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

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

@@ -1,98 +0,0 @@
-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 };

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

@@ -1,154 +0,0 @@
-import { ActionCreator, Action } from 'ts-action';
-import { LoaderStyle } from '@progressive-development/pd-content';
-/**
- * Configuration for loading state and toast messages.
- */
-export interface AsyncActionConfig {
-    /** Unique key for identifying the loading state */
-    actionKey: string;
-    /** Text shown during loading */
-    loadingTxt: string;
-    /** Text shown on success (empty string = no toast) */
-    successTxt?: string;
-    /** Show modal overlay during loading */
-    modal?: boolean;
-    /** Show small background loader */
-    smallBackground?: boolean;
-    /** Duration for success toast in ms */
-    successDuration?: number;
-    /** Override loader style for this action (overrides app default) */
-    loaderStyle?: LoaderStyle;
-}
-/**
- * Typed action creator that preserves payload type for ts-action compatibility.
- * This enables proper type inference with on() and ofType().
- */
-type TypedActionCreator<P> = ActionCreator<string, (payload: P) => {
-    type: string;
-    payload: P;
-}>;
-/**
- * Action creator without payload.
- */
-type TypedActionCreatorVoid = ActionCreator<string, () => {
-    type: string;
-}>;
-/**
- * Base interface for async action groups.
- * Use this type for arrays containing groups with different payload types.
- *
- * @example
- * ```typescript
- * const allGroups: AsyncActionGroupBase[] = [
- *   loadProfile,      // AsyncActionGroup<void, ProfileData>
- *   sendRequest,      // AsyncActionGroup<RequestData, void>
- * ];
- * ```
- */
-export interface AsyncActionGroupBase {
-    /** Loading state and toast configuration */
-    config: AsyncActionConfig;
-    /** Base action type (e.g., "LOAD_PROFILE") */
-    baseType: string;
-    /** All action types for this group */
-    types: {
-        action: string;
-        success: string;
-        fail: string;
-    };
-}
-/**
- * An async action group containing action, success, and fail action creators
- * plus the associated configuration.
- *
- * The action creators preserve their full ts-action types for compatibility
- * with on() and ofType().
- */
-export interface AsyncActionGroup<TPayload = void, TResult = unknown, TError = Error> extends AsyncActionGroupBase {
-    /** The initiating action creator - typed for ts-action compatibility */
-    action: TPayload extends void ? TypedActionCreatorVoid : TypedActionCreator<TPayload>;
-    /** The success action creator - typed for ts-action compatibility */
-    success: TypedActionCreator<TResult>;
-    /** The fail action creator - typed for ts-action compatibility */
-    fail: TypedActionCreator<TError>;
-}
-/**
- * Options for creating an async action group.
- * actionKey is derived from baseType if not provided.
- */
-export type AsyncActionOptions = Omit<AsyncActionConfig, "actionKey"> & {
-    actionKey?: string;
-};
-/**
- * Creates an async action group with action/success/fail creators and config.
- *
- * @param baseType - Base action type (e.g., "LOAD_PROFILE")
- * @param options - Loading state and toast configuration
- * @returns AsyncActionGroup with all creators and config
- *
- * @example
- * ```typescript
- * // Without payload on action
- * export const loadProfile = createAsyncAction<ProfileData>("LOAD_PROFILE", {
- *   loadingTxt: msg("Loading profile...", { id: "..." }),
- *   modal: true,
- * });
- *
- * // With typed payloads
- * export const updateProfile = createAsyncActionGroup<
- *   UpdateData,     // Action payload
- *   ProfileData,    // Success payload
- * >("UPDATE_PROFILE", {
- *   loadingTxt: "Updating...",
- *   successTxt: "Profile updated!",
- *   modal: true,
- * });
- *
- * // Usage in effect with ofType():
- * actions$.pipe(
- *   ofType(loadProfile.action),
- *   mergeMap(() => profileService.load().pipe(
- *     map((data) => loadProfile.success(data)),
- *     catchError((err) => of(loadProfile.fail(err)))
- *   ))
- * );
- *
- * // Usage in reducer with on():
- * reducer(
- *   initialState,
- *   on(loadProfile.success, (state, { payload }) => ({
- *     ...state,
- *     profile: payload
- *   }))
- * );
- * ```
- */
-export declare function createAsyncActionGroup<TPayload = void, TResult = unknown, TError = Error>(baseType: string, options: AsyncActionOptions): AsyncActionGroup<TPayload, TResult, TError>;
-/**
- * Creates an async action group without payload on the initiating action.
- * This is a convenience wrapper for the common case.
- *
- * @example
- * ```typescript
- * export const loadProfile = createAsyncAction<ProfileData>("LOAD_PROFILE", {
- *   loadingTxt: "Loading...",
- *   modal: true,
- * });
- *
- * // loadProfile.action() - no payload
- * // loadProfile.success(data) - ProfileData payload
- * // loadProfile.fail(error) - Error payload
- * ```
- */
-export declare function createAsyncAction<TResult = unknown, TError = Error>(baseType: string, options: AsyncActionOptions): AsyncActionGroup<void, TResult, TError>;
-/**
- * Type guard to check if an action belongs to an async action group.
- */
-export declare function isActionFromGroup(actionObj: Action, group: AsyncActionGroupBase): boolean;
-/**
- * Gets the config for an action from a list of groups.
- * Returns undefined if no matching group is found.
- */
-export declare function getConfigForAction(actionObj: Action, groups: AsyncActionGroupBase[]): AsyncActionConfig | undefined;
-export {};
-//# sourceMappingURL=async-action-utils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"async-action-utils.d.ts","sourceRoot":"","sources":["../../src/store/async-action-utils.ts"],"names":[],"mappings":"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"}

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

