@defoai/ads-client 1.4.0

package/dist/index.js

@@ -0,0 +1,207 @@
+// Defo Ads — official TypeScript SDK (US-ADS-267).
+//
+// A thin, hand-written façade over the OpenAPI-generated core (./generated). It
+// gives you the ergonomic surface — `new DefoAds({ token }).campaigns.list()` —
+// with bearer auth, a default Space header, cursor auto-pagination, retry-on-429
+// (honoring Retry-After) and typed errors, while the generated core (regenerated
+// from the spec on every release) does the wire work and stays byte-true to the
+// API contract.
+//
+// Quick start:
+//   import { DefoAds } from '@defoai/ads-client';
+//   const defo = new DefoAds({ token: process.env.DEFOADS_TOKEN!, space: 'spc_…' });
+//   const campaigns = await defo.campaigns.list();          // first page
+//   for await (const c of defo.campaigns.listAll()) { … }    // every page
+//   const created = await defo.campaigns.create({ name: 'Launch', budget: 50 });
+import { Configuration, CampaignsApi, AdGroupsApi, AdsApi, KeywordsApi, SitesApi, AssetsApi, CampaignAssetsApi, AdAssetsApi, MediaApi, ReportsApi, SyncApi, MetaApi, } from './generated';
+/** The production base URL. Override via `baseUrl` (e.g. for staging). */
+export const PRODUCTION_BASE_URL = 'https://api.ads.defoai.com';
+export const STAGING_BASE_URL = 'https://api-ads-staging.defoai.com';
+// ---- Typed errors -------------------------------------------------------------
+/** Base error for any non-2xx response; carries the API's `{ code, message, details }`. */
+export class DefoAdsError extends Error {
+    constructor(status, code, message, details) {
+        super(message);
+        this.name = 'DefoAdsError';
+        this.status = status;
+        this.code = code;
+        this.details = details;
+    }
+}
+/** 401 — missing/invalid token. */ export class AuthError extends DefoAdsError {
+    constructor() {
+        super(...arguments);
+        this.name = 'AuthError';
+    }
+}
+/** 403 — token lacks the required scope or Space membership. */ export class ForbiddenError extends DefoAdsError {
+    constructor() {
+        super(...arguments);
+        this.name = 'ForbiddenError';
+    }
+}
+/** 404 — resource not found (or outside your Space). */ export class NotFoundError extends DefoAdsError {
+    constructor() {
+        super(...arguments);
+        this.name = 'NotFoundError';
+    }
+}
+/** 409 — conflict (e.g. delete blocked by dependents, or a sync already running). */ export class ConflictError extends DefoAdsError {
+    constructor() {
+        super(...arguments);
+        this.name = 'ConflictError';
+    }
+}
+/** 429 — rate limited. The SDK already retried up to `maxRetries`. */ export class RateLimitError extends DefoAdsError {
+    constructor() {
+        super(...arguments);
+        this.name = 'RateLimitError';
+    }
+}
+function toTypedError(status, code, message, details) {
+    const msg = message || `HTTP ${status}`;
+    switch (status) {
+        case 401: return new AuthError(status, code, msg, details);
+        case 403: return new ForbiddenError(status, code, msg, details);
+        case 404: return new NotFoundError(status, code, msg, details);
+        case 409: return new ConflictError(status, code, msg, details);
+        case 429: return new RateLimitError(status, code, msg, details);
+        default: return new DefoAdsError(status, code, msg, details);
+    }
+}
+// ---- fetch with retry/backoff (honors Retry-After) ---------------------------
+function retryingFetch(baseFetch, maxRetries) {
+    return async (input, init) => {
+        const method = (init?.method || 'GET').toUpperCase();
+        const idempotent = method === 'GET' || method === 'PUT' || method === 'DELETE';
+        let attempt = 0;
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            const res = await baseFetch(input, init);
+            const retryable = res.status === 429 || (res.status >= 500 && idempotent);
+            if (!retryable || attempt >= maxRetries)
+                return res;
+            const retryAfter = res.headers.get('retry-after');
+            const waitMs = retryAfter
+                ? Number(retryAfter) * 1000
+                : Math.min(2 ** attempt * 500, 8000);
+            await new Promise((r) => setTimeout(r, Number.isFinite(waitMs) ? waitMs : 1000));
+            attempt += 1;
+        }
+    };
+}
+// Throw a typed error on any 4xx/5xx, parsing the `ErrorEnvelope`, BEFORE the
+// generated core raises its generic ResponseError.
+const errorMiddleware = {
+    post: async ({ response }) => {
+        if (response.status >= 400) {
+            let code;
+            let message = response.statusText;
+            let details;
+            try {
+                const body = await response.clone().json();
+                code = body?.error?.code;
+                message = body?.error?.message ?? message;
+                details = body?.error?.details;
+            }
+            catch { /* non-JSON error body */ }
+            throw toTypedError(response.status, code, message, details);
+        }
+        return response;
+    },
+};
+// ---- generic resource factory ------------------------------------------------
+// Every generated method takes a single request-params object and returns a
+// SuccessEnvelope `{ data, meta }`; the façade unwraps `.data` and threads the
+// default Space + cursor pagination. Input bodies stay fully typed (C/U); list
+// responses are arrays (the envelope's `data` is contract-untyped today).
+const data = (env) => env?.data;
+function crudResource(api, prefix, createKey, updateKey) {
+    return {
+        /** List one page (default 50, max 200). */
+        list: (params = {}) => api[`${prefix}List`]({ ...params }).then(data),
+        /** Async-iterate EVERY item across all pages (follows `meta.nextCursor`). */
+        async *listAll(params = {}) {
+            let cursor = params.cursor;
+            do {
+                const env = await api[`${prefix}List`]({ ...params, cursor });
+                for (const item of env.data ?? [])
+                    yield item;
+                cursor = env.meta?.nextCursor ?? undefined;
+            } while (cursor);
+        },
+        /** Fetch one by id. */
+        get: (id) => api[`${prefix}Get`]({ id }).then(data),
+        /** Create. */
+        create: (body) => api[`${prefix}Create`]({ [createKey]: body }).then(data),
+        /** Partial update by id. */
+        update: (id, body) => api[`${prefix}Update`]({ id, [updateKey]: body }).then(data),
+        /** Delete by id. */
+        delete: (id) => api[`${prefix}Delete`]({ id }).then(data),
+    };
+}
+/** The Defo Ads client. Construct once, reuse everywhere. */
+export class DefoAds {
+    constructor(options) {
+        if (!options?.token)
+            throw new Error('DefoAds: `token` is required (a dads_… personal access token).');
+        const baseFetch = options.fetch ?? globalThis.fetch;
+        if (!baseFetch)
+            throw new Error('DefoAds: no global fetch — pass `fetch` in options (Node < 18).');
+        const config = new Configuration({
+            basePath: options.baseUrl ?? PRODUCTION_BASE_URL,
+            accessToken: options.token, // → Authorization: Bearer <token>
+            headers: options.space ? { 'X-Space-Id': options.space } : {},
+            fetchApi: retryingFetch(baseFetch, options.maxRetries ?? 3),
+            middleware: [errorMiddleware],
+        });
+        this.campaigns = crudResource(new CampaignsApi(config), 'campaigns', 'campaignCreate', 'campaignUpdate');
+        this.adGroups = crudResource(new AdGroupsApi(config), 'adGroups', 'adGroupCreate', 'adGroupUpdate');
+        this.ads = crudResource(new AdsApi(config), 'ads', 'adCreate', 'adUpdate');
+        this.keywords = crudResource(new KeywordsApi(config), 'keywords', 'keywordCreate', 'keywordUpdate');
+        this.sites = crudResource(new SitesApi(config), 'sites', 'siteCreate', 'siteUpdate');
+        this.assets = crudResource(new AssetsApi(config), 'assets', 'assetCreate', 'assetUpdate');
+        // Binding-only resources (no full CRUD).
+        const campaignAssetsApi = new CampaignAssetsApi(config);
+        this.campaignAssets = {
+            list: (p = {}) => campaignAssetsApi.campaignAssetsList(p).then(data),
+            get: (id) => campaignAssetsApi.campaignAssetsGet({ id }).then(data),
+            create: (body) => campaignAssetsApi.campaignAssetsCreate({ campaignAssetCreate: body }).then(data),
+            delete: (id) => campaignAssetsApi.campaignAssetsDelete({ id }).then(data),
+        };
+        const adAssetsApi = new AdAssetsApi(config);
+        this.adAssets = {
+            list: (p = {}) => adAssetsApi.adAssetsList(p).then(data),
+            get: (id) => adAssetsApi.adAssetsGet({ id }).then(data),
+            create: (body) => adAssetsApi.adAssetsCreate({ adAssetCreate: body }).then(data),
+            delete: (id) => adAssetsApi.adAssetsDelete({ id }).then(data),
+        };
+        const mediaApi = new MediaApi(config);
+        this.media = { matrix: () => mediaApi.mediaMatrix().then(data) };
+        const reportsApi = new ReportsApi(config);
+        this.reports = {
+            /** Performance stats; see the reference for `date_range`, `group_by`, `metrics`, etc. */
+            stats: (params = {}) => reportsApi.reportsStats(params).then(data),
+        };
+        const syncApi = new SyncApi(config);
+        this.sync = {
+            /** Trigger a sync for the active Space (async — poll `get(syncId)`). */
+            trigger: (body = {}) => syncApi.syncTrigger({ syncTriggerRequest: body }).then(data),
+            list: (p = {}) => syncApi.syncList(p).then(data),
+            /** Dry-run plan (import/export/remove) without executing. */
+            plan: (p = {}) => syncApi.syncPlan(p).then(data),
+            get: (id) => syncApi.syncGet({ id }).then(data),
+            cancel: (id) => syncApi.syncCancel({ id }).then(data),
+            /** Unlink campaigns from a platform (keeps the local campaign). */
+            unlink: (body) => syncApi.syncUnlink({ syncUnlinkRequest: body }).then(data),
+        };
+        const metaApi = new MetaApi(config);
+        this.meta = {
+            /** Introspect the authenticated token. */
+            me: () => metaApi.meGet().then(data),
+            /** List Spaces the token can access. */
+            spaces: () => metaApi.spacesList().then(data),
+        };
+    }
+}
+export default DefoAds;

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@defoai/ads-client",
+  "version": "1.4.0",
+  "description": "Official TypeScript SDK for the Defo Ads public API (/api/v1).",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test --import tsx test/*.test.ts"
+  },
+  "devDependencies": {
+    "tsx": "^4.22.4",
+    "typescript": "^5.9.3"
+  }
+}

package/src/generated/apis/AdAssetsApi.ts

@@ -0,0 +1,342 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+import * as runtime from '../runtime';
+import type {
+  AdAssetCreate,
+  CampaignsListCursorParameter,
+  ErrorEnvelope,
+  SuccessEnvelope,
+} from '../models/index';
+import {
+    AdAssetCreateFromJSON,
+    AdAssetCreateToJSON,
+    CampaignsListCursorParameterFromJSON,
+    CampaignsListCursorParameterToJSON,
+    ErrorEnvelopeFromJSON,
+    ErrorEnvelopeToJSON,
+    SuccessEnvelopeFromJSON,
+    SuccessEnvelopeToJSON,
+} from '../models/index';
+
+export interface AdAssetsCreateRequest {
+    adAssetCreate: AdAssetCreate;
+    xSpaceId?: string;
+}
+
+export interface AdAssetsDeleteRequest {
+    id: string;
+    xSpaceId?: string;
+}
+
+export interface AdAssetsGetRequest {
+    id: string;
+    xSpaceId?: string;
+}
+
+export interface AdAssetsListRequest {
+    limit?: number;
+    cursor?: CampaignsListCursorParameter;
+    adId?: string;
+    adGroupId?: string;
+    campaignId?: string;
+    role?: string;
+    xSpaceId?: string;
+}
+
+/**
+ * AdAssetsApi - interface
+ * 
+ * @export
+ * @interface AdAssetsApiInterface
+ */
+export interface AdAssetsApiInterface {
+    /**
+     * 
+     * @summary Bind an asset to an ad or ad group with a role
+     * @param {AdAssetCreate} adAssetCreate 
+     * @param {string} [xSpaceId] Target Space ID (e.g. `spc_…`). Omit to use the caller\'s Personal Space. Invalid Space → 404 SPACE_NOT_FOUND; non-member → 403 NOT_A_MEMBER.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdAssetsApiInterface
+     */
+    adAssetsCreateRaw(requestParameters: AdAssetsCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+
+    /**
+     * Bind an asset to an ad or ad group with a role
+     */
+    adAssetsCreate(requestParameters: AdAssetsCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+
+    /**
+     * 
+     * @summary Remove an ad-asset binding
+     * @param {string} id 
+     * @param {string} [xSpaceId] Target Space ID (e.g. &#x60;spc_…&#x60;). Omit to use the caller\&#39;s Personal Space. Invalid Space → 404 SPACE_NOT_FOUND; non-member → 403 NOT_A_MEMBER.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdAssetsApiInterface
+     */
+    adAssetsDeleteRaw(requestParameters: AdAssetsDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+
+    /**
+     * Remove an ad-asset binding
+     */
+    adAssetsDelete(requestParameters: AdAssetsDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+
+    /**
+     * 
+     * @summary Get ad-asset binding
+     * @param {string} id 
+     * @param {string} [xSpaceId] Target Space ID (e.g. &#x60;spc_…&#x60;). Omit to use the caller\&#39;s Personal Space. Invalid Space → 404 SPACE_NOT_FOUND; non-member → 403 NOT_A_MEMBER.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdAssetsApiInterface
+     */
+    adAssetsGetRaw(requestParameters: AdAssetsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+
+    /**
+     * Get ad-asset binding
+     */
+    adAssetsGet(requestParameters: AdAssetsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+
+    /**
+     * 
+     * @summary List ad / ad-group asset bindings (filter by adId/adGroupId/campaignId)
+     * @param {number} [limit] Maximum items to return. Default 50, max 200.
+     * @param {CampaignsListCursorParameter} [cursor] Opaque pagination cursor returned by the previous page in &#x60;meta.nextCursor&#x60;.
+     * @param {string} [adId] Restrict to bindings for a specific ad.
+     * @param {string} [adGroupId] Restrict to bindings for a specific ad group.
+     * @param {string} [campaignId] All ad/ad-group bindings across a campaign.
+     * @param {string} [role] Filter by asset role.
+     * @param {string} [xSpaceId] Target Space ID (e.g. &#x60;spc_…&#x60;). Omit to use the caller\&#39;s Personal Space. Invalid Space → 404 SPACE_NOT_FOUND; non-member → 403 NOT_A_MEMBER.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdAssetsApiInterface
+     */
+    adAssetsListRaw(requestParameters: AdAssetsListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+
+    /**
+     * List ad / ad-group asset bindings (filter by adId/adGroupId/campaignId)
+     */
+    adAssetsList(requestParameters: AdAssetsListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+
+}
+
+/**
+ * 
+ */
+export class AdAssetsApi extends runtime.BaseAPI implements AdAssetsApiInterface {
+
+    /**
+     * Bind an asset to an ad or ad group with a role
+     */
+    async adAssetsCreateRaw(requestParameters: AdAssetsCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>> {
+        if (requestParameters['adAssetCreate'] == null) {
+            throw new runtime.RequiredError(
+                'adAssetCreate',
+                'Required parameter "adAssetCreate" was null or undefined when calling adAssetsCreate().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (requestParameters['xSpaceId'] != null) {
+            headerParameters['X-Space-Id'] = String(requestParameters['xSpaceId']);
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiToken", ["ads:write"]);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const response = await this.request({
+            path: `/api/v1/ad-assets`,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: AdAssetCreateToJSON(requestParameters['adAssetCreate']),
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SuccessEnvelopeFromJSON(jsonValue));
+    }
+
+    /**
+     * Bind an asset to an ad or ad group with a role
+     */
+    async adAssetsCreate(requestParameters: AdAssetsCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope> {
+        const response = await this.adAssetsCreateRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Remove an ad-asset binding
+     */
+    async adAssetsDeleteRaw(requestParameters: AdAssetsDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>> {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError(
+                'id',
+                'Required parameter "id" was null or undefined when calling adAssetsDelete().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (requestParameters['xSpaceId'] != null) {
+            headerParameters['X-Space-Id'] = String(requestParameters['xSpaceId']);
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiToken", ["ads:write"]);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const response = await this.request({
+            path: `/api/v1/ad-assets/{id}`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SuccessEnvelopeFromJSON(jsonValue));
+    }
+
+    /**
+     * Remove an ad-asset binding
+     */
+    async adAssetsDelete(requestParameters: AdAssetsDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope> {
+        const response = await this.adAssetsDeleteRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Get ad-asset binding
+     */
+    async adAssetsGetRaw(requestParameters: AdAssetsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>> {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError(
+                'id',
+                'Required parameter "id" was null or undefined when calling adAssetsGet().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (requestParameters['xSpaceId'] != null) {
+            headerParameters['X-Space-Id'] = String(requestParameters['xSpaceId']);
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiToken", ["ads:read"]);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const response = await this.request({
+            path: `/api/v1/ad-assets/{id}`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SuccessEnvelopeFromJSON(jsonValue));
+    }
+
+    /**
+     * Get ad-asset binding
+     */
+    async adAssetsGet(requestParameters: AdAssetsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope> {
+        const response = await this.adAssetsGetRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * List ad / ad-group asset bindings (filter by adId/adGroupId/campaignId)
+     */
+    async adAssetsListRaw(requestParameters: AdAssetsListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>> {
+        const queryParameters: any = {};
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
+
+        if (requestParameters['adId'] != null) {
+            queryParameters['adId'] = requestParameters['adId'];
+        }
+
+        if (requestParameters['adGroupId'] != null) {
+            queryParameters['adGroupId'] = requestParameters['adGroupId'];
+        }
+
+        if (requestParameters['campaignId'] != null) {
+            queryParameters['campaignId'] = requestParameters['campaignId'];
+        }
+
+        if (requestParameters['role'] != null) {
+            queryParameters['role'] = requestParameters['role'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (requestParameters['xSpaceId'] != null) {
+            headerParameters['X-Space-Id'] = String(requestParameters['xSpaceId']);
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiToken", ["ads:read"]);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const response = await this.request({
+            path: `/api/v1/ad-assets`,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SuccessEnvelopeFromJSON(jsonValue));
+    }
+
+    /**
+     * List ad / ad-group asset bindings (filter by adId/adGroupId/campaignId)
+     */
+    async adAssetsList(requestParameters: AdAssetsListRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope> {
+        const response = await this.adAssetsListRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}