@delali/sirannon-db 0.1.6 → 0.1.8

package/dist/chunk-3MCMONVP.mjs

@@ -1,115 +0,0 @@
-import { QueryError } from './chunk-O7BHI3CF.mjs';
-
-// src/core/query-executor.ts
-var STATEMENT_CACHE_CAPACITY = 128;
-var statementCaches = /* @__PURE__ */ new WeakMap();
-async function getStatement(conn, sql) {
-  let cache = statementCaches.get(conn);
-  if (!cache) {
-    cache = /* @__PURE__ */ new Map();
-    statementCaches.set(conn, cache);
-  }
-  const cached = cache.get(sql);
-  if (cached) {
-    cache.delete(sql);
-    cache.set(sql, cached);
-    return cached;
-  }
-  const pending = conn.prepare(sql);
-  cache.set(sql, pending);
-  if (cache.size > STATEMENT_CACHE_CAPACITY) {
-    const oldest = cache.keys().next().value;
-    if (oldest !== void 0) {
-      cache.delete(oldest);
-    }
-  }
-  try {
-    return await pending;
-  } catch (err) {
-    cache.delete(sql);
-    throw err;
-  }
-}
-function bindParams(params) {
-  if (params === void 0) return [];
-  if (Array.isArray(params)) return params;
-  return [params];
-}
-async function query(conn, sql, params) {
-  try {
-    const stmt = await getStatement(conn, sql);
-    return await stmt.all(...bindParams(params));
-  } catch (err) {
-    throw new QueryError(err instanceof Error ? err.message : String(err), sql);
-  }
-}
-async function queryOne(conn, sql, params) {
-  try {
-    const stmt = await getStatement(conn, sql);
-    return await stmt.get(...bindParams(params));
-  } catch (err) {
-    throw new QueryError(err instanceof Error ? err.message : String(err), sql);
-  }
-}
-async function execute(conn, sql, params) {
-  try {
-    const stmt = await getStatement(conn, sql);
-    const result = await stmt.run(...bindParams(params));
-    return {
-      changes: result.changes,
-      lastInsertRowId: result.lastInsertRowId
-    };
-  } catch (err) {
-    throw new QueryError(err instanceof Error ? err.message : String(err), sql);
-  }
-}
-async function executeBatch(conn, sql, paramsBatch) {
-  try {
-    const stmt = await getStatement(conn, sql);
-    const results = [];
-    for (const params of paramsBatch) {
-      const result = await stmt.run(...bindParams(params));
-      results.push({
-        changes: result.changes,
-        lastInsertRowId: result.lastInsertRowId
-      });
-    }
-    return results;
-  } catch (err) {
-    throw new QueryError(err instanceof Error ? err.message : String(err), sql);
-  }
-}
-
-// src/core/transaction.ts
-var Transaction = class _Transaction {
-  constructor(conn) {
-    this.conn = conn;
-  }
-  _lastInsertRowId = 0;
-  async query(sql, params) {
-    return query(this.conn, sql, params);
-  }
-  async execute(sql, params) {
-    const result = await execute(this.conn, sql, params);
-    this._lastInsertRowId = result.lastInsertRowId;
-    return result;
-  }
-  async executeBatch(sql, paramsBatch) {
-    const results = await executeBatch(this.conn, sql, paramsBatch);
-    if (results.length > 0) {
-      this._lastInsertRowId = results[results.length - 1].lastInsertRowId;
-    }
-    return results;
-  }
-  get lastInsertRowId() {
-    return this._lastInsertRowId;
-  }
-  static async run(conn, fn) {
-    return conn.transaction(async (txConn) => {
-      const tx = new _Transaction(txConn);
-      return fn(tx);
-    });
-  }
-};
-
-export { Transaction, execute, executeBatch, query, queryOne };

package/dist/chunk-74UN4DIE.mjs

@@ -1,14 +0,0 @@
-import { SirannonError } from './chunk-O7BHI3CF.mjs';
-
-// src/core/driver/define.ts
-function defineDriver(config) {
-  if (!config.capabilities || typeof config.open !== "function") {
-    throw new SirannonError("Driver must define capabilities and open()", "INVALID_DRIVER");
-  }
-  return Object.freeze({
-    capabilities: Object.freeze({ ...config.capabilities }),
-    open: config.open
-  });
-}
-
-export { defineDriver };

