@zwave-js/nvmedit 13.2.0 → 13.4.0

package/build/lib/common/definitions.d.ts

@@ -0,0 +1,138 @@
+import { type CommandClasses } from "@zwave-js/core";
+import { type Expand } from "@zwave-js/shared";
+import { type ApplicationCCsFile, type ApplicationRFConfigFile, type ApplicationTypeFile, type ControllerInfoFile, type LRNodeInfo, type NodeInfo } from "../nvm3/files";
+import { type Route } from "./routeCache";
+import { type SUCUpdateEntry } from "./sucUpdateEntry";
+export declare enum NVMAccess {
+    None = 0,
+    Read = 1,
+    Write = 2,
+    ReadWrite = 3
+}
+/** Provides an abstraction to access the contents of an NVM at the binary level */
+export interface NVMIO {
+    /**
+     * Opens the NVM for reading and/or writing.
+     * Since different NVM implementations may or may not allow reading and writing at the same time,
+     * the returned value indicates which access patterns are actually allowed.
+     */
+    open(access: NVMAccess.Read | NVMAccess.Write): Promise<NVMAccess>;
+    /** Returns the size of the NVM, after it has been opened */
+    get size(): number;
+    /** Returns which access is currently allowed for this NVM implementation */
+    get accessMode(): NVMAccess;
+    /**
+     * Determines the size of the data chunks that can be used for writing.
+     * Requires the NVM to be readable.
+     */
+    determineChunkSize(): Promise<number>;
+    /**
+     * Reads a chunk of data with the given length from the NVM.
+     * If the length is longer than the chunk size, or the end of the NVM is reached,
+     * the returned buffer will be shorter than the requested length.
+     */
+    read(offset: number, length: number): Promise<{
+        buffer: Buffer;
+        endOfFile: boolean;
+    }>;
+    /**
+     * Writes a chunk of data with the given length from the NVM.
+     * The returned value indicates how many bytes were actually written.
+     */
+    write(offset: number, data: Buffer): Promise<{
+        bytesWritten: number;
+        endOfFile: boolean;
+    }>;
+    /** Closes the NVM */
+    close(): Promise<void>;
+}
+/** A specific NVM implementation */
+export interface NVM<ID, Data> {
+    /** Checks if a property exists in the NVM */
+    has(property: ID): Promise<boolean>;
+    /** Reads a property from the NVM */
+    get(property: ID): Promise<Data | undefined>;
+    /** Writes a property to the NVM */
+    set(property: ID, value: Data): Promise<void>;
+    /** Deletes the property from the NVM */
+    delete(property: ID): Promise<void>;
+}
+/**
+ * Provides an application-level abstraction over an NVM implementation
+ */
+export interface NVMAdapter {
+    /** Reads a property from the NVM */
+    get<T extends NVMProperty, R extends boolean = boolean>(property: T, required?: R): Promise<R extends true ? NVMPropertyToDataType<T> : (NVMPropertyToDataType<T> | undefined)>;
+    /**
+     * Changes a property to be written to the NVM later
+     */
+    set<T extends NVMProperty>(property: T, value: NVMPropertyToDataType<T>): Promise<void>;
+    /**
+     * Marks a property for deletion from the NVM. In some implementations,
+     * deleting one property may delete multiple properties that are stored together.
+     */
+    delete(property: NVMProperty): Promise<void>;
+    /** Returns whether there are pending changes that weren't written to the NVM yet */
+    hasPendingChanges(): boolean;
+    /** Writes all pending changes to the NVM */
+    commit(): Promise<void>;
+}
+export type ControllerNVMPropertyTypes = Expand<{
+    protocolVersion: string;
+    protocolFileFormat: number;
+    applicationVersion: string;
+    applicationData: Buffer;
+    preferredRepeaters?: number[];
+    sucUpdateEntries: SUCUpdateEntry[];
+    appRouteLock: number[];
+    routeSlaveSUC: number[];
+    sucPendingUpdate: number[];
+    pendingDiscovery: number[];
+    virtualNodeIds: number[];
+    nodeIds: number[];
+} & Partial<{
+    applicationFileFormat: number;
+    applicationName: string;
+    lrNodeIds: number[];
+}> & Partial<{
+    learnedHomeId: Buffer;
+    commandClasses: CommandClasses[];
+    systemState: number;
+    watchdogStarted: number;
+    powerLevelNormal: number[];
+    powerLevelLow: number[];
+    powerMode: number;
+    powerModeExtintEnable: number;
+    powerModeWutTimeout: number;
+}> & Pick<ControllerInfoFile, "homeId" | "nodeId" | "lastNodeId" | "staticControllerNodeId" | "sucLastIndex" | "controllerConfiguration" | "sucAwarenessPushNeeded" | "maxNodeId" | "reservedId" | "systemState" | "lastNodeIdLR" | "maxNodeIdLR" | "reservedIdLR" | "primaryLongRangeChannelId" | "dcdcConfig"> & Partial<Pick<ApplicationCCsFile, "includedInsecurely" | "includedSecurelyInsecureCCs" | "includedSecurelySecureCCs">> & Partial<Pick<ApplicationRFConfigFile, "rfRegion" | "txPower" | "measured0dBm" | "enablePTI" | "maxTXPower" | "nodeIdType">> & Partial<Pick<ApplicationTypeFile, "isListening" | "optionalFunctionality" | "genericDeviceClass" | "specificDeviceClass">>>;
+export interface NodeNVMPropertyTypes {
+    info: NodeInfo;
+    routes: {
+        lwr?: Route;
+        nlwr?: Route;
+    };
+}
+export interface LRNodeNVMPropertyTypes {
+    info: LRNodeInfo;
+}
+export type ControllerNVMProperty = {
+    domain: "controller";
+    type: keyof ControllerNVMPropertyTypes;
+    nodeId?: undefined;
+};
+export type ControllerNVMPropertyToDataType<P extends ControllerNVMProperty> = ControllerNVMPropertyTypes[P["type"]];
+export type NodeNVMProperty = {
+    domain: "node";
+    type: keyof NodeNVMPropertyTypes;
+    nodeId: number;
+};
+export type NodeNVMPropertyToDataType<P extends NodeNVMProperty> = P["type"] extends keyof NodeNVMPropertyTypes ? NodeNVMPropertyTypes[P["type"]] : never;
+export type LRNodeNVMProperty = {
+    domain: "lrnode";
+    type: keyof LRNodeNVMPropertyTypes;
+    nodeId: number;
+};
+export type LRNodeNVMPropertyToDataType<P extends LRNodeNVMProperty> = P["type"] extends keyof LRNodeNVMPropertyTypes ? LRNodeNVMPropertyTypes[P["type"]] : never;
+export type NVMProperty = ControllerNVMProperty | NodeNVMProperty | LRNodeNVMProperty;
+export type NVMPropertyToDataType<P extends NVMProperty> = P extends ControllerNVMProperty ? ControllerNVMPropertyToDataType<P> : P extends NodeNVMProperty ? NodeNVMPropertyToDataType<P> : P extends LRNodeNVMProperty ? LRNodeNVMPropertyToDataType<P> : never;
+//# sourceMappingURL=definitions.d.ts.map

