@voltro/plugin-storage 0.71.1 → 0.72.0

package/dist/types.d.ts

@@ -125,6 +125,17 @@ export declare interface PutInput {
     readonly derivedFrom?: string;
     /** Derivative label — `'rendition'` / `'poster'` (internal). */
     readonly kind?: string;
+    /**
+     * The RESUMABLE identity of this put. Two calls with the same `operationId`
+     * (a retry after a network failure, two replicas completing the same job)
+     * resolve to ONE reference: the second finds the first's reservation and
+     * returns its ref, or finishes what the first left half-done. Without it a
+     * put is a fresh object every time — and a retried put beside its winner
+     * left a second reference on the same key whose bytes outlived the winner's
+     * delete. Any stable string the caller owns (a job id, a message id).
+     * Needs a bound data store; the in-memory ref store cannot hold intents.
+     */
+    readonly operationId?: string;
 }
 
 /** One derived output a `Transcoder` produces from a source asset. Each becomes
@@ -479,6 +490,8 @@ export declare interface StorageServiceShape {
         readonly abortSignal?: AbortSignal;
         readonly contentType?: string;
         readonly tenantId?: string | null;
+        /** The resumable identity of this ingest — see `PutInput.operationId`. */
+        readonly operationId?: string;
         readonly ownerId?: string | null;
         readonly visibility?: StorageVisibility;
         readonly key?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-storage",
-  "version": "0.71.1",
+  "version": "0.72.0",
   "description": "File-storage plugin — one StorageProvider contract, switchable backends (S3 / MinIO / Azure / filesystem / memory / database). Public (CDN-direct) + private (access policy + per-object grants) objects, upload constraints, virus-scan hook, on-the-fly image transforms.",
   "keywords": [
     "voltro",
@@ -43,9 +43,9 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/database": "0.71.1",
-    "@voltro/env": "0.71.1",
-    "@voltro/protocol": "0.71.1"
+    "@voltro/database": "0.72.0",
+    "@voltro/env": "0.72.0",
+    "@voltro/protocol": "0.72.0"
   },
   "optionalDependencies": {
     "@aws-sdk/client-s3": "^3.1126.0",