@beignet/core 0.0.48 → 0.0.50

package/src/server/use-case-route.ts

@@ -192,8 +192,10 @@ type UseCaseRouteShape<
   /**
    * Map parsed request parts to the use case input.
    *
-   * Defaults to `defaultBinderInput`, which merges query, body, and path
-   * objects (path wins collisions) and never merges headers.
+   * A sole declared path, query, or body schema is passed through unchanged
+   * when no additional path, query, or object body values are present.
+   * Otherwise `defaultBinderInput` merges query, body, and path objects (path
+   * wins collisions) and never merges headers.
    */
   input?: (parts: UseCaseRouteInputParts<C>) => UseCaseRouteInput<UC>;
   handle?: never;
@@ -330,9 +332,10 @@ function isPlainObject(value: unknown): value is Record<string, unknown> {
  * Merges parsed query, body, and path objects into one input object. Path
  * keys win all collisions, then body keys, then query keys. Headers are never
  * merged: parsed headers include every raw request header, so merging them
- * would poison the use case input. Non-object bodies (text, arrays, scalars)
- * are excluded. Routes that need headers or non-object bodies declare an
- * explicit `input` mapper.
+ * would poison the use case input. The route binder passes a sole declared
+ * input schema through unchanged when no other object input contains values;
+ * this merge handles every other default mapping. Routes that combine a
+ * non-object body with another source declare an explicit `input` mapper.
  */
 export function defaultBinderInput(parts: {
   path: unknown;
@@ -356,16 +359,42 @@ export function isUseCaseRouteDef(route: {
   return route.useCase !== undefined && route.useCase !== null;
 }
 
-function computeTrustedInput(
+function computeSingleInput(
   contract: HttpContractConfig,
   def: RuntimeUseCaseRouteDef,
-): boolean {
-  if (def.input) return false;
+): { source: "path" | "query" | "body"; schema: unknown } | undefined {
+  if (def.input) return undefined;
+
+  const sources = [
+    { source: "path", schema: contract.pathParams },
+    {
+      source: "query",
+      schema: contract.query,
+    },
+    {
+      source: "body",
+      schema: contract.body,
+    },
+  ] as const;
+  const present = sources.filter(
+    (candidate) => candidate.schema !== null && candidate.schema !== undefined,
+  );
+  const single = present[0];
+  return present.length === 1 && single
+    ? { source: single.source, schema: single.schema }
+    : undefined;
+}
 
-  const sources = [contract.pathParams, contract.query, contract.body].filter(
-    (schema) => schema !== null && schema !== undefined,
+function canPassSingleInput(
+  parts: { path: unknown; query: unknown; body: unknown },
+  source: "path" | "query" | "body",
+): boolean {
+  return (["path", "query", "body"] as const).every(
+    (candidate) =>
+      candidate === source ||
+      !isPlainObject(parts[candidate]) ||
+      Object.keys(parts[candidate]).length === 0,
   );
-  return sources.length === 1 && sources[0] === def.useCase.inputSchema;
 }
 
 function computeResponseExemption(
@@ -405,11 +434,11 @@ export function createUseCaseRouteHandler<Ctx, C extends HttpContractConfig>(
     );
   }
 
-  const mapInput = def.input ?? defaultBinderInput;
-  const trustedRun = computeTrustedInput(contract, def)
-    ? def.useCase[USE_CASE_TRUSTED_RUN_KEY]
-    : undefined;
-  const run = trustedRun ?? def.useCase.run;
+  const singleInput = computeSingleInput(contract, def);
+  const trustedRun =
+    singleInput?.schema === def.useCase.inputSchema
+      ? def.useCase[USE_CASE_TRUSTED_RUN_KEY]
+      : undefined;
 
   const handler: Handler<Ctx, C> = async ({
     ctx,
@@ -417,13 +446,23 @@ export function createUseCaseRouteHandler<Ctx, C extends HttpContractConfig>(
     query,
     headers,
     body,
-  }) => ({
-    status,
-    body: await run.call(def.useCase, {
-      ctx,
-      input: mapInput({ path, query, headers, body }),
-    }),
-  });
+  }) => {
+    const parts = { path, query, headers, body };
+    const passSingle =
+      singleInput !== undefined &&
+      canPassSingleInput(parts, singleInput.source);
+    const input = def.input
+      ? def.input(parts)
+      : passSingle
+        ? parts[singleInput.source]
+        : defaultBinderInput(parts);
+    const run = passSingle && trustedRun ? trustedRun : def.useCase.run;
+
+    return {
+      status,
+      body: await run.call(def.useCase, { ctx, input }),
+    };
+  };
 
   return {
     handler,

package/src/testing/index.ts

@@ -29,6 +29,10 @@ import {
   createMemoryAuditLog,
   type MemoryAuditLogPort,
 } from "../ports/audit.js";
+import type {
+  BestEffortWork,
+  BestEffortWorkPort,
+} from "../ports/best-effort-work.js";
 import { type CachePort, createMemoryCache } from "../ports/cache.js";
 import {
   type ClockPort,
@@ -56,6 +60,7 @@ import {
   type UnitOfWorkPort,
 } from "../ports/index.js";
 import {
+  createRecordingBestEffortWork,
   createRecordingEventBus,
   createRecordingJobDispatcher,
   createTestActivityContext,
@@ -107,6 +112,10 @@ export interface CommonTestPorts<TxPorts = AnyPorts> {
    * Recording event bus.
    */
   eventBus: EventBusPort;
+  /**
+   * Recording non-durable best-effort work.
+   */
+  bestEffortWork: BestEffortWorkPort;
   /**
    * In-memory error reporter.
    */
@@ -193,6 +202,18 @@ export interface TestPortsFixture<
    * Recording event bus port.
    */
   eventBus: EventBusPort;
+  /**
+   * Recording best-effort-work port.
+   */
+  bestEffortWork: BestEffortWorkPort;
+  /**
+   * Work currently waiting in the recording best-effort-work adapter.
+   */
+  pendingBestEffortWork: BestEffortWork[];
+  /**
+   * Run the currently pending best-effort-work batch in FIFO order.
+   */
+  flushBestEffortWork(): Promise<void>;
   /**
    * Recorded events published through `eventBus`.
    */
@@ -380,6 +401,11 @@ export function createTestPorts<
   const audit = createMemoryAuditLog();
   const cache = createMemoryCache();
   const clock = options.clock ?? createFrozenClock();
+  const {
+    bestEffortWork,
+    pending: pendingBestEffortWork,
+    flush: flushBestEffortWork,
+  } = createRecordingBestEffortWork();
   const { bus: eventBus, events } = createRecordingEventBus();
   const errorReporter = createMemoryErrorReporter();
   const flags = createMemoryFlags();
@@ -408,6 +434,7 @@ export function createTestPorts<
     audit: createAmbientAuditLog(audit),
     cache,
     clock,
+    bestEffortWork,
     eventBus,
     errorReporter,
     flags,
@@ -490,6 +517,9 @@ export function createTestPorts<
   return {
     ports,
     audit,
+    bestEffortWork,
+    pendingBestEffortWork,
+    flushBestEffortWork,
     eventBus,
     events,
     errorReporter,

package/dist/query-codec.d.ts

@@ -1,3 +0,0 @@
-export declare function encodeQueryValue(value: unknown): string;
-export declare function decodeQueryValue(value: string): unknown;
-//# sourceMappingURL=query-codec.d.ts.map

package/dist/query-codec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"query-codec.d.ts","sourceRoot":"","sources":["../src/query-codec.ts"],"names":[],"mappings":"AA8GA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOvD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAUvD"}

package/dist/query-codec.js

@@ -1,110 +0,0 @@
-const QUERY_VALUE_PREFIX = "~beignet-query:";
-function encodeStructuredValue(value, ancestors) {
-    if (value === null)
-        return { type: "null" };
-    if (typeof value === "string")
-        return { type: "string", value };
-    if (typeof value === "number" && Number.isFinite(value)) {
-        return { type: "number", value };
-    }
-    if (typeof value === "boolean")
-        return { type: "boolean", value };
-    if (value instanceof Date && Number.isFinite(value.getTime())) {
-        return { type: "date", value: value.toISOString() };
-    }
-    if (typeof value !== "object" || value === null) {
-        throw new TypeError("Query value is not serializable.");
-    }
-    if (ancestors.has(value)) {
-        throw new TypeError("Query value contains a circular reference.");
-    }
-    ancestors.add(value);
-    try {
-        if (Array.isArray(value)) {
-            return {
-                type: "array",
-                value: value.map((entry) => encodeStructuredValue(entry, ancestors)),
-            };
-        }
-        const prototype = Object.getPrototypeOf(value);
-        if (prototype !== Object.prototype && prototype !== null) {
-            throw new TypeError("Query value contains a non-plain object.");
-        }
-        return {
-            type: "object",
-            value: Object.fromEntries(Object.entries(value)
-                .filter(([, entry]) => entry !== undefined)
-                .map(([key, entry]) => [
-                key,
-                encodeStructuredValue(entry, ancestors),
-            ])),
-        };
-    }
-    finally {
-        ancestors.delete(value);
-    }
-}
-function decodeStructuredValue(value) {
-    if (typeof value !== "object" || value === null || !("type" in value)) {
-        throw new TypeError("Invalid encoded query value.");
-    }
-    const encoded = value;
-    switch (encoded.type) {
-        case "null":
-            return null;
-        case "string":
-            if (typeof encoded.value === "string")
-                return encoded.value;
-            break;
-        case "number":
-            if (typeof encoded.value === "number" && Number.isFinite(encoded.value)) {
-                return encoded.value;
-            }
-            break;
-        case "boolean":
-            if (typeof encoded.value === "boolean")
-                return encoded.value;
-            break;
-        case "date": {
-            if (typeof encoded.value !== "string")
-                break;
-            const date = new Date(encoded.value);
-            if (Number.isFinite(date.getTime()))
-                return date;
-            break;
-        }
-        case "array":
-            if (Array.isArray(encoded.value)) {
-                return encoded.value.map(decodeStructuredValue);
-            }
-            break;
-        case "object":
-            if (typeof encoded.value === "object" &&
-                encoded.value !== null &&
-                !Array.isArray(encoded.value)) {
-                return Object.fromEntries(Object.entries(encoded.value).map(([key, entry]) => [
-                    key,
-                    decodeStructuredValue(entry),
-                ]));
-            }
-            break;
-    }
-    throw new TypeError("Invalid encoded query value.");
-}
-export function encodeQueryValue(value) {
-    if (typeof value === "string" && !value.startsWith(QUERY_VALUE_PREFIX)) {
-        return value;
-    }
-    return `${QUERY_VALUE_PREFIX}${JSON.stringify(encodeStructuredValue(value, new Set()))}`;
-}
-export function decodeQueryValue(value) {
-    if (!value.startsWith(QUERY_VALUE_PREFIX))
-        return value;
-    try {
-        return decodeStructuredValue(JSON.parse(value.slice(QUERY_VALUE_PREFIX.length)));
-    }
-    catch {
-        return value;
-    }
-}
-//# sourceMappingURL=query-codec.js.map

package/dist/query-codec.js.map

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

package/src/query-codec.ts

@@ -1,130 +0,0 @@
-const QUERY_VALUE_PREFIX = "~beignet-query:";
-
-type EncodedQueryValue =
-  | { type: "null" }
-  | { type: "string"; value: string }
-  | { type: "number"; value: number }
-  | { type: "boolean"; value: boolean }
-  | { type: "date"; value: string }
-  | { type: "array"; value: EncodedQueryValue[] }
-  | { type: "object"; value: Record<string, EncodedQueryValue> };
-
-function encodeStructuredValue(
-  value: unknown,
-  ancestors: Set<object>,
-): EncodedQueryValue {
-  if (value === null) return { type: "null" };
-  if (typeof value === "string") return { type: "string", value };
-  if (typeof value === "number" && Number.isFinite(value)) {
-    return { type: "number", value };
-  }
-  if (typeof value === "boolean") return { type: "boolean", value };
-  if (value instanceof Date && Number.isFinite(value.getTime())) {
-    return { type: "date", value: value.toISOString() };
-  }
-  if (typeof value !== "object" || value === null) {
-    throw new TypeError("Query value is not serializable.");
-  }
-  if (ancestors.has(value)) {
-    throw new TypeError("Query value contains a circular reference.");
-  }
-
-  ancestors.add(value);
-  try {
-    if (Array.isArray(value)) {
-      return {
-        type: "array",
-        value: value.map((entry) => encodeStructuredValue(entry, ancestors)),
-      };
-    }
-
-    const prototype = Object.getPrototypeOf(value);
-    if (prototype !== Object.prototype && prototype !== null) {
-      throw new TypeError("Query value contains a non-plain object.");
-    }
-    return {
-      type: "object",
-      value: Object.fromEntries(
-        Object.entries(value)
-          .filter(([, entry]) => entry !== undefined)
-          .map(([key, entry]) => [
-            key,
-            encodeStructuredValue(entry, ancestors),
-          ]),
-      ),
-    };
-  } finally {
-    ancestors.delete(value);
-  }
-}
-
-function decodeStructuredValue(value: unknown): unknown {
-  if (typeof value !== "object" || value === null || !("type" in value)) {
-    throw new TypeError("Invalid encoded query value.");
-  }
-  const encoded = value as { type: unknown; value?: unknown };
-
-  switch (encoded.type) {
-    case "null":
-      return null;
-    case "string":
-      if (typeof encoded.value === "string") return encoded.value;
-      break;
-    case "number":
-      if (typeof encoded.value === "number" && Number.isFinite(encoded.value)) {
-        return encoded.value;
-      }
-      break;
-    case "boolean":
-      if (typeof encoded.value === "boolean") return encoded.value;
-      break;
-    case "date": {
-      if (typeof encoded.value !== "string") break;
-      const date = new Date(encoded.value);
-      if (Number.isFinite(date.getTime())) return date;
-      break;
-    }
-    case "array":
-      if (Array.isArray(encoded.value)) {
-        return encoded.value.map(decodeStructuredValue);
-      }
-      break;
-    case "object":
-      if (
-        typeof encoded.value === "object" &&
-        encoded.value !== null &&
-        !Array.isArray(encoded.value)
-      ) {
-        return Object.fromEntries(
-          Object.entries(encoded.value).map(([key, entry]) => [
-            key,
-            decodeStructuredValue(entry),
-          ]),
-        );
-      }
-      break;
-  }
-
-  throw new TypeError("Invalid encoded query value.");
-}
-
-export function encodeQueryValue(value: unknown): string {
-  if (typeof value === "string" && !value.startsWith(QUERY_VALUE_PREFIX)) {
-    return value;
-  }
-  return `${QUERY_VALUE_PREFIX}${JSON.stringify(
-    encodeStructuredValue(value, new Set()),
-  )}`;
-}
-
-export function decodeQueryValue(value: string): unknown {
-  if (!value.startsWith(QUERY_VALUE_PREFIX)) return value;
-
-  try {
-    return decodeStructuredValue(
-      JSON.parse(value.slice(QUERY_VALUE_PREFIX.length)) as unknown,
-    );
-  } catch {
-    return value;
-  }
-}