@things-factory/worklist 10.1.248 → 10.1.250

package/dist-server/controllers/activity-read/participates.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Who may read one case - one instance, one thread, or one approval on it - by its id.
+ *
+ * The lists of every thread and every approval ask the activity-instance query privilege. Reading
+ * one by id cannot ask only that: the thread screen and the approval screen open the case for the
+ * people working on it, and most of them hold no management privilege. So the body decides.
+ *
+ * The domain comes first. Then the people the case is about:
+ *
+ *   the assignee of the thread (of any thread, when the case is the instance)
+ *   whoever raised the instance, wrote it, or started it
+ *   a holder of the instance's supervisory role
+ *   a holder of any one of the roles the instance waits for - they have to see it to pick it up (instance only)
+ *   every approver on the thread(s) - by person or by role, references included, and a delegator
+ *   keeps the row that was delegated
+ *
+ * Anyone else is refused by name (NOT_A_PARTICIPANT). A null would draw as "no such case" on the
+ * approval screen, which is untrue and sends the reader looking for something that exists.
+ *
+ * Kept free of entities and repositories so the rule can be tested on its own.
+ */
+export declare const NOT_A_PARTICIPANT = "not-a-participant";
+export type CaseFacts = {
+    domainId?: string;
+    assigneeIds: (string | undefined)[];
+    waitingRoleIds?: readonly string[];
+    issuerId?: string;
+    creatorId?: string;
+    starterId?: string;
+    supervisoryRoleId?: string;
+    approvals: {
+        approverId?: string;
+        approverRoleId?: string;
+    }[];
+};
+export type Reader = {
+    domainId?: string;
+    userId: string;
+    roleIds: readonly string[];
+};
+export declare function participates(facts: CaseFacts, reader: Reader): boolean;

package/dist-server/controllers/activity-read/participates.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Who may read one case - one instance, one thread, or one approval on it - by its id.
+ *
+ * The lists of every thread and every approval ask the activity-instance query privilege. Reading
+ * one by id cannot ask only that: the thread screen and the approval screen open the case for the
+ * people working on it, and most of them hold no management privilege. So the body decides.
+ *
+ * The domain comes first. Then the people the case is about:
+ *
+ *   the assignee of the thread (of any thread, when the case is the instance)
+ *   whoever raised the instance, wrote it, or started it
+ *   a holder of the instance's supervisory role
+ *   a holder of any one of the roles the instance waits for - they have to see it to pick it up (instance only)
+ *   every approver on the thread(s) - by person or by role, references included, and a delegator
+ *   keeps the row that was delegated
+ *
+ * Anyone else is refused by name (NOT_A_PARTICIPANT). A null would draw as "no such case" on the
+ * approval screen, which is untrue and sends the reader looking for something that exists.
+ *
+ * Kept free of entities and repositories so the rule can be tested on its own.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NOT_A_PARTICIPANT = void 0;
+exports.participates = participates;
+exports.NOT_A_PARTICIPANT = 'not-a-participant';
+function participates(facts, reader) {
+    if (!facts?.domainId || !reader?.domainId || facts.domainId !== reader.domainId)
+        return false;
+    const { userId } = reader;
+    /* An empty id on either side is nobody - an unassigned thread must not match a reader without one. */
+    if (!userId)
+        return false;
+    const roles = new Set(reader.roleIds);
+    const holds = (roleId) => !!roleId && roles.has(roleId);
+    if ([...(facts.assigneeIds || []), facts.issuerId, facts.creatorId, facts.starterId].includes(userId))
+        return true;
+    if (holds(facts.supervisoryRoleId) || (facts.waitingRoleIds || []).some(holds))
+        return true;
+    return (facts.approvals || []).some(one => one.approverId === userId || holds(one.approverRoleId));
+}
+//# sourceMappingURL=participates.js.map

package/dist-server/controllers/activity-read/participates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"participates.js","sourceRoot":"","sources":["../../../server/controllers/activity-read/participates.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAiBH,oCAcC;AA7BY,QAAA,iBAAiB,GAAG,mBAAmB,CAAA;AAepD,SAAgB,YAAY,CAAC,KAAgB,EAAE,MAAc;IAC3D,IAAI,CAAC,KAAK,EAAE,QAAQ,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAA;IAE7F,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IACzB,sGAAsG;IACtG,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IAEzB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,CAAC,MAAe,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAEhE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAA;IAClH,IAAI,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAE3F,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,KAAK,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAA;AACpG,CAAC","sourcesContent":["/**\n * Who may read one case - one instance, one thread, or one approval on it - by its id.\n *\n * The lists of every thread and every approval ask the activity-instance query privilege. Reading\n * one by id cannot ask only that: the thread screen and the approval screen open the case for the\n * people working on it, and most of them hold no management privilege. So the body decides.\n *\n * The domain comes first. Then the people the case is about:\n *\n *   the assignee of the thread (of any thread, when the case is the instance)\n *   whoever raised the instance, wrote it, or started it\n *   a holder of the instance's supervisory role\n *   a holder of any one of the roles the instance waits for - they have to see it to pick it up (instance only)\n *   every approver on the thread(s) - by person or by role, references included, and a delegator\n *   keeps the row that was delegated\n *\n * Anyone else is refused by name (NOT_A_PARTICIPANT). A null would draw as \"no such case\" on the\n * approval screen, which is untrue and sends the reader looking for something that exists.\n *\n * Kept free of entities and repositories so the rule can be tested on its own.\n */\n\nexport const NOT_A_PARTICIPANT = 'not-a-participant'\n\nexport type CaseFacts = {\n  domainId?: string\n  assigneeIds: (string | undefined)[]\n  waitingRoleIds?: readonly string[]\n  issuerId?: string\n  creatorId?: string\n  starterId?: string\n  supervisoryRoleId?: string\n  approvals: { approverId?: string; approverRoleId?: string }[]\n}\n\nexport type Reader = { domainId?: string; userId: string; roleIds: readonly string[] }\n\nexport function participates(facts: CaseFacts, reader: Reader): boolean {\n  if (!facts?.domainId || !reader?.domainId || facts.domainId !== reader.domainId) return false\n\n  const { userId } = reader\n  /* An empty id on either side is nobody - an unassigned thread must not match a reader without one. */\n  if (!userId) return false\n\n  const roles = new Set(reader.roleIds)\n  const holds = (roleId?: string) => !!roleId && roles.has(roleId)\n\n  if ([...(facts.assigneeIds || []), facts.issuerId, facts.creatorId, facts.starterId].includes(userId)) return true\n  if (holds(facts.supervisoryRoleId) || (facts.waitingRoleIds || []).some(holds)) return true\n\n  return (facts.approvals || []).some(one => one.approverId === userId || holds(one.approverRoleId))\n}\n"]}

package/dist-server/controllers/activity-thread/_abort.d.ts

