@kernhq/module-inventory 0.1.2 → 0.3.0

package/dist/server/services/assets.d.ts

@@ -0,0 +1,139 @@
+import { type Kernel, type Tx } from '@kernhq/kernel';
+import type { AssetCreateInput, AssetHistoryEntry, Asset as AssetModel, AssetPatchInput, AssetSort } from '../../contract/models.js';
+import { assetHistory, assets } from '../schema.js';
+import type { HistoryInput, NotifyService } from './notify.js';
+type Row = typeof assets.$inferSelect;
+/**
+ * What a mutation wrote, and what may only leave the module once it has committed.
+ *
+ * `asset_history` is written inside the caller's transaction and is authoritative; the mirror of it
+ * in core's activity feed is not, and used to be fired off with `void` while the transaction was
+ * still open. A rollback then left the workspace's feed showing an event for an id that does not
+ * exist. Everything else this module announces — the event, the realtime change — already waits for
+ * the commit, so the activity record is handed back here and flushed beside them.
+ */
+export interface Written {
+    row: Row;
+    /** `null` when nothing happened worth recording, which is what an update that changed nothing is. */
+    activity: HistoryInput | null;
+}
+/** How this workspace spells an asset tag. Read before the transaction opens — see `codeFormat`. */
+export interface CodeFormat {
+    prefix: string;
+    pad: number;
+}
+/** The wire shape: drizzle gives Date objects for timestamps, the contract promises ISO strings. */
+export declare function toAsset(row: Row): AssetModel;
+/**
+ * The wire shape of one timeline entry. Drizzle's `jsonb` columns are nullable in the row and never
+ * null in the contract — `changes: []` and `data: {}` are what "nothing to say" looks like to a
+ * screen, where `null` is one more thing every caller has to remember to handle.
+ */
+export declare function toHistoryEntry(row: typeof assetHistory.$inferSelect): AssetHistoryEntry;
+export interface ListInput {
+    workspaceId: string;
+    limit: number;
+    cursor?: string;
+    q?: string;
+    categoryId?: string;
+    status?: string;
+    custodianUserId?: string;
+    archived: boolean;
+    sort: AssetSort;
+}
+export declare class AssetService {
+    private readonly kernel;
+    private readonly notify;
+    constructor(kernel: Kernel, notify: NotifyService);
+    /**
+     * How this workspace spells an asset tag.
+     *
+     * **Called before the transaction opens, never inside one.** `kernel.settings.module` is a
+     * `core.settings.getModule` call over the broker, and awaiting a remote service while holding a
+     * pooled connection *and* the counter row lock is two failures waiting: the pool starves under
+     * concurrent creates, and a create fails outright whenever core is briefly away — which is the
+     * one thing `NotifyService`'s own docblock says a mutation here must never do.
+     */
+    codeFormat(workspaceId: string): Promise<CodeFormat>;
+    /**
+     * The next asset tag for a workspace.
+     *
+     * One narrow row per workspace and key, incremented under the insert's conflict lock — two
+     * concurrent creates each read the value their own statement returned, so codes stay unique
+     * without a retry loop. `INV-0042`, because people say asset tags out loud. Nothing in here
+     * leaves the database, which is what keeps the lock short.
+     */
+    nextCode(tx: Tx, workspaceId: string, format: CodeFormat): Promise<string>;
+    list(tx: Tx, input: ListInput): Promise<{
+        items: AssetModel[];
+        nextCursor: string | null;
+    }>;
+    /**
+     * The asset's own timeline, newest first, paged on the sequence the entries carry.
+     *
+     * **The ordering is `seq`, not `occurred_at` and not the id**, and the middle one of those three
+     * is the interesting correction.
+     *
+     * `occurred_at` was never a candidate: it defaults to `now()`, which is the *transaction*
+     * timestamp, so `create` writes the asset and its `created` entry with the same value and a page
+     * boundary between two entries that share a sort key repeats one and drops the other.
+     *
+     * The id looked like the answer and was only half of one. A uuidv7 is unique, so paging on it is
+     * gapless — but the kernel's `uuidv7()` carries the clock only to the millisecond and fills the
+     * rest from `randomUUID()` with no counter, so two entries written inside one millisecond sort by
+     * ten random bytes. Stable, so nothing was ever dropped or repeated; and arbitrary, so a timeline
+     * could show "Bruno removed the file" above "Bruno added the file". `seq` is a sequence: strictly
+     * increasing whatever the clock does, at whatever rate. `schema.ts` argues it at the column.
+     *
+     * The comparison is a single column because the sort key *is* the bookmark, so there is no
+     * bookmarked-row subquery here. The bookmark is still checked as a bounded positive integer and
+     * still bound to the sort it was issued under, because that is the codec's job and not this
+     * query's.
+     */
+    history(tx: Tx, workspaceId: string, assetId: string, input: {
+        limit: number;
+        cursor?: string;
+    }): Promise<{
+        items: AssetHistoryEntry[];
+        nextCursor: string | null;
+    }>;
+    /**
+     * A category id in a request is a claim about a row in this workspace, and it is checked before
+     * it is stored.
+     *
+     * The same defect `photoFileId` had, one field over: `assets.create` and `assets.update` took
+     * `categoryId` on trust, so any uuid at all went into the column. Two things follow from that,
+     * and neither is theoretical. An id belonging to **another workspace** files an asset under a
+     * category this one cannot see, name or unfile — the picker resolves names from its own
+     * `categories.list`, so the field renders blank and the filter it sits behind matches nothing
+     * anybody can select. An id belonging to **nobody** does the same thing with no other workspace
+     * involved. Either way the register holds a reference to a row that is not there, which is
+     * exactly the state `categories.archive` exists to prevent from the other end.
+     *
+     * **Checked inside the caller's transaction, unlike `checkPhoto`.** A file lives in core and has
+     * to be asked for over the broker, so that check happens before a connection is taken — the rule
+     * `codeFormat` documents. A category is this module's own table one join away, so the honest
+     * place for it is the transaction that writes the row: it costs one indexed read, and it cannot
+     * be raced by somebody deleting the category, because nothing deletes one.
+     *
+     * An **archived** category is deliberately allowed. Archiving takes it out of every picker and
+     * leaves every asset already filed under it still naming it; refusing it here would mean an edit
+     * to an asset's location failed because of a category somebody tidied away last year, and it
+     * would make re-filing a batch of assets under an old category impossible for no gain.
+     */
+    private requireCategory;
+    get(tx: Tx, workspaceId: string, assetId: string): Promise<Row>;
+    create(tx: Tx, workspaceId: string, actorId: string | null, input: AssetCreateInput, format: CodeFormat): Promise<Written>;
+    /** Fields a person edits directly, and therefore the fields the timeline reports a diff for. */
+    private static readonly EDITABLE;
+    update(tx: Tx, workspaceId: string, actorId: string | null, assetId: string, input: AssetPatchInput): Promise<Written>;
+    /**
+     * @param repairsOn whether the workspace records repairs, read before the transaction opened.
+     * The "it is away for repair" refusal below tells somebody to go and use `repairs.complete`, and
+     * that procedure answers 404 in a workspace with the capability off — so the refusal would be an
+     * instruction to open a door that is not there, and the asset could never leave the register.
+     */
+    archive(tx: Tx, workspaceId: string, actorId: string | null, assetId: string, archived: boolean, repairsOn: boolean): Promise<Written>;
+}
+export {};
+//# sourceMappingURL=assets.d.ts.map

