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

package/dist/knowledge-sources/payload.d.ts

@@ -65,13 +65,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";
@@ -94,6 +102,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[];
@@ -102,7 +115,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 ResourceErrorCode = "capability_not_supported" | "conflict" | "forbidden" | "internal" | "invalid_request" | "not_found" | "rate_limited" | "transport_error" | "unauthenticated" | "unavailable" | 

package/dist/knowledge-sources/strapi.d.ts

@@ -65,13 +65,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";
@@ -94,6 +102,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[];
@@ -102,7 +115,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 ResourceErrorCode = "capability_not_supported" | "conflict" | "forbidden" | "internal" | "invalid_request" | "not_found" | "rate_limited" | "transport_error" | "unauthenticated" | "unavailable" | 

package/dist/persistence/drizzle.d.ts

@@ -102,13 +102,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";
@@ -131,6 +139,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[];
@@ -139,7 +152,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<{
@@ -170,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" | "upload";
+export type EntityOperation = "list_members" | "list" | "get" | "create" | "update" | "delete" | "upload";
 export type EntityListQuery = Omit<ResourceListQuery, "pagination" | "includeDeleted"> & Readonly<{
 	pagination: Extract<ResourcePagination, {
 		mode: "page";
@@ -205,13 +226,15 @@ export type ApplicationUserIdentity = Readonly<{
  * and request/correlation IDs are deliberately not part of that logical identity.
  */
 export type EntityInvocationContext = Readonly<{
+	/** The App Permissions of the user's effective roles on the app. */
+	appPermissions: readonly string[];
 	applicationId: string;
 	issuer: string;
 	organizationId: string;
 	resourceId: string;
+	/** The user's effective roles on the app, read from CI at this lookup. */
 	roles: readonly string[];
 	scopes: readonly string[];
-	groupIds: readonly string[];
 	user: ApplicationUserIdentity;
 }>;
 /** Common CRUD port. Implementations own atomic revisions, receipts and soft deletion. */
@@ -653,7 +676,9 @@ declare const definePlatformTables: (options?: PlatformTablesOptions) => {
 				result: import("drizzle-orm/pg-core").PgBuildColumn<"resource_idempotency", import("drizzle-orm/pg-core").SetNotNull<import("drizzle-orm/pg-core").Set$Type<import("drizzle-orm/pg-core").PgJsonbBuilder, Readonly<{
 					deletedAt?: string;
 					id: ResourceRecordId;
+					included?: Readonly<Record<string, ResourceJsonValue>>;
 					revision: ResourceRevision;
+					truncated?: readonly string[];
 					value: unknown;
 				}>>>, {
 					name: string;
@@ -662,7 +687,9 @@ declare const definePlatformTables: (options?: PlatformTablesOptions) => {
 					data: Readonly<{
 						deletedAt?: string;
 						id: ResourceRecordId;
+						included?: Readonly<Record<string, ResourceJsonValue>>;
 						revision: ResourceRevision;
+						truncated?: readonly string[];
 						value: unknown;
 					}>;
 					driverParam: unknown;
@@ -893,7 +920,9 @@ declare const makePlatformPersistence: (options: PlatformPersistenceOptions) =>
 				result: import("drizzle-orm/pg-core").PgBuildColumn<"resource_idempotency", import("drizzle-orm/pg-core").SetNotNull<import("drizzle-orm/pg-core").Set$Type<import("drizzle-orm/pg-core").PgJsonbBuilder, Readonly<{
 					deletedAt?: string;
 					id: ResourceRecordId;
+					included?: Readonly<Record<string, ResourceJsonValue>>;
 					revision: ResourceRevision;
+					truncated?: readonly string[];
 					value: unknown;
 				}>>>, {
 					name: string;
@@ -902,7 +931,9 @@ declare const makePlatformPersistence: (options: PlatformPersistenceOptions) =>
 					data: Readonly<{
 						deletedAt?: string;
 						id: ResourceRecordId;
+						included?: Readonly<Record<string, ResourceJsonValue>>;
 						revision: ResourceRevision;
+						truncated?: readonly string[];
 						value: unknown;
 					}>;
 					driverParam: unknown;
@@ -1320,7 +1351,9 @@ declare const definePlatformTables$1: (options?: PlatformTablesOptions) => {
 				result: import("drizzle-orm/pg-core").PgBuildColumn<"resource_idempotency", import("drizzle-orm/pg-core").SetNotNull<import("drizzle-orm/pg-core").Set$Type<import("drizzle-orm/pg-core").PgJsonbBuilder, Readonly<{
 					deletedAt?: string;
 					id: ResourceRecordId;
+					included?: Readonly<Record<string, ResourceJsonValue>>;
 					revision: ResourceRevision;
+					truncated?: readonly string[];
 					value: unknown;
 				}>>>, {
 					name: string;
@@ -1329,7 +1362,9 @@ declare const definePlatformTables$1: (options?: PlatformTablesOptions) => {
 					data: Readonly<{
 						deletedAt?: string;
 						id: ResourceRecordId;
+						included?: Readonly<Record<string, ResourceJsonValue>>;
 						revision: ResourceRevision;
+						truncated?: readonly string[];
 						value: unknown;
 					}>;
 					driverParam: unknown;
@@ -1482,7 +1517,9 @@ declare const makePlatformPersistence$1: (options: PlatformPersistenceOptions) =
 				result: import("drizzle-orm/pg-core").PgBuildColumn<"resource_idempotency", import("drizzle-orm/pg-core").SetNotNull<import("drizzle-orm/pg-core").Set$Type<import("drizzle-orm/pg-core").PgJsonbBuilder, Readonly<{
 					deletedAt?: string;
 					id: ResourceRecordId;
+					included?: Readonly<Record<string, ResourceJsonValue>>;
 					revision: ResourceRevision;
+					truncated?: readonly string[];
 					value: unknown;
 				}>>>, {
 					name: string;
@@ -1491,7 +1528,9 @@ declare const makePlatformPersistence$1: (options: PlatformPersistenceOptions) =
 					data: Readonly<{
 						deletedAt?: string;
 						id: ResourceRecordId;
+						included?: Readonly<Record<string, ResourceJsonValue>>;
 						revision: ResourceRevision;
+						truncated?: readonly string[];
 						value: unknown;
 					}>;
 					driverParam: unknown;