@matter/nodejs 0.16.6-alpha.0-20260121-bc6d62766 → 0.16.6

package/dist/esm/storage/sqlite/SqliteStorage.js

@@ -0,0 +1,423 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+  fromJson,
+  Storage,
+  toJson
+} from "@matter/general";
+import { SqliteStorageError } from "./SqliteStorageError.js";
+import { SqliteTransaction as Transaction } from "./SqliteTypes.js";
+import { buildContextKeyLog, buildContextKeyPair, buildContextPath, escapeGlob } from "./SqliteUtil.js";
+class SqliteStorage extends Storage {
+  static memoryPath = ":memory:";
+  static defaultTableName = "kvstore";
+  isInitialized = false;
+  #inTransaction = false;
+  // internal values
+  database;
+  dbPath;
+  tableName;
+  clearOnInit;
+  databaseCreator;
+  // queries
+  #queryInit;
+  #queryGet;
+  #queryGetRaw;
+  #querySet;
+  #querySetRaw;
+  #queryDelete;
+  #queryKeys;
+  #queryValues;
+  #queryContextSub;
+  #queryClear;
+  #queryClearAll;
+  #queryHas;
+  #queryOpenBlob;
+  #queryWriteBlob;
+  /**
+   * Create sqlite-based disk
+   *
+   * @param args.databaseCreator database instance creator
+   * @param args.path Database path (treats `null` as `:memory:`, DO NOT input `:memory:` directly)
+   * @param args.clear Clear on init
+   * @param args.tableName table name
+   */
+  constructor(args) {
+    super();
+    const { databaseCreator, path, tableName, clear } = args;
+    this.dbPath = path === null ? SqliteStorage.memoryPath : path;
+    this.databaseCreator = databaseCreator;
+    this.database = databaseCreator(this.dbPath);
+    this.tableName = tableName ?? SqliteStorage.defaultTableName;
+    this.clearOnInit = clear ?? false;
+    this.#queryInit = this.database.prepare(`
+      CREATE TABLE IF NOT EXISTS ${this.tableName} (
+        context TEXT NOT NULL,
+        key TEXT NOT NULL,
+        value_type TEXT CHECK(value_type IN ('json', 'blob')),
+        value_json TEXT,
+        value_blob BLOB,
+        CONSTRAINT PKPair PRIMARY KEY (context, key)
+      ) STRICT
+    `);
+    this.#queryInit.run();
+    this.#queryGet = this.database.prepare(`
+      SELECT value_json FROM ${this.tableName} WHERE
+        context=$context AND
+        key=$key AND
+        value_type='json'
+    `);
+    this.#queryGetRaw = this.database.prepare(`
+      SELECT * FROM ${this.tableName}
+    `);
+    this.#queryHas = this.database.prepare(`
+      SELECT EXISTS(
+        SELECT 1 FROM ${this.tableName}
+        WHERE context=$context AND key=$key
+      ) as has_record
+    `);
+    this.#querySet = this.database.prepare(`
+      INSERT INTO ${this.tableName}
+        (context, key, value_type, value_json, value_blob)
+      VALUES($context, $key, 'json', $value_json, NULL)
+      ON CONFLICT(context, key)
+      DO UPDATE SET
+        value_type = 'json',
+        value_json = excluded.value_json,
+        value_blob = NULL
+    `);
+    this.#querySetRaw = this.database.prepare(`
+      INSERT INTO ${this.tableName}
+        (context, key, value_type, value_json, value_blob)
+      VALUES($context, $key, $value_type, $value_json, $value_blob)
+      ON CONFLICT(context, key)
+      DO UPDATE SET
+        value_type = excluded.value_type,
+        value_json = excluded.value_json,
+        value_blob = excluded.value_blob
+    `);
+    this.#queryDelete = this.database.prepare(`
+      DELETE FROM ${this.tableName} WHERE
+        context=$context AND
+        key=$key
+    `);
+    this.#queryClear = this.database.prepare(`
+      DELETE FROM ${this.tableName}
+    `);
+    this.#queryClearAll = this.database.prepare(`
+      DELETE FROM ${this.tableName} WHERE
+        context=$context OR context GLOB $contextGlob
+    `);
+    this.#queryKeys = this.database.prepare(`
+      SELECT DISTINCT key FROM ${this.tableName} WHERE
+        context=$context
+    `);
+    this.#queryValues = this.database.prepare(`
+      SELECT key, value_json FROM ${this.tableName} WHERE
+        context=$context AND
+        value_type='json'
+    `);
+    this.#queryContextSub = this.database.prepare(`
+      SELECT DISTINCT context FROM ${this.tableName} WHERE
+        context GLOB $contextGlob
+    `);
+    this.#queryOpenBlob = this.database.prepare(`
+      SELECT value_type, value_json, value_blob FROM ${this.tableName} WHERE
+        context=$context AND
+        key=$key
+    `);
+    this.#queryWriteBlob = this.database.prepare(`
+      INSERT INTO ${this.tableName}
+        (context, key, value_type, value_json, value_blob)
+      VALUES($context, $key, 'blob', NULL, $value_blob)
+      ON CONFLICT(context, key)
+      DO UPDATE SET
+        value_type = 'blob',
+        value_json = NULL,
+        value_blob = excluded.value_blob
+    `);
+  }
+  /**
+   * Manual transaction control
+   *
+   * Use this for explicit transaction management across multiple operations.
+   * Internal methods like `set()` will automatically detect and use external transactions.
+   *
+   * TODO: Sync transaction to native matter.js API
+   */
+  transaction(mode) {
+    switch (mode) {
+      case Transaction.BEGIN:
+        if (this.#inTransaction) {
+          throw new SqliteStorageError("transaction", "BEGIN", "Transaction is in progress.");
+        }
+        this.database.exec("BEGIN IMMEDIATE TRANSACTION");
+        this.#inTransaction = true;
+        break;
+      case Transaction.COMMIT:
+        if (!this.#inTransaction) {
+          throw new SqliteStorageError("transaction", "COMMIT", "No transaction in progress.");
+        }
+        this.database.exec("COMMIT");
+        this.#inTransaction = false;
+        break;
+      case Transaction.ROLLBACK:
+        if (!this.#inTransaction) {
+          return;
+        }
+        this.database.exec("ROLLBACK");
+        this.#inTransaction = false;
+        break;
+    }
+  }
+  withAnyTransaction(callback) {
+    if (this.#inTransaction) {
+      return callback();
+    }
+    this.transaction(Transaction.BEGIN);
+    try {
+      const result = callback();
+      this.transaction(Transaction.COMMIT);
+      return result;
+    } catch (err) {
+      this.transaction(Transaction.ROLLBACK);
+      throw err;
+    }
+  }
+  get initialized() {
+    return this.isInitialized;
+  }
+  async initialize() {
+    if (this.clearOnInit) {
+      await this.clear(false);
+    }
+    this.isInitialized = true;
+  }
+  clone() {
+    const clonedStorage = new SqliteStorage({
+      databaseCreator: this.databaseCreator,
+      path: null,
+      tableName: this.tableName,
+      clear: false
+    });
+    const rawData = this.getRawAll();
+    clonedStorage.setRaw(rawData);
+    clonedStorage.isInitialized = true;
+    return clonedStorage;
+  }
+  close() {
+    this.isInitialized = false;
+    this.database.close();
+  }
+  get(contexts, key) {
+    const queryResult = this.#queryGet.get(buildContextKeyPair(contexts, key));
+    if (queryResult == null) {
+      return void 0;
+    }
+    if (queryResult.value_json === null) {
+      this.delete(contexts, key);
+      throw new SqliteStorageError(
+        "get",
+        buildContextKeyLog(contexts, key),
+        "path has null json-value! (expected non-null value)"
+      );
+    }
+    return fromJson(queryResult.value_json);
+  }
+  getRawAll() {
+    return this.#queryGetRaw.all().filter((v) => v != null);
+  }
+  set(contexts, keyOrValues, value) {
+    if (typeof keyOrValues === "string") {
+      if (value === void 0) {
+        throw new SqliteStorageError(
+          "set",
+          buildContextKeyLog(contexts, keyOrValues),
+          "Use null instead of undefined if you want to store null value!"
+        );
+      }
+      this.setValue(contexts, keyOrValues, toJson(value));
+    } else {
+      this.withAnyTransaction(() => {
+        for (const [key, value2] of Object.entries(keyOrValues)) {
+          this.setValue(contexts, key, toJson(value2 ?? null));
+        }
+      });
+    }
+  }
+  /**
+   * Set [contexts, key] to value
+   * @param contexts Context
+   * @param key Key
+   * @param value Value
+   * @returns
+   */
+  setValue(contexts, key, value) {
+    const { changes } = this.#querySet.run({
+      ...buildContextKeyPair(contexts, key),
+      value_json: value
+    });
+    if (Number(changes) <= 0) {
+      throw new SqliteStorageError(
+        "set",
+        buildContextKeyLog(contexts, key),
+        `Something went wrong! Value wasn't changed.`
+      );
+    }
+  }
+  /**
+   * Set Raw data. (for copy)
+   */
+  setRaw(rawData) {
+    if (rawData.length <= 0) {
+      return;
+    }
+    if (rawData.length === 1) {
+      const raw = rawData[0];
+      const { changes } = this.#querySetRaw.run({
+        context: raw.context,
+        key: raw.key,
+        value_type: raw.value_type,
+        value_json: raw.value_json,
+        value_blob: raw.value_blob
+      });
+      if (Number(changes) <= 0) {
+        throw new SqliteStorageError(
+          "setraw",
+          `${raw.context}$${raw.key}`,
+          `Something went wrong! Value wasn't changed.`
+        );
+      }
+      return;
+    }
+    this.withAnyTransaction(() => {
+      for (const raw of rawData) {
+        const { changes } = this.#querySetRaw.run({
+          context: raw.context,
+          key: raw.key,
+          value_type: raw.value_type,
+          value_json: raw.value_json,
+          value_blob: raw.value_blob
+        });
+        if (Number(changes) <= 0) {
+          throw new SqliteStorageError(
+            "setraw",
+            `${raw.context}$${raw.key}`,
+            `Something went wrong! Value wasn't changed.`
+          );
+        }
+      }
+    });
+  }
+  delete(contexts, key) {
+    this.#queryDelete.run(buildContextKeyPair(contexts, key));
+  }
+  keys(contexts) {
+    const queryResults = this.#queryKeys.all({
+      context: buildContextPath(contexts)
+    }).filter((v) => v != null);
+    return queryResults.map((v) => v.key);
+  }
+  values(contexts) {
+    const queryResults = this.#queryValues.all({
+      context: buildContextPath(contexts)
+    }).filter((v) => v != null);
+    const record = /* @__PURE__ */ Object.create(null);
+    for (const element of queryResults) {
+      record[element.key] = fromJson(element.value_json);
+    }
+    return record;
+  }
+  /**
+   * Return sub contexts of context
+   * (search nested depth, return 1 depth of them)
+   * @param contexts context path
+   * @returns sub contexts
+   */
+  contexts(contexts) {
+    const parentCtx = buildContextPath(contexts);
+    let subContexts;
+    if (contexts.length === 0) {
+      const allContexts = this.#queryContextSub.all({ contextGlob: "*" }).filter((v) => v != null);
+      subContexts = allContexts.map((v) => {
+        const firstDotIndex = v.context.indexOf(".");
+        if (firstDotIndex < 0) {
+          return v.context;
+        }
+        return v.context.substring(0, firstDotIndex);
+      });
+    } else {
+      const allSubContexts = this.#queryContextSub.all({
+        contextGlob: escapeGlob(parentCtx) + ".*"
+      }).filter((v) => v != null);
+      subContexts = allSubContexts.map((v) => {
+        const subKey = v.context.substring(parentCtx.length + 1);
+        const dotIndex = subKey.indexOf(".");
+        if (dotIndex < 0) {
+          return subKey;
+        }
+        return subKey.substring(0, dotIndex);
+      });
+    }
+    return [...new Set(subContexts.filter((c) => c != null && c.trim().length > 0))];
+  }
+  /**
+   * Should be implement to platform specific class
+   * when `completely = true`
+   *
+   * basic cleanup query for here.
+   */
+  async clear(_completely) {
+    this.#queryClear.run();
+  }
+  clearAll(contexts) {
+    if (contexts.length === 0) {
+      return;
+    }
+    const contextPath = buildContextPath(contexts);
+    this.#queryClearAll.run({
+      context: contextPath,
+      contextGlob: escapeGlob(contextPath) + ".*"
+    });
+  }
+  has(contexts, key) {
+    const result = this.#queryHas.get(buildContextKeyPair(contexts, key));
+    return result?.has_record === 1;
+  }
+  openBlob(contexts, key) {
+    const queryResult = this.#queryOpenBlob.get(buildContextKeyPair(contexts, key));
+    if (queryResult == null) {
+      return new Blob();
+    }
+    if (queryResult.value_type === "blob" && queryResult.value_blob != null) {
+      return new Blob([new Uint8Array(queryResult.value_blob)]);
+    }
+    if (queryResult.value_type === "json" && queryResult.value_json != null) {
+      return new Blob([queryResult.value_json]);
+    }
+    this.delete(contexts, key);
+    return new Blob();
+  }
+  async writeBlobFromStream(contexts, key, stream) {
+    const arrayBuffer = await new Response(stream).arrayBuffer();
+    const bytes = new Uint8Array(arrayBuffer);
+    const queryResult = this.#queryWriteBlob.run({
+      ...buildContextKeyPair(contexts, key),
+      value_blob: bytes
+    });
+    if (Number(queryResult.changes) <= 0) {
+      throw new SqliteStorageError(
+        "writeBlob",
+        buildContextKeyLog(contexts, key),
+        `Something went wrong! Value wasn't changed.`
+      );
+    }
+  }
+}
+export {
+  SqliteStorage
+};
+//# sourceMappingURL=SqliteStorage.js.map

