@doswiftly/cli 0.2.1 → 0.2.6

package/CHANGELOG.md

@@ -0,0 +1,260 @@
+# Changelog
+
+## 0.2.6
+
+### Patch Changes
+
+- 7846bdb: Fix `doswiftly dev` port pre-flight on Windows (and any host where another
+  process binds the port on IPv6 `::` only): the probe now checks IPv4 and
+  IPv6 in parallel and requires BOTH free before marking a port as available.
+  Previously an IPv6-only conflict (common on Windows, where Next.js binds
+  `::` by default) slipped past the IPv4-only probe — the banner advertised
+  `http://localhost:3000` and the framework immediately crashed with
+  `EADDRINUSE :::3000`. With this fix `doswiftly dev` falls back to the next
+  free port (3001, 3002, …) as documented.
+
+  Also ship `CHANGELOG.md` inside the npm tarball. Previous releases packed
+  only `dist`/`bin`/`templates` (and `schema.graphql`/operations for
+  `storefront-operations`, `dist` for `storefront-sdk`), so consumers who
+  `npm install @doswiftly/cli` got a version number with no user-visible
+  release notes.
+
+## 0.2.5
+
+### Patch Changes
+
+- e3174bb: Fix `doswiftly dev` to handle two common papercuts out of the box.
+
+  **Port pre-flight + auto-fallback.** `doswiftly dev` now probes the requested port
+  (default `3000`) before spawning the framework and auto-falls back to the next free
+  port up to `+10` (e.g. `3000 → 3001 → 3002`) — no more `EADDRINUSE` crashes when
+  another process already owns the default port. The banner is printed after the port
+  is reserved, so the advertised URL always matches what the framework actually binds.
+  Pass `--strict-port` (or set `dev.strictPort: true` in `doswiftly.config.ts`) to
+  fail fast instead of falling back.
+
+  **Active profile now wins over `api.url`.** `doswiftly env use <profile>` used to be
+  silently ignored for `doswiftly dev`, `inspect`, and `proxy` when `doswiftly.config.ts`
+  contained an `api.url` (which every scaffold sets). The precedence is now:
+  `DOSWIFTLY_API_URL` / `NEXT_PUBLIC_API_URL` shell env > active profile >
+  `doswiftly.config.ts` `api.url` > `.env.local` > default. `doswiftly deploy`
+  keeps its existing behaviour (project config wins unless `DOSWIFTLY_API_URL` is set).
+
+  Extras shipped alongside the fixes:
+  - `--strict-port` flag on `doswiftly dev`.
+  - The dev banner reports where the API URL came from
+    (e.g. `API: http://localhost:8000 (from profile "dev")`).
+  - `doswiftly env use` prints a one-line hint when the active profile overrides
+    `api.url` from `doswiftly.config.ts`.
+  - A warning when your `package.json` dev script hardcodes a port
+    (e.g. `"dev": "next dev -p 3000"`) that may override the CLI-supplied port.
+
+All notable changes to `@doswiftly/cli` will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.4] - 2026-04-20
+
+### Fixed
+
+- **`doswiftly dev` no longer crashes with `EADDRINUSE` when the dev port is in use.**
+  The CLI now probes the requested port (default `3000`) before starting the framework and
+  auto-falls back to the next free port up to `+10` (so `3000 → 3001 → 3002`). The banner is
+  printed after the port is bound, so `Storefront: http://localhost:3001` always matches what
+  actually starts. Opt out with `--strict-port` on the command or `dev.strictPort: true` in
+  `doswiftly.config.ts` to fail fast instead.
+- **`doswiftly env use <profile>` now takes precedence over `api.url` in `doswiftly.config.ts`
+  for `doswiftly dev`, `inspect`, and `proxy`.** Previously, the project config silently
+  overrode the active profile, so switching to a `dev` profile with `API: http://localhost:8000`
+  still hit the production URL configured at scaffold time. Shell env vars (`DOSWIFTLY_API_URL`,
+  `NEXT_PUBLIC_API_URL`) stay on top for CI/CD and ad-hoc overrides. `doswiftly deploy`
+  behaviour is unchanged.
+
+### Added
+
+- **`--strict-port` flag and `dev.strictPort` config field** for `doswiftly dev`. When set,
+  the command fails with an actionable error (including the blocking port and the hint to
+  pass `--port <N>`) instead of auto-falling back.
+- **Banner now reports where the API URL came from** (e.g. `API: http://localhost:8000
+(from profile "dev")`), making it easier to diagnose unexpected target URLs.
+- **`doswiftly env use` surfaces a one-line notice** when the project's `doswiftly.config.ts`
+  hardcodes a different `api.url` than the active profile, so you know the profile is
+  intentionally taking over.
+- **Warning for hardcoded port in your `dev` script.** When `package.json` has
+  `"dev": "next dev -p 3000"` (or similar), the CLI warns in CI logs that the hardcoded port
+  may override `--port` / `PORT` env.
+
+## [0.2.3] - 2026-04-17
+
+### Security
+
+- Bump `axios` to `^1.15.0` to resolve GHSA-3p68-rc4w-qgx5 (NO_PROXY normalization bypass → SSRF) and GHSA-fvcv-3m26-pcqx (cloud metadata exfiltration via header injection).
+
+## [0.2.2] - 2026-04-12
+
+### Changed
+
+- **Default `@doswiftly/storefront-operations` dependency bumped `^1.0.0` → `^5.0.0`.** New storefronts
+  scaffolded via `doswiftly init` / `doswiftly template` now pull the per-location
+  `storeAvailability` surface out of the box. Existing storefronts on older operations keep working —
+  bump the dependency manually and re-run `pnpm install` when you're ready to adopt it.
+- **Storefront template (`storefront-nextjs-shadcn`): BOPIS example in `custom.example.graphql`
+  rewritten to the new API.** The `storeAvailability(first, near, locationType)` field on
+  `ProductVariant` replaces the previous per-location lookup, and the example now demonstrates the
+  `@inContext(preferredLocationId)` operation directive plus a `GetPickupLocations` store picker
+  query.
+
+## [0.2.1] - 2026-04-10
+
+### Fixed
+
+- **Dev proxy: strip Referer header alongside Origin.** The CSRF origin middleware on the
+  production backend validates both `Origin` and `Referer` headers. The proxy was only stripping
+  `Origin`, so the browser's `Referer: http://localhost:3000` was forwarded and rejected as
+  an unknown origin. Now both are stripped, making proxied requests appear as server-to-server.
+
+## [0.2.0] - 2026-04-10
+
+### Added
+
+- **Init: adopt flow for existing projects.** Running `doswiftly init` in a non-empty directory
+  now detects the existing project and offers to connect it to DoSwiftly without copying template
+  files. Creates `doswiftly.config.ts`, merges `.env.local`, and optionally installs SDK packages.
+- **Dev: automatic API proxy for CORS-free development.** `doswiftly dev` now auto-starts a local
+  proxy when the API URL points to a remote server, eliminating CORS errors during local development.
+  The proxy forwards all headers and runs transparently — no code changes needed in the storefront.
+
+### Changed
+
+- **Renamed "Commerce SDK" to "Storefront SDK"** across all CLI output, command descriptions,
+  and help text to match the actual package name (`@doswiftly/storefront-sdk`).
+- **Doctor: accepts `storefront-sdk` OR `storefront-operations`** as valid DoSwiftly dependencies
+  (matching deploy command logic).
+- **Dev: framework-agnostic dev command.** `doswiftly dev` now reads `scripts.dev` from
+  `package.json` instead of hardcoding `next dev`.
+- **Proxy: full header forwarding.** The proxy now forwards all request/response headers
+  (except hop-by-hop), including SDK headers, cookies, and Set-Cookie.
+
+### Removed
+
+- **Deprecated templates `storefront-nextjs` and `storefront-minimal`** removed from the package.
+  Only `storefront-nextjs-shadcn` (Next.js 16 + shadcn/ui) is shipped. These templates had
+  broken dependencies and outdated SDK references.
+- **Dead code:** removed duplicate `sdkVersionCommand` in `types.ts`, removed unused
+  `COMMERCE_SDK_VERSION` placeholder from init and template commands.
+
+### Fixed
+
+- **Verify/Check: fixed `env:generate` → `env generate`** in help text (commands use spaces, not colons).
+
+## [0.1.24] - 2026-04-10
+
+### Fixed
+
+- **Deploy: fix esbuild version detection using `pnpm ls` instead of binary/require().**
+  Both `pnpm exec esbuild --version` and `require('esbuild/package.json')` fail silently
+  in pnpm strict mode for transitive deps. Now uses `pnpm ls esbuild --parseable` which
+  queries pnpm's own dependency graph — works regardless of hoisting or strict mode config.
+- **Deploy: suggest highest installed esbuild version in fix instructions.** Instead of
+  a hardcoded `>=0.17.0`, the error message now suggests the highest esbuild version
+  already in the dependency tree (e.g. `0.25.4` from `@opennextjs/cloudflare`).
+
+## [0.1.23] - 2026-04-10
+
+### Added
+
+- **Deploy: early detection of incompatible esbuild versions.** If a transitive dependency
+  (e.g. `react-email`) pulls in esbuild <0.16.10 (lacks subpath alias support), CLI now
+  detects this before the build and exits with an actionable error message explaining how
+  to add an override. Uses the same `pnpm exec` resolution pattern as wrangler.
+
+### Removed
+
+- Removed auto-override of merchant's `package.json` (0.1.20-0.1.22). The approach was
+  unreliable across pnpm configurations and overstepped CLI's responsibility — dependency
+  management belongs to the project owner, not the deploy tool.
+
+## [0.1.19] - 2026-04-08
+
+### Fixed
+
+- Deploy: improved Cloudflare WAF/Bot protection error diagnostics with CF-Ray ID and hints.
+- Deploy: better error formatting for HTML error pages from Cloudflare.
+
+## [0.1.18] - 2026-04-05
+
+### Added
+
+- Deploy: `[observability]` section in generated `wrangler.toml` — logs persisted in Cloudflare Dashboard.
+- Deploy: `[images]` binding for Next.js `/_next/image` optimization via Cloudflare Images.
+
+## [0.1.17] - 2026-03-28
+
+### Fixed
+
+- Deploy: added Wrangler re-bundle step (`wrangler deploy --dry-run --outdir`) to convert
+  `require()` calls to ESM imports. Without this, CF Workers throw
+  `Dynamic require of "node:crypto" is not supported`.
+- Deploy: CLI now auto-installs `wrangler` if not present in the project.
+- Deploy: only `.js`, `.mjs`, `.wasm` files are copied from Wrangler output (skips `.map`, `README`).
+
+### Changed
+
+- Deploy: CLI generates `wrangler.toml` automatically, overwriting merchant's version to ensure
+  correct worker name, compatibility flags, and ASSETS binding.
+- Deploy: CLI generates `open-next.config.ts` (required by `@opennextjs/cloudflare` 1.17+).
+
+## [0.1.16] - 2026-03-20
+
+### Added
+
+- `doswiftly upgrade` — user-friendly wrapper for template migration commands.
+- `doswiftly migrate check/apply/diff` — template update management.
+
+## [0.1.15] - 2026-03-15
+
+### Added
+
+- `doswiftly auth github` — GitHub account linking via device flow.
+- `doswiftly auth token` — deploy token generation for CI/CD pipelines.
+- `doswiftly template create/register/publish/validate` — SaaS developer template management.
+
+## [0.1.14] - 2026-03-10
+
+### Added
+
+- `doswiftly preview create/list/stop/logs/open` — preview environment management.
+- `doswiftly config domain add/remove/list` — custom domain management.
+
+## [0.1.13] - 2026-03-05
+
+### Added
+
+- `doswiftly deploy run/status/rollback/logs` — Track 2 deployment pipeline.
+- Content-hash manifest for incremental uploads (only changed assets uploaded).
+- Idempotency keys for safe retries.
+
+## [0.1.12] - 2026-02-28
+
+### Added
+
+- `doswiftly env add/use/list/generate/delete/set` — environment profile management.
+- `doswiftly doctor` — project health diagnostics.
+- `doswiftly check` — dependency validation.
+
+## [0.1.11] - 2026-02-20
+
+### Added
+
+- `doswiftly dev` — development server with automatic env injection from API.
+- `doswiftly config pull/show` — configuration management.
+
+## [0.1.10] - 2026-02-15
+
+### Added
+
+- `doswiftly init` — interactive project scaffolding with template selection.
+- `doswiftly auth login/logout` — OAuth authentication.
+- `doswiftly whoami` — current context display.
+- `doswiftly verify` — project verification.

