@centricare/contract 0.1.1 → 0.1.2

package/README.md

@@ -14,6 +14,8 @@ pnpm add @centricare/contract
 
 ## Usage
 
+Import from the package root (all schemas):
+
 ```ts
 import { userSchema, User } from "@centricare/contract";
 
@@ -27,37 +29,50 @@ if (!result.success) {
 const user: User = result.data;
 ```
 
-## Schemas
+Import from a specific model subpath:
 
-| Schema                | File                            | Description                                                              |
-| --------------------- | ------------------------------- | ------------------------------------------------------------------------ |
-| `timestampSchema`     | `src/commons/timestamp.ts`      | ISO date string                                                          |
-| `apiResponseSchema`   | `src/commons/api-response.ts`   | Standardized API response envelope                                       |
-| `metadataSchema`      | `src/commons/api-response.ts`   | Pagination metadata (total, offset, limit, next, previous)               |
-| `codedConceptSchema`  | `src/commons/coded-concept.ts`  | Coded system value (system, value, display, valid, tags)                 |
-| `settingOptionSchema` | `src/commons/setting-option.ts` | Single setting option item                                               |
-| `userSchema`          | `src/models/user.ts`            | User record (full_name, email, statuses, identifiers, demographic, etc.) |
-| `settingsSchema`      | `src/models/settings.ts`        | Settings / preferences record                                            |
+```ts
+import { departmentSchema, Department } from "@centricare/contract/department";
+```
 
-### Folder structure
+## Folder structure
 
 ```
 src/
-├── commons/          # Shared/primitive schemas (one file per schema)
+├── 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
-│   └── index.ts
-├── models/           # Data entity schemas
-│   ├── user.ts
-│   ├── settings.ts
-│   └── index.ts
-├── index.ts          # Package root export
-└── example.test.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 schemas under `src/models/`. Re-export both from `src/index.ts`.
+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
 
@@ -80,21 +95,26 @@ If you are an AI agent contributing to this package, read [`AGENTS.md`](./AGENTS
 
 ### Without an AI agent
 
-1. **Create a new schema file**
+1. **Create a new model folder**
    - Shared/primitive schema → `src/commons/<name>.ts` (one file per schema, kebab-case)
-   - Data entity schema → `src/models/<name>.ts`
+   - 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 `create` and `update` schemas
+   - 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 "./<name>";` to the appropriate barrel file (`src/commons/index.ts` or `src/models/index.ts`)
-   - The root `src/index.ts` re-exports both, so no change is needed there unless you add a new top-level folder
+   - 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 `src/example.test.ts` for new schemas
+   - 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

@@ -8,19 +8,7 @@ export declare const metadataSchema: z.ZodObject<{
     limit: z.ZodNumber;
     next: z.ZodNullable<z.ZodString>;
     previous: z.ZodNullable<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    offset: number;
-    total: number;
-    limit: number;
-    next: string | null;
-    previous: string | null;
-}, {
-    offset: number;
-    total: number;
-    limit: number;
-    next: string | null;
-    previous: string | null;
-}>;
+}, z.core.$strip>;
 export type Metadata = z.infer<typeof metadataSchema>;
 /**
  * Standardized API response envelope used by CentriCare services.
@@ -44,51 +32,15 @@ export declare const apiResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T)
     success: z.ZodBoolean;
     message: z.ZodString;
     status_code: z.ZodString;
-    data: z.ZodArray<T, "many">;
+    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>;
-    }, "strip", z.ZodTypeAny, {
-        offset: number;
-        total: number;
-        limit: number;
-        next: string | null;
-        previous: string | null;
-    }, {
-        offset: number;
-        total: number;
-        limit: number;
-        next: string | null;
-        previous: string | null;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    success: boolean;
-    status_code: string;
-    data: T["_output"][];
-    metadata: {
-        offset: number;
-        total: number;
-        limit: number;
-        next: string | null;
-        previous: string | null;
-    };
-}, {
-    message: string;
-    success: boolean;
-    status_code: string;
-    data: T["_input"][];
-    metadata: {
-        offset: number;
-        total: number;
-        limit: number;
-        next: string | null;
-        previous: string | null;
-    };
-}>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 export type ApiResponse<T> = {
     success: boolean;
     message: string;
@@ -101,78 +53,18 @@ export type ApiResponse<T> = {
  * 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.ZodEffects<z.ZodObject<{
+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, "many">;
+    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>;
-    }, "strip", z.ZodTypeAny, {
-        offset: number;
-        total: number;
-        limit: number;
-        next: string | null;
-        previous: string | null;
-    }, {
-        offset: number;
-        total: number;
-        limit: number;
-        next: string | null;
-        previous: string | null;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    success: boolean;
-    status_code: string;
-    data: T["_output"][];
-    metadata: {
-        offset: number;
-        total: number;
-        limit: number;
-        next: string | null;
-        previous: string | null;
-    };
-}, {
-    message: string;
-    success: boolean;
-    status_code: string;
-    data: T["_input"][];
-    metadata: {
-        offset: number;
-        total: number;
-        limit: number;
-        next: string | null;
-        previous: string | null;
-    };
-}>, {
-    message: string;
-    success: boolean;
-    status_code: string;
-    data: T["_output"][];
-    metadata: {
-        offset: number;
-        total: number;
-        limit: number;
-        next: string | null;
-        previous: string | null;
-    };
-}, {
-    message: string;
-    success: boolean;
-    status_code: string;
-    data: T["_input"][];
-    metadata: {
-        offset: number;
-        total: number;
-        limit: number;
-        next: string | null;
-        previous: string | null;
-    };
-}>;
+    }, 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

@@ -1 +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;;;;;;;;;;;;;;;;;;EAMzB,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOnE,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaZ,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"}
+{"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/coded-concept.d.ts

@@ -9,20 +9,8 @@ export declare const codedConceptSchema: z.ZodObject<{
     system: z.ZodString;
     value: z.ZodString;
     display: z.ZodOptional<z.ZodString>;
-    valid: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    value: string;
-    system: string;
-    valid?: string | undefined;
-    display?: string | undefined;
-    tags?: string[] | undefined;
-}, {
-    value: string;
-    system: string;
-    valid?: string | undefined;
-    display?: string | undefined;
-    tags?: string[] | undefined;
-}>;
+    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

@@ -1 +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;;;;;;;;;;;;;;;;;;EAa7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"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/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

@@ -6,4 +6,7 @@ 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

@@ -1 +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"}
+{"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

@@ -6,4 +6,7 @@ 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

@@ -1 +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"}
+{"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

@@ -7,7 +7,17 @@ import { z } from "zod";
  * path (e.g. "crn:status:system") for options whose input type is determined
  * by a registry code system.
  */
