@concavejs/runtime-node 0.0.1-alpha.4

package/dist/module-loader/fs-module-loader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Filesystem Module Loader for Node.js
+ *
+ * Loads Convex UDF modules from the filesystem with TypeScript support
+ *
+ * Note: TypeScript support requires the tsx loader to be registered via --import flag.
+ * The CLI automatically adds this flag when starting the Node.js runtime.
+ */
+import { FsModuleLoaderBase, type ModuleLoaderConfig } from "@concavejs/runtime-base/module-loader";
+export { type ModuleLoaderConfig };
+export declare class FsModuleLoader extends FsModuleLoaderBase {
+    constructor(config: ModuleLoaderConfig);
+    protected fileExists(path: string): Promise<boolean>;
+    protected importModule(path: string): Promise<any>;
+}

package/dist/server/dev.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Node.js Development Server Entry Point
+ *
+ * This script is spawned by the CLI to run the Node.js dev server.
+ * Must be run with Node.js 22.5+ and --experimental-sqlite flag.
+ */
+export {};

package/dist/server/http-handler.d.ts

@@ -0,0 +1,12 @@
+/**
+ * HTTP Request Handler for Node.js
+ *
+ * Thin wrapper around the shared HttpHandler from @concavejs/core
+ */
+import type { UdfExec } from "@concavejs/core/udf";
+import type { UdfExecutionAdapter } from "@concavejs/core/udf/execution-adapter";
+import { HttpHandler, type HttpHandlerOptions } from "@concavejs/core/http";
+export type NodeHttpHandlerOptions = HttpHandlerOptions;
+export declare class NodeHttpHandler extends HttpHandler {
+    constructor(udfExecutor: UdfExec, adapter?: UdfExecutionAdapter, options?: HttpHandlerOptions);
+}

package/dist/server/index.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Node.js Server for Concave
+ *
+ * Single-process server using Node.js HTTP and WebSocket APIs
+ */
+import type { DocStore } from "@concavejs/core/docstore";
+import type { BlobStore } from "@concavejs/core/abstractions";
+import type { ModuleLoader } from "@concavejs/core/udf";
+type ModuleRegistryEntry = (() => Promise<any>) | Promise<any> | any;
+export interface NodeAdapterFactoryContext {
+    runtime: "node";
+    options: Readonly<NodeServerOptions>;
+}
+export type NodeDocStoreFactory = (context: NodeAdapterFactoryContext) => DocStore;
+export type NodeBlobStoreFactory = (context: NodeAdapterFactoryContext) => BlobStore;
+export type NodeModuleMap = Record<string, ModuleRegistryEntry>;
+export type NodeModuleSource = ModuleLoader | NodeModuleMap;
+export type NodeModuleSources = NodeModuleSource | NodeModuleSource[];
+export type SchemaBootstrapMode = "auto" | "skip";
+export interface NodeListenOptions {
+    port?: number;
+    hostname?: string;
+}
+export interface NodeServerOptions {
+    /** Path to the root convex/ directory (used for component scanning). */
+    convexDir?: string;
+    /** Path to the directory containing root UDF modules (defaults to convexDir). */
+    functionsDir?: string;
+    /** Document storage provider */
+    docstore?: DocStore | NodeDocStoreFactory;
+    /** Blob storage provider */
+    blobstore?: BlobStore | NodeBlobStoreFactory;
+    /**
+     * Schema bootstrap behavior.
+     * - "auto": load schema.ts (if present) and register search/vector indexes.
+     * - "skip": do not load schema.ts and initialize with no schema indexes.
+     */
+    schema?: SchemaBootstrapMode;
+    /** Pre-loaded dashboard HTML (avoids bundling dashboard-local) */
+    dashboardHtml?: string;
+    /** Module sources to resolve Convex modules. */
+    modules?: NodeModuleSources;
+    /** Whether this server is running in dev mode. Controls logLines on wire. Defaults to true. */
+    isDev?: boolean;
+}
+export declare class NodeServer {
+    private options;
+    private docstore;
+    private blobstore?;
+    private syncHandler;
+    private httpHandler;
+    private taskExecutor;
+    private runtime;
+    private server?;
+    private wss?;
+    private convexDir?;
+    private functionsDir?;
+    private dashboardHtml?;
+    private schemaMode;
+    private componentLoadersConfigured;
+    private boundPort?;
+    private boundHostname?;
+    private initialized;
+    constructor(options?: NodeServerOptions);
+    /**
+     * Resolve adapters and build runtime internals.
+     * Called once at the start of listen(). Default docstore/blobstore are
+     * loaded via dynamic import() so that node:sqlite is never eagerly required
+     * when the caller provides their own adapter (e.g. better-sqlite3 in Electron).
+     */
+    private init;
+    listen(options?: NodeListenOptions): Promise<void>;
+    close(): Promise<void>;
+    private configureComponentLoaders;
+    private resolveSchemaIndexes;
+    /**
+     * Convert Node.js IncomingMessage to fetch-compatible Request
+     */
+    private nodeRequestToFetch;
+    /**
+     * Serve dashboard static files
+     */
+    private serveDashboard;
+    private getDashboardHtml;
+    get url(): string;
+    get port(): number;
+}
+export {};