@kernhq/module-inventory 0.1.0

package/README.md

@@ -0,0 +1,32 @@
+# @kernhq/module-inventory
+
+The asset register for [Kern](https://github.com/KernAIO/app): what the company owns, who holds each
+item, and everything that happened to it.
+
+- **Assets** with an auto-assigned tag (`INV-0042`), serial number, purchase date and vendor, price,
+  warranty expiry, location, photo and description.
+- **Custody**: hand an item to a member and it stays theirs — with the full history of who held it
+  before — until somebody hands it on or takes it back.
+- **History**: every change to an asset is recorded as an append-only timeline entry: what moved,
+  from what, to what, by whom.
+
+Part of a Kern instance; enable it per workspace in **Settings → Modules**.
+
+## Developing
+
+```bash
+pnpm install
+pnpm typecheck   # tsc + svelte-check over the client
+pnpm test
+pnpm build
+pnpm db:generate # drizzle-kit → migrations/ (RLS policies are hand-written)
+```
+
+This package follows the standard Kern module shape: one contract shared by both halves, a server
+module hosted by core, and a client module whose screens ship inside this package. See
+`docs/adr/0008-a-module-ships-its-own-screens.md` in the app repository for the reasoning.
+
+## Licence
+
+AGPL-3.0-only. This module is part of the Kern product; anything you build for your own Kern
+instance does not have to be released, but modifications to this module do.

package/dist/contract.d.ts

@@ -0,0 +1,387 @@
+import { z } from 'zod';
+/**
+ * What this module offers, as data.
+ *
+ * Imported by **both** halves — the server implements it, the client calls it — so nothing here may
+ * touch Node. The contract is the only thing that crosses that line, which is why a procedure that
+ * exists here and not in the router is a lie that compiles. `module.test.ts` checks exactly that.
+ */
+/** Lowercase, 2-32 characters. Names the API prefix, the Postgres schema `mod_<id>` and every event. */
+export declare const MODULE_ID = "inventory";
+/**
+ * An asset's lifecycle. `in_stock` and `assigned` follow custody (an open row in
+ * `custody_periods` means assigned); `under_repair` follows an open repair; `retired` is set by
+ * hand when an item leaves the company. Stored, because every list filter needs it, and kept in
+ * step inside the same transaction that writes the row it derives from.
+ */
+export declare const AssetStatus: z.ZodEnum<{
+    in_stock: "in_stock";
+    assigned: "assigned";
+    under_repair: "under_repair";
+    retired: "retired";
+}>;
+export type AssetStatus = z.infer<typeof AssetStatus>;
+export declare const 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";
+        under_repair: "under_repair";
+        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>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    archivedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type Asset = z.infer<typeof Asset>;
+export declare const inventoryContract: {
+    assets: {
+        list: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            q: z.ZodOptional<z.ZodString>;
+            categoryId: z.ZodOptional<z.ZodUUID>;
+            status: z.ZodOptional<z.ZodEnum<{
+                in_stock: "in_stock";
+                assigned: "assigned";
+                under_repair: "under_repair";
+                retired: "retired";
+            }>>;
+            sort: z.ZodDefault<z.ZodEnum<{
+                code: "code";
+                name: "name";
+                recent: "recent";
+            }>>;
+            cursor: z.ZodOptional<z.ZodString>;
+            limit: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            items: z.ZodArray<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";
+                    under_repair: "under_repair";
+                    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>;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                archivedAt: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            nextCursor: z.ZodNullable<z.ZodString>;
+            total: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        get: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            assetId: z.ZodUUID;
+        }, z.core.$strip>, 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";
+                under_repair: "under_repair";
+                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>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            archivedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        create: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            name: z.ZodString;
+            description: z.ZodDefault<z.ZodString>;
+            categoryId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            serialNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            location: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            purchasedFrom: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            purchasedOn: z.ZodOptional<z.ZodNullable<z.ZodISODate>>;
+            warrantyUntil: z.ZodOptional<z.ZodNullable<z.ZodISODate>>;
+            priceMinor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>, 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";
+                under_repair: "under_repair";
+                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>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            archivedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        update: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            name: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+            categoryId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodUUID>>>;
+            serialNumber: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+            location: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+            purchasedFrom: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+            purchasedOn: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodISODate>>>;
+            warrantyUntil: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodISODate>>>;
+            priceMinor: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+            currency: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+            assetId: z.ZodUUID;
+        }, z.core.$strip>, 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";
+                under_repair: "under_repair";
+                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>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            archivedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        archive: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            assetId: z.ZodUUID;
+            archived: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>, 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";
+                under_repair: "under_repair";
+                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>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            archivedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+    };
+};
+export type InventoryContract = typeof inventoryContract;
+/** `<module>.<entity>.<action>`. Anything that emits one declares it here. Payloads carry ids, never rows. */
+export declare const inventoryEvents: {
+    assetCreated: import("@kernhq/contracts").EventDef<"inventory.asset.created", z.ZodObject<{
+        assetId: z.ZodUUID;
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+    }, z.core.$strip>>;
+    assetUpdated: import("@kernhq/contracts").EventDef<"inventory.asset.updated", z.ZodObject<{
+        assetId: z.ZodUUID;
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+    }, z.core.$strip>>;
+    assetArchived: import("@kernhq/contracts").EventDef<"inventory.asset.archived", z.ZodObject<{
+        assetId: z.ZodUUID;
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+    }, z.core.$strip>>;
+};
+/**
+ * `<module>.<resource>.<action>`, each with the narrowest scope that works and the roles that hold it
+ * by default. A workspace can add or remove any of them afterwards with a custom role.
+ */
+export declare const inventoryPermissions: readonly [{
+    readonly key: "inventory.asset.view";
+    readonly label: "View assets";
+    readonly scope: "workspace";
+    readonly defaultRoles: ["owner", "admin", "member", "guest"];
+    readonly dangerous: false;
+}, {
+    readonly key: "inventory.asset.manage";
+    readonly label: "Create and edit assets";
+    readonly scope: "workspace";
+    readonly defaultRoles: ["owner", "admin", "member"];
+    readonly dangerous: false;
+}];
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;GAMG;AAEH,wGAAwG;AACxG,eAAO,MAAM,SAAS,cAAc,CAAA;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;EAA8D,CAAA;AACtF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAErD,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2BhB,CAAA;AACF,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAA;AAiBzC,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC7B,CAAA;AACD,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAA;AAExD,8GAA8G;AAC9G,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAa3B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAe/B,CAAA"}

