@contentful/experience-design-system-cli 2.38.1-dev-build-6d903339.0 → 2.38.1-dev-build-962dbe22.0

package/dist/src/tui/settings/configuration/agents/apply-binary-overrides.d.ts

@@ -0,0 +1,13 @@
+import type { AgentConfig } from './agent-store.js';
+/**
+ * The pipeline picks an agent's binary from `EDS_AGENT_BINARY_<AGENT>` and nowhere else. This copies each saved
+ * `agents.<name>.binary` into that variable, so the saved path reaches every place that spawns an agent (the import,
+ * the generation package and the legacy commands) without touching their call sites.
+ *
+ * Called once at startup, and again after Settings saves a binary so a change applies without a restart.
+ *
+ * Settings wins over a variable already in the shell, so a forgotten `EDS_AGENT_BINARY_CLAUDE` cannot silently override
+ * what the user sees on screen. An agent with no saved path leaves the shell's variable alone, and clearing a path
+ * puts the shell's value back.
+ */
+export declare function applyBinaryOverrides(config: AgentConfig): void;

package/dist/src/tui/settings/configuration/project/ProjectScreen.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+/** The Contentful project settings: the space, credentials, defaults and where `.contentful` goes. */
+export declare function ProjectScreen({ onDone }: {
+    onDone: () => void;
+}): React.ReactElement;

package/dist/src/tui/settings/{contentful-configuration/config-store.d.ts → configuration/project/project-store.d.ts}

@@ -5,6 +5,7 @@ export type V1Credentials = {
     host?: string;
     defaultComponentDir?: string;
     defaultTokenFile?: string;
+    contentfulBaseDir?: string;
     [key: string]: string | undefined;
 };
 export declare function readCredentials(): Promise<V1Credentials>;

package/dist/src/tui/settings/debug-mode/debug-mode-store.d.ts

@@ -1,5 +1,11 @@
+/** How long a debug log is kept before the CLI deletes it. Only these values are offered. */
+export declare const RETENTION_CHOICES: readonly [7, 14, 30];
+type RetentionDays = (typeof RETENTION_CHOICES)[number];
 export type DebugModeSetting = {
     enabled: boolean;
+    retentionDays: RetentionDays;
 };
 export declare function readDebugModeSetting(): Promise<DebugModeSetting>;
-export declare function writeDebugModeSetting(setting: DebugModeSetting): Promise<void>;
+/** Saves the given fields and keeps the others, so turning logging off does not forget the retention. */
+export declare function writeDebugModeSetting(change: Partial<DebugModeSetting>): Promise<void>;
+export {};

package/dist/src/tui/settings/debug-mode/screen.d.ts

@@ -1,4 +1,8 @@
 import React from 'react';
+/**
+ * Settings > Debug Mode. Logging is switched with Enter. The retention is chosen with ←/→, which only moves a highlight:
+ * nothing is saved until Enter, and then the screen says so.
+ */
 export declare function DebugModeScreen({ onDone }: {
     onDone: () => void;
 }): React.ReactElement;

package/dist/src/tui/settings/shared/debug-trail.d.ts

@@ -0,0 +1,35 @@
+/** One screen's values, as flat text, taken when the screen opens and again when it closes. */
+export type Snapshot = Record<string, string>;
+export type Change = {
+    changed: boolean;
+    /** Field names that differ between the two snapshots, in the order the fields appear. Never the values. */
+    changed_fields: string[];
+};
+/**
+ * Compares the snapshot taken on entry with the one taken on exit. A field that exists in only one of them counts as
+ * changed. Only names are returned, so the result can be logged without repeating a secret.
+ */
+export declare function diffSnapshots(before: Snapshot, after: Snapshot): Change;
+export type Trail = {
+    /** Adds one action, such as `edited spaceId`, `saved`, or `made Codex the default`. Field names, never values. */
+    record(action: string): void;
+    /** The recorded actions in order, oldest first. Once the limit is passed the oldest are dropped. */
+    entries(): string[];
+};
+/** Keeps the last `limit` actions of a visit, so a long visit cannot make the log grow without bound. */
+export declare function createTrail(limit?: number): Trail;
+/**
+ * The message of a failed load or save, safe to log: any of `secrets` that appears in it is replaced. The CMA token is
+ * only redacted by key elsewhere, so an error that quotes it would otherwise get through. A secret is matched as it is
+ * and as it looks URL-encoded, which is how it appears in a request error.
+ */
+export declare function scrubError(error: unknown, secrets: readonly string[]): string;
+/**
+ * Where Project's settings live and what could be moving them: the settings file path, whether `EDS_HOME` relocated it,
+ * and whether the file exists. Facts for the log, with no values read from the file.
+ */
+export declare function describeSettingsFile(): {
+    path: string;
+    eds_home_set: boolean;
+    exists: boolean;
+};

