@syntrologie/runtime-sdk 0.2.20 → 1.0.1-canary.0

package/dist/state/StateStore.d.ts

@@ -0,0 +1,41 @@
+/**
+ * StateStore - Unified state management for the runtime.
+ *
+ * Provides scoped storage (session and user) with built-in helpers
+ * for common patterns like dismissals, cooldowns, and frequency caps.
+ */
+import type { ScopedStorage, DismissalStore, CooldownStore, FrequencyStore } from "./types";
+export interface StateStoreOptions {
+    /** Namespace prefix for storage keys */
+    namespace?: string;
+}
+/**
+ * StateStore class for unified state management.
+ */
+export declare class StateStore {
+    /** Session-scoped storage (cleared on browser close) */
+    readonly session: ScopedStorage;
+    /** User-scoped storage (persists across sessions) */
+    readonly user: ScopedStorage;
+    /** Dismissal tracking */
+    readonly dismissals: DismissalStore;
+    /** Cooldown tracking */
+    readonly cooldowns: CooldownStore;
+    /** Frequency tracking */
+    readonly frequency: FrequencyStore;
+    private readonly namespace;
+    private readonly namespacedStorages;
+    constructor(options?: StateStoreOptions);
+    /**
+     * Create a namespaced storage scope.
+     * Useful for isolating state by adaptive/tile.
+     *
+     * @param namespace - Additional namespace segment
+     * @returns A ScopedStorage with the nested namespace
+     */
+    ns(namespace: string): ScopedStorage;
+}
+/**
+ * Create a StateStore instance.
+ */
+export declare function createStateStore(options?: StateStoreOptions): StateStore;

package/dist/state/StateStore.js

