@fluojs/serialization 1.0.0-beta.5 → 1.0.0

package/README.ko.md

@@ -109,6 +109,8 @@ fluo의 직렬화 엔진은 활성 순환 참조를 자동으로 감지하고 `u
 
 기반 클래스에 선언한 직렬화 메타데이터는 파생 DTO에도 상속됩니다. 공통 필드에 적용한 `@Expose()`, `@Exclude()`, `@Transform()` 규칙은 서브클래스 인스턴스를 직렬화할 때도 그대로 반영됩니다.
 
+Class-level `excludeExtraneous`도 일반 상속 규칙을 따릅니다. 파생 클래스에 option 없는 `@Expose()`를 붙여도 가장 가까운 상속 설정이 유지되므로, expose-only 기반 DTO는 subclass에서도 expose-only 상태를 유지합니다. 일반 enumerable field를 다시 포함하려는 의도가 있을 때만 파생 클래스에 `@Expose({ excludeExtraneous: false })`를 명시하세요. 이 경우에도 상속된 field-level `@Exclude()` metadata는 계속 적용됩니다.
+
 Decorated metadata가 없는 class instance도 재귀적으로 순회하므로, parent object에 serialization metadata가 없어도 decorated nested descendant는 반영됩니다.
 
 ### 일반 객체 안전성

package/README.md

@@ -109,6 +109,8 @@ The serializer cuts active cyclic references safely instead of recursing forever
 
 Serialization metadata declared on a base class is inherited by derived DTOs. `@Expose()`, `@Exclude()`, and `@Transform()` rules applied to shared base fields still take effect when you serialize subclass instances.
 
+Class-level `excludeExtraneous` also follows normal inheritance. A derived class with `@Expose()` and no options keeps the nearest inherited setting, so an expose-only base DTO remains expose-only in subclasses. Use `@Expose({ excludeExtraneous: false })` on the derived class only when you intentionally want to re-enable ordinary enumerable fields while still honoring inherited field-level `@Exclude()` metadata.
+
 Undecorated class instances are still traversed recursively, so decorated nested descendants are respected even when the parent object has no serialization metadata.
 
 ### Plain-object safety

package/dist/decorators/expose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expose.d.ts","sourceRoot":"","sources":["../../src/decorators/expose.ts"],"names":[],"mappings":"AAIA,KAAK,wBAAwB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAC1F,KAAK,wBAAwB,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;AAG1H,KAAK,yBAAyB,GAAG,wBAAwB,GAAG,wBAAwB,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,yBAAyB,CAmB9E"}
+{"version":3,"file":"expose.d.ts","sourceRoot":"","sources":["../../src/decorators/expose.ts"],"names":[],"mappings":"AAIA,KAAK,wBAAwB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAC1F,KAAK,wBAAwB,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;AAG1H,KAAK,yBAAyB,GAAG,wBAAwB,GAAG,wBAAwB,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,yBAAyB,CAqB9E"}

package/dist/decorators/expose.js

@@ -25,9 +25,11 @@ import { updateClassSerializationOptions, updateFieldSerializationMetadata } fro
 export function Expose(options) {
   const decorator = (_value, context) => {
     if (context.kind === 'class') {
-      updateClassSerializationOptions(context.metadata, {
-        excludeExtraneous: options?.excludeExtraneous
-      });
+      if (Object.prototype.hasOwnProperty.call(options ?? {}, 'excludeExtraneous')) {
+        updateClassSerializationOptions(context.metadata, {
+          excludeExtraneous: options?.excludeExtraneous
+        });
+      }
       return;
     }
     updateFieldSerializationMetadata(context.metadata, context.name, current => ({

package/package.json

@@ -9,7 +9,7 @@
     "output",
     "transform"
   ],
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -36,8 +36,8 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/core": "^1.0.0-beta.4",
-    "@fluojs/http": "^1.0.0-beta.10"
+    "@fluojs/core": "^1.0.0",
+    "@fluojs/http": "^1.0.0"
   },
   "devDependencies": {
     "vitest": "^3.2.4"