@drawbridge/drawbridge-utils 0.0.10 → 0.0.11

package/README.md

@@ -21,7 +21,8 @@ Exports:
 - `formatNumber( number, digits )` — Intl-based number formatter with fixed-digit min/max.
 - `getPlanFeature( plan, key )` — `{ granted, message }` lookup.
 - `infinite`, `isInfinite( value )`, `megabyte`, `gigabyte` — size constants.
-- `percentage( a, b, decimals )` — `(a / b) * 100`, fixed decimals.
+- `nanoid()` — 8-char base36 random ID.
+- `percentage( value1, value2, decimals )` — `(value1 / value2) * 100`, fixed decimals (default 1).
 - `reducers.fields` — reducer for grouping fields by `additional` / `lead` type.
 - `regex.url` / `regex.protocols` / `regex.domain` — shared regex constants.
 - `shareUrls({ formUri, organization, page })` — builds share URLs from the configured form base URI. Falls back to `process.env.APP_CLIENT_FORM_URI` if `formUri` is not passed (server-only).
@@ -35,6 +36,42 @@ const { encrypt, decrypt } = require( '@drawbridge/drawbridge-utils/encrypt' );
 
 Server-only because it uses Node `crypto` and reads `process.env.ENCRYPT_CONNECTION_SECRET`. Exposed as a sub-export so client bundles don't pull Node built-ins.
 
+## Axios entry (server-only)
+
+```js
+const { safe, axios } = require( '@drawbridge/drawbridge-utils/axios' );
+```
+
+- `safe.get( url, axiosOptions )` — SSRF-protected GET request.
+- `axios` — raw axios passthrough for advanced usage.
+
+## Circuit entry (server-only)
+
+```js
+const { circuit } = require( '@drawbridge/drawbridge-utils/circuit' );
+```
+
+- `circuit({ name, threshold, timeout })` — circuit breaker for async operations.
+
+## Upload entry
+
+```js
+const { allowedUploadTypes, allowedMimes, resolveUploadType, isAllowedMime } = require( '@drawbridge/drawbridge-utils/upload' );
+```
+
+- `allowedUploadTypes` / `allowedMimes` — shared whitelist constants.
+- `resolveUploadType( type, extension )` — resolves an upload type from MIME + extension.
+- `isAllowedMime( mime )` — predicate for the MIME whitelist.
+
+## Nanoid entry (server-only)
+
+```js
+const { nanoid, retry } = require( '@drawbridge/drawbridge-utils/nanoid' );
+```
+
+- `nanoid()` — 8-char base36 random ID (same as the main export).
+- `retry({ field, operation, maxRetries })` — runs an async operation that generates a nanoid, retrying on Mongo duplicate-key errors.
+
 ## Build & publish
 
 ```bash

package/dist/axios.cjs

@@ -103,7 +103,12 @@ var safeGet = async (url, axiosOptions = {}) => {
   const pinned = records[0];
   const agent = new import_https.default.Agent({
     lookup: (hostname, options, callback) => {
-      callback(null, pinned.address, pinned.family);
+      if (options == null ? void 0 : options.all) {
+        callback(null, [{ address: pinned.address, family: pinned.family }]);
+      } else {
+        callback(null, pinned.address, pinned.family);
+      }
+      ;
     }
   });
   return import_axios.default.get(url, {

package/dist/axios.d.cts

@@ -113,8 +113,19 @@ const safeGet = async ( url, axiosOptions = {} ) => {
 	const agent = new https.Agent({
 		lookup : ( hostname, options, callback ) => {
 
-			callback( null, pinned.address, pinned.family );
+			// Node's https.Agent (Happy Eyeballs) calls this with options.all = true
+			// and expects callback( err, [ { address, family } ] ); the legacy
+			// callback( err, address, family ) form only applies when options.all
+			// is falsy.
+			if( options?.all ){
 
+				callback( null, [ { address : pinned.address, family : pinned.family } ] );
+
+			} else {
+
+				callback( null, pinned.address, pinned.family );
+
+			}
 		}
 	});
 

package/dist/axios.d.ts

@@ -113,8 +113,19 @@ const safeGet = async ( url, axiosOptions = {} ) => {
 	const agent = new https.Agent({
 		lookup : ( hostname, options, callback ) => {
 
-			callback( null, pinned.address, pinned.family );
+			// Node's https.Agent (Happy Eyeballs) calls this with options.all = true
+			// and expects callback( err, [ { address, family } ] ); the legacy
+			// callback( err, address, family ) form only applies when options.all
+			// is falsy.
+			if( options?.all ){
 
+				callback( null, [ { address : pinned.address, family : pinned.family } ] );
+
+			} else {
+
+				callback( null, pinned.address, pinned.family );
+
+			}
 		}
 	});
 

package/dist/axios.js

@@ -68,7 +68,12 @@ var safeGet = async (url, axiosOptions = {}) => {
   const pinned = records[0];
   const agent = new https.Agent({
     lookup: (hostname, options, callback) => {
-      callback(null, pinned.address, pinned.family);
+      if (options == null ? void 0 : options.all) {
+        callback(null, [{ address: pinned.address, family: pinned.family }]);
+      } else {
+        callback(null, pinned.address, pinned.family);
+      }
+      ;
     }
   });
   return axiosLib.get(url, {

package/package.json

@@ -53,5 +53,5 @@
     "build": "tsup && npm publish"
   },
   "types": "dist/index.d.ts",
-  "version": "0.0.10"
+  "version": "0.0.11"
 }