@agentmedia/schema 0.2.1 → 0.3.0

package/src/video.ts

@@ -221,18 +221,54 @@ export const SubtitleSchema = z.object({
 
 export type SubtitleInput = z.infer<typeof SubtitleSchema>;
 
-export const ProductReviewSchema = z.object({
-  product_url: z.string().url(),
+export const SaasReviewSchema = z.preprocess(flattenGroupedParams, z.object({
+  script: z.string().min(50).max(3000).optional(),
+  prompt: z.string().min(1).max(1000).optional(),
+  product_url: z.string().url().optional(),
   angle: z.enum(REVIEW_ANGLES).optional(),
-  tone: z.enum(TONES).optional(),
   actor_slug: z.string().min(1).max(100).optional(),
+  persona_slug: z.string().min(1).max(100).optional(),
+  face_photo_url: z.string().url().optional(),
+  voice: z.string().max(100).optional(),
   target_duration: z.number().refine(
     (v) => (DURATIONS as readonly number[]).includes(v),
     { message: 'target_duration must be 5, 10, or 15' },
   ).optional(),
-});
+  style: z.string().max(50).optional(),
+  tone: z.enum(TONES).optional(),
+  voice_speed: z.number().min(0.7).max(1.5).optional(),
+  music: z.enum(MUSIC_GENRES).optional(),
+  cta: z.string().max(100).optional(),
+  aspect_ratio: z.enum(ASPECT_RATIOS).optional(),
+  template: z.string().max(50).optional(),
+  composition_mode: z.literal('pip').optional(),
+  pip_options: PipOptionsSchema.optional(),
+  allow_broll: z.boolean().optional(),
+  broll_model: z.enum(BROLL_MODELS).optional(),
+  broll_images: z.array(z.string().url()).max(10).optional(),
+  dub_language: z.string().max(10).optional(),
+  webhook_url: z.string().url().optional(),
+  scenes: z.array(
+    z.object({
+      type: z.enum(SCENE_TYPES).optional(),
+    }).passthrough(),
+  ).max(30).optional(),
+}).refine(
+  (data) => data.script !== undefined || data.prompt !== undefined || data.product_url !== undefined,
+  { message: 'script, prompt, or product_url is required' },
+));
+
+export type SaasReviewInput = z.infer<typeof SaasReviewSchema>;
 
-export type ProductReviewInput = z.infer<typeof ProductReviewSchema>;
+/**
+ * @deprecated Use SaasReviewSchema. Kept for API/SDK compatibility.
+ */
+export const ProductReviewSchema = SaasReviewSchema;
+
+/**
+ * @deprecated Use SaasReviewInput. Kept for API/SDK compatibility.
+ */
+export type ProductReviewInput = SaasReviewInput;
 
 export const SHOW_YOUR_APP_WORDS_PER_SECOND = 3;
 export const SHOW_YOUR_APP_DURATIONS = [5, 10, 15] as const;
@@ -261,3 +297,123 @@ export const ShowYourAppSchema = z.object({
 });
 
 export type ShowYourAppInput = z.infer<typeof ShowYourAppSchema>;
+
+// ── Laptop UGC ──────────────────────────────────────────────────────────────
+
+export const LAPTOP_UGC_WORDS_PER_SECOND = 3;
+export const LAPTOP_UGC_DURATIONS = [15, 20] as const;
+export const LAPTOP_UGC_MAX_RECORDING_BYTES = 10 * 1024 * 1024; // 10 MB
+export const LAPTOP_UGC_MAX_RECORDING_SECONDS = 10;
+export const LAPTOP_UGC_RECORDING_MIME_TYPES = ['video/mp4', 'video/quicktime'] as const;
+export const LAPTOP_UGC_MAX_IMAGE_BYTES = 5 * 1024 * 1024; // 5 MB
+export const LAPTOP_UGC_IMAGE_MIME_TYPES = ['image/png', 'image/jpeg', 'image/webp'] as const;
+
+export const LaptopUgcSchema = z.object({
+  app_screen_recording_url: z.string().url().optional().describe('Public URL of a screen recording of your app (mp4 or mov). Max 10 MB, max 10 seconds. Provide this OR app_screen_image_url, not both.'),
+  app_screen_image_url: z.string().url().optional().describe('Public URL of a static screenshot of your app (png, jpeg, or webp). Max 5 MB. Provide this OR app_screen_recording_url, not both.'),
+  actor_slug: z.string().min(1).max(100).optional().describe('Actor slug from GET /v1/actors. Random actor if omitted.'),
+  script: z.string().min(5).max(3000).describe('Full voiceover script. Auto-split at sentence boundary into two halves for the two face shots.'),
+  duration: z.number().refine(
+    (v) => (LAPTOP_UGC_DURATIONS as readonly number[]).includes(v),
+    { message: 'duration must be 15 or 20' },
+  ).optional().default(20),
+  subtitle_style: z.enum(['hormozi', 'none']).optional().default('hormozi'),
+  webhook_url: z.string().url().optional(),
+}).superRefine((val, ctx) => {
+  // Exactly one of recording / image must be provided
+  const hasRecording = !!val.app_screen_recording_url;
+  const hasImage = !!val.app_screen_image_url;
+  if (hasRecording && hasImage) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ['app_screen_recording_url'],
+      message: 'Provide app_screen_recording_url OR app_screen_image_url, not both',
+    });
+  }
+  if (!hasRecording && !hasImage) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ['app_screen_recording_url'],
+      message: 'Either app_screen_recording_url or app_screen_image_url is required',
+    });
+  }
+  // Word-count cap
+  const duration = val.duration ?? 20;
+  const maxWords = duration * LAPTOP_UGC_WORDS_PER_SECOND;
+  const wordCount = val.script.trim().split(/\s+/).filter(Boolean).length;
+  if (wordCount > maxWords) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ['script'],
+      message: `Script has ${wordCount} words; max ${maxWords} for ${duration}s at ${LAPTOP_UGC_WORDS_PER_SECOND} words/sec`,
+    });
+  }
+});
+
+export type LaptopUgcInput = z.infer<typeof LaptopUgcSchema>;
+
+export const PRODUCT_ACTING_WORDS_PER_SECOND = 3;
+export const PRODUCT_ACTING_DURATIONS = [5, 10, 15] as const;
+export const PRODUCT_ACTING_TEMPLATES = [
+  'product-in-hand',
+  'mirror-selfie',
+  'bathroom-reaction',
+  'kitchen-counter',
+  'car-selfie',
+  'couch-review',
+  'expert-interview',
+  'product-closeup',
+] as const;
+export const PRODUCT_ACTING_STYLES = [
+  'raw-selfie',
+  'shocked',
+  'angry',
+  'excited',
+  'dramatic',
+  'weird-hook',
+  'casual-demo',
+  'honest-review',
+] as const;
+
+export const ProductActingSchema = z.object({
+  product_image_url: z.string().url().describe('Public URL of the product image to place in the actor scene. PNG, JPEG, or WebP recommended.'),
+  actor_slug: z.string().min(1).max(100).describe('Actor slug from GET /v1/actors. This actor is used as the creator reference.'),
+  actor_variant_id: z.string().uuid().optional().describe('Optional actor variant UUID for a specific outfit, framing, expression, or background.'),
+  product_name: z.string().min(1).max(120).optional().describe('Optional product name used for prompt/script context.'),
+  product_description: z.string().min(1).max(1000).optional().describe('Product context used to generate a short script when script is omitted. Required when script is omitted.'),
+  script: z.string().min(5).max(3000).optional().describe('Exact words the actor should say. If omitted, the API generates a short script from product_description.'),
+  template: z.enum(PRODUCT_ACTING_TEMPLATES).optional().default('product-in-hand').describe('UGC scenario template for the generated frame and motion.'),
+  acting_style: z.enum(PRODUCT_ACTING_STYLES).optional().default('raw-selfie').describe('Acting energy and delivery style.'),
+  visual_style: z.string().max(200).optional().describe('Extra camera, pose, environment, or framing direction.'),
+  duration: z.number().refine(
+    (v) => (PRODUCT_ACTING_DURATIONS as readonly number[]).includes(v),
+    { message: 'duration must be 5, 10, or 15' },
+  ).optional().default(5).describe('Video duration in seconds. Valid values: 5, 10, or 15.'),
+  subtitles: z.boolean().optional().default(true).describe('Whether to burn word-level synced subtitles into the final video.'),
+  subtitle_style: z.enum(['hormozi', 'none']).optional().default('hormozi').describe('Subtitle style. Use none to disable subtitle rendering.'),
+  webhook_url: z.string().url().optional().describe('HTTPS URL to receive a callback when the job completes or fails.'),
+}).superRefine((val, ctx) => {
+  if (!val.script && !val.product_description) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ['product_description'],
+      message: 'Either script or product_description is required',
+    });
+    return;
+  }
+
+  if (!val.script) return;
+
+  const duration = val.duration ?? 5;
+  const maxWords = duration * PRODUCT_ACTING_WORDS_PER_SECOND;
+  const wordCount = val.script.trim().split(/\s+/).filter(Boolean).length;
+  if (wordCount > maxWords) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ['script'],
+      message: `Script has ${wordCount} words; max ${maxWords} for ${duration}s at ${PRODUCT_ACTING_WORDS_PER_SECOND} words/sec`,
+    });
+  }
+});
+
+export type ProductActingInput = z.infer<typeof ProductActingSchema>;