@tacet-ink/journal-core 0.2.5 → 0.3.0

package/dist/client/pinlock.js

@@ -0,0 +1,84 @@
+/**
+ * pinlock.ts — 本機 PIN 鎖定包裹原語（jr1p.，「開啟時鎖定」，2026-09-24 動工）。
+ *
+ * 威脅模型：裝置被順手翻看／拔走。raw noteKey 摘除、以 PIN 派生 KEK 包裹，
+ * 鎖定期間 localStorage 無 raw key（鐵律 8 誠實姿態的實質升級）。
+ * jr1p. 刻意用 PBKDF2-SHA256 600k，不用 Argon2id：解鎖每次啟動都要經歷，
+ * 鎖定閘要即時性＋省電；鎖定閘非登入 oracle 戰場（離線爆破 6 位數字 ≈ 單 GPU 數天＝門檻不是牆）。
+ * KDF 升級走帶內版本化（新前綴），禁原地改語意。
+ *
+ * payload（pinSalt 內嵌自描述，與 jr2w./jr3d. 同構）：
+ *   jr1p. + b64( pinSalt[16] ‖ iv[12] ‖ GCM(KEK, hex(noteKey), aad='notekey-pinlock') )，嚴格 108B
+ *   KEK = PBKDF2-SHA256(pinNorm, 'tacet-pinlock-v1:' + hex(pinSalt), 600k) → AES-GCM key（nonextractable）
+ * ⚠️ unwrap 輸出 noteKey 一律 extractable=true（鐵律 1：要能再包裹/匯出）；KEK nonextractable。
+ * ⚠️ cfg 未配置 = 全拒（wrapDual/wrapShare3 同款 opt-in 律，兄弟 fork 零影響）。
+ * ⚠️ 語意分離：jr1p. 是本機裝置閘，與登入第二因子（jr2w./jr3d.）契約、payload、威脅模型全分離。
+ */
+import { b64, unb64, toHex, hexToBytes, decryptWithKey, importAesGcm, normalizePin, } from './note-crypto.js';
+/** 雙因子 pin 段等級（2M）過重：鎖定閘要即時性，600k 與 jr1w. 同級。 */
+export const PINLOCK_ITERATIONS = 600_000;
+const SALT_LEN = 16;
+const IV_LEN = 12;
+/** pinSalt(16) + iv(12) + ct(hex 字串 64B + GCM tag 16B) = 108B 固定。 */
+const PAYLOAD_LEN = SALT_LEN + IV_LEN + 80;
+/** KEK = PBKDF2-SHA256(pinNorm, pinLockSaltPrefix + hex(pinSalt), 600k) → AES-GCM key（nonextractable）。 */
+async function deriveLockKek(pinNorm, pinSalt, cfg) {
+    if (!cfg.pinLock || !cfg.pinLockSaltPrefix || !cfg.pinLockAad)
+        throw new Error('ERR_PINLOCK_NOT_CONFIGURED');
+    const keyMat = await crypto.subtle.importKey('raw', new TextEncoder().encode(pinNorm), 'PBKDF2', false, ['deriveKey']);
+    return crypto.subtle.deriveKey({
+        name: 'PBKDF2',
+        hash: 'SHA-256',
+        salt: new TextEncoder().encode(cfg.pinLockSaltPrefix + toHex(pinSalt)),
+        iterations: PINLOCK_ITERATIONS,
+    }, keyMat, { name: 'AES-GCM', length: 256 }, false, // KEK nonextractable
+    ['encrypt', 'decrypt']);
+}
+/** jr1p. 包裹：payload = pinSalt[16] ‖ iv[12] ‖ GCM(KEK, hex(noteKey), aad)；全自描述（salt 內嵌）。
+ *  鹽內嵌家族（jr2w./jr3d./jr1p.）自帶三段組裝——sealNoteKey 是鹽外置家族形（iv‖ct），
+ *  內嵌鹽的 pinSalt 前綴不在其契約內（毒化輪回歸實證：亂收口＝unwrap 恆 null）。 */
+export async function wrapNoteKeyPinLock(cfg, noteKey, pin) {
+    if (!cfg.pinLock || !cfg.pinLockSaltPrefix || !cfg.pinLockAad)
+        throw new Error('ERR_PINLOCK_NOT_CONFIGURED');
+    const pinNorm = normalizePin(pin);
+    if (!pinNorm)
+        throw new Error('ERR_PINLOCK_EMPTY');
+    const pinSalt = crypto.getRandomValues(new Uint8Array(SALT_LEN));
+    const kek = await deriveLockKek(pinNorm, pinSalt, cfg);
+    const rawHex = toHex(new Uint8Array(await crypto.subtle.exportKey('raw', noteKey)));
+    const iv = crypto.getRandomValues(new Uint8Array(IV_LEN));
+    const ct = new Uint8Array(await crypto.subtle.encrypt({ name: 'AES-GCM', iv, additionalData: new TextEncoder().encode(cfg.pinLockAad) }, kek, new TextEncoder().encode(rawHex)));
+    const payload = new Uint8Array(PAYLOAD_LEN);
+    payload.set(pinSalt, 0);
+    payload.set(iv, SALT_LEN);
+    payload.set(ct, SALT_LEN + IV_LEN);
+    return cfg.pinLock + b64(payload);
+}
+/** jr1p. 解包：全自描述；任何不符（前綴/長度/PIN 空/AAD）回 null 不拋；成功 → noteKey extractable=true（鐵律 1）。
+ *  嚴格檢查為鹽內嵌族自有（payload 嚴格 108B＋rawHex hex 形檢查；
+ *  hexToBytes fail-closed 由 try/catch 承接＝行為不變）——不經 openNoteKey 本體
+ *  （openNoteKey 是鹽外置家族 92B 形，pinSalt 前綴不在其契約內）。 */
+export async function unwrapNoteKeyPinLock(cfg, wrapped, pin) {
+    try {
+        if (!cfg.pinLock || !cfg.pinLockSaltPrefix || !cfg.pinLockAad)
+            return null;
+        if (!wrapped.startsWith(cfg.pinLock))
+            return null;
+        const payload = unb64(wrapped.slice(cfg.pinLock.length));
+        if (payload.length !== PAYLOAD_LEN)
+            return null;
+        const pinSalt = payload.slice(0, SALT_LEN);
+        const ivPrefixedCt = payload.slice(SALT_LEN); // 鹽內嵌家族：payload = pinSalt[16] ‖ iv[12] ‖ ct
+        const pinNorm = normalizePin(pin);
+        if (!pinNorm)
+            return null;
+        const kek = await deriveLockKek(pinNorm, pinSalt, cfg);
+        const rawHex = await decryptWithKey(kek, ivPrefixedCt, cfg.pinLockAad);
+        if (!rawHex || rawHex.length !== 64 || !/^[0-9a-f]+$/.test(rawHex))
+            return null;
+        return importAesGcm(hexToBytes(rawHex), true);
+    }
+    catch {
+        return null;
+    }
+}

