@camstack/types 1.2.360 → 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/data-store-provider.cap.d.ts

@@ -136,6 +136,18 @@ export declare const dataStoreProviderCapability: {
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
         }, z.core.$strip>, "mutation">;
+        /** Upsert many records in ONE transaction; see the door's `upsertMany`. */
+        readonly upsertMany: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            conflict: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+            records: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            upserted: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
         /** Insert many records in ONE transaction. All or nothing. */
         readonly insertMany: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             namespace: z.ZodOptional<z.ZodString>;
@@ -178,6 +190,14 @@ export declare const dataStoreProviderCapability: {
                 collection: z.ZodString;
                 id: z.ZodString;
                 data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>, z.ZodObject<{
+                op: z.ZodLiteral<"upsertMany">;
+                collection: z.ZodString;
+                conflict: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+                records: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                }, z.core.$strip>>>;
             }, z.core.$strip>], "op">>>;
         }, z.core.$strip>, z.ZodObject<{
             applied: z.ZodBoolean;
@@ -336,6 +356,13 @@ export declare const dataStoreProviderCapability: {
                 columns: z.ZodReadonly<z.ZodArray<z.ZodString>>;
                 unique: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>>;
+            database: z.ZodOptional<z.ZodEnum<{
+                events: "events";
+                history: "history";
+                settings: "settings";
+            }>>;
+            primaryKey: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+            withoutRowid: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodVoid, "mutation">;
     };
 };

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';
@@ -106,7 +106,7 @@ export type { AudioStreamPick, CameraStream, CamProfile, CamStreamKind, DecodedA
 export { AudioChunkFormatSchema, AudioStreamPickSchema, BrokerStatsSchema, BrokerStatusSchema, CAM_PROFILE_ORDER, CameraStreamSchema, CamProfileSchema, CamStreamKindSchema, CamStreamResolutionSchema, DecodedAudioChunkSchema, FrameHandleSchema, makeProfileBrokerId, makeSourceBrokerId, ProfileRtspEntrySchema, ProfileSlotSchema, ProfileSlotStatusSchema, parseProfileBrokerId, StreamSourceEntrySchema, StreamSourceSchema, SubscribeAudioChunksInputSchema, SubscribeAudioChunksResultSchema, selectAssignedProfileSlots, } from './schemas/streaming-shared.js';
 export { buildEventKindDescriptor, EVENT_KIND_BY_CAP, EVENTFUL_CAP_NAMES, type SensorEventKindDescriptor, } from './sensor-event-kinds.js';
 export { type ImageContract, ImageContractSchema, type ImageContractState, ImageContractStateSchema, type IServerManagementProvider, type ServerBootMode, ServerBootModeSchema, type ServerPackageStatus, ServerPackageStatusSchema, type ServerRollbackInfo, ServerRollbackInfoSchema, type ServerUpdateActionResult, ServerUpdateActionResultSchema, type ServerUpdateCheckResult, ServerUpdateCheckResultSchema, type ServerUpdateOutcome, ServerUpdateOutcomeSchema, type ServerUpdateState, ServerUpdateStateSchema, serverManagementCapability, type WrapperEvidence, WrapperEvidenceSchema, type WrapperIdentity, WrapperIdentitySchema, type WrapperKind, WrapperKindSchema, } from './server-management.cap.js';
-export { type BulkRecord, BulkRecordSchema, type CollectionColumn, CollectionColumnSchema, type CollectionIndex, CollectionIndexSchema, type ISettingsStoreProvider, type MutationFilter, MutationFilterSchema, QueryFilterSchema, SettingsRecordSchema, type SettingsStoreClient, settingsStoreCapability, } from './settings-store.cap.js';
+export { type BulkRecord, BulkRecordSchema, type CollectionColumn, CollectionColumnSchema, type CollectionIndex, CollectionIndexSchema, DATA_STORE_DATABASES, type DataStoreDatabase, DataStoreDatabaseSchema, type DeclareCollectionInput, DeclareCollectionInputSchema, type ISettingsStoreProvider, type MutationFilter, MutationFilterSchema, QueryFilterSchema, SettingsRecordSchema, type SettingsStoreClient, settingsStoreCapability, } from './settings-store.cap.js';
 export type { ISmtpProvider } from './smtp-provider.cap.js';
 export { SendEmailInputSchema, SendEmailResultSchema, SmtpStatusSchema, smtpProviderCapability, } from './smtp-provider.cap.js';
 export { type ISnapshotOrchestrator, SnapshotImageSchema, snapshotCapability, } from './snapshot.cap.js';

package/dist/capabilities/settings-store.cap.d.ts

@@ -80,9 +80,24 @@ declare const BulkRecordSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, z.core.$strip>;
+/**
+ * The database FILES one `sqlite-settings` engine process owns (D851).
+ * Closed on purpose: a file is a thing the engine opens, backs up and gives a
+ * serving thread, so a new one is a code change, never a string a caller
+ * invents. `settings` is `camstack.db` and the default for every collection
+ * that names no file.
+ */
+declare const DataStoreDatabaseSchema: z.ZodEnum<{
+    events: "events";
+    history: "history";
+    settings: "settings";
+}>;
+/** Every database file, in a stable order (settings first). */
+declare const DATA_STORE_DATABASES: readonly z.infer<typeof DataStoreDatabaseSchema>[];
 /**
  * One write inside a {@link settingsStoreCapability.methods.transact} call.
- * Only the three that a "replace this set, bump that revision" write needs.
+ * The three that a "replace this set, bump that revision" write needs, plus
+ * the batched upsert a rollup writer needs.
  */
 declare const TransactOpSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     op: z.ZodLiteral<"deleteWhere">;
@@ -106,6 +121,14 @@ declare const TransactOpSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     collection: z.ZodString;
     id: z.ZodString;
     data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"upsertMany">;
+    collection: z.ZodString;
+    conflict: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    records: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>], "op">;
 /**
  * The precondition of a transaction: the row `key` of `collection` must hold
@@ -145,6 +168,51 @@ declare const CollectionIndexSchema: z.ZodObject<{
     columns: z.ZodReadonly<z.ZodArray<z.ZodString>>;
     unique: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
+/**
+ * The input of `declareCollection` — ONE schema for the door and for the
+ * engine behind it, so the two surfaces cannot drift (the dispatcher forwards
+ * the payload untouched).
+ *
+ * - `database` — the file the collection lives in (D851). Absent means
+ *   `settings`. A declaration naming a file other than the one the table is
+ *   already in is REFUSED by the engine, never moved.
+ * - `primaryKey` — a COMPOSITE key, as column names. A single name is the same
+ *   as `primaryKey: true` on that column. A composite-keyed collection has no
+ *   `id`: it is written with `insertMany` / `upsertMany` / `transact` and read
+ *   with `query` / `count` / `aggregate` / `deleteWhere`; the calls that
+ *   address one row by id are refused.
+ * - `withoutRowid` — emit `WITHOUT ROWID`. Requires a primary key.
+ */
+declare const DeclareCollectionInputSchema: z.ZodObject<{
+    namespace: z.ZodOptional<z.ZodString>;
+    collection: z.ZodString;
+    columns: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            BOOLEAN: "BOOLEAN";
+            INTEGER: "INTEGER";
+            JSON: "JSON";
+            REAL: "REAL";
+            TEXT: "TEXT";
+        }>;
+        primaryKey: z.ZodOptional<z.ZodBoolean>;
+        notNull: z.ZodOptional<z.ZodBoolean>;
+        unique: z.ZodOptional<z.ZodBoolean>;
+        defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    }, z.core.$strip>>>;
+    indexes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        columns: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        unique: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>>;
+    database: z.ZodOptional<z.ZodEnum<{
+        events: "events";
+        history: "history";
+        settings: "settings";
+    }>>;
+    primaryKey: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+    withoutRowid: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
 /**
  * settings-store — singleton capability for addon-scoped persistence.
  *
@@ -295,6 +363,31 @@ export declare const settingsStoreCapability: {
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
         }, z.core.$strip>, "mutation">;
+        /**
+         * {@link upsert} for a BATCH, in ONE transaction on ONE prepared statement.
+         *
+         * The write-side twin of {@link insertMany} for rows that may already
+         * exist: a rollup writer recomputes a bucket and must overwrite it, and
+         * N round trips with N COMMITs is the cost {@link insertMany} was added to
+         * avoid. `conflict` has the meaning it has on {@link upsert} (declared
+         * columns covered by a UNIQUE index or the primary key, never empty).
+         *
+         * Every record of a batch must carry the SAME set of declared columns and
+         * every `conflict` column: one batch is one statement shape, and a record
+         * that silently bound NULL over a column it did not mention would erase
+         * it. A heterogeneous batch is refused whole. **All or nothing.**
+         */
+        readonly upsertMany: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            conflict: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+            records: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            upserted: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
         /** Insert a new record. */
         readonly insert: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             namespace: z.ZodOptional<z.ZodString>;