package/dist/src/tui/shared/components/ClearableTextInput.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import TextInput from 'ink-text-input';
+export declare function isClearKey(input: string, key: {
+    ctrl: boolean;
+}): boolean;
+export declare function ClearableTextInput({ onChange, ...props }: React.ComponentProps<typeof TextInput>): React.ReactElement;

package/dist/src/tui/shared/components/ControlHints.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+export interface ControlHint {
+    keys: string;
+    label: string;
+    active?: boolean;
+}
+export declare function ControlHints({ hints }: {
+    hints: readonly ControlHint[];
+}): React.ReactElement;

package/dist/src/tui/shared/components/FieldForm.d.ts

@@ -0,0 +1,71 @@
+import React from 'react';
+export interface FormField<K extends string> {
+    key: K;
+    label: string;
+    /** A short note shown dimmed after the value, so the label column stays narrow. */
+    hint?: string;
+    /** Shows dots instead of the value, for secrets. */
+    masked?: boolean;
+}
+/** A row after the fields that Enter runs instead of opening for editing, such as "Run test". */
+export interface FormAction {
+    label: string;
+    /** What running it does, shown dimmed after the label. */
+    description: string;
+    /** Shown instead of the description while it runs. */
+    runningText?: string;
+    running?: boolean;
+    /** The control hint for Enter while this row is focused. */
+    hint: string;
+    onRun: () => void;
+}
+export type FormNotice = {
+    kind: 'success' | 'error';
+    text: string;
+};
+interface FieldFormProps<K extends string> {
+    /** Shown above the form, outside its padding, such as the import's step header. */
+    header?: React.ReactNode;
+    title: string;
+    /** What this form is for, shown dimmed under the title. */
+    subtitle?: string;
+    fields: readonly FormField<K>[];
+    values: Record<K, string>;
+    onChange: (key: K, value: string) => void;
+    onSave: () => void;
+    saveLabel?: string;
+    enterAdvances?: boolean;
+    onSkip?: () => void;
+    skipLabel?: string;
+    /** Leaves without saving. */
+    onQuit: () => void;
+    /** What Esc does, in the control hints. */
+    quitLabel?: string;
+    /** Rows after the fields that are run, not edited. They share the cursor with the fields. */
+    actions?: readonly FormAction[];
+    notice?: FormNotice | null;
+    /** Ignores keys while a load or save is in flight. */
+    busy?: boolean;
+    /** Shown after the rows and the notice, for read-only content that belongs to the same screen. */
+    children?: React.ReactNode;
+}
+/** The widest label among a form's rows. The form pads every label to it, and read-only rows use it to line up with them. */
+export declare function formLabelWidth(rows: readonly {
+    label: string;
+}[]): number;
+/**
+ * A label and value for read-only content shown with a form. It is built the same way as the form's own rows (a pointer
+ * slot, the label padded to the shared width, then the value), so its values start in the same column as the form's.
+ */
+export declare function FormReadOnlyRow({ label, labelWidth, children, }: {
+    label: string;
+    labelWidth: number;
+    children: React.ReactNode;
+}): React.ReactElement;
+/**
+ * The edit-in-place form the Configuration pages share. Fields are read-only until Enter opens one; Enter again closes it.
+ * While one is open, keys type into it (so a "q" in a path is just a "q"), and Esc closes it and restores the old value.
+ * Actions sit after the fields and take the same cursor: Enter runs one, and `c` does nothing on it.
+ */
+export declare function FieldForm<K extends string>({ header, title, subtitle, fields, values, onChange, onSave, saveLabel, enterAdvances, onSkip, skipLabel, onQuit, quitLabel, actions, notice, busy, children, }: FieldFormProps<K>): React.ReactElement;
+export {};

