@smarthome.exchange/integrations 0.2.0 → 2.0.0

package/changelog.md

@@ -1,5 +1,173 @@
 # Changelog
 
+## 2026-10-07 - 2.0.0
+
+### Breaking Changes
+
+- Require explicit host-selected home context at native setup, config-flow and public native-client boundaries; configuration and storage scope cannot choose authority.
+
+- Replace the nanoleaf prototype runtime with selected native controls, explicit home and identity admission, truthful observations and terminal resource ownership.
+
+- Replace the wiz prototype runtime with selected native controls, explicit home and identity admission, truthful observations and terminal resource ownership.
+
+- Replace the denonavr prototype runtime with selected native controls, explicit home and identity admission, truthful observations and terminal resource ownership.
+
+- Replace the onkyo prototype runtime with selected native controls, explicit home and identity admission, truthful observations and terminal resource ownership.
+
+- Replace the daikin prototype runtime with selected native controls, explicit home and identity admission, truthful observations and terminal resource ownership.
+
+- Replace the broadlink prototype runtime with selected native controls, explicit home and identity admission, truthful observations and terminal resource ownership.
+- Replace the yamaha descriptor runtime with explicitly home-bound native admission, observed identity and capabilities, bounded ownership and one-shot selected controls.
+
+- Require an independently selected native host home and retain bounded daikin setup, flow and runtime resources through terminal cleanup and explicit cleanup retry.
+
+- Require an independently selected native host home and retain bounded denonavr setup, flow and runtime resources through terminal cleanup and explicit cleanup retry.
+
+- Require an independently selected native host home and retain bounded nanoleaf setup, flow and runtime resources through terminal cleanup and explicit cleanup retry.
+
+- Require an independently selected native host home and retain bounded wiz setup, flow and runtime resources through terminal cleanup and explicit cleanup retry.
+
+- Require an independently selected native host home and retain bounded onkyo setup, flow and runtime resources through terminal cleanup and explicit cleanup retry.
+
+- Require an independently selected native host home and retain bounded broadlink setup, flow and runtime resources through terminal cleanup and explicit cleanup retry.
+- Replace the pioneer descriptor runtime with explicitly home-bound native admission, observed identity and capabilities, bounded ownership and one-shot selected controls.
+- Replace the panasonic-viera descriptor runtime with explicitly home-bound native admission, observed identity and capabilities, bounded ownership and one-shot selected controls.
+- Replace the modbus descriptor runtime with explicitly home-bound native admission, observed identity and capabilities, bounded ownership and one-shot selected controls.
+- Replace the soundtouch descriptor runtime with explicitly home-bound native admission, observed identity and capabilities, bounded ownership and one-shot selected controls.
+- Replace the braviatv descriptor runtime with explicitly home-bound native admission, observed identity and capabilities, bounded ownership and one-shot selected controls.
+
+- Replace the kodi descriptor runtime with explicitly home-bound native admission, observed identity and capabilities, bounded ownership and one-shot selected controls.
+
+### Fixes
+
+- Retain actual encryption-provider callbacks after caller cancellation, drain them during terminal config-store cleanup, and expose explicit cleanup acknowledgment without replay or unbounded admission.
+- Use the public config-store cleanup retry from Nanoleaf resource owners after an observed terminal failure, preserving original close results and borrowed-store ownership.
+
+### Maintenance
+
+- Update the release package-manager pin to pnpm 12.8.2.
+
+- Serialize configured full release tests and builds with bounded per-command shared-host locks, releasing the lock before publication and registry verification.
+
+## 2026-10-06 - 1.0.0
+
+### Maintenance
+
+- Consume published interfaces 2.0.0 and devicemanager 4.3.0 and regenerate the combined standalone dependency graph with preserved strong integrity records.
+
+### Features
+
+- Provision native Tuya 3.4 devices with encrypted home-scoped configuration, observed datapoint capabilities and one-shot effect outcomes.
+
+- Use published Samsung TV, Yeelight and legacy Kasa transports with exact home/device identity, truthful capabilities, explicit controls and terminal resource ownership.
+
+- bound encrypted configuration store startup and expose immutable scope (core)
+  - Prepare the public client collection with cancellation and configured deadlines, and drain owned startup and operations on terminal close.
+  - Return fresh frozen home/domain scope snapshots so consumers can verify an exact configuration-store boundary.
+
+- add native MQTT.js runtime with live discovery and feature writes (mqtt)
+  - Replace the custom MQTT transport with MQTT.js, bounded operations, reconnect-aware subscriptions, topic validation, and snapshot limits.
+  - Connect the MQTT integration during setup and expose runtime health, normalized entity events, and feature write support.
+  - Improve Home Assistant discovery parsing, availability handling, state normalization, and command validation.
+  - Add fixture-backed MQTT runtime tests, documentation, and the mqtt dependency.
+
+- add native Tasmota runtime with selected-device MQTT controls (tasmota)
+  - Promote Tasmota into the handwritten public registry with relay, single-channel brightness, and read-only sensor support.
+  - Require a configured MQTT broker and explicit device Topic/FullTopic selection, with fresh nonretained state before readiness and after reconnects.
+  - Bind feature writes to the Tasmota integration domain, selected device id, and configured controls; always publish commands without retain.
+  - Report QoS 0 transport acceptance without claiming physical execution or optimistically changing readable state.
+  - Add broker lifecycle, device ownership, native registration, and preserved catalogue coverage regressions.
+
+- implement native Zigbee2MQTT runtime (zigbee2mqtt)
+  - Use retained inventory and typed primitive exposes for exact-target nonretained controls, authoritative availability and owned cleanup.
+
+- implement native scoped webOS SSAP runtime (webostv)
+  - Verify device identity, persist pairing tokens in an exact encrypted home/domain store, and await persistence before admitting controls.
+  - Use authoritative subscriptions and bounded owned-target commands with cancellation and terminal cleanup.
+
+- Use published LIFX UDP transport with exact home-scoped identity, observed single-zone capabilities, explicit HSBK writes and terminal drain.
+
+### Fixes
+
+- Preserve exact colon-bearing Home Assistant home identifiers and observe public reconnect health deterministically in tests.
+
+- Bind live OpenHome SOAP requests to the configured origin and close owned requests; use a tracked File fixture in clean checkouts.
+
+- Track standalone root-only pnpm dependency build approvals.
+
+- harden gateway discovery matching and metadata sanitization (tradfri)
+  - Validate mDNS, manual, and external candidate endpoints before accepting TRADFRI gateways.
+  - Exclude DIRIGERA and unrelated advertisements to reduce false positives.
+  - Recognize native CoAP gateway records and case-insensitive TXT metadata without propagating pairing credentials.
+
+- harden coordinator discovery admission (zha)
+  - Require known ZHA USB VID/PID pairs with matching coordinator product descriptions instead of generic serial bridge or serial-number hints
+  - Validate network and manual coordinator endpoints, including host, port, path, socket URL, and conflicting alias handling
+  - Sanitize discovery candidates to avoid propagating credentials, runtime snapshots, database paths, and nested caller metadata
+  - Add ZHA admission tests and document the current native runtime boundary
+
+- use the bounded published SOAP client for OpenHome (openhome)
+  - Bind live requests to the configured description URL, preserve optional product fields and close owned SOAP requests during destruction.
+  - Keep snapshot-only construction valid and verify terminal cleanup against a namespace-correct loopback fixture.
+
+- track the File sensor test fixture for clean checkouts (tests)
+  - Use a committed text asset instead of relying on an ignored local log file.
+
+### Breaking Changes
+
+- bind native Home Assistant controls to home scope and live services (homeassistant)
+  - Require explicit home identity and current advertised service schemas; keep state authoritative and drain owned transport lifetimes.
+
+- implement native Gen2/3 RPC runtime (shelly)
+  - Require host-based Shelly configuration and remove deviceInfo/status/deviceConfig fixture fields.
+  - Validate setup and config-flow connections against Shelly Gen2/3 HTTP/RPC endpoints with digest authentication.
+  - Add WebSocket subscriptions for status, availability, vendor events, and safe cleanup behavior.
+  - Support switch feature writes and stricter switch service target validation.
+  - Reject advertised Gen1 devices during Shelly discovery.
+
+- replace filesystem integration config with encrypted NoSQL persistence (core)
+  - Remove the exported `JsonFileConfigStore` and its file-path constructor; consumers must construct `NoSqlConfigStore` with a database, authorized home/domain scope and external encryption-key provider, then await `initialize()`.
+  - Scope each atomic config document to an immutable home, integration and key through public `@lossless.org/client/nosqldb` model APIs; encrypt credentials and values with externally supplied AES-256-GCM keys.
+  - Support key rotation, authenticate ciphertext scope, bound operation admission and key-provider lookup deadlines, and reject malformed or oversized JSON data.
+  - Join caller-owned public client transactions consistently across config reads, writes, insert-only creation, deletion and listing so ownership fencing and encrypted config updates commit or roll back together.
+  - Add an explicit transactional legacy JSON import under `ts_migration/` that refuses overwrites, records completion and leaves its source untouched.
+
+- harden pairing, runtime writes, and validation (deconz)
+  - Adds authenticated deCONZ pairing with unlock retry support and gateway identity validation.
+  - Validates endpoints, snapshots, gateway responses, WebSocket events, and write acknowledgements before updating runtime health.
+  - Adds runtime feature writes for lights, groups, covers, thermostats, and writable CLIP sensor state fields.
+  - BREAKING CHANGE: direct deCONZ write patch APIs now accept only supported typed fields and reject arbitrary or incompatible fields.
+  - BREAKING CHANGE: light and sensor device IDs now use the full deCONZ unique ID to distinguish multi-endpoint devices.
+
+- replace ESPHome fixtures with native authenticated runtime (esphome)
+  - Validate encrypted native configuration and exact device capabilities, then bound commands, subscriptions and cleanup.
+
+- implement identity-bound Hue v2 HTTPS and SSE runtime (hue)
+  - Require explicit bridge identity and TLS trust, validate exact writes, and update state through authoritative bridge events.
+
+- implement native Z-Wave JS websocket runtime (zwave)
+  - Verify server schema and home identity; admit only supported binary and multilevel commands with authoritative state and terminal cleanup.
+
+- Replace prototype WLED configuration with validated native HTTP and WebSocket controls.
+
+- Replace Roku prototype configuration with verified native ECP identity and explicit controls.
+
+- Replace prototype Sonos configuration with verified native discovery, topology and bounded audio controls.
+
+### Maintenance
+
+- verify merged native integrations with the TypeScript 7 beta (tooling)
+  - Pin `@git.zone/tsbuild` to `6.0.0-beta.0`, use current release tooling and pnpm 12.8.1, and reconcile the standalone dependency lockfile.
+  - Keep default-registry discovery tests on explicitly empty network interfaces.
+
+### Fixes
+
+- Enforce active-discovery cancellation before probe admission and around each awaited probe, including rejecting probes, preserve the exact caller abort reason even when an admitted probe rejects, and retain original errors when uncancelled; reject partial results and add deterministic admission, rejection and normal-aggregation specifications.
+
+### Maintenance
+
+- Update release test tooling to published tstest 7.2.0; preserve the exact TypeScript 7.1 beta compiler and current eligible pnpm 12.8.1 / Node types 26.6.3 under the global seven-day release-age policy.
+
 ## 2026-08-10 - 0.2.0
 
 ### Features
