@cimplify/cli 0.7.20 → 0.7.22

package/dist/dispatcher.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { TEMPLATES } from './chunk-CIZ7IWO4.mjs';
-import { package_default } from './chunk-HAGBHLXW.mjs';
+import { package_default } from './chunk-AYVOCJTK.mjs';
+import { TEMPLATES } from './chunk-YUXVTC3O.mjs';
 
 // src/dispatcher.ts
 var VERSION = package_default.version ?? "unknown";
@@ -33,6 +33,8 @@ Deploy:
   cimplify status                            Show the latest deployment for the linked project
   cimplify logs [flags]                      Stream build logs for the latest (or given) deployment
   cimplify dev [--remote]                    Run your project's dev script (optionally with prod env)
+  cimplify mock [flags]                      Boot the local Cimplify API mock (custom seeds welcome)
+  cimplify mock init [--from <seed>]         Scaffold a cimplify.seed.ts (or --format json) to customise
 
 Env vars:
   cimplify env ls [--scope=<s>]              List env vars (default scope: preview)
@@ -120,8 +122,11 @@ Logs flags:
   --deployment <id>        Override which deployment to read (default: latest)
   --follow                 Poll until the deployment terminates
 
-Need the mock storefront server? It ships with @cimplify/sdk:
-  bunx @cimplify/sdk mock [flags]            Boot the local Cimplify API mock
+Local mock server (custom demo data, no fork needed):
+  cimplify mock [flags]                      Boot the mock (auto-loads ./cimplify.seed.{ts,json})
+  cimplify mock init --from retail           Scaffold an editable seed to start from a built-in
+  cimplify mock --seed-file demo.json        Boot from a JSON snapshot (--dump one to create it)
+  cimplify mock --seed-module ./seed.ts      Boot from a seed module (defineSeed from @cimplify/sdk/mock)
 `;
 var COMMANDS = {
   login: () => import('./login-3OD4ND2H.mjs'),
@@ -138,16 +143,17 @@ var COMMANDS = {
   logs: () => import('./logs-YNN2PQ24.mjs'),
   status: () => import('./status-JSYXM5RT.mjs'),
   dev: () => import('./dev-ONW2S77K.mjs'),
-  introspect: () => import('./introspect-RCSMCNVR.mjs'),
+  mock: () => import('./mock-TSUKCLWU.mjs'),
+  introspect: () => import('./introspect-DX2OYRTY.mjs'),
   inspect: () => import('./inspect-CGYX4DDF.mjs'),
-  doctor: () => import('./doctor-RBXE5QGS.mjs'),
-  explain: () => import('./explain-HR2GEMAB.mjs'),
+  doctor: () => import('./doctor-3UN3HWZK.mjs'),
+  explain: () => import('./explain-57MQ3RJ5.mjs'),
   assets: () => import('./assets-74SK63TR.mjs'),
   repo: () => import('./repo-KNQMSPVV.mjs'),
-  list: () => import('./list-N5GWOJLE.mjs'),
-  add: () => import('./add-OSD4553G.mjs'),
-  update: () => import('./update-JBR2UM4Y.mjs'),
-  upgrade: () => import('./update-JBR2UM4Y.mjs'),
+  list: () => import('./list-LKO7J47M.mjs'),
+  add: () => import('./add-BNQSUAKS.mjs'),
+  update: () => import('./update-TY6HIDIQ.mjs'),
+  upgrade: () => import('./update-TY6HIDIQ.mjs'),
   "auth-step-up": () => import('./auth-step-up-BIUYQJP6.mjs')
 };
 var COMMAND_PREFIXES = {

package/dist/{doctor-RBXE5QGS.mjs → doctor-3UN3HWZK.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { gatherIntrospection } from './chunk-UXS75OSQ.mjs';
+import { gatherIntrospection } from './chunk-TC6KEJ3V.mjs';
 import './chunk-K5464A3L.mjs';
 import './chunk-DBZ3UOQ2.mjs';
-import './chunk-HAGBHLXW.mjs';
+import './chunk-AYVOCJTK.mjs';
 import { parseArgs, flagBool } from './chunk-C4M3DXKC.mjs';
 import { ApiClient } from './chunk-MAOO6ZZ5.mjs';
 import { readAuthOrNull } from './chunk-UBAI443T.mjs';

package/dist/{explain-HR2GEMAB.mjs → explain-57MQ3RJ5.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { package_default } from './chunk-HAGBHLXW.mjs';
+import { package_default } from './chunk-AYVOCJTK.mjs';
 import { parseArgs } from './chunk-C4M3DXKC.mjs';
 import { bold, dim, info, result, CliError, CLI_ERROR_CODE } from './chunk-E2T2SBP5.mjs';
 
@@ -178,7 +178,7 @@ var TOPICS = [
     "title": "seeds",
     "description": "Available mock seeds and how to switch between them",
     "source_url": "https://cimplify.dev/docs/cli/mock",
-    "body": '## Mock seeds\n\nEvery Cimplify storefront ships with a local Hono mock backed by one of\nthese seeds. Switch with `cimplify mock seed <name>` (or hand-edit the\n`--seed` flag in your `package.json` `scripts.dev`).\n\n| Seed | Notes |\n| --- | --- |\n| `auto` | (no description) |\n| `default` | Generic small business \u2014 minimal fixtures |\n| `empty` | No data \u2014 for blank-slate testing |\n| `fashion` | Apparel with multi-axis variants (size, color) |\n| `grocery` | High-SKU produce + perishables |\n| `pharmacy` | Wellspring Apothecary \u2014 health products with regulated metadata |\n| `reesa-storefront` | Reesa-specific demo storefront |\n| `restaurant` | Menu-driven with reservations |\n| `retail` | Electronics-focused storefront with variants and add-ons |\n| `services` | Bookable services (e.g. salon, spa) |\n\n### Finding fixture IDs\n\nEach seed is a TypeScript file at `packages/sdk/src/mock/seeds/<name>.ts`\nin the cimplify monorepo. Product slugs, categories, and variant axes\nare defined inline. Grep that file when you need a real slug for a\nhard-coded demo:\n\n```bash\ngrep "slug:" node_modules/@cimplify/sdk/dist/mock/seeds/<name>.* | head\n```\n\nA future `cimplify mock products ls --json` will surface these IDs\ndirectly without grep.\n'
+    "body": '## Mock seeds\n\nEvery Cimplify storefront ships with a local Hono mock backed by one of\nthese seeds. Switch with `cimplify mock seed <name>` (or hand-edit the\n`--seed` flag in your `package.json` `scripts.dev`).\n\n| Seed | Notes |\n| --- | --- |\n| `auto` | (no description) |\n| `context` | (no description) |\n| `default` | Generic small business \u2014 minimal fixtures |\n| `empty` | No data \u2014 for blank-slate testing |\n| `fashion` | Apparel with multi-axis variants (size, color) |\n| `grocery` | High-SKU produce + perishables |\n| `pharmacy` | Wellspring Apothecary \u2014 health products with regulated metadata |\n| `reesa-storefront` | Reesa-specific demo storefront |\n| `restaurant` | Menu-driven with reservations |\n| `retail` | Electronics-focused storefront with variants and add-ons |\n| `services` | Bookable services (e.g. salon, spa) |\n| `source` | (no description) |\n\n### Finding fixture IDs\n\nEach seed is a TypeScript file at `packages/sdk/src/mock/seeds/<name>.ts`\nin the cimplify monorepo. Product slugs, categories, and variant axes\nare defined inline. Grep that file when you need a real slug for a\nhard-coded demo:\n\n```bash\ngrep "slug:" node_modules/@cimplify/sdk/dist/mock/seeds/<name>.* | head\n```\n\nA future `cimplify mock products ls --json` will surface these IDs\ndirectly without grep.\n'
   }
 ];
 var TOPICS_BY_NAME = Object.fromEntries(

package/dist/{introspect-RCSMCNVR.mjs → introspect-DX2OYRTY.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-export { run as default, extractMockSeed, gatherIntrospection, renderIntrospection } from './chunk-UXS75OSQ.mjs';
+export { run as default, extractMockSeed, gatherIntrospection, renderIntrospection } from './chunk-TC6KEJ3V.mjs';
 import './chunk-K5464A3L.mjs';
 import './chunk-DBZ3UOQ2.mjs';
-import './chunk-HAGBHLXW.mjs';
+import './chunk-AYVOCJTK.mjs';
 import './chunk-C4M3DXKC.mjs';
 import './chunk-UBAI443T.mjs';
 import './chunk-E2T2SBP5.mjs';

package/dist/{list-N5GWOJLE.mjs → list-LKO7J47M.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { REGISTRY_INDEX } from './chunk-CIZ7IWO4.mjs';
+import { REGISTRY_INDEX } from './chunk-YUXVTC3O.mjs';
 import { parseArgs, flagBool } from './chunk-C4M3DXKC.mjs';
 import { CliError, CLI_ERROR_CODE, info, bold, dim, green, result } from './chunk-E2T2SBP5.mjs';
 

package/dist/mock-TSUKCLWU.mjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { parseArgs, flagString, flagBool } from './chunk-C4M3DXKC.mjs';
+import { CliError, CLI_ERROR_CODE, info, dim } from './chunk-E2T2SBP5.mjs';
+import { spawn } from 'child_process';
+import { existsSync, writeFileSync } from 'fs';
+import path from 'path';
+
+var MOCK_BIN = "cimplify-mock";
+var SDK_PACKAGE = "@cimplify/sdk";
+var SEED_FILE_TS = "cimplify.seed.ts";
+var SEED_FILE_JSON = "cimplify.seed.json";
+var DEFAULT_FROM = "default";
+function findLocalMockBin(start) {
+  let dir = start;
+  for (; ; ) {
+    const candidate = path.join(dir, "node_modules", ".bin", MOCK_BIN);
+    if (existsSync(candidate)) return candidate;
+    const parent = path.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function spawnMock(args) {
+  const local = findLocalMockBin(process.cwd());
+  const cmd = local ?? "npx";
+  const cmdArgs = local ? args : ["-y", "-p", SDK_PACKAGE, MOCK_BIN, ...args];
+  return new Promise((resolve, reject) => {
+    const child = spawn(cmd, cmdArgs, { cwd: process.cwd(), stdio: "inherit" });
+    child.on(
+      "error",
+      (err) => reject(
+        new CliError(CLI_ERROR_CODE.INVALID_INPUT, `Failed to start the mock server: ${err.message}`, {
+          remediation: local ? void 0 : `Install the SDK first: \`bun add ${SDK_PACKAGE}\``
+        })
+      )
+    );
+    child.on("close", (code) => {
+      process.exitCode = code ?? 0;
+      resolve();
+    });
+  });
+}
+function seedTemplate(from) {
+  return `import { defineSeed } from "${SDK_PACKAGE}/mock";
+
+/**
+ * Local mock seed. The mock server picks this file up automatically
+ * (run \`cimplify mock\`), or point at it with \`--seed-module\`.
+ */
+export default defineSeed((ctx) => {
+  // Start from a built-in seed, then customise from there.
+  const { businessId } = ctx.extend("${from}");
+
+  // Or start from scratch instead of extending:
+  // const biz = ctx.business({ name: "Akua's Bakery", handle: "akua", default_currency: "GHS" });
+  // const breads = ctx.category({ name: "Breads" });
+  // ctx.product({ name: "Sourdough", price: "25.00", category: breads,
+  //               image: ctx.image("bakery", "sourdough-loaf") });
+  // return { businessId: biz.id };
+
+  return { businessId };
+});
+`;
+}
+async function runInit(rest) {
+  const args = parseArgs(rest);
+  const from = flagString(args, "from") ?? DEFAULT_FROM;
+  const format = flagString(args, "format") ?? "ts";
+  const force = flagBool(args, "force");
+  const cwd = process.cwd();
+  if (format !== "ts" && format !== "json") {
+    throw new CliError(CLI_ERROR_CODE.INVALID_INPUT, `--format must be "ts" or "json" (got "${format}").`);
+  }
+  const target = format === "json" ? SEED_FILE_JSON : SEED_FILE_TS;
+  if (existsSync(path.join(cwd, target)) && !force) {
+    throw new CliError(CLI_ERROR_CODE.INVALID_INPUT, `${target} already exists. Pass --force to overwrite.`);
+  }
+  if (format === "json") {
+    await spawnMock(["--seed", from, "--dump", target]);
+    info(`Wrote ${target} from the "${from}" seed.`);
+    info(dim(`Edit it, then run:  cimplify mock --seed-file ${target}`));
+    return;
+  }
+  writeFileSync(path.join(cwd, target), seedTemplate(from), "utf8");
+  info(`Wrote ${target} (extends the "${from}" seed).`);
+  info(dim("Edit it, then run:  cimplify mock"));
+}
+async function run(argv) {
+  const [sub, ...rest] = argv;
+  if (sub === "init") {
+    return runInit(rest);
+  }
+  return spawnMock(argv);
+}
+
+export { run as default };

