@chainmcp/storage 0.0.0-stage → 0.4.1

package/dist/sqlite.d.ts

@@ -0,0 +1,69 @@
+import { DatabaseSync } from "node:sqlite";
+import type { BlobPayload, BlobPayloadStore, BlobStorePutOptions, KeyValueStore, StorageDriver, StorageDriverOptions, TelemetryEvent, TelemetryQueryOptions, TelemetryRingBuffer, TelemetryRingBufferOptions } from "./types.js";
+export interface SqliteStorageDriverOptions extends StorageDriverOptions {
+    busyTimeoutMs?: number | undefined;
+}
+export declare class SqliteKeyValueStore<T = unknown> implements KeyValueStore<T> {
+    private readonly db;
+    readonly namespace: string;
+    constructor(db: DatabaseSync, namespace: string);
+    get(key: string, tenantId?: string): Promise<T | null>;
+    set(key: string, value: T, options?: {
+        tenantId?: string | undefined;
+        ttlMs?: number | undefined;
+    }): Promise<void>;
+    delete(key: string, tenantId?: string): Promise<boolean>;
+    list(options?: {
+        tenantId?: string | undefined;
+        prefix?: string | undefined;
+        limit?: number | undefined;
+    }): Promise<Array<{
+        key: string;
+        value: T;
+    }>>;
+    clear(tenantId?: string): Promise<void>;
+}
+export declare class SqliteBlobPayloadStore implements BlobPayloadStore {
+    private readonly db;
+    readonly namespace: string;
+    constructor(db: DatabaseSync, namespace?: string);
+    put(handle: string, data: string | Uint8Array, options?: BlobStorePutOptions): Promise<BlobPayload>;
+    get(handle: string, options?: {
+        tenantId?: string | undefined;
+        principalId?: string | undefined;
+    }): Promise<BlobPayload | null>;
+    delete(handle: string, options?: {
+        tenantId?: string | undefined;
+        principalId?: string | undefined;
+    }): Promise<boolean>;
+    pruneExpired(): Promise<number>;
+}
+export declare class SqliteTelemetryRingBuffer implements TelemetryRingBuffer {
+    private readonly db;
+    private readonly maxEntries;
+    constructor(db: DatabaseSync, options?: TelemetryRingBufferOptions);
+    push(event: TelemetryEvent): Promise<void>;
+    pushBatch(events: TelemetryEvent[]): Promise<void>;
+    private pruneBuffer;
+    query(options?: TelemetryQueryOptions): Promise<TelemetryEvent[]>;
+    clear(tenantId?: string): Promise<void>;
+}
+export declare class SqliteStorageDriver implements StorageDriver {
+    readonly id = "sqlite";
+    isConnected: boolean;
+    private db;
+    private readonly resolvedPath;
+    private readonly busyTimeoutMs;
+    private readonly kvStores;
+    private readonly blobStores;
+    private telemetryBuffer;
+    constructor(options?: SqliteStorageDriverOptions);
+    init(): Promise<void>;
+    close(): Promise<void>;
+    ping(): Promise<boolean>;
+    getKeyValueStore<T = unknown>(namespace: string): KeyValueStore<T>;
+    getBlobPayloadStore(namespace?: string): BlobPayloadStore;
+    getTelemetryRingBuffer(options?: TelemetryRingBufferOptions): TelemetryRingBuffer;
+}
+export declare function createSqliteStorageDriver(options?: SqliteStorageDriverOptions): SqliteStorageDriver;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/sqlite.d.ts.map

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

package/dist/sqlite.js

