@camstack/system 1.2.330 → 1.2.331

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-Bx4zxM9N.js");
+const require_dist = require("./dist-DRUzy1SF.js");
 const require_builtins_alerts_alerts_addon = require("./builtins/alerts/alerts.addon.js");
 require("./builtins/alerts/index.js");
 const require_builtins_composer_composer_addon = require("./builtins/composer/composer.addon.js");
@@ -29,7 +29,7 @@ require("./builtins/system-config/index.js");
 const require_builtins_winston_logging_index = require("./builtins/winston-logging/index.js");
 const require_event_loop_stall_monitor = require("./event-loop-stall-monitor-ey4mbofz.js");
 const require_tls$1 = require("./tls-D_wUeOTD.js");
-const require_child_cap_dispatch = require("./child-cap-dispatch-C8uts1P4.js");
+const require_child_cap_dispatch = require("./child-cap-dispatch-93MfsaZL.js");
 const require_resource_monitor = require("./resource-monitor-DzNn_IZK.js");
 const require_custom_action_registry = require("./custom-action-registry-acBY3mHA.js");
 let zod = require("zod");

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { a as __toCommonJS, i as __require, n as __esmMin, o as __toESM$1, r as __exportAll, t as __commonJSMin$1 } from "./chunk-CNf5ZN-e.mjs";
-import { $n as DEVICE_SETTINGS_CONTRIBUTION_METHODS, C as LOG_LEVEL_RANK, E as METHOD_ACCESS_MAP, H as addonSettingsCapability, Ht as lifecycleJobSchema, It as isObjectInput, Kt as logLevelAtMost, Nt as isArrayOutputSchema, Ot as extractNestedAddonId, Pt as isCollectionArrayMethod, Qn as DATAPLANE_SECRET_HEADER$1, Rt as isVoidInput, Sr as EventCategory$1, Xn as errMsg$1, _r as readinessKey, ar as asNumber, cr as emitDownForOwnedCaps, er as DEVICE_STATUS_METHOD, fn as resolveMethodAuth, gr as parseJsonUnknown, hn as scopesAllowDeviceCap, hr as parseJsonObject, ir as asJsonObject$1, j as RUNTIME_DEFAULTS, mn as scopesAllowAddon, nn as objectInputDeclaresRequiredDeviceId, nr as ReadinessTimeoutError, on as procedureAuthKey, or as asString$1, qt as looseSchema, sr as createEvent, t as ALL_CAPABILITY_DEFINITIONS, tn as objectInputDeclaresAddonId, tr as ReadinessRegistry, ur as expandCapMethods, vr as resolveCapMount, yr as scopeKey, zt as kebabToCamel } from "./dist-Dp043AI0.mjs";
+import { $n as createEvent, At as isArrayOutputSchema, C as LOG_LEVEL_RANK, E as METHOD_ACCESS_MAP, Ft as kebabToCamel, Gn as DEVICE_SETTINGS_CONTRIBUTION_METHODS, H as addonSettingsCapability, Hn as errMsg$1, Ht as logLevelAtMost, Jn as ReadinessTimeoutError, Kn as DEVICE_STATUS_METHOD, Nt as isObjectInput, Pt as isVoidInput, Qn as asString$1, Qt as objectInputDeclaresRequiredDeviceId, Rt as lifecycleJobSchema, Tt as extractNestedAddonId, Ut as looseSchema, Wn as DATAPLANE_SECRET_HEADER$1, Xn as asJsonObject$1, Zn as asNumber, Zt as objectInputDeclaresAddonId, cn as resolveMethodAuth, cr as parseJsonUnknown, dn as scopesAllowDeviceCap, dr as scopeKey, er as emitDownForOwnedCaps, j as RUNTIME_DEFAULTS, jt as isCollectionArrayMethod, lr as readinessKey, mr as EventCategory$1, nn as procedureAuthKey, nr as expandCapMethods, qn as ReadinessRegistry, sr as parseJsonObject, t as ALL_CAPABILITY_DEFINITIONS, un as scopesAllowAddon, ur as resolveCapMount } from "./dist-CoG8lY6H.mjs";
 import { AlertCenterAddon } from "./builtins/alerts/alerts.addon.mjs";
 import "./builtins/alerts/index.mjs";
 import { ComposerAddon } from "./builtins/composer/composer.addon.mjs";
@@ -28,7 +28,7 @@ import "./builtins/system-config/index.mjs";
 import { WinstonDestination, WinstonLoggingAddon } from "./builtins/winston-logging/index.mjs";
 import { _ as ensureModel, a as createFileDataPlaneHandler, c as parseRangeHeader, d as ModelDownloadService, g as downloadModel, h as downloadFile, i as startEventLoopStallMonitor, l as parseTokenizedUrl, m as deleteModelFromDisk, n as STALL_TICK_MS, o as contentTypeFor, p as collectModelFiles, r as attributeStall, s as createAuthenticatedFileServer, t as STALL_REPORT_MS, u as resolveFilePath, v as fetchJson, x as isModelDownloaded, y as getModelFilePath } from "./event-loop-stall-monitor-EXjzIxDz.mjs";
 import { C as registerLanHttpHandler, S as readLanHttpState, _ as DEFAULT_LAN_HTTP_PORT, a as writeTlsMode, b as bindPendingLanHttp, c as loadTlsCert, d as collectCertIdentity, f as CA_VALIDITY_DAYS, g as evaluateExistingCert, h as SERVER_AUTH_OID, i as writeExtraSans, l as reissueTlsLeaf, m as MAX_LEAF_VALIDITY_DAYS, n as readTlsAccessStatus, o as validateUploadedTls, p as LEAF_RENEWAL_WINDOW_DAYS, r as readTlsMode, s as ensureTlsCert, t as readExtraSans, u as CA_COMMON_NAME, v as allFamiliesListenHost, x as closeLanHttp, y as applyLanHttp } from "./tls-IM-v7JV4.mjs";
-import { $ as classifyCapRoute, $n as EMPTY_CAP_ACTION_READING, $t as RUNNER_RSS_BUDGET_ENV, A as resolveHwAccel, An as OUTBOUND_QUEUE_SUSTAIN_MS, At as DeviceRegistry, B as udsChildLogToWorkerEntry, Bn as createSocketPlaneMeter, Bt as hostNodeIdOf, C as getBrokerEventBus, Cn as HEAP_SPACE_REPORT_MIN_MB, Ct as capActionName, D as subscribePassthrough, Dn as readHeapSpaces, Dt as parseCapAction, E as setNodeEventInterest, En as heapSpaceField, Et as capServiceName, F as ipcParentLink, Fn as createMeshQueueReader, Ft as resolveAddonClass, G as UDS_NO_ROUTE_PREFIX, Gn as EMPTY_SOCKET_DIRECTION, Gt as HEAP_WATCH_INTERVAL_MS, H as createUdsLoggerWithControl, Hn as diffSocketPlane, Ht as HEAP_RECLAIM_MIN_INTERVAL_MS, I as localProviderLink, In as formatMeshQueue, It as buildNpmChildEnv, J as deviceOfGetStatus, Jn as sampleSocketDirection, Jt as HUB_MAIN_RSS_BUDGET_MB, K as GET_STATUS_METHOD, Kn as createSocketDirectionCounters, Kt as HEAP_WATCH_WARN_RATIO, L as createParentUnownedCallHandler, Ln as EMPTY_SOCKET_PLANE_BASELINE, Lt as resolveNpmInvocation, M as brokerTransportLink, Mn as createOutboundQueueGate, Mt as CapabilityUnavailableError, N as buildLinkChain, Nn as formatOutboundQueueVerdict, Nt as copyBundledNativeModules, O as AddonDepsManager, On as selectReportedSpaces, Ot as deserializeTypedArrays, P as deviceCapResolverLink, Pn as MESH_QUEUE_TOP_N, Pt as installManifestNativeDeps, Q as CapRouteError, Qn as CAP_ACTION_UNLABELLED, Qt as RUNNER_HEAP_WATCH_INTERVAL_MS, R as createUdsEventBridge, Rn as SOCKET_PLANE_TOP_N, Rt as runNpm, S as clusterEventTopic, Sn as DECISIVE_HEAP_SPACES, St as NATIVE_PROVIDER_SERVICE_INFIX, T as registerEventBusService, Tn as formatHeapSpaces, Tt as capBareAction, U as LocalChildClient, Un as formatSocketPlane, Ut as HEAP_RECLAIM_STEADY_STATE_INTERVAL_MS, V as createUdsLogger, Vn as createSocketPlaneReader, Vt as createAddonDataPlaneFacility, W as LocalChildRegistry, Wn as readSocketQueues, Wt as HEAP_RECLAIM_TRIGGER_MB, X as AGENT_CAP_FWD_SERVICE, Xn as socketDirectionMessages, Xt as RSS_BUDGET_REANNOUNCE_MIN_MS, Y as AGENT_CAP_FWD_ACTION, Yn as socketDirectionBytes, Yt as HUB_RSS_BUDGET_ENV, Z as CapRouteResolver, Zn as CAP_ACTION_OVERFLOW_LABEL, Zt as RSS_BUDGET_RELEASE_RATIO, _ as getWorkerDeviceRegistry, _n as ARRAY_BUFFER_RELEASE_MIN_DROP_RATIO, a as reapProcessGroup, an as describeRss, ar as createEventPlaneMeter, at as getCapUsageRegistry, b as setHubConnected, bn as formatArrayBufferCensus, bt as createAddonService, c as runnerOwnsProcessGroup, cn as parseRssBudgetMb, cr as formatEventPlane, ct as UdsLocalTransportServer, d as summarizeMembers, dn as startHeapWatch, dt as localEndpointPath, en as ZERO_LOOP_DELAY, er as MAX_CAP_ACTIONS_PER_PEER, et as callWithServiceDiscovery, f as installManifestSystemDeps, fn as startRunnerHeapWatch, ft as FrameDecoder, g as createUdsAddonContext, gn as ARRAY_BUFFER_CENSUS_THRESHOLD_MB, h as createAddonContext, hn as ARRAY_BUFFER_CENSUS_SUSTAIN_MS, ht as createBrokerDeviceManagerApi, in as createV8Reclaimer, ir as EVENT_PLANE_TOP_N, it as __resetCapUsageRegistryForTests, j as brokerCallForCap, jn as OUTBOUND_QUEUE_THRESHOLD_BYTES, jt as CapabilityHandle, k as createKernelHwAccel, kn as OUTBOUND_QUEUE_COOLDOWN_MS, kt as serializeTypedArrays, l as signalAllRunnerGroups, ln as reclaimIntervalMs, lt as SocketChannel, m as adaptBrokerToCluster, mn as ARRAY_BUFFER_CENSUS_COOLDOWN_MS, mt as buildNativeCapProxy, nn as createDeferredHeapWatchSink, nr as createCapActionCensus, nt as CapUsageRegistry, o as registerRunnerGroup, on as hubMainRssBudget, or as createEventPlaneReader, ot as createLocalTransport, p as installManifestPythonDeps, pn as strandedMb, pt as encodeFrame, q as answerClaimedGetStatus, qn as recordSocketFrame, qt as HUB_MAIN_HEAP_WATCH_LABEL, r as defaultProcessGroupOps, rn as createLoopDelayMeter, rr as diffCapActionCensus, rt as PARENT_ROUTED_PROVIDER_ADDON_ID, s as releaseRunnerGroup, sn as nextRssBudgetState, sr as diffEventPlane, st as UdsLocalTransportClient, t as CAP_METHOD_NOT_IMPLEMENTED, tn as buildHeapSample, tr as capActionLabel, tt as readMoleculerFanoutMode, un as shouldReclaim, ut as PeerAnsweredError, v as getOrInitReadinessRegistry, vn as createArrayBufferCensusGate, vt as mountNativeCapService, w as getMoleculerEventStats, wn as emitHeapDiagnosticReport, wt as capActionSuffix, x as EVENT_TOPIC_PREFIX, xn as isArrayBufferCensusReport, xt as validateProviderRegistrations, y as getOrInitReadinessRegistryForClient, yn as createInspectorArrayBufferCensus, z as createUdsEventBus, zn as SOCKET_QUEUE_TOP_N, zt as createAddonPeerBytesFacility } from "./child-cap-dispatch-C2VINHu1.mjs";
+import { $ as classifyCapRoute, $n as EMPTY_CAP_ACTION_READING, $t as RUNNER_RSS_BUDGET_ENV, A as resolveHwAccel, An as OUTBOUND_QUEUE_SUSTAIN_MS, At as DeviceRegistry, B as udsChildLogToWorkerEntry, Bn as createSocketPlaneMeter, Bt as hostNodeIdOf, C as getBrokerEventBus, Cn as HEAP_SPACE_REPORT_MIN_MB, Ct as capActionName, D as subscribePassthrough, Dn as readHeapSpaces, Dt as parseCapAction, E as setNodeEventInterest, En as heapSpaceField, Et as capServiceName, F as ipcParentLink, Fn as createMeshQueueReader, Ft as resolveAddonClass, G as UDS_NO_ROUTE_PREFIX, Gn as EMPTY_SOCKET_DIRECTION, Gt as HEAP_WATCH_INTERVAL_MS, H as createUdsLoggerWithControl, Hn as diffSocketPlane, Ht as HEAP_RECLAIM_MIN_INTERVAL_MS, I as localProviderLink, In as formatMeshQueue, It as buildNpmChildEnv, J as deviceOfGetStatus, Jn as sampleSocketDirection, Jt as HUB_MAIN_RSS_BUDGET_MB, K as GET_STATUS_METHOD, Kn as createSocketDirectionCounters, Kt as HEAP_WATCH_WARN_RATIO, L as createParentUnownedCallHandler, Ln as EMPTY_SOCKET_PLANE_BASELINE, Lt as resolveNpmInvocation, M as brokerTransportLink, Mn as createOutboundQueueGate, Mt as CapabilityUnavailableError, N as buildLinkChain, Nn as formatOutboundQueueVerdict, Nt as copyBundledNativeModules, O as AddonDepsManager, On as selectReportedSpaces, Ot as deserializeTypedArrays, P as deviceCapResolverLink, Pn as MESH_QUEUE_TOP_N, Pt as installManifestNativeDeps, Q as CapRouteError, Qn as CAP_ACTION_UNLABELLED, Qt as RUNNER_HEAP_WATCH_INTERVAL_MS, R as createUdsEventBridge, Rn as SOCKET_PLANE_TOP_N, Rt as runNpm, S as clusterEventTopic, Sn as DECISIVE_HEAP_SPACES, St as NATIVE_PROVIDER_SERVICE_INFIX, T as registerEventBusService, Tn as formatHeapSpaces, Tt as capBareAction, U as LocalChildClient, Un as formatSocketPlane, Ut as HEAP_RECLAIM_STEADY_STATE_INTERVAL_MS, V as createUdsLogger, Vn as createSocketPlaneReader, Vt as createAddonDataPlaneFacility, W as LocalChildRegistry, Wn as readSocketQueues, Wt as HEAP_RECLAIM_TRIGGER_MB, X as AGENT_CAP_FWD_SERVICE, Xn as socketDirectionMessages, Xt as RSS_BUDGET_REANNOUNCE_MIN_MS, Y as AGENT_CAP_FWD_ACTION, Yn as socketDirectionBytes, Yt as HUB_RSS_BUDGET_ENV, Z as CapRouteResolver, Zn as CAP_ACTION_OVERFLOW_LABEL, Zt as RSS_BUDGET_RELEASE_RATIO, _ as getWorkerDeviceRegistry, _n as ARRAY_BUFFER_RELEASE_MIN_DROP_RATIO, a as reapProcessGroup, an as describeRss, ar as createEventPlaneMeter, at as getCapUsageRegistry, b as setHubConnected, bn as formatArrayBufferCensus, bt as createAddonService, c as runnerOwnsProcessGroup, cn as parseRssBudgetMb, cr as formatEventPlane, ct as UdsLocalTransportServer, d as summarizeMembers, dn as startHeapWatch, dt as localEndpointPath, en as ZERO_LOOP_DELAY, er as MAX_CAP_ACTIONS_PER_PEER, et as callWithServiceDiscovery, f as installManifestSystemDeps, fn as startRunnerHeapWatch, ft as FrameDecoder, g as createUdsAddonContext, gn as ARRAY_BUFFER_CENSUS_THRESHOLD_MB, h as createAddonContext, hn as ARRAY_BUFFER_CENSUS_SUSTAIN_MS, ht as createBrokerDeviceManagerApi, in as createV8Reclaimer, ir as EVENT_PLANE_TOP_N, it as __resetCapUsageRegistryForTests, j as brokerCallForCap, jn as OUTBOUND_QUEUE_THRESHOLD_BYTES, jt as CapabilityHandle, k as createKernelHwAccel, kn as OUTBOUND_QUEUE_COOLDOWN_MS, kt as serializeTypedArrays, l as signalAllRunnerGroups, ln as reclaimIntervalMs, lt as SocketChannel, m as adaptBrokerToCluster, mn as ARRAY_BUFFER_CENSUS_COOLDOWN_MS, mt as buildNativeCapProxy, nn as createDeferredHeapWatchSink, nr as createCapActionCensus, nt as CapUsageRegistry, o as registerRunnerGroup, on as hubMainRssBudget, or as createEventPlaneReader, ot as createLocalTransport, p as installManifestPythonDeps, pn as strandedMb, pt as encodeFrame, q as answerClaimedGetStatus, qn as recordSocketFrame, qt as HUB_MAIN_HEAP_WATCH_LABEL, r as defaultProcessGroupOps, rn as createLoopDelayMeter, rr as diffCapActionCensus, rt as PARENT_ROUTED_PROVIDER_ADDON_ID, s as releaseRunnerGroup, sn as nextRssBudgetState, sr as diffEventPlane, st as UdsLocalTransportClient, t as CAP_METHOD_NOT_IMPLEMENTED, tn as buildHeapSample, tr as capActionLabel, tt as readMoleculerFanoutMode, un as shouldReclaim, ut as PeerAnsweredError, v as getOrInitReadinessRegistry, vn as createArrayBufferCensusGate, vt as mountNativeCapService, w as getMoleculerEventStats, wn as emitHeapDiagnosticReport, wt as capActionSuffix, x as EVENT_TOPIC_PREFIX, xn as isArrayBufferCensusReport, xt as validateProviderRegistrations, y as getOrInitReadinessRegistryForClient, yn as createInspectorArrayBufferCensus, z as createUdsEventBus, zn as SOCKET_QUEUE_TOP_N, zt as createAddonPeerBytesFacility } from "./child-cap-dispatch-kLIiU1CG.mjs";
 import { n as getSinglePidStats, t as getPidStats } from "./resource-monitor-B1v6E07R.mjs";
 import { t as CustomActionRegistry } from "./custom-action-registry-B4Cf4O_X.mjs";
 import { z } from "zod";

