@once-agent/sdk 0.1.3 → 0.1.5

package/dist/runtime/decision.js

@@ -0,0 +1,102 @@
+const SAFE_HTTP_METHODS = new Set([
+    "GET",
+    "HEAD",
+    "OPTIONS"
+]);
+const CONSEQUENTIAL_HTTP_METHODS = new Set([
+    "POST",
+    "PUT",
+    "PATCH",
+    "DELETE"
+]);
+function normalizeMethod(method) {
+    return String(method || "")
+        .trim()
+        .toUpperCase();
+}
+function nonEmpty(value) {
+    return (typeof value === "string" &&
+        value.trim().length > 0);
+}
+/**
+ * Decide whether an outbound HTTP operation may
+ * pass normally, must be protected by Once, or
+ * must fail closed.
+ *
+ * v0.1 intentionally does NOT guess identity.
+ *
+ * A consequential operation without a stable
+ * operationId is blocked rather than executed
+ * unsafely.
+ */
+export function decideHttpExecution(call) {
+    const method = normalizeMethod(call.method);
+    let parsedUrl;
+    try {
+        parsedUrl =
+            new URL(call.url);
+    }
+    catch {
+        return {
+            decision: "BLOCK",
+            code: "INVALID_URL",
+            consequential: true,
+            method,
+            reason: "Runtime could not safely determine the destination URL."
+        };
+    }
+    if (parsedUrl.protocol !== "https:" &&
+        parsedUrl.protocol !== "http:") {
+        return {
+            decision: "BLOCK",
+            code: "UNSUPPORTED_PROTOCOL",
+            consequential: true,
+            method,
+            reason: `Runtime does not support protocol ${parsedUrl.protocol}`
+        };
+    }
+    if (SAFE_HTTP_METHODS.has(method)) {
+        return {
+            decision: "PASS",
+            code: "SAFE_HTTP_METHOD",
+            consequential: false,
+            method,
+            reason: `${method} is treated as a non-consequential HTTP read in Runtime v0.1.`
+        };
+    }
+    if (!CONSEQUENTIAL_HTTP_METHODS.has(method)) {
+        return {
+            decision: "BLOCK",
+            code: "UNSUPPORTED_HTTP_METHOD",
+            consequential: true,
+            method,
+            reason: `Runtime does not yet have a proven execution policy for HTTP method ${method || "(empty)"}.`
+        };
+    }
+    if (!nonEmpty(call.provider)) {
+        return {
+            decision: "BLOCK",
+            code: "MISSING_PROVIDER",
+            consequential: true,
+            method,
+            reason: "Consequential operation has no configured Once provider."
+        };
+    }
+    if (!nonEmpty(call.operationId)) {
+        return {
+            decision: "BLOCK",
+            code: "MISSING_OPERATION_ID",
+            consequential: true,
+            method,
+            reason: "Consequential operation has no stable operation identity. Once refuses unsafe execution."
+        };
+    }
+    return {
+        decision: "PROTECT",
+        code: "CONSEQUENTIAL_HTTP_WRITE",
+        consequential: true,
+        method,
+        reason: "Consequential HTTP operation has a provider and stable identity and must execute through Once."
+    };
+}
+//# sourceMappingURL=decision.js.map

