contentrain 0.3.2 → 0.3.4

package/README.md

@@ -2,9 +2,16 @@
 
 [![npm version](https://img.shields.io/npm/v/contentrain?label=contentrain)](https://www.npmjs.com/package/contentrain)
 [![GitHub source](https://img.shields.io/badge/source-Contentrain%2Fai-181717?logo=github)](https://github.com/Contentrain/ai/tree/main/packages/cli)
+[![Docs](https://img.shields.io/badge/docs-ai.contentrain.io-0f172a)](https://ai.contentrain.io/packages/cli)
 
 CLI for Contentrain.
 
+Start here:
+
+- [2-minute product demo](https://ai.contentrain.io/demo)
+- [CLI docs](https://ai.contentrain.io/packages/cli)
+- [Getting started](https://ai.contentrain.io/getting-started)
+
 `contentrain` is the local operations surface for a Contentrain project:
 
 - initialize `.contentrain/` in an existing repo
@@ -51,6 +58,17 @@ Requirements:
 | `contentrain generate` | Generate `.contentrain/client/` and `#contentrain` package imports |
 | `contentrain diff` | Review and merge or reject pending `contentrain/*` branches |
 | `contentrain serve` | Start the local review UI or the MCP stdio server |
+| `contentrain studio login` | Authenticate with Contentrain Studio |
+| `contentrain studio logout` | Log out from Studio |
+| `contentrain studio whoami` | Show current authentication status |
+| `contentrain studio status` | Show project overview from Studio |
+| `contentrain studio activity` | Show recent activity feed |
+| `contentrain studio usage` | Show workspace usage metrics |
+| `contentrain studio branches` | Manage remote content branches |
+| `contentrain studio cdn-init` | Set up CDN for content delivery |
+| `contentrain studio cdn-build` | Trigger a CDN rebuild |
+| `contentrain studio webhooks` | Manage webhooks |
+| `contentrain studio submissions` | Manage form submissions |
 
 ## 🔄 Typical Flow
 
@@ -150,6 +168,42 @@ to understand:
 - whether branch health is blocking new writes
 - what changed before merging or deleting a branch
 
+## 🔗 Studio Integration
+
+The `studio` command group connects the CLI to [Contentrain Studio](https://studio.contentrain.io) for enterprise workflows.
+
+Authenticate:
+
+```bash
+contentrain studio login
+contentrain studio whoami
+```
+
+Set up CDN for content delivery:
+
+```bash
+contentrain studio cdn-init
+contentrain studio cdn-build --wait
+```
+
+Monitor project activity and usage:
+
+```bash
+contentrain studio status
+contentrain studio activity --limit 10
+contentrain studio usage
+```
+
+Manage branches, webhooks, and form submissions:
+
+```bash
+contentrain studio branches
+contentrain studio webhooks
+contentrain studio submissions --form contact-form
+```
+
+Credentials are stored securely in `~/.contentrain/credentials.json` with `0o600` permissions. Use `CONTENTRAIN_STUDIO_TOKEN` environment variable for CI/CD.
+
 ## 🤖 IDE Rules
 
 `contentrain init` installs project-level AI rules automatically:

package/dist/activity-CtOcAA4X.mjs

@@ -0,0 +1,88 @@
+import { i as pc } from "./ui-B5mXontH.mjs";
+import { n as resolveStudioClient } from "./client-D4xW8aLz.mjs";
+import { t as resolveStudioContext } from "./resolve-context-BMV7JwCw.mjs";
+import { defineCommand } from "citty";
+import { intro, log, outro, spinner } from "@clack/prompts";
+//#region src/studio/commands/activity.ts
+var activity_default = defineCommand({
+	meta: {
+		name: "activity",
+		description: "Show recent activity from Studio"
+	},
+	args: {
+		workspace: {
+			type: "string",
+			description: "Workspace ID",
+			required: false
+		},
+		project: {
+			type: "string",
+			description: "Project ID",
+			required: false
+		},
+		limit: {
+			type: "string",
+			description: "Number of entries (default 20)",
+			required: false
+		},
+		json: {
+			type: "boolean",
+			description: "JSON output",
+			required: false
+		}
+	},
+	async run({ args }) {
+		if (!args.json) intro(pc.bold("contentrain studio activity"));
+		try {
+			const client = await resolveStudioClient();
+			const ctx = await resolveStudioContext(client, args);
+			if (!ctx) {
+				log.warning("No workspace or project found.");
+				outro("");
+				return;
+			}
+			const s = args.json ? null : spinner();
+			s?.start("Fetching activity...");
+			const result = await client.getActivity(ctx.workspaceId, ctx.projectId, { limit: args.limit ?? "20" });
+			s?.stop(`${result.data.length} entries`);
+			if (args.json) {
+				process.stdout.write(JSON.stringify(result, null, 2));
+				return;
+			}
+			if (result.data.length === 0) {
+				log.info("No recent activity.");
+				outro("");
+				return;
+			}
+			for (const entry of result.data) {
+				const time = pc.dim(timeAgo(entry.createdAt).padEnd(10));
+				const actor = pc.cyan(entry.actor.padEnd(24));
+				const action = actionColor(entry.action);
+				const details = entry.details ? pc.dim(` ${entry.details}`) : "";
+				log.message(`  ${time} ${actor} ${action}${details}`);
+			}
+			if (result.total > result.data.length) log.message(pc.dim(`\n  Showing ${result.data.length} of ${result.total} entries. Use --limit to see more.`));
+		} catch (error) {
+			log.error(error instanceof Error ? error.message : String(error));
+			process.exitCode = 1;
+		}
+		if (!args.json) outro("");
+	}
+});
+function timeAgo(dateStr) {
+	const diff = Date.now() - new Date(dateStr).getTime();
+	const minutes = Math.floor(diff / 6e4);
+	if (minutes < 1) return "just now";
+	if (minutes < 60) return `${minutes}m ago`;
+	const hours = Math.floor(minutes / 60);
+	if (hours < 24) return `${hours}h ago`;
+	return `${Math.floor(hours / 24)}d ago`;
+}
+function actionColor(action) {
+	if (action.includes("saved") || action.includes("merged")) return pc.green(action);
+	if (action.includes("deleted") || action.includes("rejected")) return pc.red(action);
+	if (action.includes("build")) return pc.yellow(action);
+	return action;
+}
+//#endregion
+export { activity_default as default };

package/dist/branches-C_kgqSv9.mjs

@@ -0,0 +1,142 @@
+import { i as pc, r as formatTable, t as formatCount } from "./ui-B5mXontH.mjs";
+import { n as resolveStudioClient } from "./client-D4xW8aLz.mjs";
+import { t as resolveStudioContext } from "./resolve-context-BMV7JwCw.mjs";
+import { defineCommand } from "citty";
+import { confirm, intro, isCancel, log, outro, select, spinner } from "@clack/prompts";
+//#region src/studio/commands/branches.ts
+var branches_default = defineCommand({
+	meta: {
+		name: "branches",
+		description: "Manage content branches on Studio"
+	},
+	args: {
+		workspace: {
+			type: "string",
+			description: "Workspace ID",
+			required: false
+		},
+		project: {
+			type: "string",
+			description: "Project ID",
+			required: false
+		},
+		json: {
+			type: "boolean",
+			description: "JSON output",
+			required: false
+		}
+	},
+	async run({ args }) {
+		if (!args.json) intro(pc.bold("contentrain studio branches"));
+		try {
+			const client = await resolveStudioClient();
+			const ctx = await resolveStudioContext(client, args);
+			if (!ctx) {
+				log.warning("No workspace or project found.");
+				outro("");
+				return;
+			}
+			const { workspaceId, projectId } = ctx;
+			const s = args.json ? null : spinner();
+			s?.start("Fetching branches...");
+			const branches = await client.listBranches(workspaceId, projectId);
+			s?.stop(`${formatCount(branches.length, "branch", "branches")}`);
+			if (args.json) {
+				process.stdout.write(JSON.stringify(branches, null, 2));
+				return;
+			}
+			if (branches.length === 0) {
+				log.info("No pending content branches.");
+				outro("");
+				return;
+			}
+			const rows = branches.map((b) => [
+				b.name,
+				`+${b.ahead}`,
+				b.author ?? "—",
+				timeAgo(b.lastCommitDate)
+			]);
+			log.message(formatTable([
+				"Branch",
+				"Ahead",
+				"Author",
+				"Updated"
+			], rows));
+			const branchChoice = await select({
+				message: "Select a branch to manage",
+				options: [...branches.map((b) => ({
+					value: b.name,
+					label: `${b.name} (+${b.ahead})`
+				})), {
+					value: "__cancel__",
+					label: pc.dim("Cancel")
+				}]
+			});
+			if (isCancel(branchChoice) || branchChoice === "__cancel__") {
+				outro("");
+				return;
+			}
+			const selectedBranch = branchChoice;
+			const action = await select({
+				message: `Action for ${pc.cyan(selectedBranch)}`,
+				options: [
+					{
+						value: "merge",
+						label: "Merge into main branch"
+					},
+					{
+						value: "reject",
+						label: "Reject and delete"
+					},
+					{
+						value: "cancel",
+						label: pc.dim("Cancel")
+					}
+				]
+			});
+			if (isCancel(action) || action === "cancel") {
+				outro("");
+				return;
+			}
+			if (action === "merge") {
+				const confirmed = await confirm({ message: `Merge ${pc.cyan(selectedBranch)} into the main branch?` });
+				if (isCancel(confirmed) || !confirmed) {
+					outro(pc.dim("Cancelled"));
+					return;
+				}
+				const ms = spinner();
+				ms.start("Merging...");
+				await client.mergeBranch(workspaceId, projectId, selectedBranch);
+				ms.stop("Merged");
+				log.success(`Branch ${pc.cyan(selectedBranch)} merged successfully.`);
+			}
+			if (action === "reject") {
+				const confirmed = await confirm({ message: `Reject and delete ${pc.cyan(selectedBranch)}? This cannot be undone.` });
+				if (isCancel(confirmed) || !confirmed) {
+					outro(pc.dim("Cancelled"));
+					return;
+				}
+				const rs = spinner();
+				rs.start("Rejecting...");
+				await client.rejectBranch(workspaceId, projectId, selectedBranch);
+				rs.stop("Rejected");
+				log.success(`Branch ${pc.cyan(selectedBranch)} rejected and deleted.`);
+			}
+		} catch (error) {
+			log.error(error instanceof Error ? error.message : String(error));
+			process.exitCode = 1;
+		}
+		if (!args.json) outro("");
+	}
+});
+function timeAgo(dateStr) {
+	const diff = Date.now() - new Date(dateStr).getTime();
+	const minutes = Math.floor(diff / 6e4);
+	if (minutes < 1) return "just now";
+	if (minutes < 60) return `${minutes}m ago`;
+	const hours = Math.floor(minutes / 60);
+	if (hours < 24) return `${hours}h ago`;
+	return `${Math.floor(hours / 24)}d ago`;
+}
+//#endregion
+export { branches_default as default };

package/dist/cdn-build-CDv_yM15.mjs

@@ -0,0 +1,106 @@
+import { i as pc, t as formatCount } from "./ui-B5mXontH.mjs";
+import { n as resolveStudioClient } from "./client-D4xW8aLz.mjs";
+import { t as resolveStudioContext } from "./resolve-context-BMV7JwCw.mjs";
+import { defineCommand } from "citty";
+import { intro, log, outro, spinner } from "@clack/prompts";
+//#region src/studio/commands/cdn-build.ts
+const POLL_INTERVAL_MS = 3e3;
+var cdn_build_default = defineCommand({
+	meta: {
+		name: "cdn-build",
+		description: "Trigger a CDN rebuild"
+	},
+	args: {
+		workspace: {
+			type: "string",
+			description: "Workspace ID",
+			required: false
+		},
+		project: {
+			type: "string",
+			description: "Project ID",
+			required: false
+		},
+		wait: {
+			type: "boolean",
+			description: "Wait for build to complete",
+			required: false
+		},
+		json: {
+			type: "boolean",
+			description: "JSON output",
+			required: false
+		}
+	},
+	async run({ args }) {
+		if (!args.json) intro(pc.bold("contentrain studio cdn-build"));
+		try {
+			const client = await resolveStudioClient();
+			const ctx = await resolveStudioContext(client, args);
+			if (!ctx) {
+				log.warning("No workspace or project found.");
+				outro("");
+				return;
+			}
+			const { workspaceId, projectId } = ctx;
+			const s = args.json ? null : spinner();
+			s?.start("Triggering CDN build...");
+			const build = await client.triggerCdnBuild(workspaceId, projectId);
+			if (build.status === "success") {
+				s?.stop("Build complete");
+				outputResult(build, args.json);
+				if (!args.json) outro("");
+				return;
+			}
+			if (!args.wait || build.status === "failed") {
+				s?.stop(`Build ${build.status}`);
+				outputResult(build, args.json);
+				if (build.status === "failed" && build.errorMessage && !args.json) {
+					log.error(build.errorMessage);
+					process.exitCode = 1;
+				}
+				if (!args.json) outro("");
+				return;
+			}
+			s?.stop("Build started, waiting...");
+			const ps = args.json ? null : spinner();
+			ps?.start("Building...");
+			let current = build;
+			while (current.status === "building") {
+				await sleep(POLL_INTERVAL_MS);
+				const builds = await client.listCdnBuilds(workspaceId, projectId, { limit: "1" });
+				if (builds.data[0]) current = builds.data[0];
+			}
+			if (current.status === "success") {
+				ps?.stop("Build complete");
+				outputResult(current, args.json);
+			} else {
+				ps?.stop("Build failed");
+				outputResult(current, args.json);
+				if (current.errorMessage && !args.json) log.error(current.errorMessage);
+				process.exitCode = 1;
+			}
+		} catch (error) {
+			log.error(error instanceof Error ? error.message : String(error));
+			process.exitCode = 1;
+		}
+		if (!args.json) outro("");
+	}
+});
+function outputResult(build, json) {
+	if (json) {
+		process.stdout.write(JSON.stringify(build, null, 2));
+		return;
+	}
+	const sizeKb = (build.totalSizeBytes / 1024).toFixed(1);
+	const duration = build.buildDurationMs ? `${(build.buildDurationMs / 1e3).toFixed(1)}s` : "—";
+	log.message(`  Files:    ${formatCount(build.fileCount, "file")}`);
+	log.message(`  Size:     ${sizeKb} KB`);
+	log.message(`  Duration: ${duration}`);
+	if (build.status === "success") log.success("CDN is up to date.");
+}
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//#endregion
+export { cdn_build_default as default };

package/dist/cdn-init-DXQ-3V_c.mjs

@@ -0,0 +1,90 @@
+import { i as pc } from "./ui-B5mXontH.mjs";
+import { n as resolveStudioClient } from "./client-D4xW8aLz.mjs";
+import { t as resolveStudioContext } from "./resolve-context-BMV7JwCw.mjs";
+import { defineCommand } from "citty";
+import { confirm, intro, isCancel, log, outro, spinner } from "@clack/prompts";
+//#region src/studio/commands/cdn-init.ts
+var cdn_init_default = defineCommand({
+	meta: {
+		name: "cdn-init",
+		description: "Set up CDN for content delivery"
+	},
+	args: {
+		workspace: {
+			type: "string",
+			description: "Workspace ID",
+			required: false
+		},
+		project: {
+			type: "string",
+			description: "Project ID",
+			required: false
+		}
+	},
+	async run({ args }) {
+		intro(pc.bold("contentrain studio cdn-init"));
+		try {
+			const client = await resolveStudioClient();
+			const ctx = await resolveStudioContext(client, args);
+			if (!ctx) {
+				log.warning("No workspace or project found.");
+				outro("");
+				return;
+			}
+			const { workspaceId, projectId } = ctx;
+			const s = spinner();
+			s.start("Checking CDN status...");
+			const existingKeys = await client.listCdnKeys(workspaceId, projectId);
+			if (existingKeys.length > 0) {
+				s.stop("CDN already configured");
+				log.info(`Found ${existingKeys.length} existing CDN key(s):`);
+				for (const key of existingKeys) log.message(`  ${pc.cyan(key.name)} — ${pc.dim(key.prefix + "...")} (${key.createdAt})`);
+				const createAnother = await confirm({ message: "Create an additional CDN key?" });
+				if (isCancel(createAnother) || !createAnother) {
+					outro("");
+					return;
+				}
+			} else s.stop("No CDN keys found");
+			const s2 = spinner();
+			s2.start("Creating CDN API key...");
+			const newKey = await client.createCdnKey(workspaceId, projectId, "cli-generated");
+			s2.stop("CDN key created");
+			log.warning("Save this API key — it will not be shown again:");
+			log.message(`\n  ${pc.bold(pc.green(newKey.key ?? newKey.prefix + "..."))}`);
+			log.message("");
+			const shouldBuild = await confirm({ message: "Trigger initial CDN build now?" });
+			if (!isCancel(shouldBuild) && shouldBuild) {
+				const s3 = spinner();
+				s3.start("Building CDN...");
+				const build = await client.triggerCdnBuild(workspaceId, projectId);
+				if (build.status === "success") s3.stop(`Build complete (${build.fileCount} files)`);
+				else if (build.status === "building") s3.stop("Build started (check status with `contentrain studio cdn-build --wait`)");
+				else {
+					s3.stop(`Build ${build.status}`);
+					if (build.errorMessage) log.warning(build.errorMessage);
+				}
+			}
+			log.info(pc.bold("\nSDK Integration"));
+			log.message(pc.dim("  Install the SDK:"));
+			log.message(`  ${pc.cyan("npm install @contentrain/query")}`);
+			log.message("");
+			log.message(pc.dim("  Configure the CDN client:"));
+			log.message(`
+  ${pc.dim("import { createContentrainCDN } from '@contentrain/query/cdn'")}
+
+  ${pc.dim("const client = createContentrainCDN({")}
+  ${pc.dim(`  projectId: '${projectId}',`)}
+  ${pc.dim("  apiKey: process.env.CONTENTRAIN_CDN_KEY,")}
+  ${pc.dim("})")}
+`);
+			log.message(pc.dim("  Add to your .env:"));
+			log.message(`  ${pc.yellow(`CONTENTRAIN_CDN_KEY=${newKey.key ?? "<your-key>"}`)}`);
+		} catch (error) {
+			log.error(error instanceof Error ? error.message : String(error));
+			process.exitCode = 1;
+		}
+		outro("");
+	}
+});
+//#endregion
+export { cdn_init_default as default };