@se-studio/contentful-cms 3.2.0 → 3.3.0

package/dist/mcp/tools/media.js

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import { mediaCatalog, mediaImport, mediaPrepare, mediaStatus, mediaWait, } from '../../media-pipeline/actions.js';
+import { MediaPipelineClient } from '../../media-pipeline/client.js';
+import { loadMediaPipelineConfig } from '../../media-pipeline/config.js';
+import { getRuntimeContext } from '../../runtime/context.js';
+import { prefixHostedToolDescription } from '../hosted-metadata.js';
+const TOOL_DESCRIPTION = `Prepare, inspect, and import media packs via the SE media pipeline (hosted cms-edit only).
+
+Uses the host's service credentials — never ask the user for MEDIA_PIPELINE_API_KEY.
+
+Actions:
+- prepare: start a Drive folder pack job (returns jobId)
+- status: poll job status / gap counts
+- catalog: list ready assets (readyUrl, previewUrl) for naming/alt
+- wait: poll until terminal or timeout (~25s default)
+- import: reuse-first Contentful upload from readyUrl (optional dryRun, withMedia, overrides)
+
+Workflow: prepare → wait → catalog → (draft titles/alts from previewUrl) → import.`;
+function buildActionContext(hosted) {
+    const runtime = getRuntimeContext();
+    const config = loadMediaPipelineConfig();
+    return {
+        userId: runtime?.user?.userId ?? '',
+        projectKey: runtime?.projectKey ?? hosted?.projectKey ?? 'unknown',
+        config,
+        jobStore: runtime?.mediaPipelineJobStore ?? null,
+        client: config ? new MediaPipelineClient(config) : null,
+    };
+}
+export function registerMediaTools(server, hosted) {
+    server.tool('cms_edit_media', prefixHostedToolDescription(TOOL_DESCRIPTION, hosted), {
+        action: z
+            .enum(['prepare', 'status', 'catalog', 'wait', 'import'])
+            .describe('Media pipeline action'),
+        driveFolderUrl: z.string().optional().describe('Google Drive folder URL (prepare)'),
+        jobId: z.string().optional().describe('Job id from prepare (status/catalog/wait/import)'),
+        profile: z.string().optional().describe('Pipeline profile (default case-study-v1)'),
+        ttlHours: z.number().int().min(1).max(24).optional().describe('Pack TTL hours (1–24)'),
+        brief: z.string().optional().describe('Optional free-text brief stored on the job'),
+        waitTimeoutSec: z
+            .number()
+            .int()
+            .min(1)
+            .max(55)
+            .optional()
+            .describe('wait: max seconds to poll (default 25, max 55)'),
+        dryRun: z.boolean().optional().describe('import: preview map without uploading'),
+        withMedia: z.boolean().optional().describe('import: also create Media wrapper entries'),
+        overrides: z
+            .array(z.object({
+            sourceName: z.string(),
+            title: z.string().optional(),
+            alt: z.string().optional(),
+            fileName: z.string().optional(),
+        }))
+            .optional()
+            .describe('import: per-sourceName title/alt/fileName overrides'),
+    }, async (params) => {
+        const ctx = buildActionContext(hosted);
+        let result;
+        switch (params.action) {
+            case 'prepare':
+                if (!params.driveFolderUrl) {
+                    result = {
+                        ok: false,
+                        error: 'driveFolderUrl is required for action=prepare',
+                        code: 'invalid_input',
+                    };
+                    break;
+                }
+                result = await mediaPrepare(ctx, {
+                    driveFolderUrl: params.driveFolderUrl,
+                    profile: params.profile,
+                    ttlHours: params.ttlHours,
+                    brief: params.brief,
+                });
+                break;
+            case 'status':
+                if (!params.jobId) {
+                    result = {
+                        ok: false,
+                        error: 'jobId is required for action=status',
+                        code: 'invalid_input',
+                    };
+                    break;
+                }
+                result = await mediaStatus(ctx, { jobId: params.jobId });
+                break;
+            case 'catalog':
+                if (!params.jobId) {
+                    result = {
+                        ok: false,
+                        error: 'jobId is required for action=catalog',
+                        code: 'invalid_input',
+                    };
+                    break;
+                }
+                result = await mediaCatalog(ctx, { jobId: params.jobId });
+                break;
+            case 'wait':
+                if (!params.jobId) {
+                    result = {
+                        ok: false,
+                        error: 'jobId is required for action=wait',
+                        code: 'invalid_input',
+                    };
+                    break;
+                }
+                result = await mediaWait(ctx, {
+                    jobId: params.jobId,
+                    waitTimeoutSec: params.waitTimeoutSec,
+                });
+                break;
+            case 'import':
+                if (!params.jobId) {
+                    result = {
+                        ok: false,
+                        error: 'jobId is required for action=import',
+                        code: 'invalid_input',
+                    };
+                    break;
+                }
+                result = await mediaImport(ctx, {
+                    jobId: params.jobId,
+                    dryRun: params.dryRun,
+                    withMedia: params.withMedia,
+                    overrides: params.overrides,
+                });
+                break;
+            default:
+                result = { ok: false, error: `Unknown action: ${String(params.action)}` };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+        };
+    });
+}
+//# sourceMappingURL=media.js.map

package/dist/mcp/tools/media.js.map

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

package/dist/media-pipeline/actions.d.ts

@@ -0,0 +1,30 @@
+import type { MediaPipelineClient } from './client.js';
+import type { MediaPipelineConfig } from './config.js';
+import type { MediaPipelineJobStore } from './job-store.js';
+export interface MediaActionContext {
+    userId: string;
+    projectKey: string;
+    config: MediaPipelineConfig | null;
+    jobStore: MediaPipelineJobStore | null;
+    client: MediaPipelineClient | null;
+}
+export type MediaActionResult = Record<string, unknown>;
+export declare function mediaPrepare(ctx: MediaActionContext, params: {
+    driveFolderUrl: string;
+    profile?: string;
+    ttlHours?: number;
+    brief?: string;
+}): Promise<MediaActionResult>;
+export declare function mediaStatus(ctx: MediaActionContext, params: {
+    jobId: string;
+}): Promise<MediaActionResult>;
+export declare function mediaCatalog(ctx: MediaActionContext, params: {
+    jobId: string;
+}): Promise<MediaActionResult>;
+export type { MediaImportOverride, MediaImportParams } from './import.js';
+export { mediaImport } from './import.js';
+export declare function mediaWait(ctx: MediaActionContext, params: {
+    jobId: string;
+    waitTimeoutSec?: number;
+}): Promise<MediaActionResult>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/media-pipeline/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/media-pipeline/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAA6B,MAAM,aAAa,CAAC;AAElF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,KAAK,EAAmB,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAU7E,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACvC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAsCxD,wBAAsB,YAAY,CAChC,GAAG,EAAE,kBAAkB,EACvB,MAAM,EAAE;IACN,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,iBAAiB,CAAC,CA0E5B;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,kBAAkB,EACvB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC,iBAAiB,CAAC,CA6B5B;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,kBAAkB,EACvB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAsD5B;AAED,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,wBAAsB,SAAS,CAC7B,GAAG,EAAE,kBAAkB,EACvB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,OAAO,CAAC,iBAAiB,CAAC,CAmD5B"}

package/dist/media-pipeline/actions.js

