@beignet/core 0.0.1

package/dist/server/hooks/rate-limit.js

@@ -0,0 +1,93 @@
+/**
+ * Rate limit hooks for @beignet/core/server
+ */
+import { AppError, httpErrors } from "../../errors";
+function defaultGetClientIp(req) {
+    const xfwd = req.headers.get("x-forwarded-for") ?? "";
+    return xfwd.split(",")[0].trim() || undefined;
+}
+function emitUserKey(userId) {
+    return `user:${userId}`;
+}
+function emitIpKey(ip) {
+    return `ip:${ip}`;
+}
+function defaultRateLimitKey(args, getClientIp) {
+    const { ctx, req, scope } = args;
+    if (scope === "user" && ctx.actor?.type === "user" && ctx.actor.id) {
+        return emitUserKey(ctx.actor.id);
+    }
+    if (scope === "ip") {
+        const ip = getClientIp(req) || "unknown";
+        return emitIpKey(ip);
+    }
+    return "global";
+}
+function defaultEarlyRateLimitKey(args, getClientIp) {
+    if (args.scope === "ip") {
+        const ip = getClientIp(args.req) || "unknown";
+        return emitIpKey(ip);
+    }
+    return "global";
+}
+async function enforceRateLimit(rateLimit, args) {
+    const result = await rateLimit.hit({
+        key: args.key,
+        limit: args.limit,
+        windowSec: args.windowSec,
+    });
+    if (result.allowed) {
+        return;
+    }
+    throw new AppError(httpErrors.TooManyRequests, {
+        key: args.key,
+        scope: args.scope,
+        retryAfterSeconds: result.retryAfterSeconds,
+        resetAt: result.resetAt?.toISOString() ?? null,
+    }, "Rate limit exceeded");
+}
+export function createRateLimitHooks(options = {}) {
+    const getClientIp = options.getClientIp ?? defaultGetClientIp;
+    return {
+        name: "rate-limit",
+        onRequest: async ({ contract, ports, req }) => {
+            const rlMeta = contract.metadata?.rateLimit;
+            if (!rlMeta) {
+                return undefined;
+            }
+            const scope = rlMeta.scope ?? "global";
+            if (scope === "user") {
+                return undefined;
+            }
+            const key = options.earlyKey?.({ req, scope }) ??
+                defaultEarlyRateLimitKey({ req, scope }, getClientIp);
+            await enforceRateLimit(ports.rateLimit, {
+                key,
+                limit: rlMeta.max,
+                windowSec: rlMeta.windowSec,
+                scope,
+            });
+            return undefined;
+        },
+        beforeHandle: async ({ ctx, contract, req }) => {
+            const rlMeta = contract.metadata?.rateLimit;
+            if (!rlMeta) {
+                return undefined;
+            }
+            const scope = rlMeta.scope ?? "global";
+            if (scope !== "user") {
+                return undefined;
+            }
+            const key = options.key?.({ ctx, req, scope }) ??
+                defaultRateLimitKey({ ctx, req, scope }, getClientIp);
+            await enforceRateLimit(ctx.ports.rateLimit, {
+                key,
+                limit: rlMeta.max,
+                windowSec: rlMeta.windowSec,
+                scope,
+            });
+            return undefined;
+        },
+    };
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/server/hooks/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../../src/server/hooks/rate-limit.ts"],"names":[],"mappings":"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"}

package/dist/server/hooks/utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared utilities for server hooks.
+ */
+/**
+ * Extract requestId from context object if it exists.
+ * This helper reduces type casting duplication throughout the codebase.
+ */
+export declare function getRequestIdFromContext(ctx: unknown): string | undefined;
+//# sourceMappingURL=utils.d.ts.map

package/dist/server/hooks/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/server/hooks/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOxE"}

package/dist/server/hooks/utils.js

@@ -0,0 +1,16 @@
+/**
+ * Shared utilities for server hooks.
+ */
+/**
+ * Extract requestId from context object if it exists.
+ * This helper reduces type casting duplication throughout the codebase.
+ */
+export function getRequestIdFromContext(ctx) {
+    if (ctx !== null && ctx !== undefined && typeof ctx === "object") {
+        const ctxRecord = ctx;
+        const requestId = ctxRecord.requestId;
+        return typeof requestId === "string" ? requestId : undefined;
+    }
+    return undefined;
+}
+//# sourceMappingURL=utils.js.map

package/dist/server/hooks/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/server/hooks/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAY;IAClD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACjE,MAAM,SAAS,GAAG,GAA8B,CAAC;QACjD,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;QACtC,OAAO,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/server/hooks.d.ts

@@ -0,0 +1,2 @@
+export * from "./hooks/index";
+//# sourceMappingURL=hooks.d.ts.map

package/dist/server/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/server/hooks.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/server/hooks.js

@@ -0,0 +1,2 @@
+export * from "./hooks/index";
+//# sourceMappingURL=hooks.js.map

package/dist/server/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/server/hooks.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/server/http.d.ts

@@ -0,0 +1,124 @@
+import type { HttpContractConfig, InferHeaderSchemaOutput, InferOutput, StandardSchema } from "../contracts";
+import type { AnyPorts } from "../ports";
+export interface HttpRequestLike {
+    method: string;
+    url: string;
+    headers: Headers;
+    /**
+     * The platform request when an adapter has one available.
+     *
+     * Use this as an escape hatch for platform-specific APIs. Prefer the
+     * framework-agnostic methods below when possible.
+     */
+    raw?: Request;
+    json(): Promise<unknown>;
+    text(): Promise<string>;
+    arrayBuffer?(): Promise<ArrayBuffer>;
+    blob?(): Promise<Blob>;
+    formData?(): Promise<FormData>;
+    clone?(): HttpRequestLike;
+}
+export interface HttpResponseLike {
+    status: number;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+export type HttpResponse = HttpResponseLike | Response;
+type InferSchemaOrFallback<T extends StandardSchema | null, Fallback> = T extends StandardSchema ? InferOutput<T> : Fallback;
+export type InferPath<C extends HttpContractConfig> = InferSchemaOrFallback<C["pathParams"], Record<string, string>>;
+export type InferQuery<C extends HttpContractConfig> = InferSchemaOrFallback<C["query"], Record<string, string | string[]>>;
+export type InferBody<C extends HttpContractConfig> = InferSchemaOrFallback<C["body"], unknown>;
+export type InferHeaders<C extends HttpContractConfig> = InferHeaderSchemaOutput<Exclude<C["headers"], undefined>> extends undefined ? Record<string, string> : InferHeaderSchemaOutput<Exclude<C["headers"], undefined>>;
+export interface HandlerArgs<Ctx, C extends HttpContractConfig> {
+    req: HttpRequestLike;
+    ctx: Ctx;
+    contract: C;
+    path: InferPath<C>;
+    query: InferQuery<C>;
+    headers: InferHeaders<C>;
+    body: InferBody<C>;
+}
+export type Handler<Ctx, C extends HttpContractConfig> = (args: HandlerArgs<Ctx, C>) => Promise<HttpResponse> | HttpResponse;
+export type MaybePromise<T> = T | Promise<T>;
+export type OnRequestHook<Ports extends AnyPorts = AnyPorts, C extends HttpContractConfig = HttpContractConfig> = (args: {
+    req: HttpRequestLike;
+    ports: Ports;
+    contract: C;
+    params: Record<string, string>;
+}) => MaybePromise<HttpResponse | undefined>;
+export type BeforeHandleResult<Ctx> = undefined | HttpResponse | {
+    ctx?: Ctx;
+    response?: HttpResponse;
+};
+export type BeforeHandleHook<Ctx, C extends HttpContractConfig = HttpContractConfig> = (args: {
+    req: HttpRequestLike;
+    ctx: Ctx;
+    contract: C;
+    path: InferPath<C>;
+    query: InferQuery<C>;
+    headers: InferHeaders<C>;
+    body: InferBody<C>;
+}) => MaybePromise<BeforeHandleResult<Ctx>>;
+export type BeforeSendHook<Ctx, C extends HttpContractConfig = HttpContractConfig> = (args: {
+    req: HttpRequestLike;
+    ctx?: Ctx;
+    contract: C;
+    path?: InferPath<C>;
+    query?: InferQuery<C>;
+    headers?: InferHeaders<C>;
+    body?: InferBody<C>;
+    response: HttpResponseLike;
+    error?: unknown;
+}) => MaybePromise<HttpResponseLike | undefined>;
+export type AfterSendHook<Ctx, C extends HttpContractConfig = HttpContractConfig> = (args: {
+    req: HttpRequestLike;
+    ctx?: Ctx;
+    contract: C;
+    path?: InferPath<C>;
+    query?: InferQuery<C>;
+    headers?: InferHeaders<C>;
+    body?: InferBody<C>;
+    response: HttpResponseLike;
+    error?: unknown;
+    durationMs: number;
+}) => MaybePromise<void>;
+export type ServerCaughtErrorHook<Ctx, C extends HttpContractConfig = HttpContractConfig> = (args: {
+    err: unknown;
+    req: HttpRequestLike;
+    ctx?: Ctx;
+    contract: C;
+    path?: InferPath<C>;
+    query?: InferQuery<C>;
+    headers?: InferHeaders<C>;
+    body?: InferBody<C>;
+}) => MaybePromise<void>;
+export type ServerUnhandledErrorMapper<Ctx, C extends HttpContractConfig = HttpContractConfig> = (args: {
+    err: unknown;
+    req: HttpRequestLike;
+    ctx?: Ctx;
+    contract: C;
+    path?: InferPath<C>;
+    query?: InferQuery<C>;
+    headers?: InferHeaders<C>;
+    body?: InferBody<C>;
+}) => MaybePromise<HttpResponse | undefined>;
+export interface ServerHook<Ctx, Ports extends AnyPorts = AnyPorts> {
+    name?: string;
+    onRequest?: OnRequestHook<Ports>;
+    beforeHandle?: BeforeHandleHook<Ctx>;
+    beforeSend?: BeforeSendHook<Ctx>;
+    afterSend?: AfterSendHook<Ctx>;
+    onCaughtError?: ServerCaughtErrorHook<Ctx>;
+    mapUnhandledError?: ServerUnhandledErrorMapper<Ctx>;
+}
+export type ResolvedRoute<_Ctx, C extends HttpContractConfig> = {
+    contract: C;
+    handler: (req: HttpRequestLike, params?: Record<string, string>) => Promise<HttpResponse>;
+    match: (method: string, pathname: string) => {
+        matched: true;
+    } | {
+        matched: false;
+    };
+};
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/server/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/server/http.ts"],"names":[],"mappings":"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"}

package/dist/server/http.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http.js.map

package/dist/server/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/server/http.ts"],"names":[],"mappings":""}

package/dist/server/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @beignet/core/server
+ *
+ * Framework-agnostic HTTP server runtime for Beignet.
+ * Shared by Beignet server adapters.
+ */
+export type { HttpContractConfig, InferOutput, StandardSchema, StandardSchemaV1, } from "../contracts";
+export { AppError } from "../errors";
+export type { AnyPorts } from "../ports";
+export type { ServiceProvider } from "../providers";
+export * from "./health";
+export * from "./hooks";
+export * from "./http";
+export * from "./openapi";
+export * from "./providers";
+export type { CreateServerOptions, RouteDef, RouteGroup, ServerInstance, } from "./server";
+export { contractsFromRoutes, createServer, defineRouteGroup, defineRoutes, } from "./server";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,YAAY,EACV,mBAAmB,EACnB,QAAQ,EACR,UAAU,EACV,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,cAAc,SAAS,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,15 @@
+/**
+ * @beignet/core/server
+ *
+ * Framework-agnostic HTTP server runtime for Beignet.
+ * Shared by Beignet server adapters.
+ */
+export { AppError } from "../errors";
+export * from "./health";
+export * from "./hooks";
+export * from "./http";
+export * from "./openapi";
+export * from "./providers";
+export { contractsFromRoutes, createServer, defineRouteGroup, defineRoutes, } from "./server";
+export * from "./types";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAO5B,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,cAAc,SAAS,CAAC"}

package/dist/server/openapi.d.ts

@@ -0,0 +1,32 @@
+/**
+ * OpenAPI generation handler
+ * OpenAPI helpers for the Beignet server runtime.
+ */
+import type { HttpContractConfig } from "../contracts";
+import type { AppEnvironment } from "./health";
+import type { HttpRequestLike, HttpResponseLike } from "./types";
+/**
+ * OpenAPI configuration
+ */
+export interface OpenAPIConfig {
+    /** Enable OpenAPI endpoint (default: false) */
+    enabled?: boolean;
+    /**
+     * Suggested path for the OpenAPI endpoint (e.g., "/api/openapi.json").
+     * NOTE: This field is for documentation/metadata only and does not control routing.
+     * You must manually wire the openapiHandler to your desired route.
+     */
+    suggestedPath?: string;
+    /** API title */
+    title?: string;
+    /** API version */
+    version?: string;
+    /** API description */
+    description?: string;
+}
+/**
+ * Create an OpenAPI handler
+ * Returns a function that can be called with an HttpRequestLike to get an HttpResponseLike
+ */
+export declare function createOpenAPIHandler(contracts: readonly HttpContractConfig[], openapiConfig: OpenAPIConfig | undefined, _env: AppEnvironment): (req: HttpRequestLike) => Promise<HttpResponseLike>;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/server/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/server/openapi.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,IAAI,EAAE,cAAc,GACnB,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAkCrD"}

package/dist/server/openapi.js

@@ -0,0 +1,43 @@
+/**
+ * OpenAPI generation handler
+ * OpenAPI helpers for the Beignet server runtime.
+ */
+/**
+ * Create an OpenAPI handler
+ * Returns a function that can be called with an HttpRequestLike to get an HttpResponseLike
+ */
+export function createOpenAPIHandler(contracts, openapiConfig, _env) {
+    // Lazily generate OpenAPI spec on first request
+    let cachedSpec = null;
+    return async (_req) => {
+        // Generate spec if not cached
+        if (!cachedSpec) {
+            try {
+                // Dynamic import to avoid hard dependency
+                const { contractsToOpenAPI } = await import("../openapi");
+                cachedSpec = contractsToOpenAPI(contracts, {
+                    title: openapiConfig?.title ?? "Beignet API",
+                    version: openapiConfig?.version ?? "1.0.0",
+                    description: openapiConfig?.description,
+                });
+            }
+            catch (error) {
+                // OpenAPI generation failed
+                return {
+                    status: 500,
+                    body: {
+                        error: "OpenAPI generation failed",
+                        message: error instanceof Error ? error.message : "Unknown error",
+                    },
+                    headers: { "Content-Type": "application/json" },
+                };
+            }
+        }
+        return {
+            status: 200,
+            body: cachedSpec,
+            headers: { "Content-Type": "application/json" },
+        };
+    };
+}
+//# sourceMappingURL=openapi.js.map

package/dist/server/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../src/server/openapi.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAAwC,EACxC,aAAwC,EACxC,IAAoB;IAEpB,gDAAgD;IAChD,IAAI,UAAU,GAAkB,IAAI,CAAC;IAErC,OAAO,KAAK,EAAE,IAAqB,EAA6B,EAAE;QAChE,8BAA8B;QAC9B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,0CAA0C;gBAC1C,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;gBAC1D,UAAU,GAAG,kBAAkB,CAAC,SAAS,EAAE;oBACzC,KAAK,EAAE,aAAa,EAAE,KAAK,IAAI,aAAa;oBAC5C,OAAO,EAAE,aAAa,EAAE,OAAO,IAAI,OAAO;oBAC1C,WAAW,EAAE,aAAa,EAAE,WAAW;iBACxC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,4BAA4B;gBAC5B,OAAO;oBACL,MAAM,EAAE,GAAG;oBACX,IAAI,EAAE;wBACJ,KAAK,EAAE,2BAA2B;wBAClC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;qBAClE;oBACD,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;iBAChD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;SAChD,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/server/providers/index.d.ts

@@ -0,0 +1,4 @@
+export { ConfigValidationError, readEnv } from "../../config";
+export { SchemaValidationError } from "../../errors";
+export { loadProviderConfig, parseStandardSchema } from "./loadProviderConfig";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/server/providers/index.js

@@ -0,0 +1,4 @@
+export { ConfigValidationError, readEnv } from "../../config";
+export { SchemaValidationError } from "../../errors";
+export { loadProviderConfig, parseStandardSchema } from "./loadProviderConfig";
+//# sourceMappingURL=index.js.map

package/dist/server/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/server/providers/loadProviderConfig.d.ts

@@ -0,0 +1,7 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type { AnyPorts } from "../../ports";
+import type { ServiceProvider } from "../../providers";
+declare function parseStandardSchema<Schema extends StandardSchemaV1<unknown, unknown>>(schema: Schema, input: unknown): Promise<StandardSchemaV1.InferOutput<Schema>>;
+export declare function loadProviderConfig<Ports extends AnyPorts, Schema extends StandardSchemaV1<unknown, unknown>>(provider: ServiceProvider<Ports, Schema>, env: Record<string, string | undefined>, overrides: Record<string, unknown>): Promise<StandardSchemaV1.InferOutput<Schema> | undefined>;
+export { parseStandardSchema };
+//# sourceMappingURL=loadProviderConfig.d.ts.map

package/dist/server/providers/loadProviderConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadProviderConfig.d.ts","sourceRoot":"","sources":["../../../src/server/providers/loadProviderConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAO9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAOvD,iBAAe,mBAAmB,CAChC,MAAM,SAAS,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAEjD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAU/C;AAED,wBAAsB,kBAAkB,CACtC,KAAK,SAAS,QAAQ,EACtB,MAAM,SAAS,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAEjD,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,EACxC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CA8B3D;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/server/providers/loadProviderConfig.js

@@ -0,0 +1,42 @@
+import { ConfigValidationError, parseStandardSchemaAsync, readEnv, } from "../../config";
+import { SchemaValidationError } from "../../errors";
+async function parseStandardSchema(schema, input) {
+    try {
+        return await parseStandardSchemaAsync(schema, input);
+    }
+    catch (error) {
+        if (error instanceof ConfigValidationError) {
+            throw new SchemaValidationError(error.issues);
+        }
+        throw error;
+    }
+}
+export async function loadProviderConfig(provider, env, overrides) {
+    const configDef = provider.config;
+    if (!configDef)
+        return undefined;
+    const { schema, envPrefix } = configDef;
+    const hasOverride = Object.hasOwn(overrides, provider.name);
+    const input = hasOverride
+        ? overrides[provider.name]
+        : envPrefix
+            ? readEnv({ env, prefix: envPrefix })
+            : {};
+    try {
+        return await parseStandardSchema(schema, input);
+    }
+    catch (error) {
+        const suffix = envPrefix ? ` (envPrefix=${envPrefix})` : "";
+        const found = envPrefix
+            ? Object.keys(env).filter((k) => k.startsWith(envPrefix) && env[k] !== undefined)
+            : [];
+        const hint = envPrefix
+            ? found.length
+                ? `\n  Env vars found with prefix "${envPrefix}": ${found.join(", ")}`
+                : `\n  No env vars found with prefix "${envPrefix}"`
+            : "";
+        throw new Error(`Failed to load config for provider "${provider.name}"${suffix}: ${error.message}${hint}`);
+    }
+}
+export { parseStandardSchema };
+//# sourceMappingURL=loadProviderConfig.js.map

package/dist/server/providers/loadProviderConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadProviderConfig.js","sourceRoot":"","sources":["../../../src/server/providers/loadProviderConfig.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,OAAO,GACR,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AASrD,KAAK,UAAU,mBAAmB,CAGhC,MAAc,EACd,KAAc;IAEd,IAAI,CAAC;QACH,OAAO,MAAM,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;YAC3C,MAAM,IAAI,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAItC,QAAwC,EACxC,GAAuC,EACvC,SAAkC;IAElC,MAAM,SAAS,GAAG,QAAQ,CAAC,MAA+C,CAAC;IAC3E,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;IACxC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,WAAW;QACvB,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC1B,CAAC,CAAC,SAAS;YACT,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YACrC,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,CAAC;QACH,OAAO,MAAM,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,eAAe,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,KAAK,GAAG,SAAS;YACrB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CACrB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,CACvD;YACH,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,GAAG,SAAS;YACpB,CAAC,CAAC,KAAK,CAAC,MAAM;gBACZ,CAAC,CAAC,mCAAmC,SAAS,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACtE,CAAC,CAAC,sCAAsC,SAAS,GAAG;YACtD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CACb,uCAAuC,QAAQ,CAAC,IAAI,IAAI,MAAM,KAAM,KAAe,CAAC,OAAO,GAAG,IAAI,EAAE,CACrG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/server/server.d.ts

@@ -0,0 +1,86 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import { type HttpContractConfig } from "../contracts";
+import type { AnyPorts } from "../ports";
+import type { ProvidedPortsOfList, ServiceProvider } from "../providers";
+import type { ContractLike, ResolveContract } from "./contract-like";
+import type { Handler, HttpRequestLike, HttpResponse, ServerCaughtErrorHook, ServerHook, ServerUnhandledErrorMapper } from "./http";
+/**
+ * Route definition
+ */
+export type RouteDef<Ctx, CLike extends ContractLike = ContractLike> = {
+    contract: CLike;
+    handle: Handler<Ctx, ResolveContract<CLike>>;
+};
+declare const ROUTE_GROUP_KIND = "beignet.route-group";
+export type RouteGroup<Ctx, Routes extends readonly RouteDef<Ctx, any>[] = readonly RouteDef<Ctx, any>[]> = {
+    kind: typeof ROUTE_GROUP_KIND;
+    name: string;
+    routes: Routes;
+};
+type RouteInput<Ctx> = RouteDef<Ctx, any> | RouteGroup<Ctx, readonly RouteDef<Ctx, any>[]>;
+type RoutesFromInput<Input> = Input extends RouteGroup<any, infer Routes> ? Routes : Input extends RouteDef<any, any> ? readonly [Input] : readonly [];
+type FlattenRouteInputs<Inputs extends readonly unknown[]> = number extends Inputs["length"] ? readonly RouteDef<any, any>[] : Inputs extends readonly [infer First, ...infer Rest] ? readonly [...RoutesFromInput<First>, ...FlattenRouteInputs<Rest>] : readonly [];
+type ContractsFromRouteList<Routes extends readonly RouteDef<any, any>[]> = {
+    readonly [Index in keyof Routes]: Routes[Index] extends RouteDef<any, infer CLike> ? ResolveContract<CLike> : never;
+};
+export type CreateServerOptions<Ctx, Ports extends AnyPorts, Routes extends readonly RouteDef<Ctx, any>[] = readonly RouteDef<Ctx, any>[], Providers extends readonly ServiceProvider<unknown, StandardSchemaV1<any, any>, AnyPorts>[] = readonly []> = {
+    ports: Ports;
+    providers?: Providers;
+    providerEnv?: Record<string, string | undefined>;
+    providerConfig?: Record<string, unknown>;
+    createContext: (args: {
+        req: HttpRequestLike;
+        ports: Ports & ProvidedPortsOfList<Providers>;
+        contract?: HttpContractConfig;
+    }) => Ctx | Promise<Ctx>;
+    hooks?: ServerHook<Ctx, Ports & ProvidedPortsOfList<Providers>>[];
+    routes?: Routes;
+    onCaughtError?: ServerCaughtErrorHook<Ctx>;
+    mapUnhandledError?: ServerUnhandledErrorMapper<Ctx>;
+};
+interface RouteBuilder<Ctx, C extends HttpContractConfig> {
+    handle: (fn: Handler<Ctx, C>) => (req: HttpRequestLike) => Promise<HttpResponse>;
+}
+export interface ServerInstance<Ctx, Ports extends AnyPorts = AnyPorts> {
+    api: (req: HttpRequestLike) => Promise<HttpResponse>;
+    route: <CLike extends ContractLike>(contractLike: CLike) => RouteBuilder<Ctx, ResolveContract<CLike>>;
+    contracts: readonly HttpContractConfig[];
+    stop: () => Promise<void>;
+    ports: Ports;
+}
+export declare function createServer<Ctx, Ports extends AnyPorts, Routes extends readonly RouteDef<Ctx, any>[] = readonly RouteDef<Ctx, any>[], Providers extends readonly ServiceProvider<unknown, StandardSchemaV1<any, any>, AnyPorts>[] = readonly []>(options: CreateServerOptions<Ctx, Ports, Routes, Providers>): Promise<ServerInstance<Ctx, Ports & ProvidedPortsOfList<Providers>>>;
+/**
+ * Helper function to define routes with proper type inference.
+ * Eliminates the need for type assertions when passing routes to createServer.
+ *
+ * @example
+ * const routes = defineRoutes<AppContext>([
+ *   { contract: myContract, handle: async ({ query }) => { ... } }
+ * ]);
+ */
+export declare function defineRoutes<Ctx, const R extends readonly RouteInput<Ctx>[] = readonly RouteInput<Ctx>[]>(routes: R): FlattenRouteInputs<R>;
+/**
+ * Extract contract configs from a route list. Use this to drive OpenAPI from
+ * the same route registration list that createServer receives.
+ */
+export declare function contractsFromRoutes<const R extends readonly RouteDef<any, any>[]>(routes: R): ContractsFromRouteList<R>;
+/**
+ * Helper function to group related route registrations.
+ *
+ * Route groups are flattened by defineRoutes, so createServer still receives
+ * a regular route list while app code can keep feature route wiring colocated.
+ *
+ * @example
+ * const todoRoutes = defineRouteGroup<AppContext>({
+ *   name: "todos",
+ *   routes: [
+ *     { contract: listTodos, handle: async ({ ctx }) => { ... } }
+ *   ]
+ * });
+ */
+export declare function defineRouteGroup<Ctx, const R extends readonly RouteDef<Ctx, any>[] = readonly RouteDef<Ctx, any>[]>(group: {
+    name: string;
+    routes: R;
+}): RouteGroup<Ctx, R>;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"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"}