@venizia/ignis-helpers 0.4.8-9 → 0.4.8

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 (199) hide show
  1. package/README.md +2 -3
  2. package/dist/esm/common/constants/app.d.ts +1 -3
  3. package/dist/esm/common/constants/app.js +1 -11
  4. package/dist/esm/common/constants/app.js.map +1 -1
  5. package/dist/esm/common/constants/http.d.ts +2 -0
  6. package/dist/esm/common/constants/http.js +3 -0
  7. package/dist/esm/common/constants/http.js.map +1 -1
  8. package/dist/esm/common/constants/mime.d.ts +0 -2
  9. package/dist/esm/common/constants/mime.js +0 -4
  10. package/dist/esm/common/constants/mime.js.map +1 -1
  11. package/dist/esm/common/redact.js.map +1 -1
  12. package/dist/esm/common/types/class.d.ts +14 -12
  13. package/dist/esm/common/types/class.js.map +1 -1
  14. package/dist/esm/common/types/const-value.d.ts +3 -3
  15. package/dist/esm/common/types/const-value.js.map +1 -1
  16. package/dist/esm/common/types/field-mapping.d.ts +6 -8
  17. package/dist/esm/common/types/field-mapping.js +0 -10
  18. package/dist/esm/common/types/field-mapping.js.map +1 -1
  19. package/dist/esm/common/types/index.d.ts +1 -0
  20. package/dist/esm/common/types/index.js +1 -0
  21. package/dist/esm/common/types/index.js.map +1 -1
  22. package/dist/esm/common/types/injection.d.ts +1 -1
  23. package/dist/esm/common/types/injection.js.map +1 -1
  24. package/dist/esm/common/types/json.d.ts +14 -0
  25. package/dist/esm/common/types/json.js +2 -0
  26. package/dist/esm/common/types/json.js.map +1 -0
  27. package/dist/esm/common/types/utility.d.ts +0 -4
  28. package/dist/esm/common/types/utility.js.map +1 -1
  29. package/dist/esm/modules/env/app-env.d.ts +17 -8
  30. package/dist/esm/modules/env/app-env.js +18 -15
  31. package/dist/esm/modules/env/app-env.js.map +1 -1
  32. package/dist/esm/modules/env/common/types.d.ts +22 -6
  33. package/dist/esm/modules/env/common/types.js.map +1 -1
  34. package/dist/esm/modules/logger/base/abstract.d.ts +6 -7
  35. package/dist/esm/modules/logger/base/abstract.js.map +1 -1
  36. package/dist/esm/modules/logger/base/base.d.ts +7 -8
  37. package/dist/esm/modules/logger/base/base.js.map +1 -1
  38. package/dist/esm/modules/logger/base/console.d.ts +6 -7
  39. package/dist/esm/modules/logger/base/console.js.map +1 -1
  40. package/dist/esm/modules/logger/common/types.d.ts +7 -7
  41. package/dist/esm/modules/logger/common/types.js.map +1 -1
  42. package/dist/esm/modules/logger/factory.js.map +1 -1
  43. package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
  44. package/dist/esm/modules/logger/hf/logger.d.ts +6 -7
  45. package/dist/esm/modules/logger/hf/logger.js.map +1 -1
  46. package/dist/esm/modules/logger/pino/backing.js.map +1 -1
  47. package/dist/esm/modules/logger/pino/destination.d.ts +1 -1
  48. package/dist/esm/modules/logger/pino/destination.js.map +1 -1
  49. package/dist/esm/modules/logger/pino/logger.d.ts +1 -2
  50. package/dist/esm/modules/logger/pino/logger.js.map +1 -1
  51. package/dist/esm/modules/logger/winston/formats.js +2 -2
  52. package/dist/esm/modules/logger/winston/formats.js.map +1 -1
  53. package/dist/esm/modules/logger/winston/logger.d.ts +1 -2
  54. package/dist/esm/modules/logger/winston/logger.js.map +1 -1
  55. package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts +1 -1
  56. package/dist/esm/modules/logger/winston/transports/dgram.transport.js +1 -1
  57. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  58. package/dist/esm/modules/network/http-request/common/constants.d.ts +0 -2
  59. package/dist/esm/modules/network/http-request/common/constants.js +0 -4
  60. package/dist/esm/modules/network/http-request/common/constants.js.map +1 -1
  61. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts +6 -6
  62. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  63. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +2 -3
  64. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  65. package/dist/esm/modules/network/http-request/fetcher/common/types.d.ts +1 -1
  66. package/dist/esm/modules/network/http-request/fetcher/common/types.js.map +1 -1
  67. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +1 -2
  68. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +5 -6
  69. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  70. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.d.ts +4 -4
  71. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
  72. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  73. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts +3 -5
  74. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +0 -8
  75. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  76. package/dist/esm/modules/network/utilities/query-string.d.ts +2 -2
  77. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  78. package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts +0 -2
  79. package/dist/esm/modules/network/utilities/url-safety/common/constants.js +0 -4
  80. package/dist/esm/modules/network/utilities/url-safety/common/constants.js.map +1 -1
  81. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  82. package/dist/esm/modules/queue/bullmq/helper.d.ts +23 -10
  83. package/dist/esm/modules/queue/bullmq/helper.js +57 -10
  84. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  85. package/dist/esm/modules/queue/common/constants.d.ts +6 -2
  86. package/dist/esm/modules/queue/common/constants.js +6 -4
  87. package/dist/esm/modules/queue/common/constants.js.map +1 -1
  88. package/dist/esm/modules/queue/internal/sequential/common/types.d.ts +2 -4
  89. package/dist/esm/modules/queue/internal/sequential/common/types.js +0 -4
  90. package/dist/esm/modules/queue/internal/sequential/common/types.js.map +1 -1
  91. package/dist/esm/modules/queue/kafka/base.d.ts +1 -1
  92. package/dist/esm/modules/queue/kafka/base.js +13 -2
  93. package/dist/esm/modules/queue/kafka/base.js.map +1 -1
  94. package/dist/esm/modules/queue/kafka/common/constants.d.ts +0 -4
  95. package/dist/esm/modules/queue/kafka/common/constants.js +0 -8
  96. package/dist/esm/modules/queue/kafka/common/constants.js.map +1 -1
  97. package/dist/esm/modules/redis/base/abstract.helper.d.ts +13 -2
  98. package/dist/esm/modules/redis/base/abstract.helper.js +53 -45
  99. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  100. package/dist/esm/modules/redis/cluster/cluster.helper.d.ts +1 -2
  101. package/dist/esm/modules/redis/cluster/cluster.helper.js +21 -9
  102. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  103. package/dist/esm/modules/redis/cluster/index.d.ts +1 -0
  104. package/dist/esm/modules/redis/cluster/index.js +1 -0
  105. package/dist/esm/modules/redis/cluster/index.js.map +1 -1
  106. package/dist/esm/modules/redis/cluster/types.d.ts +20 -0
  107. package/dist/esm/modules/redis/cluster/types.js +2 -0
  108. package/dist/esm/modules/redis/cluster/types.js.map +1 -0
  109. package/dist/esm/modules/redis/common/constants.d.ts +15 -19
  110. package/dist/esm/modules/redis/common/constants.js +16 -18
  111. package/dist/esm/modules/redis/common/constants.js.map +1 -1
  112. package/dist/esm/modules/redis/common/types.d.ts +10 -60
  113. package/dist/esm/modules/redis/common/types.js.map +1 -1
  114. package/dist/esm/modules/redis/factory.d.ts +7 -25
  115. package/dist/esm/modules/redis/factory.js +9 -18
  116. package/dist/esm/modules/redis/factory.js.map +1 -1
  117. package/dist/esm/modules/redis/sentinel/constants.d.ts +14 -0
  118. package/dist/esm/modules/redis/sentinel/constants.js +11 -0
  119. package/dist/esm/modules/redis/sentinel/constants.js.map +1 -0
  120. package/dist/esm/modules/redis/sentinel/index.d.ts +2 -0
  121. package/dist/esm/modules/redis/sentinel/index.js +2 -0
  122. package/dist/esm/modules/redis/sentinel/index.js.map +1 -1
  123. package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts +1 -2
  124. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +25 -15
  125. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  126. package/dist/esm/modules/redis/sentinel/types.d.ts +26 -0
  127. package/dist/esm/modules/redis/sentinel/types.js +2 -0
  128. package/dist/esm/modules/redis/sentinel/types.js.map +1 -0
  129. package/dist/esm/modules/redis/single/index.d.ts +1 -0
  130. package/dist/esm/modules/redis/single/index.js +1 -0
  131. package/dist/esm/modules/redis/single/index.js.map +1 -1
  132. package/dist/esm/modules/redis/single/single.helper.d.ts +1 -2
  133. package/dist/esm/modules/redis/single/single.helper.js +5 -6
  134. package/dist/esm/modules/redis/single/single.helper.js.map +1 -1
  135. package/dist/esm/modules/redis/single/types.d.ts +15 -0
  136. package/dist/esm/modules/redis/single/types.js +2 -0
  137. package/dist/esm/modules/redis/single/types.js.map +1 -0
  138. package/dist/esm/modules/secrets/base/abstract.helper.js +6 -1
  139. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  140. package/dist/esm/modules/secrets/common/types/registration.d.ts +25 -6
  141. package/dist/esm/modules/secrets/common/types/registration.js.map +1 -1
  142. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js +1 -1
  143. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js.map +1 -1
  144. package/dist/esm/modules/secrets/factory.js +7 -6
  145. package/dist/esm/modules/secrets/factory.js.map +1 -1
  146. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts +12 -10
  147. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +50 -25
  148. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  149. package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -1
  150. package/dist/esm/modules/socket/socket-io/common/types/client.d.ts +2 -2
  151. package/dist/esm/modules/socket/socket-io/common/types/client.js.map +1 -1
  152. package/dist/esm/modules/socket/socket-io/common/types/server.d.ts +3 -1
  153. package/dist/esm/modules/socket/socket-io/common/types/server.js.map +1 -1
  154. package/dist/esm/modules/socket/socket-io/server/helper.d.ts +2 -2
  155. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  156. package/dist/esm/modules/storage/base.d.ts +24 -60
  157. package/dist/esm/modules/storage/base.js +66 -123
  158. package/dist/esm/modules/storage/base.js.map +1 -1
  159. package/dist/esm/modules/storage/bun-s3/helper.d.ts +21 -35
  160. package/dist/esm/modules/storage/bun-s3/helper.js +126 -128
  161. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  162. package/dist/esm/modules/storage/bun-s3/utility.d.ts +13 -7
  163. package/dist/esm/modules/storage/bun-s3/utility.js +63 -45
  164. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  165. package/dist/esm/modules/storage/common/constants.d.ts +29 -2
  166. package/dist/esm/modules/storage/common/constants.js +29 -4
  167. package/dist/esm/modules/storage/common/constants.js.map +1 -1
  168. package/dist/esm/modules/storage/common/errors.d.ts +9 -0
  169. package/dist/esm/modules/storage/common/errors.js +9 -0
  170. package/dist/esm/modules/storage/common/errors.js.map +1 -1
  171. package/dist/esm/modules/storage/common/types.d.ts +90 -61
  172. package/dist/esm/modules/storage/common/types.js.map +1 -1
  173. package/dist/esm/modules/storage/common/utility.d.ts +8 -0
  174. package/dist/esm/modules/storage/common/utility.js +14 -2
  175. package/dist/esm/modules/storage/common/utility.js.map +1 -1
  176. package/dist/esm/modules/storage/disk/helper.d.ts +3 -8
  177. package/dist/esm/modules/storage/disk/helper.js +1 -0
  178. package/dist/esm/modules/storage/disk/helper.js.map +1 -1
  179. package/dist/esm/modules/storage/in-memory/helper.d.ts +2 -3
  180. package/dist/esm/modules/storage/in-memory/helper.js.map +1 -1
  181. package/dist/esm/modules/worker-thread/common/types.d.ts +2 -2
  182. package/dist/esm/modules/worker-thread/common/types.js.map +1 -1
  183. package/dist/esm/modules/worker-thread/thread/abstract.d.ts +2 -2
  184. package/dist/esm/modules/worker-thread/thread/abstract.js.map +1 -1
  185. package/dist/esm/modules/worker-thread/worker-pool.d.ts +1 -1
  186. package/dist/esm/modules/worker-thread/worker-pool.js.map +1 -1
  187. package/dist/esm/utilities/module.utility.d.ts +8 -5
  188. package/dist/esm/utilities/module.utility.js +5 -1
  189. package/dist/esm/utilities/module.utility.js.map +1 -1
  190. package/dist/esm/utilities/parse.utility.d.ts +34 -6
  191. package/dist/esm/utilities/parse.utility.js +82 -15
  192. package/dist/esm/utilities/parse.utility.js.map +1 -1
  193. package/dist/esm/utilities/performance.utility.d.ts +3 -3
  194. package/dist/esm/utilities/performance.utility.js.map +1 -1
  195. package/dist/esm/utilities/promise.utility.d.ts +1 -1
  196. package/dist/esm/utilities/promise.utility.js.map +1 -1
  197. package/dist/esm/utilities/request.utility.d.ts +9 -11
  198. package/dist/esm/utilities/request.utility.js.map +1 -1
  199. package/package.json +3 -3