package/dist/{update-JBR2UM4Y.mjs → update-TY6HIDIQ.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { package_default } from './chunk-HAGBHLXW.mjs';
+import { package_default } from './chunk-AYVOCJTK.mjs';
 import { promptYesNo } from './chunk-ITAFAORS.mjs';
 import { parseArgs, flagBool, flagString } from './chunk-C4M3DXKC.mjs';
 import { success, bold, info, dim, result, failure, CliError, CLI_ERROR_CODE, step, isJsonMode } from './chunk-E2T2SBP5.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cimplify/cli",
-  "version": "0.7.20",
+  "version": "0.7.22",
   "description": "Cimplify CLI — deploy, manage env vars, link projects, and scaffold storefronts",
   "keywords": [
     "cimplify",
@@ -45,6 +45,6 @@
     "vitest": "^4.1.5"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.79.0"
+    "@cimplify/sdk": "^0.83.0"
   }
 }

package/templates/storefront-auto/components/providers.tsx

@@ -1,6 +1,7 @@
 "use client";
 
 import { useMemo, type ReactNode } from "react";
+import Link from "next/link";
 import { createCimplifyClient, type Business, type Location } from "@cimplify/sdk";
 import { CimplifyProvider, CartDrawerProvider } from "@cimplify/sdk/react";
 import { AuthErrorToast } from "@/components/auth-error-toast";
