brainerce 1.30.0 → 1.32.0

package/dist/index.d.mts

@@ -2736,6 +2736,37 @@ interface VariantInventoryResponse {
     canPurchase: boolean;
     lastInventorySyncAt?: string | null;
 }
+/**
+ * A media-library asset returned by the admin media endpoints
+ * (`/v1/media/*`). The CDN `url` is what you store in `images[].url` on a
+ * product. Requires an admin API key with `media:read` / `media:write`.
+ */
+interface MediaAsset {
+    id: string;
+    url: string;
+    key: string;
+    thumbnailUrl: string | null;
+    mimeType: string;
+    width: number | null;
+    height: number | null;
+    size: number;
+    /** Display name / title in the media library. */
+    name: string;
+    /** Accessibility alt text. */
+    alt: string | null;
+    createdAt: string;
+}
+/** Query params for `listMedia`. */
+interface ListMediaParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+}
+/** Body for `updateMediaAsset` — default metadata. */
+interface UpdateMediaAssetInput {
+    alt?: string;
+    name?: string;
+}
 type RefundType = 'full' | 'partial';
 interface RefundLineItem {
     lineItemId: string;
@@ -5582,6 +5613,50 @@ declare class BrainerceClient {
      * ```
      */
     updateVariantInventory(productId: string, variantId: string, data: UpdateVariantInventoryDto): Promise<VariantInventoryResponse>;
+    /**
+     * Upload a file, or ingest a remote image URL, into the store's media
+     * library. Requires an admin API key with the `media:write` scope. Returns
+     * the created asset — store `asset.url` in `images[].url` on a product.
+     *
+     * @example
+     * ```typescript
+     * // Upload a File/Blob:
+     * const asset = await client.uploadMedia(fileInput.files[0]);
+     * // …or ingest by URL (fetched server-side via the SSRF-safe downloader):
+     * const asset = await client.uploadMedia({ sourceUrl: 'https://example.com/photo.jpg' });
+     * await client.updateProduct('prod_123', {
+     *   images: [{ url: asset.url, position: 0, isMain: true }],
+     * });
+     * ```
+     */
+    uploadMedia(input: File | Blob | {
+        sourceUrl: string;
+    }): Promise<MediaAsset>;
+    /**
+     * List media-library assets (paginated). Requires `media:read`.
+     *
+     * @example
+     * ```typescript
+     * const { data, meta } = await client.listMedia({ page: 1, limit: 50, search: 'hero' });
+     * ```
+     */
+    listMedia(params?: ListMediaParams): Promise<PaginatedResponse<MediaAsset>>;
+    /**
+     * Get a single media asset by ID. Requires `media:read`.
+     */
+    getMedia(id: string): Promise<MediaAsset>;
+    /**
+     * Update an asset's default metadata (`alt` / `name`). Requires `media:write`.
+     */
+    updateMediaAsset(id: string, data: UpdateMediaAssetInput): Promise<MediaAsset>;
+    /**
+     * Delete a media asset — soft-deletes it and removes its key from every
+     * product/variant/category/brand/store/modifier that referenced it.
+     * Requires `media:write`.
+     */
+    deleteMedia(id: string): Promise<{
+        success: boolean;
+    }>;
     /**
      * Get a list of orders with pagination
      */

package/dist/index.d.ts

@@ -2736,6 +2736,37 @@ interface VariantInventoryResponse {
     canPurchase: boolean;
     lastInventorySyncAt?: string | null;
 }
+/**
+ * A media-library asset returned by the admin media endpoints
+ * (`/v1/media/*`). The CDN `url` is what you store in `images[].url` on a
+ * product. Requires an admin API key with `media:read` / `media:write`.
+ */
+interface MediaAsset {
+    id: string;
+    url: string;
+    key: string;
+    thumbnailUrl: string | null;
+    mimeType: string;
+    width: number | null;
+    height: number | null;
+    size: number;
+    /** Display name / title in the media library. */
+    name: string;
+    /** Accessibility alt text. */
+    alt: string | null;
+    createdAt: string;
+}
+/** Query params for `listMedia`. */
+interface ListMediaParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+}
+/** Body for `updateMediaAsset` — default metadata. */
+interface UpdateMediaAssetInput {
+    alt?: string;
+    name?: string;
+}
 type RefundType = 'full' | 'partial';
 interface RefundLineItem {
     lineItemId: string;
@@ -5582,6 +5613,50 @@ declare class BrainerceClient {
      * ```
      */
     updateVariantInventory(productId: string, variantId: string, data: UpdateVariantInventoryDto): Promise<VariantInventoryResponse>;
+    /**
+     * Upload a file, or ingest a remote image URL, into the store's media
+     * library. Requires an admin API key with the `media:write` scope. Returns
+     * the created asset — store `asset.url` in `images[].url` on a product.
+     *
+     * @example
+     * ```typescript
+     * // Upload a File/Blob:
+     * const asset = await client.uploadMedia(fileInput.files[0]);
+     * // …or ingest by URL (fetched server-side via the SSRF-safe downloader):
+     * const asset = await client.uploadMedia({ sourceUrl: 'https://example.com/photo.jpg' });
+     * await client.updateProduct('prod_123', {
+     *   images: [{ url: asset.url, position: 0, isMain: true }],
+     * });
+     * ```
+     */
+    uploadMedia(input: File | Blob | {
+        sourceUrl: string;
+    }): Promise<MediaAsset>;
+    /**
+     * List media-library assets (paginated). Requires `media:read`.
+     *
+     * @example
+     * ```typescript
+     * const { data, meta } = await client.listMedia({ page: 1, limit: 50, search: 'hero' });
+     * ```
+     */
+    listMedia(params?: ListMediaParams): Promise<PaginatedResponse<MediaAsset>>;
+    /**
+     * Get a single media asset by ID. Requires `media:read`.
+     */
+    getMedia(id: string): Promise<MediaAsset>;
+    /**
+     * Update an asset's default metadata (`alt` / `name`). Requires `media:write`.
+     */
+    updateMediaAsset(id: string, data: UpdateMediaAssetInput): Promise<MediaAsset>;
+    /**
+     * Delete a media asset — soft-deletes it and removes its key from every
+     * product/variant/category/brand/store/modifier that referenced it.
+     * Requires `media:write`.
+     */
+    deleteMedia(id: string): Promise<{
+        success: boolean;
+    }>;
     /**
      * Get a list of orders with pagination
      */

package/dist/index.js

@@ -1404,6 +1404,70 @@ var BrainerceClient = class {
       data
     );
   }
+  // -------------------- Media Library (Admin) --------------------
+  /**
+   * Upload a file, or ingest a remote image URL, into the store's media
+   * library. Requires an admin API key with the `media:write` scope. Returns
+   * the created asset — store `asset.url` in `images[].url` on a product.
+   *
+   * @example
+   * ```typescript
+   * // Upload a File/Blob:
+   * const asset = await client.uploadMedia(fileInput.files[0]);
+   * // …or ingest by URL (fetched server-side via the SSRF-safe downloader):
+   * const asset = await client.uploadMedia({ sourceUrl: 'https://example.com/photo.jpg' });
+   * await client.updateProduct('prod_123', {
+   *   images: [{ url: asset.url, position: 0, isMain: true }],
+   * });
+   * ```
+   */
+  async uploadMedia(input) {
+    const formData = new FormData();
+    if (typeof input === "object" && "sourceUrl" in input) {
+      formData.append("sourceUrl", input.sourceUrl);
+    } else {
+      formData.append("file", input);
+    }
+    return this.adminRequest("POST", "/api/v1/media", formData);
+  }
+  /**
+   * List media-library assets (paginated). Requires `media:read`.
+   *
+   * @example
+   * ```typescript
+   * const { data, meta } = await client.listMedia({ page: 1, limit: 50, search: 'hero' });
+   * ```
+   */
+  async listMedia(params) {
+    return this.adminRequest("GET", "/api/v1/media", void 0, {
+      page: params?.page,
+      limit: params?.limit,
+      search: params?.search
+    });
+  }
+  /**
+   * Get a single media asset by ID. Requires `media:read`.
+   */
+  async getMedia(id) {
+    return this.adminRequest("GET", `/api/v1/media/${encodePathSegment(id)}`);
+  }
+  /**
+   * Update an asset's default metadata (`alt` / `name`). Requires `media:write`.
+   */
+  async updateMediaAsset(id, data) {
+    return this.adminRequest("PATCH", `/api/v1/media/${encodePathSegment(id)}`, data);
+  }
+  /**
+   * Delete a media asset — soft-deletes it and removes its key from every
+   * product/variant/category/brand/store/modifier that referenced it.
+   * Requires `media:write`.
+   */
+  async deleteMedia(id) {
+    return this.adminRequest(
+      "DELETE",
+      `/api/v1/media/${encodePathSegment(id)}`
+    );
+  }
   // -------------------- Orders --------------------
   /**
    * Get a list of orders with pagination

package/dist/index.mjs

@@ -1334,6 +1334,70 @@ var BrainerceClient = class {
       data
     );
   }
+  // -------------------- Media Library (Admin) --------------------
+  /**
+   * Upload a file, or ingest a remote image URL, into the store's media
+   * library. Requires an admin API key with the `media:write` scope. Returns
+   * the created asset — store `asset.url` in `images[].url` on a product.
+   *
+   * @example
+   * ```typescript
+   * // Upload a File/Blob:
+   * const asset = await client.uploadMedia(fileInput.files[0]);
+   * // …or ingest by URL (fetched server-side via the SSRF-safe downloader):
+   * const asset = await client.uploadMedia({ sourceUrl: 'https://example.com/photo.jpg' });
+   * await client.updateProduct('prod_123', {
+   *   images: [{ url: asset.url, position: 0, isMain: true }],
+   * });
+   * ```
+   */
+  async uploadMedia(input) {
+    const formData = new FormData();
+    if (typeof input === "object" && "sourceUrl" in input) {
+      formData.append("sourceUrl", input.sourceUrl);
+    } else {
+      formData.append("file", input);
+    }
+    return this.adminRequest("POST", "/api/v1/media", formData);
+  }
+  /**
+   * List media-library assets (paginated). Requires `media:read`.
+   *
+   * @example
+   * ```typescript
+   * const { data, meta } = await client.listMedia({ page: 1, limit: 50, search: 'hero' });
+   * ```
+   */
+  async listMedia(params) {
+    return this.adminRequest("GET", "/api/v1/media", void 0, {
+      page: params?.page,
+      limit: params?.limit,
+      search: params?.search
+    });
+  }
+  /**
+   * Get a single media asset by ID. Requires `media:read`.
+   */
+  async getMedia(id) {
+    return this.adminRequest("GET", `/api/v1/media/${encodePathSegment(id)}`);
+  }
+  /**
+   * Update an asset's default metadata (`alt` / `name`). Requires `media:write`.
+   */
+  async updateMediaAsset(id, data) {
+    return this.adminRequest("PATCH", `/api/v1/media/${encodePathSegment(id)}`, data);
+  }
+  /**
+   * Delete a media asset — soft-deletes it and removes its key from every
+   * product/variant/category/brand/store/modifier that referenced it.
+   * Requires `media:write`.
+   */
+  async deleteMedia(id) {
+    return this.adminRequest(
+      "DELETE",
+      `/api/v1/media/${encodePathSegment(id)}`
+    );
+  }
   // -------------------- Orders --------------------
   /**
    * Get a list of orders with pagination

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainerce",
-  "version": "1.30.0",
+  "version": "1.32.0",
   "description": "Official SDK for building e-commerce storefronts with Brainerce Platform. Perfect for vibe-coded sites, AI-built stores (Cursor, Lovable, v0), and custom storefronts.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",