@defoai/ads-client 1.4.0

package/src/generated/runtime.ts

@@ -0,0 +1,431 @@
+/* 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.
+ */
+
+
+export const BASE_PATH = "https://api.ads.defoai.com".replace(/\/+$/, "");
+
+export interface ConfigurationParameters {
+    basePath?: string; // override base path
+    fetchApi?: FetchAPI; // override for fetch implementation
+    middleware?: Middleware[]; // middleware to apply before/after fetch requests
+    queryParamsStringify?: (params: HTTPQuery) => string; // stringify function for query strings
+    username?: string; // parameter for basic security
+    password?: string; // parameter for basic security
+    apiKey?: string | Promise<string> | ((name: string) => string | Promise<string>); // parameter for apiKey security
+    accessToken?: string | Promise<string> | ((name?: string, scopes?: string[]) => string | Promise<string>); // parameter for oauth2 security
+    headers?: HTTPHeaders; //header params we want to use on every request
+    credentials?: RequestCredentials; //value for the credentials param we want to use on each request
+}
+
+export class Configuration {
+    constructor(private configuration: ConfigurationParameters = {}) {}
+
+    set config(configuration: Configuration) {
+        this.configuration = configuration;
+    }
+
+    get basePath(): string {
+        return this.configuration.basePath != null ? this.configuration.basePath : BASE_PATH;
+    }
+
+    get fetchApi(): FetchAPI | undefined {
+        return this.configuration.fetchApi;
+    }
+
+    get middleware(): Middleware[] {
+        return this.configuration.middleware || [];
+    }
+
+    get queryParamsStringify(): (params: HTTPQuery) => string {
+        return this.configuration.queryParamsStringify || querystring;
+    }
+
+    get username(): string | undefined {
+        return this.configuration.username;
+    }
+
+    get password(): string | undefined {
+        return this.configuration.password;
+    }
+
+    get apiKey(): ((name: string) => string | Promise<string>) | undefined {
+        const apiKey = this.configuration.apiKey;
+        if (apiKey) {
+            return typeof apiKey === 'function' ? apiKey : () => apiKey;
+        }
+        return undefined;
+    }
+
+    get accessToken(): ((name?: string, scopes?: string[]) => string | Promise<string>) | undefined {
+        const accessToken = this.configuration.accessToken;
+        if (accessToken) {
+            return typeof accessToken === 'function' ? accessToken : async () => accessToken;
+        }
+        return undefined;
+    }
+
+    get headers(): HTTPHeaders | undefined {
+        return this.configuration.headers;
+    }
+
+    get credentials(): RequestCredentials | undefined {
+        return this.configuration.credentials;
+    }
+}
+
+export const DefaultConfig = new Configuration();
+
+/**
+ * This is the base class for all generated API classes.
+ */
+export class BaseAPI {
+
+    private static readonly jsonRegex = new RegExp('^(:?application\/json|[^;/ \t]+\/[^;/ \t]+[+]json)[ \t]*(:?;.*)?$', 'i');
+    private middleware: Middleware[];
+
+    constructor(protected configuration = DefaultConfig) {
+        this.middleware = configuration.middleware;
+    }
+
+    withMiddleware<T extends BaseAPI>(this: T, ...middlewares: Middleware[]) {
+        const next = this.clone<T>();
+        next.middleware = next.middleware.concat(...middlewares);
+        return next;
+    }
+
+    withPreMiddleware<T extends BaseAPI>(this: T, ...preMiddlewares: Array<Middleware['pre']>) {
+        const middlewares = preMiddlewares.map((pre) => ({ pre }));
+        return this.withMiddleware<T>(...middlewares);
+    }
+
+    withPostMiddleware<T extends BaseAPI>(this: T, ...postMiddlewares: Array<Middleware['post']>) {
+        const middlewares = postMiddlewares.map((post) => ({ post }));
+        return this.withMiddleware<T>(...middlewares);
+    }
+
+    /**
+     * Check if the given MIME is a JSON MIME.
+     * JSON MIME examples:
+     *   application/json
+     *   application/json; charset=UTF8
+     *   APPLICATION/JSON
+     *   application/vnd.company+json
+     * @param mime - MIME (Multipurpose Internet Mail Extensions)
+     * @return True if the given MIME is JSON, false otherwise.
+     */
+    protected isJsonMime(mime: string | null | undefined): boolean {
+        if (!mime) {
+            return false;
+        }
+        return BaseAPI.jsonRegex.test(mime);
+    }
+
+    protected async request(context: RequestOpts, initOverrides?: RequestInit | InitOverrideFunction): Promise<Response> {
+        const { url, init } = await this.createFetchParams(context, initOverrides);
+        const response = await this.fetchApi(url, init);
+        if (response && (response.status >= 200 && response.status < 300)) {
+            return response;
+        }
+        throw new ResponseError(response, 'Response returned an error code');
+    }
+
+    private async createFetchParams(context: RequestOpts, initOverrides?: RequestInit | InitOverrideFunction) {
+        let url = this.configuration.basePath + context.path;
+        if (context.query !== undefined && Object.keys(context.query).length !== 0) {
+            // only add the querystring to the URL if there are query parameters.
+            // this is done to avoid urls ending with a "?" character which buggy webservers
+            // do not handle correctly sometimes.
+            url += '?' + this.configuration.queryParamsStringify(context.query);
+        }
+
+        const headers = Object.assign({}, this.configuration.headers, context.headers);
+        Object.keys(headers).forEach(key => headers[key] === undefined ? delete headers[key] : {});
+
+        const initOverrideFn =
+            typeof initOverrides === "function"
+                ? initOverrides
+                : async () => initOverrides;
+
+        const initParams = {
+            method: context.method,
+            headers,
+            body: context.body,
+            credentials: this.configuration.credentials,
+        };
+
+        const overriddenInit: RequestInit = {
+            ...initParams,
+            ...(await initOverrideFn({
+                init: initParams,
+                context,
+            }))
+        };
+
+        let body: any;
+        if (isFormData(overriddenInit.body)
+            || (overriddenInit.body instanceof URLSearchParams)
+            || isBlob(overriddenInit.body)) {
+          body = overriddenInit.body;
+        } else if (this.isJsonMime(headers['Content-Type'])) {
+          body = JSON.stringify(overriddenInit.body);
+        } else {
+          body = overriddenInit.body;
+        }
+
+        const init: RequestInit = {
+            ...overriddenInit,
+            body
+        };
+
+        return { url, init };
+    }
+
+    private fetchApi = async (url: string, init: RequestInit) => {
+        let fetchParams = { url, init };
+        for (const middleware of this.middleware) {
+            if (middleware.pre) {
+                fetchParams = await middleware.pre({
+                    fetch: this.fetchApi,
+                    ...fetchParams,
+                }) || fetchParams;
+            }
+        }
+        let response: Response | undefined = undefined;
+        try {
+            response = await (this.configuration.fetchApi || fetch)(fetchParams.url, fetchParams.init);
+        } catch (e) {
+            for (const middleware of this.middleware) {
+                if (middleware.onError) {
+                    response = await middleware.onError({
+                        fetch: this.fetchApi,
+                        url: fetchParams.url,
+                        init: fetchParams.init,
+                        error: e,
+                        response: response ? response.clone() : undefined,
+                    }) || response;
+                }
+            }
+            if (response === undefined) {
+              if (e instanceof Error) {
+                throw new FetchError(e, 'The request failed and the interceptors did not return an alternative response');
+              } else {
+                throw e;
+              }
+            }
+        }
+        for (const middleware of this.middleware) {
+            if (middleware.post) {
+                response = await middleware.post({
+                    fetch: this.fetchApi,
+                    url: fetchParams.url,
+                    init: fetchParams.init,
+                    response: response.clone(),
+                }) || response;
+            }
+        }
+        return response;
+    }
+
+    /**
+     * Create a shallow clone of `this` by constructing a new instance
+     * and then shallow cloning data members.
+     */
+    private clone<T extends BaseAPI>(this: T): T {
+        const constructor = this.constructor as any;
+        const next = new constructor(this.configuration);
+        next.middleware = this.middleware.slice();
+        return next;
+    }
+};
+
+function isBlob(value: any): value is Blob {
+    return typeof Blob !== 'undefined' && value instanceof Blob;
+}
+
+function isFormData(value: any): value is FormData {
+    return typeof FormData !== "undefined" && value instanceof FormData;
+}
+
+export class ResponseError extends Error {
+    override name: "ResponseError" = "ResponseError";
+    constructor(public response: Response, msg?: string) {
+        super(msg);
+    }
+}
+
+export class FetchError extends Error {
+    override name: "FetchError" = "FetchError";
+    constructor(public cause: Error, msg?: string) {
+        super(msg);
+    }
+}
+
+export class RequiredError extends Error {
+    override name: "RequiredError" = "RequiredError";
+    constructor(public field: string, msg?: string) {
+        super(msg);
+    }
+}
+
+export const COLLECTION_FORMATS = {
+    csv: ",",
+    ssv: " ",
+    tsv: "\t",
+    pipes: "|",
+};
+
+export type FetchAPI = WindowOrWorkerGlobalScope['fetch'];
+
+export type Json = any;
+export type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
+export type HTTPHeaders = { [key: string]: string };
+export type HTTPQuery = { [key: string]: string | number | null | boolean | Array<string | number | null | boolean> | Set<string | number | null | boolean> | HTTPQuery };
+export type HTTPBody = Json | FormData | URLSearchParams;
+export type HTTPRequestInit = { headers?: HTTPHeaders; method: HTTPMethod; credentials?: RequestCredentials; body?: HTTPBody };
+export type ModelPropertyNaming = 'camelCase' | 'snake_case' | 'PascalCase' | 'original';
+
+export type InitOverrideFunction = (requestContext: { init: HTTPRequestInit, context: RequestOpts }) => Promise<RequestInit>
+
+export interface FetchParams {
+    url: string;
+    init: RequestInit;
+}
+
+export interface RequestOpts {
+    path: string;
+    method: HTTPMethod;
+    headers: HTTPHeaders;
+    query?: HTTPQuery;
+    body?: HTTPBody;
+}
+
+export function querystring(params: HTTPQuery, prefix: string = ''): string {
+    return Object.keys(params)
+        .map(key => querystringSingleKey(key, params[key], prefix))
+        .filter(part => part.length > 0)
+        .join('&');
+}
+
+function querystringSingleKey(key: string, value: string | number | null | undefined | boolean | Array<string | number | null | boolean> | Set<string | number | null | boolean> | HTTPQuery, keyPrefix: string = ''): string {
+    const fullKey = keyPrefix + (keyPrefix.length ? `[${key}]` : key);
+    if (value instanceof Array) {
+        const multiValue = value.map(singleValue => encodeURIComponent(String(singleValue)))
+            .join(`&${encodeURIComponent(fullKey)}=`);
+        return `${encodeURIComponent(fullKey)}=${multiValue}`;
+    }
+    if (value instanceof Set) {
+        const valueAsArray = Array.from(value);
+        return querystringSingleKey(key, valueAsArray, keyPrefix);
+    }
+    if (value instanceof Date) {
+        return `${encodeURIComponent(fullKey)}=${encodeURIComponent(value.toISOString())}`;
+    }
+    if (value instanceof Object) {
+        return querystring(value as HTTPQuery, fullKey);
+    }
+    return `${encodeURIComponent(fullKey)}=${encodeURIComponent(String(value))}`;
+}
+
+export function exists(json: any, key: string) {
+    const value = json[key];
+    return value !== null && value !== undefined;
+}
+
+export function mapValues(data: any, fn: (item: any) => any) {
+  return Object.keys(data).reduce(
+    (acc, key) => ({ ...acc, [key]: fn(data[key]) }),
+    {}
+  );
+}
+
+export function canConsumeForm(consumes: Consume[]): boolean {
+    for (const consume of consumes) {
+        if ('multipart/form-data' === consume.contentType) {
+            return true;
+        }
+    }
+    return false;
+}
+
+export interface Consume {
+    contentType: string;
+}
+
+export interface RequestContext {
+    fetch: FetchAPI;
+    url: string;
+    init: RequestInit;
+}
+
+export interface ResponseContext {
+    fetch: FetchAPI;
+    url: string;
+    init: RequestInit;
+    response: Response;
+}
+
+export interface ErrorContext {
+    fetch: FetchAPI;
+    url: string;
+    init: RequestInit;
+    error: unknown;
+    response?: Response;
+}
+
+export interface Middleware {
+    pre?(context: RequestContext): Promise<FetchParams | void>;
+    post?(context: ResponseContext): Promise<Response | void>;
+    onError?(context: ErrorContext): Promise<Response | void>;
+}
+
+export interface ApiResponse<T> {
+    raw: Response;
+    value(): Promise<T>;
+}
+
+export interface ResponseTransformer<T> {
+    (json: any): T;
+}
+
+export class JSONApiResponse<T> {
+    constructor(public raw: Response, private transformer: ResponseTransformer<T> = (jsonValue: any) => jsonValue) {}
+
+    async value(): Promise<T> {
+        return this.transformer(await this.raw.json());
+    }
+}
+
+export class VoidApiResponse {
+    constructor(public raw: Response) {}
+
+    async value(): Promise<void> {
+        return undefined;
+    }
+}
+
+export class BlobApiResponse {
+    constructor(public raw: Response) {}
+
+    async value(): Promise<Blob> {
+        return await this.raw.blob();
+    };
+}
+
+export class TextApiResponse {
+    constructor(public raw: Response) {}
+
+    async value(): Promise<string> {
+        return await this.raw.text();
+    };
+}

