@xano/sdk 1.0.0

package/dist/env-example-refresh-ET5HMMDW.js

@@ -0,0 +1,126 @@
+import {
+  bundleEnvNames,
+  refreshEnvExample,
+  rerenderEnvExample
+} from "./chunk-W3HBUKFO.js";
+import "./chunk-X677DMZM.js";
+import "./chunk-LRN4ZJCQ.js";
+import "./chunk-RTJRZFFY.js";
+import "./chunk-65HWOMGV.js";
+import "./chunk-TPHWJ7UG.js";
+import "./chunk-AOSYVMUS.js";
+import "./chunk-CJHQKJU4.js";
+import "./chunk-3DRXWLJ5.js";
+import "./chunk-X4DVXBFY.js";
+import "./chunk-TRJCALW3.js";
+import "./chunk-LIEOKXKD.js";
+import "./chunk-D7VGG3WS.js";
+import "./chunk-2TFRR6JV.js";
+import "./chunk-HRVBLCVJ.js";
+import "./chunk-YHEFQUQB.js";
+import "./chunk-ETO6LGLD.js";
+import "./chunk-ZIY7RNUT.js";
+import "./chunk-DAD3ONIS.js";
+import "./chunk-HHN734BU.js";
+import "./chunk-LPECSJ2J.js";
+import "./chunk-6NNTNXN7.js";
+import "./chunk-QCNYHBL7.js";
+import "./chunk-2ZUEE4EK.js";
+import "./chunk-AN6BL47T.js";
+import "./chunk-ET4Y4XCB.js";
+import "./chunk-SWBF2LTK.js";
+import "./chunk-UZ6QQWJT.js";
+import "./chunk-A3UDOZB6.js";
+import "./chunk-2MNLRIOX.js";
+import "./chunk-3M4LFYNQ.js";
+import "./chunk-AM4FKL4J.js";
+import "./chunk-Q325JKYB.js";
+import "./chunk-STSFNCY4.js";
+import "./chunk-I4F5TCJH.js";
+import "./chunk-5QU2P5CA.js";
+import "./chunk-ZYJP6BOO.js";
+import "./chunk-QO6BVGS5.js";
+import "./chunk-JZGVVJSI.js";
+import "./chunk-7G3CTU7I.js";
+import "./chunk-6PBR37LN.js";
+import "./chunk-T5KELPAR.js";
+import "./chunk-622HUCZT.js";
+import "./chunk-NAQDMEHV.js";
+import "./chunk-5A2PLKZB.js";
+import "./chunk-AHJWCYQO.js";
+import "./chunk-DX4QR4B2.js";
+import "./chunk-6QXLMMT3.js";
+import "./chunk-ZFDZKNGG.js";
+import "./chunk-FWD7AL6N.js";
+import "./chunk-2GNFDZA2.js";
+import "./chunk-JTUKLCXS.js";
+import "./chunk-4KHEMC32.js";
+import "./chunk-U64O2MXY.js";
+import "./chunk-ROY4YAEQ.js";
+import "./chunk-P2HAGF6H.js";
+import "./chunk-TLQE7ZN3.js";
+import "./chunk-WRBKLYSJ.js";
+import "./chunk-3LDULPRE.js";
+import "./chunk-XW6KISBB.js";
+import "./chunk-AWQ7BQTQ.js";
+import "./chunk-EUUUMY7J.js";
+import "./chunk-YLDALTWZ.js";
+import "./chunk-5FBYXK5P.js";
+import "./chunk-LLNZGEFK.js";
+import "./chunk-QXTKSOFI.js";
+import "./chunk-X2NL4KUO.js";
+import "./chunk-3KZCLN4Z.js";
+import "./chunk-FXFV3KU6.js";
+import "./chunk-OPHB5ORL.js";
+import "./chunk-UCQ2VUTG.js";
+import "./chunk-DGWHAVRG.js";
+import "./chunk-27GWNP2I.js";
+import "./chunk-3YW23UFH.js";
+import "./chunk-JGE7CAWB.js";
+import "./chunk-PTHVMXZI.js";
+import "./chunk-MXHSQOC4.js";
+import "./chunk-6IUMKYWI.js";
+import "./chunk-2CMJZDCL.js";
+import "./chunk-CTMO46PK.js";
+import "./chunk-ZDPP6RKB.js";
+import "./chunk-K5BBGTYZ.js";
+import "./chunk-LQCMKAJ7.js";
+import "./chunk-YGZHHAAB.js";
+import "./chunk-XVBGLISP.js";
+import "./chunk-6HO3NCSJ.js";
+import "./chunk-5V5XU32D.js";
+import "./chunk-GSGDWJB5.js";
+import "./chunk-HVRUQXGD.js";
+import "./chunk-ERVIASGL.js";
+import "./chunk-4POWHT2K.js";
+import "./chunk-H2V3N23D.js";
+import "./chunk-3JDU4VRL.js";
+import "./chunk-WTPZRR4I.js";
+import "./chunk-UTI5G6OJ.js";
+import "./chunk-2EZ3ZJZZ.js";
+import "./chunk-6MR5TI5V.js";
+import "./chunk-5ZSO4T2G.js";
+import "./chunk-XNCP4KYO.js";
+import "./chunk-AKNCFVKZ.js";
+import "./chunk-YU4HSQW7.js";
+import "./chunk-TFFGOFVZ.js";
+import "./chunk-EHP3WPEG.js";
+import "./chunk-L5JYN3NM.js";
+import "./chunk-Q7DGTQ5G.js";
+import "./chunk-G554NZNI.js";
+import "./chunk-N5GKCWE5.js";
+import "./chunk-OXA6PSZT.js";
+import "./chunk-VAX3UZOY.js";
+import "./chunk-NZOWWHU5.js";
+import "./chunk-4BW2SG2N.js";
+import "./chunk-TTEIYD5P.js";
+import "./chunk-CIMQZRRE.js";
+import "./chunk-OHX6MIUZ.js";
+import "./chunk-36JUQZVQ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  bundleEnvNames,
+  refreshEnvExample,
+  rerenderEnvExample
+};
+//# sourceMappingURL=env-example-refresh-ET5HMMDW.js.map

package/dist/env-pull-command-TNMNB3CV.js

@@ -0,0 +1,323 @@
+import {
+  confirm
+} from "./chunk-65HWOMGV.js";
+import {
+  exportWorkspaceBundle
+} from "./chunk-CJHQKJU4.js";
+import "./chunk-3DRXWLJ5.js";
+import "./chunk-X4DVXBFY.js";
+import {
+  envValuesOf
+} from "./chunk-45UIT5T2.js";
+import "./chunk-HRVBLCVJ.js";
+import {
+  refuseIfTracked,
+  requireSecretPathGitignored
+} from "./chunk-YHEFQUQB.js";
+import {
+  WORKSPACE_ENV_BASENAME,
+  WORKSPACE_ENV_EXAMPLE_BASENAME,
+  WORKSPACE_ENV_EXAMPLE_FILE,
+  WORKSPACE_ENV_FILE,
+  namesInEnvExample,
+  readWorkspaceEnvFile,
+  renderWorkspaceEnvFile
+} from "./chunk-DAD3ONIS.js";
+import {
+  NothingTrackedError,
+  memoCredential,
+  refuseProfileForLocal,
+  selectBackend
+} from "./chunk-HHN734BU.js";
+import "./chunk-LPECSJ2J.js";
+import "./chunk-6NNTNXN7.js";
+import {
+  resolveSource
+} from "./chunk-QCNYHBL7.js";
+import "./chunk-2ZUEE4EK.js";
+import "./chunk-AN6BL47T.js";
+import {
+  getAccessToken
+} from "./chunk-ET4Y4XCB.js";
+import "./chunk-SWBF2LTK.js";
+import "./chunk-UZ6QQWJT.js";
+import "./chunk-A3UDOZB6.js";
+import "./chunk-2MNLRIOX.js";
+import "./chunk-3M4LFYNQ.js";
+import "./chunk-AM4FKL4J.js";
+import {
+  requireBackendSlot
+} from "./chunk-STSFNCY4.js";
+import "./chunk-5QU2P5CA.js";
+import "./chunk-ZYJP6BOO.js";
+import "./chunk-QO6BVGS5.js";
+import "./chunk-JZGVVJSI.js";
+import "./chunk-7G3CTU7I.js";
+import "./chunk-6PBR37LN.js";
+import "./chunk-T5KELPAR.js";
+import "./chunk-622HUCZT.js";
+import {
+  contextFlags
+} from "./chunk-NAQDMEHV.js";
+import {
+  resolveBackendDir
+} from "./chunk-5A2PLKZB.js";
+import "./chunk-AHJWCYQO.js";
+import "./chunk-DX4QR4B2.js";
+import "./chunk-6QXLMMT3.js";
+import "./chunk-ZFDZKNGG.js";
+import "./chunk-FWD7AL6N.js";
+import "./chunk-2GNFDZA2.js";
+import "./chunk-JTUKLCXS.js";
+import "./chunk-4KHEMC32.js";
+import "./chunk-ROY4YAEQ.js";
+import "./chunk-TLQE7ZN3.js";
+import "./chunk-WRBKLYSJ.js";
+import "./chunk-3LDULPRE.js";
+import "./chunk-XW6KISBB.js";
+import "./chunk-AWQ7BQTQ.js";
+import "./chunk-EUUUMY7J.js";
+import "./chunk-YLDALTWZ.js";
+import "./chunk-5FBYXK5P.js";
+import {
+  atomicWrite
+} from "./chunk-LLNZGEFK.js";
+import "./chunk-QXTKSOFI.js";
+import "./chunk-X2NL4KUO.js";
+import "./chunk-UCQ2VUTG.js";
+import "./chunk-DGWHAVRG.js";
+import {
+  UsageError,
+  detail,
+  info,
+  isMachineOutput,
+  relForwardSlash,
+  step,
+  success,
+  warn,
+  writeJson
+} from "./chunk-PTHVMXZI.js";
+import "./chunk-2CMJZDCL.js";
+import "./chunk-5V5XU32D.js";
+import {
+  isRepresentableName,
+  safeNames
+} from "./chunk-GSGDWJB5.js";
+import "./chunk-ERVIASGL.js";
+import "./chunk-4POWHT2K.js";
+import "./chunk-H2V3N23D.js";
+import "./chunk-UTI5G6OJ.js";
+import "./chunk-2EZ3ZJZZ.js";
+import "./chunk-6MR5TI5V.js";
+import {
+  shellQuote
+} from "./chunk-5ZSO4T2G.js";
+import "./chunk-XNCP4KYO.js";
+import "./chunk-YU4HSQW7.js";
+import "./chunk-TFFGOFVZ.js";
+import "./chunk-L5JYN3NM.js";
+import "./chunk-G554NZNI.js";
+import "./chunk-N5GKCWE5.js";
+import "./chunk-OXA6PSZT.js";
+import "./chunk-VAX3UZOY.js";
+import "./chunk-NZOWWHU5.js";
+import "./chunk-4BW2SG2N.js";
+import "./chunk-TTEIYD5P.js";
+import "./chunk-CIMQZRRE.js";
+import "./chunk-OHX6MIUZ.js";
+import "./chunk-36JUQZVQ.js";
+import "./chunk-PZ5AY32C.js";
+
+// src/emit/env-pull-command.ts
+import { existsSync } from "fs";
+import { dirname, join } from "path";
+var HELP = { command: "env", subcommand: "pull" };
+function describeChange(before, after) {
+  const had = before ?? {};
+  const names = new Set(Object.keys(had));
+  return {
+    added: Object.keys(after).filter((n) => !names.has(n)),
+    // A name whose value is the same on both sides is not "replaced" — saying
+    // so turned an identical pull into a confirmation about nothing.
+    replaced: Object.keys(after).filter((n) => names.has(n) && had[n] !== after[n]),
+    lost: Object.keys(had).filter((n) => !Object.hasOwn(after, n))
+  };
+}
+async function runEnvPullCommand(args, opts = {}) {
+  const cwd = opts.deps?.cwd ?? process.cwd();
+  const deps = { ...opts.deps, cwd };
+  const slot = requireBackendSlot("env", "pull", "from");
+  const credential = memoCredential(() => getAccessToken(args));
+  const source = await selectBackend(slot, args.from, { credential, deps }).catch((err) => {
+    if (err instanceof NothingTrackedError) {
+      throw new UsageError(
+        `${err.message} Or fill in ${WORKSPACE_ENV_FILE} by hand from ${WORKSPACE_ENV_EXAMPLE_FILE}.`,
+        { hintFor: err.hintFor }
+      );
+    }
+    throw err;
+  });
+  if (source.kind === "file") {
+    throw new Error("Internal: `env pull` resolved a bundle file as its source.");
+  }
+  refuseProfileForLocal(args.profile, [source.kind], slot);
+  const backendDir = resolveBackendDir(cwd, args.backendDir, (m) => new UsageError(
+    `${m} \`env pull\` writes backend values into the directory it is given.`,
+    { hintFor: HELP }
+  ));
+  const path = join(cwd, backendDir, WORKSPACE_ENV_BASENAME);
+  const rel = relForwardSlash(cwd, path) || WORKSPACE_ENV_FILE;
+  if (!existsSync(dirname(path))) {
+    throw new UsageError(
+      `No ${backendDir}/ directory, so there is nowhere to put ${rel}. Run this from a project that has one \u2014 \`xanosdk init\` writes it, \`xanosdk pull${contextFlags()}\` refreshes it, and \`--backend-dir <path>\` names it when this project keeps its backend somewhere discovery cannot find it.`,
+      { hintFor: HELP }
+    );
+  }
+  refuseIfTracked(path, rel, HELP);
+  const resolved = await resolveSource(source, credential, deps);
+  step(`Reading env from ${resolved.target.label}`);
+  const bundle = await exportWorkspaceBundle(resolved.bearer, {
+    ...resolved.target,
+    label: `Reading env from ${resolved.target.label}`,
+    // The no-leak guarantee has to hold on the failure path too.
+    safeErrors: true
+  }).catch(async (err) => {
+    const { unansweredRead, actualKind } = await import("./source-resolve-S2XA3XZF.js");
+    throw unansweredRead(err, `read the env of ${resolved.target.label}`, actualKind(resolved));
+  });
+  const values = Object.fromEntries(envValuesOf(bundle));
+  let existing;
+  let unreadable = false;
+  try {
+    existing = readWorkspaceEnvFile(path);
+  } catch {
+    unreadable = true;
+  }
+  const change = describeChange(existing, values);
+  const { declaredEnvNames, readableDeclaredEnvNames } = await import("./pull-command-VBO7C4S3.js");
+  const declared = readableDeclaredEnvNames(dirname(path)) ?? [
+    .../* @__PURE__ */ new Set([...declaredEnvNames(dirname(path)), ...namesInEnvExample(join(dirname(path), WORKSPACE_ENV_EXAMPLE_BASENAME))])
+  ];
+  const valueless = declared.filter((n) => isRepresentableName(n) && !Object.hasOwn(values, n));
+  const sayValueless = () => {
+    if (valueless.length === 0) return;
+    const one = valueless.length === 1;
+    const to = args.from !== void 0 ? ` --to ${shellQuote(args.from)}` : "";
+    warn(
+      `${sentenceLabel(resolved)} holds no value for ${safeNames(valueless)}, which this project declares \u2014 so ${rel} has none for ${one ? "it" : "them"} either, and a deploy has nothing to send.`,
+      "env-pull.declared-missing",
+      [
+        ...valueless.map(
+          (n) => `Set it on the backend (the value on stdin), then pull again: \`xanosdk env set ${n}${to}${contextFlags(args)}\``
+        ),
+        `Or add ${one ? "it" : "them"} to ${rel} by hand.`
+      ]
+    );
+  };
+  if (existing !== void 0 && existsSync(path) && change.added.length === 0 && change.replaced.length === 0 && change.lost.length === 0) {
+    success(`${rel} is already up to date with ${sourceLabel(resolved)} \u2014 nothing to write.`);
+    sayValueless();
+    if (isMachineOutput(args)) {
+      writeJson({
+        path: rel,
+        source: resolved.provenance,
+        written: false,
+        upToDate: true,
+        names: Object.keys(values),
+        omitted: [],
+        dropped: []
+      });
+    }
+    return;
+  }
+  if (args.yes !== true && existsSync(path)) {
+    info(`${rel} will be REPLACED with the env of ${sourceLabel(resolved)}:`);
+    if (unreadable) detail(`the current ${rel} could not be parsed; it will be replaced wholesale`);
+    if (change.added.length > 0) detail(`added: ${safeNames(change.added)}`);
+    if (change.replaced.length > 0) detail(`value replaced: ${safeNames(change.replaced)}`);
+    if (change.lost.length > 0) detail(`present locally and will be LOST: ${safeNames(change.lost)}`);
+    if (Object.keys(values).length === 0) {
+      detail(`${sentenceLabel(resolved)} declares no env vars \u2014 the file will be written empty.`);
+    }
+    const { yesRerun } = await import("./retry-command-AS5EVREX.js");
+    const { rerun, note } = yesRerun(args, "env pull");
+    const ok = await confirm(`Overwrite ${rel}?`, {
+      flag: "--yes",
+      refusal: { details: { path: rel, written: false, wouldLose: change.lost.length }, rerun, note }
+    });
+    if (!ok) {
+      info("Nothing was written.");
+      if (isMachineOutput(args)) {
+        writeJson({ path: rel, source: resolved.provenance, written: false, upToDate: false, names: [], omitted: [], dropped: [] });
+      }
+      return;
+    }
+  }
+  requireSecretPathGitignored(path, HELP);
+  refuseIfTracked(path, rel, HELP);
+  const { content, omitted } = renderWorkspaceEnvFile(
+    values,
+    { source: sourceLabel(resolved), at: (/* @__PURE__ */ new Date()).toISOString() },
+    backendDir,
+    existsSync(join(dirname(path), WORKSPACE_ENV_EXAMPLE_BASENAME))
+  );
+  atomicWrite(path, content, { mode: 384 });
+  const written = Object.keys(values).length - omitted.length;
+  success(`Wrote ${written} env value${written === 1 ? "" : "s"} to ${rel} from ${sourceLabel(resolved)}.`);
+  sayValueless();
+  const dropped = change.lost.filter((n) => !valueless.includes(n));
+  if (dropped.length > 0) {
+    const one = dropped.length === 1;
+    warn(
+      `Dropped ${dropped.length} key${one ? "" : "s"} that ${one ? "was" : "were"} only in the local ${rel}: ${safeNames(dropped)}. ${sentenceLabel(resolved)} holds no value for ${one ? "it" : "them"}.`,
+      "env-pull.dropped-keys"
+    );
+  }
+  const badNames = omitted.filter((n) => !isRepresentableName(n));
+  const badValues = omitted.filter((n) => isRepresentableName(n));
+  if (badValues.length > 0) {
+    warn(
+      `${safeNames(badValues)} could not be written: the dotenv format carries no newlines or edge whitespace in a value. Pass ${badValues.length === 1 ? "it" : "each"} at deploy time with \`--env-var NAME=...\` \u2014 the value is still in the backend.`,
+      "env-pull.unwritable-value"
+    );
+  }
+  if (badNames.length > 0) {
+    const one = badNames.length === 1;
+    const to = args.from !== void 0 ? ` --to ${shellQuote(args.from)}` : "";
+    const typeable = badNames.every((n) => !/[\u0000-\u001F\u007F]/.test(n));
+    const unset = typeable ? ` with ${badNames.map((n) => `\`xanosdk env unset ${shellQuote(n)}${to}${contextFlags(args)}\``).join(", ")}` : "";
+    warn(
+      `${badNames.map((n) => `"${safeNames([n])}"`).join(", ")} could not be written: ${one ? "it is not a usable env var name" : "they are not usable env var names"} \u2014 a name is letters, digits and \`_\`, and does not start with a digit. No deploy can supply ${one ? "it" : "them"} either. Remove ${one ? "it" : "them"} from ${sourceLabel(resolved)}${unset}, and set the value again under a usable name with \`printf %s "$VALUE" | xanosdk env set NAME${to}${contextFlags(args)}\`.`,
+      "env-pull.invalid-name"
+    );
+  }
+  if (isMachineOutput(args)) {
+    const skipped = new Set(omitted);
+    writeJson({
+      path: rel,
+      source: resolved.provenance,
+      written: true,
+      // Always present, so a reader tests one key rather than its absence.
+      upToDate: false,
+      names: Object.keys(values).filter((n) => !skipped.has(n)),
+      omitted,
+      // Keys the file held that the source does not declare, now gone from it.
+      dropped: change.lost
+    });
+  }
+}
+function sourceLabel(resolved) {
+  if (resolved.provenance === "workspace") return "your workspace";
+  if (resolved.provenance === "local-engine") return "your local engine";
+  return resolved.provenance;
+}
+function sentenceLabel(resolved) {
+  const label = sourceLabel(resolved);
+  return label.startsWith("your ") ? `Y${label.slice(1)}` : label;
+}
+export {
+  runEnvPullCommand,
+  sentenceLabel,
+  sourceLabel
+};
+//# sourceMappingURL=env-pull-command-TNMNB3CV.js.map

