@rolino/contracts 0.1.0 → 0.3.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/index.ts
 import { z } from "zod";
 var API_VERSION = "v1";
-var CONTRACT_VERSION = "0.12.0";
+var CONTRACT_VERSION = "0.14.0";
 var RequestMetadataSchema = z.object({
   requestId: z.string().min(1)
 });
@@ -187,9 +187,11 @@ var PlatformPostStatusSchema = z.enum([
 ]);
 var PostMediaSchema = z.object({
   id: z.string().min(1),
+  assetId: z.string().min(1).nullable().optional(),
   type: z.enum(["IMAGE", "VIDEO"]),
   url: z.string().url(),
   mimeType: z.string().min(1),
+  sizeBytes: z.number().int().positive().nullable().optional(),
   width: z.number().int().positive().nullable(),
   height: z.number().int().positive().nullable(),
   durationMs: z.number().int().nonnegative().nullable(),
@@ -244,54 +246,23 @@ var MediaAssetUploadCompleteInputSchema = MediaAssetUploadInputSchema.extend({
   durationMs: z.number().int().nonnegative().max(864e5).nullable().optional()
 }).strict();
 var MediaAssetResponseSchema = successEnvelopeSchema(MediaAssetSchema);
-var PostDestinationSchema = z.object({
-  provider: z.enum(["INSTAGRAM", "TIKTOK", "YOUTUBE", "BLUESKY"]),
-  status: PlatformPostStatusSchema,
-  captionOverride: z.string().nullable(),
-  scheduledAt: z.string().datetime().nullable(),
-  publishedAt: z.string().datetime().nullable(),
-  remoteUrl: z.string().url().nullable(),
-  attemptCount: z.number().int().nonnegative()
-});
 var PublishingProviderSchema = z.enum([
   "INSTAGRAM",
   "TIKTOK",
   "YOUTUBE",
-  "BLUESKY"
+  "BLUESKY",
+  "LINKEDIN"
 ]);
 var PUBLISHING_PROVIDER_COUNT = PublishingProviderSchema.options.length;
-var PostSchema = z.object({
-  id: z.string().min(1),
-  projectId: z.string().min(1),
-  version: z.number().int().positive(),
-  campaign: z.object({
-    id: z.string().min(1),
-    title: z.string().min(1)
-  }).nullable(),
-  caption: z.string(),
-  status: PostStatusSchema,
+var PostDestinationSchema = z.object({
+  provider: PublishingProviderSchema,
+  status: PlatformPostStatusSchema,
+  captionOverride: z.string().nullable(),
   scheduledAt: z.string().datetime().nullable(),
-  timezone: z.string().nullable(),
   publishedAt: z.string().datetime().nullable(),
-  createdAt: z.string().datetime(),
-  updatedAt: z.string().datetime(),
-  media: z.array(PostMediaSchema),
-  destinations: z.array(PostDestinationSchema)
-});
-var PostListQuerySchema = z.object({
-  limit: z.coerce.number().int().min(1).max(100).default(50),
-  cursor: z.string().min(1).optional(),
-  status: PostStatusSchema.optional()
-});
-var PostListDataSchema = z.object({
-  items: z.array(PostSchema),
-  page: z.object({
-    limit: z.number().int().min(1).max(100),
-    nextCursor: z.string().min(1).nullable()
-  })
+  remoteUrl: z.string().url().nullable(),
+  attemptCount: z.number().int().nonnegative()
 });
-var PostListResponseSchema = successEnvelopeSchema(PostListDataSchema);
-var PostResponseSchema = successEnvelopeSchema(PostSchema);
 var TikTokPostSettingsSchema = z.object({
   postMode: z.enum(["DIRECT_POST", "MEDIA_UPLOAD"]).default("DIRECT_POST"),
   privacyLevel: z.string().trim().min(1).max(100).nullable().default(null),
@@ -305,6 +276,91 @@ var TikTokPostSettingsSchema = z.object({
   videoCoverTimestampMs: z.number().int().nonnegative().nullable().default(null),
   consentedAt: z.union([z.string().datetime(), z.literal("")]).default("")
 }).strict();
+var TikTokDraftSettingsSchema = z.object({
+  postMode: z.enum(["DIRECT_POST", "MEDIA_UPLOAD"]).optional(),
+  privacyLevel: z.string().trim().min(1).max(100).nullable().optional(),
+  allowComment: z.boolean().optional(),
+  allowDuet: z.boolean().optional(),
+  allowStitch: z.boolean().optional(),
+  commercialContentEnabled: z.boolean().optional(),
+  promotesOwnBrand: z.boolean().optional(),
+  promotesThirdParty: z.boolean().optional(),
+  isAiGenerated: z.boolean().optional(),
+  videoCoverTimestampMs: z.number().int().nonnegative().nullable().optional(),
+  reviewed: z.boolean().optional(),
+  consentedAt: z.union([z.string().datetime(), z.literal("")]).optional()
+}).strict().superRefine((input, context) => {
+  const requestsReview = input.reviewed === true || Boolean(input.consentedAt);
+  if (input.postMode === "MEDIA_UPLOAD") {
+    if (input.privacyLevel != null || input.allowComment === true || input.allowDuet === true || input.allowStitch === true || input.commercialContentEnabled === true || input.promotesOwnBrand === true || input.promotesThirdParty === true || input.isAiGenerated === true || input.videoCoverTimestampMs != null) {
+      context.addIssue({
+        code: "custom",
+        message: "TikTok inbox drafts do not apply direct-post visibility, interaction, disclosure, AI, or cover settings."
+      });
+    }
+    return;
+  }
+  if (!requestsReview) return;
+  if (!input.postMode) {
+    context.addIssue({
+      code: "custom",
+      path: ["postMode"],
+      message: "Choose TikTok direct publishing or inbox draft delivery explicitly."
+    });
+    return;
+  }
+  const requiredBooleanFields = [
+    "allowComment",
+    "allowDuet",
+    "allowStitch",
+    "commercialContentEnabled",
+    "promotesOwnBrand",
+    "promotesThirdParty",
+    "isAiGenerated"
+  ];
+  if (!input.privacyLevel) {
+    context.addIssue({
+      code: "custom",
+      path: ["privacyLevel"],
+      message: "Choose TikTok visibility explicitly before reviewing the settings."
+    });
+  }
+  for (const field of requiredBooleanFields) {
+    if (input[field] === void 0) {
+      context.addIssue({
+        code: "custom",
+        path: [field],
+        message: "Choose yes or no explicitly before reviewing TikTok settings."
+      });
+    }
+  }
+  if (input.commercialContentEnabled === true && input.promotesOwnBrand !== true && input.promotesThirdParty !== true) {
+    context.addIssue({
+      code: "custom",
+      path: ["commercialContentEnabled"],
+      message: "Commercial TikTok content must identify own-brand or third-party promotion."
+    });
+  }
+  if (input.commercialContentEnabled === false && (input.promotesOwnBrand === true || input.promotesThirdParty === true)) {
+    context.addIssue({
+      code: "custom",
+      path: ["commercialContentEnabled"],
+      message: "Promotion declarations require commercial content to be enabled."
+    });
+  }
+}).transform((input) => ({
+  postMode: input.postMode ?? "DIRECT_POST",
+  privacyLevel: input.privacyLevel ?? null,
+  allowComment: input.allowComment ?? false,
+  allowDuet: input.allowDuet ?? false,
+  allowStitch: input.allowStitch ?? false,
+  commercialContentEnabled: input.commercialContentEnabled ?? false,
+  promotesOwnBrand: input.promotesOwnBrand ?? false,
+  promotesThirdParty: input.promotesThirdParty ?? false,
+  isAiGenerated: input.isAiGenerated ?? false,
+  videoCoverTimestampMs: input.videoCoverTimestampMs ?? null,
+  reviewed: input.reviewed === true || Boolean(input.consentedAt)
+}));
 function youtubeTagLength(tags) {
   return tags.reduce((total, tag, index) => total + (index ? 1 : 0) + tag.length + (tag.includes(" ") ? 2 : 0), 0);
 }
@@ -326,6 +382,43 @@ var YouTubePostSettingsSchema = z.object({
     "YouTube tags exceed the 500-character aggregate limit."
   ).default([])
 }).strict();
+var PostProviderSettingsSchema = z.object({
+  TIKTOK: TikTokPostSettingsSchema.nullable().optional(),
+  YOUTUBE: YouTubePostSettingsSchema.nullable().optional()
+}).strict().default({});
+var PostSchema = z.object({
+  id: z.string().min(1),
+  projectId: z.string().min(1),
+  version: z.number().int().positive(),
+  campaign: z.object({
+    id: z.string().min(1),
+    title: z.string().min(1)
+  }).nullable(),
+  caption: z.string(),
+  status: PostStatusSchema,
+  scheduledAt: z.string().datetime().nullable(),
+  timezone: z.string().nullable(),
+  publishedAt: z.string().datetime().nullable(),
+  createdAt: z.string().datetime(),
+  updatedAt: z.string().datetime(),
+  media: z.array(PostMediaSchema),
+  destinations: z.array(PostDestinationSchema),
+  providerSettings: PostProviderSettingsSchema.optional()
+});
+var PostListQuerySchema = z.object({
+  limit: z.coerce.number().int().min(1).max(100).default(50),
+  cursor: z.string().min(1).optional(),
+  status: PostStatusSchema.optional()
+});
+var PostListDataSchema = z.object({
+  items: z.array(PostSchema),
+  page: z.object({
+    limit: z.number().int().min(1).max(100),
+    nextCursor: z.string().min(1).nullable()
+  })
+});
+var PostListResponseSchema = successEnvelopeSchema(PostListDataSchema);
+var PostResponseSchema = successEnvelopeSchema(PostSchema);
 var blueskyGraphemeSegmenter = new Intl.Segmenter("en", {
   granularity: "grapheme"
 });
@@ -338,24 +431,27 @@ var YouTubeDescriptionSchema = z.string().max(5e3).refine(
   (value) => utf8Encoder.encode(value).length <= 5e3,
   "YouTube descriptions cannot exceed 5,000 UTF-8 bytes."
 );
-var DraftCaptionOverridesSchema = z.object({
+var DraftCaptionOverridesObjectSchema = z.object({
   INSTAGRAM: z.string().max(2200).nullable().optional(),
   TIKTOK: z.string().max(2200).nullable().optional(),
   YOUTUBE: YouTubeDescriptionSchema.nullable().optional(),
-  BLUESKY: BlueskyCaptionSchema.nullable().optional()
-}).strict().default({});
+  BLUESKY: BlueskyCaptionSchema.nullable().optional(),
+  LINKEDIN: z.string().max(3e3).nullable().optional()
+}).strict();
+var DraftPlatformsSchema = z.array(PublishingProviderSchema).max(PUBLISHING_PROVIDER_COUNT).refine(
+  (providers) => new Set(providers).size === providers.length,
+  "Publishing destinations must be unique."
+);
+var DraftMediaAssetIdsSchema = z.array(z.string().trim().min(1).max(200)).max(10).refine(
+  (ids) => new Set(ids).size === ids.length,
+  "Media asset IDs must be unique."
+);
 var DraftPostInputSchema = z.object({
-  caption: z.string().max(2200).transform((value) => value.trim()).default(""),
-  platforms: z.array(PublishingProviderSchema).max(PUBLISHING_PROVIDER_COUNT).refine(
-    (providers) => new Set(providers).size === providers.length,
-    "Publishing destinations must be unique."
-  ).default([]),
-  mediaAssetIds: z.array(z.string().trim().min(1).max(200)).max(10).refine(
-    (ids) => new Set(ids).size === ids.length,
-    "Media asset IDs must be unique."
-  ).default([]),
-  captionOverrides: DraftCaptionOverridesSchema,
-  tiktokSettings: TikTokPostSettingsSchema.nullable().default(null),
+  caption: z.string().max(3e3).transform((value) => value.trim()).default(""),
+  platforms: DraftPlatformsSchema.default([]),
+  mediaAssetIds: DraftMediaAssetIdsSchema.default([]),
+  captionOverrides: DraftCaptionOverridesObjectSchema.default({}),
+  tiktokSettings: TikTokDraftSettingsSchema.nullable().default(null),
   youtubeSettings: YouTubePostSettingsSchema.nullable().default(null)
 }).strict().superRefine((input, context) => {
   if (input.caption.length === 0 && input.mediaAssetIds.length === 0) {
@@ -401,6 +497,32 @@ var DraftPostInputSchema = z.object({
     });
   }
 });
+var DraftPostUpdateInputSchema = z.object({
+  caption: z.string().max(3e3).transform((value) => value.trim()).optional(),
+  platforms: DraftPlatformsSchema.optional(),
+  mediaAssetIds: DraftMediaAssetIdsSchema.optional(),
+  captionOverrides: DraftCaptionOverridesObjectSchema.optional(),
+  tiktokSettings: TikTokDraftSettingsSchema.nullable().optional(),
+  youtubeSettings: YouTubePostSettingsSchema.nullable().optional()
+}).strict().superRefine((input, context) => {
+  if (Object.values(input).every((value) => value === void 0)) {
+    context.addIssue({ code: "custom", message: "Provide at least one draft field to update." });
+  }
+  if (input.platforms && input.tiktokSettings && !input.platforms.includes("TIKTOK")) {
+    context.addIssue({
+      code: "custom",
+      path: ["tiktokSettings"],
+      message: "TikTok settings require the TIKTOK destination."
+    });
+  }
+  if (input.platforms && input.youtubeSettings && !input.platforms.includes("YOUTUBE")) {
+    context.addIssue({
+      code: "custom",
+      path: ["youtubeSettings"],
+      message: "YouTube settings require the YOUTUBE destination."
+    });
+  }
+});
 var IntegrationConnectionStatusSchema = z.enum([
   "PENDING",
   "CONNECTED",
@@ -443,6 +565,65 @@ var IntegrationHealthListDataSchema = z.object({
 var IntegrationHealthListResponseSchema = successEnvelopeSchema(
   IntegrationHealthListDataSchema
 );
+var ProviderDeliveryOptionsProviderSchema = z.enum([
+  "TIKTOK",
+  "LINKEDIN"
+]);
+var TikTokDeliveryOptionsSchema = z.object({
+  provider: z.literal("TIKTOK"),
+  account: z.object({
+    username: z.string().nullable(),
+    displayName: z.string().nullable(),
+    avatarUrl: z.string().url().nullable()
+  }),
+  allowedPostModes: z.array(z.enum(["DIRECT_POST", "MEDIA_UPLOAD"])).max(2).refine(
+    (items) => new Set(items).size === items.length,
+    "TikTok post modes must be unique."
+  ),
+  visibilityOptions: z.array(z.string().trim().min(1).max(100)).max(20).refine(
+    (items) => new Set(items).size === items.length,
+    "TikTok visibility options must be unique."
+  ),
+  interactions: z.object({
+    comment: z.object({ available: z.boolean() }),
+    duet: z.object({ available: z.boolean() }),
+    stitch: z.object({ available: z.boolean() })
+  }),
+  maxVideoDurationMs: z.number().int().positive().max(864e5).nullable(),
+  health: z.object({
+    status: ProviderHealthStatusSchema,
+    code: z.string().min(1),
+    message: z.string().min(1)
+  }),
+  checkedAt: z.string().datetime()
+});
+var LinkedInDeliveryOptionsSchema = z.object({
+  provider: z.literal("LINKEDIN"),
+  account: z.object({
+    displayName: z.string().nullable(),
+    avatarUrl: z.string().url().nullable()
+  }),
+  supportedPostTypes: z.array(z.enum(["TEXT", "SINGLE_IMAGE", "MULTI_IMAGE"])).length(3),
+  image: z.object({
+    maxItems: z.literal(10),
+    mimeTypes: z.tuple([z.literal("image/jpeg"), z.literal("image/png")]),
+    maxPixelsExclusive: z.literal(36152320),
+    maxBytes: z.literal(26214400)
+  }),
+  health: z.object({
+    status: ProviderHealthStatusSchema,
+    code: z.string().min(1),
+    message: z.string().min(1)
+  }),
+  checkedAt: z.string().datetime()
+});
+var ProviderDeliveryOptionsSchema = z.discriminatedUnion("provider", [
+  TikTokDeliveryOptionsSchema,
+  LinkedInDeliveryOptionsSchema
+]);
+var ProviderDeliveryOptionsResponseSchema = successEnvelopeSchema(
+  ProviderDeliveryOptionsSchema
+);
 var ReadinessStatusSchema = z.enum([
   "checking",
   "pass",
@@ -667,10 +848,12 @@ export {
   CliAuthorizationRevokeDataSchema,
   CliAuthorizationRevokeResponseSchema,
   DraftPostInputSchema,
+  DraftPostUpdateInputSchema,
   IntegrationConnectionStatusSchema,
   IntegrationHealthListDataSchema,
   IntegrationHealthListResponseSchema,
   IntegrationHealthSchema,
+  LinkedInDeliveryOptionsSchema,
   MediaAssetListDataSchema,
   MediaAssetListQuerySchema,
   MediaAssetListResponseSchema,
@@ -687,6 +870,7 @@ export {
   PostListQuerySchema,
   PostListResponseSchema,
   PostMediaSchema,
+  PostProviderSettingsSchema,
   PostPublishExecuteInputSchema,
   PostPublishInputSchema,
   PostPublishPreviewResponseSchema,
@@ -711,11 +895,16 @@ export {
   ProjectResponseSchema,
   ProjectSchema,
   ProjectTypeSchema,
+  ProviderDeliveryOptionsProviderSchema,
+  ProviderDeliveryOptionsResponseSchema,
+  ProviderDeliveryOptionsSchema,
   ProviderHealthStatusSchema,
   PublishingProviderSchema,
   ReadinessActionSchema,
   ReadinessStatusSchema,
   RequestMetadataSchema,
+  TikTokDeliveryOptionsSchema,
+  TikTokDraftSettingsSchema,
   TikTokPostSettingsSchema,
   WhoAmIResponseSchema,
   YouTubePostSettingsSchema,