@knpkv/herdr-work 0.7.2 → 0.8.1

package/dist/request-decision.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Deciding a goal's approval request inside the Work tab: what the host hands the board, and how
+ * a request's clock and bar read. Pure: the host owns the clock (`now`), the sending decision and
+ * the hub's answer; the board only presents them.
+ *
+ * The clock is display only. A request is decided or expired when the hub says so, never because
+ * the client clock reached zero: at zero it reads "expiring" and the bar stays usable, so the hub's
+ * refusal is what the reader sees.
+ *
+ * @module
+ */
+import type { WorkRequest } from "./model.js";
+/** One decision on the hub job behind a request. */
+export interface WorkRequestDecision {
+    readonly jobId: string;
+    readonly decision: "approve" | "reject";
+}
+/**
+ * The hub's own words about the last decision sent from this page, for the job it decided.
+ * `outcome` is `accepted` when the hub took the decision, `refused` when it answered no, and
+ * `uncertain` when the request failed in transit (a 5xx, an unreadable reply). An accepted answer
+ * keeps the bar off until the host's pending list drops the job; an uncertain one gives way to the
+ * outcome a later snapshot proves.
+ */
+export interface WorkRequestAnswer {
+    readonly jobId: string;
+    readonly outcome: "accepted" | "refused" | "uncertain";
+    readonly text: string;
+}
+/**
+ * What a host that can decide approvals gives the Work board. Without it (the LAN view, a host
+ * that is not the hub) every request keeps its link to the hub.
+ */
+export interface WorkRequestDecisions {
+    /**
+     * The expiry of a hub job this host lists as pending: a time, `null` for a pending job without
+     * one, `undefined` when this host cannot decide the job (not pending here, or another host's).
+     */
+    readonly expiresAt: (jobId: string) => number | null | undefined;
+    /**
+     * Hub time: the snapshot's `observedAt` plus the time elapsed locally since it arrived, re-read
+     * while any clock is visible. Expiries are hub times, so a browser clock ahead or behind must not
+     * move them.
+     */
+    readonly now: number;
+    /** The decision waiting for the hub, if any. */
+    readonly sending: WorkRequestDecision | null;
+    /** The hub's answer to the last decision sent from this page. */
+    readonly answer: WorkRequestAnswer | null;
+    readonly onDecision: (decision: WorkRequestDecision) => void;
+}
+/** Under this much time left the clock keeps seconds. */
+export declare const workRequestSoonMs: number;
+/** "52s", "4m 12s", "11m": seconds only matter under five minutes; "expiring" at zero. */
+export declare const workRequestClockText: (expiresAt: number, now: number) => string;
+/** How a request can be decided on this page. */
+export type WorkRequestDecidability = {
+    readonly _tag: "Here";
+    readonly jobId: string;
+    readonly expiresAt: number | null;
+} | {
+    readonly _tag: "Elsewhere";
+};
+/**
+ * A request is decided here when the host lists its hub job as pending, or when this page already
+ * sent a decision for it and holds the answer, so the bar and its announcement stay mounted after
+ * the request leaves the queue.
+ */
+export declare const workRequestDecidability: (request: WorkRequest, decisions: WorkRequestDecisions | undefined) => WorkRequestDecidability;
+//# sourceMappingURL=request-decision.d.ts.map

package/dist/request-decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-decision.d.ts","sourceRoot":"","sources":["../src/request-decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAA;CACxC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,CAAA;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAChE;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAA;IAC5C,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACzC,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAA;CAC7D;AAED,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,QAAa,CAAA;AAE3C,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB,cAAe,MAAM,OAAO,MAAM,KAAG,MAOrE,CAAA;AAED,iDAAiD;AACjD,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACpF;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAA;AAElC;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,YACzB,WAAW,aACT,oBAAoB,GAAG,SAAS,KAC1C,uBAOF,CAAA"}

package/dist/request-decision.js

@@ -0,0 +1,29 @@
+/** Under this much time left the clock keeps seconds. */
+export const workRequestSoonMs = 5 * 60_000;
+/** "52s", "4m 12s", "11m": seconds only matter under five minutes; "expiring" at zero. */
+export const workRequestClockText = (expiresAt, now) => {
+    const left = expiresAt - now;
+    if (left <= 0)
+        return "expiring";
+    const seconds = Math.floor(left / 1000);
+    const minutes = Math.floor(seconds / 60);
+    if (minutes === 0)
+        return `${seconds}s`;
+    return left < workRequestSoonMs ? `${minutes}m ${String(seconds % 60).padStart(2, "0")}s` : `${minutes}m`;
+};
+/**
+ * A request is decided here when the host lists its hub job as pending, or when this page already
+ * sent a decision for it and holds the answer, so the bar and its announcement stay mounted after
+ * the request leaves the queue.
+ */
+export const workRequestDecidability = (request, decisions) => {
+    const target = request.approvalTarget;
+    if (decisions === undefined || target === null)
+        return { _tag: "Elsewhere" };
+    const expiresAt = decisions.expiresAt(target.jobId);
+    const answered = decisions.answer?.jobId === target.jobId || decisions.sending?.jobId === target.jobId;
+    if (expiresAt === undefined && !answered)
+        return { _tag: "Elsewhere" };
+    return { _tag: "Here", expiresAt: expiresAt ?? null, jobId: target.jobId };
+};
+//# sourceMappingURL=request-decision.js.map

package/dist/request-decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-decision.js","sourceRoot":"","sources":["../src/request-decision.ts"],"names":[],"mappings":"AAuDA,yDAAyD;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAG,MAAM,CAAA;AAE3C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAAiB,EAAE,GAAW,EAAU,EAAE;IAC7E,MAAM,IAAI,GAAG,SAAS,GAAG,GAAG,CAAA;IAC5B,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,UAAU,CAAA;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAA;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAA;IACxC,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,GAAG,OAAO,GAAG,CAAA;IACvC,OAAO,IAAI,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAA;AAC3G,CAAC,CAAA;AAOD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,OAAoB,EACpB,SAA2C,EAClB,EAAE;IAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAA;IACrC,IAAI,SAAS,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAA;IAC5E,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACnD,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,KAAK,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC,OAAO,EAAE,KAAK,KAAK,MAAM,CAAC,KAAK,CAAA;IACtG,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAA;IACtE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAA;AAC5E,CAAC,CAAA"}

package/dist/store.js

@@ -2053,7 +2053,7 @@ export class WorkStore {
                             {
                                 id: jobId,
                                 kind: "status",
-                                summary: workReassignActivitySummary(decoded, jobId, decoded.approvalHash),
+                                summary: workReassignActivitySummary(decoded),
                                 occurredAt: at
                             }
                         ],
@@ -2284,7 +2284,7 @@ export class WorkStore {
                             {
                                 id: jobId,
                                 kind: "status",
-                                summary: workAbandonActivitySummary(decoded, jobId, decoded.approvalHash),
+                                summary: workAbandonActivitySummary(decoded),
                                 occurredAt: at
                             }
                         ],