@s2-dev/streamstore 0.20.0 → 0.21.0

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.
Files changed (221) hide show
  1. package/LICENSE +21 -201
  2. package/README.md +60 -10
  3. package/dist/cjs/accessTokens.d.ts +27 -14
  4. package/dist/cjs/accessTokens.d.ts.map +1 -1
  5. package/dist/cjs/accessTokens.js +72 -8
  6. package/dist/cjs/accessTokens.js.map +1 -1
  7. package/dist/cjs/basins.d.ts +29 -19
  8. package/dist/cjs/basins.d.ts.map +1 -1
  9. package/dist/cjs/basins.js +119 -9
  10. package/dist/cjs/basins.js.map +1 -1
  11. package/dist/cjs/batch-transform.d.ts +12 -16
  12. package/dist/cjs/batch-transform.d.ts.map +1 -1
  13. package/dist/cjs/batch-transform.js +17 -21
  14. package/dist/cjs/batch-transform.js.map +1 -1
  15. package/dist/cjs/common.d.ts +31 -24
  16. package/dist/cjs/common.d.ts.map +1 -1
  17. package/dist/cjs/common.js +22 -0
  18. package/dist/cjs/common.js.map +1 -1
  19. package/dist/cjs/endpoints.d.ts +63 -0
  20. package/dist/cjs/endpoints.d.ts.map +1 -0
  21. package/dist/cjs/endpoints.js +120 -0
  22. package/dist/cjs/endpoints.js.map +1 -0
  23. package/dist/cjs/error.d.ts.map +1 -1
  24. package/dist/cjs/error.js +11 -0
  25. package/dist/cjs/error.js.map +1 -1
  26. package/dist/cjs/generated/types.gen.d.ts +11 -20
  27. package/dist/cjs/generated/types.gen.d.ts.map +1 -1
  28. package/dist/cjs/index.d.ts +30 -46
  29. package/dist/cjs/index.d.ts.map +1 -1
  30. package/dist/cjs/index.js +50 -26
  31. package/dist/cjs/index.js.map +1 -1
  32. package/dist/cjs/internal/case-transform.d.ts +59 -0
  33. package/dist/cjs/internal/case-transform.d.ts.map +1 -0
  34. package/dist/cjs/internal/case-transform.js +80 -0
  35. package/dist/cjs/internal/case-transform.js.map +1 -0
  36. package/dist/cjs/internal/mappers.d.ts +51 -0
  37. package/dist/cjs/internal/mappers.d.ts.map +1 -0
  38. package/dist/cjs/internal/mappers.js +225 -0
  39. package/dist/cjs/internal/mappers.js.map +1 -0
  40. package/dist/cjs/internal/sdk-types.d.ts +127 -0
  41. package/dist/cjs/internal/sdk-types.d.ts.map +1 -0
  42. package/dist/cjs/internal/sdk-types.js +9 -0
  43. package/dist/cjs/internal/sdk-types.js.map +1 -0
  44. package/dist/cjs/lib/base64.d.ts +8 -0
  45. package/dist/cjs/lib/base64.d.ts.map +1 -1
  46. package/dist/cjs/lib/base64.js +32 -12
  47. package/dist/cjs/lib/base64.js.map +1 -1
  48. package/dist/cjs/lib/event-stream.d.ts.map +1 -1
  49. package/dist/cjs/lib/event-stream.js +2 -1
  50. package/dist/cjs/lib/event-stream.js.map +1 -1
  51. package/dist/cjs/lib/paginate.d.ts +57 -0
  52. package/dist/cjs/lib/paginate.d.ts.map +1 -0
  53. package/dist/cjs/lib/paginate.js +51 -0
  54. package/dist/cjs/lib/paginate.js.map +1 -0
  55. package/dist/cjs/lib/result.d.ts +1 -1
  56. package/dist/cjs/lib/result.d.ts.map +1 -1
  57. package/dist/cjs/lib/retry.d.ts +47 -31
  58. package/dist/cjs/lib/retry.d.ts.map +1 -1
  59. package/dist/cjs/lib/retry.js +302 -201
  60. package/dist/cjs/lib/retry.js.map +1 -1
  61. package/dist/cjs/lib/stream/runtime.d.ts +1 -1
  62. package/dist/cjs/lib/stream/transport/fetch/index.d.ts +7 -9
  63. package/dist/cjs/lib/stream/transport/fetch/index.d.ts.map +1 -1
  64. package/dist/cjs/lib/stream/transport/fetch/index.js +38 -39
  65. package/dist/cjs/lib/stream/transport/fetch/index.js.map +1 -1
  66. package/dist/cjs/lib/stream/transport/fetch/shared.d.ts +7 -2
  67. package/dist/cjs/lib/stream/transport/fetch/shared.d.ts.map +1 -1
  68. package/dist/cjs/lib/stream/transport/fetch/shared.js +56 -110
  69. package/dist/cjs/lib/stream/transport/fetch/shared.js.map +1 -1
  70. package/dist/cjs/lib/stream/transport/proto.d.ts +9 -0
  71. package/dist/cjs/lib/stream/transport/proto.d.ts.map +1 -0
  72. package/dist/cjs/lib/stream/transport/proto.js +118 -0
  73. package/dist/cjs/lib/stream/transport/proto.js.map +1 -0
  74. package/dist/cjs/lib/stream/transport/s2s/index.d.ts +3 -3
  75. package/dist/cjs/lib/stream/transport/s2s/index.d.ts.map +1 -1
  76. package/dist/cjs/lib/stream/transport/s2s/index.js +115 -82
  77. package/dist/cjs/lib/stream/transport/s2s/index.js.map +1 -1
  78. package/dist/cjs/lib/stream/types.d.ts +81 -36
  79. package/dist/cjs/lib/stream/types.d.ts.map +1 -1
  80. package/dist/cjs/lib/stream/types.js +18 -0
  81. package/dist/cjs/lib/stream/types.js.map +1 -1
  82. package/dist/cjs/metrics.d.ts +18 -17
  83. package/dist/cjs/metrics.d.ts.map +1 -1
  84. package/dist/cjs/metrics.js +67 -12
  85. package/dist/cjs/metrics.js.map +1 -1
  86. package/dist/cjs/producer.d.ts +82 -0
  87. package/dist/cjs/producer.d.ts.map +1 -0
  88. package/dist/cjs/producer.js +305 -0
  89. package/dist/cjs/producer.js.map +1 -0
  90. package/dist/cjs/s2.d.ts +1 -2
  91. package/dist/cjs/s2.d.ts.map +1 -1
  92. package/dist/cjs/s2.js +9 -9
  93. package/dist/cjs/s2.js.map +1 -1
  94. package/dist/cjs/stream.d.ts +26 -12
  95. package/dist/cjs/stream.d.ts.map +1 -1
  96. package/dist/cjs/stream.js +77 -13
  97. package/dist/cjs/stream.js.map +1 -1
  98. package/dist/cjs/streams.d.ts +29 -19
  99. package/dist/cjs/streams.d.ts.map +1 -1
  100. package/dist/cjs/streams.js +120 -9
  101. package/dist/cjs/streams.js.map +1 -1
  102. package/dist/cjs/types.d.ts +624 -0
  103. package/dist/cjs/types.d.ts.map +1 -0
  104. package/dist/cjs/types.js +129 -0
  105. package/dist/cjs/types.js.map +1 -0
  106. package/dist/cjs/utils.d.ts +1 -22
  107. package/dist/cjs/utils.d.ts.map +1 -1
  108. package/dist/cjs/utils.js +0 -42
  109. package/dist/cjs/utils.js.map +1 -1
  110. package/dist/cjs/version.d.ts +1 -1
  111. package/dist/cjs/version.js +1 -1
  112. package/dist/esm/accessTokens.d.ts +27 -14
  113. package/dist/esm/accessTokens.d.ts.map +1 -1
  114. package/dist/esm/accessTokens.js +73 -9
  115. package/dist/esm/accessTokens.js.map +1 -1
  116. package/dist/esm/basins.d.ts +29 -19
  117. package/dist/esm/basins.d.ts.map +1 -1
  118. package/dist/esm/basins.js +119 -9
  119. package/dist/esm/basins.js.map +1 -1
  120. package/dist/esm/batch-transform.d.ts +12 -16
  121. package/dist/esm/batch-transform.d.ts.map +1 -1
  122. package/dist/esm/batch-transform.js +18 -22
  123. package/dist/esm/batch-transform.js.map +1 -1
  124. package/dist/esm/common.d.ts +31 -24
  125. package/dist/esm/common.d.ts.map +1 -1
  126. package/dist/esm/common.js +20 -1
  127. package/dist/esm/common.js.map +1 -1
  128. package/dist/esm/endpoints.d.ts +63 -0
  129. package/dist/esm/endpoints.d.ts.map +1 -0
  130. package/dist/esm/endpoints.js +115 -0
  131. package/dist/esm/endpoints.js.map +1 -0
  132. package/dist/esm/error.d.ts.map +1 -1
  133. package/dist/esm/error.js +11 -0
  134. package/dist/esm/error.js.map +1 -1
  135. package/dist/esm/generated/types.gen.d.ts +11 -20
  136. package/dist/esm/generated/types.gen.d.ts.map +1 -1
  137. package/dist/esm/index.d.ts +30 -46
  138. package/dist/esm/index.d.ts.map +1 -1
  139. package/dist/esm/index.js +33 -19
  140. package/dist/esm/index.js.map +1 -1
  141. package/dist/esm/internal/case-transform.d.ts +59 -0
  142. package/dist/esm/internal/case-transform.d.ts.map +1 -0
  143. package/dist/esm/internal/case-transform.js +76 -0
  144. package/dist/esm/internal/case-transform.js.map +1 -0
  145. package/dist/esm/internal/mappers.d.ts +51 -0
  146. package/dist/esm/internal/mappers.d.ts.map +1 -0
  147. package/dist/esm/internal/mappers.js +218 -0
  148. package/dist/esm/internal/mappers.js.map +1 -0
  149. package/dist/esm/internal/sdk-types.d.ts +127 -0
  150. package/dist/esm/internal/sdk-types.d.ts.map +1 -0
  151. package/dist/esm/internal/sdk-types.js +8 -0
  152. package/dist/esm/internal/sdk-types.js.map +1 -0
  153. package/dist/esm/lib/base64.d.ts +8 -0
  154. package/dist/esm/lib/base64.d.ts.map +1 -1
  155. package/dist/esm/lib/base64.js +30 -11
  156. package/dist/esm/lib/base64.js.map +1 -1
  157. package/dist/esm/lib/event-stream.d.ts.map +1 -1
  158. package/dist/esm/lib/event-stream.js +2 -1
  159. package/dist/esm/lib/event-stream.js.map +1 -1
  160. package/dist/esm/lib/paginate.d.ts +57 -0
  161. package/dist/esm/lib/paginate.d.ts.map +1 -0
  162. package/dist/esm/lib/paginate.js +48 -0
  163. package/dist/esm/lib/paginate.js.map +1 -0
  164. package/dist/esm/lib/result.d.ts +1 -1
  165. package/dist/esm/lib/result.d.ts.map +1 -1
  166. package/dist/esm/lib/retry.d.ts +47 -31
  167. package/dist/esm/lib/retry.d.ts.map +1 -1
  168. package/dist/esm/lib/retry.js +303 -201
  169. package/dist/esm/lib/retry.js.map +1 -1
  170. package/dist/esm/lib/stream/runtime.d.ts +1 -1
  171. package/dist/esm/lib/stream/transport/fetch/index.d.ts +7 -9
  172. package/dist/esm/lib/stream/transport/fetch/index.d.ts.map +1 -1
  173. package/dist/esm/lib/stream/transport/fetch/index.js +40 -41
  174. package/dist/esm/lib/stream/transport/fetch/index.js.map +1 -1
  175. package/dist/esm/lib/stream/transport/fetch/shared.d.ts +7 -2
  176. package/dist/esm/lib/stream/transport/fetch/shared.d.ts.map +1 -1
  177. package/dist/esm/lib/stream/transport/fetch/shared.js +58 -112
  178. package/dist/esm/lib/stream/transport/fetch/shared.js.map +1 -1
  179. package/dist/esm/lib/stream/transport/proto.d.ts +9 -0
  180. package/dist/esm/lib/stream/transport/proto.d.ts.map +1 -0
  181. package/dist/esm/lib/stream/transport/proto.js +110 -0
  182. package/dist/esm/lib/stream/transport/proto.js.map +1 -0
  183. package/dist/esm/lib/stream/transport/s2s/index.d.ts +3 -3
  184. package/dist/esm/lib/stream/transport/s2s/index.d.ts.map +1 -1
  185. package/dist/esm/lib/stream/transport/s2s/index.js +116 -82
  186. package/dist/esm/lib/stream/transport/s2s/index.js.map +1 -1
  187. package/dist/esm/lib/stream/types.d.ts +81 -36
  188. package/dist/esm/lib/stream/types.d.ts.map +1 -1
  189. package/dist/esm/lib/stream/types.js +17 -1
  190. package/dist/esm/lib/stream/types.js.map +1 -1
  191. package/dist/esm/metrics.d.ts +18 -17
  192. package/dist/esm/metrics.d.ts.map +1 -1
  193. package/dist/esm/metrics.js +66 -12
  194. package/dist/esm/metrics.js.map +1 -1
  195. package/dist/esm/producer.d.ts +82 -0
  196. package/dist/esm/producer.d.ts.map +1 -0
  197. package/dist/esm/producer.js +300 -0
  198. package/dist/esm/producer.js.map +1 -0
  199. package/dist/esm/s2.d.ts +1 -2
  200. package/dist/esm/s2.d.ts.map +1 -1
  201. package/dist/esm/s2.js +9 -9
  202. package/dist/esm/s2.js.map +1 -1
  203. package/dist/esm/stream.d.ts +26 -12
  204. package/dist/esm/stream.d.ts.map +1 -1
  205. package/dist/esm/stream.js +79 -15
  206. package/dist/esm/stream.js.map +1 -1
  207. package/dist/esm/streams.d.ts +29 -19
  208. package/dist/esm/streams.d.ts.map +1 -1
  209. package/dist/esm/streams.js +120 -9
  210. package/dist/esm/streams.js.map +1 -1
  211. package/dist/esm/types.d.ts +624 -0
  212. package/dist/esm/types.d.ts.map +1 -0
  213. package/dist/esm/types.js +126 -0
  214. package/dist/esm/types.js.map +1 -0
  215. package/dist/esm/utils.d.ts +1 -22
  216. package/dist/esm/utils.d.ts.map +1 -1
  217. package/dist/esm/utils.js +0 -41
  218. package/dist/esm/utils.js.map +1 -1
  219. package/dist/esm/version.d.ts +1 -1
  220. package/dist/esm/version.js +1 -1
  221. package/package.json +4 -3