package/build/lib/common/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/lib/common/definitions.ts"],"names":[],"mappings":"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"}

package/build/lib/common/definitions.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NVMAccess = void 0;
+var NVMAccess;
+(function (NVMAccess) {
+    NVMAccess[NVMAccess["None"] = 0] = "None";
+    NVMAccess[NVMAccess["Read"] = 1] = "Read";
+    NVMAccess[NVMAccess["Write"] = 2] = "Write";
+    NVMAccess[NVMAccess["ReadWrite"] = 3] = "ReadWrite";
+})(NVMAccess || (exports.NVMAccess = NVMAccess = {}));
+//# sourceMappingURL=definitions.js.map

package/build/lib/common/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../src/lib/common/definitions.ts"],"names":[],"mappings":";;;AAaA,IAAY,SAKX;AALD,WAAY,SAAS;IACpB,yCAAI,CAAA;IACJ,yCAAI,CAAA;IACJ,2CAAK,CAAA;IACL,mDAAS,CAAA;AACV,CAAC,EALW,SAAS,yBAAT,SAAS,QAKpB"}

package/build/lib/common/routeCache.d.ts

@@ -0,0 +1,18 @@
+import { type FLiRS, RouteProtocolDataRate } from "@zwave-js/core/safe";
+export declare const ROUTECACHE_SIZE: number;
+export declare const EMPTY_ROUTECACHE_FILL = 255;
+export declare const emptyRouteCache: Buffer;
+export interface Route {
+    beaming: FLiRS;
+    protocolRate: RouteProtocolDataRate;
+    repeaterNodeIDs?: number[];
+}
+export interface RouteCache {
+    nodeId: number;
+    lwr: Route;
+    nlwr: Route;
+}
+export declare function parseRoute(buffer: Buffer, offset: number): Route;
+export declare function encodeRoute(route: Route | undefined): Buffer;
+export declare function getEmptyRoute(): Route;
+//# sourceMappingURL=routeCache.d.ts.map

