@hatk/hatk 0.0.1-alpha.4 → 0.0.1-alpha.41

package/dist/renderer.d.ts

@@ -0,0 +1,27 @@
+export interface SSRManifest {
+    getPreloadTags(url: string): string;
+}
+export interface RenderResult {
+    html: string;
+    head?: string;
+}
+export type RendererHandler = (request: Request, manifest: SSRManifest) => Promise<RenderResult>;
+export declare function defineRenderer(handler: RendererHandler): {
+    __type: "renderer";
+    handler: RendererHandler;
+};
+export declare function registerRenderer(handler: RendererHandler): void;
+export declare function setSSRManifest(manifest: SSRManifest): void;
+export declare function getRenderer(): RendererHandler | null;
+export declare function getSSRManifest(): SSRManifest | null;
+/**
+ * Render an HTML page by calling the user's renderer and assembling the result
+ * into the index.html template.
+ *
+ * @param template - The index.html content (with <!--ssr-outlet--> placeholder)
+ * @param request - The incoming Request
+ * @param ogMeta - Optional OG meta tags to inject
+ * @returns Assembled HTML string, or null if no renderer is registered
+ */
+export declare function renderPage(template: string, request: Request, ogMeta?: string | null): Promise<string | null>;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;AAKhG,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe;;;EAEtD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAG/D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAE1D;AAED,wBAAgB,WAAW,IAAI,eAAe,GAAG,IAAI,CAEpD;AAED,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsBnH"}

package/dist/renderer.js

@@ -0,0 +1,46 @@
+import { log } from "./logger.js";
+let renderer = null;
+let ssrManifest = null;
+export function defineRenderer(handler) {
+    return { __type: 'renderer', handler };
+}
+export function registerRenderer(handler) {
+    renderer = handler;
+    log('[renderer] SSR renderer registered');
+}
+export function setSSRManifest(manifest) {
+    ssrManifest = manifest;
+}
+export function getRenderer() {
+    return renderer;
+}
+export function getSSRManifest() {
+    return ssrManifest;
+}
+/**
+ * Render an HTML page by calling the user's renderer and assembling the result
+ * into the index.html template.
+ *
+ * @param template - The index.html content (with <!--ssr-outlet--> placeholder)
+ * @param request - The incoming Request
+ * @param ogMeta - Optional OG meta tags to inject
+ * @returns Assembled HTML string, or null if no renderer is registered
+ */
+export async function renderPage(template, request, ogMeta) {
+    if (!renderer)
+        return null;
+    const manifest = ssrManifest || { getPreloadTags: () => '' };
+    const result = await renderer(request, manifest);
+    let html = template;
+    // Inject SSR head tags (preloads, styles)
+    if (result.head) {
+        html = html.replace('</head>', `${result.head}\n</head>`);
+    }
+    // Inject OG meta tags
+    if (ogMeta) {
+        html = html.replace('</head>', `${ogMeta}\n</head>`);
+    }
+    // Inject rendered HTML into the outlet
+    html = html.replace('<!--ssr-outlet-->', result.html);
+    return html;
+}

package/dist/resolve-hatk.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Register a Node.js module resolve hook so dynamic import() of server files
+ * can resolve the $hatk alias to the generated entry points.
+ */
+export declare function registerHatkResolveHook(): void;
+//# sourceMappingURL=resolve-hatk.d.ts.map

package/dist/resolve-hatk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-hatk.d.ts","sourceRoot":"","sources":["../src/resolve-hatk.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAU9C"}

package/dist/resolve-hatk.js

@@ -0,0 +1,20 @@
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { registerHooks } from 'node:module';
+/**
+ * Register a Node.js module resolve hook so dynamic import() of server files
+ * can resolve the $hatk alias to the generated entry points.
+ */
+export function registerHatkResolveHook() {
+    const hatkUrl = pathToFileURL(resolve('hatk.generated.ts')).href;
+    const hatkClientUrl = pathToFileURL(resolve('hatk.generated.client.ts')).href;
+    registerHooks({
+        resolve(specifier, context, nextResolve) {
+            if (specifier === '$hatk/client')
+                return { url: hatkClientUrl, shortCircuit: true };
+            if (specifier === '$hatk')
+                return { url: hatkUrl, shortCircuit: true };
+            return nextResolve(specifier, context);
+        },
+    });
+}