package/dist/client/wordlist.d.ts

@@ -0,0 +1,7 @@
+/**
+ * wordlist.ts — BIP39 英文詞表（2048 詞，標準常數；非任何套件的碼）。
+ * 源：BIP39 官方 english wordlist（經 @scure/bip39 v2.4.0 wordlists/english.js 校對）。
+ * MIT (c) 2022 Patricio Palladino, Paul Miller（@scure/bip39）。
+ * 契約：全小寫 a-z、恰 2048 詞、索引即 11-bit 編碼值；只供 kit 轉寫層使用。
+ */
+export declare const wordlist: readonly string[];

package/dist/client/wordlist.js

@@ -0,0 +1,264 @@
+/**
+ * wordlist.ts — BIP39 英文詞表（2048 詞，標準常數；非任何套件的碼）。
+ * 源：BIP39 官方 english wordlist（經 @scure/bip39 v2.4.0 wordlists/english.js 校對）。
+ * MIT (c) 2022 Patricio Palladino, Paul Miller（@scure/bip39）。
+ * 契約：全小寫 a-z、恰 2048 詞、索引即 11-bit 編碼值；只供 kit 轉寫層使用。
+ */
+export const wordlist = Object.freeze([
+    'abandon', 'ability', 'able', 'about', 'above', 'absent', 'absorb', 'abstract',
+    'absurd', 'abuse', 'access', 'accident', 'account', 'accuse', 'achieve', 'acid',
+    'acoustic', 'acquire', 'across', 'act', 'action', 'actor', 'actress', 'actual',
+    'adapt', 'add', 'addict', 'address', 'adjust', 'admit', 'adult', 'advance',
+    'advice', 'aerobic', 'affair', 'afford', 'afraid', 'again', 'age', 'agent',
+    'agree', 'ahead', 'aim', 'air', 'airport', 'aisle', 'alarm', 'album',
+    'alcohol', 'alert', 'alien', 'all', 'alley', 'allow', 'almost', 'alone',
+    'alpha', 'already', 'also', 'alter', 'always', 'amateur', 'amazing', 'among',
+    'amount', 'amused', 'analyst', 'anchor', 'ancient', 'anger', 'angle', 'angry',
+    'animal', 'ankle', 'announce', 'annual', 'another', 'answer', 'antenna', 'antique',
+    'anxiety', 'any', 'apart', 'apology', 'appear', 'apple', 'approve', 'april',
+    'arch', 'arctic', 'area', 'arena', 'argue', 'arm', 'armed', 'armor',
+    'army', 'around', 'arrange', 'arrest', 'arrive', 'arrow', 'art', 'artefact',
+    'artist', 'artwork', 'ask', 'aspect', 'assault', 'asset', 'assist', 'assume',
+    'asthma', 'athlete', 'atom', 'attack', 'attend', 'attitude', 'attract', 'auction',
+    'audit', 'august', 'aunt', 'author', 'auto', 'autumn', 'average', 'avocado',
+    'avoid', 'awake', 'aware', 'away', 'awesome', 'awful', 'awkward', 'axis',
+    'baby', 'bachelor', 'bacon', 'badge', 'bag', 'balance', 'balcony', 'ball',
+    'bamboo', 'banana', 'banner', 'bar', 'barely', 'bargain', 'barrel', 'base',
+    'basic', 'basket', 'battle', 'beach', 'bean', 'beauty', 'because', 'become',
+    'beef', 'before', 'begin', 'behave', 'behind', 'believe', 'below', 'belt',
+    'bench', 'benefit', 'best', 'betray', 'better', 'between', 'beyond', 'bicycle',
+    'bid', 'bike', 'bind', 'biology', 'bird', 'birth', 'bitter', 'black',
+    'blade', 'blame', 'blanket', 'blast', 'bleak', 'bless', 'blind', 'blood',
+    'blossom', 'blouse', 'blue', 'blur', 'blush', 'board', 'boat', 'body',
+    'boil', 'bomb', 'bone', 'bonus', 'book', 'boost', 'border', 'boring',
+    'borrow', 'boss', 'bottom', 'bounce', 'box', 'boy', 'bracket', 'brain',
+    'brand', 'brass', 'brave', 'bread', 'breeze', 'brick', 'bridge', 'brief',
+    'bright', 'bring', 'brisk', 'broccoli', 'broken', 'bronze', 'broom', 'brother',
+    'brown', 'brush', 'bubble', 'buddy', 'budget', 'buffalo', 'build', 'bulb',
+    'bulk', 'bullet', 'bundle', 'bunker', 'burden', 'burger', 'burst', 'bus',
+    'business', 'busy', 'butter', 'buyer', 'buzz', 'cabbage', 'cabin', 'cable',
+    'cactus', 'cage', 'cake', 'call', 'calm', 'camera', 'camp', 'can',
+    'canal', 'cancel', 'candy', 'cannon', 'canoe', 'canvas', 'canyon', 'capable',
+    'capital', 'captain', 'car', 'carbon', 'card', 'cargo', 'carpet', 'carry',
+    'cart', 'case', 'cash', 'casino', 'castle', 'casual', 'cat', 'catalog',
+    'catch', 'category', 'cattle', 'caught', 'cause', 'caution', 'cave', 'ceiling',
+    'celery', 'cement', 'census', 'century', 'cereal', 'certain', 'chair', 'chalk',
+    'champion', 'change', 'chaos', 'chapter', 'charge', 'chase', 'chat', 'cheap',
+    'check', 'cheese', 'chef', 'cherry', 'chest', 'chicken', 'chief', 'child',
+    'chimney', 'choice', 'choose', 'chronic', 'chuckle', 'chunk', 'churn', 'cigar',
+    'cinnamon', 'circle', 'citizen', 'city', 'civil', 'claim', 'clap', 'clarify',
+    'claw', 'clay', 'clean', 'clerk', 'clever', 'click', 'client', 'cliff',
+    'climb', 'clinic', 'clip', 'clock', 'clog', 'close', 'cloth', 'cloud',
+    'clown', 'club', 'clump', 'cluster', 'clutch', 'coach', 'coast', 'coconut',
+    'code', 'coffee', 'coil', 'coin', 'collect', 'color', 'column', 'combine',
+    'come', 'comfort', 'comic', 'common', 'company', 'concert', 'conduct', 'confirm',
+    'congress', 'connect', 'consider', 'control', 'convince', 'cook', 'cool', 'copper',
+    'copy', 'coral', 'core', 'corn', 'correct', 'cost', 'cotton', 'couch',
+    'country', 'couple', 'course', 'cousin', 'cover', 'coyote', 'crack', 'cradle',
+    'craft', 'cram', 'crane', 'crash', 'crater', 'crawl', 'crazy', 'cream',
+    'credit', 'creek', 'crew', 'cricket', 'crime', 'crisp', 'critic', 'crop',
+    'cross', 'crouch', 'crowd', 'crucial', 'cruel', 'cruise', 'crumble', 'crunch',
+    'crush', 'cry', 'crystal', 'cube', 'culture', 'cup', 'cupboard', 'curious',
+    'current', 'curtain', 'curve', 'cushion', 'custom', 'cute', 'cycle', 'dad',
+    'damage', 'damp', 'dance', 'danger', 'daring', 'dash', 'daughter', 'dawn',
+    'day', 'deal', 'debate', 'debris', 'decade', 'december', 'decide', 'decline',
+    'decorate', 'decrease', 'deer', 'defense', 'define', 'defy', 'degree', 'delay',
+    'deliver', 'demand', 'demise', 'denial', 'dentist', 'deny', 'depart', 'depend',
+    'deposit', 'depth', 'deputy', 'derive', 'describe', 'desert', 'design', 'desk',
+    'despair', 'destroy', 'detail', 'detect', 'develop', 'device', 'devote', 'diagram',
+    'dial', 'diamond', 'diary', 'dice', 'diesel', 'diet', 'differ', 'digital',
+    'dignity', 'dilemma', 'dinner', 'dinosaur', 'direct', 'dirt', 'disagree', 'discover',
+    'disease', 'dish', 'dismiss', 'disorder', 'display', 'distance', 'divert', 'divide',
+    'divorce', 'dizzy', 'doctor', 'document', 'dog', 'doll', 'dolphin', 'domain',
+    'donate', 'donkey', 'donor', 'door', 'dose', 'double', 'dove', 'draft',
+    'dragon', 'drama', 'drastic', 'draw', 'dream', 'dress', 'drift', 'drill',
+    'drink', 'drip', 'drive', 'drop', 'drum', 'dry', 'duck', 'dumb',
+    'dune', 'during', 'dust', 'dutch', 'duty', 'dwarf', 'dynamic', 'eager',
+    'eagle', 'early', 'earn', 'earth', 'easily', 'east', 'easy', 'echo',
+    'ecology', 'economy', 'edge', 'edit', 'educate', 'effort', 'egg', 'eight',
+    'either', 'elbow', 'elder', 'electric', 'elegant', 'element', 'elephant', 'elevator',
+    'elite', 'else', 'embark', 'embody', 'embrace', 'emerge', 'emotion', 'employ',
+    'empower', 'empty', 'enable', 'enact', 'end', 'endless', 'endorse', 'enemy',
+    'energy', 'enforce', 'engage', 'engine', 'enhance', 'enjoy', 'enlist', 'enough',
+    'enrich', 'enroll', 'ensure', 'enter', 'entire', 'entry', 'envelope', 'episode',
+    'equal', 'equip', 'era', 'erase', 'erode', 'erosion', 'error', 'erupt',
+    'escape', 'essay', 'essence', 'estate', 'eternal', 'ethics', 'evidence', 'evil',
+    'evoke', 'evolve', 'exact', 'example', 'excess', 'exchange', 'excite', 'exclude',
+    'excuse', 'execute', 'exercise', 'exhaust', 'exhibit', 'exile', 'exist', 'exit',
+    'exotic', 'expand', 'expect', 'expire', 'explain', 'expose', 'express', 'extend',
+    'extra', 'eye', 'eyebrow', 'fabric', 'face', 'faculty', 'fade', 'faint',
+    'faith', 'fall', 'false', 'fame', 'family', 'famous', 'fan', 'fancy',
+    'fantasy', 'farm', 'fashion', 'fat', 'fatal', 'father', 'fatigue', 'fault',
+    'favorite', 'feature', 'february', 'federal', 'fee', 'feed', 'feel', 'female',
+    'fence', 'festival', 'fetch', 'fever', 'few', 'fiber', 'fiction', 'field',
+    'figure', 'file', 'film', 'filter', 'final', 'find', 'fine', 'finger',
+    'finish', 'fire', 'firm', 'first', 'fiscal', 'fish', 'fit', 'fitness',
+    'fix', 'flag', 'flame', 'flash', 'flat', 'flavor', 'flee', 'flight',
+    'flip', 'float', 'flock', 'floor', 'flower', 'fluid', 'flush', 'fly',
+    'foam', 'focus', 'fog', 'foil', 'fold', 'follow', 'food', 'foot',
+    'force', 'forest', 'forget', 'fork', 'fortune', 'forum', 'forward', 'fossil',
+    'foster', 'found', 'fox', 'fragile', 'frame', 'frequent', 'fresh', 'friend',
+    'fringe', 'frog', 'front', 'frost', 'frown', 'frozen', 'fruit', 'fuel',
+    'fun', 'funny', 'furnace', 'fury', 'future', 'gadget', 'gain', 'galaxy',
+    'gallery', 'game', 'gap', 'garage', 'garbage', 'garden', 'garlic', 'garment',
+    'gas', 'gasp', 'gate', 'gather', 'gauge', 'gaze', 'general', 'genius',
+    'genre', 'gentle', 'genuine', 'gesture', 'ghost', 'giant', 'gift', 'giggle',
+    'ginger', 'giraffe', 'girl', 'give', 'glad', 'glance', 'glare', 'glass',
+    'glide', 'glimpse', 'globe', 'gloom', 'glory', 'glove', 'glow', 'glue',
+    'goat', 'goddess', 'gold', 'good', 'goose', 'gorilla', 'gospel', 'gossip',
+    'govern', 'gown', 'grab', 'grace', 'grain', 'grant', 'grape', 'grass',
+    'gravity', 'great', 'green', 'grid', 'grief', 'grit', 'grocery', 'group',
+    'grow', 'grunt', 'guard', 'guess', 'guide', 'guilt', 'guitar', 'gun',
+    'gym', 'habit', 'hair', 'half', 'hammer', 'hamster', 'hand', 'happy',
+    'harbor', 'hard', 'harsh', 'harvest', 'hat', 'have', 'hawk', 'hazard',
+    'head', 'health', 'heart', 'heavy', 'hedgehog', 'height', 'hello', 'helmet',
+    'help', 'hen', 'hero', 'hidden', 'high', 'hill', 'hint', 'hip',
+    'hire', 'history', 'hobby', 'hockey', 'hold', 'hole', 'holiday', 'hollow',
+    'home', 'honey', 'hood', 'hope', 'horn', 'horror', 'horse', 'hospital',
+    'host', 'hotel', 'hour', 'hover', 'hub', 'huge', 'human', 'humble',
+    'humor', 'hundred', 'hungry', 'hunt', 'hurdle', 'hurry', 'hurt', 'husband',
+    'hybrid', 'ice', 'icon', 'idea', 'identify', 'idle', 'ignore', 'ill',
+    'illegal', 'illness', 'image', 'imitate', 'immense', 'immune', 'impact', 'impose',
+    'improve', 'impulse', 'inch', 'include', 'income', 'increase', 'index', 'indicate',
+    'indoor', 'industry', 'infant', 'inflict', 'inform', 'inhale', 'inherit', 'initial',
+    'inject', 'injury', 'inmate', 'inner', 'innocent', 'input', 'inquiry', 'insane',
+    'insect', 'inside', 'inspire', 'install', 'intact', 'interest', 'into', 'invest',
+    'invite', 'involve', 'iron', 'island', 'isolate', 'issue', 'item', 'ivory',
+    'jacket', 'jaguar', 'jar', 'jazz', 'jealous', 'jeans', 'jelly', 'jewel',
+    'job', 'join', 'joke', 'journey', 'joy', 'judge', 'juice', 'jump',
+    'jungle', 'junior', 'junk', 'just', 'kangaroo', 'keen', 'keep', 'ketchup',
+    'key', 'kick', 'kid', 'kidney', 'kind', 'kingdom', 'kiss', 'kit',
+    'kitchen', 'kite', 'kitten', 'kiwi', 'knee', 'knife', 'knock', 'know',
+    'lab', 'label', 'labor', 'ladder', 'lady', 'lake', 'lamp', 'language',
+    'laptop', 'large', 'later', 'latin', 'laugh', 'laundry', 'lava', 'law',
+    'lawn', 'lawsuit', 'layer', 'lazy', 'leader', 'leaf', 'learn', 'leave',
+    'lecture', 'left', 'leg', 'legal', 'legend', 'leisure', 'lemon', 'lend',
+    'length', 'lens', 'leopard', 'lesson', 'letter', 'level', 'liar', 'liberty',
+    'library', 'license', 'life', 'lift', 'light', 'like', 'limb', 'limit',
+    'link', 'lion', 'liquid', 'list', 'little', 'live', 'lizard', 'load',
+    'loan', 'lobster', 'local', 'lock', 'logic', 'lonely', 'long', 'loop',
+    'lottery', 'loud', 'lounge', 'love', 'loyal', 'lucky', 'luggage', 'lumber',
+    'lunar', 'lunch', 'luxury', 'lyrics', 'machine', 'mad', 'magic', 'magnet',
+    'maid', 'mail', 'main', 'major', 'make', 'mammal', 'man', 'manage',
+    'mandate', 'mango', 'mansion', 'manual', 'maple', 'marble', 'march', 'margin',
+    'marine', 'market', 'marriage', 'mask', 'mass', 'master', 'match', 'material',
+    'math', 'matrix', 'matter', 'maximum', 'maze', 'meadow', 'mean', 'measure',
+    'meat', 'mechanic', 'medal', 'media', 'melody', 'melt', 'member', 'memory',
+    'mention', 'menu', 'mercy', 'merge', 'merit', 'merry', 'mesh', 'message',
+    'metal', 'method', 'middle', 'midnight', 'milk', 'million', 'mimic', 'mind',
+    'minimum', 'minor', 'minute', 'miracle', 'mirror', 'misery', 'miss', 'mistake',
+    'mix', 'mixed', 'mixture', 'mobile', 'model', 'modify', 'mom', 'moment',
+    'monitor', 'monkey', 'monster', 'month', 'moon', 'moral', 'more', 'morning',
+    'mosquito', 'mother', 'motion', 'motor', 'mountain', 'mouse', 'move', 'movie',
+    'much', 'muffin', 'mule', 'multiply', 'muscle', 'museum', 'mushroom', 'music',
+    'must', 'mutual', 'myself', 'mystery', 'myth', 'naive', 'name', 'napkin',
+    'narrow', 'nasty', 'nation', 'nature', 'near', 'neck', 'need', 'negative',
+    'neglect', 'neither', 'nephew', 'nerve', 'nest', 'net', 'network', 'neutral',
+    'never', 'news', 'next', 'nice', 'night', 'noble', 'noise', 'nominee',
+    'noodle', 'normal', 'north', 'nose', 'notable', 'note', 'nothing', 'notice',
+    'novel', 'now', 'nuclear', 'number', 'nurse', 'nut', 'oak', 'obey',
+    'object', 'oblige', 'obscure', 'observe', 'obtain', 'obvious', 'occur', 'ocean',
+    'october', 'odor', 'off', 'offer', 'office', 'often', 'oil', 'okay',
+    'old', 'olive', 'olympic', 'omit', 'once', 'one', 'onion', 'online',
+    'only', 'open', 'opera', 'opinion', 'oppose', 'option', 'orange', 'orbit',
+    'orchard', 'order', 'ordinary', 'organ', 'orient', 'original', 'orphan', 'ostrich',
+    'other', 'outdoor', 'outer', 'output', 'outside', 'oval', 'oven', 'over',
+    'own', 'owner', 'oxygen', 'oyster', 'ozone', 'pact', 'paddle', 'page',
+    'pair', 'palace', 'palm', 'panda', 'panel', 'panic', 'panther', 'paper',
+    'parade', 'parent', 'park', 'parrot', 'party', 'pass', 'patch', 'path',
+    'patient', 'patrol', 'pattern', 'pause', 'pave', 'payment', 'peace', 'peanut',
+    'pear', 'peasant', 'pelican', 'pen', 'penalty', 'pencil', 'people', 'pepper',
+    'perfect', 'permit', 'person', 'pet', 'phone', 'photo', 'phrase', 'physical',
+    'piano', 'picnic', 'picture', 'piece', 'pig', 'pigeon', 'pill', 'pilot',
+    'pink', 'pioneer', 'pipe', 'pistol', 'pitch', 'pizza', 'place', 'planet',
+    'plastic', 'plate', 'play', 'please', 'pledge', 'pluck', 'plug', 'plunge',
+    'poem', 'poet', 'point', 'polar', 'pole', 'police', 'pond', 'pony',
+    'pool', 'popular', 'portion', 'position', 'possible', 'post', 'potato', 'pottery',
+    'poverty', 'powder', 'power', 'practice', 'praise', 'predict', 'prefer', 'prepare',
+    'present', 'pretty', 'prevent', 'price', 'pride', 'primary', 'print', 'priority',
+    'prison', 'private', 'prize', 'problem', 'process', 'produce', 'profit', 'program',
+    'project', 'promote', 'proof', 'property', 'prosper', 'protect', 'proud', 'provide',
+    'public', 'pudding', 'pull', 'pulp', 'pulse', 'pumpkin', 'punch', 'pupil',
+    'puppy', 'purchase', 'purity', 'purpose', 'purse', 'push', 'put', 'puzzle',
+    'pyramid', 'quality', 'quantum', 'quarter', 'question', 'quick', 'quit', 'quiz',
+    'quote', 'rabbit', 'raccoon', 'race', 'rack', 'radar', 'radio', 'rail',
+    'rain', 'raise', 'rally', 'ramp', 'ranch', 'random', 'range', 'rapid',
+    'rare', 'rate', 'rather', 'raven', 'raw', 'razor', 'ready', 'real',
+    'reason', 'rebel', 'rebuild', 'recall', 'receive', 'recipe', 'record', 'recycle',
+    'reduce', 'reflect', 'reform', 'refuse', 'region', 'regret', 'regular', 'reject',
+    'relax', 'release', 'relief', 'rely', 'remain', 'remember', 'remind', 'remove',
+    'render', 'renew', 'rent', 'reopen', 'repair', 'repeat', 'replace', 'report',
+    'require', 'rescue', 'resemble', 'resist', 'resource', 'response', 'result', 'retire',
+    'retreat', 'return', 'reunion', 'reveal', 'review', 'reward', 'rhythm', 'rib',
+    'ribbon', 'rice', 'rich', 'ride', 'ridge', 'rifle', 'right', 'rigid',
+    'ring', 'riot', 'ripple', 'risk', 'ritual', 'rival', 'river', 'road',
+    'roast', 'robot', 'robust', 'rocket', 'romance', 'roof', 'rookie', 'room',
+    'rose', 'rotate', 'rough', 'round', 'route', 'royal', 'rubber', 'rude',
+    'rug', 'rule', 'run', 'runway', 'rural', 'sad', 'saddle', 'sadness',
+    'safe', 'sail', 'salad', 'salmon', 'salon', 'salt', 'salute', 'same',
+    'sample', 'sand', 'satisfy', 'satoshi', 'sauce', 'sausage', 'save', 'say',
+    'scale', 'scan', 'scare', 'scatter', 'scene', 'scheme', 'school', 'science',
+    'scissors', 'scorpion', 'scout', 'scrap', 'screen', 'script', 'scrub', 'sea',
+    'search', 'season', 'seat', 'second', 'secret', 'section', 'security', 'seed',
+    'seek', 'segment', 'select', 'sell', 'seminar', 'senior', 'sense', 'sentence',
+    'series', 'service', 'session', 'settle', 'setup', 'seven', 'shadow', 'shaft',
+    'shallow', 'share', 'shed', 'shell', 'sheriff', 'shield', 'shift', 'shine',
+    'ship', 'shiver', 'shock', 'shoe', 'shoot', 'shop', 'short', 'shoulder',
+    'shove', 'shrimp', 'shrug', 'shuffle', 'shy', 'sibling', 'sick', 'side',
+    'siege', 'sight', 'sign', 'silent', 'silk', 'silly', 'silver', 'similar',
+    'simple', 'since', 'sing', 'siren', 'sister', 'situate', 'six', 'size',
+    'skate', 'sketch', 'ski', 'skill', 'skin', 'skirt', 'skull', 'slab',
+    'slam', 'sleep', 'slender', 'slice', 'slide', 'slight', 'slim', 'slogan',
+    'slot', 'slow', 'slush', 'small', 'smart', 'smile', 'smoke', 'smooth',
+    'snack', 'snake', 'snap', 'sniff', 'snow', 'soap', 'soccer', 'social',
+    'sock', 'soda', 'soft', 'solar', 'soldier', 'solid', 'solution', 'solve',
+    'someone', 'song', 'soon', 'sorry', 'sort', 'soul', 'sound', 'soup',
+    'source', 'south', 'space', 'spare', 'spatial', 'spawn', 'speak', 'special',
+    'speed', 'spell', 'spend', 'sphere', 'spice', 'spider', 'spike', 'spin',
+    'spirit', 'split', 'spoil', 'sponsor', 'spoon', 'sport', 'spot', 'spray',
+    'spread', 'spring', 'spy', 'square', 'squeeze', 'squirrel', 'stable', 'stadium',
+    'staff', 'stage', 'stairs', 'stamp', 'stand', 'start', 'state', 'stay',
+    'steak', 'steel', 'stem', 'step', 'stereo', 'stick', 'still', 'sting',
+    'stock', 'stomach', 'stone', 'stool', 'story', 'stove', 'strategy', 'street',
+    'strike', 'strong', 'struggle', 'student', 'stuff', 'stumble', 'style', 'subject',
+    'submit', 'subway', 'success', 'such', 'sudden', 'suffer', 'sugar', 'suggest',
+    'suit', 'summer', 'sun', 'sunny', 'sunset', 'super', 'supply', 'supreme',
+    'sure', 'surface', 'surge', 'surprise', 'surround', 'survey', 'suspect', 'sustain',
+    'swallow', 'swamp', 'swap', 'swarm', 'swear', 'sweet', 'swift', 'swim',
+    'swing', 'switch', 'sword', 'symbol', 'symptom', 'syrup', 'system', 'table',
+    'tackle', 'tag', 'tail', 'talent', 'talk', 'tank', 'tape', 'target',
+    'task', 'taste', 'tattoo', 'taxi', 'teach', 'team', 'tell', 'ten',
+    'tenant', 'tennis', 'tent', 'term', 'test', 'text', 'thank', 'that',
+    'theme', 'then', 'theory', 'there', 'they', 'thing', 'this', 'thought',
+    'three', 'thrive', 'throw', 'thumb', 'thunder', 'ticket', 'tide', 'tiger',
+    'tilt', 'timber', 'time', 'tiny', 'tip', 'tired', 'tissue', 'title',
+    'toast', 'tobacco', 'today', 'toddler', 'toe', 'together', 'toilet', 'token',
+    'tomato', 'tomorrow', 'tone', 'tongue', 'tonight', 'tool', 'tooth', 'top',
+    'topic', 'topple', 'torch', 'tornado', 'tortoise', 'toss', 'total', 'tourist',
+    'toward', 'tower', 'town', 'toy', 'track', 'trade', 'traffic', 'tragic',
+    'train', 'transfer', 'trap', 'trash', 'travel', 'tray', 'treat', 'tree',
+    'trend', 'trial', 'tribe', 'trick', 'trigger', 'trim', 'trip', 'trophy',
+    'trouble', 'truck', 'true', 'truly', 'trumpet', 'trust', 'truth', 'try',
+    'tube', 'tuition', 'tumble', 'tuna', 'tunnel', 'turkey', 'turn', 'turtle',
+    'twelve', 'twenty', 'twice', 'twin', 'twist', 'two', 'type', 'typical',
+    'ugly', 'umbrella', 'unable', 'unaware', 'uncle', 'uncover', 'under', 'undo',
+    'unfair', 'unfold', 'unhappy', 'uniform', 'unique', 'unit', 'universe', 'unknown',
+    'unlock', 'until', 'unusual', 'unveil', 'update', 'upgrade', 'uphold', 'upon',
+    'upper', 'upset', 'urban', 'urge', 'usage', 'use', 'used', 'useful',
+    'useless', 'usual', 'utility', 'vacant', 'vacuum', 'vague', 'valid', 'valley',
+    'valve', 'van', 'vanish', 'vapor', 'various', 'vast', 'vault', 'vehicle',
+    'velvet', 'vendor', 'venture', 'venue', 'verb', 'verify', 'version', 'very',
+    'vessel', 'veteran', 'viable', 'vibrant', 'vicious', 'victory', 'video', 'view',
+    'village', 'vintage', 'violin', 'virtual', 'virus', 'visa', 'visit', 'visual',
+    'vital', 'vivid', 'vocal', 'voice', 'void', 'volcano', 'volume', 'vote',
+    'voyage', 'wage', 'wagon', 'wait', 'walk', 'wall', 'walnut', 'want',
+    'warfare', 'warm', 'warrior', 'wash', 'wasp', 'waste', 'water', 'wave',
+    'way', 'wealth', 'weapon', 'wear', 'weasel', 'weather', 'web', 'wedding',
+    'weekend', 'weird', 'welcome', 'west', 'wet', 'whale', 'what', 'wheat',
+    'wheel', 'when', 'where', 'whip', 'whisper', 'wide', 'width', 'wife',
+    'wild', 'will', 'win', 'window', 'wine', 'wing', 'wink', 'winner',
+    'winter', 'wire', 'wisdom', 'wise', 'wish', 'witness', 'wolf', 'woman',
+    'wonder', 'wood', 'wool', 'word', 'work', 'world', 'worry', 'worth',
+    'wrap', 'wreck', 'wrestle', 'wrist', 'write', 'wrong', 'yard', 'year',
+    'yellow', 'you', 'young', 'youth', 'zebra', 'zero', 'zone', 'zoo',
+]);

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * index.ts — 公開 API barrel。
+ *
+ * 客戶端原語（WebCrypto；Argon2id 瀏覽器載體見 argon2.ts 檔頭 setArgonLoader）：
+ */
+export { makeHeldKey, generateNoteKey, encryptNote, decryptNote, encryptAttach, decryptAttach, encryptLocal, decryptLocal, wrapNoteKey, unwrapNoteKey, wrapNoteKeyWithRecToken, unwrapNoteKeyWithRecToken, wrapNoteKeyDual, unwrapNoteKeyDual, storeLocalWrap, clearLocalWrap, buildBindPayload, ph1Of, normalizePin, normalizePassphrase, recTokenHash, generateRecToken, PBKDF2_ITERATIONS, PIN_PBKDF2_ITERATIONS, type NoteCryptoConfig, type IdentityProvider, type HeldKey, } from './client/note-crypto.ts';
+export { setArgonLoader, verifyArgonKat, wrapNoteKey3, unwrapNoteKey3, wrapNoteKeyDual3, unwrapNoteKeyDual3, wrapNoteKey4, unwrapNoteKey4, wrapNoteKeyDual4, unwrapNoteKeyDual4, wrapNoteKeyShare3, unwrapNoteKeyShare3, derivePh1Argon, derivePh1ArgonV3, PH1_V2_SALT, PH1_V3_SALT, ARGON_MEMORY_KIB, ARGON_ITERATIONS, ARGON_PARALLELISM, ARGON_TAG_LEN, type Argon3Config, } from './client/argon2.ts';
+export { wrapNoteKeyPinLock, unwrapNoteKeyPinLock, PINLOCK_ITERATIONS, type PinLockConfig, } from './client/pinlock.ts';
+export { generateBip39Words, wordsToRecToken, recTokenToWords, spotCheckIndexes, } from './client/bip39.ts';
+export { makeKeyStore, type KeyStore, type KeyStoreConfig } from './client/keys.ts';
+export { wordlist } from './client/wordlist.ts';
+/** 伺服器端原語（Cloudflare Workers + D1）。 */
+export { makeInboundCipher, isCipherFor, validWrappedKey, validHash64, validSalt, pickKeyPackage, loginRouteCore, errResponse, AUTH_RATE, type AuthRow, type AuthStore, type CipherFormats, type KeyPackage, } from './server/auth.ts';
+export { checkRate, type RateWindow } from './server/ratelimit.ts';
+export { corsResponse, CORS_HEADERS } from './server/cors.ts';
+export { sha256Hex, hashString, generateSessionToken, timingSafeEq, } from './server/hash.ts';
+export type { Env } from './server/env.ts';
+export { PH2_LADDER_TABLE, PH2_LADDER_KIND_LEGACY, PH2_LADDER_KIND_V2, type Ph2LadderKind, type Ph2LadderRow, } from './server/ladder.ts';

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * index.ts — 公開 API barrel。
+ *
+ * 客戶端原語（WebCrypto；Argon2id 瀏覽器載體見 argon2.ts 檔頭 setArgonLoader）：
+ */
+export { makeHeldKey, generateNoteKey, encryptNote, decryptNote, encryptAttach, decryptAttach, encryptLocal, decryptLocal, wrapNoteKey, unwrapNoteKey, wrapNoteKeyWithRecToken, unwrapNoteKeyWithRecToken, wrapNoteKeyDual, unwrapNoteKeyDual, storeLocalWrap, clearLocalWrap, buildBindPayload, ph1Of, normalizePin, normalizePassphrase, recTokenHash, generateRecToken, PBKDF2_ITERATIONS, PIN_PBKDF2_ITERATIONS, } from './client/note-crypto.js';
+export { setArgonLoader, verifyArgonKat, wrapNoteKey3, unwrapNoteKey3, wrapNoteKeyDual3, unwrapNoteKeyDual3, wrapNoteKey4, unwrapNoteKey4, wrapNoteKeyDual4, unwrapNoteKeyDual4, wrapNoteKeyShare3, unwrapNoteKeyShare3, derivePh1Argon, derivePh1ArgonV3, PH1_V2_SALT, PH1_V3_SALT, ARGON_MEMORY_KIB, ARGON_ITERATIONS, ARGON_PARALLELISM, ARGON_TAG_LEN, } from './client/argon2.js';
+export { wrapNoteKeyPinLock, unwrapNoteKeyPinLock, PINLOCK_ITERATIONS, } from './client/pinlock.js';
+export { generateBip39Words, wordsToRecToken, recTokenToWords, spotCheckIndexes, } from './client/bip39.js';
+export { makeKeyStore } from './client/keys.js';
+export { wordlist } from './client/wordlist.js';
+/** 伺服器端原語（Cloudflare Workers + D1）。 */
+export { makeInboundCipher, isCipherFor, validWrappedKey, validHash64, validSalt, pickKeyPackage, loginRouteCore, errResponse, AUTH_RATE, } from './server/auth.js';
+export { checkRate } from './server/ratelimit.js';
+export { corsResponse, CORS_HEADERS } from './server/cors.js';
+export { sha256Hex, hashString, generateSessionToken, timingSafeEq, } from './server/hash.js';
+export { PH2_LADDER_TABLE, PH2_LADDER_KIND_LEGACY, PH2_LADDER_KIND_V2, } from './server/ladder.js';

