PluginProbe
Templately – Elementor & Gutenberg Template Library: 6500+ Free & Pro Ready Templates And Cloud! / 3.7.3
Templately – Elementor & Gutenberg Template Library: 6500+ Free & Pro Ready Templates And Cloud! v3.7.3
3.7.5 3.7.4 3.7.3 3.7.2 1-final 3.7.1 3.7.0 3.6.8 3.6.7 3.6.6 3.6.5 3.6.4 3.6.3 3.6.2 3.6.1 3.0.3 3.0.4 3.0.5 3.0.6 3.0.7 3.0.8 3.0.9 3.1.0 3.1.1 3.1.10 All 111 releases
← All changes | includes/API/AIContent.php +721 -4 3.6.23.7.3 View file →
@@ -11,8 +11,9 @@
11 11
12 12 use Error;
13 13 use Exception;
14 14 use Templately\Utils\Helper;
15 +use Templately\Utils\Database;
15 16 use WP_REST_Request;
16 17 use WP_Error;
17 18 use Templately\Core\Importer\Utils\Utils;
18 19 use Templately\Core\Importer\Utils\AIUtils;
@@ -22,9 +23,22 @@
22 23 class AIContent extends API {
23 24 private $endpoint = 'ai-content';
24 25 private $dev_mode = false;
25 26
27 + /**
28 + * Short-lived cache of the `v2/chatbot/generated/{chat}` bundle.
29 + *
30 + * That payload is large (every generated page's block JSON, served off GCP)
31 + * and the direct-import handoff pulls it twice within seconds — once to read
32 + * the customization, once to write the pages. Only a COMPLETE bundle is ever
33 + * reused (an incomplete one has to be re-pulled to pick up new pages), and
34 + * the TTL is deliberately short so the `can_import` / already-imported gate
35 + * cannot go meaningfully stale.
36 + */
37 + const GENERATED_CACHE_KEY = 'chatbot_generated_';
38 + const GENERATED_CACHE_TTL = 60;
26 39
40 +
27 41 /**
28 42 * AIContent constructor.
29 43 *
30 44 * @param string $file File path.
@@ -42,12 +56,15 @@
42 56 $process_id = $this->get_param('process_id');
43 57
44 58 $_route = $request->get_route();
45 59 if ('/templately/v1/ai-content/ai-update' === $_route || '/templately/v1/ai-content/ai-update-preview' === $_route) {
46 - Helper::log( [
47 - 'headers' => $request->get_headers(),
48 - 'body' => $request->get_params(),
49 - ], 'ai_update_request' );
60 + // Disabled: the headers carry X-Templately-Apikey, and Helper::log()
61 + // writes to debug.log, which is web-readable on plenty of hosts. That
62 + // key authorizes this very route.
63 + // Helper::log( [
64 + // 'headers' => $request->get_headers(),
65 + // 'body' => $request->get_params(),
66 + // ], 'ai_update_request' );
50 67
51 68 if (empty($process_id)) {
52 69 return $this->error('invalid_id', __('Invalid ID.', 'templately'), 'calculate_credit', 400);
53 70 }
@@ -89,8 +106,59 @@
89 106 $this->post($this->endpoint . '/modify-content', [$this, 'modify_content']);
90 107 $this->post($this->endpoint . '/ai-update', [$this, 'ai_update']);
91 108 $this->post($this->endpoint . '/ai-update-preview', [$this, 'ai_update_preview']);
92 109 $this->post($this->endpoint . '/generate-tagline', [$this, 'generate_tagline']);
110 + $this->get($this->endpoint . '/chatbot-conversation', [$this, 'get_chatbot_conversation'], [
111 + 'chat' => [
112 + 'required' => true,
113 + 'sanitize_callback' => 'sanitize_text_field',
114 + 'validate_callback' => function($param, $request, $key) {
115 + return is_string($param) && strlen($param) > 0 && strlen($param) <= 128 && preg_match('/^[A-Za-z0-9\-_]+$/', $param);
116 + },
117 + ],
118 + ]);
119 + $this->get($this->endpoint . '/chatbot-conversations', [$this, 'get_chatbot_conversations'], [
120 + 'page' => [
121 + 'required' => false,
122 + 'default' => 1,
123 + // absint, not the sanitize_text_field default — that would turn the
124 + // int into a string and corrupt anything non-string.
125 + 'sanitize_callback' => 'absint',
126 + ],
127 + 'per_page' => [
128 + 'required' => false,
129 + 'default' => 10,
130 + 'sanitize_callback' => 'absint',
131 + ],
132 + ]);
133 + $this->get($this->endpoint . '/chatbot-generated', [$this, 'get_chatbot_generated'], [
134 + 'chat' => [
135 + 'required' => true,
136 + 'sanitize_callback' => 'sanitize_text_field',
137 + 'validate_callback' => function($param, $request, $key) {
138 + return is_string($param) && strlen($param) > 0 && strlen($param) <= 128 && preg_match('/^[A-Za-z0-9\-_]+$/', $param);
139 + },
140 + ],
141 + ]);
142 + $this->post($this->endpoint . '/chatbot-detected-info', [$this, 'update_chatbot_detected_info'], [
143 + 'chat' => [
144 + 'required' => true,
145 + 'sanitize_callback' => 'sanitize_text_field',
146 + 'validate_callback' => function($param, $request, $key) {
147 + return is_string($param) && strlen($param) > 0 && strlen($param) <= 128 && preg_match('/^[A-Za-z0-9\-_]+$/', $param);
148 + },
149 + ],
150 + ]);
151 + $this->post($this->endpoint . '/chatbot-import-prepare', [$this, 'chatbot_import_prepare']);
152 + $this->post($this->endpoint . '/chatbot-mark-imported', [$this, 'mark_chatbot_imported'], [
153 + 'chat' => [
154 + 'required' => true,
155 + 'sanitize_callback' => 'sanitize_text_field',
156 + 'validate_callback' => function($param, $request, $key) {
157 + return is_string($param) && strlen($param) > 0 && strlen($param) <= 128 && preg_match('/^[A-Za-z0-9\-_]+$/', $param);
158 + },
159 + ],
160 + ]);
93 161 $this->get($this->endpoint . '/attachments', [$this, 'get_attachments'], [
94 162 'type' => [
95 163 'default' => 'pack',
96 164 'required' => false,
@@ -933,8 +1001,657 @@
933 1001 }
934 1002
935 1003 // Return the response as-is
936 1004 return $data;
1005 + }
1006 +
1007 + /**
1008 + * Fetch a chatbot conversation by ID from the external Templately chatbot API.
1009 + *
1010 + * Used to resume a conversation that began on templately.dev when the user
1011 + * is redirected into the plugin with ?process=ai&chat={uuid}.
1012 + *
1013 + * @return array|\WP_Error Pass-through of the external response { status, data } or WP_Error.
1014 + */
1015 + public function get_chatbot_conversation() {
1016 + $chat = $this->get_param('chat');
1017 +
1018 + if (empty($chat)) {
1019 + return $this->error('invalid_chat_id', __('Invalid conversation ID.', 'templately'), 'ai-content/chatbot-conversation', 400);
1020 + }
1021 +
1022 + $extra_headers = [
1023 + 'Accept' => 'application/json',
1024 + ];
1025 + $response = Helper::make_api_get_request("v2/chatbot/conversation/{$chat}", [], $extra_headers, 30);
1026 +
1027 + if (is_wp_error($response)) {
1028 + return $this->error('request_failed', __('Failed to fetch conversation.', 'templately'), 'ai-content/chatbot-conversation', 500, ['error_detail' => $response->get_error_message()]);
1029 + }
1030 +
1031 + $response_code = wp_remote_retrieve_response_code($response);
1032 + $body = wp_remote_retrieve_body($response);
1033 + $data = json_decode($body, true);
1034 +
1035 + if ($response_code !== 200) {
1036 + $message = (is_array($data) && !empty($data['message'])) ? $data['message'] : sprintf(__('API returned HTTP %d error.', 'templately'), $response_code);
1037 + return $this->error('api_http_error', $message, 'ai-content/chatbot-conversation', $response_code);
1038 + }
1039 +
1040 + if (!is_array($data) || !isset($data['status'])) {
1041 + return $this->error('invalid_response', __('Invalid response.', 'templately'), 'ai-content/chatbot-conversation', 500);
1042 + }
1043 +
1044 + return $data;
1045 + }
1046 +
1047 + /**
1048 + * List the connected account's generated AI sites, newest first.
1049 + *
1050 + * Backs the "My AI Sites" screen, which exists so a user can re-import a
1051 + * generation at any time instead of having to keep its templately.com link.
1052 + *
1053 + * Each row carries `can_import` / `is_expired` / `is_pro` / `expires_at`,
1054 + * computed server-side (free accounts get 7 days from generation, entitled
1055 + * accounts import forever). Render those as given — recomputing the window
1056 + * here would silently drift from the backend the moment the rule changes.
1057 + *
1058 + * @return array|\WP_Error Pass-through of { status, current_page, total_page, total, data } or WP_Error.
1059 + */
1060 + public function get_chatbot_conversations() {
1061 + $page = max(1, (int) $this->get_param('page', 1, 'absint'));
1062 + $per_page = min(100, max(1, (int) $this->get_param('per_page', 10, 'absint')));
1063 +
1064 + $extra_headers = [
1065 + 'Accept' => 'application/json',
1066 + ];
1067 + $response = Helper::make_api_get_request('v2/chatbot/conversations', [
1068 + 'page' => $page,
1069 + 'per_page' => $per_page,
1070 + ], $extra_headers, 30);
1071 +
1072 + if (is_wp_error($response)) {
1073 + return $this->error('request_failed', __('Failed to fetch your AI sites.', 'templately'), 'ai-content/chatbot-conversations', 500, ['error_detail' => $response->get_error_message()]);
1074 + }
1075 +
1076 + $response_code = wp_remote_retrieve_response_code($response);
1077 + $body = wp_remote_retrieve_body($response);
1078 + $data = json_decode($body, true);
1079 +
1080 + if ($response_code !== 200) {
1081 + $message = (is_array($data) && !empty($data['message'])) ? $data['message'] : sprintf(__('API returned HTTP %d error.', 'templately'), $response_code);
1082 + return $this->error('api_http_error', $message, 'ai-content/chatbot-conversations', $response_code);
1083 + }
1084 +
1085 + if (!is_array($data) || !isset($data['status'])) {
1086 + return $this->error('invalid_response', __('Invalid response.', 'templately'), 'ai-content/chatbot-conversations', 500);
1087 + }
1088 +
1089 + return $data;
1090 + }
1091 +
1092 + /**
1093 + * Fetch the server-side generated content for a chatbot conversation (Phase 2).
1094 + *
1095 + * In Phase 2 the AI content is generated on the backend. This proxy mirrors
1096 + * {@see get_chatbot_conversation()} and returns the already-generated page
1097 + * content, customization data and signed logo URL so the plugin can run a
1098 + * thin import without triggering generation or the customizer locally.
1099 + *
1100 + * @return array|\WP_Error Pass-through of the external response { status, data } or WP_Error.
1101 + */
1102 + public function get_chatbot_generated() {
1103 + $chat = $this->get_param('chat');
1104 +
1105 + if (empty($chat)) {
1106 + return $this->error('invalid_chat_id', __('Invalid conversation ID.', 'templately'), 'ai-content/chatbot-generated', 400);
1107 + }
1108 +
1109 + $extra_headers = [
1110 + 'Accept' => 'application/json',
1111 + ];
1112 + $response = Helper::make_api_get_request("v2/chatbot/generated/{$chat}", [], $extra_headers, 30);
1113 +
1114 + if (is_wp_error($response)) {
1115 + return $this->error('request_failed', __('Failed to fetch generated content.', 'templately'), 'ai-content/chatbot-generated', 500, ['error_detail' => $response->get_error_message()]);
1116 + }
1117 +
1118 + $response_code = wp_remote_retrieve_response_code($response);
1119 + $body = wp_remote_retrieve_body($response);
1120 + $data = json_decode($body, true);
1121 +
1122 + if ($response_code !== 200) {
1123 + $message = (is_array($data) && !empty($data['message'])) ? $data['message'] : sprintf(__('API returned HTTP %d error.', 'templately'), $response_code);
1124 + return $this->error('api_http_error', $message, 'ai-content/chatbot-generated', $response_code);
1125 + }
1126 +
1127 + if (!is_array($data) || !isset($data['status'])) {
1128 + return $this->error('invalid_response', __('Invalid response.', 'templately'), 'ai-content/chatbot-generated', 500);
1129 + }
1130 +
1131 + // The direct-import handoff reads this endpoint and then immediately calls
1132 + // chatbot-import-prepare, which pulls the very same (large) bundle off GCP
1133 + // seconds later. Park it so prepare can reuse it instead of paying for a
1134 + // second identical transfer.
1135 + Database::set_transient(self::GENERATED_CACHE_KEY . $chat, $data, self::GENERATED_CACHE_TTL);
1136 +
1137 + return $data;
1138 + }
1139 +
1140 + /**
1141 + * Persist edited detected-info back to the chatbot conversation (Phase 2).
1142 + *
1143 + * Mirrors {@see get_chatbot_conversation()} / {@see get_chatbot_generated()}
1144 + * but forwards a POST. When the user edits the detected-info card in the
1145 + * sidebar, the plugin proxies the corrected values to the backend so a later
1146 + * replay reflects them. The backend route is gated by the X-Templately-Apikey
1147 + * header, so it is supplied explicitly here.
1148 + *
1149 + * Expected JSON body: { chat, detected_info: { ...fields } }
1150 + *
1151 + * @return array|\WP_Error Pass-through of the external response { status, data } or WP_Error.
1152 + */
1153 + public function update_chatbot_detected_info() {
1154 + $chat = $this->get_param('chat');
1155 + $detected_info = $this->get_param('detected_info', [], null);
1156 +
1157 + if (empty($chat)) {
1158 + return $this->error('invalid_chat_id', __('Invalid conversation ID.', 'templately'), 'ai-content/chatbot-detected-info', 400);
1159 + }
1160 +
1161 + // detected_info may arrive as a JSON string when sent via FormData.
1162 + if (is_string($detected_info)) {
1163 + $decoded = json_decode($detected_info, true);
1164 + $detected_info = is_array($decoded) ? $decoded : [];
1165 + }
1166 + if (!is_array($detected_info)) {
1167 + $detected_info = [];
1168 + }
1169 +
1170 + $extra_headers = [
1171 + 'Accept' => 'application/json',
1172 + 'X-Templately-Apikey' => $this->api_key,
1173 + ];
1174 + $response = Helper::make_api_post_request("v2/chatbot/conversation/{$chat}/detected-info", ['detected_info' => $detected_info], $extra_headers, 30);
1175 +
1176 + if (is_wp_error($response)) {
1177 + return $this->error('request_failed', __('Failed to update detected info.', 'templately'), 'ai-content/chatbot-detected-info', 500, ['error_detail' => $response->get_error_message()]);
1178 + }
1179 +
1180 + $response_code = wp_remote_retrieve_response_code($response);
1181 + $body = wp_remote_retrieve_body($response);
1182 + $data = json_decode($body, true);
1183 +
1184 + if ($response_code !== 200) {
1185 + $message = (is_array($data) && !empty($data['message'])) ? $data['message'] : sprintf(__('API returned HTTP %d error.', 'templately'), $response_code);
1186 + return $this->error('api_http_error', $message, 'ai-content/chatbot-detected-info', $response_code);
1187 + }
1188 +
1189 + if (!is_array($data) || !isset($data['status'])) {
1190 + return $this->error('invalid_response', __('Invalid response.', 'templately'), 'ai-content/chatbot-detected-info', 500);
1191 + }
1192 +
1193 + return $data;
1194 + }
1195 +
1196 + /**
1197 + * Report a completed import back to templately.dev (Phase 2 import-once gate).
1198 + *
1199 + * Once the plugin finishes importing the generated content for a conversation,
1200 + * it calls this so the backend flips the conversation status to `imported`.
1201 + * Subsequent pulls then return `already_imported = true`, and the web/plugin
1202 + * UIs refuse a second import.
1203 + *
1204 + * @return array|\WP_Error
1205 + */
1206 + public function mark_chatbot_imported() {
1207 + $chat = $this->get_param('chat');
1208 +
1209 + if (empty($chat)) {
1210 + return $this->error('invalid_chat_id', __('Invalid conversation ID.', 'templately'), 'ai-content/chatbot-mark-imported', 400);
1211 + }
1212 +
1213 + $extra_headers = [
1214 + 'Accept' => 'application/json',
1215 + 'X-Templately-Apikey' => $this->api_key,
1216 + ];
1217 + $response = Helper::make_api_post_request("v2/chatbot/conversation/{$chat}/imported", [], $extra_headers, 30);
1218 +
1219 + if (is_wp_error($response)) {
1220 + return $this->error('request_failed', __('Failed to record import.', 'templately'), 'ai-content/chatbot-mark-imported', 500, ['error_detail' => $response->get_error_message()]);
1221 + }
1222 +
1223 + $response_code = wp_remote_retrieve_response_code($response);
1224 + $body = wp_remote_retrieve_body($response);
1225 + $data = json_decode($body, true);
1226 +
1227 + if ($response_code !== 200) {
1228 + $message = (is_array($data) && !empty($data['message'])) ? $data['message'] : sprintf(__('API returned HTTP %d error.', 'templately'), $response_code);
1229 + return $this->error('api_http_error', $message, 'ai-content/chatbot-mark-imported', $response_code);
1230 + }
1231 +
1232 + if (!is_array($data) || !isset($data['status'])) {
1233 + return $this->error('invalid_response', __('Invalid response.', 'templately'), 'ai-content/chatbot-mark-imported', 500);
1234 + }
1235 +
1236 + return $data;
1237 + }
1238 +
1239 + /**
1240 + * Thin importer prepare step (Phase 2).
1241 + *
1242 + * Given a chat uuid and a session that has already been created and had its
1243 + * pack downloaded (via the existing templately_pack_create_session_and_download
1244 + * AJAX flow), this:
1245 + * 1. Registers AI process data (including `chat_id`) so ai_get_json()/
1246 + * validation keep working AND so the Finalizer's ChatAIContentProvider
1247 + * can claim this process.
1248 + * 2. Fetches the backend-generated page content for the conversation.
1249 + * 3. Writes whatever pages are ALREADY generated to the same .ai.json
1250 + * location the legacy flow uses (via AIUtils::save_template_to_file).
1251 + * 4. Downloads the signed logo URL into the WP media library (Utils::upload_logo).
1252 + *
1253 + * This endpoint NEVER waits for generation to complete. Pages still being
1254 + * generated are reported in `missing` and are pulled on demand — and waited
1255 + * for — by the Finalizer via AIContentResolver. Previously this held the
1256 + * client in a 3s poll loop until every page was ready, which delayed the
1257 + * start of the import by minutes for no benefit.
1258 + *
1259 + * It returns the resolved customization data, logo attachment and the
1260 + * process_id so the React app can build the settings FormData and run the
1261 + * existing import. No generation or local customizer is involved.
1262 + *
1263 + * Expected JSON body: { chat, session_id, ai_page_ids: { 'content/page': [...], templates: [...] } }
1264 + *
1265 + * @return array|\WP_Error
1266 + */
1267 + /**
1268 + * Does a `v2/chatbot/generated` bundle already carry every expected page?
1269 + *
1270 + * A page counts as present when it is in `templates` (string or int key, the
1271 + * upstream is inconsistent) or listed in `skipped_pages` — a skipped page is
1272 + * never coming, so waiting on it would hang the poll until it timed out.
1273 + *
1274 + * @param array $data Decoded `{ status, data }` bundle.
1275 + * @param array $expected_ids Flattened page ids, as strings.
1276 + * @return bool
1277 + */
1278 + private function is_generated_bundle_complete($data, $expected_ids) {
1279 + $generated = isset($data['data']) && is_array($data['data']) ? $data['data'] : [];
1280 +
1281 + // Never reuse a bundle the user is no longer allowed to import.
1282 + if (isset($generated['can_import']) && ! $generated['can_import']) {
1283 + return false;
1284 + }
1285 +
1286 + $templates = isset($generated['templates']) && is_array($generated['templates']) ? $generated['templates'] : [];
1287 + $skipped = isset($generated['skipped_pages']) && is_array($generated['skipped_pages']) ? array_map('strval', $generated['skipped_pages']) : [];
1288 +
1289 + if (empty($templates) && empty($skipped)) {
1290 + return false;
1291 + }
1292 +
1293 + foreach ($expected_ids as $id) {
1294 + if (array_key_exists($id, $templates) || array_key_exists((int) $id, $templates) || in_array($id, $skipped, true)) {
1295 + continue;
1296 + }
1297 + return false;
1298 + }
1299 +
1300 + return true;
1301 + }
1302 +
1303 + /**
1304 + * Resolve the conversation answers to store on a chat-driven process.
1305 + *
1306 + * Prefers what the client sent (the sidebar holds the detected info the user
1307 + * may have just edited), then what was already stored for this process (so a
1308 + * repeat call costs nothing), and only then pulls the conversation from the
1309 + * cloud — which is the path the `?process=import` landing takes, since it
1310 + * never opens the sidebar and so has no answers to send.
1311 + *
1312 + * A failure here must never break the import: it returns an empty array and
1313 + * the process is stored exactly as before.
1314 + *
1315 + * @param string $chat Conversation uuid.
1316 + * @param mixed $detected_info Raw `detected_info` sent by the client.
1317 + * @param array $ai_process_data All stored process data.
1318 + * @param string $process_id This process id.
1319 + * @return array<string,string> Map of conversation step key => value.
1320 + */
1321 + private function resolve_chat_conversation_fields($chat, $detected_info, $ai_process_data, $process_id) {
1322 + $mapped = AIUtils::map_chat_detected_info($detected_info);
1323 + if (!empty($mapped)) {
1324 + return $mapped;
1325 + }
1326 +
1327 + // Already resolved on an earlier call for this process — reuse it.
1328 + if (isset($ai_process_data[$process_id]) && AIUtils::has_conversation_data($ai_process_data[$process_id])) {
1329 + return AIUtils::map_chat_detected_info(
1330 + array_intersect_key($ai_process_data[$process_id], array_flip(AIUtils::CONVERSATION_FIELDS))
1331 + );
1332 + }
1333 +
1334 + $response = Helper::make_api_get_request("v2/chatbot/conversation/{$chat}", [], ['Accept' => 'application/json'], 30);
1335 + if (is_wp_error($response) || wp_remote_retrieve_response_code($response) !== 200) {
1336 + Helper::log(sprintf('chatbot_import_prepare[%s] conversation fetch failed — process stored without answers', $chat), 'ai-import', 'warning');
1337 + return [];
1338 + }
1339 +
1340 + $data = json_decode(wp_remote_retrieve_body($response), true);
1341 + if (!is_array($data) || empty($data['data']['detected_info'])) {
1342 + return [];
1343 + }
1344 +
1345 + return AIUtils::map_chat_detected_info($data['data']['detected_info']);
1346 + }
1347 +
1348 + public function chatbot_import_prepare() {
1349 + add_filter('wp_redirect', '__return_false', 999);
1350 + set_time_limit(3 * MINUTE_IN_SECONDS);
1351 +
1352 + $handler_started = microtime(true);
1353 +
1354 + $chat = $this->get_param('chat');
1355 + $session_id = $this->get_param('session_id');
1356 + $ai_page_ids = $this->get_param('ai_page_ids', [], null);
1357 + // Conversation context, so reopening "Build with AI" later can resume this
1358 + // app-end session instead of starting from scratch. `detected_info` is
1359 + // sanitized field-by-field in AIUtils::map_chat_detected_info().
1360 + $pack_id = $this->get_param('pack_id', 0, 'absint');
1361 + $platform = $this->get_param('platform');
1362 + $detected_info = $this->get_param('detected_info', [], null);
1363 +
1364 + if (empty($chat)) {
1365 + return $this->error('invalid_chat_id', __('Invalid conversation ID.', 'templately'), 'ai-content/chatbot-import-prepare', 400);
1366 + }
1367 +
1368 + if (empty($session_id)) {
1369 + return $this->error('invalid_session_id', __('Invalid session ID.', 'templately'), 'ai-content/chatbot-import-prepare', 400);
1370 + }
1371 +
1372 + // Security: sanitize the session id before it is used to build file paths.
1373 + $session_id = AIUtils::sanitize_path_component($session_id, 'session_id');
1374 + if (is_wp_error($session_id)) {
1375 + return $this->error('invalid_session_id', $session_id->get_error_message(), 'ai-content/chatbot-import-prepare', 400);
1376 + }
1377 +
1378 + // ai_page_ids may arrive as a JSON string when sent via FormData, and with
1379 + // scalar / comma-separated group values — normalize to the canonical
1380 + // `type/sub_type => ['id',...]` shape before anything indexes into it.
1381 + $ai_page_ids = AIUtils::normalize_ai_page_ids($ai_page_ids);
1382 + if (empty($ai_page_ids)) {
1383 + return $this->error('invalid_ai_page_ids', __('Invalid AI page IDs.', 'templately'), 'ai-content/chatbot-import-prepare', 400);
1384 + }
1385 +
1386 + // Expected page ids (flattened) — the client may redirect to customization
1387 + // as soon as the home/header/footer are ready, so by import time some pages
1388 + // can still be generating. We re-pull until every expected page is present
1389 + // (bounded wait), then proceed; anything still missing falls back to the
1390 + // pack's default content.
1391 + $expected_ids = AIUtils::flatten_ai_page_ids($ai_page_ids);
1392 +
1393 + $extra_headers = ['Accept' => 'application/json'];
1394 + $cache_key = self::GENERATED_CACHE_KEY . $chat;
1395 +
1396 + // This endpoint NEVER waits for completeness. The import starts as soon as
1397 + // the session exists; whatever pages are already generated are written
1398 + // here as a warm start, and any page still generating is pulled on demand
1399 + // by the Finalizer (Core/Importer/Utils/AIContentResolver +
1400 + // Providers/ChatAIContentProvider).
1401 + //
1402 + // Reuse the bundle chatbot-generated just parked, but ONLY when it already
1403 + // holds every expected page — a complete bundle cannot become less
1404 + // complete, whereas an incomplete one has to be re-pulled to pick up the
1405 + // pages that have since finished. On the common handoff (generation
1406 + // finished long before the user landed here) this removes an entire
1407 + // duplicate transfer of every page's block JSON.
1408 + $pull_started = microtime(true);
1409 + $pull_duration = 0;
1410 + $data = Database::get_transient($cache_key);
1411 + $from_cache = is_array($data) && $this->is_generated_bundle_complete($data, $expected_ids);
1412 +
1413 + if (! $from_cache) {
1414 + // Single pull — no server-side sleep/retry. The user can reach import as
1415 + // soon as the key pages (home/header/footer) are ready while the rest are
1416 + // still generating; rather than hold the request open until everything is
1417 + // done (which tripped a gateway 504), we return a non-fatal `pending`
1418 + // status and let the client poll (JS-side pull).
1419 + $response = Helper::make_api_get_request("v2/chatbot/generated/{$chat}", [], $extra_headers, 2 * MINUTE_IN_SECONDS);
1420 + $pull_duration = microtime(true) - $pull_started;
1421 +
1422 + if (is_wp_error($response)) {
1423 + Helper::log(sprintf('chatbot_import_prepare[%s] pull failed after %.2fs: %s', $chat, $pull_duration, $response->get_error_message()), 'ai-import', 'error');
1424 + return $this->error('request_failed', __('Failed to fetch generated content.', 'templately'), 'ai-content/chatbot-import-prepare', 500, ['error_detail' => $response->get_error_message()]);
1425 + }
1426 +
1427 + $response_code = wp_remote_retrieve_response_code($response);
1428 + $data = json_decode(wp_remote_retrieve_body($response), true);
1429 +
1430 + if ($response_code !== 200 || !is_array($data) || !isset($data['status'])) {
1431 + $message = (is_array($data) && !empty($data['message'])) ? $data['message'] : sprintf(__('API returned HTTP %d error.', 'templately'), $response_code);
1432 + Helper::log(sprintf('chatbot_import_prepare[%s] pull HTTP %d after %.2fs', $chat, $response_code, $pull_duration), 'ai-import', 'error');
1433 + return $this->error('api_http_error', $message, 'ai-content/chatbot-import-prepare', $response_code ?: 500);
1434 + }
1435 +
1436 + // Park a complete bundle for the credits re-read on the success screen.
1437 + if ($this->is_generated_bundle_complete($data, $expected_ids)) {
1438 + Database::set_transient($cache_key, $data, self::GENERATED_CACHE_TTL);
1439 + }
1440 + } else {
1441 + Helper::log(sprintf('chatbot_import_prepare[%s] reused cached bundle (no upstream pull)', $chat), 'ai-import', 'info');
1442 + }
1443 +
1444 + $generated = isset($data['data']) && is_array($data['data']) ? $data['data'] : [];
1445 +
1446 + // Access gate: the backend blocks a free user past their 7-day window.
1447 + if (isset($generated['can_import']) && ! $generated['can_import']) {
1448 + return $this->error('access_expired', __('Your free access to this generated site has ended. Upgrade your plan or purchase this template to import it.', 'templately'), 'ai-content/chatbot-import-prepare', 403);
1449 + }
1450 +
1451 + $templates = isset($generated['templates']) && is_array($generated['templates']) ? $generated['templates'] : [];
1452 +
1453 + // Pages the backend skipped (empty source JSON) or failed to generate.
1454 + // These will never appear in `templates`, so they must not be treated
1455 + // as "still generating" — without this, one skipped page keeps the poll
1456 + // pending until it times out.
1457 + $skipped_pages = isset($generated['skipped_pages']) && is_array($generated['skipped_pages']) ? array_map('strval', $generated['skipped_pages']) : [];
1458 + $skipped_expected = array_values(array_intersect($expected_ids, $skipped_pages));
1459 +
1460 + // Which expected pages are still missing from the bundle?
1461 + $missing = array_values(array_filter($expected_ids, function ($id) use ($templates, $skipped_pages) {
1462 + return !array_key_exists($id, $templates) && !array_key_exists((int) $id, $templates) && !in_array($id, $skipped_pages, true);
1463 + }));
1464 +
1465 + $ready = array_values(array_diff($expected_ids, $missing));
1466 + Helper::log(sprintf('chatbot_import_prepare[%s] warm start: ready=%d/%d missing=%d skipped=%d pull=%.2fs', $chat, count($ready), count($expected_ids), count($missing), count($skipped_expected), $pull_duration), 'ai-import', 'info');
1467 +
1468 +
1469 + // Derive a process_id for this chat-driven import and register process data
1470 + // so the existing validation/ai_get_json paths keep functioning.
1471 + $process_id = 'chat-' . $session_id;
1472 + $user = $this->utils('options')->get('user');
1473 +
1474 + $ai_process_data = AIUtils::get_ai_process_data();
1475 + $record = [
1476 + 'process_id' => $process_id,
1477 + 'session_id' => $session_id,
1478 + 'ai_page_ids' => $ai_page_ids,
1479 + 'api_key' => $this->api_key,
1480 + 'user_id' => isset($user['id']) ? $user['id'] : null,
1481 + 'chat_id' => $chat,
1482 + ];
1483 +
1484 + if (!empty($pack_id)) {
1485 + $record['pack_id'] = $pack_id;
1486 + }
1487 + if (!empty($platform)) {
1488 + $record['platform'] = $platform;
1489 + }
1490 +
1491 + // Persist the app-end answers exactly as an in-plugin conversation stores
1492 + // them, so reopening "Build with AI" resumes this session instead of
1493 + // starting over. Without this the record holds no answers at all and the
1494 + // sidebar has nothing to restore.
1495 + $conversation = AIUtils::build_conversation_fields(
1496 + $this->resolve_chat_conversation_fields($chat, $detected_info, $ai_process_data, $process_id)
1497 + );
1498 + if (!empty($conversation)) {
1499 + $record = array_merge($record, $conversation);
1500 + }
1501 +
1502 + $ai_process_data[$process_id] = $record;
1503 + AIUtils::update_ai_process_data($ai_process_data);
1504 +
1505 + // Persist each generated page to its .ai.json location for the import runners.
1506 + //
1507 + // Every page present in THIS pull is written immediately, even when others
1508 + // are still generating. Holding the writes back until the whole set was
1509 + // ready meant a single slow page threw away the full bundle on every poll
1510 + // — dozens of multi-hundred-KB pulls (all of `templates`, straight off GCP)
1511 + // discarded to save nothing. Writing as we go also lets the Finalizer
1512 + // runner finalize the pages that ARE ready instead of blocking on all of
1513 + // them. Already-written pages are skipped, so a re-poll is cheap.
1514 + $save_started = microtime(true);
1515 + $saved_count = 0;
1516 + $errors = [];
1517 + $processed_pages = get_option('templately_ai_processed_pages', []);
1518 + $already_saved = isset($processed_pages[$process_id]['pages']) ? $processed_pages[$process_id]['pages'] : [];
1519 + foreach ($templates as $content_id => $template) {
1520 + if (empty($template)) {
1521 + continue;
1522 + }
1523 +
1524 + if (array_key_exists((string) $content_id, $already_saved)) {
1525 + $saved_count++;
1526 + continue;
1527 + }
1528 +
1529 + // The runners read JSON strings; normalize arrays/objects to a string.
1530 + $template_payload = is_string($template) ? $template : wp_json_encode($template);
1531 +
1532 + $result = AIUtils::save_template_to_file(
1533 + $process_id,
1534 + $session_id,
1535 + $content_id,
1536 + $template_payload,
1537 + $ai_page_ids,
1538 + false
1539 + );
1540 +
1541 + if (is_wp_error($result)) {
1542 + $errors[$content_id] = $result->get_error_message();
1543 + continue;
1544 + }
1545 + if (isset($result['status']) && $result['status'] === 'success') {
1546 + $saved_count++;
1547 + } else {
1548 + $errors[$content_id] = isset($result['message']) ? $result['message'] : 'unknown';
1549 + }
1550 + }
1551 +
1552 + // Write each backend-skipped page as an explicit `{"isSkipped": true}`
1553 + // marker (same shape the legacy per-page callback wrote) so the import
1554 + // runners fall back to the pack's default content instead of treating
1555 + // the page as missing.
1556 + $skipped_saved = [];
1557 + foreach ($skipped_expected as $skipped_id) {
1558 + if (array_key_exists($skipped_id, $templates) || array_key_exists((int) $skipped_id, $templates)) {
1559 + continue;
1560 + }
1561 +
1562 + if (array_key_exists((string) $skipped_id, $already_saved)) {
1563 + $skipped_saved[] = $skipped_id;
1564 + continue;
1565 + }
1566 +
1567 + $result = AIUtils::save_template_to_file(
1568 + $process_id,
1569 + $session_id,
1570 + $skipped_id,
1571 + '',
1572 + $ai_page_ids,
1573 + true
1574 + );
1575 +
1576 + if (is_wp_error($result)) {
1577 + $errors[$skipped_id] = $result->get_error_message();
1578 + continue;
1579 + }
1580 + if (isset($result['status']) && $result['status'] === 'success') {
1581 + $skipped_saved[] = $skipped_id;
1582 + } else {
1583 + $errors[$skipped_id] = isset($result['message']) ? $result['message'] : 'unknown';
1584 + }
1585 + }
1586 +
1587 + $save_duration = microtime(true) - $save_started;
1588 + Helper::log(sprintf('chatbot_import_prepare[%s] saved %d/%d pages in %.2fs (skipped=%d, errors=%d)', $chat, $saved_count, count($templates), $save_duration, count($skipped_saved), count($errors)), 'ai-import', 'info');
1589 +
1590 + // NOTE: there is deliberately NO `pending` return here any more. Pages that
1591 + // are still generating come back in `missing` and are pulled on demand —
1592 + // and waited for — by the Finalizer. Returning `pending` made the client
1593 + // poll for minutes before the import could even start.
1594 + //
1595 + // NOT an error when nothing was saved: with the wait deferred to the
1596 + // Finalizer it is legitimate for zero pages to be ready at import start.
1597 + // Only a genuine write failure (something was ready but every save
1598 + // errored) is fatal.
1599 + if ($saved_count === 0 && empty($skipped_saved) && !empty($errors)) {
1600 + return $this->error('save_failed', __('Failed to save generated content.', 'templately'), 'ai-content/chatbot-import-prepare', 500, ['errors' => $errors]);
1601 + }
1602 +
1603 + Helper::log(sprintf('chatbot_import_prepare[%s] returning: pages=%d missing=%d pull=%.2fs', $chat, count($templates), count($missing), $pull_duration), 'ai-import', 'info');
1604 +
1605 + // Import the logo into the media library and map it into the customization.
1606 + $customization = isset($generated['customization_data']) && is_array($generated['customization_data']) ? $generated['customization_data'] : [];
1607 + $logo = null;
1608 + $logo_url = !empty($generated['logo_url']) ? esc_url_raw($generated['logo_url']) : '';
1609 +
1610 + if (!empty($logo_url)) {
1611 + $logo_started = microtime(true);
1612 + $uploaded = Utils::upload_logo($logo_url, $session_id);
1613 + Helper::log(sprintf('chatbot_import_prepare[%s] logo upload in %.2fs', $chat, microtime(true) - $logo_started), 'ai-import', 'info');
1614 + if (!empty($uploaded['id'])) {
1615 + $logo = [
1616 + 'id' => (int) $uploaded['id'],
1617 + 'url' => $uploaded['url'],
1618 + ];
1619 + } elseif (!empty($uploaded['error'])) {
1620 + // Logo is non-fatal: log and continue without it.
1621 + Helper::log('chatbot_import_prepare logo upload failed: ' . $uploaded['error']);
1622 + }
1623 + }
1624 +
1625 + // Reflect the imported logo back into the customization payload so React
1626 + // can build the settings FormData from a single source.
1627 + if (!empty($logo)) {
1628 + $customization['logo'] = $logo;
1629 + }
1630 +
1631 + Helper::log(sprintf('chatbot_import_prepare[%s] done in %.2fs total', $chat, microtime(true) - $handler_started), 'ai-import', 'info');
1632 +
1633 + return [
1634 + 'status' => 'success',
1635 + 'data' => [
1636 + 'session_id' => $session_id,
1637 + 'process_id' => $process_id,
1638 + 'ai_page_ids' => $ai_page_ids,
1639 + 'saved' => $saved_count,
1640 + // Pages the backend explicitly skipped — imported with the
1641 + // pack's default content instead.
1642 + 'skipped' => $skipped_expected,
1643 + // Readiness snapshot at import start. `missing` pages are NOT a
1644 + // failure: the Finalizer pulls each on demand and waits for it.
1645 + 'expected' => $expected_ids,
1646 + 'ready' => $ready,
1647 + 'missing' => $missing,
1648 + 'platform' => isset($customization['platform']) ? $customization['platform'] : null,
1649 + 'customization_data' => $customization,
1650 + 'logo' => $logo,
1651 + 'errors' => $errors,
1652 + ],
1653 + ];
937 1654 }
938 1655
939 1656 /**
940 1657 * Validate API key against database