import {z} from 'zod' export type GettyImagesServicesConnectPublicControllersSearchModelCollectionsFilterType = 'include' | 'exclude'; export type GettyImagesServicesConnectPublicControllersSearchFacetsCreateImageSearchFacetsFields = 'artists' | 'locations'; export type GettyImagesServicesConnectPublicControllersSearchModelCreativeImagesFieldValues = 'allowed_use' | 'alternative_ids' | 'artist' | 'asset_family' | 'call_for_image' | 'caption' | 'collection_code' | 'collection_id' | 'collection_name' | 'color_type' | 'comp' | 'comp_webp' | 'copyright' | 'date_camera_shot' | 'date_created' | 'date_submitted' | 'display_set' | 'download_product' | 'download_sizes' | 'graphical_style' | 'id' | 'istock_collection' | 'istock_exclusive' | 'keywords' | 'largest_downloads' | 'license_model' | 'max_dimensions' | 'orientation' | 'preview' | 'product_types' | 'quality_rank' | 'referral_destinations' | 'summary_set' | 'thumb' | 'title' | 'uri_oembed'; export type GetApiV3SearchImagesCreativeByImageArgs = {'Accept-Language'?: string | undefined, 'GI-Country-Code'?: string | undefined, asset_id?: string | undefined, collection_codes?: Array | undefined, collections_filter_type?: GettyImagesServicesConnectPublicControllersSearchModelCollectionsFilterType | undefined, exclude_editorial_use_only?: boolean | undefined, facet_fields?: Array | undefined, facet_max_count?: number | undefined, fields?: Array | undefined, image_url?: string | undefined, include_facets?: boolean | undefined, istock_exclusive?: boolean | undefined, page?: number | undefined, page_size?: number | undefined, phrase?: string | undefined, product_types?: Array | undefined}; export type GetApiV3SearchImagesCreativeByImageOptions = {baseUrl: string, ApiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const gettyImagesServicesConnectPublicDomainServicesAssetRelatedSearch = z.object({phrase: z.string().nullable().optional(), url: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsAllowedUse = z.object({how_can_i_use_it: z.string().nullable().optional(), release_info: z.string().nullable().optional(), usage_restrictions: z.array(z.string()).nullable().optional(), editorial_use_only: z.boolean().optional()}); export const gettyImagesServicesConnectPublicModelsContributor = z.object({member_name: z.string().nullable().optional(), display_name: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsSearchImageSearchItemDisplaySize = z.object({is_watermarked: z.boolean().optional(), name: z.string().nullable().optional(), uri: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsImagesImageDownloadAuthorization = z.object({product_id: z.string().nullable().optional(), product_type: z.string().nullable().optional(), uri: z.string().nullable().optional(), agreement_name: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsTeeShirtSize = z.enum(["x_small", "small", "medium", "large", "x_large", "xx_large", "vector"]); export const gettyImagesServicesConnectPublicModelsImagesImageDownloadSize = z.object({bytes: z.number().int().optional(), downloads: z.array(gettyImagesServicesConnectPublicModelsImagesImageDownloadAuthorization).nullable().optional(), height: z.number().int().optional(), media_type: z.string().nullable().optional(), name: gettyImagesServicesConnectPublicModelsTeeShirtSize.optional(), width: z.number().int().optional(), dpi: z.number().int().optional()}); export const gettyImagesServicesConnectPublicModelsKeyword = z.object({keyword_id: z.string().nullable().optional(), text: z.string().nullable().optional(), type: z.string().nullable().optional(), relevance: z.number().int().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsDownload = z.object({product_id: z.string().nullable().optional(), product_type: z.string().nullable().optional(), uri: z.string().nullable().optional(), agreement_name: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsMaxDimensions = z.object({height: z.number().int().optional(), width: z.number().int().optional()}); export const gettyImagesServicesConnectPublicModelsReferralDestination = z.object({site_name: z.string().nullable().optional(), uri: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsTerritoryRestriction = z.object({country_code: z.string().nullable().optional(), type: z.string().nullable().optional(), description: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsSearchNewModelsCreativeImage = z.object({istock_collection: z.string().nullable().optional(), istock_exclusive: z.boolean().nullable().optional(), allowed_use: gettyImagesServicesConnectPublicModelsAllowedUse.optional(), alternative_ids: z.record(z.string(), z.string().nullable()).nullable().optional(), artist: z.string().nullable().optional(), asset_family: z.string().nullable().optional(), asset_type: z.string().nullable().optional(), call_for_image: z.boolean().nullable().optional(), caption: z.string().nullable().optional(), collection_code: z.string().nullable().optional(), collection_id: z.number().int().nullable().optional(), collection_name: z.string().nullable().optional(), color_type: z.string().nullable().optional(), contributor: gettyImagesServicesConnectPublicModelsContributor.optional(), copyright: z.string().nullable().optional(), date_camera_shot: z.string().nullable().optional(), date_created: z.string().nullable().optional(), display_sizes: z.array(gettyImagesServicesConnectPublicModelsSearchImageSearchItemDisplaySize).nullable().optional(), download_product: z.string().nullable().optional(), download_sizes: z.array(gettyImagesServicesConnectPublicModelsImagesImageDownloadSize).nullable().optional(), graphical_style: z.string().nullable().optional(), id: z.string().nullable().optional(), keywords: z.array(gettyImagesServicesConnectPublicModelsKeyword).nullable().optional(), largest_downloads: z.array(gettyImagesServicesConnectPublicModelsDownload).nullable().optional(), license_model: z.string().nullable().optional(), max_dimensions: gettyImagesServicesConnectPublicModelsMaxDimensions.optional(), orientation: z.string().nullable().optional(), product_types: z.array(z.string()).nullable().optional(), quality_rank: z.number().int().nullable().optional(), referral_destinations: z.array(gettyImagesServicesConnectPublicModelsReferralDestination).nullable().optional(), territory_restrictions: z.array(gettyImagesServicesConnectPublicModelsTerritoryRestriction).nullable().optional(), title: z.string().nullable().optional(), uri_oembed: z.string().nullable().optional(), date_submitted: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicControllersSearchFacetsSpecificPeople = z.object({id: z.number().int().optional(), name: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicControllersSearchFacetsFacetEvent = z.object({id: z.number().int().optional(), name: z.string().nullable().optional(), date: z.string().optional()}); export const gettyImagesServicesConnectPublicControllersSearchFacetsLocation = z.object({id: z.number().int().optional(), name: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicControllersSearchFacetsArtist = z.object({name: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicControllersSearchFacetsEntertainment = z.object({id: z.number().int().optional(), name: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicControllersSearchFacetsSearchFacetsResponse = z.object({specific_people: z.array(gettyImagesServicesConnectPublicControllersSearchFacetsSpecificPeople).nullable().optional(), events: z.array(gettyImagesServicesConnectPublicControllersSearchFacetsFacetEvent).nullable().optional(), locations: z.array(gettyImagesServicesConnectPublicControllersSearchFacetsLocation).nullable().optional(), artists: z.array(gettyImagesServicesConnectPublicControllersSearchFacetsArtist).nullable().optional(), entertainment: z.array(gettyImagesServicesConnectPublicControllersSearchFacetsEntertainment).nullable().optional()}); export const gettyImagesServicesConnectPublicModelsSearchAutoCorrections = z.object({phrase: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsSearchSearchByImageResourceResults = z.object({image_fingerprint: z.string().nullable().optional(), related_searches: z.array(gettyImagesServicesConnectPublicDomainServicesAssetRelatedSearch).nullable().optional(), result_count: z.number().int().optional(), images: z.array(gettyImagesServicesConnectPublicModelsSearchNewModelsCreativeImage).nullable().optional(), facets: gettyImagesServicesConnectPublicControllersSearchFacetsSearchFacetsResponse.optional(), auto_corrections: gettyImagesServicesConnectPublicModelsSearchAutoCorrections.optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Search for creative images based on url * * GET /v3/search/images/creative/by-image * * Also accepts auth: OAuth2 */ export const getApiV3SearchImagesCreativeByImage = async (args: GetApiV3SearchImagesCreativeByImageArgs, options: GetApiV3SearchImagesCreativeByImageOptions) => { const {baseUrl, fetch: fetchFn = fetch, ApiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args['Accept-Language'] != null) headers.set("Accept-Language", String(args['Accept-Language'])) if (args['GI-Country-Code'] != null) headers.set("GI-Country-Code", String(args['GI-Country-Code'])) if (args.asset_id != null) query.append("asset_id", String(args.asset_id)) if (args.collection_codes != null) query.append("collection_codes", args.collection_codes.join(',')) if (args.collections_filter_type != null) query.append("collections_filter_type", String(args.collections_filter_type)) if (args.exclude_editorial_use_only != null) query.append("exclude_editorial_use_only", String(args.exclude_editorial_use_only)) if (args.facet_fields != null) query.append("facet_fields", args.facet_fields.join(',')) if (args.facet_max_count != null) query.append("facet_max_count", String(args.facet_max_count)) if (args.fields != null) query.append("fields", args.fields.join(',')) if (args.image_url != null) query.append("image_url", String(args.image_url)) if (args.include_facets != null) query.append("include_facets", String(args.include_facets)) if (args.istock_exclusive != null) query.append("istock_exclusive", String(args.istock_exclusive)) if (args.page != null) query.append("page", String(args.page)) if (args.page_size != null) query.append("page_size", String(args.page_size)) if (args.phrase != null) query.append("phrase", String(args.phrase)) if (args.product_types != null) query.append("product_types", args.product_types.join(',')) if (ApiKey !== undefined) headers.set("Api-Key", ApiKey) const url = `${baseUrl.replace(/\/+$/, '')}/v3/search/images/creative/by-image${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(gettyImagesServicesConnectPublicModelsSearchSearchByImageResourceResults, await res.json()) };