@cavi-ai/api-client 0.1.0

package/dist/core/gateway/client/capabilities.js

@@ -0,0 +1,288 @@
+import { extractGatewayCommandCatalog, } from "../agent/commands.js";
+import { GATEWAY_MEDIA_KINDS, } from "../resources/media.js";
+const MEDIA_KIND_KEYS = {
+    audio: ["audio", "media.audio", "audioGeneration", "audio_generation"],
+    image: ["image", "media.image", "imageGeneration", "image_generation"],
+    video: ["video", "media.video", "videoGeneration", "video_generation"],
+    music: ["music", "media.music", "musicGeneration", "music_generation"],
+};
+const TTS_KEYS = [
+    "tts",
+    "textToSpeech",
+    "text_to_speech",
+    "speech",
+    "speechSynthesis",
+    "speech_synthesis",
+    "media.tts",
+    "media.textToSpeech",
+];
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function normalizeKey(key) {
+    return key.trim().toLowerCase().replace(/[^a-z0-9]/gu, "");
+}
+function normalizeName(value) {
+    return value.trim().toLowerCase();
+}
+function hasEnabledValue(value) {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "number")
+        return value > 0;
+    if (typeof value === "string") {
+        const normalized = normalizeName(value);
+        return ["available", "enabled", "true", "supported", "ready", "ok"].includes(normalized);
+    }
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (isRecord(value)) {
+        for (const key of ["enabled", "supported", "available", "configured"]) {
+            if (key in value)
+                return hasEnabledValue(value[key]);
+        }
+        if (typeof value.status === "string")
+            return hasEnabledValue(value.status);
+        return Object.keys(value).length > 0;
+    }
+    return false;
+}
+function collectFeatureValues(value, out, prefix = "") {
+    if (!isRecord(value))
+        return;
+    for (const [key, entry] of Object.entries(value)) {
+        const name = prefix ? `${prefix}.${key}` : key;
+        out.set(normalizeKey(name), entry);
+        out.set(normalizeKey(key), entry);
+        if (isRecord(entry)) {
+            collectFeatureValues(entry, out, name);
+        }
+    }
+}
+function hasFeature(features, keys) {
+    return keys.some((key) => {
+        const value = features.get(normalizeKey(key));
+        return value !== undefined && hasEnabledValue(value);
+    });
+}
+function maybeProviderList(value) {
+    if (!isRecord(value) || !Array.isArray(value.providers))
+        return null;
+    return value;
+}
+function flattenMediaProviders(input) {
+    if (!input)
+        return [];
+    const directList = maybeProviderList(input);
+    if (directList)
+        return [...directList.providers];
+    if (!Array.isArray(input))
+        return [];
+    const out = [];
+    for (const entry of input) {
+        const list = maybeProviderList(entry);
+        if (list) {
+            out.push(...list.providers);
+            continue;
+        }
+        if (isRecord(entry) && typeof entry.id === "string") {
+            out.push(entry);
+        }
+    }
+    return out;
+}
+function normalizeMediaKind(kind) {
+    if (typeof kind !== "string")
+        return null;
+    const normalized = normalizeName(kind);
+    return GATEWAY_MEDIA_KINDS.includes(normalized)
+        ? normalized
+        : null;
+}
+function providerImpliesKind(provider) {
+    if (provider.configured === false)
+        return null;
+    return normalizeMediaKind(provider.kind);
+}
+function providerImpliesTts(provider) {
+    if (provider.configured === false)
+        return false;
+    if (provider.voices && provider.voices.length > 0)
+        return true;
+    if (!provider.metadata)
+        return false;
+    return hasEnabledValue(provider.metadata.tts) ||
+        hasEnabledValue(provider.metadata.textToSpeech) ||
+        hasEnabledValue(provider.metadata.text_to_speech);
+}
+function tokenizeHint(value) {
+    return value
+        .replace(/([a-z0-9])([A-Z])/gu, "$1 $2")
+        .toLowerCase()
+        .split(/[^a-z0-9]+/u)
+        .filter(Boolean)
+        .map(normalizeKey);
+}
+function collectEndpointHints(capabilities) {
+    if (!capabilities?.endpoints)
+        return [];
+    const hints = [];
+    for (const [name, endpoint] of Object.entries(capabilities.endpoints)) {
+        hints.push(tokenizeHint(name));
+        if (isRecord(endpoint)) {
+            hints.push(...Object.keys(endpoint).map(tokenizeHint));
+            if (typeof endpoint.path === "string")
+                hints.push(tokenizeHint(endpoint.path));
+        }
+    }
+    return hints.filter((hint) => hint.length > 0);
+}
+function endpointHintsInclude(endpointHints, keys) {
+    const normalized = keys.map(normalizeKey);
+    return endpointHints.some((hint) => normalized.some((key) => hint.includes(key)));
+}
+function endpointHintsIncludeAll(endpointHints, keys) {
+    const normalized = keys.map(normalizeKey);
+    return endpointHints.some((hint) => normalized.every((key) => hint.includes(key)));
+}
+function collectStringEntries(value, out) {
+    if (typeof value === "string") {
+        const normalized = value.trim();
+        if (normalized)
+            out.add(normalized);
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const entry of value)
+            collectStringEntries(entry, out);
+        return;
+    }
+    if (!isRecord(value))
+        return;
+    for (const key of [
+        "id",
+        "name",
+        "method",
+        "action",
+        "command",
+        "insert",
+        "label",
+    ]) {
+        collectStringEntries(value[key], out);
+    }
+}
+function collectNamedCapabilityList(capabilities, keys) {
+    const out = new Set();
+    const root = isRecord(capabilities) ? capabilities : {};
+    const features = isRecord(capabilities?.features)
+        ? capabilities.features
+        : {};
+    const runtime = isRecord(capabilities?.runtime)
+        ? capabilities.runtime
+        : {};
+    for (const key of keys) {
+        collectStringEntries(root[key], out);
+        collectStringEntries(features[key], out);
+        collectStringEntries(runtime[key], out);
+    }
+    return [...out];
+}
+function commandNames(commands) {
+    return commands
+        .map((command) => command.insert || command.label)
+        .map((command) => command.trim())
+        .filter(Boolean);
+}
+function isNormalized(input) {
+    if (!isRecord(input))
+        return false;
+    const record = input;
+    return typeof record.media === "boolean" &&
+        isRecord(record.mediaKinds) &&
+        Array.isArray(record.rpcMethods) &&
+        Array.isArray(record.actions) &&
+        Array.isArray(record.commands);
+}
+function normalizeInput(input) {
+    if (isNormalized(input))
+        return input;
+    return normalizeGatewayFeatureCapabilities({ capabilities: input ?? null });
+}
+export function normalizeGatewayFeatureCapabilities(options = {}) {
+    const capabilities = options.capabilities ?? null;
+    const rawFeatures = isRecord(capabilities?.features) ? capabilities.features : {};
+    const features = new Map();
+    collectFeatureValues(rawFeatures, features);
+    collectFeatureValues(capabilities?.runtime, features);
+    const endpointHints = collectEndpointHints(capabilities);
+    const providers = flattenMediaProviders(options.mediaProviders);
+    const mediaKinds = Object.fromEntries(GATEWAY_MEDIA_KINDS.map((kind) => {
+        const providerSupported = providers.some((provider) => providerImpliesKind(provider) === kind);
+        const featureSupported = hasFeature(features, MEDIA_KIND_KEYS[kind]);
+        const endpointSupported = endpointHintsIncludeAll(endpointHints, ["media", kind]);
+        return [kind, providerSupported || featureSupported || endpointSupported];
+    }));
+    const textToSpeech = hasFeature(features, TTS_KEYS) ||
+        providers.some(providerImpliesTts);
+    if (textToSpeech) {
+        mediaKinds.audio = true;
+    }
+    const media = Object.values(mediaKinds).some(Boolean) ||
+        hasFeature(features, ["media", "mediaGeneration", "media_generation"]) ||
+        endpointHintsInclude(endpointHints, ["media"]);
+    const wiki = hasFeature(features, ["wiki", "knowledge", "vault"]) ||
+        endpointHintsInclude(endpointHints, ["wiki", "vault"]);
+    const sse = hasFeature(features, ["sse", "eventStream", "event_stream"]) ||
+        endpointHintsInclude(endpointHints, ["events", "stream", "sse"]);
+    const websocket = hasFeature(features, ["websocket", "webSocket", "ws"]) ||
+        endpointHintsInclude(endpointHints, ["websocket", "socket", "ws"]);
+    const rpcMethods = collectNamedCapabilityList(capabilities, [
+        "rpcMethods",
+        "rpc_methods",
+        "methods",
+    ]);
+    const actions = collectNamedCapabilityList(capabilities, [
+        "actions",
+        "actionCatalog",
+        "action_catalog",
+        "tools",
+    ]);
+    const commands = commandNames(extractGatewayCommandCatalog(capabilities));
+    const rpc = rpcMethods.length > 0 ||
+        hasFeature(features, ["rpc", "jsonRpc", "json_rpc"]) ||
+        websocket;
+    return {
+        media,
+        mediaKinds,
+        textToSpeech,
+        wiki,
+        sse,
+        websocket,
+        rpc,
+        rpcMethods,
+        actions,
+        commands,
+        rawFeatures,
+    };
+}
+export function gatewaySupportsMediaKind(input, kind) {
+    const normalizedKind = normalizeMediaKind(kind);
+    if (!normalizedKind)
+        return false;
+    return normalizeInput(input).mediaKinds[normalizedKind];
+}
+export function gatewaySupportsTextToSpeech(input) {
+    return normalizeInput(input).textToSpeech;
+}
+export function gatewaySupportsAction(input, action) {
+    const normalizedAction = normalizeName(action);
+    if (!normalizedAction)
+        return false;
+    return normalizeInput(input).actions.some((candidate) => normalizeName(candidate) === normalizedAction);
+}
+export function gatewaySupportsRpcMethod(input, method) {
+    const normalizedMethod = normalizeName(method);
+    if (!normalizedMethod)
+        return false;
+    return normalizeInput(input).rpcMethods.some((candidate) => normalizeName(candidate) === normalizedMethod);
+}

