@dimah-s3/core 1.7.1 → 2.0.0-beta.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 (74) hide show
  1. package/README.md +32 -13
  2. package/dist/create-s3-client.d.ts +3 -0
  3. package/dist/create-s3-client.d.ts.map +1 -1
  4. package/dist/error-codes.d.ts +297 -29
  5. package/dist/error-codes.d.ts.map +1 -1
  6. package/dist/error.d.ts +46 -14
  7. package/dist/error.d.ts.map +1 -1
  8. package/dist/helpers/base64url.d.ts +18 -0
  9. package/dist/helpers/base64url.d.ts.map +1 -0
  10. package/dist/helpers/build-content-disposition.d.ts +4 -4
  11. package/dist/helpers/build-content-disposition.d.ts.map +1 -1
  12. package/dist/helpers/checksum.d.ts +8 -2
  13. package/dist/helpers/checksum.d.ts.map +1 -1
  14. package/dist/helpers/content-type.d.ts +17 -0
  15. package/dist/helpers/content-type.d.ts.map +1 -0
  16. package/dist/helpers/fit-file-name.d.ts +15 -0
  17. package/dist/helpers/fit-file-name.d.ts.map +1 -0
  18. package/dist/helpers/index.d.ts +7 -9
  19. package/dist/helpers/index.d.ts.map +1 -1
  20. package/dist/helpers/magic-bytes.d.ts +9 -2
  21. package/dist/helpers/magic-bytes.d.ts.map +1 -1
  22. package/dist/helpers/normalize-object-key.d.ts +8 -3
  23. package/dist/helpers/normalize-object-key.d.ts.map +1 -1
  24. package/dist/helpers/parse-file-name.d.ts +5 -0
  25. package/dist/helpers/parse-file-name.d.ts.map +1 -1
  26. package/dist/helpers/resolve-inline-disposition.d.ts +16 -6
  27. package/dist/helpers/resolve-inline-disposition.d.ts.map +1 -1
  28. package/dist/helpers/validate-file.d.ts +13 -16
  29. package/dist/helpers/validate-file.d.ts.map +1 -1
  30. package/dist/index.d.ts +2 -2
  31. package/dist/index.d.ts.map +1 -1
  32. package/dist/index.js +711 -478
  33. package/dist/index.js.map +1 -1
  34. package/dist/limits.d.ts +30 -0
  35. package/dist/limits.d.ts.map +1 -0
  36. package/dist/plugin/create-s3-fetch.d.ts +5 -3
  37. package/dist/plugin/create-s3-fetch.d.ts.map +1 -1
  38. package/dist/plugin/types.d.ts +13 -4
  39. package/dist/plugin/types.d.ts.map +1 -1
  40. package/dist/routes.d.ts +10 -4
  41. package/dist/routes.d.ts.map +1 -1
  42. package/dist/schema/catalog.d.ts +30 -39
  43. package/dist/schema/catalog.d.ts.map +1 -1
  44. package/dist/schema/delete.d.ts +1 -2
  45. package/dist/schema/delete.d.ts.map +1 -1
  46. package/dist/schema/download.d.ts +16 -3
  47. package/dist/schema/download.d.ts.map +1 -1
  48. package/dist/schema/index.d.ts +5 -9
  49. package/dist/schema/index.d.ts.map +1 -1
  50. package/dist/schema/index.js +221 -0
  51. package/dist/schema/index.js.map +1 -0
  52. package/dist/schema/multipart.d.ts +6 -29
  53. package/dist/schema/multipart.d.ts.map +1 -1
  54. package/dist/schema/shared.d.ts +25 -17
  55. package/dist/schema/shared.d.ts.map +1 -1
  56. package/dist/schema/upload.d.ts +10 -7
  57. package/dist/schema/upload.d.ts.map +1 -1
  58. package/dist/types/index.d.ts +2 -2
  59. package/dist/types/index.d.ts.map +1 -1
  60. package/dist/types/requests.d.ts +25 -31
  61. package/dist/types/requests.d.ts.map +1 -1
  62. package/dist/types/responses.d.ts +96 -83
  63. package/dist/types/responses.d.ts.map +1 -1
  64. package/package.json +9 -4
  65. package/dist/helpers/format-file-size.d.ts +0 -18
  66. package/dist/helpers/format-file-size.d.ts.map +0 -1
  67. package/dist/helpers/sanitize-file-name.d.ts +0 -3
  68. package/dist/helpers/sanitize-file-name.d.ts.map +0 -1
  69. package/dist/helpers/truncate-file-name.d.ts +0 -5
  70. package/dist/helpers/truncate-file-name.d.ts.map +0 -1
  71. package/dist/schema/error.d.ts +0 -14
  72. package/dist/schema/error.d.ts.map +0 -1
  73. package/dist/schema/file.d.ts +0 -12
  74. package/dist/schema/file.d.ts.map +0 -1
@@ -13,62 +13,56 @@ export declare const routeCatalogUploadSchema: z.ZodDiscriminatedUnion<[z.ZodObj
13
13
  fileTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
14
14
  maxFileSize: z.ZodOptional<z.ZodInt>;
15
15
  multipart: z.ZodBoolean;
16
- checksum: z.ZodOptional<z.ZodBoolean>;
17
- replace: z.ZodOptional<z.ZodLiteral<"overwrite">>;
16
+ checksum: z.ZodBoolean;
18
17
  }, z.core.$strict>, z.ZodObject<{
19
18
  enabled: z.ZodLiteral<false>;
20
19
  }, z.core.$strict>], "enabled">;
21
20
  export declare const routeCatalogDownloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
22
21
  enabled: z.ZodLiteral<true>;
23
- expiresIn: z.ZodOptional<z.ZodInt>;
24
- disposition: z.ZodOptional<z.ZodEnum<{
22
+ maxExpiresIn: z.ZodInt;
23
+ disposition: z.ZodEnum<{
25
24
  attachment: "attachment";
26
25
  inline: "inline";
27
- }>>;
28
- inlineTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
29
- mode: z.ZodOptional<z.ZodEnum<{
26
+ }>;
27
+ inlineTypes: z.ZodArray<z.ZodString>;
28
+ mode: z.ZodEnum<{
30
29
  presign: "presign";
31
30
  proxy: "proxy";
32
- }>>;
33
- }, z.core.$strict>, z.ZodObject<{
34
- enabled: z.ZodLiteral<false>;
35
- }, z.core.$strict>], "enabled">;
36
- export declare const routeCatalogDeleteSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
37
- enabled: z.ZodLiteral<true>;
31
+ }>;
38
32
  }, z.core.$strict>, z.ZodObject<{
39
33
  enabled: z.ZodLiteral<false>;
40
34
  }, z.core.$strict>], "enabled">;
