@assemora/notifications 0.1.0

package/dist/jobs.js

@@ -0,0 +1,59 @@
+/**
+ * The sending itself (SPEC.md §82).
+ *
+ * One job per delivery, dispatched by `notifications.send` and handed to the queue
+ * only once the outermost transaction commits (ADR-0023) — so a rollback tells nobody,
+ * and the network call happens after the request that caused it has answered.
+ *
+ * The handler sends and then executes a command to write down what happened, rather
+ * than writing the row itself: a job is not a mutation, and the rows it changes go
+ * through the Command Bus like every other row (SPEC.md §14). It executes it by name
+ * so that this file does not import the file that dispatches this job.
+ */
+import { job } from '@assemora/core';
+import { uuid } from '@assemora/schema';
+import { channelNamed, isRejection } from './channel.js';
+import { NotificationDelivery } from './models.js';
+export const DeliverNotification = job('notifications.deliver', {
+    description: 'Sends one notification over its channel and records what came back',
+    input: { deliveryId: uuid() },
+    handle: async ({ deliveryId }, context) => {
+        const delivery = await NotificationDelivery.find(deliveryId);
+        // The row is gone, or somebody has already sent it. A queue delivers at least
+        // once, so a worker killed between the send and the record hands this to another
+        // worker — and the second one must not send the kitchen a duplicate.
+        if (delivery === null || delivery.status === 'sent')
+            return;
+        const channel = channelNamed(delivery.channel);
+        if (channel === undefined) {
+            await context.commands.execute('notifications.record', {
+                deliveryId,
+                outcome: 'failed',
+                error: `No channel named "${delivery.channel}" is configured`,
+            });
+            return;
+        }
+        try {
+            await channel.send(delivery.address, { text: delivery.body });
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            await context.commands.execute('notifications.record', {
+                deliveryId,
+                outcome: 'failed',
+                error: reason,
+            });
+            // A rejection is the channel's final answer — a chat that does not exist will
+            // not start existing on the third attempt, and a queue retrying it spends the
+            // afternoon on a typo. Everything else is a moment that has passed by the time
+            // the queue tries again, so it is rethrown and the adapter decides when
+            // (ADR-0023).
+            if (isRejection(error))
+                return;
+            throw error;
+        }
+        await context.commands.execute('notifications.record', { deliveryId, outcome: 'sent' });
+    },
+});
+export const notificationJobs = [DeliverNotification];
+//# sourceMappingURL=jobs.js.map

package/dist/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAEvC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC,uBAAuB,EAAE;IAC9D,WAAW,EAAE,oEAAoE;IACjF,KAAK,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;IAC7B,MAAM,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE;QACxC,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAE5D,8EAA8E;QAC9E,iFAAiF;QACjF,qEAAqE;QACrE,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM;YAAE,OAAM;QAE3D,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAE9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,sBAAsB,EAAE;gBACrD,UAAU;gBACV,OAAO,EAAE,QAAQ;gBACjB,KAAK,EAAE,qBAAqB,QAAQ,CAAC,OAAO,iBAAiB;aAC9D,CAAC,CAAA;YAEF,OAAM;QACR,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAErE,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,sBAAsB,EAAE;gBACrD,UAAU;gBACV,OAAO,EAAE,QAAQ;gBACjB,KAAK,EAAE,MAAM;aACd,CAAC,CAAA;YAEF,8EAA8E;YAC9E,8EAA8E;YAC9E,+EAA+E;YAC/E,wEAAwE;YACxE,cAAc;YACd,IAAI,WAAW,CAAC,KAAK,CAAC;gBAAE,OAAM;YAE9B,MAAM,KAAK,CAAA;QACb,CAAC;QAED,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;IACzF,CAAC;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,mBAAmB,CAAU,CAAA"}

package/dist/models.d.ts

