@drawbridge/drawbridge-utils 0.0.90 → 0.0.92

package/dist/plans.cjs

@@ -423,8 +423,8 @@ var plans = {
   }
 };
 var conversionRate = (subscription) => {
-  var _a;
-  return (subscription == null ? void 0 : subscription.conversion) ?? ((_a = plans[subscription == null ? void 0 : subscription.plan]) == null ? void 0 : _a.conversion) ?? free.conversion;
+  var _a, _b;
+  return ((_a = subscription == null ? void 0 : subscription.overrides) == null ? void 0 : _a.conversion) ?? (subscription == null ? void 0 : subscription.conversion) ?? ((_b = plans[subscription == null ? void 0 : subscription.plan]) == null ? void 0 : _b.conversion) ?? free.conversion;
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/plans.d.cts

@@ -196,11 +196,14 @@ const plans = {
 };
 
 // Resolve the conversion-fee percentage for an order's owning org.
-// Precedence: explicit per-subscription override (admin/negotiated) →
-// the plan's catalog default → the free-org rate. `subscription` is null
-// for free orgs (they have no subscription doc).
+// Precedence: explicit per-subscription override (admin/negotiated) in
+// subscription.overrides → the legacy top-level field (pre-migration docs;
+// remove after the overrides cleanup release) → the plan's catalog default →
+// the free-org rate. `??` throughout — a stored 0 is a valid 0% override.
+// `subscription` is null for free orgs (they have no subscription doc).
 const conversionRate = ( subscription ) =>
-	subscription?.conversion
+	subscription?.overrides?.conversion
+	?? subscription?.conversion
 	?? plans[ subscription?.plan ]?.conversion
 	?? free.conversion;
 

package/dist/plans.d.ts

@@ -196,11 +196,14 @@ const plans = {
 };
 
 // Resolve the conversion-fee percentage for an order's owning org.
-// Precedence: explicit per-subscription override (admin/negotiated) →
-// the plan's catalog default → the free-org rate. `subscription` is null
-// for free orgs (they have no subscription doc).
+// Precedence: explicit per-subscription override (admin/negotiated) in
+// subscription.overrides → the legacy top-level field (pre-migration docs;
+// remove after the overrides cleanup release) → the plan's catalog default →
+// the free-org rate. `??` throughout — a stored 0 is a valid 0% override.
+// `subscription` is null for free orgs (they have no subscription doc).
 const conversionRate = ( subscription ) =>
-	subscription?.conversion
+	subscription?.overrides?.conversion
+	?? subscription?.conversion
 	?? plans[ subscription?.plan ]?.conversion
 	?? free.conversion;
 

package/dist/plans.js

@@ -386,8 +386,8 @@ var plans = {
   }
 };
 var conversionRate = (subscription) => {
-  var _a;
-  return (subscription == null ? void 0 : subscription.conversion) ?? ((_a = plans[subscription == null ? void 0 : subscription.plan]) == null ? void 0 : _a.conversion) ?? free.conversion;
+  var _a, _b;
+  return ((_a = subscription == null ? void 0 : subscription.overrides) == null ? void 0 : _a.conversion) ?? (subscription == null ? void 0 : subscription.conversion) ?? ((_b = plans[subscription == null ? void 0 : subscription.plan]) == null ? void 0 : _b.conversion) ?? free.conversion;
 };
 export {
   conversionRate,

package/dist/social.cjs

@@ -0,0 +1,158 @@
+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);
+
+// lib/social.js
+var social_exports = {};
+__export(social_exports, {
+  matchSocial: () => matchSocial,
+  platforms: () => platforms
+});
+module.exports = __toCommonJS(social_exports);
+var segment = /^\/.+/;
+var platforms = [
+  {
+    platform: "instagram",
+    label: "Instagram",
+    hosts: ["instagram.com"],
+    requirePath: true,
+    // content permalinks, not profiles
+    exclude: /^\/(p|reel|reels|stories|explore)(\/|$)/
+  },
+  {
+    platform: "facebook",
+    label: "Facebook",
+    hosts: ["facebook.com", "fb.com"],
+    requirePath: true,
+    exclude: /^\/(sharer|share|dialog|plugins)(\/|\.|$)/
+  },
+  {
+    platform: "tiktok",
+    label: "TikTok",
+    hosts: ["tiktok.com"],
+    path: /^\/@./
+  },
+  {
+    platform: "youtube",
+    label: "YouTube",
+    hosts: [
+      { host: "youtube.com", path: /^\/(@.|channel\/|c\/|user\/)/ },
+      { host: "youtu.be", requirePath: true }
+    ]
+  },
+  {
+    platform: "x",
+    label: "X",
+    hosts: ["x.com", "twitter.com"],
+    requirePath: true,
+    exclude: /^\/(intent|share)(\/|$)/
+  },
+  {
+    platform: "linkedin",
+    label: "LinkedIn",
+    hosts: ["linkedin.com"],
+    path: /^\/(company|in)\/./
+  },
+  {
+    platform: "pinterest",
+    label: "Pinterest",
+    hosts: ["pinterest.com"],
+    requirePath: true,
+    exclude: /^\/pin(\/|$)/
+  },
+  {
+    platform: "threads",
+    label: "Threads",
+    hosts: ["threads.net", "threads.com"],
+    path: /^\/@./
+  },
+  {
+    platform: "snapchat",
+    label: "Snapchat",
+    hosts: ["snapchat.com"],
+    path: /^\/add\/./
+  },
+  {
+    platform: "whatsapp",
+    label: "WhatsApp",
+    hosts: [
+      { host: "wa.me", requirePath: true },
+      { host: "api.whatsapp.com", path: /^\/send/ }
+    ]
+  },
+  {
+    platform: "spotify",
+    label: "Spotify",
+    hosts: ["open.spotify.com"],
+    path: /^\/(artist|show|user|playlist)\/./
+  },
+  {
+    platform: "discord",
+    label: "Discord",
+    hosts: [
+      { host: "discord.gg", requirePath: true },
+      { host: "discord.com", path: /^\/invite\/./ }
+    ]
+  },
+  {
+    platform: "twitch",
+    label: "Twitch",
+    hosts: ["twitch.tv"],
+    requirePath: true,
+    exclude: /^\/(videos|directory)(\/|$)/
+  },
+  {
+    platform: "github",
+    label: "GitHub",
+    hosts: ["github.com"],
+    requirePath: true
+  }
+];
+var matchSocial = (url) => {
+  if (!url || typeof url !== "string") return null;
+  let parsed;
+  try {
+    parsed = new URL(url.includes("://") ? url : "https://" + url.replace(/^\/+/, ""));
+  } catch {
+    return null;
+  }
+  ;
+  if (!/^https?:$/.test(parsed.protocol)) return null;
+  const host = parsed.hostname.toLowerCase().replace(/^(www|m)\./, "");
+  const path = parsed.pathname.replace(/\/+$/, "") || "/";
+  for (const entry of platforms) {
+    const matched = entry.hosts.map((h) => typeof h === "string" ? { host: h } : h).find((h) => host === h.host || host.endsWith("." + h.host));
+    if (!matched) continue;
+    const exclude = matched.exclude || entry.exclude;
+    const pattern = matched.path || entry.path;
+    const requirePath = matched.requirePath ?? entry.requirePath;
+    if (exclude && exclude.test(path)) return null;
+    if (pattern && !pattern.test(path)) return null;
+    if (requirePath && !segment.test(path)) return null;
+    return {
+      label: entry.label,
+      platform: entry.platform
+    };
+  }
+  ;
+  return null;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  matchSocial,
+  platforms
+});

