@esri/hub-common 14.74.1 → 14.75.0

package/dist/esm/associations/addAssociation.js

@@ -1,4 +1,7 @@
 /**
+ * ** DEPRECATED: please use requestAssociation instead.
+ * This will be removed in the next breaking version **
+ *
  * Add an association to an entity
  * Persisted into the entity's `.typeKeywords` array
  * @param info

package/dist/esm/associations/addAssociation.js.map

@@ -1 +1 @@
-{"version":3,"file":"addAssociation.js","sourceRoot":"","sources":["../../../src/associations/addAssociation.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAyB,EACzB,IAAsB;IAEtB,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE;QACxB,MAAM,CAAC,YAAY,GAAG,EAAE,CAAC;KAC1B;IACD,MAAM,WAAW,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;QAC9C,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;KACvC;AACH,CAAC"}
+{"version":3,"file":"addAssociation.js","sourceRoot":"","sources":["../../../src/associations/addAssociation.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAyB,EACzB,IAAsB;IAEtB,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE;QACxB,MAAM,CAAC,YAAY,GAAG,EAAE,CAAC;KAC1B;IACD,MAAM,WAAW,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;QAC9C,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;KACvC;AACH,CAAC"}

package/dist/esm/associations/breakAssociation.js

@@ -0,0 +1,54 @@
+import { unshareItemWithGroup } from "@esri/arcgis-rest-portal";
+import { getProp } from "../objects";
+import { fetchHubEntity } from "../core";
+import { getTypeFromEntity } from "../core/getTypeFromEntity";
+import { updateHubEntity } from "../core/updateHubEntity";
+import { getAssociationHierarchy } from "./internal/getAssociationHierarchy";
+import { isAssociationSupported } from "./internal/isAssociationSupported";
+import { removeAssociationKeyword } from "./internal/removeAssociationKeyword";
+/**
+ * When an entity decides it wants to "disconnect" itself
+ * from an existing association, half of the association
+ * "connection" is broken.
+ *
+ * from the parent's perspective: the parent removes
+ * the child from its association group
+ *
+ * From the child's perspective: the child removes
+ * the parent reference (ref|<parentType>|<parentID>)
+ * from its typeKeywords
+ *
+ * @param entity - entity initiating the disconnection
+ * @param type - type of the entity the initiating entity wants to disconnect from
+ * @param id - id of the entity the initiating entity wants to disconnect from
+ * @param context - contextual portal and auth information
+ */
+export const breakAssociation = async (entity, associationType, id, context) => {
+    const entityType = getTypeFromEntity(entity);
+    const isSupported = isAssociationSupported(entityType, associationType);
+    if (!isSupported) {
+        throw new Error(`breakAssociation: Association between ${entityType} and ${associationType} is not supported.`);
+    }
+    const associationHierarchy = getAssociationHierarchy(entityType);
+    const isParent = associationHierarchy.children.includes(associationType);
+    if (isParent) {
+        const associationGroupId = getProp(entity, "associations.groupId");
+        const { owner } = await fetchHubEntity(associationType, id, context);
+        try {
+            await unshareItemWithGroup({
+                id,
+                groupId: associationGroupId,
+                authentication: context.session,
+                owner,
+            });
+        }
+        catch (error) {
+            throw new Error(`breakAssociation: there was an error unsharing ${id} from ${associationGroupId}: ${error}`);
+        }
+    }
+    else {
+        entity.typeKeywords = removeAssociationKeyword(entity.typeKeywords, associationType, id);
+        await updateHubEntity(entityType, entity, context);
+    }
+};
+//# sourceMappingURL=breakAssociation.js.map

package/dist/esm/associations/breakAssociation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakAssociation.js","sourceRoot":"","sources":["../../../src/associations/breakAssociation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACnC,MAAiB,EACjB,eAA8B,EAC9B,EAAU,EACV,OAAuB,EACR,EAAE;IACjB,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,sBAAsB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAExE,IAAI,CAAC,WAAW,EAAE;QAChB,MAAM,IAAI,KAAK,CACb,yCAAyC,UAAU,QAAQ,eAAe,oBAAoB,CAC/F,CAAC;KACH;IAED,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEzE,IAAI,QAAQ,EAAE;QACZ,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;QACnE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,cAAc,CAAC,eAAe,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QACrE,IAAI;YACF,MAAM,oBAAoB,CAAC;gBACzB,EAAE;gBACF,OAAO,EAAE,kBAAkB;gBAC3B,cAAc,EAAE,OAAO,CAAC,OAAO;gBAC/B,KAAK;aACN,CAAC,CAAC;SACJ;QAAC,OAAO,KAAK,EAAE;YACd,MAAM,IAAI,KAAK,CACb,kDAAkD,EAAE,SAAS,kBAAkB,KAAK,KAAK,EAAE,CAC5F,CAAC;SACH;KACF;SAAM;QACL,MAAM,CAAC,YAAY,GAAG,wBAAwB,CAC5C,MAAM,CAAC,YAAY,EACnB,eAAe,EACf,EAAE,CACH,CAAC;QACF,MAAM,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;KACpD;AACH,CAAC,CAAC"}

