@meistrari/vault-sdk 1.4.0 → 1.4.2

package/dist/index.cjs

@@ -50,6 +50,19 @@ ${text}`, url, method, response);
   }
 }
 
+function resolveBaseUrl(baseUrl) {
+  if (baseUrl.endsWith("/")) {
+    return baseUrl;
+  }
+  return `${baseUrl}/`;
+}
+function resolveConfig(config) {
+  return {
+    ...config,
+    vaultUrl: resolveBaseUrl(config.vaultUrl)
+  };
+}
+
 var __defProp$1 = Object.defineProperty;
 var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField$1 = (obj, key, value) => {
@@ -57,7 +70,7 @@ var __publicField$1 = (obj, key, value) => {
   return value;
 };
 class Permalink {
-  constructor(config, params) {
+  constructor(vaultConfig, params) {
     __publicField$1(this, "config");
     __publicField$1(this, "id");
     __publicField$1(this, "workspaceId");
@@ -65,6 +78,8 @@ class Permalink {
     __publicField$1(this, "createdBy");
     __publicField$1(this, "expiresAt");
     __publicField$1(this, "fileId");
+    __publicField$1(this, "baseUrl");
+    const config = resolveConfig(vaultConfig);
     this.config = config;
     this.id = params.id;
     this.workspaceId = params.workspaceId;
@@ -72,12 +87,13 @@ class Permalink {
     this.createdBy = params.createdBy;
     this.expiresAt = params.expiresAt ? new Date(params.expiresAt) : null;
     this.fileId = params.fileId;
+    this.baseUrl = config.vaultUrl;
   }
   /**
    * The URL for the permalink.
    */
   get url() {
-    return new URL(`/permalinks/${this.id}`, this.config.vaultUrl);
+    return new URL(`permalinks/${this.id}`, this.baseUrl);
   }
   /**
    * Get a new permalink instance from its ID.
@@ -86,8 +102,9 @@ class Permalink {
    * @param id - The permalink ID.
    * @returns The permalink.
    */
-  static async fromId(config, id) {
-    const response = await fetch(`${config.vaultUrl}/permalinks/${id}/metadata`, {
+  static async fromId(vaultConfig, id) {
+    const config = resolveConfig(vaultConfig);
+    const response = await fetch(new URL(`permalinks/${id}/metadata`, config.vaultUrl), {
       headers: config.authStrategy.getHeaders()
     });
     if (!response.ok) {
@@ -110,14 +127,15 @@ class Permalink {
    *
    * @returns The permalink.
    */
-  static async create(config, params, options) {
+  static async create(vaultConfig, params, options) {
+    const config = resolveConfig(vaultConfig);
     const { expiresIn } = params;
     const expiresAt = expiresIn ? new Date(Date.now() + expiresIn * 1e3) : void 0;
     const headers = config.authStrategy.getHeaders();
     headers.append("x-compatibility-date", "2025-07-29");
     headers.append("content-type", "application/json");
     const body = expiresAt ? JSON.stringify({ expiresAt: expiresAt.toISOString() }) : "{}";
-    const response = await fetch(`${config.vaultUrl}/files/${params.fileId}/permalinks`, {
+    const response = await fetch(new URL(`files/${params.fileId}/permalinks`, config.vaultUrl), {
       method: "POST",
       signal: options?.signal,
       headers,
@@ -136,7 +154,7 @@ class Permalink {
    * @param options.signal - The signal to abort the request.
    */
   async delete(options) {
-    const response = await fetch(`${this.config.vaultUrl}/permalinks/${this.id}`, {
+    const response = await fetch(new URL(`permalinks/${this.id}`, this.baseUrl), {
       method: "DELETE",
       signal: options?.signal,
       headers: this.config.authStrategy.getHeaders()
@@ -221,11 +239,13 @@ class VaultFile {
     __publicField(this, "content");
     __publicField(this, "lastDownloadUrl");
     __publicField(this, "lastUploadUrl");
-    this.config = config;
+    __publicField(this, "baseUrl");
+    this.config = resolveConfig(config);
     this.content = content;
     this.id = id;
     this.name = name;
     this.metadata = metadata;
+    this.baseUrl = this.config.vaultUrl;
   }
   /**
    * Gets the headers for the request based on the auth strategy.
@@ -248,7 +268,7 @@ class VaultFile {
    */
   async _fetch(params) {
     const { method, path, body, signal, query } = params;
-    const url = new URL(path, this.config.vaultUrl);
+    const url = new URL(path, this.baseUrl);
     const headers = new Headers(this.headers);
     headers.set("x-compatibility-date", compatibilityDate);
     if (query) {
@@ -293,7 +313,7 @@ class VaultFile {
     }
     this.id = response.data.id;
     this.metadata = response.data.metadata;
-    this.name = response.data.metadata?.originalFileName;
+    this.name = response.data.metadata?.originalFileName ?? void 0;
     return response.data;
   }
   /**
@@ -336,10 +356,11 @@ class VaultFile {
    * ```
    */
   static async fromVaultReference(params, options) {
-    const { reference, config, download = false } = params;
+    const { reference, config: vaultConfig, download = false } = params;
+    const config = resolveConfig(vaultConfig);
     const { vaultUrl, authStrategy } = config;
     const id = removeVaultPrefix(reference);
-    const url = new URL(`files/${id}`, vaultUrl);
+    const url = new URL(`files/${id}`, config.vaultUrl);
     const response = await wrappedFetch(url, {
       method: "GET",
       headers: authStrategy.getHeaders(),
@@ -355,7 +376,7 @@ class VaultFile {
         vaultUrl,
         authStrategy
       },
-      name: response.data.metadata?.originalFileName
+      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);
@@ -406,7 +427,8 @@ class VaultFile {
    * ```
    */
   static async fromContent(params, options) {
-    const { name, content, config, upload = false } = params;
+    const { name, content, config: vaultConfig, upload = false } = params;
+    const config = resolveConfig(vaultConfig);
     const { vaultUrl, authStrategy } = config;
     const sha256sum = await getFileHash(content);
     const mimeType = await detectFileMimeType(content);
@@ -441,7 +463,7 @@ class VaultFile {
   async populateMetadata(options) {
     try {
       this.metadata = await this.getFileMetadata({ signal: options?.signal });
-      this.name = this.metadata.originalFileName;
+      this.name = this.metadata.originalFileName ?? void 0;
       this.id = this.metadata.id;
       return this;
     } catch (error) {
@@ -498,7 +520,7 @@ class VaultFile {
       const createdFile = await this._createFile();
       this.id = createdFile.id;
       this.metadata = createdFile.metadata;
-      this.name = createdFile.metadata?.originalFileName;
+      this.name = createdFile.metadata?.originalFileName ?? void 0;
       this.lastUploadUrl = { url: new URL(createdFile.uploadUrl), expiresAt: new Date(createdFile.expiresAt) };
       return this.lastUploadUrl.url;
     }
@@ -654,7 +676,8 @@ class VaultFile {
   }
 }
 
-function vaultClient(config) {
+function vaultClient(vaultConfig) {
+  const config = resolveConfig(vaultConfig);
   function createFromContent(name, content, options) {
     return VaultFile.fromContent({
       name,

package/dist/index.d.cts

@@ -36,7 +36,8 @@ declare class Permalink {
     readonly createdBy: string | null;
     readonly expiresAt: Date | null;
     readonly fileId: string;
-    constructor(config: VaultConfig, params: SerializedPermalink);
+    private readonly baseUrl;
+    constructor(vaultConfig: VaultConfig, params: SerializedPermalink);
     /**
      * The URL for the permalink.
      */
@@ -48,7 +49,7 @@ declare class Permalink {
      * @param id - The permalink ID.
      * @returns The permalink.
      */
-    static fromId(config: VaultConfig, id: string): Promise<Permalink>;
+    static fromId(vaultConfig: VaultConfig, id: string): Promise<Permalink>;
     /**
      * Create a new permalink.
      *
@@ -63,7 +64,7 @@ declare class Permalink {
      *
      * @returns The permalink.
      */
-    static create(config: VaultConfig, params: Pick<SerializedPermalink, 'fileId' | 'workspaceId'> & {
+    static create(vaultConfig: VaultConfig, params: Pick<SerializedPermalink, 'fileId' | 'workspaceId'> & {
         expiresIn?: number;
     }, options?: {
         signal?: AbortSignal;
@@ -111,6 +112,7 @@ declare class VaultFile {
         url: URL;
         expiresAt: Date;
     } | undefined;
+    private readonly baseUrl;
     /**
      * Constructs a new VaultFile instance. Direct usage of the constructor is not recommended,
      * instead use the static methods {@link VaultFile.fromVaultReference} when dealing with an existing file in the vault,
@@ -397,7 +399,7 @@ declare class VaultFile {
     }): Promise<Permalink[]>;
 }
 
-declare function vaultClient(config: VaultConfig): {
+declare function vaultClient(vaultConfig: VaultConfig): {
     createFromContent: (name: string, content: Blob | File, options?: {
         signal?: AbortSignal;
     }) => Promise<VaultFile>;

package/dist/index.d.mts

@@ -36,7 +36,8 @@ declare class Permalink {
     readonly createdBy: string | null;
     readonly expiresAt: Date | null;
     readonly fileId: string;
-    constructor(config: VaultConfig, params: SerializedPermalink);
+    private readonly baseUrl;
+    constructor(vaultConfig: VaultConfig, params: SerializedPermalink);
     /**
      * The URL for the permalink.
      */
@@ -48,7 +49,7 @@ declare class Permalink {
      * @param id - The permalink ID.
      * @returns The permalink.
      */
-    static fromId(config: VaultConfig, id: string): Promise<Permalink>;
+    static fromId(vaultConfig: VaultConfig, id: string): Promise<Permalink>;
     /**
      * Create a new permalink.
      *
@@ -63,7 +64,7 @@ declare class Permalink {
      *
      * @returns The permalink.
      */
-    static create(config: VaultConfig, params: Pick<SerializedPermalink, 'fileId' | 'workspaceId'> & {
+    static create(vaultConfig: VaultConfig, params: Pick<SerializedPermalink, 'fileId' | 'workspaceId'> & {
         expiresIn?: number;
     }, options?: {
         signal?: AbortSignal;
@@ -111,6 +112,7 @@ declare class VaultFile {
         url: URL;
         expiresAt: Date;
     } | undefined;
+    private readonly baseUrl;
     /**
      * Constructs a new VaultFile instance. Direct usage of the constructor is not recommended,
      * instead use the static methods {@link VaultFile.fromVaultReference} when dealing with an existing file in the vault,
@@ -397,7 +399,7 @@ declare class VaultFile {
     }): Promise<Permalink[]>;
 }
 
-declare function vaultClient(config: VaultConfig): {
+declare function vaultClient(vaultConfig: VaultConfig): {
     createFromContent: (name: string, content: Blob | File, options?: {
         signal?: AbortSignal;
     }) => Promise<VaultFile>;

package/dist/index.d.ts

@@ -36,7 +36,8 @@ declare class Permalink {
     readonly createdBy: string | null;
     readonly expiresAt: Date | null;
     readonly fileId: string;
-    constructor(config: VaultConfig, params: SerializedPermalink);
+    private readonly baseUrl;
+    constructor(vaultConfig: VaultConfig, params: SerializedPermalink);
     /**
      * The URL for the permalink.
      */
@@ -48,7 +49,7 @@ declare class Permalink {
      * @param id - The permalink ID.
      * @returns The permalink.
      */
-    static fromId(config: VaultConfig, id: string): Promise<Permalink>;
+    static fromId(vaultConfig: VaultConfig, id: string): Promise<Permalink>;
     /**
      * Create a new permalink.
      *
@@ -63,7 +64,7 @@ declare class Permalink {
      *
      * @returns The permalink.
      */
-    static create(config: VaultConfig, params: Pick<SerializedPermalink, 'fileId' | 'workspaceId'> & {
+    static create(vaultConfig: VaultConfig, params: Pick<SerializedPermalink, 'fileId' | 'workspaceId'> & {
         expiresIn?: number;
     }, options?: {
         signal?: AbortSignal;
@@ -111,6 +112,7 @@ declare class VaultFile {
         url: URL;
         expiresAt: Date;
     } | undefined;
+    private readonly baseUrl;
     /**
      * Constructs a new VaultFile instance. Direct usage of the constructor is not recommended,
      * instead use the static methods {@link VaultFile.fromVaultReference} when dealing with an existing file in the vault,
@@ -397,7 +399,7 @@ declare class VaultFile {
     }): Promise<Permalink[]>;
 }
 
-declare function vaultClient(config: VaultConfig): {
+declare function vaultClient(vaultConfig: VaultConfig): {
     createFromContent: (name: string, content: Blob | File, options?: {
         signal?: AbortSignal;
     }) => Promise<VaultFile>;

package/dist/index.mjs

@@ -48,6 +48,19 @@ ${text}`, url, method, response);
   }
 }
 
