@centricare/contract 0.0.0-stage → 0.1.2

package/README.md

@@ -1,3 +1,120 @@
-# Temporary Holding Version
+# @centricare/contract
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Standardized Zod schemas used across CentriCare projects. This package provides shared validation schemas and inferred TypeScript types for data entities (e.g. User, Settings) and common primitives (e.g. CodedConcept, timestamp, API response envelope), ensuring consistent data shapes and validation rules across all CentriCare services.
+
+## Installation
+
+```bash
+npm install @centricare/contract
+# or
+yarn add @centricare/contract
+# or
+pnpm add @centricare/contract
+```
+
+## Usage
+
+Import from the package root (all schemas):
+
+```ts
+import { userSchema, User } from "@centricare/contract";
+
+// Validate incoming data
+const result = userSchema.safeParse(req.body);
+
+if (!result.success) {
+  return res.status(400).json({ errors: result.error.flatten() });
+}
+
+const user: User = result.data;
+```
+
+Import from a specific model subpath:
+
+```ts
+import { departmentSchema, Department } from "@centricare/contract/department";
+```
+
+## Folder structure
+
+```
+src/
+├── index.ts              # Package root barrel export (@centricare/contract)
+├── commons/              # Shared/primitive schemas (one file per schema)
+│   ├── index.ts
+│   ├── timestamp.ts
+│   ├── api-response.ts
+│   ├── setting-option.ts
+│   ├── coded-concept.ts
+│   ├── address.ts
+│   └── demographic.ts
+└── models/               # Data entity schemas (one folder per model)
+    ├── index.ts
+    ├── user/
+    │   ├── index.ts
+    │   ├── user.schema.ts          # Full schema + User type
+    │   ├── user-minimal.schema.ts  # Omit server-generated fields + UserMinimal type
+    │   ├── user-partial.schema.ts  # Based on minimal, all optional + UserPartial type
+    │   ├── user-settings.schema.ts # Settings schema (if model has settings)
+    │   └── ... (other schemas as needed)
+    ├── settings/
+    │   ├── index.ts
+    │   ├── settings.schema.ts
+    │   ├── settings-minimal.schema.ts
+    │   ├── settings-partial.schema.ts
+    │   └── ...
+    └── ... (one folder per model)
+```
+
+Add new shared schemas under `src/commons/` (one file each) and new entity models under `src/models/<model>/`. Each model folder contains an `index.ts` barrel and the following schema files:
+- `<model>.schema.ts` — Full schema definition
+- `<model>-minimal.schema.ts` — Omits server-generated fields
+- `<model>-partial.schema.ts` — Based on minimal, all fields optional
+- `<model>-settings.schema.ts` — Settings schema (only if model has settings)
+
+Re-export model folders from `src/models/index.ts`.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build to dist/
+npm run build
+
+# Watch for changes during development
+npm run dev
+```
+
+## Contributing
+
+### Using an AI agent
+
+If you are an AI agent contributing to this package, read [`AGENTS.md`](./AGENTS.md) first. It defines the project structure, code conventions, folder layout, Zod error message rules (`message` not `error`), schema/type pairing, create/update patterns, and import guidelines. Follow those conventions strictly so all schemas remain consistent.
+
+### Without an AI agent
+
+1. **Create a new model folder**
+   - Shared/primitive schema → `src/commons/<name>.ts` (one file per schema, kebab-case)
+   - Data entity model → `src/models/<model>/` with the following files:
+     - `<model>.schema.ts` — Full schema definition
+     - `<model>-minimal.schema.ts` — Omits server-generated fields
+     - `<model>-partial.schema.ts` — Based on minimal, all fields optional
+     - `<model>-settings.schema.ts` — Settings schema (if model has settings)
+     - `index.ts` — Barrel export
+
+2. **Follow the code conventions**
+   - Every Zod schema must export an inferred TypeScript type: `export type X = z.infer<typeof xSchema>;`
+   - Use `message` (not `error`) for custom Zod error messages
+   - Use `z.coerce.number()` for query-string parameters
+   - Omit auto-generated fields (`_id`, `id`, `created_at`, `updated_at`, `updated_by`, `schema_version`) from minimal schemas
+   - Use `.nullable()` for fields that can be `null` but must be present; use `.optional()` for fields that may be absent
+
+3. **Register the schema**
+   - Add `export * from "./<model>";` to `src/models/index.ts`
+   - The root `src/index.ts` re-exports `./commons` and `./models`, so no change is needed there
+
+4. **Build and verify**
+   - Run `npm run build` to compile TypeScript to `dist/`
+   - Add validation examples to `EXAMPLES.md` for new schemas

package/dist/commons/address.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+export declare const addressSchema: z.ZodObject<{
+    street: z.ZodString;
+    subdistrict: z.ZodObject<{
+        system: z.ZodString;
+        value: z.ZodString;
+        display: z.ZodOptional<z.ZodString>;
+        valid: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    district: z.ZodObject<{
+        system: z.ZodString;
+        value: z.ZodString;
+        display: z.ZodOptional<z.ZodString>;
+        valid: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    city: z.ZodObject<{
+        system: z.ZodString;
+        value: z.ZodString;
+        display: z.ZodOptional<z.ZodString>;
+        valid: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    province: z.ZodObject<{
+        system: z.ZodString;
+        value: z.ZodString;
+        display: z.ZodOptional<z.ZodString>;
+        valid: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    postal_code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Address = z.infer<typeof addressSchema>;
+//# sourceMappingURL=address.d.ts.map

package/dist/commons/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../src/commons/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOxB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/commons/address.js

@@ -0,0 +1,11 @@
+import { z } from "zod";
+import { codedConceptSchema } from "./coded-concept";
+export const addressSchema = z.object({
+    street: z.string().min(1, { message: "street is required" }),
+    subdistrict: codedConceptSchema,
+    district: codedConceptSchema,
+    city: codedConceptSchema,
+    province: codedConceptSchema,
+    postal_code: z.string().optional(),
+});
+//# sourceMappingURL=address.js.map

package/dist/commons/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../src/commons/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAC5D,WAAW,EAAE,kBAAkB;IAC/B,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,kBAAkB;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC"}

package/dist/commons/api-response.d.ts

@@ -0,0 +1,70 @@
+import { z } from "zod";
+/**
+ * Pagination metadata included in every standardized API response.
+ */
+export declare const metadataSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    offset: z.ZodNumber;
+    limit: z.ZodNumber;
+    next: z.ZodNullable<z.ZodString>;
+    previous: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type Metadata = z.infer<typeof metadataSchema>;
+/**
+ * Standardized API response envelope used by CentriCare services.
+ * Based on /Docs/API/1. Standardized Response.md
+ *
+ * {
+ *   "success": true,
+ *   "message": "Successfully do something",
+ *   "status_code": "200",
+ *   "data": [],
+ *   "metadata": {
+ *     "total": 1,
+ *     "offset": 0,
+ *     "limit": 1,
+ *     "next": null,
+ *     "previous": null
+ *   }
+ * }
+ */
+export declare const apiResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodObject<{
+    success: z.ZodBoolean;
+    message: z.ZodString;
+    status_code: z.ZodString;
+    data: z.ZodArray<T>;
+    metadata: z.ZodObject<{
+        total: z.ZodNumber;
+        offset: z.ZodNumber;
+        limit: z.ZodNumber;
+        next: z.ZodNullable<z.ZodString>;
+        previous: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ApiResponse<T> = {
+    success: boolean;
+    message: string;
+    status_code: string;
+    data: T[];
+    metadata: Metadata;
+};
+/**
+ * Schema for a single-resource API response.
+ * For single-resource requests, metadata.total is always 1,
+ * offset and limit default to 0, and next/previous are null.
+ */
+export declare const singleResourceResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodObject<{
+    success: z.ZodBoolean;
+    message: z.ZodString;
+    status_code: z.ZodString;
+    data: z.ZodArray<T>;
+    metadata: z.ZodObject<{
+        total: z.ZodNumber;
+        offset: z.ZodNumber;
+        limit: z.ZodNumber;
+        next: z.ZodNullable<z.ZodString>;
+        previous: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SingleResourceResponse<T extends z.ZodTypeAny> = z.infer<ReturnType<typeof singleResourceResponseSchema<T>>>;
+//# sourceMappingURL=api-response.d.ts.map

package/dist/commons/api-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-response.d.ts","sourceRoot":"","sources":["../../src/commons/api-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;iBAMzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC;;;;;;;;;;;;iBAOnE,CAAC;AAEL,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GAAI,CAAC,SAAS,CAAC,CAAC,UAAU,EACjE,YAAY,CAAC;;;;;;;;;;;;iBAaZ,CAAC;AAEJ,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,CAClE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,CAAC,CAAC,CACnD,CAAC"}

package/dist/commons/api-response.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+/**
+ * Pagination metadata included in every standardized API response.
+ */
+export const metadataSchema = z.object({
+    total: z.number().int().nonnegative(),
+    offset: z.number().int().nonnegative(),
+    limit: z.number().int().nonnegative(),
+    next: z.string().nullable(),
+    previous: z.string().nullable(),
+});
+/**
+ * Standardized API response envelope used by CentriCare services.
+ * Based on /Docs/API/1. Standardized Response.md
+ *
+ * {
+ *   "success": true,
+ *   "message": "Successfully do something",
+ *   "status_code": "200",
+ *   "data": [],
+ *   "metadata": {
+ *     "total": 1,
+ *     "offset": 0,
+ *     "limit": 1,
+ *     "next": null,
+ *     "previous": null
+ *   }
+ * }
+ */
+export const apiResponseSchema = (dataSchema) => z.object({
+    success: z.boolean(),
+    message: z.string(),
+    status_code: z.string(),
+    data: z.array(dataSchema),
+    metadata: metadataSchema,
+});
+/**
+ * Schema for a single-resource API response.
+ * For single-resource requests, metadata.total is always 1,
+ * offset and limit default to 0, and next/previous are null.
+ */
+export const singleResourceResponseSchema = (dataSchema) => apiResponseSchema(dataSchema).refine((data) => data.metadata.total === 1 &&
+    data.metadata.offset === 0 &&
+    data.metadata.limit === 0 &&
+    data.metadata.next === null &&
+    data.metadata.previous === null, {
+    message: "Single resource response metadata must have total=1, offset=0, limit=0, next=null, previous=null",
+});
+//# sourceMappingURL=api-response.js.map

package/dist/commons/api-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-response.js","sourceRoot":"","sources":["../../src/commons/api-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAIH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAyB,UAAa,EAAE,EAAE,CACzE,CAAC,CAAC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IACzB,QAAQ,EAAE,cAAc;CACzB,CAAC,CAAC;AAUL;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,UAAa,EACb,EAAE,CACF,iBAAiB,CAAC,UAAU,CAAC,CAAC,MAAM,CAClC,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC;IACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;IAC1B,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC;IACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI;IAC3B,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,IAAI,EACjC;IACE,OAAO,EACL,kGAAkG;CACrG,CACF,CAAC"}

package/dist/commons/coded-concept.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+/**
+ * CodedConcept - A data type for coded system values based on a defined code system.
+ * Used across CentriCare models for statuses, identifiers, contacts, demographic fields, etc.
+ *
+ * Accepts only codes and code systems registered in the CentriCare Registry.
+ */
+export declare const codedConceptSchema: z.ZodObject<{
+    system: z.ZodString;
+    value: z.ZodString;
+    display: z.ZodOptional<z.ZodString>;
+    valid: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type CodedConcept = z.infer<typeof codedConceptSchema>;
+//# sourceMappingURL=coded-concept.d.ts.map

package/dist/commons/coded-concept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coded-concept.d.ts","sourceRoot":"","sources":["../../src/commons/coded-concept.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;iBAa7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/commons/coded-concept.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import { timestampSchema } from "./timestamp";
+/**
+ * CodedConcept - A data type for coded system values based on a defined code system.
+ * Used across CentriCare models for statuses, identifiers, contacts, demographic fields, etc.
+ *
+ * Accepts only codes and code systems registered in the CentriCare Registry.
+ */
+export const codedConceptSchema = z.object({
+    system: z.string().min(1, { message: "system is required" }),
+    value: z.string().min(1, { message: "value is required" }),
+    display: z.string().optional(),
+    valid: z
+        .string()
+        .datetime({ offset: true })
+        .optional()
+        .refine((val) => !val || timestampSchema.safeParse(val).success, { message: "valid must be a valid ISO 8601 datetime if provided" }),
+    tags: z.array(z.string()).optional(),
+});
+//# sourceMappingURL=coded-concept.js.map

package/dist/commons/coded-concept.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coded-concept.js","sourceRoot":"","sources":["../../src/commons/coded-concept.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAC5D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC1D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SAC1B,QAAQ,EAAE;SACV,MAAM,CACL,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EACvD,EAAE,OAAO,EAAE,qDAAqD,EAAE,CACnE;IACH,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC"}

package/dist/commons/demographic.d.ts

@@ -0,0 +1,29 @@
+import z from "zod";
+export declare const demographicSchema: z.ZodObject<{
+    sex: z.ZodObject<{
+        system: z.ZodString;
+        value: z.ZodString;
+        display: z.ZodOptional<z.ZodString>;
+        valid: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    religion: z.ZodObject<{
+        system: z.ZodString;
+        value: z.ZodString;
+        display: z.ZodOptional<z.ZodString>;
+        valid: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    ethnicity: z.ZodOptional<z.ZodString>;
+    marital_status: z.ZodObject<{
+        system: z.ZodString;
+        value: z.ZodString;
+        display: z.ZodOptional<z.ZodString>;
+        valid: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    date_of_birth: z.ZodString;
+    place_of_birth: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Demographic = z.infer<typeof demographicSchema>;
+//# sourceMappingURL=demographic.d.ts.map

package/dist/commons/demographic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demographic.d.ts","sourceRoot":"","sources":["../../src/commons/demographic.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAGpB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;iBAO5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/commons/demographic.js

@@ -0,0 +1,11 @@
+import z from "zod";
+import { codedConceptSchema } from "./coded-concept";
+export const demographicSchema = z.object({
+    sex: codedConceptSchema,
+    religion: codedConceptSchema,
+    ethnicity: z.string().optional(),
+    marital_status: codedConceptSchema,
+    date_of_birth: z.string(),
+    place_of_birth: z.string().optional(),
+});
+//# sourceMappingURL=demographic.js.map

package/dist/commons/demographic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demographic.js","sourceRoot":"","sources":["../../src/commons/demographic.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,GAAG,EAAE,kBAAkB;IACvB,QAAQ,EAAE,kBAAkB;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,cAAc,EAAE,kBAAkB;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC"}

package/dist/commons/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared/primitive schemas used across CentriCare projects.
+ * Each schema lives in its own file.
+ */
+export * from "./timestamp";
+export * from "./api-response";
+export * from "./setting-option";
+export * from "./coded-concept";
+export * from "./demographic";
+export * from "./address";
+export * from "./object-id";
+//# sourceMappingURL=index.d.ts.map

package/dist/commons/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commons/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/commons/index.js

@@ -0,0 +1,12 @@
+/**
+ * Shared/primitive schemas used across CentriCare projects.
+ * Each schema lives in its own file.
+ */
+export * from "./timestamp";
+export * from "./api-response";
+export * from "./setting-option";
+export * from "./coded-concept";
+export * from "./demographic";
+export * from "./address";
+export * from "./object-id";
+//# sourceMappingURL=index.js.map

package/dist/commons/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commons/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/commons/object-id.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+/**
+ * ObjectId schema for MongoDB document IDs.
+ * Validates a 24-character hexadecimal string (MongoDB ObjectId format).
+ */
+export declare const objectIdSchema: z.ZodString;
+export type ObjectId = string;
+//# sourceMappingURL=object-id.d.ts.map

package/dist/commons/object-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-id.d.ts","sourceRoot":"","sources":["../../src/commons/object-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,cAAc,aAIzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC"}

package/dist/commons/object-id.js

@@ -0,0 +1,11 @@
+import { z } from "zod";
+/**
+ * ObjectId schema for MongoDB document IDs.
+ * Validates a 24-character hexadecimal string (MongoDB ObjectId format).
+ */
+export const objectIdSchema = z.string().length(24, {
+    message: "ObjectId must be a 24-character hexadecimal string",
+}).regex(/^[0-9a-fA-F]{24}$/, {
+    message: "ObjectId must be a valid MongoDB ObjectId (24-character hex string)",
+});
+//# sourceMappingURL=object-id.js.map

package/dist/commons/object-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-id.js","sourceRoot":"","sources":["../../src/commons/object-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE;IAClD,OAAO,EAAE,oDAAoD;CAC9D,CAAC,CAAC,KAAK,CAAC,mBAAmB,EAAE;IAC5B,OAAO,EAAE,qEAAqE;CAC/E,CAAC,CAAC"}

package/dist/commons/setting-option.d.ts

@@ -0,0 +1,45 @@
+import { z } from "zod";
+/**
+ * The type of a setting option value.
+ *
+ * Accepts "string", "number", "boolean", "date", or an array of those
+ * for options with multiple choices. Also accepts any valid registry system
+ * path (e.g. "crn:status:system") for options whose input type is determined
+ * by a registry code system.
+ */
+export declare const settingOptionTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    string: "string";
+    number: "number";
+    boolean: "boolean";
+    date: "date";
+}>, z.ZodArray<z.ZodEnum<{
+    string: "string";
+    number: "number";
+    boolean: "boolean";
+    date: "date";
+}>>, z.ZodString]>;
+export type SettingOptionType = z.infer<typeof settingOptionTypeSchema>;
+/**
+ * A single setting option item.
+ *
+ * - `default` and `value` can be null but cannot be undefined or missing.
+ */
+export declare const settingOptionSchema: z.ZodObject<{
+    field: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    type: z.ZodUnion<readonly [z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        date: "date";
+    }>, z.ZodArray<z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        date: "date";
+    }>>, z.ZodString]>;
+    default: z.ZodNullable<z.ZodString>;
+    value: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>;
+}, z.core.$strip>;
+export type SettingOption = z.infer<typeof settingOptionSchema>;
+//# sourceMappingURL=setting-option.d.ts.map

package/dist/commons/setting-option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-option.d.ts","sourceRoot":"","sources":["../../src/commons/setting-option.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;kBAIlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;iBAM9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/commons/setting-option.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+/**
+ * The type of a setting option value.
+ *
+ * Accepts "string", "number", "boolean", "date", or an array of those
+ * for options with multiple choices. Also accepts any valid registry system
+ * path (e.g. "crn:status:system") for options whose input type is determined
+ * by a registry code system.
+ */
+export const settingOptionTypeSchema = z.union([
+    z.enum(["string", "number", "boolean", "date"]),
+    z.array(z.enum(["string", "number", "boolean", "date"])),
+    z.string(),
+]);
+/**
+ * A single setting option item.
+ *
+ * - `default` and `value` can be null but cannot be undefined or missing.
+ */
+export const settingOptionSchema = z.object({
+    field: z.string().min(1, { message: "field is required" }),
+    label: z.string().optional(),
+    type: settingOptionTypeSchema,
+    default: z.string().nullable(),
+    value: z.union([z.string(), z.boolean(), z.number()]).nullable(),
+});
+//# sourceMappingURL=setting-option.js.map

package/dist/commons/setting-option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-option.js","sourceRoot":"","sources":["../../src/commons/setting-option.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC;IAC7C,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,MAAM,EAAE;CACX,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CACjE,CAAC,CAAC"}

package/dist/commons/timestamp.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+/**
+ * ISO 8601 timestamp string.
+ */
+export declare const timestampSchema: z.ZodString;
+export type Timestamp = z.infer<typeof timestampSchema>;
+//# sourceMappingURL=timestamp.d.ts.map

package/dist/commons/timestamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp.d.ts","sourceRoot":"","sources":["../../src/commons/timestamp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,eAAe,aAG1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/commons/timestamp.js

@@ -0,0 +1,9 @@
+import { z } from "zod";
+/**
+ * ISO 8601 timestamp string.
+ */
+export const timestampSchema = z.string().datetime({
+    offset: true,
+    message: 'Invalid timestamp: must be an ISO 8601 datetime',
+});
+//# sourceMappingURL=timestamp.js.map

package/dist/commons/timestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp.js","sourceRoot":"","sources":["../../src/commons/timestamp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC;IACjD,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,iDAAiD;CAC3D,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @centricare/contract
+ * Standardized Zod schemas used across CentriCare projects.
+ */
+export * from "./commons";
+export * from "./models";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * @centricare/contract
+ * Standardized Zod schemas used across CentriCare projects.
+ */
+export * from "./commons";
+export * from "./models";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/models/assignment/assignment-minimal.schema.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+/**
+ * Minimal assignment schema (omits server-generated fields).
+ */
+export declare const assignmentMinimalSchema: z.ZodObject<{
+    type: z.ZodObject<{
+        system: z.ZodString;
+        value: z.ZodString;
+        display: z.ZodOptional<z.ZodString>;
+        valid: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    facility_id: z.ZodString;
+    for: z.ZodString;
+    assigned_to: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>;
+}, z.core.$strip>;
+export type AssignmentMinimal = z.infer<typeof assignmentMinimalSchema>;
+//# sourceMappingURL=assignment-minimal.schema.d.ts.map

package/dist/models/assignment/assignment-minimal.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment-minimal.schema.d.ts","sourceRoot":"","sources":["../../../src/models/assignment/assignment-minimal.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;iBAOlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/models/assignment/assignment-minimal.schema.js

@@ -0,0 +1,13 @@
+import { assignmentSchema } from "./assignment.schema";
+/**
+ * Minimal assignment schema (omits server-generated fields).
+ */
+export const assignmentMinimalSchema = assignmentSchema.omit({
+    _id: true,
+    created_at: true,
+    created_by: true,
+    updated_at: true,
+    updated_by: true,
+    schema_version: true,
+});
+//# sourceMappingURL=assignment-minimal.schema.js.map