@kernhq/module-inventory 0.1.2 → 0.3.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/contract/router.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA0BvB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAqC1B;;;;;;;;;;WAUG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOL;;;;;;;OAOG;;QAED,6FAA6F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAK7F,6EAA6E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAK7E;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAKH;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAKH;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOL;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAcD;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOL;;;;;;;;;;OAUG;;QAED;;;;;;;;;;WAUG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAYH;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAKH;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAKH;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAcL;;;;;;;;;;OAUG;;QAED;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAKH,oGAAoG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAWpG,iGAAiG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOnG;;;;;;;;;OASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIJ,CAAA;AACD,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAA"}

package/dist/contract/router.js

@@ -0,0 +1,266 @@
+import { baseContract, PageInput, page } from '@kernhq/contracts';
+import { z } from 'zod';
+import { Asset, AssetCreateInput, AssetHistoryEntry, AssetPatchInput, AssetSort, AssetStatus, Attachment, Category, CategoryInput, CustodyPeriod, CustodyResult, InventoryStats, RepairInput, RepairListItem, RepairPatchInput, RepairResult, ws, } from './models.js';
+const t = ['inventory'];
+/** A handover note is optional everywhere and shaped the same everywhere. */
+const custodyNote = z.string().max(500).nullish();
+export const inventoryContract = {
+    assets: {
+        list: baseContract
+            .route({ method: 'GET', path: '/assets', tags: t })
+            .input(ws.extend({
+            ...PageInput.shape,
+            q: z.string().max(200).optional(),
+            categoryId: z.uuid().optional(),
+            status: AssetStatus.optional(),
+            custodianUserId: z.uuid().optional(),
+            /**
+             * Archived rows are excluded unless asked for. The page used to filter them in the
+             * browser, which is wrong the moment there is more than one page of them: the first
+             * twenty rows come back, half are dropped, and the list looks short rather than paged.
+             */
+            archived: z.boolean().default(false),
+            sort: AssetSort.default('recent'),
+        }))
+            .output(page(Asset)),
+        get: baseContract
+            .route({ method: 'GET', path: '/assets/{assetId}', tags: t })
+            .input(ws.extend({ assetId: z.uuid() }))
+            .output(Asset),
+        create: baseContract
+            .route({ method: 'POST', path: '/assets', tags: t })
+            .input(ws.extend(AssetCreateInput.shape))
+            .output(Asset),
+        update: baseContract
+            .route({ method: 'PATCH', path: '/assets/{assetId}', tags: t })
+            .input(ws.extend({ assetId: z.uuid(), ...AssetPatchInput.shape }))
+            .output(Asset),
+        archive: baseContract
+            .route({ method: 'POST', path: '/assets/{assetId}/archive', tags: t })
+            .input(ws.extend({ assetId: z.uuid(), archived: z.boolean().default(true) }))
+            .output(Asset),
+        /**
+         * The asset's own timeline, newest first.
+         *
+         * Paged with the same keyset discipline `assets.list` uses and the same cursor codec, because a
+         * second bookmark format is a second set of the three bugs the first one had. The bookmark is a
+         * row id; the ordering is by id, which for a uuidv7 is the clock and, unlike `created_at`, is
+         * unique — two entries written in one transaction (a create and its first custody row) share a
+         * timestamp and a page boundary between them would repeat or drop one.
+         *
+         * Reads on `inventory.asset.view`. See `permissions.ts` for why custody is not gated separately.
+         */
+        history: baseContract
+            .route({ method: 'GET', path: '/assets/{assetId}/history', tags: t })
+            .input(ws.extend({ assetId: z.uuid(), ...PageInput.shape }))
+            .output(page(AssetHistoryEntry)),
+    },
+    /**
+     * Who is holding what.
+     *
+     * Four verbs rather than one, because "hand it to somebody" and "hand it on to somebody else" are
+     * different questions with different failure modes: assigning something already out is a mistake
+     * worth refusing, and transferring something nobody holds is a different mistake. One procedure
+     * taking `userId | null` would answer both by silently doing whatever the row happened to allow.
+     */
+    custody: {
+        /** Hand a free item to a member. Refuses if somebody already has it — that is `transfer`. */
+        assign: baseContract
+            .route({ method: 'POST', path: '/assets/{assetId}/custody', tags: t })
+            .input(ws.extend({ assetId: z.uuid(), userId: z.uuid(), note: custodyNote }))
+            .output(CustodyResult),
+        /** Take it back. Closes the open period and puts the asset back in stock. */
+        return: baseContract
+            .route({ method: 'POST', path: '/assets/{assetId}/custody/return', tags: t })
+            .input(ws.extend({ assetId: z.uuid(), note: custodyNote }))
+            .output(CustodyResult),
+        /**
+         * Hand it straight on: one transaction, not a return followed by an assign.
+         *
+         * Two calls would leave the asset `in_stock` with no custodian in between — visible to anybody
+         * reading the list at that moment, and permanently visible in the timeline as a return that
+         * nobody performed.
+         */
+        transfer: baseContract
+            .route({ method: 'POST', path: '/assets/{assetId}/custody/transfer', tags: t })
+            .input(ws.extend({ assetId: z.uuid(), userId: z.uuid(), note: custodyNote }))
+            .output(CustodyResult),
+        /**
+         * Every period for one asset, newest first — "who had this laptop before me".
+         *
+         * An array rather than a page, like HR's `employment.history`: the rows are bounded by how many
+         * times one item changed hands, which is tens over its life. `limit` caps it rather than
+         * paging, so the answer is never unbounded and the caller never has a cursor to keep.
+         */
+        history: baseContract
+            .route({ method: 'GET', path: '/assets/{assetId}/custody', tags: t })
+            .input(ws.extend({ assetId: z.uuid(), limit: z.number().int().min(1).max(200).default(100) }))
+            .output(z.array(CustodyPeriod)),
+        /**
+         * What one person is holding right now.
+         *
+         * Answered from `assets.custodian_user_id` — denormalised inside the same transaction that
+         * writes the period, and indexed — rather than from an open-period join, so the offboarding
+         * question ("what does Ada still have?") is one indexed read.
+         */
+        byUser: baseContract
+            .route({ method: 'GET', path: '/custody/by-user/{userId}', tags: t })
+            .input(ws.extend({ userId: z.uuid(), ...PageInput.shape }))
+            .output(page(Asset)),
+    },
+    /**
+     * How a workspace groups what it owns.
+     *
+     * Not paged: a workspace has tens of categories, and every one of them has to be in the picker
+     * anyway. A cursor here would be a page boundary in a dropdown.
+     */
+    categories: {
+        list: baseContract
+            .route({ method: 'GET', path: '/categories', tags: t })
+            .input(ws.extend({ archived: z.boolean().default(false) }))
+            .output(z.array(Category)),
+        create: baseContract
+            .route({ method: 'POST', path: '/categories', tags: t })
+            .input(ws.extend(CategoryInput.shape))
+            .output(Category),
+        update: baseContract
+            .route({ method: 'PATCH', path: '/categories/{categoryId}', tags: t })
+            .input(ws.extend({ categoryId: z.uuid(), ...CategoryInput.partial().shape }))
+            .output(Category),
+        /**
+         * Archive, not delete — and the same procedure restores.
+         *
+         * `assets.category_id` carries no foreign key, so a delete would leave every asset filed under
+         * it pointing at nothing: a blank column, and a timeline entry that recorded the move losing
+         * the name it recorded. Archiving is reversible and destroys nothing.
+         */
+        archive: baseContract
+            .route({ method: 'POST', path: '/categories/{categoryId}/archive', tags: t })
+            .input(ws.extend({ categoryId: z.uuid(), archived: z.boolean().default(true) }))
+            .output(Category),
+    },
+    /**
+     * What went away to be fixed.
+     *
+     * **Behind the `repairs` capability**, which is this module's first switchable one — so every
+     * procedure here answers **404** rather than 403 in a workspace that has it off. 403 would say
+     * "this exists and you may not have it", which is false for a company that does not record
+     * repairs, and it would contradict a panel that has already hidden the tab.
+     *
+     * Writing takes `inventory.repair.manage`; reading rides `inventory.asset.view`, for the reason
+     * custody does — "where is the projector" is the question the register exists to answer.
+     */
+    repairs: {
+        /**
+         * One asset's repairs, or the whole workspace's — the same procedure, because they are the same
+         * query with one filter and a second one would be a second thing to keep in step.
+         *
+         * `open: true` is the "what is away right now" question a dashboard card asks, and it is a
+         * filter rather than a procedure of its own for the same reason.
+         *
+         * Paged, unlike `custody.history`: one asset's repairs are bounded by how often it breaks, but
+         * a workspace's are not. Ordered newest-logged first, by row id — a uuidv7 already carries the
+         * clock and is unique, where `sent_on` is a date two repairs logged the same day share.
+         */
+        list: baseContract
+            .route({ method: 'GET', path: '/repairs', tags: t })
+            .input(ws.extend({
+            ...PageInput.shape,
+            assetId: z.uuid().optional(),
+            /** `true` for still away, `false` for finished, absent for both. */
+            open: z.boolean().optional(),
+        }))
+            .output(page(RepairListItem)),
+        /**
+         * Send it away. Refuses when the item is already at a repairer — one open repair per asset, and
+         * `inventory_repairs_one_open_uq` is what makes that true in the database rather than merely
+         * likely in the service.
+         *
+         * `sentOn` is optional and defaults to today **on the server**: a browser clock is not a fact
+         * this module is willing to record, and the same reasoning already keeps asset tags server-side.
+         */
+        create: baseContract
+            .route({ method: 'POST', path: '/assets/{assetId}/repairs', tags: t })
+            .input(ws.extend({ assetId: z.uuid(), ...RepairInput.shape }))
+            .output(RepairResult),
+        /**
+         * Correct what was recorded — a vendor, a cost that arrived with the invoice a week later.
+         *
+         * Deliberately cannot set `returnedOn`: that one column decides whether the asset reads as
+         * `under_repair`, so exactly one procedure moves it and the derived status has one door rather
+         * than two.
+         */
+        update: baseContract
+            .route({ method: 'PATCH', path: '/repairs/{repairId}', tags: t })
+            .input(ws.extend({ repairId: z.uuid(), ...RepairPatchInput.shape }))
+            .output(RepairResult),
+        /**
+         * It came back. Closes the repair and puts the asset back to `assigned` if somebody still holds
+         * it, or `in_stock` if nobody does — never blindly to `in_stock`, which would quietly release
+         * whoever is answerable for it.
+         *
+         * Takes the cost, because that is when the invoice usually arrives.
+         */
+        complete: baseContract
+            .route({ method: 'POST', path: '/repairs/{repairId}/complete', tags: t })
+            .input(ws.extend({
+            repairId: z.uuid(),
+            returnedOn: z.iso.date().optional(),
+            costMinor: z.number().int().min(0).nullish(),
+            currency: z.string().length(3).nullish(),
+        }))
+            .output(RepairResult),
+    },
+    /**
+     * Receipts, warranties, manuals — and the asset's photo, which is an `Asset` field rather than one
+     * of these.
+     *
+     * **Behind the `attachments` capability**, so these answer 404 in a workspace that has it off.
+     *
+     * **A module does not upload.** The browser sends the bytes to core's file service and hands this
+     * module the id core gave it; `add` records that this asset has that file. Nothing here streams,
+     * signs or stores anything, and `remove` detaches rather than deleting core's file — the same
+     * bytes may be attached elsewhere, and a module has no standing to destroy another module's row.
+     */
+    attachments: {
+        /**
+         * Every file on one asset, its repairs' included, each carrying its own `repairId`.
+         *
+         * Not paged and not filtered by repair: one asset's files are bounded and entirely loaded, so
+         * the panel groups them in the browser. That is the one case where filtering client-side is
+         * right, and it is the opposite of what `assets.list` may do.
+         */
+        list: baseContract
+            .route({ method: 'GET', path: '/assets/{assetId}/attachments', tags: t })
+            .input(ws.extend({ assetId: z.uuid() }))
+            .output(z.array(Attachment)),
+        /** Attach files core already holds. `repairId` files them under one repair instead of the asset. */
+        add: baseContract
+            .route({ method: 'POST', path: '/assets/{assetId}/attachments', tags: t })
+            .input(ws.extend({
+            assetId: z.uuid(),
+            fileIds: z.array(z.uuid()).min(1).max(20),
+            repairId: z.uuid().nullish(),
+        }))
+            .output(z.array(Attachment)),
+        /** Answers with the id it detached, so a client can drop exactly that row without re-reading. */
+        remove: baseContract
+            .route({ method: 'DELETE', path: '/attachments/{attachmentId}', tags: t })
+            .input(ws.extend({ attachmentId: z.uuid() }))
+            .output(z.object({ id: z.uuid() })),
+    },
+    /**
+     * The register in numbers.
+     *
+     * One procedure rather than a `total` on `assets.list`, because they answer different questions:
+     * a list's total describes the filter you asked for, and this describes the workspace. The assets
+     * page needs both — "showing 50 of 214" is two numbers from two places.
+     *
+     * Not behind a capability: it counts assets, which is `core`. `outForRepair` comes back null
+     * rather than 0 where `repairs` is off — see `InventoryStats`.
+     */
+    stats: {
+        summary: baseContract.route({ method: 'GET', path: '/stats', tags: t }).input(ws).output(InventoryStats),
+    },
+};
+//# sourceMappingURL=router.js.map

