@bleedingdev/modern-js-app-tools 3.8.1-ultramodern.2 → 3.8.1-ultramodern.3

package/dist/cjs/presetUltramodern.js

@@ -79,7 +79,7 @@ const setReactRouterBridgeSafeAliases = (chain, { isProd })=>{
     chain.resolve.alias.set('react-router/dist/development/index.js', developmentEntry);
 };
 const createPresetUltramodernConfig = (options = {})=>{
-    const { appId = 'app', deliveryUnit, enableBffRequestId = true, enableTelemetry = true, enableTelemetryExporters, otlpEndpoint = process.env.MODERN_TELEMETRY_OTLP_ENDPOINT, victoriaMetricsEndpoint = process.env.MODERN_TELEMETRY_VICTORIA_ENDPOINT, telemetryFailLoudStartup = true, enableModuleFederationSSR = true } = options;
+    const { appId = 'app', deliveryUnit, enableBffRequestId = true, enableTelemetry = true, enableTelemetryExporters, otlpEndpoint = process.env.MODERN_TELEMETRY_OTLP_ENDPOINT, victoriaMetricsEndpoint = process.env.MODERN_TELEMETRY_VICTORIA_ENDPOINT, telemetryFailLoudStartup = false, enableModuleFederationSSR = true } = options;
     const server = {};
     const releaseIdentity = deliveryUnit ? (0, external_ultramodern_release_identity_js_namespaceObject.resolveUltramodernReleaseIdentity)({
         generationBuildMarker: deliveryUnit.buildMarker,

package/dist/esm/presetUltramodern.mjs

@@ -35,7 +35,7 @@ const setReactRouterBridgeSafeAliases = (chain, { isProd })=>{
     chain.resolve.alias.set('react-router/dist/development/index.js', developmentEntry);
 };
 const createPresetUltramodernConfig = (options = {})=>{
-    const { appId = 'app', deliveryUnit, enableBffRequestId = true, enableTelemetry = true, enableTelemetryExporters, otlpEndpoint = process.env.MODERN_TELEMETRY_OTLP_ENDPOINT, victoriaMetricsEndpoint = process.env.MODERN_TELEMETRY_VICTORIA_ENDPOINT, telemetryFailLoudStartup = true, enableModuleFederationSSR = true } = options;
+    const { appId = 'app', deliveryUnit, enableBffRequestId = true, enableTelemetry = true, enableTelemetryExporters, otlpEndpoint = process.env.MODERN_TELEMETRY_OTLP_ENDPOINT, victoriaMetricsEndpoint = process.env.MODERN_TELEMETRY_VICTORIA_ENDPOINT, telemetryFailLoudStartup = false, enableModuleFederationSSR = true } = options;
     const server = {};
     const releaseIdentity = deliveryUnit ? resolveUltramodernReleaseIdentity({
         generationBuildMarker: deliveryUnit.buildMarker,

package/dist/esm-node/presetUltramodern.mjs

@@ -36,7 +36,7 @@ const setReactRouterBridgeSafeAliases = (chain, { isProd })=>{
     chain.resolve.alias.set('react-router/dist/development/index.js', developmentEntry);
 };
 const createPresetUltramodernConfig = (options = {})=>{
-    const { appId = 'app', deliveryUnit, enableBffRequestId = true, enableTelemetry = true, enableTelemetryExporters, otlpEndpoint = process.env.MODERN_TELEMETRY_OTLP_ENDPOINT, victoriaMetricsEndpoint = process.env.MODERN_TELEMETRY_VICTORIA_ENDPOINT, telemetryFailLoudStartup = true, enableModuleFederationSSR = true } = options;
+    const { appId = 'app', deliveryUnit, enableBffRequestId = true, enableTelemetry = true, enableTelemetryExporters, otlpEndpoint = process.env.MODERN_TELEMETRY_OTLP_ENDPOINT, victoriaMetricsEndpoint = process.env.MODERN_TELEMETRY_VICTORIA_ENDPOINT, telemetryFailLoudStartup = false, enableModuleFederationSSR = true } = options;
     const server = {};
     const releaseIdentity = deliveryUnit ? resolveUltramodernReleaseIdentity({
         generationBuildMarker: deliveryUnit.buildMarker,

package/dist/types/presetUltramodern.d.ts

@@ -53,7 +53,7 @@ export interface PresetUltramodernOptions {
     /**
      * Enable fail-loud startup probing for telemetry exporters.
      * Probes only run for exporters that are actually enabled.
-     * @default true
+     * @default false
      */
     telemetryFailLoudStartup?: boolean;
     /**

package/docs/guides/advanced-features/bff/frameworks.md

@@ -8,12 +8,8 @@ Modern.js supports two BFF runtime frameworks:
 `effect` and `hono` are strict runtime modes. There is no automatic fallback between them.
 
 ::::info
-This page documents generic Modern.js runtime support. Generated UltraModern
-workspaces always use the `effect` runtime with
-`bff.effect.strictEffectApproach: true`. Add or change generated UltraModern
-HTTP API work through `shared/api.ts` and `api/index.ts`; do not add
-Hono/file-convention handlers, raw request parsing, or manual `Response`
-construction inside those workspaces.
+Generated UltraModern workspaces use strict Effect APIs: author HTTP APIs in
+`shared/api.ts` and `api/index.ts`, not Hono/file-convention handlers.
 ::::
 
 ## Switch to Effect runtime
@@ -121,6 +117,10 @@ const response = await api.client.hello.ping({});
 
 The `api.client.*` surface is materialized by the BFF loader for `@api/index` imports. Do not import `api/index` directly and expect `client` to run in server code, scripts, or tests; direct entry imports expose the server runtime definition, and `client` is only a typed placeholder there.
 
+For UltraModern, Effect `HttpApi` plus Effect BFF is the single blessed authored HTTP path. Use `HttpApi` endpoints with `query`, `params`, `payload`, `success`, and declared errors such as `HttpApiSchema.status(...)`; implement them with `HttpApiBuilder.group(...).handle(...)` and `HttpApiBuilder.layer(...).pipe(Layer.provide(...))`, then default-export the entry as `defineEffectBff({ api, layer })`. See `packages/cli/plugin-bff/tests/effect-httpapi-schema-validation.test.ts` for the real shapes.
+
+Hono and `api/lambda/**` are internal compatibility only and feature-frozen.
+
 ### Getting Request Context
 
 Sometimes in BFF functions, it's necessary to obtain the request context to handle more logic. In such cases, you can use `useHonoContext` to get it:

package/docs/llms.txt

@@ -47,7 +47,7 @@
 - [Deploy Application](/guides/basic-features/deploy.md): Currently, Modern.js offers two deployment way: You can host your application in a container that includes a Node.js environment on your own, which provides flexibility for the deployment of the application.You can also deploy your application through a platform. Currently, Modern.js officially supports deployment on Netlify, Vercel, and Github pages.
 - [BFF](/guides/advanced-features/bff.md): BFF (Backends for Frontends) is an architectural pattern primarily used to address issues of data aggregation in front-end and back-end collaboration. Under the BFF architecture, front-end applications do not communicate directly with backend services. Instead, they interact with backend services through a dedicated BFF middleware layer, custom-made for the front end. The main problems it tries to solve include: Aggregation, mapping, clipping, and proxying of lower-level APIs according to their own business needs.Cache data for some specific scenarios to improve performance and thus improve user experience.Quickly development of new products based on existing interfaces.Interface with third-party systems, such as login authentication. Modern.js officially supported the BFF and provided the Integrated BFF to further strengthen the BFF's capabilities, mainly including the following capabilities: Quick development and debugging go live, running, building, and deploying BFF code in the same project.Minimal pure function call, directly import BFF function on the front end, and can be automatically converted into HTTP request when called.No private protocol, follow RESTful API specification, all BFF interfaces are standardized.Full TypeScript support.Meet user preferences and support multi-frame extension writing.
 - [Basic Usage](/guides/advanced-features/bff/function.md): In a Modern.js application, developers can define API files under the api/lambda directory and export API functions from these files. In the frontend code, these API functions can be directly invoked by importing the file, which initiates the API requests. This invocation method is called unified invocation, where developers do not need to write glue code for the frontend and backend separately, thereby ensuring type safety across both.
-- [Runtime Framework](/guides/advanced-features/bff/frameworks.md): Modern.js supports two BFF runtime frameworks: effect (default): use Effect HttpApi runtime from api/index.hono: use file-convention BFF handlers from api/lambda/**. effect and hono are strict runtime modes. There is no automatic fallback between them. ::::info This page documents generic Modern.js runtime support. Generated UltraModern workspaces always use the effect runtime with bff.effect.strictEffectApproach: true. Add or change generated UltraModern HTTP API work through shared/api.ts and api/index.ts; do not add Hono/file-convention handlers, raw request parsing, or manual Response construction inside those workspaces. ::::
+- [Runtime Framework](/guides/advanced-features/bff/frameworks.md): Modern.js supports two BFF runtime frameworks: effect (default): use Effect HttpApi runtime from api/index.hono: use file-convention BFF handlers from api/lambda/**. effect and hono are strict runtime modes. There is no automatic fallback between them. ::::info Generated UltraModern workspaces use strict Effect APIs: author HTTP APIs in shared/api.ts and api/index.ts, not Hono/file-convention handlers. ::::
 - [Data Platform](/guides/advanced-features/bff/data-platform.md): Modern.js Effect API runtime now supports a request-envelope based data platform contract for safer and more predictable data orchestration in complex applications such as Module Federation and micro frontends.
 - [Creating Extensible BFF Functions](/guides/advanced-features/bff/operators.md): The previous section showed how to export a simple BFF function in a file. In more complex scenarios, each BFF function may need to do independent type validation, pre-logic, etc. Therefore, Modern.js exposes Api, which supports creating BFF functions through this API. BFF functions created in this way can be easily extended with functionality.
 - [Extend BFF Server](/guides/advanced-features/bff/extend-server.md): In some applications, developers may want to handle all BFF functions uniformly, such as authentication, logging, data processing, etc. Modern.js allows users to freely extend the BFF Server through Middleware method.

package/package.json

@@ -17,7 +17,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.8.1-ultramodern.2",
+  "version": "3.8.1-ultramodern.3",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/cjs/index.js",
   "exports": {
@@ -134,16 +134,16 @@
     "@babel/traverse": "^8.0.0",
     "@babel/types": "^8.0.0",
     "@loadable/component": "5.16.7",
-    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.8.1-ultramodern.2",
-    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.8.1-ultramodern.2",
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.8.1-ultramodern.2",
-    "@modern-js/plugin-data-loader": "npm:@bleedingdev/modern-js-plugin-data-loader@3.8.1-ultramodern.2",
-    "@modern-js/prod-server": "npm:@bleedingdev/modern-js-prod-server@3.8.1-ultramodern.2",
-    "@modern-js/server": "npm:@bleedingdev/modern-js-server@3.8.1-ultramodern.2",
-    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.8.1-ultramodern.2",
-    "@modern-js/server-utils": "npm:@bleedingdev/modern-js-server-utils@3.8.1-ultramodern.2",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.8.1-ultramodern.2",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.8.1-ultramodern.2",
+    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.8.1-ultramodern.3",
+    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.8.1-ultramodern.3",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.8.1-ultramodern.3",
+    "@modern-js/plugin-data-loader": "npm:@bleedingdev/modern-js-plugin-data-loader@3.8.1-ultramodern.3",
+    "@modern-js/prod-server": "npm:@bleedingdev/modern-js-prod-server@3.8.1-ultramodern.3",
+    "@modern-js/server": "npm:@bleedingdev/modern-js-server@3.8.1-ultramodern.3",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.8.1-ultramodern.3",
+    "@modern-js/server-utils": "npm:@bleedingdev/modern-js-server-utils@3.8.1-ultramodern.3",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.8.1-ultramodern.3",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.8.1-ultramodern.3",
     "@rsbuild/core": "2.1.5",
     "@swc/core": "1.15.43",
     "@swc/helpers": "^0.5.23",