35
+ export declare const routeCatalogDeleteSchema: z.ZodObject<{
36
+ enabled: z.ZodBoolean;
37
+ }, z.core.$strict>;
41
38
  export declare const routeCatalogEntrySchema: z.ZodObject<{
42
39
  upload: z.ZodDiscriminatedUnion<[z.ZodObject<{
43
40
  enabled: z.ZodLiteral<true>;
44
41
  fileTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
45
42
  maxFileSize: z.ZodOptional<z.ZodInt>;
46
43
  multipart: z.ZodBoolean;
47
- checksum: z.ZodOptional<z.ZodBoolean>;
48
- replace: z.ZodOptional<z.ZodLiteral<"overwrite">>;
44
+ checksum: z.ZodBoolean;
49
45
  }, z.core.$strict>, z.ZodObject<{
50
46
  enabled: z.ZodLiteral<false>;
51
47
  }, z.core.$strict>], "enabled">;
52
48
  download: z.ZodDiscriminatedUnion<[z.ZodObject<{
53
49
  enabled: z.ZodLiteral<true>;
54
- expiresIn: z.ZodOptional<z.ZodInt>;
55
- disposition: z.ZodOptional<z.ZodEnum<{
50
+ maxExpiresIn: z.ZodInt;
51
+ disposition: z.ZodEnum<{
56
52
  attachment: "attachment";
57
53
  inline: "inline";
58
- }>>;
59
- inlineTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
60
- mode: z.ZodOptional<z.ZodEnum<{
54
+ }>;
55
+ inlineTypes: z.ZodArray<z.ZodString>;
56
+ mode: z.ZodEnum<{
61
57
  presign: "presign";
62
58
  proxy: "proxy";
63
- }>>;
64
- }, z.core.$strict>, z.ZodObject<{
65
- enabled: z.ZodLiteral<false>;
66
- }, z.core.$strict>], "enabled">;
67
- delete: z.ZodDiscriminatedUnion<[z.ZodObject<{
68
- enabled: z.ZodLiteral<true>;
59
+ }>;
69
60
  }, z.core.$strict>, z.ZodObject<{
70
61
  enabled: z.ZodLiteral<false>;
71
62
  }, z.core.$strict>], "enabled">;
63
+ delete: z.ZodObject<{
64
+ enabled: z.ZodBoolean;
65
+ }, z.core.$strict>;
72
66
  }, z.core.$strict>;
73
67
  export declare const routeCatalogResponseSchema: z.ZodObject<{
74
68
  routes: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -77,31 +71,28 @@ export declare const routeCatalogResponseSchema: z.ZodObject<{
77
71
  fileTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
78
72
  maxFileSize: z.ZodOptional<z.ZodInt>;
79
73
  multipart: z.ZodBoolean;
80
- checksum: z.ZodOptional<z.ZodBoolean>;
81
- replace: z.ZodOptional<z.ZodLiteral<"overwrite">>;
74
+ checksum: z.ZodBoolean;
82
75
  }, z.core.$strict>, z.ZodObject<{
83
76
  enabled: z.ZodLiteral<false>;
84
77
  }, z.core.$strict>], "enabled">;
85
78
  download: z.ZodDiscriminatedUnion<[z.ZodObject<{
86
79
  enabled: z.ZodLiteral<true>;
87
- expiresIn: z.ZodOptional<z.ZodInt>;
88
- disposition: z.ZodOptional<z.ZodEnum<{
80
+ maxExpiresIn: z.ZodInt;
81
+ disposition: z.ZodEnum<{
89
82
  attachment: "attachment";
90
83
  inline: "inline";
91
- }>>;
92
- inlineTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
93
- mode: z.ZodOptional<z.ZodEnum<{
84
+ }>;
85
+ inlineTypes: z.ZodArray<z.ZodString>;
86
+ mode: z.ZodEnum<{
94
87
  presign: "presign";
95
88
  proxy: "proxy";
96
- }>>;
97
- }, z.core.$strict>, z.ZodObject<{
98
- enabled: z.ZodLiteral<false>;
99
- }, z.core.$strict>], "enabled">;
100
- delete: z.ZodDiscriminatedUnion<[z.ZodObject<{
101
- enabled: z.ZodLiteral<true>;
89
+ }>;
102
90
  }, z.core.$strict>, z.ZodObject<{
103
91
  enabled: z.ZodLiteral<false>;
104
92
  }, z.core.$strict>], "enabled">;
93
+ delete: z.ZodObject<{
94
+ enabled: z.ZodBoolean;
95
+ }, z.core.$strict>;
105
96
  }, z.core.$strict>>;
106
97
  }, z.core.$strict>;
107
98
  export type RouteCatalogEntry = z.output<typeof routeCatalogEntrySchema>;