package/README.md

@@ -21,7 +21,7 @@ doswiftly auth login       # Login to DoSwiftly
 doswiftly dev              # Start development server
 ```
 
-Your storefront will be running at `http://localhost:3000`.
+Your storefront will be running at `http://localhost:3000` (or the next available port if 3000 is in use).
 
 ## Commands Overview
 

package/dist/commands/dev.d.ts

@@ -1,7 +1,13 @@
 interface DevOptions {
-    port?: number;
+    /**
+     * Commander now coerces `--port` via `Number.parseInt`, but programmatic
+     * callers (tests, SDK embeds) may still pass a string. Accept both and
+     * coerce inside `devCommand`.
+     */
+    port?: number | string;
     host?: string;
     open?: boolean;
+    strictPort?: boolean;
 }
 /**
  * Detect the dev command and port/host args from package.json.

package/dist/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAQA,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAYD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CA2BjC;AA0CD,wBAAsB,UAAU,CAAC,OAAO,GAAE,UAAe,iBAuFxD"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAgBA,UAAU,UAAU;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAcD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAqCjC;AAqCD,wBAAsB,UAAU,CAAC,OAAO,GAAE,UAAe,iBAiKxD"}

package/dist/commands/dev.js

@@ -3,8 +3,11 @@ import ora from "ora";
 import { execa } from "execa";
 import { existsSync, readFileSync } from "fs";
 import { readLocalConfigSync } from "../lib/config.js";
-import { getActiveProfile } from "../lib/env-storage.js";
-import { isRemoteUrl, findFreePort, startProxyServer } from "../lib/proxy-server.js";
+import { resolveApiUrl } from "../lib/api-url.js";
+import { isRemoteUrl, findFreePort, findSequentialFreePort, PortRangeExhaustedError, startProxyServer, } from "../lib/proxy-server.js";
+import { logger } from "../lib/logger.js";
+import { t } from "../lib/i18n.js";
+const PORT_FALLBACK_MAX_ATTEMPTS = 10;
 /**
  * Read a non-commented env var value from a dotenv file content.
  * Returns null if not found or commented out.
@@ -34,8 +37,15 @@ export function detectDevCommand(port, host) {
     catch {
         return { bin: "pnpm", args: ["dev"] };
     }
-    // If scripts.dev exists, delegate — port/host set via env (PORT, HOST)
+    // If scripts.dev exists, delegate — port/host set via env (PORT, HOST).
+    // If the script hardcodes a port (e.g. `next dev -p 3000`), the env var
+    // cannot override it — surface a warning so the developer can diagnose.
     if (pkg.scripts?.dev) {
+        const hardcoded = /(?:-p|--port)\s+\d+/.exec(pkg.scripts.dev);
+        if (hardcoded) {
+            logger.warn(t().devScriptsDevHardcodedPort(hardcoded[0]));
+            logger.ghWarning(t().devScriptsDevHardcodedPort(hardcoded[0]), "scripts.dev hardcoded port");
+        }
         return { bin: "pnpm", args: ["run", "dev"] };
     }
     // No scripts.dev — detect framework and use correct flag syntax
@@ -52,56 +62,94 @@ export function detectDevCommand(port, host) {
     return { bin: "pnpm", args: ["dev"] };
 }
 /**
- * Resolve API URL from config sources (priority order).
+ * Render the provenance tag for the resolved API URL (e.g. `(from profile "dev")`).
  */
