@contentful/experience-design-system-cli 2.37.1-dev-build-97678ad0.0 → 2.37.1-dev-build-f86ffbb8.0

package/dist/app.js

@@ -1,5 +1,5 @@
 // packages/experience-design-system-cli/app.tsx
-import { useEffect as useEffect9, useState as useState12 } from "react";
+import { useEffect as useEffect9, useState as useState13 } from "react";
 
 // packages/experience-design-system-cli/src/tui/home/home.tsx
 import { useEffect as useEffect2, useState as useState2 } from "react";
@@ -705,6 +705,219 @@ function PathValidationScreen({
   ] });
 }
 
+// packages/experience-design-system-cli/src/tui/import/steps/04-credentials/screen.tsx
+import { useRef, useState as useState6 } from "react";
+import { Box as Box6, Text as Text7 } from "ink";
+import TextInput3 from "ink-text-input";
+
+// packages/experience-design-system-cli/src/tui/import/steps/04-credentials/controls.ts
+import { useInput as useInput6 } from "ink";
+
+// packages/experience-design-system-cli/src/tui/import/steps/04-credentials/logic.ts
+var FIELDS = ["spaceId", "environmentId", "cmaToken", "host"];
+var DEFAULT_HOST = "api.contentful.com";
+function keyAction2(input, key) {
+  if (key.escape) return "back";
+  if (key.tab) return "next-field";
+  if (key.ctrl && input === "s") return "skip";
+  return null;
+}
+function nextField(field) {
+  return FIELDS[(FIELDS.indexOf(field) + 1) % FIELDS.length];
+}
+function toConfiguredHost(host) {
+  const value = (host ?? "").trim().replace(/\/+$/, "");
+  return value === "" ? DEFAULT_HOST : value.replace(/^https:\/\//i, "");
+}
+function toApiHost(host) {
+  const value = host.trim().replace(/\/+$/, "");
+  if (value === "") return `https://${DEFAULT_HOST}`;
+  return /^[a-z][a-z\d+\-.]*:\/\//i.test(value) ? value : `https://${value}`;
+}
+function normalize(values) {
+  return {
+    spaceId: values.spaceId.trim(),
+    environmentId: values.environmentId.trim(),
+    cmaToken: values.cmaToken.trim(),
+    host: toConfiguredHost(values.host)
+  };
+}
+function missingField(values) {
+  return values.spaceId === "" || values.environmentId === "" || values.cmaToken === "";
+}
+function isUnchanged(current, initial) {
+  return FIELDS.every((field) => current[field] === initial[field]);
+}
+
+// packages/experience-design-system-cli/src/tui/import/steps/04-credentials/controls.ts
+var CREDENTIALS_CONTROLS = [
+  { keys: "Enter", label: "Next field / Continue" },
+  { keys: "Tab", label: "Switch field" },
+  { keys: "Ctrl+S", label: "Skip (no push)" },
+  { keys: "Esc", label: "Back" }
+];
+function useCredentialsControls(handlers) {
+  useInput6((input, key) => {
+    if (handlers.disabled) return;
+    const action = keyAction2(input, key);
+    if (action === "back") handlers.onBack();
+    else if (action === "next-field") handlers.onNextField();
+    else if (action === "skip") handlers.onSkip();
+  });
+}
+
+// packages/experience-design-system-cli/src/tui/import/steps/04-credentials/validate.ts
+var USER_AGENT = "app contentful.experience-design-system-cli";
+function headers(token) {
+  return { Authorization: `Bearer ${token}`, "X-Contentful-User-Agent": USER_AGENT };
+}
+function isApsDenial(body) {
+  try {
+    const id = JSON.parse(body).sys?.id;
+    return id === "NotFound" || id === "AccessDenied";
+  } catch {
+    return false;
+  }
+}
+function messageFrom(body) {
+  try {
+    const message = JSON.parse(body).message;
+    return typeof message === "string" && message !== "" ? message : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function validateCredentials(values) {
+  const base = toApiHost(values.host);
+  let me;
+  try {
+    me = await fetch(`${base}/users/me`, { headers: headers(values.cmaToken) });
+  } catch (error) {
+    return { ok: false, error: `Could not reach ${base}: ${error instanceof Error ? error.message : String(error)}` };
+  }
+  if (me.status === 401) return { ok: false, error: "CMA token is invalid or revoked." };
+  if (!me.ok) return { ok: false, error: `Unexpected error validating the token (${me.status}).` };
+  let preflight;
+  try {
+    preflight = await fetch(
+      `${base}/spaces/${values.spaceId}/environments/${values.environmentId}/design_systems/preflight`,
+      { headers: headers(values.cmaToken) }
+    );
+  } catch {
+    return { ok: true };
+  }
+  if (preflight.ok || preflight.status >= 500) return { ok: true };
+  const body = await preflight.text();
+  if (preflight.status === 404 && !isApsDenial(body)) return { ok: true };
+  const detail = messageFrom(body);
+  if (preflight.status === 403) {
+    return { ok: false, error: `Access denied. ${detail ?? "Your token cannot write design system components here."}` };
+  }
+  if (preflight.status === 404) {
+    return {
+      ok: false,
+      error: `Not found. Check the space ID, environment and API host.${detail ? ` (${detail})` : ""}`
+    };
+  }
+  return { ok: false, error: `Credential check failed (${preflight.status}).${detail ? ` ${detail}` : ""}` };
+}
+
+// packages/experience-design-system-cli/src/tui/import/steps/04-credentials/screen.tsx
+import { Fragment, jsx as jsx7, jsxs as jsxs6 } from "react/jsx-runtime";
+var LABELS = {
+  spaceId: "Space ID",
+  environmentId: "Environment",
+  cmaToken: "CMA Token",
+  host: "API Host"
+};
+function CredentialsScreen({
+  onDone,
+  onBack,
+  initial = {},
+  validate = validateCredentials
+}) {
+  const initialValues = useRef(
+    normalize({
+      spaceId: initial.spaceId ?? "",
+      environmentId: initial.environmentId || "master",
+      cmaToken: initial.cmaToken ?? "",
+      host: initial.host ?? ""
+    })
+  ).current;
+  const [values, setValues] = useState6(initialValues);
+  const [active, setActive] = useState6("spaceId");
+  const [error, setError] = useState6(null);
+  const [validating, setValidating] = useState6(false);
+  const prefilled = initialValues.spaceId !== "" && initialValues.cmaToken !== "";
+  useCredentialsControls({
+    disabled: validating,
+    onBack,
+    onNextField: () => setActive(nextField),
+    onSkip: () => onDone({ skipped: true })
+  });
+  const change = (field) => (value) => {
+    setValues((current) => ({ ...current, [field]: value }));
+    setError(null);
+  };
+  const submit = async (field) => {
+    if (field !== "host") {
+      setActive(nextField(field));
+      return;
+    }
+    const credentials = normalize(values);
+    if (missingField(credentials)) {
+      setError("Space ID, environment and CMA token are all required.");
+      return;
+    }
+    setValidating(true);
+    const result = await validate(credentials);
+    setValidating(false);
+    if (result.ok) onDone({ skipped: false, credentials });
+    else setError(result.error);
+  };
+  return /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", gap: 1, paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx7(Text7, { bold: true, children: "Contentful credentials" }),
+      /* @__PURE__ */ jsx7(Text7, { children: prefilled ? "Credentials pre-filled from the configuration settings." : "Enter the Contentful space you want to import into." }),
+      !prefilled && /* @__PURE__ */ jsxs6(Fragment, { children: [
+        /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "Used to align suggestions with what already exists in the space and to push your import at the end. Skipping runs without space context and disables push." }),
+        /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "Tip: save these under Settings \u2192 Configuration so they pre-fill here." })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx7(Box6, { flexDirection: "column", children: FIELDS.map((field) => /* @__PURE__ */ jsxs6(Box6, { gap: 1, children: [
+      /* @__PURE__ */ jsx7(Text7, { color: active === field ? PALETTE.accent : void 0, children: "?" }),
+      /* @__PURE__ */ jsxs6(Text7, { bold: active === field, children: [
+        LABELS[field],
+        ":"
+      ] }),
+      /* @__PURE__ */ jsx7(
+        TextInput3,
+        {
+          value: values[field],
+          focus: active === field && !validating,
+          mask: field === "cmaToken" ? "\u2022" : void 0,
+          placeholder: field === "host" ? DEFAULT_HOST : void 0,
+          onChange: change(field),
+          onSubmit: () => void submit(field)
+        }
+      )
+    ] }, field)) }),
+    active === "host" && /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "Default: api.contentful.com \xB7 EU spaces: api.eu.contentful.com" }),
+    error && /* @__PURE__ */ jsxs6(Text7, { color: PALETTE.error, children: [
+      "\u2717 ",
+      error
+    ] }),
+    validating && /* @__PURE__ */ jsx7(Text7, { color: PALETTE.accent, children: "Validating credentials..." }),
+    !validating && !error && !isUnchanged(normalize(values), initialValues) && /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "Changed values are saved after they validate." }),
+    /* @__PURE__ */ jsx7(Box6, { marginTop: 1, gap: 3, children: CREDENTIALS_CONTROLS.map((control) => /* @__PURE__ */ jsxs6(Text7, { dimColor: true, children: [
+      "[",
+      control.keys,
+      "] ",
+      control.label
+    ] }, control.keys)) })
+  ] });
+}
+
 // packages/experience-design-system-cli/src/tui/import/spawn-v1-import.ts
 import { spawn } from "node:child_process";
 
