@styleflow.app/flowpress-deploy 1.0.0-beta.0 → 1.0.0-beta.10

package/includes/queue-provider.php

@@ -0,0 +1,621 @@
+<?php
+
+if (! defined('ABSPATH')) {
+    exit;
+}
+
+function flowpress_deploy_queue_table(): string
+{
+    global $wpdb;
+    return $wpdb->prefix . 'flowpress_deploy_queue';
+}
+
+function flowpress_deploy_state_table(): string
+{
+    global $wpdb;
+    return $wpdb->prefix . 'flowpress_deploy_state';
+}
+
+function flowpress_deploy_batch_table(): string
+{
+    global $wpdb;
+    return $wpdb->prefix . 'flowpress_deploy_batches';
+}
+
+function flowpress_deploy_install_schema(): void
+{
+    if (! function_exists('flowpress_wordpress_ready') || ! flowpress_wordpress_ready()) {
+        return;
+    }
+    if (get_option('flowpress_deploy_schema') === '1') {
+        return;
+    }
+
+    global $wpdb;
+    require_once ABSPATH . 'wp-admin/includes/upgrade.php';
+    $charset = $wpdb->get_charset_collate();
+    $queue = flowpress_deploy_queue_table();
+    $state = flowpress_deploy_state_table();
+    $batches = flowpress_deploy_batch_table();
+    dbDelta("CREATE TABLE {$queue} (
+        id bigint unsigned NOT NULL AUTO_INCREMENT,
+        target varchar(64) NOT NULL,
+        group_key varchar(191) NOT NULL,
+        resource_type varchar(64) NOT NULL,
+        resource_id bigint unsigned NOT NULL DEFAULT 0,
+        current_uris longtext NOT NULL,
+        previous_uris longtext NOT NULL,
+        fingerprint char(64) NOT NULL,
+        revision bigint unsigned NOT NULL DEFAULT 1,
+        force_full tinyint(1) NOT NULL DEFAULT 0,
+        batch_id varchar(64) NULL,
+        dispatched_revision bigint unsigned NULL,
+        dispatched_at datetime NULL,
+        created_at datetime NOT NULL,
+        updated_at datetime NOT NULL,
+        PRIMARY KEY (id),
+        UNIQUE KEY target_group (target, group_key),
+        KEY batch_id (batch_id),
+        KEY target_pending (target, batch_id)
+    ) {$charset};");
+    dbDelta("CREATE TABLE {$state} (
+        target varchar(64) NOT NULL,
+        group_key varchar(191) NOT NULL,
+        current_uris longtext NOT NULL,
+        fingerprint char(64) NOT NULL,
+        revision bigint unsigned NOT NULL DEFAULT 0,
+        updated_at datetime NOT NULL,
+        PRIMARY KEY (target, group_key)
+    ) {$charset};");
+    dbDelta("CREATE TABLE {$batches} (
+        batch_id varchar(64) NOT NULL,
+        target varchar(64) NOT NULL,
+        mode varchar(16) NOT NULL,
+        snapshot longtext NOT NULL,
+        status varchar(16) NOT NULL DEFAULT 'in_flight',
+        created_at datetime NOT NULL,
+        completed_at datetime NULL,
+        PRIMARY KEY (batch_id),
+        KEY status_created (status, created_at)
+    ) {$charset};");
+    update_option('flowpress_deploy_schema', '1', false);
+    flowpress_deploy_migrate_core_queue();
+}
+add_action('init', 'flowpress_deploy_install_schema', 0);
+
+/** @return list<string> */
+function flowpress_deploy_decode_uris(mixed $value): array
+{
+    $decoded = is_array($value) ? $value : json_decode((string) $value, true);
+    if (! is_array($decoded)) {
+        return [];
+    }
+    $uris = [];
+    foreach ($decoded as $uri) {
+        if (! is_string($uri) || $uri === '') {
+            continue;
+        }
+        $normalized = function_exists('flowpress_normalize_uri')
+            ? flowpress_normalize_uri($uri)
+            : (string) (wp_parse_url($uri, PHP_URL_PATH) ?: '/');
+        $uris[$normalized] = true;
+    }
+    $uris = array_keys($uris);
+    sort($uris, SORT_STRING);
+    return $uris;
+}
+
+function flowpress_deploy_json(array $value): string
+{
+    return (string) wp_json_encode(array_values($value), JSON_UNESCAPED_SLASHES);
+}
+
+/** @return array{paths:list<string>,deletedPaths:list<string>} */
+function flowpress_deploy_route_delta(array $previous, array $current): array
+{
+    $previous = flowpress_deploy_decode_uris($previous);
+    $current = flowpress_deploy_decode_uris($current);
+    return [
+        'paths' => $current,
+        'deletedPaths' => array_values(array_diff($previous, $current)),
+    ];
+}
+
+function flowpress_deploy_ack_action(string $status, int $current_revision, int $snapshot_revision): string
+{
+    if ($status !== 'success') {
+        return 'release';
+    }
+    return $current_revision === $snapshot_revision ? 'delete' : 'release';
+}
+
+/** @return array{resourceType:string,resourceId:int,uri:string,operation:string,forceFull:bool,target:string} */
+function flowpress_deploy_normalize_legacy_row(array $row): array
+{
+    return [
+        'resourceType' => sanitize_key((string) ($row['resource_type'] ?? 'legacy')) ?: 'legacy',
+        'resourceId' => max(0, (int) ($row['resource_id'] ?? 0)),
+        'uri' => (string) ($row['uri'] ?? '/'),
+        'operation' => ($row['operation'] ?? '') === 'delete' ? 'delete' : 'update',
+        'forceFull' => ! empty($row['force_full']),
+        'target' => sanitize_key((string) ($row['target'] ?? '')),
+    ];
+}
+
+/** @return array{groupKey:string,resourceType:string,resourceId:int,uris:list<string>,fingerprint:string} */
+function flowpress_deploy_describe_resource(string $resource_type, int $resource_id, string $fallback_uri): array
+{
+    $resource_type = sanitize_key($resource_type);
+    $group_key = $resource_type . ':' . max(0, $resource_id);
+    $uris = flowpress_deploy_decode_uris([$fallback_uri]);
+    $fingerprint_fields = [
+        'resourceType' => $resource_type,
+        'resourceId' => $resource_id,
+    ];
+
+    $post = $resource_id > 0 ? get_post($resource_id) : null;
+    if ($post instanceof WP_Post) {
+        $element_type = 'post_' . $post->post_type;
+        $trid = apply_filters('wpml_element_trid', null, $resource_id, $element_type);
+        if (is_numeric($trid) && (int) $trid > 0) {
+            $group_key = 'wpml:' . $element_type . ':' . (int) $trid;
+        }
+        $translations = is_numeric($trid)
+            ? apply_filters('wpml_get_element_translations', [], (int) $trid, $element_type)
+            : [];
+        $post_ids = [$resource_id];
+        if (is_array($translations)) {
+            foreach ($translations as $translation) {
+                $translated_id = is_object($translation) ? ($translation->element_id ?? 0) : 0;
+                if ((int) $translated_id > 0) {
+                    $post_ids[] = (int) $translated_id;
+                }
+            }
+        }
+        $post_ids = array_values(array_unique($post_ids));
+        sort($post_ids, SORT_NUMERIC);
+        $uris = [];
+        $posts = [];
+        foreach ($post_ids as $post_id) {
+            $translated = get_post($post_id);
+            if (! $translated instanceof WP_Post) {
+                continue;
+            }
+            if ($translated->post_status === 'publish') {
+                $permalink = get_permalink($translated);
+                if (is_string($permalink) && $permalink !== '') {
+                    $uris[] = $permalink;
+                }
+            }
+            $meta = get_post_meta($post_id);
+            $excluded = (array) apply_filters('flowpress_deploy_volatile_meta_keys', [
+                '_edit_lock', '_edit_last', '_wp_old_slug', '_wp_page_template',
+            ], 'post', $post_id);
+            foreach ($excluded as $key) {
+                unset($meta[(string) $key]);
+            }
+            ksort($meta);
+            $terms = wp_get_object_terms($post_id, get_object_taxonomies($translated->post_type), ['fields' => 'tt_ids']);
+            if (! is_wp_error($terms)) {
+                $terms = array_map('intval', $terms);
+                sort($terms, SORT_NUMERIC);
+            }
+            $posts[] = [
+                'id' => $post_id,
+                'type' => $translated->post_type,
+                'status' => $translated->post_status,
+                'slug' => $translated->post_name,
+                'title' => $translated->post_title,
+                'content' => $translated->post_content,
+                'excerpt' => $translated->post_excerpt,
+                'parent' => (int) $translated->post_parent,
+                'modified' => $translated->post_modified_gmt,
+                'meta' => $meta,
+                'terms' => is_wp_error($terms) ? [] : $terms,
+            ];
+        }
+        $fingerprint_fields['posts'] = $posts;
+    } elseif ($resource_id > 0) {
+        $term = get_term($resource_id, $resource_type);
+        if ($term instanceof WP_Term) {
+            $element_type = 'tax_' . $resource_type;
+            $trid = apply_filters('wpml_element_trid', null, $term->term_taxonomy_id, $element_type);
+            if (is_numeric($trid) && (int) $trid > 0) {
+                $group_key = 'wpml:' . $element_type . ':' . (int) $trid;
+            }
+            $translations = is_numeric($trid)
+                ? apply_filters('wpml_get_element_translations', [], (int) $trid, $element_type)
+                : [];
+            $translated_terms = [$term];
+            if (is_array($translations)) {
+                foreach ($translations as $translation) {
+                    $tt_id = is_object($translation) ? (int) ($translation->element_id ?? 0) : 0;
+                    $translated_term = $tt_id > 0
+                        ? get_term_by('term_taxonomy_id', $tt_id, $resource_type)
+                        : null;
+                    if ($translated_term instanceof WP_Term) {
+                        $translated_terms[] = $translated_term;
+                    }
+                }
+            }
+            $term_map = [];
+            foreach ($translated_terms as $translated_term) {
+                $term_map[$translated_term->term_id] = $translated_term;
+            }
+            ksort($term_map, SORT_NUMERIC);
+            $uris = [];
+            $terms = [];
+            foreach ($term_map as $translated_term) {
+                $link = get_term_link($translated_term);
+                if (! is_wp_error($link) && is_string($link)) {
+                    $uris[] = $link;
+                }
+                $meta = get_term_meta($translated_term->term_id);
+                $excluded = (array) apply_filters(
+                    'flowpress_deploy_volatile_meta_keys',
+                    [],
+                    'term',
+                    $translated_term->term_id
+                );
+                foreach ($excluded as $key) {
+                    unset($meta[(string) $key]);
+                }
+                ksort($meta);
+                $terms[] = [
+                    'id' => $translated_term->term_id,
+                    'taxonomy' => $resource_type,
+                    'slug' => $translated_term->slug,
+                    'name' => $translated_term->name,
+                    'description' => $translated_term->description,
+                    'parent' => (int) $translated_term->parent,
+                    'meta' => $meta,
+                ];
+            }
+            $fingerprint_fields['terms'] = $terms;
+        }
+    }
+
+    $group_key = (string) apply_filters(
+        'flowpress_deploy_group_key',
+        $group_key,
+        $resource_type,
+        $resource_id
+    );
+    $uris = flowpress_deploy_decode_uris((array) apply_filters(
+        'flowpress_deploy_canonical_uris',
+        $uris,
+        $resource_type,
+        $resource_id,
+        $group_key
+    ));
+    $fingerprint_fields = (array) apply_filters(
+        'flowpress_deploy_fingerprint_fields',
+        $fingerprint_fields,
+        $resource_type,
+        $resource_id,
+        $group_key
+    );
+    return [
+        'groupKey' => sanitize_key(str_replace(':', '-', $group_key)),
+        'resourceType' => $resource_type,
+        'resourceId' => max(0, $resource_id),
+        'uris' => $uris,
+        'fingerprint' => hash('sha256', (string) wp_json_encode($fingerprint_fields)),
+    ];
+}
+
+/** @var array<string,array{resourceType:string,resourceId:int,uri:string,operation:string,forceFull:bool}> */
+function &flowpress_deploy_collected_changes(): array
+{
+    static $changes = [];
+    return $changes;
+}
+
+function flowpress_deploy_collect_change(
+    string $resource_type,
+    int $resource_id,
+    string $uri,
+    string $operation = 'update',
+    bool $force_full = false
+): void {
+    if (function_exists('flowpress_deploy_schedule_public_build')) flowpress_deploy_schedule_public_build();
+
+    if ($operation === 'delete') {
+        flowpress_deploy_enqueue_change($resource_type, $resource_id, $uri, 'delete', $force_full);
+        return;
+    }
+    $changes = &flowpress_deploy_collected_changes();
+    $changes[$resource_type . ':' . $resource_id] = [
+        'resourceType' => $resource_type,
+        'resourceId' => $resource_id,
+        'uri' => $uri,
+        'operation' => $operation,
+        'forceFull' => $force_full,
+    ];
+}
+
+function flowpress_deploy_flush_changes(): void
+{
+    $changes = &flowpress_deploy_collected_changes();
+    foreach ($changes as $change) {
+        flowpress_deploy_enqueue_change(
+            $change['resourceType'],
+            $change['resourceId'],
+            $change['uri'],
+            $change['operation'],
+            $change['forceFull']
+        );
+    }
+    $changes = [];
+}
+add_action('shutdown', 'flowpress_deploy_flush_changes', 0);
+
+function flowpress_deploy_enqueue_change(
+    string $resource_type,
+    int $resource_id,
+    string $uri,
+    string $operation = 'update',
+    bool $force_full = false,
+    ?string $only_target = null
+): void {
+    global $wpdb;
+    $descriptor = flowpress_deploy_describe_resource($resource_type, $resource_id, $uri);
+    if ($operation === 'delete') {
+        $descriptor['uris'] = [];
+        $descriptor['fingerprint'] = hash('sha256', 'deleted:' . $descriptor['groupKey']);
+    }
+    $targets = $only_target !== null ? [$only_target] : flowpress_static_targets();
+    foreach ($targets as $target) {
+        $target = sanitize_key($target);
+        if ($target === '') {
+            continue;
+        }
+        $existing = $wpdb->get_row($wpdb->prepare(
+            'SELECT * FROM ' . flowpress_deploy_queue_table() . ' WHERE target = %s AND group_key = %s',
+            $target,
+            $descriptor['groupKey']
+        ), ARRAY_A);
+        $state = $wpdb->get_row($wpdb->prepare(
+            'SELECT * FROM ' . flowpress_deploy_state_table() . ' WHERE target = %s AND group_key = %s',
+            $target,
+            $descriptor['groupKey']
+        ), ARRAY_A);
+        if (
+            ! $force_full
+            && $operation !== 'delete'
+            && ! is_array($existing)
+            && is_array($state)
+            && hash_equals((string) $state['fingerprint'], $descriptor['fingerprint'])
+            && flowpress_deploy_decode_uris($state['current_uris']) === $descriptor['uris']
+        ) {
+            continue;
+        }
+        $previous = is_array($existing)
+            ? flowpress_deploy_decode_uris($existing['previous_uris'])
+            : (is_array($state) ? flowpress_deploy_decode_uris($state['current_uris']) : []);
+        if ($operation === 'delete' && $previous === []) {
+            $previous = flowpress_deploy_decode_uris([$uri]);
+        }
+        $now = current_time('mysql', true);
+        if (is_array($existing)) {
+            $wpdb->update(flowpress_deploy_queue_table(), [
+                'resource_type' => $descriptor['resourceType'],
+                'resource_id' => $descriptor['resourceId'],
+                'current_uris' => flowpress_deploy_json($descriptor['uris']),
+                'fingerprint' => $descriptor['fingerprint'],
+                'revision' => (int) $existing['revision'] + 1,
+                'force_full' => ($force_full || ! empty($existing['force_full'])) ? 1 : 0,
+                'updated_at' => $now,
+            ], ['id' => (int) $existing['id']]);
+        } else {
+            $wpdb->insert(flowpress_deploy_queue_table(), [
+                'target' => $target,
+                'group_key' => $descriptor['groupKey'],
+                'resource_type' => $descriptor['resourceType'],
+                'resource_id' => $descriptor['resourceId'],
+                'current_uris' => flowpress_deploy_json($descriptor['uris']),
+                'previous_uris' => flowpress_deploy_json($previous),
+                'fingerprint' => $descriptor['fingerprint'],
+                'revision' => 1,
+                'force_full' => $force_full ? 1 : 0,
+                'created_at' => $now,
+                'updated_at' => $now,
+            ]);
+        }
+    }
+}
+
+/** @return array<string,list<array<string,mixed>>> */
+function &flowpress_deploy_payload_snapshots(): array
+{
+    static $snapshots = [];
+    return $snapshots;
+}
+
+function flowpress_deploy_build_payload(string $target, bool $force_full = false): array
+{
+    flowpress_deploy_flush_changes();
+    flowpress_deploy_recover_stale_batches();
+    global $wpdb;
+    $rows = (array) $wpdb->get_results($wpdb->prepare(
+        'SELECT * FROM ' . flowpress_deploy_queue_table()
+        . ' WHERE target = %s AND batch_id IS NULL ORDER BY id ASC',
+        $target
+    ), ARRAY_A);
+    $paths = [];
+    $deleted = [];
+    $full = $force_full;
+    foreach ($rows as $row) {
+        $current = flowpress_deploy_decode_uris($row['current_uris']);
+        $previous = flowpress_deploy_decode_uris($row['previous_uris']);
+        $delta = flowpress_deploy_route_delta($previous, $current);
+        foreach ($delta['paths'] as $path) {
+            $paths[$path] = true;
+            unset($deleted[$path]);
+        }
+        foreach ($delta['deletedPaths'] as $path) {
+            if (! isset($paths[$path])) {
+                $deleted[$path] = true;
+            }
+        }
+        $full = $full || ! empty($row['force_full']);
+    }
+    $batch_id = wp_generate_uuid4();
+    $snapshots = &flowpress_deploy_payload_snapshots();
+    $snapshots[$batch_id] = $rows;
+    return [
+        'batchId' => $batch_id,
+        'target' => sanitize_key($target),
+        'mode' => $full ? 'full' : 'partial',
+        'paths' => array_keys($paths),
+        'deletedPaths' => array_keys($deleted),
+        'queueIds' => array_map('intval', array_column($rows, 'id')),
+    ];
+}
+
+function flowpress_deploy_mark_dispatched(array $payload): void
+{
+    global $wpdb;
+    $batch_id = sanitize_text_field((string) ($payload['batchId'] ?? ''));
+    $snapshots = &flowpress_deploy_payload_snapshots();
+    $rows = $snapshots[$batch_id] ?? [];
+    unset($snapshots[$batch_id]);
+    $now = current_time('mysql', true);
+    $accepted = [];
+    foreach ($rows as $row) {
+        $updated = $wpdb->query($wpdb->prepare(
+            'UPDATE ' . flowpress_deploy_queue_table()
+            . ' SET batch_id = %s, dispatched_revision = %d, dispatched_at = %s'
+            . ' WHERE id = %d AND revision = %d AND batch_id IS NULL',
+            $batch_id,
+            (int) $row['revision'],
+            $now,
+            (int) $row['id'],
+            (int) $row['revision']
+        ));
+        if ($updated) {
+            $accepted[] = $row;
+        }
+    }
+    $wpdb->replace(flowpress_deploy_batch_table(), [
+        'batch_id' => $batch_id,
+        'target' => sanitize_key((string) ($payload['target'] ?? '')),
+        'mode' => ($payload['mode'] ?? '') === 'full' ? 'full' : 'partial',
+        'snapshot' => (string) wp_json_encode($accepted, JSON_UNESCAPED_SLASHES),
+        'status' => 'in_flight',
+        'created_at' => $now,
+    ]);
+}
+
+function flowpress_deploy_complete_batch(string $batch_id, string $status): int
+{
+    global $wpdb;
+    $batch = $wpdb->get_row($wpdb->prepare(
+        'SELECT * FROM ' . flowpress_deploy_batch_table() . ' WHERE batch_id = %s',
+        $batch_id
+    ), ARRAY_A);
+    if (! is_array($batch)) {
+        return 0;
+    }
+    $rows = json_decode((string) $batch['snapshot'], true);
+    $rows = is_array($rows) ? $rows : [];
+    $affected = 0;
+    foreach ($rows as $snapshot) {
+        $current = $wpdb->get_row($wpdb->prepare(
+            'SELECT * FROM ' . flowpress_deploy_queue_table() . ' WHERE id = %d',
+            (int) ($snapshot['id'] ?? 0)
+        ), ARRAY_A);
+        if (! is_array($current) || (string) $current['batch_id'] !== $batch_id) {
+            continue;
+        }
+        if ($status === 'success') {
+            $wpdb->replace(flowpress_deploy_state_table(), [
+                'target' => (string) $snapshot['target'],
+                'group_key' => (string) $snapshot['group_key'],
+                'current_uris' => (string) $snapshot['current_uris'],
+                'fingerprint' => (string) $snapshot['fingerprint'],
+                'revision' => (int) $snapshot['revision'],
+                'updated_at' => current_time('mysql', true),
+            ]);
+        }
+        $ack_action = flowpress_deploy_ack_action(
+            $status,
+            (int) $current['revision'],
+            (int) $snapshot['revision']
+        );
+        if ($ack_action === 'delete') {
+            $affected += (int) $wpdb->delete(flowpress_deploy_queue_table(), ['id' => (int) $current['id']]);
+        } else {
+            $affected += (int) $wpdb->update(flowpress_deploy_queue_table(), [
+                'batch_id' => null,
+                'dispatched_revision' => null,
+                'dispatched_at' => null,
+            ], ['id' => (int) $current['id']]);
+        }
+    }
+    $wpdb->update(flowpress_deploy_batch_table(), [
+        'status' => $status,
+        'completed_at' => current_time('mysql', true),
+    ], ['batch_id' => $batch_id]);
+    return $affected;
+}
+
+function flowpress_deploy_pending_count(string $target): int
+{
+    global $wpdb;
+    return (int) $wpdb->get_var($wpdb->prepare(
+        'SELECT COUNT(*) FROM ' . flowpress_deploy_queue_table()
+        . ' WHERE target = %s AND batch_id IS NULL',
+        sanitize_key($target)
+    ));
+}
+
+function flowpress_deploy_recover_stale_batches(): int
+{
+    global $wpdb;
+    $hours = max(1, (int) apply_filters('flowpress_deploy_stale_batch_hours', 6));
+    $cutoff = gmdate('Y-m-d H:i:s', time() - ($hours * HOUR_IN_SECONDS));
+    $batch_ids = (array) $wpdb->get_col($wpdb->prepare(
+        'SELECT batch_id FROM ' . flowpress_deploy_batch_table()
+        . " WHERE status = 'in_flight' AND created_at < %s",
+        $cutoff
+    ));
+    $affected = 0;
+    foreach ($batch_ids as $batch_id) {
+        $affected += flowpress_deploy_complete_batch((string) $batch_id, 'failure');
+    }
+    return $affected;
+}
+add_action('flowpress_deploy_recover_stale_batches', 'flowpress_deploy_recover_stale_batches');
+add_action('init', static function (): void {
+    if (! wp_next_scheduled('flowpress_deploy_recover_stale_batches')) {
+        wp_schedule_event(time() + HOUR_IN_SECONDS, 'hourly', 'flowpress_deploy_recover_stale_batches');
+    }
+}, 20);
+
+function flowpress_deploy_migrate_core_queue(): void
+{
+    if (get_option('flowpress_deploy_core_queue_migrated') === '1') {
+        return;
+    }
+    global $wpdb;
+    $core = $wpdb->prefix . 'flowpress_build_queue';
+    $like = method_exists($wpdb, 'esc_like') ? $wpdb->esc_like($core) : $core;
+    if ($wpdb->get_var($wpdb->prepare('SHOW TABLES LIKE %s', $like)) !== $core) {
+        update_option('flowpress_deploy_core_queue_migrated', '1', false);
+        return;
+    }
+    $rows = (array) $wpdb->get_results("SELECT * FROM {$core} ORDER BY id ASC", ARRAY_A);
+    foreach ($rows as $row) {
+        $legacy = flowpress_deploy_normalize_legacy_row($row);
+        flowpress_deploy_enqueue_change(
+            $legacy['resourceType'],
+            $legacy['resourceId'],
+            $legacy['uri'],
+            $legacy['operation'],
+            $legacy['forceFull'],
+            $legacy['target']
+        );
+    }
+    update_option('flowpress_deploy_core_queue_migrated', '1', false);
+}