@crevio/sdk 0.4.22 → 0.5.1

package/src/sdk/socials.ts

@@ -0,0 +1,490 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { socialsAccountAnalytics } from "../funcs/socialsAccountAnalytics.js";
+import { socialsActivate } from "../funcs/socialsActivate.js";
+import { socialsComments } from "../funcs/socialsComments.js";
+import { socialsCommentsFeed } from "../funcs/socialsCommentsFeed.js";
+import { socialsConnect } from "../funcs/socialsConnect.js";
+import { socialsCreate } from "../funcs/socialsCreate.js";
+import { socialsDelete } from "../funcs/socialsDelete.js";
+import { socialsDeleteComment } from "../funcs/socialsDeleteComment.js";
+import { socialsDisconnect } from "../funcs/socialsDisconnect.js";
+import { socialsGet } from "../funcs/socialsGet.js";
+import { socialsHideComment } from "../funcs/socialsHideComment.js";
+import { socialsLabel } from "../funcs/socialsLabel.js";
+import { socialsLikeComment } from "../funcs/socialsLikeComment.js";
+import { socialsListAccounts } from "../funcs/socialsListAccounts.js";
+import { socialsListPosts } from "../funcs/socialsListPosts.js";
+import { socialsListUploads } from "../funcs/socialsListUploads.js";
+import { socialsPortal } from "../funcs/socialsPortal.js";
+import { socialsPostAnalytics } from "../funcs/socialsPostAnalytics.js";
+import { socialsPrivateReply } from "../funcs/socialsPrivateReply.js";
+import { socialsPublish } from "../funcs/socialsPublish.js";
+import { socialsReply } from "../funcs/socialsReply.js";
+import { socialsStatus } from "../funcs/socialsStatus.js";
+import { socialsSync } from "../funcs/socialsSync.js";
+import { socialsUnhideComment } from "../funcs/socialsUnhideComment.js";
+import { socialsUnlikeComment } from "../funcs/socialsUnlikeComment.js";
+import { socialsUpdate } from "../funcs/socialsUpdate.js";
+import { socialsUpload } from "../funcs/socialsUpload.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Socials extends ClientSDK {
+  /**
+   * Activate social posting
+   *
+   * @remarks
+   * Enables social posting for the current account. Idempotent. Requires an active subscription.
+   */
+  async activate(
+    options?: RequestOptions,
+  ): Promise<operations.ActivateSocialsResponse> {
+    return unwrapAsync(socialsActivate(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Get social status
+   *
+   * @remarks
+   * Returns whether social posting is activated and lists the connected accounts.
+   */
+  async status(
+    options?: RequestOptions,
+  ): Promise<operations.GetSocialsStatusResponse> {
+    return unwrapAsync(socialsStatus(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Sync connected accounts
+   *
+   * @remarks
+   * Refreshes the list of connected social accounts.
+   */
+  async sync(
+    options?: RequestOptions,
+  ): Promise<operations.SyncSocialsResponse> {
+    return unwrapAsync(socialsSync(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Get an OAuth connect URL
+   *
+   * @remarks
+   * Returns an OAuth URL to connect a social account on the given platform. Activates the account on first connect; requires an active subscription.
+   */
+  async connect(
+    request: operations.ConnectSocialAccountRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ConnectSocialAccountResponse> {
+    return unwrapAsync(socialsConnect(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Create a hosted connect portal
+   *
+   * @remarks
+   * A hosted multi-account connect portal is not offered; use POST /socials/connect for a per-platform OAuth URL.
+   */
+  async portal(
+    request: operations.CreateSocialsPortalRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(socialsPortal(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List connected accounts
+   *
+   * @remarks
+   * Lists all connected social accounts.
+   */
+  async listAccounts(
+    request?: operations.ListSocialAccountsRequest | undefined,
+    options?: RequestOptions,
+  ): Promise<operations.ListSocialAccountsResponse> {
+    return unwrapAsync(socialsListAccounts(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Disconnect an account
+   *
+   * @remarks
+   * Disconnects a social account.
+   */
+  async disconnect(
+    request: operations.DisconnectSocialAccountRequest,
+    options?: RequestOptions,
+  ): Promise<models.DeleteResponse> {
+    return unwrapAsync(socialsDisconnect(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Label an account
+   *
+   * @remarks
+   * Assigns a custom label to a connected account and returns it.
+   */
+  async label(
+    request: operations.LabelSocialAccountRequest,
+    options?: RequestOptions,
+  ): Promise<models.SocialAccount> {
+    return unwrapAsync(socialsLabel(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get account analytics
+   *
+   * @remarks
+   * Returns analytics for a connected account.
+   */
+  async accountAnalytics(
+    request: operations.GetSocialAccountAnalyticsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetSocialAccountAnalyticsResponse> {
+    return unwrapAsync(socialsAccountAnalytics(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List posts
+   *
+   * @remarks
+   * Lists social posts with optional status/date filtering and pagination.
+   */
+  async listPosts(
+    request?: operations.ListSocialPostsRequest | undefined,
+    options?: RequestOptions,
+  ): Promise<operations.ListSocialPostsResponse> {
+    return unwrapAsync(socialsListPosts(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Create a post
+   *
+   * @remarks
+   * Creates a draft post, or publishes/schedules it immediately when publish_now or scheduled_at is set.
+   */
+  async create(
+    request: operations.CreateSocialPostRequest,
+    options?: RequestOptions,
+  ): Promise<models.SocialPost> {
+    return unwrapAsync(socialsCreate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get a post
+   *
+   * @remarks
+   * Retrieves a single social post.
+   */
+  async get(
+    request: operations.GetSocialPostRequest,
+    options?: RequestOptions,
+  ): Promise<models.SocialPost> {
+    return unwrapAsync(socialsGet(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Edit a draft post
+   *
+   * @remarks
+   * Edits a draft post. Only posts in the draft status are editable.
+   */
+  async update(
+    request: operations.UpdateSocialPostRequest,
+    options?: RequestOptions,
+  ): Promise<models.SocialPost> {
+    return unwrapAsync(socialsUpdate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Delete a post
+   *
+   * @remarks
+   * Deletes a post; published posts are unpublished from their platforms first.
+   */
+  async delete(
+    request: operations.DeleteSocialPostRequest,
+    options?: RequestOptions,
+  ): Promise<models.DeleteResponse> {
+    return unwrapAsync(socialsDelete(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Publish a draft post
+   *
+   * @remarks
+   * Publishes a draft post immediately.
+   */
+  async publish(
+    request: operations.PublishSocialPostRequest,
+    options?: RequestOptions,
+  ): Promise<models.SocialPost> {
+    return unwrapAsync(socialsPublish(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get post analytics
+   *
+   * @remarks
+   * Returns per-post analytics. Null until the post is published.
+   */
+  async postAnalytics(
+    request: operations.GetSocialPostAnalyticsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetSocialPostAnalyticsResponse> {
+    return unwrapAsync(socialsPostAnalytics(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get post comments
+   *
+   * @remarks
+   * Returns comments on a published post.
+   */
+  async comments(
+    request: operations.GetSocialPostCommentsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetSocialPostCommentsResponse> {
+    return unwrapAsync(socialsComments(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Reply to a post or comment
+   *
+   * @remarks
+   * Posts a public reply to the post, or to a specific comment when comment_id is given. Published as the chosen connected account. Requires the post to be published.
+   */
+  async reply(
+    request: operations.ReplyToSocialPostRequest,
+    options?: RequestOptions,
+  ): Promise<{ [k: string]: any }> {
+    return unwrapAsync(socialsReply(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Delete a comment
+   *
+   * @remarks
+   * Deletes a comment on the post. Supported on Facebook, Instagram, Bluesky, Reddit, YouTube, and LinkedIn.
+   */
+  async deleteComment(
+    request: operations.DeleteSocialCommentRequest,
+    options?: RequestOptions,
+  ): Promise<operations.DeleteSocialCommentResponse> {
+    return unwrapAsync(socialsDeleteComment(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Like a comment
+   *
+   * @remarks
+   * Likes or upvotes a comment. Supported on Facebook, Twitter/X, Bluesky, and Reddit. Bluesky requires the comment cid.
+   */
+  async likeComment(
+    request: operations.LikeSocialCommentRequest,
+    options?: RequestOptions,
+  ): Promise<operations.LikeSocialCommentResponse> {
+    return unwrapAsync(socialsLikeComment(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Unlike a comment
+   *
+   * @remarks
+   * Removes a like from a comment. Supported on Facebook, Twitter/X, Bluesky, and Reddit. Bluesky requires the like_uri returned when liking.
+   */
+  async unlikeComment(
+    request: operations.UnlikeSocialCommentRequest,
+    options?: RequestOptions,
+  ): Promise<{ [k: string]: any }> {
+    return unwrapAsync(socialsUnlikeComment(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Hide a comment
+   *
+   * @remarks
+   * Hides a comment (visible only to its author and page admins). Supported on Facebook, Instagram, Threads, and X/Twitter.
+   */
+  async hideComment(
+    request: operations.HideSocialCommentRequest,
+    options?: RequestOptions,
+  ): Promise<operations.HideSocialCommentResponse> {
+    return unwrapAsync(socialsHideComment(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Unhide a comment
+   *
+   * @remarks
+   * Unhides a previously hidden comment. Supported on Facebook, Instagram, Threads, and X/Twitter.
+   */
+  async unhideComment(
+    request: operations.UnhideSocialCommentRequest,
+    options?: RequestOptions,
+  ): Promise<{ [k: string]: any }> {
+    return unwrapAsync(socialsUnhideComment(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Send a private reply
+   *
+   * @remarks
+   * Sends a private message to the author of a comment. Instagram and Facebook only; one reply per comment, within 7 days, text only.
+   */
+  async privateReply(
+    request: operations.PrivateReplySocialCommentRequest,
+    options?: RequestOptions,
+  ): Promise<operations.PrivateReplySocialCommentResponse> {
+    return unwrapAsync(socialsPrivateReply(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List comment activity
+   *
+   * @remarks
+   * Cross-account feed of posts with comment counts across all connected channels, for triaging where to engage. Paginates by opaque cursor (next_cursor).
+   */
+  async commentsFeed(
+    request?: operations.ListSocialCommentsRequest | undefined,
+    options?: RequestOptions,
+  ): Promise<operations.ListSocialCommentsResponse> {
+    return unwrapAsync(socialsCommentsFeed(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Upload media
+   *
+   * @remarks
+   * Uploads media from a public URL for use in posts.
+   */
+  async upload(
+    request: operations.UploadSocialMediaRequest,
+    options?: RequestOptions,
+  ): Promise<models.SocialUpload> {
+    return unwrapAsync(socialsUpload(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List uploads
+   *
+   * @remarks
+   * Lists previously uploaded media.
+   */
+  async listUploads(
+    request?: operations.ListSocialUploadsRequest | undefined,
+    options?: RequestOptions,
+  ): Promise<operations.ListSocialUploadsResponse> {
+    return unwrapAsync(socialsListUploads(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/status.ts

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { statusGet } from "../funcs/statusGet.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Status extends ClientSDK {
+  /**
+   * Get API status
+   *
+   * @remarks
+   * Authenticated self-check. A single call confirms the API is operational, your credentials are valid, and which account they resolve to (whoami). For credit balance and plan detail, use Get account usage.
+   */
+  async get(
+    options?: RequestOptions,
+  ): Promise<models.Status> {
+    return unwrapAsync(statusGet(
+      this,
+      options,
+    ));
+  }
+}

package/src/sdk/targeting.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { adsTargetingReachEstimate } from "../funcs/adsTargetingReachEstimate.js";
+import { adsTargetingSearch } from "../funcs/adsTargetingSearch.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Targeting extends ClientSDK {
+  /**
+   * Search targeting options
+   *
+   * @remarks
+   * Search interests, locations, behaviors, or income targeting for audience building.
+   */
+  async search(
+    request: operations.AdsTargetingSearchRequest,
+    options?: RequestOptions,
+  ): Promise<operations.AdsTargetingSearchResponse> {
+    return unwrapAsync(adsTargetingSearch(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Estimate audience reach
+   *
+   * @remarks
+   * Pre-flight audience size for a targeting spec.
+   */
+  async reachEstimate(
+    request: operations.AdsTargetingReachEstimateRequest,
+    options?: RequestOptions,
+  ): Promise<{ [k: string]: any }> {
+    return unwrapAsync(adsTargetingReachEstimate(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/usage.ts

@@ -0,0 +1,44 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { usageGet } from "../funcs/usageGet.js";
+import { usageTransactions } from "../funcs/usageTransactions.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Usage extends ClientSDK {
+  /**
+   * Get account usage
+   *
+   * @remarks
+   * Returns the authenticated account's credit balance, plan status, and credit spend for the current billing period broken down by operation.
+   */
+  async get(
+    options?: RequestOptions,
+  ): Promise<models.Usage> {
+    return unwrapAsync(usageGet(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * List usage transactions
+   *
+   * @remarks
+   * Returns the account's raw credit ledger (newest first), cursor-paginated. Spends are negative; grants are positive. Each entry may carry a `reference` to the resource that triggered the charge (currently generation jobs).
+   */
+  async transactions(
+    request?: operations.ListUsageTransactionsRequest | undefined,
+    options?: RequestOptions,
+  ): Promise<models.ListResponseUsageTransaction> {
+    return unwrapAsync(usageTransactions(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/video.ts

@@ -0,0 +1,62 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { videoGenerate } from "../funcs/videoGenerate.js";
+import { videoGet } from "../funcs/videoGet.js";
+import { videoListModels } from "../funcs/videoListModels.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Video extends ClientSDK {
+  /**
+   * Generate a video
+   *
+   * @remarks
+   * Submits an asynchronous video generation job to the fal.ai queue and returns the queued job immediately. Poll `GET /v1/jobs/{id}` or `GET /v1/videos/{id}` for status and results. Credits are charged only when the job completes successfully.
+   */
+  async generate(
+    request: models.VideoGenerateRequest,
+    options?: RequestOptions,
+  ): Promise<models.ProviderJob> {
+    return unwrapAsync(videoGenerate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List video models
+   *
+   * @remarks
+   * Lists the video generation models available to `POST /v1/videos/generate`, enriched with live fal.ai pricing.
+   */
+  async listModels(
+    options?: RequestOptions,
+  ): Promise<models.ListResponseGenerationModel> {
+    return unwrapAsync(videoListModels(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Get video job
+   *
+   * @remarks
+   * Convenience alias for `GET /v1/jobs/{id}` that asserts the job is a video generation job (404 otherwise).
+   */
+  async get(
+    request: operations.GetVideoJobRequest,
+    options?: RequestOptions,
+  ): Promise<models.ProviderJob> {
+    return unwrapAsync(videoGet(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/types/async.ts

@@ -21,16 +21,17 @@ export type APICall =
 
 export class APIPromise<T> implements Promise<T> {
   readonly #promise: Promise<[T, APICall]>;
-  readonly #unwrapped: Promise<T>;
+  #unwrapped: Promise<T> | null;
 
   readonly [Symbol.toStringTag] = "APIPromise";
 
   constructor(p: [T, APICall] | Promise<[T, APICall]>) {
     this.#promise = p instanceof Promise ? p : Promise.resolve(p);
-    this.#unwrapped =
-      p instanceof Promise
-        ? this.#promise.then(([value]) => value)
-        : Promise.resolve(p[0]);
+    this.#unwrapped = p instanceof Promise ? null : Promise.resolve(p[0]);
+  }
+
+  #getUnwrapped(): Promise<T> {
+    return (this.#unwrapped ??= this.#promise.then(([value]) => value));
   }
 
   then<TResult1 = T, TResult2 = never>(
@@ -55,11 +56,11 @@ export class APIPromise<T> implements Promise<T> {
       | null
       | undefined,
   ): Promise<T | TResult> {
-    return this.#unwrapped.catch(onrejected);
+    return this.#getUnwrapped().catch(onrejected);
   }
 
   finally(onfinally?: (() => void) | null | undefined): Promise<T> {
-    return this.#unwrapped.finally(onfinally);
+    return this.#getUnwrapped().finally(onfinally);
   }
 
   $inspect(): Promise<[T, APICall]> {