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

package/dist/runtime/effect.d.ts

@@ -96,13 +96,21 @@ export type ResourceDefinition<Entity, Create = Entity, Update = Partial<Entity>
 	}>;
 }>;
 export type FilterValue = ResourceJsonValue | readonly ResourceJsonValue[];
+/**
+ * A filter predicate. `field` names a declared filterable field, or a path
+ * through at most three fields that hold Entity References to a field of
+ * the last target, such as `company.industry` or
+ * `contacts.company.parent.industry`. On a field that holds Entity
+ * References, `is_empty` means no reference, and `contains_any` and
+ * `contains_all` compare the ids of a field that holds many.
+ */
 export type ResourceFilter = Readonly<{
 	field: string;
-	operator: "contains" | "ends_with" | "eq" | "gt" | "gte" | "in" | "lt" | "lte" | "ne" | "not_in" | "starts_with";
+	operator: "contains" | "contains_all" | "contains_any" | "ends_with" | "eq" | "gt" | "gte" | "in" | "lt" | "lte" | "ne" | "not_in" | "starts_with";
 	value: FilterValue;
 }> | Readonly<{
 	field: string;
-	operator: "is_not_null" | "is_null";
+	operator: "is_empty" | "is_not_null" | "is_null";
 }> | Readonly<{
 	filters: readonly ResourceFilter[];
 	operator: "and" | "or";
@@ -125,6 +133,11 @@ export type ResourcePagination = Readonly<{
 }>;
 export type ResourceListQuery = Readonly<{
 	filter?: ResourceFilter;
+	/**
+	 * Include Paths, such as `["company", "contacts.company"]`: relation
+	 * fields whose records each item carries in `included`.
+	 */
+	include?: readonly string[];
 	includeDeleted?: boolean;
 	pagination: ResourcePagination;
 	sort?: readonly ResourceSort[];
@@ -133,7 +146,15 @@ export type ResourceListQuery = Readonly<{
 export type ResourceRecord<Entity> = Readonly<{
 	deletedAt?: string;
 	id: ResourceRecordId;
+	/**
+	 * The records of the read's Include Paths by relation field key: one
+	 * record, or the records of a `many` field in reference order. Untyped:
+	 * the target schemas are CI's.
+	 */
+	included?: Readonly<Record<string, ResourceJsonValue>>;
 	revision: ResourceRevision;
+	/** The keys whose included records were cut to the first 100. */
+	truncated?: readonly string[];
 	value: Entity;
 }>;
 export type ResourceListResult<Entity> = Readonly<{
@@ -261,6 +282,7 @@ export type EntityRequest<Create = unknown, Patch = unknown> = EntityRequestIden
 }> | Readonly<{
 	operation: "get";
 	id: ResourceRecordId;
+	include?: readonly string[];
 }> | (Readonly<{
 	operation: "create";
 }> & EntityCreateInput<Create>) | (Readonly<{
@@ -1013,6 +1035,63 @@ export type GatewayEffectHandler = (request: Request) => Effect.Effect<Response,
 export type ResourceEffectHandlerOptions<E = never, R = never, Value = unknown, Create = Value, Patch = Partial<Value>> = Omit<ResourceHttpHandlerOptions<Value, Create, Patch>, "authorize"> & Readonly<{
 	authorize: (request: Request, operation: Parameters<ResourceHttpHandlerOptions["authorize"]>[1]) => Effect.Effect<EntityInvocationContext | Response, E, R>;
 }>;
+/** One file of a File field, as every CI read surface returns it. */
+export declare const EntityFileValue: Schema.Struct<{
+	readonly filename: Schema.String;
+	readonly id: Schema.String;
+	readonly mimeType: Schema.NullOr<Schema.String>;
+	readonly size: Schema.NullOr<Schema.Int>;
+	readonly source: Schema.Literals<readonly [
+		"managed",
+		"external_url"
+	]>;
+	readonly url: Schema.String;
+}>;
+export type EntityFileValue = typeof EntityFileValue.Type;
+/**
+ * One file of a File field write: `{ upload }` adds the File upload of an
+ * upload slot's `uploadId`; `{ id }` keeps a file, so a File value read before
+ * decodes as the file it names.
+ */
+export declare const EntityFileWrite: Schema.Union<readonly [
+	Schema.Struct<{
+		readonly id: Schema.optionalKey<Schema.Never>;
+		readonly upload: Schema.String;
+	}>,
+	Schema.Struct<{
+		readonly id: Schema.String;
+		readonly upload: Schema.optionalKey<Schema.Never>;
+	}>
+]>;
+export type EntityFileWrite = typeof EntityFileWrite.Type;
+/**
+ * The write form of a File field key: one file or `null` for a single field,
+ * an ordered array for a multiple field; `null` removes every file. Omit the
+ * key to keep its files unchanged.
+ */
+export declare const EntityFileFieldWrite: Schema.NullOr<Schema.Union<readonly [
+	Schema.Union<readonly [
+		Schema.Struct<{
+			readonly id: Schema.optionalKey<Schema.Never>;
+			readonly upload: Schema.String;
+		}>,
+		Schema.Struct<{
+			readonly id: Schema.String;
+			readonly upload: Schema.optionalKey<Schema.Never>;
+		}>
+	]>,
+	Schema.$Array<Schema.Union<readonly [
+		Schema.Struct<{
+			readonly id: Schema.optionalKey<Schema.Never>;
+			readonly upload: Schema.String;
+		}>,
+		Schema.Struct<{
+			readonly id: Schema.String;
+			readonly upload: Schema.optionalKey<Schema.Never>;
+		}>
+	]>>
+]>>;
+export type EntityFileFieldWrite = typeof EntityFileFieldWrite.Type;
 export declare const createGatewayEffectHandler: (kernel: GatewayRuntimeKernel) => GatewayEffectHandler;
 export declare const createResourceEffectHandler: <E, R, Value = unknown, Create = Value, Patch = Partial<Value>>(options: ResourceEffectHandlerOptions<E, R, Value, Create, Patch>) => (request: Request) => import("effect/Effect").Effect<Response, E | GatewayEffectRuntimeError, R>;
 export declare const DateTimeString: import("effect/Schema").String;