80 lines
2.2 KiB
TypeScript
80 lines
2.2 KiB
TypeScript
// packages/core/src/ports.ts
|
|
// 결정성(Determinism) 포트 — 시간(Clock)과 난수/UUID(Random)를 명시적으로 주입하기 위한 공용 계약.
|
|
// 프로덕션 기본값은 systemClock / systemRandom 이며, 단위·통합 테스트는 createFakeClock / createSeededRandom 을 주입한다.
|
|
|
|
import { randomUUID } from 'node:crypto'
|
|
|
|
export interface Clock {
|
|
now(): number
|
|
}
|
|
|
|
export interface FakeClock extends Clock {
|
|
advance(ms: number): number
|
|
set(ms: number): void
|
|
}
|
|
|
|
export interface Random {
|
|
/** [0, 1) 범위 부동소수점 난수 */
|
|
next(): number
|
|
/** RFC 4122 v4 형식 UUID */
|
|
uuid(): string
|
|
}
|
|
|
|
export const systemClock: Clock = {
|
|
now: () => Date.now()
|
|
}
|
|
|
|
export const systemRandom: Random = {
|
|
next: () => Math.random(),
|
|
uuid: () => randomUUID()
|
|
}
|
|
|
|
export function createFakeClock(initialMs = 1_700_000_000_000): FakeClock {
|
|
let currentMs = initialMs
|
|
return {
|
|
now: () => currentMs,
|
|
advance(ms: number): number {
|
|
currentMs += ms
|
|
return currentMs
|
|
},
|
|
set(ms: number): void {
|
|
currentMs = ms
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 결정적 Mulberry32 기반 PRNG + RFC 4122 v4 형식 UUID 생성기.
|
|
* 동일 seed 입력 시 플랫폼·시각과 무관하게 동일한 수열을 보장한다.
|
|
*/
|
|
export function createSeededRandom(seed = 1): Random {
|
|
let state = seed >>> 0
|
|
|
|
const nextUint32 = (): number => {
|
|
state = (state + 0x6d2b79f5) >>> 0
|
|
let t = Math.imul(state ^ (state >>> 15), 1 | state)
|
|
t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t
|
|
return (t ^ (t >>> 14)) >>> 0
|
|
}
|
|
|
|
return {
|
|
next(): number {
|
|
return nextUint32() / 0x1_0000_0000
|
|
},
|
|
uuid(): string {
|
|
const bytes = new Uint8Array(16)
|
|
for (let offset = 0; offset < 16; offset += 4) {
|
|
const word = nextUint32()
|
|
bytes[offset] = (word >>> 24) & 0xff
|
|
bytes[offset + 1] = (word >>> 16) & 0xff
|
|
bytes[offset + 2] = (word >>> 8) & 0xff
|
|
bytes[offset + 3] = word & 0xff
|
|
}
|
|
bytes[6] = (bytes[6] & 0x0f) | 0x40
|
|
bytes[8] = (bytes[8] & 0x3f) | 0x80
|
|
|
|
const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('')
|
|
return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`
|
|
}
|
|
}
|
|
}
|