@pol-studios/powersync 1.0.7 → 1.0.10

package/dist/types-Bgvx7-E8.d.ts

@@ -1,187 +0,0 @@
-import { LoggerAdapter } from './platform/index.js';
-
-/**
- * Storage Types for @pol-studios/powersync
- *
- * Defines interfaces for pluggable storage adapters supporting
- * different backend storage providers (Supabase, S3, etc.).
- */
-/**
- * Function type for resolving storage bucket from a file path.
- *
- * @example
- * ```typescript
- * const resolver: BucketResolver = (path) => {
- *   if (path.startsWith('avatars/')) return 'user-avatars';
- *   if (path.startsWith('docs/')) return 'documents';
- *   return 'default-bucket';
- * };
- * ```
- */
-type BucketResolver = (storagePath: string) => string;
-/**
- * Configuration for bucket resolution.
- * Supports multiple strategies: default bucket, prefix mapping, or custom resolver.
- */
-interface BucketConfig {
-    /** Default bucket when no other rule matches */
-    defaultBucket: string;
-    /**
-     * Map of path prefixes to bucket names.
-     * Checked in iteration order (use Map to preserve order).
-     *
-     * @example
-     * ```typescript
-     * const bucketMap = new Map([
-     *   ['avatars/', 'user-avatars'],
-     *   ['docs/', 'documents'],
-     * ]);
-     * ```
-     */
-    bucketMap?: Map<string, string>;
-    /**
-     * Custom resolver function (takes precedence over bucketMap).
-     * Return undefined to fall through to bucketMap/defaultBucket.
-     */
-    resolver?: (storagePath: string) => string | undefined;
-}
-/**
- * Resolve bucket from a storage path using BucketConfig.
- *
- * Resolution order:
- * 1. Custom resolver (if provided and returns a value)
- * 2. bucketMap prefix matching (if provided)
- * 3. defaultBucket
- */
-declare function resolveBucketFromConfig(config: BucketConfig, storagePath: string): string;
-/**
- * Interface for remote storage download adapters.
- * Implement this to support non-Supabase storage backends.
- */
-interface RemoteStorageAdapter {
-    /**
-     * Download a file from remote storage to local path.
-     */
-    download(remotePath: string, localPath: string): Promise<void>;
-    /**
-     * Get a signed download URL for a remote file.
-     */
-    getDownloadUrl(remotePath: string): Promise<string>;
-    /**
-     * Check if a file exists in remote storage.
-     */
-    exists(remotePath: string): Promise<boolean>;
-}
-/**
- * Options for upload operations.
- */
-interface UploadOptions {
-    contentType?: string;
-    onProgress?: (progress: {
-        loaded: number;
-        total: number;
-    }) => void;
-}
-/**
- * Interface for attachment upload handlers.
- * Implement this to support non-Supabase upload backends.
- */
-interface AttachmentUploadHandler {
-    /**
-     * Upload a file from local path to remote storage.
-     */
-    upload(localPath: string, remotePath: string, options?: UploadOptions): Promise<void>;
-    /**
-     * Get a signed upload URL (optional, for direct uploads).
-     */
-    getUploadUrl?(remotePath: string): Promise<string>;
-}
-/**
- * Interface for platform-specific upload handlers.
- * Used by SupabaseUploadHandler implementations.
- *
- * Note: This is named StorageUploadHandler to avoid conflicts with
- * the UploadHandler interface in attachments/types.ts which has
- * slightly different semantics.
- */
-interface StorageUploadHandler {
-    /**
-     * Upload a file to remote storage.
-     *
-     * @param storagePath - Remote path in storage bucket
-     * @param localFileUri - Local file URI (file:// on native, blob URL on web)
-     * @param mediaType - MIME type of the file
-     * @param signal - Optional AbortSignal for cancellation
-     */
-    uploadFile(storagePath: string, localFileUri: string, mediaType: string, signal?: AbortSignal): Promise<void>;
-    /**
-     * Resolve the storage bucket for a given path.
-     */
-    resolveBucket(storagePath: string): string;
-}
-
-/**
- * Options for creating a SupabaseStorageAdapter.
- */
-interface SupabaseStorageAdapterOptions {
-    /** Supabase client instance */
-    client: any;
-    /** Bucket configuration for multi-bucket routing */
-    bucketConfig: BucketConfig;
-    /**
-     * Custom signed URL expiry in seconds.
-     * @default 60 (short-lived for security)
-     */
-    signedUrlExpiry?: number;
-    /**
-     * Optional logger for diagnostic messages.
-     * If not provided, falls back to console.warn for warnings.
-     */
-    logger?: LoggerAdapter;
-}
-/**
- * Result of a download operation.
- */
-interface DownloadResult {
-    /** Local file path where the file was saved */
-    localPath: string;
-    /** MIME type of the downloaded file */
-    mimeType: string;
-    /** Size of the downloaded file in bytes */
-    size: number;
-}
-/**
- * PowerSync StorageAdapter interface from @powersync/attachments.
- * Re-declared here to avoid import dependency.
- */
-interface PowerSyncStorageAdapter {
-    /** Upload a file to remote storage */
-    uploadFile(filename: string, data: ArrayBuffer, options?: {
-        mediaType?: string;
-    }): Promise<void>;
-    /** Download a file from remote storage */
-    downloadFile(filePath: string): Promise<Blob>;
-    /** Write a file to local storage */
-    writeFile(fileURI: string, base64Data: string, options?: {
-        encoding?: 'utf8' | 'base64';
-    }): Promise<void>;
-    /** Read a file from local storage */
-    readFile(fileURI: string, options?: {
-        encoding?: 'utf8' | 'base64';
-        mediaType?: string;
-    }): Promise<ArrayBuffer>;
-    /** Delete a local file */
-    deleteFile(uri: string, options?: {
-        filename?: string;
-    }): Promise<void>;
-    /** Check if a local file exists */
-    fileExists(fileURI: string): Promise<boolean>;
-    /** Create a directory */
-    makeDir(uri: string): Promise<void>;
-    /** Copy a file */
-    copyFile(sourceUri: string, targetUri: string): Promise<void>;
-    /** Get the user storage directory */
-    getUserStorageDirectory(): string;
-}
-
-export { type AttachmentUploadHandler as A, type BucketResolver as B, type DownloadResult as D, type PowerSyncStorageAdapter as P, type RemoteStorageAdapter as R, type StorageUploadHandler as S, type UploadOptions as U, type BucketConfig as a, type SupabaseStorageAdapterOptions as b, resolveBucketFromConfig as r };