@clipboard-health/contract-core 3.8.6 → 4.0.0

package/esm/package.json

@@ -0,0 +1,4 @@
+{
+  "type": "module",
+  "sideEffects": false
+}

package/esm/src/index.js

@@ -0,0 +1,2 @@
+export * from "./lib/schemas/index.js";
+//# sourceMappingURL=index.js.map

package/esm/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/contract-core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/esm/src/lib/schemas/apiError.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import { nonEmptyString } from "./nonEmptyString.js";
+/**
+ * @see {@link https://jsonapi.org/format/#error-objects Error Objects}
+ */
+export const apiError = z.object({
+    code: nonEmptyString,
+    detail: z.string().optional(),
+    id: nonEmptyString,
+    status: nonEmptyString,
+    title: z.string().optional(),
+});
+/**
+ * @see {@link https://jsonapi.org/format/#errors Errors}
+ */
+export const apiErrors = z.object({
+    errors: apiError.array().min(0).max(100),
+});
+//# sourceMappingURL=apiError.js.map

package/esm/src/lib/schemas/apiError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiError.js","sourceRoot":"","sources":["../../../../../../../packages/contract-core/src/lib/schemas/apiError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,EAAE,EAAE,cAAc;IAClB,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CACzC,CAAC,CAAC"}

package/esm/src/lib/schemas/booleanString.js

@@ -0,0 +1,12 @@
+import { z } from "zod";
+/**
+ * A Zod schema for use with boolean query parameters since `z.coerce.boolean()` treats any truthy
+ * value as `true`.
+ *
+ * `.transform((value) => value === "true")` causes inference issues in controllers.
+ */
+export const booleanString = z.enum(["true", "false"]);
+export function toBoolean(value) {
+    return value === "true";
+}
+//# sourceMappingURL=booleanString.js.map

package/esm/src/lib/schemas/booleanString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"booleanString.js","sourceRoot":"","sources":["../../../../../../../packages/contract-core/src/lib/schemas/booleanString.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAIvD,MAAM,UAAU,SAAS,CAAC,KAAoB;IAC5C,OAAO,KAAK,KAAK,MAAM,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,28 @@
+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 function commaSeparatedArray(itemSchema) {
+    return z
+        .union([z.string().transform((value) => value.split(",")), z.array(itemSchema)])
+        .pipe(z.array(itemSchema));
+}
+//# sourceMappingURL=commaSeparatedArray.js.map

package/esm/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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,mBAAmB,CAAyB,UAAa;IACvE,OAAO,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;SAC/E,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,27 @@
+import { z } from "zod";
+/**
+ * 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
+ * z.object({
+ *   start: dateTimeSchema(),
+ *   clockIn: dateTimeSchema().optional(),
+ * });
+ * ```
+ *
+ * z.input  → string | Date
+ * z.output → Date
+ */
+export function dateTimeSchema() {
+    return z
+        .union([z.string().datetime({ offset: true }), z.date()])
+        .transform((value) => (value instanceof Date ? value : new Date(value)));
+}
+//# sourceMappingURL=dateTime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dateTime.js","sourceRoot":"","sources":["../../../../../../../packages/contract-core/src/lib/schemas/dateTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;SACxD,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"}

package/esm/src/lib/schemas/enum.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+/**
+ * A business-context-neutral sentinel returned when an enum field
+ * receives a value the consumer does not recognize.
+ */
+export const ENUM_FALLBACK = "UNRECOGNIZED_";
+export function enumWithFallback(values, options = {}) {
+    if (values.includes(ENUM_FALLBACK)) {
+        throw new Error(`Enum values must not include "${ENUM_FALLBACK}". It is appended automatically.`);
+    }
+    const OriginalEnum = z.enum([...values]);
+    const ExpandedEnum = z.enum([...values, ENUM_FALLBACK]);
+    const optional = options.optional ?? false;
+    const schema = optional ? ExpandedEnum.optional() : ExpandedEnum;
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    return z.preprocess((value) => {
+        if (value === undefined) {
+            return optional ? undefined : value;
+        }
+        return OriginalEnum.safeParse(value).success ? value : ENUM_FALLBACK;
+    }, schema);
+}
+export function requiredEnumWithFallback(values) {
+    return enumWithFallback(values, { optional: false });
+}
+export function optionalEnumWithFallback(values) {
+    return enumWithFallback(values, { optional: true });
+}
+export function requiredEnum(values) {
+    return z.enum([...values]);
+}
+export function optionalEnum(values) {
+    return z.enum([...values]).optional();
+}
+//# sourceMappingURL=enum.js.map

package/esm/src/lib/schemas/enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../../../../../../packages/contract-core/src/lib/schemas/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,eAAwB,CAAC;AAqBtD,MAAM,UAAU,gBAAgB,CAC9B,MAAS,EACT,OAAO,GAA2B,EAAE;IAEpC,IAAK,MAA4B,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CACb,iCAAiC,aAAa,kCAAkC,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;IAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;IAEjE,+DAA+D;IAC/D,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE;QAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;QACtC,CAAC;QAED,OAAO,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC;IACvE,CAAC,EAAE,MAAM,CAAC,CAAC;AACb,CAAC;AAED,MAAM,UAAU,wBAAwB,CAA6B,MAAqB;IACxF,OAAO,gBAAgB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAA6B,MAAqB;IACxF,OAAO,gBAAgB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,YAAY,CAA6B,MAAqB;IAC5E,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAqB;IAErB,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,10 @@
+export * from "./apiError.js";
+export * from "./booleanString.js";
+export * from "./commaSeparatedArray.js";
+export * from "./dateTime.js";
+export * from "./enum.js";
+export * from "./money.js";
+export * from "./nonEmptyString.js";
+export * from "./objectId.js";
+export * from "./uuid.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/contract-core/src/lib/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC"}