package/dist/{retired-settings-keys-DR2WMe5d.js → retired-settings-keys-BY9H1I2b.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-Bx4zxM9N.js");
+const require_dist = require("./dist-DRUzy1SF.js");
 //#region src/builtins/sqlite-storage/retired-settings-keys.ts
 /**
 * Is THIS node the one whose settings store is the cluster's authority?

package/dist/{retired-settings-keys-Dxf9vELs.mjs → retired-settings-keys-BcJDpASY.mjs}

@@ -1,4 +1,4 @@
-import { ir as asJsonObject } from "./dist-Dp043AI0.mjs";
+import { Xn as asJsonObject } from "./dist-CoG8lY6H.mjs";
 //#region src/builtins/sqlite-storage/retired-settings-keys.ts
 /**
 * Is THIS node the one whose settings store is the cluster's authority?

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.330",
+  "version": "1.2.331",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",
@@ -190,21 +190,6 @@
           }
         ]
       },
-      {
-        "id": "virtual-doorbell",
-        "category": "system",
-        "name": "Virtual Doorbell",
-        "description": "Wrapper over the `doorbell` cap — turns any binary sensor or switch (contact, motion, flood/gas/CO/smoke, vibration, tamper, or a switch) into a per-camera doorbell. Operator binds it per camera and picks the trigger devices from a searchable list in the camera's general settings; the reaction is automatic (sensor active / switch on).",
-        "entry": "./dist/builtins/doorbell/index.js",
-        "capabilities": [
-          {
-            "name": "doorbell"
-          },
-          {
-            "name": "device-extension"
-          }
-        ]
-      },
       {
         "id": "autotrack",
         "category": "system",

package/dist/builtins/doorbell/binding-mirror.d.ts

@@ -1,110 +0,0 @@
-import { WrapperActivationRead } from '@camstack/types';
-/**
- * `bound` — a read saw the wrapper's activation.
- * `unbind-pending` — one read did not; NOT yet believed, still rings.
- * `unbound` — two consecutive reads did not; believed, silences the camera.
- */
-export type DoorbellBindingState = 'bound' | 'unbind-pending' | 'unbound';
-/**
- * Fold one SUCCESSFUL bindings read into the mirror. A read that failed must
- * never reach this function — an unanswerable store carries no information
- * and must leave the mirror exactly as it was.
- */
-export declare function nextBindingState(previous: DoorbellBindingState | undefined, boundNow: boolean): DoorbellBindingState;
-/**
- * May a ring proceed on the mirror STATE alone? Only a corroborated unbind
- * stops one. {@link needsDurableRead} adds the served-elsewhere case on top.
- */
-export declare function allowsRing(state: DoorbellBindingState | undefined): boolean;
-/** True only when a read has positively confirmed the binding. */
-export declare function hasConfirmedBinding(state: DoorbellBindingState | undefined): boolean;
-/** The fields of a `DeviceBindingEntry` this module reasons about. */
-export interface BindingEntryView {
-    readonly capName: string;
-    readonly kind: string;
-    readonly providerAddonId: string;
-    readonly nativeAddonId?: string;
-}
-/**
- * Does this list of binding entries name `ownAddonId` as the ACTIVE WRAPPER
- * of `capName`?
- *
- * `isSameAddonId` is the whole point: `ownAddonId` is an `AddonContext.id`,
- * which is prefixed (`addon:…`) in hub-main and bare in a forked runner,
- * while `providerAddonId` is always bare. A raw `===` here is the D72 bug.
- */
-export declare function entriesBindWrapper(entries: ReadonlyArray<BindingEntryView>, capName: string, ownAddonId: string): boolean;
-/**
- * Render binding entries for a log line. A systematic wrong answer and a
- * one-off blip produce the same VERDICT; only the entries themselves tell
- * them apart, so a negative read never gets to report just its conclusion.
- */
-export declare function summariseEntries(entries: ReadonlyArray<BindingEntryView>): string[];
-/**
- * `bound` / `unbound` — the durable store answered, and this is its answer.
- * `unreadable` — the store could not be read, or answered from an empty
- * snapshot (D44). It carries NO information and must never destroy work.
- */
-export type DurableBindingVerdict = 'bound' | 'unbound' | 'unreadable';
-/**
- * The durable verdict for `ownAddonId`, from device-manager's STORED
- * activation of this cap on this device (`deviceManager.getWrapperActivation`).
- *
- * - `value` naming this wrapper → `bound`.
- * - `value` naming another wrapper, or `null` — the operator's explicit "off"
- *   marker (D62) — → `unbound`.
- * - `missing` → `unbound`: the store ANSWERED and holds no activation, and the
- *   doorbell cap is `defaultActive: false`, so a wrapper nobody activated is
- *   not bound.
- * - `failed` → `unreadable`: it carries no information and destroys nothing.
- */
-export declare function durableVerdictOf(read: WrapperActivationRead, ownAddonId: string): DurableBindingVerdict;
-/**
- * Who, other than this wrapper, the derived view says serves `capName` —
- * `composer` on a camera whose doorbell was migrated to a composition (D671).
- * Non-empty means a press this wrapper does not ring is still somebody's ring.
- */
-export declare function otherProvidersOf(entries: ReadonlyArray<BindingEntryView>, capName: string, ownAddonId: string): string[];
-/**
- * What a press on this camera would do right now.
- *
- * `rings` — the binding is confirmed (mirror `bound`, or the durable store
- * rescued an `unbound` mirror). `rings-pending` — one negative read, not yet
- * believed. `rings-unconfirmed` — no read has happened yet; the ring path errs
- * open. `unknown` — the mirror says unbound but the durable store could not
- * be read: a press RINGS (an unanswerable store never destroys a one-shot
- * press), and nobody can say whether that is right. `silent` — the durable
- * store agrees with an unbound mirror: the only verdict that drops a press.
- */
-export type RingVerdict = 'rings' | 'rings-pending' | 'rings-unconfirmed' | 'unknown' | 'silent';
-/**
- * What the ring gate and the card know about one camera without I/O: the
- * mirror's state, and which OTHER providers the last successful bindings read
- * said serve `doorbell` there (empty when none, or when no read has answered).
- */
-export interface DoorbellMirrorRead {
-    readonly state: DoorbellBindingState | undefined;
-    readonly servedBy: readonly string[];
-}
-/**
- * Does this camera need the durable authority before a verdict?
- *
- * An `unbound` mirror does (D72). So does any mirror short of `bound` on a
- * camera whose doorbell another provider serves — the D671 cutover, where
- * erring open means ringing ON TOP of the composer: after every restart the
- * mirror starts `undefined` and spends a reload cycle at `unbind-pending`, and
- * each press in that window was a duplicate ring. Two independent reads
- * agreeing — the derived view naming another provider, the store naming no
- * wrapper — is the D49 "second read agrees"; an unreadable store still rings.
- */
-export declare function needsDurableRead(mirror: DoorbellMirrorRead): boolean;
-/**
- * THE decision — the ring gate (`fireDoorbell` / `ringsAfterDurableRead`)
- * and the Extensions card's activation both call it, so what the card says
- * and what a press does cannot disagree. `durable` is `null` when it was not
- * read, which {@link needsDurableRead} allows only where it says so.
- * Pure: it reads nothing and writes nothing.
- */
-export declare function ringVerdict(mirror: DoorbellMirrorRead, durable: DurableBindingVerdict | null): RingVerdict;
-/** Whether a press proceeds under this verdict. */
-export declare function verdictRings(verdict: RingVerdict): boolean;

package/dist/builtins/doorbell/doorbell-composition-migration.d.ts

@@ -1,47 +0,0 @@
-import { DeviceType, ICoreBlocksProvider, IScopedLogger } from '@camstack/types';
-import { BindingEntryView } from './binding-mirror.js';
-import { DoorbellSource } from './doorbell-settings.js';
-export declare const DOORBELL_COMPOSITION_MIGRATION_STATE_KEY = "doorbell-source-composition-migration-v1";
-export declare const DOORBELL_COMPOSITION_MIGRATION_CALLER: {
-    readonly userId: "system:doorbell-source-migration";
-    readonly isAdmin: true;
-};
-export interface DoorbellMigrationDevice {
-    readonly id: number;
-    readonly addonId: string;
-    readonly stableId: string;
-    readonly type: DeviceType;
-}
-export interface DoorbellMigrationBindingRow {
-    readonly deviceId: number;
-    readonly entries: readonly BindingEntryView[];
-}
-export interface DoorbellCompositionMigrationDeps {
-    readonly logger: IScopedLogger;
-    readonly listCameras: () => Promise<readonly DoorbellMigrationDevice[]>;
-    readonly listSourceDevices: (deviceIds: readonly number[]) => Promise<readonly DoorbellMigrationDevice[]>;
-    readonly readSources: (cameraId: number) => Promise<readonly DoorbellSource[]>;
-    readonly getBindingsBatch: (deviceIds: readonly number[]) => Promise<readonly DoorbellMigrationBindingRow[]>;
-    readonly coreBlocks: () => ICoreBlocksProvider | null;
-    readonly setWrapperActive: (input: {
-        readonly deviceId: number;
-        readonly capName: 'doorbell';
-        readonly wrapperAddonId: 'virtual-doorbell';
-        readonly active: false;
-    }) => Promise<void>;
-    readonly isComplete: () => Promise<boolean>;
-    readonly markComplete: () => Promise<void>;
-}
-export declare class DoorbellCompositionMigration {
-    private readonly deps;
-    private rerunRequested;
-    private inFlight;
-    private stopped;
-    constructor(deps: DoorbellCompositionMigrationDeps);
-    request(reason: string): void;
-    waitForIdle(): Promise<void>;
-    shutdown(): void;
-    private runUntilQuiet;
-    private runAttempt;
-    private warnCamera;
-}

package/dist/builtins/doorbell/doorbell-extension-slot.d.ts

@@ -1,67 +0,0 @@
-import { ExtensionSlotActivation, IDeviceExtensionProvider, IScopedLogger } from '@camstack/types';
-import { DoorbellMirrorRead, DurableBindingVerdict, RingVerdict } from './binding-mirror.js';
-import { DoorbellSource } from './doorbell-settings.js';
-/** The routing prefix of this owner's `slotRef`s. */
-export declare const VIRTUAL_DOORBELL_EXTENSION_SOURCE = "virtual-doorbell";
-/** The store the slot reads and writes, named (D62). */
-export declare const DOORBELL_SOURCES_AUTHORITY = "virtual-doorbell:doorbellSources";
-/** The authority that decides whether the wrapper serves a camera at all. */
-export declare const WRAPPER_ACTIVATION_AUTHORITY = "device-manager:setWrapperActive";
-/** The compact device row this slot needs from the device manager. */
-export interface DoorbellSlotDevice {
-    readonly id: number;
-    readonly name: string;
-    readonly type: string;
-    readonly location: string | null;
-    readonly parentDeviceId: number | null;
-}
-/** What the slot needs from the addon — its store, its mirror, and the fleet's reads. */
-export interface DoorbellSlotDeps {
-    readonly ownAddonId: string;
-    readonly logger: IScopedLogger;
-    readonly readSources: (deviceId: number) => Promise<readonly DoorbellSource[]>;
-    /** The addon's own settings-save path (normalise, store, invalidate). */
-    readonly persistSources: (deviceId: number, deviceIds: readonly number[]) => Promise<void>;
-    /** The host's own row — ONE read, for its type. */
-    readonly getDevice: (deviceId: number) => Promise<DoorbellSlotDevice | null>;
-    /** Several devices in ONE read. Ids no device has are simply absent. */
-    readonly listDevices: (deviceIds: readonly number[]) => Promise<readonly DoorbellSlotDevice[]>;
-    /** The D49 mirror's verdict for this camera, or undefined when it has none. */
-    readonly readBindingMirror: (deviceId: number) => DoorbellMirrorRead;
-    /**
-     * The DURABLE authority, read-only — the same read the ring gate makes
-     * before it drops a press. Never throws: a store that cannot answer is
-     * `unreadable`, which carries no information.
-     */
-    readonly readDurableBinding: (deviceId: number) => Promise<DurableBindingVerdict>;
-    readonly sourceCapableDeviceIds: () => Promise<readonly number[]>;
-    readonly listFleet: () => Promise<readonly DoorbellSlotDevice[]>;
-}
-/** How the card SAYS a verdict. The verdict itself is `ringVerdict`'s, never the card's. */
-export declare function activationFromVerdict(verdict: RingVerdict): ExtensionSlotActivation;
-/**
- * The card's activation — READ-ONLY (D648 fix round 3).
- *
- * The verdict is `ringVerdict`, the function the ring gate decides with, fed
- * the addon's mirror as it stands. The card never refreshes the mirror and
- * never writes it: the mirror gates the ring, and a view that could move it
- * would let a page refetch during a store blip silence a doorbell. The only
- * read the card may make is the durable authority, and only where the ring
- * gate would make it too (`needsDurableRead`: an `unbound` mirror, or one
- * short of `bound` whose doorbell another provider serves). A camera
- * the mirror has never seen costs nothing — the ring path errs open there and
- * so does the card.
- */
-/** The card's durable read for one camera, shared by every view asking at once. */
-type DurableReader = (deviceId: number) => Promise<DurableBindingVerdict>;
-/**
- * Concurrent card views of the same `unbound` camera share ONE durable read,
- * per camera, for as long as it is in flight — a page with several viewers
- * (or a refetch storm) must not multiply the store round trip. Only the
- * CARD's reads are shared: the ring gate calls the addon's
- * `readDurableAuthority` on its own path and never waits behind a card.
- */
-export declare function shareDurableReads(read: DurableReader): DurableReader;
-/** Build the `device-extension` provider the virtual doorbell registers. */
-export declare function createDoorbellExtensionProvider(deps: DoorbellSlotDeps): IDeviceExtensionProvider;
-export {};

package/dist/builtins/doorbell/doorbell-settings.d.ts

@@ -1,58 +0,0 @@
-/**
- * Pure per-camera settings parsing/normalization for the virtual-doorbell
- * builtin. Kept separate from the addon class (and the runtime trigger
- * engine) so the persisted-shape handling — including tolerant migration of
- * the legacy single-source blob — is unit-testable in isolation.
- *
- * PERSISTED SHAPE (extensible by design):
- *   doorbellSources: Array<{ deviceId: number }>
- *
- * The source is an OBJECT rather than a bare id so future per-source options
- * (a custom trigger override, an event-type match, a per-source debounce)
- * can be added without another migration. Today only `deviceId` is stored;
- * the reaction is DERIVED at runtime from the source device's cap (see
- * `trigger-engine.ts`).
- */
-/** Device-store key holding the source list. */
-export declare const KEY_SOURCES = "doorbellSources";
-/**
- * Legacy device-store keys from the pre-simplification shape (single source
- * device + explicit trigger + event type). Retained ONLY for tolerant
- * migration on read and cleanup on write — never written afresh.
- */
-export declare const LEGACY_KEY_SOURCE = "doorbellSourceDeviceId";
-export declare const LEGACY_KEY_TRIGGER = "doorbellTrigger";
-export declare const LEGACY_KEY_EVENT_TYPE = "doorbellEventType";
-/**
- * One source device driving a camera's virtual doorbell. Intentionally an
- * object so it can grow (custom trigger, event type) without a migration.
- */
-export interface DoorbellSource {
-    readonly deviceId: number;
-}
-/** Coerce a persisted / form-supplied id (number or numeric string) to a
- *  positive integer device id, or null when it is not a usable id. */
-export declare function coerceDeviceId(value: unknown): number | null;
-/**
- * Parse the persisted doorbell sources for one camera. Tolerant of BOTH:
- *   - the new `doorbellSources: [{deviceId}]` shape (ids may arrive as
- *     numbers, numeric strings, or `{deviceId}` records); and
- *   - the legacy single `doorbellSourceDeviceId` scalar, mapped onto one
- *     source (the old trigger/eventType are dropped — the reaction is now
- *     derived at runtime).
- *
- * Never throws on malformed data — unknown entries are skipped.
- */
-export declare function parseDoorbellSources(blob: Record<string, unknown>): readonly DoorbellSource[];
-/**
- * Normalize a settings-patch value for the `doorbellSources` multiselect
- * (a `string[]` of device ids from the form, or an already-shaped
- * `{deviceId}[]` / `number[]`) into the persisted extensible shape.
- */
-export declare function normalizeDoorbellSources(value: unknown): DoorbellSource[];
-/**
- * Produce the next device-store blob after applying a doorbell-sources
- * patch: writes the normalized new shape and strips every legacy key so a
- * migrated camera never carries stale single-source fields.
- */
-export declare function applyDoorbellSourcesPatch(current: Record<string, unknown>, patchValue: unknown): Record<string, unknown>;

package/dist/builtins/doorbell/index.d.ts

@@ -1,2 +0,0 @@
-export { VirtualDoorbellAddon } from './virtual-doorbell.addon.js';
-export { VirtualDoorbellAddon as default } from './virtual-doorbell.addon.js';

package/dist/builtins/doorbell/index.js

@@ -1,8 +0,0 @@
-Object.defineProperties(exports, {
-	__esModule: { value: true },
-	[Symbol.toStringTag]: { value: "Module" }
-});
-require("../../chunk-Cek0wNdY.js");
-const require_builtins_doorbell_virtual_doorbell_addon = require("./virtual-doorbell.addon.js");
-exports.VirtualDoorbellAddon = require_builtins_doorbell_virtual_doorbell_addon.VirtualDoorbellAddon;
-exports.default = require_builtins_doorbell_virtual_doorbell_addon.VirtualDoorbellAddon;

package/dist/builtins/doorbell/index.mjs

@@ -1,2 +0,0 @@
-import { VirtualDoorbellAddon } from "./virtual-doorbell.addon.mjs";
-export { VirtualDoorbellAddon, VirtualDoorbellAddon as default };

package/dist/builtins/doorbell/trigger-engine.d.ts

@@ -1,92 +0,0 @@
-import { DEFAULT_FIRST_SIGHTING_FRESHNESS_MS, isSourceCap, SOURCE_CAP_ACTIVE_FIELD, SOURCE_CAP_CHANGED_AT_FIELD, SOURCE_CAPS, SOURCE_DEVICE_TYPES, SensorEdgeIgnoreReason } from '@camstack/types';
-export { DEFAULT_FIRST_SIGHTING_FRESHNESS_MS, isSourceCap, SOURCE_CAP_ACTIVE_FIELD, SOURCE_CAP_CHANGED_AT_FIELD, SOURCE_CAPS, SOURCE_DEVICE_TYPES, };
-/**
- * Why a slice produced no ring. Every value names a DROPPED evaluation, so
- * the addon can log the ones that may have cost a real press instead of
- * returning an empty array that reads as "nothing happened".
- *
- * It is {@link SensorEdgeIgnoreReason} plus ONE value the pure evaluator
- * cannot know: `no-assignment` is a real rise that no camera is wired to, and
- * that is a fact about the doorbell's wiring, not about the sensor.
- */
-export type DoorbellIgnoreReason = SensorEdgeIgnoreReason
-/** A real rise, but no camera is wired to this source. */
- | 'no-assignment';
-/**
- * The outcome of feeding one slice. `fired` is what rings; `debounced` and
- * `ignored` exist so that no suppression is invisible.
- */
-export interface DoorbellTriggerResult {
-    /** Cameras to ring now. */
-    readonly fired: readonly number[];
-    /** Cameras that WOULD have rung but are inside their debounce window. */
-    readonly debounced: readonly number[];
-    /** Set when the slice carried no ring at all; null once a rise was matched. */
-    readonly ignored: DoorbellIgnoreReason | null;
-}
-/**
- * One camera's virtual-doorbell wiring: a source device that rings it. A
- * camera with several sources produces several assignments (one per source).
- */
-export interface DoorbellAssignment {
-    readonly cameraId: number;
-    readonly sourceDeviceId: number;
-}
-/** Debounce window guarding against sensor chatter (reed-switch bounce,
- *  duplicate HA state pushes). One ring per camera per window. */
-export declare const DEFAULT_DEBOUNCE_MS = 2000;
-/**
- * Stateful (but side-effect-free towards the outside) trigger engine.
- *
- * Tracks the last observed binary value per (sourceDevice, cap) so a
- * `DeviceStateChanged` re-emission (the slice's `lastChangedAt` moves while
- * the binary value does not) never double-fires.
- *
- * FIRST SIGHTINGS. Seeding the baseline and never firing was wrong for the
- * one case that matters: a momentary source (a button wired to a Home
- * Assistant switch) is NOT re-pushed in its resting `off` state after a hub
- * restart, so after every restart — several a day — the first slice the
- * engine ever sees for it is the PRESS ITSELF, already active. That press
- * was eaten whole; a real one on 2026-08-05 left no trace anywhere.
- *
- * The discriminator is the source's own transition timestamp. A first
- * sighting that is already active rings only when its transition can be
- * proved to have happened AFTER this engine started watching AND within
- * `firstSightingFreshnessMs`. Both halves earn their keep: freshness alone
- * would ring on a boot hydration of a state that flipped seconds before the
- * restart, and "after we started" alone would ring, on a long-lived
- * process, for a source adopted today whose state flipped yesterday. An
- * undateable first sighting (no timestamp, or a zero sentinel) does NOT
- * ring — the ambiguous case errs towards silence, but reports
- * `baseline-seeded-stale-active` so the caller can say so out loud.
- */
-export declare class DoorbellTriggerEngine {
-    private assignments;
-    /** Last observed binary value keyed by `${deviceId}:${capName}`. */
-    private readonly lastValues;
-    /** Last fire timestamp per camera — debounce bookkeeping. */
-    private readonly lastFiredAt;
-    private readonly debounceMs;
-    private readonly now;
-    private readonly firstSightingFreshnessMs;
-    /** When this engine started watching — the floor for a first-sighting rise. */
-    private readonly startedAt;
-    constructor(options?: {
-        readonly debounceMs?: number;
-        readonly now?: () => number;
-        readonly firstSightingFreshnessMs?: number;
-    });
-    /** Replace the full assignment set (rebuilt whenever settings change). */
-    setAssignments(assignments: readonly DoorbellAssignment[]): void;
-    getAssignments(): readonly DoorbellAssignment[];
-    /** True when any assignment references `deviceId` as its source. */
-    hasSource(deviceId: number): boolean;
-    /**
-     * Feed one `DeviceStateChanged` slice. Reports which cameras should ring,
-     * which were suppressed by the debounce window, and — when nothing was
-     * matched at all — WHY. Only a rise to active on a recognised source cap
-     * can ring; re-emissions and the falling edge never do.
-     */
-    onStateSlice(deviceId: number, capName: string, slice: Record<string, unknown>): DoorbellTriggerResult;
-    private matchAndDebounce;
-}