package/build/lib/common/routeCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeCache.d.ts","sourceRoot":"","sources":["../../../src/lib/common/routeCache.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,KAAK,EAEV,qBAAqB,EAErB,MAAM,qBAAqB,CAAC;AAG7B,eAAO,MAAM,eAAe,QAAiB,CAAC;AAC9C,eAAO,MAAM,qBAAqB,MAAO,CAAC;AAC1C,eAAO,MAAM,eAAe,QAG3B,CAAC;AAOF,MAAM,WAAW,KAAK;IACrB,OAAO,EAAE,KAAK,CAAC;IACf,YAAY,EAAE,qBAAqB,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;IACX,IAAI,EAAE,KAAK,CAAC;CACZ;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAWhE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAqB5D;AAED,wBAAgB,aAAa,IAAI,KAAK,CAMrC"}

package/build/lib/common/routeCache.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emptyRouteCache = exports.EMPTY_ROUTECACHE_FILL = exports.ROUTECACHE_SIZE = void 0;
+exports.parseRoute = parseRoute;
+exports.encodeRoute = encodeRoute;
+exports.getEmptyRoute = getEmptyRoute;
+const safe_1 = require("@zwave-js/core/safe");
+const ROUTE_SIZE = safe_1.MAX_REPEATERS + 1;
+exports.ROUTECACHE_SIZE = 2 * ROUTE_SIZE;
+exports.EMPTY_ROUTECACHE_FILL = 0xff;
+exports.emptyRouteCache = Buffer.alloc(exports.ROUTECACHE_SIZE, exports.EMPTY_ROUTECACHE_FILL);
+var Beaming;
+(function (Beaming) {
+    Beaming[Beaming["1000ms"] = 64] = "1000ms";
+    Beaming[Beaming["250ms"] = 32] = "250ms";
+})(Beaming || (Beaming = {}));
+function parseRoute(buffer, offset) {
+    const routeConf = buffer[offset + safe_1.MAX_REPEATERS];
+    const ret = {
+        beaming: (Beaming[routeConf & 0x60] ?? false),
+        protocolRate: routeConf & safe_1.protocolDataRateMask,
+        repeaterNodeIDs: [
+            ...buffer.subarray(offset, offset + safe_1.MAX_REPEATERS),
+        ].filter((id) => id !== 0),
+    };
+    if (ret.repeaterNodeIDs[0] === 0xfe)
+        delete ret.repeaterNodeIDs;
+    return ret;
+}
+function encodeRoute(route) {
+    const ret = Buffer.alloc(ROUTE_SIZE, 0);
+    if (route) {
+        if (route.repeaterNodeIDs) {
+            for (let i = 0; i < safe_1.MAX_REPEATERS && i < route.repeaterNodeIDs.length; i++) {
+                ret[i] = route.repeaterNodeIDs[i];
+            }
+        }
+        else {
+            ret[0] = 0xfe;
+        }
+        let routeConf = 0;
+        if (route.beaming)
+            routeConf |= Beaming[route.beaming] ?? 0;
+        routeConf |= route.protocolRate & safe_1.protocolDataRateMask;
+        ret[ROUTE_SIZE - 1] = routeConf;
+    }
+    return ret;
+}
+function getEmptyRoute() {
+    return {
+        beaming: false,
+        protocolRate: safe_1.RouteProtocolDataRate.ZWave_40k,
+        repeaterNodeIDs: undefined,
+    };
+}
+//# sourceMappingURL=routeCache.js.map