package/dist/esm/associations/getAssociatedEntitiesQuery.js

@@ -0,0 +1,33 @@
+import { getTypeFromEntity } from "../core/getTypeFromEntity";
+import { getAssociationHierarchy } from "./internal/getAssociationHierarchy";
+import { isAssociationSupported } from "./internal/isAssociationSupported";
+import { getIncludesAndReferencesQuery } from "./internal/getIncludesAndReferencesQuery";
+/**
+ * Associated entities are those which have mutually
+ * "agreed" to be connected with one another. They
+ * require a two-way "connection" between parent/child:
+ *
+ * parent: "includes" the child in its association query
+ * child: "references" the parent via a typeKeyword of
+ * the form ref|<parentType>|<parentID>
+ *
+ * The following returns a query to view an entity's
+ * associations with another entity type
+ *
+ * @param entity - Hub entity
+ * @param associationType - entity type to query for
+ * @param context - contextual auth and portal information
+ * @returns {IQuery}
+ */
+export const getAssociatedEntitiesQuery = async (entity, associationType, context) => {
+    const entityType = getTypeFromEntity(entity);
+    const isSupported = isAssociationSupported(entityType, associationType);
+    if (!isSupported) {
+        throw new Error(`getAssociatedEntitiesQuery: Association between ${entityType} and ${associationType} is not supported.`);
+    }
+    const associationHierarchy = getAssociationHierarchy(entityType);
+    const isParent = associationHierarchy.children.includes(associationType);
+    const query = await getIncludesAndReferencesQuery(entity, associationType, isParent, context);
+    return query;
+};
+//# sourceMappingURL=getAssociatedEntitiesQuery.js.map

package/dist/esm/associations/getAssociatedEntitiesQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAssociatedEntitiesQuery.js","sourceRoot":"","sources":["../../../src/associations/getAssociatedEntitiesQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,MAAM,0CAA0C,CAAC;AAGzF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,EAC7C,MAAiB,EACjB,eAA8B,EAC9B,OAAuB,EACN,EAAE;IACnB,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,sBAAsB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAExE,IAAI,CAAC,WAAW,EAAE;QAChB,MAAM,IAAI,KAAK,CACb,mDAAmD,UAAU,QAAQ,eAAe,oBAAoB,CACzG,CAAC;KACH;IAED,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEzE,MAAM,KAAK,GAAG,MAAM,6BAA6B,CAC/C,MAAM,EACN,eAAe,EACf,QAAQ,EACR,OAAO,CACR,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/esm/associations/getAssociationStats.js

@@ -0,0 +1,49 @@
+import { getTypeFromEntity } from "../core/getTypeFromEntity";
+import { hubSearch } from "../search/hubSearch";
+import { getAssociatedEntitiesQuery } from "./getAssociatedEntitiesQuery";
+import { getPendingEntitiesQuery } from "./getPendingEntitiesQuery";
+import { getRequestingEntitiesQuery } from "./getRequestingEntitiesQuery";
+import { getAssociationHierarchy } from "./internal/getAssociationHierarchy";
+import { isAssociationSupported } from "./internal/isAssociationSupported";
+/**
+ * get an entity's association stats - # of associated, pending,
+ * requesting, included/referenced entities
+ *
+ * @param entity - Hub entity
+ * @param associationType - entity type to query for
+ * @param context - contextual auth and portal information
+ * @returns
+ */
+export const getAssociationStats = async (entity, associationType, context) => {
+    let stats;
+    const entityType = getTypeFromEntity(entity);
+    const isSupported = isAssociationSupported(entityType, associationType);
+    if (!isSupported) {
+        throw new Error(`getAssociationStats: Association between ${entityType} and ${associationType} is not supported.`);
+    }
+    const associationHierarchy = getAssociationHierarchy(entityType);
+    const isParent = associationHierarchy.children.includes(associationType);
+    stats = Object.assign({ associated: 0, pending: 0, requesting: 0 }, (isParent ? { included: 0 } : { referenced: 0 }));
+    try {
+        const queries = await Promise.all([
+            getAssociatedEntitiesQuery(entity, associationType, context),
+            getPendingEntitiesQuery(entity, associationType, context),
+            getRequestingEntitiesQuery(entity, associationType, context),
+        ]);
+        const [{ total: associated }, { total: pending }, { total: requesting }] = await Promise.all(queries.map((query) => {
+            return hubSearch(query, {
+                requestOptions: context.hubRequestOptions,
+            });
+        }));
+        stats = Object.assign({ associated,
+            pending,
+            requesting }, (isParent
+            ? { included: associated + pending }
+            : { referenced: associated + pending }));
+    }
+    catch (error) {
+        return stats;
+    }
+    return stats;
+};
+//# sourceMappingURL=getAssociationStats.js.map

