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

package/dist/index/redis-index-cache.js

@@ -0,0 +1,83 @@
+import { indexCacheKeySuffix } from './cache-keys.js';
+import { INDEX_BLOB_TTL_SECONDS, } from './cache-store.js';
+function prefix(key) {
+    return `cms-edit:index:${indexCacheKeySuffix(key)}`;
+}
+function parseJson(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;
+}
+export class RedisIndexCacheStore {
+    redis;
+    blobTtlSeconds;
+    constructor(redis, blobTtlSeconds = INDEX_BLOB_TTL_SECONDS) {
+        this.redis = redis;
+        this.blobTtlSeconds = blobTtlSeconds;
+    }
+    invalidationKey(key) {
+        return `${prefix(key)}:invalidation`;
+    }
+    blobMetaKey(key) {
+        return `${prefix(key)}:meta`;
+    }
+    blobDataKey(key) {
+        return `${prefix(key)}:blob`;
+    }
+    syncLockKey(key) {
+        return `${prefix(key)}:lock`;
+    }
+    async getInvalidation(key) {
+        return parseJson(await this.redis.get(this.invalidationKey(key)));
+    }
+    async setInvalidation(key, inv) {
+        await this.redis.set(this.invalidationKey(key), JSON.stringify(inv));
+    }
+    async clearInvalidation(key) {
+        await this.redis.del(this.invalidationKey(key));
+    }
+    async getBlob(key) {
+        const meta = parseJson(await this.redis.get(this.blobMetaKey(key)));
+        const raw = await this.redis.get(this.blobDataKey(key));
+        if (!meta || raw == null)
+            return null;
+        const encoded = typeof raw === 'string' ? raw : String(raw);
+        const data = Buffer.from(encoded, 'base64');
+        return { meta, data };
+    }
+    async putBlob(key, meta, data) {
+        const encoded = Buffer.from(data).toString('base64');
+        await this.redis.set(this.blobMetaKey(key), JSON.stringify(meta), {
+            ex: this.blobTtlSeconds,
+        });
+        await this.redis.set(this.blobDataKey(key), encoded, { ex: this.blobTtlSeconds });
+    }
+    async deleteBlob(key) {
+        await this.redis.del(this.blobMetaKey(key));
+        await this.redis.del(this.blobDataKey(key));
+    }
+    async tryAcquireSyncLock(key, holderId, ttlSeconds) {
+        const result = await this.redis.set(this.syncLockKey(key), holderId, {
+            ex: ttlSeconds,
+            nx: true,
+        });
+        return result === true;
+    }
+    async releaseSyncLock(key, holderId) {
+        const current = await this.redis.get(this.syncLockKey(key));
+        if (current === holderId) {
+            await this.redis.del(this.syncLockKey(key));
+        }
+    }
+}
+//# sourceMappingURL=redis-index-cache.js.map

package/dist/index/redis-index-cache.js.map

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

package/dist/index/reference-lookup.d.ts

@@ -0,0 +1,18 @@
+import type { SpaceConfig } from '../config/types.js';
+import type { SafeEnvironment } from '../contentful/client.js';
+import { type ReferenceEntryRow } from './query.js';
+export { referenceRowFromCmaEntry } from '../contentful/reference-record.js';
+/**
+ * Resolves a slug-indexed reference entry (articleType, tagType, tag) via local index when available,
+ * otherwise falls back to CMA.
+ */
+export declare function findReferenceEntryBySlug(space: SpaceConfig, env: SafeEnvironment, contentType: string, slug: string, opts?: {
+    preview?: boolean;
+}): Promise<ReferenceEntryRow | null>;
+/**
+ * Resolves a reference entry by display label (templates use cmsLabel; others use name).
+ */
+export declare function findReferenceEntryByLabel(space: SpaceConfig, env: SafeEnvironment, contentType: string, label: string, opts?: {
+    preview?: boolean;
+}): Promise<ReferenceEntryRow | null>;
+//# sourceMappingURL=reference-lookup.d.ts.map