package/dist/core/gateway/client/client.d.ts

@@ -0,0 +1,106 @@
+import { BaseHttpApiClient } from "../../http/client.js";
+import type { HttpApiClientOptions, HttpApiTransport } from "../../http/types.js";
+import type { GatewayCommandCapabilities } from "../agent/commands.js";
+import { type NormalizeGatewayFeatureCapabilitiesOptions, type NormalizedGatewayFeatureCapabilities } from "./capabilities.js";
+export type GatewayCapabilities = GatewayCommandCapabilities & {
+    object?: string;
+    platform?: string;
+    model?: string;
+    auth?: {
+        type?: string;
+        required?: boolean;
+    };
+    features: Record<string, unknown>;
+    endpoints?: Record<string, {
+        method: string;
+        path: string;
+    }>;
+    runtime?: Record<string, unknown>;
+};
+export type GatewayRunStatus = {
+    object?: string;
+    run_id: string;
+    status: "started" | "running" | "completed" | "failed" | "cancelled" | "stopping" | string;
+    session_id?: string;
+    model?: string;
+    targetProfile?: string;
+    task_id?: string;
+    routing?: {
+        kind?: string;
+        targetProfile?: string | null;
+        taskId?: string | null;
+        workerEventStream?: boolean;
+        decision?: Record<string, unknown>;
+    };
+    output?: string;
+    response?: string;
+    error?: string;
+    usage?: Record<string, number>;
+    events?: Record<string, unknown>[];
+    tool_call_count?: number;
+};
+export type GatewayRunMessage = {
+    role: string;
+    content: string | Record<string, unknown>[];
+    [key: string]: unknown;
+};
+export type GatewayRunAttachment = {
+    name: string;
+    mimeType?: string;
+    mime_type?: string;
+    size?: number;
+    dataBase64?: string;
+    data_base64?: string;
+    [key: string]: unknown;
+};
+export type GatewayRunStartBody = {
+    input: string | GatewayRunMessage[];
+    session_id?: string;
+    instructions?: string;
+    previous_response_id?: string;
+    conversation_history?: GatewayRunMessage[];
+    targetProfile?: string;
+    target_profile?: string;
+    targetAgent?: string;
+    target_agent?: string;
+    agentId?: string;
+    agent_id?: string;
+    action?: string;
+    source?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    attachments?: GatewayRunAttachment[];
+    dryRun?: boolean;
+    dry_run?: boolean;
+};
+export declare class GatewayApiClient extends BaseHttpApiClient {
+    readonly endpoints: {
+        readonly health: "/health";
+        readonly healthDetailed: "/health/detailed";
+        readonly models: "/v1/models";
+        readonly capabilities: "/v1/capabilities";
+        readonly chatCompletions: "/v1/chat/completions";
+        readonly responses: "/v1/responses";
+        readonly response: (responseId: string) => string;
+        readonly runs: "/v1/runs";
+        readonly run: (runId: string) => string;
+        readonly runEvents: (runId: string) => string;
+        readonly runApproval: (runId: string) => string;
+        readonly runStop: (runId: string) => string;
+        readonly jobs: "/api/jobs";
+        readonly job: (jobId: string) => string;
+    };
+    readonly request: HttpApiTransport;
+    constructor(options: HttpApiClientOptions, surface?: string);
+    getCapabilities(): Promise<GatewayCapabilities>;
+    getFeatureCapabilities(options?: Omit<NormalizeGatewayFeatureCapabilitiesOptions, "capabilities">): Promise<NormalizedGatewayFeatureCapabilities>;
+    startRun(body: GatewayRunStartBody): Promise<GatewayRunStatus>;
+    getRun(runId: string): Promise<GatewayRunStatus>;
+    stopRun(runId: string): Promise<{
+        status: string;
+    }>;
+    resolveRunApproval<T = unknown>(runId: string, body: {
+        approved: boolean;
+        reason?: string;
+    }, idempotencyKey?: string): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/core/gateway/client/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/core/gateway/client/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAEL,KAAK,0CAA0C,EAC/C,KAAK,oCAAoC,EAC1C,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,mBAAmB,GAAG,0BAA0B,GAAG;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EACF,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,GACX,UAAU,GACV,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,iBAAiB;IACrD,QAAQ,CAAC,SAAS;;;;;;;;;;;;;;;MAAyB;IAC3C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;gBAEvB,OAAO,EAAE,oBAAoB,EAAE,OAAO,SAAgB;IAKlE,eAAe,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIzC,sBAAsB,CAC1B,OAAO,GAAE,IAAI,CAAC,0CAA0C,EAAE,cAAc,CAAM,GAC7E,OAAO,CAAC,oCAAoC,CAAC;IAOhD,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO9D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIhD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAMnD,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAC5C,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,CAAC,CAAC;CAOd"}

package/dist/core/gateway/client/client.js

@@ -0,0 +1,41 @@
+import { GATEWAY_API_ENDPOINTS } from "../../../contracts/paths.js";
+import { BaseHttpApiClient } from "../../http/client.js";
+import { normalizeGatewayFeatureCapabilities, } from "./capabilities.js";
+export class GatewayApiClient extends BaseHttpApiClient {
+    endpoints = GATEWAY_API_ENDPOINTS;
+    request;
+    constructor(options, surface = "gateway-api") {
+        super(surface, options);
+        this.request = this.createTransport();
+    }
+    getCapabilities() {
+        return this.request(this.endpoints.capabilities);
+    }
+    async getFeatureCapabilities(options = {}) {
+        return normalizeGatewayFeatureCapabilities({
+            ...options,
+            capabilities: await this.getCapabilities(),
+        });
+    }
+    startRun(body) {
+        return this.request(this.endpoints.runs, {
+            method: "POST",
+            body,
+        });
+    }
+    getRun(runId) {
+        return this.request(this.endpoints.run(runId));
+    }
+    stopRun(runId) {
+        return this.request(this.endpoints.runStop(runId), {
+            method: "POST",
+        });
+    }
+    resolveRunApproval(runId, body, idempotencyKey) {
+        return this.request(this.endpoints.runApproval(runId), {
+            method: "POST",
+            body,
+            idempotencyKey,
+        });
+    }
+}

package/dist/core/gateway/client/error-details.d.ts

@@ -0,0 +1,17 @@
+export declare function cleanGatewayErrorText(value: unknown): string | null;
+export declare function extractGatewayErrorDetails(payload: unknown): {
+    message: string | null;
+    code: string | null;
+};
+export declare function parseGatewayErrorText(text: string, contentType: string): {
+    message: string | null;
+    code: string | null;
+};
+export declare function formatGatewayHttpErrorMessage(params: {
+    label: string;
+    status: number;
+    statusText: string;
+    message?: string | null;
+    code?: string | null;
+}): string;
+//# sourceMappingURL=error-details.d.ts.map

package/dist/core/gateway/client/error-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-details.d.ts","sourceRoot":"","sources":["../../../../src/core/gateway/client/error-details.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CASnE;AAQD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG;IAC5D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAeA;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB;IACD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAUA;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,GAAG,MAAM,CAYT"}

package/dist/core/gateway/client/error-details.js

@@ -0,0 +1,50 @@
+export function cleanGatewayErrorText(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim().replace(/\s+/gu, " ");
+    if (!trimmed) {
+        return null;
+    }
+    return trimmed.slice(0, 180);
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+export function extractGatewayErrorDetails(payload) {
+    const record = asRecord(payload);
+    const errorRecord = asRecord(record?.error);
+    const message = cleanGatewayErrorText(errorRecord?.message) ??
+        cleanGatewayErrorText(record?.message) ??
+        cleanGatewayErrorText(record?.error) ??
+        null;
+    const code = cleanGatewayErrorText(errorRecord?.code) ??
+        cleanGatewayErrorText(record?.code) ??
+        null;
+    return { message, code };
+}
+export function parseGatewayErrorText(text, contentType) {
+    if (!contentType.toLowerCase().includes("application/json")) {
+        return { message: null, code: null };
+    }
+    try {
+        return extractGatewayErrorDetails(JSON.parse(text));
+    }
+    catch {
+        return { message: null, code: null };
+    }
+}
+export function formatGatewayHttpErrorMessage(params) {
+    const statusText = cleanGatewayErrorText(params.statusText);
+    const detail = cleanGatewayErrorText(params.message);
+    const code = cleanGatewayErrorText(params.code);
+    const base = statusText
+        ? `${params.label} ${params.status}: ${statusText}`
+        : `${params.label} ${params.status}`;
+    const withCode = code ? `${base} [${code}]` : base;
+    return detail && detail !== statusText
+        ? `${withCode} - ${detail}`
+        : withCode;
+}

package/dist/core/gateway/client/fetch.d.ts

@@ -0,0 +1,24 @@
+import type { HttpApiTrace } from "../../http/types.js";
+export type GatewayHttpFetchOptions = Omit<RequestInit, "headers"> & {
+    httpBaseUrl: string;
+    clientId: string;
+    authToken: string | null;
+    /** Shown in thrown errors, e.g. "Gateway API". */
+    apiLabel: string;
+    headers?: Record<string, string>;
+    sessionAuthMode?: boolean;
+    surface?: HttpApiTrace["surface"];
+    fetchImpl?: typeof fetch;
+};
+export declare function buildGatewayAuthHeaders(clientId: string, authToken: string | null, options?: {
+    includeBearerToken?: boolean;
+}): Record<string, string>;
+export declare function resolveGatewayRequestCredentials(sessionAuthMode: boolean | null | undefined): RequestCredentials | undefined;
+export declare function requestGatewayRaw(path: string, options: GatewayHttpFetchOptions): Promise<Response>;
+export declare function fetchGatewayJson<T>(path: string, options: GatewayHttpFetchOptions): Promise<T>;
+export declare function fetchGatewayExpectOk(path: string, options: GatewayHttpFetchOptions): Promise<void>;
+export declare function fetchGatewayBlob(path: string, options: GatewayHttpFetchOptions): Promise<Blob>;
+export declare function fetchGatewayFormDataJson<T>(path: string, options: Omit<GatewayHttpFetchOptions, "body" | "method"> & {
+    body: FormData;
+}): Promise<T>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/core/gateway/client/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../../src/core/gateway/client/fetch.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,GAAG;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,OAAO,CAAC,EAAE;IACR,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,GACA,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB;AAED,wBAAgB,gCAAgC,CAC9C,eAAe,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAC1C,kBAAkB,GAAG,SAAS,CAEhC;AAsDD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,QAAQ,CAAC,CAuCnB;AAED,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,CAAC,CAAC,CAGZ;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG;IAC1D,IAAI,EAAE,QAAQ,CAAC;CAChB,GACA,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/core/gateway/client/fetch.js

@@ -0,0 +1,98 @@
+import { requirePortalClientId, PORTAL_CLIENT_ID_HEADER } from "../../http/client-id.js";
+import { HttpApiError } from "../../http/errors.js";
+import { buildGatewayHttpError, parseGatewayErrorText, } from "../../http/gateway-error.js";
+import { createRawHttpApiClient, toHttpRequestInit, } from "../../http/raw-client.js";
+export function buildGatewayAuthHeaders(clientId, authToken, options) {
+    const includeBearerToken = options?.includeBearerToken ?? true;
+    const headers = {
+        Accept: "application/json",
+        [PORTAL_CLIENT_ID_HEADER]: requirePortalClientId(clientId),
+    };
+    if (includeBearerToken && authToken) {
+        headers.Authorization = `Bearer ${authToken}`;
+    }
+    return headers;
+}
+export function resolveGatewayRequestCredentials(sessionAuthMode) {
+    return sessionAuthMode ? "same-origin" : undefined;
+}
+async function parseGatewayJsonResponse(res, endpoint, apiLabel) {
+    const contentType = res.headers.get("content-type") ?? "";
+    const text = await res.text();
+    if (!res.ok) {
+        const details = parseGatewayErrorText(text, contentType);
+        throw buildGatewayHttpError({
+            label: apiLabel,
+            status: res.status,
+            statusText: res.statusText,
+            message: details.message,
+            code: details.code,
+        });
+    }
+    if (!contentType.includes("application/json")) {
+        const trimmed = text.trimStart().toLowerCase();
+        const htmlHint = trimmed.startsWith("<!doctype") || trimmed.startsWith("<html")
+            ? ` (received HTML - check ${endpoint} gateway wiring)`
+            : "";
+        throw new Error(`Expected JSON from ${endpoint}, got ${contentType || "unknown"}${htmlHint}`);
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new Error(`Invalid JSON from ${endpoint}.`);
+    }
+}
+function throwGatewayHttpErrorFromCore(error, apiLabel) {
+    const details = parseGatewayErrorText(error.body, "application/json");
+    throw buildGatewayHttpError({
+        label: apiLabel,
+        status: error.status,
+        statusText: "",
+        message: details.message,
+        code: details.code,
+    });
+}
+export async function requestGatewayRaw(path, options) {
+    const { httpBaseUrl, clientId, authToken, apiLabel, headers: extraHeaders, sessionAuthMode, surface, fetchImpl, ...init } = options;
+    const credentials = resolveGatewayRequestCredentials(sessionAuthMode);
+    const client = createRawHttpApiClient({
+        surface: surface ?? "gateway-api",
+        baseUrl: httpBaseUrl,
+        authToken: sessionAuthMode ? null : authToken,
+        clientId,
+        credentials,
+        fetchImpl,
+    });
+    try {
+        return await client.raw(path, toHttpRequestInit({
+            ...init,
+            ...(credentials ? { credentials } : {}),
+        }, extraHeaders));
+    }
+    catch (error) {
+        if (error instanceof HttpApiError && error.status > 0) {
+            throwGatewayHttpErrorFromCore(error, apiLabel);
+        }
+        throw error;
+    }
+}
+export async function fetchGatewayJson(path, options) {
+    const res = await requestGatewayRaw(path, options);
+    return parseGatewayJsonResponse(res, path, options.apiLabel);
+}
+export async function fetchGatewayExpectOk(path, options) {
+    await requestGatewayRaw(path, options);
+}
+export async function fetchGatewayBlob(path, options) {
+    const res = await requestGatewayRaw(path, options);
+    return res.blob();
+}
+export async function fetchGatewayFormDataJson(path, options) {
+    const res = await requestGatewayRaw(path, {
+        ...options,
+        method: "POST",
+        body: options.body,
+    });
+    return parseGatewayJsonResponse(res, path, options.apiLabel);
+}

package/dist/core/gateway/client/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./client.js";
+export * from "./capabilities.js";
+export * from "./error-details.js";
+export * from "./fetch.js";
+export * from "./runtime-targets.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/gateway/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/gateway/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC"}

package/dist/core/gateway/client/index.js

@@ -0,0 +1,5 @@
+export * from "./client.js";
+export * from "./capabilities.js";
+export * from "./error-details.js";
+export * from "./fetch.js";
+export * from "./runtime-targets.js";

package/dist/core/gateway/client/runtime-targets.d.ts

@@ -0,0 +1,11 @@
+export type ResolveGatewayRuntimeTargetOptions = {
+    configuredGatewayBaseUrl?: string | null;
+    windowOrigin?: string | null;
+    fallbackWsUrl?: string;
+};
+export declare function normalizeGatewayBaseUrl(rawGatewayBaseUrl: string | null | undefined): string | null;
+export declare function sameGatewayDaemon(leftBaseUrl: string | null | undefined, rightBaseUrl: string | null | undefined): boolean;
+export declare function resolveGatewayRuntimeHttpBase(gatewayBaseUrl: string, options?: ResolveGatewayRuntimeTargetOptions): string;
+export declare function resolveGatewayRuntimeWsUrl(gatewayBaseUrl: string, options?: ResolveGatewayRuntimeTargetOptions): string;
+export declare function resolveGatewayRuntimeHttpUrl(gatewayBaseUrl: string, pathname: string, options?: ResolveGatewayRuntimeTargetOptions): string;
+//# sourceMappingURL=runtime-targets.d.ts.map