@wp-typia/rest 0.3.7 → 0.3.8

package/README.md

@@ -18,19 +18,21 @@ resolution, use `@wp-typia/api-client`.
 ## Export contract
 
 - `@wp-typia/rest`
-  Canonical convenience surface for transport helpers plus HTTP decoder helpers.
+  Canonical convenience surface. It intentionally combines the transport helper
+  layer and the HTTP decoder helpers.
 - `@wp-typia/rest/client`
-  Backward-compatible alias of the root surface. It is not a distinct semantic
-  contract and may be removed in a future major once downstream imports settle.
+  Focused transport surface for endpoint creation, validated fetch helpers,
+  WordPress REST route resolution, validation utilities, and named runtime
+  errors.
 - `@wp-typia/rest/http`
-  Backward-compatible alias of the root surface. It remains publishable for
-  existing imports, but it is not a distinct decoder-only contract in the
-  current major line.
+  Focused decoder surface for query/header/parameter decoders plus the shared
+  validation helper utilities they return.
 - `@wp-typia/rest/react`
   React-only cache and hook layer.
 
-The root `@wp-typia/rest` entry stays transport-oriented. If you want query and
-mutation hooks on top of those WordPress helpers, use the React-only subpath:
+Prefer the root entry when you want the shortest import path. Reach for
+`./client` or `./http` when a narrower surface makes the consumer boundary
+clearer. Query and mutation hooks still live on the React-only subpath:
 
 ```ts
 import { useEndpointMutation, useEndpointQuery } from '@wp-typia/rest/react';
@@ -69,7 +71,7 @@ are reserved for public runtime misconfiguration or assertion APIs:
 If you need a canonical REST URL for a route path, use:
 
 ```ts
-import { resolveRestRouteUrl } from '@wp-typia/rest';
+import { resolveRestRouteUrl } from '@wp-typia/rest/client';
 
 const url = resolveRestRouteUrl('/my-namespace/v1/demo');
 ```
@@ -78,7 +80,7 @@ If you want Typia-powered HTTP decoding, compile the decoder in the consumer pro
 
 ```ts
 import typia from 'typia';
