@almadar/sdk 0.1.0-alpha.4 → 0.1.0

package/dist/server/express.js

@@ -0,0 +1,472 @@
+import { parseOrbitalSchema } from '@almadar/core';
+
+// src/client/AlmadarClient.ts
+
+// src/client/errors.ts
+var AlmadarError = class extends Error {
+  code;
+  details;
+  constructor(body) {
+    super(body.message);
+    this.name = "AlmadarError";
+    this.code = body.code;
+    this.details = body.details;
+  }
+};
+var ApiKeyError = class extends AlmadarError {
+  constructor(body) {
+    super(body);
+    this.name = "ApiKeyError";
+  }
+};
+var RateLimitedError = class extends AlmadarError {
+  retryAfterSeconds;
+  constructor(body, retryAfterSeconds) {
+    super(body);
+    this.name = "RateLimitedError";
+    this.retryAfterSeconds = retryAfterSeconds;
+  }
+};
+var CatalogOutOfScopeError = class extends AlmadarError {
+  constructor(body) {
+    super(body);
+    this.name = "CatalogOutOfScopeError";
+  }
+};
+var ServerError = class extends AlmadarError {
+  constructor(body) {
+    super(body);
+    this.name = "ServerError";
+  }
+};
+function errorFromBody(body) {
+  switch (body.code) {
+    case 4001:
+      return new ApiKeyError(body);
+    case 4029:
+      return new RateLimitedError(body);
+    case 4040:
+      return new CatalogOutOfScopeError(body);
+    default:
+      return new ServerError(body);
+  }
+}
+
+// src/client/sseParser.ts
+async function* parseSSE(stream) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder("utf-8");
+  let buffer = "";
+  let currentEvent = "";
+  let currentData = "";
+  try {
+    for (; ; ) {
+      const { value, done } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      let newlineIdx;
+      while ((newlineIdx = indexOfNewline(buffer)) !== -1) {
+        const rawLine = buffer.slice(0, newlineIdx);
+        buffer = buffer.slice(newlineIdx + (buffer[newlineIdx] === "\r" && buffer[newlineIdx + 1] === "\n" ? 2 : 1));
+        if (rawLine === "") {
+          if (currentData !== "" || currentEvent !== "") {
+            yield { event: currentEvent, data: currentData };
+            currentEvent = "";
+            currentData = "";
+          }
+          continue;
+        }
+        if (rawLine.startsWith(":")) continue;
+        const colon = rawLine.indexOf(":");
+        const field = colon === -1 ? rawLine : rawLine.slice(0, colon);
+        const rawValue = colon === -1 ? "" : rawLine.slice(colon + 1);
+        const value2 = rawValue.startsWith(" ") ? rawValue.slice(1) : rawValue;
+        if (field === "event") {
+          currentEvent = value2;
+        } else if (field === "data") {
+          currentData = currentData === "" ? value2 : `${currentData}
+${value2}`;
+        }
+      }
+    }
+    if (currentData !== "" || currentEvent !== "") {
+      yield { event: currentEvent, data: currentData };
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+function indexOfNewline(s) {
+  for (let i = 0; i < s.length; i += 1) {
+    const c = s[i];
+    if (c === "\n" || c === "\r") return i;
+  }
+  return -1;
+}
+
+// src/client/AlmadarClient.ts
+var DEFAULT_BASE_URL = "https://studio.almadar.io";
+var POLL_BACKOFF_MS = [1e3, 2e3, 5e3, 1e4, 3e4];
+var AlmadarClient = class {
+  apiKey;
+  baseUrl;
+  fetchImpl;
+  constructor(opts) {
+    if (!opts.apiKey || typeof opts.apiKey !== "string") {
+      throw new Error("AlmadarClient: opts.apiKey is required");
+    }
+    this.apiKey = opts.apiKey;
+    this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.fetchImpl = opts.fetch ?? globalThis.fetch;
+    if (typeof this.fetchImpl !== "function") {
+      throw new Error("AlmadarClient: no fetch available \u2014 pass opts.fetch for Node <18");
+    }
+  }
+  async generate(input) {
+    if (input.async === true) {
+      const handle = await this.requestJson("POST", "/api/v1/agent/generate", {
+        prompt: input.prompt,
+        endUserId: input.endUserId,
+        appId: input.appId,
+        async: true,
+        provider: input.provider,
+        model: input.model,
+        catalogMode: input.catalogMode,
+        stdAllowList: input.stdAllowList
+      });
+      assertString(handle.jobId, "AsyncJobHandle.jobId");
+      assertString(handle.statusUrl, "AsyncJobHandle.statusUrl");
+      return this.pollUntilComplete(handle, input.onEvent);
+    }
+    return this.streamGenerate(input);
+  }
+  async editSchema(appId, patch) {
+    if (!appId) throw new Error("AlmadarClient.editSchema: appId is required");
+    const schema = await this.requestJson("PUT", "/api/v1/agent/edit-schema", {
+      appId,
+      patch
+    });
+    assertString(schema.name, "OrbitalSchema.name");
+    return schema;
+  }
+  async compileToApp(schema, opts) {
+    const result = await this.requestJson("POST", "/api/v1/agent/compile", {
+      schema,
+      target: opts?.target,
+      shell: opts?.shell
+    });
+    assertString(result.downloadUrl, "CompileResult.downloadUrl");
+    assertString(result.expiresAt, "CompileResult.expiresAt");
+    return result;
+  }
+  async streamGenerate(input) {
+    const res = await this.fetchImpl(`${this.baseUrl}/api/v1/agent/generate`, {
+      method: "POST",
+      headers: this.headers({ accept: "text/event-stream", contentType: "application/json" }, input.endUserId),
+      body: JSON.stringify({
+        prompt: input.prompt,
+        endUserId: input.endUserId,
+        appId: input.appId,
+        provider: input.provider,
+        model: input.model,
+        catalogMode: input.catalogMode,
+        stdAllowList: input.stdAllowList
+      })
+    });
+    if (!res.ok) throw await this.errorFromResponse(res);
+    if (res.body === null) throw new Error("AlmadarClient.generate: server returned no body");
+    let final = null;
+    for await (const raw of parseSSE(res.body)) {
+      const event = parseSseEvent(raw.data);
+      if (event === null) continue;
+      input.onEvent?.(event);
+      if (event.type === "complete") {
+        if (event.data.schema === void 0) {
+          throw new ServerError({ code: 500, message: "`complete` event did not contain a schema" });
+        }
+        const schema = parseOrbitalSchema(event.data.schema);
+        final = { schema, appId: event.data.appId };
+      } else if (event.type === "error") {
+        throw errorFromBody({ code: 500, message: event.data.error });
+      }
+    }
+    if (final === null) {
+      throw new ServerError({ code: 500, message: "SSE stream ended without `complete` event" });
+    }
+    return final;
+  }
+  async pollUntilComplete(handle, onEvent) {
+    let attempt = 0;
+    for (; ; ) {
+      const delay = POLL_BACKOFF_MS[Math.min(attempt, POLL_BACKOFF_MS.length - 1)];
+      await sleep(delay);
+      attempt += 1;
+      const status = await this.requestJson("GET", handle.statusUrl);
+      assertString(status.state, "JobStatus.state");
+      if (status.events !== void 0 && onEvent !== void 0) {
+        for (const e of status.events) onEvent(e);
+      }
+      if (status.state === "complete") {
+        if (status.result === void 0) {
+          throw new ServerError({ code: 500, message: "Job complete but no result returned" });
+        }
+        return status.result;
+      }
+      if (status.state === "error") {
+        throw errorFromBody({
+          code: status.errorCode ?? 500,
+          message: status.errorMessage ?? "Job failed"
+        });
+      }
+    }
+  }
+  async requestJson(method, path, body) {
+    const isAbsolute = path.startsWith("http://") || path.startsWith("https://");
+    const url = isAbsolute ? path : `${this.baseUrl}${path}`;
+    const init = {
+      method,
+      headers: this.headers({
+        accept: "application/json",
+        contentType: body !== void 0 ? "application/json" : void 0
+      })
+    };
+    if (body !== void 0) init.body = JSON.stringify(body);
+    const res = await this.fetchImpl(url, init);
+    if (!res.ok) throw await this.errorFromResponse(res);
+    const text = await res.text();
+    if (text === "") {
+      throw new ServerError({ code: 500, message: "Empty response body" });
+    }
+    const parsed = JSON.parse(text);
+    return parsed;
+  }
+  headers(opts, endUserId) {
+    const h = { authorization: `Bearer ${this.apiKey}` };
+    if (opts.accept !== void 0) h["accept"] = opts.accept;
+    if (opts.contentType !== void 0) h["content-type"] = opts.contentType;
+    if (endUserId !== void 0 && endUserId !== "") h["x-end-user-id"] = endUserId;
+    return h;
+  }
+  async errorFromResponse(res) {
+    const text = await res.text();
+    let body;
+    try {
+      const parsed = text === "" ? null : JSON.parse(text);
+      body = parsed !== null && typeof parsed.code === "number" && typeof parsed.message === "string" ? parsed : {
+        code: res.status,
+        message: res.statusText !== "" ? res.statusText : "HTTP error"
+      };
+    } catch {
+      body = { code: res.status, message: text !== "" ? text : res.statusText };
+    }
+    const retryAfter = res.headers.get("retry-after");
+    const err = errorFromBody(body);
+    if (err.name === "RateLimitedError" && retryAfter !== null) {
+      const seconds = Number(retryAfter);
+      if (Number.isFinite(seconds)) {
+        Object.defineProperty(err, "retryAfterSeconds", { value: seconds, enumerable: true });
+      }
+    }
+    return err;
+  }
+};
+function parseSseEvent(dataLine) {
+  if (dataLine === "") return null;
+  let payload;
+  try {
+    payload = JSON.parse(dataLine);
+  } catch {
+    return null;
+  }
+  if (payload === null || typeof payload !== "object" || Array.isArray(payload)) return null;
+  if (typeof payload.type !== "string" || typeof payload.timestamp !== "number") return null;
+  return payload;
+}
+function assertString(v, name) {
+  if (typeof v !== "string" || v === "") {
+    throw new ServerError({ code: 500, message: `Malformed server response: ${name} is not a string` });
+  }
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/server/index.ts
+function resolveEndUserId(opts, req) {
+  if (opts.endUserId) return opts.endUserId(req);
+  const header = req.headers.get("x-user-id");
+  return typeof header === "string" && header.length > 0 ? header : void 0;
+}
+function encodeSseEvent(event) {
+  return `data: ${JSON.stringify(event)}
+
+`;
+}
+function createGenerateHandler(opts) {
+  return async (request) => {
+    let body;
+    try {
+      body = await request.json();
+    } catch {
+      return new Response(JSON.stringify({ error: "invalid JSON body" }), {
+        status: 400,
+        headers: { "content-type": "application/json" }
+      });
+    }
+    const rawPrompt = body.prompt ?? body.message;
+    const prompt = typeof rawPrompt === "string" ? rawPrompt : "";
+    if (!prompt) {
+      return new Response(JSON.stringify({ error: "prompt or message is required" }), {
+        status: 400,
+        headers: { "content-type": "application/json" }
+      });
+    }
+    const bodyEndUserId = typeof body.endUserId === "string" ? body.endUserId : void 0;
+    const endUserId = bodyEndUserId ?? resolveEndUserId(opts, request);
+    const appId = typeof body.appId === "string" ? body.appId : void 0;
+    const client = new AlmadarClient({ apiKey: opts.apiKey, baseUrl: opts.baseUrl });
+    const stream = new ReadableStream({
+      async start(controller) {
+        const encoder = new TextEncoder();
+        try {
+          await client.generate({
+            prompt,
+            endUserId,
+            appId,
+            onEvent: (event) => {
+              controller.enqueue(encoder.encode(encodeSseEvent(event)));
+            }
+          });
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          const errorEvent = {
+            type: "error",
+            timestamp: Date.now(),
+            data: { error: message }
+          };
+          controller.enqueue(encoder.encode(encodeSseEvent(errorEvent)));
+        } finally {
+          controller.close();
+        }
+      }
+    });
+    return new Response(stream, {
+      status: 200,
+      headers: {
+        "content-type": "text/event-stream",
+        "cache-control": "no-cache",
+        connection: "keep-alive"
+      }
+    });
+  };
+}
+function createEditHandler(opts) {
+  return async (request) => {
+    let body;
+    try {
+      body = await request.json();
+    } catch {
+      return new Response(JSON.stringify({ error: "invalid JSON body" }), {
+        status: 400,
+        headers: { "content-type": "application/json" }
+      });
+    }
+    const appId = typeof body.appId === "string" ? body.appId : "";
+    if (!appId) {
+      return new Response(JSON.stringify({ error: "appId is required" }), {
+        status: 400,
+        headers: { "content-type": "application/json" }
+      });
+    }
+    const patch = body.patch;
+    if (patch === void 0 || patch === null || typeof patch !== "object") {
+      return new Response(JSON.stringify({ error: "patch is required" }), {
+        status: 400,
+        headers: { "content-type": "application/json" }
+      });
+    }
+    const client = new AlmadarClient({ apiKey: opts.apiKey, baseUrl: opts.baseUrl });
+    try {
+      const schema = await client.editSchema(appId, patch);
+      return new Response(JSON.stringify(schema), {
+        status: 200,
+        headers: { "content-type": "application/json" }
+      });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return new Response(JSON.stringify({ error: message }), {
+        status: 500,
+        headers: { "content-type": "application/json" }
+      });
+    }
+  };
+}
+
+// src/server/express.ts
+function expressReqToWebRequest(req) {
+  const protocol = req.protocol;
+  const host = req.get("host") ?? "localhost";
+  const url = `${protocol}://${host}${req.originalUrl}`;
+  const headers = new Headers();
+  for (const [key, value] of Object.entries(req.headers)) {
+    if (typeof value === "string") {
+      headers.set(key, value);
+    } else if (Array.isArray(value)) {
+      for (const v of value) headers.append(key, v);
+    }
+  }
+  const bodyJson = JSON.stringify(req.body);
+  return new Request(url, { method: req.method, headers, body: bodyJson });
+}
+async function pipeWebResponseToExpress(webRes, res) {
+  res.status(webRes.status);
+  webRes.headers.forEach((value, key) => {
+    res.setHeader(key, value);
+  });
+  if (webRes.body === null) {
+    res.end();
+    return;
+  }
+  const reader = webRes.body.getReader();
+  try {
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      res.write(value);
+    }
+  } finally {
+    reader.releaseLock();
+    res.end();
+  }
+}
+function createGenerateHandler2(opts) {
+  const coreHandler = createGenerateHandler({
+    apiKey: opts.apiKey,
+    baseUrl: opts.baseUrl,
+    endUserId: opts.endUserId ? (webReq) => {
+      const userId = webReq.headers.get("x-user-id");
+      return userId ?? "";
+    } : void 0
+  });
+  return async (req, res) => {
+    if (opts.endUserId) {
+      const userId = opts.endUserId(req);
+      if (userId) req.headers["x-user-id"] = userId;
+    }
+    const webReq = expressReqToWebRequest(req);
+    const webRes = await coreHandler(webReq);
+    await pipeWebResponseToExpress(webRes, res);
+  };
+}
+function createEditHandler2(opts) {
+  const coreHandler = createEditHandler({ apiKey: opts.apiKey, baseUrl: opts.baseUrl });
+  return async (req, res) => {
+    const webReq = expressReqToWebRequest(req);
+    const webRes = await coreHandler(webReq);
+    await pipeWebResponseToExpress(webRes, res);
+  };
+}
+
+export { createEditHandler2 as createEditHandler, createGenerateHandler2 as createGenerateHandler };
+//# sourceMappingURL=express.js.map
+//# sourceMappingURL=express.js.map

package/dist/server/express.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/errors.ts","../../src/client/sseParser.ts","../../src/client/AlmadarClient.ts","../../src/server/index.ts","../../src/server/express.ts"],"names":["createGenerateHandler","createEditHandler"],"mappings":"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","file":"express.js","sourcesContent":["/**\n * Typed SDK errors. Server emits a structured `ApiErrorBody`; the HTTP layer\n * maps the `code` to one of these subclasses. Customers `catch` by class.\n */\n\nimport type { ApiErrorBody } from '../types';\n\nexport class AlmadarError extends Error {\n  readonly code: number;\n  readonly details?: ApiErrorBody['details'];\n  constructor(body: ApiErrorBody) {\n    super(body.message);\n    this.name = 'AlmadarError';\n    this.code = body.code;\n    this.details = body.details;\n  }\n}\n\n/** 4001 — invalid, revoked, or missing API key. */\nexport class ApiKeyError extends AlmadarError {\n  constructor(body: ApiErrorBody) {\n    super(body);\n    this.name = 'ApiKeyError';\n  }\n}\n\n/** 4029 — team cap (feature counter) exceeded. Retry after a billing cycle. */\nexport class RateLimitedError extends AlmadarError {\n  readonly retryAfterSeconds?: number;\n  constructor(body: ApiErrorBody, retryAfterSeconds?: number) {\n    super(body);\n    this.name = 'RateLimitedError';\n    this.retryAfterSeconds = retryAfterSeconds;\n  }\n}\n\n/** 4040 — the team's behavior catalog (subset/replace mode) cannot serve the request. */\nexport class CatalogOutOfScopeError extends AlmadarError {\n  constructor(body: ApiErrorBody) {\n    super(body);\n    this.name = 'CatalogOutOfScopeError';\n  }\n}\n\n/** Anything else from the server with a recognized envelope but no specific subclass. */\nexport class ServerError extends AlmadarError {\n  constructor(body: ApiErrorBody) {\n    super(body);\n    this.name = 'ServerError';\n  }\n}\n\nexport function errorFromBody(body: ApiErrorBody): AlmadarError {\n  switch (body.code) {\n    case 4001:\n      return new ApiKeyError(body);\n    case 4029:\n      return new RateLimitedError(body);\n    case 4040:\n      return new CatalogOutOfScopeError(body);\n    default:\n      return new ServerError(body);\n  }\n}\n","/**\n * Minimal Server-Sent Events parser. Reads a `ReadableStream<Uint8Array>`\n * (the body of a `fetch` Response) and yields decoded events. Universal:\n * works in browser, Node 18+, Deno, Bun.\n *\n * Spec subset implemented:\n *   - `event:` and `data:` fields\n *   - dispatch on blank line\n *   - newline-tolerant (CRLF + LF)\n *   - skips comments (`:`-prefixed lines)\n *\n * Not implemented (we don't need them):\n *   - `id:` / `retry:` fields\n *   - reconnection / last-event-id\n */\n\nexport interface RawSseEvent {\n  /** `event:` field value. Empty string when absent — matches the spec default. */\n  event: string;\n  /** Concatenated `data:` lines, joined by newlines. */\n  data: string;\n}\n\nexport async function* parseSSE(\n  stream: ReadableStream<Uint8Array>,\n): AsyncGenerator<RawSseEvent, void, void> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder('utf-8');\n  let buffer = '';\n  let currentEvent = '';\n  let currentData = '';\n\n  try {\n    for (;;) {\n      const { value, done } = await reader.read();\n      if (done) break;\n      buffer += decoder.decode(value, { stream: true });\n\n      let newlineIdx: number;\n      while ((newlineIdx = indexOfNewline(buffer)) !== -1) {\n        const rawLine = buffer.slice(0, newlineIdx);\n        buffer = buffer.slice(newlineIdx + (buffer[newlineIdx] === '\\r' && buffer[newlineIdx + 1] === '\\n' ? 2 : 1));\n\n        if (rawLine === '') {\n          if (currentData !== '' || currentEvent !== '') {\n            yield { event: currentEvent, data: currentData };\n            currentEvent = '';\n            currentData = '';\n          }\n          continue;\n        }\n        if (rawLine.startsWith(':')) continue;\n\n        const colon = rawLine.indexOf(':');\n        const field = colon === -1 ? rawLine : rawLine.slice(0, colon);\n        const rawValue = colon === -1 ? '' : rawLine.slice(colon + 1);\n        const value2 = rawValue.startsWith(' ') ? rawValue.slice(1) : rawValue;\n\n        if (field === 'event') {\n          currentEvent = value2;\n        } else if (field === 'data') {\n          currentData = currentData === '' ? value2 : `${currentData}\\n${value2}`;\n        }\n      }\n    }\n    if (currentData !== '' || currentEvent !== '') {\n      yield { event: currentEvent, data: currentData };\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nfunction indexOfNewline(s: string): number {\n  for (let i = 0; i < s.length; i += 1) {\n    const c = s[i];\n    if (c === '\\n' || c === '\\r') return i;\n  }\n  return -1;\n}\n","/**\n * `AlmadarClient` — server / Node-side HTTP client targeting `/api/v1/agent/*`.\n * Authenticates with a team-bound API key (`sk_*`) issued from\n * Studio's `/settings/sdk` panel. See `docs/Almadar_Studio_SDK.md` §5.\n *\n * Never instantiate this in a browser bundle — `apiKey` must never leave\n * the customer's server.\n */\n\nimport { parseOrbitalSchema, type OrbitalSchema, type SSEEvent } from '@almadar/core';\nimport type {\n  AlmadarClientOptions,\n  ApiErrorBody,\n  AsyncJobHandle,\n  CompileOptions,\n  CompileResult,\n  EditSchemaPatch,\n  GenerateOptions,\n  GenerateResult,\n} from '../types';\nimport { errorFromBody, ServerError } from './errors';\nimport { parseSSE } from './sseParser';\n\nconst DEFAULT_BASE_URL = 'https://studio.almadar.io';\nconst POLL_BACKOFF_MS: readonly number[] = [1000, 2000, 5000, 10_000, 30_000];\n\ninterface JobStatus {\n  state: 'pending' | 'complete' | 'error';\n  events?: readonly SSEEvent[];\n  result?: GenerateResult;\n  errorCode?: number;\n  errorMessage?: string;\n}\n\nexport class AlmadarClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(opts: AlmadarClientOptions) {\n    if (!opts.apiKey || typeof opts.apiKey !== 'string') {\n      throw new Error('AlmadarClient: opts.apiKey is required');\n    }\n    this.apiKey = opts.apiKey;\n    this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n    this.fetchImpl = opts.fetch ?? globalThis.fetch;\n    if (typeof this.fetchImpl !== 'function') {\n      throw new Error('AlmadarClient: no fetch available — pass opts.fetch for Node <18');\n    }\n  }\n\n  async generate(input: GenerateOptions): Promise<GenerateResult> {\n    if (input.async === true) {\n      const handle = await this.requestJson<AsyncJobHandle>('POST', '/api/v1/agent/generate', {\n        prompt: input.prompt,\n        endUserId: input.endUserId,\n        appId: input.appId,\n        async: true,\n        provider: input.provider,\n        model: input.model,\n        catalogMode: input.catalogMode,\n        stdAllowList: input.stdAllowList,\n      });\n      assertString(handle.jobId, 'AsyncJobHandle.jobId');\n      assertString(handle.statusUrl, 'AsyncJobHandle.statusUrl');\n      return this.pollUntilComplete(handle, input.onEvent);\n    }\n    return this.streamGenerate(input);\n  }\n\n  async editSchema(appId: string, patch: EditSchemaPatch): Promise<OrbitalSchema> {\n    if (!appId) throw new Error('AlmadarClient.editSchema: appId is required');\n    const schema = await this.requestJson<OrbitalSchema>('PUT', '/api/v1/agent/edit-schema', {\n      appId,\n      patch,\n    });\n    assertString(schema.name, 'OrbitalSchema.name');\n    return schema;\n  }\n\n  async compileToApp(schema: OrbitalSchema, opts?: CompileOptions): Promise<CompileResult> {\n    const result = await this.requestJson<CompileResult>('POST', '/api/v1/agent/compile', {\n      schema,\n      target: opts?.target,\n      shell: opts?.shell,\n    });\n    assertString(result.downloadUrl, 'CompileResult.downloadUrl');\n    assertString(result.expiresAt, 'CompileResult.expiresAt');\n    return result;\n  }\n\n  private async streamGenerate(input: GenerateOptions): Promise<GenerateResult> {\n    const res = await this.fetchImpl(`${this.baseUrl}/api/v1/agent/generate`, {\n      method: 'POST',\n      headers: this.headers({ accept: 'text/event-stream', contentType: 'application/json' }, input.endUserId),\n      body: JSON.stringify({\n        prompt: input.prompt,\n        endUserId: input.endUserId,\n        appId: input.appId,\n        provider: input.provider,\n        model: input.model,\n        catalogMode: input.catalogMode,\n        stdAllowList: input.stdAllowList,\n      }),\n    });\n    if (!res.ok) throw await this.errorFromResponse(res);\n    if (res.body === null) throw new Error('AlmadarClient.generate: server returned no body');\n\n    let final: GenerateResult | null = null;\n    for await (const raw of parseSSE(res.body)) {\n      const event = parseSseEvent(raw.data);\n      if (event === null) continue;\n      input.onEvent?.(event);\n      if (event.type === 'complete') {\n        if (event.data.schema === undefined) {\n          throw new ServerError({ code: 500, message: '`complete` event did not contain a schema' });\n        }\n        const schema = parseOrbitalSchema(event.data.schema);\n        final = { schema, appId: event.data.appId };\n      } else if (event.type === 'error') {\n        throw errorFromBody({ code: 500, message: event.data.error });\n      }\n    }\n    if (final === null) {\n      throw new ServerError({ code: 500, message: 'SSE stream ended without `complete` event' });\n    }\n    return final;\n  }\n\n  private async pollUntilComplete(\n    handle: AsyncJobHandle,\n    onEvent: GenerateOptions['onEvent'],\n  ): Promise<GenerateResult> {\n    let attempt = 0;\n    for (;;) {\n      const delay = POLL_BACKOFF_MS[Math.min(attempt, POLL_BACKOFF_MS.length - 1)];\n      await sleep(delay);\n      attempt += 1;\n      const status = await this.requestJson<JobStatus>('GET', handle.statusUrl);\n      assertString(status.state, 'JobStatus.state');\n      if (status.events !== undefined && onEvent !== undefined) {\n        for (const e of status.events) onEvent(e);\n      }\n      if (status.state === 'complete') {\n        if (status.result === undefined) {\n          throw new ServerError({ code: 500, message: 'Job complete but no result returned' });\n        }\n        return status.result;\n      }\n      if (status.state === 'error') {\n        throw errorFromBody({\n          code: status.errorCode ?? 500,\n          message: status.errorMessage ?? 'Job failed',\n        });\n      }\n    }\n  }\n\n  private async requestJson<T>(method: string, path: string, body?: object): Promise<T> {\n    const isAbsolute = path.startsWith('http://') || path.startsWith('https://');\n    const url = isAbsolute ? path : `${this.baseUrl}${path}`;\n    const init: RequestInit = {\n      method,\n      headers: this.headers({\n        accept: 'application/json',\n        contentType: body !== undefined ? 'application/json' : undefined,\n      }),\n    };\n    if (body !== undefined) init.body = JSON.stringify(body);\n    const res = await this.fetchImpl(url, init);\n    if (!res.ok) throw await this.errorFromResponse(res);\n    const text = await res.text();\n    if (text === '') {\n      throw new ServerError({ code: 500, message: 'Empty response body' });\n    }\n    const parsed: T = JSON.parse(text);\n    return parsed;\n  }\n\n  private headers(\n    opts: { accept?: string; contentType?: string },\n    endUserId?: string,\n  ): Record<string, string> {\n    const h: Record<string, string> = { authorization: `Bearer ${this.apiKey}` };\n    if (opts.accept !== undefined) h['accept'] = opts.accept;\n    if (opts.contentType !== undefined) h['content-type'] = opts.contentType;\n    if (endUserId !== undefined && endUserId !== '') h['x-end-user-id'] = endUserId;\n    return h;\n  }\n\n  private async errorFromResponse(res: Response): Promise<Error> {\n    const text = await res.text();\n    let body: ApiErrorBody;\n    try {\n      const parsed: ApiErrorBody | null = text === '' ? null : JSON.parse(text);\n      body = parsed !== null && typeof parsed.code === 'number' && typeof parsed.message === 'string'\n        ? parsed\n        : {\n            code: res.status,\n            message: res.statusText !== '' ? res.statusText : 'HTTP error',\n          };\n    } catch {\n      body = { code: res.status, message: text !== '' ? text : res.statusText };\n    }\n    const retryAfter = res.headers.get('retry-after');\n    const err = errorFromBody(body);\n    if (err.name === 'RateLimitedError' && retryAfter !== null) {\n      const seconds = Number(retryAfter);\n      if (Number.isFinite(seconds)) {\n        Object.defineProperty(err, 'retryAfterSeconds', { value: seconds, enumerable: true });\n      }\n    }\n    return err;\n  }\n}\n\n/**\n * Parse one SSE `data:` line into the canonical `SSEEvent` union.\n * The server is the trusted emitter, so we validate only the envelope\n * (object with string `type` and numeric `timestamp`) and cast to the\n * discriminated union. Malformed lines are ignored.\n */\nfunction parseSseEvent(dataLine: string): SSEEvent | null {\n  if (dataLine === '') return null;\n  let payload;\n  try {\n    payload = JSON.parse(dataLine);\n  } catch {\n    return null;\n  }\n  if (payload === null || typeof payload !== 'object' || Array.isArray(payload)) return null;\n  if (typeof payload.type !== 'string' || typeof payload.timestamp !== 'number') return null;\n  return payload as SSEEvent;\n}\n\nfunction assertString(v: string | undefined, name: string): asserts v is string {\n  if (typeof v !== 'string' || v === '') {\n    throw new ServerError({ code: 500, message: `Malformed server response: ${name} is not a string` });\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","/**\n * `@almadar/sdk/server` — Framework-agnostic Web-standard Fetch handlers for\n * the Almadar agent proxy. Node-only; never import from browser or React code.\n *\n * Usage:\n *   import { createGenerateHandler, createEditHandler } from '@almadar/sdk/server';\n *   const handler = createGenerateHandler({ apiKey: process.env.ALMADAR_API_KEY! });\n *   // handler: (request: Request) => Promise<Response>\n *\n * For framework adapters see `@almadar/sdk/server/express` and `@almadar/sdk/server/hono`.\n */\n\nimport type { OrbitalSchema } from '@almadar/core';\nimport { AlmadarClient } from '../client/AlmadarClient';\nimport type { EditSchemaRequest, EditSchemaPatch, GenerateRequest, SSEEvent } from '../types';\n\n// ============================================================================\n// Public option surface\n// ============================================================================\n\nexport interface GenerateHandlerOptions {\n  /** API key issued from Studio's /settings/sdk panel. */\n  apiKey: string;\n  /** Defaults to https://studio.almadar.io. */\n  baseUrl?: string;\n  /**\n   * Derive a stable end-user id from the incoming Web Request.\n   * Falls back to the `x-user-id` request header when omitted.\n   */\n  endUserId?: (req: Request) => string;\n}\n\n// ============================================================================\n// Internal helpers\n// ============================================================================\n\nfunction resolveEndUserId(opts: GenerateHandlerOptions, req: Request): string | undefined {\n  if (opts.endUserId) return opts.endUserId(req);\n  const header = req.headers.get('x-user-id');\n  return typeof header === 'string' && header.length > 0 ? header : undefined;\n}\n\nfunction encodeSseEvent(event: SSEEvent): string {\n  return `data: ${JSON.stringify(event)}\\n\\n`;\n}\n\n// ============================================================================\n// createGenerateHandler\n// ============================================================================\n\n/**\n * Returns a Web-standard Fetch handler that streams a generate call as SSE.\n *\n * Body shape accepted: `{ prompt: string; endUserId?: string; appId?: string }`\n */\nexport function createGenerateHandler(\n  opts: GenerateHandlerOptions,\n): (request: Request) => Promise<Response> {\n  return async (request: Request): Promise<Response> => {\n    let body: GenerateRequest;\n    try {\n      body = (await request.json()) as GenerateRequest;\n    } catch {\n      return new Response(JSON.stringify({ error: 'invalid JSON body' }), {\n        status: 400,\n        headers: { 'content-type': 'application/json' },\n      });\n    }\n\n    const rawPrompt = body.prompt ?? body.message;\n    const prompt = typeof rawPrompt === 'string' ? rawPrompt : '';\n\n    if (!prompt) {\n      return new Response(JSON.stringify({ error: 'prompt or message is required' }), {\n        status: 400,\n        headers: { 'content-type': 'application/json' },\n      });\n    }\n\n    const bodyEndUserId = typeof body.endUserId === 'string' ? body.endUserId : undefined;\n    const endUserId = bodyEndUserId ?? resolveEndUserId(opts, request);\n    const appId = typeof body.appId === 'string' ? body.appId : undefined;\n\n    const client = new AlmadarClient({ apiKey: opts.apiKey, baseUrl: opts.baseUrl });\n\n    const stream = new ReadableStream<Uint8Array>({\n      async start(controller) {\n        const encoder = new TextEncoder();\n        try {\n          await client.generate({\n            prompt,\n            endUserId,\n            appId,\n            onEvent: (event: SSEEvent) => {\n              controller.enqueue(encoder.encode(encodeSseEvent(event)));\n            },\n          });\n        } catch (err) {\n          const message = err instanceof Error ? err.message : String(err);\n          const errorEvent: SSEEvent = {\n            type: 'error',\n            timestamp: Date.now(),\n            data: { error: message },\n          };\n          controller.enqueue(encoder.encode(encodeSseEvent(errorEvent)));\n        } finally {\n          controller.close();\n        }\n      },\n    });\n\n    return new Response(stream, {\n      status: 200,\n      headers: {\n        'content-type': 'text/event-stream',\n        'cache-control': 'no-cache',\n        connection: 'keep-alive',\n      },\n    });\n  };\n}\n\n// ============================================================================\n// createEditHandler\n// ============================================================================\n\n/**\n * Returns a Web-standard Fetch handler that calls `editSchema` and returns JSON.\n *\n * Body shape accepted: `{ appId: string; patch: EditSchemaPatch }`\n */\nexport function createEditHandler(\n  opts: GenerateHandlerOptions,\n): (request: Request) => Promise<Response> {\n  return async (request: Request): Promise<Response> => {\n    let body: EditSchemaRequest;\n    try {\n      body = (await request.json()) as EditSchemaRequest;\n    } catch {\n      return new Response(JSON.stringify({ error: 'invalid JSON body' }), {\n        status: 400,\n        headers: { 'content-type': 'application/json' },\n      });\n    }\n\n    const appId = typeof body.appId === 'string' ? body.appId : '';\n    if (!appId) {\n      return new Response(JSON.stringify({ error: 'appId is required' }), {\n        status: 400,\n        headers: { 'content-type': 'application/json' },\n      });\n    }\n\n    const patch: EditSchemaPatch | undefined = body.patch;\n    if (patch === undefined || patch === null || typeof patch !== 'object') {\n      return new Response(JSON.stringify({ error: 'patch is required' }), {\n        status: 400,\n        headers: { 'content-type': 'application/json' },\n      });\n    }\n\n    const client = new AlmadarClient({ apiKey: opts.apiKey, baseUrl: opts.baseUrl });\n\n    try {\n      const schema: OrbitalSchema = await client.editSchema(appId, patch);\n      return new Response(JSON.stringify(schema), {\n        status: 200,\n        headers: { 'content-type': 'application/json' },\n      });\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      return new Response(JSON.stringify({ error: message }), {\n        status: 500,\n        headers: { 'content-type': 'application/json' },\n      });\n    }\n  };\n}\n","/**\n * `@almadar/sdk/server/express` — Express adapter for the Almadar server handlers.\n *\n * Node-only. The consumer must provide their own `express` installation.\n * This module imports express TYPES only; it is never bundled with express itself.\n *\n * Usage:\n *   import { createGenerateHandler, createEditHandler } from '@almadar/sdk/server/express';\n *   app.post('/api/agent/generate', createGenerateHandler({ apiKey }));\n *   app.put('/api/agent/edit', createEditHandler({ apiKey }));\n */\n\nimport type { Request as ExpressRequest, Response as ExpressResponse, RequestHandler } from 'express';\nimport {\n  createGenerateHandler as coreGenerateHandler,\n  createEditHandler as coreEditHandler,\n} from './index';\n\n// ============================================================================\n// Express-specific option surface\n// ============================================================================\n\nexport interface GenerateHandlerOptions {\n  /** API key issued from Studio's /settings/sdk panel. */\n  apiKey: string;\n  /** Defaults to https://studio.almadar.io. */\n  baseUrl?: string;\n  /**\n   * Derive a stable end-user id from the Express request.\n   * Falls back to the `x-user-id` request header when omitted.\n   */\n  endUserId?: (req: ExpressRequest) => string;\n}\n\n// ============================================================================\n// Express↔Fetch bridge helpers\n// ============================================================================\n\n/**\n * Convert an Express `Request` to a Web-standard `Request`.\n * Re-serialises the already-parsed body so the core handler's `request.json()` succeeds.\n */\nfunction expressReqToWebRequest(req: ExpressRequest): Request {\n  const protocol = req.protocol;\n  const host = req.get('host') ?? 'localhost';\n  const url = `${protocol}://${host}${req.originalUrl}`;\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(req.headers)) {\n    if (typeof value === 'string') {\n      headers.set(key, value);\n    } else if (Array.isArray(value)) {\n      for (const v of value) headers.append(key, v);\n    }\n  }\n  const bodyJson = JSON.stringify(req.body);\n  return new Request(url, { method: req.method, headers, body: bodyJson });\n}\n\n/**\n * Write a Web-standard `Response` back to an express `Response`.\n * Streams the body chunk-by-chunk so SSE works without buffering.\n */\nasync function pipeWebResponseToExpress(\n  webRes: Response,\n  res: ExpressResponse,\n): Promise<void> {\n  res.status(webRes.status);\n  webRes.headers.forEach((value, key) => {\n    res.setHeader(key, value);\n  });\n  if (webRes.body === null) {\n    res.end();\n    return;\n  }\n  const reader = webRes.body.getReader();\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      res.write(value);\n    }\n  } finally {\n    reader.releaseLock();\n    res.end();\n  }\n}\n\n// ============================================================================\n// Exported factories\n// ============================================================================\n\n/**\n * Returns an Express `RequestHandler` that streams a generate call as SSE.\n *\n * Body shape accepted: `{ prompt: string; endUserId?: string; appId?: string }`\n */\nexport function createGenerateHandler(opts: GenerateHandlerOptions): RequestHandler {\n  const coreHandler = coreGenerateHandler({\n    apiKey: opts.apiKey,\n    baseUrl: opts.baseUrl,\n    endUserId: opts.endUserId\n      ? (webReq: Request) => {\n          // The x-user-id header is available on the Web Request; express opts.endUserId\n          // receives the original express req via closure — pass the header value as a\n          // synthetic express request shaped enough for the callback.\n          const userId = webReq.headers.get('x-user-id');\n          return userId ?? '';\n        }\n      : undefined,\n  });\n  return async (req: ExpressRequest, res: ExpressResponse): Promise<void> => {\n    if (opts.endUserId) {\n      const userId = opts.endUserId(req);\n      if (userId) req.headers['x-user-id'] = userId;\n    }\n    const webReq = expressReqToWebRequest(req);\n    const webRes = await coreHandler(webReq);\n    await pipeWebResponseToExpress(webRes, res);\n  };\n}\n\n/**\n * Returns an Express `RequestHandler` that calls `editSchema` and returns JSON.\n *\n * Body shape accepted: `{ appId: string; patch: EditSchemaPatch }`\n */\nexport function createEditHandler(opts: GenerateHandlerOptions): RequestHandler {\n  const coreHandler = coreEditHandler({ apiKey: opts.apiKey, baseUrl: opts.baseUrl });\n  return async (req: ExpressRequest, res: ExpressResponse): Promise<void> => {\n    const webReq = expressReqToWebRequest(req);\n    const webRes = await coreHandler(webReq);\n    await pipeWebResponseToExpress(webRes, res);\n  };\n}\n"]}

package/dist/server/hono.d.ts

@@ -0,0 +1,33 @@
+import { Handler } from 'hono';
+import { GenerateHandlerOptions } from './index.js';
+
+/**
+ * `@almadar/sdk/server/hono` — Hono adapter for the Almadar server handlers.
+ *
+ * Hono is Fetch-native, so this is a near-passthrough: each factory wraps the
+ * core Web-standard handler in a Hono-compatible `Handler`.
+ *
+ * Node-only. The consumer must provide their own `hono` installation.
+ *
+ * Usage:
+ *   import { Hono } from 'hono';
+ *   import { createGenerateHandler, createEditHandler } from '@almadar/sdk/server/hono';
+ *   const app = new Hono();
+ *   app.post('/api/agent/generate', createGenerateHandler({ apiKey }));
+ *   app.put('/api/agent/edit', createEditHandler({ apiKey }));
+ */
+
+/**
+ * Returns a Hono `Handler` that streams a generate call as SSE.
+ *
+ * Body shape accepted: `{ prompt: string; endUserId?: string; appId?: string }`
+ */
+declare function createGenerateHandler(opts: GenerateHandlerOptions): Handler;
+/**
+ * Returns a Hono `Handler` that calls `editSchema` and returns JSON.
+ *
+ * Body shape accepted: `{ appId: string; patch: EditSchemaPatch }`
+ */
+declare function createEditHandler(opts: GenerateHandlerOptions): Handler;
+
+export { GenerateHandlerOptions, createEditHandler, createGenerateHandler };