create-nextdevtpl 2.6.0

package/template/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/template/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/template/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

package/template/public/logo.svg

@@ -0,0 +1,6 @@
+<svg width="24" height="24" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+  <rect width="24" height="24" rx="5" fill="#0F5C57" />
+  <path d="M3 17 L9 7 L13 14 L21 4" fill="none" stroke="#FFFFFF" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round" />
+  <circle cx="9" cy="7" r="1.6" fill="#FFFFFF" />
+  <circle cx="21" cy="4" r="1.6" fill="#FFFFFF" />
+</svg>

package/template/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

package/template/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

package/template/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

package/template/sentry.client.config.ts

@@ -0,0 +1,10 @@
+/**
+ * Sentry 客户端配置
+ *
+ * 此文件由 Next.js 自动加载
+ * 仅在 NEXT_PUBLIC_SENTRY_DSN 配置后生效
+ */
+
+import { initSentryClient } from "@/lib/monitoring";
+
+initSentryClient();

package/template/sentry.edge.config.ts

@@ -0,0 +1,10 @@
+/**
+ * Sentry Edge 配置
+ *
+ * 用于 Edge Runtime (middleware, edge routes)
+ * 仅在 NEXT_PUBLIC_SENTRY_DSN 配置后生效
+ */
+
+import { initSentryServer } from "@/lib/monitoring";
+
+initSentryServer();

package/template/sentry.server.config.ts

@@ -0,0 +1,10 @@
+/**
+ * Sentry 服务端配置
+ *
+ * 此文件由 Next.js 自动加载
+ * 仅在 NEXT_PUBLIC_SENTRY_DSN 配置后生效
+ */
+
+import { initSentryServer } from "@/lib/monitoring";
+
+initSentryServer();

package/template/source.config.ts

@@ -0,0 +1,59 @@
+import {
+  defineCollections,
+  defineDocs,
+  frontmatterSchema,
+} from "fumadocs-mdx/config";
+import { z } from "zod";
+
+/**
+ * Fumadocs 内容源配置
+ *
+ * 定义 Blog 和 Docs 两个内容集合
+ */
+
+/**
+ * 文档集合配置
+ */
+export const docs = defineDocs({
+  dir: "src/content/docs",
+});
+
+/**
+ * 博客文章 Frontmatter Schema
+ */
+const blogFrontmatter = frontmatterSchema.extend({
+  title: z.string(),
+  description: z.string().optional(),
+  date: z.string().or(z.date()),
+  author: z.string().optional(),
+  image: z.string().optional(),
+  tags: z.array(z.string()).optional(),
+});
+
+/**
+ * 博客集合配置
+ */
+export const blog = defineCollections({
+  dir: "src/content/blog",
+  schema: blogFrontmatter,
+  type: "doc",
+});
+
+/**
+ * 法律文档 Frontmatter Schema
+ */
+const legalFrontmatter = frontmatterSchema.extend({
+  title: z.string(),
+  date: z.string().or(z.date()),
+  description: z.string().optional(),
+});
+
+/**
+ * 法律文档集合配置
+ * 包含 Terms of Service, Privacy Policy, Cookie Policy
+ */
+export const legal = defineCollections({
+  dir: "src/content/legal",
+  schema: legalFrontmatter,
+  type: "doc",
+});

package/template/src/adapters/ai/anthropic.ts

