@solidxai/core 0.1.2 → 0.1.4

package/dist/testing/runner/run-from-metadata.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runFromMetadata = runFromMetadata;
+const api_adapter_1 = require("../adapters/api/api-adapter");
+const playwright_adapter_1 = require("../adapters/ui/playwright-adapter");
+const api_1 = require("../steps/api");
+const ui_1 = require("../steps/ui");
+const assert_1 = require("../steps/assert");
+const util_1 = require("../steps/util");
+const test_1 = require("../steps/test");
+const resource_store_1 = require("../core/resource-store");
+const step_registry_1 = require("../core/step-registry");
+const spec_registry_1 = require("../core/spec-registry");
+const testing_engine_1 = require("../core/testing-engine");
+const scenario_filter_1 = require("./scenario-filter");
+const lifecycle_1 = require("./lifecycle");
+const console_reporter_1 = require("../reporter/console-reporter");
+function buildTestDataIndex(data) {
+    const index = {};
+    if (!Array.isArray(data))
+        return index;
+    for (const record of data) {
+        if (!record?.modelUserKey || !record?.recUserKeyValue)
+            continue;
+        if (!index[record.modelUserKey]) {
+            index[record.modelUserKey] = {};
+        }
+        index[record.modelUserKey][record.recUserKeyValue] = record.data ?? {};
+    }
+    return index;
+}
+async function runFromMetadata(opts) {
+    const registry = new step_registry_1.StepRegistry();
+    (0, api_1.registerApiSteps)(registry);
+    (0, ui_1.registerUiSteps)(registry);
+    (0, assert_1.registerAssertSteps)(registry);
+    (0, util_1.registerUtilSteps)(registry);
+    (0, test_1.registerTestSteps)(registry);
+    const engine = new testing_engine_1.TestingEngine(registry, opts.defaults);
+    const scenarios = (0, scenario_filter_1.filterScenarios)(opts.metadata.testing.scenarios, {
+        scenarioIds: opts.scenarioIds,
+        includeTags: opts.includeTags,
+        skipScenarioIds: opts.skipScenarioIds,
+    });
+    const specRegistry = new spec_registry_1.SpecRegistry();
+    const testData = buildTestDataIndex(opts.metadata.testing?.data);
+    if (opts.specs) {
+        opts.specs(specRegistry);
+    }
+    const resources = new resource_store_1.SimpleResourceStore();
+    const reporter = opts.reporter ?? new console_reporter_1.ConsoleReporter();
+    const api = new api_adapter_1.ApiAdapter(opts.api);
+    const ui = new playwright_adapter_1.PlaywrightAdapter(opts.ui);
+    const ctxBase = { resources, reporter, api, ui, specRegistry, testData, options: opts.options };
+    const uiStarted = { value: false };
+    try {
+        for (const scenario of scenarios) {
+            if ((0, lifecycle_1.scenarioNeedsUi)(scenario)) {
+                await (0, lifecycle_1.ensureUiStarted)(ctxBase, uiStarted);
+            }
+            await engine.runScenario(scenario, ctxBase);
+        }
+    }
+    finally {
+        if (uiStarted.value) {
+            await ui.stop();
+        }
+    }
+}
+//# sourceMappingURL=run-from-metadata.js.map

