@fragno-dev/upload 0.1.1 → 0.1.3

package/dist/node/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","names":[],"sources":["../../src/definition.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;cAQa,6CAAwB,mBAAA,sBAAA,iBAAA,CAAA,8BAAA;kBAAA;;;;;;;;;MAAxB,cAAA,EAAA,CAAA,OAqFH,iBAAA,EAAA,GAAA,IAAA,UAAA,CAAA,IAAA,CAAA;MAAA,aAAA,EAAA,CAAA,OAAA,iBAAA,EAAA,GAAA,IAAA,UAAA,CAAA,IAAA,CAAA;MArF2B,eAAA,EAAA,CAAA,OAAA,sBAAA,EAAA,GAAA,IAAA,UAAA,CAAA,IAAA,CAAA;IAAA,CAAA,CAAA;KAAA,OAAA,gBAAA,EAAA,6BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BpB;;;;;;;;sBAOoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAPpB,CAAA,CAAA;;IAOoB,SAAA,CAAA,kDAAA,CAAA,CAAA,MAAA,SAAA,CAAA,oCAAA,QAAA,EAAA,SAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,OAAA,EAAA,OAAA,EAAA,KAAA,EAAA,KAAA,EAAA,KAAA,EAAA,KAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBApCA,GAAA,IAAA;IAAA,SAAA,MAAA"}
+{"version":3,"file":"definition.d.ts","names":[],"sources":["../../src/definition.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;cAea,6CAAwB,mBAAA,sBAAA,iBAAA,CAAA,8BAAA;kBAAA;;;;;;;;;MAAxB,cAAA,EAAA,CAAA,OAmJH,iBAAA,EAAA,GAAA,IAAA,UAAA,CAAA,IAAA,CAAA;MAAA,aAAA,EAAA,CAAA,OAAA,iBAAA,EAAA,GAAA,IAAA,UAAA,CAAA,IAAA,CAAA;MAnJ2B,oBAAA,EAAA,CAAA,OAAA,iBAAA,EAAA,GAAA,IAAA,UAAA,CAAA,IAAA,CAAA;MAAA,eAAA,EAAA,CAAA,OAAA,sBAAA,EAAA,GAAA,IAAA,UAAA,CAAA,IAAA,CAAA;IAAA,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiB9B;;;;;;;;;sBAQmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBARnB;;;;;;;;;sBAQmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBARnB;;;;;;;;;sBAQmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MARnB,cAAA,EAAA,CAAA,OAAA,iBAAA,EAAA,GAAA,IAAA,UAAA,CAAA,IAAA,CAAA;;MAQmB,oBAAA,EAAA,CAAA,OAAA,iBAAA,EAAA,GAAA,IAAA,UAAA,CAAA,IAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KARnB;;IAQmB,GAAA,EAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KARnB,EAAA;;IAQmB,QAAA,0CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAzBW,QAAA,EAAA,MAAA"}

package/dist/node/definition.js

@@ -7,7 +7,10 @@ import { defineFragment } from "@fragno-dev/core";
 import { withDatabase } from "@fragno-dev/db";
 
 //#region src/definition.ts
+const buildMissingDeletedFileObjectKeyError = (input) => `Missing persisted objectKey for deleted file '${input.provider}:${input.fileKey}'. Refusing to reconstruct storage key from provider/fileKey.`;
+const buildMissingCleanupObjectKeyError = (input) => `Missing storage cleanup objectKey for '${input.provider}:${input.fileKey}'. Refusing to reconstruct storage key from provider/fileKey.`;
 const uploadFragmentDefinition = defineFragment("upload").extend(withDatabase(uploadSchema)).withDependencies(({ config }) => ({ resolvedConfig: resolveUploadFragmentConfig(config) })).provideHooks(({ defineHook, config }) => {
+	const resolvedConfig = resolveUploadFragmentConfig(config);
 	return {
 		onFileReady: defineHook(async function(payload) {
 			await config.onFileReady?.(payload, this.idempotencyKey);
@@ -15,8 +18,28 @@ const uploadFragmentDefinition = defineFragment("upload").extend(withDatabase(up
 		onUploadFailed: defineHook(async function(payload) {
 			await config.onUploadFailed?.(payload, this.idempotencyKey);
 		}),
+		cleanupStorageObject: defineHook(async function(payload) {
+			const objectKey = typeof payload.objectKey === "string" && payload.objectKey.length > 0 ? payload.objectKey : null;
+			if (!objectKey) throw new Error(buildMissingCleanupObjectKeyError({
+				provider: payload.provider,
+				fileKey: payload.fileKey
+			}));
+			await resolvedConfig.storage.deleteObject({ storageKey: objectKey });
+		}),
 		onFileDeleted: defineHook(async function(payload) {
-			await config.onFileDeleted?.(payload, this.idempotencyKey);
+			const persistedObjectKey = (typeof payload.objectKey === "string" && payload.objectKey.length > 0 ? payload.objectKey : void 0) ?? await this.handlerTx().retrieve(({ forSchema }) => forSchema(uploadSchema).findFirst("file", (b) => b.whereIndex("idx_file_provider_key", (eb) => eb.and(eb("provider", "=", payload.provider), eb("key", "=", payload.fileKey))))).transformRetrieve(([file]) => {
+				if (file?.status === "deleted" && typeof file.objectKey === "string" && file.objectKey.length > 0) return file.objectKey;
+				return null;
+			}).execute();
+			if (!persistedObjectKey) throw new Error(buildMissingDeletedFileObjectKeyError({
+				provider: payload.provider,
+				fileKey: payload.fileKey
+			}));
+			await resolvedConfig.storage.deleteObject({ storageKey: persistedObjectKey });
+			await config.onFileDeleted?.({
+				...payload,
+				objectKey: persistedObjectKey
+			}, this.idempotencyKey);
 		}),
 		onUploadTimeout: defineHook(async function(payload) {
 			const now = /* @__PURE__ */ new Date();
@@ -35,8 +58,9 @@ const uploadFragmentDefinition = defineFragment("upload").extend(withDatabase(up
 				return {
 					shouldNotify: true,
 					payload: {
-						fileKey: upload.fileKey,
-						fileKeyParts: payload.fileKeyParts,
+						provider: upload.provider,
+						fileKey: upload.key,
+						objectKey: upload.objectKey,
 						uploadId: payload.uploadId,
 						uploaderId: upload.uploaderId,
 						sizeBytes: Number(upload.expectedSizeBytes),

package/dist/node/definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition.js","names":[],"sources":["../../src/definition.ts"],"sourcesContent":["import { defineFragment } from \"@fragno-dev/core\";\nimport { withDatabase } from \"@fragno-dev/db\";\nimport type { UploadFragmentConfig } from \"./config\";\nimport { resolveUploadFragmentConfig } from \"./config\";\nimport { uploadSchema } from \"./schema\";\nimport { createFileServices, createUploadServices } from \"./services\";\nimport type { UploadStatus } from \"./types\";\n\nexport const uploadFragmentDefinition = defineFragment<UploadFragmentConfig>(\"upload\")\n  .extend(withDatabase(uploadSchema))\n  .withDependencies(({ config }) => ({\n    resolvedConfig: resolveUploadFragmentConfig(config),\n  }))\n  .provideHooks(({ defineHook, config }) => {\n    return {\n      onFileReady: defineHook(async function (payload) {\n        await config.onFileReady?.(payload, this.idempotencyKey);\n      }),\n      onUploadFailed: defineHook(async function (payload) {\n        await config.onUploadFailed?.(payload, this.idempotencyKey);\n      }),\n      onFileDeleted: defineHook(async function (payload) {\n        await config.onFileDeleted?.(payload, this.idempotencyKey);\n      }),\n      onUploadTimeout: defineHook(async function (payload) {\n        const now = new Date();\n\n        if (!payload.uploadId) {\n          return;\n        }\n\n        const result = await this.handlerTx()\n          .retrieve(({ forSchema }) =>\n            forSchema(uploadSchema).findFirst(\"upload\", (b) =>\n              b.whereIndex(\"primary\", (eb) => eb(\"id\", \"=\", payload.uploadId)),\n            ),\n          )\n          .mutate(({ forSchema, retrieveResult: [upload] }) => {\n            if (!upload) {\n              return { shouldNotify: false as const };\n            }\n\n            const status = upload.status as UploadStatus;\n            if (\n              status === \"completed\" ||\n              status === \"aborted\" ||\n              status === \"failed\" ||\n              status === \"expired\"\n            ) {\n              return { shouldNotify: false as const };\n            }\n\n            if (upload.expiresAt.getTime() > now.getTime()) {\n              return { shouldNotify: false as const };\n            }\n\n            const uow = forSchema(uploadSchema);\n            uow.update(\"upload\", upload.id, (b) =>\n              b.set({\n                status: \"expired\",\n                updatedAt: now,\n                errorCode: \"UPLOAD_EXPIRED\",\n                errorMessage: \"Upload expired\",\n              }),\n            );\n\n            return {\n              shouldNotify: true as const,\n              payload: {\n                fileKey: upload.fileKey,\n                fileKeyParts: payload.fileKeyParts,\n                uploadId: payload.uploadId,\n                uploaderId: upload.uploaderId,\n                sizeBytes: Number(upload.expectedSizeBytes),\n                contentType: upload.contentType,\n              },\n            };\n          })\n          .transform(({ mutateResult }) => mutateResult)\n          .execute();\n\n        if (result.shouldNotify) {\n          await config.onUploadFailed?.(result.payload, this.idempotencyKey);\n        }\n      }),\n    };\n  })\n  .providesBaseService(({ defineService, deps }) => {\n    return defineService({\n      ...createUploadServices(deps.resolvedConfig),\n      ...createFileServices(deps.resolvedConfig),\n    });\n  })\n  .build();\n"],"mappings":";;;;;;;;;AAQA,MAAa,2BAA2B,eAAqC,SAAS,CACnF,OAAO,aAAa,aAAa,CAAC,CAClC,kBAAkB,EAAE,cAAc,EACjC,gBAAgB,4BAA4B,OAAO,EACpD,EAAE,CACF,cAAc,EAAE,YAAY,aAAa;AACxC,QAAO;EACL,aAAa,WAAW,eAAgB,SAAS;AAC/C,SAAM,OAAO,cAAc,SAAS,KAAK,eAAe;IACxD;EACF,gBAAgB,WAAW,eAAgB,SAAS;AAClD,SAAM,OAAO,iBAAiB,SAAS,KAAK,eAAe;IAC3D;EACF,eAAe,WAAW,eAAgB,SAAS;AACjD,SAAM,OAAO,gBAAgB,SAAS,KAAK,eAAe;IAC1D;EACF,iBAAiB,WAAW,eAAgB,SAAS;GACnD,MAAM,sBAAM,IAAI,MAAM;AAEtB,OAAI,CAAC,QAAQ,SACX;GAGF,MAAM,SAAS,MAAM,KAAK,WAAW,CAClC,UAAU,EAAE,gBACX,UAAU,aAAa,CAAC,UAAU,WAAW,MAC3C,EAAE,WAAW,YAAY,OAAO,GAAG,MAAM,KAAK,QAAQ,SAAS,CAAC,CACjE,CACF,CACA,QAAQ,EAAE,WAAW,gBAAgB,CAAC,cAAc;AACnD,QAAI,CAAC,OACH,QAAO,EAAE,cAAc,OAAgB;IAGzC,MAAM,SAAS,OAAO;AACtB,QACE,WAAW,eACX,WAAW,aACX,WAAW,YACX,WAAW,UAEX,QAAO,EAAE,cAAc,OAAgB;AAGzC,QAAI,OAAO,UAAU,SAAS,GAAG,IAAI,SAAS,CAC5C,QAAO,EAAE,cAAc,OAAgB;AAIzC,IADY,UAAU,aAAa,CAC/B,OAAO,UAAU,OAAO,KAAK,MAC/B,EAAE,IAAI;KACJ,QAAQ;KACR,WAAW;KACX,WAAW;KACX,cAAc;KACf,CAAC,CACH;AAED,WAAO;KACL,cAAc;KACd,SAAS;MACP,SAAS,OAAO;MAChB,cAAc,QAAQ;MACtB,UAAU,QAAQ;MAClB,YAAY,OAAO;MACnB,WAAW,OAAO,OAAO,kBAAkB;MAC3C,aAAa,OAAO;MACrB;KACF;KACD,CACD,WAAW,EAAE,mBAAmB,aAAa,CAC7C,SAAS;AAEZ,OAAI,OAAO,aACT,OAAM,OAAO,iBAAiB,OAAO,SAAS,KAAK,eAAe;IAEpE;EACH;EACD,CACD,qBAAqB,EAAE,eAAe,WAAW;AAChD,QAAO,cAAc;EACnB,GAAG,qBAAqB,KAAK,eAAe;EAC5C,GAAG,mBAAmB,KAAK,eAAe;EAC3C,CAAC;EACF,CACD,OAAO"}
+{"version":3,"file":"definition.js","names":[],"sources":["../../src/definition.ts"],"sourcesContent":["import { defineFragment } from \"@fragno-dev/core\";\nimport { withDatabase } from \"@fragno-dev/db\";\n\nimport type { UploadFragmentConfig } from \"./config\";\nimport { resolveUploadFragmentConfig } from \"./config\";\nimport { uploadSchema } from \"./schema\";\nimport { createFileServices, createUploadServices } from \"./services\";\nimport type { UploadStatus } from \"./types\";\n\nconst buildMissingDeletedFileObjectKeyError = (input: { provider: string; fileKey: string }) =>\n  `Missing persisted objectKey for deleted file '${input.provider}:${input.fileKey}'. Refusing to reconstruct storage key from provider/fileKey.`;\n\nconst buildMissingCleanupObjectKeyError = (input: { provider: string; fileKey: string }) =>\n  `Missing storage cleanup objectKey for '${input.provider}:${input.fileKey}'. Refusing to reconstruct storage key from provider/fileKey.`;\n\nexport const uploadFragmentDefinition = defineFragment<UploadFragmentConfig>(\"upload\")\n  .extend(withDatabase(uploadSchema))\n  .withDependencies(({ config }) => ({\n    resolvedConfig: resolveUploadFragmentConfig(config),\n  }))\n  .provideHooks(({ defineHook, config }) => {\n    const resolvedConfig = resolveUploadFragmentConfig(config);\n\n    return {\n      onFileReady: defineHook(async function (payload) {\n        await config.onFileReady?.(payload, this.idempotencyKey);\n      }),\n      onUploadFailed: defineHook(async function (payload) {\n        await config.onUploadFailed?.(payload, this.idempotencyKey);\n      }),\n      cleanupStorageObject: defineHook(async function (payload) {\n        const objectKey =\n          typeof payload.objectKey === \"string\" && payload.objectKey.length > 0\n            ? payload.objectKey\n            : null;\n\n        if (!objectKey) {\n          throw new Error(\n            buildMissingCleanupObjectKeyError({\n              provider: payload.provider,\n              fileKey: payload.fileKey,\n            }),\n          );\n        }\n\n        await resolvedConfig.storage.deleteObject({ storageKey: objectKey });\n      }),\n      onFileDeleted: defineHook(async function (payload) {\n        const payloadObjectKey =\n          typeof payload.objectKey === \"string\" && payload.objectKey.length > 0\n            ? payload.objectKey\n            : undefined;\n        const persistedObjectKey =\n          payloadObjectKey ??\n          (await this.handlerTx()\n            .retrieve(({ forSchema }) =>\n              forSchema(uploadSchema).findFirst(\"file\", (b) =>\n                b.whereIndex(\"idx_file_provider_key\", (eb) =>\n                  eb.and(eb(\"provider\", \"=\", payload.provider), eb(\"key\", \"=\", payload.fileKey)),\n                ),\n              ),\n            )\n            .transformRetrieve(([file]) => {\n              if (\n                file?.status === \"deleted\" &&\n                typeof file.objectKey === \"string\" &&\n                file.objectKey.length > 0\n              ) {\n                return file.objectKey;\n              }\n              return null;\n            })\n            .execute());\n\n        if (!persistedObjectKey) {\n          throw new Error(\n            buildMissingDeletedFileObjectKeyError({\n              provider: payload.provider,\n              fileKey: payload.fileKey,\n            }),\n          );\n        }\n\n        await resolvedConfig.storage.deleteObject({ storageKey: persistedObjectKey });\n        await config.onFileDeleted?.(\n          {\n            ...payload,\n            objectKey: persistedObjectKey,\n          },\n          this.idempotencyKey,\n        );\n      }),\n      onUploadTimeout: defineHook(async function (payload) {\n        const now = new Date();\n\n        if (!payload.uploadId) {\n          return;\n        }\n\n        const result = await this.handlerTx()\n          .retrieve(({ forSchema }) =>\n            forSchema(uploadSchema).findFirst(\"upload\", (b) =>\n              b.whereIndex(\"primary\", (eb) => eb(\"id\", \"=\", payload.uploadId)),\n            ),\n          )\n          .mutate(({ forSchema, retrieveResult: [upload] }) => {\n            if (!upload) {\n              return { shouldNotify: false as const };\n            }\n\n            const status = upload.status as UploadStatus;\n            if (\n              status === \"completed\" ||\n              status === \"aborted\" ||\n              status === \"failed\" ||\n              status === \"expired\"\n            ) {\n              return { shouldNotify: false as const };\n            }\n\n            if (upload.expiresAt.getTime() > now.getTime()) {\n              return { shouldNotify: false as const };\n            }\n\n            const uow = forSchema(uploadSchema);\n            uow.update(\"upload\", upload.id, (b) =>\n              b.set({\n                status: \"expired\",\n                updatedAt: now,\n                errorCode: \"UPLOAD_EXPIRED\",\n                errorMessage: \"Upload expired\",\n              }),\n            );\n\n            return {\n              shouldNotify: true as const,\n              payload: {\n                provider: upload.provider,\n                fileKey: upload.key,\n                objectKey: upload.objectKey,\n                uploadId: payload.uploadId,\n                uploaderId: upload.uploaderId,\n                sizeBytes: Number(upload.expectedSizeBytes),\n                contentType: upload.contentType,\n              },\n            };\n          })\n          .transform(({ mutateResult }) => mutateResult)\n          .execute();\n\n        if (result.shouldNotify) {\n          await config.onUploadFailed?.(result.payload, this.idempotencyKey);\n        }\n      }),\n    };\n  })\n  .providesBaseService(({ defineService, deps }) => {\n    return defineService({\n      ...createUploadServices(deps.resolvedConfig),\n      ...createFileServices(deps.resolvedConfig),\n    });\n  })\n  .build();\n"],"mappings":"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"}

package/dist/node/file-key.d.ts

@@ -0,0 +1,19 @@
+//#region src/file-key.d.ts
+type FileKey = string;
+type FileKeyValidationResult = {
+  valid: true;
+} | {
+  valid: false;
+  reason: "EMPTY" | "TOO_LONG" | "EMPTY_SEGMENT" | "DOT_SEGMENT" | "CONTROL_CHARACTERS";
+};
+type ValidateFileKeyOptions = {
+  maxBytes?: number;
+};
+declare const validateFileKey: (value: string, options?: ValidateFileKeyOptions) => FileKeyValidationResult;
+declare const assertFileKey: (value: string, options?: ValidateFileKeyOptions) => FileKey;
+declare const splitFileKey: (value: string) => readonly string[];
+//# sourceMappingURL=file-key.d.ts.map
+
+//#endregion
+export { FileKey, FileKeyValidationResult, ValidateFileKeyOptions, assertFileKey, splitFileKey, validateFileKey };
+//# sourceMappingURL=file-key.d.ts.map

package/dist/node/file-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-key.d.ts","names":[],"sources":["../../src/file-key.ts"],"sourcesContent":[],"mappings":";KAAY,OAAA;AAAA,KAEA,uBAAA,GAFO;EAEP,KAAA,EAAA,IAAA;AAOZ,CAAA,GAAY;EAuBC,KAAA,EAAA,KAAA;EA4BZ,MAAA,EAAA,OAAA,GAAA,UAAA,GAAA,eAAA,GAAA,aAAA,GAAA,oBAAA;;AAzBE,KA1BS,sBAAA,GA0BT;EAyBF,QAAA,CAAA,EAAA,MAAA;AAED,CAAA;AAMC,cApCY,eAoCZ,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAlCU,sBAkCV,EAAA,GAjCE,uBAiCF;AANsD,cAA1C,aAA0C,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,sBAAA,EAAA,GAAyB,OAAzB;AAAyB,cAQnE,YARmE,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,GAAA,SAAA,MAAA,EAAA"}

package/dist/node/file-key.js

@@ -0,0 +1,47 @@
+//#region src/file-key.ts
+const hasControlCharacters = (value) => {
+	for (let index = 0; index < value.length; index += 1) {
+		const code = value.charCodeAt(index);
+		if (code <= 31 || code === 127) return true;
+	}
+	return false;
+};
+const utf8ByteLength = (value) => {
+	if (typeof Buffer !== "undefined") return Buffer.byteLength(value, "utf8");
+	return new TextEncoder().encode(value).byteLength;
+};
+const validateFileKey = (value, options = {}) => {
+	if (value.length === 0) return {
+		valid: false,
+		reason: "EMPTY"
+	};
+	if (hasControlCharacters(value)) return {
+		valid: false,
+		reason: "CONTROL_CHARACTERS"
+	};
+	const segments = value.split("/");
+	for (const segment of segments) {
+		if (segment.length === 0) return {
+			valid: false,
+			reason: "EMPTY_SEGMENT"
+		};
+		if (segment === "." || segment === "..") return {
+			valid: false,
+			reason: "DOT_SEGMENT"
+		};
+	}
+	if (typeof options.maxBytes === "number" && utf8ByteLength(value) > options.maxBytes) return {
+		valid: false,
+		reason: "TOO_LONG"
+	};
+	return { valid: true };
+};
+const assertFileKey = (value, options) => {
+	if (!validateFileKey(value, options).valid) throw new Error("INVALID_FILE_KEY");
+	return value;
+};
+const splitFileKey = (value) => assertFileKey(value).split("/");
+
+//#endregion
+export { assertFileKey, splitFileKey, validateFileKey };
+//# sourceMappingURL=file-key.js.map

package/dist/node/file-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-key.js","names":[],"sources":["../../src/file-key.ts"],"sourcesContent":["export type FileKey = string;\n\nexport type FileKeyValidationResult =\n  | { valid: true }\n  | {\n      valid: false;\n      reason: \"EMPTY\" | \"TOO_LONG\" | \"EMPTY_SEGMENT\" | \"DOT_SEGMENT\" | \"CONTROL_CHARACTERS\";\n    };\n\nexport type ValidateFileKeyOptions = {\n  maxBytes?: number;\n};\n\nconst hasControlCharacters = (value: string): boolean => {\n  for (let index = 0; index < value.length; index += 1) {\n    const code = value.charCodeAt(index);\n    if (code <= 0x1f || code === 0x7f) {\n      return true;\n    }\n  }\n\n  return false;\n};\n\nconst utf8ByteLength = (value: string): number => {\n  if (typeof Buffer !== \"undefined\") {\n    return Buffer.byteLength(value, \"utf8\");\n  }\n\n  return new TextEncoder().encode(value).byteLength;\n};\n\nexport const validateFileKey = (\n  value: string,\n  options: ValidateFileKeyOptions = {},\n): FileKeyValidationResult => {\n  if (value.length === 0) {\n    return { valid: false, reason: \"EMPTY\" };\n  }\n\n  if (hasControlCharacters(value)) {\n    return { valid: false, reason: \"CONTROL_CHARACTERS\" };\n  }\n\n  const segments = value.split(\"/\");\n  for (const segment of segments) {\n    if (segment.length === 0) {\n      return { valid: false, reason: \"EMPTY_SEGMENT\" };\n    }\n\n    if (segment === \".\" || segment === \"..\") {\n      return { valid: false, reason: \"DOT_SEGMENT\" };\n    }\n  }\n\n  if (typeof options.maxBytes === \"number\" && utf8ByteLength(value) > options.maxBytes) {\n    return { valid: false, reason: \"TOO_LONG\" };\n  }\n\n  return { valid: true };\n};\n\nexport const assertFileKey = (value: string, options?: ValidateFileKeyOptions): FileKey => {\n  const result = validateFileKey(value, options);\n  if (!result.valid) {\n    throw new Error(\"INVALID_FILE_KEY\");\n  }\n  return value;\n};\n\nexport const splitFileKey = (value: string): readonly string[] => assertFileKey(value).split(\"/\");\n"],"mappings":";AAaA,MAAM,wBAAwB,UAA2B;AACvD,MAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS,GAAG;EACpD,MAAM,OAAO,MAAM,WAAW,MAAM;AACpC,MAAI,QAAQ,MAAQ,SAAS,IAC3B,QAAO;;AAIX,QAAO;;AAGT,MAAM,kBAAkB,UAA0B;AAChD,KAAI,OAAO,WAAW,YACpB,QAAO,OAAO,WAAW,OAAO,OAAO;AAGzC,QAAO,IAAI,aAAa,CAAC,OAAO,MAAM,CAAC;;AAGzC,MAAa,mBACX,OACA,UAAkC,EAAE,KACR;AAC5B,KAAI,MAAM,WAAW,EACnB,QAAO;EAAE,OAAO;EAAO,QAAQ;EAAS;AAG1C,KAAI,qBAAqB,MAAM,CAC7B,QAAO;EAAE,OAAO;EAAO,QAAQ;EAAsB;CAGvD,MAAM,WAAW,MAAM,MAAM,IAAI;AACjC,MAAK,MAAM,WAAW,UAAU;AAC9B,MAAI,QAAQ,WAAW,EACrB,QAAO;GAAE,OAAO;GAAO,QAAQ;GAAiB;AAGlD,MAAI,YAAY,OAAO,YAAY,KACjC,QAAO;GAAE,OAAO;GAAO,QAAQ;GAAe;;AAIlD,KAAI,OAAO,QAAQ,aAAa,YAAY,eAAe,MAAM,GAAG,QAAQ,SAC1E,QAAO;EAAE,OAAO;EAAO,QAAQ;EAAY;AAG7C,QAAO,EAAE,OAAO,MAAM;;AAGxB,MAAa,iBAAiB,OAAe,YAA8C;AAEzF,KAAI,CADW,gBAAgB,OAAO,QAAQ,CAClC,MACV,OAAM,IAAI,MAAM,mBAAmB;AAErC,QAAO;;AAGT,MAAa,gBAAgB,UAAqC,cAAc,MAAM,CAAC,MAAM,IAAI"}