@homebridge-plugins/homebridge-august 3.2.3 → 3.3.0-beta.0

package/.github/npm-version-script-esm.js

@@ -0,0 +1,97 @@
+#!/bin/env node
+
+/**
+ * This scripts queries the npm registry to pull out the latest version for a given tag.
+ */
+
+import assert from 'node:assert'
+import child_process from 'node:child_process'
+import fs from 'node:fs'
+import process from 'node:process'
+
+const BRANCH_VERSION_PATTERN = /^([A-Z]+)-(\d+\.\d+\.\d+)$/i
+
+// Load the contents of the package.json file
+const packageJSON = JSON.parse(fs.readFileSync('package.json', 'utf8'))
+
+const refArgument = process.argv[2]
+const tagArgument = process.argv[3] || 'latest'
+
+if (!refArgument) {
+  console.error('ref argument is missing')
+  console.error('Usage: npm-version-script-esm.js <ref> [tag]')
+  process.exit(1)
+}
+
+/**
+ * Queries the NPM registry for the latest version for the provided base version and tag.
+ * If the tag is latest, then the base version is returned if it exists. For other tags, the latest
+ * version found for that base version and tag is returned.
+ * @param baseVersion The base version to query for, e.g. 2.0.0
+ * @param tag The tag to query for, e.g. beta or latest
+ * @returns {string} Returns the version, or '' if not found
+ */
+function getTagVersionFromNpm(baseVersion, tag) {
+  try {
+    return JSON.parse(child_process.execSync(`npm info ${packageJSON.name} versions --json`).toString('utf8').trim())
+      .filter(v => tag === 'latest' ? v === baseVersion : v.startsWith(`${baseVersion}-${tag}.`)) // find all published versions for this base version and tag
+      .reduce((_, current) => current, '') // choose the last as they're sorted in ascending order, or '' if there are none
+  } catch (e) {
+    console.error(`Failed to query the npm registry for the latest version for tag: ${tag}`, e)
+    // throw e;
+    return ''
+  }
+}
+
+function desiredTargetVersion(ref) {
+  // ref is a GitHub action ref string
+  if (ref.startsWith('refs/pull/')) {
+    throw new Error('The version script was executed inside a PR!')
+  }
+
+  assert(ref.startsWith('refs/heads/'))
+  const branchName = ref.slice('refs/heads/'.length)
+
+  const results = branchName.match(BRANCH_VERSION_PATTERN)
+  if (results !== null) {
+    if (results[1] !== tagArgument) {
+      console.warn(`The base branch name (${results[1]}) differs from the tag name ${tagArgument}`)
+    }
+
+    return results[2]
+  }
+
+  throw new Error(`Malformed branch name for ref: ${ref}. Can't derive the base version. Use a branch name like: beta-x.x.x or alpha-x.x.x`)
+}
+
+// derive the base version from the branch ref
+const baseVersion = desiredTargetVersion(refArgument)
+
+// query the npm registry for the latest version of the provided tag name
+const latestReleasedVersion = getTagVersionFromNpm(baseVersion, tagArgument) // e.g. 0.7.0-beta.12
+
+let publishTag
+
+if (latestReleasedVersion) {
+  console.warn(`Latest published version for ${baseVersion} with tag ${tagArgument} is ${latestReleasedVersion}`)
+  publishTag = latestReleasedVersion // set this released beta or alpha to be incremented
+} else {
+  console.warn(`No published versions for ${baseVersion} with tag ${tagArgument}`)
+  publishTag = baseVersion // start off with a new beta or alpha version
+}
+
+if (packageJSON.version !== publishTag) {
+  // report the change for CI
+  console.warn(`Changing version in package.json from ${packageJSON.version} to ${publishTag}`)
+
+  // save the package.json
+  packageJSON.version = publishTag
+  fs.writeFileSync('package.json', JSON.stringify(packageJSON, null, 2))
+
+  // perform the same change to the package-lock.json
+  const packageLockJSON = JSON.parse(fs.readFileSync('package-lock.json', 'utf8'))
+  packageLockJSON.version = publishTag
+  fs.writeFileSync('package-lock.json', JSON.stringify(packageLockJSON, null, 2))
+} else {
+  console.warn(`Leaving version in package.json at ${packageJSON.version}`)
+}

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+## [3.3.0](https://github.com/homebridge-plugins/homebridge-august/releases/tag/v3.3.0) (2026-05-09)
+
+
+### Features
+
+- Major refactor: Introduced a new shared Base Platform architecture for HAP (HomeKit) and Matter platforms, improving reliability and maintainability.
+- Improved lock/device management and connectivity handling for both HAP and Matter modes.
+
+### Other Changes
+
+- Internal codebase cleanup and test reorganization.
+- Removed legacy scripts and reduced code duplication.
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-august/compare/v3.2.3...v3.3.0
+
 ## [3.2.3](https://github.com/homebridge-plugins/homebridge-august/releases/tag/v3.2.3) (2026-05-04)
 
 ### Bug Fixes

