@vibesdotdev/forge 0.0.0-stage → 1.0.0-rc.5

package/dist/request.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Isomorphic Forge HTTP request and response contracts.
+ *
+ * This module uses only JavaScript and Web-standard APIs. Authentication,
+ * environment resolution and credential storage belong to the CLI, tools,
+ * worker, or web surface that invokes these pure helpers. A response parses
+ * into its data or a typed `CapabilityError`: a server's body or message never
+ * enters a failure's text, details or message; it rides only as a redacted
+ * `cause`, with the request's credential passed as a secret.
+ */
+import { CapabilityError, type ValueFreeFailure } from "@vibesdotdev/kernel";
+import type { JsonValue } from "@vibesdotdev/kernel/schemas/json";
+export interface ForgeRequestSpec {
+    method: "GET" | "POST" | "DELETE" | "PATCH";
+    path: string;
+    query?: Record<string, string | number | boolean | undefined | null>;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+export interface BuiltRequest {
+    url: string;
+    init: {
+        method: string;
+        headers: Record<string, string>;
+        body?: string;
+    };
+}
+export type FetchLike = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+    /** Whether a browser host may attach its cookies; Forge presents its credential explicitly. */
+    credentials?: "omit" | "same-origin" | "include";
+}) => Promise<{
+    status: number;
+    ok: boolean;
+    text: () => Promise<string>;
+}>;
+/**
+ * The fetch a Forge transport uses when its caller injects none: the selected
+ * host's WHATWG `fetch`. The runtime declares no fetch kind yet (owed by the
+ * Runtime post-seal pass); this is the one place the transports read it, so
+ * moving to the runtime's fetch is one edit.
+ */
+export declare const forgeHostFetch: FetchLike;
+/** A failed Forge response: value-free text and the typed failure. */
+export interface ForgeFailureResponse {
+    ok: false;
+    status: number;
+    /** Value-free text naming the failure; never the server's body or message. */
+    message: string;
+    /** The server's error code, only when it is a plain identifier that carries no credential. */
+    code?: string;
+    retryable?: boolean;
+    /** The typed failure. `parseResponse` always sets it; `forgeResponseFailure` answers it for any failure. */
+    error?: CapabilityError;
+}
+export type ForgeResponse<T> = {
+    ok: true;
+    status: number;
+    data: T;
+} | ForgeFailureResponse;
+/**
+ * The forge could not name a service origin: the runtime's `NOT_FOUND`
+ * `service-undeclared` (rc04 §2.4), so callers matching either the class or
+ * the typed shape see the same failure.
+ */
+export declare class ForgeOriginUnavailableError extends CapabilityError {
+    readonly code: "NOT_FOUND";
+    constructor(options?: {
+        serviceId?: string;
+        cause?: unknown;
+    });
+}
+/** No caller credential: `AUTH_REQUIRED` `not-signed-in`, the same shape auth refuses with. */
+export declare class ForgeNotSignedInError extends CapabilityError {
+    readonly code: "AUTH_REQUIRED";
+    constructor();
+}
+/**
+ * The stored session could not be exchanged for an app token. The auth
+ * server's answer rides only as the redacted `cause`.
+ */
+export declare class ForgeJwtMintError extends CapabilityError {
+    constructor(status: number, options?: {
+        authOrigin?: string;
+        cause?: unknown;
+    });
+}
+/** One response body read as JSON: empty, a JSON value, or not JSON (named by value-free facts only). */
+export type ForgeJsonBody = {
+    readonly outcome: "empty";
+} | {
+    readonly outcome: "parsed";
+    readonly value: JsonValue;
+} | {
+    readonly outcome: "not-json";
+    readonly failure: ValueFreeFailure;
+};
+export declare function readForgeJsonBody(text: string): ForgeJsonBody;
+/** The body's JSON value; an empty or non-JSON body has none. */
+export declare function safeJsonParse(text: string): JsonValue | undefined;
+/** What a platform error envelope says about itself. Server text: never a failure's message. */
+export interface ForgeErrorDetails {
+    message?: string;
+    code?: string;
+    retryable?: boolean;
+}
+export declare function extractForgeErrorDetails(parsed: JsonValue | undefined): ForgeErrorDetails;
+export declare function withQuery(path: string, query?: ForgeRequestSpec["query"]): string;
+export declare function buildRequest(spec: ForgeRequestSpec, origin: string, token: string): BuiltRequest;
+/**
+ * A Forge response as data or a typed failure. The body is never passed
+ * through: a 2xx whose body is not JSON is `UNAVAILABLE`
+ * `forge-response-not-json`, and a failed status is its status's typed
+ * failure (`forge-not-found`, `forge-conflict`, …). The server's body, message
+ * and validation text ride only as the redacted `cause`, with `secrets` (the
+ * request's credential) removed; the details carry only the status, a safe
+ * server code and validation field paths.
+ */
+export declare function parseResponse<T>(status: number, ok: boolean, text: string, secrets?: readonly string[]): ForgeResponse<T>;
+/**
+ * The typed failure of a failed Forge response: the one `parseResponse`
+ * attached, else one built from its status and safe code alone (a response a
+ * caller assembled by hand never carries its message into the failure).
+ */
+export declare function forgeResponseFailure(response: ForgeFailureResponse): CapabilityError;
+export declare function formatForgeRequestFailure(response: {
+    status: number;
+    message: string;
+    code?: string;
+    error?: CapabilityError;
+}): string;
+//# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

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