@@ -0,0 +1,91 @@
+/** What a delivery can be. `pending` is a row nobody has tried to send yet. */
+export declare const DELIVERY_STATUSES: readonly ['pending', 'sent', 'failed'];
+export type DeliveryStatus = (typeof DELIVERY_STATUSES)[number];
+export declare const NotificationRecipient: import("@assemora/data").Model<{
+    id: import("@assemora/data").UuidColumnBuilder;
+    /** What a person calls this address: "Kitchen", "Ada's phone". */
+    label: import("@assemora/data").ColumnBuilder<string>;
+    /** The channel's own name, as the driver registered it. */
+    channel: import("@assemora/data").ColumnBuilder<string>;
+    /** A Telegram chat id today; an address, a number or a URL when a channel grows. */
+    address: import("@assemora/data").ColumnBuilder<string>;
+    /**
+     * The topics this recipient asked for. Empty means all of them.
+     *
+     * Empty-is-everything because the first recipient anybody adds is the staff chat
+     * that wants the lot, and making them tick every box would mean a new topic is one
+     * nobody is told about until somebody remembers to go back and tick it.
+     */
+    topics: import("@assemora/data").JsonColumnBuilder<string[]>;
+    /**
+     * Off rather than deleted, so a chat can be silenced for an evening without losing
+     * what it is and which topics it had.
+     */
+    active: import("@assemora/data").ColumnBuilder<boolean>;
+    createdAt: import("@assemora/data").TimestampColumnBuilder;
+    updatedAt: import("@assemora/data").TimestampColumnBuilder;
+}, never, Readonly<Record<never, never>>>;
+export declare const NotificationDelivery: import("@assemora/data").Model<{
+    id: import("@assemora/data").UuidColumnBuilder;
+    topic: import("@assemora/data").ColumnBuilder<string>;
+    channel: import("@assemora/data").ColumnBuilder<string>;
+    address: import("@assemora/data").ColumnBuilder<string>;
+    /**
+     * Null when the recipient row has been deleted since. The delivery is history and
+     * outlives the address book.
+     */
+    recipientId: import("@assemora/data").ColumnBuilder<string | null>;
+    /** What was rendered, so the log shows what was actually said, not what it would say now. */
+    body: import("@assemora/data").ColumnBuilder<string>;
+    status: import("@assemora/data").ColumnBuilder<"failed" | "pending" | "sent">;
+    attempts: import("@assemora/data").ColumnBuilder<number>;
+    /** The channel's refusal, in its own words. Null while nothing has gone wrong. */
+    error: import("@assemora/data").ColumnBuilder<string | null>;
+    sentAt: import("@assemora/data").ColumnBuilder<Date | null>;
+    createdAt: import("@assemora/data").TimestampColumnBuilder;
+    updatedAt: import("@assemora/data").TimestampColumnBuilder;
+}, never, Readonly<Record<never, never>>>;
+export declare const notificationModels: readonly [import("@assemora/data").Model<{
+    id: import("@assemora/data").UuidColumnBuilder;
+    /** What a person calls this address: "Kitchen", "Ada's phone". */
+    label: import("@assemora/data").ColumnBuilder<string>;
+    /** The channel's own name, as the driver registered it. */
+    channel: import("@assemora/data").ColumnBuilder<string>;
+    /** A Telegram chat id today; an address, a number or a URL when a channel grows. */
+    address: import("@assemora/data").ColumnBuilder<string>;
+    /**
+     * The topics this recipient asked for. Empty means all of them.
+     *
+     * Empty-is-everything because the first recipient anybody adds is the staff chat
+     * that wants the lot, and making them tick every box would mean a new topic is one
+     * nobody is told about until somebody remembers to go back and tick it.
+     */
+    topics: import("@assemora/data").JsonColumnBuilder<string[]>;
+    /**
+     * Off rather than deleted, so a chat can be silenced for an evening without losing
+     * what it is and which topics it had.
+     */
+    active: import("@assemora/data").ColumnBuilder<boolean>;
+    createdAt: import("@assemora/data").TimestampColumnBuilder;
+    updatedAt: import("@assemora/data").TimestampColumnBuilder;
+}, never, Readonly<Record<never, never>>>, import("@assemora/data").Model<{
+    id: import("@assemora/data").UuidColumnBuilder;
+    topic: import("@assemora/data").ColumnBuilder<string>;
+    channel: import("@assemora/data").ColumnBuilder<string>;
+    address: import("@assemora/data").ColumnBuilder<string>;
+    /**
+     * Null when the recipient row has been deleted since. The delivery is history and
+     * outlives the address book.
+     */
+    recipientId: import("@assemora/data").ColumnBuilder<string | null>;
+    /** What was rendered, so the log shows what was actually said, not what it would say now. */
+    body: import("@assemora/data").ColumnBuilder<string>;
+    status: import("@assemora/data").ColumnBuilder<"failed" | "pending" | "sent">;
+    attempts: import("@assemora/data").ColumnBuilder<number>;
+    /** The channel's refusal, in its own words. Null while nothing has gone wrong. */
+    error: import("@assemora/data").ColumnBuilder<string | null>;
+    sentAt: import("@assemora/data").ColumnBuilder<Date | null>;
+    createdAt: import("@assemora/data").TimestampColumnBuilder;
+    updatedAt: import("@assemora/data").TimestampColumnBuilder;
+}, never, Readonly<Record<never, never>>>];
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAsBA,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,YAAI,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAA;AAEvE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,eAAO,MAAM,qBAAqB;;IAEhC,kEAAkE;;IAElE,2DAA2D;;IAE3D,oFAAoF;;IAEpF;;;;;;OAMG;;IAEH;;;OAGG;;;;yCAIH,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;IAK/B;;;OAGG;;IAEH,6FAA6F;;;;IAM7F,kFAAkF;;;;;yCAKlF,CAAA;AAEF,eAAO,MAAM,kBAAkB;;IA9C7B,kEAAkE;;IAElE,2DAA2D;;IAE3D,oFAAoF;;IAEpF;;;;;;OAMG;;IAEH;;;OAGG;;;;;;;;;IAWH;;;OAGG;;IAEH,6FAA6F;;;;IAM7F,kFAAkF;;;;;0CAOI,CAAA"}

