@postpeer/node 0.6.0 → 0.8.0

package/dist/index.d.cts

@@ -0,0 +1,3484 @@
+type AuthToken = string | undefined;
+interface Auth {
+    /**
+     * Which part of the request do we use to send the auth?
+     *
+     * @default 'header'
+     */
+    in?: 'header' | 'query' | 'cookie';
+    /**
+     * A unique identifier for the security scheme.
+     *
+     * Defined only when there are multiple security schemes whose `Auth`
+     * shape would otherwise be identical.
+     */
+    key?: string;
+    /**
+     * Header or query parameter name.
+     *
+     * @default 'Authorization'
+     */
+    name?: string;
+    scheme?: 'basic' | 'bearer';
+    type: 'apiKey' | 'http';
+}
+
+interface SerializerOptions<T> {
+    /**
+     * @default true
+     */
+    explode: boolean;
+    style: T;
+}
+type ArrayStyle = 'form' | 'spaceDelimited' | 'pipeDelimited';
+type ObjectStyle = 'form' | 'deepObject';
+
+type QuerySerializer = (query: Record<string, unknown>) => string;
+type BodySerializer = (body: unknown) => unknown;
+type QuerySerializerOptionsObject = {
+    allowReserved?: boolean;
+    array?: Partial<SerializerOptions<ArrayStyle>>;
+    object?: Partial<SerializerOptions<ObjectStyle>>;
+};
+type QuerySerializerOptions = QuerySerializerOptionsObject & {
+    /**
+     * Per-parameter serialization overrides. When provided, these settings
+     * override the global array/object settings for specific parameter names.
+     */
+    parameters?: Record<string, QuerySerializerOptionsObject>;
+};
+
+type HttpMethod = 'connect' | 'delete' | 'get' | 'head' | 'options' | 'patch' | 'post' | 'put' | 'trace';
+type Client$1<RequestFn = never, Config = unknown, MethodFn = never, BuildUrlFn = never, SseFn = never> = {
+    /**
+     * Returns the final request URL.
+     */
+    buildUrl: BuildUrlFn;
+    getConfig: () => Config;
+    request: RequestFn;
+    setConfig: (config: Config) => Config;
+} & {
+    [K in HttpMethod]: MethodFn;
+} & ([SseFn] extends [never] ? {
+    sse?: never;
+} : {
+    sse: {
+        [K in HttpMethod]: SseFn;
+    };
+});
+interface Config$1 {
+    /**
+     * Auth token or a function returning auth token. The resolved value will be
+     * added to the request payload as defined by its `security` array.
+     */
+    auth?: ((auth: Auth) => Promise<AuthToken> | AuthToken) | AuthToken;
+    /**
+     * A function for serializing request body parameter. By default,
+     * {@link JSON.stringify()} will be used.
+     */
+    bodySerializer?: BodySerializer | null;
+    /**
+     * An object containing any HTTP headers that you want to pre-populate your
+     * `Headers` object with.
+     *
+     * {@link https://developer.mozilla.org/docs/Web/API/Headers/Headers#init See more}
+     */
+    headers?: RequestInit['headers'] | Record<string, string | number | boolean | (string | number | boolean)[] | null | undefined | unknown>;
+    /**
+     * The request method.
+     *
+     * {@link https://developer.mozilla.org/docs/Web/API/fetch#method See more}
+     */
+    method?: Uppercase<HttpMethod>;
+    /**
+     * A function for serializing request query parameters. By default, arrays
+     * will be exploded in form style, objects will be exploded in deepObject
+     * style, and reserved characters are percent-encoded.
+     *
+     * This method will have no effect if the native `paramsSerializer()` Axios
+     * API function is used.
+     *
+     * {@link https://swagger.io/docs/specification/serialization/#query View examples}
+     */
+    querySerializer?: QuerySerializer | QuerySerializerOptions;
+    /**
+     * A function validating request data. This is useful if you want to ensure
+     * the request conforms to the desired shape, so it can be safely sent to
+     * the server.
+     */
+    requestValidator?: (data: unknown) => Promise<unknown>;
+    /**
+     * A function transforming response data before it's returned. This is useful
+     * for post-processing data, e.g., converting ISO strings into Date objects.
+     */
+    responseTransformer?: (data: unknown) => Promise<unknown>;
+    /**
+     * A function validating response data. This is useful if you want to ensure
+     * the response conforms to the desired shape, so it can be safely passed to
+     * the transformers and returned to the user.
+     */
+    responseValidator?: (data: unknown) => Promise<unknown>;
+}
+/**
+ * Arbitrary metadata passed through the `meta` request option.
+ */
+interface ClientMeta {
+}
+
+type ServerSentEventsOptions<TData = unknown> = Omit<RequestInit, 'method'> & Pick<Config$1, 'method' | 'responseTransformer' | 'responseValidator'> & {
+    /**
+     * Fetch API implementation. You can use this option to provide a custom
+     * fetch instance.
+     *
+     * @default globalThis.fetch
+     */
+    fetch?: typeof fetch;
+    /**
+     * Implementing clients can call request interceptors inside this hook.
+     */
+    onRequest?: (url: string, init: RequestInit) => Promise<Request>;
+    /**
+     * Callback invoked when a network or parsing error occurs during streaming.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @param error The error that occurred.
+     */
+    onSseError?: (error: unknown) => void;
+    /**
+     * Callback invoked when an event is streamed from the server.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @param event Event streamed from the server.
+     * @returns Nothing (void).
+     */
+    onSseEvent?: (event: StreamEvent<TData>) => void;
+    serializedBody?: RequestInit['body'];
+    /**
+     * Default retry delay in milliseconds.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @default 3000
+     */
+    sseDefaultRetryDelay?: number;
+    /**
+     * Maximum number of retry attempts before giving up.
+     */
+    sseMaxRetryAttempts?: number;
+    /**
+     * Maximum retry delay in milliseconds.
+     *
+     * Applies only when exponential backoff is used.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @default 30000
+     */
+    sseMaxRetryDelay?: number;
+    /**
+     * Optional sleep function for retry backoff.
+     *
+     * Defaults to using `setTimeout`.
+     */
+    sseSleepFn?: (ms: number) => Promise<void>;
+    url: string;
+};
+interface StreamEvent<TData = unknown> {
+    data: TData;
+    event?: string;
+    id?: string;
+    retry?: number;
+}
+type ServerSentEventsResult<TData = unknown, TReturn = void, TNext = unknown> = {
+    stream: AsyncGenerator<TData extends Record<string, unknown> ? TData[keyof TData] : TData, TReturn, TNext>;
+};
+
+type ErrInterceptor<Err, Res, Req, Options> = (error: Err, 
+/** response may be undefined due to a network error where no response object is produced */
+response: Res | undefined, 
+/** request may be undefined, because error may be from building the request object itself */
+request: Req | undefined, options: Options) => Err | Promise<Err>;
+type ReqInterceptor<Req, Options> = (request: Req, options: Options) => Req | Promise<Req>;
+type ResInterceptor<Res, Req, Options> = (response: Res, request: Req, options: Options) => Res | Promise<Res>;
+declare class Interceptors<Interceptor> {
+    fns: Array<Interceptor | null>;
+    clear(): void;
+    eject(id: number | Interceptor): void;
+    exists(id: number | Interceptor): boolean;
+    getInterceptorIndex(id: number | Interceptor): number;
+    update(id: number | Interceptor, fn: Interceptor): number | Interceptor | false;
+    use(fn: Interceptor): number;
+}
+interface Middleware<Req, Res, Err, Options> {
+    error: Interceptors<ErrInterceptor<Err, Res, Req, Options>>;
+    request: Interceptors<ReqInterceptor<Req, Options>>;
+    response: Interceptors<ResInterceptor<Res, Req, Options>>;
+}
+
+type ResponseStyle = 'data' | 'fields';
+interface Config<T extends ClientOptions$1 = ClientOptions$1> extends Omit<RequestInit, 'body' | 'headers' | 'method'>, Config$1 {
+    /**
+     * Base URL for all requests made by this client.
+     */
+    baseUrl?: T['baseUrl'];
+    /**
+     * Fetch API implementation. You can use this option to provide a custom
+     * fetch instance.
+     *
+     * @default globalThis.fetch
+     */
+    fetch?: typeof fetch;
+    /**
+     * Please don't use the Fetch client for Next.js applications. The `next`
+     * options won't have any effect.
+     *
+     * Install {@link https://www.npmjs.com/package/@hey-api/client-next `@hey-api/client-next`} instead.
+     */
+    next?: never;
+    /**
+     * Return the response data parsed in a specified format. By default, `auto`
+     * will infer the appropriate method from the `Content-Type` response header.
+     * You can override this behavior with any of the {@link Body} methods.
+     * Select `stream` if you don't want to parse response data at all.
+     *
+     * @default 'auto'
+     */
+    parseAs?: 'arrayBuffer' | 'auto' | 'blob' | 'formData' | 'json' | 'stream' | 'text';
+    /**
+     * Should we return only data or multiple fields (data, error, response, etc.)?
+     *
+     * @default 'fields'
+     */
+    responseStyle?: ResponseStyle;
+    /**
+     * Throw an error instead of returning it in the response?
+     *
+     * @default false
+     */
+    throwOnError?: T['throwOnError'];
+}
+interface RequestOptions<TData = unknown, TResponseStyle extends ResponseStyle = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends Config<{
+    responseStyle: TResponseStyle;
+    throwOnError: ThrowOnError;
+}>, Pick<ServerSentEventsOptions<TData>, 'onRequest' | 'onSseError' | 'onSseEvent' | 'sseDefaultRetryDelay' | 'sseMaxRetryAttempts' | 'sseMaxRetryDelay'> {
+    /**
+     * Any body that you want to add to your request.
+     *
+     * {@link https://developer.mozilla.org/docs/Web/API/fetch#body}
+     */
+    body?: unknown;
+    path?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    /**
+     * Security mechanism(s) to use for the request.
+     */
+    security?: ReadonlyArray<Auth>;
+    url: Url;
+}
+interface ResolvedRequestOptions<TResponseStyle extends ResponseStyle = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends RequestOptions<unknown, TResponseStyle, ThrowOnError, Url> {
+    headers: Headers;
+    serializedBody?: string;
+}
+type RequestResult<TData = unknown, TError = unknown, ThrowOnError extends boolean = boolean, TResponseStyle extends ResponseStyle = 'fields'> = ThrowOnError extends true ? Promise<TResponseStyle extends 'data' ? TData extends Record<string, unknown> ? TData[keyof TData] : TData : {
+    data: TData extends Record<string, unknown> ? TData[keyof TData] : TData;
+    request: Request;
+    response: Response;
+}> : Promise<TResponseStyle extends 'data' ? (TData extends Record<string, unknown> ? TData[keyof TData] : TData) | undefined : ({
+    data: TData extends Record<string, unknown> ? TData[keyof TData] : TData;
+    error: undefined;
+} | {
+    data: undefined;
+    error: TError extends Record<string, unknown> ? TError[keyof TError] : TError;
+}) & {
+    /** request may be undefined, because error may be from building the request object itself */
+    request?: Request;
+    /** response may be undefined, because error may be from building the request object itself or from a network error */
+    response?: Response;
+}>;
+interface ClientOptions$1 {
+    baseUrl?: string;
+    responseStyle?: ResponseStyle;
+    throwOnError?: boolean;
+}
+type MethodFn = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<TData, TResponseStyle, ThrowOnError>, 'method'>) => RequestResult<TData, TError, ThrowOnError, TResponseStyle>;
+type SseFn = <TData = unknown, _TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<never, TResponseStyle, ThrowOnError>, 'method'>) => Promise<ServerSentEventsResult<TData>>;
+type RequestFn = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<TData, TResponseStyle, ThrowOnError>, 'method'> & Pick<Required<RequestOptions<TData, TResponseStyle, ThrowOnError>>, 'method'>) => RequestResult<TData, TError, ThrowOnError, TResponseStyle>;
+type BuildUrlFn = <TData extends {
+    body?: unknown;
+    path?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    url: string;
+}>(options: TData & Options$1<TData>) => string;
+type Client = Client$1<RequestFn, Config, MethodFn, BuildUrlFn, SseFn> & {
+    interceptors: Middleware<Request, Response, unknown, ResolvedRequestOptions>;
+};
+interface TDataShape {
+    body?: unknown;
+    headers?: unknown;
+    path?: unknown;
+    query?: unknown;
+    url: string;
+}
+type OmitKeys<T, K> = Pick<T, Exclude<keyof T, K>>;
+type Options$1<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown, TResponseStyle extends ResponseStyle = 'fields'> = OmitKeys<RequestOptions<TResponse, TResponseStyle, ThrowOnError>, 'body' | 'path' | 'query' | 'url'> & ([TData] extends [never] ? unknown : Omit<TData, 'url'>);
+
+type Platform = 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+type Status = 'draft' | 'pending' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'partial';
+type SortOrder = 'asc' | 'desc';
+type ErrorResponse = {
+    success: boolean;
+    message: string;
+};
+/**
+ * Pass this object in platformSpecificData when posting to Twitter/X, including Community post options.
+ */
+type TwitterConfigurations = {
+    /**
+     * Community ID to publish this post into.
+     */
+    communityId?: string;
+    /**
+     * When posting to a Community, also share the post with followers.
+     */
+    shareWithFollowers?: boolean;
+    /**
+     * Tweet ID to reply to.
+     */
+    replyToTweetId?: string;
+    replySettings?: 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
+    /**
+     * Additional tweets to chain as a thread. The root tweet uses post.content.
+     */
+    threadItems?: Array<{
+        /**
+         * Text of this thread tweet (max 280 chars)
+         */
+        content: string;
+        mediaItems?: Array<{
+            type: 'image' | 'video' | 'gif' | 'document';
+            url: string;
+            /**
+             * Thumbnail image URL for video items. Supported on YouTube regular videos (not Shorts). JPEG, PNG, or GIF, max 2 MB, min 640 px wide.
+             */
+            thumbnail?: string;
+        }>;
+    }>;
+    /**
+     * Cannot be combined with media or threadItems.
+     */
+    poll?: {
+        /**
+         * 2–4 poll options.
+         */
+        options: Array<string>;
+        /**
+         * Poll duration in minutes (5 min – 7 days).
+         */
+        durationMinutes: number;
+    };
+};
+/**
+ * Pass this object in platformSpecificData when posting to YouTube.
+ */
+type YouTubeConfigurations = {
+    /**
+     * Video title (max 100 chars, no < or >). Defaults to first 100 chars of content, or "Untitled Video".
+     */
+    title?: string;
+    /**
+     * Video tags. Total characters across all tags must be ≤500.
+     */
+    tags?: Array<string>;
+    /**
+     * Who can see the video. Defaults to "public". Scheduled posts upload as private and flip to this value at publish time.
+     */
+    visibility?: 'public' | 'private' | 'unlisted';
+    /**
+     * COPPA compliance flag. Setting to true permanently disables comments, notification bell, personalized ads, end screens, and cards on the video. Defaults to false.
+     */
+    madeForKids?: boolean;
+    /**
+     * AI-generated content disclosure. YouTube is increasingly enforcing this requirement. Defaults to false.
+     */
+    containsSyntheticMedia?: boolean;
+    /**
+     * YouTube category ID. Defaults to "22" (People & Blogs). Common values: "1" Film & Animation, "10" Music, "20" Gaming, "22" People & Blogs, "27" Education, "28" Science & Technology.
+     */
+    categoryId?: string;
+    /**
+     * Auto-posted comment after the video goes live. Max 10,000 characters. For publishNow posts: posted immediately after upload. For scheduled posts: posted when the video becomes public.
+     */
+    firstComment?: string;
+};
+/**
+ * Pass this object in platformSpecificData when posting to TikTok.
+ */
+type TikTokConfigurations = {
+    /**
+     * Who can see this post. Defaults to "PUBLIC_TO_EVERYONE".
+     */
+    privacyLevel?: 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY';
+    /**
+     * Disable comments on this post. Defaults to false.
+     */
+    disableComment?: boolean;
+    /**
+     * Disable duet for this video. Videos only. Defaults to false.
+     */
+    disableDuet?: boolean;
+    /**
+     * Disable stitch for this video. Videos only. Defaults to false.
+     */
+    disableStitch?: boolean;
+    /**
+     * Mark as branded content (paid partnership). Defaults to false.
+     */
+    brandContentToggle?: boolean;
+    /**
+     * Mark as organic brand promotion. Defaults to false.
+     */
+    brandOrganicToggle?: boolean;
+    /**
+     * AI-generated content disclosure. Videos only. Defaults to false.
+     */
+    isAigc?: boolean;
+    /**
+     * Timestamp in milliseconds to use as the video cover frame. Videos only.
+     */
+    videoCoverTimestampMs?: number;
+    /**
+     * Automatically add background music to photo carousels. Photo posts only. Defaults to true.
+     */
+    autoAddMusic?: boolean;
+    /**
+     * 0-indexed position of the cover image in a photo carousel. Photo posts only. Defaults to 0.
+     */
+    photoCoverIndex?: number;
+    /**
+     * Separate description for a TikTok photo or carousel post. Max 4,000 characters. When omitted, the post content is also used as the description. Photo posts only.
+     */
+    description?: string;
+    /**
+     * When true, sends content to the creator's TikTok inbox as a draft. Defaults to false (publishes immediately via DIRECT_POST).
+     */
+    draft?: boolean;
+};
+/**
+ * Pass this object in platformSpecificData when posting to Pinterest.
+ */
+type PinterestConfigurations = {
+    /**
+     * Target board ID. Retrieve available boards via GET /v1/pinterest/boards.
+     */
+    boardId: string;
+    /**
+     * Pin title. Max 100 characters. Defaults to first line of content.
+     */
+    title?: string;
+    /**
+     * HTTPS destination URL when the pin is clicked. Important for driving traffic.
+     */
+    link?: string;
+    /**
+     * Accessible image description. Max 500 characters.
+     */
+    altText?: string;
+    /**
+     * Hex color for the loading placeholder (e.g. "#6E7874").
+     */
+    dominantColor?: string;
+    /**
+     * Custom cover image URL for video pins.
+     */
+    coverImageUrl?: string;
+};
+/**
+ * Pass this object in platformSpecificData when posting to LinkedIn.
+ */
+type LinkedInConfigurations = {
+    /**
+     * Post visibility. "PUBLIC" = visible to everyone, "CONNECTIONS" = visible to connections only. Defaults to "PUBLIC".
+     */
+    visibility?: 'PUBLIC' | 'CONNECTIONS';
+    /**
+     * URL for an article/link post. When provided, the post becomes a link share with a preview card.
+     */
+    articleUrl?: string;
+    /**
+     * Title for the article preview card. Max 400 characters.
+     */
+    articleTitle?: string;
+    /**
+     * Description for the article preview card. Max 400 characters.
+     */
+    articleDescription?: string;
+    /**
+     * Title shown on the document card when posting a PDF. Required by LinkedIn when a document media item is included.
+     */
+    documentTitle?: string;
+};
+/**
+ * Pass this object in platformSpecificData when posting to Bluesky.
+ */
+type BlueskyConfigurations = {
+    /**
+     * BCP-47 language tags for the post (e.g. ["en"], ["en-US", "es"]). Defaults to ["en"].
+     */
+    langs?: Array<string>;
+    /**
+     * Alt text for each image, in the same order as mediaItems. Strongly encouraged for accessibility.
+     */
+    altText?: Array<string>;
+};
+/**
+ * Pass this object in platformSpecificData when posting to Facebook Pages.
+ */
+type FacebookConfigurations = {
+    /**
+     * When provided on a text-only post, Facebook renders a link preview card from this URL's Open Graph tags. Ignored when mediaItems are attached.
+     */
+    link?: string;
+    /**
+     * When false, the post is created on the Page in unpublished/draft state — useful for staging or scheduling via Facebook's own composer. Defaults to true.
+     */
+    published?: boolean;
+    /**
+     * Video posts only. Public URL of an image Facebook will use as the video's cover/thumbnail. Applied as a follow-up call after publish — if the upload fails, the post still succeeds (Facebook just auto-picks a frame). Ignored when no video is attached.
+     */
+    videoThumbnailUrl?: string;
+};
+/**
+ * Pass this object in platformSpecificData when posting to Instagram Business accounts. All fields are optional and apply to Reels/video posts; image posts ignore them.
+ */
+type InstagramConfigurations = {
+    /**
+     * Reels-only. When true (default), the Reel also appears in the account's main feed grid. Set false to publish to Reels only.
+     */
+    shareToFeed?: boolean;
+    /**
+     * Video-only. Public URL of an image Instagram will use as the cover frame for the Reel/video post. Ignored for image posts.
+     */
+    coverUrl?: string;
+    /**
+     * Video-only. Timestamp in milliseconds Instagram extracts as the cover frame. Ignored when coverUrl is set or for image posts.
+     */
+    thumbOffset?: number;
+};
+/**
+ * Pass this object in platformSpecificData when posting to Threads.
+ */
+type ThreadsConfigurations = {
+    /**
+     * Who can reply to this thread. Defaults to "everyone" when omitted.
+     */
+    replyControl?: 'everyone' | 'accounts_you_follow' | 'mentioned_only';
+    /**
+     * Alt text for each image, in the same order as mediaItems. Strongly encouraged for accessibility.
+     */
+    altText?: Array<string>;
+};
+/**
+ * Pass this object in platformSpecificData when posting to Google Business Profile. Posts appear on Google Search and Maps.
+ */
+type GoogleBusinessConfigurations = {
+    /**
+     * Post type. Defaults to STANDARD. Use EVENT for event posts, OFFER for promotional offer posts.
+     */
+    topicType?: 'STANDARD' | 'EVENT' | 'OFFER';
+    /**
+     * Call-to-action button shown on the post.
+     */
+    callToActionType?: 'BOOK' | 'ORDER' | 'SHOP' | 'LEARN_MORE' | 'SIGN_UP' | 'CALL' | 'GET_OFFER';
+    /**
+     * URL for the call-to-action. Required for all CTA types except CALL.
+     */
+    callToActionUrl?: string;
+    /**
+     * Event title. Required when topicType is EVENT.
+     */
+    eventTitle?: string;
+    /**
+     * Event start date in YYYY-MM-DD format. Required when topicType is EVENT.
+     */
+    eventStartDate?: string;
+    /**
+     * Event start time in HH:MM (24-hour) format. Required when topicType is EVENT.
+     */
+    eventStartTime?: string;
+    /**
+     * Event end date in YYYY-MM-DD format. Required when topicType is EVENT.
+     */
+    eventEndDate?: string;
+    /**
+     * Event end time in HH:MM (24-hour) format. Required when topicType is EVENT.
+     */
+    eventEndTime?: string;
+    /**
+     * Coupon code for OFFER posts.
+     */
+    offerCouponCode?: string;
+    /**
+     * Online redemption URL for OFFER posts.
+     */
+    offerRedeemOnlineUrl?: string;
+    /**
+     * Terms and conditions text for OFFER posts.
+     */
+    offerTermsConditions?: string;
+};
+type PostPayload = {
+    /**
+     * Post text body
+     */
+    content: string;
+    /**
+     * Media attachments (images, videos, GIFs)
+     */
+    mediaItems?: Array<{
+        type: 'image' | 'video' | 'gif' | 'document';
+        url: string;
+        /**
+         * Thumbnail image URL for video items. Supported on YouTube regular videos (not Shorts). JPEG, PNG, or GIF, max 2 MB, min 640 px wide.
+         */
+        thumbnail?: string;
+    }>;
+    /**
+     * Target platform accounts to publish to
+     */
+    platforms: Array<{
+        platform: 'twitter';
+        /**
+         * Integration._id — find yours via GET /connect/integrations
+         */
+        accountId: string;
+        /**
+         * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+         */
+        content?: string;
+        platformSpecificData?: TwitterConfigurations;
+    } | {
+        platform: 'instagram';
+        /**
+         * Integration._id — find yours via GET /connect/integrations
+         */
+        accountId: string;
+        /**
+         * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+         */
+        content?: string;
+        platformSpecificData?: InstagramConfigurations;
+    } | {
+        platform: 'youtube';
+        /**
+         * Integration._id — find yours via GET /connect/integrations
+         */
+        accountId: string;
+        /**
+         * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+         */
+        content?: string;
+        platformSpecificData?: YouTubeConfigurations;
+    } | {
+        platform: 'tiktok';
+        /**
+         * Integration._id — find yours via GET /connect/integrations
+         */
+        accountId: string;
+        /**
+         * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+         */
+        content?: string;
+        platformSpecificData?: TikTokConfigurations;
+    } | {
+        platform: 'pinterest';
+        /**
+         * Integration._id — find yours via GET /connect/integrations
+         */
+        accountId: string;
+        /**
+         * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+         */
+        content?: string;
+        platformSpecificData?: PinterestConfigurations;
+    } | {
+        platform: 'linkedin';
+        /**
+         * Integration._id — find yours via GET /connect/integrations
+         */
+        accountId: string;
+        /**
+         * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+         */
+        content?: string;
+        platformSpecificData?: LinkedInConfigurations;
+    } | {
+        platform: 'bluesky';
+        /**
+         * Integration._id — find yours via GET /connect/integrations
+         */
+        accountId: string;
+        /**
+         * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+         */
+        content?: string;
+        platformSpecificData?: BlueskyConfigurations;
+    } | {
+        platform: 'facebook';
+        /**
+         * Integration._id — find yours via GET /connect/integrations
+         */
+        accountId: string;
+        /**
+         * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+         */
+        content?: string;
+        platformSpecificData?: FacebookConfigurations;
+    } | {
+        platform: 'threads';
+        /**
+         * Integration._id — find yours via GET /connect/integrations
+         */
+        accountId: string;
+        /**
+         * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+         */
+        content?: string;
+        platformSpecificData?: ThreadsConfigurations;
+    } | {
+        platform: 'googlebusiness';
+        /**
+         * Integration._id — find yours via GET /connect/integrations
+         */
+        accountId: string;
+        /**
+         * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+         */
+        content?: string;
+        platformSpecificData?: GoogleBusinessConfigurations;
+    }>;
+    /**
+     * Publish immediately. Required when scheduledFor is omitted.
+     */
+    publishNow?: boolean;
+    /**
+     * ISO 8601 datetime to schedule the post for future publishing
+     */
+    scheduledFor?: string;
+    /**
+     * IANA timezone for the scheduled time (e.g. America/New_York). Defaults to UTC.
+     */
+    timezone?: string;
+};
+type GetV1HealthData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/health';
+};
+type GetV1HealthResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        ok: boolean;
+    };
+};
+type GetV1HealthResponse = GetV1HealthResponses[keyof GetV1HealthResponses];
+type GetV1HealthAuthData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/health/auth';
+};
+type GetV1HealthAuthResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        ok: boolean;
+    };
+};
+type GetV1HealthAuthResponse = GetV1HealthAuthResponses[keyof GetV1HealthAuthResponses];
+type GetV1ConnectLinkedinSelectionByTokenData = {
+    body?: never;
+    path: {
+        token: string;
+    };
+    query?: never;
+    url: '/v1/connect/linkedin/selection/{token}';
+};
+type GetV1ConnectLinkedinSelectionByTokenErrors = {
+    /**
+     * Default Response
+     */
+    404: {
+        error: string;
+    };
+};
+type GetV1ConnectLinkedinSelectionByTokenError = GetV1ConnectLinkedinSelectionByTokenErrors[keyof GetV1ConnectLinkedinSelectionByTokenErrors];
+type GetV1ConnectLinkedinSelectionByTokenResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        platform: 'linkedin';
+        expiresInSeconds: number;
+        accounts: Array<{
+            id: string;
+            type: 'person' | 'organization';
+            platformUserId: string;
+            displayName: string | null;
+            username: string | null;
+            imageUrl: string | null;
+        }>;
+    };
+};
+type GetV1ConnectLinkedinSelectionByTokenResponse = GetV1ConnectLinkedinSelectionByTokenResponses[keyof GetV1ConnectLinkedinSelectionByTokenResponses];
+type PostV1ConnectLinkedinSelectionByTokenData = {
+    body: {
+        selectedAccountIds: Array<string>;
+    };
+    path: {
+        token: string;
+    };
+    query?: never;
+    url: '/v1/connect/linkedin/selection/{token}';
+};
+type PostV1ConnectLinkedinSelectionByTokenErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        error: string;
+    };
+    /**
+     * Default Response
+     */
+    404: {
+        error: string;
+    };
+};
+type PostV1ConnectLinkedinSelectionByTokenError = PostV1ConnectLinkedinSelectionByTokenErrors[keyof PostV1ConnectLinkedinSelectionByTokenErrors];
+type PostV1ConnectLinkedinSelectionByTokenResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        platform: 'linkedin';
+        message: string;
+        redirectUri?: string;
+        integrations: Array<{
+            /**
+             * Use this as accountId when creating posts
+             */
+            id: string;
+            platform: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+            /**
+             * The user ID on the platform, or null if not yet retrieved
+             */
+            platformUserId: string | null;
+            /**
+             * The public username or handle, including @ for handle-based platforms
+             */
+            username: string | null;
+            /**
+             * Human-readable display name of the connected account
+             */
+            displayName: string | null;
+            /**
+             * Public profile/page URL for the connected account, when it can be derived
+             */
+            profileUrl: string | null;
+            /**
+             * Profile image URL for the connected account, or null if unavailable
+             */
+            imageUrl: string | null;
+            /**
+             * Provider-specific public metadata for this connected account.
+             */
+            platformMetadata?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Profile this integration belongs to, or null if it was connected without a profile
+             */
+            profileId: string | null;
+            /**
+             * The OAuth app (customer's own OAuth app) this integration was connected under, or null if postpeer's system app was used.
+             */
+            appId: string | null;
+            /**
+             * The OAuth app metadata for BYOK integrations, or null when postpeer system app was used.
+             */
+            app: {
+                id?: string;
+                name?: string;
+                imageUrl?: string | null;
+            } | null;
+            /**
+             * True when this integration was connected under the customer's own OAuth app (Bring Your Own Keys), i.e. appId is set. False when postpeer's system app is used.
+             */
+            byok: boolean;
+            createdAt: string;
+        }>;
+    };
+};
+type PostV1ConnectLinkedinSelectionByTokenResponse = PostV1ConnectLinkedinSelectionByTokenResponses[keyof PostV1ConnectLinkedinSelectionByTokenResponses];
+type GetV1ConnectByPlatformData = {
+    body?: never;
+    path: {
+        platform: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+    };
+    query?: {
+        /**
+         * Final URL to redirect to after the connection completes. In headless mode, this URL also receives selection status query parameters when customer-owned account selection is required.
+         */
+        redirectUri?: string;
+        /**
+         * URL to redirect to when the user cancels or denies the OAuth prompt. Falls back to redirectUri when omitted.
+         */
+        cancelRedirectUri?: string;
+        /**
+         * When true, platforms that require account selection redirect back to redirectUri with a short-lived selectionToken so you can build your own selection UI. When false, PostPeer hosts the selection UI.
+         */
+        headless?: boolean;
+        /**
+         * Profile to associate the resulting integration with. Must belong to the same project. Omit to connect without a profile.
+         */
+        profileId?: string;
+        /**
+         * Connect under your own OAuth app (Bring Your Own Keys). Pass the id of an OAuth app created via /v1/apps for this same platform. Omit to use postpeer's system app.
+         */
+        appId?: string;
+    };
+    url: '/v1/connect/{platform}';
+};
+type GetV1ConnectByPlatformErrors = {
+    /**
+     * Default Response
+     */
+    500: {
+        error: string;
+    };
+};
+type GetV1ConnectByPlatformError = GetV1ConnectByPlatformErrors[keyof GetV1ConnectByPlatformErrors];
+type GetV1ConnectByPlatformResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        url: string;
+    };
+};
+type GetV1ConnectByPlatformResponse = GetV1ConnectByPlatformResponses[keyof GetV1ConnectByPlatformResponses];
+type PostV1ConnectBlueskyAuthData = {
+    body: {
+        /**
+         * Bluesky handle (e.g. "alice.bsky.social") or DID (e.g. "did:plc:abc123").
+         */
+        identifier: string;
+        /**
+         * An app password generated at https://bsky.app/settings/app-passwords. Do NOT use the account password.
+         */
+        password: string;
+    };
+    path?: never;
+    query?: {
+        /**
+         * Final URL to redirect to after the connection completes. In headless mode, this URL also receives selection status query parameters when customer-owned account selection is required.
+         */
+        redirectUri?: string;
+        /**
+         * URL to redirect to when the user cancels or denies the OAuth prompt. Falls back to redirectUri when omitted.
+         */
+        cancelRedirectUri?: string;
+        /**
+         * When true, platforms that require account selection redirect back to redirectUri with a short-lived selectionToken so you can build your own selection UI. When false, PostPeer hosts the selection UI.
+         */
+        headless?: boolean;
+        /**
+         * Profile to associate the resulting integration with. Must belong to the same project. Omit to connect without a profile.
+         */
+        profileId?: string;
+        /**
+         * Connect under your own OAuth app (Bring Your Own Keys). Pass the id of an OAuth app created via /v1/apps for this same platform. Omit to use postpeer's system app.
+         */
+        appId?: string;
+    };
+    url: '/v1/connect/bluesky/auth';
+};
+type PostV1ConnectBlueskyAuthErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        error: string;
+    };
+    /**
+     * Default Response
+     */
+    401: {
+        error: string;
+    };
+    /**
+     * Default Response
+     */
+    502: {
+        error: string;
+    };
+};
+type PostV1ConnectBlueskyAuthError = PostV1ConnectBlueskyAuthErrors[keyof PostV1ConnectBlueskyAuthErrors];
+type GetV1ConnectIntegrationsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        platform?: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+        /**
+         * Filter to integrations belonging to this profile. Pass "null" (literal string) to filter to integrations with no profile.
+         */
+        profileId?: string;
+        /**
+         * Case-insensitive search across the connected account name (displayName), username, and platform user ID.
+         */
+        q?: string;
+        /**
+         * Page size (max 100)
+         */
+        limit?: number;
+        /**
+         * Number of integrations to skip
+         */
+        offset?: number;
+        sort?: SortOrder;
+    };
+    url: '/v1/connect/integrations';
+};
+type GetV1ConnectIntegrationsResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        /**
+         * Total matched integrations across all pages
+         */
+        total: number;
+        integrations: Array<{
+            /**
+             * Use this as accountId when creating posts
+             */
+            id: string;
+            platform: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+            /**
+             * The user ID on the platform, or null if not yet retrieved
+             */
+            platformUserId: string | null;
+            /**
+             * The public username or handle, including @ for handle-based platforms
+             */
+            username: string | null;
+            /**
+             * Human-readable display name of the connected account
+             */
+            displayName: string | null;
+            /**
+             * Public profile/page URL for the connected account, when it can be derived
+             */
+            profileUrl: string | null;
+            /**
+             * Profile image URL for the connected account, or null if unavailable
+             */
+            imageUrl: string | null;
+            /**
+             * Provider-specific public metadata for this connected account.
+             */
+            platformMetadata?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Profile this integration belongs to, or null if it was connected without a profile
+             */
+            profileId: string | null;
+            /**
+             * The OAuth app (customer's own OAuth app) this integration was connected under, or null if postpeer's system app was used.
+             */
+            appId: string | null;
+            /**
+             * The OAuth app metadata for BYOK integrations, or null when postpeer system app was used.
+             */
+            app: {
+                id?: string;
+                name?: string;
+                imageUrl?: string | null;
+            } | null;
+            /**
+             * True when this integration was connected under the customer's own OAuth app (Bring Your Own Keys), i.e. appId is set. False when postpeer's system app is used.
+             */
+            byok: boolean;
+            createdAt: string;
+        }>;
+    };
+};
+type GetV1ConnectIntegrationsResponse = GetV1ConnectIntegrationsResponses[keyof GetV1ConnectIntegrationsResponses];
+type DeleteV1ConnectIntegrationsByIdData = {
+    body?: never;
+    path: {
+        /**
+         * Integration ID to disconnect
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/connect/integrations/{id}';
+};
+type DeleteV1ConnectIntegrationsByIdErrors = {
+    /**
+     * Default Response
+     */
+    404: {
+        error: string;
+    };
+};
+type DeleteV1ConnectIntegrationsByIdError = DeleteV1ConnectIntegrationsByIdErrors[keyof DeleteV1ConnectIntegrationsByIdErrors];
+type DeleteV1ConnectIntegrationsByIdResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        message: string;
+    };
+};
+type DeleteV1ConnectIntegrationsByIdResponse = DeleteV1ConnectIntegrationsByIdResponses[keyof DeleteV1ConnectIntegrationsByIdResponses];
+type GetV1ProfilesData = {
+    body?: never;
+    path?: never;
+    query?: {
+        page?: number;
+        limit?: number;
+        /**
+         * Case-insensitive substring match on profile name
+         */
+        name?: string;
+    };
+    url: '/v1/profiles/';
+};
+type GetV1ProfilesResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        total: number;
+        page: number;
+        limit: number;
+        profiles: Array<{
+            id: string;
+            name: string;
+            description: string | null;
+            /**
+             * Number of active integrations bound to this profile
+             */
+            integrationCount: number;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+    };
+};
+type GetV1ProfilesResponse = GetV1ProfilesResponses[keyof GetV1ProfilesResponses];
+type PostV1ProfilesData = {
+    body: {
+        /**
+         * Profile name (e.g. "Acme Co", "Personal Brand")
+         */
+        name: string;
+        /**
+         * Optional description of what this profile is for
+         */
+        description?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/profiles/';
+};
+type PostV1ProfilesResponses = {
+    /**
+     * Default Response
+     */
+    201: {
+        success: boolean;
+        profile: {
+            id: string;
+            name: string;
+            description: string | null;
+            /**
+             * Number of active integrations bound to this profile
+             */
+            integrationCount: number;
+            createdAt: string;
+            updatedAt: string;
+        };
+    };
+};
+type PostV1ProfilesResponse = PostV1ProfilesResponses[keyof PostV1ProfilesResponses];
+type DeleteV1ProfilesByIdData = {
+    body?: never;
+    path: {
+        /**
+         * Profile ID
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/profiles/{id}';
+};
+type DeleteV1ProfilesByIdErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        error: string;
+    };
+    /**
+     * Default Response
+     */
+    404: {
+        error: string;
+    };
+};
+type DeleteV1ProfilesByIdError = DeleteV1ProfilesByIdErrors[keyof DeleteV1ProfilesByIdErrors];
+type DeleteV1ProfilesByIdResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        message: string;
+    };
+};
+type DeleteV1ProfilesByIdResponse = DeleteV1ProfilesByIdResponses[keyof DeleteV1ProfilesByIdResponses];
+type GetV1ProfilesByIdData = {
+    body?: never;
+    path: {
+        /**
+         * Profile ID
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/profiles/{id}';
+};
+type GetV1ProfilesByIdErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        error: string;
+    };
+    /**
+     * Default Response
+     */
+    404: {
+        error: string;
+    };
+};
+type GetV1ProfilesByIdError = GetV1ProfilesByIdErrors[keyof GetV1ProfilesByIdErrors];
+type GetV1ProfilesByIdResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        profile: {
+            id: string;
+            name: string;
+            description: string | null;
+            /**
+             * Number of active integrations bound to this profile
+             */
+            integrationCount: number;
+            createdAt: string;
+            updatedAt: string;
+        };
+    };
+};
+type GetV1ProfilesByIdResponse = GetV1ProfilesByIdResponses[keyof GetV1ProfilesByIdResponses];
+type PatchV1ProfilesByIdData = {
+    body: {
+        name?: string;
+        description?: string | null;
+    };
+    path: {
+        /**
+         * Profile ID
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/profiles/{id}';
+};
+type PatchV1ProfilesByIdErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        error: string;
+    };
+    /**
+     * Default Response
+     */
+    404: {
+        error: string;
+    };
+};
+type PatchV1ProfilesByIdError = PatchV1ProfilesByIdErrors[keyof PatchV1ProfilesByIdErrors];
+type PatchV1ProfilesByIdResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        profile: {
+            id: string;
+            name: string;
+            description: string | null;
+            /**
+             * Number of active integrations bound to this profile
+             */
+            integrationCount: number;
+            createdAt: string;
+            updatedAt: string;
+        };
+    };
+};
+type PatchV1ProfilesByIdResponse = PatchV1ProfilesByIdResponses[keyof PatchV1ProfilesByIdResponses];
+type GetV1AppsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        platform?: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+        page?: number;
+        limit?: number;
+        /**
+         * Case-insensitive substring match on app name
+         */
+        name?: string;
+    };
+    url: '/v1/apps/';
+};
+type GetV1AppsResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        total: number;
+        page: number;
+        limit: number;
+        apps: Array<{
+            /**
+             * Pass this as appId when connecting
+             */
+            id: string;
+            platform: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+            name: string;
+            imageUrl: string | null;
+            /**
+             * The OAuth app client id. The client secret is never returned.
+             */
+            clientId: string;
+            /**
+             * Number of active integrations connected under this app
+             */
+            integrationCount: number;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+    };
+};
+type GetV1AppsResponse = GetV1AppsResponses[keyof GetV1AppsResponses];
+type PostV1AppsData = {
+    body: {
+        platform: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+        /**
+         * A label for this app (e.g. "Acme Twitter OAuth App")
+         */
+        name: string;
+        /**
+         * The client id of your OAuth app for this platform
+         */
+        clientId: string;
+        /**
+         * The client secret of your OAuth app. Stored encrypted.
+         */
+        clientSecret: string;
+        /**
+         * Optional icon URL for the app
+         */
+        imageUrl?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/apps/';
+};
+type PostV1AppsErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        error: string;
+    };
+    /**
+     * Default Response
+     */
+    409: {
+        error: string;
+    };
+};
+type PostV1AppsError = PostV1AppsErrors[keyof PostV1AppsErrors];
+type PostV1AppsResponses = {
+    /**
+     * Default Response
+     */
+    201: {
+        success: boolean;
+        app: {
+            /**
+             * Pass this as appId when connecting
+             */
+            id: string;
+            platform: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+            name: string;
+            imageUrl: string | null;
+            /**
+             * The OAuth app client id. The client secret is never returned.
+             */
+            clientId: string;
+            /**
+             * Number of active integrations connected under this app
+             */
+            integrationCount: number;
+            createdAt: string;
+            updatedAt: string;
+        };
+    };
+};
+type PostV1AppsResponse = PostV1AppsResponses[keyof PostV1AppsResponses];
+type DeleteV1AppsByIdData = {
+    body?: never;
+    path: {
+        /**
+         * OAuth app ID
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/apps/{id}';
+};
+type DeleteV1AppsByIdErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        error: string;
+    };
+    /**
+     * Default Response
+     */
+    404: {
+        error: string;
+    };
+    /**
+     * Default Response
+     */
+    409: {
+        error: string;
+    };
+};
+type DeleteV1AppsByIdError = DeleteV1AppsByIdErrors[keyof DeleteV1AppsByIdErrors];
+type DeleteV1AppsByIdResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        message: string;
+    };
+};
+type DeleteV1AppsByIdResponse = DeleteV1AppsByIdResponses[keyof DeleteV1AppsByIdResponses];
+type GetV1AppsByIdData = {
+    body?: never;
+    path: {
+        /**
+         * OAuth app ID
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/apps/{id}';
+};
+type GetV1AppsByIdErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        error: string;
+    };
+    /**
+     * Default Response
+     */
+    404: {
+        error: string;
+    };
+};
+type GetV1AppsByIdError = GetV1AppsByIdErrors[keyof GetV1AppsByIdErrors];
+type GetV1AppsByIdResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        app: {
+            /**
+             * Pass this as appId when connecting
+             */
+            id: string;
+            platform: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+            name: string;
+            imageUrl: string | null;
+            /**
+             * The OAuth app client id. The client secret is never returned.
+             */
+            clientId: string;
+            /**
+             * Number of active integrations connected under this app
+             */
+            integrationCount: number;
+            createdAt: string;
+            updatedAt: string;
+        };
+    };
+};
+type GetV1AppsByIdResponse = GetV1AppsByIdResponses[keyof GetV1AppsByIdResponses];
+type PatchV1AppsByIdData = {
+    body: {
+        name?: string;
+        imageUrl?: string | null;
+        /**
+         * Rotate the stored client secret. The clientId stays the same so existing tokens keep working — to switch to a different app, create a new OAuth app and reconnect.
+         */
+        clientSecret?: string;
+    };
+    path: {
+        /**
+         * OAuth app ID
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/apps/{id}';
+};
+type PatchV1AppsByIdErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        error: string;
+    };
+    /**
+     * Default Response
+     */
+    404: {
+        error: string;
+    };
+};
+type PatchV1AppsByIdError = PatchV1AppsByIdErrors[keyof PatchV1AppsByIdErrors];
+type PatchV1AppsByIdResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        app: {
+            /**
+             * Pass this as appId when connecting
+             */
+            id: string;
+            platform: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+            name: string;
+            imageUrl: string | null;
+            /**
+             * The OAuth app client id. The client secret is never returned.
+             */
+            clientId: string;
+            /**
+             * Number of active integrations connected under this app
+             */
+            integrationCount: number;
+            createdAt: string;
+            updatedAt: string;
+        };
+    };
+};
+type PatchV1AppsByIdResponse = PatchV1AppsByIdResponses[keyof PatchV1AppsByIdResponses];
+type PostV1NotificationsTestData = {
+    body: {
+        channel: 'webhook' | 'email';
+        profileId?: string | null;
+        webhook?: {
+            /**
+             * HTTPS endpoint that receives PostPeer JSON payloads
+             */
+            url: string;
+        };
+        email?: {
+            recipients: Array<string>;
+        };
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/notifications/test';
+};
+type PostV1NotificationsTestErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        success: boolean;
+        message: string;
+    };
+};
+type PostV1NotificationsTestError = PostV1NotificationsTestErrors[keyof PostV1NotificationsTestErrors];
+type PostV1NotificationsTestResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        message: string;
+    };
+};
+type PostV1NotificationsTestResponse = PostV1NotificationsTestResponses[keyof PostV1NotificationsTestResponses];
+type GetV1NotificationsData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/notifications/';
+};
+type GetV1NotificationsResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        notifications: Array<{
+            id: string;
+            channel: 'webhook' | 'email';
+            profileId: string | null;
+            eventTypes: Array<'post.scheduled' | 'post.published' | 'post.partial' | 'post.failed'>;
+            onlyScheduledPosts: boolean;
+            enabled: boolean;
+            webhook?: {
+                url: string;
+                /**
+                 * Webhook signing secret (masked in list responses)
+                 */
+                secret: string;
+            };
+            email?: {
+                recipients: Array<string>;
+            };
+            lastTestAt: string | null;
+            lastTestStatus: string | null;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+    };
+};
+type GetV1NotificationsResponse = GetV1NotificationsResponses[keyof GetV1NotificationsResponses];
+type PostV1NotificationsData = {
+    body: {
+        channel: 'webhook' | 'email';
+        profileId?: string | null;
+        eventTypes: Array<'post.scheduled' | 'post.published' | 'post.partial' | 'post.failed'>;
+        /**
+         * When true, deliver matching notifications only for posts that were scheduled.
+         */
+        onlyScheduledPosts?: boolean;
+        enabled?: boolean;
+        webhook?: {
+            /**
+             * HTTPS endpoint that receives PostPeer JSON payloads
+             */
+            url: string;
+        };
+        email?: {
+            recipients: Array<string>;
+        };
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/notifications/';
+};
+type PostV1NotificationsErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        success: boolean;
+        message: string;
+    };
+};
+type PostV1NotificationsError = PostV1NotificationsErrors[keyof PostV1NotificationsErrors];
+type PostV1NotificationsResponses = {
+    /**
+     * Default Response
+     */
+    201: {
+        success: boolean;
+        notification: {
+            id: string;
+            channel: 'webhook' | 'email';
+            profileId: string | null;
+            eventTypes: Array<'post.scheduled' | 'post.published' | 'post.partial' | 'post.failed'>;
+            onlyScheduledPosts: boolean;
+            enabled: boolean;
+            webhook?: {
+                url: string;
+                /**
+                 * Webhook signing secret (masked in list responses)
+                 */
+                secret: string;
+            };
+            email?: {
+                recipients: Array<string>;
+            };
+            lastTestAt: string | null;
+            lastTestStatus: string | null;
+            createdAt: string;
+            updatedAt: string;
+        };
+    };
+};
+type PostV1NotificationsResponse = PostV1NotificationsResponses[keyof PostV1NotificationsResponses];
+type DeleteV1NotificationsByIdData = {
+    body?: never;
+    path: {
+        /**
+         * Notification subscription ID
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/notifications/{id}';
+};
+type DeleteV1NotificationsByIdErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    404: {
+        success: boolean;
+        message: string;
+    };
+};
+type DeleteV1NotificationsByIdError = DeleteV1NotificationsByIdErrors[keyof DeleteV1NotificationsByIdErrors];
+type DeleteV1NotificationsByIdResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        message: string;
+    };
+};
+type DeleteV1NotificationsByIdResponse = DeleteV1NotificationsByIdResponses[keyof DeleteV1NotificationsByIdResponses];
+type GetV1NotificationsByIdData = {
+    body?: never;
+    path: {
+        /**
+         * Notification subscription ID
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/notifications/{id}';
+};
+type GetV1NotificationsByIdErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    404: {
+        success: boolean;
+        message: string;
+    };
+};
+type GetV1NotificationsByIdError = GetV1NotificationsByIdErrors[keyof GetV1NotificationsByIdErrors];
+type GetV1NotificationsByIdResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        notification: {
+            id: string;
+            channel: 'webhook' | 'email';
+            profileId: string | null;
+            eventTypes: Array<'post.scheduled' | 'post.published' | 'post.partial' | 'post.failed'>;
+            onlyScheduledPosts: boolean;
+            enabled: boolean;
+            webhook?: {
+                url: string;
+                /**
+                 * Webhook signing secret (masked in list responses)
+                 */
+                secret: string;
+            };
+            email?: {
+                recipients: Array<string>;
+            };
+            lastTestAt: string | null;
+            lastTestStatus: string | null;
+            createdAt: string;
+            updatedAt: string;
+        };
+    };
+};
+type GetV1NotificationsByIdResponse = GetV1NotificationsByIdResponses[keyof GetV1NotificationsByIdResponses];
+type PatchV1NotificationsByIdData = {
+    body: {
+        profileId?: string | null;
+        eventTypes?: Array<'post.scheduled' | 'post.published' | 'post.partial' | 'post.failed'>;
+        /**
+         * When true, deliver matching notifications only for posts that were scheduled.
+         */
+        onlyScheduledPosts?: boolean;
+        enabled?: boolean;
+        webhook?: {
+            /**
+             * HTTPS endpoint that receives PostPeer JSON payloads
+             */
+            url: string;
+        };
+        email?: {
+            recipients: Array<string>;
+        };
+    };
+    path: {
+        /**
+         * Notification subscription ID
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/notifications/{id}';
+};
+type PatchV1NotificationsByIdErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    404: {
+        success: boolean;
+        message: string;
+    };
+};
+type PatchV1NotificationsByIdError = PatchV1NotificationsByIdErrors[keyof PatchV1NotificationsByIdErrors];
+type PatchV1NotificationsByIdResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        notification: {
+            id: string;
+            channel: 'webhook' | 'email';
+            profileId: string | null;
+            eventTypes: Array<'post.scheduled' | 'post.published' | 'post.partial' | 'post.failed'>;
+            onlyScheduledPosts: boolean;
+            enabled: boolean;
+            webhook?: {
+                url: string;
+                /**
+                 * Webhook signing secret (masked in list responses)
+                 */
+                secret: string;
+            };
+            email?: {
+                recipients: Array<string>;
+            };
+            lastTestAt: string | null;
+            lastTestStatus: string | null;
+            createdAt: string;
+            updatedAt: string;
+        };
+    };
+};
+type PatchV1NotificationsByIdResponse = PatchV1NotificationsByIdResponses[keyof PatchV1NotificationsByIdResponses];
+type GetV1PlatformsData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/platforms';
+};
+type GetV1PlatformsResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        platforms: Array<{
+            name: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+            status: 'prod' | 'beta' | 'dev';
+        }>;
+    };
+};
+type GetV1PlatformsResponse = GetV1PlatformsResponses[keyof GetV1PlatformsResponses];
+type GetV1PostsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        status?: 'draft' | 'pending' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'partial';
+        /**
+         * Filter by platform (repeatable — OR logic)
+         */
+        platform?: Array<'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness'>;
+        /**
+         * Filter to posts targeting an integration bound to this profile. Pass "null" (literal string) to filter to posts whose integrations have no profile.
+         */
+        profileId?: string;
+        /**
+         * ISO 8601 lower bound on createdAt
+         */
+        createdAfter?: string;
+        /**
+         * ISO 8601 upper bound on createdAt
+         */
+        createdBefore?: string;
+        /**
+         * ISO 8601 lower bound on scheduledFor
+         */
+        scheduledAfter?: string;
+        /**
+         * ISO 8601 upper bound on scheduledFor
+         */
+        scheduledBefore?: string;
+        /**
+         * Page size (max 100)
+         */
+        limit?: number;
+        /**
+         * Number of posts to skip
+         */
+        offset?: number;
+        sort?: SortOrder;
+    };
+    url: '/v1/posts/';
+};
+type GetV1PostsErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        success: boolean;
+        message: string;
+    };
+};
+type GetV1PostsError = GetV1PostsErrors[keyof GetV1PostsErrors];
+type GetV1PostsResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        /**
+         * Total matched posts across all pages
+         */
+        total: number;
+        posts: Array<{
+            /**
+             * MongoDB ObjectId of the Post document
+             */
+            postId: string;
+            content: string;
+            status: 'draft' | 'pending' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'partial';
+            /**
+             * ISO 8601 scheduled datetime
+             */
+            scheduledFor: string | null;
+            timezone: string;
+            mediaItems: Array<{
+                type: 'image' | 'video' | 'gif';
+                url: string;
+                filename: string;
+                size: number;
+                mimeType: string;
+            }>;
+            platforms: Array<{
+                platform: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+                status: 'draft' | 'pending' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'partial';
+                /**
+                 * Per-platform text override that was used for this platform. Null when the top-level `content` was used.
+                 */
+                content: string | null;
+                platformPostId: string | null;
+                /**
+                 * Direct URL to the published post
+                 */
+                platformPostUrl: string | null;
+                publishedAt: string | null;
+                errorMessage: string | null;
+                warningMessage: string | null;
+            }>;
+            crosspostingEnabled: boolean;
+            rawRequestBody: {
+                [key: string]: unknown;
+            };
+            createdAt: string;
+            updatedAt: string;
+        }>;
+    };
+};
+type GetV1PostsResponse = GetV1PostsResponses[keyof GetV1PostsResponses];
+type PostV1PostsData = {
+    body: {
+        /**
+         * Post text body
+         */
+        content: string;
+        /**
+         * Media attachments (images, videos, GIFs)
+         */
+        mediaItems?: Array<{
+            type: 'image' | 'video' | 'gif' | 'document';
+            url: string;
+            /**
+             * Thumbnail image URL for video items. Supported on YouTube regular videos (not Shorts). JPEG, PNG, or GIF, max 2 MB, min 640 px wide.
+             */
+            thumbnail?: string;
+        }>;
+        /**
+         * Target platform accounts to publish to
+         */
+        platforms: Array<{
+            platform: 'twitter';
+            /**
+             * Integration._id — find yours via GET /connect/integrations
+             */
+            accountId: string;
+            /**
+             * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+             */
+            content?: string;
+            platformSpecificData?: TwitterConfigurations;
+        } | {
+            platform: 'instagram';
+            /**
+             * Integration._id — find yours via GET /connect/integrations
+             */
+            accountId: string;
+            /**
+             * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+             */
+            content?: string;
+            platformSpecificData?: InstagramConfigurations;
+        } | {
+            platform: 'youtube';
+            /**
+             * Integration._id — find yours via GET /connect/integrations
+             */
+            accountId: string;
+            /**
+             * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+             */
+            content?: string;
+            platformSpecificData?: YouTubeConfigurations;
+        } | {
+            platform: 'tiktok';
+            /**
+             * Integration._id — find yours via GET /connect/integrations
+             */
+            accountId: string;
+            /**
+             * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+             */
+            content?: string;
+            platformSpecificData?: TikTokConfigurations;
+        } | {
+            platform: 'pinterest';
+            /**
+             * Integration._id — find yours via GET /connect/integrations
+             */
+            accountId: string;
+            /**
+             * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+             */
+            content?: string;
+            platformSpecificData?: PinterestConfigurations;
+        } | {
+            platform: 'linkedin';
+            /**
+             * Integration._id — find yours via GET /connect/integrations
+             */
+            accountId: string;
+            /**
+             * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+             */
+            content?: string;
+            platformSpecificData?: LinkedInConfigurations;
+        } | {
+            platform: 'bluesky';
+            /**
+             * Integration._id — find yours via GET /connect/integrations
+             */
+            accountId: string;
+            /**
+             * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+             */
+            content?: string;
+            platformSpecificData?: BlueskyConfigurations;
+        } | {
+            platform: 'facebook';
+            /**
+             * Integration._id — find yours via GET /connect/integrations
+             */
+            accountId: string;
+            /**
+             * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+             */
+            content?: string;
+            platformSpecificData?: FacebookConfigurations;
+        } | {
+            platform: 'threads';
+            /**
+             * Integration._id — find yours via GET /connect/integrations
+             */
+            accountId: string;
+            /**
+             * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+             */
+            content?: string;
+            platformSpecificData?: ThreadsConfigurations;
+        } | {
+            platform: 'googlebusiness';
+            /**
+             * Integration._id — find yours via GET /connect/integrations
+             */
+            accountId: string;
+            /**
+             * Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.
+             */
+            content?: string;
+            platformSpecificData?: GoogleBusinessConfigurations;
+        }>;
+        /**
+         * Publish immediately. Required when scheduledFor is omitted.
+         */
+        publishNow?: boolean;
+        /**
+         * ISO 8601 datetime to schedule the post for future publishing
+         */
+        scheduledFor?: string;
+        /**
+         * IANA timezone for the scheduled time (e.g. America/New_York). Defaults to UTC.
+         */
+        timezone?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/posts/';
+};
+type PostV1PostsErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    402: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    403: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    503: {
+        success: boolean;
+        message: string;
+    };
+};
+type PostV1PostsError = PostV1PostsErrors[keyof PostV1PostsErrors];
+type PostV1PostsResponses = {
+    /**
+     * Default Response
+     */
+    202: {
+        /**
+         * false only when every platform failed
+         */
+        success: boolean;
+        status: 'draft' | 'pending' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'partial';
+        /**
+         * ISO 8601 datetime the post is scheduled for (only present for scheduled posts)
+         */
+        scheduledFor?: string;
+        /**
+         * id of the saved Post document
+         */
+        postId: string;
+        platforms: Array<{
+            platform: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+            /**
+             * For publish-now timeout fallback, true means the platform target was accepted and final status is still pending.
+             */
+            success: boolean;
+            /**
+             * Direct URL to the published post
+             */
+            platformPostUrl?: string;
+            /**
+             * Error message when success is false
+             */
+            error?: string;
+            /**
+             * Warning message when the post published but a non-critical follow-up action failed
+             */
+            warningMessage?: string;
+        }>;
+    };
+};
+type PostV1PostsResponse = PostV1PostsResponses[keyof PostV1PostsResponses];
+type DeleteV1PostsByPostIdData = {
+    body?: never;
+    path: {
+        /**
+         * Post identifier
+         */
+        postId: string;
+    };
+    query?: {
+        /**
+         * When true, also delete supported published platform posts. Costs 1 credit per successful platform deletion.
+         */
+        deleteFromPlatforms?: boolean;
+    };
+    url: '/v1/posts/{postId}';
+};
+type DeleteV1PostsByPostIdErrors = {
+    /**
+     * Default Response
+     */
+    402: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    404: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    409: {
+        success: boolean;
+        message: string;
+    };
+};
+type DeleteV1PostsByPostIdError = DeleteV1PostsByPostIdErrors[keyof DeleteV1PostsByPostIdErrors];
+type DeleteV1PostsByPostIdResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        creditsCharged?: number;
+        platforms?: Array<{
+            platform: string;
+            integrationId: string;
+            platformPostId: string | null;
+            status: string;
+            success: boolean;
+            message?: string;
+            errorMessage?: string;
+        }>;
+    };
+};
+type DeleteV1PostsByPostIdResponse = DeleteV1PostsByPostIdResponses[keyof DeleteV1PostsByPostIdResponses];
+type GetV1PostsByPostIdData = {
+    body?: never;
+    path: {
+        /**
+         * Post identifier
+         */
+        postId: string;
+    };
+    query?: never;
+    url: '/v1/posts/{postId}';
+};
+type GetV1PostsByPostIdErrors = {
+    /**
+     * Default Response
+     */
+    404: {
+        success: boolean;
+        message: string;
+    };
+};
+type GetV1PostsByPostIdError = GetV1PostsByPostIdErrors[keyof GetV1PostsByPostIdErrors];
+type GetV1PostsByPostIdResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        post: {
+            /**
+             * MongoDB ObjectId of the Post document
+             */
+            postId: string;
+            content: string;
+            status: 'draft' | 'pending' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'partial';
+            /**
+             * ISO 8601 scheduled datetime
+             */
+            scheduledFor: string | null;
+            timezone: string;
+            mediaItems: Array<{
+                type: 'image' | 'video' | 'gif';
+                url: string;
+                filename: string;
+                size: number;
+                mimeType: string;
+            }>;
+            platforms: Array<{
+                platform: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+                status: 'draft' | 'pending' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'partial';
+                /**
+                 * Per-platform text override that was used for this platform. Null when the top-level `content` was used.
+                 */
+                content: string | null;
+                platformPostId: string | null;
+                /**
+                 * Direct URL to the published post
+                 */
+                platformPostUrl: string | null;
+                publishedAt: string | null;
+                errorMessage: string | null;
+                warningMessage: string | null;
+            }>;
+            crosspostingEnabled: boolean;
+            rawRequestBody: {
+                [key: string]: unknown;
+            };
+            createdAt: string;
+            updatedAt: string;
+        };
+    };
+};
+type GetV1PostsByPostIdResponse = GetV1PostsByPostIdResponses[keyof GetV1PostsByPostIdResponses];
+type GetV1PostsScheduledData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Page size (max 100)
+         */
+        limit?: number;
+        /**
+         * Number of scheduled posts to skip
+         */
+        offset?: number;
+        sort?: SortOrder;
+    };
+    url: '/v1/posts/scheduled/';
+};
+type GetV1PostsScheduledResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        /**
+         * Total matched scheduled posts across all pages
+         */
+        total: number;
+        posts: Array<{
+            /**
+             * MongoDB ObjectId of the Post document
+             */
+            postId: string;
+            /**
+             * Post text body
+             */
+            content: string;
+            /**
+             * ISO 8601 scheduled datetime
+             */
+            scheduledFor: string | null;
+            /**
+             * IANA timezone for the scheduled time
+             */
+            timezone: string;
+            /**
+             * Media attachments
+             */
+            mediaItems?: Array<{
+                type: 'image' | 'video' | 'gif' | 'document';
+                url: string;
+                /**
+                 * Thumbnail image URL for video items. Supported on YouTube regular videos (not Shorts). JPEG, PNG, or GIF, max 2 MB, min 640 px wide.
+                 */
+                thumbnail?: string;
+            }>;
+            platforms: Array<{
+                platform: 'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness';
+                status: 'draft' | 'pending' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'partial';
+            }>;
+            createdAt: string;
+        }>;
+    };
+};
+type GetV1PostsScheduledResponse = GetV1PostsScheduledResponses[keyof GetV1PostsScheduledResponses];
+type DeleteV1PostsScheduledByPostIdData = {
+    body?: never;
+    path: {
+        postId: string;
+    };
+    query?: never;
+    url: '/v1/posts/scheduled/{postId}';
+};
+type DeleteV1PostsScheduledByPostIdErrors = {
+    /**
+     * Default Response
+     */
+    404: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    409: {
+        success: boolean;
+        message: string;
+    };
+};
+type DeleteV1PostsScheduledByPostIdError = DeleteV1PostsScheduledByPostIdErrors[keyof DeleteV1PostsScheduledByPostIdErrors];
+type DeleteV1PostsScheduledByPostIdResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        message: string;
+    };
+};
+type DeleteV1PostsScheduledByPostIdResponse = DeleteV1PostsScheduledByPostIdResponses[keyof DeleteV1PostsScheduledByPostIdResponses];
+type PatchV1PostsScheduledByPostIdData = {
+    body: {
+        /**
+         * New ISO 8601 datetime to schedule the post
+         */
+        scheduledFor: string;
+        /**
+         * IANA timezone
+         */
+        timezone?: string;
+    };
+    path: {
+        postId: string;
+    };
+    query?: never;
+    url: '/v1/posts/scheduled/{postId}';
+};
+type PatchV1PostsScheduledByPostIdErrors = {
+    /**
+     * Default Response
+     */
+    404: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    409: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    503: {
+        success: boolean;
+        message: string;
+    };
+};
+type PatchV1PostsScheduledByPostIdError = PatchV1PostsScheduledByPostIdErrors[keyof PatchV1PostsScheduledByPostIdErrors];
+type PatchV1PostsScheduledByPostIdResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        message: string;
+        scheduledFor: string;
+    };
+};
+type PatchV1PostsScheduledByPostIdResponse = PatchV1PostsScheduledByPostIdResponses[keyof PatchV1PostsScheduledByPostIdResponses];
+type PostV1MediaUploadData = {
+    body: {
+        filename: string;
+        mimeType: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/media/upload';
+};
+type PostV1MediaUploadErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        success: boolean;
+        message: string;
+    };
+};
+type PostV1MediaUploadError = PostV1MediaUploadErrors[keyof PostV1MediaUploadErrors];
+type PostV1MediaUploadResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        data: {
+            uploadUrl: string;
+            publicUrl: string;
+        };
+    };
+};
+type PostV1MediaUploadResponse = PostV1MediaUploadResponses[keyof PostV1MediaUploadResponses];
+type GetV1AnalyticsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * PostPeer post ID or external platform post ID (auto-resolved). When omitted, returns a paginated list of all published posts with analytics.
+         */
+        postId?: string;
+        platform?: Platform;
+        /**
+         * Integration ID. Required for external ID lookups and source=platform.
+         */
+        accountId?: string;
+        /**
+         * Where the result came from. "postpeer" = posts published via PostPeer (stored in our DB). "platform" = fetched directly from the connected platform account.
+         */
+        source?: 'postpeer' | 'platform';
+        /**
+         * Inclusive start date (YYYY-MM-DD). Defaults to 90 days ago.
+         */
+        fromDate?: string;
+        /**
+         * Inclusive end date (YYYY-MM-DD). Defaults to today.
+         */
+        toDate?: string;
+        /**
+         * Sort results by this metric
+         */
+        sortBy?: 'date' | 'likes' | 'comments' | 'impressions' | 'views' | 'shares' | 'saves' | 'clicks' | 'engagement';
+        order?: SortOrder;
+        /**
+         * Page size (1-100)
+         */
+        limit?: number;
+        /**
+         * Page number
+         */
+        page?: number;
+    };
+    url: '/v1/analytics/';
+};
+type GetV1AnalyticsErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    402: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    404: {
+        success: boolean;
+        message: string;
+    };
+};
+type GetV1AnalyticsError = GetV1AnalyticsErrors[keyof GetV1AnalyticsErrors];
+type GetV1AnalyticsResponses = {
+    /**
+     * Single-post response (when postId is supplied) or paginated list response.
+     */
+    200: {
+        success: boolean;
+        post: {
+            /**
+             * Where the result came from. "postpeer" = posts published via PostPeer (stored in our DB). "platform" = fetched directly from the connected platform account.
+             */
+            source: 'postpeer' | 'platform';
+            /**
+             * PostPeer post ID. null when source=platform (post fetched directly from the platform).
+             */
+            postId: string | null;
+            content: string | null;
+            publishedAt: string | null;
+            aggregated: {
+                impressions: number | null;
+                reach: number | null;
+                likes: number | null;
+                comments: number | null;
+                shares: number | null;
+                saves: number | null;
+                clicks: number | null;
+                views: number | null;
+                /**
+                 * Engagement rate (0-1). null when the platform does not report engagement.
+                 */
+                engagementRate: number | null;
+            };
+            platforms: Array<{
+                platform: Platform;
+                /**
+                 * Native post ID on the platform
+                 */
+                platformPostId: string;
+                /**
+                 * Direct URL to the published post, if known
+                 */
+                platformPostUrl: string | null;
+                metrics: {
+                    impressions: number | null;
+                    reach: number | null;
+                    likes: number | null;
+                    comments: number | null;
+                    shares: number | null;
+                    saves: number | null;
+                    clicks: number | null;
+                    views: number | null;
+                    /**
+                     * Engagement rate (0-1). null when the platform does not report engagement.
+                     */
+                    engagementRate: number | null;
+                };
+            }>;
+        };
+    } | {
+        success: boolean;
+        /**
+         * Total matched posts across all pages
+         */
+        total: number;
+        page: number;
+        limit: number;
+        posts: Array<{
+            /**
+             * Where the result came from. "postpeer" = posts published via PostPeer (stored in our DB). "platform" = fetched directly from the connected platform account.
+             */
+            source: 'postpeer' | 'platform';
+            /**
+             * PostPeer post ID. null when source=platform (post fetched directly from the platform).
+             */
+            postId: string | null;
+            content: string | null;
+            publishedAt: string | null;
+            aggregated: {
+                impressions: number | null;
+                reach: number | null;
+                likes: number | null;
+                comments: number | null;
+                shares: number | null;
+                saves: number | null;
+                clicks: number | null;
+                views: number | null;
+                /**
+                 * Engagement rate (0-1). null when the platform does not report engagement.
+                 */
+                engagementRate: number | null;
+            };
+            platforms: Array<{
+                platform: Platform;
+                /**
+                 * Native post ID on the platform
+                 */
+                platformPostId: string;
+                /**
+                 * Direct URL to the published post, if known
+                 */
+                platformPostUrl: string | null;
+                metrics: {
+                    impressions: number | null;
+                    reach: number | null;
+                    likes: number | null;
+                    comments: number | null;
+                    shares: number | null;
+                    saves: number | null;
+                    clicks: number | null;
+                    views: number | null;
+                    /**
+                     * Engagement rate (0-1). null when the platform does not report engagement.
+                     */
+                    engagementRate: number | null;
+                };
+            }>;
+        }>;
+    };
+};
+type GetV1AnalyticsResponse = GetV1AnalyticsResponses[keyof GetV1AnalyticsResponses];
+type GetV1UsageData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Return usage for this profile only. Mutually exclusive with integrationId.
+         */
+        profileId?: string;
+        /**
+         * Return usage for this integration only. Mutually exclusive with profileId.
+         */
+        integrationId?: string;
+        /**
+         * Inclusive start month (YYYY-MM). Filters the usage history array.
+         */
+        from?: string;
+        /**
+         * Inclusive end month (YYYY-MM). Filters the usage history array.
+         */
+        to?: string;
+    };
+    url: '/v1/usage/';
+};
+type GetV1UsageErrors = {
+    /**
+     * Default Response
+     */
+    400: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    404: {
+        success: boolean;
+        message: string;
+    };
+};
+type GetV1UsageError = GetV1UsageErrors[keyof GetV1UsageErrors];
+type GetV1UsageResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        /**
+         * All-time credits used
+         */
+        totalUsage: number;
+        /**
+         * Monthly credit history, oldest first
+         */
+        usage: Array<{
+            /**
+             * Calendar year
+             */
+            year: number;
+            /**
+             * Calendar month (1–12)
+             */
+            month: number;
+            /**
+             * Credits used this month
+             */
+            count: number;
+            /**
+             * Credits broken down by platform name
+             */
+            platform: {
+                [key: string]: number;
+            };
+        }>;
+        /**
+         * Current credit balance. Only present on project-level requests (no profileId or integrationId filter).
+         */
+        balance?: {
+            monthly: {
+                /**
+                 * Total monthly credits included in your plan
+                 */
+                limit: number;
+                /**
+                 * Monthly credits used so far this billing cycle
+                 */
+                used: number;
+                /**
+                 * Monthly credits still available this cycle
+                 */
+                remaining: number;
+                /**
+                 * Start of the current billing cycle
+                 */
+                cycleStart: string;
+                /**
+                 * End of the current billing cycle — resets here
+                 */
+                cycleEnd: string;
+            };
+            purchased: {
+                /**
+                 * Total one-time credits purchased (never expire)
+                 */
+                total: number;
+                /**
+                 * One-time credits consumed so far
+                 */
+                used: number;
+                /**
+                 * One-time credits still available
+                 */
+                remaining: number;
+            };
+        };
+    };
+};
+type GetV1UsageResponse = GetV1UsageResponses[keyof GetV1UsageResponses];
+type GetV1PinterestBoardsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Integration ID of the Pinterest account. If omitted, uses the first connected Pinterest account.
+         */
+        accountId?: string;
+    };
+    url: '/v1/pinterest/boards';
+};
+type GetV1PinterestBoardsErrors = {
+    /**
+     * Default Response
+     */
+    404: {
+        error: string;
+    };
+    /**
+     * Default Response
+     */
+    502: {
+        error: string;
+    };
+};
+type GetV1PinterestBoardsError = GetV1PinterestBoardsErrors[keyof GetV1PinterestBoardsErrors];
+type GetV1PinterestBoardsResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        boards: Array<{
+            id: string;
+            name: string;
+            description: string | null;
+            privacy: string;
+        }>;
+    };
+};
+type GetV1PinterestBoardsResponse = GetV1PinterestBoardsResponses[keyof GetV1PinterestBoardsResponses];
+type GetV1TiktokCreatorInfoData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Integration ID of the TikTok account. If omitted, uses the first connected TikTok account.
+         */
+        accountId?: string;
+    };
+    url: '/v1/tiktok/creator-info';
+};
+type GetV1TiktokCreatorInfoErrors = {
+    /**
+     * Default Response
+     */
+    404: {
+        error: string;
+    };
+    /**
+     * Default Response
+     */
+    502: {
+        error: string;
+    };
+};
+type GetV1TiktokCreatorInfoError = GetV1TiktokCreatorInfoErrors[keyof GetV1TiktokCreatorInfoErrors];
+type GetV1TiktokCreatorInfoResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        data?: {
+            /**
+             * Profile avatar URL returned by TikTok.
+             */
+            creatorAvatarUrl: string | unknown;
+            /**
+             * Username (@handle) of the creator.
+             */
+            creatorUsername: string | unknown;
+            /**
+             * Display name of the creator.
+             */
+            creatorNickname: string | unknown;
+            /**
+             * Privacy levels available to this creator. Your UX must restrict the privacy dropdown to these values.
+             */
+            privacyLevelOptions: Array<'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY'>;
+            /**
+             * If true, the creator has disabled comments in their app settings — grey out the Allow Comment toggle.
+             */
+            commentDisabled: boolean;
+            /**
+             * If true, the creator has disabled duet in their app settings — grey out the Allow Duet toggle.
+             */
+            duetDisabled: boolean;
+            /**
+             * If true, the creator has disabled stitch in their app settings — grey out the Allow Stitch toggle.
+             */
+            stitchDisabled: boolean;
+            /**
+             * Maximum video duration (in seconds) this creator may post. Reject videos longer than this before upload.
+             */
+            maxVideoPostDurationSec: number;
+        };
+        error?: string;
+    };
+};
+type GetV1TiktokCreatorInfoResponse = GetV1TiktokCreatorInfoResponses[keyof GetV1TiktokCreatorInfoResponses];
+type PostV1AiWriteData = {
+    body: {
+        /**
+         * Free-form description of what the post should be about, in the creator's own words.
+         */
+        description: string;
+        /**
+         * Platforms this post will target. Used to fit the strictest character limit.
+         */
+        platforms?: Array<'twitter' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'linkedin' | 'bluesky' | 'facebook' | 'threads' | 'googlebusiness'>;
+        /**
+         * Optional existing draft to rewrite/improve rather than start from scratch.
+         */
+        existingContent?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/ai/write';
+};
+type PostV1AiWriteErrors = {
+    /**
+     * Default Response
+     */
+    402: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    500: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    503: {
+        success: boolean;
+        message: string;
+    };
+};
+type PostV1AiWriteError = PostV1AiWriteErrors[keyof PostV1AiWriteErrors];
+type PostV1AiWriteResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        content: string;
+        creditsCharged: number;
+    };
+};
+type PostV1AiWriteResponse = PostV1AiWriteResponses[keyof PostV1AiWriteResponses];
+type PostV1AiImageData = {
+    body: {
+        description: string;
+        /**
+         * Output aspect ratio. Defaults to square when omitted.
+         */
+        aspectRatio?: 'square' | 'vertical' | 'landscape';
+        /**
+         * Visual style preset. Adds style guidance to the prompt. Omit for the model to pick whatever fits the brief.
+         */
+        style?: 'photo' | 'illustration' | 'minimal' | 'vibrant' | 'cinematic' | '3d-render' | 'retro' | 'hand-drawn';
+        /**
+         * Reference images. Used as style/vibe inspiration ONLY. The model will not copy them. Useful for "match my brand look" or "same composition as this".
+         */
+        referenceImageUrls?: Array<string>;
+        /**
+         * Asset images that MUST appear in the generated image (e.g. a brand logo, a specific product photo). The model will place them faithfully according to the brief, without redrawing them.
+         */
+        assetImageUrls?: Array<string>;
+        /**
+         * DEPRECATED: use referenceImageUrls instead. Still accepted for backwards compatibility.
+         */
+        referenceImageUrl?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/ai/image';
+};
+type PostV1AiImageErrors = {
+    /**
+     * Default Response
+     */
+    402: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    500: {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Default Response
+     */
+    503: {
+        success: boolean;
+        message: string;
+    };
+};
+type PostV1AiImageError = PostV1AiImageErrors[keyof PostV1AiImageErrors];
+type PostV1AiImageResponses = {
+    /**
+     * Default Response
+     */
+    200: {
+        success: boolean;
+        url: string;
+        mimeType: string;
+        creditsCharged: number;
+    };
+};
+type PostV1AiImageResponse = PostV1AiImageResponses[keyof PostV1AiImageResponses];
+
+type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options$1<TData, ThrowOnError, TResponse> & {
+    /**
+     * You can provide a client instance returned by `createClient()` instead of
+     * individual options. This might be also useful if you want to implement a
+     * custom client.
+     */
+    client?: Client;
+    /**
+     * You can pass arbitrary values through the `meta` object. This can be
+     * used to access values that aren't defined as part of the SDK function.
+     */
+    meta?: keyof ClientMeta extends never ? Record<string, unknown> : ClientMeta;
+};
+declare class HeyApiClient {
+    protected client: Client;
+    constructor(args?: {
+        client?: Client;
+    });
+}
+declare class HeyApiRegistry<T> {
+    private readonly defaultKey;
+    private readonly instances;
+    get(key?: string): T;
+    set(value: T, key?: string): void;
+}
+declare class Health extends HeyApiClient {
+    /**
+     * Health check
+     */
+    check<ThrowOnError extends boolean = false>(options?: Options<GetV1HealthData, ThrowOnError>): RequestResult<GetV1HealthResponses, unknown, ThrowOnError>;
+    /**
+     * Verify that the provided access key is valid
+     */
+    verifyAccessKey<ThrowOnError extends boolean = false>(options?: Options<GetV1HealthAuthData, ThrowOnError>): RequestResult<GetV1HealthAuthResponses, unknown, ThrowOnError>;
+}
+declare class Linkedin extends HeyApiClient {
+    /**
+     * Get pending LinkedIn account choices for headless mode
+     *
+     * Use only when starting LinkedIn OAuth with headless=true and the callback redirects to your redirectUri with status=selection_required and selectionToken. Returns the personal profile and organization pages available for the user to choose from.
+     */
+    getSelection<ThrowOnError extends boolean = false>(options: Options<GetV1ConnectLinkedinSelectionByTokenData, ThrowOnError>): RequestResult<GetV1ConnectLinkedinSelectionByTokenResponses, GetV1ConnectLinkedinSelectionByTokenErrors, ThrowOnError>;
+    /**
+     * Save selected LinkedIn accounts for headless mode
+     *
+     * Use only after GET /v1/connect/linkedin/selection/:token in a headless LinkedIn connect flow. Saves the selected personal profile and/or organization pages, then invalidates the one-time selection token.
+     */
+    submitSelection<ThrowOnError extends boolean = false>(options: Options<PostV1ConnectLinkedinSelectionByTokenData, ThrowOnError>): RequestResult<PostV1ConnectLinkedinSelectionByTokenResponses, PostV1ConnectLinkedinSelectionByTokenErrors, ThrowOnError>;
+}
+declare class Integrations extends HeyApiClient {
+    /**
+     * List integrations connected to this project
+     */
+    list<ThrowOnError extends boolean = false>(options?: Options<GetV1ConnectIntegrationsData, ThrowOnError>): RequestResult<GetV1ConnectIntegrationsResponses, unknown, ThrowOnError>;
+    /**
+     * Disconnect a platform integration
+     */
+    disconnect<ThrowOnError extends boolean = false>(options: Options<DeleteV1ConnectIntegrationsByIdData, ThrowOnError>): RequestResult<DeleteV1ConnectIntegrationsByIdResponses, DeleteV1ConnectIntegrationsByIdErrors, ThrowOnError>;
+}
+declare class Connect extends HeyApiClient {
+    /**
+     * Get OAuth URL for a platform
+     *
+     * Initiates an OAuth connection flow. By default, PostPeer hosts any required account selection UI and then returns the user to redirectUri. For LinkedIn custom account-selection UI, pass headless=true; if selection is required, the callback redirects to redirectUri with status=selection_required, platform=linkedin, and selectionToken.
+     */
+    getOAuthUrl<ThrowOnError extends boolean = false>(options: Options<GetV1ConnectByPlatformData, ThrowOnError>): RequestResult<GetV1ConnectByPlatformResponses, GetV1ConnectByPlatformErrors, ThrowOnError>;
+    /**
+     * Connect a Bluesky account via app password
+     *
+     * Bluesky has no OAuth redirect. Have the user generate an app password at https://bsky.app/settings/app-passwords, then submit it here.
+     */
+    bluesky<ThrowOnError extends boolean = false>(options: Options<PostV1ConnectBlueskyAuthData, ThrowOnError>): RequestResult<unknown, PostV1ConnectBlueskyAuthErrors, ThrowOnError>;
+    private _linkedin?;
+    get linkedin(): Linkedin;
+    private _integrations?;
+    get integrations(): Integrations;
+}
+declare class Profiles extends HeyApiClient {
+    /**
+     * List profiles for this project
+     */
+    list<ThrowOnError extends boolean = false>(options?: Options<GetV1ProfilesData, ThrowOnError>): RequestResult<GetV1ProfilesResponses, unknown, ThrowOnError>;
+    /**
+     * Create a profile
+     *
+     * Profiles group integrations under a label. Pass the returned `id` as `profileId` when calling /v1/connect/:platform to bind the resulting integration to this profile.
+     */
+    create<ThrowOnError extends boolean = false>(options: Options<PostV1ProfilesData, ThrowOnError>): RequestResult<PostV1ProfilesResponses, unknown, ThrowOnError>;
+    /**
+     * Delete a profile
+     *
+     * Soft-deletes the profile. Existing integrations bound to it keep their profileId — they are not orphaned, but listing /v1/profiles will no longer surface this row.
+     */
+    delete<ThrowOnError extends boolean = false>(options: Options<DeleteV1ProfilesByIdData, ThrowOnError>): RequestResult<DeleteV1ProfilesByIdResponses, DeleteV1ProfilesByIdErrors, ThrowOnError>;
+    /**
+     * Get a single profile
+     */
+    get<ThrowOnError extends boolean = false>(options: Options<GetV1ProfilesByIdData, ThrowOnError>): RequestResult<GetV1ProfilesByIdResponses, GetV1ProfilesByIdErrors, ThrowOnError>;
+    /**
+     * Update a profile
+     */
+    update<ThrowOnError extends boolean = false>(options: Options<PatchV1ProfilesByIdData, ThrowOnError>): RequestResult<PatchV1ProfilesByIdResponses, PatchV1ProfilesByIdErrors, ThrowOnError>;
+}
+declare class Apps extends HeyApiClient {
+    /**
+     * List registered OAuth apps for this project
+     */
+    list<ThrowOnError extends boolean = false>(options?: Options<GetV1AppsData, ThrowOnError>): RequestResult<GetV1AppsResponses, unknown, ThrowOnError>;
+    /**
+     * Register your own OAuth app (Bring Your Own Keys)
+     *
+     * Store the client credentials of your own OAuth app for a platform. Pass the returned `id` as `appId` when calling /v1/connect/:platform to connect accounts under it.
+     */
+    create<ThrowOnError extends boolean = false>(options: Options<PostV1AppsData, ThrowOnError>): RequestResult<PostV1AppsResponses, PostV1AppsErrors, ThrowOnError>;
+    /**
+     * Delete an OAuth app
+     *
+     * Deletes the app. Blocked with 409 while active integrations are still connected under it — those integrations rely on the app for token refresh. Disconnect or reconnect them first.
+     */
+    delete<ThrowOnError extends boolean = false>(options: Options<DeleteV1AppsByIdData, ThrowOnError>): RequestResult<DeleteV1AppsByIdResponses, DeleteV1AppsByIdErrors, ThrowOnError>;
+    /**
+     * Get a single OAuth app
+     */
+    get<ThrowOnError extends boolean = false>(options: Options<GetV1AppsByIdData, ThrowOnError>): RequestResult<GetV1AppsByIdResponses, GetV1AppsByIdErrors, ThrowOnError>;
+    /**
+     * Update an OAuth app
+     *
+     * Change the name, image, or rotate the client secret. The clientId and platform are immutable: a refresh token is bound to the clientId that issued it, so changing the app would brick existing integrations — create a new OAuth app and reconnect instead.
+     */
+    update<ThrowOnError extends boolean = false>(options: Options<PatchV1AppsByIdData, ThrowOnError>): RequestResult<PatchV1AppsByIdResponses, PatchV1AppsByIdErrors, ThrowOnError>;
+}
+declare class Notifications extends HeyApiClient {
+    /**
+     * Test a notification destination before saving it
+     */
+    test<ThrowOnError extends boolean = false>(options: Options<PostV1NotificationsTestData, ThrowOnError>): RequestResult<PostV1NotificationsTestResponses, PostV1NotificationsTestErrors, ThrowOnError>;
+    /**
+     * List notification subscriptions
+     */
+    list<ThrowOnError extends boolean = false>(options?: Options<GetV1NotificationsData, ThrowOnError>): RequestResult<GetV1NotificationsResponses, unknown, ThrowOnError>;
+    /**
+     * Create a notification subscription
+     */
+    create<ThrowOnError extends boolean = false>(options: Options<PostV1NotificationsData, ThrowOnError>): RequestResult<PostV1NotificationsResponses, PostV1NotificationsErrors, ThrowOnError>;
+    /**
+     * Delete a notification subscription
+     */
+    delete<ThrowOnError extends boolean = false>(options: Options<DeleteV1NotificationsByIdData, ThrowOnError>): RequestResult<DeleteV1NotificationsByIdResponses, DeleteV1NotificationsByIdErrors, ThrowOnError>;
+    /**
+     * Get a notification subscription
+     */
+    get<ThrowOnError extends boolean = false>(options: Options<GetV1NotificationsByIdData, ThrowOnError>): RequestResult<GetV1NotificationsByIdResponses, GetV1NotificationsByIdErrors, ThrowOnError>;
+    /**
+     * Update a notification subscription
+     */
+    update<ThrowOnError extends boolean = false>(options: Options<PatchV1NotificationsByIdData, ThrowOnError>): RequestResult<PatchV1NotificationsByIdResponses, PatchV1NotificationsByIdErrors, ThrowOnError>;
+}
+declare class Platforms extends HeyApiClient {
+    /**
+     * List available platforms and their status
+     */
+    list<ThrowOnError extends boolean = false>(options?: Options<GetV1PlatformsData, ThrowOnError>): RequestResult<GetV1PlatformsResponses, unknown, ThrowOnError>;
+}
+declare class Scheduled extends HeyApiClient {
+    /**
+     * List all scheduled posts
+     *
+     * Returns a paginated list of scheduled posts. Use `limit` + `offset` to page through the results.
+     */
+    list<ThrowOnError extends boolean = false>(options?: Options<GetV1PostsScheduledData, ThrowOnError>): RequestResult<GetV1PostsScheduledResponses, unknown, ThrowOnError>;
+    /**
+     * Cancel a scheduled post (moves it back to draft)
+     */
+    cancel<ThrowOnError extends boolean = false>(options: Options<DeleteV1PostsScheduledByPostIdData, ThrowOnError>): RequestResult<DeleteV1PostsScheduledByPostIdResponses, DeleteV1PostsScheduledByPostIdErrors, ThrowOnError>;
+    /**
+     * Reschedule a post to a new time
+     */
+    reschedule<ThrowOnError extends boolean = false>(options: Options<PatchV1PostsScheduledByPostIdData, ThrowOnError>): RequestResult<PatchV1PostsScheduledByPostIdResponses, PatchV1PostsScheduledByPostIdErrors, ThrowOnError>;
+}
+declare class Posts extends HeyApiClient {
+    /**
+     * List all posts for the project
+     *
+     * Returns a paginated list of posts. Filter by status, platform (OR logic), and date ranges. Published posts include platformPostUrl per platform.
+     */
+    list<ThrowOnError extends boolean = false>(options?: Options<GetV1PostsData, ThrowOnError>): RequestResult<GetV1PostsResponses, GetV1PostsErrors, ThrowOnError>;
+    /**
+     * Publish a post to one or more social media platforms
+     */
+    create<ThrowOnError extends boolean = false>(options: Options<PostV1PostsData, ThrowOnError>): RequestResult<PostV1PostsResponses, PostV1PostsErrors, ThrowOnError>;
+    /**
+     * Delete a post by ID
+     */
+    delete<ThrowOnError extends boolean = false>(options: Options<DeleteV1PostsByPostIdData, ThrowOnError>): RequestResult<DeleteV1PostsByPostIdResponses, DeleteV1PostsByPostIdErrors, ThrowOnError>;
+    /**
+     * Get a single post by ID
+     */
+    get<ThrowOnError extends boolean = false>(options: Options<GetV1PostsByPostIdData, ThrowOnError>): RequestResult<GetV1PostsByPostIdResponses, GetV1PostsByPostIdErrors, ThrowOnError>;
+    private _scheduled?;
+    get scheduled(): Scheduled;
+}
+declare class Media extends HeyApiClient {
+    /**
+     * Get a presigned S3 URL to upload a media file
+     */
+    upload<ThrowOnError extends boolean = false>(options: Options<PostV1MediaUploadData, ThrowOnError>): RequestResult<PostV1MediaUploadResponses, PostV1MediaUploadErrors, ThrowOnError>;
+}
+declare class Analytics extends HeyApiClient {
+    /**
+     * Get post analytics
+     *
+     * With postId, returns analytics for a single post. Without postId, returns a paginated list of published posts with analytics. Accepts both PostPeer post IDs and external platform post IDs (auto-resolved). fromDate defaults to 90 days ago if omitted, max range 366 days. Each call costs 1 credit.
+     */
+    get<ThrowOnError extends boolean = false>(options?: Options<GetV1AnalyticsData, ThrowOnError>): RequestResult<GetV1AnalyticsResponses, GetV1AnalyticsErrors, ThrowOnError>;
+}
+declare class Usage extends HeyApiClient {
+    /**
+     * Get credit usage
+     *
+     * Returns credit usage history for the project. Without filters, returns project-level totals. Add `profileId` to scope to a specific profile, or `integrationId` to scope to a specific connected account. Use `from`/`to` (YYYY-MM) to slice the history. Each entry contains the monthly credit count and a per-platform breakdown.
+     */
+    get<ThrowOnError extends boolean = false>(options?: Options<GetV1UsageData, ThrowOnError>): RequestResult<GetV1UsageResponses, GetV1UsageErrors, ThrowOnError>;
+}
+declare class Pinterest extends HeyApiClient {
+    /**
+     * List Pinterest boards for a connected account
+     */
+    getBoards<ThrowOnError extends boolean = false>(options?: Options<GetV1PinterestBoardsData, ThrowOnError>): RequestResult<GetV1PinterestBoardsResponses, GetV1PinterestBoardsErrors, ThrowOnError>;
+}
+declare class Tiktok extends HeyApiClient {
+    /**
+     * Fetch TikTok creator info for a connected account
+     *
+     * Proxies TikTok's /v2/post/publish/creator_info/query/ endpoint. Use the returned `privacyLevelOptions`, `commentDisabled`, `duetDisabled`, `stitchDisabled`, and `maxVideoPostDurationSec` to build a compliant "Post to TikTok" UX.
+     */
+    getCreatorInfo<ThrowOnError extends boolean = false>(options?: Options<GetV1TiktokCreatorInfoData, ThrowOnError>): RequestResult<GetV1TiktokCreatorInfoResponses, GetV1TiktokCreatorInfoErrors, ThrowOnError>;
+}
+declare class Ai extends HeyApiClient {
+    /**
+     * Generate a social media caption from a description
+     *
+     * Generates a caption tailored to the platforms you'll post to. Costs 2 credits per successful generation. Failed calls do not deduct credits.
+     */
+    write<ThrowOnError extends boolean = false>(options: Options<PostV1AiWriteData, ThrowOnError>): RequestResult<PostV1AiWriteResponses, PostV1AiWriteErrors, ThrowOnError>;
+    /**
+     * Generate a social media image from a description
+     *
+     * Generates a square or vertical image suitable for social media. Costs 10 credits per successful generation. Failed calls do not deduct credits.
+     */
+    generateImage<ThrowOnError extends boolean = false>(options: Options<PostV1AiImageData, ThrowOnError>): RequestResult<PostV1AiImageResponses, PostV1AiImageErrors, ThrowOnError>;
+}
+declare class PostPeerApi extends HeyApiClient {
+    static readonly __registry: HeyApiRegistry<PostPeerApi>;
+    constructor(args?: {
+        client?: Client;
+        key?: string;
+    });
+    private _health?;
+    get health(): Health;
+    private _connect?;
+    get connect(): Connect;
+    private _profiles?;
+    get profiles(): Profiles;
+    private _apps?;
+    get apps(): Apps;
+    private _notifications?;
+    get notifications(): Notifications;
+    private _platforms?;
+    get platforms(): Platforms;
+    private _posts?;
+    get posts(): Posts;
+    private _media?;
+    get media(): Media;
+    private _analytics?;
+    get analytics(): Analytics;
+    private _usage?;
+    get usage(): Usage;
+    private _pinterest?;
+    get pinterest(): Pinterest;
+    private _tiktok?;
+    get tiktok(): Tiktok;
+    private _ai?;
+    get ai(): Ai;
+}
+
+interface ClientOptions {
+    /** Defaults to `process.env.POSTPEER_API_KEY`. */
+    apiKey?: string;
+    /** @default "https://api.postpeer.dev" */
+    baseURL?: string;
+    /** Request timeout in milliseconds. @default 60000 */
+    timeout?: number;
+    /** Number of retries for transient failures. @default 2 */
+    maxRetries?: number;
+    defaultHeaders?: HeadersInit;
+    fetch?: typeof globalThis.fetch;
+}
+/** The official Node.js client for the PostPeer API. */
+declare class PostPeer extends PostPeerApi {
+    #private;
+    static readonly DEFAULT_TIMEOUT = 60000;
+    static readonly DEFAULT_MAX_RETRIES = 2;
+    readonly apiKey: string;
+    readonly baseURL: string;
+    readonly timeout: number;
+    readonly maxRetries: number;
+    readonly rawClient: Client;
+    constructor(options?: ClientOptions);
+    withOptions(options: Partial<ClientOptions>): PostPeer;
+}
+
+declare class PostPeerError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+declare class APIError extends PostPeerError {
+    readonly status: number;
+    readonly code?: string;
+    readonly details?: unknown;
+    readonly requestId?: string;
+    readonly headers: Headers;
+    constructor(status: number, message: string, options?: {
+        code?: string;
+        details?: unknown;
+        headers?: Headers;
+        requestId?: string;
+        cause?: unknown;
+    });
+}
+declare class BadRequestError extends APIError {
+}
+declare class AuthenticationError extends APIError {
+}
+declare class PermissionDeniedError extends APIError {
+}
+declare class NotFoundError extends APIError {
+}
+declare class ConflictError extends APIError {
+}
+declare class UnprocessableEntityError extends APIError {
+}
+declare class RateLimitError extends APIError {
+}
+declare class InternalServerError extends APIError {
+}
+declare class APIConnectionError extends PostPeerError {
+    constructor(message?: string, options?: ErrorOptions);
+}
+declare class APIConnectionTimeoutError extends APIConnectionError {
+    constructor(options?: ErrorOptions);
+}
+declare class APIUserAbortError extends APIConnectionError {
+    constructor(options?: ErrorOptions);
+}
+
+declare const VERSION = "0.8.0";
+
+export { APIConnectionError, APIConnectionTimeoutError, APIError, APIUserAbortError, AuthenticationError, BadRequestError, type BlueskyConfigurations, type ClientOptions, ConflictError, type DeleteV1AppsByIdData, type DeleteV1AppsByIdError, type DeleteV1AppsByIdErrors, type DeleteV1AppsByIdResponse, type DeleteV1AppsByIdResponses, type DeleteV1ConnectIntegrationsByIdData, type DeleteV1ConnectIntegrationsByIdError, type DeleteV1ConnectIntegrationsByIdErrors, type DeleteV1ConnectIntegrationsByIdResponse, type DeleteV1ConnectIntegrationsByIdResponses, type DeleteV1NotificationsByIdData, type DeleteV1NotificationsByIdError, type DeleteV1NotificationsByIdErrors, type DeleteV1NotificationsByIdResponse, type DeleteV1NotificationsByIdResponses, type DeleteV1PostsByPostIdData, type DeleteV1PostsByPostIdError, type DeleteV1PostsByPostIdErrors, type DeleteV1PostsByPostIdResponse, type DeleteV1PostsByPostIdResponses, type DeleteV1PostsScheduledByPostIdData, type DeleteV1PostsScheduledByPostIdError, type DeleteV1PostsScheduledByPostIdErrors, type DeleteV1PostsScheduledByPostIdResponse, type DeleteV1PostsScheduledByPostIdResponses, type DeleteV1ProfilesByIdData, type DeleteV1ProfilesByIdError, type DeleteV1ProfilesByIdErrors, type DeleteV1ProfilesByIdResponse, type DeleteV1ProfilesByIdResponses, type ErrorResponse, type FacebookConfigurations, type GetV1AnalyticsData, type GetV1AnalyticsError, type GetV1AnalyticsErrors, type GetV1AnalyticsResponse, type GetV1AnalyticsResponses, type GetV1AppsByIdData, type GetV1AppsByIdError, type GetV1AppsByIdErrors, type GetV1AppsByIdResponse, type GetV1AppsByIdResponses, type GetV1AppsData, type GetV1AppsResponse, type GetV1AppsResponses, type GetV1ConnectByPlatformData, type GetV1ConnectByPlatformError, type GetV1ConnectByPlatformErrors, type GetV1ConnectByPlatformResponse, type GetV1ConnectByPlatformResponses, type GetV1ConnectIntegrationsData, type GetV1ConnectIntegrationsResponse, type GetV1ConnectIntegrationsResponses, type GetV1ConnectLinkedinSelectionByTokenData, type GetV1ConnectLinkedinSelectionByTokenError, type GetV1ConnectLinkedinSelectionByTokenErrors, type GetV1ConnectLinkedinSelectionByTokenResponse, type GetV1ConnectLinkedinSelectionByTokenResponses, type GetV1HealthAuthData, type GetV1HealthAuthResponse, type GetV1HealthAuthResponses, type GetV1HealthData, type GetV1HealthResponse, type GetV1HealthResponses, type GetV1NotificationsByIdData, type GetV1NotificationsByIdError, type GetV1NotificationsByIdErrors, type GetV1NotificationsByIdResponse, type GetV1NotificationsByIdResponses, type GetV1NotificationsData, type GetV1NotificationsResponse, type GetV1NotificationsResponses, type GetV1PinterestBoardsData, type GetV1PinterestBoardsError, type GetV1PinterestBoardsErrors, type GetV1PinterestBoardsResponse, type GetV1PinterestBoardsResponses, type GetV1PlatformsData, type GetV1PlatformsResponse, type GetV1PlatformsResponses, type GetV1PostsByPostIdData, type GetV1PostsByPostIdError, type GetV1PostsByPostIdErrors, type GetV1PostsByPostIdResponse, type GetV1PostsByPostIdResponses, type GetV1PostsData, type GetV1PostsError, type GetV1PostsErrors, type GetV1PostsResponse, type GetV1PostsResponses, type GetV1PostsScheduledData, type GetV1PostsScheduledResponse, type GetV1PostsScheduledResponses, type GetV1ProfilesByIdData, type GetV1ProfilesByIdError, type GetV1ProfilesByIdErrors, type GetV1ProfilesByIdResponse, type GetV1ProfilesByIdResponses, type GetV1ProfilesData, type GetV1ProfilesResponse, type GetV1ProfilesResponses, type GetV1TiktokCreatorInfoData, type GetV1TiktokCreatorInfoError, type GetV1TiktokCreatorInfoErrors, type GetV1TiktokCreatorInfoResponse, type GetV1TiktokCreatorInfoResponses, type GetV1UsageData, type GetV1UsageError, type GetV1UsageErrors, type GetV1UsageResponse, type GetV1UsageResponses, type GoogleBusinessConfigurations, type InstagramConfigurations, InternalServerError, type LinkedInConfigurations, NotFoundError, type PatchV1AppsByIdData, type PatchV1AppsByIdError, type PatchV1AppsByIdErrors, type PatchV1AppsByIdResponse, type PatchV1AppsByIdResponses, type PatchV1NotificationsByIdData, type PatchV1NotificationsByIdError, type PatchV1NotificationsByIdErrors, type PatchV1NotificationsByIdResponse, type PatchV1NotificationsByIdResponses, type PatchV1PostsScheduledByPostIdData, type PatchV1PostsScheduledByPostIdError, type PatchV1PostsScheduledByPostIdErrors, type PatchV1PostsScheduledByPostIdResponse, type PatchV1PostsScheduledByPostIdResponses, type PatchV1ProfilesByIdData, type PatchV1ProfilesByIdError, type PatchV1ProfilesByIdErrors, type PatchV1ProfilesByIdResponse, type PatchV1ProfilesByIdResponses, PermissionDeniedError, type PinterestConfigurations, type Platform, type PostPayload, PostPeer, PostPeerError, type PostV1AiImageData, type PostV1AiImageError, type PostV1AiImageErrors, type PostV1AiImageResponse, type PostV1AiImageResponses, type PostV1AiWriteData, type PostV1AiWriteError, type PostV1AiWriteErrors, type PostV1AiWriteResponse, type PostV1AiWriteResponses, type PostV1AppsData, type PostV1AppsError, type PostV1AppsErrors, type PostV1AppsResponse, type PostV1AppsResponses, type PostV1ConnectBlueskyAuthData, type PostV1ConnectBlueskyAuthError, type PostV1ConnectBlueskyAuthErrors, type PostV1ConnectLinkedinSelectionByTokenData, type PostV1ConnectLinkedinSelectionByTokenError, type PostV1ConnectLinkedinSelectionByTokenErrors, type PostV1ConnectLinkedinSelectionByTokenResponse, type PostV1ConnectLinkedinSelectionByTokenResponses, type PostV1MediaUploadData, type PostV1MediaUploadError, type PostV1MediaUploadErrors, type PostV1MediaUploadResponse, type PostV1MediaUploadResponses, type PostV1NotificationsData, type PostV1NotificationsError, type PostV1NotificationsErrors, type PostV1NotificationsResponse, type PostV1NotificationsResponses, type PostV1NotificationsTestData, type PostV1NotificationsTestError, type PostV1NotificationsTestErrors, type PostV1NotificationsTestResponse, type PostV1NotificationsTestResponses, type PostV1PostsData, type PostV1PostsError, type PostV1PostsErrors, type PostV1PostsResponse, type PostV1PostsResponses, type PostV1ProfilesData, type PostV1ProfilesResponse, type PostV1ProfilesResponses, RateLimitError, type SortOrder, type Status, type ThreadsConfigurations, type TikTokConfigurations, type TwitterConfigurations, UnprocessableEntityError, VERSION, type YouTubeConfigurations, PostPeer as default };