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

package/dist/contentful/article-tags-from-json.js

@@ -0,0 +1,121 @@
+import { loadConfig, resolveSpaceConfig } from '../config/load.js';
+import { findReferenceEntryBySlug } from '../index/reference-lookup.js';
+import { isJsonMode } from '../output/mode.js';
+import { infoMsg, successMsg, warnMsg } from '../output/print.js';
+import { makeEntryLink } from '../session/refs.js';
+import { createSafeEnvironment } from './client.js';
+import { findEntryByContentTypeAndSlug, normalizeSlug } from './fetch.js';
+async function resolveTagIds(space, env, tagSlugs) {
+    const resolved = [];
+    for (const rawSlug of tagSlugs) {
+        const slug = normalizeSlug(rawSlug);
+        const ref = await findReferenceEntryBySlug(space, env, 'tag', slug);
+        if (!ref) {
+            throw new Error(`No tag found with slug "${slug}".`);
+        }
+        resolved.push({ slug, id: ref.id });
+    }
+    return resolved;
+}
+function readLinkIds(entry, fieldId, locale) {
+    const raw = entry.fields[fieldId]?.[locale] ?? entry.fields[fieldId]?.['en-US'];
+    if (!Array.isArray(raw))
+        return [];
+    return raw
+        .map((link) => {
+        if (link && typeof link === 'object' && 'sys' in link) {
+            return link.sys?.id;
+        }
+        return undefined;
+    })
+        .filter((id) => typeof id === 'string');
+}
+function linkArraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+async function applyTagsToArticle(space, env, locale, item, dryRun) {
+    const articleSlug = normalizeSlug(item.articleSlug);
+    const article = await findEntryByContentTypeAndSlug(env, 'article', articleSlug);
+    if (!article) {
+        throw new Error(`No article found with slug "${articleSlug}".`);
+    }
+    const tagRefs = await resolveTagIds(space, env, item.tagSlugs);
+    const newIds = tagRefs.map((t) => t.id);
+    const existingIds = readLinkIds(article, 'tags', locale);
+    const mergedIds = item.append ? [...existingIds, ...newIds] : newIds;
+    const dedupedIds = [];
+    for (const id of mergedIds) {
+        if (!dedupedIds.includes(id))
+            dedupedIds.push(id);
+    }
+    const dedupedLinks = dedupedIds.map((id) => makeEntryLink(id));
+    if (linkArraysEqual(existingIds, dedupedIds)) {
+        if (!isJsonMode()) {
+            infoMsg(`Article "${articleSlug}" tags unchanged.`);
+        }
+        return {
+            articleSlug,
+            articleId: article.sys.id,
+            tagSlugs: tagRefs.map((t) => t.slug),
+            status: 'unchanged',
+        };
+    }
+    if (dryRun) {
+        if (!isJsonMode()) {
+            infoMsg(`[dry-run] Would set tags on "${articleSlug}" to ${tagRefs.map((t) => t.slug).join(', ')}`);
+        }
+        return {
+            articleSlug,
+            articleId: article.sys.id,
+            tagSlugs: tagRefs.map((t) => t.slug),
+            status: 'dry-run',
+        };
+    }
+    const fresh = await env.getEntry(article.sys.id);
+    if (!fresh.fields['tags']) {
+        fresh.fields['tags'] = {};
+    }
+    fresh.fields['tags'][locale] = dedupedLinks;
+    await env.saveDraft(fresh);
+    if (!isJsonMode()) {
+        successMsg(`Updated tags on "${articleSlug}" → ${tagRefs.map((t) => t.slug).join(', ')} (${item.append ? 'append' : 'replace'})`);
+    }
+    return {
+        articleSlug,
+        articleId: article.sys.id,
+        tagSlugs: tagRefs.map((t) => t.slug),
+        status: 'updated',
+    };
+}
+export async function runArticleTagsFromJson(opts) {
+    const config = loadConfig(opts.configPath);
+    const { space } = resolveSpaceConfig(config, opts.spaceKey);
+    const env = await createSafeEnvironment(space);
+    const locale = space.defaultLocale;
+    const results = [];
+    for (const item of opts.items) {
+        const articleSlug = normalizeSlug(item.articleSlug);
+        try {
+            results.push(await applyTagsToArticle(space, env, locale, item, opts.dryRun));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            results.push({
+                articleSlug,
+                tagSlugs: item.tagSlugs.map(normalizeSlug),
+                status: 'failed',
+                message,
+            });
+            warnMsg(`Failed "${articleSlug}": ${message}`);
+        }
+    }
+    const ok = results.every((r) => r.status !== 'failed');
+    return { results, ok };
+}
+//# sourceMappingURL=article-tags-from-json.js.map

