@drawbridge/drawbridge-utils 0.0.1

package/README.md

@@ -0,0 +1,25 @@
+# @drawbridge/drawbridge-utils
+
+Shared helper functions used across the drawbridge-* repositories.
+
+## Exports
+
+- `capitalize( string )` — uppercases the first character.
+- `formatCurrency({ code, digits, display, locale, value })` — Intl-based currency formatter. `display: 'standard'` (default) returns Intl's standard string; `'parts'` splits symbol/number for custom layouts.
+- `formatDateString({ date, locale, options })` — Intl-based date formatter.
+- `formatNumber( number, digits )` — Intl-based number formatter with fixed-digit min/max.
+- `getPlanFeature( plan, key )` — looks up a feature on a plan; returns `{ granted, message }`.
+- `regex` — `{ url, protocols }` shared URL regex constants.
+- `shareUrls({ formUri, organization, page })` — builds page share URLs from the configured form base URI.
+- `urlRoot( string )` — `'https://'` if the input string contains `'https'`, else `'http://'`.
+- `infinite`, `isInfinite( value )`, `megabyte`, `gigabyte` — size-related constants.
+
+## Build & publish
+
+```bash
+nvm use
+npm install
+npm run build
+```
+
+`build` runs `tsup` (dual CJS + ESM output) and then `npm publish`. Bump the `version` in `package.json` first.

package/dist/index.d.mts

@@ -0,0 +1,163 @@
+const infinite = 1e300;
+
+const isInfinite = ( value ) => value === infinite;
+
+const megabyte = ( 1024 * 1024 );
+const gigabyte = ( megabyte * 1024 );
+
+const urlRoot = ( string ) => ( string?.includes( 'https' ) ? 'https://' : 'http://' );
+
+const capitalize = ( string ) => {
+
+	return string?.charAt( 0 )?.toUpperCase() + string?.slice( 1 );
+
+};
+
+const formatCurrency = ({
+	code = 'USD',
+	digits = 2,
+	display = 'standard',
+	locale,
+	value = 0
+}) => {
+
+	const resolvedLocale = locale
+		|| ( typeof navigator !== 'undefined' ? navigator?.language : null )
+		|| 'en-US';
+
+	const options = {
+		currency : code,
+		minimumFractionDigits : digits,
+		maximumFractionDigits : digits,
+		style : 'currency'
+	};
+
+	if( display === 'parts' ){
+
+		options.currencyDisplay = 'narrowSymbol';
+
+		const parts = new Intl.NumberFormat( resolvedLocale, options ).formatToParts( value );
+
+		const symbol = parts.find( ( p ) => p.type === 'currency' )?.value || '';
+		const number = parts
+			.filter( ( p ) => p.type !== 'currency' && p.type !== 'literal' )
+			.map( ( p ) => p.value )
+			.join( '' );
+
+		return symbol + number + ' ' + code;
+
+	}
+	return new Intl.NumberFormat( resolvedLocale, options ).format( value );
+
+};
+
+const formatDateString = ({
+	date,
+	locale,
+	options = {
+		day : 'numeric',
+		month : 'long',
+		weekday : 'long',
+		year : 'numeric'
+	}
+}) => {
+
+	return new Date( date ).toLocaleDateString(
+		locale,
+		options
+	);
+
+};
+
+const formatNumber = (
+	number,
+	digits = 0
+) => {
+
+	return Number( number ).toLocaleString( 'en', {
+		minimumFractionDigits : digits,
+		maximumFractionDigits : digits
+	});
+
+};
+
+const getPlanFeature = ( plan, key ) => {
+
+	const error = ( plan?.features?.denied || {} )?.[ key ];
+	const feature = ( plan?.features?.granted || {} )?.[ key ];
+	const granted = Boolean( feature );
+
+	return {
+		granted,
+		message : granted ? feature : error
+	};
+
+};
+
+const regex = {
+	url : /^(https:\/\/)/,
+	protocols : /^(https?:\/\/)?(www\.)?/
+};
+
+const shareUrls = ({
+	formUri,
+	organization,
+	page
+}) => {
+
+	const preface = urlRoot( formUri );
+	const base = formUri;
+
+	const qr = preface + base?.replace( preface, '' ) + '/' + page?.shortId + '?qr=1';
+	const short = preface + base?.replace( preface, '' ) + '/' + page?.shortId;
+	const url = preface + organization?.subdomain + '.' + base?.replace( preface, '' ) + '/' + page?.slug;
+
+	const clients = [
+		base,
+		qr,
+		short,
+		url
+	];
+
+	const urls = {
+		qr,
+		short,
+		url
+	};
+
+	if( organization?.subdomain && page?.shortId ){
+
+		clients.push( preface + base?.replace( preface, '' ) + '/' + page?.shortId );
+		clients.push( preface + base?.replace( preface, '' ) + '/' + page?.shortId + '?qr=1' );
+		clients.push( preface + organization.subdomain + '.' + base?.replace( preface, '' ) );
+		clients.push( preface + organization.subdomain + '.' + base?.replace( preface, '' ) + '/' + page?.shortId );
+
+	}
+	if( organization?.shortId && page?.slug && page?.shortId ){
+
+		clients.push( preface + organization.shortId + '.' + base?.replace( preface, '' ) );
+		clients.push( preface + organization.shortId + '.' + base?.replace( preface, '' ) + '/' + page?.slug );
+		clients.push( preface + organization.shortId + '.' + base?.replace( preface, '' ) + '/' + page?.shortId );
+
+	}
+	return {
+		clients,
+		urls
+	};
+
+};
+
+module.exports = {
+	capitalize,
+	formatCurrency,
+	formatDateString,
+	formatNumber,
+	getPlanFeature,
+	gigabyte,
+	infinite,
+	isInfinite,
+	megabyte,
+	regex,
+	shareUrls,
+	urlRoot
+};

