error( $assoc_args, 'error', $human, $exit ); return; } } Pawa_Cli_IO::halt( $exit ); } /** * @param array $assoc_args Assoc args. * @param string $code Error code. * @param string $message Message. * @param int $exit Exit code. */ protected function error( $assoc_args, $code, $message, $exit = 1 ) { if ( Pawa_Cli_IO::wants_json( $assoc_args ) ) { Pawa_Cli_IO::send_error( $code, $message, $exit ); } if ( class_exists( 'WP_CLI' ) && method_exists( 'WP_CLI', 'error' ) ) { WP_CLI::error( $message ); } Pawa_Cli_IO::halt( $exit > 0 ? $exit : 1 ); } /** * @param array $assoc_args Assoc args. * @param string $action What --yes confirms. * @return bool False when the command already halted. */ protected function require_yes( $assoc_args, $action ) { if ( Pawa_Cli_IO::is_yes( $assoc_args ) ) { return true; } $this->error( $assoc_args, 'confirmation_required', $action . ' requires --yes (non-interactive).', 1 ); return false; } /** * Stop unless WP-CLI's `--user` signed in a user who may manage automations. * * @param array $assoc_args Assoc args. * @return bool False when the command already halted. */ protected function require_user( $assoc_args ) { $ok = Pawa_Cli_IO::require_user(); if ( is_wp_error( $ok ) ) { $this->error( $assoc_args, $ok->get_error_code(), $ok->get_error_message() ); return false; } return true; } /** * @param array $assoc_args Assoc args. * @param array $items Rows. * @param string[] $fields Columns. * @param array $meta Meta for JSON lists. */ protected function send_list( $assoc_args, $items, $fields, $meta = array() ) { $items = is_array( $items ) ? array_values( $items ) : array(); $format = Pawa_Cli_IO::format( $assoc_args ); $meta = array_merge( array( 'total' => count( $items ) ), is_array( $meta ) ? $meta : array() ); if ( 'json' === $format ) { Pawa_Cli_IO::send_data( true, $items, $meta, 0 ); } if ( 'human' === $format ) { $format = 'table'; } Pawa_Cli_IO::print_items( $items, $fields, $format ); Pawa_Cli_IO::halt( 0 ); } /** * @return Pawa_Action_Registry */ protected function action_registry() { $registry = apply_filters( 'pawa_action_registry', null ); if ( $registry instanceof Pawa_Action_Registry ) { return $registry; } return new Pawa_Action_Registry(); } /** * @return Pawa_Runner */ protected function runner() { return new Pawa_Runner( $this->action_registry() ); } /** * @return array{events:array,eventsFields:array} */ protected function catalog() { if ( ! class_exists( 'Pawa_Events_Fields' ) ) { return array( 'events' => array(), 'eventsFields' => array(), ); } $provider = new Pawa_Events_Fields(); return array( 'events' => $provider->get_events(), 'eventsFields' => $provider->get_events_fields(), ); } /** * Build a canvas event node from a catalog id or a JSON event object. * * @param mixed $trigger Catalog id, dotted alias, or event node. * @param array $extra Extra event data. * @return array|WP_Error */ protected function event_node( $trigger, $extra = array() ) { if ( is_array( $trigger ) && ( isset( $trigger['slug'] ) || isset( $trigger['data'] ) ) ) { $node = $trigger; if ( empty( $node['id'] ) ) { $node['id'] = 'trigger-1'; } if ( empty( $node['type'] ) ) { $node['type'] = 'events'; } return $node; } $name = is_string( $trigger ) ? $trigger : ''; $name = str_replace( '-', '_', $name ); if ( '' === $name ) { return new WP_Error( 'missing_trigger', 'Provide a catalog event id (see `wp pawa trigger list`).' ); } $catalog = $this->catalog(); $events = isset( $catalog['events'] ) && is_array( $catalog['events'] ) ? $catalog['events'] : array(); if ( ! isset( $events[ $name ] ) ) { return new WP_Error( 'unknown_trigger', 'Unknown event `' . $name . '`. Use a catalog id from `wp pawa trigger list` (for example wc_new_order, wordpress_new_post).' ); } $slug = Pawa_Integrations::event_slug_from_name( $name ); if ( '' === $slug ) { return new WP_Error( 'unmapped_trigger', 'Event `' . $name . '` is in the catalog but has no mapped canvas slug. Pass a full event object (`{"slug":"database","data":{"eventName":"..."}}`) or pick a WordPress / WooCommerce / form catalog id.' ); } $data = array_merge( array( 'eventName' => $name, 'eventTitle' => (string) $events[ $name ], ), is_array( $extra ) ? $extra : array() ); return array( 'id' => 'trigger-1', 'slug' => $slug, 'type' => 'events', 'title' => (string) $events[ $name ], 'data' => $data, ); } /** * Normalize workflow JSON (create/update). * * @param array $input JSON body. * @return array|WP_Error */ protected function workflow_from_json( $input ) { $input = is_array( $input ) ? $input : array(); $title = ''; if ( isset( $input['name'] ) ) { $title = (string) $input['name']; } elseif ( isset( $input['title'] ) ) { $title = (string) $input['title']; } $status = isset( $input['status'] ) ? (string) $input['status'] : 'draft'; $status = Pawa_Cli_Inspect::post_status( $status ); if ( ! in_array( $status, array( 'publish', 'draft' ), true ) ) { $status = 'draft'; } $event = null; if ( isset( $input['event'] ) && is_array( $input['event'] ) ) { return new WP_Error( 'pawa_pre_release_event', __( 'pre-release format (top-level "event"); recreate the automation', 'pluginsandapps-workflow-automation' ) ); } if ( isset( $input['trigger'] ) ) { $built = $this->event_node( $input['trigger'] ); if ( is_wp_error( $built ) ) { return $built; } $event = $built; } elseif ( isset( $input['eventName'] ) ) { $built = $this->event_node( $input['eventName'] ); if ( is_wp_error( $built ) ) { return $built; } $event = $built; } elseif ( isset( $input['event'] ) && is_string( $input['event'] ) ) { // Catalog id string shorthand (not the document key). $built = $this->event_node( $input['event'] ); if ( is_wp_error( $built ) ) { return $built; } $event = $built; } if ( array_key_exists( 'blocks', $input ) && ! Pawa_Workflow_Document::is_blocks_list( $input['blocks'] ) ) { return new WP_Error( 'pawa_invalid_blocks', __( 'Blocks must be an array.', 'pluginsandapps-workflow-automation' ) ); } $blocks = array_key_exists( 'blocks', $input ) ? $input['blocks'] : array(); return array( 'title' => $title, 'status' => $status, 'trigger' => $event, 'blocks' => $blocks, ); } }