package/dist/esm/storage/sqlite/SqliteStorage.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/storage/sqlite/SqliteStorage.ts"],
+  "mappings": "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",
+  "names": ["value"]
+}

package/dist/esm/storage/sqlite/SqliteStorageError.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { StorageError } from "@matter/general";
+/**
+ * StorageError with
+ *
+ * `methodType`: Method type of Storage
+ * `contextKey`: Context$Key
+ */
+export declare class SqliteStorageError extends StorageError {
+    readonly methodType: string;
+    readonly contextKey: string;
+    readonly mainReason: string;
+    constructor(methodType: string, contextKey: string, mainReason: string);
+}
+//# sourceMappingURL=SqliteStorageError.d.ts.map

package/dist/esm/storage/sqlite/SqliteStorageError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteStorageError.d.ts","sourceRoot":"","sources":["../../../../src/storage/sqlite/SqliteStorageError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;aAE5B,UAAU,EAAE,MAAM;aAClB,UAAU,EAAE,MAAM;aAClB,UAAU,EAAE,MAAM;gBAFlB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM;CAIzC"}

package/dist/esm/storage/sqlite/SqliteStorageError.js

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { StorageError } from "@matter/general";
+class SqliteStorageError extends StorageError {
+  constructor(methodType, contextKey, mainReason) {
+    super(`[${methodType.toUpperCase()}] ${contextKey}: ${mainReason}`);
+    this.methodType = methodType;
+    this.contextKey = contextKey;
+    this.mainReason = mainReason;
+  }
+}
+export {
+  SqliteStorageError
+};
+//# sourceMappingURL=SqliteStorageError.js.map

