@hardlydifficult/poller 1.0.24 → 1.0.26

package/README.md

@@ -1,6 +1,8 @@
 # @hardlydifficult/poller
 
-A generic polling utility with debounced triggers, overlapping request handling, and deep equality change detection.
+Opinionated polling with one entrypoint: `watch()`.
+
+The package starts immediately, emits only when the value changes, and keeps the returned handle small.
 
 ## Installation
 
@@ -10,149 +12,73 @@ npm install @hardlydifficult/poller
 
 ## Quick Start
 
-```typescript
-import { Poller } from "@hardlydifficult/poller";
+```ts
+import { watch } from "@hardlydifficult/poller";
 
-const poller = Poller.create({
-  fetch: async () => {
-    const res = await fetch("https://api.example.com/user");
-    return res.json();
-  },
-  onChange: (user, previousUser) => {
-    console.log("User changed:", user, previousUser);
+const userWatcher = await watch({
+  everyMs: 5_000,
+  read: () => fetch("/api/user").then((r) => r.json()),
+  onChange: (user, previous) => {
+    console.log("User changed", user, previous);
   },
-  intervalMs: 5000,
 });
 
-await poller.start();
-poller.trigger();
-poller.stop();
+await userWatcher.refresh();
+userWatcher.stop();
 ```
 
-## Poller Creation
-
-The `Poller` class supports two constructor styles: a modern options-based approach and a deprecated positional constructor for backward compatibility.
-
-### Options-based constructor (recommended)
+## API
 
-```typescript
-import { Poller } from "@hardlydifficult/poller";
+### `watch(options)`
 
-const poller = Poller.create({
-  fetch: async () => fetch("/api/data").then(r => r.json()),
-  onChange: (current, previous) => console.log("Changed:", current),
-  intervalMs: 3000,
-  debounceMs: 1000, // optional, defaults to 1000
-  onError: (error) => console.error("Poll error:", error), // optional
-  comparator: (curr, prev) => curr.id === prev?.id, // optional
-});
-```
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `fetch` | `() => Promise<T>` | Async function to fetch data |
-| `onChange` | `(current: T, previous: T \| undefined) => void` | Callback when data changes |
-| `intervalMs` | `number` | Polling interval in milliseconds |
-| `debounceMs` | `number` | Debounce delay for manual triggers (default: `1000`) |
-| `onError` | `(error: unknown) => void` | Error handler (optional) |
-| `comparator` | `(current: T, previous: T \| undefined) => boolean` | Custom change detection (default: deep equality) |
-
-### Deprecated positional constructor
-
-```typescript
-const poller = new Poller(
-  async () => fetch("/api/data").then(r => r.json()),
-  (current, previous) => console.log("Changed:", current),
-  3000,
-  (error) => console.error("Poll error:", error)
-);
-```
+Starts reading immediately and resolves after the first read attempt completes.
 
-> Note: This style is deprecated; use `Poller.create(options)` or `new Poller(options)` instead.
-
-## Polling Control
-
-### `start()`
-Starts polling at the configured interval. Returns immediately after the first fetch completes.
-
-```typescript
-await poller.start();
-```
-
-### `stop()`
-Stops all timers and prevents further polling.
-
-```typescript
-poller.stop();
-```
-
-### `trigger(debounceMs?)`
-Manually triggers a poll, debouncing multiple calls.
-
-```typescript
-poller.trigger();           // Uses default debounceMs
-poller.trigger(2000);       // Override debounce delay
-```
-
-## Change Detection
-
-By default, the `Poller` uses deep equality to detect changes, supporting primitives, arrays, and plain objects—even when new references are returned.
-
-```typescript
-const poller = Poller.create({
-  fetch: async () => ({ count: 42 }),
-  onChange: (data, prev) => console.log("Changed:", data),
-  intervalMs: 2000,
+```ts
+const watcher = await watch({
+  everyMs: 30_000,
+  read: () => fetch("/api/data").then((r) => r.json()),
+  onChange: (current, previous) => {
+    console.log("Changed:", current, previous);
+  },
+  onError: (error) => {
+    console.error("Read failed:", error.message);
+  },
+  isEqual: (current, previous) => current.id === previous?.id,
 });
-
-// Even if fetch returns a new object with same content, onChange won't fire
 ```
 
-### Custom comparator
+Options:
 
-You can supply a custom comparator to control change detection logic:
+- `read: () => Promise<T>`
+- `onChange: (current: T, previous: T | undefined) => void`
+- `everyMs: number`
+- `isEqual?: (current: T, previous: T | undefined) => boolean`
+- `onError?: (error: Error) => void`
 
-```typescript
-const poller = Poller.create({
-  fetch: async () => ({ id: 1, name: "Alice" }),
-  onChange: (data, prev) => console.log("Changed:", data.name),
-  intervalMs: 2000,
-  comparator: (current, previous) => current.name === previous?.name,
-});
-```
+### `watcher.current`
 
-## Error Handling
+The last emitted value. This stays `undefined` until a read succeeds and is accepted as changed.
 
-Errors during fetch or comparator execution are routed to the `onError` callback, if provided. Polling continues after errors.
+### `watcher.refresh()`
 
-```typescript
-const poller = Poller.create({
-  fetch: async () => { throw new Error("Network issue"); },
-  onChange: () => {},
-  intervalMs: 1000,
-  onError: (err) => console.warn("Caught error:", err),
-});
+Runs a read immediately and returns the current emitted value. If a read is already in flight, the same promise is reused.
 
-await poller.start(); // Continues polling despite error
+```ts
+const current = await watcher.refresh();
 ```
 
-## Overlapping Request Handling
+### `watcher.stop()`
 
-If a fetch is still pending when the next interval arrives, the new poll is skipped to avoid overlapping requests.
+Stops the interval and makes future `refresh()` calls a no-op.
 
-```typescript
-const poller = Poller.create({
-  fetch: async () => {
-    await new Promise(r => setTimeout(r, 2000)); // Simulate slow fetch
-    return "data";
-  },
-  onChange: () => {},
-  intervalMs: 1000, // Won't trigger overlapping fetch
-});
+```ts
+watcher.stop();
 ```
 
-## API Reference
+## Behavior
 
-- `Poller<T>`: Generic polling class
-- `PollerOptions<T>`: Options interface for configuring the poller
-- `Poller.create<T>(options: PollerOptions<T>): Poller<T>`: Static factory method (recommended)
+- The first successful read calls `onChange(current, undefined)`.
+- Reads never overlap.
+- Deep equality is the default change detection for primitives, arrays, and plain objects.
+- Polling continues after read failures.
+- If `onError` is omitted, errors are logged with `console.error`.

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { Poller, type PollerOptions } from "./Poller.js";
+export { watch, type WatchHandle, type WatchOptions } from "./watch.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":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Poller = void 0;
-var Poller_js_1 = require("./Poller.js");
-Object.defineProperty(exports, "Poller", { enumerable: true, get: function () { return Poller_js_1.Poller; } });
+exports.watch = void 0;
+var watch_js_1 = require("./watch.js");
+Object.defineProperty(exports, "watch", { enumerable: true, get: function () { return watch_js_1.watch; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAAyD;AAAhD,mGAAA,MAAM,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAAwE;AAA/D,iGAAA,KAAK,OAAA"}

package/dist/watch.d.ts

@@ -0,0 +1,17 @@
+/** Small opinionated polling utility that reads periodically and emits only when the value changes. */
+export interface WatchOptions<T> {
+    readonly read: () => Promise<T>;
+    readonly onChange: (current: T, previous: T | undefined) => void;
+    readonly everyMs: number;
+    readonly isEqual?: (current: T, previous: T | undefined) => boolean;
+    readonly onError?: (error: Error) => void;
+}
+/** Live watcher handle returned by {@link watch}. */
+export interface WatchHandle<T> {
+    readonly current: T | undefined;
+    stop(): void;
+    refresh(): Promise<T | undefined>;
+}
+/** Starts watching immediately and resolves after the first read attempt completes. */
+export declare function watch<T>(options: WatchOptions<T>): Promise<WatchHandle<T>>;
+//# sourceMappingURL=watch.d.ts.map

package/dist/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,OAAO,CAAC;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC3C;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,CAAC;IAChC,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CACnC;AAgGD,uFAAuF;AACvF,wBAAsB,KAAK,CAAC,CAAC,EAC3B,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAEzB"}

package/dist/watch.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.watch = watch;
+class Watcher {
+    readFn;
+    onChange;
+    everyMs;
+    isEqual;
+    onError;
+    timer;
+    currentValue;
+    stopped = false;
+    inFlight;
+    constructor(options) {
+        this.readFn = options.read;
+        this.onChange = options.onChange;
+        this.everyMs = options.everyMs;
+        this.isEqual = options.isEqual ?? defaultIsEqual;
+        this.onError = options.onError;
+    }
+    get current() {
+        return this.currentValue;
+    }
+    async start() {
+        await this.refresh();
+        if (!this.stopped) {
+            this.timer = setInterval(() => {
+                void this.refresh();
+            }, this.everyMs);
+            this.timer.unref();
+        }
+        return this;
+    }
+    stop() {
+        this.stopped = true;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+    }
+    refresh() {
+        if (this.stopped) {
+            return Promise.resolve(this.currentValue);
+        }
+        if (this.inFlight) {
+            return this.inFlight;
+        }
+        this.inFlight = this.readCurrentValue().finally(() => {
+            this.inFlight = undefined;
+        });
+        return this.inFlight;
+    }
+    async readCurrentValue() {
+        try {
+            const current = await this.readFn();
+            if (this.stopped) {
+                return this.currentValue;
+            }
+            if (!this.isEqual(current, this.currentValue)) {
+                const previous = this.currentValue;
+                this.onChange(current, previous);
+                this.currentValue = current;
+            }
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+        return this.currentValue;
+    }
+    handleError(error) {
+        const normalizedError = normalizeError(error);
+        if (this.onError) {
+            this.onError(normalizedError);
+            return;
+        }
+        console.error("watch() read failed:", normalizedError);
+    }
+}
+/** Starts watching immediately and resolves after the first read attempt completes. */
+async function watch(options) {
+    return new Watcher(options).start();
+}
+function normalizeError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+function defaultIsEqual(a, b) {
+    if (Object.is(a, b)) {
+        return true;
+    }
+    if (isPrimitive(a) || isPrimitive(b) || b === undefined) {
+        return false;
+    }
+    if (isPlainObjectOrArray(a) && isPlainObjectOrArray(b)) {
+        return deepEqual(a, b);
+    }
+    try {
+        return JSON.stringify(a) === JSON.stringify(b);
+    }
+    catch {
+        return false;
+    }
+}
+function isPrimitive(value) {
+    return (value === null || (typeof value !== "object" && typeof value !== "function"));
+}
+function isPlainObjectOrArray(value) {
+    if (Array.isArray(value)) {
+        return true;
+    }
+    if (value === null || typeof value !== "object") {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function deepEqual(a, b) {
+    if (Object.is(a, b)) {
+        return true;
+    }
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length) {
+            return false;
+        }
+        return a.every((item, index) => deepEqual(item, b[index]));
+    }
+    if (!isPlainObjectOrArray(a) || !isPlainObjectOrArray(b)) {
+        return false;
+    }
+    const aEntries = Object.entries(a);
+    const bEntries = Object.entries(b);
+    if (aEntries.length !== bEntries.length) {
+        return false;
+    }
+    return aEntries.every(([key, value]) => {
+        if (!(key in b)) {
+            return false;
+        }
+        return deepEqual(value, b[key]);
+    });
+}
+//# sourceMappingURL=watch.js.map

package/dist/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardlydifficult/poller",
-  "version": "1.0.24",
+  "version": "1.0.26",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -15,7 +15,7 @@
     "clean": "node --eval \"fs.rmSync('dist', { recursive: true, force: true })\""
   },
   "devDependencies": {
-    "@types/node": "25.3.2",
+    "@types/node": "25.3.5",
     "typescript": "5.9.3",
     "vitest": "4.0.18",
     "@vitest/coverage-v8": "4.0.18"

package/dist/Poller.d.ts

@@ -1,35 +0,0 @@
-/** Generic polling utility that periodically fetches data and invokes a callback when the result changes. */
-export interface PollerOptions<T> {
-    fetch: () => Promise<T>;
-    onChange: (current: T, previous: T | undefined) => void;
-    intervalMs: number;
-    onError?: (error: unknown) => void;
-    debounceMs?: number;
-    comparator?: (current: T, previous: T | undefined) => boolean;
-}
-/**
- *
- */
-export declare class Poller<T> {
-    private readonly fetchFn;
-    private readonly onChange;
-    private readonly intervalMs;
-    private readonly onError?;
-    private readonly debounceMs;
-    private readonly comparator;
-    private timer;
-    private previous;
-    private running;
-    private fetching;
-    private triggerTimeout;
-    constructor(options: PollerOptions<T>);
-    /** @deprecated Use `Poller.create(options)` or `new Poller({ ...options })` instead. */
-    constructor(fetchFn: () => Promise<T>, onChange: (current: T, previous: T | undefined) => void, intervalMs: number, onError?: (error: unknown) => void);
-    static create<T>(options: PollerOptions<T>): Poller<T>;
-    start(): Promise<void>;
-    stop(): void;
-    trigger(debounceMs?: number): void;
-    private poll;
-    private static resolveOptions;
-}
-//# sourceMappingURL=Poller.d.ts.map

package/dist/Poller.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Poller.d.ts","sourceRoot":"","sources":["../src/Poller.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAC7G,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,OAAO,CAAC;CAC/D;AAED;;GAEG;AACH,qBAAa,MAAM,CAAC,CAAC;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;IACzE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmD;IAE9E,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAA4C;gBAEtD,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IACrC,wFAAwF;gBAEtF,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,EACvD,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAuBpC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAIhD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,IAAI,IAAI,IAAI;IAYZ,OAAO,CAAC,UAAU,SAAkB,GAAG,IAAI;YAc7B,IAAI;IAqBlB,OAAO,CAAC,MAAM,CAAC,cAAc;CAuB9B"}

package/dist/Poller.js

@@ -1,158 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Poller = void 0;
-/**
- *
- */
-class Poller {
-    fetchFn;
-    onChange;
-    intervalMs;
-    onError;
-    debounceMs;
-    comparator;
-    timer;
-    previous;
-    running = false;
-    fetching = false;
-    triggerTimeout;
-    constructor(optionsOrFetch, onChange, intervalMs, onError) {
-        const options = Poller.resolveOptions(optionsOrFetch, onChange, intervalMs, onError);
-        this.fetchFn = options.fetch;
-        this.onChange = options.onChange;
-        this.intervalMs = options.intervalMs;
-        this.onError = options.onError;
-        this.debounceMs = options.debounceMs ?? 1_000;
-        this.comparator = options.comparator ?? defaultIsEqual;
-    }
-    static create(options) {
-        return new Poller(options);
-    }
-    async start() {
-        if (this.running) {
-            return;
-        }
-        this.running = true;
-        await this.poll();
-        this.timer = setInterval(() => {
-            void this.poll();
-        }, this.intervalMs);
-        this.timer.unref();
-    }
-    stop() {
-        this.running = false;
-        if (this.timer) {
-            clearInterval(this.timer);
-            this.timer = undefined;
-        }
-        if (this.triggerTimeout) {
-            clearTimeout(this.triggerTimeout);
-            this.triggerTimeout = undefined;
-        }
-    }
-    trigger(debounceMs = this.debounceMs) {
-        if (!this.running) {
-            return;
-        }
-        if (this.triggerTimeout) {
-            clearTimeout(this.triggerTimeout);
-        }
-        this.triggerTimeout = setTimeout(() => {
-            this.triggerTimeout = undefined;
-            void this.poll();
-        }, debounceMs);
-        this.triggerTimeout.unref();
-    }
-    async poll() {
-        if (this.fetching) {
-            return;
-        }
-        this.fetching = true;
-        try {
-            const current = await this.fetchFn();
-            if (!this.comparator(current, this.previous)) {
-                this.onChange(current, this.previous);
-                this.previous = current;
-            }
-        }
-        catch (error) {
-            if (this.onError) {
-                this.onError(error);
-            }
-        }
-        finally {
-            this.fetching = false;
-        }
-    }
-    static resolveOptions(optionsOrFetch, onChange, intervalMs, onError) {
-        if (typeof optionsOrFetch !== "function") {
-            return optionsOrFetch;
-        }
-        if (!onChange || intervalMs === undefined) {
-            throw new Error("Poller positional constructor requires fetch, onChange, and intervalMs.");
-        }
-        return {
-            fetch: optionsOrFetch,
-            onChange,
-            intervalMs,
-            onError,
-        };
-    }
-}
-exports.Poller = Poller;
-function defaultIsEqual(a, b) {
-    if (Object.is(a, b)) {
-        return true;
-    }
-    if (isPrimitive(a) || isPrimitive(b) || b === undefined) {
-        return false;
-    }
-    if (isPlainObjectOrArray(a) && isPlainObjectOrArray(b)) {
-        return deepEqual(a, b);
-    }
-    try {
-        return JSON.stringify(a) === JSON.stringify(b);
-    }
-    catch {
-        return false;
-    }
-}
-function isPrimitive(value) {
-    return (value === null || (typeof value !== "object" && typeof value !== "function"));
-}
-function isPlainObjectOrArray(value) {
-    if (Array.isArray(value)) {
-        return true;
-    }
-    if (value === null || typeof value !== "object") {
-        return false;
-    }
-    const prototype = Object.getPrototypeOf(value);
-    return prototype === Object.prototype || prototype === null;
-}
-function deepEqual(a, b) {
-    if (Object.is(a, b)) {
-        return true;
-    }
-    if (Array.isArray(a) && Array.isArray(b)) {
-        if (a.length !== b.length) {
-            return false;
-        }
-        return a.every((item, index) => deepEqual(item, b[index]));
-    }
-    if (!isPlainObjectOrArray(a) || !isPlainObjectOrArray(b)) {
-        return false;
-    }
-    const aEntries = Object.entries(a);
-    const bEntries = Object.entries(b);
-    if (aEntries.length !== bEntries.length) {
-        return false;
-    }
-    return aEntries.every(([key, value]) => {
-        if (!(key in b)) {
-            return false;
-        }
-        return deepEqual(value, b[key]);
-    });
-}
-//# sourceMappingURL=Poller.js.map

package/dist/Poller.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Poller.js","sourceRoot":"","sources":["../src/Poller.ts"],"names":[],"mappings":"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"}