@hardlydifficult/chat 1.1.24 → 1.1.25

package/README.md

@@ -155,6 +155,28 @@ Post a message that the specified user can dismiss by clicking the trash reactio
 await channel.postDismissable("Build complete!", user.id);
 ```
 
+### Message Tracker
+
+Track posted messages by key for later editing. Useful for status messages that should be updated in-place (e.g., "Worker disconnected" → "Worker reconnected").
+
+```typescript
+import { createMessageTracker } from "@hardlydifficult/chat";
+
+const tracker = createMessageTracker((content) => channel.postMessage(content));
+
+// Post and track by key
+tracker.post("worker-1", "🔴 Worker disconnected: Server A");
+
+// Later, edit the tracked message
+const postedAt = tracker.getPostedAt("worker-1");
+if (postedAt !== undefined) {
+  const downtime = Date.now() - postedAt.getTime();
+  tracker.edit("worker-1", `🟢 Worker reconnected: Server A (down for ${downtime}ms)`);
+}
+```
+
+`post()` is fire-and-forget. `edit()` handles the race where the edit arrives before the original post completes — it chains on the stored promise.
+
 ### Threads
 
 Create a thread, post messages, and listen for replies. The `Thread` object is the primary interface — all threading internals are hidden.

package/dist/MessageTracker.d.ts

@@ -0,0 +1,30 @@
+import type { Message } from "./Message";
+/**
+ * Tracks posted messages by key for later editing.
+ *
+ * Useful for status messages that should be updated in-place rather than
+ * posting a new message (e.g., "Worker disconnected" → "Worker reconnected").
+ */
+export interface MessageTracker {
+    /** Post a message and track it by key for later editing. */
+    post(key: string, content: string): void;
+    /** Edit a previously tracked message. Returns false if key not found. */
+    edit(key: string, content: string): boolean;
+    /** Get the timestamp when a tracked message was posted. */
+    getPostedAt(key: string): Date | undefined;
+}
+/**
+ * Create a message tracker that posts messages via the given function
+ * and allows editing them later by key.
+ *
+ * @example
+ * ```typescript
+ * const tracker = createMessageTracker((content) => channel.postMessage(content));
+ *
+ * tracker.post("worker-1", "🔴 Worker disconnected: Server A");
+ * // Later, when the worker reconnects:
+ * tracker.edit("worker-1", "🟢 Worker reconnected: Server A (down for 2m 5s)");
+ * ```
+ */
+export declare function createMessageTracker(postFn: (content: string) => PromiseLike<Message>): MessageTracker;
+//# sourceMappingURL=MessageTracker.d.ts.map

package/dist/MessageTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageTracker.d.ts","sourceRoot":"","sources":["../src/MessageTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,yEAAyE;IACzE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5C,2DAA2D;IAC3D,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAC5C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,WAAW,CAAC,OAAO,CAAC,GAChD,cAAc,CA6BhB"}

package/dist/MessageTracker.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMessageTracker = createMessageTracker;
+/**
+ * Create a message tracker that posts messages via the given function
+ * and allows editing them later by key.
+ *
+ * @example
+ * ```typescript
+ * const tracker = createMessageTracker((content) => channel.postMessage(content));
+ *
+ * tracker.post("worker-1", "🔴 Worker disconnected: Server A");
+ * // Later, when the worker reconnects:
+ * tracker.edit("worker-1", "🟢 Worker reconnected: Server A (down for 2m 5s)");
+ * ```
+ */
+function createMessageTracker(postFn) {
+    const entries = new Map();
+    return {
+        post(key, content) {
+            entries.set(key, { message: postFn(content), postedAt: new Date() });
+        },
+        edit(key, content) {
+            const entry = entries.get(key);
+            if (entry === undefined) {
+                return false;
+            }
+            entries.delete(key);
+            void Promise.resolve(entry.message)
+                .then((msg) => msg.update(content))
+                .catch(() => {
+                // Swallow — message may have been dismissed or deleted
+            });
+            return true;
+        },
+        getPostedAt(key) {
+            return entries.get(key)?.postedAt;
+        },
+    };
+}
+//# sourceMappingURL=MessageTracker.js.map

package/dist/MessageTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageTracker.js","sourceRoot":"","sources":["../src/MessageTracker.ts"],"names":[],"mappings":";;AA8BA,oDA+BC;AA5CD;;;;;;;;;;;;GAYG;AACH,SAAgB,oBAAoB,CAClC,MAAiD;IAEjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAGpB,CAAC;IAEJ,OAAO;QACL,IAAI,CAAC,GAAG,EAAE,OAAO;YACf,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,CAAC,GAAG,EAAE,OAAO;YACf,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpB,KAAK,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;iBAChC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;iBAClC,KAAK,CAAC,GAAG,EAAE;gBACV,uDAAuD;YACzD,CAAC,CAAC,CAAC;YACL,OAAO,IAAI,CAAC;QACd,CAAC;QAED,WAAW,CAAC,GAAG;YACb,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export { Message } from "./Message";
 export { EditableStreamReply } from "./EditableStreamReply";
 export { StreamingReply } from "./StreamingReply";
 export { Thread } from "./Thread";
+export { createMessageTracker, type MessageTracker } from "./MessageTracker";
 export { DiscordChatClient } from "./discord";
 export { SlackChatClient } from "./slack";
 import { type ChatClient } from "./ChatClient";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,IAAI,EACT,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG1C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAW/D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,IAAI,EACT,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG1C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAW/D"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SlackChatClient = exports.DiscordChatClient = exports.Thread = exports.StreamingReply = exports.EditableStreamReply = exports.Message = exports.Channel = exports.ChatClient = exports.MESSAGE_LIMITS = void 0;
+exports.SlackChatClient = exports.DiscordChatClient = exports.createMessageTracker = exports.Thread = exports.StreamingReply = exports.EditableStreamReply = exports.Message = exports.Channel = exports.ChatClient = exports.MESSAGE_LIMITS = void 0;
 exports.createChatClient = createChatClient;
 // Constants
 var constants_1 = require("./constants");
@@ -18,6 +18,8 @@ var StreamingReply_1 = require("./StreamingReply");
 Object.defineProperty(exports, "StreamingReply", { enumerable: true, get: function () { return StreamingReply_1.StreamingReply; } });
 var Thread_1 = require("./Thread");
 Object.defineProperty(exports, "Thread", { enumerable: true, get: function () { return Thread_1.Thread; } });
+var MessageTracker_1 = require("./MessageTracker");
+Object.defineProperty(exports, "createMessageTracker", { enumerable: true, get: function () { return MessageTracker_1.createMessageTracker; } });
 // Platform implementations
 var discord_1 = require("./discord");
 Object.defineProperty(exports, "DiscordChatClient", { enumerable: true, get: function () { return discord_1.DiscordChatClient; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AA4DA,4CAWC;AApDD,YAAY;AACZ,yCAA6C;AAApC,2GAAA,cAAc,OAAA;AAEvB,eAAe;AACf,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AAEf,2BAA2B;AAC3B,qCAA8C;AAArC,4GAAA,iBAAiB,OAAA;AAC1B,iCAA0C;AAAjC,wGAAA,eAAe,OAAA;AAIxB,uCAA8C;AAC9C,mCAA0C;AAG1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,gBAAgB,CAAC,MAAkB;IACjD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,IAAI,2BAAiB,CAAC,MAAM,CAAC,CAAC;QACvC,KAAK,OAAO;YACV,OAAO,IAAI,uBAAe,CAAC,MAAM,CAAC,CAAC;QACrC;YACE,MAAM,IAAI,KAAK,CACb,0BAA2B,MAA2B,CAAC,IAAI,EAAE,CAC9D,CAAC;IACN,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AA6DA,4CAWC;AArDD,YAAY;AACZ,yCAA6C;AAApC,2GAAA,cAAc,OAAA;AAEvB,eAAe;AACf,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,mDAA6E;AAApE,sHAAA,oBAAoB,OAAA;AAE7B,2BAA2B;AAC3B,qCAA8C;AAArC,4GAAA,iBAAiB,OAAA;AAC1B,iCAA0C;AAAjC,wGAAA,eAAe,OAAA;AAIxB,uCAA8C;AAC9C,mCAA0C;AAG1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,gBAAgB,CAAC,MAAkB;IACjD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,IAAI,2BAAiB,CAAC,MAAM,CAAC,CAAC;QACvC,KAAK,OAAO;YACV,OAAO,IAAI,uBAAe,CAAC,MAAM,CAAC,CAAC;QACrC;YACE,MAAM,IAAI,KAAK,CACb,0BAA2B,MAA2B,CAAC,IAAI,EAAE,CAC9D,CAAC;IACN,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardlydifficult/chat",
-  "version": "1.1.24",
+  "version": "1.1.25",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [