secure-upload-fastify-sdk 1.0.0

package/dist/server/errors.mjs

@@ -0,0 +1,85 @@
+// src/server/errors.ts
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2[ErrorCode2["INVALID_REQUEST"] = 1001] = "INVALID_REQUEST";
+  ErrorCode2[ErrorCode2["INTERNAL_ERROR"] = 1500] = "INTERNAL_ERROR";
+  ErrorCode2[ErrorCode2["NOT_FOUND"] = 1400] = "NOT_FOUND";
+  ErrorCode2[ErrorCode2["FORBIDDEN"] = 1403] = "FORBIDDEN";
+  ErrorCode2[ErrorCode2["RATE_LIMITED"] = 1402] = "RATE_LIMITED";
+  ErrorCode2[ErrorCode2["BINARY_PAYLOAD_EMPTY"] = 1501] = "BINARY_PAYLOAD_EMPTY";
+  ErrorCode2[ErrorCode2["BINARY_PAYLOAD_TOO_LARGE"] = 1502] = "BINARY_PAYLOAD_TOO_LARGE";
+  ErrorCode2[ErrorCode2["BINARY_AUTH_REQUIRED"] = 1503] = "BINARY_AUTH_REQUIRED";
+  ErrorCode2[ErrorCode2["BINARY_AUTH_FAILED"] = 1504] = "BINARY_AUTH_FAILED";
+  ErrorCode2[ErrorCode2["BATCH_EMPTY"] = 1510] = "BATCH_EMPTY";
+  ErrorCode2[ErrorCode2["BATCH_TOO_MANY_FILES"] = 1511] = "BATCH_TOO_MANY_FILES";
+  ErrorCode2[ErrorCode2["BATCH_TOTAL_TOO_LARGE"] = 1512] = "BATCH_TOTAL_TOO_LARGE";
+  ErrorCode2[ErrorCode2["BATCH_FILE_INVALID"] = 1513] = "BATCH_FILE_INVALID";
+  ErrorCode2[ErrorCode2["MULTIPART_NOT_FOUND"] = 1520] = "MULTIPART_NOT_FOUND";
+  ErrorCode2[ErrorCode2["MULTIPART_ALREADY_COMPLETED"] = 1521] = "MULTIPART_ALREADY_COMPLETED";
+  ErrorCode2[ErrorCode2["MULTIPART_ALREADY_ABORTED"] = 1522] = "MULTIPART_ALREADY_ABORTED";
+  ErrorCode2[ErrorCode2["MULTIPART_EXPIRED"] = 1523] = "MULTIPART_EXPIRED";
+  ErrorCode2[ErrorCode2["MULTIPART_STATUS_INVALID"] = 1524] = "MULTIPART_STATUS_INVALID";
+  ErrorCode2[ErrorCode2["MULTIPART_TOTAL_TOO_LARGE"] = 1530] = "MULTIPART_TOTAL_TOO_LARGE";
+  ErrorCode2[ErrorCode2["MULTIPART_PART_TOO_LARGE"] = 1531] = "MULTIPART_PART_TOO_LARGE";
+  ErrorCode2[ErrorCode2["MULTIPART_PART_TOO_SMALL"] = 1532] = "MULTIPART_PART_TOO_SMALL";
+  ErrorCode2[ErrorCode2["MULTIPART_INVALID_PART_NUMBER"] = 1533] = "MULTIPART_INVALID_PART_NUMBER";
+  ErrorCode2[ErrorCode2["MULTIPART_DUPLICATE_PART"] = 1534] = "MULTIPART_DUPLICATE_PART";
+  ErrorCode2[ErrorCode2["MULTIPART_PART_HASH_MISMATCH"] = 1535] = "MULTIPART_PART_HASH_MISMATCH";
+  ErrorCode2[ErrorCode2["MULTIPART_FINAL_HASH_MISMATCH"] = 1536] = "MULTIPART_FINAL_HASH_MISMATCH";
+  ErrorCode2[ErrorCode2["MULTIPART_INCOMPLETE_PARTS"] = 1537] = "MULTIPART_INCOMPLETE_PARTS";
+  ErrorCode2[ErrorCode2["MULTIPART_AUTH_REQUIRED"] = 1538] = "MULTIPART_AUTH_REQUIRED";
+  ErrorCode2[ErrorCode2["MULTIPART_INVALID_ARG"] = 1539] = "MULTIPART_INVALID_ARG";
+  return ErrorCode2;
+})(ErrorCode || {});
+var HTTP = {
+  [1001 /* INVALID_REQUEST */]: 400,
+  [1500 /* INTERNAL_ERROR */]: 500,
+  [1400 /* NOT_FOUND */]: 404,
+  [1403 /* FORBIDDEN */]: 403,
+  [1402 /* RATE_LIMITED */]: 429,
+  // binary
+  [1501 /* BINARY_PAYLOAD_EMPTY */]: 400,
+  [1502 /* BINARY_PAYLOAD_TOO_LARGE */]: 413,
+  [1503 /* BINARY_AUTH_REQUIRED */]: 401,
+  [1504 /* BINARY_AUTH_FAILED */]: 401,
+  // batch
+  [1510 /* BATCH_EMPTY */]: 400,
+  [1511 /* BATCH_TOO_MANY_FILES */]: 413,
+  [1512 /* BATCH_TOTAL_TOO_LARGE */]: 413,
+  [1513 /* BATCH_FILE_INVALID */]: 400,
+  // multipart
+  [1520 /* MULTIPART_NOT_FOUND */]: 404,
+  [1521 /* MULTIPART_ALREADY_COMPLETED */]: 409,
+  [1522 /* MULTIPART_ALREADY_ABORTED */]: 409,
+  [1523 /* MULTIPART_EXPIRED */]: 410,
+  [1524 /* MULTIPART_STATUS_INVALID */]: 409,
+  [1530 /* MULTIPART_TOTAL_TOO_LARGE */]: 413,
+  [1531 /* MULTIPART_PART_TOO_LARGE */]: 413,
+  [1532 /* MULTIPART_PART_TOO_SMALL */]: 400,
+  [1533 /* MULTIPART_INVALID_PART_NUMBER */]: 400,
+  [1534 /* MULTIPART_DUPLICATE_PART */]: 409,
+  [1535 /* MULTIPART_PART_HASH_MISMATCH */]: 400,
+  [1536 /* MULTIPART_FINAL_HASH_MISMATCH */]: 400,
+  [1537 /* MULTIPART_INCOMPLETE_PARTS */]: 409,
+  [1538 /* MULTIPART_AUTH_REQUIRED */]: 401,
+  [1539 /* MULTIPART_INVALID_ARG */]: 400
+};
+var SecureError = class extends Error {
+  constructor(code, message) {
+    super(message ?? ErrorCode[code]);
+    this.code = code;
+    this.name = "SecureError";
+  }
+  code;
+  get statusCode() {
+    return HTTP[this.code];
+  }
+};
+function getHttpStatus(code) {
+  return HTTP[code];
+}
+export {
+  ErrorCode,
+  SecureError,
+  getHttpStatus
+};
+//# sourceMappingURL=errors.mjs.map