package/dist/env-target-O4HRKTGZ.js

@@ -0,0 +1,40 @@
+import {
+  otherCredentialRefusal,
+  reachableFirst,
+  resolveEphemeralName
+} from "./chunk-SWBF2LTK.js";
+import "./chunk-5QU2P5CA.js";
+import "./chunk-ZYJP6BOO.js";
+import "./chunk-QO6BVGS5.js";
+import "./chunk-JZGVVJSI.js";
+import "./chunk-622HUCZT.js";
+import "./chunk-NAQDMEHV.js";
+import "./chunk-FWD7AL6N.js";
+import "./chunk-TLQE7ZN3.js";
+import "./chunk-XW6KISBB.js";
+import "./chunk-AWQ7BQTQ.js";
+import "./chunk-EUUUMY7J.js";
+import "./chunk-YLDALTWZ.js";
+import "./chunk-5FBYXK5P.js";
+import "./chunk-LLNZGEFK.js";
+import "./chunk-QXTKSOFI.js";
+import "./chunk-X2NL4KUO.js";
+import "./chunk-PTHVMXZI.js";
+import "./chunk-UTI5G6OJ.js";
+import "./chunk-2EZ3ZJZZ.js";
+import "./chunk-6MR5TI5V.js";
+import "./chunk-5ZSO4T2G.js";
+import "./chunk-XNCP4KYO.js";
+import "./chunk-TFFGOFVZ.js";
+import "./chunk-NZOWWHU5.js";
+import "./chunk-4BW2SG2N.js";
+import "./chunk-CIMQZRRE.js";
+import "./chunk-OHX6MIUZ.js";
+import "./chunk-36JUQZVQ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  otherCredentialRefusal,
+  reachableFirst,
+  resolveEphemeralName
+};
+//# sourceMappingURL=env-target-O4HRKTGZ.js.map