@indigoai-us/hq-cloud 5.25.0 → 5.27.0

package/dist/sync/push-event.test.js

@@ -0,0 +1,188 @@
+/**
+ * Unit tests for `src/sync/push-event.ts` (US-007 port).
+ *
+ * Covers the three required acceptance assertions:
+ *  1. A known-good fixture round-trips through encode → decode unchanged.
+ *  2. Unknown extra fields on the input are dropped silently (no throw).
+ *  3. Missing required fields throw a typed `PushEventDecodeError` whose
+ *     `.issues` exposes the underlying zod issues.
+ *
+ * Also covers the supporting invariants needed to keep the wire contract
+ * stable across the watcher → server → receiver hop: malformed JSON, bad
+ * hash/timestamp formats, and the integer/range bounds on `sequenceNumber`.
+ */
+import { describe, expect, it } from "vitest";
+import { PushEventDecodeError, decodePushEvent, encodePushEvent, } from "../../src/sync/index.js";
+// A canonical, valid PushEvent. All other tests derive from this fixture so
+// any single field mutation can't accidentally pass for the wrong reason.
+const validFixture = {
+    relativePath: "docs/architecture/overview.md",
+    contentHash: "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+    mtime: "2026-05-18T12:34:56.789Z",
+    originDeviceId: "device-laptop-a",
+    originTenantId: "tenant-indigo",
+    sequenceNumber: 42,
+    eventTimestamp: "2026-05-18T12:35:00.000Z",
+};
+describe("PushEvent encode/decode", () => {
+    // ── Acceptance #1: round-trip ──────────────────────────────────────────
+    it("round-trips a known-good fixture through encode → decode", () => {
+        const encoded = encodePushEvent(validFixture);
+        expect(typeof encoded).toBe("string");
+        const decoded = decodePushEvent(encoded);
+        expect(decoded).toEqual(validFixture);
+        // Re-encoding the decoded value must produce byte-identical output —
+        // catches accidental field re-ordering or coercion drift.
+        expect(encodePushEvent(decoded)).toBe(encoded);
+    });
+    it("decodes from a pre-parsed object as well as from a JSON string", () => {
+        const fromObject = decodePushEvent({ ...validFixture });
+        const fromString = decodePushEvent(JSON.stringify(validFixture));
+        expect(fromObject).toEqual(validFixture);
+        expect(fromString).toEqual(validFixture);
+    });
+    // ── Acceptance #2: unknown fields dropped ──────────────────────────────
+    it("drops unknown extra fields silently (does not throw)", () => {
+        const withExtras = {
+            ...validFixture,
+            // Future producers may add fields like `originAppVersion`; today's
+            // consumers must not crash on them.
+            originAppVersion: "1.2.3",
+            experimentalFlag: true,
+            nested: { ignored: "yes" },
+        };
+        const decoded = decodePushEvent(withExtras);
+        expect(decoded).toEqual(validFixture);
+        expect(decoded).not.toHaveProperty("originAppVersion");
+        expect(decoded).not.toHaveProperty("experimentalFlag");
+        expect(decoded).not.toHaveProperty("nested");
+        // Round-tripping through JSON behaves the same way.
+        const decodedFromJson = decodePushEvent(JSON.stringify(withExtras));
+        expect(decodedFromJson).toEqual(validFixture);
+    });
+    // ── Acceptance #3: missing required fields throw typed error ───────────
+    it.each([
+        "relativePath",
+        "contentHash",
+        "mtime",
+        "originDeviceId",
+        "originTenantId",
+        "sequenceNumber",
+        "eventTimestamp",
+    ])("throws PushEventDecodeError when %s is missing", (field) => {
+        const partial = { ...validFixture };
+        delete partial[field];
+        let caught;
+        try {
+            decodePushEvent(partial);
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(PushEventDecodeError);
+        const error = caught;
+        expect(error.stage).toBe("schema-validation");
+        expect(error.issues.length).toBeGreaterThan(0);
+        // The zod issue path must point at the missing field — that's what
+        // downstream callers rely on to render structured diagnostics.
+        expect(error.issues.some((issue) => issue.path.includes(field))).toBe(true);
+    });
+    it("PushEventDecodeError carries the underlying zod issues array", () => {
+        // Multiple missing fields → multiple issues, all reachable via `.issues`.
+        const sparse = { relativePath: "x.md" };
+        let caught;
+        try {
+            decodePushEvent(sparse);
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(PushEventDecodeError);
+        const error = caught;
+        expect(error.issues.length).toBeGreaterThanOrEqual(6);
+    });
+    // ── Supporting wire-contract invariants ────────────────────────────────
+    it("throws PushEventDecodeError on malformed JSON input", () => {
+        let caught;
+        try {
+            decodePushEvent("{not valid json");
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(PushEventDecodeError);
+        const error = caught;
+        expect(error.stage).toBe("json-parse");
+        expect(error.issues.length).toBe(1);
+    });
+    it("surfaces a JSON-parseable non-object payload as schema-validation, not json-parse", () => {
+        // `'42'` is syntactically valid JSON, so the parse stage clears; the
+        // object-shape check is what fails. Pinning this here keeps the JSDoc
+        // contract (see decodePushEvent docs) honest.
+        let caught;
+        try {
+            decodePushEvent("42");
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(PushEventDecodeError);
+        const error = caught;
+        expect(error.stage).toBe("schema-validation");
+    });
+    it.each([
+        ["raw hex without `sha256:` prefix", "e".repeat(64)],
+        ["wrong algorithm prefix", `md5:${"a".repeat(64)}`],
+        ["uppercase hex", `sha256:${"A".repeat(64)}`],
+        ["too few hex chars", `sha256:${"a".repeat(63)}`],
+    ])("rejects contentHash: %s", (_label, badHash) => {
+        expect(() => decodePushEvent({ ...validFixture, contentHash: badHash })).toThrow(PushEventDecodeError);
+    });
+    it.each([
+        ["missing timezone", "2026-05-18T12:34:56.789"],
+        ["space separator", "2026-05-18 12:34:56Z"],
+        ["date only", "2026-05-18"],
+    ])("rejects ISO-8601 timestamps: %s", (_label, badTimestamp) => {
+        expect(() => decodePushEvent({ ...validFixture, mtime: badTimestamp })).toThrow(PushEventDecodeError);
+        expect(() => decodePushEvent({ ...validFixture, eventTimestamp: badTimestamp })).toThrow(PushEventDecodeError);
+    });
+    it("accepts a sequenceNumber of 0 and rejects negative / fractional / oversized values", () => {
+        // 0 is allowed — sequence numbers are non-negative, not strictly positive.
+        expect(decodePushEvent({ ...validFixture, sequenceNumber: 0 })).toEqual({
+            ...validFixture,
+            sequenceNumber: 0,
+        });
+        expect(() => decodePushEvent({ ...validFixture, sequenceNumber: -1 })).toThrow(PushEventDecodeError);
+        expect(() => decodePushEvent({ ...validFixture, sequenceNumber: 1.5 })).toThrow(PushEventDecodeError);
+        expect(() => decodePushEvent({
+            ...validFixture,
+            sequenceNumber: Number.MAX_SAFE_INTEGER + 1,
+        })).toThrow(PushEventDecodeError);
+    });
+    it("encodePushEvent validates and drops unknown fields from the output", () => {
+        // We cast through `unknown` because the public type forbids extra keys —
+        // this models a producer that hands us a wider object by mistake.
+        const wider = {
+            ...validFixture,
+            stray: "field",
+        };
+        const encoded = encodePushEvent(wider);
+        expect(encoded.includes("stray")).toBe(false);
+        expect(JSON.parse(encoded)).toEqual(validFixture);
+    });
+    it("encodePushEvent throws PushEventDecodeError when input is invalid", () => {
+        const bad = { ...validFixture, contentHash: "not-a-hash" };
+        let caught;
+        try {
+            encodePushEvent(bad);
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(PushEventDecodeError);
+        const error = caught;
+        expect(error.stage).toBe("schema-validation");
+        expect(error.issues.some((issue) => issue.path.includes("contentHash"))).toBe(true);
+    });
+});
+//# sourceMappingURL=push-event.test.js.map

package/dist/sync/push-event.test.js.map

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

package/dist/sync/push-receiver.d.ts

@@ -0,0 +1,442 @@
+/**
+ * PushReceiver — inbound subscription seam for the hq-cloud watcher daemon
+ * (project event-driven-sync-menubar US-009).
+ *
+ * Mirrors {@link PushTransport} (`./push-transport.ts`) but for the opposite
+ * direction of travel: where the transport SHIPS local file changes out to the
+ * cloud, the receiver SUBSCRIBES to the tenant fanout and triggers an
+ * immediate, TARGETED local pull the moment a peer device of the same tenant
+ * publishes a change. Together they form the event-driven primary path; the
+ * existing `--poll-remote-ms` poll in `runRunnerWithLoop` is the safety net
+ * behind both.
+ *
+ * Transport: SNS → per-client SQS (US-000 decision)
+ * ─────────────────────────────────────────────────
+ * Per the US-000 transport investigation (companies/indigo/projects/
+ * event-driven-sync-menubar/references.md): reuse PR #112's SNS publish +
+ * DynamoDB catch-up log, and build the client RECEIVE side as a per-client
+ * SQS queue subscribed to `sync-push-{tenantId}`. The receiver long-polls its
+ * own queue, decodes each message body as a {@link PushEvent}, dedupes by
+ * `sequenceNumber` per `relativePath`, and bridges into the existing sync
+ * engine via an injected {@link SyncEngineFn} (→ targeted `runRunner` pull).
+ *
+ * The live queue is NOT provisioned yet (the server SQS-provisioning Lambda is
+ * an unbuilt follow-up — see references.md "Open items handed to the plan").
+ * So this module ships:
+ *  - {@link SqsClientLike} — the narrow SQS surface the receiver depends on
+ *    (`receiveMessage` / `deleteMessage`). Production callers pass an
+ *    `@aws-sdk/client-sqs` `SQSClient` adapted to this shape; unit tests inject
+ *    a fake. NO real AWS is required to exercise the receiver.
+ *  - {@link SqsPushReceiver} — the real receiver. Long-polls the queue,
+ *    dispatches each event through the shared dedupe path, deletes the message
+ *    on successful handoff, and reconnects on transient `receiveMessage`
+ *    failures with exponential backoff. SQS's own 14-day retention buffers
+ *    messages while the device is offline → reconnect-replay is "free": on
+ *    reconnect the poll loop simply resumes and the retained messages are
+ *    redelivered, then dedupe skips anything already processed.
+ *  - {@link NoopPushReceiver} — the dormant default. Flips `connected` on
+ *    start, opens no subscription. Wired when the daemon runs without a real
+ *    queue (or when the feature flag is OFF).
+ *  - {@link createPushReceiver} — factory the daemon uses; returns the noop
+ *    unless an SQS client + queue URL are supplied.
+ *
+ * Lifecycle (mirrors PushTransport)
+ * ─────────────────────────────────
+ *  - `start()` opens the subscription (begins the long-poll loop). Awaited
+ *    AFTER the watcher starts so a synthetic event can't race a half-built
+ *    daemon. When the feature flag is OFF, `start()` is a no-op and `connected`
+ *    stays false — NO queue is polled (dormant; AC#4).
+ *  - On each received message: validate with {@link decodePushEvent} (defense
+ *    in depth at the wire boundary), dedupe by `relativePath` against the
+ *    highest `sequenceNumber` seen for that path, then call the injected
+ *    {@link SyncEngineFn}. The sync engine is an injected seam — this story
+ *    does NOT re-implement download logic; it bridges to `runRunner` pull.
+ *  - `dispose()` aborts in-flight via AbortController, stops the poll loop,
+ *    awaits the in-flight sync up to a drain deadline, then disconnects.
+ *
+ * Dedupe (AC#3)
+ * ─────────────
+ * A per-`relativePath` map of the highest `sequenceNumber` already passed to
+ * `syncFn`. An incoming event with `sequenceNumber <= seen` is skipped. SQS
+ * at-least-once delivery + reconnect-replay means the SAME event can arrive
+ * twice; dedupe makes that idempotent.
+ *
+ * Disconnect / reconnect with catch-up replay (AC#3/#4)
+ * ─────────────────────────────────────────────────────
+ * `receiveMessage` failures (network blip, throttling) are caught; the loop
+ * backs off (exponential + jitter, capped) and resumes. Because the per-client
+ * SQS queue retains undelivered messages for 14 days, anything published while
+ * the device was offline/disconnected is redelivered when the poll resumes —
+ * catch-up replay with no server round-trip. Redelivered-but-already-processed
+ * events are absorbed by the dedupe path. The in-memory fake's
+ * `simulateDisconnect()` / `simulateReconnect()` model exactly this buffering.
+ *
+ * Feature flag (AC#4)
+ * ───────────────────
+ * Gated by the per-tenant {@link EventDrivenPushFlagProvider} (US-008's
+ * feature-flags.ts) — honors `HQ_SYNC_EVENT_DRIVEN_PUSH_ENABLED_TENANTS`
+ * (per-tenant) + the legacy global `HQ_SYNC_EVENT_DRIVEN_PUSH_ENABLED=true`.
+ * Default DISABLED. Resolution precedence: explicit `enabled` > injected
+ * `flagProvider.isEnabled(tenantId)` > default env-driven provider.
+ *
+ * Cross-tenant isolation (US-010)
+ * ───────────────────────────────
+ * Each receiver instance binds exactly ONE `tenantId` and polls exactly ONE
+ * queue URL (its own tenant's per-client queue). Isolation is enforced at the
+ * subscription boundary — the receiver never reads another tenant's queue, and
+ * never filters cross-tenant data post-hoc.
+ *
+ * @see ./push-transport.ts (the outbound seam this mirrors)
+ * @see ./feature-flags.ts (the per-tenant flag provider — US-008)
+ * @see ../bin/sync-runner.ts (the wiring site — runRunnerWithLoop)
+ * @see companies/indigo/projects/event-driven-sync-menubar/references.md (US-000)
+ *
+ * Adapted from indigoai-us/hq-pro PR #112 (src/sync/push-receiver.ts) into
+ * @indigoai-us/hq-cloud (Path B). The hq-pro source shipped only Noop +
+ * InMemory receivers (the production SQS path was deferred there); this module
+ * builds the real SQS receiver behind the same lifecycle/dedupe/flag seam.
+ */
+import { type PushEvent } from "./push-event.js";
+import { type EventDrivenPushFlagProvider } from "./feature-flags.js";
+import { type SyncLatencyMetric } from "./metrics.js";
+/**
+ * How long `dispose()` awaits an in-flight `syncFn` after aborting its signal,
+ * before abandoning it (the poll/cadence safety net re-pulls on the next tick).
+ */
+export declare const DEFAULT_RECEIVER_DISPOSE_DRAIN_MS = 5000;
+/** Default SQS long-poll wait (seconds). 20 is the SQS max — true long-poll. */
+export declare const DEFAULT_WAIT_TIME_SECONDS = 20;
+/** Default max messages pulled per `receiveMessage` call (SQS max is 10). */
+export declare const DEFAULT_MAX_MESSAGES = 10;
+/** Reconnect backoff defaults. */
+export declare const DEFAULT_RECONNECT_INITIAL_MS = 250;
+export declare const DEFAULT_RECONNECT_MAX_MS = 30000;
+/**
+ * One SQS message as the receiver consumes it. A structural subset of the AWS
+ * SDK `Message` so a real `SQSClient` response satisfies it without adaptation
+ * and tests can build literals.
+ */
+export interface SqsMessageLike {
+    /** The message payload — a JSON-encoded {@link PushEvent}. */
+    readonly Body?: string;
+    /** Opaque handle used to delete the message after successful handoff. */
+    readonly ReceiptHandle?: string;
+    /** Optional SQS message id (logged for diagnostics). */
+    readonly MessageId?: string;
+}
+/**
+ * The narrow SQS client surface the receiver depends on. The AWS SDK
+ * `SQSClient` does NOT match this shape directly (it exposes a single
+ * `send(command)`); production callers adapt it with a thin wrapper (see
+ * {@link sqsClientFromAwsSdk} in the wiring site / tests). Keeping the seam
+ * this narrow means unit tests inject a hand-written fake with zero AWS deps.
+ */
+export interface SqsClientLike {
+    /**
+     * Long-poll the queue. Resolves with zero or more messages. MUST honor the
+     * abort signal (resolve/reject promptly on abort) so `dispose()` doesn't
+     * block on an in-flight 20s long-poll.
+     */
+    receiveMessage(args: {
+        queueUrl: string;
+        maxMessages: number;
+        waitTimeSeconds: number;
+        signal: AbortSignal;
+    }): Promise<{
+        messages: SqsMessageLike[];
+    }>;
+    /** Delete a successfully-handled message so it isn't redelivered. */
+    deleteMessage(args: {
+        queueUrl: string;
+        receiptHandle: string;
+    }): Promise<void>;
+}
+/**
+ * Context handed to {@link SyncEngineFn} on every received event.
+ *
+ * - `event` — the validated, deduped PushEvent. `relativePath` is what the
+ *   sync engine pulls; `sequenceNumber` is for observability.
+ * - `signal` — aborts when `dispose()` runs past its drain deadline. A
+ *   well-behaved sync fn checks `signal.aborted` between stages and returns
+ *   early.
+ */
+export interface PushReceiverContext {
+    readonly event: PushEvent;
+    readonly signal: AbortSignal;
+}
+/**
+ * The injected sync function. The receiver does NOT perform the actual fetch —
+ * it hands off the relativePath to whatever the deployment supplies. In
+ * production this bridges to a targeted `runRunner` pull for the affected
+ * company/path; in tests it's a fake recording invocations.
+ *
+ * Errors from `syncFn` are CAUGHT by the receiver — they log and the loop
+ * continues. A misbehaving sync fn cannot crash the receiver. The poll/cadence
+ * safety net is the recovery path for a thrown pull.
+ */
+export type SyncEngineFn = (ctx: PushReceiverContext) => Promise<void>;
+/**
+ * Best-effort CloudWatch metric publish seam (US-011). Invoked on the
+ * receive-SUCCESS path with the measured save-on-A → visible-on-B latency.
+ * Defaults to {@link publishSyncLatencyMetric} (the module singleton client);
+ * tests inject a spy so no real AWS is touched. The receiver awaits it inside a
+ * try/catch — a metric failure can never crash the loop (it's also best-effort
+ * inside the default impl).
+ */
+export type PublishMetricFn = (metric: SyncLatencyMetric) => Promise<void>;
+/** Minimal structured logger. Defaults to a no-op (quiet daemon). */
+export interface ReceiverLogger {
+    info(obj: Record<string, unknown>, msg?: string): void;
+    warn(obj: Record<string, unknown>, msg?: string): void;
+    error(obj: Record<string, unknown>, msg?: string): void;
+    debug(obj: Record<string, unknown>, msg?: string): void;
+}
+/**
+ * Lifecycle handle. Mirrors {@link PushTransport} so daemon wiring is
+ * mechanically identical on both sides.
+ */
+export interface PushReceiver {
+    /** Open the subscription / poll loop. No-op when the feature flag is OFF. */
+    start(): Promise<void>;
+    /** Idempotent teardown — stop polling, abort + drain in-flight, disconnect. */
+    dispose(): Promise<void>;
+    /** Advisory: is the subscription currently believed to be open? */
+    readonly connected: boolean;
+}
+/**
+ * Default `PushReceiver` used when no real queue is wired (or the flag is OFF
+ * at the factory). `start()` flips `connected` true; `dispose()` flips it
+ * false. No subscription work, no events. Mirrors {@link NoopPushTransport}.
+ */
+export declare class NoopPushReceiver implements PushReceiver {
+    private _connected;
+    get connected(): boolean;
+    start(): Promise<void>;
+    dispose(): Promise<void>;
+}
+/**
+ * Configuration for {@link SqsPushReceiver}.
+ */
+export interface SqsPushReceiverOptions {
+    /**
+     * Tenant id this receiver subscribes to. Each instance binds exactly one
+     * tenant — cross-tenant isolation is enforced by the subscription boundary
+     * (this queue belongs to this tenant), not post-hoc filtering. (US-010)
+     */
+    tenantId: string;
+    /**
+     * The caller's own per-tenant SQS queue URL (minted server-side by the
+     * provisioning Lambda and subscribed to `sync-push-{tenantId}`). The
+     * receiver polls ONLY this URL.
+     */
+    queueUrl: string;
+    /** The injected SQS client. Tests pass a fake; production an SDK adapter. */
+    sqs: SqsClientLike;
+    /**
+     * The sync engine that performs the actual targeted pull. The receiver only
+     * invokes this; errors are logged + isolated from the loop.
+     */
+    syncFn: SyncEngineFn;
+    /** Structured logger. Default: a no-op (quiet). */
+    logger?: ReceiverLogger;
+    /**
+     * Feature-flag override — wins over provider + env when set explicitly.
+     * When the resolved value is false, `start()` is a no-op, `connected` stays
+     * false, and NO queue is polled. (AC#4)
+     */
+    enabled?: boolean;
+    /** Per-tenant flag provider (US-008). Consulted when `enabled` is unset. */
+    flagProvider?: EventDrivenPushFlagProvider;
+    /** Env snapshot for flag resolution. Default: `process.env`. */
+    env?: Record<string, string | undefined>;
+    /** SQS long-poll wait seconds. Default {@link DEFAULT_WAIT_TIME_SECONDS}. */
+    waitTimeSeconds?: number;
+    /** Max messages per receive. Default {@link DEFAULT_MAX_MESSAGES}. */
+    maxMessages?: number;
+    /** Max time `dispose()` waits for an in-flight syncFn after abort. */
+    disposeDrainMs?: number;
+    /** Reconnect backoff config. */
+    reconnect?: {
+        initialMs?: number;
+        maxMs?: number;
+        jitter?: boolean;
+    };
+    /**
+     * Sleep seam for backoff (tests inject a fast/abortable sleep). Default:
+     * host `setTimeout` that resolves early on abort.
+     */
+    sleep?: (ms: number, signal: AbortSignal) => Promise<void>;
+    /**
+     * Best-effort latency-metric publish (US-011). Called on the receive-success
+     * path with the measured save→visible latency. Default:
+     * {@link publishSyncLatencyMetric}; tests inject a spy. (AC#1/#3)
+     */
+    publishMetric?: PublishMetricFn;
+    /**
+     * Clock for latency measurement + metric timestamps. Default
+     * `() => Date.now()`. Tests inject a fake clock to assert the latency value.
+     */
+    now?: () => number;
+}
+/**
+ * Real client `PushReceiver` backed by a per-tenant SQS queue.
+ *
+ * Poll loop: long-poll `receiveMessage` → for each message, decode + dedupe +
+ * dispatch through `syncFn`, then `deleteMessage` on successful handoff. A
+ * `receiveMessage` rejection is treated as a transient disconnect: log, back
+ * off, resume. SQS retention covers offline catch-up; dedupe covers redelivery.
+ */
+export declare class SqsPushReceiver implements PushReceiver {
+    private readonly tenantId;
+    private readonly queueUrl;
+    private readonly sqs;
+    private readonly syncFn;
+    private readonly logger;
+    private readonly enabled;
+    private readonly waitTimeSeconds;
+    private readonly maxMessages;
+    private readonly disposeDrainMs;
+    private readonly reconnectInitialMs;
+    private readonly reconnectMaxMs;
+    private readonly reconnectJitter;
+    private readonly sleep;
+    private readonly publishMetric;
+    private readonly now;
+    private _connected;
+    private disposed;
+    private disposing;
+    private disposePromise;
+    /** Abort signal shared by the poll loop + in-flight sync; fired on dispose. */
+    private loopAbort;
+    /** The running poll loop promise; awaited (best-effort) during dispose. */
+    private loopPromise;
+    /** AbortController for the in-flight syncFn; refreshed each dispatch. */
+    private inFlightAbort;
+    private inFlightSync;
+    /** Per-path highest sequence number already PROCESSED by syncFn. */
+    private readonly seenSequencePerPath;
+    private _processedCount;
+    private _dedupedCount;
+    private _decodeFailureCount;
+    private _receiveErrorCount;
+    constructor(opts: SqsPushReceiverOptions);
+    get connected(): boolean;
+    start(): Promise<void>;
+    dispose(): Promise<void>;
+    /** Events that passed dedupe AND completed `syncFn` successfully. */
+    get processedCount(): number;
+    /** Events skipped by dedupe. */
+    get dedupedCount(): number;
+    /** Events dropped at the wire-boundary decode step. */
+    get decodeFailureCount(): number;
+    /** `receiveMessage` failures (transient disconnects) the loop recovered from. */
+    get receiveErrorCount(): number;
+    /**
+     * The long-poll loop. Runs until the loop abort signal fires (dispose). A
+     * `receiveMessage` rejection is a transient disconnect — log, back off,
+     * resume. Because the SQS queue retains messages, resuming after a blip
+     * replays the gap (catch-up). The loop never throws past this method; it
+     * is fire-and-forgotten by `start()` and awaited best-effort by `dispose()`.
+     */
+    private pollLoop;
+    /**
+     * Decode → dedupe → dispatch → delete a single SQS message. Decode failures
+     * and syncFn throws are logged + absorbed (never crash the loop). The message
+     * is deleted only after a successful handoff so an unprocessed message stays
+     * on the queue for redelivery (the dedupe path makes redelivery idempotent).
+     */
+    private handleMessage;
+    /**
+     * Dedupe + invoke `syncFn`. Returns true once the event has been accounted
+     * for (deduped, or syncFn settled) so the caller can delete the message.
+     * Stores the in-flight promise so `dispose()` can drain it.
+     */
+    private dispatch;
+    /** Delete a message, swallowing transport errors (redelivery is harmless). */
+    private safeDelete;
+    /**
+     * Publish one best-effort latency datum (US-011). Awaits `publishMetric` and
+     * swallows any rejection so a metric-backend outage can never reach the poll
+     * loop. Called fire-and-forget (`void`) off the dispatch critical path.
+     */
+    private emitLatencyMetric;
+    /** Exponential backoff (capped) with optional full-jitter. */
+    private computeBackoff;
+}
+/**
+ * A tiny in-process fanout the {@link InMemoryPushReceiver} subscribes against.
+ * Models SNS publish + the per-client SQS queue's disconnect buffering so unit
+ * tests can drive the receive path without AWS. `publish` raw strings (the
+ * wire form) so decode-failure paths are testable too.
+ */
+export declare class InMemoryFanout {
+    private readonly subscribers;
+    subscribe(handler: (raw: string) => void): () => void;
+    /** Publish a raw (already-encoded) message body to all subscribers. */
+    publish(raw: string): void;
+}
+/** Options for {@link InMemoryPushReceiver}. */
+export interface InMemoryPushReceiverOptions {
+    tenantId: string;
+    fanout: InMemoryFanout;
+    syncFn: SyncEngineFn;
+    logger?: ReceiverLogger;
+    enabled?: boolean;
+    flagProvider?: EventDrivenPushFlagProvider;
+    env?: Record<string, string | undefined>;
+    disposeDrainMs?: number;
+}
+/**
+ * In-memory receiver paired with {@link InMemoryFanout}. Powers the unit
+ * tests for dedupe, reconnect-replay, flag gating, and dispose-drain WITHOUT
+ * any AWS SDK. The dedupe / dispatch / dispose semantics are identical to
+ * {@link SqsPushReceiver} (shared design); the disconnect buffer is the
+ * in-process analogue of the per-client SQS queue's 14-day retention.
+ */
+export declare class InMemoryPushReceiver implements PushReceiver {
+    private readonly tenantId;
+    private readonly fanout;
+    private readonly syncFn;
+    private readonly logger;
+    private readonly enabled;
+    private readonly disposeDrainMs;
+    private _connected;
+    private disposed;
+    private disposing;
+    private disposePromise;
+    private unsubscribe;
+    private disconnectedFlag;
+    private readonly pendingDuringDisconnect;
+    private readonly seenSequencePerPath;
+    private inFlightAbort;
+    private inFlightSync;
+    private _processedCount;
+    private _dedupedCount;
+    private _decodeFailureCount;
+    constructor(opts: InMemoryPushReceiverOptions);
+    get connected(): boolean;
+    start(): Promise<void>;
+    dispose(): Promise<void>;
+    get processedCount(): number;
+    get dedupedCount(): number;
+    get decodeFailureCount(): number;
+    get bufferedCount(): number;
+    /** Emulate a network blip — events buffer instead of dispatching. */
+    simulateDisconnect(): void;
+    /** Emulate reconnect — drain the buffer through the same dedupe path. */
+    simulateReconnect(): void;
+    private dispatch;
+}
+/**
+ * Build a PushReceiver. The daemon defaults to the noop so wiring is
+ * regression-safe — production deployments wire the SQS impl explicitly once
+ * the server provisioning Lambda mints a queue URL. Mirrors PushTransport's
+ * noop-default opt-in posture.
+ */
+export type CreatePushReceiverOptions = (SqsPushReceiverOptions & {
+    kind?: "sqs";
+}) | {
+    kind: "noop";
+};
+export declare function createPushReceiver(opts: CreatePushReceiverOptions): PushReceiver;
+//# sourceMappingURL=push-receiver.d.ts.map

package/dist/sync/push-receiver.d.ts.map

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