@loams/live 0.0.0-stage → 0.1.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.
@@ -0,0 +1,1225 @@
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
+ * One Live app of the cluster (design §45 §7, D690).
495
+ *
496
+ * @generated from message loams.live.v1.App
497
+ */
498
+ export type App = Message<"loams.live.v1.App"> & {
499
+ /**
500
+ * Cluster-unique and permanent.
501
+ *
502
+ * @generated from field: uint32 id = 1;
503
+ */
504
+ id: number;
505
+ /**
506
+ * Unique among the cluster's apps; the `loams-live-app` header names it.
507
+ *
508
+ * @generated from field: string name = 2;
509
+ */
510
+ name: string;
511
+ /**
512
+ * The org and environment the app belongs to (Q639: one app per
513
+ * environment); free text until the authorization of LV1 Task 15.
514
+ *
515
+ * @generated from field: string namespace = 3;
516
+ */
517
+ namespace: string;
518
+ /**
519
+ * Where its data lives: `loams_live_a<id>`, or the server's own keyspace
520
+ * for its default app (`--live-app`).
521
+ *
522
+ * @generated from field: string keyspace = 4;
523
+ */
524
+ keyspace: string;
525
+ /**
526
+ * @generated from field: loams.live.v1.AppState state = 5;
527
+ */
528
+ state: AppState;
529
+ /**
530
+ * When a deleted app's data is purged (Unix ms); 0 unless deleting.
531
+ *
532
+ * @generated from field: uint64 purge_after_ms = 6;
533
+ */
534
+ purgeAfterMs: bigint;
535
+ /**
536
+ * @generated from field: loams.live.v1.AppLimits limits = 7;
537
+ */
538
+ limits?: AppLimits | undefined;
539
+ /**
540
+ * @generated from field: repeated loams.live.v1.TrustedIssuer issuers = 8;
541
+ */
542
+ issuers: TrustedIssuer[];
543
+ /**
544
+ * The browser origins allowed to call the app (CORS, LV1 Task 18).
545
+ *
546
+ * @generated from field: repeated string allowed_origins = 9;
547
+ */
548
+ allowedOrigins: string[];
549
+ /**
550
+ * Whether calls without a credential are accepted (LV1 Task 16).
551
+ *
552
+ * @generated from field: bool allow_anonymous = 10;
553
+ */
554
+ allowAnonymous: boolean;
555
+ /**
556
+ * Unix ms.
557
+ *
558
+ * @generated from field: uint64 created_at_ms = 11;
559
+ */
560
+ createdAtMs: bigint;
561
+ };
562
+ /**
563
+ * Describes the message loams.live.v1.App.
564
+ * Use `create(AppSchema)` to create a new message.
565
+ */
566
+ export declare const AppSchema: GenMessage<App>;
567
+ /**
568
+ * Per-app limits. Each one only tightens the server's own; absent means
569
+ * the server's.
570
+ *
571
+ * @generated from message loams.live.v1.AppLimits
572
+ */
573
+ export type AppLimits = Message<"loams.live.v1.AppLimits"> & {
574
+ /**
575
+ * JavaScript CPU time of one call, in ms.
576
+ *
577
+ * @generated from field: optional uint64 max_js_cpu_ms = 1;
578
+ */
579
+ maxJsCpuMs?: bigint | undefined;
580
+ /**
581
+ * The wall-clock deadline of one mutation, in ms.
582
+ *
583
+ * @generated from field: optional uint64 mutation_deadline_ms = 2;
584
+ */
585
+ mutationDeadlineMs?: bigint | undefined;
586
+ /**
587
+ * The value one call returns, in bytes.
588
+ *
589
+ * @generated from field: optional uint64 max_result_bytes = 3;
590
+ */
591
+ maxResultBytes?: bigint | undefined;
592
+ /**
593
+ * Documents one function scans.
594
+ *
595
+ * @generated from field: optional uint64 max_scanned_docs = 4;
596
+ */
597
+ maxScannedDocs?: bigint | undefined;
598
+ /**
599
+ * Documents one mutation writes.
600
+ *
601
+ * @generated from field: optional uint64 max_written_docs = 5;
602
+ */
603
+ maxWrittenDocs?: bigint | undefined;
604
+ /**
605
+ * Bytes one mutation writes.
606
+ *
607
+ * @generated from field: optional uint64 max_written_bytes = 6;
608
+ */
609
+ maxWrittenBytes?: bigint | undefined;
610
+ };
611
+ /**
612
+ * Describes the message loams.live.v1.AppLimits.
613
+ * Use `create(AppLimitsSchema)` to create a new message.
614
+ */
615
+ export declare const AppLimitsSchema: GenMessage<AppLimits>;
616
+ /**
617
+ * An OIDC issuer whose tokens identify the app's end users (design §45
618
+ * §5.3; used from LV1 Task 16).
619
+ *
620
+ * @generated from message loams.live.v1.TrustedIssuer
621
+ */
622
+ export type TrustedIssuer = Message<"loams.live.v1.TrustedIssuer"> & {
623
+ /**
624
+ * The issuer URL, as the tokens' `iss` names it.
625
+ *
626
+ * @generated from field: string issuer = 1;
627
+ */
628
+ issuer: string;
629
+ /**
630
+ * The `aud` values accepted; at least one.
631
+ *
632
+ * @generated from field: repeated string audiences = 2;
633
+ */
634
+ audiences: string[];
635
+ /**
636
+ * The JWKS URL; absent means OIDC discovery.
637
+ *
638
+ * @generated from field: optional string jwks_uri = 3;
639
+ */
640
+ jwksUri?: string | undefined;
641
+ };
642
+ /**
643
+ * Describes the message loams.live.v1.TrustedIssuer.
644
+ * Use `create(TrustedIssuerSchema)` to create a new message.
645
+ */
646
+ export declare const TrustedIssuerSchema: GenMessage<TrustedIssuer>;
647
+ /**
648
+ * @generated from message loams.live.v1.CreateAppRequest
649
+ */
650
+ export type CreateAppRequest = Message<"loams.live.v1.CreateAppRequest"> & {
651
+ /**
652
+ * @generated from field: string name = 1;
653
+ */
654
+ name: string;
655
+ /**
656
+ * @generated from field: string namespace = 2;
657
+ */
658
+ namespace: string;
659
+ /**
660
+ * @generated from field: loams.live.v1.AppLimits limits = 3;
661
+ */
662
+ limits?: AppLimits | undefined;
663
+ /**
664
+ * @generated from field: repeated loams.live.v1.TrustedIssuer issuers = 4;
665
+ */
666
+ issuers: TrustedIssuer[];
667
+ /**
668
+ * @generated from field: repeated string allowed_origins = 5;
669
+ */
670
+ allowedOrigins: string[];
671
+ /**
672
+ * @generated from field: bool allow_anonymous = 6;
673
+ */
674
+ allowAnonymous: boolean;
675
+ };
676
+ /**
677
+ * Describes the message loams.live.v1.CreateAppRequest.
678
+ * Use `create(CreateAppRequestSchema)` to create a new message.
679
+ */
680
+ export declare const CreateAppRequestSchema: GenMessage<CreateAppRequest>;
681
+ /**
682
+ * @generated from message loams.live.v1.CreateAppResponse
683
+ */
684
+ export type CreateAppResponse = Message<"loams.live.v1.CreateAppResponse"> & {
685
+ /**
686
+ * @generated from field: loams.live.v1.App app = 1;
687
+ */
688
+ app?: App | undefined;
689
+ };
690
+ /**
691
+ * Describes the message loams.live.v1.CreateAppResponse.
692
+ * Use `create(CreateAppResponseSchema)` to create a new message.
693
+ */
694
+ export declare const CreateAppResponseSchema: GenMessage<CreateAppResponse>;
695
+ /**
696
+ * @generated from message loams.live.v1.ListAppsRequest
697
+ */
698
+ export type ListAppsRequest = Message<"loams.live.v1.ListAppsRequest"> & {
699
+ /**
700
+ * AIP-158 page size: 100 when 0, at most 1 000.
701
+ *
702
+ * @generated from field: int32 page_size = 1;
703
+ */
704
+ pageSize: number;
705
+ /**
706
+ * The `next_page_token` of the previous page; empty starts at the first.
707
+ *
708
+ * @generated from field: string page_token = 2;
709
+ */
710
+ pageToken: string;
711
+ };
712
+ /**
713
+ * Describes the message loams.live.v1.ListAppsRequest.
714
+ * Use `create(ListAppsRequestSchema)` to create a new message.
715
+ */
716
+ export declare const ListAppsRequestSchema: GenMessage<ListAppsRequest>;
717
+ /**
718
+ * @generated from message loams.live.v1.ListAppsResponse
719
+ */
720
+ export type ListAppsResponse = Message<"loams.live.v1.ListAppsResponse"> & {
721
+ /**
722
+ * By id. Deleted apps are listed until they are purged.
723
+ *
724
+ * @generated from field: repeated loams.live.v1.App apps = 1;
725
+ */
726
+ apps: App[];
727
+ /**
728
+ * Empty on the last page.
729
+ *
730
+ * @generated from field: string next_page_token = 2;
731
+ */
732
+ nextPageToken: string;
733
+ };
734
+ /**
735
+ * Describes the message loams.live.v1.ListAppsResponse.
736
+ * Use `create(ListAppsResponseSchema)` to create a new message.
737
+ */
738
+ export declare const ListAppsResponseSchema: GenMessage<ListAppsResponse>;
739
+ /**
740
+ * @generated from message loams.live.v1.GetAppRequest
741
+ */
742
+ export type GetAppRequest = Message<"loams.live.v1.GetAppRequest"> & {
743
+ /**
744
+ * @generated from field: string name = 1;
745
+ */
746
+ name: string;
747
+ };
748
+ /**
749
+ * Describes the message loams.live.v1.GetAppRequest.
750
+ * Use `create(GetAppRequestSchema)` to create a new message.
751
+ */
752
+ export declare const GetAppRequestSchema: GenMessage<GetAppRequest>;
753
+ /**
754
+ * @generated from message loams.live.v1.GetAppResponse
755
+ */
756
+ export type GetAppResponse = Message<"loams.live.v1.GetAppResponse"> & {
757
+ /**
758
+ * @generated from field: loams.live.v1.App app = 1;
759
+ */
760
+ app?: App | undefined;
761
+ };
762
+ /**
763
+ * Describes the message loams.live.v1.GetAppResponse.
764
+ * Use `create(GetAppResponseSchema)` to create a new message.
765
+ */
766
+ export declare const GetAppResponseSchema: GenMessage<GetAppResponse>;
767
+ /**
768
+ * @generated from message loams.live.v1.UpdateAppRequest
769
+ */
770
+ export type UpdateAppRequest = Message<"loams.live.v1.UpdateAppRequest"> & {
771
+ /**
772
+ * @generated from field: string name = 1;
773
+ */
774
+ name: string;
775
+ /**
776
+ * `APP_STATE_ACTIVE` or `APP_STATE_DISABLED`; a deleted app cannot
777
+ * change state.
778
+ *
779
+ * @generated from field: optional loams.live.v1.AppState state = 2;
780
+ */
781
+ state?: AppState | undefined;
782
+ /**
783
+ * Replaces the limits.
784
+ *
785
+ * @generated from field: loams.live.v1.AppLimits limits = 3;
786
+ */
787
+ limits?: AppLimits | undefined;
788
+ /**
789
+ * Replaces the issuers.
790
+ *
791
+ * @generated from field: loams.live.v1.TrustedIssuers issuers = 4;
792
+ */
793
+ issuers?: TrustedIssuers | undefined;
794
+ /**
795
+ * Replaces the allowed origins.
796
+ *
797
+ * @generated from field: loams.live.v1.AllowedOrigins allowed_origins = 5;
798
+ */
799
+ allowedOrigins?: AllowedOrigins | undefined;
800
+ /**
801
+ * @generated from field: optional bool allow_anonymous = 6;
802
+ */
803
+ allowAnonymous?: boolean | undefined;
804
+ };
805
+ /**
806
+ * Describes the message loams.live.v1.UpdateAppRequest.
807
+ * Use `create(UpdateAppRequestSchema)` to create a new message.
808
+ */
809
+ export declare const UpdateAppRequestSchema: GenMessage<UpdateAppRequest>;
810
+ /**
811
+ * A list that replaces the app's issuers (empty removes them all).
812
+ *
813
+ * @generated from message loams.live.v1.TrustedIssuers
814
+ */
815
+ export type TrustedIssuers = Message<"loams.live.v1.TrustedIssuers"> & {
816
+ /**
817
+ * @generated from field: repeated loams.live.v1.TrustedIssuer issuers = 1;
818
+ */
819
+ issuers: TrustedIssuer[];
820
+ };
821
+ /**
822
+ * Describes the message loams.live.v1.TrustedIssuers.
823
+ * Use `create(TrustedIssuersSchema)` to create a new message.
824
+ */
825
+ export declare const TrustedIssuersSchema: GenMessage<TrustedIssuers>;
826
+ /**
827
+ * A list that replaces the app's allowed origins (empty removes them all).
828
+ *
829
+ * @generated from message loams.live.v1.AllowedOrigins
830
+ */
831
+ export type AllowedOrigins = Message<"loams.live.v1.AllowedOrigins"> & {
832
+ /**
833
+ * @generated from field: repeated string origins = 1;
834
+ */
835
+ origins: string[];
836
+ };
837
+ /**
838
+ * Describes the message loams.live.v1.AllowedOrigins.
839
+ * Use `create(AllowedOriginsSchema)` to create a new message.
840
+ */
841
+ export declare const AllowedOriginsSchema: GenMessage<AllowedOrigins>;
842
+ /**
843
+ * @generated from message loams.live.v1.UpdateAppResponse
844
+ */
845
+ export type UpdateAppResponse = Message<"loams.live.v1.UpdateAppResponse"> & {
846
+ /**
847
+ * @generated from field: loams.live.v1.App app = 1;
848
+ */
849
+ app?: App | undefined;
850
+ };
851
+ /**
852
+ * Describes the message loams.live.v1.UpdateAppResponse.
853
+ * Use `create(UpdateAppResponseSchema)` to create a new message.
854
+ */
855
+ export declare const UpdateAppResponseSchema: GenMessage<UpdateAppResponse>;
856
+ /**
857
+ * @generated from message loams.live.v1.DeleteAppRequest
858
+ */
859
+ export type DeleteAppRequest = Message<"loams.live.v1.DeleteAppRequest"> & {
860
+ /**
861
+ * @generated from field: string name = 1;
862
+ */
863
+ name: string;
864
+ };
865
+ /**
866
+ * Describes the message loams.live.v1.DeleteAppRequest.
867
+ * Use `create(DeleteAppRequestSchema)` to create a new message.
868
+ */
869
+ export declare const DeleteAppRequestSchema: GenMessage<DeleteAppRequest>;
870
+ /**
871
+ * @generated from message loams.live.v1.DeleteAppResponse
872
+ */
873
+ export type DeleteAppResponse = Message<"loams.live.v1.DeleteAppResponse"> & {
874
+ /**
875
+ * The app, now `APP_STATE_DELETING`.
876
+ *
877
+ * @generated from field: loams.live.v1.App app = 1;
878
+ */
879
+ app?: App | undefined;
880
+ };
881
+ /**
882
+ * Describes the message loams.live.v1.DeleteAppResponse.
883
+ * Use `create(DeleteAppResponseSchema)` to create a new message.
884
+ */
885
+ export declare const DeleteAppResponseSchema: GenMessage<DeleteAppResponse>;
886
+ /**
887
+ * Where a deployment is in its life (design §45 §3.3). The catalog's
888
+ * records store it too.
889
+ *
890
+ * @generated from enum loams.live.v1.DeploymentState
891
+ */
892
+ export declare enum DeploymentState {
893
+ /**
894
+ * @generated from enum value: DEPLOYMENT_STATE_UNSPECIFIED = 0;
895
+ */
896
+ UNSPECIFIED = 0,
897
+ /**
898
+ * Its record is written; its schema is not applied yet.
899
+ *
900
+ * @generated from enum value: DEPLOYMENT_STATE_PENDING = 1;
901
+ */
902
+ PENDING = 1,
903
+ /**
904
+ * A stricter validator scans existing data (LV1 plan Task 8): it is
905
+ * enforced on new writes, and the table's documents are checked.
906
+ *
907
+ * @generated from enum value: DEPLOYMENT_STATE_VALIDATING = 2;
908
+ */
909
+ VALIDATING = 2,
910
+ /**
911
+ * A new index is backfilled (LV1 plan Task 9).
912
+ *
913
+ * @generated from enum value: DEPLOYMENT_STATE_BACKFILLING = 3;
914
+ */
915
+ BACKFILLING = 3,
916
+ /**
917
+ * The pointer names it: new calls run its functions.
918
+ *
919
+ * @generated from enum value: DEPLOYMENT_STATE_ACTIVE = 4;
920
+ */
921
+ ACTIVE = 4,
922
+ /**
923
+ * A later deployment replaced it.
924
+ *
925
+ * @generated from enum value: DEPLOYMENT_STATE_SUPERSEDED = 5;
926
+ */
927
+ SUPERSEDED = 5,
928
+ /**
929
+ * It never became active; `failure_reason` says why.
930
+ *
931
+ * @generated from enum value: DEPLOYMENT_STATE_FAILED = 6;
932
+ */
933
+ FAILED = 6,
934
+ /**
935
+ * It is active, but its isolated workers crashed five times within a
936
+ * minute (design §45 §3.1). Calls are still served.
937
+ *
938
+ * @generated from enum value: DEPLOYMENT_STATE_DEGRADED = 7;
939
+ */
940
+ DEGRADED = 7
941
+ }
942
+ /**
943
+ * Describes the enum loams.live.v1.DeploymentState.
944
+ */
945
+ export declare const DeploymentStateSchema: GenEnum<DeploymentState>;
946
+ /**
947
+ * @generated from enum loams.live.v1.FunctionKind
948
+ */
949
+ export declare enum FunctionKind {
950
+ /**
951
+ * @generated from enum value: FUNCTION_KIND_UNSPECIFIED = 0;
952
+ */
953
+ UNSPECIFIED = 0,
954
+ /**
955
+ * @generated from enum value: FUNCTION_KIND_QUERY = 1;
956
+ */
957
+ QUERY = 1,
958
+ /**
959
+ * @generated from enum value: FUNCTION_KIND_MUTATION = 2;
960
+ */
961
+ MUTATION = 2
962
+ }
963
+ /**
964
+ * Describes the enum loams.live.v1.FunctionKind.
965
+ */
966
+ export declare const FunctionKindSchema: GenEnum<FunctionKind>;
967
+ /**
968
+ * Who may call a function (D699).
969
+ *
970
+ * @generated from enum loams.live.v1.FunctionVisibility
971
+ */
972
+ export declare enum FunctionVisibility {
973
+ /**
974
+ * @generated from enum value: FUNCTION_VISIBILITY_UNSPECIFIED = 0;
975
+ */
976
+ UNSPECIFIED = 0,
977
+ /**
978
+ * `query`, `mutation`: end users and platform principals.
979
+ *
980
+ * @generated from enum value: FUNCTION_VISIBILITY_PUBLIC = 1;
981
+ */
982
+ PUBLIC = 1,
983
+ /**
984
+ * `internalQuery`, `internalMutation`: platform principals only.
985
+ *
986
+ * @generated from enum value: FUNCTION_VISIBILITY_INTERNAL = 2;
987
+ */
988
+ INTERNAL = 2
989
+ }
990
+ /**
991
+ * Describes the enum loams.live.v1.FunctionVisibility.
992
+ */
993
+ export declare const FunctionVisibilitySchema: GenEnum<FunctionVisibility>;
994
+ /**
995
+ * Where a user index is in its life (LV1 plan Task 9, design §45 §4.2). The
996
+ * catalog's index definitions store it too.
997
+ *
998
+ * @generated from enum loams.live.v1.IndexState
999
+ */
1000
+ export declare enum IndexState {
1001
+ /**
1002
+ * In a catalog record: ready (an index defined before Task 9). The admin
1003
+ * API never answers it.
1004
+ *
1005
+ * @generated from enum value: INDEX_STATE_UNSPECIFIED = 0;
1006
+ */
1007
+ UNSPECIFIED = 0,
1008
+ /**
1009
+ * Every write maintains it and a backfill job writes the entries of the
1010
+ * documents already there; no query reads it.
1011
+ *
1012
+ * @generated from enum value: INDEX_STATE_BACKFILLING = 1;
1013
+ */
1014
+ BACKFILLING = 1,
1015
+ /**
1016
+ * Queries read it; every write maintains it.
1017
+ *
1018
+ * @generated from enum value: INDEX_STATE_READY = 2;
1019
+ */
1020
+ READY = 2,
1021
+ /**
1022
+ * No write maintains it and no query reads it; its entries are being
1023
+ * deleted, then the definition goes.
1024
+ *
1025
+ * @generated from enum value: INDEX_STATE_DROPPING = 3;
1026
+ */
1027
+ DROPPING = 3
1028
+ }
1029
+ /**
1030
+ * Describes the enum loams.live.v1.IndexState.
1031
+ */
1032
+ export declare const IndexStateSchema: GenEnum<IndexState>;
1033
+ /**
1034
+ * @generated from enum loams.live.v1.LogLevel
1035
+ */
1036
+ export declare enum LogLevel {
1037
+ /**
1038
+ * @generated from enum value: LOG_LEVEL_UNSPECIFIED = 0;
1039
+ */
1040
+ UNSPECIFIED = 0,
1041
+ /**
1042
+ * @generated from enum value: LOG_LEVEL_DEBUG = 1;
1043
+ */
1044
+ DEBUG = 1,
1045
+ /**
1046
+ * @generated from enum value: LOG_LEVEL_LOG = 2;
1047
+ */
1048
+ LOG = 2,
1049
+ /**
1050
+ * @generated from enum value: LOG_LEVEL_INFO = 3;
1051
+ */
1052
+ INFO = 3,
1053
+ /**
1054
+ * @generated from enum value: LOG_LEVEL_WARN = 4;
1055
+ */
1056
+ WARN = 4,
1057
+ /**
1058
+ * `console.error`, and the error a call ended with.
1059
+ *
1060
+ * @generated from enum value: LOG_LEVEL_ERROR = 5;
1061
+ */
1062
+ ERROR = 5
1063
+ }
1064
+ /**
1065
+ * Describes the enum loams.live.v1.LogLevel.
1066
+ */
1067
+ export declare const LogLevelSchema: GenEnum<LogLevel>;
1068
+ /**
1069
+ * @generated from enum loams.live.v1.AppState
1070
+ */
1071
+ export declare enum AppState {
1072
+ /**
1073
+ * @generated from enum value: APP_STATE_UNSPECIFIED = 0;
1074
+ */
1075
+ UNSPECIFIED = 0,
1076
+ /**
1077
+ * Calls are served.
1078
+ *
1079
+ * @generated from enum value: APP_STATE_ACTIVE = 1;
1080
+ */
1081
+ ACTIVE = 1,
1082
+ /**
1083
+ * Every call is FAILED_PRECONDITION, reason `live_app_disabled`.
1084
+ *
1085
+ * @generated from enum value: APP_STATE_DISABLED = 2;
1086
+ */
1087
+ DISABLED = 2,
1088
+ /**
1089
+ * Deleted: refused as disabled, and purged at `purge_after_ms`.
1090
+ *
1091
+ * @generated from enum value: APP_STATE_DELETING = 3;
1092
+ */
1093
+ DELETING = 3
1094
+ }
1095
+ /**
1096
+ * Describes the enum loams.live.v1.AppState.
1097
+ */
1098
+ export declare const AppStateSchema: GenEnum<AppState>;
1099
+ /**
1100
+ * @generated from service loams.live.v1.LiveAdminService
1101
+ */
1102
+ export declare const LiveAdminService: GenService<{
1103
+ /**
1104
+ * Deploys a function bundle and a schema (§45 §3.3). The deployment
1105
+ * activates by compare-and-swap against `expected_active`; a mismatch is
1106
+ * FAILED_PRECONDITION, reason `live_deploy_conflict`. The call returns
1107
+ * when the deployment is active or failed, which takes as long as its
1108
+ * validation scans and index backfills.
1109
+ *
1110
+ * @generated from rpc loams.live.v1.LiveAdminService.Deploy
1111
+ */
1112
+ deploy: {
1113
+ methodKind: "unary";
1114
+ input: typeof DeployRequestSchema;
1115
+ output: typeof DeployResponseSchema;
1116
+ };
1117
+ /**
1118
+ * The app's deployments, newest first.
1119
+ *
1120
+ * @generated from rpc loams.live.v1.LiveAdminService.ListDeployments
1121
+ */
1122
+ listDeployments: {
1123
+ methodKind: "unary";
1124
+ input: typeof ListDeploymentsRequestSchema;
1125
+ output: typeof ListDeploymentsResponseSchema;
1126
+ };
1127
+ /**
1128
+ * One deployment, with its schema and its functions.
1129
+ *
1130
+ * @generated from rpc loams.live.v1.LiveAdminService.GetDeployment
1131
+ */
1132
+ getDeployment: {
1133
+ methodKind: "unary";
1134
+ input: typeof GetDeploymentRequestSchema;
1135
+ output: typeof GetDeploymentResponseSchema;
1136
+ };
1137
+ /**
1138
+ * Activates an existing deployment: a rollback, or a roll forward. It
1139
+ * takes the deploy's path with the stored bundle and schema, so the
1140
+ * deployment's schema is applied again (§45 §3.3).
1141
+ *
1142
+ * @generated from rpc loams.live.v1.LiveAdminService.ActivateDeployment
1143
+ */
1144
+ activateDeployment: {
1145
+ methodKind: "unary";
1146
+ input: typeof ActivateDeploymentRequestSchema;
1147
+ output: typeof ActivateDeploymentResponseSchema;
1148
+ };
1149
+ /**
1150
+ * The state of an index and its backfill's progress (§45 §4.2).
1151
+ *
1152
+ * @generated from rpc loams.live.v1.LiveAdminService.GetIndexStatus
1153
+ */
1154
+ getIndexStatus: {
1155
+ methodKind: "unary";
1156
+ input: typeof GetIndexStatusRequestSchema;
1157
+ output: typeof GetIndexStatusResponseSchema;
1158
+ };
1159
+ /**
1160
+ * The functions' `console.*` output on this node (§45 §3.3): the lines
1161
+ * the node still holds, then, with `follow`, new lines as they come.
1162
+ *
1163
+ * @generated from rpc loams.live.v1.LiveAdminService.TailLogs
1164
+ */
1165
+ tailLogs: {
1166
+ methodKind: "server_streaming";
1167
+ input: typeof TailLogsRequestSchema;
1168
+ output: typeof TailLogsResponseSchema;
1169
+ };
1170
+ /**
1171
+ * Creates an app (design §45 §7, D690): its dedicated keyspace
1172
+ * `loams_live_a<id>` first, then its directory record. A taken name is
1173
+ * FAILED_PRECONDITION, reason `live_app_exists`; more apps than the
1174
+ * cluster allows is RESOURCE_EXHAUSTED.
1175
+ *
1176
+ * @generated from rpc loams.live.v1.LiveAdminService.CreateApp
1177
+ */
1178
+ createApp: {
1179
+ methodKind: "unary";
1180
+ input: typeof CreateAppRequestSchema;
1181
+ output: typeof CreateAppResponseSchema;
1182
+ };
1183
+ /**
1184
+ * The cluster's apps, by id.
1185
+ *
1186
+ * @generated from rpc loams.live.v1.LiveAdminService.ListApps
1187
+ */
1188
+ listApps: {
1189
+ methodKind: "unary";
1190
+ input: typeof ListAppsRequestSchema;
1191
+ output: typeof ListAppsResponseSchema;
1192
+ };
1193
+ /**
1194
+ * One app, by name.
1195
+ *
1196
+ * @generated from rpc loams.live.v1.LiveAdminService.GetApp
1197
+ */
1198
+ getApp: {
1199
+ methodKind: "unary";
1200
+ input: typeof GetAppRequestSchema;
1201
+ output: typeof GetAppResponseSchema;
1202
+ };
1203
+ /**
1204
+ * Changes an app's settings, or disables and enables it. Fields left out
1205
+ * are kept.
1206
+ *
1207
+ * @generated from rpc loams.live.v1.LiveAdminService.UpdateApp
1208
+ */
1209
+ updateApp: {
1210
+ methodKind: "unary";
1211
+ input: typeof UpdateAppRequestSchema;
1212
+ output: typeof UpdateAppResponseSchema;
1213
+ };
1214
+ /**
1215
+ * Deletes an app softly: it is `APP_STATE_DELETING` (every call refused)
1216
+ * and its data is purged after the retention, 7 days by default.
1217
+ *
1218
+ * @generated from rpc loams.live.v1.LiveAdminService.DeleteApp
1219
+ */
1220
+ deleteApp: {
1221
+ methodKind: "unary";
1222
+ input: typeof DeleteAppRequestSchema;
1223
+ output: typeof DeleteAppResponseSchema;
1224
+ };
1225
+ }>;