package/build/lib/common/routeCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeCache.js","sourceRoot":"","sources":["../../../src/lib/common/routeCache.ts"],"names":[],"mappings":";;;AAgCA,gCAWC;AAED,kCAqBC;AAED,sCAMC;AA1ED,8CAK6B;AAE7B,MAAM,UAAU,GAAG,oBAAa,GAAG,CAAC,CAAC;AACxB,QAAA,eAAe,GAAG,CAAC,GAAG,UAAU,CAAC;AACjC,QAAA,qBAAqB,GAAG,IAAI,CAAC;AAC7B,QAAA,eAAe,GAAG,MAAM,CAAC,KAAK,CAC1C,uBAAe,EACf,6BAAqB,CACrB,CAAC;AAEF,IAAK,OAGJ;AAHD,WAAK,OAAO;IACX,0CAAe,CAAA;IACf,wCAAc,CAAA;AACf,CAAC,EAHI,OAAO,KAAP,OAAO,QAGX;AAcD,SAAgB,UAAU,CAAC,MAAc,EAAE,MAAc;IACxD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,GAAG,oBAAa,CAAC,CAAC;IACjD,MAAM,GAAG,GAAU;QAClB,OAAO,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,KAAK,CAAU;QACtD,YAAY,EAAE,SAAS,GAAG,2BAAoB;QAC9C,eAAe,EAAE;YAChB,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAa,CAAC;SAClD,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;KAC1B,CAAC;IACF,IAAI,GAAG,CAAC,eAAgB,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,GAAG,CAAC,eAAe,CAAC;IACjE,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,SAAgB,WAAW,CAAC,KAAwB;IACnD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACxC,IAAI,KAAK,EAAE,CAAC;QACX,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;YAC3B,KACC,IAAI,CAAC,GAAG,CAAC,EACT,CAAC,GAAG,oBAAa,IAAI,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC,MAAM,EACrD,CAAC,EAAE,EACF,CAAC;gBACF,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YACnC,CAAC;QACF,CAAC;aAAM,CAAC;YACP,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACf,CAAC;QACD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,KAAK,CAAC,OAAO;YAAE,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5D,SAAS,IAAI,KAAK,CAAC,YAAY,GAAG,2BAAoB,CAAC;QACvD,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC;IACjC,CAAC;IAED,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,SAAgB,aAAa;IAC5B,OAAO;QACN,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,4BAAqB,CAAC,SAAS;QAC7C,eAAe,EAAE,SAAS;KAC1B,CAAC;AACH,CAAC"}

package/build/lib/common/sucUpdateEntry.d.ts

@@ -0,0 +1,10 @@
+import { type CommandClasses } from "@zwave-js/core/safe";
+export interface SUCUpdateEntry {
+    nodeId: number;
+    changeType: number;
+    supportedCCs: CommandClasses[];
+    controlledCCs: CommandClasses[];
+}
+export declare function parseSUCUpdateEntry(buffer: Buffer, offset: number): SUCUpdateEntry | undefined;
+export declare function encodeSUCUpdateEntry(entry: SUCUpdateEntry | undefined): Buffer;
+//# sourceMappingURL=sucUpdateEntry.d.ts.map

package/build/lib/common/sucUpdateEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sucUpdateEntry.d.ts","sourceRoot":"","sources":["../../../src/lib/common/sucUpdateEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,cAAc,EAKnB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,aAAa,EAAE,cAAc,EAAE,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,cAAc,GAAG,SAAS,CAgB5B;AAED,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,cAAc,GAAG,SAAS,GAC/B,MAAM,CAeR"}

package/build/lib/common/sucUpdateEntry.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSUCUpdateEntry = parseSUCUpdateEntry;
+exports.encodeSUCUpdateEntry = encodeSUCUpdateEntry;
+const safe_1 = require("@zwave-js/core/safe");
+const consts_1 = require("../../consts");
+function parseSUCUpdateEntry(buffer, offset) {
+    const slice = buffer.subarray(offset, offset + consts_1.SUC_UPDATE_ENTRY_SIZE);
+    if (slice.every((b) => b === 0x00 || b === 0xff)) {
+        return;
+    }
+    const nodeId = slice[0];
+    const changeType = slice[1];
+    const { supportedCCs, controlledCCs } = (0, safe_1.parseCCList)(slice.subarray(2, consts_1.SUC_UPDATE_ENTRY_SIZE));
+    return {
+        nodeId,
+        changeType,
+        supportedCCs: supportedCCs.filter((cc) => cc > 0),
+        controlledCCs: controlledCCs.filter((cc) => cc > 0),
+    };
+}
+function encodeSUCUpdateEntry(entry) {
+    const ret = Buffer.alloc(consts_1.SUC_UPDATE_ENTRY_SIZE, 0);
+    if (entry) {
+        ret[0] = entry.nodeId;
+        ret[1] = entry.changeType;
+        const ccList = (0, safe_1.encodeCCList)(entry.supportedCCs, entry.controlledCCs);
+        if (ccList.length > consts_1.SUC_UPDATE_NODEPARM_MAX) {
+            throw new safe_1.ZWaveError("Cannot encode SUC update entry, too many CCs", safe_1.ZWaveErrorCodes.Argument_Invalid);
+        }
+        ccList.copy(ret, 2);
+    }
+    return ret;
+}
+//# sourceMappingURL=sucUpdateEntry.js.map

