@serfab/cadre-core 1.17.0 → 1.18.0

package/dist/control-schema-version.js

@@ -3,42 +3,39 @@
  * store after declaring the control schema and before applying it.
  *
  * `apply schema CadreControl` runs whatever DDL makes the hydrated catalog equal the declared
- * schema. Against a store written by another release that DDL is either refused by the
- * optimystic module part-way through (`alter table … drop constraint`, `add column`,
- * `drop column`), which fails the start with a message naming whichever step came first, or
- * runs and destroys rows (`drop table`). This module decides from the pending DDL and the
- * stored schema version, before any of it runs, and throws one typed error instead.
+ * schema, and that apply is how a store written under an older control schema version is
+ * migrated in place: between consecutive versions the difference is limited to statements the
+ * optimystic module applies to a table's catalog record without rewriting a row, so running the
+ * diff from a store at version K to this build's declaration runs each version's changes from
+ * K+1 up to the build's, in order. This module decides, from the stored version and the pending
+ * DDL and before any of it runs, whether the apply may go ahead, and throws one typed error
+ * naming the reason when it may not.
  *
  * The same change classifier ({@link classifyControlSchemaChange}) is what
  * `control-schema-versions.spec.ts` runs over each pair of consecutive control schema versions,
  * so a schema edit that no store could be migrated across fails when it is made. Where the
  * version lives, when it changes and what a new version may change: docs/architecture.md →
- * "Control schema changes and incompatible stores".
+ * "Control schema versions and migrations".
  *
- * NOTE: the stored tag is the version the store's `OwnerKey` table was CREATED under. The
- * optimystic plugin does not persist `alter table … set tags` (Quereus applies a tag change to
- * its catalog without calling the module, and the plugin follows it in memory only), so the
- * `set tags` an additive upgrade runs raises the version for that process alone. The check stays
- * safe regardless, because it lets through only DDL that adds, so an older build's diff against
- * an upgraded store lists the drop and is refused on that ground. Migrating a store in place
- * (control-store-migrates-on-start) needs the version a store was upgraded to, so it needs that
- * persisted upstream (optimystic-catalog-only-alter-table).
+ * The stored tag is the version of the last start that applied the schema to the store: the
+ * apply's `alter table OwnerKey set tags (…)` persists since Optimystic 1.16.0, so after a
+ * migrating start the store records this build's version. A store additively upgraded by a build
+ * from before that still reads the version it was created under, which is harmless: the diff is
+ * computed from the catalog, not from the number, and the number only has to tell a store that
+ * a newer release migrated from one this build can migrate.
  */
 import { Parser } from '@quereus/quereus';
-import { CONTROL_SCHEMA_NAME, CONTROL_SCHEMA_VERSION_TAG } from './control-schema.js';
+import { CONTROL_SCHEMA_BASELINE_VERSION, CONTROL_SCHEMA_NAME, CONTROL_SCHEMA_VERSION_TAG } from './control-schema.js';
 import { controlStorageScope } from './storage-scope.js';
 /** The control table whose tags carry {@link CONTROL_SCHEMA_VERSION_TAG}. */
 const VERSION_TABLE = 'OwnerKey';
