Phase 1 of the 4-package split called out in RoadMap #3. Moves the "infrastructure" leaves — files with zero business dependencies that @snowluma/bridge, @snowluma/core, and @snowluma/onebot all consume — into a dedicated workspace package. Mirrors what #4 (proto-defs) did for wire-protobuf definitions. Why --- - Cleaner layering: these were never bridge- or onebot-specific. Logger / hex codec / runtime config sit at the bottom of every module's import graph; giving them their own package makes that graph readable and prevents future leaks the other direction. - Sets up #3's bridge + onebot extractions: those need a clean leaf to depend on. Without this, every cross-package import would have to re-export through core, which defeats the split. - Mirrors @snowluma/proto-defs layout — per-file subpath exports (`@snowluma/common/logger`, `@snowluma/common/hex`, …) keep import sites unambiguous and let bundlers tree-shake aggressively. Layout ------ Moved (via `git mv` — history preserved): packages/core/src/utils/logger.ts → @snowluma/common/logger packages/core/src/utils/hex.ts → @snowluma/common/hex packages/core/src/utils/log-file-transport.ts → @snowluma/common/log-file-transport packages/core/src/utils/log-summary.ts → @snowluma/common/log-summary packages/core/src/protocol/packet-sender.ts → @snowluma/common/packet-sender packages/core/src/protocol/types.ts → @snowluma/common/protocol-types packages/core/src/common/runtime.ts → @snowluma/common/runtime Not moved (deferred to Phase 2): `packages/core/src/utils/event-format.ts` — it has reverse imports on `bridge/events`, `bridge/identity-service`, `onebot/message-store`, `onebot/types`. It moves into @snowluma/bridge in Phase 2, with the MessageStore parameter decoupled via a structural type so bridge doesn't end up depending on onebot. Changes ------- - New package `packages/common/` (package.json, tsconfig.json — no src/index.ts barrel, callers use the subpath exports directly to avoid pulling in `node:fs` when only the hex codec is needed). - 7 `.ts` files moved via `git mv`. - 50+ import sites rewritten via sed across `packages/core/src` and `packages/core/tests`. Old shapes (`../utils/logger`, `../../protocol/types`, `./common/runtime`, `../src/utils/hex`) all collapse to `@snowluma/common/<sub>`. - `@snowluma/core` depends on `@snowluma/common` (workspace:*). - `packages/core/src/{protocol,common}/` directories removed (empty). Verification ------------ - core typecheck: clean - common typecheck: clean - Full workspace `pnpm -r typecheck`: all 9 projects clean - core test suite: 552 passed / 552 total (pre-existing websocket-darwin-arm64.node addon failure unchanged — same baseline as the previous refactor commits) - Vite build with stubbed native binary: clean (143 modules, 2.84 MB bundle, 224 KB gzip — same size envelope as before) Note: `utils/event-format.ts` is the only file remaining under the old `utils/` namespace. It moves into @snowluma/bridge alongside the events / identity-service / packet-pipeline trio in Phase 2.
36 lines
979 B
TypeScript
36 lines
979 B
TypeScript
const HEX_CHARS = '0123456789abcdef';
|
|
const HEX_CHARS_UPPER = '0123456789ABCDEF';
|
|
|
|
export function toHex(data: Uint8Array | Buffer): string {
|
|
let h = '';
|
|
for (const b of data) {
|
|
h += HEX_CHARS[b >> 4];
|
|
h += HEX_CHARS[b & 0xf];
|
|
}
|
|
return h;
|
|
}
|
|
|
|
export function toHexUpper(data: Uint8Array | Buffer): string {
|
|
let h = '';
|
|
for (const b of data) {
|
|
h += HEX_CHARS_UPPER[b >> 4];
|
|
h += HEX_CHARS_UPPER[b & 0xf];
|
|
}
|
|
return h;
|
|
}
|
|
|
|
export function hexPreview(data: Uint8Array | Buffer, maxBytes = 64): string {
|
|
const limit = Math.max(0, Math.min(maxBytes, data.length));
|
|
const head = toHex(data.subarray(0, limit));
|
|
return data.length > limit ? `${head}...` : head;
|
|
}
|
|
|
|
export function fromHex(hex: string): Buffer {
|
|
if (hex.length % 2 !== 0) throw new Error('Invalid hex string length');
|
|
const buf = Buffer.alloc(hex.length / 2);
|
|
for (let i = 0; i < buf.length; i++) {
|
|
buf[i] = parseInt(hex.substring(i * 2, i * 2 + 2), 16);
|
|
}
|
|
return buf;
|
|
}
|