package/dist/Platform.Base.d.ts

@@ -0,0 +1,288 @@
+import type { API, DynamicPlatformPlugin, Logging, PlatformAccessory } from 'homebridge';
+import type { AugustPlatformConfig, credentials, device, devicesConfig, options } from './settings.js';
+import { PluginLogger } from '@homebridge/plugin-logger';
+import August from 'august-yale';
+import { ConnectivityManager } from './connectivity-manager.js';
+/**
+ * Base platform class for August/Yale Homebridge plugin.
+ * Contains all shared logic for config, credentials, device discovery, polling, etc.
+ * Protocol-specific logic (HAP/Matter) should be implemented in subclasses.
+ */
+export declare class AugustPlatformBase implements DynamicPlatformPlugin {
+    /**
+     * Subscribes to PubNub push updates for a given lockId.
+     * Stores unsubscribe/teardown functions in the lockMechanisms map for unified cleanup.
+     * Calls the provided event handler on push events.
+     *
+     * @param {string} lockId - The lock ID to subscribe to.
+     * @param {(event: any, timestamp: Date) => Promise<void>} onEvent - Handler for push events.
+     * @param {(status: any) => void} [onStatus] - Optional handler for PubNub status events.
+     * @returns {Promise<void>}
+     */
+    subscribePubNub(lockId: string, onEvent: (event: any, timestamp: Date) => Promise<void>, onStatus?: (status: any) => void): Promise<void>;
+    /**
+     * Tears down the PubNub subscription for a given lockId (if present).
+     * Safe to call multiple times.
+     * @param {string} lockId
+     */
+    tearDownPubNubSubscription(lockId: string): void;
+    accessories: PlatformAccessory[];
+    readonly api: API;
+    readonly log: Logging;
+    config: AugustPlatformConfig;
+    platformConfig: AugustPlatformConfig;
+    platformLogging: options['logging'];
+    platformRefreshRate: options['refreshRate'];
+    platformPushRate: options['pushRate'];
+    platformUpdateRate: options['updateRate'];
+    registeringDevice: boolean;
+    debugMode: boolean;
+    version: string;
+    augustConfig?: August;
+    connectivity?: ConnectivityManager;
+    protected readonly lockMechanisms: Map<string, any>;
+    protected pollTimer?: NodeJS.Timeout;
+    protected normalizedCredentialsCache?: credentials;
+    logger: PluginLogger;
+    constructor(log: Logging, config: AugustPlatformConfig, api: API);
+    Lock(device: any): Promise<void>;
+    /**
+     * Tears down resources for a lock mechanism, including PubNub subscriptions and polling if present.
+     *
+     * Removes the lock mechanism from the internal map and calls tearDownPubNubSubscription if implemented.
+     * Used by both HAP and Matter platforms. Lock mechanisms must implement tearDownPubNubSubscription for proper cleanup.
+     *
+     * @param {string} lockId - The lock ID whose mechanism should be torn down.
+     * @returns {void}
+     */
+    protected tearDownLockMechanism(lockId: string): void;
+    /**
+     * Handles restoration of cached accessories from disk during Homebridge startup.
+     *
+     * Called by Homebridge for each accessory previously registered and persisted in the cache.
+     * Adds the accessory to the platform's accessories array for tracking and future management.
+     * Subclasses should override this method to set up event handlers and update characteristic values as needed.
+     *
+     * @param {PlatformAccessory} accessory - The accessory instance restored from cache.
+     * @returns {Promise<void>} Resolves when the accessory is processed and added to the cache.
+     */
+    configureAccessory(accessory: PlatformAccessory): Promise<void>;
+    /**
+     * Verifies that the plugin configuration contains all required credentials.
+     *
+     * Checks for the presence of credentials, August ID, and password. Throws descriptive errors
+     * if any required field is missing. Should be called during initialization to ensure the platform
+     * is properly configured before proceeding with authentication or device discovery.
+     *
+     * @returns {Promise<void>} Resolves if the configuration is valid.
+     * @throws {Error} If credentials, August ID, or password are missing.
+     */
+    verifyConfig(): Promise<void>;
+    /**
+     * Validates the August credentials and manages the Homebridge config state for authentication.
+     *
+     * - If the session is not validated and a validateCode is present, attempts to validate with the code,
+     *   updates the config, and clears the validateCode on success.
+     * - If already validated or no validateCode is present, ensures installId is set and prompts the user
+     *   to enter the verification code if needed.
+     * - Always updates the config file and clears the normalized credentials cache after changes.
+     * - Handles device discovery after successful validation.
+     *
+     * @returns {Promise<void>} Resolves when validation and config updates are complete.
+     * @throws {Error} If credentials are missing or validation fails unexpectedly.
+     */
+    validated(): Promise<void>;
+    /**
+     * Initializes and manages the August API credentials and connectivity manager.
+     *
+     * Ensures credentials are present, initializes the ConnectivityManager if needed,
+     * and keeps the public augustConfig field in sync with the manager's internal client.
+     * If already initialized, skips re-initialization. Handles automatic client rebuilds
+     * on authentication failures and network recovery.
+     *
+     * @returns {Promise<void>} Resolves when credentials and connectivity are initialized.
+     * @throws {Error} If credentials are missing.
+     */
+    augustCredentials(): Promise<void>;
+    /**
+     * Normalizes credentials for August API compatibility, handling country code variations.
+     *
+     * Maps regional country codes (e.g., CA, MX) to supported API endpoints (US) unless normalization is disabled in config.
+     * Logs normalization actions for debugging and API compatibility.
+     *
+     * @param {credentials} credentials - The credentials object to normalize.
+     * @returns {Promise<credentials>} Resolves with the normalized credentials object.
+     * @throws {Error} If credentials are null or undefined.
+     */
+    private normalizeCredentialsForApi;
+    /**
+     * Clears the cached normalized credentials.
+     *
+     * Should be called whenever credentials are updated or invalidated to ensure
+     * that subsequent API calls use fresh, normalized credentials.
+     * Logs the cache clear operation for debugging.
+     *
+     * @returns {void}
+     */
+    clearNormalizedCredentialsCache(): void;
+    /**
+     * Returns normalized credentials for use by device classes, with caching to avoid redundant normalization.
+     *
+     * If the credentials have not changed since the last call, returns the cached normalized credentials.
+     * Otherwise, normalizes the credentials, caches them, and returns the new value.
+     *
+     * @returns {Promise<credentials>} Resolves with the normalized credentials object for API use.
+     * @throws {Error} If credentials are missing or invalid.
+     */
+    getNormalizedCredentials(): Promise<credentials>;
+    /**
+     * Starts the platform-level polling cycle for device state updates.
+     *
+     * Iterates registered locks serially (not in parallel) and short-circuits on the first failure.
+     *
+     * **Why serial:**
+     *   - One outstanding request at a time on a healthy network is cheap enough (most cycles complete in <1s for a handful of locks) and avoids racing the August API.
+     *   - On a failing network, a parallel cycle would produce N timeouts ~simultaneously, which is exactly the log-spam pattern the ConnectivityManager exists to prevent. Serial means one timeout, classified once, and the rest of the cycle aborts.
+     *
+     * **Why short-circuit on first failure:**
+     *   - If the first call fails with a network error, the manager has already entered 'degraded' state and scheduled a probe. The remaining N-1 calls would all hit the same dead network and produce identical errors. Aborting the cycle is the correct thing to do.
+     *
+     * **Why skip when offline:**
+     *   - The manager's state machine is already managing recovery via scheduled probes. Polling on top of that just wastes API calls and risks rate limiting.
+     *
+     * Idempotent: If discovery re-runs (e.g. after re-auth), does not stack timers.
+     *
+     * @returns {void}
+     */
+    startPolling(): void;
+    /**
+     * Stops the platform polling cycle for device state updates.
+     *
+     * Clears the polling timer if active, halting periodic device refreshes.
+     * Typically called during plugin shutdown or when polling is no longer needed.
+     *
+     * @returns {void}
+     */
+    stopPolling(): void;
+    /**
+     * Loads and returns the plugin's configuration and the full Homebridge config from disk.
+     *
+     * Reads the Homebridge config file, finds this plugin's config section, and ensures credentials is an object.
+     * Throws if the platforms array or plugin config is missing.
+     *
+     * @returns {Promise<{ pluginConfig: any, currentConfig: any }>} Resolves with the plugin's config and the full config object.
+     * @throws {TypeError|Error} If the platforms array or plugin config is missing.
+     */
+    pluginConfig(): Promise<{
+        pluginConfig: any;
+        currentConfig: any;
+    }>;
+    /**
+     * Discovers and registers August/Yale lock devices for the platform.
+     *
+     * Fetches device details from the August API using normalized credentials, applies config-based filtering,
+     * unregisters excluded accessories, merges config overrides, and registers each device via the Lock method.
+     * Handles authentication errors and triggers re-authentication if needed.
+     *
+     * @returns {Promise<void>} Resolves when all devices have been discovered and registered.
+     * @throws {Error} If device discovery or authentication fails.
+     */
+    discoverDevices(): Promise<void>;
+    /**
+     * --- Additional shared methods for config, logging, etc. ---
+     */
+    /**
+     * Determines if a device should be registered based on its visibility and HomeKit enablement.
+     *
+     * This is a generic version; subclasses may override for protocol-specific logic.
+     * Sets the registeringDevice flag and logs the registration decision.
+     *
+     * @param {any} device - The device object to evaluate for registration.
+     * @returns {Promise<boolean>} Resolves to true if the device should be registered, false otherwise.
+     */
+    protected registerDevice(device: any): Promise<boolean>;
+    /**
+     * Unregisters a platform accessory from Homebridge and removes it from the cache.
+     *
+     * Calls the Homebridge API to unregister the accessory, tears down the lock mechanism,
+     * removes the accessory from the internal cache, and logs the removal.
+     *
+     * @param {PlatformAccessory} existingAccessory - The accessory to unregister.
+     * @param {any} device - The device object (used for lockId and logging).
+     * @returns {Promise<void>} Resolves when the accessory has been unregistered and removed from cache.
+     */
+    protected unregisterPlatformAccessories(existingAccessory: PlatformAccessory, device: any): Promise<void>;
+    /**
+     * Publishes an accessory as either an external accessory or a platform accessory based on device config.
+     *
+     * If the device config has `external` set, publishes the accessory as an external accessory and logs the mode.
+     * Otherwise, registers it as a platform accessory and logs the mode.
+     *
+     * @param {device & devicesConfig} device - The device configuration object.
+     * @param {PlatformAccessory} accessory - The accessory to publish or register.
+     * @returns {Promise<void>} Resolves when the accessory has been published or registered.
+     */
+    externalOrPlatform(device: device & devicesConfig, accessory: PlatformAccessory): Promise<void>;
+    /**
+     * Publishes an accessory as an external accessory to Homebridge.
+     *
+     * Calls the Homebridge API to publish the provided accessory as an external accessory.
+     * This is used for accessories that should be exposed independently from the main bridge.
+     *
+     * @param {PlatformAccessory} accessory - The accessory to publish externally.
+     * @returns {Promise<void>} Resolves when the accessory has been published.
+     */
+    externalAccessory(accessory: PlatformAccessory): Promise<void>;
+    /**
+     * Asynchronously determines and logs the platform logging mode based on config options and debug flags.
+     *
+     * Sets the platformLogging property to 'debug', 'standard', 'none', or 'debugMode' depending on config and CLI flags.
+     * Logs the selected logging mode for debugging purposes.
+     *
+     * @returns {Promise<void>} Resolves when the logging mode has been determined, set, and logged.
+     */
+    protected getPlatformLogSettings(): Promise<void>;
+    /**
+     * Asynchronously loads and logs platform polling, update, and push rate settings from the config options.
+     *
+     * Reads refreshRate, updateRate, and pushRate from the config options, assigns them to instance properties,
+     * and logs the values for debugging purposes.
+     *
+     * @returns {Promise<void>} Resolves when the rates have been loaded, assigned, and logged.
+     */
+    protected getPlatformRateSettings(): Promise<void>;
+    /**
+     * Asynchronously loads and logs platform configuration settings from the config options.
+     *
+     * Reads logging, refreshRate, updateRate, and pushRate from the config options,
+     * builds a platformConfig object, logs it if present, and assigns it to this.platformConfig.
+     *
+     * @returns {Promise<void>} Resolves when the config has been loaded, logged, and assigned.
+     */
+    protected getPlatformConfigSettings(): Promise<void>;
+    /**
+     * Asynchronously retrieves and logs the plugin version from package.json.
+     *
+     * Reads the version from the package.json file, logs it using logger.debug, and
+     * assigns it to the `version` property of the class instance.
+     *
+     * @returns {Promise<void>} Resolves when the version has been read, logged, and assigned.
+     */
+    protected getVersion(): Promise<void>;
+    /**
+     * Asynchronously validates and cleans a display name or characteristic value for HomeKit compatibility.
+     *
+     * If invalid characters are not allowed (default), this method:
+     *   - Ensures the value contains only alphanumeric, space, and apostrophe characters.
+     *   - Removes any invalid characters and trims invalid start/end characters.
+     *   - Logs warnings and before/after values if modifications are made.
+     * If invalid characters are allowed by config, the value is returned unchanged.
+     *
+     * @param {string} displayName - The accessory's display name (for logging context).
+     * @param {string} name - The characteristic name (for logging context).
+     * @param {string} value - The value to validate and clean.
+     * @returns {Promise<string>} The cleaned (or original) value, suitable for HomeKit.
+     */
+    protected validateAndCleanDisplayName(displayName: string, name: string, value: string): Promise<string>;
+}
+//# sourceMappingURL=Platform.Base.d.ts.map