package/dist/esm/associations/getAssociationStats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAssociationStats.js","sourceRoot":"","sources":["../../../src/associations/getAssociationStats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAG3E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,MAAiB,EACjB,eAA8B,EAC9B,OAAuB,EACK,EAAE;IAC9B,IAAI,KAAwB,CAAC;IAC7B,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,sBAAsB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAExE,IAAI,CAAC,WAAW,EAAE;QAChB,MAAM,IAAI,KAAK,CACb,4CAA4C,UAAU,QAAQ,eAAe,oBAAoB,CAClG,CAAC;KACH;IAED,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEzE,KAAK,mBACH,UAAU,EAAE,CAAC,EACb,OAAO,EAAE,CAAC,EACV,UAAU,EAAE,CAAC,IACV,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CACpD,CAAC;IAEF,IAAI;QACF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAChC,0BAA0B,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC;YAC5D,uBAAuB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC;YACzD,0BAA0B,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC;SAC7D,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,GACtE,MAAM,OAAO,CAAC,GAAG,CACf,OAAO,CAAC,GAAG,CAAC,CAAC,KAAa,EAAE,EAAE;YAC5B,OAAO,SAAS,CAAC,KAAK,EAAE;gBACtB,cAAc,EAAE,OAAO,CAAC,iBAAiB;aAC1C,CAAC,CAAC;QACL,CAAC,CAAC,CACH,CAAC;QAEJ,KAAK,mBACH,UAAU;YACV,OAAO;YACP,UAAU,IACP,CAAC,QAAQ;YACV,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,EAAE;YACpC,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,EAAE,CAAC,CAC1C,CAAC;KACH;IAAC,OAAO,KAAK,EAAE;QACd,OAAO,KAAK,CAAC;KACd;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/esm/associations/getAvailableToRequestEntitiesQuery.js

@@ -0,0 +1,65 @@
+import { getTypeFromEntity } from "../core/getTypeFromEntity";
+import { getAssociationHierarchy } from "./internal/getAssociationHierarchy";
+import { isAssociationSupported } from "./internal/isAssociationSupported";
+import { getProp } from "../objects/get-prop";
+import { getTypesFromEntityType } from "../core/getTypesFromEntityType";
+import { getIdsFromKeywords } from "./internal/getIdsFromKeywords";
+import { getTypeByNotIdsQuery } from "./internal/getTypeByNotIdsQuery";
+import { negateGroupPredicates } from "../search/_internal/negateGroupPredicates";
+import { getTypeByIdsQuery } from "./internal/getTypeByIdsQuery";
+import { combineQueries } from "../search/_internal/combineQueries";
+/**
+ * An entity can send an "outgoing" request to associate
+ * itself with another entity. The following query returns
+ * a set of entities that the requesting entity can still
+ * request:
+ *
+ * from a parent perspective: returns a set of children
+ * that are NOT "included" in the parent's association group
+ *
+ * from a child perspective: returns a set of parents that
+ * the child does not "reference" with via a typeKeyword of
+ * the form ref|<parentType>|<parentID>
+ *
+ * @param entity - entity requesting association
+ * @param associationType - type of entity the requesting entity wants to associate with
+ * @param context - contextual auth and portal information
+ * @returns {IQuery}
+ */
+export const getAvailableToRequestEntitiesQuery = (entity, associationType) => {
+    let query;
+    const entityType = getTypeFromEntity(entity);
+    const isSupported = isAssociationSupported(entityType, associationType);
+    if (!isSupported) {
+        throw new Error(`getAvailableToRequestEntitiesQuery: Association between ${entityType} and ${associationType} is not supported.`);
+    }
+    const associationHierarchy = getAssociationHierarchy(entityType);
+    const isParent = associationHierarchy.children.includes(associationType);
+    if (isParent) {
+        /** 1. build query that returns child entities */
+        const childType = getTypesFromEntityType(associationType);
+        const childTypeQuery = getTypeByIdsQuery(childType, []);
+        /**
+         * 2. grab the parent's association query and negate
+         * the group predicate
+         */
+        const notIncludedQuery = negateGroupPredicates(getProp(entity, "associations.rules.query"));
+        /** 3. combine queries - will remove null/undefined entries */
+        query = combineQueries([notIncludedQuery, childTypeQuery]);
+    }
+    else {
+        /**
+         * 1. iterate over the child's typeKeywords and grab the parent
+         * ids it references (typeKeyword = <associationType>|<id>)
+         */
+        const ids = getIdsFromKeywords(entity, associationType);
+        /**
+         * 2. build query that returns parent entities NOT
+         * "referenced" by the child
+         */
+        const type = getTypesFromEntityType(associationType);
+        query = getTypeByNotIdsQuery(type, ids);
+    }
+    return query;
+};
+//# sourceMappingURL=getAvailableToRequestEntitiesQuery.js.map

