@wild-framework/storage 0.1.1 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @wild-framework/storage
 
-File storage abstraction for [Wild Framework](https://github.com/your-org/wild-framework).
+File storage abstraction for [Wild Framework](https://github.com/KhandaSoftware/wild-framework).
 
 ## Install
 
@@ -13,13 +13,22 @@ pnpm add @wild-framework/storage
 ```ts
 import { Storage } from "@wild-framework/storage";
 
-await storage.put("avatars/photo.jpg", buffer);
+await storage.put("avatars/photo.jpg", buffer, { contentType: "image/jpeg" });
 const contents = await storage.get("avatars/photo.jpg");
 await storage.exists("avatars/photo.jpg");
 await storage.delete("avatars/photo.jpg");
+const url = await storage.url("avatars/photo.jpg"); // or { expiresIn: 3600 }
 ```
 
-Ships with a local filesystem driver. Implement `StorageDriver` for S3/GCS.
+Ships with a local filesystem driver (path-traversal-safe).
+
+Cloud backends:
+
+- `@wild-framework/storage-s3` — AWS S3 + S3-compatible (MinIO, R2, …)
+- `@wild-framework/storage-gcs` — Google Cloud Storage
+- `@wild-framework/storage-auto` — env-driven (`STORAGE_DRIVER`)
+
+Implement `StorageDriver` for any other backend.
 
 ## License
 

package/dist/driver.d.ts

@@ -1,3 +1,19 @@
+/**
+ * Options for storing a file.
+ */
+export interface PutOptions {
+    /** MIME type, e.g. `image/png`. Cloud backends store it as Content-Type. */
+    contentType?: string;
+    /** Arbitrary string metadata stored on backends that support it. */
+    metadata?: Record<string, string>;
+}
+/**
+ * Options for generating a URL.
+ */
+export interface UrlOptions {
+    /** Return a signed URL that expires after this many seconds (private buckets). */
+    expiresIn?: number;
+}
 /**
  * Storage driver contract.
  *
@@ -6,14 +22,14 @@
  */
 export interface StorageDriver {
     /** Store a file at the given path. Returns the stored path. */
-    put(path: string, contents: Buffer | string): Promise<string>;
+    put(path: string, contents: Buffer | string, options?: PutOptions): Promise<string>;
     /** Read a file's contents. */
     get(path: string): Promise<Buffer>;
     /** Delete a file. */
     delete(path: string): Promise<void>;
     /** Check whether a file exists. */
     exists(path: string): Promise<boolean>;
-    /** Get a public URL for a file. */
-    url(path: string): Promise<string>;
+    /** Get a URL (optionally signed) for a file. */
+    url(path: string, options?: UrlOptions): Promise<string>;
 }
 //# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC1B,+DAA+D;IAC/D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,8BAA8B;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,qBAAqB;IACrB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,mCAAmC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,mCAAmC;IACnC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC"}
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC1B,+DAA+D;IAC/D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpF,8BAA8B;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,qBAAqB;IACrB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,mCAAmC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,gDAAgD;IAChD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5D"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { Storage } from "./storage.js";
 export { StorageProvider } from "./provider.js";
 export { LocalStorageDriver } from "./local-driver.js";
-export type { StorageDriver } from "./driver.js";
+export type { StorageDriver, PutOptions, UrlOptions } from "./driver.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/local-driver.d.ts

@@ -1,4 +1,4 @@
-import type { StorageDriver } from "./driver.js";
+import type { StorageDriver, PutOptions, UrlOptions } from "./driver.js";
 /**
  * Filesystem-backed storage driver.
  *
@@ -7,11 +7,13 @@ import type { StorageDriver } from "./driver.js";
 export declare class LocalStorageDriver implements StorageDriver {
     private basePath;
     constructor(basePath: string);
-    put(filePath: string, contents: Buffer | string): Promise<string>;
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    put(filePath: string, contents: Buffer | string, _options?: PutOptions): Promise<string>;
     get(filePath: string): Promise<Buffer>;
     delete(filePath: string): Promise<void>;
     exists(filePath: string): Promise<boolean>;
-    url(filePath: string): Promise<string>;
+    url(filePath: string, _options?: UrlOptions): Promise<string>;
     private resolve;
 }
 //# sourceMappingURL=local-driver.d.ts.map

package/dist/local-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-driver.d.ts","sourceRoot":"","sources":["../src/local-driver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACxC,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAM9B,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOjE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU1C,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK5C,OAAO,CAAC,OAAO;CAWlB"}
+{"version":3,"file":"local-driver.d.ts","sourceRoot":"","sources":["../src/local-driver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzE;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACxC,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAM9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAOxF,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU1C,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnE,OAAO,CAAC,OAAO;CAWlB"}

package/dist/local-driver.js

@@ -13,7 +13,13 @@ export class LocalStorageDriver {
             throw new Error("LocalStorageDriver requires a base path.");
         }
     }
-    async put(filePath, contents) {
+    async connect() {
+        // No persistent connection — kept for provider symmetry.
+    }
+    async close() {
+        // No persistent connection — kept for provider symmetry.
+    }
+    async put(filePath, contents, _options) {
         const absolute = this.resolve(filePath);
         await fs.mkdir(path.dirname(absolute), { recursive: true });
         await fs.writeFile(absolute, contents);
@@ -37,7 +43,7 @@ export class LocalStorageDriver {
             return false;
         }
     }
-    async url(filePath) {
+    async url(filePath, _options) {
         // Local files don't have a public URL — return the path.
         return filePath;
     }

package/dist/local-driver.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-driver.js","sourceRoot":"","sources":["../src/local-driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IACP;IAApB,YAAoB,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAChE,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,QAAyB;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACvC,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC;YACD,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB;QACtB,yDAAyD;QACzD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAEO,OAAO,CAAC,QAAgB;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAE9C,oDAAoD;QACpD,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,uCAAuC,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;CACJ"}
+{"version":3,"file":"local-driver.js","sourceRoot":"","sources":["../src/local-driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IACP;IAApB,YAAoB,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAChE,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO;QACT,yDAAyD;IAC7D,CAAC;IAED,KAAK,CAAC,KAAK;QACP,yDAAyD;IAC7D,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,QAAyB,EAAE,QAAqB;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACvC,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC;YACD,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,QAAqB;QAC7C,yDAAyD;QACzD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAEO,OAAO,CAAC,QAAgB;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAE9C,oDAAoD;QACpD,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,uCAAuC,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;CACJ"}

package/dist/provider.d.ts

@@ -1,12 +1,21 @@
 import type { Provider, Application } from "@wild-framework/core";
 /**
- * Registers the file storage with the application.
+ * Registers local filesystem storage with the application.
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * StorageProvider.basePath = "./uploads"; // default "./storage"
+ * ```
  *
- * Binds a `Storage` backed by the local filesystem driver.
  * Swap drivers by implementing `StorageDriver` and binding a new
- * `Storage` — app code never changes.
+ * `Storage` — app code never changes. Cloud backends live in
+ * `@wild-framework/storage-s3`, `@wild-framework/storage-gcs`,
+ * and the env-driven `@wild-framework/storage-auto`.
  */
 export declare class StorageProvider implements Provider {
+    /** Local filesystem base directory. Defaults to `./storage`. */
+    static basePath: string;
     register(app: Application): void;
 }
 //# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAKlE;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC5C,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAKnC"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAKlE;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC5C,gEAAgE;IAChE,MAAM,CAAC,QAAQ,SAAe;IAE9B,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAKnC"}

package/dist/provider.js

@@ -2,16 +2,25 @@ import { Container } from "@wild-framework/container";
 import { Storage } from "./storage.js";
 import { LocalStorageDriver } from "./local-driver.js";
 /**
- * Registers the file storage with the application.
+ * Registers local filesystem storage with the application.
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * StorageProvider.basePath = "./uploads"; // default "./storage"
+ * ```
  *
- * Binds a `Storage` backed by the local filesystem driver.
  * Swap drivers by implementing `StorageDriver` and binding a new
- * `Storage` — app code never changes.
+ * `Storage` — app code never changes. Cloud backends live in
+ * `@wild-framework/storage-s3`, `@wild-framework/storage-gcs`,
+ * and the env-driven `@wild-framework/storage-auto`.
  */
 export class StorageProvider {
+    /** Local filesystem base directory. Defaults to `./storage`. */
+    static basePath = "./storage";
     register(app) {
         const container = app.resolve(Container);
-        const storage = new Storage(new LocalStorageDriver("./storage"));
+        const storage = new Storage(new LocalStorageDriver(StorageProvider.basePath));
         container.singleton(Storage, () => storage);
     }
 }

package/dist/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IACxB,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC;QACjE,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;CACJ"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,eAAe;IACxB,gEAAgE;IAChE,MAAM,CAAC,QAAQ,GAAG,WAAW,CAAC;IAE9B,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,kBAAkB,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9E,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC"}

package/dist/storage.d.ts

@@ -1,4 +1,4 @@
-import type { StorageDriver } from "./driver.js";
+import type { StorageDriver, PutOptions, UrlOptions } from "./driver.js";
 /**
  * File storage facade.
  *
@@ -9,14 +9,14 @@ export declare class Storage {
     private driver;
     constructor(driver: StorageDriver);
     /** Store a file at the given path. Returns the stored path. */
-    put(path: string, contents: Buffer | string): Promise<string>;
+    put(path: string, contents: Buffer | string, options?: PutOptions): Promise<string>;
     /** Read a file's contents. */
     get(path: string): Promise<Buffer>;
     /** Delete a file. */
     delete(path: string): Promise<void>;
     /** Check whether a file exists. */
     exists(path: string): Promise<boolean>;
-    /** Get a public URL for a file. */
-    url(path: string): Promise<string>;
+    /** Get a URL (optionally signed) for a file. */
+    url(path: string, options?: UrlOptions): Promise<string>;
 }
 //# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;GAKG;AACH,qBAAa,OAAO;IACJ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC,+DAA+D;IAC/D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7D,8BAA8B;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlC,qBAAqB;IACrB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,mCAAmC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,mCAAmC;IACnC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAGrC"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzE;;;;;GAKG;AACH,qBAAa,OAAO;IACJ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC,+DAA+D;IAC/D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAInF,8BAA8B;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlC,qBAAqB;IACrB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,mCAAmC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,gDAAgD;IAChD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAG3D"}

