@clipboard-health/contract-core 3.2.0 → 3.3.1

package/README.md

@@ -19,6 +19,30 @@ npm install @clipboard-health/contract-core
 
 ### Zod schemas
 
+#### Comma-separated array schema
+
+`commaSeparatedArray(itemSchema)` validates comma-separated string or array inputs and normalizes them to typed arrays. Designed for shared contracts where the server receives comma-separated query strings and the client passes typed arrays.
+
+```ts
+// z.input  → string | string[]
+// z.output → string[]
+commaSeparatedArray(nonEmptyString).optional();
+
+// z.input  → string | ("CNA" | "RN" | "LVN")[]
+// z.output → ("CNA" | "RN" | "LVN")[]
+commaSeparatedArray(requiredEnum(["CNA", "RN", "LVN"]));
+
+// z.input  → string | string[]
+// z.output → string[]  (each validated as ObjectId)
+commaSeparatedArray(objectId);
+
+// z.input  → string | (string | Date)[]
+// z.output → Date[]
+commaSeparatedArray(dateTimeSchema());
+```
+
+Composes with all contract-core schemas and enum helpers. Replaces `z.preprocess(splitString, z.array(...))` with proper `z.input` typing (the `splitString` pattern erases input types to `unknown`).
+
 #### DateTime schema
 
 `dateTimeSchema()` validates strict ISO-8601 datetime strings and transforms them to `Date` objects. Unlike `z.coerce.date()`, it rejects loose inputs like epoch numbers and date-only strings. Composable with `.optional()`, `.nullable()`, etc. at the call site.
@@ -58,9 +82,11 @@ requiredEnum(widened); // TS error
 import {
   apiErrors,
   booleanString,
+  commaSeparatedArray,
   dateTimeSchema,
   ENUM_FALLBACK,
   nonEmptyString,
+  objectId,
   optionalEnum,
   optionalEnumWithFallback,
   requiredEnum,
@@ -85,6 +111,35 @@ apiErrors.parse({
   ],
 });
 
+// Comma-separated array examples
+// Designed for shared contracts: server receives "CNA,RN" (string), client passes ["CNA", "RN"] (array).
+// Both normalize to the same typed array output.
+const workerTypes = commaSeparatedArray(requiredEnum(["CNA", "RN", "LVN"]));
+
+// Server-side: comma-separated string from query params
+const fromString = workerTypes.parse("CNA,RN");
+// => ["CNA", "RN"]
+console.log(fromString);
+
+// Client-side: typed array
+const fromArray = workerTypes.parse(["CNA", "LVN"]);
+// => ["CNA", "LVN"]
+console.log(fromArray);
+
+// Composes with other schemas
+const workerIds = commaSeparatedArray(objectId).optional();
+const dates = commaSeparatedArray(dateTimeSchema());
+
+// Works with .optional()
+// eslint-disable-next-line unicorn/no-useless-undefined
+const noIds = workerIds.parse(undefined);
+// => undefined
+console.log(noIds);
+
+const someDates = dates.parse("2026-01-01T00:00:00.000Z,2026-01-02T00:00:00.000Z");
+// => [Date, Date]
+console.log(someDates[0] instanceof Date); // true
+
 booleanString.parse("true");
 
 try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/contract-core",