package/dist/models.js

@@ -0,0 +1,61 @@
+/**
+ * Who is told, and what was told to them (SPEC.md §81).
+ *
+ * Two tables and no more. A recipient is an address somebody put in Studio; a
+ * delivery is one attempt to reach one address with one message, kept whether it
+ * worked or not — a notification that quietly did not arrive is the failure mode of
+ * every notification system, and a row that says `failed` with the channel's own
+ * words in it is the whole difference between "the kitchen was not told" and "nobody
+ * knows whether the kitchen was told".
+ */
+import { boolean, enumOf, integer, json, model, string, text, timestamp, uuid, } from '@assemora/data';
+/** What a delivery can be. `pending` is a row nobody has tried to send yet. */
+export const DELIVERY_STATUSES = ['pending', 'sent', 'failed'];
+export const NotificationRecipient = model('assemora_notification_recipients', {
+    id: uuid().primary().defaultRandom(),
+    /** What a person calls this address: "Kitchen", "Ada's phone". */
+    label: string(),
+    /** The channel's own name, as the driver registered it. */
+    channel: string(),
+    /** A Telegram chat id today; an address, a number or a URL when a channel grows. */
+    address: string(),
+    /**
+     * The topics this recipient asked for. Empty means all of them.
+     *
+     * Empty-is-everything because the first recipient anybody adds is the staff chat
+     * that wants the lot, and making them tick every box would mean a new topic is one
+     * nobody is told about until somebody remembers to go back and tick it.
+     */
+    topics: json().default([]),
+    /**
+     * Off rather than deleted, so a chat can be silenced for an evening without losing
+     * what it is and which topics it had.
+     */
+    active: boolean().default(true),
+    createdAt: timestamp().created(),
+    updatedAt: timestamp().updated(),
+});
+export const NotificationDelivery = model('assemora_notification_deliveries', {
+    id: uuid().primary().defaultRandom(),
+    topic: string().index(),
+    channel: string(),
+    address: string(),
+    /**
+     * Null when the recipient row has been deleted since. The delivery is history and
+     * outlives the address book.
+     */
+    recipientId: uuid().nullable(),
+    /** What was rendered, so the log shows what was actually said, not what it would say now. */
+    body: text(),
+    status: enumOf(...DELIVERY_STATUSES)
+        .default('pending')
+        .index(),
+    attempts: integer().default(0),
+    /** The channel's refusal, in its own words. Null while nothing has gone wrong. */
+    error: text().nullable(),
+    sentAt: timestamp().nullable(),
+    createdAt: timestamp().created(),
+    updatedAt: timestamp().updated(),
+});
+export const notificationModels = [NotificationRecipient, NotificationDelivery];
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,OAAO,EACP,MAAM,EACN,OAAO,EACP,IAAI,EACJ,KAAK,EACL,MAAM,EACN,IAAI,EACJ,SAAS,EACT,IAAI,GACL,MAAM,gBAAgB,CAAA;AAEvB,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAA;AAIvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC,kCAAkC,EAAE;IAC7E,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,aAAa,EAAE;IACpC,kEAAkE;IAClE,KAAK,EAAE,MAAM,EAAE;IACf,2DAA2D;IAC3D,OAAO,EAAE,MAAM,EAAE;IACjB,oFAAoF;IACpF,OAAO,EAAE,MAAM,EAAE;IACjB;;;;;;OAMG;IACH,MAAM,EAAE,IAAI,EAAY,CAAC,OAAO,CAAC,EAAE,CAAC;IACpC;;;OAGG;IACH,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC/B,SAAS,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE;IAChC,SAAS,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE;CACjC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC,kCAAkC,EAAE;IAC5E,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,aAAa,EAAE;IACpC,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE;IACvB,OAAO,EAAE,MAAM,EAAE;IACjB,OAAO,EAAE,MAAM,EAAE;IACjB;;;OAGG;IACH,WAAW,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE;IAC9B,6FAA6F;IAC7F,IAAI,EAAE,IAAI,EAAE;IACZ,MAAM,EAAE,MAAM,CAAC,GAAG,iBAAiB,CAAC;SACjC,OAAO,CAAC,SAAS,CAAC;SAClB,KAAK,EAAE;IACV,QAAQ,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9B,kFAAkF;IAClF,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE;IAChC,SAAS,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE;CACjC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,qBAAqB,EAAE,oBAAoB,CAAU,CAAA"}

