@fluid-app/fluid-cli-assets 0.1.11 → 0.1.12

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @fluid-app/fluid-cli-assets@0.1.11 build /home/runner/_work/fluid-mono/fluid-mono/packages/cli/assets
+> @fluid-app/fluid-cli-assets@0.1.12 build /home/runner/_work/fluid-mono/fluid-mono/packages/cli/assets
 > tsdown
 
 ℹ tsdown v0.21.0 powered by rolldown v1.0.0-rc.7
@@ -8,9 +8,11 @@
 ℹ target: node24
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/index.mjs         8.76 kB │ gzip: 1.28 kB
-ℹ dist/index.mjs.map    17.08 kB │ gzip: 2.44 kB
+ℹ dist/index.mjs        12.11 kB │ gzip: 2.54 kB
+ℹ dist/index.mjs.map    26.57 kB │ gzip: 5.83 kB
 ℹ dist/index.d.mts.map   0.11 kB │ gzip: 0.12 kB
 ℹ dist/index.d.mts       0.19 kB │ gzip: 0.16 kB
-ℹ 4 files, total: 26.15 kB
-✔ Build complete in 2685ms
+ℹ 4 files, total: 38.99 kB
+✔ Build complete in 5682ms
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugin `rolldown-plugin-dts:generate`. See https://rolldown.rs/options/checks#plugintimings for more details.
+

package/.turbo/turbo-typecheck.log

@@ -1,4 +1,4 @@
 
-> @fluid-app/fluid-cli-assets@0.1.11 typecheck /home/runner/_work/fluid-mono/fluid-mono/packages/cli/assets
+> @fluid-app/fluid-cli-assets@0.1.12 typecheck /home/runner/_work/fluid-mono/fluid-mono/packages/cli/assets
 > tsgo --noEmit
 

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;cAKM,MAAA,EAAQ,WAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;cAMM,MAAA,EAAQ,WAAA"}

package/dist/index.mjs

@@ -1,5 +1,67 @@
-import { createDomainCommand } from "@fluid-app/fluid-cli";
+import { createDomainCommand, findProjectConfig, getAuthToken } from "@fluid-app/fluid-cli";
 import "commander";
