@ponceca/firestore-sdk 0.1.0 → 1.0.0

package/dist/storage/index.d.mts

@@ -0,0 +1,138 @@
+/**
+ * SDK compatible con Firebase Storage v9 Modular.
+ * Clon fidedigno: misma API, mismos códigos de error, misma semántica de seguridad.
+ *
+ * Códigos de error idénticos a Firebase:
+ *   storage/unauthenticated  → No hay token (user no autenticado)
+ *   storage/unauthorized     → Token válido pero security rules deniegan (403)
+ *   storage/object-not-found → Archivo no existe (404)
+ *   storage/canceled         → Operación cancelada por el usuario
+ *   storage/retry-limit-exceeded → Reintentos agotados
+ *   storage/unknown          → Error genérico del servidor
+ */
+declare class StorageError extends Error {
+    readonly code: string;
+    readonly serverResponse: string | null;
+    constructor(code: string, message: string, serverResponse?: string | null);
+}
+declare class AcmeStorageError extends StorageError {
+    constructor(code: string, message: string, serverResponse?: string | null);
+}
+interface FirebaseStorage {
+    app: any;
+    config: {
+        authEndpoint: string;
+        tokenGetter: () => Promise<string | null>;
+        apiKey?: string;
+        project?: string;
+        bucket?: string;
+    };
+}
+interface StorageReference {
+    storage: FirebaseStorage;
+    fullPath: string;
+    name: string;
+    bucket: string;
+    parent: StorageReference | null;
+    root: StorageReference;
+    _location: {
+        project: string;
+        bucket: string;
+        path: string;
+    };
+    _cachedMetadata?: any;
+}
+type StorageObserver<T> = {
+    next?: (snapshot: T) => void;
+    error?: (error: StorageError) => void;
+    complete?: () => void;
+};
+interface UploadTaskSnapshot {
+    bytesTransferred: number;
+    totalBytes: number;
+    state: 'running' | 'paused' | 'success' | 'error' | 'canceled';
+    metadata: any;
+    ref: StorageReference;
+    task: UploadTask;
+}
+interface UploadTask {
+    snapshot: UploadTaskSnapshot;
+    on(event: 'state_changed', next?: (snapshot: UploadTaskSnapshot) => void, error?: (error: StorageError) => void, complete?: () => void): Function;
+    then(onFulfilled?: ((snapshot: UploadTaskSnapshot) => any) | null, onRejected?: ((error: any) => any) | null): Promise<any>;
+    cancel(): boolean;
+    pause(): boolean;
+    resume(): boolean;
+}
+interface SettableMetadata {
+    cacheControl?: string;
+    contentDisposition?: string;
+    contentEncoding?: string;
+    contentLanguage?: string;
+    contentType?: string;
+    customMetadata?: {
+        [key: string]: string;
+    };
+}
+interface ListOptions {
+    maxResults?: number;
+    pageToken?: string;
+}
+interface ListResult {
+    items: StorageReference[];
+    prefixes: StorageReference[];
+    nextPageToken?: string;
+}
+type StringFormat = 'raw' | 'base64' | 'base64url' | 'data_url';
+/** Config directa (legacy/compatibilidad) */
+interface StorageConfig {
+    authEndpoint: string;
+    tokenGetter: () => Promise<string | null>;
+    apiKey?: string;
+    project?: string;
+    bucket?: string;
+}
+/** Interfaz mínima de App (evita import circular) */
+interface AppLike {
+    name: string;
+    options: {
+        storageUrl?: string;
+        apiKey?: string;
+        projectId: string;
+        storageBucket?: string;
+        [key: string]: any;
+    };
+}
+/**
+ * Obtiene la instancia de Storage.
+ *
+ * Uso con App unificada (recomendado):
+ *   const storage = getStorage(app);
+ *
+ * Uso con config directa (legacy):
+ *   const storage = getStorage({ authEndpoint: '...', tokenGetter: ... });
+ */
+declare function getStorage(appOrConfig?: AppLike | StorageConfig): FirebaseStorage;
+declare function connectStorageEmulator(storage: FirebaseStorage, host: string, port: number): void;
+declare function ref(storage: FirebaseStorage, path?: string): StorageReference;
+declare function ref(reference: StorageReference, path?: string): StorageReference;
+declare function child(parent: StorageReference, childPath: string): StorageReference;
+declare function getParent(reference: StorageReference): StorageReference | null;
+declare function getRoot(reference: StorageReference): StorageReference;
+declare function getDownloadURL(storageRef: StorageReference): Promise<string>;
+declare function getMetadata(storageRef: StorageReference): Promise<any>;
+declare function updateMetadata(storageRef: StorageReference, metadata: SettableMetadata): Promise<any>;
+declare function listAll(reference: StorageReference): Promise<{
+    items: StorageReference[];
+    prefixes: StorageReference[];
+}>;
+declare function list(reference: StorageReference, options?: ListOptions): Promise<ListResult>;
+declare function getBlob(storageRef: StorageReference, maxDownloadSizeBytes?: number): Promise<Blob>;
+declare function getBytes(storageRef: StorageReference, maxDownloadSizeBytes?: number): Promise<ArrayBuffer>;
+declare function getStream(storageRef: StorageReference, maxDownloadSizeBytes?: number): Promise<ReadableStream>;
+declare function deleteObject(storageRef: StorageReference): Promise<void>;
+declare function uploadBytesResumable(storageRef: StorageReference, data: Blob | Uint8Array | ArrayBuffer, metadata?: any): UploadTask;
+declare function uploadBytes(storageRef: StorageReference, data: Blob | Uint8Array | ArrayBuffer, metadata?: any): Promise<UploadTaskSnapshot>;
+declare function uploadString(storageRef: StorageReference, value: string, format?: StringFormat, metadata?: any): Promise<UploadTaskSnapshot>;
+declare function getThumbnailURL(storageRef: StorageReference, width?: number): Promise<string>;
+
+export { AcmeStorageError, type FirebaseStorage, type ListOptions, type ListResult, type SettableMetadata, type StorageConfig, StorageError, type StorageObserver, type StorageReference, type StringFormat, type UploadTask, type UploadTaskSnapshot, child, connectStorageEmulator, deleteObject, getBlob, getBytes, getDownloadURL, getMetadata, getParent, getRoot, getStorage, getStream, getThumbnailURL, list, listAll, ref, updateMetadata, uploadBytes, uploadBytesResumable, uploadString };