package/dist/index.d.ts

@@ -0,0 +1,163 @@
+const infinite = 1e300;
+
+const isInfinite = ( value ) => value === infinite;
+
+const megabyte = ( 1024 * 1024 );
+const gigabyte = ( megabyte * 1024 );
+
+const urlRoot = ( string ) => ( string?.includes( 'https' ) ? 'https://' : 'http://' );
+
+const capitalize = ( string ) => {
+
+	return string?.charAt( 0 )?.toUpperCase() + string?.slice( 1 );
+
+};
+
+const formatCurrency = ({
+	code = 'USD',
+	digits = 2,
+	display = 'standard',
+	locale,
+	value = 0
+}) => {
+
+	const resolvedLocale = locale
+		|| ( typeof navigator !== 'undefined' ? navigator?.language : null )
+		|| 'en-US';
+
+	const options = {
+		currency : code,
+		minimumFractionDigits : digits,
+		maximumFractionDigits : digits,
+		style : 'currency'
+	};
+
+	if( display === 'parts' ){
+
+		options.currencyDisplay = 'narrowSymbol';
+
+		const parts = new Intl.NumberFormat( resolvedLocale, options ).formatToParts( value );
+
+		const symbol = parts.find( ( p ) => p.type === 'currency' )?.value || '';
+		const number = parts
+			.filter( ( p ) => p.type !== 'currency' && p.type !== 'literal' )
+			.map( ( p ) => p.value )
+			.join( '' );
+
+		return symbol + number + ' ' + code;
+
+	}
+	return new Intl.NumberFormat( resolvedLocale, options ).format( value );
+
+};
+
+const formatDateString = ({
+	date,
+	locale,
+	options = {
+		day : 'numeric',
+		month : 'long',
+		weekday : 'long',
+		year : 'numeric'
+	}
+}) => {
+
+	return new Date( date ).toLocaleDateString(
+		locale,
+		options
+	);
+
+};
+
+const formatNumber = (
+	number,
+	digits = 0
+) => {
+
+	return Number( number ).toLocaleString( 'en', {
+		minimumFractionDigits : digits,
+		maximumFractionDigits : digits
+	});
+
+};
+
+const getPlanFeature = ( plan, key ) => {
+
+	const error = ( plan?.features?.denied || {} )?.[ key ];
+	const feature = ( plan?.features?.granted || {} )?.[ key ];
+	const granted = Boolean( feature );
+
+	return {
+		granted,
+		message : granted ? feature : error
+	};
+
+};
+
+const regex = {
+	url : /^(https:\/\/)/,
+	protocols : /^(https?:\/\/)?(www\.)?/
+};
+
+const shareUrls = ({
+	formUri,
+	organization,
+	page
+}) => {
+
+	const preface = urlRoot( formUri );
+	const base = formUri;
+
+	const qr = preface + base?.replace( preface, '' ) + '/' + page?.shortId + '?qr=1';
+	const short = preface + base?.replace( preface, '' ) + '/' + page?.shortId;
+	const url = preface + organization?.subdomain + '.' + base?.replace( preface, '' ) + '/' + page?.slug;
+
+	const clients = [
+		base,
+		qr,
+		short,
+		url
+	];
+
+	const urls = {
+		qr,
+		short,
+		url
+	};
+
+	if( organization?.subdomain && page?.shortId ){
+
+		clients.push( preface + base?.replace( preface, '' ) + '/' + page?.shortId );
+		clients.push( preface + base?.replace( preface, '' ) + '/' + page?.shortId + '?qr=1' );
+		clients.push( preface + organization.subdomain + '.' + base?.replace( preface, '' ) );
+		clients.push( preface + organization.subdomain + '.' + base?.replace( preface, '' ) + '/' + page?.shortId );
+
+	}
+	if( organization?.shortId && page?.slug && page?.shortId ){
+
+		clients.push( preface + organization.shortId + '.' + base?.replace( preface, '' ) );
+		clients.push( preface + organization.shortId + '.' + base?.replace( preface, '' ) + '/' + page?.slug );
+		clients.push( preface + organization.shortId + '.' + base?.replace( preface, '' ) + '/' + page?.shortId );
+
+	}
+	return {
+		clients,
+		urls
+	};
+
+};
+
+module.exports = {
+	capitalize,
+	formatCurrency,
+	formatDateString,
+	formatNumber,
+	getPlanFeature,
+	gigabyte,
+	infinite,
+	isInfinite,
+	megabyte,
+	regex,
+	shareUrls,
+	urlRoot
+};

