@matter/model 0.11.0-alpha.0-20241005-e3e4e4a7a

package/dist/cjs/common/FieldValue.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Metatype } from "./Metatype.js";
+/**
+ * A FieldValue represents a concrete value for a datatype.  Most values are primitives but some values we encode with
+ * specialized typed objects so we can capture the original semantic meaning.
+ */
+export type FieldValue = null | string | number | bigint | boolean | Date | FieldValue[] | FieldValue.Properties | FieldValue.Reference | FieldValue.Percent | FieldValue.Celsius | FieldValue.Bytes;
+export declare namespace FieldValue {
+    const percent = "percent";
+    type percent = typeof percent;
+    const celsius = "celsius";
+    type celsius = typeof celsius;
+    const reference = "reference";
+    type reference = typeof reference;
+    const properties = "properties";
+    type properties = typeof properties;
+    const bytes = "bytes";
+    type bytes = typeof bytes;
+    /**
+     * If a field value isn't a primitive type, it's an object with a type field indicating one of these types.
+     */
+    type Type = percent | celsius | reference | properties | bytes;
+    /**
+     * Test for one of the special placeholder types.
+     */
+    function is(value: FieldValue | undefined, type: Type): boolean | "" | 0 | 0n | null | undefined;
+    /**
+     * Flag for an invalid value.  Not part of the FieldValue union but returned when casting to a field value if the
+     * cast is impossible
+     */
+    const Invalid: unique symbol;
+    type Invalid = typeof Invalid;
+    /**
+     * Reference to a named field
+     */
+    type Reference = {
+        type: reference;
+        name: string;
+    };
+    function Reference(name: string): Reference;
+    /**
+     * Celsius value, typically .1°C or .01°C
+     */
+    type Celsius = {
+        type: celsius;
+        value: number;
+    };
+    function Celsius(value: number): Celsius;
+    /**
+     * Percent value, units of either 1% (.01) or .01% (.0001)
+     */
+    type Percent = {
+        type: percent;
+        value: number;
+    };
+    function Percent(value: number): Percent;
+    /**
+     * A set of struct property values keyed by name.
+     */
+    type Properties = {
+        type: properties;
+        properties: {
+            [name: string]: FieldValue;
+        };
+    };
+    /**
+     * Byte value, encoded as hex string.
+     */
+    type Bytes = {
+        type: bytes;
+        value: string;
+    };
+    function Bytes(value: Uint8Array | string): Bytes;
+    /**
+     * Convert the field value to a "defacto-standard" form.
+     */
+    function serialize(value: FieldValue): string;
+    /**
+     * Given a type name as a hint, do our best to convert a field value to a number.
+     */
+    function numericValue(value: FieldValue | undefined, typeName?: string): number | undefined;
+    /**
+     * Extract object properties from the value.
+     */
+    function objectValue(value: FieldValue | undefined): {
+        [name: string]: FieldValue;
+    } | undefined;
+    /**
+     * Unwrap wrapped values, leave others as-is.
+     */
+    function unwrap(value: FieldValue | undefined, typeName?: string): string | number | bigint | boolean | Date | FieldValue[] | {
+        [name: string]: FieldValue;
+    } | null | undefined;
+    /**
+     * Get the referenced name if the FieldValue is a reference.
+     */
+    function referenced(value: FieldValue | undefined): string | undefined;
+    /**
+     * Convert an arbitrary value to a proper FieldValue.
+     *
+     * @param type casts to a native equivalent of this type
+     * @param value value to cast
+     *
+     * @returns the cast value or FieldValue.Invalid if cast is not possible
+     */
+    function cast(type: Metatype, value: any): FieldValue | FieldValue.Invalid | undefined;
+}
+//# sourceMappingURL=FieldValue.d.ts.map

package/dist/cjs/common/FieldValue.d.ts.map

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

package/dist/cjs/common/FieldValue.js

