docs: add PageDraw visual design & architecture review

High-end design pass over the pagedraw editor styling and architecture
(lib + webapp integration). Scores each axis against a Linear/Figma-tier
app-chrome rubric and lays out a P0-P2 roadmap: token sweep to kill
hardcoded greys and unify the accent, an owned type ramp, custom-eased
micro-motion, double-bezel panel surfaces, a concentric radius scale,
z-index hygiene, and module-size/architecture notes.

.sqlx/query-05a880a2ece0236f57fe1c40100cba0c0cdcad2ebee0fecb88f9043ac7b82d8c.json

@@ -0,0 +1,179 @@
+{
+  "db_name": "MySQL",
+  "query": "\nSELECT\n  f.id as `id: u64`,\n  f.token as `token: FolderToken`,\n  f.name,\n  f.owner_user_token as `owner_user_token: UserToken`,\n  f.maybe_parent_folder_token as `maybe_parent_folder_token: FolderToken`,\n  f.maybe_last_media_file_token_1 as `maybe_last_media_file_token_1: MediaFileToken`,\n  f.maybe_last_media_file_token_2 as `maybe_last_media_file_token_2: MediaFileToken`,\n  f.maybe_last_media_file_token_3 as `maybe_last_media_file_token_3: MediaFileToken`,\n  f.maybe_last_media_file_token_4 as `maybe_last_media_file_token_4: MediaFileToken`,\n  f.maybe_cover_image_custom_media_token as `maybe_cover_image_custom_media_token: MediaFileToken`,\n  f.maybe_color_code,\n  f.has_star as `has_star: bool`,\n  f.created_at,\n  f.updated_at,\n  (\n    f.maybe_parent_folder_token IS NOT NULL\n    AND (p.token IS NULL OR p.maybe_deleted_at IS NOT NULL)\n  ) as `is_orphaned: bool`\nFROM folders f\nLEFT JOIN folders p\n  ON p.token = f.maybe_parent_folder_token\nWHERE f.owner_user_token = ?\n  AND f.maybe_deleted_at IS NULL\nORDER BY f.id DESC\nLIMIT ?\n        ",
+  "describe": {
+    "columns": [
+      {
+        "ordinal": 0,
+        "name": "id: u64",
+        "type_info": {
+          "type": "LongLong",
+          "flags": "NOT_NULL | PRIMARY_KEY | UNSIGNED | AUTO_INCREMENT",
+          "char_set": 63,
+          "max_size": 20
+        }
+      },
+      {
+        "ordinal": 1,
+        "name": "token: FolderToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 2,
+        "name": "name",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 1020
+        }
+      },
+      {
+        "ordinal": 3,
+        "name": "owner_user_token: UserToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 4,
+        "name": "maybe_parent_folder_token: FolderToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "MULTIPLE_KEY | BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 5,
+        "name": "maybe_last_media_file_token_1: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 6,
+        "name": "maybe_last_media_file_token_2: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 7,
+        "name": "maybe_last_media_file_token_3: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 8,
+        "name": "maybe_last_media_file_token_4: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 9,
+        "name": "maybe_cover_image_custom_media_token: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 10,
+        "name": "maybe_color_code",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 11,
+        "name": "has_star: bool",
+        "type_info": {
+          "type": "Tiny",
+          "flags": "NOT_NULL",
+          "char_set": 63,
+          "max_size": 1
+        }
+      },
+      {
+        "ordinal": 12,
+        "name": "created_at",
+        "type_info": {
+          "type": "Timestamp",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | TIMESTAMP",
+          "char_set": 63,
+          "max_size": 19
+        }
+      },
+      {
+        "ordinal": 13,
+        "name": "updated_at",
+        "type_info": {
+          "type": "Timestamp",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | TIMESTAMP | ON_UPDATE_NOW",
+          "char_set": 63,
+          "max_size": 19
+        }
+      },
+      {
+        "ordinal": 14,
+        "name": "is_orphaned: bool",
+        "type_info": {
+          "type": "LongLong",
+          "flags": "NOT_NULL | BINARY",
+          "char_set": 63,
+          "max_size": 1
+        }
+      }
+    ],
+    "parameters": {
+      "Right": 2
+    },
+    "nullable": [
+      false,
+      false,
+      false,
+      false,
+      true,
+      true,
+      true,
+      true,
+      true,
+      true,
+      true,
+      false,
+      false,
+      false,
+      false
+    ]
+  },
+  "hash": "05a880a2ece0236f57fe1c40100cba0c0cdcad2ebee0fecb88f9043ac7b82d8c"
+}

.sqlx/query-0c918aacf4ce34e1e03d2f9af49dd3138cadf59a28d0917726135ed5f34cba5e.json

@@ -0,0 +1,179 @@
+{
+  "db_name": "MySQL",
+  "query": "\nSELECT\n  f.id as `id: u64`,\n  f.token as `token: FolderToken`,\n  f.name,\n  f.owner_user_token as `owner_user_token: UserToken`,\n  f.maybe_parent_folder_token as `maybe_parent_folder_token: FolderToken`,\n  f.maybe_last_media_file_token_1 as `maybe_last_media_file_token_1: MediaFileToken`,\n  f.maybe_last_media_file_token_2 as `maybe_last_media_file_token_2: MediaFileToken`,\n  f.maybe_last_media_file_token_3 as `maybe_last_media_file_token_3: MediaFileToken`,\n  f.maybe_last_media_file_token_4 as `maybe_last_media_file_token_4: MediaFileToken`,\n  f.maybe_cover_image_custom_media_token as `maybe_cover_image_custom_media_token: MediaFileToken`,\n  f.maybe_color_code,\n  f.has_star as `has_star: bool`,\n  f.created_at,\n  f.updated_at,\n  (\n    f.maybe_parent_folder_token IS NOT NULL\n    AND (p.token IS NULL OR p.maybe_deleted_at IS NOT NULL)\n  ) as `is_orphaned: bool`\nFROM folders f\nLEFT JOIN folders p\n  ON p.token = f.maybe_parent_folder_token\nWHERE f.token = ?\n  AND f.owner_user_token = ?\n  AND f.maybe_deleted_at IS NULL\nLIMIT 1\n    ",
+  "describe": {
+    "columns": [
+      {
+        "ordinal": 0,
+        "name": "id: u64",
+        "type_info": {
+          "type": "LongLong",
+          "flags": "NOT_NULL | PRIMARY_KEY | UNSIGNED | AUTO_INCREMENT",
+          "char_set": 63,
+          "max_size": 20
+        }
+      },
+      {
+        "ordinal": 1,
+        "name": "token: FolderToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 2,
+        "name": "name",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 1020
+        }
+      },
+      {
+        "ordinal": 3,
+        "name": "owner_user_token: UserToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 4,
+        "name": "maybe_parent_folder_token: FolderToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "MULTIPLE_KEY | BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 5,
+        "name": "maybe_last_media_file_token_1: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 6,
+        "name": "maybe_last_media_file_token_2: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 7,
+        "name": "maybe_last_media_file_token_3: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 8,
+        "name": "maybe_last_media_file_token_4: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 9,
+        "name": "maybe_cover_image_custom_media_token: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 10,
+        "name": "maybe_color_code",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 11,
+        "name": "has_star: bool",
+        "type_info": {
+          "type": "Tiny",
+          "flags": "NOT_NULL",
+          "char_set": 63,
+          "max_size": 1
+        }
+      },
+      {
+        "ordinal": 12,
+        "name": "created_at",
+        "type_info": {
+          "type": "Timestamp",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | TIMESTAMP",
+          "char_set": 63,
+          "max_size": 19
+        }
+      },
+      {
+        "ordinal": 13,
+        "name": "updated_at",
+        "type_info": {
+          "type": "Timestamp",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | TIMESTAMP | ON_UPDATE_NOW",
+          "char_set": 63,
+          "max_size": 19
+        }
+      },
+      {
+        "ordinal": 14,
+        "name": "is_orphaned: bool",
+        "type_info": {
+          "type": "LongLong",
+          "flags": "NOT_NULL | BINARY",
+          "char_set": 63,
+          "max_size": 1
+        }
+      }
+    ],
+    "parameters": {
+      "Right": 2
+    },
+    "nullable": [
+      false,
+      false,
+      false,
+      false,
+      true,
+      true,
+      true,
+      true,
+      true,
+      true,
+      true,
+      false,
+      false,
+      false,
+      false
+    ]
+  },
+  "hash": "0c918aacf4ce34e1e03d2f9af49dd3138cadf59a28d0917726135ed5f34cba5e"
+}

.sqlx/query-1359fb54af12d78251fe435b063771984ee00d74a71b5d29e9df267991f38522.json

@@ -0,0 +1,12 @@
+{
+  "db_name": "MySQL",
+  "query": "\nINSERT INTO user_email_changes\nSET\n  user_token = ?,\n  old_email = ?,\n  new_email = ?,\n  ip_address = ?,\n  maybe_changed_by_user_token = ?\n    ",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 5
+    },
+    "nullable": []
+  },
+  "hash": "1359fb54af12d78251fe435b063771984ee00d74a71b5d29e9df267991f38522"
+}

.sqlx/query-197e4fb3822b095cbbf8127493dad91c9254b7c242b8921a8c2df9f5a0e77424.json

@@ -0,0 +1,12 @@
+{
+  "db_name": "MySQL",
+  "query": "\nUPDATE folders\nSET maybe_cover_image_custom_media_token = ?\nWHERE token = ?\n  AND owner_user_token = ?\n  AND maybe_deleted_at IS NULL\nLIMIT 1\n    ",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 3
+    },
+    "nullable": []
+  },
+  "hash": "197e4fb3822b095cbbf8127493dad91c9254b7c242b8921a8c2df9f5a0e77424"
+}

.sqlx/query-24716cfdb77eee365bd605a40cecb02b3a27a90725dbe96e3865545d14839ab8.json

@@ -0,0 +1,12 @@
+{
+  "db_name": "MySQL",
+  "query": "\nUPDATE folders\nSET has_star = ?\nWHERE token = ?\n  AND owner_user_token = ?\n  AND maybe_deleted_at IS NULL\nLIMIT 1\n    ",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 3
+    },
+    "nullable": []
+  },
+  "hash": "24716cfdb77eee365bd605a40cecb02b3a27a90725dbe96e3865545d14839ab8"
+}

.sqlx/query-491980e0a555a900354e60525947d77548a6cb8e4305d13886c8ad7e6787476c.json

@@ -0,0 +1,157 @@
+{
+  "db_name": "MySQL",
+  "query": "\nSELECT\n  fmf.id as `membership_id: u64`,\n  fmf.created_at as `added_to_folder_at: DateTime<Utc>`,\n  mf.token as `media_file_token: MediaFileToken`,\n  mf.media_type,\n  mf.media_class,\n  mf.maybe_mime_type,\n  mf.public_bucket_directory_hash,\n  mf.maybe_public_bucket_prefix,\n  mf.maybe_public_bucket_extension,\n  mf.maybe_frame_width,\n  mf.maybe_frame_height,\n  mf.maybe_duration_millis,\n  mf.maybe_title\nFROM folder_media_files fmf\nJOIN media_files mf\n  ON mf.token = fmf.media_file_token\nWHERE fmf.folder_token = ?\n  AND mf.user_deleted_at IS NULL\n  AND mf.mod_deleted_at IS NULL\nORDER BY fmf.id DESC\nLIMIT ?\n        ",
+  "describe": {
+    "columns": [
+      {
+        "ordinal": 0,
+        "name": "membership_id: u64",
+        "type_info": {
+          "type": "LongLong",
+          "flags": "NOT_NULL | UNIQUE_KEY | UNSIGNED | AUTO_INCREMENT",
+          "char_set": 63,
+          "max_size": 20
+        }
+      },
+      {
+        "ordinal": 1,
+        "name": "added_to_folder_at: DateTime<Utc>",
+        "type_info": {
+          "type": "Timestamp",
+          "flags": "NOT_NULL | BINARY | TIMESTAMP",
+          "char_set": 63,
+          "max_size": 19
+        }
+      },
+      {
+        "ordinal": 2,
+        "name": "media_file_token: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 3,
+        "name": "media_type",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 4,
+        "name": "media_class",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 5,
+        "name": "maybe_mime_type",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 6,
+        "name": "public_bucket_directory_hash",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 7,
+        "name": "maybe_public_bucket_prefix",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 8,
+        "name": "maybe_public_bucket_extension",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 9,
+        "name": "maybe_frame_width",
+        "type_info": {
+          "type": "Long",
+          "flags": "",
+          "char_set": 63,
+          "max_size": 5
+        }
+      },
+      {
+        "ordinal": 10,
+        "name": "maybe_frame_height",
+        "type_info": {
+          "type": "Long",
+          "flags": "",
+          "char_set": 63,
+          "max_size": 5
+        }
+      },
+      {
+        "ordinal": 11,
+        "name": "maybe_duration_millis",
+        "type_info": {
+          "type": "Long",
+          "flags": "",
+          "char_set": 63,
+          "max_size": 10
+        }
+      },
+      {
+        "ordinal": 12,
+        "name": "maybe_title",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 1020
+        }
+      }
+    ],
+    "parameters": {
+      "Right": 2
+    },
+    "nullable": [
+      false,
+      false,
+      false,
+      false,
+      false,
+      true,
+      false,
+      true,
+      true,
+      true,
+      true,
+      true,
+      true
+    ]
+  },
+  "hash": "491980e0a555a900354e60525947d77548a6cb8e4305d13886c8ad7e6787476c"
+}

.sqlx/query-5606a694c872d868ab3b35f4b3685f86f2b27ad16e741c8b1bf997b613f1b803.json

@@ -0,0 +1,58 @@
+{
+  "db_name": "MySQL",
+  "query": "\nSELECT\n  maybe_creator_user_token as `maybe_creator_user_token: UserToken`,\n  media_class as `media_class: MediaFileClass`,\n  media_type as `media_type: MediaFileType`,\n  maybe_cover_image_media_file_token as `maybe_cover_image_media_file_token: MediaFileToken`\nFROM media_files\nWHERE token = ?\n  AND user_deleted_at IS NULL\n  AND mod_deleted_at IS NULL\nLIMIT 1\n    ",
+  "describe": {
+    "columns": [
+      {
+        "ordinal": 0,
+        "name": "maybe_creator_user_token: UserToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "MULTIPLE_KEY | BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 1,
+        "name": "media_class: MediaFileClass",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 2,
+        "name": "media_type: MediaFileType",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 3,
+        "name": "maybe_cover_image_media_file_token: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      }
+    ],
+    "parameters": {
+      "Right": 1
+    },
+    "nullable": [
+      true,
+      false,
+      false,
+      true
+    ]
+  },
+  "hash": "5606a694c872d868ab3b35f4b3685f86f2b27ad16e741c8b1bf997b613f1b803"
+}

.sqlx/query-5611678b6c168208ea4da9ef0e3071758c9bb8d89b54e2d3f0fc84bd0a6c915f.json

@@ -0,0 +1,157 @@
+{
+  "db_name": "MySQL",
+  "query": "\nSELECT\n  uec.id as `id: u64`,\n  uec.old_email,\n  uec.new_email,\n  uec.ip_address,\n  uec.created_at,\n\n  u_subject.token as `user_token: tokens::tokens::users::UserToken`,\n  u_subject.username as user_username,\n  u_subject.display_name as user_display_name,\n  u_subject.email_gravatar_hash as user_gravatar_hash,\n\n  u_changer.token as `maybe_changed_by_user_token?: tokens::tokens::users::UserToken`,\n  u_changer.username as `maybe_changed_by_user_username?`,\n  u_changer.display_name as `maybe_changed_by_user_display_name?`,\n  u_changer.email_gravatar_hash as `maybe_changed_by_user_gravatar_hash?`\n\nFROM user_email_changes AS uec\nJOIN users AS u_subject\n  ON uec.user_token = u_subject.token\nLEFT JOIN users AS u_changer\n  ON uec.maybe_changed_by_user_token = u_changer.token\nWHERE uec.user_token = ?\n  AND uec.id < ?\nORDER BY uec.id DESC\nLIMIT ?\n        ",
+  "describe": {
+    "columns": [
+      {
+        "ordinal": 0,
+        "name": "id: u64",
+        "type_info": {
+          "type": "LongLong",
+          "flags": "NOT_NULL | PRIMARY_KEY | UNSIGNED | AUTO_INCREMENT",
+          "char_set": 63,
+          "max_size": 20
+        }
+      },
+      {
+        "ordinal": 1,
+        "name": "old_email",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 1020
+        }
+      },
+      {
+        "ordinal": 2,
+        "name": "new_email",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 1020
+        }
+      },
+      {
+        "ordinal": 3,
+        "name": "ip_address",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 160
+        }
+      },
+      {
+        "ordinal": 4,
+        "name": "created_at",
+        "type_info": {
+          "type": "Timestamp",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | TIMESTAMP",
+          "char_set": 63,
+          "max_size": 19
+        }
+      },
+      {
+        "ordinal": 5,
+        "name": "user_token: tokens::tokens::users::UserToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 6,
+        "name": "user_username",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 80
+        }
+      },
+      {
+        "ordinal": 7,
+        "name": "user_display_name",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 80
+        }
+      },
+      {
+        "ordinal": 8,
+        "name": "user_gravatar_hash",
+        "type_info": {
+          "type": "String",
+          "flags": "NOT_NULL | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 9,
+        "name": "maybe_changed_by_user_token?: tokens::tokens::users::UserToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 10,
+        "name": "maybe_changed_by_user_username?",
+        "type_info": {
+          "type": "VarString",
+          "flags": "UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 80
+        }
+      },
+      {
+        "ordinal": 11,
+        "name": "maybe_changed_by_user_display_name?",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 80
+        }
+      },
+      {
+        "ordinal": 12,
+        "name": "maybe_changed_by_user_gravatar_hash?",
+        "type_info": {
+          "type": "String",
+          "flags": "BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      }
+    ],
+    "parameters": {
+      "Right": 3
+    },
+    "nullable": [
+      false,
+      false,
+      false,
+      false,
+      false,
+      false,
+      false,
+      false,
+      false,
+      true,
+      true,
+      true,
+      true
+    ]
+  },
+  "hash": "5611678b6c168208ea4da9ef0e3071758c9bb8d89b54e2d3f0fc84bd0a6c915f"
+}

.sqlx/query-6a0e3f012795068a56a0dfaf567d066dc157bb06c736c1c4314b18c8e0356127.json

@@ -0,0 +1,12 @@
+{
+  "db_name": "MySQL",
+  "query": "\nUPDATE folders\nSET maybe_color_code = ?\nWHERE token = ?\n  AND owner_user_token = ?\n  AND maybe_deleted_at IS NULL\nLIMIT 1\n    ",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 3
+    },
+    "nullable": []
+  },
+  "hash": "6a0e3f012795068a56a0dfaf567d066dc157bb06c736c1c4314b18c8e0356127"
+}

.sqlx/query-780891e8294b78cc0e5a05a8b5a8949a763bcb8c5d6526a621234020b154bdc9.json

@@ -0,0 +1,25 @@
+{
+  "db_name": "MySQL",
+  "query": "\nWITH RECURSIVE ancestor_chain (token, parent_token, depth) AS (\n  SELECT token, maybe_parent_folder_token, 0\n  FROM folders\n  WHERE token = ?\n    AND owner_user_token = ?\n    AND maybe_deleted_at IS NULL\n  UNION ALL\n  SELECT f.token, f.maybe_parent_folder_token, ac.depth + 1\n  FROM folders f\n  INNER JOIN ancestor_chain ac\n    ON f.token = ac.parent_token\n  WHERE f.owner_user_token = ?\n    AND f.maybe_deleted_at IS NULL\n    AND ac.depth < ?\n)\nSELECT token as `token!: FolderToken`\nFROM ancestor_chain\nWHERE depth > 0\nORDER BY depth ASC\n    ",
+  "describe": {
+    "columns": [
+      {
+        "ordinal": 0,
+        "name": "token!: FolderToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      }
+    ],
+    "parameters": {
+      "Right": 4
+    },
+    "nullable": [
+      true
+    ]
+  },
+  "hash": "780891e8294b78cc0e5a05a8b5a8949a763bcb8c5d6526a621234020b154bdc9"
+}

.sqlx/query-a13680fb2b54809b6d9d9356f8eec87cd0f1f37405b84bbf734ed06cc244efb1.json

@@ -0,0 +1,168 @@
+{
+  "db_name": "MySQL",
+  "query": "\nSELECT\n  f.id as `id: u64`,\n  f.token as `token: FolderToken`,\n  f.name,\n  f.owner_user_token as `owner_user_token: UserToken`,\n  f.maybe_parent_folder_token as `maybe_parent_folder_token: FolderToken`,\n  f.maybe_last_media_file_token_1 as `maybe_last_media_file_token_1: MediaFileToken`,\n  f.maybe_last_media_file_token_2 as `maybe_last_media_file_token_2: MediaFileToken`,\n  f.maybe_last_media_file_token_3 as `maybe_last_media_file_token_3: MediaFileToken`,\n  f.maybe_last_media_file_token_4 as `maybe_last_media_file_token_4: MediaFileToken`,\n  f.maybe_cover_image_custom_media_token as `maybe_cover_image_custom_media_token: MediaFileToken`,\n  f.maybe_color_code,\n  f.has_star as `has_star: bool`,\n  f.created_at,\n  f.updated_at\nFROM folders f\nWHERE f.maybe_parent_folder_token = ?\n  AND f.owner_user_token = ?\n  AND f.maybe_deleted_at IS NULL\nORDER BY f.id DESC\nLIMIT ?\n        ",
+  "describe": {
+    "columns": [
+      {
+        "ordinal": 0,
+        "name": "id: u64",
+        "type_info": {
+          "type": "LongLong",
+          "flags": "NOT_NULL | PRIMARY_KEY | UNSIGNED | AUTO_INCREMENT",
+          "char_set": 63,
+          "max_size": 20
+        }
+      },
+      {
+        "ordinal": 1,
+        "name": "token: FolderToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 2,
+        "name": "name",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 1020
+        }
+      },
+      {
+        "ordinal": 3,
+        "name": "owner_user_token: UserToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 4,
+        "name": "maybe_parent_folder_token: FolderToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "MULTIPLE_KEY | BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 5,
+        "name": "maybe_last_media_file_token_1: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 6,
+        "name": "maybe_last_media_file_token_2: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 7,
+        "name": "maybe_last_media_file_token_3: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 8,
+        "name": "maybe_last_media_file_token_4: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 9,
+        "name": "maybe_cover_image_custom_media_token: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 10,
+        "name": "maybe_color_code",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 11,
+        "name": "has_star: bool",
+        "type_info": {
+          "type": "Tiny",
+          "flags": "NOT_NULL",
+          "char_set": 63,
+          "max_size": 1
+        }
+      },
+      {
+        "ordinal": 12,
+        "name": "created_at",
+        "type_info": {
+          "type": "Timestamp",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | TIMESTAMP",
+          "char_set": 63,
+          "max_size": 19
+        }
+      },
+      {
+        "ordinal": 13,
+        "name": "updated_at",
+        "type_info": {
+          "type": "Timestamp",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | TIMESTAMP | ON_UPDATE_NOW",
+          "char_set": 63,
+          "max_size": 19
+        }
+      }
+    ],
+    "parameters": {
+      "Right": 3
+    },
+    "nullable": [
+      false,
+      false,
+      false,
+      false,
+      true,
+      true,
+      true,
+      true,
+      true,
+      true,
+      true,
+      false,
+      false,
+      false
+    ]
+  },
+  "hash": "a13680fb2b54809b6d9d9356f8eec87cd0f1f37405b84bbf734ed06cc244efb1"
+}

.sqlx/query-c099b274026619760f0982f0e5082da1e8de16c26122f2750667b9cdc2c4abf3.json

@@ -0,0 +1,12 @@
+{
+  "db_name": "MySQL",
+  "query": "\nINSERT INTO folders\nSET\n  token = ?,\n  name = ?,\n  owner_user_token = ?,\n  maybe_parent_folder_token = ?,\n  maybe_color_code = ?\n    ",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 5
+    },
+    "nullable": []
+  },
+  "hash": "c099b274026619760f0982f0e5082da1e8de16c26122f2750667b9cdc2c4abf3"
+}

.sqlx/query-c17e1d6b567dd378bb4cb0478fb9558e907a0f36498bd049c7c526e496e89259.json

@@ -0,0 +1,157 @@
+{
+  "db_name": "MySQL",
+  "query": "\nSELECT\n  uec.id as `id: u64`,\n  uec.old_email,\n  uec.new_email,\n  uec.ip_address,\n  uec.created_at,\n\n  u_subject.token as `user_token: tokens::tokens::users::UserToken`,\n  u_subject.username as user_username,\n  u_subject.display_name as user_display_name,\n  u_subject.email_gravatar_hash as user_gravatar_hash,\n\n  u_changer.token as `maybe_changed_by_user_token?: tokens::tokens::users::UserToken`,\n  u_changer.username as `maybe_changed_by_user_username?`,\n  u_changer.display_name as `maybe_changed_by_user_display_name?`,\n  u_changer.email_gravatar_hash as `maybe_changed_by_user_gravatar_hash?`\n\nFROM user_email_changes AS uec\nJOIN users AS u_subject\n  ON uec.user_token = u_subject.token\nLEFT JOIN users AS u_changer\n  ON uec.maybe_changed_by_user_token = u_changer.token\nWHERE uec.user_token = ?\nORDER BY uec.id DESC\nLIMIT ?\n        ",
+  "describe": {
+    "columns": [
+      {
+        "ordinal": 0,
+        "name": "id: u64",
+        "type_info": {
+          "type": "LongLong",
+          "flags": "NOT_NULL | PRIMARY_KEY | UNSIGNED | AUTO_INCREMENT",
+          "char_set": 63,
+          "max_size": 20
+        }
+      },
+      {
+        "ordinal": 1,
+        "name": "old_email",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 1020
+        }
+      },
+      {
+        "ordinal": 2,
+        "name": "new_email",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 1020
+        }
+      },
+      {
+        "ordinal": 3,
+        "name": "ip_address",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 160
+        }
+      },
+      {
+        "ordinal": 4,
+        "name": "created_at",
+        "type_info": {
+          "type": "Timestamp",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | TIMESTAMP",
+          "char_set": 63,
+          "max_size": 19
+        }
+      },
+      {
+        "ordinal": 5,
+        "name": "user_token: tokens::tokens::users::UserToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 6,
+        "name": "user_username",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 80
+        }
+      },
+      {
+        "ordinal": 7,
+        "name": "user_display_name",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 80
+        }
+      },
+      {
+        "ordinal": 8,
+        "name": "user_gravatar_hash",
+        "type_info": {
+          "type": "String",
+          "flags": "NOT_NULL | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 9,
+        "name": "maybe_changed_by_user_token?: tokens::tokens::users::UserToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 10,
+        "name": "maybe_changed_by_user_username?",
+        "type_info": {
+          "type": "VarString",
+          "flags": "UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 80
+        }
+      },
+      {
+        "ordinal": 11,
+        "name": "maybe_changed_by_user_display_name?",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 80
+        }
+      },
+      {
+        "ordinal": 12,
+        "name": "maybe_changed_by_user_gravatar_hash?",
+        "type_info": {
+          "type": "String",
+          "flags": "BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      }
+    ],
+    "parameters": {
+      "Right": 2
+    },
+    "nullable": [
+      false,
+      false,
+      false,
+      false,
+      false,
+      false,
+      false,
+      false,
+      false,
+      true,
+      true,
+      true,
+      true
+    ]
+  },
+  "hash": "c17e1d6b567dd378bb4cb0478fb9558e907a0f36498bd049c7c526e496e89259"
+}

.sqlx/query-d6f0c65abce2da20fe86805ff053b8c2569bf0095f6245a5529f0c71854a604b.json

@@ -0,0 +1,179 @@
+{
+  "db_name": "MySQL",
+  "query": "\nSELECT\n  f.id as `id: u64`,\n  f.token as `token: FolderToken`,\n  f.name,\n  f.owner_user_token as `owner_user_token: UserToken`,\n  f.maybe_parent_folder_token as `maybe_parent_folder_token: FolderToken`,\n  f.maybe_last_media_file_token_1 as `maybe_last_media_file_token_1: MediaFileToken`,\n  f.maybe_last_media_file_token_2 as `maybe_last_media_file_token_2: MediaFileToken`,\n  f.maybe_last_media_file_token_3 as `maybe_last_media_file_token_3: MediaFileToken`,\n  f.maybe_last_media_file_token_4 as `maybe_last_media_file_token_4: MediaFileToken`,\n  f.maybe_cover_image_custom_media_token as `maybe_cover_image_custom_media_token: MediaFileToken`,\n  f.maybe_color_code,\n  f.has_star as `has_star: bool`,\n  f.created_at,\n  f.updated_at,\n  (\n    f.maybe_parent_folder_token IS NOT NULL\n    AND (p.token IS NULL OR p.maybe_deleted_at IS NOT NULL)\n  ) as `is_orphaned: bool`\nFROM folders f\nLEFT JOIN folders p\n  ON p.token = f.maybe_parent_folder_token\nWHERE f.owner_user_token = ?\n  AND f.maybe_deleted_at IS NULL\n  AND f.id < ?\nORDER BY f.id DESC\nLIMIT ?\n        ",
+  "describe": {
+    "columns": [
+      {
+        "ordinal": 0,
+        "name": "id: u64",
+        "type_info": {
+          "type": "LongLong",
+          "flags": "NOT_NULL | PRIMARY_KEY | UNSIGNED | AUTO_INCREMENT",
+          "char_set": 63,
+          "max_size": 20
+        }
+      },
+      {
+        "ordinal": 1,
+        "name": "token: FolderToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 2,
+        "name": "name",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 1020
+        }
+      },
+      {
+        "ordinal": 3,
+        "name": "owner_user_token: UserToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 4,
+        "name": "maybe_parent_folder_token: FolderToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "MULTIPLE_KEY | BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 5,
+        "name": "maybe_last_media_file_token_1: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 6,
+        "name": "maybe_last_media_file_token_2: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 7,
+        "name": "maybe_last_media_file_token_3: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 8,
+        "name": "maybe_last_media_file_token_4: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 9,
+        "name": "maybe_cover_image_custom_media_token: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 10,
+        "name": "maybe_color_code",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 11,
+        "name": "has_star: bool",
+        "type_info": {
+          "type": "Tiny",
+          "flags": "NOT_NULL",
+          "char_set": 63,
+          "max_size": 1
+        }
+      },
+      {
+        "ordinal": 12,
+        "name": "created_at",
+        "type_info": {
+          "type": "Timestamp",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | TIMESTAMP",
+          "char_set": 63,
+          "max_size": 19
+        }
+      },
+      {
+        "ordinal": 13,
+        "name": "updated_at",
+        "type_info": {
+          "type": "Timestamp",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | TIMESTAMP | ON_UPDATE_NOW",
+          "char_set": 63,
+          "max_size": 19
+        }
+      },
+      {
+        "ordinal": 14,
+        "name": "is_orphaned: bool",
+        "type_info": {
+          "type": "LongLong",
+          "flags": "NOT_NULL | BINARY",
+          "char_set": 63,
+          "max_size": 1
+        }
+      }
+    ],
+    "parameters": {
+      "Right": 3
+    },
+    "nullable": [
+      false,
+      false,
+      false,
+      false,
+      true,
+      true,
+      true,
+      true,
+      true,
+      true,
+      true,
+      false,
+      false,
+      false,
+      false
+    ]
+  },
+  "hash": "d6f0c65abce2da20fe86805ff053b8c2569bf0095f6245a5529f0c71854a604b"
+}

