@antelopejs/interface-dms 0.10.4 → 0.13.0

package/dist/tenant-lifecycle.d.ts

@@ -1,13 +1,52 @@
+/**
+ * The release of an invocation that finished or refused failed on every try.
+ * Its admission stays, so the deletion of `tenantId` is blocked until
+ * {@link releaseTenantLifecycleAttempt} retires `attemptId`. The `cause` is the
+ * failure of the last try.
+ */
+export declare class TenantLifecycleReleaseError extends Error {
+    readonly tenantId: string;
+    readonly attemptId: string;
+    constructor(tenantId: string, attemptId: string, cause: unknown);
+}
 /**
  * Admits one invocation. Work must await every producer effect and start no
  * detached writer. Failure retains its admission; an independent replay must
- * never retire this invocation's identity. Internal nested calls reuse admission.
+ * never retire this invocation's identity. Each call takes its own admission,
+ * so work never calls this again for the same tenant.
+ *
+ * A success, and a deliberate refusal (an HTTP 4xx), are the exceptions: work
+ * that awaits every effect has none left in flight once it finishes or
+ * refuses, so keeping the admission would only block the tenant's deletion
+ * forever. The release is tried {@link RELEASE_ATTEMPTS} times, with a pause
+ * between tries. If every try fails, the admission stays, the failure is
+ * logged and the call rejects, so the blocked deletion is reported instead of
+ * hidden: with an `AggregateError` of the refusal and a
+ * {@link TenantLifecycleReleaseError} after a refusal, with the
+ * {@link TenantLifecycleReleaseError} after a success.
  *
- * A deliberate refusal (an HTTP 4xx) is the exception: work that awaits every
- * effect has none left in flight once it refuses, so keeping the admission
- * would only block the tenant's deletion forever.
+ * A refusal is read by shape, not `instanceof`, because it can come from
+ * another module's copy of the API interface (a dms-saas seat limit raised
+ * from a hook, for instance).
  */
 export declare function runTenantLifecycleOperation<T>(tenantId: string, work: () => Promise<T>): Promise<T>;
+/**
+ * Retires one admission by hand: the operator path for a deletion that
+ * {@link closeTenantLifecycleAdmission} reports blocked.
+ *
+ * Call it with the `tenantId` and `attemptId` of a
+ * {@link TenantLifecycleReleaseError} once the database answers again. That
+ * invocation finished or refused, so none of its effects is in flight. Any
+ * other attempt that {@link observeTenantLifecycle} lists retains its admission
+ * because its effects may be indeterminate: retire it only after confirming
+ * that its work left no write in flight, since deletion may then overtake it.
+ *
+ * Resolves true when it retired the admission. Resolves false, and writes
+ * nothing, when the tenant holds no such admission: the attempt was already
+ * retired, or an id is wrong. Never call it from a
+ * `runTenantLifecycleOperation` callback or on a timer.
+ */
+export declare function releaseTenantLifecycleAttempt(tenantId: string, attemptId: string): Promise<boolean>;
 /**
  * Must succeed before any destructive tenant phase. Closure is permanent;
  * rejection requires preserving data, never timeout-based takeover or reopening.

package/dist/tenant-lifecycle.js

@@ -1,38 +1,88 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.TenantLifecycleReleaseError = void 0;
 exports.runTenantLifecycleOperation = runTenantLifecycleOperation;
+exports.releaseTenantLifecycleAttempt = releaseTenantLifecycleAttempt;
 exports.closeTenantLifecycleAdmission = closeTenantLifecycleAdmission;
 exports.observeTenantLifecycle = observeTenantLifecycle;
 exports.pauseTenantLifecycleAdmission = pauseTenantLifecycleAdmission;
 exports.resumeTenantLifecycleAdmission = resumeTenantLifecycleAdmission;
 const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:timers/promises");
+const logging_1 = require("@antelopejs/interface-core/logging");
 const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
 const tenantLifecycle_model_1 = require("./db/internal/tenantLifecycle.model");
 const HTTP_CLIENT_ERROR_MIN = 400;
 const HTTP_SERVER_ERROR_MIN = 500;
+const RELEASE_ATTEMPTS = 3;
+const RELEASE_BACKOFF_MS = 200;
 /**
- * Whether the work refused on purpose, with an HTTP 4xx: a decision rather
- * than an effect whose outcome is unknown. Read by shape, not `instanceof`,
- * because the refusal can come from another module's copy of the API
- * interface (a dms-saas seat limit raised from a hook, for instance).
+ * Whether a status is an HTTP 4xx: a refusal on purpose, a decision rather
+ * than an effect whose outcome is unknown.
  */
