@baijimu/cmodel 1.1.2 → 1.1.4

package/README.md

@@ -3,7 +3,7 @@
 Strict TypeScript types and parser for Baijimu CModel Error Contract `1.0.0`.
 
 ```bash
-npm install @baijimu/cmodel@1.1.2
+npm install @baijimu/cmodel@1.1.4
 ```
 
 ```ts
@@ -12,4 +12,10 @@ import { parseCModelResponse } from "@baijimu/cmodel";
 const response = parseCModelResponse(httpStatus, body, (value) => value);
 ```
 
+CModel producers return HTTP `200` for both success and business failure. Consumers determine the
+business outcome only from `errorCode`; non-zero values are failures. The parser temporarily accepts
+legacy non-`200` failure envelopes so services can roll forward without an atomic fleet deployment.
+
+An absent `contractVersion` is interpreted as CModel Error Contract `1.0.0`. Explicit versions are validated strictly and unsupported versions are rejected.
+
 The public package contains only the protocol types and validation logic. It does not include Baijimu's internal service catalog or internal data models. See <https://docs.baijimu.com/integration/cmodel-error-model/>.

package/dist/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AAIpB,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC;AAEhE,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,GACvB,cAAc,CAAC,CAAC,CAAC,CAwCnB"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AAIpB,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC;AAEhE,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,GACvB,cAAc,CAAC,CAAC,CAAC,CAoCnB"}

package/dist/parser.js

@@ -11,9 +11,9 @@ export class CModelContractError extends Error {
 export function parseCModelResponse(httpStatus, input, parseData) {
     const envelope = envelopeAt(input, "$");
     requiredKeys(envelope, "$", ["errorCode", "data"]);
-    const contractVersion = envelope.contractVersion === undefined
-        ? CONTRACT_VERSION
-        : stringAt(envelope.contractVersion, "$.contractVersion", 1, 64);
+    const contractVersion = "contractVersion" in envelope
+        ? stringAt(envelope.contractVersion, "$.contractVersion", 1, 64)
+        : CONTRACT_VERSION;
     if (contractVersion !== CONTRACT_VERSION) {
         fail("$.contractVersion", `unsupported contract version ${contractVersion}`);
     }
@@ -21,13 +21,12 @@ export function parseCModelResponse(httpStatus, input, parseData) {
     if (!codePattern.test(errorCode)) {
         fail("$.errorCode", "must be 0 or upper snake case");
     }
-    const httpSuccess = httpStatus >= 200 && httpStatus < 300;
-    if (httpStatus === 204) {
-        fail("$httpStatus", "CModel responses cannot use 204 No Content");
+    if (httpStatus !== 200 && (httpStatus < 400 || httpStatus > 599)) {
+        fail("$httpStatus", "a CModel response must use HTTP 200; only legacy 4xx/5xx failures are accepted during migration");
     }
     if (errorCode === "0") {
-        if (!httpSuccess) {
-            fail("$httpStatus", "non-2xx status cannot carry a success envelope");
+        if (httpStatus !== 200) {
+            fail("$httpStatus", "a CModel success response must use HTTP 200");
         }
         const data = envelope.data === null ? null : parseData(envelope.data, "$.data");
         return {
@@ -36,9 +35,6 @@ export function parseCModelResponse(httpStatus, input, parseData) {
             data,
         };
     }
-    if (httpSuccess) {
-        fail("$httpStatus", "2xx status cannot carry a failure envelope");
-    }
     if (envelope.data !== null) {
         fail("$.data", "failure response data must be null");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baijimu/cmodel",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "Strict TypeScript parser and types for the Baijimu CModel Error Contract",
   "type": "module",
   "main": "./dist/index.js",