@drawbridge/drawbridge-utils 0.0.6 → 0.0.8

package/dist/nanoid.cjs

@@ -0,0 +1,53 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// nanoid.js
+var nanoid_exports = {};
+__export(nanoid_exports, {
+  nanoid: () => nanoid,
+  retry: () => retry
+});
+module.exports = __toCommonJS(nanoid_exports);
+var import_nanoid = require("nanoid");
+var nanoid = (0, import_nanoid.customAlphabet)("0123456789abcdefghijklmnopqrstuvwxyz", 8);
+var DEFAULT_MAX_RETRIES = 5;
+var retry = async ({
+  field,
+  operation,
+  maxRetries = DEFAULT_MAX_RETRIES
+}) => {
+  var _a;
+  for (let attempt = 0; attempt < maxRetries; attempt++) {
+    try {
+      return await operation(nanoid());
+    } catch (error) {
+      const isCollision = (error == null ? void 0 : error.code) === 11e3 && ((_a = error == null ? void 0 : error.keyPattern) == null ? void 0 : _a[field]);
+      if (!isCollision || attempt === maxRetries - 1) {
+        throw error;
+      }
+      ;
+    }
+    ;
+  }
+  ;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  nanoid,
+  retry
+});

package/dist/nanoid.d.cts

@@ -0,0 +1,63 @@
+import { customAlphabet } from 'nanoid';
+
+// 8-char base36 nanoid (36⁸ ≈ 2.8T entropy). Used as the short-id / slug
+// generator across drawbridge collections with unique indexes (page.shortId,
+// organization.shortId, affiliate.shortId, link.slug, prize.slug,
+// advertisement.slug, etc.).
+//
+// Also exported from the main entrypoint for back-compat:
+//   const { nanoid } = require( '@drawbridge/drawbridge-utils' );
+//
+// New code should prefer this subpath, which also exposes `retry`:
+//   const { nanoid, retry } = require( '@drawbridge/drawbridge-utils/nanoid' );
+
+const nanoid = customAlphabet( '0123456789abcdefghijklmnopqrstuvwxyz', 8 );
+
+// Retry an async operation when Mongo rejects an insert because of a
+// duplicate-key error on a specific field. The operation receives a fresh
+// nanoid() on each attempt — typically used for shortId / slug fields where
+// a unique index is in place and the value is randomly generated.
+//
+//   const result = await retry({
+//     field : 'shortId',
+//     operation : ( shortId ) => controller.create({
+//       collection : 'page',
+//       data : { ..., shortId }
+//     })
+//   });
+//
+// Throws immediately if the error is anything other than E11000 on the named
+// field. Throws the last error if retries are exhausted (extremely unlikely
+// at 36⁸ entropy — 5 consecutive collisions are astronomically improbable).
+
+const DEFAULT_MAX_RETRIES = 5;
+
+const retry = async ({
+	field,
+	operation,
+	maxRetries = DEFAULT_MAX_RETRIES
+}) => {
+
+	for( let attempt = 0; attempt < maxRetries; attempt++ ){
+
+		try {
+
+			return await operation( nanoid() );
+
+		} catch ( error ){
+
+			const isCollision = (
+				error?.code === 11000 &&
+				error?.keyPattern?.[ field ]
+			);
+
+			if( ! isCollision || attempt === maxRetries - 1 ){
+
+				throw error;
+
+			}
+		}
+	}
+};
+
+export { nanoid, retry };

package/dist/nanoid.d.ts

@@ -0,0 +1,63 @@
+import { customAlphabet } from 'nanoid';
+
+// 8-char base36 nanoid (36⁸ ≈ 2.8T entropy). Used as the short-id / slug
+// generator across drawbridge collections with unique indexes (page.shortId,
+// organization.shortId, affiliate.shortId, link.slug, prize.slug,
+// advertisement.slug, etc.).
+//
+// Also exported from the main entrypoint for back-compat:
+//   const { nanoid } = require( '@drawbridge/drawbridge-utils' );
+//
+// New code should prefer this subpath, which also exposes `retry`:
+//   const { nanoid, retry } = require( '@drawbridge/drawbridge-utils/nanoid' );
+
+const nanoid = customAlphabet( '0123456789abcdefghijklmnopqrstuvwxyz', 8 );
+
+// Retry an async operation when Mongo rejects an insert because of a
+// duplicate-key error on a specific field. The operation receives a fresh
+// nanoid() on each attempt — typically used for shortId / slug fields where
+// a unique index is in place and the value is randomly generated.
+//
+//   const result = await retry({
+//     field : 'shortId',
+//     operation : ( shortId ) => controller.create({
+//       collection : 'page',
+//       data : { ..., shortId }
+//     })
+//   });
+//
+// Throws immediately if the error is anything other than E11000 on the named
+// field. Throws the last error if retries are exhausted (extremely unlikely
+// at 36⁸ entropy — 5 consecutive collisions are astronomically improbable).
+
+const DEFAULT_MAX_RETRIES = 5;
+
+const retry = async ({
+	field,
+	operation,
+	maxRetries = DEFAULT_MAX_RETRIES
+}) => {
+
+	for( let attempt = 0; attempt < maxRetries; attempt++ ){
+
+		try {
+
+			return await operation( nanoid() );
+
+		} catch ( error ){
+
+			const isCollision = (
+				error?.code === 11000 &&
+				error?.keyPattern?.[ field ]
+			);
+
+			if( ! isCollision || attempt === maxRetries - 1 ){
+
+				throw error;
+
+			}
+		}
+	}
+};
+
+export { nanoid, retry };