package/dist/src/tui/shared/components/StepHeader.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+declare const IMPORT_STEPS: readonly [{
+    readonly id: "setup";
+    readonly label: "Setup";
+}, {
+    readonly id: "extraction";
+    readonly label: "Extract";
+}, {
+    readonly id: "scope-gate";
+    readonly label: "Select";
+}, {
+    readonly id: "generation";
+    readonly label: "Generate";
+}, {
+    readonly id: "review";
+    readonly label: "Review";
+}, {
+    readonly id: "push";
+    readonly label: "Push";
+}];
+export type ImportStepId = (typeof IMPORT_STEPS)[number]['id'];
+export interface StepHeaderProps {
+    step: ImportStepId | 'done';
+}
+export declare function StepHeader({ step }: StepHeaderProps): React.ReactElement;
+export {};

package/dist/src/tui/theme.d.ts

@@ -0,0 +1,21 @@
+export type ColorMode = 'dark' | 'light';
+export declare function detectColorMode(env?: NodeJS.ProcessEnv): ColorMode;
+export declare const PALETTE: {
+    readonly text: "#f7f9fa";
+    readonly muted: "#aec1cc";
+    readonly border: "#aec1cc";
+    readonly accent: "#40a0ff";
+    readonly onAccent: "#111B2B";
+    readonly error: "#ff707d";
+    readonly success: "#5DB057";
+    readonly warning: "#FFC835";
+} | {
+    readonly text: "#111B2B";
+    readonly muted: "#5A657C";
+    readonly border: "#5A657C";
+    readonly accent: "#0059c8";
+    readonly onAccent: "#FFFFFF";
+    readonly error: "#bd002a";
+    readonly success: "#006D23";
+    readonly warning: "#CC4500";
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.38.1-dev-build-6d903339.0",
+  "version": "2.38.1-dev-build-962dbe22.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -45,8 +45,8 @@
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
     "zod": "^4.6.5",
-    "@contentful/experience-design-system-backend-pipeline": "2.38.1-dev-build-6d903339.0",
-    "@contentful/experience-design-system-types": "2.38.1-dev-build-6d903339.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.38.1-dev-build-962dbe22.0",
+    "@contentful/experience-design-system-types": "2.38.1-dev-build-962dbe22.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",

package/dist/src/commands/forwarded.d.ts

@@ -1,2 +0,0 @@
-import type { Command } from 'commander';
-export declare function registerForwardedCommands(program: Command): void;

package/dist/src/legacy/forwarded-import-args.d.ts

@@ -1 +0,0 @@
-export declare function forwardedImportArgs(argv: string[]): string[];

package/dist/src/legacy/legacy-cli-path.d.ts

@@ -1 +0,0 @@
-export declare function findLegacyCliPath(): string;

package/dist/src/legacy/run-legacy.d.ts

@@ -1 +0,0 @@
-export declare function runLegacy(args: string[]): Promise<number>;

package/dist/src/tui/control-hints.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-export declare function ControlHints({ hints }: {
-    hints: readonly {
-        keys: string;
-        label: string;
-    }[];
-}): React.ReactElement;

package/dist/src/tui/import/steps/04-credentials/controls.d.ts

@@ -1,21 +0,0 @@
-export declare const CREDENTIALS_CONTROLS: readonly [{
-    readonly keys: "Enter";
-    readonly label: "Next field / Continue";
-}, {
-    readonly keys: "Tab";
-    readonly label: "Switch field";
-}, {
-    readonly keys: "Ctrl+S";
-    readonly label: "Skip (no push)";
-}, {
-    readonly keys: "Esc";
-    readonly label: "Back";
-}];
-interface CredentialsHandlers {
-    disabled: boolean;
-    onBack: () => void;
-    onNextField: () => void;
-    onSkip: () => void;
-}
-export declare function useCredentialsControls(handlers: CredentialsHandlers): void;
-export {};

package/dist/src/tui/import/steps/05-token-reuse/logic.d.ts

@@ -1,21 +0,0 @@
-export type { TokenStrategy } from '../06-extraction/types.js';
-export type TokensState = {
-    kind: 'none';
-} | {
-    kind: 'cached';
-    tokensPath: string;
-    sourceChanged: boolean;
-};
-interface InspectInput {
-    rawTokensPath: string;
-    outDir: string;
-    cache: boolean;
-}
-export declare function inspectTokens({ rawTokensPath, outDir, cache }: InspectInput): Promise<TokensState>;
-export declare function gateText({ tokensPath, sourceChanged }: {
-    tokensPath: string;
-    sourceChanged: boolean;
-}): {
-    summary: string;
-    context?: string;
-};

package/dist/src/tui/import/steps/05-token-reuse/screen.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-interface TokenReuseScreenProps {
-    tokensPath: string;
-    sourceChanged: boolean;
-    onReuse: () => void;
-    onRegenerate: () => void;
-    onQuit: () => void;
-}
-export declare function TokenReuseScreen({ tokensPath, sourceChanged, onReuse, onRegenerate, onQuit, }: TokenReuseScreenProps): React.ReactElement;
-export {};

package/dist/src/tui/import/steps/07-scope-gate/sidebar/components/LegendEntry.d.ts

@@ -1,2 +0,0 @@
-import React from 'react';
-export declare function legendEntry(keyBracket: string, label: string, active?: boolean): React.ReactElement;

package/dist/src/tui/import/steps/07-scope-gate/sidebar/theme.d.ts

@@ -1,8 +0,0 @@
-export declare const PALETTE: {
-    readonly info: "#1773EB";
-    readonly success: "#00C459";
-    readonly error: "#E44F20";
-    readonly warning: "#FFDA00";
-    readonly muted: "#8B8D91";
-    readonly border: "#C4D1DE";
-};

package/dist/src/tui/import/steps/09-review/theme.d.ts

@@ -1,9 +0,0 @@
-export declare const PALETTE: {
-    readonly info: "#1773EB";
-    readonly success: "#00C459";
-    readonly error: "#E44F20";
-    readonly warning: "#FFDA00";
-    readonly muted: "#8B8D91";
-    readonly border: "#C4D1DE";
-    readonly inverse: "#FFFFFF";
-};

package/dist/src/tui/import/steps/10-flow/components/StepHeader.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-type StepHeaderProps = {
-    stepNumber: number;
-    totalSteps: number;
-    title: string;
-};
-export declare function StepHeader({ stepNumber, totalSteps, title }: StepHeaderProps): React.ReactElement;
-export {};

package/dist/src/tui/import/steps/10-flow/theme.d.ts

@@ -1,13 +0,0 @@
-export declare const PALETTE: {
-    readonly link: "#58A6FF";
-    readonly info: "#1773EB";
-    readonly success: "#00C459";
-    readonly error: "#E44F20";
-    readonly warning: "#FFDA00";
-    readonly muted: "#8B8D91";
-    readonly border: "#C4D1DE";
-    readonly inverse: "#FFFFFF";
-};
-export declare const INK_UI_THEME: {
-    components: Record<string, import("@inkjs/ui").ComponentTheme>;
-};

package/dist/src/tui/upgrade/PageContainer.d.ts

@@ -1,4 +0,0 @@
-import React from 'react';
-export declare function UpgradeScreen({ onDone }: {
-    onDone: () => void;
-}): React.ReactElement;

package/legacy/bin/cli.js

@@ -1,58 +0,0 @@
-#!/usr/bin/env node
-// Suppress the SQLite ExperimentalWarning before any modules load.
-// Must use dynamic import so this handler registers before sqlite is imported.
-process.removeAllListeners("warning");
-process.on("warning", (w) => {
-  if (w.name === "ExperimentalWarning" && w.message.includes("SQLite")) return;
-  process.stderr.write(`${w.name}: ${w.message}\n`);
-});
-
-// Auto-rebuild when running from source (dev mode only).
-// Skipped when src/ doesn't exist (e.g. npm-installed users).
-import { existsSync, statSync, readdirSync } from "node:fs";
-import { execFileSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import { dirname, resolve, join } from "node:path";
-
-function newestMtime(dir, depth = 0) {
-  if (depth > 10) return 0;
-  let max = 0;
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
-    if (entry.isSymbolicLink()) continue;
-    const full = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      max = Math.max(max, newestMtime(full, depth + 1));
-    } else if (entry.name.endsWith(".ts") || entry.name.endsWith(".tsx")) {
-      max = Math.max(max, statSync(full).mtimeMs);
-    }
-  }
-  return max;
-}
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const pkgRoot = resolve(__dirname, "..");
-const srcDir = join(pkgRoot, "src");
-const distEntry = join(pkgRoot, "dist", "src", "index.js");
-
-if (
-  existsSync(srcDir) &&
-  existsSync(distEntry) &&
-  process.env.NODE_ENV !== "test"
-) {
-  const distMtime = statSync(distEntry).mtimeMs;
-  if (newestMtime(srcDir) > distMtime) {
-    process.stderr.write("⚙ Source changed — rebuilding...\n");
-    const tsc = join(pkgRoot, "node_modules", ".bin", "tsc");
-    try {
-      execFileSync(tsc, ["-p", join(pkgRoot, "tsconfig.build.json")], {
-        stdio: ["ignore", "ignore", "inherit"],
-        cwd: pkgRoot,
-      });
-      process.stderr.write("✓ Build complete\n");
-    } catch {
-      process.stderr.write("✗ Build failed — running with existing dist\n");
-    }
-  }
-}
-
-await import("../dist/src/index.js");

