@fonderie/client 0.17.1 → 0.18.0

package/brain/signatures.md

@@ -48,6 +48,7 @@ new FonderieClient(opts: IFonderieClientOptions): FonderieClient
   .audit: AuditClient
   .webhooks: WebhooksClient
   .customers: CustomersClient
+  .media: MediaClient
   .setAccessToken(token: string | undefined): void
   .clearCache(): void
   .setWorkspaceId(workspaceId: string | undefined): void
@@ -377,6 +378,20 @@ new CustomersClient(http: HttpClient, tokens: TokenStore): CustomersClient
   .listLabels(type: CustomerLabelType, opts?: IReadOptions | undefined): Promise<IApiResponse<ICustomerLabelListResult>>
   .removeLabel(labelId: string): Promise<IApiResponse<undefined>>
 
+interface IUploadMediaInput {
+    dataBase64: string;
+    purpose?: string;
+    ownerType?: string;
+    ownerId?: string;
+}
+
+new MediaClient(http: HttpClient, tokens: TokenStore): MediaClient
+  .setAccessToken(token: string | undefined): void
+  .upload(input: IUploadMediaInput): Promise<IApiResponse<IMediaAssetResult>>
+  .delete(id: string): Promise<IApiResponse<{ id: string; }>>
+  .assetUrl(id: string): string
+  .assetIdFromUrl(url: string | null | undefined): string | null
+
 interface ICreateWebhookEndpointInput {
     url: string;
     events?: string[];
@@ -800,6 +815,21 @@ interface ILoginResult {
     requiresVerification?: boolean;
 }
 
+interface IMediaAssetDTO {
+    id: string;
+    url: string;
+    contentType: string;
+    byteSize: number;
+    ownerType: string;
+    ownerId: string;
+    purpose: string;
+    createdAt: string;
+}
+
+interface IMediaAssetResult {
+    asset: IMediaAssetDTO;
+}
+
 interface IMemberDTO {
     userId: string;
     workspaceId: string;

package/dist/index.cjs

@@ -28,6 +28,7 @@ __export(index_exports, {
   CustomersClient: () => CustomersClient,
   FonderieApiError: () => FonderieApiError,
   FonderieClient: () => FonderieClient,
+  MediaClient: () => MediaClient,
   WebhooksClient: () => WebhooksClient,
   WorkspacesClient: () => WorkspacesClient,
   createMemoryCache: () => createMemoryCache,
@@ -98,6 +99,12 @@ var HttpClient = class {
   cache;
   defaultTtlMs;
   refresh;
+  // Absolute URL for a path on this client's origin — for endpoints a browser
+  // navigates to or embeds (e.g. a public `<img src>`) rather than fetches
+  // through request(). Mirrors the `${baseUrl}${path}` join request() uses.
+  absolute(path) {
+    return `${this.baseUrl}${path}`;
+  }
   // Drop all cached responses — sign-out must not leave one session's data
   // servable to the next.
   clearCache() {
@@ -1020,6 +1027,55 @@ var CustomersClient = class {
   }
 };
 
+// src/modules/media.ts
+var MediaClient = class {
+  constructor(http, tokens) {
+    this.http = http;
+    this.tokens = tokens;
+  }
+  http;
+  tokens;
+  setAccessToken(token) {
+    this.tokens.set(token);
+  }
+  // POST /media — store an image; returns the asset with its monomorphic
+  // /media/:id url. requireAuth server-side.
+  upload(input) {
+    return this.http.request({
+      method: "POST",
+      path: "/media",
+      body: input,
+      token: this.tokens.get()
+    });
+  }
+  // DELETE /media/:id — uploader-only (403 for anyone else).
+  delete(id) {
+    return this.http.request({
+      method: "DELETE",
+      path: `/media/${encodeURIComponent(id)}`,
+      token: this.tokens.get()
+    });
+  }
+  // Absolute URL for a stored asset — an `<img src>` target. The GET /media/:id
+  // route is public and cached (it can't carry a Bearer token), so turn an
+  // upload's `asset.id` into a browser-loadable URL with this, and use it as
+  // the avatarUrl handed to auth's updateProfile.
+  assetUrl(id) {
+    return this.http.absolute(`/media/${encodeURIComponent(id)}`);
+  }
+  // Inverse of assetUrl: pull the asset id out of one of THIS brick's
+  // /media/:id URLs (absolute or relative); null for empty/external URLs. Lets
+  // avatar cleanup delete only assets we minted (matched as a UUID), never a
+  // placeholder or third-party avatar URL.
+  assetIdFromUrl(url) {
+    if (!url) return null;
+    const m = url.match(
+      /\/media\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})(?:[/?#]|$)/i
+    );
+    return m ? m[1] : null;
+  }
+};
+
 // src/modules/webhooks.ts
 var WebhooksClient = class {
   constructor(http, tokens) {
@@ -1355,6 +1411,7 @@ var FonderieClient = class {
   audit;
   webhooks;
   customers;
+  media;
   http;
   tokens;
   workspaceId;
@@ -1377,6 +1434,7 @@ var FonderieClient = class {
     this.audit = new AuditClient(this.http, this.tokens);
     this.webhooks = new WebhooksClient(this.http, this.tokens);
     this.customers = new CustomersClient(this.http, this.tokens);
+    this.media = new MediaClient(this.http, this.tokens);
     if (opts.workspaceId !== void 0) this.setWorkspaceId(opts.workspaceId);
   }
   // Single-flight refresh: POST /auth/refresh with the app-supplied refresh
@@ -1665,6 +1723,7 @@ function isMfaRequired(result) {
   CustomersClient,
   FonderieApiError,
   FonderieClient,
+  MediaClient,
   WebhooksClient,
   WorkspacesClient,
   createMemoryCache,