@wp-typia/project-tools 0.14.0 → 0.15.0

package/templates/_shared/workspace/persistence-public/server.php.mustache

@@ -158,6 +158,126 @@ function {{phpPrefix}}_build_state_response( $post_id, $resource_key, $count ) {
 	);
 }
 
+function {{phpPrefix}}_block_tree_has_resource_key( $blocks, $block_name, $resource_key ) {
+	if ( ! is_array( $blocks ) ) {
+		return false;
+	}
+
+	foreach ( $blocks as $block ) {
+		if ( ! is_array( $block ) ) {
+			continue;
+		}
+
+		if ( (string) ( $block['blockName'] ?? '' ) === $block_name ) {
+			$attributes = isset( $block['attrs'] ) && is_array( $block['attrs'] ) ? $block['attrs'] : array();
+			$candidate_resource_key = array_key_exists( 'resourceKey', $attributes )
+				? (string) $attributes['resourceKey']
+				: 'primary';
+			if ( (string) $resource_key === $candidate_resource_key ) {
+				return true;
+			}
+		}
+
+		if (
+			isset( $block['innerBlocks'] ) &&
+			{{phpPrefix}}_block_tree_has_resource_key( $block['innerBlocks'], $block_name, $resource_key )
+		) {
+			return true;
+		}
+	}
+
+	return false;
+}
+
+function {{phpPrefix}}_get_rendered_block_instance_key( $post_id, $block_name, $resource_key ) {
+	return 'wpt_pri_' . md5( implode( '|', array( (string) $block_name, (int) $post_id, (string) $resource_key ) ) );
+}
+
+function {{phpPrefix}}_record_rendered_block_instance( $post_id, $block_name, $resource_key ) {
+	if ( $post_id <= 0 || '' === (string) $resource_key || '' === (string) $block_name ) {
+		return;
+	}
+
+	set_transient(
+		{{phpPrefix}}_get_rendered_block_instance_key( $post_id, $block_name, $resource_key ),
+		1,
+		5 * MINUTE_IN_SECONDS
+	);
+}
+
+function {{phpPrefix}}_has_rendered_block_instance( $post_id, $resource_key ) {
+	if ( $post_id <= 0 || '' === (string) $resource_key ) {
+		return false;
+	}
+
+	if (
+		false !== get_transient(
+			{{phpPrefix}}_get_rendered_block_instance_key(
+				$post_id,
+				'{{namespace}}/{{slugKebabCase}}',
+				$resource_key
+			)
+		)
+	) {
+		return true;
+	}
+
+	$post = get_post( $post_id );
+	if ( ! ( $post instanceof WP_Post ) ) {
+		return false;
+	}
+
+	if ( ! is_post_publicly_viewable( $post ) ) {
+		return false;
+	}
+
+	return {{phpPrefix}}_block_tree_has_resource_key(
+		parse_blocks( (string) $post->post_content ),
+		'{{namespace}}/{{slugKebabCase}}',
+		(string) $resource_key
+	);
+}
+
+function {{phpPrefix}}_build_bootstrap_response( $post_id, $resource_key ) {
+	$response = array(
+		'canWrite' => false,
+	);
+	$post = get_post( $post_id );
+
+	if (
+		$post_id <= 0 ||
+		! ( $post instanceof WP_Post ) ||
+		! is_post_publicly_viewable( $post ) ||
+		! function_exists( '{{phpPrefix}}_create_public_write_token' ) ||
+		! {{phpPrefix}}_has_rendered_block_instance( (int) $post_id, (string) $resource_key )
+	) {
+		return $response;
+	}
+
+	$public_write = {{phpPrefix}}_create_public_write_token( (int) $post_id, (string) $resource_key );
+	if ( ! is_array( $public_write ) ) {
+		return $response;
+	}
+
+	$token      = isset( $public_write['token'] ) ? (string) $public_write['token'] : '';
+	$expires_at = isset( $public_write['expiresAt'] ) ? (int) $public_write['expiresAt'] : 0;
+	$is_expired = $expires_at > 0 && $expires_at <= time();
+
+	if ( '' !== $token && $expires_at > 0 && ! $is_expired ) {
+		$response['publicWriteToken'] = $token;
+		$response['canWrite']         = true;
+	}
+
+	if ( $expires_at > 0 ) {
+		$response['publicWriteExpiresAt'] = $expires_at;
+		if ( $is_expired ) {
+			$response['canWrite'] = false;
+		}
+	}
+
+	return $response;
+}
+
 function {{phpPrefix}}_handle_get_state( WP_REST_Request $request ) {
 	$payload = {{phpPrefix}}_validate_and_sanitize_request(
 		array(
@@ -183,6 +303,33 @@ function {{phpPrefix}}_handle_get_state( WP_REST_Request $request ) {
 	);
 }
 
+function {{phpPrefix}}_handle_get_bootstrap( WP_REST_Request $request ) {
+	$payload = {{phpPrefix}}_validate_and_sanitize_request(
+		array(
+			'postId'      => $request->get_param( 'postId' ),
+			'resourceKey' => $request->get_param( 'resourceKey' ),
+		),
+		{{phpPrefix}}_get_rest_build_dir(),
+		'bootstrap-query',
+		'query'
+	);
+
+	if ( is_wp_error( $payload ) ) {
+		return $payload;
+	}
+
+	$response = rest_ensure_response(
+		{{phpPrefix}}_build_bootstrap_response(
+			(int) $payload['postId'],
+			(string) $payload['resourceKey']
+		)
+	);
+
+	$response->header( 'Cache-Control', 'no-store, no-cache, must-revalidate, max-age=0, s-maxage=0' );
+	$response->header( 'Pragma', 'no-cache' );
+	return $response;
+}
+
 function {{phpPrefix}}_handle_write_state( WP_REST_Request $request ) {
 	$payload = {{phpPrefix}}_validate_and_sanitize_request(
 		$request->get_json_params(),
@@ -246,6 +393,18 @@ function {{phpPrefix}}_register_routes() {
 			),
 		)
 	);
+
+	register_rest_route(
+		'{{namespace}}/v1',
+		'/{{slugKebabCase}}/bootstrap',
+		array(
+			array(
+				'methods'             => WP_REST_Server::READABLE,
+				'callback'            => '{{phpPrefix}}_handle_get_bootstrap',
+				'permission_callback' => '__return_true',
+			),
+		)
+	);
 }
 
 add_action( 'init', '{{phpPrefix}}_ensure_storage_installed' );

package/templates/persistence/src/edit.tsx.mustache

@@ -112,7 +112,7 @@ export default function Edit( {
 						{ persistencePolicyDescription }
 					</Notice>
 					<Notice status="info" isDismissible={ false }>
-						{ __( 'Render mode: dynamic. `render.php` bootstraps post context, storage-backed state, and write-policy data before hydration.', '{{textDomain}}' ) }
+						{ __( 'Render mode: dynamic. `render.php` bootstraps durable post context, while fresh session-only write data is loaded from the dedicated `/bootstrap` endpoint after hydration.', '{{textDomain}}' ) }
 					</Notice>
 				</InspectorFromManifest>
 				{ ! isValid && (

package/templates/persistence/src/render.php.mustache

@@ -35,45 +35,37 @@ $post_id            = is_object( $block ) && isset( $block->context['postId'] )
 	: (int) get_queried_object_id();
 $storage_mode       = '{{dataStorageMode}}';
 $persistence_policy = '{{persistencePolicy}}';
-$can_write          = false;
+
+{{phpPrefix}}_record_rendered_block_instance(
+	(int) $post_id,
+	'{{namespace}}/{{slugKebabCase}}',
+	$resource_key
+);
+
 $notice_message     = 'authenticated' === $persistence_policy
 	? __( 'Sign in to persist this counter.', '{{textDomain}}' )
-	: __( 'Reload the page to refresh this write token.', '{{textDomain}}' );
+	: __( 'Public writes are temporarily unavailable.', '{{textDomain}}' );
 $context            = array(
-	'buttonLabel'       => $button_label,
-	'canWrite'          => false,
-	'count'             => 0,
-	'isVisible'         => ! empty( $normalized['isVisible'] ),
-	'persistencePolicy' => $persistence_policy,
-	'postId'            => (int) $post_id,
-	'resourceKey'       => $resource_key,
-	'storage'           => $storage_mode,
+	'bootstrapReady'       => false,
+	'buttonLabel'          => $button_label,
+	'canWrite'             => false,
+	'client'               => array(
+		'writeExpiry' => 0,
+		'writeNonce'  => '',
+		'writeToken'  => '',
+	),
+	'count'                => 0,
+	'error'                => '',
+	'isBootstrapping'      => false,
+	'isLoading'            => false,
+	'isSaving'             => false,
+	'isVisible'            => ! empty( $normalized['isVisible'] ),
+	'persistencePolicy'    => $persistence_policy,
+	'postId'               => (int) $post_id,
+	'resourceKey'          => $resource_key,
+	'storage'              => $storage_mode,
 );
 
-if ( 'authenticated' === $persistence_policy ) {
-	$can_write = $post_id > 0 && is_user_logged_in();
-	if ( $can_write ) {
-		$context['restNonce'] = wp_create_nonce( 'wp_rest' );
-	}
-} elseif ( $post_id > 0 && function_exists( '{{phpPrefix}}_create_public_write_token' ) ) {
-	$public_write = {{phpPrefix}}_create_public_write_token( (int) $post_id, $resource_key );
-	if ( is_array( $public_write ) ) {
-		$token      = isset( $public_write['token'] ) ? (string) $public_write['token'] : '';
-		$expires_at = isset( $public_write['expiresAt'] ) ? (int) $public_write['expiresAt'] : 0;
-
-		if ( '' !== $token ) {
-			$context['publicWriteToken'] = $token;
-			$can_write                   = true;
-		}
-
-		if ( $expires_at > 0 ) {
-			$context['publicWriteExpiresAt'] = $expires_at;
-		}
-	}
-}
-
-$context['canWrite'] = $can_write;
-
 $wrapper_attributes = get_block_wrapper_attributes(
 	array(
 		'data-wp-context'       => wp_json_encode( $context ),
@@ -89,18 +81,20 @@ $wrapper_attributes = get_block_wrapper_attributes(
 		<p class="{{frontendCssClassName}}__content" style="<?php echo esc_attr( 'text-align:' . $alignment ); ?>">
 			<?php echo esc_html( $content ); ?>
 		</p>
-		<?php if ( ! $can_write ) : ?>
-			<p class="{{frontendCssClassName}}__notice">
-				<?php echo esc_html( $notice_message ); ?>
-			</p>
-		<?php endif; ?>
+		<p
+			class="{{frontendCssClassName}}__notice"
+			data-wp-bind--hidden="!context.bootstrapReady || context.canWrite"
+			hidden
+		>
+			<?php echo esc_html( $notice_message ); ?>
+		</p>
 		<p
 			class="{{frontendCssClassName}}__error"
 			role="status"
 			aria-live="polite"
 			aria-atomic="true"
-			data-wp-bind--hidden="!state.error"
-			data-wp-text="state.error"
+			data-wp-bind--hidden="!context.error"
+			data-wp-text="context.error"
 			hidden
 		></p>
 		<?php if ( ! empty( $normalized['showCount'] ) ) : ?>
@@ -109,14 +103,14 @@ $wrapper_attributes = get_block_wrapper_attributes(
 				role="status"
 				aria-live="polite"
 				aria-atomic="true"
-				data-wp-text="state.count"
+				data-wp-text="context.count"
 			>
 				0
 			</span>
 		<?php endif; ?>
 		<button
 			type="button"
-			<?php echo $can_write ? '' : 'disabled'; ?>
+			disabled
 			data-wp-bind--disabled="!context.canWrite"
 			data-wp-on--click="actions.increment"
 		>

package/templates/persistence/src/types.ts.mustache

@@ -30,26 +30,30 @@ export interface {{pascalCase}}Attributes {
 
 export interface {{pascalCase}}Context {
 	buttonLabel: string;
+	bootstrapReady: boolean;
 	canWrite: boolean;
 	count: number;
+	error: string;
+	isBootstrapping: boolean;
+	isLoading: boolean;
+	isSaving: boolean;
 	persistencePolicy: 'authenticated' | 'public';
 	postId: number;
-	publicWriteExpiresAt?: number;
-	publicWriteToken?: string;
 	resourceKey: string;
-	restNonce?: string;
 	storage: 'post-meta' | 'custom-table';
 	isVisible: boolean;
+	client?: {{pascalCase}}ClientState;
 }
 
 export interface {{pascalCase}}State {
-	canWrite: boolean;
-	count: number;
-	error?: string;
 	isHydrated: boolean;
-	isLoading: boolean;
-	isSaving: boolean;
-	isVisible: boolean;
+}
+
+export interface {{pascalCase}}ClientState {
+	bootstrapError: string;
+	writeExpiry: number;
+	writeNonce: string;
+	writeToken: string;
 }
 
 export type {{pascalCase}}ValidationResult = ValidationResult< {{pascalCase}}Attributes >;