eptaadmin-sdk 0.1.2 → 0.1.4

package/README.md

@@ -6,7 +6,13 @@ This SDK is currently **read-only**: it fetches workspaces, data sources, and th
 
 ## Install
 
-This package isn't published to the npm registry yet. Install it directly from the EptaAdmin repository, e.g. by copying `sdk/js/` into your project or adding it as a local/git dependency:
+```sh
+npm install eptaadmin-sdk
+```
+
+The package is published on the [npm registry](https://www.npmjs.com/package/eptaadmin-sdk) and versioned automatically from this repository (see `.github/workflows/publish-sdk.yml`) — every change under `sdk/js/` merged to `main` bumps the version and publishes a new release.
+
+If you'd rather work against an unreleased change, point at the local folder instead:
 
 ```json
 {
@@ -68,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.2",
+  "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);
   }
 }