package/dist/chunk-FB2U2Q3Y.mjs

@@ -1,21 +0,0 @@
-// src/core/errors.ts
-var SirannonError = class extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-    this.name = "SirannonError";
-  }
-};
-
-// src/core/driver/define.ts
-function defineDriver(config) {
-  if (!config.capabilities || typeof config.open !== "function") {
-    throw new SirannonError("Driver must define capabilities and open()", "INVALID_DRIVER");
-  }
-  return Object.freeze({
-    capabilities: Object.freeze({ ...config.capabilities }),
-    open: config.open
-  });
-}
-
-export { defineDriver };

package/dist/chunk-GS7T5YMI.mjs

@@ -1,51 +0,0 @@
-// src/core/cdc/encoding.ts
-var BLOB_TAG = "__sirannon_blob";
-var INT_TAG = "__sirannon_int";
-var SAFE_INT_BOUND_TEXT = "9007199254740991";
-var HEX_BYTES_RE = /^[0-9a-fA-F]*$/;
-function decodeTaggedValues(value) {
-  if (value === null || typeof value !== "object") return value;
-  if (isBinaryValue(value)) return value;
-  if (Array.isArray(value)) {
-    return value.map(decodeTaggedValues);
-  }
-  const obj = value;
-  const keys = Object.keys(obj);
-  if (keys.length === 1) {
-    const tag = keys[0];
-    const tagValue = obj[tag];
-    if (tag === BLOB_TAG && typeof tagValue === "string") {
-      return decodeHexBytes(tagValue);
-    }
-    if (tag === INT_TAG && typeof tagValue === "string") {
-      return BigInt(tagValue);
-    }
-  }
-  const out = {};
-  for (const k of keys) {
-    out[k] = decodeTaggedValues(obj[k]);
-  }
-  return out;
-}
-function isBinaryValue(value) {
-  return value instanceof Uint8Array || typeof Buffer !== "undefined" && Buffer.isBuffer(value);
-}
-function decodeHexBytes(hex) {
-  if (hex.length % 2 !== 0 || !HEX_BYTES_RE.test(hex)) {
-    throw new Error("Invalid CDC BLOB hex payload");
-  }
-  if (typeof Buffer !== "undefined") {
-    return Buffer.from(hex, "hex");
-  }
-  const bytes = new Uint8Array(hex.length / 2);
-  for (let i = 0; i < hex.length; i += 2) {
-    const byte = Number.parseInt(hex.slice(i, i + 2), 16);
-    if (Number.isNaN(byte)) {
-      throw new Error("Invalid CDC BLOB hex payload");
-    }
-    bytes[i / 2] = byte;
-  }
-  return bytes;
-}
-
-export { SAFE_INT_BOUND_TEXT, decodeTaggedValues };

package/dist/chunk-PXKAKK2V.mjs