package/dist/esm/storage/sqlite/SqliteStorageError.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/storage/sqlite/SqliteStorageError.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,oBAAoB;AAQtB,MAAM,2BAA2B,aAAa;AAAA,EACjD,YACoB,YACA,YACA,YAClB;AACE,UAAM,IAAI,WAAW,YAAY,CAAC,KAAK,UAAU,KAAK,UAAU,EAAE;AAJlD;AACA;AACA;AAAA,EAGpB;AACJ;",
+  "names": []
+}

package/dist/esm/storage/sqlite/SqliteTypes.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Stores various utility types used by sqlite disk.
+ */
+export type SafeUint8Array = Uint8Array<ArrayBuffer>;
+export type SqliteDataType = null | number | bigint | string | SafeUint8Array;
+export type SqliteResultType = Record<string, SqliteDataType>;
+/**
+ * DatabaseLike
+ *
+ * compatible with `node:sqlite`(type mismatch), `bun:sqlite`
+ */
+export interface DatabaseLike {
+    prepare<O extends SqliteResultType | void>(query: string): SqlRunnableSimple<O> & SqlRunnableParam<any, O>;
+    exec(sql: string): void;
+    close(): void;
+}
+export type DatabaseCreator = (path: string) => DatabaseLike;
+/**
+ * Defines `I` -> `O` Runnable
+ *
+ * `I` type is treated as Input.
+ *
+ * `O` type is treated as Output.
+ *
+ * `void` type is used for no input/output.
+ */
+export type SqlRunnable<I extends SqliteResultType | void, O extends SqliteResultType | void> = I extends SqliteResultType ? SqlRunnableParam<I, O> : SqlRunnableSimple<O>;
+/**
+ * Database method with no parameter.
+ *
+ * (`I` must be void)
+ */
+interface SqlRunnableSimple<O extends SqliteResultType | void> {
+    run(): {
+        changes: number | bigint;
+    };
+    get(): O | null | undefined;
+    all(): Array<O | undefined>;
+}
+/**
+ * Database method with parameter.
+ */
+interface SqlRunnableParam<I extends SqliteResultType, O extends SqliteResultType | void> {
+    run(arg: I): {
+        changes: number | bigint;
+    };
+    get(arg: I): O | null | undefined;
+    all(arg: I): Array<O | undefined>;
+}
+/**
+ * SQLite Transaction mode
+ *
+ * TODO: Move transaction control to higher level (matter.js Transaction API)
+ * and remove this
+ */
+export declare enum SqliteTransaction {
+    BEGIN = 0,
+    COMMIT = 1,
+    ROLLBACK = 2
+}
+export {};
+//# sourceMappingURL=SqliteTypes.d.ts.map