package/dist/contentful/article-tags-from-json.js.map

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

package/dist/contentful/article-type-resolve.d.ts

@@ -0,0 +1,11 @@
+import type { SpaceConfig } from '../config/types.js';
+import type { SafeEnvironment } from './client.js';
+export interface ArticleTypeLookupOptions {
+    articleTypeId?: string;
+    articleTypeSlug?: string;
+    articleTypeName?: string;
+}
+/** Fails fast when no article-type lookup was provided (CLI or JSON). */
+export declare function assertArticleTypeLookupProvided(opts: ArticleTypeLookupOptions): void;
+export declare function resolveArticleTypeEntryId(space: SpaceConfig, env: SafeEnvironment, opts: ArticleTypeLookupOptions): Promise<string>;
+//# sourceMappingURL=article-type-resolve.d.ts.map

package/dist/contentful/article-type-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-type-resolve.d.ts","sourceRoot":"","sources":["../../src/contentful/article-type-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAKD,yEAAyE;AACzE,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,wBAAwB,GAAG,IAAI,CAIpF;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,MAAM,CAAC,CA4BjB"}

package/dist/contentful/article-type-resolve.js

@@ -0,0 +1,35 @@
+import { findReferenceEntryByLabel, findReferenceEntryBySlug } from '../index/reference-lookup.js';
+import { findEntryByContentTypeAndSlug } from './fetch.js';
+const ARTICLE_TYPE_REQUIRED_MESSAGE = 'Article type is required. Use --article-type-id, --article-type-slug, or --article-type-name (or articleTypeId / articleTypeSlug / articleTypeName in JSON).';
+/** Fails fast when no article-type lookup was provided (CLI or JSON). */
+export function assertArticleTypeLookupProvided(opts) {
+    if (!opts.articleTypeId && !opts.articleTypeSlug && !opts.articleTypeName) {
+        throw new Error(ARTICLE_TYPE_REQUIRED_MESSAGE);
+    }
+}
+export async function resolveArticleTypeEntryId(space, env, opts) {
+    if (opts.articleTypeId) {
+        return opts.articleTypeId;
+    }
+    if (opts.articleTypeSlug) {
+        const ref = await findReferenceEntryBySlug(space, env, 'articleType', opts.articleTypeSlug);
+        if (ref) {
+            return ref.id;
+        }
+        const entry = await findEntryByContentTypeAndSlug(env, 'articleType', opts.articleTypeSlug);
+        if (entry) {
+            return entry.sys.id;
+        }
+        throw new Error(`No articleType found with slug "${opts.articleTypeSlug}". Run: cms-edit list --type articleType`);
+    }
+    if (opts.articleTypeName) {
+        const ref = await findReferenceEntryByLabel(space, env, 'articleType', opts.articleTypeName);
+        if (ref) {
+            return ref.id;
+        }
+        throw new Error(`No articleType found with name "${opts.articleTypeName}". Run: cms-edit list --type articleType`);
+    }
+    assertArticleTypeLookupProvided(opts);
+    throw new Error(ARTICLE_TYPE_REQUIRED_MESSAGE);
+}
+//# sourceMappingURL=article-type-resolve.js.map

