@frontmcp/storage-sqlite 0.1.0

package/sqlite-elicitation.store.d.ts

@@ -0,0 +1,112 @@
+/**
+ * SQLite Elicitation Store
+ *
+ * Implements the ElicitationStore interface using SQLite KV store.
+ * Uses Node.js EventEmitter for single-process pub/sub (replaces Redis pub/sub).
+ * Suitable for local-only deployments (no distributed pub/sub needed).
+ */
+import { SqliteKvStore } from './sqlite-kv.store';
+import type { SqliteStorageOptions } from './sqlite.options';
+/**
+ * Pending elicitation record.
+ * Matches PendingElicitRecord from @frontmcp/sdk.
+ */
+export interface PendingElicitRecord {
+    elicitId: string;
+    sessionId: string;
+    createdAt: number;
+    expiresAt: number;
+    message: string;
+    mode: string;
+    requestedSchema?: Record<string, unknown>;
+}
+/**
+ * Pending fallback record.
+ * Matches PendingElicitFallback from @frontmcp/sdk.
+ */
+export type PendingElicitFallback = Record<string, unknown>;
+/**
+ * Elicit result type.
+ */
+export type ElicitResult<T = unknown> = {
+    status: string;
+    content?: T;
+    [key: string]: unknown;
+};
+/**
+ * Resolved elicit result stored for re-invocation.
+ */
+export type ResolvedElicitResult = Record<string, unknown>;
+/**
+ * Fallback execution result.
+ */
+export type FallbackExecutionResult = Record<string, unknown>;
+export type ElicitResultCallback<T = unknown> = (result: ElicitResult<T>) => void;
+export type FallbackResultCallback = (result: FallbackExecutionResult) => void;
+export type ElicitUnsubscribe = () => Promise<void>;
+export interface SqliteElicitationStoreOptions extends SqliteStorageOptions {
+    /** Key prefix for elicitation keys. @default 'mcp:elicit:' */
+    keyPrefix?: string;
+}
+/**
+ * Elicitation store interface.
+ * Matches ElicitationStore from @frontmcp/sdk.
+ */
+export interface ElicitationStoreInterface {
+    setPending(record: PendingElicitRecord): Promise<void>;
+    getPending(sessionId: string): Promise<PendingElicitRecord | null>;
+    deletePending(sessionId: string): Promise<void>;
+    subscribeResult<T = unknown>(elicitId: string, callback: ElicitResultCallback<T>, sessionId?: string): Promise<ElicitUnsubscribe>;
+    publishResult<T = unknown>(elicitId: string, sessionId: string, result: ElicitResult<T>): Promise<void>;
+    destroy?(): Promise<void>;
+    setPendingFallback(record: PendingElicitFallback): Promise<void>;
+    getPendingFallback(elicitId: string, sessionId?: string): Promise<PendingElicitFallback | null>;
+    deletePendingFallback(elicitId: string): Promise<void>;
+    setResolvedResult(elicitId: string, result: ElicitResult<unknown>, sessionId?: string): Promise<void>;
+    getResolvedResult(elicitId: string, sessionId?: string): Promise<ResolvedElicitResult | null>;
+    deleteResolvedResult(elicitId: string): Promise<void>;
+    subscribeFallbackResult(elicitId: string, callback: FallbackResultCallback, sessionId?: string): Promise<ElicitUnsubscribe>;
+    publishFallbackResult(elicitId: string, sessionId: string, result: FallbackExecutionResult): Promise<void>;
+}
+/**
+ * SQLite-backed elicitation store with EventEmitter-based pub/sub.
+ *
+ * Storage layout:
+ * - `pending:{sessionId}` - Pending elicitation records
+ * - `fallback:{elicitId}` - Fallback context
+ * - `resolved:{elicitId}` - Pre-resolved results
+ *
+ * Pub/sub channels (via EventEmitter):
+ * - `result:{elicitId}` - Elicitation results
+ * - `fallback-result:{elicitId}` - Fallback execution results
+ */
+export declare class SqliteElicitationStore implements ElicitationStoreInterface {
+    private kv;
+    private emitter;
+    private keyPrefix;
+    constructor(options: SqliteElicitationStoreOptions);
+    private pendingKey;
+    private fallbackKey;
+    private resolvedKey;
+    private resultChannel;
+    private fallbackResultChannel;
+    setPending(record: PendingElicitRecord): Promise<void>;
+    getPending(sessionId: string): Promise<PendingElicitRecord | null>;
+    deletePending(sessionId: string): Promise<void>;
+    subscribeResult<T = unknown>(elicitId: string, callback: ElicitResultCallback<T>, _sessionId?: string): Promise<ElicitUnsubscribe>;
+    publishResult<T = unknown>(elicitId: string, sessionId: string, result: ElicitResult<T>): Promise<void>;
+    setPendingFallback(record: PendingElicitFallback): Promise<void>;
+    getPendingFallback(elicitId: string, _sessionId?: string): Promise<PendingElicitFallback | null>;
+    deletePendingFallback(elicitId: string): Promise<void>;
+    setResolvedResult(elicitId: string, result: ElicitResult<unknown>, _sessionId?: string): Promise<void>;
+    getResolvedResult(elicitId: string, _sessionId?: string): Promise<ResolvedElicitResult | null>;
+    deleteResolvedResult(elicitId: string): Promise<void>;
+    subscribeFallbackResult(elicitId: string, callback: FallbackResultCallback, _sessionId?: string): Promise<ElicitUnsubscribe>;
+    publishFallbackResult(elicitId: string, _sessionId: string, result: FallbackExecutionResult): Promise<void>;
+    destroy(): Promise<void>;
+    /**
+     * Get the underlying KV store (for testing/advanced use).
+     */
+    getKvStore(): SqliteKvStore;
+}
+//# sourceMappingURL=sqlite-elicitation.store.d.ts.map