package/dist/esm/associations/getAvailableToRequestEntitiesQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAvailableToRequestEntitiesQuery.js","sourceRoot":"","sources":["../../../src/associations/getAvailableToRequestEntitiesQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAChD,MAAiB,EACjB,eAA8B,EACtB,EAAE;IACV,IAAI,KAAa,CAAC;IAClB,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,sBAAsB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAExE,IAAI,CAAC,WAAW,EAAE;QAChB,MAAM,IAAI,KAAK,CACb,2DAA2D,UAAU,QAAQ,eAAe,oBAAoB,CACjH,CAAC;KACH;IAED,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEzE,IAAI,QAAQ,EAAE;QACZ,iDAAiD;QACjD,MAAM,SAAS,GAAG,sBAAsB,CAAC,eAAe,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,iBAAiB,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAExD;;;WAGG;QACH,MAAM,gBAAgB,GAAG,qBAAqB,CAC5C,OAAO,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAC5C,CAAC;QAEF,8DAA8D;QAC9D,KAAK,GAAG,cAAc,CAAC,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC;KAC5D;SAAM;QACL;;;WAGG;QACH,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QAExD;;;WAGG;QACH,MAAM,IAAI,GAAG,sBAAsB,CAAC,eAAe,CAAC,CAAC;QACrD,KAAK,GAAG,oBAAoB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;KACzC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/esm/associations/getPendingEntitiesQuery.js

@@ -0,0 +1,41 @@
+import { getTypeFromEntity } from "../core/getTypeFromEntity";
+import { getAssociationHierarchy } from "./internal/getAssociationHierarchy";
+import { getReferencesDoesNotIncludeQuery } from "./internal/getReferencesDoesNotIncludeQuery";
+import { getIncludesDoesNotReferenceQuery } from "./internal/getIncludesDoesNotReferenceQuery";
+import { isAssociationSupported } from "./internal/isAssociationSupported";
+/**
+ * Pending entities represent "outgoing" requests that are
+ * awaiting "approval". They imply a one-way "connection"
+ * between parent/child.
+ *
+ * From the parent's perspective:
+ * parent: "includes" the child in its association query
+ * child: does NOT "reference" the parent via a typeKeyword
+ *
+ * From the child's perspective:
+ * parent: does NOT "include" the child in its association query
+ * child: "references" the parent via a typeKeyword of the
+ * form ref|<parentType>|<parentID>
+ *
+ * The following returns a query to view an entity's outgoing
+ * requests for association with another entity type
+ *
+ * @param entity - Hub entity
+ * @param associationType - entity type to query for
+ * @param context - contextual auth and portal information
+ * @returns {IQuery}
+ */
+export const getPendingEntitiesQuery = async (entity, associationType, context) => {
+    const entityType = getTypeFromEntity(entity);
+    const isSupported = isAssociationSupported(entityType, associationType);
+    if (!isSupported) {
+        throw new Error(`getPendingEntitiesQuery: Association between ${entityType} and ${associationType} is not supported.`);
+    }
+    const associationHierarchy = getAssociationHierarchy(entityType);
+    const isParent = associationHierarchy.children.includes(associationType);
+    const query = isParent
+        ? await getIncludesDoesNotReferenceQuery(entity, associationType, isParent, context)
+        : await getReferencesDoesNotIncludeQuery(entity, associationType, isParent, context);
+    return query;
+};
+//# sourceMappingURL=getPendingEntitiesQuery.js.map

package/dist/esm/associations/getPendingEntitiesQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPendingEntitiesQuery.js","sourceRoot":"","sources":["../../../src/associations/getPendingEntitiesQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAC;AAC/F,OAAO,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAG3E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAC1C,MAAiB,EACjB,eAA8B,EAC9B,OAAuB,EACN,EAAE;IACnB,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,sBAAsB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAExE,IAAI,CAAC,WAAW,EAAE;QAChB,MAAM,IAAI,KAAK,CACb,gDAAgD,UAAU,QAAQ,eAAe,oBAAoB,CACtG,CAAC;KACH;IAED,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEzE,MAAM,KAAK,GAAG,QAAQ;QACpB,CAAC,CAAC,MAAM,gCAAgC,CACpC,MAAM,EACN,eAAe,EACf,QAAQ,EACR,OAAO,CACR;QACH,CAAC,CAAC,MAAM,gCAAgC,CACpC,MAAM,EACN,eAAe,EACf,QAAQ,EACR,OAAO,CACR,CAAC;IAEN,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/esm/associations/getRequestingEntitiesQuery.js

