@esri/hub-common 14.74.1 → 14.75.0

package/dist/node/associations/breakAssociation.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.breakAssociation = void 0;
+const arcgis_rest_portal_1 = require("@esri/arcgis-rest-portal");
+const objects_1 = require("../objects");
+const core_1 = require("../core");
+const getTypeFromEntity_1 = require("../core/getTypeFromEntity");
+const updateHubEntity_1 = require("../core/updateHubEntity");
+const getAssociationHierarchy_1 = require("./internal/getAssociationHierarchy");
+const isAssociationSupported_1 = require("./internal/isAssociationSupported");
+const removeAssociationKeyword_1 = require("./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
+ */
+exports.breakAssociation = async (entity, associationType, id, context) => {
+    const entityType = getTypeFromEntity_1.getTypeFromEntity(entity);
+    const isSupported = isAssociationSupported_1.isAssociationSupported(entityType, associationType);
+    if (!isSupported) {
+        throw new Error(`breakAssociation: Association between ${entityType} and ${associationType} is not supported.`);
+    }
+    const associationHierarchy = getAssociationHierarchy_1.getAssociationHierarchy(entityType);
+    const isParent = associationHierarchy.children.includes(associationType);
+    if (isParent) {
+        const associationGroupId = objects_1.getProp(entity, "associations.groupId");
+        const { owner } = await core_1.fetchHubEntity(associationType, id, context);
+        try {
+            await arcgis_rest_portal_1.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_1.removeAssociationKeyword(entity.typeKeywords, associationType, id);
+        await updateHubEntity_1.updateHubEntity(entityType, entity, context);
+    }
+};
+//# sourceMappingURL=breakAssociation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"breakAssociation.js","sourceRoot":"","sources":["../../../src/associations/breakAssociation.ts"],"names":[],"mappings":";;;AAAA,iEAAgE;AAEhE,wCAAqC;AACrC,kCAAyC;AAEzC,iEAA8D;AAC9D,6DAA0D;AAC1D,gFAA6E;AAC7E,8EAA2E;AAC3E,kFAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,gBAAgB,GAAG,KAAK,EACnC,MAAiB,EACjB,eAA8B,EAC9B,EAAU,EACV,OAAuB,EACR,EAAE;IACjB,MAAM,UAAU,GAAG,qCAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,+CAAsB,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,iDAAuB,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,iBAAO,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;QACnE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,qBAAc,CAAC,eAAe,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QACrE,IAAI;YACF,MAAM,yCAAoB,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,mDAAwB,CAC5C,MAAM,CAAC,YAAY,EACnB,eAAe,EACf,EAAE,CACH,CAAC;QACF,MAAM,iCAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;KACpD;AACH,CAAC,CAAC"}

package/dist/node/associations/getAssociatedEntitiesQuery.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAssociatedEntitiesQuery = void 0;
+const getTypeFromEntity_1 = require("../core/getTypeFromEntity");
+const getAssociationHierarchy_1 = require("./internal/getAssociationHierarchy");
+const isAssociationSupported_1 = require("./internal/isAssociationSupported");
+const getIncludesAndReferencesQuery_1 = require("./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}
+ */
+exports.getAssociatedEntitiesQuery = async (entity, associationType, context) => {
+    const entityType = getTypeFromEntity_1.getTypeFromEntity(entity);
+    const isSupported = isAssociationSupported_1.isAssociationSupported(entityType, associationType);
+    if (!isSupported) {
+        throw new Error(`getAssociatedEntitiesQuery: Association between ${entityType} and ${associationType} is not supported.`);
+    }
+    const associationHierarchy = getAssociationHierarchy_1.getAssociationHierarchy(entityType);
+    const isParent = associationHierarchy.children.includes(associationType);
+    const query = await getIncludesAndReferencesQuery_1.getIncludesAndReferencesQuery(entity, associationType, isParent, context);
+    return query;
+};
+//# sourceMappingURL=getAssociatedEntitiesQuery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getAssociatedEntitiesQuery.js","sourceRoot":"","sources":["../../../src/associations/getAssociatedEntitiesQuery.ts"],"names":[],"mappings":";;;AAAA,iEAA8D;AAG9D,gFAA6E;AAC7E,8EAA2E;AAC3E,4FAAyF;AAGzF;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,0BAA0B,GAAG,KAAK,EAC7C,MAAiB,EACjB,eAA8B,EAC9B,OAAuB,EACN,EAAE;IACnB,MAAM,UAAU,GAAG,qCAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,+CAAsB,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,iDAAuB,CAAC,UAAU,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEzE,MAAM,KAAK,GAAG,MAAM,6DAA6B,CAC/C,MAAM,EACN,eAAe,EACf,QAAQ,EACR,OAAO,CACR,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/node/associations/getAssociationStats.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAssociationStats = void 0;
+const getTypeFromEntity_1 = require("../core/getTypeFromEntity");
+const hubSearch_1 = require("../search/hubSearch");
+const getAssociatedEntitiesQuery_1 = require("./getAssociatedEntitiesQuery");
+const getPendingEntitiesQuery_1 = require("./getPendingEntitiesQuery");
+const getRequestingEntitiesQuery_1 = require("./getRequestingEntitiesQuery");
+const getAssociationHierarchy_1 = require("./internal/getAssociationHierarchy");
+const isAssociationSupported_1 = require("./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
+ */
+exports.getAssociationStats = async (entity, associationType, context) => {
+    let stats;
+    const entityType = getTypeFromEntity_1.getTypeFromEntity(entity);
+    const isSupported = isAssociationSupported_1.isAssociationSupported(entityType, associationType);
+    if (!isSupported) {
+        throw new Error(`getAssociationStats: Association between ${entityType} and ${associationType} is not supported.`);
+    }
+    const associationHierarchy = getAssociationHierarchy_1.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_1.getAssociatedEntitiesQuery(entity, associationType, context),
+            getPendingEntitiesQuery_1.getPendingEntitiesQuery(entity, associationType, context),
+            getRequestingEntitiesQuery_1.getRequestingEntitiesQuery(entity, associationType, context),
+        ]);
+        const [{ total: associated }, { total: pending }, { total: requesting }] = await Promise.all(queries.map((query) => {
+            return hubSearch_1.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/node/associations/getAssociationStats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAssociationStats.js","sourceRoot":"","sources":["../../../src/associations/getAssociationStats.ts"],"names":[],"mappings":";;;AACA,iEAA8D;AAG9D,mDAAgD;AAChD,6EAA0E;AAC1E,uEAAoE;AACpE,6EAA0E;AAC1E,gFAA6E;AAC7E,8EAA2E;AAG3E;;;;;;;;GAQG;AACU,QAAA,mBAAmB,GAAG,KAAK,EACtC,MAAiB,EACjB,eAA8B,EAC9B,OAAuB,EACK,EAAE;IAC9B,IAAI,KAAwB,CAAC;IAC7B,MAAM,UAAU,GAAG,qCAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,+CAAsB,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,iDAAuB,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,uDAA0B,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC;YAC5D,iDAAuB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC;YACzD,uDAA0B,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,qBAAS,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/node/associations/getAvailableToRequestEntitiesQuery.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAvailableToRequestEntitiesQuery = void 0;
+const getTypeFromEntity_1 = require("../core/getTypeFromEntity");
+const getAssociationHierarchy_1 = require("./internal/getAssociationHierarchy");
+const isAssociationSupported_1 = require("./internal/isAssociationSupported");
+const get_prop_1 = require("../objects/get-prop");
+const getTypesFromEntityType_1 = require("../core/getTypesFromEntityType");
+const getIdsFromKeywords_1 = require("./internal/getIdsFromKeywords");
+const getTypeByNotIdsQuery_1 = require("./internal/getTypeByNotIdsQuery");
+const negateGroupPredicates_1 = require("../search/_internal/negateGroupPredicates");
+const getTypeByIdsQuery_1 = require("./internal/getTypeByIdsQuery");
+const combineQueries_1 = require("../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}
+ */
+exports.getAvailableToRequestEntitiesQuery = (entity, associationType) => {
+    let query;
+    const entityType = getTypeFromEntity_1.getTypeFromEntity(entity);
+    const isSupported = isAssociationSupported_1.isAssociationSupported(entityType, associationType);
+    if (!isSupported) {
+        throw new Error(`getAvailableToRequestEntitiesQuery: Association between ${entityType} and ${associationType} is not supported.`);
+    }
+    const associationHierarchy = getAssociationHierarchy_1.getAssociationHierarchy(entityType);
+    const isParent = associationHierarchy.children.includes(associationType);
+    if (isParent) {
+        /** 1. build query that returns child entities */
+        const childType = getTypesFromEntityType_1.getTypesFromEntityType(associationType);
+        const childTypeQuery = getTypeByIdsQuery_1.getTypeByIdsQuery(childType, []);
+        /**
+         * 2. grab the parent's association query and negate
+         * the group predicate
+         */
+        const notIncludedQuery = negateGroupPredicates_1.negateGroupPredicates(get_prop_1.getProp(entity, "associations.rules.query"));
+        /** 3. combine queries - will remove null/undefined entries */
+        query = combineQueries_1.combineQueries([notIncludedQuery, childTypeQuery]);
+    }
+    else {
+        /**
+         * 1. iterate over the child's typeKeywords and grab the parent
+         * ids it references (typeKeyword = <associationType>|<id>)
+         */
+        const ids = getIdsFromKeywords_1.getIdsFromKeywords(entity, associationType);
+        /**
+         * 2. build query that returns parent entities NOT
+         * "referenced" by the child
+         */
+        const type = getTypesFromEntityType_1.getTypesFromEntityType(associationType);
+        query = getTypeByNotIdsQuery_1.getTypeByNotIdsQuery(type, ids);
+    }
+    return query;
+};
+//# sourceMappingURL=getAvailableToRequestEntitiesQuery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getAvailableToRequestEntitiesQuery.js","sourceRoot":"","sources":["../../../src/associations/getAvailableToRequestEntitiesQuery.ts"],"names":[],"mappings":";;;AAAA,iEAA8D;AAG9D,gFAA6E;AAC7E,8EAA2E;AAC3E,kDAA8C;AAC9C,2EAAwE;AACxE,sEAAmE;AACnE,0EAAuE;AACvE,qFAAkF;AAClF,oEAAiE;AACjE,uEAAoE;AAEpE;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,kCAAkC,GAAG,CAChD,MAAiB,EACjB,eAA8B,EACtB,EAAE;IACV,IAAI,KAAa,CAAC;IAClB,MAAM,UAAU,GAAG,qCAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,+CAAsB,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,iDAAuB,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,+CAAsB,CAAC,eAAe,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,qCAAiB,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAExD;;;WAGG;QACH,MAAM,gBAAgB,GAAG,6CAAqB,CAC5C,kBAAO,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAC5C,CAAC;QAEF,8DAA8D;QAC9D,KAAK,GAAG,+BAAc,CAAC,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC;KAC5D;SAAM;QACL;;;WAGG;QACH,MAAM,GAAG,GAAG,uCAAkB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QAExD;;;WAGG;QACH,MAAM,IAAI,GAAG,+CAAsB,CAAC,eAAe,CAAC,CAAC;QACrD,KAAK,GAAG,2CAAoB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;KACzC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/node/associations/getPendingEntitiesQuery.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPendingEntitiesQuery = void 0;
+const getTypeFromEntity_1 = require("../core/getTypeFromEntity");
+const getAssociationHierarchy_1 = require("./internal/getAssociationHierarchy");
+const getReferencesDoesNotIncludeQuery_1 = require("./internal/getReferencesDoesNotIncludeQuery");
+const getIncludesDoesNotReferenceQuery_1 = require("./internal/getIncludesDoesNotReferenceQuery");
+const isAssociationSupported_1 = require("./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}
+ */
+exports.getPendingEntitiesQuery = async (entity, associationType, context) => {
+    const entityType = getTypeFromEntity_1.getTypeFromEntity(entity);
+    const isSupported = isAssociationSupported_1.isAssociationSupported(entityType, associationType);
+    if (!isSupported) {
+        throw new Error(`getPendingEntitiesQuery: Association between ${entityType} and ${associationType} is not supported.`);
+    }
+    const associationHierarchy = getAssociationHierarchy_1.getAssociationHierarchy(entityType);
+    const isParent = associationHierarchy.children.includes(associationType);
+    const query = isParent
+        ? await getIncludesDoesNotReferenceQuery_1.getIncludesDoesNotReferenceQuery(entity, associationType, isParent, context)
+        : await getReferencesDoesNotIncludeQuery_1.getReferencesDoesNotIncludeQuery(entity, associationType, isParent, context);
+    return query;
+};
+//# sourceMappingURL=getPendingEntitiesQuery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getPendingEntitiesQuery.js","sourceRoot":"","sources":["../../../src/associations/getPendingEntitiesQuery.ts"],"names":[],"mappings":";;;AAAA,iEAA8D;AAG9D,gFAA6E;AAC7E,kGAA+F;AAC/F,kGAA+F;AAC/F,8EAA2E;AAG3E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACU,QAAA,uBAAuB,GAAG,KAAK,EAC1C,MAAiB,EACjB,eAA8B,EAC9B,OAAuB,EACN,EAAE;IACnB,MAAM,UAAU,GAAG,qCAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,+CAAsB,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,iDAAuB,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,mEAAgC,CACpC,MAAM,EACN,eAAe,EACf,QAAQ,EACR,OAAO,CACR;QACH,CAAC,CAAC,MAAM,mEAAgC,CACpC,MAAM,EACN,eAAe,EACf,QAAQ,EACR,OAAO,CACR,CAAC;IAEN,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/node/associations/getRequestingEntitiesQuery.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRequestingEntitiesQuery = void 0;
+const getTypeFromEntity_1 = require("../core/getTypeFromEntity");
+const getAssociationHierarchy_1 = require("./internal/getAssociationHierarchy");
+const getReferencesDoesNotIncludeQuery_1 = require("./internal/getReferencesDoesNotIncludeQuery");
+const getIncludesDoesNotReferenceQuery_1 = require("./internal/getIncludesDoesNotReferenceQuery");
+const isAssociationSupported_1 = require("./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}
+ */
+exports.getRequestingEntitiesQuery = async (entity, associationType, context) => {
+    const entityType = getTypeFromEntity_1.getTypeFromEntity(entity);
+    const isSupported = isAssociationSupported_1.isAssociationSupported(entityType, associationType);
+    if (!isSupported) {
+        throw new Error(`getRequestingEntitiesQuery: Association between ${entityType} and ${associationType} is not supported.`);
+    }
+    const associationHierarchy = getAssociationHierarchy_1.getAssociationHierarchy(entityType);
+    const isParent = associationHierarchy.children.includes(associationType);
+    const query = isParent
+        ? await getReferencesDoesNotIncludeQuery_1.getReferencesDoesNotIncludeQuery(entity, associationType, isParent, context)
+        : await getIncludesDoesNotReferenceQuery_1.getIncludesDoesNotReferenceQuery(entity, associationType, isParent, context);
+    return query;
+};
+//# sourceMappingURL=getRequestingEntitiesQuery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getRequestingEntitiesQuery.js","sourceRoot":"","sources":["../../../src/associations/getRequestingEntitiesQuery.ts"],"names":[],"mappings":";;;AAAA,iEAA8D;AAG9D,gFAA6E;AAC7E,kGAA+F;AAC/F,kGAA+F;AAC/F,8EAA2E;AAG3E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACU,QAAA,0BAA0B,GAAG,KAAK,EAC7C,MAAiB,EACjB,eAA8B,EAC9B,OAAuB,EACN,EAAE;IACnB,MAAM,UAAU,GAAG,qCAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,+CAAsB,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,iDAAuB,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,mEAAgC,CACpC,MAAM,EACN,eAAe,EACf,QAAQ,EACR,OAAO,CACR;QACH,CAAC,CAAC,MAAM,mEAAgC,CACpC,MAAM,EACN,eAAe,EACf,QAAQ,EACR,OAAO,CACR,CAAC;IAEN,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/node/associations/getWellKnownAssociationsCatalog.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWellKnownAssociationsCatalog = void 0;
+const core_1 = require("../core");
+const buildCatalog_1 = require("../search/_internal/buildCatalog");
+const getEntityTypeFromType_1 = require("../search/_internal/getEntityTypeFromType");
+const getAssociatedEntitiesQuery_1 = require("./getAssociatedEntitiesQuery");
+const getPendingEntitiesQuery_1 = require("./getPendingEntitiesQuery");
+const getAvailableToRequestEntitiesQuery_1 = require("./getAvailableToRequestEntitiesQuery");
+const getRequestingEntitiesQuery_1 = require("./getRequestingEntitiesQuery");
+const isAssociationSupported_1 = require("./internal/isAssociationSupported");
+const wellKnownCatalog_1 = require("../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}
+ */
+async function getWellKnownAssociationsCatalog(i18nScope, catalogName, entity, associationType, context) {
+    let catalog;
+    const entityType = core_1.getTypeFromEntity(entity);
+    const isSupported = isAssociationSupported_1.isAssociationSupported(entityType, associationType);
+    if (!isSupported) {
+        throw new Error(`getWellKnownAssociationsCatalog: Association between ${entityType} and ${associationType} is not supported.`);
+    }
+    i18nScope = wellKnownCatalog_1.dotifyString(i18nScope);
+    const targetEntity = getEntityTypeFromType_1.getEntityTypeFromType(entity.type);
+    /** 1. build a collection based on the provided associationType */
+    const collections = [
+        wellKnownCatalog_1.getWellknownCollection(i18nScope, targetEntity, associationType),
+    ];
+    /** 2. build a query based on the provided catalogName */
+    let query;
+    switch (catalogName) {
+        case "associated":
+            query = await getAssociatedEntitiesQuery_1.getAssociatedEntitiesQuery(entity, associationType, context);
+            break;
+        case "pending":
+            query = await getPendingEntitiesQuery_1.getPendingEntitiesQuery(entity, associationType, context);
+            break;
+        case "requesting":
+            query = await getRequestingEntitiesQuery_1.getRequestingEntitiesQuery(entity, associationType, context);
+            break;
+        case "availableToRequest":
+            query = getAvailableToRequestEntitiesQuery_1.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_1.buildCatalog(i18nScope, catalogName, filters, collections, targetEntity);
+    return catalog;
+}
+exports.getWellKnownAssociationsCatalog = getWellKnownAssociationsCatalog;
+//# sourceMappingURL=getWellKnownAssociationsCatalog.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getWellKnownAssociationsCatalog.js","sourceRoot":"","sources":["../../../src/associations/getWellKnownAssociationsCatalog.ts"],"names":[],"mappings":";;;AACA,kCAA4C;AAE5C,mEAAgE;AAChE,qFAAkF;AAClF,6EAA0E;AAC1E,uEAAoE;AACpE,6FAA0F;AAC1F,6EAA0E;AAC1E,8EAA2E;AAE3E,iEAIoC;AAapC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,KAAK,UAAU,+BAA+B,CACnD,SAAiB,EACjB,WAAwC,EACxC,MAAiB,EACjB,eAA8B,EAC9B,OAAuB;IAEvB,IAAI,OAAoB,CAAC;IACzB,MAAM,UAAU,GAAG,wBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,+CAAsB,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,+BAAY,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,YAAY,GAAG,6CAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAExD,kEAAkE;IAClE,MAAM,WAAW,GAAG;QAClB,yCAAsB,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,uDAA0B,CACtC,MAAM,EACN,eAAe,EACf,OAAO,CACR,CAAC;YACF,MAAM;QACR,KAAK,SAAS;YACZ,KAAK,GAAG,MAAM,iDAAuB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;YACxE,MAAM;QACR,KAAK,YAAY;YACf,KAAK,GAAG,MAAM,uDAA0B,CACtC,MAAM,EACN,eAAe,EACf,OAAO,CACR,CAAC;YACF,MAAM;QACR,KAAK,oBAAoB;YACvB,KAAK,GAAG,uEAAkC,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,2BAAY,CACpB,SAAS,EACT,WAAW,EACX,OAAO,EACP,WAAW,EACX,YAAY,CACb,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAtED,0EAsEC"}

package/dist/node/associations/index.js

@@ -2,7 +2,21 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./addAssociation"), exports);
+tslib_1.__exportStar(require("./breakAssociation"), exports);
 tslib_1.__exportStar(require("./listAssociations"), exports);
 tslib_1.__exportStar(require("./removeAssociation"), exports);
 tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./getAssociatedEntitiesQuery"), exports);
+tslib_1.__exportStar(require("./getAssociationStats"), exports);
+tslib_1.__exportStar(require("./getAvailableToRequestEntitiesQuery"), exports);
+tslib_1.__exportStar(require("./getPendingEntitiesQuery"), exports);
+tslib_1.__exportStar(require("./getRequestingEntitiesQuery"), exports);
+tslib_1.__exportStar(require("./getWellKnownAssociationsCatalog"), exports);
+// Note: we expose "requestAssociation" under 2 names.
+// These actions are functionally equivalent, but we want
+// to make the intent more clear to the consumer.
+var requestAssociation_1 = require("./requestAssociation");
+Object.defineProperty(exports, "requestAssociation", { enumerable: true, get: function () { return requestAssociation_1.requestAssociation; } });
+var requestAssociation_2 = require("./requestAssociation");
+Object.defineProperty(exports, "acceptAssociation", { enumerable: true, get: function () { return requestAssociation_2.requestAssociation; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/associations/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,6DAAmC;AACnC,8DAAoC;AACpC,kDAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/associations/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,6DAAmC;AACnC,6DAAmC;AACnC,8DAAoC;AACpC,kDAAwB;AACxB,uEAA6C;AAC7C,gEAAsC;AACtC,+EAAqD;AACrD,oEAA0C;AAC1C,uEAA6C;AAC7C,4EAAkD;AAClD,sDAAsD;AACtD,yDAAyD;AACzD,iDAAiD;AACjD,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,2DAA+E;AAAtE,uHAAA,kBAAkB,OAAqB"}

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAssociationHierarchy = void 0;
+const ProjectAssociationHierarchies_1 = require("../../projects/_internal/ProjectAssociationHierarchies");
+const InitiativeAssociationHierarchies_1 = require("../../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}
+ */
+exports.getAssociationHierarchy = (type) => {
+    let hierarchy = {
+        children: [],
+        parents: [],
+    };
+    switch (type) {
+        case "initiative":
+            hierarchy = InitiativeAssociationHierarchies_1.InitiativeAssociationHierarchies;
+            break;
+        case "project":
+            hierarchy = ProjectAssociationHierarchies_1.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/node/associations/internal/getAssociationHierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAssociationHierarchy.js","sourceRoot":"","sources":["../../../../src/associations/internal/getAssociationHierarchy.ts"],"names":[],"mappings":";;;AAEA,0GAAuG;AACvG,mHAAgH;AAEhH;;;;;;;;;;;GAWG;AACU,QAAA,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,mEAAgC,CAAC;YAC7C,MAAM;QACR,KAAK,SAAS;YACZ,SAAS,GAAG,6DAA6B,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/node/associations/internal/getIdsFromAssociationGroups.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIdsFromAssociationGroups = void 0;
+/**
+ * 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[]}
+ */
+exports.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/node/associations/internal/getIdsFromAssociationGroups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getIdsFromAssociationGroups.js","sourceRoot":"","sources":["../../../../src/associations/internal/getIdsFromAssociationGroups.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;GAWG;AACU,QAAA,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/node/associations/internal/getIdsFromKeywords.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIdsFromKeywords = void 0;
+const objects_1 = require("../../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[]}
+ */
+exports.getIdsFromKeywords = (entity, associationType) => {
+    return objects_1.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/node/associations/internal/getIdsFromKeywords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getIdsFromKeywords.js","sourceRoot":"","sources":["../../../../src/associations/internal/getIdsFromKeywords.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;GAUG;AACU,QAAA,kBAAkB,GAAG,CAChC,MAAiB,EACjB,eAA8B,EACpB,EAAE;IACZ,OAAO,iBAAO,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/node/associations/internal/getIncludesAndReferencesQuery.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIncludesAndReferencesQuery = void 0;
+const arcgis_rest_portal_1 = require("@esri/arcgis-rest-portal");
+const getTypesFromEntityType_1 = require("../../core/getTypesFromEntityType");
+const get_prop_1 = require("../../objects/get-prop");
+const combineQueries_1 = require("../../search/_internal/combineQueries");
+const getTypeWithKeywordQuery_1 = require("./getTypeWithKeywordQuery");
+const getTypeByIdsQuery_1 = require("./getTypeByIdsQuery");
+const getTypeFromEntity_1 = require("../../core/getTypeFromEntity");
+const getIdsFromKeywords_1 = require("./getIdsFromKeywords");
+const getIdsFromAssociationGroups_1 = require("./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}
+ */
+exports.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_1.getTypeFromEntity(entity);
+        const referencedQuery = getTypeWithKeywordQuery_1.getTypeWithKeywordQuery(getTypesFromEntityType_1.getTypesFromEntityType(associationType), `ref|${parentType}|${entity.id}`);
+        /** 2. grab the parent's association query */
+        const includedQuery = get_prop_1.getProp(entity, "associations.rules.query");
+        /** 3. combine queries - will remove null/undefined entries */
+        return combineQueries_1.combineQueries([referencedQuery, includedQuery]);
+    }
+    else {
+        /** 1. fetch the groups a child has been shared with */
+        const { admin, member, other } = await arcgis_rest_portal_1.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_1.getIdsFromAssociationGroups(groupsChildIsSharedWith, associationType);
+        /**
+         * 3. iterate over the child's typeKeywords and grab the parent
+         * ids it references (typeKeyword = <associationType>|<id>)
+         */
+        const parentIdsChildReferences = getIdsFromKeywords_1.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_1.getTypesFromEntityType(associationType);
+        return parentIds.length ? getTypeByIdsQuery_1.getTypeByIdsQuery(type, parentIds) : null;
+    }
+};
+//# sourceMappingURL=getIncludesAndReferencesQuery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getIncludesAndReferencesQuery.js","sourceRoot":"","sources":["../../../../src/associations/internal/getIncludesAndReferencesQuery.ts"],"names":[],"mappings":";;;AAAA,iEAAiE;AAEjE,8EAA2E;AAC3E,qDAAiD;AAEjD,0EAAuE;AACvE,uEAAoE;AAEpE,2DAAwD;AACxD,oEAAiE;AACjE,6DAA0D;AAC1D,+EAA4E;AAE5E;;;;;;;;;GASG;AACU,QAAA,6BAA6B,GAAG,KAAK,EAChD,MAAiB,EACjB,eAA8B,EAC9B,QAAiB,EACjB,OAAuB,EACN,EAAE;IACnB,IAAI,QAAQ,EAAE;QACZ;;;WAGG;QACH,MAAM,UAAU,GAAG,qCAAiB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,eAAe,GAAG,iDAAuB,CAC7C,+CAAsB,CAAC,eAAe,CAAC,EACvC,OAAO,UAAU,IAAI,MAAM,CAAC,EAAE,EAAE,CACjC,CAAC;QAEF,6CAA6C;QAC7C,MAAM,aAAa,GAAG,kBAAO,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;QAElE,8DAA8D;QAC9D,OAAO,+BAAc,CAAC,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC;KACzD;SAAM;QACL,uDAAuD;QACvD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,kCAAa,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,yDAA2B,CAC3D,uBAAuB,EACvB,eAAe,CAChB,CAAC;QAEF;;;WAGG;QACH,MAAM,wBAAwB,GAAG,uCAAkB,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,+CAAsB,CAAC,eAAe,CAAC,CAAC;QACrD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,qCAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;KACrE;AACH,CAAC,CAAC"}