@camstack/types 1.2.592 → 1.2.593
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +6 -0
- package/dist/addon.js +1 -1
- package/dist/addon.mjs +1 -1
- package/dist/capabilities/device-state-refresh.cap.d.ts +58 -0
- package/dist/capabilities/index.d.ts +3 -1
- package/dist/client.js +5 -0
- package/dist/client.mjs +5 -0
- package/dist/device/command-hold.d.ts +6 -0
- package/dist/device/state-refresh.d.ts +51 -0
- package/dist/generated/addon-api.d.ts +22 -0
- package/dist/generated/cap-vocabulary.d.ts +1 -1
- package/dist/generated/capability-router-map.d.ts +5 -2
- package/dist/generated/device-proxy.d.ts +2 -0
- package/dist/generated/device-scoped-caps.d.ts +1 -1
- package/dist/generated/method-access-map.d.ts +1 -1
- package/dist/generated/method-device-selectors.d.ts +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.js +158 -1
- package/dist/index.mjs +148 -2
- package/dist/{sleep-D2Ny6tvi.js → sleep-BOK28JE0.js} +20 -2
- package/dist/{sleep-dgC2VKW4.mjs → sleep-DO-ayTnk.mjs} +20 -2
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [1.2.593] - 2026-11-18
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
|
|
14
|
+
- New device-state-refresh capability and state-refresh policy types: a provider declares how its devices are read, the hub decides when (D1062).
|
|
15
|
+
|
|
10
16
|
## [1.2.592] - 2026-11-18
|
|
11
17
|
|
|
12
18
|
### Changed
|
package/dist/addon.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
-
const require_sleep = require("./sleep-
|
|
2
|
+
const require_sleep = require("./sleep-BOK28JE0.js");
|
|
3
3
|
const require_event_category = require("./event-category-BKxXXxnV.js");
|
|
4
4
|
const require_composed_stable_id = require("./composed-stable-id-BdeYe5dD.js");
|
|
5
5
|
//#region src/generated/cap-input-defaults.ts
|
package/dist/addon.mjs
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { $ as viewerUiCapability, $i as asRecordsError, $n as RecordIndexSchema, Ai as isSecretRef, An as resolveSecretViewsIn, B as CALLER_STAMPED_CAPABILITIES, Bi as InvalidRecordError, Bn as PEER_BYTES_CHUNK_BYTES, Ca as isSecretClear, Ci as RECORD_SETTINGS_MAX_ROWS, Cn as OnBehalfSchema, Ct as ReadinessTimeoutError, Da as makeSecretMarker, Di as buildSecretRef, Dn as makeInMemoryRecords, Ea as isSecretMarkerLike, Ei as arrayItemFieldPath, En as ruleFireOfClaim, Er as ErrorI18nPayloadSchema, Et as scopeKey, F as CAP_METHOD_TIMEOUTS_MS, Fn as forgetKnownSecret, Gi as RecordSecretUnavailableError, Gn as CALLER_USERNAME_HEADER, Gr as nodeIdOfScopedKey, H as customAction, Hi as PlaintextSecretError, Hn as PEER_BYTES_STALL_MS, Ia as AddonMigrationsBlockedError, Ii as BatchTooLargeError, In as knownSecretCount, J as commandOrigin, Ji as RecordsError, Jn as DisposerChain, Ki as RecordTooLargeError, Kn as DATAPLANE_SECRET_HEADER, Kr as resolveDeviceSettings, L as CAP_STATE_LEAVES, La as findMigrationsBlocked, Li as DeclarationRefusedError, Ln as registerKnownSecret, M as HF_REPO, Mi as parseSecretRef, Mn as createSecretsAccess, Nn as MIN_SCRUBBED_LENGTH, O as isCommand, Oa as toSecretFieldView, Oi as formatSecretScope, On as createRecordsAccess, P as CAP_ADVANCE_FIELDS, Pn as clearKnownSecrets, Pr as normalizeAddonInitResult, Pt as createDebugEmitter, Qi as UnknownRecordKindError, Qn as RecordFieldPathSchema, R as CAP_METHOD_NOT_IMPLEMENTED, Ri as FilterRequiredError, Rn as scrubKnownSecrets, Sa as classifySecretWrite, Si as RECORD_SECRET_COLLECTION_PREFIX, Sn as CommandOriginClaimSchema, St as ReadinessRegistry, Ta as isSecretMarker, Ti as SECRET_REF_SCHEME, Tn as RuleFireOriginSchema, U as defineCustomActions, Ui as RECORDS_ERROR_CODES, Un as PEER_BYTES_TICKET_TTL_MS, V as withoutCallerStamp, Vi as NoCallerError, Vn as PEER_BYTES_MAX_OUTSTANDING, W as describeCustomActions, Wi as RecordNotFoundError, Wr as SCOPED_SETTINGS_SCOPES, X as readCommandOrigin, Xi as TransactRefusedError, Xn as entryBody, Y as nodePin, Yi as RevConflictError, Yn as defineEntryKind, Z as readNodePin, Zi as UnindexedFilterError, Zn as EntryDescriptorSchema, _i as RECORD_ID_MAX_LENGTH, _r as expandCapMethods, ai as mapSecretLeaves, ar as declarationsOf, bi as RECORD_MAX_INDEX_FIELDS, c as asString, ci as recordSecretCollection, cr as collectZodSecretPaths, ct as adminUiCapability, d as parseJsonUnknown, da as emitReadiness, di as RECORD_BATCH_MAX, ea as recordsErrorFromMessage, er as RecordKindDeclarationSchema, et as SWITCH_SETTABLE_GATE, f as hfModelUrl, fi as RECORD_BATCH_MAX_BYTES, g as createDeviceProxy, gi as RECORD_DELETE_BATCH, h as isDeviceScopedCap, hi as RECORD_DEFAULT_MAX_DATA_BYTES, ii as collectSecretLeaves, ir as assertValidDeclaration, it as MIGRATION_API_VERSION, ji as normalizeSecretOwner, jn as REVALIDATE_AFTER_MS, jr as BaseAddon, ki as globalSecretScope, kn as assertTransactScope, kr as readErrorI18n, li as recordSecretRef, lr as isZodSecret, m as DEVICE_SCOPED_CAPS, mi as RECORD_DATABASES, ni as secretViewsOf, nr as RecordRetentionSchema, nt as PipelineRunResultBridge, o as asJsonObject, oi as parseSecretPath, or as defineRecordKinds, ot as deviceOpsCapability, p as BOOT_RECOVERY_BACKOFF_MS, pi as RECORD_CLASSES, qi as RecordUniqueViolationError, qr as resolvedValues, r as maskUrlCredentials, ri as REMOVE_LEAF, rr as StoredRecordKindDeclarationSchema, rt as PipelineStepInputSchema, si as recordArrayItemPath, st as DEVICE_CHILDREN_BATCH_MAX, t as sleep, tr as RecordKindNameSchema, tt as switchRefusesSetState, ua as createEvent, ui as secretArrayPrefixes, ut as addonPagesSourceCapability, v as addonSliceHandleApi, vi as RECORD_MAX_DATA_BYTES, wa as isSecretFieldView, wi as RECORD_SWEEP_INTERVAL_MS, wn as OnBehalfSourceSchema, xa as SECRET_CLEAR, xi as RECORD_QUERY_MAX, xt as MODEL_FORMATS, y as createEventBusSliceSource, yi as RECORD_MAX_INDEXES, z as isCapMethodAbsent, zi as ForeignSecretMarkerError, zn as shortSecretRefHash } from "./sleep-
|
|
1
|
+
import { $ as viewerUiCapability, $i as asRecordsError, $n as RecordIndexSchema, Ai as isSecretRef, An as resolveSecretViewsIn, B as CALLER_STAMPED_CAPABILITIES, Bi as InvalidRecordError, Bn as PEER_BYTES_CHUNK_BYTES, Ca as isSecretClear, Ci as RECORD_SETTINGS_MAX_ROWS, Cn as OnBehalfSchema, Ct as ReadinessTimeoutError, Da as makeSecretMarker, Di as buildSecretRef, Dn as makeInMemoryRecords, Ea as isSecretMarkerLike, Ei as arrayItemFieldPath, En as ruleFireOfClaim, Er as ErrorI18nPayloadSchema, Et as scopeKey, F as CAP_METHOD_TIMEOUTS_MS, Fn as forgetKnownSecret, Gi as RecordSecretUnavailableError, Gn as CALLER_USERNAME_HEADER, Gr as nodeIdOfScopedKey, H as customAction, Hi as PlaintextSecretError, Hn as PEER_BYTES_STALL_MS, Ia as AddonMigrationsBlockedError, Ii as BatchTooLargeError, In as knownSecretCount, J as commandOrigin, Ji as RecordsError, Jn as DisposerChain, Ki as RecordTooLargeError, Kn as DATAPLANE_SECRET_HEADER, Kr as resolveDeviceSettings, L as CAP_STATE_LEAVES, La as findMigrationsBlocked, Li as DeclarationRefusedError, Ln as registerKnownSecret, M as HF_REPO, Mi as parseSecretRef, Mn as createSecretsAccess, Nn as MIN_SCRUBBED_LENGTH, O as isCommand, Oa as toSecretFieldView, Oi as formatSecretScope, On as createRecordsAccess, P as CAP_ADVANCE_FIELDS, Pn as clearKnownSecrets, Pr as normalizeAddonInitResult, Pt as createDebugEmitter, Qi as UnknownRecordKindError, Qn as RecordFieldPathSchema, R as CAP_METHOD_NOT_IMPLEMENTED, Ri as FilterRequiredError, Rn as scrubKnownSecrets, Sa as classifySecretWrite, Si as RECORD_SECRET_COLLECTION_PREFIX, Sn as CommandOriginClaimSchema, St as ReadinessRegistry, Ta as isSecretMarker, Ti as SECRET_REF_SCHEME, Tn as RuleFireOriginSchema, U as defineCustomActions, Ui as RECORDS_ERROR_CODES, Un as PEER_BYTES_TICKET_TTL_MS, V as withoutCallerStamp, Vi as NoCallerError, Vn as PEER_BYTES_MAX_OUTSTANDING, W as describeCustomActions, Wi as RecordNotFoundError, Wr as SCOPED_SETTINGS_SCOPES, X as readCommandOrigin, Xi as TransactRefusedError, Xn as entryBody, Y as nodePin, Yi as RevConflictError, Yn as defineEntryKind, Z as readNodePin, Zi as UnindexedFilterError, Zn as EntryDescriptorSchema, _i as RECORD_ID_MAX_LENGTH, _r as expandCapMethods, ai as mapSecretLeaves, ar as declarationsOf, bi as RECORD_MAX_INDEX_FIELDS, c as asString, ci as recordSecretCollection, cr as collectZodSecretPaths, ct as adminUiCapability, d as parseJsonUnknown, da as emitReadiness, di as RECORD_BATCH_MAX, ea as recordsErrorFromMessage, er as RecordKindDeclarationSchema, et as SWITCH_SETTABLE_GATE, f as hfModelUrl, fi as RECORD_BATCH_MAX_BYTES, g as createDeviceProxy, gi as RECORD_DELETE_BATCH, h as isDeviceScopedCap, hi as RECORD_DEFAULT_MAX_DATA_BYTES, ii as collectSecretLeaves, ir as assertValidDeclaration, it as MIGRATION_API_VERSION, ji as normalizeSecretOwner, jn as REVALIDATE_AFTER_MS, jr as BaseAddon, ki as globalSecretScope, kn as assertTransactScope, kr as readErrorI18n, li as recordSecretRef, lr as isZodSecret, m as DEVICE_SCOPED_CAPS, mi as RECORD_DATABASES, ni as secretViewsOf, nr as RecordRetentionSchema, nt as PipelineRunResultBridge, o as asJsonObject, oi as parseSecretPath, or as defineRecordKinds, ot as deviceOpsCapability, p as BOOT_RECOVERY_BACKOFF_MS, pi as RECORD_CLASSES, qi as RecordUniqueViolationError, qr as resolvedValues, r as maskUrlCredentials, ri as REMOVE_LEAF, rr as StoredRecordKindDeclarationSchema, rt as PipelineStepInputSchema, si as recordArrayItemPath, st as DEVICE_CHILDREN_BATCH_MAX, t as sleep, tr as RecordKindNameSchema, tt as switchRefusesSetState, ua as createEvent, ui as secretArrayPrefixes, ut as addonPagesSourceCapability, v as addonSliceHandleApi, vi as RECORD_MAX_DATA_BYTES, wa as isSecretFieldView, wi as RECORD_SWEEP_INTERVAL_MS, wn as OnBehalfSourceSchema, xa as SECRET_CLEAR, xi as RECORD_QUERY_MAX, xt as MODEL_FORMATS, y as createEventBusSliceSource, yi as RECORD_MAX_INDEXES, z as isCapMethodAbsent, zi as ForeignSecretMarkerError, zn as shortSecretRefHash } from "./sleep-DO-ayTnk.mjs";
|
|
2
2
|
import { t as EventCategory } from "./event-category-CY27-fF0.mjs";
|
|
3
3
|
import { a as DeviceType, s as errMsg, t as COMPOSED_DEVICE_STABLE_ID_PREFIX } from "./composed-stable-id-BNTaDZEh.mjs";
|
|
4
4
|
//#region src/generated/cap-input-defaults.ts
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { type InferProvider } from './capability-definition.js';
|
|
3
|
+
/**
|
|
4
|
+
* device-state-refresh — the HOW of a device's state refresh, called by the
|
|
5
|
+
* core, which owns the WHEN (D1062).
|
|
6
|
+
*
|
|
7
|
+
* The provider registers it per device with its policy
|
|
8
|
+
* (`registerNativeCap(cap, provider, { stateRefresh })`). The hub's scheduler
|
|
9
|
+
* calls `refresh` on the schedule, after a command and in the burst that
|
|
10
|
+
* follows it, and `resubscribe` when a push integration fell silent. The
|
|
11
|
+
* provider re-reads and writes the slices it already writes; nothing is
|
|
12
|
+
* returned but completion.
|
|
13
|
+
*/
|
|
14
|
+
export declare const DeviceStateRefreshInputSchema: z.ZodObject<{
|
|
15
|
+
deviceId: z.ZodNumber;
|
|
16
|
+
deviceIds: z.ZodArray<z.ZodNumber>;
|
|
17
|
+
reason: z.ZodEnum<{
|
|
18
|
+
burst: "burst";
|
|
19
|
+
command: "command";
|
|
20
|
+
schedule: "schedule";
|
|
21
|
+
}>;
|
|
22
|
+
}, z.core.$strip>;
|
|
23
|
+
export type DeviceStateRefreshInput = z.infer<typeof DeviceStateRefreshInputSchema>;
|
|
24
|
+
export declare const DeviceStateResubscribeInputSchema: z.ZodObject<{
|
|
25
|
+
deviceId: z.ZodNumber;
|
|
26
|
+
}, z.core.$strip>;
|
|
27
|
+
export declare const DeviceStateRefreshResultSchema: z.ZodObject<{
|
|
28
|
+
ok: z.ZodLiteral<true>;
|
|
29
|
+
}, z.core.$strip>;
|
|
30
|
+
export declare const deviceStateRefreshCapability: {
|
|
31
|
+
readonly name: 'device-state-refresh';
|
|
32
|
+
readonly scope: 'device';
|
|
33
|
+
readonly deviceNative: true;
|
|
34
|
+
readonly mode: 'singleton';
|
|
35
|
+
readonly methods: {
|
|
36
|
+
readonly refresh: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
|
|
37
|
+
deviceId: z.ZodNumber;
|
|
38
|
+
deviceIds: z.ZodArray<z.ZodNumber>;
|
|
39
|
+
reason: z.ZodEnum<{
|
|
40
|
+
burst: "burst";
|
|
41
|
+
command: "command";
|
|
42
|
+
schedule: "schedule";
|
|
43
|
+
}>;
|
|
44
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
45
|
+
ok: z.ZodLiteral<true>;
|
|
46
|
+
}, z.core.$strip>, "mutation">;
|
|
47
|
+
readonly resubscribe: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
|
|
48
|
+
deviceId: z.ZodNumber;
|
|
49
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
50
|
+
ok: z.ZodLiteral<true>;
|
|
51
|
+
}, z.core.$strip>, "mutation">;
|
|
52
|
+
};
|
|
53
|
+
readonly vocabulary: {
|
|
54
|
+
readonly noun: import("../index.js").VocabL10n;
|
|
55
|
+
readonly order: 3247;
|
|
56
|
+
};
|
|
57
|
+
};
|
|
58
|
+
export type IDeviceStateRefreshProvider = InferProvider<typeof deviceStateRefreshCapability>;
|
|
@@ -261,6 +261,7 @@ export { type IRunningStateProvider, type RunningStateSource, RunningStateSource
|
|
|
261
261
|
export { type IRebootProvider, rebootCapability } from './reboot.cap.js';
|
|
262
262
|
export { type ILowPowerSleepProvider, type LowPowerSleepStatus, LowPowerSleepStatusSchema, lowPowerSleepCapability, } from './low-power-sleep.cap.js';
|
|
263
263
|
export { type IResyncProvider, ResyncDeviceInputSchema, resyncCapability } from './resync.cap.js';
|
|
264
|
+
export { type DeviceStateRefreshInput, DeviceStateRefreshInputSchema, DeviceStateRefreshResultSchema, DeviceStateResubscribeInputSchema, deviceStateRefreshCapability, type IDeviceStateRefreshProvider, } from './device-state-refresh.cap.js';
|
|
264
265
|
export { type IRecordingProvider, RECORDING_SOURCE_CAMSTACK, RECORDING_SOURCE_CAMSTACK_ADDON, type RecordingAvailability, RecordingAvailabilitySchema, type RecordingDays, RecordingDaysSchema, type RecordingManifest, RecordingManifestSchema, type RecordingPlayback, RecordingPlaybackSchema, RecordingRangeSchema, type RecordingRead, RecordingReadSchema, type RecordingSource, type RecordingSourceAvailability, RecordingSourceAvailabilitySchema, type RecordingSourceOptions, RecordingSourceOptionsSchema, RecordingSourceSchema, recordingCapability, } from './recording.cap.js';
|
|
265
266
|
export { type IRecordingArchiveProvider, type LocateSegmentResult, LocateSegmentResultSchema, RECORDING_TIMELINE_BATCH_MAX, type ReadGopBytesResult, ReadGopBytesResultSchema, type ReadSegmentBytesResult, ReadSegmentBytesResultSchema, type ReadWindowBytesResult, ReadWindowBytesResultSchema, type RecordingAvailabilityForDevice, RecordingAvailabilityForDeviceSchema, type RecordingDaysForDevice, RecordingDaysForDeviceSchema, type RecordingDeviceUsage, RecordingDeviceUsageSchema, type RecordingLocationUsage, RecordingLocationUsageSchema, type RecordingRebalanceInput, RecordingRebalanceInputSchema, type RecordingRebalanceMove, RecordingRebalanceMoveSchema, type RecordingRebalancePlan, RecordingRebalancePlanSchema, type RecordingRebalanceSkip, type RecordingRebalanceSkipReason, RecordingRebalanceSkipReasonSchema, RecordingRebalanceSkipSchema, type RecordingStatus, RecordingStatusSchema, type RecordingStorageUsage, RecordingStorageUsageSchema, recordingArchiveCapability, } from './recording-archive.cap.js';
|
|
266
267
|
export { type ClipExportFailure, ClipExportFailureSchema, clipExportFailure, clipExportFailureOf, EXPORT_DENSE_MAX_RANGES, type ExportBytes, ExportBytesSchema, type ExportClipSubject, ExportClipSubjectSchema, type ExportDense, type ExportDenseRange, ExportDenseRangeSchema, ExportDenseSchema, type ExportDownload, ExportDownloadSchema, type ExportFootageSubject, ExportFootageSubjectSchema, type ExportOptions, ExportOptionsSchema, type ExportRecord, ExportRecordSchema, ExportSpeedSchema, type ExportState, ExportStateSchema, type ExportSubject, ExportSubjectSchema, ExportTimelapseSchema, exportSubjectOf, type IRecordingExportProvider, RECORDING_EXPORT_MAX_READ_BYTES, recordingExportCapability, resolveCreateExportSubject, resolveExportProfiles, } from './recording-export.cap.js';
|
|
@@ -463,6 +464,7 @@ import type { runningStateCapability } from './running-state.cap.js';
|
|
|
463
464
|
import type { rebootCapability } from './reboot.cap.js';
|
|
464
465
|
import type { lowPowerSleepCapability } from './low-power-sleep.cap.js';
|
|
465
466
|
import type { resyncCapability } from './resync.cap.js';
|
|
467
|
+
import type { deviceStateRefreshCapability } from './device-state-refresh.cap.js';
|
|
466
468
|
import type { recordingCapability } from './recording.cap.js';
|
|
467
469
|
import type { recordingArchiveCapability } from './recording-archive.cap.js';
|
|
468
470
|
import type { recordingExportCapability } from './recording-export.cap.js';
|
|
@@ -511,6 +513,6 @@ import type { trainingProviderCapability } from './training-provider.cap.js';
|
|
|
511
513
|
import type { zoneAnalyticsCapability } from './zone-analytics.cap.js';
|
|
512
514
|
import type { zoneRulesCapability } from './zone-rules.cap.js';
|
|
513
515
|
import type { zonesCapability } from './zones.cap.js';
|
|
514
|
-
type AnyCapability = typeof streamSignalsCapability | typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageMigrationCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof storageOccupancyCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof dataStoreProviderCapability | typeof databaseSnapshotCapability | typeof migrationsCapability | typeof storageAdminCapability | typeof recordsCapability | typeof recordEntriesCapability | typeof deviceHistoryCapability | typeof deviceRunsCapability | typeof deviceTransitionsCapability | typeof timedRunCapability | typeof doNotDisturbCapability | typeof keychainCapability | typeof keychainAdminCapability | typeof deviceCredentialsCapability | typeof nodeCertificatesCapability | typeof logChannelsCapability | typeof logDestinationCapability | typeof loadContributionCapability | typeof failureContributionCapability | typeof deviceRemovalHookCapability | typeof nodeRemovalHookCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceAdminLinkCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof calendarSourceCapability | typeof calendarsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof vectorStoreCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof boardKeySourceCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof composerCapability | typeof coreBlocksCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof navigationCapability | typeof consumablesCapability | typeof runningStateCapability | typeof rebootCapability | typeof lowPowerSleepCapability | typeof resyncCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof weatherStationCapability | typeof imageCapability | typeof lockControlCapability | typeof powerSourceCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof petFountainCapability | typeof pumpCycleCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof meterCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof actionSourceCapability | typeof actionsCapability | typeof schedulersCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof sirenCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof trainingCapability | typeof trainingProviderCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof groupActiveCapability | typeof groupCommandsCapability | typeof groupStatusCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof heatingValveCapability | typeof heatPumpStatusCapability | typeof energySystemCapability | typeof workloadCapability | typeof heatPumpControlCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof recordingArchiveCapability | typeof recordingExportCapability | typeof recordingSignalCapability | typeof deviceOpsCapability | typeof displayPaletteCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof clusterUpdateCapability | typeof integrationsCapability | typeof integrationInstancesCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof cameraGridLayoutCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof recordingOnboardCapability | typeof imageSettingsCapability | typeof osdCapability | typeof osdManagerCapability | typeof accessoriesCapability | typeof batteryCapability | typeof errorCapability | typeof networkLinkCapability | typeof buttonCapability | typeof irTransmitterCapability | typeof remoteCapability | typeof heroLayoutCapability | typeof fanPresetsCapability | typeof templateCapability | typeof tagsCapability | typeof remoteLayoutComponentsCapability | typeof cameraCredentialsCapability | typeof deviceStatusCapability | typeof doorbellCapability | typeof eventEmitterCapability | typeof faceGalleryCapability | typeof featureProbeCapability | typeof intercomCapability | typeof nativeObjectDetectionCapability | typeof plateGalleryCapability | typeof switchCapability | typeof updateCapability | typeof videoclipsCapability | typeof deviceExtensionCapability | typeof dishwasherCapability;
|
|
516
|
+
type AnyCapability = typeof streamSignalsCapability | typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageMigrationCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof storageOccupancyCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof dataStoreProviderCapability | typeof databaseSnapshotCapability | typeof migrationsCapability | typeof storageAdminCapability | typeof recordsCapability | typeof recordEntriesCapability | typeof deviceHistoryCapability | typeof deviceRunsCapability | typeof deviceTransitionsCapability | typeof timedRunCapability | typeof doNotDisturbCapability | typeof keychainCapability | typeof keychainAdminCapability | typeof deviceCredentialsCapability | typeof nodeCertificatesCapability | typeof logChannelsCapability | typeof logDestinationCapability | typeof loadContributionCapability | typeof failureContributionCapability | typeof deviceRemovalHookCapability | typeof nodeRemovalHookCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceAdminLinkCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof calendarSourceCapability | typeof calendarsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof vectorStoreCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof boardKeySourceCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof composerCapability | typeof coreBlocksCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof navigationCapability | typeof consumablesCapability | typeof runningStateCapability | typeof rebootCapability | typeof lowPowerSleepCapability | typeof resyncCapability | typeof deviceStateRefreshCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof weatherStationCapability | typeof imageCapability | typeof lockControlCapability | typeof powerSourceCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof petFountainCapability | typeof pumpCycleCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof meterCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof actionSourceCapability | typeof actionsCapability | typeof schedulersCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof sirenCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof trainingCapability | typeof trainingProviderCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof groupActiveCapability | typeof groupCommandsCapability | typeof groupStatusCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof heatingValveCapability | typeof heatPumpStatusCapability | typeof energySystemCapability | typeof workloadCapability | typeof heatPumpControlCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof recordingArchiveCapability | typeof recordingExportCapability | typeof recordingSignalCapability | typeof deviceOpsCapability | typeof displayPaletteCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof clusterUpdateCapability | typeof integrationsCapability | typeof integrationInstancesCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof cameraGridLayoutCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof recordingOnboardCapability | typeof imageSettingsCapability | typeof osdCapability | typeof osdManagerCapability | typeof accessoriesCapability | typeof batteryCapability | typeof errorCapability | typeof networkLinkCapability | typeof buttonCapability | typeof irTransmitterCapability | typeof remoteCapability | typeof heroLayoutCapability | typeof fanPresetsCapability | typeof templateCapability | typeof tagsCapability | typeof remoteLayoutComponentsCapability | typeof cameraCredentialsCapability | typeof deviceStatusCapability | typeof doorbellCapability | typeof eventEmitterCapability | typeof faceGalleryCapability | typeof featureProbeCapability | typeof intercomCapability | typeof nativeObjectDetectionCapability | typeof plateGalleryCapability | typeof switchCapability | typeof updateCapability | typeof videoclipsCapability | typeof deviceExtensionCapability | typeof dishwasherCapability;
|
|
515
517
|
export type CapabilityName = AnyCapability['name'];
|
|
516
518
|
export type ITypedReadinessRegistry = IReadinessRegistry<CapabilityName>;
|
package/dist/client.js
CHANGED
|
@@ -27799,6 +27799,10 @@ function createDeviceProxy(api, binding, opts) {
|
|
|
27799
27799
|
getRun: (input, options) => dispatch("device-runs", "deviceRuns", "getRun", "query", input, void 0, options),
|
|
27800
27800
|
getCurrentRun: (input, options) => dispatch("device-runs", "deviceRuns", "getCurrentRun", "query", input, void 0, options)
|
|
27801
27801
|
};
|
|
27802
|
+
const deviceStateRefreshInterface = {
|
|
27803
|
+
refresh: (input, options) => dispatch("device-state-refresh", "deviceStateRefresh", "refresh", "mutation", input, void 0, options),
|
|
27804
|
+
resubscribe: (input, options) => dispatch("device-state-refresh", "deviceStateRefresh", "resubscribe", "mutation", input, void 0, options)
|
|
27805
|
+
};
|
|
27802
27806
|
const deviceStatusInterface = { getStatus: (input, options) => dispatch("device-status", "deviceStatus", "getStatus", "query", input, void 0, options) };
|
|
27803
27807
|
const deviceTransitionsInterface = {
|
|
27804
27808
|
listTransitions: (input, options) => dispatch("device-transitions", "deviceTransitions", "listTransitions", "query", input, void 0, options),
|
|
@@ -28582,6 +28586,7 @@ function createDeviceProxy(api, binding, opts) {
|
|
|
28582
28586
|
...bound("device-extension") ? { deviceExtension: deviceExtensionInterface } : {},
|
|
28583
28587
|
...bound("device-ops") ? { deviceOps: deviceOpsInterface } : {},
|
|
28584
28588
|
...bound("device-runs") ? { deviceRuns: deviceRunsInterface } : {},
|
|
28589
|
+
...bound("device-state-refresh") ? { deviceStateRefresh: deviceStateRefreshInterface } : {},
|
|
28585
28590
|
...bound("device-status") ? { deviceStatus: deviceStatusInterface } : {},
|
|
28586
28591
|
...bound("device-transitions") ? { deviceTransitions: deviceTransitionsInterface } : {},
|
|
28587
28592
|
...bound("dishwasher") ? { dishwasher: dishwasherInterface } : {},
|
package/dist/client.mjs
CHANGED
|
@@ -27798,6 +27798,10 @@ function createDeviceProxy(api, binding, opts) {
|
|
|
27798
27798
|
getRun: (input, options) => dispatch("device-runs", "deviceRuns", "getRun", "query", input, void 0, options),
|
|
27799
27799
|
getCurrentRun: (input, options) => dispatch("device-runs", "deviceRuns", "getCurrentRun", "query", input, void 0, options)
|
|
27800
27800
|
};
|
|
27801
|
+
const deviceStateRefreshInterface = {
|
|
27802
|
+
refresh: (input, options) => dispatch("device-state-refresh", "deviceStateRefresh", "refresh", "mutation", input, void 0, options),
|
|
27803
|
+
resubscribe: (input, options) => dispatch("device-state-refresh", "deviceStateRefresh", "resubscribe", "mutation", input, void 0, options)
|
|
27804
|
+
};
|
|
27801
27805
|
const deviceStatusInterface = { getStatus: (input, options) => dispatch("device-status", "deviceStatus", "getStatus", "query", input, void 0, options) };
|
|
27802
27806
|
const deviceTransitionsInterface = {
|
|
27803
27807
|
listTransitions: (input, options) => dispatch("device-transitions", "deviceTransitions", "listTransitions", "query", input, void 0, options),
|
|
@@ -28581,6 +28585,7 @@ function createDeviceProxy(api, binding, opts) {
|
|
|
28581
28585
|
...bound("device-extension") ? { deviceExtension: deviceExtensionInterface } : {},
|
|
28582
28586
|
...bound("device-ops") ? { deviceOps: deviceOpsInterface } : {},
|
|
28583
28587
|
...bound("device-runs") ? { deviceRuns: deviceRunsInterface } : {},
|
|
28588
|
+
...bound("device-state-refresh") ? { deviceStateRefresh: deviceStateRefreshInterface } : {},
|
|
28584
28589
|
...bound("device-status") ? { deviceStatus: deviceStatusInterface } : {},
|
|
28585
28590
|
...bound("device-transitions") ? { deviceTransitions: deviceTransitionsInterface } : {},
|
|
28586
28591
|
...bound("dishwasher") ? { dishwasher: dishwasherInterface } : {},
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
import type { CapabilityDefinition } from '../capabilities/capability-definition.js';
|
|
13
13
|
import { type CommandEffect, type CommandSlice } from './cap-vocabulary/command-catalog.js';
|
|
14
14
|
import type { LooseVocabSideEffect } from './cap-vocabulary/types.js';
|
|
15
|
+
import type { StateRefreshPolicy } from './state-refresh.js';
|
|
15
16
|
/**
|
|
16
17
|
* How long a command is held when nothing says otherwise. Equal to the
|
|
17
18
|
* transition correlator's match window (D1022), so a hold that reverts and a
|
|
@@ -39,6 +40,11 @@ export type CommandHoldOptions = Readonly<Record<string, CommandHoldOption>>;
|
|
|
39
40
|
/** The options `registerNativeCap` takes, method names checked against the cap. */
|
|
40
41
|
export interface NativeCapOptions<TCap extends CapabilityDefinition = CapabilityDefinition> {
|
|
41
42
|
readonly commands?: Partial<Readonly<Record<keyof TCap['methods'] & string, CommandHoldOption>>>;
|
|
43
|
+
/**
|
|
44
|
+
* The device's refresh policy (D1062). Read only on the `device-state-refresh`
|
|
45
|
+
* registration: the core schedules that device's refreshes by it.
|
|
46
|
+
*/
|
|
47
|
+
readonly stateRefresh?: StateRefreshPolicy;
|
|
42
48
|
}
|
|
43
49
|
/** What the core holds for one command: the fields and the limit. */
|
|
44
50
|
export interface ResolvedCommandHold {
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Server-driven device state refresh (D1062): the core decides WHEN a device is
|
|
3
|
+
* re-read, the integration only knows HOW.
|
|
4
|
+
*
|
|
5
|
+
* A provider states its policy where it registers the device's
|
|
6
|
+
* `device-state-refresh` cap (`ctx.registerNativeCap(cap, provider, {
|
|
7
|
+
* stateRefresh })`). It reaches the hub by the road the command-hold options
|
|
8
|
+
* take (D1061): written directly in-process, carried on a forked child's cap
|
|
9
|
+
* descriptors otherwise. Plain data, wire-safe.
|
|
10
|
+
*/
|
|
11
|
+
import { z } from 'zod';
|
|
12
|
+
/** Why the core asks for a refresh. */
|
|
13
|
+
export declare const StateRefreshReasonSchema: z.ZodEnum<{
|
|
14
|
+
burst: "burst";
|
|
15
|
+
command: "command";
|
|
16
|
+
schedule: "schedule";
|
|
17
|
+
}>;
|
|
18
|
+
export type StateRefreshReason = z.infer<typeof StateRefreshReasonSchema>;
|
|
19
|
+
/**
|
|
20
|
+
* What arrives without asking: `none` (everything is read), `partial` (some
|
|
21
|
+
* fields arrive by push, the rest is read on the schedule), `full` (everything
|
|
22
|
+
* arrives by push — never read on a schedule).
|
|
23
|
+
*/
|
|
24
|
+
export declare const StateRefreshPushSchema: z.ZodEnum<{
|
|
25
|
+
full: "full";
|
|
26
|
+
none: "none";
|
|
27
|
+
partial: "partial";
|
|
28
|
+
}>;
|
|
29
|
+
export type StateRefreshPush = z.infer<typeof StateRefreshPushSchema>;
|
|
30
|
+
/** The fastest base cadence the core accepts from any provider. */
|
|
31
|
+
export declare const MIN_STATE_REFRESH_INTERVAL_MS = 1000;
|
|
32
|
+
export declare const StateRefreshPolicySchema: z.ZodObject<{
|
|
33
|
+
integrationId: z.ZodString;
|
|
34
|
+
minIntervalMs: z.ZodNumber;
|
|
35
|
+
intervalMs: z.ZodOptional<z.ZodNumber>;
|
|
36
|
+
batch: z.ZodBoolean;
|
|
37
|
+
push: z.ZodEnum<{
|
|
38
|
+
full: "full";
|
|
39
|
+
none: "none";
|
|
40
|
+
partial: "partial";
|
|
41
|
+
}>;
|
|
42
|
+
heartbeatMs: z.ZodOptional<z.ZodNumber>;
|
|
43
|
+
connectionEpoch: z.ZodOptional<z.ZodNumber>;
|
|
44
|
+
}, z.core.$strip>;
|
|
45
|
+
export type StateRefreshPolicy = z.infer<typeof StateRefreshPolicySchema>;
|
|
46
|
+
/** The cadence the core runs a policy at: the declared minimum, slowed (never sped up) by the setting. */
|
|
47
|
+
export declare function effectiveRefreshIntervalMs(policy: StateRefreshPolicy): number;
|
|
48
|
+
/** The burst after a command on a read (non-push) device: offsets from the command, in ms. */
|
|
49
|
+
export declare const COMMAND_BURST_OFFSETS_MS: readonly number[];
|
|
50
|
+
/** How long the core waits for a push device to confirm a command before reading it once. */
|
|
51
|
+
export declare const PUSH_CONFIRM_WINDOW_MS = 2500;
|
|
@@ -53,6 +53,7 @@ import type { deviceOpsCapability } from '../capabilities/device-ops.cap.js';
|
|
|
53
53
|
import type { deviceProviderCapability } from '../capabilities/device-provider.cap.js';
|
|
54
54
|
import type { deviceRemovalHookCapability } from '../capabilities/device-removal-hook.cap.js';
|
|
55
55
|
import type { deviceRunsCapability } from '../capabilities/device-runs.cap.js';
|
|
56
|
+
import type { deviceStateRefreshCapability } from '../capabilities/device-state-refresh.cap.js';
|
|
56
57
|
import type { deviceStateCapability } from '../capabilities/device-state.cap.js';
|
|
57
58
|
import type { deviceTransitionsCapability } from '../capabilities/device-transitions.cap.js';
|
|
58
59
|
import type { dishwasherCapability } from '../capabilities/dishwasher.cap.js';
|
|
@@ -3660,6 +3661,27 @@ export type AppRouter = TrpcCoreRouter<{
|
|
|
3660
3661
|
meta: object;
|
|
3661
3662
|
}>;
|
|
3662
3663
|
}>>;
|
|
3664
|
+
deviceStateRefresh: TRPCBuiltRouter<{
|
|
3665
|
+
ctx: TrpcContext;
|
|
3666
|
+
meta: object;
|
|
3667
|
+
errorShape: AugmentedErrorShape;
|
|
3668
|
+
transformer: true;
|
|
3669
|
+
}, TRPCDecorateCreateRouterOptions<{
|
|
3670
|
+
refresh: TRPCMutationProcedure<{
|
|
3671
|
+
input: {
|
|
3672
|
+
[x: string]: unknown;
|
|
3673
|
+
} & z.input<typeof deviceStateRefreshCapability.methods.refresh.input>;
|
|
3674
|
+
output: z.infer<typeof deviceStateRefreshCapability.methods.refresh.output>;
|
|
3675
|
+
meta: object;
|
|
3676
|
+
}>;
|
|
3677
|
+
resubscribe: TRPCMutationProcedure<{
|
|
3678
|
+
input: {
|
|
3679
|
+
[x: string]: unknown;
|
|
3680
|
+
} & z.input<typeof deviceStateRefreshCapability.methods.resubscribe.input>;
|
|
3681
|
+
output: z.infer<typeof deviceStateRefreshCapability.methods.resubscribe.output>;
|
|
3682
|
+
meta: object;
|
|
3683
|
+
}>;
|
|
3684
|
+
}>>;
|
|
3663
3685
|
deviceStatus: TRPCBuiltRouter<{
|
|
3664
3686
|
ctx: TrpcContext;
|
|
3665
3687
|
meta: object;
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { CapVocabularyMap } from '../device/cap-vocabulary/types.js';
|
|
2
2
|
/**
|
|
3
3
|
* THE cap vocabulary (D920), projected from the declarations of every
|
|
4
|
-
* `*.cap.ts` (D1050):
|
|
4
|
+
* `*.cap.ts` (D1050): 214 caps (112 device, 102 system).
|
|
5
5
|
* Device caps in their declared picker order, then system caps by name.
|
|
6
6
|
*/
|
|
7
7
|
export declare const CAP_VOCABULARY: CapVocabularyMap;
|
|
@@ -61,6 +61,7 @@ export { deviceProviderCapability } from '../capabilities/device-provider.cap.js
|
|
|
61
61
|
export { deviceRemovalHookCapability } from '../capabilities/device-removal-hook.cap.js';
|
|
62
62
|
export { deviceRunsCapability } from '../capabilities/device-runs.cap.js';
|
|
63
63
|
export { deviceStateCapability } from '../capabilities/device-state.cap.js';
|
|
64
|
+
export { deviceStateRefreshCapability } from '../capabilities/device-state-refresh.cap.js';
|
|
64
65
|
export { deviceStatusCapability } from '../capabilities/device-status.cap.js';
|
|
65
66
|
export { deviceTransitionsCapability } from '../capabilities/device-transitions.cap.js';
|
|
66
67
|
export { dishwasherCapability } from '../capabilities/dishwasher.cap.js';
|
|
@@ -275,6 +276,7 @@ export declare const CAPABILITY_NAMES: {
|
|
|
275
276
|
readonly deviceRemovalHook: 'device-removal-hook';
|
|
276
277
|
readonly deviceRuns: 'device-runs';
|
|
277
278
|
readonly deviceState: 'device-state';
|
|
279
|
+
readonly deviceStateRefresh: 'device-state-refresh';
|
|
278
280
|
readonly deviceStatus: 'device-status';
|
|
279
281
|
readonly deviceTransitions: 'device-transitions';
|
|
280
282
|
readonly dishwasher: 'dishwasher';
|
|
@@ -502,6 +504,7 @@ export interface CapabilityRouterMap<TRouter = unknown> {
|
|
|
502
504
|
readonly deviceRemovalHook: TRouter;
|
|
503
505
|
readonly deviceRuns: TRouter;
|
|
504
506
|
readonly deviceState: TRouter;
|
|
507
|
+
readonly deviceStateRefresh: TRouter;
|
|
505
508
|
readonly deviceStatus: TRouter;
|
|
506
509
|
readonly deviceTransitions: TRouter;
|
|
507
510
|
readonly dishwasher: TRouter;
|
|
@@ -653,8 +656,8 @@ export interface CapabilityRouterMap<TRouter = unknown> {
|
|
|
653
656
|
readonly zoneRules: TRouter;
|
|
654
657
|
readonly zones: TRouter;
|
|
655
658
|
}
|
|
656
|
-
/** Capability names whose mode is `singleton` (
|
|
657
|
-
export declare const SINGLETON_CAPABILITY_NAMES: readonly ['accessories', 'actions', 'addon-pages', 'addon-settings', 'addon-widgets', 'addons', 'admin-ui', 'air-quality-sensor', 'alarm-panel', 'alerts', 'ambient-light-sensor', 'audio-analysis', 'audio-analyzer', 'audio-codec', 'audio-metrics', 'automation-control', 'backup', 'battery', 'binary', 'brightness', 'button', 'calendars', 'camera-credentials', 'camera-grid-layout', 'camera-pipeline-config', 'camera-streams', 'carbon-monoxide', 'climate-control', 'cluster-update', 'color', 'composer', 'connectivity', 'consumables', 'contact', 'control', 'core-blocks', 'cover', 'database-snapshot', 'day-night', 'decoder', 'detection-pipeline', 'device-admin-link', 'device-credentials', 'device-history', 'device-manager', 'device-ops', 'device-runs', 'device-state', 'device-status', 'device-transitions', 'dishwasher', 'display-palette', 'do-not-disturb', 'doorbell', 'energy-system', 'enum-sensor', 'error', 'event-emitter', 'face-gallery', 'fan-control', 'fan-presets', 'feature-probe', 'filesystem-browse', 'flood', 'gas', 'group-active', 'group-commands', 'group-status', 'heat-pump-control', 'heat-pump-status', 'heating-valve', 'hero-layout', 'humidifier', 'humidity-sensor', 'image', 'image-settings', 'integrations', 'intercom', 'ir-transmitter', 'keychain', 'keychain-admin', 'lawn-mower-control', 'llm-runtime', 'local-network', 'lock-control', 'low-power-sleep', 'media-player', 'meter', 'metrics-provider', 'migrations', 'model-convert', 'model-distributor', 'motion', 'motion-detection', 'motion-trigger', 'motion-zones', 'native-object-detection', 'navigation', 'network-link', 'network-quality', 'node-certificates', 'nodes', 'notification-rules', 'notifier', 'numeric-sensor', 'osd', 'osd-manager', 'pet-feeder', 'pet-fountain', 'pipeline-analytics', 'pipeline-executor', 'pipeline-orchestrator', 'pipeline-runner', 'plate-gallery', 'platform-probe', 'power-meter', 'power-source', 'presence', 'pressure-sensor', 'privacy-mask', 'ptz', 'ptz-autotrack', 'pump-cycle', 'reboot', 'record-entries', 'recording-archive', 'recording-export', 'recording-onboard', 'recording-signal', 'records', 'remote', 'resync', 'running-state', 'scene-monitor', 'schedulers', 'script-runner', 'server-management', 'settings-store', 'siren', 'smoke', 'snapshot', 'sso-bridge', 'storage', 'storage-admin', 'storage-migration', 'stream-broker', 'stream-catalog', 'stream-params', 'stream-signals', 'switch', 'system', 'tags', 'tamper', 'temperature-sensor', 'terminal-session', 'timed-run', 'toast', 'training', 'update', 'user-management', 'vacuum-control', 'valve', 'vector-store', 'vibration', 'viewer-ui', 'water-heater', 'weather', 'weather-station', 'webrtc-session', 'workload', 'zone-analytics', 'zone-rules', 'zones'];
|
|
659
|
+
/** Capability names whose mode is `singleton` (174 caps). */
|
|
660
|
+
export declare const SINGLETON_CAPABILITY_NAMES: readonly ['accessories', 'actions', 'addon-pages', 'addon-settings', 'addon-widgets', 'addons', 'admin-ui', 'air-quality-sensor', 'alarm-panel', 'alerts', 'ambient-light-sensor', 'audio-analysis', 'audio-analyzer', 'audio-codec', 'audio-metrics', 'automation-control', 'backup', 'battery', 'binary', 'brightness', 'button', 'calendars', 'camera-credentials', 'camera-grid-layout', 'camera-pipeline-config', 'camera-streams', 'carbon-monoxide', 'climate-control', 'cluster-update', 'color', 'composer', 'connectivity', 'consumables', 'contact', 'control', 'core-blocks', 'cover', 'database-snapshot', 'day-night', 'decoder', 'detection-pipeline', 'device-admin-link', 'device-credentials', 'device-history', 'device-manager', 'device-ops', 'device-runs', 'device-state', 'device-state-refresh', 'device-status', 'device-transitions', 'dishwasher', 'display-palette', 'do-not-disturb', 'doorbell', 'energy-system', 'enum-sensor', 'error', 'event-emitter', 'face-gallery', 'fan-control', 'fan-presets', 'feature-probe', 'filesystem-browse', 'flood', 'gas', 'group-active', 'group-commands', 'group-status', 'heat-pump-control', 'heat-pump-status', 'heating-valve', 'hero-layout', 'humidifier', 'humidity-sensor', 'image', 'image-settings', 'integrations', 'intercom', 'ir-transmitter', 'keychain', 'keychain-admin', 'lawn-mower-control', 'llm-runtime', 'local-network', 'lock-control', 'low-power-sleep', 'media-player', 'meter', 'metrics-provider', 'migrations', 'model-convert', 'model-distributor', 'motion', 'motion-detection', 'motion-trigger', 'motion-zones', 'native-object-detection', 'navigation', 'network-link', 'network-quality', 'node-certificates', 'nodes', 'notification-rules', 'notifier', 'numeric-sensor', 'osd', 'osd-manager', 'pet-feeder', 'pet-fountain', 'pipeline-analytics', 'pipeline-executor', 'pipeline-orchestrator', 'pipeline-runner', 'plate-gallery', 'platform-probe', 'power-meter', 'power-source', 'presence', 'pressure-sensor', 'privacy-mask', 'ptz', 'ptz-autotrack', 'pump-cycle', 'reboot', 'record-entries', 'recording-archive', 'recording-export', 'recording-onboard', 'recording-signal', 'records', 'remote', 'resync', 'running-state', 'scene-monitor', 'schedulers', 'script-runner', 'server-management', 'settings-store', 'siren', 'smoke', 'snapshot', 'sso-bridge', 'storage', 'storage-admin', 'storage-migration', 'stream-broker', 'stream-catalog', 'stream-params', 'stream-signals', 'switch', 'system', 'tags', 'tamper', 'temperature-sensor', 'terminal-session', 'timed-run', 'toast', 'training', 'update', 'user-management', 'vacuum-control', 'valve', 'vector-store', 'vibration', 'viewer-ui', 'water-heater', 'weather', 'weather-station', 'webrtc-session', 'workload', 'zone-analytics', 'zone-rules', 'zones'];
|
|
658
661
|
/** Union of singleton capability names (literal string union). */
|
|
659
662
|
export type SingletonCapabilityName = typeof SINGLETON_CAPABILITY_NAMES[number];
|
|
660
663
|
/** Capability names whose mode is `collection` (40 caps). */
|
|
@@ -31,6 +31,7 @@ import type { deviceAdminLinkCapability } from '../capabilities/device-admin-lin
|
|
|
31
31
|
import type { deviceExtensionCapability } from '../capabilities/device-extension.cap.js';
|
|
32
32
|
import type { deviceOpsCapability } from '../capabilities/device-ops.cap.js';
|
|
33
33
|
import type { deviceRunsCapability } from '../capabilities/device-runs.cap.js';
|
|
34
|
+
import type { deviceStateRefreshCapability } from '../capabilities/device-state-refresh.cap.js';
|
|
34
35
|
import type { deviceStatusCapability } from '../capabilities/device-status.cap.js';
|
|
35
36
|
import type { deviceTransitionsCapability } from '../capabilities/device-transitions.cap.js';
|
|
36
37
|
import type { dishwasherCapability } from '../capabilities/dishwasher.cap.js';
|
|
@@ -275,6 +276,7 @@ export interface DeviceProxy {
|
|
|
275
276
|
readonly deviceExtension?: InferDeviceProxyCap<typeof deviceExtensionCapability>;
|
|
276
277
|
readonly deviceOps?: InferDeviceProxyCap<typeof deviceOpsCapability>;
|
|
277
278
|
readonly deviceRuns?: InferDeviceProxyCap<typeof deviceRunsCapability>;
|
|
279
|
+
readonly deviceStateRefresh?: InferDeviceProxyCap<typeof deviceStateRefreshCapability>;
|
|
278
280
|
readonly deviceStatus?: InferDeviceProxyCap<typeof deviceStatusCapability>;
|
|
279
281
|
readonly deviceTransitions?: InferDeviceProxyCap<typeof deviceTransitionsCapability>;
|
|
280
282
|
readonly dishwasher?: InferDeviceProxyCap<typeof dishwasherCapability>;
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* can answer "may a rule actuate this?" without importing the schema barrel
|
|
6
6
|
* (~144MB RSS per runner, D28).
|
|
7
7
|
*
|
|
8
|
-
* Coverage:
|
|
8
|
+
* Coverage: 112 device-scoped capabilities.
|
|
9
9
|
*/
|
|
10
10
|
export declare const DEVICE_SCOPED_CAPS: ReadonlySet<string>;
|
|
11
11
|
/**
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
* scope+access check inside `protectedProcedure` (see
|
|
7
7
|
* `server/backend/src/api/trpc/trpc.middleware.ts`).
|
|
8
8
|
*
|
|
9
|
-
* Coverage:
|
|
9
|
+
* Coverage: 1524 method paths across 214 capabilities.
|
|
10
10
|
*/
|
|
11
11
|
import type { MethodRole } from '../auth/viewer-access.js';
|
|
12
12
|
import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
* system-scope cap that takes a deviceId was previously never device-filtered
|
|
7
7
|
* — see the generator header).
|
|
8
8
|
*
|
|
9
|
-
* Coverage:
|
|
9
|
+
* Coverage: 645 methods carry a device reference, of which
|
|
10
10
|
* 199 are on SYSTEM-scope caps.
|
|
11
11
|
*
|
|
12
12
|
* Top-level fields, number arrays, and one-level arrays of objects carrying
|
package/dist/index.d.ts
CHANGED
|
@@ -493,4 +493,5 @@ export * from './migrations/api/migration-api-ports.js';
|
|
|
493
493
|
export { normalizeSearchText, searchRank, type SearchRankFields } from './search/search-match.js';
|
|
494
494
|
export { DEFAULT_COMMAND_HOLD_MS, MAX_COMMAND_HOLD_MS, resolveCommandHold, } from './device/command-hold.js';
|
|
495
495
|
export { ONE_SHOT_HOLD_MS } from './device/cap-vocabulary/hold-limits.js';
|
|
496
|
+
export { COMMAND_BURST_OFFSETS_MS, effectiveRefreshIntervalMs, MIN_STATE_REFRESH_INTERVAL_MS, PUSH_CONFIRM_WINDOW_MS, type StateRefreshPolicy, StateRefreshPolicySchema, type StateRefreshPush, StateRefreshPushSchema, type StateRefreshReason, StateRefreshReasonSchema, } from './device/state-refresh.js';
|
|
496
497
|
export type { CommandHoldOption, CommandHoldOptions, NativeCapOptions, ResolvedCommandHold, } from './device/command-hold.js';
|