@fidt/saul-server 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/dist/index.cjs +3 -0
  2. package/dist/index.cjs.map +1 -0
  3. package/dist/index.d.cts +464 -0
  4. package/dist/index.d.ts +464 -0
  5. package/dist/index.js +3 -0
  6. package/dist/index.js.map +1 -0
  7. package/package.json +34 -6
  8. package/src/index.ts +0 -7
  9. package/tsconfig.json +0 -18
package/dist/index.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/models/file.ts","../src/models/fileStream.ts","../src/models/saulException.ts","../src/models/predicate.ts","../src/upload/UploadError.ts","../src/upload/PartDiskStore.ts","../src/upload/UploadRegistry.ts","../src/upload/UploadSweeper.ts","../src/upload/concatParts.ts","../src/upload/uploadRouter.ts"],"names":["File","meta","buffer","base64","uint8Array","FILE_STREAM_BRAND","FileStream","_FileStream","metadata","source","destination","pipeline","maxBytes","chunks","total","chunk","buf","value","data","Readable","SaulException","_SaulException","message","code","narrow","predicates","present","p","UploadError","_UploadError","UPLOAD_ERROR_STATUS","uploadErrorStatus","READ_HIGH_WATER_MARK","PartDiskStore","options","uploadId","assertSafeUploadId","join","partNumber","partCount","assertSafePartNumber","mkdir","body","opts","finalPath","tmpPath","handle","open","err","hash","createHash","received","limit","meter","Transform","_enc","cb","unlink","etag","rename","createReadStream","entries","readdir","parts","entry","match","info","stat","a","b","dir","freed","rm","olderThanMs","now","stale","file","fileInfo","META_FILE","UploadRegistry","bytes","record","full","allowed","deltaBytes","tmp","writeFile","raw","readFile","UploadSweeper","result","dirName","actual","concatParts","store","partNumbers","generate","envInt","key","fallback","n","envBool","createUploadSubsystem","tmpdir","registry","sweeper","maxPartBytes","router","Hono","c","contentLength","before","ctx","missing","sum","ordered","fileStream"],"mappings":"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","file":"index.js","sourcesContent":["export class File {\n private content: string | null\n\n public metadata: {\n name: string\n size: number\n type: string\n }\n\n constructor(meta?: { name: string, size: number, type: string }) {\n this.metadata = meta || { name: '', size: 0, type: '' }\n this.content = ''\n }\n\n private encodeBase64(buffer: ArrayBuffer): string {\n return Buffer.from(buffer).toString('base64');\n }\n\n private decodeBase64(base64: string): ArrayBuffer {\n const buffer = Buffer.from(base64, 'base64');\n const uint8Array = new Uint8Array(buffer.length);\n buffer.copy(uint8Array);\n return uint8Array.buffer;\n }\n\n /**\n * Đọc tất cả nội dụng của file\n */\n read(): ArrayBuffer {\n if (!this.content) {\n throw new Error('File content is not set')\n }\n return this.decodeBase64(this.content)\n }\n\n /**\n * Ghi nội dung vào file\n */\n write(buffer: ArrayBuffer) {\n this.content = this.encodeBase64(buffer)\n }\n}\n\n","import { Readable, type Writable } from 'stream'\nimport { pipeline } from 'stream/promises'\n\n/**\n * FILE DẠNG STREAM — cho file mà cả nội dung KHÔNG được phép nằm trong RAM.\n *\n * Khác `File` (buffered, giữ base64 trong bộ nhớ, trần vài chục MB), `FileStream` chỉ giữ\n * metadata + một hàm mở nguồn. Byte chỉ chảy khi có người đọc, nên RAM là hằng số bất kể\n * file 8MB hay 8GB.\n *\n * Dùng được ở CẢ HAI vị trí trong definition:\n * - param → chiều lên: multipart upload, gateway/downstream đưa `Readable` vào đây.\n * - returnType → chiều xuống: handler trả về, runtime pipe thẳng ra browser.\n *\n * Khai kiểu nào là chọn hợp đồng đó. Transport KHÔNG được đánh tráo `File` thành\n * `FileStream` hay ngược lại — một param có shape phụ thuộc transport là thứ tuyệt đối\n * không được xảy ra.\n */\n\n/** Brand để nhận diện qua ranh giới package — xem `FileStream.is`. */\nconst FILE_STREAM_BRAND = Symbol.for('@fidt/saul.FileStream')\n\nexport interface FileStreamMetadata {\n name: string\n /** Kích thước KHAI BÁO. `0` = không biết trước (dữ liệu sinh on-the-fly). */\n size: number\n type: string\n}\n\nexport class FileStream {\n /** @internal Đánh dấu instance để `is()` nhận ra qua nhiều bản copy của package. */\n readonly [FILE_STREAM_BRAND] = true as const\n\n readonly metadata: FileStreamMetadata\n\n private readonly source: () => Readable\n private consumed = false\n\n constructor(metadata: FileStreamMetadata, source: () => Readable) {\n this.metadata = metadata\n this.source = source\n }\n\n /**\n * Mở nguồn và trả về `Readable`.\n *\n * Gọi lần thứ hai sẽ NÉM. Một stream không phải là value: đọc hai lần thì lần thứ hai\n * hoặc rỗng, hoặc mở lại nguồn và trả về dữ liệu đã cũ — cả hai đều là bug im lặng.\n * Cần đọc nhiều lần thì `buffer()` một lần rồi tự giữ.\n */\n stream(): Readable {\n if (this.consumed) {\n throw new Error(\n `FILE_STREAM_CONSUMED: '${this.metadata.name}' đã được đọc rồi — một FileStream chỉ tiêu thụ được một lần`\n )\n }\n this.consumed = true\n return this.source()\n }\n\n /** Đã có ai đọc chưa — cho runtime biết có phải drain trước khi trả response không. */\n get isConsumed(): boolean {\n return this.consumed\n }\n\n /** Đẩy toàn bộ nội dung vào một `Writable`, chờ tới khi xong. */\n async pipeTo(destination: Writable): Promise<void> {\n await pipeline(this.stream(), destination)\n }\n\n /**\n * Đọc hết vào một `Buffer`.\n *\n * `maxBytes` là BẮT BUỘC, không có mặc định: đây là escape hatch duy nhất ra khỏi mô hình\n * streaming, và người dùng nó phải tự nói ra trần mình chấp nhận. Một `buffer()` không\n * trần đặt giữa đường xử lý file 3GB sẽ giết process — mà chỉ giết trong production, với\n * file lớn, chứ không bao giờ trong test.\n */\n async buffer(maxBytes: number): Promise<Buffer> {\n const chunks: Buffer[] = []\n let total = 0\n\n for await (const chunk of this.stream()) {\n const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk as Uint8Array)\n total += buf.length\n if (total > maxBytes) {\n throw new Error(\n `FILE_STREAM_TOO_LARGE: '${this.metadata.name}' vượt ${maxBytes} byte khi buffer()`\n )\n }\n chunks.push(buf)\n }\n\n return Buffer.concat(chunks, total)\n }\n\n /**\n * Có phải `FileStream` không.\n *\n * Dùng brand chứ KHÔNG dùng `instanceof`: gateway và downstream có thể resolve hai bản\n * copy khác nhau của `@fidt/saul-server` (dual-package hazard), lúc đó `instanceof` trả\n * `false` cho một object hoàn toàn hợp lệ — và nó hỏng theo kiểu chỉ lộ ra khi deploy\n * thật, không bao giờ trong monorepo.\n */\n static is(value: unknown): value is FileStream {\n return (\n typeof value === 'object' &&\n value !== null &&\n (value as Record<symbol, unknown>)[FILE_STREAM_BRAND] === true\n )\n }\n\n /** Dựng từ một `Buffer` sẵn có — tiện cho test và cho handler trả dữ liệu nhỏ. */\n static fromBuffer(metadata: Omit<FileStreamMetadata, 'size'> & { size?: number }, data: Buffer): FileStream {\n return new FileStream(\n { ...metadata, size: metadata.size ?? data.length },\n () => Readable.from(data)\n )\n }\n}\n","/**\n * SaulException — lỗi NGHIỆP VỤ mà handler chủ động ném để từ chối một lời gọi.\n *\n * Khác `Error` trần ở đúng hai điểm, và cả hai đều là lý do nó tồn tại:\n *\n * 1. **Có `code`** đi qua được dây. Envelope lỗi của downstream mang cả `message` lẫn\n * `code`, gateway map sang ack `{ ok:false, error, code }`, client dựng lại thành\n * `SaulException` — nên client bắt được lỗi theo mã chứ không phải so khớp chuỗi tiếng\n * Việt. `Error` trần chỉ còn lại `message` sau chuyến đi.\n * 2. **Là ý ĐỊNH từ chối, không phải sự cố.** Gateway log `Error` lạ như một lỗi server,\n * còn `SaulException` là câu trả lời hợp lệ (\"bạn không được sub chat của người khác\")\n * nên không cần ồn ào trong log.\n *\n * Chỗ dùng chính là validator của subscription: controller `sub<Model>` ném `SaulException`\n * để từ chối, và cái ném đó nổi lên đúng chỗ client đang `catch` quanh vòng `for await`.\n */\nexport class SaulException extends Error {\n /** Mã ổn định để client rẽ nhánh. Mặc định là mã chung của một từ chối nghiệp vụ. */\n readonly code: string;\n\n constructor(message: string, code: string = 'SAUL_EXCEPTION') {\n super(message);\n this.name = 'SaulException';\n this.code = code;\n // Bắt buộc khi target ES5/ES2015: không có dòng này thì `instanceof SaulException`\n // trả false ở chính nơi người ta sẽ dùng nó nhiều nhất — khối catch.\n Object.setPrototypeOf(this, new.target.prototype);\n }\n\n /**\n * Nhận diện KHÔNG dùng `instanceof`.\n *\n * Gateway, downstream và SDK có thể resolve ba bản copy vật lý khác nhau của package\n * này (pnpm workspace + code sinh ra được copy vào từng service), nên `instanceof` sẽ\n * trả false cho một SaulException hoàn toàn thật. Cùng lý do với `FileStream.is`.\n */\n static is(value: unknown): value is SaulException {\n return (\n value instanceof SaulException ||\n (value instanceof Error && (value as { name?: string }).name === 'SaulException')\n );\n }\n}\n","/**\n * PREDICATE — điều kiện lọc mà client khai khi mở một subscription.\n *\n * File này CHỈ có kiểu, không có runtime: việc đánh giá predicate xảy ra ở GATEWAY (nó giữ\n * socket và biết ai đang nghe gì), không ở downstream. Downstream chỉ cần đọc và thu hẹp\n * predicate trong validator `sub<Model>` rồi trả về.\n *\n * Cú pháp `$`-prefix, cố ý KHÁC filter authz kiểu Directus (`_eq`, `_or`) ở\n * `Permission.filter`. Hai thứ trả lời hai câu hỏi khác nhau — filter authz nói \"được thấy\n * BẢN GHI nào\" và được forward xuống query storage; predicate nói \"muốn nhận EVENT nào\" và\n * được Saul tự đánh giá in-memory. Trộn cú pháp sẽ khiến người đọc tưởng chúng thay nhau được.\n */\n\n/** So sánh trên một field. Nhiều toán tử trong cùng object thì AND với nhau. */\nexport interface PredicateComparison<V> {\n $eq?: V;\n $ne?: V;\n $gt?: V;\n $gte?: V;\n $lt?: V;\n $lte?: V;\n $in?: V[];\n $nin?: V[];\n /** Field có mặt trong payload hay không — nói về SỰ CÓ MẶT, không phải giá trị. */\n $exists?: boolean;\n}\n\n/**\n * Predicate trên một Model.\n *\n * Giá trị trần là shorthand của `$eq`: `{ chatId: 12 }` ≡ `{ chatId: { $eq: 12 } }`.\n * Các key cùng cấp AND với nhau, nên `{}` khớp TẤT CẢ — đó là lý do validator `sub<Model>`\n * mặc định TỪ CHỐI, và là lý do nên thu hẹp predicate thay vì chỉ kiểm rồi trả nguyên.\n *\n * KHÔNG có `$regex`: nó là đường ReDoS do client tự khai, chạy ở đường nóng của mọi lần push.\n */\nexport type Predicate<T> = {\n [K in keyof T]?: T[K] | PredicateComparison<T[K]>;\n} & {\n $and?: Predicate<T>[];\n $or?: Predicate<T>[];\n $not?: Predicate<T>;\n};\n\n/**\n * Một subscription đang mở, nhìn từ phía server.\n *\n * `id` do gateway sinh TRƯỚC khi gọi validator và truyền xuống qua `ctx.subId`, nên\n * validator lưu lại được để về sau `sub<Model>.unsub(id)` thu hồi (vd user bị mời khỏi\n * phòng chat trong lúc đang nghe).\n */\nexport interface Sub<T> {\n id: string;\n predicate: Predicate<T>;\n}\n\n/**\n * Gộp nhiều predicate bằng AND — cách chuẩn để validator THU HẸP thứ client xin.\n *\n * ```ts\n * return narrow(predicate, { userId: { $eq: ctx.principal.sub } })\n * ```\n *\n * Dùng `$and` thay vì trải phẳng bằng spread: spread sẽ để điều kiện sau GHI ĐÈ điều kiện\n * trước trên cùng một field, tức là client khai `{ userId: { $eq: 'ai-đó' } }` rồi ràng\n * buộc bảo mật ghi đè lên — đúng ý. Nhưng ở chiều ngược lại (`{...cứng, ...client}`) thì\n * client ghi đè ràng buộc bảo mật. `$and` không có chiều nào để nhầm: mọi nhánh đều phải thoả.\n */\nexport const narrow = <T>(...predicates: (Predicate<T> | null | undefined)[]): Predicate<T> => {\n const present = predicates.filter((p): p is Predicate<T> => !!p && Object.keys(p).length > 0);\n if (present.length === 0) return {} as Predicate<T>;\n if (present.length === 1) return present[0];\n return { $and: present } as Predicate<T>;\n};\n","/**\n * LỖI CỦA CHUNK STORE, có mã máy-đọc-được.\n *\n * Cùng kiểu với `BinaryStreamError` của đường WebSocket: mỗi tình huống một `code`, và mã\n * đó — chứ không phải chuỗi message — là thứ tầng trên map sang HTTP status. Một bảng map\n * duy nhất, không handler nào tự viết status.\n */\n\nexport type UploadErrorCode =\n | 'UPLOAD_NOT_FOUND'\n | 'UPLOAD_EXISTS'\n | 'UPLOAD_EXPIRED'\n | 'UPLOAD_COMPLETED'\n /** Đang complete dở — một lời gọi complete khác đã chiếm chỗ. */\n | 'UPLOAD_BUSY'\n | 'PART_OUT_OF_RANGE'\n | 'PART_IN_FLIGHT'\n | 'PART_TOO_LARGE'\n | 'PART_MISSING'\n | 'SIZE_MISMATCH'\n | 'CHECKSUM_MISMATCH'\n | 'DISK_BUDGET'\n | 'FORBIDDEN'\n\nexport class UploadError extends Error {\n constructor(\n public readonly code: UploadErrorCode,\n message: string\n ) {\n super(message)\n this.name = 'UploadError'\n }\n\n static is(value: unknown): value is UploadError {\n return value instanceof UploadError\n }\n}\n\n/**\n * MÃ LỖI → HTTP STATUS. Bảng DUY NHẤT, và nó phải phủ hết `UploadErrorCode`.\n *\n * `Record<UploadErrorCode, number>` cố ý không optional: thêm một mã mới mà quên map thì\n * TypeScript báo ngay, thay vì lặng lẽ trả 500 cho một lỗi vốn có nghĩa rõ ràng.\n */\nexport const UPLOAD_ERROR_STATUS: Record<UploadErrorCode, number> = {\n UPLOAD_NOT_FOUND: 404,\n UPLOAD_EXISTS: 409,\n // 410 chứ không 404: upload TỪNG tồn tại, client nên dừng retry và làm lại từ init.\n UPLOAD_EXPIRED: 410,\n UPLOAD_COMPLETED: 409,\n UPLOAD_BUSY: 409,\n PART_OUT_OF_RANGE: 416,\n PART_IN_FLIGHT: 409,\n PART_TOO_LARGE: 413,\n PART_MISSING: 422,\n SIZE_MISMATCH: 422,\n CHECKSUM_MISMATCH: 422,\n // 503 = lỗi TẠM THỜI: client nên backoff rồi thử lại, không phải báo lỗi cho người dùng.\n DISK_BUDGET: 503,\n FORBIDDEN: 403,\n}\n\nexport const uploadErrorStatus = (code: UploadErrorCode): number => UPLOAD_ERROR_STATUS[code] ?? 500\n","import { createHash } from 'crypto'\nimport { createReadStream, createWriteStream } from 'fs'\nimport { mkdir, open, readdir, rename, rm, stat, unlink } from 'fs/promises'\nimport { join } from 'path'\nimport { Readable, Transform } from 'stream'\nimport { pipeline } from 'stream/promises'\n\nimport { UploadError } from './UploadError.ts'\n\n/**\n * LƯU PART RA ĐĨA. Chỉ đĩa — không biết gì về Redis, HTTP hay vòng đời upload.\n *\n * Mỗi upload là một thư mục, mỗi part là một file. Không có gì thông minh ở đây, và đó là\n * chủ ý: thứ duy nhất cần đúng tuyệt đối là **không bao giờ giữ cả part trong RAM** và\n * **không bao giờ để lại một `.part` nửa vời mà tầng trên tưởng là hoàn chỉnh**.\n */\n\n/** Kích thước đọc khi ghép part. Đủ lớn để không syscall liên tục, đủ nhỏ để RAM phẳng. */\nconst READ_HIGH_WATER_MARK = 1024 * 1024\n\nexport interface WritePartResult {\n size: number\n /** sha256 hex của part — client dùng để retry có kiểm chứng. */\n etag: string\n}\n\nexport interface PartInfo {\n partNumber: number\n size: number\n}\n\nexport interface PartDiskStoreOptions {\n /** Thư mục gốc. Mỗi upload một thư mục con. */\n rootDir: string\n /** fsync mỗi part trước khi rename. Tắt = đổi durability-khi-crash lấy throughput. */\n fsync?: boolean\n}\n\nexport class PartDiskStore {\n private readonly rootDir: string\n private readonly fsync: boolean\n\n constructor(options: PartDiskStoreOptions) {\n this.rootDir = options.rootDir\n this.fsync = options.fsync ?? true\n }\n\n /**\n * Thư mục của một upload.\n *\n * `assertSafeUploadId` chạy TRƯỚC `join` — đây là bề mặt path-traversal duy nhất của\n * cả tính năng, và `join('/tmp', '../../etc')` là một đường dẫn hoàn toàn hợp lệ.\n */\n dirFor(uploadId: string): string {\n assertSafeUploadId(uploadId)\n return join(this.rootDir, uploadId)\n }\n\n private pathFor(uploadId: string, partNumber: number, partCount: number): string {\n assertSafePartNumber(partNumber, partCount)\n // Đệm 0 để thứ tự tên file trùng thứ tự part — tiện khi soi bằng `ls` lúc debug.\n return join(this.dirFor(uploadId), `${String(partNumber).padStart(6, '0')}.part`)\n }\n\n async ensureDir(uploadId: string): Promise<void> {\n await mkdir(this.dirFor(uploadId), { recursive: true })\n }\n\n /**\n * Ghi một part. Trả về số byte thật và sha256.\n *\n * Bốn bước, thứ tự bắt buộc:\n * 1. `open(tmp, 'wx')` — hai PUT cùng part cùng lúc thì một cái thua ngay, thay vì\n * hai writer xen kẽ vào cùng một file.\n * 2. pipeline có đếm byte + hash — vượt trần là abort GIỮA CHỪNG, không đọc hết rồi\n * mới than.\n * 3. fsync (nếu bật) rồi `rename` — rename trong cùng filesystem là atomic, nên\n * file `.part` xuất hiện là đã hoàn chỉnh, không có trạng thái nửa vời.\n * 4. Chỉ khi rename xong mới coi như part tồn tại.\n */\n async writePart(\n uploadId: string,\n partNumber: number,\n body: Readable,\n opts: { maxBytes: number; partCount: number; declaredLength?: number; expectedSha256?: string }\n ): Promise<WritePartResult> {\n const finalPath = this.pathFor(uploadId, partNumber, opts.partCount)\n const tmpPath = `${finalPath}.tmp`\n\n await this.ensureDir(uploadId)\n\n let handle\n try {\n handle = await open(tmpPath, 'wx')\n } catch (err: any) {\n if (err?.code === 'EEXIST') {\n throw new UploadError(\n 'PART_IN_FLIGHT',\n `Part ${partNumber} của '${uploadId}' đang được ghi bởi một request khác`\n )\n }\n throw err\n }\n\n const hash = createHash('sha256')\n let received = 0\n const limit = opts.declaredLength !== undefined\n ? Math.min(opts.maxBytes, opts.declaredLength)\n : opts.maxBytes\n\n const meter = new Transform({\n transform(chunk, _enc, cb) {\n received += chunk.length\n if (received > limit) {\n // Huỷ NGAY, không đợi hết body: mục đích của trần là không nhận byte\n // thừa, chứ không phải nhận xong rồi mới từ chối.\n cb(new UploadError('PART_TOO_LARGE', `Part ${partNumber} vượt ${limit} byte`))\n return\n }\n hash.update(chunk)\n cb(null, chunk)\n },\n })\n\n try {\n await pipeline(body, meter, handle.createWriteStream())\n if (this.fsync) await handle.sync()\n } catch (err) {\n await handle.close().catch(() => undefined)\n await unlink(tmpPath).catch(() => undefined)\n throw err\n }\n await handle.close()\n\n if (opts.declaredLength !== undefined && received !== opts.declaredLength) {\n await unlink(tmpPath).catch(() => undefined)\n throw new UploadError(\n 'SIZE_MISMATCH',\n `Part ${partNumber}: nhận ${received} byte, content-length khai ${opts.declaredLength}`\n )\n }\n\n const etag = hash.digest('hex')\n if (opts.expectedSha256 && opts.expectedSha256 !== etag) {\n await unlink(tmpPath).catch(() => undefined)\n throw new UploadError(\n 'CHECKSUM_MISMATCH',\n `Part ${partNumber}: sha256 không khớp (khai ${opts.expectedSha256}, thật ${etag})`\n )\n }\n\n // Ghi đè part cũ là HỢP LỆ và cần thiết: đó chính là thứ làm retry từng part an toàn.\n await rename(tmpPath, finalPath)\n\n return { size: received, etag }\n }\n\n /** Mở một part để đọc. Dùng bởi `concatParts`. */\n createPartStream(uploadId: string, partNumber: number, partCount: number): Readable {\n return createReadStream(this.pathFor(uploadId, partNumber, partCount), {\n highWaterMark: READ_HIGH_WATER_MARK,\n })\n }\n\n /** Các part ĐANG CÓ THẬT trên đĩa (không tính `.tmp`). */\n async listParts(uploadId: string): Promise<PartInfo[]> {\n let entries: string[]\n try {\n entries = await readdir(this.dirFor(uploadId))\n } catch (err: any) {\n if (err?.code === 'ENOENT') return []\n throw err\n }\n\n const parts: PartInfo[] = []\n for (const entry of entries) {\n const match = /^(\\d{6})\\.part$/.exec(entry)\n if (!match) continue\n const info = await stat(join(this.dirFor(uploadId), entry))\n parts.push({ partNumber: Number.parseInt(match[1], 10), size: info.size })\n }\n return parts.sort((a, b) => a.partNumber - b.partNumber)\n }\n\n /** Xoá cả thư mục upload. Trả về số byte giải phóng. Idempotent. */\n async removeUpload(uploadId: string): Promise<number> {\n const dir = this.dirFor(uploadId)\n let freed = 0\n try {\n for (const entry of await readdir(dir)) {\n const info = await stat(join(dir, entry)).catch(() => undefined)\n if (info) freed += info.size\n }\n } catch (err: any) {\n if (err?.code === 'ENOENT') return 0\n throw err\n }\n await rm(dir, { recursive: true, force: true })\n return freed\n }\n\n /** Thư mục cũ hơn `olderThanMs` — ứng viên dọn rác. Xem `UploadSweeper`. */\n async listStaleDirs(olderThanMs: number, now: number = Date.now()): Promise<string[]> {\n let entries: string[]\n try {\n entries = await readdir(this.rootDir)\n } catch (err: any) {\n if (err?.code === 'ENOENT') return []\n throw err\n }\n\n const stale: string[] = []\n for (const entry of entries) {\n const info = await stat(join(this.rootDir, entry)).catch(() => undefined)\n if (!info?.isDirectory()) continue\n if (now - info.mtimeMs > olderThanMs) stale.push(entry)\n }\n return stale\n }\n\n /** Tổng byte đang chiếm — để đối chiếu lại counter, vốn trôi sau mỗi lần crash. */\n async totalBytes(): Promise<number> {\n let entries: string[]\n try {\n entries = await readdir(this.rootDir)\n } catch (err: any) {\n if (err?.code === 'ENOENT') return 0\n throw err\n }\n\n let total = 0\n for (const entry of entries) {\n const dir = join(this.rootDir, entry)\n const info = await stat(dir).catch(() => undefined)\n if (!info?.isDirectory()) continue\n for (const file of await readdir(dir).catch(() => [] as string[])) {\n const fileInfo = await stat(join(dir, file)).catch(() => undefined)\n if (fileInfo?.isFile()) total += fileInfo.size\n }\n }\n return total\n }\n}\n\n/**\n * `uploadId` phải là UUID. Kiểm TRƯỚC mọi thao tác đường dẫn.\n *\n * Không dùng blacklist (`..`, `/`): danh sách cấm luôn thiếu một dạng nào đó\n * (`%2e%2e`, null byte, tên dài quá giới hạn OS). Whitelist một hình dạng đã biết thì không.\n */\nexport function assertSafeUploadId(uploadId: string): void {\n if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(uploadId)) {\n throw new UploadError('FORBIDDEN', `uploadId không hợp lệ: '${uploadId}'`)\n }\n}\n\n/** `partNumber` phải là số nguyên trong `1..partCount`. */\nexport function assertSafePartNumber(partNumber: number, partCount: number): void {\n if (!Number.isSafeInteger(partNumber) || partNumber < 1 || partNumber > partCount) {\n throw new UploadError(\n 'PART_OUT_OF_RANGE',\n `partNumber ${partNumber} ngoài dải 1..${partCount}`\n )\n }\n}\n","import { readFile, writeFile, rename } from 'fs/promises'\nimport { join } from 'path'\n\nimport { UploadError } from './UploadError.ts'\nimport type { PartDiskStore } from './PartDiskStore.ts'\n\n/**\n * MANIFEST của các upload đang mở, giữ trong RAM và ghi kèm ra `meta.json`.\n *\n * Vì sao KHÔNG dùng Redis ở đây: một upload sống trọn đời trên MỘT process — gateway đã ghim\n * `target` từ lúc init, nên mọi part của nó về cùng một nơi. Thêm Redis vào downstream chỉ để\n * lưu thứ không ai khác đọc là bắt mọi service dùng Saul phải nuôi thêm một dependency.\n *\n * `meta.json` tồn tại vì hai lý do, đều là chuyện lúc hỏng chứ không phải lúc chạy: sống sót\n * qua restart, và cho sweeper phân biệt \"thư mục của một upload đang chạy\" với \"rác của một\n * process đã chết\".\n */\n\nconst META_FILE = 'meta.json'\n\nexport type UploadState = 'open' | 'completing' | 'completed'\n\nexport interface UploadRecord {\n uploadId: string\n module: string\n function: string\n /** Tên param kiểu FileStream của function đích. */\n param: string\n /** Các param KHÔNG phải file của cùng lời gọi. */\n params: Record<string, unknown>\n file: { name: string; size: number; type: string }\n chunkSize: number\n partCount: number\n /** Deadline TUYỆT ĐỐI do gateway quyết, không bao giờ gia hạn. */\n hardExpiresAt: number\n /** Deadline TRƯỢT, gia hạn mỗi lần nhận được part. */\n expiresAt: number\n idleTimeoutMs: number\n state: UploadState\n createdAt: number\n}\n\nexport interface UploadRegistryOptions {\n store: PartDiskStore\n /** Ngân sách đĩa của MÁY NÀY. Vượt thì từ chối init. */\n maxDiskBytes: number\n}\n\nexport class UploadRegistry {\n private readonly records = new Map<string, UploadRecord>()\n private readonly store: PartDiskStore\n private readonly maxDiskBytes: number\n\n /**\n * Byte đang chiếm, đếm tăng dần. Đây là con số ƯỚC LƯỢNG — nó trôi sau mỗi lần crash,\n * nên `UploadSweeper` định kỳ tính lại bằng `du` thật. Counter trôi mà không ai sửa thì\n * ngân sách âm thầm khoá mọi upload, và không có gì trong log nói tại sao.\n */\n private usedBytes = 0\n\n constructor(options: UploadRegistryOptions) {\n this.store = options.store\n this.maxDiskBytes = options.maxDiskBytes\n }\n\n get diskUsedBytes(): number {\n return this.usedBytes\n }\n\n /** Đặt lại bộ đếm sau khi đối chiếu với đĩa thật. Xem `UploadSweeper`. */\n setDiskUsedBytes(bytes: number): void {\n this.usedBytes = Math.max(0, bytes)\n }\n\n async init(record: Omit<UploadRecord, 'state' | 'createdAt' | 'expiresAt'>): Promise<UploadRecord> {\n if (this.records.has(record.uploadId)) {\n throw new UploadError('UPLOAD_EXISTS', `Upload '${record.uploadId}' đã tồn tại`)\n }\n // Từ chối SỚM cái chắc chắn không vừa. Kế toán thật diễn ra theo từng part, nhưng\n // biết trước là không đủ chỗ thì không có lý do gì để nhận byte đầu tiên.\n if (this.usedBytes + record.file.size > this.maxDiskBytes) {\n throw new UploadError(\n 'DISK_BUDGET',\n `Hết ngân sách đĩa (${this.usedBytes}/${this.maxDiskBytes} byte) — thử lại sau`\n )\n }\n\n const now = Date.now()\n const full: UploadRecord = {\n ...record,\n state: 'open',\n createdAt: now,\n expiresAt: Math.min(now + record.idleTimeoutMs, record.hardExpiresAt),\n }\n\n this.records.set(full.uploadId, full)\n await this.store.ensureDir(full.uploadId)\n await this.persist(full)\n return full\n }\n\n /**\n * Record của một upload đang MỞ được.\n *\n * Hết hạn thì ném `UPLOAD_EXPIRED` chứ không `UPLOAD_NOT_FOUND`: hai thứ đó nói với\n * client hai điều khác nhau — \"id sai, đừng thử nữa\" và \"chậm quá, làm lại từ init\".\n */\n get(uploadId: string, allowed: UploadState[] = ['open']): UploadRecord {\n const record = this.records.get(uploadId)\n if (!record) {\n throw new UploadError('UPLOAD_NOT_FOUND', `Upload '${uploadId}' không tồn tại`)\n }\n if (Date.now() > record.hardExpiresAt || Date.now() > record.expiresAt) {\n throw new UploadError('UPLOAD_EXPIRED', `Upload '${uploadId}' đã hết hạn`)\n }\n if (!allowed.includes(record.state)) {\n throw new UploadError(\n record.state === 'completed' ? 'UPLOAD_COMPLETED' : 'UPLOAD_BUSY',\n `Upload '${uploadId}' đang ở trạng thái '${record.state}'`\n )\n }\n return record\n }\n\n /** Có record nào không, bất kể trạng thái — cho abort idempotent và cho sweeper. */\n peek(uploadId: string): UploadRecord | undefined {\n return this.records.get(uploadId)\n }\n\n list(): UploadRecord[] {\n return [...this.records.values()]\n }\n\n /**\n * Gia hạn deadline sau khi nhận được một part, và cộng chênh lệch byte vào bộ đếm.\n *\n * `delta` chứ không phải `size`: PUT lại một part là GHI ĐÈ, nên phần tăng thêm chỉ là\n * hiệu số. Cộng nguyên `size` mỗi lần retry sẽ thổi phồng bộ đếm cho tới khi ngân sách\n * khoá cả những upload hoàn toàn bình thường.\n */\n touch(uploadId: string, deltaBytes: number): void {\n const record = this.records.get(uploadId)\n if (!record) return\n record.expiresAt = Math.min(Date.now() + record.idleTimeoutMs, record.hardExpiresAt)\n this.usedBytes = Math.max(0, this.usedBytes + deltaBytes)\n }\n\n /**\n * Chuyển sang `completing`, một lần duy nhất.\n *\n * Đây là chốt chống complete đồng thời: hai request cùng lúc thì cái thứ hai thấy state\n * đã đổi và nhận `UPLOAD_BUSY`, thay vì cả hai cùng ghép file và cùng gọi handler.\n */\n beginComplete(uploadId: string): UploadRecord {\n const record = this.get(uploadId, ['open'])\n record.state = 'completing'\n return record\n }\n\n /** Quay lại `open` khi complete thất bại — cho client retry mà không mất part đã gửi. */\n rollbackComplete(uploadId: string): void {\n const record = this.records.get(uploadId)\n if (record?.state === 'completing') record.state = 'open'\n }\n\n /** Xoá record + part trên đĩa. Idempotent. */\n async remove(uploadId: string): Promise<void> {\n this.records.delete(uploadId)\n const freed = await this.store.removeUpload(uploadId)\n this.usedBytes = Math.max(0, this.usedBytes - freed)\n }\n\n /**\n * Ghi `meta.json` cạnh part.\n *\n * Ghi tmp rồi rename để không bao giờ có một `meta.json` cụt: sweeper đọc phải file cụt\n * sẽ coi thư mục là rác và xoá một upload đang chạy dở.\n */\n private async persist(record: UploadRecord): Promise<void> {\n const dir = this.store.dirFor(record.uploadId)\n const tmp = join(dir, `${META_FILE}.tmp`)\n await writeFile(tmp, JSON.stringify(record), 'utf-8')\n await rename(tmp, join(dir, META_FILE))\n }\n\n /** Đọc `meta.json` của một thư mục — cho sweeper phân biệt upload sống với rác. */\n async readPersisted(uploadId: string): Promise<UploadRecord | undefined> {\n try {\n const raw = await readFile(join(this.store.dirFor(uploadId), META_FILE), 'utf-8')\n return JSON.parse(raw) as UploadRecord\n } catch {\n return undefined\n }\n }\n}\n","import type { PartDiskStore } from './PartDiskStore.ts'\nimport type { UploadRegistry } from './UploadRegistry.ts'\n\n/**\n * DỌN RÁC ĐỊNH KỲ cho chunk store.\n *\n * Ba việc, và việc thứ hai/thứ ba mới là lý do tồn tại của nó: một `setTimeout` per-upload\n * (kiểu `BinaryStreamBuffer` đang dùng cho WS) chỉ dọn được thứ nó biết. Process chết giữa\n * chừng thì timer chết theo, còn file thì ở lại đĩa mãi mãi.\n *\n * 1. Upload quá hạn → xoá record + part.\n * 2. Thư mục KHÔNG có record trong RAM và đã cũ → rác của một process đã chết, xoá.\n * 3. Định kỳ đối chiếu bộ đếm byte với đĩa thật → counter trôi sau crash, mà counter trôi\n * thì ngân sách âm thầm khoá mọi upload và không có gì trong log nói tại sao.\n */\n\nexport interface UploadSweeperOptions {\n registry: UploadRegistry\n store: PartDiskStore\n intervalMs?: number\n /** Thư mục mồ côi phải cũ hơn ngần này mới xoá. Mặc định 2× idle timeout dài nhất. */\n orphanGraceMs?: number\n /** Bao nhiêu tick thì đối chiếu lại bộ đếm với đĩa (quét `du` không rẻ). */\n reconcileEvery?: number\n}\n\nexport interface SweepResult {\n expired: number\n orphans: number\n reconciledBytes?: number\n}\n\nexport class UploadSweeper {\n private readonly registry: UploadRegistry\n private readonly store: PartDiskStore\n private readonly intervalMs: number\n private readonly orphanGraceMs: number\n private readonly reconcileEvery: number\n\n private timer?: ReturnType<typeof setInterval>\n private ticks = 0\n\n constructor(options: UploadSweeperOptions) {\n this.registry = options.registry\n this.store = options.store\n this.intervalMs = options.intervalMs ?? 60_000\n this.orphanGraceMs = options.orphanGraceMs ?? 20 * 60_000\n this.reconcileEvery = options.reconcileEvery ?? 10\n }\n\n /** Bắt đầu quét. `unref()` để timer dọn dẹp không giữ process sống. */\n start(): void {\n if (this.timer) return\n this.timer = setInterval(() => {\n // Không `await`: đây là timer, không có ai để `catch`. Nuốt lỗi tại chỗ và log,\n // vì một lần quét hỏng không được phép làm chết process.\n this.sweep().catch((err) => console.error('[saul][upload] sweep lỗi:', err))\n }, this.intervalMs)\n if (typeof (this.timer as any).unref === 'function') (this.timer as any).unref()\n }\n\n stop(): void {\n if (!this.timer) return\n clearInterval(this.timer)\n this.timer = undefined\n }\n\n async sweep(now: number = Date.now()): Promise<SweepResult> {\n const result: SweepResult = { expired: 0, orphans: 0 }\n\n for (const record of this.registry.list()) {\n if (now > record.hardExpiresAt || now > record.expiresAt) {\n await this.registry.remove(record.uploadId)\n result.expired += 1\n }\n }\n\n // Thư mục cũ mà không có record trong RAM: hoặc process đã restart, hoặc record bị\n // xoá mà `rm` thất bại. Cả hai đều là rác — nhưng chỉ sau `orphanGraceMs`, vì một\n // upload vừa `ensureDir()` xong cũng chưa có part nào.\n for (const dirName of await this.store.listStaleDirs(this.orphanGraceMs, now)) {\n if (this.registry.peek(dirName)) continue\n await this.store.removeUpload(dirName).catch(() => undefined)\n result.orphans += 1\n }\n\n this.ticks += 1\n if (this.ticks % this.reconcileEvery === 0) {\n const actual = await this.store.totalBytes()\n this.registry.setDiskUsedBytes(actual)\n result.reconciledBytes = actual\n }\n\n return result\n }\n}\n","import { Readable } from 'stream'\n\nimport type { PartDiskStore } from './PartDiskStore.ts'\n\n/**\n * NỐI CÁC PART thành MỘT `Readable`, không buffer.\n *\n * `Readable.from(async generator)` cho backpressure đúng miễn phí: generator chỉ chạy tiếp\n * khi consumer kéo, nên tốc độ đọc đĩa tự khớp tốc độ ghi ra downstream. Và vì generator\n * chỉ mở part khi tới lượt, ở mọi thời điểm chỉ có **một** fd đang mở — RAM là\n * `highWaterMark`, không phụ thuộc file 8MB hay 8GB.\n *\n * `finally { rs.destroy() }` không phải cho đường thành công (stream tự đóng khi hết) mà cho\n * đường HUỶ: consumer `destroy()` giữa chừng sẽ ném vào generator, và không có `finally` thì\n * part đang đọc dở giữ fd tới tận lúc GC.\n */\nexport function concatParts(\n store: PartDiskStore,\n uploadId: string,\n partNumbers: number[],\n partCount: number\n): Readable {\n async function* generate(): AsyncGenerator<Buffer> {\n for (const partNumber of partNumbers) {\n const source = store.createPartStream(uploadId, partNumber, partCount)\n try {\n for await (const chunk of source) {\n yield chunk as Buffer\n }\n } finally {\n source.destroy()\n }\n }\n }\n\n return Readable.from(generate())\n}\n","import { Hono } from 'hono'\nimport { Readable } from 'stream'\nimport { tmpdir } from 'os'\nimport { join } from 'path'\n\nimport { FileStream } from '../models/fileStream.ts'\nimport { concatParts } from './concatParts.ts'\nimport { PartDiskStore } from './PartDiskStore.ts'\nimport { UploadError, uploadErrorStatus } from './UploadError.ts'\nimport { UploadRegistry, type UploadRecord } from './UploadRegistry.ts'\nimport { UploadSweeper } from './UploadSweeper.ts'\n\n/**\n * SUB-ROUTER `/saul/upload/*` — phía DOWNSTREAM của multipart upload.\n *\n * Gateway không lưu byte nào; nó bơm thẳng từng part sang đây. Nên đây mới là nơi part nằm\n * trên đĩa và được ghép lại lúc complete.\n *\n * Router này KHÔNG tự gác quyền. Nó tin gateway, đúng như `POST /saul` đang tin — quyền đã\n * được chốt ở `/upload/init` của gateway, trước byte đầu tiên. Đặt thêm một tầng authz ở đây\n * mà không có token của user thì cũng chỉ là kiểm lại chính mình.\n *\n * Chỉ ba biến env, và cả ba đều nói về TÀI NGUYÊN CỦA MÁY NÀY. Mọi thứ thuộc về chính sách\n * (deadline, chunk size, partCount) do gateway truyền xuống trong lời gọi init.\n */\n\nexport interface UploadRouterOptions {\n /** Gọi hàm đích sau khi đã ghép file. Runtime truyền `dispatch` của nó vào đây. */\n dispatch: (body: { module: string; function: string; params: Record<string, unknown> }) => Promise<unknown>\n rootDir?: string\n maxDiskBytes?: number\n fsync?: boolean\n /** Trần cứng một part. Gateway cũng gác, nhưng ở đây mới đếm byte THẬT. */\n maxPartBytes?: number\n sweepIntervalMs?: number\n}\n\nconst envInt = (key: string, fallback: number): number => {\n const raw = process.env[key]\n const n = raw ? Number.parseInt(raw, 10) : NaN\n return Number.isFinite(n) && n > 0 ? n : fallback\n}\nconst envBool = (key: string, fallback: boolean): boolean => {\n const raw = process.env[key]\n if (raw === undefined) return fallback\n return raw === 'true' || raw === '1'\n}\n\nexport interface UploadSubsystem {\n router: Hono\n registry: UploadRegistry\n store: PartDiskStore\n sweeper: UploadSweeper\n}\n\nexport function createUploadSubsystem(options: UploadRouterOptions): UploadSubsystem {\n const store = new PartDiskStore({\n rootDir: options.rootDir ?? process.env.SAUL_UPLOAD_TMP_DIR ?? join(tmpdir(), 'saul-uploads'),\n fsync: options.fsync ?? envBool('SAUL_UPLOAD_FSYNC', true),\n })\n const registry = new UploadRegistry({\n store,\n maxDiskBytes:\n options.maxDiskBytes ?? envInt('SAUL_UPLOAD_MAX_DISK_BYTES', 20 * 1024 * 1024 * 1024),\n })\n const sweeper = new UploadSweeper({ registry, store, intervalMs: options.sweepIntervalMs })\n const maxPartBytes = options.maxPartBytes ?? envInt('SAUL_UPLOAD_MAX_PART_BYTES', 32 * 1024 * 1024)\n\n const router = new Hono()\n\n router.onError((err, c) => {\n if (UploadError.is(err)) {\n return c.json({ error: err.message, code: err.code }, uploadErrorStatus(err.code) as any)\n }\n console.error('[saul][upload] lỗi không xác định:', err)\n return c.json({ error: err instanceof Error ? err.message : String(err) }, 500)\n })\n\n /**\n * Gateway sinh `uploadId` và áp đặt xuống — downstream không tự đặt id, nhờ vậy không\n * phải map hai id ở hai bên. Deadline cũng do gateway quyết: chính sách nằm ở\n * `remote_config` của Saul, downstream chỉ thi hành.\n */\n router.post('/init', async (c) => {\n const body = (await c.req.json()) as Omit<UploadRecord, 'state' | 'createdAt' | 'expiresAt'>\n const record = await registry.init(body)\n return c.json({ uploadId: record.uploadId, expiresAt: record.expiresAt })\n })\n\n router.put('/:uploadId/part/:partNumber', async (c) => {\n const uploadId = c.req.param('uploadId')\n const partNumber = Number(c.req.param('partNumber'))\n const record = registry.get(uploadId)\n\n const contentLength = c.req.header('content-length')\n if (!contentLength) {\n throw new UploadError('SIZE_MISMATCH', 'Thiếu content-length — part phải khai độ dài')\n }\n\n const before = (await store.listParts(uploadId)).find((p) => p.partNumber === partNumber)\n\n // `c.req.raw.body` là stream của socket. KHÔNG đọc nó thành buffer ở bất kỳ đâu —\n // một lần chạm là cả part vào RAM.\n const source = c.req.raw.body\n if (!source) {\n throw new UploadError('SIZE_MISMATCH', 'Request không có body')\n }\n\n const result = await store.writePart(uploadId, partNumber, Readable.fromWeb(source as any), {\n maxBytes: maxPartBytes,\n partCount: record.partCount,\n declaredLength: Number(contentLength),\n expectedSha256: c.req.header('x-saul-part-sha256'),\n })\n\n // Hiệu số, không phải `result.size`: PUT lại một part là ghi đè, cộng nguyên size\n // mỗi lần retry sẽ thổi phồng bộ đếm cho tới khi ngân sách khoá cả upload lành lặn.\n registry.touch(uploadId, result.size - (before?.size ?? 0))\n\n return c.json({ partNumber, size: result.size, etag: result.etag })\n })\n\n router.get('/:uploadId', async (c) => {\n const uploadId = c.req.param('uploadId')\n const record = registry.get(uploadId, ['open', 'completing'])\n const parts = await store.listParts(uploadId)\n\n return c.json({\n uploadId,\n size: record.file.size,\n chunkSize: record.chunkSize,\n partCount: record.partCount,\n received: parts,\n expiresAt: record.expiresAt,\n })\n })\n\n /**\n * Ghép part → dựng `FileStream` → gọi handler → trả về ĐÚNG giá trị handler trả.\n *\n * `ctx` tới ở ĐÂY chứ không phải ở init: nó phải phản ánh trạng thái quyền tại thời điểm\n * chạy handler, không phải lúc bắt đầu một upload có thể kéo dài 40 phút.\n */\n router.post('/:uploadId/complete', async (c) => {\n const uploadId = c.req.param('uploadId')\n const { ctx } = (await c.req.json().catch(() => ({}))) as { ctx?: unknown }\n const record = registry.beginComplete(uploadId)\n\n try {\n const parts = await store.listParts(uploadId)\n const received = new Set(parts.map((p) => p.partNumber))\n const missing: number[] = []\n for (let n = 1; n <= record.partCount; n += 1) {\n if (!received.has(n)) missing.push(n)\n }\n if (missing.length > 0) {\n throw new UploadError(\n 'PART_MISSING',\n `Thiếu part: ${missing.slice(0, 10).join(', ')}${missing.length > 10 ? '…' : ''}`\n )\n }\n\n const total = parts.reduce((sum, p) => sum + p.size, 0)\n // Fail-closed, cùng lý lẽ với `BinaryStreamBuffer.end()`: dispatch một file cụt\n // nghĩa là handler nhận dữ liệu sai mà không có gì báo.\n if (record.file.size > 0 && total !== record.file.size) {\n throw new UploadError(\n 'SIZE_MISMATCH',\n `Nhận ${total} byte, khai báo ${record.file.size}`\n )\n }\n\n const ordered = parts.map((p) => p.partNumber)\n const fileStream = new FileStream(record.file, () =>\n concatParts(store, uploadId, ordered, record.partCount)\n )\n\n const result = await options.dispatch({\n module: record.module,\n function: record.function,\n params: { ...record.params, [record.param]: fileStream, ctx },\n })\n\n return c.json(result as any)\n } catch (err) {\n // Trả về `open` để client retry được mà không mất part đã gửi. Nếu để nguyên\n // `completing` thì một lỗi tạm thời của handler biến thành phải upload lại 3GB.\n registry.rollbackComplete(uploadId)\n throw err\n } finally {\n // Dọn part dù thành công hay thất bại — trừ khi còn ở `completing` (đã rollback,\n // client sẽ thử lại).\n if (registry.peek(uploadId)?.state !== 'open') {\n await registry.remove(uploadId).catch(() => undefined)\n }\n }\n })\n\n router.delete('/:uploadId', async (c) => {\n // Idempotent: xoá cái không tồn tại vẫn 204, để gọi được từ `sendBeacon` lúc đóng tab.\n await registry.remove(c.req.param('uploadId')).catch(() => undefined)\n return c.body(null, 204)\n })\n\n return { router, registry, store, sweeper }\n}\n"]}
package/package.json CHANGED
@@ -1,17 +1,45 @@
1
1
  {
2
2
  "name": "@fidt/saul-server",
3
- "version": "1.0.0",
3
+ "version": "1.1.0",
4
4
  "description": "",
5
- "main": "src",
5
+ "main": "dist/index.js",
6
+ "module": "dist/index.js",
7
+ "types": "dist/index.d.ts",
8
+ "exports": {
9
+ ".": {
10
+ "types": "./dist/index.d.ts",
11
+ "import": "./dist/index.js",
12
+ "require": "./dist/index.cjs"
13
+ }
14
+ },
15
+ "files": [
16
+ "dist"
17
+ ],
18
+ "type": "module",
19
+ "scripts": {
20
+ "build": "tsup",
21
+ "dev": "tsup --watch",
22
+ "clean": "rimraf dist",
23
+ "typecheck": "tsc --noEmit",
24
+ "test": "vitest",
25
+ "prepublishOnly": "pnpm run clean && pnpm run build"
26
+ },
6
27
  "keywords": [],
7
28
  "author": "",
8
29
  "license": "ISC",
9
30
  "dependencies": {
10
31
  "@hono/node-server": "^1.13.8",
32
+ "@socket.io/redis-adapter": "^8.3.0",
33
+ "@types/node": "^22.15.3",
11
34
  "hono": "^4.7.4",
12
- "zod": "^3.24.2"
35
+ "socket.io": "^4.8.1",
36
+ "zod": "^3.24.2",
37
+ "zod-validation-error": "^3.4.0"
13
38
  },
14
- "scripts": {
15
- "test": "echo \"Error: no test specified\" && exit 1"
39
+ "devDependencies": {
40
+ "rimraf": "^5.0.5",
41
+ "tsup": "^8.4.0",
42
+ "typescript": "^5.4.5",
43
+ "vitest": "^1.6.1"
16
44
  }
17
- }
45
+ }
package/src/index.ts DELETED
@@ -1,7 +0,0 @@
1
- export { Hono as WebServer } from 'hono'
2
-
3
- export * from 'hono'
4
- export { cors } from 'hono/cors'
5
- export { serve } from '@hono/node-server'
6
-
7
- export * as Zod from 'zod'
package/tsconfig.json DELETED
@@ -1,18 +0,0 @@
1
- {
2
- "compilerOptions": {
3
- "outDir": "dist/",
4
- "moduleResolution": "Node",
5
- "declaration": true,
6
- "baseUrl": ".",
7
- "paths": {
8
- "@fidt/interface/*": ["packages/interface/src/*"]
9
- },
10
- "target": "es2016",
11
- "module": "commonjs",
12
- "esModuleInterop": true,
13
- "forceConsistentCasingInFileNames": true,
14
- "strict": true,
15
- "strictPropertyInitialization": false,
16
- "skipLibCheck": true
17
- }
18
- }