.sqlx/query-d85c1a844f14b9416c6260d7a906fec709b50eb4583b98dffb52ebbe6abcb7d5.json

@@ -0,0 +1,168 @@
+{
+  "db_name": "MySQL",
+  "query": "\nSELECT\n  f.id as `id: u64`,\n  f.token as `token: FolderToken`,\n  f.name,\n  f.owner_user_token as `owner_user_token: UserToken`,\n  f.maybe_parent_folder_token as `maybe_parent_folder_token: FolderToken`,\n  f.maybe_last_media_file_token_1 as `maybe_last_media_file_token_1: MediaFileToken`,\n  f.maybe_last_media_file_token_2 as `maybe_last_media_file_token_2: MediaFileToken`,\n  f.maybe_last_media_file_token_3 as `maybe_last_media_file_token_3: MediaFileToken`,\n  f.maybe_last_media_file_token_4 as `maybe_last_media_file_token_4: MediaFileToken`,\n  f.maybe_cover_image_custom_media_token as `maybe_cover_image_custom_media_token: MediaFileToken`,\n  f.maybe_color_code,\n  f.has_star as `has_star: bool`,\n  f.created_at,\n  f.updated_at\nFROM folders f\nWHERE f.maybe_parent_folder_token = ?\n  AND f.owner_user_token = ?\n  AND f.maybe_deleted_at IS NULL\n  AND f.id < ?\nORDER BY f.id DESC\nLIMIT ?\n        ",
+  "describe": {
+    "columns": [
+      {
+        "ordinal": 0,
+        "name": "id: u64",
+        "type_info": {
+          "type": "LongLong",
+          "flags": "NOT_NULL | PRIMARY_KEY | UNSIGNED | AUTO_INCREMENT",
+          "char_set": 63,
+          "max_size": 20
+        }
+      },
+      {
+        "ordinal": 1,
+        "name": "token: FolderToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 2,
+        "name": "name",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 1020
+        }
+      },
+      {
+        "ordinal": 3,
+        "name": "owner_user_token: UserToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 4,
+        "name": "maybe_parent_folder_token: FolderToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "MULTIPLE_KEY | BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 5,
+        "name": "maybe_last_media_file_token_1: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 6,
+        "name": "maybe_last_media_file_token_2: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 7,
+        "name": "maybe_last_media_file_token_3: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 8,
+        "name": "maybe_last_media_file_token_4: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 9,
+        "name": "maybe_cover_image_custom_media_token: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 10,
+        "name": "maybe_color_code",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 11,
+        "name": "has_star: bool",
+        "type_info": {
+          "type": "Tiny",
+          "flags": "NOT_NULL",
+          "char_set": 63,
+          "max_size": 1
+        }
+      },
+      {
+        "ordinal": 12,
+        "name": "created_at",
+        "type_info": {
+          "type": "Timestamp",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | TIMESTAMP",
+          "char_set": 63,
+          "max_size": 19
+        }
+      },
+      {
+        "ordinal": 13,
+        "name": "updated_at",
+        "type_info": {
+          "type": "Timestamp",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | TIMESTAMP | ON_UPDATE_NOW",
+          "char_set": 63,
+          "max_size": 19
+        }
+      }
+    ],
+    "parameters": {
+      "Right": 4
+    },
+    "nullable": [
+      false,
+      false,
+      false,
+      false,
+      true,
+      true,
+      true,
+      true,
+      true,
+      true,
+      true,
+      false,
+      false,
+      false
+    ]
+  },
+  "hash": "d85c1a844f14b9416c6260d7a906fec709b50eb4583b98dffb52ebbe6abcb7d5"
+}

.sqlx/query-e32e195ef41bc833e5b7fc53cfde8669f88aeb66d279e5213d047f4860ec86ab.json

@@ -0,0 +1,12 @@
+{
+  "db_name": "MySQL",
+  "query": "\nUPDATE folders\nSET name = ?\nWHERE token = ?\n  AND owner_user_token = ?\n  AND maybe_deleted_at IS NULL\nLIMIT 1\n    ",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 3
+    },
+    "nullable": []
+  },
+  "hash": "e32e195ef41bc833e5b7fc53cfde8669f88aeb66d279e5213d047f4860ec86ab"
+}

.sqlx/query-ea5f5e5b3caf990e9c25a3e8fe2e9625c12d6a36dd5dd91fc4615a45acdd33b8.json

@@ -0,0 +1,157 @@
+{
+  "db_name": "MySQL",
+  "query": "\nSELECT\n  fmf.id as `membership_id: u64`,\n  fmf.created_at as `added_to_folder_at: DateTime<Utc>`,\n  mf.token as `media_file_token: MediaFileToken`,\n  mf.media_type,\n  mf.media_class,\n  mf.maybe_mime_type,\n  mf.public_bucket_directory_hash,\n  mf.maybe_public_bucket_prefix,\n  mf.maybe_public_bucket_extension,\n  mf.maybe_frame_width,\n  mf.maybe_frame_height,\n  mf.maybe_duration_millis,\n  mf.maybe_title\nFROM folder_media_files fmf\nJOIN media_files mf\n  ON mf.token = fmf.media_file_token\nWHERE fmf.folder_token = ?\n  AND mf.user_deleted_at IS NULL\n  AND mf.mod_deleted_at IS NULL\n  AND fmf.id < ?\nORDER BY fmf.id DESC\nLIMIT ?\n        ",
+  "describe": {
+    "columns": [
+      {
+        "ordinal": 0,
+        "name": "membership_id: u64",
+        "type_info": {
+          "type": "LongLong",
+          "flags": "NOT_NULL | UNIQUE_KEY | UNSIGNED | AUTO_INCREMENT",
+          "char_set": 63,
+          "max_size": 20
+        }
+      },
+      {
+        "ordinal": 1,
+        "name": "added_to_folder_at: DateTime<Utc>",
+        "type_info": {
+          "type": "Timestamp",
+          "flags": "NOT_NULL | BINARY | TIMESTAMP",
+          "char_set": 63,
+          "max_size": 19
+        }
+      },
+      {
+        "ordinal": 2,
+        "name": "media_file_token: MediaFileToken",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | UNIQUE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 3,
+        "name": "media_type",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 4,
+        "name": "media_class",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | MULTIPLE_KEY | BINARY",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 5,
+        "name": "maybe_mime_type",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 6,
+        "name": "public_bucket_directory_hash",
+        "type_info": {
+          "type": "VarString",
+          "flags": "NOT_NULL | BINARY | NO_DEFAULT_VALUE",
+          "char_set": 224,
+          "max_size": 128
+        }
+      },
+      {
+        "ordinal": 7,
+        "name": "maybe_public_bucket_prefix",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 8,
+        "name": "maybe_public_bucket_extension",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 64
+        }
+      },
+      {
+        "ordinal": 9,
+        "name": "maybe_frame_width",
+        "type_info": {
+          "type": "Long",
+          "flags": "",
+          "char_set": 63,
+          "max_size": 5
+        }
+      },
+      {
+        "ordinal": 10,
+        "name": "maybe_frame_height",
+        "type_info": {
+          "type": "Long",
+          "flags": "",
+          "char_set": 63,
+          "max_size": 5
+        }
+      },
+      {
+        "ordinal": 11,
+        "name": "maybe_duration_millis",
+        "type_info": {
+          "type": "Long",
+          "flags": "",
+          "char_set": 63,
+          "max_size": 10
+        }
+      },
+      {
+        "ordinal": 12,
+        "name": "maybe_title",
+        "type_info": {
+          "type": "VarString",
+          "flags": "BINARY",
+          "char_set": 224,
+          "max_size": 1020
+        }
+      }
+    ],
+    "parameters": {
+      "Right": 3
+    },
+    "nullable": [
+      false,
+      false,
+      false,
+      false,
+      false,
+      true,
+      false,
+      true,
+      true,
+      true,
+      true,
+      true,
+      true
+    ]
+  },
+  "hash": "ea5f5e5b3caf990e9c25a3e8fe2e9625c12d6a36dd5dd91fc4615a45acdd33b8"
+}

.sqlx/query-f9e3ff8ca682948076b799d6b2d934be4a87a4e04665d6f12cc32095494129ad.json

@@ -0,0 +1,12 @@
+{
+  "db_name": "MySQL",
+  "query": "\nUPDATE folders\nSET maybe_deleted_at = NOW()\nWHERE token = ?\n  AND owner_user_token = ?\n  AND maybe_deleted_at IS NULL\nLIMIT 1\n    ",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 2
+    },
+    "nullable": []
+  },
+  "hash": "f9e3ff8ca682948076b799d6b2d934be4a87a4e04665d6f12cc32095494129ad"
+}

Cargo.lock