package/dist/module.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The `notifications()` module (SPEC.md §13, §81).
+ *
+ * ```ts
+ * assemora({
+ *   modules: [
+ *     notifications({
+ *       channels: [telegram({ token: process.env.TELEGRAM_BOT_TOKEN ?? '' })],
+ *       topics: [OrderPlaced],
+ *     }),
+ *   ],
+ * })
+ * ```
+ *
+ * The two lists are configuration and declaration: a channel is a driver this
+ * deployment was given, a topic is something this application can announce. Both are
+ * passed rather than discovered by import, for the reason `pages({ blocks })` takes
+ * its blocks that way — a registration that happens at import time is in the
+ * application whether the module was switched on or not.
+ */
+import { type ModuleBuilder } from '@assemora/core';
+import { type NotificationChannel } from './channel.js';
+import { type AnyNotification } from './notification.js';
+export type NotificationsOptions = {
+    /** The drivers this deployment can send over. None means nothing can be delivered. */
+    readonly channels?: readonly NotificationChannel[];
+    /** What this application can announce, declared with `notification()`. */
+    readonly topics?: readonly AnyNotification[];
+};
+export declare const notifications: (options?: NotificationsOptions) => ModuleBuilder;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,gBAAgB,CAAA;AAE3D,OAAO,EAAE,KAAK,mBAAmB,EAAe,MAAM,cAAc,CAAA;AAIpE,OAAO,EAAE,KAAK,eAAe,EAAoB,MAAM,mBAAmB,CAAA;AAG1E,MAAM,MAAM,oBAAoB,GAAG;IACjC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAClD,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;CAC7C,CAAA;AAED,eAAO,MAAM,aAAa,aAAa,oBAAoB,KAAQ,aA0ClE,CAAA"}

package/dist/module.js