@@ -0,0 +1,269 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var FieldValue_exports = {};
+__export(FieldValue_exports, {
+  FieldValue: () => FieldValue
+});
+module.exports = __toCommonJS(FieldValue_exports);
+var import_general = require("@matter/general");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var FieldValue;
+((FieldValue2) => {
+  FieldValue2.percent = "percent";
+  FieldValue2.celsius = "celsius";
+  FieldValue2.reference = "reference";
+  FieldValue2.properties = "properties";
+  FieldValue2.bytes = "bytes";
+  function is(value, type) {
+    return value && value.type === type;
+  }
+  FieldValue2.is = is;
+  FieldValue2.Invalid = Symbol("invalid");
+  function Reference(name) {
+    return { type: FieldValue2.reference, name };
+  }
+  FieldValue2.Reference = Reference;
+  function Celsius(value) {
+    return { type: FieldValue2.celsius, value };
+  }
+  FieldValue2.Celsius = Celsius;
+  function Percent(value) {
+    return { type: FieldValue2.percent, value };
+  }
+  FieldValue2.Percent = Percent;
+  function Bytes(value) {
+    return { type: FieldValue2.bytes, value: ArrayBuffer.isView(value) ? import_general.Bytes.toHex(value) : value };
+  }
+  FieldValue2.Bytes = Bytes;
+  function serialize(value) {
+    if (value === null) {
+      return "null";
+    }
+    if (is(value, FieldValue2.reference)) {
+      return value.name;
+    }
+    if (is(value, FieldValue2.celsius)) {
+      return `${value.value}\xB0C`;
+    }
+    if (is(value, FieldValue2.percent)) {
+      return `${value.value}%';`;
+    }
+    if (is(value, FieldValue2.properties)) {
+      return (0, import_general.serialize)(value.properties) ?? "?";
+    }
+    return value.toString();
+  }
+  FieldValue2.serialize = serialize;
+  function numericValue(value, typeName) {
+    if (typeof value === "boolean") {
+      return value ? 1 : 0;
+    }
+    if (typeof value === "number") {
+      return value;
+    }
+    if (is(value, FieldValue2.celsius)) {
+      switch (typeName) {
+        case "temperature":
+        case "temp-diff":
+          return value.value * 100;
+        case "temp-u8":
+        case "temp-s8":
+          return value.value * 10;
+      }
+      return;
+    }
+    if (is(value, FieldValue2.percent)) {
+      switch (typeName) {
+        case "percent100ths":
+          return value.value * 100;
+        default:
+          return value.value;
+      }
+    }
+  }
+  FieldValue2.numericValue = numericValue;
+  function objectValue(value) {
+    if (is(value, FieldValue2.properties)) {
+      return value.properties;
+    }
+  }
+  FieldValue2.objectValue = objectValue;
+  function unwrap(value, typeName) {
+    if (value === null || typeof value !== "object" || Array.isArray(value) || value instanceof Date) {
+      return value;
+    }
+    const type = value.type;
+    switch (type) {
+      case "properties":
+        return objectValue(value);
+      case "reference":
+        return;
+      case "percent":
+      case "celsius":
+        return numericValue(value, typeName);
+      case void 0:
+        throw new import_general.UnexpectedDataError(`Field value objects must be wrappers with "type" field`);
+      default:
+        throw new import_general.UnexpectedDataError(`Unsupported wrapped object type "${type}"`);
+    }
+  }
+  FieldValue2.unwrap = unwrap;
+  function referenced(value) {
+    if (is(value, FieldValue2.reference)) {
+      return value.name;
+    }
+  }
+  FieldValue2.referenced = referenced;
+  function cast(type, value) {
+    if (value === void 0 || value === null || type === "any") {
+      return value;
+    }
+    if (value === "null") {
+      return null;
+    }
+    if (value === "") {
+      if (type === "string") {
+        return "";
+      }
+      return void 0;
+    }
+    if (FieldValue2.is(value, FieldValue2.reference)) {
+      return value;
+    }
+    switch (type) {
+      case "string":
+        return value.toString();
+      case "boolean":
+        if (typeof value === "string") {
+          value = value.trim().toLowerCase();
+        }
+        return value !== "false" && value !== "no" && !!value;
+      case "bitmap":
+      case "enum":
+        if (FieldValue2.is(value, FieldValue2.properties) && type === "bitmap") {
+          return value;
+        }
+        const id = Number(value);
+        if (Number.isNaN(id)) {
+          if (typeof value === "string") {
+            return value;
+          }
+          return;
+        }
+        return id;
+      case "integer":
+        if (typeof value === "string") {
+          let type2;
+          if (value.endsWith("\xB0C")) {
+            type2 = FieldValue2.celsius;
+          } else if (value.endsWith("%")) {
+            type2 = FieldValue2.percent;
+          }
+          if (type2) {
+            value = Number.parseInt(value);
+            if (Number.isNaN(value)) {
+              return FieldValue2.Invalid;
+            }
+            return { type: type2, value };
+          }
+          const match = value.match(/^(0x[0-9a-f]+|0b[01]+|\d+)/i);
+          if (match) {
+            value = match[1];
+          }
+        }
+        try {
+          switch (typeof value) {
+            case "string":
+            case "number":
+            case "bigint":
+            case "boolean":
+              break;
+            default:
+              if (FieldValue2.is(value, FieldValue2.celsius) || FieldValue2.is(value, FieldValue2.percent)) {
+                return value;
+              }
+              return FieldValue2.Invalid;
+          }
+          const i = BigInt(value);
+          const n = Number(i);
+          if (BigInt(n) === i) {
+            return n;
+          }
+          return i;
+        } catch (e) {
+          if (e instanceof SyntaxError) {
+            return FieldValue2.Invalid;
+          }
+          throw e;
+        }
+      case "float":
+        const float = Number(value);
+        if (Number.isNaN(float)) {
+          return FieldValue2.Invalid;
+        }
+        return float.valueOf();
+      case "date":
+        if (value instanceof Date) {
+          return value;
+        }
+        if (typeof value !== "string") {
+          return FieldValue2.Invalid;
+        }
+        value = new Date(value);
+        if (Number.isNaN(value.valueOf())) {
+          return FieldValue2.Invalid;
+        }
+        return value;
+      case "object":
+        if (FieldValue2.is(value, FieldValue2.properties)) {
+          return value;
+        }
+        break;
+      case "bytes":
+        if (value === "empty") {
+          return void 0;
+        }
+        if (FieldValue2.is(value, FieldValue2.bytes)) {
+          return value;
+        }
+        if (typeof value === "string" || value instanceof Uint8Array) {
+          return Bytes(value);
+        }
+        break;
+      case "array":
+        if (value === "0" || value === "{0,0}") {
+          return;
+        }
+        if (value === "empty" || value === "[]" || value === "{}") {
+          return [];
+        }
+        if (Array.isArray(value)) {
+          return value;
+        }
+        return FieldValue2.Invalid;
+    }
+    return FieldValue2.Invalid;
+  }
+  FieldValue2.cast = cast;
+})(FieldValue || (FieldValue = {}));
+//# sourceMappingURL=FieldValue.js.map

