@delali/sirannon-db 0.2.3-next.38 → 0.3.0

package/dist/core/index.d.ts

@@ -1,15 +1,15 @@
-export { B as BackupCapabilities, a as BackupChainLocation, b as BackupRestorePlan, c as BackupSafeToDeleteOptions, d as backupPiecesSafeToDelete, p as planBackupRestore } from '../database-backup-CliAhaEm.js';
-import { G as SQLiteConnection, L as SynchronousLevel, S as SQLiteDriver, D as DatabaseOptions, O as LifecycleConfig, M as Migration, P as MigrationResult, R as RollbackResult } from '../types-CopTgHG3.js';
-export { A as AfterQueryHook, Q as AppliedMigration, U as AppliedMigrationEntry, g as BackupChain, h as BackupChainBase, i as BackupChainChange, j as BackupChainPosition, k as BackupChainRecord, m as BackupCycleError, n as BackupCycleOptions, o as BackupCycleStatus, B as BackupDestination, p as BackupGroupMembership, q as BackupGroupSource, r as BackupNodePreference, s as BackupPiece, t as BackupProgress, f as BackupRunReport, I as BackupScheduleOptions, u as BackupSkip, v as BackupSkipReason, w as BackupToDestinationOptions, x as BackupVerifyResult, V as BatchSummary, c as BeforeConnectHook, b as BeforeQueryHook, W as BeforeSubscribeHook, X as CDCMetrics, Y as ClusterReadEndpointInfo, F as ClusterStatusInfo, Z as ConnectionHookContext, _ as ConnectionMetrics, y as DEFAULT_CHAIN_NAME, e as DatabaseCloseHook, $ as DatabaseCopyRequest, a0 as DatabaseCopyStep, d as DatabaseOpenHook, J as DriverCapabilities, a1 as DriverWorkerEntry, a2 as HookConfig, a3 as MIGRATION_NAME_RE, a4 as MetricsConfig, a5 as MigrationBaseline, a6 as MigrationSource, N as NodeHealth, a7 as NodeHealthReason, a8 as NodeHealthState, a9 as OpenOptions, aa as QueryHookContext, ab as QueryMetrics, ac as RunResult, ad as SQLiteStatement, a as SirannonOptions, T as Transaction, ae as WriterWorkerOptions, C as readBackupChains } from '../types-CopTgHG3.js';
-import { B as BulkLoadDurability, a as BulkLoadResult } from '../server-options-CFgBQDLz.js';
-export { A as AuthenticateHook, b as BulkLoadOptions, C as ClientOptions, c as ClusterStatusAuthorizer, d as CorsOptions, R as ReplicationStatusInfo, e as RequestContext, f as ServerExecutionTarget, g as ServerExecutionTargetResolver, S as ServerOptions, W as WSHandlerOptions } from '../server-options-CFgBQDLz.js';
-export { C as ChangeTracker, a as ChangeTrackerOptions } from '../change-tracker-BLKRX8ic.js';
-import { D as Database } from '../database-DSbJl-k5.js';
-export { C as ConnectionPool, a as ConnectionPoolOptions, b as DatabaseBackups, c as DatabaseLifecycle, H as HookDispose, d as HookEvent, e as HookEventContextMap, f as HookHandler, g as HookRegistry, M as MetricsCollector, S as SubscribeHookContext, h as execute, i as executeBatch, q as query, j as queryOne } from '../database-DSbJl-k5.js';
+export { B as BackupCapabilities, a as BackupChainLocation, b as BackupRestorePlan, c as BackupSafeToDeleteOptions, d as backupPiecesSafeToDelete, p as planBackupRestore } from '../database-backup-C090lMHc.js';
+import { I as SQLiteConnection, U as SynchronousLevel, S as SQLiteDriver, D as DatabaseOptions, V as LifecycleConfig, M as Migration, W as MigrationResult, X as RollbackResult } from '../types-DApb7dvw.js';
+export { A as AfterQueryHook, Y as AppliedMigration, Z as AppliedMigrationEntry, g as BackupChain, h as BackupChainBase, i as BackupChainChange, j as BackupChainPosition, k as BackupChainRecord, m as BackupCycleError, n as BackupCycleOptions, o as BackupCycleStatus, B as BackupDestination, p as BackupFileReport, q as BackupGroupMembership, r as BackupGroupSource, s as BackupLogPosition, t as BackupNodePreference, u as BackupPiece, v as BackupProgress, f as BackupRunReport, O as BackupScheduleOptions, w as BackupSkip, x as BackupSkipReason, y as BackupToDestinationOptions, z as BackupVerifyResult, _ as BatchSummary, c as BeforeConnectHook, b as BeforeQueryHook, $ as BeforeSubscribeHook, a0 as CDCMetrics, a1 as ClusterReadEndpointInfo, H as ClusterStatusInfo, a2 as ConnectionHookContext, a3 as ConnectionMetrics, C as DEFAULT_CHAIN_NAME, e as DatabaseCloseHook, a4 as DatabaseCopyRequest, a5 as DatabaseCopyStep, d as DatabaseOpenHook, P as DriverCapabilities, a6 as DriverWorkerEntry, a7 as HookConfig, a8 as MIGRATION_NAME_RE, a9 as MetricsConfig, aa as MigrationBaseline, ab as MigrationSource, N as NodeHealth, ac as NodeHealthReason, ad as NodeHealthState, ae as OpenOptions, af as QueryHookContext, ag as QueryMetrics, ah as RunResult, ai as SQLiteStatement, a as SirannonOptions, T as Transaction, aj as WriterWorkerOptions, F as readBackupChains } from '../types-DApb7dvw.js';
+import { B as BulkLoadDurability, a as BulkLoadResult } from '../server-options-DeK6ZG8u.js';
+export { A as AuthenticateHook, b as BulkLoadOptions, C as ClientOptions, c as ClusterStatusAuthorizer, d as CorsOptions, R as ReplicationStatusInfo, e as RequestContext, f as ServerExecutionTarget, g as ServerExecutionTargetResolver, S as ServerOptions, W as WSHandlerOptions } from '../server-options-DeK6ZG8u.js';
+export { C as ChangeTracker, a as ChangeTrackerOptions } from '../change-tracker-uG9gWvsY.js';
+import { D as Database } from '../database-BlhUdJAO.js';
+export { C as ConnectionPool, a as ConnectionPoolOptions, b as DatabaseBackups, c as DatabaseLifecycle, H as HookDispose, d as HookEvent, e as HookEventContextMap, f as HookHandler, g as HookRegistry, M as MetricsCollector, S as SubscribeHookContext, h as execute, i as executeBatch, q as query, j as queryOne } from '../database-BlhUdJAO.js';
 export { B as BackupError, C as CDCError, a as ConnectionPoolError, D as DatabaseAlreadyExistsError, b as DatabaseNotFoundError, E as ExtensionError, F as ForbiddenSqlError, H as HookDeniedError, M as MaxDatabasesError, c as MigrationError, Q as QueryError, R as ReadOnlyError, d as RequestDeniedError, S as SirannonError, T as TransactionError, W as WriteOverloadError } from '../errors-Dei4GdBb.js';
 export { a as LiveQuery, L as LiveQueryOptions, b as LiveQueryState, c as LiveUpdate, R as ResultOp } from '../types-BCejqzNA.js';
 import { B as BaselineFileOption } from '../baseline-D93hcIEE.js';
