@cimplify/cli 0.13.5 → 0.15.0

package/dist/{deploy-SLRFPGTH.mjs → deploy-JE6TUYCL.mjs}

@@ -1,23 +1,94 @@
 #!/usr/bin/env node
-import { isFreestyleRemote, gitDetectRoot, gitStatusPorcelain, gitCurrentBranch, gitCurrentSha, gitGetRemoteUrl, gitPushToUrl, gitPush } from './chunk-MLVBE5V2.mjs';
-import { pollDeployment } from './chunk-PDGKBATF.mjs';
-import { fetchRepoRecord, fetchCloneToken } from './chunk-OE7YRDLH.mjs';
-import { promptYesNo } from './chunk-5ZQURRIM.mjs';
+import { detectPackageManager } from './chunk-F2UI225N.mjs';
+import { fetchRepoRecord, fetchCloneToken } from './chunk-A6WHBSXZ.mjs';
+import { pollDeployment } from './chunk-NK6VC264.mjs';
+import './chunk-I2UP7YTG.mjs';
+import { promptYesNo } from './chunk-TH4XENKH.mjs';
 import { REPO_PROVIDER, ENV_SCOPE, DEPLOY_TRIGGER, DEPLOYMENT_STATUS, TOKEN_PURPOSE } from './chunk-MXYUAJEW.mjs';
+import { isFreestyleRemote, gitDetectRoot, gitStatusPorcelain, gitCurrentBranch, gitCurrentSha, gitGetRemoteUrl, gitPushToUrl, gitPush } from './chunk-KN2YSKXZ.mjs';
 import { parseArgs, flagBool, flagString } from './chunk-5KYR6WJB.mjs';
-import { ApiClient } from './chunk-TOQGLBWF.mjs';
-import { readAuth, readProjectLink, writeProjectState } from './chunk-6CHBU7O4.mjs';
-import { CliError, CLI_ERROR_CODE, info, dim, step, success, result, EXIT_CODE } from './chunk-4O4G2CDE.mjs';
+import { ApiClient } from './chunk-NYXA6X56.mjs';
+import { readAuth, readProjectLink, writeProjectState } from './chunk-MLE4MVYC.mjs';
+import { info, dim, step, CliError, CLI_ERROR_CODE, success, result, EXIT_CODE } from './chunk-3QUK5BPY.mjs';
+import { spawn } from 'child_process';
+import { promises } from 'fs';
+import path from 'path';
 
-// src/commands/deploy.ts
 var FLAG_PROD = "prod";
 var FLAG_REF = "ref";
 var FLAG_NO_PUSH = "no-push";
 var FLAG_ALLOW_DIRTY = "allow-dirty";
 var FLAG_NO_POLL = "no-poll";
+var FLAG_SKIP_ENV_CHECK = "skip-env-check";
+var FLAG_SKIP_BUILD = "skip-build";
+var SCRIPT_BUILD = "build";
+var NODE_MODULES_DIR = "node_modules";
+var PACKAGE_JSON_FILE = "package.json";
 function deployEndpoint(businessId, projectId) {
   return `/v1/businesses/${encodeURIComponent(businessId)}/projects/${encodeURIComponent(projectId)}/deploy`;
 }
