@progressive-development/pd-spa-helper 0.8.22 → 0.9.1

package/dist/service-provider/interfaces/IStorageProvider.d.ts

@@ -0,0 +1,118 @@
+/**
+ * File upload request
+ */
+export interface UploadFileRequest {
+    /** Target file name in storage */
+    fileName: string;
+    /** Base64 encoded file data URL */
+    base64DataURL: string;
+    /** Human-readable description name */
+    descriptionName: string;
+    /** Detailed description */
+    description: string;
+    /** Storage bucket/container name */
+    storageName: string;
+    /** Reference key for grouping files */
+    referenceKey: string;
+    /** Optional subfolder path */
+    subFolderName?: string;
+    /** Mark file as read-only */
+    readonly?: boolean;
+}
+/**
+ * Result of an upload operation
+ */
+export interface UploadResult {
+    /** Full storage path of uploaded file */
+    fullPath: string;
+    /** Download URL for the file */
+    downloadURL: string;
+}
+/**
+ * Stored document metadata
+ */
+export interface StorageDocument {
+    /** Storage bucket/container name */
+    storageName: string;
+    /** Reference key for grouping */
+    refKey: string;
+    /** File name */
+    fileName: string;
+    /** Full storage path */
+    filePath: string;
+    /** Optional subfolder */
+    subFolderName?: string;
+    /** MIME type or document type */
+    documentType?: string;
+    /** Human-readable description */
+    description?: string;
+    /** Description name */
+    descriptionName?: string;
+    /** Creation timestamp */
+    creation?: Date;
+    /** Creator user ID */
+    creator?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Read-only flag */
+    readonly?: boolean;
+    /** Additional metadata */
+    metaData?: unknown;
+}
+/**
+ * Options for listing files
+ */
+export interface ListFilesOptions {
+    /** Storage bucket name */
+    storageName: string;
+    /** Reference key for filtering */
+    referenceKey: string;
+    /** Optional subfolder */
+    subFolderName?: string;
+}
+/**
+ * Options for getting a single file
+ */
+export interface GetFileOptions {
+    /** Storage bucket name */
+    storageName: string;
+    /** Reference key */
+    referenceKey: string;
+    /** File name */
+    fileName: string;
+    /** Optional subfolder */
+    subFolderName?: string;
+}
+/**
+ * File storage provider interface
+ *
+ * Abstracts file storage operations from specific implementations
+ * (Firebase Storage, S3, Mock, etc.)
+ */
+export interface IStorageProvider {
+    /**
+     * Upload a file to storage
+     * @returns Upload result with path and download URL
+     */
+    uploadFile(request: UploadFileRequest): Promise<UploadResult>;
+    /**
+     * Download a file from storage
+     * @returns Base64 encoded data URL
+     */
+    downloadFile(options: GetFileOptions): Promise<string>;
+    /**
+     * Delete a file from storage
+     */
+    deleteFile(options: GetFileOptions): Promise<void>;
+    /**
+     * List files in a storage location
+     * @returns Array of storage documents
+     */
+    listFiles(options: ListFilesOptions): Promise<StorageDocument[]>;
+    /**
+     * Get metadata for a single file
+     * @returns Storage document metadata or null if not found
+     */
+    getFile(options: GetFileOptions): Promise<StorageDocument | null>;
+}
+//# sourceMappingURL=IStorageProvider.d.ts.map

package/dist/service-provider/interfaces/IStorageProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IStorageProvider.d.ts","sourceRoot":"","sources":["../../../src/service-provider/interfaces/IStorageProvider.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE9D;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAEjE;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;CACnE"}

package/dist/service-provider/interfaces/ServiceProvider.d.ts

@@ -0,0 +1,24 @@
+import { IAuthProvider } from './IAuthProvider.js';
+import { IFunctionProvider } from './IFunctionProvider.js';
+import { IStorageProvider } from './IStorageProvider.js';
+import { IDatabaseProvider } from './IDatabaseProvider.js';
+/**
+ * Complete service provider configuration
+ *
+ * This is the main type that provider packages (pd-provider-firebase,
+ * pd-provider-mock, etc.) must implement.
+ *
+ * Note: Messaging is NOT part of this interface - it remains Firebase-specific
+ * and is handled directly in pd-provider-firebase.
+ */
+export interface ServiceProvider {
+    /** Authentication provider (required) */
+    auth: IAuthProvider;
+    /** Cloud functions provider (required) */
+    functions: IFunctionProvider;
+    /** File storage provider (required) */
+    storage: IStorageProvider;
+    /** Database provider (optional - not all apps need real-time database) */
+    database?: IDatabaseProvider;
+}
+//# sourceMappingURL=ServiceProvider.d.ts.map

package/dist/service-provider/interfaces/ServiceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceProvider.d.ts","sourceRoot":"","sources":["../../../src/service-provider/interfaces/ServiceProvider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,IAAI,EAAE,aAAa,CAAC;IAEpB,0CAA0C;IAC1C,SAAS,EAAE,iBAAiB,CAAC;IAE7B,uCAAuC;IACvC,OAAO,EAAE,gBAAgB,CAAC;IAE1B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B"}

package/dist/service-provider/interfaces/common.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unsubscribe function returned by listeners/subscriptions
+ */
+export type Unsubscribe = () => void;
+//# sourceMappingURL=common.d.ts.map

package/dist/service-provider/interfaces/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/service-provider/interfaces/common.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC"}

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

@@ -31,13 +31,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 +53,7 @@ export interface MenuElement {
     name: string;
     sec?: string;
     route?: string;
+    requiredRoles?: string[];
     action?: () => void;
     topItem?: boolean;
     ref?: HTMLElement;
@@ -63,6 +65,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;
@@ -76,6 +80,8 @@ 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;
@@ -88,10 +94,20 @@ export interface Footer {
     copyright?: string;
     links: Array<LinkObj>;
 }
+/** 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 +122,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;
@@ -139,12 +155,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;AAErC,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;CACxB;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,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACvB;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;CACnC;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/service-provider/service-provider-model.js

@@ -13,8 +13,5 @@ class BusinessError extends Error {
     Object.setPrototypeOf(this, new.target.prototype);
   }
 }
-export {
-  BusinessError,
-  SC_INVALID_USER,
-  SC_TECHNICAL_FAILURE
-};
+
+export { BusinessError, SC_INVALID_USER, SC_TECHNICAL_FAILURE };

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;;;;6DAoBnC;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,97 @@
+import { createEffect, actions$ } from 'mini-rx-store';
+import { filter, map, tap } 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
+        });
+      })
+    )
+  );
+}
+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 };