otok-adapter-node 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kamod
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# otok-adapter-node
+
+Node.js deployment adapter for [Otok](https://github.com/kamod-ch/otok).
+
+## Usage
+
+```ts
+import { defineConfig } from "@kamod-ch/otok";
+import node from "otok-adapter-node";
+
+export default defineConfig({
+  adapter: node({
+    outDir: "dist",
+    port: 3000,
+    host: "0.0.0.0",
+  }),
+});
+```
+
+## Features
+
+- Standalone server build (`dist/server/server.js`)
+- Configurable `HOST` and `PORT` at runtime
+- Immutable cache headers for hashed assets
+- Graceful shutdown on `SIGTERM` / `SIGINT`
+- Full Node.js environment access (`process.env`, filesystem)
+
+## Operations
+
+### Docker
+
+See `examples/adapters/node/Dockerfile`.
+
+### systemd
+
+```ini
+[Service]
+Environment=NODE_ENV=production
+Environment=PORT=3000
+ExecStart=/usr/bin/node dist/server/server.js
+KillSignal=SIGTERM
+```
+
+## Capabilities
+
+`node-apis`, `filesystem`, `process-env`, `graceful-shutdown`, `ssr`, `streaming`, `middleware`, `server-actions`, `islands`, `static-assets`

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+export interface NodeAdapterOptions {
+    /** Output root directory. Defaults to `dist`. */
+    outDir?: string;
+    /** Default bind host when the generated server starts. Overridable via `HOST`. */
+    host?: string;
+    /** Default port when the generated server starts. Overridable via `PORT`. */
+    port?: number;
+    /** Project-relative server entry. When omitted, the adapter generates one at build time. */
+    serverEntry?: string;
+    /** Cache-Control header for hashed static assets. */
+    assetCacheControl?: string;
+    /**
+     * When true, the generated server wires `RedisCacheProvider` from
+     * `UPSTASH_REDIS_REST_URL` + `UPSTASH_REDIS_REST_TOKEN` (or `OTOK_REDIS_REST_*`).
+     */
+    redisCache?: boolean;
+}
+declare const GENERATED_SERVER_ENTRY = "src/otok.generated.server.ts";
+declare function outputDirs(options: NodeAdapterOptions): {
+    root: string;
+    client: string;
+    server: string;
+};
+declare function generatedServerSource(options: NodeAdapterOptions): string;
+declare const nodeAdapterFactory: (options?: NodeAdapterOptions | undefined) => import("@kamod-ch/otok-config").OtokAdapter<NodeAdapterOptions>;
+/** Node.js adapter with standalone server output, static assets, and graceful shutdown. */
+export default function node(options?: NodeAdapterOptions): import("@kamod-ch/otok-config").OtokAdapter<NodeAdapterOptions>;
+export { node, nodeAdapterFactory, GENERATED_SERVER_ENTRY, generatedServerSource, outputDirs as nodeOutputDirs };
+//# 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":"AAIA,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAgBD,QAAA,MAAM,sBAAsB,iCAAiC,CAAC;AAE9D,iBAAS,UAAU,CAAC,OAAO,EAAE,kBAAkB;;;;EAO9C;AAED,iBAAS,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAsElE;AAUD,QAAA,MAAM,kBAAkB,+GAiEtB,CAAC;AAEH,2FAA2F;AAC3F,MAAM,CAAC,OAAO,UAAU,IAAI,CAAC,OAAO,GAAE,kBAAuB,mEAO5D;AAED,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,UAAU,IAAI,cAAc,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,178 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createDualBuildVitePlugin, defineAdapter } from "@kamod-ch/otok-config";
+const NODE_CAPABILITIES = [
+    "node-apis",
+    "filesystem",
+    "process-env",
+    "graceful-shutdown",
+    "ssr",
+    "streaming",
+    "middleware",
+    "server-actions",
+    "islands",
+    "static-assets",
+];
+const DEFAULT_OUT_DIR = "dist";
+const GENERATED_SERVER_ENTRY = "src/otok.generated.server.ts";
+function outputDirs(options) {
+    const root = options.outDir ?? DEFAULT_OUT_DIR;
+    return {
+        root,
+        client: path.posix.join(root, "client"),
+        server: path.posix.join(root, "server"),
+    };
+}
+function generatedServerSource(options) {
+    const outDirs = outputDirs(options);
+    const port = options.port ?? 3000;
+    const host = options.host ?? "0.0.0.0";
+    const cacheControl = options.assetCacheControl ?? "public, max-age=31536000, immutable";
+    const redisCache = options.redisCache === true;
+    const redisBootstrap = redisCache
+        ? `
+import { setCacheProvider, RedisCacheProvider, createRedisRestClient } from "@kamod-ch/otok/cache";
+
+const redisUrl = process.env.UPSTASH_REDIS_REST_URL ?? process.env.OTOK_REDIS_REST_URL;
+const redisToken = process.env.UPSTASH_REDIS_REST_TOKEN ?? process.env.OTOK_REDIS_REST_TOKEN;
+if (redisUrl && redisToken) {
+  setCacheProvider(new RedisCacheProvider({
+    client: createRedisRestClient({ url: redisUrl, token: redisToken }),
+  }));
+}
+`
+        : "";
+    return `import { serve } from "@hono/node-server";
+import { createOtokAppAsync, readOtokManifest } from "@kamod-ch/otok/server";
+import { loadOtokResolvedConfig } from "virtual:otok-config";
+import { errorRoute, notFoundRoute, routes } from "virtual:otok-routes";
+${redisBootstrap}
+const { runtime, applyAppPlugins, collectPluginRoutes, transformHtml } = await loadOtokResolvedConfig();
+const pluginRoutes = await collectPluginRoutes();
+
+const app = await createOtokAppAsync({
+  routes: [...routes, ...(pluginRoutes as typeof routes)],
+  notFoundRoute,
+  errorRoute,
+  ...runtime,
+  manifest: readOtokManifest(import.meta.url),
+  clientEntry: ${JSON.stringify("src/client.ts")},
+  devClientEntry: "/src/client.ts",
+  devStylesheets: ["/src/styles.css"],
+  staticDir: ${JSON.stringify(`./${outDirs.client}`)},
+  assetCacheControl: ${JSON.stringify(cacheControl)},
+  health: { ok: true, runtime: "node", adapter: "otok-adapter-node" },
+  transformHtml,
+  configure: (app) => applyAppPlugins(app),
+  theme: runtime.theme ?? true,
+});
+
+export default app;
+
+if (import.meta.env.PROD) {
+  const port = Number(process.env.PORT ?? ${JSON.stringify(String(port))});
+  const hostname = process.env.HOST ?? ${JSON.stringify(host)};
+  const server = serve({ fetch: app.fetch, port, hostname }, (info) => {
+    console.info(\`Otok server listening on http://\${info.address}:\${info.port}\`);
+  });
+
+  const shutdown = (signal: NodeJS.Signals) => {
+    console.info(\`Received \${signal}; shutting down Otok server...\`);
+    server.close((error) => {
+      if (error) {
+        console.error(error);
+        process.exit(1);
+      }
+      process.exit(0);
+    });
+  };
+
+  process.once("SIGTERM", shutdown);
+  process.once("SIGINT", shutdown);
+}
+`;
+}
+async function writeGeneratedServer(ctx, options) {
+    if (options.serverEntry)
+        return;
+    const target = path.resolve(ctx.root, GENERATED_SERVER_ENTRY);
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.writeFileSync(target, generatedServerSource(options));
+}
+const nodeAdapterFactory = defineAdapter({
+    name: "otok-adapter-node",
+    runtime: "node",
+    capabilities: NODE_CAPABILITIES,
+    build: {
+        clientEntry: "src/client.ts",
+        ssrEntry: GENERATED_SERVER_ENTRY,
+        ssrTarget: "node",
+        clientManifest: true,
+    },
+    outputDirs(options, _root) {
+        return outputDirs(options);
+    },
+    async serverEntry(ctx) {
+        const options = ctx.options;
+        const entry = options.serverEntry ?? GENERATED_SERVER_ENTRY;
+        return {
+            path: entry,
+            generated: !options.serverEntry,
+        };
+    },
+    assets: {
+        cacheControl: "public, max-age=31536000, immutable",
+        assetsPath: "/assets",
+    },
+    environment: {
+        processEnv: true,
+    },
+    ssr: {
+        supported: true,
+        streaming: true,
+    },
+    middleware: {
+        supported: true,
+    },
+    prerender: {
+        supported: false,
+    },
+    hooks: {
+        async buildStart(ctx) {
+            const options = ctx.adapter.options;
+            await writeGeneratedServer(ctx, options);
+        },
+        async buildEnd(ctx) {
+            if (!ctx.isSsrBuild)
+                return;
+            const options = ctx.adapter.options;
+            await writeGeneratedServer(ctx, options);
+        },
+    },
+    configureVite(ctx) {
+        const options = ctx.options;
+        const outDirs = outputDirs(options);
+        const serverEntry = options.serverEntry ?? GENERATED_SERVER_ENTRY;
+        return createDualBuildVitePlugin({
+            name: "otok-adapter-node",
+            outDirs,
+            build: {
+                clientEntry: "src/client.ts",
+                ssrEntry: serverEntry,
+                ssrTarget: "node",
+                clientManifest: true,
+            },
+        });
+    },
+});
+/** Node.js adapter with standalone server output, static assets, and graceful shutdown. */
+export default function node(options = {}) {
+    const adapter = nodeAdapterFactory(options);
+    adapter.build = {
+        ...adapter.build,
+        ssrEntry: options.serverEntry ?? GENERATED_SERVER_ENTRY,
+    };
+    return adapter;
+}
+export { node, nodeAdapterFactory, GENERATED_SERVER_ENTRY, generatedServerSource, outputDirs as nodeOutputDirs };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "otok-adapter-node",
+  "version": "1.0.0",
+  "description": "Node.js deployment adapter for Otok with standalone server builds, static assets, and graceful shutdown.",
+  "homepage": "https://github.com/kamod-ch/otok/tree/main/packages/otok-adapter-node#readme",
+  "bugs": {
+    "url": "https://github.com/kamod-ch/otok/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kamod-ch/otok.git",
+    "directory": "packages/otok-adapter-node"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@kamod-ch/otok-config": "1.0.0"
+  },
+  "devDependencies": {
+    "@kamod-ch/otok": "1.0.0",
+    "@types/node": "^24.12.2",
+    "otok-adapter-contract": "1.0.0",
+    "typescript": "~6.0.2",
+    "vite": "^8.0.10",
+    "vitest": "^4.1.2"
+  },
+  "peerDependencies": {
+    "@kamod-ch/otok": ">=0.6.1",
+    "vite": ">=6"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}