@africanies/angular-web-sdk 0.1.6 → 0.1.8

package/.nx/workspace-data/project-graph.json

@@ -826,7 +826,7 @@
           "targetGroups": {},
           "js": {
             "packageName": "@africanies/angular-web-sdk",
-            "packageVersion": "0.1.6",
+            "packageVersion": "0.1.8",
             "isInPackageManagerWorkspaces": true
           }
         },
@@ -17328,6 +17328,11 @@
         "target": "africanies-storage",
         "type": "static"
       },
+      {
+        "source": "africanies-theme",
+        "target": "africanies-models",
+        "type": "static"
+      },
       {
         "source": "africanies-theme",
         "target": "npm:jest-preset-angular",
@@ -42090,5 +42095,5 @@
   },
   "version": "6.0",
   "errors": [],
-  "computedAt": 1788420746319
+  "computedAt": 1788654115229
 }

package/apps/playground/src/app/pages/button-page.ts

@@ -48,7 +48,7 @@ import {
       <app-demo-section
         title="Variants"
         hint="Pick the visual weight for the action. Primary and ghost-primary are mode-colored — flip STN/SFN in the sidebar to see them change."
-        badge="7"
+        badge="8"
         [code]="variantsCode"
       >
         <div class="flex flex-wrap items-end gap-6">
@@ -113,7 +113,7 @@ import {
             <africanies-icon name="airplane" [size]="16" />
             Create shipment
           </button>
-          <button africanies-button type="button" variant="secondary">
+          <button africanies-button type="button" variant="flat">
             <africanies-icon name="adjust" [size]="16" />
             Filters
           </button>
@@ -216,7 +216,7 @@ import {
             <p class="m-0 text-caption text-neutral-600">Draft · Lagos → London</p>
           </div>
           <div class="flex flex-wrap gap-2">
-            <button africanies-button type="button" variant="ghost" size="sm">Cancel</button>
+            <button africanies-button type="button" variant="flat" size="sm">Cancel</button>
             <button africanies-button type="button" variant="secondary" size="sm">Save draft</button>
             <button africanies-button type="button" variant="primary" size="sm">Submit</button>
           </div>
@@ -229,6 +229,7 @@ export class ButtonPage {
   protected readonly variants: ButtonVariant[] = [
     'primary',
     'secondary',
+    'flat',
     'ghost',
     'ghost-primary',
     'ghost-danger',
@@ -239,6 +240,7 @@ export class ButtonPage {
   protected readonly labels: Record<ButtonVariant, string> = {
     primary: 'Save shipment',
     secondary: 'Save draft',
+    flat: 'Filters',
     ghost: 'Cancel',
     'ghost-primary': 'Add row',
     'ghost-danger': 'Remove',

package/apps/playground/src/app/pages/feedback-page.ts

@@ -230,7 +230,7 @@ const SUCCESS_ROWS: DemoShipment[] = [
               class="rounded-md px-3 py-1.5 text-body-sm transition-colors duration-150"
               [class]="
                 demo() === kind
-                  ? 'bg-white text-ink shadow-sm dark:bg-ink dark:text-white'
+                  ? 'bg-white text-ink shadow-sm dark:bg-ink-950 dark:text-white'
                   : 'text-neutral-600 hover:text-ink dark:text-neutral-400 dark:hover:text-white'
               "
               [attr.aria-selected]="demo() === kind"

package/apps/playground/src/app/pages/home-page.ts

@@ -94,7 +94,7 @@ interface CatalogCard {
           @for (card of cards; track card.path) {
             <a
               [routerLink]="card.path"
-              class="flex flex-col gap-4 rounded-xl border border-border bg-white p-5 no-underline transition-colors hover:border-neutral-400 dark:border-white/10 dark:bg-ink dark:hover:border-white/25"
+              class="flex flex-col gap-4 rounded-xl border border-border bg-white p-5 no-underline transition-colors hover:border-neutral-400 dark:border-white/10 dark:bg-ink-950 dark:hover:border-white/25"
             >
               <div class="flex items-center justify-between">
                 <span

package/apps/playground/src/app/pages/icons-page.ts

@@ -38,7 +38,7 @@ import { ICONS_USAGE } from '../snippets';
           @for (sample of samples; track sample) {
             <button
               type="button"
-              class="inline-flex items-center justify-center rounded-lg border border-border bg-white p-2.5 transition hover:border-neutral-400 dark:border-white/10 dark:bg-ink dark:hover:border-white/25"
+              class="inline-flex items-center justify-center rounded-lg border border-border bg-white p-2.5 transition hover:border-neutral-400 dark:border-white/10 dark:bg-ink-950 dark:hover:border-white/25"
               [attr.aria-label]="'Copy snippet for ' + sample"
               [title]="'Copy <africanies-icon name=&quot;' + sample + '&quot; />'"
               (click)="copySnippet(sample)"
@@ -55,7 +55,7 @@ import { ICONS_USAGE } from '../snippets';
       <div class="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
         <input
           type="search"
-          class="w-full max-w-md rounded-xl border border-border bg-white px-4 py-2.5 text-body text-ink outline-none ring-export/30 transition focus:ring-2 dark:border-white/15 dark:bg-ink dark:text-white"
+          class="w-full max-w-md rounded-xl border border-border bg-white px-4 py-2.5 text-body text-ink outline-none ring-export/30 transition focus:ring-2 dark:border-white/15 dark:bg-ink-950 dark:text-white"
           placeholder="Filter by name…"
           [value]="query()"
           (input)="query.set($any($event.target).value)"
@@ -77,7 +77,7 @@ import { ICONS_USAGE } from '../snippets';
         @for (name of filtered(); track name) {
           <button
             type="button"
-            class="group flex flex-col items-center gap-2.5 rounded-xl border border-border bg-white px-2 py-3.5 text-ink transition duration-150 hover:-translate-y-0.5 hover:border-neutral-400 hover:shadow-sm dark:border-white/10 dark:bg-ink dark:text-white dark:hover:border-white/25"
+            class="group flex flex-col items-center gap-2.5 rounded-xl border border-border bg-white px-2 py-3.5 text-ink transition duration-150 hover:-translate-y-0.5 hover:border-neutral-400 hover:shadow-sm dark:border-white/10 dark:bg-ink-950 dark:text-white dark:hover:border-white/25"
             [attr.aria-label]="'Copy snippet for ' + name"
             [title]="'Copy <africanies-icon name=&quot;' + name + '&quot; />'"
             (click)="copySnippet(name)"

package/apps/playground/src/app/pages/lecture-page.ts

@@ -42,7 +42,7 @@ import { PageHeaderComponent } from '../shared/page-header.component';
       />
 
       <section
-        class="rounded-xl border border-border bg-white p-5 dark:border-white/10 dark:bg-ink sm:p-6"
+        class="rounded-xl border border-border bg-white p-5 dark:border-white/10 dark:bg-ink-950 sm:p-6"
       >
         <h2 class="m-0 text-heading-3 text-ink dark:text-white">
           Category abbreviations
@@ -75,7 +75,7 @@ import { PageHeaderComponent } from '../shared/page-header.component';
       </section>
 
       <section
-        class="rounded-xl border border-border bg-white p-5 dark:border-white/10 dark:bg-ink sm:p-6"
+        class="rounded-xl border border-border bg-white p-5 dark:border-white/10 dark:bg-ink-950 sm:p-6"
       >
         <h2 class="m-0 text-heading-3 text-ink dark:text-white">On this page</h2>
         <p class="mt-2 mb-4 text-body-sm text-neutral-600 dark:text-neutral-400">
@@ -114,7 +114,7 @@ import { PageHeaderComponent } from '../shared/page-header.component';
             @for (entry of entriesFor(category); track entry.id) {
               <article
                 [id]="entry.id"
-                class="scroll-mt-24 rounded-xl border border-border bg-white p-5 dark:border-white/10 dark:bg-ink sm:p-6"
+                class="scroll-mt-24 rounded-xl border border-border bg-white p-5 dark:border-white/10 dark:bg-ink-950 sm:p-6"
                 [class.ring-2]="activeId() === entry.id"
                 [class.ring-export]="activeId() === entry.id"
               >

package/apps/playground/src/app/pages/models-page.ts

@@ -96,7 +96,7 @@ interface ModelCategory {
               <div class="grid gap-4">
                 @for (entry of group.models; track entry.name) {
                   <article
-                    class="flex flex-col gap-3 rounded-xl border border-border bg-white p-4 dark:border-white/10 dark:bg-ink sm:p-5"
+                    class="flex flex-col gap-3 rounded-xl border border-border bg-white p-4 dark:border-white/10 dark:bg-ink-950 sm:p-5"
                   >
                     <div
                       class="flex flex-wrap items-baseline justify-between gap-2"

package/apps/playground/src/app/pages/overlay-demos.ts

@@ -60,7 +60,7 @@ export interface DemoDrawerData {
           Note
         </span>
         <input
-          class="rounded-md border border-border bg-white px-3 py-2 text-body text-ink outline-none focus:border-neutral-400 dark:border-white/15 dark:bg-ink dark:text-white"
+          class="rounded-md border border-border bg-white px-3 py-2 text-body text-ink outline-none focus:border-neutral-400 dark:border-white/15 dark:bg-ink-950 dark:text-white"
           type="text"
           [value]="note"
           (input)="note = $any($event.target).value"

package/apps/playground/src/app/pages/tokens-page.ts

@@ -65,7 +65,7 @@ interface TokenSwatch {
                   class="h-20 border-b border-border dark:border-white/10"
                   [class]="token.bgClass"
                 ></div>
-                <div class="bg-white px-3 py-2.5 dark:bg-ink">
+                <div class="bg-white px-3 py-2.5 dark:bg-ink-surface">
                   <p class="m-0 text-body-sm font-medium text-ink dark:text-white">
                     {{ token.name }}
                   </p>
@@ -177,34 +177,52 @@ export class TokensPage {
   protected readonly colors: TokenSwatch[] = [
     { name: 'black', bgClass: 'bg-black', hex: '#000000', group: 'Core' },
     { name: 'white', bgClass: 'bg-white', hex: '#ffffff', group: 'Core' },
-    { name: 'ink', bgClass: 'bg-ink', hex: '#212529', group: 'Core' },
+    { name: 'ink', bgClass: 'bg-ink', hex: '#172033', group: 'Core' },
     { name: 'ink-blue', bgClass: 'bg-ink-blue', hex: '#192a3e', group: 'Core' },
-    { name: 'ink-brand', bgClass: 'bg-ink-brand', hex: '#1c2b3f', group: 'Core' },
+    { name: 'ink-brand', bgClass: 'bg-ink-brand', hex: '#172033', group: 'Core' },
+    { name: 'ink-surface', bgClass: 'bg-ink-surface', hex: '#212529', group: 'Core' },
     { name: 'ink-950', bgClass: 'bg-ink-950', hex: '#272729', group: 'Core' },
-    { name: 'neutral-300', bgClass: 'bg-neutral-300', hex: '#c9d5e1', group: 'Neutral' },
-    { name: 'neutral-400', bgClass: 'bg-neutral-400', hex: '#a9b5cb', group: 'Neutral' },
-    { name: 'neutral-600', bgClass: 'bg-neutral-600', hex: '#667185', group: 'Neutral' },
-    { name: 'border', bgClass: 'bg-border', hex: '#c9d5e1', group: 'Neutral' },
+    { name: 'surface', bgClass: 'bg-surface', hex: '#ffffff', group: 'Neutral' },
+    { name: 'neutral-500', bgClass: 'bg-neutral-500', hex: '#667185', group: 'Neutral' },
+    { name: 'neutral-600', bgClass: 'bg-neutral-600', hex: '#526071', group: 'Neutral' },
+    { name: 'border', bgClass: 'bg-border', hex: '#dde3ea', group: 'Neutral' },
+    { name: 'border-strong', bgClass: 'bg-border-strong', hex: '#c4cdd8', group: 'Neutral' },
+    { name: 'control', bgClass: 'bg-control', hex: '#8793a3', group: 'Neutral' },
+    { name: 'focus', bgClass: 'bg-focus', hex: '#175cd3', group: 'Neutral' },
+    {
+      name: 'background-chrome',
+      bgClass: 'bg-background-chrome',
+      hex: '#f4f6f8',
+      group: 'Neutral',
+    },
+    {
+      name: 'background-well',
+      bgClass: 'bg-background-well',
+      hex: '#eef2f6',
+      group: 'Neutral',
+    },
     {
       name: 'background-welcome',
       bgClass: 'bg-background-welcome',
-      hex: '#f9fafb',
+      hex: '#f8fafc',
       group: 'Neutral',
     },
     { name: 'export', bgClass: 'bg-export', hex: '#1cbd5d', group: 'Export (SFN)' },
+    { name: 'export-strong', bgClass: 'bg-export-strong', hex: '#0b7a3e', group: 'Export (SFN)' },
     { name: 'export-light', bgClass: 'bg-export-light', hex: '#24dc6d', group: 'Export (SFN)' },
     { name: 'export-subtle', bgClass: 'bg-export-subtle', hex: '#e4fff3', group: 'Export (SFN)' },
-    { name: 'export-tint', bgClass: 'bg-export-tint', hex: '#f2fff8', group: 'Export (SFN)' },
     { name: 'import', bgClass: 'bg-import', hex: '#f08829', group: 'Import (STN)' },
+    { name: 'import-strong', bgClass: 'bg-import-strong', hex: '#9a4b0b', group: 'Import (STN)' },
     { name: 'import-light', bgClass: 'bg-import-light', hex: '#ffa95b', group: 'Import (STN)' },
     { name: 'import-subtle', bgClass: 'bg-import-subtle', hex: '#fffcef', group: 'Import (STN)' },
     { name: 'danger', bgClass: 'bg-danger', hex: '#ff001c', group: 'Feedback' },
-    { name: 'danger-dark', bgClass: 'bg-danger-dark', hex: '#b41433', group: 'Feedback' },
+    { name: 'danger-dark', bgClass: 'bg-danger-dark', hex: '#b4233c', group: 'Feedback' },
     { name: 'danger-strong', bgClass: 'bg-danger-strong', hex: '#C00B19', group: 'Feedback' },
     { name: 'danger-subtle', bgClass: 'bg-danger-subtle', hex: '#FFF2F2', group: 'Feedback' },
     { name: 'warning', bgClass: 'bg-warning', hex: '#DBB316', group: 'Feedback' },
-    { name: 'warning-dark', bgClass: 'bg-warning-dark', hex: '#EF8833', group: 'Feedback' },
+    { name: 'warning-dark', bgClass: 'bg-warning-dark', hex: '#8a5a00', group: 'Feedback' },
     { name: 'warning-subtle', bgClass: 'bg-warning-subtle', hex: '#FFF6E6', group: 'Feedback' },
+    { name: 'info', bgClass: 'bg-info', hex: '#175cd3', group: 'Feedback' },
   ];
 
   protected colorsIn(group: string): TokenSwatch[] {

package/apps/playground/src/app/pages/usecases/onboarding-login.page.ts

@@ -27,7 +27,7 @@ import { PageHeaderComponent } from '../../shared/page-header.component';
       />
 
       <form
-        class="flex flex-col gap-4 rounded-xl border border-border bg-white p-6 dark:border-white/10 dark:bg-ink"
+        class="flex flex-col gap-4 rounded-xl border border-border bg-white p-6 dark:border-white/10 dark:bg-ink-950"
         (submit)="$event.preventDefault()"
       >
         <africanies-text-input

package/apps/playground/src/app/pages/usecases/onboarding-reset-password.page.ts

@@ -36,7 +36,7 @@ import { playgroundErrorMessage } from '../../shared/playground-notify';
       />
 
       <form
-        class="flex flex-col gap-4 rounded-xl border border-border bg-white p-6 dark:border-white/10 dark:bg-ink"
+        class="flex flex-col gap-4 rounded-xl border border-border bg-white p-6 dark:border-white/10 dark:bg-ink-950"
         (submit)="$event.preventDefault(); save()"
       >
         @if (errorMessage(); as err) {

package/apps/playground/src/app/pages/usecases/shipment-detail.page.ts

@@ -36,7 +36,7 @@ import { findUsecaseShipment } from './shipment-data';
         </div>
 
         <dl
-          class="grid gap-4 rounded-xl border border-border bg-white px-5 py-4 sm:grid-cols-3 dark:border-white/10 dark:bg-ink"
+          class="grid gap-4 rounded-xl border border-border bg-white px-5 py-4 sm:grid-cols-3 dark:border-white/10 dark:bg-ink-950"
         >
           <div>
             <dt class="text-caption text-neutral-500">Origin</dt>

package/apps/playground/src/app/pages/viewport-preview.component.ts

@@ -19,7 +19,7 @@ import {
   imports: [AppShellComponent, SideNavComponent],
   template: `
     <div
-      class="mx-auto overflow-hidden rounded-xl border border-border bg-white shadow-sm dark:border-white/10 dark:bg-ink"
+      class="mx-auto overflow-hidden rounded-xl border border-border bg-white shadow-sm dark:border-white/10 dark:bg-ink-950"
       [class]="frameClass()"
     >
       <africanies-app-shell

package/apps/playground/src/app/snippets/button.snippets.ts

@@ -3,9 +3,8 @@
 export /**
  *
  */
-const BUTTON_VARIANTS = `// Five variants. Primary and ghost-primary pick up SFN green / STN orange
-// from ModeColorService — don't hard-code those colors yourself.
-// ghost stays neutral (Cancel); ghost-primary is a mode-colored text button.
+const BUTTON_VARIANTS = `// Variants. Primary / ghost-primary / secondary (stroked) pick up SFN green /
+// STN orange from ModeColorService. flat is neutral chrome (Cancel, Filters).
 
 import { Component } from '@angular/core';
 import {
@@ -34,6 +33,7 @@ export class ShipmentActionsComponent {
   protected readonly variants: ButtonVariant[] = [
     'primary',
     'secondary',
+    'flat',
     'ghost',
     'ghost-primary',
     'ghost-danger',
@@ -44,6 +44,7 @@ export class ShipmentActionsComponent {
   protected readonly labels: Record<ButtonVariant, string> = {
     primary: 'Save shipment',
     secondary: 'Save draft',
+    flat: 'Filters',
     ghost: 'Cancel',
     'ghost-primary': 'Add row',
     'ghost-danger': 'Remove',

package/apps/playground/src/app/snippets/filters.snippets.ts

@@ -248,6 +248,16 @@ export const updateShipmentsFilterConfig: ModuleFilterConfigModel = {
         { value: '0', label: 'No' },
       ],
     },
+    {
+      key: 'pay_later',
+      label: 'Pay Later',
+      type: 'enum',
+      exclusive: true,
+      options: [
+        { value: 'credit', label: 'Credit' },
+        { value: 'debit', label: 'Debit' },
+      ],
+    },
   ],
 };
 `;

package/apps/playground/src/index.html

@@ -14,6 +14,12 @@
       type="image/png"
       href="assets/africanies-ui/brand/africanies-logo-mini.png"
     />
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap"
+      rel="stylesheet"
+    />
   </head>
   <body>
     <app-root></app-root>

package/apps/playground/src/styles.css

@@ -12,12 +12,11 @@
   }
 
   /*
-   * Playground light canvas — slightly duller than theme `background-welcome`
-   * (#f9fafb) so long catalog sessions feel less glare-y. Demo cards stay white.
+   * Playground light canvas — portal page chrome (#f6f7f9). Demo cards stay white.
    */
   :root {
-    --pg-canvas: #e6ebf1;
-    --pg-chrome: #f2f5f8;
+    --pg-canvas: #f6f7f9;
+    --pg-chrome: #f0f2f5;
   }
 
   body {
@@ -229,7 +228,7 @@
 }
 
 .pg-lecture-scroll-top {
-  @apply fixed bottom-6 right-6 z-40 flex size-11 items-center justify-center rounded-full border border-border bg-white text-ink shadow-md hover:border-export hover:text-export dark:border-white/15 dark:bg-ink dark:text-white dark:hover:border-export-light dark:hover:text-export-light;
+  @apply fixed bottom-6 right-6 z-40 flex size-11 items-center justify-center rounded-full border border-border bg-white text-ink shadow-md hover:border-export hover:text-export dark:border-white/15 dark:bg-ink-surface dark:text-white dark:hover:border-export-light dark:hover:text-export-light;
   opacity: 0;
   pointer-events: none;
   transform: translateY(1rem) scale(0.92);

package/dist/libs/africanies-core/fesm2022/africanies-africanies-core.mjs

@@ -3765,22 +3765,58 @@ const SHIPMENT_APP_BY_MODE = {
     stn: 'shiptonaija',
     sfn: 'shipfromnaija',
 };
+const QUERY_SHIPMENT_APP = 'shipment_app';
+const LEGACY_PORTAL_HOST = /^(?:test-)?(?:admin|customer)-(?:export|import)\.africaniestest\.com$/i;
+/** Signed export downloads and other hosts that must not be rewritten in-app. */
+function isNotificationExternalLink(link) {
+    const trimmed = decodeNotificationLink(link).trim();
+    if (!trimmed) {
+        return false;
+    }
+    try {
+        const url = new URL(trimmed);
+        if (/\.(xlsx|xls|csv)(\?|$)/i.test(url.pathname)) {
+            return true;
+        }
+        if (/\.amazonaws\.com$/i.test(url.hostname)) {
+            return true;
+        }
+        return !isLegacyPortalHost(url.hostname);
+    }
+    catch {
+        return false;
+    }
+}
 /**
- * Rewrite a notification portal URL for the active {@link ShippingMode}.
+ * Rewrite a notification href for the active {@link ShippingMode}.
  *
- * Swaps `-export` / `-import` host segments and sets `shipment_app` to
- * `shipfromnaija` (SFN) or `shiptonaija` (STN).
- * @param link
- * @param mode
+ * - Export / download URLs (S3, spreadsheets) pass through unchanged (no `shipment_app`).
+ * - Legacy portal hosts become relative `/portal/...` paths with query preserved.
+ * - When the notification already includes `shipment_app`, it is kept as-is.
+ * - Otherwise classic host / `shipment_app` rewriting applies for portal URLs.
  */
 function resolveNotificationLinkForMode(link, mode) {
-    const trimmed = asString(link).trim();
+    const trimmed = decodeNotificationLink(asString(link)).trim();
     if (!trimmed) {
         return trimmed;
     }
+    if (isNotificationExternalLink(trimmed)) {
+        return stripShipmentAppFromLink(trimmed);
+    }
+    const relativePortal = toRelativePortalNotificationLink(trimmed);
+    if (relativePortal && hasShipmentAppQuery(relativePortal)) {
+        return relativePortal;
+    }
+    const relative = normalizeRelativePortalLink(trimmed);
+    if (relative && hasShipmentAppQuery(relative)) {
+        return relative;
+    }
     try {
         const url = new URL(trimmed);
-        url.searchParams.set('shipment_app', SHIPMENT_APP_BY_MODE[mode]);
+        if (url.searchParams.has(QUERY_SHIPMENT_APP)) {
+            return trimmed;
+        }
+        url.searchParams.set(QUERY_SHIPMENT_APP, SHIPMENT_APP_BY_MODE[mode]);
         url.hostname = rewriteNotificationHostForMode(url.hostname, mode);
         return url.toString();
     }
@@ -3795,6 +3831,9 @@ function rewriteNotificationHostForMode(hostname, mode) {
     return hostname.replace(/-import/i, '-export');
 }
 function rewriteNotificationLinkFallback(link, mode) {
+    if (hasShipmentAppQuery(link)) {
+        return link;
+    }
     let out = link.replace(/shipment_app=(?:shipfromnaija|shiptonaija)/gi, `shipment_app=${SHIPMENT_APP_BY_MODE[mode]}`);
     if (!/shipment_app=/i.test(out)) {
         const joiner = out.includes('?') ? '&' : '?';
@@ -3805,6 +3844,90 @@ function rewriteNotificationLinkFallback(link, mode) {
     }
     return out.replace(/-import/gi, '-export');
 }
+function toRelativePortalNotificationLink(link) {
+    try {
+        const url = new URL(link);
+        if (!isLegacyPortalHost(url.hostname)) {
+            return null;
+        }
+        let path = url.pathname.replace(/^\/+/, '');
+        if (path.startsWith('ng/portal/')) {
+            path = path.slice('ng/'.length);
+        }
+        if (!path.startsWith('portal/') && path !== 'portal') {
+            return null;
+        }
+        const query = url.searchParams.toString();
+        return `/${path}${query ? `?${query}` : ''}`;
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeRelativePortalLink(link) {
+    let path = link.split('?')[0]?.split('#')[0] ?? '';
+    const query = link.includes('?') ? link.slice(link.indexOf('?')) : '';
+    path = path.replace(/^\/+/, '');
+    if (path.startsWith('ng/portal/')) {
+        path = path.slice('ng/'.length);
+    }
+    if (!path.startsWith('portal/') && path !== 'portal') {
+        return null;
+    }
+    return `/${path}${query}`;
+}
+function stripShipmentAppFromLink(link) {
+    const trimmed = link.trim();
+    if (!trimmed) {
+        return trimmed;
+    }
+    try {
+        const url = new URL(trimmed);
+        if (!url.searchParams.has(QUERY_SHIPMENT_APP)) {
+            return trimmed;
+        }
+        url.searchParams.delete(QUERY_SHIPMENT_APP);
+        return url.toString();
+    }
+    catch {
+        const params = new URLSearchParams(trimmed.includes('?') ? trimmed.slice(trimmed.indexOf('?') + 1) : '');
+        if (!params.has(QUERY_SHIPMENT_APP)) {
+            return trimmed;
+        }
+        params.delete(QUERY_SHIPMENT_APP);
+        const query = params.toString();
+        const base = trimmed.split('?')[0] ?? trimmed;
+        return query ? `${base}?${query}` : base;
+    }
+}
+function hasShipmentAppQuery(link) {
+    try {
+        const query = link.includes('?') ? link.slice(link.indexOf('?') + 1) : '';
+        return new URLSearchParams(query).has(QUERY_SHIPMENT_APP);
+    }
+    catch {
+        return /(?:^|[?&])shipment_app=/i.test(link);
+    }
+}
+function decodeNotificationLink(link) {
+    let value = (link ?? '').trim();
+    if (!value.includes('%')) {
+        return value;
+    }
+    try {
+        const decoded = decodeURIComponent(value);
+        if (decoded !== value) {
+            value = decoded;
+        }
+    }
+    catch {
+        // Keep original when not valid URI encoding.
+    }
+    return value;
+}
+function isLegacyPortalHost(hostname) {
+    return LEGACY_PORTAL_HOST.test(hostname);
+}
 
 /**
  * File utility reads (`POST /file/read`).
@@ -4507,5 +4630,5 @@ function downloadCsv(options) {
  * Generated bundle index. Do not edit.
  */
 
-export { AFRICANIES_HTTP_TOAST, AFRICANIES_SDK_CONFIG, AUTH_FORGOT_PASSWORD_PATH, ApiClient, AuthService, AuthTokenService, COUNTRY_FLAG_CDN_BASE, COUNTRY_READ_PATH, CURRENCY_CREATE_PATH, CURRENCY_DELETE_PATH, CURRENCY_READ_PATH, CURRENCY_UPDATE_PATH, CountryService, CurrencyService, DOCUMENT_READ_PATH, DRAWER_SERVICE, DocumentService, FILE_READ_MULTIPLE_PARAM, FILE_READ_PATH, FileService, FilterOptionsResolver, HttpResponseCache, MODAL_SERVICE, MODE_CONFIG_PATH, ModeConfigService, NOTIFICATION_READ_PATH, NOTIFICATION_UPDATE_PATH, NotificationService, OVERLAY_ROUTE_CONFIGS, PAYMENT_METHOD_READ_PATH, PAYMENT_METHOD_UPDATE_PATH, PLAN_READ_PATH, PRODUCT_READ_PATH, PaymentMethodService, PlanService, ProductService, RouteOverlayService, SERVICE_READ_PATH, SHIPMENT_METHOD_READ_PATH, SHIPPING_MODE_OVERRIDE, ServiceService, ShipmentMethodService, ShippingModeService, TOAST_HTTP_OPTIONS, USER_CHANGE_PASSWORD_PATH, USER_LOGOUT_FROM_ALL_SESSIONS_PATH, USER_PATH, UserService, WAREHOUSE_READ_PATH, WarehouseService, ZONE_READ_PATH, ZoneService, asArray, asBoolean, asNullableBoolean, asNullableFlag01, asNullableNumber, asNullableString, asNumber, asRecord, asShippingMode$1 as asShippingMode, asString, authInterceptor, buildResourcePath, buildResourceQueryParams, collectFilterOptionsSources, collectResolvableSelectFields, copyToClipboard, countryFlagUrl, createAfricaniesQueryClientDefaults, csvCell, downloadCsv, fieldErrorsMap, formatApiErrorMessage, httpToastInterceptor, isLaravelValidationBag, isValidEmail, joinApiErrorMessages, listFetchKind, mapApiJsonList, mapApiJsonValue, mapArray, mapCountry, mapCountryList, mapCountrySelectOptions, mapCountryState, mapCurrency, mapCurrencyList, mapCurrencyPaymentMethod, mapCurrencyPaymentMethodPivot, mapDocument, mapDocumentList, mapFileRead, mapFileReadList, mapLaravelValidationBag, mapList, mapModeConfigData, mapNotification, mapNotificationInboxItem, mapNotificationList, mapNotificationPayload, mapPaymentMethod, mapPaymentMethodCurrency, mapPaymentMethodList, mapPlan, mapPlanList, mapPlanPackage, mapProduct, mapProductList, mapResourcePayload, mapService, mapServiceList, mapShipmentMethod, mapShipmentMethodFilterOptions, mapShipmentMethodList, mapShipmentMethodZoneLink, mapShipmentMethodZonePage, mapShipmentZone, mapUser, mapUserAccountManager, mapUserBusinessAccount, mapUserCountry, mapUserCountryState, mapUserGatewayPayload, mapUserPaymentPayload, mapUserPlan, mapUserPlanPackage, mapUserStateLabel, mapUserSubscription, mapWarehouse, mapWarehouseCountry, mapWarehouseFilterOptions, mapWarehouseList, mapWarehouseState, mapZone, mapZoneList, mergeFilterOptionLists, normalize, normalizePagination, provideAfricaniesHttpClient, provideAfricaniesQueryDefaults, provideAfricaniesSdk, provideModeConfig, provideOverlayRoutes, resolveModeRegionConfig, resolveNotificationLinkForMode, resourceCacheTtlMs, shipmentModeInterceptor, toCsvString, toCurrencyCreateBody, toCurrencyDeleteBody, toCurrencyFlag01, toCurrencyUpdateBody, toFlag01, toPaymentMethodFlag01, toPaymentMethodUpdateBody, unwrapLaravelPaginator, withShippingMode, withToast };
+export { AFRICANIES_HTTP_TOAST, AFRICANIES_SDK_CONFIG, AUTH_FORGOT_PASSWORD_PATH, ApiClient, AuthService, AuthTokenService, COUNTRY_FLAG_CDN_BASE, COUNTRY_READ_PATH, CURRENCY_CREATE_PATH, CURRENCY_DELETE_PATH, CURRENCY_READ_PATH, CURRENCY_UPDATE_PATH, CountryService, CurrencyService, DOCUMENT_READ_PATH, DRAWER_SERVICE, DocumentService, FILE_READ_MULTIPLE_PARAM, FILE_READ_PATH, FileService, FilterOptionsResolver, HttpResponseCache, MODAL_SERVICE, MODE_CONFIG_PATH, ModeConfigService, NOTIFICATION_READ_PATH, NOTIFICATION_UPDATE_PATH, NotificationService, OVERLAY_ROUTE_CONFIGS, PAYMENT_METHOD_READ_PATH, PAYMENT_METHOD_UPDATE_PATH, PLAN_READ_PATH, PRODUCT_READ_PATH, PaymentMethodService, PlanService, ProductService, RouteOverlayService, SERVICE_READ_PATH, SHIPMENT_METHOD_READ_PATH, SHIPPING_MODE_OVERRIDE, ServiceService, ShipmentMethodService, ShippingModeService, TOAST_HTTP_OPTIONS, USER_CHANGE_PASSWORD_PATH, USER_LOGOUT_FROM_ALL_SESSIONS_PATH, USER_PATH, UserService, WAREHOUSE_READ_PATH, WarehouseService, ZONE_READ_PATH, ZoneService, asArray, asBoolean, asNullableBoolean, asNullableFlag01, asNullableNumber, asNullableString, asNumber, asRecord, asShippingMode$1 as asShippingMode, asString, authInterceptor, buildResourcePath, buildResourceQueryParams, collectFilterOptionsSources, collectResolvableSelectFields, copyToClipboard, countryFlagUrl, createAfricaniesQueryClientDefaults, csvCell, downloadCsv, fieldErrorsMap, formatApiErrorMessage, httpToastInterceptor, isLaravelValidationBag, isNotificationExternalLink, isValidEmail, joinApiErrorMessages, listFetchKind, mapApiJsonList, mapApiJsonValue, mapArray, mapCountry, mapCountryList, mapCountrySelectOptions, mapCountryState, mapCurrency, mapCurrencyList, mapCurrencyPaymentMethod, mapCurrencyPaymentMethodPivot, mapDocument, mapDocumentList, mapFileRead, mapFileReadList, mapLaravelValidationBag, mapList, mapModeConfigData, mapNotification, mapNotificationInboxItem, mapNotificationList, mapNotificationPayload, mapPaymentMethod, mapPaymentMethodCurrency, mapPaymentMethodList, mapPlan, mapPlanList, mapPlanPackage, mapProduct, mapProductList, mapResourcePayload, mapService, mapServiceList, mapShipmentMethod, mapShipmentMethodFilterOptions, mapShipmentMethodList, mapShipmentMethodZoneLink, mapShipmentMethodZonePage, mapShipmentZone, mapUser, mapUserAccountManager, mapUserBusinessAccount, mapUserCountry, mapUserCountryState, mapUserGatewayPayload, mapUserPaymentPayload, mapUserPlan, mapUserPlanPackage, mapUserStateLabel, mapUserSubscription, mapWarehouse, mapWarehouseCountry, mapWarehouseFilterOptions, mapWarehouseList, mapWarehouseState, mapZone, mapZoneList, mergeFilterOptionLists, normalize, normalizePagination, provideAfricaniesHttpClient, provideAfricaniesQueryDefaults, provideAfricaniesSdk, provideModeConfig, provideOverlayRoutes, resolveModeRegionConfig, resolveNotificationLinkForMode, resourceCacheTtlMs, shipmentModeInterceptor, toCsvString, toCurrencyCreateBody, toCurrencyDeleteBody, toCurrencyFlag01, toCurrencyUpdateBody, toFlag01, toPaymentMethodFlag01, toPaymentMethodUpdateBody, unwrapLaravelPaginator, withShippingMode, withToast };
 //# sourceMappingURL=africanies-africanies-core.mjs.map