@@ -1,124 +0,0 @@
-import { BackupError } from './chunk-O7BHI3CF.mjs';
-import { existsSync, mkdirSync, rmSync, readdirSync, lstatSync } from 'fs';
-import { resolve, dirname, join } from 'path';
-import { Cron } from 'croner';
-
-var BACKUP_FILE_PREFIX = "backup";
-function hasControlCharacters(s) {
-  for (let i = 0; i < s.length; i++) {
-    const code = s.charCodeAt(i);
-    if (code <= 31) return true;
-  }
-  return false;
-}
-var BackupManager = class {
-  async backup(conn, destPath) {
-    if (hasControlCharacters(destPath)) {
-      throw new BackupError("Backup path contains invalid characters");
-    }
-    const segments = destPath.split(/[/\\]/);
-    if (segments.includes("..")) {
-      throw new BackupError("Backup path must not contain directory traversal segments");
-    }
-    const resolved = resolve(destPath);
-    const dir = dirname(resolved);
-    if (!existsSync(dir)) {
-      try {
-        mkdirSync(dir, { recursive: true });
-      } catch (err) {
-        throw new BackupError(
-          `Failed to create backup directory '${dir}': ${err instanceof Error ? err.message : String(err)}`
-        );
-      }
-    }
-    if (existsSync(resolved)) {
-      throw new BackupError(`Backup destination '${destPath}' already exists`);
-    }
-    const escaped = resolved.replace(/'/g, "''");
-    try {
-      await conn.exec(`VACUUM INTO '${escaped}'`);
-    } catch (err) {
-      try {
-        rmSync(resolved, { force: true });
-      } catch {
-      }
-      throw new BackupError(`Backup to '${destPath}' failed: ${err instanceof Error ? err.message : String(err)}`);
-    }
-  }
-  generateFilename() {
-    const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-    return `${BACKUP_FILE_PREFIX}-${ts}.db`;
-  }
-  rotate(dir, maxFiles) {
-    if (maxFiles <= 0) return;
-    const resolved = resolve(dir);
-    if (!existsSync(resolved)) return;
-    let entries;
-    try {
-      entries = readdirSync(resolved).filter((f) => f.startsWith(`${BACKUP_FILE_PREFIX}-`) && f.endsWith(".db")).map((f) => {
-        const filePath = join(resolved, f);
-        return { path: filePath, mtimeMs: lstatSync(filePath).mtimeMs };
-      }).sort((a, b) => b.mtimeMs - a.mtimeMs);
-    } catch (err) {
-      throw new BackupError(
-        `Failed to list backup files in '${dir}': ${err instanceof Error ? err.message : String(err)}`
-      );
-    }
-    for (const entry of entries.slice(maxFiles)) {
-      try {
-        rmSync(entry.path, { force: true });
-      } catch {
-      }
-    }
-  }
-};
-var DEFAULT_MAX_FILES = 5;
-var BackupScheduler = class {
-  manager;
-  constructor(manager) {
-    this.manager = manager ?? new BackupManager();
-  }
-  schedule(conn, options) {
-    const { cron: cronExpr, destDir, maxFiles = DEFAULT_MAX_FILES, onError } = options;
-    const resolvedDir = resolve(destDir);
-    if (!existsSync(resolvedDir)) {
-      try {
-        mkdirSync(resolvedDir, { recursive: true });
-      } catch (err) {
-        throw new BackupError(
-          `Failed to create backup directory '${destDir}': ${err instanceof Error ? err.message : String(err)}`
-        );
-      }
-    }
-    let job;
-    try {
-      job = new Cron(
-        cronExpr,
-        {
-          unref: true,
-          catch: (err) => {
-            if (onError) {
-              const error = err instanceof Error ? err : new BackupError(typeof err === "string" ? err : "Scheduled backup failed");
-              onError(error);
-            }
-          }
-        },
-        async () => {
-          const filename = this.manager.generateFilename();
-          const destPath = join(resolvedDir, filename);
-          await this.manager.backup(conn, destPath);
-          this.manager.rotate(resolvedDir, maxFiles);
-        }
-      );
-    } catch (err) {
-      throw new BackupError(
-        `Invalid cron expression '${cronExpr}': ${err instanceof Error ? err.message : String(err)}`
-      );
-    }
-    return () => {
-      job.stop();
-    };
-  }
-};
-
-export { BackupManager, BackupScheduler };

package/dist/index-CLdNrcPz.d.ts

@@ -1,16 +0,0 @@
-import { a as SQLiteConnection } from './types-BFSsG77t.js';
-import { m as BackupScheduleOptions } from './types-D-74JiXb.js';
-
-declare class BackupManager {
-    backup(conn: SQLiteConnection, destPath: string): Promise<void>;
-    generateFilename(): string;
-    rotate(dir: string, maxFiles: number): void;
-}
-
-declare class BackupScheduler {
-    private readonly manager;
-    constructor(manager?: BackupManager);
-    schedule(conn: SQLiteConnection, options: BackupScheduleOptions): () => void;
-}
-
-export { BackupManager as B, BackupScheduler as a };

package/dist/types-BFSsG77t.d.ts

@@ -1,29 +0,0 @@
-interface RunResult {
-    changes: number;
-    lastInsertRowId: number | bigint;
-}
-interface SQLiteStatement {
-    all<T = unknown>(...params: unknown[]): Promise<T[]>;
-    get<T = unknown>(...params: unknown[]): Promise<T | undefined>;
-    run(...params: unknown[]): Promise<RunResult>;
-}
-interface SQLiteConnection {
-    exec(sql: string): Promise<void>;
-    prepare(sql: string): Promise<SQLiteStatement>;
-    transaction<T>(fn: (conn: SQLiteConnection) => Promise<T>): Promise<T>;
-    close(): Promise<void>;
-}
-interface OpenOptions {
-    readonly?: boolean;
-    walMode?: boolean;
-}
-interface DriverCapabilities {
-    multipleConnections: boolean;
-    extensions: boolean;
-}
-interface SQLiteDriver {
-    readonly capabilities: DriverCapabilities;
-    open(path: string, options?: OpenOptions): Promise<SQLiteConnection>;
-}
-
-export type { DriverCapabilities as D, OpenOptions as O, RunResult as R, SQLiteDriver as S, SQLiteConnection as a, SQLiteStatement as b };

package/dist/types-D-74JiXb.d.ts

@@ -1,265 +0,0 @@
-import { a as SQLiteConnection, S as SQLiteDriver } from './types-BFSsG77t.js';
-
-declare class Transaction {
-    private readonly conn;
-    private _lastInsertRowId;
-    constructor(conn: SQLiteConnection);
-    query<T = Record<string, unknown>>(sql: string, params?: Params): Promise<T[]>;
-    execute(sql: string, params?: Params): Promise<ExecuteResult>;
-    executeBatch(sql: string, paramsBatch: Params[]): Promise<ExecuteResult[]>;
-    get lastInsertRowId(): number | bigint;
-    static run<T>(conn: SQLiteConnection, fn: (tx: Transaction) => Promise<T>): Promise<T>;
-}
-
-/** Query parameter types: named (object) or positional (array). */
-type Params = Record<string, unknown> | unknown[];
-type WriteConcernLevel = 'local' | 'majority' | 'all';
-interface WriteConcern {
-    level: WriteConcernLevel;
-    timeoutMs?: number;
-}
-type ReadConcernLevel = 'local' | 'majority' | 'linearizable';
-interface ReadConcern {
-    level: ReadConcernLevel;
-}
-interface QueryOptions {
-    writeConcern?: WriteConcern;
-    readConcern?: ReadConcern;
-}
-interface ClusterReadEndpointInfo {
-    nodeId: string;
-    endpoint: string;
-    readConcerns: ReadConcernLevel[];
-}
-interface ClusterStatusInfo {
-    databaseId: string;
-    replicationGroupId?: string;
-    role?: 'primary' | 'replica';
-    currentPrimary?: {
-        nodeId: string;
-        endpoint?: string;
-    } | null;
-    primaryTerm?: bigint;
-    readEndpoints?: ClusterReadEndpointInfo[];
-    health: 'healthy' | 'degraded' | 'failing_over' | 'unavailable' | 'repairing' | 'syncing';
-}
-/** Result returned by mutation statements (INSERT, UPDATE, DELETE). */
-interface ExecuteResult {
-    changes: number;
-    lastInsertRowId: number | bigint;
-}
-/** CDC operation type. */
-type ChangeOperation = 'insert' | 'update' | 'delete';
-/** Event emitted when a watched table row changes. */
-interface ChangeEvent<T = Record<string, unknown>> {
-    type: ChangeOperation;
-    table: string;
-    row: T;
-    oldRow?: T;
-    seq: bigint;
-    timestamp: number;
-}
-/** Context passed to query hooks. */
-interface QueryHookContext {
-    databaseId: string;
-    sql: string;
-    params?: Params;
-    metadata?: Record<string, unknown>;
-    writeConcern?: WriteConcern;
-    readConcern?: ReadConcern;
-}
-/** Hook invoked before a query is executed. Throw to deny. */
-type BeforeQueryHook = (ctx: QueryHookContext) => void | Promise<void>;
-/** Hook invoked after a query is executed. */
-type AfterQueryHook = (ctx: QueryHookContext & {
-    durationMs: number;
-}) => void | Promise<void>;
-/** Context passed to connection hooks. */
-interface ConnectionHookContext {
-    databaseId: string;
-    path: string;
-}
-/** Hook invoked before a database connection is established. */
-type BeforeConnectHook = (ctx: ConnectionHookContext) => void | Promise<void>;
-/** Hook invoked when a database is opened. */
-type DatabaseOpenHook = (ctx: ConnectionHookContext) => void | Promise<void>;
-/** Hook invoked when a database is closed. */
-type DatabaseCloseHook = (ctx: ConnectionHookContext) => void | Promise<void>;
-/** Hook invoked before a subscription is created. Throw to deny. */
-type BeforeSubscribeHook = (ctx: {
-    databaseId: string;
-    table: string;
-    filter?: Record<string, unknown>;
-}) => void | Promise<void>;
-/** Aggregated hook configuration. */
-interface HookConfig {
-    onBeforeQuery?: BeforeQueryHook | BeforeQueryHook[];
-    onAfterQuery?: AfterQueryHook | AfterQueryHook[];
-    onBeforeConnect?: BeforeConnectHook | BeforeConnectHook[];
-    onDatabaseOpen?: DatabaseOpenHook | DatabaseOpenHook[];
-    onDatabaseClose?: DatabaseCloseHook | DatabaseCloseHook[];
-    onBeforeSubscribe?: BeforeSubscribeHook | BeforeSubscribeHook[];
-}
-/** Metrics emitted after a query completes. */
-interface QueryMetrics {
-    databaseId: string;
-    sql: string;
-    durationMs: number;
-    rowsReturned?: number;
-    changes?: number;
-    error?: boolean;
-}
-/** Metrics emitted when a connection opens or closes. */
-interface ConnectionMetrics {
-    databaseId: string;
-    path: string;
-    readerCount: number;
-    event: 'open' | 'close';
-}
-/** Metrics emitted when a CDC event is dispatched. */
-interface CDCMetrics {
-    databaseId: string;
-    table: string;
-    operation: ChangeOperation;
-    subscriberCount: number;
-}
-/** Callbacks for metrics collection. */
-interface MetricsConfig {
-    onQueryComplete?: (metrics: QueryMetrics) => void;
-    onConnectionOpen?: (metrics: ConnectionMetrics) => void;
-    onConnectionClose?: (metrics: ConnectionMetrics) => void;
-    onCDCEvent?: (metrics: CDCMetrics) => void;
-}
-/** Configuration for automatic database lifecycle management. */
-interface LifecycleConfig {
-    autoOpen?: {
-        resolver: (id: string) => {
-            path: string;
-            options?: DatabaseOptions;
-        } | undefined;
-    };
-    /** Milliseconds before an idle database is closed. 0 = disabled. */
-    idleTimeout?: number;
-    /** Maximum number of concurrently open databases. 0 = unlimited. */
-    maxOpen?: number;
-}
-/** Options for opening a single database. */
-interface DatabaseOptions {
-    /** Open the database in read-only mode. */
-    readOnly?: boolean;
-    /** Number of read connections in the pool. Default: 4. */
-    readPoolSize?: number;
-    /** Enable WAL mode. Default: true. */
-    walMode?: boolean;
-    /** CDC polling interval in milliseconds. Default: 50. */
-    cdcPollInterval?: number;
-    /** CDC retention period in milliseconds. Default: 3_600_000 (1 hour). */
-    cdcRetention?: number;
-}
-/** Top-level options for the Sirannon database registry. */
-interface SirannonOptions {
-    driver: SQLiteDriver;
-    hooks?: HookConfig;
-    metrics?: MetricsConfig;
-    lifecycle?: LifecycleConfig;
-}
-/** Options for scheduled backups. */
-interface BackupScheduleOptions {
-    /** Cron expression (e.g., '0 * * * *' for hourly). */
-    cron: string;
-    /** Directory to store backup files. */
-    destDir: string;
-    /** Maximum number of backup files to keep. Default: 5. */
-    maxFiles?: number;
-    /** Called when a scheduled backup fails. Without this, errors are silently discarded. */
-    onError?: (error: Error) => void;
-}
-/** Builder for creating CDC subscriptions with optional filters. */
-interface SubscriptionBuilder {
-    filter(conditions: Record<string, unknown>): SubscriptionBuilder;
-    subscribe(callback: (event: ChangeEvent) => void): Subscription;
-}
-/** Handle for an active subscription. */
-interface Subscription {
-    unsubscribe(): void;
-}
-/** Context passed to the onRequest middleware hook. */
-interface RequestContext {
-    headers: Record<string, string>;
-    method: string;
-    path: string;
-    databaseId?: string;
-    remoteAddress: string;
-}
-/** Return this from an onRequest hook to deny the request with a custom response. */
-interface RequestDenial {
-    status: number;
-    code: string;
-    message: string;
-}
-/** Middleware hook for auth, rate limiting, and request validation. */
-type OnRequestHook = (ctx: RequestContext) => undefined | RequestDenial | Promise<undefined | RequestDenial>;
-interface ServerExecutionTarget {
-    query<T = Record<string, unknown>>(sql: string, params?: Params, options?: QueryOptions): Promise<T[]>;
-    execute(sql: string, params?: Params, options?: QueryOptions): Promise<ExecuteResult>;
-    transaction<T>(fn: (tx: Transaction) => Promise<T>, options?: QueryOptions): Promise<T>;
-}
-type ServerExecutionTargetResolver = (databaseId: string) => ServerExecutionTarget | null | undefined | Promise<ServerExecutionTarget | null | undefined>;
-/** Options for the standalone HTTP + WS server. */
-interface ServerOptions {
-    host?: string;
-    port?: number;
-    cors?: boolean | CorsOptions;
-    onRequest?: OnRequestHook;
-    resolveExecutionTarget?: ServerExecutionTargetResolver;
-    getReplicationStatus?: () => ReplicationStatusInfo | null;
-    getClusterStatus?: (databaseId: string) => ClusterStatusInfo | null;
-}
-interface ReplicationStatusInfo {
-    role: string;
-    writeForwarding: boolean;
-    peers: number;
-    localSeq: bigint;
-    replicationGroupId?: string;
-    primaryTerm?: bigint;
-    currentPrimary?: string;
-    coordinator?: {
-        connected: boolean;
-        authority: boolean;
-    };
-    controller?: {
-        state: 'disabled' | 'standby' | 'active' | 'lost';
-    };
-    inSyncReplicas?: string[];
-    laggingReplicas?: string[];
-    syncState?: string;
-    readAvailability?: 'available' | 'unavailable';
-    writeAvailability?: 'available' | 'unavailable';
-}
-/** CORS configuration. */
-interface CorsOptions {
-    origin?: string | string[];
-    methods?: string[];
-    headers?: string[];
-}
-/** Options for the mountable WebSocket handler. */
-interface WSHandlerOptions {
-    /** Maximum message size in bytes. Default: 1_048_576 (1 MB). */
-    maxPayloadLength?: number;
-    resolveExecutionTarget?: ServerExecutionTargetResolver;
-}
-/** Options for the client SDK. */
-interface ClientOptions {
-    /** Transport to use. Default: 'websocket'. */
-    transport?: 'websocket' | 'http';
-    /** Custom headers for HTTP requests. */
-    headers?: Record<string, string>;
-    /** WebSocket subprotocols sent during the browser-compatible handshake. */
-    webSocketProtocols?: string | string[];
-    /** Reconnect on WebSocket disconnect. Default: true. */
-    autoReconnect?: boolean;
-    /** Reconnect interval in ms. Default: 1000. */
-    reconnectInterval?: number;
-}
-
-export { type AfterQueryHook as A, type BeforeQueryHook as B, type ChangeEvent as C, type DatabaseOptions as D, type ExecuteResult as E, type HookConfig as H, type LifecycleConfig as L, type MetricsConfig as M, type OnRequestHook as O, type Params as P, type QueryHookContext as Q, type ReadConcern as R, type SirannonOptions as S, Transaction as T, type WriteConcern as W, type BeforeConnectHook as a, type DatabaseOpenHook as b, type DatabaseCloseHook as c, type ServerOptions as d, type WSHandlerOptions as e, type ConnectionHookContext as f, type BeforeSubscribeHook as g, type QueryMetrics as h, type ConnectionMetrics as i, type CDCMetrics as j, type QueryOptions as k, type SubscriptionBuilder as l, type BackupScheduleOptions as m, type ChangeOperation as n, type ClientOptions as o, type ClusterReadEndpointInfo as p, type ClusterStatusInfo as q, type CorsOptions as r, type ReadConcernLevel as s, type ReplicationStatusInfo as t, type RequestContext as u, type RequestDenial as v, type ServerExecutionTarget as w, type ServerExecutionTargetResolver as x, type Subscription as y, type WriteConcernLevel as z };