@contentful/experience-design-system-cli 2.5.3-dev-build-b2e98f1.0 → 2.6.0

package/README.md

@@ -1,8 +1,8 @@
 # @contentful/experience-design-system-cli
 
-CLI for extracting, reviewing, generating, validating, and pushing Contentful Experience Design System component definitions.
+CLI for extracting, reviewing, generating, validating, and pushing Contentful Experience Design System component definitions into Experiences
 
-## Pipeline Overview
+## CLI Overview
 
 The commands form a pipeline. Run them in order, or use `import` to orchestrate the whole thing at once:
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.5.3-dev-build-b2e98f1.0",
+  "version": "2.6.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -18,6 +18,10 @@
       "node": "./dist/src/index.js"
     }
   },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://npm.pkg.github.com/"
+  },
   "files": [
     "bin/",
     "dist/",

package/dist/src/apply/api-client.js

@@ -1,4 +1,5 @@
-export const DEFAULT_HOST = 'https://api.contentful.com';
+import { DEFAULT_API_HOST, toApiHost } from '../host-utils.js';
+export const DEFAULT_HOST = DEFAULT_API_HOST;
 export class ApiError extends Error {
     status;
     body;
@@ -33,7 +34,7 @@ export class ImportApiClient {
     spaceId;
     environmentId;
     constructor(opts) {
-        this.host = opts.host ?? DEFAULT_HOST;
+        this.host = toApiHost(opts.host);
         this.token = opts.cmaToken;
         this.spaceId = opts.spaceId;
         this.environmentId = opts.environmentId;

package/dist/src/credentials-store.d.ts

@@ -2,6 +2,7 @@ export type ExperiencesCredentials = {
     spaceId: string;
     environmentId: string;
     cmaToken: string;
+    host?: string;
 };
 export declare function readExperiencesCredentials(): Promise<ExperiencesCredentials>;
 export declare function writeExperiencesCredentials(creds: ExperiencesCredentials): Promise<void>;

package/dist/src/credentials-store.js

@@ -1,29 +1,39 @@
 import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
+import { toConfiguredHost } from './host-utils.js';
 const CREDENTIALS_DIR = join(homedir(), '.config', 'experiences');
 const CREDENTIALS_PATH = join(CREDENTIALS_DIR, 'credentials.json');
 export async function readExperiencesCredentials() {
     try {
         const raw = await readFile(CREDENTIALS_PATH, 'utf8');
         const parsed = JSON.parse(raw);
+        const host = toConfiguredHost(process.env['EDS_HOST'] ?? parsed.host);
         return {
             spaceId: process.env['CONTENTFUL_SPACE_ID'] ?? parsed.spaceId ?? '',
             environmentId: process.env['CONTENTFUL_ENVIRONMENT_ID'] ?? parsed.environmentId ?? '',
             cmaToken: process.env['CONTENTFUL_MANAGEMENT_TOKEN'] ?? parsed.cmaToken ?? '',
+            ...(host ? { host } : {}),
         };
     }
     catch {
+        const host = toConfiguredHost(process.env['EDS_HOST']);
         return {
             spaceId: process.env['CONTENTFUL_SPACE_ID'] ?? '',
             environmentId: process.env['CONTENTFUL_ENVIRONMENT_ID'] ?? '',
             cmaToken: process.env['CONTENTFUL_MANAGEMENT_TOKEN'] ?? '',
+            ...(host ? { host } : {}),
         };
     }
 }
 export async function writeExperiencesCredentials(creds) {
+    const { host: _host, ...rest } = creds;
+    const host = toConfiguredHost(creds.host);
     await mkdir(CREDENTIALS_DIR, { recursive: true });
-    await writeFile(CREDENTIALS_PATH, JSON.stringify(creds, null, 2) + '\n', { mode: 0o600 });
+    await writeFile(CREDENTIALS_PATH, JSON.stringify({
+        ...rest,
+        ...(host ? { host } : {}),
+    }, null, 2) + '\n', { mode: 0o600 });
 }
 export function experiencesCredentialsPath() {
     return CREDENTIALS_PATH;

package/dist/src/host-utils.d.ts

@@ -0,0 +1,4 @@
+export declare const DEFAULT_API_HOST = "https://api.contentful.com";
+export declare const DEFAULT_CONFIGURED_HOST = "api.contentful.com";
+export declare function toConfiguredHost(host?: string): string | undefined;
+export declare function toApiHost(host?: string): string;

package/dist/src/host-utils.js

@@ -0,0 +1,26 @@
+export const DEFAULT_API_HOST = 'https://api.contentful.com';
+export const DEFAULT_CONFIGURED_HOST = 'api.contentful.com';
+function trimTrailingSlashes(value) {
+    return value.replace(/\/+$/, '');
+}
+function normalizeHostInput(host) {
+    const value = host?.trim();
+    if (!value)
+        return undefined;
+    return trimTrailingSlashes(value);
+}
+export function toConfiguredHost(host) {
+    const normalized = normalizeHostInput(host);
+    if (!normalized)
+        return undefined;
+    return normalized.replace(/^https:\/\//i, '');
+}
+export function toApiHost(host) {
+    const normalized = normalizeHostInput(host);
+    if (!normalized)
+        return DEFAULT_API_HOST;
+    if (/^[a-z][a-z\d+\-.]*:\/\//i.test(normalized)) {
+        return normalized;
+    }
+    return `https://${normalized}`;
+}

package/dist/src/import/command.js

@@ -1,6 +1,7 @@
 import { resolve, join } from 'node:path';
 import { runPipeline } from './orchestrator.js';
 import { readExperiencesCredentials } from '../credentials-store.js';
+import { DEFAULT_CONFIGURED_HOST, toConfiguredHost } from '../host-utils.js';
 export function registerImportCommand(program) {
     program
         .command('import')
@@ -45,6 +46,7 @@ export function registerImportCommand(program) {
                 initialSpaceId: creds.spaceId,
                 initialEnvironmentId: creds.environmentId || 'master',
                 initialCmaToken: creds.cmaToken,
+                initialHost: toConfiguredHost(opts.host ?? creds.host) ?? DEFAULT_CONFIGURED_HOST,
                 initialAgent: opts.agent !== 'claude' ? opts.agent : undefined,
                 initialProjectPath: opts.project !== '.' ? resolve(opts.project) : undefined,
                 host: opts.host,

package/dist/src/import/tui/WizardApp.d.ts

@@ -3,8 +3,9 @@ export type WizardAppProps = {
     initialSpaceId?: string;
     initialEnvironmentId?: string;
     initialCmaToken?: string;
+    initialHost?: string;
     initialAgent?: string;
     initialProjectPath?: string;
     host?: string;
 };
-export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialAgent, initialProjectPath, host, }?: WizardAppProps): React.ReactElement;
+export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialProjectPath, host, }?: WizardAppProps): React.ReactElement;

package/dist/src/import/tui/WizardApp.js

@@ -24,6 +24,8 @@ import { buildManifest } from '@contentful/experience-design-system-types';
 import { openPipelineDb, loadCDFComponents, seedCDFFromPreviewResponse, seedDefaultsFromChangedItems, backfillUnclassifiedProps, } from '../../session/db.js';
 import { checkAgentAuth } from '../../generate/agent-runner.js';
 import { normalizePath } from '../path-utils.js';
+import { DEFAULT_CONFIGURED_HOST, toConfiguredHost } from '../../host-utils.js';
+import { writeExperiencesCredentials } from '../../credentials-store.js';
 function findCliPath() {
     return join(fileURLToPath(import.meta.url), '..', '..', '..', '..', '..', 'bin', 'cli.js');
 }
@@ -39,8 +41,9 @@ function logStep(entry) {
     const line = JSON.stringify({ ts: new Date().toISOString(), ...entry }) + '\n';
     appendFileSync(WIZARD_LOG, line);
 }
-export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master', initialCmaToken = '', initialAgent, initialProjectPath, host, } = {}) {
-    const apiHost = host ?? process.env['EDS_HOST'];
+export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master', initialCmaToken = '', initialHost, initialAgent, initialProjectPath, host, } = {}) {
+    const defaultConfiguredHost = toConfiguredHost(host || process.env['EDS_HOST']) ?? DEFAULT_CONFIGURED_HOST;
+    const resolveWizardHost = (hostValue) => hostValue || defaultConfiguredHost;
     const { stdout } = useStdout();
     const terminalWidth = stdout?.columns ?? 80;
     const logInit = useRef(false);
@@ -75,6 +78,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
         spaceId: initialSpaceId,
         environmentId: initialEnvironmentId,
         cmaToken: initialCmaToken,
+        host: resolveWizardHost(toConfiguredHost(initialHost)),
         credentialsError: '',
         serverPreview: null,
         manifest: null,
@@ -375,7 +379,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
         }
         if (returnToPreview) {
             const { extractSessionId, tokensPath } = sessionRef.current;
-            void runPreview(extractSessionId, tokensPath, state.spaceId, state.environmentId, state.cmaToken);
+            void runPreview(extractSessionId, tokensPath, state.spaceId, state.environmentId, state.cmaToken, state.host);
         }
         else {
             advanceToPushFlow(generatedAcceptedCount);
@@ -431,19 +435,46 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
         }
         // Re-preview with updated definitions
         const { extractSessionId: sid, tokensPath: tp } = sessionRef.current;
-        void runPreview(sid, tp, state.spaceId, state.environmentId, state.cmaToken);
+        void runPreview(sid, tp, state.spaceId, state.environmentId, state.cmaToken, state.host);
     };
-    const confirmCredentials = (spaceId, environmentId, cmaToken) => {
+    const advanceWithCredentials = (spaceId, environmentId, cmaToken, host) => {
+        const resolvedHost = resolveWizardHost(host);
         credentialsRef.current = { spaceId, environmentId, cmaToken };
-        update({ spaceId, environmentId, cmaToken, step: 'credential-test-gate' });
+        update({
+            spaceId,
+            environmentId,
+            cmaToken,
+            host: resolvedHost,
+            credentialsError: '',
+            step: 'credential-test-gate',
+        });
+    };
+    const confirmCredentials = async (spaceId, environmentId, cmaToken, host) => {
+        const resolvedHost = resolveWizardHost(host);
+        try {
+            await writeExperiencesCredentials({ spaceId, environmentId, cmaToken, host: resolvedHost });
+            advanceWithCredentials(spaceId, environmentId, cmaToken, resolvedHost);
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : 'Unable to save credentials';
+            update({
+                spaceId,
+                environmentId,
+                cmaToken,
+                host: resolvedHost,
+                credentialsError: `Failed to save credentials: ${message}`,
+                step: 'credentials',
+            });
+        }
     };
-    const validateCredentials = async (spaceId, environmentId, cmaToken) => {
+    const validateCredentials = async (spaceId, environmentId, cmaToken, host) => {
         update({ step: 'validating-credentials' });
         try {
-            const client = new ImportApiClient({ cmaToken, spaceId, environmentId, host: apiHost });
+            const resolvedHost = resolveWizardHost(host);
+            const client = new ImportApiClient({ cmaToken, spaceId, environmentId, host: resolvedHost });
             await client.validateToken();
             const { extractSessionId, tokensPath } = sessionRef.current;
-            void runPreview(extractSessionId, tokensPath, spaceId, environmentId, cmaToken);
+            void runPreview(extractSessionId, tokensPath, spaceId, environmentId, cmaToken, resolvedHost);
         }
         catch (e) {
             if (e instanceof ApiError && (e.status === 401 || e.status === 403)) {
@@ -459,10 +490,11 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
             });
         }
     };
-    const runPreview = async (extractSessionId, tokensPath, spaceId, environmentId, cmaToken) => {
+    const runPreview = async (extractSessionId, tokensPath, spaceId, environmentId, cmaToken, host) => {
         update({ step: 'previewing' });
+        const resolvedHost = resolveWizardHost(host);
         try {
-            const client = new ImportApiClient({ cmaToken, spaceId, environmentId, host: apiHost });
+            const client = new ImportApiClient({ cmaToken, spaceId, environmentId, host: resolvedHost });
             let components = [];
             if (extractSessionId) {
                 const db = openPipelineDb();
@@ -548,7 +580,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                         errorMessage: `Not found (404). Check that the space ID, environment ID, and host are correct.\n\n` +
                             `  Space:       ${spaceId}\n` +
                             `  Environment: ${environmentId}\n` +
-                            (apiHost ? `  Host:        ${apiHost}\n` : '') +
+                            (resolvedHost ? `  Host:        ${resolvedHost}\n` : '') +
                             `\nIf using a custom --host, make sure the space exists on that host.`,
                     });
                     return;
@@ -560,7 +592,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
             update({ step: 'error', errorStep: 'apply preview', errorMessage: msg, errorAllowCredentialRetry: true });
         }
     };
-    const runPush = async (manifest, spaceId, environmentId, cmaToken, acknowledgeBreakingChanges, preview) => {
+    const runPush = async (manifest, spaceId, environmentId, cmaToken, host, acknowledgeBreakingChanges, preview) => {
         if (preview) {
             const hasComponentChanges = preview.components.new.length > 0 ||
                 preview.components.changed.length > 0 ||
@@ -579,7 +611,8 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
         }
         update({ step: 'pushing' });
         try {
-            const client = new ImportApiClient({ cmaToken, spaceId, environmentId, host: apiHost });
+            const resolvedHost = resolveWizardHost(host);
+            const client = new ImportApiClient({ cmaToken, spaceId, environmentId, host: resolvedHost });
             let operation = await client.applyImport(manifest, acknowledgeBreakingChanges);
             try {
                 logStep({
@@ -835,13 +868,15 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                     }, onQuit: () => process.exit(0) }));
             }
             case 'credentials':
-                return (_jsx(CredentialsStep, { initialSpaceId: state.spaceId, initialEnvironmentId: state.environmentId, initialCmaToken: state.cmaToken, error: state.credentialsError || undefined, onConfirm: confirmCredentials, onContinue: confirmCredentials, onQuit: () => process.exit(0) }));
+                return (_jsx(CredentialsStep, { initialSpaceId: state.spaceId, initialEnvironmentId: state.environmentId, initialCmaToken: state.cmaToken, initialHost: state.host, error: state.credentialsError || undefined, onConfirm: (spaceId, environmentId, cmaToken, host) => {
+                        void confirmCredentials(spaceId, environmentId, cmaToken, host);
+                    }, onContinue: advanceWithCredentials, onQuit: () => process.exit(0) }));
             case 'credential-test-gate':
                 return (_jsx(GateStep, { successMessage: "Credentials entered", summary: `Space: ${state.spaceId}  ·  Environment: ${state.environmentId}`, context: "Verify your credentials work before running the import, or skip and find out during the push step.", continueLabel: "Test credentials", skipLabel: "Skip and continue", showSkip: true, onContinue: () => {
-                        void validateCredentials(state.spaceId, state.environmentId, state.cmaToken);
+                        void validateCredentials(state.spaceId, state.environmentId, state.cmaToken, state.host);
                     }, onSkip: () => {
                         const { extractSessionId, tokensPath } = sessionRef.current;
-                        void runPreview(extractSessionId, tokensPath, state.spaceId, state.environmentId, state.cmaToken);
+                        void runPreview(extractSessionId, tokensPath, state.spaceId, state.environmentId, state.cmaToken, state.host);
                     }, onQuit: () => process.exit(0) }));
             case 'validating-credentials':
                 return (_jsx(RunningStep, { stepNumber: totalSteps - 1, totalSteps: totalSteps, title: "Validating credentials", description: "Checking that your space ID and CMA token are valid..." }));
@@ -849,7 +884,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                 return (_jsx(RunningStep, { stepNumber: totalSteps, totalSteps: totalSteps, title: "Computing diff", description: "Computing diff against your Contentful space..." }));
             case 'preview-gate':
                 return (_jsx(WizardPreviewStep, { preview: state.serverPreview, spaceId: state.spaceId, environmentId: state.environmentId, stepNumber: totalSteps, totalSteps: totalSteps, onConfirm: (acknowledge) => {
-                        void runPush(state.manifest, state.spaceId, state.environmentId, state.cmaToken, acknowledge, state.serverPreview);
+                        void runPush(state.manifest, state.spaceId, state.environmentId, state.cmaToken, state.host, acknowledge, state.serverPreview);
                     }, onEdit: () => {
                         void runEditFromPreview(state.serverPreview);
                     }, onSaveFiles: () => {

package/dist/src/import/tui/steps/CredentialsStep.d.ts

@@ -5,11 +5,12 @@ type CredentialsStepProps = {
     initialSpaceId?: string;
     initialEnvironmentId?: string;
     initialCmaToken?: string;
-    /** Called when the user submits with all fields changed from their initial values */
-    onConfirm: (spaceId: string, environmentId: string, cmaToken: string) => void;
+    initialHost?: string;
+    /** Called when the user submits with any field changed from its initial value */
+    onConfirm: (spaceId: string, environmentId: string, cmaToken: string, host: string) => void;
     /** Called when the user submits without changing any field (use existing creds as-is) */
-    onContinue?: (spaceId: string, environmentId: string, cmaToken: string) => void;
+    onContinue?: (spaceId: string, environmentId: string, cmaToken: string, host: string) => void;
     onQuit: () => void;
 };
-export declare function CredentialsStep({ summary, error: externalError, initialSpaceId, initialEnvironmentId, initialCmaToken, onConfirm, onContinue, onQuit, }: CredentialsStepProps): React.ReactElement;
+export declare function CredentialsStep({ summary, error: externalError, initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, onConfirm, onContinue, onQuit, }: CredentialsStepProps): React.ReactElement;
 export {};

package/dist/src/import/tui/steps/CredentialsStep.js

@@ -2,10 +2,13 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState, useEffect } from 'react';
 import { Box, Text } from 'ink';
 import { useImmediateInput } from '../../../analyze/select/tui/hooks/useImmediateInput.js';
-export function CredentialsStep({ summary, error: externalError, initialSpaceId = '', initialEnvironmentId = 'master', initialCmaToken = '', onConfirm, onContinue, onQuit, }) {
+import { DEFAULT_CONFIGURED_HOST, toConfiguredHost } from '../../../host-utils.js';
+export function CredentialsStep({ summary, error: externalError, initialSpaceId = '', initialEnvironmentId = 'master', initialCmaToken = '', initialHost, onConfirm, onContinue, onQuit, }) {
+    const normalizedInitialHost = toConfiguredHost(initialHost) ?? DEFAULT_CONFIGURED_HOST;
     const [spaceId, setSpaceId] = useState(initialSpaceId);
     const [environmentId, setEnvironmentId] = useState(initialEnvironmentId);
     const [cmaToken, setCmaToken] = useState(initialCmaToken);
+    const [host, setHost] = useState(normalizedInitialHost);
     const [activeField, setActiveField] = useState('spaceId');
     const [inlineError, setInlineError] = useState(null);
     const [cursorVisible, setCursorVisible] = useState(true);
@@ -23,25 +26,31 @@ export function CredentialsStep({ summary, error: externalError, initialSpaceId
                 setActiveField('cmaToken');
                 return;
             }
+            if (activeField === 'cmaToken') {
+                setActiveField('host');
+                return;
+            }
             // Submit
             if (!spaceId.trim() || !environmentId.trim() || !cmaToken.trim()) {
                 setInlineError('All fields are required.');
                 return;
             }
             setInlineError(null);
+            const submittedHost = toConfiguredHost(host) ?? DEFAULT_CONFIGURED_HOST;
             const unchanged = spaceId.trim() === initialSpaceId &&
                 environmentId.trim() === initialEnvironmentId &&
-                cmaToken.trim() === initialCmaToken;
+                cmaToken.trim() === initialCmaToken &&
+                submittedHost === normalizedInitialHost;
             if (unchanged && onContinue) {
-                onContinue(spaceId.trim(), environmentId.trim(), cmaToken.trim());
+                onContinue(spaceId.trim(), environmentId.trim(), cmaToken.trim(), submittedHost);
             }
             else {
-                onConfirm(spaceId.trim(), environmentId.trim(), cmaToken.trim());
+                onConfirm(spaceId.trim(), environmentId.trim(), cmaToken.trim(), submittedHost);
             }
             return;
         }
         if (key.tab) {
-            setActiveField((f) => (f === 'spaceId' ? 'environmentId' : f === 'environmentId' ? 'cmaToken' : 'spaceId'));
+            setActiveField((f) => f === 'spaceId' ? 'environmentId' : f === 'environmentId' ? 'cmaToken' : f === 'cmaToken' ? 'host' : 'spaceId');
             return;
         }
         if (key.escape || input === 'q') {
@@ -53,8 +62,10 @@ export function CredentialsStep({ summary, error: externalError, initialSpaceId
                 setSpaceId((v) => v.slice(0, -1));
             else if (activeField === 'environmentId')
                 setEnvironmentId((v) => v.slice(0, -1));
-            else
+            else if (activeField === 'cmaToken')
                 setCmaToken((v) => v.slice(0, -1));
+            else
+                setHost((v) => v.slice(0, -1));
             return;
         }
         if (input && !key.ctrl && !key.meta) {
@@ -62,18 +73,21 @@ export function CredentialsStep({ summary, error: externalError, initialSpaceId
                 setSpaceId((v) => v + input);
             else if (activeField === 'environmentId')
                 setEnvironmentId((v) => v + input);
-            else
+            else if (activeField === 'cmaToken')
                 setCmaToken((v) => v + input);
+            else
+                setHost((v) => v + input);
         }
     });
     const cursor = cursorVisible ? '█' : ' ';
     function renderField(label, value, field, masked = false) {
         const isActive = activeField === field;
         const display = masked ? '•'.repeat(value.length) : value;
-        return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: isActive ? 'cyan' : undefined, children: '?' }), _jsxs(Text, { bold: isActive, children: [label, ":"] }), _jsx(Text, { children: isActive ? display + cursor : display || _jsx(Text, { dimColor: true, children: "(empty)" }) })] }));
+        const fallback = field === 'host' ? DEFAULT_CONFIGURED_HOST : _jsx(Text, { dimColor: true, children: "(empty)" });
+        return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: isActive ? 'cyan' : undefined, children: '?' }), _jsxs(Text, { bold: isActive, children: [label, ":"] }), _jsx(Text, { children: isActive ? display + cursor : display || fallback })] }));
     }
     const displayError = inlineError ?? externalError ?? null;
     return (_jsxs(Box, { flexDirection: "column", gap: 1, paddingX: 2, paddingY: 1, children: [summary && _jsxs(Text, { color: "green", children: ["\u2713 ", summary] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: initialSpaceId && initialCmaToken
                         ? 'Credentials pre-filled from experiences setup. Press Enter to continue or edit any field to update.'
-                        : 'Enter your Contentful credentials to continue.' }) }), !(initialSpaceId && initialCmaToken) && (_jsx(Text, { dimColor: true, children: "Tip: run experiences setup to save these to ~/.config/experiences/credentials.json so they pre-fill here automatically." })), _jsxs(Box, { flexDirection: "column", gap: 0, marginTop: 1, children: [renderField('Space ID', spaceId, 'spaceId'), renderField('Environment', environmentId, 'environmentId'), renderField('CMA Token', cmaToken, 'cmaToken', true)] }), displayError && _jsxs(Text, { color: "red", children: ["\u2717 ", displayError] }), _jsxs(Box, { gap: 3, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "[Enter] Next field / Submit" }), _jsx(Text, { dimColor: true, children: "[Tab] Switch field" }), _jsx(Text, { dimColor: true, children: "[q] Quit" })] })] }));
+                        : 'Enter your Contentful credentials to continue.' }) }), !(initialSpaceId && initialCmaToken) && (_jsx(Text, { dimColor: true, children: "Tip: run experiences setup to save these to ~/.config/experiences/credentials.json so they pre-fill here automatically." })), _jsxs(Box, { flexDirection: "column", gap: 0, marginTop: 1, children: [renderField('Space ID', spaceId, 'spaceId'), renderField('Environment', environmentId, 'environmentId'), renderField('CMA Token', cmaToken, 'cmaToken', true), renderField('API Host', host, 'host')] }), activeField === 'host' && _jsx(Text, { dimColor: true, children: "Default: api.contentful.com \u00B7 EU spaces: api.eu.contentful.com" }), displayError && _jsxs(Text, { color: "red", children: ["\u2717 ", displayError] }), _jsxs(Box, { gap: 3, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "[Enter] Next field / Submit" }), _jsx(Text, { dimColor: true, children: "[Tab] Switch field" }), _jsx(Text, { dimColor: true, children: "[q] Quit" })] })] }));
 }

