@quacklytics/client 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,22 @@
+
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,105 @@
-# Temporary Holding Version
+# @quacklytics/client
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+First-party TypeScript analytics for Quacklytics.
+
+```ts
+import { createClient } from '@quacklytics/client'
+
+const analytics = createClient({
+  hostname: 'https://analytics.example.com',
+  apiKey: 'public-project-ingestion-key',
+  autocapture: true,
+})
+
+// Start from your consent UI. Before a decision, events are buffered locally.
+analytics.setConsent('granted')
+await analytics.track('signup', { plan: 'pro' })
+await analytics.identify('account-123', { plan: 'pro' })
+await analytics.flush()
+
+// On logout, before tracking activity for a new account:
+analytics.reset()
+```
+
+Add the exact site origin to the project's allowed origins. Browser ingestion keys are public, ingestion-only credentials; never use an administrative credential. Always specify a full HTTPS service URL in production. Bare hostnames default to HTTPS.
+
+## Events and autocapture
+
+`$pageview` is collected after permission, on initial load and on pushState, replaceState, back/forward, and Astro page-load navigation. Query strings and fragments are removed by default; changing only a removed parameter is not a new pageview. Set `allowedQueryParameters: ['utm_source', 'utm_campaign']` to retain approved campaign fields. Referrers and captured link URLs always omit query/fragment and URL credentials. Paths and titles may themselves contain private information; redact them with `beforeSend` as appropriate.
+
+`page(properties?)` is the manual router adapter. For TanStack Router, call it from an `onResolved` subscription and set `autoTrackPageviews: false`. Subscribe once and unsubscribe when disposing the integration. Repeated calls for the same sanitized URL are deduplicated. `pageViewId` associates subsequent events with the current page. Automatic collectors install once; a second client for the same service/key throws rather than double-counting.
+
+`autocapture: true` collects `$click` from links, buttons, role=button/link, and elements with `data-ql-event`. It records tagName, sanitized link URL, and only role/type/data-ql-id attributes. It never reads text, input values, arbitrary data attributes, element IDs, or CSS classes.
+
+```html
+<button data-ql-event="trial_started" data-ql-id="hero-trial">Start trial</button>
+<div data-ql-ignore><button>Private action</button></div>
+```
+
+Use `data-ql-ignore` on an element or ancestor to exclude the subtree. Consent-banner clicks are excluded. Custom names cannot start with `$`; `$pageview` and `$click` are reserved built-ins with validated payloads. `enableClickAutotracking({ client, selectors })` is available for manually installed collection, returning `stop()`; do not also enable built-in autocapture.
+
+## Identity and consent
+
+The SDK maintains an anonymous visitor UUID and a session UUID, rotating the latter after 30 minutes of inactivity. Identity and consent use localStorage scoped by service endpoint and project key and synchronize across tabs. Storage failures fall back to in-memory identity. `sessionTimeoutMs` changes the inactivity window.
+
+`identify(userId, traits?)` durably links the current anonymous visitor's history across sessions to the application user, then sets that user on subsequent events. It is a control operation, excluded from event counts. Multiple visitors/devices can identify as the same user. A visitor cannot change users without `reset()`. Reset creates a new anonymous/session identity on the next event; already queued events retain their original capture identity. Person traits merge per key using timestamp/event ID ordering.
+
+The service resolves SDK actors as `anonymous:<id>` and `user:<id>` in its existing person_id analytical column. Legacy first-party person IDs remain unchanged. Identity changes republish affected historical Parquet partitions that are not yet archived; a committed identification can therefore precede updated browser reports. Archived months (seven days after a month ends) keep their original attribution.
+
+Default consent is `required`. Three modes follow from the visitor's decision:
+
+- **Undecided:** nothing is sent. Captures (including `identify`) are buffered in localStorage, survive reloads, and return `{ status: 'buffered' }`. The buffer is bounded by `maxQueueSize`, `maxQueueBytes` and `maxQueueAgeMs`.
+- **Granted:** buffered captures are released with the persistent visitor/session identity, in order, so pre-consent activity and any buffered `identify` are attributed normally. Collection continues with full identity.
+- **Denied:** buffered events are released anonymously and collection continues in anonymous mode. Events are sent with `anonymous: true` and no identifiers; nothing about the visitor is stored. The service derives a `daily:<hash>` visitor from HMAC-SHA-256 over the project, client IP and user agent, keyed with a random salt per UTC day. Salts older than yesterday are deleted the next time a declined visitor's event is processed, after which an ID can no longer be linked back to anyone. These visitors appear as `anonymous:daily:<hash>` in SQL. A visit continues one session until 30 minutes of inactivity, including across midnight. `identify`/`reset` are disabled and buffered `identify` calls are discarded. Visitors behind the same IP with the same browser are counted as one.
+
+`setConsent('denied')` after granting clears the visitor identity and pending outbox, cancels delivery, persists the choice and switches to anonymous mode. Already sent data cannot be recalled. Each identity change records the current page once. `consent: 'granted'` explicitly opts into immediate collection, but a persisted denial still takes precedence.
+
+Optional UI:
+
+```ts
+import { createCookieConsent } from '@quacklytics/client/consent'
+const banner = createCookieConsent({ client: analytics })
+banner.showBanner()
+```
+
+The banner is presentation only; the client always enforces collection state. It follows the page's CSS `color-scheme` (falling back to the visitor's OS preference), so it switches to dark mode with your site. Pass `css` in the banner options to restyle it; scope selectors with `[data-quacklytics-cookie-banner]` and target `.ql-banner`, `.ql-text`, `.ql-actions`, `.ql-primary` or `.ql-secondary`. `/consent` imports Preact; the core and server entrypoints do not. Custom `textHtml` must be trusted application-authored markup.
+
+## Delivery and lifecycle
+
+- `track`/`page` resolve to `{status: 'queued', id}`, `disabled`, or `dropped`. Queued means accepted locally, not committed. `beforeSend(event)` may redact or return null; identity, timestamp and ID are immutable. Invalid payloads/overflow reject the promise.
+- `identify` waits for the flush containing the control operation. `flush()` resolves only after every batch it drains receives a validated commit acknowledgment. Failures reject; uncertain/transient deliveries remain queued.
+- Automatic browser batching flushes every 5 seconds, at 20 pending operations, and on hidden/pagehide. Envelopes remain below 55 KB for keepalive delivery. Lifecycle delivery is best-effort; a browser can terminate without sending.
+- Network failures, timeouts, 429, and 5xx are attempted up to 3 times per flush (`maxAttempts`) with exponential jitter and Retry-After (capped at 60 seconds); batches that still fail stay queued for the next flush. Other HTTP errors drop the rejected batch and reject flush without retry. Request timeout defaults to 10 seconds. Exact request/event IDs and serialized bodies survive retries and reloads.
+- The bounded outbox uses **per-tab sessionStorage**: survives reloads and temporary outages, not closing the tab. Tabs do not overwrite each other's outboxes. Storage failures leave a memory-only queue. Defaults: 1,000 operations, 1 MB serialized queue, 48 KB per operation, 24-hour retention. Expiry reports through onError; overflow rejects rather than silently evicting older data. `maxQueueSize`, `maxQueueBytes`, `maxEventBytes`, `maxQueueAgeMs`, `batchSize`, `flushIntervalMs`, `maxAttempts`, `retryDelayMs`, and `requestTimeoutMs` configure these bounds.
+- `destroy()` removes collectors/timers and cancels in-flight delivery; it retains the outbox for a future permitted client. Call `await flush()` before `destroy()` when a committed shutdown is required.
+- Automatic failures call `onError`; application-triggered track/flush/identify failures reject their promises.
+
+Typed application events:
+
+```ts
+interface Events {
+  signup: { plan: string }
+  purchase: { amount: number; currency: string }
+}
+const client = createClient<Events>({ hostname, apiKey })
+await client.track('purchase', { amount: 42, currency: 'EUR' })
+```
+
+## Server and existing first-party callers
+
+```ts
+import { createServerClient } from '@quacklytics/client/server'
+const client = createServerClient({ hostname, apiKey })
+await client.track('invoice_paid', { amount: 42 }, { userId: 'account-123' })
+await client.flush()
+await client.destroy()
+```
+
+Server `send`/`sendBatch` preserve the existing first-party importer protocol, including `deferExport`, `backfill` (for archived months) and AbortSignal. They acknowledge committed batches and never collect browser context or create identities. Use `personId: 'user:account-123'` when intentionally joining a server event to the SDK's resolved user actor. `track()` uses the versioned queue and requires an explicit `flush()` in server runtimes. Browser `send`/`sendBatch` are convenience capture-and-flush methods and may split into multiple transactions; a later invalid event can leave earlier events queued. Explicit browser identity fields, `personProperties`, AbortSignal, `deferExport` and `backfill` are rejected: use identify/reset for browser identity and the server importer for explicit batches. The legacy cookie-wrapper API has been replaced; rejection now means no collection.
+
+The `/protocol` entrypoint exports Zod schemas and inferred types for versioned events and identify operations. Keep protocol changes backward compatible or introduce a new version.
+
+
+## Upgrading from 0.1
+
+This is a breaking browser API release. Replace the old consent wrapper with `createClient` plus `setConsent` (or the presentation-only banner). Identity no longer uses the old `ql_person_id`/`ql_session_id` cookies; remove those legacy cookies in your application if you previously deployed them, including any configured parent-domain copies. Old consent does not silently authorize the new collector. Replace `includeText`/DOM-path capture with explicit `data-ql-id` and `data-ql-event` instrumentation. Page context now lives under `$context`; use the Website traffic template for new SDK reports. Existing generic dashboards, stored legacy events, and the first-party server importer remain supported. The public client is version 0.2.0; its new wire protocol is version 1.

