@unified-api/typescript-sdk 2.83.42 → 2.83.43

package/src/funcs/adsGetAdsTarget.ts

@@ -0,0 +1,174 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { UnifiedToCore } from "../core.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../sdk/models/errors/httpclienterrors.js";
+import { ResponseValidationError } from "../sdk/models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../sdk/models/errors/sdkvalidationerror.js";
+import { UnifiedToError } from "../sdk/models/errors/unifiedtoerror.js";
+import * as operations from "../sdk/models/operations/index.js";
+import * as shared from "../sdk/models/shared/index.js";
+import { APICall, APIPromise } from "../sdk/types/async.js";
+import { Result } from "../sdk/types/fp.js";
+
+/**
+ * Retrieve a target
+ */
+export function adsGetAdsTarget(
+  client: UnifiedToCore,
+  request: operations.GetAdsTargetRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    shared.AdsTarget,
+    | UnifiedToError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: UnifiedToCore,
+  request: operations.GetAdsTargetRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      shared.AdsTarget,
+      | UnifiedToError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.GetAdsTargetRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    connection_id: encodeSimple("connection_id", payload.connection_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    id: encodeSimple("id", payload.id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/ads/{connection_id}/target/{id}")(pathParams);
+
+  const query = encodeFormQuery({
+    "fields": payload.fields,
+    "raw": payload.raw,
+  });
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const securityInput = await extractSecurity(client._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "getAdsTarget",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.security,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    query: query,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const [result] = await M.match<
+    shared.AdsTarget,
+    | UnifiedToError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, shared.AdsTarget$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/adsListAdsCampaigns.ts

@@ -94,6 +94,7 @@ async function $do(
   const path = pathToFunc("/ads/{connection_id}/campaign")(pathParams);
 
   const query = encodeFormQuery({
+    "end_lt": payload.end_lt,
     "fields": payload.fields,
     "limit": payload.limit,
     "offset": payload.offset,
@@ -102,6 +103,7 @@ async function $do(
     "query": payload.query,
     "raw": payload.raw,
     "sort": payload.sort,
+    "start_gte": payload.start_gte,
     "updated_gte": payload.updated_gte,
   });
 

package/src/funcs/adsListAdsGroups.ts

@@ -95,6 +95,7 @@ async function $do(
 
   const query = encodeFormQuery({
     "campaign_id": payload.campaign_id,
+    "end_lt": payload.end_lt,
     "fields": payload.fields,
     "io_id": payload.io_id,
     "limit": payload.limit,
@@ -105,6 +106,7 @@ async function $do(
     "query": payload.query,
     "raw": payload.raw,
     "sort": payload.sort,
+    "start_gte": payload.start_gte,
     "updated_gte": payload.updated_gte,
   });
 

package/src/lib/config.ts

@@ -73,8 +73,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0",
-  sdkVersion: "2.83.42",
+  sdkVersion: "2.83.43",
   genVersion: "2.881.4",
   userAgent:
-    "speakeasy-sdk/typescript 2.83.42 2.881.4 1.0 @unified-api/typescript-sdk",
+    "speakeasy-sdk/typescript 2.83.43 2.881.4 1.0 @unified-api/typescript-sdk",
 } as const;

package/src/sdk/ads.ts

@@ -12,6 +12,8 @@ import { adsGetAdsCampaign } from "../funcs/adsGetAdsCampaign.js";
 import { adsGetAdsCreative } from "../funcs/adsGetAdsCreative.js";
 import { adsGetAdsGroup } from "../funcs/adsGetAdsGroup.js";
 import { adsGetAdsInsertionorder } from "../funcs/adsGetAdsInsertionorder.js";
+import { adsGetAdsPromoted } from "../funcs/adsGetAdsPromoted.js";
+import { adsGetAdsTarget } from "../funcs/adsGetAdsTarget.js";
 import { adsListAdsAds } from "../funcs/adsListAdsAds.js";
 import { adsListAdsCampaigns } from "../funcs/adsListAdsCampaigns.js";
 import { adsListAdsCreatives } from "../funcs/adsListAdsCreatives.js";
@@ -215,6 +217,34 @@ export class Ads extends ClientSDK {
     ));
   }
 
+  /**
+   * Retrieve a promoted
+   */
+  async getAdsPromoted(
+    request: operations.GetAdsPromotedRequest,
+    options?: RequestOptions,
+  ): Promise<shared.AdsPromoted> {
+    return unwrapAsync(adsGetAdsPromoted(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Retrieve a target
+   */
+  async getAdsTarget(
+    request: operations.GetAdsTargetRequest,
+    options?: RequestOptions,
+  ): Promise<shared.AdsTarget> {
+    return unwrapAsync(adsGetAdsTarget(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * List all ads
    */

package/src/sdk/models/operations/getadspromoted.ts

@@ -0,0 +1,73 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../../lib/primitives.js";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const GetAdsPromotedQueryParamFields = {
+  Id: "id",
+  Name: "name",
+  Type: "type",
+  Raw: "raw",
+} as const;
+export type GetAdsPromotedQueryParamFields = ClosedEnum<
+  typeof GetAdsPromotedQueryParamFields
+>;
+
+export type GetAdsPromotedRequest = {
+  /**
+   * ID of the connection
+   */
+  connectionId: string;
+  /**
+   * Fields to return
+   */
+  fields?: Array<GetAdsPromotedQueryParamFields> | undefined;
+  /**
+   * ID of the Promoted
+   */
+  id: string;
+  /**
+   * Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar
+   */
+  raw?: string | undefined;
+};
+
+/** @internal */
+export const GetAdsPromotedQueryParamFields$outboundSchema: z.ZodNativeEnum<
+  typeof GetAdsPromotedQueryParamFields
+> = z.nativeEnum(GetAdsPromotedQueryParamFields);
+
+/** @internal */
+export type GetAdsPromotedRequest$Outbound = {
+  connection_id: string;
+  fields?: Array<string> | undefined;
+  id: string;
+  raw?: string | undefined;
+};
+
+/** @internal */
+export const GetAdsPromotedRequest$outboundSchema: z.ZodType<
+  GetAdsPromotedRequest$Outbound,
+  z.ZodTypeDef,
+  GetAdsPromotedRequest
+> = z.object({
+  connectionId: z.string(),
+  fields: z.array(GetAdsPromotedQueryParamFields$outboundSchema).optional(),
+  id: z.string(),
+  raw: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    connectionId: "connection_id",
+  });
+});
+
+export function getAdsPromotedRequestToJSON(
+  getAdsPromotedRequest: GetAdsPromotedRequest,
+): string {
+  return JSON.stringify(
+    GetAdsPromotedRequest$outboundSchema.parse(getAdsPromotedRequest),
+  );
+}

package/src/sdk/models/operations/getadstarget.ts

@@ -0,0 +1,75 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../../lib/primitives.js";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const GetAdsTargetQueryParamFields = {
+  Id: "id",
+  Name: "name",
+  Type: "type",
+  IsActive: "is_active",
+  ParentId: "parent_id",
+  Raw: "raw",
+} as const;
+export type GetAdsTargetQueryParamFields = ClosedEnum<
+  typeof GetAdsTargetQueryParamFields
+>;
+
+export type GetAdsTargetRequest = {
+  /**
+   * ID of the connection
+   */
+  connectionId: string;
+  /**
+   * Fields to return
+   */
+  fields?: Array<GetAdsTargetQueryParamFields> | undefined;
+  /**
+   * ID of the Target
+   */
+  id: string;
+  /**
+   * Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar
+   */
+  raw?: string | undefined;
+};
+
+/** @internal */
+export const GetAdsTargetQueryParamFields$outboundSchema: z.ZodNativeEnum<
+  typeof GetAdsTargetQueryParamFields
+> = z.nativeEnum(GetAdsTargetQueryParamFields);
+
+/** @internal */
+export type GetAdsTargetRequest$Outbound = {
+  connection_id: string;
+  fields?: Array<string> | undefined;
+  id: string;
+  raw?: string | undefined;
+};
+
+/** @internal */
+export const GetAdsTargetRequest$outboundSchema: z.ZodType<
+  GetAdsTargetRequest$Outbound,
+  z.ZodTypeDef,
+  GetAdsTargetRequest
+> = z.object({
+  connectionId: z.string(),
+  fields: z.array(GetAdsTargetQueryParamFields$outboundSchema).optional(),
+  id: z.string(),
+  raw: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    connectionId: "connection_id",
+  });
+});
+
+export function getAdsTargetRequestToJSON(
+  getAdsTargetRequest: GetAdsTargetRequest,
+): string {
+  return JSON.stringify(
+    GetAdsTargetRequest$outboundSchema.parse(getAdsTargetRequest),
+  );
+}

package/src/sdk/models/operations/index.ts

@@ -131,6 +131,8 @@ export * from "./getadscreative.js";
 export * from "./getadsgroup.js";
 export * from "./getadsinsertionorder.js";
 export * from "./getadsorganization.js";
+export * from "./getadspromoted.js";
+export * from "./getadstarget.js";
 export * from "./getassessmentpackage.js";
 export * from "./getatsactivity.js";
 export * from "./getatsapplication.js";

package/src/sdk/models/operations/listadscampaigns.ts

@@ -38,6 +38,10 @@ export type ListAdsCampaignsRequest = {
    * ID of the connection
    */
   connectionId: string;
+  /**
+   * The end date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
+   */
+  endLt?: string | undefined;
   /**
    * Fields to return
    */
@@ -58,6 +62,10 @@ export type ListAdsCampaignsRequest = {
    */
   raw?: string | undefined;
   sort?: string | undefined;
+  /**
+   * The start date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
+   */
+  startGte?: string | undefined;
   /**
    * Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    */
@@ -72,6 +80,7 @@ export const ListAdsCampaignsQueryParamFields$outboundSchema: z.ZodNativeEnum<
 /** @internal */
 export type ListAdsCampaignsRequest$Outbound = {
   connection_id: string;
+  end_lt?: string | undefined;
   fields?: Array<string> | undefined;
   limit?: number | undefined;
   offset?: number | undefined;
@@ -80,6 +89,7 @@ export type ListAdsCampaignsRequest$Outbound = {
   query?: string | undefined;
   raw?: string | undefined;
   sort?: string | undefined;
+  start_gte?: string | undefined;
   updated_gte?: string | undefined;
 };
 
@@ -90,6 +100,7 @@ export const ListAdsCampaignsRequest$outboundSchema: z.ZodType<
   ListAdsCampaignsRequest
 > = z.object({
   connectionId: z.string(),
+  endLt: z.string().optional(),
   fields: z.array(ListAdsCampaignsQueryParamFields$outboundSchema).optional(),
   limit: z.number().optional(),
   offset: z.number().optional(),
@@ -98,11 +109,14 @@ export const ListAdsCampaignsRequest$outboundSchema: z.ZodType<
   query: z.string().optional(),
   raw: z.string().optional(),
   sort: z.string().optional(),
+  startGte: z.string().optional(),
   updatedGte: z.string().optional(),
 }).transform((v) => {
   return remap$(v, {
     connectionId: "connection_id",
+    endLt: "end_lt",
     orgId: "org_id",
+    startGte: "start_gte",
     updatedGte: "updated_gte",
   });
 });

package/src/sdk/models/operations/listadsgroups.ts

@@ -50,6 +50,10 @@ export type ListAdsGroupsRequest = {
    * ID of the connection
    */
   connectionId: string;
+  /**
+   * The end date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
+   */
+  endLt?: string | undefined;
   /**
    * Fields to return
    */
@@ -78,6 +82,10 @@ export type ListAdsGroupsRequest = {
    */
   raw?: string | undefined;
   sort?: string | undefined;
+  /**
+   * The start date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
+   */
+  startGte?: string | undefined;
   /**
    * Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    */
@@ -93,6 +101,7 @@ export const ListAdsGroupsQueryParamFields$outboundSchema: z.ZodNativeEnum<
 export type ListAdsGroupsRequest$Outbound = {
   campaign_id?: string | undefined;
   connection_id: string;
+  end_lt?: string | undefined;
   fields?: Array<string> | undefined;
   io_id?: string | undefined;
   limit?: number | undefined;
@@ -103,6 +112,7 @@ export type ListAdsGroupsRequest$Outbound = {
   query?: string | undefined;
   raw?: string | undefined;
   sort?: string | undefined;
+  start_gte?: string | undefined;
   updated_gte?: string | undefined;
 };
 
@@ -114,6 +124,7 @@ export const ListAdsGroupsRequest$outboundSchema: z.ZodType<
 > = z.object({
   campaignId: z.string().optional(),
   connectionId: z.string(),
+  endLt: z.string().optional(),
   fields: z.array(ListAdsGroupsQueryParamFields$outboundSchema).optional(),
   ioId: z.string().optional(),
   limit: z.number().optional(),
@@ -124,14 +135,17 @@ export const ListAdsGroupsRequest$outboundSchema: z.ZodType<
   query: z.string().optional(),
   raw: z.string().optional(),
   sort: z.string().optional(),
+  startGte: z.string().optional(),
   updatedGte: z.string().optional(),
 }).transform((v) => {
   return remap$(v, {
     campaignId: "campaign_id",
     connectionId: "connection_id",
+    endLt: "end_lt",
     ioId: "io_id",
     orgId: "org_id",
     parentId: "parent_id",
+    startGte: "start_gte",
     updatedGte: "updated_gte",
   });
 });

package/src/sdk/models/operations/listadspromoteds.ts

@@ -10,6 +10,7 @@ export const ListAdsPromotedsQueryParamFields = {
   Id: "id",
   Name: "name",
   Type: "type",
+  Raw: "raw",
 } as const;
 export type ListAdsPromotedsQueryParamFields = ClosedEnum<
   typeof ListAdsPromotedsQueryParamFields

package/src/sdk/models/operations/listadstargets.ts

@@ -9,8 +9,9 @@ import { ClosedEnum } from "../../types/enums.js";
 export const ListAdsTargetsQueryParamFields = {
   Id: "id",
   Name: "name",
-  Value: "value",
   Type: "type",
+  IsActive: "is_active",
+  ParentId: "parent_id",
   Raw: "raw",
 } as const;
 export type ListAdsTargetsQueryParamFields = ClosedEnum<

package/src/sdk/models/shared/adspromoted.ts

@@ -34,6 +34,7 @@ export type AdsPromotedType = OpenEnum<typeof AdsPromotedType>;
 export type AdsPromoted = {
   id: string;
   name?: string | undefined;
+  raw?: { [k: string]: any } | undefined;
   type: AdsPromotedType;
 };
 
@@ -58,12 +59,14 @@ export const AdsPromoted$inboundSchema: z.ZodType<
 > = z.object({
   id: z.string(),
   name: z.string().optional(),
+  raw: z.record(z.any()).optional(),
   type: AdsPromotedType$inboundSchema,
 });
 /** @internal */
 export type AdsPromoted$Outbound = {
   id: string;
   name?: string | undefined;
+  raw?: { [k: string]: any } | undefined;
   type: string;
 };
 
@@ -75,6 +78,7 @@ export const AdsPromoted$outboundSchema: z.ZodType<
 > = z.object({
   id: z.string(),
   name: z.string().optional(),
+  raw: z.record(z.any()).optional(),
   type: AdsPromotedType$outboundSchema,
 });
 

package/src/sdk/models/shared/adstarget.ts

@@ -3,6 +3,7 @@
  */
 
 import * as z from "zod/v3";
+import { remap as remap$ } from "../../../lib/primitives.js";
 import { safeParse } from "../../../lib/schemas.js";
 import * as openEnums from "../../types/enums.js";
 import { OpenEnum } from "../../types/enums.js";
@@ -10,18 +11,21 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export const AdsTargetType = {
-  Interests: "INTERESTS",
-  Behaviors: "BEHAVIORS",
-  Locales: "LOCALES",
-  Countries: "COUNTRIES",
-  Regions: "REGIONS",
-  Cities: "CITIES",
-  Zips: "ZIPS",
-  UsDmas: "US_DMAS",
-  Topics: "TOPICS",
-  UserLists: "USER_LISTS",
-  AgeRanges: "AGE_RANGES",
-  Genders: "GENDERS",
+  Interest: "INTEREST",
+  Behavior: "BEHAVIOR",
+  Locale: "LOCALE",
+  Country: "COUNTRY",
+  Region: "REGION",
+  City: "CITY",
+  Zip: "ZIP",
+  UsDma: "US_DMA",
+  Topic: "TOPIC",
+  UserList: "USER_LIST",
+  AgeRange: "AGE_RANGE",
+  Gender: "GENDER",
+  Carrier: "CARRIER",
+  DeviceModel: "DEVICE_MODEL",
+  OsVersion: "OS_VERSION",
 } as const;
 export type AdsTargetType = OpenEnum<typeof AdsTargetType>;
 
@@ -30,10 +34,11 @@ export type AdsTargetType = OpenEnum<typeof AdsTargetType>;
  */
 export type AdsTarget = {
   id: string;
+  isActive?: boolean | undefined;
   name?: string | undefined;
+  parentId?: string | undefined;
   raw?: { [k: string]: any } | undefined;
   type?: AdsTargetType | undefined;
-  value: string;
 };
 
 /** @internal */
@@ -50,10 +55,16 @@ export const AdsTarget$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   id: z.string(),
+  is_active: z.boolean().optional(),
   name: z.string().optional(),
+  parent_id: z.string().optional(),
   raw: z.record(z.any()).optional(),
   type: AdsTargetType$inboundSchema.optional(),
-  value: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "is_active": "isActive",
+    "parent_id": "parentId",
+  });
 });
 
 export function adsTargetFromJSON(