@innovatorstack/harness 0.0.0-stage → 0.1.1

package/dist/platform/values.d.ts

@@ -0,0 +1,17 @@
+import type { HarnessStorage, ItemTypeDefinition, StorageValue, StoredItem } from "../storage/types.js";
+export interface ItemReference {
+    readonly type: string;
+    readonly id: string;
+    readonly world: symbol;
+    readonly generation: number;
+}
+export type SeedValue = StorageValue | ItemReference;
+interface NormalizationOptions {
+    readonly creating: boolean;
+    readonly current?: StoredItem;
+    readonly id?: string;
+    readonly pendingReferences?: ReadonlySet<string>;
+}
+export declare function normalizeProperties(storage: HarnessStorage, definition: ItemTypeDefinition, values: Readonly<Record<string, StorageValue>>, options: NormalizationOptions): Record<string, StorageValue>;
+export {};
+//# sourceMappingURL=values.d.ts.map

package/dist/platform/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/platform/values.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,cAAc,EACd,kBAAkB,EAElB,YAAY,EACZ,UAAU,EACb,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,aAAa,CAAC;AAErD,UAAU,oBAAoB;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpD;AAED,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAC9C,OAAO,EAAE,oBAAoB,GAC9B,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CA0C9B"}

package/dist/platform/values.js

@@ -0,0 +1,105 @@
+import { getOwn, setOwn } from "../core/data.js";
+import { PlatformError } from "./errors.js";
+import { projectedProperties } from "./query.js";
+export function normalizeProperties(storage, definition, values, options) {
+    const normalized = {};
+    const inputs = { ...values };
+    if (options.creating) {
+        for (const property of definition.properties) {
+            if (inputs[property.name] === undefined && property.defaultValue !== undefined) {
+                setOwn(inputs, property.name, property.defaultValue);
+            }
+        }
+    }
+    for (const [name, value] of Object.entries(inputs)) {
+        const property = definition.properties.find((property) => property.name === name);
+        if (!property) {
+            throw new PlatformError("UnknownProperty", `Unknown property '${definition.name}.${name}'.`);
+        }
+        if (isUnchangedComputedProperty(storage, definition, property, value, options)) {
+            continue;
+        }
+        const converted = normalizeValue(definition, property, value);
+        validateItemReference(storage, definition, property, converted, options);
+        if (property.isRequired && (converted === null || converted === "")) {
+            throw new PlatformError("RequiredProperty", `Required property '${definition.name}.${name}' is missing.`);
+        }
+        setOwn(normalized, name, converted);
+    }
+    validateRequiredProperties(definition, normalized, options.creating);
+    return normalized;
+}
+function normalizeValue(definition, property, value) {
+    let converted = value;
+    if (value === "" && ["integer", "boolean", "float", "decimal"].includes(property.dataType)) {
+        converted = null;
+    }
+    if (converted !== null &&
+        typeof converted === "string" &&
+        ["integer", "boolean", "float"].includes(property.dataType)) {
+        const pattern = property.dataType === "float"
+            ? /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?$/
+            : /^[+-]?\d+$/;
+        if (!pattern.test(converted.trim()) || !Number.isFinite(Number(converted))) {
+            throw new PlatformError("InvalidValue", `Invalid ${property.dataType} value for '${definition.name}.${property.name}'.`);
+        }
+        converted = Number(converted);
+    }
+    return converted;
+}
+function validateItemReference(storage, definition, property, converted, options) {
+    if (property.dataType === "item" &&
+        property.dataSource &&
+        converted !== null &&
+        converted !== "") {
+        const target = storage
+            .listItemTypes()
+            .find((type) => type.id.toLowerCase() === property.dataSource?.toLowerCase());
+        if (!target) {
+            throw new PlatformError("MissingItemType", `Missing target ItemType '${property.dataSource}' for '${definition.name}.${property.name}'.`);
+        }
+        const self = options.creating && target.id === definition.id && converted === options.id;
+        const familyIdentity = property.name === "config_id" && target.id === definition.id;
+        const pending = typeof converted === "string" &&
+            options.pendingReferences?.has(JSON.stringify([target.name.toLowerCase(), converted.toLowerCase()]));
+        if (!self &&
+            !familyIdentity &&
+            !pending &&
+            (typeof converted !== "string" || !storage.getItem(target.name, converted))) {
+            throw new PlatformError("MissingReference", `Missing '${target.name}' record '${converted}' referenced by '${definition.name}.${property.name}'.`);
+        }
+    }
+}
+function isUnchangedComputedProperty(storage, definition, property, value, options) {
+    if (property.dataType === "foreign" || property.isFederated) {
+        if (options.current) {
+            const computed = getOwn(projectedProperties(storage, definition, options.current, [property.name]), property.name);
+            if (computed === value ||
+                (computed !== null &&
+                    computed !== undefined &&
+                    value !== null &&
+                    String(computed) === String(value))) {
+                return true;
+            }
+        }
+        throw new PlatformError("ReadOnlyProperty", `Property '${definition.name}.${property.name}' is computed and cannot be written.`);
+    }
+    return false;
+}
+function validateRequiredProperties(definition, normalized, creating) {
+    if (!creating) {
+        return;
+    }
+    for (const property of definition.properties) {
+        if (property.dataType === "foreign" || property.isFederated || property.name === "id") {
+            continue;
+        }
+        if (property.isRequired &&
+            (normalized[property.name] === undefined ||
+                normalized[property.name] === null ||
+                normalized[property.name] === "")) {
+            throw new PlatformError("RequiredProperty", `Required property '${definition.name}.${property.name}' is missing.`);
+        }
+    }
+}
+//# sourceMappingURL=values.js.map