package/src/index.ts

@@ -0,0 +1,229 @@
+// 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,
+    type Middleware,
+    type CampaignCreate, type CampaignUpdate,
+    type AdGroupCreate, type AdGroupUpdate,
+    type AdCreate, type AdUpdate,
+    type KeywordCreate, type KeywordUpdate,
+    type SiteCreate, type SiteUpdate,
+    type AssetCreate, type AssetUpdate,
+    type CampaignAssetCreate, type AdAssetCreate,
+    type SyncTriggerRequest, type SyncUnlinkRequest,
+} 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';
+
+export interface DefoAdsOptions {
+    /** A Defo Ads personal access token (`dads_…`). Required. */
+    token: string;
+    /** Default Space id (`spc_…`) sent as `X-Space-Id` on every call. Omit to use your Personal Space. */
+    space?: string;
+    /** Base URL. Defaults to production. Use {@link STAGING_BASE_URL} for staging. */
+    baseUrl?: string;
+    /** Max automatic retries on 429 / 5xx. Default 3. */
+    maxRetries?: number;
+    /** Inject a fetch implementation (handy for tests / non-global-fetch runtimes). */
+    fetch?: typeof fetch;
+}
+
+// ---- Typed errors -------------------------------------------------------------
+/** Base error for any non-2xx response; carries the API's `{ code, message, details }`. */
+export class DefoAdsError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly details?: unknown;
+    constructor(status: number, code: string | undefined, message: string, details?: unknown) {
+        super(message);
+        this.name = 'DefoAdsError';
+        this.status = status;
+        this.code = code;
+        this.details = details;
+    }
+}
+/** 401 — missing/invalid token. */ export class AuthError extends DefoAdsError { override name = 'AuthError'; }
+/** 403 — token lacks the required scope or Space membership. */ export class ForbiddenError extends DefoAdsError { override name = 'ForbiddenError'; }
+/** 404 — resource not found (or outside your Space). */ export class NotFoundError extends DefoAdsError { override name = 'NotFoundError'; }
+/** 409 — conflict (e.g. delete blocked by dependents, or a sync already running). */ export class ConflictError extends DefoAdsError { override name = 'ConflictError'; }
+/** 429 — rate limited. The SDK already retried up to `maxRetries`. */ export class RateLimitError extends DefoAdsError { override name = 'RateLimitError'; }
+
+function toTypedError(status: number, code: string | undefined, message: string, details?: unknown): DefoAdsError {
+    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: typeof fetch, maxRetries: number): typeof fetch {
+    return async (input: any, init?: any): Promise<Response> => {
+        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: Middleware = {
+    post: async ({ response }) => {
+        if (response.status >= 400) {
+            let code: string | undefined;
+            let message = response.statusText;
+            let details: unknown;
+            try {
+                const body: any = 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: any) => env?.data;
+
+interface ListParams { limit?: number; cursor?: string | number }
+
+function crudResource<C, U>(api: any, prefix: string, createKey: string, updateKey: string) {
+    return {
+        /** List one page (default 50, max 200). */
+        list: (params: ListParams = {}): Promise<any[]> => api[`${prefix}List`]({ ...params }).then(data),
+        /** Async-iterate EVERY item across all pages (follows `meta.nextCursor`). */
+        async *listAll(params: ListParams = {}): AsyncGenerator<any> {
+            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: string): Promise<any> => api[`${prefix}Get`]({ id }).then(data),
+        /** Create. */
+        create: (body: C): Promise<any> => api[`${prefix}Create`]({ [createKey]: body }).then(data),
+        /** Partial update by id. */
+        update: (id: string, body: U): Promise<any> => api[`${prefix}Update`]({ id, [updateKey]: body }).then(data),
+        /** Delete by id. */
+        delete: (id: string): Promise<any> => api[`${prefix}Delete`]({ id }).then(data),
+    };
+}
+
+/** The Defo Ads client. Construct once, reuse everywhere. */
+export class DefoAds {
+    readonly campaigns; readonly adGroups; readonly ads; readonly keywords;
+    readonly sites; readonly assets; readonly campaignAssets; readonly adAssets;
+    readonly media; readonly reports; readonly sync; readonly meta;
+
+    constructor(options: DefoAdsOptions) {
+        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<CampaignCreate, CampaignUpdate>(new CampaignsApi(config), 'campaigns', 'campaignCreate', 'campaignUpdate');
+        this.adGroups = crudResource<AdGroupCreate, AdGroupUpdate>(new AdGroupsApi(config), 'adGroups', 'adGroupCreate', 'adGroupUpdate');
+        this.ads = crudResource<AdCreate, AdUpdate>(new AdsApi(config), 'ads', 'adCreate', 'adUpdate');
+        this.keywords = crudResource<KeywordCreate, KeywordUpdate>(new KeywordsApi(config), 'keywords', 'keywordCreate', 'keywordUpdate');
+        this.sites = crudResource<SiteCreate, SiteUpdate>(new SitesApi(config), 'sites', 'siteCreate', 'siteUpdate');
+        this.assets = crudResource<AssetCreate, AssetUpdate>(new AssetsApi(config), 'assets', 'assetCreate', 'assetUpdate');
+
+        // Binding-only resources (no full CRUD).
+        const campaignAssetsApi = new CampaignAssetsApi(config);
+        this.campaignAssets = {
+            list: (p: ListParams & { campaignId?: string; assetId?: string } = {}) => campaignAssetsApi.campaignAssetsList(p as any).then(data),
+            get: (id: string) => campaignAssetsApi.campaignAssetsGet({ id }).then(data),
+            create: (body: CampaignAssetCreate) => campaignAssetsApi.campaignAssetsCreate({ campaignAssetCreate: body }).then(data),
+            delete: (id: string) => campaignAssetsApi.campaignAssetsDelete({ id }).then(data),
+        };
+        const adAssetsApi = new AdAssetsApi(config);
+        this.adAssets = {
+            list: (p: ListParams & { adId?: string; adGroupId?: string; campaignId?: string; role?: string } = {}) => adAssetsApi.adAssetsList(p as any).then(data),
+            get: (id: string) => adAssetsApi.adAssetsGet({ id }).then(data),
+            create: (body: AdAssetCreate) => adAssetsApi.adAssetsCreate({ adAssetCreate: body }).then(data),
+            delete: (id: string) => 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: Record<string, any> = {}) => reportsApi.reportsStats(params as any).then(data),
+        };
+
+        const syncApi = new SyncApi(config);
+        this.sync = {
+            /** Trigger a sync for the active Space (async — poll `get(syncId)`). */
+            trigger: (body: SyncTriggerRequest = {}) => syncApi.syncTrigger({ syncTriggerRequest: body }).then(data),
+            list: (p: ListParams = {}) => syncApi.syncList(p).then(data),
+            /** Dry-run plan (import/export/remove) without executing. */
+            plan: (p: { platforms?: string } = {}) => syncApi.syncPlan(p as any).then(data),
+            get: (id: string) => syncApi.syncGet({ id }).then(data),
+            cancel: (id: string) => syncApi.syncCancel({ id }).then(data),
+            /** Unlink campaigns from a platform (keeps the local campaign). */
+            unlink: (body: SyncUnlinkRequest) => 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;