@things-factory/announcement 10.1.248 → 10.1.250

package/dist-client/utils/announcement-api.d.ts

@@ -0,0 +1,149 @@
+export type Audience = {
+    scope: 'DOMAIN' | 'DEPARTMENT' | 'ROLE' | 'USER' | string;
+    targetId: string;
+    targetName?: string | null;
+};
+export type AnnouncementLink = {
+    label: string;
+    url: string;
+};
+export type FileRow = {
+    id: string;
+    name: string;
+    fullpath: string;
+    size?: number;
+    mimetype?: string;
+};
+export type Receipt = {
+    readAt?: string | null;
+    acknowledgedAt?: string | null;
+};
+export type Delivery = {
+    at: string;
+    kind: string;
+    receivers: number;
+    email: {
+        sent: number;
+        failed: number;
+    };
+    teams: {
+        sent: number;
+        failed: number;
+    };
+    failed?: boolean;
+};
+export interface AnnouncementItem {
+    id: string;
+    title: string;
+    body?: string | null;
+    category: string;
+    importance: 'NORMAL' | 'IMPORTANT' | 'URGENT' | string;
+    status: 'DRAFT' | 'SCHEDULED' | 'PUBLISHED' | 'WITHDRAWN' | string;
+    startsAt?: string | null;
+    endsAt?: string | null;
+    pinned: boolean;
+    requiresAcknowledgement: boolean;
+    acknowledgeBy?: string | null;
+    popup: boolean;
+    sendEmail?: boolean;
+    deliveries?: Delivery[] | null;
+    links?: AnnouncementLink[] | null;
+    version: number;
+    publishedAt?: string | null;
+    audienceSize?: number | null;
+    withdrawnAt?: string | null;
+    withdrawReason?: string | null;
+    readerState?: 'unread' | 'read' | 'to-acknowledge' | 'acknowledged';
+    readCount?: number | null;
+    acknowledgedCount?: number | null;
+    editable?: boolean;
+    addressed?: boolean;
+    mine?: Receipt | null;
+    publisher?: {
+        id: string;
+        name?: string;
+    } | null;
+    creator?: {
+        id: string;
+        name?: string;
+    } | null;
+    audiences?: Audience[];
+    attachments?: FileRow[];
+}
+export interface AnnouncementInput {
+    title: string;
+    body?: string;
+    category?: string;
+    importance?: string;
+    startsAt?: string | null;
+    endsAt?: string | null;
+    pinned?: boolean;
+    requiresAcknowledgement?: boolean;
+    acknowledgeBy?: string | null;
+    popup?: boolean;
+    sendEmail?: boolean;
+    links?: AnnouncementLink[];
+    audiences?: Audience[];
+}
+/** The fields a list row needs. */
+export declare const LIST_FIELDS = "id title category importance status startsAt endsAt pinned requiresAcknowledgement acknowledgeBy popup publishedAt version readerState publisher { id name }";
+/** Everything one announcement shows. */
+export declare const FULL_FIELDS = "id title category importance status startsAt endsAt pinned requiresAcknowledgement acknowledgeBy popup publishedAt version readerState publisher { id name } body links sendEmail deliveries audienceSize withdrawnAt withdrawReason editable addressed mine { readAt acknowledgedAt }\n  creator { id name } audiences { scope targetId targetName } attachments { id name fullpath size mimetype }";
+/** Tells the badge and an open list that a reading changed. */
+export declare const announcementsChanged: () => boolean;
+export declare const announcementApi: {
+    one: (id: string) => Promise<AnnouncementItem | null>;
+    summary: () => Promise<{
+        unread: number;
+        toAcknowledge: number;
+        pending: number;
+    }>;
+    popups: () => Promise<AnnouncementItem[]>;
+    read: (id: string) => Promise<AnnouncementItem>;
+    acknowledge: (id: string) => Promise<AnnouncementItem>;
+    receipts: (id: string) => Promise<{
+        userId: string;
+        name?: string;
+        email?: string;
+        listed: boolean;
+        notifiedAt?: string;
+        readAt?: string;
+        acknowledgedAt?: string;
+    }[]>;
+    revisions: (id: string) => Promise<{
+        version: number;
+        title: string;
+        body?: string;
+        rest?: any;
+        createdAt: string;
+        creator?: {
+            name?: string;
+        };
+    }[]>;
+    choices: () => Promise<{
+        domainId: string;
+        domainName: string;
+        departments: {
+            id: string;
+            name: string;
+            note?: string;
+        }[];
+        roles: {
+            id: string;
+            name: string;
+            note?: string;
+        }[];
+    }>;
+    people: (text: string) => Promise<{
+        id: string;
+        name: string;
+        note?: string;
+    }[]>;
+    audienceSize: (audiences: Audience[]) => Promise<number>;
+    create: (input: AnnouncementInput, attach: File[], uploading?: (fraction: number) => void) => Promise<AnnouncementItem>;
+    update: (id: string, input: AnnouncementInput, attach: File[], remove: string[], notifyAgain: boolean, uploading?: (fraction: number) => void) => Promise<AnnouncementItem>;
+    publish: (id: string) => Promise<AnnouncementItem>;
+    withdraw: (id: string, reason: string) => Promise<AnnouncementItem>;
+    remove: (id: string) => Promise<boolean>;
+    remind: (id: string) => Promise<number>;
+};

package/dist-client/utils/announcement-api.js