package/build/lib/common/sucUpdateEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sucUpdateEntry.js","sourceRoot":"","sources":["../../../src/lib/common/sucUpdateEntry.ts"],"names":[],"mappings":";;AAgBA,kDAmBC;AAED,oDAiBC;AAtDD,8CAM6B;AAC7B,yCAA8E;AAS9E,SAAgB,mBAAmB,CAClC,MAAc,EACd,MAAc;IAEd,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,8BAAqB,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QAClD,OAAO;IACR,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,IAAA,kBAAW,EAClD,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,8BAAqB,CAAC,CACxC,CAAC;IACF,OAAO;QACN,MAAM;QACN,UAAU;QACV,YAAY,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QACjD,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;KACnD,CAAC;AACH,CAAC;AAED,SAAgB,oBAAoB,CACnC,KAAiC;IAEjC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,8BAAqB,EAAE,CAAC,CAAC,CAAC;IACnD,IAAI,KAAK,EAAE,CAAC;QACX,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;QACtB,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAA,mBAAY,EAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QACrE,IAAI,MAAM,CAAC,MAAM,GAAG,gCAAuB,EAAE,CAAC;YAC7C,MAAM,IAAI,iBAAU,CACnB,8CAA8C,EAC9C,sBAAe,CAAC,gBAAgB,CAChC,CAAC;QACH,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/build/lib/common/utils.d.ts

@@ -0,0 +1,9 @@
+import type { NVMIO } from "./definitions";
+export declare function nvmReadUInt32LE(io: NVMIO, position: number): Promise<number>;
+export declare function nvmReadUInt16LE(io: NVMIO, position: number): Promise<number>;
+export declare function nvmReadUInt32BE(io: NVMIO, position: number): Promise<number>;
+export declare function nvmReadUInt16BE(io: NVMIO, position: number): Promise<number>;
+export declare function nvmReadUInt8(io: NVMIO, position: number): Promise<number>;
+export declare function nvmWriteBuffer(io: NVMIO, position: number, buffer: Buffer): Promise<void>;
+export declare function nvmReadBuffer(io: NVMIO, position: number, length: number): Promise<Buffer>;
+//# sourceMappingURL=utils.d.ts.map

package/build/lib/common/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/common/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,wBAAsB,eAAe,CACpC,EAAE,EAAE,KAAK,EACT,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,wBAAsB,eAAe,CACpC,EAAE,EAAE,KAAK,EACT,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,wBAAsB,eAAe,CACpC,EAAE,EAAE,KAAK,EACT,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,wBAAsB,eAAe,CACpC,EAAE,EAAE,KAAK,EACT,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,wBAAsB,YAAY,CACjC,EAAE,EAAE,KAAK,EACT,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,wBAAsB,cAAc,CACnC,EAAE,EAAE,KAAK,EACT,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAsB,aAAa,CAClC,EAAE,EAAE,KAAK,EACT,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAcjB"}

package/build/lib/common/utils.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nvmReadUInt32LE = nvmReadUInt32LE;
+exports.nvmReadUInt16LE = nvmReadUInt16LE;
+exports.nvmReadUInt32BE = nvmReadUInt32BE;
+exports.nvmReadUInt16BE = nvmReadUInt16BE;
+exports.nvmReadUInt8 = nvmReadUInt8;
+exports.nvmWriteBuffer = nvmWriteBuffer;
+exports.nvmReadBuffer = nvmReadBuffer;
+async function nvmReadUInt32LE(io, position) {
+    const { buffer } = await io.read(position, 4);
+    return buffer.readUInt32LE(0);
+}
+async function nvmReadUInt16LE(io, position) {
+    const { buffer } = await io.read(position, 2);
+    return buffer.readUInt16LE(0);
+}
+async function nvmReadUInt32BE(io, position) {
+    const { buffer } = await io.read(position, 4);
+    return buffer.readUInt32BE(0);
+}
+async function nvmReadUInt16BE(io, position) {
+    const { buffer } = await io.read(position, 2);
+    return buffer.readUInt16BE(0);
+}
+async function nvmReadUInt8(io, position) {
+    const { buffer } = await io.read(position, 1);
+    return buffer.readUInt8(0);
+}
+async function nvmWriteBuffer(io, position, buffer) {
+    const chunkSize = await io.determineChunkSize();
+    let offset = 0;
+    while (offset < buffer.length) {
+        const chunk = buffer.subarray(offset, offset + chunkSize);
+        const { bytesWritten } = await io.write(position + offset, chunk);
+        offset += bytesWritten;
+    }
+}
+async function nvmReadBuffer(io, position, length) {
+    const ret = Buffer.allocUnsafe(length);
+    const chunkSize = await io.determineChunkSize();
+    let offset = 0;
+    while (offset < length) {
+        const { buffer, endOfFile } = await io.read(position + offset, Math.min(chunkSize, length - offset));
+        buffer.copy(ret, offset);
+        offset += buffer.length;
+        if (endOfFile)
+            break;
+    }
+    return ret.subarray(0, offset);
+}
+//# sourceMappingURL=utils.js.map

