@contentful/experience-design-system-cli 2.32.1-dev-build-23e5797.0 → 2.32.1-dev-build-4052dd5.0

package/dist/src/session/core/cdf/cdf-mappers.d.ts

@@ -0,0 +1,3 @@
+export type CdfCategory = 'content' | 'design' | 'state';
+export declare function mapContentfulTypeToCdfType(contentfulType: string): string;
+export declare function resolveCdfCategory(contentfulCategory: string | null | undefined, propName: string, contentProps: Set<string>, designProps: Set<string>): CdfCategory;

package/dist/src/session/core/components/derive-component-id.d.ts

@@ -0,0 +1 @@
+export declare function deriveComponentId(name: string, source: string): string;

package/dist/src/session/core/components/hash-component-shape.d.ts

@@ -0,0 +1,5 @@
+import type { RawComponentDefinition } from '../../../types.js';
+export type RawComponentForHash = RawComponentDefinition & {
+    component_id?: string;
+};
+export declare function hashComponentShape(component: RawComponentForHash): string;

package/dist/src/session/core/shared/index-rows-by-key.d.ts

@@ -0,0 +1 @@
+export declare function indexRowsByKey<T>(items: T[], key: (item: T) => string): Map<string, T[]>;

package/dist/src/session/core/tokens/build-dtcg-groups.d.ts

@@ -0,0 +1,12 @@
+import type { DTCGTokenGroup } from '@contentful/experience-design-system-types';
+export interface GroupRow {
+    path: string;
+    description: string | null;
+}
+export interface TokenRow {
+    path: string;
+    type: string;
+    value: string;
+    description: string | null;
+}
+export declare function buildDtcgGroups(groupRows: GroupRow[], tokenRows: TokenRow[]): DTCGTokenGroup[];

package/dist/src/session/core/tokens/build-dtcg-tokens.d.ts

@@ -0,0 +1,3 @@
+import type { DTCGTokenEntry } from '@contentful/experience-design-system-types';
+import type { TokenRow } from './build-dtcg-groups.js';
+export declare function buildDtcgTokens(tokenRows: TokenRow[]): DTCGTokenEntry[];

package/dist/src/session/core/tokens/hash-token-content.d.ts

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

package/dist/src/session/db.d.ts

@@ -1,9 +1,21 @@
 import { DatabaseSync } from 'node:sqlite';
 import type { RawComponentDefinition } from '../types.js';
-import type { CDFComponentEntry, DTCGTokenEntry, DTCGTokenGroup } from '@contentful/experience-design-system-types';
-import type { ToolCall, TokenToolCall, ComponentSourceRef } from '@contentful/experience-design-system-generation';
+import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
+import type { ToolCall, ComponentSourceRef } from '@contentful/experience-design-system-generation';
 import type { ComponentTypeSummary } from '@contentful/experience-design-system-types';
 import type { SlotCycle, SlotEdge } from '../analyze/cycle-detection.js';
