@llblab/pi-telegram 0.56.0 → 0.56.1

package/lib/updates.ts

@@ -547,6 +547,7 @@ interface TelegramUpdateAdmissionBinding {
   inspectSource?: () => TelegramDeferredSourceEvidence | undefined;
   inspectSourceSnapshot?: () => TelegramDeferredSourceSnapshot | undefined;
   inspectCompletion?: () => TelegramDeferredSourceEvidence | undefined;
+  subscribeCompletion?: (notify: () => void) => () => void;
   isSourceUnsettled?: () => boolean;
   prepareLiveInput?: (
     sourceUpdateIds: readonly number[],
@@ -615,6 +616,7 @@ export function bindTelegramUpdateAdmissionSource<
     | "inspectSource"
     | "inspectSourceSnapshot"
     | "inspectCompletion"
+    | "subscribeCompletion"
     | "isSourceUnsettled"
     | "acknowledgeTransferred"
     | "prepareLiveInput"
@@ -743,6 +745,15 @@ export function inspectTelegramDeferredSourceCompletion(
   return execution.isCurrent() && source ? { ...source } : undefined;
 }
 
+/** Warm ACK notification only; subscribers must independently recheck exact completion and recipient authority. */
+export function subscribeTelegramDeferredSourceCompletion(value: unknown, notify: () => void): (() => void) | undefined {
+  const execution = getTelegramUpdateExecutionFence(value);
+  if (execution?.isCurrent() !== true) return undefined;
+  return getTelegramUpdateAdmissionBinding(value)?.subscribeCompletion?.(() => {
+    if (execution.isCurrent()) notify();
+  });
+}
+
 /** Reuse only live bound deferred originals; raw IDs or cold/adopted input cannot mint this carrier. */
 export function prepareTelegramLiveDeferredInput(
   values: readonly unknown[],
@@ -8721,6 +8732,7 @@ function createTelegramUpdateSourceAdmissionHandle<
     let outcome: TelegramUpdateAdmissionOutcome | undefined;
     let completionAttempted = false;
     let completedSource: TelegramDeferredSourceCompletion | undefined;
+    const completionObservers = new Set<() => void>();
     const boundUpdate = bindTelegramUpdateExecutionFence(
       bindTelegramUpdateAdmissionSource(
         update,
@@ -8777,11 +8789,12 @@ function createTelegramUpdateSourceAdmissionHandle<
                 execution.isCurrent() &&
                 completion.isCurrent() &&
                 isDeepStrictEqual(completion.source, expectedSource)
-              )
-                completedSource = {
-                  ...completion,
-                  source: { ...expectedSource },
-                };
+              ) {
+                completedSource = { ...completion, source: { ...expectedSource } };
+                for (const notify of completionObservers) {
+                  try { notify(); } catch { /* Observation cannot invalidate an exact removal ACK. */ }
+                }
+              }
             })
             .catch((error) => {
               try {
@@ -8842,6 +8855,10 @@ function createTelegramUpdateSourceAdmissionHandle<
                   signal,
                 })
               : undefined,
+          subscribeCompletion: (notify) => {
+            completionObservers.add(notify);
+            return () => { completionObservers.delete(notify); };
+          },
           inspectCompletion: () =>
             execution.isCurrent() && completedSource?.isCurrent()
               ? { ...completedSource.source }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-telegram",
-  "version": "0.56.0",
+  "version": "0.56.1",
   "private": false,
   "publishConfig": {
     "access": "public"