@xanots/sdk 0.0.9 → 0.0.11

package/dist/chunk-WGPXT2G2.js

@@ -0,0 +1,22 @@
+// src/emit/output-target.ts
+import { statSync } from "fs";
+import { join, resolve } from "path";
+function resolveOutputTarget(opts) {
+  const { path, name, ext } = opts;
+  if (path === "-") return { kind: "stdout" };
+  const basename = `${name}.${ext}`;
+  if (path === void 0 || path === "") {
+    return { kind: "file", path: resolve(basename) };
+  }
+  const endsWithSep = path.endsWith("/") || path.endsWith("\\");
+  const isDir = statSync(path, { throwIfNoEntry: false })?.isDirectory() ?? false;
+  if (endsWithSep || isDir) {
+    return { kind: "file", path: resolve(join(path, basename)) };
+  }
+  return { kind: "file", path: resolve(path) };
+}
+
+export {
+  resolveOutputTarget
+};
+//# sourceMappingURL=chunk-WGPXT2G2.js.map

package/dist/{chunk-6AAT2AYQ.js → chunk-WP4OZZV4.js}

@@ -29,7 +29,7 @@ function endpoint(opts, suffix = "", qs = "") {
 }
 function explainDuplicateIdentity(body2) {
   if (!/duplicate key value violates unique constraint/i.test(body2)) return void 0;
-  return "The import tried to CREATE objects that already exist under different identities, and the engine refused the duplicate.\nThis is what a stale `xano.lock` looks like: it names guids the workspace no longer has, so nothing matched and everything was planned as new. `--replace` causes it by minting fresh identities.\nRun `xanots lock adopt` against this workspace to re-pin the lock to what is actually there, then release again.";
+  return "The import tried to CREATE objects that already exist under different identities, and the engine refused the duplicate.\nThis is what a stale `xano.lock` looks like: it names guids the workspace no longer has, so nothing matched and everything was planned as new. `--replace` causes it by minting fresh identities.\nRun `xanots lock import` against this workspace to re-pin the lock to what is actually there, then release again.";
 }
 var ImportHttpError = class extends Error {
   constructor(status, action, statusText, body2) {
@@ -173,4 +173,4 @@ export {
   importWorkspaceArchive,
   planWorkspaceImport
 };
-//# sourceMappingURL=chunk-6AAT2AYQ.js.map
+//# sourceMappingURL=chunk-WP4OZZV4.js.map

package/dist/{chunk-OYMR5AMJ.js → chunk-XEOX6AM7.js}

@@ -4,7 +4,7 @@ import {
 import {
   parseLock,
   serializeLock
-} from "./chunk-7JDT4PBU.js";
+} from "./chunk-VAF6A3YD.js";
 
 // src/lock/io.ts
 import { readFileSync, existsSync } from "fs";
@@ -35,4 +35,4 @@ export {
   readLockFile,
   writeLockFile
 };
-//# sourceMappingURL=chunk-OYMR5AMJ.js.map
+//# sourceMappingURL=chunk-XEOX6AM7.js.map

package/dist/{chunk-MU3O43L2.js → chunk-YBC3IKMF.js}

@@ -1,6 +1,6 @@
 import {
   renderThemeScript
-} from "./chunk-P5C2YKAM.js";
+} from "./chunk-ANUDXFEX.js";
 import {
   defaultThemeChoice,
   iconLibraryOf,
@@ -842,4 +842,4 @@ export {
   allFrontendPresets,
   resolveFrameworkFlag
 };
-//# sourceMappingURL=chunk-MU3O43L2.js.map
+//# sourceMappingURL=chunk-YBC3IKMF.js.map

package/dist/chunk-ZQ2PKR6R.js

@@ -0,0 +1,40 @@
+import {
+  getEnvironment,
+  readEphemeralState
+} from "./chunk-K5IOND4K.js";
+
+// src/emit/env-target.ts
+async function resolveEphemeral(auth, name, deps) {
+  const resolved = resolveEphemeralName(auth, name, deps.cwd);
+  const summary = await deps.resolveLive(auth, auth.workspaceId, resolved);
+  if (summary.url === void 0) {
+    throw new Error(`Ephemeral "${resolved}" has no base URL to address yet \u2014 it may still be provisioning.`);
+  }
+  return { base: summary.url, workspaceId: 1, label: `ephemeral ${resolved}`, env: resolved };
+}
+function resolveEphemeralName(auth, name, cwd = process.cwd()) {
+  const tracked = getEnvironment(readEphemeralState(cwd), auth.workspaceId)?.name;
+  const resolved = name ?? tracked;
+  if (resolved === void 0 || resolved === "") {
+    throw new Error(
+      `No ephemeral environment to target. Name one with \`ephemeral:<name>\` (\`xanots ephemeral list\` shows them), or run \`xanots deploy\` first \u2014 this project then remembers the env it deployed to, which is what bare \`ephemeral\` reads.`
+    );
+  }
+  return resolved;
+}
+async function resolveMetaTarget(auth, selector, deps = {}) {
+  switch (selector.kind) {
+    case "workspace":
+      return { base: auth.instance, workspaceId: auth.workspaceId, label: `workspace ${auth.workspaceId}` };
+    case "ephemeral": {
+      const resolveLive = deps.resolveLive ?? (await import("./ephemeral-command-U4AQ3TXX.js")).resolveLive;
+      return resolveEphemeral(auth, selector.name, { ...deps, resolveLive });
+    }
+  }
+}
+
+export {
+  resolveEphemeralName,
+  resolveMetaTarget
+};
+//# sourceMappingURL=chunk-ZQ2PKR6R.js.map

package/dist/cli.d.ts

@@ -27,7 +27,7 @@ interface NonPublicSeedValue {
 interface ParsedArgs {
     command: string | undefined;
     /**
-     * The verb of a noun-verb command (`sandbox deploy`, `profile me`): here
+     * The verb of a noun-verb command (`workspace export`, `profile me`): here
      * `command` is the noun and `subcommand` is the verb.
      * Undefined for the single-token verbs (`compile`/`export`/`lock`/…).
      */
@@ -73,14 +73,17 @@ interface ParsedArgs {
     /** `--reset`: accepted but redundant — every deploy is a full replace now. */
     reset: boolean;
     /**
-     * `--dest`: which environment to address.
+     * `test --env <target>`: which environment to read — `workspace`,
+     * `ephemeral`, or `ephemeral:<name>`. Kept as the raw string and resolved by
+     * `env-selector.ts`, the one module that knows the grammar, so `init --from`
+     * and this cannot drift on how an environment is spelled.
      *
-     * The parser accepts all three because `test` reads all three. `workspace` is
-     * refused by the commands that WRITE (`deploy`, `release`) at dispatch, with
-     * the explanation — not here, where the message could only say "bad value"
-     * for something that is a deliberate product boundary rather than a typo.
+     * `deploy` and `release` each reach exactly one environment and declare no
+     * flag for it; they refuse this at dispatch with the reason rather than a
+     * "bad value" here, since a full-replace import into a real workspace is a
+     * product boundary rather than a typo.
      */
-    dest: "sandbox" | "ephemeral" | "workspace" | undefined;
+    env: string | undefined;
     /** `test --kind unit|workflow`: narrow to one test family (default: both). */
     kind: "unit" | "workflow" | undefined;
     /** `test run-all --concurrency <n>`: how many tests to run at once (default 1). */
@@ -95,7 +98,7 @@ interface ParsedArgs {
      * frontend gets the typed path/verb contract without the SDK runtime.
      */
     emit: string | undefined;
-    /** `deploy --static <dir>`: archive this directory and deploy it to the sandbox's static host. */
+    /** `deploy --static <dir>`: archive this directory and deploy it to the environment's static host. */
     static: string | undefined;
     /**
      * `deploy --static-env KEY=VALUE` (repeatable): public config baked into EVERY
@@ -152,22 +155,22 @@ interface ParsedArgs {
     paste: boolean;
     /** `login --scope "<space list>"`: OAuth scopes to request (default: the built-in xano-cli set). */
     scope: string | undefined;
-    /** `validate --runtime`: after import + round-trip, run each deployed function and report. */
+    /** `preflight --runtime`: after import + round-trip, run each deployed function and report. */
     runtime: boolean;
-    /** `validate --capture`: write each round-tripped function's fetched JSON (candidate fixtures). */
+    /** `preflight --capture`: write each round-tripped function's fetched JSON (candidate fixtures). */
     capture: boolean;
-    /** `validate --verbose`: print full diffs / raw engine detail instead of a projected summary. */
+    /** `preflight --verbose`: print full diffs / raw engine detail instead of a projected summary. */
     verbose: boolean;
-    /** `validate --instance <url>`: override XANO_VALIDATE_INSTANCE for this run. */
+    /** `preflight --instance <url>`: override XANO_VALIDATE_INSTANCE for this run. */
     instance: string | undefined;
-    /** `sandbox export --format <json|multidoc>`: which artifact to emit (validated at parse time). */
+    /** `ephemeral export --format <json|multidoc>`: which artifact to emit (validated at parse time). */
     format: "json" | "multidoc" | undefined;
-    /** `sandbox export --path <p>`: output location (`-` for stdout; a dir or a full file path). */
+    /** `<env> export --path <p>`: output location (`-` for stdout; a dir or a full file path). */
     path: string | undefined;
-    /** `sandbox export --name <n>`: output basename override (default `sandbox`). Also the `init`/`codegen` app name (default: target dir basename). */
+    /** `<env> export --name <n>`: output basename override. Also the `init` app name (default: target dir basename). */
     name: string | undefined;
     /**
-     * `init`/`codegen` `--ai <preset>` (repeatable, comma-separated): AI-assistant instruction
+     * `init` `--ai <preset>` (repeatable, comma-separated): AI-assistant instruction
      * files to scaffold (`claude`/`codex`/`cursor`/`none`). Empty = prompt in a TTY,
      * else write none. Validated in the init command, not at parse time.
      */
@@ -182,45 +185,68 @@ interface ParsedArgs {
      */
     marketplace: string[];
     /**
-     * `init`/`codegen` `--framework <id>`: which frontend to scaffold
+     * `init --from <source>`: where `xano/` comes from — `workspace`,
+     * `ephemeral:<name>`, or a path to a bundle JSON already on disk. Undefined
+     * writes the empty-but-valid starter backend instead.
+     *
+     * Kept as the raw string here and resolved in `init-command.ts`, so the one
+     * place that knows the spellings is the one that reports a bad one.
+     */
+    from: string | undefined;
+    /**
+     * `init` `--framework <id>`: which frontend to scaffold
      * (`react`/`svelte`). Undefined = prompt in a TTY, else the default.
      * Validated in `frontend-presets.ts`, not at parse time.
      */
     framework: string | undefined;
     /**
-     * `init`/`codegen` `--theme <id>`: the shadcn/ui palette to render into the
+     * `init` `--theme <id>`: the shadcn/ui palette to render into the
      * scaffold's stylesheet — a `<base>` or `<base>-<accent>` pair, a registry
      * theme URL, or a path to a registry item JSON file. Undefined = plain
      * shadcn. Validated in `theme-presets.ts`, not at parse time.
      */
     theme: string | undefined;
-    /** `init`/`codegen` `--radius <len>`: corner radius override, bare number = rem. */
+    /** `init` `--radius <len>`: corner radius override, bare number = rem. */
     radius: string | undefined;
     /**
-     * `init`/`codegen` `--dark <mode>`: what switches the scaffold into its dark
+     * `init` `--dark <mode>`: what switches the scaffold into its dark
      * palette — `system` (default), `toggle`, or `off`.
      */
     dark: string | undefined;
-    /** `init`/`codegen` `--font <id>`: the body typeface (Tailwind's `--font-sans`). */
+    /** `init` `--font <id>`: the body typeface (Tailwind's `--font-sans`). */
     font: string | undefined;
-    /** `init`/`codegen` `--font-mono <id>`: the code typeface. */
+    /** `init` `--font-mono <id>`: the code typeface. */
     fontMono: string | undefined;
-    /** `init`/`codegen` `--font-heading <id>`: the heading typeface; absent inherits the body face. */
+    /** `init` `--font-heading <id>`: the heading typeface; absent inherits the body face. */
     fontHeading: string | undefined;
-    /** `init`/`codegen` `--icons <id>`: the icon set (`lucide` default, `tabler`, `phosphor`). */
+    /** `init` `--icons <id>`: the icon set (`lucide` default, `tabler`, `phosphor`). */
     icons: string | undefined;
-    /** `init`/`codegen` `--force`: scaffold into a non-empty target directory (overwrite our own files). */
+    /** `init` `--force`: scaffold into a non-empty target directory (overwrite our own files). */
     force: boolean;
-    /** `init`/`codegen` `--no-install`: skip the post-scaffold `npm install`. For `codegen` this also means the round trip cannot be verified, since loading the tree needs its dependencies. */
+    /** `init` `--no-install`: skip the post-scaffold `npm install`. Under `--from` this also means the round trip cannot be verified, since loading the tree needs its dependencies. */
     noInstall: boolean;
     /**
-     * `deploy --no-verify`: skip the post-deploy liveness checks. Everything is
-     * still deployed; XanoTS just doesn't wait to confirm it came up — neither
+     * `deploy --skip-liveness`: skip the post-deploy liveness checks. Everything
+     * is still deployed; XanoTS just doesn't wait to confirm it came up — neither
      * that the edge is serving *this* static build (via `X-Xano-Canonical`) nor
      * that the workspace's microservices reached a ready state. Useful for fast
      * iterative deploys or when the deployed URL isn't reachable from the CLI host.
      */
-    noVerify: boolean;
+    skipLiveness: boolean;
+    /**
+     * `init --from … --skip-roundtrip`: skip the offline check that the tree just
+     * written re-exports as the bundle it was decoded from. Entirely local — no
+     * network, no deploy, no workspace mutation — which is why it is not the same
+     * flag as {@link skipLiveness} despite both once being spelled `--no-verify`.
+     */
+    skipRoundtrip: boolean;
+    /**
+     * `lock prune --identity-only`: drop the named entries without loading the
+     * entry file. The third thing `--no-verify` used to mean, and the least
+     * related to the other two: nothing is verified either way, the question is
+     * whether the workspace is evaluated at all.
+     */
+    identityOnly: boolean;
     /**
      * `deploy --require-microservices`: fail the deploy when a microservice has
      * not reported ready by the end of the wait, not just when the engine says it
@@ -230,7 +256,7 @@ interface ParsedArgs {
      */
     requireMicroservices: boolean;
     /**
-     * `codegen --report <grouped|full|json>`: how the findings are rendered.
+     * `init --from … --report <grouped|full|json>`: how the findings are rendered.
      *
      * `grouped` (the default) prints one line per distinct root cause with a count
      * and a collapsed object list; `full` prints every site; `json` prints the
@@ -383,7 +409,7 @@ interface CompiledBundle {
 }
 /**
  * Thin wrapper over {@link compileBundle} for the many callers that only need the
- * bundle text (export, validate, sandbox-export). Seed content is not built here.
+ * bundle text (export, preflight). Seed content is not built here.
  */
 declare function exportBundleJson(args: ParsedArgs): Promise<string>;
 /**

package/dist/cli.js

@@ -8,17 +8,19 @@ import {
   resolveHelpRequest,
   resolveLockPath,
   run
-} from "./chunk-K3YSQDXJ.js";
-import "./chunk-JQLR64UC.js";
-import "./chunk-OYMR5AMJ.js";
+} from "./chunk-RCT7UX7B.js";
+import "./chunk-CTD5ZCV6.js";
+import "./chunk-XEOX6AM7.js";
+import "./chunk-F6CYJ7TN.js";
 import "./chunk-GNPVYOPB.js";
 import "./chunk-EZG76F7R.js";
-import "./chunk-UDL46O35.js";
-import "./chunk-OKNSR7MT.js";
-import "./chunk-QONOJO45.js";
+import "./chunk-OWGCOGKK.js";
+import "./chunk-DIA7CT7J.js";
+import "./chunk-QK7ZQJLP.js";
 import "./chunk-WHOJWOSV.js";
+import "./chunk-VAF6A3YD.js";
 import "./chunk-5XZ744TS.js";
-import "./chunk-7JDT4PBU.js";
+import "./chunk-OHX6MIUZ.js";
 export {
   compileBundle,
   exportBundleJson,

package/dist/codegen-command-FUT2KJB6.js

@@ -0,0 +1,49 @@
+import {
+  blameGeneratedFile,
+  fetchWorkspaceBundle,
+  isMissingDependencyError,
+  runInitFromCommand,
+  verifyCrashEntry
+} from "./chunk-HYBN4H3F.js";
+import "./chunk-ZQ2PKR6R.js";
+import "./chunk-K5IOND4K.js";
+import "./chunk-QKM4U5UK.js";
+import "./chunk-FE5I6S6N.js";
+import "./chunk-7ZYW652H.js";
+import "./chunk-ZUTSMMAG.js";
+import "./chunk-X4DVXBFY.js";
+import "./chunk-3IGNIP6R.js";
+import "./chunk-4IF54NU5.js";
+import "./chunk-KA6G2L7U.js";
+import "./chunk-ZSYZTGJH.js";
+import "./chunk-G4EJMQLD.js";
+import "./chunk-LU7TRWMC.js";
+import "./chunk-YBC3IKMF.js";
+import "./chunk-ANUDXFEX.js";
+import "./chunk-Q77KNEUL.js";
+import "./chunk-BSK7ELHU.js";
+import "./chunk-UOZMSF4C.js";
+import "./chunk-EHP3WPEG.js";
+import "./chunk-3INK4Y4E.js";
+import "./chunk-BC2C5GVI.js";
+import "./chunk-RCT7UX7B.js";
+import "./chunk-CTD5ZCV6.js";
+import "./chunk-XEOX6AM7.js";
+import "./chunk-F6CYJ7TN.js";
+import "./chunk-GNPVYOPB.js";
+import "./chunk-EZG76F7R.js";
+import "./chunk-OWGCOGKK.js";
+import "./chunk-DIA7CT7J.js";
+import "./chunk-QK7ZQJLP.js";
+import "./chunk-WHOJWOSV.js";
+import "./chunk-VAF6A3YD.js";
+import "./chunk-5XZ744TS.js";
+import "./chunk-OHX6MIUZ.js";
+export {
+  blameGeneratedFile,
+  fetchWorkspaceBundle,
+  isMissingDependencyError,
+  runInitFromCommand,
+  verifyCrashEntry
+};
+//# sourceMappingURL=codegen-command-FUT2KJB6.js.map

package/dist/codegen.d.ts

@@ -1,4 +1,5 @@
-import { a1 as Statement, a8 as Tag, w as FilterXdo, a9 as TaggedValue, p as FieldDescriptor, Z as ResponseDef } from './response-CVAE2kMj.js';
+import { S as Statement, f as FieldDescriptor, w as ResponseDef } from './response-BQVQ24l1.js';
+import { n as Tag, h as FilterXdo, o as TaggedValue } from './xdo-BjJj5W_E.js';
 
 /** A stored statement envelope as it appears in a Xano bundle's `run[]`. */
 type RawEnvelope = Record<string, unknown>;

package/dist/{completion-A6BZ3XGU.js → completion-WF46272M.js}

@@ -6,7 +6,7 @@ import {
   liveCommandNames,
   liveSubcommandNames,
   visibleFlags
-} from "./chunk-OKNSR7MT.js";
+} from "./chunk-DIA7CT7J.js";
 
 // src/emit/completion.ts
 var COMPLETION_SHELLS = ["bash", "zsh", "fish"];
@@ -296,4 +296,4 @@ export {
   renderCompletion,
   runCompletionCommand
 };
-//# sourceMappingURL=completion-A6BZ3XGU.js.map
+//# sourceMappingURL=completion-WF46272M.js.map

package/dist/{config-NL33PN4D.js → config-476F3PT5.js}

@@ -81,4 +81,4 @@ export {
   resolveValidateConfig,
   verifyToken
 };
-//# sourceMappingURL=config-NL33PN4D.js.map
+//# sourceMappingURL=config-476F3PT5.js.map