@@ -0,0 +1,52 @@
+/*
+ * The announcement doors as the screens call them (ADR-0163). Every call throws the server's words when it is refused.
+ */
+import gql from 'graphql-tag';
+import { client, uploadContext } from '@operato/graphql';
+/** The fields a list row needs. */
+export const LIST_FIELDS = `id title category importance status startsAt endsAt pinned requiresAcknowledgement acknowledgeBy popup publishedAt version readerState publisher { id name }`;
+/** Everything one announcement shows. */
+export const FULL_FIELDS = `${LIST_FIELDS} body links sendEmail deliveries audienceSize withdrawnAt withdrawReason editable addressed mine { readAt acknowledgedAt }
+  creator { id name } audiences { scope targetId targetName } attachments { id name fullpath size mimetype }`;
+function answer(response, field) {
+    if (response.errors?.length)
+        throw new Error(response.errors.map((one) => one.message).join(' · '));
+    return response.data?.[field];
+}
+async function ask(query, variables, field) {
+    return answer(await client.query({ query: gql(query), variables, fetchPolicy: 'network-only' }), field);
+}
+async function change(mutation, variables, field, uploading) {
+    return answer(await client.mutate({ mutation: gql(mutation), variables, ...(uploading ? { context: uploadContext(uploading) } : {}) }), field);
+}
+/** Tells the badge and an open list that a reading changed. */
+export const announcementsChanged = () => window.dispatchEvent(new CustomEvent('announcements-changed'));
+export const announcementApi = {
+    one: (id) => ask(`query ($id: String!) { announcement(id: $id) { ${FULL_FIELDS} readCount acknowledgedCount } }`, { id }, 'announcement'),
+    summary: () => ask(`query { announcementSummary { unread toAcknowledge pending } }`, {}, 'announcementSummary'),
+    popups: () => ask(`query { announcementPopups { ${FULL_FIELDS} } }`, {}, 'announcementPopups'),
+    read: async (id) => {
+        const one = await change(`mutation ($id: String!) { readAnnouncement(id: $id) { id readerState mine { readAt acknowledgedAt } } }`, { id }, 'readAnnouncement');
+        announcementsChanged();
+        return one;
+    },
+    acknowledge: async (id) => {
+        const one = await change(`mutation ($id: String!) { acknowledgeAnnouncement(id: $id) { id readerState mine { readAt acknowledgedAt } } }`, { id }, 'acknowledgeAnnouncement');
+        announcementsChanged();
+        return one;
+    },
+    receipts: (id) => ask(`query ($id: String!) { announcementReceipts(id: $id) { userId name email listed notifiedAt readAt acknowledgedAt } }`, { id }, 'announcementReceipts'),
+    revisions: (id) => ask(`query ($id: String!) { announcementRevisions(id: $id) { version title body rest createdAt creator { name } } }`, { id }, 'announcementRevisions'),
+    choices: () => ask(`query { announcementAudienceChoices { domainId domainName departments { id name note } roles { id name note } } }`, {}, 'announcementAudienceChoices'),
+    people: (text) => ask(`query ($text: String!) { announcementPeople(text: $text) { id name note } }`, { text }, 'announcementPeople'),
+    audienceSize: (audiences) => ask(`query ($audiences: [AnnouncementAudienceInput!]!) { announcementAudienceSize(audiences: $audiences) }`, { audiences }, 'announcementAudienceSize'),
+    create: (input, attach, uploading) => change(`mutation ($input: AnnouncementInput!, $attach: [Upload!]) { createAnnouncement(input: $input, attach: $attach) { id } }`, { input, attach }, 'createAnnouncement', attach.length ? uploading ?? (() => { }) : undefined),
+    update: (id, input, attach, remove, notifyAgain, uploading) => change(`mutation ($id: String!, $input: AnnouncementInput!, $attach: [Upload!], $remove: [String!], $notifyAgain: Boolean) {
+        updateAnnouncement(id: $id, input: $input, attach: $attach, remove: $remove, notifyAgain: $notifyAgain) { id status }
+      }`, { id, input, attach, remove, notifyAgain }, 'updateAnnouncement', attach.length ? uploading ?? (() => { }) : undefined),
+    publish: (id) => change(`mutation ($id: String!) { publishAnnouncement(id: $id) { id status startsAt } }`, { id }, 'publishAnnouncement'),
+    withdraw: (id, reason) => change(`mutation ($id: String!, $reason: String!) { withdrawAnnouncement(id: $id, reason: $reason) { id status } }`, { id, reason }, 'withdrawAnnouncement'),
+    remove: (id) => change(`mutation ($id: String!) { deleteAnnouncement(id: $id) }`, { id }, 'deleteAnnouncement'),
+    remind: (id) => change(`mutation ($id: String!) { remindAnnouncement(id: $id) }`, { id }, 'remindAnnouncement')
+};
+//# sourceMappingURL=announcement-api.js.map

