@ponceca/storage-sdk 0.1.0

package/README.md

@@ -0,0 +1,242 @@
+# Firebase Storage Clone SDK
+
+Clon 100% compatible con Firebase Storage v9+, con funcionalidades extendidas.
+
+## Instalación
+
+```bash
+npm install @ponceca/storage-sdk
+# o
+yarn add @ponceca/storage-sdk
+```
+
+## Uso Básico
+
+```typescript
+import { 
+    initializeStorage, 
+    ref, 
+    uploadBytesResumable, 
+    getDownloadURL,
+    getMetadata,
+    deleteObject,
+    listAll
+} from '@ponceca/storage-sdk';
+
+// Inicializar (igual que Firebase)
+const storage = initializeStorage({
+    authEndpoint: 'http://localhost:8080/api',
+    tokenGetter: async () => localStorage.getItem('token')
+});
+
+// Subir archivo
+const fileRef = ref(storage, 'users/photo.jpg');
+const task = uploadBytesResumable(fileRef, file, { contentType: 'image/jpeg' });
+
+task.on('state_changed',
+    (snapshot) => console.log(snapshot.bytesTransferred),
+    (error) => console.error(error),
+    () => console.log('¡Completado!')
+);
+
+// Obtener URL de descarga
+const url = await getDownloadURL(fileRef);
+
+// Metadata
+const metadata = await getMetadata(fileRef);
+
+// Eliminar
+await deleteObject(fileRef);
+```
+
+## Funciones Disponibles
+
+### Upload
+| Función | Descripción |
+|---------|-------------|
+| `uploadBytesResumable(ref, data, metadata)` | Subida resumible con progreso |
+| `uploadBytes(ref, data, metadata)` | Subida simple (Promise) |
+| `uploadString(ref, value, format, metadata)` | Subir string (raw/base64/data_url) |
+
+### Download
+| Función | Descripción |
+|---------|-------------|
+| `getDownloadURL(ref)` | URL firmada para descargar |
+| `getBytes(ref, maxSize?)` | Descargar como ArrayBuffer |
+| `getBlob(ref, maxSize?)` | Descargar como Blob |
+| `getStream(ref, maxSize?)` | Descargar como ReadableStream |
+
+### Metadata
+| Función | Descripción |
+|---------|-------------|
+| `getMetadata(ref)` | Obtener metadata del archivo |
+| `updateMetadata(ref, metadata)` | Actualizar metadata |
+
+### Listado
+| Función | Descripción |
+|---------|-------------|
+| `listAll(ref)` | Listar todos los archivos |
+| `list(ref, options)` | Listar con paginación |
+
+### Eliminación
+| Función | Descripción |
+|---------|-------------|
+| `deleteObject(ref)` | Eliminar archivo |
+
+## Integración Angular (wrapper delgado)
+
+El SDK incluye un wrapper Angular con provider + inyección + helpers reactivos.
+
+Guía completa (Angular + integración con Firestore clone):
+
+- `ANGULAR_FIRESTORE_INTEGRACION.md`
+
+### Imports disponibles
+
+- `@ponceca/storage-sdk/angular/storage`
+- `@ponceca/storage-sdk/angular/fire/storage` (compat con sintaxis tipo AngularFire)
+
+### Configuración en `app.config.ts`
+
+```typescript
+import { ApplicationConfig } from '@angular/core';
+import { getStorage } from '@ponceca/storage-sdk/storage';
+import { provideStorage } from '@ponceca/storage-sdk/angular/storage';
+
+export const appConfig: ApplicationConfig = {
+    providers: [
+        ...provideStorage(() => getStorage({
+            authEndpoint: 'http://localhost:8080/api',
+            tokenGetter: async () => localStorage.getItem('token'),
+            project: 'mi-proyecto',
+            bucket: 'mi-bucket'
+        }))
+    ]
+};
+```
+
+### Uso en servicio Angular
+
+```typescript
+import { injectStorage, ref, uploadBytes, getDownloadURL } from '@ponceca/storage-sdk/angular/storage';
+
+const storage = injectStorage();
+const fileRef = ref(storage, 'uploads/foto.png');
+await uploadBytes(fileRef, archivo);
+const url = await getDownloadURL(fileRef);
+```
+
+### Multi-instancia (opcional)
+
+```typescript
+providers: [
+    ...provideStorage(() => getStorage(mainConfig)),
+    ...provideStorage(() => getStorage(backupConfig), { name: 'backup' })
+]
+
+const backupStorage = injectStorage('backup');
+```
+
+### Helpers reactivos
+
+- `uploadTaskObservable(task)`
+- `uploadTaskSignal(task)`
+- `downloadUrlSignal(ref)`
+
+> Nota: `uploadTaskObservable` requiere `rxjs` en la app Angular.
+
+## Compatibilidad de imports (IA / código legado)
+
+Se añadieron subpaths para facilitar aliases:
+
+- `@ponceca/storage-sdk/firebase/storage` -> core storage
+- `@ponceca/storage-sdk/angular/fire/storage` -> wrapper Angular
+
+Para soportar código que importa `firebase/storage`, configura alias en la app consumidora (`tsconfig` + bundler) hacia `@ponceca/storage-sdk/firebase/storage`.
+
+## Funciones Exclusivas (Super-Firebase)
+
+### Thumbnails Automáticos
+
+```typescript
+import { getThumbnailURL } from '@ponceca/storage-sdk';
+
+// Thumbnail de 320px (por defecto)
+const thumbUrl = await getThumbnailURL(fileRef);
+
+// Thumbnail de tamaño específico
+const thumb500 = await getThumbnailURL(fileRef, 500);
+```
+
+### Video Streaming HLS
+
+```typescript
+import { getHLSStreamURL } from '@ponceca/storage-sdk';
+
+// Obtiene URL del manifest HLS (.m3u8)
+const hlsUrl = await getHLSStreamURL(fileRef);
+
+// Usar con video.js, hls.js, etc.
+```
+
+## Configuración del Backend
+
+Variables de entorno requeridas:
+
+```env
+DATABASE_URL=postgres://user:pass@localhost:5432/storage_db
+MINIO_ENDPOINT=localhost:9000
+MINIO_ACCESS_KEY=minioadmin
+MINIO_SECRET_KEY=minioadmin123
+JWT_SECRET=tu-secreto-jwt
+RATE_LIMIT_REQUESTS=10000
+```
+
+## Diferencias con Firebase Original
+
+| Característica | Firebase | Este Clon |
+|----------------|----------|-----------|
+| Thumbnails automáticos | ❌ | ✅ |
+| Video streaming HLS | ❌ | ✅ |
+| Self-hosted | ❌ | ✅ |
+| Rate limit configurable | Fijo | ✅ 10k/min |
+| Sin límites de egreso | ❌ (costoso) | ✅ |
+
+## Tests
+
+```bash
+cd productiontest
+node firebase_sdk_test.js
+```
+
+### Tests E2E reales del wrapper Angular (SDK compilado)
+
+La suite `tests/angular.wrapper.compat.test.ts` ejecuta operaciones reales contra backend usando `dist/src/angular-wrapper/index.js`.
+
+Variables requeridas:
+
+```bash
+set STORAGE_E2E_ENDPOINT=http://localhost:8080/api
+set STORAGE_E2E_TOKEN=tu_jwt_valido
+```
+
+Opcionales:
+
+```bash
+set STORAGE_E2E_API_KEY=tu_api_key
+set STORAGE_E2E_PROJECT=default
+set STORAGE_E2E_BUCKET=default
+```
+
+Ejecución:
+
+```bash
+npm run build:ts
+npm test -- tests/angular.wrapper.compat.test.ts --runInBand
+```
+
+Si faltan `STORAGE_E2E_ENDPOINT` o `STORAGE_E2E_TOKEN`, la suite se omite (`skip`) intencionalmente.
+
+## Licencia
+
+MIT