package/dist/response.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Create a JSON Response with optional gzip compression.
+ * Mirrors the old jsonResponse/sendJson behavior.
+ */
+export declare function json(data: unknown, status?: number, acceptEncoding?: string | null): Response;
+/** Create a JSON error Response. */
+export declare function jsonError(status: number, message: string, acceptEncoding?: string | null): Response;
+/** CORS preflight Response. */
+export declare function cors(): Response;
+/** Add CORS headers to an existing Response. */
+export declare function withCors(response: Response): Response;
+/** Create a static file Response with correct MIME type. */
+export declare function file(content: Buffer | Uint8Array, contentType: string, cacheControl?: string): Response;
+/** 404 Not Found. */
+export declare function notFound(): Response;
+//# sourceMappingURL=response.d.ts.map

package/dist/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,SAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAuB1F;AAED,oCAAoC;AACpC,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAEnG;AAED,+BAA+B;AAC/B,wBAAgB,IAAI,IAAI,QAAQ,CAS/B;AAED,gDAAgD;AAChD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAUrD;AAED,4DAA4D;AAC5D,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,CAQvG;AAED,qBAAqB;AACrB,wBAAgB,QAAQ,IAAI,QAAQ,CAEnC"}

package/dist/response.js

@@ -0,0 +1,69 @@
+import { gzipSync } from 'node:zlib';
+import { normalizeValue } from "./database/db.js";
+/**
+ * Create a JSON Response with optional gzip compression.
+ * Mirrors the old jsonResponse/sendJson behavior.
+ */
+export function json(data, status = 200, acceptEncoding) {
+    const body = Buffer.from(JSON.stringify(data, (_, v) => normalizeValue(v)));
+    if (body.length > 1024 && acceptEncoding && /\bgzip\b/.test(acceptEncoding)) {
+        const compressed = gzipSync(body);
+        return new Response(compressed, {
+            status,
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Encoding': 'gzip',
+                Vary: 'Accept-Encoding',
+                ...(status === 200 ? { 'Cache-Control': 'no-store' } : {}),
+            },
+        });
+    }
+    return new Response(body, {
+        status,
+        headers: {
+            'Content-Type': 'application/json',
+            ...(status === 200 ? { 'Cache-Control': 'no-store' } : {}),
+        },
+    });
+}
+/** Create a JSON error Response. */
+export function jsonError(status, message, acceptEncoding) {
+    return json({ error: message }, status, acceptEncoding);
+}
+/** CORS preflight Response. */
+export function cors() {
+    return new Response(null, {
+        status: 200,
+        headers: {
+            'Access-Control-Allow-Origin': '*',
+            'Access-Control-Allow-Headers': '*',
+            'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+        },
+    });
+}
+/** Add CORS headers to an existing Response. */
+export function withCors(response) {
+    const headers = new Headers(response.headers);
+    headers.set('Access-Control-Allow-Origin', '*');
+    headers.set('Access-Control-Allow-Headers', '*');
+    headers.set('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+    return new Response(response.body, {
+        status: response.status,
+        statusText: response.statusText,
+        headers,
+    });
+}
+/** Create a static file Response with correct MIME type. */
+export function file(content, contentType, cacheControl) {
+    return new Response(Buffer.from(content), {
+        status: 200,
+        headers: {
+            'Content-Type': contentType,
+            ...(cacheControl ? { 'Cache-Control': cacheControl } : {}),
+        },
+    });
+}
+/** 404 Not Found. */
+export function notFound() {
+    return new Response('Not Found', { status: 404 });
+}

package/dist/scanner.d.ts

@@ -0,0 +1,21 @@
+export interface ScannedModule {
+    path: string;
+    name: string;
+    mod: any;
+}
+export interface ScanResult {
+    feeds: ScannedModule[];
+    queries: ScannedModule[];
+    procedures: ScannedModule[];
+    hooks: ScannedModule[];
+    setup: ScannedModule[];
+    labels: ScannedModule[];
+    og: ScannedModule[];
+    renderer: ScannedModule | null;
+}
+/**
+ * Scan a directory for hatk server modules.
+ * Each file's default export is inspected for a `__type` tag.
+ */
+export declare function scanServerDir(serverDir: string): Promise<ScanResult>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,GAAG,CAAA;CACT;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,UAAU,EAAE,aAAa,EAAE,CAAA;IAC3B,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,EAAE,EAAE,aAAa,EAAE,CAAA;IACnB,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAA;CAC/B;AAmBD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA2D1E"}

