@idyl-sh/sdk 0.1.0 → 0.1.1

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/dist/index.d.cts CHANGED
@@ -192,6 +192,30 @@ declare const SAVE_REASON_COMPUTER_SIZE = "computer-size";
192
192
  * the Computer's size holds (`ComputerSizeInfo.names`).
193
193
  */
194
194
  declare const SAVE_REASON_NAME_LIMIT = "name-limit";
195
+ /**
196
+ * A save that is ready to publish and waits for its turn: behind the
197
+ * Account's other publications, as many at once as its plan allows, or behind
198
+ * other work the publication service runs. The save publishes once a
199
+ * publication ahead of it ends. It is what a pending save waits for, as
200
+ * `SaveOptions.onWaiting` hears it.
201
+ */
202
+ declare const SAVE_WAITING_FOR_PUBLICATION_TURN = "publication-turn";
203
+ /**
204
+ * A save whose Computer's publications are held: two publications in a row
205
+ * ended without finishing under one release of IDYL's storage service. The
206
+ * hold ends 24 hours after the last of them, the instant
207
+ * `SaveOptions.onWaiting` hears with it, or earlier when another release
208
+ * takes the publication. It is also the reason of the save's last failed
209
+ * attempt.
210
+ */
211
+ declare const SAVE_REASON_PUBLICATION_HELD = "publication-held";
212
+ /**
213
+ * The reason of a pending save's last attempt while its recording,
214
+ * confirmation or file pages wait for the Account's own turn: IDYL runs a
215
+ * bounded number of each Account's saves at once. The wait ends by itself
216
+ * when one of them ends, so it states no end time.
217
+ */
218
+ declare const SAVE_REASON_ACCOUNT_TURN_WAITING = "account-turn-waiting";
195
219
 
196
220
  /**
197
221
  * The name of a size a Computer runs at, such as `small`: its whole CPU and
@@ -720,6 +744,36 @@ interface Page<T> {
720
744
  * absent on the last page.
721
745
  */
722
746
  readonly continue?: string;
747
+ /**
748
+ * How many items the listing selects, counted up to 1,000, on the first
749
+ * page of a listing that counts: the page read with no `continue`.
750
+ * Absent on every later page and on a listing that does not count.
751
+ */
752
+ readonly totalCount?: number;
753
+ /**
754
+ * `true` when the listing selects more than `totalCount` items, which is
755
+ * then 1,000 and reads as "1,000+". Absent otherwise.
756
+ */
757
+ readonly totalCountIsLowerBound?: true;
758
+ }
759
+ /**
760
+ * A count that stops at 1,000: `count` is exact up to it, and beyond it
761
+ * `count` is 1,000 and `isLowerBound` is `true`, which reads as "1,000+".
762
+ */
763
+ interface BoundedCount {
764
+ /** The count, at most 1,000. */
765
+ readonly count: number;
766
+ /** `true` when there are more than `count`; absent otherwise. */
767
+ readonly isLowerBound?: true;
768
+ }
769
+ /** Selects the versions a usage read states something of. */
770
+ interface UsageOptions extends CallOptions {
771
+ /**
772
+ * The versions to state something of, at most 100 and none twice, each a
773
+ * whole number of at least 1; the answer keeps their order. `undefined`
774
+ * names none.
775
+ */
776
+ readonly versions?: readonly number[];
723
777
  }
724
778
  /** Walks a listing. */
