@collage-dam/mcp-server 0.1.0

package/dist/tools/create-folder.js

@@ -0,0 +1,83 @@
+// ── create_folder ────────────────────────────────────────────────────
+// Creates one new folder, optionally under a parent. Wraps the dry-run
+// framework so the call is plan → preview → execute.
+//
+// Upstream surface (different paths for top-level vs sub-folder, same body
+// shape modulo `category_id`):
+//   POST digital-assets/category/add               { workspace_id, folder_name }
+//   POST digital-assets/category/add-sub-category  { workspace_id, folder_name, category_id }
+//
+// MVP scope: one folder per call. Bulk create is Phase 1.5 if needed.
+import { z } from 'zod';
+import { MutatingTool, } from '../conventions/dry-run/index.js';
+import { createToolError } from '../conventions/errors.js';
+import { IdSchema } from '../types.js';
+export const CreateFolderInputSchema = z.object({
+    folder_name: z.string().min(1).max(255),
+    parent_id: IdSchema.nullable().optional(),
+});
+export const CREATE_FOLDER_DESCRIPTION = 'Create a new folder (category) in the workspace. Pass `parent_id` to ' +
+    'create a sub-folder, omit it to create a top-level folder. Two-step: ' +
+    'first call returns a preview plus a confirmation_token; second call ' +
+    '(with the token) executes the create and returns the new folder id.';
+export class CreateFolderTool extends MutatingTool {
+    name = 'create_folder';
+    chunkSize = 1;
+    client;
+    constructor(deps) {
+        super(deps);
+        this.client = deps.client;
+    }
+    plan(input) {
+        const parentId = input.parent_id ?? null;
+        const after = {
+            folder_name: input.folder_name,
+            parent_id: parentId === null ? null : String(parentId),
+        };
+        const change = {
+            id: 'new-folder',
+            operation: 'create',
+            before: null,
+            after,
+            metadata: {
+                folder_name: input.folder_name,
+                parent_id: parentId === null ? null : String(parentId),
+            },
+        };
+        const riskFlags = [];
+        if (input.folder_name.length > 100) {
+            riskFlags.push({
+                code: 'long_folder_name',
+                severity: 'warning',
+                message: 'folder name exceeds 100 characters',
+                count: 1,
+            });
+        }
+        return { changes: [change], riskFlags };
+    }
+    apply = async (change) => {
+        const meta = (change.metadata ?? {});
+        if (typeof meta.folder_name !== 'string' || meta.folder_name.length === 0) {
+            return {
+                ok: false,
+                error: createToolError('VALIDATION', `change ${change.id} missing folder_name`),
+            };
+        }
+        const result = await this.client.createFolder({
+            folder_name: meta.folder_name,
+            parent_id: meta.parent_id ?? null,
+        });
+        if (!result.ok) {
+            return { ok: false, error: result.error };
+        }
+        return {
+            ok: true,
+            result: {
+                folder_id: result.folder_id,
+                folder_name: meta.folder_name,
+                parent_id: meta.parent_id ?? null,
+            },
+        };
+    };
+}
+//# sourceMappingURL=create-folder.js.map

package/dist/tools/create-folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-folder.js","sourceRoot":"","sources":["../../src/tools/create-folder.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,uEAAuE;AACvE,qDAAqD;AACrD,EAAE;AACF,2EAA2E;AAC3E,+BAA+B;AAC/B,iFAAiF;AACjF,8FAA8F;AAC9F,EAAE;AACF,sEAAsE;AAEtE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,YAAY,GAKb,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAqB,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACvC,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,yBAAyB,GACpC,uEAAuE;IACvE,uEAAuE;IACvE,sEAAsE;IACtE,qEAAqE,CAAC;AAsBxE,MAAM,OAAO,gBAAiB,SAAQ,YAGrC;IACU,IAAI,GAAG,eAAe,CAAC;IACJ,SAAS,GAAG,CAAC,CAAC;IAEzB,MAAM,CAAqB;IAE5C,YAAY,IAAsB;QAChC,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5B,CAAC;IAES,IAAI,CAAC,KAAwB;QACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC;QACzC,MAAM,KAAK,GAA4B;YACrC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;SACvD,CAAC;QAEF,MAAM,MAAM,GAAiB;YAC3B,EAAE,EAAE,YAAY;YAChB,SAAS,EAAE,QAAQ;YACnB,MAAM,EAAE,IAAI;YACZ,KAAK;YACL,QAAQ,EAAE;gBACR,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,SAAS,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;aACvD;SACF,CAAC;QAEF,MAAM,SAAS,GAAe,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACnC,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,kBAAkB;gBACxB,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,oCAAoC;gBAC7C,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IAC1C,CAAC;IAES,KAAK,GAAoC,KAAK,EAAE,MAAM,EAAE,EAAE;QAClE,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAGlC,CAAC;QACF,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1E,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,eAAe,CACpB,YAAY,EACZ,UAAU,MAAM,CAAC,EAAE,sBAAsB,CAC1C;aACF,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;YAC5C,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;SAClC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM,EAAE;gBACN,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;aAClC;SACF,CAAC;IACJ,CAAC,CAAC;CACH"}

