secure-upload-fastify-sdk 1.0.0

package/dist/server/utils/strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/utils/strategy.ts"],"sourcesContent":["/**\r\n * Smart 上传策略选择器\r\n *\r\n * 服务端根据 totalSize 自动选择 ONE_SHOT 或 MULTIPART:\r\n *   - ONE_SHOT:  1 个 part(适合 ≤ ONE_SHOT_MAX 的小文件)\r\n *                客户端只调 1 次 part + 1 次 complete = 2 RTT\r\n *   - MULTIPART: N 个 part,根据文件大小动态调整 partSize:\r\n *                  ≤ 1GB         → 1MB / part\r\n *                  1 ~ 10GB      → 5MB / part\r\n *                  > 10GB        → 10MB / part\r\n *\r\n * 设计约束\r\n * ========\r\n *   - 纯函数:无副作用、不读 IO、不访问全局状态,易于单测\r\n *   - 0 字节文件合法(partSize=0, totalParts=1)\r\n *   - 决策结果携带 reason 字段,便于日志/排障\r\n *   - 不与 config 直接耦合:调用方传入 cfg\r\n */\r\n\r\nexport type StrategyKind = 'ONE_SHOT' | 'MULTIPART';\r\n\r\nexport interface StrategyConfig {\r\n  /** ≤ 此字节数走 ONE_SHOT(默认 1MB) */\r\n  oneShotMax: number;\r\n  /** 默认分片大小(默认 1MB) */\r\n  defaultPartSize: number;\r\n  /** 超过此字节数切到大分片(默认 1GB) */\r\n  bigFileThreshold: number;\r\n  /** 大文件分片大小(默认 5MB) */\r\n  bigFilePartSize: number;\r\n  /** 超过此字节数切到超大分片(默认 10GB) */\r\n  hugeFileThreshold: number;\r\n  /** 超大文件分片大小(默认 10MB) */\r\n  hugeFilePartSize: number;\r\n}\r\n\r\nexport interface StrategyResult {\r\n  kind: StrategyKind;\r\n  /** 实际分片大小(字节) */\r\n  partSize: number;\r\n  /** 总分片数(ONE_SHOT 固定为 1) */\r\n  totalParts: number;\r\n  /** 决策原因(便于日志/调试) */\r\n  reason: string;\r\n}\r\n\r\n/** 默认策略配置 */\r\nexport const DEFAULT_STRATEGY_CONFIG: StrategyConfig = {\r\n  oneShotMax: 1024 * 1024,              // 1MB\r\n  defaultPartSize: 1024 * 1024,         // 1MB\r\n  bigFileThreshold: 1024 ** 3,          // 1GB\r\n  bigFilePartSize: 5 * 1024 * 1024,     // 5MB\r\n  hugeFileThreshold: 10 * 1024 ** 3,    // 10GB\r\n  hugeFilePartSize: 10 * 1024 * 1024,   // 10MB\r\n};\r\n\r\n/**\r\n * 根据 totalSize 选出上传策略\r\n *\r\n * @throws  totalSize 非法(负数 / NaN / 非有限数)\r\n *\r\n * @example\r\n *   chooseStrategy(1024)            // → ONE_SHOT  1 part, partSize=1024\r\n *   chooseStrategy(5 * 1024 * 1024) // → MULTIPART 5 part, partSize=1MB\r\n *   chooseStrategy(5 * 1024**3)     // → MULTIPART 1024 part, partSize=5MB\r\n *   chooseStrategy(50 * 1024**3)    // → MULTIPART 5120 part, partSize=10MB\r\n */\r\nexport function chooseStrategy(\r\n  totalSize: number,\r\n  cfg: StrategyConfig = DEFAULT_STRATEGY_CONFIG\r\n): StrategyResult {\r\n  if (!Number.isFinite(totalSize) || totalSize < 0) {\r\n    throw new Error(`[strategy] totalSize 非法: ${totalSize}(必须 ≥ 0 的有限数)`);\r\n  }\r\n  validateConfig(cfg);\r\n\r\n  if (totalSize === 0) {\r\n    return { kind: 'ONE_SHOT', partSize: 0, totalParts: 1, reason: '0字节' };\r\n  }\r\n\r\n  if (totalSize <= cfg.oneShotMax) {\r\n    return {\r\n      kind: 'ONE_SHOT',\r\n      partSize: totalSize,\r\n      totalParts: 1,\r\n      reason: `≤ ${cfg.oneShotMax}B 走 ONE_SHOT(1 part 直传)`,\r\n    };\r\n  }\r\n\r\n  if (totalSize > cfg.hugeFileThreshold) {\r\n    const partSize = cfg.hugeFilePartSize;\r\n    return {\r\n      kind: 'MULTIPART',\r\n      partSize,\r\n      totalParts: Math.ceil(totalSize / partSize),\r\n      reason: `> ${cfg.hugeFileThreshold}B 走 HUGE(${partSize}B/part)`,\r\n    };\r\n  }\r\n\r\n  if (totalSize > cfg.bigFileThreshold) {\r\n    const partSize = cfg.bigFilePartSize;\r\n    return {\r\n      kind: 'MULTIPART',\r\n      partSize,\r\n      totalParts: Math.ceil(totalSize / partSize),\r\n      reason: `> ${cfg.bigFileThreshold}B 走 BIG(${partSize}B/part)`,\r\n    };\r\n  }\r\n\r\n  const partSize = cfg.defaultPartSize;\r\n  return {\r\n    kind: 'MULTIPART',\r\n    partSize,\r\n    totalParts: Math.ceil(totalSize / partSize),\r\n    reason: `≤ ${cfg.bigFileThreshold}B 走 DEFAULT(${partSize}B/part)`,\r\n  };\r\n}\r\n\r\n/**\r\n * 建议的客户端并发上传 part 数\r\n *   - ONE_SHOT:固定 1(只传 1 个 part,无需并发)\r\n *   - totalParts ≤ 4:用 totalParts(part 太少,无并发必要)\r\n *   - totalParts > 4:用 4(服务端限流/带宽考虑)\r\n */\r\nexport function suggestConcurrency(s: StrategyResult): number {\r\n  if (s.kind === 'ONE_SHOT') return 1;\r\n  if (s.totalParts <= 4) return Math.max(1, s.totalParts);\r\n  return 4;\r\n}\r\n\r\nfunction validateConfig(cfg: StrategyConfig): void {\r\n  const fields: Array<[keyof StrategyConfig, string]> = [\r\n    ['oneShotMax', 'oneShotMax'],\r\n    ['defaultPartSize', 'defaultPartSize'],\r\n    ['bigFileThreshold', 'bigFileThreshold'],\r\n    ['bigFilePartSize', 'bigFilePartSize'],\r\n    ['hugeFileThreshold', 'hugeFileThreshold'],\r\n    ['hugeFilePartSize', 'hugeFilePartSize'],\r\n  ];\r\n  for (const [k, name] of fields) {\r\n    if (!Number.isFinite(cfg[k]) || cfg[k] <= 0) {\r\n      throw new Error(`[strategy] cfg.${name} 非法: ${cfg[k]}(必须 > 0)`);\r\n    }\r\n  }\r\n  if (cfg.oneShotMax > cfg.defaultPartSize) {\r\n    throw new Error(\r\n      `[strategy] oneShotMax(${cfg.oneShotMax}) 不能 > defaultPartSize(${cfg.defaultPartSize})`\r\n    );\r\n  }\r\n  if (cfg.bigFileThreshold >= cfg.hugeFileThreshold) {\r\n    throw new Error(\r\n      `[strategy] bigFileThreshold(${cfg.bigFileThreshold}) 必须 < hugeFileThreshold(${cfg.hugeFileThreshold})`\r\n    );\r\n  }\r\n  if (cfg.defaultPartSize > cfg.bigFilePartSize) {\r\n    throw new Error(\r\n      `[strategy] defaultPartSize(${cfg.defaultPartSize}) 不能 > bigFilePartSize(${cfg.bigFilePartSize})`\r\n    );\r\n  }\r\n  if (cfg.bigFilePartSize > cfg.hugeFilePartSize) {\r\n    throw new Error(\r\n      `[strategy] bigFilePartSize(${cfg.bigFilePartSize}) 不能 > hugeFilePartSize(${cfg.hugeFilePartSize})`\r\n    );\r\n  }\r\n}\r\n"],"mappings":"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","names":["partSize"]}

package/dist/server/utils/strategy.mjs

@@ -0,0 +1,103 @@
+// src/server/utils/strategy.ts
+var DEFAULT_STRATEGY_CONFIG = {
+  oneShotMax: 1024 * 1024,
+  // 1MB
+  defaultPartSize: 1024 * 1024,
+  // 1MB
+  bigFileThreshold: 1024 ** 3,
+  // 1GB
+  bigFilePartSize: 5 * 1024 * 1024,
+  // 5MB
+  hugeFileThreshold: 10 * 1024 ** 3,
+  // 10GB
+  hugeFilePartSize: 10 * 1024 * 1024
+  // 10MB
+};
+function chooseStrategy(totalSize, cfg = DEFAULT_STRATEGY_CONFIG) {
+  if (!Number.isFinite(totalSize) || totalSize < 0) {
+    throw new Error(`[strategy] totalSize \u975E\u6CD5: ${totalSize}(\u5FC5\u987B \u2265 0 \u7684\u6709\u9650\u6570)`);
+  }
+  validateConfig(cfg);
+  if (totalSize === 0) {
+    return { kind: "ONE_SHOT", partSize: 0, totalParts: 1, reason: "0\u5B57\u8282" };
+  }
+  if (totalSize <= cfg.oneShotMax) {
+    return {
+      kind: "ONE_SHOT",
+      partSize: totalSize,
+      totalParts: 1,
+      reason: `\u2264 ${cfg.oneShotMax}B \u8D70 ONE_SHOT(1 part \u76F4\u4F20)`
+    };
+  }
+  if (totalSize > cfg.hugeFileThreshold) {
+    const partSize2 = cfg.hugeFilePartSize;
+    return {
+      kind: "MULTIPART",
+      partSize: partSize2,
+      totalParts: Math.ceil(totalSize / partSize2),
+      reason: `> ${cfg.hugeFileThreshold}B \u8D70 HUGE(${partSize2}B/part)`
+    };
+  }
+  if (totalSize > cfg.bigFileThreshold) {
+    const partSize2 = cfg.bigFilePartSize;
+    return {
+      kind: "MULTIPART",
+      partSize: partSize2,
+      totalParts: Math.ceil(totalSize / partSize2),
+      reason: `> ${cfg.bigFileThreshold}B \u8D70 BIG(${partSize2}B/part)`
+    };
+  }
+  const partSize = cfg.defaultPartSize;
+  return {
+    kind: "MULTIPART",
+    partSize,
+    totalParts: Math.ceil(totalSize / partSize),
+    reason: `\u2264 ${cfg.bigFileThreshold}B \u8D70 DEFAULT(${partSize}B/part)`
+  };
+}
+function suggestConcurrency(s) {
+  if (s.kind === "ONE_SHOT") return 1;
+  if (s.totalParts <= 4) return Math.max(1, s.totalParts);
+  return 4;
+}
+function validateConfig(cfg) {
+  const fields = [
+    ["oneShotMax", "oneShotMax"],
+    ["defaultPartSize", "defaultPartSize"],
+    ["bigFileThreshold", "bigFileThreshold"],
+    ["bigFilePartSize", "bigFilePartSize"],
+    ["hugeFileThreshold", "hugeFileThreshold"],
+    ["hugeFilePartSize", "hugeFilePartSize"]
+  ];
+  for (const [k, name] of fields) {
+    if (!Number.isFinite(cfg[k]) || cfg[k] <= 0) {
+      throw new Error(`[strategy] cfg.${name} \u975E\u6CD5: ${cfg[k]}(\u5FC5\u987B > 0)`);
+    }
+  }
+  if (cfg.oneShotMax > cfg.defaultPartSize) {
+    throw new Error(
+      `[strategy] oneShotMax(${cfg.oneShotMax}) \u4E0D\u80FD > defaultPartSize(${cfg.defaultPartSize})`
+    );
+  }
+  if (cfg.bigFileThreshold >= cfg.hugeFileThreshold) {
+    throw new Error(
+      `[strategy] bigFileThreshold(${cfg.bigFileThreshold}) \u5FC5\u987B < hugeFileThreshold(${cfg.hugeFileThreshold})`
+    );
+  }
+  if (cfg.defaultPartSize > cfg.bigFilePartSize) {
+    throw new Error(
+      `[strategy] defaultPartSize(${cfg.defaultPartSize}) \u4E0D\u80FD > bigFilePartSize(${cfg.bigFilePartSize})`
+    );
+  }
+  if (cfg.bigFilePartSize > cfg.hugeFilePartSize) {
+    throw new Error(
+      `[strategy] bigFilePartSize(${cfg.bigFilePartSize}) \u4E0D\u80FD > hugeFilePartSize(${cfg.hugeFilePartSize})`
+    );
+  }
+}
+export {
+  DEFAULT_STRATEGY_CONFIG,
+  chooseStrategy,
+  suggestConcurrency
+};
+//# sourceMappingURL=strategy.mjs.map

package/dist/server/utils/strategy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/utils/strategy.ts"],"sourcesContent":["/**\r\n * Smart 上传策略选择器\r\n *\r\n * 服务端根据 totalSize 自动选择 ONE_SHOT 或 MULTIPART:\r\n *   - ONE_SHOT:  1 个 part(适合 ≤ ONE_SHOT_MAX 的小文件)\r\n *                客户端只调 1 次 part + 1 次 complete = 2 RTT\r\n *   - MULTIPART: N 个 part,根据文件大小动态调整 partSize:\r\n *                  ≤ 1GB         → 1MB / part\r\n *                  1 ~ 10GB      → 5MB / part\r\n *                  > 10GB        → 10MB / part\r\n *\r\n * 设计约束\r\n * ========\r\n *   - 纯函数:无副作用、不读 IO、不访问全局状态,易于单测\r\n *   - 0 字节文件合法(partSize=0, totalParts=1)\r\n *   - 决策结果携带 reason 字段,便于日志/排障\r\n *   - 不与 config 直接耦合:调用方传入 cfg\r\n */\r\n\r\nexport type StrategyKind = 'ONE_SHOT' | 'MULTIPART';\r\n\r\nexport interface StrategyConfig {\r\n  /** ≤ 此字节数走 ONE_SHOT(默认 1MB) */\r\n  oneShotMax: number;\r\n  /** 默认分片大小(默认 1MB) */\r\n  defaultPartSize: number;\r\n  /** 超过此字节数切到大分片(默认 1GB) */\r\n  bigFileThreshold: number;\r\n  /** 大文件分片大小(默认 5MB) */\r\n  bigFilePartSize: number;\r\n  /** 超过此字节数切到超大分片(默认 10GB) */\r\n  hugeFileThreshold: number;\r\n  /** 超大文件分片大小(默认 10MB) */\r\n  hugeFilePartSize: number;\r\n}\r\n\r\nexport interface StrategyResult {\r\n  kind: StrategyKind;\r\n  /** 实际分片大小(字节) */\r\n  partSize: number;\r\n  /** 总分片数(ONE_SHOT 固定为 1) */\r\n  totalParts: number;\r\n  /** 决策原因(便于日志/调试) */\r\n  reason: string;\r\n}\r\n\r\n/** 默认策略配置 */\r\nexport const DEFAULT_STRATEGY_CONFIG: StrategyConfig = {\r\n  oneShotMax: 1024 * 1024,              // 1MB\r\n  defaultPartSize: 1024 * 1024,         // 1MB\r\n  bigFileThreshold: 1024 ** 3,          // 1GB\r\n  bigFilePartSize: 5 * 1024 * 1024,     // 5MB\r\n  hugeFileThreshold: 10 * 1024 ** 3,    // 10GB\r\n  hugeFilePartSize: 10 * 1024 * 1024,   // 10MB\r\n};\r\n\r\n/**\r\n * 根据 totalSize 选出上传策略\r\n *\r\n * @throws  totalSize 非法(负数 / NaN / 非有限数)\r\n *\r\n * @example\r\n *   chooseStrategy(1024)            // → ONE_SHOT  1 part, partSize=1024\r\n *   chooseStrategy(5 * 1024 * 1024) // → MULTIPART 5 part, partSize=1MB\r\n *   chooseStrategy(5 * 1024**3)     // → MULTIPART 1024 part, partSize=5MB\r\n *   chooseStrategy(50 * 1024**3)    // → MULTIPART 5120 part, partSize=10MB\r\n */\r\nexport function chooseStrategy(\r\n  totalSize: number,\r\n  cfg: StrategyConfig = DEFAULT_STRATEGY_CONFIG\r\n): StrategyResult {\r\n  if (!Number.isFinite(totalSize) || totalSize < 0) {\r\n    throw new Error(`[strategy] totalSize 非法: ${totalSize}(必须 ≥ 0 的有限数)`);\r\n  }\r\n  validateConfig(cfg);\r\n\r\n  if (totalSize === 0) {\r\n    return { kind: 'ONE_SHOT', partSize: 0, totalParts: 1, reason: '0字节' };\r\n  }\r\n\r\n  if (totalSize <= cfg.oneShotMax) {\r\n    return {\r\n      kind: 'ONE_SHOT',\r\n      partSize: totalSize,\r\n      totalParts: 1,\r\n      reason: `≤ ${cfg.oneShotMax}B 走 ONE_SHOT(1 part 直传)`,\r\n    };\r\n  }\r\n\r\n  if (totalSize > cfg.hugeFileThreshold) {\r\n    const partSize = cfg.hugeFilePartSize;\r\n    return {\r\n      kind: 'MULTIPART',\r\n      partSize,\r\n      totalParts: Math.ceil(totalSize / partSize),\r\n      reason: `> ${cfg.hugeFileThreshold}B 走 HUGE(${partSize}B/part)`,\r\n    };\r\n  }\r\n\r\n  if (totalSize > cfg.bigFileThreshold) {\r\n    const partSize = cfg.bigFilePartSize;\r\n    return {\r\n      kind: 'MULTIPART',\r\n      partSize,\r\n      totalParts: Math.ceil(totalSize / partSize),\r\n      reason: `> ${cfg.bigFileThreshold}B 走 BIG(${partSize}B/part)`,\r\n    };\r\n  }\r\n\r\n  const partSize = cfg.defaultPartSize;\r\n  return {\r\n    kind: 'MULTIPART',\r\n    partSize,\r\n    totalParts: Math.ceil(totalSize / partSize),\r\n    reason: `≤ ${cfg.bigFileThreshold}B 走 DEFAULT(${partSize}B/part)`,\r\n  };\r\n}\r\n\r\n/**\r\n * 建议的客户端并发上传 part 数\r\n *   - ONE_SHOT:固定 1(只传 1 个 part,无需并发)\r\n *   - totalParts ≤ 4:用 totalParts(part 太少,无并发必要)\r\n *   - totalParts > 4:用 4(服务端限流/带宽考虑)\r\n */\r\nexport function suggestConcurrency(s: StrategyResult): number {\r\n  if (s.kind === 'ONE_SHOT') return 1;\r\n  if (s.totalParts <= 4) return Math.max(1, s.totalParts);\r\n  return 4;\r\n}\r\n\r\nfunction validateConfig(cfg: StrategyConfig): void {\r\n  const fields: Array<[keyof StrategyConfig, string]> = [\r\n    ['oneShotMax', 'oneShotMax'],\r\n    ['defaultPartSize', 'defaultPartSize'],\r\n    ['bigFileThreshold', 'bigFileThreshold'],\r\n    ['bigFilePartSize', 'bigFilePartSize'],\r\n    ['hugeFileThreshold', 'hugeFileThreshold'],\r\n    ['hugeFilePartSize', 'hugeFilePartSize'],\r\n  ];\r\n  for (const [k, name] of fields) {\r\n    if (!Number.isFinite(cfg[k]) || cfg[k] <= 0) {\r\n      throw new Error(`[strategy] cfg.${name} 非法: ${cfg[k]}(必须 > 0)`);\r\n    }\r\n  }\r\n  if (cfg.oneShotMax > cfg.defaultPartSize) {\r\n    throw new Error(\r\n      `[strategy] oneShotMax(${cfg.oneShotMax}) 不能 > defaultPartSize(${cfg.defaultPartSize})`\r\n    );\r\n  }\r\n  if (cfg.bigFileThreshold >= cfg.hugeFileThreshold) {\r\n    throw new Error(\r\n      `[strategy] bigFileThreshold(${cfg.bigFileThreshold}) 必须 < hugeFileThreshold(${cfg.hugeFileThreshold})`\r\n    );\r\n  }\r\n  if (cfg.defaultPartSize > cfg.bigFilePartSize) {\r\n    throw new Error(\r\n      `[strategy] defaultPartSize(${cfg.defaultPartSize}) 不能 > bigFilePartSize(${cfg.bigFilePartSize})`\r\n    );\r\n  }\r\n  if (cfg.bigFilePartSize > cfg.hugeFilePartSize) {\r\n    throw new Error(\r\n      `[strategy] bigFilePartSize(${cfg.bigFilePartSize}) 不能 > hugeFilePartSize(${cfg.hugeFilePartSize})`\r\n    );\r\n  }\r\n}\r\n"],"mappings":"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","names":["partSize"]}

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "secure-upload-fastify-sdk",
+  "version": "1.0.0",
+  "description": "Fastify plugin SDK for resumable / multipart / smart uploads. Pluggable storage (Local / S3 / OSS / COS), pluggable repository (Prisma or custom), optional bridge to secure-crypto-top-zod-sdk.",
+  "main": "./dist/server/index.js",
+  "module": "./dist/server/index.mjs",
+  "types": "./dist/server/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.mjs",
+      "require": "./dist/server/index.js"
+    },
+    "./storage": {
+      "types": "./dist/server/utils/storage/index.d.ts",
+      "import": "./dist/server/utils/storage/index.mjs",
+      "require": "./dist/server/utils/storage/index.js"
+    },
+    "./repository": {
+      "types": "./dist/server/utils/repository/index.d.ts",
+      "import": "./dist/server/utils/repository/index.mjs",
+      "require": "./dist/server/utils/repository/index.js"
+    },
+    "./errors": {
+      "types": "./dist/server/errors.d.ts",
+      "import": "./dist/server/errors.mjs",
+      "require": "./dist/server/errors.js"
+    },
+    "./strategy": {
+      "types": "./dist/server/utils/strategy.d.ts",
+      "import": "./dist/server/utils/strategy.mjs",
+      "require": "./dist/server/utils/strategy.js"
+    },
+    "./prisma/schema": "./prisma/schema.prisma"
+  },
+  "files": [
+    "dist",
+    "prisma",
+    "README.md"
+  ],
+  "keywords": [
+    "fastify",
+    "plugin",
+    "upload",
+    "multipart",
+    "resumable",
+    "smart-upload",
+    "sdk"
+  ],
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.dts.json",
+    "build:js": "tsup",
+    "build:dts": "tsc -p tsconfig.dts.json",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "login": "npm login --registry=https://registry.npmjs.org/",
+    "publish": "npm publish --access public --registry=https://registry.npmjs.org/",
+    "test": "node --import tsx --test \"tests/**/*.test.ts\"",
+    "test:strategy": "node --import tsx --test tests/strategy.test.ts",
+    "test:e2e": "node --import tsx tests/standalone-e2e-cli.mjs"
+  },
+  "peerDependencies": {
+    "fastify": "^4.28.0",
+    "fastify-plugin": "^4.5.1",
+    "zod": "^3.23.0"
+  },
+  "peerDependenciesMeta": {
+    "secure-crypto-top-zod-sdk": {
+      "optional": true
+    },
+    "@prisma/client": {
+      "optional": true
+    },
+    "ioredis": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "secure-crypto-top-zod-sdk": "file:../secure-crypto-top-zod-sdk"
+  },
+  "devDependencies": {
+    "@prisma/client": "5.15.0",
+    "@types/node": "^20.14.0",
+    "fastify": "^4.28.0",
+    "fastify-plugin": "^4.5.1",
+    "ioredis": "^5.4.1",
+    "tsup": "^8.0.2",
+    "tsx": "^4.15.0",
+    "typescript": "^5.4.5",
+    "zod": "^3.23.8"
+  }
+}