package/dist/index/reference-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-lookup.d.ts","sourceRoot":"","sources":["../../src/index/reference-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAM/D,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAkE7E;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,eAAe,EACpB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/B,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAiCnC;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,eAAe,EACpB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/B,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAiCnC"}

package/dist/index/reference-lookup.js

@@ -0,0 +1,123 @@
+import { findEntryByContentTypeAndSlug, normalizeSlug } from '../contentful/fetch.js';
+import { referenceRowFromCmaEntry } from '../contentful/reference-record.js';
+import { ReferenceCatalogAmbiguityError } from './errors.js';
+import { resolveIndexPreview } from './mode.js';
+import { indexExists } from './paths.js';
+import { assertUniqueReferenceRows, listReferencesByLabel, listReferencesBySlug, } from './query.js';
+import { isReferenceContentType } from './schema.js';
+export { referenceRowFromCmaEntry } from '../contentful/reference-record.js';
+function findReferenceInIndexBySlug(space, contentType, slug, preview) {
+    if (!isReferenceContentType(contentType))
+        return null;
+    if (!indexExists(space, resolveIndexPreview(preview)))
+        return null;
+    const rows = listReferencesBySlug(space, contentType, slug, preview);
+    if (rows.length === 0)
+        return null;
+    return assertUniqueReferenceRows(rows, `Multiple ${contentType} entries share slug "${slug}" in the local index. Use --force-cma or resolve by entry ID.`);
+}
+function findReferenceInIndexByLabel(space, contentType, label, preview) {
+    if (!isReferenceContentType(contentType))
+        return null;
+    if (!indexExists(space, resolveIndexPreview(preview)))
+        return null;
+    const rows = listReferencesByLabel(space, contentType, label.trim(), preview);
+    if (rows.length === 0)
+        return null;
+    const fieldName = contentType === 'template' ? 'cmsLabel' : 'name';
+    return assertUniqueReferenceRows(rows, `Multiple ${contentType} entries share ${fieldName} "${label}" in the local index. Use --force-cma or resolve by entry ID.`);
+}
+async function findCmaEntryByLabel(env, contentType, label) {
+    const trimmed = label.trim();
+    const fieldId = contentType === 'template' ? 'cmsLabel' : 'name';
+    const result = await env.getEntries({
+        content_type: contentType,
+        [`fields.${fieldId}`]: trimmed,
+        limit: 2,
+    });
+    if (result.items.length > 1) {
+        const fieldName = contentType === 'template' ? 'cmsLabel' : 'name';
+        throw new ReferenceCatalogAmbiguityError(`Multiple ${contentType} entries share ${fieldName} "${trimmed}" in Contentful.`, result.items.map((entry) => ({
+            id: entry.sys.id,
+            label: trimmed,
+            slug: null,
+        })));
+    }
+    if (result.items.length === 0)
+        return null;
+    return result.items[0] ?? null;
+}
+/**
+ * Resolves a slug-indexed reference entry (articleType, tagType, tag) via local index when available,
+ * otherwise falls back to CMA.
+ */
+export async function findReferenceEntryBySlug(space, env, contentType, slug, opts = {}) {
+    const fromIndex = findReferenceInIndexBySlug(space, contentType, slug, opts.preview);
+    if (fromIndex)
+        return fromIndex;
+    const entry = await findEntryByContentTypeAndSlug(env, contentType, slug);
+    if (!entry)
+        return null;
+    if (!isReferenceContentType(contentType)) {
+        return {
+            id: entry.sys.id,
+            contentType,
+            slug: normalizeSlug(slug),
+            label: entry.sys.id,
+            cmsLabel: null,
+            updatedAt: entry.sys.updatedAt,
+            tagTypeSlug: null,
+            articleTypeSlug: null,
+            date: null,
+        };
+    }
+    const mapped = referenceRowFromCmaEntry(contentType, entry, space.defaultLocale);
+    return {
+        id: mapped.id,
+        contentType: mapped.contentType,
+        slug: mapped.slug,
+        label: mapped.label,
+        cmsLabel: mapped.cmsLabel,
+        updatedAt: mapped.updatedAt,
+        tagTypeSlug: mapped.tagTypeSlug,
+        articleTypeSlug: mapped.articleTypeSlug,
+        date: mapped.date,
+    };
+}
+/**
+ * Resolves a reference entry by display label (templates use cmsLabel; others use name).
+ */
+export async function findReferenceEntryByLabel(space, env, contentType, label, opts = {}) {
+    const fromIndex = findReferenceInIndexByLabel(space, contentType, label, opts.preview);
+    if (fromIndex)
+        return fromIndex;
+    const entry = await findCmaEntryByLabel(env, contentType, label);
+    if (!entry)
+        return null;
+    if (!isReferenceContentType(contentType)) {
+        return {
+            id: entry.sys.id,
+            contentType,
+            slug: null,
+            label: label.trim(),
+            cmsLabel: null,
+            updatedAt: entry.sys.updatedAt,
+            tagTypeSlug: null,
+            articleTypeSlug: null,
+            date: null,
+        };
+    }
+    const mapped = referenceRowFromCmaEntry(contentType, entry, space.defaultLocale);
+    return {
+        id: mapped.id,
+        contentType: mapped.contentType,
+        slug: mapped.slug,
+        label: mapped.label,
+        cmsLabel: mapped.cmsLabel,
+        updatedAt: mapped.updatedAt,
+        tagTypeSlug: mapped.tagTypeSlug,
+        articleTypeSlug: mapped.articleTypeSlug,
+        date: mapped.date,
+    };
+}
+//# sourceMappingURL=reference-lookup.js.map