package/sqlite-elicitation.store.d.ts.map

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

package/sqlite-event.store.d.ts

@@ -0,0 +1,69 @@
+/**
+ * SQLite Event Store
+ *
+ * Implements the EventStore interface from @modelcontextprotocol/sdk for SSE resumability.
+ * Stores events in SQLite with TTL-based expiration and max event limits.
+ */
+import type { SqliteStorageOptions } from './sqlite.options';
+/**
+ * Event store interface matching @modelcontextprotocol/sdk EventStore.
+ * Redeclared here to avoid hard dependency on @modelcontextprotocol/sdk.
+ */
+export interface EventStoreInterface {
+    storeEvent(streamId: string, message: unknown): Promise<string>;
+    replayEventsAfter(lastEventId: string, callbacks: {
+        send: (eventId: string, message: unknown) => Promise<void>;
+    }): Promise<string>;
+}
+export interface SqliteEventStoreOptions extends SqliteStorageOptions {
+    /** Maximum number of events to store before eviction. @default 10000 */
+    maxEvents?: number;
+    /** TTL in milliseconds for stored events. @default 300000 (5 minutes) */
+    ttlMs?: number;
+}
+/**
+ * SQLite-backed event store for SSE resumability.
+ *
+ * Schema:
+ * ```sql
+ * CREATE TABLE IF NOT EXISTS events (
+ *   id         TEXT PRIMARY KEY,
+ *   stream_id  TEXT NOT NULL,
+ *   message    TEXT NOT NULL,
+ *   created_at INTEGER NOT NULL
+ * );
+ * ```
+ */
+export declare class SqliteEventStore implements EventStoreInterface {
+    private db;
+    private maxEvents;
+    private ttlMs;
+    private counters;
+    private cleanupTimer;
+    private stmts;
+    constructor(options: SqliteEventStoreOptions);
+    private initSchema;
+    private prepareStatements;
+    /**
+     * Return prepared statements, throwing if not yet initialized.
+     */
+    private prepared;
+    /**
+     * Get the next counter value for a stream, rehydrating from SQLite on first use.
+     */
+    private getNextCounter;
+    storeEvent(streamId: string, message: unknown): Promise<string>;
+    replayEventsAfter(lastEventId: string, { send }: {
+        send: (eventId: string, message: unknown) => Promise<void>;
+    }): Promise<string>;
+    private evictExpired;
+    /**
+     * Close the database connection and stop cleanup timer.
+     */
+    close(): void;
+    /**
+     * Get the current number of stored events.
+     */
+    get size(): number;
+}
+//# sourceMappingURL=sqlite-event.store.d.ts.map

