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

package/dist/index/sync-lock.js

@@ -0,0 +1,98 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const LOCK_STALE_MS = 30 * 60 * 1000;
+export class IndexSyncLockError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'IndexSyncLockError';
+    }
+}
+function readLockData(lockPath) {
+    try {
+        const raw = fs.readFileSync(lockPath, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function formatLockHolder(lockPath) {
+    const data = readLockData(lockPath);
+    if (!data)
+        return 'unknown holder';
+    return `pid ${String(data.pid)}, started ${data.startedAt}`;
+}
+function isStaleLock(lockPath) {
+    const data = readLockData(lockPath);
+    if (!data)
+        return true;
+    const started = Date.parse(data.startedAt);
+    if (Number.isNaN(started) || Date.now() - started > LOCK_STALE_MS) {
+        return true;
+    }
+    try {
+        process.kill(data.pid, 0);
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
+function tryAcquireLock(lockPath) {
+    if (fs.existsSync(lockPath)) {
+        if (!isStaleLock(lockPath)) {
+            return 'held';
+        }
+        fs.rmSync(lockPath, { force: true });
+    }
+    fs.mkdirSync(path.dirname(lockPath), { recursive: true });
+    const data = { pid: process.pid, startedAt: new Date().toISOString() };
+    try {
+        fs.writeFileSync(lockPath, JSON.stringify(data), { flag: 'wx' });
+        return true;
+    }
+    catch {
+        return 'contention';
+    }
+}
+function releaseLock(lockPath) {
+    try {
+        if (!fs.existsSync(lockPath))
+            return;
+        const data = readLockData(lockPath);
+        if (data?.pid === process.pid) {
+            fs.rmSync(lockPath, { force: true });
+        }
+    }
+    catch {
+        // ignore
+    }
+}
+function lockHeldError(lockPath, reason) {
+    if (reason === 'held' || fs.existsSync(lockPath)) {
+        const holder = formatLockHolder(lockPath);
+        return new IndexSyncLockError(`Index sync already in progress (${holder}). ` +
+            `Lock file: ${lockPath}. ` +
+            'Wait for the other process to finish, or remove the lock if it is stale (>30 min or dead pid).');
+    }
+    return new IndexSyncLockError('Could not acquire index sync lock (another cms-edit process claimed it at the same time). ' +
+        `Lock file: ${lockPath}. Retry in a moment.`);
+}
+/**
+ * Ensures only one process syncs a given index database at a time.
+ * Fails immediately if a non-stale lock is already held.
+ */
+export async function withIndexSyncLock(dbPath, fn) {
+    const lockPath = `${dbPath}.lock`;
+    const acquired = tryAcquireLock(lockPath);
+    if (acquired !== true) {
+        throw lockHeldError(lockPath, acquired);
+    }
+    try {
+        return await fn();
+    }
+    finally {
+        releaseLock(lockPath);
+    }
+}
+//# sourceMappingURL=sync-lock.js.map

package/dist/index/sync-lock.js.map

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

package/dist/index/sync-log.d.ts

@@ -0,0 +1,7 @@
+/** biome-ignore-all lint/suspicious/noConsole: Verbose index sync writes to stderr intentionally */
+/** Set from `cms-edit index sync --verbose` for the current process. */
+export declare function setIndexSyncCliVerbose(enabled: boolean): void;
+export declare function isIndexSyncVerbose(): boolean;
+/** Progress trace for index sync — `index sync --verbose` or `LOG_CMS_INDEX=1`. */
+export declare function indexSyncVerbose(message: string): void;
+//# sourceMappingURL=sync-log.d.ts.map

package/dist/index/sync-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-log.d.ts","sourceRoot":"","sources":["../../src/index/sync-log.ts"],"names":[],"mappings":"AAAA,oGAAoG;AAMpG,wEAAwE;AACxE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE7D;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAI5C;AAMD,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGtD"}

package/dist/index/sync-log.js

@@ -0,0 +1,23 @@
+/** biome-ignore-all lint/suspicious/noConsole: Verbose index sync writes to stderr intentionally */
+import pc from 'picocolors';
+let cliVerbose = false;
+/** Set from `cms-edit index sync --verbose` for the current process. */
+export function setIndexSyncCliVerbose(enabled) {
+    cliVerbose = enabled;
+}
+export function isIndexSyncVerbose() {
+    if (cliVerbose)
+        return true;
+    const value = process.env['LOG_CMS_INDEX'];
+    return value === '1' || value === 'true';
+}
+function writeIndexLog(line) {
+    process.stderr.write(`${line}\n`);
+}
+/** Progress trace for index sync — `index sync --verbose` or `LOG_CMS_INDEX=1`. */
+export function indexSyncVerbose(message) {
+    if (!isIndexSyncVerbose())
+        return;
+    writeIndexLog(`${pc.cyan('[cms-edit:index]')} ${message}`);
+}
+//# sourceMappingURL=sync-log.js.map

package/dist/index/sync-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-log.js","sourceRoot":"","sources":["../../src/index/sync-log.ts"],"names":[],"mappings":"AAAA,oGAAoG;AAEpG,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,wEAAwE;AACxE,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,UAAU,GAAG,OAAO,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,IAAI,UAAU;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC3C,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,MAAM,CAAC;AAC3C,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,IAAI,CAAC,kBAAkB,EAAE;QAAE,OAAO;IAClC,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/index/sync.d.ts

@@ -0,0 +1,50 @@
+import type { SpaceConfig } from '../config/types.js';
+import type { CdaAssetRecord, CdaReferenceRecord, CdaSyncPayload } from '../contentful/cda-sync.js';
+export interface SyncIndexOptions {
+    preview?: boolean;
+    accessToken: string;
+    apiKeyId?: string;
+    payload: CdaSyncPayload;
+}
+export interface SyncIndexResult {
+    dbPath: string;
+    assetCount: number;
+    mediaCount: number;
+    referenceCount: number;
+    syncedAt: string;
+    /** `full` replaced all rows; `incremental` merged updates since last sync. */
+    syncMode: 'full' | 'incremental';
+}
+export type IndexSyncReason = 'missing' | 'schema' | 'stale' | 'invalidated-full' | 'invalidated-incremental' | 'current';
+export type IndexSyncMode = 'full' | 'incremental';
+export declare function indexSyncModeForReason(reason: IndexSyncReason): IndexSyncMode | null;
+export declare function rebuildIndexFromPayload(space: SpaceConfig, options: SyncIndexOptions): SyncIndexResult;
+/** Merges CDA rows into an existing index (upsert). Used for stale refresh with same schema. */
+export declare function mergeIndexFromPayload(space: SpaceConfig, options: SyncIndexOptions): SyncIndexResult;
+/** Upsert a single asset row after CMA upload (optional dedup freshness). */
+export declare function upsertAssetRow(space: SpaceConfig, asset: CdaAssetRecord, preview?: boolean): void;
+/** Removes a catalog row after a committed delete. */
+export declare function deleteReferenceRow(space: SpaceConfig, entryId: string, preview?: boolean): void;
+/** Removes an asset row after a committed delete. */
+export declare function deleteAssetRow(space: SpaceConfig, assetId: string, preview?: boolean): void;
+/** Upsert a single reference row after taxonomy/template create. */
+export declare function upsertReferenceRow(space: SpaceConfig, reference: CdaReferenceRecord, preview?: boolean): void;
+export declare function getStoredSchemaVersion(space: SpaceConfig, preview?: boolean): number | null;
+export declare function getIndexSyncReason(space: SpaceConfig, preview?: boolean): IndexSyncReason;
+/** Resolves sync reason including shared invalidation markers (Redis or file). */
+export declare function resolveIndexSyncReason(space: SpaceConfig, preview?: boolean): Promise<IndexSyncReason>;
+/** True when the index must be synced (missing, schema mismatch, or older than 24h). */
+export declare function indexNeedsRebuild(space: SpaceConfig, preview?: boolean): boolean;
+export declare function readIndexStatus(space: SpaceConfig, preview?: boolean): {
+    exists: boolean;
+    dbPath: string;
+    syncedAt: string | null;
+    assetCount: number | null;
+    mediaCount: number | null;
+    referenceCount: number | null;
+    apiKeyId: string | null;
+    stale: boolean;
+};
+export declare const INDEX_STALE_MS: number;
+export declare function isSyncedAtStale(syncedAt: string, now?: number): boolean;
+//# sourceMappingURL=sync.d.ts.map

package/dist/index/sync.d.ts.map

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

package/dist/index/sync.js

@@ -0,0 +1,292 @@
+import { hashDeliveryToken } from '../contentful/delivery-token.js';
+import { indexCacheKeyFromSpace } from './cache-keys.js';
+import { getIndexCacheStore } from './cache-store.js';
+import { getMeta, openIndexDatabase, setMeta } from './db.js';
+import { DEFAULT_INDEX_PREVIEW, resolveIndexPreview } from './mode.js';
+import { ensureIndexDirectory, getIndexDbPath, indexExists } from './paths.js';
+import { getIndexSyncedAt } from './query.js';
+import { SCHEMA_VERSION } from './schema.js';
+export function indexSyncModeForReason(reason) {
+    switch (reason) {
+        case 'missing':
+        case 'schema':
+        case 'invalidated-full':
+            return 'full';
+        case 'stale':
+        case 'invalidated-incremental':
+            return 'incremental';
+        case 'current':
+            return null;
+    }
+}
+function clearTables(db) {
+    db.exec('DELETE FROM assets; DELETE FROM media; DELETE FROM reference_entries;');
+}
+function upsertAssets(db, assets) {
+    const stmt = db.prepare(`
+    INSERT INTO assets (id, fileName, title, description, contentType, url, width, height, size, updatedAt)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    ON CONFLICT(id) DO UPDATE SET
+      fileName = excluded.fileName,
+      title = excluded.title,
+      description = excluded.description,
+      contentType = excluded.contentType,
+      url = excluded.url,
+      width = excluded.width,
+      height = excluded.height,
+      size = excluded.size,
+      updatedAt = excluded.updatedAt
+  `);
+    for (const a of assets) {
+        stmt.run(a.id, a.fileName, a.title, a.description, a.contentType, a.url, a.width, a.height, a.size, a.updatedAt);
+    }
+}
+function upsertMedia(db, media, fileNameByAssetId) {
+    const stmt = db.prepare(`
+    INSERT INTO media (id, name, assetId, assetFileName, updatedAt)
+    VALUES (?, ?, ?, ?, ?)
+    ON CONFLICT(id) DO UPDATE SET
+      name = excluded.name,
+      assetId = excluded.assetId,
+      assetFileName = excluded.assetFileName,
+      updatedAt = excluded.updatedAt
+  `);
+    for (const m of media) {
+        const assetFileName = fileNameByAssetId.get(m.assetId) ?? '';
+        stmt.run(m.id, m.name, m.assetId, assetFileName, m.updatedAt);
+    }
+}
+function upsertReferenceIntoDb(db, reference) {
+    db.prepare(`
+    INSERT INTO reference_entries (id, contentType, slug, label, cmsLabel, updatedAt, tagTypeSlug, articleTypeSlug, date)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+    ON CONFLICT(id) DO UPDATE SET
+      contentType = excluded.contentType,
+      slug = excluded.slug,
+      label = excluded.label,
+      cmsLabel = excluded.cmsLabel,
+      updatedAt = excluded.updatedAt,
+      tagTypeSlug = excluded.tagTypeSlug,
+      articleTypeSlug = excluded.articleTypeSlug,
+      date = excluded.date
+  `).run(reference.id, reference.contentType, reference.slug, reference.label, reference.cmsLabel, reference.updatedAt, reference.tagTypeSlug, reference.articleTypeSlug, reference.date);
+}
+function upsertReferences(db, references) {
+    for (const reference of references) {
+        upsertReferenceIntoDb(db, reference);
+    }
+}
+function fileNameMapFromAssets(assets) {
+    const fileNameByAssetId = new Map();
+    for (const a of assets) {
+        fileNameByAssetId.set(a.id, a.fileName);
+    }
+    return fileNameByAssetId;
+}
+function readTableCounts(db) {
+    const assetCount = db.prepare(`SELECT COUNT(*) AS count FROM assets`).get()
+        .count;
+    const mediaCount = db.prepare(`SELECT COUNT(*) AS count FROM media`).get()
+        .count;
+    const referenceCount = db.prepare(`SELECT COUNT(*) AS count FROM reference_entries`).get().count;
+    return { assetCount, mediaCount, referenceCount };
+}
+function writeSyncMeta(db, options, preview, counts, syncedAt) {
+    setMeta(db, 'syncedAt', syncedAt);
+    setMeta(db, 'assetCount', String(counts.assetCount));
+    setMeta(db, 'mediaCount', String(counts.mediaCount));
+    setMeta(db, 'referenceCount', String(counts.referenceCount));
+    setMeta(db, 'cdaTokenHash', hashDeliveryToken(options.accessToken));
+    setMeta(db, 'schemaVersion', String(SCHEMA_VERSION));
+    setMeta(db, 'preview', preview ? '1' : '0');
+    if (options.apiKeyId) {
+        setMeta(db, 'apiKeyId', options.apiKeyId);
+    }
+}
+export function rebuildIndexFromPayload(space, options) {
+    const preview = resolveIndexPreview(options.preview);
+    ensureIndexDirectory(space, preview);
+    const dbPath = getIndexDbPath(space, preview);
+    const db = openIndexDatabase(dbPath);
+    clearTables(db);
+    const fileNameByAssetId = fileNameMapFromAssets(options.payload.assets);
+    upsertAssets(db, options.payload.assets);
+    upsertMedia(db, options.payload.media, fileNameByAssetId);
+    upsertReferences(db, options.payload.references);
+    const syncedAt = new Date().toISOString();
+    const counts = readTableCounts(db);
+    writeSyncMeta(db, options, preview, counts, syncedAt);
+    db.close();
+    return {
+        dbPath,
+        assetCount: counts.assetCount,
+        mediaCount: counts.mediaCount,
+        referenceCount: counts.referenceCount,
+        syncedAt,
+        syncMode: 'full',
+    };
+}
+/** Merges CDA rows into an existing index (upsert). Used for stale refresh with same schema. */
+export function mergeIndexFromPayload(space, options) {
+    const preview = resolveIndexPreview(options.preview);
+    ensureIndexDirectory(space, preview);
+    const dbPath = getIndexDbPath(space, preview);
+    const db = openIndexDatabase(dbPath);
+    const fileNameByAssetId = fileNameMapFromAssets(options.payload.assets);
+    upsertAssets(db, options.payload.assets);
+    upsertMedia(db, options.payload.media, fileNameByAssetId);
+    upsertReferences(db, options.payload.references);
+    const syncedAt = new Date().toISOString();
+    const counts = readTableCounts(db);
+    writeSyncMeta(db, options, preview, counts, syncedAt);
+    db.close();
+    return {
+        dbPath,
+        assetCount: counts.assetCount,
+        mediaCount: counts.mediaCount,
+        referenceCount: counts.referenceCount,
+        syncedAt,
+        syncMode: 'incremental',
+    };
+}
+/** Upsert a single asset row after CMA upload (optional dedup freshness). */
+export function upsertAssetRow(space, asset, preview = DEFAULT_INDEX_PREVIEW) {
+    const dbPath = getIndexDbPath(space, preview);
+    const db = openIndexDatabase(dbPath);
+    db.prepare(`
+    INSERT INTO assets (id, fileName, title, description, contentType, url, width, height, size, updatedAt)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    ON CONFLICT(id) DO UPDATE SET
+      fileName = excluded.fileName,
+      title = excluded.title,
+      description = excluded.description,
+      contentType = excluded.contentType,
+      url = excluded.url,
+      width = excluded.width,
+      height = excluded.height,
+      size = excluded.size,
+      updatedAt = excluded.updatedAt
+  `).run(asset.id, asset.fileName, asset.title, asset.description, asset.contentType, asset.url, asset.width, asset.height, asset.size, asset.updatedAt);
+    db.close();
+}
+function refreshReferenceCountMeta(db) {
+    const row = db.prepare(`SELECT COUNT(*) AS count FROM reference_entries`).get();
+    setMeta(db, 'referenceCount', String(row.count));
+}
+/** Removes a catalog row after a committed delete. */
+export function deleteReferenceRow(space, entryId, preview = DEFAULT_INDEX_PREVIEW) {
+    const dbPath = getIndexDbPath(space, preview);
+    if (!indexExists(space, preview))
+        return;
+    const db = openIndexDatabase(dbPath);
+    db.prepare('DELETE FROM reference_entries WHERE id = ?').run(entryId);
+    refreshReferenceCountMeta(db);
+    db.close();
+}
+/** Removes an asset row after a committed delete. */
+export function deleteAssetRow(space, assetId, preview = DEFAULT_INDEX_PREVIEW) {
+    const dbPath = getIndexDbPath(space, preview);
+    if (!indexExists(space, preview))
+        return;
+    const db = openIndexDatabase(dbPath);
+    db.prepare('DELETE FROM assets WHERE id = ?').run(assetId);
+    db.prepare('DELETE FROM media WHERE assetId = ?').run(assetId);
+    db.close();
+}
+/** Upsert a single reference row after taxonomy/template create. */
+export function upsertReferenceRow(space, reference, preview = DEFAULT_INDEX_PREVIEW) {
+    const dbPath = getIndexDbPath(space, preview);
+    if (!indexExists(space, preview))
+        return;
+    const db = openIndexDatabase(dbPath);
+    upsertReferenceIntoDb(db, reference);
+    refreshReferenceCountMeta(db);
+    db.close();
+}
+export function getStoredSchemaVersion(space, preview) {
+    const usePreview = resolveIndexPreview(preview);
+    if (!indexExists(space, usePreview))
+        return null;
+    const db = openIndexDatabase(getIndexDbPath(space, usePreview));
+    const raw = getMeta(db, 'schemaVersion');
+    db.close();
+    if (raw === null)
+        return 1;
+    const parsed = Number.parseInt(raw, 10);
+    return Number.isNaN(parsed) ? 1 : parsed;
+}
+export function getIndexSyncReason(space, preview) {
+    const usePreview = resolveIndexPreview(preview);
+    if (!indexExists(space, usePreview))
+        return 'missing';
+    const storedVersion = getStoredSchemaVersion(space, usePreview);
+    if (storedVersion !== SCHEMA_VERSION)
+        return 'schema';
+    const status = readIndexStatus(space, usePreview);
+    if (status.stale)
+        return 'stale';
+    return 'current';
+}
+/** Resolves sync reason including shared invalidation markers (Redis or file). */
+export async function resolveIndexSyncReason(space, preview) {
+    const base = getIndexSyncReason(space, preview);
+    if (base !== 'current')
+        return base;
+    const usePreview = resolveIndexPreview(preview);
+    const inv = await getIndexCacheStore().getInvalidation(indexCacheKeyFromSpace(space, usePreview));
+    if (!inv)
+        return 'current';
+    const syncedAt = getIndexSyncedAt(space, usePreview);
+    if (!syncedAt)
+        return 'current';
+    if (Date.parse(inv.invalidatedAt) > Date.parse(syncedAt)) {
+        return inv.mode === 'full' ? 'invalidated-full' : 'invalidated-incremental';
+    }
+    return 'current';
+}
+/** True when the index must be synced (missing, schema mismatch, or older than 24h). */
+export function indexNeedsRebuild(space, preview) {
+    return getIndexSyncReason(space, preview) !== 'current';
+}
+export function readIndexStatus(space, preview) {
+    const usePreview = resolveIndexPreview(preview);
+    const dbPath = getIndexDbPath(space, usePreview);
+    if (!indexExists(space, usePreview)) {
+        return {
+            exists: false,
+            dbPath,
+            syncedAt: null,
+            assetCount: null,
+            mediaCount: null,
+            referenceCount: null,
+            apiKeyId: null,
+            stale: true,
+        };
+    }
+    const db = openIndexDatabase(dbPath);
+    const syncedAt = getMeta(db, 'syncedAt');
+    const assetCount = Number.parseInt(getMeta(db, 'assetCount') ?? '0', 10);
+    const mediaCount = Number.parseInt(getMeta(db, 'mediaCount') ?? '0', 10);
+    const referenceCount = Number.parseInt(getMeta(db, 'referenceCount') ?? '0', 10);
+    const apiKeyId = getMeta(db, 'apiKeyId');
+    db.close();
+    const stale = syncedAt ? isSyncedAtStale(syncedAt) : true;
+    return {
+        exists: true,
+        dbPath,
+        syncedAt,
+        assetCount,
+        mediaCount,
+        referenceCount,
+        apiKeyId,
+        stale,
+    };
+}
+export const INDEX_STALE_MS = 24 * 60 * 60 * 1000;
+export function isSyncedAtStale(syncedAt, now = Date.now()) {
+    const t = Date.parse(syncedAt);
+    if (Number.isNaN(t))
+        return true;
+    return now - t > INDEX_STALE_MS;
+}
+//# sourceMappingURL=sync.js.map

package/dist/index/sync.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { CmsEditConfig, SpaceConfig } from './config/types.js';
+export { markdownToRtf, markdownToRtfInlines } from './rtf/fromMarkdown.js';
+export { type ReplaceRtfPlainTextMode, type ReplaceRtfPlainTextOptions, type ReplaceRtfPlainTextResult, RichTextReplaceError, replaceRtfPlainText, } from './rtf/replacePlainText.js';
+export { rtfToMarkdown } from './rtf/toMarkdown.js';
+export { isRtfDocument } from './rtf/utils.js';
+export type { FieldPatch, SerializedEntry, SessionState, TreeNode } from './session/state.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { markdownToRtf, markdownToRtfInlines } from './rtf/fromMarkdown.js';
+export { RichTextReplaceError, replaceRtfPlainText, } from './rtf/replacePlainText.js';
+export { rtfToMarkdown } from './rtf/toMarkdown.js';
+export { isRtfDocument } from './rtf/utils.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAIL,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/mcp/guide.d.ts

@@ -0,0 +1,21 @@
+export interface HostedMcpInfo {
+    projectKey: string;
+    displayName?: string;
+    spaceId?: string;
+    exampleSlugs?: string[];
+}
+export type GuideTopic = 'overview' | 'workflow' | 'commands' | 'troubleshooting' | 'hosted';
+export declare const GUIDE_TOPICS: GuideTopic[];
+export declare const GUIDE_RESOURCE_URI = "cms-edit://guide";
+export declare const ONBOARDING_PROMPTS: readonly ["cms_edit_verify", "cms_edit_explore", "cms_edit_edit_page", "cms_edit_edit_article", "cms_edit_index_sync", "cms_edit_create_page", "cms_edit_create_article", "cms_edit_create_from_doc", "cms_edit_create_article_from_doc", "cms_edit_taxonomy", "cms_edit_bulk_seo", "cms_edit_bulk_find_replace", "cms_edit_bulk_article_tags", "cms_edit_import_authors", "cms_edit_media"];
+export declare const GETTING_STARTED_INFO: {
+    readonly resourceUri: "cms-edit://guide";
+    readonly prompts: readonly ["cms_edit_verify", "cms_edit_explore", "cms_edit_edit_page", "cms_edit_edit_article", "cms_edit_index_sync", "cms_edit_create_page", "cms_edit_create_article", "cms_edit_create_from_doc", "cms_edit_create_article_from_doc", "cms_edit_taxonomy", "cms_edit_bulk_seo", "cms_edit_bulk_find_replace", "cms_edit_bulk_article_tags", "cms_edit_import_authors", "cms_edit_media"];
+    readonly helpTool: "cms_edit_help";
+};
+export declare function loadHostedGuideTemplate(): string;
+export declare function buildGuideMarkdown(hosted?: HostedMcpInfo): string;
+export declare function extractGuideTopic(markdown: string, topic: GuideTopic): string;
+export declare function getGuideTopicMarkdown(topic: GuideTopic, hosted?: HostedMcpInfo): string;
+export declare function parseGuideTopic(value?: string): GuideTopic;
+//# sourceMappingURL=guide.d.ts.map

package/dist/mcp/guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../src/mcp/guide.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAE7F,eAAO,MAAM,YAAY,EAAE,UAAU,EAMpC,CAAC;AAEF,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AAErD,eAAO,MAAM,kBAAkB,8XAgBrB,CAAC;AAEX,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAWX,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AA+BD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAMjE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAiB7E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAGvF;AAED,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAQ1D"}