@bleedingdev/modern-js-bff-core 3.9.0-ultramodern.2 → 3.9.0-ultramodern.20

package/dist/esm/client/generateClient.mjs

@@ -1,22 +1,18 @@
+import { pathToFileURL } from "node:url";
 import { ApiRouter } from "../router/index.mjs";
-import { buildOperationContractMap, createOperationSchemaHash, deriveOperationVersion } from "../security/operationContracts.mjs";
 import { Err, Ok } from "./result.mjs";
 import * as __rspack_external_path from "path";
-const getPackageInfo = (appDir)=>{
-    try {
-        const packageJsonPath = __rspack_external_path.resolve(appDir, './package.json');
-        const packageJson = require(packageJsonPath);
-        return {
-            name: packageJson.name,
-            version: packageJson.version
-        };
-    } catch (error) {
-        return {};
+class ClientCodegenError extends Error {
+    constructor(plugin, cause){
+        super(`BFF client code-generation plugin failed: ${plugin}`, {
+            cause
+        });
+        this.name = 'ClientCodegenError';
     }
-};
+}
 const INNER_CLIENT_REQUEST_CREATOR = '@modern-js/plugin-bff/client';
-const generateClient = async ({ appDir, resourcePath, apiDir, lambdaDir, prefix, port, target, requestCreator, fetcher, requireResolve = require.resolve, httpMethodDecider, domain, requestId })=>{
-    requestCreator = requestCreator || INNER_CLIENT_REQUEST_CREATOR;
+const generateClient = async (options)=>{
+    const { appDir, resourcePath, apiDir, lambdaDir, prefix, port, target, fetcher, requireResolve = require.resolve, httpMethodDecider, domain, requestId, clientCodegenPlugin } = options;
     const apiRouter = new ApiRouter({
         appDir,
         apiDir,
@@ -26,131 +22,61 @@ const generateClient = async ({ appDir, resourcePath, apiDir, lambdaDir, prefix,
     });
     const handlerInfos = await apiRouter.getSingleModuleHandlers(resourcePath);
     if (!handlerInfos) return Err(`generate client error: Cannot require module ${resourcePath}`);
-    const normalizedRequestId = requestId || 'default';
-    const operationVersion = deriveOperationVersion(getPackageInfo(appDir).version);
-    const operationContracts = buildOperationContractMap({
-        handlers: handlerInfos,
-        requestId: normalizedRequestId,
-        operationVersion
-    });
-    const operationEntries = handlerInfos.map((handlerInfo)=>{
-        const upperHttpMethod = handlerInfo.httpMethod.toUpperCase();
-        const contract = operationContracts[`${upperHttpMethod}:${handlerInfo.routePath}`];
-        return {
-            name: handlerInfo.name,
-            httpMethod: upperHttpMethod,
-            routePath: handlerInfo.routePath,
-            schemaHash: contract?.schemaHash ?? ''
-        };
-    }).sort((a, b)=>{
-        const keyA = `${a.routePath}:${a.httpMethod}:${a.name}`;
-        const keyB = `${b.routePath}:${b.httpMethod}:${b.name}`;
-        return keyA.localeCompare(keyB);
-    });
-    const schemaHash = createOperationSchemaHash(operationEntries, normalizedRequestId);
-    let hasUploadHandler = false;
-    let handlersCode = '';
-    for (const handlerInfo of handlerInfos){
-        const { name, httpMethod, routePath, action } = handlerInfo;
-        let exportStatement = `var ${name} =`;
-        if ('default' === name.toLowerCase()) exportStatement = 'default';
-        const upperHttpMethod = httpMethod.toUpperCase();
-        const operationSchemaHash = operationContracts[`${upperHttpMethod}:${routePath}`]?.schemaHash ?? '';
-        const operationContext = {
-            operationId: name,
-            routePath,
-            method: upperHttpMethod,
-            schemaHash: operationSchemaHash,
-            operationVersion
-        };
-        if ('upload' === action) {
-            hasUploadHandler = true;
-            const uploadOptions = {
-                path: routePath,
-                ...domain ? {
-                    domain
-                } : {},
-                ...requestId ? {
-                    requestId
-                } : {},
-                ...requestId ? {
-                    operationContext
-                } : {}
+    const draft = {
+        requestCreator: options.requestCreator || INNER_CLIENT_REQUEST_CREATOR,
+        imports: fetcher ? [
+            `import { fetch } from ${JSON.stringify(fetcher)};`
+        ] : [],
+        statements: [],
+        handlers: handlerInfos.map((handlerInfo)=>{
+            const optionProperties = [
+                `path: ${JSON.stringify(handlerInfo.routePath)}`
+            ];
+            if ('upload' !== handlerInfo.action) {
+                const portExpression = 'server' === target ? `process.env.PORT || ${String(port)}` : String(port);
+                optionProperties.push(`method: ${JSON.stringify(handlerInfo.httpMethod.toUpperCase())}`, `port: ${portExpression}`, `httpMethodDecider: ${JSON.stringify(httpMethodDecider || 'functionName')}`);
+            }
+            if (domain) optionProperties.push(`domain: ${JSON.stringify(domain)}`);
+            if (fetcher && 'upload' !== handlerInfo.action) optionProperties.push('fetch');
+            if (requestId) optionProperties.push(`requestId: ${JSON.stringify(requestId)}`);
+            return {
+                handlerInfo,
+                optionProperties
             };
-            handlersCode += `export ${exportStatement} createUploader(${JSON.stringify(uploadOptions)});
-      `;
-            continue;
-        }
-        const portExpression = 'server' === target ? `process.env.PORT || ${String(port)}` : String(port);
-        const requestOptionProperties = [
-            `path: ${JSON.stringify(routePath)}`,
-            `method: ${JSON.stringify(upperHttpMethod)}`,
-            `port: ${portExpression}`,
-            `httpMethodDecider: ${JSON.stringify(httpMethodDecider ? httpMethodDecider : 'functionName')}`
-        ];
-        if (domain) requestOptionProperties.push(`domain: ${JSON.stringify(domain)}`);
-        if (fetcher) requestOptionProperties.push('fetch');
-        if (requestId) requestOptionProperties.push(`requestId: ${JSON.stringify(requestId)}`);
-        requestOptionProperties.push(`operationContext: ${JSON.stringify(operationContext)}`);
-        handlersCode += `export ${exportStatement} createRequest({ ${requestOptionProperties.join(', ')} });
-      `;
+        })
+    };
+    if (clientCodegenPlugin) try {
+        const specifier = clientCodegenPlugin.startsWith('.') ? __rspack_external_path.resolve(appDir, clientCodegenPlugin) : clientCodegenPlugin;
+        const resolved = requireResolve(specifier, {
+            paths: [
+                appDir
+            ]
+        });
+        const extension = await import(pathToFileURL(resolved).href);
+        const modifyClient = extension.modifyClient ?? extension.default?.modifyClient;
+        if ('function' != typeof modifyClient) throw new TypeError('The module must export a modifyClient function.');
+        await modifyClient(draft, {
+            options,
+            handlerInfos
+        });
+    } catch (cause) {
+        throw new ClientCodegenError(clientCodegenPlugin, cause);
     }
-    const serializedRequestCreator = JSON.stringify(requestCreator);
-    const serializedFetcher = fetcher ? JSON.stringify(fetcher) : void 0;
-    const namedRequestImports = `createRequest${hasUploadHandler ? ', createUploader' : ''}`;
-    const importCode = requestId ? `import * as requestRuntime from ${serializedRequestCreator};
-const { ${namedRequestImports} } = requestRuntime;
-${serializedFetcher ? `import { fetch } from ${serializedFetcher};\n` : ''}` : `import { ${namedRequestImports} } from ${serializedRequestCreator};
-${serializedFetcher ? `import { fetch } from ${serializedFetcher};\n` : ''}`;
-    const bootstrapCode = requestId ? `export const initProducerClient = (options = {}) => {
-  const configure = requestRuntime.configure;
-  if (typeof configure !== 'function') {
-    console.warn('[modernjs] Compatibility request creator path does not expose configure(); use default @modern-js/create-request or migrate the compatibility path.');
-    return undefined;
-  }
-  const defaultSecureOptions = {
-    requestId: ${JSON.stringify(requestId)},
-    requireEnvelope: true,
-    identityBinding: {
-      enabled: true,
-      strict: true,
-    },
-    operationContract: {
-      enabled: true,
-      strict: true,
-      requireSchemaHash: true,
-      requireOperationVersion: true,
-    },
-  };
-  return configure({
-    ...defaultSecureOptions,
-    ...options,
-    identityBinding: {
-      ...defaultSecureOptions.identityBinding,
-      ...(options && options.identityBinding ? options.identityBinding : {}),
-    },
-    operationContract: {
-      ...defaultSecureOptions.operationContract,
-      ...(options && options.operationContract ? options.operationContract : {}),
-    },
-  });
-};
-` : '';
-    const manifestCode = `export const operationVersion = ${String(operationVersion)};
-export const operationSchemaHash = '${schemaHash}';
-export const operationManifest = ${JSON.stringify({
-        operationVersion,
-        schemaHash,
-        operations: operationEntries
-    }, null, 2)};
-`;
-    const generatedParts = [
-        importCode.trimEnd(),
-        bootstrapCode.trimEnd(),
-        manifestCode.trimEnd(),
-        handlersCode.trimEnd()
-    ].filter(Boolean);
-    return Ok(`${generatedParts.join('\n\n')}
-`);
+    const hasUploadHandler = handlerInfos.some((info)=>'upload' === info.action);
+    const requestImports = `createRequest${hasUploadHandler ? ', createUploader' : ''}`;
+    const importCode = [
+        `import { ${requestImports} } from ${JSON.stringify(draft.requestCreator)};`,
+        ...draft.imports
+    ].join('\n');
+    const handlersCode = draft.handlers.map(({ handlerInfo, optionProperties })=>{
+        const exportStatement = 'default' === handlerInfo.name.toLowerCase() ? 'default' : `var ${handlerInfo.name} =`;
+        const creator = 'upload' === handlerInfo.action ? 'createUploader' : 'createRequest';
+        return `export ${exportStatement} ${creator}({ ${optionProperties.join(', ')} });`;
+    }).join('\n');
+    return Ok(`${[
+        importCode,
+        ...draft.statements,
+        handlersCode
+    ].filter(Boolean).join('\n\n')}\n`);
 };
-export { INNER_CLIENT_REQUEST_CREATOR, generateClient };
+export { ClientCodegenError, INNER_CLIENT_REQUEST_CREATOR, generateClient };

package/dist/esm/index.mjs

@@ -1,11 +1,7 @@
-export * from "./adapter-kit/index.mjs";
 export * from "./client/index.mjs";
 export * from "./operators/http.mjs";
 export * from "./router/index.mjs";
-export * from "./security/crossProjectPolicy.mjs";
-export * from "./security/operationContracts.mjs";
-export * from "./security/resolveCrossProjectPolicy.mjs";
 export * from "./types.mjs";
 export { Api } from "./api.mjs";
 export { HttpError, ValidationError } from "./errors/http.mjs";
-export { HANDLER_WITH_META, INPUT_PARAMS_DECIDER, createStorage, getRelativeRuntimePath, isInputParamsDeciderHandler, isWithMetaHandler, registerPaths } from "./utils/index.mjs";
+export { HANDLER_WITH_META, INPUT_PARAMS_DECIDER, createStorage, isInputParamsDeciderHandler, isWithMetaHandler } from "./utils/index.mjs";

package/dist/esm/router/index.mjs

@@ -88,10 +88,11 @@ class ApiRouter {
                     if ('test' !== process.env.NODE_ENV) logger.warn(`Only api handlers are allowd to be exported, please remove the function ${originHandlerName} from exports`);
                     return null;
             }
+        } else {
+            if (!handler) return null;
+            if ('function' == typeof handler && handler.length > 0) return HttpMethod.Post;
+            return HttpMethod.Get;
         }
-        if (!handler) return null;
-        if ('function' == typeof handler && handler.length > 0) return HttpMethod.Post;
-        return HttpMethod.Get;
     }
     getAction(handler) {
         if (handler) {
@@ -140,9 +141,10 @@ class ApiRouter {
                     cause: err
                 });
                 throw error;
+            } else {
+                console.error(`Failed to load BFF module '${filename}':`, err);
+                return null;
             }
-            console.error(`Failed to load BFF module '${filename}':`, err);
-            return null;
         }
     }
     getHandlerInfos(moduleInfos) {

package/dist/esm/utils/index.mjs

@@ -1,4 +1,3 @@
-export * from "./alias.mjs";
 export * from "./meta.mjs";
 export * from "./storage.mjs";
 export * from "./validate.mjs";

package/dist/esm-node/client/generateClient.mjs

@@ -1,24 +1,20 @@
 import __rslib_shim_module__ from "node:module";
 const require = /*#__PURE__*/ __rslib_shim_module__.createRequire(/*#__PURE__*/ (()=>import.meta.url)());
+import { pathToFileURL } from "node:url";
 import { ApiRouter } from "../router/index.mjs";
-import { buildOperationContractMap, createOperationSchemaHash, deriveOperationVersion } from "../security/operationContracts.mjs";
 import { Err, Ok } from "./result.mjs";
 import * as __rspack_external_path from "path";
-const getPackageInfo = (appDir)=>{
-    try {
-        const packageJsonPath = __rspack_external_path.resolve(appDir, './package.json');
-        const packageJson = require(packageJsonPath);
-        return {
-            name: packageJson.name,
-            version: packageJson.version
-        };
-    } catch (error) {
-        return {};
+class ClientCodegenError extends Error {
+    constructor(plugin, cause){
+        super(`BFF client code-generation plugin failed: ${plugin}`, {
+            cause
+        });
+        this.name = 'ClientCodegenError';
     }
-};
+}
 const INNER_CLIENT_REQUEST_CREATOR = '@modern-js/plugin-bff/client';
-const generateClient = async ({ appDir, resourcePath, apiDir, lambdaDir, prefix, port, target, requestCreator, fetcher, requireResolve = require.resolve, httpMethodDecider, domain, requestId })=>{
-    requestCreator = requestCreator || INNER_CLIENT_REQUEST_CREATOR;
+const generateClient = async (options)=>{
+    const { appDir, resourcePath, apiDir, lambdaDir, prefix, port, target, fetcher, requireResolve = require.resolve, httpMethodDecider, domain, requestId, clientCodegenPlugin } = options;
     const apiRouter = new ApiRouter({
         appDir,
         apiDir,
@@ -28,131 +24,61 @@ const generateClient = async ({ appDir, resourcePath, apiDir, lambdaDir, prefix,
     });
     const handlerInfos = await apiRouter.getSingleModuleHandlers(resourcePath);
     if (!handlerInfos) return Err(`generate client error: Cannot require module ${resourcePath}`);
-    const normalizedRequestId = requestId || 'default';
-    const operationVersion = deriveOperationVersion(getPackageInfo(appDir).version);
-    const operationContracts = buildOperationContractMap({
-        handlers: handlerInfos,
-        requestId: normalizedRequestId,
-        operationVersion
-    });
-    const operationEntries = handlerInfos.map((handlerInfo)=>{
-        const upperHttpMethod = handlerInfo.httpMethod.toUpperCase();
-        const contract = operationContracts[`${upperHttpMethod}:${handlerInfo.routePath}`];
-        return {
-            name: handlerInfo.name,
-            httpMethod: upperHttpMethod,
-            routePath: handlerInfo.routePath,
-            schemaHash: contract?.schemaHash ?? ''
-        };
-    }).sort((a, b)=>{
-        const keyA = `${a.routePath}:${a.httpMethod}:${a.name}`;
-        const keyB = `${b.routePath}:${b.httpMethod}:${b.name}`;
-        return keyA.localeCompare(keyB);
-    });
-    const schemaHash = createOperationSchemaHash(operationEntries, normalizedRequestId);
-    let hasUploadHandler = false;
-    let handlersCode = '';
-    for (const handlerInfo of handlerInfos){
-        const { name, httpMethod, routePath, action } = handlerInfo;
-        let exportStatement = `var ${name} =`;
-        if ('default' === name.toLowerCase()) exportStatement = 'default';
-        const upperHttpMethod = httpMethod.toUpperCase();
-        const operationSchemaHash = operationContracts[`${upperHttpMethod}:${routePath}`]?.schemaHash ?? '';
-        const operationContext = {
-            operationId: name,
-            routePath,
-            method: upperHttpMethod,
-            schemaHash: operationSchemaHash,
-            operationVersion
-        };
-        if ('upload' === action) {
-            hasUploadHandler = true;
-            const uploadOptions = {
-                path: routePath,
-                ...domain ? {
-                    domain
-                } : {},
-                ...requestId ? {
-                    requestId
-                } : {},
-                ...requestId ? {
-                    operationContext
-                } : {}
+    const draft = {
+        requestCreator: options.requestCreator || INNER_CLIENT_REQUEST_CREATOR,
+        imports: fetcher ? [
+            `import { fetch } from ${JSON.stringify(fetcher)};`
+        ] : [],
+        statements: [],
+        handlers: handlerInfos.map((handlerInfo)=>{
+            const optionProperties = [
+                `path: ${JSON.stringify(handlerInfo.routePath)}`
+            ];
+            if ('upload' !== handlerInfo.action) {
+                const portExpression = 'server' === target ? `process.env.PORT || ${String(port)}` : String(port);
+                optionProperties.push(`method: ${JSON.stringify(handlerInfo.httpMethod.toUpperCase())}`, `port: ${portExpression}`, `httpMethodDecider: ${JSON.stringify(httpMethodDecider || 'functionName')}`);
+            }
+            if (domain) optionProperties.push(`domain: ${JSON.stringify(domain)}`);
+            if (fetcher && 'upload' !== handlerInfo.action) optionProperties.push('fetch');
+            if (requestId) optionProperties.push(`requestId: ${JSON.stringify(requestId)}`);
+            return {
+                handlerInfo,
+                optionProperties
             };
-            handlersCode += `export ${exportStatement} createUploader(${JSON.stringify(uploadOptions)});
-      `;
-            continue;
-        }
-        const portExpression = 'server' === target ? `process.env.PORT || ${String(port)}` : String(port);
-        const requestOptionProperties = [
-            `path: ${JSON.stringify(routePath)}`,
-            `method: ${JSON.stringify(upperHttpMethod)}`,
-            `port: ${portExpression}`,
-            `httpMethodDecider: ${JSON.stringify(httpMethodDecider ? httpMethodDecider : 'functionName')}`
-        ];
-        if (domain) requestOptionProperties.push(`domain: ${JSON.stringify(domain)}`);
-        if (fetcher) requestOptionProperties.push('fetch');
-        if (requestId) requestOptionProperties.push(`requestId: ${JSON.stringify(requestId)}`);
-        requestOptionProperties.push(`operationContext: ${JSON.stringify(operationContext)}`);
-        handlersCode += `export ${exportStatement} createRequest({ ${requestOptionProperties.join(', ')} });
-      `;
+        })
+    };
+    if (clientCodegenPlugin) try {
+        const specifier = clientCodegenPlugin.startsWith('.') ? __rspack_external_path.resolve(appDir, clientCodegenPlugin) : clientCodegenPlugin;
+        const resolved = requireResolve(specifier, {
+            paths: [
+                appDir
+            ]
+        });
+        const extension = await import(pathToFileURL(resolved).href);
+        const modifyClient = extension.modifyClient ?? extension.default?.modifyClient;
+        if ('function' != typeof modifyClient) throw new TypeError('The module must export a modifyClient function.');
+        await modifyClient(draft, {
+            options,
+            handlerInfos
+        });
+    } catch (cause) {
+        throw new ClientCodegenError(clientCodegenPlugin, cause);
     }
-    const serializedRequestCreator = JSON.stringify(requestCreator);
-    const serializedFetcher = fetcher ? JSON.stringify(fetcher) : void 0;
-    const namedRequestImports = `createRequest${hasUploadHandler ? ', createUploader' : ''}`;
-    const importCode = requestId ? `import * as requestRuntime from ${serializedRequestCreator};
-const { ${namedRequestImports} } = requestRuntime;
-${serializedFetcher ? `import { fetch } from ${serializedFetcher};\n` : ''}` : `import { ${namedRequestImports} } from ${serializedRequestCreator};
-${serializedFetcher ? `import { fetch } from ${serializedFetcher};\n` : ''}`;
-    const bootstrapCode = requestId ? `export const initProducerClient = (options = {}) => {
-  const configure = requestRuntime.configure;
-  if (typeof configure !== 'function') {
-    console.warn('[modernjs] Compatibility request creator path does not expose configure(); use default @modern-js/create-request or migrate the compatibility path.');
-    return undefined;
-  }
-  const defaultSecureOptions = {
-    requestId: ${JSON.stringify(requestId)},
-    requireEnvelope: true,
-    identityBinding: {
-      enabled: true,
-      strict: true,
-    },
-    operationContract: {
-      enabled: true,
-      strict: true,
-      requireSchemaHash: true,
-      requireOperationVersion: true,
-    },
-  };
-  return configure({
-    ...defaultSecureOptions,
-    ...options,
-    identityBinding: {
-      ...defaultSecureOptions.identityBinding,
-      ...(options && options.identityBinding ? options.identityBinding : {}),
-    },
-    operationContract: {
-      ...defaultSecureOptions.operationContract,
-      ...(options && options.operationContract ? options.operationContract : {}),
-    },
-  });
-};
-` : '';
-    const manifestCode = `export const operationVersion = ${String(operationVersion)};
-export const operationSchemaHash = '${schemaHash}';
-export const operationManifest = ${JSON.stringify({
-        operationVersion,
-        schemaHash,
-        operations: operationEntries
-    }, null, 2)};
-`;
-    const generatedParts = [
-        importCode.trimEnd(),
-        bootstrapCode.trimEnd(),
-        manifestCode.trimEnd(),
-        handlersCode.trimEnd()
-    ].filter(Boolean);
-    return Ok(`${generatedParts.join('\n\n')}
-`);
+    const hasUploadHandler = handlerInfos.some((info)=>'upload' === info.action);
+    const requestImports = `createRequest${hasUploadHandler ? ', createUploader' : ''}`;
+    const importCode = [
+        `import { ${requestImports} } from ${JSON.stringify(draft.requestCreator)};`,
+        ...draft.imports
+    ].join('\n');
+    const handlersCode = draft.handlers.map(({ handlerInfo, optionProperties })=>{
+        const exportStatement = 'default' === handlerInfo.name.toLowerCase() ? 'default' : `var ${handlerInfo.name} =`;
+        const creator = 'upload' === handlerInfo.action ? 'createUploader' : 'createRequest';
+        return `export ${exportStatement} ${creator}({ ${optionProperties.join(', ')} });`;
+    }).join('\n');
+    return Ok(`${[
+        importCode,
+        ...draft.statements,
+        handlersCode
+    ].filter(Boolean).join('\n\n')}\n`);
 };
-export { INNER_CLIENT_REQUEST_CREATOR, generateClient };
+export { ClientCodegenError, INNER_CLIENT_REQUEST_CREATOR, generateClient };

package/dist/esm-node/index.mjs

@@ -1,12 +1,8 @@
 import "node:module";
-export * from "./adapter-kit/index.mjs";
 export * from "./client/index.mjs";
 export * from "./operators/http.mjs";
 export * from "./router/index.mjs";
-export * from "./security/crossProjectPolicy.mjs";
-export * from "./security/operationContracts.mjs";
-export * from "./security/resolveCrossProjectPolicy.mjs";
 export * from "./types.mjs";
 export { Api } from "./api.mjs";
 export { HttpError, ValidationError } from "./errors/http.mjs";
-export { HANDLER_WITH_META, INPUT_PARAMS_DECIDER, createStorage, getRelativeRuntimePath, isInputParamsDeciderHandler, isWithMetaHandler, registerPaths } from "./utils/index.mjs";
+export { HANDLER_WITH_META, INPUT_PARAMS_DECIDER, createStorage, isInputParamsDeciderHandler, isWithMetaHandler } from "./utils/index.mjs";

package/dist/esm-node/router/index.mjs

@@ -89,10 +89,11 @@ class ApiRouter {
                     if ('test' !== process.env.NODE_ENV) logger.warn(`Only api handlers are allowd to be exported, please remove the function ${originHandlerName} from exports`);
                     return null;
             }
+        } else {
+            if (!handler) return null;
+            if ('function' == typeof handler && handler.length > 0) return HttpMethod.Post;
+            return HttpMethod.Get;
         }
-        if (!handler) return null;
-        if ('function' == typeof handler && handler.length > 0) return HttpMethod.Post;
-        return HttpMethod.Get;
     }
     getAction(handler) {
         if (handler) {
@@ -141,9 +142,10 @@ class ApiRouter {
                     cause: err
                 });
                 throw error;
+            } else {
+                console.error(`Failed to load BFF module '${filename}':`, err);
+                return null;
             }
-            console.error(`Failed to load BFF module '${filename}':`, err);
-            return null;
         }
     }
     getHandlerInfos(moduleInfos) {

package/dist/esm-node/utils/index.mjs

@@ -1,5 +1,4 @@
 import "node:module";
-export * from "./alias.mjs";
 export * from "./meta.mjs";
 export * from "./storage.mjs";
 export * from "./validate.mjs";

package/dist/types/client/generateClient.d.ts

@@ -1,4 +1,5 @@
 import type { HttpMethodDecider } from '@modern-js/types';
+import { type APIHandlerInfo } from '../router/index.js';
 import { type Result } from './result.js';
 export type GenClientResult = Result<string>;
 export type GenClientOptions = {
@@ -16,6 +17,28 @@ export type GenClientOptions = {
     httpMethodDecider?: HttpMethodDecider;
     domain?: string;
     requestId?: string;
+    /** Node module exporting a modifyClient code-generation transform. */
+    clientCodegenPlugin?: string;
 };
+export interface ClientHandlerDraft {
+    readonly handlerInfo: APIHandlerInfo;
+    /** Source expressions, including native server port and fetch bindings. */
+    optionProperties: string[];
+}
+export interface ClientModuleDraft {
+    requestCreator: string;
+    imports: string[];
+    statements: string[];
+    readonly handlers: readonly ClientHandlerDraft[];
+}
+export interface ClientCodegenContext {
+    readonly options: Readonly<GenClientOptions>;
+    readonly handlerInfos: readonly APIHandlerInfo[];
+}
+export type ClientCodegenPlugin = (draft: ClientModuleDraft, context: ClientCodegenContext) => void | Promise<void>;
+/** A failed transform must not be downgraded to best-effort publication. */
+export declare class ClientCodegenError extends Error {
+    constructor(plugin: string, cause: unknown);
+}
 export declare const INNER_CLIENT_REQUEST_CREATOR = "@modern-js/plugin-bff/client";
-export declare const generateClient: ({ appDir, resourcePath, apiDir, lambdaDir, prefix, port, target, requestCreator, fetcher, requireResolve, httpMethodDecider, domain, requestId, }: GenClientOptions) => Promise<GenClientResult>;
+export declare const generateClient: (options: GenClientOptions) => Promise<GenClientResult>;

package/dist/types/index.d.ts

@@ -1,12 +1,8 @@
-export * from './adapter-kit/index.js';
 export { Api } from './api.js';
 export * from './client/index.js';
 export type * from './compatible.js';
 export { HttpError, ValidationError } from './errors/http.js';
 export * from './operators/http.js';
 export * from './router/index.js';
-export * from './security/crossProjectPolicy.js';
-export * from './security/operationContracts.js';
-export * from './security/resolveCrossProjectPolicy.js';
 export * from './types.js';
-export { createStorage, getRelativeRuntimePath, HANDLER_WITH_META, INPUT_PARAMS_DECIDER, isInputParamsDeciderHandler, isWithMetaHandler, registerPaths, } from './utils/index.js';
+export { createStorage, HANDLER_WITH_META, INPUT_PARAMS_DECIDER, isInputParamsDeciderHandler, isWithMetaHandler, } from './utils/index.js';

package/dist/types/utils/index.d.ts

@@ -1,4 +1,3 @@
-export * from './alias.js';
 export { debug } from './debug.js';
 export * from './meta.js';
 export * from './storage.js';