@@ -34,6 +35,7 @@ export function Providers({
       client={client}
       initialBusiness={initialBusiness}
       initialLocations={initialLocations}
+      linkComponent={Link}
     >
       <CartDrawerProvider>
         {children}

package/templates/storefront-auto/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.79.0",
+    "@cimplify/sdk": "^0.83.0",
     "next": "^16.2.6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-bakery/components/providers.tsx

@@ -1,6 +1,7 @@
 "use client";
 
 import { useMemo, type ReactNode } from "react";
+import Link from "next/link";
 import { createCimplifyClient, type Business, type Location } from "@cimplify/sdk";
 import { CimplifyProvider, CartDrawerProvider } from "@cimplify/sdk/react";
 import { AuthErrorToast } from "@/components/auth-error-toast";
@@ -34,6 +35,7 @@ export function Providers({
       client={client}
       initialBusiness={initialBusiness}
       initialLocations={initialLocations}
+      linkComponent={Link}
     >
       <CartDrawerProvider>
         {children}

package/templates/storefront-bakery/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.79.0",
+    "@cimplify/sdk": "^0.83.0",
     "next": "^16.2.6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-fashion/components/providers.tsx

@@ -1,6 +1,7 @@
 "use client";
 
 import { useMemo, type ReactNode } from "react";
+import Link from "next/link";
 import { createCimplifyClient, type Business, type Location } from "@cimplify/sdk";
 import { CimplifyProvider, CartDrawerProvider } from "@cimplify/sdk/react";
 import { AuthErrorToast } from "@/components/auth-error-toast";
@@ -34,6 +35,7 @@ export function Providers({
       client={client}
       initialBusiness={initialBusiness}
       initialLocations={initialLocations}
+      linkComponent={Link}
     >
       <CartDrawerProvider>
         {children}

package/templates/storefront-fashion/package.json

@@ -19,7 +19,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.79.0",
+    "@cimplify/sdk": "^0.83.0",
     "next": "^16.2.6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-grocery/components/providers.tsx

@@ -1,6 +1,7 @@
 "use client";
 
 import { useMemo, type ReactNode } from "react";
+import Link from "next/link";
 import { createCimplifyClient, type Business, type Location } from "@cimplify/sdk";
 import { CimplifyProvider, CartDrawerProvider } from "@cimplify/sdk/react";
 import { AuthErrorToast } from "@/components/auth-error-toast";
@@ -34,6 +35,7 @@ export function Providers({
       client={client}
       initialBusiness={initialBusiness}
       initialLocations={initialLocations}
+      linkComponent={Link}
     >
       <CartDrawerProvider>
         {children}

package/templates/storefront-grocery/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.79.0",
+    "@cimplify/sdk": "^0.83.0",
     "next": "^16.2.6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-pharmacy/components/providers.tsx

@@ -1,6 +1,7 @@
 "use client";
 
 import { useMemo, type ReactNode } from "react";
+import Link from "next/link";
 import { createCimplifyClient, type Business, type Location } from "@cimplify/sdk";
 import { CimplifyProvider, CartDrawerProvider } from "@cimplify/sdk/react";
 import { AuthErrorToast } from "@/components/auth-error-toast";
@@ -34,6 +35,7 @@ export function Providers({
       client={client}
       initialBusiness={initialBusiness}
       initialLocations={initialLocations}
+      linkComponent={Link}
     >
       <CartDrawerProvider>
         {children}

package/templates/storefront-pharmacy/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.79.0",
+    "@cimplify/sdk": "^0.83.0",
     "next": "^16.2.6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-restaurant/components/providers.tsx

@@ -1,6 +1,7 @@
 "use client";
 
 import { useMemo, type ReactNode } from "react";
+import Link from "next/link";
 import { createCimplifyClient, type Business, type Location } from "@cimplify/sdk";
 import { CimplifyProvider, CartDrawerProvider } from "@cimplify/sdk/react";
 import { AuthErrorToast } from "@/components/auth-error-toast";
@@ -34,6 +35,7 @@ export function Providers({
       client={client}
       initialBusiness={initialBusiness}
       initialLocations={initialLocations}
+      linkComponent={Link}
     >
       <CartDrawerProvider>
         {children}

package/templates/storefront-restaurant/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.79.0",
+    "@cimplify/sdk": "^0.83.0",
     "next": "^16.2.6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-retail/components/providers.tsx

@@ -1,6 +1,7 @@
 "use client";
 
 import { useMemo, type ReactNode } from "react";
+import Link from "next/link";
 import { createCimplifyClient, type Business, type Location } from "@cimplify/sdk";
 import { CimplifyProvider, CartDrawerProvider } from "@cimplify/sdk/react";
 import { AuthErrorToast } from "@/components/auth-error-toast";
@@ -34,6 +35,7 @@ export function Providers({
       client={client}
       initialBusiness={initialBusiness}
       initialLocations={initialLocations}
+      linkComponent={Link}
     >
       <CartDrawerProvider>
         {children}

package/templates/storefront-retail/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.79.0",
+    "@cimplify/sdk": "^0.83.0",
     "next": "^16.2.6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-services/components/providers.tsx

@@ -1,6 +1,7 @@
 "use client";
 
 import { useMemo, type ReactNode } from "react";
+import Link from "next/link";
 import { createCimplifyClient, type Business, type Location } from "@cimplify/sdk";
 import { CimplifyProvider, CartDrawerProvider } from "@cimplify/sdk/react";
 import { AuthErrorToast } from "@/components/auth-error-toast";
@@ -34,6 +35,7 @@ export function Providers({
       client={client}
       initialBusiness={initialBusiness}
       initialLocations={initialLocations}
+      linkComponent={Link}
     >
       <CartDrawerProvider>
         {children}

package/templates/storefront-services/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.79.0",
+    "@cimplify/sdk": "^0.83.0",
     "next": "^16.2.6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"