package/dist/Platform.Base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Platform.Base.d.ts","sourceRoot":"","sources":["../src/Platform.Base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,qBAAqB,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAExF,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAKtG,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,MAAM,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAG/D;;;;GAIG;AAEH,qBAAa,kBAAmB,YAAW,qBAAqB;IAC9D;;;;;;;;;OASG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,EACvD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,GAC/B,OAAO,CAAC,IAAI,CAAC;IAoDhB;;;;OAIG;IACH,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOzC,WAAW,EAAE,iBAAiB,EAAE,CAAA;IACvC,SAAgB,GAAG,EAAE,GAAG,CAAA;IACxB,SAAgB,GAAG,EAAE,OAAO,CAAA;IACrB,MAAM,EAAG,oBAAoB,CAAA;IAEpC,cAAc,EAAG,oBAAoB,CAAA;IACrC,eAAe,EAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IACpC,mBAAmB,EAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IAC5C,gBAAgB,EAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACtC,kBAAkB,EAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAC1C,iBAAiB,EAAG,OAAO,CAAA;IAC3B,SAAS,EAAG,OAAO,CAAA;IACnB,OAAO,EAAG,MAAM,CAAA;IAEhB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAClC,SAAS,CAAC,QAAQ,CAAC,cAAc,mBAAyB;IAC1D,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,OAAO,CAAA;IACpC,SAAS,CAAC,0BAA0B,CAAC,EAAE,WAAW,CAAA;IAC3C,MAAM,EAAG,YAAY,CAAA;gBAG1B,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,oBAAoB,EAC5B,GAAG,EAAE,GAAG;IAoCG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7C;;;;;;;;OAQG;IACH,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUrD;;;;;;;;;OASG;IACG,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrE;;;;;;;;;OASG;IACG,YAAY;IAalB;;;;;;;;;;;;OAYG;IACG,SAAS;IAwDf;;;;;;;;;;OAUG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBxC;;;;;;;;;OASG;YACW,0BAA0B;IAiCxC;;;;;;;;OAQG;IACH,+BAA+B,IAAI,IAAI;IAKvC;;;;;;;;OAQG;IACG,wBAAwB,IAAI,OAAO,CAAC,WAAW,CAAC;IA0BtD;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,IAAI,IAAI;IAuDpB;;;;;;;OAOG;IACH,WAAW,IAAI,IAAI;IAOnB;;;;;;;;OAQG;IACG,YAAY,IAAI,OAAO,CAAC;QAAE,YAAY,EAAE,GAAG,CAAC;QAAC,aAAa,EAAE,GAAG,CAAA;KAAE,CAAC;IAoBxE;;;;;;;;;OASG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IA8FtC;;OAEG;IAEH;;;;;;;;OAQG;cACa,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB7D;;;;;;;;;OASG;cACa,6BAA6B,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/G;;;;;;;;;OASG;IACU,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5G;;;;;;;;OAQG;IACG,iBAAiB,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;;OAOG;cACa,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUvD;;;;;;;OAOG;cACa,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAexD;;;;;;;OAOG;cACa,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB1D;;;;;;;OAOG;cACa,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3C;;;;;;;;;;;;;OAaG;cACa,2BAA2B,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA+B/G"}