+function envEndpoint(businessId, projectId) {
+  return `/v1/businesses/${encodeURIComponent(businessId)}/projects/${encodeURIComponent(projectId)}/env-vars`;
+}
+function missingProductionKeys(preview, production) {
+  const productionKeys = new Set(production.map((record) => record.key));
+  return [...new Set(preview.map((record) => record.key))].filter((key) => !productionKeys.has(key)).sort();
+}
+async function runLocalBuildCheck(cwd) {
+  let pkg;
+  try {
+    pkg = JSON.parse(await promises.readFile(path.join(cwd, PACKAGE_JSON_FILE), "utf8"));
+  } catch {
+    return "skipped_no_package";
+  }
+  if (!pkg.scripts?.[SCRIPT_BUILD]) {
+    return "skipped_no_script";
+  }
+  try {
+    await promises.stat(path.join(cwd, NODE_MODULES_DIR));
+  } catch {
+    info(dim("Dependencies not installed locally \u2014 skipping the local build check."));
+    return "skipped_no_modules";
+  }
+  const pm = await detectPackageManager(cwd);
+  step(`Building locally first (${pm} run ${SCRIPT_BUILD}) to catch failures before the cloud`);
+  const code = await new Promise((resolve, reject) => {
+    const child = spawn(pm, ["run", SCRIPT_BUILD], { cwd, stdio: "inherit" });
+    child.on("error", reject);
+    child.on("close", (exit) => resolve(exit ?? 1));
+  });
+  if (code !== 0) {
+    throw new CliError(
+      CLI_ERROR_CODE.BUILD_FAILED,
+      `Local build failed (exit ${code}), so the deploy was not started.
+Fix the build errors above, or deploy anyway with --${FLAG_SKIP_BUILD} if your machine is the problem.`
+    );
+  }
+  success("Local build passed");
+  return "passed";
+}
+async function checkProductionEnv(client, businessId, projectId) {
+  const [preview, production] = await Promise.all([
+    client.get(envEndpoint(businessId, projectId), {
+      query: { scope: ENV_SCOPE.PREVIEW }
+    }),
+    client.get(envEndpoint(businessId, projectId), {
+      query: { scope: ENV_SCOPE.PRODUCTION }
+    })
+  ]);
+  const missing = missingProductionKeys(preview, production);
+  if (missing.length === 0) return;
+  const lines = missing.map(
+    (key) => `  cimplify env add ${key}=<value> --scope ${ENV_SCOPE.PRODUCTION}`
+  );
+  throw new CliError(
+    CLI_ERROR_CODE.INVALID_INPUT,
+    `Production is missing ${missing.length} env var${missing.length === 1 ? "" : "s"} that preview has: ${missing.join(", ")}.
+Set them first:
+${lines.join("\n")}
+Or deploy anyway with --${FLAG_SKIP_ENV_CHECK}.`
+  );
+}
 function resolvePushStrategy(originUrl, linkRemoteUrl, repo) {
   if (isFreestyleRemote(originUrl) || isFreestyleRemote(linkRemoteUrl)) {
     return { kind: "managed" };
@@ -88,6 +159,10 @@ async function run(argv) {
   const branch = await gitCurrentBranch(root);
   const localSha = await gitCurrentSha(root);
   const gitRef = explicitRef ?? localSha;
+  if (flagBool(args, FLAG_PROD) && !flagBool(args, FLAG_SKIP_ENV_CHECK)) {
+    await checkProductionEnv(client, link.businessId, link.projectId);
+  }
+  const buildCheck = flagBool(args, FLAG_SKIP_BUILD) ? "skipped_flag" : await runLocalBuildCheck(cwd);
   if (!flagBool(args, FLAG_NO_PUSH)) {
     await pushForDeploy(client, link.businessId, link.projectId, root, branch, link.remoteUrl);
   } else {
@@ -121,6 +196,7 @@ async function run(argv) {
   }
   if (flagBool(args, FLAG_NO_POLL)) {
     result({
+      build_check: buildCheck,
       deployment: {
         id: enqueued.deployment_id,
         git_sha: enqueued.git_sha,
@@ -138,6 +214,7 @@ async function run(argv) {
     enqueued.deployment_id
   );
   result({
+    build_check: buildCheck,
     deployment: {
       id: enqueued.deployment_id,
       git_sha: enqueued.git_sha,
@@ -158,4 +235,4 @@ async function run(argv) {
   process.exitCode = EXIT_CODE.ERROR;
 }
 
-export { run as default, resolvePushStrategy };
+export { run as default, missingProductionKeys, resolvePushStrategy, runLocalBuildCheck };

package/dist/dev-V7JSUVOI.mjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+export { run as default, detectPackageManager, mergeEnvEntries } from './chunk-F2UI225N.mjs';
+import './chunk-I2UP7YTG.mjs';
+import './chunk-MXYUAJEW.mjs';
+import './chunk-5KYR6WJB.mjs';
+import './chunk-NYXA6X56.mjs';
+import './chunk-MLE4MVYC.mjs';
+import './chunk-3QUK5BPY.mjs';

package/dist/dispatcher.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { TEMPLATES } from './chunk-BDC7XQIL.mjs';
-import { package_default } from './chunk-5YVMA7A5.mjs';
+import { TEMPLATES } from './chunk-YJDQYKZU.mjs';
+import { package_default } from './chunk-GCQKTUXN.mjs';
 
 // src/dispatcher.ts
 var VERSION = package_default.version ?? "unknown";
@@ -134,33 +134,33 @@ Local mock server (custom demo data, no fork needed):
   cimplify mock --seed-module ./seed.ts      Boot from a seed module (defineSeed from @cimplify/sdk/mock)
 `;
 var COMMANDS = {
-  login: () => import('./login-NCO4P5G5.mjs'),
-  logout: () => import('./logout-MF6SOLPE.mjs'),
-  whoami: () => import('./whoami-B5Y5KSOZ.mjs'),
-  projects: () => import('./projects-U75DOOR7.mjs'),
-  link: () => import('./link-KGNQWCSZ.mjs'),
-  unlink: () => import('./unlink-TCG3NBAR.mjs'),
-  deploy: () => import('./deploy-SLRFPGTH.mjs'),
-  cancel: () => import('./cancel-FD66LTTS.mjs'),
-  rollback: () => import('./rollback-ZL3V7SYH.mjs'),
-  env: () => import('./env-PAENNABF.mjs'),
-  domains: () => import('./domains-7D7WJAMC.mjs'),
-  logs: () => import('./logs-76TCJBIQ.mjs'),
-  status: () => import('./status-52HG63FE.mjs'),
-  dev: () => import('./dev-L3W6UXYN.mjs'),
-  mock: () => import('./mock-CAWNXSGC.mjs'),
-  introspect: () => import('./introspect-3OYRCVUF.mjs'),
-  inspect: () => import('./inspect-MGVG4Z44.mjs'),
-  doctor: () => import('./doctor-6NI2XNTD.mjs'),
-  lint: () => import('./lint-EYKIQ6RO.mjs'),
-  explain: () => import('./explain-HPRJBFHS.mjs'),
-  assets: () => import('./assets-OEY6FHHZ.mjs'),
-  repo: () => import('./repo-IE5IOLR5.mjs'),
-  list: () => import('./list-QNEUCCP5.mjs'),
-  add: () => import('./add-NZ47GUMD.mjs'),
-  update: () => import('./update-47HG7LN7.mjs'),
-  upgrade: () => import('./update-47HG7LN7.mjs'),
-  "auth-step-up": () => import('./auth-step-up-ALEUQUCE.mjs')
+  login: () => import('./login-ZTSWYO5G.mjs'),
+  logout: () => import('./logout-Z57X6HPE.mjs'),
+  whoami: () => import('./whoami-ZWTJMEDB.mjs'),
+  projects: () => import('./projects-4XRNHJAH.mjs'),
+  link: () => import('./link-4NM2QMI5.mjs'),
+  unlink: () => import('./unlink-H3BO3DOQ.mjs'),
+  deploy: () => import('./deploy-JE6TUYCL.mjs'),
+  cancel: () => import('./cancel-ZHVVILOU.mjs'),
+  rollback: () => import('./rollback-WCRWXSE3.mjs'),
+  env: () => import('./env-FZNXKLGL.mjs'),
+  domains: () => import('./domains-BZKGIDF4.mjs'),
+  logs: () => import('./logs-36BLYJHJ.mjs'),
+  status: () => import('./status-VA326DWD.mjs'),
+  dev: () => import('./dev-V7JSUVOI.mjs'),
+  mock: () => import('./mock-EVER34IX.mjs'),
+  introspect: () => import('./introspect-KTB4BXU5.mjs'),
+  inspect: () => import('./inspect-X3M7WSTL.mjs'),
+  doctor: () => import('./doctor-TTI237ZY.mjs'),
+  lint: () => import('./lint-DDZ7HUQN.mjs'),
+  explain: () => import('./explain-HVK5ZNTV.mjs'),
+  assets: () => import('./assets-CWB72PZG.mjs'),
+  repo: () => import('./repo-X3KZ5R64.mjs'),
+  list: () => import('./list-L6FMY3AF.mjs'),
+  add: () => import('./add-EPY25NNV.mjs'),
+  update: () => import('./update-XUDRJZDE.mjs'),
+  upgrade: () => import('./update-XUDRJZDE.mjs'),
+  "auth-step-up": () => import('./auth-step-up-VL742AS7.mjs')
 };
 var COMMAND_PREFIXES = {
   auth: { "step-up": "auth-step-up" }

package/dist/{doctor-6NI2XNTD.mjs → doctor-TTI237ZY.mjs}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { gatherIntrospection } from './chunk-GOTWRZVM.mjs';
-import './chunk-MLVBE5V2.mjs';
-import './chunk-RU53TQLZ.mjs';
-import './chunk-5YVMA7A5.mjs';
+import { gatherIntrospection } from './chunk-5SMYK3U2.mjs';
+import './chunk-I2UP7YTG.mjs';
+import './chunk-GCQKTUXN.mjs';
+import './chunk-KN2YSKXZ.mjs';
 import { parseArgs, flagBool } from './chunk-5KYR6WJB.mjs';
-import { SDK_ENV_API_URL, DEFAULT_API_BASE_URL, ApiClient, ENV_API_BASE_URL } from './chunk-TOQGLBWF.mjs';
-import { readAuthOrNull } from './chunk-6CHBU7O4.mjs';
-import { bold, dim, info, result, isCliError, CLI_ERROR_CODE, red, yellow, green } from './chunk-4O4G2CDE.mjs';
+import { SDK_ENV_API_URL, DEFAULT_API_BASE_URL, ApiClient, ENV_API_BASE_URL } from './chunk-NYXA6X56.mjs';
+import { readAuthOrNull } from './chunk-MLE4MVYC.mjs';
+import { bold, dim, info, result, isCliError, CLI_ERROR_CODE, red, yellow, green } from './chunk-3QUK5BPY.mjs';
 import { promises } from 'fs';
 import path from 'path';
 

package/dist/{domains-7D7WJAMC.mjs → domains-BZKGIDF4.mjs}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { promptYesNo } from './chunk-5ZQURRIM.mjs';
+import { promptYesNo } from './chunk-TH4XENKH.mjs';
 import { ENV_SCOPE, DOMAIN_TYPE } from './chunk-MXYUAJEW.mjs';
 import { parseArgs, flagBool, flagString } from './chunk-5KYR6WJB.mjs';
-import { ApiClient } from './chunk-TOQGLBWF.mjs';
-import { readAuth, readProjectLink } from './chunk-6CHBU7O4.mjs';
-import { CliError, CLI_ERROR_CODE, result, info, dim, bold, success } from './chunk-4O4G2CDE.mjs';
+import { ApiClient } from './chunk-NYXA6X56.mjs';
+import { readAuth, readProjectLink } from './chunk-MLE4MVYC.mjs';
+import { CliError, CLI_ERROR_CODE, result, info, dim, bold, success } from './chunk-3QUK5BPY.mjs';
 
 // src/commands/domains.ts
 var SUB_LS = "ls";

package/dist/{env-PAENNABF.mjs → env-FZNXKLGL.mjs}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { formatEnvFile, parseEnvFile, parseKeyValueArg } from './chunk-RU53TQLZ.mjs';
-import { promptYesNo } from './chunk-5ZQURRIM.mjs';
+import { formatEnvFile, parseEnvFile, parseKeyValueArg } from './chunk-I2UP7YTG.mjs';
+import { promptYesNo } from './chunk-TH4XENKH.mjs';
 import { ENV_SCOPE, PUBLIC_ENV_PREFIX, SECRET_MASK } from './chunk-MXYUAJEW.mjs';
 import { parseArgs, flagString, flagBool } from './chunk-5KYR6WJB.mjs';
-import { ApiClient } from './chunk-TOQGLBWF.mjs';
-import { readAuth, readProjectLink } from './chunk-6CHBU7O4.mjs';
-import { CliError, CLI_ERROR_CODE, info, dim, result, bold, success } from './chunk-4O4G2CDE.mjs';
+import { ApiClient } from './chunk-NYXA6X56.mjs';
+import { readAuth, readProjectLink } from './chunk-MLE4MVYC.mjs';
+import { CliError, CLI_ERROR_CODE, info, dim, result, bold, success } from './chunk-3QUK5BPY.mjs';
 import { promises } from 'fs';
 import path from 'path';
 

package/dist/{explain-HPRJBFHS.mjs → explain-HVK5ZNTV.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { package_default } from './chunk-5YVMA7A5.mjs';
+import { package_default } from './chunk-GCQKTUXN.mjs';
 import { parseArgs } from './chunk-5KYR6WJB.mjs';
-import { bold, dim, info, result, CliError, CLI_ERROR_CODE } from './chunk-4O4G2CDE.mjs';
+import { bold, dim, info, result, CliError, CLI_ERROR_CODE } from './chunk-3QUK5BPY.mjs';
 
 // src/embedded-docs.ts
 var TOPICS = [
@@ -129,7 +129,7 @@ var TOPICS = [
     "title": "Assets",
     "description": "Storefront brand assets \u2014 upload to CDN, build URLs, render through next/image",
     "source_url": "https://cimplify.dev/docs/sdk/assets",
-    "body": 'The asset surface on the SDK is **read-side only**: building URLs for images you\'ve already uploaded via [`cimplify assets upload`](/docs/cli/assets). Customer-runtime uploads still go through `client.uploads.upload(file)`.\n\n## `assetUrl(path, opts?)`\n\nPure URL builder. Prepends the CDN base for relative paths, passes absolute URLs through with the transform query contract appended.\n\n```ts\n\nassetUrl("hero/main.jpg")\n// "https://storefrontassetscdn.cimplify.io/hero/main.jpg"\n\nassetUrl("hero/main.jpg", { w: 1200, format: "webp", quality: 80 })\n// "https://storefrontassetscdn.cimplify.io/hero/main.jpg?w=1200&format=webp&quality=80"\n\nassetUrl("hero/main.jpg", { base: "http://localhost:8787/storage" })\n// "http://localhost:8787/storage/hero/main.jpg"\n\nassetUrl("https://res.cloudinary.com/foo/bar.jpg")\n// "https://res.cloudinary.com/foo/bar.jpg"   (absolute \u2192 passthrough)\n```\n\n### Options\n\n| Field | Type | Notes |\n| --- | --- | --- |\n| `base` | `string` | Override the CDN base. Defaults to `DEFAULT_CDN_BASE_URL`. |\n| `w` / `h` | `number` | Width / height in pixels (on-the-fly resizing) |\n| `quality` | `number` | 0\u2013100 |\n| `format` | `"auto" \\| "webp" \\| "avif" \\| "jpeg"` | `"auto"` lets the CDN pick by `Accept` header |\n\nThe transform query is only meaningful when the URL terminates on the Cimplify storefront CDN (which supports on-the-fly resizing). For external hosts, unknown params are typically ignored; the image still loads at its original size.\n\n## `isCimplifyAsset(src, base?)`\n\nDecides whether `src` is hosted on a Cimplify CDN. Used by the storefront\'s `next/image` loader to skip transforms for external URLs.\n\n```ts\n\nisCimplifyAsset("hero/main.jpg")                                      // true (relative \u2192 ours)\nisCimplifyAsset("/img/seed/bakery/x.jpg")                             // true (dev mock passthrough)\nisCimplifyAsset("https://storefrontassetscdn.cimplify.io/x.jpg")     // true\nisCimplifyAsset("https://cdn.cimplify.io/x.jpg")                     // true\nisCimplifyAsset("https://static-tmp.cimplify.io/seed/x.jpg")         // true\nisCimplifyAsset("https://res.cloudinary.com/demo/upload/x.jpg")      // false\nisCimplifyAsset("https://images.unsplash.com/photo-xyz")             // false\n```\n\n## Built-in `next/image` loader\n\nEvery storefront template scaffolded by `cimplify init` ships `lib/cimplify-loader.ts` and points `images.loaderFile` at it. The loader:\n\n```ts\n\nconst cdnBase = process.env.NEXT_PUBLIC_CIMPLIFY_CDN_URL?.trim() || undefined;\n\nconst cimplifyImageLoader: ImageLoader = ({ src, width, quality }) => {\n  if (isCimplifyAsset(src, cdnBase)) {\n    return assetUrl(src, { base: cdnBase, w: width, quality, format: "auto" });\n  }\n  return src;\n};\n\nexport default cimplifyImageLoader;\n```\n\n**Cloudinary URLs from `client.catalogue.getProducts()` flow through untouched.** Cimplify-hosted URLs get the transform query. The result: every `<Image>` works regardless of where its asset lives, and Cimplify-hosted ones get edge-optimized.\n\nTo point the loader at a different CDN (for testing, multi-CDN setups, etc.) set `NEXT_PUBLIC_CIMPLIFY_CDN_URL` in your `.env.local`:\n\n```\nNEXT_PUBLIC_CIMPLIFY_CDN_URL=http://localhost:8787/storage\n```\n\n## `useImage(path, opts?)` (React)\n\nThin hook that returns `{ src, loader }` for `<Image>`:\n\n```tsx\n\nexport function Hero() {\n  const { src, loader } = useImage("hero/main.jpg", { format: "webp", quality: 85 });\n  return <Image src={src} loader={loader} alt="..." width={1200} height={800} />;\n}\n```\n\nIf `images.loaderFile` is already set globally in your `next.config.ts`, you typically don\'t need `useImage`; just `<Image src={assetUrl("hero/main.jpg")} />` works. `useImage` is useful when you want per-component transform overrides on a project that doesn\'t use a global loader.\n\n### Options\n\n| Field | Notes |\n| --- | --- |\n| `base` | Per-call CDN base override |\n| `w`, `h` | Default transform values; per-image `width` from `<Image>` still wins |\n| `format`, `quality` | Default transform values |\n\n`useImage` is `useMemo`-stable across renders when the path + opts don\'t change.\n\n## Constants\n\n```ts\n\nDEFAULT_CDN_BASE_URL // "https://storefrontassetscdn.cimplify.io"\nCIMPLIFY_CDN_HOSTS   // readonly ["storefrontassetscdn.cimplify.io", "cdn.cimplify.io", "static-tmp.cimplify.io"]\n```\n\n## What\'s not in v1\n\n- **`useUpload` hook**: runtime customer-facing uploads with progress + cancel. Deferred to v1.1. Customer uploads today go through `client.uploads.upload(file)` (no progress, no cancel; just `await`).\n- **`SEED_IDS` typed const tree**: demo-only convenience for referencing seed-image slugs in code. Generate-from-seed-source step deferred to v1.1; today demos use `seedImage(industry, slug)` from the SDK\'s mock module.\n- **Cloudinary / S3 path-transform support**: the loader passes external hosts through unchanged; Cloudinary\'s `c_fill,w_500/` path transforms aren\'t synthesized.\n- **`assets rm` server-side delete**: CLI removes manifest entries; the remote blob stays until v1.1\'s media-manager `DELETE` wiring.\n\n## Where it lives in the platform\n\n- Wire format: `POST /v1/businesses/{id}/assets/{init,confirm}`; see the management API reference\n- Backend service: `crate::uploads::service::UploadService::init_storefront_asset`\n- Served from the Cimplify asset CDN at `storefrontassetscdn.cimplify.io`\n- Storage key: `assets/{business_id}/{folder}/{filename}`: deterministic, idempotent, agent-predictable\n\n## Related\n\n- [`cimplify assets`](/docs/cli/assets): CLI surface for upload/ls/rm\n- [Uploads (customer-runtime)](/docs/sdk/uploads): `client.uploads.upload(file)` for private 7-day-presigned uploads\n'
+    "body": 'The asset surface on the SDK is **read-side only**: building URLs for images you\'ve already uploaded via [`cimplify assets upload`](/docs/cli/assets). Customer-runtime uploads still go through `client.uploads.upload(file)`.\n\n## `assetUrl(path, opts?)`\n\nPure URL builder. Prepends the CDN base for relative paths, passes absolute URLs through with the transform query contract appended.\n\n```ts\n\nassetUrl("hero/main.jpg")\n// "https://storefrontassetscdn.cimplify.io/hero/main.jpg"\n\nassetUrl("hero/main.jpg", { w: 1200, format: "webp", quality: 80 })\n// "https://storefrontassetscdn.cimplify.io/hero/main.jpg?w=1200&format=webp&quality=80"\n\nassetUrl("hero/main.jpg", { base: "http://localhost:8787/storage" })\n// "http://localhost:8787/storage/hero/main.jpg"\n\nassetUrl("https://res.cloudinary.com/foo/bar.jpg")\n// "https://res.cloudinary.com/foo/bar.jpg"   (absolute \u2192 passthrough)\n```\n\n### Options\n\n| Field | Type | Notes |\n| --- | --- | --- |\n| `base` | `string` | Override the CDN base. Defaults to `DEFAULT_CDN_BASE_URL`. |\n| `w` / `h` | `number` | Width / height in pixels (on-the-fly resizing) |\n| `quality` | `number` | 0\u2013100 |\n| `format` | `"auto" \\| "webp" \\| "avif" \\| "jpeg"` | `"auto"` lets the CDN pick by `Accept` header |\n\nThe transform query is only meaningful when the URL terminates on the Cimplify storefront CDN (which supports on-the-fly resizing). For external hosts, unknown params are typically ignored; the image still loads at its original size.\n\n## `isCimplifyAsset(src, base?)`\n\nDecides whether `src` is hosted on a Cimplify CDN. Used by the storefront\'s `next/image` loader to skip transforms for external URLs.\n\n```ts\n\nisCimplifyAsset("hero/main.jpg")                                      // true (relative \u2192 ours)\nisCimplifyAsset("/img/seed/bakery/x.jpg")                             // true (dev mock passthrough)\nisCimplifyAsset("https://storefrontassetscdn.cimplify.io/x.jpg")     // true\nisCimplifyAsset("https://cdn.cimplify.io/x.jpg")                     // true\nisCimplifyAsset("https://static-tmp.cimplify.io/seed/x.jpg")         // true\nisCimplifyAsset("https://res.cloudinary.com/demo/upload/x.jpg")      // false\nisCimplifyAsset("https://images.unsplash.com/photo-xyz")             // false\n```\n\n## Built-in `next/image` loader\n\nEvery storefront template scaffolded by `cimplify init` ships `lib/cimplify-loader.ts` and points `images.loaderFile` at it. The loader:\n\n```ts\n\nconst cdnBase = process.env.NEXT_PUBLIC_CIMPLIFY_CDN_URL?.trim() || undefined;\n\nconst cimplifyImageLoader: ImageLoader = ({ src, width, quality }) => {\n  if (isCimplifyAsset(src, cdnBase)) {\n    return assetUrl(src, { base: cdnBase, w: width, quality, format: "auto" });\n  }\n  return src;\n};\n\nexport default cimplifyImageLoader;\n```\n\n**Cloudinary URLs from `client.catalogue.getProducts()` flow through untouched.** Cimplify-hosted URLs get the transform query. The result: every `<Image>` works regardless of where its asset lives, and Cimplify-hosted ones get edge-optimized.\n\nTo point the loader at a different CDN (for testing, multi-CDN setups, etc.) set `NEXT_PUBLIC_CIMPLIFY_CDN_URL` in your `.env.local`:\n\n```\nNEXT_PUBLIC_CIMPLIFY_CDN_URL=http://localhost:8787/storage\n```\n\n## `useImage(path, opts?)` (React)\n\nThin hook that returns `{ src, loader }` for `<Image>`:\n\n```tsx\n\nexport function Hero() {\n  const { src, loader } = useImage("hero/main.jpg", { format: "webp", quality: 85 });\n  return <Image src={src} loader={loader} alt="..." width={1200} height={800} />;\n}\n```\n\nIf `images.loaderFile` is already set globally in your `next.config.ts`, you typically don\'t need `useImage`; just `<Image src={assetUrl("hero/main.jpg")} />` works. `useImage` is useful when you want per-component transform overrides on a project that doesn\'t use a global loader.\n\n### Options\n\n| Field | Notes |\n| --- | --- |\n| `base` | Per-call CDN base override |\n| `w`, `h` | Default transform values; per-image `width` from `<Image>` still wins |\n| `format`, `quality` | Default transform values |\n\n`useImage` is `useMemo`-stable across renders when the path + opts don\'t change.\n\n## Constants\n\n```ts\n\nDEFAULT_CDN_BASE_URL // "https://storefrontassetscdn.cimplify.io"\nCIMPLIFY_CDN_HOSTS   // readonly ["storefrontassetscdn.cimplify.io", "cdn.cimplify.io", "static-tmp.cimplify.io"]\n```\n\n## What\'s not in v1\n\n- **`useUpload` hook**: runtime customer-facing uploads with progress + cancel. Deferred to v1.1. Customer uploads today go through `client.uploads.upload(file)` (no progress, no cancel; just `await`).\n- **`SEED_IDS` typed const tree**: demo-only convenience for referencing seed-image slugs in code. Generate-from-seed-source step deferred to v1.1; today demos use `seedImage(industry, slug)` from the SDK\'s mock module.\n- **Cloudinary / S3 path-transform support**: the loader passes external hosts through unchanged; Cloudinary\'s `c_fill,w_500/` path transforms aren\'t synthesized.\n- **`assets rm` server-side delete**: CLI removes manifest entries; the remote blob stays until v1.1\'s media-manager `DELETE` wiring.\n\n## Where it lives in the platform\n\n- Wire format: `POST /v1/businesses/{id}/assets/{init,confirm}`; see the management API reference\n- Backend service: `crate::uploads::service::UploadService::init_storefront_asset`\n- Served from the Cimplify asset CDN at `storefrontassetscdn.cimplify.io`\n- Storage key: `assets/{business_id}/{folder}/{upload_id}/{filename}`: immutable per upload; use the returned preview URL\n\n## Related\n\n- [`cimplify assets`](/docs/cli/assets): CLI surface for upload/ls/rm\n- [Uploads (customer-runtime)](/docs/sdk/uploads): `client.uploads.upload(file)` for private 7-day-presigned uploads\n'
   },
   {
     "name": "exit-codes",

package/dist/{inspect-MGVG4Z44.mjs → inspect-X3M7WSTL.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { parseEnvFile } from './chunk-RU53TQLZ.mjs';
+import { parseEnvFile } from './chunk-I2UP7YTG.mjs';
 import { parseArgs, flagString, flagBool } from './chunk-5KYR6WJB.mjs';
-import { CliError, CLI_ERROR_CODE, isJsonMode, result, info, bold, dim, yellow, green, red } from './chunk-4O4G2CDE.mjs';
+import { CliError, CLI_ERROR_CODE, isJsonMode, result, info, bold, dim, yellow, green, red } from './chunk-3QUK5BPY.mjs';
 import { promises } from 'fs';
 import path from 'path';
 import { createCimplifyClient } from '@cimplify/sdk';

package/dist/introspect-KTB4BXU5.mjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+export { run as default, extractMockSeed, gatherIntrospection, renderIntrospection } from './chunk-5SMYK3U2.mjs';
+import './chunk-I2UP7YTG.mjs';
+import './chunk-GCQKTUXN.mjs';
+import './chunk-KN2YSKXZ.mjs';
+import './chunk-5KYR6WJB.mjs';
+import './chunk-MLE4MVYC.mjs';
+import './chunk-3QUK5BPY.mjs';

package/dist/{link-KGNQWCSZ.mjs → link-4NM2QMI5.mjs}

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
+import { gitDetectRoot, gitGetRemoteUrl, gitAddRemote } from './chunk-KN2YSKXZ.mjs';
 import { parseArgs } from './chunk-5KYR6WJB.mjs';
-import { ApiClient } from './chunk-TOQGLBWF.mjs';
-import { readAuth, writeProjectLink } from './chunk-6CHBU7O4.mjs';
-import { CliError, CLI_ERROR_CODE, success, info, dim, result } from './chunk-4O4G2CDE.mjs';
+import { ApiClient } from './chunk-NYXA6X56.mjs';
+import { readAuth, writeProjectLink } from './chunk-MLE4MVYC.mjs';
+import { CliError, CLI_ERROR_CODE, success, info, dim, result } from './chunk-3QUK5BPY.mjs';
 
 // src/commands/link.ts
 function projectEndpoint(businessId, projectId) {
@@ -32,14 +33,30 @@ async function run(argv) {
     linkedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   await writeProjectLink(link);
+  const originConfigured = await configureOrigin(link.remoteUrl);
   success(`Linked to ${project.name} (${project.id})`);
   if (link.remoteUrl) info(dim(`remote: ${link.remoteUrl}`));
   result({
     project: { id: project.id, name: project.name },
     business: { id: project.business_id },
     remote_url: link.remoteUrl ?? null,
-    default_branch: link.defaultBranch ?? null
+    default_branch: link.defaultBranch ?? null,
+    origin_configured: originConfigured
   });
 }
+async function configureOrigin(remoteUrl) {
+  if (!remoteUrl) return false;
+  const root = await gitDetectRoot(process.cwd());
+  if (!root) return false;
+  const existing = await gitGetRemoteUrl(root);
+  if (existing === remoteUrl) return true;
+  if (existing) {
+    info(dim(`origin already points at ${existing}; project remote is ${remoteUrl}`));
+    return false;
+  }
+  await gitAddRemote(root, remoteUrl);
+  info(dim(`origin \u2192 ${remoteUrl}`));
+  return true;
+}
 
 export { run as default };

package/dist/{lint-EYKIQ6RO.mjs → lint-DDZ7HUQN.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { parseArgs, flagBool, flagString } from './chunk-5KYR6WJB.mjs';
-import { isJsonMode, result, info, CliError, CLI_ERROR_CODE, configureOutput, OUTPUT_MODE } from './chunk-4O4G2CDE.mjs';
+import { isJsonMode, result, info, CliError, CLI_ERROR_CODE, configureOutput, OUTPUT_MODE } from './chunk-3QUK5BPY.mjs';
 import { promises } from 'fs';
 import path from 'path';
 import { parse } from '@babel/parser';

package/dist/{list-QNEUCCP5.mjs → list-L6FMY3AF.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { REGISTRY_INDEX } from './chunk-BDC7XQIL.mjs';
+import { REGISTRY_INDEX } from './chunk-YJDQYKZU.mjs';
 import { parseArgs, flagBool } from './chunk-5KYR6WJB.mjs';
-import { CliError, CLI_ERROR_CODE, info, bold, dim, green, result } from './chunk-4O4G2CDE.mjs';
+import { CliError, CLI_ERROR_CODE, info, bold, dim, green, result } from './chunk-3QUK5BPY.mjs';
 
 // src/commands/list.ts
 async function run(argv) {

package/dist/{login-NCO4P5G5.mjs → login-ZTSWYO5G.mjs}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import { generatePkcePair, openBrowser } from './chunk-IK6NQHTG.mjs';
+import { generatePkcePair, openBrowser } from './chunk-3KRSHO6J.mjs';
 import { parseArgs, flagString, flagBool } from './chunk-5KYR6WJB.mjs';
-import { resolveBaseUrl, ApiClient } from './chunk-TOQGLBWF.mjs';
-import { writeAuth } from './chunk-6CHBU7O4.mjs';
-import { CliError, CLI_ERROR_CODE, success, result, isJsonMode, step, info, dim } from './chunk-4O4G2CDE.mjs';
+import { resolveBaseUrl, ApiClient } from './chunk-NYXA6X56.mjs';
+import { writeAuth } from './chunk-MLE4MVYC.mjs';
+import { CliError, CLI_ERROR_CODE, success, result, isJsonMode, step, info, dim } from './chunk-3QUK5BPY.mjs';
 import os from 'os';
 
 var FLAG_API_KEY = "api-key";

package/dist/{logout-MF6SOLPE.mjs → logout-Z57X6HPE.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { clearAuth } from './chunk-6CHBU7O4.mjs';
-import { success, info, result } from './chunk-4O4G2CDE.mjs';
+import { clearAuth } from './chunk-MLE4MVYC.mjs';
+import { success, info, result } from './chunk-3QUK5BPY.mjs';
 
 // src/commands/logout.ts
 async function run(_argv) {

package/dist/{logs-76TCJBIQ.mjs → logs-36BLYJHJ.mjs}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { TERMINAL_DEPLOYMENT_STATUSES } from './chunk-MXYUAJEW.mjs';
 import { parseArgs, flagString, flagBool } from './chunk-5KYR6WJB.mjs';
-import { ApiClient } from './chunk-TOQGLBWF.mjs';
-import { readAuth, readProjectLink, readProjectState } from './chunk-6CHBU7O4.mjs';
-import { CliError, CLI_ERROR_CODE, isJsonMode, failure, result, red } from './chunk-4O4G2CDE.mjs';
+import { ApiClient } from './chunk-NYXA6X56.mjs';
+import { readAuth, readProjectLink, readProjectState } from './chunk-MLE4MVYC.mjs';
+import { CliError, CLI_ERROR_CODE, isJsonMode, failure, result, red } from './chunk-3QUK5BPY.mjs';
 
 // src/commands/logs.ts
 var FLAG_DEPLOYMENT = "deployment";

package/dist/{mock-CAWNXSGC.mjs → mock-EVER34IX.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { parseArgs, flagString, flagBool } from './chunk-5KYR6WJB.mjs';
-import { CliError, CLI_ERROR_CODE, info, dim } from './chunk-4O4G2CDE.mjs';
+import { CliError, CLI_ERROR_CODE, info, dim } from './chunk-3QUK5BPY.mjs';
 import { spawn } from 'child_process';
 import { existsSync, writeFileSync } from 'fs';
 import path from 'path';

package/dist/{projects-U75DOOR7.mjs → projects-4XRNHJAH.mjs}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { REPO_PROVIDER } from './chunk-MXYUAJEW.mjs';
 import { parseArgs, flagString, flagBool } from './chunk-5KYR6WJB.mjs';
-import { ApiClient } from './chunk-TOQGLBWF.mjs';
-import { readAuth } from './chunk-6CHBU7O4.mjs';
-import { CliError, CLI_ERROR_CODE, info, dim, result, bold, success } from './chunk-4O4G2CDE.mjs';
+import { ApiClient } from './chunk-NYXA6X56.mjs';
+import { readAuth } from './chunk-MLE4MVYC.mjs';
+import { CliError, CLI_ERROR_CODE, info, dim, result, bold, success } from './chunk-3QUK5BPY.mjs';
 
 // src/commands/projects.ts
 var SUB_LS = "ls";
@@ -176,8 +176,8 @@ async function createProject(client, businessId, name, options = {}) {
   info(dim(`  remote: ${repo.remote_url}`));
   info("");
   info(dim("Wire your local repo:"));
-  info(dim(`  cimplify link ${project.id}`));
-  info(dim(`  git init && git remote add origin ${repo.remote_url}`));
+  info(dim("  git init"));
+  info(dim(`  cimplify link ${project.id}   # configures origin for you`));
   info(dim(`  git add . && git commit -m "Initial commit"`));
   info(dim(`  cimplify deploy`));
   result({

package/dist/repo-X3KZ5R64.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+export { run as default, fetchCloneToken, fetchRepoRecord } from './chunk-A6WHBSXZ.mjs';
+import './chunk-TH4XENKH.mjs';
+import './chunk-MXYUAJEW.mjs';
+import './chunk-KN2YSKXZ.mjs';
+import './chunk-5KYR6WJB.mjs';
+import './chunk-NYXA6X56.mjs';
+import './chunk-MLE4MVYC.mjs';
+import './chunk-3QUK5BPY.mjs';

package/dist/{rollback-ZL3V7SYH.mjs → rollback-WCRWXSE3.mjs}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { pollDeployment } from './chunk-PDGKBATF.mjs';
+import { pollDeployment } from './chunk-NK6VC264.mjs';
 import { DEPLOYMENT_STATUS, DEPLOY_TRIGGER } from './chunk-MXYUAJEW.mjs';
 import { parseArgs, flagBool } from './chunk-5KYR6WJB.mjs';
-import { ApiClient } from './chunk-TOQGLBWF.mjs';
-import { readAuth, readProjectLink, writeProjectState } from './chunk-6CHBU7O4.mjs';
-import { CliError, CLI_ERROR_CODE, step, success, info, dim, result, EXIT_CODE } from './chunk-4O4G2CDE.mjs';
+import { ApiClient } from './chunk-NYXA6X56.mjs';
+import { readAuth, readProjectLink, writeProjectState } from './chunk-MLE4MVYC.mjs';
+import { CliError, CLI_ERROR_CODE, step, success, info, dim, result, EXIT_CODE } from './chunk-3QUK5BPY.mjs';
 
 // src/commands/rollback.ts
 var FLAG_NO_POLL = "no-poll";

package/dist/{status-52HG63FE.mjs → status-VA326DWD.mjs}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { DEPLOYMENT_STATUS } from './chunk-MXYUAJEW.mjs';
 import { parseArgs } from './chunk-5KYR6WJB.mjs';
-import { ApiClient } from './chunk-TOQGLBWF.mjs';
-import { readAuth, readProjectLink, readProjectState } from './chunk-6CHBU7O4.mjs';
-import { bold, dim, info, result } from './chunk-4O4G2CDE.mjs';
+import { ApiClient } from './chunk-NYXA6X56.mjs';
+import { readAuth, readProjectLink, readProjectState } from './chunk-MLE4MVYC.mjs';
+import { bold, dim, info, result } from './chunk-3QUK5BPY.mjs';
 
 // src/commands/status.ts
 var QUERY_LIMIT = "limit";

package/dist/{unlink-TCG3NBAR.mjs → unlink-H3BO3DOQ.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { clearProjectLink } from './chunk-6CHBU7O4.mjs';
-import { success, info, result } from './chunk-4O4G2CDE.mjs';
+import { clearProjectLink } from './chunk-MLE4MVYC.mjs';
+import { success, info, result } from './chunk-3QUK5BPY.mjs';
 
 // src/commands/unlink.ts
 async function run(_argv) {

package/dist/{update-47HG7LN7.mjs → update-XUDRJZDE.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { package_default } from './chunk-5YVMA7A5.mjs';
-import { promptYesNo } from './chunk-5ZQURRIM.mjs';
+import { promptYesNo } from './chunk-TH4XENKH.mjs';
+import { package_default } from './chunk-GCQKTUXN.mjs';
 import { parseArgs, flagBool, flagString } from './chunk-5KYR6WJB.mjs';
-import { success, bold, info, dim, result, failure, CliError, CLI_ERROR_CODE, step, isJsonMode } from './chunk-4O4G2CDE.mjs';
+import { success, bold, info, dim, result, failure, CliError, CLI_ERROR_CODE, step, isJsonMode } from './chunk-3QUK5BPY.mjs';
 import { spawn } from 'child_process';
 import { basename, dirname } from 'path';
 

package/dist/{whoami-B5Y5KSOZ.mjs → whoami-ZWTJMEDB.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { ApiClient } from './chunk-TOQGLBWF.mjs';
-import { readAuth } from './chunk-6CHBU7O4.mjs';
-import { info, bold, dim, result } from './chunk-4O4G2CDE.mjs';
+import { ApiClient } from './chunk-NYXA6X56.mjs';
+import { readAuth } from './chunk-MLE4MVYC.mjs';
+import { info, bold, dim, result } from './chunk-3QUK5BPY.mjs';
 
 // src/commands/whoami.ts
 var ENDPOINT_AUTH_ME = "/v1/auth/me";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cimplify/cli",
-  "version": "0.13.5",
+  "version": "0.15.0",
   "description": "Cimplify CLI — deploy, manage env vars, link projects, and scaffold storefronts",
   "keywords": [
     "cimplify",
@@ -41,7 +41,7 @@
     "@babel/parser": "^8.0.4",
     "@babel/traverse": "^8.0.4",
     "@babel/types": "^8.0.4",
-    "@cimplify/sdk": "^0.100.5",
+    "@cimplify/sdk": "^0.102.0",
     "re2js": "^1.4.0"
   },
   "devDependencies": {

package/templates/storefront-auto/package.json

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

package/templates/storefront-bakery/package.json

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

package/templates/storefront-fashion/package.json

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

package/templates/storefront-grocery/package.json

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

package/templates/storefront-pharmacy/package.json

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