@glboost/sdk 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,366 @@
+import {
+  PRESET_NAMES,
+  canonicalSpec,
+  isPresetName,
+  parseCanonicalSpec,
+  presetSpec,
+  specDiffFromCompat
+} from "./chunk-YL4SZ5Y4.js";
+
+// ../core/src/share.ts
+function deliveryQueryForSpec(canonical, preset) {
+  const q = new URLSearchParams();
+  if (canonical === "original") {
+    q.set("p", "original");
+    return q;
+  }
+  if (preset && preset !== "original") {
+    q.set("p", preset);
+    return q;
+  }
+  q.set("p", "compat");
+  for (const [key, value] of specDiffFromCompat(parseCanonicalSpec(canonical))) q.set(key, value);
+  return q;
+}
+
+// src/client.ts
+import createOpenApiClient from "openapi-fetch";
+
+// src/errors.ts
+var GLBoostApiError = class extends Error {
+  name = "GLBoostApiError";
+  status;
+  /** The API's `error` string, e.g. `asset not found` or `optimization limit reached`. */
+  code;
+  body;
+  url;
+  constructor(status, body, url = null) {
+    const code = body.error ?? `HTTP ${status}`;
+    const planLimit = status === 402 || status === 413;
+    super(planLimit && body.hint ? `${code}: ${body.hint}` : code);
+    this.status = status;
+    this.code = code;
+    this.body = body;
+    this.url = url;
+  }
+  /** 402 (plan limit) or 413 (file too large): `plan`, `used`, `limit`, and `upgradeUrl` are set. */
+  get isPlanLimit() {
+    return this.status === 402 || this.status === 413;
+  }
+  get plan() {
+    return this.body.plan ?? null;
+  }
+  get used() {
+    return this.body.used ?? null;
+  }
+  get limit() {
+    return this.body.limit ?? null;
+  }
+  get hint() {
+    return this.body.hint ?? null;
+  }
+  /** Relative to the app (`/app/settings#billing`). */
+  get upgradeUrl() {
+    return this.body.upgradeUrl ?? null;
+  }
+  get issues() {
+    return this.body.issues ?? null;
+  }
+};
+async function apiErrorFromResponse(response, parsedBody) {
+  let body;
+  if (parsedBody !== void 0 && parsedBody !== null) {
+    body = typeof parsedBody === "object" ? parsedBody : { error: String(parsedBody) };
+  } else {
+    const text = await response.text().catch(() => "");
+    try {
+      const parsed = text ? JSON.parse(text) : {};
+      body = parsed && typeof parsed === "object" ? parsed : { error: text };
+    } catch {
+      body = text ? { error: text.slice(0, 200) } : {};
+    }
+  }
+  return new GLBoostApiError(response.status, body, response.url || null);
+}
+var GLBoostTimeoutError = class extends Error {
+  constructor(assetId, versionId, timeoutMs) {
+    super(`asset ${assetId} was not ready after ${Math.round(timeoutMs / 1e3)} s`);
+    this.assetId = assetId;
+    this.versionId = versionId;
+    this.timeoutMs = timeoutMs;
+  }
+  assetId;
+  versionId;
+  timeoutMs;
+  name = "GLBoostTimeoutError";
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://glboost.com";
+function createClient(options = {}) {
+  const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+  const impl = options.fetch;
+  const doFetch = (input, init) => (impl ?? globalThis.fetch)(input, init);
+  const headers = { ...options.headers };
+  if (options.apiKey) headers.authorization = `Bearer ${options.apiKey}`;
+  if (options.project) headers["x-glboost-project"] = options.project;
+  const api = createOpenApiClient({
+    baseUrl,
+    headers,
+    fetch: (request2) => doFetch(request2)
+  });
+  const request = (path, init = {}) => {
+    const url = /^https?:\/\//i.test(path) ? path : `${baseUrl}${path.startsWith("/") ? "" : "/"}${path}`;
+    const h = new Headers(init.headers);
+    for (const [key, value] of Object.entries(headers)) if (!h.has(key)) h.set(key, value);
+    if (typeof init.body === "string" && !h.has("content-type")) {
+      h.set("content-type", "application/json");
+    }
+    return doFetch(url, { ...init, headers: h });
+  };
+  let mePromise = null;
+  const me = () => {
+    mePromise ??= unwrap(api.GET("/api/v1/me")).catch((e) => {
+      mePromise = null;
+      throw e;
+    });
+    return mePromise;
+  };
+  return { baseUrl, api, fetch: doFetch, request, me };
+}
+async function unwrap(result) {
+  const { data, error, response } = await result;
+  if (!response.ok) throw await apiErrorFromResponse(response, error);
+  return data;
+}
+
+// src/sign.ts
+async function signUrl(client, assetId, options = {}) {
+  const spec = typeof options.spec === "string" ? parseCanonicalSpec(options.spec) : options.spec;
+  const body = {
+    ...options.preset ? { preset: options.preset } : {},
+    ...spec ? { spec } : {},
+    ...options.versionId ? { versionId: options.versionId } : {},
+    ...options.ttlSeconds !== void 0 ? { ttlSeconds: options.ttlSeconds } : {},
+    ...options.dl !== void 0 ? { dl: options.dl } : {}
+  };
+  return unwrap(
+    client.api.POST("/api/v1/assets/{assetId}/sign", { params: { path: { assetId } }, body })
+  );
+}
+
+// src/upload.ts
+var DEFAULT_UPLOAD_ENDPOINTS = {
+  init: "/api/v1/uploads",
+  finish: (versionId) => `/api/v1/uploads/${versionId}/complete`,
+  abort: (versionId) => `/api/v1/uploads/${versionId}/abort`
+};
+async function uploadModel(client, input, options = {}) {
+  const { name, blob } = toNamedBlob(input);
+  const endpoints = options.endpoints ?? DEFAULT_UPLOAD_ENDPOINTS;
+  const projectId = options.projectId ?? (options.endpoints ? void 0 : (await client.me()).project.id);
+  const initRes = await client.request(endpoints.init, {
+    method: "POST",
+    signal: options.signal,
+    body: JSON.stringify({
+      ...projectId ? { projectId } : {},
+      filename: name,
+      contentType: blob.type || contentTypeFor(name),
+      bytes: blob.size,
+      ...options.assetId ? { assetId: options.assetId } : {},
+      ...options.note?.trim() ? { note: options.note.trim() } : {},
+      ...endpoints.extra
+    })
+  });
+  if (!initRes.ok) throw await apiErrorFromResponse(initRes);
+  const init = await initRes.json();
+  try {
+    return await transfer(client, blob, init, options, endpoints);
+  } catch (e) {
+    await abortUpload(client, init, endpoints);
+    throw e;
+  }
+}
+async function transfer(client, blob, init, options, endpoints) {
+  const total = blob.size;
+  const count = Math.max(1, Math.ceil(total / init.partSize));
+  const transport = options.transport ?? (typeof XMLHttpRequest === "function" && options.onProgress ? "xhr" : "fetch");
+  const token = encodeURIComponent(init.token);
+  const parts = [];
+  let completed = 0;
+  options.onProgress?.({ loaded: 0, total });
+  for (let i = 0; i < count; i++) {
+    const chunk = blob.slice(i * init.partSize, Math.min(total, (i + 1) * init.partSize));
+    const url = `${init.uploadUrl}/part?n=${i + 1}&token=${token}`;
+    const report = (loaded) => options.onProgress?.({ loaded: Math.min(total, completed + loaded), total });
+    const part = transport === "xhr" ? await putPartXhr(url, chunk, report) : await putPartFetch(client, url, chunk, options.signal);
+    completed += chunk.size;
+    options.onProgress?.({ loaded: completed, total });
+    parts.push(part);
+  }
+  const done = await client.fetch(`${init.uploadUrl}/complete?token=${token}`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ parts }),
+    signal: options.signal
+  });
+  if (!done.ok) throw new Error(`complete failed: ${await readError(done)}`);
+  const finish = await client.request(endpoints.finish(init.versionId), {
+    method: "POST",
+    signal: options.signal
+  });
+  if (!finish.ok) throw await apiErrorFromResponse(finish);
+  return {
+    assetId: init.assetId,
+    versionId: init.versionId,
+    finish: await finish.json().catch(() => null)
+  };
+}
+async function putPartFetch(client, url, chunk, signal) {
+  const res = await client.fetch(url, { method: "PUT", body: chunk, signal });
+  if (!res.ok) throw new Error(`part upload failed: ${res.status} ${await readError(res)}`);
+  return await res.json();
+}
+function putPartXhr(url, chunk, onProgress) {
+  return new Promise((resolve, reject) => {
+    const xhr = new XMLHttpRequest();
+    xhr.open("PUT", url);
+    xhr.upload.onprogress = (e) => onProgress(e.loaded);
+    xhr.onload = () => {
+      if (xhr.status >= 200 && xhr.status < 300) {
+        resolve(JSON.parse(xhr.responseText));
+      } else reject(new Error(`part upload failed: ${xhr.status} ${xhr.responseText}`));
+    };
+    xhr.onerror = () => reject(new Error("part upload failed: network error"));
+    xhr.send(chunk);
+  });
+}
+async function abortUpload(client, init, endpoints) {
+  await Promise.allSettled([
+    client.fetch(`${init.uploadUrl}/abort?token=${encodeURIComponent(init.token)}`, {
+      method: "POST"
+    }),
+    endpoints.abort ? client.request(endpoints.abort(init.versionId), { method: "POST" }) : null
+  ]);
+}
+async function readError(res) {
+  try {
+    const body = await res.json();
+    return body.error ?? `${res.status}`;
+  } catch {
+    return `${res.status}`;
+  }
+}
+function toNamedBlob(input) {
+  if (input instanceof Blob) {
+    const name2 = input.name;
+    if (!name2) throw new TypeError("uploadModel: a Blob needs a name; pass { name, data }");
+    return { name: name2, blob: input };
+  }
+  if (!input.name) throw new TypeError("uploadModel: name is required");
+  const { name, data } = input;
+  const type = input.type ?? (data instanceof Blob ? data.type : "") ?? "";
+  if (data instanceof Blob) return { name, blob: input.type ? new Blob([data], { type }) : data };
+  return { name, blob: new Blob([data], { type }) };
+}
+function contentTypeFor(filename) {
+  const lower = filename.toLowerCase();
+  if (lower.endsWith(".glb")) return "model/gltf-binary";
+  if (lower.endsWith(".gltf")) return "model/gltf+json";
+  if (lower.endsWith(".zip")) return "application/zip";
+  return "application/octet-stream";
+}
+
+// src/urls.ts
+var DEFAULT_CDN_BASE = "https://cdn.glboost.com";
+function assetUrl(assetId, options = {}) {
+  const base = (options.base ?? DEFAULT_CDN_BASE).replace(/\/+$/, "");
+  const query = options.spec ? deliveryQueryForSpec(options.spec, null) : presetQuery(options.preset ?? "compat");
+  if (options.v) query.set("v", options.v);
+  if (options.dl) query.set("dl", "1");
+  return `${base}/${assetId}.glb?${query.toString()}`;
+}
+function configUrl(assetId, base = DEFAULT_CDN_BASE) {
+  return `${base.replace(/\/+$/, "")}/${assetId}/config.json`;
+}
+function presetQuery(preset) {
+  if (!isPresetName(preset)) throw new Error(`unknown preset "${preset}"`);
+  const spec = presetSpec(preset);
+  return deliveryQueryForSpec(spec ? canonicalSpec(spec) : "original", preset);
+}
+
+// src/wait.ts
+var PENDING = /* @__PURE__ */ new Set(["queued", "processing"]);
+async function waitForReady(client, assetId, options = {}) {
+  const timeoutMs = options.timeoutMs ?? 6e5;
+  const intervalMs = options.intervalMs ?? 5e3;
+  const deadline = Date.now() + timeoutMs;
+  for (; ; ) {
+    const data = await unwrap(
+      client.api.GET("/api/v1/assets/{assetId}/variants", {
+        params: { path: { assetId } },
+        signal: options.signal
+      })
+    );
+    const version = options.versionId ? data.versions.find((v) => v.id === options.versionId) : data.versions.reduce(
+      (best, v) => best === void 0 || v.number > best.number ? v : best,
+      void 0
+    );
+    if (!version) {
+      throw new Error(
+        options.versionId ? `version ${options.versionId} not found on asset ${assetId}` : `asset ${assetId} has no versions`
+      );
+    }
+    const state = {
+      versionId: version.id,
+      number: version.number,
+      variants: version.variants,
+      pending: version.variants.filter((v) => PENDING.has(v.status)),
+      failed: version.variants.filter((v) => v.status === "failed")
+    };
+    options.onPoll?.(state);
+    if (state.pending.length === 0) return state;
+    if (Date.now() + intervalMs > deadline) {
+      throw new GLBoostTimeoutError(assetId, version.id, timeoutMs);
+    }
+    await sleep(intervalMs, options.signal);
+  }
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(signal.reason instanceof Error ? signal.reason : new Error("aborted"));
+      return;
+    }
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(signal?.reason instanceof Error ? signal.reason : new Error("aborted"));
+    };
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+export {
+  DEFAULT_BASE_URL,
+  DEFAULT_CDN_BASE,
+  DEFAULT_UPLOAD_ENDPOINTS,
+  GLBoostApiError,
+  GLBoostTimeoutError,
+  PRESET_NAMES,
+  apiErrorFromResponse,
+  assetUrl,
+  canonicalSpec,
+  configUrl,
+  contentTypeFor,
+  createClient,
+  isPresetName,
+  parseCanonicalSpec,
+  signUrl,
+  unwrap,
+  uploadModel,
+  waitForReady
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../core/src/share.ts","../src/client.ts","../src/errors.ts","../src/sign.ts","../src/upload.ts","../src/urls.ts","../src/wait.ts"],"sourcesContent":["import { parseCanonicalSpec, specDiffFromCompat, type PresetName } from './spec';\nimport { signDelivery } from './tokens';\n\nconst SHARE_TOKEN_LENGTH = 22;\nconst URL_SAFE = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';\n\n/** 22 URL-safe chars from 64 symbols = 132 bits of entropy. */\nexport function newShareToken(random: (n: number) => Uint8Array = defaultRandom): string {\n  const bytes = random(SHARE_TOKEN_LENGTH);\n  let out = '';\n  for (let i = 0; i < SHARE_TOKEN_LENGTH; i++) out += URL_SAFE[(bytes[i] ?? 0) & 63];\n  return out;\n}\n\nfunction defaultRandom(n: number): Uint8Array {\n  const bytes = new Uint8Array(n);\n  crypto.getRandomValues(bytes);\n  return bytes;\n}\n\n/**\n * Query parameters that select a variant: `p=<preset>` for named presets, `p=original` for the\n * original, or `p=compat` plus the spec keys that differ from compat for ad-hoc specs. The preset\n * is always spelled out because the edge seeds a bare URL from the *project's* default preset,\n * which need not be compat; a URL that relied on that default would resolve (and sign) a different\n * spec on a project whose default is, say, `gpu`.\n */\nexport function deliveryQueryForSpec(\n  canonical: string,\n  preset: PresetName | null,\n): URLSearchParams {\n  const q = new URLSearchParams();\n  if (canonical === 'original') {\n    q.set('p', 'original');\n    return q;\n  }\n  if (preset && preset !== 'original') {\n    q.set('p', preset);\n    return q;\n  }\n  q.set('p', 'compat');\n  for (const [key, value] of specDiffFromCompat(parseCanonicalSpec(canonical))) q.set(key, value);\n  return q;\n}\n\nexport interface SignedUrlInput {\n  base: string;\n  assetId: string;\n  /** Canonical spec string or `original`; must match what `query` selects. */\n  canonical: string;\n  query: URLSearchParams;\n  versionId?: string;\n  dl?: boolean;\n  signingKey: string;\n  /** Unix seconds. */\n  exp: number;\n}\n\n/** Builds `https://<base>/<assetId>.glb?<query>&v=&dl=1&exp=&sig=` with a signature that verifies. */\nexport async function buildSignedUrl(input: SignedUrlInput): Promise<{ url: string; sig: string }> {\n  const path = `/${input.assetId}.glb`;\n  const sig = await signDelivery({\n    signingKey: input.signingKey,\n    path,\n    canonical: input.canonical,\n    exp: input.exp,\n  });\n  const q = new URLSearchParams(input.query);\n  if (input.versionId) q.set('v', input.versionId);\n  if (input.dl) q.set('dl', '1');\n  q.set('exp', String(input.exp));\n  q.set('sig', sig);\n  return { url: `${input.base}${path}?${q.toString()}`, sig };\n}\n","import createOpenApiClient, { type Client } from 'openapi-fetch';\nimport { apiErrorFromResponse } from './errors';\nimport type { paths } from './openapi';\n\nexport const DEFAULT_BASE_URL = 'https://glboost.com';\n\nexport interface ClientOptions {\n  /** `glb_live_…` from Settings → API keys. Leave unset for a same-origin dashboard session (cookies). */\n  apiKey?: string;\n  /** The app's origin (default `https://glboost.com`); `''` makes relative, same-origin requests in a browser. */\n  baseUrl?: string;\n  /** Project an org-wide key should work in (sent as `X-GLBoost-Project`). */\n  project?: string;\n  /** Replaces the global `fetch` (tests, custom dispatchers). */\n  fetch?: typeof fetch;\n  /** Extra headers on every API request. */\n  headers?: Record<string, string>;\n}\n\n/** `GET /api/v1/me`: the caller's org, project, role, and how it authenticated. */\nexport type Me = paths['/api/v1/me']['get']['responses'][200]['content']['application/json'];\n\nexport interface GLBoostClient {\n  readonly baseUrl: string;\n  /** The typed openapi-fetch client: `client.api.GET('/api/v1/assets')`, `client.api.POST(…)`. */\n  readonly api: Client<paths>;\n  /** The fetch in use, with no GLBoost headers (CDN upload endpoints take their token in the URL). */\n  readonly fetch: typeof fetch;\n  /**\n   * A raw request with the auth headers; `path` is absolute or relative to `baseUrl`. String bodies\n   * are sent as JSON unless a content type is given.\n   */\n  request(path: string, init?: RequestInit): Promise<Response>;\n  /** `GET /api/v1/me`, fetched once per client. */\n  me(): Promise<Me>;\n}\n\nexport function createClient(options: ClientOptions = {}): GLBoostClient {\n  const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, '');\n  const impl = options.fetch;\n  // Browsers throw \"Illegal invocation\" for an unbound `window.fetch`, hence the wrapper.\n  const doFetch: typeof fetch = (input, init) => (impl ?? globalThis.fetch)(input, init);\n  const headers: Record<string, string> = { ...options.headers };\n  if (options.apiKey) headers.authorization = `Bearer ${options.apiKey}`;\n  if (options.project) headers['x-glboost-project'] = options.project;\n  const api = createOpenApiClient<paths>({\n    baseUrl,\n    headers,\n    fetch: (request) => doFetch(request),\n  });\n\n  const request: GLBoostClient['request'] = (path, init = {}) => {\n    const url = /^https?:\\/\\//i.test(path)\n      ? path\n      : `${baseUrl}${path.startsWith('/') ? '' : '/'}${path}`;\n    const h = new Headers(init.headers);\n    for (const [key, value] of Object.entries(headers)) if (!h.has(key)) h.set(key, value);\n    if (typeof init.body === 'string' && !h.has('content-type')) {\n      h.set('content-type', 'application/json');\n    }\n    return doFetch(url, { ...init, headers: h });\n  };\n\n  let mePromise: Promise<Me> | null = null;\n  const me = () => {\n    mePromise ??= unwrap(api.GET('/api/v1/me')).catch((e: unknown) => {\n      mePromise = null;\n      throw e;\n    });\n    return mePromise;\n  };\n\n  return { baseUrl, api, fetch: doFetch, request, me };\n}\n\ntype ApiResult<T> = { data?: T; error?: unknown; response: Response };\n\n/** `data` of an openapi-fetch result, or a `GLBoostApiError` built from the response and its body. */\nexport async function unwrap<T>(result: ApiResult<T> | PromiseLike<ApiResult<T>>): Promise<T> {\n  const { data, error, response } = await result;\n  if (!response.ok) throw await apiErrorFromResponse(response, error);\n  return data as T;\n}\n","/** The body the API answers errors with: `{ error, issues? }`, plus the plan fields on 402 and 413. */\nexport interface ApiErrorBody {\n  error?: string;\n  issues?: unknown[];\n  plan?: string;\n  used?: number;\n  limit?: number;\n  hint?: string;\n  upgradeUrl?: string;\n}\n\n/** A non-2xx answer from the API. `message` is the API's `error` (plus the hint on plan limits). */\nexport class GLBoostApiError extends Error {\n  override readonly name = 'GLBoostApiError';\n  readonly status: number;\n  /** The API's `error` string, e.g. `asset not found` or `optimization limit reached`. */\n  readonly code: string;\n  readonly body: ApiErrorBody;\n  readonly url: string | null;\n\n  constructor(status: number, body: ApiErrorBody, url: string | null = null) {\n    const code = body.error ?? `HTTP ${status}`;\n    const planLimit = status === 402 || status === 413;\n    super(planLimit && body.hint ? `${code}: ${body.hint}` : code);\n    this.status = status;\n    this.code = code;\n    this.body = body;\n    this.url = url;\n  }\n\n  /** 402 (plan limit) or 413 (file too large): `plan`, `used`, `limit`, and `upgradeUrl` are set. */\n  get isPlanLimit(): boolean {\n    return this.status === 402 || this.status === 413;\n  }\n  get plan(): string | null {\n    return this.body.plan ?? null;\n  }\n  get used(): number | null {\n    return this.body.used ?? null;\n  }\n  get limit(): number | null {\n    return this.body.limit ?? null;\n  }\n  get hint(): string | null {\n    return this.body.hint ?? null;\n  }\n  /** Relative to the app (`/app/settings#billing`). */\n  get upgradeUrl(): string | null {\n    return this.body.upgradeUrl ?? null;\n  }\n  get issues(): unknown[] | null {\n    return this.body.issues ?? null;\n  }\n}\n\n/**\n * Builds the error for a failed response. Pass `parsedBody` when the body was already read (the\n * openapi-fetch client parses it); otherwise the body is read here.\n */\nexport async function apiErrorFromResponse(\n  response: Response,\n  parsedBody?: unknown,\n): Promise<GLBoostApiError> {\n  let body: ApiErrorBody;\n  if (parsedBody !== undefined && parsedBody !== null) {\n    body =\n      typeof parsedBody === 'object' ? (parsedBody as ApiErrorBody) : { error: String(parsedBody) };\n  } else {\n    const text = await response.text().catch(() => '');\n    try {\n      const parsed: unknown = text ? JSON.parse(text) : {};\n      body = parsed && typeof parsed === 'object' ? (parsed as ApiErrorBody) : { error: text };\n    } catch {\n      body = text ? { error: text.slice(0, 200) } : {};\n    }\n  }\n  return new GLBoostApiError(response.status, body, response.url || null);\n}\n\n/** `waitForReady` gave up before every variant settled. */\nexport class GLBoostTimeoutError extends Error {\n  override readonly name = 'GLBoostTimeoutError';\n  constructor(\n    readonly assetId: string,\n    readonly versionId: string | null,\n    readonly timeoutMs: number,\n  ) {\n    super(`asset ${assetId} was not ready after ${Math.round(timeoutMs / 1000)} s`);\n  }\n}\n","import { parseCanonicalSpec, type OptimizeSpec } from '@glboost/core';\nimport { unwrap, type GLBoostClient } from './client';\nimport type { paths } from './openapi';\n\nexport type SignResult =\n  paths['/api/v1/assets/{assetId}/sign']['post']['responses'][200]['content']['application/json'];\ntype SignBody = NonNullable<\n  paths['/api/v1/assets/{assetId}/sign']['post']['requestBody']\n>['content']['application/json'];\n\nexport interface SignOptions {\n  /** Named preset; default: the project's default preset. */\n  preset?: string;\n  /** A spec object or canonical string instead of a preset. */\n  spec?: OptimizeSpec | string;\n  versionId?: string;\n  /** 60 s to 7 days; default 10 minutes. */\n  ttlSeconds?: number;\n  /** Sign a download URL (`dl=1`). */\n  dl?: boolean;\n}\n\n/** `POST /api/v1/assets/{assetId}/sign`: a signed CDN URL for a private asset or a signing-required project. */\nexport async function signUrl(\n  client: GLBoostClient,\n  assetId: string,\n  options: SignOptions = {},\n): Promise<SignResult> {\n  const spec = typeof options.spec === 'string' ? parseCanonicalSpec(options.spec) : options.spec;\n  const body: SignBody = {\n    ...(options.preset ? { preset: options.preset } : {}),\n    ...(spec ? { spec: spec as SignBody['spec'] } : {}),\n    ...(options.versionId ? { versionId: options.versionId } : {}),\n    ...(options.ttlSeconds !== undefined ? { ttlSeconds: options.ttlSeconds } : {}),\n    ...(options.dl !== undefined ? { dl: options.dl } : {}),\n  };\n  return unwrap(\n    client.api.POST('/api/v1/assets/{assetId}/sign', { params: { path: { assetId } }, body }),\n  );\n}\n","import type { GLBoostClient } from './client';\nimport { apiErrorFromResponse } from './errors';\nimport type { paths } from './openapi';\n\n/** What `POST /api/v1/uploads` answers: the version ids and the CDN upload target. */\nexport type UploadInit =\n  paths['/api/v1/uploads']['post']['responses'][200]['content']['application/json'];\n/** What `POST /api/v1/uploads/{versionId}/complete` answers. */\nexport type UploadFinish =\n  paths['/api/v1/uploads/{versionId}/complete']['post']['responses'][200]['content']['application/json'];\n\nexport interface UploadProgress {\n  loaded: number;\n  total: number;\n}\n\n/** A `File`, or a named blob or byte buffer (`.glb`, self-contained `.gltf`, or `.zip`). */\nexport type UploadInput =\n  Blob | { name: string; data: Blob | ArrayBuffer | ArrayBufferView; type?: string };\n\n/** Where the init, finish, and abort calls go; the defaults are the public API. */\nexport interface UploadEndpoints {\n  init: string;\n  finish: (versionId: string) => string;\n  /** Tells the app the upload was given up on, so the version does not sit at `uploading`. */\n  abort?: (versionId: string) => string;\n  /** Extra fields for the init body (GLBoost's demo sends its Turnstile token). */\n  extra?: Record<string, unknown>;\n}\n\nexport const DEFAULT_UPLOAD_ENDPOINTS: UploadEndpoints = {\n  init: '/api/v1/uploads',\n  finish: (versionId) => `/api/v1/uploads/${versionId}/complete`,\n  abort: (versionId) => `/api/v1/uploads/${versionId}/abort`,\n};\n\nexport interface UploadOptions {\n  /** Defaults to the caller's project (`GET /api/v1/me`) when the default endpoints are used. */\n  projectId?: string;\n  /** Replace an existing asset with a new version. */\n  assetId?: string;\n  /** What changed in this version; shown on the dashboard and share pages. */\n  note?: string | null;\n  onProgress?: (progress: UploadProgress) => void;\n  endpoints?: UploadEndpoints;\n  signal?: AbortSignal;\n  /**\n   * How parts reach the CDN: `xhr` reports progress per byte and is the default in browsers when\n   * `onProgress` is set; `fetch` (the default elsewhere) reports progress per part.\n   */\n  transport?: 'fetch' | 'xhr';\n}\n\nexport interface UploadResult<F = UploadFinish> {\n  assetId: string;\n  versionId: string;\n  /** The finish call's body (`{ assetId, versionId, queued }` on the public API). */\n  finish: F | null;\n}\n\n/**\n * Uploads a model the way the dashboard does: init with the app, PUT the parts to the CDN,\n * complete the multipart upload there, then tell the app to start optimizing. On any failure after\n * init the upload is aborted on both sides (best effort) and the error is rethrown.\n */\nexport async function uploadModel<F = UploadFinish>(\n  client: GLBoostClient,\n  input: UploadInput,\n  options: UploadOptions = {},\n): Promise<UploadResult<F>> {\n  const { name, blob } = toNamedBlob(input);\n  const endpoints = options.endpoints ?? DEFAULT_UPLOAD_ENDPOINTS;\n  // Custom endpoints (the demo) decide their own project; the public API needs one.\n  const projectId =\n    options.projectId ?? (options.endpoints ? undefined : (await client.me()).project.id);\n  const initRes = await client.request(endpoints.init, {\n    method: 'POST',\n    signal: options.signal,\n    body: JSON.stringify({\n      ...(projectId ? { projectId } : {}),\n      filename: name,\n      contentType: blob.type || contentTypeFor(name),\n      bytes: blob.size,\n      ...(options.assetId ? { assetId: options.assetId } : {}),\n      ...(options.note?.trim() ? { note: options.note.trim() } : {}),\n      ...endpoints.extra,\n    }),\n  });\n  if (!initRes.ok) throw await apiErrorFromResponse(initRes);\n  const init = (await initRes.json()) as UploadInit;\n  try {\n    return await transfer<F>(client, blob, init, options, endpoints);\n  } catch (e) {\n    await abortUpload(client, init, endpoints);\n    throw e;\n  }\n}\n\nasync function transfer<F>(\n  client: GLBoostClient,\n  blob: Blob,\n  init: UploadInit,\n  options: UploadOptions,\n  endpoints: UploadEndpoints,\n): Promise<UploadResult<F>> {\n  const total = blob.size;\n  const count = Math.max(1, Math.ceil(total / init.partSize));\n  const transport =\n    options.transport ??\n    (typeof XMLHttpRequest === 'function' && options.onProgress ? 'xhr' : 'fetch');\n  const token = encodeURIComponent(init.token);\n  const parts: { partNumber: number; etag: string }[] = [];\n  let completed = 0;\n  options.onProgress?.({ loaded: 0, total });\n  for (let i = 0; i < count; i++) {\n    const chunk = blob.slice(i * init.partSize, Math.min(total, (i + 1) * init.partSize));\n    const url = `${init.uploadUrl}/part?n=${i + 1}&token=${token}`;\n    const report = (loaded: number) =>\n      options.onProgress?.({ loaded: Math.min(total, completed + loaded), total });\n    const part =\n      transport === 'xhr'\n        ? await putPartXhr(url, chunk, report)\n        : await putPartFetch(client, url, chunk, options.signal);\n    completed += chunk.size;\n    options.onProgress?.({ loaded: completed, total });\n    parts.push(part);\n  }\n\n  const done = await client.fetch(`${init.uploadUrl}/complete?token=${token}`, {\n    method: 'POST',\n    headers: { 'content-type': 'application/json' },\n    body: JSON.stringify({ parts }),\n    signal: options.signal,\n  });\n  if (!done.ok) throw new Error(`complete failed: ${await readError(done)}`);\n\n  const finish = await client.request(endpoints.finish(init.versionId), {\n    method: 'POST',\n    signal: options.signal,\n  });\n  if (!finish.ok) throw await apiErrorFromResponse(finish);\n  return {\n    assetId: init.assetId,\n    versionId: init.versionId,\n    finish: (await finish.json().catch(() => null)) as F | null,\n  };\n}\n\nasync function putPartFetch(\n  client: GLBoostClient,\n  url: string,\n  chunk: Blob,\n  signal?: AbortSignal,\n): Promise<{ partNumber: number; etag: string }> {\n  const res = await client.fetch(url, { method: 'PUT', body: chunk, signal });\n  if (!res.ok) throw new Error(`part upload failed: ${res.status} ${await readError(res)}`);\n  return (await res.json()) as { partNumber: number; etag: string };\n}\n\nfunction putPartXhr(\n  url: string,\n  chunk: Blob,\n  onProgress: (loaded: number) => void,\n): Promise<{ partNumber: number; etag: string }> {\n  return new Promise((resolve, reject) => {\n    const xhr = new XMLHttpRequest();\n    xhr.open('PUT', url);\n    xhr.upload.onprogress = (e) => onProgress(e.loaded);\n    xhr.onload = () => {\n      if (xhr.status >= 200 && xhr.status < 300) {\n        resolve(JSON.parse(xhr.responseText) as { partNumber: number; etag: string });\n      } else reject(new Error(`part upload failed: ${xhr.status} ${xhr.responseText}`));\n    };\n    xhr.onerror = () => reject(new Error('part upload failed: network error'));\n    xhr.send(chunk);\n  });\n}\n\n/** Drops the multipart upload on the CDN and marks the version failed in the app; failures are swallowed. */\nasync function abortUpload(\n  client: GLBoostClient,\n  init: UploadInit,\n  endpoints: UploadEndpoints,\n): Promise<void> {\n  await Promise.allSettled([\n    client.fetch(`${init.uploadUrl}/abort?token=${encodeURIComponent(init.token)}`, {\n      method: 'POST',\n    }),\n    endpoints.abort ? client.request(endpoints.abort(init.versionId), { method: 'POST' }) : null,\n  ]);\n}\n\nasync function readError(res: Response): Promise<string> {\n  try {\n    const body = (await res.json()) as { error?: string };\n    return body.error ?? `${res.status}`;\n  } catch {\n    return `${res.status}`;\n  }\n}\n\nfunction toNamedBlob(input: UploadInput): { name: string; blob: Blob } {\n  if (input instanceof Blob) {\n    const name = (input as Partial<File>).name;\n    if (!name) throw new TypeError('uploadModel: a Blob needs a name; pass { name, data }');\n    return { name, blob: input };\n  }\n  if (!input.name) throw new TypeError('uploadModel: name is required');\n  const { name, data } = input;\n  const type = input.type ?? (data instanceof Blob ? data.type : '') ?? '';\n  if (data instanceof Blob) return { name, blob: input.type ? new Blob([data], { type }) : data };\n  return { name, blob: new Blob([data as unknown as BlobPart], { type }) };\n}\n\n/** By extension; the app decides the format from the filename anyway. */\nexport function contentTypeFor(filename: string): string {\n  const lower = filename.toLowerCase();\n  if (lower.endsWith('.glb')) return 'model/gltf-binary';\n  if (lower.endsWith('.gltf')) return 'model/gltf+json';\n  if (lower.endsWith('.zip')) return 'application/zip';\n  return 'application/octet-stream';\n}\n","import {\n  canonicalSpec,\n  deliveryQueryForSpec,\n  isPresetName,\n  presetSpec,\n  type PresetName,\n} from '@glboost/core';\n\nexport const DEFAULT_CDN_BASE = 'https://cdn.glboost.com';\n\nexport interface AssetUrlOptions {\n  /** CDN origin (default `https://cdn.glboost.com`). */\n  base?: string;\n  /** Named preset (default `compat`); ignored when `spec` is given. */\n  preset?: PresetName | string;\n  /** Canonical spec string, e.g. `anim=keep,geo=meshopt,maxtex=1024,q=low,tex=ktx2`. */\n  spec?: string;\n  /** Pin a version id (`v=`). */\n  v?: string;\n  /** Ask for a download (`dl=1`). */\n  dl?: boolean;\n}\n\n/** The public delivery URL of an asset variant: `https://cdn.glboost.com/<id>.glb?p=gpu`. */\nexport function assetUrl(assetId: string, options: AssetUrlOptions = {}): string {\n  const base = (options.base ?? DEFAULT_CDN_BASE).replace(/\\/+$/, '');\n  const query = options.spec\n    ? deliveryQueryForSpec(options.spec, null)\n    : presetQuery(options.preset ?? 'compat');\n  if (options.v) query.set('v', options.v);\n  if (options.dl) query.set('dl', '1');\n  return `${base}/${assetId}.glb?${query.toString()}`;\n}\n\n/** `https://cdn.glboost.com/<id>/config.json`: what the viewer reads before loading. */\nexport function configUrl(assetId: string, base: string = DEFAULT_CDN_BASE): string {\n  return `${base.replace(/\\/+$/, '')}/${assetId}/config.json`;\n}\n\nfunction presetQuery(preset: string): URLSearchParams {\n  if (!isPresetName(preset)) throw new Error(`unknown preset \"${preset}\"`);\n  const spec = presetSpec(preset);\n  return deliveryQueryForSpec(spec ? canonicalSpec(spec) : 'original', preset);\n}\n","import { unwrap, type GLBoostClient } from './client';\nimport { GLBoostTimeoutError } from './errors';\nimport type { paths } from './openapi';\n\nexport type VariantsResponse =\n  paths['/api/v1/assets/{assetId}/variants']['get']['responses'][200]['content']['application/json'];\nexport type VariantRow = VariantsResponse['versions'][number]['variants'][number];\n\nexport interface WaitOptions {\n  /** A version to watch; default: the newest. */\n  versionId?: string;\n  /** Give up after this long (default 10 minutes). */\n  timeoutMs?: number;\n  /** Poll interval (default 5 s). */\n  intervalMs?: number;\n  signal?: AbortSignal;\n  /** Called after every poll with the state so far. */\n  onPoll?: (state: ReadyState) => void;\n}\n\nexport interface ReadyState {\n  versionId: string;\n  number: number;\n  variants: VariantRow[];\n  /** Still `queued` or `processing`. */\n  pending: VariantRow[];\n  failed: VariantRow[];\n}\n\nconst PENDING = new Set(['queued', 'processing']);\n\n/**\n * Polls `GET /api/v1/assets/{assetId}/variants` until no variant of the version is queued or\n * processing. Failed variants do not throw: they come back under `failed`.\n */\nexport async function waitForReady(\n  client: GLBoostClient,\n  assetId: string,\n  options: WaitOptions = {},\n): Promise<ReadyState> {\n  const timeoutMs = options.timeoutMs ?? 600_000;\n  const intervalMs = options.intervalMs ?? 5_000;\n  const deadline = Date.now() + timeoutMs;\n  for (;;) {\n    const data = await unwrap(\n      client.api.GET('/api/v1/assets/{assetId}/variants', {\n        params: { path: { assetId } },\n        signal: options.signal,\n      }),\n    );\n    const version = options.versionId\n      ? data.versions.find((v) => v.id === options.versionId)\n      : data.versions.reduce<VariantsResponse['versions'][number] | undefined>(\n          (best, v) => (best === undefined || v.number > best.number ? v : best),\n          undefined,\n        );\n    if (!version) {\n      throw new Error(\n        options.versionId\n          ? `version ${options.versionId} not found on asset ${assetId}`\n          : `asset ${assetId} has no versions`,\n      );\n    }\n    const state: ReadyState = {\n      versionId: version.id,\n      number: version.number,\n      variants: version.variants,\n      pending: version.variants.filter((v) => PENDING.has(v.status)),\n      failed: version.variants.filter((v) => v.status === 'failed'),\n    };\n    options.onPoll?.(state);\n    if (state.pending.length === 0) return state;\n    if (Date.now() + intervalMs > deadline) {\n      throw new GLBoostTimeoutError(assetId, version.id, timeoutMs);\n    }\n    await sleep(intervalMs, options.signal);\n  }\n}\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(signal.reason instanceof Error ? signal.reason : new Error('aborted'));\n      return;\n    }\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(signal?.reason instanceof Error ? signal.reason : new Error('aborted'));\n    };\n    const timer = setTimeout(() => {\n      signal?.removeEventListener('abort', onAbort);\n      resolve();\n    }, ms);\n    signal?.addEventListener('abort', onAbort, { once: true });\n  });\n}\n"],"mappings":"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","names":["request","name"]}

package/dist/testing.d.ts

@@ -0,0 +1,126 @@
+/**
+ * An in-memory stand-in for the GLBoost API and the CDN's upload endpoints, for tests of code built
+ * on `@glboost/sdk` (the SDK's and the CLI's own tests run against it). Pass `fetch` to
+ * `createClient({ fetch })`. It speaks the same routes and shapes as the real API for: `/me`,
+ * `/projects`, `/assets` (list, get, delete), `/assets/:id/variants`, `/assets/:id/sign`,
+ * `/assets/:id/exports`, `/shares`, the upload flow, and `${cdnBase}/_/upload/*`.
+ */
+interface FakeApiOptions {
+    /** API origin (default `https://api.test`). */
+    baseUrl?: string;
+    /** CDN origin the upload target points at (default `https://cdn.test`). */
+    cdnBase?: string;
+    plan?: 'free' | 'pro' | 'business';
+    project?: {
+        id: string;
+        name: string;
+        slug?: string;
+    };
+    /** Part size the upload target advertises (default 25 MiB, like the real edge). */
+    partSize?: number;
+    /** Variants turn `ready` once a version was polled this many times (default 1). */
+    readyAfterPolls?: number;
+    /** A preset whose variant fails instead of becoming ready. */
+    failPreset?: string | null;
+    /** Make `POST /uploads` answer a plan limit (402) or size limit (413) with the real body shape. */
+    refuse?: {
+        status: 402 | 413;
+        error: string;
+        hint?: string;
+        used?: number;
+        limit?: number;
+    } | null;
+    /** Require `Authorization: Bearer glb_…` on API routes (default: when `baseUrl` is set). */
+    requireAuth?: boolean;
+}
+interface FakeVariant {
+    id: string;
+    versionId: string;
+    spec: string;
+    preset: string | null;
+    requested: null;
+    status: 'queued' | 'processing' | 'ready' | 'failed';
+    bytes: number | null;
+    stats: null;
+    error: string | null;
+    createdAt: string;
+    readyAt: string | null;
+}
+interface FakeVersion {
+    id: string;
+    assetId: string;
+    number: number;
+    status: 'uploading' | 'uploaded' | 'processing' | 'ready' | 'failed';
+    originalBytes: number | null;
+    sourceFormat: 'glb' | 'gltf' | 'zip';
+    note: string | null;
+    createdAt: string;
+    variants: FakeVariant[];
+    /** Internal: how often this version's variants were read. */
+    polls: number;
+}
+interface FakeAsset {
+    id: string;
+    projectId: string;
+    name: string;
+    description: string | null;
+    visibility: 'public' | 'private';
+    tags: string[];
+    createdAt: string;
+    deletedAt: string | null;
+    versions: FakeVersion[];
+}
+interface FakeUpload {
+    uploadId: string;
+    token: string;
+    assetId: string;
+    versionId: string;
+    maxBytes: number;
+    parts: Map<number, {
+        etag: string;
+        size: number;
+    }>;
+    completed: number | null;
+    aborted: boolean;
+}
+interface FakeApiState {
+    assets: Map<string, FakeAsset>;
+    uploads: Map<string, FakeUpload>;
+    shares: Record<string, unknown>[];
+    exports: Record<string, unknown>[];
+    signed: Record<string, unknown>[];
+    /** Every request seen, oldest first. */
+    requests: {
+        method: string;
+        path: string;
+    }[];
+}
+interface SeedAssetInput {
+    id?: string;
+    name: string;
+    description?: string | null;
+    tags?: string[];
+    /** Original size of every version (default 1 MB). */
+    bytes?: number;
+    /** How many versions to create (default 1). */
+    versions?: number;
+    /** Variants start ready (default) or queued, to exercise polling. */
+    ready?: boolean;
+    deleted?: boolean;
+}
+interface FakeApi {
+    fetch: typeof fetch;
+    state: FakeApiState;
+    readonly baseUrl: string;
+    readonly cdnBase: string;
+    readonly project: {
+        id: string;
+        name: string;
+        slug: string;
+    };
+    seedAsset(input: SeedAssetInput): FakeAsset;
+}
+declare function createFakeApi(options?: FakeApiOptions): FakeApi;
+
+export { createFakeApi };
+export type { FakeApi, FakeApiOptions, FakeApiState, FakeAsset, FakeVariant, FakeVersion, SeedAssetInput };