<?php
/**
* StockNotificationsDataStore class file.
*/
declare( strict_types = 1 );
namespace Automattic\WooCommerce\Internal\DataStores\StockNotifications;
use Automattic\WooCommerce\Internal\StockNotifications\Notification;
use Automattic\WooCommerce\Internal\Utilities\DatabaseUtil;
use Automattic\WooCommerce\Internal\StockNotifications\Enums\NotificationStatus;
use Automattic\WooCommerce\Internal\StockNotifications\Utilities\EmailNormalizer;
defined( 'ABSPATH' ) || exit;
/**
* The Stock Notifications Data Store.
*/
class StockNotificationsDataStore implements \WC_Object_Data_Store_Interface {
/**
* The database util object to use.
*
* @var DatabaseUtil
*/
protected DatabaseUtil $database_util;
/**
* Handles custom metadata in the wc_stock_notificationmeta table.
*
* @var StockNotificationsMetaDataStore
*/
protected StockNotificationsMetaDataStore $data_store_meta;
/**
* Initialize.
*
* @internal
*
* @param StockNotificationsMetaDataStore $data_store_meta The data store meta instance to use.
* @param DatabaseUtil $database_util The database util instance to use.
*
* @return void
*/
final public function init( StockNotificationsMetaDataStore $data_store_meta, DatabaseUtil $database_util ) {
$this->data_store_meta = $data_store_meta;
$this->database_util = $database_util;
}
/**
* Get the stock notifications table name.
*
* @return string
*/
public function get_table_name(): string {
global $wpdb;
return $wpdb->prefix . 'wc_stock_notifications';
}
/**
* Get the stock notifications meta table name.
*
* @return string
*/
public function get_meta_table_name(): string {
return $this->data_store_meta->get_table_name();
}
/**
* Get the database schema.
*
* @return string
*/
public function get_database_schema(): string {
global $wpdb;
$collate = $wpdb->has_cap( 'collation' ) ? $wpdb->get_charset_collate() : '';
$table_name = $this->get_table_name();
$meta_table_name = $this->get_meta_table_name();
$max_index_length = $this->database_util->get_max_index_length();
$sql = "
CREATE TABLE $table_name (
id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
product_id bigint(20) unsigned NOT NULL,
user_id bigint(20) unsigned NOT NULL,
user_email varchar(100) NOT NULL,
status varchar(20) NOT NULL DEFAULT 'pending',
date_created_gmt datetime NULL,
date_modified_gmt datetime NULL,
date_confirmed_gmt datetime NULL,
date_last_attempt_gmt datetime NULL,
date_notified_gmt datetime NULL,
date_cancelled_gmt datetime NULL,
cancellation_source varchar(30) NULL,
PRIMARY KEY (id),
KEY product_status_attempt (product_id, status, date_last_attempt_gmt, id),
KEY user_lookup (user_id, product_id, status),
KEY email_lookup (user_email, product_id, status)
) $collate;
CREATE TABLE $meta_table_name (
id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
notification_id bigint(20) unsigned NOT NULL,
meta_key varchar(255) NULL,
meta_value longtext NULL,
PRIMARY KEY (id),
KEY notification_id (notification_id),
KEY meta_key (meta_key($max_index_length))
) $collate;
";
return $sql;
}
/**
* Filter the raw meta data.
*
* This is required due to the use of the WC_Data::read_meta_data() method.
* It's a post-specific method that used to filter internal meta data.
* For custom tables, technically there is no internal meta data,
* so this method is a no-op.
*
* @param Notification $notification The data object to filter.
* @param array $raw_meta_data The raw meta data to filter.
* @return array
*/
public function filter_raw_meta_data( &$notification, $raw_meta_data ): array {
return $raw_meta_data;
}
/**
* Get the internal meta keys.
*
* Required for the use of the WC_Data::is_internal_meta_key() method.
* It's a no-op for custom tables.
*
* @return array
*/
public function get_internal_meta_keys(): array {
return array();
}
/**
* Create a new stock notification.
*
* @param Notification $notification The data object to create.
* @return int|\WP_Error The notification ID on success. WP_Error on failure.
*/
public function create( &$notification ) {
global $wpdb;
// Fill in created and modified dates.
if ( ! $notification->get_date_created( 'edit' ) ) {
$notification->set_date_created( time() );
}
if ( ! $notification->get_date_modified( 'edit' ) ) {
$notification->set_date_modified( time() );
}
$insert = $wpdb->insert(
$this->get_table_name(),
array(
'product_id' => $notification->get_product_id( 'edit' ),
'user_id' => $notification->get_user_id( 'edit' ),
'user_email' => $notification->get_user_email( 'edit' ),
'status' => $notification->get_status( 'edit' ),
'date_created_gmt' => gmdate( 'Y-m-d H:i:s', $notification->get_date_created( 'edit' )->getTimestamp() ),
'date_modified_gmt' => gmdate( 'Y-m-d H:i:s', $notification->get_date_modified( 'edit' )->getTimestamp() ),
'date_confirmed_gmt' => $notification->get_date_confirmed( 'edit' ) ? gmdate( 'Y-m-d H:i:s', $notification->get_date_confirmed( 'edit' )->getTimestamp() ) : null,
'date_last_attempt_gmt' => $notification->get_date_last_attempt( 'edit' ) ? gmdate( 'Y-m-d H:i:s', $notification->get_date_last_attempt( 'edit' )->getTimestamp() ) : null,
'date_notified_gmt' => $notification->get_date_notified( 'edit' ) ? gmdate( 'Y-m-d H:i:s', $notification->get_date_notified( 'edit' )->getTimestamp() ) : null,
'date_cancelled_gmt' => $notification->get_date_cancelled( 'edit' ) ? gmdate( 'Y-m-d H:i:s', $notification->get_date_cancelled( 'edit' )->getTimestamp() ) : null,
'cancellation_source' => $notification->get_cancellation_source( 'edit' ),
),
array(
'%d',
'%d',
'%s',
'%s',
'%s',
'%s',
'%s',
'%s',
'%s',
'%s',
'%s',
)
);
if ( false === $insert ) {
return new \WP_Error( 'db_insert_error', 'Could not insert stock notification into the database.' );
}
$notification_id = (int) $wpdb->insert_id;
$notification->set_id( $notification_id );
$notification->save_meta_data();
$notification->apply_changes();
/**
* Action: woocommerce_new_stock_notification
*
* Fires after a stock notification is created, from any code path.
* With double opt-in the new notification is `pending` until the shopper verifies it, so
* integrations that only want confirmed sign-ups can wait for
* `woocommerce_stock_notification_status_changed` to `active` instead.
*
* @since 11.3.0
*
* @param int $notification_id The notification ID.
* @param Notification $notification The notification.
*/
do_action( 'woocommerce_new_stock_notification', $notification_id, $notification );
return $notification_id;
}
/**
* Read a stock notification.
*
* @param Notification $notification The data object to read.
*
* @throws \Exception If the stock notification is not found.
*
* @return void
*/
public function read( &$notification ) {
global $wpdb;
if ( 0 === $notification->get_id() ) {
throw new \Exception( 'Invalid notification ID.' );
}
$data = $wpdb->get_row(
$wpdb->prepare(
'SELECT * FROM %i WHERE id = %d',
$this->get_table_name(),
$notification->get_id()
)
);
if ( ! $data ) {
throw new \Exception( 'Stock notification not found' );
}
$notification->set_props(
array(
'id' => $data->id,
'product_id' => $data->product_id,
'user_id' => $data->user_id,
'user_email' => $data->user_email,
'status' => $data->status,
'date_created' => wc_string_to_timestamp( $data->date_created_gmt ),
'date_modified' => wc_string_to_timestamp( $data->date_modified_gmt ),
'date_confirmed' => wc_string_to_timestamp( $data->date_confirmed_gmt ),
'date_last_attempt' => wc_string_to_timestamp( $data->date_last_attempt_gmt ),
'date_notified' => wc_string_to_timestamp( $data->date_notified_gmt ),
'date_cancelled' => wc_string_to_timestamp( $data->date_cancelled_gmt ),
'cancellation_source' => $data->cancellation_source,
)
);
$notification->read_meta_data();
$notification->set_object_read( true );
}
/**
* Update a stock notification.
*
* @param Notification $notification The data object to update.
* @return int|\WP_Error The number of rows updated or WP_Error on failure.
*/
public function update( &$notification ) {
global $wpdb;
if ( 0 === $notification->get_id() ) {
return new \WP_Error( 'invalid_stock_notification', 'Invalid notification ID.' );
}
$changes = $notification->get_changes();
$result = 0;
$status_from = $notification->get_data()['status'];
$has_prop_changes = (bool) array_intersect( array( 'product_id', 'user_id', 'user_email', 'status', 'date_modified', 'date_confirmed', 'date_last_attempt', 'date_notified', 'date_cancelled', 'cancellation_source' ), array_keys( $changes ) );
if ( $has_prop_changes || $notification->has_meta_changes() ) {
if ( ! array_key_exists( 'date_modified', $changes ) ) {
$notification->set_date_modified( time() );
}
$result = $wpdb->update(
$this->get_table_name(),
array(
'product_id' => $notification->get_product_id( 'edit' ),
'user_id' => $notification->get_user_id( 'edit' ),
'user_email' => $notification->get_user_email( 'edit' ),
'status' => $notification->get_status( 'edit' ),
'date_created_gmt' => $notification->get_date_created( 'edit' ) ? gmdate( 'Y-m-d H:i:s', $notification->get_date_created( 'edit' )->getTimestamp() ) : null,
'date_modified_gmt' => gmdate( 'Y-m-d H:i:s', $notification->get_date_modified( 'edit' )->getTimestamp() ),
'date_confirmed_gmt' => $notification->get_date_confirmed( 'edit' ) ? gmdate( 'Y-m-d H:i:s', $notification->get_date_confirmed( 'edit' )->getTimestamp() ) : null,
'date_last_attempt_gmt' => $notification->get_date_last_attempt( 'edit' ) ? gmdate( 'Y-m-d H:i:s', $notification->get_date_last_attempt( 'edit' )->getTimestamp() ) : null,
'date_notified_gmt' => $notification->get_date_notified( 'edit' ) ? gmdate( 'Y-m-d H:i:s', $notification->get_date_notified( 'edit' )->getTimestamp() ) : null,
'date_cancelled_gmt' => $notification->get_date_cancelled( 'edit' ) ? gmdate( 'Y-m-d H:i:s', $notification->get_date_cancelled( 'edit' )->getTimestamp() ) : null,
'cancellation_source' => $notification->get_cancellation_source( 'edit' ),
),
array( 'id' => $notification->get_id() ),
array( '%d', '%d', '%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s' ),
array( '%d' )
);
if ( false === $result ) {
return new \WP_Error( 'db_update_error', 'Could not update stock notification in the database.' );
}
}
$notification->save_meta_data();
$notification->apply_changes();
$status_to = $notification->get_status( 'edit' );
/**
* Action: woocommerce_update_stock_notification
*
* Fires after a stock notification is updated, from any code path, whether or not anything changed.
* Also fires inside the back-in-stock send batch, so defer remote calls to Action Scheduler.
*
* @since 11.3.0
*
* @param int $notification_id The notification ID.
* @param Notification $notification The notification.
*/
do_action( 'woocommerce_update_stock_notification', $notification->get_id(), $notification );
if ( array_key_exists( 'status', $changes ) && $status_from !== $status_to ) {
/**
* Action: woocommerce_stock_notification_status_changed
*
* Fires after a stock notification's status is persisted with a different value, from any code path.
*
* @since 11.3.0
*
* @param int $notification_id The notification ID.
* @param string $status_from The previous status.
* @param string $status_to The new status.
* @param Notification $notification The notification.
*/
do_action( 'woocommerce_stock_notification_status_changed', $notification->get_id(), $status_from, $status_to, $notification );
}
return $result;
}
/**
* Delete a stock notification.
*
* @param Notification $notification The data object to delete.
* @param array $args Additional arguments.
* @return void
*/
public function delete( &$notification, $args = array() ) {
global $wpdb;
$notification_id = $notification->get_id();
$deleted = $wpdb->delete( $this->get_table_name(), array( 'id' => $notification_id ), array( '%d' ) );
if ( $deleted > 0 ) {
$this->data_store_meta->delete_by_notification_id( $notification_id );
/**
* Action: woocommerce_delete_stock_notification
*
* Fires after a stock notification is deleted, from any code path.
*
* @since 11.3.0
*
* @param int $notification_id The deleted notification ID.
* @param Notification $notification The notification, as it was before deletion.
*/
do_action( 'woocommerce_delete_stock_notification', $notification_id, $notification );
}
}
/**
* Add meta.
*
* @param Notification $notification The data object to add.
* @param \stdClass $meta The meta object to add (containing ->key and ->value).
* @return int|false The meta ID or false if the meta was not added.
*/
public function add_meta( &$notification, $meta ) {
$add_meta = $this->data_store_meta->add_meta( $notification, $meta );
return $add_meta ? $add_meta : false;
}
/**
* Read meta.
*
* @param Notification $notification The data object to read.
* @return array
*/
public function read_meta( &$notification ): array {
$raw_meta_data = $this->data_store_meta->read_meta( $notification );
return $this->filter_raw_meta_data( $notification, $raw_meta_data );
}
/**
* Update meta.
*
* @param Notification $notification The data object to update.
* @param \stdClass $meta The meta object to update (containing ->id, ->key and ->value).
* @return bool
*/
public function update_meta( &$notification, $meta ): bool {
return $this->data_store_meta->update_meta( $notification, $meta );
}
/**
* Delete meta.
*
* @param Notification $notification The data object to delete.
* @param \stdClass $meta The meta object to delete (containing at least ->id).
* @return bool
*/
public function delete_meta( &$notification, $meta ): bool {
return $this->data_store_meta->delete_meta( $notification, $meta );
}
/**
* Query the stock notifications.
*
* @param array $args The arguments.
* @return array<int>|array<Notification>|int An array of notifications or the number of notifications.
*/
public function query( array $args ) {
global $wpdb;
$args = wp_parse_args(
$args,
array(
'status' => '',
'product_id' => array(),
'user_id' => 0,
'user_email' => '',
'last_attempt_limit' => 0,
'start_date' => 0,
'end_date' => 0,
'limit' => -1,
'offset' => 0,
'order_by' => array( 'id' => 'ASC' ),
'return' => 'ids', // i.e. 'count', 'ids', 'objects'.
)
);
$table = $this->get_table_name();
$select = 'id';
if ( 'count' === $args['return'] ) {
$select = 'COUNT(id)';
} elseif ( 'objects' === $args['return'] ) {
$select = '*';
}
// WHERE clauses.
$where = array();
$where_values = array();
$statuses = array_filter(
array_map( 'strval', (array) $args['status'] ),
static function ( string $status ): bool {
return '' !== $status;
}
);
if ( ! empty( $statuses ) ) {
$where[] = 1 === count( $statuses )
? 'status = %s'
: 'status IN (' . implode( ',', array_fill( 0, count( $statuses ), '%s' ) ) . ')';
$where_values = array_merge( $where_values, array_values( $statuses ) );
}
if ( ! empty( $args['product_id'] ) ) {
$product_ids = array_map( 'absint', (array) $args['product_id'] );
$where[] = 'product_id IN (' . implode( ',', array_fill( 0, count( $product_ids ), '%d' ) ) . ')';
$where_values = array_merge( $where_values, $product_ids );
}
if ( $args['user_id'] ) {
$where[] = 'user_id = %d';
$where_values[] = absint( $args['user_id'] );
}
if ( $args['user_email'] ) {
$where[] = 'user_email = %s';
$where_values[] = EmailNormalizer::normalize( (string) $args['user_email'] );
}
if ( $args['last_attempt_limit'] > 0 ) {
$where[] = '(date_last_attempt_gmt < %s OR date_last_attempt_gmt IS NULL)';
$where_values[] = gmdate( 'Y-m-d H:i:s', $args['last_attempt_limit'] );
}
if ( $args['start_date'] ) {
$where[] = 'date_created_gmt >= %s';
$where_values[] = esc_sql( $args['start_date'] );
}
if ( $args['end_date'] ) {
$where[] = 'date_created_gmt < %s';
$where_values[] = esc_sql( $args['end_date'] );
}
// ORDER BY clauses.
$order_by = '';
$order_by_clauses = array();
// A COUNT() has no rows to sort, and ORDER BY on it fails under ONLY_FULL_GROUP_BY.
if ( 'count' !== $args['return'] && $args['order_by'] && is_array( $args['order_by'] ) ) {
foreach ( $args['order_by'] as $what => $how ) {
$order_by_clauses[] = $table . '.' . esc_sql( strval( $what ) ) . ' ' . esc_sql( strval( $how ) );
}
}
// Assemble the query.
$where = implode( ' AND ', $where );
$where = $where ? ' WHERE ' . $where : '';
$order_by = ! empty( $order_by_clauses ) ? ' ORDER BY ' . implode( ', ', $order_by_clauses ) : '';
$limit = $args['limit'] > 0 ? ' LIMIT ' . absint( $args['limit'] ) : '';
$offset = $args['offset'] > 0 ? ' OFFSET ' . absint( $args['offset'] ) : '';
$sql = "SELECT $select FROM $table $where $order_by $limit $offset";
// Prepare the query.
$prepared_sql = empty( $where_values ) ? $sql : $wpdb->prepare( $sql, $where_values ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
// Execute the query.
if ( 'count' === $args['return'] ) {
return (int) $wpdb->get_var( $prepared_sql ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
}
$results = $wpdb->get_results( $prepared_sql, ARRAY_A ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
if ( empty( $results ) || ! is_array( $results ) ) {
return array();
}
if ( 'objects' === $args['return'] ) {
return array_map(
function ( $result ) {
return new Notification( $result );
},
$results
);
}
return array_map(
function ( $result ) {
return absint( $result['id'] );
},
$results
);
}
/**
* Check if the product has active notifications.
*
* @param array<int> $product_ids The product IDs.
* @return bool True if the product has active notifications, false otherwise.
*/
public function product_has_active_notifications( array $product_ids ): bool {
global $wpdb;
$product_ids = array_filter( array_map( 'absint', $product_ids ) );
if ( empty( $product_ids ) ) {
return false;
}
$table = $this->get_table_name();
$format = array_fill( 0, count( $product_ids ), '%d' );
$query_in = '(' . implode( ',', $format ) . ')';
$sql = $wpdb->prepare( // phpcs:ignore WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber
"SELECT 1 FROM %i WHERE product_id IN $query_in AND status = %s LIMIT 1", // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared
array( $table, ...$product_ids, NotificationStatus::ACTIVE )
);
return (int) $wpdb->get_var( $sql ) > 0; // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
}
/**
* Check if a notification exists by email.
*
* @param int $product_id The product ID.
* @param string $email The email address.
* @return bool True if the notification exists, false otherwise.
*/
public function notification_exists_by_email( int $product_id, string $email ): bool {
$email = EmailNormalizer::normalize( $email );
if ( ! is_email( $email ) ) {
return false;
}
global $wpdb;
$table = $this->get_table_name();
$sql = $wpdb->prepare( // phpcs:ignore WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber
'SELECT 1 FROM %i WHERE product_id = %d AND user_email = %s AND status IN (%s, %s) LIMIT 1', // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared
array( $table, $product_id, $email, NotificationStatus::ACTIVE, NotificationStatus::PENDING )
);
return (int) $wpdb->get_var( $sql ) > 0; // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
}
/**
* Check if a notification exists by user ID.
*
* @param int $product_id The product ID.
* @param int $user_id The user ID.
* @return bool True if the notification exists, false otherwise.
*/
public function notification_exists_by_user_id( int $product_id, int $user_id ): bool {
if ( 0 === $user_id ) {
return false;
}
global $wpdb;
$table = $this->get_table_name();
$sql = $wpdb->prepare( // phpcs:ignore WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber
'SELECT 1 FROM %i WHERE product_id = %d AND user_id = %d AND status IN (%s, %s) LIMIT 1', // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared
array( $table, $product_id, $user_id, NotificationStatus::ACTIVE, NotificationStatus::PENDING )
);
return (int) $wpdb->get_var( $sql ) > 0; // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
}
/**
* Get the ID of the active or pending notification matching an identity, product and posted
* attribute set.
*
* The posted attributes are matched as the serialized string they are stored as, so the
* comparison is exact and case sensitive, but not sensitive to key order: both sides are
* sorted by key. An empty set matches any sign-up for the identity.
*
* @param int $product_id The product ID.
* @param int $user_id The user ID, or 0 to match on the email instead.
* @param string $user_email The email address, used when no user ID is given.
* @param array $posted_attributes The posted attributes to match.
* @return int The notification ID, or 0 when nothing matches.
*/
public function get_matching_notification_id( int $product_id, int $user_id, string $user_email, array $posted_attributes = array() ): int {
if ( empty( $product_id ) ) {
return 0;
}
if ( empty( $user_id ) ) {
$user_email = EmailNormalizer::normalize( $user_email );
if ( ! is_email( $user_email ) ) {
return 0;
}
}
global $wpdb;
$table = $this->get_table_name();
$identity_where = empty( $user_id ) ? 'user_email = %s' : 'user_id = %d';
$identity_value = empty( $user_id ) ? $user_email : $user_id;
if ( empty( $posted_attributes ) ) {
$sql = $wpdb->prepare( // phpcs:ignore WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber
"SELECT id FROM $table WHERE product_id = %d AND $identity_where AND status IN (%s, %s) LIMIT 1", // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared
array( $product_id, $identity_value, NotificationStatus::ACTIVE, NotificationStatus::PENDING )
);
return absint( $wpdb->get_var( $sql ) ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
}
// Sort by key so the serialized blob is the same whatever order the caller built the set in.
ksort( $posted_attributes );
$meta_table = $this->get_meta_table_name();
$sql = $wpdb->prepare( // phpcs:ignore WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber
"SELECT notifications.id FROM $table AS notifications INNER JOIN $meta_table AS meta ON meta.notification_id = notifications.id AND meta.meta_key = %s WHERE notifications.product_id = %d AND notifications.$identity_where AND notifications.status IN (%s, %s) AND BINARY meta.meta_value = %s LIMIT 1", // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared
array( 'posted_attributes', $product_id, $identity_value, NotificationStatus::ACTIVE, NotificationStatus::PENDING, maybe_serialize( $posted_attributes ) )
);
return absint( $wpdb->get_var( $sql ) ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
}
/**
* Get distinct notification creation dates.
*
* @return array
*/
public function get_distinct_dates() {
global $wpdb;
$results = $wpdb->get_results(
$wpdb->prepare(
'SELECT DISTINCT
YEAR(date_created_gmt) AS year,
MONTH(date_created_gmt) AS month
FROM %i
ORDER BY year DESC, month DESC',
$this->get_table_name()
)
);
return $results;
}
/**
* Count the notifications of each status.
*
* @return array<string, int> Map of status to the number of notifications in it.
*/
public function count_by_status(): array {
global $wpdb;
$table = $this->get_table_name();
$results = $wpdb->get_results(
"SELECT status, COUNT(id) AS total FROM $table GROUP BY status", // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared
ARRAY_A
);
$counts = array();
foreach ( (array) $results as $result ) {
$counts[ (string) $result['status'] ] = (int) $result['total'];
}
return $counts;
}
}