@hatk/hatk 0.0.1-alpha.23 → 0.0.1-alpha.25

package/dist/setup.d.ts

@@ -14,6 +14,11 @@ export interface SetupContext {
         }) => Promise<BulkInserter>;
     };
 }
+export type SetupHandler = (ctx: SetupContext) => Promise<void>;
+export declare function defineSetup(handler: SetupHandler): {
+    __type: "setup";
+    handler: SetupHandler;
+};
 /**
  * Run all setup scripts in the given directory on server boot.
  *
@@ -25,4 +30,6 @@ export interface SetupContext {
  * @param setupDir - Absolute path to the `setup/` directory
  */
 export declare function initSetup(setupDir: string): Promise<void>;
+/** Run a single setup handler with a SetupContext. */
+export declare function runSetupHandler(name: string, handler: SetupHandler): Promise<void>;
 //# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE;QACF,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QACtD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QACnD,QAAQ,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,GAAG,EAAE,CAAA;SAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QAC9E,kBAAkB,EAAE,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,KAChE,OAAO,CAAC,YAAY,CAAC,CAAA;KAC3B,CAAA;CACF;AAkBD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB/D"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE;QACF,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QACtD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QACnD,QAAQ,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,GAAG,EAAE,CAAA;SAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QAC9E,kBAAkB,EAAE,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,KAChE,OAAO,CAAC,YAAY,CAAC,CAAA;KAC3B,CAAA;CACF;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAE/D,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY;;;EAEhD;AAkBD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB/D;AAED,sDAAsD;AACtD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxF"}

package/dist/setup.js

@@ -34,6 +34,9 @@ import { resolve, relative } from 'node:path';
 import { readdirSync, statSync } from 'node:fs';
 import { log } from "./logger.js";
 import { querySQL, runSQL, runBatch, createBulkInserterSQL } from "./database/db.js";