package/dist/nanoid.js

@@ -0,0 +1,28 @@
+// nanoid.js
+import { customAlphabet } from "nanoid";
+var nanoid = customAlphabet("0123456789abcdefghijklmnopqrstuvwxyz", 8);
+var DEFAULT_MAX_RETRIES = 5;
+var retry = async ({
+  field,
+  operation,
+  maxRetries = DEFAULT_MAX_RETRIES
+}) => {
+  var _a;
+  for (let attempt = 0; attempt < maxRetries; attempt++) {
+    try {
+      return await operation(nanoid());
+    } catch (error) {
+      const isCollision = (error == null ? void 0 : error.code) === 11e3 && ((_a = error == null ? void 0 : error.keyPattern) == null ? void 0 : _a[field]);
+      if (!isCollision || attempt === maxRetries - 1) {
+        throw error;
+      }
+      ;
+    }
+    ;
+  }
+  ;
+};
+export {
+  nanoid,
+  retry
+};

package/dist/upload.cjs

@@ -0,0 +1,65 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// upload.js
+var upload_exports = {};
+__export(upload_exports, {
+  allowedMimes: () => allowedMimes,
+  allowedUploadTypes: () => allowedUploadTypes,
+  isAllowedMime: () => isAllowedMime,
+  resolveUploadType: () => resolveUploadType
+});
+module.exports = __toCommonJS(upload_exports);
+var allowedUploadTypes = {
+  application: {
+    pdf: "application/pdf"
+  },
+  image: {
+    jpeg: "image/jpeg",
+    jpg: "image/jpeg",
+    png: "image/png",
+    webp: "image/webp"
+  },
+  video: {
+    mp4: "video/mp4"
+  }
+};
+var allowedMimes = new Set(
+  Object.values(allowedUploadTypes).flatMap(
+    (extensions) => Object.values(extensions)
+  )
+);
+var resolveUploadType = (type, extension) => {
+  var _a;
+  const mime = (_a = allowedUploadTypes == null ? void 0 : allowedUploadTypes[type]) == null ? void 0 : _a[extension];
+  if (!mime) {
+    const error = new Error("Unsupported upload type or extension");
+    error.status = 400;
+    throw error;
+  }
+  ;
+  return mime;
+};
+var isAllowedMime = (mime) => allowedMimes.has(mime);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  allowedMimes,
+  allowedUploadTypes,
+  isAllowedMime,
+  resolveUploadType
+});

package/dist/upload.d.cts

@@ -0,0 +1,58 @@
+// Source-of-truth allowlist for file upload types accepted across drawbridge.
+//
+// Two consumer shapes:
+//
+//   1. The API needs `(type, extension) → mime` when serving an upload route
+//      where the URL carries those params. Use `resolveUploadType( type, extension )`.
+//      Throws { status: 400 } on anything not in the allowlist.
+//
+//   2. The sync worker downstream needs to validate that a `mimetype` flowing
+//      from the DB / job payload is one of the canonical values before passing
+//      it to S3 as a ContentType header. Use `isAllowedMime( mime )`.
+//
+// Adding a new accepted upload format means updating `allowedUploadTypes` here
+// AND publishing a new utils version. Both api and sync inherit the change.
+//
+// Why both helpers and not just one: api routes know (type, extension) but not
+// the canonical mime; sync workers have the mime but not the original type tuple.
+
+const allowedUploadTypes = {
+	application : {
+		pdf : 'application/pdf'
+	},
+	image : {
+		jpeg : 'image/jpeg',
+		jpg : 'image/jpeg',
+		png : 'image/png',
+		webp : 'image/webp'
+	},
+	video : {
+		mp4 : 'video/mp4'
+	}
+};
+
+const allowedMimes = new Set(
+	Object.values( allowedUploadTypes ).flatMap(
+		( extensions ) => Object.values( extensions )
+	)
+);
+
+const resolveUploadType = ( type, extension ) => {
+
+	const mime = allowedUploadTypes?.[ type ]?.[ extension ];
+
+	if( ! mime ){
+
+		const error = new Error( 'Unsupported upload type or extension' );
+		error.status = 400;
+
+		throw error;
+
+	}
+	return mime;
+
+};
+
+const isAllowedMime = ( mime ) => allowedMimes.has( mime );
+
+export { allowedMimes, allowedUploadTypes, isAllowedMime, resolveUploadType };

