@beignet/core 0.0.1

package/dist/client/types.d.ts

@@ -0,0 +1,139 @@
+import type { BodyHttpMethod, HttpContractConfig, InferHeaderSchemaInput, InferInput, InferOutput, StandardSchema, StandardSchemaV1 } from "../contracts";
+import type { ErrorResponseBody } from "../errors";
+/**
+ * Client configuration
+ */
+export type ClientConfig<TProvidedHeaders extends string = never> = {
+    baseUrl?: string;
+    headers?: () => Promise<Record<string, string>> | Record<string, string>;
+    providedHeaders?: readonly TProvidedHeaders[];
+    fetch?: typeof fetch;
+    /** Enable client-side input validation for path, query, and body. Default: false. */
+    validate?: boolean;
+};
+type PathParamPrimitive = string | number | boolean;
+type UnsupportedPathParamName<Name extends string> = Name extends "" ? true : Name extends `...${string}` ? true : Name extends `[${string}` ? true : Name extends `${string}.${string}` ? true : false;
+type SegmentPathParam<Segment extends string> = Segment extends `:${infer Name}` ? UnsupportedPathParamName<Name> extends true ? never : Name : Segment extends `[${infer Name}]` ? UnsupportedPathParamName<Name> extends true ? never : Name : never;
+type PathParamNames<TPath extends string> = string extends TPath ? never : TPath extends `${infer Segment}/${infer Rest}` ? SegmentPathParam<Segment> | PathParamNames<Rest> : SegmentPathParam<TPath>;
+type InferPathParamsFromTemplate<TPath extends string> = [
+    PathParamNames<TPath>
+] extends [never] ? undefined : {
+    [K in PathParamNames<TPath>]: PathParamPrimitive;
+};
+/**
+ * Infer path params from contract
+ */
+export type InferPathParams<TContract extends HttpContractConfig> = TContract["pathParams"] extends StandardSchemaV1 ? InferInput<TContract["pathParams"]> : InferPathParamsFromTemplate<TContract["path"]>;
+/**
+ * Infer query params from contract
+ */
+export type InferQuery<TContract extends HttpContractConfig> = TContract["query"] extends StandardSchemaV1 ? InferInput<TContract["query"]> : undefined;
+export type InferHeaders<TContract extends HttpContractConfig> = InferHeaderSchemaInput<Exclude<TContract["headers"], undefined>> extends undefined ? undefined : InferHeaderSchemaInput<Exclude<TContract["headers"], undefined>>;
+/**
+ * Infer body from contract
+ */
+export type InferBody<TContract extends HttpContractConfig> = TContract["method"] extends BodyHttpMethod ? TContract["body"] extends StandardSchemaV1 ? InferInput<TContract["body"]> : undefined : undefined;
+/**
+ * Any 2xx HTTP success status code (200–299).
+ */
+type Digit = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+type ToNumber<S extends string> = S extends `${infer N extends number}` ? N : never;
+type Any2xxCode = ToNumber<`2${Digit}${Digit}`>;
+type NumericKey<K> = K extends number ? K : K extends `${infer N extends number}` ? N : never;
+/**
+ * Find all 2xx status keys from a responses record
+ */
+type Any2xxKey<T extends object> = {
+    [K in keyof T]: NumericKey<K> extends Any2xxCode ? K : never;
+}[keyof T];
+/**
+ * Find all non-2xx status keys from a responses record
+ */
+type AnyErrorKey<T extends object> = {
+    [K in keyof T]: NumericKey<K> extends Any2xxCode ? never : K;
+}[keyof T];
+type ResponseForStatus<TResponses extends object, TStatus extends number> = TStatus extends keyof TResponses ? TResponses[TStatus] : `${TStatus}` extends keyof TResponses ? TResponses[`${TStatus}`] : never;
+/**
+ * Infer a single response type from a schema or null
+ */
+type InferResponseType<T> = T extends null ? undefined : T extends StandardSchemaV1 ? InferOutput<T> : unknown;
+/**
+ * Infer success response from contract (union of all 2xx response types)
+ */
+export type InferSuccessResponse<TContract extends HttpContractConfig> = TContract["responses"] extends Partial<Record<number, StandardSchema | null>> ? Any2xxKey<TContract["responses"]> extends infer K ? K extends keyof TContract["responses"] ? InferResponseType<TContract["responses"][K]> : unknown : unknown : unknown;
+/**
+ * Infer error response from contract (union of all non-2xx response types)
+ */
+export type InferErrorResponse<TContract extends HttpContractConfig> = TContract["responses"] extends Partial<Record<number, StandardSchema | null>> ? AnyErrorKey<TContract["responses"]> extends infer K ? K extends keyof TContract["responses"] ? InferResponseType<TContract["responses"][K]> : unknown : unknown : unknown;
+/**
+ * Infer declared non-2xx status codes from a contract.
+ */
+export type InferEndpointErrorStatus<TContract extends HttpContractConfig> = TContract["responses"] extends Partial<Record<number, StandardSchema | null>> ? NumericKey<AnyErrorKey<TContract["responses"]>> : never;
+/**
+ * Infer a declared non-2xx response body for a specific status.
+ */
+export type InferErrorResponseByStatus<TContract extends HttpContractConfig, TStatus extends number> = TContract["responses"] extends Partial<Record<number, StandardSchema | null>> ? InferResponseType<ResponseForStatus<TContract["responses"], TStatus>> : unknown;
+/**
+ * Error bodies a Beignet client can receive for a specific status.
+ */
+export type InferEndpointErrorResponseByStatus<TContract extends HttpContractConfig, TStatus extends number> = InferErrorResponseByStatus<TContract, TStatus> | ErrorResponseBody | string | undefined;
+/**
+ * Error bodies a Beignet client can receive for an endpoint.
+ *
+ * Declared route-owned errors come from the contract. Framework-owned errors
+ * use the standard envelope. Transport escape hatches may return text or no body.
+ */
+export type InferEndpointErrorResponse<TContract extends HttpContractConfig> = InferErrorResponse<TContract> | ErrorResponseBody | string | undefined;
+export type EndpointSuccessResult<TContract extends HttpContractConfig> = {
+    ok: true;
+    status: number;
+    data: InferSuccessResponse<TContract>;
+    response: Response;
+};
+export type EndpointErrorResult<TError> = {
+    ok: false;
+    status?: number;
+    error: TError;
+    response?: Response;
+};
+export type EndpointResult<TContract extends HttpContractConfig, TError> = EndpointSuccessResult<TContract> | EndpointErrorResult<TError>;
+/**
+ * Call arguments for an endpoint
+ */
+type RequestArg<Name extends "path" | "query" | "body", Value> = Value extends undefined ? {
+    [K in Name]?: undefined;
+} : undefined extends Value ? {
+    [K in Name]?: Value;
+} : {
+    [K in Name]: Value;
+};
+type PathArgs<TContract extends HttpContractConfig> = RequestArg<"path", InferPathParams<TContract>>;
+type QueryArgs<TContract extends HttpContractConfig> = RequestArg<"query", InferQuery<TContract>>;
+type BodyArgs<TContract extends HttpContractConfig> = RequestArg<"body", InferBody<TContract>>;
+type ProvidedHeaderKeys<THeaders, TProvidedHeaders extends string> = Extract<keyof THeaders, TProvidedHeaders>;
+type ApplyProvidedHeaders<THeaders, TProvidedHeaders extends string> = Omit<THeaders, ProvidedHeaderKeys<THeaders, TProvidedHeaders>> & Partial<Pick<THeaders, ProvidedHeaderKeys<THeaders, TProvidedHeaders>>>;
+type HeaderInput<TContract extends HttpContractConfig, TProvidedHeaders extends string> = InferHeaders<TContract> extends undefined ? Record<string, string> : ApplyProvidedHeaders<InferHeaders<TContract>, TProvidedHeaders>;
+type HeadersArgs<TContract extends HttpContractConfig, TProvidedHeaders extends string> = InferHeaders<TContract> extends undefined ? {
+    headers?: Record<string, string>;
+} : HasRequiredKeys<HeaderInput<TContract, TProvidedHeaders>> extends never ? {
+    headers?: HeaderInput<TContract, TProvidedHeaders>;
+} : {
+    headers: HeaderInput<TContract, TProvidedHeaders>;
+};
+export type EndpointCallArgs<TContract extends HttpContractConfig, TProvidedHeaders extends string = never> = PathArgs<TContract> & QueryArgs<TContract> & BodyArgs<TContract> & {
+    /**
+     * Escape hatch for non-JSON request bodies such as FormData, Blob,
+     * ArrayBuffer, ReadableStream, or pre-serialized text.
+     *
+     * Use `body` for contract-validated JSON requests. `rawBody` is sent as-is
+     * and is not validated or JSON-serialized.
+     */
+    rawBody?: TContract["method"] extends BodyHttpMethod ? BodyInit : never;
+    signal?: AbortSignal;
+} & HeadersArgs<TContract, TProvidedHeaders>;
+type HasRequiredKeys<T> = {
+    [K in keyof T]-?: Record<string, never> extends Pick<T, K> ? never : K;
+}[keyof T];
+export type CallArgs<TContract extends HttpContractConfig, TProvidedHeaders extends string = never> = HasRequiredKeys<EndpointCallArgs<TContract, TProvidedHeaders>> extends never ? [args?: EndpointCallArgs<TContract, TProvidedHeaders>] : [args: EndpointCallArgs<TContract, TProvidedHeaders>];
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

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