package/dist/esm/storage/sqlite/SqliteTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteTypes.d.ts","sourceRoot":"","sources":["../../../../src/storage/sqlite/SqliteTypes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AAGH,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB,OAAO,CAAC,CAAC,SAAS,gBAAgB,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC3G,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,CACnB,CAAC,SAAS,gBAAgB,GAAG,IAAI,EACjC,CAAC,SAAS,gBAAgB,GAAG,IAAI,IACjC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAE/E;;;;GAIG;AACH,UAAU,iBAAiB,CAAC,CAAC,SAAS,gBAAgB,GAAG,IAAI;IACzD,GAAG,IAAI;QAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACpC,GAAG,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5B,GAAG,IAAI,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,UAAU,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,SAAS,gBAAgB,GAAG,IAAI;IACpF,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG;QAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC1C,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CACrC;AAED;;;;;GAKG;AACH,oBAAY,iBAAiB;IACzB,KAAK,IAAA;IACL,MAAM,IAAA;IACN,QAAQ,IAAA;CACX"}

package/dist/esm/storage/sqlite/SqliteTypes.js

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var SqliteTransaction = /* @__PURE__ */ ((SqliteTransaction2) => {
+  SqliteTransaction2[SqliteTransaction2["BEGIN"] = 0] = "BEGIN";
+  SqliteTransaction2[SqliteTransaction2["COMMIT"] = 1] = "COMMIT";
+  SqliteTransaction2[SqliteTransaction2["ROLLBACK"] = 2] = "ROLLBACK";
+  return SqliteTransaction2;
+})(SqliteTransaction || {});
+export {
+  SqliteTransaction
+};
+//# sourceMappingURL=SqliteTypes.js.map

