@faasjs/react 8.0.0-beta.35 → 8.0.0-beta.36

package/README.md

@@ -6,7 +6,6 @@
 - [equal](functions/equal.md)
 - [faas](functions/faas.md)
 - [FaasReactClient](functions/FaasReactClient.md)
-- [generateId](functions/generateId.md)
 - [getClient](functions/getClient.md)
 - [OptionalWrapper](functions/OptionalWrapper.md)
 - [setMock](functions/setMock.md)

package/dist/index.d.ts

@@ -1,26 +1,6 @@
 import { Component, ComponentProps, ComponentType, Dispatch, ErrorInfo, JSX, ReactElement, ReactNode, RefObject, SetStateAction } from "react";
 import { FaasActionPaths, FaasData, FaasParams } from "@faasjs/types";
 
-//#region src/generate-id/index.d.ts
-/**
- * Generate a random identifier with an optional prefix.
- *
- * @param {string} [prefix] - Prefix prepended to the generated identifier.
- * @param {number} [length] - Length of the generated identifier excluding `prefix`. Must be between `8` and `18`.
- * @returns {string} Generated identifier string.
- * @throws {Error} When `length` is outside the supported `8` to `18` range.
- *
- * @example
- * ```ts
- * import { generateId } from '@faasjs/react'
- *
- * const id = generateId('prefix-')
- *
- * id.startsWith('prefix-') // true
- * ```
- */
-declare function generateId(prefix?: string, length?: number): string;
-//#endregion
 //#region src/browser/response.d.ts
 /**
  * Wrapper class for HTTP responses from FaasJS functions.
@@ -372,7 +352,7 @@ type FaasDataWrapperRef<Path extends FaasActionPaths> = FaasDataInjection<Path>;
  * export function UserProfile(props: { id: number }) {
  *   return (
  *     <FaasDataWrapper<User>
- *       action="/pages/users/get"
+ *       action="features/users/api/get"
  *       params={{ id: props.id }}
  *       fallback={<div>Loading user...</div>}
  *       render={({ data, error, reload }) => {
@@ -397,7 +377,7 @@ type FaasDataWrapperRef<Path extends FaasActionPaths> = FaasDataInjection<Path>;
  * export function UserProfileWithChildren(props: { id: number }) {
  *   return (
  *     <FaasDataWrapper<User>
- *       action="/pages/users/get"
+ *       action="features/users/api/get"
  *       params={{ id: props.id }}
  *       fallback={<div>Loading user...</div>}
  *     >
@@ -439,7 +419,7 @@ declare const FaasDataWrapper: <Path extends FaasActionPaths>(props: FaasDataWra
  *
  *     return <div>{data.name}</div>
  *   },
- *   { action: '/pages/users/get', params: { id: 1 } },
+ *   { action: 'features/users/api/get', params: { id: 1 } },
  * )
  * ```
  */