@@ -0,0 +1,170 @@
+import { createDismissalStore } from "./helpers/dismissals";
+import { createCooldownStore } from "./helpers/cooldowns";
+import { createFrequencyStore } from "./helpers/frequency";
+const DEFAULT_NAMESPACE = "syntro";
+/**
+ * Create a ScopedStorage backed by browser storage.
+ */
+function createBrowserStorage(storage, namespace) {
+    const prefix = `${namespace}:`;
+    return {
+        get(key) {
+            if (!storage)
+                return undefined;
+            try {
+                const raw = storage.getItem(prefix + key);
+                if (!raw)
+                    return undefined;
+                const stored = JSON.parse(raw);
+                // Check TTL
+                if (stored.expiresAt && Date.now() >= stored.expiresAt) {
+                    storage.removeItem(prefix + key);
+                    return undefined;
+                }
+                return stored.value;
+            }
+            catch {
+                return undefined;
+            }
+        },
+        set(key, value, ttlMs) {
+            if (!storage)
+                return;
+            try {
+                const stored = {
+                    value,
+                    expiresAt: ttlMs ? Date.now() + ttlMs : undefined,
+                };
+                storage.setItem(prefix + key, JSON.stringify(stored));
+            }
+            catch (err) {
+                console.warn("[StateStore] Failed to save:", err);
+            }
+        },
+        remove(key) {
+            if (!storage)
+                return;
+            storage.removeItem(prefix + key);
+        },
+        has(key) {
+            if (!storage)
+                return false;
+            return this.get(key) !== undefined;
+        },
+        keys() {
+            if (!storage)
+                return [];
+            const keys = [];
+            for (let i = 0; i < storage.length; i++) {
+                const key = storage.key(i);
+                if (key === null || key === void 0 ? void 0 : key.startsWith(prefix)) {
+                    keys.push(key.slice(prefix.length));
+                }
+            }
+            return keys;
+        },
+        clear() {
+            if (!storage)
+                return;
+            const keysToRemove = this.keys();
+            for (const key of keysToRemove) {
+                storage.removeItem(prefix + key);
+            }
+        },
+    };
+}
+/**
+ * Create an in-memory ScopedStorage (for SSR/testing).
+ */
+function createMemoryStorage(namespace) {
+    const store = new Map();
+    const prefix = `${namespace}:`;
+    return {
+        get(key) {
+            const stored = store.get(prefix + key);
+            if (!stored)
+                return undefined;
+            if (stored.expiresAt && Date.now() >= stored.expiresAt) {
+                store.delete(prefix + key);
+                return undefined;
+            }
+            return stored.value;
+        },
+        set(key, value, ttlMs) {
+            store.set(prefix + key, {
+                value,
+                expiresAt: ttlMs ? Date.now() + ttlMs : undefined,
+            });
+        },
+        remove(key) {
+            store.delete(prefix + key);
+        },
+        has(key) {
+            return this.get(key) !== undefined;
+        },
+        keys() {
+            const keys = [];
+            for (const key of store.keys()) {
+                if (key.startsWith(prefix)) {
+                    keys.push(key.slice(prefix.length));
+                }
+            }
+            return keys;
+        },
+        clear() {
+            for (const key of store.keys()) {
+                if (key.startsWith(prefix)) {
+                    store.delete(key);
+                }
+            }
+        },
+    };
+}
+/**
+ * StateStore class for unified state management.
+ */
+export class StateStore {
+    constructor(options = {}) {
+        var _a;
+        this.namespacedStorages = new Map();
+        this.namespace = (_a = options.namespace) !== null && _a !== void 0 ? _a : DEFAULT_NAMESPACE;
+        // Create scoped storages
+        if (typeof window !== "undefined") {
+            this.session = createBrowserStorage(typeof sessionStorage !== "undefined" ? sessionStorage : undefined, this.namespace);
+            this.user = createBrowserStorage(typeof localStorage !== "undefined" ? localStorage : undefined, this.namespace);
+        }
+        else {
+            // SSR fallback to in-memory storage
+            this.session = createMemoryStorage(this.namespace);
+            this.user = createMemoryStorage(this.namespace);
+        }
+        // Create helpers
+        this.dismissals = createDismissalStore(this.session, this.user);
+        this.cooldowns = createCooldownStore(this.user); // Cooldowns persist
+        this.frequency = createFrequencyStore(this.session); // Frequency is session-based
+    }
+    /**
+     * Create a namespaced storage scope.
+     * Useful for isolating state by adaptive/tile.
+     *
+     * @param namespace - Additional namespace segment
+     * @returns A ScopedStorage with the nested namespace
+     */
+    ns(namespace) {
+        const fullNamespace = `${this.namespace}:${namespace}`;
+        if (!this.namespacedStorages.has(fullNamespace)) {
+            const storage = typeof window !== "undefined" && typeof sessionStorage !== "undefined"
+                ? createBrowserStorage(sessionStorage, fullNamespace)
+                : createMemoryStorage(fullNamespace);
+            this.namespacedStorages.set(fullNamespace, storage);
+        }
+        return this.namespacedStorages.get(fullNamespace);
+    }
+}
+/**
+ * Create a StateStore instance.
+ */
+export function createStateStore(options = {}) {
+    return new StateStore(options);
+}
+//# sourceMappingURL=StateStore.js.map

package/dist/state/StateStore.js.map

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

package/dist/state/helpers/cooldowns.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Cooldown Store Implementation
+ *
+ * Tracks time-based cooldowns to prevent items from showing too frequently.
+ */
+import type { ScopedStorage, CooldownStore } from "../types";
+export declare function createCooldownStore(storage: ScopedStorage): CooldownStore;

package/dist/state/helpers/cooldowns.js

