@letterstory/cli 0.12.0 → 0.13.0

package/lib/cli.mjs

@@ -40,7 +40,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.12.0";
+export const VERSION = "0.13.0";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value.
@@ -64,6 +64,10 @@ const BOOLEAN_FLAGS = new Set([
 	// both put a value-less flag next to a value: without these entries the parser
 	// hands the following token to the flag and the real argument disappears.
 	"regenerate",
+	// `connectors connect --provider framer --token … --auto-deploy` / `--no-auto-deploy`
+	// are value-less; without these the parser eats the following token.
+	"auto-deploy",
+	"no-auto-deploy",
 	"stock-only",
 	"gate",
 	"skip",
@@ -208,6 +212,16 @@ Connectors:
                                                        collection, reconciling (adopt/update/create/orphan).
                                                        --collection for a bound collection, --provider to
                                                        auto-resolve, or both to wire an unbound collection.
+  connectors connect --provider <p> --token <api-token>
+                                                       Save + validate CMS credentials. framer also needs
+                                                       --project-url (+ [--no-auto-deploy]); sanity needs
+                                                       --project-id [--dataset]; contentful needs --space-id
+                                                       [--environment].
+  connectors disconnect --provider <p>                 Forget a CMS connection (keeps imported posts)
+  connectors connections                               Show connection status for every provider
+  connectors mappings --provider <p>                   List the org's field mappings for a provider
+  connectors bind --collection <uuid> --provider <p> [--mapping <uuid>]
+                                                       Wire a collection to a CMS + field mapping
 
 Strategy & onboarding:
   strategy company get | set [--name] [--domain] [--manifesto <text>|--manifesto-file <path>]

package/lib/commands/connectors.mjs

@@ -20,8 +20,20 @@ export async function cmdConnectors(ctx) {
 		case "pull":
 		case "import":
 			return connectorsPull(rest);
+		case "connect":
+			return connectorsConnect(rest);
+		case "disconnect":
+			return connectorsDisconnect(rest);
+		case "connections":
+			return connectorsConnections(rest);
+		case "mappings":
+			return connectorsMappings(rest);
+		case "bind":
+			return connectorsBind(rest);
 		default:
-			throw new CliError(`Unknown connectors subcommand: ${sub ?? "(none)"}. Try: list, publish, status, pull`);
+			throw new CliError(
+				`Unknown connectors subcommand: ${sub ?? "(none)"}. Try: list, publish, status, pull, connect, disconnect, connections, mappings, bind`
+			);
 	}
 }
 
@@ -81,3 +93,67 @@ async function connectorsPull(ctx) {
 	printResult(io, flags, result);
 	return 0;
 }
+
+async function connectorsConnect(ctx) {
+	const { client, flags, io } = ctx;
+	const provider = requireFlag(flags, "provider");
+	// api_token is required for every provider; the rest are provider-specific.
+	const args = compact({
+		provider,
+		api_token: requireFlag(flags, "token"),
+		project_url: flagStr(flags["project-url"]),
+		auto_deploy: flags["no-auto-deploy"] ? false : flagBool(flags["auto-deploy"]) || undefined,
+		project_id: flagStr(flags["project-id"]),
+		dataset: flagStr(flags.dataset),
+		project_name: flagStr(flags["project-name"]),
+		workspace_name: flagStr(flags.workspace),
+		space_id: flagStr(flags["space-id"]),
+		environment_id: flagStr(flags.environment),
+		space_name: flagStr(flags["space-name"]),
+		default_locale: flagStr(flags.locale),
+	});
+	const result = await client.callTool("connect_cms", args);
+	ok(ctx, `Connected ${provider}${result?.label ? ` (${result.label})` : ""}.`);
+	printResult(io, flags, result);
+	return 0;
+}
+
+async function connectorsDisconnect(ctx) {
+	const { client, flags, io } = ctx;
+	const provider = requireFlag(flags, "provider");
+	const result = await client.callTool("disconnect_cms", { provider });
+	ok(ctx, `Disconnected ${provider}.`);
+	printResult(io, flags, result);
+	return 0;
+}
+
+async function connectorsConnections(ctx) {
+	const { client, flags, io } = ctx;
+	const result = await client.callTool("list_cms_connections", {});
+	printResult(io, flags, result);
+	return 0;
+}
+
+async function connectorsMappings(ctx) {
+	const { client, flags, io } = ctx;
+	const provider = requireFlag(flags, "provider");
+	const result = await client.callTool("list_cms_mappings", { provider });
+	printResult(io, flags, result);
+	return 0;
+}
+
+async function connectorsBind(ctx) {
+	const { client, flags, io } = ctx;
+	const args = compact({
+		collection_id: requireFlag(flags, "collection"),
+		provider: requireFlag(flags, "provider"),
+		mapping_id: flagStr(flags.mapping),
+	});
+	const result = await client.callTool("bind_collection_cms", args);
+	ok(
+		ctx,
+		`Bound collection ${result?.collection_id ?? ""} to ${result?.provider ?? ""} (mapping ${result?.mapping_id ?? ""}).`
+	);
+	printResult(io, flags, result);
+	return 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@letterstory/cli",
-	"version": "0.12.0",
+	"version": "0.13.0",
 	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",