@solidxai/core 0.1.2 → 0.1.5-beta.0

package/dist/testing/steps/api/request.step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.step.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/api/request.step.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AA8NxD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAoInE"}

package/dist/testing/steps/api/request.step.js

@@ -0,0 +1,281 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerApiRequestStep = registerApiRequestStep;
+const attachments_1 = require("../../reporter/attachments");
+const form_data_1 = __importDefault(require("form-data"));
+const crypto_1 = __importDefault(require("crypto"));
+const fs_1 = __importDefault(require("fs"));
+const https_1 = __importDefault(require("https"));
+const path_1 = __importDefault(require("path"));
+const qs_1 = __importDefault(require("qs"));
+const TMP_DIR = "/tmp/.solidx-testing-files";
+const MAX_REDIRECTS = 5;
+function isPlainObject(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function deepMerge(target, source) {
+    if (isPlainObject(target) && isPlainObject(source)) {
+        const out = { ...target };
+        for (const [key, value] of Object.entries(source)) {
+            if (key in out) {
+                out[key] = deepMerge(out[key], value);
+            }
+            else {
+                out[key] = value;
+            }
+        }
+        return out;
+    }
+    return source;
+}
+function stripUndefined(value) {
+    if (Array.isArray(value)) {
+        return value.map(stripUndefined);
+    }
+    if (isPlainObject(value)) {
+        const out = {};
+        for (const [key, val] of Object.entries(value)) {
+            if (val === undefined)
+                continue;
+            out[key] = stripUndefined(val);
+        }
+        return out;
+    }
+    return value;
+}
+function ensureTmpDir() {
+    fs_1.default.mkdirSync(TMP_DIR, { recursive: true });
+}
+function buildTempFilePath(urlObj) {
+    const ext = path_1.default.extname(urlObj.pathname);
+    const base = path_1.default.basename(urlObj.pathname, ext) || "file";
+    const safeBase = base.replace(/[^a-zA-Z0-9-_]/g, "_");
+    const suffix = `${Date.now()}-${crypto_1.default.randomBytes(6).toString("hex")}`;
+    return path_1.default.join(TMP_DIR, `${safeBase}-${suffix}${ext}`);
+}
+function downloadUrlToFile(urlValue, redirectCount = 0) {
+    if (!urlValue.startsWith("https://")) {
+        throw new Error(`Only https URLs are allowed for file downloads: ${urlValue}`);
+    }
+    if (redirectCount > MAX_REDIRECTS) {
+        throw new Error(`Too many redirects while downloading file: ${urlValue}`);
+    }
+    const urlObj = new URL(urlValue);
+    ensureTmpDir();
+    const filePath = buildTempFilePath(urlObj);
+    return new Promise((resolve, reject) => {
+        const fileStream = fs_1.default.createWriteStream(filePath);
+        const request = https_1.default.get(urlObj, (response) => {
+            const status = response.statusCode ?? 0;
+            const location = response.headers.location;
+            if (status >= 300 && status < 400 && location) {
+                response.resume();
+                fileStream.close(() => fs_1.default.unlink(filePath, () => { }));
+                const nextUrl = new URL(location, urlObj).toString();
+                downloadUrlToFile(nextUrl, redirectCount + 1).then(resolve).catch(reject);
+                return;
+            }
+            if (status >= 400) {
+                response.resume();
+                fileStream.close(() => fs_1.default.unlink(filePath, () => { }));
+                reject(new Error(`Failed to download file. HTTP ${status}`));
+                return;
+            }
+            response.pipe(fileStream);
+        });
+        request.on("error", (err) => {
+            fileStream.close(() => fs_1.default.unlink(filePath, () => { }));
+            reject(err);
+        });
+        fileStream.on("error", (err) => {
+            request.destroy();
+            fs_1.default.unlink(filePath, () => { });
+            reject(err);
+        });
+        fileStream.on("finish", () => {
+            fileStream.close(() => resolve(filePath));
+        });
+    });
+}
+function resolveFilePath(rawValue) {
+    const value = rawValue.startsWith("file:") ? rawValue.slice(5) : rawValue;
+    if (!value) {
+        throw new Error('Invalid file reference. Use "file:/absolute/path".');
+    }
+    if (!path_1.default.isAbsolute(value)) {
+        throw new Error(`File path must be absolute: ${value}`);
+    }
+    if (!fs_1.default.existsSync(value)) {
+        throw new Error(`File does not exist: ${value}`);
+    }
+    return value;
+}
+async function resolveFileReference(rawValue) {
+    if (rawValue.startsWith("url:")) {
+        const urlValue = rawValue.slice(4);
+        if (!urlValue) {
+            throw new Error('Invalid url reference. Use "url:https://...".');
+        }
+        const filePath = await downloadUrlToFile(urlValue);
+        return { filePath, source: "url", url: urlValue };
+    }
+    return { filePath: resolveFilePath(rawValue), source: "file" };
+}
+function formItemsFromRecord(record) {
+    return Object.entries(record).map(([name, value]) => {
+        if (typeof value === "string" && (value.startsWith("file:") || value.startsWith("url:"))) {
+            return { name, value, type: "file" };
+        }
+        return { name, value };
+    });
+}
+async function buildFormData(items) {
+    const form = new form_data_1.default();
+    const logItems = [];
+    for (const item of items) {
+        if (!item?.name) {
+            throw new Error('Form item is missing required "name".');
+        }
+        const rawValue = item.value;
+        const isFile = item.type === "file" || (typeof rawValue === "string" && (rawValue.startsWith("file:") || rawValue.startsWith("url:")));
+        if (isFile) {
+            if (typeof rawValue !== "string") {
+                throw new Error(`Form file value must be a string for field: ${item.name}`);
+            }
+            const resolved = await resolveFileReference(rawValue);
+            const filename = item.filename ?? path_1.default.basename(resolved.filePath);
+            form.append(item.name, fs_1.default.createReadStream(resolved.filePath), {
+                filename,
+                contentType: item.contentType,
+            });
+            logItems.push({
+                name: item.name,
+                type: "file",
+                source: resolved.source,
+                url: resolved.url,
+                path: resolved.filePath,
+                filename,
+                contentType: item.contentType,
+            });
+        }
+        else {
+            const textValue = rawValue === undefined || rawValue === null ? "" : typeof rawValue === "string" ? rawValue : JSON.stringify(rawValue);
+            form.append(item.name, textValue);
+            logItems.push({
+                name: item.name,
+                type: "text",
+                value: textValue,
+            });
+        }
+    }
+    return { form, logItems };
+}
+function registerApiRequestStep(registry) {
+    registry.register("api.request", async (ctx, step) => {
+        if (!ctx.api) {
+            throw new Error('Missing API adapter on context for op "api.request"');
+        }
+        const input = (step.with ?? {});
+        if (!input.method) {
+            throw new Error('Missing "method" in step.with for op "api.request"');
+        }
+        if (!input.url) {
+            throw new Error('Missing "url" in step.with for op "api.request"');
+        }
+        const rawFormData = input.formData ?? input.body;
+        const formItems = Array.isArray(rawFormData) ? rawFormData : isPlainObject(rawFormData) ? formItemsFromRecord(rawFormData) : undefined;
+        if (rawFormData !== undefined && !formItems) {
+            throw new Error('formData/body must be an array of items or an object, for op "api.request".');
+        }
+        if (formItems && (input.json !== undefined || input.bodyText !== undefined)) {
+            throw new Error('Use either formData/body or json/bodyText, not both, for op "api.request".');
+        }
+        const rawUrl = input.url;
+        const absolute = /^[a-z][a-z0-9+.-]*:/i.test(rawUrl);
+        const urlObj = new URL(rawUrl, "http://solid.local");
+        const urlQuery = urlObj.search
+            ? qs_1.default.parse(urlObj.search, { ignoreQueryPrefix: true, allowDots: true, depth: 10 })
+            : {};
+        let stepQuery = {};
+        if (input.query !== undefined) {
+            stepQuery =
+                typeof input.query === "string"
+                    ? qs_1.default.parse(input.query, { ignoreQueryPrefix: true, allowDots: true, depth: 10 })
+                    : input.query;
+        }
+        const mergedQuery = deepMerge(urlQuery, stepQuery);
+        const queryString = qs_1.default.stringify(mergedQuery, { addQueryPrefix: true, allowDots: true });
+        urlObj.search = queryString;
+        const finalUrl = absolute
+            ? urlObj.toString()
+            : `${urlObj.pathname}${urlObj.search}${urlObj.hash}`;
+        let formData;
+        let formLogItems;
+        if (formItems) {
+            const built = await buildFormData(formItems);
+            formData = built.form;
+            formLogItems = built.logItems;
+        }
+        const req = {
+            method: input.method,
+            url: finalUrl,
+            headers: input.headers,
+            json: input.json,
+            bodyText: input.bodyText,
+            formData,
+        };
+        const startedAt = Date.now();
+        const printApiLogs = ctx.options?.printApiLogs ?? false;
+        const logName = `api.request ${req.method} ${finalUrl}`;
+        const requestLog = stripUndefined({
+            method: req.method,
+            url: finalUrl,
+            headers: req.headers,
+            query: mergedQuery,
+            queryString: urlObj.search ? urlObj.search.slice(1) : "",
+            json: input.json,
+            bodyText: input.bodyText,
+            formData: formLogItems,
+        });
+        let response;
+        try {
+            response = await ctx.api.http(req);
+        }
+        catch (err) {
+            if (printApiLogs) {
+                (0, attachments_1.attachJson)(ctx, logName, {
+                    request: requestLog,
+                    durationMs: Date.now() - startedAt,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+            throw err;
+        }
+        const durationMs = Date.now() - startedAt;
+        ctx.last = { ...(ctx.last ?? {}), apiResponse: response };
+        if (printApiLogs) {
+            const responseLog = stripUndefined({
+                status: response.status,
+                headers: response.headers,
+                bodyJson: response.bodyJson,
+                bodyText: response.bodyJson === undefined ? response.bodyText : undefined,
+            });
+            (0, attachments_1.attachJson)(ctx, logName, {
+                request: requestLog,
+                response: responseLog,
+                durationMs,
+            });
+        }
+        return {
+            status: response.status,
+            headers: response.headers,
+            bodyText: response.bodyText,
+            bodyJson: response.bodyJson,
+            body: response.bodyJson ?? response.bodyText,
+        };
+    });
+}
+//# sourceMappingURL=request.step.js.map

package/dist/testing/steps/api/request.step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.step.js","sourceRoot":"","sources":["../../../../src/testing/steps/api/request.step.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ApiRequestOptions } from \"../../adapters/api/api.types\";\nimport type { TestContext } from \"../../contracts/runtime-context.types\";\nimport type { OpStep } from \"../../contracts/testing-metadata.types\";\nimport { StepRegistry } from \"../../core/step-registry\";\nimport { attachJson } from \"../../reporter/attachments\";\nimport FormData from \"form-data\";\nimport crypto from \"crypto\";\nimport fs from \"fs\";\nimport https from \"https\";\nimport path from \"path\";\nimport qs from \"qs\";\n\nconst TMP_DIR = \"/tmp/.solidx-testing-files\";\nconst MAX_REDIRECTS = 5;\n\ntype ApiFormItem = {\n  name: string;\n  value: any;\n  type?: \"text\" | \"file\";\n  filename?: string;\n  contentType?: string;\n};\n\ntype ApiRequestInput = {\n  method: string;\n  url: string;\n  headers?: Record<string, string>;\n  json?: unknown;\n  bodyText?: string;\n  // Extra query params (object or querystring).\n  query?: Record<string, any> | string;\n  // Form data payload (array of items).\n  formData?: ApiFormItem[] | Record<string, any>;\n  // Alias for formData (array or object).\n  body?: ApiFormItem[] | Record<string, any>;\n};\n\nfunction isPlainObject(value: unknown): value is Record<string, any> {\n  // Only merge plain objects.\n  return !!value && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction deepMerge(target: any, source: any): any {\n  if (isPlainObject(target) && isPlainObject(source)) {\n    // Clone target to avoid mutation.\n    const out: Record<string, any> = { ...target };\n    for (const [key, value] of Object.entries(source)) {\n      if (key in out) {\n        // Merge nested keys.\n        out[key] = deepMerge(out[key], value);\n      } else {\n        // Add new keys.\n        out[key] = value;\n      }\n    }\n    // Return merged object.\n    return out;\n  }\n  // For non-objects, source wins.\n  return source;\n}\n\nfunction stripUndefined(value: any): any {\n  if (Array.isArray(value)) {\n    return value.map(stripUndefined);\n  }\n  if (isPlainObject(value)) {\n    const out: Record<string, any> = {};\n    for (const [key, val] of Object.entries(value)) {\n      if (val === undefined) continue;\n      out[key] = stripUndefined(val);\n    }\n    return out;\n  }\n  return value;\n}\n\nfunction ensureTmpDir(): void {\n  fs.mkdirSync(TMP_DIR, { recursive: true });\n}\n\nfunction buildTempFilePath(urlObj: URL): string {\n  const ext = path.extname(urlObj.pathname);\n  const base = path.basename(urlObj.pathname, ext) || \"file\";\n  const safeBase = base.replace(/[^a-zA-Z0-9-_]/g, \"_\");\n  const suffix = `${Date.now()}-${crypto.randomBytes(6).toString(\"hex\")}`;\n  return path.join(TMP_DIR, `${safeBase}-${suffix}${ext}`);\n}\n\nfunction downloadUrlToFile(urlValue: string, redirectCount: number = 0): Promise<string> {\n  if (!urlValue.startsWith(\"https://\")) {\n    throw new Error(`Only https URLs are allowed for file downloads: ${urlValue}`);\n  }\n  if (redirectCount > MAX_REDIRECTS) {\n    throw new Error(`Too many redirects while downloading file: ${urlValue}`);\n  }\n\n  const urlObj = new URL(urlValue);\n  ensureTmpDir();\n  const filePath = buildTempFilePath(urlObj);\n\n  return new Promise((resolve, reject) => {\n    const fileStream = fs.createWriteStream(filePath);\n\n    const request = https.get(urlObj, (response) => {\n      const status = response.statusCode ?? 0;\n      const location = response.headers.location;\n\n      if (status >= 300 && status < 400 && location) {\n        response.resume();\n        fileStream.close(() => fs.unlink(filePath, () => {}));\n        const nextUrl = new URL(location, urlObj).toString();\n        downloadUrlToFile(nextUrl, redirectCount + 1).then(resolve).catch(reject);\n        return;\n      }\n\n      if (status >= 400) {\n        response.resume();\n        fileStream.close(() => fs.unlink(filePath, () => {}));\n        reject(new Error(`Failed to download file. HTTP ${status}`));\n        return;\n      }\n\n      response.pipe(fileStream);\n    });\n\n    request.on(\"error\", (err) => {\n      fileStream.close(() => fs.unlink(filePath, () => {}));\n      reject(err);\n    });\n\n    fileStream.on(\"error\", (err) => {\n      request.destroy();\n      fs.unlink(filePath, () => {});\n      reject(err);\n    });\n\n    fileStream.on(\"finish\", () => {\n      fileStream.close(() => resolve(filePath));\n    });\n  });\n}\n\nfunction resolveFilePath(rawValue: string): string {\n  const value = rawValue.startsWith(\"file:\") ? rawValue.slice(5) : rawValue;\n  if (!value) {\n    throw new Error('Invalid file reference. Use \"file:/absolute/path\".');\n  }\n  if (!path.isAbsolute(value)) {\n    throw new Error(`File path must be absolute: ${value}`);\n  }\n  if (!fs.existsSync(value)) {\n    throw new Error(`File does not exist: ${value}`);\n  }\n  return value;\n}\n\nasync function resolveFileReference(rawValue: string): Promise<{ filePath: string; source: \"file\" | \"url\"; url?: string }>{\n  if (rawValue.startsWith(\"url:\")) {\n    const urlValue = rawValue.slice(4);\n    if (!urlValue) {\n      throw new Error('Invalid url reference. Use \"url:https://...\".');\n    }\n    const filePath = await downloadUrlToFile(urlValue);\n    return { filePath, source: \"url\", url: urlValue };\n  }\n\n  return { filePath: resolveFilePath(rawValue), source: \"file\" };\n}\n\nfunction formItemsFromRecord(record: Record<string, any>): ApiFormItem[] {\n  return Object.entries(record).map(([name, value]) => {\n    if (typeof value === \"string\" && (value.startsWith(\"file:\") || value.startsWith(\"url:\"))) {\n      return { name, value, type: \"file\" };\n    }\n    return { name, value };\n  });\n}\n\nasync function buildFormData(items: ApiFormItem[]): Promise<{ form: FormData; logItems: Record<string, any>[] }>{\n  const form = new FormData();\n  const logItems: Record<string, any>[] = [];\n\n  for (const item of items) {\n    if (!item?.name) {\n      throw new Error('Form item is missing required \"name\".');\n    }\n    const rawValue = item.value;\n    const isFile = item.type === \"file\" || (typeof rawValue === \"string\" && (rawValue.startsWith(\"file:\") || rawValue.startsWith(\"url:\")));\n\n    if (isFile) {\n      if (typeof rawValue !== \"string\") {\n        throw new Error(`Form file value must be a string for field: ${item.name}`);\n      }\n      const resolved = await resolveFileReference(rawValue);\n      const filename = item.filename ?? path.basename(resolved.filePath);\n      form.append(item.name, fs.createReadStream(resolved.filePath), {\n        filename,\n        contentType: item.contentType,\n      });\n      logItems.push({\n        name: item.name,\n        type: \"file\",\n        source: resolved.source,\n        url: resolved.url,\n        path: resolved.filePath,\n        filename,\n        contentType: item.contentType,\n      });\n    } else {\n      // TODO: Need to test the JSON.stringify(rawValue) functionality here...\n      // This scenario will happen only when we try to create embedded one-to-many or many-to-one objects in create API calls...\n      const textValue = rawValue === undefined || rawValue === null ? \"\" : typeof rawValue === \"string\" ? rawValue : JSON.stringify(rawValue);\n      form.append(item.name, textValue);\n      logItems.push({\n        name: item.name,\n        type: \"text\",\n        value: textValue,\n      });\n    }\n  }\n\n  return { form, logItems };\n}\n\nexport function registerApiRequestStep(registry: StepRegistry): void {\n  registry.register(\"api.request\", async (ctx: TestContext, step: OpStep) => {\n    if (!ctx.api) {\n      throw new Error('Missing API adapter on context for op \"api.request\"');\n    }\n\n    const input = (step.with ?? {}) as ApiRequestInput;\n    if (!input.method) {\n      throw new Error('Missing \"method\" in step.with for op \"api.request\"');\n    }\n    if (!input.url) {\n      throw new Error('Missing \"url\" in step.with for op \"api.request\"');\n    }\n\n    const rawFormData = input.formData ?? input.body;\n    const formItems = Array.isArray(rawFormData) ? rawFormData : isPlainObject(rawFormData) ? formItemsFromRecord(rawFormData) : undefined;\n\n    if (rawFormData !== undefined && !formItems) {\n      throw new Error('formData/body must be an array of items or an object, for op \"api.request\".');\n    }\n\n    if (formItems && (input.json !== undefined || input.bodyText !== undefined)) {\n      throw new Error('Use either formData/body or json/bodyText, not both, for op \"api.request\".');\n    }\n\n    // Original URL (may include query).\n    const rawUrl = input.url;\n\n    // Detect absolute URLs by scheme.\n    const absolute = /^[a-z][a-z0-9+.-]*:/i.test(rawUrl);\n\n    // Parse with base for relative URLs.\n    const urlObj = new URL(rawUrl, \"http://solid.local\");\n\n    // Parse URL query into object.\n    const urlQuery = urlObj.search\n      ? (qs.parse(urlObj.search, { ignoreQueryPrefix: true, allowDots: true, depth: 10 }) as Record<string, any>)\n      : {}; // No query in URL.\n    let stepQuery: Record<string, any> = {};\n    if (input.query !== undefined) {\n      stepQuery =\n        typeof input.query === \"string\"\n          // Parse query string.\n          ? (qs.parse(input.query, { ignoreQueryPrefix: true, allowDots: true, depth: 10 }) as Record<string, any>)\n          // Use object as-is.\n          : (input.query as Record<string, any>);\n    }\n\n    // Step query overrides URL query.\n    const mergedQuery = deepMerge(urlQuery, stepQuery);\n\n    // Rebuild query string.\n    const queryString = qs.stringify(mergedQuery, { addQueryPrefix: true, allowDots: true });\n\n    // Apply merged query to URL.\n    urlObj.search = queryString;\n    const finalUrl = absolute\n      // Preserve absolute URL.\n      ? urlObj.toString()\n      // Keep relative URL shape.\n      : `${urlObj.pathname}${urlObj.search}${urlObj.hash}`;\n\n    let formData: FormData | undefined;\n    let formLogItems: Record<string, any>[] | undefined;\n    if (formItems) {\n      const built = await buildFormData(formItems);\n      formData = built.form;\n      formLogItems = built.logItems;\n    }\n\n    const req: ApiRequestOptions = {\n      method: input.method,\n      url: finalUrl,\n      headers: input.headers,\n      json: input.json,\n      bodyText: input.bodyText,\n      formData,\n    };\n\n    const startedAt = Date.now();\n    const printApiLogs = ctx.options?.printApiLogs ?? false;\n    const logName = `api.request ${req.method} ${finalUrl}`;\n    const requestLog = stripUndefined({\n      method: req.method,\n      url: finalUrl,\n      headers: req.headers,\n      query: mergedQuery,\n      queryString: urlObj.search ? urlObj.search.slice(1) : \"\",\n      json: input.json,\n      bodyText: input.bodyText,\n      formData: formLogItems,\n    });\n\n    let response;\n    try {\n      response = await ctx.api.http(req);\n    } catch (err: any) {\n      if (printApiLogs) {\n        attachJson(ctx, logName, {\n          request: requestLog,\n          durationMs: Date.now() - startedAt,\n          error: err instanceof Error ? err.message : String(err),\n        });\n      }\n      throw err;\n    }\n\n    const durationMs = Date.now() - startedAt;\n    ctx.last = { ...(ctx.last ?? {}), apiResponse: response };\n\n    if (printApiLogs) {\n      const responseLog = stripUndefined({\n        status: response.status,\n        headers: response.headers,\n        bodyJson: response.bodyJson,\n        bodyText: response.bodyJson === undefined ? response.bodyText : undefined,\n      });\n      attachJson(ctx, logName, {\n        request: requestLog,\n        response: responseLog,\n        durationMs,\n      });\n    }\n\n    return {\n      status: response.status,\n      headers: response.headers,\n      bodyText: response.bodyText,\n      bodyJson: response.bodyJson,\n      body: response.bodyJson ?? response.bodyText,\n    };\n  });\n}\n"]}

package/dist/testing/steps/assert/http.step.d.ts

@@ -0,0 +1,3 @@
+import { StepRegistry } from "../../core/step-registry";
+export declare function registerHttpAssertSteps(registry: StepRegistry): void;
+//# sourceMappingURL=http.step.d.ts.map

package/dist/testing/steps/assert/http.step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.step.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/assert/http.step.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAKxD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAyBpE"}

package/dist/testing/steps/assert/http.step.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHttpAssertSteps = registerHttpAssertSteps;
+const attachments_1 = require("../../reporter/attachments");
+function registerHttpAssertSteps(registry) {
+    registry.register("assert.httpStatus", async (ctx, step) => {
+        const input = (step.with ?? {});
+        const response = input.from ?? ctx.last?.apiResponse;
+        if (!response) {
+            throw new Error('Missing ApiResponse for op "assert.httpStatus"');
+        }
+        if (input.is === undefined) {
+            throw new Error('Missing "is" in step.with for op "assert.httpStatus"');
+        }
+        if (ctx.options?.printApiLogs && ctx.reporter.attach) {
+            (0, attachments_1.attachJson)(ctx, "apiResponse", response);
+        }
+        if (response.status !== input.is) {
+            const err = new Error(`Expected HTTP status ${input.is} but got ${response.status}`);
+            err.httpResponseBody = response.bodyText;
+            err.httpStatus = response.status;
+            err.httpExpectedStatus = input.is;
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=http.step.js.map

package/dist/testing/steps/assert/http.step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.step.js","sourceRoot":"","sources":["../../../../src/testing/steps/assert/http.step.ts"],"names":[],"mappings":";;AAOA,0DAyBC;AA7BD,4DAAwD;AAIxD,SAAgB,uBAAuB,CAAC,QAAsB;IAC5D,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,EAAE,KAAK,EAAE,GAAgB,EAAE,IAAY,EAAE,EAAE;QAC9E,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAoB,CAAC;QACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC;QACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,GAAG,CAAC,OAAO,EAAE,YAAY,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrD,IAAA,wBAAU,EAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK,CAAC,EAAE,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,IAAI,KAAK,CACnB,wBAAwB,KAAK,CAAC,EAAE,YAAY,QAAQ,CAAC,MAAM,EAAE,CAC9D,CAAC;YACD,GAAW,CAAC,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,CAAC;YACjD,GAAW,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;YACzC,GAAW,CAAC,kBAAkB,GAAG,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { ApiResponse, TestContext } from \"../../contracts/runtime-context.types\";\nimport type { OpStep } from \"../../contracts/testing-metadata.types\";\nimport { StepRegistry } from \"../../core/step-registry\";\nimport { attachJson } from \"../../reporter/attachments\";\n\ntype HttpStatusInput = { from?: ApiResponse; is: number };\n\nexport function registerHttpAssertSteps(registry: StepRegistry): void {\n  registry.register(\"assert.httpStatus\", async (ctx: TestContext, step: OpStep) => {\n    const input = (step.with ?? {}) as HttpStatusInput;\n    const response = input.from ?? ctx.last?.apiResponse;\n    if (!response) {\n      throw new Error('Missing ApiResponse for op \"assert.httpStatus\"');\n    }\n    if (input.is === undefined) {\n      throw new Error('Missing \"is\" in step.with for op \"assert.httpStatus\"');\n    }\n\n    if (ctx.options?.printApiLogs && ctx.reporter.attach) {\n      attachJson(ctx, \"apiResponse\", response);\n    }\n\n    if (response.status !== input.is) {\n      const err = new Error(\n        `Expected HTTP status ${input.is} but got ${response.status}`,\n      );\n      (err as any).httpResponseBody = response.bodyText;\n      (err as any).httpStatus = response.status;\n      (err as any).httpExpectedStatus = input.is;\n      throw err;\n    }\n  });\n}\n"]}

package/dist/testing/steps/assert/index.d.ts

@@ -0,0 +1,3 @@
+import { StepRegistry } from "../../core/step-registry";
+export declare function registerAssertSteps(registry: StepRegistry): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/steps/assert/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/assert/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAKxD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAIhE"}

package/dist/testing/steps/assert/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAssertSteps = registerAssertSteps;
+const http_step_1 = require("./http.step");
+const jsonpath_step_1 = require("./jsonpath.step");
+const primitives_step_1 = require("./primitives.step");
+function registerAssertSteps(registry) {
+    (0, primitives_step_1.registerPrimitiveAssertSteps)(registry);
+    (0, http_step_1.registerHttpAssertSteps)(registry);
+    (0, jsonpath_step_1.registerJsonPathAssertSteps)(registry);
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/steps/assert/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/testing/steps/assert/index.ts"],"names":[],"mappings":";;AAOA,kDAIC;AARD,2CAAsD;AACtD,mDAA8D;AAC9D,uDAAiE;AAEjE,SAAgB,mBAAmB,CAAC,QAAsB;IACxD,IAAA,8CAA4B,EAAC,QAAQ,CAAC,CAAC;IACvC,IAAA,mCAAuB,EAAC,QAAQ,CAAC,CAAC;IAClC,IAAA,2CAA2B,EAAC,QAAQ,CAAC,CAAC;AACxC,CAAC","sourcesContent":["// Purpose: Assert step registrations.\n\nimport { StepRegistry } from \"../../core/step-registry\";\nimport { registerHttpAssertSteps } from \"./http.step\";\nimport { registerJsonPathAssertSteps } from \"./jsonpath.step\";\nimport { registerPrimitiveAssertSteps } from \"./primitives.step\";\n\nexport function registerAssertSteps(registry: StepRegistry): void {\n  registerPrimitiveAssertSteps(registry);\n  registerHttpAssertSteps(registry);\n  registerJsonPathAssertSteps(registry);\n}\n"]}

package/dist/testing/steps/assert/jsonpath.step.d.ts

@@ -0,0 +1,3 @@
+import { StepRegistry } from "../../core/step-registry";
+export declare function registerJsonPathAssertSteps(registry: StepRegistry): void;
+//# sourceMappingURL=jsonpath.step.d.ts.map

package/dist/testing/steps/assert/jsonpath.step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonpath.step.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/assert/jsonpath.step.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAuBxD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAsBxE"}

package/dist/testing/steps/assert/jsonpath.step.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerJsonPathAssertSteps = registerJsonPathAssertSteps;
+function resolveJsonPath(from, path) {
+    let normalized = path.trim();
+    if (normalized.startsWith("$.")) {
+        normalized = normalized.slice(2);
+    }
+    else if (normalized === "$") {
+        return from;
+    }
+    normalized = normalized.replace(/\[(\d+)\]/g, ".$1");
+    const parts = normalized.split(".").filter(Boolean);
+    let current = from;
+    for (const part of parts) {
+        if (current == null)
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+function registerJsonPathAssertSteps(registry) {
+    registry.register("assert.jsonPath", async (_ctx, step) => {
+        const input = (step.with ?? {});
+        if (!("from" in input)) {
+            throw new Error('Missing "from" in step.with for op "assert.jsonPath"');
+        }
+        if (!input.path) {
+            throw new Error('Missing "path" in step.with for op "assert.jsonPath"');
+        }
+        if (!("equals" in input)) {
+            throw new Error('Missing "equals" in step.with for op "assert.jsonPath"');
+        }
+        const actual = resolveJsonPath(input.from, input.path);
+        if (actual !== input.equals) {
+            throw new Error(`Expected JSONPath "${input.path}" to equal ${String(input.equals)} but got ${String(actual)}`);
+        }
+    });
+}
+//# sourceMappingURL=jsonpath.step.js.map

package/dist/testing/steps/assert/jsonpath.step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonpath.step.js","sourceRoot":"","sources":["../../../../src/testing/steps/assert/jsonpath.step.ts"],"names":[],"mappings":";;AA2BA,kEAsBC;AAzCD,SAAS,eAAe,CAAC,IAAS,EAAE,IAAY;IAC9C,IAAI,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;SAAM,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEpD,IAAI,OAAO,GAAQ,IAAI,CAAC;IACxB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,IAAI;YAAE,OAAO,SAAS,CAAC;QACtC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,2BAA2B,CAAC,QAAsB;IAChE,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,EAAE,KAAK,EAAE,IAAiB,EAAE,IAAY,EAAE,EAAE;QAC7E,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAkB,CAAC;QACjD,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,sBAAsB,KAAK,CAAC,IAAI,cAAc,MAAM,CAClD,KAAK,CAAC,MAAM,CACb,YAAY,MAAM,CAAC,MAAM,CAAC,EAAE,CAC9B,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["// Purpose: JSONPath assertion step registrations.\n\nimport type { TestContext } from \"../../contracts/runtime-context.types\";\nimport type { OpStep } from \"../../contracts/testing-metadata.types\";\nimport { StepRegistry } from \"../../core/step-registry\";\n\ntype JsonPathInput = { from: any; path: string; equals: any };\n\nfunction resolveJsonPath(from: any, path: string): unknown {\n  let normalized = path.trim();\n  if (normalized.startsWith(\"$.\")) {\n    normalized = normalized.slice(2);\n  } else if (normalized === \"$\") {\n    return from;\n  }\n\n  normalized = normalized.replace(/\\[(\\d+)\\]/g, \".$1\");\n  const parts = normalized.split(\".\").filter(Boolean);\n\n  let current: any = from;\n  for (const part of parts) {\n    if (current == null) return undefined;\n    current = current[part];\n  }\n  return current;\n}\n\nexport function registerJsonPathAssertSteps(registry: StepRegistry): void {\n  registry.register(\"assert.jsonPath\", async (_ctx: TestContext, step: OpStep) => {\n    const input = (step.with ?? {}) as JsonPathInput;\n    if (!(\"from\" in input)) {\n      throw new Error('Missing \"from\" in step.with for op \"assert.jsonPath\"');\n    }\n    if (!input.path) {\n      throw new Error('Missing \"path\" in step.with for op \"assert.jsonPath\"');\n    }\n    if (!(\"equals\" in input)) {\n      throw new Error('Missing \"equals\" in step.with for op \"assert.jsonPath\"');\n    }\n\n    const actual = resolveJsonPath(input.from, input.path);\n    if (actual !== input.equals) {\n      throw new Error(\n        `Expected JSONPath \"${input.path}\" to equal ${String(\n          input.equals,\n        )} but got ${String(actual)}`,\n      );\n    }\n  });\n}\n"]}

package/dist/testing/steps/assert/primitives.step.d.ts

@@ -0,0 +1,3 @@
+import { StepRegistry } from "../../core/step-registry";
+export declare function registerPrimitiveAssertSteps(registry: StepRegistry): void;
+//# sourceMappingURL=primitives.step.d.ts.map

package/dist/testing/steps/assert/primitives.step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.step.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/assert/primitives.step.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAMxD,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CA0DzE"}

package/dist/testing/steps/assert/primitives.step.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPrimitiveAssertSteps = registerPrimitiveAssertSteps;
+function registerPrimitiveAssertSteps(registry) {
+    registry.register("assert.equals", async (_ctx, step) => {
+        const input = (step.with ?? {});
+        if (!("actual" in input)) {
+            throw new Error('Missing "actual" in step.with for op "assert.equals"');
+        }
+        if (!("expected" in input)) {
+            throw new Error('Missing "expected" in step.with for op "assert.equals"');
+        }
+        if (input.actual !== input.expected) {
+            throw new Error(`Expected values to be equal. Actual: ${String(input.actual)}, Expected: ${String(input.expected)}`);
+        }
+    });
+    registry.register("assert.contains", async (_ctx, step) => {
+        const input = (step.with ?? {});
+        if (!input.actual) {
+            throw new Error('Missing "actual" in step.with for op "assert.contains"');
+        }
+        if (input.expected === undefined) {
+            throw new Error('Missing "expected" in step.with for op "assert.contains"');
+        }
+        if (!input.actual.includes(input.expected)) {
+            throw new Error(`Expected "${input.actual}" to contain "${input.expected}"`);
+        }
+    });
+    registry.register("assert.matches", async (_ctx, step) => {
+        const input = (step.with ?? {});
+        if (!input.actual) {
+            throw new Error('Missing "actual" in step.with for op "assert.matches"');
+        }
+        if (!input.pattern) {
+            throw new Error('Missing "pattern" in step.with for op "assert.matches"');
+        }
+        const regex = new RegExp(input.pattern);
+        if (!regex.test(input.actual)) {
+            throw new Error(`Expected "${input.actual}" to match /${input.pattern}/`);
+        }
+    });
+}
+//# sourceMappingURL=primitives.step.js.map

package/dist/testing/steps/assert/primitives.step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.step.js","sourceRoot":"","sources":["../../../../src/testing/steps/assert/primitives.step.ts"],"names":[],"mappings":";;AAUA,oEA0DC;AA1DD,SAAgB,4BAA4B,CAAC,QAAsB;IACjE,QAAQ,CAAC,QAAQ,CAAC,eAAe,EAAE,KAAK,EAAE,IAAiB,EAAE,IAAY,EAAE,EAAE;QAC3E,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAgB,CAAC;QAC/C,IAAI,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,wCAAwC,MAAM,CAC5C,KAAK,CAAC,MAAM,CACb,eAAe,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CACzC,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CACf,iBAAiB,EACjB,KAAK,EAAE,IAAiB,EAAE,IAAY,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAkB,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,aAAa,KAAK,CAAC,MAAM,iBAAiB,KAAK,CAAC,QAAQ,GAAG,CAC5D,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,QAAQ,CAAC,QAAQ,CACf,gBAAgB,EAChB,KAAK,EAAE,IAAiB,EAAE,IAAY,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAiB,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,wDAAwD,CACzD,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,aAAa,KAAK,CAAC,MAAM,eAAe,KAAK,CAAC,OAAO,GAAG,CACzD,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC","sourcesContent":["// Purpose: Primitive assertion step registrations.\n\nimport type { TestContext } from \"../../contracts/runtime-context.types\";\nimport type { OpStep } from \"../../contracts/testing-metadata.types\";\nimport { StepRegistry } from \"../../core/step-registry\";\n\ntype EqualsInput = { actual: unknown; expected: unknown };\ntype ContainsInput = { actual: string; expected: string };\ntype MatchesInput = { actual: string; pattern: string };\n\nexport function registerPrimitiveAssertSteps(registry: StepRegistry): void {\n  registry.register(\"assert.equals\", async (_ctx: TestContext, step: OpStep) => {\n    const input = (step.with ?? {}) as EqualsInput;\n    if (!(\"actual\" in input)) {\n      throw new Error('Missing \"actual\" in step.with for op \"assert.equals\"');\n    }\n    if (!(\"expected\" in input)) {\n      throw new Error('Missing \"expected\" in step.with for op \"assert.equals\"');\n    }\n    if (input.actual !== input.expected) {\n      throw new Error(\n        `Expected values to be equal. Actual: ${String(\n          input.actual,\n        )}, Expected: ${String(input.expected)}`,\n      );\n    }\n  });\n\n  registry.register(\n    \"assert.contains\",\n    async (_ctx: TestContext, step: OpStep) => {\n      const input = (step.with ?? {}) as ContainsInput;\n      if (!input.actual) {\n        throw new Error('Missing \"actual\" in step.with for op \"assert.contains\"');\n      }\n      if (input.expected === undefined) {\n        throw new Error(\n          'Missing \"expected\" in step.with for op \"assert.contains\"',\n        );\n      }\n      if (!input.actual.includes(input.expected)) {\n        throw new Error(\n          `Expected \"${input.actual}\" to contain \"${input.expected}\"`,\n        );\n      }\n    },\n  );\n\n  registry.register(\n    \"assert.matches\",\n    async (_ctx: TestContext, step: OpStep) => {\n      const input = (step.with ?? {}) as MatchesInput;\n      if (!input.actual) {\n        throw new Error('Missing \"actual\" in step.with for op \"assert.matches\"');\n      }\n      if (!input.pattern) {\n        throw new Error(\n          'Missing \"pattern\" in step.with for op \"assert.matches\"',\n        );\n      }\n      const regex = new RegExp(input.pattern);\n      if (!regex.test(input.actual)) {\n        throw new Error(\n          `Expected \"${input.actual}\" to match /${input.pattern}/`,\n        );\n      }\n    },\n  );\n}\n"]}

package/dist/testing/steps/test/index.d.ts

@@ -0,0 +1,3 @@
+import { StepRegistry } from "../../core/step-registry";
+export declare function registerTestSteps(registry: StepRegistry): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/steps/test/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/test/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAE9D"}

package/dist/testing/steps/test/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTestSteps = registerTestSteps;
+const test_spec_step_1 = require("./test-spec.step");
+function registerTestSteps(registry) {
+    (0, test_spec_step_1.registerTestSpecStep)(registry);
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/steps/test/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/testing/steps/test/index.ts"],"names":[],"mappings":";;AAKA,8CAEC;AAJD,qDAAwD;AAExD,SAAgB,iBAAiB,CAAC,QAAsB;IACtD,IAAA,qCAAoB,EAAC,QAAQ,CAAC,CAAC;AACjC,CAAC","sourcesContent":["// Purpose: Test step registrations.\n\nimport { StepRegistry } from \"../../core/step-registry\";\nimport { registerTestSpecStep } from \"./test-spec.step\";\n\nexport function registerTestSteps(registry: StepRegistry): void {\n  registerTestSpecStep(registry);\n}\n"]}

package/dist/testing/steps/test/test-spec.step.d.ts

@@ -0,0 +1,3 @@
+import { StepRegistry } from "../../core/step-registry";
+export declare function registerTestSpecStep(registry: StepRegistry): void;
+//# sourceMappingURL=test-spec.step.d.ts.map

package/dist/testing/steps/test/test-spec.step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-spec.step.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/test/test-spec.step.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CA6CjE"}

package/dist/testing/steps/test/test-spec.step.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTestSpecStep = registerTestSpecStep;
+function registerTestSpecStep(registry) {
+    registry.register("test.spec", async (ctx, step) => {
+        const specId = step.spec ?? step.with?.specId;
+        if (!specId) {
+            throw new Error('Missing "spec" on step (or "specId" in step.with) for op "test.spec"');
+        }
+        if (!ctx.specRegistry) {
+            throw new Error('Missing specRegistry on context for op "test.spec"');
+        }
+        const input = (step.with?.input ?? {});
+        const spec = ctx.specRegistry.create(specId);
+        const result = await spec.run({ ctx, input });
+        ctx.reporter.onSpecResult?.({
+            scenarioId: ctx.scenarioId,
+            specId,
+            stepName: step.name,
+            result,
+        });
+        if (result.attachments && ctx.reporter.attach) {
+            for (const attachment of result.attachments) {
+                const data = attachment.encoding === "base64"
+                    ? Buffer.from(attachment.data, "base64")
+                    : attachment.data;
+                ctx.reporter.attach({
+                    scenarioId: ctx.scenarioId,
+                    name: attachment.name,
+                    contentType: attachment.contentType,
+                    data,
+                });
+            }
+        }
+        if (!result.ok) {
+            throw new Error(`test.spec failed: ${specId}`);
+        }
+        return result;
+    });
+}
+//# sourceMappingURL=test-spec.step.js.map

package/dist/testing/steps/test/test-spec.step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-spec.step.js","sourceRoot":"","sources":["../../../../src/testing/steps/test/test-spec.step.ts"],"names":[],"mappings":";;AAMA,oDA6CC;AA7CD,SAAgB,oBAAoB,CAAC,QAAsB;IACzD,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,EAAE,GAAgB,EAAE,IAAY,EAAE,EAAE;QACtE,MAAM,MAAM,GACV,IAAI,CAAC,IAAI,IAAK,IAAI,CAAC,IAAI,EAAE,MAA6B,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAwB,CAAC;QAC9D,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QAE9C,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC1B,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,MAAM;YACN,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,WAAW,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC9C,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBAC5C,MAAM,IAAI,GACR,UAAU,CAAC,QAAQ,KAAK,QAAQ;oBAC9B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC;oBACxC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;gBACtB,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAClB,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,WAAW,EAAE,UAAU,CAAC,WAAW;oBACnC,IAAI;iBACL,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["// Purpose: test.spec step registration.\n\nimport type { TestContext } from \"../../contracts/runtime-context.types\";\nimport type { OpStep } from \"../../contracts/testing-metadata.types\";\nimport { StepRegistry } from \"../../core/step-registry\";\n\nexport function registerTestSpecStep(registry: StepRegistry): void {\n  registry.register(\"test.spec\", async (ctx: TestContext, step: OpStep) => {\n    const specId =\n      step.spec ?? (step.with?.specId as string | undefined);\n    if (!specId) {\n      throw new Error(\n        'Missing \"spec\" on step (or \"specId\" in step.with) for op \"test.spec\"',\n      );\n    }\n    if (!ctx.specRegistry) {\n      throw new Error('Missing specRegistry on context for op \"test.spec\"');\n    }\n\n    const input = (step.with?.input ?? {}) as Record<string, any>;\n    const spec = ctx.specRegistry.create(specId);\n    const result = await spec.run({ ctx, input });\n\n    ctx.reporter.onSpecResult?.({\n      scenarioId: ctx.scenarioId,\n      specId,\n      stepName: step.name,\n      result,\n    });\n\n    if (result.attachments && ctx.reporter.attach) {\n      for (const attachment of result.attachments) {\n        const data =\n          attachment.encoding === \"base64\"\n            ? Buffer.from(attachment.data, \"base64\")\n            : attachment.data;\n        ctx.reporter.attach({\n          scenarioId: ctx.scenarioId,\n          name: attachment.name,\n          contentType: attachment.contentType,\n          data,\n        });\n      }\n    }\n\n    if (!result.ok) {\n      throw new Error(`test.spec failed: ${specId}`);\n    }\n\n    return result;\n  });\n}\n"]}

package/dist/testing/steps/ui/actions.step.d.ts

@@ -0,0 +1,3 @@
+import { StepRegistry } from "../../core/step-registry";
+export declare function registerActionSteps(registry: StepRegistry): void;
+//# sourceMappingURL=actions.step.d.ts.map

package/dist/testing/steps/ui/actions.step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.step.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/ui/actions.step.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAYxD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAqBhE"}