@camstack/types 1.2.64 → 1.2.66

package/dist/capabilities/vibration.cap.d.ts

@@ -28,5 +28,15 @@ export declare const vibrationCapability: {
         detected: z.ZodBoolean;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — as `smoke`.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastChangedAt"];
 };
 export type IVibrationProvider = InferProvider<typeof vibrationCapability>;

package/dist/capabilities/water-heater.cap.d.ts

@@ -73,5 +73,12 @@ export declare const waterHeaterCapability: {
         maxTemp: z.ZodNullable<z.ZodNumber>;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — as `climate-control`.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IWaterHeaterProvider = InferProvider<typeof waterHeaterCapability>;

package/dist/capabilities/weather.cap.d.ts

@@ -71,5 +71,12 @@ export declare const weatherCapability: {
         windBearing: z.ZodNullable<z.ZodNumber>;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — a forecast is stale the moment the hub is down; the provider re-fetches on connect.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IWeatherProvider = InferProvider<typeof weatherCapability>;

package/dist/capabilities/zone-analytics.cap.d.ts

@@ -284,6 +284,13 @@ export declare const zoneAnalyticsCapability: {
             keyFrameMediaKey: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>>;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — per-frame analytics; with `audio-metrics` it is ~90 % of the offered write rate. Re-derived on the next frame.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IZoneAnalyticsProvider = InferProvider<typeof zoneAnalyticsCapability>;
 export { CameraOccupancySnapshotSchema as _CameraOccupancySnapshotSchema, StationaryObjectSchema, HistoryResolutionEnum, HistoryPointSchema, HistoryRangeSchema, ZoneScopeBreakdownSchema, PerScopeBreakdownSchema, };

package/dist/capabilities/zone-rules.cap.d.ts

@@ -149,5 +149,12 @@ export declare const zoneRulesCapability: {
             enabled: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>>;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — operator intent, mutation-only, same argument as `zones`.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
 };
 export type IZoneRulesProvider = InferProvider<typeof zoneRulesCapability>;

package/dist/capabilities/zones.cap.d.ts

@@ -146,5 +146,12 @@ export declare const zonesCapability: {
             color: z.ZodDefault<z.ZodString>;
         }, z.core.$strip>>>;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — written only on operator mutation, so a camera that never had one has nothing to re-derive from. This is the slice `zone-mirror-hydration.ts` exists to paper over.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
 };
 export type IZonesProvider = InferProvider<typeof zonesCapability>;

package/dist/generated/runtime-state-durability.d.ts

@@ -0,0 +1,31 @@
+import type { RuntimeStateDurability } from '../capabilities/capability-definition.js';
+/** The persistence policy one capability declares for its runtime-state slice. */
+export interface RuntimeStatePolicy {
+    /** `'restored'` slices reach disk; `'session'` slices stay in the RAM mirror. */
+    readonly durability: RuntimeStateDurability;
+    /**
+     * Clock fields — persisted, but ignored by the equality test that decides
+     * whether a write is worth a SQLite commit. Declared by the cap.
+     */
+    readonly volatileFields: readonly string[];
+}
+/**
+ * Per-cap runtime-state policy, projected from every `*.cap.ts` that declares
+ * `runtimeState`. 62 caps: 33 `restored`, 29 `session`.
+ *
+ * A cap absent from this map has no runtime-state slice at all. A cap PRESENT
+ * with `durability: 'session'` has one and has decided not to keep it.
+ */
+export declare const RUNTIME_STATE_POLICY: Readonly<Record<string, RuntimeStatePolicy>>;
+/**
+ * The policy for `capName`. An UNKNOWN cap resolves to `'session'` — an
+ * addon-private slice the codegen has never seen is not persisted until its
+ * capability says so, which is the safe direction: the cost of a lost session
+ * value is a cold window, the cost of an unasked-for persist is a commit per
+ * second on the fleet's busiest write path.
+ */
+export declare function runtimeStatePolicyFor(capName: string): RuntimeStatePolicy;
+/** True when this cap's slice is written to disk. */
+export declare function isRestoredCap(capName: string): boolean;
+/** Cap names whose slice survives a restart, sorted. */
+export declare const RESTORED_CAP_NAMES: readonly string[];

package/dist/index.d.ts

@@ -176,6 +176,8 @@ export { DEVICE_SCOPED_CAPS, isDeviceScopedCap } from './generated/device-scoped
 export type { MethodAccessRecord } from './generated/method-access-map.js';
 export { DEVICE_CAP_NAMES, KNOWN_CAP_NAMES, METHOD_ACCESS_MAP, SYSTEM_CAP_NAMES, } from './generated/method-access-map.js';
 export { CAP_PROVIDER_KIND_MAP, getCapsByProviderKind, PROVIDER_KIND_CAP_NAMES, } from './generated/provider-kind-map.js';
+export type { RuntimeStatePolicy } from './generated/runtime-state-durability.js';
+export { isRestoredCap, RESTORED_CAP_NAMES, RUNTIME_STATE_POLICY, runtimeStatePolicyFor, } from './generated/runtime-state-durability.js';
 export type { ScopePresetId, ScopePresetSpec } from './generated/scope-presets.js';
 export { SCOPE_PRESETS } from './generated/scope-presets.js';
 export type { SystemProxy } from './generated/system-proxy.js';
@@ -184,6 +186,7 @@ export type { AudioCodecInfo, AudioDecodeSessionConfig, AudioEncodedChunk, Audio
 export type { StreamQuality } from './interfaces/device-capabilities/camera.js';
 export { STREAM_QUALITY_LABELS, streamQualityLabel, } from './interfaces/device-capabilities/camera.js';
 export * from './lifecycle/index.js';
+export { audioIsFailClosed, audioLabelChoices, audioOrDefaults, isAudioLabelSelected, NC_AUDIO_DB_MAX, NC_AUDIO_DB_MIN, NC_AUDIO_DB_OFFERED, NC_AUDIO_DB_STEP, NC_AUDIO_DEFAULTS, NC_AUDIO_HIT_PERCENT_MAX, NC_AUDIO_HIT_PERCENT_MIN, NC_AUDIO_SAMPLING_MAX_SEC, NC_AUDIO_SAMPLING_MIN_SEC, type NcAudioLabelChoice, type NcAudioPatch, normalizeAudioLabel, patchAudio, toggleAudioLabel, } from './notification/audio-condition.js';
 export { isBaseConditionKey, knownValues, NC_BASE_CONDITION_KEYS, type NcBaseConditionKey, pickerForCondition, type TaxonomyGroup, type TaxonomyOption, type TaxonomyPicker, } from './notification/condition-taxonomy.js';
 export { type PreparedAction, type PreparedAttachment, type PreparedNotification, prepareNotification, type ResolvedLevel, } from './notification/degrade-engine.js';
 export { htmlToText, markdownToHtmlLite, markdownToText, type NotificationFormat as NotificationBodyFormat, resolveFormat, textToHtml, transcodeBody, } from './notification/format-transcode.js';
@@ -191,7 +194,7 @@ export { isScheduleActive } from './notification/schedule.js';
 export type { TimelapseCadencePair, TimelapsePreviewMode, TimelapseRule, TimelapseRuleInput, TimelapseRulePatch, TimelapseTemplate, } from './notification/timelapse-rule.js';
 export { assertTimelapseCadences, DEFAULT_TIMELAPSE_PREVIEW_TEXT, readTimelapseGeneratedAt, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleInputSchema, TimelapseRulePatchSchema, TimelapseRuleSchema, TimelapseTemplateSchema, } from './notification/timelapse-rule.js';
 export { DEFAULT_DETAIL_CROP_CONVENTION, DETAIL_CROP_PADDING_FIELD, DETAIL_CROP_PADDING_KEY, DETAIL_CROP_SECTION_ID, DETAIL_CROP_SQUARE_KEY, type DetailCropConvention, DetailCropConventionSchema, type DetailCropRect, deriveDetailCropRect, type HydratedSettingsSection, type HydratedSettingsView, pickDetailCropConvention, readDetailCropConvention, } from './pipeline/detail-crop.js';
-export { DEFAULT_NATIVE_LEASE_SETTINGS, NATIVE_LEASE_ACTIVITY_FIELD, NATIVE_LEASE_ACTIVITY_KEY, NATIVE_LEASE_ADMISSION_FIELD, NATIVE_LEASE_ADMISSION_KEY, NATIVE_LEASE_BUDGET_FIELD, NATIVE_LEASE_BUDGET_KEY, NATIVE_LEASE_SECTION_ID, NATIVE_LEASE_TTL_FIELD, NATIVE_LEASE_TTL_KEY, type NativeLeaseAdmission, NativeLeaseAdmissionSchema, type NativeLeaseKnob, type NativeLeaseNumberKnob, type NativeLeaseSettings, type NativeLeaseSettingsOverride, NativeLeaseSettingsSchema, pickNativeLeaseOverride, readNativeLeaseOverride, } from './pipeline/native-lease.js';
+export { DEFAULT_NATIVE_LEASE_SETTINGS, NATIVE_LEASE_ACTIVITY_FIELD, NATIVE_LEASE_ACTIVITY_KEY, NATIVE_LEASE_ADMISSION_FIELD, NATIVE_LEASE_ADMISSION_KEY, NATIVE_LEASE_BUDGET_FIELD, NATIVE_LEASE_BUDGET_KEY, NATIVE_LEASE_HOLD_FIELD, NATIVE_LEASE_HOLD_KEY, NATIVE_LEASE_SECTION_ID, NATIVE_LEASE_TILE_BUDGET_FIELD, NATIVE_LEASE_TILE_BUDGET_KEY, type NativeLeaseAdmission, NativeLeaseAdmissionSchema, type NativeLeaseKnob, type NativeLeaseNumberKnob, type NativeLeaseSettings, type NativeLeaseSettingsOverride, NativeLeaseSettingsSchema, pickNativeLeaseOverride, readNativeLeaseOverride, } from './pipeline/native-lease.js';
 export { type ApiKeyRecord, ApiKeyRecordSchema, type CapScope, CapScopeSchema, type MethodAccess, MethodAccessSchema, type ScopedToken, ScopedTokenSchema, type TokenScope, TokenScopeSchema, type UserRecord, UserRecordSchema, } from './schemas/auth-records.js';
 export type { CameraDetectionCapabilities, CameraMotionConfig, CameraNativeDetectionConfig, } from './types/camera-detection.js';
 export { DEVICE_TYPE_INFO, type DeviceTypeInfo } from './types/device-type.js';