@dimah-s3/core 0.6.3 → 0.7.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.
package/dist/index.js CHANGED
@@ -85,7 +85,7 @@ function sanitizeFileName(fileName) {
85
85
  }
86
86
 
87
87
  // src/helpers/truncate-file-name.ts
88
- function truncateFileName(name, maxChars = 26) {
88
+ function truncateFileName(name, maxChars = 48) {
89
89
  if (name.length <= maxChars) return name;
90
90
  const dotIndex = name.lastIndexOf(".");
91
91
  if (dotIndex <= 0) {
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/helpers/validate-file.ts","../src/helpers/build-object-key.ts","../src/helpers/get-file-extension.ts","../src/helpers/parse-file-name.ts","../src/helpers/format-file-size.ts","../src/helpers/build-content-disposition.ts","../src/helpers/sanitize-file-name.ts","../src/helpers/truncate-file-name.ts","../src/error.ts","../src/routes.ts","../src/plugin/create-fetcher.ts","../src/plugin/define-client-plugin.ts","../src/plugin/plugin-endpoint-path.ts","../src/plugin/types.ts","../src/create-s3-client.ts"],"names":["options"],"mappings":";AAiBO,SAAS,YAAA,CACd,MACA,OAAA,EAC0B;AAC1B,EAAA,IAAI,OAAA,CAAQ,QAAQ,MAAA,EAAQ;AAC1B,IAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,MAAA,CAAO,IAAA,CAAK,CAAC,IAAA,KAAS;AAC5C,MAAA,IAAI,IAAA,CAAK,UAAA,CAAW,GAAG,CAAA,EAAG;AACxB,QAAA,OAAO,KAAK,IAAA,CAAK,WAAA,GAAc,QAAA,CAAS,IAAA,CAAK,aAAa,CAAA;AAAA,MAC5D;AACA,MAAA,IAAI,IAAA,CAAK,QAAA,CAAS,IAAI,CAAA,EAAG;AACvB,QAAA,OAAO,KAAK,IAAA,CAAK,UAAA,CAAW,KAAK,OAAA,CAAQ,IAAA,EAAM,GAAG,CAAC,CAAA;AAAA,MACrD;AACA,MAAA,OAAO,KAAK,IAAA,KAAS,IAAA;AAAA,IACvB,CAAC,CAAA;AACD,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,MAAM,GAAA,GAAM,IAAA,CAAK,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA,GAAI,IAAA,CAAK,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA,CAAE,GAAA,EAAI,GAAI,IAAA;AACnE,MAAA,MAAM,OAAO,GAAA,GAAM,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA,GAAK,KAAK,IAAA,IAAQ,SAAA;AAC5C,MAAA,OAAO;AAAA,QACL,IAAA,EAAM,uBAAA;AAAA,QACN,OAAA,EAAS,cAAc,IAAI,CAAA,gBAAA,CAAA;AAAA,QAC3B,MAAA,EAAQ,EAAE,IAAA;AAAK,OACjB;AAAA,IACF;AAAA,EACF;AAEA,EAAA,IAAI,IAAA,CAAK,SAAS,CAAA,EAAG;AACnB,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,YAAA;AAAA,MACN,OAAA,EAAS;AAAA,KACX;AAAA,EACF;AAEA,EAAA,IAAI,OAAA,CAAQ,WAAA,IAAe,IAAA,CAAK,IAAA,GAAO,QAAQ,WAAA,EAAa;AAC1D,IAAA,MAAM,SAAS,OAAA,CAAQ,WAAA,IAAe,IAAA,GAAO,IAAA,CAAA,EAAO,QAAQ,CAAC,CAAA;AAC7D,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,gBAAA;AAAA,MACN,OAAA,EAAS,qBAAqB,KAAK,CAAA,SAAA,CAAA;AAAA,MACnC,MAAA,EAAQ,EAAE,IAAA,EAAM,CAAA,EAAG,KAAK,CAAA,GAAA,CAAA;AAAM,KAChC;AAAA,EACF;AAEA,EAAA,OAAO,IAAA;AACT;;;AC3DO,SAAS,kBAAkB,KAAA,EAAyB;AACzD,EAAA,OAAO,KAAA,CACJ,GAAA,CAAI,CAAC,CAAA,KAAM,EAAE,OAAA,CAAQ,YAAA,EAAc,EAAE,CAAC,CAAA,CACtC,MAAA,CAAO,OAAO,CAAA,CACd,KAAK,GAAG,CAAA;AACb;;;ACLO,SAAS,iBAAiB,QAAA,EAA0B;AACzD,EAAA,MAAM,QAAA,GAAW,QAAA,CAAS,WAAA,CAAY,GAAG,CAAA;AACzC,EAAA,IAAI,QAAA,GAAW,GAAG,OAAO,EAAA;AACzB,EAAA,OAAO,QAAA,CAAS,KAAA,CAAM,QAAA,GAAW,CAAC,EAAE,WAAA,EAAY;AAClD;;;ACJO,SAAS,cACd,kBAAA,EACoB;AACpB,EAAA,IAAI,CAAC,oBAAoB,OAAO,MAAA;AAEhC,EAAA,MAAM,SAAA,GAAY,kBAAA,CAAmB,KAAA,CAAM,+BAA+B,CAAA;AAC1E,EAAA,IAAI,SAAA,EAAW;AACb,IAAA,IAAI;AACF,MAAA,OAAO,kBAAA,CAAmB,SAAA,CAAU,CAAC,CAAC,CAAA;AAAA,IACxC,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AAEA,EAAA,MAAM,UAAA,GAAa,kBAAA,CAAmB,KAAA,CAAM,qBAAqB,CAAA;AACjE,EAAA,OAAO,aAAa,CAAC,CAAA;AACvB;;;AChBO,SAAS,eAAe,KAAA,EAAuB;AACpD,EAAA,IAAI,KAAA,KAAU,GAAG,OAAO,KAAA;AACxB,EAAA,MAAM,QAAQ,CAAC,GAAA,EAAK,IAAA,EAAM,IAAA,EAAM,MAAM,IAAI,CAAA;AAC1C,EAAA,MAAM,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,GAAI,IAAA,CAAK,GAAA,CAAI,IAAI,CAAC,CAAA;AACrD,EAAA,MAAM,IAAA,GAAO,KAAA,GAAQ,IAAA,CAAK,GAAA,CAAI,MAAM,CAAC,CAAA;AACrC,EAAA,OAAO,CAAA,EAAG,IAAA,CAAK,OAAA,CAAQ,CAAA,KAAM,CAAA,GAAI,CAAA,GAAI,CAAC,CAAC,CAAA,CAAA,EAAI,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AACrD;;;ACAO,SAAS,wBAAwB,QAAA,EAA0B;AAChE,EAAA,MAAM,KAAA,GAAQ,SAAS,OAAA,CAAQ,eAAA,EAAiB,GAAG,CAAA,CAAE,OAAA,CAAQ,UAAU,GAAG,CAAA;AAC1E,EAAA,MAAM,OAAA,GAAU,mBAAmB,QAAQ,CAAA;AAC3C,EAAA,OAAO,CAAA,sBAAA,EAAyB,KAAK,CAAA,oBAAA,EAAuB,OAAO,CAAA,CAAA;AACrE;;;ACTO,SAAS,iBAAiB,QAAA,EAA0B;AACzD,EAAA,OAAO,QAAA,CAAS,OAAA,CAAQ,YAAA,EAAc,GAAG,CAAA;AAC3C;;;ACAO,SAAS,gBAAA,CAAiB,IAAA,EAAc,QAAA,GAAW,EAAA,EAAY;AACpE,EAAA,IAAI,IAAA,CAAK,MAAA,IAAU,QAAA,EAAU,OAAO,IAAA;AACpC,EAAA,MAAM,QAAA,GAAW,IAAA,CAAK,WAAA,CAAY,GAAG,CAAA;AACrC,EAAA,IAAI,YAAY,CAAA,EAAG;AACjB,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,CAAA,EAAG,QAAA,GAAW,CAAC,CAAA,GAAI,QAAA;AAAA,EACvC;AACA,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,QAAQ,CAAA;AAC/B,EAAA,MAAM,SAAA,GAAY,QAAA,GAAW,GAAA,CAAI,MAAA,GAAS,CAAA;AAC1C,EAAA,IAAI,aAAa,CAAA,EAAG;AAClB,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,CAAA,EAAG,QAAA,GAAW,CAAC,CAAA,GAAI,QAAA;AAAA,EACvC;AACA,EAAA,OAAO,IAAA,CAAK,KAAA,CAAM,CAAA,EAAG,SAAS,IAAI,SAAA,GAAO,GAAA;AAC3C;AAGO,IAAM,gBAAA,GAAmB;;;ACjBzB,IAAM,cAAA,GAAiB;AAAA,EAC5B,SAAA,EAAW,WAAA;AAAA,EACX,YAAA,EAAc,cAAA;AAAA,EACd,SAAA,EAAW,WAAA;AAAA,EACX,cAAA,EAAgB,gBAAA;AAAA,EAChB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,cAAA,EAAgB,gBAAA;AAAA,EAChB,YAAA,EAAc,cAAA;AAAA,EACd,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,cAAA,EAAgB,gBAAA;AAAA,EAChB,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,4BAAA,EAA8B;AAChC;AAaO,IAAM,YAAA,GAAN,cAA2B,KAAA,CAAM;AAAA,EAC7B,MAAA;AAAA,EACA,IAAA;AAAA,EACA,MAAA;AAAA,EAET,WAAA,CAAY,OAAA,EAAiB,MAAA,GAAS,GAAA,EAAK,OAAA,EAA+B;AACxE,IAAA,KAAA;AAAA,MACE,OAAA;AAAA,MACA,SAAS,KAAA,KAAU,MAAA,GAAY,EAAE,KAAA,EAAO,OAAA,CAAQ,OAAM,GAAI;AAAA,KAC5D;AACA,IAAA,IAAA,CAAK,IAAA,GAAO,cAAA;AACZ,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,OAAO,OAAA,EAAS,IAAA;AACrB,IAAA,IAAA,CAAK,SAAS,OAAA,EAAS,MAAA;AAAA,EACzB;AACF;;;AC1CO,IAAM,gBAAA,GAAmB;AAEzB,SAAS,uBAAuB,QAAA,EAA0B;AAC/D,EAAA,OAAO,QAAA,CAAS,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AACnC;AAEO,IAAM,aAAA,GAAgB;AAAA,EAC3B,MAAA,EAAQ,gBAAA;AAAA,EACR,aAAA,EAAe,wBAAA;AAAA,EACf,QAAA,EAAU,kBAAA;AAAA,EACV,MAAA,EAAQ,QAAA;AAAA,EACR,aAAA,EAAe,wBAAA;AAAA,EACf,aAAA,EAAe,wBAAA;AAAA,EACf,iBAAA,EAAmB,4BAAA;AAAA,EACnB,cAAA,EAAgB,yBAAA;AAAA,EAChB,kBAAA,EAAoB;AACtB;;;ACdA,SAAS,WACP,KAAA,EACQ;AACR,EAAA,IAAI,CAAC,OAAO,OAAO,EAAA;AACnB,EAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AACnC,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,EAAG;AAChD,IAAA,IAAI,UAAU,MAAA,EAAW;AACzB,IAAA,MAAA,CAAO,GAAA,CAAI,GAAA,EAAK,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EAC/B;AACA,EAAA,MAAM,EAAA,GAAK,OAAO,QAAA,EAAS;AAC3B,EAAA,OAAO,EAAA,GAAK,CAAA,CAAA,EAAI,EAAE,CAAA,CAAA,GAAK,EAAA;AACzB;AAEA,eAAe,eACb,OAAA,EACkC;AAClC,EAAA,IAAI,OAAA,IAAW,MAAM,OAAO,MAAA;AAC5B,EAAA,IAAI,OAAO,OAAA,KAAY,UAAA,EAAY,OAAO,OAAA,EAAQ;AAClD,EAAA,OAAO,OAAA;AACT;AAEA,SAAS,gBACJ,KAAA,EACqB;AACxB,EAAA,MAAM,MAA8B,EAAC;AACrC,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,IAAI,CAAC,IAAA,EAAM;AACX,IAAA,MAAM,CAAA,GAAI,IAAI,OAAA,CAAQ,IAAI,CAAA;AAC1B,IAAA,CAAA,CAAE,OAAA,CAAQ,CAAC,KAAA,EAAO,GAAA,KAAQ;AACxB,MAAA,GAAA,CAAI,GAAG,CAAA,GAAI,KAAA;AAAA,IACb,CAAC,CAAA;AAAA,EACH;AACA,EAAA,OAAO,GAAA;AACT;AAEA,SAAS,SAAS,IAAA,EAA4B;AAC5C,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA,EAAmB;AAAA,IAC9C,MAAM,IAAA,KAAS,MAAA,GAAY,MAAA,GAAY,IAAA,CAAK,UAAU,IAAI;AAAA,GAC5D;AACF;AASO,SAAS,aAAA,CACd,MACA,OAAA,EACiB;AACjB,EAAA,MAAM,SAAA,GAAY,SAAS,KAAA,IAAS,KAAA;AAEpC,EAAA,MAAM,IAAA,GAAO,OAAU,GAAA,EAAa,IAAA,KAAmC;AACrE,IAAA,MAAM,YAAA,GAAe,MAAM,cAAA,CAAe,OAAA,EAAS,OAAO,CAAA;AAC1D,IAAA,MAAM,GAAA,GAAM,MAAM,SAAA,CAAU,GAAA,EAAK;AAAA,MAC/B,GAAG,IAAA;AAAA,MACH,WAAA,EAAa,OAAA,EAAS,WAAA,IAAe,IAAA,EAAM,WAAA;AAAA,MAC3C,OAAA,EAAS,YAAA,CAAa,YAAA,EAAc,IAAA,EAAM,OAAO;AAAA,KAClD,CAAA;AACD,IAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,MAAA,MAAM,IAAA,GAAQ,MAAM,GAAA,CAAI,IAAA,GAAO,KAAA,CAAM,OAAO,EAAC,CAAE,CAAA;AAK/C,MAAA,MAAM,IAAI,YAAA,CAAa,IAAA,CAAK,WAAW,GAAA,CAAI,UAAA,EAAY,IAAI,MAAA,EAAQ;AAAA,QACjE,MAAM,IAAA,CAAK,IAAA;AAAA,QACX,QAAQ,IAAA,CAAK;AAAA,OACd,CAAA;AAAA,IACH;AACA,IAAA,OAAO,IAAI,IAAA,EAAK;AAAA,EAClB,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,GAAA,CACE,MACA,KAAA,EACA;AACA,MAAA,OAAO,IAAA,CAAQ,GAAG,IAAI,CAAA,CAAA,EAAI,IAAI,CAAA,EAAG,UAAA,CAAW,KAAK,CAAC,CAAA,CAAE,CAAA;AAAA,IACtD,CAAA;AAAA,IACA,IAAA,CAAQ,MAAc,IAAA,EAAgB;AACpC,MAAA,OAAO,IAAA,CAAQ,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,EAAI;AAAA,QAChC,MAAA,EAAQ,MAAA;AAAA,QACR,GAAG,SAAS,IAAI;AAAA,OACjB,CAAA;AAAA,IACH,CAAA;AAAA,IACA,GAAA,CAAO,MAAc,IAAA,EAAgB;AACnC,MAAA,OAAO,IAAA,CAAQ,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,EAAI;AAAA,QAChC,MAAA,EAAQ,KAAA;AAAA,QACR,GAAG,SAAS,IAAI;AAAA,OACjB,CAAA;AAAA,IACH,CAAA;AAAA,IACA,KAAA,CAAS,MAAc,IAAA,EAAgB;AACrC,MAAA,OAAO,IAAA,CAAQ,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,EAAI;AAAA,QAChC,MAAA,EAAQ,OAAA;AAAA,QACR,GAAG,SAAS,IAAI;AAAA,OACjB,CAAA;AAAA,IACH,CAAA;AAAA,IACA,MAAA,CACE,MACA,KAAA,EACA;AACA,MAAA,OAAO,IAAA,CAAQ,GAAG,IAAI,CAAA,CAAA,EAAI,IAAI,CAAA,EAAG,UAAA,CAAW,KAAK,CAAC,CAAA,CAAA,EAAI;AAAA,QACpD,MAAA,EAAQ;AAAA,OACT,CAAA;AAAA,IACH;AAAA,GACF;AACF;;;AChGO,SAAS,mBAGd,MAAA,EAAoE;AACpE,EAAA,OAAO,MAAA;AACT;;;ACfO,SAAS,kBAAA,CAAmB,UAAkB,IAAA,EAAsB;AACzE,EAAA,OAAO,WAAW,QAAQ,CAAA,CAAA,EAAI,KAAK,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAC,CAAA,CAAA;AACxD;;;ACiDO,IAAM,oBAAA,GAAuB;AAAA,EAClC,QAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF;;;AC3BA,SAAS,eACP,KAAA,EACoB;AACpB,EAAA,MAAM,EAAE,OAAA,EAAS,QAAA,EAAU,GAAG,MAAK,GAAI,KAAA;AACvC,EAAA,OAAO,IAAA;AACT;AAoBO,SAAS,eACd,OAAA,EACmC;AACnC,EAAA,MAAM,EAAE,QAAA,EAAU,OAAA,EAAS,GAAG,YAAA,EAAa,GAAI,WAAW,EAAC;AAC3D,EAAA,MAAM,IAAA,GAAO,sBAAA,CAAuB,QAAA,IAAY,gBAAgB,CAAA;AAChE,EAAA,MAAM,OAAA,GAAU,aAAA,CAAc,IAAA,EAAM,YAAY,CAAA;AAEhD,EAAA,MAAM,GAAA,GAAa;AAAA,IACjB,OAAO,OAAA,EAAS;AACd,MAAA,OAAO,OAAA,CAAQ,IAAA;AAAA,QACb,aAAA,CAAc,MAAA;AAAA,QACd,eAAe,OAAO;AAAA,OACxB;AAAA,IACF,CAAA;AAAA,IAEA,QAAQ,OAAA,EAAS;AACf,MAAA,OAAO,OAAA,CAAQ,IAAA;AAAA,QACb,aAAA,CAAc,aAAA;AAAA,QACd,eAAe,OAAO;AAAA,OACxB;AAAA,IACF,CAAA;AAAA,IAEA,QAAA,CAAS,KAAKA,QAAAA,EAAU;AACtB,MAAA,MAAM,EAAE,QAAA,EAAU,MAAA,EAAO,GAAIA,YAAW,EAAC;AACzC,MAAA,OAAO,OAAA,CAAQ,GAAA,CAAqB,aAAA,CAAc,QAAA,EAAU;AAAA,QAC1D,GAAA;AAAA,QACA,QAAA,EAAU,QAAA,GAAW,gBAAA,CAAiB,QAAQ,CAAA,GAAI,MAAA;AAAA,QAClD;AAAA,OACD,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,MAAA,CAAO,KAAKA,QAAAA,EAAU;AACpB,MAAA,MAAM,EAAE,MAAA,EAAO,GAAIA,QAAAA,IAAW,EAAC;AAC/B,MAAA,OAAO,OAAA,CAAQ,MAAA,CAAuB,aAAA,CAAc,MAAA,EAAQ;AAAA,QAC1D,GAAA;AAAA,QACA;AAAA,OACD,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,SAAA,EAAW;AAAA,MACT,KAAK,OAAA,EAAS;AACZ,QAAA,OAAO,OAAA,CAAQ,IAAA;AAAA,UACb,aAAA,CAAc,aAAA;AAAA,UACd,eAAe,OAAO;AAAA,SACxB;AAAA,MACF,CAAA;AAAA,MAEA,SAAS,OAAA,EAAS;AAChB,QAAA,OAAO,OAAA,CAAQ,IAAA;AAAA,UACb,aAAA,CAAc,aAAA;AAAA,UACd,eAAe,OAAO;AAAA,SACxB;AAAA,MACF,CAAA;AAAA,MAEA,UAAU,OAAA,EAAS;AACjB,QAAA,MAAM,EAAE,GAAA,EAAK,QAAA,EAAU,MAAA,EAAO,GAAI,eAAe,OAAO,CAAA;AACxD,QAAA,OAAO,OAAA,CAAQ,GAAA;AAAA,UACb,aAAA,CAAc,kBAAA;AAAA,UACd,EAAE,GAAA,EAAK,QAAA,EAAU,MAAA;AAAO,SAC1B;AAAA,MACF,CAAA;AAAA,MAEA,SAAS,OAAA,EAAS;AAChB,QAAA,OAAO,OAAA,CAAQ,IAAA;AAAA,UACb,aAAA,CAAc,iBAAA;AAAA,UACd,eAAe,OAAO;AAAA,SACxB;AAAA,MACF,CAAA;AAAA,MAEA,MAAM,OAAA,EAAS;AACb,QAAA,OAAO,OAAA,CAAQ,IAAA;AAAA,UACb,aAAA,CAAc,cAAA;AAAA,UACd,eAAe,OAAO;AAAA,SACxB;AAAA,MACF;AAAA;AACF,GACF;AAEA,EAAA,MAAM,gBAAyC,EAAC;AAChD,EAAA,KAAA,MAAW,MAAA,IAAU,OAAA,IAAW,EAAC,EAAG;AAClC,IAAA,IAAK,oBAAA,CAA2C,QAAA,CAAS,MAAA,CAAO,EAAE,CAAA,EAAG;AACnE,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,kBAAA,EAAqB,OAAO,EAAE,CAAA,+BAAA;AAAA,OAChC;AAAA,IACF;AACA,IAAA,IAAI,MAAA,CAAO,MAAM,aAAA,EAAe;AAC9B,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,4BAAA,EAA+B,MAAA,CAAO,EAAE,CAAA,EAAA,CAAI,CAAA;AAAA,IAC9D;AACA,IAAA,aAAA,CAAc,MAAA,CAAO,EAAE,CAAA,GAAI,MAAA,CAAO,cAAc,OAAO,CAAA;AAAA,EACzD;AAEA,EAAA,OAAO,EAAE,GAAG,GAAA,EAAK,GAAG,aAAA,EAAc;AACpC","file":"index.js","sourcesContent":["/** Machine-readable codes for client-side file validation failures. */\nexport type ValidateFileErrorCode =\n \"FILE_TYPE_NOT_ALLOWED\" | \"FILE_EMPTY\" | \"FILE_TOO_LARGE\";\n\n/** Result of {@link validateFile} when the file fails a check. */\nexport type ValidateFileError = {\n code: ValidateFileErrorCode;\n /** English fallback message (localize via Fuma when a translator is available). */\n message: string;\n /** Interpolation params for i18n (e.g. `{ type }`, `{ size }`). */\n params?: Record<string, string | number>;\n};\n\n/**\n * Client-side accept / size / empty checks before starting an upload.\n * Returns `null` when the file is valid.\n */\nexport function validateFile(\n file: File,\n options: { accept?: string[]; maxFileSize?: number },\n): ValidateFileError | null {\n if (options.accept?.length) {\n const allowed = options.accept.some((type) => {\n if (type.startsWith(\".\")) {\n return file.name.toLowerCase().endsWith(type.toLowerCase());\n }\n if (type.endsWith(\"/*\")) {\n return file.type.startsWith(type.replace(\"/*\", \"/\"));\n }\n return file.type === type;\n });\n if (!allowed) {\n const ext = file.name.includes(\".\") ? file.name.split(\".\").pop() : null;\n const type = ext ? `.${ext}` : file.type || \"unknown\";\n return {\n code: \"FILE_TYPE_NOT_ALLOWED\",\n message: `File type \"${type}\" is not allowed`,\n params: { type },\n };\n }\n }\n\n if (file.size === 0) {\n return {\n code: \"FILE_EMPTY\",\n message: \"File is empty\",\n };\n }\n\n if (options.maxFileSize && file.size > options.maxFileSize) {\n const maxMB = (options.maxFileSize / (1024 * 1024)).toFixed(1);\n return {\n code: \"FILE_TOO_LARGE\",\n message: `File size exceeds ${maxMB} MB limit`,\n params: { size: `${maxMB} MB` },\n };\n }\n\n return null;\n}\n","export function buildObjectKey(...parts: string[]): string {\n return parts\n .map((p) => p.replace(/^\\/+|\\/+$/g, \"\"))\n .filter(Boolean)\n .join(\"/\");\n}\n","export function getFileExtension(fileName: string): string {\n const dotIndex = fileName.lastIndexOf(\".\");\n if (dotIndex < 1) return \"\";\n return fileName.slice(dotIndex + 1).toLowerCase();\n}\n","export function parseFileName(\n contentDisposition: string | null | undefined,\n): string | undefined {\n if (!contentDisposition) return undefined;\n\n const utf8Match = contentDisposition.match(/filename\\*=UTF-8''([^;,\\s]+)/i);\n if (utf8Match) {\n try {\n return decodeURIComponent(utf8Match[1]);\n } catch {\n /* ignore malformed encoding */\n }\n }\n\n const asciiMatch = contentDisposition.match(/filename=\"([^\"]*)\"/i);\n return asciiMatch?.[1];\n}\n","export function formatFileSize(bytes: number): string {\n if (bytes === 0) return \"0 B\";\n const units = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\"];\n const i = Math.floor(Math.log(bytes) / Math.log(1024));\n const size = bytes / Math.pow(1024, i);\n return `${size.toFixed(i === 0 ? 0 : 1)} ${units[i]}`;\n}\n","/**\n * Builds a RFC 6266 `Content-Disposition` value for a file attachment.\n *\n * Includes both the ASCII-safe `filename` fallback and the RFC 5987\n * `filename*` parameter for full Unicode support.\n */\nexport function buildContentDisposition(fileName: string): string {\n const ascii = fileName.replace(/[^\\x20-\\x7E]/g, \"_\").replace(/[\"\\\\]/g, \"_\");\n const encoded = encodeURIComponent(fileName);\n return `attachment; filename=\"${ascii}\"; filename*=UTF-8''${encoded}`;\n}\n","/** Sanitizes a file name for safe use in URL query parameters. */\nexport function sanitizeFileName(fileName: string): string {\n return fileName.replace(/[\"\\\\\\r\\n]/g, \"_\");\n}\n","/**\n * Truncates a filename while preserving the extension when possible.\n */\nexport function truncateFileName(name: string, maxChars = 26): string {\n if (name.length <= maxChars) return name;\n const dotIndex = name.lastIndexOf(\".\");\n if (dotIndex <= 0) {\n return name.slice(0, maxChars - 1) + \"…\";\n }\n const ext = name.slice(dotIndex);\n const available = maxChars - ext.length - 1;\n if (available <= 0) {\n return name.slice(0, maxChars - 1) + \"…\";\n }\n return name.slice(0, available) + \"… \" + ext;\n}\n\n/** @deprecated Use {@link truncateFileName}. */\nexport const truncateFilename = truncateFileName;\n","/** Stable API error codes returned in JSON `{ code, message, params? }`. */\nexport const S3_ERROR_CODES = {\n NOT_FOUND: \"NOT_FOUND\",\n INVALID_JSON: \"INVALID_JSON\",\n FORBIDDEN: \"FORBIDDEN\",\n INTERNAL_ERROR: \"INTERNAL_ERROR\",\n OBJECT_NOT_FOUND: \"OBJECT_NOT_FOUND\",\n S3_NETWORK_ERROR: \"S3_NETWORK_ERROR\",\n FIELD_REQUIRED: \"FIELD_REQUIRED\",\n KEY_REQUIRED: \"KEY_REQUIRED\",\n UPLOAD_ID_REQUIRED: \"UPLOAD_ID_REQUIRED\",\n PART_NUMBER_INVALID: \"PART_NUMBER_INVALID\",\n PARTS_REQUIRED: \"PARTS_REQUIRED\",\n FILE_SIZE_REQUIRED_UPLOAD: \"FILE_SIZE_REQUIRED_UPLOAD\",\n FILE_SIZE_REQUIRED_MULTIPART: \"FILE_SIZE_REQUIRED_MULTIPART\",\n} as const;\n\nexport type S3ErrorCode = (typeof S3_ERROR_CODES)[keyof typeof S3_ERROR_CODES];\n\nexport type DimahS3ErrorParams = Record<string, string | number>;\n\nexport type DimahS3ErrorOptions = {\n cause?: unknown;\n code?: S3ErrorCode | string;\n params?: DimahS3ErrorParams;\n};\n\n/** Typed API / procedure error with HTTP status and optional stable code. */\nexport class DimahS3Error extends Error {\n readonly status: number;\n readonly code?: S3ErrorCode | string;\n readonly params?: DimahS3ErrorParams;\n\n constructor(message: string, status = 400, options?: DimahS3ErrorOptions) {\n super(\n message,\n options?.cause !== undefined ? { cause: options.cause } : undefined,\n );\n this.name = \"DimahS3Error\";\n this.status = status;\n this.code = options?.code;\n this.params = options?.params;\n }\n}\n","/** Default mount path for the catch-all route (`app/api/s3/[...s3]/route.ts`). */\nexport const S3_API_BASE_PATH = \"/api/s3\";\n\nexport function normalizeS3ApiBasePath(basePath: string): string {\n return basePath.replace(/\\/$/, \"\");\n}\n\nexport const S3_API_ROUTES = {\n upload: \"presign/upload\",\n uploadConfirm: \"presign/upload/confirm\",\n download: \"presign/download\",\n delete: \"delete\",\n multipartInit: \"presign/multipart/init\",\n multipartPart: \"presign/multipart/part\",\n multipartComplete: \"presign/multipart/complete\",\n multipartAbort: \"presign/multipart/abort\",\n multipartListParts: \"presign/multipart/parts\",\n} as const;\n","import { DimahS3Error } from \"../error\";\nimport type { S3ClientFetcher, S3ClientFetchOptions } from \"./types\";\n\nfunction buildQuery(\n query?: Record<string, string | number | boolean | undefined>,\n): string {\n if (!query) return \"\";\n const params = new URLSearchParams();\n for (const [key, value] of Object.entries(query)) {\n if (value === undefined) continue;\n params.set(key, String(value));\n }\n const qs = params.toString();\n return qs ? `?${qs}` : \"\";\n}\n\nasync function resolveHeaders(\n headers: S3ClientFetchOptions[\"headers\"],\n): Promise<HeadersInit | undefined> {\n if (headers == null) return undefined;\n if (typeof headers === \"function\") return headers();\n return headers;\n}\n\nfunction mergeHeaders(\n ...parts: (HeadersInit | undefined)[]\n): Record<string, string> {\n const out: Record<string, string> = {};\n for (const part of parts) {\n if (!part) continue;\n const h = new Headers(part);\n h.forEach((value, key) => {\n out[key] = value;\n });\n }\n return out;\n}\n\nfunction jsonBody(body: unknown): RequestInit {\n return {\n headers: { \"Content-Type\": \"application/json\" },\n body: body === undefined ? undefined : JSON.stringify(body),\n };\n}\n\n/**\n * Shared fetch + JSON error parsing for core routes and client plugins.\n * `base` is a normalized API prefix (e.g. `/api/s3`).\n *\n * Non-OK responses throw {@link DimahS3Error} with the HTTP status — same\n * class as server procedures, so client and server error shapes stay aligned.\n */\nexport function createFetcher(\n base: string,\n options?: S3ClientFetchOptions,\n): S3ClientFetcher {\n const fetchImpl = options?.fetch ?? fetch;\n\n const json = async <T>(url: string, init?: RequestInit): Promise<T> => {\n const extraHeaders = await resolveHeaders(options?.headers);\n const res = await fetchImpl(url, {\n ...init,\n credentials: options?.credentials ?? init?.credentials,\n headers: mergeHeaders(extraHeaders, init?.headers),\n });\n if (!res.ok) {\n const body = (await res.json().catch(() => ({}))) as {\n message?: string;\n code?: string;\n params?: Record<string, string | number>;\n };\n throw new DimahS3Error(body.message ?? res.statusText, res.status, {\n code: body.code,\n params: body.params,\n });\n }\n return res.json() as Promise<T>;\n };\n\n return {\n get<T>(\n path: string,\n query?: Record<string, string | number | boolean | undefined>,\n ) {\n return json<T>(`${base}/${path}${buildQuery(query)}`);\n },\n post<T>(path: string, body?: unknown) {\n return json<T>(`${base}/${path}`, {\n method: \"POST\",\n ...jsonBody(body),\n });\n },\n put<T>(path: string, body?: unknown) {\n return json<T>(`${base}/${path}`, {\n method: \"PUT\",\n ...jsonBody(body),\n });\n },\n patch<T>(path: string, body?: unknown) {\n return json<T>(`${base}/${path}`, {\n method: \"PATCH\",\n ...jsonBody(body),\n });\n },\n delete<T>(\n path: string,\n query?: Record<string, string | number | boolean | undefined>,\n ) {\n return json<T>(`${base}/${path}${buildQuery(query)}`, {\n method: \"DELETE\",\n });\n },\n };\n}\n","import type { S3ClientPlugin } from \"./types\";\n\n/**\n * Identity helper that preserves literal `id` and method types for\n * {@link createS3Client} inference (`api[id]`).\n *\n * ```ts\n * export function dbClient() {\n * return defineClientPlugin({\n * id: \"db\",\n * createMethods: (fetcher) => ({\n * listObjects: () => fetcher.get(pluginEndpointPath(\"db\", \"objects\")),\n * }),\n * });\n * }\n * ```\n */\nexport function defineClientPlugin<\n Id extends string,\n TMethods extends Record<string, unknown> = Record<string, unknown>,\n>(plugin: S3ClientPlugin<Id, TMethods>): S3ClientPlugin<Id, TMethods> {\n return plugin;\n}\n","/**\n * Build the relative path for a plugin HTTP endpoint under `basePath`.\n * Server mounts and client fetchers share this so URLs never diverge.\n *\n * @example\n * pluginEndpointPath(\"db\", \"objects\") // \"plugins/db/objects\"\n */\nexport function pluginEndpointPath(pluginId: string, path: string): string {\n return `plugins/${pluginId}/${path.replace(/^\\/+/, \"\")}`;\n}\n","/**\n * Optional fetch configuration for {@link createFetcher} / {@link createS3Client}.\n * Applied to core routes and every client plugin sharing the same fetcher.\n */\nexport type S3ClientFetchOptions = {\n /** Defaults to global `fetch` — override for SSR, tests, or logging. */\n fetch?: typeof fetch;\n /** e.g. `\"include\"` to send cookies cross-origin. */\n credentials?: RequestCredentials;\n /**\n * Static headers or a (possibly async) factory called per request —\n * useful for Authorization tokens.\n */\n headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);\n};\n\n/**\n * Shared HTTP helper used by core `S3Api` methods and client plugins.\n * Built once by {@link createFetcher} / {@link createS3Client}.\n */\nexport type S3ClientFetcher = {\n get<T>(\n path: string,\n query?: Record<string, string | number | boolean | undefined>,\n ): Promise<T>;\n post<T>(path: string, body?: unknown): Promise<T>;\n put<T>(path: string, body?: unknown): Promise<T>;\n patch<T>(path: string, body?: unknown): Promise<T>;\n delete<T>(\n path: string,\n query?: Record<string, string | number | boolean | undefined>,\n ): Promise<T>;\n};\n\n/**\n * Browser / isomorphic client plugin — mirrors server `DimahS3Plugin`\n * (literal `id` + methods flattened onto the `createS3Client` result).\n *\n * @typeParam Id — unique plugin id; becomes `api[id]`.\n * @typeParam TMethods — methods returned by {@link createMethods}.\n */\nexport type S3ClientPlugin<\n Id extends string = string,\n TMethods extends Record<string, unknown> = Record<string, unknown>,\n> = {\n id: Id;\n /** Build typed methods that call plugin endpoints via the shared fetcher. */\n createMethods: (fetcher: S3ClientFetcher) => TMethods;\n};\n\n/** Map client plugin ids → their method bags. */\nexport type ClientPluginMethodsMap<P extends readonly S3ClientPlugin[]> = {\n [K in P[number] as K[\"id\"]]: K extends S3ClientPlugin<string, infer M>\n ? M\n : never;\n};\n\n/** Keys reserved on the `createS3Client` result — client plugins may not use these as ids. */\nexport const RESERVED_CLIENT_KEYS = [\n \"upload\",\n \"confirm\",\n \"download\",\n \"delete\",\n \"multipart\",\n] as const;\n\nexport type ReservedClientKey = (typeof RESERVED_CLIENT_KEYS)[number];\n","import type {\n DeleteResponse,\n MultipartAbortResponse,\n MultipartCompleteResponse,\n MultipartInitResponse,\n MultipartListPartsResponse,\n MultipartPartResponse,\n PresignResponse,\n S3Api,\n UploadConfirmResponse,\n UploadPresignResponse,\n} from \"./types\";\nimport { sanitizeFileName } from \"./helpers/sanitize-file-name\";\nimport {\n createFetcher,\n RESERVED_CLIENT_KEYS,\n type ClientPluginMethodsMap,\n type S3ClientFetchOptions,\n type S3ClientPlugin,\n} from \"./plugin\";\nimport {\n normalizeS3ApiBasePath,\n S3_API_BASE_PATH,\n S3_API_ROUTES,\n} from \"./routes\";\n\n/** Options for {@link createS3Client}. */\nexport type CreateS3ClientOptions<\n P extends readonly S3ClientPlugin[] = readonly S3ClientPlugin[],\n> = {\n /** API path prefix — must match server `basePath`. @default \"/api/s3\" */\n basePath?: string;\n /** Client plugins (e.g. `dbClient()` from `@dimah-s3/db/client`). */\n plugins?: P;\n} & S3ClientFetchOptions;\n\n/** Strip server-only `headers` before sending over HTTP. */\nfunction withoutHeaders<T extends { headers?: HeadersInit }>(\n value: T,\n): Omit<T, \"headers\"> {\n const { headers: _headers, ...rest } = value;\n return rest;\n}\n\n/**\n * Browser (or isomorphic) client for the dimah-s3 HTTP API.\n *\n * For React apps prefer `createS3Client` from `@dimah-s3/react` — same options,\n * plus a bound `S3Provider` / typed `useApi`.\n *\n * ```ts\n * import { createS3Client } from \"@dimah-s3/core\";\n * import { dbClient } from \"@dimah-s3/db/client\";\n *\n * export const api = createS3Client({\n * basePath: \"/api/s3\",\n * plugins: [dbClient()],\n * });\n *\n * await api.db.listObjects();\n * ```\n */\nexport function createS3Client<const P extends readonly S3ClientPlugin[] = []>(\n options?: CreateS3ClientOptions<P>,\n): S3Api & ClientPluginMethodsMap<P> {\n const { basePath, plugins, ...fetchOptions } = options ?? {};\n const base = normalizeS3ApiBasePath(basePath ?? S3_API_BASE_PATH);\n const fetcher = createFetcher(base, fetchOptions);\n\n const api: S3Api = {\n upload(payload) {\n return fetcher.post<UploadPresignResponse>(\n S3_API_ROUTES.upload,\n withoutHeaders(payload),\n );\n },\n\n confirm(payload) {\n return fetcher.post<UploadConfirmResponse>(\n S3_API_ROUTES.uploadConfirm,\n withoutHeaders(payload),\n );\n },\n\n download(key, options?) {\n const { fileName, bucket } = options ?? {};\n return fetcher.get<PresignResponse>(S3_API_ROUTES.download, {\n key,\n fileName: fileName ? sanitizeFileName(fileName) : undefined,\n bucket,\n });\n },\n\n delete(key, options?) {\n const { bucket } = options ?? {};\n return fetcher.delete<DeleteResponse>(S3_API_ROUTES.delete, {\n key,\n bucket,\n });\n },\n\n multipart: {\n init(payload) {\n return fetcher.post<MultipartInitResponse>(\n S3_API_ROUTES.multipartInit,\n withoutHeaders(payload),\n );\n },\n\n signPart(payload) {\n return fetcher.post<MultipartPartResponse>(\n S3_API_ROUTES.multipartPart,\n withoutHeaders(payload),\n );\n },\n\n listParts(payload) {\n const { key, uploadId, bucket } = withoutHeaders(payload);\n return fetcher.get<MultipartListPartsResponse>(\n S3_API_ROUTES.multipartListParts,\n { key, uploadId, bucket },\n );\n },\n\n complete(payload) {\n return fetcher.post<MultipartCompleteResponse>(\n S3_API_ROUTES.multipartComplete,\n withoutHeaders(payload),\n );\n },\n\n abort(payload) {\n return fetcher.post<MultipartAbortResponse>(\n S3_API_ROUTES.multipartAbort,\n withoutHeaders(payload),\n );\n },\n },\n };\n\n const pluginMethods: Record<string, unknown> = {};\n for (const plugin of plugins ?? []) {\n if ((RESERVED_CLIENT_KEYS as readonly string[]).includes(plugin.id)) {\n throw new Error(\n `Client plugin id \"${plugin.id}\" is reserved on the S3 client.`,\n );\n }\n if (plugin.id in pluginMethods) {\n throw new Error(`Duplicate client plugin id \"${plugin.id}\".`);\n }\n pluginMethods[plugin.id] = plugin.createMethods(fetcher);\n }\n\n return { ...api, ...pluginMethods } as S3Api & ClientPluginMethodsMap<P>;\n}\n"]}
1
+ {"version":3,"sources":["../src/helpers/validate-file.ts","../src/helpers/build-object-key.ts","../src/helpers/get-file-extension.ts","../src/helpers/parse-file-name.ts","../src/helpers/format-file-size.ts","../src/helpers/build-content-disposition.ts","../src/helpers/sanitize-file-name.ts","../src/helpers/truncate-file-name.ts","../src/error.ts","../src/routes.ts","../src/plugin/create-fetcher.ts","../src/plugin/define-client-plugin.ts","../src/plugin/plugin-endpoint-path.ts","../src/plugin/types.ts","../src/create-s3-client.ts"],"names":["options"],"mappings":"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","file":"index.js","sourcesContent":["/** Machine-readable codes for client-side file validation failures. */\nexport type ValidateFileErrorCode =\n \"FILE_TYPE_NOT_ALLOWED\" | \"FILE_EMPTY\" | \"FILE_TOO_LARGE\";\n\n/** Result of {@link validateFile} when the file fails a check. */\nexport type ValidateFileError = {\n code: ValidateFileErrorCode;\n /** English fallback message (localize via Fuma when a translator is available). */\n message: string;\n /** Interpolation params for i18n (e.g. `{ type }`, `{ size }`). */\n params?: Record<string, string | number>;\n};\n\n/**\n * Client-side accept / size / empty checks before starting an upload.\n * Returns `null` when the file is valid.\n */\nexport function validateFile(\n file: File,\n options: { accept?: string[]; maxFileSize?: number },\n): ValidateFileError | null {\n if (options.accept?.length) {\n const allowed = options.accept.some((type) => {\n if (type.startsWith(\".\")) {\n return file.name.toLowerCase().endsWith(type.toLowerCase());\n }\n if (type.endsWith(\"/*\")) {\n return file.type.startsWith(type.replace(\"/*\", \"/\"));\n }\n return file.type === type;\n });\n if (!allowed) {\n const ext = file.name.includes(\".\") ? file.name.split(\".\").pop() : null;\n const type = ext ? `.${ext}` : file.type || \"unknown\";\n return {\n code: \"FILE_TYPE_NOT_ALLOWED\",\n message: `File type \"${type}\" is not allowed`,\n params: { type },\n };\n }\n }\n\n if (file.size === 0) {\n return {\n code: \"FILE_EMPTY\",\n message: \"File is empty\",\n };\n }\n\n if (options.maxFileSize && file.size > options.maxFileSize) {\n const maxMB = (options.maxFileSize / (1024 * 1024)).toFixed(1);\n return {\n code: \"FILE_TOO_LARGE\",\n message: `File size exceeds ${maxMB} MB limit`,\n params: { size: `${maxMB} MB` },\n };\n }\n\n return null;\n}\n","export function buildObjectKey(...parts: string[]): string {\n return parts\n .map((p) => p.replace(/^\\/+|\\/+$/g, \"\"))\n .filter(Boolean)\n .join(\"/\");\n}\n","export function getFileExtension(fileName: string): string {\n const dotIndex = fileName.lastIndexOf(\".\");\n if (dotIndex < 1) return \"\";\n return fileName.slice(dotIndex + 1).toLowerCase();\n}\n","export function parseFileName(\n contentDisposition: string | null | undefined,\n): string | undefined {\n if (!contentDisposition) return undefined;\n\n const utf8Match = contentDisposition.match(/filename\\*=UTF-8''([^;,\\s]+)/i);\n if (utf8Match) {\n try {\n return decodeURIComponent(utf8Match[1]);\n } catch {\n /* ignore malformed encoding */\n }\n }\n\n const asciiMatch = contentDisposition.match(/filename=\"([^\"]*)\"/i);\n return asciiMatch?.[1];\n}\n","export function formatFileSize(bytes: number): string {\n if (bytes === 0) return \"0 B\";\n const units = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\"];\n const i = Math.floor(Math.log(bytes) / Math.log(1024));\n const size = bytes / Math.pow(1024, i);\n return `${size.toFixed(i === 0 ? 0 : 1)} ${units[i]}`;\n}\n","/**\n * Builds a RFC 6266 `Content-Disposition` value for a file attachment.\n *\n * Includes both the ASCII-safe `filename` fallback and the RFC 5987\n * `filename*` parameter for full Unicode support.\n */\nexport function buildContentDisposition(fileName: string): string {\n const ascii = fileName.replace(/[^\\x20-\\x7E]/g, \"_\").replace(/[\"\\\\]/g, \"_\");\n const encoded = encodeURIComponent(fileName);\n return `attachment; filename=\"${ascii}\"; filename*=UTF-8''${encoded}`;\n}\n","/** Sanitizes a file name for safe use in URL query parameters. */\nexport function sanitizeFileName(fileName: string): string {\n return fileName.replace(/[\"\\\\\\r\\n]/g, \"_\");\n}\n","/**\n * Truncates a filename while preserving the extension when possible.\n */\nexport function truncateFileName(name: string, maxChars = 48): string {\n if (name.length <= maxChars) return name;\n const dotIndex = name.lastIndexOf(\".\");\n if (dotIndex <= 0) {\n return name.slice(0, maxChars - 1) + \"…\";\n }\n const ext = name.slice(dotIndex);\n const available = maxChars - ext.length - 1;\n if (available <= 0) {\n return name.slice(0, maxChars - 1) + \"…\";\n }\n return name.slice(0, available) + \"… \" + ext;\n}\n\n/** @deprecated Use {@link truncateFileName}. */\nexport const truncateFilename = truncateFileName;\n","/** Stable API error codes returned in JSON `{ code, message, params? }`. */\nexport const S3_ERROR_CODES = {\n NOT_FOUND: \"NOT_FOUND\",\n INVALID_JSON: \"INVALID_JSON\",\n FORBIDDEN: \"FORBIDDEN\",\n INTERNAL_ERROR: \"INTERNAL_ERROR\",\n OBJECT_NOT_FOUND: \"OBJECT_NOT_FOUND\",\n S3_NETWORK_ERROR: \"S3_NETWORK_ERROR\",\n FIELD_REQUIRED: \"FIELD_REQUIRED\",\n KEY_REQUIRED: \"KEY_REQUIRED\",\n UPLOAD_ID_REQUIRED: \"UPLOAD_ID_REQUIRED\",\n PART_NUMBER_INVALID: \"PART_NUMBER_INVALID\",\n PARTS_REQUIRED: \"PARTS_REQUIRED\",\n FILE_SIZE_REQUIRED_UPLOAD: \"FILE_SIZE_REQUIRED_UPLOAD\",\n FILE_SIZE_REQUIRED_MULTIPART: \"FILE_SIZE_REQUIRED_MULTIPART\",\n} as const;\n\nexport type S3ErrorCode = (typeof S3_ERROR_CODES)[keyof typeof S3_ERROR_CODES];\n\nexport type DimahS3ErrorParams = Record<string, string | number>;\n\nexport type DimahS3ErrorOptions = {\n cause?: unknown;\n code?: S3ErrorCode | string;\n params?: DimahS3ErrorParams;\n};\n\n/** Typed API / procedure error with HTTP status and optional stable code. */\nexport class DimahS3Error extends Error {\n readonly status: number;\n readonly code?: S3ErrorCode | string;\n readonly params?: DimahS3ErrorParams;\n\n constructor(message: string, status = 400, options?: DimahS3ErrorOptions) {\n super(\n message,\n options?.cause !== undefined ? { cause: options.cause } : undefined,\n );\n this.name = \"DimahS3Error\";\n this.status = status;\n this.code = options?.code;\n this.params = options?.params;\n }\n}\n","/** Default mount path for the catch-all route (`app/api/s3/[...s3]/route.ts`). */\nexport const S3_API_BASE_PATH = \"/api/s3\";\n\nexport function normalizeS3ApiBasePath(basePath: string): string {\n return basePath.replace(/\\/$/, \"\");\n}\n\nexport const S3_API_ROUTES = {\n upload: \"presign/upload\",\n uploadConfirm: \"presign/upload/confirm\",\n download: \"presign/download\",\n delete: \"delete\",\n multipartInit: \"presign/multipart/init\",\n multipartPart: \"presign/multipart/part\",\n multipartComplete: \"presign/multipart/complete\",\n multipartAbort: \"presign/multipart/abort\",\n multipartListParts: \"presign/multipart/parts\",\n} as const;\n","import { DimahS3Error } from \"../error\";\nimport type { S3ClientFetcher, S3ClientFetchOptions } from \"./types\";\n\nfunction buildQuery(\n query?: Record<string, string | number | boolean | undefined>,\n): string {\n if (!query) return \"\";\n const params = new URLSearchParams();\n for (const [key, value] of Object.entries(query)) {\n if (value === undefined) continue;\n params.set(key, String(value));\n }\n const qs = params.toString();\n return qs ? `?${qs}` : \"\";\n}\n\nasync function resolveHeaders(\n headers: S3ClientFetchOptions[\"headers\"],\n): Promise<HeadersInit | undefined> {\n if (headers == null) return undefined;\n if (typeof headers === \"function\") return headers();\n return headers;\n}\n\nfunction mergeHeaders(\n ...parts: (HeadersInit | undefined)[]\n): Record<string, string> {\n const out: Record<string, string> = {};\n for (const part of parts) {\n if (!part) continue;\n const h = new Headers(part);\n h.forEach((value, key) => {\n out[key] = value;\n });\n }\n return out;\n}\n\nfunction jsonBody(body: unknown): RequestInit {\n return {\n headers: { \"Content-Type\": \"application/json\" },\n body: body === undefined ? undefined : JSON.stringify(body),\n };\n}\n\n/**\n * Shared fetch + JSON error parsing for core routes and client plugins.\n * `base` is a normalized API prefix (e.g. `/api/s3`).\n *\n * Non-OK responses throw {@link DimahS3Error} with the HTTP status — same\n * class as server procedures, so client and server error shapes stay aligned.\n */\nexport function createFetcher(\n base: string,\n options?: S3ClientFetchOptions,\n): S3ClientFetcher {\n const fetchImpl = options?.fetch ?? fetch;\n\n const json = async <T>(url: string, init?: RequestInit): Promise<T> => {\n const extraHeaders = await resolveHeaders(options?.headers);\n const res = await fetchImpl(url, {\n ...init,\n credentials: options?.credentials ?? init?.credentials,\n headers: mergeHeaders(extraHeaders, init?.headers),\n });\n if (!res.ok) {\n const body = (await res.json().catch(() => ({}))) as {\n message?: string;\n code?: string;\n params?: Record<string, string | number>;\n };\n throw new DimahS3Error(body.message ?? res.statusText, res.status, {\n code: body.code,\n params: body.params,\n });\n }\n return res.json() as Promise<T>;\n };\n\n return {\n get<T>(\n path: string,\n query?: Record<string, string | number | boolean | undefined>,\n ) {\n return json<T>(`${base}/${path}${buildQuery(query)}`);\n },\n post<T>(path: string, body?: unknown) {\n return json<T>(`${base}/${path}`, {\n method: \"POST\",\n ...jsonBody(body),\n });\n },\n put<T>(path: string, body?: unknown) {\n return json<T>(`${base}/${path}`, {\n method: \"PUT\",\n ...jsonBody(body),\n });\n },\n patch<T>(path: string, body?: unknown) {\n return json<T>(`${base}/${path}`, {\n method: \"PATCH\",\n ...jsonBody(body),\n });\n },\n delete<T>(\n path: string,\n query?: Record<string, string | number | boolean | undefined>,\n ) {\n return json<T>(`${base}/${path}${buildQuery(query)}`, {\n method: \"DELETE\",\n });\n },\n };\n}\n","import type { S3ClientPlugin } from \"./types\";\n\n/**\n * Identity helper that preserves literal `id` and method types for\n * {@link createS3Client} inference (`api[id]`).\n *\n * ```ts\n * export function dbClient() {\n * return defineClientPlugin({\n * id: \"db\",\n * createMethods: (fetcher) => ({\n * listObjects: () => fetcher.get(pluginEndpointPath(\"db\", \"objects\")),\n * }),\n * });\n * }\n * ```\n */\nexport function defineClientPlugin<\n Id extends string,\n TMethods extends Record<string, unknown> = Record<string, unknown>,\n>(plugin: S3ClientPlugin<Id, TMethods>): S3ClientPlugin<Id, TMethods> {\n return plugin;\n}\n","/**\n * Build the relative path for a plugin HTTP endpoint under `basePath`.\n * Server mounts and client fetchers share this so URLs never diverge.\n *\n * @example\n * pluginEndpointPath(\"db\", \"objects\") // \"plugins/db/objects\"\n */\nexport function pluginEndpointPath(pluginId: string, path: string): string {\n return `plugins/${pluginId}/${path.replace(/^\\/+/, \"\")}`;\n}\n","/**\n * Optional fetch configuration for {@link createFetcher} / {@link createS3Client}.\n * Applied to core routes and every client plugin sharing the same fetcher.\n */\nexport type S3ClientFetchOptions = {\n /** Defaults to global `fetch` — override for SSR, tests, or logging. */\n fetch?: typeof fetch;\n /** e.g. `\"include\"` to send cookies cross-origin. */\n credentials?: RequestCredentials;\n /**\n * Static headers or a (possibly async) factory called per request —\n * useful for Authorization tokens.\n */\n headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);\n};\n\n/**\n * Shared HTTP helper used by core `S3Api` methods and client plugins.\n * Built once by {@link createFetcher} / {@link createS3Client}.\n */\nexport type S3ClientFetcher = {\n get<T>(\n path: string,\n query?: Record<string, string | number | boolean | undefined>,\n ): Promise<T>;\n post<T>(path: string, body?: unknown): Promise<T>;\n put<T>(path: string, body?: unknown): Promise<T>;\n patch<T>(path: string, body?: unknown): Promise<T>;\n delete<T>(\n path: string,\n query?: Record<string, string | number | boolean | undefined>,\n ): Promise<T>;\n};\n\n/**\n * Browser / isomorphic client plugin — mirrors server `DimahS3Plugin`\n * (literal `id` + methods flattened onto the `createS3Client` result).\n *\n * @typeParam Id — unique plugin id; becomes `api[id]`.\n * @typeParam TMethods — methods returned by {@link createMethods}.\n */\nexport type S3ClientPlugin<\n Id extends string = string,\n TMethods extends Record<string, unknown> = Record<string, unknown>,\n> = {\n id: Id;\n /** Build typed methods that call plugin endpoints via the shared fetcher. */\n createMethods: (fetcher: S3ClientFetcher) => TMethods;\n};\n\n/** Map client plugin ids → their method bags. */\nexport type ClientPluginMethodsMap<P extends readonly S3ClientPlugin[]> = {\n [K in P[number] as K[\"id\"]]: K extends S3ClientPlugin<string, infer M>\n ? M\n : never;\n};\n\n/** Keys reserved on the `createS3Client` result — client plugins may not use these as ids. */\nexport const RESERVED_CLIENT_KEYS = [\n \"upload\",\n \"confirm\",\n \"download\",\n \"delete\",\n \"multipart\",\n] as const;\n\nexport type ReservedClientKey = (typeof RESERVED_CLIENT_KEYS)[number];\n","import type {\n DeleteResponse,\n MultipartAbortResponse,\n MultipartCompleteResponse,\n MultipartInitResponse,\n MultipartListPartsResponse,\n MultipartPartResponse,\n PresignResponse,\n S3Api,\n UploadConfirmResponse,\n UploadPresignResponse,\n} from \"./types\";\nimport { sanitizeFileName } from \"./helpers/sanitize-file-name\";\nimport {\n createFetcher,\n RESERVED_CLIENT_KEYS,\n type ClientPluginMethodsMap,\n type S3ClientFetchOptions,\n type S3ClientPlugin,\n} from \"./plugin\";\nimport {\n normalizeS3ApiBasePath,\n S3_API_BASE_PATH,\n S3_API_ROUTES,\n} from \"./routes\";\n\n/** Options for {@link createS3Client}. */\nexport type CreateS3ClientOptions<\n P extends readonly S3ClientPlugin[] = readonly S3ClientPlugin[],\n> = {\n /** API path prefix — must match server `basePath`. @default \"/api/s3\" */\n basePath?: string;\n /** Client plugins (e.g. `dbClient()` from `@dimah-s3/db/client`). */\n plugins?: P;\n} & S3ClientFetchOptions;\n\n/** Strip server-only `headers` before sending over HTTP. */\nfunction withoutHeaders<T extends { headers?: HeadersInit }>(\n value: T,\n): Omit<T, \"headers\"> {\n const { headers: _headers, ...rest } = value;\n return rest;\n}\n\n/**\n * Browser (or isomorphic) client for the dimah-s3 HTTP API.\n *\n * For React apps prefer `createS3Client` from `@dimah-s3/react` — same options,\n * plus a bound `S3Provider` / typed `useApi`.\n *\n * ```ts\n * import { createS3Client } from \"@dimah-s3/core\";\n * import { dbClient } from \"@dimah-s3/db/client\";\n *\n * export const api = createS3Client({\n * basePath: \"/api/s3\",\n * plugins: [dbClient()],\n * });\n *\n * await api.db.listObjects();\n * ```\n */\nexport function createS3Client<const P extends readonly S3ClientPlugin[] = []>(\n options?: CreateS3ClientOptions<P>,\n): S3Api & ClientPluginMethodsMap<P> {\n const { basePath, plugins, ...fetchOptions } = options ?? {};\n const base = normalizeS3ApiBasePath(basePath ?? S3_API_BASE_PATH);\n const fetcher = createFetcher(base, fetchOptions);\n\n const api: S3Api = {\n upload(payload) {\n return fetcher.post<UploadPresignResponse>(\n S3_API_ROUTES.upload,\n withoutHeaders(payload),\n );\n },\n\n confirm(payload) {\n return fetcher.post<UploadConfirmResponse>(\n S3_API_ROUTES.uploadConfirm,\n withoutHeaders(payload),\n );\n },\n\n download(key, options?) {\n const { fileName, bucket } = options ?? {};\n return fetcher.get<PresignResponse>(S3_API_ROUTES.download, {\n key,\n fileName: fileName ? sanitizeFileName(fileName) : undefined,\n bucket,\n });\n },\n\n delete(key, options?) {\n const { bucket } = options ?? {};\n return fetcher.delete<DeleteResponse>(S3_API_ROUTES.delete, {\n key,\n bucket,\n });\n },\n\n multipart: {\n init(payload) {\n return fetcher.post<MultipartInitResponse>(\n S3_API_ROUTES.multipartInit,\n withoutHeaders(payload),\n );\n },\n\n signPart(payload) {\n return fetcher.post<MultipartPartResponse>(\n S3_API_ROUTES.multipartPart,\n withoutHeaders(payload),\n );\n },\n\n listParts(payload) {\n const { key, uploadId, bucket } = withoutHeaders(payload);\n return fetcher.get<MultipartListPartsResponse>(\n S3_API_ROUTES.multipartListParts,\n { key, uploadId, bucket },\n );\n },\n\n complete(payload) {\n return fetcher.post<MultipartCompleteResponse>(\n S3_API_ROUTES.multipartComplete,\n withoutHeaders(payload),\n );\n },\n\n abort(payload) {\n return fetcher.post<MultipartAbortResponse>(\n S3_API_ROUTES.multipartAbort,\n withoutHeaders(payload),\n );\n },\n },\n };\n\n const pluginMethods: Record<string, unknown> = {};\n for (const plugin of plugins ?? []) {\n if ((RESERVED_CLIENT_KEYS as readonly string[]).includes(plugin.id)) {\n throw new Error(\n `Client plugin id \"${plugin.id}\" is reserved on the S3 client.`,\n );\n }\n if (plugin.id in pluginMethods) {\n throw new Error(`Duplicate client plugin id \"${plugin.id}\".`);\n }\n pluginMethods[plugin.id] = plugin.createMethods(fetcher);\n }\n\n return { ...api, ...pluginMethods } as S3Api & ClientPluginMethodsMap<P>;\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dimah-s3/core",
3
- "version": "0.6.3",
3
+ "version": "0.7.0",
4
4
  "description": "Shared types and pure helpers for @dimah-s3/react and @dimah-s3/server",
5
5
  "keywords": [
6
6
  "s3",
@@ -31,7 +31,7 @@
31
31
  "dist"
32
32
  ],
33
33
  "devDependencies": {
34
- "eslint": "^10.8.0",
34
+ "eslint": "^10.8.1",
35
35
  "tsup": "^8.5.1",
36
36
  "typescript": "7.0.2",
37
37
  "vitest": "^4.1.10",