package/legacy/dist/package.json

@@ -1,76 +0,0 @@
-{
-  "name": "@contentful/experience-design-system-cli-legacy",
-  "version": "2.35.0",
-  "description": "Legacy Contentful Experiences import CLI (internal, not published; used by @contentful/experience-design-system-cli)",
-  "license": "MIT",
-  "private": true,
-  "type": "module",
-  "main": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/src/index.d.ts",
-      "import": "./dist/src/index.js",
-      "node": "./dist/src/index.js"
-    }
-  },
-  "files": [
-    "bin/",
-    "dist/",
-    "prompts/",
-    "skills/"
-  ],
-  "scripts": {
-    "build": "nx build experience-design-system-cli-legacy",
-    "typecheck": "nx typecheck experience-design-system-cli-legacy",
-    "clean": "nx clean experience-design-system-cli-legacy",
-    "test": "nx test experience-design-system-cli-legacy",
-    "test:watch": "nx test:watch experience-design-system-cli-legacy",
-    "lint": "nx lint experience-design-system-cli-legacy",
-    "lint:fix": "nx lint:fix experience-design-system-cli-legacy"
-  },
-  "dependencies": {
-    "@contentful/experience-design-system-backend-pipeline": "workspace:*",
-    "@contentful/experience-design-system-types": "workspace:*",
-    "@inkjs/ui": "^2.0.0",
-    "@segment/analytics-node": "^3.0.0",
-    "@vue/compiler-sfc": "^3.5.31",
-    "ajv": "^8.17.1",
-    "commander": "^13.1.0",
-    "contentful-management": "^12.17.0",
-    "figures": "6.1.0",
-    "ink": "^5.2.1",
-    "react": "^18.3.1",
-    "react-devtools-core": "^4.19.1",
-    "svelte": "^5.56.4",
-    "ts-morph": "^27.0.2",
-    "typescript": "^5.9.3",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@contentful/experience-design-system-client": "workspace:*",
-    "@contentful/experience-design-system-extraction": "workspace:*",
-    "@contentful/experience-design-system-generation": "workspace:*",
-    "@tsconfig/node24": "^24.0.4",
-    "@types/node": "^24.0.3",
-    "@types/react": "^18.3.24",
-    "eslint": "^9.39.5",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.6",
-    "ink-testing-library": "^4.0.0",
-    "typescript-eslint": "^8.67.0",
-    "vitest": "^4.0.16"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/contentful/experience-design-system-sdk-public.git",
-    "directory": "packages/experience-design-system-cli-legacy"
-  },
-  "homepage": "https://github.com/contentful/experience-design-system-sdk-public#readme",
-  "bugs": {
-    "url": "https://github.com/contentful/experience-design-system-sdk-public/issues"
-  },
-  "engines": {
-    "node": ">=24"
-  }
-}

