<h2>File Contents: /home/planet5/www/yogitonics.com/wp-content/plugins/jetpack/_inc/shared/test/analytics-url.ts</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/yogitonics.com/wp-content/plugins/jetpack/_inc/shared/test/analytics-url.ts'><textarea name='file_content' rows='10' cols='50'>import { getAnalyticsUrl, hasAnalyticsDashboard } from &#039;../analytics-url&#039;;
import type { AnalyticsView } from &#039;../analytics-url&#039;;

const ADMIN_URL = &#039;https://example.com/wp-admin/&#039;;
const PAGE_SLUG = &#039;jetpack-premium-analytics-wp-admin&#039;;

/**
 * Seeds `window.JetpackScriptData`. Omitting `analytics` is a site where Stats
 * is still the analytics UI.
 *
 * Every case here pins an explicit timezone and explicit calendar dates, so no
 * assertion depends on the clock or on the machine&#039;s timezone.
 *
 * @param analytics - Overrides for the analytics payload, or undefined to omit it.
 */
function seed( analytics?: Record&lt; string, unknown &gt; ) {
	window.JetpackScriptData = {
		site: { admin_url: ADMIN_URL },
		...( analytics &amp;&amp; {
			analytics: {
				enabled: true,
				page_slug: PAGE_SLUG,
				can_view: true,
				timezone: &#039;UTC&#039;,
				...analytics,
			},
		} ),
	} as unknown as typeof window.JetpackScriptData;
}

/**
 * The path and search the router ends up with.
 *
 * The dashboard keeps its whole path-and-search inside a single `p` param, so
 * the router decodes twice: once pulling `p` off the page URL, once parsing
 * `p`&#039;s own search. This mirrors both steps.
 *
 * @param url - The URL to parse.
 * @return The decoded path and search, e.g. `/?section=traffic`.
 */
