@celsian/adapter-railway 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ThenJS
+
+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/dist/index.d.ts

@@ -0,0 +1,38 @@
+export interface RailwayAdapterOptions {
+    /** Node.js version (default: '20') */
+    nodeVersion?: string;
+    /** Health check path (default: '/api/health') */
+    healthCheckPath?: string;
+    /** Enable Railway's restart policy (default: true) */
+    restartPolicy?: boolean;
+    /** Region hint — Railway handles this via dashboard but we document it */
+    region?: string;
+    /** Whether to generate a Dockerfile (default: false — let Nixpacks handle it) */
+    dockerfile?: boolean;
+}
+export interface DeployAdapter {
+    name: string;
+    buildEnd(options: {
+        serverEntry: string;
+        clientDir: string;
+        staticDir: string;
+        outDir: string;
+    }): Promise<void>;
+}
+/**
+ * Create a Railway deployment adapter.
+ *
+ * Usage in then.config.ts:
+ * ```ts
+ * import { railwayAdapter } from '@celsian/adapter-railway';
+ *
+ * export default defineConfig({
+ *   build: {
+ *     adapter: railwayAdapter({ healthCheckPath: '/api/health' }),
+ *   },
+ * });
+ * ```
+ */
+export declare function railwayAdapter(options?: RailwayAdapterOptions): DeployAdapter;
+export default railwayAdapter;
+//# 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":"AAcA,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,OAAO,EAAE;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,aAAa,CAwEjF;AAmCD,eAAe,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,123 @@
+// @celsian/adapter-railway — Deploy CelsianJS apps to Railway
+//
+// Railway supports:
+// - Automatic builds with Nixpacks (detects Node.js)
+// - Custom Dockerfiles
+// - Health checks
+// - Environment variables
+// - Private networking
+//
+// This adapter generates the deployment-specific files that Railway needs.
+import { writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Create a Railway deployment adapter.
+ *
+ * Usage in then.config.ts:
+ * ```ts
+ * import { railwayAdapter } from '@celsian/adapter-railway';
+ *
+ * export default defineConfig({
+ *   build: {
+ *     adapter: railwayAdapter({ healthCheckPath: '/api/health' }),
+ *   },
+ * });
+ * ```
+ */
+export function railwayAdapter(options = {}) {
+    const nodeVersion = options.nodeVersion ?? '20';
+    const healthCheckPath = options.healthCheckPath ?? '/api/health';
+    const generateDockerfile = options.dockerfile ?? false;
+    return {
+        name: 'railway',
+        async buildEnd({ outDir }) {
+            // 1. Generate Procfile — Railway uses this to start the app
+            const procfile = `web: node dist/server/entry.js\n`;
+            await writeFile(join(outDir, 'Procfile'), procfile);
+            // 2. Generate railway.json — deployment config
+            const railwayConfig = {
+                $schema: 'https://railway.app/railway.schema.json',
+                build: {
+                    builder: generateDockerfile ? 'DOCKERFILE' : 'NIXPACKS',
+                    nixpacksPlan: generateDockerfile ? undefined : {
+                        providers: ['node'],
+                        phases: {
+                            setup: { nixPkgs: [`nodejs_${nodeVersion}`] },
+                            install: { cmds: ['npm ci --production'] },
+                        },
+                    },
+                },
+                deploy: {
+                    startCommand: 'node dist/server/entry.js',
+                    healthcheckPath: healthCheckPath,
+                    healthcheckTimeout: 10,
+                    restartPolicyType: options.restartPolicy !== false ? 'ON_FAILURE' : 'NEVER',
+                    restartPolicyMaxRetries: 3,
+                },
+            };
+            await writeFile(join(outDir, 'railway.json'), JSON.stringify(railwayConfig, null, 2) + '\n');
+            // 3. Optionally generate Dockerfile
+            if (generateDockerfile) {
+                const dockerfile = generateRailwayDockerfile(nodeVersion);
+                await writeFile(join(outDir, 'Dockerfile'), dockerfile);
+            }
+            // 4. Generate .env.example for Railway env vars
+            const envExample = [
+                '# CelsianJS — Railway Environment Variables',
+                '# These are automatically injected by Railway',
+                '',
+                '# Server',
+                'PORT=3000',
+                'HOST=0.0.0.0',
+                'NODE_ENV=production',
+                '',
+                '# Railway provides these automatically:',
+                '# RAILWAY_ENVIRONMENT',
+                '# RAILWAY_GIT_COMMIT_SHA',
+                '# RAILWAY_SERVICE_NAME',
+                '',
+            ].join('\n');
+            await writeFile(join(outDir, '.env.example'), envExample);
+            console.log('[celsian:adapter-railway] Generated deployment files:');
+            console.log('  → Procfile');
+            console.log('  → railway.json');
+            if (generateDockerfile)
+                console.log('  → Dockerfile');
+            console.log('  → .env.example');
+        },
+    };
+}
+function generateRailwayDockerfile(nodeVersion) {
+    return `# CelsianJS — Railway Dockerfile
+# Generated by @celsian/adapter-railway
+
+FROM node:${nodeVersion}-alpine AS base
+WORKDIR /app
+
+# Install dependencies
+FROM base AS deps
+COPY package.json package-lock.json* pnpm-lock.yaml* ./
+RUN \\
+  if [ -f pnpm-lock.yaml ]; then corepack enable && pnpm install --frozen-lockfile --prod; \\
+  elif [ -f package-lock.json ]; then npm ci --production; \\
+  else npm install --production; fi
+
+# Production image
+FROM base AS runner
+ENV NODE_ENV=production
+ENV PORT=3000
+ENV HOST=0.0.0.0
+
+COPY --from=deps /app/node_modules ./node_modules
+COPY dist/ ./dist/
+
+EXPOSE 3000
+
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \\
+  CMD wget -qO- http://localhost:3000/api/health || exit 1
+
+CMD ["node", "dist/server/entry.js"]
+`;
+}
+export default railwayAdapter;
+//# 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,27 @@
+{
+  "name": "@celsian/adapter-railway",
+  "version": "0.1.0",
+  "description": "CelsianJS adapter for Railway — generates Procfile, Dockerfile, and health check config",
+  "type": "module",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@celsian/server": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
+}