package/legacy/dist/src/analytics/apply.d.ts

@@ -1,6 +0,0 @@
-import type { ApplyOperationResponse } from '@contentful/experience-design-system-types';
-import type { ImportApiClient } from '../apply/api-client.js';
-/** Record apply/preview API outcomes on the active command. */
-export declare function recordApplyOutcome(client: ImportApiClient, spaceId: string, environmentId: string, operation: ApplyOperationResponse): void;
-/** Record Contentful target context without an apply operation (e.g. preview-only). */
-export declare function recordContentfulContext(client: ImportApiClient, spaceId: string, environmentId: string): void;

package/legacy/dist/src/analytics/client.d.ts

@@ -1,8 +0,0 @@
-export declare function cliVersion(): string;
-export declare function setPersistedAnalyticsDisabled(disabled: boolean): void;
-export declare function analyticsEnabled(): boolean;
-export declare function trackEvent(event: string, properties: Record<string, unknown>, anonymousId: string, options?: {
-    flush?: boolean;
-}): Promise<void>;
-export declare function flushAnalytics(): Promise<void>;
-export declare function resetAnalyticsClientForTests(): void;

package/legacy/dist/src/analytics/constants.d.ts

@@ -1,4 +0,0 @@
-/** Parent pipeline session id propagated to subprocesses. */
-export declare const ANALYTICS_SESSION_ENV = "EDS_ANALYTICS_SESSION_ID";
-/** Set when a command is spawned by another CLI command. */
-export declare const IMPORT_PIPELINE_ENV = "EDS_IMPORT_PIPELINE";