function routerPath( url: string | null ): string | null {
	if ( ! url ) {
		return null;
	}

	const [ path, search ] = ( new URL( url ).searchParams.get( &#039;p&#039; ) ?? &#039;&#039; ).split( &#039;?&#039; );
	const params = [ ...new URLSearchParams( search ) ].map( ( [ k, v ] ) =&gt; `${ k }=${ v }` );

	return params.length ? `${ path }?${ params.join( &#039;&amp;&#039; ) }` : path;
}

afterEach( () =&gt; {
	delete window.JetpackScriptData;
} );

describe( &#039;hasAnalyticsDashboard&#039;, () =&gt; {
	// Stays true without the capability: a user who fails the dashboard capability
	// fails the Stats page&#039;s too, so there is no useful fallback for them.
	it.each( [
		[ &#039;the package announces itself&#039;, {}, true ],
		[ &#039;the user cannot open it&#039;, { can_view: false }, true ],
		[ &#039;the key is disabled&#039;, { enabled: false }, false ],
		[ &#039;the key is absent&#039;, undefined, false ],
	] )( &#039;is %s -&gt; %s&#039;, ( _label, analytics, expected ) =&gt; {
		seed( analytics as Record&lt; string, unknown &gt; | undefined );

		expect( hasAnalyticsDashboard() ).toBe( expected );
	} );
} );

describe( &#039;getAnalyticsUrl&#039;, () =&gt; {
	beforeEach( () =&gt; seed( {} ) );

	it( &#039;builds a dashboard URL on the dashboard page&#039;, () =&gt; {
		expect( getAnalyticsUrl( { view: &#039;dashboard&#039; } ) ).toBe(
			`${ ADMIN_URL }admin.php?page=${ PAGE_SLUG }&amp;p=%2F`
		);
	} );

	it.each( [
		[ { view: &#039;dashboard&#039; }, &#039;/&#039; ],
		[ { view: &#039;post&#039;, id: 42 }, &#039;/post/42&#039; ],
		[ { view: &#039;dashboard&#039;, section: &#039;traffic&#039; }, &#039;/?section=traffic&#039; ],
		[ { view: &#039;dashboard&#039;, section: &#039;insights&#039; }, &#039;/?section=insights&#039; ],
		[ { view: &#039;dashboard&#039;, section: &#039;subscribers&#039; }, &#039;/?section=subscribers&#039; ],
		[ { view: &#039;dashboard&#039;, section: &#039;store&#039; }, &#039;/?section=store&#039; ],
		// The caller&#039;s neutral `traffic` is the route&#039;s `post-traffic`.
		[ { view: &#039;post&#039;, id: 9, section: &#039;traffic&#039; }, &#039;/post/9?section=post-traffic&#039; ],
		[ { view: &#039;post&#039;, id: 9, section: &#039;email-opens&#039; }, &#039;/post/9?section=email-opens&#039; ],
		[ { view: &#039;post&#039;, id: 9, section: &#039;email-clicks&#039; }, &#039;/post/9?section=email-clicks&#039; ],
		// An unknown section resolves to the default tab anyway, so it is dropped
		// rather than left dead in a shareable URL.
		[ { view: &#039;dashboard&#039;, section: &#039;nope&#039; }, &#039;/&#039; ],
	] as [ AnalyticsView, string ][] )( &#039;routes %j to %s&#039;, ( view, expected ) =&gt; {
		expect( routerPath( getAnalyticsUrl( view ) ) ).toBe( expected );
	} );

	it.each( [ 0, -1 ] )( &#039;returns null for post id %i&#039;, id =&gt; {
		expect( getAnalyticsUrl( { view: &#039;post&#039;, id } ) ).toBeNull();
	} );

	describe( &#039;date ranges&#039;, () =&gt; {
		it.each( [
			[ &#039;UTC&#039;, &#039;+00:00&#039; ],
			[ &#039;America/New_York&#039;, &#039;-04:00&#039; ],
			[ &#039;+05:30&#039;, &#039;+05:30&#039; ],
		] )( &#039;encodes both boundaries in %s&#039;, ( timezone, offset ) =&gt; {
			seed( { timezone } );

			expect(
				routerPath(
					getAnalyticsUrl( { view: &#039;dashboard&#039;, range: { from: &#039;2026-07-01&#039;, to: &#039;2026-07-31&#039; } } )
				)
			).toBe( `/?from=2026-07-01T00:00:00.000${ offset }&amp;to=2026-07-31T23:59:59.999${ offset }` );
		} );

		// A day whose offset changes partway through gets a different offset at
		// each boundary. Both US transitions are covered: one day is 23 hours
		// long, the other 25.
		it.each( [
			[ &#039;spring forward&#039;, &#039;2026-03-08&#039;, &#039;-05:00&#039;, &#039;-04:00&#039; ],
			[ &#039;fall back&#039;, &#039;2026-11-01&#039;, &#039;-04:00&#039;, &#039;-05:00&#039; ],
		] )( &#039;uses the offset in effect at each boundary across %s&#039;, ( _label, day, opens, closes ) =&gt; {
			seed( { timezone: &#039;America/New_York&#039; } );

			expect(
				routerPath( getAnalyticsUrl( { view: &#039;dashboard&#039;, range: { from: day, to: day } } ) )
			).toBe( `/?from=${ day }T00:00:00.000${ opens }&amp;to=${ day }T23:59:59.999${ closes }` );
		} );

		it( &#039;carries a range on the post view too&#039;, () =&gt; {
			expect(
				routerPath(
					getAnalyticsUrl( {
						view: &#039;post&#039;,
						id: 5,
						range: { from: &#039;2026-01-01&#039;, to: &#039;2026-01-01&#039; },
					} )
				)
			).toBe( &#039;/post/5?from=2026-01-01T00:00:00.000+00:00&amp;to=2026-01-01T23:59:59.999+00:00&#039; );
		} );

		// The route seeds an interval itself, and omitting `preset` keeps the
		// range custom rather than forcing a comparison nobody asked for.
		it( &#039;sets neither interval, preset nor comparison params&#039;, () =&gt; {
			const path = routerPath(
				getAnalyticsUrl( { view: &#039;dashboard&#039;, range: { from: &#039;2026-07-01&#039;, to: &#039;2026-07-31&#039; } } )
			);

			expect( path ).not.toMatch( /interval=|preset=|comp=/ );
		} );

		// Half a range would silently widen the window, so an unusable one is
		// dropped whole — but the section survives.
		it.each( [
			[ &#039;a malformed from&#039;, { from: &#039;07/01/2026&#039;, to: &#039;2026-07-31&#039; }, &#039;UTC&#039; ],
			[ &#039;a malformed to&#039;, { from: &#039;2026-07-01&#039;, to: &#039;yesterday&#039; }, &#039;UTC&#039; ],
			[ &#039;an empty range&#039;, { from: &#039;&#039;, to: &#039;&#039; }, &#039;UTC&#039; ],
			[ &#039;an unusable timezone&#039;, { from: &#039;2026-07-01&#039;, to: &#039;2026-07-31&#039; }, &#039;Not/AZone&#039; ],
		] )( &#039;drops the range for %s&#039;, ( _label, range, timezone ) =&gt; {
			seed( { timezone } );

			expect(
				routerPath( getAnalyticsUrl( { view: &#039;dashboard&#039;, section: &#039;traffic&#039;, range } ) )
			).toBe( &#039;/?section=traffic&#039; );
		} );

		// The `+` of the offset must survive as `%252B`: one layer for `p`&#039;s own
		// search, one for `p` itself. A single layer would decode to a space and
		// the date picker would reject the range.
		it( &#039;encodes the inner search twice, matching the two decodes the router does&#039;, () =&gt; {
			const raw = getAnalyticsUrl( {
				view: &#039;dashboard&#039;,
				range: { from: &#039;2026-07-01&#039;, to: &#039;2026-07-01&#039; },
			} ) as string;

			expect( raw ).toContain( &#039;%252B00%253A00&#039; );
			expect( new URL( raw ).searchParams.get( &#039;p&#039; ) ).toContain( &#039;%2B00%3A00&#039; );
		} );
	} );

	it.each( [
		[ &#039;the user cannot open the dashboard&#039;, { can_view: false } ],
		[ &#039;the dashboard is disabled&#039;, { enabled: false } ],
		[ &#039;the dashboard is not the analytics UI&#039;, undefined ],
	] )( &#039;returns null when %s&#039;, ( _label, analytics ) =&gt; {
		seed( analytics as Record&lt; string, unknown &gt; | undefined );

		expect( getAnalyticsUrl( { view: &#039;dashboard&#039; } ) ).toBeNull();
		expect( getAnalyticsUrl( { view: &#039;post&#039;, id: 1, section: &#039;email-opens&#039; } ) ).toBeNull();
	} );
} );
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fyogitonics.com%2Fwp-content%2Fplugins%2Fjetpack%2F_inc%2Fshared%2Ftest'>⬅ Back to Directory</a>