package/dist/index/reference-lookup.js.map

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

package/dist/index/require.d.ts

@@ -0,0 +1,22 @@
+import type { SpaceConfig } from '../config/types.js';
+import { type IndexSyncMode } from './run-sync.js';
+import { getIndexSyncReason, INDEX_STALE_MS } from './sync.js';
+export interface EnsureContentIndexOptions {
+    preview?: boolean;
+    /** Called when an automatic sync starts (missing, stale, or schema mismatch). */
+    onRebuild?: (message: string) => void;
+}
+export interface EnsureContentIndexResult {
+    syncedAt: string | null;
+    stale: boolean;
+    rebuilt: boolean;
+    syncMode?: IndexSyncMode;
+}
+/**
+ * Ensures the local content index exists and is current (schema v4, synced within 24h,
+ * and not invalidated by a committed write). Auto-sync: full rebuild when missing, schema
+ * outdated, or fully invalidated; incremental when only stale or incrementally invalidated.
+ */
+export declare function ensureContentIndex(space: SpaceConfig, opts?: EnsureContentIndexOptions): Promise<EnsureContentIndexResult>;
+export { getIndexSyncReason, INDEX_STALE_MS };
+//# sourceMappingURL=require.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"require.d.ts","sourceRoot":"","sources":["../../src/index/require.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMtD,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,eAAe,CAAC;AACxE,OAAO,EACL,kBAAkB,EAClB,cAAc,EAKf,MAAM,WAAW,CAAC;AAInB,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iFAAiF;IACjF,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAmBD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,wBAAwB,CAAC,CAiDnC;AAED,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC"}

package/dist/index/require.js

