@loams/live 0.0.0-stage → 0.1.0-preview.2
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/LICENSE +202 -0
- package/README.md +55 -2
- package/dist/gen/loams/live/v1/admin_pb.d.ts +746 -0
- package/dist/gen/loams/live/v1/admin_pb.js +293 -0
- package/dist/gen/loams/live/v1/live_pb.d.ts +742 -0
- package/dist/gen/loams/live/v1/live_pb.js +239 -0
- package/dist/gen/loams/live/v1/value_pb.d.ts +155 -0
- package/dist/gen/loams/live/v1/value_pb.js +36 -0
- package/dist/gen/loams/options/v1/options_pb.d.ts +97 -0
- package/dist/gen/loams/options/v1/options_pb.js +47 -0
- package/dist/index.d.ts +5 -0
- package/dist/index.js +18 -0
- package/dist/live.d.ts +2 -0
- package/dist/live.js +7 -0
- package/package.json +50 -4
|
@@ -0,0 +1,746 @@
|
|
|
1
|
+
import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
|
|
2
|
+
import type { Schema, Validator } from "./live_pb.js";
|
|
3
|
+
import type { Message } from "@bufbuild/protobuf";
|
|
4
|
+
/**
|
|
5
|
+
* Describes the file loams/live/v1/admin.proto.
|
|
6
|
+
*/
|
|
7
|
+
export declare const file_loams_live_v1_admin: GenFile;
|
|
8
|
+
/**
|
|
9
|
+
* A deployment as the admin API shows it (the catalog's record without the
|
|
10
|
+
* schema, which `GetDeployment` returns).
|
|
11
|
+
*
|
|
12
|
+
* @generated from message loams.live.v1.Deployment
|
|
13
|
+
*/
|
|
14
|
+
export type Deployment = Message<"loams.live.v1.Deployment"> & {
|
|
15
|
+
/**
|
|
16
|
+
* A ULID.
|
|
17
|
+
*
|
|
18
|
+
* @generated from field: string id = 1;
|
|
19
|
+
*/
|
|
20
|
+
id: string;
|
|
21
|
+
/**
|
|
22
|
+
* The bundle's SHA-256, lowercase hex.
|
|
23
|
+
*
|
|
24
|
+
* @generated from field: string bundle_sha256 = 2;
|
|
25
|
+
*/
|
|
26
|
+
bundleSha256: string;
|
|
27
|
+
/**
|
|
28
|
+
* The TSO physical time of the deploy's first transaction, in ms.
|
|
29
|
+
*
|
|
30
|
+
* @generated from field: uint64 created_at_ms = 3;
|
|
31
|
+
*/
|
|
32
|
+
createdAtMs: bigint;
|
|
33
|
+
/**
|
|
34
|
+
* The principal that deployed it (an id, never a credential).
|
|
35
|
+
*
|
|
36
|
+
* @generated from field: string created_by = 4;
|
|
37
|
+
*/
|
|
38
|
+
createdBy: string;
|
|
39
|
+
/**
|
|
40
|
+
* @generated from field: string message = 5;
|
|
41
|
+
*/
|
|
42
|
+
message: string;
|
|
43
|
+
/**
|
|
44
|
+
* The deployment that was active when this one was deployed; empty for
|
|
45
|
+
* the app's first.
|
|
46
|
+
*
|
|
47
|
+
* @generated from field: string parent = 6;
|
|
48
|
+
*/
|
|
49
|
+
parent: string;
|
|
50
|
+
/**
|
|
51
|
+
* @generated from field: loams.live.v1.DeploymentState state = 7;
|
|
52
|
+
*/
|
|
53
|
+
state: DeploymentState;
|
|
54
|
+
/**
|
|
55
|
+
* Why it failed, when `state` is `DEPLOYMENT_STATE_FAILED`.
|
|
56
|
+
*
|
|
57
|
+
* @generated from field: string failure_reason = 8;
|
|
58
|
+
*/
|
|
59
|
+
failureReason: string;
|
|
60
|
+
};
|
|
61
|
+
/**
|
|
62
|
+
* Describes the message loams.live.v1.Deployment.
|
|
63
|
+
* Use `create(DeploymentSchema)` to create a new message.
|
|
64
|
+
*/
|
|
65
|
+
export declare const DeploymentSchema: GenMessage<Deployment>;
|
|
66
|
+
/**
|
|
67
|
+
* A function a deployment exports (§45 §3.4).
|
|
68
|
+
*
|
|
69
|
+
* @generated from message loams.live.v1.FunctionInfo
|
|
70
|
+
*/
|
|
71
|
+
export type FunctionInfo = Message<"loams.live.v1.FunctionInfo"> & {
|
|
72
|
+
/**
|
|
73
|
+
* `module:export`.
|
|
74
|
+
*
|
|
75
|
+
* @generated from field: string path = 1;
|
|
76
|
+
*/
|
|
77
|
+
path: string;
|
|
78
|
+
/**
|
|
79
|
+
* @generated from field: loams.live.v1.FunctionKind kind = 2;
|
|
80
|
+
*/
|
|
81
|
+
kind: FunctionKind;
|
|
82
|
+
/**
|
|
83
|
+
* @generated from field: loams.live.v1.FunctionVisibility visibility = 3;
|
|
84
|
+
*/
|
|
85
|
+
visibility: FunctionVisibility;
|
|
86
|
+
/**
|
|
87
|
+
* The arguments' validator; absent: any arguments.
|
|
88
|
+
*
|
|
89
|
+
* @generated from field: loams.live.v1.Validator args = 4;
|
|
90
|
+
*/
|
|
91
|
+
args?: Validator | undefined;
|
|
92
|
+
};
|
|
93
|
+
/**
|
|
94
|
+
* Describes the message loams.live.v1.FunctionInfo.
|
|
95
|
+
* Use `create(FunctionInfoSchema)` to create a new message.
|
|
96
|
+
*/
|
|
97
|
+
export declare const FunctionInfoSchema: GenMessage<FunctionInfo>;
|
|
98
|
+
/**
|
|
99
|
+
* @generated from message loams.live.v1.DeployRequest
|
|
100
|
+
*/
|
|
101
|
+
export type DeployRequest = Message<"loams.live.v1.DeployRequest"> & {
|
|
102
|
+
/**
|
|
103
|
+
* One ES module (§20 §6).
|
|
104
|
+
*
|
|
105
|
+
* @generated from field: bytes bundle = 1;
|
|
106
|
+
*/
|
|
107
|
+
bundle: Uint8Array;
|
|
108
|
+
/**
|
|
109
|
+
* @generated from field: loams.live.v1.Schema schema = 2;
|
|
110
|
+
*/
|
|
111
|
+
schema?: Schema | undefined;
|
|
112
|
+
/**
|
|
113
|
+
* The deployment the client built against: the active one when it read
|
|
114
|
+
* the app. Absent means the app has no active deployment.
|
|
115
|
+
*
|
|
116
|
+
* @generated from field: optional string expected_active = 3;
|
|
117
|
+
*/
|
|
118
|
+
expectedActive?: string | undefined;
|
|
119
|
+
/**
|
|
120
|
+
* A note for the record, such as a commit message.
|
|
121
|
+
*
|
|
122
|
+
* @generated from field: string message = 4;
|
|
123
|
+
*/
|
|
124
|
+
message: string;
|
|
125
|
+
/**
|
|
126
|
+
* Validate the bundle and plan the schema changes, writing nothing.
|
|
127
|
+
*
|
|
128
|
+
* @generated from field: bool dry_run = 5;
|
|
129
|
+
*/
|
|
130
|
+
dryRun: boolean;
|
|
131
|
+
};
|
|
132
|
+
/**
|
|
133
|
+
* Describes the message loams.live.v1.DeployRequest.
|
|
134
|
+
* Use `create(DeployRequestSchema)` to create a new message.
|
|
135
|
+
*/
|
|
136
|
+
export declare const DeployRequestSchema: GenMessage<DeployRequest>;
|
|
137
|
+
/**
|
|
138
|
+
* @generated from message loams.live.v1.DeployResponse
|
|
139
|
+
*/
|
|
140
|
+
export type DeployResponse = Message<"loams.live.v1.DeployResponse"> & {
|
|
141
|
+
/**
|
|
142
|
+
* The new deployment (in a dry run, the record it would write, still
|
|
143
|
+
* `DEPLOYMENT_STATE_PENDING`).
|
|
144
|
+
*
|
|
145
|
+
* @generated from field: loams.live.v1.Deployment deployment = 1;
|
|
146
|
+
*/
|
|
147
|
+
deployment?: Deployment | undefined;
|
|
148
|
+
/**
|
|
149
|
+
* @generated from field: loams.live.v1.SchemaChanges changes = 2;
|
|
150
|
+
*/
|
|
151
|
+
changes?: SchemaChanges | undefined;
|
|
152
|
+
};
|
|
153
|
+
/**
|
|
154
|
+
* Describes the message loams.live.v1.DeployResponse.
|
|
155
|
+
* Use `create(DeployResponseSchema)` to create a new message.
|
|
156
|
+
*/
|
|
157
|
+
export declare const DeployResponseSchema: GenMessage<DeployResponse>;
|
|
158
|
+
/**
|
|
159
|
+
* What applying a schema changed (or, in a dry run, would change).
|
|
160
|
+
*
|
|
161
|
+
* @generated from message loams.live.v1.SchemaChanges
|
|
162
|
+
*/
|
|
163
|
+
export type SchemaChanges = Message<"loams.live.v1.SchemaChanges"> & {
|
|
164
|
+
/**
|
|
165
|
+
* The tables it created.
|
|
166
|
+
*
|
|
167
|
+
* @generated from field: repeated string tables_created = 1;
|
|
168
|
+
*/
|
|
169
|
+
tablesCreated: string[];
|
|
170
|
+
/**
|
|
171
|
+
* The existing tables whose validator it changed.
|
|
172
|
+
*
|
|
173
|
+
* @generated from field: repeated string validators_changed = 2;
|
|
174
|
+
*/
|
|
175
|
+
validatorsChanged: string[];
|
|
176
|
+
/**
|
|
177
|
+
* Of those, the ones whose documents it checked against a stricter
|
|
178
|
+
* validator first.
|
|
179
|
+
*
|
|
180
|
+
* @generated from field: repeated string tables_validated = 3;
|
|
181
|
+
*/
|
|
182
|
+
tablesValidated: string[];
|
|
183
|
+
/**
|
|
184
|
+
* The indexes of existing tables it added (backfilled first).
|
|
185
|
+
*
|
|
186
|
+
* @generated from field: repeated loams.live.v1.IndexRef indexes_added = 4;
|
|
187
|
+
*/
|
|
188
|
+
indexesAdded: IndexRef[];
|
|
189
|
+
/**
|
|
190
|
+
* The indexes of existing tables it dropped.
|
|
191
|
+
*
|
|
192
|
+
* @generated from field: repeated loams.live.v1.IndexRef indexes_dropped = 5;
|
|
193
|
+
*/
|
|
194
|
+
indexesDropped: IndexRef[];
|
|
195
|
+
};
|
|
196
|
+
/**
|
|
197
|
+
* Describes the message loams.live.v1.SchemaChanges.
|
|
198
|
+
* Use `create(SchemaChangesSchema)` to create a new message.
|
|
199
|
+
*/
|
|
200
|
+
export declare const SchemaChangesSchema: GenMessage<SchemaChanges>;
|
|
201
|
+
/**
|
|
202
|
+
* @generated from message loams.live.v1.IndexRef
|
|
203
|
+
*/
|
|
204
|
+
export type IndexRef = Message<"loams.live.v1.IndexRef"> & {
|
|
205
|
+
/**
|
|
206
|
+
* @generated from field: string table = 1;
|
|
207
|
+
*/
|
|
208
|
+
table: string;
|
|
209
|
+
/**
|
|
210
|
+
* @generated from field: string index = 2;
|
|
211
|
+
*/
|
|
212
|
+
index: string;
|
|
213
|
+
};
|
|
214
|
+
/**
|
|
215
|
+
* Describes the message loams.live.v1.IndexRef.
|
|
216
|
+
* Use `create(IndexRefSchema)` to create a new message.
|
|
217
|
+
*/
|
|
218
|
+
export declare const IndexRefSchema: GenMessage<IndexRef>;
|
|
219
|
+
/**
|
|
220
|
+
* @generated from message loams.live.v1.ListDeploymentsRequest
|
|
221
|
+
*/
|
|
222
|
+
export type ListDeploymentsRequest = Message<"loams.live.v1.ListDeploymentsRequest"> & {
|
|
223
|
+
/**
|
|
224
|
+
* AIP-158 page size: 100 when 0, at most 1 000.
|
|
225
|
+
*
|
|
226
|
+
* @generated from field: int32 page_size = 1;
|
|
227
|
+
*/
|
|
228
|
+
pageSize: number;
|
|
229
|
+
/**
|
|
230
|
+
* The `next_page_token` of the previous page; empty starts at the newest.
|
|
231
|
+
*
|
|
232
|
+
* @generated from field: string page_token = 2;
|
|
233
|
+
*/
|
|
234
|
+
pageToken: string;
|
|
235
|
+
};
|
|
236
|
+
/**
|
|
237
|
+
* Describes the message loams.live.v1.ListDeploymentsRequest.
|
|
238
|
+
* Use `create(ListDeploymentsRequestSchema)` to create a new message.
|
|
239
|
+
*/
|
|
240
|
+
export declare const ListDeploymentsRequestSchema: GenMessage<ListDeploymentsRequest>;
|
|
241
|
+
/**
|
|
242
|
+
* @generated from message loams.live.v1.ListDeploymentsResponse
|
|
243
|
+
*/
|
|
244
|
+
export type ListDeploymentsResponse = Message<"loams.live.v1.ListDeploymentsResponse"> & {
|
|
245
|
+
/**
|
|
246
|
+
* Newest first.
|
|
247
|
+
*
|
|
248
|
+
* @generated from field: repeated loams.live.v1.Deployment deployments = 1;
|
|
249
|
+
*/
|
|
250
|
+
deployments: Deployment[];
|
|
251
|
+
/**
|
|
252
|
+
* Empty on the last page.
|
|
253
|
+
*
|
|
254
|
+
* @generated from field: string next_page_token = 2;
|
|
255
|
+
*/
|
|
256
|
+
nextPageToken: string;
|
|
257
|
+
};
|
|
258
|
+
/**
|
|
259
|
+
* Describes the message loams.live.v1.ListDeploymentsResponse.
|
|
260
|
+
* Use `create(ListDeploymentsResponseSchema)` to create a new message.
|
|
261
|
+
*/
|
|
262
|
+
export declare const ListDeploymentsResponseSchema: GenMessage<ListDeploymentsResponse>;
|
|
263
|
+
/**
|
|
264
|
+
* @generated from message loams.live.v1.GetDeploymentRequest
|
|
265
|
+
*/
|
|
266
|
+
export type GetDeploymentRequest = Message<"loams.live.v1.GetDeploymentRequest"> & {
|
|
267
|
+
/**
|
|
268
|
+
* @generated from field: string id = 1;
|
|
269
|
+
*/
|
|
270
|
+
id: string;
|
|
271
|
+
};
|
|
272
|
+
/**
|
|
273
|
+
* Describes the message loams.live.v1.GetDeploymentRequest.
|
|
274
|
+
* Use `create(GetDeploymentRequestSchema)` to create a new message.
|
|
275
|
+
*/
|
|
276
|
+
export declare const GetDeploymentRequestSchema: GenMessage<GetDeploymentRequest>;
|
|
277
|
+
/**
|
|
278
|
+
* @generated from message loams.live.v1.GetDeploymentResponse
|
|
279
|
+
*/
|
|
280
|
+
export type GetDeploymentResponse = Message<"loams.live.v1.GetDeploymentResponse"> & {
|
|
281
|
+
/**
|
|
282
|
+
* @generated from field: loams.live.v1.Deployment deployment = 1;
|
|
283
|
+
*/
|
|
284
|
+
deployment?: Deployment | undefined;
|
|
285
|
+
/**
|
|
286
|
+
* The schema it declares.
|
|
287
|
+
*
|
|
288
|
+
* @generated from field: loams.live.v1.Schema schema = 2;
|
|
289
|
+
*/
|
|
290
|
+
schema?: Schema | undefined;
|
|
291
|
+
/**
|
|
292
|
+
* The functions its bundle exports, by path. Empty for a deployment made
|
|
293
|
+
* before the server recorded them (LV1 Task 10).
|
|
294
|
+
*
|
|
295
|
+
* @generated from field: repeated loams.live.v1.FunctionInfo functions = 3;
|
|
296
|
+
*/
|
|
297
|
+
functions: FunctionInfo[];
|
|
298
|
+
};
|
|
299
|
+
/**
|
|
300
|
+
* Describes the message loams.live.v1.GetDeploymentResponse.
|
|
301
|
+
* Use `create(GetDeploymentResponseSchema)` to create a new message.
|
|
302
|
+
*/
|
|
303
|
+
export declare const GetDeploymentResponseSchema: GenMessage<GetDeploymentResponse>;
|
|
304
|
+
/**
|
|
305
|
+
* @generated from message loams.live.v1.ActivateDeploymentRequest
|
|
306
|
+
*/
|
|
307
|
+
export type ActivateDeploymentRequest = Message<"loams.live.v1.ActivateDeploymentRequest"> & {
|
|
308
|
+
/**
|
|
309
|
+
* @generated from field: string id = 1;
|
|
310
|
+
*/
|
|
311
|
+
id: string;
|
|
312
|
+
/**
|
|
313
|
+
* The active deployment the client saw. Absent means the app has none.
|
|
314
|
+
*
|
|
315
|
+
* @generated from field: optional string expected_active = 2;
|
|
316
|
+
*/
|
|
317
|
+
expectedActive?: string | undefined;
|
|
318
|
+
};
|
|
319
|
+
/**
|
|
320
|
+
* Describes the message loams.live.v1.ActivateDeploymentRequest.
|
|
321
|
+
* Use `create(ActivateDeploymentRequestSchema)` to create a new message.
|
|
322
|
+
*/
|
|
323
|
+
export declare const ActivateDeploymentRequestSchema: GenMessage<ActivateDeploymentRequest>;
|
|
324
|
+
/**
|
|
325
|
+
* @generated from message loams.live.v1.ActivateDeploymentResponse
|
|
326
|
+
*/
|
|
327
|
+
export type ActivateDeploymentResponse = Message<"loams.live.v1.ActivateDeploymentResponse"> & {
|
|
328
|
+
/**
|
|
329
|
+
* The deployment, now active.
|
|
330
|
+
*
|
|
331
|
+
* @generated from field: loams.live.v1.Deployment deployment = 1;
|
|
332
|
+
*/
|
|
333
|
+
deployment?: Deployment | undefined;
|
|
334
|
+
/**
|
|
335
|
+
* @generated from field: loams.live.v1.SchemaChanges changes = 2;
|
|
336
|
+
*/
|
|
337
|
+
changes?: SchemaChanges | undefined;
|
|
338
|
+
};
|
|
339
|
+
/**
|
|
340
|
+
* Describes the message loams.live.v1.ActivateDeploymentResponse.
|
|
341
|
+
* Use `create(ActivateDeploymentResponseSchema)` to create a new message.
|
|
342
|
+
*/
|
|
343
|
+
export declare const ActivateDeploymentResponseSchema: GenMessage<ActivateDeploymentResponse>;
|
|
344
|
+
/**
|
|
345
|
+
* @generated from message loams.live.v1.GetIndexStatusRequest
|
|
346
|
+
*/
|
|
347
|
+
export type GetIndexStatusRequest = Message<"loams.live.v1.GetIndexStatusRequest"> & {
|
|
348
|
+
/**
|
|
349
|
+
* @generated from field: string table = 1;
|
|
350
|
+
*/
|
|
351
|
+
table: string;
|
|
352
|
+
/**
|
|
353
|
+
* @generated from field: string index = 2;
|
|
354
|
+
*/
|
|
355
|
+
index: string;
|
|
356
|
+
};
|
|
357
|
+
/**
|
|
358
|
+
* Describes the message loams.live.v1.GetIndexStatusRequest.
|
|
359
|
+
* Use `create(GetIndexStatusRequestSchema)` to create a new message.
|
|
360
|
+
*/
|
|
361
|
+
export declare const GetIndexStatusRequestSchema: GenMessage<GetIndexStatusRequest>;
|
|
362
|
+
/**
|
|
363
|
+
* @generated from message loams.live.v1.GetIndexStatusResponse
|
|
364
|
+
*/
|
|
365
|
+
export type GetIndexStatusResponse = Message<"loams.live.v1.GetIndexStatusResponse"> & {
|
|
366
|
+
/**
|
|
367
|
+
* @generated from field: loams.live.v1.IndexState state = 1;
|
|
368
|
+
*/
|
|
369
|
+
state: IndexState;
|
|
370
|
+
/**
|
|
371
|
+
* Documents the backfill has written entries for (every document, once
|
|
372
|
+
* the index is ready).
|
|
373
|
+
*
|
|
374
|
+
* @generated from field: uint64 done = 2;
|
|
375
|
+
*/
|
|
376
|
+
done: bigint;
|
|
377
|
+
/**
|
|
378
|
+
* The table's documents now.
|
|
379
|
+
*
|
|
380
|
+
* @generated from field: uint64 total_estimate = 3;
|
|
381
|
+
*/
|
|
382
|
+
totalEstimate: bigint;
|
|
383
|
+
};
|
|
384
|
+
/**
|
|
385
|
+
* Describes the message loams.live.v1.GetIndexStatusResponse.
|
|
386
|
+
* Use `create(GetIndexStatusResponseSchema)` to create a new message.
|
|
387
|
+
*/
|
|
388
|
+
export declare const GetIndexStatusResponseSchema: GenMessage<GetIndexStatusResponse>;
|
|
389
|
+
/**
|
|
390
|
+
* @generated from message loams.live.v1.TailLogsRequest
|
|
391
|
+
*/
|
|
392
|
+
export type TailLogsRequest = Message<"loams.live.v1.TailLogsRequest"> & {
|
|
393
|
+
/**
|
|
394
|
+
* Keep the stream open and send new lines as functions write them.
|
|
395
|
+
*
|
|
396
|
+
* @generated from field: bool follow = 1;
|
|
397
|
+
*/
|
|
398
|
+
follow: boolean;
|
|
399
|
+
/**
|
|
400
|
+
* Only lines written at or after this Unix time, in ms.
|
|
401
|
+
*
|
|
402
|
+
* @generated from field: optional uint64 since_ms = 2;
|
|
403
|
+
*/
|
|
404
|
+
sinceMs?: bigint | undefined;
|
|
405
|
+
/**
|
|
406
|
+
* Only lines of this function (`module:export`).
|
|
407
|
+
*
|
|
408
|
+
* @generated from field: optional string function = 3;
|
|
409
|
+
*/
|
|
410
|
+
function?: string | undefined;
|
|
411
|
+
};
|
|
412
|
+
/**
|
|
413
|
+
* Describes the message loams.live.v1.TailLogsRequest.
|
|
414
|
+
* Use `create(TailLogsRequestSchema)` to create a new message.
|
|
415
|
+
*/
|
|
416
|
+
export declare const TailLogsRequestSchema: GenMessage<TailLogsRequest>;
|
|
417
|
+
/**
|
|
418
|
+
* @generated from message loams.live.v1.TailLogsResponse
|
|
419
|
+
*/
|
|
420
|
+
export type TailLogsResponse = Message<"loams.live.v1.TailLogsResponse"> & {
|
|
421
|
+
/**
|
|
422
|
+
* Oldest first. Empty while following: a heartbeat every 15 s.
|
|
423
|
+
*
|
|
424
|
+
* @generated from field: repeated loams.live.v1.LogEntry entries = 1;
|
|
425
|
+
*/
|
|
426
|
+
entries: LogEntry[];
|
|
427
|
+
/**
|
|
428
|
+
* Lines this stream missed before these entries: the node's buffer
|
|
429
|
+
* (10 000 lines per app) overwrote them before the stream read them.
|
|
430
|
+
*
|
|
431
|
+
* @generated from field: uint64 skipped = 2;
|
|
432
|
+
*/
|
|
433
|
+
skipped: bigint;
|
|
434
|
+
};
|
|
435
|
+
/**
|
|
436
|
+
* Describes the message loams.live.v1.TailLogsResponse.
|
|
437
|
+
* Use `create(TailLogsResponseSchema)` to create a new message.
|
|
438
|
+
*/
|
|
439
|
+
export declare const TailLogsResponseSchema: GenMessage<TailLogsResponse>;
|
|
440
|
+
/**
|
|
441
|
+
* One line a function wrote with `console.*`, or the error a call ended
|
|
442
|
+
* with. A line holds only what the function wrote (cut to 4 KiB); the
|
|
443
|
+
* server adds no arguments, results, documents or credentials.
|
|
444
|
+
*
|
|
445
|
+
* @generated from message loams.live.v1.LogEntry
|
|
446
|
+
*/
|
|
447
|
+
export type LogEntry = Message<"loams.live.v1.LogEntry"> & {
|
|
448
|
+
/**
|
|
449
|
+
* Unix time, in ms, at which the server recorded the line.
|
|
450
|
+
*
|
|
451
|
+
* @generated from field: uint64 ts_ms = 1;
|
|
452
|
+
*/
|
|
453
|
+
tsMs: bigint;
|
|
454
|
+
/**
|
|
455
|
+
* The call's request id, as the `loams-request-id` response header of
|
|
456
|
+
* `Query` and `Mutate` names it. A subscription's evaluation has its own.
|
|
457
|
+
*
|
|
458
|
+
* @generated from field: string request_id = 2;
|
|
459
|
+
*/
|
|
460
|
+
requestId: string;
|
|
461
|
+
/**
|
|
462
|
+
* `module:export`.
|
|
463
|
+
*
|
|
464
|
+
* @generated from field: string function = 3;
|
|
465
|
+
*/
|
|
466
|
+
function: string;
|
|
467
|
+
/**
|
|
468
|
+
* The deployment that ran the call (a ULID); empty for a built-in.
|
|
469
|
+
*
|
|
470
|
+
* @generated from field: string deployment = 4;
|
|
471
|
+
*/
|
|
472
|
+
deployment: string;
|
|
473
|
+
/**
|
|
474
|
+
* @generated from field: loams.live.v1.LogLevel level = 5;
|
|
475
|
+
*/
|
|
476
|
+
level: LogLevel;
|
|
477
|
+
/**
|
|
478
|
+
* @generated from field: string line = 6;
|
|
479
|
+
*/
|
|
480
|
+
line: string;
|
|
481
|
+
/**
|
|
482
|
+
* The line was longer than the per-line limit and was cut.
|
|
483
|
+
*
|
|
484
|
+
* @generated from field: bool truncated = 7;
|
|
485
|
+
*/
|
|
486
|
+
truncated: boolean;
|
|
487
|
+
};
|
|
488
|
+
/**
|
|
489
|
+
* Describes the message loams.live.v1.LogEntry.
|
|
490
|
+
* Use `create(LogEntrySchema)` to create a new message.
|
|
491
|
+
*/
|
|
492
|
+
export declare const LogEntrySchema: GenMessage<LogEntry>;
|
|
493
|
+
/**
|
|
494
|
+
* Where a deployment is in its life (design §45 §3.3). The catalog's
|
|
495
|
+
* records store it too.
|
|
496
|
+
*
|
|
497
|
+
* @generated from enum loams.live.v1.DeploymentState
|
|
498
|
+
*/
|
|
499
|
+
export declare enum DeploymentState {
|
|
500
|
+
/**
|
|
501
|
+
* @generated from enum value: DEPLOYMENT_STATE_UNSPECIFIED = 0;
|
|
502
|
+
*/
|
|
503
|
+
UNSPECIFIED = 0,
|
|
504
|
+
/**
|
|
505
|
+
* Its record is written; its schema is not applied yet.
|
|
506
|
+
*
|
|
507
|
+
* @generated from enum value: DEPLOYMENT_STATE_PENDING = 1;
|
|
508
|
+
*/
|
|
509
|
+
PENDING = 1,
|
|
510
|
+
/**
|
|
511
|
+
* A stricter validator scans existing data (LV1 plan Task 8): it is
|
|
512
|
+
* enforced on new writes, and the table's documents are checked.
|
|
513
|
+
*
|
|
514
|
+
* @generated from enum value: DEPLOYMENT_STATE_VALIDATING = 2;
|
|
515
|
+
*/
|
|
516
|
+
VALIDATING = 2,
|
|
517
|
+
/**
|
|
518
|
+
* A new index is backfilled (LV1 plan Task 9).
|
|
519
|
+
*
|
|
520
|
+
* @generated from enum value: DEPLOYMENT_STATE_BACKFILLING = 3;
|
|
521
|
+
*/
|
|
522
|
+
BACKFILLING = 3,
|
|
523
|
+
/**
|
|
524
|
+
* The pointer names it: new calls run its functions.
|
|
525
|
+
*
|
|
526
|
+
* @generated from enum value: DEPLOYMENT_STATE_ACTIVE = 4;
|
|
527
|
+
*/
|
|
528
|
+
ACTIVE = 4,
|
|
529
|
+
/**
|
|
530
|
+
* A later deployment replaced it.
|
|
531
|
+
*
|
|
532
|
+
* @generated from enum value: DEPLOYMENT_STATE_SUPERSEDED = 5;
|
|
533
|
+
*/
|
|
534
|
+
SUPERSEDED = 5,
|
|
535
|
+
/**
|
|
536
|
+
* It never became active; `failure_reason` says why.
|
|
537
|
+
*
|
|
538
|
+
* @generated from enum value: DEPLOYMENT_STATE_FAILED = 6;
|
|
539
|
+
*/
|
|
540
|
+
FAILED = 6,
|
|
541
|
+
/**
|
|
542
|
+
* It is active, but its isolated workers crashed five times within a
|
|
543
|
+
* minute (design §45 §3.1). Calls are still served.
|
|
544
|
+
*
|
|
545
|
+
* @generated from enum value: DEPLOYMENT_STATE_DEGRADED = 7;
|
|
546
|
+
*/
|
|
547
|
+
DEGRADED = 7
|
|
548
|
+
}
|
|
549
|
+
/**
|
|
550
|
+
* Describes the enum loams.live.v1.DeploymentState.
|
|
551
|
+
*/
|
|
552
|
+
export declare const DeploymentStateSchema: GenEnum<DeploymentState>;
|
|
553
|
+
/**
|
|
554
|
+
* @generated from enum loams.live.v1.FunctionKind
|
|
555
|
+
*/
|
|
556
|
+
export declare enum FunctionKind {
|
|
557
|
+
/**
|
|
558
|
+
* @generated from enum value: FUNCTION_KIND_UNSPECIFIED = 0;
|
|
559
|
+
*/
|
|
560
|
+
UNSPECIFIED = 0,
|
|
561
|
+
/**
|
|
562
|
+
* @generated from enum value: FUNCTION_KIND_QUERY = 1;
|
|
563
|
+
*/
|
|
564
|
+
QUERY = 1,
|
|
565
|
+
/**
|
|
566
|
+
* @generated from enum value: FUNCTION_KIND_MUTATION = 2;
|
|
567
|
+
*/
|
|
568
|
+
MUTATION = 2
|
|
569
|
+
}
|
|
570
|
+
/**
|
|
571
|
+
* Describes the enum loams.live.v1.FunctionKind.
|
|
572
|
+
*/
|
|
573
|
+
export declare const FunctionKindSchema: GenEnum<FunctionKind>;
|
|
574
|
+
/**
|
|
575
|
+
* Who may call a function (D699).
|
|
576
|
+
*
|
|
577
|
+
* @generated from enum loams.live.v1.FunctionVisibility
|
|
578
|
+
*/
|
|
579
|
+
export declare enum FunctionVisibility {
|
|
580
|
+
/**
|
|
581
|
+
* @generated from enum value: FUNCTION_VISIBILITY_UNSPECIFIED = 0;
|
|
582
|
+
*/
|
|
583
|
+
UNSPECIFIED = 0,
|
|
584
|
+
/**
|
|
585
|
+
* `query`, `mutation`: end users and platform principals.
|
|
586
|
+
*
|
|
587
|
+
* @generated from enum value: FUNCTION_VISIBILITY_PUBLIC = 1;
|
|
588
|
+
*/
|
|
589
|
+
PUBLIC = 1,
|
|
590
|
+
/**
|
|
591
|
+
* `internalQuery`, `internalMutation`: platform principals only.
|
|
592
|
+
*
|
|
593
|
+
* @generated from enum value: FUNCTION_VISIBILITY_INTERNAL = 2;
|
|
594
|
+
*/
|
|
595
|
+
INTERNAL = 2
|
|
596
|
+
}
|
|
597
|
+
/**
|
|
598
|
+
* Describes the enum loams.live.v1.FunctionVisibility.
|
|
599
|
+
*/
|
|
600
|
+
export declare const FunctionVisibilitySchema: GenEnum<FunctionVisibility>;
|
|
601
|
+
/**
|
|
602
|
+
* Where a user index is in its life (LV1 plan Task 9, design §45 §4.2). The
|
|
603
|
+
* catalog's index definitions store it too.
|
|
604
|
+
*
|
|
605
|
+
* @generated from enum loams.live.v1.IndexState
|
|
606
|
+
*/
|
|
607
|
+
export declare enum IndexState {
|
|
608
|
+
/**
|
|
609
|
+
* In a catalog record: ready (an index defined before Task 9). The admin
|
|
610
|
+
* API never answers it.
|
|
611
|
+
*
|
|
612
|
+
* @generated from enum value: INDEX_STATE_UNSPECIFIED = 0;
|
|
613
|
+
*/
|
|
614
|
+
UNSPECIFIED = 0,
|
|
615
|
+
/**
|
|
616
|
+
* Every write maintains it and a backfill job writes the entries of the
|
|
617
|
+
* documents already there; no query reads it.
|
|
618
|
+
*
|
|
619
|
+
* @generated from enum value: INDEX_STATE_BACKFILLING = 1;
|
|
620
|
+
*/
|
|
621
|
+
BACKFILLING = 1,
|
|
622
|
+
/**
|
|
623
|
+
* Queries read it; every write maintains it.
|
|
624
|
+
*
|
|
625
|
+
* @generated from enum value: INDEX_STATE_READY = 2;
|
|
626
|
+
*/
|
|
627
|
+
READY = 2,
|
|
628
|
+
/**
|
|
629
|
+
* No write maintains it and no query reads it; its entries are being
|
|
630
|
+
* deleted, then the definition goes.
|
|
631
|
+
*
|
|
632
|
+
* @generated from enum value: INDEX_STATE_DROPPING = 3;
|
|
633
|
+
*/
|
|
634
|
+
DROPPING = 3
|
|
635
|
+
}
|
|
636
|
+
/**
|
|
637
|
+
* Describes the enum loams.live.v1.IndexState.
|
|
638
|
+
*/
|
|
639
|
+
export declare const IndexStateSchema: GenEnum<IndexState>;
|
|
640
|
+
/**
|
|
641
|
+
* @generated from enum loams.live.v1.LogLevel
|
|
642
|
+
*/
|
|
643
|
+
export declare enum LogLevel {
|
|
644
|
+
/**
|
|
645
|
+
* @generated from enum value: LOG_LEVEL_UNSPECIFIED = 0;
|
|
646
|
+
*/
|
|
647
|
+
UNSPECIFIED = 0,
|
|
648
|
+
/**
|
|
649
|
+
* @generated from enum value: LOG_LEVEL_DEBUG = 1;
|
|
650
|
+
*/
|
|
651
|
+
DEBUG = 1,
|
|
652
|
+
/**
|
|
653
|
+
* @generated from enum value: LOG_LEVEL_LOG = 2;
|
|
654
|
+
*/
|
|
655
|
+
LOG = 2,
|
|
656
|
+
/**
|
|
657
|
+
* @generated from enum value: LOG_LEVEL_INFO = 3;
|
|
658
|
+
*/
|
|
659
|
+
INFO = 3,
|
|
660
|
+
/**
|
|
661
|
+
* @generated from enum value: LOG_LEVEL_WARN = 4;
|
|
662
|
+
*/
|
|
663
|
+
WARN = 4,
|
|
664
|
+
/**
|
|
665
|
+
* `console.error`, and the error a call ended with.
|
|
666
|
+
*
|
|
667
|
+
* @generated from enum value: LOG_LEVEL_ERROR = 5;
|
|
668
|
+
*/
|
|
669
|
+
ERROR = 5
|
|
670
|
+
}
|
|
671
|
+
/**
|
|
672
|
+
* Describes the enum loams.live.v1.LogLevel.
|
|
673
|
+
*/
|
|
674
|
+
export declare const LogLevelSchema: GenEnum<LogLevel>;
|
|
675
|
+
/**
|
|
676
|
+
* @generated from service loams.live.v1.LiveAdminService
|
|
677
|
+
*/
|
|
678
|
+
export declare const LiveAdminService: GenService<{
|
|
679
|
+
/**
|
|
680
|
+
* Deploys a function bundle and a schema (§45 §3.3). The deployment
|
|
681
|
+
* activates by compare-and-swap against `expected_active`; a mismatch is
|
|
682
|
+
* FAILED_PRECONDITION, reason `live_deploy_conflict`. The call returns
|
|
683
|
+
* when the deployment is active or failed, which takes as long as its
|
|
684
|
+
* validation scans and index backfills.
|
|
685
|
+
*
|
|
686
|
+
* @generated from rpc loams.live.v1.LiveAdminService.Deploy
|
|
687
|
+
*/
|
|
688
|
+
deploy: {
|
|
689
|
+
methodKind: "unary";
|
|
690
|
+
input: typeof DeployRequestSchema;
|
|
691
|
+
output: typeof DeployResponseSchema;
|
|
692
|
+
};
|
|
693
|
+
/**
|
|
694
|
+
* The app's deployments, newest first.
|
|
695
|
+
*
|
|
696
|
+
* @generated from rpc loams.live.v1.LiveAdminService.ListDeployments
|
|
697
|
+
*/
|
|
698
|
+
listDeployments: {
|
|
699
|
+
methodKind: "unary";
|
|
700
|
+
input: typeof ListDeploymentsRequestSchema;
|
|
701
|
+
output: typeof ListDeploymentsResponseSchema;
|
|
702
|
+
};
|
|
703
|
+
/**
|
|
704
|
+
* One deployment, with its schema and its functions.
|
|
705
|
+
*
|
|
706
|
+
* @generated from rpc loams.live.v1.LiveAdminService.GetDeployment
|
|
707
|
+
*/
|
|
708
|
+
getDeployment: {
|
|
709
|
+
methodKind: "unary";
|
|
710
|
+
input: typeof GetDeploymentRequestSchema;
|
|
711
|
+
output: typeof GetDeploymentResponseSchema;
|
|
712
|
+
};
|
|
713
|
+
/**
|
|
714
|
+
* Activates an existing deployment: a rollback, or a roll forward. It
|
|
715
|
+
* takes the deploy's path with the stored bundle and schema, so the
|
|
716
|
+
* deployment's schema is applied again (§45 §3.3).
|
|
717
|
+
*
|
|
718
|
+
* @generated from rpc loams.live.v1.LiveAdminService.ActivateDeployment
|
|
719
|
+
*/
|
|
720
|
+
activateDeployment: {
|
|
721
|
+
methodKind: "unary";
|
|
722
|
+
input: typeof ActivateDeploymentRequestSchema;
|
|
723
|
+
output: typeof ActivateDeploymentResponseSchema;
|
|
724
|
+
};
|
|
725
|
+
/**
|
|
726
|
+
* The state of an index and its backfill's progress (§45 §4.2).
|
|
727
|
+
*
|
|
728
|
+
* @generated from rpc loams.live.v1.LiveAdminService.GetIndexStatus
|
|
729
|
+
*/
|
|
730
|
+
getIndexStatus: {
|
|
731
|
+
methodKind: "unary";
|
|
732
|
+
input: typeof GetIndexStatusRequestSchema;
|
|
733
|
+
output: typeof GetIndexStatusResponseSchema;
|
|
734
|
+
};
|
|
735
|
+
/**
|
|
736
|
+
* The functions' `console.*` output on this node (§45 §3.3): the lines
|
|
737
|
+
* the node still holds, then, with `follow`, new lines as they come.
|
|
738
|
+
*
|
|
739
|
+
* @generated from rpc loams.live.v1.LiveAdminService.TailLogs
|
|
740
|
+
*/
|
|
741
|
+
tailLogs: {
|
|
742
|
+
methodKind: "server_streaming";
|
|
743
|
+
input: typeof TailLogsRequestSchema;
|
|
744
|
+
output: typeof TailLogsResponseSchema;
|
|
745
|
+
};
|
|
746
|
+
}>;
|