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

package/dist/screen-size/responsive-directives.js

@@ -0,0 +1,71 @@
+import { directive, AsyncDirective } from 'lit/async-directive.js';
+import { screenSizeService } from './ScreenSizeService.js';
+
+function resolveResponsiveValue(options, currentBreakpoint) {
+  const breakpointOrder = screenSizeService.breakpointOrder;
+  const currentIndex = breakpointOrder.indexOf(currentBreakpoint);
+  for (let i = currentIndex; i < breakpointOrder.length; i++) {
+    const bp = breakpointOrder[i];
+    const value = options[bp];
+    if (value !== void 0) {
+      return value;
+    }
+  }
+  return options.default;
+}
+class ResponsiveTextDirective extends AsyncDirective {
+  render(options) {
+    this._options = options;
+    if (!this._unsubscribe) {
+      this._unsubscribe = screenSizeService.subscribe(() => {
+        this.setValue(this._getText());
+      });
+    }
+    return this._getText();
+  }
+  disconnected() {
+    this._unsubscribe?.();
+    this._unsubscribe = void 0;
+  }
+  reconnected() {
+    if (!this._unsubscribe) {
+      this._unsubscribe = screenSizeService.subscribe(() => {
+        this.setValue(this._getText());
+      });
+    }
+  }
+  _getText() {
+    if (!this._options) return "";
+    return resolveResponsiveValue(this._options, screenSizeService.breakpoint);
+  }
+}
+class ResponsiveValueDirective extends AsyncDirective {
+  render(options) {
+    this._options = options;
+    if (!this._unsubscribe) {
+      this._unsubscribe = screenSizeService.subscribe(() => {
+        this.setValue(this._getValue());
+      });
+    }
+    return this._getValue();
+  }
+  disconnected() {
+    this._unsubscribe?.();
+    this._unsubscribe = void 0;
+  }
+  reconnected() {
+    if (!this._unsubscribe) {
+      this._unsubscribe = screenSizeService.subscribe(() => {
+        this.setValue(this._getValue());
+      });
+    }
+  }
+  _getValue() {
+    if (!this._options) return void 0;
+    return resolveResponsiveValue(this._options, screenSizeService.breakpoint);
+  }
+}
+const responsiveText = directive(ResponsiveTextDirective);
+const responsiveValue = directive(ResponsiveValueDirective);
+
+export { responsiveText, responsiveValue };