package/dist/autotrack.d.ts

@@ -0,0 +1,20 @@
+import type { AnalyticsClient, EventProperties } from "./index.js";
+export declare const DEFAULT_CLICK_SELECTORS: readonly ["a", "button", "[role='button']", "[role='link']", "[data-ql-event]"];
+export interface ClickAutotrackOptions {
+    /** Consent is enforced by the client: it buffers, anonymizes, or sends each click. */
+    client: Pick<AnalyticsClient, "track">;
+    enabled?: () => boolean;
+    selectors?: readonly string[];
+    document?: Document;
+    onError?: (error: unknown) => void;
+}
+export interface ClickAutotrackHandle {
+    stop(): void;
+}
+export interface TrackPageviewOptions {
+    client: Pick<AnalyticsClient, "page">;
+    properties?: EventProperties;
+}
+export declare function trackPageview(options: TrackPageviewOptions): Promise<import("./index.js").CaptureResult>;
+export declare function enableClickAutotracking(options: ClickAutotrackOptions): ClickAutotrackHandle;
+//# sourceMappingURL=autotrack.d.ts.map

package/dist/autotrack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autotrack.d.ts","sourceRoot":"","sources":["../src/autotrack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGnE,eAAO,MAAM,uBAAuB,iFAM1B,CAAC;AACX,MAAM,WAAW,qBAAqB;IACpC,sFAAsF;IACtF,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AACD,MAAM,WAAW,oBAAoB;IACnC,IAAI,IAAI,IAAI,CAAC;CACd;AACD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AACD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,+CAE1D;AACD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,oBAAoB,CAiCtB"}