+export function defineSetup(handler) {
+    return { __type: 'setup', handler };
+}
 /** Recursively collect .ts/.js files in a directory, skipping files prefixed with `_`. */
 function walkDir(dir) {
     const results = [];
@@ -67,7 +70,7 @@ export async function initSetup(setupDir) {
         return;
     for (const scriptPath of files) {
         const name = relative(setupDir, scriptPath).replace(/\.(ts|js)$/, '');
-        const mod = await import(__rewriteRelativeImportExtension(scriptPath));
+        const mod = await import(__rewriteRelativeImportExtension(/* @vite-ignore */ `${scriptPath}?t=${Date.now()}`));
         const handler = mod.default?.handler || mod.default;
         if (typeof handler !== 'function') {
             console.warn(`[setup] ${name}: no handler function found, skipping`);
@@ -81,3 +84,12 @@ export async function initSetup(setupDir) {
         log(`[setup] done: ${name}`);
     }
 }
+/** Run a single setup handler with a SetupContext. */
+export async function runSetupHandler(name, handler) {
+    const ctx = {
+        db: { query: querySQL, run: runSQL, runBatch, createBulkInserter: createBulkInserterSQL },
+    };
+    log(`[setup] running: ${name}`);
+    await handler(ctx);
+    log(`[setup] done: ${name}`);
+}

package/dist/test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAmBzD,OAAO,EAAE,IAAI,IAAI,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE;QACF,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QACtD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KACpD,CAAA;IACD,YAAY,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAA;IAC5E,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAA;IACnE,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE;QACnB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;QAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAChC,KAAK,WAAW,CAAA;IACjB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAA;IACpC,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CACxC;AAED,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC9D,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC7E,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,KAAK,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;IAC/D,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAClE;AAYD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,WAAW,CAAC,CAiL9D;AA8BD,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC,CAgD3D"}
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAkBzD,OAAO,EAAE,IAAI,IAAI,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE;QACF,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QACtD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KACpD,CAAA;IACD,YAAY,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAA;IAC5E,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAA;IACnE,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE;QACnB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;QAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAChC,KAAK,WAAW,CAAA;IACjB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAA;IACpC,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CACxC;AAED,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC9D,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC7E,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,KAAK,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;IAC/D,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAClE;AAYD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,WAAW,CAAC,CAwK9D;AA8BD,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC,CAgD3D"}

package/dist/test.js

@@ -5,13 +5,12 @@ import { loadConfig } from "./config.js";
 import { loadLexicons, storeLexicons, discoverCollections, generateTableSchema, generateCreateTableSQL, } from "./database/schema.js";
 import { initDatabase, querySQL, runSQL, insertRecord, closeDatabase } from "./database/db.js";
 import { createAdapter } from "./database/adapter-factory.js";
+import { SQLITE_DIALECT } from "./database/dialect.js";
 import { setSearchPort } from "./database/fts.js";
-import { initFeeds, executeFeed, listFeeds, createPaginate } from "./feeds.js";
-import { initXrpc, executeXrpc, listXrpc, configureRelay } from "./xrpc.js";
-import { initOpengraph } from "./opengraph.js";
-import { initLabels } from "./labels.js";
+import { executeFeed, listFeeds, createPaginate } from "./feeds.js";
+import { executeXrpc, listXrpc, configureRelay } from "./xrpc.js";
+import { initServer } from "./server-init.js";
 import { discoverViews } from "./views.js";
-import { loadOnLoginHook } from "./hooks.js";
 import { validateLexicons } from '@bigmoves/lexicon';
 import { packCursor, unpackCursor, isTakendownDid, filterTakendownDids } from "./database/db.js";
 import { seed as createSeedHelpers } from "./seed.js";
@@ -58,25 +57,16 @@ export async function createTestContext() {
             continue;
         const schema = generateTableSchema(nsid, lexicon, lexicons);
         schemas.push(schema);
-        ddlStatements.push(generateCreateTableSQL(schema));
+        ddlStatements.push(generateCreateTableSQL(schema, SQLITE_DIALECT));
     }
-    // In-memory database
-    const { adapter, searchPort } = await createAdapter('duckdb');
+    // In-memory SQLite — faster startup, no native module issues in Vite's module runner
+    const { adapter, searchPort } = await createAdapter('sqlite');
     setSearchPort(searchPort);
     await initDatabase(adapter, ':memory:', schemas, ddlStatements);
-    // Discover views + hooks
+    // Discover views
     discoverViews();
-    try {
-        await loadOnLoginHook(resolve(configDir, 'hooks'));
-    }
-    catch { }
-    // Skip setup hooks in test context — they're for server boot-time
-    // initialization (e.g. importing large datasets) and not appropriate for tests
-    // Discover feeds, xrpc, labels
-    await initFeeds(resolve(configDir, 'feeds'));
-    await initXrpc(resolve(configDir, 'xrpc'));
-    await initOpengraph(resolve(configDir, 'og'));
-    await initLabels(resolve(configDir, 'labels'));
+    // Discover feeds, xrpc, labels, hooks, og from server/ directory (skip setup scripts in tests)
+    await initServer(resolve(configDir, 'server'), { skipSetup: true });
     return {
         db: { query: querySQL, run: runSQL },
         _config: config,
@@ -234,8 +224,8 @@ export async function startTestServer() {
     // Import startServer — it creates the HTTP server and returns it
     const { startServer } = await import("./server.js");
     // Start server on port 0 (random available port)
-    const resolveViewer = (req) => {
-        const did = req.headers['x-test-viewer'];
+    const resolveViewer = (request) => {
+        const did = request.headers.get('x-test-viewer');
         return typeof did === 'string' ? { did } : null;
     };
     const httpServer = startServer(0, ctx._collections, ctx._config.publicDir, ctx._config.oauth, ctx._config.admins, resolveViewer);

package/dist/vite-plugin.d.ts

@@ -1,4 +1,4 @@
-import type { Plugin } from 'vite';
+import { type Plugin } from 'vite';
 export declare function hatk(opts?: {
     port?: number;
 }): Plugin;

package/dist/vite-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAKlC,wBAAgB,IAAI,CAAC,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAiGrD"}
+{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,MAAM,EAA6C,MAAM,MAAM,CAAA;AA8D3G,wBAAgB,IAAI,CAAC,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA2NrD"}

package/dist/vite-plugin.js

@@ -1,97 +1,267 @@
-import { spawn } from 'node:child_process';
+import { createRunnableDevEnvironment } from 'vite';
 import { resolve } from 'node:path';
 import { existsSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { isHatkRoute } from "./adapter.js";
+/** Boot the local PDS if a docker-compose.yml exists. */
+async function ensurePds() {
+    if (!existsSync(resolve('docker-compose.yml')))
+        return;
+    try {
+        const res = await fetch('http://localhost:2583/xrpc/_health');
+        if (res.ok)
+            return;
+    }
+    catch { }
+    console.log('[hatk] Starting PDS...');
+    execSync('docker compose up -d', { stdio: 'inherit', cwd: process.cwd() });
+    for (let i = 0; i < 30; i++) {
+        try {
+            const res = await fetch('http://localhost:2583/xrpc/_health');
+            if (res.ok) {
+                console.log('[hatk] PDS ready');
+                return;
+            }
+        }
+        catch { }
+        await new Promise((r) => setTimeout(r, 1000));
+    }
+    console.error('[hatk] PDS failed to start');
+}
+/** Run seed file if it exists. */
+function runSeed() {
+    const seedFile = resolve('seeds/seed.ts');
+    if (!existsSync(seedFile))
+        return;
+    try {
+        execSync(`npx tsx ${seedFile}`, { stdio: 'inherit', cwd: process.cwd() });
+    }
+    catch { }
+}
+/** Walk all loaded modules in the module graphs to collect CSS URLs for SSR. */
+function collectAllCss(server) {
+    const cssUrls = new Set();
+    for (const envName of ['hatk', 'client']) {
+        const env = server.environments[envName];
+        if (!env?.moduleGraph)
+            continue;
+        // TODO: uses internal Vite module graph API — may break across Vite minor versions
+        for (const mod of env.moduleGraph.idToModuleMap?.values?.() ?? []) {
+            const url = mod.url || '';
+            if (/\.(css|scss|less|styl|stylus|pcss|postcss)(\?|$)/.test(url)) {
+                cssUrls.add(url);
+            }
+            if (url.includes('type=style')) {
+                cssUrls.add(url);
+            }
+        }
+    }
+    if (cssUrls.size === 0)
+        return '';
+    return Array.from(cssUrls)
+        .map((url) => `<link rel="stylesheet" href="${url}">`)
+        .join('\n');
+}
 export function hatk(opts) {
-    const devPort = 3000;
-    const backendPort = opts?.port ?? devPort + 1;
-    const issuer = `http://127.0.0.1:${devPort}`;
-    let serverProcess = null;
+    const devPort = opts?.port ?? 3000;
+    let handler = null;
+    let ssrRenderPage = null;
+    let ssrGetRenderer = null;
+    let reloadServer = null;
+    let reloadTimer = null;
     return {
         name: 'vite-plugin-hatk',
+        // Rewrite $hatk imports in source code so SSR module runners can resolve them.
+        // vite-plus's fetchModule bypasses resolve.alias for bare imports.
+        transform(code, id) {
+            if (!code.includes('$hatk'))
+                return;
+            const hatk = resolve('hatk.generated.ts');
+            const hatkClient = resolve('hatk.generated.client.ts');
+            return code
+                .replace(/from\s+['"](\$hatk\/client)['"]/g, `from '${hatkClient}'`)
+                .replace(/from\s+['"](\$hatk)['"]/g, `from '${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 {
+                environments: {
+                    hatk: {
+                        resolve: {
+                            conditions: ['svelte'],
+                            noExternal: ['svelte', '@tanstack/svelte-query'],
+                            external: true,
+                        },
+                        dev: {
+                            createEnvironment(name, config) {
+                                return createRunnableDevEnvironment(name, config);
+                            },
+                            optimizeDeps: {
+                                exclude: ['better-sqlite3', '@duckdb/node-api'],
+                            },
+                        },
+                        build: {
+                            outDir: 'dist/server',
+                            ssr: true,
+                            rollupOptions: {
+                                external: ['better-sqlite3', '@duckdb/node-api'],
+                            },
+                        },
+                    },
+                },
                 server: {
                     host: '127.0.0.1',
                     port: devPort,
+                    fs: {
+                        allow: ['.'],
+                    },
                     watch: {
                         ignored: ['**/db/**', '**/data/**'],
                     },
-                    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.js');
-            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, 'hatk.config.ts'], {
-                stdio: 'inherit',
-                cwd: process.cwd(),
-                env: {
-                    ...process.env,
-                    PORT: String(backendPort),
-                    OAUTH_ISSUER: process.env.OAUTH_ISSUER || issuer,
-                    DEV_MODE: '1',
-                },
-            });
-            // Suppress ECONNREFUSED proxy errors while backend is booting
-            const origError = server.config.logger.error;
-            server.config.logger.error = (msg, opts) => {
-                if (typeof msg === 'string' && msg.includes('ECONNREFUSED'))
+        async configureServer(server) {
+            // Skip hatk server boot in test mode — tests manage their own context
+            if (process.env.VITEST)
+                return;
+            // Boot PDS and run seeds before starting
+            await ensurePds();
+            runSeed();
+            const env = server.environments.hatk;
+            if (!env || !('runner' in env)) {
+                console.error('[hatk] hatk environment not available — is Vite 8 with Environment API?');
+                return;
+            }
+            // Load the hatk boot module through the module runner
+            const mainPath = resolve(import.meta.dirname, 'dev-entry.js');
+            const mod = await env.runner.import(mainPath);
+            handler = mod.handler;
+            ssrRenderPage = mod.renderPage;
+            ssrGetRenderer = mod.getRenderer;
+            reloadServer = mod.reloadServer;
+            globalThis.__hatk_callXrpc = mod.callXrpc;
+            // Capture cookie parser and name for SSR viewer resolution
+            const ssrParseSessionCookie = mod.parseSessionCookie ?? null;
+            globalThis.__hatk_parseSessionCookie = ssrParseSessionCookie;
+            globalThis.__hatk_sessionCookieName = mod.getSessionCookieName?.() ?? '__hatk_session';
+            if (ssrGetRenderer?.()) {
+                console.log('[hatk] SSR ready');
+            }
+            // API routes — must run before Vite's static middleware
+            server.middlewares.use(async (req, res, next) => {
+                const url = new URL(req.url, `http://localhost:${devPort}`);
+                if (!isHatkRoute(url.pathname) || !handler) {
+                    next();
                     return;
-                origError(msg, opts);
-            };
-            server.httpServer?.on('close', () => {
-                serverProcess?.kill();
-                serverProcess = null;
+                }
+                try {
+                    const { toRequest, sendResponse } = await import('./adapter.js');
+                    const request = toRequest(req, `http://localhost:${devPort}`);
+                    const response = await handler(request);
+                    if (response.status === 404) {
+                        next();
+                        return;
+                    }
+                    await sendResponse(res, response);
+                }
+                catch (err) {
+                    console.error('[hatk]', err.message);
+                    next(err);
+                }
             });
+            // SSR middleware — returned function runs after htmlFallback but before indexHtmlMiddleware
+            return () => {
+                server.middlewares.use(async (req, res, next) => {
+                    if (!ssrGetRenderer?.()) {
+                        next();
+                        return;
+                    }
+                    const accept = req.headers.accept || '';
+                    const url = req.originalUrl || req.url;
+                    if (!accept.includes('text/html') || !url) {
+                        next();
+                        return;
+                    }
+                    try {
+                        const { readFileSync } = await import('node:fs');
+                        const rawHtml = readFileSync(resolve('index.html'), 'utf-8');
+                        const template = await server.transformIndexHtml(url, rawHtml);
+                        const fullUrl = new URL(url, `http://localhost:${devPort}`);
+                        const headers = {};
+                        if (req.headers.cookie)
+                            headers.cookie = req.headers.cookie;
+                        const request = new Request(fullUrl.href, { headers });
+                        // Resolve viewer from session cookie for SSR
+                        // TODO: globalThis.__hatk_viewer is not safe for concurrent SSR requests.
+                        // Replace with AsyncLocalStorage when callXrpc supports per-request context.
+                        let viewer = null;
+                        if (ssrParseSessionCookie) {
+                            try {
+                                viewer = await ssrParseSessionCookie(request);
+                            }
+                            catch { }
+                        }
+                        ;
+                        globalThis.__hatk_viewer = viewer;
+                        let renderedHtml;
+                        try {
+                            renderedHtml = await ssrRenderPage(template, request);
+                        }
+                        finally {
+                            ;
+                            globalThis.__hatk_viewer = null;
+                        }
+                        // Inject viewer into HTML so client has it before OAuth initializes
+                        if (renderedHtml && viewer) {
+                            const script = `<script>globalThis.__hatk_viewer=${JSON.stringify(viewer)}</script>`;
+                            renderedHtml = renderedHtml.replace('</head>', `${script}\n</head>`);
+                        }
+                        if (!renderedHtml) {
+                            next();
+                            return;
+                        }
+                        // Collect CSS from all loaded modules to prevent FOUC
+                        const cssLinks = collectAllCss(server);
+                        let html = renderedHtml;
+                        if (cssLinks) {
+                            html = html.replace('</head>', `${cssLinks}\n</head>`);
+                        }
+                        res.setHeader('Content-Type', 'text/html');
+                        res.end(html);
+                    }
+                    catch (err) {
+                        console.error('[hatk] SSR error:', err.message);
+                        next(err);
+                    }
+                });
+            };
+        },
+        // Handle HMR for server/ files in the hatk environment
+        hotUpdate(options) {
+            if (options.file.includes('/server/') && reloadServer) {
+                // Debounce: hotUpdate fires once per environment, only reload once
+                if (!reloadTimer) {
+                    reloadTimer = setTimeout(() => {
+                        reloadTimer = null;
+                        reloadServer().then(() => {
+                            console.log('[hatk] Server handlers reloaded');
+                        }).catch((err) => {
+                            console.error('[hatk] Failed to reload server handlers:', err.message);
+                        });
+                    }, 50);
+                }
+            }
         },
-        buildEnd() {
-            serverProcess?.kill();
-            serverProcess = null;
+        // Two-stage production build
+        async buildApp(builder) {
+            // Stage 1: Build client
+            if (builder.environments.client) {
+                await builder.build(builder.environments.client);
+            }
+            // Stage 2: Build hatk server (if environment exists)
+            if (builder.environments.hatk) {
+                await builder.build(builder.environments.hatk);
+            }
         },
     };
 }

package/dist/xrpc.d.ts

@@ -67,10 +67,23 @@ export declare function blobUrl(did: string, ref: unknown, preset?: 'avatar' | '
  * coerced against the matching lexicon definition.
  */
 export declare function initXrpc(xrpcDir: string): Promise<void>;
+/** Register a single XRPC handler from a scanned server/ module. */
+export declare function registerXrpcHandler(nsid: string, handlerModule: {
+    handler: (ctx: any) => Promise<any>;
+}): void;
 /** Execute a registered XRPC handler by name. Returns null if no handler matches. */
 export declare function executeXrpc(name: string, params: Record<string, string>, cursor: string | undefined, limit: number, viewer?: {
     did: string;
 } | null, input?: unknown): Promise<any | null>;
+/** Call a registered XRPC handler directly (no HTTP). For use in SSR renderers. */
+export declare function callXrpc(nsid: string, params?: Record<string, any>, input?: unknown): Promise<any>;
+/**
+ * Register a core XRPC handler directly (no XrpcContext wrapping).
+ * Used for built-in dev.hatk.* handlers that manage their own dependencies.
+ */
+export declare function registerCoreXrpcHandler(nsid: string, fn: (params: Record<string, string>, cursor: string | undefined, limit: number, viewer: {
+    did: string;
+} | null, input?: unknown) => Promise<any>): void;
 /** Return all registered XRPC method names. */
 export declare function listXrpc(): string[];
 //# sourceMappingURL=xrpc.d.ts.map

package/dist/xrpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xrpc.d.ts","sourceRoot":"","sources":["../src/xrpc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"xrpc.d.ts","sourceRoot":"","sources":["../src/xrpc.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAElD,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,CAAA;AAE5B,gFAAgF;AAChF,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,MAAM,SAAM;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;gBACN,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AACD,0DAA0D;AAC1D,qBAAa,aAAc,SAAQ,mBAAmB;IACpD,MAAM,SAAM;gBACA,OAAO,SAAc;CAGlC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW,CAC1B,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzD,CAAC,GAAG,OAAO;IAEX,EAAE,EAAE;QACF,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QACtD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KACtD,CAAA;IACD,MAAM,EAAE,CAAC,CAAA;IACT,KAAK,EAAE,CAAC,CAAA;IACR,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC9B,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IAC7D,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACzE,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9C,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAC7D,MAAM,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,OAAO,EACvC,UAAU,EAAE,CAAC,EACb,CAAC,EAAE,MAAM,EACT,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KACxD,OAAO,CAAC;QAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC7D,OAAO,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAC3D,MAAM,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACtG,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5F,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACjF,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAA;IACvD,OAAO,EAAE,CACP,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,OAAO,EACZ,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,gBAAgB,GAAG,eAAe,KAC9D,MAAM,GAAG,SAAS,CAAA;CACxB;AAgBD,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,QAE3C;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,OAAO,EACZ,MAAM,GAAE,QAAQ,GAAG,QAAQ,GAAG,gBAAgB,GAAG,eAA0B,GAC1E,MAAM,GAAG,SAAS,CAQpB;AAoBD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsE7D;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE;IAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;CAAE,GAAG,IAAI,CAyD9G;AAED,qFAAqF;AACrF,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAC/B,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAIrB;AAED,mFAAmF;AACnF,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAChC,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,GAAG,CAAC,CAgBd;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAC9B,KAAK,CAAC,EAAE,OAAO,KACZ,OAAO,CAAC,GAAG,CAAC,GAChB,IAAI,CAEN;AAED,+CAA+C;AAC/C,wBAAgB,QAAQ,IAAI,MAAM,EAAE,CAEnC"}

package/dist/xrpc.js

@@ -98,7 +98,7 @@ export async function initXrpc(xrpcDir) {
     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 mod = await import(__rewriteRelativeImportExtension(/* @vite-ignore */ `${scriptPath}?t=${Date.now()}`));
         const handler = mod.default;
         // Extract param schema from lexicon for validation and defaults
         const lexicon = getLexicon(name);
@@ -161,6 +161,65 @@ export async function initXrpc(xrpcDir) {
         log(`[xrpc] discovered: ${name}`);
     }
 }
+/** Register a single XRPC handler from a scanned server/ module. */
+export function registerXrpcHandler(nsid, handlerModule) {
+    const lexicon = getLexicon(nsid);
+    const paramsDef = lexicon?.defs?.main?.parameters;
+    const requiredParams = paramsDef?.required || [];
+    const paramProperties = paramsDef?.properties || {};
+    handlers.set(nsid, {
+        name: nsid,
+        execute: async (params, cursor, limit, viewer, input) => {
+            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 handlerModule.handler(ctx);
+        },
+    });
+}
 /** Execute a registered XRPC handler by name. Returns null if no handler matches. */
 export async function executeXrpc(name, params, cursor, limit, viewer, input) {
     const handler = handlers.get(name);
@@ -168,6 +227,33 @@ export async function executeXrpc(name, params, cursor, limit, viewer, input) {
         return null;
     return handler.execute(params, cursor, limit, viewer || null, input);
 }
+/** Call a registered XRPC handler directly (no HTTP). For use in SSR renderers. */
+export async function callXrpc(nsid, params = {}, input) {
+    const viewer = globalThis.__hatk_viewer ?? null;
+    // In externalized module context (e.g. SSR), delegate to the runner's callXrpc via globalThis.
+    // The runner's module instance has all registered handlers; this (Node's) instance may not.
+    if (handlers.size === 0 && globalThis.__hatk_callXrpc) {
+        return globalThis.__hatk_callXrpc(nsid, params, input);
+    }
+    const stringParams = {};
+    for (const [k, v] of Object.entries(params)) {
+        if (v != null)
+            stringParams[k] = String(v);
+    }
+    const limit = params.limit ? Number(params.limit) : 20;
+    const cursor = params.cursor ?? undefined;
+    const result = await executeXrpc(nsid, stringParams, cursor, limit, viewer, input);
+    if (result === null)
+        throw new Error(`No XRPC handler registered for ${nsid}`);
+    return result;
+}
+/**
+ * Register a core XRPC handler directly (no XrpcContext wrapping).
+ * Used for built-in dev.hatk.* handlers that manage their own dependencies.
+ */
+export function registerCoreXrpcHandler(nsid, fn) {
+    handlers.set(nsid, { name: nsid, execute: fn });
+}
 /** Return all registered XRPC method names. */
 export function listXrpc() {
     return Array.from(handlers.keys());