blogwright-pds 0.1.0

package/dist/sync.js

@@ -0,0 +1,167 @@
+import { join } from 'node:path';
+import { FileNotFoundError, } from 'blogwright-core';
+import { listPublishablePosts } from './content.js';
+import { postPath, tidFromPath } from './rkey.js';
+import { rkeyFromUri } from './xrpc.js';
+export const PUBLICATION_COLLECTION = 'site.standard.publication';
+export const DOCUMENT_COLLECTION = 'site.standard.document';
+/**
+ * Repo-relative path of the standard.site well-known file `pds init` writes;
+ * its segment under the public dir is protocol-fixed. The companion
+ * atproto.json path comes straight from `config.paths.atprotoJson`.
+ */
+export function wellKnownPath(cfg) {
+    return `${cfg.paths.publicDir}/.well-known/site.standard.publication`;
+}
+export function requirePdsConfig(ctx) {
+    if (!ctx.config.pds) {
+        throw new Error('config has no "pds" section — add it to config/production.jsonc');
+    }
+    return ctx.config.pds;
+}
+/** Read the atproto.json site file; undefined when the site has not been initialised. */
+async function readAtprotoSiteConfig(fs, repoRoot, cfg) {
+    let text;
+    try {
+        text = await fs.readText(join(repoRoot, cfg.paths.atprotoJson));
+    }
+    catch (err) {
+        if (err instanceof FileNotFoundError)
+            return undefined;
+        throw err;
+    }
+    const parsed = JSON.parse(text);
+    if (!parsed.did || !parsed.publicationUri)
+        return undefined;
+    return { did: parsed.did, publicationUri: parsed.publicationUri };
+}
+/** Read the committed well-known file; undefined when absent. */
+export async function readWellKnownUri(fs, repoRoot, cfg) {
+    try {
+        const text = await fs.readText(join(repoRoot, wellKnownPath(cfg)));
+        return text.trim() || undefined;
+    }
+    catch (err) {
+        if (err instanceof FileNotFoundError)
+            return undefined;
+        throw err;
+    }
+}
+/**
+ * The publication record as config + domain describe it. `siteUrl` must have
+ * no trailing slash — standard.site appends the document `path`, which already
+ * starts with one.
+ */
+export function publicationRecord(pds, siteUrl) {
+    return {
+        $type: PUBLICATION_COLLECTION,
+        url: siteUrl,
+        name: pds.name,
+        ...(pds.description ? { description: pds.description } : {}),
+        preferences: { showInDiscover: true },
+    };
+}
+/** The document record for a post. */
+export function documentRecord(publicationUri, post) {
+    return {
+        $type: DOCUMENT_COLLECTION,
+        site: publicationUri,
+        title: post.title,
+        path: postPath(post.slug),
+        description: post.description,
+        publishedAt: post.pubDate.toISOString(),
+    };
+}
+/** Fields compared to decide whether an existing record needs a put. */
+const DOCUMENT_DIFF_FIELDS = ['site', 'title', 'path', 'description', 'publishedAt'];
+const PUBLICATION_DIFF_FIELDS = ['url', 'name', 'description'];
+function recordsDiffer(existing, desired, fields) {
+    return fields.some((f) => existing[f] !== desired[f]);
+}
+/** Put the publication record when it differs from (or is missing at) its rkey. */
+export async function syncPublication(client, desired, publicationUri) {
+    const rkey = rkeyFromUri(publicationUri);
+    const existing = await client.getRecord(PUBLICATION_COLLECTION, rkey);
+    if (existing && !recordsDiffer(existing.value, desired, PUBLICATION_DIFF_FIELDS)) {
+        return 'unchanged';
+    }
+    // Preserve preferences the owner set out-of-band (e.g. showInDiscover off in
+    // a standard.site client) — a config-driven update must not clobber them.
+    const next = existing && existing.value.preferences !== undefined
+        ? { ...desired, preferences: existing.value.preferences }
+        : desired;
+    await client.putRecord(PUBLICATION_COLLECTION, rkey, next);
+    return 'updated';
+}
+/**
+ * Reconcile document records against the local posts: create missing rkeys,
+ * update drifted ones, report (never delete) orphans. Adapted from
+ * mastrojs/atproto createOrUpdateDocuments (MIT) onto the local XRPC client.
+ */
+export async function syncDocuments(client, posts, publicationUri) {
+    const existing = new Map();
+    for (const record of await client.listRecords(DOCUMENT_COLLECTION)) {
+        if (record.value.site === publicationUri)
+            existing.set(rkeyFromUri(record.uri), record);
+    }
+    const summary = {
+        created: [],
+        updated: [],
+        unchanged: 0,
+        orphans: [],
+    };
+    const localRkeys = new Set();
+    for (const post of posts) {
+        const rkey = tidFromPath(postPath(post.slug));
+        if (localRkeys.has(rkey))
+            throw new Error(`rkey collision for slug "${post.slug}"`);
+        localRkeys.add(rkey);
+        const desired = documentRecord(publicationUri, post);
+        const current = existing.get(rkey);
+        if (!current) {
+            await client.putRecord(DOCUMENT_COLLECTION, rkey, desired);
+            summary.created.push(post.slug);
+        }
+        else if (recordsDiffer(current.value, desired, DOCUMENT_DIFF_FIELDS)) {
+            await client.putRecord(DOCUMENT_COLLECTION, rkey, desired);
+            summary.updated.push(post.slug);
+        }
+        else {
+            summary.unchanged += 1;
+        }
+    }
+    for (const rkey of existing.keys()) {
+        if (!localRkeys.has(rkey))
+            summary.orphans.push(rkey);
+    }
+    return summary;
+}
+/**
+ * Full reconcile: OAuth session restore against the PDS, publication +
+ * documents. The caller decides when this may run (production only) and
+ * whether a failure is fatal.
+ */
+export async function syncPds(ctx, repoRoot, openRepo) {
+    const pds = requirePdsConfig(ctx);
+    const atprotoJson = ctx.config.paths.atprotoJson;
+    const site = await readAtprotoSiteConfig(ctx.ports.fs, repoRoot, ctx.config);
+    if (!site) {
+        throw new Error(`${atprotoJson} is not initialised — run \`blogwright pds init\` first`);
+    }
+    const wellKnown = await readWellKnownUri(ctx.ports.fs, repoRoot, ctx.config);
+    if (wellKnown !== site.publicationUri) {
+        throw new Error(`${wellKnownPath(ctx.config)} (${wellKnown ?? 'missing'}) does not match ${atprotoJson} ` +
+            `(${site.publicationUri}) — re-run \`blogwright pds init\``);
+    }
+    if (!ctx.domain)
+        throw new Error('pds sync requires a configured domain');
+    const { did, repo } = await openRepo(ctx);
+    if (did !== site.did) {
+        throw new Error(`session DID ${did} does not match ${atprotoJson} DID ${site.did}`);
+    }
+    const posts = await listPublishablePosts(ctx.ports.fs, repoRoot, ctx.config.paths.content);
+    const publication = await syncPublication(repo, publicationRecord(pds, `https://${ctx.domain}`), site.publicationUri);
+    const documents = await syncDocuments(repo, posts, site.publicationUri);
+    return { publication, ...documents };
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"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"}