@@ -0,0 +1,74 @@
+import { setIndexSyncMode } from '../telemetry/request-stats.js';
+import { ContentIndexSyncError } from './errors.js';
+import { tryHydrateIndexFromCache } from './hydrate.js';
+import { resolveIndexPreview } from './mode.js';
+import { getIndexSyncedAt } from './query.js';
+import { runContentIndexSync } from './run-sync.js';
+import { getIndexSyncReason, INDEX_STALE_MS, indexSyncModeForReason, isSyncedAtStale, resolveIndexSyncReason, } from './sync.js';
+import { IndexSyncLockError } from './sync-lock.js';
+import { isIndexSyncVerbose } from './sync-log.js';
+function rebuildMessage(reason) {
+    switch (reason) {
+        case 'missing':
+            return 'Building content index (not built)…';
+        case 'schema':
+            return 'Rebuilding content index (schema outdated)…';
+        case 'stale':
+            return 'Refreshing content index (stale >24h, incremental)…';
+        case 'invalidated-incremental':
+            return 'Refreshing content index (recent edits, incremental)…';
+        case 'invalidated-full':
+            return 'Rebuilding content index (catalog change, full)…';
+        default:
+            return 'Syncing content index…';
+    }
+}
+/**
+ * Ensures the local content index exists and is current (schema v4, synced within 24h,
+ * and not invalidated by a committed write). Auto-sync: full rebuild when missing, schema
+ * outdated, or fully invalidated; incremental when only stale or incrementally invalidated.
+ */
+export async function ensureContentIndex(space, opts = {}) {
+    const preview = resolveIndexPreview(opts.preview);
+    const hydrated = await tryHydrateIndexFromCache(space, preview);
+    const reason = await resolveIndexSyncReason(space, preview);
+    if (reason === 'current') {
+        setIndexSyncMode(hydrated ? 'hydrate' : 'skip');
+        const syncedAt = getIndexSyncedAt(space, preview);
+        return {
+            syncedAt,
+            stale: syncedAt ? isSyncedAtStale(syncedAt) : true,
+            rebuilt: false,
+        };
+    }
+    const mode = indexSyncModeForReason(reason);
+    if (!mode) {
+        const syncedAt = getIndexSyncedAt(space, preview);
+        return { syncedAt, stale: false, rebuilt: false };
+    }
+    opts.onRebuild?.(rebuildMessage(reason));
+    try {
+        const result = await runContentIndexSync(space, {
+            preview,
+            warnOnKeyCreated: true,
+            mode,
+            verbose: isIndexSyncVerbose(),
+        });
+        setIndexSyncMode(result.syncMode);
+        return {
+            syncedAt: result.syncedAt,
+            stale: false,
+            rebuilt: true,
+            syncMode: result.syncMode,
+        };
+    }
+    catch (err) {
+        if (err instanceof IndexSyncLockError) {
+            throw err;
+        }
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new ContentIndexSyncError(`Content index sync failed (${detail}). Run: cms-edit index sync`, { cause: err });
+    }
+}
+export { getIndexSyncReason, INDEX_STALE_MS };
+//# sourceMappingURL=require.js.map

package/dist/index/require.js.map

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

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

@@ -0,0 +1,22 @@
+import type { SpaceConfig } from '../config/types.js';
+import { type SyncIndexResult } from './sync.js';
+export type IndexSyncMode = 'full' | 'incremental';
+export interface RunContentIndexSyncOptions {
+    preview?: boolean;
+    /** When true, log a warning if a delivery API key was auto-created. */
+    warnOnKeyCreated?: boolean;
+    /**
+     * `full` — replace all rows (default for `cms-edit index sync`).
+     * `incremental` — upsert only items updated since last `syncedAt` (auto-refresh when stale).
+     */
+    mode?: IndexSyncMode;
+    /** Progress on stderr; also enabled with `LOG_CMS_INDEX=1`. */
+    verbose?: boolean;
+    /** When false, skip publishing the SQLite blob to the shared cache (internal). */
+    publishCache?: boolean;
+}
+/**
+ * Fetches CDA/CPA payload and rebuilds or merges into the local SQLite index.
+ */
+export declare function runContentIndexSync(space: SpaceConfig, opts?: RunContentIndexSyncOptions): Promise<SyncIndexResult>;
+//# sourceMappingURL=run-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-sync.d.ts","sourceRoot":"","sources":["../../src/index/run-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAYtD,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,WAAW,CAAC;AAGnB,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,aAAa,CAAC;AAEnD,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kFAAkF;IAClF,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAkBD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE,0BAA+B,GACpC,OAAO,CAAC,eAAe,CAAC,CAsE1B"}