package/dist/index.js

@@ -0,0 +1,123 @@
+// index.js
+var infinite = 1e300;
+var isInfinite = (value) => value === infinite;
+var megabyte = 1024 * 1024;
+var gigabyte = megabyte * 1024;
+var urlRoot = (string) => (string == null ? void 0 : string.includes("https")) ? "https://" : "http://";
+var capitalize = (string) => {
+  var _a;
+  return ((_a = string == null ? void 0 : string.charAt(0)) == null ? void 0 : _a.toUpperCase()) + (string == null ? void 0 : string.slice(1));
+};
+var formatCurrency = ({
+  code = "USD",
+  digits = 2,
+  display = "standard",
+  locale,
+  value = 0
+}) => {
+  var _a;
+  const resolvedLocale = locale || (typeof navigator !== "undefined" ? navigator == null ? void 0 : navigator.language : null) || "en-US";
+  const options = {
+    currency: code,
+    minimumFractionDigits: digits,
+    maximumFractionDigits: digits,
+    style: "currency"
+  };
+  if (display === "parts") {
+    options.currencyDisplay = "narrowSymbol";
+    const parts = new Intl.NumberFormat(resolvedLocale, options).formatToParts(value);
+    const symbol = ((_a = parts.find((p) => p.type === "currency")) == null ? void 0 : _a.value) || "";
+    const number = parts.filter((p) => p.type !== "currency" && p.type !== "literal").map((p) => p.value).join("");
+    return symbol + number + " " + code;
+  }
+  ;
+  return new Intl.NumberFormat(resolvedLocale, options).format(value);
+};
+var formatDateString = ({
+  date,
+  locale,
+  options = {
+    day: "numeric",
+    month: "long",
+    weekday: "long",
+    year: "numeric"
+  }
+}) => {
+  return new Date(date).toLocaleDateString(
+    locale,
+    options
+  );
+};
+var formatNumber = (number, digits = 0) => {
+  return Number(number).toLocaleString("en", {
+    minimumFractionDigits: digits,
+    maximumFractionDigits: digits
+  });
+};
+var getPlanFeature = (plan, key) => {
+  var _a, _b, _c, _d;
+  const error = (_b = ((_a = plan == null ? void 0 : plan.features) == null ? void 0 : _a.denied) || {}) == null ? void 0 : _b[key];
+  const feature = (_d = ((_c = plan == null ? void 0 : plan.features) == null ? void 0 : _c.granted) || {}) == null ? void 0 : _d[key];
+  const granted = Boolean(feature);
+  return {
+    granted,
+    message: granted ? feature : error
+  };
+};
+var regex = {
+  url: /^(https:\/\/)/,
+  protocols: /^(https?:\/\/)?(www\.)?/
+};
+var shareUrls = ({
+  formUri,
+  organization,
+  page
+}) => {
+  const preface = urlRoot(formUri);
+  const base = formUri;
+  const qr = preface + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.shortId) + "?qr=1";
+  const short = preface + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.shortId);
+  const url = preface + (organization == null ? void 0 : organization.subdomain) + "." + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.slug);
+  const clients = [
+    base,
+    qr,
+    short,
+    url
+  ];
+  const urls = {
+    qr,
+    short,
+    url
+  };
+  if ((organization == null ? void 0 : organization.subdomain) && (page == null ? void 0 : page.shortId)) {
+    clients.push(preface + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.shortId));
+    clients.push(preface + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.shortId) + "?qr=1");
+    clients.push(preface + organization.subdomain + "." + (base == null ? void 0 : base.replace(preface, "")));
+    clients.push(preface + organization.subdomain + "." + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.shortId));
+  }
+  ;
+  if ((organization == null ? void 0 : organization.shortId) && (page == null ? void 0 : page.slug) && (page == null ? void 0 : page.shortId)) {
+    clients.push(preface + organization.shortId + "." + (base == null ? void 0 : base.replace(preface, "")));
+    clients.push(preface + organization.shortId + "." + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.slug));
+    clients.push(preface + organization.shortId + "." + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.shortId));
+  }
+  ;
+  return {
+    clients,
+    urls
+  };
+};
+module.exports = {
+  capitalize,
+  formatCurrency,
+  formatDateString,
+  formatNumber,
+  getPlanFeature,
+  gigabyte,
+  infinite,
+  isInfinite,
+  megabyte,
+  regex,
+  shareUrls,
+  urlRoot
+};

package/dist/index.mjs

@@ -0,0 +1,133 @@
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+
+// index.js
+var require_index = __commonJS({
+  "index.js"(exports, module) {
+    var infinite = 1e300;
+    var isInfinite = (value) => value === infinite;
+    var megabyte = 1024 * 1024;
+    var gigabyte = megabyte * 1024;
+    var urlRoot = (string) => (string == null ? void 0 : string.includes("https")) ? "https://" : "http://";
+    var capitalize = (string) => {
+      var _a;
+      return ((_a = string == null ? void 0 : string.charAt(0)) == null ? void 0 : _a.toUpperCase()) + (string == null ? void 0 : string.slice(1));
+    };
+    var formatCurrency = ({
+      code = "USD",
+      digits = 2,
+      display = "standard",
+      locale,
+      value = 0
+    }) => {
+      var _a;
+      const resolvedLocale = locale || (typeof navigator !== "undefined" ? navigator == null ? void 0 : navigator.language : null) || "en-US";
+      const options = {
+        currency: code,
+        minimumFractionDigits: digits,
+        maximumFractionDigits: digits,
+        style: "currency"
+      };
+      if (display === "parts") {
+        options.currencyDisplay = "narrowSymbol";
+        const parts = new Intl.NumberFormat(resolvedLocale, options).formatToParts(value);
+        const symbol = ((_a = parts.find((p) => p.type === "currency")) == null ? void 0 : _a.value) || "";
+        const number = parts.filter((p) => p.type !== "currency" && p.type !== "literal").map((p) => p.value).join("");
+        return symbol + number + " " + code;
+      }
+      ;
+      return new Intl.NumberFormat(resolvedLocale, options).format(value);
+    };
+    var formatDateString = ({
+      date,
+      locale,
+      options = {
+        day: "numeric",
+        month: "long",
+        weekday: "long",
+        year: "numeric"
+      }
+    }) => {
+      return new Date(date).toLocaleDateString(
+        locale,
+        options
+      );
+    };
+    var formatNumber = (number, digits = 0) => {
+      return Number(number).toLocaleString("en", {
+        minimumFractionDigits: digits,
+        maximumFractionDigits: digits
+      });
+    };
+    var getPlanFeature = (plan, key) => {
+      var _a, _b, _c, _d;
+      const error = (_b = ((_a = plan == null ? void 0 : plan.features) == null ? void 0 : _a.denied) || {}) == null ? void 0 : _b[key];
+      const feature = (_d = ((_c = plan == null ? void 0 : plan.features) == null ? void 0 : _c.granted) || {}) == null ? void 0 : _d[key];
+      const granted = Boolean(feature);
+      return {
+        granted,
+        message: granted ? feature : error
+      };
+    };
+    var regex = {
+      url: /^(https:\/\/)/,
+      protocols: /^(https?:\/\/)?(www\.)?/
+    };
+    var shareUrls = ({
+      formUri,
+      organization,
+      page
+    }) => {
+      const preface = urlRoot(formUri);
+      const base = formUri;
+      const qr = preface + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.shortId) + "?qr=1";
+      const short = preface + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.shortId);
+      const url = preface + (organization == null ? void 0 : organization.subdomain) + "." + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.slug);
+      const clients = [
+        base,
+        qr,
+        short,
+        url
+      ];
+      const urls = {
+        qr,
+        short,
+        url
+      };
+      if ((organization == null ? void 0 : organization.subdomain) && (page == null ? void 0 : page.shortId)) {
+        clients.push(preface + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.shortId));
+        clients.push(preface + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.shortId) + "?qr=1");
+        clients.push(preface + organization.subdomain + "." + (base == null ? void 0 : base.replace(preface, "")));
+        clients.push(preface + organization.subdomain + "." + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.shortId));
+      }
+      ;
+      if ((organization == null ? void 0 : organization.shortId) && (page == null ? void 0 : page.slug) && (page == null ? void 0 : page.shortId)) {
+        clients.push(preface + organization.shortId + "." + (base == null ? void 0 : base.replace(preface, "")));
+        clients.push(preface + organization.shortId + "." + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.slug));
+        clients.push(preface + organization.shortId + "." + (base == null ? void 0 : base.replace(preface, "")) + "/" + (page == null ? void 0 : page.shortId));
+      }
+      ;
+      return {
+        clients,
+        urls
+      };
+    };
+    module.exports = {
+      capitalize,
+      formatCurrency,
+      formatDateString,
+      formatNumber,
+      getPlanFeature,
+      gigabyte,
+      infinite,
+      isInfinite,
+      megabyte,
+      regex,
+      shareUrls,
+      urlRoot
+    };
+  }
+});
+export default require_index();

package/package.json

@@ -0,0 +1,28 @@
+{
+  "dependencies": {
+    "tsup": "8.5.1",
+    "typescript": "5.9.3"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "ISC",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "name": "@drawbridge/drawbridge-utils",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup ./index.js && npm publish"
+  },
+  "types": "dist/index.d.ts",
+  "version": "0.0.1"
+}