@beignet/next 0.0.33 → 0.0.35

package/src/index.ts

@@ -9,13 +9,13 @@ import type { PaymentsPort, PaymentWebhookEvent } from "@beignet/core/payments";
 import type { AnyPorts, StorageObject, StoragePort } from "@beignet/core/ports";
 import type {
   InferProviderPorts,
+  ProviderInstrumentationPort,
   ServiceProvider,
 } from "@beignet/core/providers";
 import { resolveProviderInstrumentationPort } from "@beignet/core/providers";
 import {
   createInlineScheduleRunner,
   type ScheduleDef,
-  type ScheduleInstrumentation,
   type StandardSchema,
 } from "@beignet/core/schedules";
 import type {
@@ -44,37 +44,6 @@ import {
 } from "@beignet/core/webhooks";
 import { createFetchHandler, toRequestLike, toWebResponse } from "@beignet/web";
 
-/**
- * Server types re-exported for Next.js apps.
- */
-export type {
-  AnyUseCaseLike,
-  CreateServerOptions,
-  HandlerRouteDef,
-  RawRouteInit,
-  RouteDef,
-  RouteGroup,
-  RouteHook,
-  ServerInstance,
-  UseCaseRouteDef,
-} from "@beignet/core/server";
-/**
- * Server helpers re-exported for Next.js apps.
- */
-export {
-  contractsFromRoutes,
-  createServer,
-  defaultBinderInput,
-  defineRoute,
-  defineRouteGroup,
-  defineRoutes,
-} from "@beignet/core/server";
-
-/**
- * Web Fetch adapter helpers re-exported for Next.js route helpers.
- */
-export { createFetchHandler, toRequestLike, toWebResponse } from "@beignet/web";
-
 type AnyProvider = ServiceProvider<
   unknown,
   // biome-ignore lint/suspicious/noExplicitAny: provider config types are erased at this level
@@ -437,8 +406,8 @@ type ScheduleRouteLogger = {
 
 type ScheduleRoutePorts = {
   logger?: ScheduleRouteLogger;
-  devtools?: ScheduleInstrumentation;
-  instrumentation?: ScheduleInstrumentation;
+  devtools?: ProviderInstrumentationPort;
+  instrumentation?: ProviderInstrumentationPort;
 };
 
 type ScheduleRouteContext = {
@@ -874,13 +843,6 @@ export function createHealthRoute<Ports extends AnyPorts>(
   };
 }
 
-/**
- * Convert a Beignet response into a native `Response`.
- *
- * This is the Next-named alias for `toWebResponse(...)` from `@beignet/web`.
- */
-export const toNextResponse = toWebResponse;
-
 function resolveConfigValue(
   value: string | (() => string | undefined) | undefined,
 ): string | undefined {
@@ -1288,10 +1250,8 @@ export function createUploadRoute(
       if (!uploadName) {
         return Response.json(
           {
-            error: {
-              code: "UPLOAD_NOT_FOUND",
-              message: "Upload route is missing an upload name.",
-            },
+            code: "UPLOAD_NOT_FOUND",
+            message: "Upload route is missing an upload name.",
           },
           { status: 404 },
         );
@@ -1304,11 +1264,9 @@ export function createUploadRoute(
       ) {
         return Response.json(
           {
-            error: {
-              code: "INVALID_UPLOAD_ACTION",
-              message:
-                'Upload route action must be "prepare", "complete", or "upload".',
-            },
+            code: "INVALID_UPLOAD_ACTION",
+            message:
+              'Upload route action must be "prepare", "complete", or "upload".',
           },
           { status: 400 },
         );
@@ -1324,7 +1282,7 @@ export function createUploadRoute(
   };
 }
 
-function cronRouteJson(
+function routeJson(
   body: unknown,
   status: number,
   headers: HeadersInit | undefined,
@@ -1335,26 +1293,37 @@ function cronRouteJson(
   });
 }
 
-function paymentWebhookJson(
-  body: unknown,
-  status: number,
-  headers: HeadersInit | undefined,
-): Response {
-  return Response.json(body, {
-    status,
-    headers,
-  });
-}
-
-function webhookRouteJson(
-  body: unknown,
+type OperationalErrorCode =
+  | "CRON_SECRET_NOT_CONFIGURED"
+  | "OUTBOX_DRAIN_FAILED"
+  | "PAYMENT_WEBHOOK_BODY_READ_FAILED"
+  | "PAYMENT_WEBHOOK_CONTEXT_FAILED"
+  | "PAYMENT_WEBHOOK_HANDLER_FAILED"
+  | "PAYMENT_WEBHOOK_SIGNATURE_MISSING"
+  | "PAYMENT_WEBHOOK_VERIFICATION_FAILED"
+  | "SCHEDULE_FAILED"
+  | "UNAUTHORIZED"
+  | "WEBHOOK_BODY_READ_FAILED"
+  | "WEBHOOK_CONTEXT_FAILED"
+  | "WEBHOOK_HANDLER_FAILED"
+  | "WEBHOOK_VERIFICATION_FAILED";
+
+function operationalErrorJson(
+  code: OperationalErrorCode,
+  message: string,
   status: number,
   headers: HeadersInit | undefined,
+  details?: unknown,
 ): Response {
-  return Response.json(body, {
+  return routeJson(
+    {
+      code,
+      message,
+      ...(details !== undefined ? { details } : {}),
+    },
     status,
     headers,
-  });
+  );
 }
 
 function toHttpResponseHeaders(
@@ -1450,22 +1419,6 @@ export function createOutboxDrainRoute<Ctx extends OutboxDrainContext>(
   }): Promise<Response> => {
     const nativeReq = nativeRequestOf(req);
     const headers = resolveHeaders(options.headers, nativeReq);
-    const secret = options.secret;
-
-    if (!secret) {
-      return cronRouteJson(
-        {
-          ok: false,
-          error: "CRON_SECRET is not configured.",
-        },
-        500,
-        headers,
-      );
-    }
-
-    if (!(await isAuthorizedCronRequest(nativeReq, secret))) {
-      return cronRouteJson({ ok: false, error: "Unauthorized" }, 401, headers);
-    }
 
     try {
       const drainCtx = ctx;
@@ -1513,7 +1466,7 @@ export function createOutboxDrainRoute<Ctx extends OutboxDrainContext>(
         );
       }
 
-      return cronRouteJson(
+      return routeJson(
         {
           ok: true,
           result,
@@ -1524,11 +1477,9 @@ export function createOutboxDrainRoute<Ctx extends OutboxDrainContext>(
     } catch (error) {
       ctx.ports.logger?.error("Outbox drain failed", { error });
 
-      return cronRouteJson(
-        {
-          ok: false,
-          error: "Outbox drain failed.",
-        },
+      return operationalErrorJson(
+        "OUTBOX_DRAIN_FAILED",
+        "Outbox drain failed.",
         500,
         headers,
       );
@@ -1552,44 +1503,37 @@ export function createOutboxDrainRoute<Ctx extends OutboxDrainContext>(
   };
 
   const drainPendingOutbox = async (req: Request): Promise<Response> => {
-    const server = await resolveServerSource(options.server);
-
-    const runner =
-      pipelineRunners[req.method.toUpperCase() === "GET" ? "GET" : "POST"];
-    const pipelined = runner(server);
-    if (pipelined) return pipelined(req);
-
-    // Minimal servers without rawRoute(...) — usually test fakes — keep the
-    // original flow: authorize before touching context, then drain inline.
     const headers = resolveHeaders(options.headers, req);
     const secret = options.secret;
 
     if (!secret) {
-      return cronRouteJson(
-        {
-          ok: false,
-          error: "CRON_SECRET is not configured.",
-        },
+      return operationalErrorJson(
+        "CRON_SECRET_NOT_CONFIGURED",
+        "CRON_SECRET is not configured.",
         500,
         headers,
       );
     }
 
     if (!(await isAuthorizedCronRequest(req, secret))) {
-      return cronRouteJson({ ok: false, error: "Unauthorized" }, 401, headers);
+      return operationalErrorJson("UNAUTHORIZED", "Unauthorized", 401, headers);
     }
 
+    const server = await resolveServerSource(options.server);
+    const runner =
+      pipelineRunners[req.method.toUpperCase() === "GET" ? "GET" : "POST"];
+    const pipelined = runner(server);
+    if (pipelined) return pipelined(req);
+
     let ctx: Ctx;
     try {
       ctx = await server.createRequestContext(toRequestLike(req));
     } catch (error) {
       console.error("Outbox drain context failed", { error });
 
-      return cronRouteJson(
-        {
-          ok: false,
-          error: "Outbox drain failed.",
-        },
+      return operationalErrorJson(
+        "OUTBOX_DRAIN_FAILED",
+        "Outbox drain failed.",
         500,
         headers,
       );
@@ -1638,11 +1582,9 @@ export function createWebhookRoute<
     try {
       rawBody = await req.text();
     } catch {
-      return webhookRouteJson(
-        {
-          ok: false,
-          error: "Webhook body read failed.",
-        },
+      return operationalErrorJson(
+        "WEBHOOK_BODY_READ_FAILED",
+        "Webhook body read failed.",
         400,
         headers,
       );
@@ -1688,11 +1630,9 @@ export function createWebhookRoute<
         traceId: ctx.traceId,
       });
 
-      return webhookRouteJson(
-        {
-          ok: false,
-          error: "Webhook verification failed.",
-        },
+      return operationalErrorJson(
+        "WEBHOOK_VERIFICATION_FAILED",
+        "Webhook verification failed.",
         400,
         headers,
       );
@@ -1737,11 +1677,9 @@ export function createWebhookRoute<
         eventType: event.type,
       });
 
-      return webhookRouteJson(
-        {
-          ok: false,
-          error: "Webhook handler failed.",
-        },
+      return operationalErrorJson(
+        "WEBHOOK_HANDLER_FAILED",
+        "Webhook handler failed.",
         500,
         headers,
       );
@@ -1773,11 +1711,9 @@ export function createWebhookRoute<
       try {
         rawBody = await req.text();
       } catch {
-        return webhookRouteJson(
-          {
-            ok: false,
-            error: "Webhook body read failed.",
-          },
+        return operationalErrorJson(
+          "WEBHOOK_BODY_READ_FAILED",
+          "Webhook body read failed.",
           400,
           headers,
         );
@@ -1789,11 +1725,9 @@ export function createWebhookRoute<
       try {
         ctx = await server.createRequestContext(contextRequest);
       } catch {
-        return webhookRouteJson(
-          {
-            ok: false,
-            error: "Webhook context failed.",
-          },
+        return operationalErrorJson(
+          "WEBHOOK_CONTEXT_FAILED",
+          "Webhook context failed.",
           500,
           headers,
         );
@@ -1835,11 +1769,9 @@ export function createPaymentWebhookRoute<
     const signature = new Headers(req.headers).get(signatureHeader);
 
     if (!signature) {
-      return paymentWebhookJson(
-        {
-          ok: false,
-          error: `Missing ${signatureHeader} header.`,
-        },
+      return operationalErrorJson(
+        "PAYMENT_WEBHOOK_SIGNATURE_MISSING",
+        `Missing ${signatureHeader} header.`,
         400,
         headers,
       );
@@ -1850,11 +1782,9 @@ export function createPaymentWebhookRoute<
     try {
       rawBody = await req.text();
     } catch {
-      return paymentWebhookJson(
-        {
-          ok: false,
-          error: "Payment webhook body read failed.",
-        },
+      return operationalErrorJson(
+        "PAYMENT_WEBHOOK_BODY_READ_FAILED",
+        "Payment webhook body read failed.",
         400,
         headers,
       );
@@ -1874,11 +1804,9 @@ export function createPaymentWebhookRoute<
         traceId: ctx.traceId,
       });
 
-      return paymentWebhookJson(
-        {
-          ok: false,
-          error: "Payment webhook verification failed.",
-        },
+      return operationalErrorJson(
+        "PAYMENT_WEBHOOK_VERIFICATION_FAILED",
+        "Payment webhook verification failed.",
         400,
         headers,
       );
@@ -1921,11 +1849,9 @@ export function createPaymentWebhookRoute<
         eventType: event.type,
       });
 
-      return paymentWebhookJson(
-        {
-          ok: false,
-          error: "Payment webhook handler failed.",
-        },
+      return operationalErrorJson(
+        "PAYMENT_WEBHOOK_HANDLER_FAILED",
+        "Payment webhook handler failed.",
         500,
         headers,
       );
@@ -1955,11 +1881,9 @@ export function createPaymentWebhookRoute<
       const headers = resolveHeaders(options.headers, req);
 
       if (!req.headers.get(signatureHeader)) {
-        return paymentWebhookJson(
-          {
-            ok: false,
-            error: `Missing ${signatureHeader} header.`,
-          },
+        return operationalErrorJson(
+          "PAYMENT_WEBHOOK_SIGNATURE_MISSING",
+          `Missing ${signatureHeader} header.`,
           400,
           headers,
         );
@@ -1969,11 +1893,9 @@ export function createPaymentWebhookRoute<
       try {
         rawBody = await req.text();
       } catch {
-        return paymentWebhookJson(
-          {
-            ok: false,
-            error: "Payment webhook body read failed.",
-          },
+        return operationalErrorJson(
+          "PAYMENT_WEBHOOK_BODY_READ_FAILED",
+          "Payment webhook body read failed.",
           400,
           headers,
         );
@@ -1983,11 +1905,9 @@ export function createPaymentWebhookRoute<
       try {
         ctx = await server.createRequestContext(toContextRequest(req, rawBody));
       } catch {
-        return paymentWebhookJson(
-          {
-            ok: false,
-            error: "Payment webhook context failed.",
-          },
+        return operationalErrorJson(
+          "PAYMENT_WEBHOOK_CONTEXT_FAILED",
+          "Payment webhook context failed.",
           500,
           headers,
         );
@@ -2039,28 +1959,11 @@ export function createScheduleRoute<Ctx extends ScheduleRouteContext>(
   }): Promise<Response> => {
     const nativeReq = nativeRequestOf(req);
     const headers = resolveHeaders(options.headers, nativeReq);
-    const secret = options.secret;
-
-    if (!secret) {
-      return cronRouteJson(
-        {
-          ok: false,
-          error: "CRON_SECRET is not configured.",
-          scheduleName: schedule.name,
-        },
-        500,
-        headers,
-      );
-    }
-
-    if (!(await isAuthorizedCronRequest(nativeReq, secret))) {
-      return cronRouteJson({ ok: false, error: "Unauthorized" }, 401, headers);
-    }
 
     try {
       const runner = createInlineScheduleRunner<Ctx>({
         ctx,
-        instrumentation: resolveProviderInstrumentationPort(ctx.ports),
+        instrumentation: ctx.ports,
         instrumentationContext: {
           requestId: ctx.requestId,
           traceId: ctx.traceId,
@@ -2077,7 +1980,7 @@ export function createScheduleRoute<Ctx extends ScheduleRouteContext>(
         source: options.source ?? "next-cron-route",
       });
 
-      return cronRouteJson(
+      return routeJson(
         {
           ok: true,
           scheduleName: schedule.name,
@@ -2086,14 +1989,12 @@ export function createScheduleRoute<Ctx extends ScheduleRouteContext>(
         headers,
       );
     } catch {
-      return cronRouteJson(
-        {
-          ok: false,
-          error: "Schedule failed.",
-          scheduleName: schedule.name,
-        },
+      return operationalErrorJson(
+        "SCHEDULE_FAILED",
+        "Schedule failed.",
         500,
         headers,
+        { scheduleName: schedule.name },
       );
     }
   };
@@ -2115,46 +2016,39 @@ export function createScheduleRoute<Ctx extends ScheduleRouteContext>(
   };
 
   const runScheduleFromRequest = async (req: Request): Promise<Response> => {
-    const server = await resolveServerSource(options.server);
-
-    const runner =
-      pipelineRunners[req.method.toUpperCase() === "GET" ? "GET" : "POST"];
-    const pipelined = runner(server);
-    if (pipelined) return pipelined(req);
-
-    // Minimal servers without rawRoute(...) — usually test fakes — keep the
-    // original flow: authorize before touching context, then run inline.
     const headers = resolveHeaders(options.headers, req);
     const secret = options.secret;
 
     if (!secret) {
-      return cronRouteJson(
-        {
-          ok: false,
-          error: "CRON_SECRET is not configured.",
-          scheduleName: schedule.name,
-        },
+      return operationalErrorJson(
+        "CRON_SECRET_NOT_CONFIGURED",
+        "CRON_SECRET is not configured.",
         500,
         headers,
+        { scheduleName: schedule.name },
       );
     }
 
     if (!(await isAuthorizedCronRequest(req, secret))) {
-      return cronRouteJson({ ok: false, error: "Unauthorized" }, 401, headers);
+      return operationalErrorJson("UNAUTHORIZED", "Unauthorized", 401, headers);
     }
 
+    const server = await resolveServerSource(options.server);
+    const runner =
+      pipelineRunners[req.method.toUpperCase() === "GET" ? "GET" : "POST"];
+    const pipelined = runner(server);
+    if (pipelined) return pipelined(req);
+
     let ctx: Ctx;
     try {
       ctx = await server.createRequestContext(toRequestLike(req));
     } catch {
-      return cronRouteJson(
-        {
-          ok: false,
-          error: "Schedule failed.",
-          scheduleName: schedule.name,
-        },
+      return operationalErrorJson(
+        "SCHEDULE_FAILED",
+        "Schedule failed.",
         500,
         headers,
+        { scheduleName: schedule.name },
       );
     }