package/dist/upload.d.ts

@@ -0,0 +1,58 @@
+// Source-of-truth allowlist for file upload types accepted across drawbridge.
+//
+// Two consumer shapes:
+//
+//   1. The API needs `(type, extension) → mime` when serving an upload route
+//      where the URL carries those params. Use `resolveUploadType( type, extension )`.
+//      Throws { status: 400 } on anything not in the allowlist.
+//
+//   2. The sync worker downstream needs to validate that a `mimetype` flowing
+//      from the DB / job payload is one of the canonical values before passing
+//      it to S3 as a ContentType header. Use `isAllowedMime( mime )`.
+//
+// Adding a new accepted upload format means updating `allowedUploadTypes` here
+// AND publishing a new utils version. Both api and sync inherit the change.
+//
+// Why both helpers and not just one: api routes know (type, extension) but not
+// the canonical mime; sync workers have the mime but not the original type tuple.
+
+const allowedUploadTypes = {
+	application : {
+		pdf : 'application/pdf'
+	},
+	image : {
+		jpeg : 'image/jpeg',
+		jpg : 'image/jpeg',
+		png : 'image/png',
+		webp : 'image/webp'
+	},
+	video : {
+		mp4 : 'video/mp4'
+	}
+};
+
+const allowedMimes = new Set(
+	Object.values( allowedUploadTypes ).flatMap(
+		( extensions ) => Object.values( extensions )
+	)
+);
+
+const resolveUploadType = ( type, extension ) => {
+
+	const mime = allowedUploadTypes?.[ type ]?.[ extension ];
+
+	if( ! mime ){
+
+		const error = new Error( 'Unsupported upload type or extension' );
+		error.status = 400;
+
+		throw error;
+
+	}
+	return mime;
+
+};
+
+const isAllowedMime = ( mime ) => allowedMimes.has( mime );
+
+export { allowedMimes, allowedUploadTypes, isAllowedMime, resolveUploadType };

package/dist/upload.js

@@ -0,0 +1,38 @@
+// upload.js
+var allowedUploadTypes = {
+  application: {
+    pdf: "application/pdf"
+  },
+  image: {
+    jpeg: "image/jpeg",
+    jpg: "image/jpeg",
+    png: "image/png",
+    webp: "image/webp"
+  },
+  video: {
+    mp4: "video/mp4"
+  }
+};
+var allowedMimes = new Set(
+  Object.values(allowedUploadTypes).flatMap(
+    (extensions) => Object.values(extensions)
+  )
+);
+var resolveUploadType = (type, extension) => {
+  var _a;
+  const mime = (_a = allowedUploadTypes == null ? void 0 : allowedUploadTypes[type]) == null ? void 0 : _a[extension];
+  if (!mime) {
+    const error = new Error("Unsupported upload type or extension");
+    error.status = 400;
+    throw error;
+  }
+  ;
+  return mime;
+};
+var isAllowedMime = (mime) => allowedMimes.has(mime);
+export {
+  allowedMimes,
+  allowedUploadTypes,
+  isAllowedMime,
+  resolveUploadType
+};

package/package.json

@@ -34,6 +34,16 @@
       "types": "./dist/circuit.d.ts",
       "import": "./dist/circuit.js",
       "require": "./dist/circuit.cjs"
+    },
+    "./upload": {
+      "types": "./dist/upload.d.ts",
+      "import": "./dist/upload.js",
+      "require": "./dist/upload.cjs"
+    },
+    "./nanoid": {
+      "types": "./dist/nanoid.d.ts",
+      "import": "./dist/nanoid.js",
+      "require": "./dist/nanoid.cjs"
     }
   },
   "files": [
@@ -50,5 +60,5 @@
     "build": "tsup && npm publish"
   },
   "types": "dist/index.d.ts",
-  "version": "0.0.6"
+  "version": "0.0.8"
 }