@belvador/api 0.0.0-stage → 0.1.0

package/dist/node-wire.gen.js

@@ -0,0 +1,100 @@
+// GENERATED by scripts/api/client.ts from src/shared/contracts/api-ops/node-wire.ts. Do not edit; run `bun scripts/api/client.ts`.
+// Node reads on the wire (spec 04 §2–§4), shared by the gateway (`services/api/src/node-op.ts`)
+// and clients that read the node directly with a ticket (`@belvador/api`, which gets a copy of
+// this file from `scripts/api/client.ts`; a test keeps the copy equal). Arguments are REST wire
+// names (snake_case); `start`/`end` travel to the node as `from`/`to`. No imports: the copy must
+// compile on its own.
+const PLACEHOLDER = /\{([a-z_]+)\}/g;
+function queryValue(v) {
+    if (v === undefined || v === null)
+        return null;
+    if (Array.isArray(v))
+        return v.map(String).join(",");
+    if (typeof v === "object")
+        return JSON.stringify(v);
+    return String(v);
+}
+/** Wire arguments → the node path (placeholders filled) and query string; null when a path value is missing. */
+export function nodeReadRequest(route, wire) {
+    const names = new Set();
+    let missing = false;
+    const path = route.path.replace(PLACEHOLDER, (_, name) => {
+        names.add(name);
+        const v = wire[name];
+        if (v === undefined || v === null || v === "")
+            missing = true;
+        return encodeURIComponent(String(v ?? ""));
+    });
+    if (missing)
+        return null;
+    const qs = new URLSearchParams();
+    for (const [k, v] of Object.entries(wire)) {
+        if (names.has(k))
+            continue;
+        const s = queryValue(v);
+        if (s === null)
+            continue;
+        qs.set(k === "start" ? "from" : k === "end" ? "to" : k, s);
+    }
+    const query = qs.toString();
+    return { path, query };
+}
+/** Window routes need both ends; the node and the gateway judge the size against the plan. */
+export function nodeWindowMissing(route, wire) {
+    return !!route.window && (!wire["start"] || !wire["end"]);
+}
+/** A node list answer as the API's page: `{data, next_cursor, complete, ...rest}`. */
+export function reshapeNodeAnswer(list, body) {
+    if (!list || !body || typeof body !== "object" || Array.isArray(body))
+        return body;
+    const { [list]: rows, next_cursor, complete, search_partial, partial, ...rest } = body;
+    return {
+        data: Array.isArray(rows) ? rows : [],
+        next_cursor: typeof next_cursor === "string" && next_cursor ? next_cursor : null,
+        complete: typeof complete === "boolean" ? complete : !(search_partial === true || partial === true),
+        ...rest,
+    };
+}
+/** HTTP status of the codes a node read can end in (equal to `apiHttpStatus`; a test holds them equal). */
+export const NODE_REFUSAL_STATUS = {
+    NOT_FOUND: 404,
+    API_SCOPE_INSUFFICIENT: 403,
+    API_FORBIDDEN: 403,
+    NODE_BUSY: 429,
+    QUERY_TIMEOUT: 422,
+    NODE_OFFLINE: 503,
+    QUERY_WINDOW_REQUIRED: 400,
+    QUERY_WINDOW_TOO_LARGE: 400,
+    INVALID_INPUT: 400,
+    UNAVAILABLE: 503,
+};
+const refuse = (code, extra = {}) => ({
+    code,
+    status: NODE_REFUSAL_STATUS[code],
+    ...extra,
+});
+/** A node error (status + its fixed `error` word) → the API error code; nothing else from the payload. */
+export function nodeRefusal(status, error) {
+    if (status === 404 || error === "project_denied")
+        return refuse("NOT_FOUND");
+    if (error === "scope")
+        return refuse("API_SCOPE_INSUFFICIENT");
+    if (error === "environment_restricted")
+        return refuse("API_FORBIDDEN");
+    if (status === 429 || error === "busy")
+        return refuse("NODE_BUSY", { retryAfter: 2 });
+    if (error === "query_timeout")
+        return refuse("QUERY_TIMEOUT");
+    if (status === 503 || status === 504 || status === 502)
+        return refuse("NODE_OFFLINE");
+    if (status === 400 || status === 422) {
+        if (error === "too_broad" || error === "window_too_large")
+            return refuse("QUERY_WINDOW_TOO_LARGE");
+        return /^[a-z_]{1,40}$/.test(error) ? refuse("INVALID_INPUT", { detail: error }) : refuse("INVALID_INPUT");
+    }
+    return refuse("UNAVAILABLE");
+}
+/** The node's `error` word from a parsed body ("" when absent). */
+export function nodeErrorWord(body) {
+    return body && typeof body === "object" ? String(body.error ?? "") : "";
+}