@ama-mfe/messages 14.3.0-prerelease.9 → 14.3.0-rc.3

package/README.md

@@ -15,3 +15,14 @@ The message interfaces exposed in this package cover common use cases such as:
 - [Theme](https://github.com/AmadeusITGroup/otter/blob/main/packages/%40ama-mfe/ng-utils/src/theme/: a host application requests its embedded module to apply a common css theme. 
 
 Messages are identified thanks to their type property and are versioned for backward compatibility.
+
+## Navigation messages
+### v1.0
+Carries the target `url` only.
+
+### v1.1
+Adds an optional `extras` field to forward a subset of Angular `NavigationExtras` across the iframe boundary so the
+receiving router can reproduce the original history/location semantics. Currently supports:
+- `replaceUrl`: when set, the host navigates by replacing the current history entry instead of pushing a new one. This is
+  the key fix for modules that call `router.navigate(..., { replaceUrl: true })` to skip a route from history — without
+  forwarding, the host still pushes a new entry and the browser back button gets stuck in a loop.

package/cjs/messages/core.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});

package/cjs/messages/navigation/base.js

@@ -1,4 +1,4 @@
-/** The navigation message type used at communication with iframes */ "use strict";
+"use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true
 });

package/cjs/public_api.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
+_export_star(require("./messages/core"), exports);
 _export_star(require("./messages/history/index"), exports);
 _export_star(require("./messages/navigation/index"), exports);
 _export_star(require("./messages/resize/index"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ama-mfe/messages",
-  "version": "14.3.0-prerelease.9",
+  "version": "14.3.0-rc.3",
   "publishConfig": {
     "access": "public"
   },
@@ -43,18 +43,18 @@
     "@amadeus-it-group/microfrontends": "0.0.10",
     "@compodoc/compodoc": "^1.1.32",
     "@eslint-community/eslint-plugin-eslint-comments": "^4.4.0",
-    "@nx/eslint-plugin": "~22.6.0",
-    "@nx/jest": "~22.6.0",
-    "@o3r/build-helpers": "~14.3.0-prerelease.9",
-    "@o3r/eslint-plugin": "~14.3.0-prerelease.9",
-    "@o3r/test-helpers": "~14.3.0-prerelease.9",
+    "@nx/eslint-plugin": "~22.7.0",
+    "@nx/jest": "~22.7.0",
+    "@o3r/build-helpers": "~14.3.0-rc.3",
+    "@o3r/eslint-plugin": "~14.3.0-rc.3",
+    "@o3r/test-helpers": "~14.3.0-rc.3",
     "@schematics/angular": "~21.2.0",
     "@stylistic/eslint-plugin": "~5.10.0",
     "@swc/cli": "~0.8.0",
     "@swc/core": "~1.15.17",
     "@types/jest": "~30.0.0",
     "@types/node": "~24.12.0",
-    "@typescript-eslint/parser": "~8.57.0",
+    "@typescript-eslint/parser": "~8.58.0",
     "cpy-cli": "^6.0.0",
     "eslint": "~9.39.0",
     "eslint-import-resolver-node": "~0.3.9",
@@ -77,7 +77,7 @@
     "ts-jest": "~29.4.0",
     "type-fest": "^5.3.1",
     "typescript": "~5.9.2",
-    "typescript-eslint": "~8.57.0"
+    "typescript-eslint": "~8.58.0"
   },
   "engines": {
     "node": "^22.17.0 || ^24.0.0"

package/src/messages/core.d.ts

@@ -0,0 +1,9 @@
+import type { VersionedMessage } from '@amadeus-it-group/microfrontends';
+/** Base structure for all versioned messages in the communication protocol. */
+export interface StrictTypedVersionedMessage<V extends string, T extends string> extends VersionedMessage {
+    /** @inheritdoc */
+    version: V;
+    /** @inheritdoc */
+    type: T;
+}
+//# sourceMappingURL=core.d.ts.map

package/src/messages/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/messages/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EACjB,MAAM,kCAAkC,CAAC;AAE1C,+EAA+E;AAC/E,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAE,SAAQ,gBAAgB;IACvG,kBAAkB;IAClB,OAAO,EAAE,CAAC,CAAC;IACX,kBAAkB;IAClB,IAAI,EAAE,CAAC,CAAC;CACT"}

package/src/messages/core.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=core.js.map

package/src/messages/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/messages/core.ts"],"names":[],"mappings":""}

package/src/messages/navigation/base.d.ts

@@ -1,3 +1,7 @@
+import type { StrictTypedVersionedMessage } from '../core';
 /** The navigation message type used at communication with iframes */
 export declare const NAVIGATION_MESSAGE_TYPE = "navigation";
+/** Versioned navigation message */
+export interface VersionedNavigationMessage<V extends string> extends StrictTypedVersionedMessage<V, typeof NAVIGATION_MESSAGE_TYPE> {
+}
 //# sourceMappingURL=base.d.ts.map

package/src/messages/navigation/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/messages/navigation/base.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,eAAe,CAAC"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/messages/navigation/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAEjB,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAEpD,mCAAmC;AACnC,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,2BAA2B,CAAC,CAAC,EAAE,OAAO,uBAAuB,CAAC;CAAG"}

package/src/messages/navigation/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/messages/navigation/base.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CAAC"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/messages/navigation/base.ts"],"names":[],"mappings":"AAIA,qEAAqE;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CAAC"}