package/dist/contentful/article-type-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-type-resolve.js","sourceRoot":"","sources":["../../src/contentful/article-type-resolve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAEnG,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAQ3D,MAAM,6BAA6B,GACjC,8JAA8J,CAAC;AAEjK,yEAAyE;AACzE,MAAM,UAAU,+BAA+B,CAAC,IAA8B;IAC5E,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAAkB,EAClB,GAAoB,EACpB,IAA8B;IAE9B,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IACD,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,wBAAwB,CAAC,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5F,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,6BAA6B,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5F,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,CAAC,eAAe,0CAA0C,CAClG,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,yBAAyB,CAAC,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7F,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,CAAC,eAAe,0CAA0C,CAClG,CAAC;IACJ,CAAC;IACD,+BAA+B,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;AACjD,CAAC"}

package/dist/contentful/asset-link-from-json.d.ts

@@ -0,0 +1,17 @@
+import type { SpaceConfig } from '../config/types.js';
+import { makeAssetLink } from '../session/refs.js';
+export interface AssetIdAliasResult {
+    assetId: string | undefined;
+    warnings: string[];
+}
+/**
+ * Resolves paired asset ID shorthands (field name vs `*Id` suffix).
+ * Prefers the field-name form when both differ.
+ */
+export declare function resolveAssetIdAlias(label: string, fieldNameValue: string | undefined, idSuffixValue: string | undefined): AssetIdAliasResult;
+/**
+ * Resolves an exact asset fileName via the local media index (no CMA scan).
+ */
+export declare function resolveAssetIdFromFilename(space: SpaceConfig, fileName: string, label: string): Promise<string>;
+export declare function assetLinkFromId(assetId: string): ReturnType<typeof makeAssetLink>;
+//# sourceMappingURL=asset-link-from-json.d.ts.map

package/dist/contentful/asset-link-from-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-link-from-json.d.ts","sourceRoot":"","sources":["../../src/contentful/asset-link-from-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,kBAAkB,CAapB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAEjF"}

package/dist/contentful/asset-link-from-json.js

@@ -0,0 +1,41 @@
+import { searchAssetsInIndex } from '../index/query.js';
+import { ensureContentIndex } from '../index/require.js';
+import { makeAssetLink } from '../session/refs.js';
+/**
+ * Resolves paired asset ID shorthands (field name vs `*Id` suffix).
+ * Prefers the field-name form when both differ.
+ */
+export function resolveAssetIdAlias(label, fieldNameValue, idSuffixValue) {
+    const warnings = [];
+    const a = typeof fieldNameValue === 'string' ? fieldNameValue.trim() : undefined;
+    const b = typeof idSuffixValue === 'string' ? idSuffixValue.trim() : undefined;
+    if (a && b && a !== b) {
+        warnings.push(`Both "${label}" and "${label}Id" were provided with different values — using "${label}".`);
+    }
+    const assetId = a ?? b;
+    return { assetId: assetId || undefined, warnings };
+}
+/**
+ * Resolves an exact asset fileName via the local media index (no CMA scan).
+ */
+export async function resolveAssetIdFromFilename(space, fileName, label) {
+    await ensureContentIndex(space);
+    const trimmed = fileName.trim();
+    const matches = searchAssetsInIndex(space, { exactFileName: trimmed, limit: 2 });
+    if (matches.length === 0) {
+        throw new Error(`No asset found with fileName "${trimmed}" (${label}). Run: cms-edit index sync`);
+    }
+    if (matches.length > 1) {
+        const ids = matches.map((m) => m.id).join(', ');
+        throw new Error(`Multiple assets share fileName "${trimmed}" (${label}). Asset IDs: ${ids}. Use an explicit asset ID instead.`);
+    }
+    const first = matches[0];
+    if (!first) {
+        throw new Error(`No asset found with fileName "${trimmed}" (${label}). Run: cms-edit index sync`);
+    }
+    return first.id;
+}
+export function assetLinkFromId(assetId) {
+    return makeAssetLink(assetId.trim());
+}
+//# sourceMappingURL=asset-link-from-json.js.map

