@se-studio/contentful-cms 0.0.0-next16-20260822103555

package/dist/session/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/session/log.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAElE,0FAA0F;AAC1F,SAAS,eAAe,CAAC,IAAY;IACnC,eAAe,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7C,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,MAAM,CAAC;AAC3C,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,OAAiC;IAChF,IAAI,CAAC,uBAAuB,EAAE;QAAE,OAAO;IACvC,eAAe,CAAC,sBAAsB,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChG,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,OAAiC;IACzE,eAAe,CAAC,sBAAsB,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChG,CAAC"}

package/dist/session/redis-session-store.d.ts

@@ -0,0 +1,40 @@
+import { type RedisClient, type SessionStore } from './session-store.js';
+import type { SessionState } from './state.js';
+/** Parses session JSON from Redis — Upstash may return a deserialized object. */
+export declare function parseSessionValue(raw: unknown): SessionState | null;
+/** Coerces Redis active-pointer values (Upstash may return non-string shapes). */
+export declare function coerceActivePointerValue(raw: unknown): string | null;
+/**
+ * Space id for multi-tenant Redis isolation on shared cmsedit-sessions.
+ * Prefer explicit arg; fall back to host env (CONTENTFUL_SPACE_ID).
+ */
+export declare function resolveSessionSpaceId(explicit?: string): string | undefined;
+export declare class RedisSessionStore implements SessionStore {
+    private readonly redis;
+    private readonly keyPrefix;
+    constructor(redis: RedisClient, keyPrefix?: string);
+    private fullKey;
+    /**
+     * Active pointer is space-scoped so shared Redis across hosts does not
+     * cross-load sessions for the same Contentful user.
+     * - default: cms-edit:session:{userId}:active:{spaceId}
+     * - named:   cms-edit:session:{userId}:active:{spaceId}:{sessionName}
+     */
+    private activePointerKey;
+    /**
+     * SET of full Redis keys (session blobs + pointers) for this user+space.
+     * Enables clearAll without KEYS scans on shared Upstash.
+     */
+    private spaceIndexKey;
+    private getUserId;
+    load(spaceId?: string, rootEntryId?: string, sessionName?: string): Promise<SessionState | null>;
+    save(state: SessionState, sessionName?: string): Promise<void>;
+    clear(spaceId: string, rootEntryId: string, sessionName?: string): Promise<void>;
+    /**
+     * Clears sessions for this host's space only (CONTENTFUL_SPACE_ID / multi-tenant safe).
+     * Uses the per-user+space SET index — no KEYS scan.
+     */
+    clearAll(): Promise<void>;
+    private readSession;
+}
+//# sourceMappingURL=redis-session-store.d.ts.map

package/dist/session/redis-session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-session-store.d.ts","sourceRoot":"","sources":["../../src/session/redis-session-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAanE;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CASpE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK3E;AAED,qBAAa,iBAAkB,YAAW,YAAY;IAElD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,KAAK,EAAE,WAAW,EAClB,SAAS,SAAsB;IAGlD,OAAO,CAAC,OAAO;IAIf;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,SAAS;IAQX,IAAI,CACR,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IA8DzB,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtF;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAqBjB,WAAW;CAI1B"}

package/dist/session/redis-session-store.js