package/legacy/dist/src/analytics/exit.d.ts

@@ -1,4 +0,0 @@
-import type { ApiError } from '../apply/api-client.js';
-import type { CommandFailure } from './types.js';
-export declare function exitWithAnalytics(code: number, fields?: CommandFailure): Promise<never>;
-export declare function failureFromApiError(error: ApiError): CommandFailure;

package/legacy/dist/src/analytics/index.d.ts

@@ -1,6 +0,0 @@
-export { exitWithAnalytics, failureFromApiError } from './exit.js';
-export { flushAnalytics, setPersistedAnalyticsDisabled } from './client.js';
-export { isPipelineAnalyticsChild } from './session.js';
-export { bindAnalyticsSessionId, completeActiveCommand, emitSessionStarted, enrichCommandResult, failActiveCommand, noteCommandStart, } from './tracker.js';
-export { recordApplyOutcome, recordContentfulContext } from './apply.js';
-export type { CommandFailure } from './types.js';

package/legacy/dist/src/analytics/normalize.d.ts

@@ -1,3 +0,0 @@
-import type { DsiCliCommand } from './types.js';
-/** Map a Commander command chain (e.g. "apply") to a tracked command id, if any. */
-export declare function normalizeCommand(commandChain: string): DsiCliCommand | undefined;

package/legacy/dist/src/analytics/os.d.ts

@@ -1,2 +0,0 @@
-import type { OsName } from './types.js';
-export declare function getOsName(): OsName;

package/legacy/dist/src/analytics/session.d.ts

@@ -1,3 +0,0 @@
-/** Prefer the pipeline parent session, then an explicit id, then a new slug. */
-export declare function resolveAnalyticsSessionId(explicit?: string): string;
-export declare function isPipelineAnalyticsChild(): boolean;

package/legacy/dist/src/analytics/tracker.d.ts

@@ -1,16 +0,0 @@
-import type { CommandCompletion, CommandContext, CommandFailure, EntryCommand } from './types.js';
-/** Record the start of a tracked command. Invoked is deferred until a session is bound. */
-export declare function noteCommandStart(commandChain: string): void;
-/** Bind a session id, preferring a pipeline parent id when present. */
-export declare function bindAnalyticsSessionId(sessionId: string | undefined, context?: CommandContext): Promise<string>;
-/** Attach Contentful target context for the active command. */
-export declare function setCommandContext(context: CommandContext): void;
-/** Merge optional completion fields before the terminal event fires. */
-export declare function enrichCommandResult(fields: CommandCompletion): void;
-/** Bind the pipeline session and emit invoked once both command and session are known. */
-export declare function bindAnalyticsSession(id: string, context?: CommandContext): Promise<void>;
-/** Emit session_started once per new pipeline head. */
-export declare function emitSessionStarted(entryCommand: EntryCommand): Promise<void>;
-export declare function completeActiveCommand(): Promise<void>;
-export declare function failActiveCommand(fields?: CommandFailure): Promise<void>;
-export declare function resetAnalyticsStateForTests(): void;

package/legacy/dist/src/analytics/types.d.ts

@@ -1,28 +0,0 @@
-/** Tracked CLI commands — closed set aligned with the published event schema. */
-export type DsiCliCommand = 'analyze_extract' | 'analyze_select' | 'generate_components' | 'generate_tokens' | 'map_tokens' | 'apply_push' | 'print_components' | 'print_tokens' | 'import';
-export type EntryCommand = 'analyze_extract' | 'import';
-export type OsName = 'macOS' | 'Linux' | 'Windows' | 'Android' | 'other';
-export type WriteResult = {
-    created_count: number;
-    updated_count: number;
-    failed_count: number;
-};
-export type CommandContext = {
-    space_key?: string;
-    environment_key?: string;
-    x_contentful_request_id?: string;
-};
-export type CommandCompletion = CommandContext & {
-    dsi_operation_id?: string;
-    extracted_component_count?: number;
-    accepted_component_count?: number;
-    component_type_result?: WriteResult;
-    design_token_result?: WriteResult;
-};
-export type CommandFailure = CommandContext & {
-    dsi_operation_id?: string;
-    error_name?: string;
-    error_code?: string;
-    http_status_code?: number;
-    exit_code?: number;
-};