@@ -0,0 +1,31 @@
+const COOLDOWN_PREFIX = "cooldown:";
+export function createCooldownStore(storage) {
+    return {
+        set(key, durationMs) {
+            const storageKey = COOLDOWN_PREFIX + key;
+            const expiresAt = Date.now() + durationMs;
+            storage.set(storageKey, expiresAt);
+        },
+        isActive(key) {
+            return this.remaining(key) > 0;
+        },
+        remaining(key) {
+            const storageKey = COOLDOWN_PREFIX + key;
+            const expiresAt = storage.get(storageKey);
+            if (expiresAt === undefined)
+                return 0;
+            const remaining = expiresAt - Date.now();
+            if (remaining <= 0) {
+                // Clean up expired cooldown
+                storage.remove(storageKey);
+                return 0;
+            }
+            return remaining;
+        },
+        clear(key) {
+            const storageKey = COOLDOWN_PREFIX + key;
+            storage.remove(storageKey);
+        },
+    };
+}
+//# sourceMappingURL=cooldowns.js.map

package/dist/state/helpers/cooldowns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cooldowns.js","sourceRoot":"","sources":["../../../src/state/helpers/cooldowns.ts"],"names":[],"mappings":"AAOA,MAAM,eAAe,GAAG,WAAW,CAAC;AAEpC,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACxD,OAAO;QACL,GAAG,CAAC,GAAW,EAAE,UAAkB;YACjC,MAAM,UAAU,GAAG,eAAe,GAAG,GAAG,CAAC;YACzC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACrC,CAAC;QAED,QAAQ,CAAC,GAAW;YAClB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;QAED,SAAS,CAAC,GAAW;YACnB,MAAM,UAAU,GAAG,eAAe,GAAG,GAAG,CAAC;YACzC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAS,UAAU,CAAC,CAAC;YAClD,IAAI,SAAS,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAC;YAEtC,MAAM,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;gBACnB,4BAA4B;gBAC5B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC3B,OAAO,CAAC,CAAC;YACX,CAAC;YAED,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,KAAK,CAAC,GAAW;YACf,MAAM,UAAU,GAAG,eAAe,GAAG,GAAG,CAAC;YACzC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/state/helpers/dismissals.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Dismissal Store Implementation
+ *
+ * Tracks dismissed items in session or user storage.
+ */
+import type { ScopedStorage, DismissalStore } from "../types";
+export declare function createDismissalStore(sessionStorage: ScopedStorage, userStorage: ScopedStorage): DismissalStore;

package/dist/state/helpers/dismissals.js