-function resolveApiUrl(localConfig) {
-    // 1. Env var (explicit override)
-    if (process.env.NEXT_PUBLIC_API_URL)
-        return process.env.NEXT_PUBLIC_API_URL;
-    // 2. doswiftly.config.ts
-    if (localConfig?.api?.url)
-        return localConfig.api.url;
-    // 3. Active profile
-    const profile = getActiveProfile();
-    if (profile?.apiUrl)
-        return profile.apiUrl;
-    // 4. .env.local (ignoring comments)
-    if (existsSync(".env.local")) {
-        const content = readFileSync(".env.local", "utf-8");
-        const value = readEnvVar(content, "NEXT_PUBLIC_API_URL");
-        if (value)
-            return value;
+function describeApiUrlSource(resolution) {
+    switch (resolution.source) {
+        case "env":
+            return t().devApiSourceEnv(resolution.envVarName ?? "");
+        case "profile":
+            return t().devApiSourceProfile(resolution.profileName ?? "");
+        case "localConfig":
+            return t().devApiSourceLocalConfig;
+        case "dotEnvLocal":
+            return t().devApiSourceDotEnvLocal;
+        case "fallback":
+            return t().devApiSourceFallback;
     }
-    return "http://localhost:8000";
 }
 /**
- * Resolve shop slug from config sources.
+ * Resolve shop slug from project-scoped config sources. Profiles intentionally
+ * do not carry a slug (the slug is a property of the project, not the env).
  */
-function resolveShopSlug(localConfig) {
+function resolveShopSlug(localConfig, dotEnvLocal) {
     if (process.env.NEXT_PUBLIC_SHOP_SLUG)
         return process.env.NEXT_PUBLIC_SHOP_SLUG;
     if (localConfig?.shop?.slug)
         return localConfig.shop.slug;
-    if (existsSync(".env.local")) {
-        const content = readFileSync(".env.local", "utf-8");
-        const value = readEnvVar(content, "NEXT_PUBLIC_SHOP_SLUG");
-        if (value)
-            return value;
-    }
+    const fromEnvLocal = readEnvVar(dotEnvLocal, "NEXT_PUBLIC_SHOP_SLUG");
+    if (fromEnvLocal)
+        return fromEnvLocal;
     return "demo-shop";
 }
 export async function devCommand(options = {}) {
     // Read local config (non-fatal if missing — adopt flow may not have config yet)
     const localConfig = readLocalConfigSync();
-    const apiUrl = resolveApiUrl(localConfig);
-    const shopSlug = resolveShopSlug(localConfig);
-    const port = options.port || localConfig?.dev?.port || 3000;
-    const host = options.host || "localhost";
-    // Determine if we need a proxy
+    const dotEnvLocal = existsSync(".env.local")
+        ? readFileSync(".env.local", "utf-8")
+        : "";
+    // Unified precedence: shell env > active profile > doswiftly.config.ts > .env.local > default.
+    // The previous dev-local resolver put local config above profile, which silently
+    // ignored `doswiftly env use <profile>` when the project config had an api.url.
+    const apiResolution = resolveApiUrl({
+        envVarNames: ["NEXT_PUBLIC_API_URL", "DOSWIFTLY_API_URL"],
+        localConfigUrl: localConfig?.api?.url,
+        dotEnvLocalUrl: readEnvVar(dotEnvLocal, "NEXT_PUBLIC_API_URL") ?? undefined,
+        fallback: "http://localhost:8000",
+    });
+    const apiUrl = apiResolution.url;
+    const shopSlug = resolveShopSlug(localConfig, dotEnvLocal);
+    // Commander parses --port with Number.parseInt so options.port is already a
+    // number here. Defense-in-depth: coerce anything coming in as a string
+    // (future refactors, direct programmatic callers) and validate the range so
+    // `NaN` never reaches findSequentialFreePort's arithmetic.
+    const rawPort = options.port ?? localConfig?.dev?.port ?? 3000;
+    const requestedPort = typeof rawPort === "string" ? Number.parseInt(rawPort, 10) : rawPort;
+    if (!Number.isInteger(requestedPort) || requestedPort < 1 || requestedPort > 65535) {
+        console.error(chalk.red(`Invalid port: ${rawPort}`));
+        console.error(chalk.gray("  Port must be an integer between 1 and 65535."));
+        process.exit(1);
+    }
+    const host = options.host ?? "localhost";
+    const strictPort = Boolean(options.strictPort ?? localConfig?.dev?.strictPort);
+    // Pre-flight: find a free port before printing the banner so what we advertise
+    // matches what the framework will actually bind.
+    let actualPort;
+    try {
+        actualPort = await findSequentialFreePort(requestedPort, PORT_FALLBACK_MAX_ATTEMPTS, "0.0.0.0");
+    }
+    catch (error) {
+        if (error instanceof PortRangeExhaustedError) {
+            console.error(chalk.red(t().devPortRangeExhausted(error.start, error.end)));
+            console.error(chalk.gray(`  ${t().devPortRangeHint}`));
+            process.exit(1);
+        }
+        throw error;
+    }
+    if (actualPort !== requestedPort) {
+        if (strictPort) {
+            console.error(chalk.red(t().devPortInUseStrict(requestedPort)));
+            console.error(chalk.gray(`  ${t().devPortInUseStrictHint}`));
+            process.exit(1);
+        }
+        logger.warn(t().devPortFallback(requestedPort, actualPort));
+        console.log(chalk.gray(`  ${t().devPortFallbackHint}`));
+    }
+    // Determine if we need a proxy (remote API → local proxy to bypass CORS)
     let proxyUrl = null;
     let proxyServer = null;
     if (isRemoteUrl(apiUrl)) {
-        const spinner = ora("Starting API proxy...").start();
+        const spinner = ora(t().devProxyStarting).start();
         try {
             const proxyPort = await findFreePort(4001);
             proxyServer = await startProxyServer({
@@ -111,36 +159,47 @@ export async function devCommand(options = {}) {
                 quiet: true,
             });
             proxyUrl = `http://localhost:${proxyPort}`;
-            spinner.succeed(chalk.green("API proxy started"));
+            spinner.succeed(chalk.green(t().devProxyStarted));
         }
         catch (error) {
-            spinner.fail(chalk.red("Failed to start proxy"));
+            spinner.fail(chalk.red(t().devProxyFailed));
             console.error(chalk.gray(`  ${error.message}`));
-            console.log(chalk.yellow("\n  Continuing without proxy — CORS errors may occur.\n"));
+            console.log(chalk.yellow(`\n  ${t().devProxyContinuingNoProxy}\n`));
         }
     }
-    // Display info
-    const effectiveApiUrl = proxyUrl || apiUrl;
+    // Display info — banner is printed *after* pre-flight so it reflects the
+    // port we actually bound plus the API URL we actually resolved.
+    const effectiveApiUrl = proxyUrl ?? apiUrl;
+    const apiSource = describeApiUrlSource(apiResolution);
     console.log("");
-    console.log(chalk.bold.blue("  DoSwiftly Dev Server\n"));
-    console.log(`  ${chalk.bold("Storefront:")}  ${chalk.cyan(`http://${host}:${port}`)}`);
+    console.log(chalk.bold.blue(`  ${t().devHeader}\n`));
+    console.log(`  ${chalk.bold(t().devLabelStorefront)}  ${chalk.cyan(`http://${host}:${actualPort}`)}`);
     if (proxyUrl) {
-        console.log(`  ${chalk.bold("API Proxy:")}   ${chalk.cyan(proxyUrl)}`);
-        console.log(`  ${chalk.gray("              → " + apiUrl)}`);
+        console.log(`  ${chalk.bold(t().devLabelApiProxy)}   ${chalk.cyan(proxyUrl)} ${chalk.gray(`(${apiSource})`)}`);
+        console.log(chalk.gray(`                -> ${apiUrl}`));
     }
     else {
-        console.log(`  ${chalk.bold("API:")}         ${chalk.cyan(apiUrl)}`);
+        console.log(`  ${chalk.bold(t().devLabelApi)}         ${chalk.cyan(apiUrl)} ${chalk.gray(`(${apiSource})`)}`);
+    }
+    console.log(`  ${chalk.bold(t().devLabelShop)}        ${chalk.cyan(shopSlug)}`);
+    // Surface a one-line hint when the project config hardcodes an api.url that
+    // the active profile overrides — helps the developer understand why the
+    // banner differs from what's in doswiftly.config.ts. (When source=profile,
+    // apiResolution.url equals the profile's apiUrl — no need to re-query.)
+    if (apiResolution.source === "profile" &&
+        localConfig?.api?.url &&
+        localConfig.api.url !== apiResolution.url) {
+        console.log(chalk.gray(`  ${t().envProfileOverridesConfig}`));
     }
-    console.log(`  ${chalk.bold("Shop:")}        ${chalk.cyan(shopSlug)}`);
     console.log("");
     // Detect dev command (includes framework-specific port/host flags)
-    const devCmd = detectDevCommand(port, host);
+    const devCmd = detectDevCommand(actualPort, host);
     // Build env — set PORT/HOST as fallback for frameworks that read from env
     const env = {
         ...process.env,
         NEXT_PUBLIC_API_URL: effectiveApiUrl,
         NEXT_PUBLIC_SHOP_SLUG: shopSlug,
-        PORT: String(port),
+        PORT: String(actualPort),
         HOST: host,
     };
     // Start dev server
@@ -151,7 +210,7 @@ export async function devCommand(options = {}) {
         });
         // Clean shutdown: kill proxy + dev server on SIGINT
         const cleanup = () => {
-            console.log(chalk.yellow("\n\n  Stopping dev server...\n"));
+            console.log(chalk.yellow(`\n\n  ${t().devStopping}\n`));
             devProcess.kill("SIGINT");
             if (proxyServer)
                 proxyServer.close();
@@ -167,7 +226,7 @@ export async function devCommand(options = {}) {
             proxyServer.close();
         const exitCode = error.exitCode;
         if (exitCode && exitCode !== 0 && exitCode !== 130) {
-            console.error(chalk.red(`\n  Dev server exited with code ${exitCode}\n`));
+            console.error(chalk.red(`\n  ${t().devExitedCode(exitCode)}\n`));
             process.exit(exitCode);
         }
     }

package/dist/commands/dev.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAyB,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACL,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,gBAAgB,CAAC;AAcnC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAEtC;;;GAGG;AACH,SAAS,UAAU,CAAC,OAAe,EAAE,GAAW;IAC9C,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,QAAQ,GAAG,qBAAqB,EAAE,GAAG,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,IAAY;IAEZ,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,GAA0H,CAAC;IAC/H,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IACxC,CAAC;IAED,wEAAwE;IACxE,wEAAwE;IACxE,wEAAwE;IACxE,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC;QACrB,MAAM,SAAS,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9D,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,0BAA0B,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1D,MAAM,CAAC,SAAS,CACd,CAAC,EAAE,CAAC,0BAA0B,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAC5C,4BAA4B,CAC7B,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;IAC/C,CAAC;IAED,gEAAgE;IAChE,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;IAC7D,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAEvB,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;IACvF,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;IAC/F,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;IACjG,IAAI,eAAe,IAAI,IAAI;QAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;IAExG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,UAA4B;IACxD,QAAQ,UAAU,CAAC,MAAM,EAAE,CAAC;QAC1B,KAAK,KAAK;YACR,OAAO,CAAC,EAAE,CAAC,eAAe,CAAC,UAAU,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAC1D,KAAK,SAAS;YACZ,OAAO,CAAC,EAAE,CAAC,mBAAmB,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAC/D,KAAK,aAAa;YAChB,OAAO,CAAC,EAAE,CAAC,uBAAuB,CAAC;QACrC,KAAK,aAAa;YAChB,OAAO,CAAC,EAAE,CAAC,uBAAuB,CAAC;QACrC,KAAK,UAAU;YACb,OAAO,CAAC,EAAE,CAAC,oBAAoB,CAAC;IACpC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CACtB,WAAgD,EAChD,WAAmB;IAEnB,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IAChF,IAAI,WAAW,EAAE,IAAI,EAAE,IAAI;QAAE,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;IAE1D,MAAM,YAAY,GAAG,UAAU,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC;IACtE,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAsB,EAAE;IACvD,gFAAgF;IAChF,MAAM,WAAW,GAAG,mBAAmB,EAAE,CAAC;IAE1C,MAAM,WAAW,GAAG,UAAU,CAAC,YAAY,CAAC;QAC1C,CAAC,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC;QACrC,CAAC,CAAC,EAAE,CAAC;IAEP,+FAA+F;IAC/F,iFAAiF;IACjF,gFAAgF;IAChF,MAAM,aAAa,GAAG,aAAa,CAAC;QAClC,WAAW,EAAE,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;QACzD,cAAc,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG;QACrC,cAAc,EAAE,UAAU,CAAC,WAAW,EAAE,qBAAqB,CAAC,IAAI,SAAS;QAC3E,QAAQ,EAAE,uBAAuB;KAClC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC;IAEjC,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAC3D,4EAA4E;IAC5E,uEAAuE;IACvE,4EAA4E;IAC5E,2DAA2D;IAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE,GAAG,EAAE,IAAI,IAAI,IAAI,CAAC;IAC/D,MAAM,aAAa,GACjB,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACvE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,CAAC,IAAI,aAAa,GAAG,KAAK,EAAE,CAAC;QACnF,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;IACzC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,WAAW,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;IAE/E,+EAA+E;IAC/E,iDAAiD;IACjD,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,sBAAsB,CACvC,aAAa,EACb,0BAA0B,EAC1B,SAAS,CACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5E,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,IAAI,UAAU,KAAK,aAAa,EAAE,CAAC;QACjC,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAChE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,yEAAyE;IACzE,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,WAAW,GAAwD,IAAI,CAAC;IAE5E,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,KAAK,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;YAC3C,WAAW,GAAG,MAAM,gBAAgB,CAAC;gBACnC,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,MAAM;gBACjB,QAAQ;gBACR,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;YACH,QAAQ,GAAG,oBAAoB,SAAS,EAAE,CAAC;YAC3C,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;YAC5C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,yBAAyB,IAAI,CAAC,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,gEAAgE;IAChE,MAAM,eAAe,GAAG,QAAQ,IAAI,MAAM,CAAC;IAC3C,MAAM,SAAS,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAEtD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CACT,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,UAAU,EAAE,CAAC,EAAE,CACzF,CAAC;IACF,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CACT,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAClG,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CACT,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CACjG,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAEhF,4EAA4E;IAC5E,wEAAwE;IACxE,2EAA2E;IAC3E,wEAAwE;IACxE,IACE,aAAa,CAAC,MAAM,KAAK,SAAS;QAClC,WAAW,EAAE,GAAG,EAAE,GAAG;QACrB,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,aAAa,CAAC,GAAG,EACzC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,yBAAyB,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,mEAAmE;IACnE,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAElD,0EAA0E;IAC1E,MAAM,GAAG,GAA2B;QAClC,GAAI,OAAO,CAAC,GAA8B;QAC1C,mBAAmB,EAAE,eAAe;QACpC,qBAAqB,EAAE,QAAQ;QAC/B,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC;QACxB,IAAI,EAAE,IAAI;KACX,CAAC;IAEF,mBAAmB;IACnB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE;YAChD,KAAK,EAAE,SAAS;YAChB,GAAG;SACJ,CAAC,CAAC;QAEH,oDAAoD;QACpD,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;YACxD,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1B,IAAI,WAAW;gBAAE,WAAW,CAAC,KAAK,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE/B,MAAM,UAAU,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,IAAI,WAAW;YAAE,WAAW,CAAC,KAAK,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAI,KAA+B,CAAC,QAAQ,CAAC;QAC3D,IAAI,QAAQ,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;YACnD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YACjE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/commands/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/commands/env.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,wBAAsB,cAAc,kBAsCnC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,iBAgEhD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,iBAyChD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,kBA4CvC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,iBA4B/D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,iBAyCnD"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/commands/env.ts"],"names":[],"mappings":"AAkBA;;GAEG;AACH,wBAAsB,cAAc,kBAsCnC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,iBAgEhD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,iBAkDhD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,kBA4CvC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,iBA4B/D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,iBAyCnD"}

package/dist/commands/env.js

@@ -2,6 +2,8 @@ import { input, select, confirm } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { existsSync, writeFileSync } from 'fs';
 import { listProfiles, getActiveProfile, getProfile, addProfile, setActiveProfile, deleteProfile, generateEnvContent, setProfileVariable, getProjectShopSlug, } from '../lib/env-storage.js';
+import { readLocalConfigSync } from '../lib/config.js';
+import { t } from '../lib/i18n.js';
 /**
  * List all environment profiles
  */
@@ -124,7 +126,15 @@ export async function envUseCommand(name) {
             : chalk.gray('not logged in');
         console.log(chalk.green(`\n✔ Switched to profile "${profile.name}"`));
         console.log(chalk.gray(`  API:     ${profile.apiUrl}`));
-        console.log(chalk.gray(`  Account: ${accountInfo}\n`));
+        console.log(chalk.gray(`  Account: ${accountInfo}`));
+        // Warn when the local project config carries a different api.url — the
+        // profile wins for dev/inspect/proxy, which used to silently surprise
+        // developers who expected doswiftly.config.ts to always be authoritative.
+        const localConfig = readLocalConfigSync();
+        if (localConfig?.api?.url && localConfig.api.url !== profile.apiUrl) {
+            console.log(chalk.gray(`  ℹ ${t().envProfileOverridesConfig}`));
+        }
+        console.log('');
     }
     catch (error) {
         console.error(chalk.red(`\n✖ ${error.message}\n`));