@@ -0,0 +1,63 @@
+/**
+ * The `notifications()` module (SPEC.md §13, §81).
+ *
+ * ```ts
+ * assemora({
+ *   modules: [
+ *     notifications({
+ *       channels: [telegram({ token: process.env.TELEGRAM_BOT_TOKEN ?? '' })],
+ *       topics: [OrderPlaced],
+ *     }),
+ *   ],
+ * })
+ * ```
+ *
+ * The two lists are configuration and declaration: a channel is a driver this
+ * deployment was given, a topic is something this application can announce. Both are
+ * passed rather than discovered by import, for the reason `pages({ blocks })` takes
+ * its blocks that way — a registration that happens at import time is in the
+ * application whether the module was switched on or not.
+ */
+import { module } from '@assemora/core';
+import { useChannels } from './channel.js';
+import { notificationCommands } from './commands.js';
+import { notificationJobs } from './jobs.js';
+import { notificationModels } from './models.js';
+import { useNotifications } from './notification.js';
+import { notificationResources } from './resources.js';
+export const notifications = (options = {}) => {
+    const channels = options.channels ?? [];
+    const topics = options.topics ?? [];
+    const { recipients, deliveries } = notificationResources({
+        channels: channels.map((channel) => channel.name),
+        topics: topics.map((topic) => topic.topic),
+    });
+    return module('notifications')
+        .models(...notificationModels)
+        .resources(recipients, deliveries)
+        .commands(...notificationCommands)
+        .jobs(...notificationJobs)
+        .boot((context) => {
+        useChannels(channels);
+        useNotifications(topics);
+        for (const topic of topics) {
+            context.registry.register('notifications', {
+                name: topic.topic,
+                ...(topic.description === undefined ? {} : { description: topic.description }),
+                input: topic.input.toJsonSchema(),
+                module: context.module,
+            });
+        }
+        // Said rather than refused. An application configured with no channel still
+        // boots, still shows the address book and still records what it would have
+        // sent — which is what a project looks like the week before somebody creates
+        // the bot. Silence here is how it stays that way for a month.
+        if (channels.length === 0) {
+            context.logger.warn('The notifications module has no channel, so nothing can be delivered. Pass channels: [telegram({ token })].');
+        }
+        if (topics.length === 0) {
+            context.logger.warn('The notifications module declares no topics, so there is nothing to announce. Pass topics: [ ... ] built with notification().');
+        }
+    });
+};
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAsB,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAE3D,OAAO,EAA4B,WAAW,EAAE,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAwB,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAStD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAO,GAAyB,EAAE,EAAiB,EAAE;IACjF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAA;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAA;IACnC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,qBAAqB,CAAC;QACvD,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACjD,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;KAC3C,CAAC,CAAA;IAEF,OAAO,MAAM,CAAC,eAAe,CAAC;SAC3B,MAAM,CAAC,GAAG,kBAAkB,CAAC;SAC7B,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC;SACjC,QAAQ,CAAC,GAAG,oBAAoB,CAAC;SACjC,IAAI,CAAC,GAAG,gBAAgB,CAAC;SACzB,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QAChB,WAAW,CAAC,QAAQ,CAAC,CAAA;QACrB,gBAAgB,CAAC,MAAM,CAAC,CAAA;QAExB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,EAAE;gBACzC,IAAI,EAAE,KAAK,CAAC,KAAK;gBACjB,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;gBAC9E,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE;gBACjC,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAA;QACJ,CAAC;QAED,4EAA4E;QAC5E,2EAA2E;QAC3E,6EAA6E;QAC7E,8DAA8D;QAC9D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,MAAM,CAAC,IAAI,CACjB,6GAA6G,CAC9G,CAAA;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,IAAI,CACjB,+HAA+H,CAChI,CAAA;QACH,CAAC;IACH,CAAC,CAAC,CAAA;AACN,CAAC,CAAA"}

package/dist/notification.d.ts

@@ -0,0 +1,69 @@
+/**
+ * What an application can announce (SPEC.md §81).
+ *
+ * ```ts
+ * export const OrderPlaced = notification('orders.placed', {
+ *   description: 'A new order is waiting for the kitchen',
+ *   input: { code: string(), total: integer(), phone: string() },
+ *   render: (order) => `Order ${order.code}\n${order.total} · ${order.phone}`,
+ * })
+ * ```
+ *
+ * The fourth member of the family beside `command()`, `query()` and `job()`, and
+ * declared the same way: a name, an input schema and a function. The schema is what
+ * makes `notifications.send` a typed act rather than a text box — the payload is
+ * validated before anybody is told anything, so a topic cannot be sent with a field
+ * missing and a chat cannot be reached with arbitrary prose.
+ *
+ * `render` is a function and therefore lives on the server only. The descriptor a
+ * generator reads carries the name, the description and the input schema, which is
+ * everything a form or an agent needs to *ask* for a notification, and nothing that
+ * would have to survive `JSON.stringify` (ADR-0027).
+ */
+import type { InferShape, Schema, Shape } from '@assemora/schema';
+import type { NotificationMessage } from './channel.js';
+export type NotificationDefinition<S extends Shape> = {
+    readonly node: 'notification';
+    readonly topic: string;
+    readonly description: string | undefined;
+    readonly input: Schema<InferShape<S>>;
+    /** A string is the message; the object form is there for a channel that grows one. */
+    render(payload: InferShape<S>): NotificationMessage | string;
+};
+/** A notification of any shape, as the module stores it. */
+export type AnyNotification = {
+    readonly node: 'notification';
+    readonly topic: string;
+    readonly description: string | undefined;
+    readonly input: Schema<unknown>;
+    render(payload: never): NotificationMessage | string;
+};
+/** How a topic describes itself in the Schema Registry (ADR-0002). */
+export type NotificationDescriptor = {
+    readonly name: string;
+    readonly description?: string;
+    readonly input: ReturnType<Schema<unknown>['toJsonSchema']>;
+    readonly module?: string;
+};
+declare module '@assemora/core' {
+    interface RegistrySections {
+        notifications: NotificationDescriptor;
+    }
+}
+export declare const notification: <S extends Shape>(topic: string, definition: {
+    readonly input: S;
+    readonly description?: string;
+    render(payload: InferShape<S>): NotificationMessage | string;
+}) => NotificationDefinition<S>;
+export declare const useNotifications: (topics: readonly AnyNotification[]) => void;
+export declare const notificationTopics: () => readonly string[];
+export declare const notificationFor: (topic: string) => AnyNotification | undefined;
+export declare const clearNotifications: () => void;
+/**
+ * The text a recipient reads, from a payload that has already been validated.
+ *
+ * Trimmed, because a template literal that spans lines in a source file arrives with
+ * the indentation of the file it was written in.
+ */
+export declare const renderMessage: (definition: AnyNotification, payload: unknown) => NotificationMessage;
+//# sourceMappingURL=notification.d.ts.map