-  "version": "3.2.0",
+  "version": "3.3.1",
   "description": "Shared Zod schemas for Clipboard's contracts.",
   "keywords": [
     "contract",
@@ -25,7 +25,7 @@
     "tslib": "2.8.1"
   },
   "devDependencies": {
-    "@clipboard-health/testing-core": "2.2.90",
+    "@clipboard-health/testing-core": "2.2.91",
     "zod": "3.25.76"
   },
   "peerDependencies": {

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

@@ -0,0 +1,23 @@
+import { z } from "zod";
+/**
+ * Validates comma-separated string or array inputs and normalizes them to typed arrays.
+ *
+ * Accepts:
+ * - Comma-separated strings (split and validated per item)
+ * - Arrays of items (validated per item)
+ *
+ * Designed for shared contracts where the server receives comma-separated query strings
+ * and the client passes typed arrays.
+ *
+ * Composable with `.optional()`, `.nullable()`, etc. at the call site:
+ * ```ts
+ * z.object({
+ *   workerTypes: commaSeparatedArray(z.string().min(1)).optional(),
+ *   dates: commaSeparatedArray(dateTimeSchema()).optional(),
+ * });
+ * ```
+ *
+ * z.input  → string | T[]  (where T is z.input of the item schema)
+ * z.output → T[]           (where T is z.output of the item schema)
+ */
+export declare function commaSeparatedArray<T extends z.ZodTypeAny>(itemSchema: T): z.ZodPipeline<z.ZodUnion<[z.ZodEffects<z.ZodString, string[], string>, z.ZodArray<T, "many">]>, z.ZodArray<T, "many">>;

package/src/lib/schemas/commaSeparatedArray.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commaSeparatedArray = commaSeparatedArray;
+const zod_1 = require("zod");
+/**
+ * Validates comma-separated string or array inputs and normalizes them to typed arrays.
+ *
+ * Accepts:
+ * - Comma-separated strings (split and validated per item)
+ * - Arrays of items (validated per item)
+ *
+ * Designed for shared contracts where the server receives comma-separated query strings
+ * and the client passes typed arrays.
+ *
+ * Composable with `.optional()`, `.nullable()`, etc. at the call site:
+ * ```ts
+ * z.object({
+ *   workerTypes: commaSeparatedArray(z.string().min(1)).optional(),
+ *   dates: commaSeparatedArray(dateTimeSchema()).optional(),
+ * });
+ * ```
+ *
+ * z.input  → string | T[]  (where T is z.input of the item schema)
+ * z.output → T[]           (where T is z.output of the item schema)
+ */
+function commaSeparatedArray(itemSchema) {
+    return zod_1.z
+        .union([zod_1.z.string().transform((value) => value.split(",")), zod_1.z.array(itemSchema)])
+        .pipe(zod_1.z.array(itemSchema));
+}
+//# sourceMappingURL=commaSeparatedArray.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commaSeparatedArray.js","sourceRoot":"","sources":["../../../../../../packages/contract-core/src/lib/schemas/commaSeparatedArray.ts"],"names":[],"mappings":";;AAuBA,kDAIC;AA3BD,6BAAwB;AAExB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,mBAAmB,CAAyB,UAAa;IACvE,OAAO,OAAC;SACL,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,OAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;SAC/E,IAAI,CAAC,OAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;AAC/B,CAAC"}

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

@@ -1,5 +1,6 @@
 export * from "./apiError";
 export * from "./booleanString";
+export * from "./commaSeparatedArray";
 export * from "./dateTime";
 export * from "./enum";
 export * from "./money";

package/src/lib/schemas/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./apiError"), exports);
 tslib_1.__exportStar(require("./booleanString"), exports);
+tslib_1.__exportStar(require("./commaSeparatedArray"), exports);
 tslib_1.__exportStar(require("./dateTime"), exports);
 tslib_1.__exportStar(require("./enum"), exports);
 tslib_1.__exportStar(require("./money"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/contract-core/src/lib/schemas/index.ts"],"names":[],"mappings":";;;AAAA,qDAA2B;AAC3B,0DAAgC;AAChC,qDAA2B;AAC3B,iDAAuB;AACvB,kDAAwB;AACxB,2DAAiC;AACjC,qDAA2B;AAC3B,iDAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/contract-core/src/lib/schemas/index.ts"],"names":[],"mappings":";;;AAAA,qDAA2B;AAC3B,0DAAgC;AAChC,gEAAsC;AACtC,qDAA2B;AAC3B,iDAAuB;AACvB,kDAAwB;AACxB,2DAAiC;AACjC,qDAA2B;AAC3B,iDAAuB"}