@camstack/types 1.2.386 → 1.2.387

package/dist/interfaces/addon-data-plane.d.ts

@@ -40,9 +40,9 @@ export interface AddonDataPlane {
  *  transport in front of it (auth + reverse-proxy). */
 export type DataPlaneHandler = (req: IncomingMessage, res: ServerResponse) => void | Promise<void>;
 /**
- * The share-view scope kinds a `csv_*` share token can carry. The hub mints
- * and validates them (`share-token.service.ts` builds its enum from this
- * list); a data plane names the kinds it ACCEPTS in `share`.
+ * The share-view scope kinds a share-link token can carry. The hub mints
+ * and validates them (`ShareViewGrantSchema` builds its
+ * enum from this list); a data plane names the kinds it ACCEPTS in `share`.
  */
 export declare const SHARE_VIEW_KINDS: readonly ['grid-view', 'events-view'];
 export type ShareViewKind = (typeof SHARE_VIEW_KINDS)[number];
@@ -57,7 +57,7 @@ export interface AddonDataPlaneServeOptions {
     /** The addon's request handler — real `IncomingMessage`/`ServerResponse`. */
     readonly handler: DataPlaneHandler;
     /**
-     * Share-token scope kinds this plane serves. ABSENT means a `csv_*` share
+     * Share-token scope kinds this plane serves. ABSENT means a share-link
      * token is refused here (403), whatever `access` says: a share link is a
      * bearer credential for one view of a few devices, not a session, and a
      * plane that never read the scope headers would serve every device to it.

package/dist/interfaces/addon-peer-bytes.d.ts

@@ -9,7 +9,7 @@
  *
  * - the data-plane listener binds `127.0.0.1` behind a per-listener secret that
  *   **only the hub** presents, and the hub's `/addon/<id>/…` proxy in front of
- *   it takes a session cookie, a `cst_` token scoped `{type:'addon'}` or a JWT
+ *   it takes a session cookie, a token scoped `{type:'addon'}` or a JWT
  *   — an addon holds none of those;
  * - `ctx.api.<cap>.subscribe` is refused on an addon caller by design, so a
  *   streaming cap method is not available either;

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

@@ -22,7 +22,7 @@ import { DeviceType } from '../device/device-type.js';
  * `super_admin` — collapsed onto the single boolean because every
  * non-admin caller is governed by the same scope-check rules; the
  * distinction was only ever used to route role-specific procedures
- * which we no longer have. CLI / webhook integrations are `cst_*` tokens
+ * which we no longer have. CLI / webhook integrations are tokens (`auth.mintToken`)
  * with `isAdmin: false` + an explicit scope list.
  */
 /** Per-method access flavour. Materialised on every cap method via codegen. */

package/dist/schemas/user-preferences.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Per-user ACCOUNT preferences (D894): the hub-side half of the viewer's two
+ * settings levels.
+ *
+ *   - DEVICE settings never leave the phone.
+ *   - ACCOUNT settings live here: one row per `(user, namespace)`, private to
+ *     that user, synced across every device signed in as them, last write wins
+ *     unless the writer sends the revision it based its edit on.
+ *
+ * A setting lives in exactly ONE level; there are no overrides. The caller
+ * never names a user: the hub stamps the principal's own id, admin included.
+ *
+ * The contract the client codes against is the `preferences.*` tRPC router
+ * (`server/backend/src/api/core/preferences.router.ts`).
+ */
+import { z } from 'zod';
+/** `viewer.app`, `viewer.cameras`, `viewer.grids` … — lowercase, dot/dash separated. */
+export declare const PREFERENCES_NAMESPACE_PATTERN: RegExp;
+/** One row's value, measured as UTF-8 JSON. */
+export declare const PREFERENCES_MAX_VALUE_BYTES: number;
+/** Namespaces one user may hold. */
+export declare const PREFERENCES_MAX_NAMESPACES = 32;
+/** The opaque client id a writer stamps (`updatedByDevice`). */
+export declare const PREFERENCES_MAX_DEVICE_ID_LENGTH = 64;
+export declare const PreferenceNamespaceSchema: z.ZodString;
+export type PreferenceNamespace = z.infer<typeof PreferenceNamespaceSchema>;
+/** A namespace's value: a JSON object, opaque to the hub. */
+export declare const PreferenceValueSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type PreferenceValue = z.infer<typeof PreferenceValueSchema>;
+export declare const PreferenceDeviceIdSchema: z.ZodString;
+/** A stored row, as the owner reads it. */
+export declare const PreferenceRowSchema: z.ZodObject<{
+    namespace: z.ZodString;
+    value: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    revision: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    updatedByDevice: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type PreferenceRow = z.infer<typeof PreferenceRowSchema>;
+export declare const PreferencesGetInputSchema: z.ZodObject<{
+    namespaces: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type PreferencesGetInput = z.infer<typeof PreferencesGetInputSchema>;
+export declare const PreferencesGetOutputSchema: z.ZodObject<{
+    rows: z.ZodArray<z.ZodObject<{
+        namespace: z.ZodString;
+        value: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        revision: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+        updatedByDevice: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PreferencesGetOutput = z.infer<typeof PreferencesGetOutputSchema>;
+export declare const PreferencesPutInputSchema: z.ZodObject<{
+    namespace: z.ZodString;
+    value: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    baseRevision: z.ZodOptional<z.ZodNumber>;
+    deviceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PreferencesPutInput = z.infer<typeof PreferencesPutInputSchema>;
+export declare const PreferencesPutOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"saved">;
+    row: z.ZodObject<{
+        namespace: z.ZodString;
+        value: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        revision: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+        updatedByDevice: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"conflict">;
+    current: z.ZodNullable<z.ZodObject<{
+        namespace: z.ZodString;
+        value: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        revision: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+        updatedByDevice: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "status">;
+export type PreferencesPutOutput = z.infer<typeof PreferencesPutOutputSchema>;
+export declare const PreferencesDeleteInputSchema: z.ZodObject<{
+    namespace: z.ZodString;
+}, z.core.$strip>;
+export type PreferencesDeleteInput = z.infer<typeof PreferencesDeleteInputSchema>;
+export declare const PreferencesDeleteOutputSchema: z.ZodObject<{
+    deleted: z.ZodBoolean;
+}, z.core.$strip>;
+export type PreferencesDeleteOutput = z.infer<typeof PreferencesDeleteOutputSchema>;
+export declare const PreferencesChangedSinceInputSchema: z.ZodObject<{
+    revisionByNamespace: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, z.core.$strip>;
+export type PreferencesChangedSinceInput = z.infer<typeof PreferencesChangedSinceInputSchema>;
+export declare const PreferencesChangedSinceOutputSchema: z.ZodObject<{
+    rows: z.ZodArray<z.ZodObject<{
+        namespace: z.ZodString;
+        value: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        revision: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+        updatedByDevice: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    deleted: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type PreferencesChangedSinceOutput = z.infer<typeof PreferencesChangedSinceOutputSchema>;

package/dist/{sleep-BE7_6UnC.js → sleep-6sOPE0EV.js}

@@ -2804,9 +2804,9 @@ var DisposerChain = class {
 */
 var DATAPLANE_SECRET_HEADER = "x-camstack-dataplane-secret";
 /**
-* The share-view scope kinds a `csv_*` share token can carry. The hub mints
-* and validates them (`share-token.service.ts` builds its enum from this
-* list); a data plane names the kinds it ACCEPTS in `share`.
+* The share-view scope kinds a share-link token can carry. The hub mints
+* and validates them (`ShareViewGrantSchema` builds its
+* enum from this list); a data plane names the kinds it ACCEPTS in `share`.
 */
 var SHARE_VIEW_KINDS = ["grid-view", "events-view"];
 //#endregion
@@ -4203,6 +4203,20 @@ function parseSettingsArrayAdoptsFrom(from) {
 function isRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+/** RFC 7396: objects merge key by key, `null` removes, anything else replaces. */
+function mergePatch(target, patch) {
+	if (!isRecord(patch)) return target;
+	const out = { ...target };
+	for (const [key, value] of Object.entries(patch)) {
+		if (value === null) {
+			delete out[key];
+			continue;
+		}
+		const current = out[key];
+		out[key] = isRecord(value) && isRecord(current) ? mergePatch(current, value) : value;
+	}
+	return out;
+}
 function markersOf(decl, body) {
 	const out = /* @__PURE__ */ new Map();
 	mapSecretLeaves(body, decl.secretPaths, decl.secretArrayKeys, (leaf) => {
@@ -4384,7 +4398,20 @@ function makeInMemoryRecords(owner = "spec") {
 						releasedRefs: released
 					};
 				},
-				patch: async () => unimplemented("patch"),
+				patch: async ({ kind, id, data, at, ifRev }) => {
+					const prev = table(kind).get(id);
+					if (prev === void 0) throw new Error(`${kind}/${id}: no such record`);
+					if (ifRev !== void 0 && prev.rev !== ifRev) throw new Error("stale ifRev");
+					const { rev, released } = write(kind, {
+						id,
+						...at !== void 0 && at !== null ? { at } : prev.at !== null ? { at: prev.at } : {},
+						data: mergePatch(prev.data, data)
+					});
+					return {
+						rev,
+						releasedRefs: released
+					};
+				},
 				delete: async ({ kind, id }) => {
 					if (writesFail) throw new Error("records engine unreachable");
 					const row = table(kind).get(id);

package/dist/{sleep-BxjU_fJM.mjs → sleep-yKL5gfrH.mjs}

@@ -2804,9 +2804,9 @@ var DisposerChain = class {
 */
 var DATAPLANE_SECRET_HEADER = "x-camstack-dataplane-secret";
 /**
-* The share-view scope kinds a `csv_*` share token can carry. The hub mints
-* and validates them (`share-token.service.ts` builds its enum from this
-* list); a data plane names the kinds it ACCEPTS in `share`.
+* The share-view scope kinds a share-link token can carry. The hub mints
+* and validates them (`ShareViewGrantSchema` builds its
+* enum from this list); a data plane names the kinds it ACCEPTS in `share`.
 */
 var SHARE_VIEW_KINDS = ["grid-view", "events-view"];
 //#endregion
@@ -4203,6 +4203,20 @@ function parseSettingsArrayAdoptsFrom(from) {
 function isRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+/** RFC 7396: objects merge key by key, `null` removes, anything else replaces. */
+function mergePatch(target, patch) {
+	if (!isRecord(patch)) return target;
+	const out = { ...target };
+	for (const [key, value] of Object.entries(patch)) {
+		if (value === null) {
+			delete out[key];
+			continue;
+		}
+		const current = out[key];
+		out[key] = isRecord(value) && isRecord(current) ? mergePatch(current, value) : value;
+	}
+	return out;
+}
 function markersOf(decl, body) {
 	const out = /* @__PURE__ */ new Map();
 	mapSecretLeaves(body, decl.secretPaths, decl.secretArrayKeys, (leaf) => {
@@ -4384,7 +4398,20 @@ function makeInMemoryRecords(owner = "spec") {
 						releasedRefs: released
 					};
 				},
-				patch: async () => unimplemented("patch"),
+				patch: async ({ kind, id, data, at, ifRev }) => {
+					const prev = table(kind).get(id);
+					if (prev === void 0) throw new Error(`${kind}/${id}: no such record`);
+					if (ifRev !== void 0 && prev.rev !== ifRev) throw new Error("stale ifRev");
+					const { rev, released } = write(kind, {
+						id,
+						...at !== void 0 && at !== null ? { at } : prev.at !== null ? { at: prev.at } : {},
+						data: mergePatch(prev.data, data)
+					});
+					return {
+						rev,
+						releasedRefs: released
+					};
+				},
 				delete: async ({ kind, id }) => {
 					if (writesFail) throw new Error("records engine unreachable");
 					const row = table(kind).get(id);

package/package.json

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