@@ -0,0 +1,41 @@
+import { getTypeFromEntity } from "../core/getTypeFromEntity";
+import { getAssociationHierarchy } from "./internal/getAssociationHierarchy";
+import { getReferencesDoesNotIncludeQuery } from "./internal/getReferencesDoesNotIncludeQuery";
+import { getIncludesDoesNotReferenceQuery } from "./internal/getIncludesDoesNotReferenceQuery";
+import { isAssociationSupported } from "./internal/isAssociationSupported";
+/**
+ * Requesting entities represent "incoming" requests that are
+ * awaiting "approval". They imply a one-way "connection"
+ * between parent/child.
+ *
+ * From the parent's perspective:
+ * parent: does NOT "include" the child in its association query
+ * child: "references" the parent via a typeKeyword of the
+ * form ref|<parentType>|<parentID>
+ *
+ * From the child's perspective:
+ * parent: "includes" the child in its association query
+ * child: does NOT "reference" the parent via a typeKeyword
+ *
+ * The following returns a query to view an entity's incoming
+ * requests for association with another entity type
+ *
+ * @param entity - Hub entity
+ * @param associationType - entity type to query for
+ * @param context - contextual auth and portal information
+ * @returns {IQuery}
+ */
+export const getRequestingEntitiesQuery = async (entity, associationType, context) => {
+    const entityType = getTypeFromEntity(entity);
+    const isSupported = isAssociationSupported(entityType, associationType);
+    if (!isSupported) {
+        throw new Error(`getRequestingEntitiesQuery: Association between ${entityType} and ${associationType} is not supported.`);
+    }
+    const associationHierarchy = getAssociationHierarchy(entityType);
+    const isParent = associationHierarchy.children.includes(associationType);
+    const query = isParent
+        ? await getReferencesDoesNotIncludeQuery(entity, associationType, isParent, context)
+        : await getIncludesDoesNotReferenceQuery(entity, associationType, isParent, context);
+    return query;
+};
+//# sourceMappingURL=getRequestingEntitiesQuery.js.map

package/dist/esm/associations/getRequestingEntitiesQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRequestingEntitiesQuery.js","sourceRoot":"","sources":["../../../src/associations/getRequestingEntitiesQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAC;AAC/F,OAAO,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAG3E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,EAC7C,MAAiB,EACjB,eAA8B,EAC9B,OAAuB,EACN,EAAE;IACnB,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,sBAAsB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAExE,IAAI,CAAC,WAAW,EAAE;QAChB,MAAM,IAAI,KAAK,CACb,mDAAmD,UAAU,QAAQ,eAAe,oBAAoB,CACzG,CAAC;KACH;IAED,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEzE,MAAM,KAAK,GAAG,QAAQ;QACpB,CAAC,CAAC,MAAM,gCAAgC,CACpC,MAAM,EACN,eAAe,EACf,QAAQ,EACR,OAAO,CACR;QACH,CAAC,CAAC,MAAM,gCAAgC,CACpC,MAAM,EACN,eAAe,EACf,QAAQ,EACR,OAAO,CACR,CAAC;IAEN,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/esm/associations/getWellKnownAssociationsCatalog.js

@@ -0,0 +1,72 @@
+import { getTypeFromEntity } from "../core";
+import { buildCatalog } from "../search/_internal/buildCatalog";
+import { getEntityTypeFromType } from "../search/_internal/getEntityTypeFromType";
+import { getAssociatedEntitiesQuery } from "./getAssociatedEntitiesQuery";
+import { getPendingEntitiesQuery } from "./getPendingEntitiesQuery";
+import { getAvailableToRequestEntitiesQuery } from "./getAvailableToRequestEntitiesQuery";
+import { getRequestingEntitiesQuery } from "./getRequestingEntitiesQuery";
+import { isAssociationSupported } from "./internal/isAssociationSupported";
+import { dotifyString, getWellknownCollection, } from "../search/wellKnownCatalog";
+/**
+ * There are two primary UI workflows when we consider associations:
+ * 1. Viewing associations
+ * 2. Forming associations
+ *
+ * Because associations involve a 2-way agreement between parent
+ * and child, when viewing associations, there are 3 gallery states
+ * that can be viewed: "associated", "pending", and "requesting"
+ * entities. Additionally, when forming associations, we need a
+ * picker experience filtered to entities that can still be
+ * requested for association.
+ *
+ * These define the "well-known" association catalogs that this
+ * util can return. In turn, these can be passed into the catalog
+ * and/or gallery-picker components to render the appropriate
+ * UI experience.
+ *
+ * @param i18nScope - translation scope to be interpolated into the catalog
+ * @param catalogName - name of the well-known catalog requested
+ * @param entity - primary entity the catalog is being built for
+ * @param associationType - type of entity the primary entity wants to view associations for
+ * @param context - contextual auth and portal information
+ * @returns {IHubCatalog}
+ */
+export async function getWellKnownAssociationsCatalog(i18nScope, catalogName, entity, associationType, context) {
+    let catalog;
+    const entityType = getTypeFromEntity(entity);
+    const isSupported = isAssociationSupported(entityType, associationType);
+    if (!isSupported) {
+        throw new Error(`getWellKnownAssociationsCatalog: Association between ${entityType} and ${associationType} is not supported.`);
+    }
+    i18nScope = dotifyString(i18nScope);
+    const targetEntity = getEntityTypeFromType(entity.type);
+    /** 1. build a collection based on the provided associationType */
+    const collections = [
+        getWellknownCollection(i18nScope, targetEntity, associationType),
+    ];
+    /** 2. build a query based on the provided catalogName */
+    let query;
+    switch (catalogName) {
+        case "associated":
+            query = await getAssociatedEntitiesQuery(entity, associationType, context);
+            break;
+        case "pending":
+            query = await getPendingEntitiesQuery(entity, associationType, context);
+            break;
+        case "requesting":
+            query = await getRequestingEntitiesQuery(entity, associationType, context);
+            break;
+        case "availableToRequest":
+            query = getAvailableToRequestEntitiesQuery(entity, associationType);
+            break;
+    }
+    /** 3. build the well-known catalog */
+    // if query filters are undefined (e.g. query = null), we assume
+    // an empty state, and we need to construct a default query
+    // filter that will return no results
+    const filters = (query === null || query === void 0 ? void 0 : query.filters) ? query.filters
+        : [{ predicates: [{ type: ["Code Attachment"] }] }];
+    catalog = buildCatalog(i18nScope, catalogName, filters, collections, targetEntity);
+    return catalog;
+}
+//# sourceMappingURL=getWellKnownAssociationsCatalog.js.map