@@ -494,7 +474,7 @@ type UseFaasOptions<Path extends FaasActionPaths> = SharedUseFaasOptions<FaasPar
  * import { useFaas } from '@faasjs/react'
  *
  * function Profile({ id }: { id: number }) {
- *   const { data, error, loading, reload } = useFaas('/pages/users/get', { id })
+ *   const { data, error, loading, reload } = useFaas('features/users/api/get', { id })
  *
  *   if (loading) return <div>Loading...</div>
  *
@@ -625,7 +605,7 @@ declare function FaasReactClient(options?: FaasReactClientOptions): FaasReactCli
  *
  * const client = getClient('https://service-b.example.com/api/')
  *
- * await client.faas('/pages/posts/get', { id: 1 })
+ * await client.faas('features/posts/api/get', { id: 1 })
  * ```
  */
 declare function getClient(host?: string): FaasReactClientInstance;
@@ -719,7 +699,7 @@ declare class ErrorBoundary extends Component<ErrorBoundaryProps, {
   /**
    * Render children or the configured fallback for the captured error.
    */
-  render(): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null;
+  render(): string | number | bigint | boolean | import("react").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null;
 }
 //#endregion
 //#region src/equal/index.d.ts
@@ -866,7 +846,7 @@ type OptionalWrapperProps<TWrapper extends ComponentType<{
  * )
  * ```
  */
-declare function OptionalWrapper(props: OptionalWrapperProps): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null | undefined;
+declare function OptionalWrapper(props: OptionalWrapperProps): string | number | bigint | boolean | import("react").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null | undefined;
 declare namespace OptionalWrapper {
   var displayName: string;
 }
@@ -1067,7 +1047,7 @@ type UseFaasStreamResult<Path extends FaasActionPaths> = {
  * import { useFaasStream } from '@faasjs/react'
  *
  * function Chat({ prompt }: { prompt: string }) {
- *   const { data, error, loading, reload } = useFaasStream('/pages/chat/stream', { prompt })
+ *   const { data, error, loading, reload } = useFaasStream('features/chat/api/stream', { prompt })
  *
  *   if (loading) return <div>Streaming...</div>
  *
@@ -1137,4 +1117,4 @@ declare function usePrevious<T = any>(value: T): T | undefined;
 declare function useStateRef<T>(initialValue: T | (() => T)): [T, Dispatch<SetStateAction<T>>, RefObject<T>];
 declare function useStateRef<T = undefined>(): [T | undefined, Dispatch<SetStateAction<T | undefined>>, RefObject<T | undefined>];
 //#endregion
-export { type BaseUrl, ErrorBoundary, ErrorBoundaryProps, ErrorChildrenProps, FaasBrowserClient, type FaasBrowserClientAction, FaasDataInjection, FaasDataWrapper, FaasDataWrapperProps, FaasDataWrapperRef, FaasReactClient, FaasReactClientInstance, FaasReactClientOptions, type MockHandler, OnError, OptionalWrapper, OptionalWrapperProps, type Options, Response, ResponseError, type ResponseErrorProps, type ResponseHeaders, type ResponseProps, StateSetters, StatesWithSetters, UseFaasOptions, UseFaasStreamOptions, UseFaasStreamResult, createSplittingContext, equal, faas, generateId, getClient, setMock, useConstant, useEqualCallback, useEqualEffect, useEqualMemo, useEqualMemoize, useFaas, useFaasStream, usePrevious, useSplittingState, useStateRef, withFaasData };
+export { type BaseUrl, ErrorBoundary, ErrorBoundaryProps, ErrorChildrenProps, FaasBrowserClient, type FaasBrowserClientAction, FaasDataInjection, FaasDataWrapper, FaasDataWrapperProps, FaasDataWrapperRef, FaasReactClient, FaasReactClientInstance, FaasReactClientOptions, type MockHandler, OnError, OptionalWrapper, OptionalWrapperProps, type Options, Response, ResponseError, type ResponseErrorProps, type ResponseHeaders, type ResponseProps, StateSetters, StatesWithSetters, UseFaasOptions, UseFaasStreamOptions, UseFaasStreamResult, createSplittingContext, equal, faas, getClient, setMock, useConstant, useEqualCallback, useEqualEffect, useEqualMemo, useEqualMemoize, useFaas, useFaasStream, usePrevious, useSplittingState, useStateRef, withFaasData };

package/dist/index.mjs

@@ -1,28 +1,6 @@
+import { generateId } from "@faasjs/utils";
 import { Component, cloneElement, createContext, forwardRef, useCallback, useContext, useEffect, useImperativeHandle, useMemo, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
-//#region src/generate-id/index.ts
-/**
-* Generate a random identifier with an optional prefix.
-*
-* @param {string} [prefix] - Prefix prepended to the generated identifier.
-* @param {number} [length] - Length of the generated identifier excluding `prefix`. Must be between `8` and `18`.
-* @returns {string} Generated identifier string.
-* @throws {Error} When `length` is outside the supported `8` to `18` range.
-*
-* @example
-* ```ts
-* import { generateId } from '@faasjs/react'
-*
-* const id = generateId('prefix-')
-*
-* id.startsWith('prefix-') // true
-* ```
-*/
-function generateId(prefix = "", length = 18) {
-	if (length < 8 || length > 18) throw new Error("Length must be 8 ~ 18");
-	return `${prefix}${Date.now().toString(36).padStart(8, "0")}${Math.random().toString(36).substring(2, length - 6).padEnd(length - 8, "0")}`;
-}
-//#endregion
 //#region src/browser/response.ts
 /**
 * Wrapper class for HTTP responses from FaasJS functions.
@@ -650,7 +628,7 @@ function useEqualCallback(callback, dependencies) {
 * export function UserProfile(props: { id: number }) {
 *   return (
 *     <FaasDataWrapper<User>
-*       action="/pages/users/get"
+*       action="features/users/api/get"
 *       params={{ id: props.id }}
 *       fallback={<div>Loading user...</div>}
 *       render={({ data, error, reload }) => {
@@ -675,7 +653,7 @@ function useEqualCallback(callback, dependencies) {
 * export function UserProfileWithChildren(props: { id: number }) {
 *   return (
 *     <FaasDataWrapper<User>
-*       action="/pages/users/get"
+*       action="features/users/api/get"
 *       params={{ id: props.id }}
 *       fallback={<div>Loading user...</div>}
 *     >
@@ -748,7 +726,7 @@ Object.assign(FaasDataWrapper, { displayName: "FaasDataWrapper" });
 *
 *     return <div>{data.name}</div>
 *   },
-*   { action: '/pages/users/get', params: { id: 1 } },
+*   { action: 'features/users/api/get', params: { id: 1 } },
 * )
 * ```
 */
@@ -781,7 +759,7 @@ function withFaasData(Component, faasProps) {
 * ```ts
 * function useUserRequest(id: number) {
 *   return useFaasRequest({
-*     action: '/pages/users/get',
+*     action: 'features/users/api/get',
 *     defaultParams: { id },
 *     options: {},
 *     send: async ({ action, params, signal, client, setPromise }) => {
@@ -1016,7 +994,7 @@ function useFaasRequest({ action, defaultParams, options, beforeSend, onSuccess,
 * import { useFaas } from '@faasjs/react'
 *
 * function Profile({ id }: { id: number }) {
-*   const { data, error, loading, reload } = useFaas('/pages/users/get', { id })
+*   const { data, error, loading, reload } = useFaas('features/users/api/get', { id })
 *
 *   if (loading) return <div>Loading...</div>
 *
@@ -1165,7 +1143,7 @@ function FaasReactClient(options = { baseUrl: "/" }) {
 *
 * const client = getClient('https://service-b.example.com/api/')
 *
-* await client.faas('/pages/posts/get', { id: 1 })
+* await client.faas('features/posts/api/get', { id: 1 })
 * ```
 */
 function getClient(host) {
@@ -1448,7 +1426,7 @@ function createSplittingContext(defaultValue) {
 * import { useFaasStream } from '@faasjs/react'
 *
 * function Chat({ prompt }: { prompt: string }) {
-*   const { data, error, loading, reload } = useFaasStream('/pages/chat/stream', { prompt })
+*   const { data, error, loading, reload } = useFaasStream('features/chat/api/stream', { prompt })
 *
 *   if (loading) return <div>Streaming...</div>
 *
@@ -1571,4 +1549,4 @@ function useStateRef(initialValue) {
 	];
 }
 //#endregion
-export { ErrorBoundary, FaasBrowserClient, FaasDataWrapper, FaasReactClient, OptionalWrapper, Response, ResponseError, createSplittingContext, equal, faas, generateId, getClient, setMock, useConstant, useEqualCallback, useEqualEffect, useEqualMemo, useEqualMemoize, useFaas, useFaasStream, usePrevious, useSplittingState, useStateRef, withFaasData };
+export { ErrorBoundary, FaasBrowserClient, FaasDataWrapper, FaasReactClient, OptionalWrapper, Response, ResponseError, createSplittingContext, equal, faas, getClient, setMock, useConstant, useEqualCallback, useEqualEffect, useEqualMemo, useEqualMemoize, useFaas, useFaasStream, usePrevious, useSplittingState, useStateRef, withFaasData };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faasjs/react",
-  "version": "8.0.0-beta.35",
+  "version": "8.0.0-beta.36",
   "homepage": "https://faasjs.com/doc/react/",
   "bugs": {
     "url": "https://github.com/faasjs/faasjs/issues"
@@ -26,12 +26,14 @@
     }
   },
   "devDependencies": {
-    "@faasjs/types": ">=8.0.0-beta.35",
+    "@faasjs/types": ">=8.0.0-beta.36",
+    "@faasjs/utils": ">=8.0.0-beta.36",
     "@types/react": "^19.0.0",
     "react": "^19.0.0"
   },
   "peerDependencies": {
-    "@faasjs/types": ">=8.0.0-beta.35"
+    "@faasjs/types": ">=8.0.0-beta.36",
+    "@faasjs/utils": ">=8.0.0-beta.36"
   },
   "engines": {
     "node": ">=26.0.0",