package/dist-client/utils/announcement-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcement-api.js","sourceRoot":"","sources":["../../client/utils/announcement-api.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The announcement doors as the screens call them (ADR-0163). Every call throws the server's words when it is refused.\n */\nimport gql from 'graphql-tag'\n\nimport { client, uploadContext } from '@operato/graphql'\n\nexport type Audience = { scope: 'DOMAIN' | 'DEPARTMENT' | 'ROLE' | 'USER' | string; targetId: string; targetName?: string | null }\nexport type AnnouncementLink = { label: string; url: string }\nexport type FileRow = { id: string; name: string; fullpath: string; size?: number; mimetype?: string }\nexport type Receipt = { readAt?: string | null; acknowledgedAt?: string | null }\nexport type Delivery = { at: string; kind: string; receivers: number; email: { sent: number; failed: number }; teams: { sent: number; failed: number }; failed?: boolean }\n\nexport interface AnnouncementItem {\n  id: string\n  title: string\n  body?: string | null\n  category: string\n  importance: 'NORMAL' | 'IMPORTANT' | 'URGENT' | string\n  status: 'DRAFT' | 'SCHEDULED' | 'PUBLISHED' | 'WITHDRAWN' | string\n  startsAt?: string | null\n  endsAt?: string | null\n  pinned: boolean\n  requiresAcknowledgement: boolean\n  acknowledgeBy?: string | null\n  popup: boolean\n  sendEmail?: boolean\n  deliveries?: Delivery[] | null\n  links?: AnnouncementLink[] | null\n  version: number\n  publishedAt?: string | null\n  audienceSize?: number | null\n  withdrawnAt?: string | null\n  withdrawReason?: string | null\n  readerState?: 'unread' | 'read' | 'to-acknowledge' | 'acknowledged'\n  readCount?: number | null\n  acknowledgedCount?: number | null\n  editable?: boolean\n  addressed?: boolean\n  mine?: Receipt | null\n  publisher?: { id: string; name?: string } | null\n  creator?: { id: string; name?: string } | null\n  audiences?: Audience[]\n  attachments?: FileRow[]\n}\n\nexport interface AnnouncementInput {\n  title: string\n  body?: string\n  category?: string\n  importance?: string\n  startsAt?: string | null\n  endsAt?: string | null\n  pinned?: boolean\n  requiresAcknowledgement?: boolean\n  acknowledgeBy?: string | null\n  popup?: boolean\n  sendEmail?: boolean\n  links?: AnnouncementLink[]\n  audiences?: Audience[]\n}\n\n/** The fields a list row needs. */\nexport const LIST_FIELDS = `id title category importance status startsAt endsAt pinned requiresAcknowledgement acknowledgeBy popup publishedAt version readerState publisher { id name }`\n\n/** Everything one announcement shows. */\nexport const FULL_FIELDS = `${LIST_FIELDS} body links sendEmail deliveries audienceSize withdrawnAt withdrawReason editable addressed mine { readAt acknowledgedAt }\n  creator { id name } audiences { scope targetId targetName } attachments { id name fullpath size mimetype }`\n\nfunction answer<T>(response: any, field: string): T {\n  if (response.errors?.length) throw new Error(response.errors.map((one: any) => one.message).join(' · '))\n  return response.data?.[field] as T\n}\n\nasync function ask<T>(query: string, variables: Record<string, unknown>, field: string): Promise<T> {\n  return answer<T>(await client.query({ query: gql(query), variables, fetchPolicy: 'network-only' }), field)\n}\n\nasync function change<T>(mutation: string, variables: Record<string, unknown>, field: string, uploading?: (fraction: number) => void): Promise<T> {\n  return answer<T>(await client.mutate({ mutation: gql(mutation), variables, ...(uploading ? { context: uploadContext(uploading) } : {}) }), field)\n}\n\n/** Tells the badge and an open list that a reading changed. */\nexport const announcementsChanged = () => window.dispatchEvent(new CustomEvent('announcements-changed'))\n\nexport const announcementApi = {\n  one: (id: string) => ask<AnnouncementItem | null>(`query ($id: String!) { announcement(id: $id) { ${FULL_FIELDS} readCount acknowledgedCount } }`, { id }, 'announcement'),\n  summary: () => ask<{ unread: number; toAcknowledge: number; pending: number }>(`query { announcementSummary { unread toAcknowledge pending } }`, {}, 'announcementSummary'),\n  popups: () => ask<AnnouncementItem[]>(`query { announcementPopups { ${FULL_FIELDS} } }`, {}, 'announcementPopups'),\n  read: async (id: string) => {\n    const one = await change<AnnouncementItem>(`mutation ($id: String!) { readAnnouncement(id: $id) { id readerState mine { readAt acknowledgedAt } } }`, { id }, 'readAnnouncement')\n    announcementsChanged()\n    return one\n  },\n  acknowledge: async (id: string) => {\n    const one = await change<AnnouncementItem>(`mutation ($id: String!) { acknowledgeAnnouncement(id: $id) { id readerState mine { readAt acknowledgedAt } } }`, { id }, 'acknowledgeAnnouncement')\n    announcementsChanged()\n    return one\n  },\n  receipts: (id: string) =>\n    ask<{ userId: string; name?: string; email?: string; listed: boolean; notifiedAt?: string; readAt?: string; acknowledgedAt?: string }[]>(\n      `query ($id: String!) { announcementReceipts(id: $id) { userId name email listed notifiedAt readAt acknowledgedAt } }`,\n      { id },\n      'announcementReceipts'\n    ),\n  revisions: (id: string) =>\n    ask<{ version: number; title: string; body?: string; rest?: any; createdAt: string; creator?: { name?: string } }[]>(\n      `query ($id: String!) { announcementRevisions(id: $id) { version title body rest createdAt creator { name } } }`,\n      { id },\n      'announcementRevisions'\n    ),\n  choices: () =>\n    ask<{ domainId: string; domainName: string; departments: { id: string; name: string; note?: string }[]; roles: { id: string; name: string; note?: string }[] }>(\n      `query { announcementAudienceChoices { domainId domainName departments { id name note } roles { id name note } } }`,\n      {},\n      'announcementAudienceChoices'\n    ),\n  people: (text: string) => ask<{ id: string; name: string; note?: string }[]>(`query ($text: String!) { announcementPeople(text: $text) { id name note } }`, { text }, 'announcementPeople'),\n  audienceSize: (audiences: Audience[]) =>\n    ask<number>(`query ($audiences: [AnnouncementAudienceInput!]!) { announcementAudienceSize(audiences: $audiences) }`, { audiences }, 'announcementAudienceSize'),\n  create: (input: AnnouncementInput, attach: File[], uploading?: (fraction: number) => void) =>\n    change<AnnouncementItem>(\n      `mutation ($input: AnnouncementInput!, $attach: [Upload!]) { createAnnouncement(input: $input, attach: $attach) { id } }`,\n      { input, attach },\n      'createAnnouncement',\n      attach.length ? uploading ?? (() => {}) : undefined\n    ),\n  update: (id: string, input: AnnouncementInput, attach: File[], remove: string[], notifyAgain: boolean, uploading?: (fraction: number) => void) =>\n    change<AnnouncementItem>(\n      `mutation ($id: String!, $input: AnnouncementInput!, $attach: [Upload!], $remove: [String!], $notifyAgain: Boolean) {\n        updateAnnouncement(id: $id, input: $input, attach: $attach, remove: $remove, notifyAgain: $notifyAgain) { id status }\n      }`,\n      { id, input, attach, remove, notifyAgain },\n      'updateAnnouncement',\n      attach.length ? uploading ?? (() => {}) : undefined\n    ),\n  publish: (id: string) => change<AnnouncementItem>(`mutation ($id: String!) { publishAnnouncement(id: $id) { id status startsAt } }`, { id }, 'publishAnnouncement'),\n  withdraw: (id: string, reason: string) =>\n    change<AnnouncementItem>(`mutation ($id: String!, $reason: String!) { withdrawAnnouncement(id: $id, reason: $reason) { id status } }`, { id, reason }, 'withdrawAnnouncement'),\n  remove: (id: string) => change<boolean>(`mutation ($id: String!) { deleteAnnouncement(id: $id) }`, { id }, 'deleteAnnouncement'),\n  remind: (id: string) => change<number>(`mutation ($id: String!) { remindAnnouncement(id: $id) }`, { id }, 'remindAnnouncement')\n}\n"]}

