@studio-vaai/js-tracking 0.2.3 → 0.3.1

package/README.md

@@ -1,73 +1,30 @@
 # @studio-vaai/js-tracking
 
-Typed analytics events for studio vaai, plus a [Umami](https://umami.is) transport
-that posts to `/api/send` via keepalive `fetch`.
-
-## Public surface
+Typed analytics events and a fetch transport for studio vaai analytics.
 
 ```ts
-interface TrackingClient {
-  trackEvent(event: TrackingEvent, options?: TrackOptions): TrackResult;
-}
-```
-
-Synchronous and fire-and-forget — the default transport dispatches via
-`fetch` with `keepalive: true` and `credentials: "omit"` so events survive
-page unload and work against cross-origin Umami hosts that return
-`Access-Control-Allow-Origin: *`. The returned `TrackResult` reflects whether
-the request was queued (or the event was buffered for later flush), not
-whether the server acknowledged it.
-
-Event-specific by design: every event must appear in `TrackingEvent` (see
-[`src/events.ts`](src/events.ts)). Until the first variant lands, `trackEvent`
-is uncallable — which forces a central declaration of every event the SDK can
-send.
+import { createFetchTrackingClient } from "@studio-vaai/js-tracking";
 
-The Umami-script-style `track()` / `identify()` overloads live as
-closure-private helpers inside the transport in
-[`src/impl/fetch-umami-tracking-client.ts`](src/impl/fetch-umami-tracking-client.ts);
-they are not part of the public API.
-
-## Usage
-
-```ts
-import { createFetchUmamiTrackingClient } from "@studio-vaai/js-tracking";
-
-// Static config: websiteId known at construction.
-const tracking = createFetchUmamiTrackingClient({
-  sdkVersion: "@studio-vaai/react-components@0.2.3",
-  websiteId: "00000000-0000-0000-0000-000000000000",
-  // baseUrl defaults to https://a.studio-vaai.com
+const tracking = createFetchTrackingClient({
+  clientApiKey: "sv_client_…",
+  sdkVersion: "my-integration@1.0.0",
+  distinctId: "visitor-id",
+  // baseUrl: "https://a.studio-vaai.com", // default; override for local development
 });
-
-// Once you've declared the event in src/events.ts:
-tracking.trackEvent({ name: "try_on_started", data: { productId } });
+tracking.trackEvent({ name: "consent-granted", data: { "product-id": "p1" } });
 ```
 
-### Lazy resolver (per-shop config)
-
-Pass `resolveConfig` instead of `websiteId` when the Umami website is only
-known after an async lookup (e.g. fetched via `client.tracking.getTracking()`).
-Events fired before the resolver settles are buffered internally and flushed
-in order on success.
+When using `js-client`, reuse its key and fetch implementation:
 
 ```ts
-const tracking = createFetchUmamiTrackingClient({
-  sdkVersion: "@studio-vaai/react-components@0.2.3",
-  resolveConfig: async () => {
-    const r = await client.tracking.getTracking({});
-    if (!r.ok) throw new ApiFailureError(r.error);
-    return { websiteId: r.data.umamiWebsiteId, baseUrl: r.data.umamiBaseUrl };
-  },
-});
+const tracking = client.analytics.createTrackingClient({ sdkVersion: "my-integration@1" });
 ```
 
-## Adding an event
-
-Declare it in [`src/events.ts`](src/events.ts) as a new `TrackingEvent` union
-variant (snake_case `name`, flat-primitive `data`). Call sites then get full
-autocomplete + type-checking on `name` and `data`.
-
-## License
+React providers create this transport automatically unless supplied with an explicit
+`tracking` implementation. Requests use your existing `X-Client-Api-Key`. Browser
+events must originate from one of the shop's allowed storefront origins.
 
-MIT
+Events use `fetch` with `keepalive: true`, `credentials: "omit"`, and JSON POSTs to
+`/api/send`. Context is derived from browser APIs and supports defaults and per-event
+overrides. The return value reports whether the request was queued, not delivered.
+Asynchronous errors are absorbed so analytics cannot interrupt the host application.

package/dist/base.d.ts

@@ -16,26 +16,26 @@ export interface TrackFailure {
  * branch product behaviour on `ok`, but may surface a warning in dev.
  *
  * Returned synchronously from {@link TrackingClient.trackEvent} — reflects
- * whether the event was queued for delivery (via keepalive fetch or a buffer
- * waiting on a lazy resolver), not whether the server received it.
+ * whether the event was queued for delivery via keepalive fetch, not whether
+ * the server received it.
  */
 export type TrackResult = TrackSuccess | TrackFailure;
 /**
  * Ambient page/session metadata that decorates every event. Mirrors the Umami
- * `/api/send` payload so transports can pass it through unchanged.
+ * `/api/send` payload. The fetch transport strips URL query strings and fragments.
  *
  * Browser transports auto-populate these from `window`/`document`/`navigator`
  * when fields are absent; pass overrides via {@link TrackOptions.context} for
  * SSR, web workers, or tests.
  */
 export interface EventContext {
-    /** Page URL path + query, e.g. `/products/abc?ref=hero`. */
+    /** Page path or URL, e.g. `/products/abc`. The fetch transport strips query strings and fragments. */
     url?: string;
     /** Document title. */
     title?: string;
     /** Hostname seen by the visitor, e.g. `shop.example.com`. */
     hostname?: string;
-    /** HTTP `Referer` (sic) — origin page that linked to the current one. */
+    /** Referring page URL. The fetch transport strips query strings and fragments. */
     referrer?: string;
     /** BCP-47 language tag, e.g. `en-US`. */
     language?: string;

package/dist/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,IAAI,CAAC;CACV;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,IAAI,CAAC;CACV;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,sGAAsG;IACtG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB"}

package/dist/client.d.ts

@@ -6,21 +6,17 @@ export declare const SDK_PACKAGE_ID: "@studio-vaai/js-tracking";
 export type TrackingClientConfig = Record<never, never>;
 /**
  * Transport-agnostic event sender. Implementations live under `impl/` (e.g.
- * the Umami beacon transport) — consumers depend on this interface so the
+ * the collector transport) — consumers depend on this interface so the
  * underlying analytics backend can be swapped without touching call sites.
  */
 export interface TrackingClient {
     /**
-     * Send a single typed event. Synchronous and fire-and-forget — implementations
-     * dispatch via fire-and-forget `fetch` with `keepalive: true`. Returns a
+     * Send a single typed event. Synchronous and fire-and-forget —
+     * implementations dispatch via `fetch` with `keepalive: true`. Returns a
      * {@link TrackResult} reflecting whether the event was successfully queued
-     * for delivery, NOT
-     * whether the server acknowledged it. Never throws — analytics must not
-     * break the host app.
-     *
-     * Buffered events (e.g. while a lazy resolver is in flight) return
-     * `{ ok: true }` immediately; if the eventual flush fails, the caller is
-     * not notified — that's the price of fire-and-forget analytics.
+     * for delivery, NOT whether the server acknowledged it. Never throws —
+     * analytics must not break the host app.
+  
      */
     trackEvent(event: TrackingEvent, options?: TrackOptions): TrackResult;
 }

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,sBAAsB;AACtB,eAAO,MAAM,cAAc,EAAG,0BAAmC,CAAC;AAElE,6CAA6C;AAC7C,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,CAAC;CACvE;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,cAAc,CAElF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,sBAAsB;AACtB,eAAO,MAAM,cAAc,EAAG,0BAAmC,CAAC;AAElE,6CAA6C;AAE7C,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;OAOG;IACH,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,CAAC;CACvE;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,cAAc,CAElF"}

package/dist/client.js

@@ -1,10 +1,9 @@
 import { TrackingClientNotImplementedError } from "./errors.js";
-//#region src/client.ts
+// src/client.ts
 /** Npm package id. */
 var SDK_PACKAGE_ID = "@studio-vaai/js-tracking";
 /** Contract-only stub — throws; a transport package supplies a real implementation. */
 function createTrackingClient(_config) {
 	throw new TrackingClientNotImplementedError();
 }
-//#endregion
 export { SDK_PACKAGE_ID, createTrackingClient };

package/dist/errors.js

@@ -1,11 +1,10 @@
-//#region src/errors.ts
+// src/errors.ts
 /** Thrown by the contract-only {@link createTrackingClient} stub. */
 var TrackingClientNotImplementedError = class extends Error {
 	code = "tracking_client_not_implemented";
 	constructor() {
-		super("@studio-vaai/js-tracking: createTrackingClient has no runtime implementation; use a transport like createFetchUmamiTrackingClient.");
+		super("@studio-vaai/js-tracking: createTrackingClient has no runtime implementation; use a transport like createFetchTrackingClient.");
 		this.name = "TrackingClientNotImplementedError";
 	}
 };
-//#endregion
 export { TrackingClientNotImplementedError };

package/dist/events.d.ts

@@ -18,7 +18,7 @@ export interface TrackingEventBase {
 }
 /**
  * Fields present on every event's `data`. The transport additionally injects
- * `sdk-version` from {@link FetchUmamiTrackingClientConfig.sdkVersion}, so
+ * `sdk-version` from {@link FetchTrackingClientConfig.sdkVersion}, so
  * callers never set that themselves.
  */
 interface CommonData {
@@ -118,6 +118,23 @@ interface TryOnInitiatedEvent extends TrackingEventBase {
     readonly name: "try-on-initiated";
     readonly data: CommonData & VariantData;
 }
+/**
+ * Fires when the shopper deliberately selects a size the fit gate marks as
+ * unwearable for their body (the chip carries a "too small"/"too big" badge, so
+ * the pick is informed). The gated size is never rendered — the flow pre-pivots
+ * the try-on to the recommended size — so this event is the only signal of the
+ * shopper's insistence, and its rate per product is direct feedback on how much
+ * shoppers trust or contest the gate's verdicts.
+ */
+interface GatedSizeSelectedEvent extends TrackingEventBase {
+    readonly name: "gated-size-selected";
+    readonly data: CommonData & {
+        /** The gated size slug the shopper picked. */
+        readonly "variant-size": string;
+        /** The gate's verdict for that size. */
+        readonly gate: "too_small" | "too_large";
+    };
+}
 interface CartItemAddedEvent extends TrackingEventBase {
     readonly name: "cart-item-added";
     readonly data: CommonData & VariantData;
@@ -132,11 +149,26 @@ interface ViewClosedEvent extends TrackingEventBase {
         readonly "current-step": Step;
     };
 }
+/**
+ * Fires once when the backend assigns a visitor to an arm of the try-on
+ * rollout A/B test. Feature-level (no `product-id`) — it gates the entry point
+ * before any product context exists. Correlate `variant` against downstream
+ * conversion events in Umami to measure the test.
+ */
+interface ExperimentAssignedEvent extends TrackingEventBase {
+    readonly name: "experiment-assigned";
+    readonly data: {
+        /** Experiment identifier; currently always `try-on-enabled`. */
+        readonly experiment: "try-on-enabled";
+        /** Assigned arm. */
+        readonly variant: "enabled" | "disabled";
+    };
+}
 /**
  * Discriminated union of every event the SDK can send. Add new events by
  * declaring a variant interface above and appending it to the union — call
  * sites get full autocomplete + type-checking on `name` and `data`.
  */
-export type TrackingEvent = EntrypointImpressionEvent | EntrypointClickedEvent | IntroOpenedEvent | ConsentGrantedEvent | ImageRecordInitiatedEvent | ImageRecordAbortedEvent | ImageUploadInitiatedEvent | ImageUploadAbortedEvent | ImageUploadedEvent | HeightEnteredEvent | VariantSelectionInitiatedEvent | TryOnInitiatedEvent | CartItemAddedEvent | OrderPlacedEvent | ViewClosedEvent;
+export type TrackingEvent = EntrypointImpressionEvent | EntrypointClickedEvent | IntroOpenedEvent | ConsentGrantedEvent | ImageRecordInitiatedEvent | ImageRecordAbortedEvent | ImageUploadInitiatedEvent | ImageUploadAbortedEvent | ImageUploadedEvent | HeightEnteredEvent | VariantSelectionInitiatedEvent | TryOnInitiatedEvent | GatedSizeSelectedEvent | CartItemAddedEvent | OrderPlacedEvent | ViewClosedEvent | ExperimentAssignedEvent;
 export {};
 //# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}

package/dist/impl/fetch-tracking-client.d.ts

@@ -0,0 +1,14 @@
+import type { EventContext } from "../base.js";
+import type { TrackingClient } from "../client.js";
+export declare const DEFAULT_COLLECTOR_BASE_URL: "https://a.studio-vaai.com";
+export interface FetchTrackingClientConfig {
+    clientApiKey: string;
+    baseUrl?: string;
+    sdkVersion: string;
+    distinctId?: string | (() => string);
+    fetch?: typeof fetch;
+    defaultContext?: EventContext;
+}
+/** Direct collector transport. Returns whether the request was queued, never delivery acknowledgement. */
+export declare function createFetchTrackingClient(config: FetchTrackingClientConfig): TrackingClient;
+//# sourceMappingURL=fetch-tracking-client.d.ts.map

package/dist/impl/fetch-tracking-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-tracking-client.d.ts","sourceRoot":"","sources":["../../src/impl/fetch-tracking-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,eAAO,MAAM,0BAA0B,EAAG,2BAAoC,CAAC;AAE/E,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,cAAc,CAAC,EAAE,YAAY,CAAC;CAC/B;AAiFD,0GAA0G;AAC1G,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,cAAc,CA8C3F"}

package/dist/impl/fetch-tracking-client.js

@@ -0,0 +1,99 @@
+// src/impl/fetch-tracking-client.ts
+var DEFAULT_COLLECTOR_BASE_URL = "https://a.studio-vaai.com";
+function deriveBrowserContext() {
+	const ctx = {};
+	if (typeof globalThis === "undefined") return ctx;
+	const w = globalThis.window;
+	if (typeof w === "undefined") return ctx;
+	const loc = w.location;
+	if (typeof loc !== "undefined") {
+		ctx.hostname = loc.hostname;
+		ctx.url = loc.pathname;
+	}
+	const doc = w.document;
+	if (typeof doc !== "undefined") {
+		ctx.title = doc.title;
+		if (doc.referrer !== "") ctx.referrer = doc.referrer;
+	}
+	const nav = w.navigator;
+	if (typeof nav !== "undefined") ctx.language = nav.language;
+	const scr = w.screen;
+	if (typeof scr !== "undefined") ctx.screen = `${String(scr.width)}x${String(scr.height)}`;
+	return ctx;
+}
+function mergeContext(base, defaults, overrides) {
+	return {
+		...base,
+		...defaults,
+		...overrides
+	};
+}
+/** Keep page paths while excluding query parameters and fragments that may identify shoppers. */
+function withoutURLParameters(value) {
+	return value.split(/[?#]/, 1)[0] ?? "";
+}
+function applyContext(payload, ctx) {
+	if (typeof ctx.hostname !== "undefined") payload.hostname = ctx.hostname;
+	if (typeof ctx.language !== "undefined") payload.language = ctx.language;
+	if (typeof ctx.screen !== "undefined") payload.screen = ctx.screen;
+	if (typeof ctx.title !== "undefined") payload.title = ctx.title;
+	if (typeof ctx.url !== "undefined") payload.url = withoutURLParameters(ctx.url);
+	if (typeof ctx.referrer !== "undefined") payload.referrer = withoutURLParameters(ctx.referrer);
+}
+function networkError(message, details) {
+	return details === void 0 ? {
+		kind: "network",
+		message
+	} : {
+		kind: "network",
+		message,
+		details
+	};
+}
+/** Direct collector transport. Returns whether the request was queued, never delivery acknowledgement. */
+function createFetchTrackingClient(config) {
+	const fetchImpl = config.fetch ?? (typeof globalThis.fetch === "function" ? globalThis.fetch.bind(globalThis) : null);
+	const endpoint = `${(config.baseUrl ?? "https://a.studio-vaai.com").replace(/\/$/, "")}/api/send`;
+	return { trackEvent: (event, options) => {
+		if (fetchImpl === null) return {
+			ok: false,
+			error: networkError("fetch is not available in this environment")
+		};
+		const payload = {};
+		applyContext(payload, mergeContext(deriveBrowserContext(), config.defaultContext, options?.context));
+		try {
+			const distinctId = typeof config.distinctId === "function" ? config.distinctId() : config.distinctId;
+			const body = JSON.stringify({
+				type: "event",
+				payload: {
+					...payload,
+					name: event.name,
+					...distinctId === void 0 ? {} : { id: distinctId.slice(0, 50) },
+					data: {
+						...event.data,
+						"sdk-version": config.sdkVersion
+					}
+				}
+			});
+			fetchImpl(endpoint, {
+				method: "POST",
+				headers: {
+					"Content-Type": "application/json",
+					"X-Client-Api-Key": config.clientApiKey
+				},
+				credentials: "omit",
+				referrerPolicy: "no-referrer",
+				keepalive: true,
+				mode: "cors",
+				body
+			}).catch(() => {});
+			return { ok: true };
+		} catch (error) {
+			return {
+				ok: false,
+				error: networkError("Failed to queue analytics request", error)
+			};
+		}
+	} };
+}
+export { DEFAULT_COLLECTOR_BASE_URL, createFetchTrackingClient };

package/dist/index.d.ts

@@ -5,6 +5,6 @@ export { TrackingClientNotImplementedError } from "./errors.js";
 export type { TrackingEvent, TrackingEventBase, VariantSelectionVia } from "./events.js";
 export type { ImageFlowSource } from "./image-flow-source.js";
 export type { Step } from "./steps.js";
-export type { FetchUmamiTrackingClientConfig, ResolvedUmamiConfig, } from "./impl/fetch-umami-tracking-client.js";
-export { createFetchUmamiTrackingClient, DEFAULT_UMAMI_BASE_URL, } from "./impl/fetch-umami-tracking-client.js";
+export type { FetchTrackingClientConfig } from "./impl/fetch-tracking-client.js";
+export { createFetchTrackingClient, DEFAULT_COLLECTOR_BASE_URL, } from "./impl/fetch-tracking-client.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,iCAAiC,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACzF,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EACV,8BAA8B,EAC9B,mBAAmB,GACpB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,8BAA8B,EAC9B,sBAAsB,GACvB,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,iCAAiC,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACzF,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EACL,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
-import { TrackingClientNotImplementedError } from "./errors.js";
 import { SDK_PACKAGE_ID, createTrackingClient } from "./client.js";
-import { DEFAULT_UMAMI_BASE_URL, createFetchUmamiTrackingClient } from "./impl/fetch-umami-tracking-client.js";
-export { DEFAULT_UMAMI_BASE_URL, SDK_PACKAGE_ID, TrackingClientNotImplementedError, createFetchUmamiTrackingClient, createTrackingClient };
+import { TrackingClientNotImplementedError } from "./errors.js";
+import { DEFAULT_COLLECTOR_BASE_URL, createFetchTrackingClient } from "./impl/fetch-tracking-client.js";
+export { DEFAULT_COLLECTOR_BASE_URL, SDK_PACKAGE_ID, TrackingClientNotImplementedError, createFetchTrackingClient, createTrackingClient };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studio-vaai/js-tracking",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "Typed analytics events for studio vaai, plus a fetch-based Umami transport.",
   "license": "MIT",
   "files": [
@@ -17,7 +17,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "vite": "8.0.5"
+    "vite": "8.3.6"
   },
   "scripts": {
     "build": "vite build --config vite.lib.config.ts && rm -f tsconfig.tsbuildinfo && tsgo --emitDeclarationOnly",

package/dist/impl/fetch-umami-tracking-client.d.ts

@@ -1,64 +0,0 @@
-import type { EventContext } from "../base.js";
-import type { TrackingClient, TrackingClientConfig } from "../client.js";
-/** Default Umami base URL (int/prod Umami). */
-export declare const DEFAULT_UMAMI_BASE_URL: "https://a.studio-vaai.com";
-/** Per-shop Umami config the {@link FetchUmamiTrackingClientConfig.resolveConfig} resolver returns. */
-export interface ResolvedUmamiConfig {
-    /** Umami website UUID for this shop. */
-    websiteId: string;
-    /** Optional override; defaults to {@link DEFAULT_UMAMI_BASE_URL} when omitted. */
-    baseUrl?: string;
-}
-export interface FetchUmamiTrackingClientConfig extends TrackingClientConfig {
-    /**
-     * Stamped on every event as the `sdk-version` field. Higher SDK layers
-     * (e.g. `@studio-vaai/react-components`) pass their own
-     * `"<pkg>@<version>"` here so the analytics view shows the version of the
-     * SDK merchants actually install — not this internal tracking package.
-     */
-    sdkVersion: string;
-    /**
-     * Static Umami website UUID. Provide this OR {@link resolveConfig}, not both.
-     * Use the static form when the website id is known at client construction.
-     */
-    websiteId?: string;
-    /** Static Umami base URL. Used together with {@link websiteId}. Defaults to {@link DEFAULT_UMAMI_BASE_URL}. */
-    baseUrl?: string;
-    /**
-     * Lazy resolver for per-shop Umami config. Provide this OR {@link websiteId},
-     * not both. Runs once when the client is constructed; events fired before
-     * the promise settles are buffered internally and flushed (in order) the
-     * moment the resolver returns. Buffered events have already returned
-     * `{ ok: true }` to the caller — if the eventual flush fails (resolver
-     * rejected or the request could not be queued) the caller is not notified.
-     */
-    resolveConfig?: () => Promise<ResolvedUmamiConfig>;
-    /**
-     * Override `fetch`. Defaults to `globalThis.fetch` bound to `globalThis` so
-     * the native browser implementation doesn't trip on `this`-binding rules.
-     */
-    fetch?: typeof fetch;
-    /**
-     * Ambient context applied to every payload, before per-call overrides. Useful
-     * for SSR-known fields or to pin a hostname different from `window.location`.
-     */
-    defaultContext?: EventContext;
-}
-/**
- * Umami `/api/send` transport for {@link TrackingClient}. Dispatches via
- * fire-and-forget `fetch` with `keepalive: true` so events survive page unload,
- * and `credentials: "omit"` so cross-origin Umami hosts may use
- * `Access-Control-Allow-Origin: *`. The return value reports whether the
- * request was queued, not whether the server acknowledged it. Errors are never
- * thrown — analytics cannot break the host app.
- *
- * Supports two configuration modes:
- * - **Static**: pass `websiteId` (and optionally `baseUrl`) at construction.
- *   Events fire immediately.
- * - **Lazy**: pass `resolveConfig` for per-shop Umami config that's only known
- *   asynchronously (e.g. fetched via `client.tracking.getTracking()`). Events
- *   fired before the resolver settles are buffered in order and flushed once
- *   the config is available.
- */
-export declare function createFetchUmamiTrackingClient(config: FetchUmamiTrackingClientConfig): TrackingClient;
-//# sourceMappingURL=fetch-umami-tracking-client.d.ts.map

package/dist/impl/fetch-umami-tracking-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetch-umami-tracking-client.d.ts","sourceRoot":"","sources":["../../src/impl/fetch-umami-tracking-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGzE,+CAA+C;AAC/C,eAAO,MAAM,sBAAsB,EAAG,2BAAoC,CAAC;AAE3E,uGAAuG;AACvG,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,8BAA+B,SAAQ,oBAAoB;IAC1E;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+GAA+G;IAC/G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnD;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,YAAY,CAAC;CAC/B;AAyHD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,8BAA8B,GACrC,cAAc,CAwJhB"}

package/dist/impl/fetch-umami-tracking-client.js

@@ -1,176 +0,0 @@
-//#region src/impl/fetch-umami-tracking-client.ts
-/** Default Umami base URL (int/prod Umami). */
-var DEFAULT_UMAMI_BASE_URL = "https://a.studio-vaai.com";
-var UMAMI_FETCH_INIT = {
-	method: "POST",
-	headers: { "Content-Type": "application/json" },
-	credentials: "omit",
-	keepalive: true,
-	mode: "cors"
-};
-function deriveBrowserContext() {
-	const ctx = {};
-	if (typeof globalThis === "undefined") return ctx;
-	const w = globalThis.window;
-	if (typeof w === "undefined") return ctx;
-	const loc = w.location;
-	if (typeof loc !== "undefined") {
-		ctx.hostname = loc.hostname;
-		ctx.url = `${loc.pathname}${loc.search}`;
-	}
-	const doc = w.document;
-	if (typeof doc !== "undefined") {
-		ctx.title = doc.title;
-		if (doc.referrer !== "") ctx.referrer = doc.referrer;
-	}
-	const nav = w.navigator;
-	if (typeof nav !== "undefined") ctx.language = nav.language;
-	const scr = w.screen;
-	if (typeof scr !== "undefined") ctx.screen = `${String(scr.width)}x${String(scr.height)}`;
-	return ctx;
-}
-function mergeContext(base, defaults, overrides) {
-	return {
-		...base,
-		...defaults,
-		...overrides
-	};
-}
-function applyContext(payload, ctx) {
-	if (typeof ctx.hostname !== "undefined") payload.hostname = ctx.hostname;
-	if (typeof ctx.language !== "undefined") payload.language = ctx.language;
-	if (typeof ctx.screen !== "undefined") payload.screen = ctx.screen;
-	if (typeof ctx.title !== "undefined") payload.title = ctx.title;
-	if (typeof ctx.url !== "undefined") payload.url = ctx.url;
-	if (typeof ctx.referrer !== "undefined") payload.referrer = ctx.referrer;
-}
-function networkError(message, details) {
-	return details === void 0 ? {
-		kind: "network",
-		message
-	} : {
-		kind: "network",
-		message,
-		details
-	};
-}
-function bakeState(websiteId, baseUrl) {
-	return {
-		endpoint: `${(baseUrl ?? "https://a.studio-vaai.com").replace(/\/$/, "")}/api/send`,
-		websiteId
-	};
-}
-function defaultFetchImpl() {
-	if (typeof globalThis.fetch !== "function") return null;
-	return globalThis.fetch.bind(globalThis);
-}
-/**
-* Umami `/api/send` transport for {@link TrackingClient}. Dispatches via
-* fire-and-forget `fetch` with `keepalive: true` so events survive page unload,
-* and `credentials: "omit"` so cross-origin Umami hosts may use
-* `Access-Control-Allow-Origin: *`. The return value reports whether the
-* request was queued, not whether the server acknowledged it. Errors are never
-* thrown — analytics cannot break the host app.
-*
-* Supports two configuration modes:
-* - **Static**: pass `websiteId` (and optionally `baseUrl`) at construction.
-*   Events fire immediately.
-* - **Lazy**: pass `resolveConfig` for per-shop Umami config that's only known
-*   asynchronously (e.g. fetched via `client.tracking.getTracking()`). Events
-*   fired before the resolver settles are buffered in order and flushed once
-*   the config is available.
-*/
-function createFetchUmamiTrackingClient(config) {
-	const fetchImpl = config.fetch ?? defaultFetchImpl();
-	let resolved = null;
-	let resolverError = null;
-	const pending = [];
-	const staticWebsiteId = config.websiteId;
-	const resolverFn = config.resolveConfig;
-	if (staticWebsiteId === void 0 && resolverFn === void 0) throw new Error("createFetchUmamiTrackingClient: provide either `websiteId` or `resolveConfig`");
-	if (staticWebsiteId !== void 0 && resolverFn !== void 0) throw new Error("createFetchUmamiTrackingClient: pass either `websiteId` or `resolveConfig`, not both");
-	if (staticWebsiteId !== void 0) resolved = bakeState(staticWebsiteId, config.baseUrl);
-	else if (resolverFn !== void 0) {
-		if (config.baseUrl !== void 0) throw new Error("createFetchUmamiTrackingClient: `baseUrl` is set by the resolver in lazy mode — drop the static `baseUrl`");
-		(async () => {
-			try {
-				const r = await resolverFn();
-				resolved = bakeState(r.websiteId, r.baseUrl);
-			} catch (error) {
-				resolverError = {
-					kind: "unknown",
-					message: "Failed to resolve Umami tracking config",
-					details: error
-				};
-			}
-			while (pending.length > 0) {
-				const item = pending.shift();
-				if (item === void 0) break;
-				if (resolved === null) continue;
-				sendNow(resolved, item.event, item.options);
-			}
-		})();
-	}
-	function dispatchEvent(state, body) {
-		let json;
-		try {
-			json = JSON.stringify(body);
-		} catch (error) {
-			return {
-				ok: false,
-				error: networkError("Failed to serialise event", error)
-			};
-		}
-		if (fetchImpl === null) return {
-			ok: false,
-			error: networkError("fetch is not available in this environment")
-		};
-		try {
-			(async () => {
-				try {
-					await fetchImpl(state.endpoint, {
-						...UMAMI_FETCH_INIT,
-						body: json
-					});
-				} catch {}
-			})();
-		} catch (error) {
-			return {
-				ok: false,
-				error: networkError("Failed to queue Umami request", error)
-			};
-		}
-		return { ok: true };
-	}
-	function track(state, name, data, contextOverrides) {
-		const payload = { website: state.websiteId };
-		applyContext(payload, mergeContext(deriveBrowserContext(), config.defaultContext, contextOverrides));
-		if (typeof name !== "undefined") payload.name = name;
-		if (typeof data !== "undefined") payload.data = { ...data };
-		return dispatchEvent(state, {
-			type: "event",
-			payload
-		});
-	}
-	function sendNow(state, event, options) {
-		const data = {
-			...event.data ?? {},
-			"sdk-version": config.sdkVersion
-		};
-		return track(state, event.name, data, options?.context);
-	}
-	return { trackEvent: (event, options) => {
-		if (resolved !== null) return sendNow(resolved, event, options);
-		if (resolverError !== null) return {
-			ok: false,
-			error: resolverError
-		};
-		pending.push({
-			event,
-			options
-		});
-		return { ok: true };
-	} };
-}
-//#endregion
-export { DEFAULT_UMAMI_BASE_URL, createFetchUmamiTrackingClient };