@@ -0,0 +1,113 @@
+import {
+  AdapterError,
+  executeAdapterOperation,
+  type AIAdapter,
+  type AIMessage,
+} from "@/core/services";
+
+interface AnthropicConfig {
+  apiKey?: string;
+  fetch?: typeof globalThis.fetch;
+  model: string;
+}
+
+interface AnthropicResponse {
+  content?: Array<{ text?: string; type: string }>;
+  model?: string;
+}
+
+function buildAnthropicMessages(messages: readonly AIMessage[]) {
+  return {
+    system: messages
+      .filter((message) => message.role === "system")
+      .map((message) => message.content)
+      .join("\n\n"),
+    messages: messages
+      .filter((message) => message.role !== "system")
+      .map((message) => ({ role: message.role, content: message.content })),
+  };
+}
+
+export function createAnthropicAdapter(config: AnthropicConfig): AIAdapter {
+  const provider = "anthropic" as const;
+  const request = config.fetch ?? globalThis.fetch;
+
+  return {
+    provider,
+    capabilities: {
+      jsonOutput: false,
+      streaming: true,
+      toolCalling: true,
+    },
+
+    async complete(input) {
+      if (!config.apiKey) {
+        throw new AdapterError({
+          code: "configuration",
+          message: "ANTHROPIC_API_KEY is not configured",
+          provider,
+        });
+      }
+      const apiKey = config.apiKey;
+      if (input.jsonMode) {
+        throw new AdapterError({
+          code: "unsupported",
+          message: "Anthropic adapter does not guarantee JSON mode",
+          provider,
+        });
+      }
+
+      const normalized = buildAnthropicMessages(input.messages);
+      const result = await executeAdapterOperation({
+        provider,
+        fallbackMessage: "Anthropic request failed",
+        secrets: [apiKey],
+        operation: async () => {
+          const response = await request(
+            "https://api.anthropic.com/v1/messages",
+            {
+              method: "POST",
+              headers: {
+                "anthropic-version": "2023-06-01",
+                "content-type": "application/json",
+                "x-api-key": apiKey,
+              },
+              body: JSON.stringify({
+                model: config.model,
+                max_tokens: input.maxTokens ?? 4096,
+                messages: normalized.messages,
+                ...(normalized.system ? { system: normalized.system } : {}),
+                ...(input.temperature === undefined
+                  ? {}
+                  : { temperature: input.temperature }),
+              }),
+            }
+          );
+
+          if (!response.ok) {
+            throw new AdapterError({
+              code: response.status === 429 ? "rate_limited" : "remote_failure",
+              message: `Anthropic request failed with status ${response.status}`,
+              provider,
+              retryable: response.status === 429 || response.status >= 500,
+            });
+          }
+
+          return (await response.json()) as AnthropicResponse;
+        },
+      });
+      const content = result.content
+        ?.filter((block) => block.type === "text")
+        .map((block) => block.text ?? "")
+        .join("");
+      if (!content) {
+        throw new AdapterError({
+          code: "remote_failure",
+          message: "Anthropic returned an empty response",
+          provider,
+        });
+      }
+      return { content, model: result.model ?? config.model };
+    },
+  };
+}

package/template/src/adapters/ai/index.ts

@@ -0,0 +1,6 @@
+export { createAnthropicAdapter } from "./anthropic";
+export { createOpenAICompatibleAdapter } from "./openai-compatible";
+export {
+  createWorkersAIAdapter,
+  type WorkersAIBindingPort,
+} from "./workers-ai";

package/template/src/adapters/ai/openai-compatible.ts

@@ -0,0 +1,88 @@
+import OpenAI from "openai";
+
+import {
+  AdapterError,
+  executeAdapterOperation,
+  type AIAdapter,
+  type AIMessage,
+} from "@/core/services";
+
+interface OpenAICompatibleConfig {
+  apiKey?: string;
+  baseURL?: string;
+  defaultHeaders?: Record<string, string>;
+  model: string;
+}
+
+function toOpenAIMessages(
+  messages: readonly AIMessage[]
+): OpenAI.ChatCompletionMessageParam[] {
+  return messages.map((message) => ({
+    role: message.role,
+    content: message.content,
+  }));
+}
+
+export function createOpenAICompatibleAdapter(
+  config: OpenAICompatibleConfig
+): AIAdapter {
+  const provider = "openai-compatible" as const;
+  let client: OpenAI | undefined;
+
+  function getClient(): OpenAI {
+    if (client) {
+      return client;
+    }
+    if (!config.apiKey) {
+      throw new AdapterError({
+        code: "configuration",
+        message: "AI provider API key is not configured",
+        provider,
+      });
+    }
+    client = new OpenAI({
+      apiKey: config.apiKey,
+      ...(config.baseURL ? { baseURL: config.baseURL } : {}),
+      ...(config.defaultHeaders
+        ? { defaultHeaders: config.defaultHeaders }
+        : {}),
+    });
+    return client;
+  }
+
+  return {
+    provider,
+    capabilities: {
+      jsonOutput: true,
+      streaming: true,
+      toolCalling: true,
+    },
+
+    async complete(input) {
+      const response = await executeAdapterOperation({
+        provider,
+        fallbackMessage: "AI provider request failed",
+        secrets: [config.apiKey],
+        operation: () =>
+          getClient().chat.completions.create({
+            model: config.model,
+            messages: toOpenAIMessages(input.messages),
+            temperature: input.temperature ?? 0.7,
+            max_tokens: input.maxTokens ?? 4096,
+            ...(input.jsonMode
+              ? { response_format: { type: "json_object" as const } }
+              : {}),
+          }),
+      });
+      const content = response.choices[0]?.message.content;
+      if (!content) {
+        throw new AdapterError({
+          code: "remote_failure",
+          message: "AI provider returned an empty response",
+          provider,
+        });
+      }
+      return { content, model: response.model || config.model };
+    },
+  };
+}