package/dist/index/run-sync.js

@@ -0,0 +1,76 @@
+import { fetchCdaIndexPayload } from '../contentful/cda-sync.js';
+import { DEFAULT_DELIVERY_KEY_NAME, resolveDeliveryAccessToken, } from '../contentful/delivery-token.js';
+import { warnMsg } from '../output/print.js';
+import { withDistributedIndexSyncLock } from './distributed-sync-lock.js';
+import { resolveIndexPreview } from './mode.js';
+import { ensureIndexDirectory, getIndexDbPath } from './paths.js';
+import { publishIndexCache } from './publish-cache.js';
+import { getIndexSyncedAt } from './query.js';
+import { getIndexSyncReason, indexSyncModeForReason, mergeIndexFromPayload, rebuildIndexFromPayload, resolveIndexSyncReason, } from './sync.js';
+import { indexSyncVerbose, isIndexSyncVerbose } from './sync-log.js';
+async function resolveSyncMode(space, preview, requested) {
+    if (requested === 'full')
+        return 'full';
+    if (requested === 'incremental')
+        return 'incremental';
+    const reason = await resolveIndexSyncReason(space, preview);
+    const fromReason = indexSyncModeForReason(reason);
+    if (fromReason)
+        return fromReason;
+    const legacyReason = getIndexSyncReason(space, preview);
+    return indexSyncModeForReason(legacyReason) ?? 'full';
+}
+/**
+ * Fetches CDA/CPA payload and rebuilds or merges into the local SQLite index.
+ */
+export async function runContentIndexSync(space, opts = {}) {
+    const preview = resolveIndexPreview(opts.preview);
+    ensureIndexDirectory(space, preview);
+    const dbPath = getIndexDbPath(space, preview);
+    const mode = await resolveSyncMode(space, preview, opts.mode);
+    const verbose = opts.verbose === true || isIndexSyncVerbose();
+    const publishCache = opts.publishCache !== false;
+    return withDistributedIndexSyncLock(space, preview, dbPath, async () => {
+        if (verbose) {
+            indexSyncVerbose(`Starting ${mode} sync → ${dbPath}${preview ? ' (preview/draft)' : ' (published)'}`);
+        }
+        if (verbose)
+            indexSyncVerbose('Resolving CDN access token…');
+        const resolved = await resolveDeliveryAccessToken(space, { preview });
+        if (verbose) {
+            indexSyncVerbose(`Token source: ${resolved.source}` +
+                (resolved.apiKeyId ? `, API key ${resolved.apiKeyId}` : ''));
+        }
+        if (opts.warnOnKeyCreated && resolved.source === 'created-key') {
+            warnMsg(`Created Content Delivery API key "${DEFAULT_DELIVERY_KEY_NAME}" in this space. ` +
+                'Review API keys in Contentful and disable autoCreateDeliveryApiKey when not needed.');
+        }
+        const updatedSince = mode === 'incremental' ? (getIndexSyncedAt(space, preview) ?? undefined) : undefined;
+        const payload = await fetchCdaIndexPayload(space, resolved.accessToken, preview, {
+            updatedSince,
+            verbose,
+        });
+        if (verbose) {
+            indexSyncVerbose(`Writing SQLite (${mode}): ${String(payload.assets.length)} assets, ` +
+                `${String(payload.media.length)} media, ${String(payload.references.length)} catalog rows`);
+        }
+        const syncOptions = {
+            preview,
+            accessToken: resolved.accessToken,
+            apiKeyId: resolved.apiKeyId,
+            payload,
+        };
+        const result = mode === 'incremental' && updatedSince
+            ? mergeIndexFromPayload(space, syncOptions)
+            : rebuildIndexFromPayload(space, syncOptions);
+        if (verbose) {
+            indexSyncVerbose(`Done (${result.syncMode}): ${String(result.assetCount)} assets, ` +
+                `${String(result.mediaCount)} media, ${String(result.referenceCount)} catalog in index`);
+        }
+        if (publishCache) {
+            await publishIndexCache(space, preview, result);
+        }
+        return result;
+    });
+}
+//# sourceMappingURL=run-sync.js.map

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

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

package/dist/index/schema.d.ts

@@ -0,0 +1,19 @@
+export declare const SCHEMA_VERSION = 4;
+export declare const CATALOG_CONTENT_TYPES: readonly ["page", "article", "pageVariant", "template", "articleType", "tagType", "tag", "navigation", "navigationItem"];
+export type CatalogContentType = (typeof CATALOG_CONTENT_TYPES)[number];
+/** @deprecated Use {@link CATALOG_CONTENT_TYPES}. */
+export declare const REFERENCE_CONTENT_TYPES: readonly ["page", "article", "pageVariant", "template", "articleType", "tagType", "tag", "navigation", "navigationItem"];
+/** @deprecated Use {@link CatalogContentType}. */
+export type ReferenceContentType = CatalogContentType;
+export declare function isCatalogContentType(type: string): type is CatalogContentType;
+/** @deprecated Use {@link isCatalogContentType}. */
+export declare function isReferenceContentType(type: string): type is ReferenceContentType;
+export declare const TABLE_DDL = "\nCREATE TABLE IF NOT EXISTS meta (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS assets (\n  id TEXT PRIMARY KEY,\n  fileName TEXT NOT NULL,\n  title TEXT NOT NULL,\n  description TEXT,\n  contentType TEXT NOT NULL,\n  url TEXT NOT NULL,\n  width INTEGER,\n  height INTEGER,\n  size INTEGER,\n  updatedAt TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS media (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  assetId TEXT NOT NULL,\n  assetFileName TEXT NOT NULL,\n  updatedAt TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS reference_entries (\n  id TEXT PRIMARY KEY,\n  contentType TEXT NOT NULL,\n  slug TEXT,\n  label TEXT NOT NULL,\n  cmsLabel TEXT,\n  updatedAt TEXT NOT NULL,\n  tagTypeSlug TEXT,\n  articleTypeSlug TEXT,\n  date TEXT\n);\n";
+/** Indexes on columns present in schema v1/v2 (safe before v3 column migration). */
+export declare const BASE_INDEX_DDL = "\nCREATE INDEX IF NOT EXISTS idx_assets_fileName ON assets(fileName);\nCREATE INDEX IF NOT EXISTS idx_assets_title ON assets(title);\nCREATE INDEX IF NOT EXISTS idx_media_assetId ON media(assetId);\nCREATE INDEX IF NOT EXISTS idx_media_assetFileName ON media(assetFileName);\nCREATE INDEX IF NOT EXISTS idx_ref_type_slug ON reference_entries(contentType, slug);\nCREATE INDEX IF NOT EXISTS idx_ref_type_label ON reference_entries(contentType, label);\n";
+/** Indexes on schema v3 catalog columns — applied after migrateReferenceEntriesTable. */
+export declare const REFERENCE_V3_INDEX_DDL = "\nCREATE INDEX IF NOT EXISTS idx_ref_type_cms_label ON reference_entries(contentType, cmsLabel);\nCREATE INDEX IF NOT EXISTS idx_ref_tag_type_slug ON reference_entries(contentType, tagTypeSlug);\nCREATE INDEX IF NOT EXISTS idx_ref_article_type_slug ON reference_entries(contentType, articleTypeSlug);\n";
+/** Indexes on schema v4 article date column — applied after migrateReferenceEntriesTable. */
+export declare const REFERENCE_V4_INDEX_DDL = "\nCREATE INDEX IF NOT EXISTS idx_ref_article_date ON reference_entries(contentType, date);\n";
+export declare const DDL = "\nCREATE TABLE IF NOT EXISTS meta (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS assets (\n  id TEXT PRIMARY KEY,\n  fileName TEXT NOT NULL,\n  title TEXT NOT NULL,\n  description TEXT,\n  contentType TEXT NOT NULL,\n  url TEXT NOT NULL,\n  width INTEGER,\n  height INTEGER,\n  size INTEGER,\n  updatedAt TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS media (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  assetId TEXT NOT NULL,\n  assetFileName TEXT NOT NULL,\n  updatedAt TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS reference_entries (\n  id TEXT PRIMARY KEY,\n  contentType TEXT NOT NULL,\n  slug TEXT,\n  label TEXT NOT NULL,\n  cmsLabel TEXT,\n  updatedAt TEXT NOT NULL,\n  tagTypeSlug TEXT,\n  articleTypeSlug TEXT,\n  date TEXT\n);\n\nCREATE INDEX IF NOT EXISTS idx_assets_fileName ON assets(fileName);\nCREATE INDEX IF NOT EXISTS idx_assets_title ON assets(title);\nCREATE INDEX IF NOT EXISTS idx_media_assetId ON media(assetId);\nCREATE INDEX IF NOT EXISTS idx_media_assetFileName ON media(assetFileName);\nCREATE INDEX IF NOT EXISTS idx_ref_type_slug ON reference_entries(contentType, slug);\nCREATE INDEX IF NOT EXISTS idx_ref_type_label ON reference_entries(contentType, label);\n\nCREATE INDEX IF NOT EXISTS idx_ref_type_cms_label ON reference_entries(contentType, cmsLabel);\nCREATE INDEX IF NOT EXISTS idx_ref_tag_type_slug ON reference_entries(contentType, tagTypeSlug);\nCREATE INDEX IF NOT EXISTS idx_ref_article_type_slug ON reference_entries(contentType, articleTypeSlug);\n\nCREATE INDEX IF NOT EXISTS idx_ref_article_date ON reference_entries(contentType, date);\n";
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/index/schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,eAAO,MAAM,qBAAqB,0HAUxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,qDAAqD;AACrD,eAAO,MAAM,uBAAuB,0HAAwB,CAAC;AAE7D,kDAAkD;AAClD,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEtD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,kBAAkB,CAE7E;AAED,oDAAoD;AACpD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,oBAAoB,CAEjF;AAED,eAAO,MAAM,SAAS,uxBAsCrB,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,cAAc,ycAO1B,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,mTAIlC,CAAC;AAEF,6FAA6F;AAC7F,eAAO,MAAM,sBAAsB,iGAElC,CAAC;AAEF,eAAO,MAAM,GAAG,qmDAAoF,CAAC"}

