@xanots/sdk 0.0.8 → 0.0.10

package/dist/{chunk-EM5QPTXP.js → chunk-I7DQDJAM.js}

@@ -15,27 +15,30 @@ import {
   normalize,
   retiredInputSuccessor,
   retiredInputs
-} from "./chunk-ZOYMZZ3S.js";
+} from "./chunk-3INK4Y4E.js";
+import {
+  resolveEphemeralName
+} from "./chunk-ZQ2PKR6R.js";
 import {
   getAccessToken
-} from "./chunk-3QW5NFZJ.js";
+} from "./chunk-QKM4U5UK.js";
 import {
   exportWorkspaceBundle
-} from "./chunk-QTNO2WD6.js";
+} from "./chunk-7ZYW652H.js";
 import {
   projectShellFiles,
   resolveFrontendPreset,
   resolveThemeChoice,
   sanitizeAppName
-} from "./chunk-C3M5K4ZH.js";
+} from "./chunk-YYFXVYPX.js";
 import {
   XANO_DIR,
   resolveAiPresets,
   scaffoldProject
-} from "./chunk-4PE4ZAB7.js";
+} from "./chunk-KA6G2L7U.js";
 import {
   TEST_EXPECT_TYPES
-} from "./chunk-2ROR3AZC.js";
+} from "./chunk-75Z74TA7.js";
 import {
   raw
 } from "./chunk-LU7TRWMC.js";
