@siglo/http 0.0.0-stage → 1.0.0

package/dist/client/trace.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.injectTraceHeaders = injectTraceHeaders;
+exports.recordRequestSpanAttributes = recordRequestSpanAttributes;
+exports.recordResponseSpanAttributes = recordResponseSpanAttributes;
+exports.getActiveTraceId = getActiveTraceId;
+const api_1 = require("@opentelemetry/api");
+/**
+ * Injects W3C distributed trace context (traceparent and tracestate) into request headers
+ * from the active OpenTelemetry span and context.
+ */
+function injectTraceHeaders(carrier = {}, customSpan) {
+    const activeCtx = api_1.context.active();
+    try {
+        api_1.propagation.inject(activeCtx, carrier, api_1.defaultTextMapSetter);
+    }
+    catch {
+        // If propagation fails, continue to spanContext fallback
+    }
+    const targetSpan = customSpan || api_1.trace.getActiveSpan();
+    if (targetSpan) {
+        try {
+            const spanCtx = typeof targetSpan.spanContext === 'function'
+                ? targetSpan.spanContext()
+                : targetSpan.spanContext;
+            if (spanCtx && spanCtx.traceId && !carrier['traceparent']) {
+                const flags = (spanCtx.traceFlags ?? 0).toString(16).padStart(2, '0');
+                const spanId = spanCtx.spanId || '0000000000000000';
+                carrier['traceparent'] = `00-${spanCtx.traceId}-${spanId}-${flags}`;
+                if (spanCtx.traceState) {
+                    carrier['tracestate'] =
+                        typeof spanCtx.traceState.serialize === 'function'
+                            ? spanCtx.traceState.serialize()
+                            : String(spanCtx.traceState);
+                }
+            }
+        }
+        catch {
+            // Ignore span context extraction error
+        }
+    }
+    return carrier;
+}
+/**
+ * Attaches standard HTTP semantic convention attributes to the active OpenTelemetry span.
+ */
+function recordRequestSpanAttributes(method, url, serverAddress, customSpan) {
+    const activeSpan = customSpan || api_1.trace.getActiveSpan();
+    if (activeSpan && typeof activeSpan.setAttribute === 'function') {
+        try {
+            activeSpan.setAttribute('http.request.method', method.toUpperCase());
+            activeSpan.setAttribute('url.full', url);
+            activeSpan.setAttribute('server.address', serverAddress);
+        }
+        catch {
+            // Ignore attribute recording errors
+        }
+    }
+}
+/**
+ * Attaches standard response semantic convention attributes to the active OpenTelemetry span.
+ */
+function recordResponseSpanAttributes(statusCode, customSpan) {
+    const activeSpan = customSpan || api_1.trace.getActiveSpan();
+    if (activeSpan && typeof activeSpan.setAttribute === 'function') {
+        try {
+            activeSpan.setAttribute('http.response.status_code', statusCode);
+            if (statusCode >= 400 && typeof activeSpan.setStatus === 'function') {
+                activeSpan.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: `HTTP error status ${statusCode}`
+                });
+            }
+        }
+        catch {
+            // Ignore attribute recording errors
+        }
+    }
+}
+/**
+ * Extracts current active traceId if present.
+ */
+function getActiveTraceId(customSpan) {
+    const activeSpan = customSpan || api_1.trace.getActiveSpan();
+    if (activeSpan) {
+        try {
+            if (typeof activeSpan.spanContext === 'function') {
+                return activeSpan.spanContext()?.traceId;
+            }
+            if (activeSpan.spanContext && typeof activeSpan.spanContext === 'object') {
+                return activeSpan.spanContext.traceId;
+            }
+            if (activeSpan.traceId) {
+                return activeSpan.traceId;
+            }
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=trace.js.map

package/dist/client/trace.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { httpStep, HttpStep } from './step';
+export { httpStep, HttpStep };
+export default httpStep;
+export * from './types';
+export * from './client/retry';
+export * from './client/trace';
+export * from './client/fetch';
+export * from './policy/asl-bridge';
+export * from './schema/validator';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC9B,eAAe,QAAQ,CAAC;AAExB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpStep = exports.httpStep = void 0;
+const step_1 = require("./step");
+Object.defineProperty(exports, "httpStep", { enumerable: true, get: function () { return step_1.httpStep; } });
+Object.defineProperty(exports, "HttpStep", { enumerable: true, get: function () { return step_1.HttpStep; } });
+exports.default = step_1.httpStep;
+__exportStar(require("./types"), exports);
+__exportStar(require("./client/retry"), exports);
+__exportStar(require("./client/trace"), exports);
+__exportStar(require("./client/fetch"), exports);
+__exportStar(require("./policy/asl-bridge"), exports);
+__exportStar(require("./schema/validator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iCAA4C;AAEnC,yFAFA,eAAQ,OAEA;AAAE,yFAFA,eAAQ,OAEA;AAC3B,kBAAe,eAAQ,CAAC;AAExB,0CAAwB;AACxB,iDAA+B;AAC/B,iDAA+B;AAC/B,iDAA+B;AAC/B,sDAAoC;AACpC,qDAAmC"}

package/dist/policy/asl-bridge.d.ts

@@ -0,0 +1,21 @@
+export interface HostInfo {
+    hostname: string;
+    host: string;
+    port?: string;
+}
+/**
+ * Safely parses the destination hostname, host with port, and port from a target URL string.
+ */
+export declare function extractHostInfo(targetUrl: string): HostInfo;
+/**
+ * Verifies that the resolved URL's hostname is permitted by the active AsyncLocalStorage
+ * network egress perimeter policy.
+ *
+ * If blocked, throws a non-retryable NetworkPolicyViolationException tagged with `phase: 'before'`.
+ */
+export declare function assertNetworkPolicy(stepName: string, resolvedUrl: string, host: string, port?: string | number, fallbackPolicy?: any): void;
+/**
+ * Extracts a static hostname from a URL option if it is provided as a static string.
+ */
+export declare function extractStaticHostname(urlOption: unknown): string | undefined;
+//# sourceMappingURL=asl-bridge.d.ts.map

package/dist/policy/asl-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asl-bridge.d.ts","sourceRoot":"","sources":["../../src/policy/asl-bridge.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CA2B3D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EACtB,cAAc,CAAC,EAAE,GAAG,GACnB,IAAI,CA4BN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAU5E"}

package/dist/policy/asl-bridge.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractHostInfo = extractHostInfo;
+exports.assertNetworkPolicy = assertNetworkPolicy;
+exports.extractStaticHostname = extractStaticHostname;
+const core_1 = require("@siglo/core");
+/**
+ * Safely parses the destination hostname, host with port, and port from a target URL string.
+ */
+function extractHostInfo(targetUrl) {
+    try {
+        const urlToParse = targetUrl.includes('://') ? targetUrl : `http://${targetUrl}`;
+        const parsed = new URL(urlToParse);
+        return {
+            hostname: parsed.hostname,
+            host: parsed.host,
+            port: parsed.port || undefined
+        };
+    }
+    catch {
+        // Fallback if URL constructor still fails on malformed input
+        const withoutProto = targetUrl.replace(/^[a-z]+:\/\//, '');
+        const slashIdx = withoutProto.indexOf('/');
+        const hostPart = slashIdx !== -1 ? withoutProto.slice(0, slashIdx) : withoutProto;
+        const colonIdx = hostPart.lastIndexOf(':');
+        if (colonIdx !== -1) {
+            return {
+                hostname: hostPart.slice(0, colonIdx),
+                host: hostPart,
+                port: hostPart.slice(colonIdx + 1)
+            };
+        }
+        return {
+            hostname: hostPart,
+            host: hostPart
+        };
+    }
+}
+/**
+ * Verifies that the resolved URL's hostname is permitted by the active AsyncLocalStorage
+ * network egress perimeter policy.
+ *
+ * If blocked, throws a non-retryable NetworkPolicyViolationException tagged with `phase: 'before'`.
+ */
+function assertNetworkPolicy(stepName, resolvedUrl, host, port, fallbackPolicy) {
+    const activeStore = core_1.networkPolicyStorage.getStore() || fallbackPolicy;
+    if (!activeStore || activeStore.enabled === false) {
+        return;
+    }
+    const allowed = (0, core_1.isHostAllowed)(resolvedUrl, host, activeStore, port);
+    if (!allowed) {
+        const allowedHosts = activeStore.allowedHosts || [];
+        const exception = new core_1.NetworkPolicyViolationException(stepName, resolvedUrl, host, allowedHosts, {
+            phase: 'before',
+            retryable: false
+        });
+        // Explicitly guarantee phase: 'before' and retryable: false as specified in roadmap
+        Object.defineProperty(exception, 'phase', {
+            get: () => 'before',
+            set: () => { },
+            configurable: true
+        });
+        exception.retryable = false;
+        throw exception;
+    }
+}
+/**
+ * Extracts a static hostname from a URL option if it is provided as a static string.
+ */
+function extractStaticHostname(urlOption) {
+    if (typeof urlOption !== 'string') {
+        return undefined;
+    }
+    try {
+        const parsed = new URL(urlOption);
+        return parsed.hostname;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=asl-bridge.js.map

package/dist/policy/asl-bridge.js.map

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

package/dist/schema/validator.d.ts

@@ -0,0 +1,14 @@
+import { ValidationErrorDetail } from '@siglo/core';
+export interface ValidationResult<T = any> {
+    success: boolean;
+    data?: T;
+    errors?: ValidationErrorDetail[];
+}
+/**
+ * Validates a payload against a Standard Schema (~standard), Zod, Valibot, ArkType,
+ * or standard parsing validator.
+ *
+ * If validation fails, throws a Siglo ValidationException tagged with the provided phase.
+ */
+export declare function validatePayload<T = any>(schema: any, data: unknown, phase: 'validation' | 'action', stepName?: string): Promise<T>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/schema/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/schema/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,GAAG;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAG,GAAG,EAC3C,MAAM,EAAE,GAAG,EACX,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,YAAY,GAAG,QAAQ,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAwJZ"}

package/dist/schema/validator.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePayload = validatePayload;
+const core_1 = require("@siglo/core");
+/**
+ * Validates a payload against a Standard Schema (~standard), Zod, Valibot, ArkType,
+ * or standard parsing validator.
+ *
+ * If validation fails, throws a Siglo ValidationException tagged with the provided phase.
+ */
+async function validatePayload(schema, data, phase, stepName) {
+    if (!schema) {
+        return data;
+    }
+    // 1. Standard Schema specification (~standard v1)
+    if (typeof schema === 'object' && schema !== null && schema['~standard']) {
+        const standard = schema['~standard'];
+        const result = await standard.validate(data);
+        if (result && result.issues) {
+            const details = result.issues.map((issue) => ({
+                field: issue.path && issue.path.length > 0
+                    ? issue.path.map((segment) => String(typeof segment === 'object' && segment !== null ? segment.key : segment)).join('.')
+                    : '$root$',
+                message: issue.message || 'Validation failed',
+                error: issue
+            }));
+            const exception = new core_1.ValidationException(details, { phase, stepName, retryable: false });
+            Object.defineProperty(exception, 'phase', {
+                get: () => phase,
+                set: () => { },
+                configurable: true
+            });
+            throw exception;
+        }
+        if (!result || !('value' in result)) {
+            throw new TypeError('Standard Schema validator must return value or issues');
+        }
+        return result.value;
+    }
+    // 2. safeParse (Zod, Valibot, etc.)
+    if (typeof schema.safeParse === 'function') {
+        const result = await schema.safeParse(data);
+        if (!result.success) {
+            const issues = result.error?.issues;
+            const details = Array.isArray(issues) && issues.length > 0
+                ? issues.map((i) => ({
+                    field: i.path && i.path.length > 0 ? i.path.join('.') : '$root$',
+                    message: i.message || 'Validation failed',
+                    error: i
+                }))
+                : [
+                    {
+                        field: '$root$',
+                        message: result.error?.message || 'Schema validation failed',
+                        error: result.error
+                    }
+                ];
+            const exception = new core_1.ValidationException(details, { phase, stepName, retryable: false });
+            Object.defineProperty(exception, 'phase', {
+                get: () => phase,
+                set: () => { },
+                configurable: true
+            });
+            throw exception;
+        }
+        return result.data;
+    }
+    // 3. parse() method (Zod synchronous/asynchronous parser)
+    if (typeof schema.parse === 'function') {
+        try {
+            const parsed = await schema.parse(data);
+            return (parsed !== undefined ? parsed : data);
+        }
+        catch (err) {
+            const issues = err?.issues;
+            const details = Array.isArray(issues) && issues.length > 0
+                ? issues.map((i) => ({
+                    field: i.path && i.path.length > 0 ? i.path.join('.') : '$root$',
+                    message: i.message || 'Validation failed',
+                    error: i
+                }))
+                : [
+                    {
+                        field: '$root$',
+                        message: err?.message || 'Schema validation failed',
+                        error: err
+                    }
+                ];
+            const exception = new core_1.ValidationException(details, { phase, stepName, retryable: false });
+            Object.defineProperty(exception, 'phase', {
+                get: () => phase,
+                set: () => { },
+                configurable: true
+            });
+            throw exception;
+        }
+    }
+    // 4. validate() method (Joi, Yup, etc.)
+    if (typeof schema.validate === 'function') {
+        try {
+            const result = await schema.validate(data);
+            // Yup returns parsed data, Joi returns { error, value }
+            if (result && typeof result === 'object' && 'error' in result && result.error) {
+                const details = Array.isArray(result.error.details)
+                    ? result.error.details.map((d) => ({
+                        field: d.path ? (Array.isArray(d.path) ? d.path.join('.') : String(d.path)) : '$root$',
+                        message: d.message || 'Validation failed',
+                        error: d
+                    }))
+                    : [{ field: '$root$', message: result.error.message || 'Validation failed', error: result.error }];
+                const exception = new core_1.ValidationException(details, { phase, stepName, retryable: false });
+                Object.defineProperty(exception, 'phase', {
+                    get: () => phase,
+                    set: () => { },
+                    configurable: true
+                });
+                throw exception;
+            }
+            return (result && 'value' in result ? result.value : result);
+        }
+        catch (err) {
+            if (err instanceof core_1.ValidationException)
+                throw err;
+            const exception = new core_1.ValidationException([{ field: '$root$', message: err?.message || 'Validation failed', error: err }], { phase, stepName, retryable: false });
+            Object.defineProperty(exception, 'phase', {
+                get: () => phase,
+                set: () => { },
+                configurable: true
+            });
+            throw exception;
+        }
+    }
+    // 5. Function validator (custom predicate / mapper)
+    if (typeof schema === 'function') {
+        try {
+            const result = await schema(data);
+            if (result === false) {
+                throw new Error('Custom validation function returned false');
+            }
+            return (result !== true && result !== undefined ? result : data);
+        }
+        catch (err) {
+            const exception = new core_1.ValidationException([{ field: '$root$', message: err?.message || 'Validation failed', error: err }], { phase, stepName, retryable: false });
+            Object.defineProperty(exception, 'phase', {
+                get: () => phase,
+                set: () => { },
+                configurable: true
+            });
+            throw exception;
+        }
+    }
+    return data;
+}
+//# sourceMappingURL=validator.js.map

package/dist/schema/validator.js.map

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

package/dist/step.d.ts

@@ -0,0 +1,15 @@
+import { Step } from '@siglo/core';
+import { HttpStepOptions, HttpStepResult, CompensationHttpConfig, HttpStepInstance } from './types';
+export declare class HttpStep<TInput = any, TOutput = Record<string, any>, TName extends string = string> extends Step<TInput, HttpStepResult<TOutput>, TName> implements HttpStepInstance<TInput, TOutput, TName> {
+    private httpOptions;
+    constructor(name: TName, options: HttpStepOptions<TInput, TOutput>);
+    /**
+     * Declarative saga rollback compensation via HTTP request.
+     */
+    compensateWithHttp(config: CompensationHttpConfig<TInput, TOutput>): this;
+}
+/**
+ * Creates a resilient, W3C-traced HTTP client step for Siglo workflows.
+ */
+export declare function httpStep<const TName extends string, TInput = any, TOutput = Record<string, any>>(name: TName, options: HttpStepOptions<TInput, TOutput>): HttpStep<TInput, TOutput, TName>;
+//# sourceMappingURL=step.d.ts.map

package/dist/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../src/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAsC,MAAM,aAAa,CAAC;AACvE,OAAO,EAEL,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAKjB,qBAAa,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,SAAS,MAAM,GAAG,MAAM,CAC9F,SAAQ,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,KAAK,CACnD,YAAW,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;IAEnD,OAAO,CAAC,WAAW,CAAmC;gBAE1C,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC;IA4IlE;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CA+B1E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9F,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAElC"}

package/dist/step.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpStep = void 0;
+exports.httpStep = httpStep;
+const core_1 = require("@siglo/core");
+const asl_bridge_1 = require("./policy/asl-bridge");
+const validator_1 = require("./schema/validator");
+const fetch_1 = require("./client/fetch");
+class HttpStep extends core_1.Step {
+    httpOptions;
+    constructor(name, options) {
+        const action = async (ctx) => {
+            // 1. Resolve parameters dynamically from context
+            const resolvedUrl = typeof options.url === 'function' ? options.url(ctx) : options.url;
+            const { hostname, port } = (0, asl_bridge_1.extractHostInfo)(resolvedUrl);
+            // Asserts hostname against active AsyncLocalStorage (ASL) network policy
+            (0, asl_bridge_1.assertNetworkPolicy)(name, resolvedUrl, hostname, port);
+            const resolvedHeaders = typeof options.headers === 'function' ? options.headers(ctx) : (options.headers || {});
+            const resolvedQuery = typeof options.query === 'function' ? options.query(ctx) : options.query;
+            const resolvedBody = typeof options.body === 'function' ? options.body(ctx) : options.body;
+            // 2. VALIDATION Phase: Validate outgoing request payload before touching the network
+            if (options.requestSchema && resolvedBody !== undefined) {
+                await (0, validator_1.validatePayload)(options.requestSchema, resolvedBody, 'validation', name);
+            }
+            // 3. ACTION Phase: Network Execution via executeHttpRequest
+            const res = await (0, fetch_1.executeHttpRequest)({
+                capture: options.capture,
+                stepName: name,
+                url: resolvedUrl,
+                method: options.method || 'GET',
+                headers: resolvedHeaders,
+                query: resolvedQuery,
+                body: resolvedBody,
+                responseType: options.responseType || 'json',
+                retryOnStatus: options.retryOnStatus,
+                maxRetries: options.maxRetries,
+                allowNotFound: options.allowNotFound,
+                timeoutMs: options.timeoutMs,
+                signal: ctx?.$signal || ctx?.signal,
+                span: ctx?.span || ctx?.$span,
+                clock: options.clock,
+                sleep: options.sleep
+            });
+            // Handle 404 when allowNotFound is true
+            if (res.notFound) {
+                const notFoundPayload = {
+                    notFound: true,
+                    data: null,
+                    $httpMetadata: res.metadata,
+                    httpMetadata: res.metadata
+                };
+                return notFoundPayload;
+            }
+            // 4. Validate incoming response payload if responseSchema is defined
+            let validatedData = res.data;
+            if (options.responseSchema) {
+                validatedData = await (0, validator_1.validatePayload)(options.responseSchema, res.data, 'action', name);
+            }
+            // 5. Attach $httpMetadata and construct return object
+            if (typeof validatedData === 'object' &&
+                validatedData !== null &&
+                !Array.isArray(validatedData) &&
+                typeof validatedData.then !== 'function' &&
+                !(typeof Blob !== 'undefined' && validatedData instanceof Blob) &&
+                !(typeof ArrayBuffer !== 'undefined' && validatedData instanceof ArrayBuffer)) {
+                return {
+                    ...validatedData,
+                    data: validatedData,
+                    $httpMetadata: res.metadata,
+                    httpMetadata: res.metadata
+                };
+            }
+            const wrappedResult = {
+                data: validatedData,
+                $httpMetadata: res.metadata,
+                httpMetadata: res.metadata
+            };
+            return wrappedResult;
+        };
+        super(name, ((ctx) => (0, core_1.observeEcosystem)({ version: 1, kind: 'http', outcome: 'failure',
+            method: options.method || 'GET', url: typeof options.url === 'string' ? options.url : undefined }, () => action(ctx), result => ({ ...result.$httpMetadata, policy: 'allowed' }))));
+        this.httpOptions = options;
+        // Static host assertion for graph inspection
+        const staticHost = (0, asl_bridge_1.extractStaticHostname)(options.url);
+        if (staticHost) {
+            this.allowNetwork([staticHost]);
+        }
+        // 1. BEFORE Phase: Validate ASL Network Egress Perimeter early
+        this.onBefore(async (ctx) => {
+            try {
+                const resolvedUrl = typeof options.url === 'function' ? options.url(ctx) : options.url;
+                const { hostname, port } = (0, asl_bridge_1.extractHostInfo)(resolvedUrl);
+                // Asserts hostname against active AsyncLocalStorage (ASL) network policy
+                (0, asl_bridge_1.assertNetworkPolicy)(name, resolvedUrl, hostname, port);
+            }
+            catch (error) {
+                (0, core_1.recordInspection)({ version: 1, kind: 'http', outcome: 'failure', method: options.method || 'GET',
+                    url: typeof options.url === 'string' ? options.url : undefined,
+                    policy: error?.name === 'NetworkPolicyViolationException' ? 'denied' : 'unknown' });
+                throw error;
+            }
+            return true;
+        });
+        // 4. AFTER Phase: Safely attach telemetry if context is extensible
+        this.onAfter(async (output, ctx) => {
+            try {
+                if (output && output.$httpMetadata && ctx && typeof ctx === 'object') {
+                    if (!Object.isFrozen(ctx) && Object.isExtensible(ctx)) {
+                        if (!ctx.$steps) {
+                            ctx.$steps = {};
+                        }
+                        if (!ctx.$steps[name]) {
+                            ctx.$steps[name] = {};
+                        }
+                        ctx.$steps[name].httpMetadata = output.$httpMetadata;
+                    }
+                }
+            }
+            catch {
+                // Ignore if context is immutable or sealed
+            }
+            return output;
+        });
+        // 5. COMPENSATION Phase: Register declarative saga compensation if configured
+        if (options.compensate) {
+            this.compensateWithHttp(options.compensate);
+        }
+    }
+    /**
+     * Declarative saga rollback compensation via HTTP request.
+     */
+    compensateWithHttp(config) {
+        this.compensate(async (res, ctx) => {
+            const compUrl = typeof config.url === 'function' ? config.url(ctx, res) : config.url;
+            const compMethod = config.method || 'DELETE';
+            const compHeaders = typeof config.headers === 'function' ? config.headers(ctx, res) : (config.headers || {});
+            const compQuery = typeof config.query === 'function' ? config.query(ctx, res) : config.query;
+            const compBody = typeof config.body === 'function' ? config.body(ctx, res) : config.body;
+            // Verify ASL network policy for compensation endpoint
+            const { hostname, port } = (0, asl_bridge_1.extractHostInfo)(compUrl);
+            (0, asl_bridge_1.assertNetworkPolicy)(`${this.name}:compensate`, compUrl, hostname, port);
+            await (0, fetch_1.executeHttpRequest)({
+                stepName: `${this.name}:compensate`,
+                url: compUrl,
+                method: compMethod,
+                headers: compHeaders,
+                query: compQuery,
+                body: compBody,
+                clock: this.httpOptions.clock,
+                sleep: this.httpOptions.sleep,
+                retryOnStatus: this.httpOptions.retryOnStatus,
+                maxRetries: this.httpOptions.maxRetries
+            });
+        });
+        return this;
+    }
+}
+exports.HttpStep = HttpStep;
+/**
+ * Creates a resilient, W3C-traced HTTP client step for Siglo workflows.
+ */
+function httpStep(name, options) {
+    return new HttpStep(name, options);
+}
+//# sourceMappingURL=step.js.map