@@ -388,6 +481,14 @@ export declare const settingsStoreCapability: {
                 collection: z.ZodString;
                 id: z.ZodString;
                 data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>, z.ZodObject<{
+                op: z.ZodLiteral<"upsertMany">;
+                collection: z.ZodString;
+                conflict: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+                records: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                }, z.core.$strip>>>;
             }, z.core.$strip>], "op">>>;
         }, z.core.$strip>, z.ZodObject<{
             applied: z.ZodBoolean;
@@ -594,6 +695,13 @@ export declare const settingsStoreCapability: {
                 columns: z.ZodReadonly<z.ZodArray<z.ZodString>>;
                 unique: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>>;
+            database: z.ZodOptional<z.ZodEnum<{
+                events: "events";
+                history: "history";
+                settings: "settings";
+            }>>;
+            primaryKey: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+            withoutRowid: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodVoid, "mutation">;
     };
 };
@@ -604,10 +712,12 @@ export type ISettingsStoreProvider = InferProvider<typeof settingsStoreCapabilit
  * Methods are accessed as `client.get.query(input)`, `client.set.mutate(input)`, etc.
  */
 export type SettingsStoreClient = import('../generated/addon-api.js').AddonApi['settingsStore'];
-export { AggregateFieldSchema, AggregateResultSchema, BulkRecordSchema, CollectionColumnSchema, CollectionIndexSchema, MutationFilterSchema, QueryFilterSchema, SettingsRecordSchema, TransactGuardSchema, TransactOpSchema, };
+export { AggregateFieldSchema, DATA_STORE_DATABASES, DataStoreDatabaseSchema, DeclareCollectionInputSchema, AggregateResultSchema, BulkRecordSchema, CollectionColumnSchema, CollectionIndexSchema, MutationFilterSchema, QueryFilterSchema, SettingsRecordSchema, TransactGuardSchema, TransactOpSchema, };
 export type BulkRecord = z.infer<typeof BulkRecordSchema>;
 export type AggregateField = z.infer<typeof AggregateFieldSchema>;
 export type AggregateResult = z.infer<typeof AggregateResultSchema>;
 export type MutationFilter = z.infer<typeof MutationFilterSchema>;
 export type CollectionColumn = z.infer<typeof CollectionColumnSchema>;
 export type CollectionIndex = z.infer<typeof CollectionIndexSchema>;
