@rivetkit/engine-api-full 0.0.0-main.d6a0ba8

package/package.json

@@ -0,0 +1,68 @@
+{
+	"name": "@rivetkit/engine-api-full",
+	"version": "0.0.0-main.d6a0ba8",
+	"repository": "https://github.com/rivet-dev/rivet/tree/main/engine/sdks/typescript",
+	"files": [
+		"dist",
+		"types",
+		"core.d.ts",
+		"serialization.d.ts"
+	],
+	"exports": {
+		".": {
+			"node": {
+				"import": "./dist/node/esm/index.js",
+				"require": "./dist/node/cjs/index.js"
+			},
+			"import": "./dist/browser/esm/index.js",
+			"require": "./dist/browser/cjs/index.js",
+			"default": "./dist/browser/cjs/index.js",
+			"types": "./types/index.d.ts"
+		},
+		"./core": {
+			"node": {
+				"import": "./dist/node/esm/core.js",
+				"require": "./dist/node/cjs/core.js"
+			},
+			"import": "./dist/browser/esm/core.js",
+			"require": "./dist/browser/cjs/core.js",
+			"default": "./dist/browser/cjs/core.js",
+			"types": "./types/core/index.d.ts"
+		},
+		"./serialization": {
+			"node": {
+				"import": "./dist/node/esm/serialization.js",
+				"require": "./dist/node/cjs/serialization.js"
+			},
+			"import": "./dist/browser/esm/serialization.js",
+			"require": "./dist/browser/cjs/serialization.js",
+			"default": "./dist/browser/cjs/serialization.js",
+			"types": "./types/serialization/index.d.ts"
+		}
+	},
+	"types": "./types/index.d.ts",
+	"scripts": {
+		"compile": "tsc",
+		"bundle": "node build.js",
+		"build": "pnpm compile && pnpm bundle",
+		"prepack": "pnpm run build"
+	},
+	"dependencies": {
+		"form-data": "^4.0.4",
+		"js-base64": "^3.7.8",
+		"node-fetch": "^2.7.0",
+		"qs": "^6.14.0",
+		"readable-stream": "^4.7.0",
+		"url-join": "^5.0.0"
+	},
+	"devDependencies": {
+		"@types/node": "17.0.33",
+		"@types/node-fetch": "2.6.11",
+		"@types/qs": "6.9.8",
+		"@types/readable-stream": "^4.0.21",
+		"@types/url-join": "4.0.1",
+		"esbuild": "^0.19.12",
+		"prettier": "2.7.1",
+		"typescript": "5.8.2"
+	}
+}

package/types/Client.d.ts

@@ -0,0 +1,281 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "./core";
+import * as Rivet from "./api/index";
+import { Datacenters } from "./api/resources/datacenters/client/Client";
+import { Envoys } from "./api/resources/envoys/client/Client";
+import { Health } from "./api/resources/health/client/Client";
+import { Metadata } from "./api/resources/metadata/client/Client";
+import { Namespaces } from "./api/resources/namespaces/client/Client";
+import { Runners } from "./api/resources/runners/client/Client";
+export declare namespace RivetClient {
+    interface Options {
+        environment: core.Supplier<string>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        token: core.Supplier<core.BearerToken>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string>;
+    }
+}
+export declare class RivetClient {
+    protected readonly _options: RivetClient.Options;
+    protected _datacenters: Datacenters | undefined;
+    protected _envoys: Envoys | undefined;
+    protected _health: Health | undefined;
+    protected _metadata: Metadata | undefined;
+    protected _namespaces: Namespaces | undefined;
+    protected _runners: Runners | undefined;
+    constructor(_options: RivetClient.Options);
+    get datacenters(): Datacenters;
+    get envoys(): Envoys;
+    get health(): Health;
+    get metadata(): Metadata;
+    get namespaces(): Namespaces;
+    get runners(): Runners;
+    /**
+     * **If key is some & `include_destroyed` is false**
+     *
+     * 2 round trips:
+     *
+     * - namespace::ops::resolve_for_name_global
+     * - GET /actors (multiple DCs based on actor IDs)
+     *
+     *   This path is optimized because we can read the actor IDs fro the key directly from Epoxy with
+     *   stale consistency to determine which datacenter the actor lives in. Under most circumstances,
+     *   this means we don't need to fan out to all datacenters (like normal list does).
+     *
+     *   The reason `include_destroyed` has to be false is Epoxy only stores currently active actors. If
+     *   `include_destroyed` is true, we show all previous iterations of actors with the same key.
+     *
+     * **Otherwise**
+     *
+     * 2 round trips:
+     *
+     * - namespace::ops::resolve_for_name_global
+     * - GET /actors (fanout)
+     *
+     * ## Optimized Alternative Routes
+     *
+     * @param {Rivet.ActorsListRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.actorsList({
+     *         namespace: "namespace"
+     *     })
+     */
+    actorsList(request: Rivet.ActorsListRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.ActorsListResponse>;
+    /**
+     * **If actor is created in the current datacenter:**
+     *
+     * 2 round trips:
+     *
+     * - namespace::ops::resolve_for_name_global
+     * - [pegboard::workflows::actor] Create actor workflow (includes Epoxy key allocation)
+     *
+     * **If actor is created in a different datacenter:**
+     *
+     * 3 round trips:
+     *
+     * - namespace::ops::resolve_for_name_global
+     * - POST /actors to remote datacenter
+     * - [pegboard::workflows::actor] Create actor workflow (includes Epoxy key allocation)
+     *
+     * actor::get will always be in the same datacenter.
+     *
+     * @param {Rivet.ActorsCreateRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.actorsCreate({
+     *         namespace: "namespace",
+     *         crashPolicy: "restart",
+     *         name: "name",
+     *         runnerNameSelector: "runner_name_selector"
+     *     })
+     */
+    actorsCreate(request: Rivet.ActorsCreateRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.ActorsCreateResponse>;
+    /**
+     * **If actor exists**
+     *
+     * 2 round trips:
+     *
+     * - namespace::ops::resolve_for_name_global
+     * - GET /actors/{}
+     *
+     * **If actor does not exist and is created in the current datacenter:**
+     *
+     * 2 round trips:
+     *
+     * - namespace::ops::resolve_for_name_global
+     * - [pegboard::workflows::actor] Create actor workflow (includes Epoxy key allocation)
+     *
+     * **If actor does not exist and is created in a different datacenter:**
+     *
+     * 3 round trips:
+     *
+     * - namespace::ops::resolve_for_name_global
+     * - POST /actors to remote datacenter
+     * - [pegboard::workflows::actor] Create actor workflow (includes Epoxy key allocation)
+     *
+     * actor::get will always be in the same datacenter.
+     *
+     * ## Optimized Alternative Routes
+     *
+     * @param {Rivet.ActorsGetOrCreateRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.actorsGetOrCreate({
+     *         namespace: "namespace",
+     *         crashPolicy: "restart",
+     *         key: "key",
+     *         name: "name",
+     *         runnerNameSelector: "runner_name_selector"
+     *     })
+     */
+    actorsGetOrCreate(request: Rivet.ActorsGetOrCreateRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.ActorsGetOrCreateResponse>;
+    /**
+     * 2 round trips:
+     *
+     * - GET /actors/names (fanout)
+     * - [api-peer] namespace::ops::resolve_for_name_global
+     *
+     * @param {Rivet.ActorsListNamesRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.actorsListNames({
+     *         namespace: "namespace"
+     *     })
+     */
+    actorsListNames(request: Rivet.ActorsListNamesRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.ActorsListNamesResponse>;
+    /**
+     * 2 round trip:
+     *
+     * - DELETE /actors/{}
+     * - [api-peer] namespace::ops::resolve_for_name_global
+     *
+     * @param {Rivet.RivetId} actorId
+     * @param {Rivet.ActorsDeleteRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.actorsDelete("actor_id", {
+     *         namespace: "namespace"
+     *     })
+     */
+    actorsDelete(actorId: Rivet.RivetId, request: Rivet.ActorsDeleteRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.ActorsDeleteResponse>;
+    /**
+     * @param {Rivet.RivetId} actorId
+     * @param {string} key
+     * @param {Rivet.ActorsKvGetRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.actorsKvGet("actor_id", "key", {
+     *         namespace: "namespace"
+     *     })
+     */
+    actorsKvGet(actorId: Rivet.RivetId, key: string, request: Rivet.ActorsKvGetRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.ActorsKvGetResponse>;
+    /**
+     * @param {Rivet.RivetId} actorId
+     * @param {Rivet.ActorsRescheduleRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.actorsReschedule("actor_id", {
+     *         namespace: "namespace",
+     *         body: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    actorsReschedule(actorId: Rivet.RivetId, request: Rivet.ActorsRescheduleRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.ActorsRescheduleResponse>;
+    /**
+     * @param {Rivet.RivetId} actorId
+     * @param {Rivet.ActorsSleepRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.actorsSleep("actor_id", {
+     *         namespace: "namespace",
+     *         body: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    actorsSleep(actorId: Rivet.RivetId, request: Rivet.ActorsSleepRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.ActorsSleepResponse>;
+    /**
+     * @param {Rivet.RunnerConfigsListRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.runnerConfigsList({
+     *         namespace: "namespace"
+     *     })
+     */
+    runnerConfigsList(request: Rivet.RunnerConfigsListRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.RunnerConfigsListResponse>;
+    /**
+     * @param {Rivet.RunnerConfigsServerlessHealthCheckRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.runnerConfigsServerlessHealthCheck({
+     *         namespace: "namespace",
+     *         url: "url"
+     *     })
+     */
+    runnerConfigsServerlessHealthCheck(request: Rivet.RunnerConfigsServerlessHealthCheckRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.RunnerConfigsServerlessHealthCheckResponse>;
+    /**
+     * @param {string} runnerName
+     * @param {Rivet.RunnerConfigsUpsertRequestBody} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.runnerConfigsUpsert("runner_name", {
+     *         namespace: "namespace",
+     *         datacenters: {
+     *             "key": {}
+     *         }
+     *     })
+     */
+    runnerConfigsUpsert(runnerName: string, request: Rivet.RunnerConfigsUpsertRequestBody, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.RunnerConfigsUpsertResponse>;
+    /**
+     * @param {string} runnerName
+     * @param {Rivet.RunnerConfigsDeleteRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.runnerConfigsDelete("runner_name", {
+     *         namespace: "namespace"
+     *     })
+     */
+    runnerConfigsDelete(runnerName: string, request: Rivet.RunnerConfigsDeleteRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.RunnerConfigsDeleteResponse>;
+    /**
+     * @param {string} runnerName
+     * @param {Rivet.RunnerConfigsRefreshMetadataRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.runnerConfigsRefreshMetadata("runner_name", {
+     *         namespace: "namespace",
+     *         body: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    runnerConfigsRefreshMetadata(runnerName: string, request: Rivet.RunnerConfigsRefreshMetadataRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.RunnerConfigsRefreshMetadataResponse>;
+    protected _getAuthorizationHeader(): Promise<string>;
+}

package/types/api/client/index.d.ts

@@ -0,0 +1 @@
+export * from "./requests";

package/types/api/client/requests/ActorsCreateRequest.d.ts

@@ -0,0 +1,23 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Rivet from "../../index";
+/**
+ * @example
+ *     {
+ *         namespace: "namespace",
+ *         crashPolicy: "restart",
+ *         name: "name",
+ *         runnerNameSelector: "runner_name_selector"
+ *     }
+ */
+export interface ActorsCreateRequest {
+    namespace: string;
+    crashPolicy: Rivet.CrashPolicy;
+    datacenter?: string;
+    /** Arbitrary base64 encoded binary data. */
+    input?: string;
+    key?: string;
+    name: string;
+    runnerNameSelector: string;
+}

package/types/api/client/requests/ActorsDeleteRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         namespace: "namespace"
+ *     }
+ */
+export interface ActorsDeleteRequest {
+    namespace: string;
+}

package/types/api/client/requests/ActorsGetOrCreateRequest.d.ts

@@ -0,0 +1,23 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Rivet from "../../index";
+/**
+ * @example
+ *     {
+ *         namespace: "namespace",
+ *         crashPolicy: "restart",
+ *         key: "key",
+ *         name: "name",
+ *         runnerNameSelector: "runner_name_selector"
+ *     }
+ */
+export interface ActorsGetOrCreateRequest {
+    namespace: string;
+    crashPolicy: Rivet.CrashPolicy;
+    datacenter?: string;
+    input?: string;
+    key: string;
+    name: string;
+    runnerNameSelector: string;
+}

package/types/api/client/requests/ActorsKvGetRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         namespace: "namespace"
+ *     }
+ */
+export interface ActorsKvGetRequest {
+    namespace: string;
+}

package/types/api/client/requests/ActorsListNamesRequest.d.ts

@@ -0,0 +1,14 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         namespace: "namespace"
+ *     }
+ */
+export interface ActorsListNamesRequest {
+    namespace: string;
+    limit?: number;
+    cursor?: string;
+}

package/types/api/client/requests/ActorsListRequest.d.ts

@@ -0,0 +1,23 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Rivet from "../../index";
+/**
+ * @example
+ *     {
+ *         namespace: "namespace"
+ *     }
+ */
+export interface ActorsListRequest {
+    namespace: string;
+    name?: string;
+    key?: string;
+    /**
+     * Deprecated.
+     */
+    actorIds?: string;
+    actorId?: Rivet.RivetId | Rivet.RivetId[];
+    includeDestroyed?: boolean;
+    limit?: number;
+    cursor?: string;
+}

package/types/api/client/requests/ActorsRescheduleRequest.d.ts

@@ -0,0 +1,17 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Rivet from "../../index";
+/**
+ * @example
+ *     {
+ *         namespace: "namespace",
+ *         body: {
+ *             "key": "value"
+ *         }
+ *     }
+ */
+export interface ActorsRescheduleRequest {
+    namespace: string;
+    body: Rivet.ActorsRescheduleRequestBody;
+}

package/types/api/client/requests/ActorsSleepRequest.d.ts

@@ -0,0 +1,17 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Rivet from "../../index";
+/**
+ * @example
+ *     {
+ *         namespace: "namespace",
+ *         body: {
+ *             "key": "value"
+ *         }
+ *     }
+ */
+export interface ActorsSleepRequest {
+    namespace: string;
+    body: Rivet.ActorsSleepRequestBody;
+}

package/types/api/client/requests/RunnerConfigsDeleteRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         namespace: "namespace"
+ *     }
+ */
+export interface RunnerConfigsDeleteRequest {
+    namespace: string;
+}

package/types/api/client/requests/RunnerConfigsListRequest.d.ts

@@ -0,0 +1,21 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Rivet from "../../index";
+/**
+ * @example
+ *     {
+ *         namespace: "namespace"
+ *     }
+ */
+export interface RunnerConfigsListRequest {
+    namespace: string;
+    limit?: number;
+    cursor?: string;
+    variant?: Rivet.RunnerConfigVariant;
+    /**
+     * Deprecated.
+     */
+    runnerNames?: string;
+    runnerName?: string | string[];
+}

package/types/api/client/requests/RunnerConfigsRefreshMetadataRequest.d.ts

@@ -0,0 +1,17 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Rivet from "../../index";
+/**
+ * @example
+ *     {
+ *         namespace: "namespace",
+ *         body: {
+ *             "key": "value"
+ *         }
+ *     }
+ */
+export interface RunnerConfigsRefreshMetadataRequest {
+    namespace: string;
+    body: Rivet.RunnerConfigsRefreshMetadataRequestBody;
+}

package/types/api/client/requests/RunnerConfigsServerlessHealthCheckRequest.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         namespace: "namespace",
+ *         url: "url"
+ *     }
+ */
+export interface RunnerConfigsServerlessHealthCheckRequest {
+    namespace: string;
+    headers?: Record<string, string>;
+    url: string;
+}

package/types/api/client/requests/RunnerConfigsUpsertRequestBody.d.ts

@@ -0,0 +1,17 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Rivet from "../../index";
+/**
+ * @example
+ *     {
+ *         namespace: "namespace",
+ *         datacenters: {
+ *             "key": {}
+ *         }
+ *     }
+ */
+export interface RunnerConfigsUpsertRequestBody {
+    namespace: string;
+    datacenters: Record<string, Rivet.RunnerConfig>;
+}

package/types/api/client/requests/index.d.ts

@@ -0,0 +1,13 @@
+export { type ActorsListRequest } from "./ActorsListRequest";
+export { type ActorsCreateRequest } from "./ActorsCreateRequest";
+export { type ActorsGetOrCreateRequest } from "./ActorsGetOrCreateRequest";
+export { type ActorsListNamesRequest } from "./ActorsListNamesRequest";
+export { type ActorsDeleteRequest } from "./ActorsDeleteRequest";
+export { type ActorsKvGetRequest } from "./ActorsKvGetRequest";
+export { type ActorsRescheduleRequest } from "./ActorsRescheduleRequest";
+export { type ActorsSleepRequest } from "./ActorsSleepRequest";
+export { type RunnerConfigsListRequest } from "./RunnerConfigsListRequest";
+export { type RunnerConfigsServerlessHealthCheckRequest } from "./RunnerConfigsServerlessHealthCheckRequest";
+export { type RunnerConfigsUpsertRequestBody } from "./RunnerConfigsUpsertRequestBody";
+export { type RunnerConfigsDeleteRequest } from "./RunnerConfigsDeleteRequest";
+export { type RunnerConfigsRefreshMetadataRequest } from "./RunnerConfigsRefreshMetadataRequest";

package/types/api/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./resources";
+export * from "./client";

package/types/api/resources/datacenters/client/Client.d.ts

@@ -0,0 +1,36 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "../../../../core";
+import * as Rivet from "../../../index";
+export declare namespace Datacenters {
+    interface Options {
+        environment: core.Supplier<string>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        token: core.Supplier<core.BearerToken>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string>;
+    }
+}
+export declare class Datacenters {
+    protected readonly _options: Datacenters.Options;
+    constructor(_options: Datacenters.Options);
+    /**
+     * @param {Datacenters.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.datacenters.list()
+     */
+    list(requestOptions?: Datacenters.RequestOptions): Promise<Rivet.DatacentersListResponse>;
+    protected _getAuthorizationHeader(): Promise<string>;
+}

package/types/api/resources/datacenters/client/index.d.ts

@@ -0,0 +1 @@
+export {};

package/types/api/resources/datacenters/index.d.ts

@@ -0,0 +1 @@
+export * from "./client";