@wrongstack/telegram 0.286.0 → 0.289.0

package/dist/inbox-cursor-store.d.ts

@@ -0,0 +1,54 @@
+/** Default inbox cursor path. */
+export declare function inboxCursorPath(token: string, chatId: string | number, globalRoot?: string): string;
+export interface InboxCursorStoreOptions {
+    /** Bot token — derives a token-scoped default path. Never persisted. */
+    token?: string | undefined;
+    /** Explicit file path override. An empty string disables persistence. */
+    path?: string | undefined;
+    /** Base directory for token-scoped derivation. */
+    globalRoot?: string | undefined;
+}
+export declare class InboxCursorStore {
+    private readonly path;
+    constructor(opts?: InboxCursorStoreOptions);
+    get storePath(): string;
+    /**
+     * Read the persisted offset. Returns null when the file is missing,
+     * empty, or contains a value that is not a valid non-negative integer.
+     */
+    read(): number | null;
+    /**
+     * Persist an offset using an atomic write (temp + fsync + rename).
+     * Creates the parent directory on first call.
+     *
+     * P1.6 semantics: commit only on progress. offset = 0 means "never
+     * advanced past the initial state", so writing 0 would re-play the
+     * entire inbox on the next poll — we no-op it.
+     */
+    write(offset: number): void;
+}
+/**
+ * Per-inbox cursor map: chatId -> PersistedInboxCursor.
+ *
+ * The map is built by passing an `inboxId` to each operation, so a single
+ * store instance can drive an arbitrary number of inboxes; each one is
+ * isolated on disk and on the wire (the Telegram long-poll returns all
+ * messages globally, so the bot must also commit per-inbox deltas to
+ * maintain the replay boundary).
+ */
+export declare class PerInboxCursorMap {
+    private readonly basePath;
+    private readonly stores;
+    constructor(token: string, globalRoot?: string);
+    private readonly token;
+    private storeFor;
+    /** Read the offset for `inboxId`. Returns null when no offset is persisted. */
+    read(inboxId: string): number | null;
+    /** Persist the offset for `inboxId`. */
+    write(inboxId: string, offset: number): void;
+    /** Drop the cached store for `inboxId` (next read/write will reload from disk). */
+    invalidate(inboxId: string): void;
+    /** Drop all cached stores. */
+    clear(): void;
+}
+//# sourceMappingURL=inbox-cursor-store.d.ts.map

package/dist/inbox-cursor-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-cursor-store.d.ts","sourceRoot":"","sources":["../src/inbox-cursor-store.ts"],"names":[],"mappings":"AAiCA,iCAAiC;AACjC,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,UAAU,SAAqB,GAC9B,MAAM,CAER;AAED,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAE9B,YAAY,IAAI,GAAE,uBAA4B,EAQ7C;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;OAGG;IACH,IAAI,IAAI,MAAM,GAAG,IAAI,CAuBpB;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAoB1B;CACF;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;IAEnE,YAAY,KAAK,EAAE,MAAM,EAAE,UAAU,SAAqB,EAOzD;IAED,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,OAAO,CAAC,QAAQ;IAehB,+EAA+E;IAC/E,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEnC;IAED,wCAAwC;IACxC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE3C;IAED,mFAAmF;IACnF,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhC;IAED,8BAA8B;IAC9B,KAAK,IAAI,IAAI,CAEZ;CACF"}

package/dist/index.d.ts

@@ -1,6 +1,15 @@
 import type { Plugin } from '@wrongstack/core';
+import { TelegramBot } from './bot.js';
+import { TelegramBotOutbound } from './bot-queue.js';
+interface RuntimeState {
+    bot: TelegramBot;
+    outbound: TelegramBotOutbound;
+    cleanups: Array<() => void>;
+}
+declare let teardownState: RuntimeState | null;
 declare const plugin: Plugin;
 export default plugin;
+export { teardownState };
 export type { TelegramIncomingMessage } from './bot.js';
 export type { TelegramPluginConfig } from './config.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,kBAAkB,CAAC;AA2DvD,QAAA,MAAM,MAAM,EAAE,MAkPb,CAAC;eAEa,MAAM;AAGrB,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,MAAM,EAA2B,MAAM,kBAAkB,CAAC;AAGxF,OAAO,EAAE,WAAW,EAAuB,MAAM,UAAU,CAAC;AAS5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAuBrD,UAAU,YAAY;IACpB,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;CAC7B;AAED,QAAA,IAAI,aAAa,EAAE,YAAY,GAAG,IAAW,CAAC;AA+F9C,QAAA,MAAM,MAAM,EAAE,MA6Rb,CAAC;eAEa,MAAM;AAGrB,OAAO,EAAE,aAAa,EAAE,CAAC;AAGzB,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}