@ykdz/template 0.0.21 → 0.0.23

package/node_modules/@ykdz/template-builtin-source/package.json

@@ -65,7 +65,6 @@
   "dependencies": {
     "@ykdz/template-core": "workspace:*",
     "@ykdz/template-shared": "workspace:*",
-    "typescript": "catalog:",
     "valibot": "catalog:"
   },
   "devDependencies": {
@@ -73,6 +72,7 @@
     "@playwright/test": "catalog:",
     "@tailwindcss/vite": "catalog:",
     "@types/node": "catalog:",
+    "@typescript/native": "catalog:",
     "@vikejs/hono": "catalog:",
     "@vitejs/plugin-vue": "catalog:",
     "drizzle-kit": "catalog:",

package/node_modules/@ykdz/template-builtin-source/templates/preset-source.json

@@ -223,6 +223,7 @@
         "oxfmt",
         "oxlint",
         "oxlint-tsgolint",
+        "srvx",
         "tailwindcss",
         "telefunc",
         "typescript",
@@ -251,6 +252,8 @@
                 "sourceFiles": [
                   "web/+server.ts",
                   "web/.env.example",
+                  "web/Dockerfile",
+                  "web/Dockerfile.dockerignore",
                   "web/assets/logo.svg",
                   "web/components/CounterButton.vue",
                   "web/components/PageShell.vue",
@@ -261,6 +264,9 @@
                   "web/pages/index/+Page.telefunc.ts",
                   "web/pages/tailwind.css",
                   "web/playwright.config.ts",
+                  "web/scripts/check-standalone-deployment.ts",
+                  "web/scripts/container-entrypoint.sh",
+                  "web/scripts/prepare-database.sh",
                   "web/scripts/run-playwright.ts",
                   "web/turbo.json",
                   "web/server/api.ts",
@@ -306,7 +312,12 @@
           "vike-app/db/turbo.json",
           "vike-app/web/+server.ts",
           "vike-app/web/.env.example",
+          "vike-app/web/Dockerfile",
+          "vike-app/web/Dockerfile.dockerignore",
           "vike-app/web/playwright.config.ts",
+          "vike-app/web/scripts/check-standalone-deployment.ts",
+          "vike-app/web/scripts/container-entrypoint.sh",
+          "vike-app/web/scripts/prepare-database.sh",
           "vike-app/web/vite.config.ts",
           "vike-app/web/turbo.json",
           "vike-app/web/vitest.config.ts"

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/.github/dependabot.yml

@@ -26,3 +26,7 @@ updates:
       - dependency-name: mcr.microsoft.com/devcontainers/typescript-node
         update-types:
           - version-update:semver-major
+  - package-ecosystem: docker
+    directory: /apps/web
+    schedule:
+      interval: weekly

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/.github/workflows/check.yml

@@ -15,6 +15,8 @@ jobs:
         with:
           node-version-file: package.json
       - run: corepack enable
+      - uses: docker/setup-buildx-action@v3
       - run: pnpm install
       - run: pnpm --filter ./apps/web exec playwright install --with-deps chromium
       - run: pnpm run check
+      - run: pnpm run check:deployment

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/db/drizzle/migrations/20260709120325_old_captain_flint/migration.sql

@@ -0,0 +1,6 @@
+CREATE TABLE `todos` (
+	`id` integer PRIMARY KEY AUTOINCREMENT,
+	`title` text NOT NULL UNIQUE,
+	`completed` integer DEFAULT false NOT NULL,
+	`created_at` text DEFAULT (CURRENT_TIMESTAMP) NOT NULL
+);

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/db/drizzle/migrations/20260709120325_old_captain_flint/snapshot.json

@@ -0,0 +1,67 @@
+{
+  "version": "7",
+  "dialect": "sqlite",
+  "id": "0a8f7496-a1ed-412a-a634-7989609bcbe0",
+  "prevIds": ["00000000-0000-0000-0000-000000000000"],
+  "ddl": [
+    {
+      "name": "todos",
+      "entityType": "tables"
+    },
+    {
+      "type": "integer",
+      "notNull": false,
+      "autoincrement": true,
+      "default": null,
+      "generated": null,
+      "name": "id",
+      "entityType": "columns",
+      "table": "todos"
+    },
+    {
+      "type": "text",
+      "notNull": true,
+      "autoincrement": false,
+      "default": null,
+      "generated": null,
+      "name": "title",
+      "entityType": "columns",
+      "table": "todos"
+    },
+    {
+      "type": "integer",
+      "notNull": true,
+      "autoincrement": false,
+      "default": "false",
+      "generated": null,
+      "name": "completed",
+      "entityType": "columns",
+      "table": "todos"
+    },
+    {
+      "type": "text",
+      "notNull": true,
+      "autoincrement": false,
+      "default": "(CURRENT_TIMESTAMP)",
+      "generated": null,
+      "name": "created_at",
+      "entityType": "columns",
+      "table": "todos"
+    },
+    {
+      "columns": ["id"],
+      "nameExplicit": false,
+      "name": "todos_pk",
+      "table": "todos",
+      "entityType": "pks"
+    },
+    {
+      "columns": ["title"],
+      "nameExplicit": false,
+      "name": "todos_title_unique",
+      "entityType": "uniques",
+      "table": "todos"
+    }
+  ],
+  "renames": []
+}

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/db/scripts/seed-example.ts

@@ -0,0 +1,7 @@
+import { createDatabase } from "#db/db";
+import { assertDatabaseReady } from "#db/readiness";
+import { seedExampleData } from "#db/seed/example";
+
+const db = createDatabase();
+assertDatabaseReady(db);
+await seedExampleData(db);

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/db/src/db.ts

@@ -7,11 +7,12 @@ import { defineRelations } from "drizzle-orm/relations";
 import * as schema from "#db/schema";
 
 const relations = defineRelations(schema);
+const defaultDatabaseFile = "./data/app.sqlite";
 
 export type Database = ReturnType<typeof createDatabase>;
 
 export function createDatabase(databaseFile = process.env.DATABASE_FILE) {
-  const file = databaseFile ?? "./data/app.sqlite";
+  const file = databaseFile ?? defaultDatabaseFile;
   mkdirSync(path.dirname(file), { recursive: true });
   return drizzle(file, { relations });
 }

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/db/src/index.ts

@@ -1 +1,2 @@
 export { createDatabase, type Database } from "#db/db";
+export { assertDatabaseReady } from "#db/readiness";

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/db/src/queries/todos.ts

@@ -3,8 +3,20 @@ import { desc, eq } from "drizzle-orm";
 import type { Database } from "#db/db";
 import { todos, type NewTodo } from "#db/schema";
 
+const listTodosStatements = new WeakMap<
+  Database,
+  ReturnType<typeof prepareListTodos>
+>();
+
 export async function listTodos(db: Database) {
-  return db.select().from(todos).orderBy(desc(todos.createdAt));
+  let statement = listTodosStatements.get(db);
+
+  if (!statement) {
+    statement = prepareListTodos(db);
+    listTodosStatements.set(db, statement);
+  }
+
+  return statement.all();
 }
 
 export async function createTodo(db: Database, values: NewTodo) {
@@ -26,3 +38,7 @@ export async function completeTodo(db: Database, id: number) {
 
   return todo;
 }
+
+function prepareListTodos(db: Database) {
+  return db.select().from(todos).orderBy(desc(todos.createdAt)).prepare();
+}

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/db/src/readiness.ts

@@ -0,0 +1,22 @@
+import { sql } from "drizzle-orm";
+
+import type { Database } from "#db/db";
+import { todos } from "#db/schema";
+
+export function assertDatabaseReady(db: Database) {
+  try {
+    db.select({ ready: sql`1` })
+      .from(todos)
+      .limit(1)
+      .all();
+  } catch (cause) {
+    throw new Error(
+      [
+        "Database is not ready.",
+        "For local development, run `pnpm --dir packages/db run db:prepare:dev`.",
+        "For deployment, run `pnpm --dir packages/db run db:prepare:deploy` before starting the app.",
+      ].join(" "),
+      { cause },
+    );
+  }
+}

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/db/src/schema.ts

@@ -3,7 +3,7 @@ import { integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
 
 export const todos = sqliteTable("todos", {
   id: integer({ mode: "number" }).primaryKey({ autoIncrement: true }),
-  title: text().notNull(),
+  title: text().notNull().unique(),
   completed: integer({ mode: "boolean" }).default(false).notNull(),
   createdAt: text("created_at")
     .default(sql`(CURRENT_TIMESTAMP)`)

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/db/src/seed/example.ts

@@ -0,0 +1,23 @@
+import { eq } from "drizzle-orm";
+
+import type { Database } from "#db/db";
+import { todos } from "#db/schema";
+
+const exampleTodos = [
+  "Read the generated TODO.md",
+  "Try the Telefunc todo flow",
+] as const;
+
+export async function seedExampleData(db: Database) {
+  for (const title of exampleTodos) {
+    const existing = await db
+      .select({ id: todos.id })
+      .from(todos)
+      .where(eq(todos.title, title))
+      .limit(1);
+
+    if (existing.length === 0) {
+      await db.insert(todos).values({ title });
+    }
+  }
+}

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/db/test/todos.test.ts

@@ -2,10 +2,12 @@ import { describe, expect, it } from "vitest";
 
 import { createDatabase } from "#db/db";
 import { createTodo, listTodos } from "#db/queries/todos";
+import { assertDatabaseReady } from "#db/readiness";
 
 describe("todo queries", () => {
   it("creates and lists todos through Drizzle SQLite", async () => {
     const db = createDatabase();
+    assertDatabaseReady(db);
     const title = `发布模板 ${Date.now()}`;
 
     await expect(createTodo(db, { title })).resolves.toMatchObject({

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/web/+server.ts

@@ -1,8 +1,9 @@
 import type { Server } from "vike/types";
 
-import { app } from "#/server/app";
+import { createApp } from "#/server/app";
 
 const port = Number.parseInt(process.env.PORT ?? "3000", 10);
+const app = createApp();
 
 export default {
   fetch: app.fetch,

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/web/Dockerfile

@@ -0,0 +1,83 @@
+# syntax=docker/dockerfile:1.7
+
+ARG DEPLOYMENT_BUILD_ID="local"
+
+FROM node:{{NODE_VERSION}}-bookworm-slim AS base
+ARG PACKAGE_MANAGER_PIN="{{PACKAGE_MANAGER_PIN}}"
+ENV COREPACK_HOME="/corepack"
+ENV PNPM_HOME="/pnpm"
+ENV PATH="$PNPM_HOME:$PATH"
+WORKDIR /repo
+RUN corepack enable && corepack prepare "$PACKAGE_MANAGER_PIN" --activate
+
+FROM base AS pruner
+COPY pnpm-lock.yaml pnpm-workspace.yaml ./
+RUN pnpm fetch
+COPY package.json turbo.json ./
+COPY apps/web/package.json apps/web/package.json
+COPY packages/db/package.json packages/db/package.json
+RUN pnpm install --offline --frozen-lockfile
+COPY . .
+RUN pnpm exec turbo prune {{WEB_PACKAGE_NAME}} --docker
+
+FROM base AS build
+COPY --from=pruner /repo/out/json/pnpm-lock.yaml ./pnpm-lock.yaml
+COPY --from=pruner /repo/out/json/pnpm-workspace.yaml ./pnpm-workspace.yaml
+RUN pnpm fetch
+COPY --from=pruner /repo/out/json/ ./
+RUN pnpm install --offline --frozen-lockfile
+COPY --from=pruner /repo/out/full/ ./
+RUN pnpm --filter ./apps/web run build:run
+RUN pnpm --filter ./apps/web deploy --prod --legacy /runtime-deploy \
+  && rm -rf /runtime-deploy/node_modules/@*/db \
+  && find /runtime-deploy/node_modules/.pnpm -mindepth 1 -maxdepth 1 -type d -name '*@file+packages+db' -exec rm -rf '{}' +
+
+FROM node:{{NODE_VERSION}}-bookworm-slim AS application-runtime
+ENV NODE_ENV="production"
+WORKDIR /app
+RUN groupadd --system --gid 1001 nodejs \
+  && useradd --system --uid 1001 --gid nodejs --home-dir /app --shell /usr/sbin/nologin app \
+  && install -d -o app -g nodejs /app /data
+COPY --from=build --chown=app:nodejs /runtime-deploy/node_modules ./node_modules
+COPY --from=build --chown=app:nodejs /repo/apps/web/dist ./dist
+COPY --chmod=755 --from=build /repo/apps/web/scripts/container-entrypoint.sh /usr/local/bin/container-entrypoint
+ENV DATABASE_FILE="/data/app.sqlite"
+USER app
+
+FROM base AS database-preparation
+ENV NODE_ENV="production"
+COPY --from=pruner /repo/out/json/pnpm-lock.yaml ./pnpm-lock.yaml
+COPY --from=pruner /repo/out/json/pnpm-workspace.yaml ./pnpm-workspace.yaml
+RUN pnpm fetch
+COPY --from=pruner /repo/out/json/ ./
+RUN pnpm install --offline --frozen-lockfile --prod=false
+COPY --from=pruner /repo/out/full/ ./
+RUN groupadd --system --gid 1001 nodejs \
+  && useradd --system --uid 1001 --gid nodejs --home-dir /app --shell /usr/sbin/nologin app \
+  && install -d -o app -g nodejs /app /data
+COPY --chmod=755 --from=pruner /repo/out/full/apps/web/scripts/container-entrypoint.sh /usr/local/bin/container-entrypoint
+COPY --chmod=755 --from=pruner /repo/out/full/apps/web/scripts/prepare-database.sh /usr/local/bin/prepare-database
+ENV DATABASE_FILE="/data/app.sqlite"
+USER app
+
+# Final deployment target: standalone
+# One-container deployments prepare the database before startup.
+FROM database-preparation AS standalone
+ARG DEPLOYMENT_BUILD_ID
+LABEL org.opencontainers.image.version="$DEPLOYMENT_BUILD_ID"
+WORKDIR /app
+COPY --from=application-runtime --chown=app:nodejs /app/node_modules ./node_modules
+COPY --from=application-runtime --chown=app:nodejs /app/dist ./dist
+EXPOSE 3000
+ENTRYPOINT ["/usr/local/bin/container-entrypoint"]
+CMD ["prepare-and-start"]
+
+# Final deployment target: runtime
+# Start-only image for databases prepared by a matching standalone image.
+FROM application-runtime AS runtime
+ARG DEPLOYMENT_BUILD_ID
+LABEL org.opencontainers.image.version="$DEPLOYMENT_BUILD_ID"
+ENV CONTAINER_CAPABILITY="start-only"
+EXPOSE 3000
+ENTRYPOINT ["/usr/local/bin/container-entrypoint"]
+CMD ["start-only"]

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/web/Dockerfile.dockerignore

@@ -0,0 +1,14 @@
+.git
+.template
+node_modules
+**/node_modules
+**/.turbo
+**/dist
+**/playwright-report
+**/test-results
+apps/web/data
+apps/web/node_modules/.tmp
+packages/db/data
+packages/db/node_modules/.tmp
+*.sqlite
+*.sqlite-*

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/web/pages/index/+Page.telefunc.ts

@@ -1,6 +1,5 @@
-import { getContext } from "telefunc";
-
 // @template-anchor db-package-import
+import { getContext } from "telefunc";
 
 export type Todo = Awaited<ReturnType<typeof onLoadTodos>>[number];
 

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/web/pages/index/+Page.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { ref } from "vue";
+import { onMounted, ref } from "vue";
 
 import CounterButton from "#/components/CounterButton.vue";
 
@@ -32,6 +32,10 @@ async function submitTodo() {
   title.value = "";
   await refreshTodos();
 }
+
+onMounted(() => {
+  void refreshTodos();
+});
 </script>
 
 <template>
@@ -65,7 +69,7 @@ async function submitTodo() {
       type="button"
       @click="refreshTodos"
     >
-      加载待办事项
+      刷新待办事项
     </button>
 
     <p

package/node_modules/@ykdz/template-builtin-source/templates/vike-app/web/playwright.config.ts

@@ -1,22 +1,53 @@
-import { fileURLToPath } from "node:url";
-
 import { defineConfig, devices } from "@playwright/test";
 
+const externalBaseUrlName = "PLAYWRIGHT_EXTERNAL_BASE_URL";
+
+function externalBaseUrl(): string | undefined {
+  if (!Object.hasOwn(process.env, externalBaseUrlName)) {
+    return undefined;
+  }
+
+  const value = process.env[externalBaseUrlName]?.trim();
+  if (!value) {
+    throw new Error(`${externalBaseUrlName} must be a non-empty HTTP(S) URL`);
+  }
+
+  let url: URL;
+  try {
+    url = new URL(value);
+  } catch {
+    throw new Error(`${externalBaseUrlName} must be a valid HTTP(S) URL`);
+  }
+
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    throw new Error(`${externalBaseUrlName} must use HTTP or HTTPS`);
+  }
+
+  return url.toString();
+}
+
 function requiredPort(name: string): number {
+  return Number(requiredEnv(name));
+}
+
+function requiredEnv(name: string): string {
   const value = process.env[name];
 
   if (!value) {
     throw new Error(`${name} must be set by scripts/run-playwright.ts`);
   }
 
-  return Number(value);
+  return value;
 }
 
-const previewPort = requiredPort("PLAYWRIGHT_WEB_PORT");
-const previewUrl = `http://127.0.0.1:${previewPort}`;
-const databaseFile = fileURLToPath(
-  new URL("./node_modules/.tmp/e2e.sqlite", import.meta.url),
-);
+const externalServiceUrl = externalBaseUrl();
+const previewPort = externalServiceUrl
+  ? undefined
+  : requiredPort("PLAYWRIGHT_WEB_PORT");
+const previewUrl = externalServiceUrl ?? `http://127.0.0.1:${previewPort}`;
+const databaseFile = externalServiceUrl
+  ? undefined
+  : requiredEnv("DATABASE_FILE");
 
 function shellValue(value: string): string {
   return `'${value.replaceAll("'", "'\\''")}'`;
@@ -27,13 +58,18 @@ export default defineConfig({
   timeout: 60_000,
   use: {
     baseURL: previewUrl,
-    trace: "on-first-retry",
-  },
-  webServer: {
-    command: `DATABASE_FILE=${shellValue(databaseFile)} pnpm --dir ../../packages/db run db:push && DATABASE_FILE=${shellValue(databaseFile)} PORT=${previewPort} node dist/server/index.mjs`,
-    reuseExistingServer: !process.env.CI,
-    url: previewUrl,
+    trace: "retain-on-failure",
   },
+  ...(externalServiceUrl
+    ? {}
+    : {
+        webServer: {
+          command: `DATABASE_FILE=${shellValue(databaseFile!)} pnpm --dir ../../packages/db run db:prepare:test && PORT=${previewPort} node dist/server/index.mjs`,
+          reuseExistingServer: !process.env.CI,
+          timeout: 60_000,
+          url: previewUrl,
+        },
+      }),
   projects: [
     {
       name: "chromium",