package/dist/tools/create-share-link.d.ts

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { MutatingTool, type ApplyFn, type MutatingToolDeps, type PlanResult } from '../conventions/dry-run/index.js';
+import type { DryRunPlan } from '../conventions/dry-run/index.js';
+import { type McpToolError } from '../conventions/errors.js';
+export declare const CreateShareLinkInputSchema: z.ZodEffects<z.ZodObject<{
+    /** Target a single collection — its full asset roster is shared. */
+    collection_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    /** Target an explicit list of assets (≤50). */
+    asset_ids: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">>;
+    /** Optional human-readable title for the share. */
+    title: z.ZodOptional<z.ZodString>;
+    /** Optional description shown on the share landing page. */
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Expiration in ISO 8601 datetime. Sent to upstream as 'MMM D, YYYY'. */
+    expiration: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Optional password gate. */
+    password: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** When true, viewers cannot download the asset(s). Defaults to false. */
+    hide_download: z.ZodOptional<z.ZodBoolean>;
+    /** When true, surface that the workspace watermark setting will apply. */
+    watermark: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    description?: string | null | undefined;
+    title?: string | undefined;
+    expiration?: string | null | undefined;
+    password?: string | null | undefined;
+    hide_download?: boolean | undefined;
+    asset_ids?: (string | number)[] | undefined;
+    collection_id?: string | number | undefined;
+    watermark?: boolean | undefined;
+}, {
+    description?: string | null | undefined;
+    title?: string | undefined;
+    expiration?: string | null | undefined;
+    password?: string | null | undefined;
+    hide_download?: boolean | undefined;
+    asset_ids?: (string | number)[] | undefined;
+    collection_id?: string | number | undefined;
+    watermark?: boolean | undefined;
+}>, {
+    description?: string | null | undefined;
+    title?: string | undefined;
+    expiration?: string | null | undefined;
+    password?: string | null | undefined;
+    hide_download?: boolean | undefined;
+    asset_ids?: (string | number)[] | undefined;
+    collection_id?: string | number | undefined;
+    watermark?: boolean | undefined;
+}, {
+    description?: string | null | undefined;
+    title?: string | undefined;
+    expiration?: string | null | undefined;
+    password?: string | null | undefined;
+    hide_download?: boolean | undefined;
+    asset_ids?: (string | number)[] | undefined;
+    collection_id?: string | number | undefined;
+    watermark?: boolean | undefined;
+}>;
+export type CreateShareLinkInput = z.infer<typeof CreateShareLinkInputSchema>;
+export declare const CREATE_SHARE_LINK_DESCRIPTION: string;
+export interface CreateShareLinkItemResult {
+    share_id: string;
+    share_url: string;
+    target_kind: 'collection' | 'assets';
+}
+export interface CreateShareLinkRequest {
+    target_kind: 'collection' | 'assets';
+    collection_id?: string;
+    asset_ids: string[];
+    title: string;
+    description: string | null;
+    password: string | null;
+    hide_download: 0 | 1;
+    expiration: string | null;
+}
+export interface CreateShareLinkClient {
+    createShareLink(request: CreateShareLinkRequest): Promise<{
+        ok: true;
+        share_id: string;
+        share_url: string;
+    } | {
+        ok: false;
+        error: McpToolError;
+    }>;
+}
+export interface CreateShareLinkDeps extends MutatingToolDeps<CreateShareLinkInput> {
+    client: CreateShareLinkClient;
+}
+export declare class CreateShareLinkTool extends MutatingTool<CreateShareLinkInput, CreateShareLinkItemResult> {
+    readonly name = "create_share_link";
+    protected readonly chunkSize = 1;
+    private readonly client;
+    constructor(deps: CreateShareLinkDeps);
+    protected plan(input: CreateShareLinkInput): PlanResult;
+    protected apply: ApplyFn<CreateShareLinkItemResult>;
+}
+export declare function buildCreateShareLinkTool(deps: CreateShareLinkDeps): CreateShareLinkTool;
+export type CreateShareLinkPlan = DryRunPlan<CreateShareLinkInput>;
+/**
+ * Convert an ISO 8601 datetime to the `'MMM D, YYYY'` format expected by
+ * the Collage `generate-share-assets-url` endpoint. Mirrors the
+ * Admin-Frontend's `moment(...).format('MMM D, YYYY')` call. Returns the
+ * original string unchanged if parsing fails — the upstream will surface
+ * any validation error as UPSTREAM in that case.
+ */
+export declare function formatExpirationForUpstream(iso: string): string;
+//# sourceMappingURL=create-share-link.d.ts.map