package/dist/contract.js

@@ -0,0 +1,119 @@
+import { baseContract, defineEvent, definePermissions, PageInput, page, WorkspaceId } from '@kernhq/contracts';
+import { z } from 'zod';
+/**
+ * What this module offers, as data.
+ *
+ * Imported by **both** halves — the server implements it, the client calls it — so nothing here may
+ * touch Node. The contract is the only thing that crosses that line, which is why a procedure that
+ * exists here and not in the router is a lie that compiles. `module.test.ts` checks exactly that.
+ */
+/** Lowercase, 2-32 characters. Names the API prefix, the Postgres schema `mod_<id>` and every event. */
+export const MODULE_ID = 'inventory';
+/**
+ * An asset's lifecycle. `in_stock` and `assigned` follow custody (an open row in
+ * `custody_periods` means assigned); `under_repair` follows an open repair; `retired` is set by
+ * hand when an item leaves the company. Stored, because every list filter needs it, and kept in
+ * step inside the same transaction that writes the row it derives from.
+ */
+export const AssetStatus = z.enum(['in_stock', 'assigned', 'under_repair', 'retired']);
+export const Asset = z.object({
+    id: z.uuid(),
+    workspaceId: WorkspaceId,
+    /** Human-facing asset tag (`INV-0001`), assigned by the server, unique per workspace. */
+    code: z.string().min(1).max(40),
+    name: z.string().min(1).max(200),
+    description: z.string().max(4000),
+    categoryId: z.uuid().nullable(),
+    status: AssetStatus,
+    /**
+     * The member currently holding the item. A plain uuid — cross-schema foreign keys are what the
+     * module boundary exists to prevent — resolved against core membership at read time.
+     */
+    custodianUserId: z.uuid().nullable(),
+    custodySince: z.string().nullable(),
+    serialNumber: z.string().max(200).nullable(),
+    location: z.string().max(200).nullable(),
+    purchasedOn: z.string().nullable(),
+    purchasedFrom: z.string().max(200).nullable(),
+    /** Minor units (cents), the convention billing established; formatted on the client. */
+    priceMinor: z.number().int().nullable(),
+    currency: z.string().length(3).nullable(),
+    warrantyUntil: z.string().nullable(),
+    photoFileId: z.uuid().nullable(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    archivedAt: z.string().nullable(),
+});
+const ws = z.object({ workspaceId: WorkspaceId });
+const AssetCreateInput = z.object({
+    name: z.string().min(1).max(200),
+    description: z.string().max(4000).default(''),
+    categoryId: z.uuid().nullish(),
+    serialNumber: z.string().max(200).nullish(),
+    location: z.string().max(200).nullish(),
+    purchasedFrom: z.string().max(200).nullish(),
+    purchasedOn: z.iso.date().nullish(),
+    warrantyUntil: z.iso.date().nullish(),
+    priceMinor: z.number().int().min(0).nullish(),
+    currency: z.string().length(3).nullish(),
+});
+export const inventoryContract = {
+    assets: {
+        list: baseContract
+            .route({ method: 'GET', path: '/assets', tags: ['inventory'] })
+            .input(ws.extend({
+            ...PageInput.shape,
+            q: z.string().max(200).optional(),
+            categoryId: z.uuid().optional(),
+            status: AssetStatus.optional(),
+            sort: z.enum(['recent', 'name', 'code']).default('recent'),
+        }))
+            .output(page(Asset)),
+        get: baseContract
+            .route({ method: 'GET', path: '/assets/{assetId}', tags: ['inventory'] })
+            .input(ws.extend({ assetId: z.uuid() }))
+            .output(Asset),
+        create: baseContract
+            .route({ method: 'POST', path: '/assets', tags: ['inventory'] })
+            .input(ws.extend(AssetCreateInput.shape))
+            .output(Asset),
+        update: baseContract
+            .route({ method: 'PATCH', path: '/assets/{assetId}', tags: ['inventory'] })
+            .input(ws.extend({
+            assetId: z.uuid(),
+            ...AssetCreateInput.partial().shape,
+        }))
+            .output(Asset),
+        archive: baseContract
+            .route({ method: 'POST', path: '/assets/{assetId}/archive', tags: ['inventory'] })
+            .input(ws.extend({ assetId: z.uuid(), archived: z.boolean().default(true) }))
+            .output(Asset),
+    },
+};
+/** `<module>.<entity>.<action>`. Anything that emits one declares it here. Payloads carry ids, never rows. */
+export const inventoryEvents = {
+    assetCreated: defineEvent('inventory.asset.created', z.object({ assetId: z.uuid(), workspaceId: WorkspaceId })),
+    assetUpdated: defineEvent('inventory.asset.updated', z.object({ assetId: z.uuid(), workspaceId: WorkspaceId })),
+    assetArchived: defineEvent('inventory.asset.archived', z.object({ assetId: z.uuid(), workspaceId: WorkspaceId })),
+};
+/**
+ * `<module>.<resource>.<action>`, each with the narrowest scope that works and the roles that hold it
+ * by default. A workspace can add or remove any of them afterwards with a custom role.
+ */
+export const inventoryPermissions = definePermissions([
+    {
+        key: 'inventory.asset.view',
+        label: 'View assets',
+        scope: 'workspace',
+        defaultRoles: ['owner', 'admin', 'member', 'guest'],
+        dangerous: false,
+    },
+    {
+        key: 'inventory.asset.manage',
+        label: 'Create and edit assets',
+        scope: 'workspace',
+        defaultRoles: ['owner', 'admin', 'member'],
+        dangerous: false,
+    },
+]);
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

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