-export { S as Sirannon } from '../sirannon-Bo0PX2Cj.js';
+export { S as Sirannon } from '../sirannon-C9cTgFrw.js';
 export { C as ChangeEvent, b as ChangeOperation, E as ExecuteResult, P as Params, Q as QueryOptions, R as ReadConcern, a as ReadConcernLevel, S as Subscription, c as SubscriptionBuilder, W as WriteConcern, d as WriteConcernLevel } from '../query-types-Cv8N7pXj.js';
 export { D as DatabaseOperations, b as OperationArguments, O as OperationRef, a as OperationRegistry, c as OperationStatement, R as ReadOperation, W as WriteOperation, o as operationName, d as operationRef } from '../operation-registry-C1FmwQWR.js';
 import '../types-CjhxcjhA.js';

package/dist/core/index.mjs

@@ -231,12 +231,13 @@ var DatabaseBackupController = class {
       this.engine?.streamsToDestination() ?? false
     );
   }
-  backup(destPath) {
+  async backup(destPath) {
     const engine = this.require();
-    return startCopyWithoutHoldingWriter(
+    const copy = await startCopyWithoutHoldingWriter(
       this.runExclusive,
       (onFirstStep) => engine.backup(this.acquireWriter(), destPath, onFirstStep)
     );
+    return { ...copy, databaseId: this.databaseId, sourcePath: this.sourcePath };
   }
   backupTo(options) {
     const engine = this.require();
@@ -252,7 +253,14 @@ var DatabaseBackupController = class {
   }
   schedule(options) {
     const engine = this.require();
-    this.cancellers.push(engine.schedule(this.acquireWriter(), options, this.runExclusive));
+    this.cancellers.push(
+      engine.schedule(this.acquireWriter(), {
+        ...options,
+        databaseId: this.databaseId,
+        sourcePath: this.sourcePath,
+        runExclusive: this.runExclusive
+      })
+    );
   }
   /**
    * Builds the cycle and starts it in the background. Its first turn copies the
@@ -2163,10 +2171,11 @@ var DatabaseBackups = class extends DatabaseLifecycle {
    * runs in the gap between two steps rather than waiting for the whole copy.
    *
    * @param destPath - Path the copy is written to.
+   * @returns The run identifier, the timings, the pages it moved, and the bytes the file holds.
    */
   async backup(destPath) {
     this.ensureOpen();
-    await this.runtime.backups.backup(destPath);
+    return this.runtime.backups.backup(destPath);
   }
   /**
    * Copies this database to a destination you supply, in fixed-size pieces,
@@ -2200,7 +2209,7 @@ var DatabaseBackups = class extends DatabaseLifecycle {
   /**
    * Starts repeating backups on a cron schedule, keeping a bounded number of files.
    *
-   * @param options - Cron expression, destination directory, retention, time zone, and failure callback.
+   * @param options - Cron expression, destination directory, retention, and time zone, along with the callbacks Sirannon calls after each finished copy and after each failure.
    */
   scheduleBackup(options) {
     this.ensureOpen();

package/dist/{database-DSbJl-k5.d.ts → database-BlhUdJAO.d.ts}

@@ -1,9 +1,9 @@
-import { D as DatabaseBackupController, B as BackupCapabilities, a as BackupChainLocation, b as BackupRestorePlan, c as BackupSafeToDeleteOptions } from './database-backup-CliAhaEm.js';
-import { S as SQLiteDriver, L as SynchronousLevel, af as WorkerHostOptions, G as SQLiteConnection, T as Transaction, ag as WriterContext, M as Migration, P as MigrationResult, R as RollbackResult, aa as QueryHookContext, Z as ConnectionHookContext, W as BeforeSubscribeHook, a2 as HookConfig, a4 as MetricsConfig, ab as QueryMetrics, _ as ConnectionMetrics, X as CDCMetrics, D as DatabaseOptions, w as BackupToDestinationOptions, f as BackupRunReport, I as BackupScheduleOptions, g as BackupChain, o as BackupCycleStatus, x as BackupVerifyResult, k as BackupChainRecord, b as BeforeQueryHook, A as AfterQueryHook } from './types-CopTgHG3.js';
-import { C as ChangeTracker } from './change-tracker-BLKRX8ic.js';
+import { D as DatabaseBackupController, B as BackupCapabilities, a as BackupChainLocation, b as BackupRestorePlan, c as BackupSafeToDeleteOptions } from './database-backup-C090lMHc.js';
+import { S as SQLiteDriver, U as SynchronousLevel, ak as WorkerHostOptions, I as SQLiteConnection, T as Transaction, al as WriterContext, M as Migration, W as MigrationResult, X as RollbackResult, af as QueryHookContext, a2 as ConnectionHookContext, $ as BeforeSubscribeHook, a7 as HookConfig, a9 as MetricsConfig, ag as QueryMetrics, a3 as ConnectionMetrics, a0 as CDCMetrics, D as DatabaseOptions, p as BackupFileReport, y as BackupToDestinationOptions, f as BackupRunReport, O as BackupScheduleOptions, g as BackupChain, o as BackupCycleStatus, z as BackupVerifyResult, k as BackupChainRecord, b as BeforeQueryHook, A as AfterQueryHook } from './types-DApb7dvw.js';
+import { C as ChangeTracker } from './change-tracker-uG9gWvsY.js';
 import { C as ChangeEvent, S as Subscription, c as SubscriptionBuilder, P as Params, Q as QueryOptions, E as ExecuteResult } from './query-types-Cv8N7pXj.js';
 import { H as HLCTimestamp, c as ReplicationChange, C as ConflictResolver, A as ApplyResult, R as ReplicationBatch } from './types-CjhxcjhA.js';
-import { h as AppliedMigrationRow, b as BulkLoadOptions, a as BulkLoadResult } from './server-options-CFgBQDLz.js';
+import { h as AppliedMigrationRow, b as BulkLoadOptions, a as BulkLoadResult } from './server-options-DeK6ZG8u.js';
 import { L as LiveQueryOptions, a as LiveQuery } from './types-BCejqzNA.js';
 
 /**
@@ -612,8 +612,9 @@ declare class DatabaseBackups extends DatabaseLifecycle {
      * runs in the gap between two steps rather than waiting for the whole copy.
      *
      * @param destPath - Path the copy is written to.
+     * @returns The run identifier, the timings, the pages it moved, and the bytes the file holds.
      */
-    backup(destPath: string): Promise<void>;
+    backup(destPath: string): Promise<BackupFileReport>;
     /**
      * Copies this database to a destination you supply, in fixed-size pieces,
      * while it stays open for reads and writes.
@@ -641,7 +642,7 @@ declare class DatabaseBackups extends DatabaseLifecycle {
     /**
      * Starts repeating backups on a cron schedule, keeping a bounded number of files.
      *
-     * @param options - Cron expression, destination directory, retention, time zone, and failure callback.
+     * @param options - Cron expression, destination directory, retention, and time zone, along with the callbacks Sirannon calls after each finished copy and after each failure.
      */
     scheduleBackup(options: BackupScheduleOptions): void;
     /**

package/dist/{database-backup-CliAhaEm.d.ts → database-backup-C090lMHc.d.ts}

@@ -1,4 +1,4 @@
-import { h as BackupChainBase, i as BackupChainChange, g as BackupChain, k as BackupChainRecord, B as BackupDestination, G as SQLiteConnection, J as DriverCapabilities, K as BackupEngine, w as BackupToDestinationOptions, f as BackupRunReport, I as BackupScheduleOptions, n as BackupCycleOptions, o as BackupCycleStatus, x as BackupVerifyResult } from './types-CopTgHG3.js';
+import { h as BackupChainBase, i as BackupChainChange, g as BackupChain, k as BackupChainRecord, B as BackupDestination, I as SQLiteConnection, P as DriverCapabilities, Q as BackupEngine, p as BackupFileReport, y as BackupToDestinationOptions, f as BackupRunReport, O as BackupScheduleOptions, n as BackupCycleOptions, o as BackupCycleStatus, z as BackupVerifyResult } from './types-DApb7dvw.js';
 
 /**
  * What one runtime supports of the backup operations, so a caller learns
@@ -117,7 +117,7 @@ declare class DatabaseBackupController {
     private require;
     private requireCycle;
     capabilities(): BackupCapabilities;
-    backup(destPath: string): Promise<void>;
+    backup(destPath: string): Promise<BackupFileReport>;
     backupTo(options: BackupToDestinationOptions): Promise<BackupRunReport>;
     schedule(options: BackupScheduleOptions): void;
     /**

package/dist/driver/better-sqlite3.d.ts

@@ -1,4 +1,4 @@
-import { S as SQLiteDriver } from '../types-CopTgHG3.js';
+import { S as SQLiteDriver } from '../types-DApb7dvw.js';
 import '../query-types-Cv8N7pXj.js';
 
 /**

package/dist/driver/better-sqlite3.mjs

@@ -1,12 +1,13 @@
-import { nodeResolveExtensionPath, nodeWriterContext, nodeBackupEngine, nodeStreamingSupport, WriterWorker, createStatementCache, loadThroughRuntime, narrowSafeBigInt, narrowRowIntegers, narrowRowsIntegers } from '../chunk-G7AXGAEA.mjs';
-import '../chunk-CR6HTXSC.mjs';
-import '../chunk-IPDHHIG2.mjs';
+import { nodeResolveExtensionPath, nodeWriterContext, nodeBackupEngine, nodeStreamingSupport, WriterWorker, createStatementCache, loadThroughRuntime, narrowSafeBigInt, narrowRowIntegers, narrowRowsIntegers } from '../chunk-OJQHM4MT.mjs';
+import '../chunk-7SC2TZAS.mjs';
+import '../chunk-DXXCLTFF.mjs';
 import { defineDriver } from '../chunk-LXCGPZPA.mjs';
 import '../chunk-W67A4H2E.mjs';
 import '../chunk-YLAVDZCS.mjs';
-import '../chunk-GJ6SX53Z.mjs';
-import '../chunk-KSYFFYAP.mjs';
-import '../chunk-GBM4AU24.mjs';
+import '../chunk-W77EEVOT.mjs';
+import '../chunk-U445A3C4.mjs';
+import '../chunk-2QCPVE67.mjs';
+import '../chunk-DVS4QSIZ.mjs';
 import { synchronousPragmaValue } from '../chunk-OUSWVNWT.mjs';
 import '../chunk-YVF2ZJTE.mjs';
 import '../chunk-V5FUJEYY.mjs';

package/dist/driver/bun.d.ts

@@ -1,4 +1,4 @@
-import { S as SQLiteDriver } from '../types-CopTgHG3.js';
+import { S as SQLiteDriver } from '../types-DApb7dvw.js';
 import '../query-types-Cv8N7pXj.js';
 
 /**

package/dist/driver/expo.d.ts

@@ -1,4 +1,4 @@
-import { S as SQLiteDriver } from '../types-CopTgHG3.js';
+import { S as SQLiteDriver } from '../types-DApb7dvw.js';
 import '../query-types-Cv8N7pXj.js';
 
 /**

package/dist/driver/node.d.ts

@@ -1,4 +1,4 @@
-import { S as SQLiteDriver } from '../types-CopTgHG3.js';
+import { S as SQLiteDriver } from '../types-DApb7dvw.js';
 import '../query-types-Cv8N7pXj.js';
 
 /**

package/dist/driver/node.mjs

@@ -1,12 +1,13 @@
-import { nodeResolveExtensionPath, nodeWriterContext, createStatementCache, nodeBackupEngine, nodeStreamingSupport, WriterWorker, loadThroughRuntime, narrowSafeBigInt, narrowRowIntegers, narrowRowsIntegers } from '../chunk-G7AXGAEA.mjs';
-import '../chunk-CR6HTXSC.mjs';
-import '../chunk-IPDHHIG2.mjs';
+import { nodeResolveExtensionPath, nodeWriterContext, createStatementCache, nodeBackupEngine, nodeStreamingSupport, WriterWorker, loadThroughRuntime, narrowSafeBigInt, narrowRowIntegers, narrowRowsIntegers } from '../chunk-OJQHM4MT.mjs';
+import '../chunk-7SC2TZAS.mjs';
+import '../chunk-DXXCLTFF.mjs';
 import { defineDriver } from '../chunk-LXCGPZPA.mjs';
 import '../chunk-W67A4H2E.mjs';
 import '../chunk-YLAVDZCS.mjs';
-import '../chunk-GJ6SX53Z.mjs';
-import '../chunk-KSYFFYAP.mjs';
-import '../chunk-GBM4AU24.mjs';
+import '../chunk-W77EEVOT.mjs';
+import '../chunk-U445A3C4.mjs';
+import '../chunk-2QCPVE67.mjs';
+import '../chunk-DVS4QSIZ.mjs';
 import { synchronousPragmaValue } from '../chunk-OUSWVNWT.mjs';
 import '../chunk-YVF2ZJTE.mjs';
 import '../chunk-V5FUJEYY.mjs';

package/dist/driver/wa-sqlite.d.ts

@@ -1,4 +1,4 @@
-import { S as SQLiteDriver } from '../types-CopTgHG3.js';
+import { S as SQLiteDriver } from '../types-DApb7dvw.js';
 import '../query-types-Cv8N7pXj.js';
 
 /**

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

@@ -1,5 +1,5 @@
 import { B as BaselineFileOption } from '../baseline-D93hcIEE.js';
-import { M as Migration } from '../types-CopTgHG3.js';
+import { M as Migration } from '../types-DApb7dvw.js';
 import '../query-types-Cv8N7pXj.js';
 
 /**

package/dist/{protocol-BK0Yxu5P.d.ts → protocol-QekTGoKn.d.ts}

@@ -1,5 +1,5 @@
 import { W as WriteConcern, R as ReadConcern, E as ExecuteResult } from './query-types-Cv8N7pXj.js';
-import { B as BulkLoadDurability, a as BulkLoadResult } from './server-options-CFgBQDLz.js';
+import { B as BulkLoadDurability, a as BulkLoadResult } from './server-options-DeK6ZG8u.js';
 
 /**
  * Body of `POST /db/{id}/query`.

package/dist/replication/index.d.ts

@@ -1,18 +1,18 @@
 export { F as FieldMergeResolver, L as LWWResolver, P as PrimaryWinsResolver } from '../primary-wins-B0np8JS3.js';
-import { l as HLC, D as Database } from '../database-DSbJl-k5.js';
-import { q as BackupGroupSource, Y as ClusterReadEndpointInfo, F as ClusterStatusInfo, G as SQLiteConnection, T as Transaction } from '../types-CopTgHG3.js';
+import { l as HLC, D as Database } from '../database-BlhUdJAO.js';
+import { r as BackupGroupSource, a1 as ClusterReadEndpointInfo, H as ClusterStatusInfo, I as SQLiteConnection, T as Transaction } from '../types-DApb7dvw.js';
 import { C as ClusterCoordinator, c as ReplicationGroupState, e as CoordinatorWatchDisposer } from '../types-CMBcFPhb.js';
 export { A as AcquireControllerLeaseInput, a as AcquireControllerLeaseResult, h as AdmitNodeToInSyncSetInput, f as CompareAndAdvancePrimaryTermInput, g as CompareAndAdvancePrimaryTermResult, j as CoordinatorCompatibilityMetadata, k as CoordinatorLease, b as CoordinatorNodeSession, l as CoordinatorPrimary, P as PromoteEligibleReplicaInput, R as RegisterNodeSessionInput, d as ReplicationGroupWatcher, S as SetReplicationGroupStateInput, U as UpdateInSyncSetInput, i as UpdateNodeMaintenanceInput } from '../types-CMBcFPhb.js';
-import { R as ReplicationStatusInfo } from '../server-options-CFgBQDLz.js';
-import { C as CoordinatorRuntimeStatus, g as ReplicationStatus, h as SyncPhase, I as InFlightBatch, P as PeerState, a as ForwardedTransactionResult, b as SyncBatch, c as SyncComplete, d as SyncAck, S as SyncRequest, i as ReplicationConfig, j as SyncState, k as ReplicationErrorEvent, R as ReplicationAck, l as Topology, f as TopologyRole } from '../types-CL8uxXIV.js';
-export { F as ForwardedTransaction, N as NodeInfo, e as ReplicationTransport, T as TransportConfig } from '../types-CL8uxXIV.js';
+import { R as ReplicationStatusInfo } from '../server-options-DeK6ZG8u.js';
+import { C as CoordinatorRuntimeStatus, g as ReplicationStatus, h as SyncPhase, I as InFlightBatch, P as PeerState, a as ForwardedTransactionResult, b as SyncBatch, c as SyncComplete, d as SyncAck, S as SyncRequest, i as ReplicationConfig, j as SyncState, k as ReplicationErrorEvent, R as ReplicationAck, l as Topology, f as TopologyRole } from '../types-C1yBGTdx.js';
+export { F as ForwardedTransaction, N as NodeInfo, e as ReplicationTransport, T as TransportConfig } from '../types-C1yBGTdx.js';
 import { EventEmitter } from 'node:events';
-import { C as ChangeTracker } from '../change-tracker-BLKRX8ic.js';
+import { C as ChangeTracker } from '../change-tracker-uG9gWvsY.js';
 import { P as Params, Q as QueryOptions, E as ExecuteResult } from '../query-types-Cv8N7pXj.js';
 import { R as ReplicationBatch, C as ConflictResolver, A as ApplyResult, S as SyncTableManifest } from '../types-CjhxcjhA.js';
 export { a as ConflictContext, b as ConflictResolution, H as HLCTimestamp, c as ReplicationChange } from '../types-CjhxcjhA.js';
 import { S as SirannonError } from '../errors-Dei4GdBb.js';
-import '../database-backup-CliAhaEm.js';
+import '../database-backup-C090lMHc.js';
 import '../types-BCejqzNA.js';
 import '../operation-registry-C1FmwQWR.js';
 

package/dist/{restore-options-O5gYlr3n.d.ts → restore-options-C9MW9gpm.d.ts}

@@ -1,4 +1,4 @@
-import { B as BackupDestination, S as SQLiteDriver } from './types-CopTgHG3.js';
+import { B as BackupDestination, S as SQLiteDriver } from './types-DApb7dvw.js';
 
 /** How far one restore has got, reported after every piece it fetches.
  * @public

package/dist/server/index.d.ts

@@ -1,13 +1,13 @@
-import { g as BackupChain, k as BackupChainRecord, o as BackupCycleStatus, x as BackupVerifyResult } from '../types-CopTgHG3.js';
-import { b as BackupRestoreProgress, a as BackupRestoreReport } from '../restore-options-O5gYlr3n.js';
-import { a as TransactionStatement, Q as QueryResponse, E as ExecuteResponse, T as TransactionResponse, B as BatchResponse, L as LoadResponse, A as AckResponse } from '../protocol-BK0Yxu5P.js';
-export { b as BatchRequest, c as ErrorResponse, d as ExecuteRequest, e as LoadRequest, f as QueryRequest, g as TransactionRequest, t as toExecuteResponse } from '../protocol-BK0Yxu5P.js';
-import { S as Sirannon } from '../sirannon-Bo0PX2Cj.js';
-import { B as BulkLoadDurability, S as ServerOptions, W as WSHandlerOptions } from '../server-options-CFgBQDLz.js';
+import { g as BackupChain, k as BackupChainRecord, o as BackupCycleStatus, z as BackupVerifyResult } from '../types-DApb7dvw.js';
+import { b as BackupRestoreProgress, a as BackupRestoreReport } from '../restore-options-C9MW9gpm.js';
+import { a as TransactionStatement, Q as QueryResponse, E as ExecuteResponse, T as TransactionResponse, B as BatchResponse, L as LoadResponse, A as AckResponse } from '../protocol-QekTGoKn.js';
+export { b as BatchRequest, c as ErrorResponse, d as ExecuteRequest, e as LoadRequest, f as QueryRequest, g as TransactionRequest, t as toExecuteResponse } from '../protocol-QekTGoKn.js';
+import { S as Sirannon } from '../sirannon-C9cTgFrw.js';
+import { B as BulkLoadDurability, S as ServerOptions, W as WSHandlerOptions } from '../server-options-DeK6ZG8u.js';
 import { W as WriteConcern, R as ReadConcern } from '../query-types-Cv8N7pXj.js';
-import '../database-DSbJl-k5.js';
-import '../database-backup-CliAhaEm.js';
-import '../change-tracker-BLKRX8ic.js';
+import '../database-BlhUdJAO.js';
+import '../database-backup-C090lMHc.js';
+import '../change-tracker-uG9gWvsY.js';
 import '../types-CjhxcjhA.js';
 import '../types-BCejqzNA.js';
 import '../operation-registry-C1FmwQWR.js';

package/dist/server/index.mjs

@@ -1,4 +1,4 @@
-import { restoreBackup, MAX_RESTORE_BATCH_SIZE } from '../chunk-P53I2G6J.mjs';
+import { restoreBackup, MAX_RESTORE_BATCH_SIZE } from '../chunk-63VBFSCS.mjs';
 import { dumpSchema, tablesInFkOrder, dumpTablePages } from '../chunk-XF2HH5E6.mjs';
 import { ChangeTracker, SubscriptionManager, ensureCdcEpoch, migrationChecksum, needsResync, filteredChange, TransactionGrouper, isBulkLoadDurability, PrimedSubscription } from '../chunk-ECEGYTVF.mjs';
 import '../chunk-YNTDOFTN.mjs';
@@ -7,9 +7,10 @@ import '../chunk-2QLXDHAP.mjs';
 import { encodeTaggedValues, MIGRATIONS_TABLE, decodeTaggedValues, encodeWireRowsInPlace, CHANGES_TABLE, DEVICE_CURSORS_TABLE, INTERNAL_TABLE_PREFIX } from '../chunk-7R4ER4FB.mjs';
 import { createOperationSource, operationRegistryDigest, findRead, isRefusal, resolveArguments, findWrite } from '../chunk-TUD5CJ76.mjs';
 import '../chunk-GVCNMPOS.mjs';
-import { discardStagedChain } from '../chunk-GJ6SX53Z.mjs';
-import '../chunk-KSYFFYAP.mjs';
-import '../chunk-GBM4AU24.mjs';
+import { discardStagedChain } from '../chunk-W77EEVOT.mjs';
+import '../chunk-U445A3C4.mjs';
+import '../chunk-2QCPVE67.mjs';
+import '../chunk-DVS4QSIZ.mjs';
 import '../chunk-OUSWVNWT.mjs';
 import '../chunk-YVF2ZJTE.mjs';
 import '../chunk-V5FUJEYY.mjs';

package/dist/{server-options-CFgBQDLz.d.ts → server-options-DeK6ZG8u.d.ts}

@@ -1,6 +1,6 @@
 import { a as OperationRegistry } from './operation-registry-C1FmwQWR.js';
 import { R as ReplicationBatch, C as ConflictResolver, A as ApplyResult } from './types-CjhxcjhA.js';
-import { N as NodeHealth, T as Transaction, F as ClusterStatusInfo } from './types-CopTgHG3.js';
+import { N as NodeHealth, T as Transaction, H as ClusterStatusInfo } from './types-DApb7dvw.js';
 import { P as Params, Q as QueryOptions, E as ExecuteResult } from './query-types-Cv8N7pXj.js';
 
 interface AppliedMigrationRow {

package/dist/{sirannon-Bo0PX2Cj.d.ts → sirannon-C9cTgFrw.d.ts}

@@ -1,5 +1,5 @@
-import { D as Database } from './database-DSbJl-k5.js';
-import { a as SirannonOptions, S as SQLiteDriver, D as DatabaseOptions, M as Migration, b as BeforeQueryHook, A as AfterQueryHook, c as BeforeConnectHook, d as DatabaseOpenHook, e as DatabaseCloseHook } from './types-CopTgHG3.js';
+import { D as Database } from './database-BlhUdJAO.js';
+import { a as SirannonOptions, S as SQLiteDriver, D as DatabaseOptions, M as Migration, b as BeforeQueryHook, A as AfterQueryHook, c as BeforeConnectHook, d as DatabaseOpenHook, e as DatabaseCloseHook } from './types-DApb7dvw.js';
 
 /** What one database taken out of service produced.
  * @internal

package/dist/transport/grpc.d.ts

@@ -1,10 +1,10 @@
 import { BinaryWriter, BinaryReader } from '@bufbuild/protobuf/wire';
 import { Client, ClientDuplexStream, CallOptions, Metadata, ServiceError, ClientUnaryCall, ChannelCredentials, ClientOptions, ServerDuplexStream, Server } from '@grpc/grpc-js';
 import { HealthImplementation } from 'grpc-health-check';
-import { R as ReplicationAck, F as ForwardedTransaction, a as ForwardedTransactionResult, N as NodeInfo, S as SyncRequest, b as SyncBatch, c as SyncComplete, d as SyncAck, e as ReplicationTransport, f as TopologyRole, T as TransportConfig } from '../types-CL8uxXIV.js';
+import { R as ReplicationAck, F as ForwardedTransaction, a as ForwardedTransactionResult, N as NodeInfo, S as SyncRequest, b as SyncBatch, c as SyncComplete, d as SyncAck, e as ReplicationTransport, f as TopologyRole, T as TransportConfig } from '../types-C1yBGTdx.js';
 import { R as ReplicationBatch } from '../types-CjhxcjhA.js';
-import '../change-tracker-BLKRX8ic.js';
-import '../types-CopTgHG3.js';
+import '../change-tracker-uG9gWvsY.js';
+import '../types-DApb7dvw.js';
 import '../query-types-Cv8N7pXj.js';
 import '../types-CMBcFPhb.js';
 

package/dist/transport/memory.d.ts

@@ -1,7 +1,7 @@
-import { R as ReplicationAck, F as ForwardedTransaction, a as ForwardedTransactionResult, S as SyncRequest, b as SyncBatch, c as SyncComplete, d as SyncAck, N as NodeInfo, e as ReplicationTransport, T as TransportConfig } from '../types-CL8uxXIV.js';
+import { R as ReplicationAck, F as ForwardedTransaction, a as ForwardedTransactionResult, S as SyncRequest, b as SyncBatch, c as SyncComplete, d as SyncAck, N as NodeInfo, e as ReplicationTransport, T as TransportConfig } from '../types-C1yBGTdx.js';
 import { R as ReplicationBatch } from '../types-CjhxcjhA.js';
-import '../change-tracker-BLKRX8ic.js';
-import '../types-CopTgHG3.js';
+import '../change-tracker-uG9gWvsY.js';
+import '../types-DApb7dvw.js';
 import '../query-types-Cv8N7pXj.js';
 import '../types-CMBcFPhb.js';
 

package/dist/{types-CL8uxXIV.d.ts → types-C1yBGTdx.d.ts}

@@ -1,5 +1,5 @@
-import { C as ChangeTracker } from './change-tracker-BLKRX8ic.js';
-import { G as SQLiteConnection, N as NodeHealth } from './types-CopTgHG3.js';
+import { C as ChangeTracker } from './change-tracker-uG9gWvsY.js';
+import { I as SQLiteConnection, N as NodeHealth } from './types-DApb7dvw.js';
 import { S as SyncTableManifest, R as ReplicationBatch, C as ConflictResolver } from './types-CjhxcjhA.js';
 import { C as ClusterCoordinator, j as CoordinatorCompatibilityMetadata, c as ReplicationGroupState } from './types-CMBcFPhb.js';
 

package/dist/{types-CopTgHG3.d.ts → types-DApb7dvw.d.ts}

@@ -247,6 +247,32 @@ interface BackupSkip {
     uncapturedLogBytes?: number;
 }
 
+/**
+ * Where a database's write-ahead log had reached at one moment.
+ *
+ * A full copy states this, so you can tell which run of the log the database
+ * was on when that copy finished. SQLite stamps a fresh pair of salts on the
+ * log at every restart, and a checkpoint that empties the log restarts it.
+ *
+ * The checkpoint cycle checkpoints after each capture, and no checkpoint falls
+ * between a full copy and the first change piece extending its chain, so those
+ * two state the same salts. A change piece states later salts than the piece
+ * before it whenever the checkpoint between the two emptied the log. A reader
+ * can hold a checkpoint off, which leaves the log on the run it was already on,
+ * so two consecutive change pieces may state the same salts.
+ *
+ * @public
+ */
+interface BackupLogPosition {
+    /** Checkpoint sequence of the log. SQLite adds one to it at every restart of the log. */
+    logSequence: number;
+    /** First salt of that log. The two salts together tell one run of the log from the next. */
+    salt1: number;
+    /** Second salt of it. */
+    salt2: number;
+    /** The last frame that commits a transaction, counted from one. A log holding none reports zero. */
+    lastFrame: number;
+}
 /** How far one backup run has moved, reported at step resolution.
  * @public
  */
@@ -312,9 +338,52 @@ interface BackupRunReport {
     restarts: number;
     /** The stretch of log a change piece covers. A full copy has none. */
     position?: BackupChainPosition;
+    /**
+     * Where the write-ahead log had reached when a full copy finished. Sirannon
+     * reads the log after the copy has moved every page, so a writer committing
+     * between those two steps would put a frame here that the copy does not hold.
+     * A change piece states the stretch of log it holds in
+     * {@link BackupRunReport.position}, and a database that keeps no write-ahead
+     * log states neither.
+     */
+    logPosition?: BackupLogPosition;
     /** SHA-256 of the copied file, unless the caller turned it off. */
     fingerprint?: string;
 }
+/** What one finished copy to a local file produced.
+ * @public
+ */
+interface BackupFileReport {
+    /** Identifier this run is known by. */
+    runId: string;
+    /** Database the copy was taken from. */
+    databaseId: string;
+    /** File the copy was taken from. */
+    sourcePath: string;
+    /** Absolute path of the file the copy was written to. */
+    destPath: string;
+    /** Epoch milliseconds the copy started at. */
+    startedAt: number;
+    /** Epoch milliseconds it finished at. */
+    finishedAt: number;
+    /** Milliseconds it took. */
+    durationMs: number;
+    /** Pages it moved. */
+    pageCount: number;
+    /** Bytes one page holds. */
+    pageSize: number;
+    /** Bytes the file it wrote holds. */
+    byteLength: number;
+    /** Times the copy returned to page one. */
+    restarts: number;
+}
+/**
+ * What one copy to a local file produced. The controller that owns the database
+ * adds its identifier and its path to build a {@link BackupFileReport}.
+ *
+ * @internal
+ */
+type BackupFileCopy = Omit<BackupFileReport, 'databaseId' | 'sourcePath'>;
 /** How Sirannon runs one backup to a caller-supplied destination.
  * @public
  */
@@ -486,6 +555,17 @@ interface BackupCycleError {
     message: string;
     /** Epoch milliseconds the cycle raised it. */
     at: number;
+    /** Milliseconds from the start of the turn to the failure. */
+    durationMs: number;
+    /** The chain the cycle was extending, where it held one. */
+    chainId?: string;
+    /**
+     * How far the run had got when it failed. A turn that fails before its copy
+     * begins states none. A turn that fails part-way through states the run
+     * identifier, the pages it still had to move, and the pieces and bytes that
+     * had already reached the destination.
+     */
+    progress?: BackupProgress;
 }
 /** What the cycle is doing now, and what its recent turns produced.
  * @public
@@ -580,7 +660,7 @@ declare class BackupCycle {
     private sendRefused;
     private stopped;
     private readonly request;
-    private readonly statusRecord;
+    private readonly turnLog;
     /** @internal */
     constructor(request: BackupCycleRequest);
     /**
@@ -636,6 +716,14 @@ declare class BackupCycle {
      * @returns The pieces read, the bytes they add up to, and the digest where the backup recorded one.
      */
     verify(name: string): Promise<BackupVerifyResult>;
+    /**
+     * Runs one turn and passes whatever broke it to the operator. A deeper step
+     * announces some failures itself and then raises them, so this announces a
+     * failure only where no step has announced it already. The operator therefore
+     * hears each failure exactly once. Sirannon empties a log the turn has
+     * outgrown once all of that is done, and the report of writes reaching no
+     * backup replaces whatever failure the turn recorded.
+     */
     private runTurn;
     /** What the stand-down path needs of this cycle to let go of its chain. */
     private get standDownRequest();
@@ -648,7 +736,7 @@ declare class BackupCycle {
      * it is, because the frames it has yet to capture are still in no backup.
      */
     private takesTheTurn;
-    /** Passes a skipped turn on, counting the log this node was holding as it skipped. */
+    /** Passes a skipped turn on, where the cycle has a reason to give for it. */
     private reportSkip;
     private tick;
     private verifyChain;
@@ -657,10 +745,22 @@ declare class BackupCycle {
      * Runs one turn. A log that restarted before the capture reached it leaves a
      * chain nothing can extend, so this starts a fresh one. The caller still gets
      * the error: those writes are in no backup, and an operator has to hear that.
+     * Where the replacement chain also fails to start, Sirannon records that
+     * second failure against the chain the restart broke, because the cycle holds
+     * no chain of its own by then and an operator reading the status has to know
+     * which one they have lost.
      */
     private turnOrStartOver;
     private turn;
+    /**
+     * Passes a failure to the operator and records it as the turn's outcome.
+     *
+     * @param err - What the turn failed with.
+     * @param chainId - The chain to record it against, which defaults to the one the cycle holds now.
+     */
     private report;
+    /** Records a failure against a chain the cycle may already have let go of. */
+    private reportAgainstChain;
     private replaceChain;
     private captureAndCheckpoint;
     /**
@@ -1071,10 +1171,56 @@ interface BackupScheduleOptions {
      * When omitted, it uses the host's local time zone, which also sets the daylight saving rules that apply.
      */
     timezone?: string;
+    /**
+     * Called after every copy the schedule finishes, with the file it wrote and
+     * what that copy moved. Use it to send the file somewhere durable, or to
+     * record that the schedule is still running.
+     *
+     * Sirannon waits for the promise this returns, and it clears the older files
+     * only once that promise settles, so it deletes no copy your upload is still
+     * reading. Sirannon passes a failure to
+     * {@link BackupScheduleOptions.onError}, which is where it reports a failed
+     * copy as well. The deadline in
+     * {@link BackupScheduleOptions.onBackupTimeoutMs} bounds that wait.
+     */
+    onBackup?: (report: BackupFileReport) => void | Promise<void>;
+    /**
+     * Milliseconds {@link BackupScheduleOptions.onBackup} may take before
+     * Sirannon gives up waiting on it. It defaults to ten minutes, and zero
+     * leaves the wait unbounded.
+     *
+     * Sirannon clears the older files and takes the next copy once this callback
+     * settles or this deadline passes. Without a deadline, a callback left waiting
+     * on a socket would hold the schedule still for good. Past the deadline
+     * Sirannon reports the timeout through
+     * {@link BackupScheduleOptions.onError} and goes on with the schedule. Your
+     * callback keeps running while Sirannon counts that copy among the files it
+     * may delete, so set this longer than your slowest upload takes.
+     */
+    onBackupTimeoutMs?: number;
     /** Called when a scheduled backup fails. Without this, errors are silently discarded. */
     onError?: (error: Error) => void;
 }
 
+/** Runs a backup while nothing else holds the writer, so that the copy never shares the writer connection with another write.
+ * @public
+ */
+type RunExclusive = (op: () => Promise<void>) => Promise<void>;
+/**
+ * What one repeating backup needs beyond the caller's own options, so that
+ * every report it produces names the database the copy came from.
+ *
+ * @public
+ */
+interface BackupScheduleRequest extends BackupScheduleOptions {
+    /** Database the copies are taken from. Defaults to the name of the file SQLite has open. */
+    databaseId?: string;
+    /** File the copies are taken from. Defaults to the file SQLite has open on the connection. */
+    sourcePath?: string;
+    /** Runs each copy with nothing else holding the writer. Defaults to running it with no lock of its own. */
+    runExclusive?: RunExclusive;
+}
+
 interface WorkerHostOptions {
     writeTimeoutMs?: number;
     maxRestarts?: number;
@@ -1110,7 +1256,7 @@ interface WriterContext {
  */
 interface BackupEngine {
     /** Copies the database behind a connection to a destination path. */
-    backup(conn: SQLiteConnection, destPath: string, onFirstStep?: () => void): Promise<void>;
+    backup(conn: SQLiteConnection, destPath: string, onFirstStep?: () => void): Promise<BackupFileCopy>;
     /** Copies the database behind a connection to a caller-supplied destination. */
     copyToDestination(conn: SQLiteConnection, request: BackupRunRequest): Promise<BackupRunReport>;
     /** Reports whether a full copy reaches the destination without a local file. */
@@ -1118,7 +1264,7 @@ interface BackupEngine {
     /** Builds the cycle that captures the write-ahead log and then checkpoints it. */
     createCycle(request: BackupCycleRequest): BackupCycle;
     /** Starts a repeating backup and returns a function that stops it. */
-    schedule(conn: SQLiteConnection, options: BackupScheduleOptions, runExclusive: (op: () => Promise<void>) => Promise<void>): () => void;
+    schedule(conn: SQLiteConnection, request: BackupScheduleRequest): () => void;
 }
 /** What one step of a stepped database copy reported.
  * @public
@@ -1342,4 +1488,4 @@ interface SQLiteDriver {
     resolveExtensionPath?(extensionPath: string): string;
 }
 
-export { type DatabaseCopyRequest as $, type AfterQueryHook as A, type BackupDestination as B, readBackupChains as C, type DatabaseOptions as D, verifyBackupRecord as E, type ClusterStatusInfo as F, type SQLiteConnection as G, type BackupRunRequest as H, type BackupScheduleOptions as I, type DriverCapabilities as J, type BackupEngine as K, type SynchronousLevel as L, type Migration as M, type NodeHealth as N, type LifecycleConfig as O, type MigrationResult as P, type AppliedMigration as Q, type RollbackResult as R, type SQLiteDriver as S, Transaction as T, type AppliedMigrationEntry as U, type BatchSummary as V, type BeforeSubscribeHook as W, type CDCMetrics as X, type ClusterReadEndpointInfo as Y, type ConnectionHookContext as Z, type ConnectionMetrics as _, type SirannonOptions as a, type DatabaseCopyStep as a0, type DriverWorkerEntry as a1, type HookConfig as a2, MIGRATION_NAME_RE as a3, type MetricsConfig as a4, type MigrationBaseline as a5, type MigrationSource as a6, type NodeHealthReason as a7, type NodeHealthState as a8, type OpenOptions as a9, type QueryHookContext as aa, type QueryMetrics as ab, type RunResult as ac, type SQLiteStatement as ad, type WriterWorkerOptions as ae, type WorkerHostOptions as af, type WriterContext as ag, type BeforeQueryHook as b, type BeforeConnectHook as c, type DatabaseOpenHook as d, type DatabaseCloseHook as e, type BackupRunReport as f, type BackupChain as g, type BackupChainBase as h, type BackupChainChange as i, type BackupChainPosition as j, type BackupChainRecord as k, BackupCycle as l, type BackupCycleError as m, type BackupCycleOptions as n, type BackupCycleStatus as o, type BackupGroupMembership as p, type BackupGroupSource as q, type BackupNodePreference as r, type BackupPiece as s, type BackupProgress as t, type BackupSkip as u, type BackupSkipReason as v, type BackupToDestinationOptions as w, type BackupVerifyResult as x, DEFAULT_CHAIN_NAME as y, chainLogName as z };
+export { type BeforeSubscribeHook as $, type AfterQueryHook as A, type BackupDestination as B, DEFAULT_CHAIN_NAME as C, type DatabaseOptions as D, chainLogName as E, readBackupChains as F, verifyBackupRecord as G, type ClusterStatusInfo as H, type SQLiteConnection as I, type BackupFileCopy as J, type BackupRunRequest as K, type BackupScheduleRequest as L, type Migration as M, type NodeHealth as N, type BackupScheduleOptions as O, type DriverCapabilities as P, type BackupEngine as Q, type RunExclusive as R, type SQLiteDriver as S, Transaction as T, type SynchronousLevel as U, type LifecycleConfig as V, type MigrationResult as W, type RollbackResult as X, type AppliedMigration as Y, type AppliedMigrationEntry as Z, type BatchSummary as _, type SirannonOptions as a, type CDCMetrics as a0, type ClusterReadEndpointInfo as a1, type ConnectionHookContext as a2, type ConnectionMetrics as a3, type DatabaseCopyRequest as a4, type DatabaseCopyStep as a5, type DriverWorkerEntry as a6, type HookConfig as a7, MIGRATION_NAME_RE as a8, type MetricsConfig as a9, type MigrationBaseline as aa, type MigrationSource as ab, type NodeHealthReason as ac, type NodeHealthState as ad, type OpenOptions as ae, type QueryHookContext as af, type QueryMetrics as ag, type RunResult as ah, type SQLiteStatement as ai, type WriterWorkerOptions as aj, type WorkerHostOptions as ak, type WriterContext as al, type BeforeQueryHook as b, type BeforeConnectHook as c, type DatabaseOpenHook as d, type DatabaseCloseHook as e, type BackupRunReport as f, type BackupChain as g, type BackupChainBase as h, type BackupChainChange as i, type BackupChainPosition as j, type BackupChainRecord as k, BackupCycle as l, type BackupCycleError as m, type BackupCycleOptions as n, type BackupCycleStatus as o, type BackupFileReport as p, type BackupGroupMembership as q, type BackupGroupSource as r, type BackupLogPosition as s, type BackupNodePreference as t, type BackupPiece as u, type BackupProgress as v, type BackupSkip as w, type BackupSkipReason as x, type BackupToDestinationOptions as y, type BackupVerifyResult as z };