package/dist/screen-size/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Screen size types and interfaces
+ */
+/** Available breakpoint names (mobile-first) */
+export type Breakpoint = "xs" | "sm" | "md" | "lg" | "xl";
+/** Breakpoint threshold configuration (min-width values in pixels) */
+export interface BreakpointConfig {
+    xs: number;
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+}
+/** Options for responsive text directive */
+export interface ResponsiveTextOptions {
+    /** Default text (used when no breakpoint-specific text matches) */
+    default: string;
+    /** Text for extra small screens (< 640px) */
+    xs?: string;
+    /** Text for small screens (640px - 767px) */
+    sm?: string;
+    /** Text for medium screens (768px - 1023px) */
+    md?: string;
+    /** Text for large screens (1024px - 1279px) */
+    lg?: string;
+    /** Text for extra large screens (>= 1280px) */
+    xl?: string;
+}
+/** Options for responsive value directive (generic version) */
+export interface ResponsiveValueOptions<T> {
+    /** Default value (used when no breakpoint-specific value matches) */
+    default: T;
+    /** Value for extra small screens */
+    xs?: T;
+    /** Value for small screens */
+    sm?: T;
+    /** Value for medium screens */
+    md?: T;
+    /** Value for large screens */
+    lg?: T;
+    /** Value for extra large screens */
+    xl?: T;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/screen-size/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/screen-size/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1D,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,qEAAqE;IACrE,OAAO,EAAE,CAAC,CAAC;IACX,oCAAoC;IACpC,EAAE,CAAC,EAAE,CAAC,CAAC;IACP,8BAA8B;IAC9B,EAAE,CAAC,EAAE,CAAC,CAAC;IACP,+BAA+B;IAC/B,EAAE,CAAC,EAAE,CAAC,CAAC;IACP,8BAA8B;IAC9B,EAAE,CAAC,EAAE,CAAC,CAAC;IACP,oCAAoC;IACpC,EAAE,CAAC,EAAE,CAAC,CAAC;CACR"}

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

@@ -0,0 +1,67 @@
+import { ServiceProvider, IAuthProvider, IFunctionProvider, IStorageProvider, IDatabaseProvider } from '@progressive-development/pd-provider-interfaces';
+/**
+ * Central service container for dependency injection
+ *
+ * Usage:
+ * ```typescript
+ * // In app initialization (e.g., main.ts)
+ * import { services } from "pd-helper-app";
+ * import { createFirebaseProvider } from "pd-provider-firebase";
+ *
+ * services.initialize(createFirebaseProvider(firebaseConfig));
+ *
+ * // In components/services
+ * import { services } from "pd-helper-app";
+ *
+ * const user = services.auth.getCurrentUser();
+ * ```
+ */
+export declare class ServiceRegistry {
+    private provider;
+    /**
+     * Initialize the service registry with a provider
+     * @param provider The service provider to use
+     * @throws Error if already initialized
+     */
+    initialize(provider: ServiceProvider): void;
+    /**
+     * Check if the registry has been initialized
+     */
+    get isInitialized(): boolean;
+    /**
+     * Ensure the registry is initialized before accessing providers
+     * @throws Error if not initialized
+     */
+    private ensureInitialized;
+    /**
+     * Get the auth provider
+     */
+    get auth(): IAuthProvider;
+    /**
+     * Get the functions provider
+     */
+    get functions(): IFunctionProvider;
+    /**
+     * Get the storage provider
+     */
+    get storage(): IStorageProvider;
+    /**
+     * Get the database provider (optional)
+     * @returns Database provider or undefined if not configured
+     */
+    get database(): IDatabaseProvider | undefined;
+    /**
+     * Reset the registry (primarily for testing)
+     *
+     * Warning: This should only be used in tests.
+     * In production, providers should be initialized once at app startup.
+     */
+    reset(): void;
+}
+/**
+ * Global service registry instance
+ *
+ * This is the main entry point for accessing services throughout the application.
+ */
+export declare const services: ServiceRegistry;
+//# sourceMappingURL=ServiceRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceRegistry.d.ts","sourceRoot":"","sources":["../../src/service-provider/ServiceRegistry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,iDAAiD,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAgC;IAEhD;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAS3C;;OAEG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,IAAI,IAAI,IAAI,aAAa,CAGxB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,iBAAiB,CAGjC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,gBAAgB,CAG9B;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,iBAAiB,GAAG,SAAS,CAG5C;IAED;;;;;OAKG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,iBAAwB,CAAC"}

package/dist/service-provider/ServiceRegistry.js

@@ -0,0 +1,76 @@
+class ServiceRegistry {
+  constructor() {
+    this.provider = null;
+  }
+  /**
+   * Initialize the service registry with a provider
+   * @param provider The service provider to use
+   * @throws Error if already initialized
+   */
+  initialize(provider) {
+    if (this.provider !== null) {
+      throw new Error(
+        "ServiceRegistry already initialized. Call reset() first if re-initialization is needed."
+      );
+    }
+    this.provider = provider;
+  }
+  /**
+   * Check if the registry has been initialized
+   */
+  get isInitialized() {
+    return this.provider !== null;
+  }
+  /**
+   * Ensure the registry is initialized before accessing providers
+   * @throws Error if not initialized
+   */
+  ensureInitialized() {
+    if (this.provider === null) {
+      throw new Error(
+        "ServiceRegistry not initialized. Call services.initialize(provider) before accessing services."
+      );
+    }
+  }
+  /**
+   * Get the auth provider
+   */
+  get auth() {
+    this.ensureInitialized();
+    return this.provider.auth;
+  }
+  /**
+   * Get the functions provider
+   */
+  get functions() {
+    this.ensureInitialized();
+    return this.provider.functions;
+  }
+  /**
+   * Get the storage provider
+   */
+  get storage() {
+    this.ensureInitialized();
+    return this.provider.storage;
+  }
+  /**
+   * Get the database provider (optional)
+   * @returns Database provider or undefined if not configured
+   */
+  get database() {
+    this.ensureInitialized();
+    return this.provider?.database;
+  }
+  /**
+   * Reset the registry (primarily for testing)
+   *
+   * Warning: This should only be used in tests.
+   * In production, providers should be initialized once at app startup.
+   */
+  reset() {
+    this.provider = null;
+  }
+}
+const services = new ServiceRegistry();
+
+export { ServiceRegistry, services };

package/dist/service-provider/function-utils.d.ts

@@ -0,0 +1,55 @@
+import { BusinessError, FunctionResult, FunctionDefinition } from './service-provider-model.js';
+/**
+ * Validates a function result against the expected success codes and extracts the data.
+ *
+ * @param result - The raw function result from the provider
+ * @param functionDef - The function definition with successCodes
+ * @returns The extracted resultData, typed as T
+ * @throws BusinessError if statusCode is not in successCodes
+ *
+ * @example
+ * ```typescript
+ * public loadGalleryList(): Observable<DJGalleryItem[]> {
+ *   const call = { object: "galleryList" };
+ *   return from(
+ *     services.functions.callFunction(handlePutFunc.name, call)
+ *       .then((result) => validateFunctionResult<DJGalleryItem[]>(result, handlePutFunc))
+ *   );
+ * }
+ * ```
+ */
+export declare function validateFunctionResult<T>(result: FunctionResult, functionDef: FunctionDefinition): T;
+/**
+ * Validates a function result with a custom success code array.
+ * Use this when you don't have a full FunctionDefinition available.
+ *
+ * @param result - The raw function result from the provider
+ * @param successCodes - Array of valid status codes (default: [200])
+ * @returns The extracted resultData, typed as T
+ * @throws BusinessError if statusCode is not in successCodes
+ */
+export declare function validateResult<T>(result: FunctionResult, successCodes?: number[]): T;
+/**
+ * Type guard to check if an error is a BusinessError.
+ * Useful in catch blocks to distinguish business errors from technical errors.
+ *
+ * @example
+ * ```typescript
+ * catchError((err) => {
+ *   if (isBusinessError(err)) {
+ *     console.log("Business error:", err.code, err.message);
+ *   }
+ *   return of(failAction(err));
+ * })
+ * ```
+ */
+export declare function isBusinessError(error: unknown): error is BusinessError;
+/**
+ * Extracts error information for logging/display.
+ * Handles both BusinessError and standard Error.
+ */
+export declare function extractErrorInfo(error: unknown): {
+    message: string;
+    code: number;
+};
+//# sourceMappingURL=function-utils.d.ts.map

package/dist/service-provider/function-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-utils.d.ts","sourceRoot":"","sources":["../../src/service-provider/function-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,cAAc,EACd,kBAAkB,EAEnB,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,kBAAkB,GAC9B,CAAC,CASH;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,cAAc,EACtB,YAAY,GAAE,MAAM,EAAU,GAC7B,CAAC,CASH;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAQA"}

package/dist/service-provider/function-utils.js

@@ -0,0 +1,30 @@
+import { SC_TECHNICAL_FAILURE, BusinessError } from './service-provider-model.js';
+
+function validateFunctionResult(result, functionDef) {
+  if (!functionDef.successCodes.includes(result.statusCode)) {
+    const message = typeof result.resultData === "string" ? result.resultData : `Function call failed with code ${result.statusCode}`;
+    throw new BusinessError(message, result.statusCode);
+  }
+  return result.resultData;
+}
+function validateResult(result, successCodes = [200]) {
+  if (!successCodes.includes(result.statusCode)) {
+    const message = typeof result.resultData === "string" ? result.resultData : `Function call failed with code ${result.statusCode}`;
+    throw new BusinessError(message, result.statusCode);
+  }
+  return result.resultData;
+}
+function isBusinessError(error) {
+  return error instanceof BusinessError;
+}
+function extractErrorInfo(error) {
+  if (isBusinessError(error)) {
+    return { message: error.message, code: error.code };
+  }
+  if (error instanceof Error) {
+    return { message: error.message, code: SC_TECHNICAL_FAILURE };
+  }
+  return { message: String(error), code: SC_TECHNICAL_FAILURE };
+}
+
+export { extractErrorInfo, isBusinessError, validateFunctionResult, validateResult };

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

@@ -0,0 +1,10 @@
+export { ServiceRegistry, services } from './ServiceRegistry.js';
+export type { IAuthProvider, AuthUser, UserToken, AuthStateCallback, } from './interfaces/IAuthProvider.js';
+export type { IFunctionProvider, FunctionDefinition, FunctionResult, } from './interfaces/IFunctionProvider.js';
+export type { IStorageProvider, UploadFileRequest, UploadResult, StorageDocument, ListFilesOptions, GetFileOptions, } from './interfaces/IStorageProvider.js';
+export type { IDatabaseProvider, QueryConstraint, QueryOperator, DocumentSnapshot, CollectionCallback, } from './interfaces/IDatabaseProvider.js';
+export type { ServiceProvider } from './interfaces/ServiceProvider.js';
+export type { Unsubscribe } from './interfaces/common.js';
+export { SC_INVALID_USER, SC_TECHNICAL_FAILURE, BusinessError, } from './service-provider-model.js';
+export type { ServiceProviderConfiguration, FunctionParam, FunctionsConfig, MenuElement, NavigationPage, NavigationConfig, LinkObj, Footer, StoreConfig, FileStorage, FileStorageConfig, MessagingConfig, AppConfiguration, UploadFile, CollectionContraint, } from './service-provider-model.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/service-provider/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKjE,YAAY,EACV,aAAa,EACb,QAAQ,EACR,SAAS,EACT,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AAKvC,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,mCAAmC,CAAC;AAK3C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,cAAc,GACf,MAAM,kCAAkC,CAAC;AAK1C,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAK3C,YAAY,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAKvE,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAK1D,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,aAAa,GACd,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,4BAA4B,EAC5B,aAAa,EACb,eAAe,EACf,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,MAAM,EACN,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,mBAAmB,GACpB,MAAM,6BAA6B,CAAC"}

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

@@ -0,0 +1,68 @@
+import { Unsubscribe } from './common.js';
+/**
+ * Authenticated user information
+ */
+export interface AuthUser {
+    uid: string;
+    email: string | null;
+    emailVerified: boolean;
+    displayName?: string | null;
+    photoURL?: string | null;
+}
+/**
+ * User token with claims
+ */
+export interface UserToken {
+    token: string;
+    claims: Record<string, unknown>;
+    expirationTime: string;
+}
+/**
+ * Callback for auth state changes
+ */
+export type AuthStateCallback = (user: AuthUser | null) => void;
+/**
+ * Authentication provider interface
+ *
+ * Abstracts authentication operations (login, logout, state monitoring)
+ * from specific implementations (Firebase, Mock, etc.)
+ */
+export interface IAuthProvider {
+    /**
+     * Sign in with email and password
+     * @throws Error on authentication failure
+     */
+    login(email: string, password: string): Promise<AuthUser>;
+    /**
+     * Sign out the current user
+     */
+    logout(): Promise<void>;
+    /**
+     * Get the currently authenticated user
+     * @returns User if authenticated, null otherwise
+     */
+    getCurrentUser(): AuthUser | null;
+    /**
+     * Check if a user is currently authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get the current user's ID token
+     * @param forceRefresh Force token refresh even if not expired
+     * @returns Token string or null if not authenticated
+     */
+    getIdToken(forceRefresh?: boolean): Promise<string | null>;
+    /**
+     * Get detailed token result with claims
+     * @param forceRefresh Force token refresh even if not expired
+     * @returns Token with claims or null if not authenticated
+     */
+    getIdTokenResult(forceRefresh?: boolean): Promise<UserToken | null>;
+    /**
+     * Subscribe to authentication state changes
+     * @param callback Called when auth state changes
+     * @returns Unsubscribe function
+     */
+    onAuthStateChanged(callback: AuthStateCallback): Unsubscribe;
+}
+//# sourceMappingURL=IAuthProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IAuthProvider.d.ts","sourceRoot":"","sources":["../../../src/service-provider/interfaces/IAuthProvider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE1D;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;;OAGG;IACH,cAAc,IAAI,QAAQ,GAAG,IAAI,CAAC;IAElC;;OAEG;IACH,eAAe,IAAI,OAAO,CAAC;IAE3B;;;;OAIG;IACH,UAAU,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE3D;;;;OAIG;IACH,gBAAgB,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAEpE;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,WAAW,CAAC;CAC9D"}

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

@@ -0,0 +1,75 @@
+import { Unsubscribe } from './common.js';
+/**
+ * Query operators for filtering
+ */
+export type QueryOperator = "<" | ">" | ">=" | "<=" | "==" | "!=" | "array-contains" | "array-contains-any" | "in" | "not-in";
+/**
+ * Query constraint for filtering collections
+ */
+export interface QueryConstraint {
+    type: "where";
+    field: string;
+    operator: QueryOperator;
+    value: string | number | boolean | null | Date | Array<string | number | boolean | null | Date>;
+}
+/**
+ * Document snapshot with data and metadata
+ */
+export interface DocumentSnapshot<T = unknown> {
+    /** Document ID */
+    id: string;
+    /** Document data */
+    data: T;
+    /** Whether the document exists */
+    exists: boolean;
+}
+/**
+ * Callback for collection changes
+ */
+export type CollectionCallback<T> = (documents: DocumentSnapshot<T>[] | null) => void;
+/**
+ * Database provider interface (optional)
+ *
+ * Abstracts database operations from specific implementations
+ * (Firestore, Mock, etc.)
+ *
+ * Note: This provider is optional - not all apps need real-time database features
+ */
+export interface IDatabaseProvider {
+    /**
+     * Subscribe to a collection with optional filtering
+     * @param collectionPath Path to the collection
+     * @param callback Called with documents on changes
+     * @param constraints Optional query constraints
+     * @returns Unsubscribe function
+     */
+    onCollection<T = unknown>(collectionPath: string, callback: CollectionCallback<T>, constraints?: QueryConstraint[]): Unsubscribe;
+    /**
+     * Get a single document
+     * @param collectionPath Path to the collection
+     * @param documentId Document ID
+     * @returns Document snapshot
+     */
+    getDocument<T = unknown>(collectionPath: string, documentId: string): Promise<DocumentSnapshot<T>>;
+    /**
+     * Set/overwrite a document
+     * @param collectionPath Path to the collection
+     * @param documentId Document ID
+     * @param data Document data
+     */
+    setDocument<T = unknown>(collectionPath: string, documentId: string, data: T): Promise<void>;
+    /**
+     * Update specific fields in a document
+     * @param collectionPath Path to the collection
+     * @param documentId Document ID
+     * @param data Partial document data to update
+     */
+    updateDocument(collectionPath: string, documentId: string, data: Record<string, unknown>): Promise<void>;
+    /**
+     * Delete a document
+     * @param collectionPath Path to the collection
+     * @param documentId Document ID
+     */
+    deleteDocument(collectionPath: string, documentId: string): Promise<void>;
+}
+//# sourceMappingURL=IDatabaseProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IDatabaseProvider.d.ts","sourceRoot":"","sources":["../../../src/service-provider/interfaces/IDatabaseProvider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,GAAG,GACH,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,gBAAgB,GAChB,oBAAoB,GACpB,IAAI,GACJ,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EACD,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,IAAI,GACJ,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,IAAI,EAAE,CAAC,CAAC;IACR,kCAAkC;IAClC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAClC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,KACpC,IAAI,CAAC;AAEV;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,YAAY,CAAC,CAAC,GAAG,OAAO,EACtB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC/B,WAAW,CAAC,EAAE,eAAe,EAAE,GAC9B,WAAW,CAAC;IAEf;;;;;OAKG;IACH,WAAW,CAAC,CAAC,GAAG,OAAO,EACrB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhC;;;;;OAKG;IACH,WAAW,CAAC,CAAC,GAAG,OAAO,EACrB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,CAAC,GACN,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,cAAc,CACZ,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;OAIG;IACH,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E"}

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

@@ -0,0 +1,49 @@
+/**
+ * Result from a cloud function call
+ */
+export interface FunctionResult {
+    resultData: unknown;
+    statusCode: number;
+}
+/**
+ * Cloud function definition
+ */
+export interface FunctionDefinition {
+    /** Function name */
+    name: string;
+    /** Status codes considered successful */
+    successCodes: number[];
+    /** Show full-screen loading indicator */
+    fadeWindow: boolean;
+    /** Text shown on success */
+    successTxt: string | unknown;
+    /** Text shown while pending */
+    pendingTxt: string | unknown;
+    /** Additional parameters */
+    param?: Record<string, unknown>;
+    /** Redirect route after success */
+    redirect?: string;
+    /** Logout user on failure */
+    logoutOnFail?: boolean;
+}
+/**
+ * Cloud functions provider interface
+ *
+ * Abstracts cloud function calls from specific implementations
+ * (Firebase Functions, Mock, REST API, etc.)
+ */
+export interface IFunctionProvider {
+    /**
+     * Call a cloud function
+     * @param functionName Name of the function to call
+     * @param data Data to pass to the function
+     * @returns Function result with status code
+     */
+    callFunction(functionName: string, data: unknown): Promise<FunctionResult>;
+    /**
+     * Configure the functions region
+     * @param region Cloud region (e.g., 'europe-west3')
+     */
+    setRegion(region: string): void;
+}
+//# sourceMappingURL=IFunctionProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IFunctionProvider.d.ts","sourceRoot":"","sources":["../../../src/service-provider/interfaces/IFunctionProvider.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yCAAyC;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,+BAA+B;IAC/B,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE3E;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC"}