@camstack/types 1.2.361 → 1.2.362

package/dist/capabilities/backup.cap.d.ts

@@ -101,6 +101,11 @@ declare const BackupArchiveEntrySchema: z.ZodObject<{
         scheme: z.ZodString;
         keyId: z.ZodString;
     }, z.core.$strip>>;
+    databases: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+        events: "events";
+        history: "history";
+        settings: "settings";
+    }>>>>;
 }, z.core.$strip>;
 declare const BackupEntrySchema: z.ZodObject<{
     id: z.ZodString;
@@ -154,7 +159,17 @@ declare const ArchiveManifestSchema: z.ZodObject<{
         takenAt: z.ZodNumber;
         livePath: z.ZodString;
         snapshotPath: z.ZodString;
+        databaseId: z.ZodOptional<z.ZodEnum<{
+            events: "events";
+            history: "history";
+            settings: "settings";
+        }>>;
     }, z.core.$strip>>>;
+    omittedDatabases: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        events: "events";
+        history: "history";
+        settings: "settings";
+    }>>>;
 }, z.core.$strip>;
 declare const LocationStatSchema: z.ZodObject<{
     name: z.ZodString;
@@ -265,6 +280,11 @@ declare const BackupScheduleSchema: z.ZodObject<{
     locationIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
     retentionCount: z.ZodNumber;
     dataSources: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+    databases: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+        events: "events";
+        history: "history";
+        settings: "settings";
+    }>>>>;
     lastAttemptAt: z.ZodOptional<z.ZodNumber>;
     lastSuccessAt: z.ZodOptional<z.ZodNumber>;
     lastError: z.ZodOptional<z.ZodString>;
@@ -321,6 +341,11 @@ export declare const backupCapability: {
             locations: z.ZodOptional<z.ZodArray<z.ZodString>>;
             label: z.ZodOptional<z.ZodString>;
             retentionCount: z.ZodOptional<z.ZodNumber>;
+            databases: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                events: "events";
+                history: "history";
+                settings: "settings";
+            }>>>;
         }, z.core.$strip>>, z.ZodObject<{
             runId: z.ZodString;
             queued: z.ZodBoolean;
@@ -455,7 +480,17 @@ export declare const backupCapability: {
                 takenAt: z.ZodNumber;
                 livePath: z.ZodString;
                 snapshotPath: z.ZodString;
+                databaseId: z.ZodOptional<z.ZodEnum<{
+                    events: "events";
+                    history: "history";
+                    settings: "settings";
+                }>>;
             }, z.core.$strip>>>;
+            omittedDatabases: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                events: "events";
+                history: "history";
+                settings: "settings";
+            }>>>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly restore: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             destinationId: z.ZodString;
@@ -530,6 +565,11 @@ export declare const backupCapability: {
                 scheme: z.ZodString;
                 keyId: z.ZodString;
             }, z.core.$strip>>;
+            databases: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+                events: "events";
+                history: "history";
+                settings: "settings";
+            }>>>>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * Upsert a per-destination policy row. The `locationId` MUST be
@@ -569,6 +609,11 @@ export declare const backupCapability: {
             locationIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
             retentionCount: z.ZodNumber;
             dataSources: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+            databases: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+                events: "events";
+                history: "history";
+                settings: "settings";
+            }>>>>;
             lastAttemptAt: z.ZodOptional<z.ZodNumber>;
             lastSuccessAt: z.ZodOptional<z.ZodNumber>;
             lastError: z.ZodOptional<z.ZodString>;
@@ -588,6 +633,11 @@ export declare const backupCapability: {
             locationIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
             retentionCount: z.ZodNumber;
             dataSources: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+            databases: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+                events: "events";
+                history: "history";
+                settings: "settings";
+            }>>>>;
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodString;
@@ -596,6 +646,11 @@ export declare const backupCapability: {
             locationIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
             retentionCount: z.ZodNumber;
             dataSources: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+            databases: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+                events: "events";
+                history: "history";
+                settings: "settings";
+            }>>>>;
             lastAttemptAt: z.ZodOptional<z.ZodNumber>;
             lastSuccessAt: z.ZodOptional<z.ZodNumber>;
             lastError: z.ZodOptional<z.ZodString>;