@@ -0,0 +1,5 @@
+import { ActivityThread } from '../../service/activity-thread/activity-thread.js';
+export declare function _abort({ activityThread, reason }: {
+    activityThread: ActivityThread;
+    reason: string;
+}, context: ResolverContext): Promise<ActivityThread>;

package/dist-server/controllers/activity-thread/_abort.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._abort = _abort;
+const activity_thread_js_1 = require("../../service/activity-thread/activity-thread.js");
+const activity_approval_js_1 = require("../../service/activity-approval/activity-approval.js");
+const _abort_js_1 = require("../activity-approval/_abort.js");
+async function _abort({ activityThread, reason }, context) {
+    const { domain, user, tx } = context.state;
+    var repository = tx.getRepository(activity_thread_js_1.ActivityThread);
+    let activityApprovals = await tx.getRepository(activity_approval_js_1.ActivityApproval).find({
+        where: {
+            activityThread: { id: activityThread.id },
+            judgment: activity_approval_js_1.ActivityApprovalJudgment.Pending
+        }
+    });
+    /*
+      Actions to be processed when a activity thread is aborted
+      - All related activity approvals must be aborted.
+    */
+    for (let activityApproval of activityApprovals) {
+        await (0, _abort_js_1._abort)({
+            activityApproval,
+            comment: reason
+        }, context);
+    }
+    return await repository.save({
+        ...activityThread,
+        reason,
+        state: activity_thread_js_1.ActivityThreadStatus.Aborted,
+        transaction: 'abort',
+        updater: user,
+        terminatedAt: new Date(),
+        terminator: user
+    });
+}
+//# sourceMappingURL=_abort.js.map

package/dist-server/controllers/activity-thread/_abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_abort.js","sourceRoot":"","sources":["../../../server/controllers/activity-thread/_abort.ts"],"names":[],"mappings":";;AAIA,wBAsCC;AA1CD,yFAAuG;AACvG,+FAAiH;AACjH,8DAAgF;AAEzE,KAAK,UAAU,MAAM,CAC1B,EAAE,cAAc,EAAE,MAAM,EAAsD,EAC9E,OAAwB;IAExB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAE1C,IAAI,UAAU,GAAG,EAAE,CAAC,aAAa,CAAC,mCAAc,CAAC,CAAA;IAEjD,IAAI,iBAAiB,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,uCAAgB,CAAC,CAAC,IAAI,CAAC;QACpE,KAAK,EAAE;YACL,cAAc,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,EAAE,EAAE;YACzC,QAAQ,EAAE,+CAAwB,CAAC,OAAO;SAC3C;KACF,CAAC,CAAA;IAEF;;;MAGE;IACF,KAAK,IAAI,gBAAgB,IAAI,iBAAiB,EAAE,CAAC;QAC/C,MAAM,IAAA,kBAAqB,EACzB;YACE,gBAAgB;YAChB,OAAO,EAAE,MAAM;SAChB,EACD,OAAO,CACR,CAAA;IACH,CAAC;IAED,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC;QAC3B,GAAG,cAAc;QACjB,MAAM;QACN,KAAK,EAAE,yCAAoB,CAAC,OAAO;QACnC,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,IAAI,IAAI,EAAE;QACxB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAA;AACJ,CAAC","sourcesContent":["import { ActivityThread, ActivityThreadStatus } from '../../service/activity-thread/activity-thread.js'\nimport { ActivityApproval, ActivityApprovalJudgment } from '../../service/activity-approval/activity-approval.js'\nimport { _abort as abortActivityApproval } from '../activity-approval/_abort.js'\n\nexport async function _abort(\n  { activityThread, reason }: { activityThread: ActivityThread; reason: string },\n  context: ResolverContext\n): Promise<ActivityThread> {\n  const { domain, user, tx } = context.state\n\n  var repository = tx.getRepository(ActivityThread)\n\n  let activityApprovals = await tx.getRepository(ActivityApproval).find({\n    where: {\n      activityThread: { id: activityThread.id },\n      judgment: ActivityApprovalJudgment.Pending\n    }\n  })\n\n  /* \n    Actions to be processed when a activity thread is aborted\n    - All related activity approvals must be aborted.\n  */\n  for (let activityApproval of activityApprovals) {\n    await abortActivityApproval(\n      {\n        activityApproval,\n        comment: reason\n      },\n      context\n    )\n  }\n\n  return await repository.save({\n    ...activityThread,\n    reason,\n    state: ActivityThreadStatus.Aborted,\n    transaction: 'abort',\n    updater: user,\n    terminatedAt: new Date(),\n    terminator: user\n  })\n}\n"]}

package/dist-server/controllers/activity-thread/abort.d.ts

@@ -0,0 +1,5 @@
+import { ActivityThread } from '../../service/activity-thread/activity-thread.js';
+export declare function abort({ id, reason }: {
+    id: string;
+    reason: string;
+}, context: ResolverContext): Promise<ActivityThread>;

package/dist-server/controllers/activity-thread/abort.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.abort = abort;
+const activity_thread_js_1 = require("../../service/activity-thread/activity-thread.js");
+const common_js_1 = require("../common.js");
+const _abort_js_1 = require("./_abort.js");
+const check_authority_js_1 = require("./check-authority.js");
+async function abort({ id, reason }, context) {
+    const { domain, user, tx } = context.state;
+    var repository = tx.getRepository(activity_thread_js_1.ActivityThread);
+    var activityThread = await repository.findOne({
+        where: { domain: { id: domain.id }, id },
+        relations: ['domain', 'activityInstance', 'assignee', 'creator', 'updater']
+    });
+    if (!activityThread) {
+        throw new Error(context.t('error.activity-thread not found', {
+            activityThread: id
+        }));
+    }
+    // Stopping is for the holder, never a way to claim and destroy an unassigned pool item.
+    if (!activityThread.assigneeId || activityThread.assigneeId !== user.id) {
+        throw new Error(context.t('error.not authorized to handle this task'));
+    }
+    await (0, check_authority_js_1.checkAuthority)(activityThread, context);
+    if (['ended', 'aborted'].includes(activityThread.activityInstance?.state)) {
+        throw new Error(context.t('error.activity-instance is already terminated', { id: activityThread.activityInstanceId }));
+    }
+    /*
+      Prerequisites for a activity thread to Be Aborted.
+      - The previous state of the activity thread must not be End or Aborted.
+    */
+    if (activityThread.state == activity_thread_js_1.ActivityThreadStatus.Aborted || activityThread.state == activity_thread_js_1.ActivityThreadStatus.Ended) {
+        throw new Error(context.t(`error.activity-thread is already terminated`, {
+            id,
+            state: activityThread.state
+        }));
+    }
+    if (!activityThread.startedAt) {
+        activityThread.startedAt = new Date();
+    }
+    const result = await (0, _abort_js_1._abort)({ activityThread, reason }, context);
+    await (0, common_js_1.updateActivityInstanceState)(activityThread.activityInstanceId, { causedBy: [result] }, context);
+    return result;
+}
+//# sourceMappingURL=abort.js.map