package/dist/server/services/assets.d.ts.map

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

package/dist/server/services/assets.js

@@ -0,0 +1,429 @@
+import { KernError, uuidv7 } from '@kernhq/kernel';
+import { and, asc, desc, eq, ilike, isNull, lt, or, sql } from 'drizzle-orm';
+import { alias } from 'drizzle-orm/pg-core';
+import { InventorySettings } from '../../contract/settings.js';
+import { assetHistory, assets, categories, counters } from '../schema.js';
+import { decodeMark, decodeSeqMark, encodeMark, encodeSeqMark } from './cursor.js';
+import { openRepairId } from './status.js';
+/** The wire shape: drizzle gives Date objects for timestamps, the contract promises ISO strings. */
+export function toAsset(row) {
+    return {
+        id: row.id,
+        workspaceId: row.workspaceId,
+        code: row.code,
+        name: row.name,
+        description: row.description,
+        categoryId: row.categoryId,
+        status: row.status,
+        custodianUserId: row.custodianUserId,
+        custodySince: row.custodySince?.toISOString() ?? null,
+        serialNumber: row.serialNumber,
+        location: row.location,
+        purchasedOn: row.purchasedOn ?? null,
+        purchasedFrom: row.purchasedFrom,
+        priceMinor: row.priceMinor,
+        currency: row.currency,
+        warrantyUntil: row.warrantyUntil ?? null,
+        photoFileId: row.photoFileId,
+        custom: row.custom ?? {},
+        createdAt: row.createdAt.toISOString(),
+        updatedAt: row.updatedAt.toISOString(),
+        archivedAt: row.archivedAt?.toISOString() ?? null,
+    };
+}
+/**
+ * The wire shape of one timeline entry. Drizzle's `jsonb` columns are nullable in the row and never
+ * null in the contract — `changes: []` and `data: {}` are what "nothing to say" looks like to a
+ * screen, where `null` is one more thing every caller has to remember to handle.
+ */
+export function toHistoryEntry(row) {
+    return {
+        id: row.id,
+        assetId: row.assetId,
+        actorId: row.actorId,
+        action: row.action,
+        changes: row.changes ?? [],
+        data: row.data ?? {},
+        occurredAt: row.occurredAt.toISOString(),
+    };
+}
+/**
+ * `%`, `_` and `\` are pattern syntax to `ilike`, not text.
+ *
+ * Unescaped, a search for `50%` matched every row in the workspace and a search for `_hair` matched
+ * "Chair" — both of which read as a broken search rather than as a clever one. Escaped rather than
+ * stripped: somebody typing a per-cent sign means the character.
+ */
+const contains = (q) => `%${q.replace(/[\\%_]/g, '\\$&')}%`;
+/**
+ * The one ordering a timeline has, named rather than left as a literal.
+ *
+ * The cursor codec binds a bookmark to the sort it was issued under and refuses it under any other,
+ * so a timeline needs a name for its sort even while there is only one — and the day a second one
+ * exists, every cursor already in a browser tab is refused rather than misread.
+ */
+const HISTORY_SORT = 'recent';
+/** Which column an ordering sorts on, for the list itself and for the bookmarked row alike. */
+const sortKey = (t, sort) => sort === 'name' ? t.name : sort === 'code' ? t.code : t.id;
+export class AssetService {
+    kernel;
+    notify;
+    constructor(kernel, notify) {
+        this.kernel = kernel;
+        this.notify = notify;
+    }
+    /**
+     * How this workspace spells an asset tag.
+     *
+     * **Called before the transaction opens, never inside one.** `kernel.settings.module` is a
+     * `core.settings.getModule` call over the broker, and awaiting a remote service while holding a
+     * pooled connection *and* the counter row lock is two failures waiting: the pool starves under
+     * concurrent creates, and a create fails outright whenever core is briefly away — which is the
+     * one thing `NotifyService`'s own docblock says a mutation here must never do.
+     */
+    async codeFormat(workspaceId) {
+        const settings = await this.kernel.settings.module(workspaceId, 'inventory', InventorySettings);
+        return { prefix: settings.assetCodePrefix, pad: settings.assetCodePad };
+    }
+    /**
+     * The next asset tag for a workspace.
+     *
+     * One narrow row per workspace and key, incremented under the insert's conflict lock — two
+     * concurrent creates each read the value their own statement returned, so codes stay unique
+     * without a retry loop. `INV-0042`, because people say asset tags out loud. Nothing in here
+     * leaves the database, which is what keeps the lock short.
+     */
+    async nextCode(tx, workspaceId, format) {
+        const [row] = await tx
+            .insert(counters)
+            .values({ workspaceId, key: 'asset_code', value: 1 })
+            .onConflictDoUpdate({
+            target: [counters.workspaceId, counters.key],
+            set: { value: sql `${counters.value} + 1` },
+        })
+            .returning();
+        return `${format.prefix}${String(row.value).padStart(format.pad, '0')}`;
+    }
+    async list(tx, input) {
+        const filters = [eq(assets.workspaceId, input.workspaceId)];
+        if (input.q) {
+            // A code is something somebody reads off a sticker; matching name, code and serial loosely
+            // matters more than word-splitting here. Full-text arrives with the core indexer.
+            const pattern = contains(input.q);
+            filters.push(or(ilike(assets.name, pattern), ilike(assets.code, pattern), ilike(sql `coalesce(${assets.serialNumber}, '')`, pattern)));
+        }
+        if (input.categoryId)
+            filters.push(eq(assets.categoryId, input.categoryId));
+        if (input.status)
+            filters.push(eq(assets.status, input.status));
+        if (input.custodianUserId)
+            filters.push(eq(assets.custodianUserId, input.custodianUserId));
+        if (!input.archived)
+            filters.push(isNull(assets.archivedAt));
+        /**
+         * `recent` sorts by id rather than by `created_at`: ids are uuidv7, so they carry the clock, and
+         * one indexed unique column is a cheaper and unambiguous page boundary than a timestamp two rows
+         * can share. Ordered to the millisecond and no finer — the kernel's `uuidv7()` fills its last
+         * ten bytes from `randomUUID()` with no counter — so two assets created inside one millisecond
+         * come back in a stable but arbitrary order relative to each other.
+         *
+         * **The timeline deliberately stopped accepting that and this list has not**, so the difference
+         * is worth stating rather than leaving as an inconsistency. `asset_history` is a record somebody
+         * argues from, and a millisecond there holds a create and its own first entry, so an arbitrary
+         * order is a lie about causation — it has a sequence of its own now (`schema.ts`, `seq`). A list
+         * is an ordering of things a person is browsing: nothing hangs on which of two assets imported
+         * in the same millisecond is shown first, and paging stays gapless either way because the id is
+         * unique. If that ever stops being true — a bulk import whose order somebody relies on — the
+         * fix is the same sequence, not a timestamp: `created_at` defaults to the *transaction's*
+         * `now()`, so one import shares it exactly.
+         *
+         * It is fatal for a test that expects creation order; see `inventory.int.test.ts`.
+         */
+        const column = sortKey(assets, input.sort);
+        const descending = input.sort === 'recent';
+        if (input.cursor) {
+            const mark = decodeMark(input.cursor, input.sort);
+            /**
+             * The sort key comes back out of the bookmarked row rather than out of the cursor, which is
+             * what keeps the cursor small and stops it disagreeing with the row it names. Scoped by
+             * `workspace_id` as well as by id, so a cursor cannot be used to probe another workspace's
+             * ordering — this module reaches the database as a superuser in `core`, with RLS bypassed.
+             *
+             * A row deleted between two pages leaves the subquery empty, the row comparison NULL and the
+             * page empty: the list simply ends. That is deliberate, and preferred to a 400 — somebody
+             * else archiving a row while you read is an ordinary race, not a malformed request, and an
+             * error toast on "Load more" would be a worse answer than a list that has run out.
+             */
+            const marker = alias(assets, 'page_marker');
+            const bookmarked = tx
+                .select({ key: sortKey(marker, input.sort), id: marker.id })
+                .from(marker)
+                .where(and(eq(marker.id, mark.i), eq(marker.workspaceId, input.workspaceId)));
+            filters.push(descending
+                ? sql `(${column}, ${assets.id}) < (${bookmarked})`
+                : sql `(${column}, ${assets.id}) > (${bookmarked})`);
+        }
+        const order = descending ? [desc(column), desc(assets.id)] : [asc(column), asc(assets.id)];
+        const rows = await tx
+            .select()
+            .from(assets)
+            .where(and(...filters))
+            .orderBy(...order)
+            .limit(input.limit + 1);
+        const items = rows.slice(0, input.limit);
+        const last = items.at(-1);
+        const nextCursor = rows.length > input.limit && last ? encodeMark({ i: last.id, s: input.sort }) : null;
+        return { items: items.map(toAsset), nextCursor };
+    }
+    /**
+     * The asset's own timeline, newest first, paged on the sequence the entries carry.
+     *
+     * **The ordering is `seq`, not `occurred_at` and not the id**, and the middle one of those three
+     * is the interesting correction.
+     *
+     * `occurred_at` was never a candidate: it defaults to `now()`, which is the *transaction*
+     * timestamp, so `create` writes the asset and its `created` entry with the same value and a page
+     * boundary between two entries that share a sort key repeats one and drops the other.
+     *
+     * The id looked like the answer and was only half of one. A uuidv7 is unique, so paging on it is
+     * gapless — but the kernel's `uuidv7()` carries the clock only to the millisecond and fills the
+     * rest from `randomUUID()` with no counter, so two entries written inside one millisecond sort by
+     * ten random bytes. Stable, so nothing was ever dropped or repeated; and arbitrary, so a timeline
+     * could show "Bruno removed the file" above "Bruno added the file". `seq` is a sequence: strictly
+     * increasing whatever the clock does, at whatever rate. `schema.ts` argues it at the column.
+     *
+     * The comparison is a single column because the sort key *is* the bookmark, so there is no
+     * bookmarked-row subquery here. The bookmark is still checked as a bounded positive integer and
+     * still bound to the sort it was issued under, because that is the codec's job and not this
+     * query's.
+     */
+    async history(tx, workspaceId, assetId, input) {
+        // 404 before paging: a timeline for an asset in another workspace must not answer with an
+        // empty list, which reads as "nothing has happened to it" rather than "it is not yours".
+        await this.get(tx, workspaceId, assetId);
+        const filters = [eq(assetHistory.workspaceId, workspaceId), eq(assetHistory.assetId, assetId)];
+        if (input.cursor)
+            filters.push(lt(assetHistory.seq, decodeSeqMark(input.cursor, HISTORY_SORT).n));
+        const rows = await tx
+            .select()
+            .from(assetHistory)
+            .where(and(...filters))
+            .orderBy(desc(assetHistory.seq))
+            .limit(input.limit + 1);
+        const items = rows.slice(0, input.limit);
+        const last = items.at(-1);
+        const nextCursor = rows.length > input.limit && last ? encodeSeqMark({ n: last.seq, s: HISTORY_SORT }) : null;
+        return { items: items.map(toHistoryEntry), nextCursor };
+    }
+    /**
+     * A category id in a request is a claim about a row in this workspace, and it is checked before
+     * it is stored.
+     *
+     * The same defect `photoFileId` had, one field over: `assets.create` and `assets.update` took
+     * `categoryId` on trust, so any uuid at all went into the column. Two things follow from that,
+     * and neither is theoretical. An id belonging to **another workspace** files an asset under a
+     * category this one cannot see, name or unfile — the picker resolves names from its own
+     * `categories.list`, so the field renders blank and the filter it sits behind matches nothing
+     * anybody can select. An id belonging to **nobody** does the same thing with no other workspace
+     * involved. Either way the register holds a reference to a row that is not there, which is
+     * exactly the state `categories.archive` exists to prevent from the other end.
+     *
+     * **Checked inside the caller's transaction, unlike `checkPhoto`.** A file lives in core and has
+     * to be asked for over the broker, so that check happens before a connection is taken — the rule
+     * `codeFormat` documents. A category is this module's own table one join away, so the honest
+     * place for it is the transaction that writes the row: it costs one indexed read, and it cannot
+     * be raced by somebody deleting the category, because nothing deletes one.
+     *
+     * An **archived** category is deliberately allowed. Archiving takes it out of every picker and
+     * leaves every asset already filed under it still naming it; refusing it here would mean an edit
+     * to an asset's location failed because of a category somebody tidied away last year, and it
+     * would make re-filing a batch of assets under an old category impossible for no gain.
+     */
+    async requireCategory(tx, workspaceId, categoryId) {
+        const [row] = await tx
+            .select({ id: categories.id })
+            .from(categories)
+            .where(and(eq(categories.workspaceId, workspaceId), eq(categories.id, categoryId)));
+        if (!row)
+            throw KernError.badRequest('That category is not one this workspace has.');
+    }
+    async get(tx, workspaceId, assetId) {
+        const [row] = await tx
+            .select()
+            .from(assets)
+            .where(and(eq(assets.workspaceId, workspaceId), eq(assets.id, assetId)));
+        if (!row)
+            throw KernError.notFound('Asset');
+        return row;
+    }
+    async create(tx, workspaceId, actorId, input, format) {
+        if (input.categoryId)
+            await this.requireCategory(tx, workspaceId, input.categoryId);
+        const [row] = await tx
+            .insert(assets)
+            .values({
+            id: uuidv7(),
+            workspaceId,
+            code: await this.nextCode(tx, workspaceId, format),
+            name: input.name,
+            description: input.description,
+            categoryId: input.categoryId ?? null,
+            serialNumber: input.serialNumber ?? null,
+            location: input.location ?? null,
+            purchasedFrom: input.purchasedFrom ?? null,
+            purchasedOn: input.purchasedOn ?? null,
+            warrantyUntil: input.warrantyUntil ?? null,
+            priceMinor: input.priceMinor ?? null,
+            currency: input.currency ?? null,
+            photoFileId: input.photoFileId ?? null,
+        })
+            .returning();
+        const activity = { workspaceId, assetId: row.id, actorId, action: 'created' };
+        await this.notify.history(tx, activity);
+        return { row: row, activity };
+    }
+    /** Fields a person edits directly, and therefore the fields the timeline reports a diff for. */
+    static EDITABLE = [
+        'name',
+        'description',
+        'categoryId',
+        'serialNumber',
+        'location',
+        'purchasedFrom',
+        'purchasedOn',
+        'warrantyUntil',
+        'priceMinor',
+        'currency',
+        'photoFileId',
+    ];
+    async update(tx, workspaceId, actorId, assetId, input) {
+        // Before the row is locked, because a refusal here has nothing to do with this asset and
+        // holding a row lock across a check that can throw is a lock held for no reason. `undefined`
+        // means the patch never mentioned a category and `null` means "unfile it"; neither is an id.
+        if (input.categoryId)
+            await this.requireCategory(tx, workspaceId, input.categoryId);
+        const [prev] = await tx
+            .select()
+            .from(assets)
+            .where(and(eq(assets.workspaceId, workspaceId), eq(assets.id, assetId)))
+            .for('update');
+        if (!prev)
+            throw KernError.notFound('Asset');
+        // `undefined` means "not mentioned"; `null` means "clear it". Collapsing the two is how an
+        // edit of one field quietly wipes the others.
+        const patch = { updatedAt: new Date() };
+        for (const field of AssetService.EDITABLE) {
+            const value = input[field];
+            patch[field] = value !== undefined ? (value ?? null) : prev[field];
+        }
+        /**
+         * A new warranty date earns a new notice.
+         *
+         * `warranty_notified_at` is the marker that stops the sweep saying the same thing every morning
+         * for a month; left alone here, extending a warranty by two years would mean nobody is ever told
+         * about the new date, because the row is already marked. Cleared only when the date itself
+         * moved — an edit to the name must not re-arm a notice somebody has already had.
+         */
+        if (patch.warrantyUntil !== prev.warrantyUntil)
+            patch.warrantyNotifiedAt = null;
+        // Filtered by workspace as well as by id. The `select … for update` three statements up already
+        // carries the predicate, so this is not reachable today — but `core` connects as a superuser
+        // with RLS bypassed, which makes the predicate in the statement the only barrier there is. A
+        // barrier that holds only because of what another statement happens to do is not one.
+        const [row] = await tx
+            .update(assets)
+            .set(patch)
+            .where(and(eq(assets.workspaceId, workspaceId), eq(assets.id, assetId)))
+            .returning();
+        const iso = (v) => (v instanceof Date ? v.toISOString() : v) ?? null;
+        const changes = AssetService.EDITABLE.filter((f) => iso(patch[f]) !== iso(prev[f])).map((f) => ({
+            field: f,
+            from: iso(prev[f]),
+            to: iso(patch[f]),
+        }));
+        if (changes.length === 0)
+            return { row: row, activity: null };
+        const activity = { workspaceId, assetId, actorId, action: 'updated', changes };
+        await this.notify.history(tx, activity);
+        return { row: row, activity };
+    }
+    /**
+     * @param repairsOn whether the workspace records repairs, read before the transaction opened.
+     * The "it is away for repair" refusal below tells somebody to go and use `repairs.complete`, and
+     * that procedure answers 404 in a workspace with the capability off — so the refusal would be an
+     * instruction to open a door that is not there, and the asset could never leave the register.
+     */
+    async archive(tx, workspaceId, actorId, assetId, archived, repairsOn) {
+        /**
+         * **Locked before either refusal is decided, because both of them are about a race.**
+         *
+         * The two checks below used to read the facts with a plain select, so the state they call
+         * impossible was reachable by simply doing the two things at once: an archive and a handover
+         * each read "nobody is holding it", both were allowed, and the register was left with an
+         * archived asset and an open custody period — the timeline showing a handover that never ended,
+         * and "what is Ada still holding?" quietly not counting it, because that question excludes
+         * archived rows. A check whose answer another transaction may already have changed is not a
+         * check; it is a comment.
+         *
+         * The lock is the same one `CustodyService.stamp` and `RepairService.restamp` take before they
+         * write `status`, which is what makes the ordering complete rather than one-sided: whichever
+         * transaction gets it second re-reads what the first committed, so an archive that arrives
+         * first makes the handover refuse, and a handover that arrives first makes the archive refuse.
+         * `lockAsset` in `status.ts` argues it in full.
+         */
+        const [locked] = await tx
+            .select()
+            .from(assets)
+            .where(and(eq(assets.workspaceId, workspaceId), eq(assets.id, assetId)))
+            .for('update');
+        if (!locked)
+            throw KernError.notFound('Asset');
+        if (archived) {
+            /**
+             * An item somebody is holding cannot leave the register.
+             *
+             * Somebody is answerable for the thing; taking it out of the register does not make them not
+             * answerable, it only stops anybody being able to find out. Two steps instead of one, and
+             * both of them mean something.
+             */
+            if (locked.custodianUserId)
+                throw KernError.conflict('Somebody is still holding this item. Take it back before archiving it.', 'inventory.asset.still_held');
+            /**
+             * An item that is at a repairer cannot leave the register either, and for the same reason as
+             * custody: money is committed and the thing is out of the building, so taking it out of the
+             * register does not settle that — it only stops anybody being able to find out.
+             *
+             * It also keeps two counts that must agree from drifting. `stats.summary` reports
+             * `byStatus.under_repair` from the cached status column, over live rows only, and
+             * `outForRepair` from the repair rows themselves; an archived asset with an open repair
+             * would appear in one and not the other, and neither number would be wrong.
+             *
+             * **Only while the workspace records repairs.** With the `repairs` capability off, this
+             * refusal names a procedure that answers 404 — so it was not a two-step instruction, it was a
+             * dead end: the repair could not be completed, so the asset could not be archived, so the
+             * item was stuck in the register for as long as the capability stayed off. A refusal that
+             * points at a door has to be withdrawn when the door is taken away. `stats.away` counts only
+             * live assets for the same reason, so the two counts still cannot disagree.
+             */
+            const open = repairsOn ? await openRepairId(tx, workspaceId, assetId) : undefined;
+            if (open)
+                throw KernError.conflict('This item is away for repair. Log the repair as returned before archiving it.', 'inventory.asset.under_repair');
+        }
+        const [row] = await tx
+            .update(assets)
+            .set({ archivedAt: archived ? new Date() : null, updatedAt: new Date() })
+            .where(and(eq(assets.workspaceId, workspaceId), eq(assets.id, assetId)))
+            .returning();
+        if (!row)
+            throw KernError.notFound('Asset');
+        const activity = {
+            workspaceId,
+            assetId,
+            actorId,
+            action: archived ? 'retired' : 'restored',
+        };
+        await this.notify.history(tx, activity);
+        return { row, activity };
+    }
+}
+//# sourceMappingURL=assets.js.map

package/dist/server/services/assets.js.map

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