@xanots/sdk 0.0.9 → 0.0.10

package/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "xanots",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "TypeScript SDK that compiles a typed Xano workspace into the importable packageExport JSON bundle.",
   "coverage": {
     "objectKinds": {
@@ -8558,65 +8558,6 @@
     }
   ],
   "cli": [
-    {
-      "command": "codegen",
-      "args": "<bundle.json> <path>",
-      "flags": [
-        {
-          "flag": "--name <n>",
-          "description": "Project name (default: the target directory's basename)"
-        },
-        {
-          "flag": "--framework <id>",
-          "description": "Frontend framework to scaffold: react (default), svelte"
-        },
-        {
-          "flag": "--theme <id>",
-          "description": "shadcn/ui theme — <base> or <base>-<accent> (e.g. zinc-blue), a registry theme URL, or a registry item JSON path; an unknown id lists every base and accent"
-        },
-        {
-          "flag": "--radius <len>",
-          "description": "Corner radius for the scaffold's theme — a number of rem (0, 0.5, 1) or a CSS length"
-        },
-        {
-          "flag": "--dark <mode>",
-          "description": "What switches the app into its dark palette: system (default, follows the OS), toggle (adds a control), off"
-        },
-        {
-          "flag": "--font <id>",
-          "description": "Body typeface, self-hosted from its @fontsource package (default: the system stack)"
-        },
-        {
-          "flag": "--font-mono <id>",
-          "description": "Code typeface (default: the system mono stack)"
-        },
-        {
-          "flag": "--font-heading <id>",
-          "description": "Heading typeface, bound to h1–h6 (default: inherits the body face)"
-        },
-        {
-          "flag": "--icons <id>",
-          "description": "Icon set: lucide (default), tabler, phosphor"
-        },
-        {
-          "flag": "--ai <preset>",
-          "description": "AI instruction files to scaffold: claude, codex, cursor, none"
-        },
-        {
-          "flag": "--force",
-          "description": "Scaffold into a non-empty directory (overwriting our own files)"
-        },
-        {
-          "flag": "--no-install",
-          "description": "Skip the post-scaffold npm install"
-        },
-        {
-          "flag": "--no-verify",
-          "description": "Skip the offline round-trip check that the written tree re-exports (no network, no deploy)"
-        }
-      ],
-      "description": "A bundle JSON file → a runnable XanoTS project (offline)"
-    },
     {
       "command": "compile",
       "args": "<file>",
@@ -8641,10 +8582,6 @@
       "command": "deploy",
       "args": "<file>",
       "flags": [
-        {
-          "flag": "--dest <ephemeral|sandbox>",
-          "description": "Which environment to import into (default: ephemeral)"
-        },
         {
           "flag": "--expires-hours <n>",
           "description": "Ephemeral TTL at create time, 1–72 (default: 1)"
@@ -8678,8 +8615,8 @@
           "description": "Publish the static build even if it contains non-public seed values"
         },
         {
-          "flag": "--no-verify",
-          "description": "Skip the post-deploy liveness checks (static host, microservices); on the codegen commands it skips the offline round-trip check instead"
+          "flag": "--skip-liveness",
+          "description": "Do not wait to confirm the deploy came up (static host, microservices)"
         },
         {
           "flag": "--require-microservices",
@@ -8722,82 +8659,7 @@
           "description": "Use the project-local ./.xano/auth.json instead of the shared cache"
         }
       ],
-      "description": "Ship to a live ephemeral env (or --dest sandbox) → URL"
-    },
-    {
-      "command": "ephemeral codegen",
-      "args": "<name> <path>",
-      "flags": [
-        {
-          "flag": "--name <n>",
-          "description": "Project name (default: the target directory's basename)"
-        },
-        {
-          "flag": "--framework <id>",
-          "description": "Frontend framework to scaffold: react (default), svelte"
-        },
-        {
-          "flag": "--theme <id>",
-          "description": "shadcn/ui theme — <base> or <base>-<accent> (e.g. zinc-blue), a registry theme URL, or a registry item JSON path; an unknown id lists every base and accent"
-        },
-        {
-          "flag": "--radius <len>",
-          "description": "Corner radius for the scaffold's theme — a number of rem (0, 0.5, 1) or a CSS length"
-        },
-        {
-          "flag": "--dark <mode>",
-          "description": "What switches the app into its dark palette: system (default, follows the OS), toggle (adds a control), off"
-        },
-        {
-          "flag": "--font <id>",
-          "description": "Body typeface, self-hosted from its @fontsource package (default: the system stack)"
-        },
-        {
-          "flag": "--font-mono <id>",
-          "description": "Code typeface (default: the system mono stack)"
-        },
-        {
-          "flag": "--font-heading <id>",
-          "description": "Heading typeface, bound to h1–h6 (default: inherits the body face)"
-        },
-        {
-          "flag": "--icons <id>",
-          "description": "Icon set: lucide (default), tabler, phosphor"
-        },
-        {
-          "flag": "--ai <preset>",
-          "description": "AI instruction files to scaffold: claude, codex, cursor, none"
-        },
-        {
-          "flag": "--force",
-          "description": "Scaffold into a non-empty directory (overwriting our own files)"
-        },
-        {
-          "flag": "--no-install",
-          "description": "Skip the post-scaffold npm install"
-        },
-        {
-          "flag": "--no-verify",
-          "description": "Skip the offline round-trip check that the written tree re-exports (no network, no deploy)"
-        },
-        {
-          "flag": "--report <grouped|full|json>",
-          "description": "Findings as grouped root causes (default), every site, or JSON"
-        },
-        {
-          "flag": "--origin <origin>",
-          "description": "Xano control-plane OAuth host (default: $XANO_ORIGIN)"
-        },
-        {
-          "flag": "--config <path>",
-          "description": "Explicit credential file (default: $XANO_CONFIG)"
-        },
-        {
-          "flag": "--local",
-          "description": "Use the project-local ./.xano/auth.json instead of the shared cache"
-        }
-      ],
-      "description": "Decode an env into a runnable XanoTS project"
+      "description": "Ship to a live ephemeral env → URL"
     },
     {
       "command": "ephemeral delete",
@@ -8807,10 +8669,6 @@
           "flag": "--yes, -y",
           "description": "Confirm a destructive action non-interactively"
         },
-        {
-          "flag": "--force",
-          "description": "Skip the destroy-this-env confirmation (same as --yes)"
-        },
         {
           "flag": "--origin <origin>",
           "description": "Xano control-plane OAuth host (default: $XANO_ORIGIN)"
@@ -8999,7 +8857,7 @@
         },
         {
           "flag": "--force",
-          "description": "Scaffold into a non-empty directory (overwriting our own files)"
+          "description": "Overwrite our own files in a non-empty target directory"
         },
         {
           "flag": "--no-install",
@@ -9008,12 +8866,40 @@
         {
           "flag": "--marketplace <pkgs>",
           "description": "Add-on packages to install and register, comma-separated"
+        },
+        {
+          "flag": "--from <source>",
+          "description": "Fill xano/ by decoding an existing backend instead of writing the empty starter: workspace, ephemeral:<name>, or a path to a bundle .json"
+        },
+        {
+          "flag": "--web",
+          "description": "Collect the scaffold options in a browser instead of on the command line"
+        },
+        {
+          "flag": "--skip-roundtrip",
+          "description": "Do not check that the written tree re-exports as it was pulled (offline; no network, no deploy)"
+        },
+        {
+          "flag": "--report <grouped|full|json>",
+          "description": "Findings as grouped root causes (default), every site, or JSON"
+        },
+        {
+          "flag": "--origin <origin>",
+          "description": "Xano control-plane OAuth host (default: $XANO_ORIGIN)"
+        },
+        {
+          "flag": "--config <path>",
+          "description": "Explicit credential file (default: $XANO_CONFIG)"
+        },
+        {
+          "flag": "--local",
+          "description": "Use the project-local ./.xano/auth.json instead of the shared cache"
         }
       ],
-      "description": "Scaffold a new XanoTS project"
+      "description": "Scaffold a XanoTS project — empty, or filled from an existing backend"
     },
     {
-      "command": "lock adopt",
+      "command": "lock import",
       "args": "<bundle.json>",
       "flags": [
         {
@@ -9029,7 +8915,7 @@
           "description": "Workspace entry to resolve xano.lock beside (for lock subcommands that take no entry file)"
         }
       ],
-      "description": "Seed the lock from a live engine packageExport"
+      "description": "Import identities from a live engine packageExport, so existing objects are not recreated"
     },
     {
       "command": "lock prune",
@@ -9048,8 +8934,8 @@
           "description": "Workspace entry to resolve xano.lock beside (for lock subcommands that take no entry file)"
         },
         {
-          "flag": "--no-verify",
-          "description": "Prune the named keys without evaluating the entry file (identity only)"
+          "flag": "--identity-only",
+          "description": "Prune the named keys without loading the entry file"
         }
       ],
       "description": "Drop orphaned entries (all, or just the named keys)"
