@kernhq/module-inventory 0.2.0 → 0.3.0

package/dist/contract/models.d.ts

@@ -14,6 +14,12 @@ export declare const MODULE_ID = "inventory";
  *
  * Stored rather than derived, because every list filter asks for it — and kept in step inside the
  * same transaction that writes the row it derives from, never by a job afterwards.
+ *
+ * **`under_repair` belongs to the `repairs` capability**, so a workspace with that switch off never
+ * has an asset in it: the procedure that ends a repair answers 404 there, and a status nothing can
+ * move an item out of is a register the workspace cannot correct. The one thing a job does here is
+ * bring the rows *nobody touches* back into step after that switch moves, in both directions —
+ * `deriveStatus` in `src/server/services/status.ts` argues it, and nothing is destroyed either way.
  */
 export declare const AssetStatus: z.ZodEnum<{
     in_stock: "in_stock";
@@ -33,6 +39,76 @@ export type AssetStatus = z.infer<typeof AssetStatus>;
  */
 export declare const CustomValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 export type CustomValues = z.infer<typeof CustomValues>;
+/**
+ * A workspace's own grouping of what it owns — Laptops, Furniture, Cameras.
+ *
+ * Archived rather than deleted, and `archivedAt` is the whole reason: `assets.category_id` is a
+ * plain uuid with no foreign key, so a deleted category leaves every asset filed under it pointing
+ * at a row that is not there. The list column goes blank and the timeline entry that recorded the
+ * move loses the name it recorded. Archiving takes it out of every picker and every filter and
+ * leaves each asset able to say what it is.
+ */
+export declare const Category: z.ZodObject<{
+    id: z.ZodUUID;
+    workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+    name: z.ZodString;
+    order: z.ZodNumber;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    archivedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type Category = z.infer<typeof Category>;
+export declare const CategoryInput: z.ZodObject<{
+    name: z.ZodString;
+    order: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type CategoryInput = z.infer<typeof CategoryInput>;
+/**
+ * One stretch of time during which one person held one asset.
+ *
+ * Effective-dated, exactly as HR keeps employments: nothing is ever updated in place, a change
+ * closes the open row and inserts a new one. `effectiveTo === null` means "still holding it", and
+ * `inventory_custody_no_overlap` — a GiST exclusion constraint on
+ * `(asset_id =, tstzrange(effective_from, effective_to, '[)') &&)` — makes two of those for one
+ * asset impossible in the database rather than merely unlikely in the service.
+ */
+export declare const CustodyPeriod: z.ZodObject<{
+    id: z.ZodUUID;
+    workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+    assetId: z.ZodUUID;
+    userId: z.ZodUUID;
+    note: z.ZodNullable<z.ZodString>;
+    effectiveFrom: z.ZodString;
+    effectiveTo: z.ZodNullable<z.ZodString>;
+    createdBy: z.ZodNullable<z.ZodUUID>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type CustodyPeriod = z.infer<typeof CustodyPeriod>;
+/**
+ * One entry in an asset's timeline.
+ *
+ * `action` is a **plain string, deliberately not an enum**. The rows are append-only and outlive
+ * the image that wrote them: an instance rolled back to a previous release would fail to parse its
+ * own history the moment a newer image had written an action the older enum does not list — a
+ * timeline that 500s rather than one that says a little less. The client renders a sentence per
+ * action it knows and a neutral one for anything else. What is written today is `created`,
+ * `updated`, `assigned`, `transferred`, `returned`, `retired`, `restored`, `repair_logged`,
+ * `repair_completed`, `attachment_added` and `attachment_removed`.
+ */
+export declare const AssetHistoryEntry: z.ZodObject<{
+    id: z.ZodUUID;
+    assetId: z.ZodUUID;
+    actorId: z.ZodNullable<z.ZodUUID>;
+    action: z.ZodString;
+    changes: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        from: z.ZodUnknown;
+        to: z.ZodUnknown;
+    }, z.core.$strip>>;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    occurredAt: z.ZodString;
+}, z.core.$strip>;
+export type AssetHistoryEntry = z.infer<typeof AssetHistoryEntry>;
 export declare const Asset: z.ZodObject<{
     id: z.ZodUUID;
     workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
@@ -64,6 +140,252 @@ export declare const Asset: z.ZodObject<{
     archivedAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type Asset = z.infer<typeof Asset>;
+/**
+ * What a custody procedure answers with: the asset as it now stands, and the period this call
+ * opened.
+ *
+ * Both, because a screen needs both and fetching the asset again afterwards is a second round trip
+ * that can read a row somebody else has changed in between — the panel would then show a handover
+ * that has already been undone. `period` is null on a return: something closed, nothing opened.
+ */
+export declare const CustodyResult: z.ZodObject<{
+    asset: z.ZodObject<{
+        id: z.ZodUUID;
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        code: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        categoryId: z.ZodNullable<z.ZodUUID>;
+        status: z.ZodEnum<{
+            in_stock: "in_stock";
+            assigned: "assigned";
+            reserved: "reserved";
+            under_repair: "under_repair";
+            lost: "lost";
+            retired: "retired";
+        }>;
+        custodianUserId: z.ZodNullable<z.ZodUUID>;
+        custodySince: z.ZodNullable<z.ZodString>;
+        serialNumber: z.ZodNullable<z.ZodString>;
+        location: z.ZodNullable<z.ZodString>;
+        purchasedOn: z.ZodNullable<z.ZodString>;
+        purchasedFrom: z.ZodNullable<z.ZodString>;
+        priceMinor: z.ZodNullable<z.ZodNumber>;
+        currency: z.ZodNullable<z.ZodString>;
+        warrantyUntil: z.ZodNullable<z.ZodString>;
+        photoFileId: z.ZodNullable<z.ZodUUID>;
+        custom: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        archivedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    period: z.ZodNullable<z.ZodObject<{
+        id: z.ZodUUID;
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        assetId: z.ZodUUID;
+        userId: z.ZodUUID;
+        note: z.ZodNullable<z.ZodString>;
+        effectiveFrom: z.ZodString;
+        effectiveTo: z.ZodNullable<z.ZodString>;
+        createdBy: z.ZodNullable<z.ZodUUID>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CustodyResult = z.infer<typeof CustodyResult>;
+/**
+ * One trip an item made to a repairer.
+ *
+ * `returnedOn === null` means it is still away, and that single fact is what puts the asset in
+ * `under_repair` — see `deriveStatus` in `src/server/services/status.ts`, which is the only place
+ * the three columns that drive a status are read together.
+ *
+ * **A repair is not custody, and neither one cancels the other.** A laptop assigned to Dan that goes
+ * to the repairer is still Dan's responsibility: the custody period stays open, `custodianUserId`
+ * stays set, and only `status` moves. That is why a repair does not touch custody and custody does
+ * not refuse a repaired item — the two answer different questions ("who is answerable for it" and
+ * "where is it"), and collapsing them would mean an item could not come back to the person who sent
+ * it.
+ */
+export declare const Repair: z.ZodObject<{
+    id: z.ZodUUID;
+    workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+    assetId: z.ZodUUID;
+    summary: z.ZodString;
+    detail: z.ZodNullable<z.ZodString>;
+    vendor: z.ZodNullable<z.ZodString>;
+    costMinor: z.ZodNullable<z.ZodNumber>;
+    currency: z.ZodNullable<z.ZodString>;
+    sentOn: z.ZodString;
+    returnedOn: z.ZodNullable<z.ZodString>;
+    createdBy: z.ZodNullable<z.ZodUUID>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type Repair = z.infer<typeof Repair>;
+/**
+ * A repair in a list, with the two things a reader needs to know *which item* it is about.
+ *
+ * **Joined at read time, never stored here.** `mod_inventory.repairs` holds no asset name, so
+ * renaming an asset renames it everywhere at once — a copied label is a label that goes stale, and
+ * this module already refuses to copy a person's name for the same reason. The join is inside one
+ * schema, which is the kind a module is allowed to make; the kind it is not is a join across the
+ * boundary into another module's tables.
+ *
+ * It extends `Repair` rather than replacing it, so a component that renders a repair renders one of
+ * these without knowing the difference. `create`, `update` and `complete` answer with a plain
+ * `Repair`: the caller of those already knows which asset it asked about.
+ */
+export declare const RepairListItem: z.ZodObject<{
+    id: z.ZodUUID;
+    workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+    assetId: z.ZodUUID;
+    summary: z.ZodString;
+    detail: z.ZodNullable<z.ZodString>;
+    vendor: z.ZodNullable<z.ZodString>;
+    costMinor: z.ZodNullable<z.ZodNumber>;
+    currency: z.ZodNullable<z.ZodString>;
+    sentOn: z.ZodString;
+    returnedOn: z.ZodNullable<z.ZodString>;
+    createdBy: z.ZodNullable<z.ZodUUID>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    assetCode: z.ZodString;
+    assetName: z.ZodString;
+}, z.core.$strip>;
+export type RepairListItem = z.infer<typeof RepairListItem>;
+/**
+ * Everything a person can say about a repair.
+ *
+ * **No field here carries `.default()`, for the reason `AssetInput` spells out**: `update` is built
+ * from `.partial()`, and `.partial()` does not strip a default — zod still substitutes it for a key
+ * the request never sent, so a patch that renames a repair would silently re-date it. `sentOn` is
+ * optional rather than defaulted for the same reason; `repairs.create` fills today's date on the
+ * server, which is the only clock this module trusts.
+ */
+export declare const RepairInput: z.ZodObject<{
+    summary: z.ZodString;
+    detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    vendor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    costMinor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sentOn: z.ZodOptional<z.ZodISODate>;
+}, z.core.$strip>;
+export type RepairInput = z.infer<typeof RepairInput>;
+export declare const RepairPatchInput: z.ZodObject<{
+    summary: z.ZodOptional<z.ZodString>;
+    detail: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    vendor: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    costMinor: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    currency: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    sentOn: z.ZodOptional<z.ZodOptional<z.ZodISODate>>;
+}, z.core.$strip>;
+export type RepairPatchInput = z.infer<typeof RepairPatchInput>;
+/**
+ * What a repair mutation answers with: the repair, and the asset as it now stands.
+ *
+ * Both, for the reason `CustodyResult` carries both — sending an item away moves `assets.status`,
+ * and a screen that had to fetch the asset again afterwards would be reading a row somebody else
+ * may have changed in between.
+ */
+export declare const RepairResult: z.ZodObject<{
+    repair: z.ZodObject<{
+        id: z.ZodUUID;
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        assetId: z.ZodUUID;
+        summary: z.ZodString;
+        detail: z.ZodNullable<z.ZodString>;
+        vendor: z.ZodNullable<z.ZodString>;
+        costMinor: z.ZodNullable<z.ZodNumber>;
+        currency: z.ZodNullable<z.ZodString>;
+        sentOn: z.ZodString;
+        returnedOn: z.ZodNullable<z.ZodString>;
+        createdBy: z.ZodNullable<z.ZodUUID>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    asset: z.ZodObject<{
+        id: z.ZodUUID;
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        code: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        categoryId: z.ZodNullable<z.ZodUUID>;
+        status: z.ZodEnum<{
+            in_stock: "in_stock";
+            assigned: "assigned";
+            reserved: "reserved";
+            under_repair: "under_repair";
+            lost: "lost";
+            retired: "retired";
+        }>;
+        custodianUserId: z.ZodNullable<z.ZodUUID>;
+        custodySince: z.ZodNullable<z.ZodString>;
+        serialNumber: z.ZodNullable<z.ZodString>;
+        location: z.ZodNullable<z.ZodString>;
+        purchasedOn: z.ZodNullable<z.ZodString>;
+        purchasedFrom: z.ZodNullable<z.ZodString>;
+        priceMinor: z.ZodNullable<z.ZodNumber>;
+        currency: z.ZodNullable<z.ZodString>;
+        warrantyUntil: z.ZodNullable<z.ZodString>;
+        photoFileId: z.ZodNullable<z.ZodUUID>;
+        custom: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        archivedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type RepairResult = z.infer<typeof RepairResult>;
+/**
+ * A file recorded against an asset — a receipt, a warranty card, a manual.
+ *
+ * **The bytes are core's, not this module's.** A module does not upload: the browser uploads through
+ * core's file service and hands this module the id it was given, and reading one back is a download
+ * URL core signs. All that lives here is the fact that this asset has that file, plus the name and
+ * size copied at attach time so a list can be drawn without asking core once per row.
+ *
+ * `repairId` is what separates "the invoice for the screen replacement" from "the purchase receipt":
+ * null means it belongs to the asset itself.
+ */
+export declare const Attachment: z.ZodObject<{
+    id: z.ZodUUID;
+    workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+    assetId: z.ZodUUID;
+    repairId: z.ZodNullable<z.ZodUUID>;
+    fileId: z.ZodUUID;
+    name: z.ZodString;
+    mimeType: z.ZodNullable<z.ZodString>;
+    size: z.ZodNullable<z.ZodNumber>;
+    uploadedBy: z.ZodNullable<z.ZodUUID>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type Attachment = z.infer<typeof Attachment>;
+/**
+ * The register in numbers: what a page's count line and a dashboard card need in one request.
+ *
+ * `total` counts what the list shows by default — live rows — and `archived` is beside it rather
+ * than inside it, because a count line that silently included archived rows would disagree with the
+ * list under it.
+ *
+ * **`outForRepair` is null when the workspace does not track repairs.** Zero would be a claim
+ * ("nothing is away"), and a workspace with the `repairs` capability off has not made that claim —
+ * it has no opinion at all. The screens show the tile only when a number arrives, which is the same
+ * rule as hiding the Repairs tab, expressed in the data instead of in a second capability lookup.
+ */
+export declare const InventoryStats: z.ZodObject<{
+    total: z.ZodNumber;
+    archived: z.ZodNumber;
+    byStatus: z.ZodRecord<z.ZodEnum<{
+        in_stock: "in_stock";
+        assigned: "assigned";
+        reserved: "reserved";
+        under_repair: "under_repair";
+        lost: "lost";
+        retired: "retired";
+    }>, z.ZodNumber>;
+    outForRepair: z.ZodNullable<z.ZodNumber>;
+    unassigned: z.ZodNumber;
+}, z.core.$strip>;
+export type InventoryStats = z.infer<typeof InventoryStats>;
 /**
  * How a list is ordered, and therefore what a page cursor is a bookmark *into*.
  *

package/dist/contract/models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/contract/models.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AAEH,wGAAwG;AACxG,eAAO,MAAM,SAAS,cAAc,CAAA;AAEpC;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;;;;;;EAAkF,CAAA;AAC1G,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,wCAAoC,CAAA;AAC7D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEvD,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4BhB,CAAA;AACF,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAA;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;;;;EAAqC,CAAA;AAC3D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA;AAEjD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;iBAerB,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;iBAE3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D,6FAA6F;AAC7F,eAAO,MAAM,eAAe;;;;;;;;;;;;iBAAuB,CAAA;AACnD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D,wEAAwE;AACxE,eAAO,MAAM,EAAE;;iBAAyC,CAAA"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/contract/models.ts"],"names":[],"mappings":"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"}

package/dist/contract/models.js

@@ -15,6 +15,12 @@ export const MODULE_ID = 'inventory';
  *
  * Stored rather than derived, because every list filter asks for it — and kept in step inside the
  * same transaction that writes the row it derives from, never by a job afterwards.
+ *
+ * **`under_repair` belongs to the `repairs` capability**, so a workspace with that switch off never
+ * has an asset in it: the procedure that ends a repair answers 404 there, and a status nothing can
+ * move an item out of is a register the workspace cannot correct. The one thing a job does here is
+ * bring the rows *nobody touches* back into step after that switch moves, in both directions —
+ * `deriveStatus` in `src/server/services/status.ts` argues it, and nothing is destroyed either way.
  */
 export const AssetStatus = z.enum(['in_stock', 'assigned', 'reserved', 'under_repair', 'lost', 'retired']);
 /**
@@ -25,6 +31,78 @@ export const AssetStatus = z.enum(['in_stock', 'assigned', 'reserved', 'under_re
  * it against `field_defs` before writing.
  */
 export const CustomValues = z.record(z.string(), z.unknown());
+/**
+ * A workspace's own grouping of what it owns — Laptops, Furniture, Cameras.
+ *
+ * Archived rather than deleted, and `archivedAt` is the whole reason: `assets.category_id` is a
+ * plain uuid with no foreign key, so a deleted category leaves every asset filed under it pointing
+ * at a row that is not there. The list column goes blank and the timeline entry that recorded the
+ * move loses the name it recorded. Archiving takes it out of every picker and every filter and
+ * leaves each asset able to say what it is.
+ */
+export const Category = z.object({
+    id: z.uuid(),
+    workspaceId: WorkspaceId,
+    name: z.string().min(1).max(120),
+    /** Where it sits in a picker. Equal orders fall back to the name, so a workspace that never
+     *  reorders anything still gets an alphabetical list rather than an arbitrary one. */
+    order: z.number().int(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    archivedAt: z.string().nullable(),
+});
+export const CategoryInput = z.object({
+    name: z.string().trim().min(1).max(120),
+    order: z.number().int().min(0).max(9999).optional(),
+});
+/**
+ * One stretch of time during which one person held one asset.
+ *
+ * Effective-dated, exactly as HR keeps employments: nothing is ever updated in place, a change
+ * closes the open row and inserts a new one. `effectiveTo === null` means "still holding it", and
+ * `inventory_custody_no_overlap` — a GiST exclusion constraint on
+ * `(asset_id =, tstzrange(effective_from, effective_to, '[)') &&)` — makes two of those for one
+ * asset impossible in the database rather than merely unlikely in the service.
+ */
+export const CustodyPeriod = z.object({
+    id: z.uuid(),
+    workspaceId: WorkspaceId,
+    assetId: z.uuid(),
+    /**
+     * The member who held it. A plain uuid — a cross-schema foreign key is what the module boundary
+     * exists to prevent — resolved against core membership at read time, which is also why a person
+     * who has since left the workspace still has readable history.
+     */
+    userId: z.uuid(),
+    note: z.string().max(500).nullable(),
+    effectiveFrom: z.string(),
+    effectiveTo: z.string().nullable(),
+    /** Who did the handing over, which is not always who received it. */
+    createdBy: z.uuid().nullable(),
+    createdAt: z.string(),
+});
+/**
+ * One entry in an asset's timeline.
+ *
+ * `action` is a **plain string, deliberately not an enum**. The rows are append-only and outlive
+ * the image that wrote them: an instance rolled back to a previous release would fail to parse its
+ * own history the moment a newer image had written an action the older enum does not list — a
+ * timeline that 500s rather than one that says a little less. The client renders a sentence per
+ * action it knows and a neutral one for anything else. What is written today is `created`,
+ * `updated`, `assigned`, `transferred`, `returned`, `retired`, `restored`, `repair_logged`,
+ * `repair_completed`, `attachment_added` and `attachment_removed`.
+ */
+export const AssetHistoryEntry = z.object({
+    id: z.uuid(),
+    assetId: z.uuid(),
+    /** Null for anything the platform did rather than a person. */
+    actorId: z.uuid().nullable(),
+    action: z.string().max(40),
+    changes: z.array(z.object({ field: z.string(), from: z.unknown(), to: z.unknown() })),
+    /** Action-specific ids — who received an item, who handed it over. Never a row. */
+    data: z.record(z.string(), z.unknown()),
+    occurredAt: z.string(),
+});
 export const Asset = z.object({
     id: z.uuid(),
     workspaceId: WorkspaceId,
@@ -54,6 +132,141 @@ export const Asset = z.object({
     updatedAt: z.string(),
     archivedAt: z.string().nullable(),
 });
+/**
+ * What a custody procedure answers with: the asset as it now stands, and the period this call
+ * opened.
+ *
+ * Both, because a screen needs both and fetching the asset again afterwards is a second round trip
+ * that can read a row somebody else has changed in between — the panel would then show a handover
+ * that has already been undone. `period` is null on a return: something closed, nothing opened.
+ */
+export const CustodyResult = z.object({
+    asset: Asset,
+    period: CustodyPeriod.nullable(),
+});
+/**
+ * One trip an item made to a repairer.
+ *
+ * `returnedOn === null` means it is still away, and that single fact is what puts the asset in
+ * `under_repair` — see `deriveStatus` in `src/server/services/status.ts`, which is the only place
+ * the three columns that drive a status are read together.
+ *
+ * **A repair is not custody, and neither one cancels the other.** A laptop assigned to Dan that goes
+ * to the repairer is still Dan's responsibility: the custody period stays open, `custodianUserId`
+ * stays set, and only `status` moves. That is why a repair does not touch custody and custody does
+ * not refuse a repaired item — the two answer different questions ("who is answerable for it" and
+ * "where is it"), and collapsing them would mean an item could not come back to the person who sent
+ * it.
+ */
+export const Repair = z.object({
+    id: z.uuid(),
+    workspaceId: WorkspaceId,
+    assetId: z.uuid(),
+    summary: z.string().min(1).max(200),
+    detail: z.string().max(4000).nullable(),
+    vendor: z.string().max(200).nullable(),
+    /** Minor units, like `Asset.priceMinor` — one convention for money across the module. */
+    costMinor: z.number().int().nullable(),
+    currency: z.string().length(3).nullable(),
+    sentOn: z.string(),
+    /** Null while it is still away. Set by `repairs.complete` and by nothing else. */
+    returnedOn: z.string().nullable(),
+    createdBy: z.uuid().nullable(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+/**
+ * A repair in a list, with the two things a reader needs to know *which item* it is about.
+ *
+ * **Joined at read time, never stored here.** `mod_inventory.repairs` holds no asset name, so
+ * renaming an asset renames it everywhere at once — a copied label is a label that goes stale, and
+ * this module already refuses to copy a person's name for the same reason. The join is inside one
+ * schema, which is the kind a module is allowed to make; the kind it is not is a join across the
+ * boundary into another module's tables.
+ *
+ * It extends `Repair` rather than replacing it, so a component that renders a repair renders one of
+ * these without knowing the difference. `create`, `update` and `complete` answer with a plain
+ * `Repair`: the caller of those already knows which asset it asked about.
+ */
+export const RepairListItem = Repair.extend({
+    assetCode: z.string().min(1).max(40),
+    assetName: z.string().min(1).max(200),
+});
+/**
+ * Everything a person can say about a repair.
+ *
+ * **No field here carries `.default()`, for the reason `AssetInput` spells out**: `update` is built
+ * from `.partial()`, and `.partial()` does not strip a default — zod still substitutes it for a key
+ * the request never sent, so a patch that renames a repair would silently re-date it. `sentOn` is
+ * optional rather than defaulted for the same reason; `repairs.create` fills today's date on the
+ * server, which is the only clock this module trusts.
+ */
+export const RepairInput = z.object({
+    summary: z.string().trim().min(1).max(200),
+    detail: z.string().max(4000).nullish(),
+    vendor: z.string().max(200).nullish(),
+    costMinor: z.number().int().min(0).nullish(),
+    currency: z.string().length(3).nullish(),
+    /** `sent_on` is `not null` in the database, so this is optional but never nullable. */
+    sentOn: z.iso.date().optional(),
+});
+export const RepairPatchInput = RepairInput.partial();
+/**
+ * What a repair mutation answers with: the repair, and the asset as it now stands.
+ *
+ * Both, for the reason `CustodyResult` carries both — sending an item away moves `assets.status`,
+ * and a screen that had to fetch the asset again afterwards would be reading a row somebody else
+ * may have changed in between.
+ */
+export const RepairResult = z.object({
+    repair: Repair,
+    asset: Asset,
+});
+/**
+ * A file recorded against an asset — a receipt, a warranty card, a manual.
+ *
+ * **The bytes are core's, not this module's.** A module does not upload: the browser uploads through
+ * core's file service and hands this module the id it was given, and reading one back is a download
+ * URL core signs. All that lives here is the fact that this asset has that file, plus the name and
+ * size copied at attach time so a list can be drawn without asking core once per row.
+ *
+ * `repairId` is what separates "the invoice for the screen replacement" from "the purchase receipt":
+ * null means it belongs to the asset itself.
+ */
+export const Attachment = z.object({
+    id: z.uuid(),
+    workspaceId: WorkspaceId,
+    assetId: z.uuid(),
+    repairId: z.uuid().nullable(),
+    fileId: z.uuid(),
+    name: z.string().max(300),
+    mimeType: z.string().max(200).nullable(),
+    /** Bytes, as core reported them when the file was attached. */
+    size: z.number().int().nullable(),
+    uploadedBy: z.uuid().nullable(),
+    createdAt: z.string(),
+});
+/**
+ * The register in numbers: what a page's count line and a dashboard card need in one request.
+ *
+ * `total` counts what the list shows by default — live rows — and `archived` is beside it rather
+ * than inside it, because a count line that silently included archived rows would disagree with the
+ * list under it.
+ *
+ * **`outForRepair` is null when the workspace does not track repairs.** Zero would be a claim
+ * ("nothing is away"), and a workspace with the `repairs` capability off has not made that claim —
+ * it has no opinion at all. The screens show the tile only when a number arrives, which is the same
+ * rule as hiding the Repairs tab, expressed in the data instead of in a second capability lookup.
+ */
+export const InventoryStats = z.object({
+    total: z.number().int().nonnegative(),
+    archived: z.number().int().nonnegative(),
+    /** Every status, zero-filled, so a screen can render the set without knowing which exist. */
+    byStatus: z.record(AssetStatus, z.number().int().nonnegative()),
+    outForRepair: z.number().int().nonnegative().nullable(),
+    /** Live assets nobody is holding — what is actually available to hand out. */
+    unassigned: z.number().int().nonnegative(),
+});
 /**
  * How a list is ordered, and therefore what a page cursor is a bookmark *into*.
  *

package/dist/contract/models.js.map

@@ -1 +1 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/contract/models.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/contract/models.ts"],"names":[],"mappings":"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"}

package/dist/contract/notifications.d.ts

@@ -0,0 +1,24 @@
+import type { core } from '@kernhq/contracts';
+/**
+ * What Inventory will interrupt somebody about.
+ *
+ * Four things, and each of them changes what somebody has to *do*. That is the test: a rename, a new
+ * category, an item coming back — those are facts a screen shows when somebody looks, and a
+ * notification type nobody wants is a notification type everybody switches off along with the one
+ * that mattered.
+ *
+ * A type declared here and never sent is the same lie as a permission nothing checks. Each of these
+ * names its sender, and every one of them exists:
+ *
+ * - `custody.assigned` — `CustodyService`, on `assign` and `transfer`.
+ * - `warranty.expiring` — the `warranty-sweep` job, once per asset.
+ * - `repair.overdue` — the `repair-overdue` job, once per repair.
+ * - `custody.return_due` — the offboarding subscription, when HR says somebody has left or core says
+ *   they have been removed from the workspace.
+ *
+ * The keys keep their `inventory.custody.*` spelling rather than being renamed to
+ * `inventory.asset.*`: a notification type is the key a person's own preferences are stored under,
+ * so renaming one silently resets everybody who had switched it off.
+ */
+export declare const inventoryNotificationTypes: core.NotificationTypeDef[];
+//# sourceMappingURL=notifications.d.ts.map

package/dist/contract/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/contract/notifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,0BAA0B,EAAE,IAAI,CAAC,mBAAmB,EAiDhE,CAAA"}