package/dist/notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../src/notification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAGjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAEvD,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,KAAK,IAAI;IACpD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IACrC,sFAAsF;IACtF,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,mBAAmB,GAAG,MAAM,CAAA;CAC7D,CAAA;AAED,4DAA4D;AAC5D,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IAC/B,MAAM,CAAC,OAAO,EAAE,KAAK,GAAG,mBAAmB,GAAG,MAAM,CAAA;CACrD,CAAA;AAED,sEAAsE;AACtE,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,CAAC,CAAA;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,OAAO,QAAQ,gBAAgB,CAAC;IAC9B,UAAU,gBAAgB;QACxB,aAAa,EAAE,sBAAsB,CAAA;KACtC;CACF;AAED,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,KAAK,SACnC,MAAM,cACD;IACV,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,mBAAmB,GAAG,MAAM,CAAA;CAC7D,KACA,sBAAsB,CAAC,CAAC,CAMzB,CAAA;AAYF,eAAO,MAAM,gBAAgB,WAAY,SAAS,eAAe,EAAE,KAAG,IAErE,CAAA;AAED,eAAO,MAAM,kBAAkB,QAAO,SAAS,MAAM,EAA0B,CAAA;AAE/E,eAAO,MAAM,eAAe,UAAW,MAAM,KAAG,eAAe,GAAG,SAAgC,CAAA;AAElG,eAAO,MAAM,kBAAkB,QAAO,IAErC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,eACZ,eAAe,WAClB,OAAO,KACf,mBAMF,CAAA"}

package/dist/notification.js

@@ -0,0 +1,36 @@
+import { object } from '@assemora/schema';
+export const notification = (topic, definition) => ({
+    node: 'notification',
+    topic,
+    description: definition.description,
+    input: object(definition.input),
+    render: definition.render,
+});
+/**
+ * The topics this application declared.
+ *
+ * Filled by `notifications({ topics })` rather than by importing a file, for the
+ * reason `pages({ blocks })` takes its blocks that way: a declaration that registers
+ * itself at import time is in the application whether the module was switched on or
+ * not, and the list is also what the recipient form's checkboxes are built from.
+ */
+let declared = new Map();
+export const useNotifications = (topics) => {
+    declared = new Map(topics.map((topic) => [topic.topic, topic]));
+};
+export const notificationTopics = () => [...declared.keys()];
+export const notificationFor = (topic) => declared.get(topic);
+export const clearNotifications = () => {
+    declared = new Map();
+};
+/**
+ * The text a recipient reads, from a payload that has already been validated.
+ *
+ * Trimmed, because a template literal that spans lines in a source file arrives with
+ * the indentation of the file it was written in.
+ */
+export const renderMessage = (definition, payload) => {
+    const rendered = definition.render(payload);
+    return typeof rendered === 'string' ? { text: rendered.trim() } : { text: rendered.text.trim() };
+};
+//# sourceMappingURL=notification.js.map