package/dist/platform/values.js.map

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

package/dist/platform/version-policy.d.ts

@@ -0,0 +1,4 @@
+import type { HarnessStorage, ItemTypeDefinition } from "../storage/types.js";
+/** Manual versioning never starts a generation implicitly during an ordinary update. */
+export declare function manualVersioning(storage: HarnessStorage, definition: ItemTypeDefinition): boolean;
+//# sourceMappingURL=version-policy.d.ts.map

package/dist/platform/version-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-policy.d.ts","sourceRoot":"","sources":["../../src/platform/version-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9E,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAYjG"}

package/dist/platform/version-policy.js

@@ -0,0 +1,11 @@
+import { PlatformError } from "./errors.js";
+/** Manual versioning never starts a generation implicitly during an ordinary update. */
+export function manualVersioning(storage, definition) {
+    const metadata = storage.getCatalogEntry("ItemType", definition.id);
+    const value = String(metadata?.properties.manual_versioning ?? "0");
+    if (value !== "0" && value !== "1") {
+        throw new PlatformError("UnsupportedVersioningPolicy", `Unknown manual_versioning '${value}' on '${definition.name}'.`);
+    }
+    return value === "1";
+}
+//# sourceMappingURL=version-policy.js.map

package/dist/platform/version-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-policy.js","sourceRoot":"","sources":["../../src/platform/version-policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,wFAAwF;AACxF,MAAM,UAAU,gBAAgB,CAAC,OAAuB,EAAE,UAA8B;IACpF,MAAM,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,iBAAiB,IAAI,GAAG,CAAC,CAAC;IAEpE,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QACjC,MAAM,IAAI,aAAa,CACnB,6BAA6B,EAC7B,8BAA8B,KAAK,SAAS,UAAU,CAAC,IAAI,IAAI,CAClE,CAAC;IACN,CAAC;IAED,OAAO,KAAK,KAAK,GAAG,CAAC;AACzB,CAAC"}

package/dist/platform/versioned-request.d.ts

@@ -0,0 +1,18 @@
+import type { ExecutionContext } from "../core/types.js";
+import type { Item } from "../items/item.js";
+import type { HarnessStorage, StoredItem } from "../storage/types.js";
+export interface VersionTarget {
+    readonly record: StoredItem;
+    readonly copies: ReadonlyMap<string, string>;
+}
+interface VersionCriteria {
+    readonly scalar: boolean;
+    readonly oldId: string;
+}
+export declare function versionCriteria(original: Item, sources: readonly StoredItem[], fromUpdate: boolean): VersionCriteria;
+/** Generated updates retain native criteria, but never repeat the version decision. */
+export declare function versionedRequest(criteria: VersionCriteria, pending: Item, sources: readonly StoredItem[], targets: readonly VersionTarget[], automatic: boolean): Item;
+/** Replacement Methods see copied relationship IDs before deciding whether to apply the update. */
+export declare function remapVersionRelationships(storage: HarnessStorage, request: Item, copies: ReadonlyMap<string, string>, context: ExecutionContext): void;
+export {};
+//# sourceMappingURL=versioned-request.d.ts.map

