@gurulu/web 0.1.0 → 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 MONAFY LTD (UK Company No. 17031485)
+4 Raven Road, Unit 1C3-1051, London, United Kingdom, E18 1HB
+
+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

@@ -0,0 +1,52 @@
+# @gurulu/web
+
+Browser SDK for [Gurulu](https://gurulu.io) — Truth Layer for product analytics.
+
+Zero runtime dependencies. ~8 KB gzipped.
+
+## Install
+
+### Script tag (autocapture, no build step)
+
+```html
+<script
+  src="https://cdn.gurulu.io/t.js"
+  data-workspace="pk_xxxxxxxxxxxx"
+  defer
+></script>
+```
+
+### NPM
+
+```bash
+npm install @gurulu/web
+# or
+bun add @gurulu/web
+```
+
+```ts
+import { createGurulu } from '@gurulu/web';
+
+const gurulu = createGurulu();
+gurulu.init({ workspace: 'pk_xxxxxxxxxxxx' });
+
+gurulu.identify('user_42', { plan: 'pro' });
+gurulu.track('checkout.completed', { order_id: 'o_123', total: 49.99 });
+```
+
+## Features
+
+- **Autocapture** — click, pageview, form submit, scroll depth, web-vitals (LCP, INP, CLS).
+- **Identity** — `identify(personId, traits)` with deterministic + probabilistic merge on the server.
+- **Contract runtime** — registry-bound event validation: malformed events are quarantined, never silently dropped.
+- **Consent-aware** — respects Google Consent Mode v2, GDPR/CCPA gates.
+
+## Documentation
+
+Full API reference and integration guides: [gurulu.io/docs](https://gurulu.io/docs)
+
+## License
+
+MIT — see [LICENSE](./LICENSE).
+
+Copyright © 2026 MONAFY LTD (UK Company No. 17031485).

package/dist/autocapture/click.d.ts

@@ -0,0 +1,17 @@
+export interface ClickPayload {
+    element_tag: string;
+    element_id?: string;
+    element_class?: string;
+    element_text?: string;
+    href?: string;
+    is_outbound?: boolean;
+    is_download?: boolean;
+    custom_event?: string;
+    custom_props?: Record<string, string>;
+}
+export type ClickTracker = (payload: ClickPayload) => void;
+export interface ClickAutocaptureHandle {
+    stop(): void;
+}
+export declare function startClickAutocapture(track: ClickTracker): ClickAutocaptureHandle;
+//# sourceMappingURL=click.d.ts.map

package/dist/autocapture/click.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../src/autocapture/click.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;AA8C3D,MAAM,WAAW,sBAAsB;IACrC,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,sBAAsB,CAiDjF"}

package/dist/autocapture/form.d.ts

@@ -0,0 +1,21 @@
+export interface FormStartedPayload {
+    form_id?: string;
+    form_name?: string;
+    field_count: number;
+}
+export interface FormSubmittedPayload {
+    form_id?: string;
+    form_name?: string;
+    field_count: number;
+    /** Names of fields that had user input (PII-safe — no values). */
+    filled_fields?: string[];
+}
+export type FormTracker = {
+    onStart: (p: FormStartedPayload) => void;
+    onSubmit: (p: FormSubmittedPayload) => void;
+};
+export interface FormAutocaptureHandle {
+    stop(): void;
+}
+export declare function startFormAutocapture(track: FormTracker): FormAutocaptureHandle;
+//# sourceMappingURL=form.d.ts.map

package/dist/autocapture/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/autocapture/form.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,CAAC,CAAC,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC7C,CAAC;AAyCF,MAAM,WAAW,qBAAqB;IACpC,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,qBAAqB,CAoD9E"}

package/dist/autocapture/index.d.ts

@@ -0,0 +1,18 @@
+import type { AutocaptureConfig } from '../types.ts';
+import { type ClickPayload } from './click.ts';
+import { type FormStartedPayload, type FormSubmittedPayload } from './form.ts';
+import { type ScrollDepthPayload } from './scroll.ts';
+import { type WebVitalPayload } from './web-vitals.ts';
+export interface AutocaptureSinks {
+    pageView: (url: string, title: string, referrer: string) => void;
+    click: (payload: ClickPayload) => void;
+    formStarted: (payload: FormStartedPayload) => void;
+    formSubmitted: (payload: FormSubmittedPayload) => void;
+    scrollDepth: (payload: ScrollDepthPayload) => void;
+    webVital: (payload: WebVitalPayload) => void;
+}
+export interface AutocaptureHandle {
+    stopAll(): void;
+}
+export declare function startAutocapture(cfg: AutocaptureConfig | false | undefined, sinks: AutocaptureSinks): AutocaptureHandle;
+//# sourceMappingURL=index.d.ts.map

package/dist/autocapture/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/autocapture/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,KAAK,YAAY,EAAyB,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAE1B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,KAAK,kBAAkB,EAA0B,MAAM,aAAa,CAAC;AAC9E,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACvC,WAAW,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACnD,aAAa,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACvD,WAAW,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACnD,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,IAAI,IAAI,CAAC;CACjB;AAiBD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,iBAAiB,GAAG,KAAK,GAAG,SAAS,EAC1C,KAAK,EAAE,gBAAgB,GACtB,iBAAiB,CA8BnB"}

package/dist/autocapture/page.d.ts

@@ -0,0 +1,9 @@
+export type PageTracker = (path: string, title: string, referrer: string) => void;
+export interface PageAutocaptureHandle {
+    stop(): void;
+}
+/**
+ * Patch history & listen popstate. Emits once on init for initial page_view.
+ */
+export declare function startPageAutocapture(track: PageTracker): PageAutocaptureHandle;
+//# sourceMappingURL=page.d.ts.map

package/dist/autocapture/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/autocapture/page.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;AAElF,MAAM,WAAW,qBAAqB;IACpC,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,qBAAqB,CA0C9E"}

package/dist/autocapture/scroll.d.ts

@@ -0,0 +1,9 @@
+export interface ScrollDepthPayload {
+    depth_percent: 25 | 50 | 75 | 90;
+}
+export type ScrollTracker = (payload: ScrollDepthPayload) => void;
+export interface ScrollAutocaptureHandle {
+    stop(): void;
+}
+export declare function startScrollAutocapture(track: ScrollTracker): ScrollAutocaptureHandle;
+//# sourceMappingURL=scroll.d.ts.map

package/dist/autocapture/scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.d.ts","sourceRoot":"","sources":["../../src/autocapture/scroll.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAIlE,MAAM,WAAW,uBAAuB;IACtC,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,uBAAuB,CAuCpF"}

package/dist/autocapture/web-vitals.d.ts

@@ -0,0 +1,11 @@
+export interface WebVitalPayload {
+    metric: 'LCP' | 'FID' | 'INP' | 'CLS' | 'TTFB' | 'FCP';
+    value: number;
+    rating?: 'good' | 'needs-improvement' | 'poor';
+}
+export type WebVitalTracker = (payload: WebVitalPayload) => void;
+export interface WebVitalsHandle {
+    stop(): void;
+}
+export declare function startWebVitalsAutocapture(track: WebVitalTracker): WebVitalsHandle;
+//# sourceMappingURL=web-vitals.d.ts.map

package/dist/autocapture/web-vitals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-vitals.d.ts","sourceRoot":"","sources":["../../src/autocapture/web-vitals.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,MAAM,CAAC;CAChD;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;AAiCjE,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CAmGjF"}

package/dist/consent.d.ts

@@ -0,0 +1,117 @@
+export interface ConsentCategories {
+    necessary: boolean;
+    analytics: boolean;
+    marketing: boolean;
+    functional: boolean;
+    personalization: boolean;
+}
+export interface ConsentSnapshot {
+    workspaceId: string;
+    anonymousId: string;
+    categories: ConsentCategories;
+    /** ISO 8601. */
+    grantedAt: string;
+    /** ISO 8601. */
+    expiresAt: string;
+    /** Hangi kaynaktan geldi — 'banner' | 'settings_page' | 'sdk_api' | 'remote'. */
+    source: 'banner' | 'settings_page' | 'sdk_api' | 'remote';
+}
+export interface BannerConfig {
+    position?: 'bottom' | 'top' | 'bottom-left' | 'bottom-right' | 'modal';
+    theme?: 'auto' | 'light' | 'dark';
+    buttons?: {
+        accept?: boolean;
+        reject?: boolean;
+        customize?: boolean;
+    };
+    brand?: {
+        logo_url?: string;
+        primary_color?: string;
+    };
+    text_overrides?: Record<string, Record<string, string>>;
+}
+export interface BannerConfigResponse {
+    workspace_id: string;
+    mode: 'allow_by_default' | 'banner_required' | 'strict_gdpr';
+    categories: {
+        necessary: {
+            required: true;
+            default: true;
+        };
+        analytics: {
+            default: boolean;
+        };
+        marketing: {
+            default: boolean;
+        };
+        functional: {
+            default: boolean;
+        };
+        personalization: {
+            default: boolean;
+        };
+    };
+    banner_config: BannerConfig;
+    renewal_months: number;
+    eu_detected: {
+        country: string;
+        region: string;
+        gdpr_applicable: boolean;
+    };
+}
+export interface GuruluConsentOptions {
+    workspaceId: string;
+    /** Default 'https://api.gurulu.io'. Local dev: 'http://localhost:3000'. */
+    apiUrl?: string;
+    /** Browser locale (banner copy fallback). Default navigator.language. */
+    locale?: 'tr' | 'en' | 'zh' | 'ar';
+    /** Anonymous ID (otherwise generated). */
+    anonymousId?: string;
+    /** Test injection. */
+    fetchImpl?: typeof fetch;
+    /** Test injection. */
+    storage?: Storage;
+    /** Auto-call showBanner() in init() if mode requires. Default true. */
+    autoBanner?: boolean;
+}
+/**
+ * Browser SDK consent manager.
+ * Zero runtime dep (M11 K28). SSR-safe (init no-op if window undefined).
+ */
+export declare class GuruluConsent {
+    private readonly workspaceId;
+    private readonly apiUrl;
+    private readonly fetchImpl;
+    private readonly storage;
+    private readonly autoBanner;
+    private readonly locale;
+    private anonymousIdValue;
+    private bannerConfigCache;
+    private bannerEl;
+    constructor(opts: GuruluConsentOptions);
+    /**
+     * Banner config fetch + auto-show. Idempotent — tekrar çağırılabilir.
+     */
+    init(): Promise<void>;
+    /** Local consent snapshot — `null` if visitor henüz consent vermemiş. */
+    getState(): ConsentSnapshot | null;
+    /**
+     * Consent state set + remote sync (POST /v1/consent/state).
+     * `necessary` her zaman true (forced).
+     */
+    setState(categories: Partial<ConsentCategories>): Promise<void>;
+    /** Banner DOM elemanını oluştur + body'ye ekle. Idempotent. */
+    showBanner(): void;
+    hideBanner(): void;
+    /**
+     * gurulu.track() için header — `X-Gurulu-Consent: {categories JSON}`.
+     * Ingest endpoint K17 event snapshot için bu header'ı okur.
+     */
+    buildIngestHeader(): string;
+    /** Test util — current anon id. */
+    getAnonymousId(): string;
+    private storageKey;
+    private loadOrCreateAnonId;
+    private bannerText;
+}
+//# sourceMappingURL=consent.d.ts.map

package/dist/consent.d.ts.map

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

package/dist/core.d.ts

@@ -0,0 +1,42 @@
+import { GuruluConsent } from './consent.ts';
+import type { InitOptions } from './types.ts';
+export interface PageOverride {
+    url?: string;
+    title?: string;
+    referrer?: string;
+}
+export declare class Gurulu {
+    private initialized;
+    private opts;
+    private queue;
+    private session;
+    private anonymousId;
+    private autocaptureHandle;
+    consent: GuruluConsent;
+    /**
+     * 1-line init. Idempotent — second call no-ops with debug warning.
+     */
+    init(opts: InitOptions): void;
+    /** Manual `track()` — typed via codegen (`@gurulu/web/generated`). */
+    track(eventKey: string, properties?: Record<string, unknown>): void;
+    /** Manual `page()` — SPA route helper for non-history flows. */
+    page(override?: PageOverride): void;
+    /**
+     * Identify — anonymous → person merge.
+     * Stores person_id locally + best-effort POST /v1/ingest/identify.
+     */
+    identify(personId: string, traits?: Record<string, unknown>): Promise<void>;
+    /** Logout — wipes person_id, rotates anonymous_id, new session. */
+    reset(): void;
+    /** Manual flush — caller may await. */
+    flush(): Promise<void>;
+    /** Tracking opt-out — all subsequent track/identify no-op. */
+    optOut(): void;
+    /** Re-enable tracking. */
+    optIn(): void;
+    private queueEvent;
+    private snapshotConsent;
+    private consentAllowsAnalytics;
+    private buildContext;
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAiB7C,OAAO,KAAK,EAIV,WAAW,EAEZ,MAAM,YAAY,CAAC;AA8BpB,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,iBAAiB,CAAwC;IACjE,OAAO,EAAG,aAAa,CAAC;IAExB;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IA8E7B,sEAAsE;IACtE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAInE,gEAAgE;IAChE,IAAI,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI;IAQnC;;;OAGG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BjF,mEAAmE;IACnE,KAAK,IAAI,IAAI;IAeb,uCAAuC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,8DAA8D;IAC9D,MAAM,IAAI,IAAI;IAId,0BAA0B;IAC1B,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,UAAU;IAgClB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,YAAY;CAcrB"}

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+export declare class SDKError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class InitError extends SDKError {
+    constructor(message: string);
+}
+export declare class NetworkError extends SDKError {
+    readonly status?: number;
+    constructor(message: string, status?: number);
+}
+export declare class QueueFullError extends SDKError {
+    constructor(message: string);
+}
+export declare class OptedOutError extends SDKError {
+    constructor();
+}
+export declare class ConsentBlockedError extends SDKError {
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAIA,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,qBAAa,SAAU,SAAQ,QAAQ;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,YAAa,SAAQ,QAAQ;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAK7C;AAED,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,aAAc,SAAQ,QAAQ;;CAK1C;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;;CAKhD"}

package/dist/identity.d.ts

@@ -0,0 +1,6 @@
+export declare function getOrCreateAnonymousId(): string;
+export declare function setPersonId(personId: string): void;
+export declare function getPersonId(): string | null;
+export declare function clearIdentity(): string;
+export declare function newEventId(): string;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAwEA,wBAAgB,sBAAsB,IAAI,MAAM,CAY/C;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAE3C;AAED,wBAAgB,aAAa,IAAI,MAAM,CAOtC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/index.d.ts

@@ -1,80 +1,45 @@
-/**
- * @gurulu/web — Gurulu Web SDK
- *
- * Programmatic interface for Gurulu analytics.
- * For React/Next.js, use `@gurulu/web/react` instead.
- */
-export interface GuruluConfig {
-    siteId: string;
-    token: string;
-    endpoint?: string;
-    features?: Array<'errors' | 'replay' | 'vitals'>;
-    autoTrack?: boolean;
-    consent?: 'full' | 'analytics' | 'necessary' | 'none';
-    debug?: boolean;
+export declare const VERSION = "0.1.0";
+export { type BannerConfig, type BannerConfigResponse, type ConsentCategories, type ConsentSnapshot, GuruluConsent, type GuruluConsentOptions, } from './consent.ts';
+export { Gurulu, type PageOverride } from './core.ts';
+export { ConsentBlockedError, InitError, NetworkError, OptedOutError, QueueFullError, SDKError, } from './errors.ts';
+export type { AutocaptureConfig, ClickIdContext, ConsentCategoriesState, EventContext, EventProducer, EventType, InitOptions, OutgoingEvent, UTMContext, } from './types.ts';
+import { Gurulu } from './core.ts';
+import type { InitOptions } from './types.ts';
+export interface GuruluPublicSDK {
+    init: (opts: InitOptions) => void;
+    track: (eventKey: string, properties?: Record<string, unknown>) => void;
+    identify: (personId: string, traits?: Record<string, unknown>) => Promise<void>;
+    page: (override?: Parameters<Gurulu['page']>[0]) => void;
+    reset: () => void;
+    flush: () => Promise<void>;
+    optOut: () => void;
+    optIn: () => void;
+    consent: Gurulu['consent'];
+    VERSION: string;
 }
-export interface GuruluInstance {
-    track: (eventName: string, properties?: Record<string, unknown>) => void;
-    identify: (userId: string, traits?: Record<string, unknown>) => void;
-    purchase: (params: {
-        value: number;
-        currency: string;
-        transaction_id?: string;
-        items?: unknown[];
-    }) => void;
-    subscribe: (params: {
-        value: number;
-        currency: string;
-        plan_id?: string;
-        interval?: string;
-    }) => void;
-    login: (params?: {
-        method?: string;
-    }) => void;
-    signup: (params?: {
-        method?: string;
-    }) => void;
-    logout: () => void;
-    setConsent: (level: string) => void;
-    destroy: () => void;
-}
-declare let _config: GuruluConfig | null;
-/**
- * Initialize the Gurulu tracker by injecting the script tag.
- * Call once at app startup.
- */
-export declare function init(config: GuruluConfig): void;
-/**
- * Get the global gurulu instance (available after tracker loads).
- */
-export declare function getInstance(): GuruluInstance | null;
-/**
- * Track a custom event.
- */
-export declare function track(eventName: string, properties?: Record<string, unknown>): void;
-/**
- * Identify a user with traits.
- */
-export declare function identify(userId: string, traits?: Record<string, unknown>): void;
-/**
- * Track a purchase event.
- */
-export declare function purchase(params: {
-    value: number;
-    currency: string;
-    transaction_id?: string;
-}): void;
-/**
- * Track a subscription event.
- */
-export declare function subscribe(params: {
-    value: number;
-    currency: string;
-    plan_id?: string;
-    interval?: string;
-}): void;
 /**
- * Set consent level.
- */
-export declare function setConsent(level: string): void;
-export { _config as config };
+ * Factory — `createGurulu()` returns an isolated instance (multi-tenant SDK or
+ * test harness). For 99% of consumers, prefer the default singleton via the
+ * default export below.
+ */
+export declare function createGurulu(): Gurulu;
+declare const publicSdk: {
+    init: (opts: InitOptions) => void;
+    track: (eventKey: string, properties?: Record<string, unknown>) => void;
+    identify: (personId: string, traits?: Record<string, unknown>) => Promise<void>;
+    page: (override?: Parameters<Gurulu["page"]>[0]) => void;
+    reset: () => void;
+    flush: () => Promise<void>;
+    optOut: () => void;
+    optIn: () => void;
+    readonly consent: import("./consent.ts").GuruluConsent;
+    VERSION: string;
+};
+/**
+ * Script-tag auto-init — reads `<script data-workspace="pk_xxx" ...>` and
+ * runs `init()` automatically. No-op in non-browser environments and when
+ * the script is loaded via ESM import (no `data-workspace` attr).
+ */
+export declare function autoBootstrap(): void;
+export default publicSdk;
+//# 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":"AAeA,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,aAAa,EACb,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,aAAa,EACb,cAAc,EACd,QAAQ,GACT,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,WAAW,EACX,aAAa,EACb,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IAClC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACxE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACzD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,QAAA,MAAM,SAAS;iBACA,WAAW;sBACN,MAAM,eAAe,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;yBAEzC,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;sBAE3C,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;;;;;;;CAShD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAwBpC;AAOD,eAAe,SAAS,CAAC"}