@chidchanun/bcp 0.1.19 → 0.1.20

package/docs/releases/0.1.20.md

@@ -0,0 +1,124 @@
+# BCP Framework 0.1.20
+
+BCP 0.1.20 introduces the Error Handling System: structured HTTP errors and consistent JSON error responses for APIs, form actions, guards, loaders and shared service code. It also hardens development hydration on Windows by normalizing source line endings before the React Refresh/Babel transform.
+
+## Highlights
+
+- Added the public `bcp/error` entrypoint.
+- Added `HttpError`, `createHttpError()`, `throwHttpError()` and `isHttpError()`.
+- Added `errorResponse()` and `toErrorResponse()`.
+- Added convenience response helpers for common statuses:
+  - `badRequest()` — 400
+  - `unauthorized()` — 401
+  - `forbidden()` — 403
+  - `notFoundResponse()` — 404
+  - `conflict()` — 409
+  - `unprocessableEntity()` — 422
+  - `tooManyRequests()` — 429
+  - `internalServerError()` — 500
+  - `serviceUnavailable()` — 503
+- Standardized the HTTP error payload around `status`, `code`, `message` and optional `details`.
+- Error responses default to `Cache-Control: no-store`.
+- `tooManyRequests()` can emit `Retry-After`.
+- Unknown exceptions passed to `toErrorResponse()` become a safe generic 500 response without exposing the original exception message.
+- Re-exported the HTTP error helpers through the server-only `bcp/server` entrypoint.
+- Kept `notFound()` and `notFoundResponse()` intentionally separate: page 404 UI versus JSON HTTP 404 response.
+- Fixed development hydration mismatches on Windows when CRLF source files contain multiline JSX/template-literal attributes such as multiline `className` values.
+- Development application source now normalizes `CRLF` and standalone `CR` to `LF` before the React Refresh Babel transform, matching SSR source semantics.
+- Added a CRLF development bundle regression fixture so the line-ending mismatch cannot silently return.
+- Added unit and publish-surface regression coverage.
+- Added the Error Handling and Hydration guides and updated the `bcp-docs` source map.
+
+## API example
+
+```ts
+import {
+    unauthorized,
+} from "bcp/error";
+
+export async function GET() {
+    const user = null;
+
+    if (!user) {
+        return unauthorized();
+    }
+
+    return Response.json({
+        user,
+    });
+}
+```
+
+## Validation example
+
+```ts
+import {
+    unprocessableEntity,
+} from "bcp/error";
+import {
+    v,
+} from "bcp/validation";
+
+const schema =
+    v.object({
+        email:
+            v.string({
+                email: true,
+            }),
+    });
+
+export async function POST(
+    request: Request
+) {
+    const result =
+        schema.safeParse(
+            await request.json()
+        );
+
+    if (!result.success) {
+        return unprocessableEntity(
+            "Validation failed",
+            {
+                fieldErrors:
+                    result.fieldErrors,
+            }
+        );
+    }
+
+    return Response.json(
+        result.data
+    );
+}
+```
+
+## Windows hydration fix
+
+The following pattern is valid BCP/React code and no longer requires a one-line workaround on CRLF checkouts:
+
+```tsx
+export default function Page() {
+    return (
+        <main
+            className={`
+                min-h-screen
+                bg-white
+                text-slate-950
+            `}
+        >
+            Hello
+        </main>
+    );
+}
+```
+
+Before the fix, the development Babel/React Refresh path could preserve carriage-return characters differently from the SSR transform. React then saw different attribute strings during hydration even though the Tailwind class list looked identical. BCP now normalizes the development source before Babel.
+
+This does not suppress genuine hydration errors from `Date.now()`, `Math.random()`, browser-only initial branches, locale differences, changing external data or invalid HTML.
+
+See `docs/hydration.md` for details and troubleshooting.
+
+## Compatibility
+
+0.1.20 is additive. Existing `Response`, `Response.json()`, `bcp/server` helpers, `notFound()`, route guards and form actions continue to work.
+
+Applications do not need to migrate existing error handling immediately. New code can adopt `bcp/error` incrementally.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chidchanun/bcp",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "BCP Framework - a React full-stack framework with file-based routing, SSR, APIs, middleware, islands, caching and standalone production builds.",
   "type": "module",
   "license": "MIT",
@@ -47,6 +47,10 @@
       "types": "./packages/client/src/validation.ts",
       "default": "./packages/client/src/validation.ts"
     },
+    "./error": {
+      "types": "./packages/client/src/http-error.ts",
+      "default": "./packages/client/src/http-error.ts"
+    },
     "./database": {
       "types": "./packages/client/src/database.ts",
       "browser": "./packages/client/src/server-only.browser.mjs",

package/packages/bundler/src/index.ts

@@ -608,9 +608,9 @@ if (!globalThis.__BCP_HMR_SOURCE__) {
             runtimeOutput,
 
         content:
-            fs.readFileSync(
-                runtimeOutput
-            ),
+                    fs.readFileSync(
+                        runtimeOutput
+                    ),
 
         contentType:
             "text/javascript; charset=utf-8",
@@ -1114,7 +1114,7 @@ export class DevClientBundler {
     /*
      * =================================
      * Module Graph
-     * =================================
+     * =====================================
      */
 
     private rebuildModuleGraph() {
@@ -1155,7 +1155,7 @@ export class DevClientBundler {
     /*
      * =================================
      * Find Affected Routes
-     * =================================
+     * =====================================
      */
 
     findAffectedRoutes(
@@ -1201,7 +1201,7 @@ export class DevClientBundler {
     /*
      * =================================
      * Debug Graph
-     * =================================
+     * =====================================
      */
 
     printAffectedRoutes(
@@ -1243,7 +1243,7 @@ export class DevClientBundler {
     /*
      * =================================
      * Bundles
-     * =================================
+     * =====================================
      */
 
     getBundles():
@@ -1259,7 +1259,7 @@ export class DevClientBundler {
     /*
      * =================================
      * Dispose
-     * =================================
+     * =====================================
      */
 
     async dispose() {
@@ -1649,6 +1649,15 @@ function createReactVendorPlugin():
     };
 }
 
+export function normalizeSourceLineEndings(
+    source: string
+): string {
+    return source.replace(
+        /\r\n?/g,
+        "\n"
+    );
+}
+
 /*
  * =====================================
  * React Refresh Plugin
@@ -1711,11 +1720,13 @@ function createReactRefreshPlugin(
                     }
 
                     const source =
-                        await fs.promises
-                            .readFile(
-                                args.path,
-                                "utf8"
-                            );
+                        normalizeSourceLineEndings(
+                            await fs.promises
+                                .readFile(
+                                    args.path,
+                                    "utf8"
+                                )
+                        );
 
                     const extension =
                         path.extname(