@beignet/core 0.0.49 → 0.0.51

package/src/idempotency/index.ts

@@ -451,6 +451,17 @@ type CanonicalValue =
   | readonly CanonicalValue[]
   | { readonly [key: string]: CanonicalValue };
 
+const CANONICAL_TYPE_KEY = "$beignet:idempotency-type";
+
+function canonicalType(
+  type: "bigint" | "date" | "negative-zero" | "omitted",
+  value?: string,
+): CanonicalValue {
+  return {
+    [CANONICAL_TYPE_KEY]: value === undefined ? [type] : [type, value],
+  };
+}
+
 type MemoryRecord = MemoryIdempotencyEntry & {
   replayTtlSec?: number;
 };
@@ -875,11 +886,15 @@ function canonicalize(
     return undefined;
   }
 
-  if (
-    value === null ||
-    typeof value === "string" ||
-    typeof value === "boolean"
-  ) {
+  if (value === null) {
+    return null;
+  }
+
+  if (typeof value === "string") {
+    return value;
+  }
+
+  if (typeof value === "boolean") {
     return value;
   }
 
@@ -889,25 +904,54 @@ function canonicalize(
         "Cannot fingerprint non-finite numeric values.",
       );
     }
-    return value;
+    return Object.is(value, -0) ? canonicalType("negative-zero") : value;
   }
 
   if (typeof value === "bigint") {
-    return value.toString();
+    return canonicalType("bigint", value.toString());
   }
 
   if (value instanceof Date) {
-    return value.toISOString();
+    if (!Number.isFinite(value.getTime())) {
+      throw new IdempotencyFingerprintError(
+        "Cannot fingerprint an invalid Date value.",
+      );
+    }
+    return canonicalType("date", value.toISOString());
   }
 
   if (Array.isArray(value)) {
-    return value.map(
-      (item, index) =>
-        canonicalize(item, options, [...path, String(index)], seen) ?? null,
-    );
+    if (seen.has(value)) {
+      throw new IdempotencyFingerprintError(
+        "Cannot fingerprint circular values.",
+      );
+    }
+    seen.add(value);
+    const result: CanonicalValue = Array.from(value, (item, index) => {
+      const nestedValue = canonicalize(
+        item,
+        options,
+        [...path, String(index)],
+        seen,
+      );
+      return nestedValue === undefined ? canonicalType("omitted") : nestedValue;
+    });
+    seen.delete(value);
+    return result;
   }
 
   if (typeof value === "object") {
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== null && prototype !== Object.prototype) {
+      throw new IdempotencyFingerprintError(
+        "Cannot fingerprint unsupported object values. Use plain objects, arrays, Dates, and JSON primitives.",
+      );
+    }
+    if (Object.hasOwn(value, CANONICAL_TYPE_KEY)) {
+      throw new IdempotencyFingerprintError(
+        `Cannot fingerprint an object containing the reserved key "${CANONICAL_TYPE_KEY}".`,
+      );
+    }
     if (seen.has(value)) {
       throw new IdempotencyFingerprintError(
         "Cannot fingerprint circular values.",
@@ -915,7 +959,7 @@ function canonicalize(
     }
     seen.add(value);
 
-    const result: Record<string, CanonicalValue> = {};
+    const result: Record<string, CanonicalValue> = Object.create(null);
     for (const key of Object.keys(value as Record<string, unknown>).sort()) {
       const nestedValue = canonicalize(
         (value as Record<string, unknown>)[key],
@@ -946,9 +990,13 @@ function bytesToHex(bytes: ArrayBuffer): string {
 /**
  * Create a SHA-256 fingerprint from a canonicalized value.
  *
- * Object keys are sorted, `undefined` and functions are omitted, `Date` values
- * become ISO strings, BigInts become strings, and circular or non-finite values
- * throw. Exact omit paths may be supplied as dotted strings or string arrays.
+ * Object keys are sorted, while non-JSON values carry reserved type tags so
+ * BigInts and Dates cannot collide with same-looking strings. Ordinary JSON
+ * inputs retain their existing canonical representation. `undefined` values
+ * and functions are omitted from objects and represented as omitted array
+ * positions. Circular or unsupported object values, reserved tag keys,
+ * invalid dates, and non-finite numbers throw. Exact omit paths may be supplied
+ * as dotted strings or string arrays.
  */
 export async function createIdempotencyFingerprint(
   value: unknown,
@@ -961,7 +1009,7 @@ export async function createIdempotencyFingerprint(
   }
 
   const canonical = canonicalize(value, options, [], new WeakSet());
-  const json = JSON.stringify(canonical ?? null);
+  const json = JSON.stringify(canonical ?? canonicalType("omitted"));
   const digest = await globalThis.crypto.subtle.digest(
     "SHA-256",
     new TextEncoder().encode(json),

package/src/locks/index.ts

@@ -285,10 +285,6 @@ export function createMemoryLocksProvider(
 
   return createProvider({
     name,
-    metadata: {
-      ports: ["locks"],
-      watchers: ["locks"],
-    },
     setup({ ports }) {
       const instrumentation = createProviderInstrumentation(ports, {
         providerName: name,

package/src/mail/index.ts

@@ -403,13 +403,17 @@ export function createMemoryMailerProvider(
           onSend,
         },
         (delivery, durationMs) => {
+          const recipientCount =
+            delivery.message.to.length +
+            (delivery.message.cc?.length ?? 0) +
+            (delivery.message.bcc?.length ?? 0);
           instrumentation.custom({
             name: "mail.sent",
             label: "Mail sent",
-            summary: delivery.message.subject,
+            summary: "Mail sent",
             details: {
-              to: delivery.message.to,
-              subject: delivery.message.subject,
+              provider: "memory",
+              recipientCount,
               id: delivery.id,
               durationMs,
             },