@collective-intelligence/external-apps-server-sdk 0.1.9 → 0.1.10

package/dist/index.d.ts

@@ -3,6 +3,19 @@
 export type ResourceJsonValue = null | boolean | number | string | readonly ResourceJsonValue[] | Readonly<{
 	[key: string]: ResourceJsonValue;
 }>;
+/** A File upload request for one File field of the entity schema. */
+export type EntityUploadInput = Readonly<{
+	field: string;
+	filename: string;
+	mimeType: string;
+}>;
+/** PUT the file bytes to `url` with `headers`; then write `{ upload: uploadId }`. */
+export type EntityUploadSlot = Readonly<{
+	headers: Readonly<Record<string, string>>;
+	method: "PUT";
+	uploadId: string;
+	url: string;
+}>;
 export type ExternalApplicationsGetContextErrors = {
 	/**
 	 * Error
@@ -461,6 +474,11 @@ export type ExternalApplicationServiceOperationRequest = {
 		userId: string;
 	};
 	operationId: "members_remove";
+} | {
+	input: {
+		origin: string;
+	};
+	operationId: "origins_set_runtime";
 } | {
 	input: {
 		userId: string;
@@ -483,6 +501,8 @@ export type ExternalApplicationServiceOperationSuccess = EnvelopeSuccess<"files_
 	outcome: MemberUserResolution;
 }> | EnvelopeSuccess<"members_get", MemberUser> | EnvelopeSuccess<"members_list", MemberUserPage> | EnvelopeSuccess<"members_update", MemberUser> | EnvelopeSuccess<"members_remove", {
 	userId: string;
+}> | EnvelopeSuccess<"origins_set_runtime", {
+	origin: string;
 }> | EnvelopeSuccess<"users_list_company_links", UserCompanyLinks> | EnvelopeSuccess<"users_link_companies", UserCompanyLinks>;
 /** Every operation a confidential server client may invoke. */
 export type ExternalApplicationServerOperationRequest = ExternalApplicationOperationRequest | ExternalApplicationServiceOperationRequest;
@@ -669,6 +689,45 @@ export type ServerMessageSendRequest = Omit<MessageSendInput, "idempotencyKey">
 	idempotencyKey?: string;
 }> & ServerInvocationContext;
 export type ServerMessageSendMethod = (request: ServerMessageSendRequest) => Promise<MessageSendResult>;
+/** A File upload slot for one File field of an entity schema, named by id or FQN. */
+export type ServerResourceUploadRequest = EntityUploadInput & Readonly<{
+	schemaId: string;
+	/** Bound on each attempt's request and response body. Defaults to 10 seconds. */
+	timeoutMs?: number;
+}> & ServerInvocationContext;
+declare const resourceFailureCodes: readonly [
+	"conflict",
+	"forbidden",
+	"internal",
+	"invalid_request",
+	"not_found",
+	"unauthenticated",
+	"unavailable",
+	"upload_not_supported"
+];
+/** Why CI's resources API refused the request. */
+export type ServerResourceFailure = Readonly<{
+	correlationId: string;
+	error: Readonly<{
+		code: (typeof resourceFailureCodes)[number];
+		details?: Readonly<Record<string, ResourceJsonValue>>;
+		message: string;
+		retryable: boolean;
+	}>;
+}>;
+/** PUT the bytes to `result.url` with `result.headers`, then write `{ upload: uploadId }`. */
+export type ServerResourceUploadResult = Readonly<{
+	error: ServerResourceFailure;
+	ok: false;
+}> | Readonly<{
+	ok: true;
+	value: Readonly<{
+		correlationId: string;
+		operationId: "resources_create_upload";
+		result: EntityUploadSlot;
+	}>;
+}>;
+export type ServerResourceUploadMethod = (request: ServerResourceUploadRequest) => Promise<ServerResourceUploadResult>;
 export type RunOperationId = "runs_cancel" | "runs_get" | "runs_stream";
 export type ServerRunStatus = "accepted" | "cancelled" | "failed" | "running" | "succeeded";
 /**
@@ -803,6 +862,26 @@ export interface ServerClient {
 	readonly messages: Readonly<{
 		send: ServerMessageSendMethod;
 	}>;
+	/**
+	 * The application's browser origins in its Organization. `setRuntime({ origin })`
+	 * replaces the application's one runtime origin, such as the URL of the
+	 * current deployment, beside the `allowedOrigins` its package declares.
+	 * Needs the `origins:write` scope and confidential credentials.
+	 */
+	readonly origins: Readonly<{
+		setRuntime: ServerOperationMethod<"origins_set_runtime">;
+	}>;
+	/**
+	 * CI's resources API. `createUpload` asks a single-use File upload slot for
+	 * one File field of an entity schema; the entity write then names its
+	 * `uploadId` as `{ upload }`. Slots follow entity writes: the member's
+	 * delegated token writes as that member; the service credential writes as
+	 * the Organization default service principal, only on schemas its own
+	 * package declares.
+	 */
+	readonly resources: Readonly<{
+		createUpload: ServerResourceUploadMethod;
+	}>;
 	readonly runs: Readonly<{
 		cancel: ServerRunOperationMethod<"runs_cancel", ServerRun>;
 		get: ServerRunOperationMethod<"runs_get", ServerRun>;