@@ -1,3 +1,4 @@
1
+ import { type THttpMethod } from '../../../common/constants/http.js';
1
2
  export declare class S3SignatureUtility {
2
3
  private static hmacSHA256;
3
4
  private static toHex;
@@ -10,6 +11,7 @@ export declare class S3SignatureUtility {
10
11
  static buildCopySource(opts: {
11
12
  bucket: string;
12
13
  key: string;
14
+ versionId?: string;
13
15
  }): string;
14
16
  /** Empty or absent query must sign identically to today - callers of getBuckets/createBucket/removeBucket depend on it. */
15
17
  private static buildCanonicalQueryString;
@@ -17,8 +19,11 @@ export declare class S3SignatureUtility {
17
19
  private static deriveSigningKey;
18
20
  /** `20130524T000000Z` and its `20130524` prefix - the two forms every signature needs. */
19
21
  private static toAmzDate;
22
+ private static buildCredentialScope;
23
+ /** Lower-cases each header name into `target` and leaves out a header whose value is `undefined`. */
24
+ private static addSignedHeaders;
20
25
  static buildSignedRequest(opts: {
21
- method: string;
26
+ method: THttpMethod;
22
27
  endpoint: string;
23
28
  path: string;
24
29
  accessKey: string;
@@ -26,9 +31,10 @@ export declare class S3SignatureUtility {
26
31
  region: string;
27
32
  sessionToken?: string;
28
33
  body?: string;
29
- query?: Record<string, string>;
30
- /** Extra headers to SIGN, not merely to send - anything outside `SignedHeaders` is refused by S3. */
31
- headers?: Record<string, string>;
34
+ /** A key whose value is `undefined` is left out. */
35
+ query?: Record<string, string | undefined>;
36
+ /** Extra headers to SIGN, not merely to send - anything outside `SignedHeaders` is refused by S3. A key whose value is `undefined` is left out. */
37
+ headers?: Record<string, string | undefined>;
32
38
  }): Promise<{
33
39
  url: string;
34
40
  headers: Record<string, string>;
@@ -80,7 +86,7 @@ export declare class S3SignatureUtility {
80
86
  * size; for a ceiling, use {@link S3SignatureUtility.buildPostPolicy}.
81
87
  */
82
88
  static buildPresignedUrl(opts: {
83
- method: string;
89
+ method: THttpMethod;
84
90
  endpoint: string;
85
91
  path: string;
86
92
  accessKey: string;
@@ -88,8 +94,8 @@ export declare class S3SignatureUtility {
88
94
  region: string;
89
95
  sessionToken?: string;
90
96
  expiresInSeconds: number;
91
- /** Headers to SIGN. The client must send each one unchanged, or S3 answers 403. */
92
- headers?: Record<string, string>;
97
+ /** Headers to SIGN. The client must send each one unchanged, or S3 answers 403. A key whose value is `undefined` is left out. */
98
+ headers?: Record<string, string | undefined>;
93
99
  /** A fixed clock, so a signature can be checked against a published test vector. */
94
100
  now?: Date;
95
101
  }): Promise<string>;
@@ -1,5 +1,7 @@
1
1
  // Minimal AWS Signature V4 helpers for bucket-management operations (object ops use Bun's S3Client natively).
2
+ import { HTTP } from '../../../common/constants/http.js';
2
3
  import { getError } from '../../error/index.js';
4
+ import { S3Headers, S3Signing } from '../common/index.js';
3
5
  export class S3SignatureUtility {
4
6
  static async hmacSHA256(opts) {
5
7
  const { key, data } = opts;
@@ -30,7 +32,10 @@ export class S3SignatureUtility {
30
32
  }
31
33
  /** `x-amz-copy-source`: S3 URL-decodes it once and splits `?versionId=` off, so a raw `?`, `%` or `+` names another object and a non-Latin-1 key is not a legal header value. */
32
34
  static buildCopySource(opts) {
33
- return S3SignatureUtility.encodeSigV4Path({ path: `/${opts.bucket}/${opts.key}` });
35
+ const source = S3SignatureUtility.encodeSigV4Path({ path: `/${opts.bucket}/${opts.key}` });
36
+ return opts.versionId === undefined
37
+ ? source
38
+ : `${source}?versionId=${S3SignatureUtility.encodeSigV4Component({ value: opts.versionId })}`;
34
39
  }
35
40
  /** Empty or absent query must sign identically to today - callers of getBuckets/createBucket/removeBucket depend on it. */
36
41
  static buildCanonicalQueryString(opts) {
@@ -38,13 +43,13 @@ export class S3SignatureUtility {
38
43
  if (!query) {
39
44
  return '';
40
45
  }
41
- const keys = Object.keys(query);
46
+ const keys = Object.keys(query).filter((key) => query[key] !== undefined);
42
47
  if (keys.length === 0) {
43
48
  return '';
44
49
  }
45
50
  return keys
46
51
  .sort()
47
- .map((key) => `${S3SignatureUtility.encodeSigV4Component({ value: key })}=${S3SignatureUtility.encodeSigV4Component({ value: query[key] })}`)
52
+ .map((key) => `${S3SignatureUtility.encodeSigV4Component({ value: key })}=${S3SignatureUtility.encodeSigV4Component({ value: query[key] ?? '' })}`)
48
53
  .join('&');
49
54
  }
50
55
  /** The SigV4 four-step chain. Each step keys the next, so the final key is bound to date, region and service. */
@@ -55,8 +60,11 @@ export class S3SignatureUtility {
55
60
  data: dateStamp,
56
61
  });
57
62
  const regionKey = await S3SignatureUtility.hmacSHA256({ key: dateKey, data: region });
58
- const serviceKey = await S3SignatureUtility.hmacSHA256({ key: regionKey, data: 's3' });
59
- return S3SignatureUtility.hmacSHA256({ key: serviceKey, data: 'aws4_request' });
63
+ const serviceKey = await S3SignatureUtility.hmacSHA256({
64
+ key: regionKey,
65
+ data: S3Signing.SERVICE,
66
+ });
67
+ return S3SignatureUtility.hmacSHA256({ key: serviceKey, data: S3Signing.REQUEST_TYPE });
60
68
  }
61
69
  /** `20130524T000000Z` and its `20130524` prefix - the two forms every signature needs. */
62
70
  static toAmzDate(opts) {
@@ -66,6 +74,17 @@ export class S3SignatureUtility {
66
74
  .replace(/\.\d{3}Z$/, 'Z');
67
75
  return { amzDate, dateStamp: amzDate.slice(0, 8) };
68
76
  }
77
+ static buildCredentialScope(opts) {
78
+ return `${opts.dateStamp}/${opts.region}/${S3Signing.SERVICE}/${S3Signing.REQUEST_TYPE}`;
79
+ }
80
+ /** Lower-cases each header name into `target` and leaves out a header whose value is `undefined`. */
81
+ static addSignedHeaders(opts) {
82
+ for (const [key, value] of Object.entries(opts.headers ?? {})) {
83
+ if (value !== undefined) {
84
+ opts.target[key.toLowerCase()] = opts.trim ? value.trim() : value;
85
+ }
86
+ }
87
+ }
69
88
  static async buildSignedRequest(opts) {
70
89
  const { method, endpoint, path, accessKey, secretKey, region, sessionToken, body = '', query, headers: extraHeaders, } = opts;
71
90
  const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now: new Date() });
@@ -76,35 +95,32 @@ export class S3SignatureUtility {
76
95
  const host = new URL(endpoint).host;
77
96
  const payloadHash = await S3SignatureUtility.sha256Hex({ data: body });
78
97
  const canonicalHeadersMap = {
79
- host,
80
- 'x-amz-content-sha256': payloadHash,
81
- 'x-amz-date': amzDate,
98
+ [HTTP.Headers.HOST]: host,
99
+ [S3Headers.CONTENT_SHA256]: payloadHash,
100
+ [S3Headers.DATE]: amzDate,
82
101
  };
83
102
  if (sessionToken) {
84
- canonicalHeadersMap['x-amz-security-token'] = sessionToken;
85
- }
86
- const extraHeadersEntries = Object.entries(extraHeaders ?? {});
87
- for (const [key, value] of extraHeadersEntries) {
88
- canonicalHeadersMap[key.toLowerCase()] = value;
103
+ canonicalHeadersMap[S3Headers.SECURITY_TOKEN] = sessionToken;
89
104
  }
105
+ S3SignatureUtility.addSignedHeaders({ target: canonicalHeadersMap, headers: extraHeaders });
90
106
  const sortedKeys = Object.keys(canonicalHeadersMap).sort();
91
107
  const canonicalHeaders = sortedKeys.map((k) => `${k}:${canonicalHeadersMap[k]}\n`).join('');
92
108
  const signedHeaders = sortedKeys.join(';');
93
109
  const canonicalRequest = [
94
- method,
110
+ method.toUpperCase(),
95
111
  canonicalPath,
96
112
  canonicalQueryString,
97
113
  canonicalHeaders,
98
114
  signedHeaders,
99
115
  payloadHash,
100
116
  ].join('\n');
101
- const credentialScope = `${dateStamp}/${region}/s3/aws4_request`;
117
+ const credentialScope = S3SignatureUtility.buildCredentialScope({ dateStamp, region });
102
118
  const result = await S3SignatureUtility.sha256Hex({ data: canonicalRequest });
103
- const stringToSign = ['AWS4-HMAC-SHA256', amzDate, credentialScope, result].join('\n');
119
+ const stringToSign = [S3Signing.ALGORITHM, amzDate, credentialScope, result].join('\n');
104
120
  const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });
105
121
  const result2 = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: stringToSign });
106
122
  const signature = S3SignatureUtility.toHex({ bytes: result2 });
107
- const authHeader = `AWS4-HMAC-SHA256 Credential=${accessKey}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;
123
+ const authHeader = `${S3Signing.ALGORITHM} Credential=${accessKey}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;
108
124
  const contentLength = String(new TextEncoder().encode(body).length);
109
125
  return {
110
126
  url,
@@ -182,36 +198,38 @@ export class S3SignatureUtility {
182
198
  const { bucket, key, maxBytes, expiresInSeconds, accessKey, secretKey, region, sessionToken, contentType, } = opts;
183
199
  const now = new Date();
184
200
  const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now });
185
- const credentialScope = `${dateStamp}/${region}/s3/aws4_request`;
186
- const credential = `${accessKey}/${credentialScope}`;
201
+ const credential = `${accessKey}/${S3SignatureUtility.buildCredentialScope({ dateStamp, region })}`;
187
202
  const expiresAt = new Date(now.getTime() + expiresInSeconds * 1000).toISOString();
188
203
  // Every field the browser posts must ALSO be a condition, or S3 refuses the form it just signed.
189
204
  const fields = {
190
- 'x-amz-algorithm': 'AWS4-HMAC-SHA256',
205
+ 'x-amz-algorithm': S3Signing.ALGORITHM,
191
206
  'x-amz-credential': credential,
192
- 'x-amz-date': amzDate,
193
- ...(sessionToken ? { 'x-amz-security-token': sessionToken } : {}),
207
+ [S3Headers.DATE]: amzDate,
194
208
  };
209
+ if (sessionToken) {
210
+ fields[S3Headers.SECURITY_TOKEN] = sessionToken;
211
+ }
195
212
  const conditions = [
196
213
  { bucket },
197
214
  { key },
198
215
  ['content-length-range', 0, maxBytes],
199
216
  ...Object.entries(fields).map(([fieldName, fieldValue]) => ({ [fieldName]: fieldValue })),
200
- ...(contentType ? [{ 'Content-Type': contentType }] : []),
201
217
  ];
218
+ // The form field is spelled `Content-Type`; a policy condition matches it case-sensitively.
219
+ const typeField = 'Content-Type';
220
+ if (contentType) {
221
+ conditions.push({ [typeField]: contentType });
222
+ }
202
223
  const policy = Buffer.from(JSON.stringify({ expiration: expiresAt, conditions })).toString('base64');
203
224
  const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });
204
225
  const result = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: policy });
205
- return {
206
- formData: {
207
- key,
208
- ...fields,
209
- ...(contentType ? { 'Content-Type': contentType } : {}),
210
- policy,
211
- 'x-amz-signature': S3SignatureUtility.toHex({ bytes: result }),
212
- },
213
- expiresAt,
214
- };
226
+ const formData = { key, ...fields };
227
+ if (contentType) {
228
+ formData[typeField] = contentType;
229
+ }
230
+ formData.policy = policy;
231
+ formData['x-amz-signature'] = S3SignatureUtility.toHex({ bytes: result });
232
+ return { formData, expiresAt };
215
233
  }