package/dist/contentful/asset-link-from-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-link-from-json.js","sourceRoot":"","sources":["../../src/contentful/asset-link-from-json.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOnD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,cAAkC,EAClC,aAAiC;IAEjC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,CAAC,GAAG,OAAO,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,MAAM,CAAC,GAAG,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/E,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CACX,SAAS,KAAK,UAAU,KAAK,oDAAoD,KAAK,IAAI,CAC3F,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,QAAQ,EAAE,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAAkB,EAClB,QAAgB,EAChB,KAAa;IAEb,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACjF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,iCAAiC,OAAO,MAAM,KAAK,6BAA6B,CACjF,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,mCAAmC,OAAO,MAAM,KAAK,iBAAiB,GAAG,qCAAqC,CAC/G,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,iCAAiC,OAAO,MAAM,KAAK,6BAA6B,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AACvC,CAAC"}

package/dist/contentful/assets.d.ts

@@ -0,0 +1,54 @@
+import type { SafeEnvironment } from './client.js';
+/** Default upload fileName when only MIME type is known. */
+export declare function defaultFileNameForMime(mimeType: string): string;
+export interface AssetSummary {
+    id: string;
+    title: string;
+    description?: string;
+    fileName: string;
+    contentType: string;
+    url: string;
+    width?: number;
+    height?: number;
+    size?: number;
+}
+export interface BacklinkSummary {
+    entryId: string;
+    contentType: string;
+    label: string;
+}
+/**
+ * Returns entries that reference the given asset ID.
+ */
+export declare function getAssetBacklinks(env: SafeEnvironment, assetId: string, locale: string): Promise<BacklinkSummary[]>;
+/**
+ * Fetches a single asset by ID and returns a summary.
+ */
+export declare function getAssetSummary(env: SafeEnvironment, assetId: string): Promise<AssetSummary | null>;
+export interface GetAssetSummariesOptions {
+    /** Called when a batch CMA request fails and per-ID fallback is used. */
+    onWarning?: (message: string) => void;
+}
+/** Batch-fetch asset summaries by ID (one CMA request per 100 IDs). */
+export declare function getAssetSummaries(env: SafeEnvironment, assetIds: string[], options?: GetAssetSummariesOptions): Promise<Map<string, AssetSummary>>;
+/**
+ * Uploads binary content to Contentful as a new draft asset.
+ */
+export declare function uploadAssetBuffer(env: SafeEnvironment, fileBuffer: Buffer, opts: {
+    title?: string;
+    description?: string;
+    fileName: string;
+    mimeType: string;
+    locale: string;
+}, onProgress?: (msg: string) => void): Promise<AssetSummary>;
+/**
+ * Uploads a local file to Contentful as a new draft asset.
+ * Orchestrates: binary upload → asset creation → CDN processing → polling for URL.
+ */
+export declare function uploadAssetFile(env: SafeEnvironment, filePath: string, opts: {
+    title?: string;
+    description?: string;
+    locale: string;
+    fileName?: string;
+}, onProgress?: (msg: string) => void): Promise<AssetSummary>;
+//# sourceMappingURL=assets.d.ts.map

package/dist/contentful/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/contentful/assets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA8BnD,4DAA4D;AAC5D,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,EAAE,CAAC,CAU5B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAG9B;AAED,MAAM,WAAW,wBAAwB;IACvC,yEAAyE;IACzE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,uEAAuE;AACvE,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CA4BpC;AAeD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,eAAe,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;IACJ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,EACD,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,YAAY,CAAC,CAwCvB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EACjF,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,YAAY,CAAC,CAuBvB"}

package/dist/contentful/assets.js

@@ -0,0 +1,168 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { assertUploadBufferSize } from './upload-limits.js';
+const MIME_TYPE_MAP = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.svg': 'image/svg+xml',
+    '.pdf': 'application/pdf',
+    '.mp4': 'video/mp4',
+    '.mp3': 'audio/mpeg',
+    '.csv': 'text/csv',
+    '.json': 'application/json',
+};
+const MIME_TO_EXT = {
+    'image/png': '.png',
+    'image/jpeg': '.jpg',
+    'image/gif': '.gif',
+    'image/webp': '.webp',
+    'image/svg+xml': '.svg',
+    'application/pdf': '.pdf',
+    'video/mp4': '.mp4',
+    'audio/mpeg': '.mp3',
+    'text/csv': '.csv',
+    'application/json': '.json',
+};
+/** Default upload fileName when only MIME type is known. */
+export function defaultFileNameForMime(mimeType) {
+    const ext = MIME_TO_EXT[mimeType] ?? '.bin';
+    return `upload${ext}`;
+}
+/**
+ * Returns entries that reference the given asset ID.
+ */
+export async function getAssetBacklinks(env, assetId, locale) {
+    const result = await env.getEntries({ links_to_asset: assetId, limit: 10 });
+    return result.items.map((entry) => {
+        const ctId = entry.sys.contentType.sys.id;
+        const fields = entry.fields;
+        const labelField = fields['cmsLabel'] ?? fields['heading'] ?? fields['title'] ?? fields['adminLabel'];
+        const label = String(labelField?.[locale] ?? labelField?.['en-US'] ?? entry.sys.id);
+        return { entryId: entry.sys.id, contentType: ctId, label };
+    });
+}
+/**
+ * Fetches a single asset by ID and returns a summary.
+ */
+export async function getAssetSummary(env, assetId) {
+    const summaries = await getAssetSummaries(env, [assetId]);
+    return summaries.get(assetId) ?? null;
+}
+/** Batch-fetch asset summaries by ID (one CMA request per 100 IDs). */
+export async function getAssetSummaries(env, assetIds, options = {}) {
+    const uniqueIds = [...new Set(assetIds.filter(Boolean))];
+    const summaries = new Map();
+    if (uniqueIds.length === 0)
+        return summaries;
+    const batchSize = 100;
+    for (let i = 0; i < uniqueIds.length; i += batchSize) {
+        const chunk = uniqueIds.slice(i, i + batchSize);
+        try {
+            const result = await env.getAssets({
+                'sys.id[in]': chunk.join(','),
+                limit: chunk.length,
+            });
+            for (const asset of result.items) {
+                summaries.set(asset.sys.id, summariseAsset(asset));
+            }
+        }
+        catch {
+            options.onWarning?.(`Batch asset lookup failed for ${String(chunk.length)} ID(s); fetching individually.`);
+            for (const id of chunk) {
+                const single = await getAssetSummaryDirect(env, id);
+                if (single)
+                    summaries.set(id, single);
+            }
+        }
+    }
+    return summaries;
+}
+async function getAssetSummaryDirect(env, assetId) {
+    try {
+        const assets = await env.getAssets({ 'sys.id': assetId, limit: 1 });
+        const asset = assets.items[0];
+        return asset ? summariseAsset(asset) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Uploads binary content to Contentful as a new draft asset.
+ */
+export async function uploadAssetBuffer(env, fileBuffer, opts, onProgress) {
+    assertUploadBufferSize(fileBuffer);
+    const title = opts.title ?? path.basename(opts.fileName, path.extname(opts.fileName));
+    const description = opts.description ?? '';
+    const { locale, fileName, mimeType } = opts;
+    onProgress?.('Uploading file...');
+    const upload = await env.uploadFile(fileBuffer, mimeType);
+    onProgress?.('Creating asset entry...');
+    const asset = await env.createAsset({
+        title,
+        description,
+        fileName,
+        contentType: mimeType,
+        uploadId: upload.sys.id,
+        locale,
+    });
+    onProgress?.('Processing...');
+    await env.processAsset(asset, locale);
+    onProgress?.('Waiting for CDN...');
+    const assetId = asset.sys.id;
+    const pollDelaysMs = [500, 500, 1000, 1000, 1000, 1500, 2000, 2000, 2000, 2500];
+    let waitedMs = 0;
+    for (const delayMs of pollDelaysMs) {
+        await new Promise((resolve) => setTimeout(resolve, delayMs));
+        waitedMs += delayMs;
+        const polled = await env.getAsset(assetId);
+        const fileFields = polled.fields.file;
+        if (fileFields?.[locale]?.url) {
+            return summariseAsset(polled);
+        }
+    }
+    throw new Error(`Asset processing timed out after ${String(waitedMs)}ms. Check Contentful for asset ID: ${assetId}`);
+}
+/**
+ * Uploads a local file to Contentful as a new draft asset.
+ * Orchestrates: binary upload → asset creation → CDN processing → polling for URL.
+ */
+export async function uploadAssetFile(env, filePath, opts, onProgress) {
+    const resolvedPath = path.resolve(filePath);
+    if (!fs.existsSync(resolvedPath)) {
+        throw new Error(`File not found: ${resolvedPath}`);
+    }
+    const fileBuffer = fs.readFileSync(resolvedPath);
+    const ext = path.extname(resolvedPath).toLowerCase();
+    const mimeType = MIME_TYPE_MAP[ext] ?? 'application/octet-stream';
+    const fileName = opts.fileName ?? path.basename(resolvedPath);
+    return uploadAssetBuffer(env, fileBuffer, {
+        title: opts.title,
+        description: opts.description,
+        fileName,
+        mimeType,
+        locale: opts.locale,
+    }, onProgress);
+}
+function summariseAsset(asset) {
+    const file = asset.fields.file;
+    const locale = Object.keys(file ?? {})[0] ?? 'en-US';
+    const fileData = file?.[locale];
+    const descriptionRaw = asset.fields.description?.[locale];
+    const description = typeof descriptionRaw === 'string' && descriptionRaw ? descriptionRaw : undefined;
+    return {
+        id: asset.sys.id,
+        title: String(asset.fields.title?.[locale] ?? asset.sys.id),
+        description,
+        fileName: fileData?.fileName ?? '',
+        contentType: fileData?.contentType ?? '',
+        url: fileData?.url ? `https:${fileData.url}` : '',
+        width: fileData?.details?.image?.width,
+        height: fileData?.details?.image?.height,
+        size: fileData?.details?.size,
+    };
+}
+//# sourceMappingURL=assets.js.map

package/dist/contentful/assets.js.map

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

package/dist/contentful/bulk-rtf-replace.d.ts

@@ -0,0 +1,29 @@
+import type { Document } from '@contentful/rich-text-types';
+import type { SpaceConfig } from '../config/types.js';
+import type { SerializedEntry } from '../session/state.js';
+import type { SafeEnvironment } from './client.js';
+export interface BulkRtfReplaceOptions {
+    find: string;
+    replacePlain: string;
+    dryRun?: boolean;
+}
+export interface BulkRtfFieldChange {
+    fieldId: string;
+    matchCount: number;
+    nextValue?: Document;
+}
+export interface BulkRtfEntryChange {
+    entryId: string;
+    contentType: string;
+    fields: BulkRtfFieldChange[];
+}
+export declare function findRtfReplacementsInTree(env: SafeEnvironment, space: SpaceConfig, locale: string, entries: Record<string, SerializedEntry>, opts: BulkRtfReplaceOptions): Promise<BulkRtfEntryChange[]>;
+/** Merge duplicate entry IDs (shared components across page trees). Keeps the field change with the highest match count. */
+export declare function dedupeBulkRtfChanges(changes: BulkRtfEntryChange[]): BulkRtfEntryChange[];
+export declare function applyBulkRtfEntryChanges(env: SafeEnvironment, locale: string, changes: BulkRtfEntryChange[]): Promise<string[]>;
+export declare function fetchRootEntryIds(env: SafeEnvironment, contentTypes: string[], prefix: string | undefined, locale: string, limit: number): Promise<Array<{
+    id: string;
+    slug: string;
+    contentType: string;
+}>>;
+//# sourceMappingURL=bulk-rtf-replace.d.ts.map

package/dist/contentful/bulk-rtf-replace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-rtf-replace.d.ts","sourceRoot":"","sources":["../../src/contentful/bulk-rtf-replace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,QAAQ,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACxC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA4C/B;AAED,4HAA4H;AAC5H,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAyBxF;AAED,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kBAAkB,EAAE,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBnB;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,eAAe,EACpB,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAkCnE"}