package/dist/tools/create-share-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-share-link.d.ts","sourceRoot":"","sources":["../../src/tools/create-share-link.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAEhB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK9E,eAAO,MAAM,0BAA0B;IAEnC,oEAAoE;;IAEpE,+CAA+C;;IAE/C,mDAAmD;;IAEnD,4DAA4D;;IAE5D,0EAA0E;;IAE1E,8BAA8B;;IAE9B,0EAA0E;;IAE1E,0EAA0E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe3E,CAAC;AACJ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,6BAA6B,QAMN,CAAC;AAIrC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,YAAY,GAAG,QAAQ,CAAC;CACtC;AAID,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,YAAY,GAAG,QAAQ,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,CACb,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CACN;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GACjD;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CACrC,CAAC;CACH;AAID,MAAM,WAAW,mBACf,SAAQ,gBAAgB,CAAC,oBAAoB,CAAC;IAC9C,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED,qBAAa,mBAAoB,SAAQ,YAAY,CACnD,oBAAoB,EACpB,yBAAyB,CAC1B;IACC,QAAQ,CAAC,IAAI,uBAAuB;IACpC,mBAA4B,SAAS,KAAK;IAE1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAEnC,IAAI,EAAE,mBAAmB;IAKrC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,oBAAoB,GAAG,UAAU;IA6FvD,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAkEjD;CACH;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,mBAAmB,GACxB,mBAAmB,CAErB;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAgCnE;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO/D"}

package/dist/tools/create-share-link.js