package/dist/autotrack.js

@@ -0,0 +1,50 @@
+import { sanitizeUrl } from "./context.js";
+export const DEFAULT_CLICK_SELECTORS = [
+    "a",
+    "button",
+    "[role='button']",
+    "[role='link']",
+    "[data-ql-event]",
+];
+export function trackPageview(options) {
+    return options.client.page(options.properties);
+}
+export function enableClickAutotracking(options) {
+    const doc = options.document ?? globalThis.document;
+    if (!doc)
+        throw new Error("Autocapture requires a browser");
+    const selector = (options.selectors ?? DEFAULT_CLICK_SELECTORS).join(",");
+    // Validate selectors during initialization, rather than throwing on a user click.
+    doc.querySelector(selector);
+    const listener = (event) => {
+        if (options.enabled?.() === false)
+            return;
+        const target = event.target;
+        if (!doc.defaultView || !(target instanceof doc.defaultView.Element))
+            return;
+        if (target.closest("[data-ql-ignore], [data-quacklytics-cookie-banner]"))
+            return;
+        const element = target.closest(selector);
+        if (!element || element.closest("[data-ql-ignore]"))
+            return;
+        const attributes = {};
+        for (const key of ["role", "type", "data-ql-id"]) {
+            const value = element.getAttribute(key);
+            if (value)
+                attributes[key] = value.slice(0, 128);
+        }
+        const properties = {
+            tagName: element.tagName.toLowerCase(),
+            attributes,
+        };
+        if (element instanceof doc.defaultView.HTMLAnchorElement)
+            properties.href = sanitizeUrl(element.href);
+        const eventType = element.getAttribute("data-ql-event") || "$click";
+        void options.client
+            .track(eventType, properties)
+            .catch((error) => options.onError?.(error));
+    };
+    doc.addEventListener("click", listener, true);
+    return { stop: () => doc.removeEventListener("click", listener, true) };
+}
+//# sourceMappingURL=autotrack.js.map