-import { createQueryDecoder } from '@wp-typia/rest';
+import { createQueryDecoder } from '@wp-typia/rest/http';
 
 const decodeQuery = createQueryDecoder(
   typia.http.createValidateQuery<MyQuery>(),

package/dist/client.d.ts

@@ -3,6 +3,7 @@ import type { EndpointValidationResult } from "@wp-typia/api-client";
 import { type ValidationLike, type ValidationResult } from "./internal/runtime-primitives.js";
 export type { ValidationError, ValidationLike, ValidationResult } from "./internal/runtime-primitives.js";
 export { isValidationResult, normalizeValidationError, toValidationResult } from "./internal/runtime-primitives.js";
+export { ApiClientConfigurationError, RestConfigurationError, RestRootResolutionError, RestValidationAssertionError, WpTypiaContractError, WpTypiaValidationAssertionError, } from "./errors.js";
 export type { EndpointRequestValidationResult, EndpointResponseValidationResult, EndpointValidationResult, EndpointValidationTarget, } from "@wp-typia/api-client";
 export interface ValidatedFetch<T> {
     assertFetch(options: APIFetchOptions): Promise<T>;

package/dist/client.js

@@ -2,6 +2,7 @@ import { encodeGetLikeRequest, joinPathWithQuery, joinUrlWithQuery, mergeHeaderI
 import { isFormDataLike, toValidationResult, } from "./internal/runtime-primitives.js";
 import { RestConfigurationError, RestRootResolutionError, RestValidationAssertionError, } from "./errors.js";
 export { isValidationResult, normalizeValidationError, toValidationResult } from "./internal/runtime-primitives.js";
+export { ApiClientConfigurationError, RestConfigurationError, RestRootResolutionError, RestValidationAssertionError, WpTypiaContractError, WpTypiaValidationAssertionError, } from "./errors.js";
 function getDefaultRestRoot() {
     if (typeof window !== "undefined") {
         const wpApiSettings = window.wpApiSettings;

package/dist/http.d.ts

@@ -1,5 +1,7 @@
 import type { IValidation } from "@typia/interface";
-import { type ValidationLike, type ValidationResult } from "./client.js";
+import { type ValidationLike, type ValidationResult } from "./internal/runtime-primitives.js";
+export type { ValidationError, ValidationLike, ValidationResult, } from "./internal/runtime-primitives.js";
+export { isValidationResult, normalizeValidationError, toValidationResult, } from "./internal/runtime-primitives.js";
 export declare function createQueryDecoder<T extends object>(validate?: (input: string | URLSearchParams) => ValidationLike<T> | IValidation<T>): (input: unknown) => ValidationResult<T>;
 export declare function createHeadersDecoder<T extends object>(validate?: (input: Record<string, string | string[] | undefined>) => ValidationLike<T> | IValidation<T>): (input: unknown) => ValidationResult<T>;
 export declare function createParameterDecoder<T extends string | number | boolean | bigint | null>(): (input: string) => T;

package/dist/http.js

@@ -1,4 +1,5 @@
-import { toValidationResult, } from "./client.js";
+import { toValidationResult, } from "./internal/runtime-primitives.js";
+export { isValidationResult, normalizeValidationError, toValidationResult, } from "./internal/runtime-primitives.js";
 function toHeadersRecord(input) {
     if (input instanceof Headers) {
         const record = {};

package/dist/react.d.ts

@@ -56,7 +56,7 @@ export interface UseEndpointMutationResult<Req, Res> {
     validation: EndpointValidationResult<Req, Res> | null;
 }
 export interface EndpointDataProviderProps {
-    children?: unknown;
+    children?: Parameters<typeof createElement>[2];
     client: EndpointDataClient;
 }
 export declare function createEndpointDataClient(): EndpointDataClient;

package/dist/react.js

@@ -127,6 +127,20 @@ function isEntryStale(entry, staleTime) {
 function asInternalClient(client) {
     return client;
 }
+function castEndpointValidationResult(validation) {
+    return validation;
+}
+function castEndpointValidationPromise(promise) {
+    return promise;
+}
+function selectEndpointData(data, select) {
+    if (select) {
+        return select(data);
+    }
+    // The default selector is identity, but TypeScript cannot express that when
+    // Selected is an unconstrained generic chosen by the caller.
+    return data;
+}
 function isInvalidValidationResult(validation) {
     return validation.isValid === false;
 }
@@ -249,11 +263,11 @@ export function createEndpointDataClient() {
         async __runQuery(cacheKey, execute, { force = false, staleTime }) {
             const entry = getOrCreateEntry(entries, cacheKey);
             if (entry.promise) {
-                return entry.promise;
+                return castEndpointValidationPromise(entry.promise);
             }
             if (!force) {
                 if (!isEntryStale(entry, staleTime) && entry.validation) {
-                    return entry.validation;
+                    return castEndpointValidationResult(entry.validation);
                 }
             }
             entry.error = null;
@@ -289,7 +303,7 @@ export function createEndpointDataClient() {
                 notify(cacheKey);
             });
             entry.promise = promise;
-            return promise;
+            return castEndpointValidationPromise(promise);
         },
         __seedData(cacheKey, data) {
             const entry = getOrCreateEntry(entries, cacheKey);
@@ -319,7 +333,9 @@ export function createEndpointDataClient() {
 }
 const defaultEndpointDataClient = createEndpointDataClient();
 export function EndpointDataProvider({ children, client, }) {
-    return createElement(EndpointDataClientContext.Provider, { value: client }, children);
+    return children === undefined
+        ? createElement(EndpointDataClientContext.Provider, { value: client })
+        : createElement(EndpointDataClientContext.Provider, { value: client }, children);
 }
 export function useEndpointDataClient() {
     return useContext(EndpointDataClientContext) ?? defaultEndpointDataClient;
@@ -382,9 +398,7 @@ export function useEndpointQuery(endpoint, request, options = {}) {
                     requestOptions: callOptions?.requestOptions,
                 }), { force, staleTime: latest.staleTime });
                 if (validation.isValid) {
-                    const selected = latest.select !== undefined
-                        ? latest.select(validation.data)
-                        : validation.data;
+                    const selected = selectEndpointData(validation.data, latest.select);
                     await latest.onSuccess?.(selected, validation);
                 }
                 return validation;
@@ -459,9 +473,7 @@ export function useEndpointQuery(endpoint, request, options = {}) {
         if (rawData === undefined) {
             return undefined;
         }
-        return select !== undefined
-            ? select(rawData)
-            : rawData;
+        return selectEndpointData(rawData, select);
     }, [initialData, select, snapshot.data, snapshot.validation]);
     return {
         data,
@@ -470,7 +482,9 @@ export function useEndpointQuery(endpoint, request, options = {}) {
         isLoading: snapshot.isFetching &&
             data === undefined,
         refetch,
-        validation: snapshot.validation,
+        validation: snapshot.validation === null
+            ? null
+            : castEndpointValidationResult(snapshot.validation),
     };
 }
 export function useEndpointMutation(endpoint, options = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/rest",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "Typed WordPress REST helpers powered by Typia validation",
   "type": "module",
   "main": "dist/index.js",
@@ -12,14 +12,14 @@
       "default": "./dist/index.js"
     },
     "./client": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "default": "./dist/client.js"
     },
     "./http": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "types": "./dist/http.d.ts",
+      "import": "./dist/http.js",
+      "default": "./dist/http.js"
     },
     "./react": {
       "types": "./dist/react.d.ts",