package/dist/runtime/decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../src/runtime/decision.ts"],"names":[],"mappings":"AA0CA,MAAM,iBAAiB,GACrB,IAAI,GAAG,CAAC;IACN,KAAK;IACL,MAAM;IACN,SAAS;CACV,CAAC,CAAC;AAEL,MAAM,0BAA0B,GAC9B,IAAI,GAAG,CAAC;IACN,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;CACT,CAAC,CAAC;AAEL,SAAS,eAAe,CACtB,MAAc;IAGd,OAAO,MAAM,CACX,MAAM,IAAI,EAAE,CACb;SACE,IAAI,EAAE;SACN,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CACf,KAAyB;IAGzB,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CACxB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAyB;IAGzB,MAAM,MAAM,GACV,eAAe,CACb,IAAI,CAAC,MAAM,CACZ,CAAC;IAEJ,IAAI,SAAc,CAAC;IAEnB,IAAI,CAAC;QAEH,SAAS;YACP,IAAI,GAAG,CACL,IAAI,CAAC,GAAG,CACT,CAAC;IAEN,CAAC;IAAC,MAAM,CAAC;QAEP,OAAO;YACL,QAAQ,EACN,OAAO;YAET,IAAI,EACF,aAAa;YAEf,aAAa,EACX,IAAI;YAEN,MAAM;YAEN,MAAM,EACJ,yDAAyD;SAC5D,CAAC;IACJ,CAAC;IAED,IACE,SAAS,CAAC,QAAQ,KAAK,QAAQ;QAC/B,SAAS,CAAC,QAAQ,KAAK,OAAO,EAC9B,CAAC;QAED,OAAO;YACL,QAAQ,EACN,OAAO;YAET,IAAI,EACF,sBAAsB;YAExB,aAAa,EACX,IAAI;YAEN,MAAM;YAEN,MAAM,EACJ,qCAAqC,SAAS,CAAC,QAAQ,EAAE;SAC5D,CAAC;IACJ,CAAC;IAED,IACE,iBAAiB,CAAC,GAAG,CACnB,MAAM,CACP,EACD,CAAC;QAED,OAAO;YACL,QAAQ,EACN,MAAM;YAER,IAAI,EACF,kBAAkB;YAEpB,aAAa,EACX,KAAK;YAEP,MAAM;YAEN,MAAM,EACJ,GAAG,MAAM,+DAA+D;SAC3E,CAAC;IACJ,CAAC;IAED,IACE,CAAC,0BAA0B,CAAC,GAAG,CAC7B,MAAM,CACP,EACD,CAAC;QAED,OAAO;YACL,QAAQ,EACN,OAAO;YAET,IAAI,EACF,yBAAyB;YAE3B,aAAa,EACX,IAAI;YAEN,MAAM;YAEN,MAAM,EACJ,uEAAuE,MAAM,IAAI,SAAS,GAAG;SAChG,CAAC;IACJ,CAAC;IAED,IACE,CAAC,QAAQ,CACP,IAAI,CAAC,QAAQ,CACd,EACD,CAAC;QAED,OAAO;YACL,QAAQ,EACN,OAAO;YAET,IAAI,EACF,kBAAkB;YAEpB,aAAa,EACX,IAAI;YAEN,MAAM;YAEN,MAAM,EACJ,0DAA0D;SAC7D,CAAC;IACJ,CAAC;IAED,IACE,CAAC,QAAQ,CACP,IAAI,CAAC,WAAW,CACjB,EACD,CAAC;QAED,OAAO;YACL,QAAQ,EACN,OAAO;YAET,IAAI,EACF,sBAAsB;YAExB,aAAa,EACX,IAAI;YAEN,MAAM;YAEN,MAAM,EACJ,0FAA0F;SAC7F,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EACN,SAAS;QAEX,IAAI,EACF,0BAA0B;QAE5B,aAAa,EACX,IAAI;QAEN,MAAM;QAEN,MAAM,EACJ,gGAAgG;KACnG,CAAC;AACJ,CAAC"}

package/dist/runtime/fetch-interceptor.d.ts