package/sqlite-event.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-event.store.d.ts","sourceRoot":"","sources":["../src/sqlite-event.store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChE,iBAAiB,CACf,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE;QAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GACxE,OAAO,CAAC,MAAM,CAAC,CAAC;CACpB;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,KAAK,CAAmC;gBAEpC,OAAO,EAAE,uBAAuB;IA+B5C,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBhB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB/D,iBAAiB,CACrB,WAAW,EAAE,MAAM,EACnB,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GACvE,OAAO,CAAC,MAAM,CAAC;IAyBlB,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAIjB;CACF"}

package/sqlite-kv.store.d.ts

@@ -0,0 +1,98 @@
+/**
+ * SQLite Key-Value Store
+ *
+ * Core KV store built on better-sqlite3 with Redis-compatible interface.
+ * Supports TTL expiration, optional encryption, and WAL mode.
+ */
+import type Database from 'better-sqlite3';
+import type { SqliteStorageOptions } from './sqlite.options';
+/**
+ * SQLite-backed key-value store with TTL support and optional encryption.
+ *
+ * Schema:
+ * ```sql
+ * CREATE TABLE IF NOT EXISTS kv (
+ *   key        TEXT PRIMARY KEY,
+ *   value      TEXT NOT NULL,
+ *   expires_at INTEGER  -- Unix timestamp ms, NULL = no expiry
+ * );
+ * ```
+ */
+export declare class SqliteKvStore {
+    private db;
+    private encryptionKey;
+    private cleanupTimer;
+    private stmts;
+    constructor(options: SqliteStorageOptions);
+    private initSchema;
+    private prepareStatements;
+    /**
+     * Return prepared statements, throwing if not yet initialized.
+     */
+    private prepared;
+    /**
+     * Get a value by key.
+     * Returns null if key doesn't exist or is expired.
+     */
+    get(key: string): string | null;
+    /**
+     * Get a value and parse it as JSON.
+     */
+    getJSON<T = unknown>(key: string): T | null;
+    /**
+     * Set a key-value pair with optional TTL.
+     *
+     * @param key - The key
+     * @param value - The value to store
+     * @param ttlMs - Time to live in milliseconds (optional)
+     */
+    set(key: string, value: string, ttlMs?: number): void;
+    /**
+     * Set a key-value pair with JSON serialization and optional TTL.
+     */
+    setJSON(key: string, value: unknown, ttlMs?: number): void;
+    /**
+     * Delete a key.
+     */
+    del(key: string): void;
+    /**
+     * Check if a key exists (and is not expired).
+     */
+    has(key: string): boolean;
+    /**
+     * List keys matching an optional glob-like pattern.
+     * Pattern uses SQL LIKE syntax: `%` for any characters, `_` for single character.
+     *
+     * @param pattern - Optional pattern (uses SQL LIKE). Without pattern, returns all keys.
+     * @returns Array of matching key strings
+     */
+    keys(pattern?: string): string[];
+    /**
+     * Set TTL on an existing key.
+     *
+     * @param key - The key to set expiry on
+     * @param ttlMs - Time to live in milliseconds
+     * @returns true if key exists and TTL was set, false if key doesn't exist
+     */
+    expire(key: string, ttlMs: number): boolean;
+    /**
+     * Get remaining TTL for a key in milliseconds.
+     *
+     * @returns TTL in ms, -1 if no expiry, -2 if key doesn't exist
+     */
+    ttl(key: string): number;
+    /**
+     * Purge all expired keys.
+     * Called periodically by the cleanup timer.
+     */
+    purgeExpired(): number;
+    /**
+     * Close the database connection and stop cleanup timer.
+     */
+    close(): void;
+    /**
+     * Get the underlying database instance (for advanced use cases / testing).
+     */
+    getDatabase(): Database.Database;
+}
+//# sourceMappingURL=sqlite-kv.store.d.ts.map

package/sqlite-kv.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-kv.store.d.ts","sourceRoot":"","sources":["../src/sqlite-kv.store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAe7D;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,KAAK,CAAqC;gBAEtC,OAAO,EAAE,oBAAoB;IAmCzC,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAmB/B;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAW3C;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IASrD;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAI1D;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAItB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKzB;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAchC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAM3C;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAexB;;;OAGG;IACH,YAAY,IAAI,MAAM;IAKtB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,QAAQ;CAGjC"}

package/sqlite-session.store.d.ts

