@tensorix/metahub 0.1.2

package/dist/core/sync/auth.d.ts

@@ -0,0 +1,39 @@
+import type { Database } from "bun:sqlite";
+export interface AuthConfig {
+    debug: boolean;
+    staticToken: string | null;
+    db: Database | null;
+    ttlMs: number;
+    graceMs: number;
+}
+export declare function extractToken(req: Request, url: URL): string | null;
+/** Whether auth is on at all (so the gate runs and the fetch shim is injected). */
+export declare function authActive(cfg: AuthConfig): boolean;
+/** The currently-valid token and its expiry, or null when auth is off. */
+export declare function activeToken(cfg: AuthConfig): {
+    token: string;
+    exp: number;
+} | null;
+export declare function hasValidToken(req: Request, url: URL, cfg: AuthConfig): boolean;
+/**
+ * Token exchange: a holder of the current token (or the in-grace previous token)
+ * gets the current token back. Managed mode only — returns null otherwise.
+ */
+export declare function renewToken(req: Request, url: URL, cfg: AuthConfig): {
+    token: string;
+    exp: number;
+} | null;
+/** A browser navigation (so we can answer with an unlock page instead of a 401). */
+export declare function wantsHtml(req: Request): boolean;
+declare const HTML_HEADERS: {
+    "content-type": string;
+};
+/** Self-contained password prompt: stores token to localStorage + cookie, reloads. */
+export declare function unlockPage(): string;
+/** Insert the fetch shim into an HTML document (right after <head>, else prepend). */
+export declare function injectShim(html: string): string;
+/** For HTML responses when auth is active, inject the shim; otherwise pass through. */
+export declare function withShim(res: Response, cfg: AuthConfig): Promise<Response>;
+export declare function unauthorized(): Response;
+export { HTML_HEADERS };
+//# sourceMappingURL=auth.d.ts.map

package/dist/core/sync/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/core/sync/auth.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQ3C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,EAAE,EAAE,QAAQ,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAcD,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAIlE;AAED,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAEnD;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQlF;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAI9E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,UAAU,GACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUvC;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE/C;AAED,QAAA,MAAM,YAAY;;CAAiD,CAAC;AAEpE,sFAAsF;AACtF,wBAAgB,UAAU,IAAI,MAAM,CAoDnC;AA2CD,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED,uFAAuF;AACvF,wBAAsB,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOhF;AAED,wBAAgB,YAAY,IAAI,QAAQ,CAEvC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/core/sync/client.d.ts

@@ -0,0 +1,8 @@
+import type { Database } from "bun:sqlite";
+export interface SyncResult {
+    pushed: number;
+    pulled: number;
+}
+/** Run one push/pull round against a peer server. */
+export declare function syncWithPeer(db: Database, url: string): Promise<SyncResult>;
+//# sourceMappingURL=client.d.ts.map

package/dist/core/sync/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/sync/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAuB3C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qDAAqD;AACrD,wBAAsB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAkBjF"}

package/dist/core/sync/files.d.ts

@@ -0,0 +1,17 @@
+import type { Database } from "bun:sqlite";
+export interface FileSyncResult {
+    direction: "export" | "import";
+    kind: "doc" | "db";
+    id: string;
+    path: string;
+    bytes?: number;
+    rows?: number;
+}
+/**
+ * Move one document or data table between metahub and a file. Direction is
+ * inferred: whichever of `src`/`dst` resolves to an entity is the entity, the
+ * other is the file path. Entity on the left ⇒ export; on the right ⇒ import.
+ * Documents map to markdown (the doc body), data tables to CSV.
+ */
+export declare function syncFiles(db: Database, src: string, dst: string): Promise<FileSyncResult>;
+//# sourceMappingURL=files.d.ts.map

package/dist/core/sync/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/core/sync/files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAO3C,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAoFD;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAkB/F"}

package/dist/core/sync/openapi.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Build an OpenAPI 3.1 document by walking the route registry. Each route's
+ * Zod schemas are converted to JSON Schema (draft 2020-12, which 3.1 accepts).
+ * Adding a route to ./routes.ts is enough — this picks it up with no codegen.
+ */
+export declare function buildOpenApi(version: string): {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+    };
+    paths: Record<string, Record<string, unknown>>;
+};
+//# sourceMappingURL=openapi.d.ts.map

