@atproto/tap 0.0.0-spaces-alpha-20260818163953

package/dist/channel.d.ts

@@ -0,0 +1,57 @@
+import { type HeadersInit } from '@atproto/ws-client';
+import { type TapEvent } from './types.js';
+export interface HandlerOpts {
+    signal: AbortSignal;
+    ack: () => Promise<void>;
+}
+export interface TapHandler {
+    onEvent: (evt: TapEvent, opts: HandlerOpts) => void | Promise<void>;
+    onError: (err: Error) => void;
+}
+export type TapWebsocketOptions = {
+    adminPassword?: string;
+    maxReconnectSeconds?: number;
+    heartbeatIntervalMs?: number;
+    /** Applied to the connection's upgrade request (Node.js only). */
+    headers?: HeadersInit;
+    onReconnectError?: (error: unknown, n: number, initialSetup: boolean) => void;
+};
+export declare class TapChannel implements AsyncDisposable {
+    private ws;
+    private handler;
+    private readonly abortController;
+    private readonly destroyDefer;
+    /** The current connection's sender, or undefined between connections. */
+    private sender?;
+    /**
+     * Acks accepted while there was no connection to send them on, flushed by the
+     * `onConnect` hook below.
+     *
+     * Not a list of promises the caller awaits, deliberately: a handler runs inside
+     * the iteration, and the reconnect that would flush it only happens when the
+     * iteration advances — so awaiting delivery from a handler would block the very
+     * pull that makes delivery possible. Acks are recorded and the handler
+     * continues; Tap redelivers anything it never sees acked.
+     */
+    private readonly pendingAcks;
+    constructor(url: string, handler: TapHandler, wsOpts?: TapWebsocketOptions);
+    /**
+     * Records an ack for delivery. Resolves once the ack has been sent, or accepted
+     * for the next connection — not once the peer has processed it.
+     *
+     * It can't mean more than that: a handler runs inside the iteration, and a
+     * reconnect only happens when the iteration advances, so awaiting confirmed
+     * delivery here would block the pull delivery depends on. Tap's own
+     * at-least-once redelivery covers an ack lost with its connection.
+     *
+     * Acks are per-event, idempotent, and order-insensitive server-side (see
+     * Outbox.AckEvent), so a duplicate or out-of-order ack is harmless.
+     */
+    ackEvent(id: number): Promise<void>;
+    private flushPendingAcks;
+    start(): Promise<void>;
+    private processWsEvent;
+    destroy(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,WAAW,EAOjB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,KAAK,QAAQ,EAAiB,MAAM,YAAY,CAAA;AAsBzD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAA;IACnB,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnE,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;CAC9B;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,kEAAkE;IAClE,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,KAAK,IAAI,CAAA;CAC9E,CAAA;AAMD,qBAAa,UAAW,YAAW,eAAe;IAChD,OAAO,CAAC,EAAE,CAA2B;IACrC,OAAO,CAAC,OAAO,CAAY;IAE3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyC;IACzE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAE9D,yEAAyE;IACzE,OAAO,CAAC,MAAM,CAAC,CAAgB;IAC/B;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAEhD,YACE,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,UAAU,EACnB,MAAM,GAAE,mBAAwB,EAiCjC;IAED;;;;;;;;;;;OAWG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAaxC;YAIa,gBAAgB;IAiBxB,KAAK,kBAoBV;YAEa,cAAc;IA6BtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAG7B;IAEK,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3C;CACF"}

package/dist/channel.js

@@ -0,0 +1,175 @@
+import { createDeferrable } from '@atproto/common';
+import { lexParse } from '@atproto/lex';
+import { CloseCode, CloseError, HeartbeatTimeoutError, IdleTimeoutError, SocketError, websocket, } from '@atproto/ws-client';
+import { parseTapEvent } from './types.js';
+import { formatAdminAuthHeader, isCausedBySignal } from './util.js';
+// Matches the classification the legacy errno-matching client had: reconnect only
+// on a genuine transport failure or an abnormal close (1006). Any other close
+// code, including the synthetic 1005 a bare socket.close() produces, ends the
+// session as before.
+function shouldReconnect(error) {
+    if (error instanceof CloseError) {
+        return error.code === CloseCode.Abnormal;
+    }
+    if (error instanceof SocketError ||
+        error instanceof HeartbeatTimeoutError ||
+        error instanceof IdleTimeoutError) {
+        // Defer to each error's own answer so this can't drift from the taxonomy.
+        return error.shouldRetry();
+    }
+    return false;
+}
+function ackMessage(id) {
+    return JSON.stringify({ type: 'ack', id });
+}
+export class TapChannel {
+    constructor(url, handler, wsOpts = {}) {
+        this.abortController = new AbortController();
+        this.destroyDefer = createDeferrable();
+        /**
+         * Acks accepted while there was no connection to send them on, flushed by the
+         * `onConnect` hook below.
+         *
+         * Not a list of promises the caller awaits, deliberately: a handler runs inside
+         * the iteration, and the reconnect that would flush it only happens when the
+         * iteration advances — so awaiting delivery from a handler would block the very
+         * pull that makes delivery possible. Acks are recorded and the handler
+         * continues; Tap redelivers anything it never sees acked.
+         */
+        this.pendingAcks = new Set();
+        this.handler = handler;
+        const { adminPassword, onReconnectError } = wsOpts;
+        const headers = new Headers(wsOpts.headers);
+        if (adminPassword) {
+            headers.set('Authorization', formatAdminAuthHeader(adminPassword));
+        }
+        this.ws = websocket(url, {
+            dataMode: 'text',
+            headers,
+            maxReconnectSeconds: wsOpts.maxReconnectSeconds,
+            // `{}` means "on at the default interval"; see Subscription.
+            heartbeat: wsOpts.heartbeatIntervalMs
+                ? { intervalMs: wsOpts.heartbeatIntervalMs }
+                : {},
+            signal: this.abortController.signal,
+            shouldReconnect,
+            // Fires for every connection, the first included, so an ack recorded before
+            // anything ever connected is flushed by whichever connection comes up.
+            onConnect: (sender) => {
+                this.sender = sender;
+                void this.flushPendingAcks();
+            },
+            onDisconnect: () => {
+                this.sender = undefined;
+            },
+            // Only retries are reported here; a fatal error reaches `start()` as the
+            // iterator's rejection instead.
+            onReconnect: (error, { attempt }) => {
+                onReconnectError?.(error, attempt, attempt === 0);
+            },
+        });
+    }
+    /**
+     * Records an ack for delivery. Resolves once the ack has been sent, or accepted
+     * for the next connection — not once the peer has processed it.
+     *
+     * It can't mean more than that: a handler runs inside the iteration, and a
+     * reconnect only happens when the iteration advances, so awaiting confirmed
+     * delivery here would block the pull delivery depends on. Tap's own
+     * at-least-once redelivery covers an ack lost with its connection.
+     *
+     * Acks are per-event, idempotent, and order-insensitive server-side (see
+     * Outbox.AckEvent), so a duplicate or out-of-order ack is harmless.
+     */
+    async ackEvent(id) {
+        const sender = this.sender;
+        if (!sender) {
+            this.pendingAcks.add(id);
+            return;
+        }
+        try {
+            await sender.send(ackMessage(id));
+        }
+        catch {
+            // The connection died under us: hand the ack to the next one rather than
+            // reporting a failure the caller can do nothing about.
+            this.pendingAcks.add(id);
+        }
+    }
+    // Driven by `onConnect`, never by a handler: it runs off the socket's own event,
+    // so it doesn't depend on the iteration making progress.
+    async flushPendingAcks() {
+        const sender = this.sender;
+        if (!sender)
+            return;
+        for (const id of [...this.pendingAcks]) {
+            try {
+                await sender.send(ackMessage(id));
+                this.pendingAcks.delete(id);
+            }
+            catch (cause) {
+                // Still unsendable; leave it queued for the connection after this one.
+                this.handler.onError(new Error(`failed to send ack for event ${id}`, { cause }));
+                return;
+            }
+        }
+    }
+    async start() {
+        this.abortController.signal.throwIfAborted();
+        try {
+            for await (const chunk of this.ws) {
+                await this.processWsEvent(chunk);
+            }
+        }
+        catch (err) {
+            // A CloseError only reaches here once `shouldReconnect` has declined to
+            // retry — i.e. the peer ended the session with an ordinary close frame.
+            // That's an expected end, matching the previous client's behavior of
+            // ending silently on any non-abnormal close.
+            if (!isCausedBySignal(err, this.abortController.signal) &&
+                !(err instanceof CloseError)) {
+                throw err;
+            }
+        }
+        finally {
+            this.destroyDefer.resolve();
+        }
+    }
+    async processWsEvent(chunk) {
+        let evt;
+        try {
+            const data = lexParse(chunk, {
+                // Reject invalid CIDs and blobs
+                strict: true,
+            });
+            evt = parseTapEvent(data);
+        }
+        catch (cause) {
+            const error = new Error(`Failed to parse message`, { cause });
+            this.handler.onError(error);
+            return;
+        }
+        try {
+            await this.handler.onEvent(evt, {
+                signal: this.abortController.signal,
+                ack: async () => {
+                    await this.ackEvent(evt.id);
+                },
+            });
+        }
+        catch (cause) {
+            // Don't ack on error - let Tap retry
+            const error = new Error(`Failed to process event ${evt.id}`, { cause });
+            this.handler.onError(error);
+            return;
+        }
+    }
+    async destroy() {
+        this.abortController.abort();
+        await this.destroyDefer.complete;
+    }
+    async [Symbol.asyncDispose]() {
+        await this.destroy();
+    }
+}
+//# sourceMappingURL=channel.js.map

package/dist/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Deferrable, createDeferrable } from '@atproto/common'\nimport { lexParse } from '@atproto/lex'\nimport {\n  CloseCode,\n  CloseError,\n  type HeadersInit,\n  HeartbeatTimeoutError,\n  IdleTimeoutError,\n  type Sender,\n  SocketError,\n  type WebSocketIterable,\n  websocket,\n} from '@atproto/ws-client'\nimport { type TapEvent, parseTapEvent } from './types.js'\nimport { formatAdminAuthHeader, isCausedBySignal } from './util.js'\n\n// Matches the classification the legacy errno-matching client had: reconnect only\n// on a genuine transport failure or an abnormal close (1006). Any other close\n// code, including the synthetic 1005 a bare socket.close() produces, ends the\n// session as before.\nfunction shouldReconnect(error: unknown): boolean {\n  if (error instanceof CloseError) {\n    return error.code === CloseCode.Abnormal\n  }\n  if (\n    error instanceof SocketError ||\n    error instanceof HeartbeatTimeoutError ||\n    error instanceof IdleTimeoutError\n  ) {\n    // Defer to each error's own answer so this can't drift from the taxonomy.\n    return error.shouldRetry()\n  }\n  return false\n}\n\nexport interface HandlerOpts {\n  signal: AbortSignal\n  ack: () => Promise<void>\n}\n\nexport interface TapHandler {\n  onEvent: (evt: TapEvent, opts: HandlerOpts) => void | Promise<void>\n  onError: (err: Error) => void\n}\n\nexport type TapWebsocketOptions = {\n  adminPassword?: string\n  maxReconnectSeconds?: number\n  heartbeatIntervalMs?: number\n  /** Applied to the connection's upgrade request (Node.js only). */\n  headers?: HeadersInit\n  onReconnectError?: (error: unknown, n: number, initialSetup: boolean) => void\n}\n\nfunction ackMessage(id: number): string {\n  return JSON.stringify({ type: 'ack', id })\n}\n\nexport class TapChannel implements AsyncDisposable {\n  private ws: WebSocketIterable<'text'>\n  private handler: TapHandler\n\n  private readonly abortController: AbortController = new AbortController()\n  private readonly destroyDefer: Deferrable = createDeferrable()\n\n  /** The current connection's sender, or undefined between connections. */\n  private sender?: Sender<'text'>\n  /**\n   * Acks accepted while there was no connection to send them on, flushed by the\n   * `onConnect` hook below.\n   *\n   * Not a list of promises the caller awaits, deliberately: a handler runs inside\n   * the iteration, and the reconnect that would flush it only happens when the\n   * iteration advances — so awaiting delivery from a handler would block the very\n   * pull that makes delivery possible. Acks are recorded and the handler\n   * continues; Tap redelivers anything it never sees acked.\n   */\n  private readonly pendingAcks = new Set<number>()\n\n  constructor(\n    url: string,\n    handler: TapHandler,\n    wsOpts: TapWebsocketOptions = {},\n  ) {\n    this.handler = handler\n    const { adminPassword, onReconnectError } = wsOpts\n    const headers = new Headers(wsOpts.headers)\n    if (adminPassword) {\n      headers.set('Authorization', formatAdminAuthHeader(adminPassword))\n    }\n    this.ws = websocket(url, {\n      dataMode: 'text',\n      headers,\n      maxReconnectSeconds: wsOpts.maxReconnectSeconds,\n      // `{}` means \"on at the default interval\"; see Subscription.\n      heartbeat: wsOpts.heartbeatIntervalMs\n        ? { intervalMs: wsOpts.heartbeatIntervalMs }\n        : {},\n      signal: this.abortController.signal,\n      shouldReconnect,\n      // Fires for every connection, the first included, so an ack recorded before\n      // anything ever connected is flushed by whichever connection comes up.\n      onConnect: (sender) => {\n        this.sender = sender\n        void this.flushPendingAcks()\n      },\n      onDisconnect: () => {\n        this.sender = undefined\n      },\n      // Only retries are reported here; a fatal error reaches `start()` as the\n      // iterator's rejection instead.\n      onReconnect: (error, { attempt }) => {\n        onReconnectError?.(error, attempt, attempt === 0)\n      },\n    })\n  }\n\n  /**\n   * Records an ack for delivery. Resolves once the ack has been sent, or accepted\n   * for the next connection — not once the peer has processed it.\n   *\n   * It can't mean more than that: a handler runs inside the iteration, and a\n   * reconnect only happens when the iteration advances, so awaiting confirmed\n   * delivery here would block the pull delivery depends on. Tap's own\n   * at-least-once redelivery covers an ack lost with its connection.\n   *\n   * Acks are per-event, idempotent, and order-insensitive server-side (see\n   * Outbox.AckEvent), so a duplicate or out-of-order ack is harmless.\n   */\n  async ackEvent(id: number): Promise<void> {\n    const sender = this.sender\n    if (!sender) {\n      this.pendingAcks.add(id)\n      return\n    }\n    try {\n      await sender.send(ackMessage(id))\n    } catch {\n      // The connection died under us: hand the ack to the next one rather than\n      // reporting a failure the caller can do nothing about.\n      this.pendingAcks.add(id)\n    }\n  }\n\n  // Driven by `onConnect`, never by a handler: it runs off the socket's own event,\n  // so it doesn't depend on the iteration making progress.\n  private async flushPendingAcks(): Promise<void> {\n    const sender = this.sender\n    if (!sender) return\n    for (const id of [...this.pendingAcks]) {\n      try {\n        await sender.send(ackMessage(id))\n        this.pendingAcks.delete(id)\n      } catch (cause) {\n        // Still unsendable; leave it queued for the connection after this one.\n        this.handler.onError(\n          new Error(`failed to send ack for event ${id}`, { cause }),\n        )\n        return\n      }\n    }\n  }\n\n  async start() {\n    this.abortController.signal.throwIfAborted()\n    try {\n      for await (const chunk of this.ws) {\n        await this.processWsEvent(chunk)\n      }\n    } catch (err) {\n      // A CloseError only reaches here once `shouldReconnect` has declined to\n      // retry — i.e. the peer ended the session with an ordinary close frame.\n      // That's an expected end, matching the previous client's behavior of\n      // ending silently on any non-abnormal close.\n      if (\n        !isCausedBySignal(err, this.abortController.signal) &&\n        !(err instanceof CloseError)\n      ) {\n        throw err\n      }\n    } finally {\n      this.destroyDefer.resolve()\n    }\n  }\n\n  private async processWsEvent(chunk: string) {\n    let evt: TapEvent\n    try {\n      const data = lexParse(chunk, {\n        // Reject invalid CIDs and blobs\n        strict: true,\n      })\n      evt = parseTapEvent(data)\n    } catch (cause) {\n      const error = new Error(`Failed to parse message`, { cause })\n      this.handler.onError(error)\n      return\n    }\n\n    try {\n      await this.handler.onEvent(evt, {\n        signal: this.abortController.signal,\n        ack: async () => {\n          await this.ackEvent(evt.id)\n        },\n      })\n    } catch (cause) {\n      // Don't ack on error - let Tap retry\n      const error = new Error(`Failed to process event ${evt.id}`, { cause })\n      this.handler.onError(error)\n      return\n    }\n  }\n\n  async destroy(): Promise<void> {\n    this.abortController.abort()\n    await this.destroyDefer.complete\n  }\n\n  async [Symbol.asyncDispose](): Promise<void> {\n    await this.destroy()\n  }\n}\n"]}

package/dist/client.d.ts

@@ -0,0 +1,21 @@
+import { type DidDocument } from '@atproto/common';
+import { TapChannel, type TapHandler, type TapWebsocketOptions } from './channel.js';
+import { type RepoInfo } from './types.js';
+export interface TapConfig {
+    adminPassword?: string;
+}
+export declare class Tap {
+    url: string;
+    private adminPassword?;
+    private authHeader?;
+    private addReposUrl;
+    private removeReposUrl;
+    constructor(url: string, config?: TapConfig);
+    private getHeaders;
+    channel(handler: TapHandler, opts?: TapWebsocketOptions): TapChannel;
+    addRepos(dids: string[]): Promise<void>;
+    removeRepos(dids: string[]): Promise<void>;
+    resolveDid(did: string): Promise<DidDocument | null>;
+    getRepoInfo(did: string): Promise<RepoInfo>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,iBAAiB,CAAA;AAC/D,OAAO,EACL,UAAU,EACV,KAAK,UAAU,EACf,KAAK,mBAAmB,EACzB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,KAAK,QAAQ,EAAkB,MAAM,YAAY,CAAA;AAG1D,MAAM,WAAW,SAAS;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,qBAAa,GAAG;IACd,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,aAAa,CAAC,CAAQ;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAQ;IAE3B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,cAAc,CAAK;IAE3B,YAAY,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,SAAc,EAY9C;IAED,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,UAAU,CAQnE;IAEK,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5C;IAEK,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/C;IAEK,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAazD;IAEK,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAYhD;CACF"}

package/dist/client.js

@@ -0,0 +1,84 @@
+import { didDocument } from '@atproto/common';
+import { TapChannel, } from './channel.js';
+import { repoInfoSchema } from './types.js';
+import { formatAdminAuthHeader } from './util.js';
+export class Tap {
+    constructor(url, config = {}) {
+        if (!url.startsWith('http://') && !url.startsWith('https://')) {
+            throw new Error('Invalid URL, expected http:// or https://');
+        }
+        this.url = url;
+        this.adminPassword = config.adminPassword;
+        if (this.adminPassword) {
+            this.authHeader = formatAdminAuthHeader(this.adminPassword);
+        }
+        this.addReposUrl = new URL('/repos/add', this.url);
+        this.removeReposUrl = new URL('/repos/remove', this.url);
+    }
+    getHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (this.authHeader) {
+            headers['Authorization'] = this.authHeader;
+        }
+        return headers;
+    }
+    channel(handler, opts) {
+        const url = new URL(this.url);
+        url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
+        url.pathname = '/channel';
+        return new TapChannel(url.toString(), handler, {
+            adminPassword: this.adminPassword,
+            ...opts,
+        });
+    }
+    async addRepos(dids) {
+        const response = await fetch(this.addReposUrl, {
+            method: 'POST',
+            headers: this.getHeaders(),
+            body: JSON.stringify({ dids }),
+        });
+        await response.body?.cancel(); // expect empty body
+        if (!response.ok) {
+            throw new Error(`Failed to add repos: ${response.statusText}`);
+        }
+    }
+    async removeRepos(dids) {
+        const response = await fetch(this.removeReposUrl, {
+            method: 'POST',
+            headers: this.getHeaders(),
+            body: JSON.stringify({ dids }),
+        });
+        await response.body?.cancel(); // expect empty body
+        if (!response.ok) {
+            throw new Error(`Failed to remove repos: ${response.statusText}`);
+        }
+    }
+    async resolveDid(did) {
+        const response = await fetch(new URL(`/resolve/${did}`, this.url), {
+            method: 'GET',
+            headers: this.getHeaders(),
+        });
+        if (response.status === 404) {
+            return null;
+        }
+        else if (!response.ok) {
+            await response.body?.cancel();
+            throw new Error(`Failed to resolve DID: ${response.statusText}`);
+        }
+        return didDocument.parse(await response.json());
+    }
+    async getRepoInfo(did) {
+        const response = await fetch(new URL(`/info/${did}`, this.url), {
+            method: 'GET',
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            await response.body?.cancel();
+            throw new Error(`Failed to get repo info: ${response.statusText}`);
+        }
+        return repoInfoSchema.parse(await response.json());
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { type DidDocument, didDocument } from '@atproto/common'\nimport {\n  TapChannel,\n  type TapHandler,\n  type TapWebsocketOptions,\n} from './channel.js'\nimport { type RepoInfo, repoInfoSchema } from './types.js'\nimport { formatAdminAuthHeader } from './util.js'\n\nexport interface TapConfig {\n  adminPassword?: string\n}\n\nexport class Tap {\n  url: string\n  private adminPassword?: string\n  private authHeader?: string\n\n  private addReposUrl: URL\n  private removeReposUrl: URL\n\n  constructor(url: string, config: TapConfig = {}) {\n    if (!url.startsWith('http://') && !url.startsWith('https://')) {\n      throw new Error('Invalid URL, expected http:// or https://')\n    }\n    this.url = url\n    this.adminPassword = config.adminPassword\n    if (this.adminPassword) {\n      this.authHeader = formatAdminAuthHeader(this.adminPassword)\n    }\n\n    this.addReposUrl = new URL('/repos/add', this.url)\n    this.removeReposUrl = new URL('/repos/remove', this.url)\n  }\n\n  private getHeaders(): Record<string, string> {\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n    }\n    if (this.authHeader) {\n      headers['Authorization'] = this.authHeader\n    }\n    return headers\n  }\n\n  channel(handler: TapHandler, opts?: TapWebsocketOptions): TapChannel {\n    const url = new URL(this.url)\n    url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:'\n    url.pathname = '/channel'\n    return new TapChannel(url.toString(), handler, {\n      adminPassword: this.adminPassword,\n      ...opts,\n    })\n  }\n\n  async addRepos(dids: string[]): Promise<void> {\n    const response = await fetch(this.addReposUrl, {\n      method: 'POST',\n      headers: this.getHeaders(),\n      body: JSON.stringify({ dids }),\n    })\n    await response.body?.cancel() // expect empty body\n\n    if (!response.ok) {\n      throw new Error(`Failed to add repos: ${response.statusText}`)\n    }\n  }\n\n  async removeRepos(dids: string[]): Promise<void> {\n    const response = await fetch(this.removeReposUrl, {\n      method: 'POST',\n      headers: this.getHeaders(),\n      body: JSON.stringify({ dids }),\n    })\n    await response.body?.cancel() // expect empty body\n\n    if (!response.ok) {\n      throw new Error(`Failed to remove repos: ${response.statusText}`)\n    }\n  }\n\n  async resolveDid(did: string): Promise<DidDocument | null> {\n    const response = await fetch(new URL(`/resolve/${did}`, this.url), {\n      method: 'GET',\n      headers: this.getHeaders(),\n    })\n\n    if (response.status === 404) {\n      return null\n    } else if (!response.ok) {\n      await response.body?.cancel()\n      throw new Error(`Failed to resolve DID: ${response.statusText}`)\n    }\n    return didDocument.parse(await response.json())\n  }\n\n  async getRepoInfo(did: string): Promise<RepoInfo> {\n    const response = await fetch(new URL(`/info/${did}`, this.url), {\n      method: 'GET',\n      headers: this.getHeaders(),\n    })\n\n    if (!response.ok) {\n      await response.body?.cancel()\n      throw new Error(`Failed to get repo info: ${response.statusText}`)\n    }\n\n    return repoInfoSchema.parse(await response.json())\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './client.js';
+export * from './channel.js';
+export * from './simple-indexer.js';
+export * from './lex-indexer.js';
+export * from './util.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './client.js';
+export * from './channel.js';
+export * from './simple-indexer.js';
+export * from './lex-indexer.js';
+export * from './util.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA","sourcesContent":["export * from './types.js'\nexport * from './client.js'\nexport * from './channel.js'\nexport * from './simple-indexer.js'\nexport * from './lex-indexer.js'\nexport * from './util.js'\n"]}

package/dist/lex-indexer.d.ts

@@ -0,0 +1,46 @@
+import { type Infer, type Main, type RecordSchema } from '@atproto/lex';
+import type { HandlerOpts, TapHandler } from './channel.js';
+import type { IdentityEvent, RecordEvent, TapEvent } from './types.js';
+type BaseRecordEvent = Omit<RecordEvent, 'record' | 'action' | 'cid'>;
+export type CreateEvent<R> = BaseRecordEvent & {
+    action: 'create';
+    record: R;
+    cid: string;
+};
+export type UpdateEvent<R> = BaseRecordEvent & {
+    action: 'update';
+    record: R;
+    cid: string;
+};
+export type PutEvent<R> = CreateEvent<R> | UpdateEvent<R>;
+export type DeleteEvent = BaseRecordEvent & {
+    action: 'delete';
+};
+export type CreateHandler<R> = (evt: CreateEvent<R>, opts: HandlerOpts) => Promise<void>;
+export type UpdateHandler<R> = (evt: UpdateEvent<R>, opts: HandlerOpts) => Promise<void>;
+export type PutHandler<R> = (evt: PutEvent<R>, opts: HandlerOpts) => Promise<void>;
+export type DeleteHandler = (evt: DeleteEvent, opts: HandlerOpts) => Promise<void>;
+export type UntypedHandler = (evt: RecordEvent, opts: HandlerOpts) => Promise<void>;
+export type IdentityHandler = (evt: IdentityEvent, opts: HandlerOpts) => Promise<void>;
+export type ErrorHandler = (err: Error) => void;
+export type RecordHandler<R> = CreateHandler<R> | UpdateHandler<R> | PutHandler<R> | DeleteHandler;
+export declare class LexIndexer implements TapHandler {
+    private handlers;
+    private otherHandler;
+    private identityHandler;
+    private errorHandler;
+    private handlerKey;
+    private register;
+    create<const T extends RecordSchema>(ns: Main<T>, handler: CreateHandler<Infer<T>>): this;
+    update<const T extends RecordSchema>(ns: Main<T>, handler: UpdateHandler<Infer<T>>): this;
+    delete<const T extends RecordSchema>(ns: Main<T>, handler: DeleteHandler): this;
+    put<const T extends RecordSchema>(ns: Main<T>, handler: PutHandler<Infer<T>>): this;
+    other(fn: UntypedHandler): this;
+    identity(fn: IdentityHandler): this;
+    error(fn: ErrorHandler): this;
+    onEvent(evt: TapEvent, opts: HandlerOpts): Promise<void>;
+    private handleRecordEvent;
+    onError(err: Error): void;
+}
+export {};
+//# sourceMappingURL=lex-indexer.d.ts.map

package/dist/lex-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lex-indexer.d.ts","sourceRoot":"","sources":["../src/lex-indexer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,IAAI,EAAE,KAAK,YAAY,EAAW,MAAM,cAAc,CAAA;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEtE,KAAK,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC,CAAA;AAErE,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,eAAe,GAAG;IAC7C,MAAM,EAAE,QAAQ,CAAA;IAChB,MAAM,EAAE,CAAC,CAAA;IACT,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,eAAe,GAAG;IAC7C,MAAM,EAAE,QAAQ,CAAA;IAChB,MAAM,EAAE,CAAC,CAAA;IACT,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;AAEzD,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG;IAC1C,MAAM,EAAE,QAAQ,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAC7B,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EACnB,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,IAAI,CAAC,CAAA;AAElB,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAC7B,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EACnB,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,IAAI,CAAC,CAAA;AAElB,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAC1B,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,EAChB,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,IAAI,CAAC,CAAA;AAElB,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,IAAI,CAAC,CAAA;AAElB,MAAM,MAAM,cAAc,GAAG,CAC3B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,IAAI,CAAC,CAAA;AAElB,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,IAAI,CAAC,CAAA;AAElB,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;AAE/C,MAAM,MAAM,aAAa,CAAC,CAAC,IACzB,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,aAAa,CAAA;AAOrE,qBAAa,UAAW,YAAW,UAAU;IAC3C,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,YAAY,CAA0B;IAE9C,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,QAAQ;IAchB,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EACjC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAC/B,IAAI,CAEN;IAED,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EACjC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAC/B,IAAI,CAEN;IAED,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EACjC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,OAAO,EAAE,aAAa,GACrB,IAAI,CAEN;IAED,GAAG,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAC9B,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAC5B,IAAI,CAIN;IAED,KAAK,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAM9B;IAED,QAAQ,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI,CAMlC;IAED,KAAK,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAM5B;IAEK,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAO7D;YAEa,iBAAiB;IA0B/B,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAMxB;CACF"}

package/dist/lex-indexer.js

@@ -0,0 +1,90 @@
+import { getMain } from '@atproto/lex';
+export class LexIndexer {
+    constructor() {
+        this.handlers = new Map();
+    }
+    handlerKey(collection, action) {
+        return `${collection}:${action}`;
+    }
+    register(action, ns, handler) {
+        const schema = getMain(ns);
+        const key = this.handlerKey(schema.$type, action);
+        if (this.handlers.has(key)) {
+            throw new Error(`Handler already registered for ${key}`);
+        }
+        this.handlers.set(key, { schema, handler });
+        return this;
+    }
+    create(ns, handler) {
+        return this.register('create', ns, handler);
+    }
+    update(ns, handler) {
+        return this.register('update', ns, handler);
+    }
+    delete(ns, handler) {
+        return this.register('delete', ns, handler);
+    }
+    put(ns, handler) {
+        this.register('create', ns, handler);
+        this.register('update', ns, handler);
+        return this;
+    }
+    other(fn) {
+        if (this.otherHandler) {
+            throw new Error(`Handler already registered for "other"`);
+        }
+        this.otherHandler = fn;
+        return this;
+    }
+    identity(fn) {
+        if (this.identityHandler) {
+            throw new Error(`Handler already registered for "identity"`);
+        }
+        this.identityHandler = fn;
+        return this;
+    }
+    error(fn) {
+        if (this.errorHandler) {
+            throw new Error(`Handler already registered for "error"`);
+        }
+        this.errorHandler = fn;
+        return this;
+    }
+    async onEvent(evt, opts) {
+        if (evt.type === 'identity') {
+            await this.identityHandler?.(evt, opts);
+        }
+        else {
+            await this.handleRecordEvent(evt, opts);
+        }
+        await opts.ack();
+    }
+    async handleRecordEvent(evt, opts) {
+        const { collection, action } = evt;
+        const key = this.handlerKey(collection, action);
+        const registered = this.handlers.get(key);
+        if (!registered) {
+            await this.otherHandler?.(evt, opts);
+            return;
+        }
+        if (action === 'create' || action === 'update') {
+            const match = registered.schema.safeValidate(evt.record);
+            if (!match.success) {
+                const uriStr = `at://${evt.did}/${evt.collection}/${evt.rkey}`;
+                throw new Error(`Record validation failed for ${uriStr}`, {
+                    cause: match.reason,
+                });
+            }
+        }
+        await registered.handler(evt, opts);
+    }
+    onError(err) {
+        if (this.errorHandler) {
+            this.errorHandler(err);
+        }
+        else {
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=lex-indexer.js.map

package/dist/lex-indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lex-indexer.js","sourceRoot":"","sources":["../src/lex-indexer.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Infer, type Main, type RecordSchema, getMain } from '@atproto/lex'\nimport type { AtUriString, NsidString } from '@atproto/syntax'\nimport type { HandlerOpts, TapHandler } from './channel.js'\nimport type { IdentityEvent, RecordEvent, TapEvent } from './types.js'\n\ntype BaseRecordEvent = Omit<RecordEvent, 'record' | 'action' | 'cid'>\n\nexport type CreateEvent<R> = BaseRecordEvent & {\n  action: 'create'\n  record: R\n  cid: string\n}\n\nexport type UpdateEvent<R> = BaseRecordEvent & {\n  action: 'update'\n  record: R\n  cid: string\n}\n\nexport type PutEvent<R> = CreateEvent<R> | UpdateEvent<R>\n\nexport type DeleteEvent = BaseRecordEvent & {\n  action: 'delete'\n}\n\nexport type CreateHandler<R> = (\n  evt: CreateEvent<R>,\n  opts: HandlerOpts,\n) => Promise<void>\n\nexport type UpdateHandler<R> = (\n  evt: UpdateEvent<R>,\n  opts: HandlerOpts,\n) => Promise<void>\n\nexport type PutHandler<R> = (\n  evt: PutEvent<R>,\n  opts: HandlerOpts,\n) => Promise<void>\n\nexport type DeleteHandler = (\n  evt: DeleteEvent,\n  opts: HandlerOpts,\n) => Promise<void>\n\nexport type UntypedHandler = (\n  evt: RecordEvent,\n  opts: HandlerOpts,\n) => Promise<void>\n\nexport type IdentityHandler = (\n  evt: IdentityEvent,\n  opts: HandlerOpts,\n) => Promise<void>\n\nexport type ErrorHandler = (err: Error) => void\n\nexport type RecordHandler<R> =\n  CreateHandler<R> | UpdateHandler<R> | PutHandler<R> | DeleteHandler\n\ninterface RegisteredHandler {\n  handler: RecordHandler<any>\n  schema: RecordSchema\n}\n\nexport class LexIndexer implements TapHandler {\n  private handlers = new Map<string, RegisteredHandler>()\n  private otherHandler: UntypedHandler | undefined\n  private identityHandler: IdentityHandler | undefined\n  private errorHandler: ErrorHandler | undefined\n\n  private handlerKey(\n    collection: NsidString,\n    action: RecordEvent['action'],\n  ): string {\n    return `${collection}:${action}`\n  }\n\n  private register<const T extends RecordSchema>(\n    action: RecordEvent['action'],\n    ns: Main<T>,\n    handler: RecordHandler<Infer<T>>,\n  ): this {\n    const schema = getMain(ns)\n    const key = this.handlerKey(schema.$type, action)\n    if (this.handlers.has(key)) {\n      throw new Error(`Handler already registered for ${key}`)\n    }\n    this.handlers.set(key, { schema, handler })\n    return this\n  }\n\n  create<const T extends RecordSchema>(\n    ns: Main<T>,\n    handler: CreateHandler<Infer<T>>,\n  ): this {\n    return this.register('create', ns, handler)\n  }\n\n  update<const T extends RecordSchema>(\n    ns: Main<T>,\n    handler: UpdateHandler<Infer<T>>,\n  ): this {\n    return this.register('update', ns, handler)\n  }\n\n  delete<const T extends RecordSchema>(\n    ns: Main<T>,\n    handler: DeleteHandler,\n  ): this {\n    return this.register('delete', ns, handler)\n  }\n\n  put<const T extends RecordSchema>(\n    ns: Main<T>,\n    handler: PutHandler<Infer<T>>,\n  ): this {\n    this.register('create', ns, handler)\n    this.register('update', ns, handler)\n    return this\n  }\n\n  other(fn: UntypedHandler): this {\n    if (this.otherHandler) {\n      throw new Error(`Handler already registered for \"other\"`)\n    }\n    this.otherHandler = fn\n    return this\n  }\n\n  identity(fn: IdentityHandler): this {\n    if (this.identityHandler) {\n      throw new Error(`Handler already registered for \"identity\"`)\n    }\n    this.identityHandler = fn\n    return this\n  }\n\n  error(fn: ErrorHandler): this {\n    if (this.errorHandler) {\n      throw new Error(`Handler already registered for \"error\"`)\n    }\n    this.errorHandler = fn\n    return this\n  }\n\n  async onEvent(evt: TapEvent, opts: HandlerOpts): Promise<void> {\n    if (evt.type === 'identity') {\n      await this.identityHandler?.(evt, opts)\n    } else {\n      await this.handleRecordEvent(evt, opts)\n    }\n    await opts.ack()\n  }\n\n  private async handleRecordEvent(\n    evt: RecordEvent,\n    opts: HandlerOpts,\n  ): Promise<void> {\n    const { collection, action } = evt\n    const key = this.handlerKey(collection, action)\n    const registered = this.handlers.get(key)\n\n    if (!registered) {\n      await this.otherHandler?.(evt, opts)\n      return\n    }\n\n    if (action === 'create' || action === 'update') {\n      const match = registered.schema.safeValidate(evt.record)\n      if (!match.success) {\n        const uriStr: AtUriString = `at://${evt.did}/${evt.collection}/${evt.rkey}`\n        throw new Error(`Record validation failed for ${uriStr}`, {\n          cause: match.reason,\n        })\n      }\n    }\n\n    await (registered.handler as UntypedHandler)(evt, opts)\n  }\n\n  onError(err: Error): void {\n    if (this.errorHandler) {\n      this.errorHandler(err)\n    } else {\n      throw err\n    }\n  }\n}\n"]}

package/dist/simple-indexer.d.ts

@@ -0,0 +1,17 @@
+import type { HandlerOpts, TapHandler } from './channel.js';
+import type { IdentityEvent, RecordEvent, TapEvent } from './types.js';
+type IdentityEventHandler = (evt: IdentityEvent, opts?: HandlerOpts) => Promise<void>;
+type RecordEventHandler = (evt: RecordEvent, opts?: HandlerOpts) => Promise<void>;
+type ErrorHandler = (err: Error) => void;
+export declare class SimpleIndexer implements TapHandler {
+    private identityHandler;
+    private recordHandler;
+    private errorHandler;
+    identity(fn: IdentityEventHandler): this;
+    record(fn: RecordEventHandler): this;
+    error(fn: ErrorHandler): this;
+    onEvent(evt: TapEvent, opts: HandlerOpts): Promise<void>;
+    onError(err: Error): void;
+}
+export {};
+//# sourceMappingURL=simple-indexer.d.ts.map

package/dist/simple-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-indexer.d.ts","sourceRoot":"","sources":["../src/simple-indexer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEtE,KAAK,oBAAoB,GAAG,CAC1B,GAAG,EAAE,aAAa,EAClB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,IAAI,CAAC,CAAA;AAElB,KAAK,kBAAkB,GAAG,CACxB,GAAG,EAAE,WAAW,EAChB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,IAAI,CAAC,CAAA;AAElB,KAAK,YAAY,GAAG,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;AAExC,qBAAa,aAAc,YAAW,UAAU;IAC9C,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,YAAY,CAA0B;IAE9C,QAAQ,CAAC,EAAE,EAAE,oBAAoB,GAAG,IAAI,CAGvC;IAED,MAAM,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI,CAGnC;IAED,KAAK,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAG5B;IAEK,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAO7D;IAED,OAAO,CAAC,GAAG,EAAE,KAAK,QAMjB;CACF"}

package/dist/simple-indexer.js

@@ -0,0 +1,32 @@
+export class SimpleIndexer {
+    identity(fn) {
+        this.identityHandler = fn;
+        return this;
+    }
+    record(fn) {
+        this.recordHandler = fn;
+        return this;
+    }
+    error(fn) {
+        this.errorHandler = fn;
+        return this;
+    }
+    async onEvent(evt, opts) {
+        if (evt.type === 'record') {
+            await this.recordHandler?.(evt, opts);
+        }
+        else {
+            await this.identityHandler?.(evt, opts);
+        }
+        await opts.ack();
+    }
+    onError(err) {
+        if (this.errorHandler) {
+            this.errorHandler(err);
+        }
+        else {
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=simple-indexer.js.map

package/dist/simple-indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-indexer.js","sourceRoot":"","sources":["../src/simple-indexer.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,aAAa;IAKxB,QAAQ,CAAC,EAAwB;QAC/B,IAAI,CAAC,eAAe,GAAG,EAAE,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,CAAC,EAAsB;QAC3B,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;QACvB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,EAAgB;QACpB,IAAI,CAAC,YAAY,GAAG,EAAE,CAAA;QACtB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAa,EAAE,IAAiB;QAC5C,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACvC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACzC,CAAC;QACD,MAAM,IAAI,CAAC,GAAG,EAAE,CAAA;IAClB,CAAC;IAED,OAAO,CAAC,GAAU;QAChB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;CACF","sourcesContent":["import type { HandlerOpts, TapHandler } from './channel.js'\nimport type { IdentityEvent, RecordEvent, TapEvent } from './types.js'\n\ntype IdentityEventHandler = (\n  evt: IdentityEvent,\n  opts?: HandlerOpts,\n) => Promise<void>\n\ntype RecordEventHandler = (\n  evt: RecordEvent,\n  opts?: HandlerOpts,\n) => Promise<void>\n\ntype ErrorHandler = (err: Error) => void\n\nexport class SimpleIndexer implements TapHandler {\n  private identityHandler: IdentityEventHandler | undefined\n  private recordHandler: RecordEventHandler | undefined\n  private errorHandler: ErrorHandler | undefined\n\n  identity(fn: IdentityEventHandler): this {\n    this.identityHandler = fn\n    return this\n  }\n\n  record(fn: RecordEventHandler): this {\n    this.recordHandler = fn\n    return this\n  }\n\n  error(fn: ErrorHandler): this {\n    this.errorHandler = fn\n    return this\n  }\n\n  async onEvent(evt: TapEvent, opts: HandlerOpts): Promise<void> {\n    if (evt.type === 'record') {\n      await this.recordHandler?.(evt, opts)\n    } else {\n      await this.identityHandler?.(evt, opts)\n    }\n    await opts.ack()\n  }\n\n  onError(err: Error) {\n    if (this.errorHandler) {\n      this.errorHandler(err)\n    } else {\n      throw err\n    }\n  }\n}\n"]}