@camstack/types 1.2.105 → 1.2.107

package/dist/interfaces/recording-config.d.ts

@@ -38,8 +38,8 @@ export type RecordingWeekday = z.infer<typeof RecordingWeekdaySchema>;
  * every save (`activeModeForConfig`). Writing it has no effect.
  */
 export declare const RecordingStorageModeSchema: z.ZodEnum<{
-    events: "events";
     off: "off";
+    events: "events";
     continuous: "continuous";
 }>;
 export type RecordingStorageMode = z.infer<typeof RecordingStorageModeSchema>;
@@ -161,53 +161,6 @@ export declare const RecordingRetentionSchema: z.ZodObject<{
     maxSizeGb: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type RecordingRetention = z.infer<typeof RecordingRetentionSchema>;
-/**
- * Scrub-thumbnail fidelity preset — the single per-camera selector bundling the
- * sprite tile RESOLUTION + JPEG QUALITY the recorder packs timeline-scrub
- * previews at. Five graduated steps; absent on a config = `standard` (the
- * shipped default, matching `sheet-geometry`/`sheet-composer`).
- *
- * Existing sheets are IMMUTABLE — a changed preset applies to NEW windows only.
- * Each window's index sidecar carries its own tile dims, so a camera whose
- * preset changed over time renders every historical window at the dims it was
- * written with.
- */
-export declare const ScrubThumbnailPresetSchema: z.ZodEnum<{
-    high: "high";
-    low: "low";
-    max: "max";
-    standard: "standard";
-    minimal: "minimal";
-}>;
-export type ScrubThumbnailPreset = z.infer<typeof ScrubThumbnailPresetSchema>;
-/** Resolved sprite geometry + encode quality for a scrub-thumbnail preset. */
-export interface ScrubThumbnailGeometry {
-    /** Tile width in px (16:9). */
-    readonly tileWidth: number;
-    /** Tile height in px (16:9). */
-    readonly tileHeight: number;
-    /** Sheet JPEG quality, 1..100 (higher = better). */
-    readonly quality: number;
-}
-/** The default preset when a config omits `scrubThumbnails`. */
-export declare const DEFAULT_SCRUB_THUMBNAIL_PRESET: ScrubThumbnailPreset;
-/**
- * Preset → tile geometry + JPEG quality. Every step is 16:9; the graduated
- * ladder trades sheet size (and remote fetch cost) for scrub crispness.
- * `standard` matches the shipped `sheet-geometry`/`sheet-composer` defaults
- * (480×270 q72), so an unset config is byte-identical to today. The map is
- * strictly monotone in resolution AND quality across the ordered steps.
- */
-export declare const SCRUB_THUMBNAIL_PRESETS: Record<ScrubThumbnailPreset, ScrubThumbnailGeometry>;
-/** Human labels for each preset (resolution-tagged), for settings UIs. */
-export declare const SCRUB_THUMBNAIL_PRESET_LABELS: Record<ScrubThumbnailPreset, string>;
-/** Ordered low→high so a UI can render the ladder in graduated order. */
-export declare const SCRUB_THUMBNAIL_PRESET_ORDER: readonly ScrubThumbnailPreset[];
-/**
- * Resolve the geometry for a recording config's scrub-thumbnail preset,
- * defaulting to `standard` when unset. Pure — no I/O.
- */
-export declare function resolveScrubThumbnailGeometry(preset: ScrubThumbnailPreset | undefined): ScrubThumbnailGeometry;
 /**
  * The full per-camera recording intent — the wire shape of a RecordingTarget.
  *
@@ -216,15 +169,19 @@ export declare function resolveScrubThumbnailGeometry(preset: ScrubThumbnailPres
  * other field is a storage knob (profiles, segment length, retention, scrub).
  *
  * STRICT on purpose: the legacy authoring surface (`schedule`/`schedules`/
- * `triggers`/`preBufferSec`/`postBufferSec`/`rules`) was retired 2026-07-30.
+ * `triggers`/`preBufferSec`/`postBufferSec`/`rules`) was retired 2026-07-30,
+ * and `scrubThumbnails` — a five-step fidelity knob for a sprite tier that was
+ * deleted on 2026-07-24 and had ZERO consumers in the recorder — on 2026-08-25
+ * (D62: a switch that writes a store nobody reads is worse than no switch).
+ * Stored rows keep loading: the READ schema is `.strip()` (config-store.ts).
  * A stale caller must fail loudly — silently stripping its legacy intent would
  * persist a band-less config, i.e. silently stop recording the camera.
  */
 export declare const RecordingConfigSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
     mode: z.ZodOptional<z.ZodEnum<{
-        events: "events";
         off: "off";
+        events: "events";
         continuous: "continuous";
     }>>;
     profiles: z.ZodOptional<z.ZodArray<z.ZodEnum<{
@@ -252,13 +209,6 @@ export declare const RecordingConfigSchema: z.ZodObject<{
         maxAgeDays: z.ZodOptional<z.ZodNumber>;
         maxSizeGb: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
-    scrubThumbnails: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        low: "low";
-        max: "max";
-        standard: "standard";
-        minimal: "minimal";
-    }>>;
 }, z.core.$strict>;
 export type RecordingConfig = z.infer<typeof RecordingConfigSchema>;
 /** The bands + enabled flag a mode is derived from — all {@link deriveRecordingMode} reads. */

package/dist/interfaces/relocate.d.ts

@@ -16,20 +16,20 @@ import { z } from 'zod';
  * runs at all.
  */
 export declare const RelocateJobStateSchema: z.ZodEnum<{
+    running: "running";
     queued: "queued";
     done: "done";
     failed: "failed";
-    running: "running";
     cancelled: "cancelled";
 }>;
 export type RelocateJobState = z.infer<typeof RelocateJobStateSchema>;
 export declare const RelocateJobSchema: z.ZodObject<{
     jobId: z.ZodString;
     state: z.ZodEnum<{
+        running: "running";
         queued: "queued";
         done: "done";
         failed: "failed";
-        running: "running";
         cancelled: "cancelled";
     }>;
     fromLocationId: z.ZodString;
@@ -162,10 +162,10 @@ export declare const StorageMigrationMoveSchema: z.ZodObject<{
     toLocationId: z.ZodString;
     moverJobId: z.ZodNullable<z.ZodString>;
     state: z.ZodNullable<z.ZodEnum<{
+        running: "running";
         queued: "queued";
         done: "done";
         failed: "failed";
-        running: "running";
         cancelled: "cancelled";
     }>>;
     error: z.ZodNullable<z.ZodString>;
@@ -201,10 +201,10 @@ export declare const StorageMigrationJobSchema: z.ZodObject<{
         toLocationId: z.ZodString;
         moverJobId: z.ZodNullable<z.ZodString>;
         state: z.ZodNullable<z.ZodEnum<{
+            running: "running";
             queued: "queued";
             done: "done";
             failed: "failed";
-            running: "running";
             cancelled: "cancelled";
         }>>;
         error: z.ZodNullable<z.ZodString>;

package/dist/interfaces/storage.d.ts

@@ -65,6 +65,29 @@ export interface SettingsQueryInput {
     readonly namespace?: string;
     readonly collection: SettingsCollection;
     readonly filter?: QueryFilter;
+    /**
+     * Read ONLY these columns (plus the primary key, always). Omit for the whole
+     * row.
+     *
+     * A projection, not a predicate — which is why it sits here and not inside
+     * {@link QueryFilter}. `count` and `histogram` take a filter and answer a
+     * scalar; a column list inside the filter would be a field they could only
+     * ignore, and a filter object shared between `query` and `count` (the
+     * notification-centre artefact index does exactly that) would carry it into
+     * both. This repo has already paid for one silently-ignored filter field.
+     *
+     * **The engine REFUSES a name it cannot serve.** Not a column of the
+     * collection, or a collection whose row is a single JSON blob, and the call
+     * throws. The alternative — skipping it, the way an unresolvable PREDICATE is
+     * skipped — would hand back a record whose missing key is indistinguishable
+     * from a NULL in the database, and the caller cannot tell "I did not read it"
+     * from "it is not there". A predicate that over-matches returns extra rows; a
+     * projection that under-reads returns wrong VALUES.
+     *
+     * The returned `data` therefore contains exactly these keys and the primary
+     * key — absent means NOT READ, and every absent key was asked to be absent.
+     */
+    readonly columns?: readonly string[];
 }
 export interface SettingsInsertInput<T extends object = Record<string, unknown>> {
     readonly namespace?: string;

package/dist/lifecycle/job.d.ts

@@ -91,17 +91,17 @@ export declare const lifecycleTaskSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type LifecycleTask = z.infer<typeof lifecycleTaskSchema>;
 export declare const lifecycleJobStateSchema: z.ZodEnum<{
-    failed: "failed";
     running: "running";
+    failed: "failed";
     completed: "completed";
     "partially-failed": "partially-failed";
     cancelled: "cancelled";
 }>;
 export type LifecycleJobState = z.infer<typeof lifecycleJobStateSchema>;
 export declare const lifecycleJobScopeSchema: z.ZodEnum<{
+    cluster: "cluster";
     single: "single";
     bulk: "bulk";
-    cluster: "cluster";
 }>;
 export type LifecycleJobScope = z.infer<typeof lifecycleJobScopeSchema>;
 export declare const lifecycleJobSchema: z.ZodObject<{
@@ -115,9 +115,9 @@ export declare const lifecycleJobSchema: z.ZodObject<{
     createdAtMs: z.ZodNumber;
     createdBy: z.ZodString;
     scope: z.ZodEnum<{
+        cluster: "cluster";
         single: "single";
         bulk: "bulk";
-        cluster: "cluster";
     }>;
     tasks: z.ZodArray<z.ZodObject<{
         taskId: z.ZodString;
@@ -166,8 +166,8 @@ export declare const lifecycleJobSchema: z.ZodObject<{
         finishedAtMs: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>>;
     state: z.ZodEnum<{
-        failed: "failed";
         running: "running";
+        failed: "failed";
         completed: "completed";
         "partially-failed": "partially-failed";
         cancelled: "cancelled";

package/dist/schemas/auth-records.d.ts

@@ -34,8 +34,8 @@ export declare const MethodAccessSchema: z.ZodEnum<{
 }>;
 export type MethodAccess = z.infer<typeof MethodAccessSchema>;
 export declare const CapScopeSchema: z.ZodEnum<{
-    system: "system";
     device: "device";
+    system: "system";
 }>;
 export type CapScope = z.infer<typeof CapScopeSchema>;
 /**
@@ -96,8 +96,8 @@ declare const DeviceTokenScopeSchema: z.ZodObject<{
 export declare const TokenScopeSchema: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"category">;
     target: z.ZodEnum<{
-        system: "system";
         device: "device";
+        system: "system";
     }>;
     access: z.ZodArray<z.ZodEnum<{
         view: "view";
@@ -154,8 +154,8 @@ export declare const UserRecordSchema: z.ZodObject<{
     scopes: z.ZodDefault<z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"category">;
         target: z.ZodEnum<{
-            system: "system";
             device: "device";
+            system: "system";
         }>;
         access: z.ZodArray<z.ZodEnum<{
             view: "view";
@@ -224,8 +224,8 @@ export declare const ScopedTokenSchema: z.ZodObject<{
     scopes: z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"category">;
         target: z.ZodEnum<{
-            system: "system";
             device: "device";
+            system: "system";
         }>;
         access: z.ZodArray<z.ZodEnum<{
             view: "view";

package/dist/types/models.d.ts

@@ -121,8 +121,8 @@ export declare const ModelVariantGroupSchema: z.ZodObject<{
         int8: "int8";
     }>>;
     optimization: z.ZodOptional<z.ZodEnum<{
-        fast: "fast";
         standard: "standard";
+        fast: "fast";
     }>>;
     resolution: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -236,9 +236,9 @@ export declare const ModelCatalogEntrySchema: z.ZodObject<{
         nhwc: "nhwc";
     }>>;
     inputNormalization: z.ZodOptional<z.ZodEnum<{
-        none: "none";
         "zero-one": "zero-one";
         imagenet: "imagenet";
+        none: "none";
     }>>;
     outputProbabilities: z.ZodOptional<z.ZodBoolean>;
     preprocessMode: z.ZodOptional<z.ZodEnum<{
@@ -266,8 +266,8 @@ export declare const ModelCatalogEntrySchema: z.ZodObject<{
             int8: "int8";
         }>>;
         optimization: z.ZodOptional<z.ZodEnum<{
-            fast: "fast";
             standard: "standard";
+            fast: "fast";
         }>>;
         resolution: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
@@ -351,19 +351,19 @@ export declare const ModelConvertMetadataSchema: z.ZodObject<{
         nhwc: "nhwc";
     }>>;
     inputNormalization: z.ZodOptional<z.ZodEnum<{
-        none: "none";
         "zero-one": "zero-one";
         imagenet: "imagenet";
+        none: "none";
     }>>;
     preprocessMode: z.ZodOptional<z.ZodEnum<{
         letterbox: "letterbox";
         resize: "resize";
     }>>;
     outputFormat: z.ZodEnum<{
-        classification: "classification";
         yolo: "yolo";
         ssd: "ssd";
         embedding: "embedding";
+        classification: "classification";
         ocr: "ocr";
         segmentation: "segmentation";
     }>;
@@ -481,9 +481,9 @@ export declare const ConvertResultSchema: z.ZodObject<{
             nhwc: "nhwc";
         }>>;
         inputNormalization: z.ZodOptional<z.ZodEnum<{
-            none: "none";
             "zero-one": "zero-one";
             imagenet: "imagenet";
+            none: "none";
         }>>;
         outputProbabilities: z.ZodOptional<z.ZodBoolean>;
         preprocessMode: z.ZodOptional<z.ZodEnum<{
@@ -511,8 +511,8 @@ export declare const ConvertResultSchema: z.ZodObject<{
                 int8: "int8";
             }>>;
             optimization: z.ZodOptional<z.ZodEnum<{
-                fast: "fast";
                 standard: "standard";
+                fast: "fast";
             }>>;
             resolution: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.105",
+  "version": "1.2.107",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",