package/esm/src/lib/schemas/money.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+/**
+ * Currency code that follows the ISO 4217 standard.
+ */
+export const currencyCode = z.enum(["USD"]);
+export const money = z.object({
+    amountInMinorUnits: z.number().int(),
+    currencyCode,
+});
+//# sourceMappingURL=money.js.map

package/esm/src/lib/schemas/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../../../../../../../packages/contract-core/src/lib/schemas/money.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AAE5C,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACpC,YAAY;CACb,CAAC,CAAC"}

package/esm/src/lib/schemas/nonEmptyString.js

@@ -0,0 +1,6 @@
+import { z } from "zod";
+/**
+ * A non-empty string Zod schema.
+ */
+export const nonEmptyString = z.string().min(1);
+//# sourceMappingURL=nonEmptyString.js.map

package/esm/src/lib/schemas/nonEmptyString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonEmptyString.js","sourceRoot":"","sources":["../../../../../../../packages/contract-core/src/lib/schemas/nonEmptyString.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC"}

package/esm/src/lib/schemas/objectId.js

@@ -0,0 +1,6 @@
+import { z } from "zod";
+/**
+ * A MongoDB ObjectId string.
+ */
+export const objectId = z.coerce.string().regex(/^[\dA-Fa-f]{24}$/, "Must be a valid ObjectId");
+//# sourceMappingURL=objectId.js.map

package/esm/src/lib/schemas/objectId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectId.js","sourceRoot":"","sources":["../../../../../../../packages/contract-core/src/lib/schemas/objectId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE,0BAA0B,CAAC,CAAC"}

package/esm/src/lib/schemas/uuid.js

@@ -0,0 +1,6 @@
+import { z } from "zod";
+/**
+ * A UUID string.
+ */
+export const uuid = z.string().uuid();
+//# sourceMappingURL=uuid.js.map

package/esm/src/lib/schemas/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../../../../../../packages/contract-core/src/lib/schemas/uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/contract-core",
-  "version": "3.8.6",
+  "version": "4.0.0",
   "description": "Shared Zod schemas for Clipboard's contracts.",
   "keywords": [
     "contract",
@@ -16,6 +16,7 @@
     "directory": "packages/contract-core"
   },
   "type": "commonjs",
+  "sideEffects": false,
   "main": "./src/index.js",
   "typings": "./src/index.d.ts",
   "publishConfig": {
@@ -25,11 +26,26 @@
     "tslib": "2.8.1"
   },
   "devDependencies": {
-    "@clipboard-health/testing-core": "2.7.6",
+    "@clipboard-health/testing-core": "2.7.8",
     "zod": "3.25.76"
   },
   "peerDependencies": {
     "zod": "^3"
   },
-  "types": "./src/index.d.ts"
+  "types": "./src/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./esm/src/index.js",
+      "require": "./src/index.js",
+      "default": "./src/index.js"
+    },
+    "./*": {
+      "types": "./src/lib/schemas/*.d.ts",
+      "import": "./esm/src/lib/schemas/*.js",
+      "require": "./src/lib/schemas/*.js",
+      "default": "./src/lib/schemas/*.js"
+    }
+  }
 }