@indianic/dialout 1.12.1 → 1.13.1

package/node_modules/@indianic/dialout-shared/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.promptMoveKeys = exports.promptKeys = exports.isSafeKeyList = exports.isFreeTextOption = exports.freeTextRow = exports.detectPanePrompt = exports.PROMPT_KEYS = exports.thinkingLabel = exports.thinkingDuration = exports.parseCapturePage = exports.MAX_CAPTURE_PAGE = exports.EMPTY_CAPTURE = exports.mergeEvents = exports.EMPTY_TRANSCRIPT = exports.resolveTmuxPrefs = exports.isValidTmuxColor = exports.isValidStatusTemplate = exports.compileStatusTemplate = exports.MAX_STATUS_TEMPLATE = exports.STATUS_TOKENS = exports.DEFAULT_TMUX_PREFS = exports.renderTerminalName = exports.factsFromSession = exports.TERMINAL_NAME_TOKENS = exports.DEFAULT_TERMINAL_TEMPLATE = exports.setFunctionKeysVisible = exports.getFunctionKeysVisible = exports.FUNCTION_KEYS_PREF = exports.shouldSubmitOnEnter = exports.COARSE_POINTER_QUERY = exports.rankCommands = exports.commandQuery = exports.toolAppearance = exports.toolClass = exports.shouldFollow = exports.PIN_THRESHOLD_PX = exports.readUserMessage = exports.dedent = exports.toolGroupStartsOpen = exports.groupEvents = exports.shouldNotifyNewAiSession = exports.shouldNotifyNewTerminal = exports.shouldNotifyPrompt = exports.shouldNotifyAi = exports.NOTIFY_COOLDOWN_MS = exports.REPLAY_LIMIT = exports.isPermissionMode = exports.PERMISSION_MODES = exports.preview = exports.PREVIEW_LIMIT = void 0;
-exports.splitAttachments = exports.safeAttachmentName = exports.isImageName = exports.composeWithAttachments = exports.ATTACHMENT_MAX_FILES = exports.ATTACHMENT_MAX_BYTES = exports.ATTACHMENT_DIR = void 0;
+exports.promptKeys = exports.isSafeKeyList = exports.isFreeTextOption = exports.freeTextRow = exports.detectPanePrompt = exports.PROMPT_KEYS = exports.thinkingLabel = exports.thinkingDuration = exports.parseCapturePage = exports.MAX_CAPTURE_PAGE = exports.EMPTY_CAPTURE = exports.mergeEvents = exports.EMPTY_TRANSCRIPT = exports.resolveTmuxPrefs = exports.isValidTmuxColor = exports.isValidStatusTemplate = exports.compileStatusTemplate = exports.MAX_STATUS_TEMPLATE = exports.STATUS_TOKENS = exports.DEFAULT_TMUX_PREFS = exports.renderTerminalName = exports.factsFromSession = exports.TERMINAL_NAME_TOKENS = exports.DEFAULT_TERMINAL_TEMPLATE = exports.setFunctionKeysVisible = exports.getFunctionKeysVisible = exports.FUNCTION_KEYS_PREF = exports.shouldSubmitOnEnter = exports.COARSE_POINTER_QUERY = exports.rankCommands = exports.commandQuery = exports.toolAppearance = exports.toolClass = exports.shouldFollow = exports.PIN_THRESHOLD_PX = exports.readUserMessage = exports.dedent = exports.toolGroupStartsOpen = exports.groupEvents = exports.shouldAnnounceSession = exports.shouldNotifyNewAiSession = exports.shouldNotifyNewTerminal = exports.shouldNotifyPrompt = exports.shouldNotifyAi = exports.NOTIFY_COOLDOWN_MS = exports.REPLAY_LIMIT = exports.isPermissionMode = exports.PERMISSION_MODES = exports.preview = exports.PREVIEW_LIMIT = void 0;
+exports.isSendable = exports.folderLabel = exports.shouldSendNotification = exports.isNotificationType = exports.parseTemplatePatch = exports.parseActions = exports.renderNotification = exports.categoryId = exports.MAX_ACTIONS = exports.BODY_MAX = exports.TITLE_MAX = exports.DEFAULT_TEMPLATES = exports.TEMPLATE_VARIABLES = exports.ACTION_KINDS = exports.NOTIFICATION_TYPES = exports.splitAttachments = exports.safeAttachmentName = exports.isImageName = exports.composeWithAttachments = exports.ATTACHMENT_MAX_FILES = exports.ATTACHMENT_MAX_BYTES = exports.ATTACHMENT_DIR = exports.promptMoveKeys = void 0;
 var events_1 = require("./events");
 Object.defineProperty(exports, "PREVIEW_LIMIT", { enumerable: true, get: function () { return events_1.PREVIEW_LIMIT; } });
 Object.defineProperty(exports, "preview", { enumerable: true, get: function () { return events_1.preview; } });
