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

package/dist/contentful/media.js

@@ -0,0 +1,82 @@
+import { makeAssetLink } from '../session/refs.js';
+import { getAssetSummary } from './assets.js';
+export function parseMediaHorizontalPosition(input) {
+    if (input === undefined || input.trim() === '') {
+        return undefined;
+    }
+    const n = input.trim().toLowerCase();
+    if (n === 'left')
+        return 'Left';
+    if (n === 'middle')
+        return 'Middle';
+    if (n === 'right')
+        return 'Right';
+    return undefined;
+}
+/** Media entry list label — prefer the linked asset's title. */
+export async function defaultMediaNameForAsset(env, assetId, fallback) {
+    const summary = await getAssetSummary(env, assetId);
+    const title = summary?.title?.trim();
+    if (title)
+        return title;
+    const fb = fallback?.trim();
+    if (fb)
+        return fb;
+    return assetId;
+}
+/**
+ * Creates a draft Media entry linking to an asset.
+ */
+export async function createMediaEntry(env, opts) {
+    const horizontalPosition = parseMediaHorizontalPosition(opts.position);
+    if (opts.position !== undefined && opts.position !== '' && horizontalPosition === undefined) {
+        throw new Error(`Invalid position "${opts.position}". Use Left, Middle, or Right (case-insensitive).`);
+    }
+    if (opts.width !== undefined) {
+        if (Number.isNaN(opts.width) || opts.width < 1 || opts.width > 100) {
+            throw new Error('--width must be an integer between 1 and 100.');
+        }
+    }
+    const fields = {
+        name: { [opts.locale]: opts.name },
+        asset: { [opts.locale]: makeAssetLink(opts.assetId) },
+    };
+    if (horizontalPosition !== undefined) {
+        fields.horizontalPosition = { [opts.locale]: horizontalPosition };
+    }
+    if (opts.width !== undefined) {
+        fields.width = { [opts.locale]: opts.width };
+    }
+    const entry = await env.createEntry('media', fields);
+    return { id: entry.sys.id };
+}
+export async function listMediaForAsset(env, assetId, locale) {
+    const entries = await listAllMediaForAsset(env, assetId, locale);
+    return entries.map((entry) => mediaEntrySummary(entry, locale));
+}
+function mediaEntrySummary(entry, locale) {
+    const fields = entry.fields;
+    const name = String(fields['name']?.[locale] ?? fields['name']?.['en-US'] ?? entry.sys.id);
+    return { id: entry.sys.id, name };
+}
+/** Fetches all Media entries linking to an asset (paginated). */
+export async function listAllMediaForAsset(env, assetId, _locale) {
+    const batchSize = 100;
+    const entries = [];
+    let skip = 0;
+    while (true) {
+        const result = await env.getEntries({
+            content_type: 'media',
+            links_to_asset: assetId,
+            limit: batchSize,
+            skip,
+        });
+        entries.push(...result.items);
+        skip += result.items.length;
+        if (result.items.length < batchSize || entries.length >= result.total) {
+            break;
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=media.js.map

package/dist/contentful/media.js.map

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

package/dist/contentful/person-create.d.ts

@@ -0,0 +1,32 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import { type EntryFieldsSpec } from './entry-fields.js';
+export interface PersonCreateResult {
+    id: string;
+    slug: string;
+    name: string;
+    status: 'created' | 'existing' | 'dry-run';
+}
+export interface PersonCreateOptions {
+    slug: string;
+    name: string;
+    cmsLabel?: string;
+    jobTitle?: string;
+    description?: string;
+    emailAddress?: string;
+    phoneNumber?: string;
+    bioMarkdown?: string;
+    /** Extra fields from --json/--json-base64 on create person. */
+    jsonSpec?: Partial<EntryFieldsSpec> & Record<string, unknown>;
+    /** Inline spec (e.g. from person-from-json batch item). */
+    spec?: EntryFieldsSpec;
+    /** Extra CLI field overrides */
+    overrides?: Record<string, unknown>;
+    ifNotExists?: boolean;
+    dryRun?: boolean;
+    /** Suppress per-item CLI/JSON output (batch-from-json commands emit one aggregate result). */
+    batch?: boolean;
+    configPath?: string;
+    spaceKey?: string;
+}
+export declare function runPersonCreate(opts: PersonCreateOptions): Promise<PersonCreateResult>;
+//# sourceMappingURL=person-create.d.ts.map

package/dist/contentful/person-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"person-create.d.ts","sourceRoot":"","sources":["../../src/contentful/person-create.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAQvF,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,2DAA2D;IAC3D,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAqCD,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAsE5F"}

package/dist/contentful/person-create.js

@@ -0,0 +1,102 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+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 { markdownToRtf } from '../rtf/fromMarkdown.js';
+import { createSafeEnvironment } from './client.js';
+import { buildEntryFieldsFromSpec, extraFieldsFromSpecSource, } from './entry-fields.js';
+import { normalizeSlug } from './fetch.js';
+function mergePersonSpec(jsonSpec, opts) {
+    const bioMarkdown = opts.bioMarkdown ??
+        (typeof jsonSpec.bioMarkdown === 'string' ? jsonSpec.bioMarkdown : undefined);
+    const overrides = {
+        ...extraFieldsFromSpecSource(jsonSpec),
+        ...(jsonSpec.fields ?? {}),
+        ...(opts.spec?.overrides ?? {}),
+        ...(opts.overrides ?? {}),
+        ...(opts.jobTitle !== undefined ? { jobTitle: opts.jobTitle } : {}),
+        ...(opts.description !== undefined ? { description: opts.description } : {}),
+        ...(opts.emailAddress !== undefined ? { emailAddress: opts.emailAddress } : {}),
+        ...(opts.phoneNumber !== undefined ? { phoneNumber: opts.phoneNumber } : {}),
+    };
+    if (bioMarkdown) {
+        overrides.bio = markdownToRtf(bioMarkdown);
+    }
+    else if (jsonSpec.bio && typeof jsonSpec.bio === 'object') {
+        overrides.bio = jsonSpec.bio;
+    }
+    return {
+        ...(opts.spec ?? {}),
+        slug: normalizeSlug(opts.slug),
+        name: opts.name,
+        cmsLabel: opts.cmsLabel ?? opts.spec?.cmsLabel ?? jsonSpec.cmsLabel,
+        overrides,
+        fields: undefined,
+    };
+}
+export async function runPersonCreate(opts) {
+    const config = loadConfig(opts.configPath);
+    const { space } = resolveSpaceConfig(config, opts.spaceKey);
+    const env = await createSafeEnvironment(space);
+    const locale = space.defaultLocale;
+    const slug = normalizeSlug(opts.slug);
+    const emit = !opts.batch;
+    if (opts.ifNotExists) {
+        const existingRef = await findReferenceEntryBySlug(space, env, 'person', slug);
+        if (existingRef) {
+            const result = {
+                id: existingRef.id,
+                slug,
+                name: opts.name,
+                status: 'existing',
+            };
+            if (emit && isJsonMode()) {
+                console.log(JSON.stringify({ ok: true, ...result }));
+            }
+            else if (emit) {
+                infoMsg(`person with slug "${slug}" already exists (ID: ${existingRef.id}).`);
+            }
+            return result;
+        }
+    }
+    const jsonSpec = opts.jsonSpec ?? {};
+    const spec = mergePersonSpec(jsonSpec, opts);
+    const { fields, warnings } = await buildEntryFieldsFromSpec(env, {
+        contentTypeId: 'person',
+        spec,
+        locale,
+        spaceId: space.spaceId,
+        environment: space.environment,
+        space,
+        strict: opts.dryRun ?? false,
+    });
+    for (const w of warnings) {
+        warnMsg(w);
+    }
+    if (opts.dryRun) {
+        if (emit && isJsonMode()) {
+            console.log(JSON.stringify({ ok: true, dryRun: true, contentType: 'person', slug, fields }));
+        }
+        else if (emit) {
+            infoMsg(`[dry-run] Would create person "${opts.name}" (slug: ${slug})`);
+        }
+        return { id: '', slug, name: opts.name, status: 'dry-run' };
+    }
+    const newEntry = await env.createEntry('person', fields);
+    const result = {
+        id: newEntry.sys.id,
+        slug,
+        name: opts.name,
+        status: 'created',
+    };
+    if (emit && isJsonMode()) {
+        console.log(JSON.stringify({ ok: true, ...result }));
+    }
+    else if (emit) {
+        successMsg(`Created person "${opts.name}" (ID: ${result.id})`);
+        infoMsg(`View in Contentful: https://app.contentful.com/spaces/${space.spaceId}/entries/${result.id}`);
+    }
+    return result;
+}
+//# sourceMappingURL=person-create.js.map

package/dist/contentful/person-create.js.map

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

package/dist/contentful/reference-record.d.ts

@@ -0,0 +1,45 @@
+import type { CatalogContentType } from '../index/schema.js';
+export interface CdaReferenceRecord {
+    id: string;
+    contentType: CatalogContentType;
+    slug: string | null;
+    label: string;
+    cmsLabel: string | null;
+    updatedAt: string;
+    tagTypeSlug: string | null;
+    articleTypeSlug: string | null;
+    /** Publication date (`YYYY-MM-DD`) for articles; null for other catalog types. */
+    date: string | null;
+}
+export interface ReferenceFieldValues {
+    slug?: string | null;
+    name?: string | null;
+    title?: string | null;
+    cmsLabel?: string | null;
+    adminLabel?: string | null;
+    date?: string | null;
+}
+export interface BuildReferenceRecordOptions {
+    strict?: boolean;
+    tagTypeSlug?: string | null;
+    articleTypeSlug?: string | null;
+    date?: string | null;
+}
+/**
+ * Maps normalized reference fields to a catalog row.
+ * When `strict` is true (CDA sync), incomplete rows return null. When false (CMA upsert), falls back to entry id.
+ */
+export declare function buildReferenceRecord(contentType: CatalogContentType, id: string, updatedAt: string, fields: ReferenceFieldValues, opts?: BuildReferenceRecordOptions): CdaReferenceRecord | null;
+/** Reads locale-keyed CMA fields into {@link ReferenceFieldValues}. */
+export declare function referenceFieldValuesFromCma(fields: Record<string, Record<string, unknown>>, locale: string): ReferenceFieldValues;
+export declare function referenceRowFromCmaEntry(contentType: CatalogContentType, entry: {
+    sys: {
+        id: string;
+        updatedAt: string;
+    };
+    fields: Record<string, Record<string, unknown>>;
+}, locale: string, parentSlugs?: {
+    tagTypeSlug?: string | null;
+    articleTypeSlug?: string | null;
+}): CdaReferenceRecord;
+//# sourceMappingURL=reference-record.d.ts.map

package/dist/contentful/reference-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-record.d.ts","sourceRoot":"","sources":["../../src/contentful/reference-record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,kBAAkB,CAAC;IAChC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kFAAkF;IAClF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AA+CD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,kBAAkB,EAC/B,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,oBAAoB,EAC5B,IAAI,GAAE,2BAAgC,GACrC,kBAAkB,GAAG,IAAI,CAiC3B;AAED,uEAAuE;AACvE,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC/C,MAAM,EAAE,MAAM,GACb,oBAAoB,CActB;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,kBAAkB,EAC/B,KAAK,EAAE;IACL,GAAG,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACjD,EACD,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC7E,kBAAkB,CAsBpB"}

package/dist/contentful/reference-record.js

@@ -0,0 +1,106 @@
+import { normalizeSlug } from './fetch.js';
+function catalogLabel(contentType, fields) {
+    if (contentType === 'template') {
+        return fields.cmsLabel ?? fields.adminLabel ?? fields.name ?? null;
+    }
+    if (contentType === 'page' ||
+        contentType === 'article' ||
+        contentType === 'pageVariant' ||
+        contentType === 'navigationItem') {
+        return fields.title ?? fields.name ?? null;
+    }
+    if (contentType === 'tag' ||
+        contentType === 'tagType' ||
+        contentType === 'articleType' ||
+        contentType === 'navigation') {
+        return fields.name ?? fields.title ?? null;
+    }
+    return fields.name ?? fields.title ?? fields.cmsLabel ?? null;
+}
+function catalogCmsLabel(contentType, fields) {
+    if (contentType === 'template') {
+        const raw = fields.cmsLabel ?? fields.adminLabel ?? fields.name;
+        return raw != null ? String(raw) : null;
+    }
+    if (contentType === 'page' ||
+        contentType === 'article' ||
+        contentType === 'pageVariant' ||
+        contentType === 'tag') {
+        return fields.cmsLabel != null ? String(fields.cmsLabel) : null;
+    }
+    return null;
+}
+/**
+ * Maps normalized reference fields to a catalog row.
+ * When `strict` is true (CDA sync), incomplete rows return null. When false (CMA upsert), falls back to entry id.
+ */
+export function buildReferenceRecord(contentType, id, updatedAt, fields, opts = {}) {
+    const strict = opts.strict ?? true;
+    const labelRaw = catalogLabel(contentType, fields);
+    const slugRaw = fields.slug != null ? normalizeSlug(String(fields.slug)) : null;
+    const cmsLabel = catalogCmsLabel(contentType, fields);
+    const date = contentType === 'article' ? (opts.date ?? fields.date ?? null) : null;
+    if (!labelRaw && !slugRaw && !cmsLabel) {
+        if (strict)
+            return null;
+        return {
+            id,
+            contentType,
+            slug: null,
+            label: id,
+            cmsLabel: null,
+            updatedAt,
+            tagTypeSlug: opts.tagTypeSlug ?? null,
+            articleTypeSlug: opts.articleTypeSlug ?? null,
+            date,
+        };
+    }
+    return {
+        id,
+        contentType,
+        slug: slugRaw,
+        label: String(labelRaw ?? slugRaw ?? cmsLabel ?? id),
+        cmsLabel,
+        updatedAt,
+        tagTypeSlug: opts.tagTypeSlug ?? null,
+        articleTypeSlug: opts.articleTypeSlug ?? null,
+        date,
+    };
+}
+/** Reads locale-keyed CMA fields into {@link ReferenceFieldValues}. */
+export function referenceFieldValuesFromCma(fields, locale) {
+    const pick = (fieldId) => {
+        const val = fields[fieldId]?.[locale] ?? fields[fieldId]?.['en-US'];
+        return val != null ? String(val) : null;
+    };
+    return {
+        slug: pick('slug'),
+        name: pick('name'),
+        title: pick('title'),
+        cmsLabel: pick('cmsLabel'),
+        adminLabel: pick('adminLabel'),
+        date: pick('date'),
+    };
+}
+export function referenceRowFromCmaEntry(contentType, entry, locale, parentSlugs) {
+    const fieldValues = referenceFieldValuesFromCma(entry.fields, locale);
+    const articleDate = contentType === 'article' ? (fieldValues.date ?? null) : null;
+    const row = buildReferenceRecord(contentType, entry.sys.id, entry.sys.updatedAt, fieldValues, {
+        strict: false,
+        tagTypeSlug: parentSlugs?.tagTypeSlug ?? null,
+        articleTypeSlug: parentSlugs?.articleTypeSlug ?? null,
+        date: articleDate,
+    });
+    return (row ?? {
+        id: entry.sys.id,
+        contentType,
+        slug: null,
+        label: entry.sys.id,
+        cmsLabel: null,
+        updatedAt: entry.sys.updatedAt,
+        tagTypeSlug: parentSlugs?.tagTypeSlug ?? null,
+        articleTypeSlug: parentSlugs?.articleTypeSlug ?? null,
+        date: articleDate,
+    });
+}
+//# sourceMappingURL=reference-record.js.map

package/dist/contentful/reference-record.js.map

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

package/dist/contentful/references.d.ts

@@ -0,0 +1,7 @@
+import type { SafeEnvironment } from './client.js';
+/**
+ * Counts how many entries link to the given entry ID.
+ * Used to determine if it's safe to delete an entry when it's removed from a page.
+ */
+export declare function countInboundReferences(env: SafeEnvironment, entryId: string): Promise<number>;
+//# sourceMappingURL=references.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/contentful/references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/contentful/references.js

@@ -0,0 +1,12 @@
+/**
+ * Counts how many entries link to the given entry ID.
+ * Used to determine if it's safe to delete an entry when it's removed from a page.
+ */
+export async function countInboundReferences(env, entryId) {
+    const result = await env.getEntries({
+        links_to_entry: entryId,
+        limit: 1,
+    });
+    return result.total;
+}
+//# sourceMappingURL=references.js.map

package/dist/contentful/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/contentful/references.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAoB,EACpB,OAAe;IAEf,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC;QAClC,cAAc,EAAE,OAAO;QACvB,KAAK,EAAE,CAAC;KACT,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC"}

package/dist/contentful/regex.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Parses a user-supplied regex pattern string, throwing a clear error on invalid syntax.
+ */
+export declare function parseRegExpPattern(pattern: string, label?: string): RegExp;
+/**
+ * Parses a CLI regex with length and ReDoS heuristics. Use for `--filename-match` and similar flags.
+ */
+export declare function parseSafeRegExpPattern(pattern: string, label?: string): RegExp;
+/**
+ * Extracts a literal prefix from a regex source for CMA `[match]` pre-filtering.
+ * Returns undefined when no useful prefix is available.
+ */
+export declare function regexLiteralPrefix(pattern: RegExp): string | undefined;
+//# sourceMappingURL=regex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"regex.d.ts","sourceRoot":"","sources":["../../src/contentful/regex.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,MAAM,CAM7E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,MAAM,CAUjF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKtE"}

package/dist/contentful/regex.js

@@ -0,0 +1,38 @@
+const MAX_REGEX_PATTERN_LENGTH = 256;
+/** Patterns that commonly cause catastrophic backtracking (ReDoS). */
+const REDOS_LIKE_PATTERN = /\([^)]*[+*][^)]*\)[+*?{]|(?:\([^)]*\)\{|\([^)]*[+*]\)[+*?{])|(?:[+*?]\s*){2,}/;
+/**
+ * Parses a user-supplied regex pattern string, throwing a clear error on invalid syntax.
+ */
+export function parseRegExpPattern(pattern, label = 'pattern') {
+    try {
+        return new RegExp(pattern);
+    }
+    catch {
+        throw new Error(`Invalid ${label}: "${pattern}".`);
+    }
+}
+/**
+ * Parses a CLI regex with length and ReDoS heuristics. Use for `--filename-match` and similar flags.
+ */
+export function parseSafeRegExpPattern(pattern, label = 'pattern') {
+    if (pattern.length > MAX_REGEX_PATTERN_LENGTH) {
+        throw new Error(`${label} is too long (max ${String(MAX_REGEX_PATTERN_LENGTH)} characters).`);
+    }
+    if (REDOS_LIKE_PATTERN.test(pattern)) {
+        throw new Error(`${label} uses nested or repeated quantifiers that are not allowed. Use a simpler pattern.`);
+    }
+    return parseRegExpPattern(pattern, label);
+}
+/**
+ * Extracts a literal prefix from a regex source for CMA `[match]` pre-filtering.
+ * Returns undefined when no useful prefix is available.
+ */
+export function regexLiteralPrefix(pattern) {
+    let source = pattern.source;
+    if (source.startsWith('^'))
+        source = source.slice(1);
+    const match = source.match(/^([a-zA-Z0-9_-]{2,})/);
+    return match?.[1];
+}
+//# sourceMappingURL=regex.js.map

package/dist/contentful/regex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex.js","sourceRoot":"","sources":["../../src/contentful/regex.ts"],"names":[],"mappings":"AAAA,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAErC,sEAAsE;AACtE,MAAM,kBAAkB,GACtB,+EAA+E,CAAC;AAElF;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,KAAK,GAAG,SAAS;IACnE,IAAI,CAAC;QACH,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM,OAAO,IAAI,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,KAAK,GAAG,SAAS;IACvE,IAAI,OAAO,CAAC,MAAM,GAAG,wBAAwB,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,qBAAqB,MAAM,CAAC,wBAAwB,CAAC,eAAe,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,mFAAmF,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC5B,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACnD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,9 @@
+/** Content types commonly resolved via flat `cms-edit resolve --*-slug` flags. */
+export declare const RESOLVE_BY_SLUG_CONTENT_TYPES: readonly ["page", "article", "articleType", "tagType", "tag"];
+export type ResolveBySlugContentType = (typeof RESOLVE_BY_SLUG_CONTENT_TYPES)[number];
+/**
+ * Normalises CLI `--type` values (kebab-case, case) to Contentful content type IDs.
+ * Throws when the type is empty or not a known slug-indexed type.
+ */
+export declare function normalizeResolveContentType(type: string): ResolveBySlugContentType;
+//# sourceMappingURL=resolve-content-type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-content-type.d.ts","sourceRoot":"","sources":["../../src/contentful/resolve-content-type.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,eAAO,MAAM,6BAA6B,+DAMhC,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAYtF;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAoBlF"}

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

@@ -0,0 +1,38 @@
+/** Content types commonly resolved via flat `cms-edit resolve --*-slug` flags. */
+export const RESOLVE_BY_SLUG_CONTENT_TYPES = [
+    'page',
+    'article',
+    'articleType',
+    'tagType',
+    'tag',
+];
+const ALIASES = {
+    page: 'page',
+    article: 'article',
+    articletype: 'articleType',
+    'article-type': 'articleType',
+    tagtype: 'tagType',
+    'tag-type': 'tagType',
+    tag: 'tag',
+};
+/**
+ * Normalises CLI `--type` values (kebab-case, case) to Contentful content type IDs.
+ * Throws when the type is empty or not a known slug-indexed type.
+ */
+export function normalizeResolveContentType(type) {
+    const trimmed = type.trim();
+    if (!trimmed) {
+        throw new Error('--type must not be empty.');
+    }
+    const alias = ALIASES[trimmed.toLowerCase()];
+    if (alias) {
+        return alias;
+    }
+    const kebab = trimmed.replace(/-([a-z])/gi, (_, c) => c.toUpperCase());
+    const fromKebab = ALIASES[kebab.toLowerCase()];
+    if (fromKebab) {
+        return fromKebab;
+    }
+    throw new Error(`Unknown --type "${trimmed}". Use one of: ${RESOLVE_BY_SLUG_CONTENT_TYPES.join(', ')} (kebab-case aliases such as tag-type are accepted).`);
+}
+//# sourceMappingURL=resolve-content-type.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-content-type.js","sourceRoot":"","sources":["../../src/contentful/resolve-content-type.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,MAAM;IACN,SAAS;IACT,aAAa;IACb,SAAS;IACT,KAAK;CACG,CAAC;AAIX,MAAM,OAAO,GAA6C;IACxD,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAE,aAAa;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,SAAS;IACrB,GAAG,EAAE,KAAK;CACX,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7C,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/E,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,mBAAmB,OAAO,kBAAkB,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,sDAAsD,CAC3I,CAAC;AACJ,CAAC"}

package/dist/contentful/scalar-value.d.ts

@@ -0,0 +1,19 @@
+import type { ContentFields } from 'contentful-management';
+/** Parse CLI token literals only (no numeric guessing). */
+export declare function parseScalarToken(raw: string): string | boolean | null;
+/** Extract enum values from Symbol/Text field validations (same rules as schema command). */
+export declare function getFieldEnumValues(fieldDef: ContentFields | undefined): string[] | undefined;
+/**
+ * Returns an error message if value is not in the field enum; null if valid or no enum.
+ */
+export declare function validateScalarEnum(value: unknown, fieldDef: ContentFields | undefined, fieldId: string): string | null;
+/**
+ * Coerce a CLI scalar token to the CMA value type for the field.
+ * Symbol/Text always stay strings (no numeric guessing).
+ */
+export declare function coerceScalarForField(raw: string, fieldDef: ContentFields | undefined): string | boolean | number | null;
+/**
+ * Coerce token and validate enum; throws with actionable message on failure.
+ */
+export declare function resolveScalarValueForField(raw: string, fieldDef: ContentFields | undefined, fieldId: string): string | boolean | number | null;
+//# sourceMappingURL=scalar-value.d.ts.map

package/dist/contentful/scalar-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalar-value.d.ts","sourceRoot":"","sources":["../../src/contentful/scalar-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAKrE;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAU5F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAQf;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,aAAa,GAAG,SAAS,GAClC,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAoClC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAOlC"}