@framers/sql-storage-adapter 0.3.5 → 0.4.2

package/dist/core/contracts/hooks.js

@@ -0,0 +1,215 @@
+/**
+ * Lifecycle Hooks for SQL Storage Adapter
+ *
+ * This module defines the hook system that enables extending adapter behavior
+ * without modifying core implementations. Hooks are particularly useful for:
+ *
+ * - **Analytics**: Query logging, performance monitoring
+ * - **Auditing**: Write logging, compliance tracking
+ * - **Caching**: Custom cache strategies, invalidation
+ * - **Transformation**: Query/result modification
+ * - **Extensions**: Build higher-level abstractions on top
+ *
+ * @packageDocumentation
+ * @module @framers/sql-storage-adapter/hooks
+ *
+ * @remarks
+ * Hooks are executed in a predictable order:
+ * 1. `onBeforeQuery`/`onBeforeWrite` - Before operation execution
+ * 2. Operation executes
+ * 3. `onAfterQuery`/`onAfterWrite` - After successful execution
+ * 4. `onError` - If an error occurred
+ *
+ * @example Audit logging hook
+ * ```typescript
+ * import { createDatabase, type StorageHooks } from '@framers/sql-storage-adapter';
+ *
+ * const auditHooks: StorageHooks = {
+ *   onBeforeWrite: async (context) => {
+ *     console.log(`[AUDIT] ${context.operation}: ${context.statement}`);
+ *     return context;
+ *   }
+ * };
+ *
+ * const db = await createDatabase({ hooks: auditHooks });
+ * ```
+ */
+// ============================================================================
+// Hook Utilities
+// ============================================================================
+/**
+ * Combines multiple hook objects into a single hook object.
+ *
+ * When multiple hooks are combined, they execute in order.
+ * For transformation hooks (onBefore*, onAfter*), each hook
+ * receives the result of the previous hook.
+ *
+ * @param hooks - Hook objects to combine
+ * @returns Combined hook object
+ *
+ * @example
+ * ```typescript
+ * const loggingHooks: StorageHooks = {
+ *   onBeforeQuery: async (ctx) => {
+ *     console.log('Query:', ctx.statement);
+ *     return ctx;
+ *   }
+ * };
+ *
+ * const metricsHooks: StorageHooks = {
+ *   onAfterQuery: async (ctx, result) => {
+ *     metrics.record('query', Date.now() - ctx.startTime);
+ *     return result;
+ *   }
+ * };
+ *
+ * const combinedHooks = combineHooks(loggingHooks, metricsHooks);
+ * ```
+ */
+export function combineHooks(...hooks) {
+    return {
+        onBeforeQuery: async (context) => {
+            let ctx = context;
+            for (const hook of hooks) {
+                if (hook.onBeforeQuery) {
+                    const result = await hook.onBeforeQuery(ctx);
+                    if (result === undefined) {
+                        return undefined; // Early abort
+                    }
+                    ctx = result;
+                }
+            }
+            return ctx;
+        },
+        onAfterQuery: async (context, result) => {
+            let res = result;
+            for (const hook of hooks) {
+                if (hook.onAfterQuery) {
+                    const transformed = await hook.onAfterQuery(context, res);
+                    if (transformed !== undefined) {
+                        res = transformed;
+                    }
+                }
+            }
+            return res;
+        },
+        onBeforeWrite: async (context) => {
+            let ctx = context;
+            for (const hook of hooks) {
+                if (hook.onBeforeWrite) {
+                    const result = await hook.onBeforeWrite(ctx);
+                    if (result === undefined) {
+                        return undefined; // Early abort
+                    }
+                    ctx = result;
+                }
+            }
+            return ctx;
+        },
+        onAfterWrite: async (context, result) => {
+            for (const hook of hooks) {
+                if (hook.onAfterWrite) {
+                    await hook.onAfterWrite(context, result);
+                }
+            }
+        },
+        onBeforeTransaction: async (context) => {
+            let ctx = context;
+            for (const hook of hooks) {
+                if (hook.onBeforeTransaction) {
+                    const result = await hook.onBeforeTransaction(ctx);
+                    if (result === undefined) {
+                        return undefined;
+                    }
+                    ctx = result;
+                }
+            }
+            return ctx;
+        },
+        onAfterTransaction: async (context) => {
+            for (const hook of hooks) {
+                if (hook.onAfterTransaction) {
+                    await hook.onAfterTransaction(context);
+                }
+            }
+        },
+        onError: async (error, context) => {
+            let err = error;
+            for (const hook of hooks) {
+                if (hook.onError && err) {
+                    const result = await hook.onError(err, context);
+                    if (result === undefined) {
+                        return undefined; // Error suppressed
+                    }
+                    err = result;
+                }
+            }
+            return err;
+        },
+    };
+}
+/**
+ * Creates a hook that only runs for specific operations.
+ *
+ * @param operations - Operations to filter for
+ * @param hooks - Hooks to apply
+ * @returns Filtered hooks
+ *
+ * @example Only log write operations
+ * ```typescript
+ * const writeOnlyHooks = filterHooks(['run', 'batch'], {
+ *   onBeforeWrite: async (ctx) => {
+ *     console.log('Write:', ctx.statement);
+ *     return ctx;
+ *   }
+ * });
+ * ```
+ */
+export function filterHooks(operations, hooks) {
+    const operationSet = new Set(operations);
+    return {
+        onBeforeQuery: hooks.onBeforeQuery
+            ? async (ctx) => operationSet.has(ctx.operation) ? hooks.onBeforeQuery(ctx) : ctx
+            : undefined,
+        onAfterQuery: hooks.onAfterQuery
+            ? async (ctx, result) => operationSet.has(ctx.operation) ? hooks.onAfterQuery(ctx, result) : result
+            : undefined,
+        onBeforeWrite: hooks.onBeforeWrite
+            ? async (ctx) => operationSet.has(ctx.operation) ? hooks.onBeforeWrite(ctx) : ctx
+            : undefined,
+        onAfterWrite: hooks.onAfterWrite
+            ? async (ctx, result) => { if (operationSet.has(ctx.operation))
+                await hooks.onAfterWrite(ctx, result); }
+            : undefined,
+        onBeforeTransaction: hooks.onBeforeTransaction
+            ? async (ctx) => operationSet.has(ctx.operation) ? hooks.onBeforeTransaction(ctx) : ctx
+            : undefined,
+        onAfterTransaction: hooks.onAfterTransaction
+            ? async (ctx) => { if (operationSet.has(ctx.operation))
+                await hooks.onAfterTransaction(ctx); }
+            : undefined,
+        onError: hooks.onError
+            ? async (err, ctx) => operationSet.has(ctx.operation) ? hooks.onError(err, ctx) : err
+            : undefined,
+    };
+}
+/**
+ * Generates a unique operation ID.
+ *
+ * @returns UUID v4 string
+ *
+ * @internal
+ */
+export function generateOperationId() {
+    // Use crypto.randomUUID if available, otherwise fallback
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    // Fallback UUID v4 generation
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+//# sourceMappingURL=hooks.js.map

package/dist/core/contracts/hooks.js.map

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

package/dist/core/contracts/index.d.ts

@@ -232,4 +232,14 @@ export declare class StorageResolutionError extends Error {
     readonly causes: unknown[];
     constructor(message: string, causes?: unknown[]);
 }
+/**
+ * Performance configuration types for cost/accuracy optimization.
+ * See `OPTIMIZATION_GUIDE.md` for detailed usage documentation.
+ */
+export * from './performance';
+/**
+ * Lifecycle hooks for extending adapter behavior.
+ * Designed for RAG integration, analytics, and auditing.
+ */
+export * from './hooks';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/contracts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,cAAc,GACd,KAAK,GACL,OAAO,GACP,aAAa,GACb,WAAW,GACX,OAAO,GACP,UAAU,GACV,YAAY,GACZ,MAAM,GACN,QAAQ,CAAA;AAEZ;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,IAAI,GACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,UAAU,GAAG,OAAO,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,sDAAsD;IACtD,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAEtD;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;;;;;;;;;OAUG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAElF;;;;;;;;;OASG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvF;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAElF;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpE;;;;;;;;;;;;;OAaG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE3D;;;;;;;;;;OAUG;IACH,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,GAAG,CAAC,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/D,GAAG,CAAC,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvD,GAAG,CAAC,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAClD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;AAElE;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE;gBAA3C,OAAO,EAAE,MAAM,EAAW,MAAM,GAAE,OAAO,EAAO;CAI7D;AAMD;;;GAGG;AACH,cAAc,eAAe,CAAC;AAE9B;;;GAGG;AACH,cAAc,SAAS,CAAC"}

package/dist/core/contracts/index.js

@@ -15,4 +15,17 @@ export class StorageResolutionError extends Error {
         this.name = 'StorageResolutionError';
     }
 }