package/build/lib/common/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/lib/common/utils.ts"],"names":[],"mappings":";;AAEA,0CAMC;AAED,0CAMC;AAED,0CAMC;AAED,0CAMC;AAED,oCAMC;AAED,wCAYC;AAED,sCAkBC;AAxEM,KAAK,UAAU,eAAe,CACpC,EAAS,EACT,QAAgB;IAEhB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAEM,KAAK,UAAU,eAAe,CACpC,EAAS,EACT,QAAgB;IAEhB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAEM,KAAK,UAAU,eAAe,CACpC,EAAS,EACT,QAAgB;IAEhB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAEM,KAAK,UAAU,eAAe,CACpC,EAAS,EACT,QAAgB;IAEhB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAEM,KAAK,UAAU,YAAY,CACjC,EAAS,EACT,QAAgB;IAEhB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAEM,KAAK,UAAU,cAAc,CACnC,EAAS,EACT,QAAgB,EAChB,MAAc;IAEd,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,kBAAkB,EAAE,CAAC;IAChD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;QAC1D,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,IAAI,YAAY,CAAC;IACxB,CAAC;AACF,CAAC;AAEM,KAAK,UAAU,aAAa,CAClC,EAAS,EACT,QAAgB,EAChB,MAAc;IAEd,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,kBAAkB,EAAE,CAAC;IAChD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,MAAM,EAAE,CAAC;QACxB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAC1C,QAAQ,GAAG,MAAM,EACjB,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,CACpC,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzB,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC;QACxB,IAAI,SAAS;YAAE,MAAM;IACtB,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAChC,CAAC"}

package/build/lib/io/BufferedNVMReader.d.ts