package/dist-server/controllers/activity-thread/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../../../server/controllers/activity-thread/abort.ts"],"names":[],"mappings":";;AAKA,sBAoDC;AAzDD,yFAAuG;AACvG,4CAA0D;AAC1D,2CAAoC;AACpC,6DAAqD;AAE9C,KAAK,UAAU,KAAK,CACzB,EAAE,EAAE,EAAE,MAAM,EAAkC,EAC9C,OAAwB;IAExB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAE1C,IAAI,UAAU,GAAG,EAAE,CAAC,aAAa,CAAC,mCAAc,CAAC,CAAA;IAEjD,IAAI,cAAc,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC;QAC5C,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;QACxC,SAAS,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC;KAC5E,CAAC,CAAA;IAEF,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,OAAO,CAAC,CAAC,CAAC,iCAAiC,EAAE;YAC3C,cAAc,EAAE,EAAE;SACnB,CAAC,CACH,CAAA;IACH,CAAC;IAED,wFAAwF;IACxF,IAAI,CAAC,cAAc,CAAC,UAAU,IAAI,cAAc,CAAC,UAAU,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0CAA0C,CAAC,CAAC,CAAA;IACxE,CAAC;IACD,MAAM,IAAA,mCAAc,EAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IAC7C,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,+CAA+C,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAA;IACxH,CAAC;IAED;;;MAGE;IACF,IAAI,cAAc,CAAC,KAAK,IAAI,yCAAoB,CAAC,OAAO,IAAI,cAAc,CAAC,KAAK,IAAI,yCAAoB,CAAC,KAAK,EAAE,CAAC;QAC/G,MAAM,IAAI,KAAK,CACb,OAAO,CAAC,CAAC,CAAC,6CAA6C,EAAE;YACvD,EAAE;YACF,KAAK,EAAE,cAAc,CAAC,KAAK;SAC5B,CAAC,CACH,CAAA;IACH,CAAC;IAED,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;QAC9B,cAAc,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAA;IACvC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAM,EAAC,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAA;IAEhE,MAAM,IAAA,uCAA2B,EAAC,cAAc,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAErG,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import { ActivityThread, ActivityThreadStatus } from '../../service/activity-thread/activity-thread.js'\nimport { updateActivityInstanceState } from '../common.js'\nimport { _abort } from './_abort.js'\nimport { checkAuthority } from './check-authority.js'\n\nexport async function abort(\n  { id, reason }: { id: string; reason: string },\n  context: ResolverContext\n): Promise<ActivityThread> {\n  const { domain, user, tx } = context.state\n\n  var repository = tx.getRepository(ActivityThread)\n\n  var activityThread = await repository.findOne({\n    where: { domain: { id: domain.id }, id },\n    relations: ['domain', 'activityInstance', 'assignee', 'creator', 'updater']\n  })\n\n  if (!activityThread) {\n    throw new Error(\n      context.t('error.activity-thread not found', {\n        activityThread: id\n      })\n    )\n  }\n\n  // Stopping is for the holder, never a way to claim and destroy an unassigned pool item.\n  if (!activityThread.assigneeId || activityThread.assigneeId !== user.id) {\n    throw new Error(context.t('error.not authorized to handle this task'))\n  }\n  await checkAuthority(activityThread, context)\n  if (['ended', 'aborted'].includes(activityThread.activityInstance?.state)) {\n    throw new Error(context.t('error.activity-instance is already terminated', { id: activityThread.activityInstanceId }))\n  }\n\n  /* \n    Prerequisites for a activity thread to Be Aborted.\n    - The previous state of the activity thread must not be End or Aborted.\n  */\n  if (activityThread.state == ActivityThreadStatus.Aborted || activityThread.state == ActivityThreadStatus.Ended) {\n    throw new Error(\n      context.t(`error.activity-thread is already terminated`, {\n        id,\n        state: activityThread.state\n      })\n    )\n  }\n\n  if (!activityThread.startedAt) {\n    activityThread.startedAt = new Date()\n  }\n\n  const result = await _abort({ activityThread, reason }, context)\n\n  await updateActivityInstanceState(activityThread.activityInstanceId, { causedBy: [result] }, context)\n\n  return result\n}\n"]}

package/dist-server/controllers/activity-thread/check-authority.d.ts

@@ -0,0 +1,2 @@
+import { ActivityThread } from '../../service/activity-thread/activity-thread.js';
+export declare function checkAuthority(activityThread: ActivityThread, context: ResolverContext): Promise<void>;

package/dist-server/controllers/activity-thread/check-authority.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkAuthority = checkAuthority;
+const shell_1 = require("@things-factory/shell");
+const auth_base_1 = require("@things-factory/auth-base");
+const activity_thread_js_1 = require("../../service/activity-thread/activity-thread.js");
+const activity_instance_js_1 = require("../../service/activity-instance/activity-instance.js");
+const assignee_pool_js_1 = require("../../service/activity-instance/assignee-pool.js");
+const common_js_1 = require("../common.js");
+async function checkAuthority(activityThread, context) {
+    const { user, tx } = context.state;
+    if (activityThread.assigneeId && activityThread.assigneeId === user.id) {
+        return;
+    }
+    if (activityThread.state == activity_thread_js_1.ActivityThreadStatus.Unassigned) {
+        /*
+         * Claiming the pool's waiting thread. The case is held first - the order pick and a pool assign take
+         * (activity-instance/pick.ts, assign.ts) - and the thread is read again under it. The thread handed in
+         * was read before anything was held: someone else may have claimed it since, or a manager moved the
+         * case to another role's pool, and what this claims must be what is there now.
+         *
+         * The claimer gets this very thread; a case still short of people leaves the rest of the pool a new
+         * waiting one (common.ts leaveTheRestOfThePoolOneWaiting) - the same as pick.
+         */
+        const activityInstance = await (0, shell_1.getRepository)(activity_instance_js_1.ActivityInstance, tx).findOne({
+            where: { id: activityThread.activityInstanceId },
+            ...((0, shell_1.writeLockSupported)(tx) ? { lock: { mode: 'pessimistic_write' } } : {})
+        });
+        /*
+         * All the case's threads, not only this one: whether the rest of the pool is left a waiting thread depends
+         * on how many are held. A locking read is a current read - a plain one may answer from the snapshot taken
+         * before the wait.
+         */
+        const threads = await (0, shell_1.getRepository)(activity_thread_js_1.ActivityThread, tx).find({
+            where: { activityInstance: { id: activityThread.activityInstanceId } },
+            ...((0, shell_1.writeLockSupported)(tx) ? { lock: { mode: 'pessimistic_write' } } : {})
+        });
+        const now = threads.find(thread => thread.id === activityThread.id);
+        if (now?.state !== activity_thread_js_1.ActivityThreadStatus.Unassigned) {
+            throw new Error(context.t('error.activity-approval taken by someone else', { activityApproval: activityThread.id }));
+        }
+        /* One person, one thread of a case - as pick refuses it (activity-instance/pick.ts). */
+        if (threads.some(thread => thread.assigneeId === user.id)) {
+            throw new Error(context.t('error.activity-instance already yours', { id: activityInstance.id }));
+        }
+        const poolIds = (0, assignee_pool_js_1.poolIdsOf)(activityInstance);
+        if (poolIds.length) {
+            const roles = (await (0, shell_1.getRepository)(auth_base_1.User, tx).findOne({
+                where: { id: user.id },
+                relations: ['roles']
+            }))?.roles;
+            /* Any one of the pool's roles is enough (ADR-0091 decision 9). */
+            if ((0, assignee_pool_js_1.holdsAnyOf)((roles || []).map(role => role.id), poolIds)) {
+                activityThread.assignee = user;
+                activityThread.state = activity_thread_js_1.ActivityThreadStatus.Assigned;
+                /* The caller writes this thread; the count below reads it as held already. */
+                Object.assign(now, { assignee: user, state: activity_thread_js_1.ActivityThreadStatus.Assigned });
+                await (0, common_js_1.leaveTheRestOfThePoolOneWaiting)('claim', activityInstance, threads, context);
+                return;
+            }
+        }
+    }
+    throw new Error(context.t(`error.not authorized to handle this task`));
+}
+//# sourceMappingURL=check-authority.js.map

package/dist-server/controllers/activity-thread/check-authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-authority.js","sourceRoot":"","sources":["../../../server/controllers/activity-thread/check-authority.ts"],"names":[],"mappings":"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","sourcesContent":["import { getRepository, writeLockSupported } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\nimport { ActivityThread, ActivityThreadStatus } from '../../service/activity-thread/activity-thread.js'\nimport { ActivityInstance } from '../../service/activity-instance/activity-instance.js'\nimport { holdsAnyOf, poolIdsOf } from '../../service/activity-instance/assignee-pool.js'\nimport { leaveTheRestOfThePoolOneWaiting } from '../common.js'\n\nexport async function checkAuthority(activityThread: ActivityThread, context: ResolverContext) {\n  const { user, tx } = context.state\n\n  if (activityThread.assigneeId && activityThread.assigneeId === user.id) {\n    return\n  }\n\n  if (activityThread.state == ActivityThreadStatus.Unassigned) {\n    /*\n     * Claiming the pool's waiting thread. The case is held first - the order pick and a pool assign take\n     * (activity-instance/pick.ts, assign.ts) - and the thread is read again under it. The thread handed in\n     * was read before anything was held: someone else may have claimed it since, or a manager moved the\n     * case to another role's pool, and what this claims must be what is there now.\n     *\n     * The claimer gets this very thread; a case still short of people leaves the rest of the pool a new\n     * waiting one (common.ts leaveTheRestOfThePoolOneWaiting) - the same as pick.\n     */\n    const activityInstance = await getRepository(ActivityInstance, tx).findOne({\n      where: { id: activityThread.activityInstanceId },\n      ...(writeLockSupported(tx) ? { lock: { mode: 'pessimistic_write' as const } } : {})\n    })\n\n    /*\n     * All the case's threads, not only this one: whether the rest of the pool is left a waiting thread depends\n     * on how many are held. A locking read is a current read - a plain one may answer from the snapshot taken\n     * before the wait.\n     */\n    const threads = await getRepository(ActivityThread, tx).find({\n      where: { activityInstance: { id: activityThread.activityInstanceId } },\n      ...(writeLockSupported(tx) ? { lock: { mode: 'pessimistic_write' as const } } : {})\n    })\n    const now = threads.find(thread => thread.id === activityThread.id)\n\n    if (now?.state !== ActivityThreadStatus.Unassigned) {\n      throw new Error(context.t('error.activity-approval taken by someone else', { activityApproval: activityThread.id }))\n    }\n\n    /* One person, one thread of a case - as pick refuses it (activity-instance/pick.ts). */\n    if (threads.some(thread => thread.assigneeId === user.id)) {\n      throw new Error(context.t('error.activity-instance already yours', { id: activityInstance.id }))\n    }\n\n    const poolIds = poolIdsOf(activityInstance)\n\n    if (poolIds.length) {\n      const roles = (\n        await getRepository(User, tx).findOne({\n          where: { id: user.id },\n          relations: ['roles']\n        })\n      )?.roles\n\n      /* Any one of the pool's roles is enough (ADR-0091 decision 9). */\n      if (holdsAnyOf((roles || []).map(role => role.id), poolIds)) {\n        activityThread.assignee = user\n        activityThread.state = ActivityThreadStatus.Assigned\n\n        /* The caller writes this thread; the count below reads it as held already. */\n        Object.assign(now, { assignee: user, state: ActivityThreadStatus.Assigned })\n        await leaveTheRestOfThePoolOneWaiting('claim', activityInstance, threads, context)\n\n        return\n      }\n    }\n  }\n\n  throw new Error(context.t(`error.not authorized to handle this task`))\n}\n"]}

package/dist-server/controllers/activity-thread/delegate.d.ts

@@ -0,0 +1,7 @@
+import { ActivityThread } from '../../service/activity-thread/activity-thread.js';
+export declare function delegate({ id, assignee, dueAt, reason }: {
+    id: string;
+    assignee?: object;
+    dueAt?: Date;
+    reason?: string;
+}, context: ResolverContext): Promise<ActivityThread>;

package/dist-server/controllers/activity-thread/delegate.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delegate = delegate;
+const activity_thread_js_1 = require("../../service/activity-thread/activity-thread.js");
+const common_js_1 = require("../common.js");
+const check_authority_js_1 = require("./check-authority.js");
+const auth_base_1 = require("@things-factory/auth-base");
+const delegation_js_1 = require("../activity-approval/delegation.js");
+async function delegate({ id, assignee, dueAt, reason }, context) {
+    const { domain, user, tx } = context.state;
+    const repository = tx.getRepository(activity_thread_js_1.ActivityThread);
+    var activityThread = await repository.findOne({
+        where: { domain: { id: domain.id }, id }
+    });
+    if (!activityThread) {
+        throw new Error(context.t('error.activity-thread not found', {
+            activityThread: id
+        }));
+    }
+    await (0, check_authority_js_1.checkAuthority)(activityThread, context);
+    /*
+      Prerequisites for a activity thread to Be Delegated.
+      - The previous state of the activity thread should be assigned or started.
+    */
+    if (activityThread.state !== activity_thread_js_1.ActivityThreadStatus.Assigned && activityThread.state !== activity_thread_js_1.ActivityThreadStatus.Started) {
+        throw new Error(context.t(`error.activity-thread is already terminated`, {
+            id,
+            actual: activityThread.state
+        }));
+    }
+    /*
+     * The receiver is looked up, not taken as sent. The client's object was saved as it came - any id,
+     * of any tenant, active or not - so a thread could be handed to someone outside this domain, whose
+     * to-do list reads their own domain and would never show it.
+     */
+    const receiverId = assignee?.id;
+    const receiver = receiverId
+        ? await tx.getRepository(auth_base_1.User).findOne({ where: { id: receiverId, status: auth_base_1.UserStatus.ACTIVATED }, relations: ['domains'] })
+        : null;
+    if (!receiver) {
+        throw new Error(context.t(`error.user not found`));
+    }
+    const refusal = (0, delegation_js_1.handOverRefusal)({
+        fromUserId: user.id,
+        toUserId: receiver.id,
+        toInDomain: (receiver.domains || []).some(one => one.id === domain.id)
+    });
+    if (refusal) {
+        throw Object.assign(new Error(context.t(delegation_js_1.DELEGATION_REFUSAL_KEYS[refusal])), { code: refusal });
+    }
+    if (dueAt) {
+        activityThread.dueAt = dueAt;
+    }
+    const result = await repository.save({
+        ...activityThread,
+        assignee: receiver,
+        transaction: 'delegate',
+        reason,
+        state: activity_thread_js_1.ActivityThreadStatus.Assigned,
+        updater: user,
+        assignedAt: new Date()
+    });
+    await (0, common_js_1.updateActivityInstanceState)(activityThread.activityInstanceId, { causedBy: [result] }, context);
+    return result;
+}
+//# sourceMappingURL=delegate.js.map

package/dist-server/controllers/activity-thread/delegate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.js","sourceRoot":"","sources":["../../../server/controllers/activity-thread/delegate.ts"],"names":[],"mappings":"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","sourcesContent":["import { ActivityThread, ActivityThreadStatus } from '../../service/activity-thread/activity-thread.js'\nimport { updateActivityInstanceState } from '../common.js'\nimport { checkAuthority } from './check-authority.js'\nimport { User, UserStatus } from '@things-factory/auth-base'\nimport { DELEGATION_REFUSAL_KEYS, handOverRefusal } from '../activity-approval/delegation.js'\n\nexport async function delegate(\n  {\n    id,\n    assignee,\n    dueAt,\n    reason\n  }: {\n    id: string\n    assignee?: object\n    dueAt?: Date\n    reason?: string\n  },\n  context: ResolverContext\n): Promise<ActivityThread> {\n  const { domain, user, tx } = context.state\n\n  const repository = tx.getRepository(ActivityThread)\n\n  var activityThread = await repository.findOne({\n    where: { domain: { id: domain.id }, id }\n  })\n\n  if (!activityThread) {\n    throw new Error(\n      context.t('error.activity-thread not found', {\n        activityThread: id\n      })\n    )\n  }\n\n  await checkAuthority(activityThread, context)\n\n  /* \n    Prerequisites for a activity thread to Be Delegated.\n    - The previous state of the activity thread should be assigned or started.\n  */\n  if (activityThread.state !== ActivityThreadStatus.Assigned && activityThread.state !== ActivityThreadStatus.Started) {\n    throw new Error(\n      context.t(`error.activity-thread is already terminated`, {\n        id,\n        actual: activityThread.state\n      })\n    )\n  }\n\n  /*\n   * The receiver is looked up, not taken as sent. The client's object was saved as it came - any id,\n   * of any tenant, active or not - so a thread could be handed to someone outside this domain, whose\n   * to-do list reads their own domain and would never show it.\n   */\n  const receiverId = (assignee as any)?.id\n  const receiver = receiverId\n    ? await tx.getRepository(User).findOne({ where: { id: receiverId, status: UserStatus.ACTIVATED }, relations: ['domains'] })\n    : null\n\n  if (!receiver) {\n    throw new Error(context.t(`error.user not found`))\n  }\n\n  const refusal = handOverRefusal({\n    fromUserId: user.id,\n    toUserId: receiver.id,\n    toInDomain: (receiver.domains || []).some(one => one.id === domain.id)\n  })\n\n  if (refusal) {\n    throw Object.assign(new Error(context.t(DELEGATION_REFUSAL_KEYS[refusal])), { code: refusal })\n  }\n\n  if (dueAt) {\n    activityThread.dueAt = dueAt\n  }\n\n  const result = await repository.save({\n    ...activityThread,\n    assignee: receiver,\n    transaction: 'delegate',\n    reason,\n    state: ActivityThreadStatus.Assigned,\n    updater: user,\n    assignedAt: new Date()\n  })\n\n  await updateActivityInstanceState(activityThread.activityInstanceId, { causedBy: [result] }, context)\n\n  return result\n}\n"]}

package/dist-server/controllers/activity-thread/end.d.ts

@@ -0,0 +1,6 @@
+import { ActivityThread } from '../../service/activity-thread/activity-thread.js';
+export declare function end({ id, output, reason }: {
+    id: string;
+    output?: object;
+    reason?: string;
+}, context: ResolverContext): Promise<ActivityThread>;

package/dist-server/controllers/activity-thread/end.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.end = end;
+const activity_thread_js_1 = require("../../service/activity-thread/activity-thread.js");
+const common_js_1 = require("../common.js");
+const check_authority_js_1 = require("./check-authority.js");
+async function end({ id, output, reason }, context) {
+    const { domain, user, tx } = context.state;
+    const repository = tx.getRepository(activity_thread_js_1.ActivityThread);
+    var activityThread = await repository.findOne({
+        where: { domain: { id: domain.id }, id }
+    });
+    if (!activityThread) {
+        throw new Error(context.t('error.activity-thread not found', {
+            activityThread: id
+        }));
+    }
+    await (0, check_authority_js_1.checkAuthority)(activityThread, context);
+    /*
+      Prerequisites for a activity thread to Be End.
+      - The previous state of the activity thread must not be End or End.
+    */
+    if (activityThread.state == activity_thread_js_1.ActivityThreadStatus.Aborted || activityThread.state == activity_thread_js_1.ActivityThreadStatus.Ended) {
+        throw new Error(context.t(`error.activity-thread is already terminated`, {
+            id,
+            actual: activityThread.state
+        }));
+    }
+    if (!activityThread.startedAt) {
+        activityThread.startedAt = new Date();
+    }
+    activityThread = await repository.save({
+        ...activityThread,
+        reason,
+        output,
+        transaction: 'end',
+        state: activity_thread_js_1.ActivityThreadStatus.Ended,
+        updater: user,
+        terminatedAt: new Date()
+    });
+    await (0, common_js_1.updateActivityInstanceState)(activityThread.activityInstanceId, { causedBy: [activityThread] }, context);
+    return activityThread;
+}
+//# sourceMappingURL=end.js.map

package/dist-server/controllers/activity-thread/end.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"end.js","sourceRoot":"","sources":["../../../server/controllers/activity-thread/end.ts"],"names":[],"mappings":";;AAIA,kBAoDC;AAxDD,yFAAuG;AACvG,4CAA0D;AAC1D,6DAAqD;AAE9C,KAAK,UAAU,GAAG,CACvB,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAoD,EACxE,OAAwB;IAExB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAE1C,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,CAAC,mCAAc,CAAC,CAAA;IAEnD,IAAI,cAAc,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC;QAC5C,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;KACzC,CAAC,CAAA;IAEF,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,OAAO,CAAC,CAAC,CAAC,iCAAiC,EAAE;YAC3C,cAAc,EAAE,EAAE;SACnB,CAAC,CACH,CAAA;IACH,CAAC;IAED,MAAM,IAAA,mCAAc,EAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IAE7C;;;MAGE;IACF,IAAI,cAAc,CAAC,KAAK,IAAI,yCAAoB,CAAC,OAAO,IAAI,cAAc,CAAC,KAAK,IAAI,yCAAoB,CAAC,KAAK,EAAE,CAAC;QAC/G,MAAM,IAAI,KAAK,CACb,OAAO,CAAC,CAAC,CAAC,6CAA6C,EAAE;YACvD,EAAE;YACF,MAAM,EAAE,cAAc,CAAC,KAAK;SAC7B,CAAC,CACH,CAAA;IACH,CAAC;IAED,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;QAC9B,cAAc,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAA;IACvC,CAAC;IAED,cAAc,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC;QACrC,GAAG,cAAc;QACjB,MAAM;QACN,MAAM;QACN,WAAW,EAAE,KAAK;QAClB,KAAK,EAAE,yCAAoB,CAAC,KAAK;QACjC,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,IAAI,IAAI,EAAE;KACzB,CAAC,CAAA;IAEF,MAAM,IAAA,uCAA2B,EAAC,cAAc,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAE7G,OAAO,cAAc,CAAA;AACvB,CAAC","sourcesContent":["import { ActivityThread, ActivityThreadStatus } from '../../service/activity-thread/activity-thread.js'\nimport { updateActivityInstanceState } from '../common.js'\nimport { checkAuthority } from './check-authority.js'\n\nexport async function end(\n  { id, output, reason }: { id: string; output?: object; reason?: string },\n  context: ResolverContext\n): Promise<ActivityThread> {\n  const { domain, user, tx } = context.state\n\n  const repository = tx.getRepository(ActivityThread)\n\n  var activityThread = await repository.findOne({\n    where: { domain: { id: domain.id }, id }\n  })\n\n  if (!activityThread) {\n    throw new Error(\n      context.t('error.activity-thread not found', {\n        activityThread: id\n      })\n    )\n  }\n\n  await checkAuthority(activityThread, context)\n\n  /* \n    Prerequisites for a activity thread to Be End.\n    - The previous state of the activity thread must not be End or End.\n  */\n  if (activityThread.state == ActivityThreadStatus.Aborted || activityThread.state == ActivityThreadStatus.Ended) {\n    throw new Error(\n      context.t(`error.activity-thread is already terminated`, {\n        id,\n        actual: activityThread.state\n      })\n    )\n  }\n\n  if (!activityThread.startedAt) {\n    activityThread.startedAt = new Date()\n  }\n\n  activityThread = await repository.save({\n    ...activityThread,\n    reason,\n    output,\n    transaction: 'end',\n    state: ActivityThreadStatus.Ended,\n    updater: user,\n    terminatedAt: new Date()\n  })\n\n  await updateActivityInstanceState(activityThread.activityInstanceId, { causedBy: [activityThread] }, context)\n\n  return activityThread\n}\n"]}