package/dist/scanner.js

@@ -0,0 +1,88 @@
+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, existsSync } from 'node:fs';
+import { log } from "./logger.js";
+/** Recursively collect .ts/.js files, skipping _ prefixed and dot files */
+function walkDir(dir) {
+    const results = [];
+    try {
+        for (const entry of readdirSync(dir)) {
+            if (entry.startsWith('_') || entry.startsWith('.'))
+                continue;
+            const full = resolve(dir, entry);
+            if (statSync(full).isDirectory()) {
+                results.push(...walkDir(full));
+            }
+            else if (entry.endsWith('.ts') || entry.endsWith('.js')) {
+                results.push(full);
+            }
+        }
+    }
+    catch { }
+    return results.sort();
+}
+/**
+ * Scan a directory for hatk server modules.
+ * Each file's default export is inspected for a `__type` tag.
+ */
+export async function scanServerDir(serverDir) {
+    const result = {
+        feeds: [],
+        queries: [],
+        procedures: [],
+        hooks: [],
+        setup: [],
+        labels: [],
+        og: [],
+        renderer: null,
+    };
+    if (!existsSync(serverDir))
+        return result;
+    const files = walkDir(serverDir);
+    for (const filePath of files) {
+        const name = relative(serverDir, filePath).replace(/\.(ts|js)$/, '');
+        const mod = await import(__rewriteRelativeImportExtension(/* @vite-ignore */ `${filePath}?t=${Date.now()}`));
+        const exported = mod.default;
+        if (!exported) {
+            log(`[scanner] ${name}: no default export, skipping`);
+            continue;
+        }
+        const entry = { path: filePath, name, mod: exported };
+        switch (exported.__type) {
+            case 'feed':
+                result.feeds.push(entry);
+                break;
+            case 'query':
+                result.queries.push(entry);
+                break;
+            case 'procedure':
+                result.procedures.push(entry);
+                break;
+            case 'hook':
+                result.hooks.push(entry);
+                break;
+            case 'setup':
+                result.setup.push(entry);
+                break;
+            case 'labels':
+                result.labels.push(entry);
+                break;
+            case 'og':
+                result.og.push(entry);
+                break;
+            case 'renderer':
+                result.renderer = entry;
+                break;
+            default:
+                log(`[scanner] ${name}: no recognized __type tag, skipping`);
+        }
+    }
+    return result;
+}

package/dist/schema.d.ts

@@ -48,4 +48,12 @@ export declare function getAllLexicons(): Array<{
 export declare function getLexiconArray(): any[];
 export declare function generateTableSchema(nsid: string, lexicon: any, lexicons?: Map<string, any>): TableSchema;
 export declare function generateCreateTableSQL(schema: TableSchema): string;
+/**
+ * Build table schemas and DDL from lexicons and collections.
+ * Shared by main.ts (server boot) and cli.ts (hatk schema command).
+ */
+export declare function buildSchemas(lexicons: Map<string, any>, collections: string[]): {
+    schemas: TableSchema[];
+    ddlStatements: string[];
+};
 //# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,QAAQ,EAAE,gBAAgB,EAAE,CAAA;IAC5B,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,SAAS,EAAE,CAAA;CACrB;AAGD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AA8CD,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CASlE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CASxE;AAID,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAI9D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAExD;AAED,wBAAgB,cAAc,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,CAEtE;AAED,iFAAiF;AACjF,wBAAgB,eAAe,IAAI,GAAG,EAAE,CAEvC;AAuHD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW,CA0GxG;AAGD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAoElE"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,QAAQ,EAAE,gBAAgB,EAAE,CAAA;IAC5B,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,SAAS,EAAE,CAAA;CACrB;AAGD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AA8CD,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CASlE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CASxE;AAID,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAI9D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAExD;AAED,wBAAgB,cAAc,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,CAEtE;AAED,iFAAiF;AACjF,wBAAgB,eAAe,IAAI,GAAG,EAAE,CAEvC;AAuHD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW,CA0GxG;AAGD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAoElE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,WAAW,EAAE,MAAM,EAAE,GACpB;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,CA2BrD"}

package/dist/schema.js

@@ -356,3 +356,32 @@ export function generateCreateTableSQL(schema) {
     }
     return [createTable, ...indexes, ...childDDL].join('\n');
 }