@@ -16,6 +16,8 @@ Object.defineProperty(exports, "shouldNotifyAi", { enumerable: true, get: functi
 Object.defineProperty(exports, "shouldNotifyPrompt", { enumerable: true, get: function () { return notify_1.shouldNotifyPrompt; } });
 Object.defineProperty(exports, "shouldNotifyNewTerminal", { enumerable: true, get: function () { return notify_1.shouldNotifyNewTerminal; } });
 Object.defineProperty(exports, "shouldNotifyNewAiSession", { enumerable: true, get: function () { return notify_1.shouldNotifyNewAiSession; } });
+var session_announce_1 = require("./session-announce");
+Object.defineProperty(exports, "shouldAnnounceSession", { enumerable: true, get: function () { return session_announce_1.shouldAnnounceSession; } });
 var chat_blocks_1 = require("./chat-blocks");
 Object.defineProperty(exports, "groupEvents", { enumerable: true, get: function () { return chat_blocks_1.groupEvents; } });
 Object.defineProperty(exports, "toolGroupStartsOpen", { enumerable: true, get: function () { return chat_blocks_1.toolGroupStartsOpen; } });
@@ -77,3 +79,19 @@ Object.defineProperty(exports, "composeWithAttachments", { enumerable: true, get
 Object.defineProperty(exports, "isImageName", { enumerable: true, get: function () { return attachments_1.isImageName; } });
 Object.defineProperty(exports, "safeAttachmentName", { enumerable: true, get: function () { return attachments_1.safeAttachmentName; } });
 Object.defineProperty(exports, "splitAttachments", { enumerable: true, get: function () { return attachments_1.splitAttachments; } });
+var notify_template_1 = require("./notify-template");
+Object.defineProperty(exports, "NOTIFICATION_TYPES", { enumerable: true, get: function () { return notify_template_1.NOTIFICATION_TYPES; } });
+Object.defineProperty(exports, "ACTION_KINDS", { enumerable: true, get: function () { return notify_template_1.ACTION_KINDS; } });
+Object.defineProperty(exports, "TEMPLATE_VARIABLES", { enumerable: true, get: function () { return notify_template_1.TEMPLATE_VARIABLES; } });
+Object.defineProperty(exports, "DEFAULT_TEMPLATES", { enumerable: true, get: function () { return notify_template_1.DEFAULT_TEMPLATES; } });
+Object.defineProperty(exports, "TITLE_MAX", { enumerable: true, get: function () { return notify_template_1.TITLE_MAX; } });
+Object.defineProperty(exports, "BODY_MAX", { enumerable: true, get: function () { return notify_template_1.BODY_MAX; } });
+Object.defineProperty(exports, "MAX_ACTIONS", { enumerable: true, get: function () { return notify_template_1.MAX_ACTIONS; } });
+Object.defineProperty(exports, "categoryId", { enumerable: true, get: function () { return notify_template_1.categoryId; } });
+Object.defineProperty(exports, "renderNotification", { enumerable: true, get: function () { return notify_template_1.renderNotification; } });
+Object.defineProperty(exports, "parseActions", { enumerable: true, get: function () { return notify_template_1.parseActions; } });
+Object.defineProperty(exports, "parseTemplatePatch", { enumerable: true, get: function () { return notify_template_1.parseTemplatePatch; } });
+Object.defineProperty(exports, "isNotificationType", { enumerable: true, get: function () { return notify_template_1.isNotificationType; } });
+Object.defineProperty(exports, "shouldSendNotification", { enumerable: true, get: function () { return notify_template_1.shouldSendNotification; } });
+Object.defineProperty(exports, "folderLabel", { enumerable: true, get: function () { return notify_template_1.folderLabel; } });
+Object.defineProperty(exports, "isSendable", { enumerable: true, get: function () { return notify_template_1.isSendable; } });

package/node_modules/@indianic/dialout-shared/dist/notify-template.d.ts

@@ -0,0 +1,129 @@
+/**
+ * What an automatic notification says, and the buttons it carries.
+ *
+ * Pure, and here rather than in the ws-server for the same reason the
+ * shouldNotify* family is: src/ws-server/index.ts is one deliberately large
+ * file with no unit seams, so decision and rendering logic added inline there
+ * would be untestable. The ws-server stays the only side-effecting caller.
+ */
+export declare const NOTIFICATION_TYPES: readonly ["ai_question", "new_terminal", "new_ai_session", "announcement"];
+export type NotificationType = (typeof NOTIFICATION_TYPES)[number];
+/** A closed set, so a configured button cannot ask for behaviour the app lacks. */
+export declare const ACTION_KINDS: readonly ["open", "reply"];
+export type ActionKind = (typeof ACTION_KINDS)[number];
+export interface NotificationAction {
+    id: string;
+    label: string;
+    kind: ActionKind;
+}
+export interface NotificationTemplate {
+    type: NotificationType;
+    enabled: boolean;
+    title: string;
+    body: string;
+    actions: NotificationAction[];
+}
+/** Matches src/app/api/push/broadcast/route.ts, and both platforms truncate anyway. */
+export declare const TITLE_MAX = 80;
+export declare const BODY_MAX = 240;
+/** iOS shows four actions on an expanded notification. */
+export declare const MAX_ACTIONS = 4;
+/**
+ * Which variables each type can supply. Per type, not global, because they are
+ * not interchangeable: {question} exists for an agent question and not for a
+ * new terminal, and offering it everywhere would produce templates that render
+ * a gap on every send.
+ */
+export declare const TEMPLATE_VARIABLES: Record<NotificationType, string[]>;
+/**
+ * Today's hardcoded wording, so shipping the feature changes nothing about
+ * what anyone receives. Mirrored in scripts/apply-notification-templates.mjs,
+ * which cannot import the built package — a drift between the two is a visible
+ * difference in a notification rather than a silent failure.
+ */
+export declare const DEFAULT_TEMPLATES: Record<NotificationType, Omit<NotificationTemplate, 'type'>>;
+/**
+ * The notification category a type registers under.
+ *
+ * Expo SDK 57's setNotificationCategoryAsync documents that an identifier may
+ * contain no `:` or `-`, and the failure is silent — the notification arrives
+ * with no buttons and nothing logs why. Stripping both from the type name
+ * makes `ai_question` land on exactly `aiquestion`, which is the string
+ * AI_CATEGORY already holds and the ws-server already sends, so notifications
+ * in flight during a deploy keep their Reply button.
+ */
+export declare function categoryId(type: NotificationType): string;
+/**
+ * The folder a notification should name, or `fallback` when there is none.
+ *
+ * Lives in the sender's vars rather than in the renderer on purpose. The
+ * renderer's rule for an empty variable is "render nothing and take the
+ * neighbouring separator with it", which cannot mend an English word stranded
+ * between two spaces ("agent in  on Mac"). Only the sender knows what a sensible
+ * stand-in is for its type (a tmux name for a terminal, the word "session" for
+ * an agent), so every sender goes through this one function and none passes a
+ * raw nullable folder.
+ */
+export declare function folderLabel(folder: string | null | undefined, fallback: string): string;
+/**
+ * Whether a rendered notification is worth sending. A title alone or a body
+ * alone is a legitimate choice (an admin can clear either field), but with
+ * neither there is nothing to show: a blank banner is noise, so the sender
+ * skips it instead of discovering the case on a lock screen.
+ */
+export declare function isSendable(rendered: {
+    title: string;
+    body: string;
+}): boolean;
+export type TemplateVars = Record<string, string | null | undefined>;
+/**
+ * Renders a template's title and body.
+ *
+ * Never throws: it is called on the ws-server's notify path, where an
+ * exception would break the registry upsert chain whose ordering other
+ * sessions depend on.
+ *
+ * `vars.at` is an ISO timestamp used for {time} and {date}; every other key is
+ * substituted literally. An unknown or empty variable renders as nothing and
+ * takes any separator stranded beside it with it.
+ */
+export declare function renderNotification(template: {
+    title: string;
+    body: string;
+}, rawVars: TemplateVars, timezone: string): {
+    title: string;
+    body: string;
+};
+/** Normalises whatever the jsonb column or a request body hands over. */
+export declare function parseActions(raw: unknown): NotificationAction[];
+export type TemplatePatch = Partial<Pick<NotificationTemplate, 'enabled' | 'title' | 'body' | 'actions'>>;
+export type TemplateParseResult = {
+    ok: true;
+    patch: TemplatePatch;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Validates an edit. Text is capped rather than rejected: a long title is the
+ * author's problem to see in the preview, not a reason to refuse the save.
+ */
+export declare function parseTemplatePatch(body: unknown): TemplateParseResult;
+export declare function isNotificationType(t: string): t is NotificationType;
+/**
+ * Whether this notification reaches this device. Both gates must say yes.
+ *
+ * `enabled` is the admin's instance-wide switch from notification_templates;
+ * `userOptedIn` is the recipient's own per-device switch from user_settings.
+ * Admin-off means nobody receives the type; user-off means that one device
+ * does not.
+ *
+ * The per-device opt-out is kept deliberately rather than replaced by the
+ * admin switch: App Store guideline 4.5.4 and Play policy both require
+ * announcement push to be refusable, and removing it risks a rejection.
+ *
+ * Trivial on purpose. It exists so the rule has one name and one test instead
+ * of being spelled out at each of the three senders.
+ */
+export declare function shouldSendNotification(enabled: boolean, userOptedIn: boolean): boolean;
+//# sourceMappingURL=notify-template.d.ts.map

package/node_modules/@indianic/dialout-shared/dist/notify-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify-template.d.ts","sourceRoot":"","sources":["../src/notify-template.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,eAAO,MAAM,kBAAkB,4EAErB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,mFAAmF;AACnF,eAAO,MAAM,YAAY,4BAA6B,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,uFAAuF;AACvF,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,QAAQ,MAAM,CAAC;AAC5B,0DAA0D;AAC1D,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAQjE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,gBAAgB,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAqC1F,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAEzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAE7E;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAarE;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACzC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAoDjC;AA0BD,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,EAAE,CAyB/D;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAE1G,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,CAWrE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,gBAAgB,CAEnE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAEtF"}

package/node_modules/@indianic/dialout-shared/dist/notify-template.js

@@ -0,0 +1,302 @@
+"use strict";
+// packages/devdash-shared/src/notify-template.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TEMPLATES = exports.TEMPLATE_VARIABLES = exports.MAX_ACTIONS = exports.BODY_MAX = exports.TITLE_MAX = exports.ACTION_KINDS = exports.NOTIFICATION_TYPES = void 0;
+exports.categoryId = categoryId;
+exports.folderLabel = folderLabel;
+exports.isSendable = isSendable;
+exports.renderNotification = renderNotification;
+exports.parseActions = parseActions;
+exports.parseTemplatePatch = parseTemplatePatch;
+exports.isNotificationType = isNotificationType;
+exports.shouldSendNotification = shouldSendNotification;
+/**
+ * What an automatic notification says, and the buttons it carries.
+ *
+ * Pure, and here rather than in the ws-server for the same reason the
+ * shouldNotify* family is: src/ws-server/index.ts is one deliberately large
+ * file with no unit seams, so decision and rendering logic added inline there
+ * would be untestable. The ws-server stays the only side-effecting caller.
+ */
+exports.NOTIFICATION_TYPES = [
+    'ai_question', 'new_terminal', 'new_ai_session', 'announcement',
+];
+/** A closed set, so a configured button cannot ask for behaviour the app lacks. */
+exports.ACTION_KINDS = ['open', 'reply'];
+/** Matches src/app/api/push/broadcast/route.ts, and both platforms truncate anyway. */
+exports.TITLE_MAX = 80;
+exports.BODY_MAX = 240;
+/** iOS shows four actions on an expanded notification. */
+exports.MAX_ACTIONS = 4;
+/**
+ * Which variables each type can supply. Per type, not global, because they are
+ * not interchangeable: {question} exists for an agent question and not for a
+ * new terminal, and offering it everywhere would produce templates that render
+ * a gap on every send.
+ */
+exports.TEMPLATE_VARIABLES = {
+    ai_question: ['agent', 'what', 'kind', 'question', 'folder', 'branch', 'machine', 'session', 'time', 'date'],
+    new_terminal: ['machine', 'terminal', 'folder', 'branch', 'time', 'date'],
+    new_ai_session: ['agent', 'machine', 'session', 'folder', 'time', 'date'],
+    // An announcement has no machine, terminal or session behind it. {title} and
+    // {body} are what the admin typed in the compose form; the template supplies
+    // the wrapper and the buttons.
+    announcement: ['title', 'body', 'user', 'time', 'date'],
+};
+/**
+ * Today's hardcoded wording, so shipping the feature changes nothing about
+ * what anyone receives. Mirrored in scripts/apply-notification-templates.mjs,
+ * which cannot import the built package — a drift between the two is a visible
+ * difference in a notification rather than a silent failure.
+ */
+exports.DEFAULT_TEMPLATES = {
+    ai_question: {
+        enabled: true,
+        // {what} is "needs you" or "finished". One template string cannot branch, so
+        // the distinction is a variable: a finished job must not read as a blocked one.
+        title: '{agent} {what}',
+        body: '{question} · {kind} · {folder}',
+        actions: [
+            { id: 'reply', label: 'Reply', kind: 'reply' },
+            { id: 'open', label: 'Open', kind: 'open' },
+        ],
+    },
+    new_terminal: {
+        enabled: true,
+        title: 'New terminal',
+        // {folder}, not {terminal}: the push this replaced named a terminal by its
+        // folder, and for a browser session the tmux name is an opaque dd-<uuid>.
+        // The sender passes folderLabel(folder, tmuxName), so a session with no
+        // folder still reads as its tmux name. {terminal} stays available for an
+        // admin who wants the raw name. These defaults are seeded with DO NOTHING
+        // (scripts/apply-notification-templates.mjs), so a later wording change
+        // never reaches an existing row.
+        body: '{folder} on {machine}',
+        actions: [{ id: 'open', label: 'Open', kind: 'open' }],
+    },
+    new_ai_session: {
+        enabled: true,
+        title: 'New agent session',
+        body: '{agent} in {folder} on {machine}',
+        actions: [{ id: 'open', label: 'Open', kind: 'open' }],
+    },
+    announcement: {
+        enabled: true,
+        title: '{title}',
+        body: '{body}',
+        actions: [],
+    },
+};
+/**
+ * The notification category a type registers under.
+ *
+ * Expo SDK 57's setNotificationCategoryAsync documents that an identifier may
+ * contain no `:` or `-`, and the failure is silent — the notification arrives
+ * with no buttons and nothing logs why. Stripping both from the type name
+ * makes `ai_question` land on exactly `aiquestion`, which is the string
+ * AI_CATEGORY already holds and the ws-server already sends, so notifications
+ * in flight during a deploy keep their Reply button.
+ */
+function categoryId(type) {
+    return type.replace(/[_:-]/g, '');
+}
+/**
+ * The folder a notification should name, or `fallback` when there is none.
+ *
+ * Lives in the sender's vars rather than in the renderer on purpose. The
+ * renderer's rule for an empty variable is "render nothing and take the
+ * neighbouring separator with it", which cannot mend an English word stranded
+ * between two spaces ("agent in  on Mac"). Only the sender knows what a sensible
+ * stand-in is for its type (a tmux name for a terminal, the word "session" for
+ * an agent), so every sender goes through this one function and none passes a
+ * raw nullable folder.
+ */
+function folderLabel(folder, fallback) {
+    return typeof folder === 'string' && folder.trim() !== '' ? folder : fallback;
+}
+/**
+ * Whether a rendered notification is worth sending. A title alone or a body
+ * alone is a legitimate choice (an admin can clear either field), but with
+ * neither there is nothing to show: a blank banner is noise, so the sender
+ * skips it instead of discovering the case on a lock screen.
+ */
+function isSendable(rendered) {
+    return rendered.title.trim() !== '' || rendered.body.trim() !== '';
+}
+function formatIn(iso, timezone, opts) {
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return '';
+    try {
+        return new Intl.DateTimeFormat('en-GB', { ...opts, timeZone: timezone }).format(d);
+    }
+    catch {
+        // An unknown zone throws, and this runs while a push is being rendered.
+        return new Intl.DateTimeFormat('en-GB', { ...opts, timeZone: 'UTC' }).format(d);
+    }
+}
+/**
+ * Renders a template's title and body.
+ *
+ * Never throws: it is called on the ws-server's notify path, where an
+ * exception would break the registry upsert chain whose ordering other
+ * sessions depend on.
+ *
+ * `vars.at` is an ISO timestamp used for {time} and {date}; every other key is
+ * substituted literally. An unknown or empty variable renders as nothing and
+ * takes any separator stranded beside it with it.
+ */
+function renderNotification(template, rawVars, timezone) {
+    // The type forbids null, but "never throws" is this function's contract and
+    // a JS caller or a spread of a possibly-undefined object would otherwise
+    // throw on the ws-server's notify path.
+    const vars = rawVars && typeof rawVars === 'object' && !Array.isArray(rawVars) ? rawVars : {};
+    const at = typeof vars.at === 'string' ? vars.at : new Date().toISOString();
+    const resolved = {
+        ...vars,
+        time: formatIn(at, timezone, { hour: '2-digit', minute: '2-digit' }),
+        date: formatIn(at, timezone, { day: 'numeric', month: 'short' }),
+    };
+    // Only a value that was explicitly supplied counts, and only a string or a
+    // number. `resolved` is a plain object, so without the own-property check
+    // `{constructor}` or `{__proto__}` would resolve to Object.prototype members
+    // and render "function Object() { [native code] }" on a lock screen.
+    const lookup = (name) => {
+        if (!Object.prototype.hasOwnProperty.call(resolved, name))
+            return '';
+        const v = resolved[name];
+        if (typeof v === 'string')
+            return v.trim() === '' ? '' : v;
+        if (typeof v === 'number' && Number.isFinite(v))
+            return String(v);
+        return '';
+    };
+    const one = (raw, max) => {
+        if (typeof raw !== 'string')
+            return '';
+        // Tidy the template skeleton, then substitute values verbatim. The order is
+        // the point: tidy() collapses "-", "--", "||" and trims leading/trailing
+        // separators, which it cannot tell apart from the same characters inside a
+        // value. Run after substitution it turned an agent's question
+        // "git push --force?" into "git push - force?", so the lock screen showed a
+        // different command from the one being approved, next to a Reply button.
+        // Surviving placeholders stand in as opaque markers while the skeleton is
+        // tidied, and empty ones are dropped with their neighbouring separator.
+        const values = [];
+        const skeleton = raw
+            .replace(new RegExp(`[${MARK_OPEN}${MARK_CLOSE}]`, 'g'), '')
+            .replace(/\{(\w+)\}/g, (_, name) => {
+            const value = lookup(name);
+            if (value === '')
+                return '';
+            values.push(value);
+            return `${MARK_OPEN}${values.length - 1}${MARK_CLOSE}`;
+        });
+        // One pass over the tidied skeleton, never a re-scan of inserted text, so a
+        // value containing "{other}" cannot pull in another variable.
+        const markerRe = new RegExp(`${MARK_OPEN}(\\d+)${MARK_CLOSE}`, 'g');
+        const rendered = tidy(skeleton).replace(markerRe, (_, i) => values[Number(i)] ?? '');
+        return rendered.slice(0, max);
+    };
+    return { title: one(template?.title, exports.TITLE_MAX), body: one(template?.body, exports.BODY_MAX) };
+}
+/** Private-use code points that bracket a surviving placeholder while the skeleton is tidied. */
+const MARK_OPEN = '\uE000';
+const MARK_CLOSE = '\uE001';
+/**
+ * Removes what an emptied variable leaves behind. "{question} · {folder}" with
+ * no folder would otherwise end "Run it? · ", which reads as truncation rather
+ * than as an absent field.
+ */
+function tidy(s) {
+    return s
+        // A separator with nothing on one side of it.
+        .replace(/\s*[·|–—-]\s*(?=$)/g, '')
+        .replace(/(?<=^)\s*[·|–—-]\s*/g, '')
+        // A separator with nothing between it and the next one.
+        .replace(/\s*([·|–—-])\s*\1\s*/g, ' $1 ')
+        .replace(/\s*[·|–—-]\s*[·|–—-]\s*/g, ' · ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .replace(/\s*[·|–—-]$/, '')
+        .replace(/^[·|–—-]\s*/, '')
+        .trim();
+}
+/** Normalises whatever the jsonb column or a request body hands over. */
+function parseActions(raw) {
+    let value = raw;
+    if (typeof value === 'string') {
+        try {
+            value = JSON.parse(value);
+        }
+        catch {
+            return [];
+        }
+    }
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    const seen = new Set();
+    for (const item of value) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const a = item;
+        const id = typeof a.id === 'string' ? a.id.trim() : '';
+        const label = typeof a.label === 'string' ? a.label.trim() : '';
+        const kind = a.kind;
+        if (!id || !label)
+            continue;
+        if (!exports.ACTION_KINDS.includes(kind))
+            continue;
+        // A duplicate id would collide in the response handler, which switches on
+        // actionIdentifier.
+        if (seen.has(id))
+            continue;
+        seen.add(id);
+        out.push({ id, label: label.slice(0, 32), kind: kind });
+        if (out.length === exports.MAX_ACTIONS)
+            break;
+    }
+    return out;
+}
+/**
+ * Validates an edit. Text is capped rather than rejected: a long title is the
+ * author's problem to see in the preview, not a reason to refuse the save.
+ */
+function parseTemplatePatch(body) {
+    if (!body || typeof body !== 'object' || Array.isArray(body)) {
+        return { ok: false, error: 'Expected an object' };
+    }
+    const b = body;
+    const patch = {};
+    if (typeof b.enabled === 'boolean')
+        patch.enabled = b.enabled;
+    if (typeof b.title === 'string')
+        patch.title = b.title.trim().slice(0, exports.TITLE_MAX);
+    if (typeof b.body === 'string')
+        patch.body = b.body.trim().slice(0, exports.BODY_MAX);
+    if ('actions' in b)
+        patch.actions = parseActions(b.actions);
+    return { ok: true, patch };
+}
+function isNotificationType(t) {
+    return exports.NOTIFICATION_TYPES.includes(t);
+}
+/**
+ * Whether this notification reaches this device. Both gates must say yes.
+ *
+ * `enabled` is the admin's instance-wide switch from notification_templates;
+ * `userOptedIn` is the recipient's own per-device switch from user_settings.
+ * Admin-off means nobody receives the type; user-off means that one device
+ * does not.
+ *
+ * The per-device opt-out is kept deliberately rather than replaced by the
+ * admin switch: App Store guideline 4.5.4 and Play policy both require
+ * announcement push to be refusable, and removing it risks a rejection.
+ *
+ * Trivial on purpose. It exists so the rule has one name and one test instead
+ * of being spelled out at each of the three senders.
+ */
+function shouldSendNotification(enabled, userOptedIn) {
+    return enabled && userOptedIn;
+}

package/node_modules/@indianic/dialout-shared/dist/notify-template.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=notify-template.test.d.ts.map

package/node_modules/@indianic/dialout-shared/dist/notify-template.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify-template.test.d.ts","sourceRoot":"","sources":["../src/notify-template.test.ts"],"names":[],"mappings":""}