@woopsocial/typescript-sdk 0.0.7

package/src/models/upload-session.ts

@@ -0,0 +1,64 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  UploadSessionPart,
+  UploadSessionPart$inboundSchema,
+} from "./upload-session-part.js";
+
+export type UploadSession = {
+  /**
+   * Media upload session identifier.
+   */
+  uploadSessionId: string;
+  /**
+   * Maximum chunk size to use when slicing the file into parts.
+   *
+   * @remarks
+   *
+   * For uploads with more than one part, every part except the last must
+   * be exactly this size. The last part may be smaller. For a single-part
+   * upload, the only part may be smaller than this size.
+   */
+  partSizeInBytes: number;
+  /**
+   * Number of parts that must be uploaded before completion.
+   */
+  partCount: number;
+  /**
+   * Time when the presigned part upload URLs expire.
+   */
+  expiresAt: Date;
+  /**
+   * Presigned upload targets, in part-number order.
+   */
+  parts: Array<UploadSessionPart>;
+};
+
+/** @internal */
+export const UploadSession$inboundSchema: z.ZodMiniType<
+  UploadSession,
+  unknown
+> = z.object({
+  uploadSessionId: types.string(),
+  partSizeInBytes: types.number(),
+  partCount: types.number(),
+  expiresAt: types.date(),
+  parts: z.array(UploadSessionPart$inboundSchema),
+});
+
+export function uploadSessionFromJSON(
+  jsonString: string,
+): SafeParseResult<UploadSession, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => UploadSession$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'UploadSession' from JSON`,
+  );
+}

package/src/models/validation-error.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  ValidationField,
+  ValidationField$inboundSchema,
+} from "./validation-field.js";
+
+export type ValidationError = {
+  field: ValidationField;
+  message: string;
+};
+
+/** @internal */
+export const ValidationError$inboundSchema: z.ZodMiniType<
+  ValidationError,
+  unknown
+> = z.object({
+  field: ValidationField$inboundSchema,
+  message: types.string(),
+});
+
+export function validationErrorFromJSON(
+  jsonString: string,
+): SafeParseResult<ValidationError, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ValidationError$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ValidationError' from JSON`,
+  );
+}

package/src/models/validation-field.ts

@@ -0,0 +1,29 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+export const ValidationField = {
+  Description: "DESCRIPTION",
+  Media: "MEDIA",
+  PinterestBoard: "PINTEREST_BOARD",
+  Content: "CONTENT",
+  Title: "TITLE",
+  FirstComment: "FIRST_COMMENT",
+  TiktokPrivacyLevel: "TIKTOK_PRIVACY_LEVEL",
+  TiktokContentDisclosure: "TIKTOK_CONTENT_DISCLOSURE",
+  YoutubePrivacy: "YOUTUBE_PRIVACY",
+  YoutubeCategory: "YOUTUBE_CATEGORY",
+  YoutubeTags: "YOUTUBE_TAGS",
+  Schedule: "SCHEDULE",
+} as const;
+export type ValidationField = OpenEnum<typeof ValidationField>;
+
+/** @internal */
+export const ValidationField$inboundSchema: z.ZodMiniType<
+  ValidationField,
+  unknown
+> = openEnums.inboundSchema(ValidationField);

package/src/models/validation-warning.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  ValidationField,
+  ValidationField$inboundSchema,
+} from "./validation-field.js";
+
+export type ValidationWarning = {
+  field: ValidationField;
+  message: string;
+};
+
+/** @internal */
+export const ValidationWarning$inboundSchema: z.ZodMiniType<
+  ValidationWarning,
+  unknown
+> = z.object({
+  field: ValidationField$inboundSchema,
+  message: types.string(),
+});
+
+export function validationWarningFromJSON(
+  jsonString: string,
+): SafeParseResult<ValidationWarning, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ValidationWarning$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ValidationWarning' from JSON`,
+  );
+}

package/src/models/x-specifics.ts

