@cntryl/fitz 0.0.2 → 0.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -2
- package/dist/index.cjs +634 -122
- package/dist/index.cjs.map +1 -1
- package/dist/index.mjs +634 -122
- package/dist/index.mjs.map +1 -1
- package/dist/types/client/client.d.ts +1 -1
- package/dist/types/client/client.d.ts.map +1 -1
- package/dist/types/client/connection.d.ts +9 -3
- package/dist/types/client/connection.d.ts.map +1 -1
- package/dist/types/client/resilience.d.ts +21 -0
- package/dist/types/client/resilience.d.ts.map +1 -0
- package/dist/types/core/errors.d.ts.map +1 -1
- package/dist/types/core/types.d.ts +7 -0
- package/dist/types/core/types.d.ts.map +1 -1
- package/dist/types/domains/base.d.ts +9 -2
- package/dist/types/domains/base.d.ts.map +1 -1
- package/dist/types/domains/kv/transaction.d.ts.map +1 -1
- package/dist/types/domains/lease/client.d.ts.map +1 -1
- package/dist/types/domains/lease/types.d.ts.map +1 -1
- package/dist/types/domains/queue/client.d.ts.map +1 -1
- package/dist/types/domains/queue/types.d.ts.map +1 -1
- package/dist/types/domains/rpc/client.d.ts.map +1 -1
- package/dist/types/domains/schedule/client.d.ts.map +1 -1
- package/dist/types/domains/stream/client.d.ts.map +1 -1
- package/dist/types/domains/stream/session.d.ts.map +1 -1
- package/dist/types/index.d.ts +1 -1
- package/dist/types/index.d.ts.map +1 -1
- package/package.json +6 -2
package/README.md
CHANGED
|
@@ -18,7 +18,6 @@ import { Client } from "@cntryl/fitz";
|
|
|
18
18
|
const client = Client({
|
|
19
19
|
url: "ws://localhost:4090/ws",
|
|
20
20
|
tokenProvider: async () => "your-jwt-token",
|
|
21
|
-
reconnect: { enabled: true },
|
|
22
21
|
asyncHandlers: {
|
|
23
22
|
maxConcurrency: 32,
|
|
24
23
|
timeoutMs: 5000,
|
|
@@ -43,7 +42,6 @@ import { Client } from "@cntryl/fitz";
|
|
|
43
42
|
|
|
44
43
|
const client = Client({
|
|
45
44
|
url: "ws://localhost:4090/ws",
|
|
46
|
-
reconnect: { enabled: true },
|
|
47
45
|
observability: {
|
|
48
46
|
logger: {
|
|
49
47
|
log(level, event, fields) {
|
|
@@ -59,6 +57,16 @@ const client = Client({
|
|
|
59
57
|
|
|
60
58
|
See `docs/OPERATIONS.md` for lifecycle events, metric names, and production guidance.
|
|
61
59
|
|
|
60
|
+
## Resilience Defaults
|
|
61
|
+
|
|
62
|
+
- After a client has connected successfully once, transport loss automatically triggers reconnect with bounded backoff unless `reconnect.enabled` is set to `false`.
|
|
63
|
+
- The initial `connect()` call is still one-shot by default. If service startup should wait out broker availability, build that loop at the application boundary.
|
|
64
|
+
- Safe automatic retries are enabled by default through `ClientConfig.retry`:
|
|
65
|
+
- idempotent reads: KV `get` / `scan`, Stream `read` / `readPage` / `peek` / `metadata`, Lease `query`
|
|
66
|
+
- queue `enqueue()` only after Fitz explicitly rejects the write with a known transient commit failure
|
|
67
|
+
- The client does not automatically replay KV mutations, stream writes, queue reservations or acknowledgements, lease ownership changes, RPC calls, or notice publishes after an ambiguous post-send failure.
|
|
68
|
+
- `QueueItem`, `Lease`, `KvTransaction`, and `StreamSession` handles from the pre-disconnect session are stale after reconnect and must be reacquired.
|
|
69
|
+
|
|
62
70
|
## Stream Replay
|
|
63
71
|
|
|
64
72
|
```typescript
|