package/dist/test-support.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Test-only PdsContext factory. Builds a real, fully-typed context over
+ * in-memory adapters: file access hits a Map-backed FileSystem, and every
+ * secrets-client method a test has not overridden fails fast at the transport.
+ * Tests substitute behaviour here — at the ports — never by casting.
+ */
+import { type FileSystem, type OpsConfig, type SecretsManagerClient, type Terminal } from 'blogwright-core';
+import type { PdsContext, PdsLogger } from './context.js';
+export interface TestContextOverrides {
+    env?: string | undefined;
+    domain?: string | undefined;
+    config?: Partial<OpsConfig> | undefined;
+    clients?: {
+        secrets?: Partial<SecretsManagerClient> | undefined;
+    } | undefined;
+    logger?: Partial<PdsLogger> | undefined;
+    ports?: {
+        fs?: FileSystem | undefined;
+        terminal?: Terminal | undefined;
+    } | undefined;
+}
+/** Create a unique real-disk directory for a node-adapter integration test. */
+export declare function makeTempDir(prefix: string): Promise<string>;
+/** Delete a directory created by {@link makeTempDir}. */
+export declare function removeTempDir(dir: string): Promise<void>;
+/**
+ * Build a complete PdsContext for tests. Defaults: env "test", site "example",
+ * config merged over DEFAULT_CONFIG, a fresh in-memory FileSystem, a silent
+ * terminal, a secrets client that fails fast until overridden, and a silent
+ * logger.
+ */
+export declare function createTestContext(overrides?: TestContextOverrides): PdsContext;

package/dist/test-support.js

