@tknf/snowflake 1.2.0

v1.2.0

on Node.js NPM

ハイライト

セキュリティ / コード品質監査に基づく修正と新機能のリリースです。

🐛 バグ修正

• generateSnowflakeId() が同一ミリ秒内で重複 ID を返す問題を修正（ジェネレータキャッシュで sequence 状態を共有） (#9)
• epoch 検証を追加し、未来の epoch による負の ID 生成を防止 (#10)
• ブラウザの workerId フォールバックを crypto.getRandomValues ベースに変更 (#12)

✨ 新機能

• Monotonic edge mode: createSnowflake({ mode: 'edge', monotonic: true }) — 同一ジェネレータ内で厳密な一意性と生成順ソートを保証 (#17)
• isValidSnowflakeId() / safeParseSnowflakeId(): 外部入力の安全な検証・パース。parseSnowflakeId 系は不正入力で明確な Error を throw するように (#11)

📚 ドキュメント

• edge mode の clock-backwards 挙動と衝突確率の目安を明文化 (#13)
• Cloudflare Workers / Durable Objects のレシピを追加 (#20)
• 複数タブでのフィンガープリント衝突に関する注意を追記 (#12)

🔧 その他

• GitHub Actions を SHA ピン留めし、npm provenance 付き publish に対応 (#14)
• pnpm catalog のバージョンを固定 (#15, #16)

互換性: 公開 API のシグネチャ変更なし。すべて後方互換です。

Full Changelog: v1.1.0...v1.2.0