package/dist/capabilities/database-snapshot.cap.d.ts

@@ -29,6 +29,11 @@ export declare const DATABASE_SNAPSHOT_TIMEOUT_MS: number;
  */
 export declare const DatabaseSnapshotTargetsSchema: z.ZodObject<{
     databases: z.ZodArray<z.ZodObject<{
+        databaseId: z.ZodEnum<{
+            events: "events";
+            history: "history";
+            settings: "settings";
+        }>;
         livePath: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -60,6 +65,36 @@ export declare const DatabaseSnapshotResultSchema: z.ZodObject<{
     takenAt: z.ZodNumber;
 }, z.core.$strip>;
 export type DatabaseSnapshotResult = z.infer<typeof DatabaseSnapshotResultSchema>;
+/** A snapshot the owner wrote, with the file it belongs to. */
+export declare const DatabaseSnapshotWrittenSchema: z.ZodObject<{
+    livePath: z.ZodString;
+    snapshotPath: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    pageCount: z.ZodNumber;
+    pageSize: z.ZodNumber;
+    tables: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        rows: z.ZodNumber;
+    }, z.core.$strip>>;
+    copyMs: z.ZodNumber;
+    verifyMs: z.ZodNumber;
+    takenAt: z.ZodNumber;
+    databaseId: z.ZodEnum<{
+        events: "events";
+        history: "history";
+        settings: "settings";
+    }>;
+}, z.core.$strip>;
+export type DatabaseSnapshotWritten = z.infer<typeof DatabaseSnapshotWrittenSchema>;
+/** Which database `writeSnapshot` copies. Required: an unstated ask is not guessed. */
+export declare const DatabaseSnapshotRequestSchema: z.ZodObject<{
+    databaseId: z.ZodEnum<{
+        events: "events";
+        history: "history";
+        settings: "settings";
+    }>;
+}, z.core.$strip>;
+export type DatabaseSnapshotRequest = z.infer<typeof DatabaseSnapshotRequestSchema>;
 /**
  * A snapshot as an ARCHIVE records it (`ArchiveManifest.sqliteSnapshots`):
  * the same facts, with both paths relative to the archive root (the node's
@@ -78,6 +113,11 @@ export declare const ArchiveSqliteSnapshotSchema: z.ZodObject<{
     takenAt: z.ZodNumber;
     livePath: z.ZodString;
     snapshotPath: z.ZodString;
+    databaseId: z.ZodOptional<z.ZodEnum<{
+        events: "events";
+        history: "history";
+        settings: "settings";
+    }>>;
 }, z.core.$strip>;
 export type ArchiveSqliteSnapshot = z.infer<typeof ArchiveSqliteSnapshotSchema>;
 /**
@@ -103,21 +143,36 @@ export declare const databaseSnapshotCapability: {
     readonly internal: true;
     readonly methods: {
         /**
-         * Which databases this owner snapshots. Answered from memory — no file is
-         * touched — so a backup can ask it before deciding anything.
+         * EVERY database file this owner has open, with its id. Answered from
+         * memory — no file is touched — so a backup can ask it before deciding
+         * anything. A file created at runtime is listed from the moment it opens,
+         * so no backup can leave it out (D693).
          */
         readonly listDatabases: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
             databases: z.ZodArray<z.ZodObject<{
+                databaseId: z.ZodEnum<{
+                    events: "events";
+                    history: "history";
+                    settings: "settings";
+                }>;
                 livePath: z.ZodString;
             }, z.core.$strip>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
-         * Write `<db>.backup-snapshot` and return what it holds. Throws — and
-         * leaves no file under the final name — when the copy fails
-         * `integrity_check` or its row counts differ from the pinned source's.
-         * A second call while one is running joins it.
+         * Write `<db>.backup-snapshot` for ONE database and return what it holds.
+         * Throws — and leaves no file under the final name — when the copy fails
+         * `integrity_check` or its row counts differ from the pinned source's, or
+         * when the database is not open. A second call for the SAME database while
+         * one is running joins it; different databases run one after the other
+         * (the disk reserve check is per copy).
          */
-        readonly writeSnapshot: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+        readonly writeSnapshot: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            databaseId: z.ZodEnum<{
+                events: "events";
+                history: "history";
+                settings: "settings";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
             livePath: z.ZodString;
             snapshotPath: z.ZodString;
             sizeBytes: z.ZodNumber;
@@ -130,6 +185,11 @@ export declare const databaseSnapshotCapability: {
             copyMs: z.ZodNumber;
             verifyMs: z.ZodNumber;
             takenAt: z.ZodNumber;
+            databaseId: z.ZodEnum<{
+                events: "events";
+                history: "history";
+                settings: "settings";
+            }>;
         }, z.core.$strip>, "mutation">;
     };
 };