+export type DataStoreDatabase = z.infer<typeof DataStoreDatabaseSchema>;
+export type DeclareCollectionInput = z.infer<typeof DeclareCollectionInputSchema>;

package/dist/client.js

@@ -7783,6 +7783,7 @@ function createSystemProxy(api) {
 			set: (input) => dispatch("settingsStore", "set", "mutation", input),
 			query: (input) => dispatch("settingsStore", "query", "query", input),
 			upsert: (input) => dispatch("settingsStore", "upsert", "mutation", input),
+			upsertMany: (input) => dispatch("settingsStore", "upsertMany", "mutation", input),
 			insert: (input) => dispatch("settingsStore", "insert", "mutation", input),
 			insertMany: (input) => dispatch("settingsStore", "insertMany", "mutation", input),
 			transact: (input) => dispatch("settingsStore", "transact", "mutation", input),

package/dist/client.mjs

@@ -7782,6 +7782,7 @@ function createSystemProxy(api) {
 			set: (input) => dispatch("settingsStore", "set", "mutation", input),
 			query: (input) => dispatch("settingsStore", "query", "query", input),
 			upsert: (input) => dispatch("settingsStore", "upsert", "mutation", input),
+			upsertMany: (input) => dispatch("settingsStore", "upsertMany", "mutation", input),
 			insert: (input) => dispatch("settingsStore", "insert", "mutation", input),
 			insertMany: (input) => dispatch("settingsStore", "insertMany", "mutation", input),
 			transact: (input) => dispatch("settingsStore", "transact", "mutation", input),

package/dist/generated/addon-api.d.ts

@@ -1878,6 +1878,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof dataStoreProviderCapability.methods.upsert.output>;
             meta: object;
         }>;
+        upsertMany: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof dataStoreProviderCapability.methods.upsertMany.input>;
+            output: z.infer<typeof dataStoreProviderCapability.methods.upsertMany.output>;
+            meta: object;
+        }>;
         insertMany: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;