package/dist/index/schema.js

@@ -0,0 +1,81 @@
+export const SCHEMA_VERSION = 4;
+export const CATALOG_CONTENT_TYPES = [
+    'page',
+    'article',
+    'pageVariant',
+    'template',
+    'articleType',
+    'tagType',
+    'tag',
+    'navigation',
+    'navigationItem',
+];
+/** @deprecated Use {@link CATALOG_CONTENT_TYPES}. */
+export const REFERENCE_CONTENT_TYPES = CATALOG_CONTENT_TYPES;
+export function isCatalogContentType(type) {
+    return CATALOG_CONTENT_TYPES.includes(type);
+}
+/** @deprecated Use {@link isCatalogContentType}. */
+export function isReferenceContentType(type) {
+    return isCatalogContentType(type);
+}
+export const TABLE_DDL = `
+CREATE TABLE IF NOT EXISTS meta (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS assets (
+  id TEXT PRIMARY KEY,
+  fileName TEXT NOT NULL,
+  title TEXT NOT NULL,
+  description TEXT,
+  contentType TEXT NOT NULL,
+  url TEXT NOT NULL,
+  width INTEGER,
+  height INTEGER,
+  size INTEGER,
+  updatedAt TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS media (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  assetId TEXT NOT NULL,
+  assetFileName TEXT NOT NULL,
+  updatedAt TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS reference_entries (
+  id TEXT PRIMARY KEY,
+  contentType TEXT NOT NULL,
+  slug TEXT,
+  label TEXT NOT NULL,
+  cmsLabel TEXT,
+  updatedAt TEXT NOT NULL,
+  tagTypeSlug TEXT,
+  articleTypeSlug TEXT,
+  date TEXT
+);
+`;
+/** Indexes on columns present in schema v1/v2 (safe before v3 column migration). */
+export const BASE_INDEX_DDL = `
+CREATE INDEX IF NOT EXISTS idx_assets_fileName ON assets(fileName);
+CREATE INDEX IF NOT EXISTS idx_assets_title ON assets(title);
+CREATE INDEX IF NOT EXISTS idx_media_assetId ON media(assetId);
+CREATE INDEX IF NOT EXISTS idx_media_assetFileName ON media(assetFileName);
+CREATE INDEX IF NOT EXISTS idx_ref_type_slug ON reference_entries(contentType, slug);
+CREATE INDEX IF NOT EXISTS idx_ref_type_label ON reference_entries(contentType, label);
+`;
+/** Indexes on schema v3 catalog columns — applied after migrateReferenceEntriesTable. */
+export const REFERENCE_V3_INDEX_DDL = `
+CREATE INDEX IF NOT EXISTS idx_ref_type_cms_label ON reference_entries(contentType, cmsLabel);
+CREATE INDEX IF NOT EXISTS idx_ref_tag_type_slug ON reference_entries(contentType, tagTypeSlug);
+CREATE INDEX IF NOT EXISTS idx_ref_article_type_slug ON reference_entries(contentType, articleTypeSlug);
+`;
+/** Indexes on schema v4 article date column — applied after migrateReferenceEntriesTable. */
+export const REFERENCE_V4_INDEX_DDL = `
+CREATE INDEX IF NOT EXISTS idx_ref_article_date ON reference_entries(contentType, date);
+`;
+export const DDL = `${TABLE_DDL}${BASE_INDEX_DDL}${REFERENCE_V3_INDEX_DDL}${REFERENCE_V4_INDEX_DDL}`;
+//# sourceMappingURL=schema.js.map

package/dist/index/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/index/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,MAAM;IACN,SAAS;IACT,aAAa;IACb,UAAU;IACV,aAAa;IACb,SAAS;IACT,KAAK;IACL,YAAY;IACZ,gBAAgB;CACR,CAAC;AAIX,qDAAqD;AACrD,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAK7D,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAQ,qBAA2C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACrE,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCxB,CAAC;AAEF,oFAAoF;AACpF,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;CAO7B,CAAC;AAEF,yFAAyF;AACzF,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;CAIrC,CAAC;AAEF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,sBAAsB,GAAG;;CAErC,CAAC;AAEF,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,SAAS,GAAG,cAAc,GAAG,sBAAsB,GAAG,sBAAsB,EAAE,CAAC"}

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

@@ -0,0 +1,9 @@
+export declare class IndexSyncLockError extends Error {
+    constructor(message: string);
+}
+/**
+ * Ensures only one process syncs a given index database at a time.
+ * Fails immediately if a non-stale lock is already held.
+ */
+export declare function withIndexSyncLock<T>(dbPath: string, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=sync-lock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-lock.d.ts","sourceRoot":"","sources":["../../src/index/sync-lock.ts"],"names":[],"mappings":"AAKA,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAwFD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAa3F"}