@@ -0,0 +1,74 @@
+/**
+ * Test-only PdsContext factory. Builds a real, fully-typed context over
+ * in-memory adapters: file access hits a Map-backed FileSystem, and every
+ * secrets-client method a test has not overridden fails fast at the transport.
+ * Tests substitute behaviour here — at the ports — never by casting.
+ */
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createClients, createMemoryFileSystem, mergeConfig, staticCredentials, } from 'blogwright-core';
+const rejectAllTransport = async (req) => {
+    throw new Error(`unexpected AWS request in test: ${req.method} ${req.url} — override the client method on createTestContext`);
+};
+/**
+ * Layer test overrides over a real client so untouched methods still fail fast.
+ * Overrides must be plain objects of methods (own properties) — a class
+ * instance's prototype methods would not be copied.
+ */
+function testSecrets(region, overrides) {
+    const base = createClients({
+        region,
+        credentials: staticCredentials({ accessKeyId: 'test', secretAccessKey: 'test' }),
+        transport: rejectAllTransport,
+    }).secrets;
+    if (!overrides)
+        return base;
+    return Object.assign(Object.create(base), overrides);
+}
+/** Silent, non-interactive terminal; a prompt in a test is a missing override. */
+const silentTerminal = {
+    isInteractive: false,
+    write: () => undefined,
+    error: () => undefined,
+    status: () => undefined,
+    question: async (prompt) => {
+        throw new Error(`unexpected terminal prompt in test: ${prompt} — override ports.terminal on createTestContext`);
+    },
+};
+const NOOP_LOGGER = {
+    info: () => undefined,
+    step: () => undefined,
+    ok: () => undefined,
+    warn: () => undefined,
+    error: () => undefined,
+};
+/** Create a unique real-disk directory for a node-adapter integration test. */
+export async function makeTempDir(prefix) {
+    return mkdtemp(join(tmpdir(), `${prefix}-`));
+}
+/** Delete a directory created by {@link makeTempDir}. */
+export async function removeTempDir(dir) {
+    await rm(dir, { recursive: true, force: true });
+}
+/**
+ * Build a complete PdsContext for tests. Defaults: env "test", site "example",
+ * config merged over DEFAULT_CONFIG, a fresh in-memory FileSystem, a silent
+ * terminal, a secrets client that fails fast until overridden, and a silent
+ * logger.
+ */
+export function createTestContext(overrides = {}) {
+    const config = mergeConfig({ siteName: 'example', ...overrides.config });
+    return {
+        env: overrides.env ?? 'test',
+        domain: overrides.domain,
+        config,
+        clients: { secrets: testSecrets(config.region, overrides.clients?.secrets) },
+        ports: {
+            fs: overrides.ports?.fs ?? createMemoryFileSystem(),
+            terminal: overrides.ports?.terminal ?? silentTerminal,
+        },
+        logger: { ...NOOP_LOGGER, ...overrides.logger },
+    };
+}
+//# sourceMappingURL=test-support.js.map

package/dist/test-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-support.js","sourceRoot":"","sources":["../src/test-support.ts"],"names":[],"mappings":"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"}

package/dist/xrpc.d.ts

@@ -0,0 +1,43 @@
+/** Minimal AT Protocol XRPC client — just the calls the standard.site sync needs. */
+export interface PdsRecord {
+    uri: string;
+    cid: string;
+    value: Record<string, unknown>;
+}
+/**
+ * Sends one XRPC request. `pathname` is relative to the account's PDS; auth
+ * (OAuth DPoP headers, nonce retries) is the transport's job — in production
+ * this is the bound `fetchHandler` of an OAuthSession (see oauth.ts).
+ */
+export type XrpcTransport = (pathname: string, init?: RequestInit) => Promise<Response>;
+/** A structured error raised when the PDS returns a non-2xx response. */
+export declare class XrpcError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    constructor(opts: {
+        code: string;
+        message: string;
+        statusCode: number;
+    });
+    get isNotFound(): boolean;
+}
+/** rkey of a record, from the trailing segment of its AT-URI. */
+export declare function rkeyFromUri(uri: string): string;
+export declare class PdsClient {
+    private readonly did;
+    private readonly transport;
+    constructor(did: string, transport: XrpcTransport);
+    private call;
+    /** All records in a collection for the account repo (cursor-paginated). */
+    listRecords(collection: string): Promise<PdsRecord[]>;
+    /** Fetch one record; undefined when it does not exist. */
+    getRecord(collection: string, rkey: string): Promise<PdsRecord | undefined>;
+    /** Create a record; the PDS assigns the rkey unless one is given. */
+    createRecord(collection: string, record: Record<string, unknown>, rkey?: string): Promise<{
+        uri: string;
+    }>;
+    /** Create or overwrite the record at a known rkey. */
+    putRecord(collection: string, rkey: string, record: Record<string, unknown>): Promise<{
+        uri: string;
+    }>;
+}

