@we8/astro 0.1.0

package/dist/consent.js

@@ -0,0 +1,121 @@
+import { getSessionId } from './session.js';
+/** Where a visitor's consent decision is persisted in the browser. */
+export const CONSENT_STORAGE_KEY = 'we8:consent';
+/**
+ * The DOM event dispatched (and listened for) when a decision is recorded, so
+ * anything gated on consent (the visit beacon, an embedded map, a third-party
+ * script) can start the moment the visitor says yes, without a page reload.
+ */
+export const CONSENT_EVENT = 'we8:consent';
+function defaultStorage() {
+    try {
+        return typeof localStorage !== 'undefined' ? localStorage : null;
+    }
+    catch {
+        // Even referencing localStorage can throw in a sandboxed iframe.
+        return null;
+    }
+}
+function defaultTarget() {
+    return typeof window !== 'undefined' ? window : null;
+}
+function isDecision(value) {
+    return value === 'accepted' || value === 'partial' || value === 'declined';
+}
+/**
+ * Read the stored decision, or `null` when the visitor has not chosen yet (so
+ * a banner knows to show itself). A corrupt or unreadable store also reads as
+ * `null`: an unparseable decision is not a decision.
+ */
+export function readConsent(storage = defaultStorage()) {
+    if (!storage)
+        return null;
+    let raw;
+    try {
+        raw = storage.getItem(CONSENT_STORAGE_KEY);
+    }
+    catch {
+        return null;
+    }
+    if (!raw)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        if (!isDecision(parsed.decision))
+            return null;
+        return {
+            decision: parsed.decision,
+            analytics: parsed.analytics === true,
+            performance: parsed.performance === true,
+            decidedAt: typeof parsed.decidedAt === 'string' ? parsed.decidedAt : '',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** True when the visitor has granted analytics consent. Convenience for gating a beacon. */
+export function analyticsAllowed(storage = defaultStorage()) {
+    return readConsent(storage)?.analytics === true;
+}
+/** Persist a decision locally and announce it. Storage failures are non-fatal. */
+export function writeConsent(state, storage = defaultStorage(), target = defaultTarget()) {
+    if (storage) {
+        try {
+            storage.setItem(CONSENT_STORAGE_KEY, JSON.stringify(state));
+        }
+        catch {
+            // A blocked or full store must not break the banner; the decision still
+            // applies to this page view, it just will not survive a reload.
+        }
+    }
+    if (target?.dispatchEvent && typeof CustomEvent === 'function') {
+        target.dispatchEvent(new CustomEvent(CONSENT_EVENT, { detail: state }));
+    }
+}
+/**
+ * Record a visitor's consent decision: persist it locally FIRST (so the
+ * decision is honored even if the network is down), announce it, then report
+ * it to the analytics API. Never rejects; a failed report is invisible to the
+ * visitor and does not weaken the decision.
+ */
+export async function recordConsent(client, choice, options = {}) {
+    const state = { ...choice, decidedAt: new Date().toISOString() };
+    writeConsent(state, options.storage === undefined ? defaultStorage() : options.storage, options.target === undefined ? defaultTarget() : options.target);
+    try {
+        await client.events.consent({
+            sessionId: options.sessionId ?? getSessionId(),
+            decision: state.decision,
+            analytics: state.analytics,
+            performance: state.performance,
+        });
+    }
+    catch {
+        // Intentionally silent: the visitor's choice is already in effect.
+    }
+    return state;
+}
+/**
+ * Run `handler` once analytics consent exists: immediately if it already does,
+ * otherwise on the next consent decision that grants it. Returns a cleanup
+ * function that detaches the listener.
+ */
+export function onAnalyticsConsent(handler, options = {}) {
+    const storage = options.storage === undefined ? defaultStorage() : options.storage;
+    const target = options.target === undefined ? defaultTarget() : options.target;
+    if (analyticsAllowed(storage)) {
+        handler();
+        return () => undefined;
+    }
+    if (!target)
+        return () => undefined;
+    const listener = () => {
+        if (analyticsAllowed(storage)) {
+            target.removeEventListener(CONSENT_EVENT, listener);
+            handler();
+        }
+    };
+    target.addEventListener(CONSENT_EVENT, listener);
+    return () => target.removeEventListener(CONSENT_EVENT, listener);
+}
+//# sourceMappingURL=consent.js.map

package/dist/consent.js.map

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

package/dist/content.d.ts

@@ -0,0 +1,36 @@
+import type { SiteDocumentKind, We8Document, We8PostDetail, We8PostList, We8PostListParams, We8SiteConfig } from '@we8/client';
+import { type We8AstroConfig } from './config.js';
+export interface BuildFetchOptions {
+    /** Explicit config, overriding the env-derived default. */
+    config?: We8AstroConfig;
+    /** A fetch implementation (tests, or a custom transport). */
+    fetch?: typeof fetch;
+}
+/**
+ * Build-time: fetch a page of published posts. Call this from an Astro
+ * component's frontmatter (runs in Node during `astro build`). Requires
+ * `WE8_KEY` and `WE8_API_URL` in the environment.
+ */
+export declare function getPosts(params?: We8PostListParams, options?: BuildFetchOptions): Promise<We8PostList>;
+/** Build-time: fetch a single published post (with its JSON-LD) by slug. */
+export declare function getPost(slug: string, options?: BuildFetchOptions): Promise<We8PostDetail>;
+/**
+ * Build-time: page through every published post and collect its slug. Handy for
+ * an Astro `getStaticPaths` (one page per post) and for sitemap merging. Uses
+ * the LARGEST page size the engine accepts and stops when it has seen `total`
+ * posts or an empty page.
+ */
+export declare function getPostSlugs(options?: BuildFetchOptions): Promise<string[]>;
+/**
+ * Build-time: fetch the site identity card (name, canonical URL, SEO
+ * fallbacks, publisher, posts path). Pair with `mergeSeo` for the code-first
+ * merge: your template's values win, this config fills the gaps.
+ */
+export declare function getSiteConfig(options?: BuildFetchOptions): Promise<We8SiteConfig>;
+/**
+ * Build-time: fetch a site document (design.md or llms.txt, ME3b). Content is
+ * `''` when the tenant never wrote one; a starter route can render that
+ * straight through (an empty file) or skip serving it, its choice.
+ */
+export declare function getDocument(kind: SiteDocumentKind, options?: BuildFetchOptions): Promise<We8Document>;
+//# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAoC,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEpF,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAMD;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,MAAM,CAAC,EAAE,iBAAiB,EAC1B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED,4EAA4E;AAC5E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,CAE7F;AAKD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAcrF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,CAErF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,WAAW,CAAC,CAEtB"}

package/dist/content.js

@@ -0,0 +1,58 @@
+import { createBuildClient, resolveConfig } from './config.js';
+function clientFor(options) {
+    return createBuildClient(options.config ?? resolveConfig(), options.fetch);
+}
+/**
+ * Build-time: fetch a page of published posts. Call this from an Astro
+ * component's frontmatter (runs in Node during `astro build`). Requires
+ * `WE8_KEY` and `WE8_API_URL` in the environment.
+ */
+export function getPosts(params, options = {}) {
+    return clientFor(options).posts.list(params);
+}
+/** Build-time: fetch a single published post (with its JSON-LD) by slug. */
+export function getPost(slug, options = {}) {
+    return clientFor(options).posts.get(slug);
+}
+/** A safety cap on pagination so a bad `total` can never spin forever. */
+const MAX_SLUG_PAGES = 1000;
+/**
+ * Build-time: page through every published post and collect its slug. Handy for
+ * an Astro `getStaticPaths` (one page per post) and for sitemap merging. Uses
+ * the LARGEST page size the engine accepts and stops when it has seen `total`
+ * posts or an empty page.
+ */
+export async function getPostSlugs(options = {}) {
+    const client = clientFor(options);
+    const slugs = [];
+    // paginationQuerySchema caps pageSize at 50 (packages/shared); asking for
+    // more is a 400 from the real engine, which fakes can't see (Gate R5 catch:
+    // the original 100 here passed every fake-backed test and would have made
+    // every real getStaticPaths/mergeSitemap call fail at build time).
+    const pageSize = 50;
+    for (let page = 1; page <= MAX_SLUG_PAGES; page++) {
+        const { items, total } = await client.posts.list({ page, pageSize });
+        for (const post of items)
+            slugs.push(post.slug);
+        if (items.length === 0 || slugs.length >= total)
+            break;
+    }
+    return slugs;
+}
+/**
+ * Build-time: fetch the site identity card (name, canonical URL, SEO
+ * fallbacks, publisher, posts path). Pair with `mergeSeo` for the code-first
+ * merge: your template's values win, this config fills the gaps.
+ */
+export function getSiteConfig(options = {}) {
+    return clientFor(options).site.config();
+}
+/**
+ * Build-time: fetch a site document (design.md or llms.txt, ME3b). Content is
+ * `''` when the tenant never wrote one; a starter route can render that
+ * straight through (an empty file) or skip serving it, its choice.
+ */
+export function getDocument(kind, options = {}) {
+    return clientFor(options).documents.get(kind);
+}
+//# sourceMappingURL=content.js.map

package/dist/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAuB,MAAM,aAAa,CAAC;AASpF,SAAS,SAAS,CAAC,OAA0B;IAC3C,OAAO,iBAAiB,CAAC,OAAO,CAAC,MAAM,IAAI,aAAa,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,MAA0B,EAC1B,UAA6B,EAAE;IAE/B,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,UAA6B,EAAE;IACnE,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,0EAA0E;AAC1E,MAAM,cAAc,GAAG,IAAI,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAA6B,EAAE;IAChE,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,0EAA0E;IAC1E,4EAA4E;IAC5E,0EAA0E;IAC1E,mEAAmE;IACnE,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC;QAClD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrE,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK;YAAE,MAAM;IACzD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,UAA6B,EAAE;IAC3D,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,IAAsB,EACtB,UAA6B,EAAE;IAE/B,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/dist/form.d.ts

@@ -0,0 +1,22 @@
+import type { We8Client, We8FormSubmitResult } from '@we8/client';
+export interface EnhanceFormOptions {
+    /** The form key to submit to (`/v1/forms/{formKey}/submissions`). */
+    formKey: string;
+    /**
+     * The name of the Turnstile token field to lift out of the form data and pass
+     * as the SDK's `turnstileToken`. Defaults to Cloudflare Turnstile's
+     * `cf-turnstile-response`. The engine expects the token as `turnstileToken`,
+     * so this mapping is what makes a stock Turnstile widget just work.
+     */
+    turnstileField?: string;
+    onSuccess?: (result: We8FormSubmitResult) => void;
+    onError?: (error: unknown) => void;
+}
+/**
+ * Progressively enhance a native `<form>`: intercept submit, POST it through
+ * the we8 SDK (so the page still works without JS as a plain form as long as the
+ * template provides a no-JS fallback), and route the outcome to `onSuccess` /
+ * `onError`. Returns a cleanup function that detaches the listener.
+ */
+export declare function enhanceForm(form: HTMLFormElement, client: We8Client, options: EnhanceFormOptions): () => void;
+//# sourceMappingURL=form.d.ts.map

package/dist/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../src/form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAe,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE/E,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAmBD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,kBAAkB,GAC1B,MAAM,IAAI,CAiBZ"}

package/dist/form.js

@@ -0,0 +1,39 @@
+const DEFAULT_TURNSTILE_FIELD = 'cf-turnstile-response';
+/** Collect a form's fields into a plain data object for `forms.submit`. */
+function formToData(form) {
+    const data = {};
+    for (const [key, value] of new FormData(form).entries()) {
+        data[key] = typeof value === 'string' ? value : value.name;
+    }
+    return data;
+}
+function takeField(data, key) {
+    const value = data[key];
+    delete data[key];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+/**
+ * Progressively enhance a native `<form>`: intercept submit, POST it through
+ * the we8 SDK (so the page still works without JS as a plain form as long as the
+ * template provides a no-JS fallback), and route the outcome to `onSuccess` /
+ * `onError`. Returns a cleanup function that detaches the listener.
+ */
+export function enhanceForm(form, client, options) {
+    const handler = (event) => {
+        event.preventDefault();
+        const data = formToData(form);
+        const turnstileToken = takeField(data, options.turnstileField ?? DEFAULT_TURNSTILE_FIELD);
+        void client.forms
+            .submit(options.formKey, data, turnstileToken ? { turnstileToken } : {})
+            .then((result) => {
+            options.onSuccess?.(result);
+            form.reset();
+        })
+            .catch((error) => {
+            options.onError?.(error);
+        });
+    };
+    form.addEventListener('submit', handler);
+    return () => form.removeEventListener('submit', handler);
+}
+//# sourceMappingURL=form.js.map

package/dist/form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.js","sourceRoot":"","sources":["../src/form.ts"],"names":[],"mappings":"AAgBA,MAAM,uBAAuB,GAAG,uBAAuB,CAAC;AAExD,2EAA2E;AAC3E,SAAS,UAAU,CAAC,IAAqB;IACvC,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS,CAAC,IAA6B,EAAE,GAAW;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,IAAqB,EACrB,MAAiB,EACjB,OAA2B;IAE3B,MAAM,OAAO,GAAG,CAAC,KAAkB,EAAQ,EAAE;QAC3C,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,IAAI,uBAAuB,CAAC,CAAC;QAC1F,KAAK,MAAM,CAAC,KAAK;aACd,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IACF,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { we8 } from './integration.js';
+export type { We8AstroIntegration, We8IntegrationOptions } from './integration.js';
+export { API_URL_ENV, KEY_ENV, createBuildClient, resolveConfig, tryResolveConfig } from './config.js';
+export type { EnvLike, We8AstroConfig } from './config.js';
+export { getDocument, getPost, getPostSlugs, getPosts, getSiteConfig } from './content.js';
+export type { BuildFetchOptions } from './content.js';
+export { mergeSeo, postUrl, robotsTxt } from './seo.js';
+export type { PageSeo, ResolvedSeo } from './seo.js';
+export { mergeSitemap, we8SitemapUrl } from './sitemap.js';
+export type { MergeSitemapOptions } from './sitemap.js';
+export { getSessionId } from './session.js';
+export type { StorageLike } from './session.js';
+export { sendVisit, trackVisit } from './beacon.js';
+export type { BeaconOptions, TrackVisitOptions } from './beacon.js';
+export { CONSENT_EVENT, CONSENT_STORAGE_KEY, analyticsAllowed, onAnalyticsConsent, readConsent, recordConsent, writeConsent, } from './consent.js';
+export type { ConsentState, EventTargetLike, RecordConsentOptions } from './consent.js';
+export { enhanceForm } from './form.js';
+export type { EnhanceFormOptions } from './form.js';
+export { We8ApiError, createClient, isWe8ApiError } from '@we8/client';
+export type { ConsentDecision, Cta, PostType, SiteDocumentKind, We8Author, We8Client, We8ClientOptions, We8Document, We8FormData, We8FormSubmitResult, We8Post, We8PostDetail, We8PostList, We8PostListParams, We8SiteConfig, } from '@we8/client';
+//# 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":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACvG,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3F,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAKpD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EACV,eAAe,EACf,GAAG,EACH,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,OAAO,EACP,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,aAAa,GACd,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export { we8 } from './integration.js';
+export { API_URL_ENV, KEY_ENV, createBuildClient, resolveConfig, tryResolveConfig } from './config.js';
+export { getDocument, getPost, getPostSlugs, getPosts, getSiteConfig } from './content.js';
+export { mergeSeo, postUrl, robotsTxt } from './seo.js';
+export { mergeSitemap, we8SitemapUrl } from './sitemap.js';
+export { getSessionId } from './session.js';
+export { sendVisit, trackVisit } from './beacon.js';
+export { CONSENT_EVENT, CONSENT_STORAGE_KEY, analyticsAllowed, onAnalyticsConsent, readConsent, recordConsent, writeConsent, } from './consent.js';
+export { enhanceForm } from './form.js';
+// Re-export the client factory plus key types so a template can `import
+// { createClient } from '@we8/astro'` for its own custom calls without a
+// second dependency.
+export { We8ApiError, createClient, isWe8ApiError } from '@we8/client';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvG,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE3F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,wEAAwE;AACxE,yEAAyE;AACzE,qBAAqB;AACrB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/integration.d.ts

@@ -0,0 +1,40 @@
+export interface We8IntegrationOptions {
+    /** Override the env-derived key (otherwise read from `WE8_PUBLISHABLE_KEY`). */
+    key?: string;
+    /** Override the env-derived API URL (otherwise read from `WE8_API_URL`). */
+    apiUrl?: string;
+    /**
+     * Suppress the missing-configuration warnings. Set this in a template that
+     * deliberately falls back to its own data source (fixtures, a different
+     * backend) when we8 is not configured, so an intentional offline build is
+     * quiet rather than noisy.
+     */
+    optional?: boolean;
+}
+/** A tiny slice of Astro's logger, all this integration uses. */
+interface HookLogger {
+    info(message: string): void;
+    warn(message: string): void;
+}
+/**
+ * A structural match for Astro's `AstroIntegration`, declared locally so this
+ * package can be typechecked without Astro installed (Astro is an optional peer
+ * dependency). The object it describes is a valid `AstroIntegration` at runtime.
+ */
+export interface We8AstroIntegration {
+    name: string;
+    hooks: {
+        'astro:config:setup'?: (options: {
+            logger?: HookLogger;
+        }) => void;
+    };
+}
+/**
+ * The we8 Astro integration. Add it to `integrations` in `astro.config`. It
+ * checks configuration at build start and warns (rather than silently
+ * proceeding) when the key or the API URL is missing, so a misconfigured site
+ * fails loudly instead of shipping a dead beacon or empty content.
+ */
+export declare function we8(options?: We8IntegrationOptions): We8AstroIntegration;
+export {};
+//# sourceMappingURL=integration.d.ts.map

package/dist/integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,iEAAiE;AACjE,UAAU,UAAU;IAClB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QACL,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE;YAAE,MAAM,CAAC,EAAE,UAAU,CAAA;SAAE,KAAK,IAAI,CAAC;KACnE,CAAC;CACH;AAOD;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,OAAO,GAAE,qBAA0B,GAAG,mBAAmB,CA4B5E"}

package/dist/integration.js

@@ -0,0 +1,37 @@
+import { API_URL_ENV, KEY_ENV } from './config.js';
+function readEnv(key) {
+    const g = globalThis;
+    return g.process?.env?.[key];
+}
+/**
+ * The we8 Astro integration. Add it to `integrations` in `astro.config`. It
+ * checks configuration at build start and warns (rather than silently
+ * proceeding) when the key or the API URL is missing, so a misconfigured site
+ * fails loudly instead of shipping a dead beacon or empty content.
+ */
+export function we8(options = {}) {
+    return {
+        name: '@we8/astro',
+        hooks: {
+            'astro:config:setup': ({ logger }) => {
+                const key = options.key ?? readEnv(KEY_ENV);
+                const apiUrl = options.apiUrl ?? readEnv(API_URL_ENV);
+                if (key && apiUrl) {
+                    logger?.info(`ready (API ${apiUrl}).`);
+                    return;
+                }
+                if (options.optional) {
+                    logger?.info('not configured; the site builds from its own data source.');
+                    return;
+                }
+                if (!key) {
+                    logger?.warn(`${KEY_ENV} is not set; the visit beacon, consent, and forms will not authenticate until it is.`);
+                }
+                if (!apiUrl) {
+                    logger?.warn(`${API_URL_ENV} is not set; build-time content (getPosts/getPost) will fail until it is.`);
+                }
+            },
+        },
+    };
+}
+//# sourceMappingURL=integration.js.map

package/dist/integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.js","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAkCnD,SAAS,OAAO,CAAC,GAAW;IAC1B,MAAM,CAAC,GAAG,UAAwE,CAAC;IACnF,OAAO,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CAAC,UAAiC,EAAE;IACrD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE;YACL,oBAAoB,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;gBACnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;gBACtD,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;oBAClB,MAAM,EAAE,IAAI,CAAC,cAAc,MAAM,IAAI,CAAC,CAAC;oBACvC,OAAO;gBACT,CAAC;gBACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;oBACrB,MAAM,EAAE,IAAI,CAAC,2DAA2D,CAAC,CAAC;oBAC1E,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,MAAM,EAAE,IAAI,CACV,GAAG,OAAO,sFAAsF,CACjG,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,EAAE,IAAI,CACV,GAAG,WAAW,2EAA2E,CAC1F,CAAC;gBACJ,CAAC;YACH,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/seo.d.ts

@@ -0,0 +1,51 @@
+import type { PostType, We8SiteConfig } from '@we8/client';
+/** The SEO values a page (or layout) declares for itself. All optional. */
+export interface PageSeo {
+    title?: string;
+    description?: string;
+    ogTitle?: string;
+    ogDescription?: string;
+    ogImageUrl?: string;
+}
+/** The resolved head values after the code-first merge. */
+export interface ResolvedSeo {
+    /** The full document title (template applied when configured). */
+    title: string;
+    description?: string;
+    ogTitle?: string;
+    ogDescription?: string;
+    ogImageUrl?: string;
+    twitterHandle?: string;
+    /** True when the site is configured to discourage search engines. */
+    noindex: boolean;
+}
+/**
+ * The code-first merge (MC): the PAGE's values always win; the site config
+ * fills the gaps. Title semantics: a page title gets the site's titleTemplate
+ * applied ("%s" is the placeholder); a page WITHOUT its own title falls back
+ * to seo.defaultTitle (template NOT applied, it already names the site), then
+ * the site name. OG fields cascade page og -> page base -> site og -> site
+ * base, so a page description doubles as its og:description unless overridden.
+ */
+export declare function mergeSeo(page: PageSeo, site: We8SiteConfig): ResolvedSeo;
+/**
+ * A robots.txt body honoring the site's discourageSearchEngines flag. Serve it
+ * from a template endpoint (e.g. `src/pages/robots.txt.ts` returning this
+ * string); pass `sitemapUrl` (from `we8SitemapUrl()`) to advertise the sitemap
+ * when the site is indexable.
+ */
+export declare function robotsTxt(site: We8SiteConfig, options?: {
+    sitemapUrl?: string;
+}): string;
+/**
+ * The absolute URL a post is published at on the tenant's own site: the
+ * type's section path from the resolved contentPaths map (every type present
+ * in the public site config), joined with the slug. The single source of
+ * truth for post URLs in templates; pairs with the engine's sitemap and
+ * JSON-LD, which resolve through the same rule.
+ */
+export declare function postUrl(post: {
+    slug: string;
+    type: PostType;
+}, site: We8SiteConfig): string;
+//# sourceMappingURL=seo.d.ts.map

package/dist/seo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG3D,2EAA2E;AAC3E,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,WAAW,CA6BxE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAO5F;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAI3F"}

package/dist/seo.js

@@ -0,0 +1,63 @@
+/**
+ * The code-first merge (MC): the PAGE's values always win; the site config
+ * fills the gaps. Title semantics: a page title gets the site's titleTemplate
+ * applied ("%s" is the placeholder); a page WITHOUT its own title falls back
+ * to seo.defaultTitle (template NOT applied, it already names the site), then
+ * the site name. OG fields cascade page og -> page base -> site og -> site
+ * base, so a page description doubles as its og:description unless overridden.
+ */
+export function mergeSeo(page, site) {
+    const seo = site.seo;
+    const title = page.title
+        ? seo.titleTemplate
+            ? seo.titleTemplate.replace('%s', page.title)
+            : page.title
+        : (seo.defaultTitle ?? site.name ?? '');
+    const description = page.description ?? seo.metaDescription;
+    const resolved = {
+        title,
+        noindex: seo.discourageSearchEngines,
+    };
+    if (description !== undefined)
+        resolved.description = description;
+    const ogTitle = page.ogTitle ?? page.title ?? seo.ogTitle ?? seo.defaultTitle;
+    if (ogTitle !== undefined)
+        resolved.ogTitle = ogTitle;
+    const ogDescription = page.ogDescription ?? page.description ?? seo.ogDescription ?? seo.metaDescription;
+    if (ogDescription !== undefined)
+        resolved.ogDescription = ogDescription;
+    const ogImageUrl = page.ogImageUrl ?? seo.ogImageUrl;
+    if (ogImageUrl !== undefined)
+        resolved.ogImageUrl = ogImageUrl;
+    if (seo.twitterHandle !== undefined)
+        resolved.twitterHandle = seo.twitterHandle;
+    return resolved;
+}
+/**
+ * A robots.txt body honoring the site's discourageSearchEngines flag. Serve it
+ * from a template endpoint (e.g. `src/pages/robots.txt.ts` returning this
+ * string); pass `sitemapUrl` (from `we8SitemapUrl()`) to advertise the sitemap
+ * when the site is indexable.
+ */
+export function robotsTxt(site, options = {}) {
+    if (site.seo.discourageSearchEngines) {
+        return 'User-agent: *\nDisallow: /\n';
+    }
+    const lines = ['User-agent: *', 'Allow: /'];
+    if (options.sitemapUrl)
+        lines.push('', `Sitemap: ${options.sitemapUrl}`);
+    return lines.join('\n') + '\n';
+}
+/**
+ * The absolute URL a post is published at on the tenant's own site: the
+ * type's section path from the resolved contentPaths map (every type present
+ * in the public site config), joined with the slug. The single source of
+ * truth for post URLs in templates; pairs with the engine's sitemap and
+ * JSON-LD, which resolve through the same rule.
+ */
+export function postUrl(post, site) {
+    const prefix = site.contentPaths[post.type] ?? site.postsPathPrefix;
+    const base = site.siteUrl.replace(/\/+$/, '');
+    return `${base}${prefix}/${post.slug}`;
+}
+//# sourceMappingURL=seo.js.map

package/dist/seo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.js","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"AAyBA;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAa,EAAE,IAAmB;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IAErB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK;QACtB,CAAC,CAAC,GAAG,CAAC,aAAa;YACjB,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;YAC7C,CAAC,CAAC,IAAI,CAAC,KAAK;QACd,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAE1C,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,GAAG,CAAC,eAAe,CAAC;IAC5D,MAAM,QAAQ,GAAgB;QAC5B,KAAK;QACL,OAAO,EAAE,GAAG,CAAC,uBAAuB;KACrC,CAAC;IACF,IAAI,WAAW,KAAK,SAAS;QAAE,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;IAElE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,YAAY,CAAC;IAC9E,IAAI,OAAO,KAAK,SAAS;QAAE,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;IAEtD,MAAM,aAAa,GACjB,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,WAAW,IAAI,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,eAAe,CAAC;IACrF,IAAI,aAAa,KAAK,SAAS;QAAE,QAAQ,CAAC,aAAa,GAAG,aAAa,CAAC;IAExE,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC;IACrD,IAAI,UAAU,KAAK,SAAS;QAAE,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;IAE/D,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS;QAAE,QAAQ,CAAC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;IAEhF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAmB,EAAE,UAAmC,EAAE;IAClF,IAAI,IAAI,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC;QACrC,OAAO,8BAA8B,CAAC;IACxC,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACzE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,IAAsC,EAAE,IAAmB;IACjF,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC;IACpE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9C,OAAO,GAAG,IAAI,GAAG,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,17 @@
+/** The minimal storage surface `getSessionId` needs; `localStorage` satisfies it. */
+export interface StorageLike {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+/**
+ * A stable per-visitor session id, persisted in `localStorage` so views dedupe
+ * and a visitor's events group across a session. Pass a `storage` in tests. In
+ * an SSR context (no storage) it returns a fresh ephemeral id each call.
+ *
+ * The whole read/write is guarded: a storage that exists but is unusable (a
+ * sandboxed iframe, cookies blocked, quota exceeded, or Node's `localStorage`
+ * without a backing file) throws on `getItem`/`setItem`, and we degrade to an
+ * ephemeral id rather than letting analytics break the page.
+ */
+export declare function getSessionId(storage?: StorageLike | null): string;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAuBD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,WAAW,GAAG,IAAuB,GAAG,MAAM,CAcnF"}

package/dist/session.js

@@ -0,0 +1,46 @@
+const SESSION_KEY = 'we8:sessionId';
+function randomId() {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    // Defensive fallback for a browser without crypto.randomUUID. Not used for
+    // anything security-sensitive: this id only dedupes views and groups a
+    // visitor's events.
+    return `s_${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;
+}
+function defaultStorage() {
+    try {
+        return typeof localStorage !== 'undefined' ? localStorage : null;
+    }
+    catch {
+        // Even referencing localStorage can throw in a sandboxed iframe.
+        return null;
+    }
+}
+/**
+ * A stable per-visitor session id, persisted in `localStorage` so views dedupe
+ * and a visitor's events group across a session. Pass a `storage` in tests. In
+ * an SSR context (no storage) it returns a fresh ephemeral id each call.
+ *
+ * The whole read/write is guarded: a storage that exists but is unusable (a
+ * sandboxed iframe, cookies blocked, quota exceeded, or Node's `localStorage`
+ * without a backing file) throws on `getItem`/`setItem`, and we degrade to an
+ * ephemeral id rather than letting analytics break the page.
+ */
+export function getSessionId(storage = defaultStorage()) {
+    if (storage) {
+        try {
+            let id = storage.getItem(SESSION_KEY);
+            if (!id) {
+                id = randomId();
+                storage.setItem(SESSION_KEY, id);
+            }
+            return id;
+        }
+        catch {
+            // Fall through to an ephemeral id below.
+        }
+    }
+    return randomId();
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,GAAG,eAAe,CAAC;AAEpC,SAAS,QAAQ;IACf,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC7E,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IACD,2EAA2E;IAC3E,uEAAuE;IACvE,oBAAoB;IACpB,OAAO,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,OAAO,OAAO,YAAY,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,UAA8B,cAAc,EAAE;IACzE,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,IAAI,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACtC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,EAAE,GAAG,QAAQ,EAAE,CAAC;gBAChB,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACnC,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,EAAE,CAAC;AACpB,CAAC"}