@crowdedkingdoms/crowdyjs 17.9.0-dev.1 → 17.11.0-dev.1

package/dist/domains/exec.d.ts

@@ -1,6 +1,7 @@
 import type { DecoderOptions } from '@msgpack/msgpack';
 import type { GraphQLClient } from '../client.js';
 import { CrowdyError } from '../errors.js';
+import { type ExecAppStatusFieldsFragment, type ExecBuildFieldsFragment, type ExecInstancesQuery, type ExecLogsQuery, type ExecVersionsQuery } from '../generated/graphql.js';
 /**
  * ck-exec, the hub-and-spoke execution service (dev-tier preview).
  *
@@ -180,7 +181,9 @@ export declare class ExecConnection {
 export interface ExecNodeTypeInput {
     kind: 'hub' | 'spoke';
     /** The compiled module (`wasm32-unknown-unknown`, built with `ckx-sdk`). */
-    wasm: Uint8Array;
+    wasm?: Uint8Array;
+    /** Instead of `wasm`: a crate of the deploy's `buildId`. */
+    crate?: string;
     /** The type that owns this one; none for the root. */
     parent?: string;
     /** Clients may call it through the gateway. */
@@ -195,11 +198,126 @@ export interface ExecDeployOptions {
     /** The root hub's type name. */
     root: string;
     types: Record<string, ExecNodeTypeInput>;
+    /** A succeeded {@link ExecAPI.build} of this app whose crates the types may name. */
+    buildId?: string;
 }