package/dist/xrpc.js

@@ -0,0 +1,104 @@
+/** Minimal AT Protocol XRPC client — just the calls the standard.site sync needs. */
+/** A structured error raised when the PDS returns a non-2xx response. */
+export class XrpcError extends Error {
+    code;
+    statusCode;
+    constructor(opts) {
+        super(`pds: ${opts.code} — ${opts.message} (HTTP ${opts.statusCode})`);
+        this.name = 'XrpcError';
+        this.code = opts.code;
+        this.statusCode = opts.statusCode;
+    }
+    get isNotFound() {
+        return this.statusCode === 404 || /RecordNotFound/i.test(this.code);
+    }
+}
+/** rkey of a record, from the trailing segment of its AT-URI. */
+export function rkeyFromUri(uri) {
+    const rkey = uri.split('/').pop();
+    if (!rkey)
+        throw new Error(`cannot extract rkey from AT-URI "${uri}"`);
+    return rkey;
+}
+const LIST_PAGE_SIZE = 100;
+export class PdsClient {
+    did;
+    transport;
+    constructor(did, transport) {
+        this.did = did;
+        this.transport = transport;
+    }
+    async call(nsid, opts) {
+        const query = new URLSearchParams(opts.params ?? {}).toString();
+        const res = await this.transport(`/xrpc/${nsid}${query ? `?${query}` : ''}`, {
+            method: opts.method,
+            ...(opts.body
+                ? { headers: { 'content-type': 'application/json' }, body: JSON.stringify(opts.body) }
+                : {}),
+        });
+        const text = await res.text();
+        let parsed = {};
+        try {
+            parsed = text ? JSON.parse(text) : {};
+        }
+        catch {
+            /* non-JSON error body — fall through with the raw text as message */
+        }
+        if (!res.ok) {
+            throw new XrpcError({
+                code: typeof parsed.error === 'string' ? parsed.error : 'UnknownError',
+                message: typeof parsed.message === 'string' ? parsed.message : text.slice(0, 200),
+                statusCode: res.status,
+            });
+        }
+        return parsed;
+    }
+    /** All records in a collection for the account repo (cursor-paginated). */
+    async listRecords(collection) {
+        const records = [];
+        let cursor;
+        do {
+            const out = await this.call('com.atproto.repo.listRecords', {
+                method: 'GET',
+                params: {
+                    repo: this.did,
+                    collection,
+                    limit: String(LIST_PAGE_SIZE),
+                    ...(cursor ? { cursor } : {}),
+                },
+            });
+            records.push(...(out.records ?? []));
+            cursor = out.records?.length ? out.cursor : undefined;
+        } while (cursor);
+        return records;
+    }
+    /** Fetch one record; undefined when it does not exist. */
+    async getRecord(collection, rkey) {
+        try {
+            return await this.call('com.atproto.repo.getRecord', {
+                method: 'GET',
+                params: { repo: this.did, collection, rkey },
+            });
+        }
+        catch (err) {
+            if (err instanceof XrpcError && err.isNotFound)
+                return undefined;
+            throw err;
+        }
+    }
+    /** Create a record; the PDS assigns the rkey unless one is given. */
+    async createRecord(collection, record, rkey) {
+        return this.call('com.atproto.repo.createRecord', {
+            method: 'POST',
+            body: { repo: this.did, collection, ...(rkey ? { rkey } : {}), record },
+        });
+    }
+    /** Create or overwrite the record at a known rkey. */
+    async putRecord(collection, rkey, record) {
+        return this.call('com.atproto.repo.putRecord', {
+            method: 'POST',
+            body: { repo: this.did, collection, rkey, record },
+        });
+    }
+}
+//# sourceMappingURL=xrpc.js.map

package/dist/xrpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xrpc.js","sourceRoot":"","sources":["../src/xrpc.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "blogwright-pds",
+  "version": "0.1.0",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./rkey": {
+      "types": "./dist/rkey.d.ts",
+      "default": "./dist/rkey.js"
+    }
+  },
+  "dependencies": {
+    "@atproto/oauth-client-node": "^0.4.7",
+    "blogwright-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "oxlint": "^1.72.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9"
+  },
+  "description": "standard.site (AT Protocol) publishing for blogwright: OAuth client, PDS record sync, and URL-derived rkeys",
+  "keywords": [
+    "atproto",
+    "standard.site",
+    "pds",
+    "oauth"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/antstanley/blogwright.git"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
+    "lint": "oxlint src",
+    "test": "vitest run"
+  }
+}