+/**
+ * Build table schemas and DDL from lexicons and collections.
+ * Shared by main.ts (server boot) and cli.ts (hatk schema command).
+ */
+export function buildSchemas(lexicons, collections) {
+    const schemas = [];
+    const ddlStatements = [];
+    for (const nsid of collections) {
+        const lexicon = lexicons.get(nsid);
+        if (!lexicon) {
+            const genericDDL = `CREATE TABLE IF NOT EXISTS "${nsid}" (
+      uri TEXT PRIMARY KEY,
+      cid TEXT,
+      did TEXT NOT NULL,
+      indexed_at TIMESTAMP NOT NULL,
+      data JSON
+    );
+    CREATE INDEX IF NOT EXISTS idx_${nsid.replace(/\./g, '_')}_indexed ON "${nsid}"(indexed_at DESC);
+    CREATE INDEX IF NOT EXISTS idx_${nsid.replace(/\./g, '_')}_author ON "${nsid}"(did);`;
+            schemas.push({ collection: nsid, tableName: `"${nsid}"`, columns: [], refColumns: [], children: [], unions: [] });
+            ddlStatements.push(genericDDL);
+            continue;
+        }
+        const schema = generateTableSchema(nsid, lexicon, lexicons);
+        schemas.push(schema);
+        ddlStatements.push(generateCreateTableSQL(schema));
+    }
+    return { schemas, ddlStatements };
+}

package/dist/seed.d.ts

@@ -1,8 +1,10 @@
+/** Authenticated PDS session — returned by {@link seed.createAccount}. */
 export type Session = {
     did: string;
     accessJwt: string;
     handle: string;
 };
