@dynlabs/react-native-immutable-file-cache 1.0.0-alpha.1 → 1.0.0-alpha.3

package/src/core/adapter.ts

@@ -4,6 +4,11 @@
  */
 export type TAdapterPath = string;
 
+/**
+ * Binary source type identifier.
+ */
+export type TBinarySourceType = TBinarySource["type"];
+
 /**
  * Discriminated union for binary content sources.
  * Adapters support the subset they can handle; throw UnsupportedSourceError otherwise.
@@ -59,6 +64,14 @@ export interface IStorageAdapter {
   /** A stable root identifier (e.g., absolute cache root on native, cache name on web). */
   readonly rootId: string;
 
+  /**
+   * Set of binary source types this adapter supports.
+   * Used for capability checking before attempting operations.
+   * If not provided, all source types are assumed to be potentially supported
+   * (with UnsupportedSourceError thrown at runtime for unsupported types).
+   */
+  readonly supportedSources?: ReadonlySet<TBinarySourceType>;
+
   // ─────────────────────────────────────────────────────────────────
   // Directory Management
   // ─────────────────────────────────────────────────────────────────
@@ -126,3 +139,18 @@ export interface IStorageAdapter {
    */
   getPublicUri(path: TAdapterPath): Promise<string>;
 }
+
+/**
+ * Checks if an adapter supports a given binary source type.
+ * Returns true if the adapter declares support or if no capability declaration exists.
+ */
+export function adapterSupportsSource(
+  adapter: IStorageAdapter,
+  sourceType: TBinarySourceType
+): boolean {
+  if (!adapter.supportedSources) {
+    // No capability declaration - assume all types potentially supported
+    return true;
+  }
+  return adapter.supportedSources.has(sourceType);
+}