@se-studio/contentful-cms 1.0.1

package/dist/commands/set.js

@@ -0,0 +1,152 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import * as fs from 'node:fs';
+import { errorMsg, successMsg } from '../output/print.js';
+import { makeEntryLink, resolveRef, resolveRefToId } from '../session/refs.js';
+import { CONTENT_ARRAY_FIELDS } from '../session/state.js';
+import { requireSession, saveSession } from '../session/store.js';
+export function registerSetCommand(program) {
+    program
+        .command('set <ref> <field> [value]')
+        .description('Set a field on an entry.\n' +
+        'Scalar (default): pass a string, boolean, or number as <value>.\n' +
+        'Object/JSON: use --file <path> to read JSON from a file, or --json <json> for inline JSON.\n' +
+        'Entry link: use --link (value = linked entry ID).\n' +
+        'Content array: use --links (value = comma-separated refs or IDs); use --append to append.\n' +
+        'For rich text fields use "cms-edit rtf" instead.')
+        .option('--link', 'Value is an entry ID for a single-entry link field')
+        .option('--links', 'Value is comma-separated refs or entry IDs; field must be topContent, content, bottomContent, or contents')
+        .option('--append', 'With --links: append to existing array instead of replacing')
+        .option('--file <path>', 'Read JSON from a file and set the field as an Object value')
+        .option('--json <json>', 'Inline JSON string to set the field as an Object value')
+        .action((ref, field, rawValue, opts) => {
+        try {
+            const isObjectMode = !!(opts.file ?? opts.json);
+            if (opts.file && opts.json) {
+                errorMsg('Cannot use both --file and --json.');
+                process.exit(1);
+            }
+            if (opts.link && opts.links) {
+                errorMsg('Cannot use both --link and --links.');
+                process.exit(1);
+            }
+            if (isObjectMode && (opts.link || opts.links)) {
+                errorMsg('Cannot combine --file/--json with --link or --links.');
+                process.exit(1);
+            }
+            if (opts.append && !opts.links) {
+                errorMsg('--append is only valid with --links.');
+                process.exit(1);
+            }
+            const session = requireSession();
+            const entry = resolveRef(session, ref);
+            const locale = session.defaultLocale;
+            if (isObjectMode) {
+                const jsonString = opts.file ? readFileStrict(opts.file) : opts.json;
+                const parsed = parseJsonStrict(jsonString, opts.file);
+                if (!entry.fields[field]) {
+                    entry.fields[field] = {};
+                }
+                entry.fields[field][locale] = parsed;
+                if (!session.modifiedEntryIds.includes(entry.sys.id)) {
+                    session.modifiedEntryIds.push(entry.sys.id);
+                }
+                saveSession(session);
+                successMsg(opts.file
+                    ? `Set ${field} on ${ref} from file "${opts.file}".`
+                    : `Set ${field} on ${ref} to inline JSON object.`);
+                return;
+            }
+            if (!rawValue && !opts.links) {
+                errorMsg('Missing value. Provide a <value> argument, or use --file <path> / --json <json> for Object fields.');
+                process.exit(1);
+            }
+            const effectiveValue = rawValue ?? '';
+            if (opts.links) {
+                if (!CONTENT_ARRAY_FIELDS.includes(field)) {
+                    errorMsg(`Field must be one of: ${CONTENT_ARRAY_FIELDS.join(', ')}. Got: ${field}`);
+                    process.exit(1);
+                }
+                const entryIds = parseRefsOrIds(session, effectiveValue);
+                const linkArray = entryIds.map((id) => makeEntryLink(id));
+                if (!entry.fields[field]) {
+                    entry.fields[field] = {};
+                }
+                const fieldLocaleMap = entry.fields[field];
+                const existing = fieldLocaleMap[locale] ?? fieldLocaleMap['en-US'] ?? [];
+                const current = Array.isArray(existing) ? existing : [];
+                const newValue = opts.append ? [...current, ...linkArray] : linkArray;
+                fieldLocaleMap[locale] = newValue;
+                if (!session.modifiedEntryIds.includes(entry.sys.id)) {
+                    session.modifiedEntryIds.push(entry.sys.id);
+                }
+                saveSession(session);
+                successMsg(opts.append
+                    ? `Appended ${linkArray.length} link(s) to ${field} on ${ref}.`
+                    : `Set ${field} on ${ref} to ${linkArray.length} link(s).`);
+                return;
+            }
+            const value = opts.link
+                ? { sys: { id: effectiveValue.trim(), linkType: 'Entry' } }
+                : parseScalarValue(effectiveValue);
+            if (!entry.fields[field]) {
+                entry.fields[field] = {};
+            }
+            entry.fields[field][locale] = value;
+            if (!session.modifiedEntryIds.includes(entry.sys.id)) {
+                session.modifiedEntryIds.push(entry.sys.id);
+            }
+            saveSession(session);
+            successMsg(opts.link
+                ? `Set ${field} on ${ref} to entry link → ${effectiveValue.trim()}`
+                : `Set ${field} on ${ref} to: ${JSON.stringify(value)}`);
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+function readFileStrict(filePath) {
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`File not found: "${filePath}"`);
+    }
+    return fs.readFileSync(filePath, 'utf-8');
+}
+function parseJsonStrict(jsonString, sourceFile) {
+    try {
+        return JSON.parse(jsonString);
+    }
+    catch {
+        const source = sourceFile ? `in "${sourceFile}"` : 'in --json value';
+        throw new Error(`Invalid JSON ${source}: ${jsonString.slice(0, 80)}${jsonString.length > 80 ? '…' : ''}`);
+    }
+}
+function parseRefsOrIds(session, raw) {
+    const tokens = raw
+        .split(',')
+        .map((t) => t.trim())
+        .filter(Boolean);
+    const ids = [];
+    for (const token of tokens) {
+        if (token.startsWith('@')) {
+            ids.push(resolveRefToId(session, token));
+        }
+        else {
+            ids.push(token);
+        }
+    }
+    return ids;
+}
+function parseScalarValue(raw) {
+    if (raw === 'true')
+        return true;
+    if (raw === 'false')
+        return false;
+    if (raw === 'null')
+        return null;
+    const num = Number(raw);
+    if (!Number.isNaN(num) && raw.trim() !== '')
+        return num;
+    return raw;
+}
+//# sourceMappingURL=set.js.map

package/dist/commands/set.js.map

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

package/dist/commands/skill.d.ts

@@ -0,0 +1,4 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import type { Command } from 'commander';
+export declare function registerSkillCommand(program: Command): void;
+//# sourceMappingURL=skill.d.ts.map

package/dist/commands/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAKvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuD3D"}

package/dist/commands/skill.js

@@ -0,0 +1,73 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(__dirname, '..', '..');
+const skillsDir = path.join(packageRoot, 'skills');
+const MANIFEST_PATH = path.join(skillsDir, 'manifest.json');
+function getManifest() {
+    const raw = fs.readFileSync(MANIFEST_PATH, 'utf8');
+    return JSON.parse(raw);
+}
+function getInstallDir(global) {
+    if (global) {
+        const home = process.env.HOME ?? process.env.USERPROFILE ?? '';
+        if (!home) {
+            throw new Error('Cannot resolve home directory for --global install');
+        }
+        return path.join(home, '.cursor', 'skills', 'contentful-cms');
+    }
+    return path.join(process.cwd(), '.cursor', 'skills', 'contentful-cms');
+}
+export function registerSkillCommand(program) {
+    const skill = program
+        .command('skill')
+        .description('List, install, or show path for cms-edit skills');
+    skill
+        .command('list')
+        .description('List available skills (name and one-line description)')
+        .action(() => {
+        const manifest = getManifest();
+        for (const [name, description] of Object.entries(manifest)) {
+            console.log(`${name}\t${description}`);
+        }
+    });
+    skill
+        .command('path')
+        .description('Print the directory where skills are (or would be) installed')
+        .option('--global', 'User directory (~/.cursor/skills/contentful-cms)')
+        .action((opts) => {
+        const dir = getInstallDir(Boolean(opts.global));
+        console.log(dir);
+    });
+    skill
+        .command('install [skill-names...]')
+        .description('Install skill(s) into project (.cursor/skills/contentful-cms) or --global')
+        .option('--global', 'Install into user directory (~/.cursor/skills/contentful-cms)')
+        .action((skillNames, opts) => {
+        const manifest = getManifest();
+        const toInstall = skillNames.length > 0 ? skillNames : Object.keys(manifest);
+        for (const name of toInstall) {
+            if (!(name in manifest)) {
+                console.error(`Unknown skill: ${name}. Available: ${Object.keys(manifest).join(', ')}`);
+                process.exit(1);
+            }
+        }
+        const installDir = getInstallDir(Boolean(opts.global));
+        for (const name of toInstall) {
+            const src = path.join(skillsDir, name, 'SKILL.md');
+            if (!fs.existsSync(src)) {
+                console.error(`Skill file not found: ${src}`);
+                process.exit(1);
+            }
+            const destDir = path.join(installDir, name);
+            const dest = path.join(destDir, 'SKILL.md');
+            fs.mkdirSync(destDir, { recursive: true });
+            const content = fs.readFileSync(src, 'utf8');
+            fs.writeFileSync(dest, content, 'utf8');
+            console.log(`Installed: ${name} -> ${dest}`);
+        }
+    });
+}
+//# sourceMappingURL=skill.js.map

package/dist/commands/skill.js.map

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

package/dist/commands/snapshot.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerSnapshotCommand(program: Command): void;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/commands/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/commands/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAe9D"}

package/dist/commands/snapshot.js

@@ -0,0 +1,21 @@
+import { errorMsg } from '../output/print.js';
+import { requireSession } from '../session/store.js';
+import { renderSnapshot } from '../snapshot/render.js';
+export function registerSnapshotCommand(program) {
+    program
+        .command('snapshot')
+        .alias('tree')
+        .description('Re-print the content tree with @refs and status badges')
+        .option('-c, --compact', 'Compact output — show type labels only, no entry labels or status')
+        .action((opts) => {
+        try {
+            const session = requireSession();
+            renderSnapshot(session, { compact: opts.compact });
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/commands/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/commands/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,KAAK,CAAC,MAAM,CAAC;SACb,WAAW,CAAC,wDAAwD,CAAC;SACrE,MAAM,CAAC,eAAe,EAAE,mEAAmE,CAAC;SAC5F,MAAM,CAAC,CAAC,IAA2B,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;YACjC,cAAc,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/types.d.ts

@@ -0,0 +1,4 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import type { Command } from 'commander';
+export declare function registerTypesCommand(program: Command): void;
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuF3D"}

package/dist/commands/types.js

@@ -0,0 +1,78 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import pc from 'picocolors';
+import { loadConfig, resolveSpaceConfig } from '../config/load.js';
+import { createSafeEnvironment } from '../contentful/client.js';
+import { isJsonMode } from '../output/mode.js';
+import { errorMsg } from '../output/print.js';
+export function registerTypesCommand(program) {
+    program
+        .command('types <content-type>')
+        .description('List the valid type-discriminator enum values for a Contentful content type.\n' +
+        'Looks up the {contentType}Type field (e.g. componentType, collectionType, externalComponentType).\n' +
+        'Works for any content type that has a *Type discriminator field.\n' +
+        'Examples: cms-edit types component | cms-edit types collection | cms-edit types externalComponent')
+        .action(async (contentType, _opts, cmd) => {
+        const parentOpts = cmd.parent?.opts() ?? {};
+        try {
+            const config = loadConfig(parentOpts.config);
+            const { space } = resolveSpaceConfig(config, parentOpts.space);
+            const env = await createSafeEnvironment(space);
+            const typeFieldId = `${contentType}Type`;
+            let ct;
+            try {
+                ct = await env.getContentType(contentType);
+            }
+            catch {
+                errorMsg(`Content type "${contentType}" not found in this space. ` +
+                    `Check the ID is correct (IDs are camelCase, e.g. externalComponent).`);
+                process.exit(1);
+                return;
+            }
+            const typeField = ct.fields.find((f) => f.id === typeFieldId);
+            if (!typeField) {
+                if (isJsonMode()) {
+                    console.log(JSON.stringify({
+                        contentType,
+                        typeField: typeFieldId,
+                        values: [],
+                        message: `No "${typeFieldId}" field found — this content type may not use a type discriminator.`,
+                    }));
+                }
+                else {
+                    console.log(pc.dim(`No "${typeFieldId}" field found on the "${contentType}" content type. ` +
+                        `This content type may not use a type discriminator.`));
+                }
+                return;
+            }
+            const validations = typeField.validations ?? [];
+            const values = [];
+            for (const v of validations) {
+                const inValues = v.in;
+                if (Array.isArray(inValues)) {
+                    values.push(...inValues);
+                }
+            }
+            if (isJsonMode()) {
+                console.log(JSON.stringify({ contentType, typeField: typeFieldId, values: values.sort() }, null, 2));
+                return;
+            }
+            if (values.length === 0) {
+                console.log(pc.dim(`No enum values found for "${typeFieldId}".`));
+                return;
+            }
+            const label = contentType.charAt(0).toUpperCase() + contentType.slice(1);
+            console.log(`\n${pc.bold(`${label} types`)} (${values.length}):\n`);
+            for (const v of values.sort()) {
+                console.log(`  ${pc.cyan(v)}`);
+            }
+            console.log('');
+            console.log(pc.dim(`Use with: cms-edit add "<Type>" --content-type ${contentType}`));
+            console.log('');
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=types.js.map

package/dist/commands/types.js.map

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

package/dist/config/load.d.ts

@@ -0,0 +1,14 @@
+import type { CmsEditConfig, SpaceConfig } from './types.js';
+/**
+ * Loads .contentful-cms.json from the given path or searches up from cwd.
+ * Also loads .env.local from cwd for token resolution.
+ */
+export declare function loadConfig(configPath?: string): CmsEditConfig;
+/**
+ * Resolves a specific space config given the config and an optional override key.
+ */
+export declare function resolveSpaceConfig(config: CmsEditConfig, spaceKey?: string): {
+    key: string;
+    space: SpaceConfig;
+};
+//# sourceMappingURL=load.d.ts.map

package/dist/config/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAiB7D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAqC7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAWrC"}

package/dist/config/load.js

@@ -0,0 +1,79 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { config as loadDotenv } from 'dotenv';
+/**
+ * Resolves ${ENV_VAR} tokens in a string value using process.env.
+ */
+function resolveEnvToken(value) {
+    return value.replace(/\$\{([^}]+)\}/g, (_, key) => {
+        const resolved = process.env[key];
+        if (!resolved) {
+            throw new Error(`Environment variable "${key}" is not set. Check your .env.local or shell environment.`);
+        }
+        return resolved;
+    });
+}
+/**
+ * Loads .contentful-cms.json from the given path or searches up from cwd.
+ * Also loads .env.local from cwd for token resolution.
+ */
+export function loadConfig(configPath) {
+    const cwd = process.cwd();
+    // Load .env.local so tokens like ${CMS_EDIT_TOKEN} can be resolved
+    const envLocalPath = path.join(cwd, '.env.local');
+    if (fs.existsSync(envLocalPath)) {
+        loadDotenv({ path: envLocalPath, override: false, quiet: true });
+    }
+    const resolvedPath = configPath ? path.resolve(configPath) : findConfigFile(cwd);
+    if (!resolvedPath) {
+        throw new Error('No .contentful-cms.json found. Create one in your project root (see .contentful-cms.example.json).');
+    }
+    const raw = fs.readFileSync(resolvedPath, 'utf-8');
+    const parsed = JSON.parse(raw);
+    // Resolve env var tokens in all management tokens
+    const resolved = {
+        defaultSpace: parsed.defaultSpace,
+        spaces: {},
+    };
+    for (const [key, space] of Object.entries(parsed.spaces)) {
+        resolved.spaces[key] = {
+            spaceId: resolveEnvToken(space.spaceId),
+            environment: resolveEnvToken(space.environment),
+            managementToken: resolveEnvToken(space.managementToken),
+            defaultLocale: space.defaultLocale || 'en-US',
+            ...(space.devBaseUrl ? { devBaseUrl: space.devBaseUrl } : {}),
+        };
+    }
+    return resolved;
+}
+/**
+ * Resolves a specific space config given the config and an optional override key.
+ */
+export function resolveSpaceConfig(config, spaceKey) {
+    const key = spaceKey ?? config.defaultSpace ?? Object.keys(config.spaces)[0];
+    if (!key) {
+        throw new Error('No space configured in .contentful-cms.json');
+    }
+    const space = config.spaces[key];
+    if (!space) {
+        const available = Object.keys(config.spaces).join(', ');
+        throw new Error(`Space "${key}" not found in config. Available: ${available}`);
+    }
+    return { key, space };
+}
+/**
+ * Walk up the directory tree from start to find .contentful-cms.json.
+ */
+function findConfigFile(start) {
+    let current = start;
+    while (true) {
+        const candidate = path.join(current, '.contentful-cms.json');
+        if (fs.existsSync(candidate))
+            return candidate;
+        const parent = path.dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

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

package/dist/config/types.d.ts

@@ -0,0 +1,13 @@
+export interface SpaceConfig {
+    spaceId: string;
+    environment: string;
+    managementToken: string;
+    defaultLocale: string;
+    /** Base URL of the local dev server for this space, used by cms-edit screenshot. e.g. "http://localhost:3013" */
+    devBaseUrl?: string;
+}
+export interface CmsEditConfig {
+    defaultSpace?: string;
+    spaces: Record<string, SpaceConfig>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,iHAAiH;IACjH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC"}

package/dist/config/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":""}

package/dist/contentful/assets.d.ts

@@ -0,0 +1,20 @@
+import type { SafeEnvironment } from './client.js';
+export interface AssetSummary {
+    id: string;
+    title: string;
+    fileName: string;
+    contentType: string;
+    url: string;
+    width?: number;
+    height?: number;
+    size?: number;
+}
+/**
+ * Searches Contentful assets by title query string.
+ */
+export declare function searchAssets(env: SafeEnvironment, query: string, limit?: number): Promise<AssetSummary[]>;
+/**
+ * Fetches a single asset by ID and returns a summary.
+ */
+export declare function getAssetSummary(env: SafeEnvironment, assetId: string): Promise<AssetSummary | null>;
+//# 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":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,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;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAQ9B"}

package/dist/contentful/assets.js

@@ -0,0 +1,36 @@
+/**
+ * Searches Contentful assets by title query string.
+ */
+export async function searchAssets(env, query, limit = 10) {
+    const result = await env.getAssets({ 'fields.title[match]': query, limit });
+    return result.items.map(summariseAsset);
+}
+/**
+ * Fetches a single asset by ID and returns a summary.
+ */
+export async function getAssetSummary(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;
+    }
+}
+function summariseAsset(asset) {
+    const file = asset.fields.file;
+    const locale = Object.keys(file ?? {})[0] ?? 'en-US';
+    const fileData = file?.[locale];
+    return {
+        id: asset.sys.id,
+        title: String(asset.fields.title?.[locale] ?? asset.sys.id),
+        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":"AAcA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAoB,EACpB,KAAa,EACb,KAAK,GAAG,EAAE;IAEV,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,EAAE,qBAAqB,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5E,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAoB,EACpB,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,OAAO,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAY;IAClC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAUb,CAAC;IACd,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC;IAEhC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE;QAChB,KAAK,EAAE,MAAM,CACV,KAAK,CAAC,MAAM,CAAC,KAA6C,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CACtF;QACD,QAAQ,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE;QAClC,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,EAAE;QACxC,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE;QACjD,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK;QACtC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;QACxC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI;KAC9B,CAAC;AACJ,CAAC"}

package/dist/contentful/client.d.ts

@@ -0,0 +1,28 @@
+import type { SpaceConfig } from '../config/types.js';
+/**
+ * A restricted CMA client that deliberately does NOT expose publish, unpublish,
+ * archive, or delete methods on entries. Only safe read/write draft operations
+ * are exposed.
+ *
+ * Safety is enforced at both the Contentful Role level (no publish permissions on
+ * the token) and here at the application level (no publish methods on this interface).
+ */
+export interface SafeEnvironment {
+    getEntry(entryId: string): Promise<import('contentful-management').Entry>;
+    getEntries(query: Record<string, unknown>): Promise<import('contentful-management').Collection<import('contentful-management').Entry, import('contentful-management').EntryProps>>;
+    createEntry(contentTypeId: string, fields: Record<string, Record<string, unknown>>): Promise<import('contentful-management').Entry>;
+    getAssets(query?: Record<string, unknown>): Promise<import('contentful-management').Collection<import('contentful-management').Asset, import('contentful-management').AssetProps>>;
+    getContentType(contentTypeId: string): Promise<import('contentful-management').ContentType>;
+    getContentTypes(): Promise<import('contentful-management').Collection<import('contentful-management').ContentType, import('contentful-management').ContentTypeProps>>;
+}
+/**
+ * Creates a safe CMA environment wrapper for the given space config.
+ * The returned object only exposes methods that cannot publish or delete.
+ */
+export declare function createSafeEnvironment(space: SpaceConfig): Promise<SafeEnvironment>;
+/**
+ * Saves an entry as a draft (never publishes).
+ * Requires the entry to have been fetched via getEntry so sys.version is current.
+ */
+export declare function saveDraft(entry: import('contentful-management').Entry): Promise<import('contentful-management').Entry>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/contentful/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,uBAAuB,EAAE,KAAK,CAAC,CAAC;IAC1E,UAAU,CACR,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CACR,OAAO,uBAAuB,EAAE,UAAU,CACxC,OAAO,uBAAuB,EAAE,KAAK,EACrC,OAAO,uBAAuB,EAAE,UAAU,CAC3C,CACF,CAAC;IACF,WAAW,CACT,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC9C,OAAO,CAAC,OAAO,uBAAuB,EAAE,KAAK,CAAC,CAAC;IAClD,SAAS,CACP,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CACR,OAAO,uBAAuB,EAAE,UAAU,CACxC,OAAO,uBAAuB,EAAE,KAAK,EACrC,OAAO,uBAAuB,EAAE,UAAU,CAC3C,CACF,CAAC;IACF,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,uBAAuB,EAAE,WAAW,CAAC,CAAC;IAC5F,eAAe,IAAI,OAAO,CACxB,OAAO,uBAAuB,EAAE,UAAU,CACxC,OAAO,uBAAuB,EAAE,WAAW,EAC3C,OAAO,uBAAuB,EAAE,gBAAgB,CACjD,CACF,CAAC;CACH;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAgBxF;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,OAAO,uBAAuB,EAAE,KAAK,GAC3C,OAAO,CAAC,OAAO,uBAAuB,EAAE,KAAK,CAAC,CAEhD"}