@@ -0,0 +1,66 @@
+import { type OnceRuntimePipelineResult } from "./pipeline.js";
+export declare class OnceRuntimeBlockedError extends Error {
+    readonly code: string;
+    readonly decision: OnceRuntimePipelineResult;
+    constructor(decision: OnceRuntimePipelineResult);
+}
+export type OnceProtectedFetchContext = {
+    request: Request;
+    decision: OnceRuntimePipelineResult;
+    provider: string | undefined;
+    /**
+     * Native fetch captured before interception.
+     *
+     * Protected handlers MUST use this for internal
+     * Once/provider network operations so they do
+     * not recursively re-enter the interceptor.
+     */
+    originalFetch: typeof fetch;
+};
+export type OnceProtectedFetchHandler = (context: OnceProtectedFetchContext) => Promise<Response>;
+export type OnceFetchInterceptorOptions = {
+    /**
+     * Runtime v0.1 may use one configured provider
+     * for every supported outbound write.
+     */
+    provider?: string;
+    /**
+     * Optional provider resolver for projects with
+     * multiple provider destinations.
+     */
+    resolveProvider?: (request: Request) => string | undefined | Promise<string | undefined>;
+    /**
+     * Optional application-specific identity hook.
+     *
+     * The returned value is treated as an explicit
+     * stable operation identity by the Runtime.
+     */
+    resolveOperationId?: (request: Request) => string | undefined | Promise<string | undefined>;
+    /**
+     * Called only when Runtime returns PROTECT.
+     *
+     * It must preserve fetch Response semantics.
+     */
+    protect: OnceProtectedFetchHandler;
+    /**
+     * Primarily for tests. Normally Runtime captures
+     * the native global fetch implementation.
+     */
+    fetchImpl?: typeof fetch;
+};
+/**
+ * Create a fetch-compatible Once interception
+ * function without mutating global state.
+ */
+export declare function createOnceFetchInterceptor(options: OnceFetchInterceptorOptions): typeof fetch;
+export type OnceFetchInstallation = {
+    restore: () => void;
+    fetch: typeof fetch;
+};
+/**
+ * Install Once at the process-wide fetch boundary.
+ *
+ * Installation is explicit and reversible.
+ */
+export declare function installOnceFetchInterceptor(options: OnceFetchInterceptorOptions): OnceFetchInstallation;
+//# sourceMappingURL=fetch-interceptor.d.ts.map

package/dist/runtime/fetch-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-interceptor.d.ts","sourceRoot":"","sources":["../../src/runtime/fetch-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,eAAe,CAAC;AAEvB,qBAAa,uBACX,SAAQ,KAAK;IAEb,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EACf,yBAAyB,CAAC;gBAG1B,QAAQ,EACN,yBAAyB;CAgB9B;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,OAAO,CAAC;IAEjB,QAAQ,EACN,yBAAyB,CAAC;IAE5B,QAAQ,EACN,MAAM,GAAG,SAAS,CAAC;IAErB;;;;;;OAMG;IACH,aAAa,EACX,OAAO,KAAK,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GACnC,CACE,OAAO,EACL,yBAAyB,KACxB,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEzB,MAAM,MAAM,2BAA2B,GAAG;IACxC;;;OAGG;IACH,QAAQ,CAAC,EACP,MAAM,CAAC;IAET;;;OAGG;IACH,eAAe,CAAC,EACd,CACE,OAAO,EAAE,OAAO,KAEhB,MAAM,GACN,SAAS,GACT,OAAO,CACL,MAAM,GACN,SAAS,CACV,CAAC;IAEN;;;;;OAKG;IACH,kBAAkB,CAAC,EACjB,CACE,OAAO,EAAE,OAAO,KAEhB,MAAM,GACN,SAAS,GACT,OAAO,CACL,MAAM,GACN,SAAS,CACV,CAAC;IAEN;;;;OAIG;IACH,OAAO,EACL,yBAAyB,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,EACR,OAAO,KAAK,CAAC;CAChB,CAAC;AA6GF;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EACL,2BAA2B,GAC5B,OAAO,KAAK,CA0Gd;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EACL,MAAM,IAAI,CAAC;IAEb,KAAK,EACH,OAAO,KAAK,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EACL,2BAA2B,GAC5B,qBAAqB,CA+CvB"}

package/dist/runtime/fetch-interceptor.js

