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

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"}