@@ -0,0 +1,239 @@
+// ── create_share_link ────────────────────────────────────────────────
+// Generates a single governed share link for a Collage collection or an
+// explicit asset list (≤50). Wraps the dry-run framework so every call is
+// plan → preview → execute.
+//
+// Upstream surface (verified via Admin-Frontend `ShareAssetDialog/index.vue`):
+//   POST digital-assets/dashboard/generate-share-assets-url
+//     body: { workspace_id, assets, category, title?, description?,
+//             password?, hide_download?: 0|1, expiration?: 'MMM D, YYYY' }
+//   POST digital-assets/collection/generate-share-url
+//     body: { workspace_id, id (collection_id), assets, ... }
+//
+// The asset-list cap (50) mirrors the existing collection-membership tools.
+// `expiration` is provided by the caller as ISO datetime; we format it as
+// `'MMM D, YYYY'` to match what the Admin-Frontend sends. Watermarking is
+// a workspace-level setting on Collage and isn't a per-share toggle on the
+// generate endpoints, so we surface a `watermark` flag in the preview as
+// an info-only acknowledgment that the workspace setting will apply (no
+// request body parameter exists today — recorded as a Phase 1 limitation).
+import { z } from 'zod';
+import { MutatingTool, } from '../conventions/dry-run/index.js';
+import { createToolError } from '../conventions/errors.js';
+import { IdSchema } from '../types.js';
+// ── Tool I/O Schema ──────────────────────────────────────────────────
+export const CreateShareLinkInputSchema = z
+    .object({
+    /** Target a single collection — its full asset roster is shared. */
+    collection_id: IdSchema.optional(),
+    /** Target an explicit list of assets (≤50). */
+    asset_ids: z.array(IdSchema).min(1).max(50).optional(),
+    /** Optional human-readable title for the share. */
+    title: z.string().max(255).optional(),
+    /** Optional description shown on the share landing page. */
+    description: z.string().max(10_000).nullable().optional(),
+    /** Expiration in ISO 8601 datetime. Sent to upstream as 'MMM D, YYYY'. */
+    expiration: z.string().datetime({ offset: true }).nullable().optional(),
+    /** Optional password gate. */
+    password: z.string().min(1).max(255).nullable().optional(),
+    /** When true, viewers cannot download the asset(s). Defaults to false. */
+    hide_download: z.boolean().optional(),
+    /** When true, surface that the workspace watermark setting will apply. */
+    watermark: z.boolean().optional(),
+})
+    .refine((input) => {
+    const present = [
+        input.collection_id !== undefined,
+        input.asset_ids !== undefined && input.asset_ids.length > 0,
+    ].filter(Boolean).length;
+    return present === 1;
+}, {
+    message: 'Provide exactly one of `collection_id` or `asset_ids` (1-50 IDs).',
+});
+export const CREATE_SHARE_LINK_DESCRIPTION = 'Create a governed share link for a Collage collection or an explicit ' +
+    'asset list (1-50 IDs). Supports optional title/description, ISO ' +
+    'expiration, password protection, hide_download, and a watermark ' +
+    'acknowledgment flag. Two-step: first call returns a preview plus a ' +
+    'confirmation_token; second call (with the token) executes and returns ' +
+    'the final share URL plus its id.';
+export class CreateShareLinkTool extends MutatingTool {
+    name = 'create_share_link';
+    chunkSize = 1;
+    client;
+    constructor(deps) {
+        super(deps);
+        this.client = deps.client;
+    }
+    plan(input) {
+        const targetKind = input.collection_id !== undefined ? 'collection' : 'assets';
+        const assetIds = dedupeIds(input.asset_ids ?? []);
+        const collectionId = input.collection_id !== undefined ? String(input.collection_id) : null;
+        const expirationIso = input.expiration ?? null;
+        const expirationFormatted = expirationIso !== null ? formatExpirationForUpstream(expirationIso) : null;
+        const passwordEnabled = typeof input.password === 'string' && input.password.length > 0;
+        const hideDownload = input.hide_download === true;
+        const watermark = input.watermark === true;
+        const after = {
+            target_kind: targetKind,
+            collection_id: collectionId,
+            asset_ids: assetIds,
+            title: input.title ?? '',
+            description: input.description ?? null,
+            expiration_iso: expirationIso,
+            expiration_formatted: expirationFormatted,
+            password_protected: passwordEnabled,
+            hide_download: hideDownload,
+            watermark_acknowledged: watermark,
+        };
+        const change = {
+            id: 'new-share-link',
+            operation: 'create',
+            before: null,
+            after,
+            metadata: {
+                target_kind: targetKind,
+                ...(collectionId !== null ? { collection_id: collectionId } : {}),
+                asset_ids: assetIds,
+                title: input.title ?? '',
+                description: input.description ?? null,
+                password: passwordEnabled ? input.password : null,
+                hide_download: hideDownload ? 1 : 0,
+                expiration: expirationFormatted,
+            },
+        };
+        const riskFlags = [];
+        if (assetIds.length === 50) {
+            riskFlags.push({
+                code: 'asset_list_cap',
+                severity: 'info',
+                message: 'Asset list is at the 50-id cap — split into multiple share links if you need a larger surface.',
+                count: assetIds.length,
+            });
+        }
+        if (input.asset_ids !== undefined &&
+            input.asset_ids.length !== assetIds.length) {
+            riskFlags.push({
+                code: 'duplicate_asset_ids',
+                severity: 'info',
+                message: 'duplicate IDs in asset list were collapsed',
+                count: input.asset_ids.length - assetIds.length,
+            });
+        }
+        if (passwordEnabled === false && hideDownload === false) {
+            riskFlags.push({
+                code: 'public_link',
+                severity: 'info',
+                message: 'Share link will be public (no password, downloads allowed). Anyone with the URL can view and download.',
+                count: 1,
+            });
+        }
+        if (watermark) {
+            riskFlags.push({
+                code: 'watermark_workspace_setting',
+                severity: 'info',
+                message: 'Watermarking is a workspace-level setting on Collage; this flag is recorded for transparency but is not sent on the request body.',
+                count: 1,
+            });
+        }
+        const extraAggregates = {
+            target_assets: assetIds.length,
+            password_protected: passwordEnabled ? 1 : 0,
+            download_blocked: hideDownload ? 1 : 0,
+        };
+        return { changes: [change], riskFlags, extraAggregates };
+    }
+    apply = async (change) => {
+        const meta = (change.metadata ?? {});
+        const targetKind = meta.target_kind;
+        if (targetKind !== 'collection' && targetKind !== 'assets') {
+            return {
+                ok: false,
+                error: createToolError('VALIDATION', `change ${change.id} missing target_kind`),
+            };
+        }
+        if (targetKind === 'collection' && (meta.collection_id ?? '') === '') {
+            return {
+                ok: false,
+                error: createToolError('VALIDATION', `change ${change.id} missing collection_id for collection share`),
+            };
+        }
+        const assetIds = meta.asset_ids ?? [];
+        if (targetKind === 'assets' && assetIds.length === 0) {
+            return {
+                ok: false,
+                error: createToolError('VALIDATION', `change ${change.id} missing asset_ids for asset share`),
+            };
+        }
+        const request = {
+            target_kind: targetKind,
+            asset_ids: assetIds,
+            title: meta.title ?? '',
+            description: meta.description ?? null,
+            password: meta.password ?? null,
+            hide_download: meta.hide_download === 1 ? 1 : 0,
+            expiration: meta.expiration ?? null,
+        };
+        if (targetKind === 'collection' && meta.collection_id !== undefined) {
+            request.collection_id = meta.collection_id;
+        }
+        const result = await this.client.createShareLink(request);
+        if (!result.ok) {
+            return { ok: false, error: result.error };
+        }
+        return {
+            ok: true,
+            result: {
+                share_id: result.share_id,
+                share_url: result.share_url,
+                target_kind: targetKind,
+            },
+        };
+    };
+}
+export function buildCreateShareLinkTool(deps) {
+    return new CreateShareLinkTool(deps);
+}
+// ── Helpers ──────────────────────────────────────────────────────────
+function dedupeIds(ids) {
+    const seen = new Set();
+    const out = [];
+    for (const raw of ids) {
+        const id = String(raw);
+        if (!seen.has(id)) {
+            seen.add(id);
+            out.push(id);
+        }
+    }
+    return out;
+}
+const MONTHS = [
+    'Jan',
+    'Feb',
+    'Mar',
+    'Apr',
+    'May',
+    'Jun',
+    'Jul',
+    'Aug',
+    'Sep',
+    'Oct',
+    'Nov',
+    'Dec',
+];
+/**
+ * Convert an ISO 8601 datetime to the `'MMM D, YYYY'` format expected by
+ * the Collage `generate-share-assets-url` endpoint. Mirrors the
+ * Admin-Frontend's `moment(...).format('MMM D, YYYY')` call. Returns the
+ * original string unchanged if parsing fails — the upstream will surface
+ * any validation error as UPSTREAM in that case.
+ */
+export function formatExpirationForUpstream(iso) {
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return iso;
+    const month = MONTHS[d.getUTCMonth()];
+    const day = d.getUTCDate();
+    const year = d.getUTCFullYear();
+    return `${month} ${day}, ${year}`;
+}
+//# sourceMappingURL=create-share-link.js.map

package/dist/tools/create-share-link.js.map

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