@beignet/core 0.0.33 → 0.0.35

package/src/openapi/index.ts

@@ -553,10 +553,13 @@ function addPathParams(
 
   const shape = state.introspector.getShape(contract.pathParams);
   if (!shape) {
-    if (pathKeys.length > 0) {
-      throw new Error(
-        `Unable to introspect pathParams for contract "${contract.name}" at "${contract.path}". OpenAPI path parameters must match the path template.`,
-      );
+    for (const key of pathKeys) {
+      addParameter(operation, {
+        name: key,
+        in: "path",
+        required: true,
+        schema: { type: "string" },
+      });
     }
     return;
   }
@@ -612,14 +615,8 @@ function addQueryParams(
     const originalField = shape[key];
     const optional = state.introspector.isOptional(originalField);
 
-    let description = state.introspector.getDescription(originalField);
-
     const field = originalField;
-
-    // If outer optional didn't have description, check inner type
-    if (!description && optional) {
-      description = state.introspector.getDescription(field);
-    }
+    const description = parameterDescription(field, optional, state);
 
     const paramSchemaRef = schemaToConvertedSchemaRef(
       field,
@@ -656,7 +653,7 @@ function addHeaderParams(
     for (const key of Object.keys(shape)) {
       const originalField = shape[key];
       const optional = state.introspector.isOptional(originalField);
-      const description = state.introspector.getDescription(originalField);
+      const description = parameterDescription(originalField, optional, state);
 
       const paramSchemaRef = schemaToConvertedSchemaRef(
         originalField,
@@ -676,6 +673,21 @@ function addHeaderParams(
   }
 }
 
+function parameterDescription(
+  field: unknown,
+  optional: boolean,
+  state: GeneratorState,
+): string | undefined {
+  return (
+    state.introspector.getDescription(field) ??
+    (optional
+      ? state.introspector.getDescription(
+          state.introspector.unwrapOptional(field),
+        )
+      : undefined)
+  );
+}
+
 /**
  * Add request body from contract to operation
  */

package/src/ports/auth.ts

@@ -36,6 +36,8 @@ export interface AuthSession<User = unknown, Session = unknown> {
  */
 export class AuthUnauthorizedError extends Error {
   readonly code = "UNAUTHORIZED";
+  /** HTTP status used when the server maps this framework error. */
+  readonly status = 401;
 
   constructor(message = "Unauthorized") {
     super(message);

package/src/ports/events.ts

@@ -51,9 +51,9 @@ export type InferJobPayload<J extends JobDef> = InferContractJobPayload<J>;
  *
  * @example
  * ```ts
- * import { createInMemoryEventBus } from "@beignet/provider-event-bus-memory";
+ * import { createMemoryEventBus } from "@beignet/provider-event-bus-memory";
  *
- * const eventBus = createInMemoryEventBus();
+ * const eventBus = createMemoryEventBus();
  *
  * // Subscribe to an event
  * const unsubscribe = eventBus.subscribe(UserRegistered, (payload) => {

package/src/ports/index.ts

@@ -224,7 +224,6 @@ export {
   createMemoryFlags,
   createStaticFlags,
   defineFlag,
-  defineFlagRegistry,
   defineFlags,
   evaluateFlag,
   getFlagDetails,

package/src/providers/index.ts

@@ -39,6 +39,7 @@ export {
   parseProviderPackageMetadata,
 } from "./metadata.js";
 export {
+  type AnyProviderConfigSchema,
   type AnyServiceProvider,
   createProvider,
   type InferOutput,

package/src/providers/provider.ts

@@ -170,7 +170,7 @@ export interface ServiceProviderMetadata {
  *
  * @example
  * ```ts
- * const redisCacheProvider = createProvider({
+ * const cacheProvider = createProvider({
  *   name: "cache-redis",
  *   config: {
  *     schema: z.object({ URL: z.string().url() }),
@@ -240,6 +240,22 @@ export interface ServiceProvider<
   readonly __providedPorts?: ProvidedPorts;
 }
 
+/**
+ * A provider configuration schema whose concrete validation library and input
+ * shape are intentionally erased while its validated output may stay typed.
+ *
+ * Reusable provider packages use this in their named provider return types so
+ * internal Zod schemas do not become part of the package's public API.
+ */
+export type AnyProviderConfigSchema<
+  // biome-ignore lint/suspicious/noExplicitAny: arbitrary provider consumers may erase config output
+  Output = any,
+> = StandardSchemaV1<
+  // biome-ignore lint/suspicious/noExplicitAny: reusable provider return types intentionally erase config input
+  any,
+  Output
+>;
+
 /**
  * Loosely typed service provider.
  *
@@ -250,8 +266,7 @@ export interface ServiceProvider<
  */
 export type AnyServiceProvider = ServiceProvider<
   unknown,
-  // biome-ignore lint/suspicious/noExplicitAny: provider config types are erased at this level
-  StandardSchemaV1<any, any>,
+  AnyProviderConfigSchema,
   ProviderPorts,
   // biome-ignore lint/suspicious/noExplicitAny: provider context types are erased at this level
   any,

package/src/schedules/index.ts

@@ -1,4 +1,9 @@
 import type { StandardSchemaV1 } from "@standard-schema/spec";
+import {
+  createProviderInstrumentation,
+  type ProviderInstrumentation,
+  type ProviderInstrumentationTarget,
+} from "../providers/index.js";
 import { runWithResolvedTracingContext } from "../tracing/execution.js";
 import type { TracingPort } from "../tracing/index.js";
 
@@ -312,16 +317,6 @@ export interface ScheduleDevtoolsEvent {
   details?: Record<string, unknown>;
 }
 
-/**
- * Sink for schedule devtools events, usually `ctx.ports.devtools`.
- */
-export interface ScheduleInstrumentation {
-  /**
-   * Record one schedule devtools event.
-   */
-  record(event: ScheduleDevtoolsEvent): unknown;
-}
-
 /**
  * Correlation fields attached to schedule instrumentation events.
  */
@@ -381,13 +376,14 @@ export interface InlineScheduleRunnerOptions<Ctx> {
    */
   now?: () => Date;
   /**
-   * Devtools-compatible sink that receives `schedule` events for each run.
+   * Provider instrumentation target that receives `schedule` events for each
+   * run. Pass `ctx.ports`, `ctx.ports.instrumentation`, or
+   * `ctx.ports.devtools` directly.
    *
    * The runner records `started`, `completed`, and `failed` events. Recording
-   * failures are isolated from schedule execution and reported to
-   * `onHookError` when provided.
+   * failures are isolated from schedule execution.
    */
-  instrumentation?: ScheduleInstrumentation;
+  instrumentation?: ProviderInstrumentationTarget;
   /**
    * Correlation fields attached to recorded schedule events.
    */
@@ -675,45 +671,28 @@ async function recordScheduleEvent<
   Ctx,
   S extends ScheduleDef<string, StandardSchema, Ctx>,
 >(
-  options: InlineScheduleRunnerOptions<Ctx>,
+  instrumentation: ProviderInstrumentation,
+  instrumentationContext: ScheduleInstrumentationContext | undefined,
   schedule: S,
   status: ScheduleDevtoolsEvent["status"],
   run: ScheduleRunContext,
-  args: {
-    payload?: InferSchedulePayload<S>;
-    hook: ScheduleHookName;
-    scheduleError?: unknown;
-    details?: Record<string, unknown>;
-  },
+  details?: Record<string, unknown>,
 ): Promise<void> {
-  if (!options.instrumentation) return;
-
-  try {
-    options.instrumentation.record({
-      type: "schedule",
-      watcher: "schedules",
-      requestId: options.instrumentationContext?.requestId,
-      traceId: options.instrumentationContext?.traceId,
-      scheduleName: schedule.name,
-      status,
-      cron: schedule.cron,
-      timezone: schedule.timezone,
-      details: {
-        source: run.source,
-        scheduledAt: run.scheduledAt?.toISOString(),
-        ...args.details,
-      },
-    });
-  } catch (error) {
-    await reportHookError(options.onHookError, {
-      schedule,
-      payload: args.payload,
-      run,
-      hook: args.hook,
-      error,
-      scheduleError: args.scheduleError,
-    });
-  }
+  instrumentation.record({
+    type: "schedule",
+    watcher: "schedules",
+    requestId: instrumentationContext?.requestId,
+    traceId: instrumentationContext?.traceId,
+    scheduleName: schedule.name,
+    status,
+    cron: schedule.cron,
+    timezone: schedule.timezone,
+    details: {
+      source: run.source,
+      scheduledAt: run.scheduledAt?.toISOString(),
+      ...details,
+    },
+  });
 }
 
 function defineScheduleImpl<
@@ -785,6 +764,13 @@ export function createInlineScheduleRunner<Ctx>(
   options: InlineScheduleRunnerOptions<Ctx> = {},
 ): InlineScheduleRunner<Ctx> {
   const now = options.now ?? (() => new Date());
+  const instrumentation = createProviderInstrumentation(
+    options.instrumentation,
+    {
+      providerName: "schedules",
+      watcher: "schedules",
+    },
+  );
 
   return {
     async run<S extends ScheduleDef<string, StandardSchema, Ctx>>(
@@ -798,10 +784,13 @@ export function createInlineScheduleRunner<Ctx>(
         payload = await resolveSchedulePayload(schedule, runOptions, run);
 
         const lifecycleArgs = { schedule, payload, run };
-        await recordScheduleEvent(options, schedule, "started", run, {
-          payload,
-          hook: "start",
-        });
+        await recordScheduleEvent(
+          instrumentation,
+          options.instrumentationContext,
+          schedule,
+          "started",
+          run,
+        );
         await runLifecycleHook(
           "start",
           options.onStart,
@@ -820,10 +809,13 @@ export function createInlineScheduleRunner<Ctx>(
               run,
             }),
         });
-        await recordScheduleEvent(options, schedule, "completed", run, {
-          payload,
-          hook: "success",
-        });
+        await recordScheduleEvent(
+          instrumentation,
+          options.instrumentationContext,
+          schedule,
+          "completed",
+          run,
+        );
         await runLifecycleHook(
           "success",
           options.onSuccess,
@@ -831,12 +823,14 @@ export function createInlineScheduleRunner<Ctx>(
           lifecycleArgs,
         );
       } catch (error) {
-        await recordScheduleEvent(options, schedule, "failed", run, {
-          payload,
-          hook: "error",
-          scheduleError: error,
-          details: { error },
-        });
+        await recordScheduleEvent(
+          instrumentation,
+          options.instrumentationContext,
+          schedule,
+          "failed",
+          run,
+          { error },
+        );
         await runErrorHook(options.onError, options.onHookError, {
           error,
           schedule,

package/src/server/index.ts

@@ -76,7 +76,10 @@ export type {
   RawRouteBuilder,
   RawRouteInit,
   RouteDef,
+  RouteDefinitionBuilder,
   RouteGroup,
+  RouteGroupBuilder,
+  Routes,
   ServerInstance,
 } from "./server.js";
 /**
@@ -84,9 +87,8 @@ export type {
  */
 export {
   contractsFromRoutes,
+  createRoutes,
   createServer,
-  defineRoute,
-  defineRouteGroup,
   defineRoutes,
 } from "./server.js";
 /**