@delali/sirannon-db 0.1.4 → 0.1.5

package/dist/errors-C00ed08Q.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Base class for all sirannon-db errors. Extend this class to create
+ * domain-specific errors that carry a machine-readable {@link code}.
+ */
+declare class SirannonError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/**
+ * Thrown when a database ID cannot be resolved in the registry.
+ * This typically means the database was never opened or has already been closed.
+ */
+declare class DatabaseNotFoundError extends SirannonError {
+    constructor(id: string);
+}
+/**
+ * Thrown when attempting to register a database with an ID that is already
+ * in use. Each database ID must be unique within the registry.
+ */
+declare class DatabaseAlreadyExistsError extends SirannonError {
+    constructor(id: string);
+}
+/**
+ * Thrown when a write operation is attempted on a database that was opened
+ * in read-only mode.
+ */
+declare class ReadOnlyError extends SirannonError {
+    constructor(id: string);
+}
+/**
+ * Thrown when SQLite fails to execute a statement. The {@link sql} property
+ * holds the original SQL string that caused the failure, which is useful for
+ * debugging and logging.
+ */
+declare class QueryError extends SirannonError {
+    readonly sql: string;
+    constructor(message: string, sql: string);
+}
+/**
+ * Thrown when a transaction cannot be committed or is forcibly rolled back.
+ * Check the message for the underlying cause.
+ */
+declare class TransactionError extends SirannonError {
+    constructor(message: string);
+}
+/**
+ * Thrown when a migration step fails. The {@link version} property identifies
+ * which schema version triggered the error so the failure can be pinpointed
+ * in the migration history.
+ */
+declare class MigrationError extends SirannonError {
+    readonly version: number;
+    constructor(message: string, version: number, code?: string);
+}
+/**
+ * Thrown when a before-hook explicitly rejects an operation. The optional
+ * `reason` string is surfaced in the message so callers can distinguish
+ * between different hook policies.
+ */
+declare class HookDeniedError extends SirannonError {
+    constructor(hookName: string, reason?: string);
+}
+/**
+ * Thrown when the change-data-capture pipeline encounters an unrecoverable
+ * error, such as a failed event dispatch or a corrupt change record.
+ */
+declare class CDCError extends SirannonError {
+    constructor(message: string);
+}
+/**
+ * Thrown when a backup operation fails, whether that is an online backup via
+ * the SQLite backup API or a file-level copy.
+ */
+declare class BackupError extends SirannonError {
+    constructor(message: string);
+}
+/**
+ * Thrown when the connection pool reaches its limit or is configured with
+ * invalid parameters such as a minimum size greater than the maximum.
+ */
+declare class ConnectionPoolError extends SirannonError {
+    constructor(message: string);
+}
+/**
+ * Thrown when opening a new database would exceed the configured cap on
+ * concurrently open databases. Close an existing database before opening
+ * another one.
+ */
+declare class MaxDatabasesError extends SirannonError {
+    constructor(max: number);
+}
+/**
+ * Thrown when a native SQLite extension cannot be loaded. The `path` argument
+ * is the filesystem path passed to `load_extension`, and the optional `cause`
+ * string carries the error detail reported by SQLite.
+ */
+declare class ExtensionError extends SirannonError {
+    constructor(path: string, cause?: string);
+}
+
+export { BackupError as B, CDCError as C, DatabaseAlreadyExistsError as D, ExtensionError as E, HookDeniedError as H, MaxDatabasesError as M, QueryError as Q, ReadOnlyError as R, SirannonError as S, TransactionError as T, ConnectionPoolError as a, DatabaseNotFoundError as b, MigrationError as c };

package/dist/file-migrations/index.d.ts

@@ -1,6 +1,6 @@
-import { M as Migration } from '../types-DRkJlqex.js';
+import { M as Migration } from '../types-BeozgNPr.js';
+import '../types-D-74JiXb.js';
 import '../types-BFSsG77t.js';
