@oobe-protocol-labs/synapse-client-sdk 1.2.0 → 1.2.2

package/dist/cjs/ai/persistence/redis.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @module ai/persistence/redis
+ * @description Redis persistence adapter for Synapse AI gateway data.
+ *
+ * Stores agent snapshots, sessions, receipts, metrics, and arbitrary
+ * key-value data in Redis using JSON serialization and configurable
+ * key prefixing.
+ *
+ * Bring your own Redis client — the adapter works with any library
+ * that satisfies the {@link RedisLike} interface:
+ * - **ioredis** (`new Redis()`)
+ * - **node-redis v4** (`createClient()`)
+ * - **@upstash/redis** (REST-based, partial)
+ *
+ * @since 1.2.2
+ *
+ * @example
+ * ```ts
+ * import Redis from 'ioredis';
+ * import { RedisPersistence } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const redis = new Redis(process.env.REDIS_URL);
+ * const store = new RedisPersistence({ client: redis });
+ * await store.connect();
+ *
+ * await store.saveAgent(gateway.snapshot());
+ * await store.saveSession(sessionRecord);
+ *
+ * // Drop-in for AgentRegistry:
+ * const registry = new AgentRegistry({ persistence: store });
+ * ```
+ */
+import type { PersistenceStore, RedisStoreConfig, SetOptions, ListOptions, MetricQueryOpts, SessionRecord, ReceiptRecord, MetricPoint } from './types';
+import type { GatewaySnapshot } from '../gateway/types';
+/**
+ * @description Redis implementation of {@link PersistenceStore}.
+ *
+ * Key layout (default prefix `synapse`):
+ * ```
+ * synapse:kv:{key}                       → generic KV
+ * synapse:agent:{agentId}                → agent snapshot JSON
+ * synapse:session:{agentId}:{sessionId}  → session record JSON
+ * synapse:receipts:{agentId}             → JSON array of receipts
+ * synapse:metrics:{agentId}:{metricKey}  → JSON array of MetricPoint
+ * ```
+ *
+ * @since 1.2.2
+ */
+export declare class RedisPersistence implements PersistenceStore {
+    readonly name = "redis";
+    private readonly client;
+    private readonly prefix;
+    private readonly defaultTtl;
+    constructor(config: RedisStoreConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    ping(): Promise<boolean>;
+    private kvKey;
+    get<T = unknown>(key: string): Promise<T | null>;
+    set(key: string, value: unknown, opts?: SetOptions): Promise<void>;
+    del(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    private agentKey;
+    saveAgent(snapshot: GatewaySnapshot): Promise<void>;
+    loadAgent(agentId: string): Promise<GatewaySnapshot | null>;
+    deleteAgent(agentId: string): Promise<boolean>;
+    listAgents(): Promise<string[]>;
+    private sessionKey;
+    saveSession(record: SessionRecord): Promise<void>;
+    loadSession(agentId: string, sessionId: string): Promise<SessionRecord | null>;
+    deleteSessions(agentId: string): Promise<number>;
+    listSessions(agentId: string, opts?: ListOptions): Promise<SessionRecord[]>;
+    private receiptsKey;
+    saveReceipt(record: ReceiptRecord): Promise<void>;
+    listReceipts(agentId: string, opts?: ListOptions): Promise<ReceiptRecord[]>;
+    private metricsKey;
+    recordMetric(agentId: string, key: string, value: number, labels?: Record<string, string>): Promise<void>;
+    queryMetrics(agentId: string, key: string, opts?: MetricQueryOpts): Promise<MetricPoint[]>;
+    save(agentId: string, snapshot: GatewaySnapshot): Promise<void>;
+    load(agentId: string): Promise<GatewaySnapshot | null>;
+    delete(agentId: string): Promise<void>;
+    keys(): Promise<string[]>;
+}
+//# sourceMappingURL=redis.d.ts.map

package/dist/cjs/ai/persistence/redis.d.ts.map

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

package/dist/cjs/ai/persistence/redis.js

@@ -0,0 +1,241 @@
+"use strict";
+/**
+ * @module ai/persistence/redis
+ * @description Redis persistence adapter for Synapse AI gateway data.
+ *
+ * Stores agent snapshots, sessions, receipts, metrics, and arbitrary
+ * key-value data in Redis using JSON serialization and configurable
+ * key prefixing.
+ *
+ * Bring your own Redis client — the adapter works with any library
+ * that satisfies the {@link RedisLike} interface:
+ * - **ioredis** (`new Redis()`)
+ * - **node-redis v4** (`createClient()`)
+ * - **@upstash/redis** (REST-based, partial)
+ *
+ * @since 1.2.2
+ *
+ * @example
+ * ```ts
+ * import Redis from 'ioredis';
+ * import { RedisPersistence } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const redis = new Redis(process.env.REDIS_URL);
+ * const store = new RedisPersistence({ client: redis });
+ * await store.connect();
+ *
+ * await store.saveAgent(gateway.snapshot());
+ * await store.saveSession(sessionRecord);
+ *
+ * // Drop-in for AgentRegistry:
+ * const registry = new AgentRegistry({ persistence: store });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisPersistence = void 0;
+const types_1 = require("./types");
+const helpers_1 = require("./helpers");
+/**
+ * @description Redis implementation of {@link PersistenceStore}.
+ *
+ * Key layout (default prefix `synapse`):
+ * ```
+ * synapse:kv:{key}                       → generic KV
+ * synapse:agent:{agentId}                → agent snapshot JSON
+ * synapse:session:{agentId}:{sessionId}  → session record JSON
+ * synapse:receipts:{agentId}             → JSON array of receipts
+ * synapse:metrics:{agentId}:{metricKey}  → JSON array of MetricPoint
+ * ```
+ *
+ * @since 1.2.2
+ */
+class RedisPersistence {
+    name = 'redis';
+    client;
+    prefix;
+    defaultTtl;
+    constructor(config) {
+        this.client = config.client;
+        this.prefix = config.keyPrefix ?? 'synapse';
+        this.defaultTtl = config.defaultTtl ?? 0;
+    }
+    /* ── Lifecycle ─────────────────────────────────────────── */
+    async connect() {
+        try {
+            await this.client.ping();
+        }
+        catch (err) {
+            throw new types_1.PersistenceError('Failed to connect to Redis', 'CONN_FAILED', err);
+        }
+    }
+    async disconnect() {
+        try {
+            await this.client.quit();
+        }
+        catch {
+            // Swallow — already disconnected
+        }
+    }
+    async ping() {
+        try {
+            const res = await this.client.ping();
+            return res === 'PONG' || res === 'pong';
+        }
+        catch {
+            return false;
+        }
+    }
+    /* ── Generic KV ────────────────────────────────────────── */
+    kvKey(key) {
+        return (0, helpers_1.buildKey)(this.prefix, 'kv', key);
+    }
+    async get(key) {
+        const raw = await this.client.get(this.kvKey(key));
+        return raw ? (0, helpers_1.deserialize)(raw) : null;
+    }
+    async set(key, value, opts) {
+        const k = this.kvKey(key);
+        await this.client.set(k, (0, helpers_1.serialize)(value));
+        const ttl = opts?.ttl ?? this.defaultTtl;
+        if (ttl > 0)
+            await this.client.expire(k, ttl);
+    }
+    async del(key) {
+        const n = await this.client.del(this.kvKey(key));
+        return n > 0;
+    }
+    async has(key) {
+        const n = await this.client.exists(this.kvKey(key));
+        return n > 0;
+    }
+    /* ── Agents ────────────────────────────────────────────── */
+    agentKey(agentId) {
+        return (0, helpers_1.buildKey)(this.prefix, 'agent', agentId);
+    }
+    async saveAgent(snapshot) {
+        const k = this.agentKey(snapshot.agentId);
+        await this.client.set(k, (0, helpers_1.serialize)(snapshot));
+        if (this.defaultTtl > 0)
+            await this.client.expire(k, this.defaultTtl);
+    }
+    async loadAgent(agentId) {
+        const raw = await this.client.get(this.agentKey(agentId));
+        return raw ? (0, helpers_1.deserialize)(raw) : null;
+    }
+    async deleteAgent(agentId) {
+        const n = await this.client.del(this.agentKey(agentId));
+        return n > 0;
+    }
+    async listAgents() {
+        const pattern = (0, helpers_1.buildKey)(this.prefix, 'agent', '*');
+        const keys = await this.client.keys(pattern);
+        const prefixLen = (0, helpers_1.buildKey)(this.prefix, 'agent', '').length;
+        return keys.map(k => k.slice(prefixLen));
+    }
+    /* ── Sessions ──────────────────────────────────────────── */
+    sessionKey(agentId, sessionId) {
+        return (0, helpers_1.buildKey)(this.prefix, 'session', agentId, sessionId);
+    }
+    async saveSession(record) {
+        const k = this.sessionKey(record.agentId, record.id);
+        await this.client.set(k, (0, helpers_1.serialize)(record));
+        // Auto-expire sessions based on their TTL
+        if (record.ttl > 0)
+            await this.client.expire(k, record.ttl);
+    }
+    async loadSession(agentId, sessionId) {
+        const raw = await this.client.get(this.sessionKey(agentId, sessionId));
+        return raw ? (0, helpers_1.deserialize)(raw) : null;
+    }
+    async deleteSessions(agentId) {
+        const pattern = (0, helpers_1.buildKey)(this.prefix, 'session', agentId, '*');
+        const keys = await this.client.keys(pattern);
+        let count = 0;
+        for (const k of keys) {
+            count += await this.client.del(k);
+        }
+        return count;
+    }
+    async listSessions(agentId, opts = {}) {
+        const pattern = (0, helpers_1.buildKey)(this.prefix, 'session', agentId, '*');
+        const keys = await this.client.keys(pattern);
+        let records = [];
+        for (const k of keys) {
+            const raw = await this.client.get(k);
+            if (raw) {
+                const rec = (0, helpers_1.deserialize)(raw);
+                if (opts.status && rec.status !== opts.status)
+                    continue;
+                records.push(rec);
+            }
+        }
+        records.sort((a, b) => b.createdAt - a.createdAt);
+        const offset = opts.offset ?? 0;
+        const limit = opts.limit ?? records.length;
+        return records.slice(offset, offset + limit);
+    }
+    /* ── Receipts ──────────────────────────────────────────── */
+    receiptsKey(agentId) {
+        return (0, helpers_1.buildKey)(this.prefix, 'receipts', agentId);
+    }
+    async saveReceipt(record) {
+        const k = this.receiptsKey(record.agentId);
+        const raw = await this.client.get(k);
+        const list = raw ? (0, helpers_1.deserialize)(raw) : [];
+        list.push(record);
+        await this.client.set(k, (0, helpers_1.serialize)(list));
+    }
+    async listReceipts(agentId, opts = {}) {
+        const raw = await this.client.get(this.receiptsKey(agentId));
+        if (!raw)
+            return [];
+        const list = (0, helpers_1.deserialize)(raw);
+        const sorted = list.sort((a, b) => b.settledAt - a.settledAt);
+        const offset = opts.offset ?? 0;
+        const limit = opts.limit ?? sorted.length;
+        return sorted.slice(offset, offset + limit);
+    }
+    /* ── Metrics ───────────────────────────────────────────── */
+    metricsKey(agentId, key) {
+        return (0, helpers_1.buildKey)(this.prefix, 'metrics', agentId, key);
+    }
+    async recordMetric(agentId, key, value, labels) {
+        const k = this.metricsKey(agentId, key);
+        const raw = await this.client.get(k);
+        const list = raw ? (0, helpers_1.deserialize)(raw) : [];
+        list.push({ timestamp: Date.now(), value, labels });
+        // Keep last 10 000 points per metric key (prevent unbounded growth)
+        if (list.length > 10_000)
+            list.splice(0, list.length - 10_000);
+        await this.client.set(k, (0, helpers_1.serialize)(list));
+    }
+    async queryMetrics(agentId, key, opts = {}) {
+        const raw = await this.client.get(this.metricsKey(agentId, key));
+        if (!raw)
+            return [];
+        let points = (0, helpers_1.deserialize)(raw);
+        if (opts.from != null)
+            points = points.filter(p => p.timestamp >= opts.from);
+        if (opts.to != null)
+            points = points.filter(p => p.timestamp <= opts.to);
+        points.sort((a, b) => b.timestamp - a.timestamp);
+        if (opts.limit != null)
+            points = points.slice(0, opts.limit);
+        return points;
+    }
+    /* ── PersistenceAdapter compat ─────────────────────────── */
+    async save(agentId, snapshot) {
+        return this.saveAgent(snapshot);
+    }
+    async load(agentId) {
+        return this.loadAgent(agentId);
+    }
+    async delete(agentId) {
+        await this.deleteAgent(agentId);
+    }
+    async keys() {
+        return this.listAgents();
+    }
+}
+exports.RedisPersistence = RedisPersistence;
+//# sourceMappingURL=redis.js.map

package/dist/cjs/ai/persistence/redis.js.map

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

package/dist/cjs/ai/persistence/types.d.ts

@@ -0,0 +1,267 @@
+/**
+ * @module ai/persistence/types
+ * @description Core type definitions for the Synapse AI persistence layer.
+ *
+ * Defines the universal {@link PersistenceStore} interface and all associated
+ * data records, configuration objects, and client abstractions.
+ *
+ * The generic client interfaces ({@link RedisLike}, {@link PgLike}) use
+ * dependency-injection: you create the client with your preferred library
+ * (ioredis, node-redis, pg, @vercel/postgres, @neondatabase/serverless, …)
+ * and pass the instance to the adapter constructor.
+ *
+ * @since 1.2.2
+ */
+import type { GatewaySnapshot } from '../gateway/types';
+/**
+ * @description Error thrown by any persistence store operation.
+ * @since 1.2.2
+ */
+export declare class PersistenceError extends Error {
+    /** Machine-readable error code (e.g. `'CONN_FAILED'`, `'QUERY_ERROR'`). */
+    readonly code: string;
+    /** The underlying error from the database driver, if any. */
+    readonly cause?: unknown | undefined;
+    constructor(message: string, 
+    /** Machine-readable error code (e.g. `'CONN_FAILED'`, `'QUERY_ERROR'`). */
+    code: string, 
+    /** The underlying error from the database driver, if any. */
+    cause?: unknown | undefined);
+}
+/**
+ * @description Minimal interface a Redis-compatible client must satisfy.
+ *
+ * Compatible with:
+ * - **ioredis** (`new Redis()`)
+ * - **node-redis v4** (`createClient()`)
+ * - **@upstash/redis** (REST-based)
+ * - Any client exposing the same method signatures
+ *
+ * @since 1.2.2
+ */
+export interface RedisLike {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ...args: unknown[]): Promise<unknown>;
+    del(key: string): Promise<number>;
+    exists(key: string): Promise<number>;
+    keys(pattern: string): Promise<string[]>;
+    expire(key: string, seconds: number): Promise<number | boolean>;
+    ping(): Promise<string>;
+    quit(): Promise<unknown>;
+}
+/**
+ * @description Minimal interface a PostgreSQL-compatible client must satisfy.
+ *
+ * Compatible with:
+ * - **pg** (`new Pool()` or `new Client()`)
+ * - **@vercel/postgres** (`sql` tagged template or pool)
+ * - **@neondatabase/serverless** (`neon()`)
+ * - Any client exposing a `.query()` method
+ *
+ * @since 1.2.2
+ */
+export interface PgLike {
+    query<T extends Record<string, unknown> = Record<string, unknown>>(text: string, values?: unknown[]): Promise<{
+        rows: T[];
+        rowCount: number | null;
+    }>;
+    /** Optional — some pool implementations don't expose `end()`. */
+    end?(): Promise<void>;
+}
+/**
+ * @description JSON-safe session record for persistence.
+ * All `BigInt` fields are stored as decimal strings.
+ * @since 1.2.2
+ */
+export interface SessionRecord {
+    /** Session unique ID. */
+    id: string;
+    /** Owning agent ID. */
+    agentId: string;
+    /** Lifecycle status (`active`, `settled`, `expired`, …). */
+    status: string;
+    /** Buyer agent ID. */
+    buyer: string;
+    /** Seller agent ID. */
+    seller: string;
+    /** Pricing tier ID. */
+    tierId: string;
+    /** Payment-intent nonce. */
+    intentNonce: string;
+    /** Remaining budget (smallest token unit, as string). */
+    budgetRemaining: string;
+    /** Total budget allocated at session start (as string). */
+    budgetTotal: string;
+    /** Number of calls made. */
+    callsMade: number;
+    /** Calls remaining (−1 = unlimited). */
+    callsRemaining: number;
+    /** Per-method call counts. */
+    methodCounts: Record<string, number>;
+    /** Arbitrary session metadata. */
+    metadata: Record<string, unknown>;
+    /** Unix timestamp of creation (ms). */
+    createdAt: number;
+    /** Unix timestamp of last activity (ms). */
+    lastActivityAt: number;
+    /** Session TTL in seconds. */
+    ttl: number;
+}
+/**
+ * @description JSON-safe payment receipt for persistence.
+ * @since 1.2.2
+ */
+export interface ReceiptRecord {
+    /** Receipt unique ID. */
+    id: string;
+    /** Agent that issued the receipt. */
+    agentId: string;
+    /** Session this receipt belongs to. */
+    sessionId?: string;
+    /** Payment-intent nonce. */
+    intentNonce: string;
+    /** Amount actually charged (smallest unit, as string). */
+    amountCharged: string;
+    /** Total calls billed in this receipt. */
+    callCount: number;
+    /** On-chain tx signature, or `null` for off-chain. */
+    txSignature: string | null;
+    /** Settlement method (`onchain`, `offchain-escrow`, `streaming`). */
+    settlement: string;
+    /** Unix timestamp of settlement (ms). */
+    settledAt: number;
+}
+/**
+ * @description A single metric data point.
+ * @since 1.2.2
+ */
+export interface MetricPoint {
+    /** Unix timestamp (ms). */
+    timestamp: number;
+    /** Numeric value. */
+    value: number;
+    /** Optional labels for grouping/filtering. */
+    labels?: Record<string, string>;
+}
+/** Options for {@link PersistenceStore.set}. */
+export interface SetOptions {
+    /** TTL in seconds (0 or `undefined` = no expiry). */
+    ttl?: number;
+}
+/** Options for list queries (sessions, receipts). */
+export interface ListOptions {
+    /** Max results to return. */
+    limit?: number;
+    /** Offset for pagination. */
+    offset?: number;
+    /** Filter by status (sessions only). */
+    status?: string;
+}
+/** Options for metric queries. */
+export interface MetricQueryOpts {
+    /** Start timestamp (inclusive, ms). */
+    from?: number;
+    /** End timestamp (inclusive, ms). */
+    to?: number;
+    /** Max points to return (most recent first). */
+    limit?: number;
+}
+/** Base configuration shared by all stores. */
+export interface StoreConfig {
+    /**
+     * Key/table prefix. Default: `'synapse'`.
+     * - Redis keys: `{prefix}:agent:{id}`, `{prefix}:session:{agentId}:{id}`, …
+     * - PostgreSQL tables: `{prefix}_agents`, `{prefix}_sessions`, …
+     */
+    keyPrefix?: string;
+}
+/** Configuration for {@link RedisPersistence}. */
+export interface RedisStoreConfig extends StoreConfig {
+    /** Pre-configured Redis-compatible client instance. */
+    client: RedisLike;
+    /** Default TTL in seconds for stored values (0 = no expiry). Default: `0`. */
+    defaultTtl?: number;
+}
+/** Configuration for {@link PostgresPersistence}. */
+export interface PostgresStoreConfig extends StoreConfig {
+    /** Pre-configured PostgreSQL-compatible client/pool instance. */
+    client: PgLike;
+    /** Run schema migrations automatically on `connect()`. Default: `true`. */
+    autoMigrate?: boolean;
+}
+/** Configuration for {@link MemoryStore}. */
+export interface MemoryStoreConfig extends StoreConfig {
+    /** Maximum entries before oldest are evicted (0 = unlimited). Default: `0`. */
+    maxEntries?: number;
+}
+/**
+ * @description Universal persistence store for Synapse AI gateway data.
+ *
+ * Three built-in implementations:
+ * | Store | Best for |
+ * |---|---|
+ * | {@link MemoryStore} | Testing, dev, single-process |
+ * | {@link RedisPersistence} | Sessions, caching, pub/sub, replicas |
+ * | {@link PostgresPersistence} | Long-term analytics, receipts, audit |
+ *
+ * All implementations also satisfy the `PersistenceAdapter` interface
+ * from {@link AgentRegistry}, so they can be used as drop-in replacements:
+ *
+ * ```ts
+ * const store = new RedisPersistence({ client: redis });
+ * const registry = new AgentRegistry({ persistence: store });
+ * ```
+ *
+ * @since 1.2.2
+ */
+export interface PersistenceStore {
+    /** Store identifier (e.g. `'memory'`, `'redis'`, `'postgresql'`). */
+    readonly name: string;
+    /** Establish connection / run migrations. Idempotent. */
+    connect(): Promise<void>;
+    /** Gracefully disconnect from the backing store. */
+    disconnect(): Promise<void>;
+    /** Health check — returns `true` if the store is reachable. */
+    ping(): Promise<boolean>;
+    /** Retrieve a value by key. Returns `null` if not found or expired. */
+    get<T = unknown>(key: string): Promise<T | null>;
+    /** Store a value by key with optional TTL. */
+    set(key: string, value: unknown, opts?: SetOptions): Promise<void>;
+    /** Delete a key. Returns `true` if the key existed. */
+    del(key: string): Promise<boolean>;
+    /** Check if a key exists (and is not expired). */
+    has(key: string): Promise<boolean>;
+    /** Persist an agent's {@link GatewaySnapshot}. */
+    saveAgent(snapshot: GatewaySnapshot): Promise<void>;
+    /** Load an agent snapshot by ID. */
+    loadAgent(agentId: string): Promise<GatewaySnapshot | null>;
+    /** Delete an agent snapshot. Returns `true` if it existed. */
+    deleteAgent(agentId: string): Promise<boolean>;
+    /** List all persisted agent IDs. */
+    listAgents(): Promise<string[]>;
+    /** Persist a session record. */
+    saveSession(record: SessionRecord): Promise<void>;
+    /** Load a session by agent ID + session ID. */
+    loadSession(agentId: string, sessionId: string): Promise<SessionRecord | null>;
+    /** Delete all sessions for an agent. Returns the count deleted. */
+    deleteSessions(agentId: string): Promise<number>;
+    /** List sessions for an agent with optional filtering. */
+    listSessions(agentId: string, opts?: ListOptions): Promise<SessionRecord[]>;
+    /** Persist a payment receipt. */
+    saveReceipt(record: ReceiptRecord): Promise<void>;
+    /** List receipts for an agent with pagination. */
+    listReceipts(agentId: string, opts?: ListOptions): Promise<ReceiptRecord[]>;
+    /** Record a numeric metric data point. */
+    recordMetric(agentId: string, key: string, value: number, labels?: Record<string, string>): Promise<void>;
+    /** Query metric points with optional time range and limit. */
+    queryMetrics(agentId: string, key: string, opts?: MetricQueryOpts): Promise<MetricPoint[]>;
+    /** Alias for `saveAgent()`. Satisfies `PersistenceAdapter.save()`. */
+    save(agentId: string, snapshot: GatewaySnapshot): Promise<void>;
+    /** Alias for `loadAgent()`. Satisfies `PersistenceAdapter.load()`. */
+    load(agentId: string): Promise<GatewaySnapshot | null>;
+    /** Alias for `deleteAgent()`. Satisfies `PersistenceAdapter.delete()`. */
+    delete(agentId: string): Promise<void>;
+    /** Alias for `listAgents()`. Satisfies `PersistenceAdapter.keys()`. */
+    keys(): Promise<string[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/ai/persistence/types.d.ts.map

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

package/dist/cjs/ai/persistence/types.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * @module ai/persistence/types
+ * @description Core type definitions for the Synapse AI persistence layer.
+ *
+ * Defines the universal {@link PersistenceStore} interface and all associated
+ * data records, configuration objects, and client abstractions.
+ *
+ * The generic client interfaces ({@link RedisLike}, {@link PgLike}) use
+ * dependency-injection: you create the client with your preferred library
+ * (ioredis, node-redis, pg, @vercel/postgres, @neondatabase/serverless, …)
+ * and pass the instance to the adapter constructor.
+ *
+ * @since 1.2.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PersistenceError = void 0;
+/* ═══════════════════════════════════════════════════════════════
+ *  Error
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Error thrown by any persistence store operation.
+ * @since 1.2.2
+ */
+class PersistenceError extends Error {
+    code;
+    cause;
+    constructor(message, 
+    /** Machine-readable error code (e.g. `'CONN_FAILED'`, `'QUERY_ERROR'`). */
+    code, 
+    /** The underlying error from the database driver, if any. */
+    cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'PersistenceError';
+    }
+}
+exports.PersistenceError = PersistenceError;
+//# sourceMappingURL=types.js.map

package/dist/cjs/ai/persistence/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/ai/persistence/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAIH;;qEAEqE;AAErE;;;GAGG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IAIvB;IAEA;IALlB,YACE,OAAe;IACf,2EAA2E;IAC3D,IAAY;IAC5B,6DAA6D;IAC7C,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAXD,4CAWC"}