package/dist/social.d.cts

@@ -0,0 +1,163 @@
+// Social platform detection — the single source of truth for the platform-slug
+// vocabulary shared across the family: sync writes link.icon from it during AI
+// campaign generation, app-web derives the link form's live icon preview and
+// the icon persisted on save, and @drawbridge/components keys its social glyph
+// map on the same slugs. Adding a platform = one entry here + one glyph there.
+//
+// Order is load-bearing: it is the canonical display order for auto-created
+// social links on the share page.
+
+const segment = /^\/.+/;
+
+const platforms = [
+	{
+		platform : 'instagram',
+		label : 'Instagram',
+		hosts : [ 'instagram.com' ],
+		requirePath : true,
+		// content permalinks, not profiles
+		exclude : /^\/(p|reel|reels|stories|explore)(\/|$)/
+	},
+	{
+		platform : 'facebook',
+		label : 'Facebook',
+		hosts : [ 'facebook.com', 'fb.com' ],
+		requirePath : true,
+		exclude : /^\/(sharer|share|dialog|plugins)(\/|\.|$)/
+	},
+	{
+		platform : 'tiktok',
+		label : 'TikTok',
+		hosts : [ 'tiktok.com' ],
+		path : /^\/@./
+	},
+	{
+		platform : 'youtube',
+		label : 'YouTube',
+		hosts : [
+			{ host : 'youtube.com', path : /^\/(@.|channel\/|c\/|user\/)/ },
+			{ host : 'youtu.be', requirePath : true }
+		]
+	},
+	{
+		platform : 'x',
+		label : 'X',
+		hosts : [ 'x.com', 'twitter.com' ],
+		requirePath : true,
+		exclude : /^\/(intent|share)(\/|$)/
+	},
+	{
+		platform : 'linkedin',
+		label : 'LinkedIn',
+		hosts : [ 'linkedin.com' ],
+		path : /^\/(company|in)\/./
+	},
+	{
+		platform : 'pinterest',
+		label : 'Pinterest',
+		hosts : [ 'pinterest.com' ],
+		requirePath : true,
+		exclude : /^\/pin(\/|$)/
+	},
+	{
+		platform : 'threads',
+		label : 'Threads',
+		hosts : [ 'threads.net', 'threads.com' ],
+		path : /^\/@./
+	},
+	{
+		platform : 'snapchat',
+		label : 'Snapchat',
+		hosts : [ 'snapchat.com' ],
+		path : /^\/add\/./
+	},
+	{
+		platform : 'whatsapp',
+		label : 'WhatsApp',
+		hosts : [
+			{ host : 'wa.me', requirePath : true },
+			{ host : 'api.whatsapp.com', path : /^\/send/ }
+		]
+	},
+	{
+		platform : 'spotify',
+		label : 'Spotify',
+		hosts : [ 'open.spotify.com' ],
+		path : /^\/(artist|show|user|playlist)\/./
+	},
+	{
+		platform : 'discord',
+		label : 'Discord',
+		hosts : [
+			{ host : 'discord.gg', requirePath : true },
+			{ host : 'discord.com', path : /^\/invite\/./ }
+		]
+	},
+	{
+		platform : 'twitch',
+		label : 'Twitch',
+		hosts : [ 'twitch.tv' ],
+		requirePath : true,
+		exclude : /^\/(videos|directory)(\/|$)/
+	},
+	{
+		platform : 'github',
+		label : 'GitHub',
+		hosts : [ 'github.com' ],
+		requirePath : true
+	}
+];
+
+// Match a url against the platform table. Tolerates missing schemes and
+// www./m. subdomains; keystroke-safe (never throws) so app-web can call it
+// on every url-field change. Returns { platform, label } or null.
+const matchSocial = ( url ) => {
+
+	if( ! url || typeof url !== 'string' ) return null;
+
+	let parsed;
+
+	try {
+
+		parsed = new URL( url.includes( '://' ) ? url : 'https://' + url.replace( /^\/+/, '' ) );
+
+	} catch {
+
+		return null;
+
+	}
+	if( ! /^https?:$/.test( parsed.protocol ) ) return null;
+
+	const host = parsed.hostname.toLowerCase().replace( /^(www|m)\./, '' );
+	const path = parsed.pathname.replace( /\/+$/, '' ) || '/';
+
+	for( const entry of platforms ){
+
+		const matched = entry.hosts
+			.map( ( h ) => ( typeof h === 'string' ? { host : h } : h ) )
+			.find( ( h ) => host === h.host || host.endsWith( '.' + h.host ) );
+
+		if( ! matched ) continue;
+
+		// per-host rules override the platform-level ones (discord.gg/<invite>
+		// vs discord.com/invite/<invite>); a host match that fails its path
+		// rules is terminal — no other platform owns this host
+		const exclude = matched.exclude || entry.exclude;
+		const pattern = matched.path || entry.path;
+		const requirePath = matched.requirePath ?? entry.requirePath;
+
+		if( exclude && exclude.test( path ) ) return null;
+		if( pattern && ! pattern.test( path ) ) return null;
+		if( requirePath && ! segment.test( path ) ) return null;
+
+		return {
+			label : entry.label,
+			platform : entry.platform
+		};
+
+	}
+	return null;
+
+};
+
+export { matchSocial, platforms };

package/dist/social.d.ts

@@ -0,0 +1,163 @@
+// Social platform detection — the single source of truth for the platform-slug
+// vocabulary shared across the family: sync writes link.icon from it during AI
+// campaign generation, app-web derives the link form's live icon preview and
+// the icon persisted on save, and @drawbridge/components keys its social glyph
+// map on the same slugs. Adding a platform = one entry here + one glyph there.
+//
+// Order is load-bearing: it is the canonical display order for auto-created
+// social links on the share page.
+
+const segment = /^\/.+/;
+
+const platforms = [
+	{
+		platform : 'instagram',
+		label : 'Instagram',
+		hosts : [ 'instagram.com' ],
+		requirePath : true,
+		// content permalinks, not profiles
+		exclude : /^\/(p|reel|reels|stories|explore)(\/|$)/
+	},
+	{
+		platform : 'facebook',
+		label : 'Facebook',
+		hosts : [ 'facebook.com', 'fb.com' ],
+		requirePath : true,
+		exclude : /^\/(sharer|share|dialog|plugins)(\/|\.|$)/
+	},
+	{
+		platform : 'tiktok',
+		label : 'TikTok',
+		hosts : [ 'tiktok.com' ],
+		path : /^\/@./
+	},
+	{
+		platform : 'youtube',
+		label : 'YouTube',
+		hosts : [
+			{ host : 'youtube.com', path : /^\/(@.|channel\/|c\/|user\/)/ },
+			{ host : 'youtu.be', requirePath : true }
+		]
+	},
+	{
+		platform : 'x',
+		label : 'X',
+		hosts : [ 'x.com', 'twitter.com' ],
+		requirePath : true,
+		exclude : /^\/(intent|share)(\/|$)/
+	},
+	{
+		platform : 'linkedin',
+		label : 'LinkedIn',
+		hosts : [ 'linkedin.com' ],
+		path : /^\/(company|in)\/./
+	},
+	{
+		platform : 'pinterest',
+		label : 'Pinterest',
+		hosts : [ 'pinterest.com' ],
+		requirePath : true,
+		exclude : /^\/pin(\/|$)/
+	},
+	{
+		platform : 'threads',
+		label : 'Threads',
+		hosts : [ 'threads.net', 'threads.com' ],
+		path : /^\/@./
+	},
+	{
+		platform : 'snapchat',
+		label : 'Snapchat',
+		hosts : [ 'snapchat.com' ],
+		path : /^\/add\/./
+	},
+	{
+		platform : 'whatsapp',
+		label : 'WhatsApp',
+		hosts : [
+			{ host : 'wa.me', requirePath : true },
+			{ host : 'api.whatsapp.com', path : /^\/send/ }
+		]
+	},
+	{
+		platform : 'spotify',
+		label : 'Spotify',
+		hosts : [ 'open.spotify.com' ],
+		path : /^\/(artist|show|user|playlist)\/./
+	},
+	{
+		platform : 'discord',
+		label : 'Discord',
+		hosts : [
+			{ host : 'discord.gg', requirePath : true },
+			{ host : 'discord.com', path : /^\/invite\/./ }
+		]
+	},
+	{
+		platform : 'twitch',
+		label : 'Twitch',
+		hosts : [ 'twitch.tv' ],
+		requirePath : true,
+		exclude : /^\/(videos|directory)(\/|$)/
+	},
+	{
+		platform : 'github',
+		label : 'GitHub',
+		hosts : [ 'github.com' ],
+		requirePath : true
+	}
+];
+
+// Match a url against the platform table. Tolerates missing schemes and
+// www./m. subdomains; keystroke-safe (never throws) so app-web can call it
+// on every url-field change. Returns { platform, label } or null.
+const matchSocial = ( url ) => {
+
+	if( ! url || typeof url !== 'string' ) return null;
+
+	let parsed;
+
+	try {
+
+		parsed = new URL( url.includes( '://' ) ? url : 'https://' + url.replace( /^\/+/, '' ) );
+
+	} catch {
+
+		return null;
+
+	}
+	if( ! /^https?:$/.test( parsed.protocol ) ) return null;
+
+	const host = parsed.hostname.toLowerCase().replace( /^(www|m)\./, '' );
+	const path = parsed.pathname.replace( /\/+$/, '' ) || '/';
+
+	for( const entry of platforms ){
+
+		const matched = entry.hosts
+			.map( ( h ) => ( typeof h === 'string' ? { host : h } : h ) )
+			.find( ( h ) => host === h.host || host.endsWith( '.' + h.host ) );
+
+		if( ! matched ) continue;
+
+		// per-host rules override the platform-level ones (discord.gg/<invite>
+		// vs discord.com/invite/<invite>); a host match that fails its path
+		// rules is terminal — no other platform owns this host
+		const exclude = matched.exclude || entry.exclude;
+		const pattern = matched.path || entry.path;
+		const requirePath = matched.requirePath ?? entry.requirePath;
+
+		if( exclude && exclude.test( path ) ) return null;
+		if( pattern && ! pattern.test( path ) ) return null;
+		if( requirePath && ! segment.test( path ) ) return null;
+
+		return {
+			label : entry.label,
+			platform : entry.platform
+		};
+
+	}
+	return null;
+
+};
+
+export { matchSocial, platforms };

package/dist/social.js

@@ -0,0 +1,133 @@
+// lib/social.js
+var segment = /^\/.+/;
+var platforms = [
+  {
+    platform: "instagram",
+    label: "Instagram",
+    hosts: ["instagram.com"],
+    requirePath: true,
+    // content permalinks, not profiles
+    exclude: /^\/(p|reel|reels|stories|explore)(\/|$)/
+  },
+  {
+    platform: "facebook",
+    label: "Facebook",
+    hosts: ["facebook.com", "fb.com"],
+    requirePath: true,
+    exclude: /^\/(sharer|share|dialog|plugins)(\/|\.|$)/
+  },
+  {
+    platform: "tiktok",
+    label: "TikTok",
+    hosts: ["tiktok.com"],
+    path: /^\/@./
+  },
+  {
+    platform: "youtube",
+    label: "YouTube",
+    hosts: [
+      { host: "youtube.com", path: /^\/(@.|channel\/|c\/|user\/)/ },
+      { host: "youtu.be", requirePath: true }
+    ]
+  },
+  {
+    platform: "x",
+    label: "X",
+    hosts: ["x.com", "twitter.com"],
+    requirePath: true,
+    exclude: /^\/(intent|share)(\/|$)/
+  },
+  {
+    platform: "linkedin",
+    label: "LinkedIn",
+    hosts: ["linkedin.com"],
+    path: /^\/(company|in)\/./
+  },
+  {
+    platform: "pinterest",
+    label: "Pinterest",
+    hosts: ["pinterest.com"],
+    requirePath: true,
+    exclude: /^\/pin(\/|$)/
+  },
+  {
+    platform: "threads",
+    label: "Threads",
+    hosts: ["threads.net", "threads.com"],
+    path: /^\/@./
+  },
+  {
+    platform: "snapchat",
+    label: "Snapchat",
+    hosts: ["snapchat.com"],
+    path: /^\/add\/./
+  },
+  {
+    platform: "whatsapp",
+    label: "WhatsApp",
+    hosts: [
+      { host: "wa.me", requirePath: true },
+      { host: "api.whatsapp.com", path: /^\/send/ }
+    ]
+  },
+  {
+    platform: "spotify",
+    label: "Spotify",
+    hosts: ["open.spotify.com"],
+    path: /^\/(artist|show|user|playlist)\/./
+  },
+  {
+    platform: "discord",
+    label: "Discord",
+    hosts: [
+      { host: "discord.gg", requirePath: true },
+      { host: "discord.com", path: /^\/invite\/./ }
+    ]
+  },
+  {
+    platform: "twitch",
+    label: "Twitch",
+    hosts: ["twitch.tv"],
+    requirePath: true,
+    exclude: /^\/(videos|directory)(\/|$)/
+  },
+  {
+    platform: "github",
+    label: "GitHub",
+    hosts: ["github.com"],
+    requirePath: true
+  }
+];
+var matchSocial = (url) => {
+  if (!url || typeof url !== "string") return null;
+  let parsed;
+  try {
+    parsed = new URL(url.includes("://") ? url : "https://" + url.replace(/^\/+/, ""));
+  } catch {
+    return null;
+  }
+  ;
+  if (!/^https?:$/.test(parsed.protocol)) return null;
+  const host = parsed.hostname.toLowerCase().replace(/^(www|m)\./, "");
+  const path = parsed.pathname.replace(/\/+$/, "") || "/";
+  for (const entry of platforms) {
+    const matched = entry.hosts.map((h) => typeof h === "string" ? { host: h } : h).find((h) => host === h.host || host.endsWith("." + h.host));
+    if (!matched) continue;
+    const exclude = matched.exclude || entry.exclude;
+    const pattern = matched.path || entry.path;
+    const requirePath = matched.requirePath ?? entry.requirePath;
+    if (exclude && exclude.test(path)) return null;
+    if (pattern && !pattern.test(path)) return null;
+    if (requirePath && !segment.test(path)) return null;
+    return {
+      label: entry.label,
+      platform: entry.platform
+    };
+  }
+  ;
+  return null;
+};
+export {
+  matchSocial,
+  platforms
+};

package/package.json

@@ -13,7 +13,7 @@
     "tinycolor2": "1.6.0"
   },
   "devDependencies": {
-    "@drawbridge/drawbridge-agents": "0.1.24",
+    "@drawbridge/drawbridge-agents": "0.1.28",
     "@node-oauth/oauth2-server": "5.3.0",
     "tsup": "8.5.1",
     "typescript": "5.9.3"
@@ -132,6 +132,11 @@
       "import": "./dist/slugify.js",
       "require": "./dist/slugify.cjs"
     },
+    "./social": {
+      "types": "./dist/social.d.ts",
+      "import": "./dist/social.js",
+      "require": "./dist/social.cjs"
+    },
     "./token": {
       "types": "./dist/token.d.ts",
       "import": "./dist/token.js",
@@ -164,5 +169,5 @@
     "test": ". \"$HOME/.nvm/nvm.sh\" && nvm use && node --test"
   },
   "types": "dist/index.d.ts",
-  "version": "0.0.90"
+  "version": "0.0.92"
 }