@@ -0,0 +1,439 @@
+import { DatabaseSync } from "node:sqlite";
+import { mkdir } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { homedir } from "node:os";
+import { StorageError, StoragePayloadTooLargeError } from "./types.js";
+const DEFAULT_MAX_BLOB_BYTES = 10 * 1024 * 1024; // 10 MiB
+const DEFAULT_MAX_TELEMETRY_ENTRIES = 10_000;
+function resolveDbPath(inputPath) {
+    if (!inputPath || inputPath === ":memory:") {
+        return ":memory:";
+    }
+    if (inputPath.startsWith("~/")) {
+        return resolve(homedir(), inputPath.slice(2));
+    }
+    return resolve(process.cwd(), inputPath);
+}
+export class SqliteKeyValueStore {
+    db;
+    namespace;
+    constructor(db, namespace) {
+        this.db = db;
+        this.namespace = namespace;
+    }
+    async get(key, tenantId) {
+        const tid = tenantId ?? "";
+        const stmt = this.db.prepare(`
+      SELECT value, expires_at FROM chainmcp_kv
+      WHERE namespace = ? AND tenant_id = ? AND key = ?
+    `);
+        const row = stmt.get(this.namespace, tid, key);
+        if (!row) {
+            return null;
+        }
+        if (row.expires_at !== null && Date.now() > row.expires_at) {
+            const del = this.db.prepare(`
+        DELETE FROM chainmcp_kv
+        WHERE namespace = ? AND tenant_id = ? AND key = ?
+      `);
+            del.run(this.namespace, tid, key);
+            return null;
+        }
+        try {
+            return JSON.parse(row.value);
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(key, value, options) {
+        const tid = options?.tenantId ?? "";
+        const now = Date.now();
+        const expiresAt = options?.ttlMs ? now + options.ttlMs : null;
+        const serialized = JSON.stringify(value);
+        const stmt = this.db.prepare(`
+      INSERT INTO chainmcp_kv (namespace, tenant_id, key, value, created_at, expires_at)
+      VALUES (?, ?, ?, ?, ?, ?)
+      ON CONFLICT(namespace, tenant_id, key) DO UPDATE SET
+        value = excluded.value,
+        created_at = excluded.created_at,
+        expires_at = excluded.expires_at
+    `);
+        stmt.run(this.namespace, tid, key, serialized, now, expiresAt);
+    }
+    async delete(key, tenantId) {
+        const tid = tenantId ?? "";
+        const stmt = this.db.prepare(`
+      DELETE FROM chainmcp_kv
+      WHERE namespace = ? AND tenant_id = ? AND key = ?
+    `);
+        const result = stmt.run(this.namespace, tid, key);
+        return Number(result.changes) > 0;
+    }
+    async list(options) {
+        const tid = options?.tenantId ?? "";
+        const limit = options?.limit ?? 100;
+        const now = Date.now();
+        const prefix = options?.prefix ?? "";
+        const stmt = this.db.prepare(`
+      SELECT key, value, expires_at FROM chainmcp_kv
+      WHERE namespace = ? AND tenant_id = ? AND key LIKE ?
+      ORDER BY key ASC
+      LIMIT ?
+    `);
+        const rows = stmt.all(this.namespace, tid, `${prefix}%`, limit);
+        const results = [];
+        for (const row of rows) {
+            if (row.expires_at !== null && now > row.expires_at) {
+                continue;
+            }
+            try {
+                results.push({
+                    key: row.key,
+                    value: JSON.parse(row.value),
+                });
+            }
+            catch {
+                // Skip unparseable
+            }
+        }
+        return results;
+    }
+    async clear(tenantId) {
+        if (tenantId !== undefined) {
+            const stmt = this.db.prepare(`
+        DELETE FROM chainmcp_kv
+        WHERE namespace = ? AND tenant_id = ?
+      `);
+            stmt.run(this.namespace, tenantId);
+        }
+        else {
+            const stmt = this.db.prepare(`
+        DELETE FROM chainmcp_kv
+        WHERE namespace = ?
+      `);
+            stmt.run(this.namespace);
+        }
+    }
+}
+export class SqliteBlobPayloadStore {
+    db;
+    namespace;
+    constructor(db, namespace = "default") {
+        this.db = db;
+        this.namespace = namespace;
+    }
+    async put(handle, data, options) {
+        const strData = typeof data === "string" ? data : new TextDecoder().decode(data);
+        const byteSize = Buffer.byteLength(strData, "utf8");
+        const maxBytes = options?.maxByteSize ?? DEFAULT_MAX_BLOB_BYTES;
+        if (byteSize > maxBytes) {
+            throw new StoragePayloadTooLargeError(byteSize, maxBytes);
+        }
+        const tid = options?.tenantId ?? "";
+        const pid = options?.principalId ?? null;
+        const now = Date.now();
+        const expiresAt = options?.ttlMs ? now + options.ttlMs : null;
+        const stmt = this.db.prepare(`
+      INSERT INTO chainmcp_blobs (namespace, handle, tenant_id, principal_id, data, byte_size, created_at, expires_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(namespace, tenant_id, handle) DO UPDATE SET
+        principal_id = excluded.principal_id,
+        data = excluded.data,
+        byte_size = excluded.byte_size,
+        created_at = excluded.created_at,
+        expires_at = excluded.expires_at
+    `);
+        stmt.run(this.namespace, handle, tid, pid, strData, byteSize, now, expiresAt);
+        return {
+            handle,
+            data: strData,
+            byteSize,
+            tenantId: options?.tenantId,
+            principalId: options?.principalId,
+            createdAt: now,
+            expiresAt: expiresAt ?? undefined,
+        };
+    }
+    async get(handle, options) {
+        const tid = options?.tenantId ?? "";
+        const stmt = this.db.prepare(`
+      SELECT principal_id, data, byte_size, created_at, expires_at
+      FROM chainmcp_blobs
+      WHERE namespace = ? AND tenant_id = ? AND handle = ?
+    `);
+        const row = stmt.get(this.namespace, tid, handle);
+        if (!row) {
+            return null;
+        }
+        if (row.expires_at !== null && Date.now() > row.expires_at) {
+            const del = this.db.prepare(`
+        DELETE FROM chainmcp_blobs
+        WHERE namespace = ? AND tenant_id = ? AND handle = ?
+      `);
+            del.run(this.namespace, tid, handle);
+            return null;
+        }
+        if (options?.principalId && row.principal_id !== options.principalId) {
+            return null;
+        }
+        return {
+            handle,
+            data: row.data,
+            byteSize: row.byte_size,
+            tenantId: options?.tenantId,
+            principalId: row.principal_id ?? undefined,
+            createdAt: row.created_at,
+            expiresAt: row.expires_at ?? undefined,
+        };
+    }
+    async delete(handle, options) {
+        const tid = options?.tenantId ?? "";
+        if (options?.principalId) {
+            const stmt = this.db.prepare(`
+        DELETE FROM chainmcp_blobs
+        WHERE namespace = ? AND tenant_id = ? AND handle = ? AND principal_id = ?
+      `);
+            const result = stmt.run(this.namespace, tid, handle, options.principalId);
+            return Number(result.changes) > 0;
+        }
+        else {
+            const stmt = this.db.prepare(`
+        DELETE FROM chainmcp_blobs
+        WHERE namespace = ? AND tenant_id = ? AND handle = ?
+      `);
+            const result = stmt.run(this.namespace, tid, handle);
+            return Number(result.changes) > 0;
+        }
+    }
+    async pruneExpired() {
+        const stmt = this.db.prepare(`
+      DELETE FROM chainmcp_blobs
+      WHERE namespace = ? AND expires_at IS NOT NULL AND expires_at < ?
+    `);
+        const result = stmt.run(this.namespace, Date.now());
+        return Number(result.changes);
+    }
+}
+export class SqliteTelemetryRingBuffer {
+    db;
+    maxEntries;
+    constructor(db, options) {
+        this.db = db;
+        this.maxEntries = options?.maxEntries ?? DEFAULT_MAX_TELEMETRY_ENTRIES;
+    }
+    async push(event) {
+        const stmt = this.db.prepare(`
+      INSERT INTO chainmcp_telemetry (id, timestamp, tenant_id, tool_name, duration_ms, is_error, error_code, cached, token_count, metadata)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(event.id, event.timestamp, event.tenantId ?? null, event.toolName ?? null, event.durationMs ?? null, event.isError ? 1 : 0, event.errorCode ?? null, event.cached ? 1 : 0, event.tokenCount ?? null, event.metadata ? JSON.stringify(event.metadata) : null);
+        this.pruneBuffer();
+    }
+    async pushBatch(events) {
+        if (events.length === 0)
+            return;
+        this.db.exec("BEGIN TRANSACTION;");
+        try {
+            const stmt = this.db.prepare(`
+        INSERT INTO chainmcp_telemetry (id, timestamp, tenant_id, tool_name, duration_ms, is_error, error_code, cached, token_count, metadata)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `);
+            for (const event of events) {
+                stmt.run(event.id, event.timestamp, event.tenantId ?? null, event.toolName ?? null, event.durationMs ?? null, event.isError ? 1 : 0, event.errorCode ?? null, event.cached ? 1 : 0, event.tokenCount ?? null, event.metadata ? JSON.stringify(event.metadata) : null);
+            }
+            this.db.exec("COMMIT;");
+        }
+        catch (err) {
+            this.db.exec("ROLLBACK;");
+            throw err;
+        }
+        this.pruneBuffer();
+    }
+    pruneBuffer() {
+        const pruneStmt = this.db.prepare(`
+      DELETE FROM chainmcp_telemetry
+      WHERE id NOT IN (
+        SELECT id FROM chainmcp_telemetry
+        ORDER BY timestamp DESC
+        LIMIT ?
+      )
+    `);
+        pruneStmt.run(this.maxEntries);
+    }
+    async query(options) {
+        let sql = "SELECT * FROM chainmcp_telemetry WHERE 1=1";
+        const params = [];
+        if (options?.tenantId) {
+            sql += " AND tenant_id = ?";
+            params.push(options.tenantId);
+        }
+        if (options?.toolName) {
+            sql += " AND tool_name = ?";
+            params.push(options.toolName);
+        }
+        if (options?.since) {
+            sql += " AND timestamp >= ?";
+            params.push(options.since);
+        }
+        sql += " ORDER BY timestamp ASC LIMIT ?";
+        params.push(options?.limit ?? 100);
+        const stmt = this.db.prepare(sql);
+        const rows = stmt.all(...params);
+        return rows.map((r) => ({
+            id: r.id,
+            timestamp: r.timestamp,
+            tenantId: r.tenant_id ?? undefined,
+            toolName: r.tool_name ?? undefined,
+            durationMs: r.duration_ms ?? undefined,
+            isError: r.is_error === 1,
+            errorCode: r.error_code ?? undefined,
+            cached: r.cached === 1,
+            tokenCount: r.token_count ?? undefined,
+            metadata: r.metadata ? JSON.parse(r.metadata) : undefined,
+        }));
+    }
+    async clear(tenantId) {
+        if (tenantId) {
+            const stmt = this.db.prepare("DELETE FROM chainmcp_telemetry WHERE tenant_id = ?");
+            stmt.run(tenantId);
+        }
+        else {
+            this.db.exec("DELETE FROM chainmcp_telemetry;");
+        }
+    }
+}
+export class SqliteStorageDriver {
+    id = "sqlite";
+    isConnected = false;
+    db = undefined;
+    resolvedPath;
+    busyTimeoutMs;
+    kvStores = new Map();
+    blobStores = new Map();
+    telemetryBuffer = undefined;
+    constructor(options) {
+        this.resolvedPath = resolveDbPath(options?.path);
+        this.busyTimeoutMs = options?.busyTimeoutMs ?? 5000;
+    }
+    async init() {
+        if (this.isConnected) {
+            return;
+        }
+        if (this.resolvedPath !== ":memory:") {
+            await mkdir(dirname(this.resolvedPath), { recursive: true });
+        }
+        try {
+            this.db = new DatabaseSync(this.resolvedPath);
+            if (this.resolvedPath !== ":memory:") {
+                this.db.exec("PRAGMA journal_mode = WAL;");
+                this.db.exec("PRAGMA synchronous = NORMAL;");
+            }
+            this.db.exec(`PRAGMA busy_timeout = ${this.busyTimeoutMs};`);
+            this.db.exec("PRAGMA foreign_keys = ON;");
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS chainmcp_kv (
+          namespace TEXT NOT NULL,
+          tenant_id TEXT NOT NULL DEFAULT '',
+          key TEXT NOT NULL,
+          value TEXT NOT NULL,
+          created_at INTEGER NOT NULL,
+          expires_at INTEGER,
+          PRIMARY KEY (namespace, tenant_id, key)
+        );
+        CREATE INDEX IF NOT EXISTS idx_chainmcp_kv_exp ON chainmcp_kv (expires_at);
+
+        CREATE TABLE IF NOT EXISTS chainmcp_blobs (
+          namespace TEXT NOT NULL,
+          handle TEXT NOT NULL,
+          tenant_id TEXT NOT NULL DEFAULT '',
+          principal_id TEXT,
+          data TEXT NOT NULL,
+          byte_size INTEGER NOT NULL,
+          created_at INTEGER NOT NULL,
+          expires_at INTEGER,
+          PRIMARY KEY (namespace, tenant_id, handle)
+        );
+        CREATE INDEX IF NOT EXISTS idx_chainmcp_blobs_exp ON chainmcp_blobs (expires_at);
+
+        CREATE TABLE IF NOT EXISTS chainmcp_telemetry (
+          id TEXT PRIMARY KEY,
+          timestamp INTEGER NOT NULL,
+          tenant_id TEXT,
+          tool_name TEXT,
+          duration_ms REAL,
+          is_error INTEGER NOT NULL DEFAULT 0,
+          error_code TEXT,
+          cached INTEGER NOT NULL DEFAULT 0,
+          token_count INTEGER,
+          metadata TEXT
+        );
+        CREATE INDEX IF NOT EXISTS idx_chainmcp_telemetry_ts ON chainmcp_telemetry (timestamp);
+        CREATE INDEX IF NOT EXISTS idx_chainmcp_telemetry_tenant ON chainmcp_telemetry (tenant_id);
+      `);
+            this.isConnected = true;
+        }
+        catch (err) {
+            throw new StorageError("SQLITE_INIT_FAILED", `Failed to initialize SQLite storage at '${this.resolvedPath}': ${err.message}`, { cause: err });
+        }
+    }
+    async close() {
+        if (!this.isConnected || !this.db) {
+            return;
+        }
+        this.isConnected = false;
+        this.kvStores.clear();
+        this.blobStores.clear();
+        this.telemetryBuffer = undefined;
+        this.db.close();
+        this.db = undefined;
+    }
+    async ping() {
+        if (!this.isConnected || !this.db) {
+            return false;
+        }
+        try {
+            const stmt = this.db.prepare("SELECT 1 as alive;");
+            const res = stmt.get();
+            return res?.alive === 1;
+        }
+        catch {
+            return false;
+        }
+    }
+    getKeyValueStore(namespace) {
+        if (!this.db || !this.isConnected) {
+            throw new StorageError("NOT_CONNECTED", "Storage driver is not initialized");
+        }
+        let store = this.kvStores.get(namespace);
+        if (!store) {
+            store = new SqliteKeyValueStore(this.db, namespace);
+            this.kvStores.set(namespace, store);
+        }
+        return store;
+    }
+    getBlobPayloadStore(namespace = "default") {
+        if (!this.db || !this.isConnected) {
+            throw new StorageError("NOT_CONNECTED", "Storage driver is not initialized");
+        }
+        let store = this.blobStores.get(namespace);
+        if (!store) {
+            store = new SqliteBlobPayloadStore(this.db, namespace);
+            this.blobStores.set(namespace, store);
+        }
+        return store;
+    }
+    getTelemetryRingBuffer(options) {
+        if (!this.db || !this.isConnected) {
+            throw new StorageError("NOT_CONNECTED", "Storage driver is not initialized");
+        }
+        if (!this.telemetryBuffer) {
+            this.telemetryBuffer = new SqliteTelemetryRingBuffer(this.db, options);
+        }
+        return this.telemetryBuffer;
+    }
+}
+export function createSqliteStorageDriver(options) {
+    return new SqliteStorageDriver(options);
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/sqlite.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,96 @@
+export declare class StorageError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string, options?: ErrorOptions);
+}
+export declare class StoragePayloadTooLargeError extends StorageError {
+    constructor(byteSize: number, maxBytes: number);
+}
+export interface StorageDriverOptions {
+    path?: string | undefined;
+    readOnly?: boolean | undefined;
+}
+export interface StorageDriver {
+    readonly id: string;
+    readonly isConnected: boolean;
+    init(): Promise<void>;
+    close(): Promise<void>;
+    ping(): Promise<boolean>;
+    getKeyValueStore<T = unknown>(namespace: string): KeyValueStore<T>;
+    getBlobPayloadStore(namespace?: string): BlobPayloadStore;
+    getTelemetryRingBuffer(options?: TelemetryRingBufferOptions): TelemetryRingBuffer;
+}
+export interface KeyValueStore<T = unknown> {
+    readonly namespace: string;
+    get(key: string, tenantId?: string): Promise<T | null>;
+    set(key: string, value: T, options?: {
+        tenantId?: string | undefined;
+        ttlMs?: number | undefined;
+    }): Promise<void>;
+    delete(key: string, tenantId?: string): Promise<boolean>;
+    list(options?: {
+        tenantId?: string | undefined;
+        prefix?: string | undefined;
+        limit?: number | undefined;
+    }): Promise<Array<{
+        key: string;
+        value: T;
+    }>>;
+    clear(tenantId?: string): Promise<void>;
+}
+export interface BlobPayload {
+    handle: string;
+    data: string;
+    byteSize: number;
+    tenantId?: string | undefined;
+    principalId?: string | undefined;
+    createdAt: number;
+    expiresAt?: number | undefined;
+}
+export interface BlobStorePutOptions {
+    tenantId?: string | undefined;
+    principalId?: string | undefined;
+    ttlMs?: number | undefined;
+    maxByteSize?: number | undefined;
+}
+export interface BlobPayloadStore {
+    readonly namespace: string;
+    put(handle: string, data: string | Uint8Array, options?: BlobStorePutOptions): Promise<BlobPayload>;
+    get(handle: string, options?: {
+        tenantId?: string | undefined;
+        principalId?: string | undefined;
+    }): Promise<BlobPayload | null>;
+    delete(handle: string, options?: {
+        tenantId?: string | undefined;
+        principalId?: string | undefined;
+    }): Promise<boolean>;
+    pruneExpired(): Promise<number>;
+}
+export interface TelemetryEvent {
+    id: string;
+    timestamp: number;
+    tenantId?: string | undefined;
+    toolName?: string | undefined;
+    durationMs?: number | undefined;
+    isError?: boolean | undefined;
+    errorCode?: string | undefined;
+    cached?: boolean | undefined;
+    tokenCount?: number | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}
+export interface TelemetryRingBufferOptions {
+    maxEntries?: number | undefined;
+    retentionMs?: number | undefined;
+}
+export interface TelemetryQueryOptions {
+    tenantId?: string | undefined;
+    toolName?: string | undefined;
+    since?: number | undefined;
+    limit?: number | undefined;
+}
+export interface TelemetryRingBuffer {
+    push(event: TelemetryEvent): Promise<void>;
+    pushBatch(events: TelemetryEvent[]): Promise<void>;
+    query(options?: TelemetryQueryOptions): Promise<TelemetryEvent[]>;
+    clear(tenantId?: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,14 @@
+export class StorageError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = "StorageError";
+        this.code = code;
+    }
+}
+export class StoragePayloadTooLargeError extends StorageError {
+    constructor(byteSize, maxBytes) {
+        super("PAYLOAD_TOO_LARGE", `Payload size of ${byteSize} bytes exceeds the maximum allowed limit of ${maxBytes} bytes`);
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrB,IAAI,CAAS;IAE7B,YAAY,IAAY,EAAE,OAAe,EAAE,OAAsB;QAC/D,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,YAAY;IAC3D,YAAY,QAAgB,EAAE,QAAgB;QAC5C,KAAK,CACH,mBAAmB,EACnB,mBAAmB,QAAQ,+CAA+C,QAAQ,QAAQ,CAC3F,CAAC;IACJ,CAAC;CACF"}