package/dist/storage.js

@@ -10,8 +10,8 @@ export class Storage {
         this.driver = driver;
     }
     /** Store a file at the given path. Returns the stored path. */
-    put(path, contents) {
-        return this.driver.put(path, contents);
+    put(path, contents, options) {
+        return this.driver.put(path, contents, options);
     }
     /** Read a file's contents. */
     get(path) {
@@ -25,9 +25,9 @@ export class Storage {
     exists(path) {
         return this.driver.exists(path);
     }
-    /** Get a public URL for a file. */
-    url(path) {
-        return this.driver.url(path);
+    /** Get a URL (optionally signed) for a file. */
+    url(path, options) {
+        return this.driver.url(path, options);
     }
 }
 //# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,OAAO;IACI;IAApB,YAAoB,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAE7C,+DAA+D;IAC/D,GAAG,CAAC,IAAY,EAAE,QAAyB;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,8BAA8B;IAC9B,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,qBAAqB;IACrB,MAAM,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,mCAAmC;IACnC,MAAM,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,mCAAmC;IACnC,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACJ"}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,OAAO;IACI;IAApB,YAAoB,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAE7C,+DAA+D;IAC/D,GAAG,CAAC,IAAY,EAAE,QAAyB,EAAE,OAAoB;QAC7D,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,8BAA8B;IAC9B,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,qBAAqB;IACrB,MAAM,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,mCAAmC;IACnC,MAAM,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,gDAAgD;IAChD,GAAG,CAAC,IAAY,EAAE,OAAoB;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;CACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wild-framework/storage",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -31,8 +31,8 @@
     "s3"
   ],
   "dependencies": {
-    "@wild-framework/core": "0.1.1",
-    "@wild-framework/container": "0.1.1"
+    "@wild-framework/core": "0.2.0",
+    "@wild-framework/container": "0.2.0"
   },
   "scripts": {
     "build": "tsc",