package/dist/core/sync/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../src/core/sync/openapi.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM;;;;;;;EA2B3C"}

package/dist/core/sync/protocol.d.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import type { Change as CrdtChange } from "../crdt.ts";
+export declare const ChangeSchema: z.ZodObject<{
+    hlc: z.ZodString;
+    node_id: z.ZodString;
+    dataset: z.ZodString;
+    row_id: z.ZodString;
+    col: z.ZodString;
+    value: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const SyncRequestSchema: z.ZodObject<{
+    node_id: z.ZodString;
+    since: z.ZodNumber;
+    changes: z.ZodArray<z.ZodObject<{
+        hlc: z.ZodString;
+        node_id: z.ZodString;
+        dataset: z.ZodString;
+        row_id: z.ZodString;
+        col: z.ZodString;
+        value: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const SyncResponseSchema: z.ZodObject<{
+    node_id: z.ZodString;
+    changes: z.ZodArray<z.ZodObject<{
+        hlc: z.ZodString;
+        node_id: z.ZodString;
+        dataset: z.ZodString;
+        row_id: z.ZodString;
+        col: z.ZodString;
+        value: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    cursor: z.ZodNumber;
+}, z.core.$strip>;
+export declare const HealthResponseSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    node: z.ZodString;
+}, z.core.$strip>;
+export type SyncRequest = z.infer<typeof SyncRequestSchema> & {
+    changes: CrdtChange[];
+};
+export type SyncResponse = z.infer<typeof SyncResponseSchema> & {
+    changes: CrdtChange[];
+};
+export type HealthResponse = z.infer<typeof HealthResponseSchema>;
+export declare const SYNC_PATH = "/sync";
+export declare const HEALTH_PATH = "/health";
+export declare const RENEW_PATH = "/auth/token";
+//# sourceMappingURL=protocol.d.ts.map

package/dist/core/sync/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/core/sync/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AAMvD,eAAO,MAAM,YAAY;;;;;;;iBAOvB,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAI5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;iBAI7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AAIH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GAAG;IAAE,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AACxF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GAAG;IAAE,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAC1F,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,SAAS,UAAU,CAAC;AACjC,eAAO,MAAM,WAAW,YAAY,CAAC;AAGrC,eAAO,MAAM,UAAU,gBAAgB,CAAC"}

package/dist/core/sync/routes.d.ts

@@ -0,0 +1,22 @@
+import type { ZodType } from "zod";
+import type { Database } from "bun:sqlite";
+/** Injected at server startup; handlers reuse the open DB connection. */
+export interface RouteCtx {
+    db: Database;
+    node: string;
+}
+/**
+ * One entry per endpoint. `request`/`response` are Zod schemas that double as
+ * the OpenAPI source (see ./openapi.ts). Add an endpoint here and it shows up
+ * in /docs automatically — no generate step, no separate spec file.
+ */
+export interface Route {
+    method: "GET" | "POST" | "PATCH" | "DELETE";
+    path: string;
+    summary: string;
+    request?: ZodType;
+    response: ZodType;
+    handler: (req: Request, ctx: RouteCtx) => Promise<Response> | Response;
+}
+export declare const routes: Route[];
+//# sourceMappingURL=routes.d.ts.map

package/dist/core/sync/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/core/sync/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAa3C,yEAAyE;AACzE,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;CACxE;AA6BD,eAAO,MAAM,MAAM,EAAE,KAAK,EAAoD,CAAC"}

package/dist/core/sync/server.d.ts

@@ -0,0 +1,21 @@
+export interface RunningServer {
+    server: ReturnType<typeof Bun.serve>;
+    node: string;
+    port: number;
+    /** The active token, or null in --debug mode (auth disabled). */
+    token: string | null;
+    /** Token expiry (epoch ms); Infinity for a static --token, null when auth is off. */
+    exp: number | null;
+}
+export interface ServerOptions {
+    port?: number;
+    /** Bind address. Defaults to 127.0.0.1; pass "0.0.0.0" to expose. */
+    host?: string;
+    /** Disable auth entirely. */
+    debug?: boolean;
+    /** Custom token. If omitted in non-debug mode, one is generated. */
+    token?: string;
+}
+/** Start the CRDT sync server. It is just another node backed by ~/.metahub. */
+export declare function startServer(opts?: ServerOptions): RunningServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/core/sync/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/core/sync/server.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qFAAqF;IACrF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,GAAE,aAAkB,GAAG,aAAa,CA0FnE"}

package/dist/core/sync/sites-routes.d.ts

@@ -0,0 +1,3 @@
+import type { Route } from "./routes.ts";
+export declare const sitesRoutes: Route[];
+//# sourceMappingURL=sites-routes.d.ts.map

package/dist/core/sync/sites-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sites-routes.d.ts","sourceRoot":"","sources":["../../../src/core/sync/sites-routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAY,MAAM,aAAa,CAAC;AAqCnD,eAAO,MAAM,WAAW,EAAE,KAAK,EAe9B,CAAC"}

package/dist/core/sync/sites-serve.d.ts

@@ -0,0 +1,3 @@
+import type { RouteCtx } from "./routes.ts";
+export declare function serveSite(req: Request, ctx: RouteCtx): Promise<Response | null>;
+//# sourceMappingURL=sites-serve.d.ts.map

package/dist/core/sync/sites-serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sites-serve.d.ts","sourceRoot":"","sources":["../../../src/core/sync/sites-serve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQ5C,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAuBrF"}

package/dist/core/sync/token.d.ts

@@ -0,0 +1,23 @@
+import type { Database } from "bun:sqlite";
+export interface TokenState {
+    token: string;
+    /** Epoch ms; once `now > exp`, the next request rotates. */
+    exp: number;
+    /** The immediately-previous token, exchangeable until `prevExp`. */
+    prev: string | null;
+    /** Epoch ms; how long `prev` stays exchangeable. */
+    prevExp: number;
+}
+/** Parse a duration like "30d" / "24h" / "90m" / "3600" (bare number = seconds). */
+export declare function parseDuration(s: string | undefined, fallbackMs: number): number;
+/** Default token lifetime (override with METAHUB_TOKEN_TTL). */
+export declare const DEFAULT_TTL_MS: number;
+/** Default grace window an old token stays swappable (override with METAHUB_TOKEN_GRACE). */
+export declare const DEFAULT_GRACE_MS: number;
+/** Current persisted state, or null if no token has been minted yet. */
+export declare function readState(db: Database): TokenState | null;
+/** Rotate: current → prev (swappable for `graceMs`), mint a fresh current. */
+export declare function rotate(db: Database, ttlMs: number, graceMs: number): TokenState;
+/** Persisted state, minting or rotating when missing/expired. */
+export declare function loadOrRotate(db: Database, ttlMs: number, graceMs: number): TokenState;
+//# sourceMappingURL=token.d.ts.map

package/dist/core/sync/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/core/sync/token.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQ3C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAiB/E;AAGD,gEAAgE;AAChE,eAAO,MAAM,cAAc,QAAyD,CAAC;AACrF,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,QAA0D,CAAC;AAexF,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,UAAU,GAAG,IAAI,CAUzD;AAED,8EAA8E;AAC9E,wBAAgB,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAc/E;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAIrF"}

package/dist/core/sync/webui-routes.d.ts

@@ -0,0 +1,3 @@
+import type { Route } from "./routes.ts";
+export declare const webuiRoutes: Route[];
+//# sourceMappingURL=webui-routes.d.ts.map

package/dist/core/sync/webui-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webui-routes.d.ts","sourceRoot":"","sources":["../../../src/core/sync/webui-routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAY,MAAM,aAAa,CAAC;AAsInD,eAAO,MAAM,WAAW,EAAE,KAAK,EAyN9B,CAAC"}

package/dist/core/sync/webui.d.ts

@@ -0,0 +1,4 @@
+/** Handle WebUI asset requests. Returns null for anything else so the caller
+ *  can fall through to the API routes. */
+export declare function serveWebui(req: Request): Promise<Response | null>;
+//# sourceMappingURL=webui.d.ts.map

package/dist/core/sync/webui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webui.d.ts","sourceRoot":"","sources":["../../../src/core/sync/webui.ts"],"names":[],"mappings":"AAkmBA;0CAC0C;AAC1C,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAiBvE"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}