package/dist/capabilities/index.d.ts

@@ -44,7 +44,7 @@ export * from './custom-actions.js';
 export type { CustomModelDescriptor, ICustomModelRegistryProvider, ImportModelBundleInput, ImportModelBundleResult, ModelBundleFile, } from './custom-model-registry.cap.js';
 export { CustomModelDescriptorSchema, customModelRegistryCapability, ImportModelBundleInputSchema, ImportModelBundleResultSchema, ModelBundleFileSchema, } from './custom-model-registry.cap.js';
 export { type DataStoreEngineInfo, dataStoreProviderCapability, EngineInfoSchema as DataStoreEngineInfoSchema, type IDataStoreProvider, } from './data-store-provider.cap.js';
-export { type ArchiveSqliteSnapshot, ArchiveSqliteSnapshotSchema, DATABASE_SNAPSHOT_PARTIAL_SUFFIX, DATABASE_SNAPSHOT_SUFFIX, DATABASE_SNAPSHOT_TIMEOUT_MS, type DatabaseSnapshotResult, DatabaseSnapshotResultSchema, type DatabaseSnapshotTable, DatabaseSnapshotTableSchema, type DatabaseSnapshotTargets, DatabaseSnapshotTargetsSchema, databaseSnapshotCapability, type IDatabaseSnapshotProvider, } from './database-snapshot.cap.js';
+export { type ArchiveSqliteSnapshot, ArchiveSqliteSnapshotSchema, DATABASE_SNAPSHOT_PARTIAL_SUFFIX, DATABASE_SNAPSHOT_SUFFIX, DATABASE_SNAPSHOT_TIMEOUT_MS, type DatabaseSnapshotRequest, DatabaseSnapshotRequestSchema, type DatabaseSnapshotResult, DatabaseSnapshotResultSchema, type DatabaseSnapshotTable, DatabaseSnapshotTableSchema, type DatabaseSnapshotTargets, DatabaseSnapshotTargetsSchema, type DatabaseSnapshotWritten, DatabaseSnapshotWrittenSchema, databaseSnapshotCapability, type IDatabaseSnapshotProvider, } from './database-snapshot.cap.js';
 export { type IKeychainProvider, KEYCHAIN_MAX_REFS_PER_CALL, type KeychainResolveEntry, KeychainResolveEntrySchema, type KeychainResolveResult, KeychainResolveResultSchema, type KeychainSecretMeta, KeychainSecretMetaSchema, type KeychainState, KeychainStateSchema, type KeychainUnavailableReason, KeychainUnavailableReasonSchema, keychainCapability, } from './keychain.cap.js';
 export { type IKeychainAdminProvider, KEYCHAIN_RESET_CONFIRMATION, type KeychainAdminSecret, KeychainAdminSecretSchema, type KeychainAuditAction, KeychainAuditActionSchema, type KeychainAuditEntry, KeychainAuditEntrySchema, type KeychainKeySource, type KeychainKeySourceKind, KeychainKeySourceKindSchema, KeychainKeySourceSchema, KEYCHAIN_RESET_TRIGGER_ACTOR, type KeychainResetRecord, KeychainResetRecordSchema, type KeychainSecretUsage, KeychainSecretUsageSchema, type KeychainStatus, KeychainStatusSchema, keychainAdminCapability, type SystemHeldSecretName, SystemHeldSecretNameSchema, } from './keychain-admin.cap.js';
 export type { DecoderHwAccelConfig, HwAccelChoice, IDecoderCapProvider, } from './decoder.cap.js';