package/dist-client/utils/announcement-badge.d.ts

@@ -0,0 +1,4 @@
+/** Asks the server again and tells every badge. A count that could not be asked is not zero: it draws nothing. */
+export declare function refreshAnnouncementBadge(): Promise<void>;
+/** One badge's counts. The menu asks for a new one when it draws again; the one before it then ends, as worklist's do. */
+export declare function generateAnnouncementBadge(): AsyncGenerator<number | undefined, void, unknown>;

package/dist-client/utils/announcement-badge.js

@@ -0,0 +1,47 @@
+/*
+ * The count the menu shows on 공지 - current announcements still owed reading or acknowledging (ADR-0163 decision 5).
+ * An application puts `generateAnnouncementBadge` on its menu entry; the count is asked again whenever an announcement
+ * arrives or a reading changes.
+ */
+import { announcementApi } from './announcement-api.js';
+let count;
+/* One more each time the count is asked again - a badge that was busy drawing the last one still sees the next. */
+let version = 0;
+const waiting = new Set();
+/** Asks the server again and tells every badge. A count that could not be asked is not zero: it draws nothing. */
+export async function refreshAnnouncementBadge() {
+    try {
+        count = (await announcementApi.summary()).pending;
+    }
+    catch {
+        count = undefined;
+    }
+    version++;
+    for (const wake of [...waiting])
+        wake();
+}
+let generation = 0;
+/** One badge's counts. The menu asks for a new one when it draws again; the one before it then ends, as worklist's do. */
+export async function* generateAnnouncementBadge() {
+    const mine = ++generation;
+    for (const wake of [...waiting])
+        wake();
+    let seen = version;
+    yield count;
+    while (true) {
+        if (seen === version) {
+            await new Promise(resolve => {
+                const wake = () => {
+                    waiting.delete(wake);
+                    resolve();
+                };
+                waiting.add(wake);
+            });
+        }
+        if (mine !== generation)
+            return;
+        seen = version;
+        yield count;
+    }
+}
+//# sourceMappingURL=announcement-badge.js.map

package/dist-client/utils/announcement-badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcement-badge.js","sourceRoot":"","sources":["../../client/utils/announcement-badge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,IAAI,KAAyB,CAAA;AAC7B,mHAAmH;AACnH,IAAI,OAAO,GAAG,CAAC,CAAA;AACf,MAAM,OAAO,GAAG,IAAI,GAAG,EAAc,CAAA;AAErC,kHAAkH;AAClH,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,IAAI,CAAC;QACH,KAAK,GAAG,CAAC,MAAM,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAA;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,GAAG,SAAS,CAAA;IACnB,CAAC;IACD,OAAO,EAAE,CAAA;IACT,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,CAAA;AACzC,CAAC;AAED,IAAI,UAAU,GAAG,CAAC,CAAA;AAElB,0HAA0H;AAC1H,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,yBAAyB;IAC9C,MAAM,IAAI,GAAG,EAAE,UAAU,CAAA;IACzB,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,CAAA;IACvC,IAAI,IAAI,GAAG,OAAO,CAAA;IAClB,MAAM,KAAK,CAAA;IACX,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,MAAM,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;gBAChC,MAAM,IAAI,GAAG,GAAG,EAAE;oBAChB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;oBACpB,OAAO,EAAE,CAAA;gBACX,CAAC,CAAA;gBACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACnB,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,IAAI,KAAK,UAAU;YAAE,OAAM;QAC/B,IAAI,GAAG,OAAO,CAAA;QACd,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC","sourcesContent":["/*\n * The count the menu shows on 공지 - current announcements still owed reading or acknowledging (ADR-0163 decision 5).\n * An application puts `generateAnnouncementBadge` on its menu entry; the count is asked again whenever an announcement\n * arrives or a reading changes.\n */\nimport { announcementApi } from './announcement-api.js'\n\nlet count: number | undefined\n/* One more each time the count is asked again - a badge that was busy drawing the last one still sees the next. */\nlet version = 0\nconst waiting = new Set<() => void>()\n\n/** Asks the server again and tells every badge. A count that could not be asked is not zero: it draws nothing. */\nexport async function refreshAnnouncementBadge(): Promise<void> {\n  try {\n    count = (await announcementApi.summary()).pending\n  } catch {\n    count = undefined\n  }\n  version++\n  for (const wake of [...waiting]) wake()\n}\n\nlet generation = 0\n\n/** One badge's counts. The menu asks for a new one when it draws again; the one before it then ends, as worklist's do. */\nexport async function* generateAnnouncementBadge() {\n  const mine = ++generation\n  for (const wake of [...waiting]) wake()\n  let seen = version\n  yield count\n  while (true) {\n    if (seen === version) {\n      await new Promise<void>(resolve => {\n        const wake = () => {\n          waiting.delete(wake)\n          resolve()\n        }\n        waiting.add(wake)\n      })\n    }\n    if (mine !== generation) return\n    seen = version\n    yield count\n  }\n}\n"]}