package/dist/src/angular/fire/storage.d.ts

@@ -0,0 +1,2 @@
+export * from '../../angular-wrapper';
+//# sourceMappingURL=storage.d.ts.map

package/dist/src/angular/fire/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../../src/angular/fire/storage.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/src/angular/fire/storage.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../../angular-wrapper"), exports);
+//# sourceMappingURL=storage.js.map

package/dist/src/angular/fire/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../../src/angular/fire/storage.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC"}

package/dist/src/angular-wrapper/index.d.ts

@@ -0,0 +1,19 @@
+import { FirebaseStorage, StorageReference, UploadTask } from '../index';
+export * from '../index';
+export interface StorageProviderOptions {
+    name?: string;
+}
+export interface UploadTaskSignals {
+    snapshot: any;
+    error: any;
+    state: any;
+    isDone: any;
+    isError: any;
+}
+export declare function getStorageToken(name?: string): any;
+export declare function provideStorage(factory: () => FirebaseStorage, options?: StorageProviderOptions): any[];
+export declare function injectStorage(name?: string): FirebaseStorage;
+export declare function uploadTaskObservable(task: UploadTask): any;
+export declare function uploadTaskSignal(task: UploadTask): UploadTaskSignals;
+export declare function downloadUrlSignal(storageRef: StorageReference): any;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/angular-wrapper/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/angular-wrapper/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,eAAe,EAEf,gBAAgB,EAChB,UAAU,EAGb,MAAM,UAAU,CAAC;AAElB,cAAc,UAAU,CAAC;AAKzB,MAAM,WAAW,sBAAsB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,GAAG,CAAC;IACd,KAAK,EAAE,GAAG,CAAC;IACX,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,EAAE,GAAG,CAAC;CAChB;AAqBD,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,GAAG,CASlD;AAED,wBAAgB,cAAc,CAC1B,OAAO,EAAE,MAAM,eAAe,EAC9B,OAAO,CAAC,EAAE,sBAAsB,GACjC,GAAG,EAAE,CAGP;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAW5D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,GAAG,CAkB1D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAwBpE;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,gBAAgB,GAAG,GAAG,CA8BnE"}

