@contentful/experience-design-system-cli 2.23.2-dev-build-753ceef.0 → 2.23.2-dev-build-e996ffb.0

package/dist/src/print/command.js

@@ -8,10 +8,9 @@ import { validateDTCGTokenFile } from './validate/validators/dtcg-validator.js';
 import { formatDiagnostics } from './validate/validators/format-errors.js';
 import { ValidateView } from './validate/tui/ValidateView.js';
 import { getInteractiveTerminalSupport } from '../lib/terminal-capabilities.js';
-import { bindAnalyticsSessionId, exitWithAnalytics } from '../analytics/index.js';
-async function die(message) {
+function die(message) {
     process.stderr.write(`${message}\n`);
-    return exitWithAnalytics(1);
+    process.exit(1);
 }
 async function pathExists(p) {
     return access(p)
@@ -22,16 +21,16 @@ async function assertOutIsNotDirectory(outPath) {
     if (await pathExists(outPath)) {
         const s = await stat(outPath);
         if (s.isDirectory())
-            await die(`Error: --out must be a file path, not a directory: ${outPath}`);
+            die(`Error: --out must be a file path, not a directory: ${outPath}`);
     }
 }
-async function resolveSession(sessionFlag, command) {
+function resolveSession(sessionFlag, command) {
     const db = openPipelineDb();
     try {
         const sessionId = sessionFlag ?? findLatestSessionForCommand(db, command);
         if (!sessionId) {
             const hint = command === 'generate components' ? 'generate components' : 'generate tokens';
-            return await die(`Error: no completed ${hint} session found. Run ${hint} first, or pass --session <id>.`);
+            die(`Error: no completed ${hint} session found. Run ${hint} first, or pass --session <id>.`);
         }
         return sessionId;
     }
@@ -86,8 +85,7 @@ export function registerPrintCommand(program) {
         .action(async (opts) => {
         const outPath = resolve(opts.out);
         await assertOutIsNotDirectory(outPath);
-        const sessionId = await resolveSession(opts.session, 'generate components');
-        await bindAnalyticsSessionId(sessionId);
+        const sessionId = resolveSession(opts.session, 'generate components');
         const db = openPipelineDb();
         let components;
         let generateStepStatus = null;
@@ -112,13 +110,13 @@ export function registerPrintCommand(program) {
                 // component was rejected or left unresolved. This is a legitimate
                 // "clear the space" intent, but it's destructive, so require --allow-empty.
                 if (!opts.allowEmpty) {
-                    await die(`Error: all ${rejectedCount} generated component${rejectedCount === 1 ? ' was' : 's were'} rejected or left unresolved at final review in session '${sessionId}', so there is nothing to save. Accept at least one component (press [a] on a row, or [A] to accept all), or pass --allow-empty to write an empty manifest that will DELETE all components from the target space on push.`);
+                    die(`Error: all ${rejectedCount} generated component${rejectedCount === 1 ? ' was' : 's were'} rejected or left unresolved at final review in session '${sessionId}', so there is nothing to save. Accept at least one component (press [a] on a row, or [A] to accept all), or pass --allow-empty to write an empty manifest that will DELETE all components from the target space on push.`);
                 }
                 // Fall through: write an empty-but-present components manifest so a
                 // subsequent push removes every component from the target space.
             }
             else {
-                await die(`Error: no generated components in session '${sessionId}'. Run generate components first.`);
+                die(`Error: no generated components in session '${sessionId}'. Run generate components first.`);
             }
         }
         if (generateStepStatus === 'failed') {
@@ -147,8 +145,7 @@ export function registerPrintCommand(program) {
         .action(async (opts) => {
         const outPath = resolve(opts.out);
         await assertOutIsNotDirectory(outPath);
-        const sessionId = await resolveSession(opts.session, 'generate tokens');
-        await bindAnalyticsSessionId(sessionId);
+        const sessionId = resolveSession(opts.session, 'generate tokens');
         const db = openPipelineDb();
         let result;
         try {
@@ -158,7 +155,7 @@ export function registerPrintCommand(program) {
             db.close();
         }
         if (result.tokens.length === 0) {
-            await die(`Error: no generated tokens in session '${sessionId}'. Run generate tokens first.`);
+            die(`Error: no generated tokens in session '${sessionId}'. Run generate tokens first.`);
         }
         const tree = rebuildDTCGTree(result.groups, result.tokens);
         await mkdir(resolve(outPath, '..'), { recursive: true });
@@ -174,7 +171,7 @@ export function registerPrintCommand(program) {
         .action(async (opts) => {
         if (!opts.components && !opts.tokens) {
             process.stderr.write('Error: at least one of --components or --tokens is required.\n\nUsage: print validate [--components <path>] [--tokens <path>]\n');
-            await exitWithAnalytics(1);
+            process.exit(1);
         }
         const viewResults = [];
         if (opts.components) {
@@ -202,7 +199,7 @@ export function registerPrintCommand(program) {
         if (getInteractiveTerminalSupport().supported) {
             const { waitUntilExit } = render(createElement(ValidateView, {
                 results: viewResults,
-                onExit: () => void exitWithAnalytics(exitCode),
+                onExit: () => process.exit(exitCode),
             }));
             await waitUntilExit();
         }
@@ -215,7 +212,7 @@ export function registerPrintCommand(program) {
             }))
                 .join('\n\n');
             process.stdout.write(output + '\n');
-            await exitWithAnalytics(exitCode);
+            process.exit(exitCode);
         }
     });
 }

package/dist/src/program.js

@@ -12,7 +12,6 @@ import { registerImportCommand } from './import/command.js';
 import { registerSetupCommand } from './setup/command.js';
 import { registerRunsCommand } from './runs/ls-command.js';
 import { beginCommand } from './lib/debug-preamble.js';
-import { completeActiveCommand, flushAnalytics, noteCommandStart } from './analytics/index.js';
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
 /**
@@ -90,13 +89,7 @@ export function createProgram() {
         const chain = [];
         for (let c = actionCommand; c && c.parent; c = c.parent)
             chain.unshift(c.name());
-        const commandChain = chain.join(' ') || actionCommand.name();
-        noteCommandStart(commandChain);
-        await beginCommand(commandChain, { ...(debug !== undefined ? { debug } : {}) });
-    });
-    program.hook('postAction', async () => {
-        await completeActiveCommand();
-        await flushAnalytics();
+        await beginCommand(chain.join(' ') || actionCommand.name(), { ...(debug !== undefined ? { debug } : {}) });
     });
     return program;
 }

package/dist/src/runs/modify-launcher.d.ts

@@ -26,5 +26,7 @@ export type ModifyLauncherInput = {
     initialHost?: string;
     /** Pre-fill CMA token (from credentials.json / env). */
     initialCmaToken?: string;
+    /** From `--allow-deletions` flag. Forwarded to wizard's push step. */
+    allowDeletions?: boolean;
 };
 export declare function launchModifyWizard(input: ModifyLauncherInput): Promise<void>;

package/dist/src/runs/modify-launcher.js

@@ -35,6 +35,8 @@ export async function launchModifyWizard(input) {
         props.initialHost = input.initialHost;
     if (input.initialCmaToken)
         props.initialCmaToken = input.initialCmaToken;
+    if (input.allowDeletions !== undefined)
+        props.allowDeletions = input.allowDeletions;
     const { waitUntilExit } = render(createElement(WizardApp, props));
     await waitUntilExit();
 }

package/dist/src/runs/push-helpers.d.ts

@@ -15,6 +15,7 @@ export type PushSessionOptions = {
     environmentId: string;
     cmaToken: string;
     host?: string;
+    allowDeletions?: boolean;
 };
 /**
  * Push a recorded pipeline.db session's components + tokens to Contentful by

package/dist/src/runs/push-helpers.js

@@ -60,6 +60,9 @@ export async function pushRunSession(opts) {
     if (opts.host) {
         args.push('--host', opts.host);
     }
+    if (opts.allowDeletions) {
+        args.push('--allow-deletions');
+    }
     const r = await runCli(args);
     if (r.exitCode === 0)
         return { ok: true };

package/dist/src/runs/replay-helpers.d.ts

@@ -16,6 +16,8 @@ export type ReplayRunOptions = {
     interactive?: boolean;
     /** When true, bypass the source/saved-file staleness check. */
     force?: boolean;
+    /** From `--allow-deletions` flag. Forwarded verbatim to the pushed session's apply request. */
+    allowDeletions?: boolean;
     /**
      * Test seam: replace the interactive prompt with a deterministic resolver.
      * The CLI surface never sets this; only used by tests.
@@ -57,6 +59,8 @@ export type ModifyRunOptions = {
     outDir?: string;
     /** When true, bypass the source/saved-file staleness check. */
     force?: boolean;
+    /** From `--allow-deletions` flag. Forwarded through the modify wizard's push step. */
+    allowDeletions?: boolean;
 };
 /**
  * Re-open the wizard with a prior run's extract/generate session pre-populated

package/dist/src/runs/replay-helpers.js

@@ -83,6 +83,7 @@ export async function replayRun(opts) {
         environmentId,
         cmaToken,
         ...(host ? { host } : {}),
+        ...(opts.allowDeletions ? { allowDeletions: true } : {}),
     });
     if (!result.ok) {
         throw new Error(result.error);
@@ -98,6 +99,7 @@ export async function replayRun(opts) {
             environmentId,
             cmaToken,
             ...(host ? { host } : {}),
+            ...(opts.allowDeletions ? { allowDeletions: true } : {}),
         });
         if (!tokenResult.ok) {
             throw new Error(tokenResult.error);
@@ -157,5 +159,6 @@ export async function modifyRun(opts) {
         ...(mergedEnvironmentId ? { initialEnvironmentId: mergedEnvironmentId } : {}),
         ...(mergedHost ? { initialHost: mergedHost } : {}),
         ...(mergedCmaToken ? { initialCmaToken: mergedCmaToken } : {}),
+        ...(opts.allowDeletions !== undefined ? { allowDeletions: opts.allowDeletions } : {}),
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.23.2-dev-build-753ceef.0",
+  "version": "2.23.2-dev-build-e996ffb.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -28,16 +28,15 @@
     "prompts/"
   ],
   "dependencies": {
-    "@segment/analytics-node": "^3.0.0",
     "commander": "^13.1.0",
     "ink": "^4.4.1",
     "react": "^18.3.1",
     "react-devtools-core": "^4.19.1",
     "react-dom": "^18.3.1",
-    "@contentful/experience-design-system-client": "2.23.2-dev-build-753ceef.0",
-    "@contentful/experience-design-system-extraction": "2.23.2-dev-build-753ceef.0",
-    "@contentful/experience-design-system-types": "2.23.2-dev-build-753ceef.0",
-    "@contentful/experience-design-system-generation": "2.23.2-dev-build-753ceef.0"
+    "@contentful/experience-design-system-client": "2.23.2-dev-build-e996ffb.0",
+    "@contentful/experience-design-system-generation": "2.23.2-dev-build-e996ffb.0",
+    "@contentful/experience-design-system-extraction": "2.23.2-dev-build-e996ffb.0",
+    "@contentful/experience-design-system-types": "2.23.2-dev-build-e996ffb.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",

package/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/dist/src/analytics/apply.js

@@ -1,30 +0,0 @@
-import { enrichCommandResult, setCommandContext } from './tracker.js';
-function countWriteResult(items, entityType) {
-    const subset = items.filter((item) => item.entityType === entityType);
-    return {
-        created_count: subset.filter((item) => item.action === 'create' && item.status === 'succeeded').length,
-        updated_count: subset.filter((item) => item.action === 'update' && item.status === 'succeeded').length,
-        failed_count: subset.filter((item) => item.status === 'failed').length,
-    };
-}
-/** Record apply/preview API outcomes on the active command. */
-export function recordApplyOutcome(client, spaceId, environmentId, operation) {
-    setCommandContext({
-        space_key: spaceId,
-        environment_key: environmentId,
-        x_contentful_request_id: client.getLastRequestId(),
-    });
-    enrichCommandResult({
-        dsi_operation_id: operation.sys.id,
-        component_type_result: countWriteResult(operation.items ?? [], 'ComponentType'),
-        design_token_result: countWriteResult(operation.items ?? [], 'DesignToken'),
-    });
-}
-/** Record Contentful target context without an apply operation (e.g. preview-only). */
-export function recordContentfulContext(client, spaceId, environmentId) {
-    setCommandContext({
-        space_key: spaceId,
-        environment_key: environmentId,
-        x_contentful_request_id: client.getLastRequestId(),
-    });
-}

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

@@ -1,7 +0,0 @@
-export declare function cliVersion(): string;
-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/dist/src/analytics/client.js

@@ -1,68 +0,0 @@
-import { createRequire } from 'node:module';
-import { Analytics } from '@segment/analytics-node';
-const require = createRequire(import.meta.url);
-const pkg = require('../../package.json');
-// Anonymous usage telemetry for the CLI. Disabled when DISABLE_ANALYTICS is set
-// or when no write key is configured. Never blocks command execution.
-let analyticsClient = null;
-export function cliVersion() {
-    return pkg.version;
-}
-export function analyticsEnabled() {
-    return !process.env.DISABLE_ANALYTICS && Boolean(resolveWriteKey());
-}
-function resolveWriteKey() {
-    const key = (process.env.SEGMENT_WRITE_KEY ?? '').trim();
-    return key.length > 0 ? key : undefined;
-}
-function getClient() {
-    if (!analyticsEnabled())
-        return null;
-    const writeKey = resolveWriteKey();
-    if (!writeKey)
-        return null;
-    if (!analyticsClient) {
-        analyticsClient = new Analytics({ writeKey });
-        analyticsClient.on('error', () => {
-            /* never block the CLI on telemetry errors */
-        });
-    }
-    return analyticsClient;
-}
-export async function trackEvent(event, properties, anonymousId, options) {
-    const client = getClient();
-    if (!client)
-        return;
-    try {
-        client.track({
-            event,
-            properties,
-            anonymousId,
-            timestamp: new Date(),
-        });
-        if (options?.flush)
-            await flushAnalytics();
-    }
-    catch {
-        // Telemetry must never affect CLI exit codes or output.
-    }
-}
-// CLI processes are short-lived — we flush (and recreate the client) after each
-// event so terminal telemetry survives process.exit. Do not "optimize" this into
-// a deferred batch flush on process exit; Node will not await async exit hooks.
-export async function flushAnalytics() {
-    if (!analyticsClient)
-        return;
-    try {
-        await analyticsClient.closeAndFlush();
-    }
-    catch {
-        // Swallow — telemetry must never affect CLI behavior.
-    }
-    finally {
-        analyticsClient = null;
-    }
-}
-export function resetAnalyticsClientForTests() {
-    analyticsClient = null;
-}

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

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

package/dist/src/analytics/constants.js

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

package/dist/src/analytics/env.d.ts

@@ -1,4 +0,0 @@
-/** Merge pipeline analytics env into a subprocess environment. */
-export declare function analyticsEnvForSubprocess(env: NodeJS.ProcessEnv, analyticsSessionId: string): NodeJS.ProcessEnv;
-/** Debug + pipeline analytics env for orchestrator subprocesses. */
-export declare function pipelineSubprocessEnv(env: NodeJS.ProcessEnv, analyticsSessionId: string): NodeJS.ProcessEnv;

package/dist/src/analytics/env.js

@@ -1,14 +0,0 @@
-import { debugEnvForSubprocess } from '../lib/debug-logger.js';
-import { ANALYTICS_SESSION_ENV, IMPORT_PIPELINE_ENV } from './constants.js';
-/** Merge pipeline analytics env into a subprocess environment. */
-export function analyticsEnvForSubprocess(env, analyticsSessionId) {
-    return {
-        ...env,
-        [IMPORT_PIPELINE_ENV]: '1',
-        [ANALYTICS_SESSION_ENV]: analyticsSessionId,
-    };
-}
-/** Debug + pipeline analytics env for orchestrator subprocesses. */
-export function pipelineSubprocessEnv(env, analyticsSessionId) {
-    return analyticsEnvForSubprocess(debugEnvForSubprocess(env), analyticsSessionId);
-}

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

@@ -1,5 +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;
-export declare function failureFromUnknown(error: unknown): CommandFailure;

package/dist/src/analytics/exit.js

@@ -1,24 +0,0 @@
-import { flushAnalytics } from './client.js';
-import { completeActiveCommand, failActiveCommand } from './tracker.js';
-export async function exitWithAnalytics(code, fields = {}) {
-    if (code === 0)
-        await completeActiveCommand();
-    else
-        await failActiveCommand({ exit_code: code, ...fields });
-    await flushAnalytics();
-    process.exit(code);
-    throw new Error('unreachable');
-}
-export function failureFromApiError(error) {
-    return {
-        error_name: error.name,
-        http_status_code: error.status,
-        exit_code: 1,
-    };
-}
-export function failureFromUnknown(error) {
-    if (error instanceof Error) {
-        return { error_name: error.name, exit_code: 1 };
-    }
-    return { error_name: 'Error', exit_code: 1 };
-}

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

@@ -1,10 +0,0 @@
-export { ANALYTICS_SESSION_ENV, IMPORT_PIPELINE_ENV } from './constants.js';
-export { analyticsEnvForSubprocess, pipelineSubprocessEnv } from './env.js';
-export { exitWithAnalytics, failureFromApiError, failureFromUnknown } from './exit.js';
-export { analyticsEnabled, cliVersion, flushAnalytics, resetAnalyticsClientForTests, trackEvent } from './client.js';
-export { isPipelineAnalyticsChild, resolveAnalyticsSessionId } from './session.js';
-export { normalizeCommand } from './normalize.js';
-export { getOsName } from './os.js';
-export { bindAnalyticsSession, bindAnalyticsSessionId, completeActiveCommand, emitSessionStarted, enrichCommandResult, failActiveCommand, getBoundSessionId, noteCommandStart, resetAnalyticsStateForTests, setCommandContext, } from './tracker.js';
-export { recordApplyOutcome, recordContentfulContext } from './apply.js';
-export type { CommandCompletion, CommandContext, CommandFailure, DsiCliCommand, EntryCommand, OsName, WriteResult, } from './types.js';

package/dist/src/analytics/index.js

@@ -1,9 +0,0 @@
-export { ANALYTICS_SESSION_ENV, IMPORT_PIPELINE_ENV } from './constants.js';
-export { analyticsEnvForSubprocess, pipelineSubprocessEnv } from './env.js';
-export { exitWithAnalytics, failureFromApiError, failureFromUnknown } from './exit.js';
-export { analyticsEnabled, cliVersion, flushAnalytics, resetAnalyticsClientForTests, trackEvent } from './client.js';
-export { isPipelineAnalyticsChild, resolveAnalyticsSessionId } from './session.js';
-export { normalizeCommand } from './normalize.js';
-export { getOsName } from './os.js';
-export { bindAnalyticsSession, bindAnalyticsSessionId, completeActiveCommand, emitSessionStarted, enrichCommandResult, failActiveCommand, getBoundSessionId, noteCommandStart, resetAnalyticsStateForTests, setCommandContext, } from './tracker.js';
-export { recordApplyOutcome, recordContentfulContext } from './apply.js';

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

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

package/dist/src/analytics/normalize.js

@@ -1,18 +0,0 @@
-const COMMAND_MAP = {
-    'analyze extract': 'analyze_extract',
-    'analyze select': 'analyze_select',
-    'analyze select-agent': 'analyze_select',
-    'generate components': 'generate_components',
-    'generate tokens': 'generate_tokens',
-    'generate edit': 'generate_edit',
-    'apply preview': 'apply_preview',
-    'apply select': 'apply_select',
-    'apply push': 'apply_push',
-    'print components': 'print_components',
-    'print tokens': 'print_tokens',
-    import: 'import',
-};
-/** Map a Commander command chain (e.g. "apply push") to a tracked command id, if any. */
-export function normalizeCommand(commandChain) {
-    return COMMAND_MAP[commandChain];
-}

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

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

package/dist/src/analytics/os.js

@@ -1,13 +0,0 @@
-const OS_NAMES = {
-    android: 'Android',
-    aix: 'Linux',
-    darwin: 'macOS',
-    freebsd: 'Linux',
-    linux: 'Linux',
-    openbsd: 'Linux',
-    sunos: 'Linux',
-    win32: 'Windows',
-};
-export function getOsName() {
-    return OS_NAMES[process.platform] ?? 'other';
-}

package/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/dist/src/analytics/session.js

@@ -1,15 +0,0 @@
-import { generateSessionId } from '../session/session-id.js';
-import { ANALYTICS_SESSION_ENV } from './constants.js';
-/** Prefer the pipeline parent session, then an explicit id, then a new slug. */
-export function resolveAnalyticsSessionId(explicit) {
-    const inherited = process.env[ANALYTICS_SESSION_ENV]?.trim();
-    if (inherited)
-        return inherited;
-    const passed = explicit?.trim();
-    if (passed)
-        return passed;
-    return generateSessionId();
-}
-export function isPipelineAnalyticsChild() {
-    return Boolean(process.env[ANALYTICS_SESSION_ENV]?.trim());
-}

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

@@ -1,17 +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;
-export declare function getBoundSessionId(): string | undefined;
-/** 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/dist/src/analytics/tracker.js

@@ -1,126 +0,0 @@
-import { cliVersion, trackEvent } from './client.js';
-import { IMPORT_PIPELINE_ENV } from './constants.js';
-import { normalizeCommand } from './normalize.js';
-import { getOsName } from './os.js';
-import { resolveAnalyticsSessionId } from './session.js';
-let pending = null;
-let sessionId;
-let sessionStartedEmitted = false;
-function isPipelineStep() {
-    return process.env[IMPORT_PIPELINE_ENV] === '1';
-}
-function buildBaseProps(command) {
-    return {
-        dsi_session_id: sessionId,
-        command,
-        ...(isPipelineStep() ? { is_pipeline_step: true } : {}),
-    };
-}
-function mergeContext(target, source) {
-    if (source.space_key !== undefined)
-        target.space_key = source.space_key;
-    if (source.environment_key !== undefined)
-        target.environment_key = source.environment_key;
-    if (source.x_contentful_request_id !== undefined) {
-        target.x_contentful_request_id = source.x_contentful_request_id;
-    }
-}
-/** Record the start of a tracked command. Invoked is deferred until a session is bound. */
-export function noteCommandStart(commandChain) {
-    const command = normalizeCommand(commandChain);
-    if (!command)
-        return;
-    pending = {
-        command,
-        startedAt: Date.now(),
-        invoked: false,
-        terminalEmitted: false,
-        context: {},
-        completion: {},
-    };
-}
-/** Bind a session id, preferring a pipeline parent id when present. */
-export async function bindAnalyticsSessionId(sessionId, context) {
-    const id = resolveAnalyticsSessionId(sessionId);
-    await bindAnalyticsSession(id, context);
-    return id;
-}
-/** Attach Contentful target context for the active command. */
-export function setCommandContext(context) {
-    if (!pending)
-        return;
-    mergeContext(pending.context, context);
-    mergeContext(pending.completion, context);
-}
-/** Merge optional completion fields before the terminal event fires. */
-export function enrichCommandResult(fields) {
-    if (!pending)
-        return;
-    Object.assign(pending.completion, fields);
-    mergeContext(pending.context, fields);
-}
-export function getBoundSessionId() {
-    return sessionId;
-}
-/** Bind the pipeline session and emit invoked once both command and session are known. */
-export async function bindAnalyticsSession(id, context) {
-    sessionId = id;
-    if (context)
-        setCommandContext(context);
-    await emitInvokedIfReady();
-}
-/** Emit session_started once per new pipeline head. */
-export async function emitSessionStarted(entryCommand) {
-    if (!sessionId || sessionStartedEmitted)
-        return;
-    sessionStartedEmitted = true;
-    await trackEvent('dsi_cli_session_started', {
-        dsi_session_id: sessionId,
-        entry_command: entryCommand,
-        cli_version: cliVersion(),
-        node_version: process.version,
-        os_name: getOsName(),
-    }, sessionId, { flush: true });
-    await emitInvokedIfReady();
-}
-async function emitInvokedIfReady() {
-    if (!pending || pending.invoked || !sessionId)
-        return;
-    pending.invoked = true;
-    await trackEvent('dsi_cli_command_invoked', {
-        ...buildBaseProps(pending.command),
-        ...pending.context,
-    }, sessionId, { flush: true });
-}
-export async function completeActiveCommand() {
-    if (!pending || pending.terminalEmitted || !sessionId || !pending.invoked)
-        return;
-    pending.terminalEmitted = true;
-    const durationMs = Date.now() - pending.startedAt;
-    await trackEvent('dsi_cli_command_completed', {
-        ...buildBaseProps(pending.command),
-        ...pending.context,
-        ...pending.completion,
-        outcome: 'ok',
-        duration_ms: durationMs,
-    }, sessionId, { flush: true });
-}
-export async function failActiveCommand(fields = {}) {
-    if (!pending || pending.terminalEmitted || !sessionId || !pending.invoked)
-        return;
-    pending.terminalEmitted = true;
-    const durationMs = Date.now() - pending.startedAt;
-    const outcome = fields.exit_code === 130 ? 'interrupted' : 'error';
-    await trackEvent('dsi_cli_command_failed', {
-        ...buildBaseProps(pending.command),
-        ...pending.context,
-        ...fields,
-        outcome,
-        duration_ms: durationMs,
-    }, sessionId, { flush: true });
-}
-export function resetAnalyticsStateForTests() {
-    pending = null;
-    sessionId = undefined;
-    sessionStartedEmitted = false;
-}