@progressive-development/pd-spa-helper 1.0.0 → 1.0.1

package/dist/service-provider/service-provider-model.d.ts

@@ -1,5 +1,6 @@
 import { FirebaseOptions } from 'firebase/app';
 import { TemplateResult } from 'lit';
+import { BgConfig } from '@progressive-development/pd-model';
 export declare const SC_INVALID_USER = -150;
 export declare const SC_TECHNICAL_FAILURE = -180;
 export declare class BusinessError extends Error {
@@ -31,13 +32,14 @@ export interface FunctionDefinition {
     fadeWindow: boolean;
     successTxt: string | TemplateResult;
     pendingTxt: string | TemplateResult;
-    param?: any;
+    /** Additional parameters passed to the function */
+    param?: Record<string, unknown>;
     redirect?: string;
     logoutOnFail?: boolean;
 }
 export interface FunctionParam {
     func: FunctionDefinition;
-    inputData: any;
+    inputData: unknown;
 }
 export interface FunctionsConfig {
     region: string;
@@ -52,6 +54,7 @@ export interface MenuElement {
     name: string;
     sec?: string;
     route?: string;
+    requiredRoles?: string[];
     action?: () => void;
     topItem?: boolean;
     ref?: HTMLElement;
@@ -63,6 +66,8 @@ export interface NavigationPage {
     pattern: Array<string>;
     auth: boolean;
     authFallback?: string;
+    /** Required roles (claims) for this page - user must have at least one (OR logic) */
+    roles?: string[];
     menu?: Array<MenuElement>;
     topMenu?: Array<MenuElement>;
     withTeaser?: boolean;
@@ -71,11 +76,17 @@ export interface NavigationPage {
     hideTopMenu?: boolean;
     topMenuItems?: Array<MenuElement>;
     menuLogoRoute?: string;
+    /** Top menu display mode: "integrated" (shared bg) or "detached" (own bg). Default: "detached" */
+    topMenuMode?: "integrated" | "detached";
+    /** Background config for pd-site-header (color, gradient, or image with overlay). */
+    bgConfig?: BgConfig;
 }
 export interface NavigationConfig {
     pages: Array<NavigationPage>;
     includeLogin: boolean;
     defaultPostLoginRoute?: boolean;
+    /** Route to redirect to after logout. Defaults to "/" (home) */
+    logoutRedirect?: string;
 }
 export interface LinkObj {
     name: string;
@@ -83,15 +94,44 @@ export interface LinkObj {
     link?: string;
     action?: () => void;
 }
+export interface FooterSection {
+    heading: string;
+    links: LinkObj[];
+}
+export interface FooterSocialLink {
+    providerId: string;
+    value: string;
+    label?: string;
+}
 export interface Footer {
-    version: string;
+    sections?: FooterSection[];
+    socialLinks?: FooterSocialLink[];
+    legalLinks?: LinkObj[];
     copyright?: string;
-    links: Array<LinkObj>;
-}
+    version?: string;
+    showVersion?: boolean;
+    madeBy?: {
+        txt: string;
+        email?: string;
+        link?: string;
+    };
+    /** Background config for pd-footer (color, gradient, or image with overlay). */
+    bgConfig?: BgConfig;
+}
+/** mini-rx-store reducer function type */
+export type ReducerFunction<S = unknown> = (state: S, action: {
+    type: string;
+    payload?: unknown;
+}) => S;
 export interface StoreConfig {
     appName: string;
-    reducer: any;
-    effects: Array<any>;
+    /** Reducers object passed to mini-rx-store configureStore */
+    reducer: Record<string, ReducerFunction>;
+    /**
+     * Effect functions for mini-rx-store.
+     * Uses unknown[] as mini-rx-store expects Observable<any> internally.
+     */
+    effects: unknown[];
 }
 export interface FileStorage {
     name: string;
@@ -106,7 +146,7 @@ export interface MessagingConfig {
 export interface AppConfiguration {
     serviceProvider?: ServiceProviderConfiguration;
     mock?: {
-        mockResponse?: Map<string, (functionInput: any) => FunctionResult>;
+        mockResponse?: Map<string, (functionInput: unknown) => FunctionResult>;
         mockWaitTime?: number;
     };
     navigationConfigParam: NavigationConfig;
@@ -115,6 +155,8 @@ export interface AppConfiguration {
     storageConfig?: FileStorageConfig;
     functionsConfig?: FunctionsConfig;
     messagingConfig?: MessagingConfig;
+    /** Default loader style for pd-loading-state. Default: "spinner" */
+    defaultLoaderStyle?: "spinner" | "dots" | "pulse" | "logo";
 }
 export interface UploadFile {
     fileName: string;
@@ -139,12 +181,15 @@ export interface StorageDocument {
     creator?: string;
     size?: number;
     readonly?: boolean;
-    metaData?: any;
+    /** Firebase FullMetadata or custom metadata object */
+    metaData?: unknown;
 }
+/** Firestore query constraint value types */
+export type FirestoreValueType = string | number | boolean | null | Date | FirestoreValueType[];
 export interface CollectionContraint {
     type: "where";
     field: string;
     operator: "<" | ">" | ">=" | "<=" | "==" | "!=" | "array-contains" | "array-contains-any" | "in" | "not-in";
-    value: any;
+    value: FirestoreValueType;
 }
 //# sourceMappingURL=service-provider-model.d.ts.map

package/dist/service-provider/service-provider-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-provider-model.d.ts","sourceRoot":"","sources":["../../src/service-provider/service-provider-model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service-provider-model.d.ts","sourceRoot":"","sources":["../../src/service-provider/service-provider-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAElE,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAA6B;CAMjE;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC;AACjD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACzC,MAAM,MAAM,4BAA4B,GACpC,uBAAuB,GACvB,mBAAmB,CAAC;AAExB,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE5B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,cAAc,CAAC;IACpC,UAAU,EAAE,MAAM,GAAG,cAAc,CAAC;IACpC,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,kBAAkB,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACrC,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC;AAED;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kGAAkG;IAClG,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC,qFAAqF;IACrF,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,gFAAgF;IAChF,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,0CAA0C;AAC1C,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI,CACzC,KAAK,EAAE,CAAC,EACR,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,KACxC,CAAC,CAAC;AAEP,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACzC;;;OAGG;IACH,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,4BAA4B,CAAC;IAC/C,IAAI,CAAC,EAAE;QACL,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,OAAO,KAAK,cAAc,CAAC,CAAC;QACvE,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,qBAAqB,EAAE,gBAAgB,CAAC;IACxC,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAC/B,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CAC5D;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,6CAA6C;AAC7C,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,IAAI,GACJ,kBAAkB,EAAE,CAAC;AAEzB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EACJ,GAAG,GACH,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,gBAAgB,GAChB,oBAAoB,GACpB,IAAI,GACJ,QAAQ,CAAC;IACb,KAAK,EAAE,kBAAkB,CAAC;CAC3B"}

package/dist/services/fire-once-service.d.ts

@@ -0,0 +1,35 @@
+import { Action } from 'ts-action';
+declare class FireOnceService {
+    private _firedKeys;
+    /**
+     * Execute an action only if it hasn't been fired before for the given key.
+     *
+     * @param key - Unique identifier for this fire-once action
+     * @param action - The action to dispatch
+     * @returns true if action was dispatched, false if already fired
+     */
+    fireOnce(key: string, action: Action): boolean;
+    /**
+     * Check if a key has been fired.
+     *
+     * @param key - The key to check
+     * @returns true if the key has been fired
+     */
+    hasFired(key: string): boolean;
+    /**
+     * Reset a specific key or all keys.
+     * Useful for logout scenarios or testing.
+     *
+     * @param key - Optional key to reset. If not provided, resets all keys.
+     */
+    reset(key?: string): void;
+    /**
+     * Get all fired keys (for debugging).
+     *
+     * @returns Array of all fired keys
+     */
+    getFiredKeys(): string[];
+}
+export declare const fireOnceService: FireOnceService;
+export {};
+//# sourceMappingURL=fire-once-service.d.ts.map

package/dist/services/fire-once-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fire-once-service.d.ts","sourceRoot":"","sources":["../../src/services/fire-once-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAIxC,cAAM,eAAe;IACnB,OAAO,CAAC,UAAU,CAAqB;IAEvC;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAY9C;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAUzB;;;;OAIG;IACH,YAAY,IAAI,MAAM,EAAE;CAGzB;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/services/fire-once-service.js

@@ -0,0 +1,61 @@
+import { pdStore } from '../store/mini-rx.store.js';
+import { createLogger } from '../helper/logger.js';
+
+const logger = createLogger("FireOnceService");
+class FireOnceService {
+  constructor() {
+    this._firedKeys = /* @__PURE__ */ new Set();
+  }
+  /**
+   * Execute an action only if it hasn't been fired before for the given key.
+   *
+   * @param key - Unique identifier for this fire-once action
+   * @param action - The action to dispatch
+   * @returns true if action was dispatched, false if already fired
+   */
+  fireOnce(key, action) {
+    if (this._firedKeys.has(key)) {
+      logger.debug(`Key already fired, skipping: ${key}`);
+      return false;
+    }
+    this._firedKeys.add(key);
+    pdStore().dispatch(action);
+    logger.debug(`Action fired for key: ${key}`);
+    return true;
+  }
+  /**
+   * Check if a key has been fired.
+   *
+   * @param key - The key to check
+   * @returns true if the key has been fired
+   */
+  hasFired(key) {
+    return this._firedKeys.has(key);
+  }
+  /**
+   * Reset a specific key or all keys.
+   * Useful for logout scenarios or testing.
+   *
+   * @param key - Optional key to reset. If not provided, resets all keys.
+   */
+  reset(key) {
+    if (key) {
+      this._firedKeys.delete(key);
+      logger.debug(`Reset key: ${key}`);
+    } else {
+      this._firedKeys.clear();
+      logger.debug("Reset all keys");
+    }
+  }
+  /**
+   * Get all fired keys (for debugging).
+   *
+   * @returns Array of all fired keys
+   */
+  getFiredKeys() {
+    return Array.from(this._firedKeys);
+  }
+}
+const fireOnceService = new FireOnceService();
+
+export { fireOnceService };

package/dist/store/async-action-effects.d.ts

@@ -0,0 +1,179 @@
+import { Action } from 'ts-action';
+import { AsyncActionGroupBase } from './async-action-utils.js';
+export interface LoadingEffectOptions {
+    /** Show modal overlay (default: false) */
+    modal?: boolean;
+    /** Show small background loader (default: false) */
+    smallBackground?: boolean;
+}
+export interface ErrorToastOptions {
+    /** Custom function to get error message from error code */
+    getErrorMessage?: (code: number) => string;
+    /** Default error message when code not found */
+    defaultErrorMessage?: string;
+    /** Toast duration in ms (default: -1 = persistent, user must close manually) */
+    duration?: number;
+}
+export interface SuccessToastOptions {
+    /** Default toast duration in ms (default: 4000) */
+    defaultDuration?: number;
+}
+/**
+ * Creates an effect that adds loading state when async actions start.
+ *
+ * @param groups - Array of async action groups to monitor
+ * @param options - Loading state display options
+ * @returns Effect that dispatches addLoadingState actions
+ *
+ * @example
+ * ```typescript
+ * // Modal loading for specific groups
+ * export const modalLoadingEffect = createLoadingEffect(
+ *   [loadProfile, saveProfile],
+ *   { modal: true }
+ * );
+ *
+ * // Background loading for other groups
+ * export const bgLoadingEffect = createLoadingEffect(
+ *   [loadEvents, loadRequests],
+ *   { smallBackground: true }
+ * );
+ * ```
+ */
+export declare function createLoadingEffect(groups: AsyncActionGroupBase[], options?: LoadingEffectOptions): import('rxjs').Observable<{
+    payload: import('@progressive-development/pd-content').LoadingState;
+} & {
+    type: "SPA_APP_ADD_LOADING";
+}> & import('mini-rx-store/lib/models.js').HasEffectMetadata;
+/**
+ * Creates an effect that removes loading state when async actions complete.
+ *
+ * @param groups - Array of async action groups to monitor
+ * @returns Effect that dispatches removeLoadingState actions
+ *
+ * @example
+ * ```typescript
+ * export const removeLoadingEffect = createRemoveLoadingEffect([
+ *   loadProfile, saveProfile, loadEvents, loadRequests
+ * ]);
+ * ```
+ */
+export declare function createRemoveLoadingEffect(groups: AsyncActionGroupBase[]): import('rxjs').Observable<{
+    payload: string;
+} & {
+    type: "SPA_APP_REMOVE_LOADING";
+}> & import('mini-rx-store/lib/models.js').HasEffectMetadata;
+/**
+ * Creates an effect that shows success toast when async actions succeed.
+ * Only shows toast if successTxt is defined and non-empty.
+ *
+ * @param groups - Array of async action groups to monitor
+ * @param options - Toast display options
+ * @returns Non-dispatching effect (uses toastBus directly)
+ *
+ * @example
+ * ```typescript
+ * export const successToastEffect = createSuccessToastEffect([
+ *   saveProfile,  // Has successTxt: "Profile saved!"
+ *   loadProfile,  // Has successTxt: "" (no toast)
+ * ]);
+ * ```
+ */
+export declare function createSuccessToastEffect(groups: AsyncActionGroupBase[], options?: SuccessToastOptions): import('rxjs').Observable<Action<string>> & import('mini-rx-store/lib/models.js').HasEffectMetadata;
+/**
+ * Creates an effect that shows error toast when async actions fail.
+ * Handles BusinessError to show appropriate error messages.
+ *
+ * @param groups - Array of async action groups to monitor
+ * @param options - Error handling options
+ * @returns Non-dispatching effect (uses toastBus directly)
+ *
+ * @example
+ * ```typescript
+ * export const errorToastEffect = createErrorToastEffect(
+ *   [loadProfile, saveProfile],
+ *   {
+ *     getErrorMessage: (code) => {
+ *       const messages: Record<number, string> = {
+ *         [-150]: "Access denied",
+ *         [-180]: "Technical error",
+ *       };
+ *       return messages[code] || "An error occurred";
+ *     },
+ *   }
+ * );
+ * ```
+ */
+export declare function createErrorToastEffect(groups: AsyncActionGroupBase[], options?: ErrorToastOptions): import('rxjs').Observable<Action<string> & {
+    payload?: unknown;
+}> & import('mini-rx-store/lib/models.js').HasEffectMetadata;
+/**
+ * Options for creating all loading-related effects at once.
+ */
+export interface CreateLoadingEffectsOptions {
+    /** Groups that show modal loading */
+    modalGroups?: AsyncActionGroupBase[];
+    /** Groups that show background loading */
+    backgroundGroups?: AsyncActionGroupBase[];
+    /** Groups that show success toasts */
+    successToastGroups?: AsyncActionGroupBase[];
+    /** All groups for error handling */
+    errorGroups?: AsyncActionGroupBase[];
+    /** Error message resolver */
+    getErrorMessage?: (code: number) => string;
+    /** Default error message */
+    defaultErrorMessage?: string;
+}
+/**
+ * Creates all standard loading-related effects at once.
+ * Returns an object with all effects that can be spread into the effects array.
+ *
+ * @example
+ * ```typescript
+ * const {
+ *   modalLoadingEffect,
+ *   bgLoadingEffect,
+ *   removeLoadingEffect,
+ *   successToastEffect,
+ *   errorToastEffect
+ * } = createAllLoadingEffects({
+ *   modalGroups: [loadProfile, saveProfile],
+ *   backgroundGroups: [loadEvents],
+ *   successToastGroups: [saveProfile],
+ *   errorGroups: [loadProfile, saveProfile, loadEvents],
+ *   getErrorMessage: myErrorMessageFn,
+ * });
+ *
+ * // In store config:
+ * effects: [
+ *   modalLoadingEffect,
+ *   bgLoadingEffect,
+ *   removeLoadingEffect,
+ *   successToastEffect,
+ *   errorToastEffect,
+ *   // ... other effects
+ * ]
+ * ```
+ */
+export declare function createAllLoadingEffects(options: CreateLoadingEffectsOptions): {
+    modalLoadingEffect: (import('rxjs').Observable<{
+        payload: import('@progressive-development/pd-content').LoadingState;
+    } & {
+        type: "SPA_APP_ADD_LOADING";
+    }> & import('mini-rx-store/lib/models.js').HasEffectMetadata) | null;
+    bgLoadingEffect: (import('rxjs').Observable<{
+        payload: import('@progressive-development/pd-content').LoadingState;
+    } & {
+        type: "SPA_APP_ADD_LOADING";
+    }> & import('mini-rx-store/lib/models.js').HasEffectMetadata) | null;
+    removeLoadingEffect: (import('rxjs').Observable<{
+        payload: string;
+    } & {
+        type: "SPA_APP_REMOVE_LOADING";
+    }> & import('mini-rx-store/lib/models.js').HasEffectMetadata) | null;
+    successToastEffect: (import('rxjs').Observable<Action<string>> & import('mini-rx-store/lib/models.js').HasEffectMetadata) | null;
+    errorToastEffect: (import('rxjs').Observable<Action<string> & {
+        payload?: unknown;
+    }> & import('mini-rx-store/lib/models.js').HasEffectMetadata) | null;
+};
+//# sourceMappingURL=async-action-effects.d.ts.map

package/dist/store/async-action-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-action-effects.d.ts","sourceRoot":"","sources":["../../src/store/async-action-effects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAKxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAOpE,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oDAAoD;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,gDAAgD;IAChD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,oBAAoB,EAAE,EAC9B,OAAO,GAAE,oBAAyB;;;;6DAqBnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,oBAAoB,EAAE;;;;6DAevE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,oBAAoB,EAAE,EAC9B,OAAO,GAAE,mBAAwB,uGAoBlC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,EAAE,EAC9B,OAAO,GAAE,iBAAsB;cASO,OAAO;6DAmB9C;AAMD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,qCAAqC;IACrC,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACrC,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAC1C,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAC5C,oCAAoC;IACpC,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACrC,6BAA6B;IAC7B,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,4BAA4B;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,2BAA2B;;;;;;;;;;;;;;;;;;kBA1EpC,OAAO;;EAoG9C"}

package/dist/store/async-action-effects.js

@@ -0,0 +1,98 @@
+import { createEffect, actions$ } from 'mini-rx-store';
+import { filter, tap, map } from 'rxjs/operators';
+import { toastBus } from '@progressive-development/pd-page';
+import { addLoadingState, removeLoadingState } from './spa-app-actions.js';
+import { isBusinessError } from '../service-provider/function-utils.js';
+import { getConfigForAction } from './async-action-utils.js';
+
+function createLoadingEffect(groups, options = {}) {
+  const startTypes = groups.map((g) => g.types.action);
+  return createEffect(
+    actions$.pipe(
+      filter((action) => startTypes.includes(action.type)),
+      map((action) => {
+        const config = getConfigForAction(action, groups);
+        return addLoadingState({
+          actionKey: config?.actionKey || "unknown",
+          loadingTxt: config?.loadingTxt || "Loading...",
+          isLoading: true,
+          modal: options.modal ?? config?.modal ?? false,
+          smallBackground: options.smallBackground ?? config?.smallBackground ?? false,
+          loaderStyle: config?.loaderStyle
+        });
+      })
+    )
+  );
+}
+function createRemoveLoadingEffect(groups) {
+  const completionTypes = groups.flatMap((g) => [
+    g.types.success,
+    g.types.fail
+  ]);
+  return createEffect(
+    actions$.pipe(
+      filter((action) => completionTypes.includes(action.type)),
+      map((action) => {
+        const config = getConfigForAction(action, groups);
+        return removeLoadingState(config?.actionKey || "unknown");
+      })
+    )
+  );
+}
+function createSuccessToastEffect(groups, options = {}) {
+  const successTypes = groups.filter((g) => g.config.successTxt).map((g) => g.types.success);
+  return createEffect(
+    actions$.pipe(
+      filter((action) => successTypes.includes(action.type)),
+      tap((action) => {
+        const config = getConfigForAction(action, groups);
+        if (config?.successTxt) {
+          const duration = config.successDuration || options.defaultDuration || 4e3;
+          toastBus.success(config.successTxt, duration);
+        }
+      })
+    ),
+    { dispatch: false }
+  );
+}
+function createErrorToastEffect(groups, options = {}) {
+  const failTypes = groups.map((g) => g.types.fail);
+  const defaultMessage = options.defaultErrorMessage || "An error occurred";
+  const duration = options.duration ?? -1;
+  return createEffect(
+    actions$.pipe(
+      filter((action) => failTypes.includes(action.type)),
+      tap((action) => {
+        const error = action.payload;
+        let message;
+        if (isBusinessError(error)) {
+          message = options.getErrorMessage ? options.getErrorMessage(error.code) : error.message || defaultMessage;
+        } else if (error instanceof Error) {
+          message = error.message || defaultMessage;
+        } else {
+          message = defaultMessage;
+        }
+        toastBus.error(message, duration);
+      })
+    ),
+    { dispatch: false }
+  );
+}
+function createAllLoadingEffects(options) {
+  const allGroups = [
+    ...options.modalGroups || [],
+    ...options.backgroundGroups || []
+  ];
+  return {
+    modalLoadingEffect: options.modalGroups?.length ? createLoadingEffect(options.modalGroups, { modal: true }) : null,
+    bgLoadingEffect: options.backgroundGroups?.length ? createLoadingEffect(options.backgroundGroups, { smallBackground: true }) : null,
+    removeLoadingEffect: allGroups.length ? createRemoveLoadingEffect(allGroups) : null,
+    successToastEffect: options.successToastGroups?.length ? createSuccessToastEffect(options.successToastGroups) : null,
+    errorToastEffect: options.errorGroups?.length ? createErrorToastEffect(options.errorGroups, {
+      getErrorMessage: options.getErrorMessage,
+      defaultErrorMessage: options.defaultErrorMessage
+    }) : null
+  };
+}
+
+export { createAllLoadingEffects, createErrorToastEffect, createLoadingEffect, createRemoveLoadingEffect, createSuccessToastEffect };