package/dist/testing/runner/run-from-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-from-metadata.js","sourceRoot":"","sources":["../../../src/testing/runner/run-from-metadata.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Reporter } from \"../reporter/reporter.types\";\nimport type { TestingMetadata, TestingDataRecord } from \"../contracts/testing-metadata.types\";\nimport type { ApiAdapterOptions } from \"../adapters/api/api.types\";\nimport type { PlaywrightAdapterOptions } from \"../adapters/ui/ui.types\";\nimport { ApiAdapter } from \"../adapters/api/api-adapter\";\nimport { PlaywrightAdapter } from \"../adapters/ui/playwright-adapter\";\nimport { registerApiSteps } from \"../steps/api\";\nimport { registerUiSteps } from \"../steps/ui\";\nimport { registerAssertSteps } from \"../steps/assert\";\nimport { registerUtilSteps } from \"../steps/util\";\nimport { registerTestSteps } from \"../steps/test\";\nimport { SimpleResourceStore } from \"../core/resource-store\";\nimport { StepRegistry } from \"../core/step-registry\";\nimport { SpecRegistry } from \"../core/spec-registry\";\nimport { TestingEngine } from \"../core/testing-engine\";\nimport { filterScenarios } from \"./scenario-filter\";\nimport { ensureUiStarted, scenarioNeedsUi } from \"./lifecycle\";\nimport { ConsoleReporter } from \"../reporter/console-reporter\";\n\n\nfunction buildTestDataIndex(data?: TestingDataRecord[]): Record<string, Record<string, any>> {\n  const index: Record<string, Record<string, any>> = {};\n  if (!Array.isArray(data)) return index;\n  for (const record of data) {\n    if (!record?.modelUserKey || !record?.recUserKeyValue) continue;\n    if (!index[record.modelUserKey]) {\n      index[record.modelUserKey] = {};\n    }\n    index[record.modelUserKey][record.recUserKeyValue] = record.data ?? {};\n  }\n  return index;\n}\n\nexport type RunnerOptions = {\n  metadata: TestingMetadata;\n  scenarioIds?: string[];\n  includeTags?: string[];\n  skipScenarioIds?: string[];\n  reporter?: Reporter;\n  api?: ApiAdapterOptions;\n  ui?: PlaywrightAdapterOptions;\n  defaults?: { timeoutMs?: number; retries?: number };\n  options?: { printApiLogs?: boolean };\n  specs?: (registry: SpecRegistry) => void;\n};\n\nexport async function runFromMetadata(opts: RunnerOptions): Promise<void> {\n  const registry = new StepRegistry();\n  registerApiSteps(registry);\n  registerUiSteps(registry);\n  registerAssertSteps(registry);\n  registerUtilSteps(registry);\n  registerTestSteps(registry);\n\n  const engine = new TestingEngine(registry, opts.defaults);\n  const scenarios = filterScenarios(opts.metadata.testing.scenarios, {\n    scenarioIds: opts.scenarioIds,\n    includeTags: opts.includeTags,\n    skipScenarioIds: opts.skipScenarioIds,\n  });\n\n  const specRegistry = new SpecRegistry();\n  const testData = buildTestDataIndex(opts.metadata.testing?.data);\n  if (opts.specs) {\n    opts.specs(specRegistry);\n  }\n\n  const resources = new SimpleResourceStore();\n  const reporter = opts.reporter ?? new ConsoleReporter();\n  const api = new ApiAdapter(opts.api);\n  const ui = new PlaywrightAdapter(opts.ui);\n  const ctxBase = { resources, reporter, api, ui, specRegistry, testData, options: opts.options };\n  const uiStarted = { value: false };\n\n  try {\n    for (const scenario of scenarios) {\n      if (scenarioNeedsUi(scenario)) {\n        await ensureUiStarted(ctxBase, uiStarted);\n      }\n      await engine.runScenario(scenario, ctxBase);\n    }\n  } finally {\n    if (uiStarted.value) {\n      await ui.stop();\n    }\n  }\n}\n"]}

package/dist/testing/runner/scenario-filter.d.ts

@@ -0,0 +1,9 @@
+import type { ScenarioSpec } from "../contracts/testing-metadata.types";
+type ScenarioFilterOptions = {
+    scenarioIds?: string[];
+    includeTags?: string[];
+    skipScenarioIds?: string[];
+};
+export declare function filterScenarios(scenarios: ScenarioSpec[], opts: ScenarioFilterOptions): ScenarioSpec[];
+export {};
+//# sourceMappingURL=scenario-filter.d.ts.map

package/dist/testing/runner/scenario-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-filter.d.ts","sourceRoot":"","sources":["../../../src/testing/runner/scenario-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE,KAAK,qBAAqB,GAAG;IAC3B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,wBAAgB,eAAe,CAC7B,SAAS,EAAE,YAAY,EAAE,EACzB,IAAI,EAAE,qBAAqB,GAC1B,YAAY,EAAE,CAqBhB"}