+import { readFile, stat } from "node:fs/promises";
+import { basename } from "node:path";
+//#region src/commands/upload.ts
+const UPLOAD_BASE = (process.env["FLUID_UPLOAD_BASE"] ?? "https://upload.fluid.app").replace(/\/$/, "");
+function registerUpload(parent, ctx) {
+	parent.command("upload [file]").description("Upload a file or URL to the Fluid DAM (via upload.fluid.app)").option("--url <url>", "Fetch from an external URL instead of attaching a local file").option("--name <name>", "Display name for the DAM asset").option("--description <description>", "Asset description").option("--tags <tags>", "Comma-separated tags").option("--folder <folder>", "ImageKit folder override").option("--no-unique-filename", "Disable ImageKit's useUniqueFileName (default: enabled)").option("--create-media", "Also create a Fluid Media resource (active, share, publish-now)").action(async function(filePath, opts) {
+		const token = resolveToken(this.parent?.opts() ?? {});
+		if (!token) throw new Error("No API token found. Run `fluid login` or provide --token <token>.");
+		if (!filePath && !opts.url) throw new Error("Provide a file path or --url <url>. Run `fluid dam upload --help` for usage.");
+		if (filePath && opts.url) throw new Error("Provide either a file path OR --url, not both.");
+		const form = new FormData();
+		if (opts.folder) form.append("folder", opts.folder);
+		if (opts.uniqueFilename === false) form.append("useUniqueFileName", "false");
+		if (opts.url) form.append("external_asset_url", opts.url);
+		else if (filePath) {
+			await stat(filePath);
+			const bytes = await readFile(filePath);
+			const name = basename(filePath);
+			form.append("fileName", name);
+			form.append("file", new Blob([bytes]), name);
+		}
+		if (opts.name) form.append("name", opts.name);
+		if (opts.description) form.append("description", opts.description);
+		if (opts.tags) form.append("tags", opts.tags);
+		if (opts.createMedia) form.append("create_media", "true");
+		if (ctx.verbose) process.stderr.write(`POST ${UPLOAD_BASE}/upload\n`);
+		const resp = await fetch(`${UPLOAD_BASE}/upload`, {
+			method: "POST",
+			headers: { Authorization: `Bearer ${token}` },
+			body: form
+		});
+		if (!resp.ok) {
+			let detail = "";
+			try {
+				detail = await resp.text();
+			} catch {}
+			throw new Error(`Upload failed (HTTP ${resp.status})${detail ? `: ${detail.slice(0, 400)}` : ""}`);
+		}
+		const body = await resp.json();
+		ctx.output(body);
+	});
+}
+/**
+* Token resolution mirrors `createCommandContext.resolveToken` from
+* @fluid-app/fluid-cli: explicit flag → --profile lookup → env vars
+* → project-local `.fluidrc` → global active profile. Re-implemented
+* here instead of imported because the helper isn't exported, and
+* the duplication is tiny.
+*/
+function resolveToken(opts) {
+	if (opts.token) return opts.token;
+	if (opts.profile) return getAuthToken(opts.profile);
+	const envToken = process.env["FLUID_TOKEN"] ?? process.env["FLUID_API_TOKEN"];
+	if (envToken) return envToken;
+	const projectConfig = findProjectConfig(process.cwd());
+	if (projectConfig?.profile) {
+		const rcToken = getAuthToken(projectConfig.profile);
+		if (rcToken) return rcToken;
+	}
+	return getAuthToken();
+}
+//#endregion
 //#region src/generated/primary.ts
 function registerPrimary(parent, ctx) {
 	parent.command("get-asset-paths <code>").description("Lists asset paths for an existing asset").action(async (code) => {
@@ -164,7 +226,12 @@ const plugin = {
 	name: "@fluid-app/fluid-cli-assets",
 	version: "0.1.0",
 	register(ctx) {
-		ctx.program.addCommand(createDomainCommand("assets", "Manage Fluid digital assets (DAM)", registerAllCommands));
+		const assets = createDomainCommand("assets", "Manage Fluid digital assets (DAM)", (parent, cmdCtx) => {
+			registerAllCommands(parent, cmdCtx);
+			registerUpload(parent, cmdCtx);
+		});
+		assets.alias("dam");
+		ctx.program.addCommand(assets);
 	}
 };
 //#endregion

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/generated/primary.ts","../src/generated/index.ts","../src/index.ts"],"sourcesContent":["// primary.ts — AUTO-GENERATED, DO NOT EDIT\nimport { Command } from \"commander\";\nimport type { CommandContext } from \"@fluid-app/fluid-cli\";\n\nexport function registerPrimary(parent: Command, ctx: CommandContext): void {\n  parent\n    .command(\"get-asset-paths <code>\")\n    .description(\"Lists asset paths for an existing asset\")\n    .action(async (code) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\n          \"GET \" + `/api/dam/assets/${code}/asset_paths` + \"\\n\",\n        );\n      const result = await client.get(`/api/dam/assets/${code}/asset_paths`);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"create-asset-paths <code>\")\n    .description(\"Creates asset paths for an existing asset\")\n    .option(\"--body <json>\", \"Request body as JSON string\")\n    .option(\"--body-file <path>\", \"Read request body from file\")\n    .action(async (code, opts) => {\n      const client = await ctx.getClient();\n      let body: unknown;\n      if (opts.bodyFile) {\n        const { readFileSync } = await import(\"fs\");\n        body = ctx.parseBody(readFileSync(opts.bodyFile, \"utf-8\"));\n      } else if (opts.body) {\n        body = ctx.parseBody(opts.body);\n      }\n      if (ctx.verbose)\n        process.stderr.write(\n          \"POST \" + `/api/dam/assets/${code}/asset_paths` + \"\\n\",\n        );\n      const result = await client.post(\n        `/api/dam/assets/${code}/asset_paths`,\n        body,\n      );\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"delete-asset-path <code> <id>\")\n    .description(\"Destroys an asset path\")\n    .action(async (code, id) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\n          \"DELETE \" + `/api/dam/assets/${code}/asset_paths/${id}` + \"\\n\",\n        );\n      const result = await client.delete(\n        `/api/dam/assets/${code}/asset_paths/${id}`,\n      );\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"create-backfill-imagekit\")\n    .description(\"Creates a DAM asset from ImageKit upload metadata\")\n    .option(\"--body <json>\", \"Request body as JSON string\")\n    .option(\"--body-file <path>\", \"Read request body from file\")\n    .action(async (opts) => {\n      const client = await ctx.getClient();\n      let body: unknown;\n      if (opts.bodyFile) {\n        const { readFileSync } = await import(\"fs\");\n        body = ctx.parseBody(readFileSync(opts.bodyFile, \"utf-8\"));\n      } else if (opts.body) {\n        body = ctx.parseBody(opts.body);\n      }\n      if (ctx.verbose)\n        process.stderr.write(\n          \"POST \" + `/api/dam/assets/backfill_imagekit` + \"\\n\",\n        );\n      const result = await client.post(\n        `/api/dam/assets/backfill_imagekit`,\n        body,\n      );\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"create-asset-invalid-mixed-payload\")\n    .description(\"Errors when multiple asset types are provided\")\n    .option(\"--body <json>\", \"Request body as JSON string\")\n    .option(\"--body-file <path>\", \"Read request body from file\")\n    .action(async (opts) => {\n      const client = await ctx.getClient();\n      let body: unknown;\n      if (opts.bodyFile) {\n        const { readFileSync } = await import(\"fs\");\n        body = ctx.parseBody(readFileSync(opts.bodyFile, \"utf-8\"));\n      } else if (opts.body) {\n        body = ctx.parseBody(opts.body);\n      }\n      if (ctx.verbose) process.stderr.write(\"POST \" + `/api/dam/assets` + \"\\n\");\n      const result = await client.post(`/api/dam/assets`, body);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"get-asset <code>\")\n    .description(\"Retrieves an asset by code\")\n    .action(async (code) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\"GET \" + `/api/dam/assets/${code}` + \"\\n\");\n      const result = await client.get(`/api/dam/assets/${code}`);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"update-asset <code>\")\n    .description(\"Updates an existing asset\")\n    .option(\"--body <json>\", \"Request body as JSON string\")\n    .option(\"--body-file <path>\", \"Read request body from file\")\n    .action(async (code, opts) => {\n      const client = await ctx.getClient();\n      let body: unknown;\n      if (opts.bodyFile) {\n        const { readFileSync } = await import(\"fs\");\n        body = ctx.parseBody(readFileSync(opts.bodyFile, \"utf-8\"));\n      } else if (opts.body) {\n        body = ctx.parseBody(opts.body);\n      }\n      if (ctx.verbose)\n        process.stderr.write(\"PUT \" + `/api/dam/assets/${code}` + \"\\n\");\n      const result = await client.put(`/api/dam/assets/${code}`, body);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"delete-asset <code>\")\n    .description(\"Deletes an asset\")\n    .action(async (code) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\"DELETE \" + `/api/dam/assets/${code}` + \"\\n\");\n      const result = await client.delete(`/api/dam/assets/${code}`);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"discard-asset <code>\")\n    .description(\"Discard an asset (soft delete)\")\n    .action(async (code) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\n          \"PATCH \" + `/api/dam/assets/${code}/discard` + \"\\n\",\n        );\n      const result = await client.patch(`/api/dam/assets/${code}/discard`);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"create-imagekit-auth\")\n    .description(\n      \"Creates ImageKit authentication credentials for large file uploads\",\n    )\n    .action(async () => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\"POST \" + `/api/dam/assets/imagekit_auth` + \"\\n\");\n      const result = await client.post(`/api/dam/assets/imagekit_auth`);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"query-assets\")\n    .description(\"Query DAM assets using tree paths and tags\")\n    .option(\"--body <json>\", \"Request body as JSON string\")\n    .option(\"--body-file <path>\", \"Read request body from file\")\n    .action(async (opts) => {\n      const client = await ctx.getClient();\n      let body: unknown;\n      if (opts.bodyFile) {\n        const { readFileSync } = await import(\"fs\");\n        body = ctx.parseBody(readFileSync(opts.bodyFile, \"utf-8\"));\n      } else if (opts.body) {\n        body = ctx.parseBody(opts.body);\n      }\n      if (ctx.verbose) process.stderr.write(\"POST \" + `/api/dam/query` + \"\\n\");\n      const result = await client.post(`/api/dam/query`, body);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"list-variants <code>\")\n    .description(\"Returns all variants for an existing asset\")\n    .action(async (code) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\n          \"GET \" + `/api/dam/assets/${code}/variants` + \"\\n\",\n        );\n      const result = await client.get(`/api/dam/assets/${code}/variants`);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"create-variants <code>\")\n    .description(\"Creates variants for an existing asset\")\n    .option(\"--body <json>\", \"Request body as JSON string\")\n    .option(\"--body-file <path>\", \"Read request body from file\")\n    .action(async (code, opts) => {\n      const client = await ctx.getClient();\n      let body: unknown;\n      if (opts.bodyFile) {\n        const { readFileSync } = await import(\"fs\");\n        body = ctx.parseBody(readFileSync(opts.bodyFile, \"utf-8\"));\n      } else if (opts.body) {\n        body = ctx.parseBody(opts.body);\n      }\n      if (ctx.verbose)\n        process.stderr.write(\n          \"POST \" + `/api/dam/assets/${code}/variants` + \"\\n\",\n        );\n      const result = await client.post(\n        `/api/dam/assets/${code}/variants`,\n        body,\n      );\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"get-variant <code> <id>\")\n    .description(\"Returns a specific variant for an existing asset\")\n    .action(async (code, id) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\n          \"GET \" + `/api/dam/assets/${code}/variants/${id}` + \"\\n\",\n        );\n      const result = await client.get(`/api/dam/assets/${code}/variants/${id}`);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"update-variant <code> <id>\")\n    .description(\"Updates tags for a specific variant\")\n    .option(\"--body <json>\", \"Request body as JSON string\")\n    .option(\"--body-file <path>\", \"Read request body from file\")\n    .action(async (code, id, opts) => {\n      const client = await ctx.getClient();\n      let body: unknown;\n      if (opts.bodyFile) {\n        const { readFileSync } = await import(\"fs\");\n        body = ctx.parseBody(readFileSync(opts.bodyFile, \"utf-8\"));\n      } else if (opts.body) {\n        body = ctx.parseBody(opts.body);\n      }\n      if (ctx.verbose)\n        process.stderr.write(\n          \"PUT \" + `/api/dam/assets/${code}/variants/${id}` + \"\\n\",\n        );\n      const result = await client.put(\n        `/api/dam/assets/${code}/variants/${id}`,\n        body,\n      );\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"delete-variant <code> <id>\")\n    .description(\"Destroys a variant for an existing asset\")\n    .action(async (code, id) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\n          \"DELETE \" + `/api/dam/assets/${code}/variants/${id}` + \"\\n\",\n        );\n      const result = await client.delete(\n        `/api/dam/assets/${code}/variants/${id}`,\n      );\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"discard-variant <asset-code> <id>\")\n    .description(\"Discards a variant for an existing asset (soft delete)\")\n    .action(async (assetCode, id) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\n          \"PATCH \" +\n            `/api/dam/assets/${assetCode}/variants/${id}/discard` +\n            \"\\n\",\n        );\n      const result = await client.patch(\n        `/api/dam/assets/${assetCode}/variants/${id}/discard`,\n      );\n      ctx.output(result);\n    });\n}\n","// index.ts — AUTO-GENERATED, DO NOT EDIT\nimport { Command } from \"commander\";\nimport type { CommandContext } from \"@fluid-app/fluid-cli\";\n\nimport { registerPrimary } from \"./primary.js\";\n\nexport function registerAllCommands(\n  parent: Command,\n  ctx: CommandContext,\n): void {\n  registerPrimary(parent, ctx);\n}\n","import type { FluidPlugin } from \"@fluid-app/fluid-cli\";\nimport { createDomainCommand } from \"@fluid-app/fluid-cli\";\n\nimport { registerAllCommands } from \"./generated/index.js\";\n\nconst plugin: FluidPlugin = {\n  name: \"@fluid-app/fluid-cli-assets\",\n  version: \"0.1.0\",\n  register(ctx) {\n    ctx.program.addCommand(\n      createDomainCommand(\n        \"assets\",\n        \"Manage Fluid digital assets (DAM)\",\n        registerAllCommands,\n      ),\n    );\n  },\n};\n\nexport default plugin;\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/commands/upload.ts","../src/generated/primary.ts","../src/generated/index.ts","../src/index.ts"],"sourcesContent":["/**\n * `fluid assets upload` / `fluid dam upload` — wraps the\n * `upload.fluid.app/upload` Cloud Run service (../file-upload-\n * serverless) so users can drop a file or external URL onto the\n * Fluid DAM in one step instead of stitching together the three\n * underlying API calls (imagekit_auth → ImageKit → backfill_imagekit).\n *\n * Two input modes:\n *   - Positional `<file>` path  → multipart upload from disk.\n *   - `--url <url>`             → service-side fetch + upload.\n *\n * Auth comes from the same --token / --profile / env / active-profile\n * resolution path the rest of the CLI uses; we re-implement the\n * resolve here instead of going through `ctx.getClient()` because\n * the DAM upload service lives on a different host than the\n * regular Fluid API and we just need the bearer to forward.\n */\nimport { Command } from \"commander\";\nimport { readFile, stat } from \"node:fs/promises\";\nimport { basename } from \"node:path\";\nimport { findProjectConfig, getAuthToken } from \"@fluid-app/fluid-cli\";\nimport type { CommandContext } from \"@fluid-app/fluid-cli\";\n\n// Hard-coded — the bearer token we forward is the user's Fluid API\n// token, so the destination MUST be a Fluid-controlled host or any\n// `--upload-base evil.example` would exfiltrate it. We previously\n// shipped a `--upload-base` override for local-dev convenience; if\n// you're running the upload service locally, point at it via the\n// FLUID_UPLOAD_BASE env var instead (read at process start, not\n// from an end-user-typed argv string).\nconst UPLOAD_BASE = (\n  process.env[\"FLUID_UPLOAD_BASE\"] ?? \"https://upload.fluid.app\"\n).replace(/\\/$/, \"\");\n\ninterface UploadOptions {\n  url?: string;\n  name?: string;\n  description?: string;\n  tags?: string;\n  folder?: string;\n  /**\n   * commander maps `--no-unique-filename` onto `uniqueFilename: false`.\n   * Default is true so the service keeps its existing behavior unless\n   * the user explicitly opts out.\n   */\n  uniqueFilename: boolean;\n  createMedia?: boolean;\n}\n\nexport function registerUpload(parent: Command, ctx: CommandContext): void {\n  parent\n    .command(\"upload [file]\")\n    .description(\"Upload a file or URL to the Fluid DAM (via upload.fluid.app)\")\n    .option(\n      \"--url <url>\",\n      \"Fetch from an external URL instead of attaching a local file\",\n    )\n    .option(\"--name <name>\", \"Display name for the DAM asset\")\n    .option(\"--description <description>\", \"Asset description\")\n    .option(\"--tags <tags>\", \"Comma-separated tags\")\n    .option(\"--folder <folder>\", \"ImageKit folder override\")\n    .option(\n      \"--no-unique-filename\",\n      \"Disable ImageKit's useUniqueFileName (default: enabled)\",\n    )\n    .option(\n      \"--create-media\",\n      \"Also create a Fluid Media resource (active, share, publish-now)\",\n    )\n    .action(async function (\n      this: Command,\n      filePath: string | undefined,\n      opts: UploadOptions,\n    ) {\n      // --token / --profile live on the parent `assets` domain\n      // command (createDomainCommand sets them there). Reach up to\n      // pick them up here so the user can write\n      //   fluid dam --token X upload ./photo.jpg\n      const parentOpts = (this.parent?.opts() ?? {}) as {\n        token?: string;\n        profile?: string;\n      };\n      const token = resolveToken(parentOpts);\n      if (!token) {\n        throw new Error(\n          \"No API token found. Run `fluid login` or provide --token <token>.\",\n        );\n      }\n\n      if (!filePath && !opts.url) {\n        throw new Error(\n          \"Provide a file path or --url <url>. Run `fluid dam upload --help` for usage.\",\n        );\n      }\n      if (filePath && opts.url) {\n        throw new Error(\"Provide either a file path OR --url, not both.\");\n      }\n\n      // Multipart order matters for streaming uploads (>~100 MB).\n      // The service streams `file` straight through to ImageKit, so\n      // any field ImageKit needs (`fileName`, `folder`,\n      // `useUniqueFileName`) must arrive BEFORE the file part.\n      // Fields consumed after upload (`name`, `description`, `tags`,\n      // `create_media`) can sit anywhere — we put them last for\n      // readability.\n      const form = new FormData();\n      if (opts.folder) form.append(\"folder\", opts.folder);\n      if (opts.uniqueFilename === false) {\n        form.append(\"useUniqueFileName\", \"false\");\n      }\n\n      if (opts.url) {\n        form.append(\"external_asset_url\", opts.url);\n      } else if (filePath) {\n        // Validate first — `readFile` errors are friendlier than the\n        // service returning a generic 500 for a missing file.\n        await stat(filePath);\n        const bytes = await readFile(filePath);\n        const name = basename(filePath);\n        form.append(\"fileName\", name);\n        // Wrap as a Blob so the global fetch's multipart serializer\n        // emits a proper Content-Disposition with filename. Node 20+\n        // global FormData accepts (Blob, filename) pairs.\n        form.append(\"file\", new Blob([bytes]), name);\n      }\n\n      if (opts.name) form.append(\"name\", opts.name);\n      if (opts.description) form.append(\"description\", opts.description);\n      if (opts.tags) form.append(\"tags\", opts.tags);\n      if (opts.createMedia) form.append(\"create_media\", \"true\");\n\n      if (ctx.verbose) {\n        process.stderr.write(`POST ${UPLOAD_BASE}/upload\\n`);\n      }\n\n      const resp = await fetch(`${UPLOAD_BASE}/upload`, {\n        method: \"POST\",\n        headers: { Authorization: `Bearer ${token}` },\n        body: form,\n      });\n\n      if (!resp.ok) {\n        let detail = \"\";\n        try {\n          detail = await resp.text();\n        } catch {\n          // No body or unreadable — error message stays generic.\n        }\n        throw new Error(\n          `Upload failed (HTTP ${resp.status})${\n            detail ? `: ${detail.slice(0, 400)}` : \"\"\n          }`,\n        );\n      }\n\n      const body: unknown = await resp.json();\n      ctx.output(body);\n    });\n}\n\n/**\n * Token resolution mirrors `createCommandContext.resolveToken` from\n * @fluid-app/fluid-cli: explicit flag → --profile lookup → env vars\n * → project-local `.fluidrc` → global active profile. Re-implemented\n * here instead of imported because the helper isn't exported, and\n * the duplication is tiny.\n */\nfunction resolveToken(opts: {\n  token?: string;\n  profile?: string;\n}): string | null {\n  if (opts.token) return opts.token;\n  if (opts.profile) return getAuthToken(opts.profile);\n  const envToken = process.env[\"FLUID_TOKEN\"] ?? process.env[\"FLUID_API_TOKEN\"];\n  if (envToken) return envToken;\n  const projectConfig = findProjectConfig(process.cwd());\n  if (projectConfig?.profile) {\n    const rcToken = getAuthToken(projectConfig.profile);\n    if (rcToken) return rcToken;\n  }\n  return getAuthToken();\n}\n","// primary.ts — AUTO-GENERATED, DO NOT EDIT\nimport { Command } from \"commander\";\nimport type { CommandContext } from \"@fluid-app/fluid-cli\";\n\nexport function registerPrimary(parent: Command, ctx: CommandContext): void {\n  parent\n    .command(\"get-asset-paths <code>\")\n    .description(\"Lists asset paths for an existing asset\")\n    .action(async (code) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\n          \"GET \" + `/api/dam/assets/${code}/asset_paths` + \"\\n\",\n        );\n      const result = await client.get(`/api/dam/assets/${code}/asset_paths`);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"create-asset-paths <code>\")\n    .description(\"Creates asset paths for an existing asset\")\n    .option(\"--body <json>\", \"Request body as JSON string\")\n    .option(\"--body-file <path>\", \"Read request body from file\")\n    .action(async (code, opts) => {\n      const client = await ctx.getClient();\n      let body: unknown;\n      if (opts.bodyFile) {\n        const { readFileSync } = await import(\"fs\");\n        body = ctx.parseBody(readFileSync(opts.bodyFile, \"utf-8\"));\n      } else if (opts.body) {\n        body = ctx.parseBody(opts.body);\n      }\n      if (ctx.verbose)\n        process.stderr.write(\n          \"POST \" + `/api/dam/assets/${code}/asset_paths` + \"\\n\",\n        );\n      const result = await client.post(\n        `/api/dam/assets/${code}/asset_paths`,\n        body,\n      );\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"delete-asset-path <code> <id>\")\n    .description(\"Destroys an asset path\")\n    .action(async (code, id) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\n          \"DELETE \" + `/api/dam/assets/${code}/asset_paths/${id}` + \"\\n\",\n        );\n      const result = await client.delete(\n        `/api/dam/assets/${code}/asset_paths/${id}`,\n      );\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"create-backfill-imagekit\")\n    .description(\"Creates a DAM asset from ImageKit upload metadata\")\n    .option(\"--body <json>\", \"Request body as JSON string\")\n    .option(\"--body-file <path>\", \"Read request body from file\")\n    .action(async (opts) => {\n      const client = await ctx.getClient();\n      let body: unknown;\n      if (opts.bodyFile) {\n        const { readFileSync } = await import(\"fs\");\n        body = ctx.parseBody(readFileSync(opts.bodyFile, \"utf-8\"));\n      } else if (opts.body) {\n        body = ctx.parseBody(opts.body);\n      }\n      if (ctx.verbose)\n        process.stderr.write(\n          \"POST \" + `/api/dam/assets/backfill_imagekit` + \"\\n\",\n        );\n      const result = await client.post(\n        `/api/dam/assets/backfill_imagekit`,\n        body,\n      );\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"create-asset-invalid-mixed-payload\")\n    .description(\"Errors when multiple asset types are provided\")\n    .option(\"--body <json>\", \"Request body as JSON string\")\n    .option(\"--body-file <path>\", \"Read request body from file\")\n    .action(async (opts) => {\n      const client = await ctx.getClient();\n      let body: unknown;\n      if (opts.bodyFile) {\n        const { readFileSync } = await import(\"fs\");\n        body = ctx.parseBody(readFileSync(opts.bodyFile, \"utf-8\"));\n      } else if (opts.body) {\n        body = ctx.parseBody(opts.body);\n      }\n      if (ctx.verbose) process.stderr.write(\"POST \" + `/api/dam/assets` + \"\\n\");\n      const result = await client.post(`/api/dam/assets`, body);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"get-asset <code>\")\n    .description(\"Retrieves an asset by code\")\n    .action(async (code) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\"GET \" + `/api/dam/assets/${code}` + \"\\n\");\n      const result = await client.get(`/api/dam/assets/${code}`);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"update-asset <code>\")\n    .description(\"Updates an existing asset\")\n    .option(\"--body <json>\", \"Request body as JSON string\")\n    .option(\"--body-file <path>\", \"Read request body from file\")\n    .action(async (code, opts) => {\n      const client = await ctx.getClient();\n      let body: unknown;\n      if (opts.bodyFile) {\n        const { readFileSync } = await import(\"fs\");\n        body = ctx.parseBody(readFileSync(opts.bodyFile, \"utf-8\"));\n      } else if (opts.body) {\n        body = ctx.parseBody(opts.body);\n      }\n      if (ctx.verbose)\n        process.stderr.write(\"PUT \" + `/api/dam/assets/${code}` + \"\\n\");\n      const result = await client.put(`/api/dam/assets/${code}`, body);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"delete-asset <code>\")\n    .description(\"Deletes an asset\")\n    .action(async (code) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\"DELETE \" + `/api/dam/assets/${code}` + \"\\n\");\n      const result = await client.delete(`/api/dam/assets/${code}`);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"discard-asset <code>\")\n    .description(\"Discard an asset (soft delete)\")\n    .action(async (code) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\n          \"PATCH \" + `/api/dam/assets/${code}/discard` + \"\\n\",\n        );\n      const result = await client.patch(`/api/dam/assets/${code}/discard`);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"create-imagekit-auth\")\n    .description(\n      \"Creates ImageKit authentication credentials for large file uploads\",\n    )\n    .action(async () => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\"POST \" + `/api/dam/assets/imagekit_auth` + \"\\n\");\n      const result = await client.post(`/api/dam/assets/imagekit_auth`);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"query-assets\")\n    .description(\"Query DAM assets using tree paths and tags\")\n    .option(\"--body <json>\", \"Request body as JSON string\")\n    .option(\"--body-file <path>\", \"Read request body from file\")\n    .action(async (opts) => {\n      const client = await ctx.getClient();\n      let body: unknown;\n      if (opts.bodyFile) {\n        const { readFileSync } = await import(\"fs\");\n        body = ctx.parseBody(readFileSync(opts.bodyFile, \"utf-8\"));\n      } else if (opts.body) {\n        body = ctx.parseBody(opts.body);\n      }\n      if (ctx.verbose) process.stderr.write(\"POST \" + `/api/dam/query` + \"\\n\");\n      const result = await client.post(`/api/dam/query`, body);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"list-variants <code>\")\n    .description(\"Returns all variants for an existing asset\")\n    .action(async (code) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\n          \"GET \" + `/api/dam/assets/${code}/variants` + \"\\n\",\n        );\n      const result = await client.get(`/api/dam/assets/${code}/variants`);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"create-variants <code>\")\n    .description(\"Creates variants for an existing asset\")\n    .option(\"--body <json>\", \"Request body as JSON string\")\n    .option(\"--body-file <path>\", \"Read request body from file\")\n    .action(async (code, opts) => {\n      const client = await ctx.getClient();\n      let body: unknown;\n      if (opts.bodyFile) {\n        const { readFileSync } = await import(\"fs\");\n        body = ctx.parseBody(readFileSync(opts.bodyFile, \"utf-8\"));\n      } else if (opts.body) {\n        body = ctx.parseBody(opts.body);\n      }\n      if (ctx.verbose)\n        process.stderr.write(\n          \"POST \" + `/api/dam/assets/${code}/variants` + \"\\n\",\n        );\n      const result = await client.post(\n        `/api/dam/assets/${code}/variants`,\n        body,\n      );\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"get-variant <code> <id>\")\n    .description(\"Returns a specific variant for an existing asset\")\n    .action(async (code, id) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\n          \"GET \" + `/api/dam/assets/${code}/variants/${id}` + \"\\n\",\n        );\n      const result = await client.get(`/api/dam/assets/${code}/variants/${id}`);\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"update-variant <code> <id>\")\n    .description(\"Updates tags for a specific variant\")\n    .option(\"--body <json>\", \"Request body as JSON string\")\n    .option(\"--body-file <path>\", \"Read request body from file\")\n    .action(async (code, id, opts) => {\n      const client = await ctx.getClient();\n      let body: unknown;\n      if (opts.bodyFile) {\n        const { readFileSync } = await import(\"fs\");\n        body = ctx.parseBody(readFileSync(opts.bodyFile, \"utf-8\"));\n      } else if (opts.body) {\n        body = ctx.parseBody(opts.body);\n      }\n      if (ctx.verbose)\n        process.stderr.write(\n          \"PUT \" + `/api/dam/assets/${code}/variants/${id}` + \"\\n\",\n        );\n      const result = await client.put(\n        `/api/dam/assets/${code}/variants/${id}`,\n        body,\n      );\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"delete-variant <code> <id>\")\n    .description(\"Destroys a variant for an existing asset\")\n    .action(async (code, id) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\n          \"DELETE \" + `/api/dam/assets/${code}/variants/${id}` + \"\\n\",\n        );\n      const result = await client.delete(\n        `/api/dam/assets/${code}/variants/${id}`,\n      );\n      ctx.output(result);\n    });\n\n  parent\n    .command(\"discard-variant <asset-code> <id>\")\n    .description(\"Discards a variant for an existing asset (soft delete)\")\n    .action(async (assetCode, id) => {\n      const client = await ctx.getClient();\n      if (ctx.verbose)\n        process.stderr.write(\n          \"PATCH \" +\n            `/api/dam/assets/${assetCode}/variants/${id}/discard` +\n            \"\\n\",\n        );\n      const result = await client.patch(\n        `/api/dam/assets/${assetCode}/variants/${id}/discard`,\n      );\n      ctx.output(result);\n    });\n}\n","// index.ts — AUTO-GENERATED, DO NOT EDIT\nimport { Command } from \"commander\";\nimport type { CommandContext } from \"@fluid-app/fluid-cli\";\n\nimport { registerPrimary } from \"./primary.js\";\n\nexport function registerAllCommands(\n  parent: Command,\n  ctx: CommandContext,\n): void {\n  registerPrimary(parent, ctx);\n}\n","import type { FluidPlugin } from \"@fluid-app/fluid-cli\";\nimport { createDomainCommand } from \"@fluid-app/fluid-cli\";\n\nimport { registerUpload } from \"./commands/upload.js\";\nimport { registerAllCommands } from \"./generated/index.js\";\n\nconst plugin: FluidPlugin = {\n  name: \"@fluid-app/fluid-cli-assets\",\n  version: \"0.1.0\",\n  register(ctx) {\n    const assets = createDomainCommand(\n      \"assets\",\n      \"Manage Fluid digital assets (DAM)\",\n      (parent, cmdCtx) => {\n        registerAllCommands(parent, cmdCtx);\n        // Hand-written ergonomic command on top of the generated\n        // OpenAPI surface. Wraps upload.fluid.app/upload so users\n        // can `fluid dam upload ./photo.jpg` instead of manually\n        // coordinating the three-step ImageKit + backfill flow.\n        registerUpload(parent, cmdCtx);\n      },\n    );\n    // `dam` is the colloquial nickname for this domain — both\n    // `fluid assets <cmd>` and `fluid dam <cmd>` route to the same\n    // command tree.\n    assets.alias(\"dam\");\n    ctx.program.addCommand(assets);\n  },\n};\n\nexport default plugin;\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluid-app/fluid-cli-assets",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Fluid CLI commands for digital asset management (DAM)",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -21,7 +21,7 @@
     "@fluid-app/fluid-cli": "0.1.12"
   },
   "devDependencies": {
-    "@types/node": "^24",
+    "@types/node": "24.10.12",
     "tsdown": "^0.21.0",
     "tsx": "^4.21.0",
     "typescript": "^5",

package/src/commands/upload.ts

@@ -0,0 +1,182 @@
+/**
+ * `fluid assets upload` / `fluid dam upload` — wraps the
+ * `upload.fluid.app/upload` Cloud Run service (../file-upload-
+ * serverless) so users can drop a file or external URL onto the
+ * Fluid DAM in one step instead of stitching together the three
+ * underlying API calls (imagekit_auth → ImageKit → backfill_imagekit).
+ *
+ * Two input modes:
+ *   - Positional `<file>` path  → multipart upload from disk.
+ *   - `--url <url>`             → service-side fetch + upload.
+ *
+ * Auth comes from the same --token / --profile / env / active-profile
+ * resolution path the rest of the CLI uses; we re-implement the
+ * resolve here instead of going through `ctx.getClient()` because
+ * the DAM upload service lives on a different host than the
+ * regular Fluid API and we just need the bearer to forward.
+ */
+import { Command } from "commander";
+import { readFile, stat } from "node:fs/promises";
+import { basename } from "node:path";
+import { findProjectConfig, getAuthToken } from "@fluid-app/fluid-cli";
+import type { CommandContext } from "@fluid-app/fluid-cli";
+
+// Hard-coded — the bearer token we forward is the user's Fluid API
+// token, so the destination MUST be a Fluid-controlled host or any
+// `--upload-base evil.example` would exfiltrate it. We previously
+// shipped a `--upload-base` override for local-dev convenience; if
+// you're running the upload service locally, point at it via the
+// FLUID_UPLOAD_BASE env var instead (read at process start, not
+// from an end-user-typed argv string).
+const UPLOAD_BASE = (
+  process.env["FLUID_UPLOAD_BASE"] ?? "https://upload.fluid.app"
+).replace(/\/$/, "");
+
+interface UploadOptions {
+  url?: string;
+  name?: string;
+  description?: string;
+  tags?: string;
+  folder?: string;
+  /**
+   * commander maps `--no-unique-filename` onto `uniqueFilename: false`.
+   * Default is true so the service keeps its existing behavior unless
+   * the user explicitly opts out.
+   */
+  uniqueFilename: boolean;
+  createMedia?: boolean;
+}
+
+export function registerUpload(parent: Command, ctx: CommandContext): void {
+  parent
+    .command("upload [file]")
+    .description("Upload a file or URL to the Fluid DAM (via upload.fluid.app)")
+    .option(
+      "--url <url>",
+      "Fetch from an external URL instead of attaching a local file",
+    )
+    .option("--name <name>", "Display name for the DAM asset")
+    .option("--description <description>", "Asset description")
+    .option("--tags <tags>", "Comma-separated tags")
+    .option("--folder <folder>", "ImageKit folder override")
+    .option(
+      "--no-unique-filename",
+      "Disable ImageKit's useUniqueFileName (default: enabled)",
+    )
+    .option(
+      "--create-media",
+      "Also create a Fluid Media resource (active, share, publish-now)",
+    )
+    .action(async function (
+      this: Command,
+      filePath: string | undefined,
+      opts: UploadOptions,
+    ) {
+      // --token / --profile live on the parent `assets` domain
+      // command (createDomainCommand sets them there). Reach up to
+      // pick them up here so the user can write
+      //   fluid dam --token X upload ./photo.jpg
+      const parentOpts = (this.parent?.opts() ?? {}) as {
+        token?: string;
+        profile?: string;
+      };
+      const token = resolveToken(parentOpts);
+      if (!token) {
+        throw new Error(
+          "No API token found. Run `fluid login` or provide --token <token>.",
+        );
+      }
+
+      if (!filePath && !opts.url) {
+        throw new Error(
+          "Provide a file path or --url <url>. Run `fluid dam upload --help` for usage.",
+        );
+      }
+      if (filePath && opts.url) {
+        throw new Error("Provide either a file path OR --url, not both.");
+      }
+
+      // Multipart order matters for streaming uploads (>~100 MB).
+      // The service streams `file` straight through to ImageKit, so
+      // any field ImageKit needs (`fileName`, `folder`,
+      // `useUniqueFileName`) must arrive BEFORE the file part.
+      // Fields consumed after upload (`name`, `description`, `tags`,
+      // `create_media`) can sit anywhere — we put them last for
+      // readability.
+      const form = new FormData();
+      if (opts.folder) form.append("folder", opts.folder);
+      if (opts.uniqueFilename === false) {
+        form.append("useUniqueFileName", "false");
+      }
+
+      if (opts.url) {
+        form.append("external_asset_url", opts.url);
+      } else if (filePath) {
+        // Validate first — `readFile` errors are friendlier than the
+        // service returning a generic 500 for a missing file.
+        await stat(filePath);
+        const bytes = await readFile(filePath);
+        const name = basename(filePath);
+        form.append("fileName", name);
+        // Wrap as a Blob so the global fetch's multipart serializer
+        // emits a proper Content-Disposition with filename. Node 20+
+        // global FormData accepts (Blob, filename) pairs.
+        form.append("file", new Blob([bytes]), name);
+      }
+
+      if (opts.name) form.append("name", opts.name);
+      if (opts.description) form.append("description", opts.description);
+      if (opts.tags) form.append("tags", opts.tags);
+      if (opts.createMedia) form.append("create_media", "true");
+
+      if (ctx.verbose) {
+        process.stderr.write(`POST ${UPLOAD_BASE}/upload\n`);
+      }
+
+      const resp = await fetch(`${UPLOAD_BASE}/upload`, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${token}` },
+        body: form,
+      });
+
+      if (!resp.ok) {
+        let detail = "";
+        try {
+          detail = await resp.text();
+        } catch {
+          // No body or unreadable — error message stays generic.
+        }
+        throw new Error(
+          `Upload failed (HTTP ${resp.status})${
+            detail ? `: ${detail.slice(0, 400)}` : ""
+          }`,
+        );
+      }
+
+      const body: unknown = await resp.json();
+      ctx.output(body);
+    });
+}
+
+/**
+ * Token resolution mirrors `createCommandContext.resolveToken` from
+ * @fluid-app/fluid-cli: explicit flag → --profile lookup → env vars
+ * → project-local `.fluidrc` → global active profile. Re-implemented
+ * here instead of imported because the helper isn't exported, and
+ * the duplication is tiny.
+ */
+function resolveToken(opts: {
+  token?: string;
+  profile?: string;
+}): string | null {
+  if (opts.token) return opts.token;
+  if (opts.profile) return getAuthToken(opts.profile);
+  const envToken = process.env["FLUID_TOKEN"] ?? process.env["FLUID_API_TOKEN"];
+  if (envToken) return envToken;
+  const projectConfig = findProjectConfig(process.cwd());
+  if (projectConfig?.profile) {
+    const rcToken = getAuthToken(projectConfig.profile);
+    if (rcToken) return rcToken;
+  }
+  return getAuthToken();
+}

package/src/index.ts

@@ -1,19 +1,30 @@
 import type { FluidPlugin } from "@fluid-app/fluid-cli";
 import { createDomainCommand } from "@fluid-app/fluid-cli";
 
+import { registerUpload } from "./commands/upload.js";
 import { registerAllCommands } from "./generated/index.js";
 
 const plugin: FluidPlugin = {
   name: "@fluid-app/fluid-cli-assets",
   version: "0.1.0",
   register(ctx) {
-    ctx.program.addCommand(
-      createDomainCommand(
-        "assets",
-        "Manage Fluid digital assets (DAM)",
-        registerAllCommands,
-      ),
+    const assets = createDomainCommand(
+      "assets",
+      "Manage Fluid digital assets (DAM)",
+      (parent, cmdCtx) => {
+        registerAllCommands(parent, cmdCtx);
+        // Hand-written ergonomic command on top of the generated
+        // OpenAPI surface. Wraps upload.fluid.app/upload so users
+        // can `fluid dam upload ./photo.jpg` instead of manually
+        // coordinating the three-step ImageKit + backfill flow.
+        registerUpload(parent, cmdCtx);
+      },
     );
+    // `dam` is the colloquial nickname for this domain — both
+    // `fluid assets <cmd>` and `fluid dam <cmd>` route to the same
+    // command tree.
+    assets.alias("dam");
+    ctx.program.addCommand(assets);
   },
 };