@@ -0,0 +1,257 @@
+import { MediaPipelineClientError } from './client.js';
+import { mediaPipelineConfiguredMessage } from './config.js';
+import { MediaJobStoreError } from './job-store.js';
+import { mediaPipelineLog } from './log.js';
+import { assertAllowedProfile, clampTtlHours, isPlausibleJobId, parseDriveFolderUrl, } from './validate.js';
+const TERMINAL = new Set(['succeeded', 'partial', 'failed']);
+function ok(data) {
+    return { ok: true, ...data };
+}
+function fail(error, code, status, extra) {
+    return { ok: false, error, ...(code ? { code } : {}), ...(status ? { status } : {}), ...extra };
+}
+function requireHosted(ctx) {
+    if (!ctx.config || !ctx.client) {
+        return fail(mediaPipelineConfiguredMessage(), 'pipeline_unconfigured', 503);
+    }
+    if (!ctx.jobStore) {
+        return fail('Media pipeline job store requires hosted Redis (same as staged uploads).', 'store_unavailable', 503);
+    }
+    if (!ctx.userId) {
+        return fail('Media pipeline actions require an authenticated cms-edit user (Contentful OAuth).', 'unauthorized', 401);
+    }
+    return null;
+}
+export async function mediaPrepare(ctx, params) {
+    const blocked = requireHosted(ctx);
+    if (blocked) {
+        return blocked;
+    }
+    const config = ctx.config;
+    const jobStore = ctx.jobStore;
+    const client = ctx.client;
+    const folder = parseDriveFolderUrl(params.driveFolderUrl);
+    if (!folder.ok) {
+        return fail(folder.error, 'invalid_input', 400);
+    }
+    const profile = params.profile?.trim() || config.defaultProfile;
+    const profileOk = assertAllowedProfile(profile, config.allowedProfiles);
+    if (!profileOk.ok) {
+        return fail(profileOk.error, 'invalid_input', 400);
+    }
+    const ttlHours = clampTtlHours(params.ttlHours, config.defaultTtlHours);
+    try {
+        await jobStore.assertPrepareRateLimit(ctx.userId, config.preparePerHour);
+        await jobStore.assertConcurrentSlot(ctx.userId, config.maxConcurrentPerUser);
+        await jobStore.reserveConcurrentSlot(ctx.userId);
+        const prepared = await client.prepare({
+            profile,
+            driveFolderUrl: folder.url,
+            ttlHours,
+            brief: params.brief,
+        });
+        const binding = {
+            jobId: prepared.jobId,
+            userId: ctx.userId,
+            projectKey: ctx.projectKey,
+            tenant: config.tenant,
+            profile,
+            folderId: folder.folderId,
+            createdAt: Date.now(),
+        };
+        await jobStore.saveBinding(binding);
+        mediaPipelineLog('media.prepare', {
+            userId: ctx.userId,
+            projectKey: ctx.projectKey,
+            tenant: config.tenant,
+            jobId: prepared.jobId,
+            folderId: folder.folderId,
+            profile,
+        });
+        return ok({
+            jobId: prepared.jobId,
+            status: prepared.status,
+            tenant: config.tenant,
+            profile,
+            createdAt: prepared.createdAt,
+            expiresAt: prepared.expiresAt,
+            pollHint: 'Call cms_edit_media action=status or wait with this jobId until succeeded|partial|failed.',
+        });
+    }
+    catch (err) {
+        // Best-effort: free concurrent slot if we reserved but failed before binding
+        try {
+            await jobStore.releaseConcurrentSlot(ctx.userId);
+        }
+        catch {
+            // ignore
+        }
+        return mapActionError(err);
+    }
+}
+export async function mediaStatus(ctx, params) {
+    const blocked = requireHosted(ctx);
+    if (blocked) {
+        return blocked;
+    }
+    const jobId = params.jobId?.trim();
+    if (!jobId || !isPlausibleJobId(jobId)) {
+        return fail('jobId is required and must be a valid media job id.', 'invalid_input', 400);
+    }
+    try {
+        await ctx.jobStore.assertOwned(jobId, ctx.userId);
+        const status = await ctx.client.status(jobId);
+        await maybeReleaseConcurrent(ctx, jobId, status);
+        mediaPipelineLog('media.status', {
+            userId: ctx.userId,
+            projectKey: ctx.projectKey,
+            jobId,
+            status: status.status,
+            assetCount: status.assets?.length ?? 0,
+            gapCount: status.gaps?.length ?? 0,
+        });
+        return ok(summarizeStatus(status));
+    }
+    catch (err) {
+        return mapActionError(err);
+    }
+}
+export async function mediaCatalog(ctx, params) {
+    const blocked = requireHosted(ctx);
+    if (blocked) {
+        return blocked;
+    }
+    const jobId = params.jobId?.trim();
+    if (!jobId || !isPlausibleJobId(jobId)) {
+        return fail('jobId is required and must be a valid media job id.', 'invalid_input', 400);
+    }
+    try {
+        await ctx.jobStore.assertOwned(jobId, ctx.userId);
+        const status = await ctx.client.status(jobId);
+        await maybeReleaseConcurrent(ctx, jobId, status);
+        mediaPipelineLog('media.catalog', {
+            userId: ctx.userId,
+            projectKey: ctx.projectKey,
+            jobId,
+            status: status.status,
+            assetCount: status.assets?.length ?? 0,
+        });
+        const assets = (status.assets ?? []).map((a) => ({
+            id: a.id,
+            sourceName: a.sourceName,
+            fileName: a.fileName,
+            mime: a.mime,
+            bytes: a.bytes,
+            width: a.width,
+            height: a.height,
+            role: a.role,
+            readyUrl: a.url,
+            previewUrl: a.previewUrl ?? null,
+            posterUrl: a.posterUrl ?? null,
+            altDraft: a.altDraft ?? null,
+            titleDraft: a.titleDraft ?? null,
+            warnings: a.warnings ?? [],
+        }));
+        return ok({
+            jobId: status.jobId,
+            status: status.status,
+            profileId: status.profileId,
+            createdAt: status.createdAt,
+            expiresAt: status.expiresAt,
+            assets,
+            gaps: status.gaps ?? [],
+            note: 'Use previewUrl/posterUrl for naming and alt text. Use readyUrl only for asset upload --url (import).',
+        });
+    }
+    catch (err) {
+        return mapActionError(err);
+    }
+}
+// re-export import for single entry
+export { mediaImport } from './import.js';
+export async function mediaWait(ctx, params) {
+    const blocked = requireHosted(ctx);
+    if (blocked) {
+        return blocked;
+    }
+    const jobId = params.jobId?.trim();
+    if (!jobId || !isPlausibleJobId(jobId)) {
+        return fail('jobId is required and must be a valid media job id.', 'invalid_input', 400);
+    }
+    const timeoutSec = Math.min(Math.max(params.waitTimeoutSec ?? 25, 1), 55);
+    const deadline = Date.now() + timeoutSec * 1000;
+    try {
+        await ctx.jobStore.assertOwned(jobId, ctx.userId);
+        let last = null;
+        while (Date.now() < deadline) {
+            last = await ctx.client.status(jobId);
+            await maybeReleaseConcurrent(ctx, jobId, last);
+            if (TERMINAL.has(String(last.status))) {
+                mediaPipelineLog('media.wait', {
+                    userId: ctx.userId,
+                    projectKey: ctx.projectKey,
+                    jobId,
+                    status: last.status,
+                    terminal: true,
+                });
+                return ok({ ...summarizeStatus(last), waited: true, terminal: true });
+            }
+            await sleep(2000);
+        }
+        mediaPipelineLog('media.wait', {
+            userId: ctx.userId,
+            projectKey: ctx.projectKey,
+            jobId,
+            status: last?.status ?? 'unknown',
+            terminal: false,
+        });
+        return ok({
+            ...(last ? summarizeStatus(last) : { jobId, status: 'unknown' }),
+            waited: true,
+            terminal: false,
+            note: 'Still running — call wait or status again.',
+        });
+    }
+    catch (err) {
+        return mapActionError(err);
+    }
+}
+function summarizeStatus(status) {
+    return {
+        jobId: status.jobId,
+        status: status.status,
+        tenant: status.tenant,
+        profileId: status.profileId,
+        createdAt: status.createdAt,
+        expiresAt: status.expiresAt,
+        assetCount: status.assets?.length ?? 0,
+        gapCount: status.gaps?.length ?? 0,
+        gaps: status.gaps ?? [],
+        error: status.error,
+    };
+}
+async function maybeReleaseConcurrent(ctx, jobId, status) {
+    if (!TERMINAL.has(String(status.status))) {
+        return;
+    }
+    try {
+        await ctx.jobStore.markConcurrentReleased(jobId, ctx.userId);
+    }
+    catch {
+        // ignore
+    }
+}
+function mapActionError(err) {
+    if (err instanceof MediaJobStoreError) {
+        return fail(err.message, err.code, err.status);
+    }
+    if (err instanceof MediaPipelineClientError) {
+        return fail(err.message, err.code, err.status);
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return fail(message, 'error', 500);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=actions.js.map

package/dist/media-pipeline/actions.js.map

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

package/dist/media-pipeline/client.d.ts

@@ -0,0 +1,67 @@
+import type { MediaPipelineConfig } from './config.js';
+export type PipelineJobStatus = 'queued' | 'running' | 'succeeded' | 'partial' | 'failed' | string;
+export interface PipelineManifestAsset {
+    id: string;
+    sourceName: string;
+    fileName: string;
+    mime: string;
+    bytes: number;
+    width?: number;
+    height?: number;
+    role?: string;
+    url: string;
+    previewUrl?: string;
+    posterUrl?: string;
+    altDraft?: string;
+    titleDraft?: string;
+    warnings?: string[];
+}
+export interface PipelineManifestGap {
+    sourceName: string;
+    reason: string;
+    detail: string;
+}
+export interface PipelineJobStatusResponse {
+    jobId: string;
+    tenant: string;
+    status: PipelineJobStatus;
+    runId?: string;
+    createdAt: string;
+    expiresAt: string;
+    assets?: PipelineManifestAsset[];
+    gaps?: PipelineManifestGap[];
+    profileId?: string;
+    error?: string;
+    manifestUrl?: string;
+    reportUrl?: string;
+    statusUrl?: string;
+}
+export interface PipelinePrepareResponse {
+    jobId: string;
+    runId?: string;
+    status: PipelineJobStatus;
+    tenant: string;
+    createdAt: string;
+    expiresAt: string;
+    statusUrl?: string;
+    poll?: string;
+    error?: string;
+}
+export declare class MediaPipelineClientError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    constructor(message: string, status: number, code?: string | undefined);
+}
+export declare class MediaPipelineClient {
+    private readonly config;
+    constructor(config: MediaPipelineConfig);
+    private headers;
+    prepare(params: {
+        profile: string;
+        driveFolderUrl: string;
+        ttlHours: number;
+        brief?: string;
+    }): Promise<PipelinePrepareResponse>;
+    status(jobId: string): Promise<PipelineJobStatusResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/media-pipeline/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/media-pipeline/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnG,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IAG/C,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;gBAFtB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,YAAA;CAKzB;AAED,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,mBAAmB;IAExD,OAAO,CAAC,OAAO;IAQT,OAAO,CAAC,MAAM,EAAE;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA6B9B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAmBhE"}

package/dist/media-pipeline/client.js

@@ -0,0 +1,75 @@
+export class MediaPipelineClientError extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'MediaPipelineClientError';
+    }
+}
+export class MediaPipelineClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    headers() {
+        return {
+            Authorization: `Bearer ${this.config.serviceKey}`,
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        };
+    }
+    async prepare(params) {
+        const res = await fetch(`${this.config.baseUrl}/api/v1/jobs`, {
+            method: 'POST',
+            headers: this.headers(),
+            body: JSON.stringify({
+                tenant: this.config.tenant,
+                profile: params.profile,
+                source: {
+                    type: 'google_drive_folder',
+                    url: params.driveFolderUrl,
+                },
+                options: {
+                    ttlHours: params.ttlHours,
+                    ...(params.brief ? { brief: params.brief } : {}),
+                },
+            }),
+        });
+        const body = (await res.json().catch(() => ({})));
+        if (!res.ok) {
+            throw mapPipelineHttpError(res.status, body.error ?? res.statusText);
+        }
+        return body;
+    }
+    async status(jobId) {
+        const url = new URL(`${this.config.baseUrl}/api/v1/jobs/${encodeURIComponent(jobId)}`);
+        url.searchParams.set('tenant', this.config.tenant);
+        const res = await fetch(url.toString(), {
+            method: 'GET',
+            headers: this.headers(),
+        });
+        const body = (await res.json().catch(() => ({})));
+        if (!res.ok) {
+            throw mapPipelineHttpError(res.status, body.error ?? res.statusText);
+        }
+        return body;
+    }
+}
+function mapPipelineHttpError(status, detail) {
+    if (status === 401 || status === 403) {
+        return new MediaPipelineClientError('Media pipeline rejected the host service credentials (host misconfiguration). Contact ops — do not ask the user for a pipeline API key.', status, 'pipeline_auth');
+    }
+    if (status === 404) {
+        return new MediaPipelineClientError(detail || 'Media pipeline job not found.', status, 'not_found');
+    }
+    if (status === 429) {
+        return new MediaPipelineClientError(detail || 'Media pipeline rate limited the host.', status, 'rate_limited');
+    }
+    if (status >= 500) {
+        return new MediaPipelineClientError(detail || 'Media pipeline is unavailable.', status, 'pipeline_unavailable');
+    }
+    return new MediaPipelineClientError(detail || `Media pipeline error (${String(status)})`, status);
+}
+//# sourceMappingURL=client.js.map

package/dist/media-pipeline/client.js.map

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

package/dist/media-pipeline/config.d.ts

@@ -0,0 +1,17 @@
+export interface MediaPipelineConfig {
+    baseUrl: string;
+    serviceKey: string;
+    tenant: string;
+    defaultProfile: string;
+    allowedProfiles: string[];
+    preparePerHour: number;
+    maxConcurrentPerUser: number;
+    defaultTtlHours: number;
+}
+/**
+ * Load media-pipeline facade config from process env.
+ * Returns null when the host is not configured (do not ask agents for keys).
+ */
+export declare function loadMediaPipelineConfig(envSource?: NodeJS.ProcessEnv): MediaPipelineConfig | null;
+export declare function mediaPipelineConfiguredMessage(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/media-pipeline/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/media-pipeline/config.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;CACzB;AAyBD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,GAAE,MAAM,CAAC,UAAwB,GACzC,mBAAmB,GAAG,IAAI,CAgC5B;AAED,wBAAgB,8BAA8B,IAAI,MAAM,CAMvD"}