@africanies/angular-web-sdk 0.1.4 → 0.1.6

package/libs/africanies-core/src/lib/http/api-client.ts

@@ -11,11 +11,9 @@ import {
   map,
   Observable,
   of,
-  retry,
   tap,
   throwError,
   timeout,
-  timer,
 } from 'rxjs';
 
 import {
@@ -30,7 +28,6 @@ import { AFRICANIES_SDK_CONFIG } from '../config/africanies-sdk.config';
 import { ShippingModeService } from '../shipping/shipping-mode.service';
 import { formatApiErrorMessage } from './api-error-message';
 import { HttpResponseCache } from './http-cache';
-import { isRetryableGetError } from './is-retryable-get-error';
 import { normalize } from './normalize';
 import {
   resolveApiRequestContext,
@@ -102,7 +99,8 @@ type ResponseMode = NonNullable<ApiRequestOptions['responseMode']>;
  * - HTTP failures rethrown as `Error` whose `.message` is already
  *   user-facing ({@link formatApiErrorMessage}) — consumers do not need to
  *   parse `HttpErrorResponse` bodies
- * - Exponential-backoff retry (max 1) for **GET only**
+ * - **No automatic retry** — fail fast so UIs can show Select / table /
+ *   error-state Retry instead of a stuck loading spinner
  * - Optional per-GET TTL cache via `cacheTtlMs`
  *
  * @example
@@ -474,20 +472,8 @@ export class ApiClient {
         break;
     }
 
-    // Retry only idempotent GETs on transient failures — never replay 401/404 etc.
-    if (method === 'GET') {
-      req$ = req$.pipe(
-        retry({
-          count: 1,
-          delay: (err, retryCount) => {
-            if (!isRetryableGetError(err)) {
-              return throwError(() => err);
-            }
-            return timer(2 ** (retryCount - 1) * 1000);
-          },
-        }),
-      );
-    }
+    // No automatic GET retry — admin shells own Retry via UI
+    // (`africanies-select` showRetry, table error→refreshClick, error-state).
 
     if (this.config.timeout != null) {
       req$ = req$.pipe(

package/libs/africanies-core/src/lib/http/is-retryable-get-error.ts

@@ -1,11 +1,15 @@
 import { HttpErrorResponse } from '@angular/common/http';
 
 /**
- * Whether a failed GET should be retried by {@link ApiClient}.
+ * Whether a failed GET *would* be a candidate for automatic retry.
+ *
+ * {@link ApiClient} no longer auto-retries (fail fast for manual UI Retry).
+ * Kept for callers/tests that still want to classify transient vs permanent
+ * failures.
+ *
+ * Transient: network blips, timeouts, 408/429, 5xx.
+ * Auth and other 4xx fail fast — retrying 401 does not help.
  *
- * Retries transient failures only (network blips, timeouts, 408/429, 5xx).
- * Auth and other 4xx errors fail fast — retrying 401 does not help and causes
- * duplicate requests + toasts.
  * @param err
  */
 export function isRetryableGetError(err: unknown): boolean {

package/libs/africanies-core/src/lib/query/provide-africanies-query-defaults.ts

@@ -9,8 +9,8 @@
  * (no caret/tilde): TanStack marks the Angular adapter experimental and
  * breaking changes land without major bumps.
  *
- * Retry/backoff here mirrors {@link ApiClient}'s GET retry (max 3,
- * exponential) so HTTP-layer and query-layer behavior stay aligned.
+ * Query retries default to **0** to match {@link ApiClient} (fail fast;
+ * screens use manual Retry). Apps can override per `QueryClient` if needed.
  */
 
 /**
@@ -23,9 +23,9 @@ export interface AfricaniesQueryClientDefaults {
     staleTime: number;
     /** Unused-query garbage-collection time (ms). */
     gcTime: number;
-    /** Max failed-fetch retries for queries. */
+    /** Max failed-fetch retries for queries (default 0 — fail fast). */
     retry: number;
-    /** Exponential delay matching ApiClient GET backoff. */
+    /** Delay between retries when {@link AfricaniesQueryClientDefaults.queries.retry} > 0. */
     retryDelay: (attemptIndex: number) => number;
   };
   mutations: {
@@ -82,8 +82,7 @@ export function createAfricaniesQueryClientDefaults(): AfricaniesQueryClientDefa
     queries: {
       staleTime: 60_000,
       gcTime: 5 * 60_000,
-      retry: 3,
-      // attemptIndex is 0-based in TanStack; match 1s, 2s, 4s style backoff.
+      retry: 0,
       retryDelay: (attemptIndex: number) =>
         Math.min(1000 * 2 ** attemptIndex, 30_000),
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@africanies/angular-web-sdk",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "packageManager": "pnpm@11.24.0",
   "license": "MIT",
   "contributors": [

package/.nx/cache/1275815545780424169/dist/libs/africanies-theme/fesm2022/africanies-africanies-theme.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"africanies-africanies-theme.mjs","sources":["../../../../libs/africanies-theme/src/lib/mode-color.safelist.ts","../../../../libs/africanies-theme/src/lib/mode-color.service.ts","../../../../libs/africanies-theme/src/lib/theme.service.ts","../../../../libs/africanies-theme/src/africanies-africanies-theme.ts"],"sourcesContent":["/**\n * Tailwind safelist side-effect for shipping-mode color utilities.\n *\n * WHY this file exists: JIT/content scanning only keeps class names that appear\n * as *literal strings* in scanned sources. {@link ModeColorService} already\n * returns these literals, but keeping a dedicated comment list makes the\n * contract obvious for consumers who configure `safelist` or purge plugins.\n *\n * Do not rename these strings without updating ModeColorService and THEME.md.\n *\n * SFN (export / green):\n * text-export bg-export bg-export-subtle bg-export-light border-export\n * hover:bg-export-light hover:bg-export-subtle dark:bg-export/15 dark:hover:bg-export/15\n *\n * STN (import / orange):\n * text-import bg-import bg-import-subtle bg-import-light border-import\n * hover:bg-import-light hover:bg-import-subtle dark:bg-import/15 dark:hover:bg-import/15\n */\nexport const MODE_COLOR_SAFELIST = [\n  'text-export',\n  'bg-export',\n  'bg-export-subtle',\n  'bg-export-light',\n  'border-export',\n  'hover:bg-export-light',\n  'hover:bg-export-subtle',\n  'dark:bg-export/15',\n  'dark:hover:bg-export/15',\n  'text-import',\n  'bg-import',\n  'bg-import-subtle',\n  'bg-import-light',\n  'border-import',\n  'hover:bg-import-light',\n  'hover:bg-import-subtle',\n  'dark:bg-import/15',\n  'dark:hover:bg-import/15',\n] as const;\n","import { computed, inject, Injectable } from '@angular/core';\n\nimport { ShippingModeService } from '@africanies/africanies-core';\n\n/**\n * Tailwind class bundle for the active shipping mode (SFN export / STN import).\n *\n * Use these for **primary** product chrome: CTAs, selected controls, progress,\n * and accent text. Semantic colors (danger / warning) stay mode-independent.\n */\nexport interface ModeColorClasses {\n  /** Text color utility, e.g. `text-export`. */\n  text: string;\n  /** Solid background utility, e.g. `bg-export`. */\n  bg: string;\n  /** Soft background utility, e.g. `bg-export-subtle`. */\n  bgSubtle: string;\n  /** Border matching the mode accent, e.g. `border-export`. */\n  border: string;\n  /**\n   * Filled primary CTA — `variant=\"primary\"` on buttons.\n   * Includes hover utility as a literal so Tailwind keeps it.\n   */\n  primary: string;\n  /**\n   * Transparent / text-only CTA — `variant=\"ghost-primary\"` on buttons.\n   * Mode accent text + soft hover fill.\n   */\n  ghostPrimary: string;\n  /**\n   * Soft highlight for selected / active rows (works in dark mode).\n   */\n  soft: string;\n  /**\n   * Soft hover highlight for menus and lists.\n   */\n  softHover: string;\n}\n\n/**\n * Maps {@link ShippingModeService} to mode-accent Tailwind classes.\n *\n * - **SFN** → export green is primary\n * - **STN** → import orange is primary\n *\n * WHY literal class strings: Tailwind's scanner cannot see dynamically built\n * names like `` `text-${token}` ``. Returning full literals (`text-export`, …)\n * keeps utilities in the compiled CSS. See {@link MODE_COLOR_SAFELIST}.\n *\n * @example\n * ```html\n * @let colors = modeColor.classes();\n * <button type=\"button\" [class]=\"colors.primary\">Save</button>\n * <span [class]=\"colors.text\">Mode accent</span>\n * ```\n */\n@Injectable({ providedIn: 'root' })\nexport class ModeColorService {\n  private readonly shippingMode = inject(ShippingModeService);\n\n  /**\n   * Mode-dependent utility classes. Recomputes when shipping mode changes.\n   */\n  readonly classes = computed<ModeColorClasses>(() => {\n    // Literal strings required for Tailwind content detection — do not interpolate.\n    if (this.shippingMode.mode() === 'sfn') {\n      return {\n        text: 'text-export',\n        bg: 'bg-export',\n        bgSubtle: 'bg-export-subtle',\n        border: 'border-export',\n        primary:\n          'bg-export text-white border-transparent hover:bg-export-light',\n        ghostPrimary:\n          'bg-transparent text-export border-transparent hover:bg-export-subtle dark:hover:bg-export/15',\n        soft: 'bg-export-subtle dark:bg-export/15',\n        softHover: 'hover:bg-export-subtle dark:hover:bg-export/15',\n      };\n    }\n    return {\n      text: 'text-import',\n      bg: 'bg-import',\n      bgSubtle: 'bg-import-subtle',\n      border: 'border-import',\n      primary:\n        'bg-import text-white border-transparent hover:bg-import-light',\n      ghostPrimary:\n        'bg-transparent text-import border-transparent hover:bg-import-subtle dark:hover:bg-import/15',\n      soft: 'bg-import-subtle dark:bg-import/15',\n      softHover: 'hover:bg-import-subtle dark:hover:bg-import/15',\n    };\n  });\n}\n","import { DOCUMENT } from '@angular/common';\nimport { inject, Injectable, signal } from '@angular/core';\n\nimport { AFRICANIES_THEME_KEY, STORAGE_TOKEN } from '@africanies/africanies-storage';\n\nimport type { Theme } from './theme.types';\n\n/**\n * Application light/dark theme preference.\n *\n * WHY signals (not BehaviorSubject): theme is synchronous UI state read from\n * templates and other services; a signal avoids RxJS subscription boilerplate\n * and matches Angular 22 change detection. Persistence goes through\n * {@link STORAGE_TOKEN} so tests can swap storage without touching `localStorage`.\n *\n * Applies the Tailwind `darkMode: 'class'` contract by toggling `dark` on\n * `document.documentElement`, and sets `color-scheme` so native UI (date\n * pickers, scrollbars, form controls) matches the app theme — class-based\n * dark mode alone does not restyle browser chrome.\n *\n * @example\n * ```ts\n * // app.config.ts\n * import { inject, provideAppInitializer } from '@angular/core';\n * import { ThemeService } from '@africanies/africanies-theme';\n *\n * export const appConfig = {\n *   providers: [\n *     provideAppInitializer(() => {\n *       inject(ThemeService); // applies stored / system theme once\n *     }),\n *   ],\n * };\n *\n * // In a component\n * const theme = inject(ThemeService);\n * theme.toggle();\n * theme.setTheme('dark');\n * const current = theme.theme(); // 'light' | 'dark'\n * ```\n */\n@Injectable({ providedIn: 'root' })\nexport class ThemeService {\n  private readonly storage = inject(STORAGE_TOKEN);\n  private readonly document = inject(DOCUMENT);\n\n  /**\n   * Current theme. Prefer reading via `theme()` in templates / computed values\n   * rather than caching the string, so dark-class consumers stay in sync.\n   */\n  readonly theme = signal<Theme>(this.resolveInitialTheme());\n\n  constructor() {\n    this.applyToDocument(this.theme());\n  }\n\n  /**\n   * Sets and persists the theme, updating the `dark` class and `color-scheme`\n   * on `<html>`.\n   *\n   * @param theme - Absolute preference to store.\n   */\n  setTheme(theme: Theme): void {\n    this.theme.set(theme);\n    this.applyToDocument(theme);\n    try {\n      this.storage.set(AFRICANIES_THEME_KEY, theme);\n    } catch {\n      // Persistence failure must not block the in-session visual toggle —\n      // private browsing / quota issues are transient for theme preference.\n    }\n  }\n\n  /**\n   * Flips between light and dark.\n   *\n   * @returns The theme after the toggle.\n   */\n  toggle(): Theme {\n    const next: Theme = this.theme() === 'light' ? 'dark' : 'light';\n    this.setTheme(next);\n    return next;\n  }\n\n  private resolveInitialTheme(): Theme {\n    try {\n      const stored = this.storage.get<Theme>(AFRICANIES_THEME_KEY);\n      if (stored === 'light' || stored === 'dark') {\n        return stored;\n      }\n    } catch {\n      // Fall through to system preference when storage is unavailable.\n    }\n    return this.prefersDark() ? 'dark' : 'light';\n  }\n\n  private prefersDark(): boolean {\n    const win = this.document.defaultView;\n    return !!win?.matchMedia?.('(prefers-color-scheme: dark)').matches;\n  }\n\n  private applyToDocument(theme: Theme): void {\n    const root = this.document.documentElement;\n    if (theme === 'dark') {\n      root.classList.add('dark');\n    } else {\n      root.classList.remove('dark');\n    }\n    // Native date/time pickers follow `color-scheme`, not Tailwind's `dark` class.\n    root.style.colorScheme = theme;\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/.nx/cache/1275815545780424169/dist/libs/africanies-theme/package.json

@@ -1,36 +0,0 @@
-{
-  "name": "@africanies/africanies-theme",
-  "version": "0.0.1",
-  "peerDependencies": {
-    "@angular/common": "^22.0.0",
-    "@angular/core": "^22.0.0",
-    "@africanies/africanies-core": "^0.0.2",
-    "@africanies/africanies-storage": "^0.0.1"
-  },
-  "sideEffects": false,
-  "publishConfig": {
-    "registry": "https://npm.pkg.github.com",
-    "access": "restricted"
-  },
-  "exports": {
-    "./tailwind-preset": "./tailwind-preset.cjs",
-    "./package.json": {
-      "default": "./package.json"
-    },
-    ".": {
-      "types": "./types/africanies-africanies-theme.d.ts",
-      "default": "./fesm2022/africanies-africanies-theme.mjs"
-    }
-  },
-  "files": [
-    "**/*",
-    "tailwind-preset.cjs",
-    "THEME.md"
-  ],
-  "module": "fesm2022/africanies-africanies-theme.mjs",
-  "typings": "types/africanies-africanies-theme.d.ts",
-  "type": "module",
-  "dependencies": {
-    "tslib": "^2.3.0"
-  }
-}

package/.nx/cache/1275815545780424169/dist/libs/africanies-theme/types/africanies-africanies-theme.d.ts

@@ -1,157 +0,0 @@
-import * as i0 from '@angular/core';
-
-/**
- * Tailwind safelist side-effect for shipping-mode color utilities.
- *
- * WHY this file exists: JIT/content scanning only keeps class names that appear
- * as *literal strings* in scanned sources. {@link ModeColorService} already
- * returns these literals, but keeping a dedicated comment list makes the
- * contract obvious for consumers who configure `safelist` or purge plugins.
- *
- * Do not rename these strings without updating ModeColorService and THEME.md.
- *
- * SFN (export / green):
- * text-export bg-export bg-export-subtle bg-export-light border-export
- * hover:bg-export-light hover:bg-export-subtle dark:bg-export/15 dark:hover:bg-export/15
- *
- * STN (import / orange):
- * text-import bg-import bg-import-subtle bg-import-light border-import
- * hover:bg-import-light hover:bg-import-subtle dark:bg-import/15 dark:hover:bg-import/15
- */
-declare const MODE_COLOR_SAFELIST: readonly ["text-export", "bg-export", "bg-export-subtle", "bg-export-light", "border-export", "hover:bg-export-light", "hover:bg-export-subtle", "dark:bg-export/15", "dark:hover:bg-export/15", "text-import", "bg-import", "bg-import-subtle", "bg-import-light", "border-import", "hover:bg-import-light", "hover:bg-import-subtle", "dark:bg-import/15", "dark:hover:bg-import/15"];
-
-/**
- * Tailwind class bundle for the active shipping mode (SFN export / STN import).
- *
- * Use these for **primary** product chrome: CTAs, selected controls, progress,
- * and accent text. Semantic colors (danger / warning) stay mode-independent.
- */
-interface ModeColorClasses {
-    /** Text color utility, e.g. `text-export`. */
-    text: string;
-    /** Solid background utility, e.g. `bg-export`. */
-    bg: string;
-    /** Soft background utility, e.g. `bg-export-subtle`. */
-    bgSubtle: string;
-    /** Border matching the mode accent, e.g. `border-export`. */
-    border: string;
-    /**
-     * Filled primary CTA — `variant="primary"` on buttons.
-     * Includes hover utility as a literal so Tailwind keeps it.
-     */
-    primary: string;
-    /**
-     * Transparent / text-only CTA — `variant="ghost-primary"` on buttons.
-     * Mode accent text + soft hover fill.
-     */
-    ghostPrimary: string;
-    /**
-     * Soft highlight for selected / active rows (works in dark mode).
-     */
-    soft: string;
-    /**
-     * Soft hover highlight for menus and lists.
-     */
-    softHover: string;
-}
-/**
- * Maps {@link ShippingModeService} to mode-accent Tailwind classes.
- *
- * - **SFN** → export green is primary
- * - **STN** → import orange is primary
- *
- * WHY literal class strings: Tailwind's scanner cannot see dynamically built
- * names like `` `text-${token}` ``. Returning full literals (`text-export`, …)
- * keeps utilities in the compiled CSS. See {@link MODE_COLOR_SAFELIST}.
- *
- * @example
- * ```html
- * @let colors = modeColor.classes();
- * <button type="button" [class]="colors.primary">Save</button>
- * <span [class]="colors.text">Mode accent</span>
- * ```
- */
-declare class ModeColorService {
-    private readonly shippingMode;
-    /**
-     * Mode-dependent utility classes. Recomputes when shipping mode changes.
-     */
-    readonly classes: i0.Signal<ModeColorClasses>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ModeColorService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ModeColorService>;
-}
-
-/**
- * Supported UI color schemes for {@link ThemeService}.
- *
- * Kept as a closed string union so storage values and DOM class toggles stay
- * aligned — unknown persisted strings are ignored and fall back to system
- * preference / light.
- */
-type Theme = 'light' | 'dark';
-
-/**
- * Application light/dark theme preference.
- *
- * WHY signals (not BehaviorSubject): theme is synchronous UI state read from
- * templates and other services; a signal avoids RxJS subscription boilerplate
- * and matches Angular 22 change detection. Persistence goes through
- * {@link STORAGE_TOKEN} so tests can swap storage without touching `localStorage`.
- *
- * Applies the Tailwind `darkMode: 'class'` contract by toggling `dark` on
- * `document.documentElement`, and sets `color-scheme` so native UI (date
- * pickers, scrollbars, form controls) matches the app theme — class-based
- * dark mode alone does not restyle browser chrome.
- *
- * @example
- * ```ts
- * // app.config.ts
- * import { inject, provideAppInitializer } from '@angular/core';
- * import { ThemeService } from '@africanies/africanies-theme';
- *
- * export const appConfig = {
- *   providers: [
- *     provideAppInitializer(() => {
- *       inject(ThemeService); // applies stored / system theme once
- *     }),
- *   ],
- * };
- *
- * // In a component
- * const theme = inject(ThemeService);
- * theme.toggle();
- * theme.setTheme('dark');
- * const current = theme.theme(); // 'light' | 'dark'
- * ```
- */
-declare class ThemeService {
-    private readonly storage;
-    private readonly document;
-    /**
-     * Current theme. Prefer reading via `theme()` in templates / computed values
-     * rather than caching the string, so dark-class consumers stay in sync.
-     */
-    readonly theme: i0.WritableSignal<Theme>;
-    constructor();
-    /**
-     * Sets and persists the theme, updating the `dark` class and `color-scheme`
-     * on `<html>`.
-     *
-     * @param theme - Absolute preference to store.
-     */
-    setTheme(theme: Theme): void;
-    /**
-     * Flips between light and dark.
-     *
-     * @returns The theme after the toggle.
-     */
-    toggle(): Theme;
-    private resolveInitialTheme;
-    private prefersDark;
-    private applyToDocument;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ThemeService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ThemeService>;
-}
-
-export { MODE_COLOR_SAFELIST, ModeColorService, ThemeService };
-export type { ModeColorClasses, Theme };