216
234
  /**
217
235
  * A presigned URL: the credential travels in the QUERY, so a browser needs no `Authorization` header.
@@ -224,40 +242,40 @@ export class S3SignatureUtility {
224
242
  static async buildPresignedUrl(opts) {
225
243
  const { method, endpoint, path, accessKey, secretKey, region, sessionToken, expiresInSeconds, headers, now = new Date(), } = opts;
226
244
  const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now });
227
- const credentialScope = `${dateStamp}/${region}/s3/aws4_request`;
245
+ const credentialScope = S3SignatureUtility.buildCredentialScope({ dateStamp, region });
228
246
  const canonicalPath = S3SignatureUtility.encodeSigV4Path({ path });
229
247
  const origin = endpoint.replace(/\/$/, '');
230
- // SigV4 compares header values after trimming, so signing an untrimmed one answers 403.
231
- const canonicalHeadersMap = { host: new URL(origin).host };
232
- const signedEntries = Object.entries(headers ?? {});
233
- for (const [key, value] of signedEntries) {
234
- canonicalHeadersMap[key.toLowerCase()] = String(value).trim();
235
- }
248
+ const canonicalHeadersMap = {
249
+ [HTTP.Headers.HOST]: new URL(origin).host,
250
+ };
251
+ S3SignatureUtility.addSignedHeaders({ target: canonicalHeadersMap, headers, trim: true });
236
252
  const sortedKeys = Object.keys(canonicalHeadersMap).sort();
237
253
  const signedHeaders = sortedKeys.join(';');
238
254
  // `X-Amz-SignedHeaders` is itself signed, so the header list has to be settled before the query.
239
255
  const queryParameters = {
240
- 'X-Amz-Algorithm': 'AWS4-HMAC-SHA256',
256
+ 'X-Amz-Algorithm': S3Signing.ALGORITHM,
241
257
  'X-Amz-Credential': `${accessKey}/${credentialScope}`,
242
258
  'X-Amz-Date': amzDate,
243
259
  'X-Amz-Expires': String(expiresInSeconds),
244
260
  'X-Amz-SignedHeaders': signedHeaders,
245
- ...(sessionToken ? { 'X-Amz-Security-Token': sessionToken } : {}),
246
261
  };
262
+ if (sessionToken) {
263
+ queryParameters['X-Amz-Security-Token'] = sessionToken;
264
+ }
247
265
  const canonicalQueryString = S3SignatureUtility.buildCanonicalQueryString({
248
266
  query: queryParameters,
249
267
  });
250
268
  // A presigned URL is signed before its body exists, so the payload is excluded by name.
251
269
  const canonicalRequest = [
252
- method,
270
+ method.toUpperCase(),
253
271
  canonicalPath,
254
272
  canonicalQueryString,
255
273
  sortedKeys.map((key) => `${key}:${canonicalHeadersMap[key]}\n`).join(''),
256
274
  signedHeaders,
257
- 'UNSIGNED-PAYLOAD',
275
+ S3Signing.UNSIGNED_PAYLOAD,
258
276
  ].join('\n');
259
277
  const result = await S3SignatureUtility.sha256Hex({ data: canonicalRequest });
260
- const stringToSign = ['AWS4-HMAC-SHA256', amzDate, credentialScope, result].join('\n');
278
+ const stringToSign = [S3Signing.ALGORITHM, amzDate, credentialScope, result].join('\n');
261
279
  const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });
262
280
  const result2 = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: stringToSign });
263
281
  const signature = S3SignatureUtility.toHex({ bytes: result2 });
@@ -1 +1 @@
1
- {"version":3,"file":"utility.js","sourceRoot":"","sources":["../../../../../src/modules/storage/bun-s3/utility.ts"],"names":[],"mappings":"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","sourcesContent":["// Minimal AWS Signature V4 helpers for bucket-management operations (object ops use Bun's S3Client natively).\n\nimport { getError } from '@/modules/error';\n\nexport class S3SignatureUtility {\n private static async hmacSHA256(opts: {\n key: Uint8Array<ArrayBuffer> | string;\n data: string;\n }): Promise<Uint8Array<ArrayBuffer>> {\n const { key, data } = opts;\n const rawKey = typeof key === 'string' ? new TextEncoder().encode(key) : key;\n const cryptoKey = await crypto.subtle.importKey(\n 'raw',\n rawKey,\n { name: 'HMAC', hash: 'SHA-256' },\n false,\n ['sign'],\n );\n const signature = await crypto.subtle.sign('HMAC', cryptoKey, new TextEncoder().encode(data));\n\n return new Uint8Array(signature);\n }\n\n private static toHex(opts: { bytes: Uint8Array }): string {\n return Array.from(opts.bytes)\n .map((byte) => byte.toString(16).padStart(2, '0'))\n .join('');\n }\n\n private static async sha256Hex(opts: { data: string }): Promise<string> {\n const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(opts.data));\n\n return S3SignatureUtility.toHex({ bytes: new Uint8Array(digest) });\n }\n\n /** SigV4 canonical form needs every reserved character `encodeURIComponent` leaves untouched also percent-encoded. */\n private static encodeSigV4Component(opts: { value: string }): string {\n return encodeURIComponent(opts.value).replace(\n /[!'()*]/g,\n (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`,\n );\n }\n\n /** Signing the raw path answers 403 SignatureDoesNotMatch, because `fetch` encodes it on the wire. Separators stay literal. */\n private static encodeSigV4Path(opts: { path: string }): string {\n return opts.path\n .split('/')\n .map((segment) => S3SignatureUtility.encodeSigV4Component({ value: segment }))\n .join('/');\n }\n\n /** `x-amz-copy-source`: S3 URL-decodes it once and splits `?versionId=` off, so a raw `?`, `%` or `+` names another object and a non-Latin-1 key is not a legal header value. */\n static buildCopySource(opts: { bucket: string; key: string }): string {\n return S3SignatureUtility.encodeSigV4Path({ path: `/${opts.bucket}/${opts.key}` });\n }\n\n /** Empty or absent query must sign identically to today - callers of getBuckets/createBucket/removeBucket depend on it. */\n private static buildCanonicalQueryString(opts: { query?: Record<string, string> }): string {\n const { query } = opts;\n\n if (!query) {\n return '';\n }\n\n const keys = Object.keys(query);\n\n if (keys.length === 0) {\n return '';\n }\n\n return keys\n .sort()\n .map(\n (key) =>\n `${S3SignatureUtility.encodeSigV4Component({ value: key })}=${S3SignatureUtility.encodeSigV4Component({ value: query[key] })}`,\n )\n .join('&');\n }\n\n /** The SigV4 four-step chain. Each step keys the next, so the final key is bound to date, region and service. */\n private static async deriveSigningKey(opts: {\n secretKey: string;\n dateStamp: string;\n region: string;\n }): Promise<Uint8Array<ArrayBuffer>> {\n const { secretKey, dateStamp, region } = opts;\n const dateKey = await S3SignatureUtility.hmacSHA256({\n key: `AWS4${secretKey}`,\n data: dateStamp,\n });\n const regionKey = await S3SignatureUtility.hmacSHA256({ key: dateKey, data: region });\n const serviceKey = await S3SignatureUtility.hmacSHA256({ key: regionKey, data: 's3' });\n\n return S3SignatureUtility.hmacSHA256({ key: serviceKey, data: 'aws4_request' });\n }\n\n /** `20130524T000000Z` and its `20130524` prefix - the two forms every signature needs. */\n private static toAmzDate(opts: { now: Date }): { amzDate: string; dateStamp: string } {\n const amzDate = opts.now\n .toISOString()\n .replace(/[-:]/g, '')\n .replace(/\\.\\d{3}Z$/, 'Z');\n\n return { amzDate, dateStamp: amzDate.slice(0, 8) };\n }\n\n static async buildSignedRequest(opts: {\n method: string;\n endpoint: string;\n path: string;\n accessKey: string;\n secretKey: string;\n region: string;\n sessionToken?: string;\n body?: string;\n query?: Record<string, string>;\n /** Extra headers to SIGN, not merely to send - anything outside `SignedHeaders` is refused by S3. */\n headers?: Record<string, string>;\n }): Promise<{ url: string; headers: Record<string, string> }> {\n const {\n method,\n endpoint,\n path,\n accessKey,\n secretKey,\n region,\n sessionToken,\n body = '',\n query,\n headers: extraHeaders,\n } = opts;\n\n const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now: new Date() });\n\n const canonicalQueryString = S3SignatureUtility.buildCanonicalQueryString({ query });\n const canonicalPath = S3SignatureUtility.encodeSigV4Path({ path });\n const baseUrl = `${endpoint.replace(/\\/$/, '')}${canonicalPath}`;\n const url = canonicalQueryString ? `${baseUrl}?${canonicalQueryString}` : baseUrl;\n const host = new URL(endpoint).host;\n const payloadHash = await S3SignatureUtility.sha256Hex({ data: body });\n\n const canonicalHeadersMap: Record<string, string> = {\n host,\n 'x-amz-content-sha256': payloadHash,\n 'x-amz-date': amzDate,\n };\n\n if (sessionToken) {\n canonicalHeadersMap['x-amz-security-token'] = sessionToken;\n }\n\n const extraHeadersEntries = Object.entries(extraHeaders ?? {});\n\n for (const [key, value] of extraHeadersEntries) {\n canonicalHeadersMap[key.toLowerCase()] = value;\n }\n\n const sortedKeys = Object.keys(canonicalHeadersMap).sort();\n const canonicalHeaders = sortedKeys.map((k) => `${k}:${canonicalHeadersMap[k]}\\n`).join('');\n const signedHeaders = sortedKeys.join(';');\n\n const canonicalRequest = [\n method,\n canonicalPath,\n canonicalQueryString,\n canonicalHeaders,\n signedHeaders,\n payloadHash,\n ].join('\\n');\n\n const credentialScope = `${dateStamp}/${region}/s3/aws4_request`;\n const result = await S3SignatureUtility.sha256Hex({ data: canonicalRequest });\n const stringToSign = ['AWS4-HMAC-SHA256', amzDate, credentialScope, result].join('\\n');\n\n const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });\n const result2 = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: stringToSign });\n const signature = S3SignatureUtility.toHex({ bytes: result2 });\n\n const authHeader = `AWS4-HMAC-SHA256 Credential=${accessKey}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;\n const contentLength = String(new TextEncoder().encode(body).length);\n\n return {\n url,\n headers: {\n ...canonicalHeadersMap,\n Authorization: authHeader,\n 'Content-Length': contentLength,\n },\n };\n }\n\n private static escapeXmlText(opts: { value: string }): string {\n return opts.value\n .replace(/&/g, '&amp;')\n .replace(/</g, '&lt;')\n .replace(/>/g, '&gt;')\n .replace(/\"/g, '&quot;')\n .replace(/'/g, '&apos;');\n }\n\n /** `&amp;` decodes LAST - a literal `&lt;` in the source text must not turn into `<` through the `&amp;` step. */\n private static unescapeXmlText(opts: { value: string }): string {\n return opts.value\n .replace(/&lt;/g, '<')\n .replace(/&gt;/g, '>')\n .replace(/&quot;/g, '\"')\n .replace(/&apos;/g, \"'\")\n .replace(/&amp;/g, '&');\n }\n\n /** S3's PUT tagging body - no XML dependency, so this is hand-built rather than templated by a library. */\n static buildTaggingXml(opts: { tags: Record<string, string> }): string {\n const tagEntries = Object.entries(opts.tags)\n .map(\n ([key, value]) =>\n `<Tag><Key>${S3SignatureUtility.escapeXmlText({ value: key })}</Key><Value>${S3SignatureUtility.escapeXmlText({ value })}</Value></Tag>`,\n )\n .join('');\n\n return `<Tagging><TagSet>${tagEntries}</TagSet></Tagging>`;\n }\n\n /** The `x-amz-tagging` header: a URL-encoded query string, unlike the XML the tagging API takes. */\n static buildTaggingHeader(opts: { tags: Record<string, string> }): string {\n return Object.entries(opts.tags)\n .map(\n ([key, value]) =>\n `${S3SignatureUtility.encodeSigV4Component({ value: key })}=${S3SignatureUtility.encodeSigV4Component({ value })}`,\n )\n .join('&');\n }\n\n /** S3's GET tagging response - hand-parsed rather than a full XML parser; throws rather than returning a half-parsed object. */\n static parseTaggingXml(opts: { xml: string }): Record<string, string> {\n const { xml } = opts;\n const trimmed = xml.trim();\n\n if (/<TagSet\\s*\\/>/.test(trimmed) || /<TagSet>\\s*<\\/TagSet>/.test(trimmed)) {\n return {};\n }\n\n const tagSetMatch = trimmed.match(/<TagSet>([\\s\\S]*?)<\\/TagSet>/);\n\n if (!tagSetMatch) {\n throw getError({ message: `[parseTaggingXml] Malformed tagging response | body: ${xml}` });\n }\n\n const tags: Record<string, string> = {};\n const tagMatches = tagSetMatch[1].matchAll(/<Tag>([\\s\\S]*?)<\\/Tag>/g);\n\n for (const tagMatch of tagMatches) {\n const keyMatch = tagMatch[1].match(/<Key>([\\s\\S]*?)<\\/Key>/);\n const valueMatch = tagMatch[1].match(/<Value>([\\s\\S]*?)<\\/Value>/);\n\n if (!keyMatch || !valueMatch) {\n throw getError({ message: `[parseTaggingXml] Malformed tag entry | body: ${xml}` });\n }\n\n const key = S3SignatureUtility.unescapeXmlText({ value: keyMatch[1].trim() });\n const value = S3SignatureUtility.unescapeXmlText({ value: valueMatch[1].trim() });\n tags[key] = value;\n }\n\n return tags;\n }\n\n /**\n * A signed POST policy: the form a browser posts straight to S3.\n *\n * This is not a presigned PUT and the difference is the point. A signed PUT binds each header to an\n * EXACT value, so `content-length` names one byte count and never a ceiling - every retry or\n * re-encode becomes an opaque 403. A policy carries `content-length-range`, so \"at most N bytes\" is\n * expressible at all.\n */\n static async buildPostPolicy(opts: {\n bucket: string;\n /** The ONE key the form may be posted under. */\n key: string;\n maxBytes: number;\n expiresInSeconds: number;\n accessKey: string;\n secretKey: string;\n region: string;\n sessionToken?: string;\n contentType?: string;\n }): Promise<{ formData: Record<string, string>; expiresAt: string }> {\n const {\n bucket,\n key,\n maxBytes,\n expiresInSeconds,\n accessKey,\n secretKey,\n region,\n sessionToken,\n contentType,\n } = opts;\n\n const now = new Date();\n const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now });\n const credentialScope = `${dateStamp}/${region}/s3/aws4_request`;\n const credential = `${accessKey}/${credentialScope}`;\n const expiresAt = new Date(now.getTime() + expiresInSeconds * 1000).toISOString();\n\n // Every field the browser posts must ALSO be a condition, or S3 refuses the form it just signed.\n const fields: Record<string, string> = {\n 'x-amz-algorithm': 'AWS4-HMAC-SHA256',\n 'x-amz-credential': credential,\n 'x-amz-date': amzDate,\n ...(sessionToken ? { 'x-amz-security-token': sessionToken } : {}),\n };\n\n const conditions: unknown[] = [\n { bucket },\n { key },\n ['content-length-range', 0, maxBytes],\n ...Object.entries(fields).map(([fieldName, fieldValue]) => ({ [fieldName]: fieldValue })),\n ...(contentType ? [{ 'Content-Type': contentType }] : []),\n ];\n\n const policy = Buffer.from(JSON.stringify({ expiration: expiresAt, conditions })).toString(\n 'base64',\n );\n\n const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });\n\n const result = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: policy });\n\n return {\n formData: {\n key,\n ...fields,\n ...(contentType ? { 'Content-Type': contentType } : {}),\n policy,\n 'x-amz-signature': S3SignatureUtility.toHex({ bytes: result }),\n },\n expiresAt,\n };\n }\n\n /**\n * A presigned URL: the credential travels in the QUERY, so a browser needs no `Authorization` header.\n *\n * `headers` is what `S3Client.presign` cannot do. Anything named there is inside the signature and\n * listed in `X-Amz-SignedHeaders`, so the client must send it back byte for byte. A signature\n * expresses equality and nothing else, so a pinned `content-length` rejects every retry at another\n * size; for a ceiling, use {@link S3SignatureUtility.buildPostPolicy}.\n */\n static async buildPresignedUrl(opts: {\n method: string;\n endpoint: string;\n path: string;\n accessKey: string;\n secretKey: string;\n region: string;\n sessionToken?: string;\n expiresInSeconds: number;\n /** Headers to SIGN. The client must send each one unchanged, or S3 answers 403. */\n headers?: Record<string, string>;\n /** A fixed clock, so a signature can be checked against a published test vector. */\n now?: Date;\n }): Promise<string> {\n const {\n method,\n endpoint,\n path,\n accessKey,\n secretKey,\n region,\n sessionToken,\n expiresInSeconds,\n headers,\n now = new Date(),\n } = opts;\n\n const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now });\n const credentialScope = `${dateStamp}/${region}/s3/aws4_request`;\n const canonicalPath = S3SignatureUtility.encodeSigV4Path({ path });\n const origin = endpoint.replace(/\\/$/, '');\n\n // SigV4 compares header values after trimming, so signing an untrimmed one answers 403.\n const canonicalHeadersMap: Record<string, string> = { host: new URL(origin).host };\n const signedEntries = Object.entries(headers ?? {});\n\n for (const [key, value] of signedEntries) {\n canonicalHeadersMap[key.toLowerCase()] = String(value).trim();\n }\n\n const sortedKeys = Object.keys(canonicalHeadersMap).sort();\n const signedHeaders = sortedKeys.join(';');\n\n // `X-Amz-SignedHeaders` is itself signed, so the header list has to be settled before the query.\n const queryParameters: Record<string, string> = {\n 'X-Amz-Algorithm': 'AWS4-HMAC-SHA256',\n 'X-Amz-Credential': `${accessKey}/${credentialScope}`,\n 'X-Amz-Date': amzDate,\n 'X-Amz-Expires': String(expiresInSeconds),\n 'X-Amz-SignedHeaders': signedHeaders,\n ...(sessionToken ? { 'X-Amz-Security-Token': sessionToken } : {}),\n };\n const canonicalQueryString = S3SignatureUtility.buildCanonicalQueryString({\n query: queryParameters,\n });\n\n // A presigned URL is signed before its body exists, so the payload is excluded by name.\n const canonicalRequest = [\n method,\n canonicalPath,\n canonicalQueryString,\n sortedKeys.map((key) => `${key}:${canonicalHeadersMap[key]}\\n`).join(''),\n signedHeaders,\n 'UNSIGNED-PAYLOAD',\n ].join('\\n');\n\n const result = await S3SignatureUtility.sha256Hex({ data: canonicalRequest });\n const stringToSign = ['AWS4-HMAC-SHA256', amzDate, credentialScope, result].join('\\n');\n\n const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });\n const result2 = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: stringToSign });\n const signature = S3SignatureUtility.toHex({ bytes: result2 });\n\n return `${origin}${canonicalPath}?${canonicalQueryString}&X-Amz-Signature=${signature}`;\n }\n}\n"]}
1
+ {"version":3,"file":"utility.js","sourceRoot":"","sources":["../../../../../src/modules/storage/bun-s3/utility.ts"],"names":[],"mappings":"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","sourcesContent":["// Minimal AWS Signature V4 helpers for bucket-management operations (object ops use Bun's S3Client natively).\n\nimport { HTTP, type THttpMethod } from '@/common/constants/http';\nimport { getError } from '@/modules/error';\nimport { S3Headers, S3Signing } from '../common';\n\nexport class S3SignatureUtility {\n private static async hmacSHA256(opts: {\n key: Uint8Array<ArrayBuffer> | string;\n data: string;\n }): Promise<Uint8Array<ArrayBuffer>> {\n const { key, data } = opts;\n const rawKey = typeof key === 'string' ? new TextEncoder().encode(key) : key;\n const cryptoKey = await crypto.subtle.importKey(\n 'raw',\n rawKey,\n { name: 'HMAC', hash: 'SHA-256' },\n false,\n ['sign'],\n );\n const signature = await crypto.subtle.sign('HMAC', cryptoKey, new TextEncoder().encode(data));\n\n return new Uint8Array(signature);\n }\n\n private static toHex(opts: { bytes: Uint8Array }): string {\n return Array.from(opts.bytes)\n .map((byte) => byte.toString(16).padStart(2, '0'))\n .join('');\n }\n\n private static async sha256Hex(opts: { data: string }): Promise<string> {\n const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(opts.data));\n\n return S3SignatureUtility.toHex({ bytes: new Uint8Array(digest) });\n }\n\n /** SigV4 canonical form needs every reserved character `encodeURIComponent` leaves untouched also percent-encoded. */\n private static encodeSigV4Component(opts: { value: string }): string {\n return encodeURIComponent(opts.value).replace(\n /[!'()*]/g,\n (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`,\n );\n }\n\n /** Signing the raw path answers 403 SignatureDoesNotMatch, because `fetch` encodes it on the wire. Separators stay literal. */\n private static encodeSigV4Path(opts: { path: string }): string {\n return opts.path\n .split('/')\n .map((segment) => S3SignatureUtility.encodeSigV4Component({ value: segment }))\n .join('/');\n }\n\n /** `x-amz-copy-source`: S3 URL-decodes it once and splits `?versionId=` off, so a raw `?`, `%` or `+` names another object and a non-Latin-1 key is not a legal header value. */\n static buildCopySource(opts: { bucket: string; key: string; versionId?: string }): string {\n const source = S3SignatureUtility.encodeSigV4Path({ path: `/${opts.bucket}/${opts.key}` });\n\n return opts.versionId === undefined\n ? source\n : `${source}?versionId=${S3SignatureUtility.encodeSigV4Component({ value: opts.versionId })}`;\n }\n\n /** Empty or absent query must sign identically to today - callers of getBuckets/createBucket/removeBucket depend on it. */\n private static buildCanonicalQueryString(opts: {\n query?: Record<string, string | undefined>;\n }): string {\n const { query } = opts;\n\n if (!query) {\n return '';\n }\n\n const keys = Object.keys(query).filter((key) => query[key] !== undefined);\n\n if (keys.length === 0) {\n return '';\n }\n\n return keys\n .sort()\n .map(\n (key) =>\n `${S3SignatureUtility.encodeSigV4Component({ value: key })}=${S3SignatureUtility.encodeSigV4Component({ value: query[key] ?? '' })}`,\n )\n .join('&');\n }\n\n /** The SigV4 four-step chain. Each step keys the next, so the final key is bound to date, region and service. */\n private static async deriveSigningKey(opts: {\n secretKey: string;\n dateStamp: string;\n region: string;\n }): Promise<Uint8Array<ArrayBuffer>> {\n const { secretKey, dateStamp, region } = opts;\n const dateKey = await S3SignatureUtility.hmacSHA256({\n key: `AWS4${secretKey}`,\n data: dateStamp,\n });\n const regionKey = await S3SignatureUtility.hmacSHA256({ key: dateKey, data: region });\n const serviceKey = await S3SignatureUtility.hmacSHA256({\n key: regionKey,\n data: S3Signing.SERVICE,\n });\n\n return S3SignatureUtility.hmacSHA256({ key: serviceKey, data: S3Signing.REQUEST_TYPE });\n }\n\n /** `20130524T000000Z` and its `20130524` prefix - the two forms every signature needs. */\n private static toAmzDate(opts: { now: Date }): { amzDate: string; dateStamp: string } {\n const amzDate = opts.now\n .toISOString()\n .replace(/[-:]/g, '')\n .replace(/\\.\\d{3}Z$/, 'Z');\n\n return { amzDate, dateStamp: amzDate.slice(0, 8) };\n }\n\n private static buildCredentialScope(opts: { dateStamp: string; region: string }): string {\n return `${opts.dateStamp}/${opts.region}/${S3Signing.SERVICE}/${S3Signing.REQUEST_TYPE}`;\n }\n\n /** Lower-cases each header name into `target` and leaves out a header whose value is `undefined`. */\n private static addSignedHeaders(opts: {\n target: Record<string, string>;\n headers?: Record<string, string | undefined>;\n /** SigV4 compares header values after trimming, so signing an untrimmed one answers 403. */\n trim?: boolean;\n }): void {\n for (const [key, value] of Object.entries(opts.headers ?? {})) {\n if (value !== undefined) {\n opts.target[key.toLowerCase()] = opts.trim ? value.trim() : value;\n }\n }\n }\n\n static async buildSignedRequest(opts: {\n method: THttpMethod;\n endpoint: string;\n path: string;\n accessKey: string;\n secretKey: string;\n region: string;\n sessionToken?: string;\n body?: string;\n /** A key whose value is `undefined` is left out. */\n query?: Record<string, string | undefined>;\n /** Extra headers to SIGN, not merely to send - anything outside `SignedHeaders` is refused by S3. A key whose value is `undefined` is left out. */\n headers?: Record<string, string | undefined>;\n }): Promise<{ url: string; headers: Record<string, string> }> {\n const {\n method,\n endpoint,\n path,\n accessKey,\n secretKey,\n region,\n sessionToken,\n body = '',\n query,\n headers: extraHeaders,\n } = opts;\n\n const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now: new Date() });\n\n const canonicalQueryString = S3SignatureUtility.buildCanonicalQueryString({ query });\n const canonicalPath = S3SignatureUtility.encodeSigV4Path({ path });\n const baseUrl = `${endpoint.replace(/\\/$/, '')}${canonicalPath}`;\n const url = canonicalQueryString ? `${baseUrl}?${canonicalQueryString}` : baseUrl;\n const host = new URL(endpoint).host;\n const payloadHash = await S3SignatureUtility.sha256Hex({ data: body });\n\n const canonicalHeadersMap: Record<string, string> = {\n [HTTP.Headers.HOST]: host,\n [S3Headers.CONTENT_SHA256]: payloadHash,\n [S3Headers.DATE]: amzDate,\n };\n\n if (sessionToken) {\n canonicalHeadersMap[S3Headers.SECURITY_TOKEN] = sessionToken;\n }\n\n S3SignatureUtility.addSignedHeaders({ target: canonicalHeadersMap, headers: extraHeaders });\n\n const sortedKeys = Object.keys(canonicalHeadersMap).sort();\n const canonicalHeaders = sortedKeys.map((k) => `${k}:${canonicalHeadersMap[k]}\\n`).join('');\n const signedHeaders = sortedKeys.join(';');\n\n const canonicalRequest = [\n method.toUpperCase(),\n canonicalPath,\n canonicalQueryString,\n canonicalHeaders,\n signedHeaders,\n payloadHash,\n ].join('\\n');\n\n const credentialScope = S3SignatureUtility.buildCredentialScope({ dateStamp, region });\n const result = await S3SignatureUtility.sha256Hex({ data: canonicalRequest });\n const stringToSign = [S3Signing.ALGORITHM, amzDate, credentialScope, result].join('\\n');\n\n const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });\n const result2 = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: stringToSign });\n const signature = S3SignatureUtility.toHex({ bytes: result2 });\n\n const authHeader = `${S3Signing.ALGORITHM} Credential=${accessKey}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;\n const contentLength = String(new TextEncoder().encode(body).length);\n\n return {\n url,\n headers: {\n ...canonicalHeadersMap,\n Authorization: authHeader,\n 'Content-Length': contentLength,\n },\n };\n }\n\n private static escapeXmlText(opts: { value: string }): string {\n return opts.value\n .replace(/&/g, '&amp;')\n .replace(/</g, '&lt;')\n .replace(/>/g, '&gt;')\n .replace(/\"/g, '&quot;')\n .replace(/'/g, '&apos;');\n }\n\n /** `&amp;` decodes LAST - a literal `&lt;` in the source text must not turn into `<` through the `&amp;` step. */\n private static unescapeXmlText(opts: { value: string }): string {\n return opts.value\n .replace(/&lt;/g, '<')\n .replace(/&gt;/g, '>')\n .replace(/&quot;/g, '\"')\n .replace(/&apos;/g, \"'\")\n .replace(/&amp;/g, '&');\n }\n\n /** S3's PUT tagging body - no XML dependency, so this is hand-built rather than templated by a library. */\n static buildTaggingXml(opts: { tags: Record<string, string> }): string {\n const tagEntries = Object.entries(opts.tags)\n .map(\n ([key, value]) =>\n `<Tag><Key>${S3SignatureUtility.escapeXmlText({ value: key })}</Key><Value>${S3SignatureUtility.escapeXmlText({ value })}</Value></Tag>`,\n )\n .join('');\n\n return `<Tagging><TagSet>${tagEntries}</TagSet></Tagging>`;\n }\n\n /** The `x-amz-tagging` header: a URL-encoded query string, unlike the XML the tagging API takes. */\n static buildTaggingHeader(opts: { tags: Record<string, string> }): string {\n return Object.entries(opts.tags)\n .map(\n ([key, value]) =>\n `${S3SignatureUtility.encodeSigV4Component({ value: key })}=${S3SignatureUtility.encodeSigV4Component({ value })}`,\n )\n .join('&');\n }\n\n /** S3's GET tagging response - hand-parsed rather than a full XML parser; throws rather than returning a half-parsed object. */\n static parseTaggingXml(opts: { xml: string }): Record<string, string> {\n const { xml } = opts;\n const trimmed = xml.trim();\n\n if (/<TagSet\\s*\\/>/.test(trimmed) || /<TagSet>\\s*<\\/TagSet>/.test(trimmed)) {\n return {};\n }\n\n const tagSetMatch = trimmed.match(/<TagSet>([\\s\\S]*?)<\\/TagSet>/);\n\n if (!tagSetMatch) {\n throw getError({ message: `[parseTaggingXml] Malformed tagging response | body: ${xml}` });\n }\n\n const tags: Record<string, string> = {};\n const tagMatches = tagSetMatch[1].matchAll(/<Tag>([\\s\\S]*?)<\\/Tag>/g);\n\n for (const tagMatch of tagMatches) {\n const keyMatch = tagMatch[1].match(/<Key>([\\s\\S]*?)<\\/Key>/);\n const valueMatch = tagMatch[1].match(/<Value>([\\s\\S]*?)<\\/Value>/);\n\n if (!keyMatch || !valueMatch) {\n throw getError({ message: `[parseTaggingXml] Malformed tag entry | body: ${xml}` });\n }\n\n const key = S3SignatureUtility.unescapeXmlText({ value: keyMatch[1].trim() });\n const value = S3SignatureUtility.unescapeXmlText({ value: valueMatch[1].trim() });\n tags[key] = value;\n }\n\n return tags;\n }\n\n /**\n * A signed POST policy: the form a browser posts straight to S3.\n *\n * This is not a presigned PUT and the difference is the point. A signed PUT binds each header to an\n * EXACT value, so `content-length` names one byte count and never a ceiling - every retry or\n * re-encode becomes an opaque 403. A policy carries `content-length-range`, so \"at most N bytes\" is\n * expressible at all.\n */\n static async buildPostPolicy(opts: {\n bucket: string;\n /** The ONE key the form may be posted under. */\n key: string;\n maxBytes: number;\n expiresInSeconds: number;\n accessKey: string;\n secretKey: string;\n region: string;\n sessionToken?: string;\n contentType?: string;\n }): Promise<{ formData: Record<string, string>; expiresAt: string }> {\n const {\n bucket,\n key,\n maxBytes,\n expiresInSeconds,\n accessKey,\n secretKey,\n region,\n sessionToken,\n contentType,\n } = opts;\n\n const now = new Date();\n const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now });\n const credential = `${accessKey}/${S3SignatureUtility.buildCredentialScope({ dateStamp, region })}`;\n const expiresAt = new Date(now.getTime() + expiresInSeconds * 1000).toISOString();\n\n // Every field the browser posts must ALSO be a condition, or S3 refuses the form it just signed.\n const fields: Record<string, string> = {\n 'x-amz-algorithm': S3Signing.ALGORITHM,\n 'x-amz-credential': credential,\n [S3Headers.DATE]: amzDate,\n };\n\n if (sessionToken) {\n fields[S3Headers.SECURITY_TOKEN] = sessionToken;\n }\n\n const conditions: unknown[] = [\n { bucket },\n { key },\n ['content-length-range', 0, maxBytes],\n ...Object.entries(fields).map(([fieldName, fieldValue]) => ({ [fieldName]: fieldValue })),\n ];\n\n // The form field is spelled `Content-Type`; a policy condition matches it case-sensitively.\n const typeField = 'Content-Type';\n\n if (contentType) {\n conditions.push({ [typeField]: contentType });\n }\n\n const policy = Buffer.from(JSON.stringify({ expiration: expiresAt, conditions })).toString(\n 'base64',\n );\n\n const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });\n\n const result = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: policy });\n\n const formData: Record<string, string> = { key, ...fields };\n\n if (contentType) {\n formData[typeField] = contentType;\n }\n\n formData.policy = policy;\n formData['x-amz-signature'] = S3SignatureUtility.toHex({ bytes: result });\n\n return { formData, expiresAt };\n }\n\n /**\n * A presigned URL: the credential travels in the QUERY, so a browser needs no `Authorization` header.\n *\n * `headers` is what `S3Client.presign` cannot do. Anything named there is inside the signature and\n * listed in `X-Amz-SignedHeaders`, so the client must send it back byte for byte. A signature\n * expresses equality and nothing else, so a pinned `content-length` rejects every retry at another\n * size; for a ceiling, use {@link S3SignatureUtility.buildPostPolicy}.\n */\n static async buildPresignedUrl(opts: {\n method: THttpMethod;\n endpoint: string;\n path: string;\n accessKey: string;\n secretKey: string;\n region: string;\n sessionToken?: string;\n expiresInSeconds: number;\n /** Headers to SIGN. The client must send each one unchanged, or S3 answers 403. A key whose value is `undefined` is left out. */\n headers?: Record<string, string | undefined>;\n /** A fixed clock, so a signature can be checked against a published test vector. */\n now?: Date;\n }): Promise<string> {\n const {\n method,\n endpoint,\n path,\n accessKey,\n secretKey,\n region,\n sessionToken,\n expiresInSeconds,\n headers,\n now = new Date(),\n } = opts;\n\n const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now });\n const credentialScope = S3SignatureUtility.buildCredentialScope({ dateStamp, region });\n const canonicalPath = S3SignatureUtility.encodeSigV4Path({ path });\n const origin = endpoint.replace(/\\/$/, '');\n\n const canonicalHeadersMap: Record<string, string> = {\n [HTTP.Headers.HOST]: new URL(origin).host,\n };\n\n S3SignatureUtility.addSignedHeaders({ target: canonicalHeadersMap, headers, trim: true });\n\n const sortedKeys = Object.keys(canonicalHeadersMap).sort();\n const signedHeaders = sortedKeys.join(';');\n\n // `X-Amz-SignedHeaders` is itself signed, so the header list has to be settled before the query.\n const queryParameters: Record<string, string> = {\n 'X-Amz-Algorithm': S3Signing.ALGORITHM,\n 'X-Amz-Credential': `${accessKey}/${credentialScope}`,\n 'X-Amz-Date': amzDate,\n 'X-Amz-Expires': String(expiresInSeconds),\n 'X-Amz-SignedHeaders': signedHeaders,\n };\n\n if (sessionToken) {\n queryParameters['X-Amz-Security-Token'] = sessionToken;\n }\n\n const canonicalQueryString = S3SignatureUtility.buildCanonicalQueryString({\n query: queryParameters,\n });\n\n // A presigned URL is signed before its body exists, so the payload is excluded by name.\n const canonicalRequest = [\n method.toUpperCase(),\n canonicalPath,\n canonicalQueryString,\n sortedKeys.map((key) => `${key}:${canonicalHeadersMap[key]}\\n`).join(''),\n signedHeaders,\n S3Signing.UNSIGNED_PAYLOAD,\n ].join('\\n');\n\n const result = await S3SignatureUtility.sha256Hex({ data: canonicalRequest });\n const stringToSign = [S3Signing.ALGORITHM, amzDate, credentialScope, result].join('\\n');\n\n const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });\n const result2 = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: stringToSign });\n const signature = S3SignatureUtility.toHex({ bytes: result2 });\n\n return `${origin}${canonicalPath}?${canonicalQueryString}&X-Amz-Signature=${signature}`;\n }\n}\n"]}
@@ -6,6 +6,35 @@ export declare class StorageTypes {
6
6
  }
7
7
  /** One of the `StorageTypes` values. */
8
8
  export type TStorageType = TConstValue<typeof StorageTypes>;
9
+ /** The `x-amz-*` request and response headers the S3 helper reads and sends. */
10
+ export declare class S3Headers {
11
+ static readonly COPY_SOURCE = "x-amz-copy-source";
12
+ static readonly COPY_SOURCE_IF_MATCH = "x-amz-copy-source-if-match";
13
+ static readonly VERSION_ID = "x-amz-version-id";
14
+ static readonly TAGGING = "x-amz-tagging";
15
+ static readonly CONTENT_SHA256 = "x-amz-content-sha256";
16
+ static readonly DATE = "x-amz-date";
17
+ static readonly SECURITY_TOKEN = "x-amz-security-token";
18
+ }
19
+ /** The fixed words of an AWS Signature V4 signature for S3. */
20
+ export declare class S3Signing {
21
+ static readonly ALGORITHM = "AWS4-HMAC-SHA256";
22
+ static readonly SERVICE = "s3";
23
+ static readonly REQUEST_TYPE = "aws4_request";
24
+ static readonly UNSIGNED_PAYLOAD = "UNSIGNED-PAYLOAD";
25
+ }
26
+ /** S3 values the helper falls back to or recognises. */
27
+ export declare class S3Defaults {
28
+ static readonly REGION = "us-east-1";
29
+ /** What S3 answers as the version id of an object in a bucket where versioning is off or suspended. */
30
+ static readonly NULL_VERSION_ID = "null";
31
+ }
32
+ /** Size ceilings the storage helpers enforce: a name or key in UTF-8 bytes, and the keys one S3 listing call returns. */
33
+ export declare class StorageLimits {
34
+ static readonly MAX_SEGMENT_BYTES = 255;
35
+ static readonly MAX_KEY_BYTES = 1024;
36
+ static readonly MAX_LIST_KEYS = 1000;
37
+ }
9
38
  /** Presign expiry defaults - a PUT or a POST form carries a file and needs more time; a GET is a redirect. */
10
39
  export declare class StoragePresignDefaults {
11
40
  static readonly PUT_EXPIRES_IN: IDuration;
@@ -27,8 +56,6 @@ export declare class S3Audiences {
27
56
  static readonly SERVER = "server";
28
57
  /** The host a BROWSER is handed: presigned URLs and POST policies. */
29
58
  static readonly BROWSER = "browser";
30
- static readonly SCHEME_SET: Set<string>;
31
- static isValid(audience: string): boolean;
32
59
  }
33
60
  /** The host a signed artifact names: `server` (the host this process talks to) or `browser` (the host a browser is handed). */
34
61
  export type TS3Audience = TConstValue<typeof S3Audiences>;
@@ -4,6 +4,35 @@ export class StorageTypes {
4
4
  static { this.DISK = 'disk'; }
5
5
  static { this.BUN_S3 = 'bun-s3'; }
6
6
  }
7
+ /** The `x-amz-*` request and response headers the S3 helper reads and sends. */
8
+ export class S3Headers {
9
+ static { this.COPY_SOURCE = 'x-amz-copy-source'; }
10
+ static { this.COPY_SOURCE_IF_MATCH = 'x-amz-copy-source-if-match'; }
11
+ static { this.VERSION_ID = 'x-amz-version-id'; }
12
+ static { this.TAGGING = 'x-amz-tagging'; }
13
+ static { this.CONTENT_SHA256 = 'x-amz-content-sha256'; }
14
+ static { this.DATE = 'x-amz-date'; }
15
+ static { this.SECURITY_TOKEN = 'x-amz-security-token'; }
16
+ }
17
+ /** The fixed words of an AWS Signature V4 signature for S3. */
18
+ export class S3Signing {
19
+ static { this.ALGORITHM = 'AWS4-HMAC-SHA256'; }
20
+ static { this.SERVICE = 's3'; }
21
+ static { this.REQUEST_TYPE = 'aws4_request'; }
22
+ static { this.UNSIGNED_PAYLOAD = 'UNSIGNED-PAYLOAD'; }
23
+ }
24
+ /** S3 values the helper falls back to or recognises. */
25
+ export class S3Defaults {
26
+ static { this.REGION = 'us-east-1'; }
27
+ /** What S3 answers as the version id of an object in a bucket where versioning is off or suspended. */
28
+ static { this.NULL_VERSION_ID = 'null'; }
29
+ }
30
+ /** Size ceilings the storage helpers enforce: a name or key in UTF-8 bytes, and the keys one S3 listing call returns. */
31
+ export class StorageLimits {
32
+ static { this.MAX_SEGMENT_BYTES = 255; }
33
+ static { this.MAX_KEY_BYTES = 1024; }
34
+ static { this.MAX_LIST_KEYS = 1000; }
35
+ }
7
36
  /** Presign expiry defaults - a PUT or a POST form carries a file and needs more time; a GET is a redirect. */
8
37
  export class StoragePresignDefaults {
9
38
  static { this.PUT_EXPIRES_IN = { unit: DurationUnits.MINUTE, value: 10 }; }
@@ -25,9 +54,5 @@ export class S3Audiences {
25
54
  static { this.SERVER = 'server'; }
26
55
  /** The host a BROWSER is handed: presigned URLs and POST policies. */
27
56
  static { this.BROWSER = 'browser'; }
28
- static { this.SCHEME_SET = new Set([this.SERVER, this.BROWSER]); }
29
- static isValid(audience) {
30
- return this.SCHEME_SET.has(audience);
31
- }
32
57
  }
33
58
  //# sourceMappingURL=constants.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/storage/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoC,MAAM,UAAU,CAAC;AAE3E,8HAA8H;AAC9H,MAAM,OAAO,YAAY;aACP,SAAI,GAAG,MAAM,CAAC;aACd,WAAM,GAAG,QAAQ,CAAC;;AAMpC,8GAA8G;AAC9G,MAAM,OAAO,sBAAsB;aACjB,mBAAc,GAAc,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;aACtE,mBAAc,GAAc,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAErF,yFAAyF;aACzE,oBAAe,GAAc,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;;AAGzF,kEAAkE;AAClE,MAAM,OAAO,oBAAoB;aACf,2BAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;;AAG5D,sFAAsF;AACtF,MAAM,OAAO,kBAAkB;aACb,kBAAa,GAAG,EAAE,CAAC;;AAGrC,uJAAuJ;AACvJ,MAAM,OAAO,WAAW;IACtB,qFAAqF;aACrE,WAAM,GAAG,QAAQ,CAAC;IAElC,sEAAsE;aACtD,YAAO,GAAG,SAAS,CAAC;aAEpB,eAAU,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAE1E,MAAM,CAAC,OAAO,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC","sourcesContent":["import { DurationUnits, type IDuration, type TConstValue } from '@/common';\n\n/** The backend a storage helper writes to. A helper declares its own, so a caller never tells one apart with `instanceof`. */\nexport class StorageTypes {\n static readonly DISK = 'disk';\n static readonly BUN_S3 = 'bun-s3';\n}\n\n/** One of the `StorageTypes` values. */\nexport type TStorageType = TConstValue<typeof StorageTypes>;\n\n/** Presign expiry defaults - a PUT or a POST form carries a file and needs more time; a GET is a redirect. */\nexport class StoragePresignDefaults {\n static readonly PUT_EXPIRES_IN: IDuration = { unit: DurationUnits.MINUTE, value: 10 };\n static readonly GET_EXPIRES_IN: IDuration = { unit: DurationUnits.MINUTE, value: 1 };\n\n /** A browser upload form: the user has to pick the file and the bytes have to travel. */\n static readonly POST_EXPIRES_IN: IDuration = { unit: DurationUnits.MINUTE, value: 15 };\n}\n\n/** SigV4 refuses a presigned URL valid for longer than 7 days. */\nexport class StoragePresignLimits {\n static readonly MAX_EXPIRES_IN_SECONDS = 7 * 24 * 60 * 60;\n}\n\n/** Concurrent object operations. Unbounded exhausts sockets and gets rate limited. */\nexport class StorageConcurrency {\n static readonly DEFAULT_LIMIT = 16;\n}\n\n/** Which host a signed artifact names. `host` is inside every SigV4 signature, so this is decided at signing time and cannot be patched afterwards. */\nexport class S3Audiences {\n /** The host THIS process talks to: every bucket operation, copy and tagging call. */\n static readonly SERVER = 'server';\n\n /** The host a BROWSER is handed: presigned URLs and POST policies. */\n static readonly BROWSER = 'browser';\n\n static readonly SCHEME_SET = new Set<string>([this.SERVER, this.BROWSER]);\n\n static isValid(audience: string): boolean {\n return this.SCHEME_SET.has(audience);\n }\n}\n\n/** The host a signed artifact names: `server` (the host this process talks to) or `browser` (the host a browser is handed). */\nexport type TS3Audience = TConstValue<typeof S3Audiences>;\n"]}
1
+ {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/storage/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoC,MAAM,UAAU,CAAC;AAE3E,8HAA8H;AAC9H,MAAM,OAAO,YAAY;aACP,SAAI,GAAG,MAAM,CAAC;aACd,WAAM,GAAG,QAAQ,CAAC;;AAMpC,gFAAgF;AAChF,MAAM,OAAO,SAAS;aACJ,gBAAW,GAAG,mBAAmB,CAAC;aAClC,yBAAoB,GAAG,4BAA4B,CAAC;aACpD,eAAU,GAAG,kBAAkB,CAAC;aAChC,YAAO,GAAG,eAAe,CAAC;aAC1B,mBAAc,GAAG,sBAAsB,CAAC;aACxC,SAAI,GAAG,YAAY,CAAC;aACpB,mBAAc,GAAG,sBAAsB,CAAC;;AAG1D,+DAA+D;AAC/D,MAAM,OAAO,SAAS;aACJ,cAAS,GAAG,kBAAkB,CAAC;aAC/B,YAAO,GAAG,IAAI,CAAC;aACf,iBAAY,GAAG,cAAc,CAAC;aAC9B,qBAAgB,GAAG,kBAAkB,CAAC;;AAGxD,wDAAwD;AACxD,MAAM,OAAO,UAAU;aACL,WAAM,GAAG,WAAW,CAAC;IAErC,uGAAuG;aACvF,oBAAe,GAAG,MAAM,CAAC;;AAG3C,yHAAyH;AACzH,MAAM,OAAO,aAAa;aACR,sBAAiB,GAAG,GAAG,CAAC;aACxB,kBAAa,GAAG,IAAI,CAAC;aACrB,kBAAa,GAAG,IAAI,CAAC;;AAGvC,8GAA8G;AAC9G,MAAM,OAAO,sBAAsB;aACjB,mBAAc,GAAc,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;aACtE,mBAAc,GAAc,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAErF,yFAAyF;aACzE,oBAAe,GAAc,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;;AAGzF,kEAAkE;AAClE,MAAM,OAAO,oBAAoB;aACf,2BAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;;AAG5D,sFAAsF;AACtF,MAAM,OAAO,kBAAkB;aACb,kBAAa,GAAG,EAAE,CAAC;;AAGrC,uJAAuJ;AACvJ,MAAM,OAAO,WAAW;IACtB,qFAAqF;aACrE,WAAM,GAAG,QAAQ,CAAC;IAElC,sEAAsE;aACtD,YAAO,GAAG,SAAS,CAAC","sourcesContent":["import { DurationUnits, type IDuration, type TConstValue } from '@/common';\n\n/** The backend a storage helper writes to. A helper declares its own, so a caller never tells one apart with `instanceof`. */\nexport class StorageTypes {\n static readonly DISK = 'disk';\n static readonly BUN_S3 = 'bun-s3';\n}\n\n/** One of the `StorageTypes` values. */\nexport type TStorageType = TConstValue<typeof StorageTypes>;\n\n/** The `x-amz-*` request and response headers the S3 helper reads and sends. */\nexport class S3Headers {\n static readonly COPY_SOURCE = 'x-amz-copy-source';\n static readonly COPY_SOURCE_IF_MATCH = 'x-amz-copy-source-if-match';\n static readonly VERSION_ID = 'x-amz-version-id';\n static readonly TAGGING = 'x-amz-tagging';\n static readonly CONTENT_SHA256 = 'x-amz-content-sha256';\n static readonly DATE = 'x-amz-date';\n static readonly SECURITY_TOKEN = 'x-amz-security-token';\n}\n\n/** The fixed words of an AWS Signature V4 signature for S3. */\nexport class S3Signing {\n static readonly ALGORITHM = 'AWS4-HMAC-SHA256';\n static readonly SERVICE = 's3';\n static readonly REQUEST_TYPE = 'aws4_request';\n static readonly UNSIGNED_PAYLOAD = 'UNSIGNED-PAYLOAD';\n}\n\n/** S3 values the helper falls back to or recognises. */\nexport class S3Defaults {\n static readonly REGION = 'us-east-1';\n\n /** What S3 answers as the version id of an object in a bucket where versioning is off or suspended. */\n static readonly NULL_VERSION_ID = 'null';\n}\n\n/** Size ceilings the storage helpers enforce: a name or key in UTF-8 bytes, and the keys one S3 listing call returns. */\nexport class StorageLimits {\n static readonly MAX_SEGMENT_BYTES = 255;\n static readonly MAX_KEY_BYTES = 1024;\n static readonly MAX_LIST_KEYS = 1000;\n}\n\n/** Presign expiry defaults - a PUT or a POST form carries a file and needs more time; a GET is a redirect. */\nexport class StoragePresignDefaults {\n static readonly PUT_EXPIRES_IN: IDuration = { unit: DurationUnits.MINUTE, value: 10 };\n static readonly GET_EXPIRES_IN: IDuration = { unit: DurationUnits.MINUTE, value: 1 };\n\n /** A browser upload form: the user has to pick the file and the bytes have to travel. */\n static readonly POST_EXPIRES_IN: IDuration = { unit: DurationUnits.MINUTE, value: 15 };\n}\n\n/** SigV4 refuses a presigned URL valid for longer than 7 days. */\nexport class StoragePresignLimits {\n static readonly MAX_EXPIRES_IN_SECONDS = 7 * 24 * 60 * 60;\n}\n\n/** Concurrent object operations. Unbounded exhausts sockets and gets rate limited. */\nexport class StorageConcurrency {\n static readonly DEFAULT_LIMIT = 16;\n}\n\n/** Which host a signed artifact names. `host` is inside every SigV4 signature, so this is decided at signing time and cannot be patched afterwards. */\nexport class S3Audiences {\n /** The host THIS process talks to: every bucket operation, copy and tagging call. */\n static readonly SERVER = 'server';\n\n /** The host a BROWSER is handed: presigned URLs and POST policies. */\n static readonly BROWSER = 'browser';\n}\n\n/** The host a signed artifact names: `server` (the host this process talks to) or `browser` (the host a browser is handed). */\nexport type TS3Audience = TConstValue<typeof S3Audiences>;\n"]}
@@ -9,6 +9,15 @@ export declare const StorageErrors: {
9
9
  readonly statusCode: 404;
10
10
  readonly category: "business";
11
11
  };
12
+ /** A read or copy that named the content it expects (an ETag or a version) found other content. */
13
+ readonly PRECONDITION_FAILED: {
14
+ readonly message: {
15
+ readonly text: "The object no longer matches what was expected";
16
+ readonly code: "core.storage.precondition_failed";
17
+ };
18
+ readonly statusCode: 412;
19
+ readonly category: "business";
20
+ };
12
21
  /** An upload named a folder the storage refuses: a segment it cannot hold, or an empty path. */
13
22
  readonly FOLDER_PATH_INVALID: {
14
23
  readonly message: {
@@ -7,6 +7,15 @@ export const StorageErrors = {
7
7
  statusCode: HTTP.ResultCodes.RS_4.NotFound,
8
8
  category: ErrorScopes.BUSINESS,
9
9
  },
10
+ /** A read or copy that named the content it expects (an ETag or a version) found other content. */
11
+ PRECONDITION_FAILED: {
12
+ message: {
13
+ text: 'The object no longer matches what was expected',
14
+ code: 'core.storage.precondition_failed',
15
+ },
16
+ statusCode: HTTP.ResultCodes.RS_4.PreconditionFailed,
17
+ category: ErrorScopes.BUSINESS,
18
+ },
10
19
  /** An upload named a folder the storage refuses: a segment it cannot hold, or an empty path. */
11
20
  FOLDER_PATH_INVALID: {
12
21
  message: { text: 'Invalid folder path', code: 'core.storage.folder_path_invalid' },
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../src/modules/storage/common/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,uGAAuG;AACvG,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,gBAAgB,EAAE;QAChB,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,+BAA+B,EAAE;QAC5E,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ;QAC1C,QAAQ,EAAE,WAAW,CAAC,QAAQ;KAC/B;IACD,gGAAgG;IAChG,mBAAmB,EAAE;QACnB,OAAO,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,kCAAkC,EAAE;QAClF,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;QAC5C,QAAQ,EAAE,WAAW,CAAC,UAAU;KACjC;IACD,qBAAqB,EAAE;QACrB,OAAO,EAAE;YACP,IAAI,EAAE,uCAAuC;YAC7C,IAAI,EAAE,oCAAoC;SAC3C;QACD,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;QAC5C,QAAQ,EAAE,WAAW,CAAC,UAAU;KACjC;CACkD,CAAC","sourcesContent":["import type { TErrorDefinition, TRegisterErrors } from '@venizia/ignis-inversion';\nimport { ErrorScopes } from '@venizia/ignis-inversion';\nimport { HTTP } from '@/common/constants';\n\n/** Codes a caller branches on for a storage failure that is the request's fault, not the backend's. */\nexport const StorageErrors = {\n OBJECT_NOT_FOUND: {\n message: { text: 'Object not found', code: 'core.storage.object_not_found' },\n statusCode: HTTP.ResultCodes.RS_4.NotFound,\n category: ErrorScopes.BUSINESS,\n },\n /** An upload named a folder the storage refuses: a segment it cannot hold, or an empty path. */\n FOLDER_PATH_INVALID: {\n message: { text: 'Invalid folder path', code: 'core.storage.folder_path_invalid' },\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n category: ErrorScopes.VALIDATION,\n },\n FOLDER_DEPTH_EXCEEDED: {\n message: {\n text: 'Folder path exceeds the maximum depth',\n code: 'core.storage.folder_depth_exceeded',\n },\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n category: ErrorScopes.VALIDATION,\n },\n} as const satisfies Record<string, TErrorDefinition>;\n\n/** Augments inversion, not helpers: TS only treats this as an augmentation when the file imports that module. */\ndeclare module '@venizia/ignis-inversion' {\n interface IErrorKeyRegistry extends TRegisterErrors<typeof StorageErrors> {}\n}\n"]}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../src/modules/storage/common/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,uGAAuG;AACvG,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,gBAAgB,EAAE;QAChB,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,+BAA+B,EAAE;QAC5E,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ;QAC1C,QAAQ,EAAE,WAAW,CAAC,QAAQ;KAC/B;IACD,mGAAmG;IACnG,mBAAmB,EAAE;QACnB,OAAO,EAAE;YACP,IAAI,EAAE,gDAAgD;YACtD,IAAI,EAAE,kCAAkC;SACzC;QACD,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB;QACpD,QAAQ,EAAE,WAAW,CAAC,QAAQ;KAC/B;IACD,gGAAgG;IAChG,mBAAmB,EAAE;QACnB,OAAO,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,kCAAkC,EAAE;QAClF,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;QAC5C,QAAQ,EAAE,WAAW,CAAC,UAAU;KACjC;IACD,qBAAqB,EAAE;QACrB,OAAO,EAAE;YACP,IAAI,EAAE,uCAAuC;YAC7C,IAAI,EAAE,oCAAoC;SAC3C;QACD,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;QAC5C,QAAQ,EAAE,WAAW,CAAC,UAAU;KACjC;CACkD,CAAC","sourcesContent":["import type { TErrorDefinition, TRegisterErrors } from '@venizia/ignis-inversion';\nimport { ErrorScopes } from '@venizia/ignis-inversion';\nimport { HTTP } from '@/common/constants';\n\n/** Codes a caller branches on for a storage failure that is the request's fault, not the backend's. */\nexport const StorageErrors = {\n OBJECT_NOT_FOUND: {\n message: { text: 'Object not found', code: 'core.storage.object_not_found' },\n statusCode: HTTP.ResultCodes.RS_4.NotFound,\n category: ErrorScopes.BUSINESS,\n },\n /** A read or copy that named the content it expects (an ETag or a version) found other content. */\n PRECONDITION_FAILED: {\n message: {\n text: 'The object no longer matches what was expected',\n code: 'core.storage.precondition_failed',\n },\n statusCode: HTTP.ResultCodes.RS_4.PreconditionFailed,\n category: ErrorScopes.BUSINESS,\n },\n /** An upload named a folder the storage refuses: a segment it cannot hold, or an empty path. */\n FOLDER_PATH_INVALID: {\n message: { text: 'Invalid folder path', code: 'core.storage.folder_path_invalid' },\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n category: ErrorScopes.VALIDATION,\n },\n FOLDER_DEPTH_EXCEEDED: {\n message: {\n text: 'Folder path exceeds the maximum depth',\n code: 'core.storage.folder_depth_exceeded',\n },\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n category: ErrorScopes.VALIDATION,\n },\n} as const satisfies Record<string, TErrorDefinition>;\n\n/** Augments inversion, not helpers: TS only treats this as an augmentation when the file imports that module. */\ndeclare module '@venizia/ignis-inversion' {\n interface IErrorKeyRegistry extends TRegisterErrors<typeof StorageErrors> {}\n}\n"]}