package/dist/esm/associations/getWellKnownAssociationsCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWellKnownAssociationsCatalog.js","sourceRoot":"","sources":["../../../src/associations/getWellKnownAssociationsCatalog.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,kCAAkC,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EAEL,YAAY,EACZ,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAapC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,SAAiB,EACjB,WAAwC,EACxC,MAAiB,EACjB,eAA8B,EAC9B,OAAuB;IAEvB,IAAI,OAAoB,CAAC;IACzB,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,sBAAsB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAExE,IAAI,CAAC,WAAW,EAAE;QAChB,MAAM,IAAI,KAAK,CACb,wDAAwD,UAAU,QAAQ,eAAe,oBAAoB,CAC9G,CAAC;KACH;IAED,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,YAAY,GAAG,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAExD,kEAAkE;IAClE,MAAM,WAAW,GAAG;QAClB,sBAAsB,CACpB,SAAS,EACT,YAAY,EACZ,eAAsC,CACvC;KACF,CAAC;IAEF,yDAAyD;IACzD,IAAI,KAAa,CAAC;IAClB,QAAQ,WAAW,EAAE;QACnB,KAAK,YAAY;YACf,KAAK,GAAG,MAAM,0BAA0B,CACtC,MAAM,EACN,eAAe,EACf,OAAO,CACR,CAAC;YACF,MAAM;QACR,KAAK,SAAS;YACZ,KAAK,GAAG,MAAM,uBAAuB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;YACxE,MAAM;QACR,KAAK,YAAY;YACf,KAAK,GAAG,MAAM,0BAA0B,CACtC,MAAM,EACN,eAAe,EACf,OAAO,CACR,CAAC;YACF,MAAM;QACR,KAAK,oBAAoB;YACvB,KAAK,GAAG,kCAAkC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;YACpE,MAAM;KACT;IAED,sCAAsC;IACtC,gEAAgE;IAChE,2DAA2D;IAC3D,qCAAqC;IACrC,MAAM,OAAO,GAAG,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,EAC5B,CAAC,CAAC,KAAK,CAAC,OAAO;QACf,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACtD,OAAO,GAAG,YAAY,CACpB,SAAS,EACT,WAAW,EACX,OAAO,EACP,WAAW,EACX,YAAY,CACb,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/esm/associations/index.js

@@ -1,5 +1,17 @@
 export * from "./addAssociation";
+export * from "./breakAssociation";
 export * from "./listAssociations";
 export * from "./removeAssociation";
 export * from "./types";
+export * from "./getAssociatedEntitiesQuery";
+export * from "./getAssociationStats";
+export * from "./getAvailableToRequestEntitiesQuery";
+export * from "./getPendingEntitiesQuery";
+export * from "./getRequestingEntitiesQuery";
+export * from "./getWellKnownAssociationsCatalog";
+// Note: we expose "requestAssociation" under 2 names.
+// These actions are functionally equivalent, but we want
+// to make the intent more clear to the consumer.
+export { requestAssociation } from "./requestAssociation";
+export { requestAssociation as acceptAssociation } from "./requestAssociation";
 //# sourceMappingURL=index.js.map

package/dist/esm/associations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/associations/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/associations/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sCAAsC,CAAC;AACrD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,sDAAsD;AACtD,yDAAyD;AACzD,iDAAiD;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/esm/associations/internal/getAssociationHierarchy.js

