@wp-typia/project-tools 0.14.0 → 0.15.0

package/templates/_shared/compound/persistence-public/{{slugKebabCase}}.php.mustache

@@ -195,6 +195,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;
+}
+
 // Route handlers are the main product-level extension point for parent-block request/response shaping.
 function {{phpPrefix}}_handle_get_state( WP_REST_Request $request ) {
 	$payload = {{phpPrefix}}_validate_and_sanitize_request(
@@ -221,6 +341,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(),
@@ -285,6 +432,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',
+			),
+		)
+	);
 }
 
 function {{phpPrefix}}_register_blocks() {

package/templates/_shared/persistence/auth/{{slugKebabCase}}.php.mustache

@@ -197,6 +197,105 @@ 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;
+	}
+
+	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 ) {
+	$post          = get_post( $post_id );
+	$can_read_post =
+		$post instanceof WP_Post &&
+		(
+			is_post_publicly_viewable( $post ) ||
+			current_user_can( 'read_post', $post->ID )
+		);
+	$can_write = $post_id > 0 &&
+		is_user_logged_in() &&
+		$can_read_post &&
+		{{phpPrefix}}_has_rendered_block_instance( (int) $post_id, (string) $resource_key );
+	$response  = array(
+		'canWrite' => $can_write,
+	);
+
+	if ( $can_write ) {
+		$response['restNonce'] = wp_create_nonce( 'wp_rest' );
+	}
+
+	return $response;
+}
+
 // Route handlers are the main product-level extension point for request/response shaping.
 function {{phpPrefix}}_handle_get_state( WP_REST_Request $request ) {
 	$payload = {{phpPrefix}}_validate_and_sanitize_request(
@@ -223,6 +322,34 @@ 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' );
+	$response->header( 'Vary', 'Cookie' );
+	return $response;
+}
+
 function {{phpPrefix}}_handle_write_state( WP_REST_Request $request ) {
 	$payload = {{phpPrefix}}_validate_and_sanitize_request(
 		$request->get_json_params(),
@@ -272,6 +399,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',
+			),
+		)
+	);
 }
 
 function {{phpPrefix}}_register_block() {

package/templates/_shared/persistence/core/scripts/sync-rest-contracts.ts.mustache

@@ -28,9 +28,15 @@ const REST_ENDPOINT_MANIFEST = defineEndpointManifest( {
 		'state-query': {
 			sourceTypeName: '{{pascalCase}}StateQuery',
 		},
+		'bootstrap-query': {
+			sourceTypeName: '{{pascalCase}}BootstrapQuery',
+		},
 		'write-state-request': {
 			sourceTypeName: '{{pascalCase}}WriteStateRequest',
 		},
+		'bootstrap-response': {
+			sourceTypeName: '{{pascalCase}}BootstrapResponse',
+		},
 		'state-response': {
 			sourceTypeName: '{{pascalCase}}StateResponse',
 		},
@@ -59,6 +65,16 @@ const REST_ENDPOINT_MANIFEST = defineEndpointManifest( {
 				mechanism: '{{restWriteAuthMechanism}}',
 			},
 		},
+		{
+			auth: 'public',
+			method: 'GET',
+			operationId: 'get{{pascalCase}}Bootstrap',
+			path: '/{{namespace}}/v1/{{slugKebabCase}}/bootstrap',
+			queryContract: 'bootstrap-query',
+			responseContract: 'bootstrap-response',
+			summary: 'Read fresh session bootstrap state for the current viewer.',
+			tags: [ '{{title}}' ],
+		},
 	],
 	info: {
 		title: '{{title}} REST API',

package/templates/_shared/persistence/core/src/api-types.ts.mustache

@@ -5,6 +5,11 @@ export interface {{pascalCase}}StateQuery {
 	resourceKey: string & tags.MinLength< 1 > & tags.MaxLength< 100 >;
 }
 
+export interface {{pascalCase}}BootstrapQuery {
+	postId: number & tags.Type< 'uint32' >;
+	resourceKey: string & tags.MinLength< 1 > & tags.MaxLength< 100 >;
+}
+
 export interface {{pascalCase}}WriteStateRequest {
 	postId: number & tags.Type< 'uint32' >;
 	{{publicWriteRequestIdDeclaration}}
@@ -13,6 +18,11 @@ export interface {{pascalCase}}WriteStateRequest {
 	delta?: number & tags.Minimum< 1 > & tags.Type< 'uint32' > & tags.Default< 1 >;
 }
 
+export interface {{pascalCase}}BootstrapResponse {
+	canWrite: boolean;
+	{{bootstrapCredentialDeclarations}}
+}
+
 export interface {{pascalCase}}StateResponse {
 	postId: number & tags.Type< 'uint32' >;
 	resourceKey: string & tags.MinLength< 1 > & tags.MaxLength< 100 >;

package/templates/_shared/persistence/core/src/api.ts.mustache

@@ -3,10 +3,12 @@ import {
 } from '@wp-typia/rest';
 
 import {
+	type {{pascalCase}}BootstrapQuery,
 	type {{pascalCase}}StateQuery,
 	type {{pascalCase}}WriteStateRequest,
 } from './api-types';
 import {
+	get{{pascalCase}}BootstrapEndpoint,
 	get{{pascalCase}}StateEndpoint,
 	write{{pascalCase}}StateEndpoint,
 } from './api-client';
@@ -15,6 +17,10 @@ import {
 	type PersistenceTransportOptions,
 } from './transport';
 
+export const bootstrapEndpoint = {
+	...get{{pascalCase}}BootstrapEndpoint,
+};
+
 export const stateEndpoint = {
 	...get{{pascalCase}}StateEndpoint,
 };
@@ -40,6 +46,23 @@ export function fetchState(
 	);
 }
 
+export function fetchBootstrap(
+	request: {{pascalCase}}BootstrapQuery,
+	options: PersistenceTransportOptions = {}
+) {
+	return callEndpoint(
+		bootstrapEndpoint,
+		request,
+		resolveTransportCallOptions(
+			options.transportTarget ?? 'frontend',
+			'read',
+			bootstrapEndpoint,
+			request,
+			options
+		)
+	);
+}
+
 export function writeState(
 	request: {{pascalCase}}WriteStateRequest,
 	options: PersistenceTransportOptions = {}

package/templates/_shared/persistence/core/src/data.ts.mustache

@@ -6,11 +6,14 @@ import {
 } from '@wp-typia/rest/react';
 
 import type {
+	{{pascalCase}}BootstrapQuery,
+	{{pascalCase}}BootstrapResponse,
 	{{pascalCase}}StateQuery,
 	{{pascalCase}}StateResponse,
 	{{pascalCase}}WriteStateRequest,
 } from './api-types';
 import {
+	bootstrapEndpoint,
 	stateEndpoint,
 	writeStateEndpoint,
 } from './api';
@@ -40,6 +43,20 @@ export interface Use{{pascalCase}}StateQueryOptions<
 	transportTarget?: PersistenceTransportTarget;
 }
 
+export interface Use{{pascalCase}}BootstrapQueryOptions<
+	Selected = {{pascalCase}}BootstrapResponse,
+> extends Omit<
+	UseEndpointQueryOptions<
+		{{pascalCase}}BootstrapQuery,
+		{{pascalCase}}BootstrapResponse,
+		Selected
+	>,
+	'resolveCallOptions'
+> {
+	restNonce?: string;
+	transportTarget?: PersistenceTransportTarget;
+}
+
 export interface UseWrite{{pascalCase}}StateMutationOptions<
 	Context = unknown,
 > extends Omit<
@@ -92,6 +109,34 @@ export function use{{pascalCase}}StateQuery<
 	} );
 }
 
+export function use{{pascalCase}}BootstrapQuery<
+	Selected = {{pascalCase}}BootstrapResponse,
+>(
+	request: {{pascalCase}}BootstrapQuery,
+	options: Use{{pascalCase}}BootstrapQueryOptions< Selected > = {}
+) {
+	const {
+		restNonce,
+		transportTarget = 'editor',
+		...queryOptions
+	} = options;
+
+	return useEndpointQuery( bootstrapEndpoint, request, {
+		...queryOptions,
+		resolveCallOptions: () =>
+			resolveTransportCallOptions(
+				transportTarget,
+				'read',
+				bootstrapEndpoint,
+				request,
+				{
+					restNonce,
+					transportTarget,
+				}
+			),
+	} );
+}
+
 export function useWrite{{pascalCase}}StateMutation<
 	Context = unknown,
 >(