@@ -805,11 +805,11 @@ dependencies = [
  "gmicloud_client",
  "grok_api_client",
  "log",
- "muapi_client",
  "reqwest 0.12.23",
  "seedance2pro_client",
  "serde",
  "serde_derive",
+ "serde_json",
  "strum",
  "test_data",
  "tokens",

_database/sql/actions_and_analytics/artcraft/artcraft_jobs_daily_generations_by_model_type.sql

@@ -0,0 +1,23 @@
+-- Daily ArtCraft generations broken down by model_type since January 1st, 2026.
+-- One row per (day, model_type) pair.
+
+SELECT
+  DATE(created_at) AS day,
+  maybe_model_type AS model_type,
+  COUNT(*) AS generations
+FROM generic_inference_jobs
+WHERE created_at >= '2026-01-01'
+  AND maybe_model_type IS NOT NULL
+  AND job_type NOT IN (
+    'gpt_sovits',
+    'tacotron2',
+    'rvc_v2',
+    'f5_tts',
+    'so_vits_svc',
+    'styletts2',
+    'face_fusion',
+    'seed_vc',
+    'comfy_ui'
+  )
+GROUP BY day, model_type
+ORDER BY day DESC, generations DESC;

_database/sql/actions_and_analytics/artcraft/artcraft_paying_user_signup_sources.sql

@@ -0,0 +1,53 @@
+select
+    u.created_at,
+    CASE
+        WHEN u.maybe_landing_url LIKE '%?r=%' THEN 'user_referral'
+        WHEN u.maybe_landing_url LIKE '%gad_source%' THEN 'google_ads'
+        WHEN u.maybe_landing_url LIKE '%utm_source=fakeyou%' THEN 'fakeyou'
+        WHEN u.maybe_landing_url LIKE '%utm_source=storyteller%' THEN 'storyteller'
+        WHEN u.maybe_landing_url LIKE '%utm_source=artcraftai%' THEN 'artcraft_dot_ai_domain'
+        WHEN u.maybe_referral_url LIKE '%instagram%' THEN 'instagram'
+        WHEN u.maybe_referral_url LIKE '%reddit%' THEN 'reddit'
+        WHEN u.maybe_referral_url LIKE '%google%' THEN 'google'
+        WHEN u.maybe_referral_url LIKE '%brave%' THEN 'brave'
+        WHEN u.maybe_referral_url LIKE '%duckduckgo%' THEN 'duckduckgo'
+        WHEN u.maybe_referral_url LIKE '%yahoo.com%' THEN 'yahoo'
+        WHEN u.maybe_referral_url LIKE '%yandex%' THEN 'yandex'
+        WHEN u.maybe_referral_url LIKE '%bing.com%' THEN 'bing'
+        WHEN u.maybe_referral_url LIKE '%github.com%' THEN 'github'
+        WHEN u.maybe_referral_url LIKE '%chatgpt%' THEN 'chatgpt'
+        WHEN u.maybe_referral_url LIKE '%https://t.co%' THEN 'twitter'
+        WHEN u.maybe_referral_url LIKE '%x.com%' THEN 'twitter'
+        WHEN u.maybe_referral_url LIKE '%youtube%' THEN 'youtube'
+        WHEN u.maybe_referral_url LIKE '%fakeyou.com%' THEN 'fakeyou'
+        WHEN u.maybe_referral_url LIKE '%ycombinator%' THEN 'hackernews'
+        WHEN u.maybe_referral_url LIKE '%seedanceprice%' THEN 'seedanceprice_reddit'
+        WHEN u.maybe_landing_url LIKE '%utm_source=ig%' THEN 'instagram'
+        WHEN u.maybe_landing_url LIKE '%utm_source=chatgpt%' THEN 'chatgpt'
+        WHEN u.maybe_landing_url LIKE '%/media/%' THEN 'reddit'
+        ELSE 'unknown'
+        END AS user_source,
+    u.maybe_referral_url,
+    u.maybe_landing_url,
+    u.username,
+    us.maybe_stripe_customer_id as subscription_customer,
+    l.stripe_customer_id as credits_customer,
+    u.email_address,
+    CASE
+        WHEN u.maybe_source LIKE '%artcraft_get_web%' THEN 'website'
+        WHEN u.maybe_source LIKE '%artcraft%' THEN 'app_or_website'
+        WHEN u.maybe_source LIKE '%artcraft_get_s%' THEN 'website_stripe_checkout'
+        ELSE u.maybe_source
+        END AS maybe_source,
+    u.maybe_signup_method,
+    u.created_at,
+    u.updated_at
+from users u
+    left outer join user_subscriptions us
+         on us.user_token = u.token
+         and us.subscription_namespace  = 'artcraft'
+    left outer join user_stripe_customer_links l
+         on l.user_token = u.token
+         and l.payments_namespace = 'artcraft'
+where (us.maybe_stripe_customer_id  IS NOT NULL OR l.stripe_customer_id IS NOT NULL)
+order by u.created_at desc;

_database/sql/migrations/2026-06-03-022928-0000_user_email_changes/down.sql

@@ -0,0 +1,5 @@
+-- noinspection SqlDialectInspectionForFile
+-- noinspection SqlNoDataSourceInspectionForFile
+-- noinspection SqlResolveForFile
+
+DROP TABLE IF EXISTS user_email_changes;

_database/sql/migrations/2026-06-03-022928-0000_user_email_changes/up.sql

@@ -0,0 +1,35 @@
+-- noinspection SqlDialectInspectionForFile
+-- noinspection SqlNoDataSourceInspectionForFile
+-- noinspection SqlResolveForFile
+
+CREATE TABLE user_email_changes (
+  id BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
+
+  -- The user whose email was changed.
+  user_token VARCHAR(32) NOT NULL,
+
+  -- The email address before the change.
+  old_email VARCHAR(255) NOT NULL,
+
+  -- The email address after the change.
+  new_email VARCHAR(255) NOT NULL,
+
+  -- The IP address the change was made from.
+  -- Wide enough for IPv4/6.
+  ip_address VARCHAR(40) NOT NULL,
+
+  -- The user that performed the change, if known. NULL when the change was
+  -- performed by the user themselves, by an automated process, or in any
+  -- other context where there is no acting user.
+  maybe_changed_by_user_token VARCHAR(32) DEFAULT NULL,
+
+  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- INDICES --
+  PRIMARY KEY (id),
+  KEY index_user_token (user_token),
+  KEY index_old_email (old_email),
+  KEY index_new_email (new_email),
+  KEY index_created_at (created_at)
+
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

_database/sql/migrations/2026-06-08-121056-0000_folders/down.sql

@@ -0,0 +1,5 @@
+-- noinspection SqlDialectInspectionForFile
+-- noinspection SqlNoDataSourceInspectionForFile
+-- noinspection SqlResolveForFile
+
+DROP TABLE IF EXISTS folders;

_database/sql/migrations/2026-06-08-121056-0000_folders/up.sql

@@ -0,0 +1,56 @@
+-- noinspection SqlDialectInspectionForFile
+-- noinspection SqlNoDataSourceInspectionForFile
+-- noinspection SqlResolveForFile
+
+CREATE TABLE folders (
+  id BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
+
+  -- Effective "primary key" (PUBLIC, used by the API).
+  token VARCHAR(32) NOT NULL,
+
+  -- User-supplied folder name.
+  name VARCHAR(255) NOT NULL,
+
+  -- The user that owns this folder.
+  owner_user_token VARCHAR(32) NOT NULL,
+
+  -- Parent folder for nesting, NULL for top-level folders.
+  maybe_parent_folder_token VARCHAR(32) DEFAULT NULL,
+
+  -- The last four media files added to the folder, in order. These are
+  -- denormalized for cheap thumbnail-grid rendering on folder cards
+  -- without a separate fan-out query.
+  maybe_last_media_file_token_1 VARCHAR(32) DEFAULT NULL,
+  maybe_last_media_file_token_2 VARCHAR(32) DEFAULT NULL,
+  maybe_last_media_file_token_3 VARCHAR(32) DEFAULT NULL,
+  maybe_last_media_file_token_4 VARCHAR(32) DEFAULT NULL,
+
+  -- Optional user-chosen cover image (a media file). Overrides the
+  -- auto-grid thumbnail derived from the last-N media files above.
+  maybe_cover_image_custom_media_token VARCHAR(32) DEFAULT NULL,
+
+  -- Optional user-chosen color tag. Wide enough for "#RRGGBBAA" plus a
+  -- short named-color fallback.
+  maybe_color_code VARCHAR(16) DEFAULT NULL,
+
+  -- Whether the user has starred / favorited this folder.
+  has_star BOOLEAN NOT NULL DEFAULT FALSE,
+
+  -- ========== TIMESTAMPS ==========
+
+  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+
+  -- Soft-delete timestamp. NULL means the folder is live.
+  maybe_deleted_at TIMESTAMP NULL,
+
+  -- INDICES --
+  PRIMARY KEY (id),
+  UNIQUE KEY (token),
+  KEY fk_owner_user_token (owner_user_token),
+  KEY fk_maybe_parent_folder_token (maybe_parent_folder_token),
+  KEY index_folders_created_at (created_at),
+  KEY index_folders_updated_at (updated_at),
+  KEY index_maybe_deleted_at (maybe_deleted_at)
+
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

_database/sql/migrations/2026-06-08-124756-0000_folder_media_files/down.sql

@@ -0,0 +1,5 @@
+-- noinspection SqlDialectInspectionForFile
+-- noinspection SqlNoDataSourceInspectionForFile
+-- noinspection SqlResolveForFile
+
+DROP TABLE IF EXISTS folder_media_files;

_database/sql/migrations/2026-06-08-124756-0000_folder_media_files/up.sql

@@ -0,0 +1,27 @@
+-- noinspection SqlDialectInspectionForFile
+-- noinspection SqlNoDataSourceInspectionForFile
+-- noinspection SqlResolveForFile
+
+CREATE TABLE folder_media_files (
+  -- Auto-increment for posterity / row-creation ordering. Not the primary
+  -- key — the composite (folder_token, media_file_token) is. AUTO_INCREMENT
+  -- requires its own key, hence the UNIQUE KEY below.
+  id BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
+
+  -- The folder this membership belongs to.
+  folder_token VARCHAR(32) NOT NULL,
+
+  -- The media file in the folder.
+  media_file_token VARCHAR(32) NOT NULL,
+
+  -- When the media file was added to the folder. Rows are hard-deleted
+  -- when a media file is removed, so there is no `maybe_deleted_at`.
+  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- INDICES --
+  PRIMARY KEY (folder_token, media_file_token),
+  UNIQUE KEY (id),
+  KEY index_folder_token (folder_token),
+  KEY index_media_file_token (media_file_token)
+
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

_database/sql/migrations_squashed/folder_media_files.sql

@@ -0,0 +1,32 @@
+-- NB: This is a manually squashed view of all the CREATE and ALTER statements,
+-- with comments attached to the fields for centralized documentation.
+
+-- noinspection SqlDialectInspectionForFile
+-- noinspection SqlNoDataSourceInspectionForFile
+-- noinspection SqlResolveForFile
+
+-- N:M mapping between `folders` and `media_files`. Rows are hard-deleted
+-- when a media file is removed from a folder — no soft-delete column.
+CREATE TABLE folder_media_files (
+  -- Auto-increment for posterity / row-creation ordering. Not the primary
+  -- key — the composite (folder_token, media_file_token) is. AUTO_INCREMENT
+  -- requires its own key, hence the UNIQUE KEY below.
+  id BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
+
+  -- The folder this membership belongs to.
+  folder_token VARCHAR(32) NOT NULL,
+
+  -- The media file in the folder.
+  media_file_token VARCHAR(32) NOT NULL,
+
+  -- When the media file was added to the folder. Rows are hard-deleted
+  -- when a media file is removed, so there is no `maybe_deleted_at`.
+  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- INDICES --
+  PRIMARY KEY (folder_token, media_file_token),
+  UNIQUE KEY (id),
+  KEY index_folder_token (folder_token),
+  KEY index_media_file_token (media_file_token)
+
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

_database/sql/migrations_squashed/folders.sql

@@ -0,0 +1,59 @@
+-- NB: This is a manually squashed view of all the CREATE and ALTER statements,
+-- with comments attached to the fields for centralized documentation.
+
+-- noinspection SqlDialectInspectionForFile
+-- noinspection SqlNoDataSourceInspectionForFile
+-- noinspection SqlResolveForFile
+
+CREATE TABLE folders (
+  id BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
+
+  -- Effective "primary key" (PUBLIC, used by the API).
+  token VARCHAR(32) NOT NULL,
+
+  -- User-supplied folder name.
+  name VARCHAR(255) NOT NULL,
+
+  -- The user that owns this folder.
+  owner_user_token VARCHAR(32) NOT NULL,
+
+  -- Parent folder for nesting, NULL for top-level folders.
+  maybe_parent_folder_token VARCHAR(32) DEFAULT NULL,
+
+  -- The last four media files added to the folder, in order. These are
+  -- denormalized for cheap thumbnail-grid rendering on folder cards
+  -- without a separate fan-out query.
+  maybe_last_media_file_token_1 VARCHAR(32) DEFAULT NULL,
+  maybe_last_media_file_token_2 VARCHAR(32) DEFAULT NULL,
+  maybe_last_media_file_token_3 VARCHAR(32) DEFAULT NULL,
+  maybe_last_media_file_token_4 VARCHAR(32) DEFAULT NULL,
+
+  -- Optional user-chosen cover image (a media file). Overrides the
+  -- auto-grid thumbnail derived from the last-N media files above.
+  maybe_cover_image_custom_media_token VARCHAR(32) DEFAULT NULL,
+
+  -- Optional user-chosen color tag. Wide enough for "#RRGGBBAA" plus a
+  -- short named-color fallback.
+  maybe_color_code VARCHAR(16) DEFAULT NULL,
+
+  -- Whether the user has starred / favorited this folder.
+  has_star BOOLEAN NOT NULL DEFAULT FALSE,
+
+  -- ========== TIMESTAMPS ==========
+
+  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+
+  -- Soft-delete timestamp. NULL means the folder is live.
+  maybe_deleted_at TIMESTAMP NULL,
+
+  -- INDICES --
+  PRIMARY KEY (id),
+  UNIQUE KEY (token),
+  KEY fk_owner_user_token (owner_user_token),
+  KEY fk_maybe_parent_folder_token (maybe_parent_folder_token),
+  KEY index_folders_created_at (created_at),
+  KEY index_folders_updated_at (updated_at),
+  KEY index_maybe_deleted_at (maybe_deleted_at)
+
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

_database/sql/migrations_squashed/user_tables/user_email_changes.sql

@@ -0,0 +1,38 @@
+-- NB: This is a manually squashed view of all the CREATE and ALTER statements,
+-- with comments attached to the fields for centralized documentation.
+
+-- noinspection SqlDialectInspectionForFile
+-- noinspection SqlNoDataSourceInspectionForFile
+-- noinspection SqlResolveForFile
+
+CREATE TABLE user_email_changes (
+  id BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
+
+  -- The user whose email was changed.
+  user_token VARCHAR(32) NOT NULL,
+
+  -- The email address before the change.
+  old_email VARCHAR(255) NOT NULL,
+
+  -- The email address after the change.
+  new_email VARCHAR(255) NOT NULL,
+
+  -- The IP address the change was made from.
+  -- Wide enough for IPv4/6.
+  ip_address VARCHAR(40) NOT NULL,
+
+  -- The user that performed the change, if known. NULL when the change was
+  -- performed by the user themselves, by an automated process, or in any
+  -- other context where there is no acting user.
+  maybe_changed_by_user_token VARCHAR(32) DEFAULT NULL,
+
+  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- INDICES --
+  PRIMARY KEY (id),
+  KEY index_user_token (user_token),
+  KEY index_old_email (old_email),
+  KEY index_new_email (new_email),
+  KEY index_created_at (created_at)
+
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

_docs/pagedraw_design_review.md

@@ -0,0 +1,203 @@
+# PageDraw — Visual Design & Architecture Review
+
+**Surface:** `@storyteller/ui-pagedraw` image editor + its `artcraft-webapp` integration (`/edit-image`).
+**Lens:** Awwwards / Linear-tier "premium app chrome" rubric, adapted for an in-product creative tool.
+**Date:** 2026-06-15 · **Branch:** `worktree-pagedraw-webapp`
+
+---
+
+## 0. How to read this
+
+PageDraw is a **professional canvas tool**, not a marketing page. So the elite-design rubric is
+applied in its *app-chrome* register — the north star is **Figma / Linear / Photoshop-web**, not an
+Awwwards landing page. That means:
+
+- **Applies:** token discipline, concentric radii, hairline + inset-highlight surfaces ("double-bezel"),
+  island/pill controls, custom-eased micro-motion, z-index hygiene, premium type ramp.
+- **Does _not_ apply:** `py-40` macro-whitespace, hero typography, editorial-split layouts, scroll-reveal
+  entrances. A tool surface is dense and persistent by design; forcing landing-page whitespace would hurt it.
+
+Citations are `file:line` against the current tree.
+
+---
+
+## 1. Verdict
+
+| Axis | Score | One-liner |
+|---|---|---|
+| Color system | ⚠️ 5/10 | Good token foundation, but hardcoded greys (`#1b1b1b`, `#303030`, `#404040`) leak through a *themeable lib*. |
+| Typography | ❌ 3/10 | No type ramp, no font-family ownership; rides whatever the host sets. Banned-by-rubric default stack risk. |
+| Radii | ⚠️ 4/10 | Five radius scales in play (`sm`→`2xl`→`full`) with no concentric nesting. |
+| Surfaces (border/shadow) | ⚠️ 5/10 | Flat `shadow-lg` everywhere; no inset highlights; no double-bezel. Reads "functional", not "machined". |
+| Motion | ❌ 3/10 | Only `transition-colors`/`ease-in-out`, durations 75–200ms; **zero custom easing**, no spring, no entrance choreography. |
+| Layout / z-index | ⚠️ 6/10 | Clean fixed-panel composition, but a `z-[9999999]` escape hatch and a 6-tier ad-hoc z-stack. |
+| Icons | ✅ 7/10 | FontAwesome Pro (solid + regular) — acceptable, but solid weight is heavier than the rubric's "ultra-light line" ideal. |
+| Architecture | ⚠️ 5/10 | Clean adapter boundary; but `PaintSurface.tsx` (2005 LOC), `SceneState.ts` (1539), `PageDraw.tsx` (1292) are oversized, and the lib hardcodes host-theme colors. |
+
+**Bottom line:** the editor is *structurally competent and functional* but visually reads as
+"capable internal tool," not "$150k product surface." The single highest-leverage fix is a **shared
+design-token layer** (color + radius + motion + type), because today the lib both (a) reaches for
+host tokens (`bg-ui-panel`, `text-base-fg`) *and* (b) hardcodes its own greys — so it can never be
+fully reskinned by the webapp vs. the desktop app.
+
+---
+
+## 2. What's already good (keep)
+
+- **Token-aware base.** Most surfaces use semantic tokens (`bg-ui-panel`, `bg-ui-controls`,
+  `text-base-fg`, `border-ui-panel-border`) — the right instinct (SideToolbar, PromptEditor, HistoryStack).
+- **Clean platform boundary.** The lib has zero REST/Tauri imports; everything I/O flows through
+  `PageDrawAdapter` (`adapter.ts`). The webapp adapter (`web-adapter.tsx`) and desktop adapter stay
+  swappable. This is genuinely good architecture and should be protected.
+- **Performance-minded canvas.** Composite pre-baking on idle (`PageDraw.tsx` ~661–710) and worker
+  encoding (`generatePipeline.worker.ts`) keep the generate click off the main thread. Don't regress this.
+- **CORS already handled** for browser canvas export (`crossOrigin="anonymous"` in `Node.ts:134`,
+  `SceneState.ts:1473`, `imageHelpers.ts:16`) — the web port works because of this.
+
+---
+
+## 3. Findings & recommendations
+
+### 3.1 Color — stop hardcoding greys in a themeable lib  ⚠️ P0
+**Current:** semantic tokens *and* raw hex coexist:
+- `#1b1b1b` pegboard (`pagedraw.css:6`), `#1A1A1A`/`#333333` context menu (`ContextMenu.tsx:44`),
+  `#303030`/`#404040` dividers + popovers (`SideToolbar.tsx:381,550`), `bg-zinc-700/600` swatch
+  (`SideToolbar.tsx:173`), plus ad-hoc `bg-blue-600/500` accents (`PageDraw.tsx:157`, base selector).
+- Accent color is inconsistent: the lib's primary action uses raw **blue-600**, while the webapp's
+  design system uses `--primary` / `brand-primary`. So the editor's blue doesn't match the product.
+
+**Why it fails the bar:** a premium component library exposes *one* surface ramp and *one* accent, both
+driven by tokens, so it reskins per host. Hardcoded greys mean the desktop and web themes can drift, and
+the raw `blue-600` clashes with `brand-primary` used elsewhere in the webapp.
+
+**Do:**
+- Replace every raw grey with the existing ramp: `#1b1b1b`→`bg-ui-background`, `#1A1A1A`→`bg-ui-panel`,
+  `#303030`/`#404040`→`border-ui-panel-border` / `bg-ui-controls`. For the pegboard, add a token
+  `--st-canvas` so hosts can theme the canvas backdrop.
+- Replace `blue-600/500` accents with `bg-primary` / `text-primary` (the token the rest of the webapp uses),
+  so the Generate/Edit-3D buttons match `brand-primary`.
+- Move the react-colorful overrides off pure `rgb(255,255,255)` borders (`pagedraw.css:15,19`) onto
+  `white/15` hairlines for consistency with the rest of the chrome.
+
+### 3.2 Typography — own a type ramp  ❌ P0
+**Current:** no `font-family` anywhere in the lib (grep: 0 hits); only `text-xs/sm/base/lg/xl` +
+`font-medium/semibold/bold`. The editor inherits whatever the host's body font is.
+
+**Why it fails the bar:** the rubric explicitly bans the default web stack (Inter/Roboto/Arial/Helvetica).
+Inheriting an unspecified stack means the tool can render in a banned font with no recourse, and there's
+no deliberate hierarchy (numerics in sliders, labels, modal titles all share one undifferentiated ramp).
+
+**Do:**
+- Adopt the product's display/grotesk token (e.g. a `font-sans` mapped to Geist / Plus Jakarta Sans at
+  the app level) and reference it in the lib's root container, not per-component.
+- Define a small semantic ramp: `text-[11px] tracking-[0.16em] uppercase` for toolbar/section labels,
+  `text-sm` for controls, `text-base font-semibold` for modal titles. Apply `tabular-nums` to slider
+  read-outs (`SliderWithIndicator.tsx`) and dimension fields (`BlankCanvasModal`) so numbers don't jitter.
+
+### 3.3 Radii — collapse to a concentric scale  ⚠️ P1
+**Current:** `rounded-sm / md / lg / xl / 2xl / full` all appear, with no parent→child relationship
+(e.g. `rounded-2xl` card at `PageDraw.tsx:1123`, `rounded-xl` panels in SideToolbar, `rounded-lg`
+buttons in InpaintToolBar).
+
+**Do:** pick a 3-step system — **`rounded-2xl` shells, `rounded-xl` inner cards, `rounded-lg` controls,
+`rounded-full` pills** — and apply concentrically (the "double-bezel" curve math: inner radius =
+outer − padding). Drop `rounded-sm`/`rounded-md` from the editor entirely.
+
+### 3.4 Surfaces — add the "machined" double-bezel  ⚠️ P1
+**Current:** panels are a single `bg-ui-panel` + `border` + `shadow-lg`. No nested enclosure, no inset
+top-highlight. Reads flat.
+
+**Do (for the four floating panels — SideToolbar, HistoryStack, PromptEditor, InpaintToolBar):**
+- Outer shell: `bg-ui-panel/80 ring-1 ring-white/10 backdrop-blur-xl p-1.5 rounded-2xl`.
+- Inner core: own bg + `shadow-[inset_0_1px_0_rgba(255,255,255,0.08)] rounded-xl`.
+- This is the single change that most moves the surface from "tool" to "premium hardware." The panels are
+  already `fixed` (`PageDraw.tsx:1144,1175,1195`), so `backdrop-blur` here is GPU-safe per the perf rules.
+
+### 3.5 Motion — replace linear/ease with spring-eased micro-motion  ❌ P0 (cheap, high impact)
+**Current:** `transition-colors`/`transition-all` with `ease-in-out` and `duration-75/150/200`
+(`SideToolbar.tsx:381,550`, `SliderWithIndicator.tsx:65`, `ContextMenu.tsx:53`). No custom easing,
+no entrance/exit on popovers, color pickers, or the context menu (they pop instantly).
+
+**Why it fails the bar:** instant state changes and `ease-in-out` are explicitly banned. A pro tool still
+deserves *interpolated* motion — it's what separates Figma from a jQuery plugin.
+
+**Do:**
+- Standardize on one curve: `transition-[transform,opacity,background-color] duration-300
+  ease-[cubic-bezier(0.32,0.72,0,1)]`.
+- Tool buttons: `active:scale-[0.97]` press physics; selected tool gets a spring-eased indicator slide
+  rather than a hard background swap.
+- Popovers / color picker / context menu: animate in with `opacity-0 translate-y-1 scale-[0.98]` →
+  resolved, ~180ms. Transform+opacity only (perf rule).
+- History tiles: stagger their `opacity` reveal when a generation lands (they already use
+  `transition-opacity`, just add per-index delay).
+
+### 3.6 Layout & z-index — tame the stack  ⚠️ P1
+**Current:** clean fixed-panel composition, but z-index is ad-hoc across 6 tiers and includes a
+`z-[9999999]` on the context menu (`ContextMenu.tsx:44`) and a one-off `z-[60]` (`PageDraw.tsx:237`).
+
+**Do:** define a named scale in one place — `canvas:0, chrome:10, floating-controls:20, overlay-button:40,
+menu:50` — and replace the magic numbers. The portal menu only needs to clear the chrome, not `9999999`.
+
+### 3.7 Responsive — declare intent  ⚠️ P2
+**Current:** essentially desktop-only; fixed sidebars assume a wide viewport; only LightboxDetails has
+`sm:` variants. The webapp wrapper scopes the lib correctly (`pagedraw.tsx` `translateZ(0)` containing
+block) but there's no mobile story.
+
+**Do:** mirror the Edit-3D page's explicit **mobile gate** (`pagescene.tsx` `MobileGate`) on `/edit-image`
+rather than letting fixed toolbars overlap on touch. A precision canvas tool is legitimately desktop-first;
+just say so deliberately instead of degrading silently.
+
+---
+
+## 4. Architecture notes
+
+- **Oversized modules.** `PaintSurface.tsx` (2005 LOC), `SceneState.ts` (1539), `PageDraw.tsx` (1292).
+  These are review/maintenance hotspots. Suggest extracting from `SceneState.ts`: history/undo slice,
+  base-image-load slice, and generation/pending slice into composable Zustand slices. `PageDraw.tsx`'s
+  generate-flow (cases 1–3, ~780–868) could move to a `useGenerate()` hook.
+- **Theme ownership.** Per §3.1, the lib should *only* consume tokens. Today it mixes tokens + hex, which
+  defeats the adapter pattern's promise (one component, many themed hosts).
+- **Adapter surface is healthy.** `PageDrawAdapter` is small and intentional; the web vs. Tauri split is
+  clean. The webapp's `enqueueInpaint` stub and 402→credits-modal handling are explicit and documented.
+- **Icon weight.** FontAwesome **solid** is the heaviest option; if a line/light set is available
+  (Phosphor/Remix or FA light), the toolbar would read more refined. Low priority.
+
+---
+
+## 5. Prioritized roadmap
+
+| P | Item | Effort | Payoff |
+|---|---|---|---|
+| **P0** | Token sweep: kill hardcoded greys; unify accent on `--primary` (§3.1) | M | Highest — enables true theming + product-consistent accent |
+| **P0** | Own a font-family + semantic type ramp at the lib root (§3.2) | S | High — removes banned-font risk, adds hierarchy |
+| **P0** | One custom easing curve + press/popover micro-motion (§3.5) | S | High — cheapest "feels expensive" win |
+| **P1** | Double-bezel + inset highlights on the 4 floating panels (§3.4) | M | High — "machined" surface upgrade |
+| **P1** | Concentric 3-step radius system (§3.3) | S | Medium — visual coherence |
+| **P1** | Named z-index scale; remove `z-[9999999]` (§3.6) | S | Medium — maintainability |
+| **P2** | Explicit mobile gate on `/edit-image` (§3.7) | S | Medium — correctness on touch |
+| **P2** | Split `SceneState.ts` / `PaintSurface.tsx` into slices (§4) | L | Medium — maintainability |
+
+---
+
+## 6. Appendix — proposed token additions
+
+```css
+/* canvas + chrome surface ramp (lib should consume only these) */
+--st-canvas:        <theme>;   /* replaces #1b1b1b pegboard */
+--st-accent:        var(--primary);        /* replaces blue-600/500 */
+--st-hairline:      rgb(255 255 255 / 0.10);
+--st-inset-hi:      inset 0 1px 0 rgb(255 255 255 / 0.08);
+
+/* motion */
+--st-ease:          cubic-bezier(0.32, 0.72, 0, 1);
+--st-dur-fast:      180ms;
+--st-dur:           300ms;
+
+/* radius scale (concentric) */
+--st-r-shell:       1.25rem;  /* rounded-2xl */
+--st-r-card:        0.875rem; /* rounded-xl  */
+--st-r-control:     0.5rem;   /* rounded-lg  */
+```
+
+> Scope note: every recommendation here is **styling/architecture only** — none change the generate,
+> polling, upload, bg-removal, or adapter contracts validated during the functional debug pass.

crates/api_clients/artcraft/artcraft_api_defs/src/folders/common.rs

@@ -0,0 +1,54 @@
+use chrono::{DateTime, Utc};
+use serde_derive::{Deserialize, Serialize};
+use utoipa::ToSchema;
+
+use tokens::tokens::folders::FolderToken;
+use tokens::tokens::media_files::MediaFileToken;
+use tokens::tokens::users::UserToken;
+
+/// Canonical wire shape for a folder. Used by single-folder GETs, create
+/// responses, list rows, and subfolder list rows.
+#[derive(Clone, Debug, Serialize, Deserialize, ToSchema)]
+pub struct FolderInfo {
+  pub token: FolderToken,
+  pub name: String,
+  pub owner_user_token: UserToken,
+  pub maybe_parent_folder_token: Option<FolderToken>,
+
+  pub maybe_last_media_file_token_1: Option<MediaFileToken>,
+  pub maybe_last_media_file_token_2: Option<MediaFileToken>,
+  pub maybe_last_media_file_token_3: Option<MediaFileToken>,
+  pub maybe_last_media_file_token_4: Option<MediaFileToken>,
+
+  pub maybe_cover_image_custom_media_token: Option<MediaFileToken>,
+
+  pub maybe_color_code: Option<String>,
+  pub has_star: bool,
+
+  pub created_at: DateTime<Utc>,
+  pub updated_at: DateTime<Utc>,
+
+  /// True when `maybe_parent_folder_token` is set but the referenced
+  /// parent row is missing or soft-deleted.
+  pub is_orphaned: bool,
+}
+
+/// Canonical wire shape for a media file inside a folder. Lean enough for
+/// thumbnail rendering; callers that need richer fields should hit the
+/// media-file batch-get endpoint.
+#[derive(Clone, Debug, Serialize, Deserialize, ToSchema)]
+pub struct FolderMediaFileInfo {
+  pub media_file_token: MediaFileToken,
+  pub added_to_folder_at: DateTime<Utc>,
+
+  pub media_type: String,
+  pub media_class: String,
+  pub maybe_mime_type: Option<String>,
+  pub public_bucket_directory_hash: String,
+  pub maybe_public_bucket_prefix: Option<String>,
+  pub maybe_public_bucket_extension: Option<String>,
+  pub maybe_frame_width: Option<i32>,
+  pub maybe_frame_height: Option<i32>,
+  pub maybe_duration_millis: Option<i32>,
+  pub maybe_title: Option<String>,
+}

crates/api_clients/artcraft/artcraft_api_defs/src/folders/folder.rs

@@ -0,0 +1,116 @@
+use serde_derive::{Deserialize, Serialize};
+use utoipa::{IntoParams, ToSchema};
+
+use tokens::tokens::folders::FolderToken;
+use tokens::tokens::media_files::MediaFileToken;
+
+use crate::folders::common::FolderInfo;
+
+// ── POST /v1/folders/create ──
+
+#[derive(Deserialize, ToSchema)]
+pub struct CreateFolderRequest {
+  pub name: String,
+  pub maybe_parent_folder_token: Option<FolderToken>,
+  pub maybe_color_code: Option<String>,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct CreateFolderSuccessResponse {
+  pub success: bool,
+  pub folder: FolderInfo,
+}
+
+// ── GET /v1/folders/list_all ──
+
+#[derive(Deserialize, ToSchema, IntoParams)]
+pub struct ListFoldersQueryParams {
+  pub cursor: Option<String>,
+  pub limit: Option<u32>,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct ListFoldersSuccessResponse {
+  pub success: bool,
+  pub folders: Vec<FolderInfo>,
+  pub maybe_cursor: Option<String>,
+}
+
+// ── GET /v1/folders/folder/{folder_token} ──
+
+#[derive(Deserialize, ToSchema)]
+pub struct FolderPathInfo {
+  pub folder_token: FolderToken,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct GetFolderSuccessResponse {
+  pub success: bool,
+  pub folder: FolderInfo,
+}
+
+// ── PUT /v1/folders/folder/{folder_token}/rename ──
+
+#[derive(Deserialize, ToSchema)]
+pub struct RenameFolderRequest {
+  pub new_name: String,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct RenameFolderSuccessResponse {
+  pub success: bool,
+}
+
+// ── PUT /v1/folders/folder/{folder_token}/star ──
+
+#[derive(Deserialize, ToSchema)]
+pub struct SetFolderStarRequest {
+  pub has_star: bool,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct SetFolderStarSuccessResponse {
+  pub success: bool,
+}
+
+// ── PUT /v1/folders/folder/{folder_token}/color_code ──
+
+#[derive(Deserialize, ToSchema)]
+pub struct SetFolderColorCodeRequest {
+  /// `None` clears the color tag.
+  pub maybe_color_code: Option<String>,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct SetFolderColorCodeSuccessResponse {
+  pub success: bool,
+}
+
+// ── PUT /v1/folders/folder/{folder_token}/cover_image ──
+
+#[derive(Deserialize, ToSchema)]
+pub struct SetFolderCoverImageRequest {
+  /// `None` clears the cover image. If set, the server resolves it to a
+  /// usable cover-image media file token: image/video media files are
+  /// used directly; other types fall back to the file's own
+  /// `maybe_cover_image_media_file_token` (and fail if neither path
+  /// applies).
+  pub maybe_media_file_token: Option<MediaFileToken>,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct SetFolderCoverImageSuccessResponse {
+  pub success: bool,
+
+  /// The media file token that ended up being stored as the cover image
+  /// (may differ from the requested token if the server resolved through
+  /// the file's own cover image). `None` when the cover was cleared.
+  pub maybe_resolved_cover_media_file_token: Option<MediaFileToken>,
+}
+
+// ── DELETE /v1/folders/folder/{folder_token} ──
+
+#[derive(Serialize, ToSchema)]
+pub struct DeleteFolderSuccessResponse {
+  pub success: bool,
+}

crates/api_clients/artcraft/artcraft_api_defs/src/folders/media_files.rs

@@ -0,0 +1,59 @@
+use serde_derive::{Deserialize, Serialize};
+use utoipa::{IntoParams, ToSchema};
+
+use tokens::tokens::folders::FolderToken;
+use tokens::tokens::media_files::MediaFileToken;
+
+use crate::folders::common::FolderMediaFileInfo;
+
+// ── GET /v1/folders/media_files/{folder_token} ──
+
+#[derive(Deserialize, ToSchema)]
+pub struct FolderMediaFilesPathInfo {
+  pub folder_token: FolderToken,
+}
+
+#[derive(Deserialize, ToSchema, IntoParams)]
+pub struct ListFolderMediaFilesQueryParams {
+  pub cursor: Option<String>,
+  pub limit: Option<u32>,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct ListFolderMediaFilesSuccessResponse {
+  pub success: bool,
+  pub media_files: Vec<FolderMediaFileInfo>,
+  pub maybe_cursor: Option<String>,
+}
+
+// ── PUT /v1/folders/media_files/{folder_token}/bulk_add ──
+
+#[derive(Deserialize, ToSchema)]
+pub struct BulkAddFolderMediaFilesRequest {
+  /// Media files to add to the folder. Tokens that don't exist or are
+  /// soft-deleted are silently skipped. Already-added rows are no-ops
+  /// (idempotent via INSERT IGNORE on the composite primary key).
+  pub media_file_tokens: Vec<MediaFileToken>,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct BulkAddFolderMediaFilesSuccessResponse {
+  pub success: bool,
+  /// Tokens that pre-existed (existed + not deleted). Already-added rows
+  /// are included since the operation is idempotent.
+  pub accepted_media_file_tokens: Vec<MediaFileToken>,
+}
+
+// ── PUT /v1/folders/media_files/{folder_token}/bulk_remove ──
+
+#[derive(Deserialize, ToSchema)]
+pub struct BulkRemoveFolderMediaFilesRequest {
+  pub media_file_tokens: Vec<MediaFileToken>,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct BulkRemoveFolderMediaFilesSuccessResponse {
+  pub success: bool,
+  /// How many membership rows were actually hard-deleted.
+  pub removed_count: u64,
+}

crates/api_clients/artcraft/artcraft_api_defs/src/folders/mod.rs

@@ -0,0 +1,4 @@
+pub mod common;
+pub mod folder;
+pub mod media_files;
+pub mod subfolder;

crates/api_clients/artcraft/artcraft_api_defs/src/folders/subfolder.rs

@@ -0,0 +1,61 @@
+use serde_derive::{Deserialize, Serialize};
+use utoipa::{IntoParams, ToSchema};
+
+use tokens::tokens::folders::FolderToken;
+
+use crate::folders::common::FolderInfo;
+
+// ── GET /v1/folders/subfolders/{folder_token} ──
+
+#[derive(Deserialize, ToSchema)]
+pub struct SubfolderPathInfo {
+  pub folder_token: FolderToken,
+}
+
+#[derive(Deserialize, ToSchema, IntoParams)]
+pub struct ListSubfoldersQueryParams {
+  pub cursor: Option<String>,
+  pub limit: Option<u32>,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct ListSubfoldersSuccessResponse {
+  pub success: bool,
+  pub subfolders: Vec<FolderInfo>,
+  pub maybe_cursor: Option<String>,
+}
+
+// ── PUT /v1/folders/subfolders/{folder_token}/bulk_add ──
+
+#[derive(Deserialize, ToSchema)]
+pub struct BulkAddSubfoldersRequest {
+  /// The folders to reparent under the URL `folder_token`. Tokens that
+  /// don't exist, aren't owned by the caller, are soft-deleted, or are
+  /// the parent itself are silently skipped (idempotent).
+  pub subfolder_tokens: Vec<FolderToken>,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct BulkAddSubfoldersSuccessResponse {
+  pub success: bool,
+  /// Tokens that were actually accepted (existed + owned + not deleted +
+  /// not the parent itself). Already-parented tokens are included here
+  /// since the operation is idempotent.
+  pub accepted_subfolder_tokens: Vec<FolderToken>,
+}
+
+// ── PUT /v1/folders/subfolders/{folder_token}/bulk_remove ──
+
+#[derive(Deserialize, ToSchema)]
+pub struct BulkRemoveSubfoldersRequest {
+  /// Folders to unparent. Only rows currently parented to the URL
+  /// `folder_token` are affected; others are silently skipped.
+  pub subfolder_tokens: Vec<FolderToken>,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct BulkRemoveSubfoldersSuccessResponse {
+  pub success: bool,
+  /// How many rows were actually unparented.
+  pub removed_count: u64,
+}

crates/api_clients/artcraft/artcraft_api_defs/src/lib.rs

@@ -2,6 +2,7 @@ pub mod analytics;
 pub mod characters;
 pub mod common;
 pub mod credits;
+pub mod folders;
 pub mod generate;
 pub mod jobs;
 pub mod media_file;

crates/api_clients/artcraft/artcraft_api_defs/src/omni_gen/cost_and_generate_requests/omni_gen_image_cost_and_generate_request.rs

@@ -8,7 +8,7 @@ use enums::common::generation::common_resolution::CommonResolution;
 use tokens::tokens::media_files::MediaFileToken;
 
 /// Shared request body for both the image cost estimate and image generation endpoints.
-#[derive(Serialize, Deserialize, ToSchema, Debug)]
+#[derive(Clone, Serialize, Deserialize, ToSchema, Debug)]
 pub struct OmniGenImageCostAndGenerateRequest {
   /// REQUIRED (even if marked optional)
   /// Idempotency token to prevent duplicate requests.

crates/api_clients/artcraft/artcraft_api_defs/src/omni_gen/models/omni_gen_video_models.rs

@@ -71,7 +71,19 @@ pub struct OmniGenVideoModelDetails {
   
   #[serde(skip_serializing_if = "Option::is_none")]
   pub full_name: Option<String>,
-  
+
+  /// Additional details about the model.
+  #[serde(skip_serializing_if = "Option::is_none")]
+  pub extra_info: Option<String>,
+
+  /// Additional details about the model. (Brief; only a few words.)
+  #[serde(skip_serializing_if = "Option::is_none")]
+  pub extra_info_short: Option<String>,
+
+  /// Whether a pure text-to-video modality is supported
+  #[serde(skip_serializing_if = "Option::is_none")]
+  pub text_to_video_supported: Option<bool>,
+
   #[serde(skip_serializing_if = "Option::is_none")]
   pub text_prompt_supported: Option<bool>,
   
@@ -183,6 +195,9 @@ impl Default for OmniGenVideoModelDetails {
       model: DEFAULT_VIDEO_MODEL,
       model_creator: None,
       full_name: None,
+      extra_info: None,
+      extra_info_short: None,
+      text_to_video_supported: None,
       text_prompt_supported: None,
       text_prompt_max_length: None,
       negative_text_prompt_supported: None,

crates/api_clients/artcraft/artcraft_router/Cargo.toml

@@ -22,7 +22,6 @@ artcraft_client.workspace = true
 fal_client.workspace = true
 gmicloud_client.workspace = true
 grok_api_client.workspace = true
-muapi_client.workspace = true
 seedance2pro_client.workspace = true
 tokens.workspace = true
 url_utils.workspace = true
@@ -41,4 +40,5 @@ uuid.workspace = true
 [dev-dependencies]
 test_data.workspace = true
 strum.workspace = true
+serde_json.workspace = true
 

crates/api_clients/artcraft/artcraft_router/src/api/mod.rs

@@ -1,12 +1,12 @@
 pub mod audio_list_ref;
 pub mod character_list_ref;
-pub mod common_aspect_ratio;
-pub mod common_image_model;
-pub mod common_quality;
-pub mod common_resolution;
-pub mod common_splat_model;
-pub mod common_video_model;
 pub mod image_list_ref;
 pub mod image_ref;
-pub mod provider;
+pub mod router_aspect_ratio;
+pub mod router_image_model;
+pub mod router_provider;
+pub mod router_quality;
+pub mod router_resolution;
+pub mod router_splat_model;
+pub mod router_video_model;
 pub mod video_list_ref;

crates/api_clients/artcraft/artcraft_router/src/api/router_aspect_ratio.rs

@@ -8,7 +8,7 @@ use strum::EnumIter;
 #[derive(Copy, Clone, Debug, Serialize, Deserialize)]
 #[cfg_attr(test, derive(EnumIter))]
 #[serde(rename_all = "snake_case")]
-pub enum CommonAspectRatio {
+pub enum RouterAspectRatio {
   // Auto (eg. for image editing to use the source; used by Nano Banana Pro edit image, but not text-to-image)
   Auto,
 

crates/api_clients/artcraft/artcraft_router/src/api/router_image_model.rs

@@ -2,9 +2,9 @@ use serde_derive::{Deserialize, Serialize};
 
 /// Common image models supported by the router.
 /// Not all models are available through all providers.
-#[derive(Copy, Clone, Debug, Serialize, Deserialize)]
+#[derive(Copy, Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
 #[serde(rename_all = "snake_case")]
-pub enum CommonImageModel {
+pub enum RouterImageModel {
   #[serde(rename = "flux_1_dev")]
   Flux1Dev,
   #[serde(rename = "flux_1_schnell")]
@@ -23,6 +23,12 @@ pub enum CommonImageModel {
   GrokImagineImage,
   #[serde(rename = "grok_imagine_image_q")]
   GrokImagineImageQuality,
+  #[serde(rename = "midjourney_7")]
+  Midjourney7,
+  #[serde(rename = "midjourney_7_niji")]
+  Midjourney7Niji,
+  #[serde(rename = "midjourney_8")]
+  Midjourney8,
   #[serde(rename = "nano_banana")]
   NanoBanana,
   #[serde(rename = "nano_banana_2")]
@@ -40,3 +46,31 @@ pub enum CommonImageModel {
   #[serde(rename = "flux_2_lora_angles")]
   Flux2LoraAngles,
 }
+
+#[cfg(test)]
+mod tests {
+  use super::*;
+
+  fn assert_round_trip(model: RouterImageModel, expected_wire: &str) {
+    let json = serde_json::to_string(&model).unwrap();
+    let unquoted = json.trim_matches('"');
+    assert_eq!(unquoted, expected_wire, "serialize {:?}", model);
+    let back: RouterImageModel = serde_json::from_str(&json).unwrap();
+    assert_eq!(back, model, "deserialize round-trip for {:?}", model);
+  }
+
+  #[test]
+  fn midjourney_7_serializes_to_midjourney_7() {
+    assert_round_trip(RouterImageModel::Midjourney7, "midjourney_7");
+  }
+
+  #[test]
+  fn midjourney_7_niji_serializes_to_midjourney_7_niji() {
+    assert_round_trip(RouterImageModel::Midjourney7Niji, "midjourney_7_niji");
+  }
+
+  #[test]
+  fn midjourney_8_serializes_to_midjourney_8() {
+    assert_round_trip(RouterImageModel::Midjourney8, "midjourney_8");
+  }
+}

crates/api_clients/artcraft/artcraft_router/src/api/router_provider.rs

@@ -3,11 +3,10 @@ use serde_derive::{Deserialize, Serialize};
 /// The provider to route a generation request to.
 #[derive(Copy, Clone, Debug, Serialize, Deserialize)]
 #[serde(rename_all = "snake_case")]
-pub enum Provider {
+pub enum RouterProvider {
   Artcraft,
   Fal,
   GmiCloud,
   GrokApi,
-  Muapi,
   Seedance2Pro,
 }

crates/api_clients/artcraft/artcraft_router/src/api/router_quality.rs

@@ -4,7 +4,7 @@ use serde_derive::{Deserialize, Serialize};
 /// Not every model will use this; models that don't simply ignore it.
 #[derive(Copy, Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
 #[serde(rename_all = "snake_case")]
-pub enum CommonQuality {
+pub enum RouterQuality {
   High,
   Medium,
   Low,

crates/api_clients/artcraft/artcraft_router/src/api/router_resolution.rs

@@ -5,7 +5,7 @@ use serde_derive::{Deserialize, Serialize};
 /// In the case a model doesn't support the resolution, gracefully pick the nearest option.
 #[derive(Copy, Clone, Debug, Serialize, Deserialize)]
 #[serde(rename_all = "snake_case")]
-pub enum CommonResolution {
+pub enum RouterResolution {
   /// Models: Nano Banana Pro
   OneK,
   /// Models: Nano Banana Pro

crates/api_clients/artcraft/artcraft_router/src/api/router_splat_model.rs

@@ -4,7 +4,7 @@ use serde_derive::{Deserialize, Serialize};
 /// Not all models are available through all providers.
 #[derive(Copy, Clone, Debug, Serialize, Deserialize)]
 #[serde(rename_all = "snake_case")]
-pub enum CommonSplatModel {
+pub enum RouterSplatModel {
   #[serde(rename = "marble_0p1_mini")]
   Marble0p1Mini,
 

crates/api_clients/artcraft/artcraft_router/src/api/router_video_model.rs

@@ -4,13 +4,16 @@ use serde_derive::{Deserialize, Serialize};
 /// Not all models are available through all providers.
 #[derive(Copy, Clone, Debug, Serialize, Deserialize)]
 #[serde(rename_all = "snake_case")]
-pub enum CommonVideoModel {
+pub enum RouterVideoModel {
   #[serde(rename = "grok_video")]
   GrokVideo,
 
   #[serde(rename = "grok_imagine_video")]
   GrokImagineVideo,
 
+  #[serde(rename = "grok_imagine_video_1p5")]
+  GrokImagineVideo1p5,
+
   #[serde(rename = "kling_1p6_pro")]
   Kling16Pro,
 
@@ -56,6 +59,12 @@ pub enum CommonVideoModel {
   #[serde(rename = "seedance_2p0_u_fast")]
   Seedance2p0UltraFast,
 
+  #[serde(rename = "seedance_2p0_bpu")]
+  Seedance2p0BytePlusUltra,
+
+  #[serde(rename = "seedance_2p0_bpu_fast")]
+  Seedance2p0BytePlusUltraFast,
+
   #[serde(rename = "happy_horse_1p0")]
   HappyHorse1p0,
 

crates/api_clients/artcraft/artcraft_router/src/client/mod.rs

@@ -5,8 +5,6 @@ pub mod request_mismatch_mitigation_strategy;
 pub mod router_artcraft_client;
 pub mod router_client;
 pub mod router_fal_client;
-pub mod router_fal_webhook_optional_client;
 pub mod router_gmicloud_client;
 pub mod router_grok_api_client;
-pub mod router_muapi_client;
 pub mod router_seedance2pro_client;

crates/api_clients/artcraft/artcraft_router/src/client/multi_router_client.rs

@@ -1,19 +1,15 @@
 use crate::client::router_artcraft_client::RouterArtcraftClient;
 use crate::client::router_fal_client::RouterFalClient;
-use crate::client::router_fal_webhook_optional_client::RouterFalWebhookOptionalClient;
 use crate::client::router_gmicloud_client::RouterGmiCloudClient;
 use crate::client::router_grok_api_client::RouterGrokApiClient;
-use crate::client::router_muapi_client::RouterMuapiClient;
 use crate::client::router_seedance2pro_client::RouterSeedance2ProClient;
 use crate::errors::client_error::{ClientError, ClientType};
 
 pub struct MultiRouterClient {
   pub(crate) artcraft_client: Option<RouterArtcraftClient>,
   pub(crate) fal_client: Option<RouterFalClient>,
-  pub(crate) fal_webhook_optional_client: Option<RouterFalWebhookOptionalClient>,
   pub(crate) gmicloud_client: Option<RouterGmiCloudClient>,
   pub(crate) grok_api_client: Option<RouterGrokApiClient>,
-  pub(crate) muapi_client: Option<RouterMuapiClient>,
   pub(crate) seedance2pro_client: Option<RouterSeedance2ProClient>,
 }
 
@@ -28,11 +24,6 @@ impl MultiRouterClient {
       .ok_or(ClientError::ClientNotConfigured(ClientType::Fal))
   }
 
-  pub fn get_fal_webhook_optional_client_ref(&self) -> Result<&RouterFalWebhookOptionalClient, ClientError> {
-    self.fal_webhook_optional_client.as_ref()
-      .ok_or(ClientError::ClientNotConfigured(ClientType::FalWebhookOptional))
-  }
-
   pub fn get_gmicloud_client_ref(&self) -> Result<&RouterGmiCloudClient, ClientError> {
     self.gmicloud_client.as_ref()
       .ok_or(ClientError::ClientNotConfigured(ClientType::GmiCloud))
@@ -43,11 +34,6 @@ impl MultiRouterClient {
       .ok_or(ClientError::ClientNotConfigured(ClientType::GrokApi))
   }
 
-  pub fn get_muapi_client_ref(&self) -> Result<&RouterMuapiClient, ClientError> {
-    self.muapi_client.as_ref()
-      .ok_or(ClientError::ClientNotConfigured(ClientType::Muapi))
-  }
-
   pub fn get_seedance2pro_client_ref(&self) -> Result<&RouterSeedance2ProClient, ClientError> {
     self.seedance2pro_client.as_ref()
       .ok_or(ClientError::ClientNotConfigured(ClientType::Seedance2Pro))

crates/api_clients/artcraft/artcraft_router/src/client/multi_router_client_builder.rs

@@ -1,19 +1,15 @@
 use crate::client::multi_router_client::MultiRouterClient;
 use crate::client::router_artcraft_client::RouterArtcraftClient;
 use crate::client::router_fal_client::RouterFalClient;
-use crate::client::router_fal_webhook_optional_client::RouterFalWebhookOptionalClient;
 use crate::client::router_gmicloud_client::RouterGmiCloudClient;
 use crate::client::router_grok_api_client::RouterGrokApiClient;
-use crate::client::router_muapi_client::RouterMuapiClient;
 use crate::client::router_seedance2pro_client::RouterSeedance2ProClient;
 
 pub struct MultiRouterClientBuilder {
   artcraft_client: Option<RouterArtcraftClient>,
   fal_client: Option<RouterFalClient>,
-  fal_webhook_optional_client: Option<RouterFalWebhookOptionalClient>,
   gmicloud_client: Option<RouterGmiCloudClient>,
   grok_api_client: Option<RouterGrokApiClient>,
-  muapi_client: Option<RouterMuapiClient>,
   seedance2pro_client: Option<RouterSeedance2ProClient>,
 }
 
@@ -22,10 +18,8 @@ impl MultiRouterClientBuilder {
     Self {
       artcraft_client: None,
       fal_client: None,
-      fal_webhook_optional_client: None,
       gmicloud_client: None,
       grok_api_client: None,
-      muapi_client: None,
       seedance2pro_client: None,
     }
   }
@@ -40,11 +34,6 @@ impl MultiRouterClientBuilder {
     self
   }
 
-  pub fn set_fal_webhook_optional_client(mut self, client: RouterFalWebhookOptionalClient) -> Self {
-    self.fal_webhook_optional_client = Some(client);
-    self
-  }
-
   pub fn set_gmicloud_client(mut self, client: RouterGmiCloudClient) -> Self {
     self.gmicloud_client = Some(client);
     self
@@ -55,11 +44,6 @@ impl MultiRouterClientBuilder {
     self
   }
 
-  pub fn set_muapi_client(mut self, client: RouterMuapiClient) -> Self {
-    self.muapi_client = Some(client);
-    self
-  }
-
   pub fn set_seedance2pro_client(mut self, client: RouterSeedance2ProClient) -> Self {
     self.seedance2pro_client = Some(client);
     self
@@ -69,10 +53,8 @@ impl MultiRouterClientBuilder {
     MultiRouterClient {
       artcraft_client: self.artcraft_client,
       fal_client: self.fal_client,
-      fal_webhook_optional_client: self.fal_webhook_optional_client,
       gmicloud_client: self.gmicloud_client,
       grok_api_client: self.grok_api_client,
-      muapi_client: self.muapi_client,
       seedance2pro_client: self.seedance2pro_client,
     }
   }

crates/api_clients/artcraft/artcraft_router/src/client/router_client.rs

@@ -1,10 +1,8 @@
 use crate::client::multi_router_client::MultiRouterClient;
 use crate::client::router_artcraft_client::RouterArtcraftClient;
 use crate::client::router_fal_client::RouterFalClient;
-use crate::client::router_fal_webhook_optional_client::RouterFalWebhookOptionalClient;
 use crate::client::router_gmicloud_client::RouterGmiCloudClient;
 use crate::client::router_grok_api_client::RouterGrokApiClient;
-use crate::client::router_muapi_client::RouterMuapiClient;
 use crate::client::router_seedance2pro_client::RouterSeedance2ProClient;
 use crate::errors::client_error::{ClientError, ClientType};
 
@@ -12,10 +10,8 @@ pub enum RouterClient {
   Multi(MultiRouterClient),
   Artcraft(RouterArtcraftClient),
   Fal(RouterFalClient),
-  FalWebhookOptional(RouterFalWebhookOptionalClient),
   GmiCloud(RouterGmiCloudClient),
   GrokApi(RouterGrokApiClient),
-  Muapi(RouterMuapiClient),
   Seedance2Pro(RouterSeedance2ProClient),
 }
 
@@ -36,14 +32,6 @@ impl RouterClient {
     }
   }
 
-  pub fn get_fal_webhook_optional_client_ref(&self) -> Result<&RouterFalWebhookOptionalClient, ClientError> {
-    match self {
-      RouterClient::FalWebhookOptional(client) => Ok(client),
-      RouterClient::Multi(multi) => multi.get_fal_webhook_optional_client_ref(),
-      _ => Err(ClientError::ClientNotConfigured(ClientType::Fal)),
-    }
-  }
-
   pub fn get_gmicloud_client_ref(&self) -> Result<&RouterGmiCloudClient, ClientError> {
     match self {
       RouterClient::GmiCloud(client) => Ok(client),
@@ -60,14 +48,6 @@ impl RouterClient {
     }
   }
 
-  pub fn get_muapi_client_ref(&self) -> Result<&RouterMuapiClient, ClientError> {
-    match self {
-      RouterClient::Muapi(client) => Ok(client),
-      RouterClient::Multi(multi) => multi.get_muapi_client_ref(),
-      _ => Err(ClientError::ClientNotConfigured(ClientType::Muapi)),
-    }
-  }
-
   pub fn get_seedance2pro_client_ref(&self) -> Result<&RouterSeedance2ProClient, ClientError> {
     match self {
       RouterClient::Seedance2Pro(client) => Ok(client),

crates/api_clients/artcraft/artcraft_router/src/client/router_fal_client.rs

@@ -1,19 +1,30 @@
 use fal_client::creds::fal_api_key::FalApiKey;
 
+/// A unified Fal client. The caller picks the dispatch mode:
+///
+///   - `Some(webhook_url)` → endpoints will use Fal's webhook flow.
+///   - `None` → endpoints will use the queue/polling flow (where available).
+///
+/// Some endpoints are webhook-only (their fal_client wrapper lives under the
+/// `requests_old::webhook::*` namespace and has no `api::` queue variant). Those
+/// will return `ClientError::WebhookUrlRequired` when constructed with `None`.
 pub struct RouterFalClient {
   pub(crate) api_key: FalApiKey,
-  pub(crate) webhook_url: String,
+  pub(crate) webhook_url: Option<String>,
 }
 
 impl RouterFalClient {
-  pub fn new(api_key: FalApiKey, webhook_url: String) -> Self {
-    Self { api_key, webhook_url }
+  /// Build a client for webhook dispatch.
+  pub fn new_with_webhook(api_key: FalApiKey, webhook_url: String) -> Self {
+    Self { api_key, webhook_url: Some(webhook_url) }
   }
 
-  pub fn new_from_raw_key(api_key: &str, webhook_url: String) -> Self {
-    Self {
-      api_key: FalApiKey::from_str(api_key),
-      webhook_url,
-    }
+  /// Build a client for queue/polling dispatch (no webhook URL).
+  pub fn new_polling_only(api_key: FalApiKey) -> Self {
+    Self { api_key, webhook_url: None }
+  }
+
+  pub fn new_polling_only_from_raw_key(api_key: &str) -> Self {
+    Self::new_polling_only(FalApiKey::from_str(api_key))
   }
 }

crates/api_clients/artcraft/artcraft_router/src/client/router_fal_webhook_optional_client.rs

@@ -1,22 +0,0 @@
-use fal_client::creds::fal_api_key::FalApiKey;
-
-pub struct RouterFalWebhookOptionalClient {
-  pub(crate) api_key: FalApiKey,
-  pub(crate) webhook_url: Option<String>,
-}
-
-impl RouterFalWebhookOptionalClient {
-  pub fn new(api_key: FalApiKey) -> Self {
-    Self { api_key, webhook_url: None }
-  }
-  pub fn from_str(api_key: &str) -> Self {
-    Self::new(FalApiKey::from_str(api_key))
-  }
-
-  pub fn new_with_webhook(api_key: FalApiKey, webhook_url: String) -> Self {
-    Self { 
-      api_key, 
-      webhook_url: Some(webhook_url)
-    }
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/client/router_muapi_client.rs

@@ -1,11 +0,0 @@
-use muapi_client::creds::muapi_session::MuapiSession;
-
-pub struct RouterMuapiClient {
-  pub(crate) session: MuapiSession,
-}
-
-impl RouterMuapiClient {
-  pub fn new(session: MuapiSession) -> Self {
-    RouterMuapiClient { session }
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/errors/client_error.rs

@@ -7,10 +7,8 @@ use tokens::tokens::media_files::MediaFileToken;
 pub enum ClientType {
   Artcraft,
   Fal,
-  FalWebhookOptional,
   GmiCloud,
   GrokApi,
-  Muapi,
   Seedance2Pro,
 }
 
@@ -19,10 +17,8 @@ impl Display for ClientType {
     match self {
       Self::Artcraft => write!(f, "Artcraft"),
       Self::Fal => write!(f, "Fal"),
-      Self::FalWebhookOptional => write!(f, "FalWebhookOptional"),
       Self::GmiCloud => write!(f, "GmiCloud"),
       Self::GrokApi => write!(f, "GrokApi"),
-      Self::Muapi => write!(f, "Muapi"),
       Self::Seedance2Pro => write!(f, "Seedance2Pro"),
     }
   }
@@ -49,11 +45,13 @@ pub enum ClientError {
   /// Fal only accepts image URLs for image inputs, not media tokens.
   FalOnlySupportsUrls,
 
-  /// Muapi only accepts URLs for image inputs, not media tokens.
-  MuapiOnlySupportsUrls,
-
   /// Seedance2Pro only accepts URLs for media inputs, not media tokens.
   Seedance2ProOnlySupportsUrls,
+
+  /// The Fal endpoint requires a webhook URL but the caller built the client
+  /// in polling/queue mode (no webhook URL). Returned by webhook-only
+  /// endpoints (those whose fal_client wrapper has no `api::` queue variant).
+  WebhookUrlRequired,
   
   /// The pre-dispatch context of media file token to URL map was not supplied.
   MediaFileToUrlMapNotProvided,
@@ -91,12 +89,12 @@ impl Display for ClientError {
       Self::FalOnlySupportsUrls => {
         write!(f, "Fal only supports image URLs for image inputs, not media tokens")
       }
-      Self::MuapiOnlySupportsUrls => {
-        write!(f, "Muapi only supports URLs for image inputs; resolve media tokens to URLs before calling this provider")
-      }
       Self::Seedance2ProOnlySupportsUrls => {
         write!(f, "Seedance2Pro only supports URLs for media inputs; resolve media tokens to URLs before calling this provider")
       }
+      Self::WebhookUrlRequired => {
+        write!(f, "This Fal endpoint only supports webhook dispatch; the caller built RouterFalClient in polling-only mode (no webhook URL)")
+      }
       Self::MediaFileToUrlMapNotProvided => {
         write!(f, "Media file to URL map was not provided")
       }

crates/api_clients/artcraft/artcraft_router/src/errors/provider_error.rs

@@ -4,7 +4,6 @@ use artcraft_client::error::storyteller_error::StorytellerError;
 use fal_client::error::fal_error_plus::FalErrorPlus;
 use gmicloud_client::error::gmicloud_error::GmiCloudError;
 use grok_api_client::error::grok_error::GrokError;
-use muapi_client::error::muapi_error::MuapiError;
 use seedance2pro_client::error::seedance2pro_error::Seedance2ProError;
 
 #[derive(Debug)]
@@ -13,7 +12,6 @@ pub enum ProviderError {
   Fal(FalErrorPlus),
   GmiCloud(GmiCloudError),
   Grok(GrokError),
-  Muapi(MuapiError),
   Seedance2Pro(Seedance2ProError),
 }
 
@@ -26,7 +24,6 @@ impl Display for ProviderError {
       Self::Fal(e) => write!(f, "Fal provider error: {}", e),
       Self::GmiCloud(e) => write!(f, "GmiCloud provider error: {}", e),
       Self::Grok(e) => write!(f, "Grok provider error: {}", e),
-      Self::Muapi(e) => write!(f, "Muapi provider error: {}", e),
       Self::Seedance2Pro(e) => write!(f, "Seedance2Pro provider error: {}", e),
     }
   }
@@ -56,12 +53,6 @@ impl From<GrokError> for ProviderError {
   }
 }
 
-impl From<MuapiError> for ProviderError {
-  fn from(error: MuapiError) -> Self {
-    Self::Muapi(error)
-  }
-}
-
 impl From<Seedance2ProError> for ProviderError {
   fn from(error: Seedance2ProError) -> Self {
     Self::Seedance2Pro(error)

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_flux_1_dev.rs

@@ -1,71 +0,0 @@
-use artcraft_api_defs::generate::image::text::generate_flux_1_dev_text_to_image::GenerateFlux1DevTextToImageNumImages;
-
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_flux_1_dev::PlanArtcraftFlux1Dev;
-
-pub(crate) fn estimate_image_cost_artcraft_flux_1_dev(
-  plan: &PlanArtcraftFlux1Dev,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.02/image (2 cents). 1 credit = 1 USD cent.
-  let cost_per_image: u64 = 2;
-
-  let num_images: u64 = match plan.num_images {
-    GenerateFlux1DevTextToImageNumImages::One => 1,
-    GenerateFlux1DevTextToImageNumImages::Two => 2,
-    GenerateFlux1DevTextToImageNumImages::Three => 3,
-    GenerateFlux1DevTextToImageNumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-
-  fn estimate_usd_cents(image_batch_count: u16) -> u64 {
-    let request = GenerateImageRequestBuilder {
-      model: CommonImageModel::Flux1Dev,
-      provider: Provider::Artcraft,
-      prompt: None,
-      image_inputs: None,
-      resolution: None,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: Some(image_batch_count),
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    };
-    request.build()
-      .expect("build should succeed")
-      .estimate_costs()
-      .cost_in_usd_cents
-      .expect("cost_in_usd_cents should be present")
-  }
-
-  #[test]
-  fn test_estimate_cost_usd_cents() {
-    // $0.02/image = 2 cents each
-    assert_eq!(estimate_usd_cents(1), 2);
-    assert_eq!(estimate_usd_cents(2), 4);
-    assert_eq!(estimate_usd_cents(3), 6);
-    assert_eq!(estimate_usd_cents(4), 8);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_flux_1_schnell.rs

@@ -1,50 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_flux_1_schnell::PlanArtcraftFlux1Schnell;
-
-pub(crate) fn estimate_image_cost_artcraft_flux_1_schnell(
-  _plan: &PlanArtcraftFlux1Schnell,
-) -> ImageGenerationCostEstimate {
-  // Pricing: not available
-  ImageGenerationCostEstimate {
-    cost_in_credits: None,
-    cost_in_usd_cents: None,
-    is_free: true,
-    is_unlimited: true,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-
-  #[test]
-  fn test_estimate_cost_is_none() {
-    let request = GenerateImageRequestBuilder {
-      model: CommonImageModel::Flux1Schnell,
-      provider: Provider::Artcraft,
-      prompt: None,
-      image_inputs: None,
-      resolution: None,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: Some(1),
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    };
-    let estimate = request.build()
-      .expect("build should succeed")
-      .estimate_costs();
-    assert!(estimate.cost_in_usd_cents.is_none());
-    assert!(estimate.cost_in_credits.is_none());
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_flux_2_lora_angles.rs

@@ -1,74 +0,0 @@
-use artcraft_api_defs::generate::image::angle::flux_2_lora_edit_image_angle::Flux2LoraEditImageAngleNumImages;
-
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_flux_2_lora_angles::PlanArtcraftFlux2LoraAngles;
-
-pub(crate) fn estimate_image_cost_artcraft_flux_2_lora_angles(
-  plan: &PlanArtcraftFlux2LoraAngles,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.04/image (4 cents). 1 credit = 1 USD cent.
-  let cost_per_image: u64 = 4;
-
-  let num_images: u64 = match plan.num_images {
-    Flux2LoraEditImageAngleNumImages::One => 1,
-    Flux2LoraEditImageAngleNumImages::Two => 2,
-    Flux2LoraEditImageAngleNumImages::Three => 3,
-    Flux2LoraEditImageAngleNumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::image_list_ref::ImageListRef;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use tokens::tokens::media_files::MediaFileToken;
-
-  fn estimate_usd_cents(image_batch_count: u16) -> u64 {
-    let tokens = vec![MediaFileToken::new_from_str("test_token")];
-    let request = GenerateImageRequestBuilder {
-      model: CommonImageModel::Flux2LoraAngles,
-      provider: Provider::Artcraft,
-      prompt: None,
-      image_inputs: Some(ImageListRef::MediaFileTokens(tokens.clone())),
-      resolution: None,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: Some(image_batch_count),
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-    };
-    request.build()
-      .expect("build should succeed")
-      .estimate_costs()
-      .cost_in_usd_cents
-      .expect("cost_in_usd_cents should be present")
-  }
-
-  #[test]
-  fn test_estimate_cost_usd_cents() {
-    // $0.04/image = 4 cents each
-    assert_eq!(estimate_usd_cents(1), 4);
-    assert_eq!(estimate_usd_cents(2), 8);
-    assert_eq!(estimate_usd_cents(3), 12);
-    assert_eq!(estimate_usd_cents(4), 16);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_flux_pro_1p1.rs

@@ -1,74 +0,0 @@
-use artcraft_api_defs::generate::image::text::generate_flux_pro_11_text_to_image::GenerateFluxPro11TextToImageNumImages;
-
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_flux_pro_1p1::PlanArtcraftFluxPro11;
-
-pub(crate) fn estimate_image_cost_artcraft_flux_pro_1p1(
-  plan: &PlanArtcraftFluxPro11,
-) -> ImageGenerationCostEstimate {
-  // Fal pricing: $0.04 per megapixel, billed by rounding up to the nearest
-  // megapixel. The default image_size values are ~1MP, so 4 cents per image.
-  // (The legacy `generate_flux_pro_11_text_to_image_handler` charges this same
-  // amount via `FluxPro11Args::calculate_cost_in_cents`.)
-  let cost_per_image: u64 = 4;
-
-  let num_images: u64 = match plan.num_images {
-    GenerateFluxPro11TextToImageNumImages::One => 1,
-    GenerateFluxPro11TextToImageNumImages::Two => 2,
-    GenerateFluxPro11TextToImageNumImages::Three => 3,
-    GenerateFluxPro11TextToImageNumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-
-  fn estimate_usd_cents(image_batch_count: u16) -> u64 {
-    let request = GenerateImageRequestBuilder {
-      model: CommonImageModel::FluxPro11,
-      provider: Provider::Artcraft,
-      prompt: None,
-      image_inputs: None,
-      resolution: None,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: Some(image_batch_count),
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    };
-    request.build()
-      .expect("build should succeed")
-      .estimate_costs()
-      .cost_in_usd_cents
-      .expect("cost_in_usd_cents should be present")
-  }
-
-  #[test]
-  fn test_estimate_cost_usd_cents() {
-    // $0.04/image = 4 cents each (Fal's $0.04/MP at the default ~1MP).
-    assert_eq!(estimate_usd_cents(1), 4);
-    assert_eq!(estimate_usd_cents(2), 8);
-    assert_eq!(estimate_usd_cents(3), 12);
-    assert_eq!(estimate_usd_cents(4), 16);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_flux_pro_1p1_ultra.rs

@@ -1,71 +0,0 @@
-use artcraft_api_defs::generate::image::text::generate_flux_pro_11_ultra_text_to_image::GenerateFluxPro11UltraTextToImageNumImages;
-
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_flux_pro_1p1_ultra::PlanArtcraftFluxPro11Ultra;
-
-pub(crate) fn estimate_image_cost_artcraft_flux_pro_1p1_ultra(
-  plan: &PlanArtcraftFluxPro11Ultra,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.06/image (6 cents). 1 credit = 1 USD cent.
-  let cost_per_image: u64 = 6;
-
-  let num_images: u64 = match plan.num_images {
-    GenerateFluxPro11UltraTextToImageNumImages::One => 1,
-    GenerateFluxPro11UltraTextToImageNumImages::Two => 2,
-    GenerateFluxPro11UltraTextToImageNumImages::Three => 3,
-    GenerateFluxPro11UltraTextToImageNumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-
-  fn estimate_usd_cents(image_batch_count: u16) -> u64 {
-    let request = GenerateImageRequestBuilder {
-      model: CommonImageModel::FluxPro11Ultra,
-      provider: Provider::Artcraft,
-      prompt: None,
-      image_inputs: None,
-      resolution: None,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: Some(image_batch_count),
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    };
-    request.build()
-      .expect("build should succeed")
-      .estimate_costs()
-      .cost_in_usd_cents
-      .expect("cost_in_usd_cents should be present")
-  }
-
-  #[test]
-  fn test_estimate_cost_usd_cents() {
-    // $0.06/image = 6 cents each
-    assert_eq!(estimate_usd_cents(1), 6);
-    assert_eq!(estimate_usd_cents(2), 12);
-    assert_eq!(estimate_usd_cents(3), 18);
-    assert_eq!(estimate_usd_cents(4), 24);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_gpt_image_1.rs

@@ -1,240 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_gpt_image_1::{
-  ArtcraftGptImage1Quality, ArtcraftGptImage1Size, PlanArtcraftGptImage1,
-};
-
-pub(crate) fn estimate_image_cost_artcraft_gpt_image_1(
-  plan: &PlanArtcraftGptImage1,
-) -> ImageGenerationCostEstimate {
-  // Pricing per the fal-ai GPT Image 1 docs, adapted for our artcraft billing:
-  //
-  //   Output image cost (per output image):
-  //     Low    – $0.011 (1024×1024) / $0.016 (other)  →  2¢ / 2¢
-  //     Medium – $0.042 (1024×1024) / $0.063 (other)  →  5¢ / 7¢
-  //     High   – $0.167 (1024×1024) / $0.250 (other)  → 17¢ / 25¢
-  //
-  //   Input image cost (edit mode only, per input image, high-fidelity assumed):
-  //     3,050 tokens × $0.005/1K tokens ≈ $0.01525 → 2¢ per input image
-  //
-  //   Input text tokens: free (we don't charge for these).
-  //
-  let is_square = matches!(
-    plan.image_size,
-    None | Some(ArtcraftGptImage1Size::Square)
-  );
-
-  let output_cost_per_image: u64 = match (plan.quality, is_square) {
-    (ArtcraftGptImage1Quality::Auto, _) => 17, // Auto treated as High square
-    (ArtcraftGptImage1Quality::Low, true) => 2,
-    (ArtcraftGptImage1Quality::Low, false) => 2,
-    (ArtcraftGptImage1Quality::Medium, true) => 5,
-    (ArtcraftGptImage1Quality::Medium, false) => 7,
-    (ArtcraftGptImage1Quality::High, true) => 17,
-    (ArtcraftGptImage1Quality::High, false) => 25,
-  };
-
-  let num_output_images = plan.num_images.as_u64();
-  let output_cost = output_cost_per_image * num_output_images;
-
-  // Input image token cost: 2¢ per input image (high-fidelity estimate).
-  let input_image_cost: u64 = 2 * plan.num_input_images;
-
-  let cost_in_usd_cents = output_cost + input_image_cost;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_aspect_ratio::CommonAspectRatio;
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::common_quality::CommonQuality;
-  use crate::api::image_list_ref::ImageListRef;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use tokens::tokens::media_files::MediaFileToken;
-
-  fn base() -> GenerateImageRequestBuilder {
-    GenerateImageRequestBuilder {
-      model: CommonImageModel::GptImage1,
-      provider: Provider::Artcraft,
-      prompt: None,
-      image_inputs: None,
-      resolution: None,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: Some(1),
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    }
-  }
-
-  fn estimate_text(
-    quality: Option<CommonQuality>,
-    aspect_ratio: Option<CommonAspectRatio>,
-    batch: u16,
-  ) -> u64 {
-    let request = GenerateImageRequestBuilder {
-      quality,
-      aspect_ratio,
-      image_batch_count: Some(batch),
-      ..base()
-    };
-    request.build().unwrap().estimate_costs()
-      .cost_in_usd_cents.unwrap()
-  }
-
-  fn estimate_edit(
-    quality: Option<CommonQuality>,
-    aspect_ratio: Option<CommonAspectRatio>,
-    batch: u16,
-    num_input_images: usize,
-  ) -> u64 {
-    let tokens: Vec<MediaFileToken> = (0..num_input_images)
-      .map(|i| MediaFileToken::new_from_str(&format!("mf_test{:028}", i)))
-      .collect();
-    let request = GenerateImageRequestBuilder {
-      quality,
-      aspect_ratio,
-      image_batch_count: Some(batch),
-      image_inputs: Some(ImageListRef::MediaFileTokens(tokens.clone())),
-      ..base()
-    };
-    request.build().unwrap().estimate_costs()
-      .cost_in_usd_cents.unwrap()
-  }
-
-  // ── Default quality (None → High) ───────────────────────────────────────
-
-  #[test]
-  fn default_quality_square_one_image_costs_17_cents() {
-    assert_eq!(estimate_text(None, None, 1), 17);
-  }
-
-  #[test]
-  fn default_quality_square_four_images_costs_68_cents() {
-    assert_eq!(estimate_text(None, None, 4), 68);
-  }
-
-  // ── Low quality (2¢/image regardless of size) ───────────────────────────
-
-  #[test]
-  fn low_square_one_image() {
-    assert_eq!(estimate_text(Some(CommonQuality::Low), Some(CommonAspectRatio::Square), 1), 2);
-  }
-
-  #[test]
-  fn low_wide_one_image() {
-    assert_eq!(estimate_text(Some(CommonQuality::Low), Some(CommonAspectRatio::WideSixteenByNine), 1), 2);
-  }
-
-  #[test]
-  fn low_tall_one_image() {
-    assert_eq!(estimate_text(Some(CommonQuality::Low), Some(CommonAspectRatio::TallNineBySixteen), 1), 2);
-  }
-
-  #[test]
-  fn low_four_images() {
-    assert_eq!(estimate_text(Some(CommonQuality::Low), None, 4), 8);
-  }
-
-  // ── Medium quality (5¢ square, 7¢ wide/tall) ───────────────────────────
-
-  #[test]
-  fn medium_square_one_image() {
-    assert_eq!(estimate_text(Some(CommonQuality::Medium), Some(CommonAspectRatio::Square), 1), 5);
-  }
-
-  #[test]
-  fn medium_wide_one_image() {
-    assert_eq!(estimate_text(Some(CommonQuality::Medium), Some(CommonAspectRatio::WideSixteenByNine), 1), 7);
-  }
-
-  #[test]
-  fn medium_tall_one_image() {
-    assert_eq!(estimate_text(Some(CommonQuality::Medium), Some(CommonAspectRatio::TallNineBySixteen), 1), 7);
-  }
-
-  #[test]
-  fn medium_square_four_images() {
-    assert_eq!(estimate_text(Some(CommonQuality::Medium), Some(CommonAspectRatio::Square), 4), 20);
-  }
-
-  #[test]
-  fn medium_wide_four_images() {
-    assert_eq!(estimate_text(Some(CommonQuality::Medium), Some(CommonAspectRatio::WideSixteenByNine), 4), 28);
-  }
-
-  // ── High quality (17¢ square, 25¢ wide/tall) ───────────────────────────
-
-  #[test]
-  fn high_square_one_image() {
-    assert_eq!(estimate_text(Some(CommonQuality::High), Some(CommonAspectRatio::Square), 1), 17);
-  }
-
-  #[test]
-  fn high_wide_one_image() {
-    assert_eq!(estimate_text(Some(CommonQuality::High), Some(CommonAspectRatio::WideSixteenByNine), 1), 25);
-  }
-
-  #[test]
-  fn high_tall_one_image() {
-    assert_eq!(estimate_text(Some(CommonQuality::High), Some(CommonAspectRatio::TallNineBySixteen), 1), 25);
-  }
-
-  #[test]
-  fn high_square_four_images() {
-    assert_eq!(estimate_text(Some(CommonQuality::High), Some(CommonAspectRatio::Square), 4), 68);
-  }
-
-  #[test]
-  fn high_wide_four_images() {
-    assert_eq!(estimate_text(Some(CommonQuality::High), Some(CommonAspectRatio::WideSixteenByNine), 4), 100);
-  }
-
-  // ── Edit mode: adds 2¢ per input image ─────────────────────────────────
-
-  #[test]
-  fn edit_one_input_adds_2_cents() {
-    // High square 1 output = 17¢, plus 1 input × 2¢ = 19¢
-    assert_eq!(estimate_edit(Some(CommonQuality::High), Some(CommonAspectRatio::Square), 1, 1), 19);
-  }
-
-  #[test]
-  fn edit_three_inputs_adds_6_cents() {
-    // High square 1 output = 17¢, plus 3 inputs × 2¢ = 23¢
-    assert_eq!(estimate_edit(Some(CommonQuality::High), Some(CommonAspectRatio::Square), 1, 3), 23);
-  }
-
-  #[test]
-  fn edit_five_inputs_adds_10_cents() {
-    // Medium wide 2 outputs = 7×2 = 14¢, plus 5 inputs × 2¢ = 24¢
-    assert_eq!(estimate_edit(Some(CommonQuality::Medium), Some(CommonAspectRatio::WideSixteenByNine), 2, 5), 24);
-  }
-
-  #[test]
-  fn edit_low_quality_with_inputs() {
-    // Low square 1 output = 2¢, plus 2 inputs × 2¢ = 6¢
-    assert_eq!(estimate_edit(Some(CommonQuality::Low), None, 1, 2), 6);
-  }
-
-  // ── Text mode (no input images) has no input cost ──────────────────────
-
-  #[test]
-  fn text_mode_no_input_cost() {
-    assert_eq!(estimate_text(Some(CommonQuality::High), Some(CommonAspectRatio::Square), 1), 17);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_gpt_image_1p5.rs

@@ -1,227 +0,0 @@
-use artcraft_api_defs::generate::image::multi_function::gpt_image_1p5_multi_function_image_gen::{
-  GptImage1p5MultiFunctionImageGenNumImages, GptImage1p5MultiFunctionImageGenQuality,
-  GptImage1p5MultiFunctionImageGenSize,
-};
-
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_gpt_image_1p5::PlanArtcraftGptImage1p5;
-
-pub(crate) fn estimate_image_cost_artcraft_gpt_image_1p5(
-  plan: &PlanArtcraftGptImage1p5,
-) -> ImageGenerationCostEstimate {
-  // Per fal docs (fal-ai/gpt-image-1.5 and fal-ai/gpt-image-1.5/edit):
-  //
-  //   Output image cost (per output image), rounded up to whole cents:
-  //     Low:    $0.009 (1024×1024) / $0.013 (other)  →  1¢ / 2¢
-  //     Medium: $0.034 (1024×1024) / $0.050 (1536×1024) / $0.051 (1024×1536)  →  4¢ / 5¢ / 6¢
-  //     High:   $0.133 (1024×1024) / $0.199 (1536×1024) / $0.200 (1024×1536)  → 14¢ / 20¢ / 20¢
-  //
-  //   Input text tokens: free (we don't charge for these).
-  //
-  //   Default quality: High (when request.quality is None).
-  //
-  use GptImage1p5MultiFunctionImageGenQuality as Q;
-  use GptImage1p5MultiFunctionImageGenSize as S;
-
-  let cost_per_image: u64 = match (plan.quality, plan.image_size) {
-    // Low quality
-    (Q::Low, None | Some(S::Square)) => 1,
-    (Q::Low, Some(S::Wide) | Some(S::Tall)) => 2,
-
-    // Medium quality
-    (Q::Medium, None | Some(S::Square)) => 4,
-    (Q::Medium, Some(S::Wide)) => 5,
-    (Q::Medium, Some(S::Tall)) => 6,
-
-    // High quality
-    (Q::High, None | Some(S::Square)) => 14,
-    (Q::High, Some(S::Wide) | Some(S::Tall)) => 20,
-  };
-
-  let num_images: u64 = match plan.num_images {
-    GptImage1p5MultiFunctionImageGenNumImages::One => 1,
-    GptImage1p5MultiFunctionImageGenNumImages::Two => 2,
-    GptImage1p5MultiFunctionImageGenNumImages::Three => 3,
-    GptImage1p5MultiFunctionImageGenNumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_aspect_ratio::CommonAspectRatio;
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::common_quality::CommonQuality;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-
-  fn estimate(
-    quality: Option<CommonQuality>,
-    aspect_ratio: Option<CommonAspectRatio>,
-    batch: u16,
-  ) -> u64 {
-    let request = GenerateImageRequestBuilder {
-      model: CommonImageModel::GptImage1p5,
-      provider: Provider::Artcraft,
-      prompt: None,
-      image_inputs: None,
-      resolution: None,
-      aspect_ratio,
-      quality,
-      image_batch_count: Some(batch),
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    };
-    request.build().unwrap().estimate_costs()
-      .cost_in_usd_cents.unwrap()
-  }
-
-  // ── Default quality (None → High) ─────────────────────────────────────
-
-  #[test]
-  fn default_quality_square_one_image() {
-    assert_eq!(estimate(None, Some(CommonAspectRatio::Square), 1), 14);
-  }
-
-  #[test]
-  fn default_quality_unset_one_image() {
-    assert_eq!(estimate(None, None, 1), 14);
-  }
-
-  #[test]
-  fn default_quality_wide_one_image() {
-    assert_eq!(estimate(None, Some(CommonAspectRatio::WideSixteenByNine), 1), 20);
-  }
-
-  #[test]
-  fn default_quality_tall_one_image() {
-    assert_eq!(estimate(None, Some(CommonAspectRatio::TallNineBySixteen), 1), 20);
-  }
-
-  #[test]
-  fn default_quality_square_four_images() {
-    assert_eq!(estimate(None, Some(CommonAspectRatio::Square), 4), 56);
-  }
-
-  // ── Low quality (1¢ square, 2¢ wide/tall) ─────────────────────────────
-
-  #[test]
-  fn low_square_one() {
-    assert_eq!(estimate(Some(CommonQuality::Low), Some(CommonAspectRatio::Square), 1), 1);
-  }
-
-  #[test]
-  fn low_unset_one() {
-    assert_eq!(estimate(Some(CommonQuality::Low), None, 1), 1);
-  }
-
-  #[test]
-  fn low_wide_one() {
-    assert_eq!(estimate(Some(CommonQuality::Low), Some(CommonAspectRatio::WideSixteenByNine), 1), 2);
-  }
-
-  #[test]
-  fn low_tall_one() {
-    assert_eq!(estimate(Some(CommonQuality::Low), Some(CommonAspectRatio::TallNineBySixteen), 1), 2);
-  }
-
-  #[test]
-  fn low_square_four() {
-    assert_eq!(estimate(Some(CommonQuality::Low), None, 4), 4);
-  }
-
-  #[test]
-  fn low_wide_four() {
-    assert_eq!(estimate(Some(CommonQuality::Low), Some(CommonAspectRatio::WideSixteenByNine), 4), 8);
-  }
-
-  // ── Medium quality (4¢ square, 5¢ wide, 6¢ tall) ─────────────────────
-
-  #[test]
-  fn medium_square_one() {
-    assert_eq!(estimate(Some(CommonQuality::Medium), Some(CommonAspectRatio::Square), 1), 4);
-  }
-
-  #[test]
-  fn medium_unset_one() {
-    assert_eq!(estimate(Some(CommonQuality::Medium), None, 1), 4);
-  }
-
-  #[test]
-  fn medium_wide_one() {
-    assert_eq!(estimate(Some(CommonQuality::Medium), Some(CommonAspectRatio::WideSixteenByNine), 1), 5);
-  }
-
-  #[test]
-  fn medium_tall_one() {
-    assert_eq!(estimate(Some(CommonQuality::Medium), Some(CommonAspectRatio::TallNineBySixteen), 1), 6);
-  }
-
-  #[test]
-  fn medium_square_four() {
-    assert_eq!(estimate(Some(CommonQuality::Medium), Some(CommonAspectRatio::Square), 4), 16);
-  }
-
-  #[test]
-  fn medium_wide_four() {
-    assert_eq!(estimate(Some(CommonQuality::Medium), Some(CommonAspectRatio::WideSixteenByNine), 4), 20);
-  }
-
-  #[test]
-  fn medium_tall_four() {
-    assert_eq!(estimate(Some(CommonQuality::Medium), Some(CommonAspectRatio::TallNineBySixteen), 4), 24);
-  }
-
-  // ── High quality (14¢ square, 20¢ wide/tall) ─────────────────────────
-
-  #[test]
-  fn high_square_one() {
-    assert_eq!(estimate(Some(CommonQuality::High), Some(CommonAspectRatio::Square), 1), 14);
-  }
-
-  #[test]
-  fn high_unset_one() {
-    assert_eq!(estimate(Some(CommonQuality::High), None, 1), 14);
-  }
-
-  #[test]
-  fn high_wide_one() {
-    assert_eq!(estimate(Some(CommonQuality::High), Some(CommonAspectRatio::WideSixteenByNine), 1), 20);
-  }
-
-  #[test]
-  fn high_tall_one() {
-    assert_eq!(estimate(Some(CommonQuality::High), Some(CommonAspectRatio::TallNineBySixteen), 1), 20);
-  }
-
-  #[test]
-  fn high_square_four() {
-    assert_eq!(estimate(Some(CommonQuality::High), Some(CommonAspectRatio::Square), 4), 56);
-  }
-
-  #[test]
-  fn high_wide_four() {
-    assert_eq!(estimate(Some(CommonQuality::High), Some(CommonAspectRatio::WideSixteenByNine), 4), 80);
-  }
-
-  #[test]
-  fn high_tall_four() {
-    assert_eq!(estimate(Some(CommonQuality::High), Some(CommonAspectRatio::TallNineBySixteen), 4), 80);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_gpt_image_2.rs

@@ -1,211 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_gpt_image_2::{
-  ArtcraftGptImage2ImageSize, ArtcraftGptImage2Quality, PlanArtcraftGptImage2,
-};
-
-pub(crate) fn estimate_image_cost_artcraft_gpt_image_2(
-  plan: &PlanArtcraftGptImage2,
-) -> ImageGenerationCostEstimate {
-  // Same cost table as the Fal GPT Image 2 estimator.
-  //
-  //   Output image cost (per output image), rounded up to whole cents:
-  //     Low:    all sizes                        →  1¢
-  //     Medium: landscape_4_3/portrait_4_3       →  4¢
-  //             landscape_16_9/portrait_16_9     →  4¢
-  //             square                           →  6¢
-  //             square_hd                        →  6¢
-  //     High:   landscape_4_3/portrait_4_3       → 15¢
-  //             landscape_16_9/portrait_16_9     → 16¢
-  //             square                           → 22¢
-  //             square_hd                        → 23¢
-  //
-  use ArtcraftGptImage2ImageSize as S;
-
-  let cost_per_image: u64 = match (plan.quality, plan.image_size) {
-    // Low quality
-    (ArtcraftGptImage2Quality::Low, _) => 1,
-
-    // Medium quality
-    (ArtcraftGptImage2Quality::Medium, None | Some(S::Square) | Some(S::SquareHd)) => 6,
-    (ArtcraftGptImage2Quality::Medium, Some(S::Landscape4x3) | Some(S::Portrait4x3)) => 4,
-    (ArtcraftGptImage2Quality::Medium, Some(S::Landscape16x9) | Some(S::Portrait16x9)) => 4,
-    (ArtcraftGptImage2Quality::Medium, Some(S::Auto)) => 6,
-
-    // High quality
-    (ArtcraftGptImage2Quality::High, None | Some(S::Square)) => 22,
-    (ArtcraftGptImage2Quality::High, Some(S::SquareHd)) => 23,
-    (ArtcraftGptImage2Quality::High, Some(S::Landscape4x3) | Some(S::Portrait4x3)) => 15,
-    (ArtcraftGptImage2Quality::High, Some(S::Landscape16x9) | Some(S::Portrait16x9)) => 16,
-    (ArtcraftGptImage2Quality::High, Some(S::Auto)) => 23,
-  };
-  let cost_in_usd_cents = cost_per_image * plan.num_images.as_u64();
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use super::*;
-  use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_gpt_image_2::ArtcraftGptImage2NumImages;
-
-  fn plan(
-    quality: ArtcraftGptImage2Quality,
-    image_size: Option<ArtcraftGptImage2ImageSize>,
-    num_images: ArtcraftGptImage2NumImages,
-  ) -> PlanArtcraftGptImage2 {
-    PlanArtcraftGptImage2 {
-      prompt: Some("p".to_string()),
-      image_inputs: None,
-      image_size,
-      quality,
-      num_images,
-      idempotency_token: "test".to_string(),
-    }
-  }
-
-  fn cents(
-    quality: ArtcraftGptImage2Quality,
-    image_size: Option<ArtcraftGptImage2ImageSize>,
-    num_images: ArtcraftGptImage2NumImages,
-  ) -> u64 {
-    estimate_image_cost_artcraft_gpt_image_2(&plan(quality, image_size, num_images))
-      .cost_in_usd_cents.unwrap()
-  }
-
-  // -- Low quality (1c for all sizes) -------------------------------------------
-
-  #[test]
-  fn low_square() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::Low, Some(ArtcraftGptImage2ImageSize::Square), ArtcraftGptImage2NumImages::One), 1);
-  }
-
-  #[test]
-  fn low_square_hd() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::Low, Some(ArtcraftGptImage2ImageSize::SquareHd), ArtcraftGptImage2NumImages::One), 1);
-  }
-
-  #[test]
-  fn low_unset() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::Low, None, ArtcraftGptImage2NumImages::One), 1);
-  }
-
-  #[test]
-  fn low_landscape_4x3() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::Low, Some(ArtcraftGptImage2ImageSize::Landscape4x3), ArtcraftGptImage2NumImages::One), 1);
-  }
-
-  #[test]
-  fn low_four() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::Low, None, ArtcraftGptImage2NumImages::Four), 4);
-  }
-
-  // -- Medium quality -----------------------------------------------------------
-
-  #[test]
-  fn medium_square() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::Medium, Some(ArtcraftGptImage2ImageSize::Square), ArtcraftGptImage2NumImages::One), 6);
-  }
-
-  #[test]
-  fn medium_square_hd() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::Medium, Some(ArtcraftGptImage2ImageSize::SquareHd), ArtcraftGptImage2NumImages::One), 6);
-  }
-
-  #[test]
-  fn medium_unset() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::Medium, None, ArtcraftGptImage2NumImages::One), 6);
-  }
-
-  #[test]
-  fn medium_landscape_4x3() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::Medium, Some(ArtcraftGptImage2ImageSize::Landscape4x3), ArtcraftGptImage2NumImages::One), 4);
-  }
-
-  #[test]
-  fn medium_portrait_4x3() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::Medium, Some(ArtcraftGptImage2ImageSize::Portrait4x3), ArtcraftGptImage2NumImages::One), 4);
-  }
-
-  #[test]
-  fn medium_landscape_16x9() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::Medium, Some(ArtcraftGptImage2ImageSize::Landscape16x9), ArtcraftGptImage2NumImages::One), 4);
-  }
-
-  #[test]
-  fn medium_portrait_16x9() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::Medium, Some(ArtcraftGptImage2ImageSize::Portrait16x9), ArtcraftGptImage2NumImages::One), 4);
-  }
-
-  #[test]
-  fn medium_square_four() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::Medium, Some(ArtcraftGptImage2ImageSize::Square), ArtcraftGptImage2NumImages::Four), 24);
-  }
-
-  // -- High quality -------------------------------------------------------------
-
-  #[test]
-  fn high_square() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::High, Some(ArtcraftGptImage2ImageSize::Square), ArtcraftGptImage2NumImages::One), 22);
-  }
-
-  #[test]
-  fn high_square_hd() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::High, Some(ArtcraftGptImage2ImageSize::SquareHd), ArtcraftGptImage2NumImages::One), 23);
-  }
-
-  #[test]
-  fn high_unset() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::High, None, ArtcraftGptImage2NumImages::One), 22);
-  }
-
-  #[test]
-  fn high_landscape_4x3() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::High, Some(ArtcraftGptImage2ImageSize::Landscape4x3), ArtcraftGptImage2NumImages::One), 15);
-  }
-
-  #[test]
-  fn high_portrait_4x3() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::High, Some(ArtcraftGptImage2ImageSize::Portrait4x3), ArtcraftGptImage2NumImages::One), 15);
-  }
-
-  #[test]
-  fn high_landscape_16x9() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::High, Some(ArtcraftGptImage2ImageSize::Landscape16x9), ArtcraftGptImage2NumImages::One), 16);
-  }
-
-  #[test]
-  fn high_portrait_16x9() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::High, Some(ArtcraftGptImage2ImageSize::Portrait16x9), ArtcraftGptImage2NumImages::One), 16);
-  }
-
-  #[test]
-  fn high_square_four() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::High, Some(ArtcraftGptImage2ImageSize::Square), ArtcraftGptImage2NumImages::Four), 88);
-  }
-
-  #[test]
-  fn high_square_hd_four() {
-    assert_eq!(cents(ArtcraftGptImage2Quality::High, Some(ArtcraftGptImage2ImageSize::SquareHd), ArtcraftGptImage2NumImages::Four), 92);
-  }
-
-  // -- Metadata flags -----------------------------------------------------------
-
-  #[test]
-  fn metadata_flags_are_default() {
-    let estimate = estimate_image_cost_artcraft_gpt_image_2(&plan(
-      ArtcraftGptImage2Quality::Medium, None, ArtcraftGptImage2NumImages::One,
-    ));
-    assert!(!estimate.is_free);
-    assert!(!estimate.is_unlimited);
-    assert!(!estimate.is_rate_limited);
-    assert!(!estimate.has_watermark);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_nano_banana.rs

@@ -1,71 +0,0 @@
-use artcraft_api_defs::generate::image::multi_function::nano_banana_multi_function_image_gen::NanoBananaMultiFunctionImageGenNumImages;
-
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_nano_banana::PlanArtcraftNanaBanana;
-
-pub(crate) fn estimate_image_cost_artcraft_nano_banana(
-  plan: &PlanArtcraftNanaBanana,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.04/image (4 cents). 1 credit = 1 USD cent.
-  let cost_per_image: u64 = 4;
-
-  let num_images: u64 = match plan.num_images {
-    NanoBananaMultiFunctionImageGenNumImages::One => 1,
-    NanoBananaMultiFunctionImageGenNumImages::Two => 2,
-    NanoBananaMultiFunctionImageGenNumImages::Three => 3,
-    NanoBananaMultiFunctionImageGenNumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-
-  fn estimate_usd_cents(image_batch_count: u16) -> u64 {
-    let request = GenerateImageRequestBuilder {
-      model: CommonImageModel::NanoBanana,
-      provider: Provider::Artcraft,
-      prompt: None,
-      image_inputs: None,
-      resolution: None,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: Some(image_batch_count),
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    };
-    request.build()
-      .expect("build should succeed")
-      .estimate_costs()
-      .cost_in_usd_cents
-      .expect("cost_in_usd_cents should be present")
-  }
-
-  #[test]
-  fn test_estimate_cost_usd_cents() {
-    // $0.04/image = 4 cents each
-    assert_eq!(estimate_usd_cents(1), 4);
-    assert_eq!(estimate_usd_cents(2), 8);
-    assert_eq!(estimate_usd_cents(3), 12);
-    assert_eq!(estimate_usd_cents(4), 16);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_nano_banana_2.rs

@@ -1,197 +0,0 @@
-use artcraft_api_defs::generate::image::multi_function::nano_banana_2_multi_function_image_gen::{
-  NanaBanana2MultiFunctionImageGenImageResolution, NanaBanana2MultiFunctionImageGenNumImages,
-};
-
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_nano_banana_2::PlanArtcraftNanaBanana2;
-
-pub(crate) fn estimate_image_cost_artcraft_nano_banana_2(
-  plan: &PlanArtcraftNanaBanana2,
-) -> ImageGenerationCostEstimate {
-  // Pricing (USD cents per image), scaled off the 1K base cost of $0.08:
-  //   0.5K → $0.06 (0.75×)
-  //   1K   → $0.08 (1×, default)
-  //   2K   → $0.12 (1.5×)
-  //   4K   → $0.16 (2×)
-  let cost_per_image: u64 = match plan.resolution {
-    Some(NanaBanana2MultiFunctionImageGenImageResolution::HalfK) => 6,
-    Some(NanaBanana2MultiFunctionImageGenImageResolution::OneK) => 8,
-    Some(NanaBanana2MultiFunctionImageGenImageResolution::TwoK) => 12,
-    Some(NanaBanana2MultiFunctionImageGenImageResolution::FourK) => 16,
-    None => 8, // default 1K
-  };
-
-  let num_images: u64 = match plan.num_images {
-    NanaBanana2MultiFunctionImageGenNumImages::One => 1,
-    NanaBanana2MultiFunctionImageGenNumImages::Two => 2,
-    NanaBanana2MultiFunctionImageGenNumImages::Three => 3,
-    NanaBanana2MultiFunctionImageGenNumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::common_resolution::CommonResolution;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-
-  fn estimate_usd_cents(resolution: Option<CommonResolution>, image_batch_count: u16) -> u64 {
-    let request = GenerateImageRequestBuilder {
-      model: CommonImageModel::NanoBanana2,
-      provider: Provider::Artcraft,
-      prompt: None,
-      image_inputs: None,
-      resolution,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: Some(image_batch_count),
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    };
-    request.build()
-      .expect("build should succeed")
-      .estimate_costs()
-      .cost_in_usd_cents
-      .expect("cost_in_usd_cents should be present")
-  }
-
-  // ── Default (None → 1K → 8¢/image) ─────────────────────────────────────────
-
-  #[test]
-  fn default_resolution_one_image_costs_8_cents() {
-    assert_eq!(estimate_usd_cents(None, 1), 8);
-  }
-
-  #[test]
-  fn default_resolution_two_images_costs_16_cents() {
-    assert_eq!(estimate_usd_cents(None, 2), 16);
-  }
-
-  #[test]
-  fn default_resolution_three_images_costs_24_cents() {
-    assert_eq!(estimate_usd_cents(None, 3), 24);
-  }
-
-  #[test]
-  fn default_resolution_four_images_costs_32_cents() {
-    assert_eq!(estimate_usd_cents(None, 4), 32);
-  }
-
-  // ── 0.5K → 6¢/image (0.75× base) ───────────────────────────────────────────
-
-  #[test]
-  fn half_k_one_image_costs_6_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::HalfK), 1), 6);
-  }
-
-  #[test]
-  fn half_k_two_images_costs_12_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::HalfK), 2), 12);
-  }
-
-  #[test]
-  fn half_k_three_images_costs_18_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::HalfK), 3), 18);
-  }
-
-  #[test]
-  fn half_k_four_images_costs_24_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::HalfK), 4), 24);
-  }
-
-  // ── 1K → 8¢/image (base) ───────────────────────────────────────────────────
-
-  #[test]
-  fn one_k_one_image_costs_8_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::OneK), 1), 8);
-  }
-
-  #[test]
-  fn one_k_two_images_costs_16_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::OneK), 2), 16);
-  }
-
-  #[test]
-  fn one_k_three_images_costs_24_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::OneK), 3), 24);
-  }
-
-  #[test]
-  fn one_k_four_images_costs_32_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::OneK), 4), 32);
-  }
-
-  // ── 2K → 12¢/image (1.5× base) ─────────────────────────────────────────────
-
-  #[test]
-  fn two_k_one_image_costs_12_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::TwoK), 1), 12);
-  }
-
-  #[test]
-  fn two_k_two_images_costs_24_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::TwoK), 2), 24);
-  }
-
-  #[test]
-  fn two_k_three_images_costs_36_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::TwoK), 3), 36);
-  }
-
-  #[test]
-  fn two_k_four_images_costs_48_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::TwoK), 4), 48);
-  }
-
-  // ── 4K → 16¢/image (2× base) ───────────────────────────────────────────────
-
-  #[test]
-  fn four_k_one_image_costs_16_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::FourK), 1), 16);
-  }
-
-  #[test]
-  fn four_k_two_images_costs_32_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::FourK), 2), 32);
-  }
-
-  #[test]
-  fn four_k_three_images_costs_48_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::FourK), 3), 48);
-  }
-
-  #[test]
-  fn four_k_four_images_costs_64_cents() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::FourK), 4), 64);
-  }
-
-  // ── 3K (unsupported) falls back to 2K pricing ──────────────────────────────
-
-  #[test]
-  fn three_k_one_image_falls_back_to_two_k_pricing() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::ThreeK), 1), 12);
-  }
-
-  #[test]
-  fn three_k_four_images_falls_back_to_two_k_pricing() {
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::ThreeK), 4), 48);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_nano_banana_pro.rs

