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

package/dist/resources.d.ts

@@ -26,6 +26,8 @@ export type ResourceCapabilities = Readonly<{
 	search: true;
 	softDelete?: boolean;
 	update?: boolean;
+	/** File uploads for the File fields of a common entity resource. */
+	upload?: boolean;
 }>;
 export type ResourcePaginationMode = "cursor" | "page";
 export type PortableResourceSchema = Readonly<Record<string, ResourceJsonValue>>;
@@ -115,7 +117,9 @@ export type ResourceListResult<Entity> = Readonly<{
 	totalItems: number;
 	totalPages: number;
 }>;
-export type ResourceErrorCode = "capability_not_supported" | "conflict" | "forbidden" | "internal" | "invalid_request" | "not_found" | "rate_limited" | "transport_error" | "unauthenticated" | "unavailable";
+export type ResourceErrorCode = "capability_not_supported" | "conflict" | "forbidden" | "internal" | "invalid_request" | "not_found" | "rate_limited" | "transport_error" | "unauthenticated" | "unavailable" | 
+/** The CI Organization storage can not take a presigned File upload. */
+"upload_not_supported";
 export type ResourceError = Readonly<{
 	code: ResourceErrorCode;
 	/** Client-observed dispatch outcome; uncertainty never proves rollback. */
@@ -187,7 +191,7 @@ export type ResourceCreateInput<Value> = Readonly<{
 	value: Value;
 }>;
 /** Common entity operations. Generic resource lifecycle/cursor APIs remain separate. */
-export type EntityOperation = "list" | "get" | "create" | "update" | "delete";
+export type EntityOperation = "list" | "get" | "create" | "update" | "delete" | "upload";
 export type EntityListQuery = Omit<ResourceListQuery, "pagination" | "includeDeleted"> & Readonly<{
 	pagination: Extract<ResourcePagination, {
 		mode: "page";
@@ -203,6 +207,19 @@ export type EntityUpdateInput<Patch> = ResourceMutationInput<Patch> & Readonly<{
 export type EntityDeleteInput = ResourceLifecycleInput & Readonly<{
 	idempotencyKey: IdempotencyKey;
 }>;
+/** 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 EntityRequestIdentity = Readonly<{
 	requestId: string;
 	resourceId: string;
@@ -219,7 +236,10 @@ export type EntityRequest<Create = unknown, Patch = unknown> = EntityRequestIden
 	operation: "update";
 }> & EntityUpdateInput<Patch>) | (Readonly<{
 	operation: "delete";
-}> & EntityDeleteInput));
+}> & EntityDeleteInput) | (Readonly<{
+	operation: "upload";
+}> & EntityUploadInput));
+export type EntityOperationResult<Value, Operation extends EntityOperation> = Operation extends "list" ? EntityPage<Value> : Operation extends "upload" ? EntityUploadSlot : ResourceRecord<Value>;
 /** Application login identities are separate from gateway machine callers. */
 export type ApplicationUserIdentity = Readonly<{
 	kind: "local_user";
@@ -347,7 +367,7 @@ export type EntityResourceDefinition<Value = unknown, Create = Value, Patch = Pa
 	definition: ResourceDefinition<Value, Create, Patch>;
 	execute: (request: EntityRequest<Create, Patch>, context: EntityInvocationContext, options?: Readonly<{
 		signal?: AbortSignal;
-	}>) => Promise<ResourceResult<EntityPage<Value> | ResourceRecord<Value>>>;
+	}>) => Promise<ResourceResult<EntityOperationResult<Value, EntityOperation>>>;
 }>;
 export type GatewayResourceOperation = ResourceTransportRequest["operation"];
 export type GatewayResourceAuthorization = Readonly<Partial<Record<GatewayResourceOperation, AuthorizationRequirement>>>;
@@ -393,6 +413,8 @@ export type EntityHttpRoute = {
 } | {
 	readonly kind: "soft_delete";
 	readonly id: string;
+} | {
+	readonly kind: "uploads";
 };
 export declare const createResourceHttpHandler: <Value, Create = Value, Patch = Partial<Value>>(options: ResourceHttpHandlerOptions<Value, Create, Patch>) => (request: Request) => Promise<Response>;
 export declare const matchEntityHttpRoute: (pathname: string, basePath: string) => EntityHttpRoute | null;