@xeonr/pipelines-sdk 0.1.0 → 0.3.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 (106) hide show
  1. package/README.md +247 -24
  2. package/dist/client.d.ts +73 -3
  3. package/dist/client.d.ts.map +1 -1
  4. package/dist/client.js +48 -1
  5. package/dist/client.js.map +1 -1
  6. package/dist/errors.d.ts +42 -6
  7. package/dist/errors.d.ts.map +1 -1
  8. package/dist/errors.js +45 -2
  9. package/dist/errors.js.map +1 -1
  10. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.d.ts +173 -12
  11. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.d.ts.map +1 -1
  12. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.js +45 -28
  13. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.js.map +1 -1
  14. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.d.ts +136 -17
  15. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.d.ts.map +1 -1
  16. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.js +42 -35
  17. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.js.map +1 -1
  18. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.d.ts +346 -15
  19. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.d.ts.map +1 -1
  20. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.js +105 -10
  21. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.js.map +1 -1
  22. package/dist/gen/xeonr/pipelines/v1/common_pb.d.ts +38 -6
  23. package/dist/gen/xeonr/pipelines/v1/common_pb.d.ts.map +1 -1
  24. package/dist/gen/xeonr/pipelines/v1/common_pb.js +37 -5
  25. package/dist/gen/xeonr/pipelines/v1/common_pb.js.map +1 -1
  26. package/dist/gen/xeonr/pipelines/v1/definition_pb.d.ts +280 -5
  27. package/dist/gen/xeonr/pipelines/v1/definition_pb.d.ts.map +1 -1
  28. package/dist/gen/xeonr/pipelines/v1/definition_pb.js +100 -7
  29. package/dist/gen/xeonr/pipelines/v1/definition_pb.js.map +1 -1
  30. package/dist/gen/xeonr/pipelines/v1/pipelines_pb.d.ts +1100 -0
  31. package/dist/gen/xeonr/pipelines/v1/pipelines_pb.d.ts.map +1 -0
  32. package/dist/gen/xeonr/pipelines/v1/pipelines_pb.js +298 -0
  33. package/dist/gen/xeonr/pipelines/v1/pipelines_pb.js.map +1 -0
  34. package/dist/gen/xeonr/pipelines/v1/pools_pb.d.ts +120 -1
  35. package/dist/gen/xeonr/pipelines/v1/pools_pb.d.ts.map +1 -1
  36. package/dist/gen/xeonr/pipelines/v1/pools_pb.js +36 -11
  37. package/dist/gen/xeonr/pipelines/v1/pools_pb.js.map +1 -1
  38. package/dist/gen/xeonr/pipelines/v1/queues_pb.d.ts +769 -0
  39. package/dist/gen/xeonr/pipelines/v1/queues_pb.d.ts.map +1 -0
  40. package/dist/gen/xeonr/pipelines/v1/queues_pb.js +190 -0
  41. package/dist/gen/xeonr/pipelines/v1/queues_pb.js.map +1 -0
  42. package/dist/gen/xeonr/pipelines/v1/registry_pb.d.ts +60 -0
  43. package/dist/gen/xeonr/pipelines/v1/registry_pb.d.ts.map +1 -1
  44. package/dist/gen/xeonr/pipelines/v1/registry_pb.js +21 -16
  45. package/dist/gen/xeonr/pipelines/v1/registry_pb.js.map +1 -1
  46. package/dist/gen/xeonr/pipelines/v1/runs_pb.d.ts +867 -4
  47. package/dist/gen/xeonr/pipelines/v1/runs_pb.d.ts.map +1 -1
  48. package/dist/gen/xeonr/pipelines/v1/runs_pb.js +243 -27
  49. package/dist/gen/xeonr/pipelines/v1/runs_pb.js.map +1 -1
  50. package/dist/gen/xeonr/pipelines/v1/schedules_pb.d.ts +1110 -0
  51. package/dist/gen/xeonr/pipelines/v1/schedules_pb.d.ts.map +1 -0
  52. package/dist/gen/xeonr/pipelines/v1/schedules_pb.js +295 -0
  53. package/dist/gen/xeonr/pipelines/v1/schedules_pb.js.map +1 -0
  54. package/dist/gen/xeonr/pipelines/v1/secrets_pb.d.ts +8 -3
  55. package/dist/gen/xeonr/pipelines/v1/secrets_pb.d.ts.map +1 -1
  56. package/dist/gen/xeonr/pipelines/v1/secrets_pb.js +1 -1
  57. package/dist/gen/xeonr/pipelines/v1/secrets_pb.js.map +1 -1
  58. package/dist/gen/xeonr/platform/v1/options_pb.d.ts +123 -1
  59. package/dist/gen/xeonr/platform/v1/options_pb.d.ts.map +1 -1
  60. package/dist/gen/xeonr/platform/v1/options_pb.js +90 -1
  61. package/dist/gen/xeonr/platform/v1/options_pb.js.map +1 -1
  62. package/dist/handler.d.ts +50 -0
  63. package/dist/handler.d.ts.map +1 -1
  64. package/dist/handler.js +27 -0
  65. package/dist/handler.js.map +1 -1
  66. package/dist/index.d.ts +13 -1
  67. package/dist/index.d.ts.map +1 -1
  68. package/dist/index.js +7 -1
  69. package/dist/index.js.map +1 -1
  70. package/dist/logship.d.ts +60 -10
  71. package/dist/logship.d.ts.map +1 -1
  72. package/dist/logship.js +171 -28
  73. package/dist/logship.js.map +1 -1
  74. package/dist/queues.d.ts +171 -0
  75. package/dist/queues.d.ts.map +1 -0
  76. package/dist/queues.js +135 -0
  77. package/dist/queues.js.map +1 -0
  78. package/dist/reporter.d.ts +120 -0
  79. package/dist/reporter.d.ts.map +1 -0
  80. package/dist/reporter.js +323 -0
  81. package/dist/reporter.js.map +1 -0
  82. package/dist/schedules.d.ts +201 -0
  83. package/dist/schedules.d.ts.map +1 -0
  84. package/dist/schedules.js +127 -0
  85. package/dist/schedules.js.map +1 -0
  86. package/dist/testing/cron.d.ts +33 -0
  87. package/dist/testing/cron.d.ts.map +1 -0
  88. package/dist/testing/cron.js +177 -0
  89. package/dist/testing/cron.js.map +1 -0
  90. package/dist/testing/index.d.ts +142 -4
  91. package/dist/testing/index.d.ts.map +1 -1
  92. package/dist/testing/index.js +843 -44
  93. package/dist/testing/index.js.map +1 -1
  94. package/dist/testing/queues.d.ts +46 -0
  95. package/dist/testing/queues.d.ts.map +1 -0
  96. package/dist/testing/queues.js +70 -0
  97. package/dist/testing/queues.js.map +1 -0
  98. package/dist/testing/schedules.d.ts +113 -0
  99. package/dist/testing/schedules.d.ts.map +1 -0
  100. package/dist/testing/schedules.js +419 -0
  101. package/dist/testing/schedules.js.map +1 -0
  102. package/dist/worker.d.ts +78 -8
  103. package/dist/worker.d.ts.map +1 -1
  104. package/dist/worker.js +163 -33
  105. package/dist/worker.js.map +1 -1
  106. package/package.json +1 -1