@@ -9098,7 +8984,7 @@
         },
         {
           "flag": "--force",
-          "description": "Sign in again even when a credential is already cached"
+          "description": "Overwrite the cached credential — sign in again even when one is already there"
         }
       ],
       "description": "OAuth sign-in — shared cache, or --local per project"
@@ -9146,11 +9032,6 @@
       "args": "<string>",
       "description": "Search add-ons by keyword across name, tagline and description"
     },
-    {
-      "command": "onboard",
-      "args": "[dir]",
-      "description": "Pick a framework, theme and add-ons in a browser, then scaffold"
-    },
     {
       "command": "paths",
       "args": "<file>",
@@ -9168,7 +9049,50 @@
           "description": "Promote every export warning (data-losing shapes, unresolvable filters) to a hard failure"
         }
       ],
-      "description": "List each query's verb + resolved api:<canonical>/<name>"
+      "description": "Alias for `routes` (alias of `routes`)"
+    },
+    {
+      "command": "preflight",
+      "args": "<file>",
+      "flags": [
+        {
+          "flag": "--bundle <path>",
+          "description": "Use an already-exported bundle instead of an entry file"
+        },
+        {
+          "flag": "--runtime",
+          "description": "After the round-trip, run each deployed function and report"
+        },
+        {
+          "flag": "--capture",
+          "description": "Write each round-tripped function's fetched JSON"
+        },
+        {
+          "flag": "--verbose",
+          "description": "Print full diffs and raw engine detail"
+        },
+        {
+          "flag": "--instance <url>",
+          "description": "Override XANO_VALIDATE_INSTANCE for this run"
+        },
+        {
+          "flag": "--out, -o <path>",
+          "description": "Write the artifact to this path instead of stdout"
+        },
+        {
+          "flag": "--lock[=<path>]",
+          "description": "Use (and create) xano.lock — default: beside the entry file"
+        },
+        {
+          "flag": "--frozen-lock",
+          "description": "CI guard: fail instead of changing the lock"
+        },
+        {
+          "flag": "--strict",
+          "description": "Promote every export warning (data-losing shapes, unresolvable filters) to a hard failure"
+        }
+      ],
+      "description": "Deploy to a throwaway tenant and verify the round-trip (needs auth)"
     },
     {
       "command": "profile me",
@@ -9220,10 +9144,6 @@
           "flag": "--yes, -y",
           "description": "Confirm a destructive action non-interactively"
         },