@@ -0,0 +1,34 @@
+const DISMISSAL_PREFIX = "dismissed:";
+export function createDismissalStore(sessionStorage, userStorage) {
+    return {
+        mark(key, permanent = false) {
+            const storageKey = DISMISSAL_PREFIX + key;
+            const storage = permanent ? userStorage : sessionStorage;
+            storage.set(storageKey, true);
+        },
+        isDismissed(key) {
+            const storageKey = DISMISSAL_PREFIX + key;
+            // Check both session and user storage
+            return sessionStorage.has(storageKey) || userStorage.has(storageKey);
+        },
+        clear(key) {
+            const storageKey = DISMISSAL_PREFIX + key;
+            sessionStorage.remove(storageKey);
+            userStorage.remove(storageKey);
+        },
+        clearAll() {
+            // Clear all dismissal keys from both storages
+            for (const key of sessionStorage.keys()) {
+                if (key.startsWith(DISMISSAL_PREFIX)) {
+                    sessionStorage.remove(key);
+                }
+            }
+            for (const key of userStorage.keys()) {
+                if (key.startsWith(DISMISSAL_PREFIX)) {
+                    userStorage.remove(key);
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=dismissals.js.map

package/dist/state/helpers/dismissals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismissals.js","sourceRoot":"","sources":["../../../src/state/helpers/dismissals.ts"],"names":[],"mappings":"AAOA,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAEtC,MAAM,UAAU,oBAAoB,CAClC,cAA6B,EAC7B,WAA0B;IAE1B,OAAO;QACL,IAAI,CAAC,GAAW,EAAE,SAAS,GAAG,KAAK;YACjC,MAAM,UAAU,GAAG,gBAAgB,GAAG,GAAG,CAAC;YAC1C,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;QAED,WAAW,CAAC,GAAW;YACrB,MAAM,UAAU,GAAG,gBAAgB,GAAG,GAAG,CAAC;YAC1C,sCAAsC;YACtC,OAAO,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvE,CAAC;QAED,KAAK,CAAC,GAAW;YACf,MAAM,UAAU,GAAG,gBAAgB,GAAG,GAAG,CAAC;YAC1C,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAClC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;QAED,QAAQ;YACN,8CAA8C;YAC9C,KAAK,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC;gBACxC,IAAI,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBACrC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;YACD,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;gBACrC,IAAI,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBACrC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/state/helpers/frequency.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Frequency Store Implementation
+ *
+ * Tracks how many times items have been shown or actions taken,
+ * optionally resetting after a time window.
+ */
+import type { ScopedStorage, FrequencyStore } from "../types";
+export declare function createFrequencyStore(storage: ScopedStorage): FrequencyStore;

package/dist/state/helpers/frequency.js

@@ -0,0 +1,43 @@
+const FREQUENCY_PREFIX = "freq:";
+export function createFrequencyStore(storage) {
+    function getEntry(key) {
+        const storageKey = FREQUENCY_PREFIX + key;
+        const entry = storage.get(storageKey);
+        if (!entry)
+            return undefined;
+        // Check if reset time has passed
+        if (entry.resetAt && Date.now() >= entry.resetAt) {
+            storage.remove(storageKey);
+            return undefined;
+        }
+        return entry;
+    }
+    return {
+        increment(key, resetAfterMs) {
+            var _a, _b;
+            const storageKey = FREQUENCY_PREFIX + key;
+            const existing = getEntry(key);
+            const newCount = ((_a = existing === null || existing === void 0 ? void 0 : existing.count) !== null && _a !== void 0 ? _a : 0) + 1;
+            const entry = {
+                count: newCount,
+                // Keep existing resetAt or set new one
+                resetAt: (_b = existing === null || existing === void 0 ? void 0 : existing.resetAt) !== null && _b !== void 0 ? _b : (resetAfterMs ? Date.now() + resetAfterMs : undefined),
+            };
+            storage.set(storageKey, entry);
+            return newCount;
+        },
+        count(key) {
+            var _a;
+            const entry = getEntry(key);
+            return (_a = entry === null || entry === void 0 ? void 0 : entry.count) !== null && _a !== void 0 ? _a : 0;
+        },
+        reset(key) {
+            const storageKey = FREQUENCY_PREFIX + key;
+            storage.remove(storageKey);
+        },
+        hasReachedLimit(key, limit) {
+            return this.count(key) >= limit;
+        },
+    };
+}
+//# sourceMappingURL=frequency.js.map

package/dist/state/helpers/frequency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frequency.js","sourceRoot":"","sources":["../../../src/state/helpers/frequency.ts"],"names":[],"mappings":"AAQA,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC,MAAM,UAAU,oBAAoB,CAAC,OAAsB;IACzD,SAAS,QAAQ,CAAC,GAAW;QAC3B,MAAM,UAAU,GAAG,gBAAgB,GAAG,GAAG,CAAC;QAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAiB,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,iCAAiC;QACjC,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACjD,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC3B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;QACL,SAAS,CAAC,GAAW,EAAE,YAAqB;;YAC1C,MAAM,UAAU,GAAG,gBAAgB,GAAG,GAAG,CAAC;YAC1C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAE/B,MAAM,QAAQ,GAAG,CAAC,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,KAAK,mCAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAmB;gBAC5B,KAAK,EAAE,QAAQ;gBACf,uCAAuC;gBACvC,OAAO,EAAE,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,OAAO,mCAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;aACrF,CAAC;YAEF,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAC/B,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,KAAK,CAAC,GAAW;;YACf,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,MAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,KAAK,mCAAI,CAAC,CAAC;QAC3B,CAAC;QAED,KAAK,CAAC,GAAW;YACf,MAAM,UAAU,GAAG,gBAAgB,GAAG,GAAG,CAAC;YAC1C,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC;QAED,eAAe,CAAC,GAAW,EAAE,KAAa;YACxC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/state/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * State module exports.
+ */
+export * from "./types";
+export * from "./schema";
+export { StateStore, createStateStore } from "./StateStore";
+export type { StateStoreOptions } from "./StateStore";

package/dist/state/index.js

@@ -0,0 +1,7 @@
+/**
+ * State module exports.
+ */
+export * from "./types";
+export * from "./schema";
+export { StateStore, createStateStore } from "./StateStore";
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/state/schema.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Zod schemas for state validation.
+ */
+import { z } from "zod";
+export declare const StoredValueZ: z.ZodObject<{
+    value: z.ZodUnknown;
+    expiresAt: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    value?: unknown;
+    expiresAt?: number | undefined;
+}, {
+    value?: unknown;
+    expiresAt?: number | undefined;
+}>;
+export declare const FrequencyEntryZ: z.ZodObject<{
+    count: z.ZodNumber;
+    resetAt: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    count: number;
+    resetAt?: number | undefined;
+}, {
+    count: number;
+    resetAt?: number | undefined;
+}>;
+/**
+ * Validate a StoredValue object.
+ */
+export declare function validateStoredValue(data: unknown): z.SafeParseReturnType<{
+    value?: unknown;
+    expiresAt?: number | undefined;
+}, {
+    value?: unknown;
+    expiresAt?: number | undefined;
+}>;
+/**
+ * Validate a FrequencyEntry object.
+ */
+export declare function validateFrequencyEntry(data: unknown): z.SafeParseReturnType<{
+    count: number;
+    resetAt?: number | undefined;
+}, {
+    count: number;
+    resetAt?: number | undefined;
+}>;
+/**
+ * Type inference from Zod schema.
+ */
+export type StoredValueSchema = z.infer<typeof StoredValueZ>;
+export type FrequencyEntrySchema = z.infer<typeof FrequencyEntryZ>;

package/dist/state/schema.js

@@ -0,0 +1,25 @@
+/**
+ * Zod schemas for state validation.
+ */
+import { z } from "zod";
+export const StoredValueZ = z.object({
+    value: z.unknown(),
+    expiresAt: z.number().optional(),
+});
+export const FrequencyEntryZ = z.object({
+    count: z.number(),
+    resetAt: z.number().optional(),
+});
+/**
+ * Validate a StoredValue object.
+ */
+export function validateStoredValue(data) {
+    return StoredValueZ.safeParse(data);
+}
+/**
+ * Validate a FrequencyEntry object.
+ */
+export function validateFrequencyEntry(data) {
+    return FrequencyEntryZ.safeParse(data);
+}
+//# sourceMappingURL=schema.js.map

package/dist/state/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/state/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,OAAO,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAa;IAClD,OAAO,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/state/types.d.ts

@@ -0,0 +1,137 @@
+/**
+ * State Store Types
+ *
+ * The StateStore provides scoped storage for session and user data,
+ * with built-in helpers for common patterns like dismissals, cooldowns,
+ * and frequency caps.
+ */
+/**
+ * Scoped storage interface for reading/writing state.
+ */
+export interface ScopedStorage {
+    /**
+     * Get a value from storage.
+     * @param key - Storage key
+     * @returns The stored value or undefined
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * Set a value in storage.
+     * @param key - Storage key
+     * @param value - Value to store
+     * @param ttlMs - Optional time-to-live in milliseconds
+     */
+    set<T>(key: string, value: T, ttlMs?: number): void;
+    /**
+     * Remove a value from storage.
+     * @param key - Storage key
+     */
+    remove(key: string): void;
+    /**
+     * Check if a key exists in storage.
+     * @param key - Storage key
+     */
+    has(key: string): boolean;
+    /**
+     * Get all keys in this storage scope.
+     */
+    keys(): string[];
+    /**
+     * Clear all values in this storage scope.
+     */
+    clear(): void;
+}
+/**
+ * Dismissal store for tracking dismissed items.
+ */
+export interface DismissalStore {
+    /**
+     * Mark an item as dismissed.
+     * @param key - Item identifier
+     * @param permanent - If true, store in user storage (persistent). Default: session storage.
+     */
+    mark(key: string, permanent?: boolean): void;
+    /**
+     * Check if an item has been dismissed.
+     * @param key - Item identifier
+     */
+    isDismissed(key: string): boolean;
+    /**
+     * Clear a dismissal.
+     * @param key - Item identifier
+     */
+    clear(key: string): void;
+    /**
+     * Clear all dismissals.
+     */
+    clearAll(): void;
+}
+/**
+ * Cooldown store for time-based restrictions.
+ */
+export interface CooldownStore {
+    /**
+     * Set a cooldown for an item.
+     * @param key - Item identifier
+     * @param durationMs - Cooldown duration in milliseconds
+     */
+    set(key: string, durationMs: number): void;
+    /**
+     * Check if a cooldown is active.
+     * @param key - Item identifier
+     */
+    isActive(key: string): boolean;
+    /**
+     * Get remaining cooldown time in milliseconds.
+     * @param key - Item identifier
+     * @returns Remaining time, or 0 if not active
+     */
+    remaining(key: string): number;
+    /**
+     * Clear a cooldown.
+     * @param key - Item identifier
+     */
+    clear(key: string): void;
+}
+/**
+ * Frequency store for counting occurrences.
+ */
+export interface FrequencyStore {
+    /**
+     * Increment the count for an item.
+     * @param key - Item identifier
+     * @param resetAfterMs - Optional reset window in milliseconds
+     * @returns The new count
+     */
+    increment(key: string, resetAfterMs?: number): number;
+    /**
+     * Get the current count for an item.
+     * @param key - Item identifier
+     */
+    count(key: string): number;
+    /**
+     * Reset the count for an item.
+     * @param key - Item identifier
+     */
+    reset(key: string): void;
+    /**
+     * Check if an item has reached a limit.
+     * @param key - Item identifier
+     * @param limit - Maximum count
+     */
+    hasReachedLimit(key: string, limit: number): boolean;
+}
+/**
+ * Stored value with optional TTL metadata.
+ */
+export interface StoredValue<T = unknown> {
+    value: T;
+    expiresAt?: number;
+}
+/**
+ * Frequency entry with count and reset metadata.
+ */
+export interface FrequencyEntry {
+    count: number;
+    resetAt?: number;
+}

package/dist/state/types.js

@@ -0,0 +1,9 @@
+/**
+ * State Store Types
+ *
+ * The StateStore provides scoped storage for session and user data,
+ * with built-in helpers for common patterns like dismissals, cooldowns,
+ * and frequency caps.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/state/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/state/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/telemetry/adapters/posthog.d.ts

@@ -13,7 +13,7 @@ export interface PostHogAdapterOptions {
     apiKey?: string;
     /**
      * PostHog API host.
-     * @default "https://posthog-dev.syntrologie.com"
+     * @default "https://telemetry.syntrologie.com"
      */
     apiHost?: string;
     /**

package/dist/telemetry/adapters/posthog.js

@@ -15,7 +15,7 @@ export class PostHogAdapter {
             const enableFeatureFlags = (_a = options.enableFeatureFlags) !== null && _a !== void 0 ? _a : true;
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             this.client.init(options.apiKey, {
-                api_host: (_b = options.apiHost) !== null && _b !== void 0 ? _b : "https://posthog-dev.syntrologie.com",
+                api_host: (_b = options.apiHost) !== null && _b !== void 0 ? _b : "https://telemetry.syntrologie.com",
                 // Feature flags for segment membership (in_segment_* flags)
                 // When enabled, /decide is called to get segment flags
                 advanced_disable_feature_flags: !enableFeatureFlags,