package/dist/testing/runner/scenario-filter.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterScenarios = filterScenarios;
+function filterScenarios(scenarios, opts) {
+    let result = scenarios;
+    if (opts.scenarioIds && opts.scenarioIds.length > 0) {
+        const idSet = new Set(opts.scenarioIds);
+        result = result.filter((scenario) => idSet.has(scenario.id));
+    }
+    if (opts.includeTags && opts.includeTags.length > 0) {
+        result = result.filter((scenario) => {
+            const tags = scenario.tags ?? [];
+            return opts.includeTags.every((tag) => tags.includes(tag));
+        });
+    }
+    if (opts.skipScenarioIds && opts.skipScenarioIds.length > 0) {
+        const skipSet = new Set(opts.skipScenarioIds);
+        result = result.filter((scenario) => !skipSet.has(scenario.id));
+    }
+    return result;
+}
+//# sourceMappingURL=scenario-filter.js.map

package/dist/testing/runner/scenario-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-filter.js","sourceRoot":"","sources":["../../../src/testing/runner/scenario-filter.ts"],"names":[],"mappings":";;AAQA,0CAwBC;AAxBD,SAAgB,eAAe,CAC7B,SAAyB,EACzB,IAA2B;IAE3B,IAAI,MAAM,GAAG,SAAS,CAAC;IAEvB,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE;YAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,WAAY,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC9C,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import type { ScenarioSpec } from \"../contracts/testing-metadata.types\";\n\ntype ScenarioFilterOptions = {\n  scenarioIds?: string[];\n  includeTags?: string[];\n  skipScenarioIds?: string[];\n};\n\nexport function filterScenarios(\n  scenarios: ScenarioSpec[],\n  opts: ScenarioFilterOptions,\n): ScenarioSpec[] {\n  let result = scenarios;\n\n  if (opts.scenarioIds && opts.scenarioIds.length > 0) {\n    const idSet = new Set(opts.scenarioIds);\n    result = result.filter((scenario) => idSet.has(scenario.id));\n  }\n\n  if (opts.includeTags && opts.includeTags.length > 0) {\n    result = result.filter((scenario) => {\n      const tags = scenario.tags ?? [];\n      return opts.includeTags!.every((tag) => tags.includes(tag));\n    });\n  }\n\n  if (opts.skipScenarioIds && opts.skipScenarioIds.length > 0) {\n    const skipSet = new Set(opts.skipScenarioIds);\n    result = result.filter((scenario) => !skipSet.has(scenario.id));\n  }\n\n  return result;\n}\n"]}