package/dist/client/types.js

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

package/dist/client/types.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @beignet/core/config
+ *
+ * Environment-first configuration layer using Standard Schema (Zod, Valibot,
+ * ArkType, etc.) for Beignet applications and providers.
+ */
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+export type StandardSchema = StandardSchemaV1<unknown, unknown>;
+export type RuntimeEnv = Record<string, string | undefined>;
+export type EnvSchemaShape = Record<string, StandardSchema>;
+type EmptyEnvSchemaShape = Record<keyof never, never>;
+type NoInferType<T> = [T][T extends unknown ? 0 : never];
+export type InferOutput<T extends StandardSchemaV1> = StandardSchemaV1.InferOutput<T>;
+export type InferEnvShape<Shape extends EnvSchemaShape> = {
+    [Key in keyof Shape]: InferOutput<Shape[Key]>;
+};
+export type ClientEnvSchemaShape<ClientPrefix extends string> = ClientPrefix extends "" ? EnvSchemaShape : Record<`${ClientPrefix}${string}`, StandardSchema>;
+type ValidateClientEnvShape<ClientPrefix extends string, Client extends EnvSchemaShape> = ClientPrefix extends "" ? Client : {
+    [Key in keyof Client]: Key extends `${ClientPrefix}${string}` ? Client[Key] : never;
+};
+export type EnvValidationIssue = StandardSchemaV1.Issue;
+export declare class ConfigValidationError extends Error {
+    readonly issues: readonly EnvValidationIssue[];
+    constructor(issues: readonly EnvValidationIssue[], message?: string);
+}
+export interface ReadEnvOptions {
+    env?: RuntimeEnv;
+    prefix?: string;
+    emptyStringAsUndefined?: boolean;
+}
+export interface DefineEnvOptions<Schema extends StandardSchemaV1> {
+    /**
+     * Standard Schema for validating the full environment object.
+     */
+    schema: Schema;
+    /**
+     * Optional prefix to filter env vars. Matching keys are stripped before
+     * validation, so `APP_DATABASE_URL` becomes `DATABASE_URL`.
+     */
+    prefix?: string;
+    /**
+     * Runtime environment object. Defaults to `process.env` when available.
+     */
+    runtimeEnv?: RuntimeEnv;
+    /**
+     * Treat empty strings as missing values before validation.
+     */
+    emptyStringAsUndefined?: boolean;
+    /**
+     * Skip validation and return the raw env object. This is intended for build
+     * phases where real secrets are unavailable.
+     */
+    skipValidation?: boolean;
+    /**
+     * Called when validation fails. Throw from this hook to customize the error.
+     */
+    onValidationError?: (issues: readonly EnvValidationIssue[]) => never;
+}
+export interface EnvInstance<Out> {
+    load(options?: {
+        env?: RuntimeEnv;
+    }): Out;
+}
+export interface CreateEnvOptions<Server extends EnvSchemaShape, ClientPrefix extends string, Client extends EnvSchemaShape> {
+    /**
+     * Server-only environment variables. These throw if accessed from a client
+     * runtime through the returned env object.
+     */
+    server?: Server;
+    /**
+     * Client-safe environment variables. Keys must use `clientPrefix` when a
+     * prefix is provided.
+     */
+    client?: Client & ValidateClientEnvShape<NoInferType<ClientPrefix>, Client>;
+    /**
+     * Prefix required for client variables, e.g. `NEXT_PUBLIC_`.
+     */
+    clientPrefix?: ClientPrefix;
+    /**
+     * Runtime environment object. Defaults to `process.env` when available.
+     */
+    runtimeEnv?: RuntimeEnv;
+    /**
+     * Strict runtime environment object. Every declared key must be present on the
+     * object, even if the value is `undefined`. This catches framework bundling
+     * mistakes where an env var was not explicitly accessed.
+     */
+    runtimeEnvStrict?: RuntimeEnv;
+    /**
+     * Treat empty strings as missing values before validation.
+     *
+     * Defaults to `true` for `createEnv` because it keeps defaults ergonomic in
+     * framework starters.
+     */
+    emptyStringAsUndefined?: boolean;
+    /**
+     * Skip validation and return raw values. Use sparingly for build phases where
+     * deployment secrets are unavailable.
+     */
+    skipValidation?: boolean;
+    /**
+     * Override server detection. Defaults to checking for `window` on globalThis.
+     */
+    isServer?: boolean;
+    /**
+     * Called when validation fails. Throw from this hook to customize the error.
+     */
+    onValidationError?: (issues: readonly EnvValidationIssue[]) => never;
+    /**
+     * Called when a server-only variable is read from a client runtime.
+     */
+    onInvalidAccess?: (key: string) => never;
+}
+export type CreateEnvResult<Server extends EnvSchemaShape, Client extends EnvSchemaShape> = Readonly<InferEnvShape<Server> & InferEnvShape<Client>>;
+export declare function formatStandardSchemaIssues(issues: readonly StandardSchemaV1.Issue[]): string;
+export declare function readEnv({ env, prefix, emptyStringAsUndefined, }?: ReadEnvOptions): Record<string, string | undefined>;
+export declare function parseStandardSchemaSync<Schema extends StandardSchemaV1>(schema: Schema, input: unknown): InferOutput<Schema>;
+export declare function parseStandardSchemaAsync<Schema extends StandardSchemaV1>(schema: Schema, input: unknown): Promise<InferOutput<Schema>>;
+export declare function defineEnv<Schema extends StandardSchemaV1>(options: DefineEnvOptions<Schema>): EnvInstance<InferOutput<Schema>>;
+export declare function createEnv<const ClientPrefix extends string = "", Server extends EnvSchemaShape = EmptyEnvSchemaShape, Client extends EnvSchemaShape = EmptyEnvSchemaShape>(options: CreateEnvOptions<Server, ClientPrefix, Client>): CreateEnvResult<Server, Client>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAC5D,KAAK,mBAAmB,GAAG,MAAM,CAAC,MAAM,KAAK,EAAE,KAAK,CAAC,CAAC;AACtD,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;AAEzD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,gBAAgB,IAChD,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAElC,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,cAAc,IAAI;KACvD,GAAG,IAAI,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,YAAY,SAAS,MAAM,IAC1D,YAAY,SAAS,EAAE,GACnB,cAAc,GACd,MAAM,CAAC,GAAG,YAAY,GAAG,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC;AAEzD,KAAK,sBAAsB,CACzB,YAAY,SAAS,MAAM,EAC3B,MAAM,SAAS,cAAc,IAC3B,YAAY,SAAS,EAAE,GACvB,MAAM,GACN;KACG,GAAG,IAAI,MAAM,MAAM,GAAG,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,EAAE,GACzD,MAAM,CAAC,GAAG,CAAC,GACX,KAAK;CACV,CAAC;AAEN,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,KAAK,CAAC;AAExD,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;gBAEnC,MAAM,EAAE,SAAS,kBAAkB,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM;CAKpE;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB,CAAC,MAAM,SAAS,gBAAgB;IAC/D;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;OAEG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,KAAK,KAAK,CAAC;CACtE;AAED,MAAM,WAAW,WAAW,CAAC,GAAG;IAC9B,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,GAAG,CAAC;CAC3C;AAED,MAAM,WAAW,gBAAgB,CAC/B,MAAM,SAAS,cAAc,EAC7B,YAAY,SAAS,MAAM,EAC3B,MAAM,SAAS,cAAc;IAE7B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;IAE5E;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,UAAU,CAAC;IAE9B;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,KAAK,KAAK,CAAC;IAErE;;OAEG;IACH,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,KAAK,CAAC;CAC1C;AAED,MAAM,MAAM,eAAe,CACzB,MAAM,SAAS,cAAc,EAC7B,MAAM,SAAS,cAAc,IAC3B,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;AAwD5D,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,gBAAgB,CAAC,KAAK,EAAE,GACxC,MAAM,CAOR;AAED,wBAAgB,OAAO,CAAC,EACtB,GAAyB,EACzB,MAAM,EACN,sBAA8B,GAC/B,GAAE,cAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAmB1D;AAgBD,wBAAgB,uBAAuB,CAAC,MAAM,SAAS,gBAAgB,EACrE,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,WAAW,CAAC,MAAM,CAAC,CAgBrB;AAED,wBAAsB,wBAAwB,CAAC,MAAM,SAAS,gBAAgB,EAC5E,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAQ9B;AA0BD,wBAAgB,SAAS,CAAC,MAAM,SAAS,gBAAgB,EACvD,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAChC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CA+BlC;AA+DD,wBAAgB,SAAS,CACvB,KAAK,CAAC,YAAY,SAAS,MAAM,GAAG,EAAE,EACtC,MAAM,SAAS,cAAc,GAAG,mBAAmB,EACnD,MAAM,SAAS,cAAc,GAAG,mBAAmB,EAEnD,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,GACtD,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAqEjC"}

