@beignet/core 0.0.1

package/dist/providers/instrumentation.js

@@ -0,0 +1,93 @@
+import { redactValue } from "../ports/redaction";
+function isObject(value) {
+    return typeof value === "object" && value !== null;
+}
+export function isProviderInstrumentation(value) {
+    return (isObject(value) &&
+        typeof value.record === "function" &&
+        typeof value.custom === "function" &&
+        typeof value.isEnabled === "function");
+}
+export function isProviderInstrumentationPort(value) {
+    return isObject(value) && typeof value.record === "function";
+}
+function resolveProviderInstrumentationValue(value) {
+    if (isProviderInstrumentation(value))
+        return value.port;
+    if (isProviderInstrumentationPort(value))
+        return value;
+    return undefined;
+}
+export function resolveProviderInstrumentationPort(target) {
+    if (!target)
+        return undefined;
+    const directPort = resolveProviderInstrumentationValue(target);
+    if (directPort)
+        return directPort;
+    if (!isObject(target))
+        return undefined;
+    return (resolveProviderInstrumentationValue(target.instrumentation) ??
+        resolveProviderInstrumentationValue(target.devtools));
+}
+function withProviderDetails(providerName, details) {
+    if (details === undefined) {
+        return { providerName };
+    }
+    if (isObject(details) && !Array.isArray(details)) {
+        return { ...details, providerName };
+    }
+    return { providerName, value: details };
+}
+export function createProviderInstrumentation(target, options) {
+    if (isProviderInstrumentation(target)) {
+        return target;
+    }
+    const port = resolveProviderInstrumentationPort(target);
+    function isEnabled(watcher = options.watcher) {
+        if (!port)
+            return false;
+        if (!watcher)
+            return true;
+        return port.isWatcherEnabled?.(watcher) ?? true;
+    }
+    function record(event) {
+        if (!port)
+            return undefined;
+        const watcher = event.watcher ?? options.watcher;
+        if (watcher && !isEnabled(watcher))
+            return undefined;
+        const eventWithWatcher = options.watcher && event.watcher === undefined
+            ? { ...event, watcher: options.watcher }
+            : event;
+        let redacted;
+        try {
+            redacted = options.redact
+                ? options.redact(redactValue(eventWithWatcher))
+                : redactValue(eventWithWatcher);
+        }
+        catch {
+            return undefined;
+        }
+        try {
+            return port.record(redacted);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    function custom(event) {
+        return record({
+            ...event,
+            type: "custom",
+            watcher: event.watcher ?? options.watcher,
+            details: withProviderDetails(options.providerName, event.details),
+        });
+    }
+    return {
+        port,
+        isEnabled,
+        record,
+        custom,
+    };
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/providers/instrumentation.js.map

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

package/dist/providers/provider.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Provider system for Beignet
+ *
+ * Providers are modular extensions that can add new ports or replace existing ones
+ * during application initialization. They support configuration via Standard Schema
+ * and optional lifecycle hooks.
+ */
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+type ProviderPorts = Record<string, unknown>;
+declare const noProvidedPorts: unique symbol;
+type NoProvidedPorts = {
+    [noProvidedPorts]?: never;
+};
+/**
+ * Extract the output type from a Standard Schema.
+ * This is the validated/parsed type that results from schema validation.
+ */
+export type InferOutput<T extends StandardSchemaV1> = StandardSchemaV1.InferOutput<T>;
+/**
+ * Configuration definition for a service provider.
+ * Specifies the schema for validating config and optional environment variable prefix.
+ */
+export interface ProviderConfigDef<CfgSchema extends StandardSchemaV1> {
+    /**
+     * Standard Schema for validating provider configuration.
+     * Can be Zod, Valibot, ArkType, or any Standard Schema compatible library.
+     */
+    schema: CfgSchema;
+    /**
+     * Optional prefix to read env vars, e.g. "REDIS_".
+     * When provided, the implementation will read process.env keys starting with this prefix
+     * and pass them to the schema for validation.
+     */
+    envPrefix?: string;
+}
+export type MaybePromise<T> = T | Promise<T>;
+export type ProviderLifecycleContext = {
+    ports: Readonly<ProviderPorts>;
+};
+export type ProviderSetupResult<ProvidedPorts extends ProviderPorts> = {
+    /**
+     * Ports contributed by this provider.
+     * Keys overwrite earlier ports with the same name at runtime. Prefer unique
+     * keys unless the replacement implements the same port contract.
+     */
+    ports?: ProvidedPorts;
+    /**
+     * Optional hook called after all providers have contributed their ports.
+     */
+    start?: (ctx: ProviderLifecycleContext) => MaybePromise<void>;
+    /**
+     * Optional hook called when the server is stopped.
+     */
+    stop?: (ctx: ProviderLifecycleContext) => MaybePromise<void>;
+};
+/**
+ * A service provider that can extend or replace ports during app initialization.
+ *
+ * Providers support:
+ * - Configuration via Standard Schema (any compatible library: Zod, Valibot, etc.)
+ * - Returning ports with new capabilities (e.g., cache, mailer)
+ * - Replacing existing ports by returning the same key
+ * - Optional start/stop hooks
+ *
+ * @example
+ * ```ts
+ * const redisProvider = createProvider({
+ *   name: "redis",
+ *   config: {
+ *     schema: z.object({ URL: z.string().url() }),
+ *     envPrefix: "REDIS_",
+ *   },
+ *   async setup({ config }) {
+ *     const client = new Redis(config.URL);
+ *     return {
+ *       ports: {
+ *         cache: {
+ *           get: (key) => client.get(key),
+ *           set: (key, value) => client.set(key, value),
+ *         },
+ *       },
+ *       stop: () => client.quit(),
+ *     };
+ *   },
+ * });
+ * ```
+ */
+export interface ServiceProvider<Ports, CfgSchema extends StandardSchemaV1 = StandardSchemaV1<void, void>, ProvidedPorts extends ProviderPorts = NoProvidedPorts> {
+    /**
+     * Unique name for this provider (used for logging/debugging)
+     */
+    name: string;
+    /**
+     * Optional configuration definition.
+     * If provided, the config will be loaded and validated before calling setup.
+     */
+    config?: ProviderConfigDef<CfgSchema>;
+    /**
+     * Setup phase: create the ports this provider contributes.
+     * Called during app initialization, before routes are registered.
+     *
+     * @param ctx.ports - Ports contributed by previous providers
+     * @param ctx.config - Validated config (if config was defined), or undefined
+     */
+    setup(ctx: {
+        ports: Readonly<Ports>;
+        config: InferOutput<CfgSchema> | undefined;
+    }): MaybePromise<ProviderSetupResult<ProvidedPorts>>;
+    /**
+     * Type-only marker for ports this provider contributes.
+     * Runtime provider objects do not need to set this property.
+     */
+    readonly __providedPorts?: ProvidedPorts;
+}
+/**
+ * Extract the ports a provider contributes.
+ */
+export type ProvidedPortsOf<TProvider> = TProvider extends ServiceProvider<infer _Ports, infer _CfgSchema, infer ProvidedPorts> ? ProvidedPorts : NoProvidedPorts;
+type UnionToIntersection<T> = (T extends unknown ? (value: T) => void : never) extends (value: infer I) => void ? I : never;
+/**
+ * Extract and merge the ports contributed by a provider list.
+ */
+export type ProvidedPortsOfList<TProviders> = TProviders extends readonly unknown[] ? [TProviders[number]] extends [never] ? NoProvidedPorts : UnionToIntersection<ProvidedPortsOf<TProviders[number]>> : NoProvidedPorts;
+/**
+ * Helper function to create a provider with proper type inference.
+ *
+ * This is a simple identity function that helps TypeScript infer the correct types
+ * for the provider definition.
+ *
+ * @example
+ * ```ts
+ * export const myProvider = createProvider({
+ *   name: "my-provider",
+ *   config: {
+ *     schema: z.object({ apiKey: z.string() }),
+ *     envPrefix: "MY_SERVICE_",
+ *   },
+ *   async setup({ config }) {
+ *     return { ports: { myService: createMyService(config) } };
+ *   },
+ * });
+ * ```
+ */
+export declare function createProvider<Ports = unknown, CfgSchema extends StandardSchemaV1 = StandardSchemaV1<void, void>, ProvidedPorts extends ProviderPorts = NoProvidedPorts>(def: ServiceProvider<Ports, CfgSchema, ProvidedPorts>): ServiceProvider<Ports, CfgSchema, ProvidedPorts>;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/providers/provider.d.ts.map

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

package/dist/providers/provider.js

@@ -0,0 +1,31 @@
+/**
+ * Provider system for Beignet
+ *
+ * Providers are modular extensions that can add new ports or replace existing ones
+ * during application initialization. They support configuration via Standard Schema
+ * and optional lifecycle hooks.
+ */
+/**
+ * Helper function to create a provider with proper type inference.
+ *
+ * This is a simple identity function that helps TypeScript infer the correct types
+ * for the provider definition.
+ *
+ * @example
+ * ```ts
+ * export const myProvider = createProvider({
+ *   name: "my-provider",
+ *   config: {
+ *     schema: z.object({ apiKey: z.string() }),
+ *     envPrefix: "MY_SERVICE_",
+ *   },
+ *   async setup({ config }) {
+ *     return { ports: { myService: createMyService(config) } };
+ *   },
+ * });
+ * ```
+ */
+export function createProvider(def) {
+    return def;
+}
+//# sourceMappingURL=provider.js.map

package/dist/providers/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4JH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAK5B,GAAqD;IAErD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/schedules/index.d.ts

@@ -0,0 +1,105 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+export type StandardSchema = StandardSchemaV1<unknown, unknown>;
+export type MaybePromise<T> = T | Promise<T>;
+export type InferSchemaOutput<T extends StandardSchemaV1> = StandardSchemaV1.InferOutput<T>;
+export type ScheduleDateInput = Date | string | number;
+export interface ScheduleRunContext {
+    readonly id?: string;
+    readonly scheduledAt?: Date;
+    readonly triggeredAt: Date;
+    readonly source?: string;
+}
+export interface SchedulePayloadDef<Name extends string = string, Payload extends StandardSchema = StandardSchema> {
+    readonly name: Name;
+    readonly payload: Payload;
+}
+export interface ScheduleDef<Name extends string = string, Payload extends StandardSchema = StandardSchema, Ctx = unknown> extends SchedulePayloadDef<Name, Payload> {
+    readonly kind: "schedule";
+    readonly cron: string;
+    readonly timezone?: string;
+    readonly description?: string;
+    createPayload?(args: ScheduleCreatePayloadArgs<ScheduleDef<Name, Payload, Ctx>>): MaybePromise<InferSchemaOutput<Payload>>;
+    handle(args: ScheduleHandleArgs<ScheduleDef<Name, Payload, Ctx>, Ctx>): MaybePromise<void>;
+}
+export type InferSchedulePayload<S extends SchedulePayloadDef> = S["payload"] extends StandardSchemaV1<unknown, infer Output> ? Output : never;
+export interface ScheduleCreatePayloadArgs<S extends SchedulePayloadDef> {
+    schedule: S;
+    run: ScheduleRunContext;
+}
+export interface ScheduleHandleArgs<S extends ScheduleDef, Ctx> {
+    schedule: S;
+    payload: InferSchedulePayload<S>;
+    ctx: Ctx;
+    run: ScheduleRunContext;
+}
+export interface DefineScheduleOptions<Name extends string, Payload extends StandardSchema, Ctx> {
+    cron: string;
+    timezone?: string;
+    payload: Payload;
+    description?: string;
+    createPayload?(args: ScheduleCreatePayloadArgs<ScheduleDef<Name, Payload, Ctx>>): MaybePromise<InferSchemaOutput<Payload>>;
+    handle(args: ScheduleHandleArgs<ScheduleDef<Name, Payload, Ctx>, Ctx>): MaybePromise<void>;
+}
+export interface ScheduleRunOptions<Payload = unknown> {
+    payload?: Payload;
+    id?: string;
+    scheduledAt?: ScheduleDateInput;
+    triggeredAt?: ScheduleDateInput;
+    source?: string;
+}
+export type ScheduleRunArgs<Ctx, Payload = unknown> = ScheduleRunOptions<Payload> & {
+    ctx: Ctx;
+};
+export interface ScheduleLifecycleArgs<S extends ScheduleDef = ScheduleDef> {
+    schedule: S;
+    payload: InferSchedulePayload<S>;
+    run: ScheduleRunContext;
+}
+export interface ScheduleErrorArgs<S extends ScheduleDef = ScheduleDef> {
+    schedule: S;
+    payload?: InferSchedulePayload<S>;
+    run: ScheduleRunContext;
+    error: unknown;
+}
+export type ScheduleHookName = "start" | "success" | "error";
+export interface ScheduleHookErrorArgs<S extends ScheduleDef = ScheduleDef> {
+    schedule: S;
+    payload?: InferSchedulePayload<S>;
+    run: ScheduleRunContext;
+    hook: ScheduleHookName;
+    error: unknown;
+    scheduleError?: unknown;
+}
+export interface InlineScheduleRunnerOptions<Ctx> {
+    ctx?: Ctx | (() => MaybePromise<Ctx>);
+    now?: () => Date;
+    onStart?<S extends ScheduleDef<string, StandardSchema, Ctx>>(args: ScheduleLifecycleArgs<S>): MaybePromise<void>;
+    onSuccess?<S extends ScheduleDef<string, StandardSchema, Ctx>>(args: ScheduleLifecycleArgs<S>): MaybePromise<void>;
+    onError?<S extends ScheduleDef<string, StandardSchema, Ctx>>(args: ScheduleErrorArgs<S>): MaybePromise<void>;
+    onHookError?<S extends ScheduleDef<string, StandardSchema, Ctx>>(args: ScheduleHookErrorArgs<S>): MaybePromise<void>;
+}
+export interface ScheduleRunnerPort<Ctx = unknown> {
+    run<S extends ScheduleDef<string, StandardSchema, Ctx>>(schedule: S, options?: ScheduleRunOptions<InferSchedulePayload<S>>): Promise<void>;
+}
+export interface InlineScheduleRunner<Ctx = unknown> extends ScheduleRunnerPort<Ctx> {
+}
+export interface ScheduleHandlers<Ctx> {
+    defineSchedule<Name extends string, Payload extends StandardSchema>(name: Name, options: DefineScheduleOptions<Name, Payload, Ctx>): ScheduleDef<Name, Payload, Ctx>;
+    createInlineScheduleRunner(options?: InlineScheduleRunnerOptions<Ctx>): InlineScheduleRunner<Ctx>;
+}
+export declare class ScheduleValidationError extends Error {
+    readonly issues: readonly StandardSchemaV1.Issue[];
+    constructor(args: {
+        name: string;
+        issues: readonly StandardSchemaV1.Issue[];
+    });
+}
+export declare class ScheduleRunContextError extends Error {
+    constructor(message: string);
+}
+export declare function defineSchedule<Name extends string, Payload extends StandardSchema, Ctx = unknown>(name: Name, options: DefineScheduleOptions<Name, Payload, Ctx>): ScheduleDef<Name, Payload, Ctx>;
+export declare function parseSchedulePayload<S extends SchedulePayloadDef>(schedule: S, payload: unknown): Promise<InferSchedulePayload<S>>;
+export declare function runSchedule<Ctx, S extends ScheduleDef<string, StandardSchema, Ctx>>(schedule: S, args: ScheduleRunArgs<Ctx, InferSchedulePayload<S>>): Promise<void>;
+export declare function createInlineScheduleRunner<Ctx>(options?: InlineScheduleRunnerOptions<Ctx>): InlineScheduleRunner<Ctx>;
+export declare function createScheduleHandlers<Ctx>(): ScheduleHandlers<Ctx>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schedules/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAChE,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,gBAAgB,IACtD,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAElC,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB,CACjC,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,OAAO,SAAS,cAAc,GAAG,cAAc;IAE/C,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW,CAC1B,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,OAAO,SAAS,cAAc,GAAG,cAAc,EAC/C,GAAG,GAAG,OAAO,CACb,SAAQ,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,CAAC,CACZ,IAAI,EAAE,yBAAyB,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,GAC/D,YAAY,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,MAAM,CACJ,IAAI,EAAE,kBAAkB,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,GAC7D,YAAY,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,kBAAkB,IAC3D,CAAC,CAAC,SAAS,CAAC,SAAS,gBAAgB,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC;AAEhF,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,kBAAkB;IACrE,QAAQ,EAAE,CAAC,CAAC;IACZ,GAAG,EAAE,kBAAkB,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,WAAW,EAAE,GAAG;IAC5D,QAAQ,EAAE,CAAC,CAAC;IACZ,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACjC,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,kBAAkB,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB,CACpC,IAAI,SAAS,MAAM,EACnB,OAAO,SAAS,cAAc,EAC9B,GAAG;IAEH,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,CACZ,IAAI,EAAE,yBAAyB,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,GAC/D,YAAY,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,MAAM,CACJ,IAAI,EAAE,kBAAkB,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,GAC7D,YAAY,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB,CAAC,OAAO,GAAG,OAAO;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,CACzB,GAAG,EACH,OAAO,GAAG,OAAO,IACf,kBAAkB,CAAC,OAAO,CAAC,GAAG;IAChC,GAAG,EAAE,GAAG,CAAC;CACV,CAAC;AAEF,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACxE,QAAQ,EAAE,CAAC,CAAC;IACZ,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACjC,GAAG,EAAE,kBAAkB,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACpE,QAAQ,EAAE,CAAC,CAAC;IACZ,OAAO,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAClC,GAAG,EAAE,kBAAkB,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACxE,QAAQ,EAAE,CAAC,CAAC;IACZ,OAAO,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAClC,GAAG,EAAE,kBAAkB,CAAC;IACxB,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B,CAAC,GAAG;IAC9C,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,CAAC,CAAC,CAAC,SAAS,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EACzD,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC7B,YAAY,CAAC,IAAI,CAAC,CAAC;IACtB,SAAS,CAAC,CAAC,CAAC,SAAS,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAC3D,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC7B,YAAY,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,CAAC,CAAC,CAAC,SAAS,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EACzD,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GACzB,YAAY,CAAC,IAAI,CAAC,CAAC;IACtB,WAAW,CAAC,CAAC,CAAC,SAAS,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAC7D,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC7B,YAAY,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB,CAAC,GAAG,GAAG,OAAO;IAC/C,GAAG,CAAC,CAAC,SAAS,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EACpD,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,GACpD,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB,CAAC,GAAG,GAAG,OAAO,CACjD,SAAQ,kBAAkB,CAAC,GAAG,CAAC;CAAG;AAEpC,MAAM,WAAW,gBAAgB,CAAC,GAAG;IACnC,cAAc,CAAC,IAAI,SAAS,MAAM,EAAE,OAAO,SAAS,cAAc,EAChE,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,GACjD,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IAEnC,0BAA0B,CACxB,OAAO,CAAC,EAAE,2BAA2B,CAAC,GAAG,CAAC,GACzC,oBAAoB,CAAC,GAAG,CAAC,CAAC;CAC9B;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,CAAC,KAAK,EAAE,CAAC;gBAEvC,IAAI,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,SAAS,gBAAgB,CAAC,KAAK,EAAE,CAAC;KAC3C;CAOF;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B;AA8JD,wBAAgB,cAAc,CAC5B,IAAI,SAAS,MAAM,EACnB,OAAO,SAAS,cAAc,EAC9B,GAAG,GAAG,OAAO,EAEb,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,GACjD,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAajC;AAED,wBAAsB,oBAAoB,CAAC,CAAC,SAAS,kBAAkB,EACrE,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAIlC;AAED,wBAAsB,WAAW,CAC/B,GAAG,EACH,CAAC,SAAS,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAElD,QAAQ,EAAE,CAAC,EACX,IAAI,EAAE,eAAe,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAC5C,OAAO,GAAE,2BAA2B,CAAC,GAAG,CAAM,GAC7C,oBAAoB,CAAC,GAAG,CAAC,CA4C3B;AAED,wBAAgB,sBAAsB,CAAC,GAAG,KAAK,gBAAgB,CAAC,GAAG,CAAC,CAenE"}

package/dist/schedules/index.js

@@ -0,0 +1,178 @@
+export class ScheduleValidationError extends Error {
+    issues;
+    constructor(args) {
+        super(`Schedule "${args.name}" payload validation failed: ${formatIssues(args.issues)}`);
+        this.name = "ScheduleValidationError";
+        this.issues = args.issues;
+    }
+}
+export class ScheduleRunContextError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ScheduleRunContextError";
+    }
+}
+function formatPath(path) {
+    if (!path?.length)
+        return "";
+    return path
+        .map((segment) => typeof segment === "object" && segment !== null && "key" in segment
+        ? String(segment.key)
+        : String(segment))
+        .join(".");
+}
+function formatIssues(issues) {
+    return issues
+        .map((issue) => {
+        const path = formatPath(issue.path);
+        return path ? `${path}: ${issue.message}` : issue.message;
+    })
+        .join("; ");
+}
+async function parsePayload(schema, input, args) {
+    const result = await schema["~standard"].validate(input);
+    if (result.issues?.length) {
+        throw new ScheduleValidationError({
+            name: args.name,
+            issues: result.issues,
+        });
+    }
+    if ("value" in result) {
+        return result.value;
+    }
+    throw new Error("Invalid Standard Schema result: missing value");
+}
+function normalizeDate(value, field, fallback) {
+    if (value === undefined)
+        return fallback();
+    const date = value instanceof Date ? new Date(value.getTime()) : new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new ScheduleRunContextError(`Schedule run ${field} must be a valid date.`);
+    }
+    return date;
+}
+function normalizeOptionalDate(value, field) {
+    if (value === undefined)
+        return undefined;
+    return normalizeDate(value, field, () => new Date());
+}
+function createRunContext(options, now) {
+    return {
+        id: options.id,
+        scheduledAt: normalizeOptionalDate(options.scheduledAt, "scheduledAt"),
+        triggeredAt: normalizeDate(options.triggeredAt, "triggeredAt", now),
+        source: options.source,
+    };
+}
+async function resolveCtx(ctx) {
+    if (typeof ctx === "function") {
+        return ctx();
+    }
+    return ctx;
+}
+async function resolveSchedulePayload(schedule, options, run) {
+    const hasExplicitPayload = Object.hasOwn(options, "payload");
+    const rawPayload = hasExplicitPayload
+        ? options.payload
+        : await schedule.createPayload?.({ schedule, run });
+    return parseSchedulePayload(schedule, rawPayload);
+}
+async function reportHookError(onHookError, args) {
+    try {
+        await onHookError?.(args);
+    }
+    catch {
+        // Hook failures are isolated from schedule execution.
+    }
+}
+async function runLifecycleHook(hook, handler, onHookError, args) {
+    try {
+        await handler?.(args);
+    }
+    catch (error) {
+        await reportHookError(onHookError, { ...args, hook, error });
+    }
+}
+async function runErrorHook(handler, onHookError, args) {
+    try {
+        await handler?.(args);
+    }
+    catch (error) {
+        await reportHookError(onHookError, {
+            schedule: args.schedule,
+            payload: args.payload,
+            run: args.run,
+            hook: "error",
+            error,
+            scheduleError: args.error,
+        });
+    }
+}
+export function defineSchedule(name, options) {
+    return {
+        kind: "schedule",
+        name,
+        cron: options.cron,
+        timezone: options.timezone,
+        payload: options.payload,
+        description: options.description,
+        createPayload: options.createPayload,
+        handle: options.handle,
+    };
+}
+export async function parseSchedulePayload(schedule, payload) {
+    return (await parsePayload(schedule.payload, payload, {
+        name: schedule.name,
+    }));
+}
+export async function runSchedule(schedule, args) {
+    const run = createRunContext(args, () => new Date());
+    const payload = await resolveSchedulePayload(schedule, args, run);
+    await schedule.handle({
+        schedule,
+        payload,
+        ctx: args.ctx,
+        run,
+    });
+}
+export function createInlineScheduleRunner(options = {}) {
+    const now = options.now ?? (() => new Date());
+    return {
+        async run(schedule, runOptions = {}) {
+            const run = createRunContext(runOptions, now);
+            let payload;
+            try {
+                payload = await resolveSchedulePayload(schedule, runOptions, run);
+                const lifecycleArgs = { schedule, payload, run };
+                await runLifecycleHook("start", options.onStart, options.onHookError, lifecycleArgs);
+                await schedule.handle({
+                    schedule,
+                    payload,
+                    ctx: await resolveCtx(options.ctx),
+                    run,
+                });
+                await runLifecycleHook("success", options.onSuccess, options.onHookError, lifecycleArgs);
+            }
+            catch (error) {
+                await runErrorHook(options.onError, options.onHookError, {
+                    error,
+                    schedule,
+                    payload,
+                    run,
+                });
+                throw error;
+            }
+        },
+    };
+}
+export function createScheduleHandlers() {
+    return {
+        defineSchedule(name, options) {
+            return defineSchedule(name, options);
+        },
+        createInlineScheduleRunner(options = {}) {
+            return createInlineScheduleRunner(options);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/schedules/index.js.map

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

package/dist/server/contract-like.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Re-export contract resolution utilities for the server runtime.
+ */
+export { type ContractLike, type ResolveContract, resolveContract, } from "../contracts";
+//# sourceMappingURL=contract-like.d.ts.map

package/dist/server/contract-like.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-like.d.ts","sourceRoot":"","sources":["../../src/server/contract-like.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/server/contract-like.js

@@ -0,0 +1,5 @@
+/**
+ * Re-export contract resolution utilities for the server runtime.
+ */
+export { resolveContract, } from "../contracts";
+//# sourceMappingURL=contract-like.js.map

package/dist/server/contract-like.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-like.js","sourceRoot":"","sources":["../../src/server/contract-like.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAGL,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/server/health.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Health check handler
+ * Health check handler for Beignet server adapters.
+ */
+import type { AnyPorts } from "../ports";
+import type { HttpRequestLike, HttpResponseLike } from "./types";
+/**
+ * Health check result
+ */
+export interface HealthCheckResult {
+    ok: boolean;
+    details?: Record<string, {
+        ok: boolean;
+        message?: string;
+    }>;
+}
+/**
+ * Health check configuration
+ */
+export interface HealthConfig<Ports> {
+    /** Enable health endpoint (default: false) */
+    enabled?: boolean;
+    /**
+     * Suggested path for the health endpoint (e.g., "/api/health").
+     * NOTE: This field is for documentation/metadata only and does not control routing.
+     * You must manually wire the healthHandler to your desired route.
+     */
+    suggestedPath?: string;
+    /** Custom health check function */
+    check?: (ports: Ports) => Promise<HealthCheckResult>;
+}
+/**
+ * Application environment type
+ */
+export type AppEnvironment = "development" | "production" | "test";
+/**
+ * Create a health check handler
+ * Returns a function that can be called with an HttpRequestLike to get an HttpResponseLike
+ */
+export declare function createHealthHandler<Ports extends AnyPorts>(ports: Ports, healthConfig: HealthConfig<Ports> | undefined, env: AppEnvironment): (req: HttpRequestLike) => Promise<HttpResponseLike>;
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/server/health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,KAAK;IACjC,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,QAAQ,EACxD,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,SAAS,EAC7C,GAAG,EAAE,cAAc,GAClB,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAoCrD"}