package/dist/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../src/notification.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAoCzC,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,KAAa,EACb,UAIC,EAC0B,EAAE,CAAC,CAAC;IAC/B,IAAI,EAAE,cAAc;IACpB,KAAK;IACL,WAAW,EAAE,UAAU,CAAC,WAAW;IACnC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;IAC/B,MAAM,EAAE,UAAU,CAAC,MAAM;CAC1B,CAAC,CAAA;AAEF;;;;;;;GAOG;AACH,IAAI,QAAQ,GAAyC,IAAI,GAAG,EAAE,CAAA;AAE9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAkC,EAAQ,EAAE;IAC3E,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;AACjE,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAsB,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;AAE/E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAa,EAA+B,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AAElG,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAS,EAAE;IAC3C,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAA;AACtB,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,UAA2B,EAC3B,OAAgB,EACK,EAAE;IACvB,MAAM,QAAQ,GAAI,UAAU,CAAC,MAA6D,CACxF,OAAO,CACR,CAAA;IAED,OAAO,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAA;AAClG,CAAC,CAAA"}

package/dist/resources.d.ts

@@ -0,0 +1,49 @@
+export declare const RECIPIENTS = "notificationRecipients";
+export declare const DELIVERIES = "notificationDeliveries";
+export type NotificationResourceOptions = {
+    readonly channels: readonly string[];
+    readonly topics: readonly string[];
+};
+export declare const notificationResources: (options: NotificationResourceOptions) => {
+    recipients: import("@assemora/resources").Resource<{
+        id: import("@assemora/data").UuidColumnBuilder;
+        label: import("@assemora/data").ColumnBuilder<string>;
+        channel: import("@assemora/data").ColumnBuilder<string>;
+        address: import("@assemora/data").ColumnBuilder<string>;
+        topics: import("@assemora/data").JsonColumnBuilder<string[]>;
+        active: import("@assemora/data").ColumnBuilder<boolean>;
+        createdAt: import("@assemora/data").TimestampColumnBuilder;
+        updatedAt: import("@assemora/data").TimestampColumnBuilder;
+    }, never, Readonly<Record<never, never>>, {
+        label: import("@assemora/resources").FieldBuilder<string>;
+        channel: import("@assemora/resources").FieldBuilder<string>;
+        address: import("@assemora/resources").FieldBuilder<string>;
+        topics: import("@assemora/resources").FieldBuilder<string[]>;
+        active: import("@assemora/resources").FieldBuilder<boolean>;
+    }>;
+    deliveries: import("@assemora/resources").Resource<{
+        id: import("@assemora/data").UuidColumnBuilder;
+        topic: import("@assemora/data").ColumnBuilder<string>;
+        channel: import("@assemora/data").ColumnBuilder<string>;
+        address: import("@assemora/data").ColumnBuilder<string>;
+        recipientId: import("@assemora/data").ColumnBuilder<string | null>;
+        body: import("@assemora/data").ColumnBuilder<string>;
+        status: import("@assemora/data").ColumnBuilder<"failed" | "pending" | "sent">;
+        attempts: import("@assemora/data").ColumnBuilder<number>;
+        error: import("@assemora/data").ColumnBuilder<string | null>;
+        sentAt: import("@assemora/data").ColumnBuilder<Date | null>;
+        createdAt: import("@assemora/data").TimestampColumnBuilder;
+        updatedAt: import("@assemora/data").TimestampColumnBuilder;
+    }, never, Readonly<Record<never, never>>, {
+        topic: import("@assemora/resources").FieldBuilder<string>;
+        channel: import("@assemora/resources").FieldBuilder<string>;
+        address: import("@assemora/resources").FieldBuilder<string>;
+        status: import("@assemora/resources").FieldBuilder<"failed" | "pending" | "sent">;
+        attempts: import("@assemora/resources").FieldBuilder<number>;
+        error: import("@assemora/resources").FieldBuilder<string>;
+        body: import("@assemora/resources").FieldBuilder<string>;
+        sentAt: import("@assemora/resources").FieldBuilder<Date>;
+        createdAt: import("@assemora/resources").FieldBuilder<Date>;
+    }>;
+};
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,UAAU,2BAA2B,CAAA;AAClD,eAAO,MAAM,UAAU,2BAA2B,CAAA;AASlD,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC,CAAA;AAED,eAAO,MAAM,qBAAqB,YAAa,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsEzE,CAAA"}

package/dist/resources.js