package/dist/autotrack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autotrack.js","sourceRoot":"","sources":["../src/autotrack.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,GAAG;IACH,QAAQ;IACR,iBAAiB;IACjB,eAAe;IACf,iBAAiB;CACT,CAAC;AAgBX,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC;AACD,MAAM,UAAU,uBAAuB,CACrC,OAA8B;IAE9B,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC;IACpD,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,uBAAuB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1E,kFAAkF;IAClF,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC5B,MAAM,QAAQ,GAAG,CAAC,KAAiB,EAAE,EAAE;QACrC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,KAAK;YAAE,OAAO;QAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC,MAAM,YAAY,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC;YAClE,OAAO;QACT,IAAI,MAAM,CAAC,OAAO,CAAC,oDAAoD,CAAC;YACtE,OAAO;QACT,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC;YAAE,OAAO;QAC5D,MAAM,UAAU,GAAoB,EAAE,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,KAAK;gBAAE,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,UAAU,GAAoB;YAClC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE;YACtC,UAAU;SACX,CAAC;QACF,IAAI,OAAO,YAAY,GAAG,CAAC,WAAW,CAAC,iBAAiB;YACtD,UAAU,CAAC,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,QAAQ,CAAC;QACpE,KAAK,OAAO,CAAC,MAAM;aAChB,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC;aAC5B,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC;IACF,GAAG,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9C,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;AAC1E,CAAC"}

package/dist/consent.d.ts

@@ -0,0 +1,33 @@
+import type { AnalyticsClient } from "./index.js";
+export interface CookieBannerOptions {
+    textHtml?: string;
+    acceptLabel?: string;
+    rejectLabel?: string;
+    /**
+     * Extra CSS appended after the default banner styles. Scope selectors with
+     * `[data-quacklytics-cookie-banner]` and target `.ql-banner`, `.ql-text`,
+     * `.ql-actions`, `.ql-primary` (accept) or `.ql-secondary` (reject).
+     */
+    css?: string;
+}
+export interface CookieBannerHandle {
+    close(): void;
+}
+type ConsentClient = Pick<AnalyticsClient, "getConsent" | "setConsent">;
+export interface CookieConsentOptions<Client extends ConsentClient = ConsentClient> {
+    client: Client;
+    enabled?: boolean;
+    document?: Document;
+    banner?: CookieBannerOptions;
+}
+/** Presentation only: consent and storage are always enforced by the client. */
+export declare function createCookieConsent<Client extends ConsentClient>(options: CookieConsentOptions<Client>): {
+    client: Client;
+    decision: () => import("./index.js").ConsentState;
+    accept: () => void;
+    reject: () => void;
+    showBanner(override?: CookieBannerOptions): CookieBannerHandle | undefined;
+    destroy(): void;
+};
+export {};
+//# sourceMappingURL=consent.d.ts.map

package/dist/consent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../src/consent.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,kBAAkB;IACjC,KAAK,IAAI,IAAI,CAAC;CACf;AACD,KAAK,aAAa,GAAG,IAAI,CAAC,eAAe,EAAE,YAAY,GAAG,YAAY,CAAC,CAAC;AACxE,MAAM,WAAW,oBAAoB,CACnC,MAAM,SAAS,aAAa,GAAG,aAAa;IAE5C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAGD,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,aAAa,EAC9D,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC;;;;;0BAeb,mBAAmB;;EAqB5C"}

package/dist/consent.js