-import '../types-DtDutWRU.js';
 
 interface ScannedMigration {
     version: number;

package/dist/{index-hXiis3N-.d.ts → index-CLdNrcPz.d.ts}

@@ -1,5 +1,5 @@
 import { a as SQLiteConnection } from './types-BFSsG77t.js';
-import { e as BackupScheduleOptions } from './types-DtDutWRU.js';
+import { m as BackupScheduleOptions } from './types-D-74JiXb.js';
 
 declare class BackupManager {
     backup(conn: SQLiteConnection, destPath: string): Promise<void>;

package/dist/replication/coordinator/etcd.d.ts

@@ -0,0 +1,44 @@
+import { IOptions } from 'etcd3';
+import { C as ClusterCoordinator, A as AcquireControllerLeaseInput, a as AcquireControllerLeaseResult, R as RegisterNodeSessionInput, b as CoordinatorNodeSession, S as SetReplicationGroupStateInput, c as ReplicationGroupState, d as ReplicationGroupWatcher, e as CoordinatorWatchDisposer, f as CompareAndAdvancePrimaryTermInput, g as CompareAndAdvancePrimaryTermResult, U as UpdateInSyncSetInput, h as AdmitNodeToInSyncSetInput, i as UpdateNodeMaintenanceInput, P as PromoteEligibleReplicaInput } from '../../types-BEu1I_9_.js';
+
+interface EtcdClusterCoordinatorOptions {
+    hosts: string | string[];
+    keyPrefix: string;
+    credentials?: IOptions['credentials'];
+    auth?: IOptions['auth'];
+    grpcOptions?: IOptions['grpcOptions'];
+    dialTimeoutMs?: number;
+    defaultCallTimeoutMs?: number;
+    allowInsecure?: boolean;
+    onWatcherError?: (error: Error) => void;
+}
+declare class EtcdClusterCoordinator implements ClusterCoordinator {
+    private readonly client;
+    private readonly namespace;
+    private readonly onWatcherError;
+    private readonly leases;
+    private readonly watchers;
+    constructor(options: EtcdClusterCoordinatorOptions);
+    tryAcquireControllerLease(input: AcquireControllerLeaseInput): Promise<AcquireControllerLeaseResult>;
+    renewLease(leaseId: string, ttlMs: number): Promise<boolean>;
+    releaseLease(leaseId: string): Promise<boolean>;
+    registerNodeSession(input: RegisterNodeSessionInput): Promise<CoordinatorNodeSession>;
+    getLiveNodeSession(clusterId: string, nodeId: string): Promise<CoordinatorNodeSession | null>;
+    deregisterNodeSession(clusterId: string, nodeId: string): Promise<void>;
+    setReplicationGroupState(input: SetReplicationGroupStateInput): Promise<ReplicationGroupState>;
+    getReplicationGroupState(clusterId: string, groupId: string): Promise<ReplicationGroupState | null>;
+    watchReplicationGroup(clusterId: string, groupId: string, watcher: ReplicationGroupWatcher): Promise<CoordinatorWatchDisposer>;
+    compareAndAdvancePrimaryTerm(input: CompareAndAdvancePrimaryTermInput): Promise<CompareAndAdvancePrimaryTermResult>;
+    updateInSyncSet(input: UpdateInSyncSetInput): Promise<ReplicationGroupState | null>;
+    admitNodeToInSyncSet(input: AdmitNodeToInSyncSetInput): Promise<ReplicationGroupState | null>;
+    updateNodeMaintenance(input: UpdateNodeMaintenanceInput): Promise<ReplicationGroupState | null>;
+    promoteEligibleReplica(input: PromoteEligibleReplicaInput): Promise<ReplicationGroupState>;
+    close(): Promise<void>;
+    private getLeaseFromKey;
+    private trackLease;
+    private updateGroupStateWithRetry;
+    private casGroupState;
+}
+declare function createEtcdCoordinator(options: EtcdClusterCoordinatorOptions): EtcdClusterCoordinator;
+
+export { EtcdClusterCoordinator, type EtcdClusterCoordinatorOptions, createEtcdCoordinator };