package/dist-server/controllers/activity-thread/index.d.ts

@@ -0,0 +1,7 @@
+export * from './delegate.js';
+export * from './abort.js';
+export * from './end.js';
+export * from './submit.js';
+export * from './save.js';
+export * from './start.js';
+export * from './restart.js';

package/dist-server/controllers/activity-thread/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./delegate.js"), exports);
+tslib_1.__exportStar(require("./abort.js"), exports);
+tslib_1.__exportStar(require("./end.js"), exports);
+tslib_1.__exportStar(require("./submit.js"), exports);
+tslib_1.__exportStar(require("./save.js"), exports);
+tslib_1.__exportStar(require("./start.js"), exports);
+tslib_1.__exportStar(require("./restart.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist-server/controllers/activity-thread/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/controllers/activity-thread/index.ts"],"names":[],"mappings":";;;AAAA,wDAA6B;AAC7B,qDAA0B;AAC1B,mDAAwB;AACxB,sDAA2B;AAC3B,oDAAyB;AACzB,qDAA0B;AAC1B,uDAA4B","sourcesContent":["export * from './delegate.js'\nexport * from './abort.js'\nexport * from './end.js'\nexport * from './submit.js'\nexport * from './save.js'\nexport * from './start.js'\nexport * from './restart.js'\n"]}