@@ -44,7 +47,7 @@ import {
   describeOrigin,
   renderCodegenMarker,
   renderCodegenReadme
-} from "./chunk-P5C2YKAM.js";
+} from "./chunk-ANUDXFEX.js";
 import {
   FIELD_METHODS,
   STATEMENT_SURFACES,
@@ -67,14 +70,14 @@ import {
   searchConstrainsRows,
   tableTrigger,
   workspaceTrigger
-} from "./chunk-3MDKV2VA.js";
+} from "./chunk-P6TAVLOX.js";
 import {
   loadDefault,
   readVersion
-} from "./chunk-SNO3KHCY.js";
+} from "./chunk-ACCBOMCB.js";
 import {
   UsageError
-} from "./chunk-JQLR64UC.js";
+} from "./chunk-F6CYJ7TN.js";
 import {
   blank,
   detail,
@@ -115,7 +118,7 @@ import {
   sys,
   toolset,
   withFilters
-} from "./chunk-64QK6JEK.js";
+} from "./chunk-LBYWGMOA.js";
 import {
   parsePathParams,
   unboundPathParams
@@ -6748,24 +6751,10 @@ function reportMismatches(report, result) {
 
 // src/emit/codegen-command.ts
 async function fetchBundle(args, source) {
-  if (source.kind === "sandbox") {
-    const auth3 = await getAccessToken(args);
-    step("Reading the sandbox workspace");
-    const { fetchSandboxBundle } = await import("./sandbox-export-command-MO6DEZ7Z.js");
-    return {
-      bundle: await fetchSandboxBundle(auth3),
-      origin: { source: "sandbox", origin: auth3.instance }
-    };
-  }
   if (source.kind === "ephemeral") {
-    const name = args.positionals[0];
-    if (name === void 0 || name === "") {
-      throw new Error(
-        "`xanots ephemeral codegen` needs a tenant name and an output path: `xanots ephemeral codegen <tenant> <path>`. Run `xanots ephemeral list` to see them."
-      );
-    }
     const auth3 = await getAccessToken(args);
-    const { resolveLive, fetchEphemeralBundle } = await import("./ephemeral-command-DL7EY4LL.js");
+    const name = resolveEphemeralName(auth3, source.name);
+    const { resolveLive, fetchEphemeralBundle } = await import("./ephemeral-command-U4AQ3TXX.js");
     const summary = await resolveLive(auth3, auth3.workspaceId, name);
     step(`Reading ephemeral "${name}"`);
     return {
@@ -6853,19 +6842,12 @@ function isMissingDependencyError(err) {
   }
   return false;
 }
-async function runCodegenCommand(args, source) {
-  const outArg = source.kind === "ephemeral" ? args.positionals[1] : args.positionals[0];
-  const fileArg = source.kind === "file" ? args.positionals[0] : void 0;
-  const pathArg = source.kind === "file" ? args.positionals[1] : outArg;
-  if (source.kind === "file" && (fileArg === void 0 || fileArg === "")) {
-    throw new Error("`xanots codegen` needs a bundle file: `xanots codegen <bundle.json> <path>`.");
-  }
-  if (pathArg === void 0 || pathArg === "") {
-    throw new Error(
-      source.kind === "ephemeral" ? "`xanots ephemeral codegen` needs an output path: `xanots ephemeral codegen <tenant> <path>`." : `\`xanots ${source.kind === "file" ? "codegen <bundle.json>" : `${source.kind} codegen`}\` needs an output path.`
-    );
-  }
-  const { bundle, origin } = source.kind === "file" ? { bundle: readBundleFile(fileArg), origin: { source: "file", origin: fileArg } } : await fetchBundle(args, source);
+async function runInitFromCommand(args, source) {
+  const pathArg = args.positionals[0] ?? ".";
+  const { bundle, origin } = source.kind === "file" ? {
+    bundle: readBundleFile(source.path),
+    origin: { source: "file", origin: source.path }
+  } : await fetchBundle(args, source);
   const mode = reportMode(args.report);
   const out2 = resolve(pathArg);
   const appName = sanitizeAppName(args.name ?? basename(out2));
@@ -6904,7 +6886,7 @@ async function runCodegenCommand(args, source) {
     theme: choice
   });
   let verified = null;
-  if (!args.noVerify) {
+  if (!args.skipRoundtrip) {
     step("Verifying the generated tree round-trips");
     try {
       const result = verifyBundles(bundle, await reexport(out2));
@@ -6950,7 +6932,7 @@ function reportMode(value) {
   if (value === "full" || value === "json") return value;
   throw new UsageError(
     `--report takes grouped, full or json, not "${value}". grouped (the default) collapses repeated findings to one line per root cause, full prints every site, and json prints the findings as data.`,
-    { helpFor: { command: "workspace", subcommand: "codegen" } }
+    { helpFor: { command: "init" } }
   );
 }
 var EXIT_VERIFY_FAILED = 2;
@@ -6977,7 +6959,7 @@ function blameGeneratedFile(err, out2) {
   return void 0;
 }
 function unverifiedReason(install) {
-  const fix = `run \`npm install\` in the project and re-run codegen to check the round trip`;
+  const fix = `run \`npm install\` in the project and re-run \`init --from\` to check the round trip`;
   return install === "skipped" ? `Could not verify the round trip: dependencies are not installed (--no-install) \u2014 ${fix}.` : `Could not verify the round trip: \`npm install\` did not complete, so the tree could not be loaded \u2014 ${fix}.`;
 }
 function countBySection(payload) {
@@ -7004,7 +6986,7 @@ function summarize(args, project, bundle, verified, out2, origin, install, mode)
 `);
   }
   if (verified === null) {
-    if (args.noVerify) warn("Skipped round-trip verification (--no-verify) \u2014 the tree is unchecked.");
+    if (args.skipRoundtrip) warn("Skipped the round-trip check (--skip-roundtrip) \u2014 the tree is unchecked.");
   } else if (verified) {
     success(
       omitted > 0 ? `Verified: re-exporting ${out2} reproduces the source bundle, apart from ${omitted} deliberately omitted value${omitted === 1 ? "" : "s"} listed above` : `Verified: re-exporting ${out2} reproduces the source bundle`
@@ -7014,7 +6996,7 @@ function summarize(args, project, bundle, verified, out2, origin, install, mode)
   }
   blank();
   success("Project ready.");
-  const cdHint = out2 === process.cwd() ? "" : `  cd ${args.positionals.at(-1)}
+  const cdHint = out2 === process.cwd() ? "" : `  cd ${args.positionals[0] ?? "."}
 `;
   detail(
     `Next steps:
@@ -7023,15 +7005,15 @@ function summarize(args, project, bundle, verified, out2, origin, install, mode)
   npm run xano:deploy    # build the frontend, then deploy \u2192 live ephemeral URL`
   );
   detail(
-    `${s2.bold(`${XANO_DIR}/`)} is disposable and schema-only \u2014 re-running codegen rewrites it. Deploying is a FULL REPLACE, so send it only to an ephemeral or sandbox environment.`
+    `${s2.bold(`${XANO_DIR}/`)} is disposable and schema-only \u2014 re-running \`init --from\` rewrites it. Deploying is a FULL REPLACE, so send it only to an ephemeral environment.`
   );
 }
 
 export {
   fetchWorkspaceBundle,
   isMissingDependencyError,
-  runCodegenCommand,
+  runInitFromCommand,
   verifyCrashEntry,
   blameGeneratedFile
 };
-//# sourceMappingURL=chunk-EM5QPTXP.js.map
+//# sourceMappingURL=chunk-I7DQDJAM.js.map

package/dist/{chunk-QIWBCS7N.js → chunk-JGCWTCA7.js}

@@ -5,7 +5,7 @@ import {
   presetFilePath,
   renderPreset,
   upsertManagedBlock
-} from "./chunk-4PE4ZAB7.js";
+} from "./chunk-KA6G2L7U.js";
 import {
   warn
 } from "./chunk-EZG76F7R.js";
@@ -92,4 +92,4 @@ export {
   isCI,
   refreshAgentFiles
 };
-//# sourceMappingURL=chunk-QIWBCS7N.js.map
+//# sourceMappingURL=chunk-JGCWTCA7.js.map

package/dist/{chunk-MDXR5E5Q.js → chunk-K5IOND4K.js}

@@ -1,6 +1,6 @@
 import {
   ensureGitignored
-} from "./chunk-BKDJN76G.js";
+} from "./chunk-FE5I6S6N.js";
 import {
   atomicWrite
 } from "./chunk-GNPVYOPB.js";
@@ -57,4 +57,4 @@ export {
   setEnvironment,
   clearEnvironment
 };
-//# sourceMappingURL=chunk-MDXR5E5Q.js.map
+//# sourceMappingURL=chunk-K5IOND4K.js.map

package/dist/{chunk-4PE4ZAB7.js → chunk-KA6G2L7U.js}

@@ -46,7 +46,7 @@ canonical slug. It is written by \`npm run xano:export\`/\`xano:deploy\` and is
 
 To rename an object: rename it in code, run \`npm run xano:export\` (stderr prints
 the fix-up), run \`npx xanots lock rename <kind> <old> <new> --lock=xano/xano.lock\`,
-then export again. \`lock rename\`/\`lock adopt\` need that flag from the project root \u2014
+then export again. \`lock rename\`/\`lock import\` need that flag from the project root \u2014
 they take no entry file, so they look for the lock in the current directory, while
 \`lock prune <entry-file>\` (like \`export\`) derives it from the entry.
 \`npm run xano:check\` fails if an export would change the lock \u2014 run it before
@@ -150,13 +150,13 @@ function generatedGuidanceBody(frontend) {
 
 This is a [XanoTS](https://www.npmjs.com/package/@xanots/sdk) project whose
 Xano backend under \`xano/\` was **pulled from a live workspace** and written as
-TypeScript by \`xanots \u2026 codegen\`. The ${frontend.label} frontend under \`frontend/\`
+TypeScript by \`xanots init --from\`. The ${frontend.label} frontend under \`frontend/\`
 is a starter. XanoTS is Xano's official TypeScript SDK \u2014 the supported way to
 drive a Xano workspace from code.
 
 ### Two rules before you edit anything
 
-- **\`xano/\` is machine-written and disposable.** Re-running \`xanots \u2026 codegen\`
+- **\`xano/\` is machine-written and disposable.** Re-running \`xanots init --from\`
   on this project rewrites that directory wholesale \u2014 no merge, no diff, no
   preservation of hand edits. Work you want to keep goes outside \`xano/\`, or
   gets re-applied after each pull. Everything else in the project is yours.
@@ -173,7 +173,7 @@ ${LEARN_FROM_THE_LIBRARY}
 
 \`frontend/src/lib/api.ts\` derives request paths (\`getPath()\`) and request/response
 types (\`InferInput\` / \`InferResponse\`) from the query defs in \`xano/\`. Never
-hand-type a URL or a request body. \`npx xanots paths xano/index.ts\` lists every
+hand-type a URL or a request body. \`npx xanots routes xano/index.ts\` lists every
 endpoint's verb and resolved path.
 
 ### Layout
@@ -442,4 +442,4 @@ export {
   resolveAiPresets,
   scaffoldProject
 };
-//# sourceMappingURL=chunk-4PE4ZAB7.js.map
+//# sourceMappingURL=chunk-KA6G2L7U.js.map

package/dist/{chunk-64QK6JEK.js → chunk-LBYWGMOA.js}

@@ -3690,12 +3690,37 @@ function phpEncodeString(str) {
       case "	":
         out2 += "\\t";
         break;
+      // PHP escapes the two line terminators even under JSON_UNESCAPED_UNICODE
+      // — that flag is not JSON_UNESCAPED_LINE_TERMINATORS, which the engine
+      // does not pass.
+      case "\u2028":
+        out2 += "\\u2028";
+        break;
+      case "\u2029":
+        out2 += "\\u2029";
+        break;
       default:
         out2 += code < 32 ? "\\u" + code.toString(16).padStart(4, "0") : ch;
     }
   }
   return out2 + '"';
 }
+var PHP_INT_MAX = 9223372036854775807n;
+function phpEncodeNumber(value) {
+  if (!Number.isFinite(value)) return "0";
+  const text = JSON.stringify(value);
+  if (!/[.eE]/.test(text)) {
+    const n = BigInt(text);
+    return n > PHP_INT_MAX || n < -PHP_INT_MAX - 1n ? `"${text}"` : text;
+  }
+  const [mantissaText, exponentText] = Math.abs(value).toExponential().split("e");
+  const exponent = Number(exponentText);
+  if (exponent >= -4 && exponent < 17) return text;
+  const digits = mantissaText.replace(".", "").replace(/0+$/, "") || "0";
+  const mantissa = digits.length > 1 ? `${digits[0]}.${digits.slice(1)}` : `${digits}.0`;
+  const sign = exponent < 0 ? "-" : "+";
+  return `${value < 0 ? "-" : ""}${mantissa}e${sign}${Math.abs(exponent)}`;
+}
 function phpJsonEncode(value) {
   const out2 = [];
   const stack = [{ value }];
@@ -3715,7 +3740,7 @@ function phpJsonEncode(value) {
         out2.push(phpEncodeString(current));
         continue;
       case "number":
-        out2.push(Number.isFinite(current) ? JSON.stringify(current) : "0");
+        out2.push(phpEncodeNumber(current));
         continue;
       case "boolean":
         out2.push(current ? "true" : "false");
@@ -3737,6 +3762,15 @@ function phpJsonEncode(value) {
     }
     const obj2 = current;
     const keys = Object.keys(obj2).filter((key) => obj2[key] !== void 0);
+    if (keys.length > 0 && keys.every((key, i) => key === String(i))) {
+      stack.push({ lit: "]" });
+      for (let i = keys.length - 1; i >= 0; i--) {
+        stack.push({ value: obj2[keys[i]] });
+        if (i > 0) stack.push({ lit: "," });
+      }
+      stack.push({ lit: "[" });
+      continue;
+    }
     stack.push({ lit: "}" });
     for (let i = keys.length - 1; i >= 0; i--) {
       const key = keys[i];
@@ -4083,4 +4117,4 @@ export {
   serializeBundle,
   emitBundle
 };
-//# sourceMappingURL=chunk-64QK6JEK.js.map
+//# sourceMappingURL=chunk-LBYWGMOA.js.map

package/dist/{chunk-3MDKV2VA.js → chunk-P6TAVLOX.js}

@@ -35,7 +35,7 @@ import {
   registerKind,
   tableColumns,
   withFilters
-} from "./chunk-64QK6JEK.js";
+} from "./chunk-LBYWGMOA.js";
 import {
   assertPathParamInputs,
   fillPathParams,
@@ -3734,4 +3734,4 @@ export {
   workspaceKind,
   workspaceConfig
 };
-//# sourceMappingURL=chunk-3MDKV2VA.js.map
+//# sourceMappingURL=chunk-P6TAVLOX.js.map

package/dist/{chunk-3QW5NFZJ.js → chunk-QKM4U5UK.js}

@@ -14,7 +14,7 @@ import {
   resolveOAuthErrorCode,
   resolveScope,
   writeCredential
-} from "./chunk-BKDJN76G.js";
+} from "./chunk-FE5I6S6N.js";
 import {
   detail,
   hostLabel,
@@ -161,7 +161,7 @@ The refresh token may be expired or already spent \u2014 refresh tokens rotate o
       );
     }
     assertHttpsOrigin(instance2, "instance");
-    const { resolveScopedWorkspaceId } = await import("./workspace-K72NP7SX.js");
+    const { resolveScopedWorkspaceId } = await import("./workspace-2COHDBM3.js");
     const workspaceId = await resolveScopedWorkspaceId({ access_token: set.access_token, instance: instance2 });
     return { access_token: set.access_token, instance: instance2, workspaceId, credentialType: "oauth" };
   }
@@ -272,4 +272,4 @@ export {
   envMetaCredentialVarsSet,
   getAccessToken
 };
-//# sourceMappingURL=chunk-3QW5NFZJ.js.map
+//# sourceMappingURL=chunk-QKM4U5UK.js.map

package/dist/{chunk-T4XPCJRF.js → chunk-TCFIPDB3.js}

@@ -64,4 +64,4 @@ export {
   indexByIdentity,
   resolveMatch
 };
-//# sourceMappingURL=chunk-T4XPCJRF.js.map
+//# sourceMappingURL=chunk-TCFIPDB3.js.map

package/dist/{chunk-FEQTQ6PM.js → chunk-VKSOTZK3.js}

@@ -12,7 +12,7 @@ import {
   middlewareEntryGuid,
   stackReferencesAuth,
   tableColumns
-} from "./chunk-64QK6JEK.js";
+} from "./chunk-LBYWGMOA.js";
 import {
   CANONICAL_PAYLOAD_KEYS,
   REFERENCEABLE_KINDS,
@@ -1706,4 +1706,4 @@ export {
   Xano,
   workspace
 };
-//# sourceMappingURL=chunk-FEQTQ6PM.js.map
+//# sourceMappingURL=chunk-VKSOTZK3.js.map

package/dist/{chunk-6DHBYBTO.js → chunk-VNQM3V2C.js}

@@ -152,7 +152,6 @@ async function waitUntilReady(auth, opts, cfg = {}) {
 }
 
 export {
-  tenantBaseUrl,
   isExpired,
   isEphemeralDisabled,
   createEphemeral,
@@ -163,4 +162,4 @@ export {
   impersonateEphemeral,
   waitUntilReady
 };
-//# sourceMappingURL=chunk-6DHBYBTO.js.map
+//# sourceMappingURL=chunk-VNQM3V2C.js.map

package/dist/{chunk-PYS7UNNW.js → chunk-W24FJHPD.js}

@@ -1,9 +1,9 @@
 import {
   compileBundle
-} from "./chunk-SNO3KHCY.js";
+} from "./chunk-ACCBOMCB.js";
 import {
   missingArgument
-} from "./chunk-JQLR64UC.js";
+} from "./chunk-F6CYJ7TN.js";
 
 // src/emit/bundle-input.ts
 import { existsSync, readFileSync } from "fs";
@@ -34,4 +34,4 @@ export {
   assertBundleInput,
   loadBundleText
 };
-//# sourceMappingURL=chunk-PYS7UNNW.js.map
+//# sourceMappingURL=chunk-W24FJHPD.js.map

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-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-C3M5K4ZH.js → chunk-YYFXVYPX.js}

@@ -2,7 +2,7 @@ import {
   presetFilePath,
   resolveAiPresets,
   scaffoldProject
-} from "./chunk-4PE4ZAB7.js";
+} from "./chunk-KA6G2L7U.js";
 import {
   runNpmCapturingStderr
 } from "./chunk-ZSYZTGJH.js";
@@ -11,7 +11,7 @@ import {
   allFrontendPresets,
   findFrontendPreset,
   resolveFrameworkFlag
-} from "./chunk-MU3O43L2.js";
+} from "./chunk-YBC3IKMF.js";
 import {
   initLanding,
   renderApiTs,
@@ -27,7 +27,7 @@ import {
   renderViteConfig,
   renderXanoExampleMd,
   renderXanoIndex
-} from "./chunk-P5C2YKAM.js";
+} from "./chunk-ANUDXFEX.js";
 import {
   DEFAULT_DARK_MODE,
   defaultThemeChoice,
@@ -41,10 +41,14 @@ import {
 } from "./chunk-Q77KNEUL.js";
 import {
   readVersion
-} from "./chunk-SNO3KHCY.js";
+} from "./chunk-ACCBOMCB.js";
+import {
+  ENV_SPELLINGS,
+  parseEnvSelector
+} from "./chunk-CTD5ZCV6.js";
 import {
   UsageError
-} from "./chunk-JQLR64UC.js";
+} from "./chunk-F6CYJ7TN.js";
 import {
   blank,
   detail,
@@ -393,7 +397,33 @@ function buildFileSet(vars, preset, choice) {
     { path: "xano/EXAMPLE.md", content: renderXanoExampleMd(vars) }
   ];
 }
+function resolveFromSource(raw) {
+  const env = parseEnvSelector(raw);
+  if (env !== void 0) return env;
+  if (/\.json$/i.test(raw) || /[\\/]/.test(raw)) return { kind: "file", path: raw };
+  throw new UsageError(
+    `--from does not take "${raw}". Sources are ${ENV_SPELLINGS}, or a path to a bundle .json (\`xanots ephemeral list\` shows the environment names; bare \`ephemeral\` is the one this project last deployed to).`,
+    { helpFor: { command: "init" } }
+  );
+}
+function rejectPullOnlyFlags(args) {
+  const passed = [
+    ...args.report !== void 0 ? ["--report"] : [],
+    ...args.skipRoundtrip ? ["--skip-roundtrip"] : []
+  ];
+  if (passed.length === 0) return;
+  throw new UsageError(
+    `${passed.join(" and ")} ${passed.length === 1 ? "describes" : "describe"} the pull that \`--from\` performs, so ${passed.length === 1 ? "it does" : "they do"} nothing without it. Add \`--from <source>\`, or drop ${passed.length === 1 ? "the flag" : "them"}.`,
+    { helpFor: { command: "init" } }
+  );
+}
 async function runInitCommand(args) {
+  if (args.from !== void 0) {
+    const source = resolveFromSource(args.from);
+    const { runInitFromCommand } = await import("./codegen-command-GB3H2KQ7.js");
+    return runInitFromCommand(args, source);
+  }
+  rejectPullOnlyFlags(args);
   const targetArg = args.positionals[0] ?? ".";
   const targetDir = resolve(targetArg);
   const appName = sanitizeAppName(args.name ?? basename(targetDir));
@@ -468,6 +498,7 @@ export {
   resolveThemeChoice,
   sanitizeAppName,
   projectShellFiles,
+  resolveFromSource,
   runInitCommand
 };
-//# sourceMappingURL=chunk-C3M5K4ZH.js.map
+//# sourceMappingURL=chunk-YYFXVYPX.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