@@ -742,7 +955,8 @@ async function spawnV1Import(options = {}) {
   const args = buildArgs(options);
   return new Promise((resolvePromise) => {
     const child = spawn("node", [cliPath, ...args], {
-      stdio: "inherit"
+      stdio: "inherit",
+      env: options.skipCredentials ? { ...process.env, EDS_IMPORT_SKIP_CREDENTIALS: "1" } : process.env
     });
     child.on("close", (code) => {
       resolvePromise({ exitCode: code ?? 1, result: void 0, stdout: "", stderr: "" });
@@ -772,8 +986,8 @@ function startReadingTerminal() {
 }
 
 // packages/experience-design-system-cli/src/tui/help/PageContainer.tsx
-import { useEffect as useEffect4, useState as useState6 } from "react";
-import { Box as Box6, Text as Text7, useInput as useInput6 } from "ink";
+import { useEffect as useEffect4, useState as useState7 } from "react";
+import { Box as Box7, Text as Text8, useInput as useInput7 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/debug-store.ts
 import { mkdir as mkdir2, writeFile as writeFile2 } from "node:fs/promises";
@@ -983,18 +1197,18 @@ async function readHelpInfo() {
 }
 
 // packages/experience-design-system-cli/src/tui/help/PageContainer.tsx
-import { Fragment, jsx as jsx7, jsxs as jsxs6 } from "react/jsx-runtime";
+import { Fragment as Fragment2, jsx as jsx8, jsxs as jsxs7 } from "react/jsx-runtime";
 function Section({ title, rows }) {
-  return /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx7(Text7, { bold: true, color: PALETTE.accent, children: title }),
-    rows.map((row) => /* @__PURE__ */ jsxs6(Box6, { gap: 1, children: [
-      /* @__PURE__ */ jsx7(Box6, { width: 14, flexShrink: 0, children: /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: row.label }) }),
-      /* @__PURE__ */ jsx7(Text7, { children: row.value })
+  return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx8(Text8, { bold: true, color: PALETTE.accent, children: title }),
+    rows.map((row) => /* @__PURE__ */ jsxs7(Box7, { gap: 1, children: [
+      /* @__PURE__ */ jsx8(Box7, { width: 14, flexShrink: 0, children: /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: row.label }) }),
+      /* @__PURE__ */ jsx8(Text8, { children: row.value })
     ] }, row.label))
   ] });
 }
 function HelpScreen({ onDone }) {
-  const [info, setInfo] = useState6();
+  const [info, setInfo] = useState7();
   useEffect4(() => {
     startDebugRun({ flow: "help", step: "01-help", menuOption: "Help", inputs: {} });
     void readHelpInfo().then(setInfo);
@@ -1003,7 +1217,7 @@ function HelpScreen({ onDone }) {
     void finishDebugRun({ outputs: {}, status: "success", exitMethod });
     onDone();
   };
-  useInput6((input, key) => {
+  useInput7((input, key) => {
     if (key.return) {
       leave("saved");
       return;
@@ -1013,14 +1227,14 @@ function HelpScreen({ onDone }) {
       return;
     }
   });
-  return /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", paddingX: 2, paddingY: 1, gap: 1, children: [
-    /* @__PURE__ */ jsx7(Text7, { bold: true, children: "Help" }),
-    info ? /* @__PURE__ */ jsxs6(Fragment, { children: [
-      /* @__PURE__ */ jsx7(Section, { title: "Where things are stored", rows: info.storage }),
-      /* @__PURE__ */ jsx7(Section, { title: "Troubleshooting", rows: info.troubleshooting }),
-      /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "Hit a problem? Turn on Debug Mode in Settings, reproduce it, then share the session folder above. The CMA token is redacted from those logs." })
-    ] }) : /* @__PURE__ */ jsx7(Text7, { color: PALETTE.accent, children: "Loading..." }),
-    /* @__PURE__ */ jsx7(
+  return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", paddingX: 2, paddingY: 1, gap: 1, children: [
+    /* @__PURE__ */ jsx8(Text8, { bold: true, children: "Help" }),
+    info ? /* @__PURE__ */ jsxs7(Fragment2, { children: [
+      /* @__PURE__ */ jsx8(Section, { title: "Where things are stored", rows: info.storage }),
+      /* @__PURE__ */ jsx8(Section, { title: "Troubleshooting", rows: info.troubleshooting }),
+      /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: "Hit a problem? Turn on Debug Mode in Settings, reproduce it, then share the session folder above. The CMA token is redacted from those logs." })
+    ] }) : /* @__PURE__ */ jsx8(Text8, { color: PALETTE.accent, children: "Loading..." }),
+    /* @__PURE__ */ jsx8(
       ControlHints,
       {
         hints: [
@@ -1033,20 +1247,20 @@ function HelpScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/PageContainer.tsx
-import { useState as useState7 } from "react";
-import { Box as Box7, Text as Text8, useInput as useInput7 } from "ink";
-import { jsx as jsx8, jsxs as jsxs7 } from "react/jsx-runtime";
+import { useState as useState8 } from "react";
+import { Box as Box8, Text as Text9, useInput as useInput8 } from "ink";
+import { jsx as jsx9, jsxs as jsxs8 } from "react/jsx-runtime";
 function SettingsScreen({
   onNavigate,
   onBack
 }) {
-  const [focusIdx, setFocusIdx] = useState7(0);
+  const [focusIdx, setFocusIdx] = useState8(0);
   const items = [
     { label: "Configuration", screen: "settings-configuration" },
     { label: "Opt-in Analytics", screen: "settings-opt-in-analytics" },
     { label: "Debug Mode", screen: "settings-debug-mode" }
   ];
-  useInput7((input, key) => {
+  useInput8((input, key) => {
     if (key.upArrow) {
       setFocusIdx((i) => (i - 1 + items.length) % items.length);
       return;
@@ -1066,15 +1280,15 @@ function SettingsScreen({
       onBack();
     }
   });
-  return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx8(Text8, { bold: true, children: "Settings" }),
-    /* @__PURE__ */ jsx8(Text8, { children: " " }),
-    items.map((item, i) => /* @__PURE__ */ jsxs7(Text8, { color: i === focusIdx ? "cyan" : void 0, children: [
+  return /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx9(Text9, { bold: true, children: "Settings" }),
+    /* @__PURE__ */ jsx9(Text9, { children: " " }),
+    items.map((item, i) => /* @__PURE__ */ jsxs8(Text9, { color: i === focusIdx ? "cyan" : void 0, children: [
       i === focusIdx ? "> " : "  ",
       item.label
     ] }, item.label)),
-    /* @__PURE__ */ jsx8(Text8, { children: " " }),
-    /* @__PURE__ */ jsx8(
+    /* @__PURE__ */ jsx9(Text9, { children: " " }),
+    /* @__PURE__ */ jsx9(
       ControlHints,
       {
         hints: [
@@ -1088,9 +1302,9 @@ function SettingsScreen({
 }
 
 // packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx
-import { useEffect as useEffect5, useState as useState8 } from "react";
-import { Box as Box8, Text as Text9, useInput as useInput8 } from "ink";
-import TextInput3 from "ink-text-input";
+import { useEffect as useEffect5, useState as useState9 } from "react";
+import { Box as Box9, Text as Text10, useInput as useInput9 } from "ink";
+import TextInput4 from "ink-text-input";
 
 // packages/experience-design-system-cli/src/tui/settings/utils/v1-store.ts
 var readV1Store = readSettings;
@@ -1121,7 +1335,7 @@ async function writeCredentials(config) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx
-import { Fragment as Fragment2, jsx as jsx9, jsxs as jsxs8 } from "react/jsx-runtime";
+import { Fragment as Fragment3, jsx as jsx10, jsxs as jsxs9 } from "react/jsx-runtime";
 var FIELD_ORDER = [
   "spaceId",
   "environmentId",
@@ -1149,13 +1363,13 @@ var FIELD_LABELS = {
   defaultTokenFile: "Default token file (optional)"
 };
 function ConfigurationScreen({ onDone }) {
-  const [stage, setStage] = useState8("loading");
-  const [config, setConfig] = useState8(null);
-  const [activeField, setActiveField] = useState8("spaceId");
-  const [notice, setNotice] = useState8(null);
-  const [lastSaved, setLastSaved] = useState8(null);
-  const [editing, setEditing] = useState8(false);
-  const [valueBeforeEdit, setValueBeforeEdit] = useState8("");
+  const [stage, setStage] = useState9("loading");
+  const [config, setConfig] = useState9(null);
+  const [activeField, setActiveField] = useState9("spaceId");
+  const [notice, setNotice] = useState9(null);
+  const [lastSaved, setLastSaved] = useState9(null);
+  const [editing, setEditing] = useState9(false);
+  const [valueBeforeEdit, setValueBeforeEdit] = useState9("");
   useEffect5(() => {
     readCredentials().then((cfg) => {
       setConfig(cfg);
@@ -1196,7 +1410,7 @@ function ConfigurationScreen({ onDone }) {
     );
     onDone();
   }
-  useInput8((input, key) => {
+  useInput9((input, key) => {
     if (stage === "loading" || stage === "saving") return;
     if (editing) {
       if (key.escape) {
@@ -1233,46 +1447,46 @@ function ConfigurationScreen({ onDone }) {
     }
   });
   if (stage === "loading") {
-    return /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-      /* @__PURE__ */ jsx9(Text9, { bold: true, children: "Configuration" }),
-      /* @__PURE__ */ jsx9(Text9, { children: " " }),
-      /* @__PURE__ */ jsx9(Text9, { color: PALETTE.accent, children: "Loading..." })
+    return /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+      /* @__PURE__ */ jsx10(Text10, { bold: true, children: "Configuration" }),
+      /* @__PURE__ */ jsx10(Text10, { children: " " }),
+      /* @__PURE__ */ jsx10(Text10, { color: PALETTE.accent, children: "Loading..." })
     ] });
   }
-  return /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx9(Text9, { bold: true, children: "Configuration" }),
-    /* @__PURE__ */ jsx9(Text9, { children: " " }),
-    /* @__PURE__ */ jsx9(Box8, { flexDirection: "column", children: FIELD_ORDER.map((field) => {
+  return /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx10(Text10, { bold: true, children: "Configuration" }),
+    /* @__PURE__ */ jsx10(Text10, { children: " " }),
+    /* @__PURE__ */ jsx10(Box9, { flexDirection: "column", children: FIELD_ORDER.map((field) => {
       const isActive = activeField === field;
       const value = fieldValue(field);
       const display = field === "cmaToken" ? "\u2022".repeat(value.length) : value;
-      return /* @__PURE__ */ jsxs8(Box8, { gap: 1, children: [
-        /* @__PURE__ */ jsx9(Text9, { color: isActive ? PALETTE.accent : void 0, children: isActive ? "\u276F" : " " }),
-        /* @__PURE__ */ jsxs8(Text9, { bold: isActive, children: [
+      return /* @__PURE__ */ jsxs9(Box9, { gap: 1, children: [
+        /* @__PURE__ */ jsx10(Text10, { color: isActive ? PALETTE.accent : void 0, children: isActive ? "\u276F" : " " }),
+        /* @__PURE__ */ jsxs9(Text10, { bold: isActive, children: [
           FIELD_LABELS[field],
           ":"
         ] }),
-        isActive && editing ? /* @__PURE__ */ jsx9(
-          TextInput3,
+        isActive && editing ? /* @__PURE__ */ jsx10(
+          TextInput4,
           {
             value,
             onChange: (next) => setFieldValue(field, next),
             onSubmit: () => setEditing(false),
             mask: field === "cmaToken" ? "\u2022" : void 0
           }
-        ) : /* @__PURE__ */ jsx9(Text9, { children: display || /* @__PURE__ */ jsx9(Text9, { dimColor: true, children: "(empty)" }) })
+        ) : /* @__PURE__ */ jsx10(Text10, { children: display || /* @__PURE__ */ jsx10(Text10, { dimColor: true, children: "(empty)" }) })
       ] }, field);
     }) }),
-    notice && /* @__PURE__ */ jsxs8(Fragment2, { children: [
-      /* @__PURE__ */ jsx9(Text9, { children: " " }),
-      /* @__PURE__ */ jsxs8(Text9, { color: notice.kind === "success" ? PALETTE.success : PALETTE.error, children: [
+    notice && /* @__PURE__ */ jsxs9(Fragment3, { children: [
+      /* @__PURE__ */ jsx10(Text10, { children: " " }),
+      /* @__PURE__ */ jsxs9(Text10, { color: notice.kind === "success" ? PALETTE.success : PALETTE.error, children: [
         notice.kind === "success" ? "\u2713" : "\u2717",
         " ",
         notice.text
       ] })
     ] }),
-    /* @__PURE__ */ jsx9(Text9, { children: " " }),
-    /* @__PURE__ */ jsx9(
+    /* @__PURE__ */ jsx10(Text10, { children: " " }),
+    /* @__PURE__ */ jsx10(
       ControlHints,
       {
         hints: editing ? [
@@ -1293,8 +1507,8 @@ function ConfigurationScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
-import { useEffect as useEffect6, useState as useState9 } from "react";
-import { Box as Box9, Text as Text10, useInput as useInput9 } from "ink";
+import { useEffect as useEffect6, useState as useState10 } from "react";
+import { Box as Box10, Text as Text11, useInput as useInput10 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/analytics-store.ts
 async function readAnalyticsSetting() {
@@ -1312,10 +1526,10 @@ async function writeAnalyticsSetting(setting) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
-import { Fragment as Fragment3, jsx as jsx10, jsxs as jsxs9 } from "react/jsx-runtime";
+import { Fragment as Fragment4, jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
 function OptInAnalyticsScreen({ onDone }) {
-  const [loading, setLoading] = useState9(true);
-  const [enabled, setEnabled] = useState9(true);
+  const [loading, setLoading] = useState10(true);
+  const [enabled, setEnabled] = useState10(true);
   useEffect6(() => {
     readAnalyticsSetting().then((setting) => {
       setEnabled(setting.enabled);
@@ -1328,7 +1542,7 @@ function OptInAnalyticsScreen({ onDone }) {
       });
     });
   }, []);
-  useInput9((input, key) => {
+  useInput10((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -1343,21 +1557,21 @@ function OptInAnalyticsScreen({ onDone }) {
       onDone();
     }
   });
-  return /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx10(Text10, { bold: true, children: "Settings \u203A Opt-in Analytics" }),
-    /* @__PURE__ */ jsx10(Text10, { children: " " }),
-    loading ? /* @__PURE__ */ jsx10(Text10, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs9(Fragment3, { children: [
-      /* @__PURE__ */ jsxs9(Text10, { children: [
+  return /* @__PURE__ */ jsxs10(Box10, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx11(Text11, { bold: true, children: "Settings \u203A Opt-in Analytics" }),
+    /* @__PURE__ */ jsx11(Text11, { children: " " }),
+    loading ? /* @__PURE__ */ jsx11(Text11, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs10(Fragment4, { children: [
+      /* @__PURE__ */ jsxs10(Text11, { children: [
         "Share anonymous usage data:",
         " ",
-        /* @__PURE__ */ jsx10(Text10, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
+        /* @__PURE__ */ jsx11(Text11, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
       ] }),
-      /* @__PURE__ */ jsx10(Text10, { children: " " }),
-      /* @__PURE__ */ jsx10(Text10, { dimColor: true, children: "Shares which CLI commands are used and where imports succeed or fail." }),
-      /* @__PURE__ */ jsx10(Text10, { dimColor: true, children: "Never includes source code, file paths, credentials, or authored content." })
+      /* @__PURE__ */ jsx11(Text11, { children: " " }),
+      /* @__PURE__ */ jsx11(Text11, { dimColor: true, children: "Shares which CLI commands are used and where imports succeed or fail." }),
+      /* @__PURE__ */ jsx11(Text11, { dimColor: true, children: "Never includes source code, file paths, credentials, or authored content." })
     ] }),
-    /* @__PURE__ */ jsx10(Text10, { children: " " }),
-    /* @__PURE__ */ jsx10(
+    /* @__PURE__ */ jsx11(Text11, { children: " " }),
+    /* @__PURE__ */ jsx11(
       ControlHints,
       {
         hints: [
@@ -1370,12 +1584,12 @@ function OptInAnalyticsScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/upgrade/PageContainer.tsx
-import { useEffect as useEffect7, useState as useState10 } from "react";
-import { Box as Box10, Text as Text11, useInput as useInput10 } from "ink";
-import { jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
+import { useEffect as useEffect7, useState as useState11 } from "react";
+import { Box as Box11, Text as Text12, useInput as useInput11 } from "ink";
+import { jsx as jsx12, jsxs as jsxs11 } from "react/jsx-runtime";
 var UPGRADE_COMMANDS = ["git pull", "pnpm install", "pnpm build"];
 function UpgradeScreen({ onDone }) {
-  const [upgradeCheck, setUpgradeCheck] = useState10();
+  const [upgradeCheck, setUpgradeCheck] = useState11();
   useEffect7(() => {
     startDebugRun({
       flow: "upgrade",
@@ -1385,7 +1599,7 @@ function UpgradeScreen({ onDone }) {
     });
     checkForUpgrade().then(setUpgradeCheck).catch(() => setUpgradeCheck({ status: "error" }));
   }, []);
-  useInput10((_input, key) => {
+  useInput11((_input, key) => {
     if (key.return) {
       void finishDebugRun({
         outputs: upgradeCheck ?? {},
@@ -1396,12 +1610,12 @@ function UpgradeScreen({ onDone }) {
       return;
     }
   });
-  return /* @__PURE__ */ jsxs10(Box10, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx11(Text11, { bold: true, children: "Upgrade" }),
-    /* @__PURE__ */ jsx11(Text11, { children: " " }),
+  return /* @__PURE__ */ jsxs11(Box11, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx12(Text12, { bold: true, children: "Upgrade" }),
+    /* @__PURE__ */ jsx12(Text12, { children: " " }),
     renderBody(upgradeCheck),
-    /* @__PURE__ */ jsx11(Text11, { children: " " }),
-    /* @__PURE__ */ jsxs10(Text11, { bold: true, color: PALETTE.accent, children: [
+    /* @__PURE__ */ jsx12(Text12, { children: " " }),
+    /* @__PURE__ */ jsxs11(Text12, { bold: true, color: PALETTE.accent, children: [
       FOCUS_MARKER,
       " Go Back"
     ] })
@@ -1409,44 +1623,44 @@ function UpgradeScreen({ onDone }) {
 }
 function renderBody(upgradeCheck) {
   if (!upgradeCheck) {
-    return /* @__PURE__ */ jsx11(Text11, { color: PALETTE.muted, children: "Checking for updates\u2026" });
+    return /* @__PURE__ */ jsx12(Text12, { color: PALETTE.muted, children: "Checking for updates\u2026" });
   }
   if (upgradeCheck.status === "error") {
-    return /* @__PURE__ */ jsx11(Text11, { color: PALETTE.warning, children: "Couldn't check for updates \u2014 check your network connection and try again." });
+    return /* @__PURE__ */ jsx12(Text12, { color: PALETTE.warning, children: "Couldn't check for updates \u2014 check your network connection and try again." });
   }
   if (upgradeCheck.status === "up-to-date") {
-    return /* @__PURE__ */ jsxs10(Text11, { color: PALETTE.success, children: [
+    return /* @__PURE__ */ jsxs11(Text12, { color: PALETTE.success, children: [
       "You're already on the latest version (v",
       upgradeCheck.current,
       ")."
     ] });
   }
-  return /* @__PURE__ */ jsxs10(Box10, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs10(Text11, { color: PALETTE.muted, children: [
-      /* @__PURE__ */ jsxs10(Text11, { bold: true, color: PALETTE.success, children: [
+  return /* @__PURE__ */ jsxs11(Box11, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs11(Text12, { color: PALETTE.muted, children: [
+      /* @__PURE__ */ jsxs11(Text12, { bold: true, color: PALETTE.success, children: [
         "v",
         upgradeCheck.latest
       ] }),
       " ",
       "is available (you're on ",
-      /* @__PURE__ */ jsxs10(Text11, { bold: true, children: [
+      /* @__PURE__ */ jsxs11(Text12, { bold: true, children: [
         "v",
         upgradeCheck.current
       ] }),
       "). Exit this program, cd into the root of your local clone of contentful/experience-design-system-sdk-public, then run:"
     ] }),
-    /* @__PURE__ */ jsx11(Text11, { children: " " }),
-    /* @__PURE__ */ jsx11(Box10, { flexDirection: "column", borderStyle: "round", borderColor: PALETTE.border, paddingX: 1, children: UPGRADE_COMMANDS.map((cmd) => /* @__PURE__ */ jsx11(Text11, { bold: true, children: cmd }, cmd)) })
+    /* @__PURE__ */ jsx12(Text12, { children: " " }),
+    /* @__PURE__ */ jsx12(Box11, { flexDirection: "column", borderStyle: "round", borderColor: PALETTE.border, paddingX: 1, children: UPGRADE_COMMANDS.map((cmd) => /* @__PURE__ */ jsx12(Text12, { bold: true, children: cmd }, cmd)) })
   ] });
 }
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect8, useState as useState11 } from "react";
-import { Box as Box11, Text as Text12, useInput as useInput11 } from "ink";
-import { jsx as jsx12, jsxs as jsxs11 } from "react/jsx-runtime";
+import { useEffect as useEffect8, useState as useState12 } from "react";
+import { Box as Box12, Text as Text13, useInput as useInput12 } from "ink";
+import { jsx as jsx13, jsxs as jsxs12 } from "react/jsx-runtime";
 function DebugModeScreen({ onDone }) {
-  const [loading, setLoading] = useState11(true);
-  const [enabled, setEnabled] = useState11(true);
+  const [loading, setLoading] = useState12(true);
+  const [enabled, setEnabled] = useState12(true);
   useEffect8(() => {
     readDebugModeSetting().then((setting) => {
       setEnabled(setting.enabled);
@@ -1459,7 +1673,7 @@ function DebugModeScreen({ onDone }) {
       });
     });
   }, []);
-  useInput11((input, key) => {
+  useInput12((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -1474,16 +1688,16 @@ function DebugModeScreen({ onDone }) {
       onDone();
     }
   });
-  return /* @__PURE__ */ jsxs11(Box11, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx12(Text12, { bold: true, children: "Settings \u203A Debug Mode" }),
-    /* @__PURE__ */ jsx12(Text12, { children: " " }),
-    loading ? /* @__PURE__ */ jsx12(Text12, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs11(Text12, { children: [
+  return /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx13(Text13, { bold: true, children: "Settings \u203A Debug Mode" }),
+    /* @__PURE__ */ jsx13(Text13, { children: " " }),
+    loading ? /* @__PURE__ */ jsx13(Text13, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs12(Text13, { children: [
       "Debug logging:",
       " ",
-      /* @__PURE__ */ jsx12(Text12, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
+      /* @__PURE__ */ jsx13(Text13, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
     ] }),
-    /* @__PURE__ */ jsx12(Text12, { children: " " }),
-    /* @__PURE__ */ jsx12(
+    /* @__PURE__ */ jsx13(Text13, { children: " " }),
+    /* @__PURE__ */ jsx13(
       ControlHints,
       {
         hints: [
@@ -1496,28 +1710,38 @@ function DebugModeScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/app.tsx
-import { Fragment as Fragment4, jsx as jsx13 } from "react/jsx-runtime";
+import { Fragment as Fragment5, jsx as jsx14 } from "react/jsx-runtime";
 function App({ onLaunchImport, importExitCode }) {
   const returnedFromImport = importExitCode !== void 0;
-  const [screen, setScreen] = useState12(returnedFromImport ? "import" : "start");
-  const [showImportResult, setShowImportResult] = useState12(returnedFromImport);
-  const [projectPath, setProjectPath] = useState12();
-  const [tokensPath, setTokensPath] = useState12();
-  const [importDefaults, setImportDefaults] = useState12();
+  const [screen, setScreen] = useState13(returnedFromImport ? "import" : "start");
+  const [showImportResult, setShowImportResult] = useState13(returnedFromImport);
+  const [projectPath, setProjectPath] = useState13();
+  const [tokensPath, setTokensPath] = useState13();
+  const [pathConfirmed, setPathConfirmed] = useState13(false);
+  const [importDefaults, setImportDefaults] = useState13();
   useEffect9(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
     }
     void readCredentials().then(
-      (saved) => setImportDefaults({ componentDir: saved.defaultComponentDir ?? "", tokenFile: saved.defaultTokenFile ?? "" })
+      (saved) => setImportDefaults({
+        componentDir: saved.defaultComponentDir ?? "",
+        tokenFile: saved.defaultTokenFile ?? "",
+        credentials: saved
+      })
     );
   }, [screen]);
+  const finishCredentials = async (result, project, tokens) => {
+    if (!result.skipped) await writeCredentials({ ...result.credentials });
+    onLaunchImport?.({ project, tokens, skipCredentials: result.skipped });
+  };
   const goToStart = () => setScreen("start");
   const goToSettings = () => setScreen("settings");
   const resetImport = () => {
     setProjectPath(void 0);
     setTokensPath(void 0);
+    setPathConfirmed(false);
   };
   const finishImportResult = () => {
     setShowImportResult(false);
@@ -1530,13 +1754,13 @@ function App({ onLaunchImport, importExitCode }) {
   };
   switch (screen) {
     case "import":
-      if (showImportResult) return /* @__PURE__ */ jsx13(ImportScreen, { exitCode: importExitCode, onDone: finishImportResult });
-      if (importDefaults === void 0) return /* @__PURE__ */ jsx13(Fragment4, {});
+      if (showImportResult) return /* @__PURE__ */ jsx14(ImportScreen, { exitCode: importExitCode, onDone: finishImportResult });
+      if (importDefaults === void 0) return /* @__PURE__ */ jsx14(Fragment5, {});
       if (projectPath === void 0) {
-        return /* @__PURE__ */ jsx13(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
+        return /* @__PURE__ */ jsx14(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
       }
       if (tokensPath === void 0) {
-        return /* @__PURE__ */ jsx13(
+        return /* @__PURE__ */ jsx14(
           TokenInputScreen,
           {
             initialPath: importDefaults.tokenFile,
@@ -1545,36 +1769,46 @@ function App({ onLaunchImport, importExitCode }) {
           }
         );
       }
-      return /* @__PURE__ */ jsx13(
-        PathValidationScreen,
+      if (!pathConfirmed) {
+        return /* @__PURE__ */ jsx14(
+          PathValidationScreen,
+          {
+            projectPath,
+            onConfirm: () => setPathConfirmed(true),
+            onChangePath: resetImport,
+            onBack: () => setTokensPath(void 0)
+          }
+        );
+      }
+      return /* @__PURE__ */ jsx14(
+        CredentialsScreen,
         {
-          projectPath,
-          onConfirm: (project) => onLaunchImport?.({ project, tokens: tokensPath }),
-          onChangePath: resetImport,
-          onBack: () => setTokensPath(void 0)
+          initial: importDefaults.credentials,
+          onBack: () => setPathConfirmed(false),
+          onDone: (result) => void finishCredentials(result, projectPath, tokensPath)
         }
       );
     case "help":
-      return /* @__PURE__ */ jsx13(HelpScreen, { onDone: goToStart });
+      return /* @__PURE__ */ jsx14(HelpScreen, { onDone: goToStart });
     case "upgrade":
-      return /* @__PURE__ */ jsx13(UpgradeScreen, { onDone: goToStart });
+      return /* @__PURE__ */ jsx14(UpgradeScreen, { onDone: goToStart });
     case "settings":
-      return /* @__PURE__ */ jsx13(SettingsScreen, { onNavigate: setScreen, onBack: goToStart });
+      return /* @__PURE__ */ jsx14(SettingsScreen, { onNavigate: setScreen, onBack: goToStart });
     case "settings-configuration":
-      return /* @__PURE__ */ jsx13(ConfigurationScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx14(ConfigurationScreen, { onDone: goToSettings });
     case "settings-opt-in-analytics":
-      return /* @__PURE__ */ jsx13(OptInAnalyticsScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx14(OptInAnalyticsScreen, { onDone: goToSettings });
     case "settings-debug-mode":
-      return /* @__PURE__ */ jsx13(DebugModeScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx14(DebugModeScreen, { onDone: goToSettings });
     case "start":
-      return /* @__PURE__ */ jsx13(HomeScreen, { onNavigate: setScreen });
+      return /* @__PURE__ */ jsx14(HomeScreen, { onNavigate: setScreen });
   }
 }
 var CLEAR_SCREEN = "\x1B[2J\x1B[H";
 async function renderUntilImportRequestedOrExit(renderApp, importExitCode) {
   let requestedImport;
   const instance = renderApp(
-    /* @__PURE__ */ jsx13(
+    /* @__PURE__ */ jsx14(
       App,
       {
         importExitCode,