-export declare const settingOptionTypeSchema: z.ZodUnion<[z.ZodEnum<["string", "number", "boolean", "date"]>, z.ZodArray<z.ZodEnum<["string", "number", "boolean", "date"]>, "many">, z.ZodString]>;
+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.
@@ -17,21 +27,19 @@ export type SettingOptionType = z.infer<typeof settingOptionTypeSchema>;
 export declare const settingOptionSchema: z.ZodObject<{
     field: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
-    type: z.ZodUnion<[z.ZodEnum<["string", "number", "boolean", "date"]>, z.ZodArray<z.ZodEnum<["string", "number", "boolean", "date"]>, "many">, 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<[z.ZodString, z.ZodBoolean, z.ZodNumber]>>;
-}, "strip", z.ZodTypeAny, {
-    value: string | number | boolean | null;
-    type: string | ("string" | "number" | "boolean" | "date")[];
-    field: string;
-    default: string | null;
-    label?: string | undefined;
-}, {
-    value: string | number | boolean | null;
-    type: string | ("string" | "number" | "boolean" | "date")[];
-    field: string;
-    default: string | null;
-    label?: string | undefined;
-}>;
+    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

@@ -1 +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,uJAIlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAM9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"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/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

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

@@ -0,0 +1 @@
+{"version":3,"file":"assignment-minimal.schema.js","sourceRoot":"","sources":["../../../src/models/assignment/assignment-minimal.schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAmB,MAAM,qBAAqB,CAAC;AAExE;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,gBAAgB,CAAC,IAAI,CAAC;IAC3D,GAAG,EAAE,IAAI;IACT,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,IAAI;IAChB,cAAc,EAAE,IAAI;CACrB,CAAC,CAAC"}

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

@@ -0,0 +1,18 @@
+import { z } from "zod";
+/**
+ * Partial assignment schema (based on minimal, all fields optional).
+ */
+export declare const assignmentPartialSchema: z.ZodObject<{
+    type: z.ZodOptional<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.ZodOptional<z.ZodString>;
+    for: z.ZodOptional<z.ZodString>;
+    assigned_to: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+}, z.core.$strip>;
+export type AssignmentPartial = z.infer<typeof assignmentPartialSchema>;
+//# sourceMappingURL=assignment-partial.schema.d.ts.map

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

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

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

@@ -0,0 +1,6 @@
+import { assignmentMinimalSchema } from "./assignment-minimal.schema";
+/**
+ * Partial assignment schema (based on minimal, all fields optional).
+ */
+export const assignmentPartialSchema = assignmentMinimalSchema.partial();
+//# sourceMappingURL=assignment-partial.schema.js.map

package/dist/models/assignment/assignment-partial.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment-partial.schema.js","sourceRoot":"","sources":["../../../src/models/assignment/assignment-partial.schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAA0B,MAAM,6BAA6B,CAAC;AAE9F;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,uBAAuB,CAAC,OAAO,EAAE,CAAC"}