@mulmobridge/client 0.1.3 → 0.1.5

package/README.md

@@ -49,13 +49,43 @@ client.onPush((ev) => {
 
 ## Ecosystem
 
-Part of the `@mulmobridge/*` package family:
+Part of the [`@mulmobridge/*`](https://www.npmjs.com/~mulmobridge) package family.
 
-- **@mulmobridge/protocol** — shared types and constants
-- **@mulmobridge/client** — this package
-- **@mulmobridge/cli** — interactive terminal bridge
-- **@mulmobridge/telegram** — Telegram bot bridge
-- **@mulmobridge/chat-service** — server-side chat service
+**Shared libraries:**
+
+- [`@mulmobridge/client`](https://www.npmjs.com/package/@mulmobridge/client) — socket.io client library used by every bridge below  ← **this package**
+- [`@mulmobridge/protocol`](https://www.npmjs.com/package/@mulmobridge/protocol) — wire types and constants
+- [`@mulmobridge/chat-service`](https://www.npmjs.com/package/@mulmobridge/chat-service) — server-side relay + session store
+- [`@mulmobridge/relay`](https://www.npmjs.com/package/@mulmobridge/relay) — Cloudflare Workers webhook proxy
+- [`@mulmobridge/mock-server`](https://www.npmjs.com/package/@mulmobridge/mock-server) — mock server for local bridge development
+
+**Bridges** (one npm package per platform):
+
+- [`@mulmobridge/bluesky`](https://www.npmjs.com/package/@mulmobridge/bluesky) — Bluesky DMs over atproto
+- [`@mulmobridge/chatwork`](https://www.npmjs.com/package/@mulmobridge/chatwork) — Chatwork (Japanese business chat)
+- [`@mulmobridge/cli`](https://www.npmjs.com/package/@mulmobridge/cli) — interactive terminal bridge
+- [`@mulmobridge/discord`](https://www.npmjs.com/package/@mulmobridge/discord) — Discord bot via Gateway
+- [`@mulmobridge/email`](https://www.npmjs.com/package/@mulmobridge/email) — IMAP poll + SMTP reply, threading preserved
+- [`@mulmobridge/google-chat`](https://www.npmjs.com/package/@mulmobridge/google-chat) — Google Chat via MulmoBridge relay
+- [`@mulmobridge/irc`](https://www.npmjs.com/package/@mulmobridge/irc) — IRC (Libera, Freenode, custom)
+- [`@mulmobridge/line`](https://www.npmjs.com/package/@mulmobridge/line) — LINE Messaging API via MulmoBridge relay
+- [`@mulmobridge/line-works`](https://www.npmjs.com/package/@mulmobridge/line-works) — LINE Works (enterprise LINE)
+- [`@mulmobridge/mastodon`](https://www.npmjs.com/package/@mulmobridge/mastodon) — Mastodon DMs + mentions
+- [`@mulmobridge/matrix`](https://www.npmjs.com/package/@mulmobridge/matrix) — Matrix / Element
+- [`@mulmobridge/mattermost`](https://www.npmjs.com/package/@mulmobridge/mattermost) — Mattermost
+- [`@mulmobridge/messenger`](https://www.npmjs.com/package/@mulmobridge/messenger) — Facebook Messenger via MulmoBridge relay
+- [`@mulmobridge/nostr`](https://www.npmjs.com/package/@mulmobridge/nostr) — Nostr NIP-04 encrypted DMs
+- [`@mulmobridge/rocketchat`](https://www.npmjs.com/package/@mulmobridge/rocketchat) — Rocket.Chat
+- [`@mulmobridge/signal`](https://www.npmjs.com/package/@mulmobridge/signal) — Signal via signal-cli-rest-api
+- [`@mulmobridge/slack`](https://www.npmjs.com/package/@mulmobridge/slack) — Slack Socket Mode
+- [`@mulmobridge/teams`](https://www.npmjs.com/package/@mulmobridge/teams) — Microsoft Teams via Bot Framework
+- [`@mulmobridge/telegram`](https://www.npmjs.com/package/@mulmobridge/telegram) — Telegram bot
+- [`@mulmobridge/twilio-sms`](https://www.npmjs.com/package/@mulmobridge/twilio-sms) — SMS via Twilio Programmable Messaging
+- [`@mulmobridge/viber`](https://www.npmjs.com/package/@mulmobridge/viber) — Viber Public Account bots
+- [`@mulmobridge/webhook`](https://www.npmjs.com/package/@mulmobridge/webhook) — generic HTTP webhook bridge
+- [`@mulmobridge/whatsapp`](https://www.npmjs.com/package/@mulmobridge/whatsapp) — WhatsApp Cloud API via MulmoBridge relay
+- [`@mulmobridge/xmpp`](https://www.npmjs.com/package/@mulmobridge/xmpp) — XMPP / Jabber
+- [`@mulmobridge/zulip`](https://www.npmjs.com/package/@mulmobridge/zulip) — Zulip
 
 ## License
 

package/dist/index.d.ts

@@ -2,4 +2,5 @@ export { createBridgeClient, requireBearerToken, type MessageAck, type PushEvent
 export { readBridgeToken, TOKEN_FILE_PATH } from "./token.js";
 export { readBridgeEnvOptions } from "./options.js";
 export { chunkText } from "./text.js";
+export { formatAckReply } from "./reply.js";
 export { mimeFromExtension, isImageMime, isPdfMime, isSupportedAttachmentMime, isNativeAttachmentMime, parseDataUrl, buildDataUrl, type ParsedDataUrl, } from "./mime.js";

package/dist/index.js

@@ -3,4 +3,5 @@ export { createBridgeClient, requireBearerToken } from "./client.js";
 export { readBridgeToken, TOKEN_FILE_PATH } from "./token.js";
 export { readBridgeEnvOptions } from "./options.js";
 export { chunkText } from "./text.js";
+export { formatAckReply } from "./reply.js";
 export { mimeFromExtension, isImageMime, isPdfMime, isSupportedAttachmentMime, isNativeAttachmentMime, parseDataUrl, buildDataUrl, } from "./mime.js";

package/dist/mime.d.ts

@@ -1,14 +1,17 @@
 /** Infer MIME type from a file extension (case-insensitive).
  *  Returns the fallback if the extension is not recognised. */
 export declare function mimeFromExtension(ext: string, fallback?: string): string;
-/** True when the MIME type is an image Claude can see via vision. */
-export declare function isImageMime(mimeType: string): boolean;
+/** True when the MIME type is an image Claude can see via vision.
+ *  Tolerates `undefined` so callers can pass an attachment's optional
+ *  `mimeType` directly. */
+export declare function isImageMime(mimeType: string | undefined): boolean;
 /** True when the MIME type is a PDF document Claude can read natively
- *  via `type: "document"` content blocks. */
-export declare function isPdfMime(mimeType: string): boolean;
+ *  via `type: "document"` content blocks. Tolerates `undefined`. */
+export declare function isPdfMime(mimeType: string | undefined): boolean;
 /** True when the attachment can be sent to Claude directly as a
- *  native content block (image or PDF) — no conversion needed. */
-export declare function isNativeAttachmentMime(mimeType: string): boolean;
+ *  native content block (image or PDF) — no conversion needed.
+ *  Tolerates `undefined`. */
+export declare function isNativeAttachmentMime(mimeType: string | undefined): boolean;
 export declare const isSupportedAttachmentMime: typeof isNativeAttachmentMime;
 export interface ParsedDataUrl {
     mimeType: string;

package/dist/mime.js

@@ -31,17 +31,20 @@ const EXT_TO_MIME = {
 export function mimeFromExtension(ext, fallback = "application/octet-stream") {
     return EXT_TO_MIME[ext.toLowerCase()] ?? fallback;
 }
-/** True when the MIME type is an image Claude can see via vision. */
+/** True when the MIME type is an image Claude can see via vision.
+ *  Tolerates `undefined` so callers can pass an attachment's optional
+ *  `mimeType` directly. */
 export function isImageMime(mimeType) {
-    return mimeType.startsWith("image/");
+    return typeof mimeType === "string" && mimeType.startsWith("image/");
 }
 /** True when the MIME type is a PDF document Claude can read natively
- *  via `type: "document"` content blocks. */
+ *  via `type: "document"` content blocks. Tolerates `undefined`. */
 export function isPdfMime(mimeType) {
     return mimeType === "application/pdf";
 }
 /** True when the attachment can be sent to Claude directly as a
- *  native content block (image or PDF) — no conversion needed. */
+ *  native content block (image or PDF) — no conversion needed.
+ *  Tolerates `undefined`. */
 export function isNativeAttachmentMime(mimeType) {
     return isImageMime(mimeType) || isPdfMime(mimeType);
 }

package/dist/options.d.ts

@@ -5,9 +5,18 @@
  * Precedence when the same key resolves from both forms:
  * transport-specific wins over shared.
  *
+ * Transport ids with dashes (`google-chat`, `line-works`,
+ * `twilio-sms`, …) are normalised to underscores when building the
+ * env prefix: `google-chat` → `GOOGLE_CHAT_BRIDGE_*`. Dashes in env
+ * var names break shells, so `_` is the portable convention.
+ *
  * Example:
  *   SLACK_BRIDGE_DEFAULT_ROLE=slack
  *   BRIDGE_DEFAULT_ROLE=general
  *   → `{ defaultRole: "slack" }`
+ *
+ *   GOOGLE_CHAT_BRIDGE_DEFAULT_ROLE=support
+ *   (with transportId="google-chat")
+ *   → `{ defaultRole: "support" }`
  */
 export declare function readBridgeEnvOptions(transportId: string, env: Readonly<Record<string, string | undefined>>): Record<string, string>;

package/dist/options.js

@@ -48,13 +48,22 @@ function matchBridgePrefix(name, transportPrefix) {
  * Precedence when the same key resolves from both forms:
  * transport-specific wins over shared.
  *
+ * Transport ids with dashes (`google-chat`, `line-works`,
+ * `twilio-sms`, …) are normalised to underscores when building the
+ * env prefix: `google-chat` → `GOOGLE_CHAT_BRIDGE_*`. Dashes in env
+ * var names break shells, so `_` is the portable convention.
+ *
  * Example:
  *   SLACK_BRIDGE_DEFAULT_ROLE=slack
  *   BRIDGE_DEFAULT_ROLE=general
  *   → `{ defaultRole: "slack" }`
+ *
+ *   GOOGLE_CHAT_BRIDGE_DEFAULT_ROLE=support
+ *   (with transportId="google-chat")
+ *   → `{ defaultRole: "support" }`
  */
 export function readBridgeEnvOptions(transportId, env) {
-    const transportPrefix = `${transportId.toUpperCase()}_BRIDGE_`;
+    const transportPrefix = `${transportId.toUpperCase().replace(/-/g, "_")}_BRIDGE_`;
     const shared = {};
     const specific = {};
     for (const [name, value] of Object.entries(env)) {

package/dist/reply.d.ts

@@ -0,0 +1,8 @@
+import type { MessageAck } from "./client.js";
+/**
+ * Format a `MessageAck` as a single user-facing string.
+ *
+ * - `ok` ack → `reply` content (or empty string if absent).
+ * - Failed ack → `"Error[ (status)]: <error or 'unknown'>"`.
+ */
+export declare function formatAckReply(ack: MessageAck): string;

package/dist/reply.js

@@ -0,0 +1,19 @@
+// Shared reply formatting for bridges.
+//
+// Every bridge converts a `MessageAck` from `BridgeClient.send()`
+// into a single string to send back over its native transport. The
+// happy-path / error-path shape is identical across bridges
+// (LINE / Slack / Teams / Mastodon / XMPP all do the same thing
+// modulo the send call), so the formatting belongs here.
+/**
+ * Format a `MessageAck` as a single user-facing string.
+ *
+ * - `ok` ack → `reply` content (or empty string if absent).
+ * - Failed ack → `"Error[ (status)]: <error or 'unknown'>"`.
+ */
+export function formatAckReply(ack) {
+    if (ack.ok)
+        return ack.reply ?? "";
+    const status = ack.status ? ` (${ack.status})` : "";
+    return `Error${status}: ${ack.error ?? "unknown"}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mulmobridge/client",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Socket.io client library for MulmoBridge — shared by all bridge implementations",
   "type": "module",
   "main": "./dist/index.js",
@@ -45,11 +45,11 @@
   "license": "MIT",
   "author": "Receptron Team",
   "dependencies": {
-    "@mulmobridge/protocol": "^0.1.0",
+    "@mulmobridge/protocol": "^0.1.4",
     "socket.io-client": "^4.0.0"
   },
   "devDependencies": {
-    "@types/node": "^25.6.0",
+    "@types/node": "^26.1.0",
     "typescript": "^6.0.3"
   }
 }