@meistrari/vault-sdk 1.8.3 → 1.9.0

package/dist/index.cjs

@@ -237,7 +237,7 @@ function getFileName(content) {
 }
 
 const name = "@meistrari/vault-sdk";
-const version = "1.8.3";
+const version = "1.9.0";
 const license = "UNLICENSED";
 const repository = {
 	type: "git",
@@ -417,6 +417,7 @@ class VaultFile {
    * @param metadata.mimeType - The mime type of the file
    * @param metadata.parentId - The ID of the parent file for hierarchical file relationships
    * @param metadata.onMissingParent - What to do if the parent file does not exist or has been deleted
+   * @param metadata.onParentConflict - What to do if the file already exists as an active child of another file
    * @param options - The options for the request
    * @param options.signal - The signal to abort the request
    *
@@ -433,6 +434,7 @@ class VaultFile {
         mimeType: metadata.mimeType,
         parentId: metadata.parentId,
         onMissingParent: metadata.onMissingParent,
+        onParentConflict: metadata.onParentConflict,
         fileName: this.name,
         sha256sum: this.id ?? this.metadata?.id ?? (this.content ? await getFileHash(this.content) : void 0)
       }),
@@ -524,6 +526,7 @@ class VaultFile {
    * @param params.upload - Whether to upload the file (default: false)
    * @param params.parentId - The ID of the parent file for hierarchical file relationships
    * @param params.onMissingParent - What to do if the parent file does not exist or has been deleted
+   * @param params.onParentConflict - What to do if the file already exists as an active child of another file
    * @param options - The options for the request
    * @param options.signal - The signal to abort the request
    *
@@ -576,7 +579,7 @@ class VaultFile {
    * ```
    */
   static async fromContent(params, options) {
-    const { content, config: vaultConfig, upload = false, parentId, onMissingParent } = params;
+    const { content, config: vaultConfig, upload = false, parentId, onMissingParent, onParentConflict } = params;
     const name = basename(params.name) ?? getFileName(content);
     const config = resolveConfig(vaultConfig);
     const { vaultUrl, authStrategy } = config;
@@ -596,7 +599,8 @@ class VaultFile {
       size,
       mimeType,
       parentId,
-      onMissingParent
+      onMissingParent,
+      onParentConflict
     }, { signal: options?.signal });
     if (upload) {
       await file.upload(file.content, createdFile.uploadUrl, { signal: options?.signal });
@@ -614,6 +618,7 @@ class VaultFile {
    * @param params.contentType - The MIME type of the content (optional)
    * @param params.parentId - The ID of the parent file for hierarchical file relationships
    * @param params.onMissingParent - What to do if the parent file does not exist or has been deleted
+   * @param params.onParentConflict - What to do if the file already exists as an active child of another file
    * @param options - The options for the request
    * @param options.signal - The signal to abort the request
    *
@@ -650,7 +655,14 @@ class VaultFile {
    * ```
    */
   static async fromStream(params, options) {
-    const { contentLength, config: vaultConfig, contentType, parentId, onMissingParent } = params;
+    const {
+      contentLength,
+      config: vaultConfig,
+      contentType,
+      parentId,
+      onMissingParent,
+      onParentConflict
+    } = params;
     const name = basename(params.name);
     const config = resolveConfig(vaultConfig);
     const file = new VaultFile({ config, name });
@@ -658,7 +670,8 @@ class VaultFile {
       size: contentLength,
       mimeType: contentType || "application/octet-stream",
       parentId,
-      onMissingParent
+      onMissingParent,
+      onParentConflict
     }, { signal: options?.signal });
     return file;
   }

package/dist/index.d.cts

@@ -88,6 +88,7 @@ type VaultFileParams = {
     config: VaultConfig;
 };
 type OnMissingParent = 'error' | 'create-as-root';
+type OnParentConflict = 'error' | 'update-parent-id' | 'ignore';
 /**
  * Represents a file in the vault and allows interacting with it.
  *
@@ -154,6 +155,7 @@ declare class VaultFile {
      * @param metadata.mimeType - The mime type of the file
      * @param metadata.parentId - The ID of the parent file for hierarchical file relationships
      * @param metadata.onMissingParent - What to do if the parent file does not exist or has been deleted
+     * @param metadata.onParentConflict - What to do if the file already exists as an active child of another file
      * @param options - The options for the request
      * @param options.signal - The signal to abort the request
      *
@@ -219,6 +221,7 @@ declare class VaultFile {
      * @param params.upload - Whether to upload the file (default: false)
      * @param params.parentId - The ID of the parent file for hierarchical file relationships
      * @param params.onMissingParent - What to do if the parent file does not exist or has been deleted
+     * @param params.onParentConflict - What to do if the file already exists as an active child of another file
      * @param options - The options for the request
      * @param options.signal - The signal to abort the request
      *
@@ -278,6 +281,7 @@ declare class VaultFile {
         upload?: boolean;
         parentId?: string;
         onMissingParent?: OnMissingParent;
+        onParentConflict?: OnParentConflict;
     }, options?: {
         signal?: AbortSignal;
     }): Promise<VaultFile>;
@@ -292,6 +296,7 @@ declare class VaultFile {
      * @param params.contentType - The MIME type of the content (optional)
      * @param params.parentId - The ID of the parent file for hierarchical file relationships
      * @param params.onMissingParent - What to do if the parent file does not exist or has been deleted
+     * @param params.onParentConflict - What to do if the file already exists as an active child of another file
      * @param options - The options for the request
      * @param options.signal - The signal to abort the request
      *
@@ -334,6 +339,7 @@ declare class VaultFile {
         contentType?: string;
         parentId?: string;
         onMissingParent?: OnMissingParent;
+        onParentConflict?: OnParentConflict;
     }, options?: {
         signal?: AbortSignal;
     }): Promise<VaultFile>;

package/dist/index.d.mts

@@ -88,6 +88,7 @@ type VaultFileParams = {
     config: VaultConfig;
 };
 type OnMissingParent = 'error' | 'create-as-root';
+type OnParentConflict = 'error' | 'update-parent-id' | 'ignore';
 /**
  * Represents a file in the vault and allows interacting with it.
  *
@@ -154,6 +155,7 @@ declare class VaultFile {
      * @param metadata.mimeType - The mime type of the file
      * @param metadata.parentId - The ID of the parent file for hierarchical file relationships
      * @param metadata.onMissingParent - What to do if the parent file does not exist or has been deleted
+     * @param metadata.onParentConflict - What to do if the file already exists as an active child of another file
      * @param options - The options for the request
      * @param options.signal - The signal to abort the request
      *
@@ -219,6 +221,7 @@ declare class VaultFile {
      * @param params.upload - Whether to upload the file (default: false)
      * @param params.parentId - The ID of the parent file for hierarchical file relationships
      * @param params.onMissingParent - What to do if the parent file does not exist or has been deleted
+     * @param params.onParentConflict - What to do if the file already exists as an active child of another file
      * @param options - The options for the request
      * @param options.signal - The signal to abort the request
      *
@@ -278,6 +281,7 @@ declare class VaultFile {
         upload?: boolean;
         parentId?: string;
         onMissingParent?: OnMissingParent;
+        onParentConflict?: OnParentConflict;
     }, options?: {
         signal?: AbortSignal;
     }): Promise<VaultFile>;
@@ -292,6 +296,7 @@ declare class VaultFile {
      * @param params.contentType - The MIME type of the content (optional)
      * @param params.parentId - The ID of the parent file for hierarchical file relationships
      * @param params.onMissingParent - What to do if the parent file does not exist or has been deleted
+     * @param params.onParentConflict - What to do if the file already exists as an active child of another file
      * @param options - The options for the request
      * @param options.signal - The signal to abort the request
      *
@@ -334,6 +339,7 @@ declare class VaultFile {
         contentType?: string;
         parentId?: string;
         onMissingParent?: OnMissingParent;
+        onParentConflict?: OnParentConflict;
     }, options?: {
         signal?: AbortSignal;
     }): Promise<VaultFile>;

package/dist/index.d.ts

@@ -88,6 +88,7 @@ type VaultFileParams = {
     config: VaultConfig;
 };
 type OnMissingParent = 'error' | 'create-as-root';
+type OnParentConflict = 'error' | 'update-parent-id' | 'ignore';
 /**
  * Represents a file in the vault and allows interacting with it.
  *
@@ -154,6 +155,7 @@ declare class VaultFile {
      * @param metadata.mimeType - The mime type of the file
      * @param metadata.parentId - The ID of the parent file for hierarchical file relationships
      * @param metadata.onMissingParent - What to do if the parent file does not exist or has been deleted
+     * @param metadata.onParentConflict - What to do if the file already exists as an active child of another file
      * @param options - The options for the request
      * @param options.signal - The signal to abort the request
      *
@@ -219,6 +221,7 @@ declare class VaultFile {
      * @param params.upload - Whether to upload the file (default: false)
      * @param params.parentId - The ID of the parent file for hierarchical file relationships
      * @param params.onMissingParent - What to do if the parent file does not exist or has been deleted
+     * @param params.onParentConflict - What to do if the file already exists as an active child of another file
      * @param options - The options for the request
      * @param options.signal - The signal to abort the request
      *
@@ -278,6 +281,7 @@ declare class VaultFile {
         upload?: boolean;
         parentId?: string;
         onMissingParent?: OnMissingParent;
+        onParentConflict?: OnParentConflict;
     }, options?: {
         signal?: AbortSignal;
     }): Promise<VaultFile>;
@@ -292,6 +296,7 @@ declare class VaultFile {
      * @param params.contentType - The MIME type of the content (optional)
      * @param params.parentId - The ID of the parent file for hierarchical file relationships
      * @param params.onMissingParent - What to do if the parent file does not exist or has been deleted
+     * @param params.onParentConflict - What to do if the file already exists as an active child of another file
      * @param options - The options for the request
      * @param options.signal - The signal to abort the request
      *
@@ -334,6 +339,7 @@ declare class VaultFile {
         contentType?: string;
         parentId?: string;
         onMissingParent?: OnMissingParent;
+        onParentConflict?: OnParentConflict;
     }, options?: {
         signal?: AbortSignal;
     }): Promise<VaultFile>;

package/dist/index.mjs

@@ -231,7 +231,7 @@ function getFileName(content) {
 }
 
 const name = "@meistrari/vault-sdk";
-const version = "1.8.3";
+const version = "1.9.0";
 const license = "UNLICENSED";
 const repository = {
 	type: "git",
@@ -411,6 +411,7 @@ class VaultFile {
    * @param metadata.mimeType - The mime type of the file
    * @param metadata.parentId - The ID of the parent file for hierarchical file relationships
    * @param metadata.onMissingParent - What to do if the parent file does not exist or has been deleted
+   * @param metadata.onParentConflict - What to do if the file already exists as an active child of another file
    * @param options - The options for the request
    * @param options.signal - The signal to abort the request
    *
@@ -427,6 +428,7 @@ class VaultFile {
         mimeType: metadata.mimeType,
         parentId: metadata.parentId,
         onMissingParent: metadata.onMissingParent,
+        onParentConflict: metadata.onParentConflict,
         fileName: this.name,
         sha256sum: this.id ?? this.metadata?.id ?? (this.content ? await getFileHash(this.content) : void 0)
       }),
@@ -518,6 +520,7 @@ class VaultFile {
    * @param params.upload - Whether to upload the file (default: false)
    * @param params.parentId - The ID of the parent file for hierarchical file relationships
    * @param params.onMissingParent - What to do if the parent file does not exist or has been deleted
+   * @param params.onParentConflict - What to do if the file already exists as an active child of another file
    * @param options - The options for the request
    * @param options.signal - The signal to abort the request
    *
@@ -570,7 +573,7 @@ class VaultFile {
    * ```
    */
   static async fromContent(params, options) {
-    const { content, config: vaultConfig, upload = false, parentId, onMissingParent } = params;
+    const { content, config: vaultConfig, upload = false, parentId, onMissingParent, onParentConflict } = params;
     const name = basename(params.name) ?? getFileName(content);
     const config = resolveConfig(vaultConfig);
     const { vaultUrl, authStrategy } = config;
@@ -590,7 +593,8 @@ class VaultFile {
       size,
       mimeType,
       parentId,
-      onMissingParent
+      onMissingParent,
+      onParentConflict
     }, { signal: options?.signal });
     if (upload) {
       await file.upload(file.content, createdFile.uploadUrl, { signal: options?.signal });
@@ -608,6 +612,7 @@ class VaultFile {
    * @param params.contentType - The MIME type of the content (optional)
    * @param params.parentId - The ID of the parent file for hierarchical file relationships
    * @param params.onMissingParent - What to do if the parent file does not exist or has been deleted
+   * @param params.onParentConflict - What to do if the file already exists as an active child of another file
    * @param options - The options for the request
    * @param options.signal - The signal to abort the request
    *
@@ -644,7 +649,14 @@ class VaultFile {
    * ```
    */
   static async fromStream(params, options) {
-    const { contentLength, config: vaultConfig, contentType, parentId, onMissingParent } = params;
+    const {
+      contentLength,
+      config: vaultConfig,
+      contentType,
+      parentId,
+      onMissingParent,
+      onParentConflict
+    } = params;
     const name = basename(params.name);
     const config = resolveConfig(vaultConfig);
     const file = new VaultFile({ config, name });
@@ -652,7 +664,8 @@ class VaultFile {
       size: contentLength,
       mimeType: contentType || "application/octet-stream",
       parentId,
-      onMissingParent
+      onMissingParent,
+      onParentConflict
     }, { signal: options?.signal });
     return file;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/vault-sdk",
-  "version": "1.8.3",
+  "version": "1.9.0",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",