@camstack/types 1.2.359 → 1.2.361

package/dist/index.js

@@ -1949,6 +1949,7 @@ var RETRAIN_REVIEW_MATCH_IOU = .5;
 var RETRAIN_REVIEW_ADJUSTED_IOU = .95;
 /** Two boxes this close on every edge are the same rectangle (an exact match). */
 var EXACT_EDGE_EPSILON = 1e-6;
+var optLabel = (label) => label !== void 0 ? { label } : {};
 /** Intersection over union of two normalised rectangles. */
 function retrainBoxIou(a, b) {
 	const inter = Math.max(0, Math.min(a.x + a.w, b.x + b.w) - Math.max(a.x, b.x)) * Math.max(0, Math.min(a.y + a.h, b.y + b.h) - Math.max(a.y, b.y));
@@ -1958,13 +1959,13 @@ function retrainBoxIou(a, b) {
 function sameRect(a, b) {
 	return Math.abs(a.x - b.x) <= EXACT_EDGE_EPSILON && Math.abs(a.y - b.y) <= EXACT_EDGE_EPSILON && Math.abs(a.w - b.w) <= EXACT_EDGE_EPSILON && Math.abs(a.h - b.h) <= EXACT_EDGE_EPSILON;
 }
-function labelOf(value) {
+function labelField(value) {
 	return value?.trim() ?? "";
 }
 /** Kept box versus its baseline: class/label first, then geometry. */
 function compareKept(saved, baseline, adjustedIou) {
 	const iou = retrainBoxIou(saved.bbox, baseline.bbox);
-	if (saved.macroClass !== baseline.macroClass || labelOf(saved.label) !== labelOf(baseline.label)) return {
+	if (saved.macroClass !== baseline.macroClass || labelField(saved.label) !== labelField(baseline.label)) return {
 		status: "reclassified",
 		iou
 	};
@@ -2039,6 +2040,8 @@ function classifyRetrainReview(saved, origins, dismissed, opts = {}) {
 				savedId: box.id,
 				status: "model-error",
 				approximate: false,
+				macroClass: box.macroClass,
+				...optLabel(box.label),
 				...baseline !== null ? {
 					origin: baseline,
 					iou: retrainBoxIou(box.bbox, baseline.bbox)
@@ -2052,6 +2055,8 @@ function classifyRetrainReview(saved, origins, dismissed, opts = {}) {
 				savedId: box.id,
 				status: "added",
 				approximate: approximate && baseline === null,
+				macroClass: box.macroClass,
+				...optLabel(box.label),
 				...baseline !== null ? { origin: baseline } : {}
 			});
 			return;
@@ -2062,6 +2067,8 @@ function classifyRetrainReview(saved, origins, dismissed, opts = {}) {
 			savedId: box.id,
 			status: verdict.status,
 			approximate,
+			macroClass: box.macroClass,
+			...optLabel(box.label),
 			origin: baseline,
 			iou: verdict.iou
 		});
@@ -2070,6 +2077,8 @@ function classifyRetrainReview(saved, origins, dismissed, opts = {}) {
 		ref: entry.ref,
 		status: "removed",
 		approximate: false,
+		macroClass: entry.snapshot.macroClass,
+		...optLabel(entry.snapshot.label),
 		origin: entry.snapshot
 	});
 	if (opts.inferRemoved === true) for (const origin of origins) {
@@ -2078,6 +2087,8 @@ function classifyRetrainReview(saved, origins, dismissed, opts = {}) {
 			ref: origin.ref,
 			status: "removed",
 			approximate: true,
+			macroClass: origin.macroClass,
+			...optLabel(origin.label),
 			origin
 		});
 	}
@@ -12655,8 +12666,23 @@ var BulkRecordSchema = zod.z.object({
 	data: zod.z.record(zod.z.string(), zod.z.unknown())
 });
 /**
+* 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.
+*/
+var DataStoreDatabaseSchema = zod.z.enum([
+	"settings",
+	"events",
+	"history"
+]);
+/** Every database file, in a stable order (settings first). */
+var DATA_STORE_DATABASES = DataStoreDatabaseSchema.options;
+/**
 * 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.
 */
 var TransactOpSchema = zod.z.discriminatedUnion("op", [
 	zod.z.object({
@@ -12674,6 +12700,12 @@ var TransactOpSchema = zod.z.discriminatedUnion("op", [
 		collection: zod.z.string(),
 		id: zod.z.string(),
 		data: zod.z.record(zod.z.string(), zod.z.unknown())
+	}),
+	zod.z.object({
+		op: zod.z.literal("upsertMany"),
+		collection: zod.z.string(),
+		conflict: zod.z.array(zod.z.string()).readonly(),
+		records: zod.z.array(BulkRecordSchema).readonly()
 	})
 ]);
 /**
@@ -12725,6 +12757,30 @@ var CollectionIndexSchema = zod.z.object({
 	unique: zod.z.boolean().optional()
 });
 /**
+* 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.
+*/
+var DeclareCollectionInputSchema = zod.z.object({
+	namespace: zod.z.string().optional(),
+	collection: zod.z.string(),
+	columns: zod.z.array(CollectionColumnSchema).readonly(),
+	indexes: zod.z.array(CollectionIndexSchema).readonly().optional(),
+	database: DataStoreDatabaseSchema.optional(),
+	primaryKey: zod.z.array(zod.z.string()).readonly().optional(),
+	withoutRowid: zod.z.boolean().optional()
+});
+/**
 * settings-store — singleton capability for addon-scoped persistence.
 *
 * Every method operates within a `collection`. An optional `namespace`
@@ -12862,6 +12918,29 @@ id: zod.z.union([zod.z.string(), zod.z.number()]) }), {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/**
+		* {@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.**
+		*/
+		upsertMany: require_sleep.method(zod.z.object({
+			namespace: zod.z.string().optional(),
+			collection: zod.z.string(),
+			conflict: zod.z.array(zod.z.string()).readonly(),
+			records: zod.z.array(BulkRecordSchema).readonly()
+		}), zod.z.object({ upserted: zod.z.number().int() }), {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		/** Insert a new record. */
 		insert: require_sleep.method(zod.z.object({
 			namespace: zod.z.string().optional(),
@@ -13060,12 +13139,7 @@ id: zod.z.union([zod.z.string(), zod.z.number()]) }), {
 		* `pipeline-analytics:object-events`) to avoid cross-addon
 		* clashes — no automatic prefix is added.
 		*/
-		declareCollection: require_sleep.method(zod.z.object({
-			namespace: zod.z.string().optional(),
-			collection: zod.z.string(),
-			columns: zod.z.array(CollectionColumnSchema).readonly(),
-			indexes: zod.z.array(CollectionIndexSchema).readonly().optional()
-		}), zod.z.void(), {
+		declareCollection: require_sleep.method(DeclareCollectionInputSchema, zod.z.void(), {
 			kind: "mutation",
 			auth: "admin"
 		})
@@ -13218,6 +13292,16 @@ id: zod.z.union([zod.z.string(), zod.z.number()]) }), {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/** Upsert many records in ONE transaction; see the door's `upsertMany`. */
+		upsertMany: require_sleep.method(zod.z.object({
+			namespace: zod.z.string().optional(),
+			collection: zod.z.string(),
+			conflict: zod.z.array(zod.z.string()).readonly(),
+			records: zod.z.array(BulkRecordSchema).readonly()
+		}), zod.z.object({ upserted: zod.z.number().int() }), {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		/** Insert many records in ONE transaction. All or nothing. */
 		insertMany: require_sleep.method(zod.z.object({
 			namespace: zod.z.string().optional(),
@@ -13310,12 +13394,7 @@ id: zod.z.union([zod.z.string(), zod.z.number()]) }), {
 			collection: zod.z.string()
 		}), zod.z.boolean(), { auth: "admin" }),
 		/** Declare a typed (SQL-backed) collection with columns + indexes. */
-		declareCollection: require_sleep.method(zod.z.object({
-			namespace: zod.z.string().optional(),
-			collection: zod.z.string(),
-			columns: zod.z.array(CollectionColumnSchema).readonly(),
-			indexes: zod.z.array(CollectionIndexSchema).readonly().optional()
-		}), zod.z.void(), {
+		declareCollection: require_sleep.method(DeclareCollectionInputSchema, zod.z.void(), {
 			kind: "mutation",
 			auth: "admin"
 		})
@@ -25972,6 +26051,9 @@ var RetrainBoxReviewSchema = zod.z.object({
 	/** The baseline was re-derived, not snapshotted (a pre-origin row). */
 	approximate: zod.z.boolean(),
 	origin: RetrainOriginSchema.optional(),
+	/** The class / label the box carries NOW (a removed box: its origin's). Absent on an older hub. */
+	macroClass: RetrainMacroClassSchema.optional(),
+	label: zod.z.string().optional(),
 	iou: zod.z.number().optional()
 });
 var RetrainFrameReviewSchema = zod.z.object({
@@ -56038,6 +56120,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"dataStoreProvider.upsertMany": {
+		capName: "data-store-provider",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"dayNight.getOptions": {
 		capName: "day-night",
 		capScope: "device",
@@ -60886,6 +60974,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"settingsStore.upsertMany": {
+		capName: "settings-store",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"smoke.getStatus": {
 		capName: "smoke",
 		capScope: "device",
@@ -71117,6 +71211,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),
@@ -80105,6 +80200,7 @@ exports.DATABASE_SNAPSHOT_PARTIAL_SUFFIX = DATABASE_SNAPSHOT_PARTIAL_SUFFIX;
 exports.DATABASE_SNAPSHOT_SUFFIX = DATABASE_SNAPSHOT_SUFFIX;
 exports.DATABASE_SNAPSHOT_TIMEOUT_MS = DATABASE_SNAPSHOT_TIMEOUT_MS;
 exports.DATAPLANE_SECRET_HEADER = require_sleep.DATAPLANE_SECRET_HEADER;
+exports.DATA_STORE_DATABASES = DATA_STORE_DATABASES;
 exports.DAYS_PER_WEEK = DAYS_PER_WEEK;
 exports.DAY_NAMES = DAY_NAMES;
 exports.DECLARED_DEVICE_SWEEP_LIMIT = DECLARED_DEVICE_SWEEP_LIMIT;
@@ -80164,6 +80260,7 @@ exports.DISPLAY_ICON_KEYS = DISPLAY_ICON_KEYS;
 exports.DISPLAY_ICON_OFFERED_KEYS = DISPLAY_ICON_OFFERED_KEYS;
 exports.DISPLAY_ICON_VOCABULARY = DISPLAY_ICON_VOCABULARY;
 exports.DOORBELL_RISE_DEBOUNCE_MS = DOORBELL_RISE_DEBOUNCE_MS;
+exports.DataStoreDatabaseSchema = DataStoreDatabaseSchema;
 exports.DataStoreEngineInfoSchema = EngineInfoSchema;
 exports.DatabaseSnapshotResultSchema = DatabaseSnapshotResultSchema;
 exports.DatabaseSnapshotTableSchema = DatabaseSnapshotTableSchema;
@@ -80172,6 +80269,7 @@ exports.DayNightModeSchema = DayNightModeSchema;
 exports.DayNightOptionsSchema = DayNightOptionsSchema;
 exports.DayNightSettingsPatchSchema = DayNightSettingsPatchSchema;
 exports.DayNightStatusSchema = DayNightStatusSchema;
+exports.DeclareCollectionInputSchema = DeclareCollectionInputSchema;
 exports.DeclaredDevices = DeclaredDevices;
 exports.DecodedAudioChunkSchema = require_sleep.DecodedAudioChunkSchema;
 exports.DeleteIntegrationResultSchema = DeleteIntegrationResultSchema;