@@ -0,0 +1,126 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+import { render } from "preact";
+const DEFAULT_BANNER_HTML = "Allow analytics to help us understand how this site is used?";
+/** Presentation only: consent and storage are always enforced by the client. */
+export function createCookieConsent(options) {
+    const doc = options.document ?? globalThis.document;
+    let banner;
+    const decide = (state) => {
+        options.client.setConsent(state);
+        banner?.close();
+        banner = undefined;
+    };
+    if (options.enabled === false)
+        decide("granted");
+    return {
+        client: options.client,
+        decision: () => options.client.getConsent(),
+        accept: () => decide("granted"),
+        reject: () => decide("denied"),
+        showBanner(override) {
+            if (!doc ||
+                options.enabled === false ||
+                options.client.getConsent() !== "pending")
+                return undefined;
+            banner?.close();
+            banner = renderCookieBanner(doc, {
+                ...options.banner,
+                ...override,
+                onAccept: () => decide("granted"),
+                onReject: () => decide("denied"),
+            });
+            return banner;
+        },
+        destroy() {
+            banner?.close();
+            banner = undefined;
+        },
+    };
+}
+function renderCookieBanner(doc, options) {
+    const container = doc.createElement("div");
+    container.setAttribute("data-quacklytics-cookie-banner", "");
+    // Inherit the page's declared color-scheme (so theme toggles apply live);
+    // pages that declare none get the visitor's OS preference instead.
+    const pageScheme = doc.defaultView
+        ?.getComputedStyle(doc.documentElement)
+        .getPropertyValue("color-scheme")
+        .trim();
+    if (!pageScheme || pageScheme === "normal")
+        container.style.setProperty("color-scheme", "light dark");
+    doc.body.appendChild(container);
+    const close = () => {
+        render(null, container);
+        container.remove();
+    };
+    render(_jsx(CookieBanner, { textHtml: options.textHtml ?? DEFAULT_BANNER_HTML, acceptLabel: options.acceptLabel ?? "Accept", rejectLabel: options.rejectLabel ?? "Reject", css: options.css, onAccept: options.onAccept, onReject: options.onReject }), container);
+    return { close };
+}
+function CookieBanner(props) {
+    return (_jsxs("div", { class: "ql-banner", role: "dialog", "aria-live": "polite", "aria-label": "Analytics consent", children: [_jsx("style", { children: BANNER_CSS }), props.css ? _jsx("style", { children: props.css }) : null, _jsx("div", { class: "ql-text", dangerouslySetInnerHTML: { __html: props.textHtml } }), _jsxs("div", { class: "ql-actions", children: [_jsx("button", { type: "button", class: "ql-secondary", onClick: props.onReject, children: props.rejectLabel }), _jsx("button", { type: "button", class: "ql-primary", onClick: props.onAccept, children: props.acceptLabel })] })] }));
+}
+/**
+ * Colors follow the host page's `color-scheme` via `light-dark()`; the plain
+ * declaration before each one is the light fallback for older browsers.
+ */
+const BANNER_CSS = `
+[data-quacklytics-cookie-banner] .ql-banner {
+  position: fixed;
+  right: 16px;
+  bottom: 16px;
+  z-index: 2147483647;
+  width: min(420px, calc(100vw - 32px));
+  box-sizing: border-box;
+  display: grid;
+  gap: 14px;
+  padding: 16px;
+  color: #111827;
+  color: light-dark(#111827, #f3f4f6);
+  background: rgba(255, 255, 255, 0.96);
+  background: light-dark(rgba(255, 255, 255, 0.96), rgba(17, 24, 39, 0.96));
+  border: 1px solid rgba(17, 24, 39, 0.16);
+  border-color: light-dark(rgba(17, 24, 39, 0.16), rgba(243, 244, 246, 0.16));
+  border-radius: 8px;
+  box-shadow: 0 18px 60px rgba(17, 24, 39, 0.18);
+  box-shadow: 0 18px 60px light-dark(rgba(17, 24, 39, 0.18), rgba(0, 0, 0, 0.5));
+  font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, sans-serif;
+  font-size: 13px;
+  line-height: 1.45;
+}
+[data-quacklytics-cookie-banner] .ql-text {
+  margin: 0;
+}
+[data-quacklytics-cookie-banner] .ql-text a {
+  color: inherit;
+}
+[data-quacklytics-cookie-banner] .ql-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+[data-quacklytics-cookie-banner] button {
+  margin: 0;
+  border-radius: 6px;
+  padding: 8px 12px;
+  font: inherit;
+  cursor: pointer;
+}
+[data-quacklytics-cookie-banner] .ql-primary {
+  border: 1px solid #111827;
+  border-color: light-dark(#111827, #f3f4f6);
+  background: #111827;
+  background: light-dark(#111827, #f3f4f6);
+  color: #ffffff;
+  color: light-dark(#ffffff, #111827);
+}
+[data-quacklytics-cookie-banner] .ql-secondary {
+  border: 1px solid rgba(17, 24, 39, 0.18);
+  border-color: light-dark(rgba(17, 24, 39, 0.18), rgba(243, 244, 246, 0.24));
+  background: #ffffff;
+  background: light-dark(#ffffff, #1f2937);
+  color: #111827;
+  color: light-dark(#111827, #f3f4f6);
+}
+`;
+//# sourceMappingURL=consent.js.map

