@matter/nodejs 0.16.6-alpha.0-20260121-06f1d9611 → 0.16.6-alpha.0-20260122-b5154bcb4

package/dist/cjs/storage/sqlite/SqliteStorage.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type Bytes, type CloneableStorage, type SupportedStorageTypes, Storage } from "@matter/general";
+import type { DatabaseCreator, DatabaseLike, SafeUint8Array } from "./SqliteTypes.js";
+import { SqliteTransaction as Transaction } from "./SqliteTypes.js";
+/**
+ * Type of Key-Value store table
+ *
+ * T means JSON or BLOB type
+ */
+type KVStoreType<T extends string | SafeUint8Array = string | SafeUint8Array> = {
+    context: string;
+    key: string;
+    value_type: T extends string ? "json" : "blob";
+    value_json: T extends string ? string : null;
+    value_blob: T extends SafeUint8Array ? SafeUint8Array : null;
+};
+/**
+ * SQLite implementation of `StorageBackendDisk.ts`
+ *
+ * `DatabaseCreator` is need to use (sqlite).
+ *
+ * Supports `node:sqlite`, `bun:sqlite`. (maybe also `better-sqlite3` support)
+ */
+export declare class SqliteStorage extends Storage implements CloneableStorage {
+    #private;
+    static readonly memoryPath = ":memory:";
+    static readonly defaultTableName = "kvstore";
+    protected isInitialized: boolean;
+    protected readonly database: DatabaseLike;
+    protected readonly dbPath: string;
+    protected readonly tableName: string;
+    protected readonly clearOnInit: boolean;
+    protected readonly databaseCreator: DatabaseCreator;
+    /**
+     * 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: {
+        databaseCreator: DatabaseCreator;
+        path: string | null;
+        tableName?: string;
+        clear?: boolean;
+    });
+    /**
+     * 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: Transaction): void;
+    protected withAnyTransaction<T>(callback: () => T): T;
+    get initialized(): boolean;
+    initialize(): Promise<void>;
+    clone(): Storage;
+    close(): void;
+    get<T extends SupportedStorageTypes>(contexts: string[], key: string): T | null | undefined;
+    protected getRawAll(): KVStoreType<string | SafeUint8Array>[];
+    set(contexts: string[], key: string, value: SupportedStorageTypes): void;
+    set(contexts: string[], values: Record<string, SupportedStorageTypes>): void;
+    /**
+     * Set [contexts, key] to value
+     * @param contexts Context
+     * @param key Key
+     * @param value Value
+     * @returns
+     */
+    protected setValue(contexts: string[], key: string, value: string): void;
+    /**
+     * Set Raw data. (for copy)
+     */
+    protected setRaw(rawData: KVStoreType[]): void;
+    delete(contexts: string[], key: string): void;
+    keys(contexts: string[]): string[];
+    values(contexts: string[]): Record<string, SupportedStorageTypes>;
+    /**
+     * Return sub contexts of context
+     * (search nested depth, return 1 depth of them)
+     * @param contexts context path
+     * @returns sub contexts
+     */
+    contexts(contexts: string[]): string[];
+    /**
+     * Should be implement to platform specific class
+     * when `completely = true`
+     *
+     * basic cleanup query for here.
+     */
+    clear(_completely?: boolean): Promise<void>;
+    clearAll(contexts: string[]): void;
+    has(contexts: string[], key: string): boolean;
+    openBlob(contexts: string[], key: string): Blob;
+    writeBlobFromStream(contexts: string[], key: string, stream: ReadableStream<Bytes>): Promise<void>;
+}
+export {};
+//# sourceMappingURL=SqliteStorage.d.ts.map

package/dist/cjs/storage/sqlite/SqliteStorage.d.ts.map

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

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

@@ -0,0 +1,439 @@
+"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 SqliteStorage_exports = {};
+__export(SqliteStorage_exports, {
+  SqliteStorage: () => SqliteStorage
+});
+module.exports = __toCommonJS(SqliteStorage_exports);
+var import_general = require("@matter/general");
+var import_SqliteStorageError = require("./SqliteStorageError.js");
+var import_SqliteTypes = require("./SqliteTypes.js");
+var import_SqliteUtil = require("./SqliteUtil.js");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class SqliteStorage extends import_general.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 import_SqliteTypes.SqliteTransaction.BEGIN:
+        if (this.#inTransaction) {
+          throw new import_SqliteStorageError.SqliteStorageError("transaction", "BEGIN", "Transaction is in progress.");
+        }
+        this.database.exec("BEGIN IMMEDIATE TRANSACTION");
+        this.#inTransaction = true;
+        break;
+      case import_SqliteTypes.SqliteTransaction.COMMIT:
+        if (!this.#inTransaction) {
+          throw new import_SqliteStorageError.SqliteStorageError("transaction", "COMMIT", "No transaction in progress.");
+        }
+        this.database.exec("COMMIT");
+        this.#inTransaction = false;
+        break;
+      case import_SqliteTypes.SqliteTransaction.ROLLBACK:
+        if (!this.#inTransaction) {
+          return;
+        }
+        this.database.exec("ROLLBACK");
+        this.#inTransaction = false;
+        break;
+    }
+  }
+  withAnyTransaction(callback) {
+    if (this.#inTransaction) {
+      return callback();
+    }
+    this.transaction(import_SqliteTypes.SqliteTransaction.BEGIN);
+    try {
+      const result = callback();
+      this.transaction(import_SqliteTypes.SqliteTransaction.COMMIT);
+      return result;
+    } catch (err) {
+      this.transaction(import_SqliteTypes.SqliteTransaction.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((0, import_SqliteUtil.buildContextKeyPair)(contexts, key));
+    if (queryResult == null) {
+      return void 0;
+    }
+    if (queryResult.value_json === null) {
+      this.delete(contexts, key);
+      throw new import_SqliteStorageError.SqliteStorageError(
+        "get",
+        (0, import_SqliteUtil.buildContextKeyLog)(contexts, key),
+        "path has null json-value! (expected non-null value)"
+      );
+    }
+    return (0, import_general.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 import_SqliteStorageError.SqliteStorageError(
+          "set",
+          (0, import_SqliteUtil.buildContextKeyLog)(contexts, keyOrValues),
+          "Use null instead of undefined if you want to store null value!"
+        );
+      }
+      this.setValue(contexts, keyOrValues, (0, import_general.toJson)(value));
+    } else {
+      this.withAnyTransaction(() => {
+        for (const [key, value2] of Object.entries(keyOrValues)) {
+          this.setValue(contexts, key, (0, import_general.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({
+      ...(0, import_SqliteUtil.buildContextKeyPair)(contexts, key),
+      value_json: value
+    });
+    if (Number(changes) <= 0) {
+      throw new import_SqliteStorageError.SqliteStorageError(
+        "set",
+        (0, import_SqliteUtil.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 import_SqliteStorageError.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 import_SqliteStorageError.SqliteStorageError(
+            "setraw",
+            `${raw.context}$${raw.key}`,
+            `Something went wrong! Value wasn't changed.`
+          );
+        }
+      }
+    });
+  }
+  delete(contexts, key) {
+    this.#queryDelete.run((0, import_SqliteUtil.buildContextKeyPair)(contexts, key));
+  }
+  keys(contexts) {
+    const queryResults = this.#queryKeys.all({
+      context: (0, import_SqliteUtil.buildContextPath)(contexts)
+    }).filter((v) => v != null);
+    return queryResults.map((v) => v.key);
+  }
+  values(contexts) {
+    const queryResults = this.#queryValues.all({
+      context: (0, import_SqliteUtil.buildContextPath)(contexts)
+    }).filter((v) => v != null);
+    const record = /* @__PURE__ */ Object.create(null);
+    for (const element of queryResults) {
+      record[element.key] = (0, import_general.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 = (0, import_SqliteUtil.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: (0, import_SqliteUtil.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 = (0, import_SqliteUtil.buildContextPath)(contexts);
+    this.#queryClearAll.run({
+      context: contextPath,
+      contextGlob: (0, import_SqliteUtil.escapeGlob)(contextPath) + ".*"
+    });
+  }
+  has(contexts, key) {
+    const result = this.#queryHas.get((0, import_SqliteUtil.buildContextKeyPair)(contexts, key));
+    return result?.has_record === 1;
+  }
+  openBlob(contexts, key) {
+    const queryResult = this.#queryOpenBlob.get((0, import_SqliteUtil.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({
+      ...(0, import_SqliteUtil.buildContextKeyPair)(contexts, key),
+      value_blob: bytes
+    });
+    if (Number(queryResult.changes) <= 0) {
+      throw new import_SqliteStorageError.SqliteStorageError(
+        "writeBlob",
+        (0, import_SqliteUtil.buildContextKeyLog)(contexts, key),
+        `Something went wrong! Value wasn't changed.`
+      );
+    }
+  }
+}
+//# sourceMappingURL=SqliteStorage.js.map

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

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

package/dist/cjs/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/cjs/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/cjs/storage/sqlite/SqliteStorageError.js

@@ -0,0 +1,38 @@
+"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 SqliteStorageError_exports = {};
+__export(SqliteStorageError_exports, {
+  SqliteStorageError: () => SqliteStorageError
+});
+module.exports = __toCommonJS(SqliteStorageError_exports);
+var import_general = require("@matter/general");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class SqliteStorageError extends import_general.StorageError {
+  constructor(methodType, contextKey, mainReason) {
+    super(`[${methodType.toUpperCase()}] ${contextKey}: ${mainReason}`);
+    this.methodType = methodType;
+    this.contextKey = contextKey;
+    this.mainReason = mainReason;
+  }
+}
+//# sourceMappingURL=SqliteStorageError.js.map

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

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