package/dist/src/angular-wrapper/index.js

@@ -0,0 +1,136 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStorageToken = getStorageToken;
+exports.provideStorage = provideStorage;
+exports.injectStorage = injectStorage;
+exports.uploadTaskObservable = uploadTaskObservable;
+exports.uploadTaskSignal = uploadTaskSignal;
+exports.downloadUrlSignal = downloadUrlSignal;
+const index_1 = require("../index");
+__exportStar(require("../index"), exports);
+const DEFAULT_STORAGE_INSTANCE = 'default';
+const STORAGE_TOKEN_CACHE = new Map();
+function _normalizeName(name) {
+    const value = (name || DEFAULT_STORAGE_INSTANCE).trim();
+    return value.length > 0 ? value : DEFAULT_STORAGE_INSTANCE;
+}
+function _loadAngularCore() {
+    try {
+        const core = require('@angular/core');
+        if (!core || !core.InjectionToken || !core.inject) {
+            throw new Error('Missing Angular DI symbols.');
+        }
+        return core;
+    }
+    catch (err) {
+        throw new Error('[@ponceca/storage-sdk/angular] Angular no disponible. Instala @angular/core y configura providers en app.config.ts.');
+    }
+}
+function getStorageToken(name) {
+    const instanceName = _normalizeName(name);
+    const cached = STORAGE_TOKEN_CACHE.get(instanceName);
+    if (cached)
+        return cached;
+    const core = _loadAngularCore();
+    const token = new core.InjectionToken(`PONCECA_STORAGE_${instanceName}`);
+    STORAGE_TOKEN_CACHE.set(instanceName, token);
+    return token;
+}
+function provideStorage(factory, options) {
+    const token = getStorageToken(options === null || options === void 0 ? void 0 : options.name);
+    return [{ provide: token, useFactory: factory }];
+}
+function injectStorage(name) {
+    const core = _loadAngularCore();
+    const token = getStorageToken(name);
+    try {
+        return core.inject(token);
+    }
+    catch (err) {
+        throw new Error(`[@ponceca/storage-sdk/angular] No se encontró provider para storage instance "${_normalizeName(name)}". Usa provideStorage(...) en app.config.ts.`);
+    }
+}
+function uploadTaskObservable(task) {
+    try {
+        const { Observable } = require('rxjs');
+        return new Observable((subscriber) => {
+            const unsubscribe = task.on('state_changed', (snapshot) => subscriber.next(snapshot), (error) => subscriber.error(error), () => subscriber.complete());
+            return () => {
+                if (typeof unsubscribe === 'function')
+                    unsubscribe();
+            };
+        });
+    }
+    catch (err) {
+        throw new Error('[@ponceca/storage-sdk/angular] rxjs no disponible. Instala rxjs para usar uploadTaskObservable.');
+    }
+}
+function uploadTaskSignal(task) {
+    const core = _loadAngularCore();
+    if (typeof core.signal !== 'function') {
+        throw new Error('[@ponceca/storage-sdk/angular] signal() no disponible. Requiere una versión moderna de Angular.');
+    }
+    const snapshot = core.signal(task.snapshot);
+    const error = core.signal(null);
+    const state = core.computed(() => { var _a; return ((_a = snapshot()) === null || _a === void 0 ? void 0 : _a.state) || 'running'; });
+    const isDone = core.computed(() => state() === 'success' || state() === 'canceled');
+    const isError = core.computed(() => state() === 'error');
+    task.on('state_changed', (nextSnapshot) => {
+        snapshot.set(nextSnapshot);
+    }, (nextError) => {
+        error.set(nextError);
+    });
+    return { snapshot, error, state, isDone, isError };
+}
+function downloadUrlSignal(storageRef) {
+    const core = _loadAngularCore();
+    if (typeof core.signal !== 'function' || typeof core.effect !== 'function') {
+        throw new Error('[@ponceca/storage-sdk/angular] signal/effect no disponible. Requiere una versión moderna de Angular.');
+    }
+    const url = core.signal(null);
+    const loading = core.signal(true);
+    const error = core.signal(null);
+    const refresh = () => __awaiter(this, void 0, void 0, function* () {
+        loading.set(true);
+        error.set(null);
+        try {
+            const value = yield (0, index_1.getDownloadURL)(storageRef);
+            url.set(value);
+        }
+        catch (err) {
+            error.set(err instanceof index_1.StorageError ? err : new index_1.StorageError('storage/unknown', (err === null || err === void 0 ? void 0 : err.message) || 'Unknown error'));
+            url.set(null);
+        }
+        finally {
+            loading.set(false);
+        }
+    });
+    queueMicrotask(() => {
+        refresh();
+    });
+    return { url, loading, error, refresh };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/angular-wrapper/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/angular-wrapper/index.ts"],"names":[],"mappings":"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"}

package/dist/src/firebase/storage.d.ts

@@ -0,0 +1,2 @@
+export * from '../index';
+//# sourceMappingURL=storage.d.ts.map

package/dist/src/firebase/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/firebase/storage.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/src/firebase/storage.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../index"), exports);
+//# sourceMappingURL=storage.js.map

package/dist/src/firebase/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/firebase/storage.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB"}

package/dist/src/index.d.ts

@@ -0,0 +1,115 @@
+/**
+ * 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
+ */
+export declare class StorageError extends Error {
+    readonly code: string;
+    readonly serverResponse: string | null;
+    constructor(code: string, message: string, serverResponse?: string | null);
+}
+export declare class AcmeStorageError extends StorageError {
+    constructor(code: string, message: string, serverResponse?: string | null);
+}
+export interface FirebaseStorage {
+    app: any;
+    config: {
+        authEndpoint: string;
+        tokenGetter: () => Promise<string | null>;
+        apiKey?: string;
+        project?: string;
+        bucket?: string;
+    };
+}
+export interface StorageReference {
+    storage: FirebaseStorage;
+    fullPath: string;
+    name: string;
+    bucket: string;
+    parent: StorageReference | null;
+    root: StorageReference;
+    _location: {
+        project: string;
+        bucket: string;
+        path: string;
+    };
+    _cachedMetadata?: any;
+}
+export type StorageObserver<T> = {
+    next?: (snapshot: T) => void;
+    error?: (error: StorageError) => void;
+    complete?: () => void;
+};
+export interface UploadTaskSnapshot {
+    bytesTransferred: number;
+    totalBytes: number;
+    state: 'running' | 'paused' | 'success' | 'error' | 'canceled';
+    metadata: any;
+    ref: StorageReference;
+    task: UploadTask;
+}
+export 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;
+}
+export interface SettableMetadata {
+    cacheControl?: string;
+    contentDisposition?: string;
+    contentEncoding?: string;
+    contentLanguage?: string;
+    contentType?: string;
+    customMetadata?: {
+        [key: string]: string;
+    };
+}
+export interface ListOptions {
+    maxResults?: number;
+    pageToken?: string;
+}
+export interface ListResult {
+    items: StorageReference[];
+    prefixes: StorageReference[];
+    nextPageToken?: string;
+}
+export type StringFormat = 'raw' | 'base64' | 'base64url' | 'data_url';
+export declare function getStorage(config: {
+    authEndpoint: string;
+    tokenGetter: () => Promise<string | null>;
+    apiKey?: string;
+    project?: string;
+    bucket?: string;
+}): FirebaseStorage;
+export declare function connectStorageEmulator(storage: FirebaseStorage, host: string, port: number): void;
+export declare function ref(storage: FirebaseStorage, path?: string): StorageReference;
+export declare function ref(reference: StorageReference, path?: string): StorageReference;
+export declare function child(parent: StorageReference, childPath: string): StorageReference;
+export declare function getParent(reference: StorageReference): StorageReference | null;
+export declare function getRoot(reference: StorageReference): StorageReference;
+export declare function getDownloadURL(storageRef: StorageReference): Promise<string>;
+export declare function getMetadata(storageRef: StorageReference): Promise<any>;
+export declare function updateMetadata(storageRef: StorageReference, metadata: SettableMetadata): Promise<any>;
+export declare function listAll(reference: StorageReference): Promise<{
+    items: StorageReference[];
+    prefixes: StorageReference[];
+}>;
+export declare function list(reference: StorageReference, options?: ListOptions): Promise<ListResult>;
+export declare function getBlob(storageRef: StorageReference, maxDownloadSizeBytes?: number): Promise<Blob>;
+export declare function getBytes(storageRef: StorageReference, maxDownloadSizeBytes?: number): Promise<ArrayBuffer>;
+export declare function getStream(storageRef: StorageReference, maxDownloadSizeBytes?: number): Promise<ReadableStream>;
+export declare function deleteObject(storageRef: StorageReference): Promise<void>;
+export declare function uploadBytesResumable(storageRef: StorageReference, data: Blob | Uint8Array | ArrayBuffer, metadata?: any): UploadTask;
+export declare function uploadBytes(storageRef: StorageReference, data: Blob | Uint8Array | ArrayBuffer, metadata?: any): Promise<UploadTaskSnapshot>;
+export declare function uploadString(storageRef: StorageReference, value: string, format?: StringFormat, metadata?: any): Promise<UploadTaskSnapshot>;
+export declare function getThumbnailURL(storageRef: StorageReference, width?: number): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

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

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