package/dist/server/auth.d.ts

@@ -0,0 +1,99 @@
+/**
+ * auth.ts — 零知識伺服器端 auth 核心邏輯（品牌／schema 參數化）。
+ *
+ * 本檔實作的契約：
+ * - pass 明文永不過線：線上憑證送 PH1（雜湊形），伺服器存 PH2 = SHA-256(PH1)。
+ *   PH1 派生方式由各產品自定義（快雜湊或 Argon2id 派生皆可）——本層只驗
+ *   hex64 形，不驗 PH1 派生方式（伺服器零知識，無從也無需區分形別）。
+ * - 入庫前密文／包裹格式驗證（inboundCipher／isCipherFor／validWrappedKey／
+ *   pickKeyPackage 等，前綴由 config 注入）。
+ * - /auth/login 核心動線（loginRouteCore）：rate-limit 閘 → PH1 驗形 →
+ *   PH2 → store 查詢（現值 miss → ladder 查表守衛——0.2.4 內建，optional 未配置
+ *   即退場）／建號 → session token 簽發（30 天）。
+ *
+ * 呼叫端（fork）職責——本檔只定義介面，機制在呼叫端實作：
+ * - identity 生成：AuthStore.createUser 由各 fork 自決（隨機 account_id 或
+ *   客戶端帶入語意皆可）；PH2 UNIQUE 衝突（兩個同時首登同密語）是 store
+ *   責任——tacet 參考實作：UNIQUE 失敗重查既有列回 userKey（非 5xx）。
+ * - hash-ladder 雙軌（舊式 PH1 直比 → 升級寫回 PH2）與密語重設後的 session
+ *   撤銷時機：fork 呼叫端接線（revokeAllSessions 介面已備）；ladder 查表守衛已
+ *   內建 loginRouteCore（optional——fork 只需配 ladderLookup＋0011 migration，接線零寫）。
+ * - 常數時間比較 timingSafeEq：./hash.ts 匯出（login 動線經 PH2 查詢不直比）。
+ *
+ * 不變量（勿破壞）：
+ * - 金鑰包裹欄組（wrapped+salt）缺一整組放棄——pair 檢查本體在 pickKeyPackage。
+ * - recPkg 與 recHash 成對出現＝呼叫端（fork store）職責：本層介面兩參各自可空、
+ *   不做 pair 檢查（裁定照此收口；pickKeyPackage 是同職責的成對檢查先例）。
+ */
+import { type RateWindow } from './ratelimit.ts';
+import type { Env } from './env.ts';
+export interface CipherFormats {
+    /** 密文前綴家族字面（startsWith 語意，非 regex 來源），如 'jr1b.'。 */
+    cipherPrefixes: [string, string];
+    /** 金鑰包裹前綴，如 'jr1w.'。 */
+    wrapPrefix: string;
+    /** 密文上限：UTF-16 code unit 計數（.length 語意；非 UTF-8 bytes）。 */
+    cipherMax: number;
+}
+/**
+ * 入庫前校正：前綴密文原樣入庫；超限密文／編碼丟棄（截斷必壞）、明文截到上限照收。
+ * cipherMax（UTF-16 單位）同為明文截斷帽：明文相容層無 opt-out——明文一律照收、
+ * 截到 cipherMax 入庫（JSDoc 幽靈參數 plainMax 已摘除）。
+ */
+export declare function makeInboundCipher(c: CipherFormats): (raw: unknown) => string | null;
+export declare function isCipherFor(text: string | null | undefined, c: CipherFormats): boolean;
+export declare function validWrappedKey(v: unknown, wrapPrefix: string | string[]): string | null;
+export declare function validHash64(v: unknown): string | null;
+export declare function validSalt(v: unknown): string | null;
+/** 綁定/復原共用的金鑰包裹欄組：wrapped 與 salt 必須成對，缺一整組放棄。 */
+export declare function pickKeyPackage(body: any, wrapPrefix: string | string[]): {
+    wrapped: string | null;
+    salt: string | null;
+};
+export interface KeyPackage {
+    wrapped: string;
+    salt: string;
+}
+export interface AuthStore {
+    /** 以 PH2 查身份（PH2 UNIQUE；tacet：隨機 account_id 在此建立）。 */
+    findByIdentityQuery(ph2: string): Promise<AuthRow | null>;
+    /** 建立（identity 生成由各 fork 自決——見檔頭「呼叫端職責」；PH2 UNIQUE 衝突亦是 store 責任）。 */
+    createUser(ph2: string): Promise<string>;
+    getByUserKey(key: string): Promise<AuthRow | null>;
+    getByRecHash(recHash: string): Promise<AuthRow | null>;
+    setWrapped(userKey: string, ph2: string, pkg: KeyPackage, recPkg: string | null, recHash: string | null): Promise<void>;
+    /** v3 重鑰：舊值入 ladder 表＋ph2/wrapped/salt/wrappedRec/rec_hash
+     *  五欄同列覆蓋（rec 欄在場才覆蓋——四欄形契約面不動；fork 實作三語句同批寫入）。 */
+    rekeyWithLadder?(userKey: string, oldPh2: string, oldKind: 'legacy' | 'v2', ph2: string, pkg: KeyPackage, recPkg: string | null, recHash: string | null): Promise<void>;
+    /**
+     * ladder 查表：以「舊 ph2 值」（v2/legacy 形）查 ladder 表，命中回帳戶 id。
+     * loginRouteCore 內建接線（0.2.4 外審 #8 幽靈守衛上位）：現值 miss → ladderLookup →
+     * 命中＝回舊帳（不建幽靈；ph2Kind 語意照 ladder.ts 檔頭註解——core 端回帳序：
+     * ladder hit → getByUserKey → 可續 buildSession），兩面皆 miss 才 createUser。
+     * 未配置（optional undefined）＝查表面退場（現行單查行為零變——向後相容：
+     * fork 未配 ladder（0011 未上）時行為與 0.2.3 恆等，sennight/vestige 未來接 core 也零炸）。
+     * 錯誤處理照 tacet store.ts 母型：lookup 拋任何錯（0011 未上的 ladder 表缺席、ladder store
+     * 停機故障）＝fail-open 視同 miss，不炸登入（ladder store 停機中登入＝建幽靈——fail-open
+     * 語意的已知代價；接線端 ladderGuard 統一 catch 只包 lookup）＋非 lookup 錯誤照常外拋。
+     */
+    ladderLookup?(oldPh2: string): Promise<string | null>;
+    /** ladder 入表（遷移線用；upsert冪等）。 */
+    ladderInsert?(accountId: string, oldPh2: string, oldKind: 'legacy' | 'v2'): Promise<void>;
+    /** ladder 刪列（直銷面；遷移批次同批或後續呼叫端承擔）。 */
+    ladderDelete?(accountId: string): Promise<void>;
+    revokeAllSessions(userKey: string): Promise<void>;
+    insertSession(tokenHash: string, userKey: string, expiresAt: number): Promise<void>;
+}
+export interface AuthRow {
+    userKey: string;
+    ph2: string | null;
+    salt: string | null;
+    wrapped: string | null;
+    wrappedRec: string | null;
+    recHash: string | null;
+    /** 訂閱方案（tacet：users.plan，'free'/'paid'）；兄弟 fork 無訂閱面時預設 'free'。 */
+    plan?: string;
+}
+export declare const AUTH_RATE: RateWindow;
+export declare function errResponse(code: string, status: number): Response;
+export declare function loginRouteCore(env: Env & Record<string, unknown>, store: AuthStore, ip: string, ph1In: unknown): Promise<Response>;