package/dist/server/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/errors.ts"],"sourcesContent":["/**\r\n * 错误码 + SecureError\r\n *\r\n * 设计:\r\n *   - 1000-1099: 通用请求错误(INVALID_REQUEST 等)\r\n *   - 1400-1499: HTTP 语义错误(NOT_FOUND / FORBIDDEN / RATE_LIMITED 等)\r\n *   - 1500-1599: 上传相关(BINARY / BATCH / MULTIPART)\r\n *\r\n * 独立于 secure-crypto-top-zod-sdk 的错误码空间,\r\n * 即使用户不引入加密 SDK,这套码也能独立用。\r\n */\r\n\r\nexport enum ErrorCode {\r\n  // 通用\r\n  INVALID_REQUEST    = 1001,\r\n  INTERNAL_ERROR     = 1500,\r\n  NOT_FOUND          = 1400,\r\n  FORBIDDEN          = 1403,\r\n  RATE_LIMITED       = 1402,\r\n\r\n  // binary 协议(网关透传场景)\r\n  BINARY_PAYLOAD_EMPTY     = 1501,\r\n  BINARY_PAYLOAD_TOO_LARGE = 1502,\r\n  BINARY_AUTH_REQUIRED     = 1503,\r\n  BINARY_AUTH_FAILED       = 1504,\r\n\r\n  // 批量上传\r\n  BATCH_EMPTY              = 1510,\r\n  BATCH_TOO_MANY_FILES     = 1511,\r\n  BATCH_TOTAL_TOO_LARGE    = 1512,\r\n  BATCH_FILE_INVALID       = 1513,\r\n\r\n  // 分片上传(1520-1539)\r\n  MULTIPART_NOT_FOUND              = 1520,\r\n  MULTIPART_ALREADY_COMPLETED      = 1521,\r\n  MULTIPART_ALREADY_ABORTED        = 1522,\r\n  MULTIPART_EXPIRED                = 1523,\r\n  MULTIPART_STATUS_INVALID         = 1524,\r\n  MULTIPART_TOTAL_TOO_LARGE        = 1530,\r\n  MULTIPART_PART_TOO_LARGE         = 1531,\r\n  MULTIPART_PART_TOO_SMALL         = 1532,\r\n  MULTIPART_INVALID_PART_NUMBER    = 1533,\r\n  MULTIPART_DUPLICATE_PART         = 1534,\r\n  MULTIPART_PART_HASH_MISMATCH     = 1535,\r\n  MULTIPART_FINAL_HASH_MISMATCH    = 1536,\r\n  MULTIPART_INCOMPLETE_PARTS       = 1537,\r\n  MULTIPART_AUTH_REQUIRED          = 1538,\r\n  MULTIPART_INVALID_ARG            = 1539,\r\n}\r\n\r\nconst HTTP: Record<ErrorCode, number> = {\r\n  [ErrorCode.INVALID_REQUEST]: 400,\r\n  [ErrorCode.INTERNAL_ERROR]: 500,\r\n  [ErrorCode.NOT_FOUND]: 404,\r\n  [ErrorCode.FORBIDDEN]: 403,\r\n  [ErrorCode.RATE_LIMITED]: 429,\r\n  // binary\r\n  [ErrorCode.BINARY_PAYLOAD_EMPTY]: 400,\r\n  [ErrorCode.BINARY_PAYLOAD_TOO_LARGE]: 413,\r\n  [ErrorCode.BINARY_AUTH_REQUIRED]: 401,\r\n  [ErrorCode.BINARY_AUTH_FAILED]: 401,\r\n  // batch\r\n  [ErrorCode.BATCH_EMPTY]: 400,\r\n  [ErrorCode.BATCH_TOO_MANY_FILES]: 413,\r\n  [ErrorCode.BATCH_TOTAL_TOO_LARGE]: 413,\r\n  [ErrorCode.BATCH_FILE_INVALID]: 400,\r\n  // multipart\r\n  [ErrorCode.MULTIPART_NOT_FOUND]: 404,\r\n  [ErrorCode.MULTIPART_ALREADY_COMPLETED]: 409,\r\n  [ErrorCode.MULTIPART_ALREADY_ABORTED]: 409,\r\n  [ErrorCode.MULTIPART_EXPIRED]: 410,\r\n  [ErrorCode.MULTIPART_STATUS_INVALID]: 409,\r\n  [ErrorCode.MULTIPART_TOTAL_TOO_LARGE]: 413,\r\n  [ErrorCode.MULTIPART_PART_TOO_LARGE]: 413,\r\n  [ErrorCode.MULTIPART_PART_TOO_SMALL]: 400,\r\n  [ErrorCode.MULTIPART_INVALID_PART_NUMBER]: 400,\r\n  [ErrorCode.MULTIPART_DUPLICATE_PART]: 409,\r\n  [ErrorCode.MULTIPART_PART_HASH_MISMATCH]: 400,\r\n  [ErrorCode.MULTIPART_FINAL_HASH_MISMATCH]: 400,\r\n  [ErrorCode.MULTIPART_INCOMPLETE_PARTS]: 409,\r\n  [ErrorCode.MULTIPART_AUTH_REQUIRED]: 401,\r\n  [ErrorCode.MULTIPART_INVALID_ARG]: 400,\r\n};\r\n\r\nexport class SecureError extends Error {\r\n  constructor(public code: ErrorCode, message?: string) {\r\n    super(message ?? ErrorCode[code]);\r\n    this.name = 'SecureError';\r\n  }\r\n  get statusCode(): number {\r\n    return HTTP[this.code];\r\n  }\r\n}\r\n\r\nexport function getHttpStatus(code: ErrorCode): number {\r\n  return HTTP[code];\r\n}\r\n"],"mappings":";AAYO,IAAK,YAAL,kBAAKA,eAAL;AAEL,EAAAA,sBAAA,qBAAqB,QAArB;AACA,EAAAA,sBAAA,oBAAqB,QAArB;AACA,EAAAA,sBAAA,eAAqB,QAArB;AACA,EAAAA,sBAAA,eAAqB,QAArB;AACA,EAAAA,sBAAA,kBAAqB,QAArB;AAGA,EAAAA,sBAAA,0BAA2B,QAA3B;AACA,EAAAA,sBAAA,8BAA2B,QAA3B;AACA,EAAAA,sBAAA,0BAA2B,QAA3B;AACA,EAAAA,sBAAA,wBAA2B,QAA3B;AAGA,EAAAA,sBAAA,iBAA2B,QAA3B;AACA,EAAAA,sBAAA,0BAA2B,QAA3B;AACA,EAAAA,sBAAA,2BAA2B,QAA3B;AACA,EAAAA,sBAAA,wBAA2B,QAA3B;AAGA,EAAAA,sBAAA,yBAAmC,QAAnC;AACA,EAAAA,sBAAA,iCAAmC,QAAnC;AACA,EAAAA,sBAAA,+BAAmC,QAAnC;AACA,EAAAA,sBAAA,uBAAmC,QAAnC;AACA,EAAAA,sBAAA,8BAAmC,QAAnC;AACA,EAAAA,sBAAA,+BAAmC,QAAnC;AACA,EAAAA,sBAAA,8BAAmC,QAAnC;AACA,EAAAA,sBAAA,8BAAmC,QAAnC;AACA,EAAAA,sBAAA,mCAAmC,QAAnC;AACA,EAAAA,sBAAA,8BAAmC,QAAnC;AACA,EAAAA,sBAAA,kCAAmC,QAAnC;AACA,EAAAA,sBAAA,mCAAmC,QAAnC;AACA,EAAAA,sBAAA,gCAAmC,QAAnC;AACA,EAAAA,sBAAA,6BAAmC,QAAnC;AACA,EAAAA,sBAAA,2BAAmC,QAAnC;AAnCU,SAAAA;AAAA,GAAA;AAsCZ,IAAM,OAAkC;AAAA,EACtC,CAAC,0BAAyB,GAAG;AAAA,EAC7B,CAAC,yBAAwB,GAAG;AAAA,EAC5B,CAAC,oBAAmB,GAAG;AAAA,EACvB,CAAC,oBAAmB,GAAG;AAAA,EACvB,CAAC,uBAAsB,GAAG;AAAA;AAAA,EAE1B,CAAC,+BAA8B,GAAG;AAAA,EAClC,CAAC,mCAAkC,GAAG;AAAA,EACtC,CAAC,+BAA8B,GAAG;AAAA,EAClC,CAAC,6BAA4B,GAAG;AAAA;AAAA,EAEhC,CAAC,sBAAqB,GAAG;AAAA,EACzB,CAAC,+BAA8B,GAAG;AAAA,EAClC,CAAC,gCAA+B,GAAG;AAAA,EACnC,CAAC,6BAA4B,GAAG;AAAA;AAAA,EAEhC,CAAC,8BAA6B,GAAG;AAAA,EACjC,CAAC,sCAAqC,GAAG;AAAA,EACzC,CAAC,oCAAmC,GAAG;AAAA,EACvC,CAAC,4BAA2B,GAAG;AAAA,EAC/B,CAAC,mCAAkC,GAAG;AAAA,EACtC,CAAC,oCAAmC,GAAG;AAAA,EACvC,CAAC,mCAAkC,GAAG;AAAA,EACtC,CAAC,mCAAkC,GAAG;AAAA,EACtC,CAAC,wCAAuC,GAAG;AAAA,EAC3C,CAAC,mCAAkC,GAAG;AAAA,EACtC,CAAC,uCAAsC,GAAG;AAAA,EAC1C,CAAC,wCAAuC,GAAG;AAAA,EAC3C,CAAC,qCAAoC,GAAG;AAAA,EACxC,CAAC,kCAAiC,GAAG;AAAA,EACrC,CAAC,gCAA+B,GAAG;AACrC;AAEO,IAAM,cAAN,cAA0B,MAAM;AAAA,EACrC,YAAmB,MAAiB,SAAkB;AACpD,UAAM,WAAW,UAAU,IAAI,CAAC;AADf;AAEjB,SAAK,OAAO;AAAA,EACd;AAAA,EAHmB;AAAA,EAInB,IAAI,aAAqB;AACvB,WAAO,KAAK,KAAK,IAAI;AAAA,EACvB;AACF;AAEO,SAAS,cAAc,MAAyB;AACrD,SAAO,KAAK,IAAI;AAClB;","names":["ErrorCode"]}

package/dist/server/fastify-plugin.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Fastify 主插件
+ *
+ * 注册 5 + 1 端点:
+ *   - {pathPrefix.multipart}/init
+ *   - {pathPrefix.multipart}/part
+ *   - {pathPrefix.multipart}/complete
+ *   - {pathPrefix.multipart}/abort
+ *   - {pathPrefix.multipart}/status
+ *   - {pathPrefix.smart}/init
+ *
+ * 用法(详见 README):
+ *
+ *   import Fastify from 'fastify';
+ *   import uploadPlugin from 'secure-upload-fastify-sdk/server';
+ *   import { LocalStorage } from 'secure-upload-fastify-sdk/storage';
+ *   import { PrismaMultipartRepository, PrismaFileRepository } from 'secure-upload-fastify-sdk/repository';
+ *
+ *   const app = Fastify({ logger: true });
+ *   await app.register(uploadPlugin, {
+ *     storage: { adapter: 'local', options: { baseDir: '/var/upload' } },
+ *     repository: { kind: 'prisma', prisma },
+ *     redis,
+ *     pathPrefix: { multipart: '/api/v1/upload/multipart', smart: '/api/v1/upload/smart' },
+ *     fileUrlPrefix: '/api/v1/upload/files',
+ *   });
+ */
+import type { FastifyInstance } from 'fastify';
+import { LocalStorage } from './utils/storage/local';
+import { InMemoryStorage } from './utils/storage/memory';
+import { PrismaMultipartRepository, PrismaFileRepository } from './utils/repository/prisma';
+import { InMemoryMultipartRepository, InMemoryFileRepository } from './utils/repository/memory';
+import type { SecureUploadOptions } from './types';
+declare function secureUploadPluginImpl(app: FastifyInstance, options: SecureUploadOptions): Promise<void>;
+declare const _default: typeof secureUploadPluginImpl;
+export default _default;
+export { LocalStorage, InMemoryStorage, PrismaMultipartRepository, PrismaFileRepository, InMemoryMultipartRepository, InMemoryFileRepository, };
+//# sourceMappingURL=fastify-plugin.d.ts.map

package/dist/server/fastify-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify-plugin.d.ts","sourceRoot":"","sources":["../../src/server/fastify-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC5F,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAQhG,OAAO,KAAK,EACV,mBAAmB,EAIpB,MAAM,SAAS,CAAC;AAmDjB,iBAAe,sBAAsB,CACnC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAqHf;;AAED,wBAGG;AAKH,OAAO,EACL,YAAY,EACZ,eAAe,EACf,yBAAyB,EACzB,oBAAoB,EACpB,2BAA2B,EAC3B,sBAAsB,GACvB,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Server 公开 API
+ *
+ * 主入口:
+ *   import secureUploadPlugin, { type SecureUploadOptions } from 'secure-upload-fastify-sdk/server';
+ *   await app.register(secureUploadPlugin, { ... });
+ *
+ * 工具类:
+ *   import { LocalStorage, InMemoryStorage } from 'secure-upload-fastify-sdk/storage';
+ *   import { PrismaMultipartRepository, PrismaFileRepository } from 'secure-upload-fastify-sdk/repository';
+ *   import { ErrorCode, SecureError } from 'secure-upload-fastify-sdk/errors';
+ *   import { chooseStrategy, suggestConcurrency, DEFAULT_STRATEGY_CONFIG } from 'secure-upload-fastify-sdk/strategy';
+ */
+export { default, default as secureUploadPlugin, LocalStorage, InMemoryStorage, PrismaMultipartRepository, PrismaFileRepository, InMemoryMultipartRepository, InMemoryFileRepository, } from './fastify-plugin';
+export type { SecureUploadOptions, SecureUploadRuntime, SecureMode, RepositoryConfig, StorageConfig, PathPrefixConfig, SessionValidator, InitResponse, PartResponse, CompleteResponse, AbortResponse, StatusResponse, MultipartRecord, FileRecord, } from './types';
+export { ErrorCode, SecureError, getHttpStatus, } from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,OAAO,EACP,OAAO,IAAI,kBAAkB,EAC7B,YAAY,EACZ,eAAe,EACf,yBAAyB,EACzB,oBAAoB,EACpB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,SAAS,EACT,WAAW,EACX,aAAa,GACd,MAAM,UAAU,CAAC"}