Netlify Functions

npm install @netlify/functions
npm install --save-dev netlify-cli

// netlify/functions/hello.mts
import type { Config, Context } from "@netlify/functions";

export default async (request: Request, context: Context) => {
  const name = new URL(request.url).searchParams.get("name")?.trim() || "World";

  return Response.json({
    message: `Hello, ${name}!`,
    requestId: context.requestId,
  });
};

export const config: Config = {
  path: "/api/hello",
  method: "GET",
};

// netlify/functions/product.mts
import type { Config, Context } from "@netlify/functions";

export default async (_request: Request, context: Context) => {
  const sku = context.params.sku;

  return Response.json({
    sku,
    available: true,
  });
};

export const config: Config = {
  path: "/api/products/:sku",
  method: "GET",
  rateLimit: {
    action: "rate_limit",
    aggregateBy: ["domain", "ip"],
    windowSize: 60,
    windowLimit: 120,
  },
};

// netlify/functions/process-report.mts
import type { Config } from "@netlify/functions";

export default async (request: Request) => {
  const { reportId } = (await request.json()) as {
    reportId: string;
  };

  // 客户端已经收到 202；把最终结果写入持久存储。
  await generateAndStoreReport(reportId);
};

export const config: Config = {
  path: "/api/reports/process",
  method: "POST",
  background: true,
};

// netlify/functions/hourly-sync.mts
import type { Config } from "@netlify/functions";

export default async (request: Request) => {
  const { next_run } = (await request.json()) as {
    next_run: string;
  };

  await synchronizeCatalog();
  console.log("Next run:", next_run);
};

export const config: Config = {
  schedule: "@hourly",
};

// netlify/functions/stream.mts
import type { Config } from "@netlify/functions";

export default async () => {
  const encoder = new TextEncoder();

  const body = new ReadableStream({
    start(controller) {
      for (const message of ["连接成功", "读取数据", "完成"]) {
        controller.enqueue(
          encoder.encode(`data: ${JSON.stringify({ message })}\n\n`),
        );
      }

      controller.close();
    },
  });

  return new Response(body, {
    headers: { "content-type": "text/event-stream" },
  });
};

export const config: Config = {
  path: "/api/stream",
};

npx netlify link
npx netlify dev

# 默认地址通常是 8888
curl "http://localhost:8888/api/hello?name=Ada"
curl "http://localhost:8888/api/products/sku-1001"

# 手动测试定时函数，不会启动真实 Cron
npx netlify functions:invoke hourly-sync