@atproto/tap 0.0.0-spaces-alpha-20260818163953

package/CHANGELOG.md

@@ -0,0 +1,372 @@
+# @atproto/tap
+
+## 0.0.0-spaces-alpha-20260818163953
+
+### Patch Changes
+
+- Updated dependencies [[`2f77206`](https://github.com/bluesky-social/atproto/commit/2f77206ff8010710db5733c454abff9eb5ebb96b)]:
+  - @atproto/common@0.0.0-spaces-alpha-20260818163953
+  - @atproto/syntax@0.0.0-spaces-alpha-20260818163953
+  - @atproto/lex@0.0.0-spaces-alpha-20260818163953
+
+## 0.4.2
+
+### Patch Changes
+
+- Updated dependencies [[`b66870d`](https://github.com/bluesky-social/atproto/commit/b66870d5a1efbcfa0cc07498c7cfcf3f0f243e86), [`b66870d`](https://github.com/bluesky-social/atproto/commit/b66870d5a1efbcfa0cc07498c7cfcf3f0f243e86)]:
+  - @atproto/common@0.7.6
+  - @atproto/lex@0.3.5
+
+## 0.4.1
+
+### Patch Changes
+
+- Updated dependencies [[`8b55a4a`](https://github.com/bluesky-social/atproto/commit/8b55a4ab69c24e5038f67c479b3b9953666ea0c2)]:
+  - @atproto/syntax@0.7.4
+  - @atproto/lex@0.3.4
+  - @atproto/common@0.7.5
+
+## 0.4.0
+
+### Minor Changes
+
+- [#5285](https://github.com/bluesky-social/atproto/pull/5285) [`d12f6ac`](https://github.com/bluesky-social/atproto/commit/d12f6ac6e2cb2590446bf9f2051287bac058c092) Thanks [@devinivy](https://github.com/devinivy)! - **BREAKING:** `TapWebsocketOptions` now takes an explicit set of options rather than arbitrary `ws` `ClientOptions`, and adds a `headers` option for the upgrade request.
+
+  `ackEvent()` now resolves once the ack has been sent — or recorded for the next connection — rather than once it is confirmed delivered. Awaiting confirmed delivery from a handler could deadlock the channel (a bug that predates this change). Acks issued while disconnected are flushed when the next connection comes up, and Tap's at-least-once redelivery covers an ack lost with its connection.
+
+  `onReconnectError`'s `initialSetup` argument now means "first attempt of this reconnect cycle" rather than "before the first-ever successful connection".
+
+### Patch Changes
+
+- [#5295](https://github.com/bluesky-social/atproto/pull/5295) [`6a3d607`](https://github.com/bluesky-social/atproto/commit/6a3d6073cb66c527b5b109242049c85c36b9658c) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Update vitest dependencies
+
+- [#5301](https://github.com/bluesky-social/atproto/pull/5301) [`8c07338`](https://github.com/bluesky-social/atproto/commit/8c07338232aa69427aa65322a555f70e0211d6d7) Thanks [@43081j](https://github.com/43081j)! - Switch from destructured default imports to named imports of CommonJS dependencies.
+
+- Updated dependencies [[`6a3d607`](https://github.com/bluesky-social/atproto/commit/6a3d6073cb66c527b5b109242049c85c36b9658c), [`8c07338`](https://github.com/bluesky-social/atproto/commit/8c07338232aa69427aa65322a555f70e0211d6d7), [`d12f6ac`](https://github.com/bluesky-social/atproto/commit/d12f6ac6e2cb2590446bf9f2051287bac058c092)]:
+  - @atproto/lex@0.3.3
+  - @atproto/syntax@0.7.3
+  - @atproto/ws-client@0.2.0
+  - @atproto/common@0.7.4
+
+## 0.3.12
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atproto/lex@0.3.2
+  - @atproto/common@0.7.3
+  - @atproto/ws-client@0.1.8
+
+## 0.3.11
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atproto/lex@0.3.1
+
+## 0.3.10
+
+### Patch Changes
+
+- Updated dependencies [[`f8267c3`](https://github.com/bluesky-social/atproto/commit/f8267c3ada1645a2472c81c1ba95157466108b6e)]:
+  - @atproto/lex@0.3.0
+
+## 0.3.9
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atproto/lex@0.2.3
+
+## 0.3.8
+
+### Patch Changes
+
+- Updated dependencies [[`9e1da84`](https://github.com/bluesky-social/atproto/commit/9e1da84cc00a1cc5b453705539a2766403f3ee55)]:
+  - @atproto/syntax@0.7.2
+  - @atproto/lex@0.2.2
+  - @atproto/common@0.7.2
+  - @atproto/ws-client@0.1.7
+
+## 0.3.7
+
+### Patch Changes
+
+- [#5197](https://github.com/bluesky-social/atproto/pull/5197) [`a0c49d9`](https://github.com/bluesky-social/atproto/commit/a0c49d9e8bc685c5a747a8d3b2775c73c63fdb6f) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Rewrite import statements to be compatible with TypeScript's `verbatimModuleSyntax` config.
+
+- Updated dependencies [[`a0c49d9`](https://github.com/bluesky-social/atproto/commit/a0c49d9e8bc685c5a747a8d3b2775c73c63fdb6f)]:
+  - @atproto/ws-client@0.1.6
+  - @atproto/lex@0.2.1
+  - @atproto/common@0.7.1
+  - @atproto/syntax@0.7.1
+
+## 0.3.6
+
+### Patch Changes
+
+- Updated dependencies [[`d1be0ce`](https://github.com/bluesky-social/atproto/commit/d1be0cead444ef95e64cac5ea5318edbec9d8112), [`963b944`](https://github.com/bluesky-social/atproto/commit/963b9440190c7e59abc0c05de70ecea9cab6fe37), [`d1be0ce`](https://github.com/bluesky-social/atproto/commit/d1be0cead444ef95e64cac5ea5318edbec9d8112), [`d79f6d5`](https://github.com/bluesky-social/atproto/commit/d79f6d59a073c05cc37bd0d1482beeea482b67ed)]:
+  - @atproto/syntax@0.7.0
+  - @atproto/lex@0.2.0
+  - @atproto/common@0.7.0
+  - @atproto/ws-client@0.1.5
+
+## 0.3.5
+
+### Patch Changes
+
+- [#5099](https://github.com/bluesky-social/atproto/pull/5099) [`b43ec31`](https://github.com/bluesky-social/atproto/commit/b43ec31f247f4461725b01226885f88bd430ca07) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Update TypeScript build to rely on references to composite internal projects
+
+- [#5099](https://github.com/bluesky-social/atproto/pull/5099) [`b43ec31`](https://github.com/bluesky-social/atproto/commit/b43ec31f247f4461725b01226885f88bd430ca07) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Bundle only necessary files in the NPM tarball, including the `CHANGELOG.md` and `README.md` files (if present).
+
+- [#5099](https://github.com/bluesky-social/atproto/pull/5099) [`b43ec31`](https://github.com/bluesky-social/atproto/commit/b43ec31f247f4461725b01226885f88bd430ca07) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Build with `noImplicitAny` enabled
+
+- Updated dependencies [[`28a0b58`](https://github.com/bluesky-social/atproto/commit/28a0b588147863eaef948cd2bb8fc0f19d08cda9), [`b43ec31`](https://github.com/bluesky-social/atproto/commit/b43ec31f247f4461725b01226885f88bd430ca07), [`b43ec31`](https://github.com/bluesky-social/atproto/commit/b43ec31f247f4461725b01226885f88bd430ca07), [`b43ec31`](https://github.com/bluesky-social/atproto/commit/b43ec31f247f4461725b01226885f88bd430ca07), [`b43ec31`](https://github.com/bluesky-social/atproto/commit/b43ec31f247f4461725b01226885f88bd430ca07)]:
+  - @atproto/syntax@0.6.4
+  - @atproto/ws-client@0.1.4
+  - @atproto/lex@0.1.7
+  - @atproto/common@0.6.5
+
+## 0.3.4
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atproto/lex@0.1.6
+
+## 0.3.3
+
+### Patch Changes
+
+- [#5151](https://github.com/bluesky-social/atproto/pull/5151) [`a51c45d`](https://github.com/bluesky-social/atproto/commit/a51c45d38f6bd7b8765f640e564cf921d52162e7) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Update dependencies
+
+- Updated dependencies [[`f2cf8f7`](https://github.com/bluesky-social/atproto/commit/f2cf8f7fc5f3a10847f2e6d785e5fa2244ee8cfb), [`a51c45d`](https://github.com/bluesky-social/atproto/commit/a51c45d38f6bd7b8765f640e564cf921d52162e7), [`f2cf8f7`](https://github.com/bluesky-social/atproto/commit/f2cf8f7fc5f3a10847f2e6d785e5fa2244ee8cfb)]:
+  - @atproto/common@0.6.4
+  - @atproto/lex@0.1.5
+  - @atproto/syntax@0.6.3
+  - @atproto/ws-client@0.1.3
+
+## 0.3.2
+
+### Patch Changes
+
+- [#5117](https://github.com/bluesky-social/atproto/pull/5117) [`8a4c88b`](https://github.com/bluesky-social/atproto/commit/8a4c88b0f63fb2d82b1391d64c54e0c760fac48b) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Make tests less flaky in CI
+
+- Updated dependencies [[`8a4c88b`](https://github.com/bluesky-social/atproto/commit/8a4c88b0f63fb2d82b1391d64c54e0c760fac48b)]:
+  - @atproto/ws-client@0.1.2
+
+## 0.3.1
+
+### Patch Changes
+
+- [#4967](https://github.com/bluesky-social/atproto/pull/4967) [`9fc720c`](https://github.com/bluesky-social/atproto/commit/9fc720ce75f3ee88a5e48a9be919b07c7647f6f5) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Use TypeScript 7 to build package
+
+- Updated dependencies [[`9fc720c`](https://github.com/bluesky-social/atproto/commit/9fc720ce75f3ee88a5e48a9be919b07c7647f6f5)]:
+  - @atproto/ws-client@0.1.1
+  - @atproto/lex@0.1.4
+  - @atproto/common@0.6.3
+  - @atproto/syntax@0.6.2
+
+## 0.3.0
+
+### Minor Changes
+
+- [#4929](https://github.com/bluesky-social/atproto/pull/4929) [`f01c59f`](https://github.com/bluesky-social/atproto/commit/f01c59f5bd3f75fb8b47a9eecd4858b84033fb7c) Thanks [@devinivy](https://github.com/devinivy)! - **BREAKING:** Drop support for Node.js 18 and 20. Node.js 22 is now the minimum supported version. Docker images now use Node.js 24.
+
+- [#4943](https://github.com/bluesky-social/atproto/pull/4943) [`c459153`](https://github.com/bluesky-social/atproto/commit/c459153395a30ce89e050892c8fab7dc98e019b9) Thanks [@devinivy](https://github.com/devinivy)! - **BREAKING:** Convert to pure ESM. All packages now ship `"type": "module"` with ES module output and Node16 module resolution.
+
+  Node.js 22's `require()` compatibility layer can still load these packages in CommonJS code.
+
+- [#4930](https://github.com/bluesky-social/atproto/pull/4930) [`908bece`](https://github.com/bluesky-social/atproto/commit/908bece169258bff5ad121e5eec157d6ded6f705) Thanks [@devinivy](https://github.com/devinivy)! - Build with TypeScript 6.0.
+
+### Patch Changes
+
+- Updated dependencies [[`affb50c`](https://github.com/bluesky-social/atproto/commit/affb50c040b497a12631df99a6310f8e78cab557), [`f01c59f`](https://github.com/bluesky-social/atproto/commit/f01c59f5bd3f75fb8b47a9eecd4858b84033fb7c), [`c459153`](https://github.com/bluesky-social/atproto/commit/c459153395a30ce89e050892c8fab7dc98e019b9), [`908bece`](https://github.com/bluesky-social/atproto/commit/908bece169258bff5ad121e5eec157d6ded6f705)]:
+  - @atproto/common@0.6.0
+  - @atproto/lex@0.1.0
+  - @atproto/syntax@0.6.0
+  - @atproto/ws-client@0.1.0
+
+## 0.2.15
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atproto/lex@0.0.27
+
+## 0.2.14
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atproto/lex@0.0.26
+
+## 0.2.13
+
+### Patch Changes
+
+- Updated dependencies [[`26d793a`](https://github.com/bluesky-social/atproto/commit/26d793af95a6fb3a50f9b2a97187d8ac4fecf676), [`26d793a`](https://github.com/bluesky-social/atproto/commit/26d793af95a6fb3a50f9b2a97187d8ac4fecf676), [`26d793a`](https://github.com/bluesky-social/atproto/commit/26d793af95a6fb3a50f9b2a97187d8ac4fecf676), [`55d06de`](https://github.com/bluesky-social/atproto/commit/55d06de80a1506908a04ed5c0834986cb5783797), [`26d793a`](https://github.com/bluesky-social/atproto/commit/26d793af95a6fb3a50f9b2a97187d8ac4fecf676)]:
+  - @atproto/syntax@0.5.4
+  - @atproto/lex@0.0.25
+
+## 0.2.12
+
+### Patch Changes
+
+- Updated dependencies [[`c62651d`](https://github.com/bluesky-social/atproto/commit/c62651dd69f1e18bd854b66e499b91fee9eaa856)]:
+  - @atproto/lex@0.0.24
+  - @atproto/common@0.5.16
+
+## 0.2.11
+
+### Patch Changes
+
+- Updated dependencies [[`0dbea15`](https://github.com/bluesky-social/atproto/commit/0dbea15da48a6ca913cc3a3a2d8c0ffe64d7c69a), [`d0c136c`](https://github.com/bluesky-social/atproto/commit/d0c136cba2ec8fa97017849b1023d5af5d2cc60c), [`527f5d4`](https://github.com/bluesky-social/atproto/commit/527f5d4c5d0c9264c2ff6f23ad06a41163fc6809)]:
+  - @atproto/syntax@0.5.2
+  - @atproto/lex@0.0.23
+
+## 0.2.10
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atproto/lex@0.0.22
+  - @atproto/common@0.5.15
+
+## 0.2.9
+
+### Patch Changes
+
+- Updated dependencies [[`67eb0c1`](https://github.com/bluesky-social/atproto/commit/67eb0c19ac415e762e221b2ccda9f0bcf7b3dd6f)]:
+  - @atproto/syntax@0.5.1
+  - @atproto/lex@0.0.21
+
+## 0.2.8
+
+### Patch Changes
+
+- Updated dependencies [[`f7c2610`](https://github.com/bluesky-social/atproto/commit/f7c26103a6d4e24e5bedbb6fd908be140420e0dd), [`f7c2610`](https://github.com/bluesky-social/atproto/commit/f7c26103a6d4e24e5bedbb6fd908be140420e0dd), [`f7c2610`](https://github.com/bluesky-social/atproto/commit/f7c26103a6d4e24e5bedbb6fd908be140420e0dd), [`f7c2610`](https://github.com/bluesky-social/atproto/commit/f7c26103a6d4e24e5bedbb6fd908be140420e0dd), [`f7c2610`](https://github.com/bluesky-social/atproto/commit/f7c26103a6d4e24e5bedbb6fd908be140420e0dd), [`f7c2610`](https://github.com/bluesky-social/atproto/commit/f7c26103a6d4e24e5bedbb6fd908be140420e0dd), [`f7c2610`](https://github.com/bluesky-social/atproto/commit/f7c26103a6d4e24e5bedbb6fd908be140420e0dd), [`52834ab`](https://github.com/bluesky-social/atproto/commit/52834aba182da8df3611fd9dff924e6c6a3973a7), [`f7c2610`](https://github.com/bluesky-social/atproto/commit/f7c26103a6d4e24e5bedbb6fd908be140420e0dd)]:
+  - @atproto/syntax@0.5.0
+  - @atproto/lex@0.0.20
+  - @atproto/common@0.5.14
+
+## 0.2.7
+
+### Patch Changes
+
+- Updated dependencies [[`38852f0`](https://github.com/bluesky-social/atproto/commit/38852f0ddfa9fbce8036233dc6af87614e9ae4b2)]:
+  - @atproto/lex@0.0.19
+
+## 0.2.6
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atproto/common@0.5.13
+  - @atproto/lex@0.0.18
+
+## 0.2.5
+
+### Patch Changes
+
+- Updated dependencies [[`009c4af`](https://github.com/bluesky-social/atproto/commit/009c4afd3643d4edf4bd05065ec93cab74610bfe)]:
+  - @atproto/lex@0.0.17
+  - @atproto/common@0.5.12
+
+## 0.2.4
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atproto/lex@0.0.16
+
+## 0.2.3
+
+### Patch Changes
+
+- Updated dependencies [[`ed61c62`](https://github.com/bluesky-social/atproto/commit/ed61c62f3161fcde85ee9a93f8ed339c7e06c015), [`ed61c62`](https://github.com/bluesky-social/atproto/commit/ed61c62f3161fcde85ee9a93f8ed339c7e06c015), [`ed61c62`](https://github.com/bluesky-social/atproto/commit/ed61c62f3161fcde85ee9a93f8ed339c7e06c015)]:
+  - @atproto/lex@0.0.15
+  - @atproto/common@0.5.11
+
+## 0.2.2
+
+### Patch Changes
+
+- Updated dependencies [[`369bb02`](https://github.com/bluesky-social/atproto/commit/369bb02b9f80f0e15e5242e54f09bd4e01117f3a), [`49b3806`](https://github.com/bluesky-social/atproto/commit/49b38069ed4b5bd1ef71e967c78e5123b1c1f6f1)]:
+  - @atproto/lex@0.0.14
+  - @atproto/common@0.5.10
+
+## 0.2.1
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atproto/lex@0.0.13
+
+## 0.2.0
+
+### Minor Changes
+
+- [#4532](https://github.com/bluesky-social/atproto/pull/4532) [`aaedafc`](https://github.com/bluesky-social/atproto/commit/aaedafc6baef106b85e0954d8474cec21c00c1c2) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Expose `record` data as parsed atproto data (including CIDs and Uint8Arrays)
+
+### Patch Changes
+
+- [#4532](https://github.com/bluesky-social/atproto/pull/4532) [`aaedafc`](https://github.com/bluesky-social/atproto/commit/aaedafc6baef106b85e0954d8474cec21c00c1c2) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Replace event validation from "zod" to "@atproto/lex"
+
+- [#4562](https://github.com/bluesky-social/atproto/pull/4562) [`7310b97`](https://github.com/bluesky-social/atproto/commit/7310b9704de678a3b389a741784d58bb7f79b10b) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Add validation error as cause when handling invalid records
+
+- Updated dependencies [[`99963d0`](https://github.com/bluesky-social/atproto/commit/99963d002a9e030e79aed5fba700e0a68f31e101), [`99963d0`](https://github.com/bluesky-social/atproto/commit/99963d002a9e030e79aed5fba700e0a68f31e101), [`7310b97`](https://github.com/bluesky-social/atproto/commit/7310b9704de678a3b389a741784d58bb7f79b10b), [`99963d0`](https://github.com/bluesky-social/atproto/commit/99963d002a9e030e79aed5fba700e0a68f31e101), [`7310b97`](https://github.com/bluesky-social/atproto/commit/7310b9704de678a3b389a741784d58bb7f79b10b), [`99963d0`](https://github.com/bluesky-social/atproto/commit/99963d002a9e030e79aed5fba700e0a68f31e101), [`7310b97`](https://github.com/bluesky-social/atproto/commit/7310b9704de678a3b389a741784d58bb7f79b10b), [`7310b97`](https://github.com/bluesky-social/atproto/commit/7310b9704de678a3b389a741784d58bb7f79b10b)]:
+  - @atproto/syntax@0.4.3
+  - @atproto/lex@0.0.12
+  - @atproto/common@0.5.9
+
+## 0.1.3
+
+### Patch Changes
+
+- [#4534](https://github.com/bluesky-social/atproto/pull/4534) [`0193467`](https://github.com/bluesky-social/atproto/commit/0193467463a1a49c0c7f17d129c07b687a1f5057) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Make sure the `destroy()` promise resolves, even in case of error
+
+- [#4534](https://github.com/bluesky-social/atproto/pull/4534) [`0193467`](https://github.com/bluesky-social/atproto/commit/0193467463a1a49c0c7f17d129c07b687a1f5057) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Make `TapChannel` implement `AsyncDisposable`, allowing use with `using` keyword
+
+- Updated dependencies []:
+  - @atproto/common@0.5.8
+  - @atproto/lex@0.0.11
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atproto/common@0.5.7
+  - @atproto/lex@0.0.10
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [[`2f78893`](https://github.com/bluesky-social/atproto/commit/2f78893ace3bbf14d4bac36837820ddb46658c98), [`2f78893`](https://github.com/bluesky-social/atproto/commit/2f78893ace3bbf14d4bac36837820ddb46658c98)]:
+  - @atproto/lex@0.0.9
+  - @atproto/common@0.5.6
+
+## 0.1.0
+
+### Minor Changes
+
+- [#4483](https://github.com/bluesky-social/atproto/pull/4483) [`e3357e9`](https://github.com/bluesky-social/atproto/commit/e3357e9c781ff84430556f4c891639acfcef3486) Thanks [@dholms](https://github.com/dholms)! - Add LexIndexer
+
+## 0.0.3
+
+### Patch Changes
+
+- [#4481](https://github.com/bluesky-social/atproto/pull/4481) [`e15e7cf`](https://github.com/bluesky-social/atproto/commit/e15e7cf1a07d6a4bdd7a9a3c591690613f5414b5) Thanks [@dholms](https://github.com/dholms)! - Fix URL formatting with trailing slash
+
+- Updated dependencies []:
+  - @atproto/common@0.5.4
+
+## 0.0.2
+
+### Patch Changes
+
+- [#4290](https://github.com/bluesky-social/atproto/pull/4290) [`b4a76ba`](https://github.com/bluesky-social/atproto/commit/b4a76bae7bef1189302488d43ce49a03fd61f957) Thanks [@dholms](https://github.com/dholms)! - Initial version of package
+
+- Updated dependencies [[`b4a76ba`](https://github.com/bluesky-social/atproto/commit/b4a76bae7bef1189302488d43ce49a03fd61f957)]:
+  - @atproto/ws-client@0.0.4

package/LICENSE.txt

@@ -0,0 +1,7 @@
+Dual MIT/Apache-2.0 License
+
+Copyright (c) 2022-2026 Bluesky Social PBC, and Contributors
+
+Except as otherwise noted in individual files, this software is licensed under the MIT license (<http://opensource.org/licenses/MIT>), or the Apache License, Version 2.0 (<http://www.apache.org/licenses/LICENSE-2.0>).
+
+Downstream projects and end users may chose either license individually, or both together, at their discretion. The motivation for this dual-licensing is the additional software patent assurance provided by Apache 2.0.

package/README.md

@@ -0,0 +1,268 @@
+# @atproto/tap
+
+TypeScript client library for [Tap](https://github.com/bluesky-social/indigo/tree/main/cmd/tap/README.md), a sync utility for the AT Protocol network.
+
+Tap handles firehose connections, cryptographic verification, backfill, and filtering. This client library lets you connect to a Tap instance and receive simple JSON events for the repos you care about.
+
+[![NPM](https://img.shields.io/npm/v/@atproto/tap)](https://www.npmjs.com/package/@atproto/tap)
+[![Github CI Status](https://github.com/bluesky-social/atproto/actions/workflows/repo.yaml/badge.svg)](https://github.com/bluesky-social/atproto/actions/workflows/repo.yaml)
+
+## Quick Start
+
+```bash
+npm install @atproto/tap
+```
+
+```ts
+import { Tap, SimpleIndexer } from '@atproto/tap'
+
+const tap = new Tap('http://localhost:2480', { adminPassword: 'secret' })
+
+const indexer = new SimpleIndexer()
+
+indexer.identity(async (evt) => {
+  console.log(`${evt.did} updated identity: ${evt.handle} (${evt.status})`)
+})
+
+indexer.record(async (evt) => {
+  const uri = `at://${evt.did}/${evt.collection}/${evt.rkey}`
+  if (evt.action === 'create' || evt.action === 'update') {
+    console.log(`${evt.action}: ${uri}`)
+  } else {
+    console.log(`deleted: ${uri}`)
+  }
+})
+
+indexer.error((err) => console.error(err))
+
+const channel = tap.channel(indexer)
+channel.start()
+
+await tap.addRepos(['did:plc:ewvi7nxzyoun6zhxrhs64oiz'])
+
+// On shutdown
+await channel.destroy()
+```
+
+## Running Tap
+
+See the [Tap README](https://github.com/bluesky-social/indigo/tree/main/cmd/tap/README.md) for details getting Tap up and running. Your app can communicate with it either locally or over the internet.
+
+This library is intended to be used with Tap running in the default mode of "WebScoket with acks". In this mode, Tap provides:
+
+- **At-least-once delivery**: Events may be redelivered if the connection drops before an ack is received
+- **Per-repo ordering**: Events for the same repo are delivered in order
+- **Backfill**: When you add a repo, historical events are delivered before live events
+
+## API
+
+### `Tap`
+
+The main client for interacting with a Tap server.
+
+```ts
+const tap = new Tap(url: string, config?: TapConfig)
+```
+
+**Config options:**
+
+- `adminPassword?: string` - Password for Basic auth (required if Tap server has auth enabled)
+
+**Methods:**
+
+- `channel(handler: TapHandler, opts?: TapWebsocketOptions): TapChannel` - Create a WebSocket channel to receive events
+- `addRepos(dids: string[]): Promise<void>` - Add repos to track (triggers backfill)
+- `removeRepos(dids: string[]): Promise<void>` - Stop tracking repos
+- `resolveDid(did: string): Promise<DidDocument | null>` - Resolve a DID to its DID document
+- `getRepoInfo(did: string): Promise<RepoInfo>` - Get info about a tracked repo
+
+### `TapChannel`
+
+WebSocket connection for receiving events. Created via `tap.channel()`.
+
+```ts
+const channel = tap.channel(handler, opts?)
+```
+
+**Methods:**
+
+- `start(): Promise<void>` - Start receiving events. Returns a promise that resolves when the connection is destroyed or errors.
+- `destroy(): Promise<void>` - Close the connection
+
+The channel automatically handles reconnection and keepalive. Events are automatically acknowledged after your handler completes successfully.
+
+### `SimpleIndexer`
+
+A convenience class for handling events by type. Passed into `tap.channel()` when opening a channel with Tap.
+
+```ts
+const indexer = new SimpleIndexer()
+
+indexer.identity(async (evt: IdentityEvent) => { ... })
+indexer.record(async (evt: RecordEvent) => { ... })
+indexer.error((err: Error) => { ... })
+```
+
+If no error handler is registered, errors will throw as unhandled exceptions.
+
+### `LexIndexer`
+
+A typed indexer that uses `@atproto/lex` schemas for type-safe event handling. Register handlers for specific record types and actions:
+
+```ts
+import { LexIndexer } from '@atproto/tap'
+import * as com from './lexicons/com'
+
+const indexer = new LexIndexer()
+
+// Handle creates for a specific record type
+indexer.create(com.example.post, async (evt) => {
+  // evt.record is fully typed as com.example.post.Main
+  console.log(`New post: ${evt.record.text}`)
+})
+
+// Handle updates
+indexer.update(com.example.post, async (evt) => {
+  console.log(`Updated post: ${evt.record.text}`)
+})
+
+// Handle deletes (no record on delete events)
+indexer.delete(com.example.post, async (evt) => {
+  console.log(`Deleted: at://${evt.did}/${evt.collection}/${evt.rkey}`)
+})
+
+// Handle both creates and updates with put()
+indexer.put(com.example.like, async (evt) => {
+  console.log(`Like ${evt.action}: ${evt.record.subject.uri}`)
+})
+
+// Fallback for unhandled record types/actions
+indexer.other(async (evt) => {
+  console.log(`Unhandled: ${evt.action}, ${evt.collection}`)
+})
+
+// Identity and error handlers
+indexer.identity(async (evt) => { ... })
+indexer.error((err) => { ... })
+
+const channel = tap.channel(indexer)
+```
+
+Records are validated against their schemas before handlers are called. If validation fails, an error is thrown which will be picked up through the `error` handler..
+
+Duplicate handler registration throws an error, including conflicts between `put()` and `create()`/`update()` for the same schema.
+
+### `TapHandler`
+
+You can create your own custom handler by creating a class that implements the `TapHandler` interface:
+
+```ts
+interface TapHandler {
+  onEvent: (evt: TapEvent, opts: HandlerOpts) => void | Promise<void>
+  onError: (err: Error) => void
+}
+
+interface HandlerOpts {
+  signal: AbortSignal
+  ack: () => Promise<void>
+}
+```
+
+When implementing a custom handler, be sure to call `ack()` when you're done processing the event.
+
+## Event Types
+
+### `RecordEvent`
+
+```ts
+type RecordEvent = {
+  id: number
+  type: 'record'
+  action: 'create' | 'update' | 'delete'
+  did: string
+  rev: string
+  collection: string
+  rkey: string
+  record?: Record<string, unknown> // present for create/update
+  cid?: string // present for create/update
+  live: boolean // true if from firehose, false if from backfill
+}
+```
+
+### `IdentityEvent`
+
+```ts
+type IdentityEvent = {
+  id: number
+  type: 'identity'
+  did: string
+  handle: string
+  isActive: boolean
+  status: 'active' | 'takendown' | 'suspended' | 'deactivated' | 'deleted'
+}
+```
+
+## Webhook Mode
+
+If your Tap server is configured for webhook delivery, you can use `parseTapEvent` to validate incoming webhook payloads:
+
+```ts
+import express from 'express'
+import { parseTapEvent, assureAdminAuth } from '@atproto/tap'
+
+const ADMIN_PASSWORD = process.env.ADMIN_PASSWORD
+
+const app = express()
+app.use(express.json())
+
+app.post('/webhook', async (req, res) => {
+  try {
+    assureAdminAuth(ADMIN_PASSWORD, req.headers.authorization)
+  } catch {
+    return res.status(401).json({ error: 'Unauthorized' })
+  }
+
+  try {
+    const evt = parseTapEvent(req.body)
+    // handle event...
+    res.sendStatus(200)
+  } catch (err) {
+    console.error('Failed to process event:', err)
+    res.status(500).json({ error: 'Failed to process event' })
+  }
+})
+```
+
+## Utilities
+
+### Auth helpers
+
+```ts
+import {
+  formatAdminAuthHeader,
+  parseAdminAuthHeader,
+  assureAdminAuth,
+} from '@atproto/tap'
+
+// Format a password into a Basic auth header value
+const header = formatAdminAuthHeader('secret')
+// => 'Basic YWRtaW46c2VjcmV0'
+
+// Parse an auth header to extract the password (throws if invalid)
+const password = parseAdminAuthHeader(header)
+
+// Verify auth header matches expected password (timing-safe, throws if invalid)
+assureAdminAuth('secret', req.headers.authorization)
+```
+
+### Event parsing
+
+```ts
+import { parseTapEvent } from '@atproto/tap'
+
+const evt = parseTapEvent(jsonData) // validates and returns typed TapEvent
+```
+
+## License
+
+MIT