-/** `client.exec`: connecting players to ck-exec, and deploying an app's nodes. */
+/** One crate for {@link ExecAPI.build}: its files by path (`Cargo.toml`, `src/lib.rs`, ...). */
+export interface ExecCrate {
+    name: string;
+    files: Record<string, string> | ExecSourceFile[];
+}
+export interface ExecSourceFile {
+    path: string;
+    content: string;
+}
+/** A build: `queued`, `building`, `succeeded` or `failed`, its log, and one module per crate. */
+export type ExecBuild = Omit<ExecBuildFieldsFragment, '__typename' | 'artifacts'> & {
+    artifacts: Array<{
+        crate: string;
+        digest: string;
+        sizeBytes: number;
+    }>;
+};
+/** A starter crate, with its files ready for {@link ExecAPI.build}. */
+export interface ExecStarter {
+    crate: string;
+    nodeType: string;
+    description: string;
+    files: ExecSourceFile[];
+}
+/** The starter packs, and the manifest that deploys them as one app, its types naming their crates. */
+export interface ExecStarterPack {
+    manifest: {
+        root: string;
+        types: Record<string, ExecNodeTypeInput>;
+    };
+    starters: ExecStarter[];
+}
+/** One guest log line (`ctx.log`); `level` is 0 error, 1 warn, 2 info, 3 debug. */
+export type ExecLogLine = Omit<ExecLogsQuery['execLogs'][number], '__typename'>;
+/** An instance the execution manager has placed. */
+export type ExecInstance = Omit<ExecInstancesQuery['execInstances'][number], '__typename'>;
+/** A deployed version. */
+export type ExecVersion = Omit<ExecVersionsQuery['execVersions'][number], '__typename'>;
+/** An app's active version, kill switches and budget pause. */
+export type ExecAppStatus = Omit<ExecAppStatusFieldsFragment, '__typename'>;
+export interface ExecLogsOptions {
+    nodeType?: string;
+    key?: string;
+    /** The least severe level included: 0 errors only … 3 everything (the default). */
+    maxLevel?: number;
+    /** Only lines older than this line id, to page back. */
+    before?: string;
+    /** At most this many lines (default 100, at most 500). */
+    limit?: number;
+}
+/**
+ * `client.exec`: connecting players to ck-exec, building and deploying an app's nodes (and
+ * the starter packs), and operating them (logs, instances, versions, rollback, the kill
+ * switch, developer connections).
+ */
 export declare class ExecAPI {
     private readonly graphql;
     constructor(graphql: GraphQLClient);
+    /**
+     * A host and a developer connect token for `appId` (valid for about a minute). The
+     * session's calls arrive as `Caller::Developer` with your user id and may reach any
+     * node type, not only `client` ones. Requires the org `manage_compute` permission and
+     * your own session token, not an app token.
+     */
+    developerEndpoint(appId: string, options?: {
+        nodeType?: string;
+        key?: string;
+    }): Promise<ExecEndpoint & {
+        expiresAt: string;
+    }>;
+    /**
+     * Connects as one of the app's developers, for studio tools, manual runs and admin
+     * endpoints. The same connection as {@link connect}, reconnecting with a fresh
+     * developer token.
+     */
+    connectAsDeveloper(appId: string, options?: ExecConnectOptions): Promise<ExecConnection>;
+    /** Guest log lines, newest first, kept for 24 hours. Requires `view_compute_diagnostics`. */
+    logs(appId: string, options?: ExecLogsOptions): Promise<ExecLogLine[]>;
+    /** What the manager has placed for the app. Requires `view_compute_diagnostics`. */
+    instances(appId: string): Promise<ExecInstance[]>;
+    /** The app's versions, newest first. Requires `view_compute_diagnostics`. */
+    versions(appId: string): Promise<ExecVersion[]>;
+    /** The active version and the switches. Requires `view_compute_diagnostics`. */
+    status(appId: string): Promise<ExecAppStatus>;
+    /**
+     * Makes an earlier version active again, a rollback; instances pick it up when they
+     * next start. Requires `manage_compute`.
+     */
+    activateVersion(appId: string, version: number): Promise<ExecAppStatus>;
+    /**
+     * The kill switch, for the whole app or one node type. Off: nothing of it is placed,
+     * what runs is persisted and stopped, and calls are refused with `Denied`. Requires
+     * `manage_compute`.
+     */
+    setEnabled(appId: string, enabled: boolean, nodeType?: string): Promise<ExecAppStatus>;
+    /**
+     * The starter packs, which replace the compute templates: a world tick (the root hub), a
+     * matchmaker, game sessions and an NPC and mob engine. Build them with {@link build} and
+     * deploy the build with `manifest`. Requires `manage_compute`.
+     */
+    starters(appId: string): Promise<ExecStarterPack>;
+    /**
+     * Builds crates into modules on the platform (`ckx-sdk`, `wasm32-unknown-unknown`), so you
+     * need no Rust toolchain. Returns at once with the build queued; wait with
+     * {@link waitForBuild}, then {@link deploy} with its `buildId`. Requires `manage_compute`.
+     */
+    build(appId: string, crates: ExecCrate[]): Promise<ExecBuild>;
+    /** A build's status, log and modules, or null. Requires `view_compute_diagnostics`. */
+    buildStatus(appId: string, buildId: string): Promise<ExecBuild | null>;
+    /**
+     * Polls a build until it succeeds or fails, and returns it either way; a failed build's
+     * `log` says why. Throws when it is not done in `timeoutMs` (default 10 minutes).
+     */
+    waitForBuild(appId: string, buildId: string, options?: {
+        intervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<ExecBuild>;
     /** A host for this player and its connect token (valid for about a minute). */
     endpoint(appId: string, options?: {
         nodeType?: string;
@@ -215,8 +333,9 @@ export declare class ExecAPI {
     connect(appId: string, options?: ExecConnectOptions): Promise<ExecConnection>;
     /**
      * Deploys a new version of the app's nodes and makes it active: the manifest, and
-     * each distinct module once. Running instances pick it up when they next start.
-     * Requires the org `manage_compute` permission.
+     * each distinct module once. A type gives its module as `wasm`, or names a `crate` of
+     * `buildId`, whose modules the platform already holds. Running instances pick it up
+     * when they next start. Requires the org `manage_compute` permission.
      */
     deploy(options: ExecDeployOptions): Promise<{
         version: number;

package/dist/domains/exec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/domains/exec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/domains/exec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAGL,KAAK,2BAA2B,EAEhC,KAAK,uBAAuB,EAQ5B,KAAK,kBAAkB,EAEvB,KAAK,aAAa,EAIlB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,oFAAoF;AACpF,eAAO,MAAM,aAAa,2JAahB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;AAEpE,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAEpD;AASD;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;gBAEhB,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAKjE;AAID,4CAA4C;AAC5C,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,UAAU,CAAC;CACrB,GACD;IACE,IAAI,EAAE,WAAW,GAAG,aAAa,CAAC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,4CAA4C;AAC5C,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GACnE;IACE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,CAAC;CACrB,GACD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AA6CpC,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,CAAC,EAAE,eAAe,GAAG,UAAU,CAuB9D;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,CA8ClE;AAID,oEAAoE;AACpE,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAEvE,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0EAA0E;AAC1E,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,iGAAiG;IACjG,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAwBD;;;GAGG;AACH,qBAAa,cAAc;IAevB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAf1B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgD;IACrE,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqC;IACxE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC,4EAA4E;gBAEzD,IAAI,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,EACjC,OAAO,GAAE,kBAAuB;IAanD;;;OAGG;WACU,IAAI,CACf,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAM,GAClD,OAAO,CAAC,cAAc,CAAC;IAS1B,gDAAgD;IAChD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,sDAAsD;IACtD,WAAW,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAKzD,gBAAgB;IACV,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAUhB,QAAQ;IAwCtB,OAAO,CAAC,SAAS;IA4CjB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,QAAQ;YAQF,SAAS;IAcvB;;;OAGG;YACW,MAAM;YAmBN,kBAAkB;IAOhC,OAAO,CAAC,GAAG;IAMX,4DAA4D;YAC9C,OAAO;IAuBrB;;;;;OAKG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,UAA6B,EACtC,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,UAAU,CAAC;IAqBtB;;;OAGG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,CAAC,CAAC;IAMb;;;OAGG;IACG,SAAS,CAAC,CAAC,GAAG,OAAO,EACzB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IA8B/B,kDAAkD;IAC5C,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAM7B,oDAAoD;IACpD,KAAK,IAAI,IAAI;CAMd;AAQD,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,kFAAkF;IAClF,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACzC,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,gGAAgG;AAChG,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,EAAE,CAAC;CAClD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iGAAiG;AACjG,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,uBAAuB,EAAE,YAAY,GAAG,WAAW,CAAC,GAAG;IAClF,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxE,CAAC;AAEF,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,uGAAuG;AACvG,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;KAAE,CAAC;IACrE,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAeD,mFAAmF;AACnF,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC;AAChF,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC;AAC3F,0BAA0B;AAC1B,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC;AACxF,+DAA+D;AAC/D,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,2BAA2B,EAAE,YAAY,CAAC,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD;;;;GAIG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAEnD;;;;;OAKG;IACG,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,GAChD,OAAO,CAAC,YAAY,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAShD;;;;OAIG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IASlG,6FAA6F;IACvF,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKhF,oFAAoF;IAC9E,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAKvD,6EAA6E;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKrD,gFAAgF;IAC1E,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAKnD;;;OAGG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAK7E;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAK5F;;;;OAIG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAavD;;;;OAIG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAenE,uFAAuF;IACjF,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAK5E;;;OAGG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACxD,OAAO,CAAC,SAAS,CAAC;IAWrB,+EAA+E;IACzE,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,GAChD,OAAO,CAAC,YAAY,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAShD;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IASvF;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CA0BvE"}

package/dist/domains/exec.js

@@ -1,6 +1,6 @@
 import { decode, encode } from '@msgpack/msgpack';
 import { CrowdyError } from '../errors.js';
-import { ExecConnectDocument, ExecDeployDocument, } from '../generated/graphql.js';
+import { ExecActivateVersionDocument, ExecAppStatusDocument, ExecBuildDocument, ExecBuildStatusDocument, ExecConnectAsDeveloperDocument, ExecConnectDocument, ExecDeployDocument, ExecInstancesDocument, ExecLogsDocument, ExecSetEnabledDocument, ExecStartersDocument, ExecVersionsDocument, } from '../generated/graphql.js';
 /**
  * ck-exec, the hub-and-spoke execution service (dev-tier preview).
  *
@@ -512,11 +512,142 @@ async function sha256Hex(bytes) {
     const d = new Uint8Array(await crypto.subtle.digest('SHA-256', bytes));
     return Array.from(d, (x) => x.toString(16).padStart(2, '0')).join('');
 }
-/** `client.exec`: connecting players to ck-exec, and deploying an app's nodes. */
+function strip(v) {
+    const { __typename: _, ...rest } = v;
+    return rest;
+}
+function build(b) {
+    const { __typename: _, artifacts, ...rest } = b;
+    return { ...rest, artifacts: artifacts.map(strip) };
+}
+/**
+ * `client.exec`: connecting players to ck-exec, building and deploying an app's nodes (and
+ * the starter packs), and operating them (logs, instances, versions, rollback, the kill
+ * switch, developer connections).
+ */
 export class ExecAPI {
     constructor(graphql) {
         this.graphql = graphql;
     }
+    /**
+     * A host and a developer connect token for `appId` (valid for about a minute). The
+     * session's calls arrive as `Caller::Developer` with your user id and may reach any
+     * node type, not only `client` ones. Requires the org `manage_compute` permission and
+     * your own session token, not an app token.
+     */
+    async developerEndpoint(appId, options = {}) {
+        const data = await this.graphql.request(ExecConnectAsDeveloperDocument, {
+            appId,
+            nodeType: options.nodeType,
+            key: options.key,
+        });
+        return data.execConnectAsDeveloper;
+    }
+    /**
+     * Connects as one of the app's developers, for studio tools, manual runs and admin
+     * endpoints. The same connection as {@link connect}, reconnecting with a fresh
+     * developer token.
+     */
+    async connectAsDeveloper(appId, options = {}) {
+        const c = new ExecConnection(() => this.developerEndpoint(appId, { nodeType: options.nodeType, key: options.key }), options);
+        await c.connect();
+        return c;
+    }
+    /** Guest log lines, newest first, kept for 24 hours. Requires `view_compute_diagnostics`. */
+    async logs(appId, options = {}) {
+        const data = await this.graphql.request(ExecLogsDocument, { appId, ...options });
+        return data.execLogs.map(strip);
+    }
+    /** What the manager has placed for the app. Requires `view_compute_diagnostics`. */
+    async instances(appId) {
+        const data = await this.graphql.request(ExecInstancesDocument, { appId });
+        return data.execInstances.map(strip);
+    }
+    /** The app's versions, newest first. Requires `view_compute_diagnostics`. */
+    async versions(appId) {
+        const data = await this.graphql.request(ExecVersionsDocument, { appId });
+        return data.execVersions.map(strip);
+    }
+    /** The active version and the switches. Requires `view_compute_diagnostics`. */
+    async status(appId) {
+        const data = await this.graphql.request(ExecAppStatusDocument, { appId });
+        return strip(data.execAppStatus);
+    }
+    /**
+     * Makes an earlier version active again, a rollback; instances pick it up when they
+     * next start. Requires `manage_compute`.
+     */
+    async activateVersion(appId, version) {
+        const data = await this.graphql.request(ExecActivateVersionDocument, { appId, version });
+        return strip(data.execActivateVersion);
+    }
+    /**
+     * The kill switch, for the whole app or one node type. Off: nothing of it is placed,
+     * what runs is persisted and stopped, and calls are refused with `Denied`. Requires
+     * `manage_compute`.
+     */
+    async setEnabled(appId, enabled, nodeType) {
+        const data = await this.graphql.request(ExecSetEnabledDocument, { appId, enabled, nodeType });
+        return strip(data.execSetEnabled);
+    }
+    /**
+     * The starter packs, which replace the compute templates: a world tick (the root hub), a
+     * matchmaker, game sessions and an NPC and mob engine. Build them with {@link build} and
+     * deploy the build with `manifest`. Requires `manage_compute`.
+     */
+    async starters(appId) {
+        const data = await this.graphql.request(ExecStartersDocument, { appId });
+        return {
+            manifest: JSON.parse(data.execStarters.manifestJson),
+            starters: data.execStarters.starters.map((s) => ({
+                crate: s.crate,
+                nodeType: s.nodeType,
+                description: s.description,
+                files: s.files.map(strip),
+            })),
+        };
+    }
+    /**
+     * Builds crates into modules on the platform (`ckx-sdk`, `wasm32-unknown-unknown`), so you
+     * need no Rust toolchain. Returns at once with the build queued; wait with
+     * {@link waitForBuild}, then {@link deploy} with its `buildId`. Requires `manage_compute`.
+     */
+    async build(appId, crates) {
+        const data = await this.graphql.request(ExecBuildDocument, {
+            input: {
+                appId,
+                crates: crates.map((c) => ({
+                    name: c.name,
+                    files: Array.isArray(c.files)
+                        ? c.files
+                        : Object.entries(c.files).map(([path, content]) => ({ path, content })),
+                })),
+            },
+        });
+        return build(data.execBuild);
+    }
+    /** A build's status, log and modules, or null. Requires `view_compute_diagnostics`. */
+    async buildStatus(appId, buildId) {
+        const data = await this.graphql.request(ExecBuildStatusDocument, { appId, buildId });
+        return data.execBuildStatus ? build(data.execBuildStatus) : null;
+    }
+    /**
+     * Polls a build until it succeeds or fails, and returns it either way; a failed build's
+     * `log` says why. Throws when it is not done in `timeoutMs` (default 10 minutes).
+     */
+    async waitForBuild(appId, buildId, options = {}) {
+        const until = Date.now() + (options.timeoutMs ?? 600000);
+        for (;;) {
+            const b = await this.buildStatus(appId, buildId);
+            if (!b)
+                throw new CrowdyError({ message: `no build ${buildId} in app ${appId}` });
+            if (b.status === 'succeeded' || b.status === 'failed')
+                return b;
+            if (Date.now() > until)
+                throw new CrowdyError({ message: `build ${buildId} is still ${b.status}` });
+            await new Promise((r) => setTimeout(r, options.intervalMs ?? 2000));
+        }
+    }
     /** A host for this player and its connect token (valid for about a minute). */
     async endpoint(appId, options = {}) {
         const data = await this.graphql.request(ExecConnectDocument, {
@@ -538,14 +669,22 @@ export class ExecAPI {
     }
     /**
      * Deploys a new version of the app's nodes and makes it active: the manifest, and
-     * each distinct module once. Running instances pick it up when they next start.
-     * Requires the org `manage_compute` permission.
+     * each distinct module once. A type gives its module as `wasm`, or names a `crate` of
+     * `buildId`, whose modules the platform already holds. Running instances pick it up
+     * when they next start. Requires the org `manage_compute` permission.
      */
     async deploy(options) {
         const types = {};
         const artifacts = new Map();
         for (const [name, t] of Object.entries(options.types)) {
             const { wasm, ...spec } = t;
+            if (!wasm) {
+                if (!spec.crate || !options.buildId) {
+                    throw new CrowdyError({ message: `type '${name}' needs its wasm, or a crate of the deploy's buildId` });
+                }
+                types[name] = spec;
+                continue;
+            }
             const digest = await sha256Hex(wasm);
             if (!artifacts.has(digest))
                 artifacts.set(digest, base64(wasm));
@@ -556,6 +695,7 @@ export class ExecAPI {
                 appId: options.appId,
                 manifestJson: JSON.stringify({ root: options.root, types }),
                 artifacts: [...artifacts].map(([digest, wasmBase64]) => ({ digest, wasmBase64 })),
+                buildId: options.buildId,
             },
         });
         return data.execDeploy;