@mulmobridge/client 0.1.4 → 0.1.5

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/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.4",
+  "version": "0.1.5",
   "description": "Socket.io client library for MulmoBridge — shared by all bridge implementations",
   "type": "module",
   "main": "./dist/index.js",
@@ -49,7 +49,7 @@
     "socket.io-client": "^4.0.0"
   },
   "devDependencies": {
-    "@types/node": "^25.6.0",
+    "@types/node": "^26.1.0",
     "typescript": "^6.0.3"
   }
 }