@tekki-forge/generator-docker 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# @tekki-forge/generator-docker
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Forge generator: IR -> Docker and Compose configuration.
+
+Part of [Tekki Forge](https://www.npmjs.com/package/tekki-forge), which turns a `forge.config.ts` into a production-ready full-stack app. Apps created with `forge new` install this package for you; see the [tekki-forge](https://www.npmjs.com/package/tekki-forge) package for the documentation.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { type AppIR, type GeneratedFile, type Generator } from "@tekki-forge/compiler";
+/**
+ * Docker files are developer-owned after creation (scaffold): teams customize them.
+ * `forge docker --force` rewrites them from the current template.
+ */
+export declare function dockerFiles(ir: AppIR, ownership?: GeneratedFile["ownership"]): GeneratedFile[];
+export declare const dockerGenerator: Generator;

package/dist/index.js

@@ -0,0 +1,135 @@
+import {} from "@tekki-forge/compiler";
+import { stringify } from "yaml";
+/**
+ * Docker files are developer-owned after creation (scaffold): teams customize them.
+ * `forge docker --force` rewrites them from the current template.
+ */
+export function dockerFiles(ir, ownership = "scaffold") {
+    const db = ir.slug.replace(/-/g, "_");
+    const apiEnv = {
+        DATABASE_URL: `postgresql://app:app@postgres:5432/${db}`,
+        BETTER_AUTH_SECRET: "${BETTER_AUTH_SECRET:-change-me-in-production-use-openssl-rand-base64-32}",
+        BETTER_AUTH_URL: "${PUBLIC_URL:-http://localhost:${WEB_PORT:-3000}}",
+        PORT: "4000",
+        SEED: "${SEED:-true}",
+        ADMIN_EMAIL: "${ADMIN_EMAIL:-admin@example.com}",
+        ADMIN_PASSWORD: "${ADMIN_PASSWORD:-admin12345}",
+        SMTP_URL: "${SMTP_URL:-}",
+        RESEND_API_KEY: "${RESEND_API_KEY:-}",
+        EMAIL_FROM: "${EMAIL_FROM:-}",
+    };
+    for (const p of ir.auth.social) {
+        const key = p.toUpperCase();
+        apiEnv[`${key}_CLIENT_ID`] = `\${${key}_CLIENT_ID:-}`;
+        apiEnv[`${key}_CLIENT_SECRET`] = `\${${key}_CLIENT_SECRET:-}`;
+    }
+    const dependsOn = { postgres: { condition: "service_healthy" } };
+    const services = {
+        postgres: {
+            image: "postgres:17-alpine",
+            restart: "unless-stopped",
+            environment: { POSTGRES_DB: db, POSTGRES_USER: "app", POSTGRES_PASSWORD: "app" },
+            ports: ["${POSTGRES_PORT:-5432}:5432"],
+            volumes: ["postgres_data:/var/lib/postgresql/data"],
+            healthcheck: { test: ["CMD-SHELL", `pg_isready -U app -d ${db}`], interval: "3s", timeout: "3s", retries: 20 },
+        },
+    };
+    const volumes = { postgres_data: null };
+    for (const plugin of ir.plugins) {
+        for (const [name, svc] of Object.entries(plugin.docker.services)) {
+            services[name] = { restart: "unless-stopped", ...svc };
+            dependsOn[name] = { condition: svc.healthcheck ? "service_healthy" : "service_started" };
+        }
+        for (const v of plugin.docker.volumes)
+            volumes[v] = null;
+        for (const e of plugin.env)
+            if (e.docker !== undefined)
+                apiEnv[e.name] = `\${${e.name}:-${e.docker}}`;
+    }
+    const workers = ir.plugins.some((p) => p.runtime.worker);
+    if (workers && ir.backups)
+        volumes.backups = null;
+    services.api = {
+        build: { context: ".", dockerfile: "Dockerfile.api" },
+        restart: "unless-stopped",
+        depends_on: dependsOn,
+        environment: apiEnv,
+        ports: ["${API_PORT:-4000}:4000"],
+    };
+    if (workers) {
+        services.worker = {
+            build: { context: ".", dockerfile: "Dockerfile.api" },
+            restart: "unless-stopped",
+            command: ["sh", "-c", "pnpm worker"],
+            depends_on: { ...dependsOn, api: { condition: "service_started" } },
+            environment: { ...apiEnv, SEED: "false", ...(ir.backups ? { FORGE_BACKUP_DIR: "/backups" } : {}) },
+            // Scheduled backups (backups in forge.config.ts) land here unless the storage plugin uses S3.
+            ...(ir.backups ? { volumes: ["backups:/backups"] } : {}),
+        };
+    }
+    services.web = {
+        build: { context: ".", dockerfile: "Dockerfile.web" },
+        restart: "unless-stopped",
+        depends_on: ["api"],
+        environment: { API_INTERNAL_URL: "http://api:4000" },
+        ports: ["${WEB_PORT:-3000}:3000"],
+    };
+    const compose = `# Generated by Forge. Safe to edit — \`forge generate\` never touches this file.\n${stringify({ name: ir.slug, services, volumes }, { lineWidth: 0, nullStr: "", aliasDuplicateObjects: false })}`;
+    const base = `FROM node:24-alpine AS base
+ENV PNPM_HOME=/pnpm PATH=/pnpm:$PATH CI=true NEXT_TELEMETRY_DISABLED=1
+RUN corepack enable
+WORKDIR /app
+`;
+    const dockerfileApi = `# Generated by Forge. Safe to edit.
+${base}
+FROM base AS deps
+COPY . .
+RUN pnpm install --frozen-lockfile --filter "@app/api..." \\
+ && pnpm --filter @app/database exec prisma generate
+
+FROM deps AS runner
+ENV NODE_ENV=production
+# pg_dump/psql matching the PostgreSQL 17 server, for scheduled backups (forge backup).
+RUN apk add --no-cache postgresql17-client
+WORKDIR /app/apps/api
+EXPOSE 4000
+CMD ["sh", "-c", "pnpm --filter @app/database exec prisma migrate deploy && if [ \\"$SEED\\" = \\"true\\" ]; then pnpm seed; fi && pnpm start"]
+`;
+    const dockerfileWeb = `# Generated by Forge. Safe to edit.
+${base}
+FROM base AS build
+COPY . .
+RUN pnpm install --frozen-lockfile --filter "@app/web..." \\
+ && pnpm --filter @app/web build
+
+FROM base AS runner
+ENV NODE_ENV=production HOSTNAME=0.0.0.0 PORT=3000
+WORKDIR /app
+COPY --from=build /app/apps/web/.next/standalone ./
+COPY --from=build /app/apps/web/.next/static ./apps/web/.next/static
+COPY --from=build /app/apps/web/public ./apps/web/public
+EXPOSE 3000
+CMD ["node", "apps/web/server.js"]
+`;
+    const dockerignore = `**/node_modules
+**/.next
+**/dist
+**/.turbo
+**/src/generated/prisma
+.env
+.env.*
+!.env.example
+.git
+`;
+    return [
+        { path: "docker-compose.yml", contents: compose, ownership },
+        { path: "Dockerfile.api", contents: dockerfileApi, ownership },
+        { path: "Dockerfile.web", contents: dockerfileWeb, ownership },
+        { path: ".dockerignore", contents: dockerignore, ownership },
+    ];
+}
+export const dockerGenerator = {
+    name: "docker",
+    generate: (ir) => dockerFiles(ir),
+};
+//# 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

@@ -1,6 +1,39 @@
 {
   "name": "@tekki-forge/generator-docker",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Forge generator: IR -> Docker and Compose configuration",
+  "keywords": [
+    "code-generator",
+    "forge",
+    "full-stack",
+    "tekki-forge"
+  ],
+  "author": "Mahy KANE",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "yaml": "^2.9.1",
+    "@tekki-forge/compiler": "^0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }