@podosoft/podokit 0.17.4 → 1.0.2

package/dist/templates/todo/infra/docker/docker-compose.yml

@@ -1,33 +0,0 @@
-services:
-  # --- Runtime (always started by `docker compose up`) ---
-  postgres:
-    image: postgres:16-alpine
-    environment:
-      POSTGRES_USER: ${POSTGRES_USER:-podokit}
-      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-podokit}
-      POSTGRES_DB: ${POSTGRES_DB:-podokit}
-    ports:
-      - "${POSTGRES_PORT:-5432}:5432"
-    volumes:
-      - pgdata:/var/lib/postgresql/data
-    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-podokit}"]
-      interval: 5s
-      timeout: 5s
-      retries: 5
-
-  # --- Runtime, but only needed by cache/queue modules. Start with:
-  #     docker compose --profile cache up
-  redis:
-    image: redis:7-alpine
-    profiles: ["cache"]
-    ports:
-      - "${REDIS_PORT:-6379}:6379"
-    healthcheck:
-      test: ["CMD", "redis-cli", "ping"]
-      interval: 5s
-      timeout: 5s
-      retries: 5
-
-volumes:
-  pgdata:

package/dist/templates/todo/infra/k3s/README.md

@@ -1,18 +0,0 @@
-# Example k3s manifests
-
-These are **illustrative**. `podo deploy` does not read or apply them.
-
-For a real deployment, initialize a profile and let PodoKit render the manifests it
-will actually apply — with image digests, probes, disruption budgets, a migration
-Job, and a confirmation hash:
-
-```bash
-podo deploy init --profile production --context production --host app.example.com
-podo deploy render --profile production --release v1.2.3
-```
-
-Keep these files if you want a starting point for hand-managed manifests, or delete
-the directory if you deploy with `podo deploy`. If you do apply them by hand, replace
-every `example.com` and `ghcr.io/example/...` placeholder first, and note that the
-image tags below are placeholders too: the deployment tooling rejects `latest`,
-branch tags, and empty tags, and so should you.

package/dist/templates/todo/infra/k3s/api-deployment.yaml

@@ -1,29 +0,0 @@
-# Example only. See README.md in this directory; `podo deploy` renders its own.
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  name: api
-  namespace: podokit
-spec:
-  replicas: 1
-  selector:
-    matchLabels: { app: api }
-  template:
-    metadata:
-      labels: { app: api }
-    spec:
-      containers:
-        - name: api
-          # Placeholder. Use one immutable, stable SemVer tag for api and web.
-          image: ghcr.io/example/podokit-api:v0.0.0
-          ports:
-            - containerPort: 3000
-          envFrom:
-            - configMapRef: { name: app-config }
-            - secretRef: { name: app-secrets }
-          readinessProbe:
-            httpGet: { path: /health/ready, port: 3000 }
-            initialDelaySeconds: 5
-          livenessProbe:
-            httpGet: { path: /health, port: 3000 }
-            initialDelaySeconds: 15

package/dist/templates/todo/infra/k3s/configmap.yaml

@@ -1,12 +0,0 @@
-apiVersion: v1
-kind: ConfigMap
-metadata:
-  name: app-config
-  namespace: podokit
-data:
-  NODE_ENV: "production"
-  PORT: "3000"
-  CORS_ORIGIN: "https://example.com"
-  BACKEND_INTERNAL_URL: "http://api:3000"
-  ADDRESS_HEADER: "x-forwarded-for"
-  XFF_DEPTH: "1"

package/dist/templates/todo/infra/k3s/ingress.yaml

@@ -1,32 +0,0 @@
-# Example only. See README.md in this directory; `podo deploy` renders its own.
-apiVersion: traefik.io/v1alpha1
-kind: Middleware
-metadata:
-  name: compression
-  namespace: podokit
-spec:
-  compress: {}
----
-apiVersion: networking.k8s.io/v1
-kind: Ingress
-metadata:
-  name: app
-  namespace: podokit
-  annotations:
-    traefik.ingress.kubernetes.io/router.middlewares: podokit-compression@kubernetescrd
-spec:
-  # Name the controller explicitly rather than relying on a default IngressClass.
-  ingressClassName: traefik
-  # app-config sets an https:// origin, so the route has to terminate TLS. Create the
-  # Secret out of band (cert-manager, or an existing certificate) and name it here.
-  tls:
-    - hosts: [example.com]
-      secretName: app-tls
-  rules:
-    - host: example.com
-      http:
-        paths:
-          - path: /
-            pathType: Prefix
-            backend:
-              service: { name: web, port: { number: 3000 } }

package/dist/templates/todo/infra/k3s/namespace.yaml

@@ -1,4 +0,0 @@
-apiVersion: v1
-kind: Namespace
-metadata:
-  name: podokit

package/dist/templates/todo/infra/k3s/secret.example.yaml

@@ -1,10 +0,0 @@
-# Example only. Never commit real secrets. Create the real Secret out-of-band:
-#   kubectl -n podokit create secret generic app-secrets --from-literal=POSTGRES_PASSWORD=...
-apiVersion: v1
-kind: Secret
-metadata:
-  name: app-secrets
-  namespace: podokit
-type: Opaque
-stringData:
-  POSTGRES_PASSWORD: "change-me"

package/dist/templates/todo/infra/k3s/services.yaml

@@ -1,21 +0,0 @@
-apiVersion: v1
-kind: Service
-metadata:
-  name: api
-  namespace: podokit
-spec:
-  selector: { app: api }
-  ports:
-    - port: 3000
-      targetPort: 3000
----
-apiVersion: v1
-kind: Service
-metadata:
-  name: web
-  namespace: podokit
-spec:
-  selector: { app: web }
-  ports:
-    - port: 3000
-      targetPort: 3000

package/dist/templates/todo/infra/k3s/web-deployment.yaml

@@ -1,30 +0,0 @@
-# Example only. See README.md in this directory; `podo deploy` renders its own.
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  name: web
-  namespace: podokit
-spec:
-  replicas: 1
-  selector:
-    matchLabels: { app: web }
-  template:
-    metadata:
-      labels: { app: web }
-    spec:
-      containers:
-        - name: web
-          # Placeholder. Use one immutable, stable SemVer tag for api and web.
-          image: ghcr.io/example/podokit-web:v0.0.0
-          ports:
-            - containerPort: 3000
-          envFrom:
-            - configMapRef: { name: app-config }
-          # Without these a rolling update sends traffic to a process that has not
-          # bound its port yet.
-          readinessProbe:
-            httpGet: { path: /, port: 3000 }
-            initialDelaySeconds: 5
-          livenessProbe:
-            httpGet: { path: /, port: 3000 }
-            initialDelaySeconds: 15

package/dist/templates/todo/infra/traefik/dynamic.yml

@@ -1,17 +0,0 @@
-# Traefik dynamic config (file provider). Routes the browser-facing web app;
-# api/postgres/redis/minio stay internal (reached by service name).
-http:
-  routers:
-    web:
-      rule: "PathPrefix(`/`)"  # any host on this dedicated proxy -> web
-      entryPoints: [web]
-      middlewares: [compression]
-      service: web
-  middlewares:
-    compression:
-      compress: {}
-  services:
-    web:
-      loadBalancer:
-        servers:
-          - url: "http://web:5001"

package/dist/templates/todo/package.json

@@ -1,21 +0,0 @@
-{
-  "name": "{{projectName}}",
-  "version": "0.0.0",
-  "private": true,
-  "engines": {
-    "node": ">=22.22.1"
-  },
-  "workspaces": [
-    "apps/*",
-    "tests"
-  ],
-  "scripts": {
-    "dev": "npm run dev --workspaces --if-present",
-    "build": "npm run build --workspaces --if-present",
-    "lint": "npm run lint --workspaces --if-present",
-    "test": "npm run test --workspaces --if-present",
-    "test:e2e": "npm run test:e2e -w tests",
-    "test:e2e:ui": "npm run test:e2e:ui -w tests",
-    "test:e2e:api": "npm run test:e2e:api -w tests"
-  }
-}

package/dist/templates/todo/tests/README.md

@@ -1,21 +0,0 @@
-# tests
-
-End-to-end tests for this app, run with [`@playwright/test`](https://playwright.dev):
-
-```bash
-npm run test:e2e         # all specs (api + ui)
-npm run test:e2e:api     # backend endpoints (request-only)
-npm run test:e2e:ui      # pages (chromium)
-npm run test:e2e:report  # open the HTML report
-```
-
-The suite runs against a live stack (web on `E2E_BASE_URL`, proxying `/api/*` to
-the API). With the recommended containerized loop, start `podo dev watch` and run:
-
-```bash
-E2E_BASE_URL=http://{{projectName}}.localhost npm run test:e2e
-```
-
-The default `http://localhost:5001` is for the alternative `npm run dev`
-host-process loop. Files ending in `*.api.spec.ts` run in the request-only `api`
-project; `*.ui.spec.ts` run in the chromium `ui` project.

package/dist/templates/todo/tests/api/health.api.spec.ts

@@ -1,14 +0,0 @@
-import { expect, test } from "@playwright/test";
-
-// Health endpoints are public and present in every generated app.
-test("GET /health is public and ok @smoke", async ({ request }) => {
-  const res = await request.get("/api/health");
-  expect(res.ok()).toBeTruthy();
-  expect((await res.json()).status).toBe("ok");
-});
-
-test("GET /health/ready reports the database", async ({ request }) => {
-  const res = await request.get("/api/health/ready");
-  expect(res.status()).toBe(200);
-  expect((await res.json()).status).toBe("ready");
-});

package/dist/templates/todo/tests/package.json

@@ -1,15 +0,0 @@
-{
-  "name": "{{projectName}}-tests",
-  "version": "0.0.0",
-  "private": true,
-  "scripts": {
-    "test:e2e": "playwright test",
-    "test:e2e:ui": "playwright test --project=ui",
-    "test:e2e:api": "playwright test --project=api",
-    "test:e2e:report": "playwright show-report"
-  },
-  "devDependencies": {
-    "@playwright/test": "^1.61.1",
-    "otpauth": "^9.5.1"
-  }
-}

package/dist/templates/todo/tests/playwright.config.ts

@@ -1,27 +0,0 @@
-import { defineConfig, devices } from "@playwright/test";
-import { loadPlaywrightProjects } from "./playwright.extensions";
-
-// The suite runs against a live stack: web on E2E_BASE_URL (proxying /api/* to
-// the API). Start it first (see docs/testing.md) — locally via the dev harness,
-// in CI via scripts/e2e-ci.mjs. Two projects: `api` (request-only, backend e2e)
-// and `ui` (chromium, pages). Files are routed by suffix (*.api/*.ui.spec.ts).
-const baseURL = process.env.E2E_BASE_URL ?? "http://localhost:5001";
-const coreProjects = [
-  { name: "api", testMatch: /.*\.api\.spec\.ts/ },
-  { name: "ui", testMatch: /.*\.ui\.spec\.ts/, use: { ...devices["Desktop Chrome"] } },
-];
-
-export default defineConfig({
-  testDir: ".",
-  fullyParallel: true,
-  forbidOnly: !!process.env.CI,
-  retries: process.env.CI ? 2 : 0,
-  workers: process.env.CI ? 1 : undefined,
-  reporter: [["list"], ["html", { open: "never" }]],
-  use: {
-    baseURL,
-    trace: "on-first-retry",
-    screenshot: "only-on-failure",
-  },
-  projects: [...coreProjects, ...loadPlaywrightProjects(coreProjects)],
-});

package/dist/templates/todo/tests/playwright.extensions.ts

@@ -1,44 +0,0 @@
-import { existsSync } from "node:fs";
-import { createRequire } from "node:module";
-import { join } from "node:path";
-import type { TestConfig } from "@playwright/test";
-
-type Projects = NonNullable<TestConfig["projects"]>;
-
-const requireFromTests = createRequire(__filename);
-
-function projectName(project: unknown): string | null {
-  if (typeof project !== "object" || project === null || !("name" in project)) return null;
-  return typeof project.name === "string" && project.name.length > 0 ? project.name : null;
-}
-
-/**
- * Merge application-owned Playwright projects into PodoKit's managed config.
- * The optional CommonJS file stays owned so applications can add devices and
- * browsers without creating a 3-way merge hotspot in playwright.config.ts.
- */
-export function loadPlaywrightProjects(coreProjects: Projects): Projects {
-  const extensionPath = join(__dirname, "playwright.projects.cjs");
-  if (!existsSync(extensionPath)) return [];
-
-  const loaded = requireFromTests(extensionPath) as unknown;
-  if (!Array.isArray(loaded)) {
-    throw new Error("tests/playwright.projects.cjs must export an array of Playwright projects.");
-  }
-
-  const names = new Set(
-    coreProjects.map((project) => projectName(project)).filter((name): name is string => name !== null),
-  );
-  for (const project of loaded) {
-    const name = projectName(project);
-    if (!name) {
-      throw new Error("Every project in tests/playwright.projects.cjs must have a non-empty name.");
-    }
-    if (names.has(name)) {
-      throw new Error(`Duplicate Playwright project name: ${name}`);
-    }
-    names.add(name);
-  }
-
-  return loaded as Projects;
-}

package/dist/templates/todo/tests/ui/smoke.ui.spec.ts

@@ -1,8 +0,0 @@
-import { expect, test } from "@playwright/test";
-
-// Module-agnostic: the app responds at "/" (a page or a redirect to it).
-test("app is reachable @smoke", async ({ page }) => {
-  const res = await page.goto("/");
-  expect(res?.status()).toBeLessThan(400);
-  await expect(page.locator("body")).toBeVisible();
-});