@@ -1,85 +0,0 @@
-use artcraft_api_defs::generate::image::multi_function::nano_banana_pro_multi_function_image_gen::{
-  NanoBananaProMultiFunctionImageGenImageResolution, NanoBananaProMultiFunctionImageGenNumImages,
-};
-
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_nano_banana_pro::PlanArtcraftNanaBananaPro;
-
-pub(crate) fn estimate_image_cost_artcraft_nano_banana_pro(
-  plan: &PlanArtcraftNanaBananaPro,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.15/image at 1K or 2K resolution, $0.30/image at 4K.
-  // (Stored as USD cents.)
-  let cost_per_image: u64 = match plan.resolution {
-    Some(NanoBananaProMultiFunctionImageGenImageResolution::FourK) => 30,
-    _ => 15,
-  };
-
-  let num_images: u64 = match plan.num_images {
-    NanoBananaProMultiFunctionImageGenNumImages::One => 1,
-    NanoBananaProMultiFunctionImageGenNumImages::Two => 2,
-    NanoBananaProMultiFunctionImageGenNumImages::Three => 3,
-    NanoBananaProMultiFunctionImageGenNumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::common_resolution::CommonResolution;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-
-  fn estimate_usd_cents(resolution: Option<CommonResolution>, image_batch_count: u16) -> u64 {
-    let request = GenerateImageRequestBuilder {
-      model: CommonImageModel::NanoBananaPro,
-      provider: Provider::Artcraft,
-      prompt: None,
-      image_inputs: None,
-      resolution,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: Some(image_batch_count),
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    };
-    request.build()
-      .expect("build should succeed")
-      .estimate_costs()
-      .cost_in_usd_cents
-      .expect("cost_in_usd_cents should be present")
-  }
-
-  #[test]
-  fn test_estimate_cost_usd_cents() {
-    // 1K/2K: $0.15/image = 15 cents
-    assert_eq!(estimate_usd_cents(None, 1), 15);
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::OneK), 1), 15);
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::TwoK), 1), 15);
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::OneK), 2), 30);
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::OneK), 3), 45);
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::OneK), 4), 60);
-
-    // 4K: $0.30/image = 30 cents
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::FourK), 1), 30);
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::FourK), 2), 60);
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::FourK), 4), 120);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_qwen_edit_2511_angles.rs

