a collection of lightweight TypeScript packages for AT Protocol, the protocol powering Bluesky
atproto
bluesky
typescript
npm
docs(tid): explain `TID.now()` behavior
+7
+7
packages/utilities/tid/README.md
+7
packages/utilities/tid/README.md
···
25
25
// -> "3l25zusnsfck2"
26
26
```
27
27
28
+
on Node.js, `TID.now()` relies on the system's real-time clock for microsecond precision where
29
+
available, falling back to millisecond precision otherwise.
30
+
31
+
`TID.now()` is not monotonic — TIDs must track wall clock time, so if the clock is adjusted
32
+
backward, the generated TIDs will follow. within a single process, rapid successive calls that
33
+
observe the same timestamp will increment instead of reusing it to avoid collisions.
34
+
28
35
### parsing TIDs
29
36
30
37
```ts