@@ -1,42 +0,0 @@
-import { action, payload } from 'ts-action';
-
-function createAsyncActionGroup(baseType, options) {
-  const types = {
-    action: baseType,
-    success: `${baseType}_SUCCESS`,
-    fail: `${baseType}_FAIL`
-  };
-  const actionKey = options.actionKey || baseType.toLowerCase().replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
-  const config = {
-    actionKey,
-    loadingTxt: options.loadingTxt,
-    successTxt: options.successTxt,
-    modal: options.modal,
-    smallBackground: options.smallBackground,
-    successDuration: options.successDuration,
-    loaderStyle: options.loaderStyle
-  };
-  const actionCreator = action(types.action, payload());
-  const successCreator = action(types.success, payload());
-  const failCreator = action(types.fail, payload());
-  return {
-    action: actionCreator,
-    success: successCreator,
-    fail: failCreator,
-    config,
-    baseType,
-    types
-  };
-}
-function createAsyncAction(baseType, options) {
-  return createAsyncActionGroup(baseType, options);
-}
-function isActionFromGroup(actionObj, group) {
-  return actionObj.type === group.types.action || actionObj.type === group.types.success || actionObj.type === group.types.fail;
-}
-function getConfigForAction(actionObj, groups) {
-  const group = groups.find((g) => isActionFromGroup(actionObj, g));
-  return group?.config;
-}
-
-export { createAsyncAction, createAsyncActionGroup, getConfigForAction, isActionFromGroup };

package/dist/store/index.d.ts

@@ -1,9 +0,0 @@
-export { pdStore, initializeStore } from './mini-rx.store.js';
-export { initIndexDBSuccess, loginSuccess, logoutSuccess, nologin, routeAction, updateInternetOffline, addLoadingState, changeSubTask, removeLoadingState, updateNewNotificationToken, updateNewNotificationTokenSuccess, updateNewNotificationTokenFail, } from './spa-app-actions.js';
-export { getLoadingSelector, getOfflineSelector, getInitStatusSelector, selectAuthUser, } from './spa-app-selector.js';
-export { setRouteElement } from './spa-app-effects.js';
-export { spaAppReducer } from './spa-app-reducer.js';
-export type { SpaAppState } from './spa-app-reducer.js';
-export * as SpaActions from './spa-app-actions.js';
-export * as SpaSelectors from './spa-app-selector.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/store/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,OAAO,EACP,WAAW,EACX,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,0BAA0B,EAC1B,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,KAAK,UAAU,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAC"}

package/dist/stories/introduction.stories.d.ts

@@ -1,11 +0,0 @@
-import { Meta, StoryObj } from '@storybook/web-components';
-declare const meta: Meta;
-export default meta;
-type Story = StoryObj;
-/**
- * Welcome to pd-spa-helper Storybook
- *
- * This library provides the core SPA framework for Lit-based applications.
- */
-export declare const Welcome: Story;
-//# sourceMappingURL=introduction.stories.d.ts.map

package/dist/stories/introduction.stories.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"introduction.stories.d.ts","sourceRoot":"","sources":["../../src/stories/introduction.stories.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAEhE,QAAA,MAAM,IAAI,EAAE,IAKX,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC;AAEtB;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,KAqCrB,CAAC"}