package/template/src/adapters/ai/workers-ai.ts

@@ -0,0 +1,63 @@
+import {
+  AdapterError,
+  executeAdapterOperation,
+  type AIAdapter,
+} from "@/core/services";
+
+export interface WorkersAIBindingPort {
+  run(model: string, input: Record<string, unknown>): Promise<unknown>;
+}
+
+interface WorkersAIConfig {
+  binding: WorkersAIBindingPort;
+  model: string;
+}
+
+export function createWorkersAIAdapter(config: WorkersAIConfig): AIAdapter {
+  const provider = "workers-ai" as const;
+
+  return {
+    provider,
+    capabilities: {
+      jsonOutput: false,
+      streaming: true,
+      toolCalling: true,
+    },
+
+    async complete(input) {
+      if (input.jsonMode) {
+        throw new AdapterError({
+          code: "unsupported",
+          message: "Workers AI adapter does not guarantee JSON mode",
+          provider,
+        });
+      }
+
+      const result = await executeAdapterOperation({
+        provider,
+        fallbackMessage: "Workers AI inference failed",
+        operation: () =>
+          config.binding.run(config.model, {
+            messages: input.messages,
+            temperature: input.temperature ?? 0.7,
+            max_tokens: input.maxTokens ?? 4096,
+          }),
+      });
+      const content =
+        typeof result === "object" &&
+        result !== null &&
+        "response" in result &&
+        typeof result.response === "string"
+          ? result.response
+          : undefined;
+      if (!content) {
+        throw new AdapterError({
+          code: "remote_failure",
+          message: "Workers AI returned an empty response",
+          provider,
+        });
+      }
+      return { content, model: config.model };
+    },
+  };
+}

package/template/src/adapters/index.ts

@@ -0,0 +1,10 @@
+export {
+  createServiceAdapterSelection,
+  defaultServiceAdapters,
+  serviceAdapterRegistry,
+} from "./registry";
+export type {
+  ServiceAdapterChoices,
+  ServiceAdapterId,
+  ServiceAdapterSelection,
+} from "./registry";

package/template/src/adapters/jobs/cloudflare-workflows.ts

@@ -0,0 +1,46 @@
+import {
+  AdapterError,
+  executeAdapterOperation,
+  type JobAdapter,
+  type JsonObject,
+} from "@/core/services";
+
+export interface WorkflowBindingPort {
+  create(input: { id?: string; params: JsonObject }): Promise<{ id: string }>;
+}
+
+export function createCloudflareWorkflowsAdapter(
+  workflows: Readonly<Record<string, WorkflowBindingPort>>
+): JobAdapter {
+  const provider = "cloudflare-workflows" as const;
+
+  return {
+    provider,
+    capabilities: {
+      durableSteps: true,
+      events: true,
+      scheduling: true,
+    },
+
+    async dispatch(input) {
+      const workflow = workflows[input.name];
+      if (!workflow) {
+        throw new AdapterError({
+          code: "configuration",
+          message: `Workflow binding is not configured for ${input.name}`,
+          provider,
+        });
+      }
+      const instance = await executeAdapterOperation({
+        provider,
+        fallbackMessage: "Cloudflare Workflow dispatch failed",
+        operation: () =>
+          workflow.create({
+            params: input.payload,
+            ...(input.id ? { id: input.id } : {}),
+          }),
+      });
+      return { id: instance.id };
+    },
+  };
+}

package/template/src/adapters/jobs/index.ts

@@ -0,0 +1,5 @@
+export {
+  createCloudflareWorkflowsAdapter,
+  type WorkflowBindingPort,
+} from "./cloudflare-workflows";
+export { createInngestJobAdapter } from "./inngest";

package/template/src/adapters/jobs/inngest/adapter.ts

