@project-chip/matter.js 0.13.1-alpha.0-20250520-d699cd56d → 0.14.0-alpha.0-20250524-51a7e1721

package/dist/esm/cluster/server/AttributeServer.js

@@ -0,0 +1,636 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Diagnostic, ImplementationError, InternalError, Logger, MatterError, camelize, isDeepEqual } from "#general";
+import { AccessLevel, AttributeModel, ClusterModel, DatatypeModel, FabricIndex, MatterModel } from "#model";
+import { NoAssociatedFabricError, assertSecureSession } from "#protocol";
+import {
+  StatusCode,
+  StatusResponseError,
+  ValidationError
+} from "#types";
+const logger = Logger.get("AttributeServer");
+const FabricIndexName = camelize(FabricIndex.name);
+class FabricScopeError extends MatterError {
+}
+function createAttributeServer(clusterDef, attributeDef, attributeName, initValue, datasource, getter, setter, validator) {
+  const {
+    id,
+    schema,
+    writable,
+    fabricScoped,
+    fixed,
+    omitChanges,
+    timed,
+    default: defaultValue,
+    readAcl,
+    writeAcl
+  } = attributeDef;
+  if (fixed) {
+    return new FixedAttributeServer(
+      id,
+      attributeName,
+      readAcl,
+      writeAcl,
+      schema,
+      writable,
+      false,
+      timed,
+      initValue,
+      defaultValue,
+      datasource,
+      getter
+    );
+  }
+  if (fabricScoped) {
+    return new FabricScopedAttributeServer(
+      id,
+      attributeName,
+      readAcl,
+      writeAcl,
+      schema,
+      writable,
+      !omitChanges,
+      timed,
+      initValue,
+      defaultValue,
+      clusterDef,
+      datasource,
+      getter,
+      setter,
+      validator
+    );
+  }
+  return new AttributeServer(
+    id,
+    attributeName,
+    readAcl,
+    writeAcl,
+    schema,
+    writable,
+    !omitChanges,
+    timed,
+    initValue,
+    defaultValue,
+    datasource,
+    getter,
+    setter,
+    validator
+  );
+}
+class BaseAttributeServer {
+  constructor(id, name, readAcl, writeAcl, schema, isWritable, isSubscribable, requiresTimedInteraction, initValue, defaultValue) {
+    this.id = id;
+    this.name = name;
+    this.schema = schema;
+    this.isWritable = isWritable;
+    this.isSubscribable = isSubscribable;
+    this.requiresTimedInteraction = requiresTimedInteraction;
+    this.#readAcl = readAcl;
+    this.#writeAcl = writeAcl;
+    try {
+      this.validateWithSchema(initValue);
+      this.value = initValue;
+    } catch (error) {
+      logger.warn(
+        `Attribute value to initialize for ${name} has an invalid value ${Diagnostic.json(
+          initValue
+        )}. Restore to default ${Diagnostic.json(defaultValue)}`
+      );
+      if (defaultValue === void 0) {
+        throw new ImplementationError(`Attribute value to initialize for ${name} cannot be undefined.`);
+      }
+      this.validateWithSchema(defaultValue);
+      this.value = defaultValue;
+    }
+    this.defaultValue = this.value;
+  }
+  /**
+   * The value is undefined when getter/setter are used. But we still handle the version number here.
+   */
+  value = void 0;
+  endpoint;
+  defaultValue;
+  #readAcl;
+  #writeAcl;
+  get hasFabricSensitiveData() {
+    return false;
+  }
+  validateWithSchema(value) {
+    try {
+      this.schema.validate(value);
+    } catch (e) {
+      ValidationError.accept(e);
+      e.message = `Validation error for attribute "${this.name}"${e.fieldName !== void 0 ? ` in field ${e.fieldName}` : ""}: ${e.message}`;
+      throw e;
+    }
+  }
+  assignToEndpoint(endpoint) {
+    this.endpoint = endpoint;
+  }
+  get writeAcl() {
+    return this.#writeAcl ?? AccessLevel.Operate;
+  }
+  get readAcl() {
+    return this.#readAcl ?? AccessLevel.View;
+  }
+}
+class FixedAttributeServer extends BaseAttributeServer {
+  constructor(id, name, readAcl, writeAcl, schema, isWritable, isSubscribable, requiresTimedInteraction, initValue, defaultValue, datasource, getter) {
+    super(
+      id,
+      name,
+      readAcl,
+      writeAcl,
+      schema,
+      isWritable,
+      isSubscribable,
+      requiresTimedInteraction,
+      initValue,
+      defaultValue
+    );
+    this.datasource = datasource;
+    if (getter === void 0) {
+      this.getter = () => {
+        if (this.value === void 0) {
+          throw new InternalError(`Attribute value for attribute "${name}" is not initialized.`);
+        }
+        return this.value;
+      };
+    } else {
+      this.getter = getter;
+    }
+  }
+  isFixed = true;
+  getter;
+  /**
+   * Get the value of the attribute. This method is used by the Interaction model to read the value of the attribute
+   * and includes the ACL check. It should not be used locally in the code!
+   *
+   * If a getter is defined the value is determined by that getter method.
+   */
+  get(session, isFabricFiltered, message) {
+    return this.getter(session, this.endpoint, isFabricFiltered, message);
+  }
+  /**
+   * Get the value of the attribute including the version number. This method is used by the Interaction model to read
+   * the value of the attribute and includes the ACL check. It should not be used locally in the code!
+   *
+   * If a getter is defined the value is determined by that getter method. The version number is always 0 for fixed
+   * attributes.
+   */
+  getWithVersion(session, isFabricFiltered, message) {
+    return { version: this.datasource.version, value: this.get(session, isFabricFiltered, message) };
+  }
+  /**
+   * Get the value of the attribute locally. This method should be used locally in the code and does not include the
+   * ACL check.
+   * If a getter is defined the value is determined by that getter method.
+   */
+  getLocal() {
+    return this.getter(void 0, this.endpoint);
+  }
+  /**
+   * Initialize the value of the attribute, used when a persisted value is set initially or when values needs to be
+   * adjusted before the Device gets announced. Do not use this method to change values when the device is in use!
+   * If a getter or setter is defined the value must be undefined The version number must also be undefined.
+   */
+  init(value) {
+    if (value === void 0) {
+      throw new InternalError(`Cannot initialize fixed attribute "${this.name}" with undefined value.`);
+    }
+    this.validateWithSchema(value);
+    this.value = value;
+  }
+  /**
+   * Add an internal listener that is called when the value of the attribute changes. The listener is called with the
+   * new value and the version number.
+   */
+  addValueChangeListener(_listener) {
+  }
+  /**
+   * Remove an internal listener.
+   */
+  removeValueChangeListener(_listener) {
+  }
+  /**
+   * Add an external listener that is called when the value of the attribute changes. The listener is called with the
+   * new value and the old value.
+   */
+  addValueSetListener(_listener) {
+  }
+  /**
+   * Add an external listener that is called when the value of the attribute changes. The listener is called with the
+   * new value and the old value. This method is a convenient alias for addValueSetListener.
+   */
+  subscribe(_listener) {
+  }
+  /**
+   * Remove an external listener.
+   */
+  removeValueSetListener(_listener) {
+  }
+}
+class AttributeServer extends FixedAttributeServer {
+  isFixed = false;
+  valueChangeListeners = new Array();
+  valueSetListeners = new Array();
+  setter;
+  validator;
+  delayedChangeData = void 0;
+  constructor(id, name, readAcl, writeAcl, schema, isWritable, isSubscribable, requiresTimedInteraction, initValue, defaultValue, datasource, getter, setter, validator) {
+    if (isWritable && (getter === void 0 || setter === void 0) && !(getter === void 0 && setter === void 0)) {
+      throw new ImplementationError(
+        `Getter and setter must be implemented together for writeable attribute "${name}".`
+      );
+    }
+    super(
+      id,
+      name,
+      readAcl,
+      writeAcl,
+      schema,
+      isWritable,
+      isSubscribable,
+      requiresTimedInteraction,
+      initValue,
+      defaultValue,
+      datasource,
+      getter
+    );
+    if (setter === void 0) {
+      this.setter = (value) => {
+        const oldValue = this.value;
+        this.value = value;
+        return !isDeepEqual(value, oldValue);
+      };
+    } else {
+      this.setter = setter;
+    }
+    this.validator = (value, session, endpoint) => {
+      this.validateWithSchema(value);
+      if (validator !== void 0) {
+        validator(value, session, endpoint);
+      }
+    };
+  }
+  /**
+   * Initialize the value of the attribute, used when a persisted value is set initially or when values needs to be
+   * adjusted before the Device gets announced. Do not use this method to change values when the device is in use!
+   */
+  init(value) {
+    if (value === void 0) {
+      value = this.getter(void 0, this.endpoint);
+    }
+    if (value === void 0) {
+      throw new InternalError(`Cannot initialize attribute "${this.name}" with undefined value.`);
+    }
+    this.validator(value, void 0, this.endpoint);
+    this.value = value;
+  }
+  /**
+   * Set the value of the attribute. This method is used by the Interaction model to write the value of the attribute
+   * and includes the ACL check. It should not be used locally in the code!
+   *
+   * If a setter is defined this setter method is called to store the value.
+   *
+   * Listeners are called when the value changes (internal listeners) or in any case (external listeners).
+   */
+  set(value, session, message, delayChangeEvents = false) {
+    if (!this.isWritable) {
+      throw new StatusResponseError(`Attribute "${this.name}" is not writable.`, StatusCode.UnsupportedWrite);
+    }
+    this.setRemote(value, session, message, delayChangeEvents);
+  }
+  /**
+   * Method that contains the logic to set a value "from remote" (e.g. from a client).
+   */
+  setRemote(value, session, message, delayChangeEvents = false) {
+    this.processSet(value, session, message, delayChangeEvents);
+    this.value = value;
+  }
+  /**
+   * Set the value of the attribute locally. This method should be used locally in the code and does not include the
+   * ACL check.
+   *
+   * If a setter is defined this setter method is called to validate and store the value.
+   *
+   * Else if a validator is defined the value is validated before it is stored.
+   *
+   * Listeners are called when the value changes (internal listeners) or in any case (external listeners).
+   */
+  setLocal(value) {
+    this.processSet(value, void 0);
+    this.value = value;
+  }
+  /**
+   * Helper Method to process the set of a value in a generic way. This method is used internally.
+   */
+  processSet(value, session, message, delayChangeEvents = false) {
+    this.validator(value, session, this.endpoint);
+    const oldValue = this.getter(session, this.endpoint, void 0, message);
+    const valueChanged = this.setter(value, session, this.endpoint, message);
+    if (delayChangeEvents) {
+      this.delayedChangeData = {
+        oldValue: this.delayedChangeData?.oldValue ?? oldValue,
+        // We keep the oldest value
+        newValue: value,
+        changed: !!this.delayedChangeData?.changed || valueChanged
+        // We combine the changed flag
+      };
+      logger.info(`Delay change for attribute "${this.name}" with value ${Diagnostic.json(value)}`);
+    } else {
+      this.handleVersionAndTriggerListeners(value, oldValue, valueChanged);
+    }
+  }
+  triggerDelayedChangeEvents() {
+    if (this.delayedChangeData !== void 0) {
+      const { oldValue, newValue, changed } = this.delayedChangeData;
+      this.delayedChangeData = void 0;
+      logger.info(`Trigger delayed change for attribute "${this.name}" with value ${Diagnostic.json(newValue)}`);
+      this.handleVersionAndTriggerListeners(newValue, oldValue, changed);
+    }
+  }
+  /**
+   * Helper Method to handle needed version increases and trigger the relevant listeners. This method is used
+   * internally.
+   */
+  handleVersionAndTriggerListeners(value, oldValue, considerVersionChanged) {
+    if (considerVersionChanged) {
+      const version = this.datasource.increaseVersion();
+      this.valueChangeListeners.forEach((listener) => listener(value, version));
+    }
+    if (oldValue !== void 0) {
+      this.valueSetListeners.forEach((listener) => listener(value, oldValue));
+    }
+  }
+  /**
+   * When the value is handled by getter or setter methods and is changed by other processes this method can be used
+   * to notify the attribute server that the value has changed. This will increase the version number and trigger the
+   * listeners.
+   *
+   * ACL checks needs to be performed before calling this method.
+   */
+  updated(session) {
+    const oldValue = this.value ?? this.defaultValue;
+    try {
+      this.value = this.get(session, false);
+    } catch (e) {
+      NoAssociatedFabricError.accept(e);
+      if (this.value === void 0) {
+        this.value = this.defaultValue;
+      }
+    }
+    this.handleVersionAndTriggerListeners(this.value, oldValue, true);
+  }
+  /**
+   * When the value is handled by getter or setter methods and is changed by other processes and no session from the
+   * originating process is known this method can be used to notify the attribute server that the value has changed.
+   * This will increase the version number and trigger the listeners.
+   *
+   * ACL checks needs to be performed before calling this method.
+   */
+  updatedLocal() {
+    const oldValue = this.value ?? this.defaultValue;
+    this.value = this.getLocal();
+    this.handleVersionAndTriggerListeners(this.value, oldValue, true);
+  }
+  /**
+   * Add an internal listener that is called when the value of the attribute changes. The listener is called with the
+   * new value and the version number.
+   */
+  addValueChangeListener(listener) {
+    this.valueChangeListeners.push(listener);
+  }
+  /**
+   * Remove an internal listener.
+   */
+  removeValueChangeListener(listener) {
+    const entryIndex = this.valueChangeListeners.indexOf(listener);
+    if (entryIndex !== -1) {
+      this.valueChangeListeners.splice(entryIndex, 1);
+    }
+  }
+  /**
+   * Add an external listener that is called when the value of the attribute changes. The listener is called with the
+   * new value and the old value.
+   */
+  addValueSetListener(listener) {
+    this.valueSetListeners.push(listener);
+  }
+  /**
+   * Add an external listener that is called when the value of the attribute changes. The listener is called with the
+   * new value and the old value. This method is a convenient alias for addValueSetListener.
+   */
+  subscribe(listener) {
+    this.addValueSetListener(listener);
+  }
+  /**
+   * Remove an external listener.
+   */
+  removeValueSetListener(listener) {
+    const entryIndex = this.valueSetListeners.indexOf(listener);
+    if (entryIndex !== -1) {
+      this.valueSetListeners.splice(entryIndex, 1);
+    }
+  }
+}
+class FabricScopedAttributeServer extends AttributeServer {
+  constructor(id, name, readAcl, writeAcl, schema, isWritable, isSubscribable, requiresTimedInteraction, initValue, defaultValue, cluster, datasource, getter, setter, validator) {
+    if (isWritable && (getter === void 0 || setter === void 0) && !(getter === void 0 && setter === void 0)) {
+      throw new ImplementationError(
+        `Getter and setter must be implemented together for writeable fabric scoped attribute "${name}".`
+      );
+    }
+    if (getter === void 0) {
+      getter = (session, _endpoint, isFabricFiltered) => {
+        if (session === void 0)
+          throw new FabricScopeError(`Session is required for fabric scoped attribute ${name}`);
+        if (isFabricFiltered === true) {
+          assertSecureSession(session);
+          return this.getLocalForFabric(session.associatedFabric);
+        } else {
+          const values = new Array();
+          for (const fabric of datasource.fabrics) {
+            const value = this.getLocalForFabric(fabric);
+            if (!Array.isArray(value)) {
+              throw new FabricScopeError(
+                `Fabric scoped attribute "${name}" can only be read for all fabrics if they are arrays.`
+              );
+            }
+            values.push(...value);
+          }
+          return values;
+        }
+      };
+    }
+    if (setter === void 0) {
+      setter = () => {
+        throw new ImplementationError("Legacy FabricScopedAttributeServer data set is not supported anymore.");
+      };
+    }
+    super(
+      id,
+      name,
+      readAcl,
+      writeAcl,
+      schema,
+      isWritable,
+      isSubscribable,
+      requiresTimedInteraction,
+      initValue,
+      defaultValue,
+      datasource,
+      getter,
+      setter,
+      validator
+    );
+    this.cluster = cluster;
+    this.#determineSensitiveFieldsToRemove();
+  }
+  fabricSensitiveElementsToRemove = new Array();
+  #determineSensitiveFieldsToRemove() {
+    const clusterFromModel = MatterModel.standard.get(ClusterModel, this.cluster.id);
+    if (clusterFromModel === void 0) {
+      logger.debug(`${this.cluster.name}: Cluster for Fabric scoped element not found in Model, ignore`);
+      return;
+    }
+    const attributeFromModel = clusterFromModel.get(AttributeModel, this.id);
+    if (attributeFromModel === void 0) {
+      logger.debug(
+        `${this.cluster.name}.${this.id}: Attribute for Fabric scoped element not found in Model, ignore`
+      );
+      return;
+    }
+    if (!attributeFromModel.fabricScoped) {
+      logger.debug(`${this.cluster.name}.${this.id}: Attribute is not Fabric scoped in model, ignore`);
+      return;
+    }
+    if (attributeFromModel.children.length !== 1) {
+      logger.debug(`${this.cluster.name}.${this.id}: Attribute has not exactly one child, ignore`);
+      return;
+    }
+    const type = attributeFromModel.children[0].type;
+    if (type === void 0) {
+      logger.debug(`${this.cluster.name}.${this.id}: Attribute field has no type, ignore`);
+      return;
+    }
+    const dataType = clusterFromModel.get(DatatypeModel, type);
+    if (dataType === void 0) {
+      logger.debug(`${this.cluster.name}.${this.id}: DataType ${type} not found in model, ignore`);
+      return;
+    }
+    dataType.children.filter((field) => field.fabricSensitive).forEach((field) => this.fabricSensitiveElementsToRemove.push(camelize(field.name)));
+  }
+  get hasFabricSensitiveData() {
+    return this.fabricSensitiveElementsToRemove.length > 0;
+  }
+  /**
+   * Sanitize the value of the attribute by removing fabric sensitive fields that do not belong to the
+   * associated fabric
+   */
+  sanitizeFabricSensitiveFields(value, associatedFabric) {
+    if (this.fabricSensitiveElementsToRemove.length && Array.isArray(value)) {
+      const associatedFabricIndex = associatedFabric?.fabricIndex ?? -1;
+      return value.map((data) => {
+        if (data[FabricIndexName] !== associatedFabricIndex) {
+          const result = { ...data };
+          this.fabricSensitiveElementsToRemove.forEach((fieldName) => delete result[fieldName]);
+          return result;
+        }
+        return data;
+      });
+    }
+    return value;
+  }
+  /**
+   * Initialize the attribute with a value. Because the value is stored on fabric level this method only initializes
+   * the version number.
+   */
+  init(value) {
+    if (value !== void 0) {
+      throw new InternalError(`Cannot initialize fabric scoped attribute "${this.name}" with a value.`);
+    }
+  }
+  /**
+   * Fabric scoped enhancement of set to allow setting special fabricindex locally.
+   */
+  set(value, session, message, delayChangeEvents = false, preserveFabricIndex = false) {
+    if (!this.isWritable) {
+      throw new StatusResponseError(`Attribute "${this.name}" is not writable.`, StatusCode.UnsupportedWrite);
+    }
+    this.setRemote(value, session, message, delayChangeEvents, preserveFabricIndex);
+  }
+  /**
+   * Method that contains the logic to set a value "from remote" (e.g. from a client). For Fabric scoped attributes
+   * we need to inject the fabric index into the value.
+   */
+  setRemote(value, session, message, delayChangeEvents = false, preserveFabricIndex = false) {
+    value = this.schema.injectField(
+      value,
+      FabricIndex.id,
+      session.associatedFabric.fabricIndex,
+      () => !preserveFabricIndex
+      // No one should send any index and if we simply SHALL ignore it,  but internally we might need it
+    );
+    logger.info(
+      `Set remote value for fabric scoped attribute "${this.name}" to ${Diagnostic.json(value)} (delayed=${delayChangeEvents})`
+    );
+    super.setRemote(value, session, message, delayChangeEvents);
+  }
+  /**
+   * Set Local is not allowed for fabric scoped attributes. Use setLocalForFabric instead.
+   */
+  setLocal(_value) {
+    throw new FabricScopeError(
+      `Fabric scoped attribute "${this.name}" can only be set locally by providing a Fabric. Use setLocalForFabric instead.`
+    );
+  }
+  /**
+   * Set the value of the attribute locally for a fabric. This method should be used locally in the code and does not
+   * include the ACL check.
+   * If a setter is defined this method cannot be used!
+   * If a validator is defined the value is validated before it is stored.
+   * Listeners are called when the value changes (internal listeners) or in any case (external listeners).
+   */
+  setLocalForFabric(_value, _fabric) {
+    throw new ImplementationError("Legacy FabricScopedAttributeServer data write is not supported anymore.");
+  }
+  /**
+   * When the value is handled by getter or setter methods and is changed by other processes and no session from the
+   * originating process is known this method can be used to notify the attribute server that the value has changed.
+   * This will increase the version number and trigger the listeners.
+   * ACL checks needs to be performed before calling this method.
+   */
+  updatedLocalForFabric(fabric) {
+    const oldValue = this.value ?? this.defaultValue;
+    try {
+      this.value = this.getLocalForFabric(fabric);
+    } catch (e) {
+      FabricScopeError.accept(e);
+      if (this.value === void 0) {
+        this.value = this.defaultValue;
+      }
+    }
+    this.handleVersionAndTriggerListeners(this.value, oldValue, true);
+  }
+  /**
+   * Get the value of the attribute locally for a special Fabric. This method should be used locally in the code and
+   * does not include the ACL check.
+   * If a getter is defined this method returns an error and the value should be retrieved directly internally.
+   */
+  getLocalForFabric(_fabric) {
+    throw new ImplementationError("Legacy FabricScopedAttributeServer data read is not supported anymore.");
+  }
+}
+export {
+  AttributeServer,
+  BaseAttributeServer,
+  FabricScopeError,
+  FabricScopedAttributeServer,
+  FixedAttributeServer,
+  createAttributeServer
+};
+//# sourceMappingURL=AttributeServer.js.map

package/dist/esm/cluster/server/AttributeServer.js.map

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

package/dist/esm/cluster/server/ClusterDatasource.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SupportedStorageTypes } from "#general";
+import { Fabric, OccurrenceManager } from "#protocol";
+export interface ClusterDatasource {
+    readonly version: number;
+    readonly eventHandler?: OccurrenceManager;
+    readonly fabrics: Fabric[];
+    increaseVersion(): number;
+    changed(key: string, value: SupportedStorageTypes): void;
+}
+//# sourceMappingURL=ClusterDatasource.d.ts.map

package/dist/esm/cluster/server/ClusterDatasource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterDatasource.d.ts","sourceRoot":"","sources":["../../../../src/cluster/server/ClusterDatasource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,IAAI,MAAM,CAAC;IAC1B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC5D"}

package/dist/esm/cluster/server/ClusterDatasource.js

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=ClusterDatasource.js.map

package/dist/esm/cluster/server/ClusterDatasource.js.map

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