@venizia/ignis-helpers 0.4.8-8 → 0.4.8-9

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.
@@ -9,6 +9,8 @@ export declare class HTTP {
9
9
  readonly CONTENT_TYPE: "content-type";
10
10
  readonly CONTENT_RANGE: "content-range";
11
11
  readonly CONTENT_SECURITY_POLICY: "content-security-policy";
12
+ readonly ACCEPT_RANGES: "accept-ranges";
13
+ readonly RANGE: "range";
12
14
  readonly ACCEPT: "accept";
13
15
  readonly ACCEPT_ENCODING: "accept-encoding";
14
16
  readonly ACCEPT_LANGUAGE: "accept-language";
@@ -9,6 +9,8 @@ export class HTTP {
9
9
  CONTENT_TYPE: 'content-type',
10
10
  CONTENT_RANGE: 'content-range',
11
11
  CONTENT_SECURITY_POLICY: 'content-security-policy',
12
+ ACCEPT_RANGES: 'accept-ranges',
13
+ RANGE: 'range',
12
14
  // Request - content negotiation & conditionals
13
15
  ACCEPT: 'accept',
14
16
  ACCEPT_ENCODING: 'accept-encoding',
@@ -1 +1 @@
1
- {"version":3,"file":"http.js","sourceRoot":"","sources":["../../../../src/common/constants/http.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ValueOf } from '../types';\n\n/** HTTP constants: header names, CORS headers, header values, methods, protocols and status codes. Header names, methods and protocols are lowercase. */\nexport class HTTP {\n /** Standard and common HTTP headers (lowercase per HTTP/2 convention). */\n static readonly Headers = {\n // Content\n CONTENT_DISPOSITION: 'content-disposition',\n CONTENT_ENCODING: 'content-encoding',\n CONTENT_LENGTH: 'content-length',\n CONTENT_TYPE: 'content-type',\n CONTENT_RANGE: 'content-range',\n CONTENT_SECURITY_POLICY: 'content-security-policy',\n\n // Request - content negotiation & conditionals\n ACCEPT: 'accept',\n ACCEPT_ENCODING: 'accept-encoding',\n ACCEPT_LANGUAGE: 'accept-language',\n AUTHORIZATION: 'authorization',\n COOKIE: 'cookie',\n HOST: 'host',\n IF_MODIFIED_SINCE: 'if-modified-since',\n IF_NONE_MATCH: 'if-none-match',\n ORIGIN: 'origin',\n REFERER: 'referer',\n USER_AGENT: 'user-agent',\n\n // Response - caching, auth challenges & redirects\n ALLOW: 'allow',\n CACHE_CONTROL: 'cache-control',\n ETAG: 'etag',\n LAST_MODIFIED: 'last-modified',\n LOCATION: 'location',\n RETRY_AFTER: 'retry-after',\n SET_COOKIE: 'set-cookie',\n VARY: 'vary',\n WWW_AUTHENTICATE: 'www-authenticate',\n\n // CORS (RFC 6454 / Fetch spec)\n ACCESS_CONTROL_ALLOW_CREDENTIALS: 'access-control-allow-credentials',\n ACCESS_CONTROL_ALLOW_HEADERS: 'access-control-allow-headers',\n ACCESS_CONTROL_ALLOW_METHODS: 'access-control-allow-methods',\n ACCESS_CONTROL_ALLOW_ORIGIN: 'access-control-allow-origin',\n ACCESS_CONTROL_EXPOSE_HEADERS: 'access-control-expose-headers',\n ACCESS_CONTROL_MAX_AGE: 'access-control-max-age',\n ACCESS_CONTROL_REQUEST_HEADERS: 'access-control-request-headers',\n ACCESS_CONTROL_REQUEST_METHOD: 'access-control-request-method',\n\n // Transport\n CONNECTION: 'connection',\n TRANSFER_ENCODING: 'transfer-encoding',\n UPGRADE: 'upgrade',\n\n // Security\n STRICT_TRANSPORT_SECURITY: 'strict-transport-security',\n X_CONTENT_TYPE_OPTIONS: 'x-content-type-options',\n X_FRAME_OPTIONS: 'x-frame-options',\n\n // Proxy / forwarding (de facto standard)\n FORWARDED: 'forwarded',\n X_FORWARDED_FOR: 'x-forwarded-for',\n X_FORWARDED_HOST: 'x-forwarded-host',\n X_FORWARDED_PROTO: 'x-forwarded-proto',\n\n // Rate limiting (de facto standard)\n X_RATELIMIT_LIMIT: 'x-ratelimit-limit',\n X_RATELIMIT_REMAINING: 'x-ratelimit-remaining',\n X_RATELIMIT_RESET: 'x-ratelimit-reset',\n\n // IGNIS custom\n REQUEST_TRACING_ID: 'x-request-id',\n REQUEST_DEVICE_INFO: 'x-device-info',\n REQUEST_CHANNEL: 'x-request-channel',\n REQUEST_COUNT_DATA: 'x-request-count',\n REQUEST_EXTRA: 'x-request-extra',\n RESPONSE_COUNT_DATA: 'x-response-count',\n RESPONSE_FORMAT: 'x-response-format',\n RESPONSE_EXTRA: 'x-response-extra',\n } as const;\n\n /**\n * The headers IGNIS adds to a request and to a response, for a CORS configuration that lists them\n * by hand: spread `ALLOW` into the allowed request headers and `EXPOSE` into the exposed ones, so\n * a header IGNIS adds later needs no change there.\n */\n static readonly CorsHeaders = {\n ALLOW: [\n 'x-request-id',\n 'x-request-count',\n 'x-request-extra',\n 'x-request-channel',\n 'x-device-info',\n ],\n EXPOSE: [\n 'content-range',\n 'x-request-id',\n 'x-response-count',\n 'x-response-format',\n 'x-response-extra',\n ],\n } as const;\n\n /** Common MIME / Content-Type values. */\n static readonly HeaderValues = {\n // Application\n APPLICATION_FORM_URLENCODED: 'application/x-www-form-urlencoded',\n APPLICATION_GRAPHQL_JSON: 'application/graphql+json',\n APPLICATION_GZIP: 'application/gzip',\n APPLICATION_JAVASCRIPT: 'application/javascript',\n APPLICATION_JSON: 'application/json',\n APPLICATION_MSGPACK: 'application/msgpack',\n APPLICATION_NDJSON: 'application/x-ndjson',\n APPLICATION_OCTET_STREAM: 'application/octet-stream',\n APPLICATION_PDF: 'application/pdf',\n APPLICATION_PROTOBUF: 'application/x-protobuf',\n APPLICATION_XML: 'application/xml',\n APPLICATION_ZIP: 'application/zip',\n\n // Multipart\n MULTIPART_FORM_DATA: 'multipart/form-data',\n\n // Text\n TEXT_CSS: 'text/css',\n TEXT_CSV: 'text/csv',\n TEXT_EVENT_STREAM: 'text/event-stream',\n TEXT_HTML: 'text/html',\n TEXT_PLAIN: 'text/plain',\n TEXT_XML: 'text/xml',\n\n // Image\n IMAGE_GIF: 'image/gif',\n IMAGE_JPEG: 'image/jpeg',\n IMAGE_PNG: 'image/png',\n IMAGE_SVG: 'image/svg+xml',\n IMAGE_WEBP: 'image/webp',\n } as const;\n\n /** Standard HTTP methods (lowercase). */\n static readonly Methods = {\n GET: 'get',\n POST: 'post',\n PUT: 'put',\n PATCH: 'patch',\n DELETE: 'delete',\n HEAD: 'head',\n OPTIONS: 'options',\n QUERY: 'query',\n } as const;\n\n /** Standard HTTP protocols (lowercase). */\n static readonly Protocols = {\n HTTP: 'http',\n HTTPS: 'https',\n } as const;\n\n /** HTTP status codes grouped by class (1xx - 5xx). */\n static readonly ResultCodes = {\n /** 1xx - Informational. */\n RS_1: {\n Continue: 100,\n SwitchingProtocols: 101,\n EarlyHints: 103,\n },\n\n /** 2xx - Success. */\n RS_2: {\n Ok: 200,\n Created: 201,\n Accepted: 202,\n NonAuthoritativeInformation: 203,\n NoContent: 204,\n ResetContent: 205,\n PartialContent: 206,\n MultiStatus: 207,\n },\n\n /** 3xx - Redirection. */\n RS_3: {\n MovedPermanently: 301,\n Found: 302,\n NotModified: 304,\n TemporaryRedirect: 307,\n PermanentRedirect: 308,\n },\n\n /** 4xx - Client error. */\n RS_4: {\n BadRequest: 400,\n Unauthorized: 401,\n PaymentRequired: 402,\n Forbidden: 403,\n NotFound: 404,\n MethodNotAllowed: 405,\n NotAcceptable: 406,\n RequestTimeout: 408,\n Conflict: 409,\n Gone: 410,\n LengthRequired: 411,\n PreconditionFailed: 412,\n ContentTooLarge: 413,\n URITooLong: 414,\n UnsupportedMediaType: 415,\n RangeNotSatisfiable: 416,\n ExpectationFailed: 417,\n UnprocessableEntity: 422,\n Locked: 423,\n FailedDependency: 424,\n TooEarly: 425,\n UpgradeRequired: 426,\n PreconditionRequired: 428,\n TooManyRequests: 429,\n RequestHeaderFieldsTooLarge: 431,\n UnavailableForLegalReasons: 451,\n },\n\n /** 5xx - Server error. */\n RS_5: {\n InternalServerError: 500,\n NotImplemented: 501,\n BadGateway: 502,\n ServiceUnavailable: 503,\n GatewayTimeout: 504,\n HTTPVersionNotSupported: 505,\n InsufficientStorage: 507,\n LoopDetected: 508,\n NetworkAuthenticationRequired: 511,\n },\n } as const;\n}\n\n/** An HTTP method from `HTTP.Methods`, in lowercase or uppercase. */\nexport type THttpMethod = ValueOf<typeof HTTP.Methods> | Uppercase<ValueOf<typeof HTTP.Methods>>;\n/** An HTTP protocol from `HTTP.Protocols`, in lowercase or uppercase. */\nexport type THttpProtocol =\n | ValueOf<typeof HTTP.Protocols>\n | Uppercase<ValueOf<typeof HTTP.Protocols>>;\n/** A numeric HTTP status code from any class in `HTTP.ResultCodes`. */\nexport type THttpResultCode = ValueOf<typeof HTTP.ResultCodes>;\n"]}
1
+ {"version":3,"file":"http.js","sourceRoot":"","sources":["../../../../src/common/constants/http.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ValueOf } from '../types';\n\n/** HTTP constants: header names, CORS headers, header values, methods, protocols and status codes. Header names, methods and protocols are lowercase. */\nexport class HTTP {\n /** Standard and common HTTP headers (lowercase per HTTP/2 convention). */\n static readonly Headers = {\n // Content\n CONTENT_DISPOSITION: 'content-disposition',\n CONTENT_ENCODING: 'content-encoding',\n CONTENT_LENGTH: 'content-length',\n CONTENT_TYPE: 'content-type',\n CONTENT_RANGE: 'content-range',\n CONTENT_SECURITY_POLICY: 'content-security-policy',\n ACCEPT_RANGES: 'accept-ranges',\n RANGE: 'range',\n\n // Request - content negotiation & conditionals\n ACCEPT: 'accept',\n ACCEPT_ENCODING: 'accept-encoding',\n ACCEPT_LANGUAGE: 'accept-language',\n AUTHORIZATION: 'authorization',\n COOKIE: 'cookie',\n HOST: 'host',\n IF_MODIFIED_SINCE: 'if-modified-since',\n IF_NONE_MATCH: 'if-none-match',\n ORIGIN: 'origin',\n REFERER: 'referer',\n USER_AGENT: 'user-agent',\n\n // Response - caching, auth challenges & redirects\n ALLOW: 'allow',\n CACHE_CONTROL: 'cache-control',\n ETAG: 'etag',\n LAST_MODIFIED: 'last-modified',\n LOCATION: 'location',\n RETRY_AFTER: 'retry-after',\n SET_COOKIE: 'set-cookie',\n VARY: 'vary',\n WWW_AUTHENTICATE: 'www-authenticate',\n\n // CORS (RFC 6454 / Fetch spec)\n ACCESS_CONTROL_ALLOW_CREDENTIALS: 'access-control-allow-credentials',\n ACCESS_CONTROL_ALLOW_HEADERS: 'access-control-allow-headers',\n ACCESS_CONTROL_ALLOW_METHODS: 'access-control-allow-methods',\n ACCESS_CONTROL_ALLOW_ORIGIN: 'access-control-allow-origin',\n ACCESS_CONTROL_EXPOSE_HEADERS: 'access-control-expose-headers',\n ACCESS_CONTROL_MAX_AGE: 'access-control-max-age',\n ACCESS_CONTROL_REQUEST_HEADERS: 'access-control-request-headers',\n ACCESS_CONTROL_REQUEST_METHOD: 'access-control-request-method',\n\n // Transport\n CONNECTION: 'connection',\n TRANSFER_ENCODING: 'transfer-encoding',\n UPGRADE: 'upgrade',\n\n // Security\n STRICT_TRANSPORT_SECURITY: 'strict-transport-security',\n X_CONTENT_TYPE_OPTIONS: 'x-content-type-options',\n X_FRAME_OPTIONS: 'x-frame-options',\n\n // Proxy / forwarding (de facto standard)\n FORWARDED: 'forwarded',\n X_FORWARDED_FOR: 'x-forwarded-for',\n X_FORWARDED_HOST: 'x-forwarded-host',\n X_FORWARDED_PROTO: 'x-forwarded-proto',\n\n // Rate limiting (de facto standard)\n X_RATELIMIT_LIMIT: 'x-ratelimit-limit',\n X_RATELIMIT_REMAINING: 'x-ratelimit-remaining',\n X_RATELIMIT_RESET: 'x-ratelimit-reset',\n\n // IGNIS custom\n REQUEST_TRACING_ID: 'x-request-id',\n REQUEST_DEVICE_INFO: 'x-device-info',\n REQUEST_CHANNEL: 'x-request-channel',\n REQUEST_COUNT_DATA: 'x-request-count',\n REQUEST_EXTRA: 'x-request-extra',\n RESPONSE_COUNT_DATA: 'x-response-count',\n RESPONSE_FORMAT: 'x-response-format',\n RESPONSE_EXTRA: 'x-response-extra',\n } as const;\n\n /**\n * The headers IGNIS adds to a request and to a response, for a CORS configuration that lists them\n * by hand: spread `ALLOW` into the allowed request headers and `EXPOSE` into the exposed ones, so\n * a header IGNIS adds later needs no change there.\n */\n static readonly CorsHeaders = {\n ALLOW: [\n 'x-request-id',\n 'x-request-count',\n 'x-request-extra',\n 'x-request-channel',\n 'x-device-info',\n ],\n EXPOSE: [\n 'content-range',\n 'x-request-id',\n 'x-response-count',\n 'x-response-format',\n 'x-response-extra',\n ],\n } as const;\n\n /** Common MIME / Content-Type values. */\n static readonly HeaderValues = {\n // Application\n APPLICATION_FORM_URLENCODED: 'application/x-www-form-urlencoded',\n APPLICATION_GRAPHQL_JSON: 'application/graphql+json',\n APPLICATION_GZIP: 'application/gzip',\n APPLICATION_JAVASCRIPT: 'application/javascript',\n APPLICATION_JSON: 'application/json',\n APPLICATION_MSGPACK: 'application/msgpack',\n APPLICATION_NDJSON: 'application/x-ndjson',\n APPLICATION_OCTET_STREAM: 'application/octet-stream',\n APPLICATION_PDF: 'application/pdf',\n APPLICATION_PROTOBUF: 'application/x-protobuf',\n APPLICATION_XML: 'application/xml',\n APPLICATION_ZIP: 'application/zip',\n\n // Multipart\n MULTIPART_FORM_DATA: 'multipart/form-data',\n\n // Text\n TEXT_CSS: 'text/css',\n TEXT_CSV: 'text/csv',\n TEXT_EVENT_STREAM: 'text/event-stream',\n TEXT_HTML: 'text/html',\n TEXT_PLAIN: 'text/plain',\n TEXT_XML: 'text/xml',\n\n // Image\n IMAGE_GIF: 'image/gif',\n IMAGE_JPEG: 'image/jpeg',\n IMAGE_PNG: 'image/png',\n IMAGE_SVG: 'image/svg+xml',\n IMAGE_WEBP: 'image/webp',\n } as const;\n\n /** Standard HTTP methods (lowercase). */\n static readonly Methods = {\n GET: 'get',\n POST: 'post',\n PUT: 'put',\n PATCH: 'patch',\n DELETE: 'delete',\n HEAD: 'head',\n OPTIONS: 'options',\n QUERY: 'query',\n } as const;\n\n /** Standard HTTP protocols (lowercase). */\n static readonly Protocols = {\n HTTP: 'http',\n HTTPS: 'https',\n } as const;\n\n /** HTTP status codes grouped by class (1xx - 5xx). */\n static readonly ResultCodes = {\n /** 1xx - Informational. */\n RS_1: {\n Continue: 100,\n SwitchingProtocols: 101,\n EarlyHints: 103,\n },\n\n /** 2xx - Success. */\n RS_2: {\n Ok: 200,\n Created: 201,\n Accepted: 202,\n NonAuthoritativeInformation: 203,\n NoContent: 204,\n ResetContent: 205,\n PartialContent: 206,\n MultiStatus: 207,\n },\n\n /** 3xx - Redirection. */\n RS_3: {\n MovedPermanently: 301,\n Found: 302,\n NotModified: 304,\n TemporaryRedirect: 307,\n PermanentRedirect: 308,\n },\n\n /** 4xx - Client error. */\n RS_4: {\n BadRequest: 400,\n Unauthorized: 401,\n PaymentRequired: 402,\n Forbidden: 403,\n NotFound: 404,\n MethodNotAllowed: 405,\n NotAcceptable: 406,\n RequestTimeout: 408,\n Conflict: 409,\n Gone: 410,\n LengthRequired: 411,\n PreconditionFailed: 412,\n ContentTooLarge: 413,\n URITooLong: 414,\n UnsupportedMediaType: 415,\n RangeNotSatisfiable: 416,\n ExpectationFailed: 417,\n UnprocessableEntity: 422,\n Locked: 423,\n FailedDependency: 424,\n TooEarly: 425,\n UpgradeRequired: 426,\n PreconditionRequired: 428,\n TooManyRequests: 429,\n RequestHeaderFieldsTooLarge: 431,\n UnavailableForLegalReasons: 451,\n },\n\n /** 5xx - Server error. */\n RS_5: {\n InternalServerError: 500,\n NotImplemented: 501,\n BadGateway: 502,\n ServiceUnavailable: 503,\n GatewayTimeout: 504,\n HTTPVersionNotSupported: 505,\n InsufficientStorage: 507,\n LoopDetected: 508,\n NetworkAuthenticationRequired: 511,\n },\n } as const;\n}\n\n/** An HTTP method from `HTTP.Methods`, in lowercase or uppercase. */\nexport type THttpMethod = ValueOf<typeof HTTP.Methods> | Uppercase<ValueOf<typeof HTTP.Methods>>;\n/** An HTTP protocol from `HTTP.Protocols`, in lowercase or uppercase. */\nexport type THttpProtocol =\n | ValueOf<typeof HTTP.Protocols>\n | Uppercase<ValueOf<typeof HTTP.Protocols>>;\n/** A numeric HTTP status code from any class in `HTTP.ResultCodes`. */\nexport type THttpResultCode = ValueOf<typeof HTTP.ResultCodes>;\n"]}
@@ -42,7 +42,8 @@ export declare abstract class BaseStorageHelper extends BaseHelper implements IS
42
42
  protected abstract writeObject(opts: IObjectLocation & {
43
43
  file: IUploadFile;
44
44
  }): Promise<void>;
45
- protected normalizeObjectName(opts: {
45
+ /** The key `upload` writes when no naming hook is given: lowercase, spaces become `_`, under the folder when there is one. Public so a naming hook can start from the very key the helper would have written. */
46
+ static normalizeObjectName(opts: {
46
47
  file: TUploadNaming;
47
48
  }): string;
48
49
  protected normalizeObjectLink(opts: IObjectLocation): string;
@@ -70,6 +71,12 @@ export declare abstract class BaseStorageHelper extends BaseHelper implements IS
70
71
  * @default BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH
71
72
  */
72
73
  maxFolderDepth?: number;
74
+ /**
75
+ * Folders the finished key may carry, a scope the `normalizeNameFn` adds included.
76
+ *
77
+ * @default `maxFolderDepth`
78
+ */
79
+ maxKeyDepth?: number;
73
80
  }): Promise<IUploadResult[]>;
74
81
  /** Correct anywhere; overridden by a backend whose transport is already a web stream. */
75
82
  getObjectStream(opts: IObjectLocation & {
@@ -106,9 +113,7 @@ export declare abstract class BaseStorageHelper extends BaseHelper implements IS
106
113
  source: IObjectRef;
107
114
  destination: IObjectRef;
108
115
  }): Promise<void>;
109
- presignPost(_opts: {
110
- bucket: IBucketRef;
111
- keyPrefix: string;
116
+ presignPost(_opts: IObjectLocation & {
112
117
  maxBytes: number;
113
118
  contentType?: string;
114
119
  expiresIn?: IDuration;
@@ -147,7 +147,8 @@ export class BaseStorageHelper extends BaseHelper {
147
147
  }
148
148
  return MimeTypes.UNKNOWN;
149
149
  }
150
- normalizeObjectName(opts) {
150
+ /** The key `upload` writes when no naming hook is given: lowercase, spaces become `_`, under the folder when there is one. Public so a naming hook can start from the very key the helper would have written. */
151
+ static normalizeObjectName(opts) {
151
152
  const { originalName, folderPath } = opts.file;
152
153
  const normalizedFileName = originalName.toLowerCase().replace(/ /g, '_');
153
154
  if (!folderPath) {
@@ -203,11 +204,15 @@ export class BaseStorageHelper extends BaseHelper {
203
204
  const folderSegments = folderPath.replace(/^\/+|\/+$/g, '').split('/');
204
205
  if (folderSegments.length > depthLimit) {
205
206
  throw getError({
207
+ error: StorageErrors.FOLDER_DEPTH_EXCEEDED,
206
208
  message: `[upload] Invalid folder path | depth: ${folderSegments.length} | max: ${depthLimit}`,
207
209
  });
208
210
  }
209
211
  if (!this.isValidKeyPath({ path: folderPath, maxDepth: depthLimit })) {
210
- throw getError({ message: '[upload] Invalid folder path' });
212
+ throw getError({
213
+ error: StorageErrors.FOLDER_PATH_INVALID,
214
+ message: '[upload] Invalid folder path',
215
+ });
211
216
  }
212
217
  }
213
218
  // Missing or negative is invalid; zero is a legitimate empty file.
@@ -217,6 +222,7 @@ export class BaseStorageHelper extends BaseHelper {
217
222
  }
218
223
  async upload(opts) {
219
224
  const { bucket, files, normalizeNameFn, normalizeLinkFn, maxFolderDepth } = opts;
225
+ const maxKeyDepth = opts.maxKeyDepth ?? maxFolderDepth;
220
226
  if (!files || files.length === 0) {
221
227
  return [];
222
228
  }
@@ -239,8 +245,8 @@ export class BaseStorageHelper extends BaseHelper {
239
245
  };
240
246
  const key = normalizeNameFn
241
247
  ? normalizeNameFn({ file: naming })
242
- : this.normalizeObjectName({ file: naming });
243
- if (!this.isValidObjectKey({ object: { key }, maxDepth: maxFolderDepth })) {
248
+ : BaseStorageHelper.normalizeObjectName({ file: naming });
249
+ if (!this.isValidObjectKey({ object: { key }, maxDepth: maxKeyDepth })) {
244
250
  throw getError({
245
251
  message: `[upload] Invalid normalized object name | name: ${EchoUtility.toSafeText({ value: key })}`,
246
252
  });
@@ -1 +1 @@
1
- {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/modules/storage/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAkB,SAAS,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAevC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE7E,+IAA+I;AAC/I,MAAM,OAAgB,iBAAkB,SAAQ,UAAU;IACxD,YAAY,IAA2C;QACrD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,WAAW,CAAC,IAA0B;QACpC,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,yHAAyH;IACzH,cAAc,CAAC,IAAyB;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC;QAE1B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CAAC,2BAA2B,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAE/E,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;YAEvE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACrE,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CACJ,2CAA2C,EAC3C,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CACxC,CAAC;YAEJ,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CAAC,kCAAkC,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAEtF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,cAAc,GAAG,kBAAkB,CAAC;QAE1C,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CAAC,wCAAwC,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAE5F,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,iBAAiB,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,0FAA0F;YAC1F,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CAAC,iEAAiE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAEzF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC;QAElE,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CACJ,iCAAiC,EACjC,UAAU,EACV,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CACxC,CAAC;YAEJ,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CACJ,6CAA6C,EAC7C,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CACxC,CAAC;YAEJ,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;aAEe,6BAAwB,GAAG,CAAC,CAAC;aAErB,SAAI,GAAG,IAAI,WAAW,EAAE,CAAC;IAEjD,ySAAyS;aACjR,2BAAsB,GAC5C,yEAAyE,CAAC;IAE5E,iGAAiG;IACjG,iBAAiB,CAAC,IAA4B;QAC5C,OAAO,IAAI,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,uGAAuG;IACvG,gBAAgB,CAAC,IAA+C;QAC9D,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAE5B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;iBAC/B,KAAK,CAAC,kCAAkC,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAErF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,sFAAsF;IAC5E,cAAc,CAAC,IAAyC;QAChE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,iBAAiB,CAAC,wBAAwB,CAAC;QAE7E,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YACzF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAElF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAErD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CAAC,+CAA+C,CAAC,CAAC;YAE1D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEvC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CACJ,mDAAmD,EACnD,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAC3C,CAAC;YAEJ,OAAO,KAAK,CAAC;QACf,CAAC;QAED,uDAAuD;QACvD,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAExC,IAAI,WAAW,GAAG,QAAQ,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CACJ,oDAAoD,EACpD,QAAQ,EACR,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAC1C,WAAW,CACZ,CAAC;YAEJ,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC,MAAM;qBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;qBAC7B,KAAK,CACJ,kDAAkD,EAClD,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAC1C,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAC3C,CAAC;gBAEJ,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC;QAExE,IAAI,UAAU,GAAG,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC7B,KAAK,CACJ,iCAAiC,EACjC,UAAU,EACV,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAC3C,CAAC;YAEJ,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,IAA0B;QACrC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAE1B,IAAI,QAAQ,EAAE,WAAW,EAAE,EAAE,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,OAAO,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,IAAI,QAAQ,EAAE,WAAW,EAAE,EAAE,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,OAAO,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,IAAI,QAAQ,EAAE,WAAW,EAAE,EAAE,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,OAAO,SAAS,CAAC,IAAI,CAAC;QACxB,CAAC;QAED,OAAO,SAAS,CAAC,OAAO,CAAC;IAC3B,CAAC;IAQS,mBAAmB,CAAC,IAA6B;QACzD,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QAC/C,MAAM,kBAAkB,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAEzE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QAED,OAAO,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,kBAAkB,EAAE,CAAC;IAChF,CAAC;IAES,mBAAmB,CAAC,IAAqB;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG;aAChC,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;aAC7C,IAAI,CAAC,GAAG,CAAC,CAAC;QAEb,OAAO,GAAG,IAAI,CAAC,iBAAiB,GAAG,UAAU,IAAI,WAAW,EAAE,CAAC;IACjE,CAAC;IAED,uGAAuG;IAC7F,mBAAmB,CAAC,IAAsB;QAClD,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAEtB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YAC9E,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC;iBAClC,KAAK,CAAC,2BAA2B,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAE/E,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,iBAAiB,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC;iBAClC,KAAK,CACJ,oEAAoE,EACpE,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CACxC,CAAC;YAEJ,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oJAAoJ;IAC1I,mBAAmB,CAAC,IAI7B;QACC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,qBAAqB,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;QAEtE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,IAI1B;QACC,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAC;QAC7D,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAEhD,MAAM,WAAW,GAAG,qBAAqB;YACvC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YAClD,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;QAEnD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,+FAA+F;QAC/F,4FAA4F;QAC5F,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,cAAc,IAAI,iBAAiB,CAAC,wBAAwB,CAAC;YAChF,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAEvE,IAAI,cAAc,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;gBACvC,MAAM,QAAQ,CAAC;oBACb,OAAO,EAAE,yCAAyC,cAAc,CAAC,MAAM,WAAW,UAAU,EAAE;iBAC/F,CAAC,CAAC;YACL,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;gBACrE,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,mEAAmE;QACnE,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,sCAAsC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAWZ;QACC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;QAEjF,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAElD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,0CAA0C,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE;aACpG,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,mBAAmB,CAAC;YACvB,KAAK;YACL,cAAc;YACd,qBAAqB,EAAE,eAAe,KAAK,SAAS;SACrD,CAAC,CAAC;QAEH,6FAA6F;QAC7F,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAC9B,MAAM,MAAM,GAAkB;gBAC5B,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC;YACF,MAAM,GAAG,GAAG,eAAe;gBACzB,CAAC,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACnC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAE/C,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;gBAC1E,MAAM,QAAQ,CAAC;oBACb,OAAO,EAAE,mDAAmD,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE;iBACrG,CAAC,CAAC;YACL,CAAC;YAED,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,kBAAkB,CAAC;YAC7B,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;gBACpC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;gBACpD,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;gBAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBAExB,MAAM,MAAM,GAAe,EAAE,GAAG,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,eAAe;oBAC1B,CAAC,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;oBACrC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAEjD,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAEjD,IAAI,CAAC,MAAM;qBACR,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;qBACrB,IAAI,CACH,8BAA8B,EAC9B,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,EAC1E,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CACtB,CAAC;gBAEJ,OAAO;oBACL,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;oBAC7B,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE;oBAC5C,IAAI;iBACL,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,yFAAyF;IACzF,KAAK,CAAC,eAAe,CACnB,IAAmE;QAEnE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAExD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAA+B,CAAC;QAC9D,CAAC;QAED,6FAA6F;QAC7F,yFAAyF;QACzF,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9C,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,OAAO,IAAI,cAAc,CAAa;YACpC,KAAK,CAAC,IAAI,CAAC,UAAU;gBACnB,OAAO,IAAI,EAAE,CAAC;oBACZ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;oBAEjC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;wBACd,UAAU,CAAC,KAAK,EAAE,CAAC;wBAEnB,OAAO;oBACT,CAAC;oBAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAmB,CAAC;oBACvC,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC;oBAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;oBACzC,MAAM,EAAE,GACN,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;oBACtF,MAAM,QAAQ,GAAG,QAAQ,GAAG,KAAK,IAAI,IAAI,GAAG,EAAE,CAAC;oBAE/C,IAAI,QAAQ,EAAE,CAAC;wBACb,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;oBAC/C,CAAC;oBAED,MAAM,GAAG,QAAQ,CAAC;oBAElB,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;wBACtC,MAAM,CAAC,OAAO,EAAE,CAAC;wBACjB,UAAU,CAAC,KAAK,EAAE,CAAC;wBAEnB,OAAO;oBACT,CAAC;oBAED,IAAI,QAAQ,EAAE,CAAC;wBACb,OAAO;oBACT,CAAC;gBACH,CAAC;YACH,CAAC;YAED,mFAAmF;YACnF,MAAM;gBACJ,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CACf,IAIC;QAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;QAErD,8GAA8G;QAC9G,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC;YACtE,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,4CAA4C,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE;aACrG,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,2CAA2C,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE;aACrG,CAAC,CAAC;QACL,CAAC;QAED,sDAAsD;QACtD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAEjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,+CAA+C,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE;aACzG,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,GACR,MAAM,YAAY,QAAQ,IAAI,MAAM,YAAY,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC1F,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEnC,MAAM,IAAI,CAAC,WAAW,CAAC;YACrB,MAAM;YACN,MAAM;YACN,IAAI,EAAE;gBACJ,YAAY,EAAE,MAAM,CAAC,GAAG;gBACxB,QAAQ,EAAE,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;gBACnE,MAAM;gBACN,IAAI,EAAE,MAAM,CAAC,MAAM;aACpB;SACF,CAAC,CAAC;IACL,CAAC;IAED,+FAA+F;IACrF,KAAK,CAAC,kBAAkB,CAAe,IAIhD;QACC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAE7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,cAAc,CAAC,gBAAgB,CAAC;YACrC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,kBAAkB,CAAC,aAAa,CAAC;YAClE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;SAC/D,CAAC,CAAC;IACL,CAAC;IAED,oGAAoG;IAC1F,cAAc,CAAC,IAA6D;QACpF,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAElD,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YAC/C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,QAAQ,CAAC;YACd,KAAK,EAAE,aAAa,CAAC,gBAAgB;YACrC,OAAO,EAAE,IAAI,SAAS,gCAAgC,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE;SAC/J,CAAC,CAAC;IACL,CAAC;IAED,mGAAmG;IACnG,KAAK,CAAC,UAAU,CAAC,KAIhB;QACC,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,+DAA+D;SAClG,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAMjB;QACC,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,qEAAqE;SACxG,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CACd,KAKC;QAED,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,kEAAkE;SACrG,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CACd,KAAgF;QAEhF,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,kEAAkE;SACrG,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAsB;QACxC,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,gEAAgE;SACnG,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,KAAyD;QAEzD,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,oEAAoE;SACvG,CAAC,CAAC;IACL,CAAC","sourcesContent":["import { ObjectUtility } from '@venizia/ignis-inversion';\nimport { ContentTypeTable, type IDuration, MimeTypes } from '@/common';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { EchoUtility } from '@/utilities/echo.utility';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { Readable } from 'node:stream';\nimport {\n type IBucketInfo,\n type IBucketRef,\n type IFileStat,\n type IListObjectsOptions,\n type IObjectInfo,\n type IObjectLocation,\n type IPostPolicy,\n type IObjectRef,\n type IStorageHelper,\n type IUploadFile,\n type IUploadResult,\n type TUploadNaming,\n} from './common';\nimport { StorageUtility, StorageConcurrency, StorageErrors } from './common';\n\n/** Shared base for storage helpers: MIME lookup, name and path validation, and upload naming. Concrete helpers implement the backend calls. */\nexport abstract class BaseStorageHelper extends BaseHelper implements IStorageHelper {\n constructor(opts: { scope: string; identifier: string }) {\n super(opts);\n }\n\n getMimeType(opts: { filename: string }): string {\n return ContentTypeTable.resolve(opts);\n }\n\n /** One path segment or file name: at most 255 UTF-8 bytes, no separator, no traversal, no control or shell character. */\n isValidSegment(opts: { segment: string }): boolean {\n const name = opts.segment;\n\n if (typeof name !== 'string') {\n this.logger\n .for(this.isValidSegment.name)\n .error('Invalid name provided: %s', EchoUtility.toSafeEcho({ value: name }));\n\n return false;\n }\n\n if (!name || ObjectUtility.isEmpty({ value: name })) {\n this.logger.for(this.isValidSegment.name).error('Empty name provided');\n\n return false;\n }\n\n if (name.includes('..') || name.includes('/') || name.includes('\\\\')) {\n this.logger\n .for(this.isValidSegment.name)\n .error(\n 'Name contains invalid path characters: %s',\n EchoUtility.toSafeEcho({ value: name }),\n );\n\n return false;\n }\n\n if (name.startsWith('.')) {\n this.logger\n .for(this.isValidSegment.name)\n .error('Name cannot start with a dot: %s', EchoUtility.toSafeEcho({ value: name }));\n\n return false;\n }\n\n const dangerousChars = /[;|&$`<>{}[\\]!#]/;\n\n if (dangerousChars.test(name)) {\n this.logger\n .for(this.isValidSegment.name)\n .error('Name contains dangerous characters: %s', EchoUtility.toSafeEcho({ value: name }));\n\n return false;\n }\n\n if (BaseStorageHelper.UNSAFE_NAME_CHARACTERS.test(name)) {\n // The length, not the name: a control character in a log line is the line's own to forge.\n this.logger\n .for(this.isValidSegment.name)\n .error('Name contains a control or bidirectional character | length: %d', name.length);\n\n return false;\n }\n\n const byteLength = BaseStorageHelper.UTF8.encode(name).byteLength;\n\n if (byteLength > 255) {\n this.logger\n .for(this.isValidSegment.name)\n .error(\n 'Name is too long (%d bytes): %s',\n byteLength,\n EchoUtility.toSafeEcho({ value: name }),\n );\n\n return false;\n }\n\n if (name.trim().length === 0) {\n this.logger\n .for(this.isValidSegment.name)\n .error(\n 'Name cannot be empty or whitespace only: %s',\n EchoUtility.toSafeEcho({ value: name }),\n );\n\n return false;\n }\n\n return true;\n }\n\n static readonly DEFAULT_MAX_FOLDER_DEPTH = 2;\n\n private static readonly UTF8 = new TextEncoder();\n\n /** Control characters, lone surrogates, the line and paragraph separators (U+2028, U+2029) and the bidirectional marks and overrides: never part of a file name or a key (the overrides make `gpj.exe` display as `exe.jpg`), and a control character or a surrogate cannot be encoded into a header. */\n private static readonly UNSAFE_NAME_CHARACTERS =\n /[\\p{Cc}\\p{Cs}\\u061C\\u200E\\u200F\\u2028\\u2029\\u202A-\\u202E\\u2066-\\u2069]/u;\n\n /** A bucket name is one segment; a separator in it would silently address a different bucket. */\n isValidBucketName(opts: { bucket: IBucketRef }): boolean {\n return this.isValidSegment({ segment: opts.bucket.name });\n }\n\n /** A whole object key: every segment valid, no trailing `/`, and no deeper than `maxDepth` folders. */\n isValidObjectKey(opts: { object: IObjectRef; maxDepth?: number }): boolean {\n const { key } = opts.object;\n\n if (typeof key === 'string' && key.endsWith('/')) {\n this.logger\n .for(this.isValidObjectKey.name)\n .error('Object key ends with a slash: %s', EchoUtility.toSafeEcho({ value: key }));\n\n return false;\n }\n\n return this.isValidKeyPath({ path: key, maxDepth: opts.maxDepth });\n }\n\n /** The shared rule behind `isValidObjectKey` and the folder check inside `upload`. */\n protected isValidKeyPath(opts: { path: string; maxDepth?: number }): boolean {\n const { path: pathStr } = opts;\n const maxDepth = opts.maxDepth ?? BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH;\n\n if (typeof pathStr !== 'string' || !pathStr || ObjectUtility.isEmpty({ value: pathStr })) {\n this.logger.for(this.isValidKeyPath.name).error('Empty or invalid path provided');\n\n return false;\n }\n\n const normalized = pathStr.replace(/^\\/+|\\/+$/g, '');\n\n if (!normalized) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error('Path resolved to empty after trimming slashes');\n\n return false;\n }\n\n const segments = normalized.split('/');\n\n if (segments.some((s) => s.length === 0)) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error(\n 'Path contains empty segments (double slashes): %s',\n EchoUtility.toSafeEcho({ value: pathStr }),\n );\n\n return false;\n }\n\n // segments include the filename, so depth is one less.\n const folderDepth = segments.length - 1;\n\n if (folderDepth > maxDepth) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error(\n 'Path exceeds max folder depth (%d): %s (depth: %d)',\n maxDepth,\n EchoUtility.toSafeEcho({ value: pathStr }),\n folderDepth,\n );\n\n return false;\n }\n\n for (const segment of segments) {\n if (!this.isValidSegment({ segment })) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error(\n 'Path segment failed validation: %s (in path: %s)',\n EchoUtility.toSafeEcho({ value: segment }),\n EchoUtility.toSafeEcho({ value: pathStr }),\n );\n\n return false;\n }\n }\n\n const byteLength = BaseStorageHelper.UTF8.encode(normalized).byteLength;\n\n if (byteLength > 1024) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error(\n 'Path is too long (%d bytes): %s',\n byteLength,\n EchoUtility.toSafeEcho({ value: pathStr }),\n );\n\n return false;\n }\n\n return true;\n }\n\n getMediaType(opts: { mimeType: string }): string {\n const { mimeType } = opts;\n\n if (mimeType?.toLowerCase()?.startsWith(MimeTypes.IMAGE)) {\n return MimeTypes.IMAGE;\n }\n\n if (mimeType?.toLowerCase()?.startsWith(MimeTypes.VIDEO)) {\n return MimeTypes.VIDEO;\n }\n\n if (mimeType?.toLowerCase()?.startsWith(MimeTypes.TEXT)) {\n return MimeTypes.TEXT;\n }\n\n return MimeTypes.UNKNOWN;\n }\n\n /** Public URL prefix; keeps its trailing slash. */\n protected abstract get defaultLinkPrefix(): string;\n\n /** Backend write step; owns its metadata and error handling. */\n protected abstract writeObject(opts: IObjectLocation & { file: IUploadFile }): Promise<void>;\n\n protected normalizeObjectName(opts: { file: TUploadNaming }): string {\n const { originalName, folderPath } = opts.file;\n const normalizedFileName = originalName.toLowerCase().replace(/ /g, '_');\n\n if (!folderPath) {\n return normalizedFileName;\n }\n\n return `${folderPath.toLowerCase().replace(/ /g, '_')}/${normalizedFileName}`;\n }\n\n protected normalizeObjectLink(opts: IObjectLocation): string {\n const bucketName = opts.bucket.name;\n const encodedName = opts.object.key\n .split('/')\n .map((segment) => encodeURIComponent(segment))\n .join('/');\n\n return `${this.defaultLinkPrefix}${bucketName}/${encodedName}`;\n }\n\n /** An original name that is only metadata - the key is resolved elsewhere and validated on its own. */\n protected isValidOriginalName(opts: { name: string }): boolean {\n const { name } = opts;\n\n if (typeof name !== 'string' || name.trim().length === 0 || name.length > 255) {\n this.logger\n .for(this.isValidOriginalName.name)\n .error('Invalid original name: %s', EchoUtility.toSafeEcho({ value: name }));\n\n return false;\n }\n\n if (BaseStorageHelper.UNSAFE_NAME_CHARACTERS.test(name)) {\n this.logger\n .for(this.isValidOriginalName.name)\n .error(\n 'Original name contains a control character or a lone surrogate: %s',\n EchoUtility.toSafeEcho({ value: name }),\n );\n\n return false;\n }\n\n return true;\n }\n\n /** `isKeyResolvedByCaller`: a `normalizeNameFn` decides the key, so the original name is metadata and meets the metadata rule, not the key rule. */\n protected validateUploadFiles(opts: {\n files: IUploadFile[];\n maxFolderDepth?: number;\n isKeyResolvedByCaller?: boolean;\n }): void {\n const { files, maxFolderDepth, isKeyResolvedByCaller = false } = opts;\n\n for (const file of files) {\n this.validateUploadFile({ file, maxFolderDepth, isKeyResolvedByCaller });\n }\n }\n\n private validateUploadFile(opts: {\n file: IUploadFile;\n maxFolderDepth?: number;\n isKeyResolvedByCaller: boolean;\n }): void {\n const { file, maxFolderDepth, isKeyResolvedByCaller } = opts;\n const { originalName, size, folderPath } = file;\n\n const isNameValid = isKeyResolvedByCaller\n ? this.isValidOriginalName({ name: originalName })\n : this.isValidSegment({ segment: originalName });\n\n if (!isNameValid) {\n throw getError({ message: '[upload] Invalid original file name' });\n }\n\n // Checked against the CALLER's depth, before the body is spooled. `isValidKeyPath` measures an\n // object path (one folder deeper than a bare folderPath), so the depth is checked directly.\n if (folderPath) {\n const depthLimit = maxFolderDepth ?? BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH;\n const folderSegments = folderPath.replace(/^\\/+|\\/+$/g, '').split('/');\n\n if (folderSegments.length > depthLimit) {\n throw getError({\n message: `[upload] Invalid folder path | depth: ${folderSegments.length} | max: ${depthLimit}`,\n });\n }\n\n if (!this.isValidKeyPath({ path: folderPath, maxDepth: depthLimit })) {\n throw getError({ message: '[upload] Invalid folder path' });\n }\n }\n\n // Missing or negative is invalid; zero is a legitimate empty file.\n if (size === undefined || size === null || size < 0) {\n throw getError({ message: `[upload] Invalid file size | size: ${size}` });\n }\n }\n\n async upload(opts: {\n bucket: IBucketRef;\n files: IUploadFile[];\n normalizeNameFn?: (opts: { file: TUploadNaming }) => string;\n normalizeLinkFn?: (opts: IObjectLocation) => string;\n /**\n * Folder nesting allowed.\n *\n * @default BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH\n */\n maxFolderDepth?: number;\n }): Promise<IUploadResult[]> {\n const { bucket, files, normalizeNameFn, normalizeLinkFn, maxFolderDepth } = opts;\n\n if (!files || files.length === 0) {\n return [];\n }\n\n const isExists = await this.hasBucket({ bucket });\n\n if (!isExists) {\n throw getError({\n message: `[upload] Bucket does not exist | name: ${EchoUtility.toSafeText({ value: bucket.name })}`,\n });\n }\n\n this.validateUploadFiles({\n files,\n maxFolderDepth,\n isKeyResolvedByCaller: normalizeNameFn !== undefined,\n });\n\n // Every key is resolved and validated before the first write, so one bad key stores nothing.\n const keys = files.map((file) => {\n const naming: TUploadNaming = {\n originalName: file.originalName,\n folderPath: file.folderPath,\n };\n const key = normalizeNameFn\n ? normalizeNameFn({ file: naming })\n : this.normalizeObjectName({ file: naming });\n\n if (!this.isValidObjectKey({ object: { key }, maxDepth: maxFolderDepth })) {\n throw getError({\n message: `[upload] Invalid normalized object name | name: ${EchoUtility.toSafeText({ value: key })}`,\n });\n }\n\n return key;\n });\n\n return this.mapWithConcurrency({\n items: files,\n task: async ({ item: file, index }) => {\n const { mimetype: mimeType, size, encoding } = file;\n const t = performance.now();\n const key = keys[index];\n\n const object: IObjectRef = { key };\n const link = normalizeLinkFn\n ? normalizeLinkFn({ bucket, object })\n : this.normalizeObjectLink({ bucket, object });\n\n await this.writeObject({ bucket, object, file });\n\n this.logger\n .for(this.upload.name)\n .info(\n 'Uploaded: %s | Took: %s (ms)',\n EchoUtility.toSafeEcho({ value: { key, link, mimeType, encoding, size } }),\n performance.now() - t,\n );\n\n return {\n bucket: { name: bucket.name },\n object: { key, size, contentType: mimeType },\n link,\n };\n },\n });\n }\n\n /** Correct anywhere; overridden by a backend whose transport is already a web stream. */\n async getObjectStream(\n opts: IObjectLocation & { range?: { start: number; end?: number } },\n ): Promise<ReadableStream<Uint8Array>> {\n const { bucket, object, range } = opts;\n const source = await this.getObject({ bucket, object });\n\n if (!range) {\n return Readable.toWeb(source) as ReadableStream<Uint8Array>;\n }\n\n // No native range here: take the window off the front of the full stream. `pull` rather than\n // `start`, so one chunk is read per demand instead of the whole range landing in memory.\n const { start, end } = range;\n const chunks = source[Symbol.asyncIterator]();\n let offset = 0;\n\n return new ReadableStream<Uint8Array>({\n async pull(controller) {\n while (true) {\n const next = await chunks.next();\n\n if (next.done) {\n controller.close();\n\n return;\n }\n\n const bytes = next.value as Uint8Array;\n const chunkEnd = offset + bytes.byteLength;\n const from = Math.max(start - offset, 0);\n const to =\n end === undefined ? bytes.byteLength : Math.min(end + 1 - offset, bytes.byteLength);\n const isWanted = chunkEnd > start && from < to;\n\n if (isWanted) {\n controller.enqueue(bytes.subarray(from, to));\n }\n\n offset = chunkEnd;\n\n if (end !== undefined && offset > end) {\n source.destroy();\n controller.close();\n\n return;\n }\n\n if (isWanted) {\n return;\n }\n }\n },\n\n // Without this a client that aborts leaves the backend stream draining to nowhere.\n cancel() {\n source.destroy();\n },\n });\n }\n\n /**\n * Correct anywhere, and the wrong path to stay on: it buffers, so a backend whose transport takes\n * a stream overrides it. `BunS3Helper` does.\n */\n async writeStream(\n opts: IObjectLocation & {\n source: ReadableStream<Uint8Array> | Blob | Response | Request;\n contentType?: string;\n maxFolderDepth?: number;\n },\n ): Promise<void> {\n const { bucket, object, source, contentType } = opts;\n\n // The same depth rule `upload` applies, as `BunS3Helper.writeStream` does: one object, two doors, one answer.\n if (!this.isValidObjectKey({ object, maxDepth: opts.maxFolderDepth })) {\n throw getError({\n message: `[writeStream] Invalid object name | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n if (!this.isValidBucketName({ bucket })) {\n throw getError({\n message: `[storage] Invalid bucket name | bucket: ${EchoUtility.toSafeText({ value: bucket.name })}`,\n });\n }\n\n // As `upload` does: a write never creates the bucket.\n const result2 = await this.hasBucket({ bucket });\n\n if (!result2) {\n throw getError({\n message: `[writeStream] Bucket does not exist | name: ${EchoUtility.toSafeText({ value: bucket.name })}`,\n });\n }\n\n const body =\n source instanceof Response || source instanceof Request ? source : new Response(source);\n const result = await body.arrayBuffer();\n const buffer = Buffer.from(result);\n\n await this.writeObject({\n bucket,\n object,\n file: {\n originalName: object.key,\n mimetype: contentType ?? this.getMimeType({ filename: object.key }),\n buffer,\n size: buffer.length,\n },\n });\n }\n\n /** Bounded fan-out on the shared limiter; unbounded exhausts sockets and gets rate limited. */\n protected async mapWithConcurrency<Item, Result>(opts: {\n items: Item[];\n limit?: number;\n task: (taskOptions: { item: Item; index: number }) => Promise<Result>;\n }): Promise<Result[]> {\n const { items, task } = opts;\n\n if (items.length === 0) {\n return [];\n }\n\n return PromiseUtility.executeWithLimit({\n limit: Math.max(1, opts.limit ?? StorageConcurrency.DEFAULT_LIMIT),\n tasks: items.map((item, index) => () => task({ item, index })),\n });\n }\n\n /** A \"not there\" failure becomes a catalogued 404; every other failure passes through unchanged. */\n protected asStorageError(opts: IObjectLocation & { error: unknown; operation: string }): unknown {\n const { error, operation, bucket, object } = opts;\n\n if (!StorageUtility.isNotFoundError({ error })) {\n return error;\n }\n\n return getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[${operation}] Object not found | bucket: ${EchoUtility.toSafeText({ value: bucket.name })} | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n // No transport for these: throwing beats returning undefined, which reads as a valid empty result.\n async copyObject(_opts: {\n bucket: IBucketRef;\n source: IObjectRef;\n destination: IObjectRef;\n }): Promise<void> {\n throw getError({\n message: `[${this.constructor.name}.copyObject] Server-side copy is not supported by this helper`,\n });\n }\n\n async presignPost(_opts: {\n bucket: IBucketRef;\n keyPrefix: string;\n maxBytes: number;\n contentType?: string;\n expiresIn?: IDuration;\n }): Promise<IPostPolicy> {\n throw getError({\n message: `[${this.constructor.name}.presignPost] Signed POST policies are not supported by this helper`,\n });\n }\n\n async presignPut(\n _opts: IObjectLocation & {\n expiresIn?: IDuration;\n tagging?: Record<string, string>;\n contentLength?: number;\n contentType?: string;\n },\n ): Promise<string> {\n throw getError({\n message: `[${this.constructor.name}.presignPut] Presigned PUT URLs are not supported by this helper`,\n });\n }\n\n async presignGet(\n _opts: IObjectLocation & { expiresIn?: IDuration; responseContentType?: string },\n ): Promise<string> {\n throw getError({\n message: `[${this.constructor.name}.presignGet] Presigned GET URLs are not supported by this helper`,\n });\n }\n\n async getObjectTags(_opts: IObjectLocation): Promise<Record<string, string>> {\n throw getError({\n message: `[${this.constructor.name}.getObjectTags] Object tagging is not supported by this helper`,\n });\n }\n\n async replaceObjectTags(\n _opts: IObjectLocation & { tags: Record<string, string> },\n ): Promise<void> {\n throw getError({\n message: `[${this.constructor.name}.replaceObjectTags] Object tagging is not supported by this helper`,\n });\n }\n\n abstract hasBucket(opts: { bucket: IBucketRef }): Promise<boolean>;\n abstract getBuckets(): Promise<IBucketInfo[]>;\n abstract getBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null>;\n abstract createBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null>;\n abstract removeBucket(opts: { bucket: IBucketRef }): Promise<boolean>;\n\n abstract getObject(opts: IObjectLocation & { options?: any }): Promise<Readable>;\n abstract getStat(opts: IObjectLocation): Promise<IFileStat>;\n abstract removeObject(opts: IObjectLocation): Promise<void>;\n abstract removeObjects(opts: { bucket: IBucketRef; objects: IObjectRef[] }): Promise<void>;\n abstract listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]>;\n}\n"]}
1
+ {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/modules/storage/base.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObjectUtility } from '@venizia/ignis-inversion';\nimport { ContentTypeTable, type IDuration, MimeTypes } from '@/common';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { EchoUtility } from '@/utilities/echo.utility';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { Readable } from 'node:stream';\nimport {\n type IBucketInfo,\n type IBucketRef,\n type IFileStat,\n type IListObjectsOptions,\n type IObjectInfo,\n type IObjectLocation,\n type IPostPolicy,\n type IObjectRef,\n type IStorageHelper,\n type IUploadFile,\n type IUploadResult,\n type TUploadNaming,\n} from './common';\nimport { StorageUtility, StorageConcurrency, StorageErrors } from './common';\n\n/** Shared base for storage helpers: MIME lookup, name and path validation, and upload naming. Concrete helpers implement the backend calls. */\nexport abstract class BaseStorageHelper extends BaseHelper implements IStorageHelper {\n constructor(opts: { scope: string; identifier: string }) {\n super(opts);\n }\n\n getMimeType(opts: { filename: string }): string {\n return ContentTypeTable.resolve(opts);\n }\n\n /** One path segment or file name: at most 255 UTF-8 bytes, no separator, no traversal, no control or shell character. */\n isValidSegment(opts: { segment: string }): boolean {\n const name = opts.segment;\n\n if (typeof name !== 'string') {\n this.logger\n .for(this.isValidSegment.name)\n .error('Invalid name provided: %s', EchoUtility.toSafeEcho({ value: name }));\n\n return false;\n }\n\n if (!name || ObjectUtility.isEmpty({ value: name })) {\n this.logger.for(this.isValidSegment.name).error('Empty name provided');\n\n return false;\n }\n\n if (name.includes('..') || name.includes('/') || name.includes('\\\\')) {\n this.logger\n .for(this.isValidSegment.name)\n .error(\n 'Name contains invalid path characters: %s',\n EchoUtility.toSafeEcho({ value: name }),\n );\n\n return false;\n }\n\n if (name.startsWith('.')) {\n this.logger\n .for(this.isValidSegment.name)\n .error('Name cannot start with a dot: %s', EchoUtility.toSafeEcho({ value: name }));\n\n return false;\n }\n\n const dangerousChars = /[;|&$`<>{}[\\]!#]/;\n\n if (dangerousChars.test(name)) {\n this.logger\n .for(this.isValidSegment.name)\n .error('Name contains dangerous characters: %s', EchoUtility.toSafeEcho({ value: name }));\n\n return false;\n }\n\n if (BaseStorageHelper.UNSAFE_NAME_CHARACTERS.test(name)) {\n // The length, not the name: a control character in a log line is the line's own to forge.\n this.logger\n .for(this.isValidSegment.name)\n .error('Name contains a control or bidirectional character | length: %d', name.length);\n\n return false;\n }\n\n const byteLength = BaseStorageHelper.UTF8.encode(name).byteLength;\n\n if (byteLength > 255) {\n this.logger\n .for(this.isValidSegment.name)\n .error(\n 'Name is too long (%d bytes): %s',\n byteLength,\n EchoUtility.toSafeEcho({ value: name }),\n );\n\n return false;\n }\n\n if (name.trim().length === 0) {\n this.logger\n .for(this.isValidSegment.name)\n .error(\n 'Name cannot be empty or whitespace only: %s',\n EchoUtility.toSafeEcho({ value: name }),\n );\n\n return false;\n }\n\n return true;\n }\n\n static readonly DEFAULT_MAX_FOLDER_DEPTH = 2;\n\n private static readonly UTF8 = new TextEncoder();\n\n /** Control characters, lone surrogates, the line and paragraph separators (U+2028, U+2029) and the bidirectional marks and overrides: never part of a file name or a key (the overrides make `gpj.exe` display as `exe.jpg`), and a control character or a surrogate cannot be encoded into a header. */\n private static readonly UNSAFE_NAME_CHARACTERS =\n /[\\p{Cc}\\p{Cs}\\u061C\\u200E\\u200F\\u2028\\u2029\\u202A-\\u202E\\u2066-\\u2069]/u;\n\n /** A bucket name is one segment; a separator in it would silently address a different bucket. */\n isValidBucketName(opts: { bucket: IBucketRef }): boolean {\n return this.isValidSegment({ segment: opts.bucket.name });\n }\n\n /** A whole object key: every segment valid, no trailing `/`, and no deeper than `maxDepth` folders. */\n isValidObjectKey(opts: { object: IObjectRef; maxDepth?: number }): boolean {\n const { key } = opts.object;\n\n if (typeof key === 'string' && key.endsWith('/')) {\n this.logger\n .for(this.isValidObjectKey.name)\n .error('Object key ends with a slash: %s', EchoUtility.toSafeEcho({ value: key }));\n\n return false;\n }\n\n return this.isValidKeyPath({ path: key, maxDepth: opts.maxDepth });\n }\n\n /** The shared rule behind `isValidObjectKey` and the folder check inside `upload`. */\n protected isValidKeyPath(opts: { path: string; maxDepth?: number }): boolean {\n const { path: pathStr } = opts;\n const maxDepth = opts.maxDepth ?? BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH;\n\n if (typeof pathStr !== 'string' || !pathStr || ObjectUtility.isEmpty({ value: pathStr })) {\n this.logger.for(this.isValidKeyPath.name).error('Empty or invalid path provided');\n\n return false;\n }\n\n const normalized = pathStr.replace(/^\\/+|\\/+$/g, '');\n\n if (!normalized) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error('Path resolved to empty after trimming slashes');\n\n return false;\n }\n\n const segments = normalized.split('/');\n\n if (segments.some((s) => s.length === 0)) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error(\n 'Path contains empty segments (double slashes): %s',\n EchoUtility.toSafeEcho({ value: pathStr }),\n );\n\n return false;\n }\n\n // segments include the filename, so depth is one less.\n const folderDepth = segments.length - 1;\n\n if (folderDepth > maxDepth) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error(\n 'Path exceeds max folder depth (%d): %s (depth: %d)',\n maxDepth,\n EchoUtility.toSafeEcho({ value: pathStr }),\n folderDepth,\n );\n\n return false;\n }\n\n for (const segment of segments) {\n if (!this.isValidSegment({ segment })) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error(\n 'Path segment failed validation: %s (in path: %s)',\n EchoUtility.toSafeEcho({ value: segment }),\n EchoUtility.toSafeEcho({ value: pathStr }),\n );\n\n return false;\n }\n }\n\n const byteLength = BaseStorageHelper.UTF8.encode(normalized).byteLength;\n\n if (byteLength > 1024) {\n this.logger\n .for(this.isValidKeyPath.name)\n .error(\n 'Path is too long (%d bytes): %s',\n byteLength,\n EchoUtility.toSafeEcho({ value: pathStr }),\n );\n\n return false;\n }\n\n return true;\n }\n\n getMediaType(opts: { mimeType: string }): string {\n const { mimeType } = opts;\n\n if (mimeType?.toLowerCase()?.startsWith(MimeTypes.IMAGE)) {\n return MimeTypes.IMAGE;\n }\n\n if (mimeType?.toLowerCase()?.startsWith(MimeTypes.VIDEO)) {\n return MimeTypes.VIDEO;\n }\n\n if (mimeType?.toLowerCase()?.startsWith(MimeTypes.TEXT)) {\n return MimeTypes.TEXT;\n }\n\n return MimeTypes.UNKNOWN;\n }\n\n /** Public URL prefix; keeps its trailing slash. */\n protected abstract get defaultLinkPrefix(): string;\n\n /** Backend write step; owns its metadata and error handling. */\n protected abstract writeObject(opts: IObjectLocation & { file: IUploadFile }): Promise<void>;\n\n /** The key `upload` writes when no naming hook is given: lowercase, spaces become `_`, under the folder when there is one. Public so a naming hook can start from the very key the helper would have written. */\n static normalizeObjectName(opts: { file: TUploadNaming }): string {\n const { originalName, folderPath } = opts.file;\n const normalizedFileName = originalName.toLowerCase().replace(/ /g, '_');\n\n if (!folderPath) {\n return normalizedFileName;\n }\n\n return `${folderPath.toLowerCase().replace(/ /g, '_')}/${normalizedFileName}`;\n }\n\n protected normalizeObjectLink(opts: IObjectLocation): string {\n const bucketName = opts.bucket.name;\n const encodedName = opts.object.key\n .split('/')\n .map((segment) => encodeURIComponent(segment))\n .join('/');\n\n return `${this.defaultLinkPrefix}${bucketName}/${encodedName}`;\n }\n\n /** An original name that is only metadata - the key is resolved elsewhere and validated on its own. */\n protected isValidOriginalName(opts: { name: string }): boolean {\n const { name } = opts;\n\n if (typeof name !== 'string' || name.trim().length === 0 || name.length > 255) {\n this.logger\n .for(this.isValidOriginalName.name)\n .error('Invalid original name: %s', EchoUtility.toSafeEcho({ value: name }));\n\n return false;\n }\n\n if (BaseStorageHelper.UNSAFE_NAME_CHARACTERS.test(name)) {\n this.logger\n .for(this.isValidOriginalName.name)\n .error(\n 'Original name contains a control character or a lone surrogate: %s',\n EchoUtility.toSafeEcho({ value: name }),\n );\n\n return false;\n }\n\n return true;\n }\n\n /** `isKeyResolvedByCaller`: a `normalizeNameFn` decides the key, so the original name is metadata and meets the metadata rule, not the key rule. */\n protected validateUploadFiles(opts: {\n files: IUploadFile[];\n maxFolderDepth?: number;\n isKeyResolvedByCaller?: boolean;\n }): void {\n const { files, maxFolderDepth, isKeyResolvedByCaller = false } = opts;\n\n for (const file of files) {\n this.validateUploadFile({ file, maxFolderDepth, isKeyResolvedByCaller });\n }\n }\n\n private validateUploadFile(opts: {\n file: IUploadFile;\n maxFolderDepth?: number;\n isKeyResolvedByCaller: boolean;\n }): void {\n const { file, maxFolderDepth, isKeyResolvedByCaller } = opts;\n const { originalName, size, folderPath } = file;\n\n const isNameValid = isKeyResolvedByCaller\n ? this.isValidOriginalName({ name: originalName })\n : this.isValidSegment({ segment: originalName });\n\n if (!isNameValid) {\n throw getError({ message: '[upload] Invalid original file name' });\n }\n\n // Checked against the CALLER's depth, before the body is spooled. `isValidKeyPath` measures an\n // object path (one folder deeper than a bare folderPath), so the depth is checked directly.\n if (folderPath) {\n const depthLimit = maxFolderDepth ?? BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH;\n const folderSegments = folderPath.replace(/^\\/+|\\/+$/g, '').split('/');\n\n if (folderSegments.length > depthLimit) {\n throw getError({\n error: StorageErrors.FOLDER_DEPTH_EXCEEDED,\n message: `[upload] Invalid folder path | depth: ${folderSegments.length} | max: ${depthLimit}`,\n });\n }\n\n if (!this.isValidKeyPath({ path: folderPath, maxDepth: depthLimit })) {\n throw getError({\n error: StorageErrors.FOLDER_PATH_INVALID,\n message: '[upload] Invalid folder path',\n });\n }\n }\n\n // Missing or negative is invalid; zero is a legitimate empty file.\n if (size === undefined || size === null || size < 0) {\n throw getError({ message: `[upload] Invalid file size | size: ${size}` });\n }\n }\n\n async upload(opts: {\n bucket: IBucketRef;\n files: IUploadFile[];\n normalizeNameFn?: (opts: { file: TUploadNaming }) => string;\n normalizeLinkFn?: (opts: IObjectLocation) => string;\n /**\n * Folder nesting allowed.\n *\n * @default BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH\n */\n maxFolderDepth?: number;\n /**\n * Folders the finished key may carry, a scope the `normalizeNameFn` adds included.\n *\n * @default `maxFolderDepth`\n */\n maxKeyDepth?: number;\n }): Promise<IUploadResult[]> {\n const { bucket, files, normalizeNameFn, normalizeLinkFn, maxFolderDepth } = opts;\n const maxKeyDepth = opts.maxKeyDepth ?? maxFolderDepth;\n\n if (!files || files.length === 0) {\n return [];\n }\n\n const isExists = await this.hasBucket({ bucket });\n\n if (!isExists) {\n throw getError({\n message: `[upload] Bucket does not exist | name: ${EchoUtility.toSafeText({ value: bucket.name })}`,\n });\n }\n\n this.validateUploadFiles({\n files,\n maxFolderDepth,\n isKeyResolvedByCaller: normalizeNameFn !== undefined,\n });\n\n // Every key is resolved and validated before the first write, so one bad key stores nothing.\n const keys = files.map((file) => {\n const naming: TUploadNaming = {\n originalName: file.originalName,\n folderPath: file.folderPath,\n };\n const key = normalizeNameFn\n ? normalizeNameFn({ file: naming })\n : BaseStorageHelper.normalizeObjectName({ file: naming });\n\n if (!this.isValidObjectKey({ object: { key }, maxDepth: maxKeyDepth })) {\n throw getError({\n message: `[upload] Invalid normalized object name | name: ${EchoUtility.toSafeText({ value: key })}`,\n });\n }\n\n return key;\n });\n\n return this.mapWithConcurrency({\n items: files,\n task: async ({ item: file, index }) => {\n const { mimetype: mimeType, size, encoding } = file;\n const t = performance.now();\n const key = keys[index];\n\n const object: IObjectRef = { key };\n const link = normalizeLinkFn\n ? normalizeLinkFn({ bucket, object })\n : this.normalizeObjectLink({ bucket, object });\n\n await this.writeObject({ bucket, object, file });\n\n this.logger\n .for(this.upload.name)\n .info(\n 'Uploaded: %s | Took: %s (ms)',\n EchoUtility.toSafeEcho({ value: { key, link, mimeType, encoding, size } }),\n performance.now() - t,\n );\n\n return {\n bucket: { name: bucket.name },\n object: { key, size, contentType: mimeType },\n link,\n };\n },\n });\n }\n\n /** Correct anywhere; overridden by a backend whose transport is already a web stream. */\n async getObjectStream(\n opts: IObjectLocation & { range?: { start: number; end?: number } },\n ): Promise<ReadableStream<Uint8Array>> {\n const { bucket, object, range } = opts;\n const source = await this.getObject({ bucket, object });\n\n if (!range) {\n return Readable.toWeb(source) as ReadableStream<Uint8Array>;\n }\n\n // No native range here: take the window off the front of the full stream. `pull` rather than\n // `start`, so one chunk is read per demand instead of the whole range landing in memory.\n const { start, end } = range;\n const chunks = source[Symbol.asyncIterator]();\n let offset = 0;\n\n return new ReadableStream<Uint8Array>({\n async pull(controller) {\n while (true) {\n const next = await chunks.next();\n\n if (next.done) {\n controller.close();\n\n return;\n }\n\n const bytes = next.value as Uint8Array;\n const chunkEnd = offset + bytes.byteLength;\n const from = Math.max(start - offset, 0);\n const to =\n end === undefined ? bytes.byteLength : Math.min(end + 1 - offset, bytes.byteLength);\n const isWanted = chunkEnd > start && from < to;\n\n if (isWanted) {\n controller.enqueue(bytes.subarray(from, to));\n }\n\n offset = chunkEnd;\n\n if (end !== undefined && offset > end) {\n source.destroy();\n controller.close();\n\n return;\n }\n\n if (isWanted) {\n return;\n }\n }\n },\n\n // Without this a client that aborts leaves the backend stream draining to nowhere.\n cancel() {\n source.destroy();\n },\n });\n }\n\n /**\n * Correct anywhere, and the wrong path to stay on: it buffers, so a backend whose transport takes\n * a stream overrides it. `BunS3Helper` does.\n */\n async writeStream(\n opts: IObjectLocation & {\n source: ReadableStream<Uint8Array> | Blob | Response | Request;\n contentType?: string;\n maxFolderDepth?: number;\n },\n ): Promise<void> {\n const { bucket, object, source, contentType } = opts;\n\n // The same depth rule `upload` applies, as `BunS3Helper.writeStream` does: one object, two doors, one answer.\n if (!this.isValidObjectKey({ object, maxDepth: opts.maxFolderDepth })) {\n throw getError({\n message: `[writeStream] Invalid object name | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n if (!this.isValidBucketName({ bucket })) {\n throw getError({\n message: `[storage] Invalid bucket name | bucket: ${EchoUtility.toSafeText({ value: bucket.name })}`,\n });\n }\n\n // As `upload` does: a write never creates the bucket.\n const result2 = await this.hasBucket({ bucket });\n\n if (!result2) {\n throw getError({\n message: `[writeStream] Bucket does not exist | name: ${EchoUtility.toSafeText({ value: bucket.name })}`,\n });\n }\n\n const body =\n source instanceof Response || source instanceof Request ? source : new Response(source);\n const result = await body.arrayBuffer();\n const buffer = Buffer.from(result);\n\n await this.writeObject({\n bucket,\n object,\n file: {\n originalName: object.key,\n mimetype: contentType ?? this.getMimeType({ filename: object.key }),\n buffer,\n size: buffer.length,\n },\n });\n }\n\n /** Bounded fan-out on the shared limiter; unbounded exhausts sockets and gets rate limited. */\n protected async mapWithConcurrency<Item, Result>(opts: {\n items: Item[];\n limit?: number;\n task: (taskOptions: { item: Item; index: number }) => Promise<Result>;\n }): Promise<Result[]> {\n const { items, task } = opts;\n\n if (items.length === 0) {\n return [];\n }\n\n return PromiseUtility.executeWithLimit({\n limit: Math.max(1, opts.limit ?? StorageConcurrency.DEFAULT_LIMIT),\n tasks: items.map((item, index) => () => task({ item, index })),\n });\n }\n\n /** A \"not there\" failure becomes a catalogued 404; every other failure passes through unchanged. */\n protected asStorageError(opts: IObjectLocation & { error: unknown; operation: string }): unknown {\n const { error, operation, bucket, object } = opts;\n\n if (!StorageUtility.isNotFoundError({ error })) {\n return error;\n }\n\n return getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[${operation}] Object not found | bucket: ${EchoUtility.toSafeText({ value: bucket.name })} | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n // No transport for these: throwing beats returning undefined, which reads as a valid empty result.\n async copyObject(_opts: {\n bucket: IBucketRef;\n source: IObjectRef;\n destination: IObjectRef;\n }): Promise<void> {\n throw getError({\n message: `[${this.constructor.name}.copyObject] Server-side copy is not supported by this helper`,\n });\n }\n\n async presignPost(\n _opts: IObjectLocation & {\n maxBytes: number;\n contentType?: string;\n expiresIn?: IDuration;\n },\n ): Promise<IPostPolicy> {\n throw getError({\n message: `[${this.constructor.name}.presignPost] Signed POST policies are not supported by this helper`,\n });\n }\n\n async presignPut(\n _opts: IObjectLocation & {\n expiresIn?: IDuration;\n tagging?: Record<string, string>;\n contentLength?: number;\n contentType?: string;\n },\n ): Promise<string> {\n throw getError({\n message: `[${this.constructor.name}.presignPut] Presigned PUT URLs are not supported by this helper`,\n });\n }\n\n async presignGet(\n _opts: IObjectLocation & { expiresIn?: IDuration; responseContentType?: string },\n ): Promise<string> {\n throw getError({\n message: `[${this.constructor.name}.presignGet] Presigned GET URLs are not supported by this helper`,\n });\n }\n\n async getObjectTags(_opts: IObjectLocation): Promise<Record<string, string>> {\n throw getError({\n message: `[${this.constructor.name}.getObjectTags] Object tagging is not supported by this helper`,\n });\n }\n\n async replaceObjectTags(\n _opts: IObjectLocation & { tags: Record<string, string> },\n ): Promise<void> {\n throw getError({\n message: `[${this.constructor.name}.replaceObjectTags] Object tagging is not supported by this helper`,\n });\n }\n\n abstract hasBucket(opts: { bucket: IBucketRef }): Promise<boolean>;\n abstract getBuckets(): Promise<IBucketInfo[]>;\n abstract getBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null>;\n abstract createBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null>;\n abstract removeBucket(opts: { bucket: IBucketRef }): Promise<boolean>;\n\n abstract getObject(opts: IObjectLocation & { options?: any }): Promise<Readable>;\n abstract getStat(opts: IObjectLocation): Promise<IFileStat>;\n abstract removeObject(opts: IObjectLocation): Promise<void>;\n abstract removeObjects(opts: { bucket: IBucketRef; objects: IObjectRef[] }): Promise<void>;\n abstract listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]>;\n}\n"]}
@@ -28,6 +28,7 @@ export interface IBunS3HelperOptions extends IStorageHelperOptions {
28
28
  }
29
29
  /** Storage helper for S3-compatible object stores through Bun's `S3Client`. Uses separate hosts for calls this process makes and for URLs handed to browsers. */
30
30
  export declare class BunS3Helper extends BaseStorageHelper {
31
+ readonly storageType = "bun-s3";
31
32
  private client;
32
33
  private credentials;
33
34
  /** Undefined leaves Bun's own defaults in force. */
@@ -62,9 +63,7 @@ export declare class BunS3Helper extends BaseStorageHelper {
62
63
  source: IObjectRef;
63
64
  destination: IObjectRef;
64
65
  }): Promise<void>;
65
- presignPost(opts: {
66
- bucket: IBucketRef;
67
- keyPrefix: string;
66
+ presignPost(opts: IObjectLocation & {
68
67
  maxBytes: number;
69
68
  contentType?: string;
70
69
  expiresIn?: IDuration;
@@ -4,7 +4,7 @@ import { EchoUtility } from '../../../utilities/echo.utility.js';
4
4
  import { S3Client } from 'bun';
5
5
  import { Readable } from 'node:stream';
6
6
  import { BaseStorageHelper } from '../base.js';
7
- import { S3Audiences, StorageUtility, StoragePresignDefaults } from '../common/index.js';
7
+ import { S3Audiences, StorageTypes, StorageUtility, StoragePresignDefaults } from '../common/index.js';
8
8
  import { S3SignatureUtility } from './utility.js';
9
9
  /** One lower-case DNS label: the only shape a bucket may have when it becomes part of a host. */
10
10
  const S3_HOST_LABEL_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
@@ -15,6 +15,7 @@ export class BunS3Helper extends BaseStorageHelper {
15
15
  scope: options.scope ?? BunS3Helper.name,
16
16
  identifier: options.identifier ?? BunS3Helper.name,
17
17
  });
18
+ this.storageType = StorageTypes.BUN_S3;
18
19
  this.credentials = {
19
20
  accessKey: options.accessKey,
20
21
  secretKey: options.secretKey,
@@ -217,17 +218,17 @@ export class BunS3Helper extends BaseStorageHelper {
217
218
  }
218
219
  }
219
220
  async presignPost(opts) {
220
- const { bucket, keyPrefix, maxBytes, contentType, expiresIn = StoragePresignDefaults.POST_EXPIRES_IN, } = opts;
221
+ const { bucket, object, maxBytes, contentType, expiresIn = StoragePresignDefaults.POST_EXPIRES_IN, } = opts;
221
222
  const { accessKey, secretKey, region, sessionToken } = this.credentials;
222
- // The browser posts to the BUCKET, not to an object - the key travels as a form field, because
223
- // the policy only constrains its prefix.
223
+ // The browser posts to the BUCKET, not to an object - the key travels as a form field, which the
224
+ // policy pins to this one value.
224
225
  const { endpoint, pathPrefix } = this.objectEndpoint({
225
226
  bucket: bucket.name,
226
227
  audience: S3Audiences.BROWSER,
227
228
  });
228
229
  const { formData, expiresAt } = await S3SignatureUtility.buildPostPolicy({
229
230
  bucket: bucket.name,
230
- keyPrefix,
231
+ key: object.key,
231
232
  maxBytes,
232
233
  expiresInSeconds: StorageUtility.toExpirySeconds({ expiresIn, operation: 'presignPost' }),
233
234
  accessKey,
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/storage/bun-s3/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IDuration } from '@/common';\nimport { getError } from '@/modules/error';\nimport { ErrorPrettier } from '@/modules/logger';\nimport { EchoUtility } from '@/utilities/echo.utility';\nimport { S3Client } from 'bun';\nimport { Readable } from 'node:stream';\nimport { BaseStorageHelper } from '../base';\nimport type {\n IBucketInfo,\n IBucketRef,\n IFileStat,\n IListObjectsOptions,\n IObjectInfo,\n IObjectLocation,\n IObjectRef,\n IPostPolicy,\n IStorageHelperOptions,\n IUploadFile,\n} from '../common';\nimport { S3Audiences, StorageUtility, StoragePresignDefaults } from '../common';\nimport type { TS3Audience } from '../common';\nimport { S3SignatureUtility } from './utility';\n\n/** One lower-case DNS label: the only shape a bucket may have when it becomes part of a host. */\nconst S3_HOST_LABEL_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;\n\n/** Options for `BunS3Helper`. Unset `partSize`, `queueSize` and `retry` leave Bun defaults in force. */\nexport interface IBunS3HelperOptions extends IStorageHelperOptions {\n accessKey: string;\n secretKey: string;\n /** @default 'us-east-1' */\n region?: string;\n sessionToken?: string;\n /** `default` is the host THIS process talks to; `public` is the host a browser is handed. `host` is inside every SigV4 signature, so a URL signed against an internal name cannot be rewritten later - which is why the two are separate rather than one value patched afterwards. */\n endpoint: {\n default: string;\n /** @default endpoint.default */\n public?: string;\n };\n\n /**\n * `https://<bucket>.<endpoint>/<key>` instead of `<endpoint>/<bucket>/<key>`. AWS requires it; MinIO and R2 do not.\n *\n * @default false\n */\n virtualHostedStyle?: boolean;\n partSize?: number;\n queueSize?: number;\n\n /** Retries Bun performs on a failed part before the write fails. */\n retry?: number;\n}\n\n/** Storage helper for S3-compatible object stores through Bun's `S3Client`. Uses separate hosts for calls this process makes and for URLs handed to browsers. */\nexport class BunS3Helper extends BaseStorageHelper {\n private client: S3Client;\n private credentials: {\n accessKey: string;\n secretKey: string;\n endpoint: { default: string; public: string };\n region: string;\n sessionToken?: string;\n virtualHostedStyle: boolean;\n };\n\n /** Undefined leaves Bun's own defaults in force. */\n private transfer: { partSize?: number; queueSize?: number; retry?: number };\n\n constructor(options: IBunS3HelperOptions) {\n super({\n scope: options.scope ?? BunS3Helper.name,\n identifier: options.identifier ?? BunS3Helper.name,\n });\n\n this.credentials = {\n accessKey: options.accessKey,\n secretKey: options.secretKey,\n endpoint: {\n default: options.endpoint.default,\n // Falls back to the default, so one reachable host still serves both audiences.\n public: options.endpoint.public ?? options.endpoint.default,\n },\n region: options.region ?? 'us-east-1',\n sessionToken: options.sessionToken,\n virtualHostedStyle: options.virtualHostedStyle ?? false,\n };\n\n this.transfer = {\n partSize: options.partSize,\n queueSize: options.queueSize,\n retry: options.retry,\n };\n\n this.client = new S3Client({\n accessKeyId: options.accessKey,\n secretAccessKey: options.secretKey,\n endpoint: options.endpoint.default,\n region: options.region,\n sessionToken: options.sessionToken,\n virtualHostedStyle: options.virtualHostedStyle,\n });\n }\n\n /** One bucket's objects, in either addressing style. `audience` picks the host: `server` for a call this process makes, `browser` for a URL it hands out. Virtual-hosted derives the per-bucket host, because the bucket arrives per call. */\n private objectEndpoint(opts: { bucket: string; audience: TS3Audience }): {\n endpoint: string;\n pathPrefix: string;\n } {\n const { endpoint, virtualHostedStyle } = this.credentials;\n const host = opts.audience === S3Audiences.BROWSER ? endpoint.public : endpoint.default;\n\n if (!virtualHostedStyle) {\n return { endpoint: host, pathPrefix: `/${opts.bucket}` };\n }\n\n // The bucket becomes a label of the host, so it must be one: anything else (a dot, a slash, an `@`, a port) would steer the request to another host.\n if (!S3_HOST_LABEL_PATTERN.test(opts.bucket)) {\n throw getError({\n message: `[objectEndpoint] A bucket used in a host must be one lower-case DNS label (a-z, 0-9, hyphen; 1-63 characters) | bucket: '${EchoUtility.toSafeText({ value: opts.bucket })}'`,\n });\n }\n\n const parsed = new URL(host);\n parsed.hostname = `${opts.bucket}.${parsed.hostname}`;\n\n return { endpoint: parsed.origin, pathPrefix: '' };\n }\n\n /** Per-call overrides, so one client serves every bucket in either addressing style. */\n private presignOptions(opts: { bucket: string }): {\n bucket: string;\n endpoint: string;\n virtualHostedStyle?: boolean;\n } {\n const { virtualHostedStyle } = this.credentials;\n const { endpoint } = this.objectEndpoint({\n bucket: opts.bucket,\n audience: S3Audiences.BROWSER,\n });\n\n return {\n bucket: opts.bucket,\n endpoint,\n ...(virtualHostedStyle ? { virtualHostedStyle: true } : {}),\n };\n }\n\n /**\n * What a call this process makes on one bucket's objects (or its listing) passes to Bun's client. Path style needs only the\n * bucket. Virtual-hosted style needs the bucket's own host as well: Bun puts the bucket in neither the host nor the path in that\n * mode, so a call without it goes to the bare endpoint (`PUT /k.png` on the endpoint host) and never reaches the object.\n */\n private callOptions(opts: { bucket: string }): {\n bucket: string;\n endpoint?: string;\n virtualHostedStyle?: boolean;\n } {\n if (!this.credentials.virtualHostedStyle) {\n return { bucket: opts.bucket };\n }\n\n const { endpoint } = this.objectEndpoint({ bucket: opts.bucket, audience: S3Audiences.SERVER });\n\n return { bucket: opts.bucket, endpoint, virtualHostedStyle: true };\n }\n\n async hasBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n return false;\n }\n\n try {\n await this.client.list({ maxKeys: 1 }, this.callOptions({ bucket: name }));\n\n return true;\n } catch (error) {\n // A missing bucket is the answer; a credentials or network failure is not, and must not vanish.\n if (!StorageUtility.isNotFoundError({ error })) {\n this.logger.warn(\n '[hasBucket] Cannot determine bucket existence - reporting false | bucket: %s | %s',\n EchoUtility.toSafeEcho({ value: name }),\n ErrorPrettier.format({ error }),\n );\n }\n\n return false;\n }\n }\n\n async getBuckets(): Promise<IBucketInfo[]> {\n // A bucket operation is a call this process makes, so it goes to the default host.\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const endpoint = this.credentials.endpoint.default;\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'GET',\n endpoint,\n path: '/',\n accessKey,\n secretKey,\n region,\n sessionToken,\n });\n\n const response = await fetch(url, { method: 'GET', headers });\n const xml = await response.text();\n\n if (!response.ok) {\n throw getError({ message: `[getBuckets] S3 error: ${xml}` });\n }\n\n const buckets: IBucketInfo[] = [];\n const bucketMatches = xml.matchAll(\n /<Bucket>\\s*<Name>(.*?)<\\/Name>\\s*<CreationDate>(.*?)<\\/CreationDate>\\s*<\\/Bucket>/gs,\n );\n\n for (const match of bucketMatches) {\n buckets.push({\n name: match[1],\n creationDate: new Date(match[2]),\n });\n }\n\n return buckets;\n }\n\n /** S3 exposes a creation date only through `ListBuckets`, so one full listing is the cheapest correct answer. */\n async getBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n return null;\n }\n\n const buckets = await this.getBuckets();\n\n return buckets.find((bucket) => bucket.name === name) ?? null;\n }\n\n async createBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n throw getError({ message: '[createBucket] Invalid name to create bucket!' });\n }\n\n // A bucket operation is a call this process makes, so it goes to the default host.\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const endpoint = this.credentials.endpoint.default;\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'PUT',\n endpoint,\n path: `/${name}`,\n accessKey: accessKey,\n secretKey,\n region,\n sessionToken,\n });\n\n const response = await fetch(url, { method: 'PUT', headers });\n\n if (!response.ok) {\n const xml = await response.text();\n throw getError({ message: `[createBucket] S3 error: ${xml}` });\n }\n\n return this.getBucket(opts);\n }\n\n async removeBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n throw getError({ message: '[removeBucket] Invalid name to remove bucket!' });\n }\n\n // A bucket operation is a call this process makes, so it goes to the default host.\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const endpoint = this.credentials.endpoint.default;\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'DELETE',\n endpoint,\n path: `/${name}`,\n accessKey: accessKey,\n secretKey: secretKey,\n region,\n sessionToken,\n });\n\n const response = await fetch(url, { method: 'DELETE', headers });\n\n if (!response.ok) {\n const xml = await response.text();\n throw getError({ message: `[removeBucket] S3 error: ${xml}` });\n }\n\n return true;\n }\n\n override async copyObject(opts: {\n bucket: IBucketRef;\n source: IObjectRef;\n destination: IObjectRef;\n }): Promise<void> {\n const { bucket, source, destination } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucket.name,\n audience: S3Audiences.SERVER,\n });\n\n // `x-amz-copy-source` is what makes this server side: S3 reads the source itself, so a 500 MB\n // object never travels through this process. The encoded value is both signed and sent.\n const request = await S3SignatureUtility.buildSignedRequest({\n method: 'PUT',\n endpoint,\n path: `${pathPrefix}/${destination.key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n headers: {\n 'x-amz-copy-source': S3SignatureUtility.buildCopySource({\n bucket: bucket.name,\n key: source.key,\n }),\n },\n });\n\n const response = await fetch(request.url, { method: 'PUT', headers: request.headers });\n\n if (!response.ok) {\n throw getError({\n message: `[copyObject] Copy failed | bucket: ${EchoUtility.toSafeText({ value: bucket.name })} | source: ${EchoUtility.toSafeText({ value: source.key })} | status: ${response.status}`,\n });\n }\n }\n\n override async presignPost(opts: {\n bucket: IBucketRef;\n keyPrefix: string;\n maxBytes: number;\n contentType?: string;\n expiresIn?: IDuration;\n }): Promise<IPostPolicy> {\n const {\n bucket,\n keyPrefix,\n maxBytes,\n contentType,\n expiresIn = StoragePresignDefaults.POST_EXPIRES_IN,\n } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n\n // The browser posts to the BUCKET, not to an object - the key travels as a form field, because\n // the policy only constrains its prefix.\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucket.name,\n audience: S3Audiences.BROWSER,\n });\n const { formData, expiresAt } = await S3SignatureUtility.buildPostPolicy({\n bucket: bucket.name,\n keyPrefix,\n maxBytes,\n expiresInSeconds: StorageUtility.toExpirySeconds({ expiresIn, operation: 'presignPost' }),\n accessKey,\n secretKey,\n region,\n sessionToken,\n contentType,\n });\n\n return { postURL: `${endpoint.replace(/\\/$/, '')}${pathPrefix}`, formData, expiresAt };\n }\n\n override async presignPut(\n opts: IObjectLocation & {\n expiresIn?: IDuration;\n tagging?: Record<string, string>;\n contentLength?: number;\n contentType?: string;\n },\n ): Promise<string> {\n const {\n bucket,\n object,\n tagging,\n contentLength,\n contentType,\n expiresIn = StoragePresignDefaults.PUT_EXPIRES_IN,\n } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n\n // Not `client.presign`: its options are method and expiry only, and a tag that is merely SENT\n // is a tag S3 ignores. These two have to be inside the signature to exist at all.\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucket.name,\n audience: S3Audiences.BROWSER,\n });\n\n return S3SignatureUtility.buildPresignedUrl({\n method: 'PUT',\n endpoint,\n path: `${pathPrefix}/${object.key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n expiresInSeconds: StorageUtility.toExpirySeconds({ expiresIn, operation: 'presignPut' }),\n headers: {\n ...(tagging\n ? { 'x-amz-tagging': S3SignatureUtility.buildTaggingHeader({ tags: tagging }) }\n : {}),\n ...(contentLength === undefined ? {} : { 'content-length': String(contentLength) }),\n ...(contentType ? { 'content-type': contentType } : {}),\n },\n });\n }\n\n override async presignGet(\n opts: IObjectLocation & {\n expiresIn?: IDuration;\n responseContentType?: string;\n responseContentDisposition?: string;\n },\n ): Promise<string> {\n const {\n bucket,\n object,\n expiresIn = StoragePresignDefaults.GET_EXPIRES_IN,\n responseContentType,\n responseContentDisposition,\n } = opts;\n\n return this.client.presign(object.key, {\n ...this.presignOptions({ bucket: bucket.name }),\n method: 'GET',\n expiresIn: StorageUtility.toExpirySeconds({ expiresIn, operation: 'presignGet' }),\n ...(responseContentType ? { type: responseContentType } : {}),\n ...(responseContentDisposition ? { contentDisposition: responseContentDisposition } : {}),\n });\n }\n\n override async getObjectTags(opts: IObjectLocation): Promise<Record<string, string>> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucketName,\n audience: S3Audiences.SERVER,\n });\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'GET',\n endpoint,\n path: `${pathPrefix}/${key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n query: { tagging: '' },\n });\n\n const response = await fetch(url, { method: 'GET', headers });\n\n // S3 answers a missing tag set with 404: the empty case, not a failure.\n if (response.status === 404) {\n return {};\n }\n\n const body = await response.text();\n\n if (!response.ok) {\n throw getError({\n message: `[getObjectTags] S3 error | status: ${response.status} | body: ${body}`,\n });\n }\n\n return S3SignatureUtility.parseTaggingXml({ xml: body });\n }\n\n override async replaceObjectTags(\n opts: IObjectLocation & { tags: Record<string, string> },\n ): Promise<void> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const { tags } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucketName,\n audience: S3Audiences.SERVER,\n });\n const requestBody = S3SignatureUtility.buildTaggingXml({ tags });\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'PUT',\n endpoint,\n path: `${pathPrefix}/${key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n query: { tagging: '' },\n body: requestBody,\n });\n\n const response = await fetch(url, { method: 'PUT', headers, body: requestBody });\n\n if (!response.ok) {\n const body = await response.text();\n throw getError({\n message: `[replaceObjectTags] S3 error | status: ${response.status} | body: ${body}`,\n });\n }\n }\n\n protected get defaultLinkPrefix(): string {\n return '/static-assets/';\n }\n\n protected async writeObject(opts: IObjectLocation & { file: IUploadFile }): Promise<void> {\n const { file } = opts;\n const bucketName = opts.bucket.name;\n const { mimetype: mimeType, buffer } = file;\n\n await this.client.write(opts.object.key, buffer, {\n ...this.callOptions({ bucket: bucketName }),\n type: mimeType,\n partSize: this.transfer.partSize,\n queueSize: this.transfer.queueSize,\n retry: this.transfer.retry,\n });\n }\n\n /** Streams without holding the object in memory. `upload` carries a `Buffer`, so it cannot; this is the path for anything large. */\n override async writeStream(\n opts: IObjectLocation & {\n source: ReadableStream<Uint8Array> | Blob | Response | Request;\n contentType?: string;\n maxFolderDepth?: number;\n },\n ): Promise<void> {\n const { bucket, object, source, contentType } = opts;\n\n // The same depth rule `upload` applies: one object, two doors, one answer.\n if (!this.isValidObjectKey({ object, maxDepth: opts.maxFolderDepth })) {\n throw getError({\n message: `[writeStream] Invalid object name | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n // Bun's `write` takes a Response, not a bare ReadableStream; wrapping streams, never buffers.\n const body = source instanceof ReadableStream ? new Response(source) : source;\n\n await this.client.write(object.key, body, {\n ...this.callOptions({ bucket: bucket.name }),\n ...(contentType ? { type: contentType } : {}),\n partSize: this.transfer.partSize,\n queueSize: this.transfer.queueSize,\n retry: this.transfer.retry,\n });\n }\n\n /** `S3File.stream()` is lazy: it reaches the network on first read, so a `try` here never sees a 404 - the failure arrives on the stream. */\n async getObject(opts: IObjectLocation & { options?: any }): Promise<Readable> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const source = this.client.file(key, this.callOptions({ bucket: bucketName })).stream();\n\n return Readable.fromWeb(source as ReadableStream<Uint8Array>, {\n // Keeps backpressure meaningful rather than draining S3 into memory.\n objectMode: false,\n });\n }\n\n /** The conversion-free path a `Response` body wants. `slice` makes it a ranged GET, so only the requested bytes leave S3. */\n override async getObjectStream(\n opts: IObjectLocation & { range?: { start: number; end?: number } },\n ): Promise<ReadableStream<Uint8Array>> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const { range } = opts;\n const file = this.client.file(key, this.callOptions({ bucket: bucketName }));\n\n if (!range) {\n return file.stream() as ReadableStream<Uint8Array>;\n }\n\n // HTTP ranges include `end`; `slice` excludes it.\n const window =\n range.end === undefined ? file.slice(range.start) : file.slice(range.start, range.end + 1);\n\n return window.stream() as ReadableStream<Uint8Array>;\n }\n\n async getStat(opts: IObjectLocation): Promise<IFileStat> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n\n try {\n const stat = await this.client.stat(key, this.callOptions({ bucket: bucketName }));\n\n return {\n size: stat.size,\n // One key, not two spellings. The served type comes from the object name; this is diagnostic.\n metadata: { mimetype: stat.type },\n lastModified: stat.lastModified,\n etag: stat.etag,\n };\n } catch (error) {\n throw this.asStorageError({\n error,\n operation: 'getStat',\n bucket: opts.bucket,\n object: opts.object,\n });\n }\n }\n\n async removeObject(opts: IObjectLocation): Promise<void> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n\n try {\n await this.client.delete(key, this.callOptions({ bucket: bucketName }));\n } catch (error) {\n throw this.asStorageError({\n error,\n operation: 'removeObject',\n bucket: opts.bucket,\n object: opts.object,\n });\n }\n }\n\n async removeObjects(opts: { bucket: IBucketRef; objects: IObjectRef[] }): Promise<void> {\n const { bucket, objects } = opts;\n\n await this.mapWithConcurrency({\n items: objects,\n task: ({ item: object }) => this.removeObject({ bucket, object }),\n });\n }\n\n /** S3 caps a call at 1000 keys and continues through `nextContinuationToken`. `useRecursive: false` maps to `delimiter: '/'`. */\n async listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]> {\n const { prefix, useRecursive = false, maxKeys } = opts;\n const bucketName = opts.bucket.name;\n\n // `maxKeys: 0` means zero, not unlimited.\n const limit = maxKeys ?? Number.POSITIVE_INFINITY;\n\n if (limit <= 0) {\n return [];\n }\n\n const objects: IObjectInfo[] = [];\n let continuationToken: string | undefined;\n\n do {\n const remaining = limit - objects.length;\n const response = await this.client.list(\n {\n prefix,\n continuationToken,\n ...(useRecursive ? {} : { delimiter: '/' }),\n ...(Number.isFinite(remaining) ? { maxKeys: Math.min(remaining, 1000) } : {}),\n },\n this.callOptions({ bucket: bucketName }),\n );\n\n const responseContents = response.contents ?? [];\n\n for (const entry of responseContents) {\n objects.push({\n name: entry.key,\n size: entry.size,\n lastModified: entry.lastModified ? new Date(entry.lastModified) : undefined,\n etag: entry.eTag,\n });\n }\n\n continuationToken = response.isTruncated ? response.nextContinuationToken : undefined;\n } while (continuationToken && objects.length < limit);\n\n return objects;\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/storage/bun-s3/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IDuration } from '@/common';\nimport { getError } from '@/modules/error';\nimport { ErrorPrettier } from '@/modules/logger';\nimport { EchoUtility } from '@/utilities/echo.utility';\nimport { S3Client } from 'bun';\nimport { Readable } from 'node:stream';\nimport { BaseStorageHelper } from '../base';\nimport type {\n IBucketInfo,\n IBucketRef,\n IFileStat,\n IListObjectsOptions,\n IObjectInfo,\n IObjectLocation,\n IObjectRef,\n IPostPolicy,\n IStorageHelperOptions,\n IUploadFile,\n} from '../common';\nimport { S3Audiences, StorageTypes, StorageUtility, StoragePresignDefaults } from '../common';\nimport type { TS3Audience } from '../common';\nimport { S3SignatureUtility } from './utility';\n\n/** One lower-case DNS label: the only shape a bucket may have when it becomes part of a host. */\nconst S3_HOST_LABEL_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;\n\n/** Options for `BunS3Helper`. Unset `partSize`, `queueSize` and `retry` leave Bun defaults in force. */\nexport interface IBunS3HelperOptions extends IStorageHelperOptions {\n accessKey: string;\n secretKey: string;\n /** @default 'us-east-1' */\n region?: string;\n sessionToken?: string;\n /** `default` is the host THIS process talks to; `public` is the host a browser is handed. `host` is inside every SigV4 signature, so a URL signed against an internal name cannot be rewritten later - which is why the two are separate rather than one value patched afterwards. */\n endpoint: {\n default: string;\n /** @default endpoint.default */\n public?: string;\n };\n\n /**\n * `https://<bucket>.<endpoint>/<key>` instead of `<endpoint>/<bucket>/<key>`. AWS requires it; MinIO and R2 do not.\n *\n * @default false\n */\n virtualHostedStyle?: boolean;\n partSize?: number;\n queueSize?: number;\n\n /** Retries Bun performs on a failed part before the write fails. */\n retry?: number;\n}\n\n/** Storage helper for S3-compatible object stores through Bun's `S3Client`. Uses separate hosts for calls this process makes and for URLs handed to browsers. */\nexport class BunS3Helper extends BaseStorageHelper {\n readonly storageType = StorageTypes.BUN_S3;\n\n private client: S3Client;\n private credentials: {\n accessKey: string;\n secretKey: string;\n endpoint: { default: string; public: string };\n region: string;\n sessionToken?: string;\n virtualHostedStyle: boolean;\n };\n\n /** Undefined leaves Bun's own defaults in force. */\n private transfer: { partSize?: number; queueSize?: number; retry?: number };\n\n constructor(options: IBunS3HelperOptions) {\n super({\n scope: options.scope ?? BunS3Helper.name,\n identifier: options.identifier ?? BunS3Helper.name,\n });\n\n this.credentials = {\n accessKey: options.accessKey,\n secretKey: options.secretKey,\n endpoint: {\n default: options.endpoint.default,\n // Falls back to the default, so one reachable host still serves both audiences.\n public: options.endpoint.public ?? options.endpoint.default,\n },\n region: options.region ?? 'us-east-1',\n sessionToken: options.sessionToken,\n virtualHostedStyle: options.virtualHostedStyle ?? false,\n };\n\n this.transfer = {\n partSize: options.partSize,\n queueSize: options.queueSize,\n retry: options.retry,\n };\n\n this.client = new S3Client({\n accessKeyId: options.accessKey,\n secretAccessKey: options.secretKey,\n endpoint: options.endpoint.default,\n region: options.region,\n sessionToken: options.sessionToken,\n virtualHostedStyle: options.virtualHostedStyle,\n });\n }\n\n /** One bucket's objects, in either addressing style. `audience` picks the host: `server` for a call this process makes, `browser` for a URL it hands out. Virtual-hosted derives the per-bucket host, because the bucket arrives per call. */\n private objectEndpoint(opts: { bucket: string; audience: TS3Audience }): {\n endpoint: string;\n pathPrefix: string;\n } {\n const { endpoint, virtualHostedStyle } = this.credentials;\n const host = opts.audience === S3Audiences.BROWSER ? endpoint.public : endpoint.default;\n\n if (!virtualHostedStyle) {\n return { endpoint: host, pathPrefix: `/${opts.bucket}` };\n }\n\n // The bucket becomes a label of the host, so it must be one: anything else (a dot, a slash, an `@`, a port) would steer the request to another host.\n if (!S3_HOST_LABEL_PATTERN.test(opts.bucket)) {\n throw getError({\n message: `[objectEndpoint] A bucket used in a host must be one lower-case DNS label (a-z, 0-9, hyphen; 1-63 characters) | bucket: '${EchoUtility.toSafeText({ value: opts.bucket })}'`,\n });\n }\n\n const parsed = new URL(host);\n parsed.hostname = `${opts.bucket}.${parsed.hostname}`;\n\n return { endpoint: parsed.origin, pathPrefix: '' };\n }\n\n /** Per-call overrides, so one client serves every bucket in either addressing style. */\n private presignOptions(opts: { bucket: string }): {\n bucket: string;\n endpoint: string;\n virtualHostedStyle?: boolean;\n } {\n const { virtualHostedStyle } = this.credentials;\n const { endpoint } = this.objectEndpoint({\n bucket: opts.bucket,\n audience: S3Audiences.BROWSER,\n });\n\n return {\n bucket: opts.bucket,\n endpoint,\n ...(virtualHostedStyle ? { virtualHostedStyle: true } : {}),\n };\n }\n\n /**\n * What a call this process makes on one bucket's objects (or its listing) passes to Bun's client. Path style needs only the\n * bucket. Virtual-hosted style needs the bucket's own host as well: Bun puts the bucket in neither the host nor the path in that\n * mode, so a call without it goes to the bare endpoint (`PUT /k.png` on the endpoint host) and never reaches the object.\n */\n private callOptions(opts: { bucket: string }): {\n bucket: string;\n endpoint?: string;\n virtualHostedStyle?: boolean;\n } {\n if (!this.credentials.virtualHostedStyle) {\n return { bucket: opts.bucket };\n }\n\n const { endpoint } = this.objectEndpoint({ bucket: opts.bucket, audience: S3Audiences.SERVER });\n\n return { bucket: opts.bucket, endpoint, virtualHostedStyle: true };\n }\n\n async hasBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n return false;\n }\n\n try {\n await this.client.list({ maxKeys: 1 }, this.callOptions({ bucket: name }));\n\n return true;\n } catch (error) {\n // A missing bucket is the answer; a credentials or network failure is not, and must not vanish.\n if (!StorageUtility.isNotFoundError({ error })) {\n this.logger.warn(\n '[hasBucket] Cannot determine bucket existence - reporting false | bucket: %s | %s',\n EchoUtility.toSafeEcho({ value: name }),\n ErrorPrettier.format({ error }),\n );\n }\n\n return false;\n }\n }\n\n async getBuckets(): Promise<IBucketInfo[]> {\n // A bucket operation is a call this process makes, so it goes to the default host.\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const endpoint = this.credentials.endpoint.default;\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'GET',\n endpoint,\n path: '/',\n accessKey,\n secretKey,\n region,\n sessionToken,\n });\n\n const response = await fetch(url, { method: 'GET', headers });\n const xml = await response.text();\n\n if (!response.ok) {\n throw getError({ message: `[getBuckets] S3 error: ${xml}` });\n }\n\n const buckets: IBucketInfo[] = [];\n const bucketMatches = xml.matchAll(\n /<Bucket>\\s*<Name>(.*?)<\\/Name>\\s*<CreationDate>(.*?)<\\/CreationDate>\\s*<\\/Bucket>/gs,\n );\n\n for (const match of bucketMatches) {\n buckets.push({\n name: match[1],\n creationDate: new Date(match[2]),\n });\n }\n\n return buckets;\n }\n\n /** S3 exposes a creation date only through `ListBuckets`, so one full listing is the cheapest correct answer. */\n async getBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n return null;\n }\n\n const buckets = await this.getBuckets();\n\n return buckets.find((bucket) => bucket.name === name) ?? null;\n }\n\n async createBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n throw getError({ message: '[createBucket] Invalid name to create bucket!' });\n }\n\n // A bucket operation is a call this process makes, so it goes to the default host.\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const endpoint = this.credentials.endpoint.default;\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'PUT',\n endpoint,\n path: `/${name}`,\n accessKey: accessKey,\n secretKey,\n region,\n sessionToken,\n });\n\n const response = await fetch(url, { method: 'PUT', headers });\n\n if (!response.ok) {\n const xml = await response.text();\n throw getError({ message: `[createBucket] S3 error: ${xml}` });\n }\n\n return this.getBucket(opts);\n }\n\n async removeBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n throw getError({ message: '[removeBucket] Invalid name to remove bucket!' });\n }\n\n // A bucket operation is a call this process makes, so it goes to the default host.\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const endpoint = this.credentials.endpoint.default;\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'DELETE',\n endpoint,\n path: `/${name}`,\n accessKey: accessKey,\n secretKey: secretKey,\n region,\n sessionToken,\n });\n\n const response = await fetch(url, { method: 'DELETE', headers });\n\n if (!response.ok) {\n const xml = await response.text();\n throw getError({ message: `[removeBucket] S3 error: ${xml}` });\n }\n\n return true;\n }\n\n override async copyObject(opts: {\n bucket: IBucketRef;\n source: IObjectRef;\n destination: IObjectRef;\n }): Promise<void> {\n const { bucket, source, destination } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucket.name,\n audience: S3Audiences.SERVER,\n });\n\n // `x-amz-copy-source` is what makes this server side: S3 reads the source itself, so a 500 MB\n // object never travels through this process. The encoded value is both signed and sent.\n const request = await S3SignatureUtility.buildSignedRequest({\n method: 'PUT',\n endpoint,\n path: `${pathPrefix}/${destination.key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n headers: {\n 'x-amz-copy-source': S3SignatureUtility.buildCopySource({\n bucket: bucket.name,\n key: source.key,\n }),\n },\n });\n\n const response = await fetch(request.url, { method: 'PUT', headers: request.headers });\n\n if (!response.ok) {\n throw getError({\n message: `[copyObject] Copy failed | bucket: ${EchoUtility.toSafeText({ value: bucket.name })} | source: ${EchoUtility.toSafeText({ value: source.key })} | status: ${response.status}`,\n });\n }\n }\n\n override async presignPost(\n opts: IObjectLocation & {\n maxBytes: number;\n contentType?: string;\n expiresIn?: IDuration;\n },\n ): Promise<IPostPolicy> {\n const {\n bucket,\n object,\n maxBytes,\n contentType,\n expiresIn = StoragePresignDefaults.POST_EXPIRES_IN,\n } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n\n // The browser posts to the BUCKET, not to an object - the key travels as a form field, which the\n // policy pins to this one value.\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucket.name,\n audience: S3Audiences.BROWSER,\n });\n const { formData, expiresAt } = await S3SignatureUtility.buildPostPolicy({\n bucket: bucket.name,\n key: object.key,\n maxBytes,\n expiresInSeconds: StorageUtility.toExpirySeconds({ expiresIn, operation: 'presignPost' }),\n accessKey,\n secretKey,\n region,\n sessionToken,\n contentType,\n });\n\n return { postURL: `${endpoint.replace(/\\/$/, '')}${pathPrefix}`, formData, expiresAt };\n }\n\n override async presignPut(\n opts: IObjectLocation & {\n expiresIn?: IDuration;\n tagging?: Record<string, string>;\n contentLength?: number;\n contentType?: string;\n },\n ): Promise<string> {\n const {\n bucket,\n object,\n tagging,\n contentLength,\n contentType,\n expiresIn = StoragePresignDefaults.PUT_EXPIRES_IN,\n } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n\n // Not `client.presign`: its options are method and expiry only, and a tag that is merely SENT\n // is a tag S3 ignores. These two have to be inside the signature to exist at all.\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucket.name,\n audience: S3Audiences.BROWSER,\n });\n\n return S3SignatureUtility.buildPresignedUrl({\n method: 'PUT',\n endpoint,\n path: `${pathPrefix}/${object.key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n expiresInSeconds: StorageUtility.toExpirySeconds({ expiresIn, operation: 'presignPut' }),\n headers: {\n ...(tagging\n ? { 'x-amz-tagging': S3SignatureUtility.buildTaggingHeader({ tags: tagging }) }\n : {}),\n ...(contentLength === undefined ? {} : { 'content-length': String(contentLength) }),\n ...(contentType ? { 'content-type': contentType } : {}),\n },\n });\n }\n\n override async presignGet(\n opts: IObjectLocation & {\n expiresIn?: IDuration;\n responseContentType?: string;\n responseContentDisposition?: string;\n },\n ): Promise<string> {\n const {\n bucket,\n object,\n expiresIn = StoragePresignDefaults.GET_EXPIRES_IN,\n responseContentType,\n responseContentDisposition,\n } = opts;\n\n return this.client.presign(object.key, {\n ...this.presignOptions({ bucket: bucket.name }),\n method: 'GET',\n expiresIn: StorageUtility.toExpirySeconds({ expiresIn, operation: 'presignGet' }),\n ...(responseContentType ? { type: responseContentType } : {}),\n ...(responseContentDisposition ? { contentDisposition: responseContentDisposition } : {}),\n });\n }\n\n override async getObjectTags(opts: IObjectLocation): Promise<Record<string, string>> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucketName,\n audience: S3Audiences.SERVER,\n });\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'GET',\n endpoint,\n path: `${pathPrefix}/${key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n query: { tagging: '' },\n });\n\n const response = await fetch(url, { method: 'GET', headers });\n\n // S3 answers a missing tag set with 404: the empty case, not a failure.\n if (response.status === 404) {\n return {};\n }\n\n const body = await response.text();\n\n if (!response.ok) {\n throw getError({\n message: `[getObjectTags] S3 error | status: ${response.status} | body: ${body}`,\n });\n }\n\n return S3SignatureUtility.parseTaggingXml({ xml: body });\n }\n\n override async replaceObjectTags(\n opts: IObjectLocation & { tags: Record<string, string> },\n ): Promise<void> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const { tags } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucketName,\n audience: S3Audiences.SERVER,\n });\n const requestBody = S3SignatureUtility.buildTaggingXml({ tags });\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'PUT',\n endpoint,\n path: `${pathPrefix}/${key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n query: { tagging: '' },\n body: requestBody,\n });\n\n const response = await fetch(url, { method: 'PUT', headers, body: requestBody });\n\n if (!response.ok) {\n const body = await response.text();\n throw getError({\n message: `[replaceObjectTags] S3 error | status: ${response.status} | body: ${body}`,\n });\n }\n }\n\n protected get defaultLinkPrefix(): string {\n return '/static-assets/';\n }\n\n protected async writeObject(opts: IObjectLocation & { file: IUploadFile }): Promise<void> {\n const { file } = opts;\n const bucketName = opts.bucket.name;\n const { mimetype: mimeType, buffer } = file;\n\n await this.client.write(opts.object.key, buffer, {\n ...this.callOptions({ bucket: bucketName }),\n type: mimeType,\n partSize: this.transfer.partSize,\n queueSize: this.transfer.queueSize,\n retry: this.transfer.retry,\n });\n }\n\n /** Streams without holding the object in memory. `upload` carries a `Buffer`, so it cannot; this is the path for anything large. */\n override async writeStream(\n opts: IObjectLocation & {\n source: ReadableStream<Uint8Array> | Blob | Response | Request;\n contentType?: string;\n maxFolderDepth?: number;\n },\n ): Promise<void> {\n const { bucket, object, source, contentType } = opts;\n\n // The same depth rule `upload` applies: one object, two doors, one answer.\n if (!this.isValidObjectKey({ object, maxDepth: opts.maxFolderDepth })) {\n throw getError({\n message: `[writeStream] Invalid object name | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n // Bun's `write` takes a Response, not a bare ReadableStream; wrapping streams, never buffers.\n const body = source instanceof ReadableStream ? new Response(source) : source;\n\n await this.client.write(object.key, body, {\n ...this.callOptions({ bucket: bucket.name }),\n ...(contentType ? { type: contentType } : {}),\n partSize: this.transfer.partSize,\n queueSize: this.transfer.queueSize,\n retry: this.transfer.retry,\n });\n }\n\n /** `S3File.stream()` is lazy: it reaches the network on first read, so a `try` here never sees a 404 - the failure arrives on the stream. */\n async getObject(opts: IObjectLocation & { options?: any }): Promise<Readable> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const source = this.client.file(key, this.callOptions({ bucket: bucketName })).stream();\n\n return Readable.fromWeb(source as ReadableStream<Uint8Array>, {\n // Keeps backpressure meaningful rather than draining S3 into memory.\n objectMode: false,\n });\n }\n\n /** The conversion-free path a `Response` body wants. `slice` makes it a ranged GET, so only the requested bytes leave S3. */\n override async getObjectStream(\n opts: IObjectLocation & { range?: { start: number; end?: number } },\n ): Promise<ReadableStream<Uint8Array>> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const { range } = opts;\n const file = this.client.file(key, this.callOptions({ bucket: bucketName }));\n\n if (!range) {\n return file.stream() as ReadableStream<Uint8Array>;\n }\n\n // HTTP ranges include `end`; `slice` excludes it.\n const window =\n range.end === undefined ? file.slice(range.start) : file.slice(range.start, range.end + 1);\n\n return window.stream() as ReadableStream<Uint8Array>;\n }\n\n async getStat(opts: IObjectLocation): Promise<IFileStat> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n\n try {\n const stat = await this.client.stat(key, this.callOptions({ bucket: bucketName }));\n\n return {\n size: stat.size,\n // One key, not two spellings. The served type comes from the object name; this is diagnostic.\n metadata: { mimetype: stat.type },\n lastModified: stat.lastModified,\n etag: stat.etag,\n };\n } catch (error) {\n throw this.asStorageError({\n error,\n operation: 'getStat',\n bucket: opts.bucket,\n object: opts.object,\n });\n }\n }\n\n async removeObject(opts: IObjectLocation): Promise<void> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n\n try {\n await this.client.delete(key, this.callOptions({ bucket: bucketName }));\n } catch (error) {\n throw this.asStorageError({\n error,\n operation: 'removeObject',\n bucket: opts.bucket,\n object: opts.object,\n });\n }\n }\n\n async removeObjects(opts: { bucket: IBucketRef; objects: IObjectRef[] }): Promise<void> {\n const { bucket, objects } = opts;\n\n await this.mapWithConcurrency({\n items: objects,\n task: ({ item: object }) => this.removeObject({ bucket, object }),\n });\n }\n\n /** S3 caps a call at 1000 keys and continues through `nextContinuationToken`. `useRecursive: false` maps to `delimiter: '/'`. */\n async listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]> {\n const { prefix, useRecursive = false, maxKeys } = opts;\n const bucketName = opts.bucket.name;\n\n // `maxKeys: 0` means zero, not unlimited.\n const limit = maxKeys ?? Number.POSITIVE_INFINITY;\n\n if (limit <= 0) {\n return [];\n }\n\n const objects: IObjectInfo[] = [];\n let continuationToken: string | undefined;\n\n do {\n const remaining = limit - objects.length;\n const response = await this.client.list(\n {\n prefix,\n continuationToken,\n ...(useRecursive ? {} : { delimiter: '/' }),\n ...(Number.isFinite(remaining) ? { maxKeys: Math.min(remaining, 1000) } : {}),\n },\n this.callOptions({ bucket: bucketName }),\n );\n\n const responseContents = response.contents ?? [];\n\n for (const entry of responseContents) {\n objects.push({\n name: entry.key,\n size: entry.size,\n lastModified: entry.lastModified ? new Date(entry.lastModified) : undefined,\n etag: entry.eTag,\n });\n }\n\n continuationToken = response.isTruncated ? response.nextContinuationToken : undefined;\n } while (continuationToken && objects.length < limit);\n\n return objects;\n }\n}\n"]}
@@ -58,7 +58,8 @@ export declare class S3SignatureUtility {
58
58
  */
59
59
  static buildPostPolicy(opts: {
60
60
  bucket: string;
61
- keyPrefix: string;
61
+ /** The ONE key the form may be posted under. */
62
+ key: string;
62
63
  maxBytes: number;
63
64
  expiresInSeconds: number;
64
65
  accessKey: string;
@@ -179,7 +179,7 @@ export class S3SignatureUtility {
179
179
  * expressible at all.
180
180
  */
181
181
  static async buildPostPolicy(opts) {
182
- const { bucket, keyPrefix, maxBytes, expiresInSeconds, accessKey, secretKey, region, sessionToken, contentType, } = opts;
182
+ const { bucket, key, maxBytes, expiresInSeconds, accessKey, secretKey, region, sessionToken, contentType, } = opts;
183
183
  const now = new Date();
184
184
  const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now });
185
185
  const credentialScope = `${dateStamp}/${region}/s3/aws4_request`;
@@ -194,9 +194,9 @@ export class S3SignatureUtility {
194
194
  };
195
195
  const conditions = [
196
196
  { bucket },
197
- ['starts-with', '$key', keyPrefix],
197
+ { key },
198
198
  ['content-length-range', 0, maxBytes],
199
- ...Object.entries(fields).map(([key, value]) => ({ [key]: value })),
199
+ ...Object.entries(fields).map(([fieldName, fieldValue]) => ({ [fieldName]: fieldValue })),
200
200
  ...(contentType ? [{ 'Content-Type': contentType }] : []),
201
201
  ];
202
202
  const policy = Buffer.from(JSON.stringify({ expiration: expiresAt, conditions })).toString('base64');
@@ -204,6 +204,7 @@ export class S3SignatureUtility {
204
204
  const result = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: policy });
205
205
  return {
206
206
  formData: {
207
+ key,
207
208
  ...fields,
208
209
  ...(contentType ? { 'Content-Type': contentType } : {}),
209
210
  policy,
@@ -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 keyPrefix: 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 keyPrefix,\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 ['starts-with', '$key', keyPrefix],\n ['content-length-range', 0, maxBytes],\n ...Object.entries(fields).map(([key, value]) => ({ [key]: value })),\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 ...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 { 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,4 +1,11 @@
1
1
  import { type IDuration, type TConstValue } from '../../../common/index.js';
2
+ /** The backend a storage helper writes to. A helper declares its own, so a caller never tells one apart with `instanceof`. */
3
+ export declare class StorageTypes {
4
+ static readonly DISK = "disk";
5
+ static readonly BUN_S3 = "bun-s3";
6
+ }
7
+ /** One of the `StorageTypes` values. */
8
+ export type TStorageType = TConstValue<typeof StorageTypes>;
2
9
  /** Presign expiry defaults - a PUT or a POST form carries a file and needs more time; a GET is a redirect. */
3
10
  export declare class StoragePresignDefaults {
4
11
  static readonly PUT_EXPIRES_IN: IDuration;
@@ -1,4 +1,9 @@
1
1
  import { DurationUnits } from '../../../common/index.js';
2
+ /** The backend a storage helper writes to. A helper declares its own, so a caller never tells one apart with `instanceof`. */
3
+ export class StorageTypes {
4
+ static { this.DISK = 'disk'; }
5
+ static { this.BUN_S3 = 'bun-s3'; }
6
+ }
2
7
  /** Presign expiry defaults - a PUT or a POST form carries a file and needs more time; a GET is a redirect. */
3
8
  export class StoragePresignDefaults {
4
9
  static { this.PUT_EXPIRES_IN = { unit: DurationUnits.MINUTE, value: 10 }; }
@@ -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,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/** 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,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"]}
@@ -9,6 +9,23 @@ export declare const StorageErrors: {
9
9
  readonly statusCode: 404;
10
10
  readonly category: "business";
11
11
  };
12
+ /** An upload named a folder the storage refuses: a segment it cannot hold, or an empty path. */
13
+ readonly FOLDER_PATH_INVALID: {
14
+ readonly message: {
15
+ readonly text: "Invalid folder path";
16
+ readonly code: "core.storage.folder_path_invalid";
17
+ };
18
+ readonly statusCode: 400;
19
+ readonly category: "validation";
20
+ };
21
+ readonly FOLDER_DEPTH_EXCEEDED: {
22
+ readonly message: {
23
+ readonly text: "Folder path exceeds the maximum depth";
24
+ readonly code: "core.storage.folder_depth_exceeded";
25
+ };
26
+ readonly statusCode: 400;
27
+ readonly category: "validation";
28
+ };
12
29
  };
13
30
  /** Augments inversion, not helpers: TS only treats this as an augmentation when the file imports that module. */
14
31
  declare module '@venizia/ignis-inversion' {
@@ -7,5 +7,19 @@ export const StorageErrors = {
7
7
  statusCode: HTTP.ResultCodes.RS_4.NotFound,
8
8
  category: ErrorScopes.BUSINESS,
9
9
  },
10
+ /** An upload named a folder the storage refuses: a segment it cannot hold, or an empty path. */
11
+ FOLDER_PATH_INVALID: {
12
+ message: { text: 'Invalid folder path', code: 'core.storage.folder_path_invalid' },
13
+ statusCode: HTTP.ResultCodes.RS_4.BadRequest,
14
+ category: ErrorScopes.VALIDATION,
15
+ },
16
+ FOLDER_DEPTH_EXCEEDED: {
17
+ message: {
18
+ text: 'Folder path exceeds the maximum depth',
19
+ code: 'core.storage.folder_depth_exceeded',
20
+ },
21
+ statusCode: HTTP.ResultCodes.RS_4.BadRequest,
22
+ category: ErrorScopes.VALIDATION,
23
+ },
10
24
  };
11
25
  //# sourceMappingURL=errors.js.map
@@ -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;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} 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,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,5 +1,6 @@
1
1
  import { type IDuration } from '../../../common/index.js';
2
2
  import { type Readable } from 'node:stream';
3
+ import type { TStorageType } from './constants.js';
3
4
  /** One file handed to `upload`. `buffer` is the whole body; `folderPath`, when set, nests the object under that folder and is depth-checked. */
4
5
  export interface IUploadFile {
5
6
  originalName: string;
@@ -90,6 +91,8 @@ export interface IStorageHelperOptions {
90
91
  }
91
92
  /** The contract every storage backend (disk, in-memory, S3) implements. Buckets and objects are addressed by `IBucketRef` and `IObjectRef`. */
92
93
  export interface IStorageHelper {
94
+ /** The backend this helper writes to. The helpers IGNIS ships declare it; a custom helper may leave it out. */
95
+ readonly storageType?: TStorageType;
93
96
  isValidSegment(opts: {
94
97
  segment: string;
95
98
  }): boolean;
@@ -128,7 +131,14 @@ export interface IStorageHelper {
128
131
  upload(opts: {
129
132
  bucket: IBucketRef;
130
133
  files: IUploadFile[];
134
+ /** Folders the caller's `folderPath` may carry. */
131
135
  maxFolderDepth?: number;
136
+ /**
137
+ * Folders the finished key may carry, a scope the `normalizeNameFn` adds included.
138
+ *
139
+ * @default `maxFolderDepth`
140
+ */
141
+ maxKeyDepth?: number;
132
142
  normalizeNameFn?: (opts: {
133
143
  file: TUploadNaming;
134
144
  }) => string;
@@ -159,10 +169,13 @@ export interface IStorageHelper {
159
169
  bucket: IBucketRef;
160
170
  objects: IObjectRef[];
161
171
  }): Promise<void>;
162
- /** The form a browser posts straight to the storage. Unlike a presigned PUT, a policy carries `content-length-range`, so "at most N bytes" is expressible - a signed PUT binds the length to one exact value. */
163
- presignPost(opts: {
164
- bucket: IBucketRef;
165
- keyPrefix: string;
172
+ /**
173
+ * The form a browser posts straight to the storage, good for exactly ONE object: the policy signs
174
+ * `object.key` as it stands, and `formData` carries that key, so the client does not add it.
175
+ * Unlike a presigned PUT, a policy carries `content-length-range`, so "at most N bytes" is
176
+ * expressible - a signed PUT binds the length to one exact value.
177
+ */
178
+ presignPost(opts: IObjectLocation & {
166
179
  maxBytes: number;
167
180
  contentType?: string;
168
181
  expiresIn?: IDuration;
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/storage/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import { type IDuration } from '@/common';\nimport { type Readable } from 'node:stream';\n\n/** One file handed to `upload`. `buffer` is the whole body; `folderPath`, when set, nests the object under that folder and is depth-checked. */\nexport interface IUploadFile {\n originalName: string;\n mimetype: string;\n buffer: Buffer;\n size: number;\n encoding?: string;\n folderPath?: string;\n [key: string | symbol]: any;\n}\n\n/** `metaLink` is a union: the old pair allowed both present, or neither. */\nexport interface IUploadResult {\n bucket: IBucketRef;\n object: IObjectRef & { size: number; contentType: string };\n link: string;\n metaLink?: { data: any } | { error: string };\n}\n\n/** `mimetype` is named because consumers persist it; `any` let it be renamed silently. */\nexport interface IObjectMetadata {\n mimetype?: string;\n [key: string]: any;\n}\n\n/** What `getStat` reports for one object. `size` is in bytes. */\nexport interface IFileStat {\n size: number;\n metadata: IObjectMetadata;\n lastModified?: Date;\n etag?: string;\n versionId?: string;\n}\n\n/** A bucket as `getBuckets`, `getBucket` and `createBucket` report it. */\nexport interface IBucketInfo {\n name: string;\n creationDate: Date;\n}\n\n/** One entry of `listObjects`. `name` is the full object key. */\nexport interface IObjectInfo {\n name?: string;\n size?: number;\n lastModified?: Date;\n etag?: string;\n prefix?: string;\n}\n\n/** One bucket. */\nexport interface IBucketRef {\n name: string;\n}\n\n/** The parts of an upload a naming hook needs; `IUploadFile` already declares both. */\nexport type TUploadNaming = Pick<IUploadFile, 'originalName' | 'folderPath'>;\n\n/** One object. `key` is the S3 term. */\nexport interface IObjectRef {\n key: string;\n}\n\n/** Which bucket, which object. */\nexport interface IObjectLocation {\n bucket: IBucketRef;\n object: IObjectRef;\n}\n\n/** Filters for `listObjects`. `maxKeys` caps the result, and `0` returns nothing. */\nexport interface IListObjectsOptions {\n bucket: IBucketRef;\n prefix?: string;\n\n /**\n * Whether the listing descends into folders.\n *\n * @default false\n */\n useRecursive?: boolean;\n maxKeys?: number;\n}\n\n/** What `presignPost` hands a browser: where to post, the fields to post with it, and when the grant dies. */\nexport interface IPostPolicy {\n postURL: string;\n formData: Record<string, string>;\n expiresAt: string;\n}\n\n/** Logger `scope` and `identifier` for a storage helper. */\nexport interface IStorageHelperOptions {\n scope?: string;\n identifier?: string;\n}\n\n/** The contract every storage backend (disk, in-memory, S3) implements. Buckets and objects are addressed by `IBucketRef` and `IObjectRef`. */\nexport interface IStorageHelper {\n isValidSegment(opts: { segment: string }): boolean;\n isValidBucketName(opts: { bucket: IBucketRef }): boolean;\n isValidObjectKey(opts: { object: IObjectRef; maxDepth?: number }): boolean;\n\n hasBucket(opts: { bucket: IBucketRef }): Promise<boolean>;\n getBuckets(): Promise<IBucketInfo[]>;\n getBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null>;\n createBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null>;\n removeBucket(opts: { bucket: IBucketRef }): Promise<boolean>;\n\n getObject(opts: IObjectLocation & { options?: any }): Promise<Readable>;\n\n /** A web stream, what a `Response` body wants. `range` includes `end`, like the HTTP header. */\n getObjectStream(\n opts: IObjectLocation & { range?: { start: number; end?: number } },\n ): Promise<ReadableStream<Uint8Array>>;\n getStat(opts: IObjectLocation): Promise<IFileStat>;\n listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]>;\n\n upload(opts: {\n bucket: IBucketRef;\n files: IUploadFile[];\n maxFolderDepth?: number;\n normalizeNameFn?: (opts: { file: TUploadNaming }) => string;\n normalizeLinkFn?: (opts: IObjectLocation) => string;\n }): Promise<IUploadResult[]>;\n\n /**\n * Writes an object from a stream, so a large body never lands in this process. A backend whose\n * transport takes a stream overrides it; the default buffers, which is the thing to avoid.\n */\n writeStream(\n opts: IObjectLocation & {\n source: ReadableStream<Uint8Array> | Blob | Response | Request;\n contentType?: string;\n /**\n * Folder nesting the key may carry, as `upload` takes it.\n *\n * @default BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH\n */\n maxFolderDepth?: number;\n },\n ): Promise<void>;\n\n /** Copies within one bucket, server side - the bytes never travel through this process. */\n copyObject(opts: {\n bucket: IBucketRef;\n source: IObjectRef;\n destination: IObjectRef;\n }): Promise<void>;\n\n removeObject(opts: IObjectLocation): Promise<void>;\n removeObjects(opts: { bucket: IBucketRef; objects: IObjectRef[] }): Promise<void>;\n\n /** The form a browser posts straight to the storage. Unlike a presigned PUT, a policy carries `content-length-range`, so \"at most N bytes\" is expressible - a signed PUT binds the length to one exact value. */\n presignPost(opts: {\n bucket: IBucketRef;\n keyPrefix: string;\n maxBytes: number;\n contentType?: string;\n expiresIn?: IDuration;\n }): Promise<IPostPolicy>;\n\n /** A URL a browser may PUT one object to. Every extra option below is SIGNED - the client must send it back unchanged. A pinned size is exact, never a ceiling; for a ceiling use {@link IStorageHelper.presignPost}. */\n presignPut(\n opts: IObjectLocation & {\n expiresIn?: IDuration;\n /** The object's tag set, written at the moment it is stored. */\n tagging?: Record<string, string>;\n /** Pins the body to EXACTLY this many bytes. A retry at a different size is refused. */\n contentLength?: number;\n /** Pins the stored content type. Unsigned, the uploader picks what is stored - and the stored type is what a browser later renders. */\n contentType?: string;\n },\n ): Promise<string>;\n presignGet(\n opts: IObjectLocation & {\n expiresIn?: IDuration;\n responseContentType?: string;\n responseContentDisposition?: string;\n },\n ): Promise<string>;\n\n getObjectTags(opts: IObjectLocation): Promise<Record<string, string>>;\n replaceObjectTags(opts: IObjectLocation & { tags: Record<string, string> }): Promise<void>;\n\n getMediaType(opts: { mimeType: string }): string;\n getMimeType(opts: { filename: string }): string;\n}\n"]}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/storage/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import { type IDuration } from '@/common';\nimport { type Readable } from 'node:stream';\nimport type { TStorageType } from './constants';\n\n/** One file handed to `upload`. `buffer` is the whole body; `folderPath`, when set, nests the object under that folder and is depth-checked. */\nexport interface IUploadFile {\n originalName: string;\n mimetype: string;\n buffer: Buffer;\n size: number;\n encoding?: string;\n folderPath?: string;\n [key: string | symbol]: any;\n}\n\n/** `metaLink` is a union: the old pair allowed both present, or neither. */\nexport interface IUploadResult {\n bucket: IBucketRef;\n object: IObjectRef & { size: number; contentType: string };\n link: string;\n metaLink?: { data: any } | { error: string };\n}\n\n/** `mimetype` is named because consumers persist it; `any` let it be renamed silently. */\nexport interface IObjectMetadata {\n mimetype?: string;\n [key: string]: any;\n}\n\n/** What `getStat` reports for one object. `size` is in bytes. */\nexport interface IFileStat {\n size: number;\n metadata: IObjectMetadata;\n lastModified?: Date;\n etag?: string;\n versionId?: string;\n}\n\n/** A bucket as `getBuckets`, `getBucket` and `createBucket` report it. */\nexport interface IBucketInfo {\n name: string;\n creationDate: Date;\n}\n\n/** One entry of `listObjects`. `name` is the full object key. */\nexport interface IObjectInfo {\n name?: string;\n size?: number;\n lastModified?: Date;\n etag?: string;\n prefix?: string;\n}\n\n/** One bucket. */\nexport interface IBucketRef {\n name: string;\n}\n\n/** The parts of an upload a naming hook needs; `IUploadFile` already declares both. */\nexport type TUploadNaming = Pick<IUploadFile, 'originalName' | 'folderPath'>;\n\n/** One object. `key` is the S3 term. */\nexport interface IObjectRef {\n key: string;\n}\n\n/** Which bucket, which object. */\nexport interface IObjectLocation {\n bucket: IBucketRef;\n object: IObjectRef;\n}\n\n/** Filters for `listObjects`. `maxKeys` caps the result, and `0` returns nothing. */\nexport interface IListObjectsOptions {\n bucket: IBucketRef;\n prefix?: string;\n\n /**\n * Whether the listing descends into folders.\n *\n * @default false\n */\n useRecursive?: boolean;\n maxKeys?: number;\n}\n\n/** What `presignPost` hands a browser: where to post, the fields to post with it, and when the grant dies. */\nexport interface IPostPolicy {\n postURL: string;\n formData: Record<string, string>;\n expiresAt: string;\n}\n\n/** Logger `scope` and `identifier` for a storage helper. */\nexport interface IStorageHelperOptions {\n scope?: string;\n identifier?: string;\n}\n\n/** The contract every storage backend (disk, in-memory, S3) implements. Buckets and objects are addressed by `IBucketRef` and `IObjectRef`. */\nexport interface IStorageHelper {\n /** The backend this helper writes to. The helpers IGNIS ships declare it; a custom helper may leave it out. */\n readonly storageType?: TStorageType;\n\n isValidSegment(opts: { segment: string }): boolean;\n isValidBucketName(opts: { bucket: IBucketRef }): boolean;\n isValidObjectKey(opts: { object: IObjectRef; maxDepth?: number }): boolean;\n\n hasBucket(opts: { bucket: IBucketRef }): Promise<boolean>;\n getBuckets(): Promise<IBucketInfo[]>;\n getBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null>;\n createBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null>;\n removeBucket(opts: { bucket: IBucketRef }): Promise<boolean>;\n\n getObject(opts: IObjectLocation & { options?: any }): Promise<Readable>;\n\n /** A web stream, what a `Response` body wants. `range` includes `end`, like the HTTP header. */\n getObjectStream(\n opts: IObjectLocation & { range?: { start: number; end?: number } },\n ): Promise<ReadableStream<Uint8Array>>;\n getStat(opts: IObjectLocation): Promise<IFileStat>;\n listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]>;\n\n upload(opts: {\n bucket: IBucketRef;\n files: IUploadFile[];\n /** Folders the caller's `folderPath` may carry. */\n maxFolderDepth?: number;\n /**\n * Folders the finished key may carry, a scope the `normalizeNameFn` adds included.\n *\n * @default `maxFolderDepth`\n */\n maxKeyDepth?: number;\n normalizeNameFn?: (opts: { file: TUploadNaming }) => string;\n normalizeLinkFn?: (opts: IObjectLocation) => string;\n }): Promise<IUploadResult[]>;\n\n /**\n * Writes an object from a stream, so a large body never lands in this process. A backend whose\n * transport takes a stream overrides it; the default buffers, which is the thing to avoid.\n */\n writeStream(\n opts: IObjectLocation & {\n source: ReadableStream<Uint8Array> | Blob | Response | Request;\n contentType?: string;\n /**\n * Folder nesting the key may carry, as `upload` takes it.\n *\n * @default BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH\n */\n maxFolderDepth?: number;\n },\n ): Promise<void>;\n\n /** Copies within one bucket, server side - the bytes never travel through this process. */\n copyObject(opts: {\n bucket: IBucketRef;\n source: IObjectRef;\n destination: IObjectRef;\n }): Promise<void>;\n\n removeObject(opts: IObjectLocation): Promise<void>;\n removeObjects(opts: { bucket: IBucketRef; objects: IObjectRef[] }): Promise<void>;\n\n /**\n * The form a browser posts straight to the storage, good for exactly ONE object: the policy signs\n * `object.key` as it stands, and `formData` carries that key, so the client does not add it.\n * Unlike a presigned PUT, a policy carries `content-length-range`, so \"at most N bytes\" is\n * expressible - a signed PUT binds the length to one exact value.\n */\n presignPost(\n opts: IObjectLocation & {\n maxBytes: number;\n contentType?: string;\n expiresIn?: IDuration;\n },\n ): Promise<IPostPolicy>;\n\n /** A URL a browser may PUT one object to. Every extra option below is SIGNED - the client must send it back unchanged. A pinned size is exact, never a ceiling; for a ceiling use {@link IStorageHelper.presignPost}. */\n presignPut(\n opts: IObjectLocation & {\n expiresIn?: IDuration;\n /** The object's tag set, written at the moment it is stored. */\n tagging?: Record<string, string>;\n /** Pins the body to EXACTLY this many bytes. A retry at a different size is refused. */\n contentLength?: number;\n /** Pins the stored content type. Unsigned, the uploader picks what is stored - and the stored type is what a browser later renders. */\n contentType?: string;\n },\n ): Promise<string>;\n presignGet(\n opts: IObjectLocation & {\n expiresIn?: IDuration;\n responseContentType?: string;\n responseContentDisposition?: string;\n },\n ): Promise<string>;\n\n getObjectTags(opts: IObjectLocation): Promise<Record<string, string>>;\n replaceObjectTags(opts: IObjectLocation & { tags: Record<string, string> }): Promise<void>;\n\n getMediaType(opts: { mimeType: string }): string;\n getMimeType(opts: { filename: string }): string;\n}\n"]}
@@ -8,6 +8,7 @@ export interface IDiskHelperOptions extends IStorageHelperOptions {
8
8
  }
9
9
  /** Storage backed by the local filesystem: each bucket is a directory under `basePath`, each object a file whose key is its relative path. Names are validated and resolved paths must stay inside the bucket. */
10
10
  export declare class DiskHelper extends BaseStorageHelper {
11
+ readonly storageType = "disk";
11
12
  private basePath;
12
13
  constructor(options: IDiskHelperOptions);
13
14
  private getBucketPath;
@@ -7,7 +7,7 @@ import fsp from 'node:fs/promises';
7
7
  import path from 'node:path';
8
8
  import { Readable } from 'node:stream';
9
9
  import { BaseStorageHelper } from '../base.js';
10
- import { StorageErrors, } from '../common/index.js';
10
+ import { StorageErrors, StorageTypes, } from '../common/index.js';
11
11
  /** Storage backed by the local filesystem: each bucket is a directory under `basePath`, each object a file whose key is its relative path. Names are validated and resolved paths must stay inside the bucket. */
12
12
  export class DiskHelper extends BaseStorageHelper {
13
13
  constructor(options) {
@@ -15,6 +15,7 @@ export class DiskHelper extends BaseStorageHelper {
15
15
  scope: options.scope ?? DiskHelper.name,
16
16
  identifier: options.identifier ?? DiskHelper.name,
17
17
  });
18
+ this.storageType = StorageTypes.DISK;
18
19
  this.basePath = path.resolve(options.basePath);
19
20
  if (!fs.existsSync(this.basePath)) {
20
21
  fs.mkdirSync(this.basePath, { recursive: true });
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/storage/disk/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants/http';\nimport { getError } from '@/modules/error';\nimport { ErrorPrettier } from '@/modules/logger';\nimport { EchoUtility } from '@/utilities/echo.utility';\nimport fs from 'node:fs';\nimport fsp from 'node:fs/promises';\nimport type { Stats } from 'node:fs';\nimport path from 'node:path';\nimport { Readable } from 'node:stream';\nimport { BaseStorageHelper } from '../base';\nimport {\n type IBucketInfo,\n type IBucketRef,\n type IFileStat,\n type IListObjectsOptions,\n type IObjectInfo,\n type IObjectLocation,\n type IObjectRef,\n type IStorageHelperOptions,\n type IUploadFile,\n StorageErrors,\n} from '../common';\n\n/** Options for `DiskHelper`; `basePath` is created when missing. */\nexport interface IDiskHelperOptions extends IStorageHelperOptions {\n /** Base directory every bucket lives under. */\n basePath: string;\n}\n\n/** Storage backed by the local filesystem: each bucket is a directory under `basePath`, each object a file whose key is its relative path. Names are validated and resolved paths must stay inside the bucket. */\nexport class DiskHelper extends BaseStorageHelper {\n private basePath: string;\n\n constructor(options: IDiskHelperOptions) {\n super({\n scope: options.scope ?? DiskHelper.name,\n identifier: options.identifier ?? DiskHelper.name,\n });\n this.basePath = path.resolve(options.basePath);\n\n if (!fs.existsSync(this.basePath)) {\n fs.mkdirSync(this.basePath, { recursive: true });\n }\n }\n\n private getBucketPath(opts: { bucket: IBucketRef }): string {\n return path.join(this.basePath, opts.bucket.name);\n }\n\n /**\n * Whether `target`, with every symbolic link followed, lies inside the real storage root. A target that does not exist\n * yet is judged by its nearest existing parent (a write creates the rest beneath it); a link whose own target is\n * missing is refused, because writing through it would create the file where the link points.\n */\n private async isInsideRoot(opts: { target: string }): Promise<boolean> {\n const root = await this.realpathOrFail({ target: this.basePath });\n let probe = opts.target;\n\n for (;;) {\n try {\n const real = await fsp.realpath(probe);\n\n return real === root || real.startsWith(`${root}${path.sep}`);\n } catch (error) {\n const code = (error as NodeJS.ErrnoException)?.code;\n\n // A link loop or a path the system refuses as too long is not a place a name can lead to.\n if (code === 'ELOOP' || code === 'ENAMETOOLONG') {\n return false;\n }\n\n if (code !== 'ENOENT' && code !== 'ENOTDIR') {\n throw this.toRealPathError({ error });\n }\n }\n\n const link = await this.lstatOrNull({ target: probe });\n\n if (link?.isSymbolicLink()) {\n return false;\n }\n\n const parent = path.dirname(probe);\n\n if (parent === probe) {\n return false;\n }\n\n probe = parent;\n }\n }\n\n /** The real path of `target`; a failure leaves as {@link DiskHelper.toRealPathError} answers it. */\n private async realpathOrFail(opts: { target: string }): Promise<string> {\n try {\n const result = await fsp.realpath(opts.target);\n\n return result;\n } catch (error) {\n throw this.toRealPathError({ error });\n }\n }\n\n /**\n * What a failed `realpath` is reported as: the code, never the path. Node's message holds the absolute path of the\n * server, and a refusal reaches the caller of the storage API. The full error stays in the log.\n */\n private toRealPathError(opts: { error: unknown }) {\n const { error } = opts;\n const code = (error as NodeJS.ErrnoException)?.code ?? 'UNKNOWN';\n\n this.logger.error(\n 'Cannot resolve the real path of a storage target | code: %s | %s',\n code,\n // A system error quotes the path it failed on; the path is a caller's key under the storage root.\n EchoUtility.toSafeEcho({ value: ErrorPrettier.format({ error }) }),\n );\n\n // A server-side fault, not the caller's: the default status of `getError` is a 400.\n return getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[storage] Cannot resolve the real path of a storage target | code: ${code}`,\n });\n }\n\n /** `null` when nothing is there (or it cannot be read): the caller walks up to the parent and judges that. */\n private async lstatOrNull(opts: { target: string }): Promise<Stats | null> {\n try {\n const result = await fsp.lstat(opts.target);\n\n return result;\n // eslint-disable-next-line venizia/no-silent-catch -- a missing or unreadable entry is the answer here: the containment walk goes on to its parent\n } catch {\n return null;\n }\n }\n\n /** A directory that exists AND lies inside the real root: a bucket that is a link leading outside is not one. */\n private async isReachableBucketPath(opts: { target: string }): Promise<boolean> {\n const inside = await this.isInsideRoot(opts);\n\n if (!inside) {\n return false;\n }\n\n return this.exists(opts);\n }\n\n /** The path of an object after the checks of {@link DiskHelper.resolveObjectPath} and the real-path containment check. */\n private async resolveContainedObjectPath(opts: IObjectLocation): Promise<string> {\n const objectPath = this.resolveObjectPath(opts);\n\n const result = await this.isInsideRoot({ target: objectPath });\n\n if (!result) {\n throw getError({\n message: `[storage] Invalid object name | key: ${EchoUtility.toSafeText({ value: opts.object.key })}`,\n });\n }\n\n return objectPath;\n }\n\n /** Validates the name AND the resolved path: containment survives a naming rule we get wrong. */\n private resolveObjectPath(opts: IObjectLocation): string {\n const { bucket, object } = opts;\n\n if (!this.isValidBucketName({ bucket })) {\n throw getError({\n message: `[storage] Invalid bucket name | bucket: ${EchoUtility.toSafeText({ value: bucket.name })}`,\n });\n }\n\n if (!this.isValidObjectKey({ object, maxDepth: Number.MAX_SAFE_INTEGER })) {\n throw getError({\n message: `[storage] Invalid object name | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n const bucketPath = this.getBucketPath({ bucket });\n const objectPath = path.resolve(bucketPath, object.key);\n\n if (objectPath !== bucketPath && !objectPath.startsWith(`${bucketPath}${path.sep}`)) {\n throw getError({\n message: `[storage] Invalid object name | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n return objectPath;\n }\n\n /** `null` means not there. Anything but ENOENT is logged: it may exist and be unreadable. */\n private async statOrNull(opts: { target: string }): Promise<Stats | null> {\n const { target } = opts;\n\n try {\n const result = await fsp.stat(target);\n\n return result;\n } catch (error) {\n if ((error as NodeJS.ErrnoException)?.code !== 'ENOENT') {\n this.logger.warn(\n '[statOrNull] Cannot determine existence, reporting missing | path: %s | %s',\n EchoUtility.toSafeEcho({ value: target }),\n // The error's own text quotes the path, so it is escaped like the path is.\n EchoUtility.toSafeEcho({ value: ErrorPrettier.format({ error }) }),\n );\n }\n\n return null;\n }\n }\n\n private async exists(opts: { target: string }): Promise<boolean> {\n const result = await this.statOrNull(opts);\n\n return result !== null;\n }\n\n /** An object is a regular file: a directory under the same path is not one, so it reads as not found. */\n private async isFile(opts: { target: string }): Promise<boolean> {\n const result = await this.statOrNull(opts);\n\n return result?.isFile() ?? false;\n }\n\n /** One `stat` answers existence and type. */\n async hasBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n if (!this.isValidBucketName(opts)) {\n return false;\n }\n\n const target = this.getBucketPath(opts);\n\n // A bucket that is a link leading outside the root is not a bucket.\n const result = await this.isInsideRoot({ target });\n\n if (!result) {\n return false;\n }\n\n const stat = await this.statOrNull({ target });\n\n return stat?.isDirectory() ?? false;\n }\n\n async getBuckets(): Promise<IBucketInfo[]> {\n const result = await this.exists({ target: this.basePath });\n\n if (!result) {\n return [];\n }\n\n const entries = await fsp.readdir(this.basePath, { withFileTypes: true });\n const buckets: IBucketInfo[] = [];\n\n for (const entry of entries) {\n if (entry.isDirectory()) {\n const bucketPath = path.join(this.basePath, entry.name);\n const stat = await fsp.stat(bucketPath);\n buckets.push({\n name: entry.name,\n creationDate: stat.birthtime,\n });\n }\n }\n\n return buckets;\n }\n\n async getBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n return null;\n }\n\n const target = this.getBucketPath(opts);\n const inside = await this.isInsideRoot({ target });\n\n if (!inside) {\n return null;\n }\n\n const stat = await this.statOrNull({ target });\n\n if (!stat?.isDirectory()) {\n return null;\n }\n\n return { name, creationDate: stat.birthtime };\n }\n\n async createBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n throw getError({\n message: '[createBucket] Invalid name to create bucket!',\n });\n }\n\n const bucketPath = this.getBucketPath(opts);\n\n const result = await this.exists({ target: bucketPath });\n\n if (result) {\n throw getError({\n message: `[createBucket] Bucket already exists | name: ${EchoUtility.toSafeText({ value: name })}`,\n });\n }\n\n await fsp.mkdir(bucketPath, { recursive: true });\n\n return this.getBucket(opts);\n }\n\n async removeBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n throw getError({\n message: '[removeBucket] Invalid name to remove bucket!',\n });\n }\n\n const bucketPath = this.getBucketPath(opts);\n\n const result = await this.isReachableBucketPath({ target: bucketPath });\n\n if (!result) {\n throw getError({\n message: `[removeBucket] Bucket does not exist | name: ${EchoUtility.toSafeText({ value: name })}`,\n });\n }\n\n const files = await fsp.readdir(bucketPath);\n\n if (files.length > 0) {\n throw getError({\n message: `[removeBucket] Bucket is not empty | name: ${EchoUtility.toSafeText({ value: name })}`,\n });\n }\n\n await fsp.rmdir(bucketPath);\n\n return true;\n }\n\n protected get defaultLinkPrefix(): string {\n return '/static-resources/';\n }\n\n protected async writeObject(opts: IObjectLocation & { file: IUploadFile }): Promise<void> {\n const { bucket, object, file } = opts;\n // The same validated, contained path every other operation uses: `writeStream` reaches here without `upload`'s checks.\n const objectPath = await this.resolveContainedObjectPath({ bucket, object });\n\n // `recursive` succeeds on an existing directory; probing first wastes a syscall per file.\n await fsp.mkdir(path.dirname(objectPath), { recursive: true });\n await fsp.writeFile(objectPath, file.buffer);\n }\n\n async getObject(opts: IObjectLocation & { options?: any }): Promise<Readable> {\n const { bucket, object } = opts;\n const objectPath = await this.resolveContainedObjectPath({ bucket, object });\n\n const result = await this.isFile({ target: objectPath });\n\n if (!result) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[getObject] Object not found | bucket: ${EchoUtility.toSafeText({ value: bucket.name })} | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n return fs.createReadStream(objectPath);\n }\n\n /** `createReadStream` seeks natively, so a range never reads the bytes before it. */\n override async getObjectStream(\n opts: IObjectLocation & { range?: { start: number; end?: number } },\n ): Promise<ReadableStream<Uint8Array>> {\n const { bucket, object, range } = opts;\n const objectPath = await this.resolveContainedObjectPath({ bucket, object });\n\n const result = await this.isFile({ target: objectPath });\n\n if (!result) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[getObjectStream] Object not found | bucket: ${EchoUtility.toSafeText({ value: bucket.name })} | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n const source = fs.createReadStream(\n objectPath,\n range ? { start: range.start, end: range.end } : {},\n );\n\n return Readable.toWeb(source) as ReadableStream<Uint8Array>;\n }\n\n async getStat(opts: IObjectLocation): Promise<IFileStat> {\n const { bucket, object } = opts;\n const objectPath = await this.resolveContainedObjectPath({ bucket, object });\n const stat = await this.statOrNull({ target: objectPath });\n\n if (!stat?.isFile()) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[getStat] Object not found | bucket: ${EchoUtility.toSafeText({ value: bucket.name })} | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n return {\n size: stat.size,\n lastModified: stat.mtime,\n metadata: {\n mimetype: this.getMimeType({ filename: object.key }),\n },\n };\n }\n\n async removeObject(opts: IObjectLocation): Promise<void> {\n const { bucket, object } = opts;\n const objectPath = await this.resolveContainedObjectPath({ bucket, object });\n\n const result = await this.isFile({ target: objectPath });\n\n if (!result) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[removeObject] Object not found | bucket: ${EchoUtility.toSafeText({ value: bucket.name })} | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n await fsp.unlink(objectPath);\n }\n\n // Bounded concurrency; one failure stops the batch.\n async removeObjects(opts: { bucket: IBucketRef; objects: IObjectRef[] }): Promise<void> {\n const { bucket, objects } = opts;\n\n await this.mapWithConcurrency({\n items: objects,\n task: ({ item: object }) => this.removeObject({ bucket, object }),\n });\n }\n\n async listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]> {\n const { bucket, prefix = '', useRecursive = false, maxKeys } = opts;\n\n if (!this.isValidBucketName({ bucket })) {\n throw getError({\n message: `[listObjects] Invalid bucket name | bucket: ${EchoUtility.toSafeText({ value: bucket.name })}`,\n });\n }\n\n // `maxKeys: 0` means zero, not unlimited.\n const limit = maxKeys ?? Number.POSITIVE_INFINITY;\n\n if (limit <= 0) {\n return [];\n }\n\n const bucketPath = this.getBucketPath({ bucket });\n const result = await this.isReachableBucketPath({ target: bucketPath });\n\n if (!result) {\n return [];\n }\n\n const objects: IObjectInfo[] = [];\n\n const scanDirectory = async (scanOptions: {\n directory: { path: string; prefix?: string };\n }): Promise<void> => {\n const { directory } = scanOptions;\n\n if (objects.length >= limit) {\n return;\n }\n\n const entries = await fsp.readdir(directory.path, { withFileTypes: true });\n\n for (const entry of entries) {\n if (objects.length >= limit) {\n return;\n }\n\n // An object key always joins on '/'; `path.join` would emit '\\' on Windows.\n const entryKey = directory.prefix ? `${directory.prefix}/${entry.name}` : entry.name;\n const entryPath = path.join(directory.path, entry.name);\n\n if (entry.isDirectory()) {\n // A prefix that cannot match below here makes descending pointless.\n const canMatch = !prefix || prefix.startsWith(entryKey) || entryKey.startsWith(prefix);\n\n if (useRecursive && canMatch) {\n await scanDirectory({ directory: { path: entryPath, prefix: entryKey } });\n }\n\n continue;\n }\n\n if (!entry.isFile() || (prefix && !entryKey.startsWith(prefix))) {\n continue;\n }\n\n const stat = await this.statOrNull({ target: entryPath });\n\n if (!stat) {\n continue;\n }\n\n objects.push({ name: entryKey, size: stat.size, lastModified: stat.mtime });\n }\n };\n\n await scanDirectory({ directory: { path: bucketPath } });\n\n return objects;\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/storage/disk/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,GAAG,MAAM,kBAAkB,CAAC;AAEnC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAUL,aAAa,EACb,YAAY,GACb,MAAM,WAAW,CAAC;AAQnB,kNAAkN;AAClN,MAAM,OAAO,UAAW,SAAQ,iBAAiB;IAK/C,YAAY,OAA2B;QACrC,KAAK,CAAC;YACJ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,IAAI;YACvC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI;SAClD,CAAC,CAAC;QARI,gBAAW,GAAG,YAAY,CAAC,IAAI,CAAC;QASvC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAE/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,IAA4B;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,YAAY,CAAC,IAAwB;QACjD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClE,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAExB,SAAS,CAAC;YACR,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAEvC,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAChE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,GAAI,KAA+B,EAAE,IAAI,CAAC;gBAEpD,0FAA0F;gBAC1F,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;oBAChD,OAAO,KAAK,CAAC;gBACf,CAAC;gBAED,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC5C,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAEvD,IAAI,IAAI,EAAE,cAAc,EAAE,EAAE,CAAC;gBAC3B,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAEnC,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBACrB,OAAO,KAAK,CAAC;YACf,CAAC;YAED,KAAK,GAAG,MAAM,CAAC;QACjB,CAAC;IACH,CAAC;IAED,oGAAoG;IAC5F,KAAK,CAAC,cAAc,CAAC,IAAwB;QACnD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAE/C,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,eAAe,CAAC,IAAwB;QAC9C,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,MAAM,IAAI,GAAI,KAA+B,EAAE,IAAI,IAAI,SAAS,CAAC;QAEjE,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,kEAAkE,EAClE,IAAI;QACJ,kGAAkG;QAClG,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CACnE,CAAC;QAEF,oFAAoF;QACpF,OAAO,QAAQ,CAAC;YACd,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;YACrD,OAAO,EAAE,sEAAsE,IAAI,EAAE;SACtF,CAAC,CAAC;IACL,CAAC;IAED,8GAA8G;IACtG,KAAK,CAAC,WAAW,CAAC,IAAwB;QAChD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAE5C,OAAO,MAAM,CAAC;YACd,mJAAmJ;QACrJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,iHAAiH;IACzG,KAAK,CAAC,qBAAqB,CAAC,IAAwB;QAC1D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,0HAA0H;IAClH,KAAK,CAAC,0BAA0B,CAAC,IAAqB;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAE/D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,wCAAwC,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE;aACtG,CAAC,CAAC;QACL,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,iGAAiG;IACzF,iBAAiB,CAAC,IAAqB;QAC7C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAEhC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,2CAA2C,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE;aACrG,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC;YAC1E,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,wCAAwC,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE;aACjG,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAExD,IAAI,UAAU,KAAK,UAAU,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;YACpF,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,wCAAwC,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE;aACjG,CAAC,CAAC;QACL,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,6FAA6F;IACrF,KAAK,CAAC,UAAU,CAAC,IAAwB;QAC/C,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAExB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAEtC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxD,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,4EAA4E,EAC5E,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;gBACzC,2EAA2E;gBAC3E,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CACnE,CAAC;YACJ,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,IAAwB;QAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAE3C,OAAO,MAAM,KAAK,IAAI,CAAC;IACzB,CAAC;IAED,yGAAyG;IACjG,KAAK,CAAC,MAAM,CAAC,IAAwB;QAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAE3C,OAAO,MAAM,EAAE,MAAM,EAAE,IAAI,KAAK,CAAC;IACnC,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,SAAS,CAAC,IAA4B;QAC1C,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAExC,oEAAoE;QACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAE/C,OAAO,IAAI,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE5D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,MAAM,OAAO,GAAkB,EAAE,CAAC;QAElC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBACxD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACxC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,YAAY,EAAE,IAAI,CAAC,SAAS;iBAC7B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAA4B;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAE7B,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAE/C,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAA4B;QAC7C,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAE7B,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,+CAA+C;aACzD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAE5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAEzD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,gDAAgD,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE;aACnG,CAAC,CAAC;QACL,CAAC;QAED,MAAM,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAA4B;QAC7C,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAE7B,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,+CAA+C;aACzD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAE5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAExE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,gDAAgD,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE;aACnG,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE5C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,8CAA8C,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE;aACjG,CAAC,CAAC;QACL,CAAC;QAED,MAAM,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAc,iBAAiB;QAC7B,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAES,KAAK,CAAC,WAAW,CAAC,IAA6C;QACvE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtC,uHAAuH;QACvH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAE7E,0FAA0F;QAC1F,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,MAAM,GAAG,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAyC;QACvD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAE7E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAEzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,QAAQ,CAAC;gBACb,KAAK,EAAE,aAAa,CAAC,gBAAgB;gBACrC,OAAO,EAAE,0CAA0C,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE;aAC5J,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,qFAAqF;IAC5E,KAAK,CAAC,eAAe,CAC5B,IAAmE;QAEnE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAE7E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAEzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,QAAQ,CAAC;gBACb,KAAK,EAAE,aAAa,CAAC,gBAAgB;gBACrC,OAAO,EAAE,gDAAgD,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE;aAClK,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,EAAE,CAAC,gBAAgB,CAChC,UAAU,EACV,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CACpD,CAAC;QAEF,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAA+B,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAqB;QACjC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAE3D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;YACpB,MAAM,QAAQ,CAAC;gBACb,KAAK,EAAE,aAAa,CAAC,gBAAgB;gBACrC,OAAO,EAAE,wCAAwC,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE;aAC1J,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,IAAI,CAAC,KAAK;YACxB,QAAQ,EAAE;gBACR,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;aACrD;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAqB;QACtC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAE7E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAEzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,QAAQ,CAAC;gBACb,KAAK,EAAE,aAAa,CAAC,gBAAgB;gBACrC,OAAO,EAAE,6CAA6C,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE;aAC/J,CAAC,CAAC;QACL,CAAC;QAED,MAAM,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,aAAa,CAAC,IAAmD;QACrE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,MAAM,IAAI,CAAC,kBAAkB,CAAC;YAC5B,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAyB;QACzC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,YAAY,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEpE,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,+CAA+C,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE;aACzG,CAAC,CAAC;QACL,CAAC;QAED,0CAA0C;QAC1C,MAAM,KAAK,GAAG,OAAO,IAAI,MAAM,CAAC,iBAAiB,CAAC;QAElD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAExE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAkB,EAAE,CAAC;QAElC,MAAM,aAAa,GAAG,KAAK,EAAE,WAE5B,EAAiB,EAAE;YAClB,MAAM,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC;YAElC,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;gBAC5B,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAE3E,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;oBAC5B,OAAO;gBACT,CAAC;gBAED,4EAA4E;gBAC5E,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;gBACrF,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAExD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,oEAAoE;oBACpE,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;oBAEvF,IAAI,YAAY,IAAI,QAAQ,EAAE,CAAC;wBAC7B,MAAM,aAAa,CAAC,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;oBAC5E,CAAC;oBAED,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;oBAChE,SAAS;gBACX,CAAC;gBAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBAE1D,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,SAAS;gBACX,CAAC;gBAED,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,aAAa,CAAC,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAEzD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF","sourcesContent":["import { HTTP } from '@/common/constants/http';\nimport { getError } from '@/modules/error';\nimport { ErrorPrettier } from '@/modules/logger';\nimport { EchoUtility } from '@/utilities/echo.utility';\nimport fs from 'node:fs';\nimport fsp from 'node:fs/promises';\nimport type { Stats } from 'node:fs';\nimport path from 'node:path';\nimport { Readable } from 'node:stream';\nimport { BaseStorageHelper } from '../base';\nimport {\n type IBucketInfo,\n type IBucketRef,\n type IFileStat,\n type IListObjectsOptions,\n type IObjectInfo,\n type IObjectLocation,\n type IObjectRef,\n type IStorageHelperOptions,\n type IUploadFile,\n StorageErrors,\n StorageTypes,\n} from '../common';\n\n/** Options for `DiskHelper`; `basePath` is created when missing. */\nexport interface IDiskHelperOptions extends IStorageHelperOptions {\n /** Base directory every bucket lives under. */\n basePath: string;\n}\n\n/** Storage backed by the local filesystem: each bucket is a directory under `basePath`, each object a file whose key is its relative path. Names are validated and resolved paths must stay inside the bucket. */\nexport class DiskHelper extends BaseStorageHelper {\n readonly storageType = StorageTypes.DISK;\n\n private basePath: string;\n\n constructor(options: IDiskHelperOptions) {\n super({\n scope: options.scope ?? DiskHelper.name,\n identifier: options.identifier ?? DiskHelper.name,\n });\n this.basePath = path.resolve(options.basePath);\n\n if (!fs.existsSync(this.basePath)) {\n fs.mkdirSync(this.basePath, { recursive: true });\n }\n }\n\n private getBucketPath(opts: { bucket: IBucketRef }): string {\n return path.join(this.basePath, opts.bucket.name);\n }\n\n /**\n * Whether `target`, with every symbolic link followed, lies inside the real storage root. A target that does not exist\n * yet is judged by its nearest existing parent (a write creates the rest beneath it); a link whose own target is\n * missing is refused, because writing through it would create the file where the link points.\n */\n private async isInsideRoot(opts: { target: string }): Promise<boolean> {\n const root = await this.realpathOrFail({ target: this.basePath });\n let probe = opts.target;\n\n for (;;) {\n try {\n const real = await fsp.realpath(probe);\n\n return real === root || real.startsWith(`${root}${path.sep}`);\n } catch (error) {\n const code = (error as NodeJS.ErrnoException)?.code;\n\n // A link loop or a path the system refuses as too long is not a place a name can lead to.\n if (code === 'ELOOP' || code === 'ENAMETOOLONG') {\n return false;\n }\n\n if (code !== 'ENOENT' && code !== 'ENOTDIR') {\n throw this.toRealPathError({ error });\n }\n }\n\n const link = await this.lstatOrNull({ target: probe });\n\n if (link?.isSymbolicLink()) {\n return false;\n }\n\n const parent = path.dirname(probe);\n\n if (parent === probe) {\n return false;\n }\n\n probe = parent;\n }\n }\n\n /** The real path of `target`; a failure leaves as {@link DiskHelper.toRealPathError} answers it. */\n private async realpathOrFail(opts: { target: string }): Promise<string> {\n try {\n const result = await fsp.realpath(opts.target);\n\n return result;\n } catch (error) {\n throw this.toRealPathError({ error });\n }\n }\n\n /**\n * What a failed `realpath` is reported as: the code, never the path. Node's message holds the absolute path of the\n * server, and a refusal reaches the caller of the storage API. The full error stays in the log.\n */\n private toRealPathError(opts: { error: unknown }) {\n const { error } = opts;\n const code = (error as NodeJS.ErrnoException)?.code ?? 'UNKNOWN';\n\n this.logger.error(\n 'Cannot resolve the real path of a storage target | code: %s | %s',\n code,\n // A system error quotes the path it failed on; the path is a caller's key under the storage root.\n EchoUtility.toSafeEcho({ value: ErrorPrettier.format({ error }) }),\n );\n\n // A server-side fault, not the caller's: the default status of `getError` is a 400.\n return getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[storage] Cannot resolve the real path of a storage target | code: ${code}`,\n });\n }\n\n /** `null` when nothing is there (or it cannot be read): the caller walks up to the parent and judges that. */\n private async lstatOrNull(opts: { target: string }): Promise<Stats | null> {\n try {\n const result = await fsp.lstat(opts.target);\n\n return result;\n // eslint-disable-next-line venizia/no-silent-catch -- a missing or unreadable entry is the answer here: the containment walk goes on to its parent\n } catch {\n return null;\n }\n }\n\n /** A directory that exists AND lies inside the real root: a bucket that is a link leading outside is not one. */\n private async isReachableBucketPath(opts: { target: string }): Promise<boolean> {\n const inside = await this.isInsideRoot(opts);\n\n if (!inside) {\n return false;\n }\n\n return this.exists(opts);\n }\n\n /** The path of an object after the checks of {@link DiskHelper.resolveObjectPath} and the real-path containment check. */\n private async resolveContainedObjectPath(opts: IObjectLocation): Promise<string> {\n const objectPath = this.resolveObjectPath(opts);\n\n const result = await this.isInsideRoot({ target: objectPath });\n\n if (!result) {\n throw getError({\n message: `[storage] Invalid object name | key: ${EchoUtility.toSafeText({ value: opts.object.key })}`,\n });\n }\n\n return objectPath;\n }\n\n /** Validates the name AND the resolved path: containment survives a naming rule we get wrong. */\n private resolveObjectPath(opts: IObjectLocation): string {\n const { bucket, object } = opts;\n\n if (!this.isValidBucketName({ bucket })) {\n throw getError({\n message: `[storage] Invalid bucket name | bucket: ${EchoUtility.toSafeText({ value: bucket.name })}`,\n });\n }\n\n if (!this.isValidObjectKey({ object, maxDepth: Number.MAX_SAFE_INTEGER })) {\n throw getError({\n message: `[storage] Invalid object name | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n const bucketPath = this.getBucketPath({ bucket });\n const objectPath = path.resolve(bucketPath, object.key);\n\n if (objectPath !== bucketPath && !objectPath.startsWith(`${bucketPath}${path.sep}`)) {\n throw getError({\n message: `[storage] Invalid object name | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n return objectPath;\n }\n\n /** `null` means not there. Anything but ENOENT is logged: it may exist and be unreadable. */\n private async statOrNull(opts: { target: string }): Promise<Stats | null> {\n const { target } = opts;\n\n try {\n const result = await fsp.stat(target);\n\n return result;\n } catch (error) {\n if ((error as NodeJS.ErrnoException)?.code !== 'ENOENT') {\n this.logger.warn(\n '[statOrNull] Cannot determine existence, reporting missing | path: %s | %s',\n EchoUtility.toSafeEcho({ value: target }),\n // The error's own text quotes the path, so it is escaped like the path is.\n EchoUtility.toSafeEcho({ value: ErrorPrettier.format({ error }) }),\n );\n }\n\n return null;\n }\n }\n\n private async exists(opts: { target: string }): Promise<boolean> {\n const result = await this.statOrNull(opts);\n\n return result !== null;\n }\n\n /** An object is a regular file: a directory under the same path is not one, so it reads as not found. */\n private async isFile(opts: { target: string }): Promise<boolean> {\n const result = await this.statOrNull(opts);\n\n return result?.isFile() ?? false;\n }\n\n /** One `stat` answers existence and type. */\n async hasBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n if (!this.isValidBucketName(opts)) {\n return false;\n }\n\n const target = this.getBucketPath(opts);\n\n // A bucket that is a link leading outside the root is not a bucket.\n const result = await this.isInsideRoot({ target });\n\n if (!result) {\n return false;\n }\n\n const stat = await this.statOrNull({ target });\n\n return stat?.isDirectory() ?? false;\n }\n\n async getBuckets(): Promise<IBucketInfo[]> {\n const result = await this.exists({ target: this.basePath });\n\n if (!result) {\n return [];\n }\n\n const entries = await fsp.readdir(this.basePath, { withFileTypes: true });\n const buckets: IBucketInfo[] = [];\n\n for (const entry of entries) {\n if (entry.isDirectory()) {\n const bucketPath = path.join(this.basePath, entry.name);\n const stat = await fsp.stat(bucketPath);\n buckets.push({\n name: entry.name,\n creationDate: stat.birthtime,\n });\n }\n }\n\n return buckets;\n }\n\n async getBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n return null;\n }\n\n const target = this.getBucketPath(opts);\n const inside = await this.isInsideRoot({ target });\n\n if (!inside) {\n return null;\n }\n\n const stat = await this.statOrNull({ target });\n\n if (!stat?.isDirectory()) {\n return null;\n }\n\n return { name, creationDate: stat.birthtime };\n }\n\n async createBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n throw getError({\n message: '[createBucket] Invalid name to create bucket!',\n });\n }\n\n const bucketPath = this.getBucketPath(opts);\n\n const result = await this.exists({ target: bucketPath });\n\n if (result) {\n throw getError({\n message: `[createBucket] Bucket already exists | name: ${EchoUtility.toSafeText({ value: name })}`,\n });\n }\n\n await fsp.mkdir(bucketPath, { recursive: true });\n\n return this.getBucket(opts);\n }\n\n async removeBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n throw getError({\n message: '[removeBucket] Invalid name to remove bucket!',\n });\n }\n\n const bucketPath = this.getBucketPath(opts);\n\n const result = await this.isReachableBucketPath({ target: bucketPath });\n\n if (!result) {\n throw getError({\n message: `[removeBucket] Bucket does not exist | name: ${EchoUtility.toSafeText({ value: name })}`,\n });\n }\n\n const files = await fsp.readdir(bucketPath);\n\n if (files.length > 0) {\n throw getError({\n message: `[removeBucket] Bucket is not empty | name: ${EchoUtility.toSafeText({ value: name })}`,\n });\n }\n\n await fsp.rmdir(bucketPath);\n\n return true;\n }\n\n protected get defaultLinkPrefix(): string {\n return '/static-resources/';\n }\n\n protected async writeObject(opts: IObjectLocation & { file: IUploadFile }): Promise<void> {\n const { bucket, object, file } = opts;\n // The same validated, contained path every other operation uses: `writeStream` reaches here without `upload`'s checks.\n const objectPath = await this.resolveContainedObjectPath({ bucket, object });\n\n // `recursive` succeeds on an existing directory; probing first wastes a syscall per file.\n await fsp.mkdir(path.dirname(objectPath), { recursive: true });\n await fsp.writeFile(objectPath, file.buffer);\n }\n\n async getObject(opts: IObjectLocation & { options?: any }): Promise<Readable> {\n const { bucket, object } = opts;\n const objectPath = await this.resolveContainedObjectPath({ bucket, object });\n\n const result = await this.isFile({ target: objectPath });\n\n if (!result) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[getObject] Object not found | bucket: ${EchoUtility.toSafeText({ value: bucket.name })} | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n return fs.createReadStream(objectPath);\n }\n\n /** `createReadStream` seeks natively, so a range never reads the bytes before it. */\n override async getObjectStream(\n opts: IObjectLocation & { range?: { start: number; end?: number } },\n ): Promise<ReadableStream<Uint8Array>> {\n const { bucket, object, range } = opts;\n const objectPath = await this.resolveContainedObjectPath({ bucket, object });\n\n const result = await this.isFile({ target: objectPath });\n\n if (!result) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[getObjectStream] Object not found | bucket: ${EchoUtility.toSafeText({ value: bucket.name })} | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n const source = fs.createReadStream(\n objectPath,\n range ? { start: range.start, end: range.end } : {},\n );\n\n return Readable.toWeb(source) as ReadableStream<Uint8Array>;\n }\n\n async getStat(opts: IObjectLocation): Promise<IFileStat> {\n const { bucket, object } = opts;\n const objectPath = await this.resolveContainedObjectPath({ bucket, object });\n const stat = await this.statOrNull({ target: objectPath });\n\n if (!stat?.isFile()) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[getStat] Object not found | bucket: ${EchoUtility.toSafeText({ value: bucket.name })} | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n return {\n size: stat.size,\n lastModified: stat.mtime,\n metadata: {\n mimetype: this.getMimeType({ filename: object.key }),\n },\n };\n }\n\n async removeObject(opts: IObjectLocation): Promise<void> {\n const { bucket, object } = opts;\n const objectPath = await this.resolveContainedObjectPath({ bucket, object });\n\n const result = await this.isFile({ target: objectPath });\n\n if (!result) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[removeObject] Object not found | bucket: ${EchoUtility.toSafeText({ value: bucket.name })} | key: ${EchoUtility.toSafeText({ value: object.key })}`,\n });\n }\n\n await fsp.unlink(objectPath);\n }\n\n // Bounded concurrency; one failure stops the batch.\n async removeObjects(opts: { bucket: IBucketRef; objects: IObjectRef[] }): Promise<void> {\n const { bucket, objects } = opts;\n\n await this.mapWithConcurrency({\n items: objects,\n task: ({ item: object }) => this.removeObject({ bucket, object }),\n });\n }\n\n async listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]> {\n const { bucket, prefix = '', useRecursive = false, maxKeys } = opts;\n\n if (!this.isValidBucketName({ bucket })) {\n throw getError({\n message: `[listObjects] Invalid bucket name | bucket: ${EchoUtility.toSafeText({ value: bucket.name })}`,\n });\n }\n\n // `maxKeys: 0` means zero, not unlimited.\n const limit = maxKeys ?? Number.POSITIVE_INFINITY;\n\n if (limit <= 0) {\n return [];\n }\n\n const bucketPath = this.getBucketPath({ bucket });\n const result = await this.isReachableBucketPath({ target: bucketPath });\n\n if (!result) {\n return [];\n }\n\n const objects: IObjectInfo[] = [];\n\n const scanDirectory = async (scanOptions: {\n directory: { path: string; prefix?: string };\n }): Promise<void> => {\n const { directory } = scanOptions;\n\n if (objects.length >= limit) {\n return;\n }\n\n const entries = await fsp.readdir(directory.path, { withFileTypes: true });\n\n for (const entry of entries) {\n if (objects.length >= limit) {\n return;\n }\n\n // An object key always joins on '/'; `path.join` would emit '\\' on Windows.\n const entryKey = directory.prefix ? `${directory.prefix}/${entry.name}` : entry.name;\n const entryPath = path.join(directory.path, entry.name);\n\n if (entry.isDirectory()) {\n // A prefix that cannot match below here makes descending pointless.\n const canMatch = !prefix || prefix.startsWith(entryKey) || entryKey.startsWith(prefix);\n\n if (useRecursive && canMatch) {\n await scanDirectory({ directory: { path: entryPath, prefix: entryKey } });\n }\n\n continue;\n }\n\n if (!entry.isFile() || (prefix && !entryKey.startsWith(prefix))) {\n continue;\n }\n\n const stat = await this.statOrNull({ target: entryPath });\n\n if (!stat) {\n continue;\n }\n\n objects.push({ name: entryKey, size: stat.size, lastModified: stat.mtime });\n }\n };\n\n await scanDirectory({ directory: { path: bucketPath } });\n\n return objects;\n }\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@venizia/ignis-helpers",
3
- "version": "0.4.8-8",
3
+ "version": "0.4.8-9",
4
4
  "description": "Production-ready TypeScript utility library: pluggable logging (winston or pino behind one ILogger contract), Redis single/cluster/sentinel with pub/sub, BullMQ/MQTT/Kafka message queues, MinIO/Disk/Bun-S3 object storage, AES-256/RSA/ECDH cryptography, Snowflake UID generation, cron scheduling, Socket.IO/WebSocket, TCP/TLS/UDP networking, HTTP clients, secrets/Vault, worker thread pools, and environment management. Sub-path imports isolate optional peer dependencies so the root barrel never forces a peer into your bundle.",
5
5
  "keywords": [
6
6
  "aes",
@@ -188,7 +188,7 @@
188
188
  "@socket.io/redis-emitter": "^5.1.0",
189
189
  "@types/bun": "^1.4.3",
190
190
  "@types/luxon": "^3.7.6",
191
- "@venizia/dev-configs": "0.4.8-5",
191
+ "@venizia/dev-configs": "0.4.8-7",
192
192
  "axios": "^1.20.0",
193
193
  "bullmq": "^6.4.0",
194
194
  "cron": "^4.4.0",