@@ -22,6 +190,9 @@
 
 ### Fixes
 
+- preserve UniFi selector value types under TypeScript 7 (unifi)
+  - Use the existing selector result type without changing runtime selection and verify fallback values.
+
 - fail closed for descriptor-only integrations, including Wolf Smartset (runtime)
   - Reject setup with `DESCRIPTOR_ONLY_INTEGRATION` before any descriptor-only setup implementation can run, while preserving Wolf Smartset discovery and config flow.
 - serialize integration runtime replacement and cleanup (runtime)

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@smarthome.exchange/integrations',
-    version: '0.2.0',
+    version: '2.0.0',
     description: 'TypeScript-native device integrations for smarthome.exchange.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxrQ0FBa0M7SUFDeEMsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLCtEQUErRDtDQUM3RSxDQUFBIn0=

package/dist_ts/cli/classes.cliruntime.d.ts

@@ -11,6 +11,7 @@ export declare class CliRuntime {
         status: string;
         step?: undefined;
     } | {
+        status?: undefined;
         domain: string;
         step: {
             kind: any;
@@ -19,6 +20,5 @@ export declare class CliRuntime {
             fields: any;
             error: any;
         };
-        status?: undefined;
     }>;
 }

package/dist_ts/cli/commands.discover.js

@@ -1,4 +1,4 @@
 export const commandDiscover = async (discoveryEngineArg, contextArg = {}) => {
     return discoveryEngineArg.runActiveDiscovery(contextArg);
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tbWFuZHMuZGlzY292ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9jbGkvY29tbWFuZHMuZGlzY292ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsTUFBTSxDQUFDLE1BQU0sZUFBZSxHQUFHLEtBQUssRUFDbEMsa0JBQW1DLEVBQ25DLGFBQWdDLEVBQUUsRUFDRixFQUFFO0lBQ2xDLE9BQU8sa0JBQWtCLENBQUMsa0JBQWtCLENBQUMsVUFBVSxDQUFDLENBQUM7QUFDM0QsQ0FBQyxDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tbWFuZHMuZGlzY292ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9jbGkvY29tbWFuZHMuZGlzY292ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsTUFBTSxDQUFDLE1BQU0sZUFBZSxHQUFHLEtBQUssRUFDbEMsa0JBQW1DLEVBQ25DLFVBQVUsR0FBc0IsRUFBRSxFQUNGLEVBQUU7SUFDbEMsT0FBTyxrQkFBa0IsQ0FBQyxrQkFBa0IsQ0FBQyxVQUFVLENBQUMsQ0FBQztBQUMzRCxDQUFDLENBQUMifQ==

package/dist_ts/cli/commands.setup.d.ts

@@ -4,6 +4,7 @@ export declare const commandSetup: (registryArg: IntegrationRegistry, domainArg:
     status: string;
     step?: undefined;
 } | {
+    status?: undefined;
     domain: string;
     step: {
         kind: any;
@@ -12,5 +13,4 @@ export declare const commandSetup: (registryArg: IntegrationRegistry, domainArg:
         fields: any;
         error: any;
     };
-    status?: undefined;
 }>;

package/dist_ts/core/classes.configrecord.d.ts

@@ -0,0 +1,15 @@
+import * as plugins from '../plugins.js';
+export interface IEncryptedConfigValue {
+    version: 1;
+    keyId: string;
+    nonce: string;
+    ciphertext: string;
+    tag: string;
+}
+export declare class IntegrationConfigRecord extends plugins.nosqldb.SmartDataDbDoc<IntegrationConfigRecord, IntegrationConfigRecord> {
+    id: string;
+    homeId: string;
+    integrationDomain: string;
+    key: string;
+    encryptedValue: IEncryptedConfigValue;
+}

package/dist_ts/core/classes.configrecord.js

@@ -0,0 +1,93 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import * as plugins from '../plugins.js';
+let IntegrationConfigRecord = (() => {
+    let _classDecorators = [plugins.nosqldb.managed({ collectionName: 'shx_integration_config' }), plugins.nosqldb.namedIndex({
+            name: 'integration_config_scope',
+            key: { homeId: 1, integrationDomain: 1, key: 1 },
+            options: { unique: true },
+        })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = plugins.nosqldb.SmartDataDbDoc;
+    let _id_decorators;
+    let _id_initializers = [];
+    let _id_extraInitializers = [];
+    let _homeId_decorators;
+    let _homeId_initializers = [];
+    let _homeId_extraInitializers = [];
+    let _integrationDomain_decorators;
+    let _integrationDomain_initializers = [];
+    let _integrationDomain_extraInitializers = [];
+    let _key_decorators;
+    let _key_initializers = [];
+    let _key_extraInitializers = [];
+    let _encryptedValue_decorators;
+    let _encryptedValue_initializers = [];
+    let _encryptedValue_extraInitializers = [];
+    var IntegrationConfigRecord = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _id_decorators = [plugins.nosqldb.unI({ indexName: 'integration_config_identity' })];
+            _homeId_decorators = [plugins.nosqldb.svDb()];
+            _integrationDomain_decorators = [plugins.nosqldb.svDb()];
+            _key_decorators = [plugins.nosqldb.svDb()];
+            _encryptedValue_decorators = [plugins.nosqldb.svDb()];
+            __esDecorate(null, null, _id_decorators, { kind: "field", name: "id", static: false, private: false, access: { has: obj => "id" in obj, get: obj => obj.id, set: (obj, value) => { obj.id = value; } }, metadata: _metadata }, _id_initializers, _id_extraInitializers);
+            __esDecorate(null, null, _homeId_decorators, { kind: "field", name: "homeId", static: false, private: false, access: { has: obj => "homeId" in obj, get: obj => obj.homeId, set: (obj, value) => { obj.homeId = value; } }, metadata: _metadata }, _homeId_initializers, _homeId_extraInitializers);
+            __esDecorate(null, null, _integrationDomain_decorators, { kind: "field", name: "integrationDomain", static: false, private: false, access: { has: obj => "integrationDomain" in obj, get: obj => obj.integrationDomain, set: (obj, value) => { obj.integrationDomain = value; } }, metadata: _metadata }, _integrationDomain_initializers, _integrationDomain_extraInitializers);
+            __esDecorate(null, null, _key_decorators, { kind: "field", name: "key", static: false, private: false, access: { has: obj => "key" in obj, get: obj => obj.key, set: (obj, value) => { obj.key = value; } }, metadata: _metadata }, _key_initializers, _key_extraInitializers);
+            __esDecorate(null, null, _encryptedValue_decorators, { kind: "field", name: "encryptedValue", static: false, private: false, access: { has: obj => "encryptedValue" in obj, get: obj => obj.encryptedValue, set: (obj, value) => { obj.encryptedValue = value; } }, metadata: _metadata }, _encryptedValue_initializers, _encryptedValue_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            IntegrationConfigRecord = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        id = __runInitializers(this, _id_initializers, void 0);
+        homeId = (__runInitializers(this, _id_extraInitializers), __runInitializers(this, _homeId_initializers, void 0));
+        integrationDomain = (__runInitializers(this, _homeId_extraInitializers), __runInitializers(this, _integrationDomain_initializers, void 0));
+        key = (__runInitializers(this, _integrationDomain_extraInitializers), __runInitializers(this, _key_initializers, void 0));
+        encryptedValue = (__runInitializers(this, _key_extraInitializers), __runInitializers(this, _encryptedValue_initializers, void 0));
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _encryptedValue_extraInitializers);
+        }
+    };
+    return IntegrationConfigRecord = _classThis;
+})();
+export { IntegrationConfigRecord };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jb25maWdyZWNvcmQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9jb3JlL2NsYXNzZXMuY29uZmlncmVjb3JkLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztJQWdCNUIsdUJBQXVCOzRCQU5uQyxPQUFPLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxFQUFFLGNBQWMsRUFBRSx3QkFBd0IsRUFBRSxDQUFDLEVBQ3JFLE9BQU8sQ0FBQyxPQUFPLENBQUMsVUFBVSxDQUFDO1lBQzFCLElBQUksRUFBRSwwQkFBMEI7WUFDaEMsR0FBRyxFQUFFLEVBQUUsTUFBTSxFQUFFLENBQUMsRUFBRSxpQkFBaUIsRUFBRSxDQUFDLEVBQUUsR0FBRyxFQUFFLENBQUMsRUFBRTtZQUNoRCxPQUFPLEVBQUUsRUFBRSxNQUFNLEVBQUUsSUFBSSxFQUFFO1NBQzFCLENBQUM7Ozs7c0JBQzJDLE9BQU8sQ0FBQyxPQUFPLENBQUMsY0FBYzs7Ozs7Ozs7Ozs7Ozs7Ozt1Q0FBdEMsU0FBUSxXQUFnRjs7Ozs4QkFDMUgsT0FBTyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsRUFBRSxTQUFTLEVBQUUsNkJBQTZCLEVBQUUsQ0FBQztrQ0FDakUsT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLEVBQUU7NkNBQ3RCLE9BQU8sQ0FBQyxPQUFPLENBQUMsSUFBSSxFQUFFOytCQUN0QixPQUFPLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRTswQ0FDdEIsT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLEVBQUU7WUFKNEMsd0pBQU8sRUFBRSw2QkFBRixFQUFFLCtFQUFVO1lBQzlELG9LQUFPLE1BQU0sNkJBQU4sTUFBTSx1RkFBVTtZQUN2QixxTUFBTyxpQkFBaUIsNkJBQWpCLGlCQUFpQiw2R0FBVTtZQUNsQywySkFBTyxHQUFHLDZCQUFILEdBQUcsaUZBQVU7WUFDcEIsNExBQU8sY0FBYyw2QkFBZCxjQUFjLHVHQUF5QjtZQUx4RSw2S0FNQzs7O1lBTlksdURBQXVCOztRQUN3QyxFQUFFLHFEQUFVO1FBQ3ZELE1BQU0sMkdBQVU7UUFDaEIsaUJBQWlCLDBIQUFVO1FBQzNCLEdBQUcsdUhBQVU7UUFDYixjQUFjLG9IQUF5Qjs7Ozs7Ozs7U0FMM0QsdUJBQXVCIn0=

package/dist_ts/core/classes.configstore.d.ts

@@ -1,11 +1,41 @@
-import type { IConfigStore } from './types.js';
-export declare class JsonFileConfigStore implements IConfigStore {
-    private readonly filePath;
-    constructor(filePath: string);
-    get<TValue>(keyArg: string): Promise<TValue | undefined>;
-    set<TValue>(keyArg: string, valueArg: TValue): Promise<void>;
-    delete(keyArg: string): Promise<void>;
-    list(prefixArg?: string): Promise<string[]>;
-    private readFile;
-    private writeFile;
+import * as plugins from '../plugins.js';
+import type { IConfigStore, IConfigStoreOperationOptions, IConfigStoreScope } from './types.js';
+export interface IConfigEncryptionKey {
+    id: string;
+    key: Uint8Array;
+}
+export interface IConfigEncryptionKeyProvider {
+    currentKey(signalArg: AbortSignal): Promise<IConfigEncryptionKey>;
+    keyForId(keyIdArg: string, signalArg: AbortSignal): Promise<Uint8Array | undefined>;
+}
+export interface INoSqlConfigStoreOptions {
+    db: plugins.nosqldb.SmartdataDb;
+    homeId: string;
+    integrationDomain: string;
+    keyProvider: IConfigEncryptionKeyProvider;
+    timeoutMs?: number;
+    maxPendingOperations?: number;
+    maxValueBytes?: number;
+}
+export interface IConfigCreateOptions extends IConfigStoreOperationOptions {
+}
+export interface IConfigStoreInitializationOptions {
+    signal?: AbortSignal;
+}
+/** The caller owns the database and key provider; this store owns neither resource. */
+export declare class NoSqlConfigStore implements IConfigStore {
+    #private;
+    constructor(optionsArg: INoSqlConfigStoreOptions);
+    getScope(): IConfigStoreScope;
+    initialize(optionsArg?: IConfigStoreInitializationOptions): Promise<void>;
+    /** Stops this store without closing its caller-owned database or sessions. */
+    close(): Promise<void>;
+    /** Acknowledges settled provider cleanup failures without repeating callbacks or reopening the store. */
+    retryCleanup(): Promise<void>;
+    get<TValue>(keyArg: string, optionsArg?: IConfigStoreOperationOptions): Promise<TValue | undefined>;
+    set<TValue>(keyArg: string, valueArg: TValue, optionsArg?: IConfigStoreOperationOptions): Promise<void>;
+    /** Insert-only persistence for callers that must never replace an existing key. */
+    create<TValue>(keyArg: string, valueArg: TValue, optionsArg?: IConfigCreateOptions): Promise<void>;
+    delete(keyArg: string, optionsArg?: IConfigStoreOperationOptions): Promise<void>;
+    list(prefixArg?: string, optionsArg?: IConfigStoreOperationOptions): Promise<string[]>;
 }