@@ -0,0 +1,21 @@
+import { type NVMAccess, type NVMIO } from "../common/definitions";
+export declare class BufferedNVMReader implements NVMIO {
+    constructor(inner: NVMIO);
+    private _inner;
+    private _buffer;
+    open(access: NVMAccess.Read | NVMAccess.Write): Promise<NVMAccess>;
+    get size(): number;
+    get accessMode(): NVMAccess;
+    determineChunkSize(): Promise<number>;
+    private readBuffered;
+    read(offset: number, length: number): Promise<{
+        buffer: Buffer;
+        endOfFile: boolean;
+    }>;
+    write(offset: number, data: Buffer): Promise<{
+        bytesWritten: number;
+        endOfFile: boolean;
+    }>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=BufferedNVMReader.d.ts.map

package/build/lib/io/BufferedNVMReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BufferedNVMReader.d.ts","sourceRoot":"","sources":["../../../src/lib/io/BufferedNVMReader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAOnE,qBAAa,iBAAkB,YAAW,KAAK;gBAC3B,KAAK,EAAE,KAAK;IAI/B,OAAO,CAAC,MAAM,CAAQ;IAItB,OAAO,CAAC,OAAO,CAAuB;IAEtC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,GAAG,SAAS,CAAC,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC;IAGlE,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,UAAU,IAAI,SAAS,CAE1B;IACD,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;YAIvB,YAAY;IAkBpB,IAAI,CACT,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IA+B5C,KAAK,CACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACV,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAqBxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGtB"}

package/build/lib/io/BufferedNVMReader.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BufferedNVMReader = void 0;
+class BufferedNVMReader {
+    constructor(inner) {
+        this._inner = inner;
+    }
+    _inner;
+    // Already-read chunks. There are a few rules to follow:
+    // - Offsets MUST be multiples of the chunk size
+    // - The size of each chunk must be exactly the chunk size
+    _buffer = [];
+    open(access) {
+        return this._inner.open(access);
+    }
+    get size() {
+        return this._inner.size;
+    }
+    get accessMode() {
+        return this._inner.accessMode;
+    }
+    determineChunkSize() {
+        return this._inner.determineChunkSize();
+    }
+    async readBuffered(alignedOffset, chunkSize) {
+        let buffered = this._buffer.find((chunk) => chunk.offset === alignedOffset);
+        if (!buffered) {
+            const { buffer: data } = await this._inner.read(alignedOffset, chunkSize);
+            buffered = { data, offset: alignedOffset };
+            this._buffer.push(buffered);
+        }
+        return buffered.data;
+    }
+    async read(offset, length) {
+        // Limit the read size to the chunk size. This ensures we have to deal with maximum 2 chunks or read requests
+        const chunkSize = await this.determineChunkSize();
+        length = Math.min(length, chunkSize);
+        // Figure out at which offsets to read
+        const firstChunkStart = offset - offset % chunkSize;
+        const secondChunkStart = (offset + length)
+            - (offset + length) % chunkSize;
+        // Read one or two chunks, depending on how many are needed
+        const chunks = [];
+        chunks.push(await this.readBuffered(firstChunkStart, chunkSize));
+        if (secondChunkStart > firstChunkStart) {
+            chunks.push(await this.readBuffered(secondChunkStart, chunkSize));
+        }
+        const alignedBuffer = Buffer.concat(chunks);
+        // Then slice out the section we need
+        const endOfFile = offset + length >= this.size;
+        const buffer = alignedBuffer.subarray(offset - firstChunkStart, offset - firstChunkStart + length);
+        return {
+            buffer,
+            endOfFile,
+        };
+    }
+    async write(offset, data) {
+        const ret = await this._inner.write(offset, data);
+        // Invalidate cached chunks
+        const chunkSize = await this.determineChunkSize();
+        // Figure out at which offsets to read
+        const firstChunkStart = offset - offset % chunkSize;
+        const lastChunkStart = (offset + ret.bytesWritten)
+            - (offset + ret.bytesWritten) % chunkSize;
+        // TODO: We should update existing chunks where possible
+        for (let i = firstChunkStart; i <= lastChunkStart; i += chunkSize) {
+            const index = this._buffer.findIndex((chunk) => chunk.offset === i);
+            if (index !== -1) {
+                this._buffer.splice(index, 1);
+            }
+        }
+        return ret;
+    }
+    close() {
+        return this._inner.close();
+    }
+}
+exports.BufferedNVMReader = BufferedNVMReader;
+//# sourceMappingURL=BufferedNVMReader.js.map

package/build/lib/io/BufferedNVMReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BufferedNVMReader.js","sourceRoot":"","sources":["../../../src/lib/io/BufferedNVMReader.ts"],"names":[],"mappings":"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"}

package/build/lib/io/NVMFileIO.d.ts

@@ -0,0 +1,24 @@
+import { NVMAccess, type NVMIO } from "../common/definitions";
+/** An implementation of NVMIO for the filesystem */
+export declare class NVMFileIO implements NVMIO {
+    constructor(path: string);
+    private _path;
+    private _handle;
+    private _chunkSize;
+    open(access: NVMAccess): Promise<NVMAccess>;
+    private _size;
+    get size(): number;
+    private _accessMode;
+    get accessMode(): NVMAccess;
+    determineChunkSize(): Promise<number>;
+    read(offset: number, length: number): Promise<{
+        buffer: Buffer;
+        endOfFile: boolean;
+    }>;
+    write(offset: number, data: Buffer): Promise<{
+        bytesWritten: number;
+        endOfFile: boolean;
+    }>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=NVMFileIO.d.ts.map

package/build/lib/io/NVMFileIO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NVMFileIO.d.ts","sourceRoot":"","sources":["../../../src/lib/io/NVMFileIO.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9D,oDAAoD;AACpD,qBAAa,SAAU,YAAW,KAAK;gBACnB,IAAI,EAAE,MAAM;IAK/B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,UAAU,CAAa;IAEzB,IAAI,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAsBjD,OAAO,CAAC,KAAK,CAAqB;IAClC,IAAI,IAAI,IAAI,MAAM,CAQjB;IAED,OAAO,CAAC,WAAW,CAAY;IAC/B,IAAI,UAAU,IAAI,SAAS,CAE1B;IAED,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/B,IAAI,CACT,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAmB5C,KAAK,CACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACV,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAuBlD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM5B"}

package/build/lib/io/NVMFileIO.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NVMFileIO = void 0;
+const core_1 = require("@zwave-js/core");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const definitions_1 = require("../common/definitions");
+/** An implementation of NVMIO for the filesystem */
+class NVMFileIO {
+    constructor(path) {
+        this._path = path;
+        this._accessMode = definitions_1.NVMAccess.None;
+    }
+    _path;
+    _handle;
+    _chunkSize = 16 * 1024; // We could read more, but 16 KB chunks are more than enough for reading NVM contents
+    async open(access) {
+        let flags;
+        switch (access) {
+            case definitions_1.NVMAccess.Read:
+                flags = "r";
+                break;
+            case definitions_1.NVMAccess.Write:
+            case definitions_1.NVMAccess.ReadWrite:
+                // Read/Write, don't create, don't truncate
+                flags = "r+";
+                access = definitions_1.NVMAccess.ReadWrite;
+                break;
+            default:
+                throw new Error("Invalid access mode");
+        }
+        this._handle = await promises_1.default.open(this._path, flags);
+        this._size = (await this._handle.stat()).size;
+        this._accessMode = access;
+        return access;
+    }
+    _size;
+    get size() {
+        if (this._size == undefined) {
+            throw new core_1.ZWaveError("The NVM file is not open", core_1.ZWaveErrorCodes.NVM_NotOpen);
+        }
+        return this._size;
+    }
+    _accessMode;
+    get accessMode() {
+        return this._accessMode;
+    }
+    determineChunkSize() {
+        return Promise.resolve(this._chunkSize);
+    }
+    async read(offset, length) {
+        if (this._handle == undefined) {
+            throw new core_1.ZWaveError("The NVM file is not open", core_1.ZWaveErrorCodes.NVM_NotOpen);
+        }
+        const readResult = await this._handle.read({
+            buffer: Buffer.alloc(length),
+            position: offset,
+        });
+        const endOfFile = offset + readResult.bytesRead >= this.size;
+        return {
+            buffer: readResult.buffer.subarray(0, readResult.bytesRead),
+            endOfFile,
+        };
+    }
+    async write(offset, data) {
+        if (this._handle == undefined) {
+            throw new core_1.ZWaveError("The NVM file is not open", core_1.ZWaveErrorCodes.NVM_NotOpen);
+        }
+        if (offset + data.length > this.size) {
+            throw new core_1.ZWaveError("Write would exceed the NVM size", core_1.ZWaveErrorCodes.NVM_NoSpace);
+        }
+        const writeResult = await this._handle.write(data, 0, data.length, offset);
+        const endOfFile = offset + writeResult.bytesWritten >= this.size;
+        return { bytesWritten: writeResult.bytesWritten, endOfFile };
+    }
+    async close() {
+        await this._handle?.close();
+        this._handle = undefined;
+        this._accessMode = definitions_1.NVMAccess.None;
+        this._size = undefined;
+    }
+}
+exports.NVMFileIO = NVMFileIO;
+//# sourceMappingURL=NVMFileIO.js.map

package/build/lib/io/NVMFileIO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NVMFileIO.js","sourceRoot":"","sources":["../../../src/lib/io/NVMFileIO.ts"],"names":[],"mappings":"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"}

package/build/lib/io/NVMMemoryIO.d.ts

@@ -0,0 +1,20 @@
+import { NVMAccess, type NVMIO } from "../common/definitions";
+/** An im-memory implementation of NVMIO */
+export declare class NVMMemoryIO implements NVMIO {
+    constructor(buffer: Buffer);
+    private _buffer;
+    open(_access: NVMAccess.Read | NVMAccess.Write): Promise<NVMAccess>;
+    get size(): number;
+    get accessMode(): NVMAccess;
+    determineChunkSize(): Promise<number>;
+    read(offset: number, length: number): Promise<{
+        buffer: Buffer;
+        endOfFile: boolean;
+    }>;
+    write(offset: number, data: Buffer): Promise<{
+        bytesWritten: number;
+        endOfFile: boolean;
+    }>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=NVMMemoryIO.d.ts.map

package/build/lib/io/NVMMemoryIO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NVMMemoryIO.d.ts","sourceRoot":"","sources":["../../../src/lib/io/NVMMemoryIO.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9D,2CAA2C;AAC3C,qBAAa,WAAY,YAAW,KAAK;gBACrB,MAAM,EAAE,MAAM;IAIjC,OAAO,CAAC,OAAO,CAAS;IAExB,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,GAAG,SAAS,CAAC,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC;IAKnE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,UAAU,IAAI,SAAS,CAE1B;IAED,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKrC,IAAI,CACH,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAOlD,KAAK,CACJ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACV,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAexD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAItB"}