package/dist-server/controllers/activity-thread/restart.d.ts

@@ -0,0 +1,2 @@
+import { ActivityThread } from '../../service/activity-thread/activity-thread.js';
+export declare function restart(id: string, output: object, reason: string, context: ResolverContext): Promise<ActivityThread>;

package/dist-server/controllers/activity-thread/restart.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.restart = restart;
+const activity_thread_js_1 = require("../../service/activity-thread/activity-thread.js");
+const common_js_1 = require("../common.js");
+const check_authority_js_1 = require("./check-authority.js");
+async function restart(id, output, reason, context) {
+    const { domain, user, tx } = context.state;
+    const repository = tx.getRepository(activity_thread_js_1.ActivityThread);
+    const activityThread = await repository.findOne({
+        where: { domain: { id: domain.id }, id },
+        relations: ['activityInstance', 'activityInstance.activity']
+    });
+    if (!activityThread) {
+        throw new Error(context.t('error.activity-thread not found', {
+            activityThread: id
+        }));
+    }
+    await (0, check_authority_js_1.checkAuthority)(activityThread, context);
+    /*
+      Prerequisites for a activity thread to Be Delegated.
+      - The previous state of the activity thread should be Rejected.
+    */
+    if (activityThread.state !== activity_thread_js_1.ActivityThreadStatus.Rejected) {
+        throw new Error(context.t(`error.activity-thread should be the state`, {
+            id,
+            state: activity_thread_js_1.ActivityThreadStatus.Rejected,
+            actual: activityThread.state
+        }));
+    }
+    /*
+     * **되돌릴 수 없는 판정은 되살리지 않는다.**
+     *
+     * 반려되는 순간 대상이 닫히는 업무가 있다 — 부적합 처분, 트윈 조치. 그런 건을 되살리면 다음 차수의
+     * 결재가 새로 서는데, 대상은 이미 닫혀 있어 **승인해도 아무 일이 일어나지 않는다.** 사람은 승인할
+     * 것이 있다고 보고, 오류도 안 난다.
+     *
+     * 다시 하려면 새로 낸다.
+     */
+    if (activityThread.activityInstance?.rejectionIsFinal ||
+        activityThread.activityInstance?.activity?.rejectionIsFinal ||
+        ['ended', 'aborted'].includes(activityThread.activityInstance?.state)) {
+        throw new Error(context.t('error.activity-thread rejection is final', {
+            id,
+            activityInstance: activityThread.activityInstanceId
+        }));
+    }
+    if (output) {
+        activityThread.output = output;
+    }
+    const result = await tx.getRepository(activity_thread_js_1.ActivityThread).save({
+        ...activityThread,
+        reason,
+        state: activity_thread_js_1.ActivityThreadStatus.Started,
+        transaction: 'restart',
+        round: activityThread.round + 1,
+        updater: user,
+        startedAt: new Date()
+    });
+    await (0, common_js_1.updateActivityInstanceState)(activityThread.activityInstanceId, { causedBy: [result] }, context);
+    return result;
+}
+//# sourceMappingURL=restart.js.map