@@ -8153,6 +8160,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof settingsStoreCapability.methods.upsert.output>;
             meta: object;
         }>;
+        upsertMany: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof settingsStoreCapability.methods.upsertMany.input>;
+            output: z.infer<typeof settingsStoreCapability.methods.upsertMany.output>;
+            meta: object;
+        }>;
         insert: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 1303 method paths across 170 capabilities.
+ * Coverage: 1305 method paths across 170 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/system-proxy.d.ts

@@ -99,7 +99,7 @@ export interface SystemProxy {
     readonly recordingArchive: Pick<InferProvider<typeof recordingArchiveCapability>, 'getAvailabilityBatch' | 'getDaysWithRecordingsBatch' | 'getStorageUsage' | 'listOpsLog' | 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'refreshStorageLocationsForMigration' | 'startStorageMigrationMove' | 'getStorageMigrationMoveStatus' | 'cancelStorageMigrationMove' | 'relocateFootage' | 'listRelocateJobs' | 'getRelocateResidue' | 'reconcileLedgerAgainstDisk' | 'cancelRelocateJob' | 'planStorageRebalance' | 'startStorageRebalance' | 'getPlacement' | 'setDevicePlacement'>;
     readonly recordingExport: Pick<InferProvider<typeof recordingExportCapability>, 'createExport' | 'getExport' | 'cancelExport' | 'deleteExport' | 'getDownloadUrl' | 'readExportBytes'>;
     readonly serverManagement: Pick<InferProvider<typeof serverManagementCapability>, 'getServerPackageStatus' | 'checkServerUpdate' | 'applyServerUpdate' | 'rollbackServerUpdate' | 'restartServer'>;
-    readonly settingsStore: Pick<InferProvider<typeof settingsStoreCapability>, 'get' | 'set' | 'query' | 'upsert' | 'insert' | 'insertMany' | 'transact' | 'update' | 'delete' | 'deleteWhere' | 'updateWhere' | 'count' | 'aggregate' | 'histogram' | 'isEmpty' | 'declareCollection'>;
+    readonly settingsStore: Pick<InferProvider<typeof settingsStoreCapability>, 'get' | 'set' | 'query' | 'upsert' | 'upsertMany' | 'insert' | 'insertMany' | 'transact' | 'update' | 'delete' | 'deleteWhere' | 'updateWhere' | 'count' | 'aggregate' | 'histogram' | 'isEmpty' | 'declareCollection'>;
     readonly storage: Pick<InferProvider<typeof storageCapability>, 'resolve' | 'write' | 'read' | 'exists' | 'list' | 'delete' | 'getAvailableSpace' | 'beginUpload' | 'writeChunk' | 'finalizeUpload' | 'abortUpload' | 'beginDownload' | 'readChunk' | 'endDownload' | 'listLocations' | 'listLocationDeclarations' | 'upsertLocation' | 'deleteLocation' | 'listDrainProgress' | 'testLocation' | 'listProviders' | 'testConfig'>;
     readonly storageMigration: Pick<InferProvider<typeof storageMigrationCapability>, 'plan' | 'start' | 'status' | 'cancel' | 'movers' | 'residue' | 'drain' | 'cleanupStart' | 'cleanupStatus' | 'cleanupCancel' | 'history'>;
     readonly streamBroker: Pick<InferProvider<typeof streamBrokerCapability>, 'fetchEventMedia' | 'listAllCameraStreams' | 'listAllProfileSlots' | 'getBrokerStats' | 'probeStream' | 'listClients' | 'getLiveViewerCounts' | 'killClient' | 'getStreamUrl' | 'getStreamWithCodec' | 'releaseStreamWithCodec' | 'acquireEgressTranscode' | 'releaseEgressTranscode' | 'subscribeAudioChunks' | 'pullAudioChunks' | 'unsubscribeAudioChunks' | 'setPreBufferDuration' | 'getPreBufferInfo' | 'getRtspPort' | 'getAllRtspEntries' | 'getRtspEntry' | 'regenerateRtspToken' | 'setRtspEnabled' | 'isRtspEnabled'>;