package/src/messages/navigation/index.d.ts

@@ -1,6 +1,6 @@
-import type { NavigationV1_0 } from './navigation-versions';
+import type { NavigationV1_0, NavigationV1_1 } from './navigation-versions';
 export * from './navigation-versions';
 export { NAVIGATION_MESSAGE_TYPE } from './base';
 /** The versions of navigation messages */
-export type NavigationMessage = NavigationV1_0;
+export type NavigationMessage = NavigationV1_0 | NavigationV1_1;
 //# sourceMappingURL=index.d.ts.map

package/src/messages/navigation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/messages/navigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACf,MAAM,uBAAuB,CAAC;AAE/B,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAEjD,0CAA0C;AAC1C,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/messages/navigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACf,MAAM,uBAAuB,CAAC;AAE/B,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAEjD,0CAA0C;AAC1C,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,cAAc,CAAC"}

package/src/messages/navigation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/messages/navigation/index.ts"],"names":[],"mappings":"AAIA,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/messages/navigation/index.ts"],"names":[],"mappings":"AAKA,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC"}

package/src/messages/navigation/navigation-versions.d.ts

@@ -1,16 +1,29 @@
-import type { VersionedMessage } from '@amadeus-it-group/microfrontends';
-import type { NAVIGATION_MESSAGE_TYPE } from './base';
+import type { VersionedNavigationMessage } from './base';
+/** Navigation content for version 1.0 */
+export interface NavigationContentV1_0 {
+    /** The url updated */
+    url: string;
+}
 /**
  * The navigation message object sent via the communication protocol.
  * Used in microfrontend architecture based on iframes where an iframe change its url and notify its parent with the url change
  * The parent should update its own url with the information received in order to allow the refresh and the deep link share
  */
-export interface NavigationV1_0 extends VersionedMessage {
-    /** @inheritdoc */
-    type: typeof NAVIGATION_MESSAGE_TYPE;
-    /** @inheritdoc */
-    version: '1.0';
-    /** The url updated */
-    url: string;
+export interface NavigationV1_0 extends NavigationContentV1_0, VersionedNavigationMessage<'1.0'> {
+}
+/** Navigation content for version 1.1 */
+export interface NavigationContentV1_1 extends NavigationContentV1_0 {
+    /** Subset of NavigationExtras forwarded across the iframe boundary. */
+    extras?: {
+        /** Navigate while replacing the current history entry instead of pushing a new one. */
+        replaceUrl?: boolean;
+    };
+}
+/**
+ * The navigation message object sent via the communication protocol.
+ * Carries a subset of NavigationExtras alongside the updated url so the receiving router
+ * can reproduce the original history/location semantics (e.g. skipping a route from history).
+ */
+export interface NavigationV1_1 extends NavigationContentV1_1, VersionedNavigationMessage<'1.1'> {
 }
 //# sourceMappingURL=navigation-versions.d.ts.map

package/src/messages/navigation/navigation-versions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-versions.d.ts","sourceRoot":"","sources":["../../../../src/messages/navigation/navigation-versions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EACjB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACV,uBAAuB,EACxB,MAAM,QAAQ,CAAC;AAEhB;;;;GAIG;AACH,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,kBAAkB;IAClB,IAAI,EAAE,OAAO,uBAAuB,CAAC;IACrC,kBAAkB;IAClB,OAAO,EAAE,KAAK,CAAC;IACf,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;CACb"}
+{"version":3,"file":"navigation-versions.d.ts","sourceRoot":"","sources":["../../../../src/messages/navigation/navigation-versions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC3B,MAAM,QAAQ,CAAC;AAEhB,yCAAyC;AACzC,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAe,SAAQ,qBAAqB,EAAE,0BAA0B,CAAC,KAAK,CAAC;CAAG;AAEnG,yCAAyC;AACzC,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,uEAAuE;IACvE,MAAM,CAAC,EAAE;QACP,uFAAuF;QACvF,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAe,SAAQ,qBAAqB,EAAE,0BAA0B,CAAC,KAAK,CAAC;CAAG"}

package/src/public_api.d.ts

@@ -1,3 +1,4 @@
+export * from './messages/core';
 export * from './messages/history/index';
 export * from './messages/navigation/index';
 export * from './messages/resize/index';

package/src/public_api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public_api.d.ts","sourceRoot":"","sources":["../../src/public_api.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"public_api.d.ts","sourceRoot":"","sources":["../../src/public_api.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC"}

package/src/public_api.js

@@ -1,3 +1,4 @@
+export * from './messages/core';
 export * from './messages/history/index';
 export * from './messages/navigation/index';
 export * from './messages/resize/index';

package/src/public_api.js.map

@@ -1 +1 @@
-{"version":3,"file":"public_api.js","sourceRoot":"","sources":["../../src/public_api.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"public_api.js","sourceRoot":"","sources":["../../src/public_api.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC"}