package/dist/storage/index.d.ts

@@ -0,0 +1,138 @@
+/**
+ * SDK compatible con Firebase Storage v9 Modular.
+ * Clon fidedigno: misma API, mismos códigos de error, misma semántica de seguridad.
+ *
+ * Códigos de error idénticos a Firebase:
+ *   storage/unauthenticated  → No hay token (user no autenticado)
+ *   storage/unauthorized     → Token válido pero security rules deniegan (403)
+ *   storage/object-not-found → Archivo no existe (404)
+ *   storage/canceled         → Operación cancelada por el usuario
+ *   storage/retry-limit-exceeded → Reintentos agotados
+ *   storage/unknown          → Error genérico del servidor
+ */
+declare class StorageError extends Error {
+    readonly code: string;
+    readonly serverResponse: string | null;
+    constructor(code: string, message: string, serverResponse?: string | null);
+}
+declare class AcmeStorageError extends StorageError {
+    constructor(code: string, message: string, serverResponse?: string | null);
+}
+interface FirebaseStorage {
+    app: any;
+    config: {
+        authEndpoint: string;
+        tokenGetter: () => Promise<string | null>;
+        apiKey?: string;
+        project?: string;
+        bucket?: string;
+    };
+}
+interface StorageReference {
+    storage: FirebaseStorage;
+    fullPath: string;
+    name: string;
+    bucket: string;
+    parent: StorageReference | null;
+    root: StorageReference;
+    _location: {
+        project: string;
+        bucket: string;
+        path: string;
+    };
+    _cachedMetadata?: any;
+}
+type StorageObserver<T> = {
+    next?: (snapshot: T) => void;
+    error?: (error: StorageError) => void;
+    complete?: () => void;
+};
+interface UploadTaskSnapshot {
+    bytesTransferred: number;
+    totalBytes: number;
+    state: 'running' | 'paused' | 'success' | 'error' | 'canceled';
+    metadata: any;
+    ref: StorageReference;
+    task: UploadTask;
+}
+interface UploadTask {
+    snapshot: UploadTaskSnapshot;
+    on(event: 'state_changed', next?: (snapshot: UploadTaskSnapshot) => void, error?: (error: StorageError) => void, complete?: () => void): Function;
+    then(onFulfilled?: ((snapshot: UploadTaskSnapshot) => any) | null, onRejected?: ((error: any) => any) | null): Promise<any>;
+    cancel(): boolean;
+    pause(): boolean;
+    resume(): boolean;
+}
+interface SettableMetadata {
+    cacheControl?: string;
+    contentDisposition?: string;
+    contentEncoding?: string;
+    contentLanguage?: string;
+    contentType?: string;
+    customMetadata?: {
+        [key: string]: string;
+    };
+}
+interface ListOptions {
+    maxResults?: number;
+    pageToken?: string;
+}
+interface ListResult {
+    items: StorageReference[];
+    prefixes: StorageReference[];
+    nextPageToken?: string;
+}
+type StringFormat = 'raw' | 'base64' | 'base64url' | 'data_url';
+/** Config directa (legacy/compatibilidad) */
+interface StorageConfig {
+    authEndpoint: string;
+    tokenGetter: () => Promise<string | null>;
+    apiKey?: string;
+    project?: string;
+    bucket?: string;
+}
+/** Interfaz mínima de App (evita import circular) */
+interface AppLike {
+    name: string;
+    options: {
+        storageUrl?: string;
+        apiKey?: string;
+        projectId: string;
+        storageBucket?: string;
+        [key: string]: any;
+    };
+}
+/**
+ * Obtiene la instancia de Storage.
+ *
+ * Uso con App unificada (recomendado):
+ *   const storage = getStorage(app);
+ *
+ * Uso con config directa (legacy):
+ *   const storage = getStorage({ authEndpoint: '...', tokenGetter: ... });
+ */
+declare function getStorage(appOrConfig?: AppLike | StorageConfig): FirebaseStorage;
+declare function connectStorageEmulator(storage: FirebaseStorage, host: string, port: number): void;
+declare function ref(storage: FirebaseStorage, path?: string): StorageReference;
+declare function ref(reference: StorageReference, path?: string): StorageReference;
+declare function child(parent: StorageReference, childPath: string): StorageReference;
+declare function getParent(reference: StorageReference): StorageReference | null;
+declare function getRoot(reference: StorageReference): StorageReference;
+declare function getDownloadURL(storageRef: StorageReference): Promise<string>;
+declare function getMetadata(storageRef: StorageReference): Promise<any>;
+declare function updateMetadata(storageRef: StorageReference, metadata: SettableMetadata): Promise<any>;
+declare function listAll(reference: StorageReference): Promise<{
+    items: StorageReference[];
+    prefixes: StorageReference[];
+}>;
+declare function list(reference: StorageReference, options?: ListOptions): Promise<ListResult>;
+declare function getBlob(storageRef: StorageReference, maxDownloadSizeBytes?: number): Promise<Blob>;
+declare function getBytes(storageRef: StorageReference, maxDownloadSizeBytes?: number): Promise<ArrayBuffer>;
+declare function getStream(storageRef: StorageReference, maxDownloadSizeBytes?: number): Promise<ReadableStream>;
+declare function deleteObject(storageRef: StorageReference): Promise<void>;
+declare function uploadBytesResumable(storageRef: StorageReference, data: Blob | Uint8Array | ArrayBuffer, metadata?: any): UploadTask;
+declare function uploadBytes(storageRef: StorageReference, data: Blob | Uint8Array | ArrayBuffer, metadata?: any): Promise<UploadTaskSnapshot>;
+declare function uploadString(storageRef: StorageReference, value: string, format?: StringFormat, metadata?: any): Promise<UploadTaskSnapshot>;
+declare function getThumbnailURL(storageRef: StorageReference, width?: number): Promise<string>;
+
+export { AcmeStorageError, type FirebaseStorage, type ListOptions, type ListResult, type SettableMetadata, type StorageConfig, StorageError, type StorageObserver, type StorageReference, type StringFormat, type UploadTask, type UploadTaskSnapshot, child, connectStorageEmulator, deleteObject, getBlob, getBytes, getDownloadURL, getMetadata, getParent, getRoot, getStorage, getStream, getThumbnailURL, list, listAll, ref, updateMetadata, uploadBytes, uploadBytesResumable, uploadString };