@operato/twin-kernel 0.7.80 → 0.7.81

package/dist/energy-ingest.js

@@ -399,7 +399,6 @@ export function ingestEnergyGenerationPriceRecords(records, opts) {
     const list = records === undefined || records === null ? [] : Array.isArray(records) ? records : [records];
     const accepted = [];
     const rejected = [];
-    let seq = 0;
     for (const r of list) {
         const errors = [];
         const span = readSpan(r, errors);
@@ -416,7 +415,7 @@ export function ingestEnergyGenerationPriceRecords(records, opts) {
         }
         const data = { from: span.from, to: span.to, unitPrice, currency };
         accepted.push({
-            eventId: `${opts.tenantId}-generation-price-${++seq}`,
+            eventId: periodFactId(opts.tenantId, ENERGY_EVENT.generationPrice, '', span.from, span.to),
             eventType: ENERGY_EVENT.generationPrice,
             eventTime: span.from,
             tenantId: opts.tenantId,
@@ -453,7 +452,6 @@ export function ingestEnergyTariffBasisRecords(records, opts) {
     const list = records === undefined || records === null ? [] : Array.isArray(records) ? records : [records];
     const accepted = [];
     const rejected = [];
-    let seq = 0;
     for (const r of list) {
         const errors = [];
         const span = readSpan(r, errors);
@@ -482,7 +480,7 @@ export function ingestEnergyTariffBasisRecords(records, opts) {
             ...(currency ? { currency } : {})
         };
         accepted.push({
-            eventId: `${opts.tenantId}-tariff-basis-${++seq}`,
+            eventId: periodFactId(opts.tenantId, ENERGY_EVENT.tariffBasis, '', span.from, span.to),
             eventType: ENERGY_EVENT.tariffBasis,
             /* **시작 시각**이다 — 그때부터 유효하다(§ 위 주석). */
             eventTime: span.from,
@@ -500,6 +498,27 @@ export function isEnergyBillRecord(record) {
         return false;
     return r.energyCharge !== undefined || r.demandCharge !== undefined || r.total !== undefined;
 }
+/*
+ * ── 마감된 구간 사실의 **정체성** (2026-08-30) ───────────────────────────────
+ *
+ * 커널이 다루는 사실에는 두 종류가 있다.
+ *
+ *   시점의 관측    「이 시각에 이 값이었다」    같은 값이 두 번 오면 **두 사실**이다
+ *   마감된 구간    「이 기간에 이만큼이었다」   같은 기간이 두 번 오면 **한 사실**이다
+ *
+ * 둘째 종류는 정체성이 내용에 있다 — **종류·대상·시작·끝**이 같으면 같은 사실이다. 어느 커넥터가
+ * 어떻게 보내든, 재기동을 몇 번 하든 그렇다.
+ *
+ * 그래서 이 문들의 봉투 id 를 **순번이 아니라 내용에서** 만든다. 순번으로 만들면 같은 기간을 다시
+ * 보낼 때마다 다른 id 가 나오고, 읽는 쪽이 같은 사실인지 알 방법이 없다.
+ *
+ * **이것만으로 중복이 막히지는 않는다.** 저널은 아직 이 id 를 유일성으로 쓰지 않는다(그 판단은
+ * 호스트의 것이고 드라이버마다 다르다). 여기서 하는 일은 **막을 근거를 만드는 것**이다.
+ */
+function periodFactId(tenantId, kind, subject, from, to) {
+    /* 대상이 없는 사실(요금 기준·청구서·발전 단가)은 그 자리를 비운다 — 없는 것을 지어내지 않는다. */
+    return [tenantId, kind, subject, from, to].join('|');
+}
 /** 두 시각을 읽고 순서를 본다 — 뒤집힌 구간은 받지 않는다(합이 음수가 된다). */
 function readSpan(r, errors) {
     const from = String(r?.from ?? '').trim();
@@ -534,7 +553,6 @@ export function ingestEnergyUsagePeriodRecords(records, opts) {
     const list = records === undefined || records === null ? [] : Array.isArray(records) ? records : [records];
     const accepted = [];
     const rejected = [];
-    let seq = 0;
     for (const r of list) {
         const errors = [];
         const meterId = String(r?.meterId ?? '').trim();
@@ -581,7 +599,7 @@ export function ingestEnergyUsagePeriodRecords(records, opts) {
             ...(basis ? { basis } : {})
         };
         accepted.push({
-            eventId: `${opts.tenantId}-usage-period-${++seq}`,
+            eventId: periodFactId(opts.tenantId, ENERGY_EVENT.usagePeriod, meterId, span.from, span.to),
             eventType: ENERGY_EVENT.usagePeriod,
             /* 구간의 **끝**이 이 사실이 성립한 시각이다 — 시작으로 달면 저널이 그 구간을 미리 안 것이 된다. */
             eventTime: span.to,
@@ -595,7 +613,6 @@ export function ingestEnergyBillRecords(records, opts) {
     const list = records === undefined || records === null ? [] : Array.isArray(records) ? records : [records];
     const accepted = [];
     const rejected = [];
-    let seq = 0;
     for (const r of list) {
         const errors = [];
         const span = readSpan(r, errors);
@@ -628,7 +645,7 @@ export function ingestEnergyBillRecords(records, opts) {
             ...(billingDemandKW !== undefined ? { billingDemandKW } : {})
         };
         accepted.push({
-            eventId: `${opts.tenantId}-bill-${++seq}`,
+            eventId: periodFactId(opts.tenantId, ENERGY_EVENT.bill, '', span.from, span.to),
             eventType: ENERGY_EVENT.bill,
             eventTime: span.to,
             tenantId: opts.tenantId,

package/dist-cjs/index.cjs

@@ -10049,7 +10049,6 @@ function ingestEnergyGenerationPriceRecords(records, opts) {
   const list = records === void 0 || records === null ? [] : Array.isArray(records) ? records : [records];
   const accepted = [];
   const rejected = [];
-  let seq = 0;
   for (const r of list) {
     const errors = [];
     const span = readSpan(r, errors);
@@ -10063,7 +10062,7 @@ function ingestEnergyGenerationPriceRecords(records, opts) {
     }
     const data = { from: span.from, to: span.to, unitPrice, currency };
     accepted.push({
-      eventId: `${opts.tenantId}-generation-price-${++seq}`,
+      eventId: periodFactId(opts.tenantId, ENERGY_EVENT.generationPrice, "", span.from, span.to),
       eventType: ENERGY_EVENT.generationPrice,
       eventTime: span.from,
       tenantId: opts.tenantId,
@@ -10083,7 +10082,6 @@ function ingestEnergyTariffBasisRecords(records, opts) {
   const list = records === void 0 || records === null ? [] : Array.isArray(records) ? records : [records];
   const accepted = [];
   const rejected = [];
-  let seq = 0;
   for (const r of list) {
     const errors = [];
     const span = readSpan(r, errors);
@@ -10109,7 +10107,7 @@ function ingestEnergyTariffBasisRecords(records, opts) {
       ...currency ? { currency } : {}
     };
     accepted.push({
-      eventId: `${opts.tenantId}-tariff-basis-${++seq}`,
+      eventId: periodFactId(opts.tenantId, ENERGY_EVENT.tariffBasis, "", span.from, span.to),
       eventType: ENERGY_EVENT.tariffBasis,
       /* **시작 시각**이다 — 그때부터 유효하다(§ 위 주석). */
       eventTime: span.from,
@@ -10125,6 +10123,9 @@ function isEnergyBillRecord(record) {
   if (r.from === void 0 || r.to === void 0) return false;
   return r.energyCharge !== void 0 || r.demandCharge !== void 0 || r.total !== void 0;
 }
+function periodFactId(tenantId, kind, subject, from, to) {
+  return [tenantId, kind, subject, from, to].join("|");
+}
 function readSpan(r, errors) {
   const from = String(r?.from ?? "").trim();
   const to = String(r?.to ?? "").trim();
@@ -10154,7 +10155,6 @@ function ingestEnergyUsagePeriodRecords(records, opts) {
   const list = records === void 0 || records === null ? [] : Array.isArray(records) ? records : [records];
   const accepted = [];
   const rejected = [];
-  let seq = 0;
   for (const r of list) {
     const errors = [];
     const meterId = String(r?.meterId ?? "").trim();
@@ -10194,7 +10194,7 @@ function ingestEnergyUsagePeriodRecords(records, opts) {
       ...basis ? { basis } : {}
     };
     accepted.push({
-      eventId: `${opts.tenantId}-usage-period-${++seq}`,
+      eventId: periodFactId(opts.tenantId, ENERGY_EVENT.usagePeriod, meterId, span.from, span.to),
       eventType: ENERGY_EVENT.usagePeriod,
       /* 구간의 **끝**이 이 사실이 성립한 시각이다 — 시작으로 달면 저널이 그 구간을 미리 안 것이 된다. */
       eventTime: span.to,
@@ -10208,7 +10208,6 @@ function ingestEnergyBillRecords(records, opts) {
   const list = records === void 0 || records === null ? [] : Array.isArray(records) ? records : [records];
   const accepted = [];
   const rejected = [];
-  let seq = 0;
   for (const r of list) {
     const errors = [];
     const span = readSpan(r, errors);
@@ -10235,7 +10234,7 @@ function ingestEnergyBillRecords(records, opts) {
       ...billingDemandKW !== void 0 ? { billingDemandKW } : {}
     };
     accepted.push({
-      eventId: `${opts.tenantId}-bill-${++seq}`,
+      eventId: periodFactId(opts.tenantId, ENERGY_EVENT.bill, "", span.from, span.to),
       eventType: ENERGY_EVENT.bill,
       eventTime: span.to,
       tenantId: opts.tenantId,

package/package.json

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