eptaadmin-sdk 0.1.6 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eptaadmin-sdk",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Client SDK for reading your EptaAdmin workspace data from your own project.",
   "type": "module",
   "main": "src/index.js",

package/src/index.js

@@ -18,17 +18,26 @@ export class EptaAdminError extends Error {
 // of just prefixing baseUrl onto the internal route, so callers get a
 // working absolute URL without depending on (or seeing) that internal
 // browser-route shape.
+//
+// The key travels as a "?apiKey=" query parameter, not an Authorization
+// header, because the whole point of this URL is to be usable directly as
+// an <img>/<video> src — a browser's native resource fetch for those never
+// attaches custom headers, so a header-only scheme would make the URL this
+// returns unusable for that (the single most common reason to want it).
 const uploadUrlPattern = /^\/workspaces\/([^/]+)\/uploads\/(.+)$/;
 
-function resolveImageURL(value, baseUrl) {
+function resolveImageURL(value, baseUrl, apiKey) {
   if (typeof value !== "string") return value;
   const match = value.match(uploadUrlPattern);
   if (!match) return value;
-  return `${baseUrl}/api/v1/workspaces/${match[1]}/uploads/${match[2]}`;
+  const url = `${baseUrl}/api/v1/workspaces/${match[1]}/uploads/${match[2]}`;
+  return apiKey ? `${url}?apiKey=${encodeURIComponent(apiKey)}` : url;
 }
 
-function resolveImageURLs(value, baseUrl) {
-  return Array.isArray(value) ? value.map((v) => resolveImageURL(v, baseUrl)) : resolveImageURL(value, baseUrl);
+function resolveImageURLs(value, baseUrl, apiKey) {
+  return Array.isArray(value)
+    ? value.map((v) => resolveImageURL(v, baseUrl, apiKey))
+    : resolveImageURL(value, baseUrl, apiKey);
 }
 
 // Populated by build tooling (see eptaadmin-sdk/vite) via a bundler `define`
@@ -95,7 +104,7 @@ export class EptaAdminClient {
           `/api/v1/workspaces/${encodeURIComponent(workspaceSlug)}/datasources/${encodeURIComponent(dataSourceSlug)}`
         );
     for (const key of Object.keys(body.columns || {})) {
-      body.columns[key] = resolveImageURLs(body.columns[key], this.baseUrl);
+      body.columns[key] = resolveImageURLs(body.columns[key], this.baseUrl, this.apiKey);
     }
     return body;
   }
@@ -127,7 +136,7 @@ export class EptaAdminClient {
       if (index !== undefined && result === undefined) {
         throw new EptaAdminError(`index ${index} out of range for column "${column}"`, 404);
       }
-      return resolveImageURLs(result, this.baseUrl);
+      return resolveImageURLs(result, this.baseUrl, this.apiKey);
     }
 
     let url =
@@ -138,6 +147,6 @@ export class EptaAdminClient {
       url += `/${encodeURIComponent(index)}`;
     }
     const body = await this._request(url);
-    return resolveImageURLs(index !== undefined ? body.value : body.values, this.baseUrl);
+    return resolveImageURLs(index !== undefined ? body.value : body.values, this.baseUrl, this.apiKey);
   }
 }