@delali/sirannon-db 0.1.5 → 0.1.7

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 };