bupkis 0.18.2 → 1.0.0

package/dist/assertion/assertion-async.js

@@ -0,0 +1,259 @@
+import { inspect } from 'util';
+import z from 'zod';
+import { AssertionError, AssertionImplementationError } from "../error.js";
+import { isA, isBoolean, isError, isStandardSchema, isZodType, } from "../guards.js";
+import { isAssertionFailure, isAssertionParseRequest, } from "../internal-schema.js";
+import { BupkisAssertion } from "./assertion.js";
+import { formatAssertionFailure } from "./format-assertion-failure.js";
+export class BupkisAssertionAsync extends BupkisAssertion {
+    async parseValuesAsync(args) {
+        const { slots } = this;
+        const parsedValues = [];
+        if (slots.length !== args.length) {
+            return {
+                success: false,
+            };
+        }
+        let exactMatch = true;
+        for (let i = 0; i < slots.length; i++) {
+            const slot = slots[i];
+            const arg = args[i];
+            const parsedLiteralResult = this.parseSlotForLiteral(slot, i, arg);
+            if (parsedLiteralResult === true) {
+                continue;
+            }
+            else if (parsedLiteralResult !== false) {
+                return parsedLiteralResult;
+            }
+            // unknown/any accept anything
+            // IMPORTANT: do not use a type guard here; it will break inference
+            if (slot.def.type === 'unknown' || slot.def.type === 'any') {
+                parsedValues.push(arg);
+                exactMatch = false;
+                continue;
+            }
+            const result = await slot.safeParseAsync(arg);
+            if (!result.success) {
+                return {
+                    success: false,
+                };
+            }
+            parsedValues.push(result.data);
+        }
+        return {
+            exactMatch,
+            parsedValues: parsedValues,
+            success: true,
+        };
+    }
+}
+/**
+ * An assertion implemented as a Zod schema.
+ *
+ * Async schemas are supported via {@link expectAsync}.
+ */
+/**
+ * Optimized schema assertion that performs subject validation during
+ * parseValues() to eliminate double parsing for simple schema-based
+ * assertions.
+ *
+ * This class implements Option 2 from the z.function() analysis - it caches the
+ * subject validation result during argument parsing and reuses it during
+ * execution, eliminating the double parsing overhead.
+ */
+export class BupkisAssertionFunctionAsync extends BupkisAssertionAsync {
+    async executeAsync(parsedValues, args, stackStartFn, _parseResult) {
+        let result;
+        try {
+            result = await this.impl.call(null, 
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+            ...parsedValues);
+        }
+        catch (err) {
+            if (AssertionError.isAssertionError(err)) {
+                throw err;
+            }
+            if (isError(err) && err instanceof z.ZodError) {
+                throw this.fromZodError(err, stackStartFn, parsedValues);
+            }
+            throw new AssertionImplementationError(`Unexpected error thrown from assertion ${this}: ${err}`, { cause: err });
+        }
+        if (isZodType(result)) {
+            try {
+                await result.parseAsync(parsedValues[0]);
+            }
+            catch (error) {
+                if (isA(error, z.ZodError)) {
+                    throw this.fromZodError(error, stackStartFn, parsedValues);
+                }
+                throw error;
+            }
+        }
+        else if (isStandardSchema(result)) {
+            const validationResult = result['~standard'].validate(parsedValues[0]);
+            const finalResult = validationResult instanceof Promise
+                ? await validationResult
+                : validationResult;
+            if (finalResult.issues) {
+                throw this.fromStandardSchemaIssues(finalResult.issues, stackStartFn, parsedValues);
+            }
+        }
+        else if (isBoolean(result)) {
+            if (!result) {
+                throw new AssertionError({
+                    id: this.id,
+                    message: `Assertion ${this} failed for arguments: ${inspect(args)}`,
+                });
+            }
+        }
+        else if (isError(result) && result instanceof z.ZodError) {
+            throw this.fromZodError(result, stackStartFn, parsedValues);
+        }
+        else if (isAssertionParseRequest(result)) {
+            const { asyncSchema, schema, subject } = result;
+            const schemaToUse = schema ?? asyncSchema;
+            if (isZodType(schemaToUse)) {
+                let zodResult;
+                if (schema) {
+                    zodResult = schemaToUse.safeParse(subject);
+                }
+                else {
+                    zodResult = await schemaToUse.safeParseAsync(subject);
+                }
+                if (!zodResult.success) {
+                    throw this.fromZodError(zodResult.error, stackStartFn, subject);
+                }
+            }
+            else if (isStandardSchema(schemaToUse)) {
+                const validationResult = schemaToUse['~standard'].validate(subject);
+                const finalResult = validationResult instanceof Promise
+                    ? await validationResult
+                    : validationResult;
+                if (finalResult.issues) {
+                    throw this.fromStandardSchemaIssues(finalResult.issues, stackStartFn, subject);
+                }
+            }
+        }
+        else if (isAssertionFailure(result)) {
+            const diffOutput = formatAssertionFailure(result);
+            const baseMessage = result.message ??
+                `Assertion ${this} failed for arguments: ${inspect(args)}`;
+            const message = diffOutput
+                ? `${baseMessage}\n${diffOutput}`
+                : baseMessage;
+            throw new AssertionError({
+                actual: result.actual,
+                expected: result.expected,
+                id: this.id,
+                message,
+            });
+        }
+        else if (result) {
+            throw new AssertionImplementationError(`Invalid return type from assertion ${this}; expected boolean, ZodType, or AssertionFailure`, { result });
+        }
+    }
+}
+/**
+ * A class representing an assertion implemented as a function.
+ *
+ * This function may:
+ *
+ * 1. Return a `boolean` indicating pass/fail.
+ * 2. Return a `ZodType` which will be used to validate the subject.
+ * 3. Return a `Promise` resolving to either of the above (when called via
+ *    {@link expectAsync})
+ * 4. Throw a {@link AssertionError}; when called via {@link expectAsync}, reject
+ *    with an {@link AssertionError}
+ */
+export class BupkisAssertionSchemaAsync extends BupkisAssertionAsync {
+    async executeAsync(parsedValues, _args, stackStartFn, parseResult) {
+        // Check if we have cached validation result from parseValuesAsync
+        const cachedValidation = parseResult?.success
+            ? parseResult.subjectValidationResult
+            : undefined;
+        if (cachedValidation && !cachedValidation.success) {
+            // Subject validation failed during parseValuesAsync, throw the cached error
+            if ('error' in cachedValidation) {
+                throw this.fromZodError(cachedValidation.error, stackStartFn, parsedValues);
+            }
+        }
+        // Fall back to standard validation if no cached result
+        const [subject] = parsedValues;
+        try {
+            await this.impl.parseAsync(subject);
+        }
+        catch (error) {
+            if (isA(error, z.ZodError)) {
+                throw this.fromZodError(error, stackStartFn, parsedValues);
+            }
+            /* c8 ignore next */
+            throw error;
+        }
+    }
+    async parseValuesAsync(args) {
+        const { slots } = this;
+        const parsedValues = [];
+        const mismatch = this.maybeParseValuesArgMismatch(args);
+        if (mismatch) {
+            return mismatch;
+        }
+        let exactMatch = true;
+        let subjectValidationResult;
+        for (let i = 0; i < slots.length; i++) {
+            const slot = slots[i];
+            const arg = args[i];
+            const parsedLiteralResult = this.parseSlotForLiteral(slot, i, arg);
+            if (parsedLiteralResult === true) {
+                continue;
+            }
+            else if (parsedLiteralResult !== false) {
+                return parsedLiteralResult;
+            }
+            // For the subject slot (first slot if it's unknown/any), try optimized validation
+            if (i === 0 &&
+                (slot.def.type === 'unknown' || slot.def.type === 'any') &&
+                this.isSimpleSchemaAssertion()) {
+                try {
+                    const result = await this.impl.parseAsync(arg);
+                    subjectValidationResult = { data: result, success: true };
+                    parsedValues.push(result); // Use validated data
+                }
+                catch (error) {
+                    if (isA(error, z.ZodError)) {
+                        subjectValidationResult = { error, success: false };
+                        parsedValues.push(arg); // Keep original for error reporting
+                    }
+                    else {
+                        throw error; // Re-throw non-Zod errors
+                    }
+                }
+                exactMatch = false; // Subject was validated, so we know the exact type
+                continue;
+            }
+            // Standard slot processing for non-optimized cases
+            if (slot.def.type === 'unknown' || slot.def.type === 'any') {
+                parsedValues.push(arg);
+                exactMatch = false;
+                continue;
+            }
+            const result = await slot.safeParseAsync(arg);
+            if (!result.success) {
+                return {
+                    success: false,
+                };
+            }
+            parsedValues.push(result.data);
+        }
+        const result = {
+            exactMatch,
+            parsedValues: parsedValues,
+            success: true,
+        };
+        // Add cached validation result if we performed optimization
+        if (subjectValidationResult) {
+            result.subjectValidationResult = subjectValidationResult;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=assertion-async.js.map

package/dist/assertion/assertion-async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion-async.js","sourceRoot":"","sources":["../../src/assertion/assertion-async.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,4BAA4B,EAAE,oBAAoB;AAC3E,OAAO,EACL,GAAG,EACH,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,SAAS,GACV,qBAAqB;AACtB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,GACxB,8BAA8B;AAe/B,OAAO,EAAE,eAAe,EAAE,uBAAuB;AACjD,OAAO,EAAE,sBAAsB,EAAE,sCAAsC;AAEvE,MAAM,OAAgB,oBAKpB,SAAQ,eAAmC;IAU3C,KAAK,CAAC,gBAAgB,CACpB,IAAU;QAEV,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,MAAM,YAAY,GAAU,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QACD,IAAI,UAAU,GAAG,IAAI,CAAC;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAEpB,MAAM,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;YACnE,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;gBACjC,SAAS;YACX,CAAC;iBAAM,IAAI,mBAAmB,KAAK,KAAK,EAAE,CAAC;gBACzC,OAAO,mBAAmB,CAAC;YAC7B,CAAC;YAED,8BAA8B;YAC9B,mEAAmE;YACnE,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBAC3D,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACvB,UAAU,GAAG,KAAK,CAAC;gBACnB,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO;oBACL,OAAO,EAAE,KAAK;iBACf,CAAC;YACJ,CAAC;YACD,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,OAAO;YACL,UAAU;YACV,YAAY,EAAE,YAA8C;YAC5D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;CACF;AACD;;;;GAIG;AACH;;;;;;;;GAQG;AAEH,MAAM,OAAO,4BAKX,SAAQ,oBAAwC;IAGvC,KAAK,CAAC,YAAY,CACzB,YAAiC,EACjC,IAAe,EACf,YAAqC,EACrC,YAAkC;QAElC,IAAI,MAAwC,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,GAAG,MAAO,IAAI,CAAC,IAAoC,CAAC,IAAI,CAC5D,IAAI;YACJ,iEAAiE;YACjE,GAAI,YAAoB,CACzB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,cAAc,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzC,MAAM,GAAG,CAAC;YACZ,CAAC;YACD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC9C,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;YAC3D,CAAC;YACD,MAAM,IAAI,4BAA4B,CACpC,0CAA0C,IAAI,KAAK,GAAG,EAAE,EACxD,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;QACJ,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC3B,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;gBAC7D,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;aAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YACvE,MAAM,WAAW,GACf,gBAAgB,YAAY,OAAO;gBACjC,CAAC,CAAC,MAAM,gBAAgB;gBACxB,CAAC,CAAC,gBAAgB,CAAC;YAEvB,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;gBACvB,MAAM,IAAI,CAAC,wBAAwB,CACjC,WAAW,CAAC,MAAM,EAClB,YAAY,EACZ,YAAY,CACb,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,cAAc,CAAC;oBACvB,EAAE,EAAE,IAAI,CAAC,EAAE;oBACX,OAAO,EAAE,aAAa,IAAI,0BAA0B,OAAO,CAAC,IAAI,CAAC,EAAE;iBACpE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC3D,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;QAC9D,CAAC;aAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;YAChD,MAAM,WAAW,GAAG,MAAM,IAAI,WAAW,CAAC;YAE1C,IAAI,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC3B,IAAI,SAAwC,CAAC;gBAC7C,IAAI,MAAM,EAAE,CAAC;oBACX,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC7C,CAAC;qBAAM,CAAC;oBACN,SAAS,GAAG,MAAM,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;gBACxD,CAAC;gBACD,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;oBACvB,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;iBAAM,IAAI,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAAC;gBACzC,MAAM,gBAAgB,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACpE,MAAM,WAAW,GACf,gBAAgB,YAAY,OAAO;oBACjC,CAAC,CAAC,MAAM,gBAAgB;oBACxB,CAAC,CAAC,gBAAgB,CAAC;gBAEvB,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;oBACvB,MAAM,IAAI,CAAC,wBAAwB,CACjC,WAAW,CAAC,MAAM,EAClB,YAAY,EACZ,OAAO,CACR,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,UAAU,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;YAClD,MAAM,WAAW,GACf,MAAM,CAAC,OAAO;gBACd,aAAa,IAAI,0BAA0B,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAG,UAAU;gBACxB,CAAC,CAAC,GAAG,WAAW,KAAK,UAAU,EAAE;gBACjC,CAAC,CAAC,WAAW,CAAC;YAEhB,MAAM,IAAI,cAAc,CAAC;gBACvB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,OAAO;aACR,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,MAAiB,EAAE,CAAC;YAC7B,MAAM,IAAI,4BAA4B,CACpC,sCAAsC,IAAI,kDAAkD,EAC5F,EAAE,MAAM,EAAE,CACX,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AAEH,MAAM,OAAO,0BAKX,SAAQ,oBAAwC;IAGvC,KAAK,CAAC,YAAY,CACzB,YAAiC,EACjC,KAAgB,EAChB,YAAqC,EACrC,WAAiC;QAEjC,kEAAkE;QAClE,MAAM,gBAAgB,GAAG,WAAW,EAAE,OAAO;YAC3C,CAAC,CAAC,WAAW,CAAC,uBAAuB;YACrC,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,gBAAgB,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAClD,4EAA4E;YAC5E,IAAI,OAAO,IAAI,gBAAgB,EAAE,CAAC;gBAChC,MAAM,IAAI,CAAC,YAAY,CACrB,gBAAgB,CAAC,KAAK,EACtB,YAAY,EACZ,YAAY,CACb,CAAC;YACJ,CAAC;QACH,CAAC;QAED,uDAAuD;QACvD,MAAM,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;YAC7D,CAAC;YACD,oBAAoB;YACpB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEQ,KAAK,CAAC,gBAAgB,CAC7B,IAAU;QAEV,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,MAAM,YAAY,GAAU,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,UAAU,GAAG,IAAI,CAAC;QACtB,IAAI,uBAA8E,CAAC;QAEnF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,MAAM,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;YACnE,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;gBACjC,SAAS;YACX,CAAC;iBAAM,IAAI,mBAAmB,KAAK,KAAK,EAAE,CAAC;gBACzC,OAAO,mBAAmB,CAAC;YAC7B,CAAC;YAED,kFAAkF;YAClF,IACE,CAAC,KAAK,CAAC;gBACP,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC;gBACxD,IAAI,CAAC,uBAAuB,EAAE,EAC9B,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC/C,uBAAuB,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;oBAC1D,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,qBAAqB;gBAClD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC3B,uBAAuB,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;wBACpD,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,oCAAoC;oBAC9D,CAAC;yBAAM,CAAC;wBACN,MAAM,KAAK,CAAC,CAAC,0BAA0B;oBACzC,CAAC;gBACH,CAAC;gBACD,UAAU,GAAG,KAAK,CAAC,CAAC,mDAAmD;gBACvE,SAAS;YACX,CAAC;YAED,mDAAmD;YACnD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBAC3D,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACvB,UAAU,GAAG,KAAK,CAAC;gBACnB,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO;oBACL,OAAO,EAAE,KAAK;iBACf,CAAC;YACJ,CAAC;YACD,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,MAAM,GAA+B;YACzC,UAAU;YACV,YAAY,EAAE,YAA8C;YAC5D,OAAO,EAAE,IAAI;SACd,CAAC;QAEF,4DAA4D;QAC5D,IAAI,uBAAuB,EAAE,CAAC;YAC5B,MAAM,CAAC,uBAAuB,GAAG,uBAAuB,CAAC;QAC3D,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/assertion/assertion-standard-schema-async.cjs

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * Asynchronous Standard Schema assertion implementation.
+ *
+ * This module provides the `BupkisAssertionStandardSchemaAsync` class for
+ * assertions implemented using Standard Schema v1 compliant validators that may
+ * perform asynchronous validation.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BupkisAssertionStandardSchemaAsync = void 0;
+const assertion_js_1 = require("./assertion.cjs");
+/**
+ * An asynchronous assertion implemented using a Standard Schema v1 validator.
+ *
+ * This class handles async schema-based assertions where the implementation is
+ * any Standard Schema compliant validator that may perform asynchronous
+ * validation. It optimizes validation by caching the subject validation result
+ * during `parseValuesAsync()` to avoid double parsing.
+ *
+ * @template Parts - The assertion parts tuple defining structure
+ * @template Impl - The Standard Schema implementation
+ * @template Slots - The derived validation slots
+ */
+class BupkisAssertionStandardSchemaAsync extends assertion_js_1.BupkisAssertion {
+    /**
+     * Executes the assertion asynchronously against validated values.
+     *
+     * If validation was already performed during `parseValuesAsync()` and cached,
+     * reuses that result. Otherwise, performs validation using the Standard
+     * Schema's validate() method (which may return a Promise).
+     *
+     * @param parsedValues - The parsed and validated values
+     * @param _args - Original raw arguments (unused)
+     * @param stackStartFn - Function to use as stack trace start point
+     * @param parseResult - Optional cached parse result from `parseValuesAsync()`
+     * @throws {AssertionError} If validation fails
+     */
+    async executeAsync(parsedValues, _args, stackStartFn, parseResult) {
+        const cachedValidation = parseResult?.success
+            ? parseResult.subjectValidationResult
+            : undefined;
+        if (cachedValidation && !cachedValidation.success) {
+            if ('issues' in cachedValidation) {
+                throw this.fromStandardSchemaIssues(cachedValidation.issues, stackStartFn, parsedValues);
+            }
+        }
+        const [subject] = parsedValues;
+        const result = this.impl['~standard'].validate(subject);
+        const validationResult = result instanceof Promise ? await result : result;
+        if (validationResult.issues) {
+            throw this.fromStandardSchemaIssues(validationResult.issues, stackStartFn, parsedValues);
+        }
+    }
+    /**
+     * Parses raw arguments asynchronously against slots with optimized caching.
+     *
+     * For simple schema assertions (subject + phrase literals only), this method
+     * validates the subject during parsing and caches the result to avoid double
+     * validation in `executeAsync()`.
+     *
+     * @param args - Raw arguments provided to `expectAsync()`
+     * @returns Promise resolving to parse result with cached validation
+     */
+    async parseValuesAsync(args) {
+        const { slots } = this;
+        const parsedValues = [];
+        const mismatch = this.maybeParseValuesArgMismatch(args);
+        if (mismatch) {
+            return mismatch;
+        }
+        let exactMatch = true;
+        let subjectValidationResult;
+        for (let i = 0; i < slots.length; i++) {
+            const slot = slots[i];
+            const arg = args[i];
+            const parsedLiteralResult = this.parseSlotForLiteral(slot, i, arg);
+            if (parsedLiteralResult === true) {
+                continue;
+            }
+            else if (parsedLiteralResult !== false) {
+                return parsedLiteralResult;
+            }
+            if (i === 0 &&
+                (slot.def.type === 'unknown' || slot.def.type === 'any') &&
+                this.isSimpleSchemaAssertion()) {
+                const result = this.impl['~standard'].validate(arg);
+                const validationResult = result instanceof Promise ? await result : result;
+                if (validationResult.issues) {
+                    subjectValidationResult = {
+                        issues: validationResult.issues,
+                        success: false,
+                    };
+                    parsedValues.push(arg);
+                }
+                else {
+                    subjectValidationResult = {
+                        data: validationResult.value,
+                        success: true,
+                    };
+                    parsedValues.push(validationResult.value);
+                }
+                exactMatch = false;
+                continue;
+            }
+            if (slot.def.type === 'unknown' || slot.def.type === 'any') {
+                parsedValues.push(arg);
+                exactMatch = false;
+                continue;
+            }
+            const result = await slot.safeParseAsync(arg);
+            if (!result.success) {
+                return {
+                    success: false,
+                };
+            }
+            parsedValues.push(result.data);
+        }
+        const result = {
+            exactMatch,
+            parsedValues: parsedValues,
+            success: true,
+        };
+        if (subjectValidationResult) {
+            result.subjectValidationResult = subjectValidationResult;
+        }
+        return result;
+    }
+}
+exports.BupkisAssertionStandardSchemaAsync = BupkisAssertionStandardSchemaAsync;
+//# sourceMappingURL=assertion-standard-schema-async.js.map

package/dist/assertion/assertion-standard-schema-async.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion-standard-schema-async.js","sourceRoot":"","sources":["../../src/assertion/assertion-standard-schema-async.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAYH,kDAAiD;AAEjD;;;;;;;;;;;GAWG;AACH,MAAa,kCAKX,SAAQ,8BAAmC;IAG3C;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,YAAY,CAChB,YAAiC,EACjC,KAAgB,EAChB,YAAqC,EACrC,WAAiC;QAEjC,MAAM,gBAAgB,GAAG,WAAW,EAAE,OAAO;YAC3C,CAAC,CAAC,WAAW,CAAC,uBAAuB;YACrC,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,gBAAgB,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAClD,IAAI,QAAQ,IAAI,gBAAgB,EAAE,CAAC;gBACjC,MAAM,IAAI,CAAC,wBAAwB,CACjC,gBAAgB,CAAC,MAAM,EACvB,YAAY,EACZ,YAAY,CACb,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,gBAAgB,GAAG,MAAM,YAAY,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QAE3E,IAAI,gBAAgB,CAAC,MAAM,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,wBAAwB,CACjC,gBAAgB,CAAC,MAAM,EACvB,YAAY,EACZ,YAAY,CACb,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,gBAAgB,CACpB,IAAU;QAEV,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,MAAM,YAAY,GAAU,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,UAAU,GAAG,IAAI,CAAC;QACtB,IAAI,uBAA8E,CAAC;QAEnF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,MAAM,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;YACnE,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;gBACjC,SAAS;YACX,CAAC;iBAAM,IAAI,mBAAmB,KAAK,KAAK,EAAE,CAAC;gBACzC,OAAO,mBAAmB,CAAC;YAC7B,CAAC;YAED,IACE,CAAC,KAAK,CAAC;gBACP,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC;gBACxD,IAAI,CAAC,uBAAuB,EAAE,EAC9B,CAAC;gBACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACpD,MAAM,gBAAgB,GACpB,MAAM,YAAY,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;gBAEpD,IAAI,gBAAgB,CAAC,MAAM,EAAE,CAAC;oBAC5B,uBAAuB,GAAG;wBACxB,MAAM,EAAE,gBAAgB,CAAC,MAAM;wBAC/B,OAAO,EAAE,KAAK;qBACf,CAAC;oBACF,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACzB,CAAC;qBAAM,CAAC;oBACN,uBAAuB,GAAG;wBACxB,IAAI,EAAE,gBAAgB,CAAC,KAAK;wBAC5B,OAAO,EAAE,IAAI;qBACd,CAAC;oBACF,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBAC5C,CAAC;gBACD,UAAU,GAAG,KAAK,CAAC;gBACnB,SAAS;YACX,CAAC;YAED,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBAC3D,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACvB,UAAU,GAAG,KAAK,CAAC;gBACnB,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO;oBACL,OAAO,EAAE,KAAK;iBACf,CAAC;YACJ,CAAC;YACD,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,MAAM,GAA+B;YACzC,UAAU;YACV,YAAY,EAAE,YAA8C;YAC5D,OAAO,EAAE,IAAI;SACd,CAAC;QAEF,IAAI,uBAAuB,EAAE,CAAC;YAC5B,MAAM,CAAC,uBAAuB,GAAG,uBAAuB,CAAC;QAC3D,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA5ID,gFA4IC"}

package/dist/assertion/assertion-standard-schema-async.d.cts

@@ -0,0 +1,52 @@
+/**
+ * Asynchronous Standard Schema assertion implementation.
+ *
+ * This module provides the `BupkisAssertionStandardSchemaAsync` class for
+ * assertions implemented using Standard Schema v1 compliant validators that may
+ * perform asynchronous validation.
+ *
+ * @packageDocumentation
+ */
+import type { StandardSchemaV1 } from "../standard-schema.cjs";
+import type { AssertionParts, AssertionSlots, AssertionStandardSchemaAsync, ParsedResult, ParsedValues } from "./assertion-types.cjs";
+import { BupkisAssertion } from "./assertion.cjs";
+/**
+ * An asynchronous assertion implemented using a Standard Schema v1 validator.
+ *
+ * This class handles async schema-based assertions where the implementation is
+ * any Standard Schema compliant validator that may perform asynchronous
+ * validation. It optimizes validation by caching the subject validation result
+ * during `parseValuesAsync()` to avoid double parsing.
+ *
+ * @template Parts - The assertion parts tuple defining structure
+ * @template Impl - The Standard Schema implementation
+ * @template Slots - The derived validation slots
+ */
+export declare class BupkisAssertionStandardSchemaAsync<Parts extends AssertionParts, Impl extends StandardSchemaV1, Slots extends AssertionSlots<Parts>> extends BupkisAssertion<Parts, Impl, Slots> implements AssertionStandardSchemaAsync<Parts, Impl, Slots> {
+    /**
+     * Executes the assertion asynchronously against validated values.
+     *
+     * If validation was already performed during `parseValuesAsync()` and cached,
+     * reuses that result. Otherwise, performs validation using the Standard
+     * Schema's validate() method (which may return a Promise).
+     *
+     * @param parsedValues - The parsed and validated values
+     * @param _args - Original raw arguments (unused)
+     * @param stackStartFn - Function to use as stack trace start point
+     * @param parseResult - Optional cached parse result from `parseValuesAsync()`
+     * @throws {AssertionError} If validation fails
+     */
+    executeAsync(parsedValues: ParsedValues<Parts>, _args: unknown[], stackStartFn: (...args: any[]) => any, parseResult?: ParsedResult<Parts>): Promise<void>;
+    /**
+     * Parses raw arguments asynchronously against slots with optimized caching.
+     *
+     * For simple schema assertions (subject + phrase literals only), this method
+     * validates the subject during parsing and caches the result to avoid double
+     * validation in `executeAsync()`.
+     *
+     * @param args - Raw arguments provided to `expectAsync()`
+     * @returns Promise resolving to parse result with cached validation
+     */
+    parseValuesAsync<Args extends readonly unknown[]>(args: Args): Promise<ParsedResult<Parts>>;
+}
+//# sourceMappingURL=assertion-standard-schema-async.d.ts.map

package/dist/assertion/assertion-standard-schema-async.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion-standard-schema-async.d.ts","sourceRoot":"","sources":["../../src/assertion/assertion-standard-schema-async.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,+BAA8B;AAC9D,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,4BAA4B,EAC5B,YAAY,EAEZ,YAAY,EACb,8BAA6B;AAE9B,OAAO,EAAE,eAAe,EAAE,wBAAuB;AAEjD;;;;;;;;;;;GAWG;AACH,qBAAa,kCAAkC,CAC7C,KAAK,SAAS,cAAc,EAC5B,IAAI,SAAS,gBAAgB,EAC7B,KAAK,SAAS,cAAc,CAAC,KAAK,CAAC,CAEnC,SAAQ,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAC1C,YAAW,4BAA4B,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC;IAE3D;;;;;;;;;;;;OAYG;IACG,YAAY,CAChB,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,EACjC,KAAK,EAAE,OAAO,EAAE,EAChB,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACrC,WAAW,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC;IA4BhB;;;;;;;;;OASG;IACG,gBAAgB,CAAC,IAAI,SAAS,SAAS,OAAO,EAAE,EACpD,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;CA0EhC"}

package/dist/assertion/assertion-standard-schema-async.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Asynchronous Standard Schema assertion implementation.
+ *
+ * This module provides the `BupkisAssertionStandardSchemaAsync` class for
+ * assertions implemented using Standard Schema v1 compliant validators that may
+ * perform asynchronous validation.
+ *
+ * @packageDocumentation
+ */
+import type { StandardSchemaV1 } from "../standard-schema.js";
+import type { AssertionParts, AssertionSlots, AssertionStandardSchemaAsync, ParsedResult, ParsedValues } from "./assertion-types.js";
+import { BupkisAssertion } from "./assertion.js";
+/**
+ * An asynchronous assertion implemented using a Standard Schema v1 validator.
+ *
+ * This class handles async schema-based assertions where the implementation is
+ * any Standard Schema compliant validator that may perform asynchronous
+ * validation. It optimizes validation by caching the subject validation result
+ * during `parseValuesAsync()` to avoid double parsing.
+ *
+ * @template Parts - The assertion parts tuple defining structure
+ * @template Impl - The Standard Schema implementation
+ * @template Slots - The derived validation slots
+ */
+export declare class BupkisAssertionStandardSchemaAsync<Parts extends AssertionParts, Impl extends StandardSchemaV1, Slots extends AssertionSlots<Parts>> extends BupkisAssertion<Parts, Impl, Slots> implements AssertionStandardSchemaAsync<Parts, Impl, Slots> {
+    /**
+     * Executes the assertion asynchronously against validated values.
+     *
+     * If validation was already performed during `parseValuesAsync()` and cached,
+     * reuses that result. Otherwise, performs validation using the Standard
+     * Schema's validate() method (which may return a Promise).
+     *
+     * @param parsedValues - The parsed and validated values
+     * @param _args - Original raw arguments (unused)
+     * @param stackStartFn - Function to use as stack trace start point
+     * @param parseResult - Optional cached parse result from `parseValuesAsync()`
+     * @throws {AssertionError} If validation fails
+     */
+    executeAsync(parsedValues: ParsedValues<Parts>, _args: unknown[], stackStartFn: (...args: any[]) => any, parseResult?: ParsedResult<Parts>): Promise<void>;
+    /**
+     * Parses raw arguments asynchronously against slots with optimized caching.
+     *
+     * For simple schema assertions (subject + phrase literals only), this method
+     * validates the subject during parsing and caches the result to avoid double
+     * validation in `executeAsync()`.
+     *
+     * @param args - Raw arguments provided to `expectAsync()`
+     * @returns Promise resolving to parse result with cached validation
+     */
+    parseValuesAsync<Args extends readonly unknown[]>(args: Args): Promise<ParsedResult<Parts>>;
+}
+//# sourceMappingURL=assertion-standard-schema-async.d.ts.map

package/dist/assertion/assertion-standard-schema-async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion-standard-schema-async.d.ts","sourceRoot":"","sources":["../../src/assertion/assertion-standard-schema-async.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,8BAA8B;AAC9D,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,4BAA4B,EAC5B,YAAY,EAEZ,YAAY,EACb,6BAA6B;AAE9B,OAAO,EAAE,eAAe,EAAE,uBAAuB;AAEjD;;;;;;;;;;;GAWG;AACH,qBAAa,kCAAkC,CAC7C,KAAK,SAAS,cAAc,EAC5B,IAAI,SAAS,gBAAgB,EAC7B,KAAK,SAAS,cAAc,CAAC,KAAK,CAAC,CAEnC,SAAQ,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAC1C,YAAW,4BAA4B,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC;IAE3D;;;;;;;;;;;;OAYG;IACG,YAAY,CAChB,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,EACjC,KAAK,EAAE,OAAO,EAAE,EAChB,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACrC,WAAW,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC;IA4BhB;;;;;;;;;OASG;IACG,gBAAgB,CAAC,IAAI,SAAS,SAAS,OAAO,EAAE,EACpD,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;CA0EhC"}

package/dist/assertion/assertion-standard-schema-async.js

@@ -0,0 +1,128 @@
+/**
+ * Asynchronous Standard Schema assertion implementation.
+ *
+ * This module provides the `BupkisAssertionStandardSchemaAsync` class for
+ * assertions implemented using Standard Schema v1 compliant validators that may
+ * perform asynchronous validation.
+ *
+ * @packageDocumentation
+ */
+import { BupkisAssertion } from "./assertion.js";
+/**
+ * An asynchronous assertion implemented using a Standard Schema v1 validator.
+ *
+ * This class handles async schema-based assertions where the implementation is
+ * any Standard Schema compliant validator that may perform asynchronous
+ * validation. It optimizes validation by caching the subject validation result
+ * during `parseValuesAsync()` to avoid double parsing.
+ *
+ * @template Parts - The assertion parts tuple defining structure
+ * @template Impl - The Standard Schema implementation
+ * @template Slots - The derived validation slots
+ */
+export class BupkisAssertionStandardSchemaAsync extends BupkisAssertion {
+    /**
+     * Executes the assertion asynchronously against validated values.
+     *
+     * If validation was already performed during `parseValuesAsync()` and cached,
+     * reuses that result. Otherwise, performs validation using the Standard
+     * Schema's validate() method (which may return a Promise).
+     *
+     * @param parsedValues - The parsed and validated values
+     * @param _args - Original raw arguments (unused)
+     * @param stackStartFn - Function to use as stack trace start point
+     * @param parseResult - Optional cached parse result from `parseValuesAsync()`
+     * @throws {AssertionError} If validation fails
+     */
+    async executeAsync(parsedValues, _args, stackStartFn, parseResult) {
+        const cachedValidation = parseResult?.success
+            ? parseResult.subjectValidationResult
+            : undefined;
+        if (cachedValidation && !cachedValidation.success) {
+            if ('issues' in cachedValidation) {
+                throw this.fromStandardSchemaIssues(cachedValidation.issues, stackStartFn, parsedValues);
+            }
+        }
+        const [subject] = parsedValues;
+        const result = this.impl['~standard'].validate(subject);
+        const validationResult = result instanceof Promise ? await result : result;
+        if (validationResult.issues) {
+            throw this.fromStandardSchemaIssues(validationResult.issues, stackStartFn, parsedValues);
+        }
+    }
+    /**
+     * Parses raw arguments asynchronously against slots with optimized caching.
+     *
+     * For simple schema assertions (subject + phrase literals only), this method
+     * validates the subject during parsing and caches the result to avoid double
+     * validation in `executeAsync()`.
+     *
+     * @param args - Raw arguments provided to `expectAsync()`
+     * @returns Promise resolving to parse result with cached validation
+     */
+    async parseValuesAsync(args) {
+        const { slots } = this;
+        const parsedValues = [];
+        const mismatch = this.maybeParseValuesArgMismatch(args);
+        if (mismatch) {
+            return mismatch;
+        }
+        let exactMatch = true;
+        let subjectValidationResult;
+        for (let i = 0; i < slots.length; i++) {
+            const slot = slots[i];
+            const arg = args[i];
+            const parsedLiteralResult = this.parseSlotForLiteral(slot, i, arg);
+            if (parsedLiteralResult === true) {
+                continue;
+            }
+            else if (parsedLiteralResult !== false) {
+                return parsedLiteralResult;
+            }
+            if (i === 0 &&
+                (slot.def.type === 'unknown' || slot.def.type === 'any') &&
+                this.isSimpleSchemaAssertion()) {
+                const result = this.impl['~standard'].validate(arg);
+                const validationResult = result instanceof Promise ? await result : result;
+                if (validationResult.issues) {
+                    subjectValidationResult = {
+                        issues: validationResult.issues,
+                        success: false,
+                    };
+                    parsedValues.push(arg);
+                }
+                else {
+                    subjectValidationResult = {
+                        data: validationResult.value,
+                        success: true,
+                    };
+                    parsedValues.push(validationResult.value);
+                }
+                exactMatch = false;
+                continue;
+            }
+            if (slot.def.type === 'unknown' || slot.def.type === 'any') {
+                parsedValues.push(arg);
+                exactMatch = false;
+                continue;
+            }
+            const result = await slot.safeParseAsync(arg);
+            if (!result.success) {
+                return {
+                    success: false,
+                };
+            }
+            parsedValues.push(result.data);
+        }
+        const result = {
+            exactMatch,
+            parsedValues: parsedValues,
+            success: true,
+        };
+        if (subjectValidationResult) {
+            result.subjectValidationResult = subjectValidationResult;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=assertion-standard-schema-async.js.map

package/dist/assertion/assertion-standard-schema-async.js.map

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