@things-factory/inquiry 0.0.0-stage → 10.1.251

package/dist-server/service/inquiry/inquiry-rules.js

@@ -0,0 +1,157 @@
+"use strict";
+/*
+ * The rules of an inquiry (ADR-0184 decisions 1-8) - what may be written, who reads and answers it, where it stands
+ * after a reply or a move, whose turn it is, and what its notice says.
+ *
+ * Pure - the rules are tested without a database. The doors (inquiry-resolver.ts) ask them.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.viewAddressOf = exports.handlersTurn = exports.HANDLERS_TURN = exports.MAX_PAGE_URL = exports.MAX_BODY = exports.MAX_TITLE = exports.INQUIRY_VISIBILITIES = exports.INQUIRY_STATUSES = exports.INQUIRY_KINDS = void 0;
+exports.inputRefusal = inputRefusal;
+exports.replyRefusal = replyRefusal;
+exports.mayRead = mayRead;
+exports.replyRefusalFor = replyRefusalFor;
+exports.sideOf = sideOf;
+exports.statusAfterReply = statusAfterReply;
+exports.answerRefusal = answerRefusal;
+exports.moveRefusal = moveRefusal;
+exports.newForAsker = newForAsker;
+exports.badgeOf = badgeOf;
+exports.plainSummary = plainSummary;
+exports.noticeWordsOf = noticeWordsOf;
+/** The kinds of inquiry - a question, a bug report, a feature proposal (`inquiry.kind.<code>`). */
+exports.INQUIRY_KINDS = ['QUESTION', 'BUG', 'PROPOSAL'];
+/** Where an inquiry stands (`inquiry.status.<code>`). PLANNED and DECLINED are a proposal's only. */
+exports.INQUIRY_STATUSES = ['RECEIVED', 'IN_PROGRESS', 'ANSWERED', 'PLANNED', 'DECLINED', 'CLOSED'];
+/** Who reads it: everyone of the domain, or its writer and the handlers (`inquiry.visibility.<code>`). */
+exports.INQUIRY_VISIBILITIES = ['DOMAIN', 'PRIVATE'];
+exports.MAX_TITLE = 200;
+exports.MAX_BODY = 20000;
+exports.MAX_PAGE_URL = 2000;
+/** The states that wait on the handlers - a to-do is open for them, and the handlers' badge counts them. */
+exports.HANDLERS_TURN = ['RECEIVED', 'IN_PROGRESS'];
+/** Why what was written cannot be kept, or nothing. */
+function inputRefusal(input) {
+    if (!exports.INQUIRY_KINDS.includes(String(input.kind ?? '')))
+        return 'unknown-kind';
+    const title = String(input.title ?? '').trim();
+    if (!title)
+        return 'no-title';
+    if (title.length > exports.MAX_TITLE)
+        return 'title-too-long';
+    if (String(input.body ?? '').length > exports.MAX_BODY)
+        return 'body-too-long';
+    if (input.visibility && !exports.INQUIRY_VISIBILITIES.includes(input.visibility))
+        return 'unknown-visibility';
+    if (String(input.pageUrl ?? '').length > exports.MAX_PAGE_URL)
+        return 'page-url-too-long';
+    return undefined;
+}
+/** Whether a reply says something - words, or files. */
+function replyRefusal(body, files) {
+    const text = String(body ?? '').trim();
+    if (!text && !files)
+        return 'empty-reply';
+    if (text.length > exports.MAX_BODY)
+        return 'body-too-long';
+    return undefined;
+}
+const isAuthor = (one, viewer) => !!one.creatorId && one.creatorId === viewer.userId;
+/** An open inquiry is read by everyone of the domain; a private one by its writer and the handlers (decision 5). */
+function mayRead(one, viewer) {
+    return one.visibility !== 'PRIVATE' || isAuthor(one, viewer) || viewer.handler;
+}
+/** Replies go back and forth between the writer and the handlers, until it is closed (decision 3). */
+function replyRefusalFor(one, viewer) {
+    if (!isAuthor(one, viewer) && !viewer.handler)
+        return 'not-a-party';
+    if (one.status === 'CLOSED')
+        return 'closed';
+    return undefined;
+}
+/** Which side a reply is from - the writer's own reply is the asker's, even when the writer is a handler. */
+function sideOf(one, viewer) {
+    return isAuthor(one, viewer) ? 'asker' : 'handler';
+}
+/**
+ * Where it stands after a reply (decision 2). A handler's reply marked as the answer answers it; any other handler's
+ * reply puts a received one in progress. The asker replying to an answer or a decision hands it back to the handlers.
+ */
+function statusAfterReply(one, side, asAnswer) {
+    if (side === 'handler') {
+        if (asAnswer)
+            return 'ANSWERED';
+        return one.status === 'RECEIVED' ? 'IN_PROGRESS' : one.status;
+    }
+    return ['ANSWERED', 'PLANNED', 'DECLINED'].includes(one.status) ? 'IN_PROGRESS' : one.status;
+}
+/** Whether `side` may mark a reply as the answer - the handlers' only. */
+function answerRefusal(side, asAnswer) {
+    return asAnswer && side !== 'handler' ? 'handlers-only' : undefined;
+}
+/**
+ * Why the request may not move it to `to`, or nothing (decision 2). The writer closes their own; everything else is the
+ * handlers'. A closed one stays closed; PLANNED and DECLINED are a proposal's; nothing goes back to RECEIVED.
+ */
+function moveRefusal(one, to, viewer) {
+    if (!exports.INQUIRY_STATUSES.includes(to))
+        return 'unknown-status';
+    if (one.status === 'CLOSED')
+        return 'closed';
+    if (to === one.status)
+        return 'same-status';
+    if (to === 'RECEIVED')
+        return 'not-a-move';
+    if ((to === 'PLANNED' || to === 'DECLINED') && one.kind !== 'PROPOSAL')
+        return 'not-a-proposal';
+    if (to === 'CLOSED' && isAuthor(one, viewer))
+        return undefined;
+    if (!viewer.handler)
+        return 'handlers-only';
+    return undefined;
+}
+/** Whether it waits on the handlers. */
+const handlersTurn = (status) => exports.HANDLERS_TURN.includes(status);
+exports.handlersTurn = handlersTurn;
+/** Whether the writer has a handler's word they have not seen - a reply or a move since they last opened it. */
+function newForAsker(one) {
+    const said = one.handlerActivityAt ? new Date(one.handlerActivityAt).getTime() : undefined;
+    if (said === undefined)
+        return false;
+    const seen = one.askerSeenAt ? new Date(one.askerSeenAt).getTime() : undefined;
+    return seen === undefined || said > seen;
+}
+/** The count on the menu entry (decision 8): new words on one's own inquiries, and for a handler those waiting on them. */
+function badgeOf(summary) {
+    return summary.newAnswers + (summary.handler ? summary.unhandled : 0);
+}
+/** The screen an inquiry opens on. */
+const viewAddressOf = (id) => `inquiry-list?id=${id}`;
+exports.viewAddressOf = viewAddressOf;
+/** The body as one line of plain words - the notice's summary. */
+function plainSummary(body, max = 120) {
+    const text = String(body ?? '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+}
+/** Who is told of what (decision 7): the handlers of a new one, the writer of a handler's word, the handler of the writer's. */
+function noticeWordsOf(one, kind, said, say) {
+    const kindWord = say(`inquiry.kind.${one.kind}`, one.kind);
+    const title = one.title;
+    const subject = {
+        received: say('inquiry.notice.received-subject', 'New {kind}: {title}', { kind: kindWord, title }),
+        replied: say('inquiry.notice.replied-subject', 'A reply to your {kind}: {title}', { kind: kindWord, title }),
+        answered: say('inquiry.notice.answered-subject', 'Answered: {title}', { title }),
+        moved: say('inquiry.notice.moved-subject', '{status}: {title}', { status: say(`inquiry.status.${said.status}`, String(said.status ?? '')), title }),
+        'asker-replied': say('inquiry.notice.asker-replied-subject', 'The writer replied: {title}', { title })
+    }[kind];
+    return {
+        subject,
+        summary: plainSummary(said.body) || subject,
+        body: said.body ?? '',
+        action: say('inquiry.notice.action', 'Open the inquiry'),
+        note: say('inquiry.notice.note', 'Open Inquiries in the application to read it.')
+    };
+}
+//# sourceMappingURL=inquiry-rules.js.map

package/dist-server/service/inquiry/inquiry-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inquiry-rules.js","sourceRoot":"","sources":["../../../server/service/inquiry/inquiry-rules.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA8CH,oCASC;AAGD,oCAKC;AAKD,0BAEC;AAGD,0CAIC;AAGD,wBAEC;AAMD,4CAMC;AAGD,sCAEC;AAMD,kCASC;AAMD,kCAKC;AAGD,0BAEC;AAYD,oCAKC;AAGD,sCAiBC;AArKD,mGAAmG;AACtF,QAAA,aAAa,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAU,CAAA;AAErE,qGAAqG;AACxF,QAAA,gBAAgB,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAU,CAAA;AAEjH,0GAA0G;AAC7F,QAAA,oBAAoB,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAA;AAKrD,QAAA,SAAS,GAAG,GAAG,CAAA;AACf,QAAA,QAAQ,GAAG,KAAK,CAAA;AAChB,QAAA,YAAY,GAAG,IAAI,CAAA;AAEhC,4GAA4G;AAC/F,QAAA,aAAa,GAAsB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;AA0B3E,uDAAuD;AACvD,SAAgB,YAAY,CAAC,KAAwB;IACnD,IAAI,CAAE,qBAAmC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAAE,OAAO,cAAc,CAAA;IACnG,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC9C,IAAI,CAAC,KAAK;QAAE,OAAO,UAAU,CAAA;IAC7B,IAAI,KAAK,CAAC,MAAM,GAAG,iBAAS;QAAE,OAAO,gBAAgB,CAAA;IACrD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,gBAAQ;QAAE,OAAO,eAAe,CAAA;IACtE,IAAI,KAAK,CAAC,UAAU,IAAI,CAAE,4BAA0C,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC;QAAE,OAAO,oBAAoB,CAAA;IAC5H,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,oBAAY;QAAE,OAAO,mBAAmB,CAAA;IACjF,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,wDAAwD;AACxD,SAAgB,YAAY,CAAC,IAA+B,EAAE,KAAa;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACtC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,aAAa,CAAA;IACzC,IAAI,IAAI,CAAC,MAAM,GAAG,gBAAQ;QAAE,OAAO,eAAe,CAAA;IAClD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,GAAiB,EAAE,MAAc,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,MAAM,CAAC,MAAM,CAAA;AAE1G,oHAAoH;AACpH,SAAgB,OAAO,CAAC,GAAiB,EAAE,MAAc;IACvD,OAAO,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAA;AAChF,CAAC;AAED,sGAAsG;AACtG,SAAgB,eAAe,CAAC,GAAiB,EAAE,MAAc;IAC/D,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,aAAa,CAAA;IACnE,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC5C,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,6GAA6G;AAC7G,SAAgB,MAAM,CAAC,GAAiB,EAAE,MAAc;IACtD,OAAO,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;AACpD,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,GAAiB,EAAE,IAAyB,EAAE,QAAiB;IAC9F,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,QAAQ;YAAE,OAAO,UAAU,CAAA;QAC/B,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAA;IAC/D,CAAC;IACD,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAA;AAC9F,CAAC;AAED,0EAA0E;AAC1E,SAAgB,aAAa,CAAC,IAAyB,EAAE,QAAiB;IACxE,OAAO,QAAQ,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAA;AACrE,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,GAAiB,EAAE,EAAU,EAAE,MAAc;IACvE,IAAI,CAAE,wBAAsC,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,gBAAgB,CAAA;IAClF,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC5C,IAAI,EAAE,KAAK,GAAG,CAAC,MAAM;QAAE,OAAO,aAAa,CAAA;IAC3C,IAAI,EAAE,KAAK,UAAU;QAAE,OAAO,YAAY,CAAA;IAC1C,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,UAAU,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,gBAAgB,CAAA;IAC/F,IAAI,EAAE,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAE,OAAO,SAAS,CAAA;IAC9D,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,eAAe,CAAA;IAC3C,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,wCAAwC;AACjC,MAAM,YAAY,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,qBAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AAAjE,QAAA,YAAY,gBAAqD;AAE9E,gHAAgH;AAChH,SAAgB,WAAW,CAAC,GAAiB;IAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IAC1F,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACpC,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IAC9E,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,GAAG,IAAI,CAAA;AAC1C,CAAC;AAED,2HAA2H;AAC3H,SAAgB,OAAO,CAAC,OAAoE;IAC1F,OAAO,OAAO,CAAC,UAAU,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACvE,CAAC;AAED,sCAAsC;AAC/B,MAAM,aAAa,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,mBAAmB,EAAE,EAAE,CAAA;AAAvD,QAAA,aAAa,iBAA0C;AAQpE,kEAAkE;AAClE,SAAgB,YAAY,CAAC,IAA+B,EAAE,GAAG,GAAG,GAAG;IACrE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;SAC5B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAA;IACT,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;AAChE,CAAC;AAED,gIAAgI;AAChI,SAAgB,aAAa,CAAC,GAAoC,EAAE,IAAgB,EAAE,IAA+C,EAAE,GAAQ;IAC7I,MAAM,QAAQ,GAAG,GAAG,CAAC,gBAAgB,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;IAC1D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAA;IACvB,MAAM,OAAO,GAAG;QACd,QAAQ,EAAE,GAAG,CAAC,iCAAiC,EAAE,qBAAqB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAClG,OAAO,EAAE,GAAG,CAAC,gCAAgC,EAAE,iCAAiC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC5G,QAAQ,EAAE,GAAG,CAAC,iCAAiC,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,CAAC;QAChF,KAAK,EAAE,GAAG,CAAC,8BAA8B,EAAE,mBAAmB,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,kBAAkB,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QACnJ,eAAe,EAAE,GAAG,CAAC,sCAAsC,EAAE,6BAA6B,EAAE,EAAE,KAAK,EAAE,CAAC;KACvG,CAAC,IAAI,CAAC,CAAA;IACP,OAAO;QACL,OAAO;QACP,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO;QAC3C,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACrB,MAAM,EAAE,GAAG,CAAC,uBAAuB,EAAE,kBAAkB,CAAC;QACxD,IAAI,EAAE,GAAG,CAAC,qBAAqB,EAAE,+CAA+C,CAAC;KAClF,CAAA;AACH,CAAC","sourcesContent":["/*\n * The rules of an inquiry (ADR-0184 decisions 1-8) - what may be written, who reads and answers it, where it stands\n * after a reply or a move, whose turn it is, and what its notice says.\n *\n * Pure - the rules are tested without a database. The doors (inquiry-resolver.ts) ask them.\n */\n\n/** The kinds of inquiry - a question, a bug report, a feature proposal (`inquiry.kind.<code>`). */\nexport const INQUIRY_KINDS = ['QUESTION', 'BUG', 'PROPOSAL'] as const\n\n/** Where an inquiry stands (`inquiry.status.<code>`). PLANNED and DECLINED are a proposal's only. */\nexport const INQUIRY_STATUSES = ['RECEIVED', 'IN_PROGRESS', 'ANSWERED', 'PLANNED', 'DECLINED', 'CLOSED'] as const\n\n/** Who reads it: everyone of the domain, or its writer and the handlers (`inquiry.visibility.<code>`). */\nexport const INQUIRY_VISIBILITIES = ['DOMAIN', 'PRIVATE'] as const\n\nexport type InquiryKind = (typeof INQUIRY_KINDS)[number]\nexport type InquiryStatus = (typeof INQUIRY_STATUSES)[number]\n\nexport const MAX_TITLE = 200\nexport const MAX_BODY = 20000\nexport const MAX_PAGE_URL = 2000\n\n/** The states that wait on the handlers - a to-do is open for them, and the handlers' badge counts them. */\nexport const HANDLERS_TURN: readonly string[] = ['RECEIVED', 'IN_PROGRESS']\n\nexport interface InquiryFacts {\n  kind: string\n  status: string\n  visibility: string\n  creatorId?: string | null\n  handlerActivityAt?: Date | string | null\n  askerSeenAt?: Date | string | null\n}\n\n/** The request's person as an inquiry sees them. */\nexport interface Viewer {\n  userId: string\n  /** Holds `inquiry:mutation` (the task `inquiry.answering`), or owns the domain. */\n  handler: boolean\n}\n\nexport interface InquiryInputFacts {\n  kind?: string | null\n  title?: string | null\n  body?: string | null\n  visibility?: string | null\n  pageUrl?: string | null\n}\n\n/** Why what was written cannot be kept, or nothing. */\nexport function inputRefusal(input: InquiryInputFacts): string | undefined {\n  if (!(INQUIRY_KINDS as readonly string[]).includes(String(input.kind ?? ''))) return 'unknown-kind'\n  const title = String(input.title ?? '').trim()\n  if (!title) return 'no-title'\n  if (title.length > MAX_TITLE) return 'title-too-long'\n  if (String(input.body ?? '').length > MAX_BODY) return 'body-too-long'\n  if (input.visibility && !(INQUIRY_VISIBILITIES as readonly string[]).includes(input.visibility)) return 'unknown-visibility'\n  if (String(input.pageUrl ?? '').length > MAX_PAGE_URL) return 'page-url-too-long'\n  return undefined\n}\n\n/** Whether a reply says something - words, or files. */\nexport function replyRefusal(body: string | null | undefined, files: number): string | undefined {\n  const text = String(body ?? '').trim()\n  if (!text && !files) return 'empty-reply'\n  if (text.length > MAX_BODY) return 'body-too-long'\n  return undefined\n}\n\nconst isAuthor = (one: InquiryFacts, viewer: Viewer) => !!one.creatorId && one.creatorId === viewer.userId\n\n/** An open inquiry is read by everyone of the domain; a private one by its writer and the handlers (decision 5). */\nexport function mayRead(one: InquiryFacts, viewer: Viewer): boolean {\n  return one.visibility !== 'PRIVATE' || isAuthor(one, viewer) || viewer.handler\n}\n\n/** Replies go back and forth between the writer and the handlers, until it is closed (decision 3). */\nexport function replyRefusalFor(one: InquiryFacts, viewer: Viewer): string | undefined {\n  if (!isAuthor(one, viewer) && !viewer.handler) return 'not-a-party'\n  if (one.status === 'CLOSED') return 'closed'\n  return undefined\n}\n\n/** Which side a reply is from - the writer's own reply is the asker's, even when the writer is a handler. */\nexport function sideOf(one: InquiryFacts, viewer: Viewer): 'asker' | 'handler' {\n  return isAuthor(one, viewer) ? 'asker' : 'handler'\n}\n\n/**\n * Where it stands after a reply (decision 2). A handler's reply marked as the answer answers it; any other handler's\n * reply puts a received one in progress. The asker replying to an answer or a decision hands it back to the handlers.\n */\nexport function statusAfterReply(one: InquiryFacts, side: 'asker' | 'handler', asAnswer: boolean): string {\n  if (side === 'handler') {\n    if (asAnswer) return 'ANSWERED'\n    return one.status === 'RECEIVED' ? 'IN_PROGRESS' : one.status\n  }\n  return ['ANSWERED', 'PLANNED', 'DECLINED'].includes(one.status) ? 'IN_PROGRESS' : one.status\n}\n\n/** Whether `side` may mark a reply as the answer - the handlers' only. */\nexport function answerRefusal(side: 'asker' | 'handler', asAnswer: boolean): string | undefined {\n  return asAnswer && side !== 'handler' ? 'handlers-only' : undefined\n}\n\n/**\n * Why the request may not move it to `to`, or nothing (decision 2). The writer closes their own; everything else is the\n * handlers'. A closed one stays closed; PLANNED and DECLINED are a proposal's; nothing goes back to RECEIVED.\n */\nexport function moveRefusal(one: InquiryFacts, to: string, viewer: Viewer): string | undefined {\n  if (!(INQUIRY_STATUSES as readonly string[]).includes(to)) return 'unknown-status'\n  if (one.status === 'CLOSED') return 'closed'\n  if (to === one.status) return 'same-status'\n  if (to === 'RECEIVED') return 'not-a-move'\n  if ((to === 'PLANNED' || to === 'DECLINED') && one.kind !== 'PROPOSAL') return 'not-a-proposal'\n  if (to === 'CLOSED' && isAuthor(one, viewer)) return undefined\n  if (!viewer.handler) return 'handlers-only'\n  return undefined\n}\n\n/** Whether it waits on the handlers. */\nexport const handlersTurn = (status: string) => HANDLERS_TURN.includes(status)\n\n/** Whether the writer has a handler's word they have not seen - a reply or a move since they last opened it. */\nexport function newForAsker(one: InquiryFacts): boolean {\n  const said = one.handlerActivityAt ? new Date(one.handlerActivityAt).getTime() : undefined\n  if (said === undefined) return false\n  const seen = one.askerSeenAt ? new Date(one.askerSeenAt).getTime() : undefined\n  return seen === undefined || said > seen\n}\n\n/** The count on the menu entry (decision 8): new words on one's own inquiries, and for a handler those waiting on them. */\nexport function badgeOf(summary: { newAnswers: number; unhandled: number; handler: boolean }): number {\n  return summary.newAnswers + (summary.handler ? summary.unhandled : 0)\n}\n\n/** The screen an inquiry opens on. */\nexport const viewAddressOf = (id: string) => `inquiry-list?id=${id}`\n\n/** Why the people are told. */\nexport type NoticeKind = 'received' | 'replied' | 'answered' | 'moved' | 'asker-replied'\n\n/** A sentence in one language, with the English one when that language has none. */\nexport type Say = (key: string, english: string, params?: Record<string, unknown>) => string\n\n/** The body as one line of plain words - the notice's summary. */\nexport function plainSummary(body: string | null | undefined, max = 120): string {\n  const text = String(body ?? '')\n    .replace(/\\s+/g, ' ')\n    .trim()\n  return text.length > max ? `${text.slice(0, max - 1)}…` : text\n}\n\n/** Who is told of what (decision 7): the handlers of a new one, the writer of a handler's word, the handler of the writer's. */\nexport function noticeWordsOf(one: { title: string; kind: string }, kind: NoticeKind, said: { body?: string | null; status?: string }, say: Say) {\n  const kindWord = say(`inquiry.kind.${one.kind}`, one.kind)\n  const title = one.title\n  const subject = {\n    received: say('inquiry.notice.received-subject', 'New {kind}: {title}', { kind: kindWord, title }),\n    replied: say('inquiry.notice.replied-subject', 'A reply to your {kind}: {title}', { kind: kindWord, title }),\n    answered: say('inquiry.notice.answered-subject', 'Answered: {title}', { title }),\n    moved: say('inquiry.notice.moved-subject', '{status}: {title}', { status: say(`inquiry.status.${said.status}`, String(said.status ?? '')), title }),\n    'asker-replied': say('inquiry.notice.asker-replied-subject', 'The writer replied: {title}', { title })\n  }[kind]\n  return {\n    subject,\n    summary: plainSummary(said.body) || subject,\n    body: said.body ?? '',\n    action: say('inquiry.notice.action', 'Open the inquiry'),\n    note: say('inquiry.notice.note', 'Open Inquiries in the application to read it.')\n  }\n}\n"]}

package/dist-server/service/inquiry/inquiry-service.d.ts

@@ -0,0 +1,35 @@
+import { EntityManager } from 'typeorm';
+import { Domain } from '@things-factory/shell';
+import { Inquiry } from './inquiry';
+import { type NoticeKind, type Viewer } from './inquiry-rules';
+/** The attachments of an inquiry hang on it under this `refType`, a reply's under the next (attachment-base). */
+export declare const INQUIRY_REF_TYPE = "Inquiry";
+export declare const INQUIRY_REPLY_REF_TYPE = "InquiryReply";
+/** Whether the request handles inquiries - the one privilege of the module (`inquiry.answering`). */
+export declare function isHandler(context: any): Promise<boolean>;
+export declare function viewerOf(context: any): Promise<Viewer>;
+/** The inquiry as the request may read it, or nothing - one answer for "none" and "not yours". */
+export declare function visibleInquiry(id: string, context: any, tx?: EntityManager): Promise<{
+    inquiry: Inquiry;
+    viewer: Viewer;
+} | undefined>;
+/** The roles of the domain that give `inquiry:mutation` - the handlers' pool. */
+export declare function handlerRoleIds(domain: Domain, tx?: EntityManager): Promise<string[]>;
+/** The handlers to tell - those in a handler role, and the domain's owner, who handles as owners do. */
+export declare function handlerUserIds(domain: Domain, tx?: EntityManager): Promise<string[]>;
+/**
+ * Opens the handlers' to-do on it, unless one is open: one case, pooled on the handler roles - whoever of them picks it.
+ * With the activity not installed in the domain, or no handler role, there is no to-do: the notice and the badge still
+ * reach the handlers.
+ */
+export declare function openTodo(inquiry: Inquiry, context: any): Promise<void>;
+/** Closes the handlers' to-do when it is no longer their turn - left alone when it is closed already. */
+export declare function closeTodo(inquiry: Inquiry, context: any, reason: string): Promise<void>;
+/**
+ * Tells `userIds` - never the request's own person - once the request's transaction has committed. A notice that does
+ * not arrive undoes nothing: the list and the badge still reach them.
+ */
+export declare function tellWhenCommitted(context: any, one: Inquiry, kind: NoticeKind, userIds: string[], said?: {
+    body?: string | null;
+    status?: string;
+}): Promise<void>;

package/dist-server/service/inquiry/inquiry-service.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INQUIRY_REPLY_REF_TYPE = exports.INQUIRY_REF_TYPE = void 0;
+exports.isHandler = isHandler;
+exports.viewerOf = viewerOf;
+exports.visibleInquiry = visibleInquiry;
+exports.handlerRoleIds = handlerRoleIds;
+exports.handlerUserIds = handlerUserIds;
+exports.openTodo = openTodo;
+exports.closeTodo = closeTodo;
+exports.tellWhenCommitted = tellWhenCommitted;
+/*
+ * What the doors of inquiries do with the database (ADR-0184 decisions 5-7): who is a handler, who reads one, the
+ * handlers' turn as a worklist to-do, and telling people of it through notification.
+ */
+const typeorm_1 = require("typeorm");
+const auth_base_1 = require("@things-factory/auth-base");
+const env_1 = require("@things-factory/env");
+const translator_1 = require("@things-factory/i18n-base/translator");
+const notification_1 = require("@things-factory/notification");
+const shell_1 = require("@things-factory/shell");
+const worklist_1 = require("@things-factory/worklist");
+const inquiry_activity_1 = require("../../inquiry-activity");
+const inquiry_1 = require("./inquiry");
+const inquiry_rules_1 = require("./inquiry-rules");
+/** The attachments of an inquiry hang on it under this `refType`, a reply's under the next (attachment-base). */
+exports.INQUIRY_REF_TYPE = 'Inquiry';
+exports.INQUIRY_REPLY_REF_TYPE = 'InquiryReply';
+/** Whether the request handles inquiries - the one privilege of the module (`inquiry.answering`). */
+async function isHandler(context) {
+    const state = context?.state ?? {};
+    const { domain, user, unsafeIP, prohibitedPrivileges } = state;
+    if (!domain || !user)
+        return false;
+    /* Asked once per request - a list asks it for each row. */
+    state.__inquiryHandler ??= (0, auth_base_1.checkPermission)({ category: 'inquiry', privilege: 'mutation', owner: true }, user, domain, unsafeIP, prohibitedPrivileges).then(Boolean);
+    return await state.__inquiryHandler;
+}
+async function viewerOf(context) {
+    return { userId: context.state.user.id, handler: await isHandler(context) };
+}
+/** The inquiry as the request may read it, or nothing - one answer for "none" and "not yours". */
+async function visibleInquiry(id, context, tx) {
+    const { domain, user } = context?.state ?? {};
+    if (!id || !domain || !user || !/^[0-9a-f-]{36}$/i.test(id))
+        return undefined;
+    const inquiry = await (0, shell_1.getRepository)(inquiry_1.Inquiry, tx).findOne({ where: { id, domain: { id: domain.id } } });
+    if (!inquiry)
+        return undefined;
+    const viewer = await viewerOf(context);
+    return (0, inquiry_rules_1.mayRead)(inquiry, viewer) ? { inquiry, viewer } : undefined;
+}
+/** The roles of the domain that give `inquiry:mutation` - the handlers' pool. */
+async function handlerRoleIds(domain, tx) {
+    const roles = await (0, shell_1.getRepository)(auth_base_1.Role, tx)
+        .createQueryBuilder('R')
+        .innerJoin('R.privileges', 'P')
+        .where('R.domain = :domain', { domain: domain.id })
+        .andWhere('P.category = :category', { category: 'inquiry' })
+        /* A privilege row's axis is its name. */
+        .andWhere('P.name = :axis', { axis: 'mutation' })
+        .getMany();
+    return roles.map(one => one.id);
+}
+/** The handlers to tell - those in a handler role, and the domain's owner, who handles as owners do. */
+async function handlerUserIds(domain, tx) {
+    const roleIds = await handlerRoleIds(domain, tx);
+    const roles = roleIds.length ? await (0, shell_1.getRepository)(auth_base_1.Role, tx).find({ where: { id: (0, typeorm_1.In)(roleIds) }, relations: ['users'] }) : [];
+    const ids = new Set(roles.flatMap(one => (one.users ?? []).map(user => user.id)));
+    if (domain.owner)
+        ids.add(domain.owner);
+    return [...ids];
+}
+/*
+ * ---------------------------------------------------------------- the handlers' turn, as worklist holds it (decision 7)
+ */
+/**
+ * Opens the handlers' to-do on it, unless one is open: one case, pooled on the handler roles - whoever of them picks it.
+ * With the activity not installed in the domain, or no handler role, there is no to-do: the notice and the badge still
+ * reach the handlers.
+ */
+async function openTodo(inquiry, context) {
+    const { domain, tx } = context.state;
+    if (inquiry.todoInstanceId)
+        return;
+    const activity = await tx.getRepository(worklist_1.Activity).findOne({ where: { domain: { id: domain.id }, name: inquiry_activity_1.INQUIRY_HANDLING } });
+    if (!activity) {
+        env_1.logger.warn(`[inquiry] ${domain.subdomain}: the activity "${inquiry_activity_1.INQUIRY_HANDLING}" is not installed - no to-do for inquiry ${inquiry.id}`);
+        return;
+    }
+    const pool = await handlerRoleIds(domain, tx);
+    if (!pool.length) {
+        env_1.logger.warn(`[inquiry] ${domain.subdomain}: no role gives inquiry handling - no to-do for inquiry ${inquiry.id}`);
+        return;
+    }
+    const name = inquiry.title.slice(0, 200);
+    const instance = await (0, worklist_1.issue)({ name, description: name, activityId: activity.id, input: { inquiryId: inquiry.id }, assignees: [], assigneeRoles: pool, threadsMin: 1 }, context);
+    await tx.getRepository(inquiry_1.Inquiry).update(inquiry.id, { todoInstanceId: instance.id });
+    inquiry.todoInstanceId = instance.id;
+}
+/** Closes the handlers' to-do when it is no longer their turn - left alone when it is closed already. */
+async function closeTodo(inquiry, context, reason) {
+    const { tx } = context.state;
+    if (!inquiry.todoInstanceId)
+        return;
+    const open = await tx.getRepository(worklist_1.ActivityThread).count({ where: { activityInstance: { id: inquiry.todoInstanceId }, state: (0, typeorm_1.In)(['assigned', 'started', 'unassigned']) } });
+    if (open)
+        await (0, worklist_1.abort)({ id: inquiry.todoInstanceId, reason }, context);
+    await tx.getRepository(inquiry_1.Inquiry).update(inquiry.id, { todoInstanceId: null });
+    inquiry.todoInstanceId = null;
+}
+/*
+ * ---------------------------------------------------------------- telling people (decision 7)
+ */
+/** The sentences in `lng` from this module's translations, the English one where `lng` has none. */
+const sayIn = (lng) => (key, english, params = {}) => (0, translator_1.translatorFor)(lng)(key, { ...params, defaultValue: english.replace(/\{(\w+)\}/g, (_, name) => String(params[name] ?? '')) });
+/** The people to tell, as notification takes them - only those who can sign in, each with their mail and language. */
+async function receiversOf(userIds, tx) {
+    if (!userIds.length)
+        return [];
+    const people = await (0, shell_1.getRepository)(auth_base_1.User, tx).find({ where: { id: (0, typeorm_1.In)(userIds) } });
+    return people.filter(one => one.status === auth_base_1.UserStatus.ACTIVATED).map(one => ({ id: one.id, email: one.email, locale: one.locale }));
+}
+/**
+ * Tells `userIds` - never the request's own person - once the request's transaction has committed. A notice that does
+ * not arrive undoes nothing: the list and the badge still reach them.
+ */
+async function tellWhenCommitted(context, one, kind, userIds, said = {}) {
+    const receivers = await receiversOf(userIds.filter(id => id !== context.state.user?.id), context.state.tx);
+    if (!receivers.length)
+        return;
+    const notice = {
+        type: 'inquiry',
+        level: 'info',
+        receivers,
+        words: lng => (0, inquiry_rules_1.noticeWordsOf)(one, kind, said, sayIn(lng)),
+        address: (0, inquiry_rules_1.viewAddressOf)(one.id),
+        link: (0, notification_1.noticeLinkOf)(context, (0, inquiry_rules_1.viewAddressOf)(one.id)),
+        label: `inquiry ${kind} ${one.id}`
+    };
+    (0, notification_1.sendNoticeWhenCommitted)(context, notice);
+}
+//# sourceMappingURL=inquiry-service.js.map

package/dist-server/service/inquiry/inquiry-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inquiry-service.js","sourceRoot":"","sources":["../../../server/service/inquiry/inquiry-service.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * What the doors of inquiries do with the database (ADR-0184 decisions 5-7): who is a handler, who reads one, the\n * handlers' turn as a worklist to-do, and telling people of it through notification.\n */\nimport { EntityManager, In } from 'typeorm'\n\nimport { checkPermission, Role, User, UserStatus } from '@things-factory/auth-base'\nimport { logger } from '@things-factory/env'\nimport { translatorFor } from '@things-factory/i18n-base/translator'\nimport { noticeLinkOf, sendNoticeWhenCommitted, type Notice } from '@things-factory/notification'\nimport { Domain, getRepository } from '@things-factory/shell'\nimport { abort, Activity, ActivityThread, issue } from '@things-factory/worklist'\n\nimport { INQUIRY_HANDLING } from '../../inquiry-activity'\nimport { Inquiry } from './inquiry'\nimport { mayRead, noticeWordsOf, viewAddressOf, type NoticeKind, type Say, type Viewer } from './inquiry-rules'\n\n/** The attachments of an inquiry hang on it under this `refType`, a reply's under the next (attachment-base). */\nexport const INQUIRY_REF_TYPE = 'Inquiry'\nexport const INQUIRY_REPLY_REF_TYPE = 'InquiryReply'\n\n/** Whether the request handles inquiries - the one privilege of the module (`inquiry.answering`). */\nexport async function isHandler(context: any): Promise<boolean> {\n  const state = context?.state ?? {}\n  const { domain, user, unsafeIP, prohibitedPrivileges } = state\n  if (!domain || !user) return false\n  /* Asked once per request - a list asks it for each row. */\n  state.__inquiryHandler ??= checkPermission({ category: 'inquiry', privilege: 'mutation', owner: true } as any, user, domain, unsafeIP, prohibitedPrivileges).then(Boolean)\n  return await state.__inquiryHandler\n}\n\nexport async function viewerOf(context: any): Promise<Viewer> {\n  return { userId: context.state.user.id, handler: await isHandler(context) }\n}\n\n/** The inquiry as the request may read it, or nothing - one answer for \"none\" and \"not yours\". */\nexport async function visibleInquiry(id: string, context: any, tx?: EntityManager): Promise<{ inquiry: Inquiry; viewer: Viewer } | undefined> {\n  const { domain, user } = context?.state ?? {}\n  if (!id || !domain || !user || !/^[0-9a-f-]{36}$/i.test(id)) return undefined\n  const inquiry = await getRepository(Inquiry, tx).findOne({ where: { id, domain: { id: domain.id } } as any })\n  if (!inquiry) return undefined\n  const viewer = await viewerOf(context)\n  return mayRead(inquiry, viewer) ? { inquiry, viewer } : undefined\n}\n\n/** The roles of the domain that give `inquiry:mutation` - the handlers' pool. */\nexport async function handlerRoleIds(domain: Domain, tx?: EntityManager): Promise<string[]> {\n  const roles = await getRepository(Role, tx)\n    .createQueryBuilder('R')\n    .innerJoin('R.privileges', 'P')\n    .where('R.domain = :domain', { domain: domain.id })\n    .andWhere('P.category = :category', { category: 'inquiry' })\n    /* A privilege row's axis is its name. */\n    .andWhere('P.name = :axis', { axis: 'mutation' })\n    .getMany()\n  return roles.map(one => one.id)\n}\n\n/** The handlers to tell - those in a handler role, and the domain's owner, who handles as owners do. */\nexport async function handlerUserIds(domain: Domain, tx?: EntityManager): Promise<string[]> {\n  const roleIds = await handlerRoleIds(domain, tx)\n  const roles = roleIds.length ? await getRepository(Role, tx).find({ where: { id: In(roleIds) } as any, relations: ['users'] }) : []\n  const ids = new Set<string>(roles.flatMap(one => (one.users ?? []).map(user => user.id)))\n  if (domain.owner) ids.add(domain.owner)\n  return [...ids]\n}\n\n/*\n * ---------------------------------------------------------------- the handlers' turn, as worklist holds it (decision 7)\n */\n\n/**\n * Opens the handlers' to-do on it, unless one is open: one case, pooled on the handler roles - whoever of them picks it.\n * With the activity not installed in the domain, or no handler role, there is no to-do: the notice and the badge still\n * reach the handlers.\n */\nexport async function openTodo(inquiry: Inquiry, context: any): Promise<void> {\n  const { domain, tx } = context.state\n  if (inquiry.todoInstanceId) return\n  const activity = await tx.getRepository(Activity).findOne({ where: { domain: { id: domain.id }, name: INQUIRY_HANDLING } as any })\n  if (!activity) {\n    logger.warn(`[inquiry] ${domain.subdomain}: the activity \"${INQUIRY_HANDLING}\" is not installed - no to-do for inquiry ${inquiry.id}`)\n    return\n  }\n  const pool = await handlerRoleIds(domain, tx)\n  if (!pool.length) {\n    logger.warn(`[inquiry] ${domain.subdomain}: no role gives inquiry handling - no to-do for inquiry ${inquiry.id}`)\n    return\n  }\n  const name = inquiry.title.slice(0, 200)\n  const instance = await issue({ name, description: name, activityId: activity.id, input: { inquiryId: inquiry.id }, assignees: [], assigneeRoles: pool, threadsMin: 1 } as any, context)\n  await tx.getRepository(Inquiry).update(inquiry.id, { todoInstanceId: instance.id })\n  inquiry.todoInstanceId = instance.id\n}\n\n/** Closes the handlers' to-do when it is no longer their turn - left alone when it is closed already. */\nexport async function closeTodo(inquiry: Inquiry, context: any, reason: string): Promise<void> {\n  const { tx } = context.state\n  if (!inquiry.todoInstanceId) return\n  const open = await tx.getRepository(ActivityThread).count({ where: { activityInstance: { id: inquiry.todoInstanceId }, state: In(['assigned', 'started', 'unassigned']) } as any })\n  if (open) await abort({ id: inquiry.todoInstanceId, reason } as any, context)\n  await tx.getRepository(Inquiry).update(inquiry.id, { todoInstanceId: null } as any)\n  inquiry.todoInstanceId = null as any\n}\n\n/*\n * ---------------------------------------------------------------- telling people (decision 7)\n */\n\n/** The sentences in `lng` from this module's translations, the English one where `lng` has none. */\nconst sayIn =\n  (lng: string): Say =>\n  (key, english, params = {}) =>\n    translatorFor(lng)(key, { ...params, defaultValue: english.replace(/\\{(\\w+)\\}/g, (_, name) => String(params[name] ?? '')) })\n\n/** The people to tell, as notification takes them - only those who can sign in, each with their mail and language. */\nasync function receiversOf(userIds: string[], tx?: EntityManager) {\n  if (!userIds.length) return []\n  const people = await getRepository(User, tx).find({ where: { id: In(userIds) } as any })\n  return people.filter(one => one.status === UserStatus.ACTIVATED).map(one => ({ id: one.id, email: one.email, locale: (one as any).locale }))\n}\n\n/**\n * Tells `userIds` - never the request's own person - once the request's transaction has committed. A notice that does\n * not arrive undoes nothing: the list and the badge still reach them.\n */\nexport async function tellWhenCommitted(context: any, one: Inquiry, kind: NoticeKind, userIds: string[], said: { body?: string | null; status?: string } = {}): Promise<void> {\n  const receivers = await receiversOf(\n    userIds.filter(id => id !== context.state.user?.id),\n    context.state.tx\n  )\n  if (!receivers.length) return\n  const notice: Notice = {\n    type: 'inquiry',\n    level: 'info',\n    receivers,\n    words: lng => noticeWordsOf(one, kind, said, sayIn(lng)),\n    address: viewAddressOf(one.id),\n    link: noticeLinkOf(context, viewAddressOf(one.id)),\n    label: `inquiry ${kind} ${one.id}`\n  } as Notice\n  sendNoticeWhenCommitted(context, notice)\n}\n"]}

package/dist-server/service/inquiry/inquiry-types.d.ts

@@ -0,0 +1,18 @@
+import { Inquiry } from './inquiry';
+export declare class InquiryInput {
+    kind: string;
+    title: string;
+    body?: string;
+    visibility?: string;
+    pageUrl?: string;
+}
+export declare class InquiryList {
+    items: Inquiry[];
+    total: number;
+}
+export declare class InquirySummary {
+    newAnswers: number;
+    unhandled: number;
+    handler: boolean;
+    badge: number;
+}

package/dist-server/service/inquiry/inquiry-types.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InquirySummary = exports.InquiryList = exports.InquiryInput = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const inquiry_1 = require("./inquiry");
+let InquiryInput = class InquiryInput {
+};
+exports.InquiryInput = InquiryInput;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'QUESTION, BUG or PROPOSAL.' }),
+    tslib_1.__metadata("design:type", String)
+], InquiryInput.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The title.' }),
+    tslib_1.__metadata("design:type", String)
+], InquiryInput.prototype, "title", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The body, plain text.' }),
+    tslib_1.__metadata("design:type", String)
+], InquiryInput.prototype, "body", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'DOMAIN (everyone of the domain reads it, the default) or PRIVATE (its writer and the handlers).' }),
+    tslib_1.__metadata("design:type", String)
+], InquiryInput.prototype, "visibility", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The address of the screen it is written from - the browser sends it.' }),
+    tslib_1.__metadata("design:type", String)
+], InquiryInput.prototype, "pageUrl", void 0);
+exports.InquiryInput = InquiryInput = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)({ description: 'What an inquiry asks, and who reads it.' })
+], InquiryInput);
+let InquiryList = class InquiryList {
+};
+exports.InquiryList = InquiryList;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [inquiry_1.Inquiry], { description: 'The inquiries of the page.' }),
+    tslib_1.__metadata("design:type", Array)
+], InquiryList.prototype, "items", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'How many there are in all.' }),
+    tslib_1.__metadata("design:type", Number)
+], InquiryList.prototype, "total", void 0);
+exports.InquiryList = InquiryList = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'A page of inquiries.' })
+], InquiryList);
+let InquirySummary = class InquirySummary {
+};
+exports.InquirySummary = InquirySummary;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Their own inquiries with a handler\'s word they have not seen.' }),
+    tslib_1.__metadata("design:type", Number)
+], InquirySummary.prototype, "newAnswers", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'For a handler, the inquiries waiting on the handlers - received or in progress; 0 otherwise.' }),
+    tslib_1.__metadata("design:type", Number)
+], InquirySummary.prototype, "unhandled", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Whether the person handles inquiries.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], InquirySummary.prototype, "handler", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'The count the menu shows - new answers, and for a handler those waiting too.' }),
+    tslib_1.__metadata("design:type", Number)
+], InquirySummary.prototype, "badge", void 0);
+exports.InquirySummary = InquirySummary = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: "What the menu counts for the request's person." })
+], InquirySummary);
+//# sourceMappingURL=inquiry-types.js.map

