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

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"}

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"}