@africanies/angular-web-sdk 0.1.12 → 0.1.13

package/.nx/cache/16704640000606796352/dist/libs/africanies-storage/fesm2022/africanies-africanies-storage.mjs

@@ -0,0 +1,249 @@
+import * as i0 from '@angular/core';
+import { Injectable, InjectionToken, inject, makeEnvironmentProviders } from '@angular/core';
+
+/**
+ * Browser key-value persistence abstraction used by theme, shipping mode,
+ * and auth token flows.
+ *
+ * Implementations JSON-serialize values so callers work with typed objects
+ * rather than raw strings. Prefer injecting via {@link STORAGE_TOKEN} so
+ * tests can swap in an in-memory fake.
+ */
+class StorageService {
+}
+
+/**
+ * JSON helpers over the Web Storage API.
+ *
+ * Kept internal so Local/Session services stay thin; failure modes are
+ * documented on {@link StorageService} for consumers.
+ */
+/**
+ * @param store - `localStorage` or `sessionStorage`.
+ * @param key - Key to read.
+ * @returns Parsed value, or `null` when missing/empty.
+ */
+function readJson(store, key) {
+    const raw = store.getItem(key);
+    if (raw === null || raw === '') {
+        return null;
+    }
+    return JSON.parse(raw);
+}
+/**
+ * @param store - `localStorage` or `sessionStorage`.
+ * @param key - Key to write.
+ * @param value - JSON-serializable value.
+ */
+function writeJson(store, key, value) {
+    store.setItem(key, JSON.stringify(value));
+}
+
+/**
+ * `localStorage`-backed {@link StorageService}.
+ *
+ * Default root implementation behind {@link STORAGE_TOKEN}. Values survive
+ * browser restarts for the origin.
+ *
+ * @example
+ * ```ts
+ * const storage = inject(LocalStorageService);
+ * try {
+ *   storage.set('user', { id: 1 });
+ * } catch (err) {
+ *   // QuotaExceededError or private-browsing denial
+ *   console.warn('persist failed', err);
+ * }
+ * ```
+ */
+/**
+ * `localStorage`-backed {@link StorageService}.
+ */
+class LocalStorageService extends StorageService {
+    /**
+     * @inheritdoc
+     * @throws {DOMException} Quota exceeded or storage disabled in private browsing.
+     * @throws {SyntaxError} Stored value is not valid JSON.
+     */
+    get(key) {
+        return readJson(localStorage, key);
+    }
+    /**
+     * @inheritdoc
+     * @throws {DOMException} Quota exceeded or storage disabled in private browsing.
+     * @throws {TypeError} Value is not JSON-serializable.
+     */
+    set(key, value) {
+        writeJson(localStorage, key, value);
+    }
+    /**
+     * @inheritdoc
+     * @throws {DOMException} When storage is inaccessible.
+     */
+    remove(key) {
+        localStorage.removeItem(key);
+    }
+    /**
+     * @inheritdoc
+     * @throws {DOMException} When storage is inaccessible.
+     */
+    clear() {
+        localStorage.clear();
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: LocalStorageService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: LocalStorageService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: LocalStorageService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * `sessionStorage`-backed {@link StorageService}.
+ *
+ * Scope is limited to the current tab/window lifetime — use when values must
+ * not outlive the session (e.g. ephemeral UI flags). Register via
+ * {@link provideSessionStorage} to bind {@link STORAGE_TOKEN} to this class.
+ *
+ * @example
+ * ```ts
+ * // app.config.ts
+ * providers: [provideSessionStorage()]
+ *
+ * // elsewhere
+ * const storage = inject(STORAGE_TOKEN);
+ * try {
+ *   storage.set('wizard.step', 2);
+ * } catch (err) {
+ *   // QuotaExceededError or private-browsing denial
+ * }
+ * ```
+ */
+/**
+ * `sessionStorage`-backed {@link StorageService}.
+ */
+class SessionStorageService extends StorageService {
+    /**
+     * @inheritdoc
+     * @throws {DOMException} Quota exceeded or storage disabled in private browsing.
+     * @throws {SyntaxError} Stored value is not valid JSON.
+     */
+    get(key) {
+        return readJson(sessionStorage, key);
+    }
+    /**
+     * @inheritdoc
+     * @throws {DOMException} Quota exceeded or storage disabled in private browsing.
+     * @throws {TypeError} Value is not JSON-serializable.
+     */
+    set(key, value) {
+        writeJson(sessionStorage, key, value);
+    }
+    /**
+     * @inheritdoc
+     * @throws {DOMException} When storage is inaccessible.
+     */
+    remove(key) {
+        sessionStorage.removeItem(key);
+    }
+    /**
+     * @inheritdoc
+     * @throws {DOMException} When storage is inaccessible.
+     */
+    clear() {
+        sessionStorage.clear();
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: SessionStorageService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: SessionStorageService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: SessionStorageService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * DI token for the active {@link StorageService} implementation.
+ *
+ * Defaults to {@link LocalStorageService} via `providedIn: 'root'`. Override
+ * in tests or at bootstrap with {@link provideSessionStorage} /
+ * {@link provideLocalStorage}.
+ *
+ * @example
+ * ```ts
+ * const storage = inject(STORAGE_TOKEN);
+ * storage.set('prefs', { dense: true });
+ * ```
+ */
+const STORAGE_TOKEN = new InjectionToken('AFRICANIES_STORAGE', {
+    providedIn: 'root',
+    factory: () => inject(LocalStorageService),
+});
+
+/**
+ * Explicitly binds {@link STORAGE_TOKEN} to {@link LocalStorageService}.
+ *
+ * Redundant with the token's root factory, but useful when an app previously
+ * registered session storage and needs to switch back, or for clarity in
+ * `app.config.ts`.
+ *
+ * @returns Environment providers wiring `STORAGE_TOKEN` → localStorage.
+ *
+ * @example
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [provideLocalStorage()],
+ * });
+ * ```
+ */
+function provideLocalStorage() {
+    return makeEnvironmentProviders([
+        LocalStorageService,
+        { provide: STORAGE_TOKEN, useExisting: LocalStorageService },
+    ]);
+}
+/**
+ * Binds {@link STORAGE_TOKEN} to {@link SessionStorageService}.
+ *
+ * Prefer this when SDK consumers (theme, auth token) should persist only
+ * for the current tab rather than across sessions.
+ *
+ * Shipping mode always uses {@link SessionStorageService} directly and is
+ * unaffected by this override.
+ *
+ * @returns Environment providers wiring `STORAGE_TOKEN` → sessionStorage.
+ *
+ * @example
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [provideSessionStorage()],
+ * });
+ * ```
+ */
+function provideSessionStorage() {
+    return makeEnvironmentProviders([
+        SessionStorageService,
+        { provide: STORAGE_TOKEN, useExisting: SessionStorageService },
+    ]);
+}
+
+/**
+ * Well-known local/session storage keys used across AFRICANIES SDK packages.
+ *
+ * Centralizing these avoids typos between theme, shipping-mode, and
+ * auth persistence layers that all go through {@link StorageService}.
+ */
+/** Persisted UI theme preference (`'light' | 'dark'` or equivalent). */
+const AFRICANIES_THEME_KEY = 'africanies.theme';
+/** Tab-scoped shipping mode (`'stn' | 'sfn'`) — {@link SessionStorageService}. */
+const AFRICANIES_SHIPPING_MODE_KEY = 'africanies.shippingMode';
+/** Cached public mode-config payload (mapped {@link ModeConfigDataModel}). */
+const AFRICANIES_MODE_CONFIG_KEY = 'africanies.modeConfig';
+/** Persisted bearer access token for authenticated SDK HTTP calls. */
+const AFRICANIES_ACCESS_TOKEN_KEY = 'africanies.accessToken';
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { AFRICANIES_ACCESS_TOKEN_KEY, AFRICANIES_MODE_CONFIG_KEY, AFRICANIES_SHIPPING_MODE_KEY, AFRICANIES_THEME_KEY, LocalStorageService, STORAGE_TOKEN, SessionStorageService, StorageService, provideLocalStorage, provideSessionStorage };
+//# sourceMappingURL=africanies-africanies-storage.mjs.map

package/.nx/cache/16704640000606796352/dist/libs/africanies-storage/fesm2022/africanies-africanies-storage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"africanies-africanies-storage.mjs","sources":["../../../../libs/africanies-storage/src/lib/storage.service.ts","../../../../libs/africanies-storage/src/lib/storage-json.ts","../../../../libs/africanies-storage/src/lib/local-storage.service.ts","../../../../libs/africanies-storage/src/lib/session-storage.service.ts","../../../../libs/africanies-storage/src/lib/storage.token.ts","../../../../libs/africanies-storage/src/lib/provide-storage.ts","../../../../libs/africanies-storage/src/lib/storage.keys.ts","../../../../libs/africanies-storage/src/africanies-africanies-storage.ts"],"sourcesContent":["/**\n * Browser key-value persistence abstraction used by theme, shipping mode,\n * and auth token flows.\n *\n * Implementations JSON-serialize values so callers work with typed objects\n * rather than raw strings. Prefer injecting via {@link STORAGE_TOKEN} so\n * tests can swap in an in-memory fake.\n */\nexport abstract class StorageService {\n  /**\n   * Reads and deserializes a previously stored value.\n   *\n   * @typeParam T - Expected value type after JSON parse.\n   * @param key - Storage key.\n   * @returns The parsed value, or `null` when the key is missing or empty.\n   * @throws {DOMException} When storage is inaccessible (e.g. private browsing\n   *   with storage disabled) or when reading fails for security reasons.\n   * @throws {SyntaxError} When stored content is not valid JSON.\n   */\n  abstract get<T>(key: string): T | null;\n\n  /**\n   * Serializes and writes a value under `key`.\n   *\n   * @typeParam T - Value type to persist (must be JSON-serializable).\n   * @param key - Storage key.\n   * @param value - Value to serialize with `JSON.stringify`.\n   * @throws {DOMException} `QuotaExceededError` when the storage quota is\n   *   exceeded, or when storage is disabled (private browsing).\n   * @throws {TypeError} When `value` cannot be serialized to JSON\n   *   (e.g. circular structures).\n   */\n  abstract set<T>(key: string, value: T): void;\n\n  /**\n   * Removes a single key if present.\n   *\n   * @param key - Storage key to delete.\n   * @throws {DOMException} When storage is inaccessible.\n   */\n  abstract remove(key: string): void;\n\n  /**\n   * Removes all keys in this storage partition.\n   *\n   * @throws {DOMException} When storage is inaccessible.\n   */\n  abstract clear(): void;\n}\n","/**\n * JSON helpers over the Web Storage API.\n *\n * Kept internal so Local/Session services stay thin; failure modes are\n * documented on {@link StorageService} for consumers.\n */\n\n/**\n * @param store - `localStorage` or `sessionStorage`.\n * @param key - Key to read.\n * @returns Parsed value, or `null` when missing/empty.\n */\nexport function readJson<T>(store: Storage, key: string): T | null {\n  const raw = store.getItem(key);\n  if (raw === null || raw === '') {\n    return null;\n  }\n  return JSON.parse(raw) as T;\n}\n\n/**\n * @param store - `localStorage` or `sessionStorage`.\n * @param key - Key to write.\n * @param value - JSON-serializable value.\n */\nexport function writeJson<T>(store: Storage, key: string, value: T): void {\n  store.setItem(key, JSON.stringify(value));\n}\n","import { Injectable } from '@angular/core';\n\nimport { StorageService } from './storage.service';\nimport { readJson, writeJson } from './storage-json';\n\n/**\n * `localStorage`-backed {@link StorageService}.\n *\n * Default root implementation behind {@link STORAGE_TOKEN}. Values survive\n * browser restarts for the origin.\n *\n * @example\n * ```ts\n * const storage = inject(LocalStorageService);\n * try {\n *   storage.set('user', { id: 1 });\n * } catch (err) {\n *   // QuotaExceededError or private-browsing denial\n *   console.warn('persist failed', err);\n * }\n * ```\n */\n@Injectable({ providedIn: 'root' })\n/**\n * `localStorage`-backed {@link StorageService}.\n */\nexport class LocalStorageService extends StorageService {\n  /**\n   * @inheritdoc\n   * @throws {DOMException} Quota exceeded or storage disabled in private browsing.\n   * @throws {SyntaxError} Stored value is not valid JSON.\n   */\n  override get<T>(key: string): T | null {\n    return readJson<T>(localStorage, key);\n  }\n\n  /**\n   * @inheritdoc\n   * @throws {DOMException} Quota exceeded or storage disabled in private browsing.\n   * @throws {TypeError} Value is not JSON-serializable.\n   */\n  override set<T>(key: string, value: T): void {\n    writeJson(localStorage, key, value);\n  }\n\n  /**\n   * @inheritdoc\n   * @throws {DOMException} When storage is inaccessible.\n   */\n  override remove(key: string): void {\n    localStorage.removeItem(key);\n  }\n\n  /**\n   * @inheritdoc\n   * @throws {DOMException} When storage is inaccessible.\n   */\n  override clear(): void {\n    localStorage.clear();\n  }\n}\n","import { Injectable } from '@angular/core';\n\nimport { StorageService } from './storage.service';\nimport { readJson, writeJson } from './storage-json';\n\n/**\n * `sessionStorage`-backed {@link StorageService}.\n *\n * Scope is limited to the current tab/window lifetime — use when values must\n * not outlive the session (e.g. ephemeral UI flags). Register via\n * {@link provideSessionStorage} to bind {@link STORAGE_TOKEN} to this class.\n *\n * @example\n * ```ts\n * // app.config.ts\n * providers: [provideSessionStorage()]\n *\n * // elsewhere\n * const storage = inject(STORAGE_TOKEN);\n * try {\n *   storage.set('wizard.step', 2);\n * } catch (err) {\n *   // QuotaExceededError or private-browsing denial\n * }\n * ```\n */\n@Injectable({ providedIn: 'root' })\n/**\n * `sessionStorage`-backed {@link StorageService}.\n */\nexport class SessionStorageService extends StorageService {\n  /**\n   * @inheritdoc\n   * @throws {DOMException} Quota exceeded or storage disabled in private browsing.\n   * @throws {SyntaxError} Stored value is not valid JSON.\n   */\n  override get<T>(key: string): T | null {\n    return readJson<T>(sessionStorage, key);\n  }\n\n  /**\n   * @inheritdoc\n   * @throws {DOMException} Quota exceeded or storage disabled in private browsing.\n   * @throws {TypeError} Value is not JSON-serializable.\n   */\n  override set<T>(key: string, value: T): void {\n    writeJson(sessionStorage, key, value);\n  }\n\n  /**\n   * @inheritdoc\n   * @throws {DOMException} When storage is inaccessible.\n   */\n  override remove(key: string): void {\n    sessionStorage.removeItem(key);\n  }\n\n  /**\n   * @inheritdoc\n   * @throws {DOMException} When storage is inaccessible.\n   */\n  override clear(): void {\n    sessionStorage.clear();\n  }\n}\n","import { inject,InjectionToken } from '@angular/core';\n\nimport { LocalStorageService } from './local-storage.service';\nimport { StorageService } from './storage.service';\n\n/**\n * DI token for the active {@link StorageService} implementation.\n *\n * Defaults to {@link LocalStorageService} via `providedIn: 'root'`. Override\n * in tests or at bootstrap with {@link provideSessionStorage} /\n * {@link provideLocalStorage}.\n *\n * @example\n * ```ts\n * const storage = inject(STORAGE_TOKEN);\n * storage.set('prefs', { dense: true });\n * ```\n */\nexport const STORAGE_TOKEN = new InjectionToken<StorageService>('AFRICANIES_STORAGE', {\n  providedIn: 'root',\n  factory: () => inject(LocalStorageService),\n});\n","import { type EnvironmentProviders, makeEnvironmentProviders } from '@angular/core';\n\nimport { LocalStorageService } from './local-storage.service';\nimport { SessionStorageService } from './session-storage.service';\nimport { STORAGE_TOKEN } from './storage.token';\n\n/**\n * Explicitly binds {@link STORAGE_TOKEN} to {@link LocalStorageService}.\n *\n * Redundant with the token's root factory, but useful when an app previously\n * registered session storage and needs to switch back, or for clarity in\n * `app.config.ts`.\n *\n * @returns Environment providers wiring `STORAGE_TOKEN` → localStorage.\n *\n * @example\n * ```ts\n * bootstrapApplication(App, {\n *   providers: [provideLocalStorage()],\n * });\n * ```\n */\nexport function provideLocalStorage(): EnvironmentProviders {\n  return makeEnvironmentProviders([\n    LocalStorageService,\n    { provide: STORAGE_TOKEN, useExisting: LocalStorageService },\n  ]);\n}\n\n/**\n * Binds {@link STORAGE_TOKEN} to {@link SessionStorageService}.\n *\n * Prefer this when SDK consumers (theme, auth token) should persist only\n * for the current tab rather than across sessions.\n *\n * Shipping mode always uses {@link SessionStorageService} directly and is\n * unaffected by this override.\n *\n * @returns Environment providers wiring `STORAGE_TOKEN` → sessionStorage.\n *\n * @example\n * ```ts\n * bootstrapApplication(App, {\n *   providers: [provideSessionStorage()],\n * });\n * ```\n */\nexport function provideSessionStorage(): EnvironmentProviders {\n  return makeEnvironmentProviders([\n    SessionStorageService,\n    { provide: STORAGE_TOKEN, useExisting: SessionStorageService },\n  ]);\n}\n","/**\n * Well-known local/session storage keys used across AFRICANIES SDK packages.\n *\n * Centralizing these avoids typos between theme, shipping-mode, and\n * auth persistence layers that all go through {@link StorageService}.\n */\n\n/** Persisted UI theme preference (`'light' | 'dark'` or equivalent). */\nexport const AFRICANIES_THEME_KEY = 'africanies.theme';\n\n/** Tab-scoped shipping mode (`'stn' | 'sfn'`) — {@link SessionStorageService}. */\nexport const AFRICANIES_SHIPPING_MODE_KEY = 'africanies.shippingMode';\n\n/** Cached public mode-config payload (mapped {@link ModeConfigDataModel}). */\nexport const AFRICANIES_MODE_CONFIG_KEY = 'africanies.modeConfig';\n\n/** Persisted bearer access token for authenticated SDK HTTP calls. */\nexport const AFRICANIES_ACCESS_TOKEN_KEY = 'africanies.accessToken';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/.nx/cache/16704640000606796352/dist/libs/africanies-storage/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@africanies/africanies-storage",
+  "version": "0.0.1",
+  "peerDependencies": {
+    "@angular/core": "^22.0.0"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "fesm2022/africanies-africanies-storage.mjs",
+  "typings": "types/africanies-africanies-storage.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/africanies-africanies-storage.d.ts",
+      "default": "./fesm2022/africanies-africanies-storage.mjs"
+    }
+  },
+  "type": "module",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/.nx/cache/16704640000606796352/dist/libs/africanies-storage/types/africanies-africanies-storage.d.ts

@@ -0,0 +1,210 @@
+import * as i0 from '@angular/core';
+import { EnvironmentProviders, InjectionToken } from '@angular/core';
+
+/**
+ * Browser key-value persistence abstraction used by theme, shipping mode,
+ * and auth token flows.
+ *
+ * Implementations JSON-serialize values so callers work with typed objects
+ * rather than raw strings. Prefer injecting via {@link STORAGE_TOKEN} so
+ * tests can swap in an in-memory fake.
+ */
+declare abstract class StorageService {
+    /**
+     * Reads and deserializes a previously stored value.
+     *
+     * @typeParam T - Expected value type after JSON parse.
+     * @param key - Storage key.
+     * @returns The parsed value, or `null` when the key is missing or empty.
+     * @throws {DOMException} When storage is inaccessible (e.g. private browsing
+     *   with storage disabled) or when reading fails for security reasons.
+     * @throws {SyntaxError} When stored content is not valid JSON.
+     */
+    abstract get<T>(key: string): T | null;
+    /**
+     * Serializes and writes a value under `key`.
+     *
+     * @typeParam T - Value type to persist (must be JSON-serializable).
+     * @param key - Storage key.
+     * @param value - Value to serialize with `JSON.stringify`.
+     * @throws {DOMException} `QuotaExceededError` when the storage quota is
+     *   exceeded, or when storage is disabled (private browsing).
+     * @throws {TypeError} When `value` cannot be serialized to JSON
+     *   (e.g. circular structures).
+     */
+    abstract set<T>(key: string, value: T): void;
+    /**
+     * Removes a single key if present.
+     *
+     * @param key - Storage key to delete.
+     * @throws {DOMException} When storage is inaccessible.
+     */
+    abstract remove(key: string): void;
+    /**
+     * Removes all keys in this storage partition.
+     *
+     * @throws {DOMException} When storage is inaccessible.
+     */
+    abstract clear(): void;
+}
+
+/**
+ * `localStorage`-backed {@link StorageService}.
+ *
+ * Default root implementation behind {@link STORAGE_TOKEN}. Values survive
+ * browser restarts for the origin.
+ *
+ * @example
+ * ```ts
+ * const storage = inject(LocalStorageService);
+ * try {
+ *   storage.set('user', { id: 1 });
+ * } catch (err) {
+ *   // QuotaExceededError or private-browsing denial
+ *   console.warn('persist failed', err);
+ * }
+ * ```
+ */
+declare class LocalStorageService extends StorageService {
+    /**
+     * @inheritdoc
+     * @throws {DOMException} Quota exceeded or storage disabled in private browsing.
+     * @throws {SyntaxError} Stored value is not valid JSON.
+     */
+    get<T>(key: string): T | null;
+    /**
+     * @inheritdoc
+     * @throws {DOMException} Quota exceeded or storage disabled in private browsing.
+     * @throws {TypeError} Value is not JSON-serializable.
+     */
+    set<T>(key: string, value: T): void;
+    /**
+     * @inheritdoc
+     * @throws {DOMException} When storage is inaccessible.
+     */
+    remove(key: string): void;
+    /**
+     * @inheritdoc
+     * @throws {DOMException} When storage is inaccessible.
+     */
+    clear(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LocalStorageService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<LocalStorageService>;
+}
+
+/**
+ * Explicitly binds {@link STORAGE_TOKEN} to {@link LocalStorageService}.
+ *
+ * Redundant with the token's root factory, but useful when an app previously
+ * registered session storage and needs to switch back, or for clarity in
+ * `app.config.ts`.
+ *
+ * @returns Environment providers wiring `STORAGE_TOKEN` → localStorage.
+ *
+ * @example
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [provideLocalStorage()],
+ * });
+ * ```
+ */
+declare function provideLocalStorage(): EnvironmentProviders;
+/**
+ * Binds {@link STORAGE_TOKEN} to {@link SessionStorageService}.
+ *
+ * Prefer this when SDK consumers (theme, auth token) should persist only
+ * for the current tab rather than across sessions.
+ *
+ * Shipping mode always uses {@link SessionStorageService} directly and is
+ * unaffected by this override.
+ *
+ * @returns Environment providers wiring `STORAGE_TOKEN` → sessionStorage.
+ *
+ * @example
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [provideSessionStorage()],
+ * });
+ * ```
+ */
+declare function provideSessionStorage(): EnvironmentProviders;
+
+/**
+ * `sessionStorage`-backed {@link StorageService}.
+ *
+ * Scope is limited to the current tab/window lifetime — use when values must
+ * not outlive the session (e.g. ephemeral UI flags). Register via
+ * {@link provideSessionStorage} to bind {@link STORAGE_TOKEN} to this class.
+ *
+ * @example
+ * ```ts
+ * // app.config.ts
+ * providers: [provideSessionStorage()]
+ *
+ * // elsewhere
+ * const storage = inject(STORAGE_TOKEN);
+ * try {
+ *   storage.set('wizard.step', 2);
+ * } catch (err) {
+ *   // QuotaExceededError or private-browsing denial
+ * }
+ * ```
+ */
+declare class SessionStorageService extends StorageService {
+    /**
+     * @inheritdoc
+     * @throws {DOMException} Quota exceeded or storage disabled in private browsing.
+     * @throws {SyntaxError} Stored value is not valid JSON.
+     */
+    get<T>(key: string): T | null;
+    /**
+     * @inheritdoc
+     * @throws {DOMException} Quota exceeded or storage disabled in private browsing.
+     * @throws {TypeError} Value is not JSON-serializable.
+     */
+    set<T>(key: string, value: T): void;
+    /**
+     * @inheritdoc
+     * @throws {DOMException} When storage is inaccessible.
+     */
+    remove(key: string): void;
+    /**
+     * @inheritdoc
+     * @throws {DOMException} When storage is inaccessible.
+     */
+    clear(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SessionStorageService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SessionStorageService>;
+}
+
+/**
+ * Well-known local/session storage keys used across AFRICANIES SDK packages.
+ *
+ * Centralizing these avoids typos between theme, shipping-mode, and
+ * auth persistence layers that all go through {@link StorageService}.
+ */
+/** Persisted UI theme preference (`'light' | 'dark'` or equivalent). */
+declare const AFRICANIES_THEME_KEY = "africanies.theme";
+/** Tab-scoped shipping mode (`'stn' | 'sfn'`) — {@link SessionStorageService}. */
+declare const AFRICANIES_SHIPPING_MODE_KEY = "africanies.shippingMode";
+/** Cached public mode-config payload (mapped {@link ModeConfigDataModel}). */
+declare const AFRICANIES_MODE_CONFIG_KEY = "africanies.modeConfig";
+/** Persisted bearer access token for authenticated SDK HTTP calls. */
+declare const AFRICANIES_ACCESS_TOKEN_KEY = "africanies.accessToken";
+
+/**
+ * DI token for the active {@link StorageService} implementation.
+ *
+ * Defaults to {@link LocalStorageService} via `providedIn: 'root'`. Override
+ * in tests or at bootstrap with {@link provideSessionStorage} /
+ * {@link provideLocalStorage}.
+ *
+ * @example
+ * ```ts
+ * const storage = inject(STORAGE_TOKEN);
+ * storage.set('prefs', { dense: true });
+ * ```
+ */
+declare const STORAGE_TOKEN: InjectionToken<StorageService>;
+
+export { AFRICANIES_ACCESS_TOKEN_KEY, AFRICANIES_MODE_CONFIG_KEY, AFRICANIES_SHIPPING_MODE_KEY, AFRICANIES_THEME_KEY, LocalStorageService, STORAGE_TOKEN, SessionStorageService, StorageService, provideLocalStorage, provideSessionStorage };

package/.nx/cache/2427575433215940812/dist/libs/africanies-ui/README.md

@@ -0,0 +1,68 @@
+# @africanies/africanies-ui
+
+Standalone Angular UI for AFRICANIES apps — buttons, forms, filters, toasts, overlays,
+tables, and the rest. Styles come from the `@africanies/africanies-theme` Tailwind preset.
+
+## Install
+
+```bash
+npm install @africanies/africanies-ui @africanies/africanies-theme @africanies/africanies-icons @africanies/africanies-models @africanies/africanies-core
+```
+
+Peer stack: Angular 22+, `@angular/cdk`, `@angular/forms`, `/*` packages
+above. Configure Tailwind with the theme preset (see `@africanies/africanies-theme`).
+
+Import CDK overlay styles once in the app (needed for select dismiss / modal /
+drawer positioning):
+
+```css
+@import '@angular/cdk/overlay-prebuilt.css';
+```
+
+## Quick start
+
+```ts
+import { ApplicationConfig } from '@angular/core';
+import { provideAfricaniesUiOverlays, provideAfricaniesToasts, ButtonComponent } from '@africanies/africanies-ui';
+
+export const appConfig: ApplicationConfig = {
+  providers: [provideAfricaniesUiOverlays(), provideAfricaniesToasts()],
+};
+```
+
+```html
+<button africanies-button type="button" variant="primary">Save</button>
+<africanies-table
+  [columns]="columns"
+  [rows]="state().data ?? []"
+  [loading]="state().isLoading"
+  [error]="state().error"
+  emptyMessage="No results match these filters."
+/>
+```
+
+## Modules
+
+| Area | Highlights |
+| --- | --- |
+| Button | `button[africanies-button]` / `a[africanies-button]` |
+| Copy | `africanies-copy` — clipboard icon button (`copyToClipboard`) |
+| Action menu | `ActionMenu` (+ `africaniesActionMenuTrigger`) — overflow / row actions |
+| Avatar | `Avatar`, `AvatarMenu` — initials/image + account dropdown |
+| Feedback | `LoadingState`, `ErrorState`, `EmptyState`, `AsyncState`, `ErrorIndicator`, `Alert`, `Chip`, `Toast` (`provideAfricaniesToasts`) |
+| Filters | `FilterDrawerService`, `FilterQueryService` — hydrate/write list queries on the URL |
+| Overlay | `ModalService`, `DrawerService`, `ConfirmService`, `provideAfricaniesUiOverlays` |
+| Forms | Text, select, address (Places API New REST), number, file upload, checkbox, radio, toggle, textarea, date, OTP — address needs `provideGooglePlaces({ apiKey })` |
+| Navigation | `AppShell` (clock, notifications, avatar menu, page title + subtitle), `SideNav` (SDK logo), `ShippingModeSwitch`, `Breadcrumb`, `PageHeader`, `Tabs`, `Segment` |
+| Notifications | `NotificationDrawerService` — inbox drawer (via `DrawerService`) |
+| Data | `Table` (+ `africaniesCellDef`), `Pagination`, `Stepper` |
+| NgModules | `AfricaniesFormsModule`, `AfricaniesFeedbackModule`, `AfricaniesActionsModule`, `AfricaniesNavigationModule`, `AfricaniesTableModule`, `AfricaniesStepperModule`, `AfricaniesTooltipModule` — optional one-import facades over the standalones |
+
+Live examples: run the workspace playground (`npx nx serve playground`).
+
+## Build / test
+
+```bash
+npx nx build africanies-ui
+npx nx test africanies-ui
+```

package/.nx/cache/2427575433215940812/dist/libs/africanies-ui/assets/brand/africanies-logo.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 88 24" role="img" aria-label="AIES">
+  <rect x="0" y="2" width="20" height="20" rx="5" fill="#2563eb"/>
+  <path d="M6.2 16.5 10 7.5h1.6l3.8 9h-1.9l-.8-2H8.9l-.8 2H6.2Zm2.5-3.6h2.6l-1.3-3.4-1.3 3.4Z" fill="#ffffff"/>
+  <text x="26" y="17" font-family="system-ui, -apple-system, sans-serif" font-size="15" font-weight="700" fill="#111827">AIES</text>
+</svg>

package/.nx/cache/2427575433215940812/dist/libs/africanies-ui/assets/carriers/dhl.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" overflow="visible" version="1.0" viewBox="-26.3622 -9.6965 228.4724 58.179">
+  <path fill="#FECC00" d="M0 38.786V0h175.748v38.786z" />
+  <path
+    fill="#D50029"
+    d="M56.665 16.206c-.768 1.04-2.053 2.848-2.835 3.904-.397.537-1.114 1.512 1.263 1.512h12.515s2.017-2.744 3.708-5.039c2.3-3.122.199-9.618-8.024-9.618H30.908l-5.615 7.629h30.603c1.545 0 1.524.588.769 1.612zm-9.194 7.298c-2.377 0-1.66-.977-1.263-1.514.782-1.056 2.088-2.845 2.856-3.885.756-1.024.776-1.612-.771-1.612H34.297L23.02 31.819h27.501c9.083 0 14.14-6.178 15.699-8.314 0-.001-16.235-.001-18.749-.001zm17.89 8.315h16.133l6.116-8.316-16.131.002c-.005-.001-6.118 8.314-6.118 8.314zm41.625-24.854l-6.188 8.405h-7.2l6.185-8.405H83.655l-10.79 14.657h39.46l10.787-14.657zM88.694 31.819h16.127l6.119-8.314H94.813c-.006-.001-6.119 8.314-6.119 8.314zM0 26.784v1.766h22.468l1.298-1.766zm26.181-3.28H0v1.764h24.88zM0 31.819h20.061l1.292-1.756H0zm152.072-3.27h23.676v-1.766h-22.376zm-2.405 3.27h26.081v-1.756h-24.79zm6.116-8.315l-1.297 1.766h21.262v-1.766zm-21.124-1.882l10.789-14.657h-17.081c-.006 0-10.797 14.657-10.797 14.657zm-18.472 1.882s-1.179 1.611-1.752 2.387c-2.025 2.736-.234 5.928 6.376 5.928h25.901l6.119-8.314h-36.644z"
+  />
+</svg>