package/dist/platform/versioned-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioned-request.d.ts","sourceRoot":"","sources":["../../src/platform/versioned-request.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAY,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKtE,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD;AAED,UAAU,eAAe;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,IAAI,EACd,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,UAAU,EAAE,OAAO,GACpB,eAAe,CA0BjB;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAC5B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,IAAI,EACb,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,SAAS,EAAE,OAAO,GACnB,IAAI,CAoCN;AAED,mGAAmG;AACnG,wBAAgB,yBAAyB,CACrC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,IAAI,EACb,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,OAAO,EAAE,gBAAgB,GAC1B,IAAI,CAwBN"}

package/dist/platform/versioned-request.js

@@ -0,0 +1,95 @@
+import { spendContext } from "../core/context.js";
+import { dataDepthMax, dataNodesMax } from "../core/limits.js";
+import { PlatformError } from "./errors.js";
+import { relationshipKey } from "./graph-actions.js";
+import { isReleased, removeRevisionProperties } from "./revisions/policy.js";
+export function versionCriteria(original, sources, fromUpdate) {
+    if (fromUpdate) {
+        return {
+            scalar: sources.length === 1,
+            oldId: sources.map((source) => source.id).join(","),
+        };
+    }
+    const id = original.getID();
+    if (id) {
+        return { scalar: true, oldId: id };
+    }
+    const idList = original.getAttribute("idlist");
+    if (idList) {
+        const ids = idList.split(",").map((value) => value.trim());
+        return { scalar: ids.length === 1, oldId: ids.join(",") };
+    }
+    return {
+        scalar: false,
+        oldId: ` ( ${original.getAttribute("where")} ) /*WhereClauseHelper marker*/ `,
+    };
+}
+/** Generated updates retain native criteria, but never repeat the version decision. */
+export function versionedRequest(criteria, pending, sources, targets, automatic) {
+    const request = pending.clone();
+    request.setAttribute("oldId", criteria.oldId);
+    delete request.node.attributes.id;
+    delete request.node.attributes.where;
+    delete request.node.attributes.idlist;
+    if (criteria.scalar) {
+        const target = targets[0];
+        if (!target) {
+            throw new PlatformError("InvalidGeneration", "A generated update target is missing.");
+        }
+        request.setProperty("id", target.record.id);
+    }
+    else {
+        request.setAttribute("idlist", targets.map((target) => target.record.id).join(","));
+    }
+    for (const [index, source] of sources.entries()) {
+        const target = targets[index];
+        if (!target) {
+            throw new PlatformError("InvalidGeneration", "A generated update target is missing.");
+        }
+        if (isReleased(source)) {
+            removeRevisionProperties(request, source, target.record);
+        }
+    }
+    if (automatic) {
+        request.setProperty("new_version", 1);
+    }
+    return request;
+}
+/** Replacement Methods see copied relationship IDs before deciding whether to apply the update. */
+export function remapVersionRelationships(storage, request, copies, context) {
+    const pending = [{ node: request.node, depth: 0, relationship: false }];
+    let visited = 0;
+    while (pending.length > 0) {
+        spendContext(context);
+        const frame = pending.pop();
+        if (!frame || ++visited > dataNodesMax || frame.depth > dataDepthMax) {
+            throw new PlatformError("ProtocolLimit", "Versioned relationships exceed their limit.");
+        }
+        if (frame.relationship) {
+            remapRelationship(storage, frame.node, copies);
+        }
+        for (const node of frame.node.relationships) {
+            pending.push({ node, depth: frame.depth + 1, relationship: true });
+        }
+        for (const node of Object.values(frame.node.propertyItems)) {
+            pending.push({ node, depth: frame.depth + 1, relationship: false });
+        }
+    }
+}
+function remapRelationship(storage, node, copies) {
+    const originalId = node.attributes.id;
+    const id = originalId ? copies.get(relationshipKey(node.type, originalId)) : undefined;
+    if (!originalId || !id) {
+        return;
+    }
+    const previous = storage.getItem(node.type, originalId);
+    const current = storage.getItem(node.type, id);
+    const source = node.properties.source_id;
+    if (source !== undefined &&
+        String(source).toLowerCase() === String(previous?.properties.source_id).toLowerCase() &&
+        current?.properties.source_id !== undefined) {
+        node.properties.source_id = current.properties.source_id;
+    }
+    node.attributes.id = id;
+}
+//# sourceMappingURL=versioned-request.js.map

