@camstack/types 1.2.276 → 1.2.277

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-WOeeZ4FU.js");
+const require_sleep = require("./sleep-DCbD8sdg.js");
 const require_event_category = require("./event-category-MbnB-6AN.js");
 const require_composition = require("./composition-DG4jVTfB.js");
 const require_err_msg = require("./err-msg-Dx2Kor0g.js");
@@ -2002,6 +2002,98 @@ var ArchivedDebugNoteQueryInputSchema = zod.z.object({
 	limit: zod.z.number().int().min(1).max(1e3).optional()
 });
 //#endregion
+//#region src/interfaces/track-relations.ts
+/**
+* Ground truth for the tracking bench, as debug marks (D681, spec §4).
+*
+* Identity over live tracks, not boxes: "A and B are the same subject",
+* "A and B are different subjects", and one track's purity ("mixed" — two
+* subjects, optionally switching at an instant — or "not a subject"). Rows
+* reference tracks as PROVENANCE: they outlive the tracks by design.
+*
+* Bounded by COUNT, never by age (the D405 argument): ground truth is most
+* valuable when it is old enough for the pattern to have repeated.
+*/
+var MAX_TRACK_RELATIONS = 2e4;
+var MAX_TRACK_PURITIES = 5e3;
+var TRACK_RELATIONS_DEFAULT_LIMIT = 500;
+var TrackRelationKindSchema = zod.z.enum(["same-subject", "different-subjects"]);
+var TrackSideSchema = zod.z.enum(["before", "after"]);
+var TrackPurityValueSchema = zod.z.enum(["mixed", "not-a-subject"]);
+var TrackRelationSchema = zod.z.object({
+	id: zod.z.string(),
+	deviceId: zod.z.number().int(),
+	leftTrackId: zod.z.string(),
+	rightTrackId: zod.z.string(),
+	leftSide: TrackSideSchema.nullable(),
+	rightSide: TrackSideSchema.nullable(),
+	relation: TrackRelationKindSchema,
+	presence: zod.z.literal("continuous").nullable(),
+	leftStartedAt: zod.z.number().int().nullable(),
+	rightStartedAt: zod.z.number().int().nullable(),
+	createdAt: zod.z.number().int(),
+	updatedAt: zod.z.number().int(),
+	author: zod.z.string().nullable()
+});
+var TrackPuritySchema = zod.z.object({
+	id: zod.z.string(),
+	deviceId: zod.z.number().int(),
+	sourceTrackId: zod.z.string(),
+	purity: TrackPurityValueSchema,
+	switchAtMs: zod.z.number().int().nullable(),
+	startedAt: zod.z.number().int().nullable(),
+	createdAt: zod.z.number().int(),
+	updatedAt: zod.z.number().int(),
+	author: zod.z.string().nullable()
+});
+var SetTrackRelationInputSchema = zod.z.object({
+	deviceId: zod.z.number().int(),
+	trackId: zod.z.string().min(1),
+	otherTrackId: zod.z.string().min(1),
+	relation: TrackRelationKindSchema,
+	presence: zod.z.literal("continuous").optional(),
+	trackSide: TrackSideSchema.optional(),
+	otherSide: TrackSideSchema.optional()
+});
+var ClearTrackRelationInputSchema = zod.z.object({
+	deviceId: zod.z.number().int(),
+	trackId: zod.z.string().min(1),
+	otherTrackId: zod.z.string().min(1)
+});
+var ClearTrackRelationResultSchema = zod.z.object({ cleared: zod.z.boolean() });
+var SetTrackPurityInputSchema = zod.z.object({
+	deviceId: zod.z.number().int(),
+	trackId: zod.z.string().min(1),
+	purity: zod.z.enum([
+		"pure",
+		"mixed",
+		"not-a-subject"
+	]),
+	switchAtMs: zod.z.number().int().optional()
+});
+/** `null` when `pure` cleared the row. */
+var SetTrackPurityResultSchema = zod.z.object({ purity: TrackPuritySchema.nullable() });
+var ListTrackRelationsInputSchema = zod.z.object({
+	deviceId: zod.z.number().int(),
+	trackId: zod.z.string().optional(),
+	since: zod.z.number().int().optional(),
+	until: zod.z.number().int().optional(),
+	limit: zod.z.number().int().min(1).max(5e3).optional()
+});
+var ListTrackRelationsResultSchema = zod.z.object({
+	relations: zod.z.array(TrackRelationSchema).readonly(),
+	purities: zod.z.array(TrackPuritySchema).readonly(),
+	truncated: zod.z.boolean()
+});
+var TrackRelationRefusalSchema = zod.z.enum([
+	"unknown-track",
+	"cross-device",
+	"self-relation",
+	"contradiction",
+	"switch-outside-track",
+	"switch-needs-mixed"
+]);
+//#endregion
 //#region src/interfaces/device-capabilities/camera.ts
 /** Friendly display labels for stream quality IDs. */
 var STREAM_QUALITY_LABELS = {
@@ -24014,6 +24106,25 @@ var pipelineAnalyticsCapability = {
 		*/
 		listArchivedDebugNotes: require_sleep.method(ArchivedDebugNoteQueryInputSchema, zod.z.array(ArchivedDebugNoteSchema).readonly(), { kind: "query" }),
 		/**
+		* Tracking-bench ground truth (D681): "this track and that one are the
+		* same subject" / "different subjects". One row per unordered pair —
+		* re-marking replaces it — and a mark that contradicts an existing chain
+		* is REFUSED with the chain named. Writing a mark also sets `debug` on
+		* both tracks. `protected`, matching `setTrackFlags`: marking is done from
+		* the viewer's track detail by an authenticated non-admin session.
+		*/
+		setTrackRelation: require_sleep.method(SetTrackRelationInputSchema, TrackRelationSchema, { kind: "mutation" }),
+		/** Remove the mark between two tracks. */
+		clearTrackRelation: require_sleep.method(ClearTrackRelationInputSchema, ClearTrackRelationResultSchema, { kind: "mutation" }),
+		/**
+		* A track that is not ONE subject: `mixed` (two subjects, optionally
+		* switching at `switchAtMs`) or `not-a-subject`. `pure` clears the mark
+		* and answers `{ purity: null }` (D681).
+		*/
+		setTrackPurity: require_sleep.method(SetTrackPurityInputSchema, SetTrackPurityResultSchema, { kind: "mutation" }),
+		/** A camera's marks, optionally one track's, windowed by track start. */
+		listTrackRelations: require_sleep.method(ListTrackRelationsInputSchema, ListTrackRelationsResultSchema, { kind: "query" }),
+		/**
 		* Birth decisions — one row per resolved confirmation-gate verdict (D409).
 		*
 		* The READ half of a measurement, and only that: it gates nothing and no
@@ -56317,6 +56428,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineAnalytics.clearTrackRelation": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "delete"
+	},
 	"pipelineAnalytics.clearTracks": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -56569,6 +56686,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.listTrackRelations": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.listTracks": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -56683,6 +56806,18 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineAnalytics.setTrackPurity": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"pipelineAnalytics.setTrackRelation": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineAnalytics.startStorageMigrationMove": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -60938,6 +61073,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"pipelineAnalytics.clearTrackRelation": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"pipelineAnalytics.clearTracks": [{
 		name: "deviceId",
 		form: "single",
@@ -61088,6 +61228,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"pipelineAnalytics.listTrackRelations": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"pipelineAnalytics.listTracks": [{
 		name: "deviceId",
 		form: "single",
@@ -61158,6 +61303,16 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"pipelineAnalytics.setTrackPurity": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"pipelineAnalytics.setTrackRelation": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"pipelineAnalytics.wipeAllAnalytics": [{
 		name: "deviceId",
 		form: "single",
@@ -68769,6 +68924,8 @@ exports.CarbonMonoxideStatusSchema = CarbonMonoxideStatusSchema;
 exports.ChargingStatus = require_err_msg.ChargingStatus;
 exports.ClaimOutcomeSchema = ClaimOutcomeSchema;
 exports.ClaimsListingSchema = ClaimsListingSchema;
+exports.ClearTrackRelationInputSchema = ClearTrackRelationInputSchema;
+exports.ClearTrackRelationResultSchema = ClearTrackRelationResultSchema;
 exports.ClientNetworkStatsSchema = ClientNetworkStatsSchema;
 exports.ClimateControlStatusSchema = ClimateControlStatusSchema;
 exports.ClipBytesOfferSchema = ClipBytesOfferSchema;
@@ -69142,6 +69299,8 @@ exports.LegacyStorageLocationDefaultSchema = LegacyStorageLocationDefaultSchema;
 exports.LinkedDeviceSchema = LinkedDeviceSchema;
 exports.LinkedDevicesModeSchema = LinkedDevicesModeSchema;
 exports.LinkedDevicesSlotValueSchema = LinkedDevicesSlotValueSchema;
+exports.ListTrackRelationsInputSchema = ListTrackRelationsInputSchema;
+exports.ListTrackRelationsResultSchema = ListTrackRelationsResultSchema;
 exports.LlmDefaultSchema = LlmDefaultSchema;
 exports.LlmDefaultSelectorSchema = LlmDefaultSelectorSchema;
 exports.LlmDownloadProgressSchema = LlmDownloadProgressSchema;
@@ -69217,6 +69376,8 @@ exports.MAX_KEYS = MAX_KEYS;
 exports.MAX_REASONS_PER_KEY = MAX_REASONS_PER_KEY;
 exports.MAX_SENSOR_TRIGGER_DEVICES = MAX_SENSOR_TRIGGER_DEVICES;
 exports.MAX_TRACK_DEBUG_NOTE_LEN = MAX_TRACK_DEBUG_NOTE_LEN;
+exports.MAX_TRACK_PURITIES = MAX_TRACK_PURITIES;
+exports.MAX_TRACK_RELATIONS = MAX_TRACK_RELATIONS;
 exports.MEDIA_OWNER_TYPES = MEDIA_OWNER_TYPES;
 exports.MEDIA_PRESENCE_OWNER_KINDS = MEDIA_PRESENCE_OWNER_KINDS;
 exports.METHOD_ACCESS_MAP = METHOD_ACCESS_MAP;
@@ -69731,6 +69892,9 @@ exports.ServerUpdateStateSchema = ServerUpdateStateSchema;
 exports.SetCameraSensorsInputSchema = SetCameraSensorsInputSchema;
 exports.SetLoggingSettingsInputSchema = SetLoggingSettingsInputSchema;
 exports.SetSiteLocationInputSchema = SetSiteLocationInputSchema;
+exports.SetTrackPurityInputSchema = SetTrackPurityInputSchema;
+exports.SetTrackPurityResultSchema = SetTrackPurityResultSchema;
+exports.SetTrackRelationInputSchema = SetTrackRelationInputSchema;
 exports.SettingsPatchSchema = SettingsPatchSchema;
 exports.SettingsRecordSchema = SettingsRecordSchema;
 exports.SettingsSchemaWithValuesSchema = SettingsSchemaWithValuesSchema;
@@ -69815,6 +69979,7 @@ exports.SystemMirror = SystemMirror;
 exports.TAXONOMY_COLORS = TAXONOMY_COLORS;
 exports.TIMELAPSE_DENSE_FLOOR_SEC = TIMELAPSE_DENSE_FLOOR_SEC;
 exports.TIMEZONES = TIMEZONES;
+exports.TRACK_RELATIONS_DEFAULT_LIMIT = TRACK_RELATIONS_DEFAULT_LIMIT;
 exports.TRANSCODE_DOWN_MAX_BITRATE_KBPS = TRANSCODE_DOWN_MAX_BITRATE_KBPS;
 exports.TRANSCODE_DOWN_MAX_HEIGHT = TRANSCODE_DOWN_MAX_HEIGHT;
 exports.TamperStatusSchema = TamperStatusSchema;
@@ -69847,7 +70012,13 @@ exports.TrackEnvelopeSchema = TrackEnvelopeSchema;
 exports.TrackFlagsPatchSchema = TrackFlagsPatchSchema;
 exports.TrackFlagsSchema = TrackFlagsSchema;
 exports.TrackProjectionSchema = TrackProjectionSchema;
+exports.TrackPuritySchema = TrackPuritySchema;
+exports.TrackPurityValueSchema = TrackPurityValueSchema;
+exports.TrackRelationKindSchema = TrackRelationKindSchema;
+exports.TrackRelationRefusalSchema = TrackRelationRefusalSchema;
+exports.TrackRelationSchema = TrackRelationSchema;
 exports.TrackSchema = TrackSchema;
+exports.TrackSideSchema = TrackSideSchema;
 exports.TrackSourceSchema = TrackSourceSchema;
 exports.TrackStateSchema = TrackStateSchema;
 exports.TrackZoneFilterSchema = TrackZoneFilterSchema;