package/dist-server/controllers/activity-thread/restart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.js","sourceRoot":"","sources":["../../../server/controllers/activity-thread/restart.ts"],"names":[],"mappings":";;AAIA,0BA6EC;AAjFD,yFAAuG;AACvG,4CAA0D;AAC1D,6DAAqD;AAE9C,KAAK,UAAU,OAAO,CAC3B,EAAU,EACV,MAAc,EACd,MAAc,EACd,OAAwB;IAExB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAE1C,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,CAAC,mCAAc,CAAC,CAAA;IACnD,MAAM,cAAc,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC;QAC9C,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;QACxC,SAAS,EAAE,CAAC,kBAAkB,EAAE,2BAA2B,CAAC;KAC7D,CAAC,CAAA;IAEF,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,OAAO,CAAC,CAAC,CAAC,iCAAiC,EAAE;YAC3C,cAAc,EAAE,EAAE;SACnB,CAAC,CACH,CAAA;IACH,CAAC;IAED,MAAM,IAAA,mCAAc,EAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IAE7C;;;MAGE;IACF,IAAI,cAAc,CAAC,KAAK,KAAK,yCAAoB,CAAC,QAAQ,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,OAAO,CAAC,CAAC,CAAC,2CAA2C,EAAE;YACrD,EAAE;YACF,KAAK,EAAE,yCAAoB,CAAC,QAAQ;YACpC,MAAM,EAAE,cAAc,CAAC,KAAK;SAC7B,CAAC,CACH,CAAA;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,IACE,cAAc,CAAC,gBAAgB,EAAE,gBAAgB;QACjD,cAAc,CAAC,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB;QAC3D,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,gBAAgB,EAAE,KAAK,CAAC,EACrE,CAAC;QACD,MAAM,IAAI,KAAK,CACb,OAAO,CAAC,CAAC,CAAC,0CAA0C,EAAE;YACpD,EAAE;YACF,gBAAgB,EAAE,cAAc,CAAC,kBAAkB;SACpD,CAAC,CACH,CAAA;IACH,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,cAAc,CAAC,MAAM,GAAG,MAAM,CAAA;IAChC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,mCAAc,CAAC,CAAC,IAAI,CAAC;QACzD,GAAG,cAAc;QACjB,MAAM;QACN,KAAK,EAAE,yCAAoB,CAAC,OAAO;QACnC,WAAW,EAAE,SAAS;QACtB,KAAK,EAAE,cAAc,CAAC,KAAK,GAAG,CAAC;QAC/B,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,IAAI,IAAI,EAAE;KACtB,CAAC,CAAA;IAEF,MAAM,IAAA,uCAA2B,EAAC,cAAc,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAErG,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import { ActivityThread, ActivityThreadStatus } from '../../service/activity-thread/activity-thread.js'\nimport { updateActivityInstanceState } from '../common.js'\nimport { checkAuthority } from './check-authority.js'\n\nexport async function restart(\n  id: string,\n  output: object,\n  reason: string,\n  context: ResolverContext\n): Promise<ActivityThread> {\n  const { domain, user, tx } = context.state\n\n  const repository = tx.getRepository(ActivityThread)\n  const activityThread = await repository.findOne({\n    where: { domain: { id: domain.id }, id },\n    relations: ['activityInstance', 'activityInstance.activity']\n  })\n\n  if (!activityThread) {\n    throw new Error(\n      context.t('error.activity-thread not found', {\n        activityThread: id\n      })\n    )\n  }\n\n  await checkAuthority(activityThread, context)\n\n  /* \n    Prerequisites for a activity thread to Be Delegated.\n    - The previous state of the activity thread should be Rejected.\n  */\n  if (activityThread.state !== ActivityThreadStatus.Rejected) {\n    throw new Error(\n      context.t(`error.activity-thread should be the state`, {\n        id,\n        state: ActivityThreadStatus.Rejected,\n        actual: activityThread.state\n      })\n    )\n  }\n\n  /*\n   * **되돌릴 수 없는 판정은 되살리지 않는다.**\n   *\n   * 반려되는 순간 대상이 닫히는 업무가 있다 — 부적합 처분, 트윈 조치. 그런 건을 되살리면 다음 차수의\n   * 결재가 새로 서는데, 대상은 이미 닫혀 있어 **승인해도 아무 일이 일어나지 않는다.** 사람은 승인할\n   * 것이 있다고 보고, 오류도 안 난다.\n   *\n   * 다시 하려면 새로 낸다.\n   */\n  if (\n    activityThread.activityInstance?.rejectionIsFinal ||\n    activityThread.activityInstance?.activity?.rejectionIsFinal ||\n    ['ended', 'aborted'].includes(activityThread.activityInstance?.state)\n  ) {\n    throw new Error(\n      context.t('error.activity-thread rejection is final', {\n        id,\n        activityInstance: activityThread.activityInstanceId\n      })\n    )\n  }\n\n  if (output) {\n    activityThread.output = output\n  }\n\n  const result = await tx.getRepository(ActivityThread).save({\n    ...activityThread,\n    reason,\n    state: ActivityThreadStatus.Started,\n    transaction: 'restart',\n    round: activityThread.round + 1,\n    updater: user,\n    startedAt: new Date()\n  })\n\n  await updateActivityInstanceState(activityThread.activityInstanceId, { causedBy: [result] }, context)\n\n  return result\n}\n"]}

