cloudtifact 0.1.0 → 0.1.2

package/dist/index.js

@@ -5703,6 +5703,11 @@ const devLoginOutput = object({
 	token: string(),
 	user: userSchema
 });
+/** A one-hour token for the comment panel on published pages: reads a space and reads or posts its comments. */
+const embedTokenOutput = object({
+	token: string(),
+	expiresAt: number$1()
+});
 object({ label: string().max(60).optional() });
 const cliLoginStartOutput = object({
 	deviceCode: string(),
@@ -5749,6 +5754,25 @@ const listTokensOutput = object({ tokens: array(object({
 const preferencesSchema = object({ developerMode: boolean() });
 preferencesSchema.partial();
 object({ handle: handleSchema });
+const emailCategoryIdSchema = _enum([
+	"invites",
+	"activity",
+	"product"
+]);
+const emailPreferencesSchema = object({
+	email: string().nullable(),
+	categories: array(object({
+		id: emailCategoryIdSchema,
+		label: string(),
+		description: string(),
+		enabled: boolean()
+	}))
+});
+object({
+	invites: boolean(),
+	activity: boolean(),
+	product: boolean()
+}).partial().strict();
 const meOutput = object({
 	user: userSchema,
 	workspaces: array(myWorkspaceSchema),
@@ -6538,8 +6562,11 @@ function createClient({ baseUrl, token, fetch: fetchImpl = fetch, agent, source,
 	const app = (id) => `/v1/apps/${enc$1(id)}`;
 	return {
 		devLogin: (input) => call("POST", "/v1/auth/dev-login", devLoginOutput, input),
+		createEmbedToken: () => call("POST", "/v1/auth/embed-token", embedTokenOutput),
 		me: () => call("GET", "/v1/me", meOutput),
 		updatePreferences: (input) => call("PATCH", "/v1/me/preferences", preferencesSchema, input),
+		emailPreferences: () => call("GET", "/v1/me/email-preferences", emailPreferencesSchema),
+		updateEmailPreferences: (input) => call("PATCH", "/v1/me/email-preferences", emailPreferencesSchema, input),
 		/** Changes your handle; your personal workspace's slug follows when it matched the old handle. */
 		updateHandle: (input) => call("PATCH", "/v1/me/handle", userSchema, input),
 		/** Deletes your account for good: tokens stop working, workspaces only you are in are deleted. */
@@ -6725,8 +6752,8 @@ function urlsFor(domain, userContent = USER_CONTENT_DOMAIN) {
 	};
 }
 const PUBLIC_URLS = urlsFor(PUBLIC_DOMAIN);
-/** The one-line install for the CLI, against a given API origin. */
-const installCommand = (apiUrl = PUBLIC_URLS.api) => `curl -fsSL ${apiUrl.replace(/\/+$/, "")}/install.sh | sh`;
+/** The one-line install for the CLI. */
+const installCommand = () => "npm i -g cloudtifact";
 //#endregion
 //#region ../contract/src/guest-writes.ts
 /**
@@ -11117,6 +11144,19 @@ function errorText(e) {
 //#endregion
 //#region src/publish.ts
 const ENTRY = "index.html";
+/** A public page's link with the comment panel already open (cloudtifact.app/<id>/?comments). */
+function commentsUrl(shareUrl) {
+	return `${shareUrl}${shareUrl.includes("?") ? "&" : "?"}comments`;
+}
+/**
+* What `publish` prints after the version line. A public page gets two links to the same page: on its own (a micro
+* app, with a Comment button in the corner) and with the comment panel already open. A private page has only the
+* app link, which members open inside the Cloudtifact viewer.
+*/
+function linkLines(space) {
+	if (space.shareUrl) return [`Page: ${space.shareUrl}`, `With comments: ${commentsUrl(space.shareUrl)}`];
+	return [`Link: ${space.url}`, `Private: only members of the ${space.workspace.slug} workspace can open it. To make it public, change visibility in the space settings on the website.`];
+}
 /** A local, relative reference, or null for absolute URLs, data:, anchors, etc. Drops ?query and #hash. */
 function localRef(raw) {
 	const ref = raw.trim().replace(/^['"]|['"]$/g, "");
@@ -11455,10 +11495,12 @@ function findThread(threads, commentId) {
 }
 //#endregion
 //#region src/hooks.ts
+const SCRIPT_INSTALL_BIN = "\"$HOME/.cloudtifact/bin/cloudtifact\"";
 /** The command every harness runs after a file edit. Reads the hook payload on stdin, always exits 0. */
-const HOOK_COMMAND = "\"$HOME/.cloudtifact/bin/cloudtifact\" hook";
+const HOOK_COMMAND = `if [ -x ${SCRIPT_INSTALL_BIN} ]; then ${SCRIPT_INSTALL_BIN} hook; elif command -v cloudtifact >/dev/null 2>&1; then cloudtifact hook; fi`;
 const OUR_COMMANDS = /* @__PURE__ */ new Set([
 	HOOK_COMMAND,
+	`${SCRIPT_INSTALL_BIN} hook`,
 	"npx -y cloudtifact hook",
 	"cloudtifact hook"
 ]);
@@ -11769,7 +11811,7 @@ description: Use when you make an HTML page for the user (publish it and share t
 
 The folder named by \`dir\` in \`.cloudtifact.json\` (at the repo root) is published to Cloudtifact. Every push makes a new version; readers comment on the published pages.
 
-If the \`cloudtifact\` command isn't found, install it: \`${installCommand()}\` (it lands in \`~/.cloudtifact/bin\`). \`cloudtifact upgrade\` updates it to the latest version.
+If the \`cloudtifact\` command isn't found, install it: \`${installCommand()}\` (needs Node.js 20 or later). \`cloudtifact upgrade\` updates it to the latest version.
 
 ## Before editing docs in that folder
 
@@ -11792,7 +11834,7 @@ Published file types: Markdown, HTML, and the files pages load (CSS, JS, JSON, i
 
 ## Publishing HTML pages
 
-When you make an HTML page for the user, run \`cloudtifact publish <file.html>\` and give them the link it prints. It uploads the page plus the local files it references (CSS, JS, images).
+When you make an HTML page for the user, run \`cloudtifact publish <file.html>\` and give them the links it prints. A public page prints two links to the same page: \`Page:\` opens it on its own (with a Comment button in the corner), and \`With comments:\` opens it with the comment panel already open. Give both, or the one the user asked for. A private page prints one \`Link:\`, for members of the workspace. It uploads the page plus the local files it references (CSS, JS, images).
 
 - To update it, edit the same file and publish it again: new version, same link.
 - Keep supporting files next to the HTML (or in subfolders) and reference them with relative paths (\`style.css\`, \`img/logo.png\`). Absolute paths and files outside the page's folder aren't included.
@@ -12074,7 +12116,7 @@ function workspaceTextLines(workspaces, currentSlug) {
 }
 //#endregion
 //#region src/program.ts
-const VERSION = "0.1.0";
+const VERSION = "0.1.2";
 const program = new Command().name("cloudtifact").description("Publish pages and docs to Cloudtifact as links people comment on, with every version kept and the comments handed back to your agent.").version(VERSION);
 program.command("login").description("Sign in through your browser (GitHub, Google or email) and save a token to the global config").option("--no-browser", "don't open a browser, just print the URL (automatic over SSH)").action(run(async (opts) => {
 	const config = await readGlobalConfig();
@@ -12458,13 +12500,6 @@ for (const [name, verb] of [["resolve", "Resolved"], ["unresolve", "Reopened"]])
 	const c = await (name === "resolve" ? client.resolveComment(commentId) : client.unresolveComment(commentId));
 	console.log(`${verb} ${c.id} on ${c.path}.`);
 }));
-function printLink(space) {
-	if (space.shareUrl) console.log(space.shareUrl);
-	else {
-		console.log(space.url);
-		console.log(`Private: only members of the ${space.workspace.slug} workspace can open it. To make it public, change visibility in the space settings on the website.`);
-	}
-}
 program.command("publish").description("Publish an HTML page (with the files it references) or a folder; prints its link").argument("<path>", "an .html file or a folder with index.html").option("--public", "anyone with the link can view (only when first published; default: private)").option("--name <name>", "space name (default: the page's <title>, else the file name)").option("--workspace <slug>", "workspace for a new space (default: the current one, see `workspace list`)").option("--entry <file>", "folder only: the page to publish as index.html").option("-m, --message <message>", "version message").option("--no-db", "don't run the db/*.sql files next to the page").action(run(async (target, opts) => {
 	const abs = path.resolve(target);
 	if (!existsSync(abs)) throw new CliError(`${target} does not exist.`);
@@ -12510,7 +12545,7 @@ program.command("publish").description("Publish an HTML page (with the files it
 	const n = bundle.files.length;
 	if (r.status === "pushed") console.log(`Published "${space.name}" v${r.version} (${n} file${n === 1 ? "" : "s"}; ${summarize(r.diff)})`);
 	else console.log(`No changes since v${space.latestVersion}: "${space.name}"`);
-	printLink(space);
+	for (const line of linkLines(space)) console.log(line);
 }));
 program.command("artifacts").description("List pages published with `cloudtifact publish`").option("--toon", "print TOON (compact, for agents)").option("--json", "print JSON").action(run(async (opts) => {
 	const map = await readArtifacts();
@@ -12526,7 +12561,8 @@ program.command("artifacts").description("List pages published with `cloudtifact
 			workspace: space?.workspace.slug ?? null,
 			visibility: space?.visibility ?? null,
 			latestVersion: space?.latestVersion ?? null,
-			link: space ? space.shareUrl ?? space.url : null
+			link: space ? space.shareUrl ?? space.url : null,
+			commentsLink: space ? space.shareUrl ? commentsUrl(space.shareUrl) : space.url : null
 		});
 	}
 	const format = resolveFormat(opts);

package/package.json

@@ -1,17 +1,12 @@
 {
   "name": "cloudtifact",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Publish pages and docs to Cloudtifact as links people comment on, with every version kept and the comments handed back to your agent.",
   "license": "MIT",
   "author": "The Cloudtifact authors",
   "homepage": "https://cloudtifact.com/docs/reference/cli",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/cloudtifact/cloudtifact.git",
-    "directory": "packages/cli"
-  },
   "bugs": {
-    "url": "https://github.com/cloudtifact/cloudtifact/issues"
+    "url": "https://cloudtifact.com/support"
   },
   "keywords": [
     "cloudtifact",
@@ -37,15 +32,15 @@
     "node": ">=20"
   },
   "devDependencies": {
+    "@cloudtifact/contract": "0.1.0",
+    "@cloudtifact/typescript-config": "0.1.0",
+    "@toon-format/toon": "^4.1.1",
     "@types/node": "^20.19.0",
     "commander": "^15.0.0",
     "tsdown": "^0.23.0",
     "typescript": "^5.9.3",
     "vitest": "~4.1.11",
-    "zod": "^4.6.5",
-    "@toon-format/toon": "^4.1.1",
-    "@cloudtifact/contract": "0.1.0",
-    "@cloudtifact/typescript-config": "0.1.0"
+    "zod": "^4.6.5"
   },
   "publishConfig": {
     "access": "public"
@@ -55,5 +50,9 @@
     "dev": "tsdown --watch",
     "typecheck": "tsc --noEmit",
     "test": "vitest run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cloudtifact/cloudtifact-cli.git"
   }
-}
+}