package/dist/testing/steps/api/auth.step.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.step.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/api/auth.step.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAQxD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAqD9D"}

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

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAuthSteps = registerAuthSteps;
+function registerAuthSteps(registry) {
+    registry.register("api.auth.bearerFromLogin", async (ctx, step) => {
+        if (!ctx.api) {
+            throw new Error('Missing API adapter on context for op "api.auth.bearerFromLogin"');
+        }
+        const input = (step.with ?? {});
+        if (!input.url) {
+            throw new Error('Missing "url" in step.with for op "api.auth.bearerFromLogin"');
+        }
+        if (!input.username) {
+            throw new Error('Missing "username" in step.with for op "api.auth.bearerFromLogin"');
+        }
+        if (!input.password) {
+            throw new Error('Missing "password" in step.with for op "api.auth.bearerFromLogin"');
+        }
+        const response = await ctx.api.http({
+            method: "POST",
+            url: input.url,
+            json: {
+                username: input.username,
+                password: input.password,
+            },
+        });
+        if (response.status < 200 || response.status >= 300) {
+            throw new Error(`Login failed with status ${response.status}: ${response.bodyText}`);
+        }
+        const bodyJson = response.bodyJson;
+        const token = bodyJson?.data?.accessToken ?? bodyJson?.accessToken;
+        if (typeof token !== "string" || token.length === 0) {
+            throw new Error("Missing access token in login response");
+        }
+        return token;
+    });
+}
+//# sourceMappingURL=auth.step.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.step.js","sourceRoot":"","sources":["../../../../src/testing/steps/api/auth.step.ts"],"names":[],"mappings":";;AAYA,8CAqDC;AArDD,SAAgB,iBAAiB,CAAC,QAAsB;IACtD,QAAQ,CAAC,QAAQ,CACf,0BAA0B,EAC1B,KAAK,EAAE,GAAgB,EAAE,IAAY,EAAE,EAAE;QACvC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAyB,CAAC;QACxD,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAClC,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,IAAI,EAAE;gBACJ,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB;SACF,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CACb,4BAA4B,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,QAAQ,EAAE,CACpE,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAEb,CAAC;QACd,MAAM,KAAK,GAAG,QAAQ,EAAE,IAAI,EAAE,WAAW,IAAI,QAAQ,EAAE,WAAW,CAAC;QACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CACF,CAAC;AACJ,CAAC","sourcesContent":["// Purpose: API auth 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 BearerFromLoginInput = {\n  url: string;\n  username: string;\n  password: string;\n};\n\nexport function registerAuthSteps(registry: StepRegistry): void {\n  registry.register(\n    \"api.auth.bearerFromLogin\",\n    async (ctx: TestContext, step: OpStep) => {\n      if (!ctx.api) {\n        throw new Error(\n          'Missing API adapter on context for op \"api.auth.bearerFromLogin\"',\n        );\n      }\n\n      const input = (step.with ?? {}) as BearerFromLoginInput;\n      if (!input.url) {\n        throw new Error(\n          'Missing \"url\" in step.with for op \"api.auth.bearerFromLogin\"',\n        );\n      }\n      if (!input.username) {\n        throw new Error(\n          'Missing \"username\" in step.with for op \"api.auth.bearerFromLogin\"',\n        );\n      }\n      if (!input.password) {\n        throw new Error(\n          'Missing \"password\" in step.with for op \"api.auth.bearerFromLogin\"',\n        );\n      }\n\n      const response = await ctx.api.http({\n        method: \"POST\",\n        url: input.url,\n        json: {\n          username: input.username,\n          password: input.password,\n        },\n      });\n\n      if (response.status < 200 || response.status >= 300) {\n        throw new Error(\n          `Login failed with status ${response.status}: ${response.bodyText}`,\n        );\n      }\n\n      const bodyJson = response.bodyJson as\n        | { data?: { accessToken?: unknown }; accessToken?: unknown }\n        | undefined;\n      const token = bodyJson?.data?.accessToken ?? bodyJson?.accessToken;\n      if (typeof token !== \"string\" || token.length === 0) {\n        throw new Error(\"Missing access token in login response\");\n      }\n\n      return token;\n    },\n  );\n}\n"]}

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

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

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

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

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerApiSteps = registerApiSteps;
+const auth_step_1 = require("./auth.step");
+const request_step_1 = require("./request.step");
+function registerApiSteps(registry) {
+    (0, request_step_1.registerApiRequestStep)(registry);
+    (0, auth_step_1.registerAuthSteps)(registry);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/testing/steps/api/index.ts"],"names":[],"mappings":";;AAMA,4CAGC;AAND,2CAAgD;AAChD,iDAAwD;AAExD,SAAgB,gBAAgB,CAAC,QAAsB;IACrD,IAAA,qCAAsB,EAAC,QAAQ,CAAC,CAAC;IACjC,IAAA,6BAAiB,EAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["// Purpose: API step registrations.\n\nimport { StepRegistry } from \"../../core/step-registry\";\nimport { registerAuthSteps } from \"./auth.step\";\nimport { registerApiRequestStep } from \"./request.step\";\n\nexport function registerApiSteps(registry: StepRegistry): void {\n  registerApiRequestStep(registry);\n  registerAuthSteps(registry);\n}\n"]}

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

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

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":";;;;;AAiOA,wDAoIC;AAjWD,4DAAwD;AACxD,0DAAiC;AACjC,oDAA4B;AAC5B,4CAAoB;AACpB,kDAA0B;AAC1B,gDAAwB;AACxB,4CAAoB;AAEpB,MAAM,OAAO,GAAG,4BAA4B,CAAC;AAC7C,MAAM,aAAa,GAAG,CAAC,CAAC;AAwBxB,SAAS,aAAa,CAAC,KAAc;IAEnC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,SAAS,CAAC,MAAW,EAAE,MAAW;IACzC,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAEnD,MAAM,GAAG,GAAwB,EAAE,GAAG,MAAM,EAAE,CAAC;QAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;gBAEf,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBAEN,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,KAAU;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,GAAwB,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAS;YAChC,GAAG,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY;IACnB,YAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAW;IACpC,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,cAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC;IAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,gBAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IACxE,OAAO,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,QAAQ,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB,EAAE,gBAAwB,CAAC;IACpE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,mDAAmD,QAAQ,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,aAAa,GAAG,aAAa,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,8CAA8C,QAAQ,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjC,YAAY,EAAE,CAAC;IACf,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,UAAU,GAAG,YAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAElD,MAAM,OAAO,GAAG,eAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,IAAI,CAAC,CAAC;YACxC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;YAE3C,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC9C,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAClB,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,YAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC;gBACtD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACrD,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC1E,OAAO;YACT,CAAC;YAED,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBAClB,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAClB,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,YAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC;gBACtD,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,MAAM,EAAE,CAAC,CAAC,CAAC;gBAC7D,OAAO;YACT,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC1B,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,YAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC7B,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,YAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YAC3B,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC1E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,cAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,QAAgB;IAClD,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IACpD,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACjE,CAAC;AAED,SAAS,mBAAmB,CAAC,MAA2B;IACtD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACzF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACvC,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,KAAoB;IAC/C,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAEvI,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9E,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,cAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACnE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,YAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;gBAC7D,QAAQ;gBACR,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;YACH,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,IAAI,EAAE,QAAQ,CAAC,QAAQ;gBACvB,QAAQ;gBACR,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YAGN,MAAM,SAAS,GAAG,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACxI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,SAAgB,sBAAsB,CAAC,QAAsB;IAC3D,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,EAAE,GAAgB,EAAE,IAAY,EAAE,EAAE;QACxE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAoB,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC;QACjD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEvI,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;QACjG,CAAC;QAED,IAAI,SAAS,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAChG,CAAC;QAGD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC;QAGzB,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAGrD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;QAGrD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM;YAC5B,CAAC,CAAE,YAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAyB;YAC3G,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,SAAS,GAAwB,EAAE,CAAC;QACxC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,SAAS;gBACP,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;oBAE7B,CAAC,CAAE,YAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAyB;oBAEzG,CAAC,CAAE,KAAK,CAAC,KAA6B,CAAC;QAC7C,CAAC;QAGD,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAGnD,MAAM,WAAW,GAAG,YAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAGzF,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC;QAC5B,MAAM,QAAQ,GAAG,QAAQ;YAEvB,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE;YAEnB,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAEvD,IAAI,QAA8B,CAAC;QACnC,IAAI,YAA+C,CAAC;QACpD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;YAC7C,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;YACtB,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,CAAC;QAED,MAAM,GAAG,GAAsB;YAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,GAAG,EAAE,QAAQ;YACb,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ;SACT,CAAC;QAEF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,EAAE,YAAY,IAAI,KAAK,CAAC;QACxD,MAAM,OAAO,GAAG,eAAe,GAAG,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QACxD,MAAM,UAAU,GAAG,cAAc,CAAC;YAChC,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,GAAG,EAAE,QAAQ;YACb,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;YACxD,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,YAAY;SACvB,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC;QACb,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAA,wBAAU,EAAC,GAAG,EAAE,OAAO,EAAE;oBACvB,OAAO,EAAE,UAAU;oBACnB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAC1C,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;QAE1D,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,WAAW,GAAG,cAAc,CAAC;gBACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;aAC1E,CAAC,CAAC;YACH,IAAA,wBAAU,EAAC,GAAG,EAAE,OAAO,EAAE;gBACvB,OAAO,EAAE,UAAU;gBACnB,QAAQ,EAAE,WAAW;gBACrB,UAAU;aACX,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,IAAI,EAAE,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ;SAC7C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC","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