@meistrari/vault-sdk 3.0.0 → 3.1.1

package/dist/index.cjs

@@ -48,7 +48,7 @@ class FetchError extends Error {
     this.name = "FetchError";
   }
   static async from(url, method, response) {
-    const text = await response.clone().json().then((json) => JSON.stringify(json, null, 2)).catch(() => response.clone().text());
+    const text = await response.clone().json().then((json) => JSON.stringify(json, null, 2)).catch(async () => await response.clone().text());
     const error = new FetchError(`Failed to ${method} ${url}: ${response.status} ${response.statusText}:
 ${text}`, url, method, response);
     return error;
@@ -237,7 +237,7 @@ function getFileName(content) {
 }
 
 const name = "@meistrari/vault-sdk";
-const version = "3.0.0";
+const version = "3.1.1";
 const license = "UNLICENSED";
 const repository = {
 	type: "git",
@@ -264,8 +264,8 @@ const scripts = {
 	check: "bun run lint && bun tsc --noEmit"
 };
 const dependencies = {
-	"@meistrari/file-type": "^22.0.0",
-	"@meistrari/vault-shared": "0.0.7",
+	"@meistrari/file-type": "22.0.0",
+	"@meistrari/vault-shared": "0.1.0",
 	"mime-types": "3.0.1",
 	ofetch: "1.4.1",
 	zod: "3.23.8"
@@ -309,6 +309,7 @@ var __publicField = (obj, key, value) => {
   return value;
 };
 const compatibilityDate = "2025-05-19";
+const bunStreamingUploadFixVersion = "1.3.10";
 function detectMimeTypeFromFilename(filename) {
   const extension = filename.split(".").pop()?.toLowerCase();
   if (extension) {
@@ -319,6 +320,30 @@ function detectMimeTypeFromFilename(filename) {
   }
   return void 0;
 }
+function compareDottedVersions(left, right) {
+  const leftParts = left.split(".");
+  const rightParts = right.split(".");
+  const length = Math.max(leftParts.length, rightParts.length);
+  for (let index = 0; index < length; index++) {
+    const leftPart = Number.parseInt(leftParts[index] ?? "0", 10);
+    const rightPart = Number.parseInt(rightParts[index] ?? "0", 10);
+    const normalizedLeft = Number.isNaN(leftPart) ? 0 : leftPart;
+    const normalizedRight = Number.isNaN(rightPart) ? 0 : rightPart;
+    if (normalizedLeft !== normalizedRight) {
+      return normalizedLeft - normalizedRight;
+    }
+  }
+  return 0;
+}
+function shouldBufferStreamingUploadForBunVersion(bunVersion) {
+  return compareDottedVersions(bunVersion, bunStreamingUploadFixVersion) < 0;
+}
+function shouldBufferStreamingUploadOnBun() {
+  if (typeof Bun === "undefined") {
+    return false;
+  }
+  return shouldBufferStreamingUploadForBunVersion(Bun.version);
+}
 async function wrappedFetch(url, requestInit) {
   const options = {
     ...requestInit,
@@ -426,7 +451,7 @@ class VaultFile {
   async _createFile(metadata = {}, options) {
     const response = await this._fetch({
       method: "POST",
-      path: `files`,
+      path: "files",
       body: JSON.stringify({
         size: metadata.size,
         mimeType: metadata.mimeType,
@@ -495,7 +520,7 @@ class VaultFile {
       method: "GET",
       headers: authStrategy.getHeaders(),
       signal: options?.signal
-    }).then((response2) => response2.json()).then((data) => schemas.GetDownloadUrlResponse.safeParse(data));
+    }).then(async (response2) => await response2.json()).then((data) => schemas.GetDownloadUrlResponse.safeParse(data));
     if (!response.success) {
       throw new Error("Invalid response from vault service");
     }
@@ -509,7 +534,7 @@ class VaultFile {
       name: response.data.metadata?.originalFileName ?? void 0
     };
     if (download) {
-      await wrappedFetch(response.data.url, { method: "GET", signal: options?.signal }).then((response2) => response2.blob()).then((blob) => fileParams.content = blob);
+      await wrappedFetch(response.data.url, { method: "GET", signal: options?.signal }).then(async (response2) => await response2.blob()).then((blob) => fileParams.content = blob);
     }
     return new VaultFile(fileParams);
   }
@@ -732,8 +757,8 @@ class VaultFile {
       const file = new VaultFile({
         config,
         id: item.id,
-        name: item.metadata?.originalFileName ?? preparedFiles[index].name,
-        content: preparedFiles[index].content,
+        name: item.metadata.originalFileName ?? preparedFiles[index]?.name,
+        content: preparedFiles[index]?.content,
         metadata: item.metadata
       });
       file.lastUploadUrl = {
@@ -745,7 +770,7 @@ class VaultFile {
     if (upload) {
       await Promise.all(
         vaultFiles.map(
-          (file) => file.upload(void 0, void 0, { signal: options?.signal })
+          async (file) => await file.upload(void 0, void 0, { signal: options?.signal })
         )
       );
     }
@@ -812,7 +837,7 @@ class VaultFile {
       const file = new VaultFile({
         config,
         id: item.id,
-        name: item.metadata?.originalFileName ?? preparedFiles[index].name,
+        name: item.metadata?.originalFileName ?? preparedFiles[index]?.name,
         metadata: item.metadata
       });
       file.lastUploadUrl = {
@@ -867,6 +892,7 @@ class VaultFile {
     } catch (error) {
       console.error("Error fetching file metadata", error);
     }
+    return void 0;
   }
   /**
    * Returns the vault URI reference for this file.
@@ -1006,7 +1032,7 @@ class VaultFile {
       path: `files/${this.id}`,
       signal: options?.signal,
       ...options?.expiresIn ? { query: { expiresIn: options.expiresIn.toString() } } : {}
-    }).then(schemas.GetUploadUrlResponseV2.safeParse);
+    }).then((result) => schemas.GetUploadUrlResponseV2.safeParse(result));
     if (!response.success) {
       throw new Error(`Invalid response from vault service. ${JSON.stringify(response.error)}`);
     }
@@ -1211,7 +1237,8 @@ class VaultFile {
    *
    * This method is ideal for uploading large files without loading the entire content into memory.
    * The stream is sent directly to cloud storage, making it perfect for files larger than a few
-   * megabytes. Note: When using Bun, the stream is buffered due to implementation limitations.
+   * megabytes. Note: On Bun versions older than 1.3.10, the stream is buffered due to
+   * implementation limitations.
    *
    * @param stream - A ReadableStream of Uint8Array chunks containing the file data
    * @param options - Required options for the upload
@@ -1278,10 +1305,10 @@ class VaultFile {
     headers.set("Content-Type", mimeType);
     headers.set("Content-Length", contentLength.toString());
     let content = stream;
-    if (stream instanceof ReadableStream && typeof Bun !== "undefined") {
+    if (stream instanceof ReadableStream && shouldBufferStreamingUploadOnBun()) {
       console.warn(
-        "[Vault SDK - WARNING] Buffering file upload due to Bun fetch implementation. Large files may cause memory issues. Consider using Node.js for streaming uploads.",
-        { fileName: this.name, fileSize: contentLength }
+        `[Vault SDK - WARNING] Buffering file upload on Bun ${Bun.version}. Streaming uploads are only buffered on Bun versions older than ${bunStreamingUploadFixVersion}. Large files may cause memory issues. Upgrade Bun or use Node.js for streaming uploads.`,
+        { fileName: this.name, fileSize: contentLength, bunVersion: Bun.version }
       );
       const chunks = [];
       const reader = stream.getReader();
@@ -1412,7 +1439,7 @@ class VaultFile {
     if (!this.metadata?.workspaceId) {
       throw new Error("Workspace ID is not set. Call populateMetadata() to populate the metadata fields.");
     }
-    return Permalink.create(this.config, {
+    return await Permalink.create(this.config, {
       fileId: this.id,
       workspaceId: this.metadata.workspaceId,
       expiresIn: params.expiresIn
@@ -1685,7 +1712,7 @@ class VaultFile {
     if (!this.id) {
       throw new Error("Parent file ID is not set");
     }
-    return VaultFile.fromContent(
+    return await VaultFile.fromContent(
       {
         ...params,
         config: this.config,
@@ -1734,7 +1761,7 @@ class VaultFile {
     if (!this.id) {
       throw new Error("Parent file ID is not set");
     }
-    return VaultFile.fromStream(
+    return await VaultFile.fromStream(
       {
         ...params,
         config: this.config,
@@ -1809,8 +1836,8 @@ class VaultFile {
   }
 }
 
-const VAULT_REFERENCE_UUID_REGEX = /^vault:\/\/[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-const VAULT_REFERENCE_SHA256_REGEX = /^vault:\/\/[a-f0-9]{64}$/i;
+const VAULT_REFERENCE_UUID_REGEX = /vault:\/\/[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/i;
+const VAULT_REFERENCE_SHA256_REGEX = /vault:\/\/[a-f0-9]{64}/i;
 function isValidUuidV4(uuid) {
   return /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(uuid);
 }
@@ -1840,7 +1867,14 @@ function isS3UrlExpired(url) {
   }
 }
 function isVaultReference(url) {
-  return VAULT_REFERENCE_UUID_REGEX.test(url) || VAULT_REFERENCE_SHA256_REGEX.test(url);
+  return new RegExp(`^${VAULT_REFERENCE_UUID_REGEX.source}$`, "i").test(url) || new RegExp(`^${VAULT_REFERENCE_SHA256_REGEX.source}$`, "i").test(url);
+}
+function extractVaultReferences(text) {
+  const uuidRegex = new RegExp(VAULT_REFERENCE_UUID_REGEX.source, "gi");
+  const sha256Regex = new RegExp(VAULT_REFERENCE_SHA256_REGEX.source, "gi");
+  const uuidMatches = text.match(uuidRegex) || [];
+  const sha256Matches = text.match(sha256Regex) || [];
+  return [...uuidMatches, ...sha256Matches];
 }
 function isPresignedS3Url(url) {
   try {
@@ -1985,6 +2019,7 @@ exports.FetchError = FetchError;
 exports.VaultFile = VaultFile;
 exports.convertS3UrlToVaultReference = convertS3UrlToVaultReference;
 exports.extractVaultFileIdFromS3Url = extractVaultFileIdFromS3Url;
+exports.extractVaultReferences = extractVaultReferences;
 exports.getVaultParamsFromS3Url = getVaultParamsFromS3Url;
 exports.isS3UrlExpired = isS3UrlExpired;
 exports.isTaggedVaultPresignedUrl = isTaggedVaultPresignedUrl;

package/dist/index.d.cts

@@ -786,7 +786,8 @@ declare class VaultFile {
      *
      * This method is ideal for uploading large files without loading the entire content into memory.
      * The stream is sent directly to cloud storage, making it perfect for files larger than a few
-     * megabytes. Note: When using Bun, the stream is buffered due to implementation limitations.
+     * megabytes. Note: On Bun versions older than 1.3.10, the stream is buffered due to
+     * implementation limitations.
      *
      * @param stream - A ReadableStream of Uint8Array chunks containing the file data
      * @param options - Required options for the upload
@@ -1271,6 +1272,18 @@ declare function isS3UrlExpired(url: string): boolean;
  * @returns true if the URL is a valid vault reference, false otherwise
  */
 declare function isVaultReference(url: string): boolean;
+/**
+ * Extracts all vault references from a given text string.
+ * Finds both UUID v4 and SHA-256 hash format vault references.
+ *
+ * @param text - The text to search for vault references
+ * @returns An array of vault reference strings found in the text
+ * @example
+ * const text = 'Files: vault://2fce5740-83da-49fe-3f10-b32205893ec0 and vault://abc123...def'
+ * const refs = extractVaultReferences(text)
+ * // Returns: ['vault://2fce5740-83da-49fe-3f10-b32205893ec0', 'vault://abc123...def']
+ */
+declare function extractVaultReferences(text: string): string[];
 /**
  * Checks if a URL seems like a valid presigned S3 URL, with no additional checks.
  *
@@ -1388,5 +1401,5 @@ declare function vaultClient(vaultConfig: VaultConfig): {
     }) => Promise<VaultFile[]>;
 };
 
-export { APIKeyAuthStrategy, DataTokenAuthStrategy, FetchError, VaultFile, convertS3UrlToVaultReference, extractVaultFileIdFromS3Url, getVaultParamsFromS3Url, isS3UrlExpired, isTaggedVaultPresignedUrl, isPresignedS3Url as isVaultFileS3Url, isVaultReference, vaultClient };
+export { APIKeyAuthStrategy, DataTokenAuthStrategy, FetchError, VaultFile, convertS3UrlToVaultReference, extractVaultFileIdFromS3Url, extractVaultReferences, getVaultParamsFromS3Url, isS3UrlExpired, isTaggedVaultPresignedUrl, isPresignedS3Url as isVaultFileS3Url, isVaultReference, vaultClient };
 export type { AuthStrategy, VaultConfig };

package/dist/index.d.mts

@@ -786,7 +786,8 @@ declare class VaultFile {
      *
      * This method is ideal for uploading large files without loading the entire content into memory.
      * The stream is sent directly to cloud storage, making it perfect for files larger than a few
-     * megabytes. Note: When using Bun, the stream is buffered due to implementation limitations.
+     * megabytes. Note: On Bun versions older than 1.3.10, the stream is buffered due to
+     * implementation limitations.
      *
      * @param stream - A ReadableStream of Uint8Array chunks containing the file data
      * @param options - Required options for the upload
@@ -1271,6 +1272,18 @@ declare function isS3UrlExpired(url: string): boolean;
  * @returns true if the URL is a valid vault reference, false otherwise
  */
 declare function isVaultReference(url: string): boolean;
+/**
+ * Extracts all vault references from a given text string.
+ * Finds both UUID v4 and SHA-256 hash format vault references.
+ *
+ * @param text - The text to search for vault references
+ * @returns An array of vault reference strings found in the text
+ * @example
+ * const text = 'Files: vault://2fce5740-83da-49fe-3f10-b32205893ec0 and vault://abc123...def'
+ * const refs = extractVaultReferences(text)
+ * // Returns: ['vault://2fce5740-83da-49fe-3f10-b32205893ec0', 'vault://abc123...def']
+ */
+declare function extractVaultReferences(text: string): string[];
 /**
  * Checks if a URL seems like a valid presigned S3 URL, with no additional checks.
  *
@@ -1388,5 +1401,5 @@ declare function vaultClient(vaultConfig: VaultConfig): {
     }) => Promise<VaultFile[]>;
 };
 
-export { APIKeyAuthStrategy, DataTokenAuthStrategy, FetchError, VaultFile, convertS3UrlToVaultReference, extractVaultFileIdFromS3Url, getVaultParamsFromS3Url, isS3UrlExpired, isTaggedVaultPresignedUrl, isPresignedS3Url as isVaultFileS3Url, isVaultReference, vaultClient };
+export { APIKeyAuthStrategy, DataTokenAuthStrategy, FetchError, VaultFile, convertS3UrlToVaultReference, extractVaultFileIdFromS3Url, extractVaultReferences, getVaultParamsFromS3Url, isS3UrlExpired, isTaggedVaultPresignedUrl, isPresignedS3Url as isVaultFileS3Url, isVaultReference, vaultClient };
 export type { AuthStrategy, VaultConfig };

package/dist/index.d.ts

@@ -786,7 +786,8 @@ declare class VaultFile {
      *
      * This method is ideal for uploading large files without loading the entire content into memory.
      * The stream is sent directly to cloud storage, making it perfect for files larger than a few
-     * megabytes. Note: When using Bun, the stream is buffered due to implementation limitations.
+     * megabytes. Note: On Bun versions older than 1.3.10, the stream is buffered due to
+     * implementation limitations.
      *
      * @param stream - A ReadableStream of Uint8Array chunks containing the file data
      * @param options - Required options for the upload
@@ -1271,6 +1272,18 @@ declare function isS3UrlExpired(url: string): boolean;
  * @returns true if the URL is a valid vault reference, false otherwise
  */
 declare function isVaultReference(url: string): boolean;
+/**
+ * Extracts all vault references from a given text string.
+ * Finds both UUID v4 and SHA-256 hash format vault references.
+ *
+ * @param text - The text to search for vault references
+ * @returns An array of vault reference strings found in the text
+ * @example
+ * const text = 'Files: vault://2fce5740-83da-49fe-3f10-b32205893ec0 and vault://abc123...def'
+ * const refs = extractVaultReferences(text)
+ * // Returns: ['vault://2fce5740-83da-49fe-3f10-b32205893ec0', 'vault://abc123...def']
+ */
+declare function extractVaultReferences(text: string): string[];
 /**
  * Checks if a URL seems like a valid presigned S3 URL, with no additional checks.
  *
@@ -1388,5 +1401,5 @@ declare function vaultClient(vaultConfig: VaultConfig): {
     }) => Promise<VaultFile[]>;
 };
 
-export { APIKeyAuthStrategy, DataTokenAuthStrategy, FetchError, VaultFile, convertS3UrlToVaultReference, extractVaultFileIdFromS3Url, getVaultParamsFromS3Url, isS3UrlExpired, isTaggedVaultPresignedUrl, isPresignedS3Url as isVaultFileS3Url, isVaultReference, vaultClient };
+export { APIKeyAuthStrategy, DataTokenAuthStrategy, FetchError, VaultFile, convertS3UrlToVaultReference, extractVaultFileIdFromS3Url, extractVaultReferences, getVaultParamsFromS3Url, isS3UrlExpired, isTaggedVaultPresignedUrl, isPresignedS3Url as isVaultFileS3Url, isVaultReference, vaultClient };
 export type { AuthStrategy, VaultConfig };

package/dist/index.mjs

@@ -42,7 +42,7 @@ class FetchError extends Error {
     this.name = "FetchError";
   }
   static async from(url, method, response) {
-    const text = await response.clone().json().then((json) => JSON.stringify(json, null, 2)).catch(() => response.clone().text());
+    const text = await response.clone().json().then((json) => JSON.stringify(json, null, 2)).catch(async () => await response.clone().text());
     const error = new FetchError(`Failed to ${method} ${url}: ${response.status} ${response.statusText}:
 ${text}`, url, method, response);
     return error;
@@ -231,7 +231,7 @@ function getFileName(content) {
 }
 
 const name = "@meistrari/vault-sdk";
-const version = "3.0.0";
+const version = "3.1.1";
 const license = "UNLICENSED";
 const repository = {
 	type: "git",
@@ -258,8 +258,8 @@ const scripts = {
 	check: "bun run lint && bun tsc --noEmit"
 };
 const dependencies = {
-	"@meistrari/file-type": "^22.0.0",
-	"@meistrari/vault-shared": "0.0.7",
+	"@meistrari/file-type": "22.0.0",
+	"@meistrari/vault-shared": "0.1.0",
 	"mime-types": "3.0.1",
 	ofetch: "1.4.1",
 	zod: "3.23.8"
@@ -303,6 +303,7 @@ var __publicField = (obj, key, value) => {
   return value;
 };
 const compatibilityDate = "2025-05-19";
+const bunStreamingUploadFixVersion = "1.3.10";
 function detectMimeTypeFromFilename(filename) {
   const extension = filename.split(".").pop()?.toLowerCase();
   if (extension) {
@@ -313,6 +314,30 @@ function detectMimeTypeFromFilename(filename) {
   }
   return void 0;
 }
+function compareDottedVersions(left, right) {
+  const leftParts = left.split(".");
+  const rightParts = right.split(".");
+  const length = Math.max(leftParts.length, rightParts.length);
+  for (let index = 0; index < length; index++) {
+    const leftPart = Number.parseInt(leftParts[index] ?? "0", 10);
+    const rightPart = Number.parseInt(rightParts[index] ?? "0", 10);
+    const normalizedLeft = Number.isNaN(leftPart) ? 0 : leftPart;
+    const normalizedRight = Number.isNaN(rightPart) ? 0 : rightPart;
+    if (normalizedLeft !== normalizedRight) {
+      return normalizedLeft - normalizedRight;
+    }
+  }
+  return 0;
+}
+function shouldBufferStreamingUploadForBunVersion(bunVersion) {
+  return compareDottedVersions(bunVersion, bunStreamingUploadFixVersion) < 0;
+}
+function shouldBufferStreamingUploadOnBun() {
+  if (typeof Bun === "undefined") {
+    return false;
+  }
+  return shouldBufferStreamingUploadForBunVersion(Bun.version);
+}
 async function wrappedFetch(url, requestInit) {
   const options = {
     ...requestInit,
@@ -420,7 +445,7 @@ class VaultFile {
   async _createFile(metadata = {}, options) {
     const response = await this._fetch({
       method: "POST",
-      path: `files`,
+      path: "files",
       body: JSON.stringify({
         size: metadata.size,
         mimeType: metadata.mimeType,
@@ -489,7 +514,7 @@ class VaultFile {
       method: "GET",
       headers: authStrategy.getHeaders(),
       signal: options?.signal
-    }).then((response2) => response2.json()).then((data) => GetDownloadUrlResponse.safeParse(data));
+    }).then(async (response2) => await response2.json()).then((data) => GetDownloadUrlResponse.safeParse(data));
     if (!response.success) {
       throw new Error("Invalid response from vault service");
     }
@@ -503,7 +528,7 @@ class VaultFile {
       name: response.data.metadata?.originalFileName ?? void 0
     };
     if (download) {
-      await wrappedFetch(response.data.url, { method: "GET", signal: options?.signal }).then((response2) => response2.blob()).then((blob) => fileParams.content = blob);
+      await wrappedFetch(response.data.url, { method: "GET", signal: options?.signal }).then(async (response2) => await response2.blob()).then((blob) => fileParams.content = blob);
     }
     return new VaultFile(fileParams);
   }
@@ -726,8 +751,8 @@ class VaultFile {
       const file = new VaultFile({
         config,
         id: item.id,
-        name: item.metadata?.originalFileName ?? preparedFiles[index].name,
-        content: preparedFiles[index].content,
+        name: item.metadata.originalFileName ?? preparedFiles[index]?.name,
+        content: preparedFiles[index]?.content,
         metadata: item.metadata
       });
       file.lastUploadUrl = {
@@ -739,7 +764,7 @@ class VaultFile {
     if (upload) {
       await Promise.all(
         vaultFiles.map(
-          (file) => file.upload(void 0, void 0, { signal: options?.signal })
+          async (file) => await file.upload(void 0, void 0, { signal: options?.signal })
         )
       );
     }
@@ -806,7 +831,7 @@ class VaultFile {
       const file = new VaultFile({
         config,
         id: item.id,
-        name: item.metadata?.originalFileName ?? preparedFiles[index].name,
+        name: item.metadata?.originalFileName ?? preparedFiles[index]?.name,
         metadata: item.metadata
       });
       file.lastUploadUrl = {
@@ -861,6 +886,7 @@ class VaultFile {
     } catch (error) {
       console.error("Error fetching file metadata", error);
     }
+    return void 0;
   }
   /**
    * Returns the vault URI reference for this file.
@@ -1000,7 +1026,7 @@ class VaultFile {
       path: `files/${this.id}`,
       signal: options?.signal,
       ...options?.expiresIn ? { query: { expiresIn: options.expiresIn.toString() } } : {}
-    }).then(GetUploadUrlResponseV2.safeParse);
+    }).then((result) => GetUploadUrlResponseV2.safeParse(result));
     if (!response.success) {
       throw new Error(`Invalid response from vault service. ${JSON.stringify(response.error)}`);
     }
@@ -1205,7 +1231,8 @@ class VaultFile {
    *
    * This method is ideal for uploading large files without loading the entire content into memory.
    * The stream is sent directly to cloud storage, making it perfect for files larger than a few
-   * megabytes. Note: When using Bun, the stream is buffered due to implementation limitations.
+   * megabytes. Note: On Bun versions older than 1.3.10, the stream is buffered due to
+   * implementation limitations.
    *
    * @param stream - A ReadableStream of Uint8Array chunks containing the file data
    * @param options - Required options for the upload
@@ -1272,10 +1299,10 @@ class VaultFile {
     headers.set("Content-Type", mimeType);
     headers.set("Content-Length", contentLength.toString());
     let content = stream;
-    if (stream instanceof ReadableStream && typeof Bun !== "undefined") {
+    if (stream instanceof ReadableStream && shouldBufferStreamingUploadOnBun()) {
       console.warn(
-        "[Vault SDK - WARNING] Buffering file upload due to Bun fetch implementation. Large files may cause memory issues. Consider using Node.js for streaming uploads.",
-        { fileName: this.name, fileSize: contentLength }
+        `[Vault SDK - WARNING] Buffering file upload on Bun ${Bun.version}. Streaming uploads are only buffered on Bun versions older than ${bunStreamingUploadFixVersion}. Large files may cause memory issues. Upgrade Bun or use Node.js for streaming uploads.`,
+        { fileName: this.name, fileSize: contentLength, bunVersion: Bun.version }
       );
       const chunks = [];
       const reader = stream.getReader();
@@ -1406,7 +1433,7 @@ class VaultFile {
     if (!this.metadata?.workspaceId) {
       throw new Error("Workspace ID is not set. Call populateMetadata() to populate the metadata fields.");
     }
-    return Permalink.create(this.config, {
+    return await Permalink.create(this.config, {
       fileId: this.id,
       workspaceId: this.metadata.workspaceId,
       expiresIn: params.expiresIn
@@ -1679,7 +1706,7 @@ class VaultFile {
     if (!this.id) {
       throw new Error("Parent file ID is not set");
     }
-    return VaultFile.fromContent(
+    return await VaultFile.fromContent(
       {
         ...params,
         config: this.config,
@@ -1728,7 +1755,7 @@ class VaultFile {
     if (!this.id) {
       throw new Error("Parent file ID is not set");
     }
-    return VaultFile.fromStream(
+    return await VaultFile.fromStream(
       {
         ...params,
         config: this.config,
@@ -1803,8 +1830,8 @@ class VaultFile {
   }
 }
 
-const VAULT_REFERENCE_UUID_REGEX = /^vault:\/\/[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-const VAULT_REFERENCE_SHA256_REGEX = /^vault:\/\/[a-f0-9]{64}$/i;
+const VAULT_REFERENCE_UUID_REGEX = /vault:\/\/[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/i;
+const VAULT_REFERENCE_SHA256_REGEX = /vault:\/\/[a-f0-9]{64}/i;
 function isValidUuidV4(uuid) {
   return /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(uuid);
 }
@@ -1834,7 +1861,14 @@ function isS3UrlExpired(url) {
   }
 }
 function isVaultReference(url) {
-  return VAULT_REFERENCE_UUID_REGEX.test(url) || VAULT_REFERENCE_SHA256_REGEX.test(url);
+  return new RegExp(`^${VAULT_REFERENCE_UUID_REGEX.source}$`, "i").test(url) || new RegExp(`^${VAULT_REFERENCE_SHA256_REGEX.source}$`, "i").test(url);
+}
+function extractVaultReferences(text) {
+  const uuidRegex = new RegExp(VAULT_REFERENCE_UUID_REGEX.source, "gi");
+  const sha256Regex = new RegExp(VAULT_REFERENCE_SHA256_REGEX.source, "gi");
+  const uuidMatches = text.match(uuidRegex) || [];
+  const sha256Matches = text.match(sha256Regex) || [];
+  return [...uuidMatches, ...sha256Matches];
 }
 function isPresignedS3Url(url) {
   try {
@@ -1973,4 +2007,4 @@ function vaultClient(vaultConfig) {
   return { createFromContent, createFromReference, createFromStream, createFromContentBulk, createFromStreamBulk };
 }
 
-export { APIKeyAuthStrategy, DataTokenAuthStrategy, FetchError, VaultFile, convertS3UrlToVaultReference, extractVaultFileIdFromS3Url, getVaultParamsFromS3Url, isS3UrlExpired, isTaggedVaultPresignedUrl, isPresignedS3Url as isVaultFileS3Url, isVaultReference, vaultClient };
+export { APIKeyAuthStrategy, DataTokenAuthStrategy, FetchError, VaultFile, convertS3UrlToVaultReference, extractVaultFileIdFromS3Url, extractVaultReferences, getVaultParamsFromS3Url, isS3UrlExpired, isTaggedVaultPresignedUrl, isPresignedS3Url as isVaultFileS3Url, isVaultReference, vaultClient };

package/package.json

@@ -1,49 +1,49 @@
 {
-    "name": "@meistrari/vault-sdk",
-    "version": "3.0.0",
-    "license": "UNLICENSED",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/meistrari/vault.git"
-    },
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.mjs",
-            "require": "./dist/index.cjs"
-        }
-    },
-    "main": "dist/index.mjs",
-    "types": "dist/index.d.ts",
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "test": "vitest --no-watch",
-        "test:watch": "vitest",
-        "build": "unbuild",
-        "lint": "eslint .",
-        "lint:fix": "eslint . --fix",
-        "check": "bun run lint && bun tsc --noEmit"
-    },
-    "dependencies": {
-        "@meistrari/file-type": "^22.0.0",
-        "@meistrari/vault-shared": "0.0.7",
-        "mime-types": "3.0.1",
-        "ofetch": "1.4.1",
-        "zod": "3.23.8"
-    },
-    "devDependencies": {
-        "@types/bun": "latest",
-        "@types/mime-types": "3.0.1",
-        "msw": "2.6.8",
-        "unbuild": "2.0.0",
-        "vitest": "2.1.9"
-    },
-    "peerDependencies": {
-        "typescript": "^5.0.0"
-    },
-    "publishConfig": {
-        "access": "public"
+  "name": "@meistrari/vault-sdk",
+  "version": "3.1.1",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/meistrari/vault.git"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
     }
+  },
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "test": "vitest --no-watch",
+    "test:watch": "vitest",
+    "build": "unbuild",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "check": "bun run lint && bun tsc --noEmit"
+  },
+  "dependencies": {
+    "@meistrari/file-type": "22.0.0",
+    "@meistrari/vault-shared": "0.1.0",
+    "mime-types": "3.0.1",
+    "ofetch": "1.4.1",
+    "zod": "3.23.8"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/mime-types": "3.0.1",
+    "msw": "2.6.8",
+    "unbuild": "2.0.0",
+    "vitest": "2.1.9"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }