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

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/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,CAqDjG"}

package/dist/server-init.js

@@ -0,0 +1,59 @@
+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, onResync?: () => void): 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,EAChE,QAAQ,CAAC,EAAE,MAAM,IAAI,GACpB,MAAM,CAg9BR"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AA2CA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAa9C;;;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,CAgvB5F;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"}