package/dist-client/utils/announcement-words.d.ts

@@ -0,0 +1,11 @@
+export declare const t: (key: string, options?: Record<string, unknown>) => string;
+export declare const CATEGORIES: string[];
+export declare const IMPORTANCES: string[];
+export declare const categoryWord: (code?: string | null) => string;
+export declare const importanceWord: (code?: string | null) => string;
+export declare const statusWord: (code?: string | null) => string;
+export declare const readerStateWord: (state?: string | null) => string;
+/** A day and time as the reader's locale writes it. */
+export declare function when(value?: string | Date | null, withTime?: boolean): string;
+/** The words of a refusal the server gave, or the fallback. */
+export declare const reasonOf: (error: unknown) => string;

package/dist-client/utils/announcement-words.js

@@ -0,0 +1,23 @@
+/*
+ * The words and marks of announcements - one place for the list, the screen and the popup.
+ */
+import { i18next } from '@operato/i18n';
+export const t = (key, options = {}) => String(i18next.t(key, options));
+export const CATEGORIES = ['GENERAL', 'HR', 'WELFARE', 'EVENT', 'SYSTEM', 'SECURITY'];
+export const IMPORTANCES = ['NORMAL', 'IMPORTANT', 'URGENT'];
+export const categoryWord = (code) => (code ? t(`announcement.category.${code}`, { defaultValue: code }) : '');
+export const importanceWord = (code) => (code ? t(`announcement.importance.${code}`, { defaultValue: code }) : '');
+export const statusWord = (code) => (code ? t(`announcement.status.${code}`, { defaultValue: code }) : '');
+export const readerStateWord = (state) => (state ? t(`announcement.reader-state.${state}`, { defaultValue: state }) : '');
+/** A day and time as the reader's locale writes it. */
+export function when(value, withTime = true) {
+    if (!value)
+        return '';
+    const date = new Date(value);
+    return withTime
+        ? date.toLocaleString(i18next.language, { year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit' })
+        : date.toLocaleDateString(i18next.language, { year: 'numeric', month: '2-digit', day: '2-digit' });
+}
+/** The words of a refusal the server gave, or the fallback. */
+export const reasonOf = (error) => error?.message || t('announcement.text.failed');
+//# sourceMappingURL=announcement-words.js.map

package/dist-client/utils/announcement-words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcement-words.js","sourceRoot":"","sources":["../../client/utils/announcement-words.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAW,EAAE,UAAmC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAA;AAExG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAA;AACrF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAA;AAE5D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAoB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAyB,IAAI,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAC9H,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAoB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,2BAA2B,IAAI,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAClI,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAoB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB,IAAI,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAC1H,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAqB,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,6BAA6B,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAEzI,uDAAuD;AACvD,MAAM,UAAU,IAAI,CAAC,KAA4B,EAAE,QAAQ,GAAG,IAAI;IAChE,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5B,OAAO,QAAQ;QACb,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAClI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAA;AACtG,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAE,EAAE,CAAE,KAAe,EAAE,OAAO,IAAI,CAAC,CAAC,0BAA0B,CAAC,CAAA","sourcesContent":["/*\n * The words and marks of announcements - one place for the list, the screen and the popup.\n */\nimport { i18next } from '@operato/i18n'\n\nexport const t = (key: string, options: Record<string, unknown> = {}) => String(i18next.t(key, options))\n\nexport const CATEGORIES = ['GENERAL', 'HR', 'WELFARE', 'EVENT', 'SYSTEM', 'SECURITY']\nexport const IMPORTANCES = ['NORMAL', 'IMPORTANT', 'URGENT']\n\nexport const categoryWord = (code?: string | null) => (code ? t(`announcement.category.${code}`, { defaultValue: code }) : '')\nexport const importanceWord = (code?: string | null) => (code ? t(`announcement.importance.${code}`, { defaultValue: code }) : '')\nexport const statusWord = (code?: string | null) => (code ? t(`announcement.status.${code}`, { defaultValue: code }) : '')\nexport const readerStateWord = (state?: string | null) => (state ? t(`announcement.reader-state.${state}`, { defaultValue: state }) : '')\n\n/** A day and time as the reader's locale writes it. */\nexport function when(value?: string | Date | null, withTime = true): string {\n  if (!value) return ''\n  const date = new Date(value)\n  return withTime\n    ? date.toLocaleString(i18next.language, { year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit' })\n    : date.toLocaleDateString(i18next.language, { year: 'numeric', month: '2-digit', day: '2-digit' })\n}\n\n/** The words of a refusal the server gave, or the fallback. */\nexport const reasonOf = (error: unknown) => (error as Error)?.message || t('announcement.text.failed')\n"]}

package/dist-server/announcement-read.d.ts

@@ -0,0 +1,6 @@
+import { type ListRead } from '@things-factory/ai-assistant';
+export declare const ANNOUNCEMENT_LIST_READ: ListRead;
+/** The keys an application's assistant mode names in its `readTargets` to read announcements. */
+export declare const ANNOUNCEMENT_READ_TARGETS: string[];
+/** At boot: the assistant may read the announcements, in a mode that names them. */
+export declare function registerAnnouncementReads(): void;

package/dist-server/announcement-read.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ANNOUNCEMENT_READ_TARGETS = exports.ANNOUNCEMENT_LIST_READ = void 0;
+exports.registerAnnouncementReads = registerAnnouncementReads;
+const ai_assistant_1 = require("@things-factory/ai-assistant");
+const announcement_rules_1 = require("./service/announcement/announcement-rules");
+/*
+ * 공지사항 as the assistant reads it (ADR-0163 decision 8) - the readers' own list query, as the person: only what is
+ * addressed to them and out, with their own reading of each. So it is `mine` - a card made of it shows each viewer
+ * their own announcements - and it is a source for 나의 대시보드 cards (ADR-0160) as every read target is.
+ *
+ * `status` narrows by the reader's state (unread, to acknowledge …), which the server works out from the reader's own
+ * receipts; `period` (current | past) is a column, a card's match keeps the current ones.
+ */
+exports.ANNOUNCEMENT_LIST_READ = {
+    key: 'announcement.list',
+    title: 'announcement.title.list',
+    name: 'Announcements (공지사항) addressed to the person - current and past, each with their own reading state (unread, read, to-acknowledge, acknowledged)',
+    listQuery: 'announcements',
+    selection: 'id title body category importance pinned requiresAcknowledgement acknowledgeBy publishedAt endsAt period readerState publisher { name }',
+    columns: [
+        { name: 'title', type: 'string', labelKey: 'announcement.field.title' },
+        { name: 'category', type: 'string', labelKey: 'announcement.field.category', words: 'announcement.category.' },
+        { name: 'importance', type: 'string', labelKey: 'announcement.field.importance', words: 'announcement.importance.' },
+        { name: 'readerState', type: 'string', labelKey: 'announcement.field.reader-state', words: 'announcement.reader-state.' },
+        { name: 'period', type: 'string', labelKey: 'announcement.text.period', words: 'announcement.period.' },
+        { name: 'publishedAt', type: 'date', labelKey: 'announcement.field.published-at' },
+        { name: 'endsAt', type: 'date', labelKey: 'announcement.field.ends-at' },
+        { name: 'acknowledgeBy', type: 'date', labelKey: 'announcement.field.acknowledge-by' },
+        { name: 'publisher', path: 'publisher.name', type: 'string', labelKey: 'announcement.field.publisher' },
+        { name: 'body', type: 'string' }
+    ],
+    dateField: 'publishedAt',
+    status: { field: 'readerState', values: [...announcement_rules_1.READER_STATES] },
+    search: 'fields title, body, category',
+    route: 'announcement-list',
+    mine: true
+};
+/** The keys an application's assistant mode names in its `readTargets` to read announcements. */
+exports.ANNOUNCEMENT_READ_TARGETS = [exports.ANNOUNCEMENT_LIST_READ.key];
+/** At boot: the assistant may read the announcements, in a mode that names them. */
+function registerAnnouncementReads() {
+    (0, ai_assistant_1.registerReadTarget)((0, ai_assistant_1.listReadTarget)(exports.ANNOUNCEMENT_LIST_READ));
+}
+//# sourceMappingURL=announcement-read.js.map

package/dist-server/announcement-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcement-read.js","sourceRoot":"","sources":["../server/announcement-read.ts"],"names":[],"mappings":";;;AAyCA,8DAEC;AA3CD,+DAAgG;AAEhG,kFAAyE;AAEzE;;;;;;;GAOG;AACU,QAAA,sBAAsB,GAAa;IAC9C,GAAG,EAAE,mBAAmB;IACxB,KAAK,EAAE,yBAAyB;IAChC,IAAI,EAAE,iJAAiJ;IACvJ,SAAS,EAAE,eAAe;IAC1B,SAAS,EAAE,yIAAyI;IACpJ,OAAO,EAAE;QACP,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,0BAA0B,EAAE;QACvE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,6BAA6B,EAAE,KAAK,EAAE,wBAAwB,EAAE;QAC9G,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,+BAA+B,EAAE,KAAK,EAAE,0BAA0B,EAAE;QACpH,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,iCAAiC,EAAE,KAAK,EAAE,4BAA4B,EAAE;QACzH,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,0BAA0B,EAAE,KAAK,EAAE,sBAAsB,EAAE;QACvG,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iCAAiC,EAAE;QAClF,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,4BAA4B,EAAE;QACxE,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,mCAAmC,EAAE;QACtF,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,8BAA8B,EAAE;QACvG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;KACjC;IACD,SAAS,EAAE,aAAa;IACxB,MAAM,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,GAAG,kCAAa,CAAC,EAAE;IAC5D,MAAM,EAAE,8BAA8B;IACtC,KAAK,EAAE,mBAAmB;IAC1B,IAAI,EAAE,IAAI;CACX,CAAA;AAED,iGAAiG;AACpF,QAAA,yBAAyB,GAAG,CAAC,8BAAsB,CAAC,GAAG,CAAC,CAAA;AAErE,oFAAoF;AACpF,SAAgB,yBAAyB;IACvC,IAAA,iCAAkB,EAAC,IAAA,6BAAc,EAAC,8BAAsB,CAAC,CAAC,CAAA;AAC5D,CAAC","sourcesContent":["import { listReadTarget, registerReadTarget, type ListRead } from '@things-factory/ai-assistant'\n\nimport { READER_STATES } from './service/announcement/announcement-rules'\n\n/*\n * 공지사항 as the assistant reads it (ADR-0163 decision 8) - the readers' own list query, as the person: only what is\n * addressed to them and out, with their own reading of each. So it is `mine` - a card made of it shows each viewer\n * their own announcements - and it is a source for 나의 대시보드 cards (ADR-0160) as every read target is.\n *\n * `status` narrows by the reader's state (unread, to acknowledge …), which the server works out from the reader's own\n * receipts; `period` (current | past) is a column, a card's match keeps the current ones.\n */\nexport const ANNOUNCEMENT_LIST_READ: ListRead = {\n  key: 'announcement.list',\n  title: 'announcement.title.list',\n  name: 'Announcements (공지사항) addressed to the person - current and past, each with their own reading state (unread, read, to-acknowledge, acknowledged)',\n  listQuery: 'announcements',\n  selection: 'id title body category importance pinned requiresAcknowledgement acknowledgeBy publishedAt endsAt period readerState publisher { name }',\n  columns: [\n    { name: 'title', type: 'string', labelKey: 'announcement.field.title' },\n    { name: 'category', type: 'string', labelKey: 'announcement.field.category', words: 'announcement.category.' },\n    { name: 'importance', type: 'string', labelKey: 'announcement.field.importance', words: 'announcement.importance.' },\n    { name: 'readerState', type: 'string', labelKey: 'announcement.field.reader-state', words: 'announcement.reader-state.' },\n    { name: 'period', type: 'string', labelKey: 'announcement.text.period', words: 'announcement.period.' },\n    { name: 'publishedAt', type: 'date', labelKey: 'announcement.field.published-at' },\n    { name: 'endsAt', type: 'date', labelKey: 'announcement.field.ends-at' },\n    { name: 'acknowledgeBy', type: 'date', labelKey: 'announcement.field.acknowledge-by' },\n    { name: 'publisher', path: 'publisher.name', type: 'string', labelKey: 'announcement.field.publisher' },\n    { name: 'body', type: 'string' }\n  ],\n  dateField: 'publishedAt',\n  status: { field: 'readerState', values: [...READER_STATES] },\n  search: 'fields title, body, category',\n  route: 'announcement-list',\n  mine: true\n}\n\n/** The keys an application's assistant mode names in its `readTargets` to read announcements. */\nexport const ANNOUNCEMENT_READ_TARGETS = [ANNOUNCEMENT_LIST_READ.key]\n\n/** At boot: the assistant may read the announcements, in a mode that names them. */\nexport function registerAnnouncementReads(): void {\n  registerReadTarget(listReadTarget(ANNOUNCEMENT_LIST_READ))\n}\n"]}

package/dist-server/attachment-reader.d.ts

@@ -0,0 +1 @@
+export declare function registerAnnouncementFiles(): void;

package/dist-server/attachment-reader.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAnnouncementFiles = registerAnnouncementFiles;
+/*
+ * Who may open an announcement's file by its path - whoever may see the announcement (ADR-0163 decision 2): its audience
+ * once it is out, its writers. attachment-base has already checked the file is of the request's domain.
+ */
+const attachment_base_1 = require("@things-factory/attachment-base");
+const announcement_service_1 = require("./service/announcement/announcement-service");
+function registerAnnouncementFiles() {
+    (0, attachment_base_1.registerAttachmentReader)(announcement_service_1.ANNOUNCEMENT_REF_TYPE, async (attachment, context) => !!attachment.refBy && !!(await (0, announcement_service_1.visibleAnnouncement)(attachment.refBy, context)));
+}
+//# sourceMappingURL=attachment-reader.js.map

package/dist-server/attachment-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-reader.js","sourceRoot":"","sources":["../server/attachment-reader.ts"],"names":[],"mappings":";;AAQA,8DAEC;AAVD;;;GAGG;AACH,qEAA0E;AAE1E,sFAAwG;AAExG,SAAgB,yBAAyB;IACvC,IAAA,0CAAwB,EAAC,4CAAqB,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,IAAA,0CAAmB,EAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;AAChK,CAAC","sourcesContent":["/*\n * Who may open an announcement's file by its path - whoever may see the announcement (ADR-0163 decision 2): its audience\n * once it is out, its writers. attachment-base has already checked the file is of the request's domain.\n */\nimport { registerAttachmentReader } from '@things-factory/attachment-base'\n\nimport { ANNOUNCEMENT_REF_TYPE, visibleAnnouncement } from './service/announcement/announcement-service'\n\nexport function registerAnnouncementFiles(): void {\n  registerAttachmentReader(ANNOUNCEMENT_REF_TYPE, async (attachment, context) => !!attachment.refBy && !!(await visibleAnnouncement(attachment.refBy, context)))\n}\n"]}

package/dist-server/index.d.ts

@@ -0,0 +1,2 @@
+export * from './service';
+export { ANNOUNCEMENT_LIST_READ, ANNOUNCEMENT_READ_TARGETS } from './announcement-read';

package/dist-server/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ANNOUNCEMENT_READ_TARGETS = exports.ANNOUNCEMENT_LIST_READ = void 0;
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./service"), exports);
+var announcement_read_1 = require("./announcement-read");
+Object.defineProperty(exports, "ANNOUNCEMENT_LIST_READ", { enumerable: true, get: function () { return announcement_read_1.ANNOUNCEMENT_LIST_READ; } });
+Object.defineProperty(exports, "ANNOUNCEMENT_READ_TARGETS", { enumerable: true, get: function () { return announcement_read_1.ANNOUNCEMENT_READ_TARGETS; } });
+const auth_base_1 = require("@things-factory/auth-base");
+const announcement_read_2 = require("./announcement-read");
+const attachment_reader_1 = require("./attachment-reader");
+const role_tasks_1 = require("./role-tasks");
+const announcement_service_1 = require("./service/announcement/announcement-service");
+for (const task of role_tasks_1.ROLE_TASKS)
+    (0, auth_base_1.registerRoleTask)(task);
+(0, attachment_reader_1.registerAnnouncementFiles)();
+(0, announcement_read_2.registerAnnouncementReads)();
+/* Scheduled announcements go out at their start (ADR-0163 decision 4). */
+process.on('bootstrap-module-start', () => (0, announcement_service_1.schedulePublishing)());
+//# sourceMappingURL=index.js.map

package/dist-server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;;AAAA,oDAAyB;AACzB,yDAAuF;AAA9E,2HAAA,sBAAsB,OAAA;AAAE,8HAAA,yBAAyB,OAAA;AAE1D,yDAA4D;AAE5D,2DAA+D;AAC/D,2DAA+D;AAC/D,6CAAyC;AACzC,sFAAgF;AAEhF,KAAK,MAAM,IAAI,IAAI,uBAAU;IAAE,IAAA,4BAAgB,EAAC,IAAI,CAAC,CAAA;AACrD,IAAA,6CAAyB,GAAE,CAAA;AAC3B,IAAA,6CAAyB,GAAE,CAAA;AAE3B,0EAA0E;AAC1E,OAAO,CAAC,EAAE,CAAC,wBAA+B,EAAE,GAAG,EAAE,CAAC,IAAA,yCAAkB,GAAE,CAAC,CAAA","sourcesContent":["export * from './service'\nexport { ANNOUNCEMENT_LIST_READ, ANNOUNCEMENT_READ_TARGETS } from './announcement-read'\n\nimport { registerRoleTask } from '@things-factory/auth-base'\n\nimport { registerAnnouncementReads } from './announcement-read'\nimport { registerAnnouncementFiles } from './attachment-reader'\nimport { ROLE_TASKS } from './role-tasks'\nimport { schedulePublishing } from './service/announcement/announcement-service'\n\nfor (const task of ROLE_TASKS) registerRoleTask(task)\nregisterAnnouncementFiles()\nregisterAnnouncementReads()\n\n/* Scheduled announcements go out at their start (ADR-0163 decision 4). */\nprocess.on('bootstrap-module-start' as any, () => schedulePublishing())\n"]}

package/dist-server/role-tasks.d.ts

@@ -0,0 +1,2 @@
+import type { RoleTask } from '@things-factory/auth-base';
+export declare const ROLE_TASKS: RoleTask[];

package/dist-server/role-tasks.js

@@ -0,0 +1,13 @@
+"use strict";
+/*
+ * The work this module names, for the seats applications build (ADR-0139 decision 11).
+ *
+ * Reading announcements is no task: an announcement is read by the people it names (ADR-0163 decision 2). Writing,
+ * publishing, withdrawing and seeing who read them is `announcement.writing`.
+ *
+ * Data only - `server/index.ts` registers it - so an application's tests read it without starting the framework.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_TASKS = void 0;
+exports.ROLE_TASKS = [{ id: 'announcement.writing', grants: [{ category: 'announcement', axes: ['mutation'] }] }];
+//# sourceMappingURL=role-tasks.js.map

package/dist-server/role-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-tasks.js","sourceRoot":"","sources":["../server/role-tasks.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAIU,QAAA,UAAU,GAAe,CAAC,EAAE,EAAE,EAAE,sBAAsB,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA","sourcesContent":["/*\n * The work this module names, for the seats applications build (ADR-0139 decision 11).\n *\n * Reading announcements is no task: an announcement is read by the people it names (ADR-0163 decision 2). Writing,\n * publishing, withdrawing and seeing who read them is `announcement.writing`.\n *\n * Data only - `server/index.ts` registers it - so an application's tests read it without starting the framework.\n */\n\nimport type { RoleTask } from '@things-factory/auth-base'\n\nexport const ROLE_TASKS: RoleTask[] = [{ id: 'announcement.writing', grants: [{ category: 'announcement', axes: ['mutation'] }] }]\n"]}

package/dist-server/service/announcement/announcement-resolver.d.ts

@@ -0,0 +1,38 @@
+import type { FileUpload } from 'graphql-upload/GraphQLUpload.js';
+import { Attachment } from '@things-factory/attachment-base';
+import { User } from '@things-factory/auth-base';
+import { ListParam } from '@things-factory/shell';
+import { Announcement, AnnouncementAudience, AnnouncementReceipt, AnnouncementRevision } from './announcement';
+import { AnnouncementAudienceChoices, AnnouncementAudienceInput, AnnouncementChoice, AnnouncementInput, AnnouncementList, AnnouncementReceiptRow, AnnouncementSummary } from './announcement-types';
+export declare class AnnouncementResolver {
+    announcements(params: ListParam, context: ResolverContext): Promise<AnnouncementList>;
+    announcement(id: string, context: ResolverContext): Promise<Announcement | undefined>;
+    announcementSummary(context: ResolverContext): Promise<AnnouncementSummary>;
+    announcementPopups(context: ResolverContext): Promise<Announcement[]>;
+    readAnnouncement(id: string, context: ResolverContext): Promise<Announcement>;
+    acknowledgeAnnouncement(id: string, context: ResolverContext): Promise<Announcement>;
+    private receive;
+    managedAnnouncements(params: ListParam, context: ResolverContext): Promise<AnnouncementList>;
+    announcementReceipts(id: string, context: ResolverContext): Promise<AnnouncementReceiptRow[]>;
+    announcementRevisions(id: string, context: ResolverContext): Promise<AnnouncementRevision[]>;
+    announcementAudienceChoices(context: ResolverContext): Promise<AnnouncementAudienceChoices>;
+    announcementPeople(text: string, context: ResolverContext): Promise<AnnouncementChoice[]>;
+    announcementAudienceSize(audiences: AnnouncementAudienceInput[], context: ResolverContext): Promise<number>;
+    createAnnouncement(input: AnnouncementInput, attach: FileUpload[], context: ResolverContext): Promise<Announcement>;
+    updateAnnouncement(id: string, input: AnnouncementInput, attach: FileUpload[], remove: string[], notifyAgain: boolean, context: ResolverContext): Promise<Announcement>;
+    publishAnnouncement(id: string, context: ResolverContext): Promise<Announcement>;
+    withdrawAnnouncement(id: string, reason: string, context: ResolverContext): Promise<Announcement>;
+    deleteAnnouncement(id: string, context: ResolverContext): Promise<boolean>;
+    remindAnnouncement(id: string, context: ResolverContext): Promise<number>;
+    audiences(one: Announcement): Promise<AnnouncementAudience[]>;
+    attachments(one: Announcement, context: ResolverContext): Promise<Attachment[]>;
+    mine(one: Announcement, context: ResolverContext): Promise<AnnouncementReceipt | null>;
+    addressed(one: Announcement, context: ResolverContext): Promise<boolean>;
+    period(one: Announcement): string | undefined;
+    readerState(one: Announcement, context: ResolverContext): Promise<string>;
+    readCount(one: Announcement, context: ResolverContext): Promise<number | null>;
+    acknowledgedCount(one: Announcement, context: ResolverContext): Promise<number | null>;
+    editable(one: Announcement, context: ResolverContext): Promise<boolean>;
+    publisher(one: Announcement): Promise<User | null>;
+    creator(one: Announcement): Promise<User | null>;
+}