725
779
  interface ListOptions extends CallOptions {
@@ -973,12 +1027,12 @@ interface BrowserExchangeRequest {
973
1027
  * person can act as, access tokens, the browser handoff, access key
974
1028
  * exchanges and sign-out.
975
1029
  *
976
- * Every token IDYL issues is bound to a key its holder keeps. Verifying a
977
- * code, redeeming a browser code and exchanging an access key prove a key
978
- * and bind the tokens they issue to it; every other call presents a
979
- * {@link RefreshCredential} for that one request only. Starting sign-in is
980
- * anonymous. None of them consults the client's `credential`. No token is
981
- * kept, inspected or logged, and no message carries one.
1030
+ * Every code and token IDYL issues is bound to a key its holder keeps.
1031
+ * Asking for a sign-in code, verifying it, redeeming a browser code and
1032
+ * exchanging an access key prove a key and bind what they issue to it; every
1033
+ * other call presents a {@link RefreshCredential} for that one request only.
1034
+ * None of them consults the client's `credential`. No token is kept,
1035
+ * inspected or logged, and no message carries one.
982
1036
  *
983
1037
  * @example
984
1038
  * ```ts
@@ -986,10 +1040,10 @@ interface BrowserExchangeRequest {
986
1040
  * "sign",
987
1041
  * "verify",
988
1042
  * ]);
989
- * await idyl.identity.startSignIn("ada@example.com");
1043
+ * await idyl.identity.startSignIn("ada@example.com", key);
990
1044
  * const { refreshToken } = await idyl.identity.verifyCode(
991
1045
  * "ada@example.com",
992
- * "123456",
1046
+ * "41820593",
993
1047
  * key,
994
1048
  * );
995
1049
  * const token = await idyl.identity.accessToken({ refreshToken, key });
@@ -997,32 +1051,43 @@ interface BrowserExchangeRequest {
997
1051
  */
998
1052
  interface Identity {
999
1053
  /**
1000
- * Sends a six-digit sign-in code to `email`. The answer is the same
1001
- * whether or not the address belongs to anyone.
1054
+ * Sends an eight-digit sign-in code to `email`, with a proof by `key`. The
1055
+ * code belongs to `key`: only {@link Identity.verifyCode} with the same key
1056
+ * redeems it, and a code another key asked for, for the same address, is
1057
+ * unaffected. The answer is the same whether or not the address belongs to
1058
+ * anyone.
1002
1059
  *
1003
1060
  * @param email The address to send the code to.
1004
- * @throws {@link TypeError} `email` is blank; nothing is sent
1061
+ * @param key The Ed25519 or ECDSA P-256 key pair made for this sign-in;
1062
+ * its private key may be non-extractable.
1063
+ * @throws {@link TypeError} `email` is blank, or `key` cannot sign; nothing
1064
+ * is sent
1005
1065
  * @throws {@link ApiError} IDYL refuses the request
1006
1066
  * @throws {@link TransportError} the request does not complete
1007
1067
  */
1008
- startSignIn(email: string, options?: SignInOptions): Promise<void>;
1068
+ startSignIn(email: string, key: CryptoKeyPair, options?: SignInOptions): Promise<void>;
1009
1069
  /**
1010
- * Sends another sign-in code, answering as {@link Identity.startSignIn} does.
1070
+ * Sends another sign-in code, with a proof by `key`, the key that started
1071
+ * the sign-in. The new code ends the earlier unused code of the same key
1072
+ * only. It answers as {@link Identity.startSignIn} does.
1011
1073
  *
1012
1074
  * @param email The address the sign-in was started for.
1013
- * @throws {@link TypeError} `email` is blank; nothing is sent
1075
+ * @param key The key pair {@link Identity.startSignIn} was given.
1076
+ * @throws {@link TypeError} `email` is blank, or `key` cannot sign; nothing
1077
+ * is sent
1014
1078
  * @throws {@link ApiError} IDYL refuses the request
1015
1079
  * @throws {@link TransportError} the request does not complete
1016
1080
  */
1017
- resendCode(email: string, options?: SignInOptions): Promise<void>;
1081
+ resendCode(email: string, key: CryptoKeyPair, options?: SignInOptions): Promise<void>;
1018
1082
  /**
1019
- * Verifies a sign-in code with a proof by `key`, the client's key, and
1020
- * returns a refresh token bound to that key.
1083
+ * Verifies a sign-in code with a proof by `key`, the key that asked for
1084
+ * the code, and returns a refresh token bound to that key. A proof by any
1085
+ * other key is refused as a wrong code.
1021
1086
  *
1022
1087
  * @param email The address the code was sent to.
1023
- * @param code The six-digit code from the email.
1024
- * @param key The Ed25519 or ECDSA P-256 key pair the tokens are bound to;
1025
- * its private key may be non-extractable.
1088
+ * @param code The eight-digit code from the email.
1089
+ * @param key The key pair {@link Identity.startSignIn} was given; the
1090
+ * tokens are bound to it.
1026
1091
  * @throws {@link TypeError} `email` or `code` is blank, or `key` cannot
1027
1092
  * sign; nothing is sent
1028
1093
  * @throws {@link ApiError} the code is wrong or expired, or IDYL refuses
@@ -2372,6 +2437,17 @@ interface ListFilesOptions extends CallOptions {
2372
2437
  readonly recursive?: boolean;
2373
2438
  /** The saved version to read, by number or name; the latest when absent. */
2374
2439
  readonly version?: number | string;
2440
+ /**
2441
+ * The most entries to read per page. `undefined` takes the platform's
2442
+ * page of 10,000, which is also the largest page. Must be a positive
2443
+ * integer.
2444
+ */
2445
+ readonly limit?: number;
2446
+ }
2447
+ /** Selects one page of a directory's entries. */
2448
+ interface ListFilesPageOptions extends PageOptions {
2449
+ /** The saved version to read, by number or name; the latest when absent. */
2450
+ readonly version?: number | string;
2375
2451
  }
2376
2452
  /**
2377
2453
  * Whether a file's content is safe in the store: `synced` once a saved
@@ -2647,6 +2723,23 @@ interface Files {
2647
2723
  * @throws {@link TransportError} a request does not complete
2648
2724
  */
2649
2725
  list(path?: string, options?: ListFilesOptions): AsyncIterable<FileEntry>;
2726
+ /**
2727
+ * One page of a directory's entries in byte order of name, the workspace
2728
+ * itself when `path` is absent. `limit` `undefined` takes the platform's
2729
+ * page of 10,000. The first page, read with no `continue`, carries
2730
+ * `totalCount`, counted up to 1,000, and `totalCountIsLowerBound` when the
2731
+ * directory holds more; `continue` reads the next page.
2732
+ *
2733
+ * @param path - The directory's path, relative to the workspace; empty or
2734
+ * absent for the workspace itself.
2735
+ * @throws {@link TypeError} the path, `limit` or `version` is invalid,
2736
+ * before any request is sent
2737
+ * @throws {@link ApiError} IDYL refuses the request, such as with status
2738
+ * 404 for a directory or version it does not hold, or a `continue` this
2739
+ * listing did not issue
2740
+ * @throws {@link TransportError} the request does not complete
2741
+ */
2742
+ listPage(path?: string, options?: ListFilesPageOptions): Promise<Page<FileEntry>>;
2650
2743
  /**
2651
2744
  * Follows a folder, the workspace itself when `path` is absent. The first
2652
2745
  * answer is the folder's current status, whether the files are `syncing`
@@ -3056,30 +3149,48 @@ interface Secrets {
3056
3149
  * first, page by page: when, which version, the Computer or Pod it was
3057
3150
  * opened for, the outcome and who reported the decryption. The record names
3058
3151
  * the Secret by name, so it holds decryptions made before the Secret was
3059
- * deleted and created again. No entry carries a value. It is read only
3060
- * when asked for, never on a Computer's wake, terminal or cell.
3152
+ * deleted and created again. No entry carries a value. `outcome` narrows
3153
+ * it to one outcome, such as `refused`. It is read only when asked for,
3154
+ * never on a Computer's wake, terminal or cell.
3061
3155
  *
3062
3156
  * @param name - The Secret's name.
3063
- * @throws {@link TypeError} `name` is empty, or `limit` is not a positive
3064
- * integer, before any request is sent
3157
+ * @throws {@link TypeError} `name` is empty, `limit` is not a positive
3158
+ * integer, or `outcome` is empty, before any request is sent
3065
3159
  * @throws {@link ApiError} IDYL refuses a page's request
3066
3160
  * @throws {@link TransportError} a page's request does not complete, or
3067
3161
  * its answer is not a valid decryption
3068
3162
  */
3069
- decryptions(name: string, options?: ListOptions): AsyncIterable<Decryption>;
3163
+ decryptions(name: string, options?: DecryptionsOptions): AsyncIterable<Decryption>;
3070
3164
  /**
3071
3165
  * One page of the record of every time IDYL opened a value of the Secret
3072
- * with this name, newest first.
3166
+ * with this name, newest first, narrowed to one outcome when `outcome` is
3167
+ * set.
3073
3168
  *
3074
3169
  * @param name - The Secret's name.
3075
3170
  * @throws {@link TypeError} `name` is empty, `limit` is not a positive
3076
- * integer, or `continue` is not one a page of this listing returned,
3077
- * before any request is sent
3171
+ * integer, `outcome` is empty, or `continue` is not one a page of this
3172
+ * listing returned, before any request is sent
3078
3173
  * @throws {@link ApiError} IDYL refuses the request
3079
3174
  * @throws {@link TransportError} the request does not complete, or its
3080
3175
  * answer is not a valid decryption
3081
3176
  */
3082
- decryptionsPage(name: string, options?: PageOptions): Promise<Page<Decryption>>;
3177
+ decryptionsPage(name: string, options?: DecryptionsPageOptions): Promise<Page<Decryption>>;
3178
+ /**
3179
+ * How the values of the Secret with this name were used in the last 90
3180
+ * days: how many openings, refusals and failures, each counted up to
3181
+ * 1,000, and when a value of each version asked about was last opened. No
3182
+ * decryption is listed and no value is read. It is read only when asked
3183
+ * for, never on a Computer's wake, terminal or cell.
3184
+ *
3185
+ * @param name - The Secret's name.
3186
+ * @throws {@link TypeError} `name` is empty, or `versions` is not whole
3187
+ * numbers of at least 1, at most 100 and none twice, before any request
3188
+ * is sent
3189
+ * @throws {@link ApiError} IDYL refuses the request, such as with status
3190
+ * 404 for a name the Namespace does not hold
3191
+ * @throws {@link TransportError} the request does not complete
3192
+ */
3193
+ usage(name: string, options?: UsageOptions): Promise<SecretUsage>;
3083
3194
  /**
3084
3195
  * Deletes the Secret with this name. For seven days, creating a Secret of
3085
3196
  * its name restores it, with its ID. To stop one Computer using a Secret,
@@ -3093,6 +3204,43 @@ interface Secrets {
3093
3204
  */
3094
3205
  delete(name: string, options?: CallOptions): Promise<void>;
3095
3206
  }
3207
+ /** Narrows a Secret's decryption record to one outcome. */
3208
+ interface DecryptionsOptions extends ListOptions {
3209
+ /**
3210
+ * Only the decryptions with this outcome, such as `refused`. `undefined`
3211
+ * reads every outcome.
3212
+ */
3213
+ readonly outcome?: Decryption["outcome"];
3214
+ }
3215
+ /** Selects one page of a Secret's decryption record, narrowed to one outcome. */
3216
+ interface DecryptionsPageOptions extends PageOptions {
3217
+ /**
3218
+ * Only the decryptions with this outcome, such as `refused`. `undefined`
3219
+ * reads every outcome.
3220
+ */
3221
+ readonly outcome?: Decryption["outcome"];
3222
+ }
3223
+ /**
3224
+ * How a Secret's values were used in the last 90 days, the record's whole
3225
+ * retention, counted without listing a decryption.
3226
+ */
3227
+ interface SecretUsage {
3228
+ /** The openings of its values. */
3229
+ readonly opened: BoundedCount;
3230
+ /** The openings the key service refused. */
3231
+ readonly refused: BoundedCount;
3232
+ /** The openings whose answer did not arrive, so whether they opened is not known. */
3233
+ readonly failed: BoundedCount;
3234
+ /**
3235
+ * For each version asked about, in the order asked, when a value of it
3236
+ * was last opened, as an RFC 3339 timestamp; `lastOpenedAt` is absent
3237
+ * when none was opened in the 90 days.
3238
+ */
3239
+ readonly versions: readonly {
3240
+ readonly version: number;
3241
+ readonly lastOpenedAt?: string;
3242
+ }[];
3243
+ }
3096
3244
  /**
3097
3245
  * The state of one Secret attachment of a Computer, judged against the
3098
3246
  * version the attachment uses: its current version, or the one it is
@@ -3149,6 +3297,261 @@ interface ComputerSecretUse {
3149
3297
  readonly version?: number;
3150
3298
  }
3151
3299
 
3300
+ /**
3301
+ * Which part of a Computer an event says changed, and so what a client
3302
+ * reads again:
3303
+ *
3304
+ * - `computer`: the Computer was created, renamed or deleted, or its state,
3305
+ * settings or reasons for being awake changed, including its fork's copy;
3306
+ * read the Computer and each list page that shows it.
3307
+ * - `session`: a session changed phase, was placed, or stated its save
3308
+ * result; read that session if the client waits for it.
3309
+ * - `sessions`: the set of open sessions changed; read them if shown.
3310
+ * - `operation`: a wake, sleep, save, restore or upload changed state; read
3311
+ * that operation if the client waits for it.
3312
+ * - `version`: a saved version was added; read the newest version, the
3313
+ * saved lists of open folders, and the history if shown.
3314
+ * - `reread`: read at once everything the client shows or waits for, of
3315
+ * the event's Namespace or, when it names none, of every Namespace. The
3316
+ * service paces the `reread`s it sends.
3317
+ *
3318
+ * A part this SDK does not name reads as `reread`.
3319
+ */
3320
+ type ComputerEventPart = "computer" | "session" | "sessions" | "operation" | "version" | "reread" | (string & Record<never, never>);
3321
+ /** A change, as the service sends it. */
3322
+ interface ComputerEventFrame {
3323
+ readonly type: "event";
3324
+ /** The Namespace of the change; absent on a `reread` for every Namespace. */
3325
+ readonly namespaceId?: string;
3326
+ /** The Computer's ID; absent on `reread`. */
3327
+ readonly computer?: string;
3328
+ readonly part: ComputerEventPart;
3329
+ /** The session's ID for `session`, the operation's for `operation`. */
3330
+ readonly id?: string;
3331
+ }
3332
+
3333
+ /** What the page asks of the Worker. Every request names a `ref` the page chose. */
3334
+ type PageToWorker = {
3335
+ readonly type: "start";
3336
+ readonly ref: number;
3337
+ readonly module: WebAssembly.Module | ArrayBuffer;
3338
+ } | {
3339
+ readonly type: "dock";
3340
+ readonly ref: number;
3341
+ readonly url: string;
3342
+ readonly serverName: string;
3343
+ readonly edgeId: string;
3344
+ readonly edgeRoots: readonly Uint8Array[];
3345
+ readonly chain: readonly Uint8Array[];
3346
+ readonly lease: Uint8Array;
3347
+ readonly keepaliveMs: number;
3348
+ } | {
3349
+ readonly type: "close-dock";
3350
+ readonly ref: number;
3351
+ readonly dock: number;
3352
+ } | {
3353
+ readonly type: "open-lane";
3354
+ readonly ref: number;
3355
+ readonly dock: number;
3356
+ readonly principal: string;
3357
+ } | {
3358
+ readonly type: "open-computer";
3359
+ readonly ref: number;
3360
+ readonly dock: number;
3361
+ readonly lane: number;
3362
+ readonly hostPod: string;
3363
+ readonly sequence: string;
3364
+ readonly epoch: string;
3365
+ readonly roots: readonly Uint8Array[];
3366
+ readonly chain: readonly Uint8Array[];
3367
+ readonly trustDomain: string;
3368
+ readonly account: string;
3369
+ readonly computer: string;
3370
+ readonly minEpoch: string;
3371
+ } | {
3372
+ readonly type: "open-service-lane";
3373
+ readonly ref: number;
3374
+ readonly dock: number;
3375
+ readonly principal: string;
3376
+ } | {
3377
+ readonly type: "open-service";
3378
+ readonly ref: number;
3379
+ readonly dock: number;
3380
+ readonly lane: number;
3381
+ /** The stream profile the lane stream's header names. */
3382
+ readonly profile: string;
3383
+ /** The trust anchors of the service's certificate, DER. */
3384
+ readonly roots: readonly Uint8Array[];
3385
+ readonly chain: readonly Uint8Array[];
3386
+ /** The exact SPIFFE ID the service's certificate must name. */
3387
+ readonly principal: string;
3388
+ } | {
3389
+ readonly type: "service-write";
3390
+ readonly ref: number;
3391
+ readonly dock: number;
3392
+ readonly service: number;
3393
+ readonly bytes: Uint8Array;
3394
+ } | {
3395
+ readonly type: "close-service";
3396
+ readonly ref: number;
3397
+ readonly dock: number;
3398
+ readonly service: number;
3399
+ }
3400
+ /**
3401
+ * The page has handled the last `service-data` of a service connection:
3402
+ * the Worker reads its stream again. Until then it reads none, so the
3403
+ * stream's sender is held by its receive window.
3404
+ */
3405
+ | {
3406
+ readonly type: "service-release";
3407
+ readonly ref: number;
3408
+ readonly dock: number;
3409
+ readonly service: number;
3410
+ } | {
3411
+ readonly type: "close-computer";
3412
+ readonly ref: number;
3413
+ readonly dock: number;
3414
+ readonly computer: number;
3415
+ } | {
3416
+ readonly type: "open-stream";
3417
+ readonly ref: number;
3418
+ readonly dock: number;
3419
+ readonly computer: number;
3420
+ } | {
3421
+ readonly type: "write";
3422
+ readonly ref: number;
3423
+ readonly dock: number;
3424
+ readonly computer: number;
3425
+ readonly stream: number;
3426
+ readonly bytes: Uint8Array;
3427
+ } | {
3428
+ readonly type: "finish";
3429
+ readonly ref: number;
3430
+ readonly dock: number;
3431
+ readonly computer: number;
3432
+ readonly stream: number;
3433
+ } | {
3434
+ readonly type: "abort";
3435
+ readonly ref: number;
3436
+ readonly dock: number;
3437
+ readonly computer: number;
3438
+ readonly stream: number;
3439
+ };
3440
+ /** What the Worker tells the page. */
3441
+ type WorkerToPage =
3442
+ /** The answer to a request: its value, or why it failed. */
3443
+ {
3444
+ readonly type: "reply";
3445
+ readonly ref: number;
3446
+ readonly value?: unknown;
3447
+ readonly error?: string;
3448
+ }
3449
+ /** The key exists: its certificate request (DER) and public key. */
3450
+ | {
3451
+ readonly type: "key";
3452
+ readonly certificateRequest: Uint8Array;
3453
+ readonly publicKey: Uint8Array;
3454
+ }
3455
+ /**
3456
+ * The dock is admitted; `serviceLaneProfile` is the client service lane
3457
+ * profile its edge serves, empty when it serves none.
3458
+ */
3459
+ | {
3460
+ readonly type: "docked";
3461
+ readonly dock: number;
3462
+ readonly serviceLaneProfile: string;
3463
+ } | {
3464
+ readonly type: "drain";
3465
+ readonly dock: number;
3466
+ readonly reason: string;
3467
+ } | {
3468
+ readonly type: "dock-ended";
3469
+ readonly dock: number;
3470
+ readonly reason: string;
3471
+ readonly retryAfterMs?: number;
3472
+ } | {
3473
+ readonly type: "lane-ready";
3474
+ readonly dock: number;
3475
+ readonly lane: number;
3476
+ } | {
3477
+ readonly type: "lane-ended";
3478
+ readonly dock: number;
3479
+ readonly lane: number;
3480
+ readonly reason: string;
3481
+ } | {
3482
+ readonly type: "computer-established";
3483
+ readonly dock: number;
3484
+ readonly computer: number;
3485
+ readonly epoch: string;
3486
+ } | {
3487
+ readonly type: "computer-ended";
3488
+ readonly dock: number;
3489
+ readonly computer: number;
3490
+ readonly reason: string;
3491
+ readonly refusal?: number;
3492
+ } | {
3493
+ readonly type: "service-established";
3494
+ readonly dock: number;
3495
+ readonly service: number;
3496
+ } | {
3497
+ readonly type: "service-ended";
3498
+ readonly dock: number;
3499
+ readonly service: number;
3500
+ readonly reason: string;
3501
+ } | {
3502
+ readonly type: "service-data";
3503
+ readonly dock: number;
3504
+ readonly service: number;
3505
+ readonly bytes: Uint8Array;
3506
+ } | {
3507
+ readonly type: "data";
3508
+ readonly dock: number;
3509
+ readonly computer: number;
3510
+ readonly stream: number;
3511
+ readonly bytes: Uint8Array;
3512
+ } | {
3513
+ readonly type: "stream-ended";
3514
+ readonly dock: number;
3515
+ readonly computer: number;
3516
+ readonly stream: number;
3517
+ readonly broken: boolean;
3518
+ };
3519
+
3520
+ /** A change to one of the Namespace's Computers, as its event names it. */
3521
+ interface ComputerChange {
3522
+ /** Which part changed; a part this SDK does not name is delivered as `reread`. */
3523
+ readonly part: ComputerEventFrame["part"];
3524
+ /** The Computer's ID; absent on `reread`. */
3525
+ readonly computer?: string;
3526
+ /** The session's ID for `session`, the operation's for `operation`. */
3527
+ readonly id?: string;
3528
+ }
3529
+ /**
3530
+ * Whether a connector's event stream carries changes:
3531
+ *
3532
+ * - `listening`: a stream carries them.
3533
+ * - `retrying`: no stream does, and the connector tries again by itself on
3534
+ * its retry steps.
3535
+ * - `unavailable`: no stream does, and the connector does not try again
3536
+ * until it docks again or is used again: no change events are served to
3537
+ * its dock, or its watch was refused for a cause a retry cannot change.
3538
+ */
3539
+ type ListeningState = "listening" | "retrying" | "unavailable";
3540
+ /** What a page or program is told of its connector's listening. */
3541
+ interface ChangeListener {
3542
+ /** A change arrived. Called in order, never while another call runs. */
3543
+ readonly onChange?: (change: ComputerChange) => void;
3544
+ /**
3545
+ * The connector's {@link ListeningState}: `listening` once a stream
3546
+ * delivers its first `reread`; `retrying` once an attempt to open one
3547
+ * fails and will be tried again; `unavailable` when no change events are
3548
+ * served to the dock, or the watch was refused for a cause a retry
3549
+ * cannot change. Called only when the state changes, and not while a
3550
+ * first attempt is in flight or a stream that ended is opened again.
3551
+ */
3552
+ readonly onListening?: (state: ListeningState) => void;
3553
+ }
3554
+
3152
3555
  /**
3153
3556
  * A terminal's size in character cells: `cols` and `rows` are whole
3154
3557
  * numbers from 1 to 10000 each.
@@ -3340,134 +3743,6 @@ interface ComputerFilesSession {
3340
3743
  close(): void;
3341
3744
  }
3342
3745
 
3343
- /** What the page asks of the Worker. Every request names a `ref` the page chose. */
3344
- type PageToWorker = {
3345
- readonly type: "start";
3346
- readonly ref: number;
3347
- readonly module: WebAssembly.Module | ArrayBuffer;
3348
- } | {
3349
- readonly type: "dock";
3350
- readonly ref: number;
3351
- readonly url: string;
3352
- readonly serverName: string;
3353
- readonly edgeId: string;
3354
- readonly edgeRoots: readonly Uint8Array[];
3355
- readonly chain: readonly Uint8Array[];
3356
- readonly lease: Uint8Array;
3357
- readonly keepaliveMs: number;
3358
- } | {
3359
- readonly type: "close-dock";
3360
- readonly ref: number;
3361
- readonly dock: number;
3362
- } | {
3363
- readonly type: "open-lane";
3364
- readonly ref: number;
3365
- readonly dock: number;
3366
- readonly principal: string;
3367
- } | {
3368
- readonly type: "open-computer";
3369
- readonly ref: number;
3370
- readonly dock: number;
3371
- readonly lane: number;
3372
- readonly hostPod: string;
3373
- readonly sequence: string;
3374
- readonly epoch: string;
3375
- readonly roots: readonly Uint8Array[];
3376
- readonly chain: readonly Uint8Array[];
3377
- readonly trustDomain: string;
3378
- readonly account: string;
3379
- readonly computer: string;
3380
- readonly minEpoch: string;
3381
- } | {
3382
- readonly type: "close-computer";
3383
- readonly ref: number;
3384
- readonly dock: number;
3385
- readonly computer: number;
3386
- } | {
3387
- readonly type: "open-stream";
3388
- readonly ref: number;
3389
- readonly dock: number;
3390
- readonly computer: number;
3391
- } | {
3392
- readonly type: "write";
3393
- readonly ref: number;
3394
- readonly dock: number;
3395
- readonly computer: number;
3396
- readonly stream: number;
3397
- readonly bytes: Uint8Array;
3398
- } | {
3399
- readonly type: "finish";
3400
- readonly ref: number;
3401
- readonly dock: number;
3402
- readonly computer: number;
3403
- readonly stream: number;
3404
- } | {
3405
- readonly type: "abort";
3406
- readonly ref: number;
3407
- readonly dock: number;
3408
- readonly computer: number;
3409
- readonly stream: number;
3410
- };
3411
- /** What the Worker tells the page. */
3412
- type WorkerToPage =
3413
- /** The answer to a request: its value, or why it failed. */
3414
- {
3415
- readonly type: "reply";
3416
- readonly ref: number;
3417
- readonly value?: unknown;
3418
- readonly error?: string;
3419
- }
3420
- /** The key exists: its certificate request (DER) and public key. */
3421
- | {
3422
- readonly type: "key";
3423
- readonly certificateRequest: Uint8Array;
3424
- readonly publicKey: Uint8Array;
3425
- } | {
3426
- readonly type: "docked";
3427
- readonly dock: number;
3428
- } | {
3429
- readonly type: "drain";
3430
- readonly dock: number;
3431
- readonly reason: string;
3432
- } | {
3433
- readonly type: "dock-ended";
3434
- readonly dock: number;
3435
- readonly reason: string;
3436
- readonly retryAfterMs?: number;
3437
- } | {
3438
- readonly type: "lane-ready";
3439
- readonly dock: number;
3440
- readonly lane: number;
3441
- } | {
3442
- readonly type: "lane-ended";
3443
- readonly dock: number;
3444
- readonly lane: number;
3445
- readonly reason: string;
3446
- } | {
3447
- readonly type: "computer-established";
3448
- readonly dock: number;
3449
- readonly computer: number;
3450
- readonly epoch: string;
3451
- } | {
3452
- readonly type: "computer-ended";
3453
- readonly dock: number;
3454
- readonly computer: number;
3455
- readonly reason: string;
3456
- readonly refusal?: number;
3457
- } | {
3458
- readonly type: "data";
3459
- readonly dock: number;
3460
- readonly computer: number;
3461
- readonly stream: number;
3462
- readonly bytes: Uint8Array;
3463
- } | {
3464
- readonly type: "stream-ended";
3465
- readonly dock: number;
3466
- readonly computer: number;
3467
- readonly stream: number;
3468
- readonly broken: boolean;
3469
- };
3470
-
3471
3746
  /**
3472
3747
  * Where a client keeps the highest session trust version it has accepted
3473
3748
  * for each Network and trust scope. `scope` is the opaque name the client's
@@ -3645,7 +3920,26 @@ interface ComputerConnector {
3645
3920
  * ends before the stream opens
3646
3921
  */
3647
3922
  openFiles(computer: string, handlers: FilesSessionHandlers): Promise<ComputerFilesSession>;
3648
- /** Ends every connection. */
3923
+ /**
3924
+ * The connector's {@link ListeningState}, as its listeners were last
3925
+ * told it; `undefined` while its first attempt to listen is in flight.
3926
+ * It stays `listening` while a stream that ended is opened again at once.
3927
+ * Waits pace themselves by whether a stream carries events at that
3928
+ * moment, not by this value.
3929
+ */
3930
+ readonly listening: ListeningState | undefined;
3931
+ /**
3932
+ * Calls `listener` with each change to the Computers of the connector's
3933
+ * own Namespace, and of no other, and each start and stop of the event
3934
+ * stream. A wait on a Computer of another Namespace pauses as with no
3935
+ * event stream. The connector listens from
3936
+ * {@link ComputerConnector.ready} or its first session on; nothing waits
3937
+ * for it.
3938
+ *
3939
+ * @returns the function that removes the listener
3940
+ */
3941
+ listen(listener: ChangeListener): () => void;
3942
+ /** Ends every connection, and the event stream. */
3649
3943
  close(): void;
3650
3944
  }
3651
3945
  /**
@@ -4123,6 +4417,15 @@ interface SaveOptions extends CallOptions {
4123
4417
  * Computer's history. `sdk` when absent.
4124
4418
  */
4125
4419
  readonly client?: "sdk" | "console" | "cli";
4420
+ /**
4421
+ * Called when the save starts waiting on a limit of its Account or its
4422
+ * Computer, with the limit, `SAVE_WAITING_FOR_PUBLICATION_TURN` or
4423
+ * `SAVE_REASON_PUBLICATION_HELD`, and for a hold the RFC 3339 instant it
4424
+ * ends; and with `undefined` when it stops waiting. It is called only when
4425
+ * that changes, as the save is read. The save goes on whatever it does,
4426
+ * and a callback that throws rejects the wait; the save itself goes on.
4427
+ */
4428
+ readonly onWaiting?: (waitingFor: string | undefined, waitingUntil: string | undefined) => void;
4126
4429
  }
4127
4430
  /** A save's outcome. */
4128
4431
  interface SaveResult {
@@ -4629,7 +4932,24 @@ interface ComputerSizeInfo {
4629
4932
  readonly default: boolean;
4630
4933
  }
4631
4934
  /**
4632
- * The Computers of the client's Namespace: `idyl.computers`.
4935
+ * How many of a Namespace's Computers attach one Secret, each count stopping
4936
+ * at 1,000.
4937
+ */
4938
+ interface ComputerSecretUsage {
4939
+ /** Every Computer whose settings attach it. */
4940
+ readonly computers: BoundedCount;
4941
+ /** Those where it is not attached, so its value is not sent. */
4942
+ readonly notAttached: BoundedCount;
4943
+ /** Those that follow its current version. */
4944
+ readonly following: BoundedCount;
4945
+ /** For each version asked about, in the order asked, the Computers pinned to it. */
4946
+ readonly pinned: readonly {
4947
+ readonly version: number;
4948
+ readonly count: BoundedCount;
4949
+ }[];
4950
+ }
4951
+ /**
4952
+ * Access Computers in the Account's default Namespace through `idyl.computers`.
4633
4953
  *
4634
4954
  * @example
4635
4955
  * ```ts
@@ -4671,23 +4991,46 @@ interface Computers {
4671
4991
  */
4672
4992
  get(name: string, options?: CallOptions): Promise<Computer>;
4673
4993
  /**
4674
- * Every Computer of the Account, page by page, as handles. Each holds the
4675
- * snapshot the listing read and acts on its Computer without reading it
4676
- * again, as a handle from `get` does.
4994
+ * The Computer with this ID, whatever it is called now.
4677
4995
  *
4678
- * @throws {@link TypeError} `limit` is not a positive integer
4679
- * @throws {@link ApiError} IDYL refuses a page's request
4996
+ * @param id the Computer's `id`, a canonical UUID
4997
+ * @throws {@link TypeError} `id` is not a canonical UUID, before any
4998
+ * request is sent
4999
+ * @throws {@link ApiError} IDYL refuses the read, such as for an ID the
5000
+ * Namespace does not hold (status 404)
5001
+ * @throws {@link TransportError} the request does not complete, or the
5002
+ * answer names another Account or Namespace
5003
+ */
5004
+ getById(id: string, options?: CallOptions): Promise<Computer>;
5005
+ /**
5006
+ * Every Computer of the Account, newest first, read page by page: each
5007
+ * page asks for the next from the position the last one returned, until a
5008
+ * page returns none. Each Computer is a handle that holds the snapshot the
5009
+ * listing read and acts on its Computer without reading it again, as a
5010
+ * handle from `get` does. A walk returns every Computer that exists for
5011
+ * the whole walk exactly once; one created during the walk is not
5012
+ * returned by it.
5013
+ *
5014
+ * @throws {@link TypeError} `limit` is not a positive integer or is above
5015
+ * the largest page
5016
+ * @throws {@link ApiError} IDYL refuses a page's request, such as
5017
+ * `ERROR_CODE_RATE_LIMITED` with the wait in `retryAfterMs`
4680
5018
  * @throws {@link TransportError} a page's request does not complete, or a
4681
5019
  * listed Computer belongs to another Account or Namespace
4682
5020
  */
4683
5021
  list(options?: ListOptions): AsyncIterable<Computer>;
4684
5022
  /**
4685
- * One page of the Account's Computers, as handles.
5023
+ * One page of the Account's Computers, newest first, as handles. `limit`
5024
+ * `undefined` takes the platform's page of 100; the platform's largest
5025
+ * page is 1,000. The first page, read with no `continue`, carries
5026
+ * `totalCount`, counted up to 1,000, and `totalCountIsLowerBound` when
5027
+ * the Account holds more.
4686
5028
  *
4687
- * @throws {@link TypeError} `limit` is not a positive integer, or
4688
- * `continue` is not a position this listing issued, before any request is
4689
- * sent
4690
- * @throws {@link ApiError} IDYL refuses the request
5029
+ * @throws {@link TypeError} `limit` is not a positive integer or is above
5030
+ * the largest page, before any request is sent
5031
+ * @throws {@link ApiError} IDYL refuses the request, such as a `continue`
5032
+ * this listing did not issue (`ERROR_CODE_INVALID_CONTINUE`), or
5033
+ * `ERROR_CODE_RATE_LIMITED` with the wait in `retryAfterMs`
4691
5034
  * @throws {@link TransportError} the request does not complete, or a
4692
5035
  * listed Computer belongs to another Account or Namespace
4693
5036
  */
@@ -4708,6 +5051,21 @@ interface Computers {
4708
5051
  * @throws {@link TransportError} the request does not complete
4709
5052
  */
4710
5053
  listBySecret(secretId: string, options?: CallOptions): Promise<readonly ComputerSecretUse[]>;
5054
+ /**
5055
+ * How many of the Namespace's Computers attach the Secret with this ID,
5056
+ * asleep or awake, counted without listing them: all of them, those where
5057
+ * it is not attached, those that follow its current version, and those
5058
+ * pinned to each version asked about, in the order asked. Each count stops
5059
+ * at 1,000. It reads no Secret.
5060
+ *
5061
+ * @param secretId a Secret's `id`, a canonical UUID
5062
+ * @throws {@link TypeError} `secretId` is not a canonical UUID, or
5063
+ * `versions` is not whole numbers of at least 1, at most 100 and none
5064
+ * twice, before any request is sent
5065
+ * @throws {@link ApiError} IDYL refuses the request
5066
+ * @throws {@link TransportError} the request does not complete
5067
+ */
5068
+ secretUsage(secretId: string, options?: UsageOptions): Promise<ComputerSecretUsage>;
4711
5069
  /**
4712
5070
  * The image catalogue a Computer can start from, for one isolation class:
4713
5071
  * `secure-container` unless `isolation` names another. Empty for a class
@@ -4807,14 +5165,6 @@ interface IdylOptions {
4807
5165
  * which the endpoints derive. Defaults to `idyl.sh`.
4808
5166
  */
4809
5167
  readonly network?: string;
4810
- /**
4811
- * The Namespace of the Account that `computers` and `secrets` address,
4812
- * such as `team-a`: 1 to 63 lowercase letters, digits, `.`, `_` and `-`,
4813
- * beginning and ending with a letter or a digit. Defaults to `default`,
4814
- * the Namespace every Account has. Another Namespace takes another
4815
- * client.
4816
- */
4817
- readonly namespace?: string;
4818
5168
  /**
4819
5169
  * The trust keys of the network, which commands and terminals verify the
4820
5170
  * network's session trust against. Defaults to the keys this package
@@ -4897,17 +5247,15 @@ declare class Idyl {
4897
5247
  */
4898
5248
  account(options?: CallOptions): Promise<Account>;
4899
5249
  /**
4900
- * The Computers of the client's Namespace: create, get, list, the image
4901
- * catalogue and the sizes.
5250
+ * Create, get and list Computers in the Account's default Namespace,
5251
+ * browse the image catalogue and list sizes.
4902
5252
  */
4903
5253
  get computers(): Computers;
4904
5254
  /**
4905
- * The Secrets of the client's Namespace, whose values IDYL adds to a
4906
- * Computer's requests to the origins each allows: create, get and delete.
5255
+ * Manage Secrets in the Account's default Namespace. IDYL adds each
5256
+ * Secret's value to Computer requests to the origins the Secret allows.
4907
5257
  */
4908
5258
  get secrets(): Secrets;
4909
- /** The Namespace the client addresses. */
4910
- get namespace(): string;
4911
5259
  /**
4912
5260
  * Sign-in for people and access keys: email codes, sign-up, profiles,
4913
5261
  * access tokens and access key exchanges.
@@ -5059,6 +5407,12 @@ declare const ERROR_CODE_UPLOAD_CANCELLED = "UPLOAD_CANCELLED";
5059
5407
  * A `continue` position the listing did not issue; list again with no position.
5060
5408
  */
5061
5409
  declare const ERROR_CODE_INVALID_CONTINUE = "INVALID_CONTINUE";
5410
+ /**
5411
+ * A request made faster than the Account's plan allows, such as creating or
5412
+ * listing Computers (HTTP 429). Nothing changed; the same request succeeds
5413
+ * after the wait the error carries in `retryAfterMs`.
5414
+ */
5415
+ declare const ERROR_CODE_RATE_LIMITED = "RATE_LIMITED";
5062
5416
  /**
5063
5417
  * The Account has used its month's allowance and its extra usage, and
5064
5418
  * auto-refill cannot buy more (HTTP 402). It refuses a session at once,
@@ -5141,6 +5495,6 @@ declare const ERROR_CODE_AUTO_REFILL_NEEDS_SPEND_CAP = "AUTO_REFILL_NEEDS_SPEND_
5141
5495
  * The code an `ApiError` carries. It is an open union: the platform may add
5142
5496
  * codes, which arrive as their own strings.
5143
5497
  */
5144
- type ApiErrorCode = typeof ERROR_CODE_EXECUTION_NOT_ENABLED | typeof ERROR_CODE_COMPUTER_TERMINATING | typeof ERROR_CODE_PROFILE_FITS_NO_HOST | typeof ERROR_CODE_WAKE_TIMEOUT | typeof ERROR_CODE_SESSION_BUDGET_EXCEEDED | typeof ERROR_CODE_INSUFFICIENT_CAPACITY | typeof ERROR_CODE_INSUFFICIENT_DISK | typeof ERROR_CODE_VERSION_DAMAGED | typeof ERROR_CODE_SAVE_FAILED | typeof ERROR_CODE_SLEEP_TIMEOUT | typeof ERROR_CODE_SESSION_FINAL | typeof ERROR_CODE_IMAGE_NOT_IN_CATALOG | typeof ERROR_CODE_COMPUTER_DOES_NOT_FIT | typeof ERROR_CODE_NETWORK_CLASS_NOT_ADMITTED | typeof ERROR_CODE_ISOLATION_CLASS_NOT_ADMITTED | typeof ERROR_CODE_CLIENT_UPGRADE_REQUIRED | typeof ERROR_CODE_SIZE_BELOW_USAGE | typeof ERROR_CODE_SIZE_ABOVE_CAP | typeof ERROR_CODE_VERSION_NOT_FOUND | typeof ERROR_CODE_FORK_NOT_QUIESCENT | typeof ERROR_CODE_PATH_INVALID | typeof ERROR_CODE_NAME_NOT_NFC | typeof ERROR_CODE_STORAGE_NOT_OPEN | typeof ERROR_CODE_HEAD_MOVED | typeof ERROR_CODE_UPLOAD_CONFLICT | typeof ERROR_CODE_UPLOAD_EXPIRED | typeof ERROR_CODE_UPLOAD_CANCELLED | typeof ERROR_CODE_INVALID_CONTINUE | typeof ERROR_CODE_OUT_OF_USAGE | typeof ERROR_CODE_SIZE_NOT_IN_PLAN | typeof ERROR_CODE_VCPU_LIMIT_REACHED | typeof ERROR_CODE_DOWNLOAD_LIMIT_REACHED | typeof ERROR_CODE_PAYMENT_DECLINED | typeof ERROR_CODE_PAYMENT_DISPUTED | typeof ERROR_CODE_ACTION_EXPIRED | typeof ERROR_CODE_PLAN_CHANGE_SUPERSEDED | typeof ERROR_CODE_PLAN_CHANGE_UNAVAILABLE | typeof ERROR_CODE_PLAN_NOT_OFFERED | typeof ERROR_CODE_EXTRA_USAGE_NOT_IN_PLAN | typeof ERROR_CODE_SPEND_CAP_REACHED | typeof ERROR_CODE_AUTO_REFILL_NEEDS_SPEND_CAP | typeof SAVE_REASON_ACCOUNT_STORAGE_LIMIT | typeof SAVE_REASON_COMPUTER_SIZE | typeof SAVE_REASON_NAME_LIMIT | (string & Record<never, never>);
5498
+ type ApiErrorCode = typeof ERROR_CODE_EXECUTION_NOT_ENABLED | typeof ERROR_CODE_COMPUTER_TERMINATING | typeof ERROR_CODE_PROFILE_FITS_NO_HOST | typeof ERROR_CODE_WAKE_TIMEOUT | typeof ERROR_CODE_SESSION_BUDGET_EXCEEDED | typeof ERROR_CODE_INSUFFICIENT_CAPACITY | typeof ERROR_CODE_INSUFFICIENT_DISK | typeof ERROR_CODE_VERSION_DAMAGED | typeof ERROR_CODE_SAVE_FAILED | typeof ERROR_CODE_SLEEP_TIMEOUT | typeof ERROR_CODE_SESSION_FINAL | typeof ERROR_CODE_IMAGE_NOT_IN_CATALOG | typeof ERROR_CODE_COMPUTER_DOES_NOT_FIT | typeof ERROR_CODE_NETWORK_CLASS_NOT_ADMITTED | typeof ERROR_CODE_ISOLATION_CLASS_NOT_ADMITTED | typeof ERROR_CODE_CLIENT_UPGRADE_REQUIRED | typeof ERROR_CODE_SIZE_BELOW_USAGE | typeof ERROR_CODE_SIZE_ABOVE_CAP | typeof ERROR_CODE_VERSION_NOT_FOUND | typeof ERROR_CODE_FORK_NOT_QUIESCENT | typeof ERROR_CODE_PATH_INVALID | typeof ERROR_CODE_NAME_NOT_NFC | typeof ERROR_CODE_STORAGE_NOT_OPEN | typeof ERROR_CODE_HEAD_MOVED | typeof ERROR_CODE_UPLOAD_CONFLICT | typeof ERROR_CODE_UPLOAD_EXPIRED | typeof ERROR_CODE_UPLOAD_CANCELLED | typeof ERROR_CODE_INVALID_CONTINUE | typeof ERROR_CODE_RATE_LIMITED | typeof ERROR_CODE_OUT_OF_USAGE | typeof ERROR_CODE_SIZE_NOT_IN_PLAN | typeof ERROR_CODE_VCPU_LIMIT_REACHED | typeof ERROR_CODE_DOWNLOAD_LIMIT_REACHED | typeof ERROR_CODE_PAYMENT_DECLINED | typeof ERROR_CODE_PAYMENT_DISPUTED | typeof ERROR_CODE_ACTION_EXPIRED | typeof ERROR_CODE_PLAN_CHANGE_SUPERSEDED | typeof ERROR_CODE_PLAN_CHANGE_UNAVAILABLE | typeof ERROR_CODE_PLAN_NOT_OFFERED | typeof ERROR_CODE_EXTRA_USAGE_NOT_IN_PLAN | typeof ERROR_CODE_SPEND_CAP_REACHED | typeof ERROR_CODE_AUTO_REFILL_NEEDS_SPEND_CAP | typeof SAVE_REASON_ACCOUNT_STORAGE_LIMIT | typeof SAVE_REASON_COMPUTER_SIZE | typeof SAVE_REASON_NAME_LIMIT | (string & Record<never, never>);
5145
5499
 
5146
- export { type AccessKey, type AccessKeyFile, type AccessKeys, type AccessToken, type Account, type AccountBilling, type AccountBillingSpec, type AccountBillingStatus, type AccountId, ApiError, type ApiErrorCode, type ApiErrorOptions, type Awake, type AwakeHold, type Billing, type BillingAction, type BillingActionKind, type BillingAllowanceWithheld, type BillingAutoRefill, type BillingAutoRefillStop, type BillingLifecycle, type BillingPlan, type BillingPlanChange, type BillingPlanChangeState, type BillingPlanOffer, type BillingPortalSession, type BillingPurchase, type BillingPurchaseKind, type BillingPurchaseState, type BillingPurchases, type BillingRenewalState, type BillingScheduledChange, type BillingSizePlan, type BillingSizeRate, type BillingStanding, type BrowserAuthorization, type BrowserAuthorizationRequest, type BrowserExchangeRequest, type CallOptions, type ChangeOptions, type CommandOutput, type CommandSave, CommandSaveError, CommandSessionError, Computer, type ComputerConnector, type ComputerFilesSession, type ComputerImage, type ComputerInfo, ComputerNotAwakeError, type ComputerSecretUse, ComputerSessionEndedError, type ComputerSessionStream, type ComputerSettingsOptions, type ComputerSize, type ComputerSizeInfo, type Computers, type ConnectorOptions, type CreateAccessKeyOptions, type CreateComputerOptions, type CreatePlanChangeOptions, type CreatePurchaseOptions, type CreateSecretOptions, type CreatedAccessKey, type Credential, type CredentialContext, type CredentialSource, type Decryption, type DeleteAccountResult, type DeleteComputerOptions, type Delivery, type DownloadLink, type DownloadLinkOptions, type DownloadOptions, type DownloadProgress, ERROR_CODE_ACTION_EXPIRED, ERROR_CODE_AUTO_REFILL_NEEDS_SPEND_CAP, ERROR_CODE_CLIENT_UPGRADE_REQUIRED, ERROR_CODE_COMPUTER_DOES_NOT_FIT, ERROR_CODE_COMPUTER_NOT_AWAKE, ERROR_CODE_COMPUTER_TERMINATING, ERROR_CODE_DOWNLOAD_LIMIT_REACHED, ERROR_CODE_EXECUTION_NOT_ENABLED, ERROR_CODE_EXTRA_USAGE_NOT_IN_PLAN, ERROR_CODE_FORK_NOT_QUIESCENT, ERROR_CODE_HEAD_MOVED, ERROR_CODE_IMAGE_NOT_IN_CATALOG, ERROR_CODE_INSUFFICIENT_CAPACITY, ERROR_CODE_INSUFFICIENT_DISK, ERROR_CODE_INVALID_CONTINUE, ERROR_CODE_ISOLATION_CLASS_NOT_ADMITTED, ERROR_CODE_NAME_NOT_NFC, ERROR_CODE_NETWORK_CLASS_NOT_ADMITTED, ERROR_CODE_OUT_OF_USAGE, ERROR_CODE_PATH_INVALID, ERROR_CODE_PAYMENT_DECLINED, ERROR_CODE_PAYMENT_DISPUTED, ERROR_CODE_PLAN_CHANGE_SUPERSEDED, ERROR_CODE_PLAN_CHANGE_UNAVAILABLE, ERROR_CODE_PLAN_NOT_OFFERED, ERROR_CODE_PROFILE_FITS_NO_HOST, ERROR_CODE_SAVE_FAILED, ERROR_CODE_SESSION_BUDGET_EXCEEDED, ERROR_CODE_SESSION_FINAL, ERROR_CODE_SIZE_ABOVE_CAP, ERROR_CODE_SIZE_BELOW_USAGE, ERROR_CODE_SIZE_NOT_IN_PLAN, ERROR_CODE_SLEEP_TIMEOUT, ERROR_CODE_SPEND_CAP_REACHED, ERROR_CODE_STORAGE_NOT_OPEN, ERROR_CODE_UPLOAD_CANCELLED, ERROR_CODE_UPLOAD_CONFLICT, ERROR_CODE_UPLOAD_EXPIRED, ERROR_CODE_VCPU_LIMIT_REACHED, ERROR_CODE_VERSION_DAMAGED, ERROR_CODE_VERSION_NOT_FOUND, ERROR_CODE_WAKE_TIMEOUT, type EndpointFrame, type Endpoints, type ExecOptions, type ExecResult, type ExecutionSettings, ExitError, type FileBody, type FileChange, type FileData, type FileEntry, type FilePublication, type FileStatus, type FileStoreWait, type Files, type FilesSessionEnding, type FilesSessionHandlers, type FolderEntry, type FolderEntryType, type FolderListing, type FolderProblem, type FolderStatus, type ForkOptions, FrameError, type HistoryEntry, type Identity, Idyl, type IdylOptions, type ImageShell, type ImagesOptions, type ListFilesOptions, type ListOptions, MICROS_PER_DOLLAR, type OpenSession, type Page, type PageOptions, type ParseAccessKeyFileOptions, type PlacementMemory, type Profile, type ProfileId, type ProfileSelector, type PurgeSecretOptions, type RefreshCredential, type ReplacedPath, type RestoreOptions, type RestoreResult, type RotateSecretOptions, SAVE_REASON_ACCOUNT_STORAGE_LIMIT, SAVE_REASON_COMPUTER_SIZE, SAVE_REASON_NAME_LIMIT, type SaveOptions, type SaveResult, type Secret, type SecretAttachment, type SecretAttachmentStatus, type SecretContentOptions, type SecretCredential, type SecretKey, type SecretPurge, type SecretSource, type SecretVersion, type SecretVersionsOptions, type Secrets, type SessionOpen, type SessionOutput, SessionTrustError, type SignIn, type SignInOptions, type SignUp, type SignUpOffer, type SignUpRequest, type SizeBelowUsageDetails, type SizeNotInPlanDetails, type SleepOptions, type SleepResult, type SpendCapReachedDetails, type TerminalOptions, type TerminalSize, TransportError, type TransportErrorCode, type TrustFloor, type TrustKey, type UpdateBillingOptions, type UpdateComputerOptions, type UploadOptions, type UploadProgress, type Uploaded, type Version, type WakeOptions, type WakeResult, type WorkerPort, accessKeyCredentials, credentialSourceFunc, encodeAccessKeyFile, isApiCode, isBillingPlanChangeStateFinal, isBillingPurchaseStateFinal, isOutOfUsage, keyThumbprint, parseAccessKeyFile, parseAccountId, parseProfileId, sizeBelowUsage, sizeNotInPlan, spendCapReached, staticCredential };
5500
+ export { type AccessKey, type AccessKeyFile, type AccessKeys, type AccessToken, type Account, type AccountBilling, type AccountBillingSpec, type AccountBillingStatus, type AccountId, ApiError, type ApiErrorCode, type ApiErrorOptions, type Awake, type AwakeHold, type Billing, type BillingAction, type BillingActionKind, type BillingAllowanceWithheld, type BillingAutoRefill, type BillingAutoRefillStop, type BillingLifecycle, type BillingPlan, type BillingPlanChange, type BillingPlanChangeState, type BillingPlanOffer, type BillingPortalSession, type BillingPurchase, type BillingPurchaseKind, type BillingPurchaseState, type BillingPurchases, type BillingRenewalState, type BillingScheduledChange, type BillingSizePlan, type BillingSizeRate, type BillingStanding, type BoundedCount, type BrowserAuthorization, type BrowserAuthorizationRequest, type BrowserExchangeRequest, type CallOptions, type ChangeListener, type ChangeOptions, type CommandOutput, type CommandSave, CommandSaveError, CommandSessionError, Computer, type ComputerChange, type ComputerConnector, type ComputerEventPart, type ComputerFilesSession, type ComputerImage, type ComputerInfo, ComputerNotAwakeError, type ComputerSecretUsage, type ComputerSecretUse, ComputerSessionEndedError, type ComputerSessionStream, type ComputerSettingsOptions, type ComputerSize, type ComputerSizeInfo, type Computers, type ConnectorOptions, type CreateAccessKeyOptions, type CreateComputerOptions, type CreatePlanChangeOptions, type CreatePurchaseOptions, type CreateSecretOptions, type CreatedAccessKey, type Credential, type CredentialContext, type CredentialSource, type Decryption, type DecryptionsOptions, type DecryptionsPageOptions, type DeleteAccountResult, type DeleteComputerOptions, type Delivery, type DownloadLink, type DownloadLinkOptions, type DownloadOptions, type DownloadProgress, ERROR_CODE_ACTION_EXPIRED, ERROR_CODE_AUTO_REFILL_NEEDS_SPEND_CAP, ERROR_CODE_CLIENT_UPGRADE_REQUIRED, ERROR_CODE_COMPUTER_DOES_NOT_FIT, ERROR_CODE_COMPUTER_NOT_AWAKE, ERROR_CODE_COMPUTER_TERMINATING, ERROR_CODE_DOWNLOAD_LIMIT_REACHED, ERROR_CODE_EXECUTION_NOT_ENABLED, ERROR_CODE_EXTRA_USAGE_NOT_IN_PLAN, ERROR_CODE_FORK_NOT_QUIESCENT, ERROR_CODE_HEAD_MOVED, ERROR_CODE_IMAGE_NOT_IN_CATALOG, ERROR_CODE_INSUFFICIENT_CAPACITY, ERROR_CODE_INSUFFICIENT_DISK, ERROR_CODE_INVALID_CONTINUE, ERROR_CODE_ISOLATION_CLASS_NOT_ADMITTED, ERROR_CODE_NAME_NOT_NFC, ERROR_CODE_NETWORK_CLASS_NOT_ADMITTED, ERROR_CODE_OUT_OF_USAGE, ERROR_CODE_PATH_INVALID, ERROR_CODE_PAYMENT_DECLINED, ERROR_CODE_PAYMENT_DISPUTED, ERROR_CODE_PLAN_CHANGE_SUPERSEDED, ERROR_CODE_PLAN_CHANGE_UNAVAILABLE, ERROR_CODE_PLAN_NOT_OFFERED, ERROR_CODE_PROFILE_FITS_NO_HOST, ERROR_CODE_RATE_LIMITED, ERROR_CODE_SAVE_FAILED, ERROR_CODE_SESSION_BUDGET_EXCEEDED, ERROR_CODE_SESSION_FINAL, ERROR_CODE_SIZE_ABOVE_CAP, ERROR_CODE_SIZE_BELOW_USAGE, ERROR_CODE_SIZE_NOT_IN_PLAN, ERROR_CODE_SLEEP_TIMEOUT, ERROR_CODE_SPEND_CAP_REACHED, ERROR_CODE_STORAGE_NOT_OPEN, ERROR_CODE_UPLOAD_CANCELLED, ERROR_CODE_UPLOAD_CONFLICT, ERROR_CODE_UPLOAD_EXPIRED, ERROR_CODE_VCPU_LIMIT_REACHED, ERROR_CODE_VERSION_DAMAGED, ERROR_CODE_VERSION_NOT_FOUND, ERROR_CODE_WAKE_TIMEOUT, type EndpointFrame, type Endpoints, type ExecOptions, type ExecResult, type ExecutionSettings, ExitError, type FileBody, type FileChange, type FileData, type FileEntry, type FilePublication, type FileStatus, type FileStoreWait, type Files, type FilesSessionEnding, type FilesSessionHandlers, type FolderEntry, type FolderEntryType, type FolderListing, type FolderProblem, type FolderStatus, type ForkOptions, FrameError, type HistoryEntry, type Identity, Idyl, type IdylOptions, type ImageShell, type ImagesOptions, type ListFilesOptions, type ListFilesPageOptions, type ListOptions, type ListeningState, MICROS_PER_DOLLAR, type OpenSession, type Page, type PageOptions, type ParseAccessKeyFileOptions, type PlacementMemory, type Profile, type ProfileId, type ProfileSelector, type PurgeSecretOptions, type RefreshCredential, type ReplacedPath, type RestoreOptions, type RestoreResult, type RotateSecretOptions, SAVE_REASON_ACCOUNT_STORAGE_LIMIT, SAVE_REASON_ACCOUNT_TURN_WAITING, SAVE_REASON_COMPUTER_SIZE, SAVE_REASON_NAME_LIMIT, SAVE_REASON_PUBLICATION_HELD, SAVE_WAITING_FOR_PUBLICATION_TURN, type SaveOptions, type SaveResult, type Secret, type SecretAttachment, type SecretAttachmentStatus, type SecretContentOptions, type SecretCredential, type SecretKey, type SecretPurge, type SecretSource, type SecretUsage, type SecretVersion, type SecretVersionsOptions, type Secrets, type SessionOpen, type SessionOutput, SessionTrustError, type SignIn, type SignInOptions, type SignUp, type SignUpOffer, type SignUpRequest, type SizeBelowUsageDetails, type SizeNotInPlanDetails, type SleepOptions, type SleepResult, type SpendCapReachedDetails, type TerminalOptions, type TerminalSize, TransportError, type TransportErrorCode, type TrustFloor, type TrustKey, type UpdateBillingOptions, type UpdateComputerOptions, type UploadOptions, type UploadProgress, type Uploaded, type UsageOptions, type Version, type WakeOptions, type WakeResult, type WorkerPort, accessKeyCredentials, credentialSourceFunc, encodeAccessKeyFile, isApiCode, isBillingPlanChangeStateFinal, isBillingPurchaseStateFinal, isOutOfUsage, keyThumbprint, parseAccessKeyFile, parseAccountId, parseProfileId, sizeBelowUsage, sizeNotInPlan, spendCapReached, staticCredential };