eptaadmin-sdk 0.1.3 → 0.1.4

package/README.md

@@ -74,6 +74,15 @@ EptaAdmin stores each column of a data source as its own independent list of val
 
 If your project needs row-aligned records, build them yourself from the columns you know are meant to line up (e.g. by index), since EptaAdmin itself doesn't guarantee that alignment.
 
+## Image values
+
+A column of type "image" stores each value as a URL. The SDK automatically rewrites these to absolute, API-key-authenticated URLs (`{baseUrl}/api/v1/workspaces/{slug}/uploads/{file}`) before returning them, so they're directly usable outside a browser session — you never see or depend on the internal browser-app route these are stored against:
+
+```js
+const avatars = await client.getValue("acme/clients/avatar");
+// ["https://your-eptaadmin-instance.example.com/api/v1/workspaces/acme/uploads/6f2dff985af5d290.png"]
+```
+
 ## Error handling
 
 Failed requests reject with an `EptaAdminError` carrying the HTTP status and the server's error message:

package/package.json

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

package/src/index.js

@@ -11,6 +11,26 @@ export class EptaAdminError extends Error {
   }
 }
 
+// Image column values are stored as the same URL the browser UI uses
+// (/workspaces/{slug}/uploads/{file}), which only accepts a session
+// cookie — useless to an external caller like this SDK, which has none.
+// Rewrite matching values to the API-key-authenticated equivalent instead
+// 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.
+const uploadUrlPattern = /^\/workspaces\/([^/]+)\/uploads\/(.+)$/;
+
+function resolveImageURL(value, baseUrl) {
+  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]}`;
+}
+
+function resolveImageURLs(value, baseUrl) {
+  return Array.isArray(value) ? value.map((v) => resolveImageURL(v, baseUrl)) : resolveImageURL(value, baseUrl);
+}
+
 export class EptaAdminClient {
   /**
    * @param {{ apiKey: string, baseUrl?: string }} options
@@ -53,10 +73,14 @@ export class EptaAdminClient {
    * between columns), so the response mirrors that: `columns` is a plain
    * object of `{ [columnKey]: value[] }`.
    */
-  getDataSource(workspaceSlug, dataSourceSlug) {
-    return this._request(
+  async getDataSource(workspaceSlug, dataSourceSlug) {
+    const body = await this._request(
       `/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);
+    }
+    return body;
   }
 
   /**
@@ -83,6 +107,6 @@ export class EptaAdminClient {
       url += `/${encodeURIComponent(index)}`;
     }
     const body = await this._request(url);
-    return index !== undefined ? body.value : body.values;
+    return resolveImageURLs(index !== undefined ? body.value : body.values, this.baseUrl);
   }
 }