-/** A warm control store this build cannot apply its control schema to without destroying data. */
+/** A warm control store this build cannot apply its control schema to. */
 export class ControlStoreIncompatibleError extends Error {
-    constructor(partyId, storeVersion, buildVersion, pendingDdl) {
+    constructor(reason, partyId, storeVersion, buildVersion, pendingDdl) {
         const storageScope = controlStorageScope(partyId);
-        super(`The control store for party ${JSON.stringify(partyId)} ${provenance(storeVersion, buildVersion)} ` +
-            `(it records control schema version ${storeVersion}; this build declares ${buildVersion}), and this build ` +
-            'cannot apply its control schema to it without losing data. Run a release whose control schema ' +
-            `matches the store, or recreate the control store (storage scope ${storageScope}) as ` +
-            'docs/architecture.md describes.');
+        super(refusalMessage(reason, partyId, storeVersion, buildVersion, storageScope));
         this.name = 'ControlStoreIncompatibleError';
+        this.reason = reason;
         this.partyId = partyId;
         this.storeVersion = storeVersion;
         this.buildVersion = buildVersion;
@@ -47,32 +44,48 @@ export class ControlStoreIncompatibleError extends Error {
     }
 }
 /**
- * Which release created the store, relative to this build, for the error message. Created, not
- * last written: the stored version does not move on an additive upgrade (module NOTE).
+ * The message for each {@link ControlStoreIncompatibility}. Only the two recreate cases advise
+ * recreating: a store a newer release migrated holds rows written since, and recreating it
+ * would throw them away.
  */
-function provenance(storeVersion, buildVersion) {
-    if (storeVersion > buildVersion) {
-        return 'was created by a newer release';
+function refusalMessage(reason, partyId, storeVersion, buildVersion, storageScope) {
+    const store = `The control store for party ${JSON.stringify(partyId)}`;
+    const versions = `it records control schema version ${storeVersion}; this build declares ${buildVersion}`;
+    const recreate = 'Run a release whose control schema matches the store, or recreate the control store ' +
+        `(storage scope ${storageScope}) as docs/architecture.md describes.`;
+    switch (reason) {
+        case 'newer-release':
+            return `${store} was migrated by a newer release (${versions}). Update this app or node to that ` +
+                'release or a later one; the store and its rows are intact.';
+        case 'before-migrations':
+            return `${store} was written before control schema migrations (${versions}; migrations start at ` +
+                `version ${CONTROL_SCHEMA_BASELINE_VERSION}, and docs/architecture.md says why earlier stores are not ` +
+                `migrated), so this build cannot upgrade it in place. ${recreate}`;
+        case 'not-migratable':
+            return `${store} cannot be migrated to this build's control schema (${versions}): applying it would ` +
+                `rewrite or discard stored rows. ${recreate}`;
     }
-    return storeVersion < buildVersion
-        ? 'was created by an older release'
-        : 'was created under the same control schema version';
 }
 /**
- * Throw {@link ControlStoreIncompatibleError} when applying the declared control schema to the
- * hydrated store would destroy data; return having run nothing otherwise. Needs
- * `declare schema CadreControl` to have run, and runs only `diff schema`, which executes no DDL.
+ * Throw {@link ControlStoreIncompatibleError} when the declared control schema must not be applied
+ * to the hydrated store; return having run nothing otherwise, and the apply then migrates the
+ * store. Needs `declare schema CadreControl` to have run, and runs only `diff schema`, which
+ * executes no DDL.
  *
  * A cold store (the hydrated catalog lists no control table) passes without a diff: the apply
- * creates everything. A warm store is refused when either
- *  - any pending statement is not `additive` ({@link classifyControlSchemaChange}): every other
- *    change to an existing control table is refused by the optimystic module or discards rows; or
- *  - its version is above the build's: a newer release created it, so even a diff that only adds
- *    (the newer release no longer declares something this build does) would put back what that
- *    release removed, and the newer release would then refuse its own store.
+ * creates everything. A warm store is refused for the first of these that holds
+ * ({@link ControlStoreIncompatibility}):
+ *  - its version is above the build's: even a diff that only adds (the newer release no longer
+ *    declares something this build does) would put back what that release removed, and the newer
+ *    release would then refuse its own store;
+ *  - its version is below the baseline, whatever the diff: a store written by 1.16.0 or earlier,
+ *    which the baseline paragraph of docs/architecture.md explains cannot be migrated;
+ *  - any pending statement is `unmigratable` ({@link classifyControlSchemaChange}).
  *
- * So a store from an older release still warm-starts when the only change since is a new table
- * or index.
+ * Every `additive` and `catalog-only` change passes, so a store from an older migratable
+ * release warm-starts and the apply brings it to this build's version. A store that is both
+ * older than the baseline and not migratable reports `before-migrations`, whose message gives the
+ * recreate advice and points at the explanation.
  */
 export async function refuseIncompatibleControlStore(db, partyId) {
     if (!isWarmControlStore(db)) {
@@ -81,11 +94,20 @@ export async function refuseIncompatibleControlStore(db, partyId) {
     const storeVersion = schemaVersionOf(db.schemaManager.getTable(CONTROL_SCHEMA_NAME, VERSION_TABLE)?.tags);
     const buildVersion = declaredSchemaVersion(db);
     const pending = await pendingControlSchemaChanges(db);
-    // `catalog-only` changes stay refused until the optimystic module applies them
-    // (optimystic-catalog-only-alter-table); control-store-migrates-on-start widens this then.
-    if (storeVersion > buildVersion || pending.some((change) => change.kind !== 'additive')) {
-        throw new ControlStoreIncompatibleError(partyId, storeVersion, buildVersion, pending.map((change) => change.ddl));
+    const reason = incompatibilityOf(storeVersion, buildVersion, pending);
+    if (reason !== undefined) {
+        throw new ControlStoreIncompatibleError(reason, partyId, storeVersion, buildVersion, pending.map((change) => change.ddl));
+    }
+}
+/** The first {@link ControlStoreIncompatibility} that holds for a warm store, or undefined when the apply may migrate it. */
+function incompatibilityOf(storeVersion, buildVersion, pending) {
+    if (storeVersion > buildVersion) {
+        return 'newer-release';
+    }
+    if (storeVersion < CONTROL_SCHEMA_BASELINE_VERSION) {
+        return 'before-migrations';
     }
+    return pending.some((change) => change.kind === 'unmigratable') ? 'not-migratable' : undefined;
 }
 /** Whether the hydrated catalog lists at least one control table, i.e. the store was written before. */
 function isWarmControlStore(db) {

package/dist/control-schema-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"control-schema-version.js","sourceRoot":"","sources":["../src/control-schema-version.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"control-schema-version.js","sourceRoot":"","sources":["../src/control-schema-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,MAAM,EAAsE,MAAM,kBAAkB,CAAC;AAE9G,OAAO,EAAE,+BAA+B,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACvH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,6EAA6E;AAC7E,MAAM,aAAa,GAAG,UAAU,CAAC;AAcjC,0EAA0E;AAC1E,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAYvD,YACC,MAAmC,EACnC,OAAe,EACf,YAAoB,EACpB,YAAoB,EACpB,UAA6B;QAE7B,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAClD,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IAClC,CAAC;CACD;AAED;;;;GAIG;AACH,SAAS,cAAc,CACtB,MAAmC,EACnC,OAAe,EACf,YAAoB,EACpB,YAAoB,EACpB,YAAoB;IAEpB,MAAM,KAAK,GAAG,+BAA+B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;IACvE,MAAM,QAAQ,GAAG,qCAAqC,YAAY,yBAAyB,YAAY,EAAE,CAAC;IAC1G,MAAM,QAAQ,GAAG,sFAAsF;QACtG,kBAAkB,YAAY,sCAAsC,CAAC;IACtE,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,eAAe;YACnB,OAAO,GAAG,KAAK,qCAAqC,QAAQ,qCAAqC;gBAChG,4DAA4D,CAAC;QAC/D,KAAK,mBAAmB;YACvB,OAAO,GAAG,KAAK,kDAAkD,QAAQ,wBAAwB;gBAChG,WAAW,+BAA+B,6DAA6D;gBACvG,wDAAwD,QAAQ,EAAE,CAAC;QACrE,KAAK,gBAAgB;YACpB,OAAO,GAAG,KAAK,uDAAuD,QAAQ,uBAAuB;gBACpG,mCAAmC,QAAQ,EAAE,CAAC;IACjD,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,EAAY,EAAE,OAAe;IACjF,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7B,OAAO;IACR,CAAC;IACD,MAAM,YAAY,GAAG,eAAe,CAAC,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,mBAAmB,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1G,MAAM,YAAY,GAAG,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,2BAA2B,CAAC,EAAE,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,iBAAiB,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IACtE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,6BAA6B,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3H,CAAC;AACF,CAAC;AAED,6HAA6H;AAC7H,SAAS,iBAAiB,CACzB,YAAoB,EACpB,YAAoB,EACpB,OAA8C;IAE9C,IAAI,YAAY,GAAG,YAAY,EAAE,CAAC;QACjC,OAAO,eAAe,CAAC;IACxB,CAAC;IACD,IAAI,YAAY,GAAG,+BAA+B,EAAE,CAAC;QACpD,OAAO,mBAAmB,CAAC;IAC5B,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;AAChG,CAAC;AAED,wGAAwG;AACxG,SAAS,kBAAkB,CAAC,EAAY;IACvC,MAAM,MAAM,GAAG,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IAC/D,OAAO,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC;AACnE,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,qBAAqB,CAAC,EAAY;IACjD,MAAM,QAAQ,GAAG,EAAE,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,QAAQ,EAAE,KAAK,CAAC,IAAI,CACjC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC,WAAW,EAAE,CAClH,CAAC;IACF,OAAO,eAAe,CAAC,KAAK,EAAE,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAC5F,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,IAAoD;IAC5E,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC,0BAA0B,CAAC,CAAC;IACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC3C,OAAO,CAAC,CAAC;IACV,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAClE,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,KAAK,CAAC,OAAO,aAAa,QAAQ,0BAA0B,UAAU,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAChI,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAaD,MAAM,YAAY,GAAuC,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;AAStG;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,EAAY;IAC7D,MAAM,OAAO,GAAiC,EAAE,CAAC;IACjD,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,eAAe,mBAAmB,EAAE,CAAC,EAAE,CAAC;QACvE,MAAM,GAAG,GAAG,GAAG,CAAC,GAAa,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,2BAA2B,CAAC,SAAS,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;QACtH,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,uEAAuE;AACvE,SAAS,eAAe,CAAC,KAAyC;IACjE,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC;AAED;;;;GAIG;AACH,SAAS,2BAA2B,CAAC,SAAoB,EAAE,OAAsB;IAChF,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,aAAa;YACjB,OAAO,UAAU,CAAC;QACnB,sFAAsF;QACtF,uFAAuF;QACvF,0EAA0E;QAC1E,KAAK,aAAa;YACjB,OAAO,UAAU,CAAC;QACnB,KAAK,MAAM;YACV,OAAO,SAAS,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC;QAC3E,KAAK,YAAY;YAChB,OAAO,uBAAuB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACpD;YACC,OAAO,cAAc,CAAC;IACxB,CAAC;AACF,CAAC;AAED,SAAS,uBAAuB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAkB,EAAE,OAAsB;IACzF,MAAM,MAAM,GAAG,GAA4B,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,IAAI,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAChH,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,SAAS;YACb,OAAO,UAAU,CAAC;QACnB,0FAA0F;QAC1F,wFAAwF;QACxF,0FAA0F;QAC1F,KAAK,eAAe;YACnB,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC;QAC7E,KAAK,gBAAgB;YACpB,OAAO,kBAAkB,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC;QACpF,KAAK,WAAW;YACf,OAAO,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC;QAC/E,KAAK,YAAY;YAChB,OAAO,eAAe,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC;QACjF;YACC,OAAO,cAAc,CAAC;IACxB,CAAC;AACF,CAAC;AAED,SAAS,kBAAkB,CAAC,KAA8B,EAAE,IAAY;IACvE,OAAO,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,KAAK,CAAC;AAC3G,CAAC;AAED;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,MAAiB;IAC/C,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;AAC9G,CAAC;AAED;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,KAA8B,EAAE,IAAY;IACpE,MAAM,MAAM,GAAG,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7D,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC;WAClE,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;WACjG,CAAC,CAAC,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACxF,CAAC"}