package/dist/logship.js CHANGED
@@ -1,17 +1,41 @@
1
+ import { Code, ConnectError } from "@connectrpc/connect";
1
2
  import { errorKind } from "./errors.js";
2
3
  import { backoff, sleep } from "./internal/time.js";
3
4
  const encoder = new TextEncoder();
5
+ /** The line a renumbered log carries where output was lost. */
6
+ export function lostMarker(lost) {
7
+ return `\n[pipelines] ${lost} bytes of output were lost: pipelines-api no longer held them and the worker had already let them go\n`;
8
+ }
4
9
  /**
5
- * Ships one attempt's log, in the runner's way (pkg/logship): chunks are
6
- * numbered from 0 without gaps, each sent until acknowledged before the next,
7
- * so a retry after a lost reply cannot duplicate or reorder anything; the
8
- * last chunk carries `final`.
10
+ * The seq an `out_of_range` answer names as expected: the last number in its
11
+ * message (the api says "seq: the next expected seq is N"), as the Go
12
+ * runner's `workerclient.ExpectedSeq` reads it. Undefined when it names none.
13
+ */
14
+ export function expectedSeq(err) {
15
+ const ce = ConnectError.from(err);
16
+ if (ce.code !== Code.OutOfRange)
17
+ return undefined;
18
+ const m = /(\d+)\D*$/.exec(ce.rawMessage);
19
+ return m ? BigInt(m[1]) : undefined;
20
+ }
21
+ class Stop extends Error {
22
+ }
23
+ /**
24
+ * Ships one attempt's log, the runner's way (pkg/logship): chunks are
25
+ * numbered from 0, each is sent until acknowledged before the next, so a
26
+ * retry after a lost reply cannot duplicate or reorder anything; the last
27
+ * chunk carries `final`.
9
28
  *
10
- * - `failed_precondition`: the attempt is lost; shipping stops and `onLost`
29
+ * - `failed_precondition`: the attempt is lost. Shipping stops and `onLost`
11
30
  * is told.
12
- * - `out_of_range` (or any other final code): not fatal to the attempt;
13
- * shipping stops and the rest of the log is dropped.
31
+ * - `out_of_range` naming the expected seq: the server holds fewer chunks
32
+ * than it acknowledged. The held chunks from the expected one are sent
33
+ * again; if they are no longer held, the log is renumbered from the
34
+ * expected seq after one marker line saying how much output was lost.
35
+ * Never fatal to the attempt.
14
36
  * - The server's `truncated`: the log is at its cap; shipping stops.
37
+ * - Another final code (`invalid_argument`, `unimplemented`): the rest of
38
+ * the log is dropped; the attempt carries on.
15
39
  * - Anything else is retried with backoff.
16
40
  */
