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

package/dist/runtime/web.d.ts

@@ -424,13 +424,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";
@@ -453,6 +461,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[];
@@ -539,13 +552,15 @@ export type ApplicationUserSession = 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;
 }>;
 export type ApplicationUserAuth = Readonly<{
@@ -554,7 +569,7 @@ export type ApplicationUserAuth = Readonly<{
 	/** Returns null only when the request has no valid application session. */
 	getSession: (request: Request) => Promise<ApplicationUserSession | null>;
 	/** Server-only current CI authority. The host still owns resource/operation policy.
-	 * Null means no valid CI session or no current role/group policy supplied by CI.
+	 * Null means no valid CI session, including a user without a role on the app.
 	 */
 	getEntityContext: (request: Request, resourceId: string) => Promise<EntityInvocationContext | null>;
 	/** Server-only Delegated access token. Absent for local application login. */