@@ -0,0 +1,44 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+export type XSpecifics = {
+  platform: "X";
+};
+
+/** @internal */
+export const XSpecifics$inboundSchema: z.ZodMiniType<XSpecifics, unknown> = z
+  .object({
+    platform: types.literal("X"),
+  });
+/** @internal */
+export type XSpecifics$Outbound = {
+  platform: "X";
+};
+
+/** @internal */
+export const XSpecifics$outboundSchema: z.ZodMiniType<
+  XSpecifics$Outbound,
+  XSpecifics
+> = z.object({
+  platform: z.literal("X"),
+});
+
+export function xSpecificsToJSON(xSpecifics: XSpecifics): string {
+  return JSON.stringify(XSpecifics$outboundSchema.parse(xSpecifics));
+}
+export function xSpecificsFromJSON(
+  jsonString: string,
+): SafeParseResult<XSpecifics, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => XSpecifics$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'XSpecifics' from JSON`,
+  );
+}

package/src/models/you-tube-privacy.ts

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+export const YouTubePrivacy = {
+  Public: "public",
+  Private: "private",
+  Unlisted: "unlisted",
+} as const;
+export type YouTubePrivacy = OpenEnum<typeof YouTubePrivacy>;
+
+/** @internal */
+export const YouTubePrivacy$inboundSchema: z.ZodMiniType<
+  YouTubePrivacy,
+  unknown
+> = openEnums.inboundSchema(YouTubePrivacy);
+/** @internal */
+export const YouTubePrivacy$outboundSchema: z.ZodMiniType<
+  string,
+  YouTubePrivacy
+> = openEnums.outboundSchema(YouTubePrivacy);

package/src/models/you-tube-specifics.ts

@@ -0,0 +1,71 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  YouTubePrivacy,
+  YouTubePrivacy$inboundSchema,
+  YouTubePrivacy$outboundSchema,
+} from "./you-tube-privacy.js";
+
+export type YouTubeSpecifics = {
+  platform: "YOUTUBE";
+  privacy?: YouTubePrivacy | undefined;
+  category?: string | undefined;
+  tags?: Array<string> | undefined;
+  madeForKids?: boolean | undefined;
+};
+
+/** @internal */
+export const YouTubeSpecifics$inboundSchema: z.ZodMiniType<
+  YouTubeSpecifics,
+  unknown
+> = z.object({
+  platform: types.literal("YOUTUBE"),
+  privacy: types.optional(YouTubePrivacy$inboundSchema),
+  category: types.optional(types.string()),
+  tags: types.optional(z.array(types.string())),
+  madeForKids: types.optional(types.boolean()),
+});
+/** @internal */
+export type YouTubeSpecifics$Outbound = {
+  platform: "YOUTUBE";
+  privacy?: string | undefined;
+  category?: string | undefined;
+  tags?: Array<string> | undefined;
+  madeForKids?: boolean | undefined;
+};
+
+/** @internal */
+export const YouTubeSpecifics$outboundSchema: z.ZodMiniType<
+  YouTubeSpecifics$Outbound,
+  YouTubeSpecifics
+> = z.object({
+  platform: z.literal("YOUTUBE"),
+  privacy: z.optional(YouTubePrivacy$outboundSchema),
+  category: z.optional(z.string()),
+  tags: z.optional(z.array(z.string())),
+  madeForKids: z.optional(z.boolean()),
+});
+
+export function youTubeSpecificsToJSON(
+  youTubeSpecifics: YouTubeSpecifics,
+): string {
+  return JSON.stringify(
+    YouTubeSpecifics$outboundSchema.parse(youTubeSpecifics),
+  );
+}
+export function youTubeSpecificsFromJSON(
+  jsonString: string,
+): SafeParseResult<YouTubeSpecifics, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => YouTubeSpecifics$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'YouTubeSpecifics' from JSON`,
+  );
+}

package/src/sdk/health.ts

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { healthGetHealth } from "../funcs/health-get-health.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Health extends ClientSDK {
+  /**
+   * Health check
+   *
+   * @remarks
+   * Returns a minimal response proving the WoopSocial API is reachable.
+   */
+  async getHealth(
+    options?: RequestOptions,
+  ): Promise<models.HealthResponse> {
+    return unwrapAsync(healthGetHealth(
+      this,
+      options,
+    ));
+  }
+}

package/src/sdk/index.ts

@@ -0,0 +1,5 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export * from "./sdk.js";

