@uniformdev/project-map 19.173.1-alpha.17 → 19.173.2-alpha.258

package/dist/index.d.mts

@@ -193,7 +193,7 @@ interface paths {
                     id?: string;
                     /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                     path?: string;
-                    /** Composition id to find associated sitemap nodes for */
+                    /** Composition id to find associated project map node for */
                     compositionId?: string;
                     /** Limit the number or records returned by a number */
                     limit?: number;
@@ -412,18 +412,27 @@ interface components {
              */
             id?: string;
         }[];
-        /** @description Basic information about a composition from the context of a project map node */
+        /**
+         * @description Basic information about the linked composition from the context of a project map node.
+         * If the linked composition has editions, the editions are included in the `editions` property.
+         */
         ProjectMapNodeCompositionData: {
-            /** @description Type of the composition instance (public_id of its definition) */
+            /** @description Type of the linked composition (id of its definition) */
             type: string;
             /**
              * Format: uuid
-             * @description The public UUID of the composition
+             * @description The UUID of the linked composition
              */
             id: string;
-            /** @description Slug pattern of this composition */
+            /**
+             * Format: uuid
+             * @description The edition UUID underneath the linked composition
+             * This is only present if the composition has not been published, but an edition has
+             */
+            editionId?: string;
+            /** @description Slug pattern of the linked composition or edition */
             slug?: string | null;
-            /** @description Friendly name of this composition */
+            /** @description Friendly name of this composition or edition */
             name: string;
             /**
              * @deprecated
@@ -438,8 +447,67 @@ interface components {
             icon?: string;
             /** @description Friendly name of this Composition's Definition */
             typeName?: string;
-            /** @description List of locales that the composition is available in. If empty, available in all locales */
+            /**
+             * @description List of locales that the composition _or any of its editions_ is available in.
+             * If empty, available in all locales.
+             */
+            locales: string[];
+            /** @description Priority of the composition relative to any editions */
+            editionPriority?: number;
+            /** @description Friendly name of the edition */
+            editionName?: string;
+            /**
+             * @deprecated
+             * @description List of editions available for this composition. The composition is included in the list, it is the edition
+             * where the editionID equals the node's compositionID.
+             */
+            editions?: components["schemas"]["ProjectMapNodeCompositionEditionData"][];
+        };
+        /**
+         * @deprecated
+         * @description Basic information about a composition edition from the context of a project map node
+         */
+        ProjectMapNodeCompositionEditionData: {
+            /**
+             * Format: uuid
+             * @description The UUID of the linked composition
+             */
+            id: string;
+            /** @description Type of the edition instance (public_id of its definition) */
+            type: string;
+            /**
+             * Format: uuid
+             * @description The edition UUID underneath the linked composition
+             */
+            editionId?: string;
+            /** @description Slug pattern of this edition */
+            slug?: string | null;
+            /** @description Friendly name of the linked composition */
+            name: string;
+            /** @description Friendly name of the edition */
+            editionName?: string;
+            /** @description Priority of the edition */
+            editionPriority?: number;
+            /**
+             * @deprecated
+             * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+             * @enum {string}
+             */
+            uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+            /**
+             * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+             * @default screen
+             */
+            icon?: string;
+            /** @description Friendly name of this edition's definition */
+            typeName?: string;
+            /** @description List of locales that the edition is available in. If empty, available in all locales */
             locales: string[];
+            /**
+             * Format: date-time
+             * @description Date and time the composition was last modified (or created if never modified). Uses ISO-8859-1 formatting and UTC timezone.
+             */
+            modified?: string;
         };
         ProjectMapNodeUpdate: {
             /**
@@ -566,6 +634,8 @@ type ProjectMapNodeGetResponse = paths['/api/v1/project-map-nodes']['get']['resp
 type ProjectMapNode = NonNullable<ProjectMapNodeGetResponse['nodes']>[0];
 type ProjectMapNodeLocale = NonNullable<ProjectMapNode['locales']>[string];
 type ProjectMapNodeWithId = ProjectMapNode & Required<Pick<ProjectMapNode, 'id' | 'name'>>;
+type ProjectMapNodeCompositionData = NonNullable<ProjectMapNode['compositionData']>;
+type ProjectMapNodeCompositionEditionData = NonNullable<NonNullable<ProjectMapNode['compositionData']>['editions']>[0];
 type ProjectMapGetRequest = paths$1['/api/v1/project-map']['get']['parameters']['query'];
 type ProjectMapGetResponse = paths$1['/api/v1/project-map']['get']['responses']['200']['content']['application/json'];
 type ProjectMapUpsertRequest = paths$1['/api/v1/project-map']['put']['requestBody']['content']['application/json'];
@@ -614,25 +684,13 @@ declare class ProjectMapClient extends ApiClient<ProjectMapClientOptions> {
      * Get available project map defintions
      */
     getProjectMapDefinitions: () => Promise<{
-        projectMaps: {
-            id?: string | undefined;
-            name: string;
-            description?: string | undefined;
-            baseUrl?: string | undefined;
-            default?: boolean | undefined;
-        }[];
+        projectMaps: components$1["schemas"]["ProjectMapDefinition"][];
     }>;
     /**
      * Get specific project map definition
      */
     getProjectMapDefinition: (options: WithoutProjectId<ProjectMapGetRequest>) => Promise<{
-        projectMaps: {
-            id?: string | undefined;
-            name: string;
-            description?: string | undefined;
-            baseUrl?: string | undefined;
-            default?: boolean | undefined;
-        }[];
+        projectMaps: components$1["schemas"]["ProjectMapDefinition"][];
     }>;
     /**
      * Update or insert a project map definition
@@ -664,6 +722,61 @@ declare class ProjectMapClient extends ApiClient<ProjectMapClientOptions> {
 declare class UncachedProjectMapClient extends ProjectMapClient {
     constructor(options: Omit<ProjectMapClientOptions, 'bypassCache'>);
 }
+/**
+ * Internal use only.
+ *
+ * @deprecated
+ */
+declare const __INTERNAL_MISSING_PARENT_NODE_ERROR = "Upsert failed, parent node not found.";
+
+interface ObjectWithEditionMetadata {
+    editionId?: string;
+    editionPriority?: number;
+    editionName?: string;
+}
+/**
+ * @deprecated pre-release functionality subject to change
+ */
+interface GetActiveEditionOptions<T> {
+    /** Node to pick the active edition for */
+    editions: Array<T>;
+    /** Selects the composition/entry ID from the edition */
+    selectId: (edition: T) => string;
+    /** Selects locales that are enabled on an edition */
+    selectEnabledLocales: (edition: T) => string[];
+    selectEdition: (edition: T) => ObjectWithEditionMetadata;
+    /**
+     * The current locale to resolve an edition for.
+     * When undefined, the default edition/composition is always matched if it exists.
+     */
+    targetLocale: string | undefined;
+}
+/**
+ * Finds the active edition for a given locale in an array of all editions.
+ * The active edition is the highest priority edition that enables the target locale.
+ * If there is no target locale, then the default edition is returned if there is one.
+ * Otherwise, undefined is returned (no edition matches).
+ * @deprecated pre-release functionality subject to change
+ */
+declare function getActiveEdition<T>({ editions, selectEdition, selectId, selectEnabledLocales, targetLocale, }: GetActiveEditionOptions<T>): T | undefined;
+
+/**
+ * Finds the active edition for a given locale in a node's compositionData.
+ * Note: All editions, including the composition, are stored in the editions array when it is present.
+ * @deprecated pre-release functionality subject to change
+ */
+declare function getNodeActiveCompositionEdition({ node, targetLocale, fallbackWhenLocaleNotMatched, }: {
+    /** Node to pick the active edition for */
+    node: Pick<ProjectMapNode, 'compositionData'>;
+    /** The current locale to resolve an edition for. When undefined, the compositionData is always matched. */
+    targetLocale: string | undefined;
+    /**
+     * Whether to fallback to the composition if nothing enables the target locale
+     * false (default): return undefined if nothing enables the target locale
+     * true: return the composition if nothing enables the target locale
+     */
+    fallbackWhenLocaleNotMatched?: boolean;
+}): ProjectMapNode['compositionData'] | undefined;
 
 type LocalePathNode = Pick<ProjectMapNode, 'path'> & {
     locales?: Record<string, {
@@ -729,4 +842,4 @@ declare class Route {
     static dynamicSegmentPrefix: string;
 }
 
-export { type AlternateLocaleUrls, type ExpandOptions, type LocalePathNode, type MatchedRoute, type NodeType, ProjectMapClient, type ProjectMapClientOptions, type ProjectMapDefinition, type ProjectMapDefinitionWithId, type ProjectMapDefinitions, type ProjectMapDeleteRequest, type ProjectMapGetRequest, type ProjectMapGetResponse, type ProjectMapNode, type ProjectMapNodeAllowedQueryString, type ProjectMapNodeData, type ProjectMapNodeDeleteRequest, type ProjectMapNodeGetRequest, type ProjectMapNodeGetResponse, type ProjectMapNodeLocale, type ProjectMapNodeUpsertRequest, type ProjectMapNodeUpsertRequestNode, type ProjectMapNodeUpsertRequestNodeLocale, type ProjectMapNodeWithId, type ProjectMapNodeWithProjectMapReference, type ProjectMapSubtree, type ProjectMapUpsertRequest, type ProjectMapUpsertResponse, ROOT_NODE_PATH, Route, UncachedProjectMapClient, type UnmatchedRoute, getNodeLocalePath, getRouteAlternateLocalesUrls };
+export { type AlternateLocaleUrls, type ExpandOptions, type GetActiveEditionOptions, type LocalePathNode, type MatchedRoute, type NodeType, type ObjectWithEditionMetadata, ProjectMapClient, type ProjectMapClientOptions, type ProjectMapDefinition, type ProjectMapDefinitionWithId, type ProjectMapDefinitions, type ProjectMapDeleteRequest, type ProjectMapGetRequest, type ProjectMapGetResponse, type ProjectMapNode, type ProjectMapNodeAllowedQueryString, type ProjectMapNodeCompositionData, type ProjectMapNodeCompositionEditionData, type ProjectMapNodeData, type ProjectMapNodeDeleteRequest, type ProjectMapNodeGetRequest, type ProjectMapNodeGetResponse, type ProjectMapNodeLocale, type ProjectMapNodeUpsertRequest, type ProjectMapNodeUpsertRequestNode, type ProjectMapNodeUpsertRequestNodeLocale, type ProjectMapNodeWithId, type ProjectMapNodeWithProjectMapReference, type ProjectMapSubtree, type ProjectMapUpsertRequest, type ProjectMapUpsertResponse, ROOT_NODE_PATH, Route, UncachedProjectMapClient, type UnmatchedRoute, __INTERNAL_MISSING_PARENT_NODE_ERROR, getActiveEdition, getNodeActiveCompositionEdition, getNodeLocalePath, getRouteAlternateLocalesUrls };

package/dist/index.d.ts

@@ -193,7 +193,7 @@ interface paths {
                     id?: string;
                     /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                     path?: string;
-                    /** Composition id to find associated sitemap nodes for */
+                    /** Composition id to find associated project map node for */
                     compositionId?: string;
                     /** Limit the number or records returned by a number */
                     limit?: number;
@@ -412,18 +412,27 @@ interface components {
              */
             id?: string;
         }[];
-        /** @description Basic information about a composition from the context of a project map node */
+        /**
+         * @description Basic information about the linked composition from the context of a project map node.
+         * If the linked composition has editions, the editions are included in the `editions` property.
+         */
         ProjectMapNodeCompositionData: {
-            /** @description Type of the composition instance (public_id of its definition) */
+            /** @description Type of the linked composition (id of its definition) */
             type: string;
             /**
              * Format: uuid
-             * @description The public UUID of the composition
+             * @description The UUID of the linked composition
              */
             id: string;
-            /** @description Slug pattern of this composition */
+            /**
+             * Format: uuid
+             * @description The edition UUID underneath the linked composition
+             * This is only present if the composition has not been published, but an edition has
+             */
+            editionId?: string;
+            /** @description Slug pattern of the linked composition or edition */
             slug?: string | null;
-            /** @description Friendly name of this composition */
+            /** @description Friendly name of this composition or edition */
             name: string;
             /**
              * @deprecated
@@ -438,8 +447,67 @@ interface components {
             icon?: string;
             /** @description Friendly name of this Composition's Definition */
             typeName?: string;
-            /** @description List of locales that the composition is available in. If empty, available in all locales */
+            /**
+             * @description List of locales that the composition _or any of its editions_ is available in.
+             * If empty, available in all locales.
+             */
+            locales: string[];
+            /** @description Priority of the composition relative to any editions */
+            editionPriority?: number;
+            /** @description Friendly name of the edition */
+            editionName?: string;
+            /**
+             * @deprecated
+             * @description List of editions available for this composition. The composition is included in the list, it is the edition
+             * where the editionID equals the node's compositionID.
+             */
+            editions?: components["schemas"]["ProjectMapNodeCompositionEditionData"][];
+        };
+        /**
+         * @deprecated
+         * @description Basic information about a composition edition from the context of a project map node
+         */
+        ProjectMapNodeCompositionEditionData: {
+            /**
+             * Format: uuid
+             * @description The UUID of the linked composition
+             */
+            id: string;
+            /** @description Type of the edition instance (public_id of its definition) */
+            type: string;
+            /**
+             * Format: uuid
+             * @description The edition UUID underneath the linked composition
+             */
+            editionId?: string;
+            /** @description Slug pattern of this edition */
+            slug?: string | null;
+            /** @description Friendly name of the linked composition */
+            name: string;
+            /** @description Friendly name of the edition */
+            editionName?: string;
+            /** @description Priority of the edition */
+            editionPriority?: number;
+            /**
+             * @deprecated
+             * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+             * @enum {string}
+             */
+            uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+            /**
+             * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+             * @default screen
+             */
+            icon?: string;
+            /** @description Friendly name of this edition's definition */
+            typeName?: string;
+            /** @description List of locales that the edition is available in. If empty, available in all locales */
             locales: string[];
+            /**
+             * Format: date-time
+             * @description Date and time the composition was last modified (or created if never modified). Uses ISO-8859-1 formatting and UTC timezone.
+             */
+            modified?: string;
         };
         ProjectMapNodeUpdate: {
             /**
@@ -566,6 +634,8 @@ type ProjectMapNodeGetResponse = paths['/api/v1/project-map-nodes']['get']['resp
 type ProjectMapNode = NonNullable<ProjectMapNodeGetResponse['nodes']>[0];
 type ProjectMapNodeLocale = NonNullable<ProjectMapNode['locales']>[string];
 type ProjectMapNodeWithId = ProjectMapNode & Required<Pick<ProjectMapNode, 'id' | 'name'>>;
+type ProjectMapNodeCompositionData = NonNullable<ProjectMapNode['compositionData']>;
+type ProjectMapNodeCompositionEditionData = NonNullable<NonNullable<ProjectMapNode['compositionData']>['editions']>[0];
 type ProjectMapGetRequest = paths$1['/api/v1/project-map']['get']['parameters']['query'];
 type ProjectMapGetResponse = paths$1['/api/v1/project-map']['get']['responses']['200']['content']['application/json'];
 type ProjectMapUpsertRequest = paths$1['/api/v1/project-map']['put']['requestBody']['content']['application/json'];
@@ -614,25 +684,13 @@ declare class ProjectMapClient extends ApiClient<ProjectMapClientOptions> {
      * Get available project map defintions
      */
     getProjectMapDefinitions: () => Promise<{
-        projectMaps: {
-            id?: string | undefined;
-            name: string;
-            description?: string | undefined;
-            baseUrl?: string | undefined;
-            default?: boolean | undefined;
-        }[];
+        projectMaps: components$1["schemas"]["ProjectMapDefinition"][];
     }>;
     /**
      * Get specific project map definition
      */
     getProjectMapDefinition: (options: WithoutProjectId<ProjectMapGetRequest>) => Promise<{
-        projectMaps: {
-            id?: string | undefined;
-            name: string;
-            description?: string | undefined;
-            baseUrl?: string | undefined;
-            default?: boolean | undefined;
-        }[];
+        projectMaps: components$1["schemas"]["ProjectMapDefinition"][];
     }>;
     /**
      * Update or insert a project map definition
@@ -664,6 +722,61 @@ declare class ProjectMapClient extends ApiClient<ProjectMapClientOptions> {
 declare class UncachedProjectMapClient extends ProjectMapClient {
     constructor(options: Omit<ProjectMapClientOptions, 'bypassCache'>);
 }
+/**
+ * Internal use only.
+ *
+ * @deprecated
+ */
+declare const __INTERNAL_MISSING_PARENT_NODE_ERROR = "Upsert failed, parent node not found.";
+
+interface ObjectWithEditionMetadata {
+    editionId?: string;
+    editionPriority?: number;
+    editionName?: string;
+}
+/**
+ * @deprecated pre-release functionality subject to change
+ */
+interface GetActiveEditionOptions<T> {
+    /** Node to pick the active edition for */
+    editions: Array<T>;
+    /** Selects the composition/entry ID from the edition */
+    selectId: (edition: T) => string;
+    /** Selects locales that are enabled on an edition */
+    selectEnabledLocales: (edition: T) => string[];
+    selectEdition: (edition: T) => ObjectWithEditionMetadata;
+    /**
+     * The current locale to resolve an edition for.
+     * When undefined, the default edition/composition is always matched if it exists.
+     */
+    targetLocale: string | undefined;
+}
+/**
+ * Finds the active edition for a given locale in an array of all editions.
+ * The active edition is the highest priority edition that enables the target locale.
+ * If there is no target locale, then the default edition is returned if there is one.
+ * Otherwise, undefined is returned (no edition matches).
+ * @deprecated pre-release functionality subject to change
+ */
+declare function getActiveEdition<T>({ editions, selectEdition, selectId, selectEnabledLocales, targetLocale, }: GetActiveEditionOptions<T>): T | undefined;
+
+/**
+ * Finds the active edition for a given locale in a node's compositionData.
+ * Note: All editions, including the composition, are stored in the editions array when it is present.
+ * @deprecated pre-release functionality subject to change
+ */
+declare function getNodeActiveCompositionEdition({ node, targetLocale, fallbackWhenLocaleNotMatched, }: {
+    /** Node to pick the active edition for */
+    node: Pick<ProjectMapNode, 'compositionData'>;
+    /** The current locale to resolve an edition for. When undefined, the compositionData is always matched. */
+    targetLocale: string | undefined;
+    /**
+     * Whether to fallback to the composition if nothing enables the target locale
+     * false (default): return undefined if nothing enables the target locale
+     * true: return the composition if nothing enables the target locale
+     */
+    fallbackWhenLocaleNotMatched?: boolean;
+}): ProjectMapNode['compositionData'] | undefined;
 
 type LocalePathNode = Pick<ProjectMapNode, 'path'> & {
     locales?: Record<string, {
@@ -729,4 +842,4 @@ declare class Route {
     static dynamicSegmentPrefix: string;
 }
 
-export { type AlternateLocaleUrls, type ExpandOptions, type LocalePathNode, type MatchedRoute, type NodeType, ProjectMapClient, type ProjectMapClientOptions, type ProjectMapDefinition, type ProjectMapDefinitionWithId, type ProjectMapDefinitions, type ProjectMapDeleteRequest, type ProjectMapGetRequest, type ProjectMapGetResponse, type ProjectMapNode, type ProjectMapNodeAllowedQueryString, type ProjectMapNodeData, type ProjectMapNodeDeleteRequest, type ProjectMapNodeGetRequest, type ProjectMapNodeGetResponse, type ProjectMapNodeLocale, type ProjectMapNodeUpsertRequest, type ProjectMapNodeUpsertRequestNode, type ProjectMapNodeUpsertRequestNodeLocale, type ProjectMapNodeWithId, type ProjectMapNodeWithProjectMapReference, type ProjectMapSubtree, type ProjectMapUpsertRequest, type ProjectMapUpsertResponse, ROOT_NODE_PATH, Route, UncachedProjectMapClient, type UnmatchedRoute, getNodeLocalePath, getRouteAlternateLocalesUrls };
+export { type AlternateLocaleUrls, type ExpandOptions, type GetActiveEditionOptions, type LocalePathNode, type MatchedRoute, type NodeType, type ObjectWithEditionMetadata, ProjectMapClient, type ProjectMapClientOptions, type ProjectMapDefinition, type ProjectMapDefinitionWithId, type ProjectMapDefinitions, type ProjectMapDeleteRequest, type ProjectMapGetRequest, type ProjectMapGetResponse, type ProjectMapNode, type ProjectMapNodeAllowedQueryString, type ProjectMapNodeCompositionData, type ProjectMapNodeCompositionEditionData, type ProjectMapNodeData, type ProjectMapNodeDeleteRequest, type ProjectMapNodeGetRequest, type ProjectMapNodeGetResponse, type ProjectMapNodeLocale, type ProjectMapNodeUpsertRequest, type ProjectMapNodeUpsertRequestNode, type ProjectMapNodeUpsertRequestNodeLocale, type ProjectMapNodeWithId, type ProjectMapNodeWithProjectMapReference, type ProjectMapSubtree, type ProjectMapUpsertRequest, type ProjectMapUpsertResponse, ROOT_NODE_PATH, Route, UncachedProjectMapClient, type UnmatchedRoute, __INTERNAL_MISSING_PARENT_NODE_ERROR, getActiveEdition, getNodeActiveCompositionEdition, getNodeLocalePath, getRouteAlternateLocalesUrls };

package/dist/index.esm.js

@@ -178,6 +178,72 @@ var cutReferences = (node) => node ? {
   parent: void 0,
   children: void 0
 } : void 0;
+var __INTERNAL_MISSING_PARENT_NODE_ERROR = "Upsert failed, parent node not found.";
+
+// src/util/getActiveEdition.ts
+function getActiveEdition({
+  editions,
+  selectEdition,
+  selectId,
+  selectEnabledLocales,
+  targetLocale
+}) {
+  if (!editions || !editions.length) {
+    return void 0;
+  }
+  if (!targetLocale) {
+    return editions.find((t) => {
+      const edition = selectEdition(t);
+      return !edition.editionId || edition.editionId === selectId(t);
+    });
+  }
+  let activeT = void 0;
+  editions.forEach((t) => {
+    var _a, _b, _c, _d;
+    const edition = selectEdition(t);
+    const activeEdition = activeT ? selectEdition(activeT) : void 0;
+    const editionPriority = (_a = edition.editionPriority) != null ? _a : 0;
+    const activeEditionPriority = (_b = activeEdition == null ? void 0 : activeEdition.editionPriority) != null ? _b : Number.MIN_SAFE_INTEGER;
+    if (selectEnabledLocales(t).includes(targetLocale) && (editionPriority > activeEditionPriority || editionPriority === activeEditionPriority && ((_c = edition.editionName) != null ? _c : "").localeCompare((_d = activeEdition == null ? void 0 : activeEdition.editionName) != null ? _d : "", "en", {
+      sensitivity: "base"
+    }) < 0)) {
+      activeT = t;
+    }
+  });
+  return activeT;
+}
+
+// src/util/getNodeActiveCompositionEdition.ts
+function getNodeActiveCompositionEdition({
+  node,
+  targetLocale,
+  fallbackWhenLocaleNotMatched = false
+}) {
+  var _a;
+  if (!node.compositionData) {
+    return void 0;
+  }
+  if (!targetLocale) {
+    return node.compositionData;
+  }
+  const activeEdition = getActiveEdition({
+    editions: (_a = node.compositionData.editions) != null ? _a : [],
+    selectId: (edition) => {
+      var _a2;
+      return (_a2 = edition.editionId) != null ? _a2 : "";
+    },
+    selectEnabledLocales: (edition) => edition.locales,
+    selectEdition: (edition) => edition,
+    targetLocale
+  });
+  if (!node.compositionData.editions && node.compositionData.locales.includes(targetLocale)) {
+    return node.compositionData;
+  }
+  if (fallbackWhenLocaleNotMatched && !activeEdition) {
+    return node.compositionData;
+  }
+  return activeEdition;
+}
 
 // src/util/getNodeLocalePath.ts
 function getNodeLocalePath(node, locale) {
@@ -341,6 +407,9 @@ export {
   ROOT_NODE_PATH,
   Route,
   UncachedProjectMapClient,
+  __INTERNAL_MISSING_PARENT_NODE_ERROR,
+  getActiveEdition,
+  getNodeActiveCompositionEdition,
   getNodeLocalePath,
   getRouteAlternateLocalesUrls
 };

package/dist/index.js

@@ -32,6 +32,9 @@ __export(src_exports, {
   ROOT_NODE_PATH: () => ROOT_NODE_PATH,
   Route: () => Route,
   UncachedProjectMapClient: () => UncachedProjectMapClient,
+  __INTERNAL_MISSING_PARENT_NODE_ERROR: () => __INTERNAL_MISSING_PARENT_NODE_ERROR,
+  getActiveEdition: () => getActiveEdition,
+  getNodeActiveCompositionEdition: () => getNodeActiveCompositionEdition,
   getNodeLocalePath: () => getNodeLocalePath,
   getRouteAlternateLocalesUrls: () => getRouteAlternateLocalesUrls
 });
@@ -208,6 +211,72 @@ var cutReferences = (node) => node ? {
   parent: void 0,
   children: void 0
 } : void 0;
+var __INTERNAL_MISSING_PARENT_NODE_ERROR = "Upsert failed, parent node not found.";
+
+// src/util/getActiveEdition.ts
+function getActiveEdition({
+  editions,
+  selectEdition,
+  selectId,
+  selectEnabledLocales,
+  targetLocale
+}) {
+  if (!editions || !editions.length) {
+    return void 0;
+  }
+  if (!targetLocale) {
+    return editions.find((t) => {
+      const edition = selectEdition(t);
+      return !edition.editionId || edition.editionId === selectId(t);
+    });
+  }
+  let activeT = void 0;
+  editions.forEach((t) => {
+    var _a, _b, _c, _d;
+    const edition = selectEdition(t);
+    const activeEdition = activeT ? selectEdition(activeT) : void 0;
+    const editionPriority = (_a = edition.editionPriority) != null ? _a : 0;
+    const activeEditionPriority = (_b = activeEdition == null ? void 0 : activeEdition.editionPriority) != null ? _b : Number.MIN_SAFE_INTEGER;
+    if (selectEnabledLocales(t).includes(targetLocale) && (editionPriority > activeEditionPriority || editionPriority === activeEditionPriority && ((_c = edition.editionName) != null ? _c : "").localeCompare((_d = activeEdition == null ? void 0 : activeEdition.editionName) != null ? _d : "", "en", {
+      sensitivity: "base"
+    }) < 0)) {
+      activeT = t;
+    }
+  });
+  return activeT;
+}
+
+// src/util/getNodeActiveCompositionEdition.ts
+function getNodeActiveCompositionEdition({
+  node,
+  targetLocale,
+  fallbackWhenLocaleNotMatched = false
+}) {
+  var _a;
+  if (!node.compositionData) {
+    return void 0;
+  }
+  if (!targetLocale) {
+    return node.compositionData;
+  }
+  const activeEdition = getActiveEdition({
+    editions: (_a = node.compositionData.editions) != null ? _a : [],
+    selectId: (edition) => {
+      var _a2;
+      return (_a2 = edition.editionId) != null ? _a2 : "";
+    },
+    selectEnabledLocales: (edition) => edition.locales,
+    selectEdition: (edition) => edition,
+    targetLocale
+  });
+  if (!node.compositionData.editions && node.compositionData.locales.includes(targetLocale)) {
+    return node.compositionData;
+  }
+  if (fallbackWhenLocaleNotMatched && !activeEdition) {
+    return node.compositionData;
+  }
+  return activeEdition;
+}
 
 // src/util/getNodeLocalePath.ts
 function getNodeLocalePath(node, locale) {
@@ -372,6 +441,9 @@ function getRouteAlternateLocalesUrls(routeResponse) {
   ROOT_NODE_PATH,
   Route,
   UncachedProjectMapClient,
+  __INTERNAL_MISSING_PARENT_NODE_ERROR,
+  getActiveEdition,
+  getNodeActiveCompositionEdition,
   getNodeLocalePath,
   getRouteAlternateLocalesUrls
 });

package/dist/index.mjs

@@ -178,6 +178,72 @@ var cutReferences = (node) => node ? {
   parent: void 0,
   children: void 0
 } : void 0;
+var __INTERNAL_MISSING_PARENT_NODE_ERROR = "Upsert failed, parent node not found.";
+
+// src/util/getActiveEdition.ts
+function getActiveEdition({
+  editions,
+  selectEdition,
+  selectId,
+  selectEnabledLocales,
+  targetLocale
+}) {
+  if (!editions || !editions.length) {
+    return void 0;
+  }
+  if (!targetLocale) {
+    return editions.find((t) => {
+      const edition = selectEdition(t);
+      return !edition.editionId || edition.editionId === selectId(t);
+    });
+  }
+  let activeT = void 0;
+  editions.forEach((t) => {
+    var _a, _b, _c, _d;
+    const edition = selectEdition(t);
+    const activeEdition = activeT ? selectEdition(activeT) : void 0;
+    const editionPriority = (_a = edition.editionPriority) != null ? _a : 0;
+    const activeEditionPriority = (_b = activeEdition == null ? void 0 : activeEdition.editionPriority) != null ? _b : Number.MIN_SAFE_INTEGER;
+    if (selectEnabledLocales(t).includes(targetLocale) && (editionPriority > activeEditionPriority || editionPriority === activeEditionPriority && ((_c = edition.editionName) != null ? _c : "").localeCompare((_d = activeEdition == null ? void 0 : activeEdition.editionName) != null ? _d : "", "en", {
+      sensitivity: "base"
+    }) < 0)) {
+      activeT = t;
+    }
+  });
+  return activeT;
+}
+
+// src/util/getNodeActiveCompositionEdition.ts
+function getNodeActiveCompositionEdition({
+  node,
+  targetLocale,
+  fallbackWhenLocaleNotMatched = false
+}) {
+  var _a;
+  if (!node.compositionData) {
+    return void 0;
+  }
+  if (!targetLocale) {
+    return node.compositionData;
+  }
+  const activeEdition = getActiveEdition({
+    editions: (_a = node.compositionData.editions) != null ? _a : [],
+    selectId: (edition) => {
+      var _a2;
+      return (_a2 = edition.editionId) != null ? _a2 : "";
+    },
+    selectEnabledLocales: (edition) => edition.locales,
+    selectEdition: (edition) => edition,
+    targetLocale
+  });
+  if (!node.compositionData.editions && node.compositionData.locales.includes(targetLocale)) {
+    return node.compositionData;
+  }
+  if (fallbackWhenLocaleNotMatched && !activeEdition) {
+    return node.compositionData;
+  }
+  return activeEdition;
+}
 
 // src/util/getNodeLocalePath.ts
 function getNodeLocalePath(node, locale) {
@@ -341,6 +407,9 @@ export {
   ROOT_NODE_PATH,
   Route,
   UncachedProjectMapClient,
+  __INTERNAL_MISSING_PARENT_NODE_ERROR,
+  getActiveEdition,
+  getNodeActiveCompositionEdition,
   getNodeLocalePath,
   getRouteAlternateLocalesUrls
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/project-map",
-  "version": "19.173.1-alpha.17+25c1176cea",
+  "version": "19.173.2-alpha.258+e8775b83de",
   "description": "Uniform Project Map",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -23,7 +23,7 @@
     "dev": "run-s update-openapi dev:ts",
     "dev:ts": "tsup --watch",
     "clean": "rimraf dist",
-    "test": "jest --maxWorkers=1 --passWithNoTests",
+    "test": "jest --passWithNoTests",
     "lint": "eslint \"src/**/*.{js,ts,tsx}\"",
     "format": "prettier --write \"src/**/*.{js,ts,tsx}\"",
     "update-openapi": "tsx ./scripts/update-openapi.cts",
@@ -33,11 +33,11 @@
     "/dist"
   ],
   "dependencies": {
-    "@uniformdev/canvas": "19.173.1-alpha.17+25c1176cea",
-    "@uniformdev/context": "19.173.1-alpha.17+25c1176cea"
+    "@uniformdev/canvas": "19.173.2-alpha.258+e8775b83de",
+    "@uniformdev/context": "19.173.2-alpha.258+e8775b83de"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "25c1176cea8d5114b92fc75cdd8bba4aa6463a50"
+  "gitHead": "e8775b83dec606ce6e2198182152d8b386e15f94"
 }