@xano/sdk 1.0.0

package/dist/chunk-CJHQKJU4.js

@@ -0,0 +1,113 @@
+import {
+  decodeWorkspaceArchive
+} from "./chunk-3DRXWLJ5.js";
+import {
+  fetchReadOrExplain,
+  markupSummary,
+  readBodyBytes,
+  safeHttpFailure,
+  serverMessage,
+  statusLabel,
+  transportTarget
+} from "./chunk-YLDALTWZ.js";
+import {
+  withArticle
+} from "./chunk-36JUQZVQ.js";
+
+// src/deploy/workspace-export.ts
+var EXPORT_TIMEOUT_MS = 12e4;
+function probeLabel() {
+  return `__xanosdk_branch_probe_${Math.random().toString(36).slice(2, 10)}`;
+}
+async function assertBranchReadSupported(auth, opts) {
+  const base = opts.base.replace(/\/$/, "");
+  const url = `${base}/api:meta/workspace/${opts.workspaceId}/export`;
+  const res = await fetchReadOrExplain(
+    url,
+    {
+      method: "POST",
+      headers: { Authorization: `Bearer ${auth.access_token}`, "Content-Type": "application/json" },
+      body: JSON.stringify({ branch: probeLabel(), password: "", records: false, vault: false }),
+      signal: AbortSignal.timeout(EXPORT_TIMEOUT_MS)
+    },
+    "branch support probe",
+    EXPORT_TIMEOUT_MS
+  );
+  if (!res.ok) return;
+  throw new Error(
+    `Refusing to read branch "${opts.branch}": this instance ignores the branch parameter on workspace export.
+  instance: ${opts.base}
+It accepted a branch label that cannot exist and answered 200 with an archive, which is what an instance that drops the parameter does. Such an instance returns whichever branch is LIVE \u2014 so the project written from it would be the live branch's code under the name of the branch you asked for, reported as success.
+Update the instance, or drop \`--branch\` to read the live branch deliberately.`
+  );
+}
+async function exportWorkspaceBundle(auth, opts) {
+  const base = opts.base.replace(/\/$/, "");
+  const url = `${base}/api:meta/workspace/${opts.workspaceId}/export`;
+  const res = await fetchReadOrExplain(
+    url,
+    {
+      method: "POST",
+      headers: { Authorization: `Bearer ${auth.access_token}`, "Content-Type": "application/json" },
+      // `branch`/`password` are required; the defaults mean "current branch, no
+      // archive password". `records: false` / `vault: false` skip table content
+      // and stored file bytes — see above.
+      // A named branch must be one the workspace ALREADY has: an unknown label
+      // is an error from the route, not a fallback to live.
+      body: JSON.stringify({ branch: opts.branch ?? "", password: "", records: false, vault: false }),
+      signal: AbortSignal.timeout(EXPORT_TIMEOUT_MS)
+    },
+    opts.label,
+    EXPORT_TIMEOUT_MS
+  );
+  if (!res.ok) {
+    const body = await readBodyBytes(res, opts.label, { url, timeoutMs: EXPORT_TIMEOUT_MS });
+    const text = new TextDecoder("utf-8", { fatal: false }).decode(body);
+    throw Object.assign(
+      new Error(
+        opts.safeErrors === true ? safeHttpFailure(opts.label, res, text) : `${opts.label} failed (${statusLabel(res)})${errorDetail(body, text)}`
+      ),
+      { status: res.status }
+    );
+  }
+  const bytes = await readBodyBytes(res, opts.label, { url, timeoutMs: EXPORT_TIMEOUT_MS });
+  if (!looksLikeArchive(bytes)) throw notAnArchive(opts.label, url, bytes, opts.safeErrors === true);
+  let bundle;
+  try {
+    bundle = decodeWorkspaceArchive(bytes);
+  } catch (err) {
+    throw new Error(
+      `${opts.label}: ${transportTarget(url)} answered with an archive that could not be read (${err instanceof Error ? err.message : String(err)}) \u2014 not a workspace export.`,
+      { cause: err }
+    );
+  }
+  if (bundle === null || typeof bundle !== "object" || !("payload" in bundle)) {
+    throw new Error(`${opts.label}: the exported archive carried no \`payload\` \u2014 not a workspace bundle.`);
+  }
+  return bundle;
+}
+function looksLikeArchive(bytes) {
+  if (bytes[0] === 31 && bytes[1] === 139) return true;
+  return bytes.length >= 262 && new TextDecoder().decode(bytes.subarray(257, 262)) === "ustar";
+}
+function notAnArchive(label, url, bytes, safe) {
+  const text = new TextDecoder("utf-8", { fatal: false }).decode(bytes.subarray(0, 4096));
+  const page = markupSummary(text);
+  const what = page !== void 0 ? `${safe ? "an HTML page" : page.replace(/, not an API response$/, "")}, not an export archive \u2014 a proxy or captive portal between you and the instance?` : bytes.length === 0 ? "an empty body, not an export archive." : /^\s*[[{]/.test(text) ? "JSON, not an export archive." : "something that is not an export archive.";
+  return new Error(`${label}: ${transportTarget(url)} answered with ${what}`);
+}
+function errorDetail(bytes, text) {
+  const NOT_TEXT = /[\uFFFD\u0000-\u0008\u000B\u000C\u000E-\u001F]/;
+  if (bytes.length > 0 && NOT_TEXT.test(text)) {
+    const gzip = bytes[0] === 31 && bytes[1] === 139;
+    return gzip ? `: the body is a workspace archive (${bytes.length} bytes) sent with an error status \u2014 re-run the export, and if it persists the instance is failing mid-export.` : `: ${withArticle(`${bytes.length}-byte`)} binary body, not an error message.`;
+  }
+  const message = serverMessage(text);
+  return message !== void 0 ? `: ${message}` : ".";
+}
+
+export {
+  assertBranchReadSupported,
+  exportWorkspaceBundle
+};
+//# sourceMappingURL=chunk-CJHQKJU4.js.map