@things-factory/headless-twin 10.1.8 → 10.1.10

package/server/service/twin-lifecycle/twin-lifecycle-mutation.ts

@@ -6,6 +6,7 @@ import { TwinEngine } from '../../engine/index.js'
 /* 정책 읽기는 그 모듈에서 직접 가져온다 — 다른 소비처(`reference-resolver`)와 같은 길이다. */
 import { readRestartPolicy } from '../../engine/restart-policy.js'
 import { TwinInstance } from '../twin-instance/twin-instance.js'
+import { TwinEvent } from '../twin-event/twin-event.js'
 
 import type { TwinModelDef } from '@operato/ops-contract'
 
@@ -160,6 +161,43 @@ export class TwinLifecycleMutation {
     return { instanceId, name: next, previous: before || null, changed: true }
   }
 
+  /**
+   * 폐기 전에 사라질 것을 읽는다.
+   *
+   * 삭제는 레지스트리 행 하나만 없애는 일이 아니다. `TwinEngine.remove` 는 같은 트윈의 저널도
+   * purge 한다. 그래서 확인 창이 추측한 숫자를 쓰지 않고, **삭제와 같은 domain·instance 범위**를
+   * 직접 센다. 저널이 비어 있는 트윈도 `0` 과 null 기간을 돌려준다 — 없는 기록을 기간으로
+   * 꾸며내면 "아무것도 안 지워진다"와 "언제부터인지 모른다"가 섞인다.
+   */
+  @Query(returns => ScalarObject, {
+    nullable: true,
+    description:
+      'Describe what deleting one twin would purge before it is deleted: its registry identity and the count plus first/last event time of its journal. Null means this twin is not in the current domain.'
+  })
+  async twinDeletionPreview(@Arg('instanceId') instanceId: string, @Ctx() context: ResolverContext): Promise<any | null> {
+    const domainId = context.state.domain.id
+    const instance = await getRepository(TwinInstance).findOne({ where: { domain: { id: domainId }, instanceId } })
+
+    if (!instance) return null
+
+    const journal = await getRepository(TwinEvent)
+      .createQueryBuilder('event')
+      .select('COUNT(event.id)', 'count')
+      .addSelect('MIN(event.eventTime)', 'firstEventAt')
+      .addSelect('MAX(event.eventTime)', 'lastEventAt')
+      .where('event.domain = :domainId', { domainId })
+      .andWhere('event.instanceId = :instanceId', { instanceId })
+      .getRawOne<{ count?: string | number; firstEventAt?: unknown; lastEventAt?: unknown }>()
+
+    return {
+      instanceId,
+      name: instance.name ?? null,
+      journalCount: Number(journal?.count ?? 0),
+      firstEventAt: journal?.firstEventAt ?? null,
+      lastEventAt: journal?.lastEventAt ?? null
+    }
+  }
+
   /** 삭제 — 정지 + 레지스트리 삭제 + 저널 purge(domain 스코프). */
   @Directive('@privilege(category: "twin", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Boolean, { description: 'Delete a twin instance: stop it, remove the registry entry and purge its event journal.' })

package/test/reference-reconciliation.test.ts

@@ -0,0 +1,39 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+import { readFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { reconcileReferenceSequence } from '../server/service/reference/reference-reconciliation.ts'
+
+test('reports work waiting after the Twin cursor', () => {
+  const got = reconcileReferenceSequence({ source: { first: 1, last: 48 }, cursorSeq: 30, firstSeqSeen: 1 })
+  assert.equal(got.status, 'gap')
+  assert.equal(got.behind, 18)
+  assert.equal(got.headMissing, undefined)
+})
+
+test('reports the leading range only when the first received sequence proves it', () => {
+  const got = reconcileReferenceSequence({ source: { first: 1, last: 48 }, cursorSeq: 48, firstSeqSeen: 21 })
+  assert.equal(got.status, 'gap')
+  assert.equal(got.headMissing, 20)
+})
+
+test('does not claim alignment when the source range or first received sequence is unknown', () => {
+  assert.equal(reconcileReferenceSequence({ source: { first: 1 }, cursorSeq: 1, firstSeqSeen: 1 }).status, 'unknown')
+  assert.equal(reconcileReferenceSequence({ source: { first: 1, last: 1 }, cursorSeq: 1 }).status, 'unknown')
+})
+
+test('reports alignment only with both source bounds and a recorded first sequence', () => {
+  const got = reconcileReferenceSequence({ source: { first: 1, last: 48 }, cursorSeq: 48, firstSeqSeen: 1 })
+  assert.equal(got.status, 'aligned')
+})
+
+test('registers the durable reconciliation table and its migration', () => {
+  const root = join(import.meta.dirname, '..', 'server')
+  const migration = readFileSync(join(root, 'migrations', '1786800000000-CreateTwinReferenceReconciliations.ts'), 'utf8')
+  const list = readFileSync(join(root, 'migrations', 'index.ts'), 'utf8')
+  const referenceIndex = readFileSync(join(root, 'service', 'reference', 'index.ts'), 'utf8')
+  assert.match(migration, /twin_reference_reconciliations/)
+  assert.match(migration, /uq_twin_reference_reconciliation_0/)
+  assert.match(list, /CreateTwinReferenceReconciliations1786800000000/)
+  assert.match(referenceIndex, /TwinReferenceReconciliation/)
+})