package/dist/esm/storage/sqlite/SqliteTypes.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/storage/sqlite/SqliteTypes.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAsEO,IAAK,oBAAL,kBAAKA,uBAAL;AACH,EAAAA,sCAAA;AACA,EAAAA,sCAAA;AACA,EAAAA,sCAAA;AAHQ,SAAAA;AAAA,GAAA;",
+  "names": ["SqliteTransaction"]
+}

package/dist/esm/storage/sqlite/SqliteUtil.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Build string context path from contexts[]
+ * @param contexts Contexts
+ * @returns `.` joined context path
+ */
+export declare function buildContextPath(contexts: string[]): string;
+/**
+ * Build Context & Key pair
+ * @param contexts Contexts
+ * @param key Key
+ */
+export declare function buildContextKeyPair(contexts: string[], key: string): {
+    context: string;
+    key: string;
+};
+/**
+ * Build Context & Key *log* path
+ */
+export declare function buildContextKeyLog(contexts: string[], key: string): string;
+/**
+ * Build key (just verification)
+ */
+export declare function buildKey(key: string): string;
+/**
+ * Escape string for Glob
+ */
+export declare function escapeGlob(value: string): string;
+//# sourceMappingURL=SqliteUtil.d.ts.map

package/dist/esm/storage/sqlite/SqliteUtil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteUtil.d.ts","sourceRoot":"","sources":["../../../../src/storage/sqlite/SqliteUtil.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAWlD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM;;;EAKlE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,UAEjE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,UAKnC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,UAEvC"}