package/src/sdk/media.ts

@@ -0,0 +1,93 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { mediaCompleteUploadSession } from "../funcs/media-complete-upload-session.js";
+import { mediaCreateMedia } from "../funcs/media-create-media.js";
+import { mediaCreateUploadSession } from "../funcs/media-create-upload-session.js";
+import { mediaGetUploadSession } from "../funcs/media-get-upload-session.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 Media extends ClientSDK {
+  /**
+   * Upload media
+   *
+   * @remarks
+   * Uploads a media file in a single request and creates a media item.
+   *
+   * The server determines the media MIME type from the uploaded file.
+   *
+   * Use this endpoint for straightforward uploads up to 600 MB.
+   *
+   * For larger files, or when you need presigned part URLs, use the upload
+   * session flow under `/media/upload-sessions`.
+   */
+  async createMedia(
+    request: operations.CreateMediaRequest,
+    options?: RequestOptions,
+  ): Promise<models.CreateMediaResponse> {
+    return unwrapAsync(mediaCreateMedia(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Start media upload session
+   *
+   * @remarks
+   * Creates an upload session and returns presigned URLs for uploading the file in parts.
+   *
+   * This flow is intended for larger files where a single-request upload via the simpler `/media` endpoint is less practical.
+   *
+   * Upload the file in `partCount` parts, using the matching
+   * `parts[n].uploadUrl` for each part number.
+   *
+   * Every part except the last must be exactly `partSizeInBytes` bytes. The
+   * last part may be smaller. After all parts have been uploaded, call
+   * `/media/upload-sessions/{uploadSessionId}/complete` to finalize the upload
+   * and create the media item.
+   */
+  async createUploadSession(
+    request: models.CreateUploadSessionRequest,
+    options?: RequestOptions,
+  ): Promise<models.UploadSession> {
+    return unwrapAsync(mediaCreateUploadSession(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get media upload session status
+   */
+  async getUploadSession(
+    request: operations.GetUploadSessionRequest,
+    options?: RequestOptions,
+  ): Promise<models.UploadSessionStatus> {
+    return unwrapAsync(mediaGetUploadSession(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Complete media upload session
+   */
+  async completeUploadSession(
+    request: operations.CompleteUploadSessionRequest,
+    options?: RequestOptions,
+  ): Promise<models.UploadSessionStatus> {
+    return unwrapAsync(mediaCompleteUploadSession(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/posts.ts

@@ -0,0 +1,95 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { postsCreatePosts } from "../funcs/posts-create-posts.js";
+import { postsDeletePosts } from "../funcs/posts-delete-posts.js";
+import { postsListPosts } from "../funcs/posts-list-posts.js";
+import { postsUpdatePosts } from "../funcs/posts-update-posts.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Posts extends ClientSDK {
+  /**
+   * List posts
+   *
+   * @remarks
+   * Returns outbound posts that were scheduled within various projects.
+   */
+  async listPosts(
+    request?: models.ListPostsRequest | undefined,
+    options?: RequestOptions,
+  ): Promise<models.ListPostsResponse> {
+    return unwrapAsync(postsListPosts(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Delete posts
+   *
+   * @remarks
+   * Deletes one or more scheduled posts by post ID.
+   *
+   * Only posts with `deliveryStatus` `NOT_STARTED` can be deleted.
+   *
+   * Results are returned in the same order as the provided `ids`.
+   */
+  async deletePosts(
+    request: Array<string>,
+    options?: RequestOptions,
+  ): Promise<models.DeletePostsResponse> {
+    return unwrapAsync(postsDeletePosts(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Create posts
+   *
+   * @remarks
+   * Creates one or more scheduled posts.
+   *
+   * Each item in the request body creates one scheduled post for a single connected social account. Each item must target a specific project.
+   *
+   * Each item must provide an `idempotencyKey`. Reusing the same `idempotencyKey` for the same API key replays the original result for that item. This is to help you prevent accidentally publishing the same post multiple times, in case you need to retry due to network failures.
+   *
+   * Results are returned in the same order as the input array.
+   */
+  async createPosts(
+    request: Array<models.CreatePostItem>,
+    options?: RequestOptions,
+  ): Promise<models.CreatePostsResponse> {
+    return unwrapAsync(postsCreatePosts(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Update posts
+   *
+   * @remarks
+   * Updates one or more scheduled posts by post ID.
+   *
+   * Only posts with `deliveryStatus` `NOT_STARTED` can be updated. It performs a full replacement of the specified posts, so omitted properties are cleared.
+   *
+   * Results are returned in the same order as the input array.
+   */
+  async updatePosts(
+    request: Array<models.UpdatePostItem>,
+    options?: RequestOptions,
+  ): Promise<models.UpdatePostsResponse> {
+    return unwrapAsync(postsUpdatePosts(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/projects.ts

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { projectsListProjects } from "../funcs/projects-list-projects.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Projects extends ClientSDK {
+  /**
+   * List projects
+   *
+   * @remarks
+   * Returns projects that belong to the same organization as the API key. A project corresponds to a "Business Profile" in the UI.
+   */
+  async listProjects(
+    options?: RequestOptions,
+  ): Promise<Array<models.Project>> {
+    return unwrapAsync(projectsListProjects(
+      this,
+      options,
+    ));
+  }
+}

package/src/sdk/sdk.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ClientSDK } from "../lib/sdks.js";
+import { Health } from "./health.js";
+import { Media } from "./media.js";
+import { Posts } from "./posts.js";
+import { Projects } from "./projects.js";
+import { SocialAccounts } from "./social-accounts.js";
+
+export class WoopSocial extends ClientSDK {
+  private _posts?: Posts;
+  get posts(): Posts {
+    return (this._posts ??= new Posts(this._options));
+  }
+
+  private _projects?: Projects;
+  get projects(): Projects {
+    return (this._projects ??= new Projects(this._options));
+  }
+
+  private _socialAccounts?: SocialAccounts;
+  get socialAccounts(): SocialAccounts {
+    return (this._socialAccounts ??= new SocialAccounts(this._options));
+  }
+
+  private _media?: Media;
+  get media(): Media {
+    return (this._media ??= new Media(this._options));
+  }
+
+  private _health?: Health;
+  get health(): Health {
+    return (this._health ??= new Health(this._options));
+  }
+}

package/src/sdk/social-accounts.ts

@@ -0,0 +1,68 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { socialAccountsCreateOAuthAuthorization } from "../funcs/social-accounts-create-o-auth-authorization.js";
+import { socialAccountsGetSocialAccountPlatformInputs } from "../funcs/social-accounts-get-social-account-platform-inputs.js";
+import { socialAccountsListSocialAccounts } from "../funcs/social-accounts-list-social-accounts.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 SocialAccounts extends ClientSDK {
+  /**
+   * Generate OAuth URL
+   *
+   * @remarks
+   * Generates a browser authorization URL for connecting a new social account to a project. Open the returned `url` in a browser to complete the platform-specific OAuth flow.
+   */
+  async createOAuthAuthorization(
+    request: models.CreateOAuthAuthorizationRequest,
+    options?: RequestOptions,
+  ): Promise<models.CreateOAuthAuthorizationResponse> {
+    return unwrapAsync(socialAccountsCreateOAuthAuthorization(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List social accounts
+   *
+   * @remarks
+   * Returns social accounts that can currently be used for publishing.
+   *
+   * When `projectId` is provided, only social accounts usable within that project are returned.
+   */
+  async listSocialAccounts(
+    request?: operations.ListSocialAccountsRequest | undefined,
+    options?: RequestOptions,
+  ): Promise<Array<models.SocialAccount>> {
+    return unwrapAsync(socialAccountsListSocialAccounts(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get platform-specific input options
+   *
+   * @remarks
+   * Returns platform-specific input options for a connected social account.
+   *
+   * Use this endpoint to discover valid values for fields inside `platformSpecifics` when creating posts for Pinterest and TikTok.
+   */
+  async getSocialAccountPlatformInputs(
+    request: operations.GetSocialAccountPlatformInputsRequest,
+    options?: RequestOptions,
+  ): Promise<models.SocialAccountPlatformInputs> {
+    return unwrapAsync(socialAccountsGetSocialAccountPlatformInputs(
+      this,
+      request,
+      options,
+    ));
+  }
+}