sequoia-cli 0.5.6 → 0.5.7

package/dist/components/sequoia-subscribe.js

@@ -1,24 +1,15 @@
 /**
- * Sequoia Subscribe - An AT Protocol-powered subscribe component
- *
- * A self-contained Web Component that lets users subscribe to a publication
- * via the AT Protocol by creating a site.standard.graph.subscription record.
+ * Sequoia Web Components — AT Protocol-powered engagement components
  *
- * Usage:
- *   <sequoia-subscribe></sequoia-subscribe>
+ * Self-contained Web Components for subscribing to publications and
+ * recommending documents via the AT Protocol.
  *
- * The component resolves the publication AT URI from the host site's
- * /.well-known/site.standard.publication endpoint.
+ * Both components share:
+ *   - OAuth redirect flow via a hosted callback endpoint
+ *   - DID caching in a cookie (primary) and localStorage (fallback)
+ *   - A common visual style driven by CSS custom properties
  *
- * Attributes:
- *   - publication-uri: Override the publication AT URI (optional)
- *   - callback-uri: Redirect URI after OAuth authentication (default: "https://sequoia.pub/subscribe")
- *   - button-type: Branding style — "sequoia" (default), "bluesky", "blacksky", "atmosphere", or "plain"
- *   - label: Override the subscribe button label text
- *   - unsubscribe-label: Override the unsubscribe button label text
- *   - hide: Set to "auto" to hide if no publication URI is detected
- *
- * CSS Custom Properties:
+ * CSS Custom Properties (apply to both components):
  *   - --sequoia-fg-color: Text color (default: #1f2937)
  *   - --sequoia-bg-color: Background color (default: #ffffff)
  *   - --sequoia-border-color: Border color (default: #e5e7eb)
@@ -26,12 +17,6 @@
  *   - --sequoia-secondary-color: Secondary text color (default: #6b7280)
  *   - --sequoia-border-radius: Border radius (default: 8px)
  *   - --sequoia-icon-display: Icon display mode (default: inline-block) — set to "none" to hide
- *
- * Events:
- *   - sequoia-subscribed: Fired when the subscription is created successfully.
- *     detail: { publicationUri: string, recordUri: string }
- *   - sequoia-subscribe-error: Fired when the subscription fails.
- *     detail: { message: string }
  */
 
 // ============================================================================
@@ -50,7 +35,7 @@ const styles = `
 	box-sizing: border-box;
 }
 
-.sequoia-subscribe-button {
+.sequoia-button {
 	display: inline-flex;
 	align-items: center;
 	gap: 0.375rem;
@@ -67,16 +52,16 @@ const styles = `
 	font-family: inherit;
 }
 