package/dist/esm/storage/sqlite/SqliteUtil.js

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SqliteStorageError } from "./SqliteStorageError.js";
+function buildContextPath(contexts) {
+  for (const ctx of contexts) {
+    if (ctx.trim().length <= 0 || ctx.includes(".")) {
+      throw new SqliteStorageError(
+        "build",
+        `{${contexts.join(",")}}`,
+        "Context must not be an empty and not contain dots."
+      );
+    }
+  }
+  return contexts.join(".");
+}
+function buildContextKeyPair(contexts, key) {
+  return {
+    context: buildContextPath(contexts),
+    key: buildKey(key)
+  };
+}
+function buildContextKeyLog(contexts, key) {
+  return `${buildContextPath(contexts)}$${key}`;
+}
+function buildKey(key) {
+  if (key.trim().length <= 0) {
+    throw new SqliteStorageError("build", key, "Key must not be an empty string.");
+  }
+  return key;
+}
+function escapeGlob(value) {
+  return value.replace(/[*[?]/g, "[$&]");
+}
+export {
+  buildContextKeyLog,
+  buildContextKeyPair,
+  buildContextPath,
+  buildKey,
+  escapeGlob
+};
+//# sourceMappingURL=SqliteUtil.js.map

package/dist/esm/storage/sqlite/SqliteUtil.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/storage/sqlite/SqliteUtil.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,0BAA0B;AAO5B,SAAS,iBAAiB,UAAoB;AACjD,aAAW,OAAO,UAAU;AACxB,QAAI,IAAI,KAAK,EAAE,UAAU,KAAK,IAAI,SAAS,GAAG,GAAG;AAC7C,YAAM,IAAI;AAAA,QACN;AAAA,QACA,IAAI,SAAS,KAAK,GAAG,CAAC;AAAA,QACtB;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AACA,SAAO,SAAS,KAAK,GAAG;AAC5B;AAOO,SAAS,oBAAoB,UAAoB,KAAa;AACjE,SAAO;AAAA,IACH,SAAS,iBAAiB,QAAQ;AAAA,IAClC,KAAK,SAAS,GAAG;AAAA,EACrB;AACJ;AAKO,SAAS,mBAAmB,UAAoB,KAAa;AAChE,SAAO,GAAG,iBAAiB,QAAQ,CAAC,IAAI,GAAG;AAC/C;AAKO,SAAS,SAAS,KAAa;AAClC,MAAI,IAAI,KAAK,EAAE,UAAU,GAAG;AACxB,UAAM,IAAI,mBAAmB,SAAS,KAAK,kCAAkC;AAAA,EACjF;AACA,SAAO;AACX;AAKO,SAAS,WAAW,OAAe;AACtC,SAAO,MAAM,QAAQ,UAAU,MAAM;AACzC;",
+  "names": []
+}