package/dist-server/service/inquiry/inquiry-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inquiry-types.js","sourceRoot":"","sources":["../../../server/service/inquiry/inquiry-types.ts"],"names":[],"mappings":";;;;AAAA,+CAAgE;AAEhE,uCAAmC;AAG5B,IAAM,YAAY,GAAlB,MAAM,YAAY;CAexB,CAAA;AAfY,oCAAY;AAEvB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;;0CACzC;AAGZ;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;;2CACxB;AAGb;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;;0CACnD;AAGb;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,iGAAiG,EAAE,CAAC;;gDACvH;AAGnB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,sEAAsE,EAAE,CAAC;;6CAC/F;uBAdL,YAAY;IADxB,IAAA,wBAAS,EAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;GACzD,YAAY,CAexB;AAGM,IAAM,WAAW,GAAjB,MAAM,WAAW;CAMvB,CAAA;AANY,kCAAW;AAEtB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,iBAAO,CAAC,EAAE,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;;0CACxD;AAGhB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;;0CACrD;sBALF,WAAW;IADvB,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC;GACvC,WAAW,CAMvB;AAGM,IAAM,cAAc,GAApB,MAAM,cAAc;CAY1B,CAAA;AAZY,wCAAc;AAEzB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,gEAAgE,EAAE,CAAC;;kDACpF;AAGlB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,8FAA8F,EAAE,CAAC;;iDACnH;AAGjB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC;;+CAChD;AAGhB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,8EAA8E,EAAE,CAAC;;6CACvG;yBAXF,cAAc;IAD1B,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,gDAAgD,EAAE,CAAC;GACjE,cAAc,CAY1B","sourcesContent":["import { Field, InputType, Int, ObjectType } from 'type-graphql'\n\nimport { Inquiry } from './inquiry'\n\n@InputType({ description: 'What an inquiry asks, and who reads it.' })\nexport class InquiryInput {\n  @Field({ description: 'QUESTION, BUG or PROPOSAL.' })\n  kind: string\n\n  @Field({ description: 'The title.' })\n  title: string\n\n  @Field({ nullable: true, description: 'The body, plain text.' })\n  body?: string\n\n  @Field({ nullable: true, description: 'DOMAIN (everyone of the domain reads it, the default) or PRIVATE (its writer and the handlers).' })\n  visibility?: string\n\n  @Field({ nullable: true, description: 'The address of the screen it is written from - the browser sends it.' })\n  pageUrl?: string\n}\n\n@ObjectType({ description: 'A page of inquiries.' })\nexport class InquiryList {\n  @Field(type => [Inquiry], { description: 'The inquiries of the page.' })\n  items: Inquiry[]\n\n  @Field(type => Int, { description: 'How many there are in all.' })\n  total: number\n}\n\n@ObjectType({ description: \"What the menu counts for the request's person.\" })\nexport class InquirySummary {\n  @Field(type => Int, { description: 'Their own inquiries with a handler\\'s word they have not seen.' })\n  newAnswers: number\n\n  @Field(type => Int, { description: 'For a handler, the inquiries waiting on the handlers - received or in progress; 0 otherwise.' })\n  unhandled: number\n\n  @Field({ description: 'Whether the person handles inquiries.' })\n  handler: boolean\n\n  @Field(type => Int, { description: 'The count the menu shows - new answers, and for a handler those waiting too.' })\n  badge: number\n}\n"]}

package/dist-server/service/inquiry/inquiry.d.ts

@@ -0,0 +1,48 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+export declare class Inquiry {
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    kind: string;
+    title: string;
+    body?: string;
+    status: string;
+    visibility: string;
+    pageUrl?: string;
+    appName?: string;
+    appVersion?: string;
+    assignee?: User;
+    assigneeId?: string;
+    replyCount: number;
+    handlerActivityAt?: Date;
+    askerSeenAt?: Date;
+    answeredAt?: Date;
+    closedAt?: Date;
+    todoInstanceId?: string;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+}
+export declare class InquiryReply {
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    inquiry?: Inquiry;
+    inquiryId?: string;
+    body?: string;
+    byHandler: boolean;
+    answer: boolean;
+    status?: string;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+}