@@ -0,0 +1,79 @@
+/**
+ * The address book and the log, as Studio sees them (SPEC.md §35, §58).
+ *
+ * They are resources rather than screens, so the list, the form, the filters, the REST
+ * endpoints, the OpenAPI document, the SDK and the MCP tools all follow from these two
+ * declarations and nothing is written twice (ADR-0027).
+ *
+ * Both are built by a function rather than exported as constants, because two of the
+ * fields are choices and the choices are configuration: the channels are the drivers
+ * this application was given, and the topics are what it declared. A free-text
+ * "channel" column is a typo waiting to become a delivery nobody receives.
+ */
+import { checkboxes, datetime, integer, json, resource, select, text, textarea, toggle, } from '@assemora/resources';
+import { DELIVERY_STATUSES, NotificationDelivery, NotificationRecipient } from './models.js';
+export const RECIPIENTS = 'notificationRecipients';
+export const DELIVERIES = 'notificationDeliveries';
+/** Studio's heading for both of them (SPEC.md §58). */
+const GROUP = 'Notifications';
+/** A non-empty tuple, or nothing — which is what `select()` and `checkboxes()` need. */
+const choices = (values) => values.length === 0 ? undefined : values;
+export const notificationResources = (options) => {
+    const channels = choices(options.channels);
+    const topics = choices(options.topics);
+    const recipients = resource(NotificationRecipient, {
+        label: text().required().searchable().sortable().label('Name'),
+        // A driver that is not configured cannot deliver, so the form offers the ones
+        // that are. With none configured the column is still a column, and a text box
+        // is a better answer than a form nobody can submit.
+        channel: channels === undefined
+            ? text().required().label('Channel')
+            : select(...channels)
+                .required()
+                .filterable()
+                .label('Channel'),
+        address: text().required().label('Address'),
+        // Nothing ticked means every topic, which is what the column says and what the
+        // hint has to repeat, because an empty box reads as "none" to everybody.
+        topics: topics === undefined
+            ? json().label('Topics')
+            : checkboxes(...topics).label('Topics'),
+        active: toggle().filterable().label('Active'),
+    }, {
+        name: RECIPIENTS,
+        label: 'Notification recipients',
+        group: GROUP,
+        icon: 'contact',
+        titleField: 'label',
+        defaultSort: 'label',
+    });
+    const deliveries = resource(NotificationDelivery, {
+        topic: text().searchable().filterable().sortable().label('Topic'),
+        channel: text().filterable().label('Channel'),
+        address: text().searchable().label('Address'),
+        status: select(...DELIVERY_STATUSES)
+            .filterable()
+            .sortable()
+            .label('Status'),
+        attempts: integer().sortable().label('Attempts'),
+        error: textarea().label('Error'),
+        body: textarea().label('Message'),
+        sentAt: datetime().sortable().label('Sent'),
+        createdAt: datetime().sortable().label('Queued'),
+    }, {
+        name: DELIVERIES,
+        label: 'Notification deliveries',
+        group: GROUP,
+        icon: 'bell',
+        titleField: 'topic',
+        defaultSort: '-createdAt',
+        perPage: 30,
+        // A log is written by the sending and read by everybody else. Editing one would
+        // be editing what happened, and creating one would be a delivery nobody sent —
+        // the flags are what make that true in Studio, over REST, in the SDK and over
+        // MCP at once (SPEC.md §43).
+        api: { create: false, update: false, delete: false },
+    });
+    return { recipients, deliveries };
+};
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

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

package/dist/telegram.d.ts

@@ -0,0 +1,13 @@
+import { type NotificationChannel } from './channel.js';
+export type TelegramOptions = {
+    /** From @BotFather. A secret: it never reaches the registry, a log or an answer. */
+    readonly token: string;
+    /** The Bot API root. Overridden by tests and by a self-hosted Bot API server. */
+    readonly api?: string;
+    /** How long one send may take. A hung request holds the command that is sending. */
+    readonly timeoutMs?: number;
+    /** Injected by tests; production uses the platform's. */
+    readonly fetch?: typeof globalThis.fetch;
+};
+export declare const telegram: (options: TelegramOptions) => NotificationChannel;
+//# sourceMappingURL=telegram.d.ts.map

package/dist/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../src/telegram.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,mBAAmB,EAAyB,MAAM,cAAc,CAAA;AAE9E,MAAM,MAAM,eAAe,GAAG;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,iFAAiF;IACjF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CACzC,CAAA;AAqCD,eAAO,MAAM,QAAQ,YAAa,eAAe,KAAG,mBA8DnD,CAAA"}