@betterlu/notif 0.0.0-stage → 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 betterlu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,262 @@
-# Temporary Holding Version
+# @betterlu/notif
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Client SDK for [notif](https://github.com/happyx94/notif) — async Telegram / Messenger / Discord / LINE / email / ChatLu / web push notifications with aliases, retries, and inbound replies.
+
+Requires Node.js >= 18 (uses native `fetch`). Zero runtime dependencies.
+
+## Install
+
+```bash
+npm install @betterlu/notif
+```
+
+## Quick start
+
+```typescript
+import { NotifClient } from "@betterlu/notif";
+
+const client = new NotifClient(); // http://localhost:8778
+// or: new NotifClient({ baseUrl: process.env.NOTIF_URL });
+
+const n = await client.send({
+  channel: "telegram",
+  chatId: "larry",
+  message: "Deploy finished",
+});
+console.log(n._id, n.status); // pending — worker delivers async
+```
+
+`baseUrl` is the **origin only** (no `/api`). Defaults to `NOTIF_URL` or `http://localhost:8778`.
+
+```bash
+export NOTIF_URL=http://localhost:8778
+```
+
+## Send a notification
+
+`send()` enqueues a job (HTTP 202). Status starts as `pending`; the worker delivers it.
+
+| Field | Type | Notes |
+|-------|------|--------|
+| `channel` | string | Channel name, provider type (`telegram` \| `messenger` \| `discord` \| `line` \| `email` \| `chatlu` \| `webpush`), or ObjectId |
+| `message` | string | Required |
+| `chatId` | string | Alias name first, else raw chat id (webpush: subscription id) |
+| `user` / `userName` | string | Alias-only (back-compat) |
+| `recipient` | `{ chatId?, psid? }` | Raw recipient |
+| `format` | `plain` \| `markdown` \| `html` | Auto-detected if omitted |
+| `options` | object | Provider extras (see below) |
+
+`chatId` looks up an alias first, then treats the value as a raw id. Discord **webhook** channels may omit `chatId`. Discord bot, LINE, Telegram, Messenger, and ChatLu require it; web push may omit it when `options.person` / `options.app` select registered subscriptions.
+
+```typescript
+// Alias
+await client.send({ channel: "telegram", chatId: "larry", message: "Hello" });
+
+// Raw chat id
+await client.send({ channel: "default-telegram", chatId: "123456789", message: "Hello" });
+
+// HTML
+await client.send({
+  channel: "telegram",
+  userName: "larry",
+  message: "<b>Alert</b> disk is full",
+  format: "html",
+});
+
+// Discord webhook (chatId optional)
+await client.send({
+  channel: "alerts-discord",
+  message: "Build passed",
+  options: { username: "ci", avatarUrl: "https://example.com/bot.png" },
+});
+
+// Web push to one subscription id
+await client.send({
+  channel: "webpush",
+  chatId: subscriptionId,
+  message: "Need milk",
+  options: { title: "cartlu", url: "/" },
+});
+
+// Web push to every subscription of a person/app
+await client.send({
+  channel: "webpush",
+  message: "Need milk",
+  options: { title: "cartlu", url: "/", app: "cartlu", person: "larry" },
+});
+
+// Shorthand
+await client.notify("Hello", { channel: "telegram", chatId: "larry" });
+```
+
+### Options
+
+| Key | Providers |
+|-----|-----------|
+| `disableNotification` | Telegram, Discord, LINE (silent) |
+| `protectContent` | Telegram |
+| `linkPreview` | Telegram |
+| `threadId` | Telegram, Discord (webhook path), ChatLu (Matrix thread event id) |
+| `replyToMessageId` | Telegram, ChatLu (Matrix event id) |
+| `replyMarkup` | Telegram |
+| `messengerTag` | Messenger (`false` → `RESPONSE`; omit for `MESSAGE_TAG`) |
+| `username` / `avatarUrl` | Discord webhook |
+| `subject` | Email (**required**) |
+| `title` / `url` / `icon` / `badge` | Web push (title defaults to `"Notification"`) |
+| `ttl` | Web push TTL seconds (overrides channel default) |
+| `person` / `app` | Web push target filters (used when `chatId` is omitted) |
+
+## Status, retry, delete
+
+```typescript
+const items = await client.listNotifications({ status: "failed", limit: 20 });
+const one = await client.getNotification(id);
+await client.retryNotification(id);   // failed → pending
+await client.deleteNotification(id);
+```
+
+`listNotifications` filters: `channel` (name or provider type), `status`, `recipient` (regex on chatId/alias), `limit` (default 20, max 50).
+
+## Channels
+
+```typescript
+const channels = await client.listChannels();
+const ch = await client.createChannel({
+  name: "alerts-telegram",
+  provider: "telegram",
+  isDefault: false,
+  config: { botToken: "..." },
+});
+await client.updateChannel(ch._id, { isDefault: true });
+await client.registerWebhook(ch._id, { baseUrl: "https://example.com" }); // telegram only
+await client.deleteChannel(ch._id);
+```
+
+Secrets in responses are masked (`abcd••••wxyz`).
+
+### Channel config by provider
+
+| Provider | Required | Optional |
+|----------|----------|----------|
+| `telegram` | `botToken` | `webhookSecretToken` |
+| `messenger` | `pageAccessToken` | `apiVersion`, `verifyToken`, `appSecret` |
+| `discord` | `webhookUrl` and/or `botToken` | `username` |
+| `line` | `channelAccessToken` | `channelSecret` |
+| `email` | `host`, `user`, `pass` | `port` (587), `secure` (false), `from`, `fromName` |
+| `chatlu` | `homeserverUrl`, `accessToken` | — |
+| `webpush` | — | `vapidSubject`, `vapidPublicKey`, `vapidPrivateKey`, `ttl` (fallback: `WEBPUSH_VAPID_*` env) |
+
+Name: `^[a-zA-Z0-9_-]+$`, not reserved (`telegram` / `messenger` / `discord` / `line` / `email` / `chatlu` / `webpush`).
+
+Email channels send over SMTP and require `options.subject`; `chatId` is the recipient address (alias lookup applies first).
+
+ChatLu channels deliver to Matrix rooms via the homeserver's client API; `chatId` is a room ID (`!room:chatlu.lan`) or room alias (`#room:chatlu.lan`). Create the bot with `scripts/chatlu-bot-setup.sh`.
+
+## Web push subscriptions
+
+Apps register their browser push subscriptions so notif can deliver `webpush` notifications (no `web-push` dependency needed in the app). Keyed by `endpoint`; `person` defaults to `agent`.
+
+```typescript
+await client.registerPushSubscription({
+  app: "cartlu",
+  person: "larry",
+  endpoint: sub.endpoint,
+  keys: { p256dh: sub.keys.p256dh, auth: sub.keys.auth },
+});
+
+const subs = await client.listPushSubscriptions({ app: "cartlu", person: "larry" });
+await client.deletePushSubscription({ id: subs[0]._id });     // or { endpoint }
+```
+
+Expired endpoints (404/410 from the push service) are dropped automatically at delivery time. Web push channels need VAPID config: on the channel (`vapidSubject` / `vapidPublicKey` / `vapidPrivateKey` / `ttl`) or `WEBPUSH_VAPID_SUBJECT` / `WEBPUSH_VAPID_PUBLIC_KEY` / `WEBPUSH_VAPID_PRIVATE_KEY` / `WEBPUSH_TTL` env.
+
+## Aliases
+
+Friendly name → per-channel chat ids.
+
+```typescript
+await client.createAlias({
+  name: "larry",
+  mappings: { "default-telegram": "123456789", "alerts-discord": "987654321" },
+});
+const aliases = await client.listAliases();
+await client.updateAlias(id, { mappings: { "default-telegram": "111" } });
+await client.deleteAlias(id);
+```
+
+## Inbound replies
+
+Telegram / Messenger / LINE webhooks persist inbound events. List omits `rawPayload`; `getInbound` includes it.
+
+```typescript
+const replies = await client.listInbound({ channel: "telegram", matched: true, limit: 20 });
+const full = await client.getInbound(replies[0]._id);
+```
+
+## Health
+
+```typescript
+const h = await client.health();
+// { ok, workerRunning, notificationCount, aliasCount, channelCount, channels, providers }
+```
+
+## Errors
+
+```typescript
+import { NotifClient, NotifError } from "@betterlu/notif";
+
+try {
+  await client.send({ channel: "telegram", message: "" });
+} catch (err) {
+  if (err instanceof NotifError) {
+    console.error(err.status, err.message); // 400 message is required
+  } else {
+    throw err;
+  }
+}
+```
+
+No auth. Inject `fetch` for tests or custom middleware:
+
+```typescript
+const client = new NotifClient({
+  baseUrl: "http://localhost:8778",
+  fetch: myFetch,
+});
+```
+
+## API reference
+
+### `NotifClient`
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `health()` | `HealthResponse` | Worker + channel list |
+| `send(req)` | `Notification` | Enqueue (202) |
+| `notify(message, opts?)` | `Notification` | Shorthand for `send` |
+| `notifyTelegramHtml(user, html)` | `Notification` | Telegram HTML to an alias (`userName`) |
+| `escapeHtml(value)` | `string` | Escape `& < > " '` for Telegram HTML |
+| `listNotifications(query?)` | `Notification[]` | Filter queue |
+| `getNotification(id)` | `Notification` | One notification |
+| `retryNotification(id)` | `Notification` | Re-queue a failed send |
+| `deleteNotification(id)` | `Notification` | Delete |
+| `listChannels()` | `Channel[]` | All channels |
+| `getChannel(id)` | `Channel` | One channel (secrets masked) |
+| `createChannel(req)` | `Channel` | Create |
+| `updateChannel(id, req)` | `Channel` | Partial update |
+| `deleteChannel(id)` | `Channel` | Delete |
+| `registerWebhook(id, req?)` | `RegisterWebhookResult` | Telegram `setWebhook` |
+| `registerPushSubscription(req)` | `PushSubscription` | Upsert a web push subscription by endpoint |
+| `listPushSubscriptions(query?)` | `PushSubscription[]` | Filter by `person`, `app`, `limit` |
+| `deletePushSubscription({ id?, endpoint? })` | `PushSubscription` | Delete a subscription |
+| `listAliases(query?)` | `Alias[]` | All aliases |
+| `getAlias(id)` | `Alias` | One alias |
+| `createAlias(req)` | `Alias` | Create |
+| `updateAlias(id, req)` | `Alias` | Update |
+| `deleteAlias(id)` | `Alias` | Delete |
+| `listInbound(query?)` | `InboundResponse[]` | Inbound events (no `rawPayload`) |
+| `getInbound(id)` | `InboundResponse` | One inbound (includes `rawPayload`) |
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,30 @@
+import type { Alias, Channel, ClientOptions, CreateAliasRequest, CreateChannelRequest, HealthResponse, InboundResponse, ListAliasesQuery, ListInboundQuery, ListNotificationsQuery, Notification, RegisterWebhookRequest, RegisterWebhookResult, SendNotificationRequest, UpdateAliasRequest, UpdateChannelRequest, PushSubscription, RegisterPushSubscriptionRequest, ListPushSubscriptionsQuery, DeletePushSubscriptionRequest } from "./types.js";
+export declare class NotifClient {
+    private readonly transport;
+    constructor(options?: ClientOptions);
+    health(): Promise<HealthResponse>;
+    send(request: SendNotificationRequest): Promise<Notification>;
+    notify(message: string, opts?: Omit<SendNotificationRequest, "message">): Promise<Notification>;
+    notifyTelegramHtml(user: string, html: string): Promise<Notification>;
+    listNotifications(query?: ListNotificationsQuery): Promise<Notification[]>;
+    getNotification(id: string): Promise<Notification>;
+    retryNotification(id: string): Promise<Notification>;
+    deleteNotification(id: string): Promise<Notification>;
+    listChannels(): Promise<Channel[]>;
+    getChannel(id: string): Promise<Channel>;
+    createChannel(request: CreateChannelRequest): Promise<Channel>;
+    updateChannel(id: string, request: UpdateChannelRequest): Promise<Channel>;
+    deleteChannel(id: string): Promise<Channel>;
+    registerWebhook(id: string, request?: RegisterWebhookRequest): Promise<RegisterWebhookResult>;
+    registerPushSubscription(request: RegisterPushSubscriptionRequest): Promise<PushSubscription>;
+    listPushSubscriptions(query?: ListPushSubscriptionsQuery): Promise<PushSubscription[]>;
+    deletePushSubscription(request: DeletePushSubscriptionRequest): Promise<PushSubscription>;
+    listAliases(query?: ListAliasesQuery): Promise<Alias[]>;
+    getAlias(id: string): Promise<Alias>;
+    createAlias(request: CreateAliasRequest): Promise<Alias>;
+    updateAlias(id: string, request: UpdateAliasRequest): Promise<Alias>;
+    deleteAlias(id: string): Promise<Alias>;
+    listInbound(query?: ListInboundQuery): Promise<InboundResponse[]>;
+    getInbound(id: string): Promise<InboundResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,KAAK,EACL,OAAO,EACP,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,+BAA+B,EAC/B,0BAA0B,EAC1B,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AAQpB,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,OAAO,GAAE,aAAkB;IAQjC,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAIjC,IAAI,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI7D,MAAM,CACV,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAM,GAClD,OAAO,CAAC,YAAY,CAAC;IAIlB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIrE,iBAAiB,CAAC,KAAK,GAAE,sBAA2B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI9E,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIlD,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIpD,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIrD,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIlC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxC,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1E,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3C,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAQjG,wBAAwB,CAAC,OAAO,EAAE,+BAA+B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI7F,qBAAqB,CAAC,KAAK,GAAE,0BAA+B,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAI1F,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIzF,WAAW,CAAC,KAAK,GAAE,gBAAqB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAI3D,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIpC,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAIxD,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAIpE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIvC,WAAW,CAAC,KAAK,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIrE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAGvD"}

package/dist/client.js

@@ -0,0 +1,89 @@
+import { DEFAULT_BASE_URL, ENV_URL_VAR } from "./types.js";
+import { createTransport } from "./transport.js";
+function resolveBaseUrl(baseUrl) {
+    const raw = baseUrl ?? (typeof process !== "undefined" ? process.env[ENV_URL_VAR] : undefined) ?? DEFAULT_BASE_URL;
+    return raw.replace(/\/+$/, "");
+}
+export class NotifClient {
+    transport;
+    constructor(options = {}) {
+        this.transport = createTransport({
+            baseUrl: resolveBaseUrl(options.baseUrl),
+            fetch: options.fetch,
+            timeoutMs: options.timeoutMs,
+        });
+    }
+    async health() {
+        return this.transport.request("GET", "/api/health");
+    }
+    async send(request) {
+        return this.transport.request("POST", "/api/notifications", request);
+    }
+    async notify(message, opts = {}) {
+        return this.send({ ...opts, message });
+    }
+    async notifyTelegramHtml(user, html) {
+        return this.send({ channel: "telegram", userName: user, message: html, format: "html" });
+    }
+    async listNotifications(query = {}) {
+        return this.transport.request("GET", "/api/notifications", undefined, query);
+    }
+    async getNotification(id) {
+        return this.transport.request("GET", `/api/notifications/${id}`);
+    }
+    async retryNotification(id) {
+        return this.transport.request("POST", `/api/notifications/${id}/retry`);
+    }
+    async deleteNotification(id) {
+        return this.transport.request("DELETE", `/api/notifications/${id}`);
+    }
+    async listChannels() {
+        return this.transport.request("GET", "/api/channels");
+    }
+    async getChannel(id) {
+        return this.transport.request("GET", `/api/channels/${id}`);
+    }
+    async createChannel(request) {
+        return this.transport.request("POST", "/api/channels", request);
+    }
+    async updateChannel(id, request) {
+        return this.transport.request("PUT", `/api/channels/${id}`, request);
+    }
+    async deleteChannel(id) {
+        return this.transport.request("DELETE", `/api/channels/${id}`);
+    }
+    async registerWebhook(id, request = {}) {
+        return this.transport.request("POST", `/api/channels/${id}/register-webhook`, request);
+    }
+    async registerPushSubscription(request) {
+        return this.transport.request("POST", "/api/push/subscriptions", request);
+    }
+    async listPushSubscriptions(query = {}) {
+        return this.transport.request("GET", "/api/push/subscriptions", undefined, query);
+    }
+    async deletePushSubscription(request) {
+        return this.transport.request("DELETE", "/api/push/subscriptions", request);
+    }
+    async listAliases(query = {}) {
+        return this.transport.request("GET", "/api/aliases", undefined, query);
+    }
+    async getAlias(id) {
+        return this.transport.request("GET", `/api/aliases/${id}`);
+    }
+    async createAlias(request) {
+        return this.transport.request("POST", "/api/aliases", request);
+    }
+    async updateAlias(id, request) {
+        return this.transport.request("PUT", `/api/aliases/${id}`, request);
+    }
+    async deleteAlias(id) {
+        return this.transport.request("DELETE", `/api/aliases/${id}`);
+    }
+    async listInbound(query = {}) {
+        return this.transport.request("GET", "/api/inbound-responses", undefined, query);
+    }
+    async getInbound(id) {
+        return this.transport.request("GET", `/api/inbound-responses/${id}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,5 @@
+export declare class NotifError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEnB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK5C"}

package/dist/errors.js

@@ -0,0 +1,9 @@
+export class NotifError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.name = "NotifError";
+        this.status = status;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnB,MAAM,CAAS;IAE/B,YAAY,MAAc,EAAE,OAAe;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/dist/html.d.ts

@@ -0,0 +1,3 @@
+/** Escape text for Telegram HTML. `&` is handled in the same pass so entities are not double-escaped. */
+export declare function escapeHtml(value: string): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAQA,yGAAyG;AACzG,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/html.js

@@ -0,0 +1,12 @@
+const REPLACEMENTS = {
+    "&": "&",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#39;",
+};
+/** Escape text for Telegram HTML. `&` is handled in the same pass so entities are not double-escaped. */
+export function escapeHtml(value) {
+    return value.replace(/[&<>"']/g, (char) => REPLACEMENTS[char]);
+}
+//# sourceMappingURL=html.js.map

package/dist/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAA2B;IAC3C,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;CACb,CAAC;AAEF,yGAAyG;AACzG,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAE,CAAC,CAAC;AAClE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { NotifClient } from "./client.js";
+export { escapeHtml } from "./html.js";
+export { NotifError } from "./errors.js";
+export { ENDPOINTS, DEFAULT_BASE_URL, ENV_URL_VAR } from "./types.js";
+export type { ClientOptions, Provider, Format, NotificationStatus, CorrelationMethod, CorrelationConfidence, NotificationOptions, Recipient, SendNotificationRequest, NotificationError, Notification, ListNotificationsQuery, TelegramChannelConfig, MessengerChannelConfig, DiscordChannelConfig, LineChannelConfig, ChatluChannelConfig, WebPushChannelConfig, ChannelConfig, Channel, CreateChannelRequest, UpdateChannelRequest, RegisterWebhookRequest, RegisterWebhookResult, Alias, CreateAliasRequest, UpdateAliasRequest, ListAliasesQuery, InboundResponse, ListInboundQuery, PushSubscriptionKeys, PushSubscription, RegisterPushSubscriptionRequest, ListPushSubscriptionsQuery, DeletePushSubscriptionRequest, HealthResponse, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtE,YAAY,EACV,aAAa,EACb,QAAQ,EACR,MAAM,EACN,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,EACT,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,+BAA+B,EAC/B,0BAA0B,EAC1B,6BAA6B,EAC7B,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { NotifClient } from "./client.js";
+export { escapeHtml } from "./html.js";
+export { NotifError } from "./errors.js";
+export { ENDPOINTS, DEFAULT_BASE_URL, ENV_URL_VAR } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/transport.d.ts

@@ -0,0 +1,12 @@
+export interface TransportOptions {
+    baseUrl: string;
+    fetch?: typeof globalThis.fetch;
+    timeoutMs?: number;
+}
+type QueryParams = object;
+export declare function createTransport(opts: TransportOptions): {
+    request: <T>(method: string, path: string, body?: unknown, query?: QueryParams) => Promise<T>;
+};
+export type Transport = ReturnType<typeof createTransport>;
+export {};
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD,KAAK,WAAW,GAAG,MAAM,CAAC;AA8D1B,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB;cAExC,CAAC,UACD,MAAM,QACR,MAAM,SACL,OAAO,UACN,WAAW;EAGxB;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/transport.js

@@ -0,0 +1,55 @@
+import { NotifError } from "./errors.js";
+function toQuery(params) {
+    if (!params)
+        return "";
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined)
+            continue;
+        search.set(key, String(value));
+    }
+    const qs = search.toString();
+    return qs ? `?${qs}` : "";
+}
+async function request(opts, method, path, body, query) {
+    const fetchFn = opts.fetch ?? globalThis.fetch;
+    const url = `${opts.baseUrl}${path}${toQuery(query)}`;
+    const headers = {};
+    let reqBody;
+    if (body !== undefined) {
+        headers["Content-Type"] = "application/json";
+        reqBody = JSON.stringify(body);
+    }
+    const res = await fetchFn(url, {
+        method,
+        headers,
+        body: reqBody,
+        signal: opts.timeoutMs ? AbortSignal.timeout(opts.timeoutMs) : undefined,
+    });
+    let json;
+    try {
+        json = (await res.json());
+    }
+    catch {
+        if (!res.ok) {
+            throw new NotifError(res.status, `HTTP ${res.status}`);
+        }
+        throw new NotifError(res.status, "Response is not JSON");
+    }
+    if (!res.ok) {
+        const message = json && typeof json === "object" && "error" in json && typeof json.error === "string"
+            ? json.error
+            : `HTTP ${res.status}`;
+        throw new NotifError(res.status, message);
+    }
+    if (json && typeof json === "object" && "data" in json && json.ok === true) {
+        return json.data;
+    }
+    return json;
+}
+export function createTransport(opts) {
+    return {
+        request: (method, path, body, query) => request(opts, method, path, body, query),
+    };
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,275 @@
+export declare const ENDPOINTS: {
+    readonly local: "http://localhost:8778";
+};
+export declare const DEFAULT_BASE_URL: "http://localhost:8778";
+export declare const ENV_URL_VAR = "NOTIF_URL";
+export interface ClientOptions {
+    /** Origin only (no `/api`). Defaults to `NOTIF_URL` or `http://localhost:8778`. */
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+    /** Abort each request after this many milliseconds. */
+    timeoutMs?: number;
+}
+export type Provider = "telegram" | "messenger" | "discord" | "line" | "email" | "chatlu" | "webpush";
+export type Format = "plain" | "markdown" | "html";
+export type NotificationStatus = "pending" | "processing" | "sent" | "failed";
+export type CorrelationMethod = "unmatched" | "reply_metadata" | "known_sender" | "sender_recent_sent" | "ambiguous";
+export type CorrelationConfidence = "none" | "medium" | "high";
+export interface NotificationOptions {
+    disableNotification?: boolean;
+    protectContent?: boolean;
+    linkPreview?: boolean;
+    threadId?: string | number;
+    replyToMessageId?: string | number;
+    replyMarkup?: unknown;
+    messengerTag?: string | false | null;
+    username?: string;
+    avatarUrl?: string;
+    /** Required for email channels. */
+    subject?: string;
+    /** Web push notification title (webpush channels). Defaults to "Notification". */
+    title?: string;
+    /** Web push click-through URL (webpush channels). */
+    url?: string;
+    /** Web push icon path (webpush channels). */
+    icon?: string;
+    /** Web push badge path (webpush channels). */
+    badge?: string;
+    /** Web push TTL in seconds (webpush channels). Overrides the channel default. */
+    ttl?: number;
+    /** Web push target filter: person (webpush channels, used when chatId is omitted). */
+    person?: string;
+    /** Web push target filter: app (webpush channels, used when chatId is omitted). */
+    app?: string;
+}
+export interface Recipient {
+    chatId?: string | null;
+    psid?: string | null;
+}
+export interface SendNotificationRequest {
+    /** Channel name, provider type (`telegram` | …), or channel ObjectId. */
+    channel?: string;
+    /** Alternate field for `channel`. */
+    channelId?: string;
+    message: string;
+    /** Alias name first, else raw chat id. */
+    chatId?: string;
+    /** Alias-only (back-compat). */
+    user?: string;
+    /** Alias-only (back-compat). */
+    userName?: string;
+    recipient?: Recipient;
+    format?: Format;
+    options?: NotificationOptions;
+}
+export interface NotificationError {
+    code?: string;
+    message?: string;
+    retryable?: boolean;
+    raw?: unknown;
+    at?: string;
+}
+export interface Notification {
+    _id: string;
+    channel: string;
+    channelId: string;
+    provider: Provider;
+    message: string;
+    format: Format;
+    recipient: Recipient;
+    chatId: string | null;
+    alias: string | null;
+    userName: string | null;
+    options: NotificationOptions | null;
+    status: NotificationStatus;
+    attempts: number;
+    maxAttempts: number;
+    nextAttemptAt: string;
+    lastAttemptAt: string | null;
+    providerMessageId: string | null;
+    providerResponse: unknown;
+    error: NotificationError | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ListNotificationsQuery {
+    /** Channel name, or provider type (`telegram` filters by provider). */
+    channel?: string;
+    status?: NotificationStatus;
+    recipient?: string;
+    /** Default 50, max 50. */
+    limit?: number;
+}
+export interface TelegramChannelConfig {
+    botToken?: string;
+    webhookSecretToken?: string;
+}
+export interface MessengerChannelConfig {
+    pageAccessToken?: string;
+    apiVersion?: string;
+    verifyToken?: string;
+    appSecret?: string;
+}
+export interface DiscordChannelConfig {
+    webhookUrl?: string;
+    botToken?: string;
+    username?: string;
+}
+export interface LineChannelConfig {
+    channelAccessToken?: string;
+    channelSecret?: string;
+}
+export interface EmailChannelConfig {
+    host?: string;
+    port?: number;
+    secure?: boolean;
+    user?: string;
+    pass?: string;
+    from?: string;
+    fromName?: string;
+}
+export interface ChatluChannelConfig {
+    /** Matrix homeserver base URL, e.g. `http://127.0.0.1:8008`. */
+    homeserverUrl?: string;
+    /** Bot user access token (sent as `Authorization: Bearer`). */
+    accessToken?: string;
+}
+export interface WebPushChannelConfig {
+    /** VAPID contact, e.g. `mailto:you@example.com`. Falls back to `WEBPUSH_VAPID_SUBJECT`. */
+    vapidSubject?: string;
+    /** VAPID public key. Falls back to `WEBPUSH_VAPID_PUBLIC_KEY`. */
+    vapidPublicKey?: string;
+    /** VAPID private key. Falls back to `WEBPUSH_VAPID_PRIVATE_KEY`. */
+    vapidPrivateKey?: string;
+    /** Push TTL in seconds, default 21600. */
+    ttl?: number;
+}
+export type ChannelConfig = TelegramChannelConfig | MessengerChannelConfig | DiscordChannelConfig | LineChannelConfig | EmailChannelConfig | ChatluChannelConfig | WebPushChannelConfig | Record<string, string | undefined>;
+export interface Channel {
+    _id: string;
+    name: string;
+    provider: Provider;
+    config: ChannelConfig;
+    isDefault: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateChannelRequest {
+    name: string;
+    provider: Provider;
+    isDefault?: boolean;
+    config: ChannelConfig;
+}
+export interface UpdateChannelRequest {
+    name?: string;
+    provider?: Provider;
+    isDefault?: boolean;
+    config?: ChannelConfig;
+}
+export interface RegisterWebhookRequest {
+    baseUrl?: string;
+}
+export interface RegisterWebhookResult {
+    webhookUrl: string;
+    raw: unknown;
+}
+export interface Alias {
+    _id: string;
+    name: string;
+    normalizedName: string;
+    mappings: Record<string, string>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateAliasRequest {
+    name: string;
+    mappings: Record<string, string>;
+}
+export interface UpdateAliasRequest {
+    name?: string;
+    mappings?: Record<string, string>;
+}
+export interface ListAliasesQuery {
+    /** Default 500, max 500. */
+    limit?: number;
+}
+export interface InboundResponse {
+    _id: string;
+    channel: string;
+    channelId: string | null;
+    provider?: Provider;
+    providerEventId: string;
+    providerMessageId: string | null;
+    senderId: string | null;
+    recipientId: string | null;
+    senderDisplayName: string | null;
+    messageText: string | null;
+    eventType: string | null;
+    rawPayload?: unknown;
+    matchedNotificationId: string | null;
+    matchedAliasId: string | null;
+    matchedUserId: string | null;
+    correlationMethod?: CorrelationMethod;
+    correlationConfidence?: CorrelationConfidence;
+    isMatched: boolean;
+    receivedAt: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ListInboundQuery {
+    /** Channel name, or provider type. */
+    channel?: string;
+    matched?: boolean;
+    senderId?: string;
+    aliasId?: string;
+    userId?: string;
+    channelId?: string;
+    notificationId?: string;
+    /** Default 50, max 100. */
+    limit?: number;
+}
+export interface PushSubscriptionKeys {
+    p256dh: string;
+    auth: string;
+}
+export interface PushSubscription {
+    _id: string;
+    /** Person the browser belongs to, e.g. `larry`. Defaults to `agent`. */
+    person: string;
+    /** App that registered the subscription, e.g. `cartlu`. */
+    app: string;
+    endpoint: string;
+    keys: PushSubscriptionKeys;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface RegisterPushSubscriptionRequest {
+    /** App name, e.g. `cartlu`. */
+    app: string;
+    endpoint: string;
+    keys: PushSubscriptionKeys;
+    /** Person name; defaults to `agent`. */
+    person?: string;
+}
+export interface ListPushSubscriptionsQuery {
+    person?: string;
+    app?: string;
+    /** Default 200, max 500. */
+    limit?: number;
+}
+export interface DeletePushSubscriptionRequest {
+    /** Subscription id. */
+    id?: string;
+    /** Or the endpoint URL. */
+    endpoint?: string;
+}
+export interface HealthResponse {
+    ok: boolean;
+    workerRunning: boolean;
+    notificationCount: number;
+    aliasCount: number;
+    channelCount: number;
+    channels: Channel[];
+    providers: Provider[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+export const ENDPOINTS = {
+    local: "http://localhost:8778",
+};
+export const DEFAULT_BASE_URL = ENDPOINTS.local;
+export const ENV_URL_VAR = "NOTIF_URL";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,KAAK,EAAE,uBAAuB;CACtB,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC,KAAK,CAAC;AAEhD,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@betterlu/notif",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.2.0",
+  "description": "Client SDK for notif — async Telegram / Messenger / Discord / LINE / email / ChatLu / web push notifications",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf dist"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "notif",
+    "notifications",
+    "telegram",
+    "messenger",
+    "discord",
+    "line",
+    "sdk"
+  ],
+  "author": "betterlu",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.3"
+  }
+}