@operato/twin-kernel 0.7.57 → 0.7.58

package/dist/face2-adapter.d.ts

@@ -29,6 +29,22 @@ export interface ObjectEventMapping {
      * 사건이 정답을 다시 말해 주고 오차가 쌓이지 않는다(시뮬 `consumeMaterials` 가 택한 것과 같은 규약).
      */
     quantityList?: MapValue;
+    /**
+     * **개체·로트의 마스터데이터** → `ilmd`(EPCIS 2.0 Instance/Lot Master Data).
+     *
+     * ── 왜 뒤늦게 생겼나 (2026-08-24 실측) ─────────────────────────────────────
+     * `quantityList` 와 **똑같은 모양의 결함**이었다: 받는 쪽은 처음부터 준비돼 있는데 **문이 없었다.**
+     * `ObservedReducer` 는 `ilmd` 를 읽어 로트와 소비기한을 세운다(`expiryOf` · `ILMD_ATTR.lot`), 그리고
+     * 이름을 모르는 속성도 버리지 않고 원문으로 든다. 그런데 이 매핑에 자리가 없어서 **커넥터가 그것을
+     * 말할 길이 없었다.**
+     *
+     * 실측(포천): 원본 재고 1,704행 **전부**에 소비기한이 있는데 투영된 상태에는 **0건**이었다. 지난
+     * 재고 950건·59,785kg 이 어디에도 나타나지 않았다 — 화면이 비어 있는 것이 「이상 없음」으로 읽혔다.
+     *
+     * 값은 **객체 그대로** 받는다(`{ 'cbvmda:lotNumber': …, 'cbvmda:itemExpirationDate': … }`). 키 어휘는
+     * 표준(CBV MDA)의 것이고 커널이 `ILMD_ATTR` 로 그 이름을 안다 — 여기서 이름을 다시 정하지 않는다.
+     */
+    ilmd?: MapValue;
     readPoint?: MapValue;
     bizLocation?: MapValue;
 }

package/dist/face2-adapter.js

@@ -99,6 +99,26 @@ function resolveQuantityList(v, record, field, errors) {
     }
     return r.map(x => ({ ...x }));
 }
+/**
+ * 객체 하나를 그대로 꺼낸다 — `ilmd` 처럼 **구조가 곧 값**인 자리.
+ *
+ * `resolve` 는 객체가 오면 오류로 본다(스칼라 자리에 표준 구조를 실은 것이 실제 결함이었다). 여기서는
+ * 반대다: 객체가 맞고 스칼라가 틀렸다. 그래서 함수를 갈라 두고 각자 자기 모양을 단정한다.
+ */
+function resolveObject(v, record, field, errors) {
+    if (v === undefined)
+        return undefined;
+    const r = get(record, v.startsWith('$.') ? v.slice(2) : v);
+    if (r === undefined || r === null)
+        return undefined;
+    if (typeof r !== 'object' || Array.isArray(r)) {
+        errors.push(`${field} 가 객체가 아니다(${v}): ${JSON.stringify(r).slice(0, 80)}`);
+        return undefined;
+    }
+    const o = { ...r };
+    /* 빈 객체는 「말하지 않은 것」이다 — 실으면 소비처가 「마스터데이터가 있는데 비었다」로 읽는다. */
+    return Object.keys(o).length ? o : undefined;
+}
 /** 단일 레코드 → 정규 EPCIS 이벤트 + 매핑에서 드러난 문제(검증은 `ingest` 가 이어서 한다). */
 export function mapRecordChecked(record, mapping, eventTime) {
     const errors = [];
@@ -165,11 +185,13 @@ export function mapRecordChecked(record, mapping, eventTime) {
     if (!epc && !quantityList.length) {
         errors.push('epc 와 quantityList 가 둘 다 비었다 — 개체 식별자나 클래스+수량 중 하나는 있어야 한다');
     }
+    const ilmd = resolveObject(mapping.ilmd, record, 'ilmd', errors);
     return {
         event: objectEvent({
             eventTime, action, bizStep, disposition,
             epcList: epc ? [epc] : [],
             ...(quantityList.length ? { quantityList } : {}),
+            ...(ilmd ? { ilmd } : {}),
             readPoint, bizLocation
         }),
         errors

package/dist-cjs/index.cjs

@@ -3188,6 +3188,17 @@ function resolveQuantityList(v, record, field, errors) {
   }
   return r.map((x) => ({ ...x }));
 }
+function resolveObject(v, record, field, errors) {
+  if (v === void 0) return void 0;
+  const r = get(record, v.startsWith("$.") ? v.slice(2) : v);
+  if (r === void 0 || r === null) return void 0;
+  if (typeof r !== "object" || Array.isArray(r)) {
+    errors.push(`${field} \uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2C8\uB2E4(${v}): ${JSON.stringify(r).slice(0, 80)}`);
+    return void 0;
+  }
+  const o = { ...r };
+  return Object.keys(o).length ? o : void 0;
+}
 function mapRecordChecked(record, mapping, eventTime) {
   const errors = [];
   const bizStep = resolve(mapping.bizStep, record, "bizStep", errors) ?? "";
@@ -3251,6 +3262,7 @@ function mapRecordChecked(record, mapping, eventTime) {
   if (!epc && !quantityList.length) {
     errors.push("epc \uC640 quantityList \uAC00 \uB458 \uB2E4 \uBE44\uC5C8\uB2E4 \u2014 \uAC1C\uCCB4 \uC2DD\uBCC4\uC790\uB098 \uD074\uB798\uC2A4+\uC218\uB7C9 \uC911 \uD558\uB098\uB294 \uC788\uC5B4\uC57C \uD55C\uB2E4");
   }
+  const ilmd = resolveObject(mapping.ilmd, record, "ilmd", errors);
   return {
     event: objectEvent({
       eventTime,
@@ -3259,6 +3271,7 @@ function mapRecordChecked(record, mapping, eventTime) {
       disposition,
       epcList: epc ? [epc] : [],
       ...quantityList.length ? { quantityList } : {},
+      ...ilmd ? { ilmd } : {},
       readPoint,
       bizLocation
     }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.7.57",
+  "version": "0.7.58",
   "type": "module",
   "description": "Twin Domain Kernel — framework-agnostic, zero-dep (domain + sim + 3-channel contract). WMS/YMS/MES, EPCIS 2.0 · ISA-95.",
   "publishConfig": {