@camstack/types 1.2.591 → 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 +15 -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/device-state.cap.d.ts +4 -1
- package/dist/capabilities/index.d.ts +3 -1
- package/dist/client.js +53 -0
- package/dist/client.mjs +53 -0
- package/dist/device/cap-vocabulary/command-catalog.d.ts +34 -1
- package/dist/device/cap-vocabulary/declaration.d.ts +21 -1
- package/dist/device/cap-vocabulary/hold-limits.d.ts +8 -0
- package/dist/device/cap-vocabulary/index.d.ts +3 -2
- package/dist/device/cap-vocabulary/types.d.ts +68 -0
- package/dist/device/command-hold.d.ts +60 -0
- package/dist/device/device-context.d.ts +5 -2
- 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 +6 -2
- package/dist/index.js +457 -10
- package/dist/index.mjs +439 -11
- package/dist/{sleep-BA_SIc0O.js → sleep-BOK28JE0.js} +429 -45
- package/dist/{sleep-BT1bLgPq.mjs → sleep-DO-ayTnk.mjs} +406 -46
- package/package.json +1 -1
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The command hold (D1061): the core shows a commanded value at once, by
|
|
3
|
+
* default, until the device confirms it, the call is refused, or the limit
|
|
4
|
+
* elapses. The vocabulary says WHAT a command leads to (`effect`,
|
|
5
|
+
* `sideEffects`); a provider may say, at its registration, that a method is
|
|
6
|
+
* never held, held longer or shorter, or leads to other fields. Never in a
|
|
7
|
+
* `*.cap.ts` or a manifest (D4).
|
|
8
|
+
*
|
|
9
|
+
* Pure: the resolution below reads the vocabulary and the option only, so the
|
|
10
|
+
* hub mirror and a spec ask the same question.
|
|
11
|
+
*/
|
|
12
|
+
import type { CapabilityDefinition } from '../capabilities/capability-definition.js';
|
|
13
|
+
import { type CommandEffect, type CommandSlice } from './cap-vocabulary/command-catalog.js';
|
|
14
|
+
import type { LooseVocabSideEffect } from './cap-vocabulary/types.js';
|
|
15
|
+
import type { StateRefreshPolicy } from './state-refresh.js';
|
|
16
|
+
/**
|
|
17
|
+
* How long a command is held when nothing says otherwise. Equal to the
|
|
18
|
+
* transition correlator's match window (D1022), so a hold that reverts and a
|
|
19
|
+
* command recorded `unconfirmed` are the same event.
|
|
20
|
+
*/
|
|
21
|
+
export declare const DEFAULT_COMMAND_HOLD_MS = 30000;
|
|
22
|
+
/** The longest hold a provider may ask for: a value the device never confirms is not shown for long. */
|
|
23
|
+
export declare const MAX_COMMAND_HOLD_MS = 120000;
|
|
24
|
+
/** A provider's word on one command method. */
|
|
25
|
+
export type CommandHoldOption =
|
|
26
|
+
/** Never held: the slice moves only when the device reports. */
|
|
27
|
+
{
|
|
28
|
+
readonly hold: 'never';
|
|
29
|
+
} | {
|
|
30
|
+
readonly hold?: undefined;
|
|
31
|
+
/** The limit, in ms (clamped to 1 … {@link MAX_COMMAND_HOLD_MS}); absent = {@link DEFAULT_COMMAND_HOLD_MS}. */
|
|
32
|
+
readonly holdMs?: number;
|
|
33
|
+
/** REPLACES the vocabulary's effects for this method. */
|
|
34
|
+
readonly effects?: readonly LooseVocabSideEffect[];
|
|
35
|
+
/** Held IN ADDITION to the vocabulary's effects (a field already named keeps the first). */
|
|
36
|
+
readonly extraEffects?: readonly LooseVocabSideEffect[];
|
|
37
|
+
};
|
|
38
|
+
/** A provider's options, keyed by cap method name. Wire-safe (plain data). */
|
|
39
|
+
export type CommandHoldOptions = Readonly<Record<string, CommandHoldOption>>;
|
|
40
|
+
/** The options `registerNativeCap` takes, method names checked against the cap. */
|
|
41
|
+
export interface NativeCapOptions<TCap extends CapabilityDefinition = CapabilityDefinition> {
|
|
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;
|
|
48
|
+
}
|
|
49
|
+
/** What the core holds for one command: the fields and the limit. */
|
|
50
|
+
export interface ResolvedCommandHold {
|
|
51
|
+
readonly effects: readonly CommandEffect[];
|
|
52
|
+
readonly holdMs: number;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* What to hold for `cap.method(args)` given the cap's slice when it arrived
|
|
56
|
+
* (`current`, as the device reported it; `shown`, with the held values over
|
|
57
|
+
* it — what a `negate` flips) and the provider's option for the method.
|
|
58
|
+
* `null` = hold nothing (`never`, or a command that leads to no state).
|
|
59
|
+
*/
|
|
60
|
+
export declare function resolveCommandHold(cap: string, method: string, args: Readonly<Record<string, unknown>> | undefined, current: CommandSlice, option: CommandHoldOption | undefined, shown?: CommandSlice): ResolvedCommandHold | null;
|
|
@@ -7,6 +7,7 @@ import type { AddonApi } from '../generated/addon-api.js';
|
|
|
7
7
|
import type { DeviceProxy } from '../generated/device-proxy.js';
|
|
8
8
|
import type { DeviceMeta, InitialDeviceMeta } from './device-management.js';
|
|
9
9
|
import type { DeviceType } from './device-type.js';
|
|
10
|
+
import type { NativeCapOptions } from './command-hold.js';
|
|
10
11
|
/** What a device states about the config it persists. */
|
|
11
12
|
export interface DevicePersistConfigOptions {
|
|
12
13
|
/** Dotted paths its schema declares secret (`collectZodSecretPaths`). */
|
|
@@ -105,8 +106,10 @@ export interface DeviceContext {
|
|
|
105
106
|
*/
|
|
106
107
|
readonly streamProbe?: IKernelStreamProbe;
|
|
107
108
|
/** Register a native provider for `cap` on the device this context belongs to.
|
|
108
|
-
* Multiple calls for the same cap throw.
|
|
109
|
-
|
|
109
|
+
* Multiple calls for the same cap throw. `options.commands` overrides the
|
|
110
|
+
* core's command hold per method (D1061): `{ hold: 'never' }`, another
|
|
111
|
+
* `holdMs`, or other effects — absent = the core default. */
|
|
112
|
+
registerNativeCap<TCap extends CapabilityDefinition>(cap: TCap, provider: InferNativeProvider<TCap>, options?: NativeCapOptions<TCap>): void;
|
|
110
113
|
/**
|
|
111
114
|
* Remove the native provider THIS context registered for `capName` (D663: the composer ungrafts an added cap when a
|
|
112
115
|
* foreign native appears or the target is gone). OPTIONAL on the published interface: every `DeviceContext` fake in the
|
|
@@ -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
|
@@ -272,8 +272,8 @@ export type { AccessoryControlInput, AccessoryControlKind, AccessoryControlPick,
|
|
|
272
272
|
export { DEVICE_TYPE_CONTROL_KIND, hasMotionTrigger, isNode, MOTION_TRIGGER_FEATURE, pickAccessoryControl, resolveDeviceControlKind, resolveMutate, SENSOR_FEATURES, SENSOR_MAP, } from './device/device-control-resolution.js';
|
|
273
273
|
export * from './device/hero/index.js';
|
|
274
274
|
export { isDoPickerDeviceType } from './device/device-do-actions.js';
|
|
275
|
-
export type { CapVocabularyEntry, CapVocabularyMap, L10n as VocabL10n, ActionEffect, CommandEffect, IndexedVocabAction, VocabActionRefusal, VocabCall, LooseCapVocabularyEntry, LooseVocabEffect, LooseVocabOffer, LooseVocabOpenArg, ResolvedBooleanTrigger, ResolvedEnumTrigger, ResolvedEnumValue, ResolvedEventTrigger, ResolvedNumericTrigger, ResolvedValueTrigger, ActionGateAnswer, ActionGateAnswerOf, DynamicOfferAnswer, DynamicOfferAnswerOf, LooseVocabActionGate, ResolvedVocabAction, ResolvedVocabTrigger, VocabBindingsInput, VocabCapName, VocabLocale, CapVocabularyDecl, DeviceCapVocabularyDecl, EventVocabularyDecl, LooseMethodActionDecl, MethodActionArgs, MethodActionDecl, MethodActionEffect, MethodActionGate, MethodActionOpenArg, SystemCapVocabularyDecl, } from './device/cap-vocabulary/index.js';
|
|
276
|
-
export { actionEffect, actionGateAnswerFrom, actionOfferedWith, actionsForDevice as vocabularyActionsForDevice, deviceOffersActions, offeredActionsWith, allVocabActions, auditedFields, CAP_VOCABULARY, CAP_VOCABULARY_BY_NAME, commandEffect, findVocabAction, isCommand, renderVocabPhrase, triggersForDevice as vocabularyTriggersForDevice, VOCAB_TEMPLATES, vocabActionIdFor, vocabCall, VocabActionError, assertDeviceOffers, NOT_A_DEVICE, } from './device/cap-vocabulary/index.js';
|
|
275
|
+
export type { CapVocabularyEntry, CapVocabularyMap, L10n as VocabL10n, ActionEffect, CommandEffect, CommandSlice, LooseVocabActionHold, LooseVocabSideEffect, VocabEffectCondition, VocabEffectValue, IndexedVocabAction, VocabActionRefusal, VocabCall, LooseCapVocabularyEntry, LooseVocabEffect, LooseVocabOffer, LooseVocabOpenArg, ResolvedBooleanTrigger, ResolvedEnumTrigger, ResolvedEnumValue, ResolvedEventTrigger, ResolvedNumericTrigger, ResolvedValueTrigger, ActionGateAnswer, ActionGateAnswerOf, DynamicOfferAnswer, DynamicOfferAnswerOf, LooseVocabActionGate, ResolvedVocabAction, ResolvedVocabTrigger, VocabBindingsInput, VocabCapName, VocabLocale, CapVocabularyDecl, DeviceCapVocabularyDecl, EventVocabularyDecl, LooseMethodActionDecl, MethodActionArgs, MethodActionDecl, MethodActionEffect, MethodActionGate, MethodActionOpenArg, SystemCapVocabularyDecl, } from './device/cap-vocabulary/index.js';
|
|
276
|
+
export { actionEffect, actionGateAnswerFrom, actionOfferedWith, actionsForDevice as vocabularyActionsForDevice, deviceOffersActions, offeredActionsWith, allVocabActions, auditedFields, CAP_VOCABULARY, CAP_VOCABULARY_BY_NAME, commandEffect, commandEffects, commandHoldMs, effectConditionHolds, resolveSideEffect, findVocabAction, isCommand, renderVocabPhrase, triggersForDevice as vocabularyTriggersForDevice, VOCAB_TEMPLATES, vocabActionIdFor, vocabCall, VocabActionError, assertDeviceOffers, NOT_A_DEVICE, } from './device/cap-vocabulary/index.js';
|
|
277
277
|
export { DEVICE_IDENTIFIER_KEYS, DeviceIdentifierEntrySchema, DeviceIdentifierKeySchema, DeviceIdentifierOriginSchema, DeviceIdentifiersSchema, identifierStrength, isEmptyIdentifiers, mergeIdentifiers, normaliseIdentifiers, sameIdentifiers, normaliseMac, } from './device/device-identifiers.js';
|
|
278
278
|
export type { AcceptedValue, DeviceIdentifierEntry, DeviceIdentifierKey, DeviceIdentifierOrigin, DeviceIdentifiers, DeviceIdentifierStrength, NormaliseIdentifiersOptions, NormalisedIdentifiers, NormaliseResult, RawDeviceIdentifiers, RawSerialIdentifier, RawVendorUidIdentifier, RejectedIdentifier, RejectedReason, } from './device/device-identifiers.js';
|
|
279
279
|
export { declareDeviceIdentifiers } from './device/declare-identifiers.js';
|
|
@@ -491,3 +491,7 @@ export * from './migrations/api/migration-api.v1.js';
|
|
|
491
491
|
export * from './migrations/api/migration-api.v1.schema.js';
|
|
492
492
|
export * from './migrations/api/migration-api-ports.js';
|
|
493
493
|
export { normalizeSearchText, searchRank, type SearchRankFields } from './search/search-match.js';
|
|
494
|
+
export { DEFAULT_COMMAND_HOLD_MS, MAX_COMMAND_HOLD_MS, resolveCommandHold, } from './device/command-hold.js';
|
|
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';
|
|
497
|
+
export type { CommandHoldOption, CommandHoldOptions, NativeCapOptions, ResolvedCommandHold, } from './device/command-hold.js';
|