@concavejs/runtime-node 0.0.1-alpha.4

package/README.md

@@ -0,0 +1,85 @@
+# @concavejs/runtime-node
+
+Library-first Node.js runtime for Concave.
+
+## Requirements
+
+- Node.js >= 22.5
+- Run with `--experimental-sqlite`
+
+## Install
+
+```bash
+npm install @concavejs/runtime-node @concavejs/docstore-node-sqlite @concavejs/blobstore-node-fs
+```
+
+## Quick start
+
+```ts
+import { createConcave } from "@concavejs/runtime-node";
+
+const server = createConcave({
+  convexDir: "./convex",
+});
+
+await server.listen({ port: 3000, hostname: "127.0.0.1" });
+console.log(server.url);
+```
+
+## Custom adapters
+
+```ts
+import { createConcave, SqliteDocStore, FsBlobStore } from "@concavejs/runtime-node";
+
+const server = createConcave({
+  convexDir: "./convex",
+  docstore: new SqliteDocStore("./data/db.sqlite"),
+  blobstore: new FsBlobStore("./data/storage"),
+});
+
+await server.listen({ port: 3000 });
+```
+
+You can also pass builders:
+
+```ts
+const server = createConcave({
+  convexDir: "./convex",
+  docstore: ({ runtime }) => {
+    if (runtime !== "node") throw new Error("Unexpected runtime");
+    return new SqliteDocStore("./data/db.sqlite");
+  },
+  blobstore: () => new FsBlobStore("./data/storage"),
+});
+```
+
+## Module loading
+
+```ts
+const server = createConcave({
+  modules: {
+    "messages.ts": () => import("./convex/messages.ts"),
+  },
+});
+```
+
+`modules` also accepts a single loader function or an array of loader sources.
+
+## API
+
+```ts
+type ConcaveOptions = {
+  convexDir?: string;
+  docstore?: DocStore | ((context: { runtime: "node"; options: Readonly<ConcaveOptions> }) => DocStore);
+  blobstore?: BlobStore | ((context: { runtime: "node"; options: Readonly<ConcaveOptions> }) => BlobStore);
+  schema?: "auto" | "skip";
+  modules?: ModuleLoader | Record<string, ModuleRegistryEntry> | Array<ModuleLoader | Record<string, ModuleRegistryEntry>>;
+};
+
+type Server = {
+  listen(options?: { port?: number; hostname?: string }): Promise<void>;
+  close(): Promise<void>;
+  readonly url: string;
+  readonly port: number;
+};
+```

package/dist/factory.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Library-first factory API for Concave Node runtime.
+ */
+import type { DocStore } from "@concavejs/core/docstore";
+import type { BlobStore } from "@concavejs/core/abstractions";
+import { NodeServer, type NodeBlobStoreFactory, type NodeDocStoreFactory, type NodeModuleSources, type SchemaBootstrapMode } from "./server";
+/**
+ * Options for createConcave().
+ */
+export interface ConcaveOptions {
+    /**
+     * Document storage provider.
+     * Defaults to SqliteDocStore at ./.concave/local/db.sqlite.
+     */
+    docstore?: DocStore | NodeDocStoreFactory;
+    /**
+     * Blob storage provider.
+     * Defaults to FsBlobStore at ./.concave/local/storage.
+     */
+    blobstore?: BlobStore | NodeBlobStoreFactory;
+    /**
+     * Module sources for loading UDF files.
+     * Accepts a loader function, a loader list, or a module map.
+     */
+    modules?: NodeModuleSources;
+    /**
+     * Path to convex/ directory with UDF modules.
+     */
+    convexDir?: string;
+    /**
+     * Path to the directory containing root UDF modules (defaults to convexDir).
+     */
+    functionsDir?: string;
+    /**
+     * Schema bootstrap mode.
+     * "auto" (default) loads schema indexes when available, "skip" disables schema loading.
+     */
+    schema?: SchemaBootstrapMode;
+    /**
+     * Pre-rendered dashboard HTML for /_dashboard responses.
+     */
+    dashboardHtml?: string;
+    /**
+     * Whether this server is running in dev mode.
+     * Controls whether logLines are sent on the wire. Defaults to true.
+     */
+    isDev?: boolean;
+}
+/**
+ * Create a configured Node server instance.
+ *
+ * Use `await server.listen({ port, hostname })` to start serving.
+ */
+export declare function createConcave(options?: ConcaveOptions): NodeServer;