+// ============================================================================
+// Re-export Performance and Hooks Types
+// ============================================================================
+/**
+ * Performance configuration types for cost/accuracy optimization.
+ * See `OPTIMIZATION_GUIDE.md` for detailed usage documentation.
+ */
+export * from './performance.js';
+/**
+ * Lifecycle hooks for extending adapter behavior.
+ * Designed for RAG integration, analytics, and auditing.
+ */
+export * from './hooks.js';
 //# sourceMappingURL=index.js.map

package/dist/core/contracts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6PH;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe,EAAW,SAAoB,EAAE;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,WAAM,GAAN,MAAM,CAAgB;QAE1D,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6PH;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe,EAAW,SAAoB,EAAE;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,WAAM,GAAN,MAAM,CAAgB;QAE1D,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;AAE/E;;;GAGG;AACH,cAAc,eAAe,CAAC;AAE9B;;;GAGG;AACH,cAAc,SAAS,CAAC"}

package/dist/core/contracts/performance.d.ts

@@ -0,0 +1,308 @@
+/**
+ * Performance Configuration Types for SQL Storage Adapter
+ *
+ * This module defines the performance tier system, caching configuration,
+ * and optimization options that enable cost/accuracy tradeoffs across
+ * all adapter implementations.
+ *
+ * @packageDocumentation
+ * @module @framers/sql-storage-adapter/performance
+ *
+ * @remarks
+ * The performance system is designed to be:
+ * - **Platform-agnostic**: Same API across browser, mobile, desktop, cloud
+ * - **Extensible**: Hooks and metadata support for custom extensions
+ * - **Configurable**: Sensible defaults with full override capability
+ * - **Observable**: Built-in metrics and slow query logging
+ *
+ * @example Basic usage with tier presets
+ * ```typescript
+ * import { createDatabase } from '@framers/sql-storage-adapter';
+ *
+ * // Development: prioritize speed
+ * const devDb = await createDatabase({
+ *   performance: { tier: 'fast' }
+ * });
+ *
+ * // Production analytics: prioritize accuracy
+ * const analyticsDb = await createDatabase({
+ *   performance: { tier: 'accurate', trackMetrics: true }
+ * });
+ * ```
+ */
+/**
+ * Performance tier presets for common use cases.
+ *
+ * Each tier provides sensible defaults that can be individually overridden.
+ * The tier affects caching, batching, validation, and query optimization.
+ *
+ * | Tier | Use Case | Caching | Batching | Validation |
+ * |------|----------|---------|----------|------------|
+ * | `fast` | Development, testing | Aggressive | Yes | Minimal |
+ * | `balanced` | General production | Moderate | No | Standard |
+ * | `accurate` | Analytics, reporting | Disabled | No | Full |
+ * | `efficient` | Mobile, battery-constrained | Moderate | Yes | Minimal |
+ * | `custom` | Full manual control | Manual | Manual | Manual |
+ *
+ * @example
+ * ```typescript
+ * // Mobile app with battery optimization
+ * const db = await createDatabase({
+ *   performance: { tier: 'efficient' }
+ * });
+ * ```
+ */
+export type PerformanceTier = 'fast' | 'balanced' | 'accurate' | 'efficient' | 'custom';
+/**
+ * Default settings for each performance tier.
+ *
+ * @internal
+ */
+export declare const TIER_DEFAULTS: Record<Exclude<PerformanceTier, 'custom'>, Readonly<PerformanceSettings>>;
+/**
+ * Individual performance settings (all fields required).
+ *
+ * @internal
+ * Used internally after merging tier defaults with user overrides.
+ */
+export interface PerformanceSettings {
+    /** Enable query result caching */
+    readonly cacheEnabled: boolean;
+    /** Cache TTL in milliseconds */
+    readonly cacheTtlMs: number;
+    /** Maximum cache entries */
+    readonly cacheMaxEntries: number;
+    /** Enable write batching */
+    readonly batchWrites: boolean;
+    /** Batch flush interval in ms */
+    readonly batchFlushIntervalMs: number;
+    /** Maximum batch size before auto-flush */
+    readonly batchMaxSize: number;
+    /** Validate SQL before execution */
+    readonly validateSql: boolean;
+    /** Track performance metrics */
+    readonly trackMetrics: boolean;
+    /** Log slow queries above this threshold in ms */
+    readonly slowQueryThresholdMs: number;
+    /** Retry transient errors */
+    readonly retryOnError: boolean;
+    /** Maximum retry attempts */
+    readonly maxRetries: number;
+    /** Retry delay in ms */
+    readonly retryDelayMs: number;
+}
+/**
+ * Performance configuration options provided by users.
+ *
+ * All fields are optional; unspecified fields use tier defaults.
+ *
+ * @example Override specific settings while using a tier
+ * ```typescript
+ * const db = await createDatabase({
+ *   performance: {
+ *     tier: 'balanced',
+ *     cacheTtlMs: 30000,     // Override: longer cache
+ *     trackMetrics: true,    // Override: enable metrics
+ *   }
+ * });
+ * ```
+ */
+export interface PerformanceConfig {
+    /**
+     * Performance tier preset.
+     *
+     * @defaultValue 'balanced'
+     */
+    tier?: PerformanceTier;
+    /**
+     * Enable query result caching.
+     *
+     * When enabled, identical SELECT queries return cached results
+     * until the cache TTL expires or cache is invalidated.
+     *
+     * @remarks
+     * - Caching is per-adapter instance (not shared)
+     * - Cache is invalidated on any write operation to affected tables
+     * - Use `accurate` tier for systems where stale data is unacceptable
+     *
+     * @defaultValue tier-dependent
+     */
+    cacheEnabled?: boolean;
+    /**
+     * Cache time-to-live in milliseconds.
+     *
+     * After this duration, cached query results are considered stale
+     * and will be re-fetched on next access.
+     *
+     * @defaultValue 5000 for balanced tier
+     */
+    cacheTtlMs?: number;
+    /**
+     * Maximum number of cached query results.
+     *
+     * When exceeded, least-recently-used entries are evicted.
+     *
+     * @defaultValue 1000 for balanced tier
+     */
+    cacheMaxEntries?: number;
+    /**
+     * Enable write batching.
+     *
+     * When enabled, write operations (INSERT, UPDATE, DELETE) are
+     * collected and executed in batches to reduce I/O operations.
+     *
+     * @remarks
+     * - Recommended for mobile/browser environments
+     * - Not recommended for systems requiring immediate consistency
+     * - Batch is flushed on `batchFlushIntervalMs` or `batchMaxSize`
+     *
+     * @defaultValue false for balanced tier, true for efficient tier
+     */
+    batchWrites?: boolean;
+    /**
+     * Batch flush interval in milliseconds.
+     *
+     * Accumulated writes are flushed after this interval.
+     *
+     * @defaultValue 100 for balanced tier
+     */
+    batchFlushIntervalMs?: number;
+    /**
+     * Maximum batch size before auto-flush.
+     *
+     * When batch reaches this size, it is immediately flushed
+     * regardless of the flush interval.
+     *
+     * @defaultValue 50 for balanced tier
+     */
+    batchMaxSize?: number;
+    /**
+     * Validate SQL statements before execution.
+     *
+     * Performs basic syntax and injection checks.
+     *
+     * @defaultValue true for balanced tier
+     */
+    validateSql?: boolean;
+    /**
+     * Track performance metrics.
+     *
+     * When enabled, the adapter tracks:
+     * - Total queries/mutations/transactions
+     * - Average query duration
+     * - Error counts
+     * - Uptime
+     *
+     * Retrieve metrics via `adapter.getMetrics()`.
+     *
+     * @defaultValue true for balanced tier
+     */
+    trackMetrics?: boolean;
+    /**
+     * Slow query logging threshold in milliseconds.
+     *
+     * Queries exceeding this duration are logged at warn level.
+     *
+     * @defaultValue 100 for balanced tier
+     */
+    slowQueryThresholdMs?: number;
+    /**
+     * Retry operations on transient errors.
+     *
+     * Transient errors include network timeouts, connection resets,
+     * and deadlocks.
+     *
+     * @defaultValue true for balanced tier
+     */
+    retryOnError?: boolean;
+    /**
+     * Maximum retry attempts.
+     *
+     * @defaultValue 3 for balanced tier
+     */
+    maxRetries?: number;
+    /**
+     * Delay between retry attempts in milliseconds.
+     *
+     * Uses exponential backoff: delay * 2^attempt.
+     *
+     * @defaultValue 100 for balanced tier
+     */
+    retryDelayMs?: number;
+}
+/**
+ * Cache entry for query results.
+ *
+ * @internal
+ */
+export interface CacheEntry<T = unknown> {
+    /** Cached result data */
+    readonly data: T;
+    /** Timestamp when entry was created (ms since epoch) */
+    readonly createdAt: number;
+    /** Timestamp when entry expires (ms since epoch) */
+    readonly expiresAt: number;
+    /** Tables affected by this query (for invalidation) */
+    readonly affectedTables: ReadonlyArray<string>;
+    /** Cache hit count for LRU tracking */
+    hits: number;
+    /** Last access timestamp for LRU tracking */
+    lastAccessedAt: number;
+}
+/**
+ * Cache statistics for monitoring (public API is readonly).
+ */
+export interface CacheStats {
+    /** Total cache hits */
+    readonly hits: number;
+    /** Total cache misses */
+    readonly misses: number;
+    /** Hit ratio (hits / (hits + misses)) */
+    readonly hitRatio: number;
+    /** Current number of entries */
+    readonly size: number;
+    /** Total bytes used (approximate) */
+    readonly bytesUsed: number;
+    /** Number of evictions */
+    readonly evictions: number;
+    /** Number of invalidations */
+    readonly invalidations: number;
+}
+/**
+ * Mutable version of CacheStats for internal use.
+ */
+export type MutableCacheStats = {
+    -readonly [K in keyof CacheStats]: CacheStats[K];
+};
+/**
+ * Resolves performance configuration by merging tier defaults with user overrides.
+ *
+ * @param config - User-provided performance configuration
+ * @returns Fully resolved performance settings
+ *
+ * @example
+ * ```typescript
+ * const settings = resolvePerformanceConfig({ tier: 'fast', cacheTtlMs: 10000 });
+ * // Returns fast tier defaults with cacheTtlMs overridden to 10000
+ * ```
+ */
+export declare function resolvePerformanceConfig(config?: PerformanceConfig): PerformanceSettings;
+/**
+ * Checks if an error is transient and should be retried.
+ *
+ * @param error - The error to check
+ * @returns true if the error is transient
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await db.run('INSERT INTO users (name) VALUES (?)', ['Alice']);
+ * } catch (error) {
+ *   if (isTransientError(error)) {
+ *     // Retry the operation
+ *   }
+ * }
+ * ```
+ */
+export declare function isTransientError(error: unknown): boolean;
+//# sourceMappingURL=performance.d.ts.map

package/dist/core/contracts/performance.d.ts.map

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