-        {
-          "flag": "--force",
-          "description": "Skip the confirmation prompt (same as --yes)"
-        },
         {
           "flag": "--static <dir>",
           "description": "Archive this built frontend and deploy it to the static host"
@@ -9245,8 +9165,8 @@
           "description": "Publish the static build even if it contains non-public seed values"
         },
         {
-          "flag": "--no-verify",
-          "description": "Skip the post-deploy liveness checks (static host, microservices); on the codegen commands it skips the offline round-trip check instead"
+          "flag": "--skip-liveness",
+          "description": "Do not wait to confirm the deploy came up (static host, microservices)"
         },
         {
           "flag": "--lock[=<path>]",
@@ -9292,132 +9212,11 @@
           "description": "Promote every export warning (data-losing shapes, unresolvable filters) to a hard failure"
         }
       ],
-      "description": "Alias for `paths` (alias of `paths`)"
-    },
-    {
-      "command": "sandbox codegen",
-      "args": "<path>",
-      "flags": [
-        {
-          "flag": "--name <n>",
-          "description": "Project name (default: the target directory's basename)"
-        },
-        {
-          "flag": "--framework <id>",
-          "description": "Frontend framework to scaffold: react (default), svelte"
-        },
-        {
-          "flag": "--theme <id>",
-          "description": "shadcn/ui theme — <base> or <base>-<accent> (e.g. zinc-blue), a registry theme URL, or a registry item JSON path; an unknown id lists every base and accent"
-        },
-        {
-          "flag": "--radius <len>",
-          "description": "Corner radius for the scaffold's theme — a number of rem (0, 0.5, 1) or a CSS length"
-        },
-        {
-          "flag": "--dark <mode>",
-          "description": "What switches the app into its dark palette: system (default, follows the OS), toggle (adds a control), off"
-        },
-        {
-          "flag": "--font <id>",
-          "description": "Body typeface, self-hosted from its @fontsource package (default: the system stack)"
-        },
-        {
-          "flag": "--font-mono <id>",
-          "description": "Code typeface (default: the system mono stack)"
-        },
-        {
-          "flag": "--font-heading <id>",
-          "description": "Heading typeface, bound to h1–h6 (default: inherits the body face)"
-        },
-        {
-          "flag": "--icons <id>",
-          "description": "Icon set: lucide (default), tabler, phosphor"
-        },
-        {
-          "flag": "--ai <preset>",
-          "description": "AI instruction files to scaffold: claude, codex, cursor, none"
-        },
-        {
-          "flag": "--force",
-          "description": "Scaffold into a non-empty directory (overwriting our own files)"
-        },
-        {
-          "flag": "--no-install",
-          "description": "Skip the post-scaffold npm install"
-        },
-        {
-          "flag": "--no-verify",
-          "description": "Skip the offline round-trip check that the written tree re-exports (no network, no deploy)"
-        },
-        {
-          "flag": "--report <grouped|full|json>",
-          "description": "Findings as grouped root causes (default), every site, or JSON"
-        },
-        {
-          "flag": "--origin <origin>",
-          "description": "Xano control-plane OAuth host (default: $XANO_ORIGIN)"
-        },
-        {
-          "flag": "--config <path>",
-          "description": "Explicit credential file (default: $XANO_CONFIG)"
-        },
-        {
-          "flag": "--local",
-          "description": "Use the project-local ./.xano/auth.json instead of the shared cache"
-        }
-      ],
-      "description": "Decode the sandbox into a runnable XanoTS project"
-    },
-    {
-      "command": "sandbox details",
-      "flags": [
-        {
-          "flag": "--origin <origin>",
-          "description": "Xano control-plane OAuth host (default: $XANO_ORIGIN)"
-        },
-        {
-          "flag": "--config <path>",
-          "description": "Explicit credential file (default: $XANO_CONFIG)"
-        },
-        {
-          "flag": "--local",
-          "description": "Use the project-local ./.xano/auth.json instead of the shared cache"
-        }
-      ],
-      "description": "Print the sandbox tenant, headlined by its URL"
+      "description": "List each query's verb + resolved api:<canonical>/<name>"
     },
     {
-      "command": "sandbox export",
+      "command": "status",
       "flags": [
-        {
-          "flag": "--format <json|multidoc>",
-          "description": "Which artifact to emit"
-        },
-        {
-          "flag": "--path <p>",
-          "description": "Output location — `-` for stdout, a dir, or a file path"
-        },
-        {
-          "flag": "--name <n>",
-          "description": "Output basename (default: `sandbox`)"
-        },
-        {
-          "flag": "--bundle <path>",
-          "description": "Use an already-exported bundle instead of an entry file"
-        },
-        {
-          "flag": "--lock[=<path>]",
-          "description": "Use (and create) xano.lock — default: beside the entry file"
-        },
-        {
-          "flag": "--frozen-lock",
-          "description": "CI guard: fail instead of changing the lock"
-        },
-        {
-          "flag": "--strict",
-          "description": "Promote every export warning (data-losing shapes, unresolvable filters) to a hard failure"
-        },
         {
           "flag": "--origin <origin>",
           "description": "Xano control-plane OAuth host (default: $XANO_ORIGIN)"
@@ -9431,18 +9230,14 @@
           "description": "Use the project-local ./.xano/auth.json instead of the shared cache"
         }
       ],
-      "description": "Write the sandbox workspace as JSON or multidoc XanoScript"
+      "description": "Who am I, which workspace, and the env this project last deployed to"
     },
     {
       "command": "test list",
       "flags": [
         {
-          "flag": "--dest <ephemeral|sandbox>",
-          "description": "Which environment to read (default: ephemeral)"
-        },
-        {
-          "flag": "--name <n>",
-          "description": "Ephemeral env to target (default: the one this project last deployed to)"
+          "flag": "--env <target>",
+          "description": "Which environment to read: workspace, ephemeral (the one this project last deployed to), or ephemeral:<name>"
         },
         {
           "flag": "--kind <unit|workflow>",
@@ -9468,12 +9263,8 @@
       "args": "<name>",
       "flags": [
         {
-          "flag": "--dest <ephemeral|sandbox>",
-          "description": "Which environment to read (default: ephemeral)"
-        },
-        {
-          "flag": "--name <n>",
-          "description": "Ephemeral env to target (default: the one this project last deployed to)"
+          "flag": "--env <target>",
+          "description": "Which environment to read: workspace, ephemeral (the one this project last deployed to), or ephemeral:<name>"
         },
         {
           "flag": "--origin <origin>",
@@ -9494,12 +9285,8 @@
       "command": "test run-all",
       "flags": [
         {
-          "flag": "--dest <ephemeral|sandbox>",
-          "description": "Which environment to read (default: ephemeral)"
-        },
-        {
-          "flag": "--name <n>",
-          "description": "Ephemeral env to target (default: the one this project last deployed to)"
+          "flag": "--env <target>",
+          "description": "Which environment to read: workspace, ephemeral (the one this project last deployed to), or ephemeral:<name>"
         },
         {
           "flag": "--kind <unit|workflow>",
@@ -9534,49 +9321,6 @@
       ],
       "description": "Install the latest @xanots/sdk, or report an available upgrade with --check"
     },
-    {
-      "command": "validate",
-      "args": "<file>",
-      "flags": [
-        {
-          "flag": "--bundle <path>",
-          "description": "Use an already-exported bundle instead of an entry file"
-        },
-        {
-          "flag": "--runtime",
-          "description": "After the round-trip, run each deployed function and report"
-        },
-        {
-          "flag": "--capture",
-          "description": "Write each round-tripped function's fetched JSON"
-        },
-        {
-          "flag": "--verbose",
-          "description": "Print full diffs and raw engine detail"
-        },
-        {
-          "flag": "--instance <url>",
-          "description": "Override XANO_VALIDATE_INSTANCE for this run"
-        },
-        {
-          "flag": "--out, -o <path>",
-          "description": "Write the artifact to this path instead of stdout"
-        },
-        {
-          "flag": "--lock[=<path>]",
-          "description": "Use (and create) xano.lock — default: beside the entry file"
-        },
-        {
-          "flag": "--frozen-lock",
-          "description": "CI guard: fail instead of changing the lock"
-        },
-        {
-          "flag": "--strict",
-          "description": "Promote every export warning (data-losing shapes, unresolvable filters) to a hard failure"
-        }
-      ],
-      "description": "Deploy to a throwaway tenant and verify the round-trip"
-    },
     {
       "command": "version",
       "description": "Print the CLI version"
@@ -9597,82 +9341,7 @@
           "description": "Use the project-local ./.xano/auth.json instead of the shared cache"
         }
       ],
-      "description": "Alias for `profile me` (alias of `profile me`)"
-    },
-    {
-      "command": "workspace codegen",
-      "args": "<path>",
-      "flags": [
-        {
-          "flag": "--name <n>",
-          "description": "Project name (default: the target directory's basename)"
-        },
-        {
-          "flag": "--framework <id>",
-          "description": "Frontend framework to scaffold: react (default), svelte"
-        },
-        {
-          "flag": "--theme <id>",
-          "description": "shadcn/ui theme — <base> or <base>-<accent> (e.g. zinc-blue), a registry theme URL, or a registry item JSON path; an unknown id lists every base and accent"
-        },
-        {
-          "flag": "--radius <len>",
-          "description": "Corner radius for the scaffold's theme — a number of rem (0, 0.5, 1) or a CSS length"
-        },
-        {
-          "flag": "--dark <mode>",
-          "description": "What switches the app into its dark palette: system (default, follows the OS), toggle (adds a control), off"
-        },
-        {
-          "flag": "--font <id>",
-          "description": "Body typeface, self-hosted from its @fontsource package (default: the system stack)"
-        },
-        {
-          "flag": "--font-mono <id>",
-          "description": "Code typeface (default: the system mono stack)"
-        },
-        {
-          "flag": "--font-heading <id>",
-          "description": "Heading typeface, bound to h1–h6 (default: inherits the body face)"
-        },
-        {
-          "flag": "--icons <id>",
-          "description": "Icon set: lucide (default), tabler, phosphor"
-        },
-        {
-          "flag": "--ai <preset>",
-          "description": "AI instruction files to scaffold: claude, codex, cursor, none"
-        },
-        {
-          "flag": "--force",
-          "description": "Scaffold into a non-empty directory (overwriting our own files)"
-        },
-        {
-          "flag": "--no-install",
-          "description": "Skip the post-scaffold npm install"
-        },
-        {
-          "flag": "--no-verify",
-          "description": "Skip the offline round-trip check that the written tree re-exports (no network, no deploy)"
-        },
-        {
-          "flag": "--report <grouped|full|json>",
-          "description": "Findings as grouped root causes (default), every site, or JSON"
-        },
-        {
-          "flag": "--origin <origin>",
-          "description": "Xano control-plane OAuth host (default: $XANO_ORIGIN)"
-        },
-        {
-          "flag": "--config <path>",
-          "description": "Explicit credential file (default: $XANO_CONFIG)"
-        },
-        {
-          "flag": "--local",
-          "description": "Use the project-local ./.xano/auth.json instead of the shared cache"
-        }
-      ],
-      "description": "Decode it into a runnable XanoTS project"
+      "description": "Show the signed-in user and instance URL"
     },
     {
       "command": "workspace details",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xanots/sdk",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "XanoTS — your Xano backend as TypeScript. `xanots deploy` ships your typed workspace (and an optional static frontend) to a live, auto-expiring ephemeral environment and prints its URL. init → deploy → URL.",
   "keywords": [
     "xanots",