package/dist/platform/versioned-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioned-request.js","sourceRoot":"","sources":["../../src/platform/versioned-request.ts"],"names":[],"mappings":"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"}

package/dist/platform/versioning.d.ts

@@ -0,0 +1,57 @@
+import type { ExecutionContext } from "../core/types.js";
+import { Item } from "../items/item.js";
+import type { HarnessStorage, ItemTypeDefinition, StoredItem } from "../storage/types.js";
+import type { EventRunners, UpdateResult } from "./events/types.js";
+import type { GraphActions } from "./graph-actions.js";
+import type { LifeCycles } from "./lifecycle.js";
+import type { ItemLocks } from "./locks.js";
+import type { DependentDeletion } from "./references/deletion.js";
+import type { ReferenceMaintenance } from "./references/maintenance.js";
+import type { Revisions } from "./revisions/policy.js";
+import type { NativeSecurity } from "./security/policy.js";
+import type { PlatformTrace } from "./trace.js";
+/** Owns generation creation; business events continue through the ordinary Method pipeline. */
+export declare class Versioning {
+    private readonly storage;
+    private readonly trace;
+    private readonly locks;
+    private readonly runners;
+    private readonly nextId;
+    private readonly graph;
+    private readonly references;
+    private readonly deletion;
+    private readonly revisions;
+    private readonly lifeCycles;
+    private readonly security;
+    private readonly copier;
+    constructor(storage: HarnessStorage, trace: PlatformTrace, locks: ItemLocks, runners: EventRunners, nextId: () => string, graph: GraphActions, references: ReferenceMaintenance, deletion: DependentDeletion, revisions: Revisions, lifeCycles: LifeCycles, security: NativeSecurity);
+    assertCurrent(record: StoredItem): void;
+    family(record: StoredItem): readonly StoredItem[];
+    applyBatch(definition: ItemTypeDefinition, records: readonly StoredItem[], request: Item, context: ExecutionContext): Promise<UpdateResult>;
+    private updateEvent;
+    private editBatch;
+    private prepareTargets;
+    private orderedTargets;
+    private authorizeTargets;
+    private updateBatch;
+    private versionBatch;
+    private assertVersionDocument;
+    private updateVersions;
+    private beforeVersions;
+    private afterUpdates;
+    private updateRequest;
+    private beforeUpdate;
+    private assertUnreleased;
+    private shouldVersion;
+    private currentRecord;
+    private updateGeneration;
+    private writeGeneration;
+    private removeManagedProperties;
+    private create;
+    private generationProperties;
+    private revisionProperties;
+    private finishVersions;
+    private generationMap;
+    private nextGeneration;
+}
+//# sourceMappingURL=versioning.d.ts.map

package/dist/platform/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../../src/platform/versioning.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,OAAO,KAAK,EACR,cAAc,EACd,kBAAkB,EAElB,UAAU,EACb,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAwB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAIxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA8BhD,+FAA+F;AAC/F,qBAAa,UAAU;IAIf,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAb7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAE1C,YACqB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,MAAM,EACpB,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,oBAAoB,EAChC,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,cAAc,EAU5C;IAED,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CA0BtC;IAED,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAEhD;IAEK,UAAU,CACZ,UAAU,EAAE,kBAAkB,EAC9B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,OAAO,EAAE,IAAI,EACb,OAAO,EAAE,gBAAgB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAiBvB;YAEa,WAAW;YAkBX,SAAS;YAiDT,cAAc;IAuB5B,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,gBAAgB;YAaV,WAAW;YAuCX,YAAY;IAyD1B,OAAO,CAAC,qBAAqB;YASf,cAAc;YAiCd,cAAc;YA+Cd,YAAY;IAkB1B,OAAO,CAAC,aAAa;YAuBP,YAAY;IAuC1B,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,aAAa;YAaP,gBAAgB;IA4C9B,OAAO,CAAC,eAAe;IAmDvB,OAAO,CAAC,uBAAuB;IAqB/B,OAAO,CAAC,MAAM;IAmBd,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,kBAAkB;YAWZ,cAAc;IA+B5B,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,cAAc;CAgBzB"}