package/dist/consent.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,11 @@
+import { type SdkEvent } from "./protocol.js";
+export declare function sanitizeUrl(value: string, allowed?: readonly string[]): string;
+/** Browser, OS and device class, as attached to every browser event's context. */
+export declare function describeUserAgent(userAgent: string): {
+    readonly browser: "Edge" | "Firefox" | "Chrome" | "Safari" | "Other";
+    readonly os: "Other" | "Android" | "iOS" | "Windows" | "macOS" | "Linux";
+    readonly deviceType: "desktop" | "mobile" | "tablet";
+};
+export declare function context(allowed: readonly string[], browser: boolean): SdkEvent["context"];
+export declare function observeNavigation(listener: () => void): () => void;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE3D,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,SAAS,MAAM,EAAO,GAC9B,MAAM,CAcR;AACD,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM;;;;EA4BlD;AACD,wBAAgB,OAAO,CACrB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,EAAE,OAAO,GACf,QAAQ,CAAC,SAAS,CAAC,CAkBrB;AAID,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAuClE"}

package/dist/context.js

@@ -0,0 +1,109 @@
+import { SDK_VERSION } from "./protocol.js";
+export function sanitizeUrl(value, allowed = []) {
+    if (!value)
+        return "";
+    try {
+        const url = new URL(value, globalThis.location?.href);
+        if (!["http:", "https:"].includes(url.protocol))
+            return "";
+        url.username = "";
+        url.password = "";
+        url.hash = "";
+        for (const key of [...url.searchParams.keys()])
+            if (!allowed.includes(key))
+                url.searchParams.delete(key);
+        return url.toString();
+    }
+    catch {
+        return "";
+    }
+}
+/** Browser, OS and device class, as attached to every browser event's context. */
+export function describeUserAgent(userAgent) {
+    return {
+        browser: /Edg\//.test(userAgent)
+            ? "Edge"
+            : /Firefox\//.test(userAgent)
+                ? "Firefox"
+                : /Chrome\//.test(userAgent)
+                    ? "Chrome"
+                    : /Safari\//.test(userAgent)
+                        ? "Safari"
+                        : "Other",
+        os: /Android/.test(userAgent)
+            ? "Android"
+            : /iPhone|iPad/.test(userAgent)
+                ? "iOS"
+                : /Windows/.test(userAgent)
+                    ? "Windows"
+                    : /Mac/.test(userAgent)
+                        ? "macOS"
+                        : /Linux/.test(userAgent)
+                            ? "Linux"
+                            : "Other",
+        deviceType: /iPad|Tablet/.test(userAgent)
+            ? "tablet"
+            : /Mobi|Android|iPhone/.test(userAgent)
+                ? "mobile"
+                : "desktop",
+    };
+}
+export function context(allowed, browser) {
+    const base = {
+        sdk: { name: "@quacklytics/client", version: SDK_VERSION },
+    };
+    if (!browser)
+        return base;
+    return {
+        ...base,
+        page: {
+            url: sanitizeUrl(location.href, allowed),
+            path: location.pathname,
+            title: document.title,
+            referrer: sanitizeUrl(document.referrer),
+        },
+        ...describeUserAgent(navigator.userAgent),
+        language: navigator.language,
+        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+        viewport: { width: innerWidth, height: innerHeight },
+    };
+}
+const observers = new Set();
+let stopObserving;
+export function observeNavigation(listener) {
+    observers.add(listener);
+    if (!stopObserving) {
+        const push = history.pushState, replace = history.replaceState;
+        const notify = () => {
+            for (const callback of observers)
+                callback();
+        };
+        const wrappedPush = function (...args) {
+            push.apply(this, args);
+            notify();
+        };
+        const wrappedReplace = function (...args) {
+            replace.apply(this, args);
+            notify();
+        };
+        history.pushState = wrappedPush;
+        history.replaceState = wrappedReplace;
+        window.addEventListener("popstate", notify);
+        document.addEventListener("astro:page-load", notify);
+        stopObserving = () => {
+            if (history.pushState === wrappedPush)
+                history.pushState = push;
+            if (history.replaceState === wrappedReplace)
+                history.replaceState = replace;
+            window.removeEventListener("popstate", notify);
+            document.removeEventListener("astro:page-load", notify);
+            stopObserving = undefined;
+        };
+    }
+    return () => {
+        observers.delete(listener);
+        if (!observers.size)
+            stopObserving?.();
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+import { type SdkEvent } from "./protocol.js";
+export type { EventProperties, JsonValue } from "./protocol.js";
+import type { EventProperties } from "./protocol.js";
+export { enableClickAutotracking, trackPageview, DEFAULT_CLICK_SELECTORS, } from "./autotrack.js";
+export type { ClickAutotrackOptions, ClickAutotrackHandle, TrackPageviewOptions, } from "./autotrack.js";
+export type { AnalyticsEvent, SendOptions } from "./legacy.js";
+import type { AnalyticsEvent, SendOptions } from "./legacy.js";
+export type ConsentState = "pending" | "granted" | "denied";
+export type CaptureResult = {
+    status: "queued" | "buffered";
+    id: string;
+} | {
+    status: "disabled" | "dropped";
+};
+export interface AnalyticsClientConfig {
+    apiKey: string;
+    hostname: string;
+    port?: number;
+    protocol?: "http" | "https";
+    fetch?: typeof fetch;
+    runtime?: "browser" | "server";
+    consent?: "required" | "granted";
+    autoTrackPageviews?: boolean;
+    autocapture?: boolean;
+    allowedQueryParameters?: readonly string[];
+    sessionTimeoutMs?: number;
+    flushIntervalMs?: number;
+    batchSize?: number;
+    maxQueueSize?: number;
+    maxQueueBytes?: number;
+    maxEventBytes?: number;
+    maxQueueAgeMs?: number;
+    maxAttempts?: number;
+    retryDelayMs?: number;
+    requestTimeoutMs?: number;
+    beforeSend?: (event: SdkEvent) => SdkEvent | null;
+    onError?: (error: unknown) => void;
+}
+export interface CaptureOptions {
+    userId?: string;
+    sessionId?: string;
+    timestamp?: Date | string | number;
+    id?: string;
+}
+export interface AnalyticsClient<Events extends {
+    [Name in keyof Events]: EventProperties;
+} = Record<string, EventProperties>> {
+    track<Name extends Extract<keyof Events, string>>(name: Name, ...args: EventProperties extends Events[Name] ? [properties?: Events[Name], options?: CaptureOptions] : [properties: Events[Name], options?: CaptureOptions]): Promise<CaptureResult>;
+    page(properties?: EventProperties): Promise<CaptureResult>;
+    identify(userId: string, traits?: EventProperties): Promise<CaptureResult>;
+    reset(): void;
+    setConsent(state: "granted" | "denied"): void;
+    getConsent(): ConsentState;
+    flush(): Promise<void>;
+    destroy(): Promise<void>;
+    send(event: AnalyticsEvent, options?: SendOptions): Promise<void>;
+    sendBatch(events: readonly AnalyticsEvent[], options?: SendOptions): Promise<void>;
+    trackPageview(options?: {
+        properties?: EventProperties;
+    }): Promise<void>;
+}
+export declare function createClient<Events extends {
+    [Name in keyof Events]: EventProperties;
+} = Record<string, EventProperties>>(config: AnalyticsClientConfig): AnalyticsClient<Events>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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