@hatk/hatk 0.0.1-alpha.0

package/dist/vite-plugin.js

@@ -0,0 +1,86 @@
+import { spawn } from 'node:child_process';
+import { resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+export function hatk(opts) {
+    const devPort = 3000;
+    const backendPort = opts?.port ?? devPort + 1;
+    const issuer = `http://127.0.0.1:${devPort}`;
+    let serverProcess = null;
+    return {
+        name: 'vite-plugin-hatk',
+        config() {
+            const target = `http://127.0.0.1:${backendPort}`;
+            // changeOrigin: false preserves the original Host header so DPoP htu matches
+            const rule = { target, changeOrigin: false };
+            return {
+                server: {
+                    host: '127.0.0.1',
+                    port: devPort,
+                    proxy: {
+                        '/xrpc': rule,
+                        '/oauth/par': rule,
+                        '/oauth/token': rule,
+                        '/oauth/jwks': rule,
+                        '/oauth/authorize': rule,
+                        '/oauth/callback': {
+                            ...rule,
+                            // Only proxy the PDS callback (iss !== our issuer) to the backend.
+                            // The client-side callback (iss === our issuer) should reach the SPA.
+                            bypass(req) {
+                                const url = new URL(req.url, issuer);
+                                if (url.searchParams.get('iss') === issuer)
+                                    return req.url;
+                            },
+                        },
+                        '/oauth/client-metadata.json': rule,
+                        '/oauth-client-metadata.json': rule,
+                        '/.well-known': rule,
+                        '/info': rule,
+                        '/repos': rule,
+                        '/og': rule,
+                        '/admin': rule,
+                        '/_health': rule,
+                    },
+                },
+                test: {
+                    projects: [
+                        {
+                            test: {
+                                name: 'unit',
+                                include: ['test/feeds/**/*.test.ts', 'test/xrpc/**/*.test.ts'],
+                            },
+                        },
+                        {
+                            test: {
+                                name: 'integration',
+                                include: ['test/integration/**/*.test.ts'],
+                            },
+                        },
+                    ],
+                },
+            };
+        },
+        configureServer(server) {
+            const mainPath = resolve(import.meta.dirname, 'main.ts');
+            const watchDirs = ['xrpc', 'feeds', 'labels', 'jobs', 'setup', 'lexicons'].filter((d) => existsSync(d));
+            const watchArgs = watchDirs.flatMap((d) => ['--watch-path', d]);
+            serverProcess = spawn('npx', ['tsx', 'watch', ...watchArgs, mainPath, 'config.yaml'], {
+                stdio: 'inherit',
+                cwd: process.cwd(),
+                env: {
+                    ...process.env,
+                    PORT: String(backendPort),
+                    OAUTH_ISSUER: process.env.OAUTH_ISSUER || issuer,
+                },
+            });
+            server.httpServer?.on('close', () => {
+                serverProcess?.kill();
+                serverProcess = null;
+            });
+        },
+        buildEnd() {
+            serverProcess?.kill();
+            serverProcess = null;
+        },
+    };
+}

package/dist/xrpc-client.d.ts

@@ -0,0 +1,18 @@
+type ExtractParams<T> = T extends {
+    params: infer P;
+} ? P : Record<string, string>;
+type ExtractOutput<T> = T extends {
+    output: infer O;
+} ? O : T;
+interface ClientOptions {
+    fetch?: typeof globalThis.fetch;
+}
+export declare function createClient<S>(baseUrl: string, opts?: ClientOptions): {
+    query<K extends keyof S & string>(nsid: K, params?: ExtractParams<S[K]> & Record<string, unknown>): Promise<ExtractOutput<S[K]>>;
+    call<K extends keyof S & string>(nsid: K, input?: S[K] extends {
+        input: infer I;
+    } ? I : undefined, params?: ExtractParams<S[K]>): Promise<ExtractOutput<S[K]>>;
+    upload<K extends keyof S & string>(nsid: K, data: Blob | ArrayBuffer, contentType: string): Promise<ExtractOutput<S[K]>>;
+};
+export {};
+//# sourceMappingURL=xrpc-client.d.ts.map

package/dist/xrpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xrpc-client.d.ts","sourceRoot":"","sources":["../src/xrpc-client.ts"],"names":[],"mappings":"AAGA,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAClF,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,CAAC,CAAA;AAE7D,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB;UAuBzD,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,QAC9B,CAAC,WACE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrD,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAUpB,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,QAC7B,CAAC,UACC,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,CAAC,GAAG,SAAS,WAC9C,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;WAclB,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,QAC/B,CAAC,QACD,IAAI,GAAG,WAAW,eACX,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;EAalC"}

package/dist/xrpc-client.js

@@ -0,0 +1,54 @@
+// xrpc-client.ts — Typed XRPC client
+// Generic over a Schema type (auto-generated from lexicons).
+export function createClient(baseUrl, opts = {}) {
+    const fetchFn = opts.fetch || globalThis.fetch.bind(globalThis);
+    function buildQs(params) {
+        if (!params || typeof params !== 'object')
+            return '';
+        const obj = params;
+        const entries = Object.entries(obj).filter(([, v]) => v !== undefined);
+        if (entries.length === 0)
+            return '';
+        return ('?' +
+            new URLSearchParams(entries.reduce((acc, [k, v]) => {
+                acc[k] = String(v);
+                return acc;
+            }, {})));
+    }
+    return {
+        async query(nsid, params) {
+            const qs = buildQs(params);
+            const res = await fetchFn(`${baseUrl}/xrpc/${nsid}${qs}`);
+            if (!res.ok) {
+                const err = await res.json().catch(() => ({}));
+                throw new Error(err.error || `XRPC ${nsid}: ${res.status}`);
+            }
+            return res.json();
+        },
+        async call(nsid, input, params) {
+            const qs = buildQs(params);
+            const res = await fetchFn(`${baseUrl}/xrpc/${nsid}${qs}`, {
+                method: 'POST',
+                headers: input ? { 'Content-Type': 'application/json' } : {},
+                body: input ? JSON.stringify(input) : undefined,
+            });
+            if (!res.ok) {
+                const err = await res.json().catch(() => ({}));
+                throw new Error(err.error || `XRPC ${nsid}: ${res.status}`);
+            }
+            return res.json();
+        },
+        async upload(nsid, data, contentType) {
+            const res = await fetchFn(`${baseUrl}/xrpc/${nsid}`, {
+                method: 'POST',
+                headers: { 'Content-Type': contentType },
+                body: data,
+            });
+            if (!res.ok) {
+                const err = await res.json().catch(() => ({}));
+                throw new Error(err.error || `XRPC ${nsid}: ${res.status}`);
+            }
+            return res.json();
+        },
+    };
+}

package/dist/xrpc.d.ts

@@ -0,0 +1,53 @@
+import type { Row, FlatRow } from './lex-types.ts';
+export type { Row, FlatRow };
+export declare class InvalidRequestError extends Error {
+    status: number;
+    errorName?: string;
+    constructor(message: string, errorName?: string);
+}
+export declare class NotFoundError extends InvalidRequestError {
+    status: number;
+    constructor(message?: string);
+}
+export interface XrpcContext<P = Record<string, string>, Records extends Record<string, any> = Record<string, any>, I = unknown> {
+    db: {
+        query: (sql: string, params?: any[]) => Promise<any[]>;
+        run: (sql: string, ...params: any[]) => Promise<void>;
+    };
+    params: P;
+    input: I;
+    cursor?: string;
+    limit: number;
+    viewer: {
+        did: string;
+    } | null;
+    packCursor: (primary: string | number, cid: string) => string;
+    unpackCursor: (cursor: string) => {
+        primary: string;
+        cid: string;
+    } | null;
+    isTakendown: (did: string) => Promise<boolean>;
+    filterTakendownDids: (dids: string[]) => Promise<Set<string>>;
+    search: <K extends string & keyof Records>(collection: K, q: string, opts?: {
+        limit?: number;
+        cursor?: string;
+        fuzzy?: boolean;
+    }) => Promise<{
+        records: Row<Records[K]>[];
+        cursor?: string;
+    }>;
+    resolve: <R = unknown>(uris: string[]) => Promise<Row<R>[]>;
+    lookup: <R = any>(collection: string, field: string, values: string[]) => Promise<Map<string, Row<R>>>;
+    count: (collection: string, field: string, values: string[]) => Promise<Map<string, number>>;
+    exists: (collection: string, filters: Record<string, string>) => Promise<boolean>;
+    labels: (uris: string[]) => Promise<Map<string, any[]>>;
+    blobUrl: (did: string, ref: unknown, preset?: 'avatar' | 'banner' | 'feed_thumbnail' | 'feed_fullsize') => string | undefined;
+}
+export declare function configureRelay(relay: string): void;
+export declare function blobUrl(did: string, ref: unknown, preset?: 'avatar' | 'banner' | 'feed_thumbnail' | 'feed_fullsize'): string | undefined;
+export declare function initXrpc(xrpcDir: string): Promise<void>;
+export declare function executeXrpc(name: string, params: Record<string, string>, cursor: string | undefined, limit: number, viewer?: {
+    did: string;
+} | null, input?: unknown): Promise<any | null>;
+export declare function listXrpc(): string[];
+//# sourceMappingURL=xrpc.d.ts.map

package/dist/xrpc.d.ts.map

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

package/dist/xrpc.js

@@ -0,0 +1,139 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { resolve, relative } from 'node:path';
+import { readdirSync, statSync } from 'node:fs';
+import { log } from "./logger.js";
+import { querySQL, runSQL, packCursor, unpackCursor, isTakendownDid, filterTakendownDids, searchRecords, findUriByFields, lookupByFieldBatch, countByFieldBatch, queryLabelsForUris, } from "./db.js";
+import { resolveRecords } from "./hydrate.js";
+import { getLexicon } from "./schema.js";
+export class InvalidRequestError extends Error {
+    status = 400;
+    errorName;
+    constructor(message, errorName) {
+        super(message);
+        this.errorName = errorName;
+    }
+}
+export class NotFoundError extends InvalidRequestError {
+    status = 404;
+    constructor(message = 'Not found') {
+        super(message, 'NotFound');
+    }
+}
+let _relayUrl = '';
+export function configureRelay(relay) {
+    _relayUrl = relay;
+}
+export function blobUrl(did, ref, preset = 'avatar') {
+    if (!ref)
+        return undefined;
+    const p = typeof ref === 'string' ? JSON.parse(ref) : ref;
+    if (!p?.ref?.$link)
+        return undefined;
+    if (_relayUrl.includes('localhost:2583')) {
+        return `http://localhost:2583/xrpc/com.atproto.sync.getBlob?did=${did}&cid=${p.ref.$link}`;
+    }
+    return `https://cdn.bsky.app/img/${preset}/plain/${did}/${p.ref.$link}@jpeg`;
+}
+const handlers = new Map();
+function walkDir(dir) {
+    const results = [];
+    try {
+        for (const entry of readdirSync(dir)) {
+            const full = resolve(dir, entry);
+            if (statSync(full).isDirectory()) {
+                results.push(...walkDir(full));
+            }
+            else if ((entry.endsWith('.ts') || entry.endsWith('.js')) && !entry.startsWith('_')) {
+                results.push(full);
+            }
+        }
+    }
+    catch { }
+    return results.sort();
+}
+export async function initXrpc(xrpcDir) {
+    const files = walkDir(xrpcDir);
+    if (files.length === 0)
+        return;
+    for (const scriptPath of files) {
+        const rel = relative(xrpcDir, scriptPath).replace(/\.(ts|js)$/, '');
+        const name = rel.replace(/[\\/]/g, '.');
+        const mod = await import(__rewriteRelativeImportExtension(scriptPath));
+        const handler = mod.default;
+        // Extract param schema from lexicon for validation and defaults
+        const lexicon = getLexicon(name);
+        const paramsDef = lexicon?.defs?.main?.parameters;
+        const requiredParams = paramsDef?.required || [];
+        const paramProperties = paramsDef?.properties || {};
+        handlers.set(name, {
+            name,
+            execute: async (params, cursor, limit, viewer, input) => {
+                // Apply defaults and coerce types from lexicon
+                for (const [key, def] of Object.entries(paramProperties)) {
+                    if (params[key] == null && def.default != null) {
+                        params[key] = String(def.default);
+                    }
+                    if (params[key] != null && def.type === 'integer') {
+                        params[key] = Number(params[key]);
+                    }
+                }
+                for (const param of requiredParams) {
+                    if (!params[param]) {
+                        throw new InvalidRequestError(`Missing required parameter: ${param}`, 'InvalidRequest');
+                    }
+                }
+                const ctx = {
+                    db: { query: querySQL, run: runSQL },
+                    params,
+                    input: input || {},
+                    cursor,
+                    limit,
+                    viewer,
+                    packCursor,
+                    unpackCursor,
+                    isTakendown: isTakendownDid,
+                    filterTakendownDids,
+                    search: searchRecords,
+                    resolve: resolveRecords,
+                    lookup: async (collection, field, values) => {
+                        if (values.length === 0)
+                            return new Map();
+                        const unique = [...new Set(values.filter(Boolean))];
+                        return lookupByFieldBatch(collection, field, unique);
+                    },
+                    count: async (collection, field, values) => {
+                        if (values.length === 0)
+                            return new Map();
+                        const unique = [...new Set(values.filter(Boolean))];
+                        return countByFieldBatch(collection, field, unique);
+                    },
+                    exists: async (collection, filters) => {
+                        const conditions = Object.entries(filters).map(([field, value]) => ({ field, value }));
+                        const uri = await findUriByFields(collection, conditions);
+                        return uri !== null;
+                    },
+                    labels: queryLabelsForUris,
+                    blobUrl,
+                };
+                return handler.handler(ctx);
+            },
+        });
+        log(`[xrpc] discovered: ${name}`);
+    }
+}
+export async function executeXrpc(name, params, cursor, limit, viewer, input) {
+    const handler = handlers.get(name);
+    if (!handler)
+        return null;
+    return handler.execute(params, cursor, limit, viewer || null, input);
+}
+export function listXrpc() {
+    return Array.from(handlers.keys());
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@hatk/hatk",
+  "version": "0.0.1-alpha.0",
+  "bin": {
+    "hatk": "dist/cli.js"
+  },
+  "type": "module",
+  "exports": {
+    "./feeds": "./dist/feeds.js",
+    "./xrpc": "./dist/xrpc.js",
+    "./opengraph": "./dist/opengraph.js",
+    "./labels": "./dist/labels.js",
+    "./lex-types": "./dist/lex-types.js",
+    "./xrpc-client": "./dist/xrpc-client.js",
+    "./views": "./dist/views.js",
+    "./seed": "./dist/seed.js",
+    "./setup": "./dist/setup.js",
+    "./test": "./dist/test.js",
+    "./test/browser": "./dist/test-browser.js",
+    "./vite-plugin": "./dist/vite-plugin.js"
+  },
+  "files": ["dist", "fonts", "public"],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@bigmoves/lexicon": "^0.2.1",
+    "@duckdb/node-api": "^1.4.4-r.1",
+    "@hatk/oauth-client": "*",
+    "@resvg/resvg-js": "^2.6.2",
+    "satori": "^0.19.2",
+    "vitest": "^4",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.58.2",
+    "@types/react": "^19.2.14",
+    "vite": "^6"
+  }
+}