+/** AT Protocol blob reference, as returned by `com.atproto.repo.uploadBlob`. */
 export type BlobRef = {
     $type: 'blob';
     ref: {
@@ -11,11 +13,23 @@ export type BlobRef = {
     mimeType: string;
     size: number;
 };
+/** Options for the seed helper. All fields fall back to env vars or sensible defaults. */
 export type SeedOpts = {
     pds?: string;
     password?: string;
     lexicons?: string;
 };
+/**
+ * Create a seed helper for populating a local PDS with test data.
+ *
+ * Returns `createAccount`, `createRecord`, and `uploadBlob` functions bound to
+ * the target PDS. Records are validated against the project's lexicons before
+ * being written. Generic parameter `R` maps collection NSIDs to their record types
+ * for type-safe seeding.
+ *
+ * @typeParam R - Map of collection NSID → record type (defaults to untyped)
+ * @param opts - PDS URL, password, and lexicon directory overrides
+ */
 export declare function seed<R extends Record<string, unknown> = Record<string, unknown>>(opts?: SeedOpts): {
     createAccount: (handle: string) => Promise<Session>;
     createRecord: <K extends keyof R & string>(session: Session, collection: K, record: R[K] extends Record<string, unknown> ? R[K] : Record<string, unknown>, opts: {
@@ -23,6 +37,11 @@ export declare function seed<R extends Record<string, unknown> = Record<string,
     }) => Promise<{
         uri: string;
         cid: string;
+        commit: {
+            cid: string;
+            rev: string;
+        };
+        validationStatus: string;
     }>;
     uploadBlob: (session: Session, filePath: string) => Promise<BlobRef>;
 };

package/dist/seed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AACxE,MAAM,MAAM,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAC/F,MAAM,MAAM,QAAQ,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7E,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ;4BAM1D,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;mBA4BlC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,WAC3C,OAAO,cACJ,CAAC,UACL,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QACvE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KACrB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;0BA4BL,OAAO,YAAY,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;EA4BhF"}
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AA8BA,0EAA0E;AAC1E,MAAM,MAAM,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAExE,gFAAgF;AAChF,MAAM,MAAM,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/F,0FAA0F;AAC1F,MAAM,MAAM,QAAQ,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7E;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ;4BAO1D,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;mBA6BlC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,WAC3C,OAAO,cACJ,CAAC,UACL,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QACvE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KACrB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;0BAkCrE,OAAO,YAAY,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;EA4BhF"}

package/dist/seed.js

@@ -1,12 +1,49 @@
-import { loadLexicons } from "./schema.js";
+/**
+ * Test data seeding helpers for populating a local PDS.
+ *
+ * Place a seed script at `seeds/seed.ts`. It runs during `hatk dev` to create
+ * accounts and records against your local PDS. Records are validated against
+ * your project's lexicons before being written.
+ *
+ * @example
+ * ```ts
+ * // seeds/seed.ts
+ * import { seed } from '../hatk.generated.ts'
+ *
+ * const { createAccount, createRecord } = seed()
+ *
+ * const alice = await createAccount('alice.test')
+ * const bob = await createAccount('bob.test')
+ *
+ * await createRecord(
+ *   alice,
+ *   'xyz.statusphere.status',
+ *   { status: '👍', createdAt: new Date().toISOString() },
+ *   { rkey: 'status1' },
+ * )
+ * ```
+ */
+import { loadLexicons } from "./database/schema.js";
 import { validateRecord } from '@bigmoves/lexicon';
 import { resolve } from 'node:path';
 import { readFileSync } from 'node:fs';
+/**
+ * Create a seed helper for populating a local PDS with test data.
+ *
+ * Returns `createAccount`, `createRecord`, and `uploadBlob` functions bound to
+ * the target PDS. Records are validated against the project's lexicons before
+ * being written. Generic parameter `R` maps collection NSIDs to their record types
+ * for type-safe seeding.
+ *
+ * @typeParam R - Map of collection NSID → record type (defaults to untyped)
+ * @param opts - PDS URL, password, and lexicon directory overrides
+ */
 export function seed(opts) {
     const pdsUrl = opts?.pds || process.env.PDS_URL || 'http://localhost:2583';
     const password = opts?.password || process.env.SEED_PASSWORD || 'password';
     const lexiconsDir = resolve(opts?.lexicons || 'lexicons');
     const lexiconArray = [...loadLexicons(lexiconsDir).values()];
+    /** Create a PDS account (or reuse an existing one) and return an authenticated session. */
     async function createAccount(handle) {
         const res = await fetch(`${pdsUrl}/xrpc/com.atproto.server.createAccount`, {
             method: 'POST',
@@ -34,6 +71,7 @@ export function seed(opts) {
         const session = (await sessionRes.json());
         return { ...session, handle };
     }
+    /** Validate a record against its lexicon and write it to the PDS via `putRecord`. */
     async function createRecord(session, collection, record, opts) {
         const error = validateRecord(lexiconArray, collection, record);
         if (error) {
@@ -53,10 +91,11 @@ export function seed(opts) {
         if (!res.ok) {
             throw new Error(`[seed] [${session.handle}] failed to create ${collection}: ${await res.text()}`);
         }
-        const { uri, cid } = (await res.json());
-        console.log(`[seed] [${session.handle}] ${collection} → ${uri}`);
-        return { uri, cid };
+        const result = (await res.json());
+        console.log(`[seed] [${session.handle}] ${collection} → ${result.uri}`);
+        return result;
     }
+    /** Upload a file to the PDS as a blob. MIME type is inferred from the file extension. */
     async function uploadBlob(session, filePath) {
         const data = readFileSync(resolve(filePath));
         const ext = filePath.split('.').pop()?.toLowerCase() || '';

package/dist/server-init.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Scan the server/ directory and register all discovered handlers.
+ * Setup scripts run immediately (in sorted order).
+ */
+export declare function initServer(serverDir: string, opts?: {
+    skipSetup?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=server-init.d.ts.map

package/dist/server-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-init.d.ts","sourceRoot":"","sources":["../src/server-init.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DjG"}

package/dist/server-init.js

@@ -0,0 +1,61 @@
+import { existsSync } from 'node:fs';
+import { log } from "./logger.js";
+import { scanServerDir } from "./scanner.js";
+import { registerFeed, listFeeds } from "./feeds.js";
+import { registerXrpcHandler, listXrpc } from "./xrpc.js";
+import { registerLabelModule, getLabelDefinitions } from "./labels.js";
+import { registerOgHandler } from "./opengraph.js";
+import { registerHook } from "./hooks.js";
+import { runSetupHandler } from "./setup.js";
+import { registerRenderer } from "./renderer.js";
+/**
+ * Scan the server/ directory and register all discovered handlers.
+ * Setup scripts run immediately (in sorted order).
+ */
+export async function initServer(serverDir, opts) {
+    if (!existsSync(serverDir)) {
+        log(`[server] No server/ directory found, skipping`);
+        return;
+    }
+    const scanned = await scanServerDir(serverDir);
+    // 1. Run setup scripts first (sorted by name) — skipped in test context
+    if (!opts?.skipSetup) {
+        for (const entry of scanned.setup.sort((a, b) => a.name.localeCompare(b.name))) {
+            await runSetupHandler(entry.name, entry.mod.handler);
+        }
+    }
+    // 2. Register feeds
+    for (const entry of scanned.feeds) {
+        const feedName = entry.name.includes('/') ? entry.name.split('/').pop() : entry.name;
+        registerFeed(feedName, entry.mod);
+    }
+    // 3. Register XRPC handlers
+    for (const entry of scanned.queries) {
+        registerXrpcHandler(entry.mod.nsid, entry.mod);
+    }
+    for (const entry of scanned.procedures) {
+        registerXrpcHandler(entry.mod.nsid, entry.mod);
+    }
+    // 4. Register hooks
+    for (const entry of scanned.hooks) {
+        registerHook(entry.mod.event, entry.mod.handler);
+    }
+    // 5. Register labels
+    for (const entry of scanned.labels) {
+        registerLabelModule(entry.name, entry.mod);
+    }
+    // 6. Register OG handlers
+    for (const entry of scanned.og) {
+        registerOgHandler(entry.mod);
+    }
+    // 7. Register renderer
+    if (scanned.renderer) {
+        registerRenderer(scanned.renderer.mod.handler);
+    }
+    log(`[server] Initialized from server/ directory:`);
+    log(`  Feeds: ${listFeeds()
+        .map((f) => f.name)
+        .join(', ') || 'none'}`);
+    log(`  XRPC: ${listXrpc().join(', ') || 'none'}`);
+    log(`  Labels: ${getLabelDefinitions().length} definitions`);
+}

package/dist/server.d.ts

@@ -1,6 +1,29 @@
-import { type Server, type IncomingMessage } from 'node:http';
 import type { OAuthConfig } from './config.ts';
-export declare function startServer(port: number, collections: string[], publicDir: string | null, oauth: OAuthConfig | null, admins?: string[], resolveViewer?: (req: IncomingMessage) => {
+/**
+ * Register built-in dev.hatk.* XRPC handlers in the handler registry.
+ * This makes them available to callXrpc() for use in SSR and server code.
+ */
+export declare function registerCoreHandlers(collections: string[], oauth: OAuthConfig | null): void;
+export interface HandlerConfig {
+    collections: string[];
+    publicDir: string | null;
+    oauth: OAuthConfig | null;
+    admins: string[];
+    renderer?: (request: Request, manifest: any) => Promise<{
+        html: string;
+        head?: string;
+    }>;
+    resolveViewer?: (request: Request) => {
+        did: string;
+    } | null;
+    onResync?: () => void;
+}
+/**
+ * Create a Web Standard request handler for all hatk routes.
+ * Returns a pure function: (Request) → Promise<Response>
+ */
+export declare function createHandler(config: HandlerConfig): (request: Request) => Promise<Response>;
+export declare function startServer(port: number, collections: string[], publicDir: string | null, oauth: OAuthConfig | null, admins?: string[], resolveViewer?: (request: Request) => {
     did: string;
-} | null): Server;
+} | null, onResync?: () => void): import('node:http').Server;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AAmD3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AA2B9C,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,KAAK,EAAE,WAAW,GAAG,IAAI,EACzB,MAAM,GAAE,MAAM,EAAO,EACrB,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAC/D,MAAM,CAo8BR"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAqDA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AA0B9C;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAwH3F;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;IACzB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACxF,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC5D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CA8xB5F;AAGD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,KAAK,EAAE,WAAW,GAAG,IAAI,EACzB,MAAM,GAAE,MAAM,EAAO,EACrB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAC5D,QAAQ,CAAC,EAAE,MAAM,IAAI,GACpB,OAAO,WAAW,EAAE,MAAM,CAG5B"}