@@ -1,74 +0,0 @@
-use artcraft_api_defs::generate::image::angle::qwen_edit_2511_edit_image_angle::QwenEdit2511EditImageAngleNumImages;
-
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_qwen_edit_2511_angles::PlanArtcraftQwenEdit2511Angles;
-
-pub(crate) fn estimate_image_cost_artcraft_qwen_edit_2511_angles(
-  plan: &PlanArtcraftQwenEdit2511Angles,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.04/image (4 cents). 1 credit = 1 USD cent.
-  let cost_per_image: u64 = 4;
-
-  let num_images: u64 = match plan.num_images {
-    QwenEdit2511EditImageAngleNumImages::One => 1,
-    QwenEdit2511EditImageAngleNumImages::Two => 2,
-    QwenEdit2511EditImageAngleNumImages::Three => 3,
-    QwenEdit2511EditImageAngleNumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::image_list_ref::ImageListRef;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use tokens::tokens::media_files::MediaFileToken;
-
-  fn estimate_usd_cents(image_batch_count: u16) -> u64 {
-    let tokens = vec![MediaFileToken::new_from_str("test_token")];
-    let request = GenerateImageRequestBuilder {
-      model: CommonImageModel::QwenEdit2511Angles,
-      provider: Provider::Artcraft,
-      prompt: None,
-      image_inputs: Some(ImageListRef::MediaFileTokens(tokens.clone())),
-      resolution: None,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: Some(image_batch_count),
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    };
-    request.build()
-      .expect("build should succeed")
-      .estimate_costs()
-      .cost_in_usd_cents
-      .expect("cost_in_usd_cents should be present")
-  }
-
-  #[test]
-  fn test_estimate_cost_usd_cents() {
-    // $0.04/image = 4 cents each
-    assert_eq!(estimate_usd_cents(1), 4);
-    assert_eq!(estimate_usd_cents(2), 8);
-    assert_eq!(estimate_usd_cents(3), 12);
-    assert_eq!(estimate_usd_cents(4), 16);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_seedream_4.rs

@@ -1,71 +0,0 @@
-use artcraft_api_defs::generate::image::multi_function::bytedance_seedream_v4_multi_function_image_gen::BytedanceSeedreamV4MultiFunctionImageGenNumImages;
-
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_seedream_4::PlanArtcraftSeedream4;
-
-pub(crate) fn estimate_image_cost_artcraft_seedream_4(
-  plan: &PlanArtcraftSeedream4,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.03/image (3 cents). 1 credit = 1 USD cent.
-  let cost_per_image: u64 = 3;
-
-  let num_images: u64 = match plan.num_images {
-    BytedanceSeedreamV4MultiFunctionImageGenNumImages::One => 1,
-    BytedanceSeedreamV4MultiFunctionImageGenNumImages::Two => 2,
-    BytedanceSeedreamV4MultiFunctionImageGenNumImages::Three => 3,
-    BytedanceSeedreamV4MultiFunctionImageGenNumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-
-  fn estimate_usd_cents(image_batch_count: u16) -> u64 {
-    let request = GenerateImageRequestBuilder {
-      model: CommonImageModel::Seedream4,
-      provider: Provider::Artcraft,
-      prompt: None,
-      image_inputs: None,
-      resolution: None,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: Some(image_batch_count),
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    };
-    request.build()
-      .expect("build should succeed")
-      .estimate_costs()
-      .cost_in_usd_cents
-      .expect("cost_in_usd_cents should be present")
-  }
-
-  #[test]
-  fn test_estimate_cost_usd_cents() {
-    // $0.03/image = 3 cents each
-    assert_eq!(estimate_usd_cents(1), 3);
-    assert_eq!(estimate_usd_cents(2), 6);
-    assert_eq!(estimate_usd_cents(3), 9);
-    assert_eq!(estimate_usd_cents(4), 12);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_seedream_4p5.rs

@@ -1,71 +0,0 @@
-use artcraft_api_defs::generate::image::multi_function::bytedance_seedream_v4p5_multi_function_image_gen::BytedanceSeedreamV4p5MultiFunctionImageGenNumImages;
-
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_seedream_4p5::PlanArtcraftSeedream4p5;
-
-pub(crate) fn estimate_image_cost_artcraft_seedream_4p5(
-  plan: &PlanArtcraftSeedream4p5,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.04/image (4 cents). 1 credit = 1 USD cent.
-  let cost_per_image: u64 = 4;
-
-  let num_images: u64 = match plan.num_images {
-    BytedanceSeedreamV4p5MultiFunctionImageGenNumImages::One => 1,
-    BytedanceSeedreamV4p5MultiFunctionImageGenNumImages::Two => 2,
-    BytedanceSeedreamV4p5MultiFunctionImageGenNumImages::Three => 3,
-    BytedanceSeedreamV4p5MultiFunctionImageGenNumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-
-  fn estimate_usd_cents(image_batch_count: u16) -> u64 {
-    let request = GenerateImageRequestBuilder {
-      model: CommonImageModel::Seedream4p5,
-      provider: Provider::Artcraft,
-      prompt: None,
-      image_inputs: None,
-      resolution: None,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: Some(image_batch_count),
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    };
-    request.build()
-      .expect("build should succeed")
-      .estimate_costs()
-      .cost_in_usd_cents
-      .expect("cost_in_usd_cents should be present")
-  }
-
-  #[test]
-  fn test_estimate_cost_usd_cents() {
-    // $0.04/image = 4 cents each
-    assert_eq!(estimate_usd_cents(1), 4);
-    assert_eq!(estimate_usd_cents(2), 8);
-    assert_eq!(estimate_usd_cents(3), 12);
-    assert_eq!(estimate_usd_cents(4), 16);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/estimate_image_cost_artcraft_seedream_5_lite.rs

@@ -1,71 +0,0 @@
-use artcraft_api_defs::generate::image::multi_function::bytedance_seedream_5_lite_multi_function_image_gen::BytedanceSeedream5LiteMultiFunctionImageGenNumImages;
-
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_seedream_5_lite::PlanArtcraftSeedream5Lite;
-
-pub(crate) fn estimate_image_cost_artcraft_seedream_5_lite(
-  plan: &PlanArtcraftSeedream5Lite,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.04/image (4 cents). 1 credit = 1 USD cent.
-  let cost_per_image: u64 = 4;
-
-  let num_images: u64 = match plan.num_images {
-    BytedanceSeedream5LiteMultiFunctionImageGenNumImages::One => 1,
-    BytedanceSeedream5LiteMultiFunctionImageGenNumImages::Two => 2,
-    BytedanceSeedream5LiteMultiFunctionImageGenNumImages::Three => 3,
-    BytedanceSeedream5LiteMultiFunctionImageGenNumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-
-  fn estimate_usd_cents(image_batch_count: u16) -> u64 {
-    let request = GenerateImageRequestBuilder {
-      model: CommonImageModel::Seedream5Lite,
-      provider: Provider::Artcraft,
-      prompt: None,
-      image_inputs: None,
-      resolution: None,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: Some(image_batch_count),
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    };
-    request.build()
-      .expect("build should succeed")
-      .estimate_costs()
-      .cost_in_usd_cents
-      .expect("cost_in_usd_cents should be present")
-  }
-
-  #[test]
-  fn test_estimate_cost_usd_cents() {
-    // $0.04/image = 4 cents each
-    assert_eq!(estimate_usd_cents(1), 4);
-    assert_eq!(estimate_usd_cents(2), 8);
-    assert_eq!(estimate_usd_cents(3), 12);
-    assert_eq!(estimate_usd_cents(4), 16);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/artcraft/mod.rs

@@ -1,15 +0,0 @@
-pub mod estimate_image_cost_artcraft_flux_1_dev;
-pub mod estimate_image_cost_artcraft_flux_1_schnell;
-pub mod estimate_image_cost_artcraft_flux_pro_1p1;
-pub mod estimate_image_cost_artcraft_flux_pro_1p1_ultra;
-pub mod estimate_image_cost_artcraft_gpt_image_1;
-pub mod estimate_image_cost_artcraft_gpt_image_1p5;
-pub mod estimate_image_cost_artcraft_gpt_image_2;
-pub mod estimate_image_cost_artcraft_nano_banana;
-pub mod estimate_image_cost_artcraft_nano_banana_2;
-pub mod estimate_image_cost_artcraft_nano_banana_pro;
-pub mod estimate_image_cost_artcraft_seedream_4;
-pub mod estimate_image_cost_artcraft_seedream_4p5;
-pub mod estimate_image_cost_artcraft_seedream_5_lite;
-pub mod estimate_image_cost_artcraft_qwen_edit_2511_angles;
-pub mod estimate_image_cost_artcraft_flux_2_lora_angles;

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/fal/estimate_image_cost_fal_flux_1_dev.rs

@@ -1,27 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::fal::plan_generate_image_fal_flux_1_dev::PlanFalFlux1Dev;
-
-pub(crate) fn estimate_image_cost_fal_flux_1_dev(
-  plan: &PlanFalFlux1Dev,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.025 per megapixel, billed by rounding up to nearest megapixel.
-  // Default image sizes are ~1MP (1024x1024), so ~$0.025/image = 3 cents rounded up.
-  //
-  // Fal docs:
-  //   Your request will cost $0.025 per megapixel, with images billed by rounding up
-  //   to the nearest megapixel.
-  //
-  let cost_per_image: u64 = 3;
-  let num_images = plan.num_images.as_u64();
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/fal/estimate_image_cost_fal_flux_1_schnell.rs

@@ -1,27 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::fal::plan_generate_image_fal_flux_1_schnell::PlanFalFlux1Schnell;
-
-pub(crate) fn estimate_image_cost_fal_flux_1_schnell(
-  plan: &PlanFalFlux1Schnell,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.003 per megapixel, billed by rounding up to nearest megapixel.
-  // Default image sizes are ~1MP (1024x1024), so ~$0.003/image = 1 cent rounded up.
-  //
-  // Fal docs:
-  //   Your request will cost $0.003 per megapixel, with images billed by rounding up
-  //   to the nearest megapixel.
-  //
-  let cost_per_image: u64 = 1;
-  let num_images = plan.num_images.as_u64();
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/fal/estimate_image_cost_fal_flux_pro_1p1.rs

@@ -1,22 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::fal::plan_generate_image_fal_flux_pro_1p1::PlanFalFluxPro11;
-
-pub(crate) fn estimate_image_cost_fal_flux_pro_1p1(
-  plan: &PlanFalFluxPro11,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.04 per megapixel, billed by rounding up to nearest megapixel.
-  // Default image sizes are ~1MP (1024x1024), so ~$0.04/image = 4 cents.
-  let cost_per_image: u64 = 4;
-  let num_images = plan.num_images.as_u64();
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/fal/estimate_image_cost_fal_flux_pro_1p1_ultra.rs

@@ -1,21 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::fal::plan_generate_image_fal_flux_pro_1p1_ultra::PlanFalFluxPro11Ultra;
-
-pub(crate) fn estimate_image_cost_fal_flux_pro_1p1_ultra(
-  plan: &PlanFalFluxPro11Ultra,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.06 per image.
-  let cost_per_image: u64 = 6;
-  let num_images = plan.num_images.as_u64();
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/fal/estimate_image_cost_fal_gpt_image_1.rs

@@ -1,246 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::fal::plan_generate_image_fal_gpt_image_1::{
-  FalGptImage1ImageSize, FalGptImage1Quality, PlanFalGptImage1,
-};
-
-pub(crate) fn estimate_image_cost_fal_gpt_image_1(
-  plan: &PlanFalGptImage1,
-) -> ImageGenerationCostEstimate {
-  // Per fal docs (fal-ai/gpt-image-1/{text-to-image,edit-image}):
-  //
-  //   Output image cost (per output image):
-  //     Low:    $0.011 (1024×1024) / $0.016 (other) →  2¢ / 2¢
-  //     Medium: $0.042 (1024×1024) / $0.063 (other) →  5¢ / 7¢
-  //     High:   $0.167 (1024×1024) / $0.250 (other) → 17¢ / 25¢
-  //
-  //   Input image tokens (edit mode, per input image, high-fidelity assumed):
-  //     3,050 tokens × $0.005/1K tokens ≈ $0.01525 → 2¢ per input image
-  //
-  //   Input text tokens: free (we don't charge for these).
-  //
-  let is_square = matches!(plan.image_size, None | Some(FalGptImage1ImageSize::Square));
-  let output_cost_per_image: u64 = match (plan.quality, is_square) {
-    (FalGptImage1Quality::Low, true) => 2,
-    (FalGptImage1Quality::Low, false) => 2,
-    (FalGptImage1Quality::Medium, true) => 5,
-    (FalGptImage1Quality::Medium, false) => 7,
-    (FalGptImage1Quality::High, true) => 17,
-    (FalGptImage1Quality::High, false) => 25,
-  };
-
-  let num_output_images = plan.num_images.as_u64();
-  let output_cost = output_cost_per_image * num_output_images;
-
-  // Input image token cost: 2¢ per input image (high-fidelity estimate).
-  let input_image_cost: u64 = if plan.image_urls.is_empty() {
-    0
-  } else {
-    2 * plan.image_urls.len() as u64
-  };
-
-  let cost_in_usd_cents = output_cost + input_image_cost;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use super::*;
-  use crate::generate::generate_image::plan::fal::plan_generate_image_fal_gpt_image_1::FalGptImage1NumImages;
-
-  fn text_plan(
-    quality: FalGptImage1Quality,
-    image_size: Option<FalGptImage1ImageSize>,
-    num_images: FalGptImage1NumImages,
-  ) -> PlanFalGptImage1 {
-    PlanFalGptImage1 {
-      prompt: Some("p".to_string()),
-      image_urls: vec![],
-      image_size,
-      quality,
-      num_images,
-    }
-  }
-
-  fn edit_plan(
-    quality: FalGptImage1Quality,
-    image_size: Option<FalGptImage1ImageSize>,
-    num_images: FalGptImage1NumImages,
-    num_input_images: usize,
-  ) -> PlanFalGptImage1 {
-    let image_urls = (0..num_input_images)
-      .map(|i| format!("https://fake.example.com/img{}.png", i))
-      .collect();
-    PlanFalGptImage1 {
-      prompt: Some("p".to_string()),
-      image_urls,
-      image_size,
-      quality,
-      num_images,
-    }
-  }
-
-  fn cents_text(
-    quality: FalGptImage1Quality,
-    image_size: Option<FalGptImage1ImageSize>,
-    num_images: FalGptImage1NumImages,
-  ) -> u64 {
-    estimate_image_cost_fal_gpt_image_1(&text_plan(quality, image_size, num_images))
-      .cost_in_usd_cents
-      .unwrap()
-  }
-
-  fn cents_edit(
-    quality: FalGptImage1Quality,
-    image_size: Option<FalGptImage1ImageSize>,
-    num_images: FalGptImage1NumImages,
-    num_input_images: usize,
-  ) -> u64 {
-    estimate_image_cost_fal_gpt_image_1(&edit_plan(quality, image_size, num_images, num_input_images))
-      .cost_in_usd_cents
-      .unwrap()
-  }
-
-  // ── Low quality text-to-image (2¢/image, both sizes) ──────────────────
-
-  #[test]
-  fn low_square_one_image() {
-    assert_eq!(cents_text(FalGptImage1Quality::Low, Some(FalGptImage1ImageSize::Square), FalGptImage1NumImages::One), 2);
-  }
-
-  #[test]
-  fn low_horizontal_one_image() {
-    assert_eq!(cents_text(FalGptImage1Quality::Low, Some(FalGptImage1ImageSize::Horizontal), FalGptImage1NumImages::One), 2);
-  }
-
-  #[test]
-  fn low_vertical_one_image() {
-    assert_eq!(cents_text(FalGptImage1Quality::Low, Some(FalGptImage1ImageSize::Vertical), FalGptImage1NumImages::One), 2);
-  }
-
-  #[test]
-  fn low_unset_size_one_image() {
-    assert_eq!(cents_text(FalGptImage1Quality::Low, None, FalGptImage1NumImages::One), 2);
-  }
-
-  #[test]
-  fn low_four_images() {
-    assert_eq!(cents_text(FalGptImage1Quality::Low, None, FalGptImage1NumImages::Four), 8);
-  }
-
-  // ── Medium quality text-to-image (5¢ square, 7¢ wide/tall) ────────────
-
-  #[test]
-  fn medium_square_one_image() {
-    assert_eq!(cents_text(FalGptImage1Quality::Medium, Some(FalGptImage1ImageSize::Square), FalGptImage1NumImages::One), 5);
-  }
-
-  #[test]
-  fn medium_horizontal_one_image() {
-    assert_eq!(cents_text(FalGptImage1Quality::Medium, Some(FalGptImage1ImageSize::Horizontal), FalGptImage1NumImages::One), 7);
-  }
-
-  #[test]
-  fn medium_vertical_one_image() {
-    assert_eq!(cents_text(FalGptImage1Quality::Medium, Some(FalGptImage1ImageSize::Vertical), FalGptImage1NumImages::One), 7);
-  }
-
-  #[test]
-  fn medium_square_four_images() {
-    assert_eq!(cents_text(FalGptImage1Quality::Medium, Some(FalGptImage1ImageSize::Square), FalGptImage1NumImages::Four), 20);
-  }
-
-  #[test]
-  fn medium_horizontal_four_images() {
-    assert_eq!(cents_text(FalGptImage1Quality::Medium, Some(FalGptImage1ImageSize::Horizontal), FalGptImage1NumImages::Four), 28);
-  }
-
-  // ── High quality text-to-image (17¢ square, 25¢ wide/tall) ────────────
-
-  #[test]
-  fn high_square_one_image() {
-    assert_eq!(cents_text(FalGptImage1Quality::High, Some(FalGptImage1ImageSize::Square), FalGptImage1NumImages::One), 17);
-  }
-
-  #[test]
-  fn high_horizontal_one_image() {
-    assert_eq!(cents_text(FalGptImage1Quality::High, Some(FalGptImage1ImageSize::Horizontal), FalGptImage1NumImages::One), 25);
-  }
-
-  #[test]
-  fn high_vertical_one_image() {
-    assert_eq!(cents_text(FalGptImage1Quality::High, Some(FalGptImage1ImageSize::Vertical), FalGptImage1NumImages::One), 25);
-  }
-
-  #[test]
-  fn high_square_two_images() {
-    assert_eq!(cents_text(FalGptImage1Quality::High, Some(FalGptImage1ImageSize::Square), FalGptImage1NumImages::Two), 34);
-  }
-
-  #[test]
-  fn high_horizontal_four_images() {
-    assert_eq!(cents_text(FalGptImage1Quality::High, Some(FalGptImage1ImageSize::Horizontal), FalGptImage1NumImages::Four), 100);
-  }
-
-  // ── Edit mode adds 2¢ per input image ─────────────────────────────────
-
-  #[test]
-  fn edit_high_square_one_output_one_input() {
-    // 17¢ output + 2¢ input = 19¢
-    assert_eq!(cents_edit(FalGptImage1Quality::High, Some(FalGptImage1ImageSize::Square), FalGptImage1NumImages::One, 1), 19);
-  }
-
-  #[test]
-  fn edit_high_square_one_output_three_inputs() {
-    // 17¢ output + 3×2¢ input = 23¢
-    assert_eq!(cents_edit(FalGptImage1Quality::High, Some(FalGptImage1ImageSize::Square), FalGptImage1NumImages::One, 3), 23);
-  }
-
-  #[test]
-  fn edit_medium_wide_two_outputs_five_inputs() {
-    // 2×7¢ output + 5×2¢ input = 24¢
-    assert_eq!(cents_edit(FalGptImage1Quality::Medium, Some(FalGptImage1ImageSize::Horizontal), FalGptImage1NumImages::Two, 5), 24);
-  }
-
-  #[test]
-  fn edit_low_square_one_output_two_inputs() {
-    // 2¢ output + 2×2¢ input = 6¢
-    assert_eq!(cents_edit(FalGptImage1Quality::Low, Some(FalGptImage1ImageSize::Square), FalGptImage1NumImages::One, 2), 6);
-  }
-
-  #[test]
-  fn edit_high_vertical_four_outputs_one_input() {
-    // 4×25¢ output + 1×2¢ input = 102¢
-    assert_eq!(cents_edit(FalGptImage1Quality::High, Some(FalGptImage1ImageSize::Vertical), FalGptImage1NumImages::Four, 1), 102);
-  }
-
-  // ── Text mode has no input image cost ─────────────────────────────────
-
-  #[test]
-  fn text_mode_no_input_cost() {
-    assert_eq!(cents_text(FalGptImage1Quality::High, Some(FalGptImage1ImageSize::Square), FalGptImage1NumImages::One), 17);
-  }
-
-  // ── Metadata flags ────────────────────────────────────────────────────
-
-  #[test]
-  fn metadata_flags_are_default() {
-    let estimate = estimate_image_cost_fal_gpt_image_1(&text_plan(
-      FalGptImage1Quality::Medium,
-      None,
-      FalGptImage1NumImages::One,
-    ));
-    assert!(!estimate.is_free);
-    assert!(!estimate.is_unlimited);
-    assert!(!estimate.is_rate_limited);
-    assert!(!estimate.has_watermark);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/fal/estimate_image_cost_fal_gpt_image_1p5.rs

@@ -1,181 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::fal::plan_generate_image_fal_gpt_image_1p5::{
-  FalGptImage1p5ImageSize, FalGptImage1p5Quality, PlanFalGptImage1p5,
-};
-
-pub(crate) fn estimate_image_cost_fal_gpt_image_1p5(
-  plan: &PlanFalGptImage1p5,
-) -> ImageGenerationCostEstimate {
-  // Per fal docs (fal-ai/gpt-image-1.5 and fal-ai/gpt-image-1.5/edit):
-  //
-  //   Output image cost (per output image), rounded up to whole cents:
-  //     Low:    $0.009 (1024×1024) / $0.013 (other)  →  1¢ / 2¢
-  //     Medium: $0.034 (1024×1024) / $0.050 (1536×1024) / $0.051 (1024×1536)  →  4¢ / 5¢ / 6¢
-  //     High:   $0.133 (1024×1024) / $0.199 (1536×1024) / $0.200 (1024×1536)  → 14¢ / 20¢ / 20¢
-  //
-  use FalGptImage1p5ImageSize as S;
-
-  let cost_per_image: u64 = match (plan.quality, plan.image_size) {
-    // Low quality
-    (FalGptImage1p5Quality::Low, None | Some(S::Square)) => 1,
-    (FalGptImage1p5Quality::Low, Some(S::Wide) | Some(S::Tall)) => 2,
-
-    // Medium quality
-    (FalGptImage1p5Quality::Medium, None | Some(S::Square)) => 4,
-    (FalGptImage1p5Quality::Medium, Some(S::Wide)) => 5,
-    (FalGptImage1p5Quality::Medium, Some(S::Tall)) => 6,
-
-    // High quality
-    (FalGptImage1p5Quality::High, None | Some(S::Square)) => 14,
-    (FalGptImage1p5Quality::High, Some(S::Wide) | Some(S::Tall)) => 20,
-  };
-  let cost_in_usd_cents = cost_per_image * plan.num_images.as_u64();
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use super::*;
-  use crate::generate::generate_image::plan::fal::plan_generate_image_fal_gpt_image_1p5::FalGptImage1p5NumImages;
-
-  fn plan(
-    quality: FalGptImage1p5Quality,
-    image_size: Option<FalGptImage1p5ImageSize>,
-    num_images: FalGptImage1p5NumImages,
-  ) -> PlanFalGptImage1p5 {
-    PlanFalGptImage1p5 {
-      prompt: Some("p".to_string()),
-      image_urls: vec![],
-      image_size,
-      quality,
-      num_images,
-    }
-  }
-
-  fn cents(
-    quality: FalGptImage1p5Quality,
-    image_size: Option<FalGptImage1p5ImageSize>,
-    num_images: FalGptImage1p5NumImages,
-  ) -> u64 {
-    estimate_image_cost_fal_gpt_image_1p5(&plan(quality, image_size, num_images))
-      .cost_in_usd_cents.unwrap()
-  }
-
-  // ── Low quality (1¢ square, 2¢ wide/tall) ─────────────────────────────
-
-  #[test]
-  fn low_square() {
-    assert_eq!(cents(FalGptImage1p5Quality::Low, Some(FalGptImage1p5ImageSize::Square), FalGptImage1p5NumImages::One), 1);
-  }
-
-  #[test]
-  fn low_unset() {
-    assert_eq!(cents(FalGptImage1p5Quality::Low, None, FalGptImage1p5NumImages::One), 1);
-  }
-
-  #[test]
-  fn low_wide() {
-    assert_eq!(cents(FalGptImage1p5Quality::Low, Some(FalGptImage1p5ImageSize::Wide), FalGptImage1p5NumImages::One), 2);
-  }
-
-  #[test]
-  fn low_tall() {
-    assert_eq!(cents(FalGptImage1p5Quality::Low, Some(FalGptImage1p5ImageSize::Tall), FalGptImage1p5NumImages::One), 2);
-  }
-
-  #[test]
-  fn low_four() {
-    assert_eq!(cents(FalGptImage1p5Quality::Low, None, FalGptImage1p5NumImages::Four), 4);
-  }
-
-  // ── Medium quality (4¢ square, 5¢ wide, 6¢ tall) ─────────────────────
-
-  #[test]
-  fn medium_square() {
-    assert_eq!(cents(FalGptImage1p5Quality::Medium, Some(FalGptImage1p5ImageSize::Square), FalGptImage1p5NumImages::One), 4);
-  }
-
-  #[test]
-  fn medium_unset() {
-    assert_eq!(cents(FalGptImage1p5Quality::Medium, None, FalGptImage1p5NumImages::One), 4);
-  }
-
-  #[test]
-  fn medium_wide() {
-    assert_eq!(cents(FalGptImage1p5Quality::Medium, Some(FalGptImage1p5ImageSize::Wide), FalGptImage1p5NumImages::One), 5);
-  }
-
-  #[test]
-  fn medium_tall() {
-    assert_eq!(cents(FalGptImage1p5Quality::Medium, Some(FalGptImage1p5ImageSize::Tall), FalGptImage1p5NumImages::One), 6);
-  }
-
-  #[test]
-  fn medium_square_four() {
-    assert_eq!(cents(FalGptImage1p5Quality::Medium, Some(FalGptImage1p5ImageSize::Square), FalGptImage1p5NumImages::Four), 16);
-  }
-
-  #[test]
-  fn medium_wide_four() {
-    assert_eq!(cents(FalGptImage1p5Quality::Medium, Some(FalGptImage1p5ImageSize::Wide), FalGptImage1p5NumImages::Four), 20);
-  }
-
-  #[test]
-  fn medium_tall_four() {
-    assert_eq!(cents(FalGptImage1p5Quality::Medium, Some(FalGptImage1p5ImageSize::Tall), FalGptImage1p5NumImages::Four), 24);
-  }
-
-  // ── High quality (14¢ square, 20¢ wide/tall) ─────────────────────────
-
-  #[test]
-  fn high_square() {
-    assert_eq!(cents(FalGptImage1p5Quality::High, Some(FalGptImage1p5ImageSize::Square), FalGptImage1p5NumImages::One), 14);
-  }
-
-  #[test]
-  fn high_unset() {
-    assert_eq!(cents(FalGptImage1p5Quality::High, None, FalGptImage1p5NumImages::One), 14);
-  }
-
-  #[test]
-  fn high_wide() {
-    assert_eq!(cents(FalGptImage1p5Quality::High, Some(FalGptImage1p5ImageSize::Wide), FalGptImage1p5NumImages::One), 20);
-  }
-
-  #[test]
-  fn high_tall() {
-    assert_eq!(cents(FalGptImage1p5Quality::High, Some(FalGptImage1p5ImageSize::Tall), FalGptImage1p5NumImages::One), 20);
-  }
-
-  #[test]
-  fn high_square_four() {
-    assert_eq!(cents(FalGptImage1p5Quality::High, Some(FalGptImage1p5ImageSize::Square), FalGptImage1p5NumImages::Four), 56);
-  }
-
-  #[test]
-  fn high_wide_four() {
-    assert_eq!(cents(FalGptImage1p5Quality::High, Some(FalGptImage1p5ImageSize::Wide), FalGptImage1p5NumImages::Four), 80);
-  }
-
-  // ── Metadata flags ────────────────────────────────────────────────────
-
-  #[test]
-  fn metadata_flags_are_default() {
-    let estimate = estimate_image_cost_fal_gpt_image_1p5(&plan(
-      FalGptImage1p5Quality::Medium, None, FalGptImage1p5NumImages::One,
-    ));
-    assert!(!estimate.is_free);
-    assert!(!estimate.is_unlimited);
-    assert!(!estimate.is_rate_limited);
-    assert!(!estimate.has_watermark);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/fal/estimate_image_cost_fal_gpt_image_2.rs

@@ -1,210 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::fal::plan_generate_image_fal_gpt_image_2::{
-  FalGptImage2ImageSize, FalGptImage2Quality, PlanFalGptImage2,
-};
-
-pub(crate) fn estimate_image_cost_fal_gpt_image_2(
-  plan: &PlanFalGptImage2,
-) -> ImageGenerationCostEstimate {
-  // Per fal docs (fal-ai/gpt-image-2 and fal-ai/gpt-image-2/edit):
-  //
-  //   Output image cost (per output image), rounded up to whole cents:
-  //     Low:    all sizes                        →  1¢
-  //     Medium: landscape_4_3/portrait_4_3       →  4¢
-  //             landscape_16_9/portrait_16_9     →  4¢
-  //             square                           →  6¢
-  //             square_hd                        →  6¢
-  //     High:   landscape_4_3/portrait_4_3       → 15¢
-  //             landscape_16_9/portrait_16_9     → 16¢
-  //             square                           → 22¢
-  //             square_hd                        → 23¢
-  //
-  use FalGptImage2ImageSize as S;
-
-  let cost_per_image: u64 = match (plan.quality, plan.image_size) {
-    // Low quality
-    (FalGptImage2Quality::Low, _) => 1,
-
-    // Medium quality
-    (FalGptImage2Quality::Medium, None | Some(S::Square) | Some(S::SquareHd)) => 6,
-    (FalGptImage2Quality::Medium, Some(S::Landscape4x3) | Some(S::Portrait4x3)) => 4,
-    (FalGptImage2Quality::Medium, Some(S::Landscape16x9) | Some(S::Portrait16x9)) => 4,
-    (FalGptImage2Quality::Medium, Some(S::Auto)) => 6, // TODO: Not checked
-
-    // High quality
-    (FalGptImage2Quality::High, None | Some(S::Square)) => 22,
-    (FalGptImage2Quality::High, Some(S::SquareHd)) => 23,
-    (FalGptImage2Quality::High, Some(S::Landscape4x3) | Some(S::Portrait4x3)) => 15,
-    (FalGptImage2Quality::High, Some(S::Landscape16x9) | Some(S::Portrait16x9)) => 16,
-    (FalGptImage2Quality::High, Some(S::Auto)) => 23, // TODO: Not checked
-  };
-  let cost_in_usd_cents = cost_per_image * plan.num_images.as_u64();
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use super::*;
-  use crate::generate::generate_image::plan::fal::plan_generate_image_fal_gpt_image_2::FalGptImage2NumImages;
-
-  fn plan(
-    quality: FalGptImage2Quality,
-    image_size: Option<FalGptImage2ImageSize>,
-    num_images: FalGptImage2NumImages,
-  ) -> PlanFalGptImage2 {
-    PlanFalGptImage2 {
-      prompt: Some("p".to_string()),
-      image_urls: vec![],
-      image_size,
-      quality,
-      num_images,
-    }
-  }
-
-  fn cents(
-    quality: FalGptImage2Quality,
-    image_size: Option<FalGptImage2ImageSize>,
-    num_images: FalGptImage2NumImages,
-  ) -> u64 {
-    estimate_image_cost_fal_gpt_image_2(&plan(quality, image_size, num_images))
-      .cost_in_usd_cents.unwrap()
-  }
-
-  // -- Low quality (1c for all sizes) -------------------------------------------
-
-  #[test]
-  fn low_square() {
-    assert_eq!(cents(FalGptImage2Quality::Low, Some(FalGptImage2ImageSize::Square), FalGptImage2NumImages::One), 1);
-  }
-
-  #[test]
-  fn low_square_hd() {
-    assert_eq!(cents(FalGptImage2Quality::Low, Some(FalGptImage2ImageSize::SquareHd), FalGptImage2NumImages::One), 1);
-  }
-
-  #[test]
-  fn low_unset() {
-    assert_eq!(cents(FalGptImage2Quality::Low, None, FalGptImage2NumImages::One), 1);
-  }
-
-  #[test]
-  fn low_landscape_4x3() {
-    assert_eq!(cents(FalGptImage2Quality::Low, Some(FalGptImage2ImageSize::Landscape4x3), FalGptImage2NumImages::One), 1);
-  }
-
-  #[test]
-  fn low_four() {
-    assert_eq!(cents(FalGptImage2Quality::Low, None, FalGptImage2NumImages::Four), 4);
-  }
-
-  // -- Medium quality -----------------------------------------------------------
-
-  #[test]
-  fn medium_square() {
-    assert_eq!(cents(FalGptImage2Quality::Medium, Some(FalGptImage2ImageSize::Square), FalGptImage2NumImages::One), 6);
-  }
-
-  #[test]
-  fn medium_square_hd() {
-    assert_eq!(cents(FalGptImage2Quality::Medium, Some(FalGptImage2ImageSize::SquareHd), FalGptImage2NumImages::One), 6);
-  }
-
-  #[test]
-  fn medium_unset() {
-    assert_eq!(cents(FalGptImage2Quality::Medium, None, FalGptImage2NumImages::One), 6);
-  }
-
-  #[test]
-  fn medium_landscape_4x3() {
-    assert_eq!(cents(FalGptImage2Quality::Medium, Some(FalGptImage2ImageSize::Landscape4x3), FalGptImage2NumImages::One), 4);
-  }
-
-  #[test]
-  fn medium_portrait_4x3() {
-    assert_eq!(cents(FalGptImage2Quality::Medium, Some(FalGptImage2ImageSize::Portrait4x3), FalGptImage2NumImages::One), 4);
-  }
-
-  #[test]
-  fn medium_landscape_16x9() {
-    assert_eq!(cents(FalGptImage2Quality::Medium, Some(FalGptImage2ImageSize::Landscape16x9), FalGptImage2NumImages::One), 4);
-  }
-
-  #[test]
-  fn medium_portrait_16x9() {
-    assert_eq!(cents(FalGptImage2Quality::Medium, Some(FalGptImage2ImageSize::Portrait16x9), FalGptImage2NumImages::One), 4);
-  }
-
-  #[test]
-  fn medium_square_four() {
-    assert_eq!(cents(FalGptImage2Quality::Medium, Some(FalGptImage2ImageSize::Square), FalGptImage2NumImages::Four), 24);
-  }
-
-  // -- High quality -------------------------------------------------------------
-
-  #[test]
-  fn high_square() {
-    assert_eq!(cents(FalGptImage2Quality::High, Some(FalGptImage2ImageSize::Square), FalGptImage2NumImages::One), 22);
-  }
-
-  #[test]
-  fn high_square_hd() {
-    assert_eq!(cents(FalGptImage2Quality::High, Some(FalGptImage2ImageSize::SquareHd), FalGptImage2NumImages::One), 23);
-  }
-
-  #[test]
-  fn high_unset() {
-    assert_eq!(cents(FalGptImage2Quality::High, None, FalGptImage2NumImages::One), 22);
-  }
-
-  #[test]
-  fn high_landscape_4x3() {
-    assert_eq!(cents(FalGptImage2Quality::High, Some(FalGptImage2ImageSize::Landscape4x3), FalGptImage2NumImages::One), 15);
-  }
-
-  #[test]
-  fn high_portrait_4x3() {
-    assert_eq!(cents(FalGptImage2Quality::High, Some(FalGptImage2ImageSize::Portrait4x3), FalGptImage2NumImages::One), 15);
-  }
-
-  #[test]
-  fn high_landscape_16x9() {
-    assert_eq!(cents(FalGptImage2Quality::High, Some(FalGptImage2ImageSize::Landscape16x9), FalGptImage2NumImages::One), 16);
-  }
-
-  #[test]
-  fn high_portrait_16x9() {
-    assert_eq!(cents(FalGptImage2Quality::High, Some(FalGptImage2ImageSize::Portrait16x9), FalGptImage2NumImages::One), 16);
-  }
-
-  #[test]
-  fn high_square_four() {
-    assert_eq!(cents(FalGptImage2Quality::High, Some(FalGptImage2ImageSize::Square), FalGptImage2NumImages::Four), 88);
-  }
-
-  #[test]
-  fn high_square_hd_four() {
-    assert_eq!(cents(FalGptImage2Quality::High, Some(FalGptImage2ImageSize::SquareHd), FalGptImage2NumImages::Four), 92);
-  }
-
-  // -- Metadata flags -----------------------------------------------------------
-
-  #[test]
-  fn metadata_flags_are_default() {
-    let estimate = estimate_image_cost_fal_gpt_image_2(&plan(
-      FalGptImage2Quality::Medium, None, FalGptImage2NumImages::One,
-    ));
-    assert!(!estimate.is_free);
-    assert!(!estimate.is_unlimited);
-    assert!(!estimate.is_rate_limited);
-    assert!(!estimate.has_watermark);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/fal/estimate_image_cost_fal_nano_banana.rs

@@ -1,35 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::fal::plan_generate_image_fal_nano_banana::{
-  FalNbNumImages, PlanFalNanoBanana,
-};
-
-pub(crate) fn estimate_image_cost_fal_nano_banana(
-  plan: &PlanFalNanoBanana,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.039/image (no resolution multiplier — Gemini 25 Flash has no resolution option).
-  // Rounded to 4 cents per image.
-  //
-  // Fal docs:
-  //   Your request will cost $0.039 per image. For $1.00, you can run this model 25 times.
-  //
-  let cost_per_image: u64 = 4;
-
-  let num_images: u64 = match plan.num_images {
-    FalNbNumImages::One => 1,
-    FalNbNumImages::Two => 2,
-    FalNbNumImages::Three => 3,
-    FalNbNumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/fal/estimate_image_cost_fal_nano_banana_2.rs

@@ -1,45 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::fal::plan_generate_image_fal_nano_banana_2::{
-  FalNb2NumImages, FalNb2Resolution, PlanFalNanaBanana2,
-};
-
-pub(crate) fn estimate_image_cost_fal_nano_banana_2(
-  plan: &PlanFalNanaBanana2,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.08/image base (1K). Multipliers: 0.5K = 0.75x, 2K = 1.5x, 4K = 2x.
-  // (Stored as USD cents.)
-  //
-  // Fal docs:
-  //   Your request will cost $0.08 per image. For $1.00, you can run this model 12 times.
-  //   2K and 4K outputs will be charged at 1.5 times and 2 times the standard rate, respectively.
-  //   0.5K (512px) resolution outputs will be charged at 0.75 times the standard rate. If web
-  //   search is used, an additional $0.015 will be charged. If high thinking is used,
-  //   an additional $0.002 will be charged. Note: Pricing is subject to change.
-  //
-  let cost_per_image: u64 = match plan.resolution {
-    Some(FalNb2Resolution::HalfK) => 6,   // $0.06 = $0.08 * 0.75
-    Some(FalNb2Resolution::OneK) => 8,     // $0.08 base
-    Some(FalNb2Resolution::TwoK) => 12,    // $0.12 = $0.08 * 1.5
-    Some(FalNb2Resolution::FourK) => 16,   // $0.16 = $0.08 * 2.0
-    None => 8,                              // default = 1K base
-  };
-
-  let num_images: u64 = match plan.num_images {
-    FalNb2NumImages::One => 1,
-    FalNb2NumImages::Two => 2,
-    FalNb2NumImages::Three => 3,
-    FalNb2NumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/fal/estimate_image_cost_fal_nano_banana_pro.rs

@@ -1,83 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::fal::plan_generate_image_fal_nano_banana_pro::{
-  FalNbpNumImages, FalNbpResolution, PlanFalNanaBananaPro,
-};
-
-pub(crate) fn estimate_image_cost_fal_nano_banana_pro(
-  plan: &PlanFalNanaBananaPro,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.15/image at 1K or 2K resolution, $0.30/image at 4K.
-  // (Stored as USD cents.)
-  let cost_per_image: u64 = match plan.resolution {
-    Some(FalNbpResolution::FourK) => 30,
-    _ => 15,
-  };
-
-  let num_images: u64 = match plan.num_images {
-    FalNbpNumImages::One => 1,
-    FalNbpNumImages::Two => 2,
-    FalNbpNumImages::Three => 3,
-    FalNbpNumImages::Four => 4,
-  };
-
-  let cost_in_usd_cents = cost_per_image * num_images;
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_image_model::CommonImageModel;
-  use crate::api::common_resolution::CommonResolution;
-  use crate::api::provider::Provider;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-
-  fn estimate_usd_cents(resolution: Option<CommonResolution>, image_batch_count: u16) -> u64 {
-    let request = GenerateImageRequestBuilder {
-      model: CommonImageModel::NanoBananaPro,
-      provider: Provider::Fal,
-      prompt: None,
-      image_inputs: None,
-      resolution,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: Some(image_batch_count),
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    };
-    request.build()
-      .expect("build should succeed")
-      .estimate_costs()
-      .cost_in_usd_cents
-      .expect("cost_in_usd_cents should be present")
-  }
-
-  #[test]
-  fn test_estimate_cost_usd_cents() {
-    // 1K/2K: $0.15/image = 15 cents
-    assert_eq!(estimate_usd_cents(None, 1), 15);
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::OneK), 1), 15);
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::TwoK), 1), 15);
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::OneK), 2), 30);
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::OneK), 3), 45);
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::OneK), 4), 60);
-
-    // 4K: $0.30/image = 30 cents
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::FourK), 1), 30);
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::FourK), 2), 60);
-    assert_eq!(estimate_usd_cents(Some(CommonResolution::FourK), 4), 120);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/fal/estimate_image_cost_fal_seedream_4.rs

@@ -1,20 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::fal::plan_generate_image_fal_seedream_4::PlanFalSeedream4;
-
-pub(crate) fn estimate_image_cost_fal_seedream_4(
-  plan: &PlanFalSeedream4,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.03 per image.
-  let cost_per_image: u64 = 3;
-  let cost_in_usd_cents = cost_per_image * plan.num_images.as_u64();
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/fal/estimate_image_cost_fal_seedream_4p5.rs

@@ -1,20 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::fal::plan_generate_image_fal_seedream_4p5::PlanFalSeedream4p5;
-
-pub(crate) fn estimate_image_cost_fal_seedream_4p5(
-  plan: &PlanFalSeedream4p5,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.04 per image.
-  let cost_per_image: u64 = 4;
-  let cost_in_usd_cents = cost_per_image * plan.num_images.as_u64();
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/fal/estimate_image_cost_fal_seedream_5_lite.rs

@@ -1,20 +0,0 @@
-use crate::generate::generate_image::image_generation_cost_estimate::ImageGenerationCostEstimate;
-use crate::generate::generate_image::plan::fal::plan_generate_image_fal_seedream_5_lite::PlanFalSeedream5Lite;
-
-pub(crate) fn estimate_image_cost_fal_seedream_5_lite(
-  plan: &PlanFalSeedream5Lite,
-) -> ImageGenerationCostEstimate {
-  // Pricing: $0.035 per image — round up to 4 cents.
-  let cost_per_image: u64 = 4;
-  let cost_in_usd_cents = cost_per_image * plan.num_images.as_u64();
-
-  ImageGenerationCostEstimate {
-    cost_in_credits: Some(cost_in_usd_cents),
-    cost_in_usd_cents: Some(cost_in_usd_cents),
-    is_free: false,
-    is_unlimited: false,
-    is_rate_limited: false,
-    has_watermark: false,
-    failures_are_refunded: None,
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/fal/mod.rs

@@ -1,13 +0,0 @@
-pub(crate) mod estimate_image_cost_fal_flux_1_dev;
-pub(crate) mod estimate_image_cost_fal_flux_1_schnell;
-pub(crate) mod estimate_image_cost_fal_flux_pro_1p1;
-pub(crate) mod estimate_image_cost_fal_flux_pro_1p1_ultra;
-pub(crate) mod estimate_image_cost_fal_gpt_image_1;
-pub(crate) mod estimate_image_cost_fal_gpt_image_1p5;
-pub(crate) mod estimate_image_cost_fal_gpt_image_2;
-pub(crate) mod estimate_image_cost_fal_seedream_4;
-pub(crate) mod estimate_image_cost_fal_seedream_4p5;
-pub(crate) mod estimate_image_cost_fal_seedream_5_lite;
-pub(crate) mod estimate_image_cost_fal_nano_banana;
-pub(crate) mod estimate_image_cost_fal_nano_banana_2;
-pub(crate) mod estimate_image_cost_fal_nano_banana_pro;

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/cost/mod.rs

@@ -1,2 +0,0 @@
-pub(crate) mod artcraft;
-pub(crate) mod fal;

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/execute/artcraft/generate_image_artcraft_flux_1_dev.rs

@@ -1,119 +0,0 @@
-use crate::client::router_artcraft_client::RouterArtcraftClient;
-use crate::errors::artcraft_router_error::ArtcraftRouterError;
-use crate::errors::provider_error::ProviderError;
-use crate::generate::generate_image::generate_image_response::{
-  ArtcraftImageResponsePayload, GenerateImageResponse,
-};
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_flux_1_dev::PlanArtcraftFlux1Dev;
-use artcraft_api_defs::generate::image::text::generate_flux_1_dev_text_to_image::GenerateFlux1DevTextToImageRequest;
-use artcraft_client::endpoints::generate::image::text::generate_flux_1_dev_text_to_image::generate_flux_1_dev_text_to_image;
-
-pub async fn execute_artcraft_flux_1_dev(
-  plan: &PlanArtcraftFlux1Dev,
-  artcraft_client: &RouterArtcraftClient,
-) -> Result<GenerateImageResponse, ArtcraftRouterError> {
-  let request = GenerateFlux1DevTextToImageRequest {
-    uuid_idempotency_token: plan.idempotency_token.clone(),
-    prompt: plan.prompt.clone(),
-    aspect_ratio: plan.aspect_ratio,
-    num_images: Some(plan.num_images),
-  };
-
-  let response = generate_flux_1_dev_text_to_image(
-    &artcraft_client.api_host,
-    Some(&artcraft_client.credentials),
-    request,
-  )
-    .await
-    .map_err(|err| ArtcraftRouterError::Provider(ProviderError::Storyteller(err)))?;
-
-  Ok(GenerateImageResponse::Artcraft(ArtcraftImageResponsePayload {
-    inference_job_token: response.inference_job_token,
-  }))
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_aspect_ratio::CommonAspectRatio;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use crate::generate::generate_image::image_generation_plan::ImageGenerationPlan;
-  use crate::test_helpers::{base_flux_1_dev_image_request, get_artcraft_client};
-  use strum::IntoEnumIterator;
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_flux_1_dev() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::WideSixteenByNine),
-      quality: None,
-      image_batch_count: Some(1),
-      prompt: Some("a cat walking through a cyberpunk city at night".to_string()),
-      ..base_flux_1_dev_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_flux_1_dev_batch_four() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::Square),
-      quality: None,
-      image_batch_count: Some(4),
-      prompt: Some("a dog surfing a wave, cinematic".to_string()),
-      ..base_flux_1_dev_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires one real API request per aspect ratio variant (expensive)
-  async fn test_text_to_image_flux_1_dev_all_aspect_ratios() {
-    let client = get_artcraft_client();
-
-    for ar in CommonAspectRatio::iter() {
-      println!("--- text-to-image aspect ratio: {:?} ---", ar);
-      let request = GenerateImageRequestBuilder {
-        aspect_ratio: Some(ar),
-        quality: None,
-        image_batch_count: Some(1),
-        prompt: Some("a bear walking through an abandoned desert city at night".to_string()),
-        request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::PayMoreUpgrade,
-        ..base_flux_1_dev_image_request()
-      };
-      match request.build() {
-        Err(e) => println!("  plan error: {:?}", e),
-        Ok(plan) => match plan.generate_image(&client).await {
-          Ok(response) => {
-            let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-            println!("  job token: {:?}", payload.inference_job_token);
-          }
-          Err(e) => println!("  generate error: {:?}", e),
-        },
-      }
-    }
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the responses above.
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/execute/artcraft/generate_image_artcraft_flux_1_schnell.rs

@@ -1,118 +0,0 @@
-use crate::client::router_artcraft_client::RouterArtcraftClient;
-use crate::errors::artcraft_router_error::ArtcraftRouterError;
-use crate::errors::provider_error::ProviderError;
-use crate::generate::generate_image::generate_image_response::{
-  ArtcraftImageResponsePayload, GenerateImageResponse,
-};
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_flux_1_schnell::PlanArtcraftFlux1Schnell;
-use artcraft_api_defs::generate::image::text::generate_flux_1_schnell_text_to_image::GenerateFlux1SchnellTextToImageRequest;
-use artcraft_client::endpoints::generate::image::text::generate_flux_1_schnell_text_to_image::generate_flux_1_schnell_text_to_image;
-
-pub async fn execute_artcraft_flux_1_schnell(
-  plan: &PlanArtcraftFlux1Schnell,
-  artcraft_client: &RouterArtcraftClient,
-) -> Result<GenerateImageResponse, ArtcraftRouterError> {
-  let request = GenerateFlux1SchnellTextToImageRequest {
-    uuid_idempotency_token: plan.idempotency_token.clone(),
-    prompt: plan.prompt.clone(),
-    aspect_ratio: plan.aspect_ratio,
-    num_images: Some(plan.num_images),
-  };
-
-  let response = generate_flux_1_schnell_text_to_image(
-    &artcraft_client.api_host,
-    Some(&artcraft_client.credentials),
-    request,
-  )
-    .await
-    .map_err(|err| ArtcraftRouterError::Provider(ProviderError::Storyteller(err)))?;
-
-  Ok(GenerateImageResponse::Artcraft(ArtcraftImageResponsePayload {
-    inference_job_token: response.inference_job_token,
-  }))
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_aspect_ratio::CommonAspectRatio;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use crate::test_helpers::{base_flux_1_schnell_image_request, get_artcraft_client};
-  use strum::IntoEnumIterator;
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_flux_1_schnell() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::WideSixteenByNine),
-      quality: None,
-      image_batch_count: Some(1),
-      prompt: Some("a man and woman walking through a cyberpunk city at night".to_string()),
-      ..base_flux_1_schnell_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_flux_1_schnell_batch_four() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::Square),
-      quality: None,
-      image_batch_count: Some(4),
-      prompt: Some("a dog surfing a wave, cinematic".to_string()),
-      ..base_flux_1_schnell_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires one real API request per aspect ratio variant (expensive)
-  async fn test_text_to_image_flux_1_schnell_all_aspect_ratios() {
-    let client = get_artcraft_client();
-
-    for ar in CommonAspectRatio::iter() {
-      println!("--- text-to-image aspect ratio: {:?} ---", ar);
-      let request = GenerateImageRequestBuilder {
-        aspect_ratio: Some(ar),
-        quality: None,
-        image_batch_count: Some(1),
-        prompt: Some("a man and woman walking through a futuristic city at evening".to_string()),
-        request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::PayMoreUpgrade,
-        ..base_flux_1_schnell_image_request()
-      };
-      match request.build() {
-        Err(e) => println!("  plan error: {:?}", e),
-        Ok(plan) => match plan.generate_image(&client).await {
-          Ok(response) => {
-            let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-            println!("  job token: {:?}", payload.inference_job_token);
-          }
-          Err(e) => println!("  generate error: {:?}", e),
-        },
-      }
-    }
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the responses above.
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/execute/artcraft/generate_image_artcraft_flux_2_lora_angles.rs

@@ -1,73 +0,0 @@
-use crate::client::router_artcraft_client::RouterArtcraftClient;
-use crate::errors::artcraft_router_error::ArtcraftRouterError;
-use crate::errors::provider_error::ProviderError;
-use crate::generate::generate_image::generate_image_response::{
-  ArtcraftImageResponsePayload, GenerateImageResponse,
-};
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_flux_2_lora_angles::PlanArtcraftFlux2LoraAngles;
-use artcraft_api_defs::generate::image::angle::flux_2_lora_edit_image_angle::Flux2LoraEditImageAngleRequest;
-use artcraft_client::endpoints::generate::image::angle::flux_2_lora_edit_image_angle::flux_2_lora_edit_image_angle;
-
-pub async fn execute_artcraft_flux_2_lora_angles(
-  plan: &PlanArtcraftFlux2LoraAngles,
-  artcraft_client: &RouterArtcraftClient,
-) -> Result<GenerateImageResponse, ArtcraftRouterError> {
-  let request = Flux2LoraEditImageAngleRequest {
-    uuid_idempotency_token: plan.idempotency_token.clone(),
-    image_media_token: plan.image_input.clone(),
-    horizontal_angle: plan.horizontal_angle,
-    vertical_angle: plan.vertical_angle,
-    zoom: plan.zoom,
-    num_images: Some(plan.num_images),
-    image_size: plan.image_size,
-  };
-
-  let response = flux_2_lora_edit_image_angle(
-    &artcraft_client.api_host,
-    Some(&artcraft_client.credentials),
-    request,
-  )
-    .await
-    .map_err(|err| ArtcraftRouterError::Provider(ProviderError::Storyteller(err)))?;
-
-  Ok(GenerateImageResponse::Artcraft(ArtcraftImageResponsePayload {
-    inference_job_token: response.inference_job_token,
-  }))
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_aspect_ratio::CommonAspectRatio;
-  use crate::api::image_list_ref::ImageListRef;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use crate::generate::generate_image::image_generation_plan::ImageGenerationPlan;
-  use crate::test_helpers::{base_flux_2_lora_angles_image_request, get_artcraft_client};
-  use tokens::tokens::media_files::MediaFileToken;
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_angle_edit_flux_2_lora() {
-    let client = get_artcraft_client();
-    let tokens = vec![MediaFileToken::new_from_str("m_r45apt2swza6wp8j2z10237t92kkr8")];
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::SquareHd),
-      quality: None,
-      image_batch_count: Some(1),
-      image_inputs: Some(ImageListRef::MediaFileTokens(tokens.clone())),
-      horizontal_angle: Some(30.0),
-      vertical_angle: Some(0.0),
-      zoom: Some(1.0),
-      ..base_flux_2_lora_angles_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/execute/artcraft/generate_image_artcraft_flux_pro_1p1.rs

@@ -1,119 +0,0 @@
-use crate::client::router_artcraft_client::RouterArtcraftClient;
-use crate::errors::artcraft_router_error::ArtcraftRouterError;
-use crate::errors::provider_error::ProviderError;
-use crate::generate::generate_image::generate_image_response::{
-  ArtcraftImageResponsePayload, GenerateImageResponse,
-};
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_flux_pro_1p1::PlanArtcraftFluxPro11;
-use artcraft_api_defs::generate::image::text::generate_flux_pro_11_text_to_image::GenerateFluxPro11TextToImageRequest;
-use artcraft_client::endpoints::generate::image::text::generate_flux_pro_11_text_to_image::generate_flux_pro_11_text_to_image;
-
-pub async fn execute_artcraft_flux_pro_1p1(
-  plan: &PlanArtcraftFluxPro11,
-  artcraft_client: &RouterArtcraftClient,
-) -> Result<GenerateImageResponse, ArtcraftRouterError> {
-  let request = GenerateFluxPro11TextToImageRequest {
-    uuid_idempotency_token: plan.idempotency_token.clone(),
-    prompt: plan.prompt.clone(),
-    aspect_ratio: plan.aspect_ratio,
-    num_images: Some(plan.num_images),
-  };
-
-  let response = generate_flux_pro_11_text_to_image(
-    &artcraft_client.api_host,
-    Some(&artcraft_client.credentials),
-    request,
-  )
-    .await
-    .map_err(|err| ArtcraftRouterError::Provider(ProviderError::Storyteller(err)))?;
-
-  Ok(GenerateImageResponse::Artcraft(ArtcraftImageResponsePayload {
-    inference_job_token: response.inference_job_token,
-  }))
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_aspect_ratio::CommonAspectRatio;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use crate::generate::generate_image::image_generation_plan::ImageGenerationPlan;
-  use crate::test_helpers::{base_flux_pro_1p1_image_request, get_artcraft_client};
-  use strum::IntoEnumIterator;
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_flux_pro_1p1() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::WideSixteenByNine),
-      quality: None,
-      image_batch_count: Some(1),
-      prompt: Some("a cat walking through a cyberpunk city at night".to_string()),
-      ..base_flux_pro_1p1_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_flux_pro_1p1_batch_four() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::Square),
-      quality: None,
-      image_batch_count: Some(4),
-      prompt: Some("a dog surfing a wave, cinematic".to_string()),
-      ..base_flux_pro_1p1_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires one real API request per aspect ratio variant (expensive)
-  async fn test_text_to_image_flux_pro_1p1_all_aspect_ratios() {
-    let client = get_artcraft_client();
-
-    for ar in CommonAspectRatio::iter() {
-      println!("--- text-to-image aspect ratio: {:?} ---", ar);
-      let request = GenerateImageRequestBuilder {
-        aspect_ratio: Some(ar),
-        quality: None,
-        image_batch_count: Some(1),
-        prompt: Some("a bear walking through an abandoned desert city at night".to_string()),
-        request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::PayMoreUpgrade,
-        ..base_flux_pro_1p1_image_request()
-      };
-      match request.build() {
-        Err(e) => println!("  plan error: {:?}", e),
-        Ok(plan) => match plan.generate_image(&client).await {
-          Ok(response) => {
-            let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-            println!("  job token: {:?}", payload.inference_job_token);
-          }
-          Err(e) => println!("  generate error: {:?}", e),
-        },
-      }
-    }
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the responses above.
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/execute/artcraft/generate_image_artcraft_flux_pro_1p1_ultra.rs

@@ -1,119 +0,0 @@
-use crate::client::router_artcraft_client::RouterArtcraftClient;
-use crate::errors::artcraft_router_error::ArtcraftRouterError;
-use crate::errors::provider_error::ProviderError;
-use crate::generate::generate_image::generate_image_response::{
-  ArtcraftImageResponsePayload, GenerateImageResponse,
-};
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_flux_pro_1p1_ultra::PlanArtcraftFluxPro11Ultra;
-use artcraft_api_defs::generate::image::text::generate_flux_pro_11_ultra_text_to_image::GenerateFluxPro11UltraTextToImageRequest;
-use artcraft_client::endpoints::generate::image::text::generate_flux_pro_11_ultra_text_to_image::generate_flux_pro_11_ultra_text_to_image;
-
-pub async fn execute_artcraft_flux_pro_1p1_ultra(
-  plan: &PlanArtcraftFluxPro11Ultra,
-  artcraft_client: &RouterArtcraftClient,
-) -> Result<GenerateImageResponse, ArtcraftRouterError> {
-  let request = GenerateFluxPro11UltraTextToImageRequest {
-    uuid_idempotency_token: plan.idempotency_token.clone(),
-    prompt: plan.prompt.clone(),
-    aspect_ratio: plan.aspect_ratio,
-    num_images: Some(plan.num_images),
-  };
-
-  let response = generate_flux_pro_11_ultra_text_to_image(
-    &artcraft_client.api_host,
-    Some(&artcraft_client.credentials),
-    request,
-  )
-    .await
-    .map_err(|err| ArtcraftRouterError::Provider(ProviderError::Storyteller(err)))?;
-
-  Ok(GenerateImageResponse::Artcraft(ArtcraftImageResponsePayload {
-    inference_job_token: response.inference_job_token,
-  }))
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_aspect_ratio::CommonAspectRatio;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use crate::generate::generate_image::image_generation_plan::ImageGenerationPlan;
-  use crate::test_helpers::{base_flux_pro_1p1_ultra_image_request, get_artcraft_client};
-  use strum::IntoEnumIterator;
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_flux_pro_1p1_ultra() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::WideSixteenByNine),
-      quality: None,
-      image_batch_count: Some(1),
-      prompt: Some("a cat walking through a cyberpunk city at night".to_string()),
-      ..base_flux_pro_1p1_ultra_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_flux_pro_1p1_ultra_batch_four() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::Square),
-      quality: None,
-      image_batch_count: Some(4),
-      prompt: Some("a dog surfing a wave, cinematic".to_string()),
-      ..base_flux_pro_1p1_ultra_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires one real API request per aspect ratio variant (expensive)
-  async fn test_text_to_image_flux_pro_1p1_ultra_all_aspect_ratios() {
-    let client = get_artcraft_client();
-
-    for ar in CommonAspectRatio::iter() {
-      println!("--- text-to-image aspect ratio: {:?} ---", ar);
-      let request = GenerateImageRequestBuilder {
-        aspect_ratio: Some(ar),
-        quality: None,
-        image_batch_count: Some(1),
-        prompt: Some("a t-rex walking through an abandoned desert city at night".to_string()),
-        request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::PayMoreUpgrade,
-        ..base_flux_pro_1p1_ultra_image_request()
-      };
-      match request.build() {
-        Err(e) => println!("  plan error: {:?}", e),
-        Ok(plan) => match plan.generate_image(&client).await {
-          Ok(response) => {
-            let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-            println!("  job token: {:?}", payload.inference_job_token);
-          }
-          Err(e) => println!("  generate error: {:?}", e),
-        },
-      }
-    }
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the responses above.
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/execute/artcraft/generate_image_artcraft_gpt_image_1.rs

@@ -1,147 +0,0 @@
-use crate::client::router_artcraft_client::RouterArtcraftClient;
-use crate::errors::artcraft_router_error::ArtcraftRouterError;
-use crate::errors::provider_error::ProviderError;
-use crate::generate::generate_image::generate_image_response::{
-  ArtcraftImageResponsePayload, GenerateImageResponse,
-};
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_gpt_image_1::PlanArtcraftGptImage1;
-use artcraft_api_defs::generate::image::edit::gpt_image_1_edit_image::GptImage1EditImageRequest;
-use artcraft_api_defs::generate::image::text::generate_gpt_image_1_text_to_image::GenerateGptImage1TextToImageRequest;
-use artcraft_client::endpoints::generate::image::edit::gpt_image_1_edit_image::gpt_image_1_edit_image;
-use artcraft_client::endpoints::generate::image::text::generate_gpt_image_1_text_to_image::generate_gpt_image_1_text_to_image;
-
-/// GPT Image 1 has two distinct legacy storyteller-web endpoints (one for
-/// text-to-image, one for image-edit), so we dispatch on whether image refs
-/// are present rather than calling a single multi-function endpoint.
-pub async fn execute_artcraft_gpt_image_1(
-  plan: &PlanArtcraftGptImage1,
-  artcraft_client: &RouterArtcraftClient,
-) -> Result<GenerateImageResponse, ArtcraftRouterError> {
-  let inference_job_token = match plan.image_inputs.clone() {
-    Some(image_inputs) => {
-      let request = GptImage1EditImageRequest {
-        uuid_idempotency_token: plan.idempotency_token.clone(),
-        prompt: plan.prompt.clone(),
-        image_media_tokens: Some(image_inputs.to_owned()),
-        image_size: plan.image_size.map(|s| s.to_edit()),
-        num_images: Some(plan.num_images.to_edit()),
-        image_quality: Some(plan.quality.to_edit()),
-      };
-      let response = gpt_image_1_edit_image(
-        &artcraft_client.api_host,
-        Some(&artcraft_client.credentials),
-        request,
-      )
-      .await
-      .map_err(|err| ArtcraftRouterError::Provider(ProviderError::Storyteller(err)))?;
-      response.inference_job_token
-    }
-    None => {
-      let request = GenerateGptImage1TextToImageRequest {
-        uuid_idempotency_token: plan.idempotency_token.clone(),
-        prompt: plan.prompt.clone(),
-        image_size: plan.image_size.map(|s| s.to_t2i()),
-        num_images: Some(plan.num_images.to_t2i()),
-        image_quality: Some(plan.quality.to_t2i()),
-      };
-      let response = generate_gpt_image_1_text_to_image(
-        &artcraft_client.api_host,
-        Some(&artcraft_client.credentials),
-        request,
-      )
-      .await
-      .map_err(|err| ArtcraftRouterError::Provider(ProviderError::Storyteller(err)))?;
-      response.inference_job_token
-    }
-  };
-
-  Ok(GenerateImageResponse::Artcraft(ArtcraftImageResponsePayload {
-    inference_job_token,
-  }))
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_aspect_ratio::CommonAspectRatio;
-  use crate::api::image_list_ref::ImageListRef;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use crate::generate::generate_image::image_generation_plan::ImageGenerationPlan;
-  use crate::test_helpers::{base_gpt_image_1_image_request, get_artcraft_client};
-  use tokens::tokens::media_files::MediaFileToken;
-
-  // Build-only smoke test that exercises the full text-to-image plan path
-  // (no network I/O — we never call generate_image).
-  #[test]
-  fn build_text_to_image_plan_smoke() {
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::Square),
-      image_batch_count: Some(1),
-      ..base_gpt_image_1_image_request()
-    };
-    let plan = request.build().expect("plan should build");
-    assert!(matches!(plan, ImageGenerationPlan::ArtcraftGptImage1(_)));
-  }
-
-  // Build-only smoke test for the edit path. We can't actually fire the
-  // request without an authenticated client, but we want to make sure the
-  // dispatcher recognizes media-token inputs as edit-mode.
-  #[test]
-  fn build_edit_image_plan_smoke() {
-    let tokens = vec![MediaFileToken::new_from_str("mf_test00000000000000000000000000")];
-    let request = GenerateImageRequestBuilder {
-      image_inputs: Some(ImageListRef::MediaFileTokens(tokens.clone())),
-      ..base_gpt_image_1_image_request()
-    };
-    let plan = request.build().expect("plan should build");
-    let ImageGenerationPlan::ArtcraftGptImage1(plan) = plan else {
-      panic!("expected ArtcraftGptImage1")
-    };
-    assert!(plan.image_inputs.is_some(), "edit mode must carry image_inputs");
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_gpt_image_1() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::WideSixteenByNine),
-      image_batch_count: Some(1),
-      prompt: Some("a horse walking through a cyberpunk city at night".to_string()),
-      ..base_gpt_image_1_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_edit_image_gpt_image_1() {
-    let client = get_artcraft_client();
-
-    let image_tokens = vec![
-      MediaFileToken::new_from_str("m_r45apt2swza6wp8j2z10237t92kkr8"),
-    ];
-
-    let request = GenerateImageRequestBuilder {
-      prompt: Some("Change the background to a desert with cacti".to_string()),
-      image_inputs: Some(ImageListRef::MediaFileTokens(image_tokens.clone())),
-      aspect_ratio: Some(CommonAspectRatio::Square),
-      image_batch_count: Some(1),
-      ..base_gpt_image_1_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/execute/artcraft/generate_image_artcraft_gpt_image_1p5.rs

@@ -1,164 +0,0 @@
-use crate::client::router_artcraft_client::RouterArtcraftClient;
-use crate::errors::artcraft_router_error::ArtcraftRouterError;
-use crate::errors::provider_error::ProviderError;
-use crate::generate::generate_image::generate_image_response::{
-  ArtcraftImageResponsePayload, GenerateImageResponse,
-};
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_gpt_image_1p5::PlanArtcraftGptImage1p5;
-use artcraft_api_defs::generate::image::multi_function::gpt_image_1p5_multi_function_image_gen::GptImage1p5MultiFunctionImageGenRequest;
-use artcraft_client::endpoints::generate::image::multi_function::gpt_image_1p5_multi_function_image_gen_image::gpt_image_1p5_multi_function_image_gen;
-
-pub async fn execute_artcraft_gpt_image_1p5(
-  plan: &PlanArtcraftGptImage1p5,
-  artcraft_client: &RouterArtcraftClient,
-) -> Result<GenerateImageResponse, ArtcraftRouterError> {
-  let request = GptImage1p5MultiFunctionImageGenRequest {
-    uuid_idempotency_token: plan.idempotency_token.clone(),
-    prompt: plan.prompt.clone(),
-    image_media_tokens: plan.image_inputs.clone(),
-    mask_image_token: None,
-    num_images: Some(plan.num_images),
-    image_size: plan.image_size,
-    background: None,
-    quality: Some(plan.quality),
-    input_fidelity: None,
-    output_format: None,
-  };
-
-  let response = gpt_image_1p5_multi_function_image_gen(
-    &artcraft_client.api_host,
-    Some(&artcraft_client.credentials),
-    request,
-  )
-    .await
-    .map_err(|err| ArtcraftRouterError::Provider(ProviderError::Storyteller(err)))?;
-
-  Ok(GenerateImageResponse::Artcraft(ArtcraftImageResponsePayload {
-    inference_job_token: response.inference_job_token,
-  }))
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_aspect_ratio::CommonAspectRatio;
-  use crate::api::image_list_ref::ImageListRef;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use crate::generate::generate_image::image_generation_plan::ImageGenerationPlan;
-  use crate::test_helpers::{base_gpt_image_1p5_image_request, get_artcraft_client};
-  use strum::IntoEnumIterator;
-  use tokens::tokens::media_files::MediaFileToken;
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_gpt_image_1p5() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::WideSixteenByNine),
-      image_batch_count: Some(1),
-      prompt: Some("a horse walking through a cyberpunk city at night".to_string()),
-      ..base_gpt_image_1p5_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_edit_image_gpt_image_1p5() {
-    let client = get_artcraft_client();
-
-    let image_tokens = vec![
-      MediaFileToken::new_from_str("m_r45apt2swza6wp8j2z10237t92kkr8"),
-    ];
-
-    let request = GenerateImageRequestBuilder {
-      prompt: Some("Change the background to a desert with cacti".to_string()),
-      image_inputs: Some(ImageListRef::MediaFileTokens(image_tokens.clone())),
-      aspect_ratio: Some(CommonAspectRatio::Auto),
-      image_batch_count: Some(1),
-      ..base_gpt_image_1p5_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires one real API request per aspect ratio variant (expensive)
-  async fn test_text_to_image_gpt_image_1p5_all_aspect_ratios() {
-    let client = get_artcraft_client();
-
-    for ar in CommonAspectRatio::iter() {
-      println!("--- text-to-image aspect ratio: {:?} ---", ar);
-      let request = GenerateImageRequestBuilder {
-        aspect_ratio: Some(ar),
-        image_batch_count: Some(1),
-        prompt: Some("a bear walking through a abandoned desert city at night".to_string()),
-        request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::PayMoreUpgrade,
-        ..base_gpt_image_1p5_image_request()
-      };
-      match request.build() {
-        Err(e) => println!("  plan error: {:?}", e),
-        Ok(plan) => match plan.generate_image(&client).await {
-          Ok(response) => {
-            let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-            println!("  job token: {:?}", payload.inference_job_token);
-          }
-          Err(e) => println!("  generate error: {:?}", e),
-        },
-      }
-    }
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the responses above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires one real API request per aspect ratio variant (expensive)
-  async fn test_edit_image_gpt_image_1p5_all_aspect_ratios() {
-    let client = get_artcraft_client();
-
-    let image_tokens = vec![
-      MediaFileToken::new_from_str("m_r45apt2swza6wp8j2z10237t92kkr8"),
-    ];
-
-    for ar in CommonAspectRatio::iter() {
-      println!("--- image-edit aspect ratio: {:?} ---", ar);
-      let request = GenerateImageRequestBuilder {
-        prompt: Some("Change the background to an alien world".to_string()),
-        image_inputs: Some(ImageListRef::MediaFileTokens(image_tokens.clone())),
-        aspect_ratio: Some(ar),
-        image_batch_count: Some(1),
-        request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::PayMoreUpgrade,
-        ..base_gpt_image_1p5_image_request()
-      };
-      match request.build() {
-        Err(e) => println!("  plan error: {:?}", e),
-        Ok(plan) => match plan.generate_image(&client).await {
-          Ok(response) => {
-            let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-            println!("  job token: {:?}", payload.inference_job_token);
-          }
-          Err(e) => println!("  generate error: {:?}", e),
-        },
-      }
-    }
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the responses above.
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/execute/artcraft/generate_image_artcraft_gpt_image_2.rs

@@ -1,145 +0,0 @@
-use crate::client::router_artcraft_client::RouterArtcraftClient;
-use crate::errors::artcraft_router_error::ArtcraftRouterError;
-use crate::errors::provider_error::ProviderError;
-use crate::generate::generate_image::generate_image_response::{
-  ArtcraftImageResponsePayload, GenerateImageResponse,
-};
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_gpt_image_2::PlanArtcraftGptImage2;
-use artcraft_api_defs::omni_gen::cost_and_generate_requests::omni_gen_image_cost_and_generate_request::OmniGenImageCostAndGenerateRequest;
-use artcraft_client::endpoints::omni_gen::generate::image::omni_gen_image::omni_gen_image_generate;
-use enums::common::generation::common_image_model::CommonImageModel;
-
-/// Execute GPT Image 2 via the Artcraft omni-gen image endpoint.
-pub async fn execute_artcraft_gpt_image_2(
-  plan: &PlanArtcraftGptImage2,
-  artcraft_client: &RouterArtcraftClient,
-) -> Result<GenerateImageResponse, ArtcraftRouterError> {
-  let request = OmniGenImageCostAndGenerateRequest {
-    idempotency_token: Some(plan.idempotency_token.clone()),
-    model: Some(CommonImageModel::GptImage2),
-    prompt: plan.prompt.clone(),
-    image_media_tokens: plan.image_inputs.clone(),
-    resolution: None,
-    aspect_ratio: plan.aspect_ratio_enum(),
-    quality: Some(plan.quality_enum()),
-    image_batch_count: Some(plan.num_images_u16()),
-    adjust_horizontal_angle: None,
-    adjust_vertical_angle: None,
-    adjust_zoom: None,
-  };
-
-  let response = omni_gen_image_generate(
-    &artcraft_client.api_host,
-    Some(&artcraft_client.credentials),
-    request,
-  )
-    .await
-    .map_err(|err| ArtcraftRouterError::Provider(ProviderError::Storyteller(err)))?;
-
-  Ok(GenerateImageResponse::Artcraft(ArtcraftImageResponsePayload {
-    inference_job_token: response.inference_job_token,
-  }))
-}
-
-#[cfg(test)]
-mod tests {
-  use artcraft_client::utils::api_host::ApiHost;
-  use crate::api::common_aspect_ratio::CommonAspectRatio;
-  use crate::api::common_quality::CommonQuality;
-  use crate::api::image_list_ref::ImageListRef;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use crate::generate::generate_image::image_generation_plan::ImageGenerationPlan;
-  use crate::test_helpers::{get_artcraft_client, get_artcraft_client_for_env};
-  use tokens::tokens::media_files::MediaFileToken;
-
-  fn base_gpt_image_2_request() -> GenerateImageRequestBuilder {
-    GenerateImageRequestBuilder {
-      model: crate::api::common_image_model::CommonImageModel::GptImage2,
-      provider: crate::api::provider::Provider::Artcraft,
-      prompt: Some("a t-rex walking through a cyberpunk city at night".to_string()),
-      image_inputs: None,
-      resolution: None,
-      aspect_ratio: None,
-      quality: None,
-      image_batch_count: None,
-      request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::ErrorOut,
-      generation_mode_mismatch_strategy: None,
-      idempotency_token: None,
-      horizontal_angle: None,
-      vertical_angle: None,
-      zoom: None,
-    }
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_gpt_image_2() {
-    let client = get_artcraft_client_for_env(ApiHost::Localhost { port: 12345 });
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::WideSixteenByNine),
-      image_batch_count: Some(1),
-      ..base_gpt_image_2_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_edit_image_gpt_image_2() {
-    let client = get_artcraft_client();
-
-    let image_tokens = vec![
-      MediaFileToken::new_from_str("m_r45apt2swza6wp8j2z10237t92kkr8"),
-    ];
-
-    let request = GenerateImageRequestBuilder {
-      prompt: Some("Change the background to a desert with cacti".to_string()),
-      image_inputs: Some(ImageListRef::MediaFileTokens(image_tokens)),
-      aspect_ratio: Some(CommonAspectRatio::Auto),
-      image_batch_count: Some(1),
-      ..base_gpt_image_2_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_gpt_image_2_high_quality() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::Square),
-      quality: Some(CommonQuality::High),
-      image_batch_count: Some(1),
-      ..base_gpt_image_2_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/execute/artcraft/generate_image_artcraft_nano_banana.rs

@@ -1,163 +0,0 @@
-use crate::client::router_artcraft_client::RouterArtcraftClient;
-use crate::errors::artcraft_router_error::ArtcraftRouterError;
-use crate::errors::provider_error::ProviderError;
-use crate::generate::generate_image::generate_image_response::{
-  ArtcraftImageResponsePayload, GenerateImageResponse,
-};
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_nano_banana::PlanArtcraftNanaBanana;
-use artcraft_api_defs::generate::image::multi_function::nano_banana_multi_function_image_gen::NanoBananaMultiFunctionImageGenRequest;
-use artcraft_client::endpoints::generate::image::multi_function::nano_banana_multi_function_image_gen_image::nano_banana_multi_function_image_gen;
-
-pub async fn execute_artcraft_nano_banana(
-  plan: &PlanArtcraftNanaBanana,
-  artcraft_client: &RouterArtcraftClient,
-) -> Result<GenerateImageResponse, ArtcraftRouterError> {
-  let request = NanoBananaMultiFunctionImageGenRequest {
-    uuid_idempotency_token: plan.idempotency_token.clone(),
-    prompt: plan.prompt.clone(),
-    image_media_tokens: plan.image_inputs.clone(),
-    num_images: Some(plan.num_images),
-    aspect_ratio: plan.aspect_ratio,
-  };
-
-  let response = nano_banana_multi_function_image_gen(
-    &artcraft_client.api_host,
-    Some(&artcraft_client.credentials),
-    request,
-  )
-    .await
-    .map_err(|err| ArtcraftRouterError::Provider(ProviderError::Storyteller(err)))?;
-
-  Ok(GenerateImageResponse::Artcraft(ArtcraftImageResponsePayload {
-    inference_job_token: response.inference_job_token,
-  }))
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_aspect_ratio::CommonAspectRatio;
-  use crate::api::image_list_ref::ImageListRef;
-  use crate::client::request_mismatch_mitigation_strategy::RequestMismatchMitigationStrategy;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use crate::generate::generate_image::image_generation_plan::ImageGenerationPlan;
-  use crate::test_helpers::{base_nano_banana_image_request, get_artcraft_client};
-  use strum::IntoEnumIterator;
-  use tokens::tokens::media_files::MediaFileToken;
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_nano_banana() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::WideSixteenByNine),
-      quality: None,
-      image_batch_count: Some(1),
-      prompt: Some("a cat walking through a cyberpunk city at night".to_string()),
-      ..base_nano_banana_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_edit_image_nano_banana() {
-    let client = get_artcraft_client();
-
-    let image_tokens = vec![
-      MediaFileToken::new_from_str("m_r45apt2swza6wp8j2z10237t92kkr8"),
-    ];
-
-    let request = GenerateImageRequestBuilder {
-      prompt: Some("Change the background to a sunny beach".to_string()),
-      image_inputs: Some(ImageListRef::MediaFileTokens(image_tokens.clone())),
-      aspect_ratio: Some(CommonAspectRatio::Auto),
-      quality: None,
-      image_batch_count: Some(1),
-      ..base_nano_banana_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires one real API request per aspect ratio variant (expensive)
-  async fn test_text_to_image_nano_banana_all_aspect_ratios() {
-    let client = get_artcraft_client();
-
-    for ar in CommonAspectRatio::iter() {
-      println!("--- text-to-image aspect ratio: {:?} ---", ar);
-      let request = GenerateImageRequestBuilder {
-        aspect_ratio: Some(ar),
-        quality: None,
-        image_batch_count: Some(1),
-        prompt: Some("a shiba walking through a cyberpunk city at night".to_string()),
-        request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::PayMoreUpgrade,
-        ..base_nano_banana_image_request()
-      };
-      match request.build() {
-        Err(e) => println!("  plan error: {:?}", e),
-        Ok(plan) => match plan.generate_image(&client).await {
-          Ok(response) => {
-            let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-            println!("  job token: {:?}", payload.inference_job_token);
-          }
-          Err(e) => println!("  generate error: {:?}", e),
-        },
-      }
-    }
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the responses above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires one real API request per aspect ratio variant (expensive)
-  async fn test_edit_image_nano_banana_all_aspect_ratios() {
-    let client = get_artcraft_client();
-
-    let image_tokens = vec![
-      MediaFileToken::new_from_str("m_r45apt2swza6wp8j2z10237t92kkr8"),
-    ];
-
-    for ar in CommonAspectRatio::iter() {
-      println!("--- image-edit aspect ratio: {:?} ---", ar);
-      let request = GenerateImageRequestBuilder {
-        prompt: Some("Change the background to a sunny beach".to_string()),
-        image_inputs: Some(ImageListRef::MediaFileTokens(image_tokens.clone())),
-        aspect_ratio: Some(ar),
-        quality: None,
-        image_batch_count: Some(1),
-        request_mismatch_mitigation_strategy: RequestMismatchMitigationStrategy::PayMoreUpgrade,
-        ..base_nano_banana_image_request()
-      };
-      match request.build() {
-        Err(e) => println!("  plan error: {:?}", e),
-        Ok(plan) => match plan.generate_image(&client).await {
-          Ok(response) => {
-            let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-            println!("  job token: {:?}", payload.inference_job_token);
-          }
-          Err(e) => println!("  generate error: {:?}", e),
-        },
-      }
-    }
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the responses above.
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/execute/artcraft/generate_image_artcraft_nano_banana_2.rs

@@ -1,68 +0,0 @@
-use crate::client::router_artcraft_client::RouterArtcraftClient;
-use crate::errors::artcraft_router_error::ArtcraftRouterError;
-use crate::errors::provider_error::ProviderError;
-use crate::generate::generate_image::generate_image_response::{
-  ArtcraftImageResponsePayload, GenerateImageResponse,
-};
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_nano_banana_2::PlanArtcraftNanaBanana2;
-use artcraft_api_defs::generate::image::multi_function::nano_banana_2_multi_function_image_gen::NanaBanana2MultiFunctionImageGenRequest;
-use artcraft_client::endpoints::generate::image::multi_function::nano_banana_2_multi_function_image_gen_image::nano_banana_2_multi_function_image_gen;
-
-pub async fn execute_artcraft_nano_banana_2(
-  plan: &PlanArtcraftNanaBanana2,
-  artcraft_client: &RouterArtcraftClient,
-) -> Result<GenerateImageResponse, ArtcraftRouterError> {
-  let request = NanaBanana2MultiFunctionImageGenRequest {
-    uuid_idempotency_token: plan.idempotency_token.clone(),
-    prompt: plan.prompt.clone(),
-    image_media_tokens: plan.image_inputs.clone(),
-    num_images: Some(plan.num_images),
-    resolution: plan.resolution,
-    aspect_ratio: plan.aspect_ratio,
-  };
-
-  let response = nano_banana_2_multi_function_image_gen(
-    &artcraft_client.api_host,
-    Some(&artcraft_client.credentials),
-    request,
-  )
-    .await
-    .map_err(|err| ArtcraftRouterError::Provider(ProviderError::Storyteller(err)))?;
-
-  Ok(GenerateImageResponse::Artcraft(ArtcraftImageResponsePayload {
-    inference_job_token: response.inference_job_token,
-  }))
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_aspect_ratio::CommonAspectRatio;
-  use crate::api::common_resolution::CommonResolution;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use crate::generate::generate_image::image_generation_plan::ImageGenerationPlan;
-  use crate::test_helpers::{base_nano_banana_2_image_request, get_artcraft_client};
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_nano_banana_2() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::WideSixteenByNine),
-      resolution: Some(CommonResolution::OneK),
-      quality: None,
-      image_batch_count: Some(1),
-      prompt: Some("a cat walking through a cyberpunk city at night".to_string()),
-      ..base_nano_banana_2_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/execute/artcraft/generate_image_artcraft_nano_banana_pro.rs

@@ -1,126 +0,0 @@
-use crate::client::router_artcraft_client::RouterArtcraftClient;
-use crate::errors::artcraft_router_error::ArtcraftRouterError;
-use crate::errors::provider_error::ProviderError;
-use crate::generate::generate_image::generate_image_response::{
-  ArtcraftImageResponsePayload, GenerateImageResponse,
-};
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_nano_banana_pro::PlanArtcraftNanaBananaPro;
-use artcraft_api_defs::generate::image::multi_function::nano_banana_pro_multi_function_image_gen::NanoBananaProMultiFunctionImageGenRequest;
-use artcraft_client::endpoints::generate::image::multi_function::nano_banana_pro_multi_function_image_gen_image::nano_banana_pro_multi_function_image_gen;
-
-pub async fn execute_artcraft_nano_banana_pro(
-  plan: &PlanArtcraftNanaBananaPro,
-  artcraft_client: &RouterArtcraftClient,
-) -> Result<GenerateImageResponse, ArtcraftRouterError> {
-  let request = NanoBananaProMultiFunctionImageGenRequest {
-    uuid_idempotency_token: plan.idempotency_token.clone(),
-    prompt: plan.prompt.clone(),
-    image_media_tokens: plan.image_inputs.clone(),
-    num_images: Some(plan.num_images),
-    resolution: plan.resolution,
-    aspect_ratio: plan.aspect_ratio,
-  };
-
-  let response = nano_banana_pro_multi_function_image_gen(
-    &artcraft_client.api_host,
-    Some(&artcraft_client.credentials),
-    request,
-  )
-    .await
-    .map_err(|err| ArtcraftRouterError::Provider(ProviderError::Storyteller(err)))?;
-
-  Ok(GenerateImageResponse::Artcraft(ArtcraftImageResponsePayload {
-    inference_job_token: response.inference_job_token,
-  }))
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_aspect_ratio::CommonAspectRatio;
-  use crate::api::common_resolution::CommonResolution;
-  use crate::api::image_list_ref::ImageListRef;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use crate::generate::generate_image::image_generation_plan::ImageGenerationPlan;
-  use crate::test_helpers::{base_image_request, get_artcraft_client};
-  use tokens::tokens::media_files::MediaFileToken;
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_nano_banana_pro() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::WideSixteenByNine),
-      resolution: Some(CommonResolution::OneK),
-      quality: None,
-      image_batch_count: Some(1),
-      prompt: Some("a cat walking through a cyberpunk city at night".to_string()),
-      ..base_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_text_to_image_nano_banana_pro_batch_four() {
-    let client = get_artcraft_client();
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::Square),
-      resolution: Some(CommonResolution::OneK),
-      quality: None,
-      image_batch_count: Some(4),
-      prompt: Some("a dog surfing a wave, cinematic".to_string()),
-      ..base_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_edit_image_nano_banana_pro() {
-    let client = get_artcraft_client();
-
-    // Reference images: the man to transplant, then the destination scene.
-    let image_tokens = vec![
-      MediaFileToken::new_from_str("m_r45apt2swza6wp8j2z10237t92kkr8"),
-      MediaFileToken::new_from_str("m_2220d5we3masng5hvzg5zz68ywbdqd"),
-    ];
-
-    let request = GenerateImageRequestBuilder {
-      prompt: Some("Add the man in the first image into the fantasy scene in the second image. Keep his hoodie and attire, but match the vibe of the fantasy scene.".to_string()),
-      image_inputs: Some(ImageListRef::MediaFileTokens(image_tokens.clone())),
-      aspect_ratio: Some(CommonAspectRatio::Auto), // edit mode: preserve source dimensions
-      resolution: Some(CommonResolution::OneK),
-      quality: None,
-      image_batch_count: Some(1),
-      ..base_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-}

crates/api_clients/artcraft/artcraft_router/src/generate/generate_image/execute/artcraft/generate_image_artcraft_qwen_edit_2511_angles.rs

@@ -1,75 +0,0 @@
-use crate::client::router_artcraft_client::RouterArtcraftClient;
-use crate::errors::artcraft_router_error::ArtcraftRouterError;
-use crate::errors::provider_error::ProviderError;
-use crate::generate::generate_image::generate_image_response::{
-  ArtcraftImageResponsePayload, GenerateImageResponse,
-};
-use crate::generate::generate_image::plan::artcraft::plan_generate_image_artcraft_qwen_edit_2511_angles::PlanArtcraftQwenEdit2511Angles;
-use artcraft_api_defs::generate::image::angle::qwen_edit_2511_edit_image_angle::QwenEdit2511EditImageAngleRequest;
-use artcraft_client::endpoints::generate::image::angle::qwen_edit_2511_edit_image_angle::qwen_edit_2511_edit_image_angle;
-
-pub async fn execute_artcraft_qwen_edit_2511_angles(
-  plan: &PlanArtcraftQwenEdit2511Angles,
-  artcraft_client: &RouterArtcraftClient,
-) -> Result<GenerateImageResponse, ArtcraftRouterError> {
-  let request = QwenEdit2511EditImageAngleRequest {
-    uuid_idempotency_token: plan.idempotency_token.clone(),
-    image_media_token: plan.image_input.clone(),
-    horizontal_angle: plan.horizontal_angle,
-    vertical_angle: plan.vertical_angle,
-    zoom: plan.zoom,
-    additional_prompt: plan.prompt.clone(),
-    num_images: Some(plan.num_images),
-    image_size: plan.image_size,
-  };
-
-  let response = qwen_edit_2511_edit_image_angle(
-    &artcraft_client.api_host,
-    Some(&artcraft_client.credentials),
-    request,
-  )
-    .await
-    .map_err(|err| ArtcraftRouterError::Provider(ProviderError::Storyteller(err)))?;
-
-  Ok(GenerateImageResponse::Artcraft(ArtcraftImageResponsePayload {
-    inference_job_token: response.inference_job_token,
-  }))
-}
-
-#[cfg(test)]
-mod tests {
-  use crate::api::common_aspect_ratio::CommonAspectRatio;
-  use crate::api::image_list_ref::ImageListRef;
-  use crate::generate::generate_image::generate_image_request_builder::GenerateImageRequestBuilder;
-  use crate::generate::generate_image::image_generation_plan::ImageGenerationPlan;
-  use crate::test_helpers::{base_qwen_edit_2511_angles_image_request, get_artcraft_client};
-  use tokens::tokens::media_files::MediaFileToken;
-
-  #[tokio::test]
-  #[ignore] // manually run — fires a real API request and incurs cost
-  async fn test_angle_edit_qwen_edit_2511() {
-    let client = get_artcraft_client();
-    let tokens = vec![MediaFileToken::new_from_str("m_r45apt2swza6wp8j2z10237t92kkr8")];
-    let request = GenerateImageRequestBuilder {
-      aspect_ratio: Some(CommonAspectRatio::SquareHd),
-      quality: None,
-      image_batch_count: Some(1),
-      prompt: None,
-      image_inputs: Some(ImageListRef::MediaFileTokens(tokens.clone())),
-      horizontal_angle: Some(30.0),
-      vertical_angle: Some(0.0),
-      zoom: Some(1.0),
-      ..base_qwen_edit_2511_angles_image_request()
-    };
-
-    let plan = request.build().unwrap();
-    let result = plan.generate_image(&client).await;
-
-    println!("Result: {:?}", result);
-    let response = result.expect("generate_image request failed");
-    let payload = response.get_artcraft_payload().expect("expected Artcraft payload");
-    println!("Job token: {:?}", payload.inference_job_token);
-
-    assert_eq!(1, 2); // NB: Intentional failure to inspect the response above.
-  }
-}