@clipboard-health/contract-core 2.3.0 → 2.3.2

package/README.md

@@ -96,13 +96,18 @@ try {
 }
 
 // DateTime schema examples
-// Validates strict ISO-8601 datetime strings and transforms to Date objects.
+// Accepts ISO-8601 datetime strings and Date objects, normalizes to Date.
 // Composable with .optional(), .nullable(), etc.
 const createdAt = dateTimeSchema().parse("2026-03-15T10:30:00.000Z");
 // => Date object
 console.log(createdAt instanceof Date); // true
 console.log(createdAt.toISOString()); // "2026-03-15T10:30:00.000Z"
 
+// Date objects pass through as-is
+const fromDate = dateTimeSchema().parse(new Date("2026-03-15T10:30:00.000Z"));
+// => Date object
+console.log(fromDate instanceof Date); // true
+
 try {
   dateTimeSchema().parse("2026-03-15"); // date-only string
 } catch (error) {
@@ -114,7 +119,7 @@ try {
   dateTimeSchema().parse(1_773_340_050_000); // epoch number
 } catch (error) {
   logError(error);
-  // => Expected string, received number
+  // => Invalid union
 }
 
 // Optional usage — compose at the call site

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@clipboard-health/contract-core",
   "description": "Shared Zod schemas for Clipboard's contracts.",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "bugs": "https://github.com/ClipboardHealth/core-utils/issues",
   "dependencies": {
     "tslib": "2.8.1"
   },
   "devDependencies": {
-    "@clipboard-health/testing-core": "2.2.42",
+    "@clipboard-health/testing-core": "2.2.43",
     "zod": "3.25.76"
   },
   "keywords": [

package/src/lib/schemas/dateTime.d.ts

@@ -1,7 +1,12 @@
 import { z } from "zod";
 /**
- * Validates that the input is a strict ISO-8601 datetime string,
- * then transforms it into a Date object.
+ * Validates datetime inputs and normalizes them to Date objects.
+ *
+ * Accepts:
+ * - ISO-8601 datetime strings (validated strictly)
+ * - Date objects (passed through as-is)
+ *
+ * Rejects epoch numbers, date-only strings, and other loose inputs.
  *
  * Composable with `.optional()`, `.nullable()`, etc. at the call site:
  * ```ts
@@ -11,9 +16,7 @@ import { z } from "zod";
  * });
  * ```
  *
- * z.input  → string (what callers send over the wire)
- * z.output → Date   (what callers receive after parsing)
- *
- * Requires `parsedApi.ts` so that schemas are parsed at runtime.
+ * z.input  → string | Date
+ * z.output → Date
  */
-export declare function dateTimeSchema(): z.ZodEffects<z.ZodString, Date, string>;
+export declare function dateTimeSchema(): z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodDate]>, Date, string | Date>;

package/src/lib/schemas/dateTime.js

@@ -3,8 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.dateTimeSchema = dateTimeSchema;
 const zod_1 = require("zod");
 /**
- * Validates that the input is a strict ISO-8601 datetime string,
- * then transforms it into a Date object.
+ * Validates datetime inputs and normalizes them to Date objects.
+ *
+ * Accepts:
+ * - ISO-8601 datetime strings (validated strictly)
+ * - Date objects (passed through as-is)
+ *
+ * Rejects epoch numbers, date-only strings, and other loose inputs.
  *
  * Composable with `.optional()`, `.nullable()`, etc. at the call site:
  * ```ts
@@ -14,15 +19,12 @@ const zod_1 = require("zod");
  * });
  * ```
  *
- * z.input  → string (what callers send over the wire)
- * z.output → Date   (what callers receive after parsing)
- *
- * Requires `parsedApi.ts` so that schemas are parsed at runtime.
+ * z.input  → string | Date
+ * z.output → Date
  */
 function dateTimeSchema() {
     return zod_1.z
-        .string()
-        .datetime()
-        .transform((value) => new Date(value));
+        .union([zod_1.z.string().datetime(), zod_1.z.date()])
+        .transform((value) => (value instanceof Date ? value : new Date(value)));
 }
 //# sourceMappingURL=dateTime.js.map

package/src/lib/schemas/dateTime.js.map

@@ -1 +1 @@
-{"version":3,"file":"dateTime.js","sourceRoot":"","sources":["../../../../../../packages/contract-core/src/lib/schemas/dateTime.ts"],"names":[],"mappings":";;AAmBA,wCAKC;AAxBD,6BAAwB;AAExB;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,cAAc;IAC5B,OAAO,OAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"dateTime.js","sourceRoot":"","sources":["../../../../../../packages/contract-core/src/lib/schemas/dateTime.ts"],"names":[],"mappings":";;AAsBA,wCAIC;AA1BD,6BAAwB;AAExB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,cAAc;IAC5B,OAAO,OAAC;SACL,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAC,CAAC,IAAI,EAAE,CAAC,CAAC;SACxC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC7E,CAAC"}