+import { type MatchHints as SessionMatchHints } from './repositories/sessions/read.js';
+import { type SessionResolution } from './services/session-resolver.js';
+export { deriveComponentId } from './core/components/derive-component-id.js';
+export { hashComponentShape as computeComponentInputHash } from './core/components/hash-component-shape.js';
+export { hashTokenContent as computeTokenInputHash } from './core/tokens/hash-token-content.js';
+export { mapContentfulTypeToCdfType, resolveCdfCategory } from './core/cdf/cdf-mappers.js';
+export { getDtcgTokensForSession as loadDTCGTokens, getRawTokenNamePaths as loadRawTokenNamePaths, getRawTokenNamePathRows as loadRawTokenNamePathRows, type RawTokenNamePaths, type RawTokenNamePathSource, type RawTokenNamePath, } from './repositories/tokens/read.js';
+export { type RawPropTokenPathSource } from './repositories/tokens/write.js';
+export { storeDtcgTokens as storeDTCGTokens } from './services/tokens/store-dtcg-tokens.js';
+export { applyTokenToolCalls, type ApplyTokenToolCallsResult } from './services/tokens/apply-tool-calls.js';
+export { replaceRawTokenNamePaths } from './services/tokens/replace-raw-token-name-paths.js';
+export { replaceRawPropTokenPaths } from './services/tokens/replace-raw-prop-token-paths.js';
 export type StepStatus = 'pending' | 'complete' | 'failed' | 'interrupted';
 export type CommandName = 'analyze extract' | 'analyze select' | 'generate components' | 'generate tokens' | 'generate edit' | 'apply preview' | 'apply select' | 'apply push' | 'print components' | 'print tokens' | 'map tokens' | 'fetch existing entities' | 'import';
 export interface SessionRow {
@@ -26,30 +38,6 @@ export interface StepRow {
 }
 export declare function getPipelineDbPath(): string;
 export declare function openPipelineDb(dbPath?: string): DatabaseSync;
-/** An exact source token reference paired with its canonical DTCG path. */
-export type RawTokenNamePaths = Record<string, string>;
-export type RawTokenNamePathSource = 'automatic' | 'manual';
-export interface RawTokenNamePath {
-    rawName: string;
-    path: string;
-    source: RawTokenNamePathSource;
-}
-/**
- * Replaces the session's exact source-reference-to-DTCG-path sidecar.
- * Source references are retained verbatim; normalisation belongs to the
- * deterministic resolver, not to persistence or CDF emission.
- */
-export declare function replaceRawTokenNamePaths(db: DatabaseSync, sessionId: string, tokenNamePaths: RawTokenNamePaths, source?: RawTokenNamePathSource): void;
-/** Loads the exact source-reference-to-DTCG-path sidecar for a session. */
-export declare function loadRawTokenNamePaths(db: DatabaseSync, sessionId: string): RawTokenNamePaths;
-export declare function loadRawTokenNamePathRows(db: DatabaseSync, sessionId: string): RawTokenNamePath[];
-/**
- * Where a prop's token-path list came from. 'agent' is a map-tokens suggestion,
- * which a later run of that step may revise. 'review' is a person's decision in
- * the review editor, which a re-run must leave alone.
- */
-export type RawPropTokenPathSource = 'agent' | 'review';
-export declare function replaceRawPropTokenPaths(db: DatabaseSync, sessionId: string, componentId: string, propName: string, paths: string[], source: RawPropTokenPathSource): void;
 export interface ApplyToolCallsResult {
     classified: number;
     excluded: number;
@@ -86,17 +74,9 @@ export interface ComponentRationale {
 }
 export declare function loadComponentRationale(db: DatabaseSync, sessionId: string, componentName: string): ComponentRationale | null;
 export declare function applyToolCalls(db: DatabaseSync, sessionId: string, componentId: string, componentName: string, calls: ToolCall[], incomingWarnings: string[]): ApplyToolCallsResult;
-export interface MatchHints {
-    command: CommandName;
-    inputPath?: string;
-    outDir?: string;
-}
-export interface SessionResolution {
-    sessionId: string;
-    isNew: boolean;
-    isResumed: boolean;
-}
-export declare function getOrCreateSession(db: DatabaseSync, sessionFlag: string | undefined, sessionName: string | undefined, _hints: MatchHints): SessionResolution;
+export type MatchHints = SessionMatchHints;
+export type { SessionResolution };
+export declare function getOrCreateSession(db: DatabaseSync, sessionFlag: string | undefined, sessionName: string | undefined, hints: MatchHints): SessionResolution;
 export declare function createStep(db: DatabaseSync, sessionId: string, command: CommandName, inputs: Record<string, string>): number;
 export declare function updateStep(db: DatabaseSync, stepId: number, status: 'complete' | 'failed', outputs: Record<string, string>, error?: string): void;
 export declare function storeRawComponents(db: DatabaseSync, sessionId: string, components: RawComponentDefinition[], options?: {
@@ -140,17 +120,6 @@ export declare function applyScopeDecisions(db: DatabaseSync, sessionId: string,
     accepted: string[];
     rejected: string[];
 }): void;
-export declare function storeDTCGTokens(db: DatabaseSync, sessionId: string, groups: DTCGTokenGroup[], tokens: DTCGTokenEntry[]): void;
-export interface ApplyTokenToolCallsResult {
-    tokens: number;
-    groups: number;
-    warnings: string[];
-}
-export declare function applyTokenToolCalls(db: DatabaseSync, sessionId: string, calls: TokenToolCall[], incomingWarnings: string[]): ApplyTokenToolCallsResult;
-export declare function loadDTCGTokens(db: DatabaseSync, sessionId: string): {
-    groups: DTCGTokenGroup[];
-    tokens: DTCGTokenEntry[];
-};
 export declare function findLatestSessionForCommand(db: DatabaseSync, command: CommandName): string | null;
 export declare function seedCDFFromPriorSession(db: DatabaseSync, targetSessionId: string): number;
 export declare function seedCDFFromPreviewResponse(db: DatabaseSync, sessionId: string, removedItems: ComponentTypeSummary[]): number;
@@ -170,8 +139,6 @@ export interface CacheEntry {
     createdAt: string;
     updatedAt: string;
 }
-export declare function computeComponentInputHash(component: RawComponentWithId): string;
-export declare function computeTokenInputHash(rawTokenContent: string): string;
 export declare function computeMapTokensInputHash(db: DatabaseSync, sessionId: string, componentSourceRefs?: readonly ComponentSourceRef[]): string;
 export declare function lookupCache(db: DatabaseSync, inputHash: string, entityType: CacheEntityType, entityId: string, promptHash?: string): CacheEntry | null;
 export declare function lookupCacheByEntity(db: DatabaseSync, entityType: CacheEntityType, entityId: string): CacheEntry | null;

package/dist/src/session/repositories/sessions/read.d.ts

@@ -0,0 +1,11 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { CommandName } from '../../db.js';
+export interface MatchHints {
+    command: CommandName;
+    inputPath?: string;
+    outDir?: string;
+}
+export declare function getSessionById(db: DatabaseSync, sessionId: string): {
+    id: string;
+} | null;
+export declare function getLatestCompletedSessionForCommand(db: DatabaseSync, command: CommandName): string | null;

package/dist/src/session/repositories/sessions/write.d.ts

@@ -0,0 +1,3 @@
+import type { DatabaseSync } from 'node:sqlite';
+export declare function createSession(db: DatabaseSync, id: string, name: string | null, timestamp: string): void;
+export declare function updateSessionTimestamp(db: DatabaseSync, sessionId: string, timestamp: string): void;

package/dist/src/session/repositories/shared/with-transaction.d.ts

@@ -0,0 +1,2 @@
+import type { DatabaseSync } from 'node:sqlite';
+export declare function withTransaction<T>(db: DatabaseSync, fn: () => T): T;

package/dist/src/session/repositories/steps/read.d.ts

@@ -0,0 +1,2 @@
+import type { DatabaseSync } from 'node:sqlite';
+export declare function getSessionIdForStep(db: DatabaseSync, stepId: number): string | null;

package/dist/src/session/repositories/steps/write.d.ts

@@ -0,0 +1,5 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { CommandName } from '../../db.js';
+export declare function updatePendingStepsToInterrupted(db: DatabaseSync, sessionId: string, command: CommandName, timestamp: string): void;
+export declare function createPendingStep(db: DatabaseSync, sessionId: string, command: CommandName, inputs: Record<string, string>, timestamp: string): number;
+export declare function updateStepStatus(db: DatabaseSync, stepId: number, status: 'complete' | 'failed', outputs: Record<string, string>, error: string | null, timestamp: string): void;

package/dist/src/session/repositories/tokens/read.d.ts

@@ -0,0 +1,15 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { DTCGTokenEntry, DTCGTokenGroup } from '@contentful/experience-design-system-types';
+export type RawTokenNamePaths = Record<string, string>;
+export type RawTokenNamePathSource = 'automatic' | 'manual';
+export interface RawTokenNamePath {
+    rawName: string;
+    path: string;
+    source: RawTokenNamePathSource;
+}
+export declare function getDtcgTokensForSession(db: DatabaseSync, sessionId: string): {
+    groups: DTCGTokenGroup[];
+    tokens: DTCGTokenEntry[];
+};
+export declare function getRawTokenNamePaths(db: DatabaseSync, sessionId: string): RawTokenNamePaths;
+export declare function getRawTokenNamePathRows(db: DatabaseSync, sessionId: string): RawTokenNamePath[];

package/dist/src/session/repositories/tokens/write.d.ts

@@ -0,0 +1,16 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { DTCGTokenEntry, DTCGTokenGroup } from '@contentful/experience-design-system-types';
+import type { TokenToolCall } from '@contentful/experience-design-system-generation';
+import type { RawTokenNamePaths, RawTokenNamePathSource } from './read.js';
+export type RawPropTokenPathSource = 'agent' | 'review';
+export declare function deleteRawTokensForSession(db: DatabaseSync, sessionId: string): void;
+export declare function createRawTokenGroups(db: DatabaseSync, sessionId: string, groups: DTCGTokenGroup[]): void;
+export declare function createRawTokens(db: DatabaseSync, sessionId: string, tokens: DTCGTokenEntry[]): void;
+export declare function upsertRawToken(db: DatabaseSync, sessionId: string, call: Extract<TokenToolCall, {
+    tool: 'set_token';
+}>): void;
+export declare function upsertRawTokenGroup(db: DatabaseSync, sessionId: string, call: Extract<TokenToolCall, {
+    tool: 'set_group';
+}>): void;
+export declare function updateRawTokenNamePaths(db: DatabaseSync, sessionId: string, tokenNamePaths: RawTokenNamePaths, source: RawTokenNamePathSource): void;
+export declare function updateRawPropTokenPaths(db: DatabaseSync, sessionId: string, componentId: string, propName: string, paths: string[], source: RawPropTokenPathSource): void;

package/dist/src/session/services/session-resolver.d.ts

@@ -0,0 +1,9 @@
+import type { DatabaseSync } from 'node:sqlite';
+import { type MatchHints } from '../repositories/sessions/read.js';
+export type { MatchHints };
+export interface SessionResolution {
+    sessionId: string;
+    isNew: boolean;
+    isResumed: boolean;
+}
+export declare function getOrCreateSessionForCommand(db: DatabaseSync, sessionFlag: string | undefined, sessionName: string | undefined, _hints: MatchHints): SessionResolution;

package/dist/src/session/services/tokens/apply-tool-calls.d.ts

@@ -0,0 +1,8 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { TokenToolCall } from '@contentful/experience-design-system-generation';
+export interface ApplyTokenToolCallsResult {
+    tokens: number;
+    groups: number;
+    warnings: string[];
+}
+export declare function applyTokenToolCalls(db: DatabaseSync, sessionId: string, calls: TokenToolCall[], incomingWarnings: string[]): ApplyTokenToolCallsResult;

package/dist/src/session/services/tokens/replace-raw-prop-token-paths.d.ts

@@ -0,0 +1,3 @@
+import type { DatabaseSync } from 'node:sqlite';
+import { type RawPropTokenPathSource } from '../../repositories/tokens/write.js';
+export declare function replaceRawPropTokenPaths(db: DatabaseSync, sessionId: string, componentId: string, propName: string, paths: string[], source: RawPropTokenPathSource): void;

package/dist/src/session/services/tokens/replace-raw-token-name-paths.d.ts

@@ -0,0 +1,3 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { RawTokenNamePaths, RawTokenNamePathSource } from '../../repositories/tokens/read.js';
+export declare function replaceRawTokenNamePaths(db: DatabaseSync, sessionId: string, tokenNamePaths: RawTokenNamePaths, source?: RawTokenNamePathSource): void;

package/dist/src/session/services/tokens/store-dtcg-tokens.d.ts

@@ -0,0 +1,3 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { DTCGTokenEntry, DTCGTokenGroup } from '@contentful/experience-design-system-types';
+export declare function storeDtcgTokens(db: DatabaseSync, sessionId: string, groups: DTCGTokenGroup[], tokens: DTCGTokenEntry[]): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.32.1-dev-build-23e5797.0",
+  "version": "2.32.1-dev-build-4052dd5.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -40,8 +40,8 @@
     "svelte": "^5.56.4",
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
-    "@contentful/experience-design-system-cli-v2": "2.32.1-dev-build-23e5797.0",
-    "@contentful/experience-design-system-types": "2.32.1-dev-build-23e5797.0"
+    "@contentful/experience-design-system-types": "2.32.1-dev-build-4052dd5.0",
+    "@contentful/experience-design-system-cli-v2": "2.32.1-dev-build-4052dd5.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",
@@ -53,9 +53,9 @@
     "ink-testing-library": "^4.0.0",
     "typescript-eslint": "^8.67.0",
     "vitest": "^4.0.16",
-    "@contentful/experience-design-system-extraction": "2.32.1-dev-build-23e5797.0",
-    "@contentful/experience-design-system-client": "2.32.1-dev-build-23e5797.0",
-    "@contentful/experience-design-system-generation": "2.32.1-dev-build-23e5797.0"
+    "@contentful/experience-design-system-generation": "2.32.1-dev-build-4052dd5.0",
+    "@contentful/experience-design-system-client": "2.32.1-dev-build-4052dd5.0",
+    "@contentful/experience-design-system-extraction": "2.32.1-dev-build-4052dd5.0"
   },
   "repository": {
     "type": "git",