@usegraft/assets 1.0.0-beta.2 → 1.0.0-beta.3

package/dist/index.d.ts

@@ -24,8 +24,22 @@ declare function defaultKeyFor(file: string): string;
 interface PresignOptions {
     expiresIn?: number;
 }
+interface PutOptions {
+    /**
+     * Write only if nothing is stored under the key yet. Sent as
+     * `If-None-Match: *`, so the store decides, not a separate existence check
+     * that a concurrent upload could slip past. A taken key throws
+     * AssetKeyTakenError. A store that ignores the header writes as usual.
+     */
+    ifAbsent?: boolean;
+}
+/** The key already held an object, and the put asked for `ifAbsent`. */
+declare class AssetKeyTakenError extends Error {
+    readonly key: string;
+    constructor(key: string);
+}
 interface Storage {
-    put(key: string, body: Uint8Array | string, contentType?: string): Promise<void>;
+    put(key: string, body: Uint8Array | string, contentType?: string, options?: PutOptions): Promise<void>;
     get(key: string): Promise<Uint8Array>;
     delete(key: string): Promise<void>;
     exists(key: string): Promise<boolean>;
@@ -41,4 +55,4 @@ interface Storage {
 }
 declare function createStorage(config?: StorageConfig): Storage;
 
-export { type PresignOptions, type Storage, type StorageConfig, contentTypeFor, createStorage, defaultKeyFor, storageConfigFromEnv };
+export { AssetKeyTakenError, type PresignOptions, type PutOptions, type Storage, type StorageConfig, contentTypeFor, createStorage, defaultKeyFor, storageConfigFromEnv };

package/dist/index.js

@@ -41,6 +41,14 @@ function defaultKeyFor(file) {
 
 // src/storage.ts
 import { AwsClient } from "aws4fetch";
+var AssetKeyTakenError = class extends Error {
+  key;
+  constructor(key) {
+    super(`An object is already stored under "${key}".`);
+    this.name = "AssetKeyTakenError";
+    this.key = key;
+  }
+};
 function withoutTrailingSlashes(value) {
   let end = value.length;
   while (end > 0 && value.charCodeAt(end - 1) === 47) end -= 1;
@@ -62,12 +70,12 @@ function createStorage(config = storageConfigFromEnv()) {
     return signed.url;
   };
   return {
-    async put(key, body, contentType) {
-      const res = await aws.fetch(urlFor(key), {
-        method: "PUT",
-        body,
-        headers: contentType ? { "content-type": contentType } : void 0
-      });
+    async put(key, body, contentType, options = {}) {
+      const headers = {};
+      if (contentType) headers["content-type"] = contentType;
+      if (options.ifAbsent) headers["if-none-match"] = "*";
+      const res = await aws.fetch(urlFor(key), { method: "PUT", body, headers });
+      if (res.status === 412 && options.ifAbsent) throw new AssetKeyTakenError(key);
       if (!res.ok) throw new Error(`storage put failed (${res.status}): ${await res.text()}`);
     },
     async get(key) {
@@ -99,6 +107,7 @@ function createStorage(config = storageConfigFromEnv()) {
   };
 }
 export {
+  AssetKeyTakenError,
   contentTypeFor,
   createStorage,
   defaultKeyFor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usegraft/assets",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.3",
   "description": "S3-compatible object storage for binary assets: Cloudflare R2, MinIO, Tigris.",
   "keywords": [
     "agent",