package/dist/request.js

@@ -0,0 +1,362 @@
+/**
+ * Isomorphic Forge HTTP request and response contracts.
+ *
+ * This module uses only JavaScript and Web-standard APIs. Authentication,
+ * environment resolution and credential storage belong to the CLI, tools,
+ * worker, or web surface that invokes these pure helpers. A response parses
+ * into its data or a typed `CapabilityError`: a server's body or message never
+ * enters a failure's text, details or message; it rides only as a redacted
+ * `cause`, with the request's credential passed as a secret.
+ */
+import * as z from "zod/v4";
+import { redactCredentials } from "@vibesdotdev/shared/utils";
+import { CapabilityError, CaughtFailureSchema, valueFreeFailure, } from "@vibesdotdev/kernel";
+import { redactedCause } from "./failures.js";
+const SAFE_ERROR_CODE = /^[A-Za-z][A-Za-z0-9_-]{0,127}$/;
+/**
+ * The fetch a Forge transport uses when its caller injects none: the selected
+ * host's WHATWG `fetch`. The runtime declares no fetch kind yet (owed by the
+ * Runtime post-seal pass); this is the one place the transports read it, so
+ * moving to the runtime's fetch is one edit.
+ */
+export const forgeHostFetch = (url, init) => fetch(url, init);
+/**
+ * The forge could not name a service origin: the runtime's `NOT_FOUND`
+ * `service-undeclared` (rc04 §2.4), so callers matching either the class or
+ * the typed shape see the same failure.
+ */
+export class ForgeOriginUnavailableError extends CapabilityError {
+    constructor(options = {}) {
+        const serviceId = options.serviceId ?? "platform";
+        super(`Could not resolve the ${serviceId} origin: this host declares no \`${serviceId}\` ` +
+            "infra/service for its configured service environment (infra.services.environment). " +
+            "Select a service catalog that declares it, or pass an explicit origin.", "NOT_FOUND", { reason: "service-undeclared", details: { serviceId }, cause: options.cause });
+        this.name = "ForgeOriginUnavailableError";
+    }
+}
+/** No caller credential: `AUTH_REQUIRED` `not-signed-in`, the same shape auth refuses with. */
+export class ForgeNotSignedInError extends CapabilityError {
+    constructor() {
+        super("Not signed in. Authenticate through the active surface before calling Forge; CLI users can run `vibes auth login`.", "AUTH_REQUIRED", { reason: "not-signed-in", recoveryHint: "Run: vibes auth login" });
+        this.name = "ForgeNotSignedInError";
+    }
+}
+/** The origin of `url` (never its userinfo, path or query), when it parses. */
+function originOf(url) {
+    return url !== undefined && URL.canParse(url) ? new URL(url).origin : undefined;
+}
+/**
+ * The stored session could not be exchanged for an app token. The auth
+ * server's answer rides only as the redacted `cause`.
+ */
+export class ForgeJwtMintError extends CapabilityError {
+    constructor(status, options = {}) {
+        super("Could not exchange the stored session for an app token.", status === 401 || status === 403 ? "AUTH_REQUIRED" : "UNAVAILABLE", {
+            reason: "app-token-mint-failed",
+            recoveryHint: "If this is not the auth origin you expected, set this host's infra.services.environment; " +
+                "if it is, the session may have expired: run `vibes auth login` again.",
+            details: { status, authOrigin: originOf(options.authOrigin) },
+            cause: options.cause,
+        });
+        this.name = "ForgeJwtMintError";
+    }
+}
+export function readForgeJsonBody(text) {
+    if (text.trim().length === 0)
+        return { outcome: "empty" };
+    try {
+        return { outcome: "parsed", value: JSON.parse(text) };
+    }
+    catch (error) {
+        // A body that is not JSON is this read's declared outcome. The parser's
+        // own message quotes the body, so only its value-free facts are kept.
+        return { outcome: "not-json", failure: valueFreeFailure(CaughtFailureSchema.parse(error)) };
+    }
+}
+/** The body's JSON value; an empty or non-JSON body has none. */
+export function safeJsonParse(text) {
+    const body = readForgeJsonBody(text);
+    return body.outcome === "parsed" ? body.value : undefined;
+}
+/** One zod issue a platform 400 carries; a malformed entry reads as `null` and is skipped. */
+const ServerIssueSchema = z
+    .object({
+    path: z.array(z.union([z.string(), z.number()])).optional().catch(undefined),
+    message: z.string().optional().catch(undefined),
+})
+    .nullable()
+    .catch(null);
+/** The error fields a platform envelope may carry; each field reads on its own. */
+const ServerErrorFieldsSchema = z.object({
+    message: z.string().optional().catch(undefined),
+    code: z.string().optional().catch(undefined),
+    retryable: z.boolean().optional().catch(undefined),
+    issues: z.array(ServerIssueSchema).optional().catch(undefined),
+    errors: z.array(ServerIssueSchema).optional().catch(undefined),
+});
+const ServerErrorBodySchema = ServerErrorFieldsSchema.extend({
+    error: z
+        .union([
+        z.string().transform((text) => ({ kind: "text", text })),
+        ServerErrorFieldsSchema.transform((fields) => ({ kind: "fields", fields })),
+    ])
+        .optional()
+        .catch(undefined),
+    result: z.object({ reason: z.string().optional().catch(undefined) }).optional().catch(undefined),
+});
+/** The envelope's error fields; a body that is not an object has none. */
+function readServerErrorBody(body) {
+    const parsed = ServerErrorBodySchema.safeParse(body);
+    return parsed.success ? parsed.data : {};
+}
+/**
+ * Render the zod `issues` array the platform returns alongside a 400 so a
+ * validation failure names the field that failed.
+ */
+function formatValidationIssues(issues) {
+    if (!issues || issues.length === 0)
+        return undefined;
+    const lines = [];
+    for (const issue of issues.slice(0, 12)) {
+        if (!issue)
+            continue;
+        const path = issue.path?.join(".");
+        const message = issue.message ?? "invalid value";
+        lines.push(path ? `  ${path}: ${message}` : `  ${message}`);
+    }
+    if (lines.length === 0)
+        return undefined;
+    const omitted = issues.length - lines.length;
+    if (omitted > 0)
+        lines.push(`  … and ${omitted} more`);
+    return lines.join("\n");
+}
+/** The envelope's nested `error` fields, when `error` is an object. */
+function nestedErrorFields(body) {
+    return body.error?.kind === "fields" ? body.error.fields : undefined;
+}
+/** The envelope's error code when it is a plain identifier, and its retry hint. */
+function readServerFacts(body) {
+    const nested = nestedErrorFields(body);
+    const rawCode = nested?.code ?? body.code;
+    const facts = {};
+    if (rawCode !== undefined && SAFE_ERROR_CODE.test(rawCode))
+        facts.code = rawCode;
+    const retryable = nested?.retryable ?? body.retryable;
+    if (retryable !== undefined)
+        facts.retryable = retryable;
+    return facts;
+}
+export function extractForgeErrorDetails(parsed) {
+    const body = readServerErrorBody(parsed);
+    const nested = nestedErrorFields(body);
+    const errorText = body.error?.kind === "text" ? body.error.text : undefined;
+    const message = nested?.message ?? body.message ?? errorText ?? body.result?.reason;
+    const issues = formatValidationIssues(nested?.issues ?? body.issues) ??
+        formatValidationIssues(nested?.errors ?? body.errors);
+    const detailedMessage = message && issues ? `${message}\n${issues}` : (message ?? issues);
+    const result = readServerFacts(body);
+    if (detailedMessage)
+        result.message = detailedMessage;
+    return result;
+}
+export function withQuery(path, query) {
+    if (!query)
+        return path;
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null)
+            continue;
+        params.set(key, String(value));
+    }
+    const queryString = params.toString();
+    return queryString.length > 0 ? `${path}?${queryString}` : path;
+}
+export function buildRequest(spec, origin, token) {
+    const url = `${origin.replace(/\/$/, "")}${withQuery(spec.path, spec.query)}`;
+    const headers = {
+        ...spec.headers,
+        Authorization: `Bearer ${token}`,
+    };
+    const init = { method: spec.method, headers };
+    if (spec.body !== undefined && spec.method !== "GET") {
+        init.headers["Content-Type"] = "application/json";
+        init.body = JSON.stringify(spec.body);
+    }
+    return { url, init };
+}
+function forgeStatusFailure(status) {
+    if (status === 400 || status === 422) {
+        return { code: "INVALID_INPUT", reason: "forge-request-invalid", message: "Forge rejected the request as invalid." };
+    }
+    if (status === 401) {
+        return { code: "AUTH_REQUIRED", reason: "forge-auth-required", message: "Forge did not accept the request credential." };
+    }
+    if (status === 403) {
+        return { code: "PERMISSION_DENIED", reason: "forge-permission-denied", message: "Forge denied the request." };
+    }
+    if (status === 404 || status === 410) {
+        return {
+            code: "NOT_FOUND",
+            reason: "forge-not-found",
+            message: "Forge found no such resource, or it is not visible to this caller.",
+        };
+    }
+    if (status === 409 || status === 412) {
+        return {
+            code: "CONFLICT",
+            reason: "forge-conflict",
+            message: "Forge refused the request because it conflicts with the current state.",
+        };
+    }
+    if (status === 429) {
+        return { code: "RATE_LIMITED", reason: "forge-rate-limited", message: "Forge rate-limited the request." };
+    }
+    if (status === 408 || status === 504) {
+        return { code: "TIMEOUT", reason: "forge-timeout", message: "Forge timed out answering the request." };
+    }
+    if (status >= 500 && status <= 599) {
+        return { code: "UNAVAILABLE", reason: "forge-unavailable", message: "Forge could not answer the request." };
+    }
+    return { code: "INTERNAL", reason: "forge-request-failed", message: "Forge answered with an unexpected status." };
+}
+/** A field path segment a failure's details may name: a plain identifier or a list index. */
+const FIELD_SEGMENT = /^(?:[A-Za-z_][A-Za-z0-9_-]{0,63}|\d{1,6})$/;
+const MAX_FAILURE_FIELDS = 12;
+/** Whether `text` reads the same after the shared redaction: no credential-shaped token, no secret. */
+function carriesNoCredential(text, secrets) {
+    return redactCredentials(text, secrets) === text;
+}
+/**
+ * The field paths a 400's validation issues name, for a failure's details:
+ * only paths whose every segment is a plain identifier or index and that
+ * carry no credential, at most twelve. The issues' messages are never read.
+ */
+function validationFields(body, secrets) {
+    const nested = nestedErrorFields(body);
+    const issues = [
+        ...(nested?.issues ?? body.issues ?? []),
+        ...(nested?.errors ?? body.errors ?? []),
+    ];
+    const fields = [];
+    for (const issue of issues) {
+        if (fields.length === MAX_FAILURE_FIELDS)
+            break;
+        const segments = issue?.path?.map(String) ?? [];
+        if (segments.length === 0 || segments.length > 8 || !segments.every((segment) => FIELD_SEGMENT.test(segment)))
+            continue;
+        const field = segments.join(".");
+        if (!fields.includes(field) && carriesNoCredential(field, secrets))
+            fields.push(field);
+    }
+    return fields;
+}
+function forgeFailure(facts) {
+    const failure = forgeStatusFailure(facts.status);
+    const details = { status: facts.status };
+    if (facts.serverCode !== undefined)
+        details.serverCode = facts.serverCode;
+    if (facts.fields !== undefined && facts.fields.length > 0)
+        details.fields = [...facts.fields];
+    return new CapabilityError(failure.message, failure.code, {
+        reason: failure.reason,
+        retryable: facts.retryable,
+        details,
+        cause: facts.cause,
+    });
+}
+/**
+ * A Forge response as data or a typed failure. The body is never passed
+ * through: a 2xx whose body is not JSON is `UNAVAILABLE`
+ * `forge-response-not-json`, and a failed status is its status's typed
+ * failure (`forge-not-found`, `forge-conflict`, …). The server's body, message
+ * and validation text ride only as the redacted `cause`, with `secrets` (the
+ * request's credential) removed; the details carry only the status, a safe
+ * server code and validation field paths.
+ */
+export function parseResponse(status, ok, text, secrets = []) {
+    const body = readForgeJsonBody(text);
+    if (ok) {
+        if (body.outcome === "not-json") {
+            const error = new CapabilityError("Forge answered successfully, but its body was not JSON.", "UNAVAILABLE", {
+                reason: "forge-response-not-json",
+                retryable: true,
+                details: { status, bytes: text.length, parseFailure: body.failure.name },
+                cause: redactedCause(text, secrets),
+            });
+            return { ok: false, status, message: error.message, retryable: true, error };
+        }
+        // SAFETY: the body read above is JSON or empty; `T` is the envelope the caller declares for its route, and callers read it through their own guards (`requireForgeToolData`).
+        return { ok: true, status, data: (body.outcome === "parsed" ? body.value : undefined) };
+    }
+    const server = readServerErrorBody(body.outcome === "parsed" ? body.value : undefined);
+    const { code, retryable } = readServerFacts(server);
+    const serverCode = code !== undefined && carriesNoCredential(code, secrets) ? code : undefined;
+    const facts = { status, fields: validationFields(server, secrets) };
+    if (serverCode !== undefined)
+        facts.serverCode = serverCode;
+    if (retryable !== undefined)
+        facts.retryable = retryable;
+    if (body.outcome !== "empty")
+        facts.cause = redactedCause(text, secrets);
+    const error = forgeFailure(facts);
+    const failure = { ok: false, status, message: error.message, error };
+    if (serverCode !== undefined)
+        failure.code = serverCode;
+    if (retryable !== undefined)
+        failure.retryable = retryable;
+    return failure;
+}
+/**
+ * The typed failure of a failed Forge response: the one `parseResponse`
+ * attached, else one built from its status and safe code alone (a response a
+ * caller assembled by hand never carries its message into the failure).
+ */
+export function forgeResponseFailure(response) {
+    if (response.error)
+        return response.error;
+    const facts = { status: response.status };
+    if (response.code !== undefined && SAFE_ERROR_CODE.test(response.code) && carriesNoCredential(response.code, [])) {
+        facts.serverCode = response.code;
+    }
+    if (response.retryable !== undefined)
+        facts.retryable = response.retryable;
+    return forgeFailure(facts);
+}
+/** C0 and C1 control characters, which a terminal would interpret. */
+function isControlCharacter(char) {
+    const point = char.codePointAt(0) ?? 0;
+    return point <= 0x1f || (point >= 0x7f && point <= 0x9f);
+}
+/** `text` with each run of control characters replaced by one space. */
+function withoutControlCharacters(text) {
+    let result = "";
+    let inRun = false;
+    for (const char of text) {
+        if (isControlCharacter(char)) {
+            if (!inRun)
+                result += " ";
+            inRun = true;
+            continue;
+        }
+        result += char;
+        inRun = false;
+    }
+    return result;
+}
+const FieldListSchema = z.array(z.string()).max(MAX_FAILURE_FIELDS);
+export function formatForgeRequestFailure(response) {
+    const status = Number.isInteger(response.status) &&
+        response.status >= 100 &&
+        response.status <= 599
+        ? String(response.status)
+        : "unknown status";
+    const code = response.code !== undefined && SAFE_ERROR_CODE.test(response.code)
+        ? `, ${response.code}`
+        : "";
+    const message = withoutControlCharacters(response.message).trim().slice(0, 500);
+    const fields = FieldListSchema.safeParse(response.error?.details?.fields);
+    const named = fields.success && fields.data.length > 0 ? ` Fields: ${fields.data.join(", ")}.` : "";
+    return `Request failed (${status}${code}): ${message || "No error message was returned"}${named}`;
+}
+//# sourceMappingURL=request.js.map

package/dist/request.js.map

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