@@ -0,0 +1,199 @@
+import { getRuntimeContext } from '../runtime/context.js';
+import { sessionLog, sessionLogVerbose } from './log.js';
+import { buildSessionKey } from './session-store.js';
+const SESSION_TTL_SECONDS = 60 * 60 * 24 * 7; // 7 days
+/** Parses session JSON from Redis — Upstash may return a deserialized object. */
+export function parseSessionValue(raw) {
+    if (!raw)
+        return null;
+    if (typeof raw === 'string') {
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    if (typeof raw === 'object') {
+        return raw;
+    }
+    return null;
+}
+/** Coerces Redis active-pointer values (Upstash may return non-string shapes). */
+export function coerceActivePointerValue(raw) {
+    if (raw == null)
+        return null;
+    if (typeof raw === 'string') {
+        return raw.length > 0 ? raw : null;
+    }
+    if (typeof raw === 'number' || typeof raw === 'boolean') {
+        return String(raw);
+    }
+    return null;
+}
+/**
+ * Space id for multi-tenant Redis isolation on shared cmsedit-sessions.
+ * Prefer explicit arg; fall back to host env (CONTENTFUL_SPACE_ID).
+ */
+export function resolveSessionSpaceId(explicit) {
+    const fromArg = explicit?.trim();
+    if (fromArg)
+        return fromArg;
+    const fromEnv = process.env['CONTENTFUL_SPACE_ID']?.trim();
+    return fromEnv || undefined;
+}
+export class RedisSessionStore {
+    redis;
+    keyPrefix;
+    constructor(redis, keyPrefix = 'cms-edit:session:') {
+        this.redis = redis;
+        this.keyPrefix = keyPrefix;
+    }
+    fullKey(sessionKey) {
+        return `${this.keyPrefix}${sessionKey}`;
+    }
+    /**
+     * Active pointer is space-scoped so shared Redis across hosts does not
+     * cross-load sessions for the same Contentful user.
+     * - default: cms-edit:session:{userId}:active:{spaceId}
+     * - named:   cms-edit:session:{userId}:active:{spaceId}:{sessionName}
+     */
+    activePointerKey(userId, spaceId, sessionName) {
+        if (sessionName) {
+            return `${this.keyPrefix}${userId}:active:${spaceId}:${sessionName}`;
+        }
+        return `${this.keyPrefix}${userId}:active:${spaceId}`;
+    }
+    /**
+     * SET of full Redis keys (session blobs + pointers) for this user+space.
+     * Enables clearAll without KEYS scans on shared Upstash.
+     */
+    spaceIndexKey(userId, spaceId) {
+        return `${this.keyPrefix}${userId}:index:${spaceId}`;
+    }
+    getUserId() {
+        const userId = getRuntimeContext()?.user?.userId;
+        if (!userId) {
+            throw new Error('Redis session store requires a Contentful user ID in runtime context.');
+        }
+        return userId;
+    }
+    async load(spaceId, rootEntryId, sessionName) {
+        const userId = this.getUserId();
+        if (spaceId && rootEntryId) {
+            const sessionKey = buildSessionKey(userId, spaceId, rootEntryId, sessionName);
+            sessionLogVerbose('redis load by id', { userId, sessionName, sessionKey, spaceId });
+            const state = await this.readSession(sessionKey);
+            sessionLog(state ? 'redis load hit' : 'redis load miss', {
+                userId,
+                sessionName,
+                sessionKey,
+                spaceId,
+                lookup: 'explicit',
+            });
+            return state;
+        }
+        const resolvedSpaceId = resolveSessionSpaceId(spaceId);
+        if (!resolvedSpaceId) {
+            sessionLog('redis load miss', {
+                userId,
+                sessionName,
+                lookup: 'active',
+                reason: 'missing_space_id',
+            });
+            return null;
+        }
+        // Active load is pointer-only — no KEYS scan / "latest session" guessing.
+        const pointerKey = this.activePointerKey(userId, resolvedSpaceId, sessionName);
+        const activeKey = coerceActivePointerValue(await this.redis.get(pointerKey));
+        sessionLogVerbose('redis load active', {
+            userId,
+            sessionName,
+            spaceId: resolvedSpaceId,
+            pointerKey,
+            resolvedKey: activeKey,
+        });
+        if (!activeKey) {
+            sessionLog('redis load miss', {
+                userId,
+                sessionName,
+                spaceId: resolvedSpaceId,
+                pointerKey,
+                lookup: 'active',
+            });
+            return null;
+        }
+        const state = await this.readSession(activeKey);
+        sessionLog(state ? 'redis load hit' : 'redis load miss', {
+            userId,
+            sessionName,
+            spaceId: resolvedSpaceId,
+            sessionKey: activeKey,
+            pointerKey,
+            lookup: 'active',
+        });
+        return state;
+    }
+    async save(state, sessionName) {
+        const userId = this.getUserId();
+        const sessionKey = buildSessionKey(userId, state.spaceId, state.rootEntryId, sessionName);
+        const blobKey = this.fullKey(sessionKey);
+        const pointerKey = this.activePointerKey(userId, state.spaceId, sessionName);
+        const indexKey = this.spaceIndexKey(userId, state.spaceId);
+        const ttl = { ex: SESSION_TTL_SECONDS };
+        await this.redis.set(blobKey, JSON.stringify(state), ttl);
+        await this.redis.set(pointerKey, sessionKey, ttl);
+        await this.redis.sadd(indexKey, blobKey, pointerKey);
+        await this.redis.expire(indexKey, SESSION_TTL_SECONDS);
+        sessionLog('redis save ok', {
+            userId,
+            sessionName,
+            sessionKey,
+            pointerKey,
+            rootEntryId: state.rootEntryId,
+            spaceId: state.spaceId,
+            entryCount: Object.keys(state.entries).length,
+        });
+    }
+    async clear(spaceId, rootEntryId, sessionName) {
+        const userId = this.getUserId();
+        const sessionKey = buildSessionKey(userId, spaceId, rootEntryId, sessionName);
+        const blobKey = this.fullKey(sessionKey);
+        const pointerKey = this.activePointerKey(userId, spaceId, sessionName);
+        const indexKey = this.spaceIndexKey(userId, spaceId);
+        await this.redis.del(blobKey);
+        const activeKey = coerceActivePointerValue(await this.redis.get(pointerKey));
+        if (activeKey === sessionKey) {
+            await this.redis.del(pointerKey);
+            await this.redis.srem(indexKey, pointerKey);
+        }
+        await this.redis.srem(indexKey, blobKey);
+    }
+    /**
+     * Clears sessions for this host's space only (CONTENTFUL_SPACE_ID / multi-tenant safe).
+     * Uses the per-user+space SET index — no KEYS scan.
+     */
+    async clearAll() {
+        const userId = this.getUserId();
+        const spaceId = resolveSessionSpaceId();
+        if (!spaceId) {
+            sessionLog('redis clearAll skipped', { userId, reason: 'missing_space_id' });
+            return;
+        }
+        const indexKey = this.spaceIndexKey(userId, spaceId);
+        const members = await this.redis.smembers(indexKey);
+        sessionLog('redis clearAll', {
+            userId,
+            spaceId,
+            indexKey,
+            memberCount: members.length,
+        });
+        await Promise.all(members.map((key) => this.redis.del(key)));
+        await this.redis.del(indexKey);
+    }
+    async readSession(sessionKey) {
+        const raw = await this.redis.get(this.fullKey(sessionKey));
+        return parseSessionValue(raw);
+    }
+}
+//# sourceMappingURL=redis-session-store.js.map

package/dist/session/redis-session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-session-store.js","sourceRoot":"","sources":["../../src/session/redis-session-store.ts"],"names":[],"mappings":"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"}

package/dist/session/refs.d.ts

@@ -0,0 +1,45 @@
+import type { SerializedEntry, SessionState, TreeNode } from './state.js';
+/**
+ * Resolves a ref string (@c0, @c1, @root, ...) to a serialized entry.
+ * Throws a descriptive error if the ref is not found.
+ */
+export declare function resolveRef(session: SessionState, ref: string): SerializedEntry;
+/**
+ * Resolves a ref string to its entry ID.
+ */
+export declare function resolveRefToId(session: SessionState, ref: string): string;
+/**
+ * Finds the TreeNode for a given ref.
+ */
+export declare function findTreeNode(session: SessionState, ref: string): TreeNode | null;
+/**
+ * Builds a depth-first ordered tree from an entry map, assigning @c0, @c1... refs.
+ * Returns updated refs, refsByEntry, and treeNodes arrays.
+ */
+export declare function buildTree(rootEntryId: string, entries: Record<string, SerializedEntry>, locale: string): Pick<SessionState, 'refs' | 'refsByEntry' | 'treeNodes'>;
+/**
+ * Returns the field name for a navigation's item array ('items' or 'navigationItems').
+ * Prefers 'items' if both exist. Returns 'items' if neither exists (for new navigations).
+ */
+export declare function getNavigationItemsFieldName(entry: SerializedEntry, locale: string): string;
+/**
+ * Creates a Contentful entry link object for inserting into content arrays.
+ */
+export declare function makeEntryLink(entryId: string): {
+    sys: {
+        type: 'Link';
+        linkType: 'Entry';
+        id: string;
+    };
+};
+/**
+ * Creates a Contentful asset link object for setting asset reference fields.
+ */
+export declare function makeAssetLink(assetId: string): {
+    sys: {
+        type: 'Link';
+        linkType: 'Asset';
+        id: string;
+    };
+};
+//# sourceMappingURL=refs.d.ts.map

package/dist/session/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/session/refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAoB1E;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAgB9E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQzE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAGhF;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACxC,MAAM,EAAE,MAAM,GACb,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,WAAW,CAAC,CA0D1D;AAWD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAS1F;AAYD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG;IAC9C,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD,CAEA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG;IAC9C,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD,CAEA"}

package/dist/session/refs.js

@@ -0,0 +1,152 @@
+/**
+ * Normalises a ref string, resolving the special alias @root to the root entry's @cN ref.
+ * Ensures the result always starts with @.
+ */
+function normalizeRef(session, ref) {
+    const withAt = ref.startsWith('@') ? ref : `@${ref}`;
+    if (withAt === '@root') {
+        return session.refsByEntry[session.rootEntryId] ?? '@c0';
+    }
+    if (withAt === '@p0' &&
+        (session.rootEntryType === 'page' || session.rootEntryType === 'article')) {
+        return session.refsByEntry[session.rootEntryId] ?? '@c0';
+    }
+    return withAt;
+}
+/**
+ * Resolves a ref string (@c0, @c1, @root, ...) to a serialized entry.
+ * Throws a descriptive error if the ref is not found.
+ */
+export function resolveRef(session, ref) {
+    const normalizedRef = normalizeRef(session, ref);
+    const entryId = session.refs[normalizedRef];
+    if (!entryId) {
+        const available = Object.keys(session.refs).join(', ');
+        const rootHint = session.rootEntryType === 'page' || session.rootEntryType === 'article'
+            ? ' Use @root or @p0 to reference the root entry.'
+            : ' Use @root or @c0 to reference the root entry.';
+        throw new Error(`Ref "${normalizedRef}" not found. Available refs: ${available}.${rootHint}`);
+    }
+    const entry = session.entries[entryId];
+    if (!entry) {
+        throw new Error(`Entry "${entryId}" not found in session. Try re-running "cms-edit open".`);
+    }
+    return entry;
+}
+/**
+ * Resolves a ref string to its entry ID.
+ */
+export function resolveRefToId(session, ref) {
+    const normalizedRef = normalizeRef(session, ref);
+    const entryId = session.refs[normalizedRef];
+    if (!entryId) {
+        const available = Object.keys(session.refs).join(', ');
+        throw new Error(`Ref "${normalizedRef}" not found. Available refs: ${available}`);
+    }
+    return entryId;
+}
+/**
+ * Finds the TreeNode for a given ref.
+ */
+export function findTreeNode(session, ref) {
+    const normalizedRef = normalizeRef(session, ref);
+    return session.treeNodes.find((n) => n.ref === normalizedRef) ?? null;
+}
+/**
+ * Builds a depth-first ordered tree from an entry map, assigning @c0, @c1... refs.
+ * Returns updated refs, refsByEntry, and treeNodes arrays.
+ */
+export function buildTree(rootEntryId, entries, locale) {
+    const refs = {};
+    const refsByEntry = {};
+    const treeNodes = [];
+    let counter = 0;
+    function assignRef(entryId) {
+        const existing = refsByEntry[entryId];
+        if (existing)
+            return existing;
+        const ref = `@c${counter++}`;
+        refs[ref] = entryId;
+        refsByEntry[entryId] = ref;
+        return ref;
+    }
+    function traverse(entryId, parentId, parentField, depth) {
+        const entry = entries[entryId];
+        if (!entry)
+            return;
+        const ref = assignRef(entryId);
+        treeNodes.push({ entryId, ref, parentId, parentField, depth });
+        const ctId = entry.sys.contentType.sys.id;
+        const fieldsToExpand = ctId === 'collection'
+            ? ['contents']
+            : ctId === 'page' || ctId === 'article'
+                ? ['topContent', 'content', 'bottomContent']
+                : ctId === 'template'
+                    ? ['preContent', 'postContent']
+                    : ctId === 'navigation'
+                        ? getNavigationItemsField(entry, locale)
+                        : [];
+        for (const fieldId of fieldsToExpand) {
+            const fieldData = entry.fields[fieldId];
+            if (!fieldData)
+                continue;
+            const items = fieldData[locale] ?? fieldData['en-US'];
+            if (!Array.isArray(items))
+                continue;
+            for (const item of items) {
+                if (isEntryLink(item)) {
+                    const childId = item.sys.id;
+                    if (entries[childId]) {
+                        traverse(childId, entryId, fieldId, depth + 1);
+                    }
+                }
+            }
+        }
+    }
+    traverse(rootEntryId, null, null, 0);
+    return { refs, refsByEntry, treeNodes };
+}
+/**
+ * For navigation entries, returns the single array field to expand (items or navigationItems).
+ * Prefers 'items' if both exist and are arrays.
+ */
+function getNavigationItemsField(entry, locale) {
+    const name = getNavigationItemsFieldName(entry, locale);
+    return name ? [name] : [];
+}
+/**
+ * Returns the field name for a navigation's item array ('items' or 'navigationItems').
+ * Prefers 'items' if both exist. Returns 'items' if neither exists (for new navigations).
+ */
+export function getNavigationItemsFieldName(entry, locale) {
+    const fallback = 'en-US';
+    for (const fieldId of ['items', 'navigationItems']) {
+        const fieldData = entry.fields[fieldId];
+        if (!fieldData || typeof fieldData !== 'object')
+            continue;
+        const items = fieldData[locale] ?? fieldData[fallback];
+        if (Array.isArray(items))
+            return fieldId;
+    }
+    return 'items';
+}
+function isEntryLink(item) {
+    return (typeof item === 'object' &&
+        item !== null &&
+        'sys' in item &&
+        typeof item.sys === 'object' &&
+        item.sys.linkType === 'Entry');
+}
+/**
+ * Creates a Contentful entry link object for inserting into content arrays.
+ */
+export function makeEntryLink(entryId) {
+    return { sys: { type: 'Link', linkType: 'Entry', id: entryId } };
+}
+/**
+ * Creates a Contentful asset link object for setting asset reference fields.
+ */
+export function makeAssetLink(assetId) {
+    return { sys: { type: 'Link', linkType: 'Asset', id: assetId } };
+}
+//# sourceMappingURL=refs.js.map

package/dist/session/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../src/session/refs.ts"],"names":[],"mappings":"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"}

package/dist/session/session-store.d.ts

@@ -0,0 +1,27 @@
+import type { SessionState } from './state.js';
+export interface SessionStore {
+    load(spaceId?: string, rootEntryId?: string, sessionName?: string): SessionState | null | Promise<SessionState | null>;
+    save(state: SessionState, sessionName?: string): void | Promise<void>;
+    clear(spaceId: string, rootEntryId: string, sessionName?: string): void | Promise<void>;
+    clearAll(): void | Promise<void>;
+}
+export interface RedisClient {
+    /** Upstash may return parsed JSON objects when automaticDeserialization is enabled. */
+    get(key: string): Promise<unknown>;
+    set(key: string, value: string, options?: {
+        ex?: number;
+        nx?: boolean;
+    }): Promise<boolean | void>;
+    del(key: string): Promise<void>;
+    /** Prefer not to use for multi-tenant session isolation — prefer explicit keys / SETs. */
+    keys(pattern: string): Promise<string[]>;
+    incr(key: string): Promise<number>;
+    expire(key: string, seconds: number): Promise<void>;
+    /** Set members — used for per-user+space session index (clearAll without KEYS). */
+    sadd(key: string, ...members: string[]): Promise<number>;
+    srem(key: string, ...members: string[]): Promise<number>;
+    smembers(key: string): Promise<string[]>;
+}
+export declare function buildSessionKey(userId: string | undefined, spaceId: string, rootEntryId: string, sessionName?: string): string;
+export declare function buildSessionNameSuffix(sessionName: string): string;
+//# sourceMappingURL=session-store.d.ts.map

package/dist/session/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/session/session-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,IAAI,CACF,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF,QAAQ,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,uFAAuF;IACvF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAClG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,0FAA0F;IAC1F,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,mFAAmF;IACnF,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1C;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAIR;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/dist/session/session-store.js

@@ -0,0 +1,9 @@
+export function buildSessionKey(userId, spaceId, rootEntryId, sessionName) {
+    const suffix = sessionName ? `-${sessionName}` : '';
+    const base = `${spaceId}-${rootEntryId}${suffix}`;
+    return userId ? `${userId}:${base}` : base;
+}
+export function buildSessionNameSuffix(sessionName) {
+    return `-${sessionName}`;
+}
+//# sourceMappingURL=session-store.js.map

package/dist/session/session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/session/session-store.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,eAAe,CAC7B,MAA0B,EAC1B,OAAe,EACf,WAAmB,EACnB,WAAoB;IAEpB,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,MAAM,IAAI,GAAG,GAAG,OAAO,IAAI,WAAW,GAAG,MAAM,EAAE,CAAC;IAClD,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,OAAO,IAAI,WAAW,EAAE,CAAC;AAC3B,CAAC"}

package/dist/session/state.d.ts

@@ -0,0 +1,106 @@
+import type { ContentTypeProps } from 'contentful-management';
+/**
+ * Serialized representation of a Contentful CMA entry for session storage.
+ * Fields use the CMA locale-keyed format: { fieldId: { locale: value } }
+ */
+export interface SerializedEntry {
+    sys: {
+        id: string;
+        version: number;
+        publishedVersion?: number;
+        publishedAt?: string;
+        contentType: {
+            sys: {
+                id: string;
+            };
+        };
+        createdAt: string;
+        updatedAt: string;
+    };
+    fields: Record<string, Record<string, unknown>>;
+}
+/**
+ * A node in the content tree representing a single entry's position within a page.
+ * Stored depth-first so iteration order matches visual display order.
+ */
+export interface TreeNode {
+    entryId: string;
+    ref: string;
+    parentId: string | null;
+    parentField: string | null;
+    depth: number;
+}
+/**
+ * A single field change to be applied on save.
+ */
+export interface FieldPatch {
+    fieldId: string;
+    locale: string;
+    value: unknown;
+    appliedAt: string;
+}
+/** Root entry kinds for a cms-edit session (maps from Contentful content type id via {@link mapContentTypeIdToRootEntryType}). */
+export type RootEntryType = 'page' | 'article' | 'articleType' | 'tag' | 'navigation' | 'template' | 'batch';
+/**
+ * Maps a CMA content type id to the session root kind. Unknown ids default to `page` (e.g. `--id` on a component).
+ */
+export declare function mapContentTypeIdToRootEntryType(contentTypeId: string): RootEntryType;
+/** Sentinel root entry ID for batch edit sessions (multiple unrelated entries by ID). */
+export declare const BATCH_ROOT_ENTRY_ID = "__batch__";
+/** How the session was opened — tree (page open) or batch (entry ID edits). */
+export type SessionKind = 'tree' | 'batch';
+/**
+ * The full session state persisted between CLI commands.
+ */
+export interface SessionState {
+    version: 1;
+    spaceKey: string;
+    spaceId: string;
+    environment: string;
+    defaultLocale: string;
+    rootEntryId: string;
+    rootEntryType: RootEntryType;
+    /** Defaults to 'tree' when omitted (backward compatible). */
+    sessionKind?: SessionKind;
+    fetchedAt: string;
+    /** All fetched entries keyed by entry ID */
+    entries: Record<string, SerializedEntry>;
+    /** Original entry state at open time (for diff) */
+    originalEntries: Record<string, SerializedEntry>;
+    /** @c0 → entryId */
+    refs: Record<string, string>;
+    /** entryId → @c0 */
+    refsByEntry: Record<string, string>;
+    /** Depth-first ordered tree nodes */
+    treeNodes: TreeNode[];
+    /** Entry IDs that have been locally modified */
+    modifiedEntryIds: string[];
+    /** Draft-only entry IDs to delete on save (from remove operations) */
+    pendingDeletions: string[];
+    /** Cached CMA content type definitions (reused across CLI invocations for this session) */
+    contentTypes?: Record<string, ContentTypeProps>;
+}
+export type EntryStatus = 'published' | 'draft' | 'pending' | 'changed';
+/**
+ * Derives the display status of an entry.
+ *
+ * - changed: has unsaved local patches
+ * - draft: never published
+ * - pending: published but has newer draft on Contentful
+ * - published: published and no pending changes
+ */
+export declare function getEntryStatus(entry: SerializedEntry, isLocallyModified: boolean): EntryStatus;
+/**
+ * Returns the display type label for any content type.
+ * Looks for a ${ctId}Type discriminator field (e.g. componentType, collectionType,
+ * externalComponentType) and renders as TypeName[value] when present.
+ * Falls back to the capitalised content type ID for types without a discriminator.
+ */
+export declare function getEntryTypeLabel(entry: SerializedEntry, locale: string): string;
+/**
+ * Returns the best display label (cmsLabel or heading or entry ID).
+ */
+export declare function getEntryLabel(entry: SerializedEntry, locale: string): string;
+/** The content array fields that can contain linked entries. */
+export declare const CONTENT_ARRAY_FIELDS: readonly ["topContent", "content", "bottomContent", "contents", "structuredData", "indexPageStructuredData", "links"];
+//# sourceMappingURL=state.d.ts.map

package/dist/session/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/session/state.ts"],"names":[],"mappings":"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"}