@@ -0,0 +1,29 @@
+import { executeAdapterOperation, type JobAdapter } from "@/core/services";
+
+import { inngest } from "./client";
+
+export function createInngestJobAdapter(): JobAdapter {
+  const provider = "inngest" as const;
+
+  return {
+    provider,
+    capabilities: {
+      durableSteps: true,
+      events: true,
+      scheduling: true,
+    },
+
+    async dispatch(input) {
+      const result = await executeAdapterOperation({
+        provider,
+        fallbackMessage: "Inngest event dispatch failed",
+        operation: () =>
+          inngest.send({
+            name: input.name,
+            data: input.payload,
+          }),
+      });
+      return { id: result.ids[0] ?? input.id ?? crypto.randomUUID() };
+    },
+  };
+}

package/template/src/adapters/jobs/inngest/client.ts

@@ -0,0 +1,8 @@
+import { Inngest } from "inngest";
+
+export const inngest = new Inngest({
+  id: "saas-template",
+  ...(process.env.INNGEST_EVENT_KEY
+    ? { eventKey: process.env.INNGEST_EVENT_KEY }
+    : {}),
+});

package/template/src/adapters/jobs/inngest/functions.ts

@@ -0,0 +1,17 @@
+import { logger } from "@/lib/logger";
+
+import { inngest } from "./client";
+
+export const helloWorld = inngest.createFunction(
+  { id: "hello-world", retries: 3 },
+  { event: "app/hello-world" },
+  async ({ event, step }) =>
+    step.run("process-message", async () => {
+      const message =
+        typeof event.data.message === "string" ? event.data.message : "";
+      logger.info({ message }, "处理 hello-world 事件");
+      return { processed: true, message };
+    })
+);
+
+export const functions = [helloWorld];

package/template/src/adapters/jobs/inngest/handler.ts

@@ -0,0 +1,6 @@
+import { serve } from "inngest/next";
+
+import { inngest } from "./client";
+import { functions } from "./functions";
+
+export const inngestHandlers = serve({ client: inngest, functions });

package/template/src/adapters/jobs/inngest/index.ts

@@ -0,0 +1,4 @@
+export { createInngestJobAdapter } from "./adapter";
+export { inngest } from "./client";
+export { functions, helloWorld } from "./functions";
+export { inngestHandlers } from "./handler";

package/template/src/adapters/mail/cloudflare-email.ts

@@ -0,0 +1,50 @@
+import { executeAdapterOperation, type MailAdapter } from "@/core/services";
+
+interface CloudflareEmailBindingMessage {
+  bcc?: readonly string[];
+  cc?: readonly string[];
+  from: string | { email: string; name?: string };
+  html: string;
+  replyTo?: string | readonly string[];
+  subject: string;
+  text: string;
+  to: string | readonly string[];
+}
+
+export interface CloudflareEmailBindingPort {
+  send(message: CloudflareEmailBindingMessage): Promise<{ messageId: string }>;
+}
+
+export function createCloudflareEmailAdapter(
+  binding: CloudflareEmailBindingPort
+): MailAdapter {
+  const provider = "cloudflare-email" as const;
+
+  return {
+    provider,
+    capabilities: {
+      attachments: true,
+      batch: false,
+      transactional: true,
+    },
+
+    async send(message) {
+      const result = await executeAdapterOperation({
+        provider,
+        fallbackMessage: "Cloudflare email delivery failed",
+        operation: () =>
+          binding.send({
+            from: message.from,
+            to: message.to,
+            subject: message.subject,
+            html: message.html,
+            text: message.text,
+            ...(message.cc ? { cc: message.cc } : {}),
+            ...(message.bcc ? { bcc: message.bcc } : {}),
+            ...(message.replyTo ? { replyTo: message.replyTo } : {}),
+          }),
+      });
+      return { id: result.messageId, queued: true };
+    },
+  };
+}

package/template/src/adapters/mail/disabled.ts

@@ -0,0 +1,17 @@
+import { AdapterError, type MailAdapter } from "@/core/services";
+
+export const disabledMailAdapter: MailAdapter = {
+  provider: "disabled",
+  capabilities: {
+    attachments: false,
+    batch: false,
+    transactional: false,
+  },
+  async send() {
+    throw new AdapterError({
+      code: "configuration",
+      message: "Mail delivery is disabled for this project",
+      provider: "disabled",
+    });
+  },
+};

package/template/src/adapters/mail/index.ts

@@ -0,0 +1,7 @@
+export {
+  createCloudflareEmailAdapter,
+  type CloudflareEmailBindingPort,
+} from "./cloudflare-email";
+export { disabledMailAdapter } from "./disabled";
+export { createResendMailAdapter } from "./resend";
+export { createSmtpMailAdapter } from "./smtp";