17
41
  export class LogShipper {
@@ -25,6 +49,11 @@ export class LogShipper {
25
49
  stopped = false;
26
50
  closing = false;
27
51
  seq = 0n;
52
+ /** Acknowledged chunks, oldest first, kept to resend; bounded by maxBuffered. */
53
+ sent = [];
54
+ sentBytes = 0;
55
+ /** offsets[i] is how many bytes the chunks before seq i held; its length is seq + 1. */
56
+ offsets = [0];
28
57
  wake;
29
58
  done;
30
59
  abort = new AbortController();
@@ -37,6 +66,7 @@ export class LogShipper {
37
66
  maxBytes: opt.maxBytes ?? 0,
38
67
  onLost: opt.onLost,
39
68
  onRetry: opt.onRetry,
69
+ onRenumber: opt.onRenumber,
40
70
  };
41
71
  this.done = this.run();
42
72
  }
@@ -130,45 +160,158 @@ export class LogShipper {
130
160
  return;
131
161
  continue;
132
162
  }
133
- if (!(await this.send(chunk.data, chunk.final, signal)))
163
+ try {
164
+ await this.send(chunk.data, chunk.final, signal);
165
+ }
166
+ catch (err) {
167
+ if (!(err instanceof Stop))
168
+ this.opt.onRetry?.(err);
169
+ this.stopped = true;
134
170
  return;
135
- if (chunk.final)
171
+ }
172
+ if (chunk.final || this.stopped)
136
173
  return;
137
174
  }
138
175
  }
139
- /** Sends one chunk until acknowledged. False means shipping has stopped. */
176
+ /**
177
+ * Delivers one chunk at the current seq. A refusal as ahead of the server
178
+ * is answered by resending what it lost, or by renumbering, and then this
179
+ * chunk again; a server that refuses again is answered the same way, a
180
+ * bounded number of times.
181
+ */
140
182
  async send(data, final, signal) {
183
+ let replayed = false;
184
+ for (let round = 0;; round++) {
185
+ const seq = this.seq;
186
+ try {
187
+ const res = await this.deliver(seq, data, final, signal);
188
+ this.acknowledged(seq, data, res.nextSeq, res.truncated);
189
+ return;
190
+ }
191
+ catch (err) {
192
+ const expected = expectedSeq(err);
193
+ if (expected === undefined || round >= 8)
194
+ throw err;
195
+ if (expected > seq) {
196
+ // The server already holds this seq: it counts as acknowledged.
197
+ this.acknowledged(seq, data, expected, false);
198
+ return;
199
+ }
200
+ if (!replayed && (await this.replay(expected, seq, signal))) {
201
+ replayed = true;
202
+ continue;
203
+ }
204
+ await this.renumber(expected, seq, signal);
205
+ replayed = true;
206
+ }
207
+ }
208
+ }
209
+ /**
210
+ * Sends one chunk at `seq` until it is acknowledged. Throws Stop when the
211
+ * attempt is lost, shipping stopped, or the server answered something
212
+ * final; and the error itself for an `out_of_range` naming a seq other
213
+ * than this one, which the caller answers.
214
+ */
215
+ async deliver(seq, data, final, signal) {
141
216
  let delay = 0;
142
217
  for (;;) {
218
+ if (this.stopped || signal.aborted)
219
+ throw new Stop();
143
220
  try {
144
- const res = await this.sink(this.seq, data, final, signal);
145
- this.seq += 1n;
146
- if (res.truncated) {
147
- this.stopped = true;
148
- return false;
149
- }
150
- return true;
221
+ return await this.sink(seq, data, final, signal);
151
222
  }
152
223
  catch (err) {
153
224
  if (signal.aborted)
154
- return false;
225
+ throw new Stop();
226
+ const expected = expectedSeq(err);
227
+ if (expected !== undefined && expected !== seq)
228
+ throw err;
155
229
  const kind = errorKind(err);
230
+ this.opt.onRetry?.(err);
156
231
  if (kind === "lost") {
157
- this.stopped = true;
158
232
  this.opt.onLost?.();
159
- return false;
233
+ throw new Stop();
160
234
  }
161
- if (kind !== "transient") {
162
- // out_of_range and the other final codes: drop the rest of the
163
- // log, keep the attempt.
164
- this.opt.onRetry?.(err);
165
- this.stopped = true;
166
- return false;
235
+ if (kind !== "transient" && expected === undefined) {
236
+ // invalid_argument, unimplemented, an out_of_range naming no seq:
237
+ // drop the rest of the log, keep the attempt.
238
+ throw new Stop();
167
239
  }
168
- this.opt.onRetry?.(err);
169
240
  delay = backoff(delay, 200, 10_000);
170
241
  if (!(await sleep(delay, signal)))
171
- return false;
242
+ throw new Stop();
243
+ }
244
+ }
245
+ }
246
+ /** Records chunk `seq` as stored and keeps it for a resend. */
247
+ acknowledged(seq, data, next, truncated) {
248
+ this.seq = next > seq ? next : seq + 1n;
249
+ if (truncated)
250
+ this.stopped = true;
251
+ const i = Number(seq);
252
+ if (this.offsets.length > i + 1)
253
+ this.offsets.length = i + 1;
254
+ const end = this.offsets[this.offsets.length - 1] + data.length;
255
+ while (this.offsets.length < Number(this.seq) + 1)
256
+ this.offsets.push(end);
257
+ this.sent.push({ seq, data });
258
+ this.sentBytes += data.length;
259
+ while (this.sent.length > 1 && this.sentBytes > this.opt.maxBuffered) {
260
+ this.sentBytes -= this.sent.shift().data.length;
261
+ }
262
+ }
263
+ /**
264
+ * Sends the held chunks from `expected` up to (not including) `upTo`
265
+ * again. False when they are not all held, or the server refused one.
266
+ */
267
+ async replay(expected, upTo, signal) {
268
+ if (expected >= upTo || this.sent.length === 0 || this.sent[0].seq > expected)
269
+ return false;
270
+ for (const c of this.sent) {
271
+ if (c.seq < expected || c.seq >= upTo)
272
+ continue;
273
+ try {
274
+ await this.deliver(c.seq, c.data, false, signal);
275
+ }
276
+ catch (err) {
277
+ if (err instanceof Stop)
278
+ throw err;
279
+ return false;
280
+ }
281
+ }
282
+ return true;
283
+ }
284
+ /**
285
+ * Continues the log at `expected` when the chunks from there to `upTo`
286
+ * are not all held: one marker with the size of what is gone, then the
287
+ * held chunks that ran without a gap up to `upTo`, under new seqs.
288
+ */
289
+ async renumber(expected, upTo, signal) {
290
+ let first = upTo;
291
+ for (let i = this.sent.length - 1; i >= 0 && this.sent[i].seq === first - 1n && this.sent[i].seq >= expected; i--)
292
+ first--;
293
+ const keep = this.sent.filter((c) => c.seq >= first && c.seq < upTo).map((c) => c.data);
294
+ const lost = Number(first) < this.offsets.length && Number(expected) < this.offsets.length
295
+ ? this.offsets[Number(first)] - this.offsets[Number(expected)]
296
+ : 0;
297
+ this.opt.onRenumber?.(upTo, expected, lost);
298
+ // Forget everything from `expected` on: it is being numbered again.
299
+ this.seq = expected;
300
+ this.offsets.length = Number(expected) + 1;
301
+ this.sent = this.sent.filter((c) => c.seq < expected);
302
+ this.sentBytes = this.sent.reduce((n, c) => n + c.data.length, 0);
303
+ for (const data of [encoder.encode(lostMarker(lost)), ...keep]) {
304
+ if (this.stopped)
305
+ return;
306
+ const seq = this.seq;
307
+ try {
308
+ const res = await this.deliver(seq, data, false, signal);
309
+ this.acknowledged(seq, data, res.nextSeq, res.truncated);
310
+ }
311
+ catch (err) {
312
+ if (err instanceof Stop)
313
+ throw err;
314
+ return; // refused again: the caller answers what the server says now
172
315
  }
173
316
  }
174
317
  }
@@ -1 +1 @@
1
- {"version":3,"file":"logship.js","sourceRoot":"","sources":["../src/logship.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"logship.js","sourceRoot":"","sources":["../src/logship.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,171 @@
1
+ import type { MessageInitShape } from "@bufbuild/protobuf";
2
+ import type { Client } from "@connectrpc/connect";
3
+ import type { RunState } from "./gen/xeonr/pipelines/v1/common_pb.js";
4
+ import type { RetrySchema } from "./gen/xeonr/pipelines/v1/definition_pb.js";
5
+ import { QueuesService } from "./gen/xeonr/pipelines/v1/queues_pb.js";
6
+ import type { GetQueueStatsResponse, Queue } from "./gen/xeonr/pipelines/v1/queues_pb.js";
7
+ import type { Run } from "./gen/xeonr/pipelines/v1/runs_pb.js";
8
+ import type { Connection } from "./transport.js";
9
+ /** Options for {@link QueuesClient}. */
10
+ export type QueuesClientOptions = Connection & {
11
+ /**
12
+ * The product (Auth application id) whose queues these are: the caller's
13
+ * own. A queue's owner always names it. See {@link productFromToken}.
14
+ */
15
+ product: string;
16
+ /** Bound on each call. Default 30 s. */
17
+ timeoutMs?: number;
18
+ };
19
+ /**
20
+ * A queue as a product declares it. Every field but `name` is optional and
21
+ * takes the contract's default (no cap, no rate limit, the platform's retry
22
+ * and timeout, priority 1).
23
+ */
24
+ export interface QueueDecl {
25
+ /** `^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$`; `default` is the product's default queue. */
26
+ name: string;
27
+ description?: string;
28
+ /** Makes the queue that team's own; unset serves every tenant the product acts for. */
29
+ tenant?: string;
30
+ /** Caps the queue's claimed and running attempts, all tenants together. */
31
+ maxConcurrency?: number;
32
+ /** Caps one tenant's claimed and running attempts in the queue. */
33
+ maxConcurrencyPerTenant?: number;
34
+ /** At most `limit` attempts claimed per sliding `windowMs`, retries included. */
35
+ rateLimit?: {
36
+ limit: number;
37
+ windowMs: number;
38
+ };
39
+ /** The retry of a job that gives none, and the most a job may ask for. */
40
+ defaultRetry?: MessageInitShape<typeof RetrySchema>;
41
+ /** The timeout of a job that gives none, and the most a job may ask for. */
42
+ defaultTimeoutMs?: number;
43
+ /** Lower first, across a product's queues a worker could claim from. Zero means 1. */
44
+ priority?: number;
45
+ }
46
+ /** A queue to read: by id, or by name (the product's, optionally a team's own). */
47
+ export type QueueRef = {
48
+ id: string;
49
+ } | {
50
+ name: string;
51
+ tenant?: string;
52
+ };
53
+ /**
54
+ * The client for `QueuesService`: the lanes a product's jobs are admitted
55
+ * through, with their limits and fairness. Needs `pipelines:queue:edit` to
56
+ * change queues and `pipelines:queue:read` to read them.
57
+ *
58
+ * Jobs name a queue with `PipelinesClient.createJob({ queue })`; a job with
59
+ * none goes to the product's `default` queue.
60
+ */
61
+ export declare class QueuesClient {
62
+ /** The generated client, for anything not wrapped here. */
63
+ readonly queues: Client<typeof QueuesService>;
64
+ private readonly runs;
65
+ readonly product: string;
66
+ private readonly timeoutMs;
67
+ constructor(opts: QueuesClientOptions);
68
+ /**
69
+ * Sets a queue (`SetQueue`): creates it, or replaces every writable field
70
+ * of the one with that owner and name. Pause and resume are separate.
71
+ */
72
+ setQueue(decl: QueueDecl, signal?: AbortSignal): Promise<{
73
+ queue: Queue;
74
+ created: boolean;
75
+ }>;
76
+ /** Reads one queue (`GetQueue`). The `default` queue reads as unlimited until it is set. */
77
+ getQueue(ref: QueueRef, signal?: AbortSignal): Promise<Queue>;
78
+ /** Lists this product's queues (`ListQueues`), by priority then name. */
79
+ listQueues(input?: {
80
+ tenant?: string;
81
+ cursor?: string;
82
+ limit?: number;
83
+ }, signal?: AbortSignal): Promise<{
84
+ queues: Queue[];
85
+ nextCursor: string;
86
+ }>;
87
+ /** Pauses a queue (`MarkQueuePaused`): it accepts jobs and starts none. Idempotent. */
88
+ pauseQueue(queueId: string, reason?: string, signal?: AbortSignal): Promise<Queue>;
89
+ /** Resumes a paused queue (`MarkQueueResumed`). Idempotent. */
90
+ resumeQueue(queueId: string, signal?: AbortSignal): Promise<Queue>;
91
+ /** How a queue is doing now (`GetQueueStats`). */
92
+ getQueueStats(queueId: string, input?: {
93
+ windowMs?: number;
94
+ topTenants?: number;
95
+ }, signal?: AbortSignal): Promise<GetQueueStatsResponse>;
96
+ /**
97
+ * Lists the jobs that went through a queue (`ListQueueJobs`), newest
98
+ * first. With `states: [RunState.FAILED]` it lists the dead letters.
99
+ */
100
+ listQueueJobs(queueId: string, input?: {
101
+ tenant?: string;
102
+ states?: RunState[];
103
+ cursor?: string;
104
+ limit?: number;
105
+ }, signal?: AbortSignal): Promise<{
106
+ runs: Run[];
107
+ nextCursor: string;
108
+ }>;
109
+ /**
110
+ * Deletes a queue (`DeleteQueue`). Refused while jobs wait unless
111
+ * `cancelWaiting`. Returns how many jobs were cancelled.
112
+ */
113
+ deleteQueue(queueId: string, input?: {
114
+ cancelWaiting?: boolean;
115
+ }, signal?: AbortSignal): Promise<number>;
116
+ /**
117
+ * Enqueues a dead letter again: `RetryNode` on the job's run, node `job`.
118
+ * The new attempt is offered on the job's queue under its settings now.
119
+ */
120
+ requeueJob(runId: string, signal?: AbortSignal): Promise<Run>;
121
+ private opts;
122
+ }
123
+ /**
124
+ * Declares a product's queues, typically at start: `SetQueue` for each,
125
+ * replacing every writable field, so the code is the source of truth and
126
+ * repeating it changes nothing. A queue's pause survives.
127
+ */
128
+ export declare function declareQueues(client: QueuesClient, decls: readonly QueueDecl[], signal?: AbortSignal): Promise<Queue[]>;
129
+ /** The SetQueue message for a declaration. */
130
+ export declare function queueInit(product: string, d: QueueDecl): {
131
+ priority: number;
132
+ defaultTimeout?: import("@bufbuild/protobuf/wkt").Duration;
133
+ defaultRetry?: import("./gen/xeonr/pipelines/v1/definition_pb.js").Retry | {
134
+ readonly $typeName?: never;
135
+ max?: number;
136
+ when?: import("./gen/xeonr/pipelines/v1/common_pb.js").FailureClass[];
137
+ backoff?: (import("./gen/xeonr/pipelines/v1/definition_pb.js").Backoff | {
138
+ readonly $typeName?: never;
139
+ initial?: (import("@bufbuild/protobuf/wkt").Duration | {
140
+ readonly $typeName?: never;
141
+ seconds?: bigint;
142
+ nanos?: number;
143
+ }) | undefined;
144
+ max?: (import("@bufbuild/protobuf/wkt").Duration | {
145
+ readonly $typeName?: never;
146
+ seconds?: bigint;
147
+ nanos?: number;
148
+ }) | undefined;
149
+ multiplier?: number;
150
+ }) | undefined;
151
+ };
152
+ rateLimit?: {
153
+ limit: number;
154
+ window: import("@bufbuild/protobuf/wkt").Duration;
155
+ };
156
+ owner: {
157
+ product: string;
158
+ tenant: string;
159
+ };
160
+ name: string;
161
+ description: string;
162
+ maxConcurrency: number;
163
+ maxConcurrencyPerTenant: number;
164
+ };
165
+ /**
166
+ * The product (Auth application id) a bearer token is for, read from its
167
+ * `urn:xeonr:auth:application_id` claim without verifying it: the caller's
168
+ * own token, to name its own product. Undefined when the token carries none.
169
+ */
170
+ export declare function productFromToken(token: string): string | undefined;
171
+ //# sourceMappingURL=queues.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"queues.d.ts","sourceRoot":"","sources":["../src/queues.ts"],"names":[],"mappings":"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"}
package/dist/queues.js ADDED
@@ -0,0 +1,135 @@
1
+ import { durationFromMs } from "@bufbuild/protobuf/wkt";
2
+ import { createClient } from "@connectrpc/connect";
3
+ import { QueuesService } from "./gen/xeonr/pipelines/v1/queues_pb.js";
4
+ import { RunsService } from "./gen/xeonr/pipelines/v1/runs_pb.js";
5
+ import { transportOf } from "./transport.js";
6
+ /**
7
+ * The client for `QueuesService`: the lanes a product's jobs are admitted
8
+ * through, with their limits and fairness. Needs `pipelines:queue:edit` to
9
+ * change queues and `pipelines:queue:read` to read them.
10
+ *
11
+ * Jobs name a queue with `PipelinesClient.createJob({ queue })`; a job with
12
+ * none goes to the product's `default` queue.
13
+ */
14
+ export class QueuesClient {
15
+ /** The generated client, for anything not wrapped here. */
16
+ queues;
17
+ runs;
18
+ product;
19
+ timeoutMs;
20
+ constructor(opts) {
21
+ const transport = transportOf(opts);
22
+ this.queues = createClient(QueuesService, transport);
23
+ this.runs = createClient(RunsService, transport);
24
+ if (!opts.product)
25
+ throw new TypeError("QueuesClient: product is required");
26
+ this.product = opts.product;
27
+ this.timeoutMs = opts.timeoutMs ?? 30_000;
28
+ }
29
+ /**
30
+ * Sets a queue (`SetQueue`): creates it, or replaces every writable field
31
+ * of the one with that owner and name. Pause and resume are separate.
32
+ */
33
+ async setQueue(decl, signal) {
34
+ const res = await this.queues.setQueue({ queue: queueInit(this.product, decl) }, this.opts(signal));
35
+ return { queue: required(res.queue), created: res.created };
36
+ }
37
+ /** Reads one queue (`GetQueue`). The `default` queue reads as unlimited until it is set. */
38
+ async getQueue(ref, signal) {
39
+ const queue = "id" in ref
40
+ ? { case: "queueId", value: ref.id }
41
+ : { case: "byName", value: { owner: { product: this.product, tenant: ref.tenant ?? "" }, name: ref.name } };
42
+ return required((await this.queues.getQueue({ queue }, this.opts(signal))).queue);
43
+ }
44
+ /** Lists this product's queues (`ListQueues`), by priority then name. */
45
+ async listQueues(input = {}, signal) {
46
+ const res = await this.queues.listQueues({ product: this.product, tenant: input.tenant ?? "", cursor: input.cursor ?? "", limit: input.limit ?? 0 }, this.opts(signal));
47
+ return { queues: res.queues, nextCursor: res.nextCursor };
48
+ }
49
+ /** Pauses a queue (`MarkQueuePaused`): it accepts jobs and starts none. Idempotent. */
50
+ async pauseQueue(queueId, reason = "", signal) {
51
+ return required((await this.queues.markQueuePaused({ queueId, reason }, this.opts(signal))).queue);
52
+ }
53
+ /** Resumes a paused queue (`MarkQueueResumed`). Idempotent. */
54
+ async resumeQueue(queueId, signal) {
55
+ return required((await this.queues.markQueueResumed({ queueId }, this.opts(signal))).queue);
56
+ }
57
+ /** How a queue is doing now (`GetQueueStats`). */
58
+ async getQueueStats(queueId, input = {}, signal) {
59
+ return this.queues.getQueueStats({ queueId, ...(input.windowMs ? { window: durationFromMs(input.windowMs) } : {}), topTenants: input.topTenants ?? 0 }, this.opts(signal));
60
+ }
61
+ /**
62
+ * Lists the jobs that went through a queue (`ListQueueJobs`), newest
63
+ * first. With `states: [RunState.FAILED]` it lists the dead letters.
64
+ */
65
+ async listQueueJobs(queueId, input = {}, signal) {
66
+ const res = await this.queues.listQueueJobs({ queueId, tenant: input.tenant ?? "", states: input.states ?? [], cursor: input.cursor ?? "", limit: input.limit ?? 0 }, this.opts(signal));
67
+ return { runs: res.runs, nextCursor: res.nextCursor };
68
+ }
69
+ /**
70
+ * Deletes a queue (`DeleteQueue`). Refused while jobs wait unless
71
+ * `cancelWaiting`. Returns how many jobs were cancelled.
72
+ */
73
+ async deleteQueue(queueId, input = {}, signal) {
74
+ return (await this.queues.deleteQueue({ queueId, cancelWaiting: input.cancelWaiting ?? false }, this.opts(signal))).cancelledJobs;
75
+ }
76
+ /**
77
+ * Enqueues a dead letter again: `RetryNode` on the job's run, node `job`.
78
+ * The new attempt is offered on the job's queue under its settings now.
79
+ */
80
+ async requeueJob(runId, signal) {
81
+ return required((await this.runs.retryNode({ runId, nodeId: "job" }, this.opts(signal))).run);
82
+ }
83
+ opts(signal) {
84
+ return { timeoutMs: this.timeoutMs, ...(signal ? { signal } : {}) };
85
+ }
86
+ }
87
+ /**
88
+ * Declares a product's queues, typically at start: `SetQueue` for each,
89
+ * replacing every writable field, so the code is the source of truth and
90
+ * repeating it changes nothing. A queue's pause survives.
91
+ */
92
+ export async function declareQueues(client, decls, signal) {
93
+ const out = [];
94
+ for (const d of decls)
95
+ out.push((await client.setQueue(d, signal)).queue);
96
+ return out;
97
+ }
98
+ /** The SetQueue message for a declaration. */
99
+ export function queueInit(product, d) {
100
+ return {
101
+ owner: { product, tenant: d.tenant ?? "" },
102
+ name: d.name,
103
+ description: d.description ?? "",
104
+ maxConcurrency: d.maxConcurrency ?? 0,
105
+ maxConcurrencyPerTenant: d.maxConcurrencyPerTenant ?? 0,
106
+ ...(d.rateLimit ? { rateLimit: { limit: d.rateLimit.limit, window: durationFromMs(d.rateLimit.windowMs) } } : {}),
107
+ ...(d.defaultRetry ? { defaultRetry: d.defaultRetry } : {}),
108
+ ...(d.defaultTimeoutMs ? { defaultTimeout: durationFromMs(d.defaultTimeoutMs) } : {}),
109
+ priority: d.priority ?? 0,
110
+ };
111
+ }
112
+ /**
113
+ * The product (Auth application id) a bearer token is for, read from its
114
+ * `urn:xeonr:auth:application_id` claim without verifying it: the caller's
115
+ * own token, to name its own product. Undefined when the token carries none.
116
+ */
117
+ export function productFromToken(token) {
118
+ const payload = token.split(".")[1];
119
+ if (!payload)
120
+ return undefined;
121
+ try {
122
+ const claims = JSON.parse(Buffer.from(payload, "base64url").toString("utf8"));
123
+ const app = claims["urn:xeonr:auth:application_id"];
124
+ return typeof app === "string" && app ? app : undefined;
125
+ }
126
+ catch {
127
+ return undefined;
128
+ }
129
+ }
130
+ function required(v) {
131
+ if (v === undefined)
132
+ throw new Error("pipelines-api answered without the queue");
133
+ return v;
134
+ }
135
+ //# sourceMappingURL=queues.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"queues.js","sourceRoot":"","sources":["../src/queues.ts"],"names":[],"mappings":"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"}