package/dist-server/controllers/activity-thread/save.d.ts

@@ -0,0 +1,3 @@
+import { ActivityThreadSave } from '../../service/activity-thread/activity-thread-type.js';
+import { ActivityThread } from '../../service/activity-thread/activity-thread.js';
+export declare function save(id: string, save: ActivityThreadSave, reason: string, context: ResolverContext): Promise<ActivityThread>;

package/dist-server/controllers/activity-thread/save.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.save = save;
+const common_js_1 = require("../common.js");
+const activity_thread_js_1 = require("../../service/activity-thread/activity-thread.js");
+const check_authority_js_1 = require("./check-authority.js");
+async function save(id, save, reason, context) {
+    const { domain, user, tx } = context.state;
+    const repository = tx.getRepository(activity_thread_js_1.ActivityThread);
+    var activityThread = await repository.findOne({
+        where: { domain: { id: domain.id }, id }
+    });
+    if (!activityThread) {
+        throw new Error(context.t('error.activity-thread not found', {
+            activityThread: id
+        }));
+    }
+    await (0, check_authority_js_1.checkAuthority)(activityThread, context);
+    /*
+      Prerequisites for a activity thread to Be Saved.
+      - The previous state of the activity thread must not be terminated.
+    */
+    if (activityThread.state == activity_thread_js_1.ActivityThreadStatus.Aborted || activityThread.state == activity_thread_js_1.ActivityThreadStatus.Ended) {
+        throw new Error(context.t(`error.activity-thread is already terminated`, {
+            id,
+            actual: activityThread.state
+        }));
+    }
+    // TODO 만약 activityInstance의 threadsMin 갯수를 아직 채우지 못했다면, 새로운 activityThread를 만들어서 처리하도록 한다.
+    // (다른 사용자들이 threadsMin 개수만큼의 activityThread를 채울 수 있는 기회를 제공하기 위해서)
+    if (!activityThread.startedAt) {
+        /* The act of saving means automatically starting the work. */
+        activityThread.startedAt = new Date();
+    }
+    activityThread = await repository.save({
+        ...activityThread,
+        ...save,
+        state: activity_thread_js_1.ActivityThreadStatus.Started,
+        transaction: 'save',
+        updater: user
+    });
+    await (0, common_js_1.updateActivityInstanceState)(activityThread.activityInstanceId, { causedBy: [activityThread] }, context);
+    return activityThread;
+}
+//# sourceMappingURL=save.js.map