@@ -0,0 +1,151 @@
+import { prepareHttpExecution } from "./pipeline.js";
+export class OnceRuntimeBlockedError extends Error {
+    code;
+    decision;
+    constructor(decision) {
+        super(`Once blocked outbound HTTP execution: ${decision.code}. ${decision.reason}`);
+        this.name =
+            "OnceRuntimeBlockedError";
+        this.code =
+            decision.code;
+        this.decision =
+            decision;
+    }
+}
+function headersToObject(headers) {
+    const result = {};
+    headers.forEach((value, key) => {
+        result[key] =
+            value;
+    });
+    return result;
+}
+async function inspectBody(request) {
+    const method = request.method
+        .trim()
+        .toUpperCase();
+    if (method === "GET" ||
+        method === "HEAD" ||
+        method === "OPTIONS") {
+        return undefined;
+    }
+    /*
+     * Identity v0.1 currently recognizes JSON-style
+     * body identity fields.
+     *
+     * Clone first so inspection never consumes the
+     * actual request body.
+     */
+    let clone;
+    try {
+        clone =
+            request.clone();
+    }
+    catch {
+        return undefined;
+    }
+    const contentType = clone.headers
+        .get("content-type")
+        ?.toLowerCase() ??
+        "";
+    if (!contentType.includes("application/json")) {
+        return undefined;
+    }
+    try {
+        const text = await clone.text();
+        return (text.length > 0
+            ? text
+            : undefined);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Create a fetch-compatible Once interception
+ * function without mutating global state.
+ */
+export function createOnceFetchInterceptor(options) {
+    const originalFetch = options.fetchImpl ??
+        globalThis.fetch;
+    if (typeof originalFetch !==
+        "function") {
+        throw new Error("Once Runtime requires a native fetch implementation.");
+    }
+    const intercepted = async (input, init) => {
+        /*
+         * Constructing a Request gives us one
+         * normalized view of URL, method, headers
+         * and body while preserving native fetch
+         * semantics for the final call.
+         */
+        const request = new Request(input, init);
+        const provider = options.resolveProvider
+            ? await options.resolveProvider(request)
+            : options.provider;
+        const explicitOperationId = options.resolveOperationId
+            ? await options.resolveOperationId(request)
+            : undefined;
+        const body = await inspectBody(request);
+        const decision = prepareHttpExecution({
+            method: request.method,
+            url: request.url,
+            provider,
+            operationId: explicitOperationId,
+            headers: headersToObject(request.headers),
+            body
+        });
+        if (decision.decision ===
+            "PASS") {
+            return await originalFetch(request);
+        }
+        if (decision.decision ===
+            "BLOCK") {
+            throw new OnceRuntimeBlockedError(decision);
+        }
+        return await options.protect({
+            request,
+            decision,
+            provider,
+            originalFetch
+        });
+    };
+    return intercepted;
+}
+/**
+ * Install Once at the process-wide fetch boundary.
+ *
+ * Installation is explicit and reversible.
+ */
+export function installOnceFetchInterceptor(options) {
+    const previous = globalThis.fetch;
+    const intercepted = createOnceFetchInterceptor({
+        ...options,
+        fetchImpl: options.fetchImpl ??
+            previous
+    });
+    globalThis.fetch =
+        intercepted;
+    let restored = false;
+    return {
+        fetch: intercepted,
+        restore: () => {
+            if (restored) {
+                return;
+            }
+            /*
+             * Restore only if our interceptor still
+             * owns global fetch. Do not overwrite a
+             * later runtime/framework replacement.
+             */
+            if (globalThis.fetch ===
+                intercepted) {
+                globalThis.fetch =
+                    previous;
+            }
+            restored =
+                true;
+        }
+    };
+}
+//# sourceMappingURL=fetch-interceptor.js.map

package/dist/runtime/fetch-interceptor.js.map

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

package/dist/runtime/identity.d.ts

@@ -0,0 +1,23 @@
+export type RuntimeIdentitySource = "explicit" | "header:idempotency-key" | "header:x-idempotency-key" | "body:once_operation_id" | "body:onceOperationId" | "body:operation_id" | "body:operationId" | "body:idempotency_key" | "body:idempotencyKey";
+export type RuntimeIdentityInput = {
+    method: string;
+    url: string;
+    operationId?: string;
+    headers?: Record<string, string | string[] | undefined>;
+    body?: unknown;
+};
+export type RuntimeIdentityResult = {
+    status: "FOUND";
+    operationId: string;
+    source: RuntimeIdentitySource;
+    reason: string;
+} | {
+    status: "REQUIRED";
+    reason: string;
+} | {
+    status: "CONFLICT";
+    sources: RuntimeIdentitySource[];
+    reason: string;
+};
+export declare function resolveHttpOperationIdentity(input: RuntimeIdentityInput): RuntimeIdentityResult;
+//# sourceMappingURL=identity.d.ts.map

package/dist/runtime/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/runtime/identity.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,qBAAqB,GAC7B,UAAU,GACV,wBAAwB,GACxB,0BAA0B,GAC1B,wBAAwB,GACxB,sBAAsB,GACtB,mBAAmB,GACnB,kBAAkB,GAClB,sBAAsB,GACtB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CACd,MAAM,EACN,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAC9B,CAAC;IACF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA8TN,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,oBAAoB,GAC1B,qBAAqB,CAiEvB"}

package/dist/runtime/identity.js

@@ -0,0 +1,191 @@
+import { createHash } from "node:crypto";
+const BODY_FIELDS = [
+    {
+        key: "once_operation_id",
+        source: "body:once_operation_id"
+    },
+    {
+        key: "onceOperationId",
+        source: "body:onceOperationId"
+    },
+    {
+        key: "operation_id",
+        source: "body:operation_id"
+    },
+    {
+        key: "operationId",
+        source: "body:operationId"
+    },
+    {
+        key: "idempotency_key",
+        source: "body:idempotency_key"
+    },
+    {
+        key: "idempotencyKey",
+        source: "body:idempotencyKey"
+    }
+];
+function clean(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const result = value.trim();
+    return result.length > 0
+        ? result
+        : null;
+}
+function normalizeMethod(value) {
+    return String(value || "")
+        .trim()
+        .toUpperCase();
+}
+function normalizeUrl(value) {
+    try {
+        const url = new URL(value);
+        if (url.protocol !== "https:" &&
+            url.protocol !== "http:") {
+            return null;
+        }
+        url.hash = "";
+        const params = Array.from(url.searchParams.entries()).sort(([ak, av], [bk, bv]) => ak.localeCompare(bk) ||
+            av.localeCompare(bv));
+        url.search = "";
+        for (const [key, item] of params) {
+            url.searchParams.append(key, item);
+        }
+        return url.toString();
+    }
+    catch {
+        return null;
+    }
+}
+function headerValue(headers, wanted) {
+    if (!headers) {
+        return null;
+    }
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() !==
+            wanted.toLowerCase()) {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            const valid = value
+                .map(clean)
+                .filter((item) => item !== null);
+            return valid.length === 1
+                ? valid[0]
+                : null;
+        }
+        return clean(value);
+    }
+    return null;
+}
+function bodyObject(body) {
+    if (body === null ||
+        body === undefined) {
+        return null;
+    }
+    if (typeof body === "string") {
+        try {
+            const parsed = JSON.parse(body);
+            if (parsed &&
+                typeof parsed === "object" &&
+                !Array.isArray(parsed)) {
+                return parsed;
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    if (typeof body === "object" &&
+        !Array.isArray(body)) {
+        return body;
+    }
+    return null;
+}
+function candidates(input) {
+    const result = [];
+    const explicit = clean(input.operationId);
+    if (explicit) {
+        result.push({
+            source: "explicit",
+            value: explicit
+        });
+    }
+    const normalHeader = headerValue(input.headers, "idempotency-key");
+    if (normalHeader) {
+        result.push({
+            source: "header:idempotency-key",
+            value: normalHeader
+        });
+    }
+    const alternateHeader = headerValue(input.headers, "x-idempotency-key");
+    if (alternateHeader) {
+        result.push({
+            source: "header:x-idempotency-key",
+            value: alternateHeader
+        });
+    }
+    const body = bodyObject(input.body);
+    if (body) {
+        for (const field of BODY_FIELDS) {
+            const value = clean(body[field.key]);
+            if (value) {
+                result.push({
+                    source: field.source,
+                    value
+                });
+            }
+        }
+    }
+    return result;
+}
+function buildOperationId(method, url, identity) {
+    const hash = createHash("sha256");
+    hash.update("once-runtime-http-id-v1\u0000", "utf8");
+    for (const value of [method, url, identity]) {
+        const bytes = Buffer.from(value, "utf8");
+        const length = Buffer.allocUnsafe(4);
+        length.writeUInt32BE(bytes.length, 0);
+        hash.update(length);
+        hash.update(bytes);
+    }
+    return ("http:" +
+        hash
+            .digest("hex")
+            .slice(0, 32));
+}
+export function resolveHttpOperationIdentity(input) {
+    const method = normalizeMethod(input.method);
+    const url = normalizeUrl(input.url);
+    if (!url) {
+        return {
+            status: "REQUIRED",
+            reason: "A valid HTTP(S) destination is required."
+        };
+    }
+    const found = candidates(input);
+    if (found.length === 0) {
+        return {
+            status: "REQUIRED",
+            reason: "No trustworthy stable identity carrier was found. Runtime refuses to guess."
+        };
+    }
+    const values = Array.from(new Set(found.map(item => item.value)));
+    if (values.length !== 1) {
+        return {
+            status: "CONFLICT",
+            sources: found.map(item => item.source),
+            reason: "Stable identity carriers disagree. Runtime refuses ambiguous identity."
+        };
+    }
+    return {
+        status: "FOUND",
+        operationId: buildOperationId(method, url, values[0]),
+        source: found[0].source,
+        reason: "Stable identity found and deterministically bound to this HTTP operation."
+    };
+}
+//# sourceMappingURL=identity.js.map

package/dist/runtime/identity.js.map

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

package/dist/runtime/pipeline.d.ts

@@ -0,0 +1,25 @@
+import { type OnceRuntimeDecision, type OnceRuntimeDecisionCode } from "./decision.js";
+import { type RuntimeIdentitySource, type RuntimeIdentityResult } from "./identity.js";
+type RuntimeIdentityStatus = RuntimeIdentityResult["status"];
+export type OnceRuntimePipelineCode = OnceRuntimeDecisionCode | "IDENTITY_REQUIRED" | "IDENTITY_CONFLICT";
+export type OnceRuntimeHttpRequest = {
+    method: string;
+    url: string;
+    provider?: string;
+    operationId?: string;
+    headers?: Record<string, string | string[] | undefined>;
+    body?: unknown;
+};
+export type OnceRuntimePipelineResult = {
+    decision: OnceRuntimeDecision;
+    code: OnceRuntimePipelineCode;
+    consequential: boolean;
+    method: string;
+    reason: string;
+    operationId?: string;
+    identitySource?: RuntimeIdentitySource;
+    identityStatus: RuntimeIdentityStatus;
+};
+export declare function prepareHttpExecution(request: OnceRuntimeHttpRequest): OnceRuntimePipelineResult;
+export {};
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/runtime/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/runtime/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC7B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC;AAEvB,KAAK,qBAAqB,GACxB,qBAAqB,CAAC,QAAQ,CAAC,CAAC;AAElC,MAAM,MAAM,uBAAuB,GAC/B,uBAAuB,GACvB,mBAAmB,GACnB,mBAAmB,CAAC;AAExB,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,OAAO,CAAC,EAAE,MAAM,CACd,MAAM,EACN,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAC9B,CAAC;IAEF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,IAAI,EAAE,uBAAuB,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IAEf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,cAAc,EAAE,qBAAqB,CAAC;CACvC,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,sBAAsB,GAC9B,yBAAyB,CA6P3B"}