package/dist/cjs/common/FieldValue.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/common/FieldValue.ts"],
+  "mappings": "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",
+  "names": ["FieldValue", "ByteUtils", "stringSerialize", "type"]
+}

package/dist/cjs/common/Mei.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Base type for semantic identifiers per Matter specification.  Formally a 32-bit unsigned integer with assigned bit
+ * functions:
+ *
+ *     Bits 0-15 are the identifier's scope:
+ *         0x0000: Standard (global) or scoped (within cluster) ID
+ *         0x0001 - 0xfff0: Manufacturer code as defined by CSA group
+ *         0xfff1 - 0xfff4: Test manufacturer codes
+ *     Bits 16-31 are the actual identifier
+ *
+ * For this and following types, the specification defines restrictions that we do not express statically with
+ * TypeScript.
+ */
+export type ManufacturerExtensibleIdentifier = number;
+export type Mei = ManufacturerExtensibleIdentifier;
+//# sourceMappingURL=Mei.d.ts.map

package/dist/cjs/common/Mei.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mei.d.ts","sourceRoot":"","sources":["../../../src/common/Mei.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,gCAAgC,GAAG,MAAM,CAAC;AACtD,MAAM,MAAM,GAAG,GAAG,gCAAgC,CAAC"}

package/dist/cjs/common/Mei.js

@@ -0,0 +1,22 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Mei_exports = {};
+module.exports = __toCommonJS(Mei_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=Mei.js.map

package/dist/cjs/common/Mei.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/common/Mei.ts"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/common/Metatype.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes, UnexpectedDataError } from "@matter/general";
+export declare class UnsupportedCastError extends UnexpectedDataError {
+}
+/**
+ * General groupings of Matter types.
+ */
+export declare enum Metatype {
+    any = "any",
+    boolean = "boolean",
+    bitmap = "bitmap",
+    enum = "enum",
+    integer = "integer",
+    float = "float",
+    bytes = "bytes",
+    array = "array",
+    object = "object",
+    string = "string",
+    date = "date"
+}
+export declare namespace Metatype {
+    /**
+     * Does the specific type have children?
+     */
+    function hasChildren(type: Metatype | undefined): boolean;
+    /**
+     * Determine the JS type for a metatype.
+     */
+    function native(type: Metatype | undefined): ObjectConstructor | ArrayConstructor | NumberConstructor | DateConstructor | Uint8ArrayConstructor | BigIntConstructor | BooleanConstructor | StringConstructor | undefined;
+    /**
+     * Functions that perform conversion of arbitrary values to a metatype.
+     *
+     * This is a "best effort" that ensures the value is an appropriate JS type but cannot ensure semantic validity in
+     * all cases.
+     *
+     * @throws {@link UnsupportedCastError} if the cast is deemed impossible
+     */
+    const cast: Record<Metatype, (value: any) => any>;
+    /**
+     * These are the native types used by this module.
+     */
+    type NativeType = typeof Boolean | typeof BigInt | typeof Number | typeof Bytes | typeof Array | typeof Object | typeof String | typeof Date;
+}
+//# sourceMappingURL=Metatype.d.ts.map

package/dist/cjs/common/Metatype.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Metatype.d.ts","sourceRoot":"","sources":["../../../src/common/Metatype.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAY,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEvE,qBAAa,oBAAqB,SAAQ,mBAAmB;CAAG;AAEhE;;GAEG;AACH,oBAAY,QAAQ;IAChB,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,IAAI,SAAS;CAChB;AAED,yBAAiB,QAAQ,CAAC;IACtB;;OAEG;IACH,SAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,WAUrD;IAED;;OAEG;IACH,SAAgB,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,+KA4BhD;IAED;;;;;;;OAOG;IACI,MAAM,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CA6OtD,CAAC;IAEF;;OAEG;IACH,KAAY,UAAU,GAChB,OAAO,OAAO,GACd,OAAO,MAAM,GACb,OAAO,MAAM,GACb,OAAO,KAAK,GACZ,OAAO,KAAK,GACZ,OAAO,MAAM,GACb,OAAO,MAAM,GACb,OAAO,IAAI,CAAC;CACrB"}