@@ -1,13 +1,21 @@
1
- import { withS2Data } from "./error.js";
1
+ import { S2Error, withS2Data } from "./error.js";
2
2
  import { checkTail } from "./generated/index.js";
3
- import { isRetryable, withRetries } from "./lib/retry.js";
3
+ import { fromAPIReadBatchBytes, fromAPIReadBatchString, fromAPITailResponse, toAPIReadQuery, } from "./internal/mappers.js";
4
+ import { withRetries } from "./lib/retry.js";
4
5
  import { createSessionTransport } from "./lib/stream/factory.js";
5
6
  import { streamAppend, streamRead, } from "./lib/stream/transport/fetch/shared.js";
7
+ /**
8
+ * Basin-scoped stream helper for append/read operations.
9
+ *
10
+ * Created via {@link S2Basin.stream}. Provides direct methods plus factories for read/append sessions.
11
+ */
6
12
  export class S2Stream {
7
13
  client;
8
14
  transportConfig;
9
15
  retryConfig;
10
16
  _transport;
17
+ closed = false;
18
+ closePromise;
11
19
  name;
12
20
  constructor(name, client, transportConfig, retryConfig) {
13
21
  this.name = name;
@@ -19,25 +27,33 @@ export class S2Stream {
19
27
  * Get or create the transport instance
20
28
  */
21
29
  async getTransport() {
30
+ this.ensureOpen();
22
31
  if (!this._transport) {
23
32
  this._transport = await createSessionTransport(this.transportConfig);
24
33
  }
25
34
  return this._transport;
26
35
  }
36
+ ensureOpen() {
37
+ if (this.closed) {
38
+ throw new S2Error({ message: "S2Stream is closed" });
39
+ }
40
+ }
27
41
  /**
28
42
  * Check the tail of the stream.
29
43
  *
30
44
  * Returns the next sequence number and timestamp to be assigned (`tail`).
31
45
  */
32
46
  async checkTail(options) {
47
+ this.ensureOpen();
33
48
  return await withRetries(this.retryConfig, async () => {
34
- return await withS2Data(() => checkTail({
49
+ const response = await withS2Data(() => checkTail({
35
50
  client: this.client,
36
51
  path: {
37
52
  stream: this.name,
38
53
  },
39
54
  ...options,
40
55
  }));
56
+ return fromAPITailResponse(response);
41
57
  });
42
58
  }
43
59
  /**
@@ -48,33 +64,45 @@ export class S2Stream {
48
64
  * - Non-streaming reads are bounded by `count` and `bytes` (defaults 1000 and 1 MiB).
49
65
  * - Use `readSession` for streaming reads
50
66
  */
51
- async read(args, options) {
67
+ async read(input, options) {
68
+ this.ensureOpen();
69
+ const { as, ...requestOptions } = options ?? {};
52
70
  return await withRetries(this.retryConfig, async () => {
53
- return await streamRead(this.name, this.client, args, options);
71
+ // Convert ReadInput to ReadArgs using mapper
72
+ const readArgs = {
73
+ ...toAPIReadQuery(input),
74
+ as,
75
+ };
76
+ const genBatch = await streamRead(this.name, this.client, readArgs, requestOptions);
77
+ // Convert from API to SDK ReadBatch
78
+ return (as === "bytes"
79
+ ? fromAPIReadBatchBytes(genBatch)
80
+ : fromAPIReadBatchString(genBatch));
54
81
  });
55
82
  }
56
83
  /**
57
- * Append one or more records to the stream.
84
+ * Append a batch of records to the stream.
58
85
  *
59
86
  * - Automatically base64-encodes when format is "bytes".
60
- * - Supports conditional appends via `fencing_token` and `match_seq_num`.
87
+ * - Supports conditional appends via `fencingToken` and `matchSeqNum` in the input.
61
88
  * - Returns the acknowledged range and the stream tail after the append.
89
+ * - All records in a batch must use the same format (either all string or all bytes).
62
90
  *
63
- * All records in a single append call must use the same format (either all string or all bytes).
91
+ * Use {@link AppendInput.create} to construct a validated AppendInput.
64
92
  * For high-throughput sequential appends, use `appendSession()` instead.
65
93
  *
66
- * @param records The record(s) to append
67
- * @param args Optional append arguments (fencing_token, match_seq_num)
94
+ * @param input The append input containing records and optional conditions
68
95
  * @param options Optional request options
69
96
  */
70
- async append(records, args, options) {
97
+ async append(input, options) {
98
+ this.ensureOpen();
71
99
  return await withRetries(this.retryConfig, async () => {
72
- return await streamAppend(this.name, this.client, records, args, options);
100
+ return await streamAppend(this.name, this.client, input, options);
73
101
  }, (config, error) => {
74
102
  if ((config.appendRetryPolicy ?? "all") === "noSideEffects") {
75
103
  // Allow retry only when the append is naturally idempotent by containing
76
104
  // a match_seq_num condition.
77
- return !!args?.match_seq_num;
105
+ return input.matchSeqNum !== undefined;
78
106
  }
79
107
  else {
80
108
  return true;
@@ -87,9 +115,16 @@ export class S2Stream {
87
115
  * Use the returned session as an async iterable or as a readable stream.
88
116
  * When `as: "bytes"` is provided, bodies and headers are decoded to `Uint8Array`.
89
117
  */
90
- async readSession(args, options) {
118
+ async readSession(input, options) {
119
+ this.ensureOpen();
120
+ const { as, ...requestOptions } = options ?? {};
91
121
  const transport = await this.getTransport();
92
- return await transport.makeReadSession(this.name, args, options);
122
+ // Convert ReadInput to ReadArgs using mapper
123
+ const readArgs = {
124
+ ...toAPIReadQuery(input),
125
+ as,
126
+ };
127
+ return await transport.makeReadSession(this.name, readArgs, requestOptions);
93
128
  }
94
129
  /**
95
130
  * Create an append session that guarantees ordering of submissions.
@@ -101,8 +136,37 @@ export class S2Stream {
101
136
  * @param requestOptions Optional request options
102
137
  */
103
138
  async appendSession(sessionOptions, requestOptions) {
139
+ this.ensureOpen();
104
140
  const transport = await this.getTransport();
105
141
  return await transport.makeAppendSession(this.name, sessionOptions, requestOptions);
106
142
  }
143
+ async close() {
144
+ if (this.closePromise) {
145
+ return this.closePromise;
146
+ }
147
+ this.closePromise = (async () => {
148
+ if (this.closed) {
149
+ return;
150
+ }
151
+ this.closed = true;
152
+ if (this._transport) {
153
+ try {
154
+ await this._transport.close();
155
+ }
156
+ finally {
157
+ this._transport = undefined;
158
+ }
159
+ }
160
+ })();
161
+ try {
162
+ await this.closePromise;
163
+ }
164
+ finally {
165
+ this.closePromise = undefined;
166
+ }
167
+ }
168
+ async [Symbol.asyncDispose]() {
169
+ await this.close();
170
+ }
107
171
  }
108
172
  //# sourceMappingURL=stream.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/stream.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/stream.ts"],"names":[],"mappings":"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"}
@@ -1,16 +1,11 @@
1
- import type { DataToObject, RetryConfig, S2RequestOptions } from "./common.js";
1
+ import type { RetryConfig, S2RequestOptions } from "./common.js";
2
2
  import type { Client } from "./generated/client/types.gen.js";
3
- import { type CreateStreamData, type CreateStreamResponse, type DeleteStreamData, type GetStreamConfigData, type ListStreamsData, type ListStreamsResponse, type ReconfigureStreamData, type ReconfigureStreamResponse, type StreamConfig } from "./generated/index.js";
4
- export interface ListStreamsArgs extends DataToObject<ListStreamsData> {
5
- }
6
- export interface CreateStreamArgs extends DataToObject<CreateStreamData> {
7
- }
8
- export interface GetStreamConfigArgs extends DataToObject<GetStreamConfigData> {
9
- }
10
- export interface DeleteStreamArgs extends DataToObject<DeleteStreamData> {
11
- }
12
- export interface ReconfigureStreamArgs extends DataToObject<ReconfigureStreamData> {
13
- }
3
+ import type * as Types from "./types.js";
4
+ /**
5
+ * Basin-scoped helper for listing and configuring streams.
6
+ *
7
+ * Access via {@link S2Basin.streams}. Methods inherit the basin's retry configuration.
8
+ */
14
9
  export declare class S2Streams {
15
10
  private readonly client;
16
11
  private readonly retryConfig?;
@@ -19,34 +14,49 @@ export declare class S2Streams {
19
14
  * List streams in the basin.
20
15
  *
21
16
  * @param args.prefix Return streams whose names start with the given prefix
22
- * @param args.start_after Name to start after (for pagination)
17
+ * @param args.startAfter Name to start after (for pagination)
23
18
  * @param args.limit Max results (up to 1000)
24
19
  */
25
- list(args?: ListStreamsArgs, options?: S2RequestOptions): Promise<ListStreamsResponse>;
20
+ list(args?: Types.ListStreamsInput, options?: S2RequestOptions): Promise<Types.ListStreamsResponse>;
21
+ /**
22
+ * List all streams in the basin with automatic pagination.
23
+ * Returns a lazy async iterable that fetches pages as needed.
24
+ *
25
+ * @param includeDeleted - Include deleted streams (default: false)
26
+ * @param args - Optional filtering options: `prefix` to filter by name prefix, `limit` for max results per page
27
+ *
28
+ * @example
29
+ * ```ts
30
+ * for await (const stream of basin.streams.listAll({ prefix: "events-" })) {
31
+ * console.log(stream.name);
32
+ * }
33
+ * ```
34
+ */
35
+ listAll(includeDeleted?: boolean, args?: Types.ListAllStreamsInput, options?: S2RequestOptions): AsyncIterable<Types.StreamInfo>;
26
36
  /**
27
37
  * Create a stream.
28
38
  *
29
39
  * @param args.stream Stream name (1-512 bytes, unique within the basin)
30
- * @param args.config Stream configuration (retention, storage class, timestamping, delete-on-empty)
40
+ * @param args.config Stream configuration (retentionPolicy, storageClass, timestamping, deleteOnEmpty)
31
41
  */
32
- create(args: CreateStreamArgs, options?: S2RequestOptions): Promise<CreateStreamResponse>;
42
+ create(args: Types.CreateStreamInput, options?: S2RequestOptions): Promise<Types.CreateStreamResponse>;
33
43
  /**
34
44
  * Get stream configuration.
35
45
  *
36
46
  * @param args.stream Stream name
37
47
  */
38
- getConfig(args: GetStreamConfigArgs, options?: S2RequestOptions): Promise<StreamConfig>;
48
+ getConfig(args: Types.GetStreamConfigInput, options?: S2RequestOptions): Promise<Types.StreamConfig>;
39
49
  /**
40
50
  * Delete a stream.
41
51
  *
42
52
  * @param args.stream Stream name
43
53
  */
44
- delete(args: DeleteStreamArgs, options?: S2RequestOptions): Promise<void>;
54
+ delete(args: Types.DeleteStreamInput, options?: S2RequestOptions): Promise<void>;
45
55
  /**
46
56
  * Reconfigure a stream.
47
57
  *
48
58
  * @param args Configuration for the stream to reconfigure (including stream name and fields to change)
49
59
  */
50
- reconfigure(args: ReconfigureStreamArgs, options?: S2RequestOptions): Promise<ReconfigureStreamResponse>;
60
+ reconfigure(args: Types.ReconfigureStreamInput, options?: S2RequestOptions): Promise<Types.ReconfigureStreamResponse>;
51
61
  }
52
62
  //# sourceMappingURL=streams.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../src/streams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EACN,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EAEzB,KAAK,gBAAgB,EAErB,KAAK,mBAAmB,EAExB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EAExB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAE9B,KAAK,YAAY,EACjB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,eAAgB,SAAQ,YAAY,CAAC,eAAe,CAAC;CAAG;AACzE,MAAM,WAAW,gBAAiB,SAAQ,YAAY,CAAC,gBAAgB,CAAC;CAAG;AAC3E,MAAM,WAAW,mBAChB,SAAQ,YAAY,CAAC,mBAAmB,CAAC;CAAG;AAC7C,MAAM,WAAW,gBAAiB,SAAQ,YAAY,CAAC,gBAAgB,CAAC;CAAG;AAC3E,MAAM,WAAW,qBAChB,SAAQ,YAAY,CAAC,qBAAqB,CAAC;CAAG;AAE/C,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;gBAE/B,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW;IAKrD;;;;;;OAMG;IACU,IAAI,CAChB,IAAI,CAAC,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC;IAY/B;;;;;OAKG;IACU,MAAM,CAClB,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,oBAAoB,CAAC;IAYhC;;;;OAIG;IACU,SAAS,CACrB,IAAI,EAAE,mBAAmB,EACzB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,YAAY,CAAC;IAYxB;;;;OAIG;IACU,MAAM,CAClB,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;OAIG;IACU,WAAW,CACvB,IAAI,EAAE,qBAAqB,EAC3B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,yBAAyB,CAAC;CAYrC"}
1
+ {"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../src/streams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAa9D,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AAkEzC;;;;GAIG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;gBAE/B,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW;IAKrD;;;;;;OAMG;IACU,IAAI,CAChB,IAAI,CAAC,EAAE,KAAK,CAAC,gBAAgB,EAC7B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC;IAiBrC;;;;;;;;;;;;;OAaG;IACI,OAAO,CACb,cAAc,UAAQ,EACtB,IAAI,CAAC,EAAE,KAAK,CAAC,mBAAmB,EAChC,OAAO,CAAC,EAAE,gBAAgB,GACxB,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC;IAYlC;;;;;OAKG;IACU,MAAM,CAClB,IAAI,EAAE,KAAK,CAAC,iBAAiB,EAC7B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC;IAoBtC;;;;OAIG;IACU,SAAS,CACrB,IAAI,EAAE,KAAK,CAAC,oBAAoB,EAChC,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;IAc9B;;;;OAIG;IACU,MAAM,CAClB,IAAI,EAAE,KAAK,CAAC,iBAAiB,EAC7B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;OAIG;IACU,WAAW,CACvB,IAAI,EAAE,KAAK,CAAC,sBAAsB,EAClC,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC;CAoB3C"}
@@ -1,6 +1,74 @@
1
1
  import { withS2Data } from "./error.js";
2
2
  import { createStream, deleteStream, getStreamConfig, listStreams, reconfigureStream, } from "./generated/index.js";
3
+ import { toCamelCase, toSnakeCase } from "./internal/case-transform.js";
4
+ import { randomToken } from "./lib/base64.js";
5
+ import { paginate } from "./lib/paginate.js";
3
6
  import { withRetries } from "./lib/retry.js";
7
+ function toDate(value) {
8
+ if (value === null)
9
+ return null;
10
+ if (value === undefined)
11
+ return undefined;
12
+ return new Date(value);
13
+ }
14
+ function transformStreamInfo(stream) {
15
+ return {
16
+ ...stream,
17
+ createdAt: toDate(stream.createdAt),
18
+ deletedAt: toDate(stream.deletedAt),
19
+ };
20
+ }
21
+ /** Convert SDK RetentionPolicy (ageSecs) to API RetentionPolicy (age). */
22
+ function toAPIRetentionPolicy(policy) {
23
+ if (policy === null)
24
+ return null;
25
+ if (policy === undefined)
26
+ return undefined;
27
+ if ("ageSecs" in policy) {
28
+ return { age: Math.floor(policy.ageSecs) };
29
+ }
30
+ return policy; // { infinite: ... } passes through
31
+ }
32
+ /** Convert API RetentionPolicy (age) to SDK RetentionPolicy (ageSecs). */
33
+ function toSDKRetentionPolicy(policy) {
34
+ if (policy === null)
35
+ return null;
36
+ if (policy === undefined)
37
+ return undefined;
38
+ if ("age" in policy) {
39
+ return { ageSecs: policy.age };
40
+ }
41
+ return policy; // { infinite: ... } passes through
42
+ }
43
+ /** Convert SDK StreamConfig to API format (handles retentionPolicy.ageSecs → age). */
44
+ function toAPIStreamConfig(config) {
45
+ if (config === null || config === undefined)
46
+ return config;
47
+ return {
48
+ ...config,
49
+ deleteOnEmpty: config.deleteOnEmpty
50
+ ? {
51
+ ...config.deleteOnEmpty,
52
+ minAgeSecs: config.deleteOnEmpty.minAgeSecs === undefined
53
+ ? undefined
54
+ : Math.max(0, Math.floor(config.deleteOnEmpty.minAgeSecs)),
55
+ }
56
+ : config.deleteOnEmpty,
57
+ retentionPolicy: toAPIRetentionPolicy(config.retentionPolicy),
58
+ };
59
+ }
60
+ /** Convert API StreamConfig to SDK format (handles retentionPolicy.age → ageSecs). */
61
+ function toSDKStreamConfig(config) {
62
+ return {
63
+ ...config,
64
+ retentionPolicy: toSDKRetentionPolicy(config?.retentionPolicy),
65
+ };
66
+ }
67
+ /**
68
+ * Basin-scoped helper for listing and configuring streams.
69
+ *
70
+ * Access via {@link S2Basin.streams}. Methods inherit the basin's retry configuration.
71
+ */
4
72
  export class S2Streams {
5
73
  client;
6
74
  retryConfig;
@@ -12,32 +80,65 @@ export class S2Streams {
12
80
  * List streams in the basin.
13
81
  *
14
82
  * @param args.prefix Return streams whose names start with the given prefix
15
- * @param args.start_after Name to start after (for pagination)
83
+ * @param args.startAfter Name to start after (for pagination)
16
84
  * @param args.limit Max results (up to 1000)
17
85
  */
18
86
  async list(args, options) {
19
- return await withRetries(this.retryConfig, async () => {
87
+ const response = await withRetries(this.retryConfig, async () => {
20
88
  return await withS2Data(() => listStreams({
21
89
  client: this.client,
22
- query: args,
90
+ query: toSnakeCase(args),
23
91
  ...options,
24
92
  }));
25
93
  });
94
+ const camelCased = toCamelCase(response);
95
+ return {
96
+ ...camelCased,
97
+ streams: camelCased.streams.map(transformStreamInfo),
98
+ };
99
+ }
100
+ /**
101
+ * List all streams in the basin with automatic pagination.
102
+ * Returns a lazy async iterable that fetches pages as needed.
103
+ *
104
+ * @param includeDeleted - Include deleted streams (default: false)
105
+ * @param args - Optional filtering options: `prefix` to filter by name prefix, `limit` for max results per page
106
+ *
107
+ * @example
108
+ * ```ts
109
+ * for await (const stream of basin.streams.listAll({ prefix: "events-" })) {
110
+ * console.log(stream.name);
111
+ * }
112
+ * ```
113
+ */
114
+ listAll(includeDeleted = false, args, options) {
115
+ return paginate((a) => this.list(a, options).then((r) => ({
116
+ items: r.streams.filter((s) => includeDeleted || !s.deletedAt),
117
+ hasMore: r.hasMore,
118
+ })), args ?? {}, (stream) => stream.name);
26
119
  }
27
120
  /**
28
121
  * Create a stream.
29
122
  *
30
123
  * @param args.stream Stream name (1-512 bytes, unique within the basin)
31
- * @param args.config Stream configuration (retention, storage class, timestamping, delete-on-empty)
124
+ * @param args.config Stream configuration (retentionPolicy, storageClass, timestamping, deleteOnEmpty)
32
125
  */
33
126
  async create(args, options) {
34
- return await withRetries(this.retryConfig, async () => {
127
+ const requestToken = randomToken();
128
+ // Convert SDK config to API format (ageSecs → age)
129
+ const apiArgs = {
130
+ ...args,
131
+ config: toAPIStreamConfig(args.config),
132
+ };
133
+ const response = await withRetries(this.retryConfig, async () => {
35
134
  return await withS2Data(() => createStream({
36
135
  client: this.client,
37
- body: args,
136
+ body: toSnakeCase(apiArgs),
137
+ headers: { "s2-request-token": requestToken },
38
138
  ...options,
39
139
  }));
40
140
  });
141
+ return toCamelCase(response);
41
142
  }
42
143
  /**
43
144
  * Get stream configuration.
@@ -45,13 +146,15 @@ export class S2Streams {
45
146
  * @param args.stream Stream name
46
147
  */
47
148
  async getConfig(args, options) {
48
- return await withRetries(this.retryConfig, async () => {
149
+ const response = await withRetries(this.retryConfig, async () => {
49
150
  return await withS2Data(() => getStreamConfig({
50
151
  client: this.client,
51
152
  path: args,
52
153
  ...options,
53
154
  }));
54
155
  });
156
+ // Convert API format to SDK (age → ageSecs)
157
+ return toSDKStreamConfig(toCamelCase(response));
55
158
  }
56
159
  /**
57
160
  * Delete a stream.
@@ -73,14 +176,22 @@ export class S2Streams {
73
176
  * @param args Configuration for the stream to reconfigure (including stream name and fields to change)
74
177
  */
75
178
  async reconfigure(args, options) {
76
- return await withRetries(this.retryConfig, async () => {
179
+ // Convert SDK config to API format (ageSecs age)
180
+ const apiArgs = {
181
+ ...args,
182
+ retentionPolicy: toAPIRetentionPolicy(args.retentionPolicy),
183
+ };
184
+ const response = await withRetries(this.retryConfig, async () => {
77
185
  return await withS2Data(() => reconfigureStream({
78
186
  client: this.client,
79
187
  path: args,
80
- body: args,
188
+ body: toSnakeCase(apiArgs),
81
189
  ...options,
82
190
  }));
83
191
  });
192
+ // Convert API format to SDK (age → ageSecs)
193
+ const camelCased = toCamelCase(response);
194
+ return toSDKStreamConfig(camelCased);
84
195
  }
85
196
  }
86
197
  //# sourceMappingURL=streams.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"streams.js","sourceRoot":"","sources":["../../src/streams.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAGN,YAAY,EAEZ,YAAY,EAEZ,eAAe,EAGf,WAAW,EAGX,iBAAiB,GAEjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAU7C,MAAM,OAAO,SAAS;IACJ,MAAM,CAAS;IACf,WAAW,CAAe;IAE3C,YAAY,MAAc,EAAE,WAAyB;QACpD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,IAAI,CAChB,IAAsB,EACtB,OAA0B;QAE1B,OAAO,MAAM,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YACrD,OAAO,MAAM,UAAU,CAAC,GAAG,EAAE,CAC5B,WAAW,CAAC;gBACX,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,IAAI;gBACX,GAAG,OAAO;aACV,CAAC,CACF,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,MAAM,CAClB,IAAsB,EACtB,OAA0B;QAE1B,OAAO,MAAM,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YACrD,OAAO,MAAM,UAAU,CAAC,GAAG,EAAE,CAC5B,YAAY,CAAC;gBACZ,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI;gBACV,GAAG,OAAO;aACV,CAAC,CACF,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,SAAS,CACrB,IAAyB,EACzB,OAA0B;QAE1B,OAAO,MAAM,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YACrD,OAAO,MAAM,UAAU,CAAC,GAAG,EAAE,CAC5B,eAAe,CAAC;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI;gBACV,GAAG,OAAO;aACV,CAAC,CACF,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,MAAM,CAClB,IAAsB,EACtB,OAA0B;QAE1B,MAAM,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YAC9C,OAAO,MAAM,UAAU,CAAC,GAAG,EAAE,CAC5B,YAAY,CAAC;gBACZ,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI;gBACV,GAAG,OAAO;aACV,CAAC,CACF,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,WAAW,CACvB,IAA2B,EAC3B,OAA0B;QAE1B,OAAO,MAAM,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YACrD,OAAO,MAAM,UAAU,CAAC,GAAG,EAAE,CAC5B,iBAAiB,CAAC;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,IAAI;gBACV,GAAG,OAAO;aACV,CAAC,CACF,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}
1
+ {"version":3,"file":"streams.js","sourceRoot":"","sources":["../../src/streams.ts"],"names":[],"mappings":"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"}