@@ -0,0 +1,33 @@
+import { ProjectAssociationHierarchies } from "../../projects/_internal/ProjectAssociationHierarchies";
+import { InitiativeAssociationHierarchies } from "../../initiatives/_internal/InitiativeAssociationHierarchies";
+/**
+ * associations are hierarchical in nature, e.g.
+ * there is always a parent and a child involved
+ * in the relationship.
+ *
+ * given an entity type, this util returns the
+ * parent and children entity types that it can
+ * associate with
+ *
+ * @param type - entity type
+ * @returns {IHubAssociationHierarchy}
+ */
+export const getAssociationHierarchy = (type) => {
+    let hierarchy = {
+        children: [],
+        parents: [],
+    };
+    switch (type) {
+        case "initiative":
+            hierarchy = InitiativeAssociationHierarchies;
+            break;
+        case "project":
+            hierarchy = ProjectAssociationHierarchies;
+            break;
+        // as we support more entity associations, we'll need to extend this
+        default:
+            throw new Error(`getAssociationHierarchy: Invalid type for associations: ${type}.`);
+    }
+    return hierarchy;
+};
+//# sourceMappingURL=getAssociationHierarchy.js.map

package/dist/esm/associations/internal/getAssociationHierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAssociationHierarchy.js","sourceRoot":"","sources":["../../../../src/associations/internal/getAssociationHierarchy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,MAAM,wDAAwD,CAAC;AACvG,OAAO,EAAE,gCAAgC,EAAE,MAAM,8DAA8D,CAAC;AAEhH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,IAAmB,EACO,EAAE;IAC5B,IAAI,SAAS,GAA6B;QACxC,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,EAAE;KACZ,CAAC;IACF,QAAQ,IAAI,EAAE;QACZ,KAAK,YAAY;YACf,SAAS,GAAG,gCAAgC,CAAC;YAC7C,MAAM;QACR,KAAK,SAAS;YACZ,SAAS,GAAG,6BAA6B,CAAC;YAC1C,MAAM;QACR,oEAAoE;QACpE;YACE,MAAM,IAAI,KAAK,CACb,2DAA2D,IAAI,GAAG,CACnE,CAAC;KACL;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

package/dist/esm/associations/internal/getIdsFromAssociationGroups.js

@@ -0,0 +1,25 @@
+/**
+ * given an array of groups, this util maps over them,
+ * and for each, determines if it's an association group
+ * by checking if it has a typeKeyword of the form
+ * <associationType>|<id>. If so, it extracts and returns
+ * the id which corresponds to the parent entity that this
+ * association group belongs to
+ *
+ * @param groups - array of groups
+ * @param associationType - entity type to extract ids for
+ * @returns {string[]}
+ */
+export const getIdsFromAssociationGroups = (groups, associationType) => {
+    return groups.reduce((ids, group) => {
+        // 1. determine if the group is an association group
+        const associationTypeKeyword = group.typeKeywords.find((keyword) => keyword.startsWith(`${associationType}|`));
+        // 2. if so, store the parent id from the typeKeyword to return
+        if (associationTypeKeyword) {
+            const id = associationTypeKeyword.split("|")[1];
+            ids.push(id);
+        }
+        return ids;
+    }, []);
+};
+//# sourceMappingURL=getIdsFromAssociationGroups.js.map

package/dist/esm/associations/internal/getIdsFromAssociationGroups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getIdsFromAssociationGroups.js","sourceRoot":"","sources":["../../../../src/associations/internal/getIdsFromAssociationGroups.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,MAAgB,EAChB,eAA8B,EACpB,EAAE;IACZ,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAa,EAAE,KAAa,EAAE,EAAE;QACpD,oDAAoD;QACpD,MAAM,sBAAsB,GAAG,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,OAAe,EAAE,EAAE,CACzE,OAAO,CAAC,UAAU,CAAC,GAAG,eAAe,GAAG,CAAC,CAC1C,CAAC;QAEF,+DAA+D;QAC/D,IAAI,sBAAsB,EAAE;YAC1B,MAAM,EAAE,GAAG,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAChD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SACd;QAED,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC,CAAC"}

package/dist/esm/associations/internal/getIdsFromKeywords.js

@@ -0,0 +1,22 @@
+import { getProp } from "../../objects";
+/**
+ * given a hub entity, this util maps over its typeKeywords,
+ * and for each, determines if it is an association typeKeyword
+ * by checking whether it has the form ref|<associationType>|<id>.
+ * If so, it extracts and returns the id which correspond to the
+ * parent entity that this entity is associated with.
+ *
+ * @param entity - hub entity to extract ids from
+ * @param associationType - entity type to extract ids for
+ * @returns {string[]}
+ */
+export const getIdsFromKeywords = (entity, associationType) => {
+    return getProp(entity, "typeKeywords").reduce((ids, keyword) => {
+        if (keyword.startsWith(`ref|${associationType}|`)) {
+            const id = keyword.split("|")[2];
+            ids.push(id);
+        }
+        return ids;
+    }, []);
+};
+//# sourceMappingURL=getIdsFromKeywords.js.map

package/dist/esm/associations/internal/getIdsFromKeywords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getIdsFromKeywords.js","sourceRoot":"","sources":["../../../../src/associations/internal/getIdsFromKeywords.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAAiB,EACjB,eAA8B,EACpB,EAAE;IACZ,OAAO,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,MAAM,CAC3C,CAAC,GAAa,EAAE,OAAe,EAAE,EAAE;QACjC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,GAAG,CAAC,EAAE;YACjD,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACjC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SACd;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EACD,EAAE,CACH,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/associations/internal/getIncludesAndReferencesQuery.js