+function resolveBaseUrl(baseUrl) {
+  if (baseUrl.endsWith("/")) {
+    return baseUrl;
+  }
+  return `${baseUrl}/`;
+}
+function resolveConfig(config) {
+  return {
+    ...config,
+    vaultUrl: resolveBaseUrl(config.vaultUrl)
+  };
+}
+
 var __defProp$1 = Object.defineProperty;
 var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField$1 = (obj, key, value) => {
@@ -55,7 +68,7 @@ var __publicField$1 = (obj, key, value) => {
   return value;
 };
 class Permalink {
-  constructor(config, params) {
+  constructor(vaultConfig, params) {
     __publicField$1(this, "config");
     __publicField$1(this, "id");
     __publicField$1(this, "workspaceId");
@@ -63,6 +76,8 @@ class Permalink {
     __publicField$1(this, "createdBy");
     __publicField$1(this, "expiresAt");
     __publicField$1(this, "fileId");
+    __publicField$1(this, "baseUrl");
+    const config = resolveConfig(vaultConfig);
     this.config = config;
     this.id = params.id;
     this.workspaceId = params.workspaceId;
@@ -70,12 +85,13 @@ class Permalink {
     this.createdBy = params.createdBy;
     this.expiresAt = params.expiresAt ? new Date(params.expiresAt) : null;
     this.fileId = params.fileId;
+    this.baseUrl = config.vaultUrl;
   }
   /**
    * The URL for the permalink.
    */
   get url() {
-    return new URL(`/permalinks/${this.id}`, this.config.vaultUrl);
+    return new URL(`permalinks/${this.id}`, this.baseUrl);
   }
   /**
    * Get a new permalink instance from its ID.
@@ -84,8 +100,9 @@ class Permalink {
    * @param id - The permalink ID.
    * @returns The permalink.
    */
-  static async fromId(config, id) {
-    const response = await fetch(`${config.vaultUrl}/permalinks/${id}/metadata`, {
+  static async fromId(vaultConfig, id) {
+    const config = resolveConfig(vaultConfig);
+    const response = await fetch(new URL(`permalinks/${id}/metadata`, config.vaultUrl), {
       headers: config.authStrategy.getHeaders()
     });
     if (!response.ok) {
@@ -108,14 +125,15 @@ class Permalink {
    *
    * @returns The permalink.
    */
-  static async create(config, params, options) {
+  static async create(vaultConfig, params, options) {
+    const config = resolveConfig(vaultConfig);
     const { expiresIn } = params;
     const expiresAt = expiresIn ? new Date(Date.now() + expiresIn * 1e3) : void 0;
     const headers = config.authStrategy.getHeaders();
     headers.append("x-compatibility-date", "2025-07-29");
     headers.append("content-type", "application/json");
     const body = expiresAt ? JSON.stringify({ expiresAt: expiresAt.toISOString() }) : "{}";
-    const response = await fetch(`${config.vaultUrl}/files/${params.fileId}/permalinks`, {
+    const response = await fetch(new URL(`files/${params.fileId}/permalinks`, config.vaultUrl), {
       method: "POST",
       signal: options?.signal,
       headers,
@@ -134,7 +152,7 @@ class Permalink {
    * @param options.signal - The signal to abort the request.
    */
   async delete(options) {
-    const response = await fetch(`${this.config.vaultUrl}/permalinks/${this.id}`, {
+    const response = await fetch(new URL(`permalinks/${this.id}`, this.baseUrl), {
       method: "DELETE",
       signal: options?.signal,
       headers: this.config.authStrategy.getHeaders()
@@ -219,11 +237,13 @@ class VaultFile {
     __publicField(this, "content");
     __publicField(this, "lastDownloadUrl");
     __publicField(this, "lastUploadUrl");
-    this.config = config;
+    __publicField(this, "baseUrl");
+    this.config = resolveConfig(config);
     this.content = content;
     this.id = id;
     this.name = name;
     this.metadata = metadata;
+    this.baseUrl = this.config.vaultUrl;
   }
   /**
    * Gets the headers for the request based on the auth strategy.
@@ -246,7 +266,7 @@ class VaultFile {
    */
   async _fetch(params) {
     const { method, path, body, signal, query } = params;
-    const url = new URL(path, this.config.vaultUrl);
+    const url = new URL(path, this.baseUrl);
     const headers = new Headers(this.headers);
     headers.set("x-compatibility-date", compatibilityDate);
     if (query) {
@@ -291,7 +311,7 @@ class VaultFile {
     }
     this.id = response.data.id;
     this.metadata = response.data.metadata;
-    this.name = response.data.metadata?.originalFileName;
+    this.name = response.data.metadata?.originalFileName ?? void 0;
     return response.data;
   }
   /**
@@ -334,10 +354,11 @@ class VaultFile {
    * ```
    */
   static async fromVaultReference(params, options) {
-    const { reference, config, download = false } = params;
+    const { reference, config: vaultConfig, download = false } = params;
+    const config = resolveConfig(vaultConfig);
     const { vaultUrl, authStrategy } = config;
     const id = removeVaultPrefix(reference);
-    const url = new URL(`files/${id}`, vaultUrl);
+    const url = new URL(`files/${id}`, config.vaultUrl);
     const response = await wrappedFetch(url, {
       method: "GET",
       headers: authStrategy.getHeaders(),
@@ -353,7 +374,7 @@ class VaultFile {
         vaultUrl,
         authStrategy
       },
-      name: response.data.metadata?.originalFileName
+      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);
@@ -404,7 +425,8 @@ class VaultFile {
    * ```
    */
   static async fromContent(params, options) {
-    const { name, content, config, upload = false } = params;
+    const { name, content, config: vaultConfig, upload = false } = params;
+    const config = resolveConfig(vaultConfig);
     const { vaultUrl, authStrategy } = config;
     const sha256sum = await getFileHash(content);
     const mimeType = await detectFileMimeType(content);
@@ -439,7 +461,7 @@ class VaultFile {
   async populateMetadata(options) {
     try {
       this.metadata = await this.getFileMetadata({ signal: options?.signal });
-      this.name = this.metadata.originalFileName;
+      this.name = this.metadata.originalFileName ?? void 0;
       this.id = this.metadata.id;
       return this;
     } catch (error) {
@@ -496,7 +518,7 @@ class VaultFile {
       const createdFile = await this._createFile();
       this.id = createdFile.id;
       this.metadata = createdFile.metadata;
-      this.name = createdFile.metadata?.originalFileName;
+      this.name = createdFile.metadata?.originalFileName ?? void 0;
       this.lastUploadUrl = { url: new URL(createdFile.uploadUrl), expiresAt: new Date(createdFile.expiresAt) };
       return this.lastUploadUrl.url;
     }
@@ -652,7 +674,8 @@ class VaultFile {
   }
 }
 
-function vaultClient(config) {
+function vaultClient(vaultConfig) {
+  const config = resolveConfig(vaultConfig);
   function createFromContent(name, content, options) {
     return VaultFile.fromContent({
       name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/vault-sdk",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -27,7 +27,7 @@
     "check": "bun run lint && bun tsc --noEmit"
   },
   "dependencies": {
-    "@meistrari/vault-shared": "0.0.3",
+    "@meistrari/vault-shared": "0.0.5",
     "file-type": "21.0.0",
     "mime-types": "3.0.1",
     "ofetch": "1.4.1",