@@ -1 +1 @@
1
- {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/schema/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,eAAO,MAAM,yBAAyB;;;EAAmC,CAAC;AAC1E,eAAO,MAAM,kBAAkB;;;EAA+B,CAAC;AAE/D,eAAO,MAAM,wBAAwB;;;;;;;;;+BAUnC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;+BAcrC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;+BAGnC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAIlC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAErC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACzE,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;CAChD,CAAC"}
1
+ {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/schema/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAIlD,eAAO,MAAM,yBAAyB;;;EAAmC,CAAC;AAC1E,eAAO,MAAM,kBAAkB;;;EAA+B,CAAC;AAE/D,eAAO,MAAM,wBAAwB;;;;;;;;+BAWnC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;+BAWrC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;kBAEnC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAIlC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAErC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACzE,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;CAChD,CAAC"}
@@ -1,10 +1,9 @@
1
1
  import * as z from "zod";
2
- export declare const DELETE_BATCH_MAX_KEYS = 100;
3
2
  export declare const deleteQuerySchema: z.ZodObject<{
4
3
  route: z.ZodString;
5
4
  key: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
6
5
  }, z.core.$strict>;
7
- export declare const deleteBatchBodySchema: z.ZodObject<{
6
+ export declare const deleteManyBodySchema: z.ZodObject<{
8
7
  route: z.ZodString;
9
8
  keys: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
10
9
  }, z.core.$strict>;
@@ -1 +1 @@
1
- {"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/schema/delete.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,eAAO,MAAM,iBAAiB;;;kBAG5B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;kBAGhC,CAAC"}
1
+ {"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/schema/delete.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,eAAO,MAAM,iBAAiB;;;kBAG5B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;kBAG/B,CAAC"}
@@ -3,11 +3,24 @@ import * as z from "zod";
3
3
  export declare const downloadQuerySchema: z.ZodObject<{
4
4
  route: z.ZodString;
5
5
  key: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
6
- fileName: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
7
- disposition: z.ZodOptional<z.ZodEnum<{
6
+ name: z.ZodPipe<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, z.ZodOptional<z.ZodString>>;
7
+ disposition: z.ZodPreprocess<z.ZodOptional<z.ZodEnum<{
8
8
  attachment: "attachment";
9
9
  inline: "inline";
10
- }>>;
10
+ }>>, unknown>;
11
11
  expiresIn: z.ZodPreprocess<z.ZodOptional<z.ZodInt>, unknown>;
12
12
  }, z.core.$strict>;
13
+ /**
14
+ * Query for the same-origin proxy download (`GET /file`): the download
15
+ * query without `expiresIn`, since a proxy URL does not expire.
16
+ */
17
+ export declare const fileQuerySchema: z.ZodObject<{
18
+ route: z.ZodString;
19
+ key: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
20
+ name: z.ZodPipe<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, z.ZodOptional<z.ZodString>>;
21
+ disposition: z.ZodPreprocess<z.ZodOptional<z.ZodEnum<{
22
+ attachment: "attachment";
23
+ inline: "inline";
24
+ }>>, unknown>;
25
+ }, z.core.$strict>;
13
26
  //# sourceMappingURL=download.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/schema/download.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAwBzB,yEAAyE;AACzE,eAAO,MAAM,mBAAmB;;;;;;;;;kBAU9B,CAAC"}
1
+ {"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/schema/download.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAkCzB,yEAAyE;AACzE,eAAO,MAAM,mBAAmB;;;;;;;;;kBAW9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;kBAAgD,CAAC"}
@@ -1,11 +1,7 @@
1
- export { metadataSchema, objectKeySchema, optionalChecksumSchema, optionalTrimmedString, partNumberSchema, routeNameSchema, ROUTE_NAME_PATTERN, s3ObjectAclSchema, S3_DEFAULT_EXPIRES_IN, S3_MAX_EXPIRES_IN, S3_MAX_METADATA_ENTRIES, S3_MAX_PART_NUMBER, S3_MAX_POST_OBJECT_BYTES, sha256ChecksumSchema, trimmedString, } from "./shared";
2
- export { confirmBodySchema, uploadBodySchema } from "./upload";
3
- export { downloadQuerySchema } from "./download";
4
- export { deleteBatchBodySchema, deleteQuerySchema, DELETE_BATCH_MAX_KEYS, } from "./delete";
5
- export { fileQuerySchema } from "./file";
1
+ export { contentTypeSchema, fileNameSchema, metadataSchema, objectKeySchema, optionalChecksumSchema, optionalContentTypeSchema, optionalFileNameSchema, optionalTrimmedString, partNumberSchema, routeNameSchema, s3ObjectAclSchema, sha256ChecksumSchema, trimmedString, uploadTicketSchema, } from "./shared";
2
+ export { ticketBodySchema, uploadBodySchema } from "./upload";
3
+ export { downloadQuerySchema, fileQuerySchema } from "./download";
4
+ export { deleteManyBodySchema, deleteQuerySchema } from "./delete";
6
5
  export { downloadDispositionSchema, downloadModeSchema, routeCatalogEntrySchema, routeCatalogResponseSchema, } from "./catalog";
7
- export type { RouteCatalogEntry, RouteCatalogResponse } from "./catalog";
8
- export { multipartAbortBodySchema, multipartCompleteBodySchema, multipartCompletedPartSchema, multipartInitBodySchema, multipartListPartsQuerySchema, multipartSignPartBodySchema, } from "./multipart";
9
- export { s3ErrorParamsSchema, s3FetchErrorSchema } from "./error";
10
- export type { S3FetchError } from "./error";
6
+ export { multipartInitBodySchema, multipartSignPartBodySchema, } from "./multipart";
11
7
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,EAC5B,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,aAAa,CAAC"}
@@ -0,0 +1,221 @@
1
+ import * as z3 from 'zod';
2
+
3
+ // src/schema/shared.ts
4
+
5
+ // src/limits.ts
6
+ var S3_MAX_EXPIRES_IN = 604800;
7
+ var S3_MAX_PART_NUMBER = 1e4;
8
+ var S3_MAX_OBJECT_SIZE = 5 * 1024 ** 4;
9
+ var S3_MAX_FILE_FIELD_BYTES = 255;
10
+ var UPLOAD_TICKET_MAX_LENGTH = 8192;
11
+ var S3_MAX_METADATA_ENTRIES = 32;
12
+ var DELETE_MANY_MAX_KEYS = 100;
13
+ var ROUTE_NAME_PATTERN = /^[a-z][\w-]{0,63}$/i;
14
+
15
+ // src/helpers/fit-file-name.ts
16
+ var BIDI_CONTROL = /[\u202A-\u202E\u2066-\u2069]/u;
17
+ new TextEncoder();
18
+
19
+ // src/helpers/strip-slashes.ts
20
+ var SLASH = "/";
21
+ function stripSurroundingSlashes(value) {
22
+ let start = 0;
23
+ let end = value.length;
24
+ while (start < end && value.charAt(start) === SLASH) start += 1;
25
+ while (end > start && value.charAt(end - 1) === SLASH) end -= 1;
26
+ return start === 0 && end === value.length ? value : value.slice(start, end);
27
+ }
28
+
29
+ // src/helpers/normalize-object-key.ts
30
+ var S3_MAX_OBJECT_KEY_BYTES = 1024;
31
+ var utf82 = new TextEncoder();
32
+ function objectKeyByteLength(key) {
33
+ return utf82.encode(key).byteLength;
34
+ }
35
+ var CONTROL_CHARACTER = /\p{Cc}/u;
36
+ function normalizeObjectKey(key) {
37
+ const trimmed = stripSurroundingSlashes(key);
38
+ if (!trimmed || trimmed !== trimmed.trim()) return null;
39
+ if (trimmed.length > S3_MAX_OBJECT_KEY_BYTES) return null;
40
+ if (!trimmed.isWellFormed()) return null;
41
+ if (objectKeyByteLength(trimmed) > S3_MAX_OBJECT_KEY_BYTES) return null;
42
+ if (trimmed.includes("\\") || CONTROL_CHARACTER.test(trimmed)) return null;
43
+ const parts = trimmed.split("/");
44
+ if (parts.some((part) => part === "" || part === "." || part === "..")) {
45
+ return null;
46
+ }
47
+ return parts.join("/");
48
+ }
49
+
50
+ // src/schema/shared.ts
51
+ var trimmedString = z3.string().trim().min(1);
52
+ var optionalTrimmedString = z3.preprocess((value) => {
53
+ if (typeof value !== "string") return value;
54
+ const trimmed = value.trim();
55
+ return trimmed === "" ? void 0 : trimmed;
56
+ }, z3.string().optional());
57
+ var utf83 = new TextEncoder();
58
+ var CONTROL_CHARACTER2 = /\p{Cc}/u;
59
+ function fitsFileField(value) {
60
+ return utf83.encode(value).byteLength <= S3_MAX_FILE_FIELD_BYTES;
61
+ }
62
+ function isPrintable(value) {
63
+ return value.isWellFormed() && !CONTROL_CHARACTER2.test(value);
64
+ }
65
+ var fileNameSchema = trimmedString.refine(fitsFileField, {
66
+ message: `File name exceeds ${S3_MAX_FILE_FIELD_BYTES} bytes`
67
+ }).refine(isPrintable, {
68
+ message: "File name contains control characters"
69
+ }).refine((value) => !BIDI_CONTROL.test(value), {
70
+ message: "File name contains bidi control characters"
71
+ });
72
+ var contentTypeSchema = z3.string().trim().refine(fitsFileField, {
73
+ message: `Content type exceeds ${S3_MAX_FILE_FIELD_BYTES} bytes`
74
+ }).refine(isPrintable, {
75
+ message: "Content type contains control characters"
76
+ });
77
+ var optionalFileNameSchema = optionalTrimmedString.pipe(
78
+ fileNameSchema.optional()
79
+ );
80
+ var optionalContentTypeSchema = optionalTrimmedString.pipe(
81
+ contentTypeSchema.optional()
82
+ );
83
+ var uploadTicketSchema = trimmedString.max(UPLOAD_TICKET_MAX_LENGTH);
84
+ var routeNameSchema = trimmedString.regex(
85
+ ROUTE_NAME_PATTERN,
86
+ "Invalid route name"
87
+ );
88
+ var objectKeySchema = z3.string().transform((value, ctx) => {
89
+ const normalized = normalizeObjectKey(value);
90
+ if (normalized == null) {
91
+ ctx.issues.push({
92
+ code: "custom",
93
+ message: "Invalid object key",
94
+ input: value
95
+ });
96
+ return z3.NEVER;
97
+ }
98
+ return normalized;
99
+ });
100
+ var partNumberSchema = z3.int().min(1).max(S3_MAX_PART_NUMBER);
101
+ var s3ObjectAclSchema = z3.enum(["private", "public-read"]);
102
+ var sha256ChecksumSchema = z3.stringFormat("sha256-base64", /^[A-Z0-9+/]{43}=?$/i).transform((value) => value.length === 43 ? `${value}=` : value);
103
+ var optionalChecksumSchema = optionalTrimmedString.pipe(
104
+ sha256ChecksumSchema.optional()
105
+ );
106
+ var metadataKeySchema = z3.string().regex(/^[a-z0-9][a-z0-9-]*$/i, "Invalid metadata key").max(128);
107
+ var metadataSchema = z3.record(metadataKeySchema, z3.string().max(2048)).refine((value) => Object.keys(value).length <= S3_MAX_METADATA_ENTRIES, {
108
+ message: "Too many metadata entries"
109
+ });
110
+ var uploadBodySchema = z3.strictObject({
111
+ route: routeNameSchema,
112
+ name: fileNameSchema,
113
+ /**
114
+ * Declared size in bytes. Confirm checks it against HeadObject. `0` parses
115
+ * so the server can reject it as `FILE_EMPTY`, as `validateFile` does.
116
+ */
117
+ size: z3.int().nonnegative().max(S3_MAX_OBJECT_SIZE),
118
+ /** MIME type. A blank value is omitted. */
119
+ type: optionalContentTypeSchema,
120
+ metadata: metadataSchema.optional(),
121
+ /**
122
+ * Base64 SHA-256 (padding optional), as `sha256Blob` / `sha256Base64`
123
+ * return it. Required when the route sets `upload.checksum`.
124
+ */
125
+ checksum: optionalChecksumSchema
126
+ });
127
+ var ticketBodySchema = z3.strictObject({
128
+ ticket: uploadTicketSchema
129
+ });
130
+ var downloadDispositionSchema = z3.enum(["inline", "attachment"]);
131
+ var downloadModeSchema = z3.enum(["presign", "proxy"]);
132
+ var routeCatalogUploadSchema = z3.discriminatedUnion("enabled", [
133
+ z3.strictObject({
134
+ enabled: z3.literal(true),
135
+ fileTypes: z3.array(z3.string()).optional(),
136
+ maxFileSize: z3.int().positive().optional(),
137
+ /** Large files go through multipart upload. */
138
+ multipart: z3.boolean(),
139
+ /** Every upload must send a SHA-256 checksum. */
140
+ checksum: z3.boolean()
141
+ }),
142
+ z3.strictObject({ enabled: z3.literal(false) })
143
+ ]);
144
+ var routeCatalogDownloadSchema = z3.discriminatedUnion("enabled", [
145
+ z3.strictObject({
146
+ enabled: z3.literal(true),
147
+ /** Longest presign TTL in seconds. Clients may request a shorter `expiresIn`. */
148
+ maxExpiresIn: z3.int().positive().max(S3_MAX_EXPIRES_IN),
149
+ disposition: downloadDispositionSchema,
150
+ /** Types that may open inline. Pass to `resolveInlineDisposition`. */
151
+ inlineTypes: z3.array(z3.string()),
152
+ mode: downloadModeSchema
153
+ }),
154
+ z3.strictObject({ enabled: z3.literal(false) })
155
+ ]);
156
+ var routeCatalogDeleteSchema = z3.strictObject({
157
+ enabled: z3.boolean()
158
+ });
159
+ var routeCatalogEntrySchema = z3.strictObject({
160
+ upload: routeCatalogUploadSchema,
161
+ download: routeCatalogDownloadSchema,
162
+ delete: routeCatalogDeleteSchema
163
+ });
164
+ var routeCatalogResponseSchema = z3.strictObject({
165
+ routes: z3.record(routeNameSchema, routeCatalogEntrySchema)
166
+ });
167
+
168
+ // src/schema/download.ts
169
+ function blankToUndefined(value) {
170
+ if (value == null) return void 0;
171
+ if (typeof value === "string" && value.trim() === "") return void 0;
172
+ return value;
173
+ }
174
+ var optionalExpiresInSchema = z3.preprocess((value) => {
175
+ const present = blankToUndefined(value);
176
+ if (typeof present === "string" && /^\d+$/.test(present.trim())) {
177
+ return Number(present.trim());
178
+ }
179
+ return present;
180
+ }, z3.int().positive().max(S3_MAX_EXPIRES_IN).optional());
181
+ var optionalDispositionSchema = z3.preprocess(
182
+ blankToUndefined,
183
+ downloadDispositionSchema.optional()
184
+ );
185
+ var downloadQuerySchema = z3.strictObject({
186
+ route: routeNameSchema,
187
+ key: objectKeySchema,
188
+ /** Download file name. A blank value is omitted. */
189
+ name: optionalFileNameSchema,
190
+ disposition: optionalDispositionSchema,
191
+ /**
192
+ * Requested TTL in seconds. Capped by the route `download.maxExpiresIn`.
193
+ * `download.resolve` can still replace it.
194
+ */
195
+ expiresIn: optionalExpiresInSchema
196
+ });
197
+ var fileQuerySchema = downloadQuerySchema.omit({ expiresIn: true });
198
+ var deleteQuerySchema = z3.strictObject({
199
+ route: routeNameSchema,
200
+ key: objectKeySchema
201
+ });
202
+ var deleteManyBodySchema = z3.strictObject({
203
+ route: routeNameSchema,
204
+ keys: z3.array(objectKeySchema).min(1).max(DELETE_MANY_MAX_KEYS)
205
+ });
206
+ var multipartInitBodySchema = uploadBodySchema.omit({
207
+ checksum: true
208
+ });
209
+ var multipartSignPartBodySchema = z3.strictObject({
210
+ ticket: uploadTicketSchema,
211
+ partNumber: partNumberSchema,
212
+ /**
213
+ * Base64 SHA-256 of the part (padding optional), as `sha256Blob` /
214
+ * `sha256Base64` return it. Required when init returned `checksum: true`.
215
+ */
216
+ checksum: optionalChecksumSchema
217
+ });
218
+
219
+ export { contentTypeSchema, deleteManyBodySchema, deleteQuerySchema, downloadDispositionSchema, downloadModeSchema, downloadQuerySchema, fileNameSchema, fileQuerySchema, metadataSchema, multipartInitBodySchema, multipartSignPartBodySchema, objectKeySchema, optionalChecksumSchema, optionalContentTypeSchema, optionalFileNameSchema, optionalTrimmedString, partNumberSchema, routeCatalogEntrySchema, routeCatalogResponseSchema, routeNameSchema, s3ObjectAclSchema, sha256ChecksumSchema, ticketBodySchema, trimmedString, uploadBodySchema, uploadTicketSchema };
220
+ //# sourceMappingURL=index.js.map
221
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/limits.ts","../../src/helpers/fit-file-name.ts","../../src/helpers/strip-slashes.ts","../../src/helpers/normalize-object-key.ts","../../src/schema/shared.ts","../../src/schema/upload.ts","../../src/schema/catalog.ts","../../src/schema/download.ts","../../src/schema/delete.ts","../../src/schema/multipart.ts"],"names":["utf8","z","CONTROL_CHARACTER","z2","z4","z5","z6"],"mappings":"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","file":"index.js","sourcesContent":["/*\n * Protocol and S3 limits. Plain values with no Zod import, so the browser\n * entry can use them without pulling in the schemas\n * (`@dimah-s3/core/schema`).\n */\n\n/** Fallback when the route omits `expiresIn`. */\nexport const S3_DEFAULT_EXPIRES_IN = 600;\n\n/** AWS SigV4 presign maximum (7 days), in seconds. */\nexport const S3_MAX_EXPIRES_IN = 604_800;\n\n/** Most S3 takes in one POST or PutObject (5 GiB), in bytes. */\nexport const S3_MAX_POST_OBJECT_BYTES = 5 * 1024 * 1024 * 1024;\n\n/** S3 multipart part number maximum. */\nexport const S3_MAX_PART_NUMBER = 10_000;\n\n/** S3 multipart part minimum (5 MiB). Only the last part may be smaller. */\nexport const S3_MIN_PART_SIZE = 5 * 1024 * 1024;\n\n/** S3 multipart part maximum (5 GiB). */\nexport const S3_MAX_PART_SIZE = 5 * 1024 * 1024 * 1024;\n\n/** Preferred part size when the route sets no `multipart.partSize` (8 MiB). */\nexport const S3_DEFAULT_PART_SIZE = 8 * 1024 * 1024;\n\n/**\n * Largest object (5 TiB), in bytes. AWS allows more since 2025, but 5 TiB\n * is the limit S3-compatible providers share.\n */\nexport const S3_MAX_OBJECT_SIZE = 5 * 1024 ** 4;\n\n/** Wire limit for `name` and `type`, in UTF-8 bytes. */\nexport const S3_MAX_FILE_FIELD_BYTES = 255;\n\n/** Upload ticket maximum, in characters. */\nexport const UPLOAD_TICKET_MAX_LENGTH = 8192;\n\n/** Max user-defined metadata entries on an upload body. */\nexport const S3_MAX_METADATA_ENTRIES = 32;\n\n/** Most keys one `deleteMany` request may carry. */\nexport const DELETE_MANY_MAX_KEYS = 100;\n\n/** Named file-route identifier (`avatars`, `uploads`, …). */\nexport const ROUTE_NAME_PATTERN = /^[a-z][\\w-]{0,63}$/i;\n","import { S3_MAX_FILE_FIELD_BYTES } from \"@/limits\";\n\n/** Longest extension (with its dot) kept when a name is shortened. */\nconst MAX_EXTENSION_BYTES = 32;\n\n/** Name used when nothing usable is left. */\nconst FALLBACK_FILE_NAME = \"file\";\n\nconst CONTROL_CHARACTERS = /\\p{Cc}/gu;\n\n/**\n * Bidi embedding, override and isolate controls (U+202A to U+202E, U+2066\n * to U+2069). They can make `x{U+202E}fdp.exe` read as `xexe.pdf`. Other\n * format characters, such as the joiner in emoji, are kept.\n */\nexport const BIDI_CONTROL = /[\\u202A-\\u202E\\u2066-\\u2069]/u;\n\nconst BIDI_CONTROLS = new RegExp(BIDI_CONTROL.source, \"gu\");\n\nconst utf8 = new TextEncoder();\n\nfunction byteLength(text: string): number {\n return utf8.encode(text).byteLength;\n}\n\nlet graphemeSegmenter: Intl.Segmenter | null | undefined;\n\n/** User-perceived characters when `Intl.Segmenter` exists, else code points. */\nfunction graphemes(text: string): Iterable<string> {\n if (graphemeSegmenter === undefined) {\n graphemeSegmenter =\n typeof Intl.Segmenter === \"function\"\n ? new Intl.Segmenter(undefined, { granularity: \"grapheme\" })\n : null;\n }\n if (!graphemeSegmenter) return text;\n return Array.from(graphemeSegmenter.segment(text), (part) => part.segment);\n}\n\n/** The longest run of whole `parts` that fits in `maxBytes`. */\nfunction takeWithin(parts: Iterable<string>, maxBytes: number): string {\n let taken = \"\";\n let used = 0;\n for (const part of parts) {\n used += byteLength(part);\n if (used > maxBytes) break;\n taken += part;\n }\n return taken;\n}\n\n/**\n * Cut `text` to `maxBytes` of UTF-8 without splitting a character. Cuts on\n * grapheme boundaries, and on code points when the first grapheme alone is\n * too long.\n */\nfunction cutToBytes(text: string, maxBytes: number): string {\n return takeWithin(graphemes(text), maxBytes) || takeWithin(text, maxBytes);\n}\n\n/**\n * Fit a file name to the wire rule for `name`: lone surrogates replaced,\n * control and bidi characters removed, trimmed, and at most\n * {@link S3_MAX_FILE_FIELD_BYTES} UTF-8 bytes. A longer name is cut on a\n * character boundary and keeps a short extension. A name that is already\n * valid comes back unchanged; an empty result is `\"file\"`.\n */\nexport function fitFileName(name: string): string {\n const cleaned = name\n .toWellFormed()\n .replaceAll(CONTROL_CHARACTERS, \"\")\n .replaceAll(BIDI_CONTROLS, \"\")\n .trim();\n if (byteLength(cleaned) <= S3_MAX_FILE_FIELD_BYTES) {\n return cleaned || FALLBACK_FILE_NAME;\n }\n const dot = cleaned.lastIndexOf(\".\");\n const extension = dot > 0 ? cleaned.slice(dot) : \"\";\n const keepExtension =\n extension.length > 1 && byteLength(extension) <= MAX_EXTENSION_BYTES;\n const suffix = keepExtension ? extension : \"\";\n const stem = keepExtension ? cleaned.slice(0, dot) : cleaned;\n const budget = S3_MAX_FILE_FIELD_BYTES - byteLength(suffix);\n const base = cutToBytes(stem, budget).trimEnd() || FALLBACK_FILE_NAME;\n return `${base}${suffix}`;\n}\n","const SLASH = \"/\";\n\n/** Drop trailing `/` in linear time so a long slash run cannot backtrack. */\nexport function stripTrailingSlashes(value: string): string {\n let end = value.length;\n while (end > 0 && value.charAt(end - 1) === SLASH) end -= 1;\n return end === value.length ? value : value.slice(0, end);\n}\n\n/** Drop leading and trailing `/` in linear time so a long slash run cannot backtrack. */\nexport function stripSurroundingSlashes(value: string): string {\n let start = 0;\n let end = value.length;\n while (start < end && value.charAt(start) === SLASH) start += 1;\n while (end > start && value.charAt(end - 1) === SLASH) end -= 1;\n return start === 0 && end === value.length ? value : value.slice(start, end);\n}\n","import { stripSurroundingSlashes } from \"./strip-slashes\";\n\n/** S3 object key maximum, in UTF-8 bytes. */\nexport const S3_MAX_OBJECT_KEY_BYTES = 1024;\n\nconst utf8 = new TextEncoder();\n\n/** Length of an object key in UTF-8 bytes, the unit S3 limits keys in. */\nexport function objectKeyByteLength(key: string): number {\n return utf8.encode(key).byteLength;\n}\n\n/** Control characters (C0, DEL, C1), NUL among them. */\nconst CONTROL_CHARACTER = /\\p{Cc}/u;\n\n/**\n * Strip leading/trailing slashes and reject `.` / `..` / empty segments,\n * control characters, backslashes, lone surrogates, whitespace around the\n * key, and keys over {@link S3_MAX_OBJECT_KEY_BYTES}. Returns `null` when\n * the key is unsafe. A key is never trimmed: `a.pdf ` and `a.pdf` are two\n * objects, so a key that differs from its trimmed form is refused.\n */\nexport function normalizeObjectKey(key: string): string | null {\n const trimmed = stripSurroundingSlashes(key);\n if (!trimmed || trimmed !== trimmed.trim()) return null;\n // A UTF-8 key is never shorter than its UTF-16 length: skip encoding huge keys.\n if (trimmed.length > S3_MAX_OBJECT_KEY_BYTES) return null;\n if (!trimmed.isWellFormed()) return null;\n if (objectKeyByteLength(trimmed) > S3_MAX_OBJECT_KEY_BYTES) return null;\n if (trimmed.includes(\"\\\\\") || CONTROL_CHARACTER.test(trimmed)) return null;\n const parts = trimmed.split(\"/\");\n if (parts.some((part) => part === \"\" || part === \".\" || part === \"..\")) {\n return null;\n }\n return parts.join(\"/\");\n}\n","import * as z from \"zod\";\nimport { BIDI_CONTROL } from \"@/helpers/fit-file-name\";\nimport { normalizeObjectKey } from \"@/helpers/normalize-object-key\";\nimport {\n ROUTE_NAME_PATTERN,\n S3_MAX_FILE_FIELD_BYTES,\n S3_MAX_METADATA_ENTRIES,\n S3_MAX_PART_NUMBER,\n UPLOAD_TICKET_MAX_LENGTH,\n} from \"@/limits\";\n\n/** Non-empty trimmed string. */\nexport const trimmedString = z.string().trim().min(1);\n\n/** Optional trimmed string. Blank or whitespace-only values are omitted. */\nexport const optionalTrimmedString = z.preprocess((value: unknown) => {\n if (typeof value !== \"string\") return value;\n const trimmed = value.trim();\n return trimmed === \"\" ? undefined : trimmed;\n}, z.string().optional());\n\nconst utf8 = new TextEncoder();\n\n/** Control characters (C0, DEL, C1). */\nconst CONTROL_CHARACTER = /\\p{Cc}/u;\n\nfunction fitsFileField(value: string): boolean {\n return utf8.encode(value).byteLength <= S3_MAX_FILE_FIELD_BYTES;\n}\n\n/** No control characters and no lone surrogates, which no header can carry. */\nfunction isPrintable(value: string): boolean {\n return value.isWellFormed() && !CONTROL_CHARACTER.test(value);\n}\n\n/**\n * File name on the wire. Trimmed, 1 to 255 UTF-8 bytes, valid Unicode, no\n * control characters, and no bidi controls, which would let `x{U+202E}fdp.exe`\n * display as `xexe.pdf`. They also bound the upload ticket size.\n */\nexport const fileNameSchema = trimmedString\n .refine(fitsFileField, {\n message: `File name exceeds ${S3_MAX_FILE_FIELD_BYTES} bytes`,\n })\n .refine(isPrintable, {\n message: \"File name contains control characters\",\n })\n .refine((value) => !BIDI_CONTROL.test(value), {\n message: \"File name contains bidi control characters\",\n });\n\n/** MIME type on the wire. Trimmed, at most 255 UTF-8 bytes, no control characters. */\nexport const contentTypeSchema = z\n .string()\n .trim()\n .refine(fitsFileField, {\n message: `Content type exceeds ${S3_MAX_FILE_FIELD_BYTES} bytes`,\n })\n .refine(isPrintable, {\n message: \"Content type contains control characters\",\n });\n\n/** Optional file name. Blank or whitespace-only values are omitted. */\nexport const optionalFileNameSchema = optionalTrimmedString.pipe(\n fileNameSchema.optional(),\n);\n\n/** Optional MIME type. Blank or whitespace-only values are omitted. */\nexport const optionalContentTypeSchema = optionalTrimmedString.pipe(\n contentTypeSchema.optional(),\n);\n\n/** Opaque upload ticket from presign or multipart init. Trimmed, 1 to 8192 characters. */\nexport const uploadTicketSchema = trimmedString.max(UPLOAD_TICKET_MAX_LENGTH);\n\nexport const routeNameSchema = trimmedString.regex(\n ROUTE_NAME_PATTERN,\n \"Invalid route name\",\n);\n\n/**\n * Stored object key: normalized, at most 1024 UTF-8 bytes, no `.` / `..` /\n * empty segments, control characters or backslashes. It is not trimmed: a\n * key with whitespace around it is refused, since S3 would treat it as\n * another object.\n */\nexport const objectKeySchema = z.string().transform((value, ctx) => {\n const normalized = normalizeObjectKey(value);\n if (normalized == null) {\n ctx.issues.push({\n code: \"custom\",\n message: \"Invalid object key\",\n input: value,\n });\n return z.NEVER;\n }\n return normalized;\n});\n\n/** 1-based S3 multipart part number. */\nexport const partNumberSchema = z.int().min(1).max(S3_MAX_PART_NUMBER);\n\nexport const s3ObjectAclSchema = z.enum([\"private\", \"public-read\"]);\n\n/**\n * S3 `ChecksumSHA256`: a 32-byte SHA-256 as standard base64. Padding is\n * optional on input, and the output always has it, so every provider gets\n * the canonical form `sha256Blob` would send padded.\n */\nexport const sha256ChecksumSchema = z\n .stringFormat(\"sha256-base64\", /^[A-Z0-9+/]{43}=?$/i)\n .transform((value) => (value.length === 43 ? `${value}=` : value));\n\n/** Optional checksum; blank / whitespace-only values are omitted. */\nexport const optionalChecksumSchema = optionalTrimmedString.pipe(\n sha256ChecksumSchema.optional(),\n);\n\nconst metadataKeySchema = z\n .string()\n .regex(/^[a-z0-9][a-z0-9-]*$/i, \"Invalid metadata key\")\n .max(128);\n\nexport const metadataSchema = z\n .record(metadataKeySchema, z.string().max(2048))\n .refine((value) => Object.keys(value).length <= S3_MAX_METADATA_ENTRIES, {\n message: \"Too many metadata entries\",\n });\n","import * as z from \"zod\";\nimport { S3_MAX_OBJECT_SIZE } from \"@/limits\";\nimport {\n fileNameSchema,\n metadataSchema,\n optionalChecksumSchema,\n optionalContentTypeSchema,\n routeNameSchema,\n uploadTicketSchema,\n} from \"./shared\";\n\nexport const uploadBodySchema = z.strictObject({\n route: routeNameSchema,\n name: fileNameSchema,\n /**\n * Declared size in bytes. Confirm checks it against HeadObject. `0` parses\n * so the server can reject it as `FILE_EMPTY`, as `validateFile` does.\n */\n size: z.int().nonnegative().max(S3_MAX_OBJECT_SIZE),\n /** MIME type. A blank value is omitted. */\n type: optionalContentTypeSchema,\n metadata: metadataSchema.optional(),\n /**\n * Base64 SHA-256 (padding optional), as `sha256Blob` / `sha256Base64`\n * return it. Required when the route sets `upload.checksum`.\n */\n checksum: optionalChecksumSchema,\n});\n\n/**\n * Body of every call that carries only an upload ticket: confirm, and the\n * multipart `listParts`, `complete` and `abort`.\n */\nexport const ticketBodySchema = z.strictObject({\n ticket: uploadTicketSchema,\n});\n","import * as z from \"zod\";\nimport type { S3RouteName } from \"@/types/routes\";\nimport { S3_MAX_EXPIRES_IN } from \"@/limits\";\nimport { routeNameSchema } from \"./shared\";\n\nexport const downloadDispositionSchema = z.enum([\"inline\", \"attachment\"]);\nexport const downloadModeSchema = z.enum([\"presign\", \"proxy\"]);\n\nexport const routeCatalogUploadSchema = z.discriminatedUnion(\"enabled\", [\n z.strictObject({\n enabled: z.literal(true),\n fileTypes: z.array(z.string()).optional(),\n maxFileSize: z.int().positive().optional(),\n /** Large files go through multipart upload. */\n multipart: z.boolean(),\n /** Every upload must send a SHA-256 checksum. */\n checksum: z.boolean(),\n }),\n z.strictObject({ enabled: z.literal(false) }),\n]);\n\nexport const routeCatalogDownloadSchema = z.discriminatedUnion(\"enabled\", [\n z.strictObject({\n enabled: z.literal(true),\n /** Longest presign TTL in seconds. Clients may request a shorter `expiresIn`. */\n maxExpiresIn: z.int().positive().max(S3_MAX_EXPIRES_IN),\n disposition: downloadDispositionSchema,\n /** Types that may open inline. Pass to `resolveInlineDisposition`. */\n inlineTypes: z.array(z.string()),\n mode: downloadModeSchema,\n }),\n z.strictObject({ enabled: z.literal(false) }),\n]);\n\nexport const routeCatalogDeleteSchema = z.strictObject({\n enabled: z.boolean(),\n});\n\nexport const routeCatalogEntrySchema = z.strictObject({\n upload: routeCatalogUploadSchema,\n download: routeCatalogDownloadSchema,\n delete: routeCatalogDeleteSchema,\n});\n\nexport const routeCatalogResponseSchema = z.strictObject({\n routes: z.record(routeNameSchema, routeCatalogEntrySchema),\n});\n\nexport type RouteCatalogEntry = z.output<typeof routeCatalogEntrySchema>;\nexport type RouteCatalogResponse = {\n routes: Record<S3RouteName, RouteCatalogEntry>;\n};\n","import * as z from \"zod\";\nimport { S3_MAX_EXPIRES_IN } from \"@/limits\";\nimport { downloadDispositionSchema } from \"./catalog\";\nimport {\n objectKeySchema,\n optionalFileNameSchema,\n routeNameSchema,\n} from \"./shared\";\n\n/** A blank query value, which the optional fields below omit. */\nfunction blankToUndefined(value: unknown): unknown {\n if (value == null) return undefined;\n if (typeof value === \"string\" && value.trim() === \"\") return undefined;\n return value;\n}\n\n/**\n * Positive TTL in seconds. Query strings arrive as digits; blank is omitted.\n * Values above the SigV4 maximum are rejected. The route cap is applied later.\n */\nconst optionalExpiresInSchema = z.preprocess((value: unknown) => {\n const present = blankToUndefined(value);\n if (typeof present === \"string\" && /^\\d+$/.test(present.trim())) {\n return Number(present.trim());\n }\n return present;\n}, z.int().positive().max(S3_MAX_EXPIRES_IN).optional());\n\n/** `inline` or `attachment`. A blank value is omitted, like the other fields. */\nconst optionalDispositionSchema = z.preprocess(\n blankToUndefined,\n downloadDispositionSchema.optional(),\n);\n\n/** Query string — numbers arrive as strings. Extra keys are rejected. */\nexport const downloadQuerySchema = z.strictObject({\n route: routeNameSchema,\n key: objectKeySchema,\n /** Download file name. A blank value is omitted. */\n name: optionalFileNameSchema,\n disposition: optionalDispositionSchema,\n /**\n * Requested TTL in seconds. Capped by the route `download.maxExpiresIn`.\n * `download.resolve` can still replace it.\n */\n expiresIn: optionalExpiresInSchema,\n});\n\n/**\n * Query for the same-origin proxy download (`GET /file`): the download\n * query without `expiresIn`, since a proxy URL does not expire.\n */\nexport const fileQuerySchema = downloadQuerySchema.omit({ expiresIn: true });\n","import * as z from \"zod\";\nimport { DELETE_MANY_MAX_KEYS } from \"@/limits\";\nimport { objectKeySchema, routeNameSchema } from \"./shared\";\n\nexport const deleteQuerySchema = z.strictObject({\n route: routeNameSchema,\n key: objectKeySchema,\n});\n\nexport const deleteManyBodySchema = z.strictObject({\n route: routeNameSchema,\n keys: z.array(objectKeySchema).min(1).max(DELETE_MANY_MAX_KEYS),\n});\n","import * as z from \"zod\";\nimport { uploadBodySchema } from \"./upload\";\nimport {\n optionalChecksumSchema,\n partNumberSchema,\n uploadTicketSchema,\n} from \"./shared\";\n\n/** Same fields as upload, minus `checksum`. The server picks the part layout. */\nexport const multipartInitBodySchema = uploadBodySchema.omit({\n checksum: true,\n});\n\nexport const multipartSignPartBodySchema = z.strictObject({\n ticket: uploadTicketSchema,\n partNumber: partNumberSchema,\n /**\n * Base64 SHA-256 of the part (padding optional), as `sha256Blob` /\n * `sha256Base64` return it. Required when init returned `checksum: true`.\n */\n checksum: optionalChecksumSchema,\n});\n"]}
@@ -1,38 +1,15 @@
1
1
  import * as z from "zod";
2
+ /** Same fields as upload, minus `checksum`. The server picks the part layout. */
2
3
  export declare const multipartInitBodySchema: z.ZodObject<{
3
4
  route: z.ZodString;
4
- fileName: z.ZodString;
5
- fileSize: z.ZodInt;
6
- contentType: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
5
+ name: z.ZodString;
6
+ size: z.ZodInt;
7
+ type: z.ZodPipe<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, z.ZodOptional<z.ZodString>>;
7
8
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8
- checksum: z.ZodPipe<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, z.ZodOptional<z.ZodCustomStringFormat<"sha256-base64">>>;
9
9
  }, z.core.$strict>;
10
10
  export declare const multipartSignPartBodySchema: z.ZodObject<{
11
- route: z.ZodString;
12
- key: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
13
- uploadId: z.ZodString;
14
- partNumber: z.ZodInt;
15
- partSize: z.ZodInt;
16
- }, z.core.$strict>;
17
- export declare const multipartListPartsQuerySchema: z.ZodObject<{
18
- route: z.ZodString;
19
- key: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
20
- uploadId: z.ZodString;
21
- }, z.core.$strict>;
22
- export declare const multipartCompletedPartSchema: z.ZodObject<{
11
+ ticket: z.ZodString;
23
12
  partNumber: z.ZodInt;
24
- }, z.core.$strict>;
25
- export declare const multipartCompleteBodySchema: z.ZodObject<{
26
- route: z.ZodString;
27
- key: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
28
- uploadId: z.ZodString;
29
- parts: z.ZodArray<z.ZodObject<{
30
- partNumber: z.ZodInt;
31
- }, z.core.$strict>>;
32
- }, z.core.$strict>;
33
- export declare const multipartAbortBodySchema: z.ZodObject<{
34
- route: z.ZodString;
35
- key: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
36
- uploadId: z.ZodString;
13
+ checksum: z.ZodPipe<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, z.ZodOptional<z.ZodPipe<z.ZodCustomStringFormat<"sha256-base64">, z.ZodTransform<string, string>>>>;
37
14
  }, z.core.$strict>;
38
15
  //# sourceMappingURL=multipart.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"multipart.d.ts","sourceRoot":"","sources":["../../src/schema/multipart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AASzB,eAAO,MAAM,uBAAuB;;;;;;;kBAAmB,CAAC;AAQxD,eAAO,MAAM,2BAA2B;;;;;;kBAItC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;kBAExC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;kBAEvC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;kBAGtC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;kBAEnC,CAAC"}
1
+ {"version":3,"file":"multipart.d.ts","sourceRoot":"","sources":["../../src/schema/multipart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAQzB,iFAAiF;AACjF,eAAO,MAAM,uBAAuB;;;;;;kBAElC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;kBAQtC,CAAC"}
@@ -1,22 +1,29 @@
1
1
  import * as z from "zod";
2
- /** Fallback when the route omits `expiresIn`. */
3
- export declare const S3_DEFAULT_EXPIRES_IN = 600;
4
- /** AWS SigV4 presign maximum (7 days), in seconds. */
5
- export declare const S3_MAX_EXPIRES_IN = 604800;
6
- /** S3 POST object maximum (5 GiB), in bytes. */
7
- export declare const S3_MAX_POST_OBJECT_BYTES: number;
8
- /** S3 multipart part number maximum. */
9
- export declare const S3_MAX_PART_NUMBER = 10000;
10
- /** Max user-defined metadata entries on an upload body. */
11
- export declare const S3_MAX_METADATA_ENTRIES = 32;
12
- /** Named file-route identifier (`avatars`, `uploads`, …). */
13
- export declare const ROUTE_NAME_PATTERN: RegExp;
14
2
  /** Non-empty trimmed string. */
15
3
  export declare const trimmedString: z.ZodString;
16
4
  /** Optional trimmed string. Blank or whitespace-only values are omitted. */
17
5
  export declare const optionalTrimmedString: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
6
+ /**
7
+ * File name on the wire. Trimmed, 1 to 255 UTF-8 bytes, valid Unicode, no
8
+ * control characters, and no bidi controls, which would let `x{U+202E}fdp.exe`
9
+ * display as `xexe.pdf`. They also bound the upload ticket size.
10
+ */
11
+ export declare const fileNameSchema: z.ZodString;
12
+ /** MIME type on the wire. Trimmed, at most 255 UTF-8 bytes, no control characters. */
13
+ export declare const contentTypeSchema: z.ZodString;
14
+ /** Optional file name. Blank or whitespace-only values are omitted. */
15
+ export declare const optionalFileNameSchema: z.ZodPipe<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, z.ZodOptional<z.ZodString>>;
16
+ /** Optional MIME type. Blank or whitespace-only values are omitted. */
17
+ export declare const optionalContentTypeSchema: z.ZodPipe<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, z.ZodOptional<z.ZodString>>;
18
+ /** Opaque upload ticket from presign or multipart init. Trimmed, 1 to 8192 characters. */
19
+ export declare const uploadTicketSchema: z.ZodString;
18
20
  export declare const routeNameSchema: z.ZodString;
19
- /** Stored object key — normalized, no `.` / `..` / NUL / backslash segments. */
21
+ /**
22
+ * Stored object key: normalized, at most 1024 UTF-8 bytes, no `.` / `..` /
23
+ * empty segments, control characters or backslashes. It is not trimmed: a
24
+ * key with whitespace around it is refused, since S3 would treat it as
25
+ * another object.
26
+ */
20
27
  export declare const objectKeySchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
21
28
  /** 1-based S3 multipart part number. */
22
29
  export declare const partNumberSchema: z.ZodInt;
@@ -25,11 +32,12 @@ export declare const s3ObjectAclSchema: z.ZodEnum<{
25
32
  "public-read": "public-read";
26
33
  }>;
27
34
  /**
28
- * S3 `ChecksumSHA256` — 32-byte SHA-256 as standard base64 (padding optional).
29
- * Matches `sha256Base64()` output and the padded form AWS also accepts.
35
+ * S3 `ChecksumSHA256`: a 32-byte SHA-256 as standard base64. Padding is
36
+ * optional on input, and the output always has it, so every provider gets
37
+ * the canonical form `sha256Blob` would send padded.
30
38
  */
31
- export declare const sha256ChecksumSchema: z.ZodCustomStringFormat<"sha256-base64">;
39
+ export declare const sha256ChecksumSchema: z.ZodPipe<z.ZodCustomStringFormat<"sha256-base64">, z.ZodTransform<string, string>>;
32
40
  /** Optional checksum; blank / whitespace-only values are omitted. */
33
- export declare const optionalChecksumSchema: z.ZodPipe<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, z.ZodOptional<z.ZodCustomStringFormat<"sha256-base64">>>;
41
+ export declare const optionalChecksumSchema: z.ZodPipe<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, z.ZodOptional<z.ZodPipe<z.ZodCustomStringFormat<"sha256-base64">, z.ZodTransform<string, string>>>>;
34
42
  export declare const metadataSchema: z.ZodRecord<z.ZodString, z.ZodString>;
35
43
  //# sourceMappingURL=shared.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/schema/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAMzB,iDAAiD;AACjD,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,SAAU,CAAC;AAEzC,gDAAgD;AAChD,eAAO,MAAM,wBAAwB,QAAyB,CAAC;AAE/D,wCAAwC;AACxC,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,2DAA2D;AAC3D,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,QAAwB,CAAC;AAExD,gCAAgC;AAChC,eAAO,MAAM,aAAa,aAA2B,CAAC;AAEtD,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,sDAIT,CAAC;AAE1B,eAAO,MAAM,eAAe,aAG3B,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,eAAe,wDAaxB,CAAC;AAEL,wCAAwC;AACxC,eAAO,MAAM,gBAAgB,UAAyC,CAAC;AAEvE,eAAO,MAAM,iBAAiB;;;EAAqC,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,0CAGhC,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,0HAElC,CAAC;AAOF,eAAO,MAAM,cAAc,uCAIvB,CAAC"}
1
+ {"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/schema/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAWzB,gCAAgC;AAChC,eAAO,MAAM,aAAa,aAA2B,CAAC;AAEtD,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,sDAIT,CAAC;AAgB1B;;;;GAIG;AACH,eAAO,MAAM,cAAc,aASvB,CAAC;AAEL,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,aAQ1B,CAAC;AAEL,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,6FAElC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,yBAAyB,6FAErC,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,aAA8C,CAAC;AAE9E,eAAO,MAAM,eAAe,aAG3B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,wDAW1B,CAAC;AAEH,wCAAwC;AACxC,eAAO,MAAM,gBAAgB,UAAyC,CAAC;AAEvE,eAAO,MAAM,iBAAiB;;;EAAqC,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,qFAEmC,CAAC;AAErE,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,qKAElC,CAAC;AAOF,eAAO,MAAM,cAAc,uCAIvB,CAAC"}
@@ -1,14 +1,17 @@
1
1
  import * as z from "zod";
2
2
  export declare const uploadBodySchema: z.ZodObject<{
3
3
  route: z.ZodString;
4
- fileName: z.ZodString;
5
- fileSize: z.ZodInt;
6
- contentType: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
4
+ name: z.ZodString;
5
+ size: z.ZodInt;
6
+ type: z.ZodPipe<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, z.ZodOptional<z.ZodString>>;
7
7
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8
- checksum: z.ZodPipe<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, z.ZodOptional<z.ZodCustomStringFormat<"sha256-base64">>>;
8
+ checksum: z.ZodPipe<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, z.ZodOptional<z.ZodPipe<z.ZodCustomStringFormat<"sha256-base64">, z.ZodTransform<string, string>>>>;
9
9
  }, z.core.$strict>;
10
- export declare const confirmBodySchema: z.ZodObject<{
11
- route: z.ZodString;
12
- key: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
10
+ /**
11
+ * Body of every call that carries only an upload ticket: confirm, and the
12
+ * multipart `listParts`, `complete` and `abort`.
13
+ */
14
+ export declare const ticketBodySchema: z.ZodObject<{
15
+ ticket: z.ZodString;
13
16
  }, z.core.$strict>;
14
17
  //# sourceMappingURL=upload.d.ts.map