@@ -0,0 +1,58 @@
+import { getItemGroups } from "@esri/arcgis-rest-portal";
+import { getTypesFromEntityType } from "../../core/getTypesFromEntityType";
+import { getProp } from "../../objects/get-prop";
+import { combineQueries } from "../../search/_internal/combineQueries";
+import { getTypeWithKeywordQuery } from "./getTypeWithKeywordQuery";
+import { getTypeByIdsQuery } from "./getTypeByIdsQuery";
+import { getTypeFromEntity } from "../../core/getTypeFromEntity";
+import { getIdsFromKeywords } from "./getIdsFromKeywords";
+import { getIdsFromAssociationGroups } from "./getIdsFromAssociationGroups";
+/**
+ * builds a query that will return entities that are
+ * "included" AND "referenced"
+ *
+ * @param entity - Hub entity
+ * @param associationType - entity type to query for
+ * @param isParent - whether the provided Hub entity is the parent in the association relationship
+ * @param context - contextual auth and portal information
+ * @returns {IQuery}
+ */
+export const getIncludesAndReferencesQuery = async (entity, associationType, isParent, context) => {
+    if (isParent) {
+        /**
+         * 1. build query that returns child entities WITH a
+         * typeKeyword reference to the parent
+         */
+        const parentType = getTypeFromEntity(entity);
+        const referencedQuery = getTypeWithKeywordQuery(getTypesFromEntityType(associationType), `ref|${parentType}|${entity.id}`);
+        /** 2. grab the parent's association query */
+        const includedQuery = getProp(entity, "associations.rules.query");
+        /** 3. combine queries - will remove null/undefined entries */
+        return combineQueries([referencedQuery, includedQuery]);
+    }
+    else {
+        /** 1. fetch the groups a child has been shared with */
+        const { admin, member, other } = await getItemGroups(entity.id, context.requestOptions);
+        const groupsChildIsSharedWith = [...admin, ...member, ...other];
+        /**
+         * 2. filter the child's groups down to association groups
+         * (by checking if they have a typeKeyword of the form
+         * <associationType>|<id>) and extract parent ids
+         */
+        const parentIdsThatIncludeChild = getIdsFromAssociationGroups(groupsChildIsSharedWith, associationType);
+        /**
+         * 3. iterate over the child's typeKeywords and grab the parent
+         * ids it references (typeKeyword = <associationType>|<id>)
+         */
+        const parentIdsChildReferences = getIdsFromKeywords(entity, associationType);
+        /**
+         * 4. filter the parent ids down to those that include
+         * the child AND that the child references
+         */
+        const parentIds = parentIdsThatIncludeChild.filter((id) => parentIdsChildReferences.includes(id));
+        /** 5. return a query for the filtered parent ids */
+        const type = getTypesFromEntityType(associationType);
+        return parentIds.length ? getTypeByIdsQuery(type, parentIds) : null;
+    }
+};
+//# sourceMappingURL=getIncludesAndReferencesQuery.js.map

package/dist/esm/associations/internal/getIncludesAndReferencesQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getIncludesAndReferencesQuery.js","sourceRoot":"","sources":["../../../../src/associations/internal/getIncludesAndReferencesQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,EAChD,MAAiB,EACjB,eAA8B,EAC9B,QAAiB,EACjB,OAAuB,EACN,EAAE;IACnB,IAAI,QAAQ,EAAE;QACZ;;;WAGG;QACH,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,eAAe,GAAG,uBAAuB,CAC7C,sBAAsB,CAAC,eAAe,CAAC,EACvC,OAAO,UAAU,IAAI,MAAM,CAAC,EAAE,EAAE,CACjC,CAAC;QAEF,6CAA6C;QAC7C,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;QAElE,8DAA8D;QAC9D,OAAO,cAAc,CAAC,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC;KACzD;SAAM;QACL,uDAAuD;QACvD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,aAAa,CAClD,MAAM,CAAC,EAAE,EACT,OAAO,CAAC,cAAc,CACvB,CAAC;QACF,MAAM,uBAAuB,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;QAEhE;;;;WAIG;QACH,MAAM,yBAAyB,GAAG,2BAA2B,CAC3D,uBAAuB,EACvB,eAAe,CAChB,CAAC;QAEF;;;WAGG;QACH,MAAM,wBAAwB,GAAG,kBAAkB,CACjD,MAAM,EACN,eAAe,CAChB,CAAC;QAEF;;;WAGG;QACH,MAAM,SAAS,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC,EAAU,EAAE,EAAE,CAChE,wBAAwB,CAAC,QAAQ,CAAC,EAAE,CAAC,CACtC,CAAC;QAEF,oDAAoD;QACpD,MAAM,IAAI,GAAG,sBAAsB,CAAC,eAAe,CAAC,CAAC;QACrD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;KACrE;AACH,CAAC,CAAC"}