package/dist/src/index.js

@@ -1,2 +1,7 @@
 import { createProgram } from './program.js';
-await createProgram().parseAsync();
+createProgram()
+    .parseAsync()
+    .catch((err) => {
+    process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});

package/dist/src/setup/command.js

@@ -6,6 +6,7 @@ import { fileURLToPath } from 'node:url';
 import { createInterface } from 'node:readline';
 import { promisify } from 'node:util';
 import { readExperiencesCredentials, writeExperiencesCredentials, experiencesCredentialsPath, } from '../credentials-store.js';
+import { DEFAULT_CONFIGURED_HOST, toConfiguredHost } from '../host-utils.js';
 const execFileAsync = promisify(execFile);
 const REQUIRED_NODE_MAJOR = 24;
 // ── Output helpers ────────────────────────────────────────────────────────────
@@ -29,7 +30,13 @@ function dim(msg) {
     process.stdout.write(`\x1b[2m${msg}\x1b[0m\n`);
 }
 // ── Prompt helpers ────────────────────────────────────────────────────────────
+function isInteractivePromptSession() {
+    return !!(process.stdin.isTTY && process.stdout.isTTY);
+}
 function prompt(question) {
+    if (!isInteractivePromptSession()) {
+        return Promise.resolve('');
+    }
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     return new Promise((resolve) => {
         rl.question(question, (answer) => {
@@ -39,6 +46,9 @@ function prompt(question) {
     });
 }
 function promptSecret(question) {
+    if (!isInteractivePromptSession()) {
+        return Promise.resolve('');
+    }
     // Use readline for all prompts — mixing raw-mode stdin listeners with
     // readline createInterface causes readline to buffer+unshift unconsumed
     // input back onto the stream, which the raw listener then re-reads,
@@ -51,9 +61,10 @@ function promptSecret(question) {
         });
         let value = '';
         process.stdout.write(question);
+        let origWrite = null;
         if (process.stdin.isTTY) {
             // Intercept the readline output write so we can replace echoed chars with *
-            const origWrite = rl.output.write.bind(rl.output);
+            origWrite = rl.output.write.bind(rl.output);
             rl.output.write = (s) => {
                 // Allow newline through; suppress everything else (the echoed characters)
                 if (s === '\r\n' || s === '\n' || s === '\r')
@@ -65,12 +76,24 @@ function promptSecret(question) {
             rl.close();
         });
         rl.once('close', () => {
-            process.stdout.write('\n');
+            // Restore stdout.write before resolving — the interceptor patches rl.output.write
+            // which is process.stdout.write, so without restoring it all subsequent output is swallowed.
+            if (origWrite) {
+                rl.output.write = origWrite;
+            }
+            // In TTY mode readline already emitted \n when Enter was pressed; only add one in non-TTY.
+            if (!process.stdin.isTTY)
+                process.stdout.write('\n');
+            // rl.close() pauses stdin; resume it so subsequent prompt() calls work.
+            process.stdin.resume();
             resolve(value);
         });
     });
 }
 async function confirm(question, defaultYes = true) {
+    if (!isInteractivePromptSession()) {
+        return false;
+    }
     const hint = defaultYes ? '[Y/n]' : '[y/N]';
     const answer = await prompt(`  ${question} ${hint} `);
     if (!answer)
@@ -387,6 +410,8 @@ async function setupContentfulCredentials() {
     const currentSpace = stored.spaceId;
     const currentEnv = stored.environmentId;
     const currentToken = stored.cmaToken;
+    const storedHost = stored.host;
+    const currentHost = storedHost ?? DEFAULT_CONFIGURED_HOST;
     const hasAny = !!(currentSpace || currentEnv || currentToken);
     if (hasAny) {
         info('Current values:');
@@ -408,6 +433,7 @@ async function setupContentfulCredentials() {
         else {
             warn('CMA Token       (not set)');
         }
+        ok(`API Host        ${currentHost}`);
         info('');
     }
     const allSet = !!(currentSpace && currentEnv && currentToken);
@@ -434,9 +460,12 @@ async function setupContentfulCredentials() {
         warn('Space ID and CMA token are required. Skipped.');
         return false;
     }
-    await writeExperiencesCredentials({ spaceId, environmentId, cmaToken });
+    const hostInput = await prompt(`  API host [${currentHost}]: `);
+    const host = toConfiguredHost(hostInput) ?? storedHost;
+    await writeExperiencesCredentials({ spaceId, environmentId, cmaToken, ...(host ? { host } : {}) });
     ok(`Credentials saved to ${experiencesCredentialsPath()}`);
-    info('Run experiences import — the credentials step will be pre-filled automatically.');
+    ok(`API host set to ${host ?? DEFAULT_CONFIGURED_HOST}`);
+    info('Run experiences import — credentials will be pre-filled automatically.');
     return true;
 }
 // ── Step 6: Optional quality-of-life ─────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.5.3-dev-build-b2e98f1.0",
+  "version": "2.6.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -18,6 +18,10 @@
       "node": "./dist/src/index.js"
     }
   },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://npm.pkg.github.com/"
+  },
   "files": [
     "bin/",
     "dist/",
@@ -32,7 +36,7 @@
     "react-dom": "^18.3.1",
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
-    "@contentful/experience-design-system-types": "2.5.3-dev-build-b2e98f1.0"
+    "@contentful/experience-design-system-types": "2.6.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.3",