@@ -0,0 +1,55 @@
+/**
+ * SQLite Session Store
+ *
+ * Implements the SessionStore interface using SQLite KV store.
+ * Uses key-prefix namespace isolation for session data.
+ */
+import { SqliteKvStore } from './sqlite-kv.store';
+import type { SqliteStorageOptions } from './sqlite.options';
+/**
+ * Session store interface (matching @frontmcp/sdk SessionStore).
+ * Redeclared here to avoid hard dependency on @frontmcp/sdk.
+ */
+export interface SessionStoreInterface {
+    get(sessionId: string): Promise<StoredSessionData | null>;
+    set(sessionId: string, session: StoredSessionData, ttlMs?: number): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+    exists(sessionId: string): Promise<boolean>;
+    allocId(): string;
+}
+/**
+ * Stored session data type.
+ * This is a generic JSON-serializable record that matches StoredSession from SDK.
+ */
+export type StoredSessionData = Record<string, unknown>;
+export interface SqliteSessionStoreOptions extends SqliteStorageOptions {
+    /** Key prefix for session keys. @default 'mcp:session:' */
+    keyPrefix?: string;
+    /** Default TTL for sessions in milliseconds. @default 3600000 (1 hour) */
+    defaultTtlMs?: number;
+}
+/**
+ * SQLite-backed session store.
+ * Stores sessions as JSON in the SQLite KV store with TTL support.
+ */
+export declare class SqliteSessionStore implements SessionStoreInterface {
+    private kv;
+    private keyPrefix;
+    private defaultTtlMs;
+    constructor(options: SqliteSessionStoreOptions);
+    private sessionKey;
+    get(sessionId: string): Promise<StoredSessionData | null>;
+    set(sessionId: string, session: StoredSessionData, ttlMs?: number): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+    exists(sessionId: string): Promise<boolean>;
+    allocId(): string;
+    /**
+     * Close the underlying SQLite connection.
+     */
+    close(): void;
+    /**
+     * Get the underlying KV store (for testing/advanced use).
+     */
+    getKvStore(): SqliteKvStore;
+}
+//# sourceMappingURL=sqlite-session.store.d.ts.map

package/sqlite-session.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-session.store.d.ts","sourceRoot":"","sources":["../src/sqlite-session.store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC1D,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,IAAI,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,qBAAqB;IAC9D,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,yBAAyB;IAM9C,OAAO,CAAC,UAAU;IAIZ,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAIzD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjF,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjD,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,UAAU,IAAI,aAAa;CAG5B"}

package/sqlite.options.d.ts

@@ -0,0 +1,51 @@
+/**
+ * SQLite Storage Options
+ *
+ * Configuration types and Zod schema for SQLite-based storage.
+ */
+import { z } from 'zod';
+/**
+ * SQLite storage configuration options.
+ */
+export interface SqliteStorageOptions {
+    /** Path to the .sqlite database file */
+    path: string;
+    /**
+     * Encryption configuration for at-rest encryption of values.
+     * Keys are stored in plaintext (needed for lookups), values are encrypted.
+     */
+    encryption?: {
+        /** Secret key material for AES-256-GCM encryption via HKDF-SHA256 */
+        secret: string;
+    };
+    /**
+     * Interval in milliseconds for purging expired keys.
+     * @default 60000
+     */
+    ttlCleanupIntervalMs?: number;
+    /**
+     * Enable WAL (Write-Ahead Logging) mode for better read concurrency.
+     * @default true
+     */
+    walMode?: boolean;
+}
+/**
+ * Zod schema for SQLite storage configuration.
+ */
+export declare const sqliteStorageOptionsSchema: z.ZodObject<{
+    path: z.ZodString;
+    encryption: z.ZodOptional<z.ZodObject<{
+        secret: z.ZodString;
+    }, z.core.$strip>>;
+    ttlCleanupIntervalMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    walMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+/**
+ * SQLite storage input type (before Zod defaults).
+ */
+export type SqliteStorageOptionsInput = z.input<typeof sqliteStorageOptionsSchema>;
+/**
+ * SQLite storage output type (after Zod defaults).
+ */
+export type SqliteStorageOptionsParsed = z.infer<typeof sqliteStorageOptionsSchema>;
+//# sourceMappingURL=sqlite.options.d.ts.map

package/sqlite.options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.options.d.ts","sourceRoot":"","sources":["../src/sqlite.options.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,UAAU,CAAC,EAAE;QACX,qEAAqE;QACrE,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;iBASrC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}