package/dist-server/controllers/activity-thread/save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.js","sourceRoot":"","sources":["../../../server/controllers/activity-thread/save.ts"],"names":[],"mappings":";;AAKA,oBAuDC;AA3DD,4CAA0D;AAC1D,yFAAuG;AACvG,6DAAqD;AAE9C,KAAK,UAAU,IAAI,CACxB,EAAU,EACV,IAAwB,EACxB,MAAc,EACd,OAAwB;IAExB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAC1C,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,CAAC,mCAAc,CAAC,CAAA;IAEnD,IAAI,cAAc,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC;QAC5C,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;KACzC,CAAC,CAAA;IAEF,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,OAAO,CAAC,CAAC,CAAC,iCAAiC,EAAE;YAC3C,cAAc,EAAE,EAAE;SACnB,CAAC,CACH,CAAA;IACH,CAAC;IAED,MAAM,IAAA,mCAAc,EAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IAE7C;;;MAGE;IACF,IAAI,cAAc,CAAC,KAAK,IAAI,yCAAoB,CAAC,OAAO,IAAI,cAAc,CAAC,KAAK,IAAI,yCAAoB,CAAC,KAAK,EAAE,CAAC;QAC/G,MAAM,IAAI,KAAK,CACb,OAAO,CAAC,CAAC,CAAC,6CAA6C,EAAE;YACvD,EAAE;YACF,MAAM,EAAE,cAAc,CAAC,KAAK;SAC7B,CAAC,CACH,CAAA;IACH,CAAC;IAED,2FAA2F;IAC3F,mEAAmE;IAEnE,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;QAC9B,8DAA8D;QAC9D,cAAc,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAA;IACvC,CAAC;IAED,cAAc,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC;QACrC,GAAG,cAAc;QACjB,GAAG,IAAI;QACP,KAAK,EAAE,yCAAoB,CAAC,OAAO;QACnC,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,IAAI;KACd,CAAC,CAAA;IAEF,MAAM,IAAA,uCAA2B,EAAC,cAAc,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAE7G,OAAO,cAAc,CAAA;AACvB,CAAC","sourcesContent":["import { ActivityThreadSave } from '../../service/activity-thread/activity-thread-type.js'\nimport { updateActivityInstanceState } from '../common.js'\nimport { ActivityThread, ActivityThreadStatus } from '../../service/activity-thread/activity-thread.js'\nimport { checkAuthority } from './check-authority.js'\n\nexport async function save(\n  id: string,\n  save: ActivityThreadSave,\n  reason: string,\n  context: ResolverContext\n): Promise<ActivityThread> {\n  const { domain, user, tx } = context.state\n  const repository = tx.getRepository(ActivityThread)\n\n  var activityThread = await repository.findOne({\n    where: { domain: { id: domain.id }, id }\n  })\n\n  if (!activityThread) {\n    throw new Error(\n      context.t('error.activity-thread not found', {\n        activityThread: id\n      })\n    )\n  }\n\n  await checkAuthority(activityThread, context)\n\n  /* \n    Prerequisites for a activity thread to Be Saved.\n    - The previous state of the activity thread must not be terminated.\n  */\n  if (activityThread.state == ActivityThreadStatus.Aborted || activityThread.state == ActivityThreadStatus.Ended) {\n    throw new Error(\n      context.t(`error.activity-thread is already terminated`, {\n        id,\n        actual: activityThread.state\n      })\n    )\n  }\n\n  // TODO 만약 activityInstance의 threadsMin 갯수를 아직 채우지 못했다면, 새로운 activityThread를 만들어서 처리하도록 한다.\n  // (다른 사용자들이 threadsMin 개수만큼의 activityThread를 채울 수 있는 기회를 제공하기 위해서)\n\n  if (!activityThread.startedAt) {\n    /* The act of saving means automatically starting the work. */\n    activityThread.startedAt = new Date()\n  }\n\n  activityThread = await repository.save({\n    ...activityThread,\n    ...save,\n    state: ActivityThreadStatus.Started,\n    transaction: 'save',\n    updater: user\n  })\n\n  await updateActivityInstanceState(activityThread.activityInstanceId, { causedBy: [activityThread] }, context)\n\n  return activityThread\n}\n"]}

package/dist-server/controllers/activity-thread/start.d.ts

@@ -0,0 +1,2 @@
+import { ActivityThread } from '../../service/activity-thread/activity-thread.js';
+export declare function start(id: string, output: object, reason: string, context: ResolverContext): Promise<ActivityThread>;