-.sequoia-subscribe-button:hover:not(:disabled) {
+.sequoia-button:hover:not(:disabled) {
 	background: color-mix(in srgb, var(--sequoia-accent-color, #2563eb) 85%, black);
 }
 
-.sequoia-subscribe-button:disabled {
+.sequoia-button:disabled {
 	opacity: 0.6;
 	cursor: not-allowed;
 }
 
-.sequoia-subscribe-button svg {
+.sequoia-button svg {
 	display: var(--sequoia-icon-display, inline-block);
 	width: 1rem;
 	height: 1rem;
@@ -148,6 +133,47 @@ const BUTTON_TYPES = {
 	plain: { icon: "", subscribe: "Subscribe", unsubscribe: "Unsubscribe" },
 };
 
+// ============================================================================
+// Recommend Icon Configuration
+// ============================================================================
+
+const HEART_PATH =
+	"M20.84 4.61a5.5 5.5 0 0 0-7.78 0L12 5.67l-1.06-1.06a5.5 5.5 0 0 0-7.78 7.78l1.06 1.06L12 21.23l7.78-7.78 1.06-1.06a5.5 5.5 0 0 0 0-7.78z";
+const HEART_ICON_OUTLINED = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="${HEART_PATH}"/></svg>`;
+const HEART_ICON_FILLED = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor"><path d="${HEART_PATH}"/></svg>`;
+
+const STAR_PATH =
+	"M3.612 15.443c-.386.198-.824-.149-.746-.592l.83-4.73L.173 6.765c-.329-.314-.158-.888.283-.95l4.898-.696L7.538.792c.197-.39.73-.39.927 0l2.184 4.327 4.898.696c.441.062.612.636.282.95l-3.522 3.356.83 4.73c.078.443-.36.79-.746.592L8 13.187l-4.389 2.256z";
+const STAR_ICON_OUTLINED = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linejoin="round"><path d="${STAR_PATH}"/></svg>`;
+const STAR_ICON_FILLED = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" fill="currentColor"><path d="${STAR_PATH}"/></svg>`;
+
+const THUMBS_UP_RECT_PATH = "M1 21h4V9H1v12z";
+const THUMBS_UP_HAND_PATH =
+	"M23 10c0-1.1-.9-2-2-2h-6.31l.95-4.57.03-.32c0-.41-.17-.79-.44-1.06L14.17 1 7.59 7.59C7.22 7.95 7 8.45 7 9v10c0 1.1.9 2 2 2h9c.83 0 1.54-.5 1.84-1.22l3.02-7.05c.09-.23.14-.47.14-.73v-2z";
+const THUMBS_UP_ICON_OUTLINED = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="${THUMBS_UP_RECT_PATH}" fill="currentColor"/><path d="${THUMBS_UP_HAND_PATH}" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linejoin="round"/></svg>`;
+const THUMBS_UP_ICON_FILLED = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor"><path d="${THUMBS_UP_RECT_PATH}"/><path d="${THUMBS_UP_HAND_PATH}"/></svg>`;
+
+const RECOMMEND_ICON_TYPES = {
+	heart: {
+		icon: HEART_ICON_OUTLINED,
+		iconActioned: HEART_ICON_FILLED,
+		action: "Recommend",
+		unaction: "Unrecommend",
+	},
+	star: {
+		icon: STAR_ICON_OUTLINED,
+		iconActioned: STAR_ICON_FILLED,
+		action: "Recommend",
+		unaction: "Unrecommend",
+	},
+	"thumbs-up": {
+		icon: THUMBS_UP_ICON_OUTLINED,
+		iconActioned: THUMBS_UP_ICON_FILLED,
+		action: "Recommend",
+		unaction: "Unrecommend",
+	},
+};
+
 // ============================================================================
 // DID Storage
 // ============================================================================
@@ -161,6 +187,7 @@ function storeSubscriberDid(did) {
 		const expires = new Date(
 			Date.now() + 365 * 24 * 60 * 60 * 1000,
 		).toUTCString();
+		// biome-ignore lint/suspicious/noDocumentCookie: back-compat with older browsers
 		document.cookie = `sequoia_did=${encodeURIComponent(did)}; Expires=${expires}; Path=/; SameSite=Lax; Secure`;
 	} catch {
 		// Cookie write may fail in some embedded contexts
@@ -200,6 +227,7 @@ function getStoredSubscriberDid() {
  */
 function clearSubscriberDid() {
 	try {
+		// biome-ignore lint/suspicious/noDocumentCookie: back-compat with older browsers
 		document.cookie =
 			"sequoia_did=; Expires=Thu, 01 Jan 1970 00:00:00 GMT; Path=/; SameSite=Lax; Secure";
 	} catch {
@@ -229,7 +257,7 @@ function consumeReturnParams() {
 		changed = true;
 	}
 
-	if (did && did.startsWith("did:")) {
+	if (did?.startsWith("did:")) {
 		storeSubscriberDid(did);
 		url.searchParams.delete("sequoia_did");
 		changed = true;
@@ -287,7 +315,13 @@ async function fetchPublicationUri(origin) {
 // SSR-safe base class - use HTMLElement in browser, empty class in Node.js
 const BaseElement = typeof HTMLElement !== "undefined" ? HTMLElement : class {};
 
-class SequoiaSubscribe extends BaseElement {
+/**
+ * Abstract base class shared by SequoiaSubscribe and SequoiaRecommend.
+ * Handles shadow DOM setup, state management, the OAuth redirect flow,
+ * DID storage, and button rendering. Subclasses implement template methods
+ * to provide resource-specific behaviour.
+ */
+class SequoiaActionBase extends BaseElement {
 	constructor() {
 		super();
 		const shadow = this.attachShadow({ mode: "open" });
@@ -301,82 +335,104 @@ class SequoiaSubscribe extends BaseElement {
 		wrapper.part = "container";
 
 		this.wrapper = wrapper;
-		this.subscribed = false;
+		this.actioned = false;
 		this.state = { type: "idle" };
 		this.abortController = null;
 		this.render();
 	}
 
-	static get observedAttributes() {
-		return [
-			"publication-uri",
-			"callback-uri",
-			"label",
-			"unsubscribe-label",
-			"button-type",
-			"hide",
-		];
-	}
-
-	connectedCallback() {
-		consumeReturnParams();
-		this.checkPublication();
-	}
-
 	disconnectedCallback() {
 		this.abortController?.abort();
 	}
 
 	attributeChangedCallback() {
-		if (this.state.type === "error" || this.state.type === "no-publication") {
+		if (this.state.type === "error" || this.state.type === "no-resource") {
 			this.state = { type: "idle" };
 		}
 		this.render();
 	}
 
-	get publicationUri() {
-		return this.getAttribute("publication-uri") ?? null;
-	}
+	// ── Shared getters ───────────────────────────────────────────────────────
 
 	get callbackUri() {
-		return this.getAttribute("callback-uri") ?? "https://sequoia.pub/subscribe";
+		return this.getAttribute("callback-uri") ?? this.defaultCallbackUri;
 	}
 
-	get label() {
-		return this.getAttribute("label") ?? null;
+	get hide() {
+		return this.getAttribute("hide") === "auto";
 	}
 
-	get unsubscribeLabel() {
-		return this.getAttribute("unsubscribe-label") ?? null;
+	// ── Template methods (override in subclasses) ────────────────────────────
+
+	/** @returns {string} Default callback URI when the attribute is absent */
+	get defaultCallbackUri() {
+		return "";
 	}
 
-	get buttonType() {
-		const val = this.getAttribute("button-type");
-		return val && val in BUTTON_TYPES ? val : "sequoia";
+	/** @returns {string} Query-parameter name for the resource URI */
+	get resourceParam() {
+		return "resourceUri";
 	}
 
-	get hide() {
-		const hideAttr = this.getAttribute("hide");
-		return hideAttr === "auto";
+	/**
+	 * Value of the `action` query-parameter used in the unaction redirect.
+	 * @returns {string}
+	 */
+	get unactionValue() {
+		return "unaction";
 	}
 
-	async checkPublication() {
-		this.abortController?.abort();
-		this.abortController = new AbortController();
+	/** @returns {string} Key in the /check response that signals the action was taken */
+	get actionedKey() {
+		return "actioned";
+	}
 
-		try {
-			const uri = this.publicationUri ?? (await fetchPublicationUri());
-			this.checkSubscription(uri);
-		} catch {
-			this.state = { type: "no-publication" };
-			this.render();
-		}
+	/** @returns {string} CustomEvent name dispatched on success */
+	get actionedEventName() {
+		return "sequoia-actioned";
+	}
+
+	/** @returns {string} CustomEvent name dispatched on error */
+	get errorEventName() {
+		return "sequoia-action-error";
+	}
+
+	/** @returns {string} Fallback error message when the thrown value has no message */
+	get defaultErrorMessage() {
+		return "Action failed";
 	}
 
-	async checkSubscription(publicationUri) {
+	/** @returns {string} SVG string for the button icon */
+	getIcon() {
+		return "";
+	}
+
+	/** @returns {string} Accessible label for the button (defaults to the visible label) */
+	getAriaLabel() {
+		return this.actioned
+			? (this.getUnactionLabel?.() ?? this.getDefaultUnactionLabel?.() ?? "")
+			: (this.label ?? this.getDefaultActionLabel?.() ?? "");
+	}
+
+	/**
+	 * Resolve the resource URI for this action. May perform async network calls.
+	 * @returns {Promise<string>}
+	 */
+	async resolveResourceUri() {
+		throw new Error("resolveResourceUri() must be implemented by subclass");
+	}
+
+	// ── Shared logic ─────────────────────────────────────────────────────────
+
+	/**
+	 * Check whether the current user has already taken this action for the
+	 * given resource URI. Updates this.actioned and re-renders on success.
+	 * @param {string} resourceUri
+	 */
+	async checkStatusFor(resourceUri) {
 		try {
 			const checkUrl = new URL(`${this.callbackUri}/check`);
-			checkUrl.searchParams.set("publicationUri", publicationUri);
+			checkUrl.searchParams.set(this.resourceParam, resourceUri);
 
 			// Pass the stored DID so the server can check without a session cookie
 			const storedDid = getStoredSubscriberDid();
@@ -389,12 +445,12 @@ class SequoiaSubscribe extends BaseElement {
 			});
 			if (!res.ok) return;
 			const data = await res.json();
-			if (data.subscribed) {
-				this.subscribed = true;
+			if (data[this.actionedKey]) {
+				this.actioned = true;
 				this.render();
 			}
 		} catch {
-			// Ignore errors — show default subscribe button
+			// Ignore errors — show default action button
 		}
 	}
 
@@ -403,11 +459,10 @@ class SequoiaSubscribe extends BaseElement {
 			return;
 		}
 
-		// Unsubscribe: redirect to full-page unsubscribe flow
-		if (this.subscribed) {
-			const publicationUri =
-				this.publicationUri ?? (await fetchPublicationUri());
-			window.location.href = `${this.callbackUri}?publicationUri=${encodeURIComponent(publicationUri)}&action=unsubscribe`;
+		// Unaction: redirect to the full-page unaction flow
+		if (this.actioned) {
+			const resourceUri = await this.resolveResourceUri();
+			window.location.href = `${this.callbackUri}?${this.resourceParam}=${encodeURIComponent(resourceUri)}&action=${this.unactionValue}`;
 			return;
 		}
 
@@ -415,28 +470,27 @@ class SequoiaSubscribe extends BaseElement {
 		this.render();
 
 		try {
-			const publicationUri =
-				this.publicationUri ?? (await fetchPublicationUri());
+			const resourceUri = await this.resolveResourceUri();
 
 			const response = await fetch(this.callbackUri, {
 				method: "POST",
 				headers: { "Content-Type": "application/json" },
 				credentials: "include",
 				referrerPolicy: "no-referrer-when-downgrade",
-				body: JSON.stringify({ publicationUri }),
+				body: JSON.stringify({ [this.resourceParam]: resourceUri }),
 			});
 
 			const data = await response.json();
 
 			if (response.status === 401 && data.authenticated === false) {
-				// Redirect to the hosted subscribe page to complete OAuth,
+				// Redirect to the hosted action page to complete OAuth,
 				// passing the current page URL (without credentials) as returnTo.
-				const subscribeUrl = new URL(data.subscribeUrl);
+				const actionUrl = new URL(data.subscribeUrl);
 				const pageUrl = new URL(window.location.href);
 				pageUrl.username = "";
 				pageUrl.password = "";
-				subscribeUrl.searchParams.set("returnTo", pageUrl.toString());
-				window.location.href = subscribeUrl.toString();
+				actionUrl.searchParams.set("returnTo", pageUrl.toString());
+				window.location.href = actionUrl.toString();
 				return;
 			}
 
@@ -454,27 +508,27 @@ class SequoiaSubscribe extends BaseElement {
 				}
 			}
 
-			this.subscribed = true;
+			this.actioned = true;
 			this.state = { type: "idle" };
 			this.render();
 
 			this.dispatchEvent(
-				new CustomEvent("sequoia-subscribed", {
+				new CustomEvent(this.actionedEventName, {
 					bubbles: true,
 					composed: true,
-					detail: { publicationUri, recordUri },
+					detail: { [this.resourceParam]: resourceUri, recordUri },
 				}),
 			);
 		} catch (error) {
 			if (this.state.type !== "loading") return;
 
 			const message =
-				error instanceof Error ? error.message : "Failed to subscribe";
+				error instanceof Error ? error.message : this.defaultErrorMessage;
 			this.state = { type: "error", message };
 			this.render();
 
 			this.dispatchEvent(
-				new CustomEvent("sequoia-subscribe-error", {
+				new CustomEvent(this.errorEventName, {
 					bubbles: true,
 					composed: true,
 					detail: { message },
@@ -486,7 +540,7 @@ class SequoiaSubscribe extends BaseElement {
 	render() {
 		const { type } = this.state;
 
-		if (type === "no-publication") {
+		if (type === "no-resource") {
 			if (this.hide) {
 				this.wrapper.innerHTML = "";
 				this.wrapper.style.display = "none";
@@ -495,15 +549,15 @@ class SequoiaSubscribe extends BaseElement {
 		}
 
 		const isLoading = type === "loading";
-		const config = BUTTON_TYPES[this.buttonType] ?? BUTTON_TYPES.sequoia;
-
 		const icon = isLoading
 			? `<span class="sequoia-loading-spinner"></span>`
-			: config.icon;
+			: this.getIcon();
+
+		const label = this.actioned
+			? (this.getUnactionLabel?.() ?? this.getDefaultUnactionLabel?.() ?? "")
+			: (this.label ?? this.getDefaultActionLabel?.() ?? "");
 
-		const label = this.subscribed
-			? (this.unsubscribeLabel ?? config.unsubscribe)
-			: (this.label ?? config.subscribe);
+		const ariaLabel = this.getAriaLabel();
 
 		const errorHtml =
 			type === "error"
@@ -512,11 +566,11 @@ class SequoiaSubscribe extends BaseElement {
 
 		this.wrapper.innerHTML = `
 			<button
-				class="sequoia-subscribe-button"
+				class="sequoia-button"
 				type="button"
 				part="button"
 				${isLoading ? "disabled" : ""}
-				aria-label="${label}"
+				aria-label="${ariaLabel}"
 			>
 				${icon}
 				${label}
@@ -529,6 +583,197 @@ class SequoiaSubscribe extends BaseElement {
 	}
 }
 
+class SequoiaSubscribe extends SequoiaActionBase {
+	static get observedAttributes() {
+		return [
+			"publication-uri",
+			"callback-uri",
+			"label",
+			"unsubscribe-label",
+			"button-type",
+			"hide",
+		];
+	}
+
+	connectedCallback() {
+		consumeReturnParams();
+		this.checkPublication();
+	}
+
+	get publicationUri() {
+		return this.getAttribute("publication-uri") ?? null;
+	}
+
+	get label() {
+		return this.getAttribute("label") ?? null;
+	}
+
+	get buttonType() {
+		const val = this.getAttribute("button-type");
+		return val && val in BUTTON_TYPES ? val : "sequoia";
+	}
+
+	get unsubscribeLabel() {
+		return this.getAttribute("unsubscribe-label") ?? null;
+	}
+
+	// ── Template method overrides ────────────────────────────────────────────
+
+	get defaultCallbackUri() {
+		return "https://sequoia.pub/subscribe";
+	}
+	get resourceParam() {
+		return "publicationUri";
+	}
+	get unactionValue() {
+		return "unsubscribe";
+	}
+	get actionedKey() {
+		return "subscribed";
+	}
+	get actionedEventName() {
+		return "sequoia-subscribed";
+	}
+	get errorEventName() {
+		return "sequoia-subscribe-error";
+	}
+	get defaultErrorMessage() {
+		return "Failed to subscribe";
+	}
+
+	getDefaultActionLabel() {
+		return (BUTTON_TYPES[this.buttonType] ?? BUTTON_TYPES.sequoia).subscribe;
+	}
+
+	getDefaultUnactionLabel() {
+		return (BUTTON_TYPES[this.buttonType] ?? BUTTON_TYPES.sequoia).unsubscribe;
+	}
+
+	getUnactionLabel() {
+		return this.unsubscribeLabel;
+	}
+
+	getIcon() {
+		return (BUTTON_TYPES[this.buttonType] ?? BUTTON_TYPES.sequoia).icon;
+	}
+
+	async resolveResourceUri() {
+		return this.publicationUri ?? (await fetchPublicationUri());
+	}
+
+	// ── SequoiaSubscribe-specific logic ──────────────────────────────────────
+
+	/** @returns {boolean} Whether the user is currently subscribed. Alias for this.actioned. */
+	get subscribed() {
+		return this.actioned;
+	}
+
+	/**
+	 * Check whether the current user is subscribed to the given publication URI.
+	 * Forwards to the shared checkStatusFor() method.
+	 * @param {string} publicationUri
+	 */
+	checkSubscription(publicationUri) {
+		return this.checkStatusFor(publicationUri);
+	}
+
+	async checkPublication() {
+		this.abortController?.abort();
+		this.abortController = new AbortController();
+
+		try {
+			const uri = await this.resolveResourceUri();
+			this.checkStatusFor(uri);
+		} catch {
+			this.state = { type: "no-resource" };
+			this.render();
+		}
+	}
+}
+
+class SequoiaRecommend extends SequoiaActionBase {
+	static get observedAttributes() {
+		return ["document-uri", "callback-uri", "button-type", "hide"];
+	}
+
+	connectedCallback() {
+		consumeReturnParams();
+		this.checkDocument();
+	}
+
+	get documentUri() {
+		const attrUri = this.getAttribute("document-uri");
+		if (attrUri) return attrUri;
+		const linkTag = document.querySelector(
+			'link[rel="site.standard.document"]',
+		);
+		return linkTag?.href ?? null;
+	}
+
+	get buttonType() {
+		const val = this.getAttribute("button-type");
+		return val && val in RECOMMEND_ICON_TYPES ? val : "heart";
+	}
+
+	// ── Template method overrides ────────────────────────────────────────────
+
+	get defaultCallbackUri() {
+		return "https://sequoia.pub/recommend";
+	}
+	get resourceParam() {
+		return "documentUri";
+	}
+	get unactionValue() {
+		return "remove";
+	}
+	get actionedKey() {
+		return "recommended";
+	}
+	get actionedEventName() {
+		return "sequoia-recommended";
+	}
+	get errorEventName() {
+		return "sequoia-recommend-error";
+	}
+	get defaultErrorMessage() {
+		return "Failed to recommend";
+	}
+
+	getAriaLabel() {
+		const config =
+			RECOMMEND_ICON_TYPES[this.buttonType] ?? RECOMMEND_ICON_TYPES.heart;
+		return this.actioned ? config.unaction : config.action;
+	}
+
+	getIcon() {
+		const config =
+			RECOMMEND_ICON_TYPES[this.buttonType] ?? RECOMMEND_ICON_TYPES.heart;
+		return this.actioned ? config.iconActioned : config.icon;
+	}
+
+	async resolveResourceUri() {
+		const uri = this.documentUri;
+		if (!uri) throw new Error("No document URI found");
+		return uri;
+	}
+
+	// ── SequoiaRecommend-specific logic ──────────────────────────────────────
+
+	async checkDocument() {
+		this.abortController?.abort();
+		this.abortController = new AbortController();
+
+		const uri = this.documentUri;
+		if (!uri) {
+			this.state = { type: "no-resource" };
+			this.render();
+			return;
+		}
+
+		this.checkStatusFor(uri);
+	}
+}
+
 /**
  * Escape HTML special characters (no DOM dependency for SSR).
  * @param {string} text
@@ -542,10 +787,62 @@ function escapeHtml(text) {
 		.replace(/"/g, "&quot;");
 }
 
-// Register the custom element
+// Register the custom elements
 if (typeof customElements !== "undefined") {
 	customElements.define("sequoia-subscribe", SequoiaSubscribe);
+	customElements.define("sequoia-recommend", SequoiaRecommend);
 }
 
-// Export for module usage
+/**
+ * Sequoia Subscribe - An AT Protocol-powered subscribe component
+ *
+ * A self-contained Web Component that lets users subscribe to a publication
+ * via the AT Protocol by creating a site.standard.graph.subscription record.
+ *
+ * Usage:
+ *   <sequoia-subscribe></sequoia-subscribe>
+ *
+ * The component resolves the publication AT URI from the host site's
+ * /.well-known/site.standard.publication endpoint.
+ *
+ * Attributes:
+ *   - publication-uri: Override the publication AT URI (optional)
+ *   - callback-uri: Redirect URI after OAuth authentication (default: "https://sequoia.pub/subscribe")
+ *   - button-type: Branding style — "sequoia" (default), "bluesky", "blacksky", "atmosphere", or "plain"
+ *   - label: Override the subscribe button label text
+ *   - unsubscribe-label: Override the unsubscribe button label text
+ *   - hide: Set to "auto" to hide if no publication URI is detected
+ *
+ * Events:
+ *   - sequoia-subscribed: Fired when the subscription is created successfully.
+ *     detail: { publicationUri: string, recordUri: string }
+ *   - sequoia-subscribe-error: Fired when the subscription fails.
+ *     detail: { message: string }
+ */
 export { SequoiaSubscribe };
+
+/**
+ * Sequoia Recommend - An AT Protocol-powered recommend component
+ *
+ * A self-contained Web Component that lets users recommend a document
+ * via the AT Protocol by creating a site.standard.graph.recommend record.
+ *
+ * Usage:
+ *   <sequoia-recommend></sequoia-recommend>
+ *
+ * The component resolves the document AT URI from the `document-uri` attribute
+ * or a <link rel="site.standard.document" href="at://..."> tag in the page head.
+ *
+ * Attributes:
+ *   - document-uri: AT Protocol URI of the document to recommend (optional if link tag present)
+ *   - callback-uri: Redirect URI after OAuth authentication (default: "https://sequoia.pub/recommend")
+ *   - button-type: Icon style — "heart" (default), "star", or "thumbs-up"
+ *   - hide: Set to "auto" to hide if no document URI is detected
+ *
+ * Events:
+ *   - sequoia-recommended: Fired when the recommendation is created successfully.
+ *     detail: { documentUri: string, recordUri: string }
+ *   - sequoia-recommend-error: Fired when the recommendation fails.
+ *     detail: { message: string }
+ */
+export { SequoiaRecommend };

package/dist/index.js

@@ -6,39 +6,60 @@ var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: () => mod[key],
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
-var __moduleCache = /* @__PURE__ */ new WeakMap;
 var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
   if (entry)
     return entry;
   entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
   __moduleCache.set(from, entry);
   return entry;
 };
+var __moduleCache;
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -60551,17 +60572,6 @@ var require_db = __commonJS((exports, module) => {
   };
 });
 
-// ../../node_modules/.bun/mime-db@1.52.0/node_modules/mime-db/index.js
-var require_mime_db = __commonJS((exports, module) => {
-  /*!
-   * mime-db
-   * Copyright(c) 2014 Jonathan Ong
-   * Copyright(c) 2015-2022 Douglas Christopher Wilson
-   * MIT Licensed
-   */
-  module.exports = require_db();
-});
-
 // ../../node_modules/.bun/@atproto-labs+fetch@0.2.3/node_modules/@atproto-labs/fetch/dist/fetch-error.js
 var require_fetch_error = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
@@ -78864,7 +78874,7 @@ var require_undici = __commonJS((exports, module) => {
   exports.setGlobalDispatcher = setGlobalDispatcher;
   exports.getGlobalDispatcher = getGlobalDispatcher;
   var fetchImpl = require_fetch2().fetch;
-  exports.fetch = async function fetch(init, options = undefined) {
+  exports.fetch = async function fetch2(init, options = undefined) {
     try {
       return await fetchImpl(init, options);
     } catch (err) {
@@ -93396,6 +93406,15 @@ import * as fs from "node:fs/promises";
 import * as path from "node:path";
 var CONFIG_FILENAME = "sequoia.json";
 var STATE_FILENAME = ".sequoia-state.json";
+var DEFAULT_PUBLISHER_CONFIG = {
+  publicDir: "./public",
+  outputDir: "./dist",
+  pathPrefix: "/posts",
+  publishContent: true,
+  removeIndexFromSlug: false,
+  stripDatePrefix: false,
+  autoSync: true
+};
 async function fileExists(filePath) {
   try {
     await fs.access(filePath);
@@ -93432,7 +93451,7 @@ async function loadConfig(configPath) {
       throw new Error("contentDir is required in config");
     if (!config.publicationUri)
       throw new Error("publicationUri is required in config");
-    return config;
+    return { ...DEFAULT_PUBLISHER_CONFIG, ...config };
   } catch (error) {
     if (error instanceof Error && error.message.includes("required")) {
       throw error;
@@ -93480,7 +93499,7 @@ function generateConfigTemplate(options) {
   if (options.textContentField) {
     config.textContentField = options.textContentField;
   }
-  if (options.publishContent) {
+  if (options.publishContent !== undefined) {
     config.publishContent = options.publishContent;
   }
   if (options.bluesky) {
@@ -93640,7 +93659,7 @@ var import_api = __toESM(require_dist8(), 1);
  * Copyright(c) 2015 Douglas Christopher Wilson
  * MIT Licensed
  */
-var db = require_mime_db();
+var db = require_db();
 var extname = __require("path").extname;
 var $extensions = Object.create(null);
 var $lookup = lookup;
@@ -103071,9 +103090,9 @@ function updateFrontmatterWithAtUri(rawContent, atUri) {
 ${afterEnd}`;
 }
 function stripMarkdownForText(markdown) {
-  return markdown.replace(/#{1,6}\s/g, "").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/`{3}[\s\S]*?`{3}/g, "").replace(/`([^`]+)`/g, "$1").replace(/!\[.*?\]\(.*?\)/g, "").replace(/\n{3,}/g, `
+  return markdown.replace(/#{1,6}\s/g, "").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/!\[.*?\]\(.*?\)/g, "").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/`{3}[\s\S]*?`{3}/g, "").replace(/`([^`]+)`/g, "$1").replace(/\n{3,}/g, `
 
-`).trim();
+`).replace(/(~{1,2})([^~]+?)\1/g, "$2").replace(/<!--[\s\S]*?-->/g, "").replace(/^\s*\[\^[^\]]+\]:[^\r\n]*(?:\r?\n[ \t]+[^\r\n]*)*/gm, "").replace(/\[\^\S+\]/g, "").trim();
 }
 
 // src/lib/oauth-client.ts
@@ -103248,6 +103267,7 @@ function isAppPasswordCredentials(creds) {
 }
 
 // src/lib/atproto.ts
+var COVER_IMAGE_MAX_SIZE = 1024 * 1024 - 1;
 function isDocumentRecord(value) {
   if (!value || typeof value !== "object")
     return false;
@@ -103337,13 +103357,14 @@ async function uploadImage(agent, imagePath) {
     const response = await agent.com.atproto.repo.uploadBlob(new Uint8Array(imageBuffer), {
       encoding: mimeType
     });
+    const blob = response.data.blob;
     return {
       $type: "blob",
       ref: {
-        $link: response.data.blob.ref.toString()
+        $link: blob.ref.toString()
       },
-      mimeType,
-      size: imageBuffer.byteLength
+      mimeType: blob.mimeType,
+      size: blob.size
     };
   } catch (error) {
     console.error(`Error uploading image ${imagePath}:`, error);
@@ -103379,7 +103400,7 @@ async function resolveImagePath(ogImage, imagesDir, contentDir) {
       return contentRelative;
     }
   }
-  return null;
+  return;
 }
 async function createDocument(agent, post, config, coverImage) {
   const postPath = resolvePostPath(post, config.pathPrefix, config.pathTemplate);
@@ -103399,7 +103420,7 @@ async function createDocument(agent, post, config, coverImage) {
     title: post.frontmatter.title,
     site: config.publicationUri,
     path: postPath,
-    textContent: textContent?.slice(0, 1e4),
+    textContent,
     publishedAt: publishDate.toISOString(),
     canonicalUrl: `${config.siteUrl}${postPath}`
   };
@@ -103420,7 +103441,10 @@ async function createDocument(agent, post, config, coverImage) {
     collection: "site.standard.document",
     record
   });
-  return response.data.uri;
+  return {
+    cid: response.data.cid,
+    uri: response.data.uri
+  };
 }
 async function updateDocument(agent, post, atUri, config, coverImage) {
   const uriMatch = atUri.match(/^at:\/\/([^/]+)\/([^/]+)\/(.+)$/);
@@ -103449,7 +103473,7 @@ async function updateDocument(agent, post, atUri, config, coverImage) {
     title: post.frontmatter.title,
     site: config.publicationUri,
     path: postPath,
-    textContent: textContent?.slice(0, 1e4),
+    textContent,
     publishedAt: publishDate.toISOString(),
     canonicalUrl: `${config.siteUrl}${postPath}`
   };
@@ -103465,12 +103489,16 @@ async function updateDocument(agent, post, atUri, config, coverImage) {
   if (post.frontmatter.tags && post.frontmatter.tags.length > 0) {
     record.tags = post.frontmatter.tags;
   }
-  await agent.com.atproto.repo.putRecord({
+  const response = await agent.com.atproto.repo.putRecord({
     repo: agent.did,
     collection,
     rkey,
     record
   });
+  return {
+    cid: response.data.cid,
+    uri: response.data.uri
+  };
 }
 function parseAtUri(atUri) {
   const match2 = atUri.match(/^at:\/\/([^/]+)\/([^/]+)\/(.+)$/);
@@ -103536,7 +103564,10 @@ async function createPublication(agent, options) {
     collection: "site.standard.publication",
     record
   });
-  return response.data.uri;
+  return {
+    cid: response.data.cid,
+    uri: response.data.uri
+  };
 }
 async function getPublication(agent, publicationUri) {
   const parsed = parseAtUri(publicationUri);
@@ -103624,6 +103655,8 @@ async function createBlueskyPost(agent, options) {
     description,
     bskyPost,
     canonicalUrl,
+    documentRef,
+    publicationRef,
     coverImage,
     publishedAt
   } = options;
@@ -103661,7 +103694,19 @@ ${truncatedDesc}`;
     external: {
       uri: canonicalUrl,
       title: title.substring(0, 500),
-      description: (description || "").substring(0, 1000)
+      description: (description || "").substring(0, 1000),
+      associatedRefs: [
+        {
+          $type: "com.atproto.repo.strongRef",
+          cid: documentRef.cid,
+          uri: documentRef.uri
+        },
+        {
+          $type: "com.atproto.repo.strongRef",
+          cid: publicationRef.cid,
+          uri: publicationRef.uri
+        }
+      ]
     }
   };
   if (coverImage) {
@@ -104236,13 +104281,14 @@ var initCommand = import_cmd_ts3.command({
       }, { onCancel });
       s.start("Creating publication...");
       try {
-        publicationUri = await createPublication(agent, {
+        const publicationRef = await createPublication(agent, {
           url: siteConfig.siteUrl,
           name: publicationConfig.name,
           description: publicationConfig.description || undefined,
           iconPath: publicationConfig.iconPath || undefined,
           showInDiscover: publicationConfig.showInDiscover
         });
+        publicationUri = publicationRef.uri;
         s.stop(`Publication created: ${publicationUri}`);
       } catch (error) {
         s.stop("Failed to create publication");
@@ -104300,9 +104346,9 @@ var initCommand = import_cmd_ts3.command({
       siteUrl: siteConfig.siteUrl,
       contentDir: siteConfig.contentDir || "./content",
       imagesDir: siteConfig.imagesDir || undefined,
-      publicDir: siteConfig.publicDir || "./public",
-      outputDir: siteConfig.outputDir || "./dist",
-      pathPrefix: siteConfig.pathPrefix ?? "/posts",
+      publicDir: siteConfig.publicDir || DEFAULT_PUBLISHER_CONFIG.publicDir,
+      outputDir: siteConfig.outputDir || DEFAULT_PUBLISHER_CONFIG.outputDir,
+      pathPrefix: siteConfig.pathPrefix ?? DEFAULT_PUBLISHER_CONFIG.pathPrefix,
       publicationUri,
       pdsUrl,
       frontmatter: frontmatterMapping,
@@ -104312,7 +104358,7 @@ var initCommand = import_cmd_ts3.command({
     const configPath = path8.join(process.cwd(), "sequoia.json");
     await fs7.writeFile(configPath, configContent);
     R2.success(`Configuration saved to ${configPath}`);
-    const publicDir = siteConfig.publicDir || "./public";
+    const publicDir = siteConfig.publicDir || DEFAULT_PUBLISHER_CONFIG.publicDir;
     const resolvedPublicDir = path8.isAbsolute(publicDir) ? publicDir : path8.join(process.cwd(), publicDir);
     const wellKnownDir = path8.join(resolvedPublicDir, ".well-known");
     const wellKnownPath = path8.join(wellKnownDir, "site.standard.publication");
@@ -104370,7 +104416,7 @@ var injectCommand = import_cmd_ts4.command({
     }
     const config = await loadConfig(configPath);
     const configDir = path9.dirname(configPath);
-    const outputDir = outputDirArg || config.outputDir || "./dist";
+    const outputDir = outputDirArg || config.outputDir || DEFAULT_PUBLISHER_CONFIG.outputDir;
     const resolvedOutputDir = path9.isAbsolute(outputDir) ? outputDir : path9.join(configDir, outputDir);
     R2.info(`Scanning for HTML files in: ${resolvedOutputDir}`);
     const state = await loadState(configDir);
@@ -104426,26 +104472,20 @@ var injectCommand = import_cmd_ts4.command({
         continue;
       }
       let content = await fs8.readFile(htmlPath, "utf-8");
-      const linkTag = `<link rel="site.standard.document" href="${atUri}">`;
-      if (content.includes('rel="site.standard.document"')) {
-        alreadyHasCount++;
-        continue;
-      }
-      const headCloseIndex = content.indexOf("</head>");
-      if (headCloseIndex === -1) {
-        R2.warn(`  No </head> found in ${relativePath}, skipping`);
-        skippedCount++;
-        continue;
-      }
-      if (dryRun) {
-        R2.message(`  Would inject into: ${relativePath}`);
-        R2.message(`    ${linkTag}`);
-        injectedCount++;
-        continue;
+      const injected = injectLinkTags(dryRun, relativePath, content, atUri, config.publicationUri);
+      switch (injected) {
+        case 0 /* AlreadyPresent */:
+          alreadyHasCount++;
+          continue;
+        case 1 /* Skipped */:
+          skippedCount++;
+          continue;
+        case 2 /* Faked */:
+          injectedCount++;
+          continue;
+        default:
+          content = injected;
       }
-      const indent = "  ";
-      content = content.slice(0, headCloseIndex) + `${indent}${linkTag}
-${indent}` + content.slice(headCloseIndex);
       await fs8.writeFile(htmlPath, content);
       R2.success(`  Injected into: ${relativePath}`);
       injectedCount++;
@@ -104464,6 +104504,47 @@ Tip: Skipped files had no matching published post. This is normal for non-post p
     }
   }
 });
+function injectLinkTags(dryRun, relativePath, content, atUri, publicationUri) {
+  let documentLinkTag = `<link rel="site.standard.document" href="${atUri}">`;
+  let publicationLinkTag = `<link rel="site.standard.publication" href="${publicationUri}">`;
+  if (content.includes('rel="site.standard.document"')) {
+    documentLinkTag = undefined;
+  }
+  if (content.includes('rel="site.standard.publication"')) {
+    publicationLinkTag = undefined;
+  }
+  if (!documentLinkTag && !publicationLinkTag) {
+    return 0 /* AlreadyPresent */;
+  }
+  const headCloseIndex = content.indexOf("</head>");
+  if (headCloseIndex === -1) {
+    R2.warn(`  No </head> found in ${relativePath}, skipping`);
+    return 1 /* Skipped */;
+  }
+  if (dryRun) {
+    R2.message(`  Would inject into: ${relativePath}`);
+    if (documentLinkTag) {
+      R2.message(`    ${documentLinkTag}`);
+    }
+    if (publicationLinkTag) {
+      R2.message(`    ${publicationLinkTag}`);
+    }
+    return 2 /* Faked */;
+  }
+  const indent = "  ";
+  const after = content.slice(headCloseIndex);
+  content = content.slice(0, headCloseIndex);
+  if (documentLinkTag) {
+    content += `${indent}${documentLinkTag}
+${indent}`;
+  }
+  if (publicationLinkTag) {
+    content += `${indent}${publicationLinkTag}
+${indent}`;
+  }
+  content += after;
+  return content;
+}
 
 // src/commands/login.ts
 import * as http from "node:http";
@@ -104725,6 +104806,9 @@ async function syncStateFromPDS(agent, config, configDir, options = {}) {
     postsByPath.set(postPath, post);
   }
   const state = await loadState(configDir);
+  if (!state.publication) {
+    state.publication = await syncPublication(agent, config.publicationUri, quiet);
+  }
   let matchedCount = 0;
   let unmatchedCount = 0;
   let frontmatterUpdatesApplied = 0;
@@ -104817,6 +104901,19 @@ Dry run complete. No changes made.`);
   }
   return { state, matchedCount, unmatchedCount, frontmatterUpdatesApplied };
 }
+async function syncPublication(agent, publicationUri, quiet) {
+  const publicationRef = await getPublication(agent, publicationUri);
+  if (!publicationRef) {
+    if (!quiet) {
+      R2.error(`Publication ${publicationUri} not found. Update your publication record and try again.`);
+    }
+    process.exit(1);
+  }
+  return {
+    cid: publicationRef.cid,
+    uri: publicationRef.uri
+  };
+}
 
 // src/commands/publish.ts
 var publishCommand = import_cmd_ts6.command({
@@ -104842,7 +104939,7 @@ var publishCommand = import_cmd_ts6.command({
   handler: async ({ force, dryRun, verbose }) => {
     const configPath = await findConfig();
     if (!configPath) {
-      R2.error("No publisher.config.ts found. Run 'publisher init' first.");
+      R2.error(`No ${CONFIG_FILENAME} found. Run 'sequoia init' first.`);
       process.exit(1);
     }
     const config = await loadConfig(configPath);
@@ -104901,7 +104998,7 @@ var publishCommand = import_cmd_ts6.command({
     let state = await loadState(configDir);
     const s = Ie();
     let agent;
-    if (config.autoSync !== false && Object.keys(state.posts).length === 0 && !dryRun) {
+    if (config.autoSync !== false && (!state.publication || Object.keys(state.posts).length === 0) && !dryRun) {
       const connectingTo = credentials.type === "oauth" ? credentials.handle : credentials.pdsUrl;
       s.start(`Connecting as ${connectingTo}...`);
       try {
@@ -104979,10 +105076,14 @@ ${postsToPublish.length} posts to publish:
     const maxAgeDays = config.bluesky?.maxAgeDays ?? 7;
     const cutoffDate = new Date;
     cutoffDate.setDate(cutoffDate.getDate() - maxAgeDays);
+    let isValid = true;
     for (const { post, action, reason } of postsToPublish) {
       const icon = action === "create" ? "+" : "~";
       const relativeFilePath = path12.relative(configDir, post.filePath);
       const existingBskyPostRef = state.posts[relativeFilePath]?.bskyPostRef;
+      if (post.frontmatter.ogImage) {
+        post.coverImagePath = await resolveImagePath(post.frontmatter.ogImage, imagesDir, contentDir);
+      }
       let bskyNote = "";
       if (blueskyEnabled) {
         if (existingBskyPostRef) {
@@ -105003,6 +105104,11 @@ ${postsToPublish.length} posts to publish:
  ${config.siteUrl}${postPath}`;
       }
       R2.message(`  ${icon} ${post.frontmatter.title} (${reason})${bskyNote}${postUrl}`);
+      const postValid = await validatePost(post);
+      isValid &&= postValid;
+    }
+    if (!isValid) {
+      return;
     }
     if (dryRun) {
       if (blueskyEnabled) {
@@ -105025,6 +105131,9 @@ Dry run complete. No changes made.`);
         process.exit(1);
       }
     }
+    if (!state.publication) {
+      state.publication = await syncPublication(agent, config.publicationUri, false);
+    }
     let publishedCount = 0;
     let updatedCount = 0;
     let errorCount = 0;
@@ -105033,35 +105142,32 @@ Dry run complete. No changes made.`);
       s.start(`Publishing: ${post.frontmatter.title}`);
       try {
         let coverImage;
-        if (post.frontmatter.ogImage) {
-          const imagePath = await resolveImagePath(post.frontmatter.ogImage, imagesDir, contentDir);
-          if (imagePath) {
-            R2.info(`  Uploading cover image: ${path12.basename(imagePath)}`);
-            coverImage = await uploadImage(agent, imagePath);
-            if (coverImage) {
-              R2.info(`  Uploaded image blob: ${coverImage.ref.$link}`);
-            }
-          } else {
-            R2.warn(`  Cover image not found: ${post.frontmatter.ogImage}`);
+        if (post.coverImagePath) {
+          R2.info(`  Uploading cover image: ${path12.basename(post.coverImagePath)}`);
+          coverImage = await uploadImage(agent, post.coverImagePath);
+          if (coverImage) {
+            R2.info(`  Uploaded image blob: ${coverImage.ref.$link}`);
           }
+        } else {
+          R2.warn(`  Cover image not found: ${post.frontmatter.ogImage}`);
         }
-        let atUri;
+        let documentRef;
         let contentForHash;
         let bskyPostRef;
         const relativeFilePath = path12.relative(configDir, post.filePath);
         const existingBskyPostRef = state.posts[relativeFilePath]?.bskyPostRef;
         if (action === "create") {
-          atUri = await createDocument(agent, post, config, coverImage);
-          s.stop(`Created: ${atUri}`);
-          const updatedContent = updateFrontmatterWithAtUri(post.rawContent, atUri);
+          documentRef = await createDocument(agent, post, config, coverImage);
+          s.stop(`Created: ${documentRef.uri}`);
+          const updatedContent = updateFrontmatterWithAtUri(post.rawContent, documentRef.uri);
           await fs15.writeFile(post.filePath, updatedContent);
           R2.info(`  Updated frontmatter in ${path12.basename(post.filePath)}`);
           contentForHash = updatedContent;
           publishedCount++;
         } else {
-          atUri = post.frontmatter.atUri;
-          await updateDocument(agent, post, atUri, config, coverImage);
-          s.stop(`Updated: ${atUri}`);
+          const atUri = post.frontmatter.atUri;
+          documentRef = await updateDocument(agent, post, atUri, config, coverImage);
+          s.stop(`Updated: ${documentRef.uri}`);
           contentForHash = post.rawContent;
           updatedCount++;
         }
@@ -105081,10 +105187,12 @@ Dry run complete. No changes made.`);
                   description: post.frontmatter.description,
                   bskyPost: post.frontmatter.bskyPost,
                   canonicalUrl,
+                  documentRef,
+                  publicationRef: state.publication,
                   coverImage,
                   publishedAt: post.frontmatter.publishDate
                 });
-                await addBskyPostRefToDocument(agent, atUri, bskyPostRef);
+                await addBskyPostRefToDocument(agent, documentRef.uri, bskyPostRef);
                 R2.info(`  Created Bluesky post: ${bskyPostRef.uri}`);
                 bskyPostCount++;
               } catch (bskyError) {
@@ -105097,7 +105205,7 @@ Dry run complete. No changes made.`);
         const contentHash = await getContentHash(contentForHash);
         state.posts[relativeFilePath] = {
           contentHash,
-          atUri,
+          atUri: documentRef.uri,
           lastPublished: new Date().toISOString(),
           slug: post.slug,
           bskyPostRef
@@ -105122,6 +105230,16 @@ Dry run complete. No changes made.`);
     }
   }
 });
+async function validatePost(post) {
+  if (post.coverImagePath) {
+    const stat3 = await fs15.stat(post.coverImagePath);
+    if (stat3.size >= COVER_IMAGE_MAX_SIZE) {
+      R2.error(`  Cover image "${post.coverImagePath}" must be less than 1MB`);
+      return false;
+    }
+  }
+  return true;
+}
 
 // src/commands/sync.ts
 var import_cmd_ts7 = __toESM(require_cjs(), 1);
@@ -105261,7 +105379,7 @@ async function updateConfigFlow(config, configPath) {
   const configSummary = [
     `Site URL: ${config.siteUrl}`,
     `Content Dir: ${config.contentDir}`,
-    `Path Prefix: ${config.pathPrefix ?? "/posts"}`,
+    `Path Prefix: ${config.pathPrefix ?? DEFAULT_PUBLISHER_CONFIG.pathPrefix}`,
     `Publication URI: ${config.publicationUri}`,
     config.imagesDir ? `Images Dir: ${config.imagesDir}` : null,
     config.outputDir ? `Output Dir: ${config.outputDir}` : null,
@@ -105345,7 +105463,7 @@ async function editSiteSettings(config) {
   }));
   const pathPrefix = exitOnCancel(await Qt({
     message: "URL path prefix for posts:",
-    initialValue: config.pathPrefix ?? "/posts"
+    initialValue: config.pathPrefix ?? DEFAULT_PUBLISHER_CONFIG.pathPrefix
   }));
   return {
     ...config,
@@ -105368,11 +105486,11 @@ async function editDirectories(config) {
   }));
   const publicDir = exitOnCancel(await Qt({
     message: "Public/static directory:",
-    initialValue: config.publicDir || "./public"
+    initialValue: config.publicDir || DEFAULT_PUBLISHER_CONFIG.publicDir
   }));
   const outputDir = exitOnCancel(await Qt({
     message: "Build output directory:",
-    initialValue: config.outputDir || "./dist"
+    initialValue: config.outputDir || DEFAULT_PUBLISHER_CONFIG.outputDir
   }));
   return {
     ...config,
@@ -105459,7 +105577,7 @@ async function editAdvanced(config) {
   }));
   const publishContent = exitOnCancel(await Mt2({
     message: "Publish the post content on the standard.site document?",
-    initialValue: config.publishContent ?? true
+    initialValue: config.publishContent ?? DEFAULT_PUBLISHER_CONFIG.publishContent
   }));
   const textContentField = exitOnCancel(await Qt({
     message: "Frontmatter field for textContent (leave empty to use markdown body):",
@@ -105474,7 +105592,7 @@ async function editAdvanced(config) {
     removeIndexFromSlug: removeIndexFromSlug || undefined,
     stripDatePrefix: stripDatePrefix || undefined,
     textContentField: textContentField || undefined,
-    publishContent: publishContent ?? true
+    publishContent: publishContent ?? DEFAULT_PUBLISHER_CONFIG.publishContent
   };
 }
 async function editBluesky(config) {
@@ -105670,7 +105788,7 @@ Publish evergreen content to the ATmosphere
 
 > https://tangled.org/stevedylan.dev/sequoia
 	`,
-  version: "0.5.6",
+  version: "0.5.7",
   cmds: {
     add: addCommand,
     auth: authCommand,
@@ -105683,3 +105801,6 @@ Publish evergreen content to the ATmosphere
   }
 });
 import_cmd_ts9.run(app, process.argv.slice(2));
+
+//# debugId=0DA3B1F9984712F664756E2164756E21
+//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "sequoia-cli",
-	"version": "0.5.6",
+	"version": "0.5.7",
 	"type": "module",
 	"bin": {
 		"sequoia": "dist/index.js"
@@ -17,13 +17,13 @@
 	"scripts": {
 		"lint": "biome lint --write",
 		"format": "biome format --write",
-		"build": "bun build src/index.ts --target node --outdir dist && mkdir -p dist/components && cp src/components/*.js dist/components/",
+		"build": "bun build src/index.ts --target node --outdir dist --sourcemap && mkdir -p dist/components && cp src/components/*.js dist/components/",
 		"test": "bun test",
 		"dev": "bun run build && bun link",
-		"deploy": "bun run build && bun publish"
+		"deploy": "bun run build && rm -f dist/*.map && bun publish"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.3.13",
+		"@biomejs/biome": "2.3.6",
 		"@types/js-yaml": "^4.0.9",
 		"@types/mime-types": "^3.0.1",
 		"@types/node": "^20"