package/dist/contract/router.js.map

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

package/dist/contract/settings.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+/**
+ * Workspace-level settings for Inventory.
+ *
+ * Deliberately small. Nearly everything an administrator configures belongs to a category, a
+ * location or a field definition, because those are the things that differ between two kinds of
+ * item in the same company. What is left is genuinely workspace-wide.
+ *
+ * Note what is *not* here: the capability switches. Those live under a reserved `$capabilities` key
+ * the platform owns, so turning one off cannot collide with a settings field and cannot be dropped
+ * by a settings round-trip.
+ */
+export declare const InventorySettings: z.ZodObject<{
+    assetCodePrefix: z.ZodDefault<z.ZodString>;
+    assetCodePad: z.ZodDefault<z.ZodNumber>;
+    warrantyNoticeDays: z.ZodDefault<z.ZodNumber>;
+    repairOverdueDays: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type InventorySettings = z.infer<typeof InventorySettings>;
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/contract/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB;;;;;iBAmC5B,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA"}

package/dist/contract/settings.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+/**
+ * Workspace-level settings for Inventory.
+ *
+ * Deliberately small. Nearly everything an administrator configures belongs to a category, a
+ * location or a field definition, because those are the things that differ between two kinds of
+ * item in the same company. What is left is genuinely workspace-wide.
+ *
+ * Note what is *not* here: the capability switches. Those live under a reserved `$capabilities` key
+ * the platform owns, so turning one off cannot collide with a settings field and cannot be dropped
+ * by a settings round-trip.
+ */
+export const InventorySettings = z.object({
+    /**
+     * What an asset tag looks like. `INV-` and 4 gives `INV-0042`.
+     *
+     * People read these off a sticker and say them out loud, so a workspace that already labels its
+     * laptops `LT-` should not have to keep two numbering systems in its head. The counter itself is a
+     * row in `mod_inventory.counters`, not a setting — a number an administrator can edit is a number
+     * that produces a duplicate tag.
+     */
+    assetCodePrefix: z.string().max(8).default('INV-'),
+    assetCodePad: z.number().int().min(1).max(10).default(4),
+    /**
+     * How far ahead of a warranty running out somebody is told.
+     *
+     * This spent a release describing a sweep that did not exist — no job, no subscription, nothing
+     * reading the number — and was taken out for it. It is back because `warranty-sweep` reads it
+     * every morning: a live asset whose `warranty_until` falls inside this many days earns exactly
+     * one notice, marked on the row so the next morning does not send it again.
+     *
+     * A month by default, which is about how long it takes to decide whether to extend a warranty or
+     * budget for a replacement. Capped at a year: further out than that is not a notice, it is a
+     * report.
+     */
+    warrantyNoticeDays: z.number().int().min(1).max(365).default(30),
+    /**
+     * How long an item may be at a repairer before somebody is asked to chase it.
+     *
+     * Read by `repair-overdue`, which tells the person who logged the repair — and whoever is still
+     * holding the item — once, and then leaves them alone. Two weeks by default: long enough that an
+     * ordinary screen replacement never trips it, short enough that a laptop nobody chased does.
+     *
+     * A workspace with the `repairs` capability off never meets this: the sweep asks first, and a
+     * setting whose feature is switched off changes nothing rather than firing quietly.
+     */
+    repairOverdueDays: z.number().int().min(1).max(365).default(14),
+});
+//# sourceMappingURL=settings.js.map

package/dist/contract/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/contract/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC;;;;;;;OAOG;IACH,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAClD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD;;;;;;;;;;;OAWG;IACH,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAChE;;;;;;;;;OASG;IACH,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAChE,CAAC,CAAA"}

package/dist/server/index.d.ts

@@ -1,3 +1,10 @@
-export declare const inventoryModule: import("@kernhq/kernel").ServerModule<import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>>;
+import { z } from 'zod';
+export declare const inventoryModule: import("@kernhq/kernel").ServerModule<z.ZodObject<{
+    assetCodePrefix: z.ZodDefault<z.ZodString>;
+    assetCodePad: z.ZodDefault<z.ZodNumber>;
+    warrantyNoticeDays: z.ZodDefault<z.ZodNumber>;
+    repairOverdueDays: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
 export default inventoryModule;
+export type InventoryModule = typeof inventoryModule;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,eAAe,2IAyB1B,CAAA;AACF,eAAe,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA8CvB,eAAO,MAAM,eAAe;;;;;kBAiR1B,CAAA;AAgBF,eAAe,eAAe,CAAA;AAC9B,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAA"}