n8n-nodes-atproto 0.2.0 → 0.2.2

package/README.md

@@ -97,6 +97,22 @@ Worked examples of common workflows. Each one is a chain of nodes — names in *
 
 **Convenience fields:** the upload also exposes `cid` / `mimeType` / `size` at the top level, so `{{ $json.cid }}` works without drilling into `blob.ref.$link`.
 
+### Post a Bluesky link with an embed card
+
+The **Bluesky** node's Post → Create operation builds an `app.bsky.embed.external` link card for you. Set **External Link URL** under Options; with **Auto-Scrape Link Metadata** on (the default) it fetches the page's OpenGraph title, description and thumbnail.
+
+```
+[Bluesky: Post → Create]
+  Text: Great read 👇
+  Options:
+    External Link URL: https://example.com/article
+    Auto-Scrape Link Metadata: ✅      ← fetches og:title / og:description / og:image
+```
+
+- **Overrides:** set **Link Title** / **Link Description** to replace the scraped text, or **Link Thumbnail Binary Property** to use your own image instead of the scraped one.
+- **Scrape failures are fatal:** if auto-scrape is on and the page can't be fetched, the item errors — enable *Continue On Fail* to tolerate it. The thumbnail itself is best-effort: the card still posts if the image is missing or exceeds Bluesky's 1 MB blob limit.
+- A post carries **either** an image embed **or** a link card, not both.
+
 ### Round-trip a blob (download, transform, re-upload)
 
 Mirror a blob from another user's repo into your own. Useful for archival, format conversion, or re-hosting.

package/dist/_chunks/shared.js

@@ -37867,6 +37867,12 @@ async function searchCollections(filter) {
 	}
 }
 //#endregion
+Object.defineProperty(exports, "Agent", {
+	enumerable: true,
+	get: function() {
+		return Agent;
+	}
+});
 Object.defineProperty(exports, "AtUri", {
 	enumerable: true,
 	get: function() {

package/dist/nodes/Atproto/Atproto.node.js

@@ -3,6 +3,16 @@ const require_shared = require("../../_chunks/shared.js");
 let n8n_workflow = require("n8n-workflow");
 //#region nodes/Atproto/operations.ts
 /**
+* CRUD operations for AT Protocol records.
+*
+* Each function wraps an XRPC call via the authenticated Agent.
+* - `$type` is auto-injected from the collection NSID.
+* - `createdAt` is auto-injected as ISO string when the schema requires it
+*   (Phase 1: always inject; Phase 2 will make it schema-conditional).
+* - `repo` defaults to the authenticated user's DID for write operations.
+*   Get/List accept an optional `repo` to read other users' public records.
+*/
+/**
 * Injects `$type` if not already present.
 */
 function ensure$type(record, collection) {
@@ -34,6 +44,53 @@ async function resolveActorToDid(agent, actor) {
 	return (await agent.com.atproto.identity.resolveHandle({ handle })).data.did;
 }
 /**
+* Map a DID to the URL of its DID document. Supports did:plc (PLC directory)
+* and did:web.
+*/
+function didDocumentUrl(did) {
+	if (did.startsWith("did:plc:")) return `https://plc.directory/${did}`;
+	if (did.startsWith("did:web:")) {
+		const [host, ...path] = did.slice(8).split(":").map(decodeURIComponent);
+		return path.length === 0 ? `https://${host}/.well-known/did.json` : `https://${host}/${path.join("/")}/did.json`;
+	}
+	throw new Error(`Unsupported DID method: ${did}`);
+}
+/**
+* Resolve a DID's hosting PDS endpoint from its DID document.
+*/
+async function resolvePdsEndpoint(did) {
+	const res = await fetch(didDocumentUrl(did));
+	if (!res.ok) throw new Error(`Failed to resolve DID ${did}: HTTP ${res.status}`);
+	const endpoint = (await res.json()).service?.find((s) => s.id.endsWith("#atproto_pds"))?.serviceEndpoint;
+	if (typeof endpoint !== "string" || endpoint.length === 0) throw new Error(`No PDS endpoint found in DID document for ${did}`);
+	return endpoint;
+}
+/**
+* Resolve the repo to read from into a DID plus an Agent pointed at the PDS
+* that hosts it. Repo-hosting reads (getRecord, listRecords, getBlob,
+* listBlobs) must hit that PDS — the authenticated session's PDS only serves
+* its own repos and answers "Could not find repo" for any other.
+*
+* The session agent is reused for the user's own repo (already on the correct
+* PDS); foreign repos get an unauthenticated Agent, since these reads are
+* public.
+*/
+async function resolveReadTarget(agent, actor) {
+	if (!actor || actor.trim() === "") return {
+		did: getOwnDid(agent),
+		agent
+	};
+	const did = await resolveActorToDid(agent, actor);
+	if (did === agent.did) return {
+		did,
+		agent
+	};
+	return {
+		did,
+		agent: new require_shared.Agent(await resolvePdsEndpoint(did))
+	};
+}
+/**
 * Walk schema properties and inject `const` values for any field the user
 * left empty. This ensures constant fields are always set correctly even if
 * the readOnly UI is bypassed (e.g. via JSON mode or expressions).
@@ -69,9 +126,9 @@ async function createRecord(agent, params) {
 * Optionally reads from a different repo (defaults to self).
 */
 async function getRecord(agent, params) {
-	const repo = params.repo ?? getOwnDid(agent);
-	const data = (await agent.com.atproto.repo.getRecord({
-		repo,
+	const { did, agent: reader } = await resolveReadTarget(agent, params.repo);
+	const data = (await reader.com.atproto.repo.getRecord({
+		repo: did,
 		collection: params.collection,
 		rkey: params.rkey
 	})).data;
@@ -119,9 +176,9 @@ async function deleteRecord(agent, params) {
 * Returns one page per execution; chain nodes or loop to paginate.
 */
 async function listRecords(agent, params) {
-	const repo = params.repo ?? getOwnDid(agent);
-	const data = (await agent.com.atproto.repo.listRecords({
-		repo,
+	const { did, agent: reader } = await resolveReadTarget(agent, params.repo);
+	const data = (await reader.com.atproto.repo.listRecords({
+		repo: did,
 		collection: params.collection,
 		limit: params.limit,
 		cursor: params.cursor
@@ -160,8 +217,9 @@ async function uploadBlob(agent, params) {
 * MIME type (read from the response headers).
 */
 async function getBlob(agent, params) {
-	const response = await agent.com.atproto.sync.getBlob({
-		did: params.did,
+	const { did, agent: reader } = await resolveReadTarget(agent, params.did);
+	const response = await reader.com.atproto.sync.getBlob({
+		did,
 		cid: params.cid
 	});
 	const buffer = Buffer.from(response.data);
@@ -179,8 +237,8 @@ async function getBlob(agent, params) {
 * `did` defaults to the authenticated user.
 */
 async function listBlobs(agent, params = {}) {
-	const did = params.did ?? getOwnDid(agent);
-	const response = await agent.com.atproto.sync.listBlobs({
+	const { did, agent: reader } = await resolveReadTarget(agent, params.did);
+	const response = await reader.com.atproto.sync.listBlobs({
 		did,
 		limit: params.limit,
 		cursor: params.cursor,