-function isDeliberateRefusal(error) {
-    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- Legacy refusal detection reads getStatus from any thrown value without validating its shape; adding validation would change proxy and getter behavior.
-    const getStatus = error?.getStatus;
-    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Refusals can originate in another copy of the API; the existing callable shape check intentionally avoids instanceof.
-    if (typeof getStatus !== "function")
-        return false;
-    const status = getStatus.call(error);
+function isClientErrorStatus(status) {
     return status >= HTTP_CLIENT_ERROR_MIN && status < HTTP_SERVER_ERROR_MIN;
 }
+/**
+ * The release of an invocation that finished or refused failed on every try.
+ * Its admission stays, so the deletion of `tenantId` is blocked until
+ * {@link releaseTenantLifecycleAttempt} retires `attemptId`. The `cause` is the
+ * failure of the last try.
+ */
+class TenantLifecycleReleaseError extends Error {
+    tenantId;
+    attemptId;
+    constructor(tenantId, attemptId, cause) {
+        super(`Tenant lifecycle release of attempt '${attemptId}' failed ${RELEASE_ATTEMPTS} times; deletion of tenant '${tenantId}' stays blocked until releaseTenantLifecycleAttempt('${tenantId}', '${attemptId}') succeeds`, { cause });
+        this.name = "TenantLifecycleReleaseError";
+        this.tenantId = tenantId;
+        this.attemptId = attemptId;
+    }
+}
+exports.TenantLifecycleReleaseError = TenantLifecycleReleaseError;
+/**
+ * Releases the admission of an invocation whose effects are all known: it
+ * finished, or it refused on purpose. Releasing is idempotent, so a failed
+ * release is tried again after a pause that doubles each time, which rides out
+ * a short outage. When every try fails, the failure is logged and returned,
+ * never swallowed.
+ */
+async function releaseAttempt(model, tenantId, attemptId) {
+    let failure;
+    for (let attempt = 0; attempt < RELEASE_ATTEMPTS; attempt++) {
+        if (attempt > 0)
+            await (0, promises_1.setTimeout)(RELEASE_BACKOFF_MS * 2 ** (attempt - 1));
+        try {
+            await model.finish(tenantId, attemptId);
+            return undefined;
+        }
+        catch (releaseFailure) {
+            failure = releaseFailure;
+        }
+    }
+    const error = new TenantLifecycleReleaseError(tenantId, attemptId, failure);
+    logging_1.Logging.Error(error.message, failure);
+    return error;
+}
 /**
  * Admits one invocation. Work must await every producer effect and start no
  * detached writer. Failure retains its admission; an independent replay must
- * never retire this invocation's identity. Internal nested calls reuse admission.
+ * never retire this invocation's identity. Each call takes its own admission,
+ * so work never calls this again for the same tenant.
  *
- * A deliberate refusal (an HTTP 4xx) is the exception: work that awaits every
- * effect has none left in flight once it refuses, so keeping the admission
- * would only block the tenant's deletion forever.
+ * A success, and a deliberate refusal (an HTTP 4xx), are the exceptions: work
+ * that awaits every effect has none left in flight once it finishes or
+ * refuses, so keeping the admission would only block the tenant's deletion
+ * forever. The release is tried {@link RELEASE_ATTEMPTS} times, with a pause
+ * between tries. If every try fails, the admission stays, the failure is
+ * logged and the call rejects, so the blocked deletion is reported instead of
+ * hidden: with an `AggregateError` of the refusal and a
+ * {@link TenantLifecycleReleaseError} after a refusal, with the
+ * {@link TenantLifecycleReleaseError} after a success.
+ *
+ * A refusal is read by shape, not `instanceof`, because it can come from
+ * another module's copy of the API interface (a dms-saas seat limit raised
+ * from a hook, for instance).
  */
 async function runTenantLifecycleOperation(tenantId, work) {
     const model = (0, interface_database_decorators_1.GetModel)(tenantLifecycle_model_1.TenantLifecycleModel, tenantId);
@@ -43,14 +93,43 @@ async function runTenantLifecycleOperation(tenantId, work) {
         result = await work();
     }
     catch (error) {
-        if (isDeliberateRefusal(error)) {
-            await model.finish(tenantId, attemptId).catch(() => undefined);
+        // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- Legacy refusal detection reads getStatus from any thrown value without validating its shape; adding validation would change proxy and getter behavior.
+        const getStatus = error?.getStatus;
+        if (
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Refusals can originate in another copy of the API; the existing callable shape check intentionally avoids instanceof.
+        typeof getStatus === "function" &&
+            isClientErrorStatus(getStatus.call(error))) {
+            const releaseFailure = await releaseAttempt(model, tenantId, attemptId);
+            if (releaseFailure) {
+                throw new AggregateError([error, releaseFailure], `Tenant lifecycle admission of tenant '${tenantId}' refused the work but could not release attempt '${attemptId}'; deletion of this tenant stays blocked`);
+            }
         }
         throw error;
     }
-    await model.finish(tenantId, attemptId);
+    const releaseFailure = await releaseAttempt(model, tenantId, attemptId);
+    if (releaseFailure)
+        throw releaseFailure;
     return result;
 }
+/**
+ * Retires one admission by hand: the operator path for a deletion that
+ * {@link closeTenantLifecycleAdmission} reports blocked.
+ *
+ * Call it with the `tenantId` and `attemptId` of a
+ * {@link TenantLifecycleReleaseError} once the database answers again. That
+ * invocation finished or refused, so none of its effects is in flight. Any
+ * other attempt that {@link observeTenantLifecycle} lists retains its admission
+ * because its effects may be indeterminate: retire it only after confirming
+ * that its work left no write in flight, since deletion may then overtake it.
+ *
+ * Resolves true when it retired the admission. Resolves false, and writes
+ * nothing, when the tenant holds no such admission: the attempt was already
+ * retired, or an id is wrong. Never call it from a
+ * `runTenantLifecycleOperation` callback or on a timer.
+ */
+async function releaseTenantLifecycleAttempt(tenantId, attemptId) {
+    return (0, interface_database_decorators_1.GetModel)(tenantLifecycle_model_1.TenantLifecycleModel, tenantId).finish(tenantId, attemptId);
+}
 /**
  * Must succeed before any destructive tenant phase. Closure is permanent;
  * rejection requires preserving data, never timeout-based takeover or reopening.

package/dist/tenant-lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"tenant-lifecycle.js","sourceRoot":"","sources":["../src/tenant-lifecycle.ts"],"names":[],"mappings":";;AAoCA,kEAkBC;AAMD,sEAIC;AAWD,wDAUC;AAWD,sEAUC;AASD,wEAKC;AAxHD,6CAAyC;AACzC,6FAAqE;AACrE,+EAA2E;AAE3E,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAOlC;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,KAAqB;IAChD,yOAAyO;IACzO,MAAM,SAAS,GAAI,KAAuC,EAAE,SAAS,CAAC;IACtE,gLAAgL;IAChL,IAAI,OAAO,SAAS,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,MAAM,IAAI,qBAAqB,IAAI,MAAM,GAAG,qBAAqB,CAAC;AAC3E,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,2BAA2B,CAC/C,QAAgB,EAChB,IAAsB;IAEtB,MAAM,KAAK,GAAG,IAAA,wCAAQ,EAAC,4CAAoB,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,IAAA,wBAAU,GAAE,CAAC;IAC/B,MAAM,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACvC,IAAI,MAAS,CAAC;IACd,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,6BAA6B,CACjD,QAAgB;IAEhB,MAAM,IAAA,wCAAQ,EAAC,4CAAoB,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAUD,+EAA+E;AACxE,KAAK,UAAU,sBAAsB,CAC1C,QAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,IAAA,wCAAQ,EAAC,4CAAoB,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC7E,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;QAClC,gBAAgB,EAAE,CAAC,GAAG,KAAK,CAAC,gBAAgB,CAAC;QAC7C,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,6BAA6B,CACjD,QAAgB,EAChB,SAAiB,EACjB,gBAAwB;IAExB,OAAO,IAAA,wCAAQ,EAAC,4CAAoB,EAAE,QAAQ,CAAC,CAAC,KAAK,CACnD,QAAQ,EACR,SAAS,EACT,gBAAgB,CACjB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,8BAA8B,CAClD,QAAgB,EAChB,SAAiB;IAEjB,OAAO,IAAA,wCAAQ,EAAC,4CAAoB,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC9E,CAAC"}
+{"version":3,"file":"tenant-lifecycle.js","sourceRoot":"","sources":["../src/tenant-lifecycle.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1 +1,21 @@
+import type { ControllerClass } from "@antelopejs/interface-api";
 export type MaybePromise<T> = T | Promise<T>;
+/** An image stored by key, as the image data type and `User.avatar` hold it. */
+export interface ImageValue {
+    key: string;
+    alt?: string;
+    principal?: boolean;
+}
+/**
+ * The page a component is placed on, as its `onCreated` hook receives it once
+ * the page registers. `PageMetadata` implements it.
+ */
+export interface CreatedPage {
+    /** The page controller the component is placed on. */
+    readonly target: ControllerClass;
+    /** The id and slug the page registered under, from the root category. */
+    readonly pageInfo?: {
+        readonly fullId: string;
+        readonly fullSlug: string;
+    };
+}

package/dist/uploads.d.ts

@@ -1,5 +1,5 @@
 import { RegisteringProxy } from "@antelopejs/interface-core";
-import type { NativeUploadFieldRegistration, UploadTokenClaims } from "./internal/uploads";
+import { type NativeUploadFieldRegistration, type UploadTokenClaims } from "./internal/uploads";
 /** @internal */
 export declare namespace internal {
     const RegisterNativeUploadField: RegisteringProxy<(registration: NativeUploadFieldRegistration) => void>;

package/dist/uploads.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SignUploadToken = exports.internal = void 0;
 exports.StampUploadFieldTokens = StampUploadFieldTokens;
 const interface_core_1 = require("@antelopejs/interface-core");
+const uploads_1 = require("./internal/uploads");
 /** @internal */
 var internal;
 (function (internal) {
@@ -17,68 +18,44 @@ var internal;
  * @internal
  */
 exports.SignUploadToken = (0, interface_core_1.InterfaceFunction)();
-const UPLOAD_FIELD_TYPES = new Set(["file", "image"]);
+function isTraversable(value) {
+    return !!value && typeof value === "object";
+}
 function isUploadFieldNode(node) {
-    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Traversal accepts arbitrary serialized option values and only inspects object nodes.
-    if (!node || typeof node !== "object")
-        return false;
-    const candidate = node;
-    return (
-    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- A native upload node must name a file or image field rather than an arbitrary option type.
-    typeof candidate.type === "string" &&
-        UPLOAD_FIELD_TYPES.has(candidate.type) &&
-        !!candidate.component &&
-        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Preserve the serialized-node shape check before accessing the component's options.
-        typeof candidate.component === "object");
+    return (isTraversable(node) &&
+        !Array.isArray(node) &&
+        "type" in node &&
+        (node.type === "file" || node.type === "image") &&
+        "component" in node &&
+        isTraversable(node.component));
 }
-function hasUploadField(node) {
-    if (Array.isArray(node)) {
-        return node.some(hasUploadField);
-    }
-    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Recursive traversal stops at primitive leaves of consumer options.
-    if (!node || typeof node !== "object") {
-        return false;
-    }
-    if (isUploadFieldNode(node)) {
-        return true;
-    }
-    return Object.values(node).some(hasUploadField);
+/** Every upload field of a serialized value, an enclosing one before the ones it holds. */
+// oxlint-disable-next-line anti-slop/no-unknown-parameters -- Walks every value of the serialized options a component declares, its own T, at any depth that declaration has, to find the upload fields among them.
+function uploadFieldNodes(node) {
+    if (!isTraversable(node))
+        return [];
+    return [
+        ...(isUploadFieldNode(node) ? [node] : []),
+        ...Object.values(node).flatMap(uploadFieldNodes),
+    ];
 }
 async function stampNode(node) {
-    if (Array.isArray(node)) {
-        for (const item of node)
-            await stampNode(item);
-        return;
-    }
-    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Primitive option leaves have no upload fields or child objects to stamp.
-    if (!node || typeof node !== "object") {
-        return;
-    }
-    if (isUploadFieldNode(node)) {
-        const component = node.component;
-        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- The existing serialized-node check does not validate options; non-object options are replaced before stamping.
-        if (!component.options || typeof component.options !== "object") {
-            component.options = {};
-        }
-        const options = component.options;
-        options.uploadToken = await (0, exports.SignUploadToken)({
-            pageId: "",
-            componentId: "",
-            storage: 
-            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Serialized consumer storage values contribute to claims only when strings.
-            typeof options.storage === "string" ? options.storage : undefined,
-            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Only a string serialized path is copied into upload claims.
-            path: typeof options.path === "string" ? options.path : undefined,
-            field: 
-            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Only a string attachmentField identifies the server-declared upload field.
-            typeof options.attachmentField === "string"
-                ? options.attachmentField
-                : undefined,
-            visibility: options.visibility === "public" ? "public" : "private",
-        });
-    }
-    for (const value of Object.values(node))
-        await stampNode(value);
+    const options = (0, uploads_1.readUploadFieldOptions)(node);
+    options.uploadToken = await (0, exports.SignUploadToken)({
+        pageId: "",
+        componentId: "",
+        storage: 
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Serialized consumer storage values contribute to claims only when strings.
+        typeof options.storage === "string" ? options.storage : undefined,
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Only a string serialized path is copied into upload claims.
+        path: typeof options.path === "string" ? options.path : undefined,
+        field: 
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Only a string attachmentField identifies the server-declared upload field.
+        typeof options.attachmentField === "string"
+            ? options.attachmentField
+            : undefined,
+        visibility: options.visibility === "public" ? "public" : "private",
+    });
 }
 /**
  * Stamp a signed upload token into every File/Image field found in a
@@ -95,11 +72,13 @@ async function stampNode(node) {
  * start from the untransformed declaration.
  */
 async function StampUploadFieldTokens(options) {
-    if (!hasUploadField(options)) {
+    if (uploadFieldNodes(options).length === 0) {
         return options;
     }
+    // oxlint-disable-next-line typescript/no-unsafe-assignment -- The JSON round trip clones the caller's options as any and types the clone as its T, kept by the 2026-11-02 16:00 ruling because any other clone changes the upload answer.
     const cloned = JSON.parse(JSON.stringify(options));
-    await stampNode(cloned);
+    for (const node of uploadFieldNodes(cloned))
+        await stampNode(node);
     return cloned;
 }
 //# sourceMappingURL=uploads.js.map

package/dist/uploads.js.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.js","sourceRoot":"","sources":["../src/uploads.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"uploads.js","sourceRoot":"","sources":["../src/uploads.ts"],"names":[],"mappings":";;;AA2FA,wDAQC;AAnGD,+DAGoC;AACpC,gDAI4B;AAE5B,gBAAgB;AAChB,IAAiB,QAAQ,CAIxB;AAJD,WAAiB,QAAQ;IACV,kCAAyB,GAAG,IAAI,iCAAgB,EAE1D,CAAC;AACN,CAAC,EAJgB,QAAQ,wBAAR,QAAQ,QAIxB;AAED;;;;;;;GAOG;AACU,QAAA,eAAe,GAC1B,IAAA,kCAAiB,GAAkD,CAAC;AAOtE,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AAC9C,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAa;IACtC,OAAO,CACL,aAAa,CAAC,IAAI,CAAC;QACnB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACpB,MAAM,IAAI,IAAI;QACd,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC;QAC/C,WAAW,IAAI,IAAI;QACnB,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,oNAAoN;AACpN,SAAS,gBAAgB,CAAC,IAAa;IACrC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,OAAO;QACL,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAqB;IAC5C,MAAM,OAAO,GAAG,IAAA,gCAAsB,EAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,WAAW,GAAG,MAAM,IAAA,uBAAe,EAAC;QAC1C,MAAM,EAAE,EAAE;QACV,WAAW,EAAE,EAAE;QACf,OAAO;QACL,qIAAqI;QACrI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACnE,sHAAsH;QACtH,IAAI,EAAE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACjE,KAAK;QACH,qIAAqI;QACrI,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ;YACzC,CAAC,CAAC,OAAO,CAAC,eAAe;YACzB,CAAC,CAAC,SAAS;QACf,UAAU,EAAE,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KACnE,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,sBAAsB,CAAI,OAAU;IACxD,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,0OAA0O;IAC1O,MAAM,MAAM,GAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC;QAAE,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/fire-and-forget.js.map

@@ -1 +1 @@
-{"version":3,"file":"fire-and-forget.js","sourceRoot":"","sources":["../../src/utils/fire-and-forget.ts"],"names":[],"mappings":";;AAMA,sCAOC;AAbD,gEAA6D;AAE7D;;;GAGG;AACH,SAAgB,aAAa,CAC3B,IAAsB,EACtB,WAAmB;IAEnB,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACnB,iBAAO,CAAC,KAAK,CAAC,oBAAoB,WAAW,YAAY,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"fire-and-forget.js","sourceRoot":"","sources":["../../src/utils/fire-and-forget.ts"],"names":[],"mappings":";;AAMA,sCAOC;AAbD,gEAA6D;AAE7D;;;GAGG;AACH,SAAgB,aAAa,CAC3B,IAAsB,EACtB,WAAmB;IAEnB,IAAI,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC5B,iBAAO,CAAC,KAAK,CAAC,oBAAoB,WAAW,YAAY,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/internal/decorated-class.d.ts

@@ -0,0 +1,14 @@
+import type { Class, DecoratorTarget } from "@antelopejs/interface-core/decorators";
+/**
+ * The class a member decorator decorates: its target's `constructor`.
+ *
+ * @internal
+ */
+export declare function decoratedClass(target: DecoratorTarget): Class;
+/**
+ * The prototype a class's instance members are decorated on.
+ *
+ * @internal
+ * @throws {TypeError} When the class has no prototype object.
+ */
+export declare function prototypeOf(owner: Class): DecoratorTarget;

package/dist/utils/internal/decorated-class.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decoratedClass = decoratedClass;
+exports.prototypeOf = prototypeOf;
+const type_check_1 = require("./type-check");
+/**
+ * The class a member decorator decorates: its target's `constructor`.
+ *
+ * @internal
+ */
+function decoratedClass(target) {
+    const owner = target.constructor;
+    if (!(0, type_check_1.isClass)(owner)) {
+        throw new TypeError("A member decorator applies to a class.");
+    }
+    return owner;
+}
+function isDecoratorTarget(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "constructor" in value &&
+        typeof value.constructor === "function");
+}
+/**
+ * The prototype a class's instance members are decorated on.
+ *
+ * @internal
+ * @throws {TypeError} When the class has no prototype object.
+ */
+function prototypeOf(owner) {
+    const prototype = owner.prototype;
+    if (!isDecoratorTarget(prototype)) {
+        throw new TypeError(`${owner.name} has no prototype to decorate`);
+    }
+    return prototype;
+}
+//# sourceMappingURL=decorated-class.js.map

package/dist/utils/internal/decorated-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorated-class.js","sourceRoot":"","sources":["../../../src/utils/internal/decorated-class.ts"],"names":[],"mappings":";;AAYA,wCAMC;AAiBD,kCAMC;AApCD,6CAAuC;AAEvC;;;;GAIG;AACH,SAAgB,cAAc,CAAC,MAAuB;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC;IACjC,IAAI,CAAC,IAAA,oBAAO,EAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,aAAa,IAAI,KAAK;QACtB,OAAO,KAAK,CAAC,WAAW,KAAK,UAAU,CACxC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,KAAY;IACtC,MAAM,SAAS,GAAY,KAAK,CAAC,SAAS,CAAC;IAC3C,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,CAAC,IAAI,+BAA+B,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/internal/type-check.d.ts

@@ -1,3 +1,4 @@
+import type { Class } from "@antelopejs/interface-core/decorators";
 declare const primitiveTypes: readonly ["string", "number", "boolean", "undefined", "bigint", "symbol"];
 type Primitive = (typeof primitiveTypes)[number];
 interface PrimitiveValueByTag {
@@ -21,6 +22,14 @@ export declare const isUndefined: (v: unknown) => v is undefined;
 export declare const isObject: (v: unknown) => v is object;
 /** @internal */
 export declare const isFunction: (v: unknown) => v is (...args: unknown[]) => unknown;
+/**
+ * Whether a value is a class: a function with an object `prototype`, which
+ * arrow functions, methods and bound functions lack. A generator function has
+ * one too, a language limit this check shares with every `prototype` test.
+ *
+ * @internal
+ */
+export declare const isClass: (value: unknown) => value is Class;
 /** @internal */
 export declare const isBigint: (v: unknown) => v is bigint;
 /** @internal */

package/dist/utils/internal/type-check.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isJSON = exports.isDate = exports.isNull = exports.isPrimitive = exports.isSymbol = exports.isBigint = exports.isFunction = exports.isObject = exports.isUndefined = exports.isBoolean = exports.isNumber = exports.isString = void 0;
+exports.isJSON = exports.isDate = exports.isNull = exports.isPrimitive = exports.isSymbol = exports.isBigint = exports.isClass = exports.isFunction = exports.isObject = exports.isUndefined = exports.isBoolean = exports.isNumber = exports.isString = void 0;
 const primitiveTypes = [
     "string",
     "number",
@@ -9,9 +9,7 @@ const primitiveTypes = [
     "bigint",
     "symbol",
 ];
-const createTypeGuard = (type) => (v) => 
-// oxlint-disable-next-line anti-slop/no-runtime-typeof -- These published primitive predicates implement JavaScript tag checks, including the legacy object/null behavior, rather than schema validation.
-typeof v === type;
+const createTypeGuard = (type) => (v) => typeof v === type;
 /** @internal */
 exports.isString = createTypeGuard("string");
 /** @internal */
@@ -26,6 +24,17 @@ exports.isObject = createTypeGuard("object");
 exports.isFunction = 
 // oxlint-disable-next-line anti-slop/no-unknown-returns -- The published function predicate promises no result shape for arbitrary callable values.
 createTypeGuard("function");
+/**
+ * Whether a value is a class: a function with an object `prototype`, which
+ * arrow functions, methods and bound functions lack. A generator function has
+ * one too, a language limit this check shares with every `prototype` test.
+ *
+ * @internal
+ */
+const isClass = (value) => typeof value === "function" &&
+    typeof value.prototype === "object" &&
+    value.prototype !== null;
+exports.isClass = isClass;
 /** @internal */
 exports.isBigint = createTypeGuard("bigint");
 /** @internal */
@@ -33,7 +42,6 @@ exports.isSymbol = createTypeGuard("symbol");
 /** @internal */
 const isPrimitive = (value) => {
     const types = primitiveTypes;
-    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- This published predicate classifies JavaScript tags and narrows to the primitive values whose tags it accepts.
     return types.includes(typeof value);
 };
 exports.isPrimitive = isPrimitive;

package/dist/utils/internal/type-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"type-check.js","sourceRoot":"","sources":["../../../src/utils/internal/type-check.ts"],"names":[],"mappings":";;;AAAA,MAAM,cAAc,GAAG;IACrB,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,WAAW;IACX,QAAQ;IACR,QAAQ;CACA,CAAC;AAaX,MAAM,eAAe,GACnB,CAAI,IAAY,EAAE,EAAE,CACpB,CAAC,CAAU,EAAU,EAAE;AACrB,0MAA0M;AAC1M,OAAO,CAAC,KAAK,IAAI,CAAC;AAEtB,gBAAgB;AACH,QAAA,QAAQ,GAAG,eAAe,CAAS,QAAQ,CAAC,CAAC;AAC1D,gBAAgB;AACH,QAAA,QAAQ,GAAG,eAAe,CAAS,QAAQ,CAAC,CAAC;AAC1D,gBAAgB;AACH,QAAA,SAAS,GAAG,eAAe,CAAU,SAAS,CAAC,CAAC;AAC7D,gBAAgB;AACH,QAAA,WAAW,GAAG,eAAe,CAAY,WAAW,CAAC,CAAC;AACnE,gBAAgB;AACH,QAAA,QAAQ,GAAG,eAAe,CAAS,QAAQ,CAAC,CAAC;AAC1D,gBAAgB;AACH,QAAA,UAAU;AACrB,oJAAoJ;AACpJ,eAAe,CAAkC,UAAU,CAAC,CAAC;AAC/D,gBAAgB;AACH,QAAA,QAAQ,GAAG,eAAe,CAAS,QAAQ,CAAC,CAAC;AAC1D,gBAAgB;AACH,QAAA,QAAQ,GAAG,eAAe,CAAS,QAAQ,CAAC,CAAC;AAE1D,gBAAgB;AACT,MAAM,WAAW,GAAG,CAAC,KAAc,EAA2B,EAAE;IACrE,MAAM,KAAK,GAAsB,cAAc,CAAC;IAChD,yKAAyK;IACzK,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,KAAK,CAAC,CAAC;AACtC,CAAC,CAAC;AAJW,QAAA,WAAW,eAItB;AAEF,gBAAgB;AACT,MAAM,MAAM,GAAG,CAAC,KAAc,EAAiB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;AAA3D,QAAA,MAAM,UAAqD;AAExE,gBAAgB;AACT,MAAM,MAAM,GAAG,CAAC,KAAc,EAAiB,EAAE,CACtD,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AAD7C,QAAA,MAAM,UACuC;AAE1D,gBAAgB;AAChB,4JAA4J;AACrJ,MAAM,MAAM,GAAG,CAAC,KAAc,EAAW,EAAE;IAChD,IAAI,CAAC,IAAA,gBAAQ,EAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO,IAAA,gBAAQ,EAAC,MAAM,CAAC,IAAI,CAAC,IAAA,cAAM,EAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAVW,QAAA,MAAM,UAUjB"}
+{"version":3,"file":"type-check.js","sourceRoot":"","sources":["../../../src/utils/internal/type-check.ts"],"names":[],"mappings":";;;AAEA,MAAM,cAAc,GAAG;IACrB,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,WAAW;IACX,QAAQ;IACR,QAAQ;CACA,CAAC;AA6BX,MAAM,eAAe,GACnB,CAAI,IAAkB,EAAE,EAAE,CAC1B,CAAC,CAAU,EAAU,EAAE,CACrB,OAAO,CAAC,KAAK,IAAI,CAAC;AAEtB,gBAAgB;AACH,QAAA,QAAQ,GAAG,eAAe,CAAS,QAAQ,CAAC,CAAC;AAC1D,gBAAgB;AACH,QAAA,QAAQ,GAAG,eAAe,CAAS,QAAQ,CAAC,CAAC;AAC1D,gBAAgB;AACH,QAAA,SAAS,GAAG,eAAe,CAAU,SAAS,CAAC,CAAC;AAC7D,gBAAgB;AACH,QAAA,WAAW,GAAG,eAAe,CAAY,WAAW,CAAC,CAAC;AACnE,gBAAgB;AACH,QAAA,QAAQ,GAAG,eAAe,CAAS,QAAQ,CAAC,CAAC;AAC1D,gBAAgB;AACH,QAAA,UAAU;AACrB,oJAAoJ;AACpJ,eAAe,CAAkC,UAAU,CAAC,CAAC;AAC/D;;;;;;GAMG;AACI,MAAM,OAAO,GAAG,CAAC,KAAc,EAAkB,EAAE,CACxD,OAAO,KAAK,KAAK,UAAU;IAC3B,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;IACnC,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;AAHd,QAAA,OAAO,WAGO;AAC3B,gBAAgB;AACH,QAAA,QAAQ,GAAG,eAAe,CAAS,QAAQ,CAAC,CAAC;AAC1D,gBAAgB;AACH,QAAA,QAAQ,GAAG,eAAe,CAAS,QAAQ,CAAC,CAAC;AAE1D,gBAAgB;AACT,MAAM,WAAW,GAAG,CAAC,KAAc,EAA2B,EAAE;IACrE,MAAM,KAAK,GAAsB,cAAc,CAAC;IAChD,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,KAAK,CAAC,CAAC;AACtC,CAAC,CAAC;AAHW,QAAA,WAAW,eAGtB;AAEF,gBAAgB;AACT,MAAM,MAAM,GAAG,CAAC,KAAc,EAAiB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;AAA3D,QAAA,MAAM,UAAqD;AAExE,gBAAgB;AACT,MAAM,MAAM,GAAG,CAAC,KAAc,EAAiB,EAAE,CACtD,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AAD7C,QAAA,MAAM,UACuC;AAE1D,gBAAgB;AAChB,4JAA4J;AACrJ,MAAM,MAAM,GAAG,CAAC,KAAc,EAAW,EAAE;IAChD,IAAI,CAAC,IAAA,gBAAQ,EAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,IAAA,gBAAQ,EAAC,MAAM,CAAC,IAAI,CAAC,IAAA,cAAM,EAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAVW,QAAA,MAAM,UAUjB"}

package/dist/utils/internal/value-parser.d.ts

@@ -83,4 +83,4 @@ export declare function isStringDate(value: string): boolean;
  */
 export declare function isStringJSON(value: string): boolean;
 /** @internal */
-export declare const assertPrimitiveValue: (value: unknown) => void;
+export declare function assertPrimitiveValue(value: unknown): asserts value is string | number | boolean | Date | null;

package/dist/utils/internal/value-parser.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertPrimitiveValue = void 0;
 exports.parseValue = parseValue;
 exports.parseObject = parseObject;
 exports.isStringKeyword = isStringKeyword;
 exports.isStringNumber = isStringNumber;
 exports.isStringDate = isStringDate;
 exports.isStringJSON = isStringJSON;
+exports.assertPrimitiveValue = assertPrimitiveValue;
 const type_check_1 = require("./type-check");
 const KEYWORD_VALUES = {
     true: true,
@@ -15,6 +15,23 @@ const KEYWORD_VALUES = {
     undefined: undefined,
 };
 const KEYWORD_LOOKUP = new Map(Object.entries(KEYWORD_VALUES));
+/** What `JSON.parse` answers, read as the value it holds. */
+function parseJsonText(text) {
+    const parsed = JSON.parse(text);
+    if ((0, type_check_1.isString)(parsed) ||
+        (0, type_check_1.isNumber)(parsed) ||
+        (0, type_check_1.isBoolean)(parsed) ||
+        (0, type_check_1.isNull)(parsed)) {
+        return parsed;
+    }
+    if (Array.isArray(parsed)) {
+        const items = parsed;
+        return items;
+    }
+    if ((0, type_check_1.isObject)(parsed))
+        return Object.fromEntries(Object.entries(parsed));
+    throw new TypeError("JSON text parsed to a value JSON cannot hold");
+}
 const STRING_TYPE_PARSERS = [
     {
         test: isStringKeyword,
@@ -30,7 +47,7 @@ const STRING_TYPE_PARSERS = [
     },
     {
         test: isStringJSON,
-        parse: (value) => JSON.parse(value),
+        parse: parseJsonText,
     },
 ];
 /**
@@ -152,14 +169,10 @@ const PRIMITIVE_TYPE_VALIDATORS = [
     type_check_1.isNull,
 ];
 /** @internal */
-// oxlint-disable-next-line anti-slop/no-unknown-parameters -- This published assertion validates arbitrary comparison operands and throws for unsupported values.
-const assertPrimitiveValue = (value) => {
+function assertPrimitiveValue(value) {
     if (PRIMITIVE_TYPE_VALIDATORS.some((test) => test(value))) {
         return;
     }
-    throw new Error(
-    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- The error reports the rejected operand's JavaScript tag without changing its validation contract.
-    `Value must be a string, number, boolean, or Date for is comparison. Got: ${typeof value}`);
-};
-exports.assertPrimitiveValue = assertPrimitiveValue;
+    throw new Error(`Value must be a string, number, boolean, or Date for is comparison. Got: ${typeof value}`);
+}
 //# sourceMappingURL=value-parser.js.map

package/dist/utils/internal/value-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"value-parser.js","sourceRoot":"","sources":["../../../src/utils/internal/value-parser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"value-parser.js","sourceRoot":"","sources":["../../../src/utils/internal/value-parser.ts"],"names":[],"mappings":";;AAqFA,gCAOC;AAcD,kCASC;AAYD,0CAEC;AAaD,wCAEC;AAaD,oCAMC;AAcD,oCAOC;AAUD,oDASC;AA3MD,6CAOsB;AActB,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,IAAI;IACV,SAAS,EAAE,SAAS;CACrB,CAAC;AAEF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;AAE/D,6DAA6D;AAC7D,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,IACE,IAAA,qBAAQ,EAAC,MAAM,CAAC;QAChB,IAAA,qBAAQ,EAAC,MAAM,CAAC;QAChB,IAAA,sBAAS,EAAC,MAAM,CAAC;QACjB,IAAA,mBAAM,EAAC,MAAM,CAAC,EACd,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAc,MAAM,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAA,qBAAQ,EAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,mBAAmB,GAAG;IAC1B;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC;KACpD;IACD;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;KACxC;IACD;QACE,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC;KAC1C;IACD;QACE,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,aAAa;KACrB;CACF,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,UAAU,CAAC,KAAa;IACtC,KAAK,MAAM,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,WAAW,CACzB,KAA4C;IAE5C,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IACD,8JAA8J;IAC9J,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,eAAe,CAAC,KAAa;IAC3C,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC,0DAA0D,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,yBAAyB,GAAG;IAChC,qBAAQ;IACR,qBAAQ;IACR,sBAAS;IACT,mBAAM;IACN,mBAAM;CACP,CAAC;AACF,gBAAgB;AAChB,SAAgB,oBAAoB,CAClC,KAAc;IAEd,IAAI,yBAAyB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1D,OAAO;IACT,CAAC;IACD,MAAM,IAAI,KAAK,CACb,4EAA4E,OAAO,KAAK,EAAE,CAC3F,CAAC;AACJ,CAAC"}