package/dist/config/index.js

@@ -0,0 +1,216 @@
+/**
+ * @beignet/core/config
+ *
+ * Environment-first configuration layer using Standard Schema (Zod, Valibot,
+ * ArkType, etc.) for Beignet applications and providers.
+ */
+export class ConfigValidationError extends Error {
+    issues;
+    constructor(issues, message) {
+        super(message ?? formatStandardSchemaIssues(issues));
+        this.name = "ConfigValidationError";
+        this.issues = issues;
+    }
+}
+function defaultRuntimeEnv() {
+    return typeof process !== "undefined" && process.env ? process.env : {};
+}
+function isPromiseLike(value) {
+    return (value !== null &&
+        (typeof value === "object" || typeof value === "function") &&
+        "then" in value &&
+        typeof value.then === "function");
+}
+function normalizeEnvValue(value, emptyStringAsUndefined) {
+    if (emptyStringAsUndefined && value === "")
+        return undefined;
+    return value;
+}
+function issuePath(issue) {
+    if (!issue.path?.length)
+        return undefined;
+    return issue.path
+        .map((segment) => {
+        if (segment && typeof segment === "object" && "key" in segment) {
+            return String(segment.key);
+        }
+        if (typeof segment === "string" ||
+            typeof segment === "number" ||
+            typeof segment === "symbol") {
+            return String(segment);
+        }
+        return undefined;
+    })
+        .filter((segment) => Boolean(segment))
+        .join(".");
+}
+function prependIssuePath(key, issue) {
+    return {
+        ...issue,
+        path: [{ key }, ...(issue.path ?? [])],
+    };
+}
+export function formatStandardSchemaIssues(issues) {
+    return issues
+        .map((issue) => {
+        const path = issuePath(issue);
+        return path ? `${path}: ${issue.message}` : issue.message;
+    })
+        .join("; ");
+}
+export function readEnv({ env = defaultRuntimeEnv(), prefix, emptyStringAsUndefined = false, } = {}) {
+    const raw = {};
+    for (const [key, value] of Object.entries(env)) {
+        if (value == null)
+            continue;
+        if (prefix && prefix.length > 0) {
+            if (!key.startsWith(prefix))
+                continue;
+            raw[key.slice(prefix.length)] = normalizeEnvValue(value, emptyStringAsUndefined);
+            continue;
+        }
+        raw[key] = normalizeEnvValue(value, emptyStringAsUndefined);
+    }
+    return raw;
+}
+function validationResultValue(result) {
+    if (result.issues?.length) {
+        throw new ConfigValidationError(result.issues);
+    }
+    if ("value" in result) {
+        return result.value;
+    }
+    throw new Error("Invalid Standard Schema result: missing value");
+}
+export function parseStandardSchemaSync(schema, input) {
+    const validate = schema?.["~standard"]?.validate;
+    if (typeof validate !== "function") {
+        throw new Error("Invalid Standard Schema: missing ~standard.validate()");
+    }
+    const result = validate(input);
+    if (isPromiseLike(result)) {
+        throw new Error("[Beignet env] Schema uses async validation, which is not supported by load().");
+    }
+    return validationResultValue(result);
+}
+export async function parseStandardSchemaAsync(schema, input) {
+    const validate = schema?.["~standard"]?.validate;
+    if (typeof validate !== "function") {
+        throw new Error("Invalid Standard Schema: missing ~standard.validate()");
+    }
+    return validationResultValue(await validate(input));
+}
+function wrapEnvError(err, prefix) {
+    if (err instanceof ConfigValidationError) {
+        return new Error(`[Beignet env] Invalid environment${prefix ? ` for prefix "${prefix}"` : ""}: ${err.message}`);
+    }
+    if (err instanceof Error) {
+        return new Error(`[Beignet env] Invalid environment${prefix ? ` for prefix "${prefix}"` : ""}: ${err.message}`);
+    }
+    return new Error(`[Beignet env] Invalid environment${prefix ? ` for prefix "${prefix}"` : ""}: ${String(err)}`);
+}
+export function defineEnv(options) {
+    const { schema, prefix, runtimeEnv, emptyStringAsUndefined = false, skipValidation = false, onValidationError, } = options;
+    function load({ env = runtimeEnv ?? defaultRuntimeEnv(), } = {}) {
+        const raw = readEnv({ env, prefix, emptyStringAsUndefined });
+        if (skipValidation) {
+            return raw;
+        }
+        try {
+            return parseStandardSchemaSync(schema, raw);
+        }
+        catch (err) {
+            if (err instanceof ConfigValidationError) {
+                onValidationError?.(err.issues);
+            }
+            throw wrapEnvError(err, prefix);
+        }
+    }
+    return { load };
+}
+function validateEnvShape(shape, runtimeEnv, emptyStringAsUndefined) {
+    const output = {};
+    const issues = [];
+    for (const [key, schema] of Object.entries(shape)) {
+        const value = normalizeEnvValue(runtimeEnv[key], emptyStringAsUndefined);
+        try {
+            output[key] = parseStandardSchemaSync(schema, value);
+        }
+        catch (error) {
+            if (error instanceof ConfigValidationError) {
+                issues.push(...error.issues.map((issue) => prependIssuePath(key, issue)));
+                continue;
+            }
+            throw error;
+        }
+    }
+    if (issues.length) {
+        throw new ConfigValidationError(issues);
+    }
+    return output;
+}
+function validateClientPrefix(client, clientPrefix) {
+    if (!clientPrefix)
+        return;
+    for (const key of Object.keys(client)) {
+        if (!key.startsWith(clientPrefix)) {
+            throw new Error(`[Beignet env] Client environment variable "${key}" must start with "${clientPrefix}".`);
+        }
+    }
+}
+function validateRuntimeEnvStrict(runtimeEnv, keys) {
+    const missing = keys.filter((key) => !Object.hasOwn(runtimeEnv, key));
+    if (missing.length === 0)
+        return;
+    throw new Error(`[Beignet env] runtimeEnvStrict is missing declared keys: ${missing.join(", ")}`);
+}
+export function createEnv(options) {
+    const server = (options.server ?? {});
+    const client = (options.client ?? {});
+    const runtimeEnv = options.runtimeEnvStrict ?? options.runtimeEnv ?? defaultRuntimeEnv();
+    const emptyStringAsUndefined = options.emptyStringAsUndefined ?? true;
+    const isServer = options.isServer ?? !("window" in globalThis);
+    if (options.runtimeEnv && options.runtimeEnvStrict) {
+        throw new Error("[Beignet env] Specify runtimeEnv or runtimeEnvStrict, not both.");
+    }
+    validateClientPrefix(client, options.clientPrefix);
+    const declaredKeys = [...Object.keys(server), ...Object.keys(client)];
+    const validationShape = isServer ? { ...server, ...client } : client;
+    const validationKeys = isServer ? declaredKeys : Object.keys(client);
+    if (options.runtimeEnvStrict) {
+        validateRuntimeEnvStrict(runtimeEnv, validationKeys);
+    }
+    let parsed;
+    if (options.skipValidation) {
+        parsed = Object.fromEntries(validationKeys.map((key) => [
+            key,
+            normalizeEnvValue(runtimeEnv[key], emptyStringAsUndefined),
+        ]));
+    }
+    else {
+        try {
+            parsed = validateEnvShape(validationShape, runtimeEnv, emptyStringAsUndefined);
+        }
+        catch (error) {
+            if (error instanceof ConfigValidationError) {
+                options.onValidationError?.(error.issues);
+            }
+            throw wrapEnvError(error);
+        }
+    }
+    const serverKeys = new Set(Object.keys(server));
+    const clientKeys = new Set(Object.keys(client));
+    return new Proxy(parsed, {
+        get(target, property, receiver) {
+            if (typeof property === "string" &&
+                !isServer &&
+                serverKeys.has(property) &&
+                !clientKeys.has(property)) {
+                options.onInvalidAccess?.(property);
+                throw new Error(`[Beignet env] Attempted to access server-only environment variable "${property}" from a client runtime.`);
+            }
+            return Reflect.get(target, property, receiver);
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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

package/dist/contracts/contract-builder.d.ts

@@ -0,0 +1,121 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type { OpenAPIOperationMeta } from "./openapi-meta";
+import type { BodyHttpMethod, ContractErrorResponses, ContractHeaderSchemas, ContractMeta, ContractResponses, HttpContractConfig, HttpMethod, ResponsesFromErrorDefinitions, StandardSchema } from "./types";
+/**
+ * Contract builder for constructing HTTP contracts in a fluent API style
+ * Schemas are accessible via the .schema property for introspection
+ */
+export declare class ContractBuilder<TMethod extends HttpMethod, TPathParams extends StandardSchema | null, TQuery extends StandardSchema | null, TBody extends StandardSchema | null, THeaders extends ContractHeaderSchemas, TResponses extends ContractResponses, TMeta extends ContractMeta, TPath extends string = string> {
+    readonly kind: "http";
+    readonly name: string;
+    readonly namespace?: string;
+    readonly localName: string;
+    readonly method: TMethod;
+    private readonly _path;
+    private readonly _pathParams;
+    private readonly _query;
+    private readonly _body;
+    private readonly _headers;
+    private readonly _responses;
+    private readonly _meta;
+    constructor(config: HttpContractConfig<TMethod, TPathParams, TQuery, TBody, TResponses, TMeta, TPath, THeaders>);
+    /**
+     * Access schemas for introspection
+     */
+    get schema(): {
+        pathParams: TPathParams;
+        query: TQuery;
+        headers: THeaders;
+        body: TBody;
+        responses: TResponses;
+    };
+    /**
+     * Get response schemas for introspection
+     */
+    get responseSchemas(): TResponses;
+    /**
+     * Get the URL path template
+     */
+    get pathTemplate(): TPath;
+    /**
+     * Get the URL path (alias for pathTemplate)
+     */
+    get path(): TPath;
+    /**
+     * Get contract metadata
+     */
+    get metadata(): TMeta;
+    /**
+     * Get the contract as an HttpContractConfig object
+     * Use this when passing to adapters that expect the plain config type
+     */
+    get config(): HttpContractConfig<TMethod, TPathParams, TQuery, TBody, TResponses, TMeta, TPath, THeaders>;
+    /**
+     * Set path parameters schema (chainable builder method)
+     */
+    pathParams<TNewPathParams extends StandardSchemaV1>(schema: TNewPathParams): ContractBuilder<TMethod, TNewPathParams, TQuery, TBody, THeaders, TResponses, TMeta, TPath>;
+    /**
+     * Set query parameters schema (chainable builder method)
+     */
+    query<TNewQuery extends StandardSchemaV1>(schema: TNewQuery): ContractBuilder<TMethod, TPathParams, TNewQuery, TBody, THeaders, TResponses, TMeta, TPath>;
+    /**
+     * Set request body schema (chainable builder method)
+     * Only available on POST, PUT, and PATCH contracts.
+     */
+    body<TNewBody extends StandardSchemaV1>(this: ContractBuilder<BodyHttpMethod, StandardSchema | null, StandardSchema | null, StandardSchema | null, ContractHeaderSchemas, ContractResponses, ContractMeta, TPath>, schema: TNewBody): ContractBuilder<TMethod, TPathParams, TQuery, TNewBody, THeaders, TResponses, TMeta, TPath>;
+    /**
+     * Add request header schema (chainable).
+     *
+     * Multiple schemas are evaluated in declaration order and their parsed
+     * outputs are merged. This keeps group-level headers library-agnostic.
+     */
+    headers<TNewHeaders extends StandardSchemaV1>(schema: TNewHeaders): ContractBuilder<TMethod, TPathParams, TQuery, TBody, THeaders extends readonly StandardSchema[] ? readonly [...THeaders, TNewHeaders] : THeaders extends StandardSchema ? readonly [THeaders, TNewHeaders] : readonly [TNewHeaders], TResponses, TMeta, TPath>;
+    /**
+     * Add or replace response schemas by status code (chainable).
+     * Use `null` for void/empty responses such as 204 No Content.
+     */
+    responses<TNewResponses extends ContractResponses>(responseSchemas: TNewResponses): ContractBuilder<TMethod, TPathParams, TQuery, TBody, THeaders, Omit<TResponses, keyof TNewResponses> & TNewResponses, TMeta, TPath>;
+    /**
+     * Declare route-owned application errors from an error catalog.
+     *
+     * Catalog errors use Beignet's standard error response envelope. Use
+     * `.responses()` when a route needs a custom error response body.
+     */
+    errors<TErrorDefs extends ContractErrorResponses>(errorDefs: TErrorDefs): ContractBuilder<TMethod, TPathParams, TQuery, TBody, THeaders, Omit<TResponses, keyof ResponsesFromErrorDefinitions<TErrorDefs>> & ResponsesFromErrorDefinitions<TErrorDefs>, Omit<TMeta, "errors"> & {
+        errors: TErrorDefs;
+    }, TPath>;
+    /**
+     * Set or merge contract metadata (chainable builder method)
+     */
+    meta<TNewMeta extends ContractMeta>(newMeta: TNewMeta): ContractBuilder<TMethod, TPathParams, TQuery, TBody, THeaders, TResponses, Omit<TMeta, keyof TNewMeta> & TNewMeta, TPath>;
+    /**
+     * Set or merge OpenAPI metadata for this operation (chainable)
+     */
+    openapi(patch: Partial<OpenAPIOperationMeta>): ContractBuilder<TMethod, TPathParams, TQuery, TBody, THeaders, TResponses, TMeta, TPath>;
+}
+/**
+ * Options for creating a contract with the factory function
+ */
+export type CreateContractOptions<TMethod extends HttpMethod = HttpMethod, TPath extends string = string> = {
+    /** HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS) */
+    method: TMethod;
+    /** URL path template (e.g., "/api/users/:id") */
+    path: TPath;
+    /** Optional contract name (auto-generated from method + path if not provided) */
+    name?: string;
+};
+/**
+ * Create a new HTTP contract with the builder pattern.
+ *
+ * @example
+ * ```ts
+ * const getTodo = createContract({
+ *   method: "GET",
+ *   path: "/api/todos/:id",
+ * })
+ *   .pathParams(z.object({ id: z.string() }))
+ *   .responses({ 200: TodoSchema });
+ * ```
+ */
+export declare function createContract<TMethod extends HttpMethod, const TPath extends string>(options: CreateContractOptions<TMethod, TPath>): ContractBuilder<TMethod, null, null, null, null, Record<never, never>, ContractMeta, TPath>;
+//# sourceMappingURL=contract-builder.d.ts.map