@drawbridge/drawbridge-utils 0.0.91 → 0.0.93

package/dist/plans.cjs

@@ -420,6 +420,61 @@ var plans = {
     overages: { actions: "1.5" },
     title: "Elite",
     conversion: 0.5
+  },
+  // Negotiated tier. Unlike the four sellable plans it has NO catalog price:
+  // each enterprise subscription bills from its own Stripe price, minted
+  // under STRIPE_PRODUCT_ENTERPRISE and recorded on items.plan.price.
+  //
+  // That absent price is the whole marker — this entry carries no flag of its
+  // own, deliberately. A plan with no stripePriceId cannot be sold self-serve
+  // because subscribe and change would hand Stripe `price : undefined`, so
+  // "is it selectable" reads straight off the thing that makes it true. Two
+  // flags were considered and dropped: `status : drafted | published` (it
+  // collides with subscription.status and organization.status, which extend.js
+  // attaches to the same payload) and `type : default | custom` (its one real
+  // job — catching a sellable plan whose STRIPE_PRICE_* env went missing — is
+  // already done by assertEnv at api boot). Negotiated-ness is recorded where
+  // it actually varies: subscription.type on the document, set by the admin.
+  //
+  // Every value below is a FALLBACK, not the deal. Real allowances come from
+  // subscription.overrides per customer. They deliberately mirror Elite
+  // rather than being infinite or zero: a half-configured enterprise
+  // subscription then degrades to the best sellable tier — a known-good,
+  // billable state — instead of billing nothing or granting everything.
+  //
+  // Placed LAST so the array-position direction logic in drawbridge-api
+  // (organization-subscription.js `plans.findIndex`) reads a move onto
+  // enterprise as an upgrade and a move off it as a downgrade.
+  DBENTERPRISE: {
+    features: all.features([
+      organization.advertisements.key,
+      organization.analytics.key,
+      organization.members.key,
+      organization.subdomain.key,
+      page.slug.key
+    ]),
+    limits: all.limits({ actions: 1e5, members: infinite, storage: gigabyte * 100 }),
+    marketing: {
+      description: "Negotiated terms tailored to your organization.",
+      features: [
+        "Analytics",
+        "Custom subdomain / URLs",
+        "Confirmation page ads",
+        "Negotiated pricing and limits"
+      ],
+      limits: [
+        ["Actions per month", "Custom"],
+        ["Affiliates", "Unlimited"],
+        ["Brands", "Unlimited"],
+        ["Campaigns", "Unlimited"],
+        ["Pages", "Unlimited"],
+        ["Members", "Custom"],
+        ["Storage", "Custom"]
+      ]
+    },
+    overages: { actions: "1.5" },
+    title: "Enterprise",
+    conversion: 0.5
   }
 };
 var conversionRate = (subscription) => {

package/dist/plans.d.cts

@@ -192,6 +192,62 @@ const plans = {
 		overages : { actions : '1.5' },
 		title : 'Elite',
 		conversion : 0.5
+	},
+
+	// Negotiated tier. Unlike the four sellable plans it has NO catalog price:
+	// each enterprise subscription bills from its own Stripe price, minted
+	// under STRIPE_PRODUCT_ENTERPRISE and recorded on items.plan.price.
+	//
+	// That absent price is the whole marker — this entry carries no flag of its
+	// own, deliberately. A plan with no stripePriceId cannot be sold self-serve
+	// because subscribe and change would hand Stripe `price : undefined`, so
+	// "is it selectable" reads straight off the thing that makes it true. Two
+	// flags were considered and dropped: `status : drafted | published` (it
+	// collides with subscription.status and organization.status, which extend.js
+	// attaches to the same payload) and `type : default | custom` (its one real
+	// job — catching a sellable plan whose STRIPE_PRICE_* env went missing — is
+	// already done by assertEnv at api boot). Negotiated-ness is recorded where
+	// it actually varies: subscription.type on the document, set by the admin.
+	//
+	// Every value below is a FALLBACK, not the deal. Real allowances come from
+	// subscription.overrides per customer. They deliberately mirror Elite
+	// rather than being infinite or zero: a half-configured enterprise
+	// subscription then degrades to the best sellable tier — a known-good,
+	// billable state — instead of billing nothing or granting everything.
+	//
+	// Placed LAST so the array-position direction logic in drawbridge-api
+	// (organization-subscription.js `plans.findIndex`) reads a move onto
+	// enterprise as an upgrade and a move off it as a downgrade.
+	DBENTERPRISE : {
+		features : all.features([
+			organization.advertisements.key,
+			organization.analytics.key,
+			organization.members.key,
+			organization.subdomain.key,
+			page.slug.key
+		]),
+		limits : all.limits({ actions : 100000, members : infinite, storage : gigabyte * 100 }),
+		marketing : {
+			description : 'Negotiated terms tailored to your organization.',
+			features : [
+				'Analytics',
+				'Custom subdomain / URLs',
+				'Confirmation page ads',
+				'Negotiated pricing and limits'
+			],
+			limits : [
+				[ 'Actions per month', 'Custom' ],
+				[ 'Affiliates', 'Unlimited' ],
+				[ 'Brands', 'Unlimited' ],
+				[ 'Campaigns', 'Unlimited' ],
+				[ 'Pages', 'Unlimited' ],
+				[ 'Members', 'Custom' ],
+				[ 'Storage', 'Custom' ]
+			]
+		},
+		overages : { actions : '1.5' },
+		title : 'Enterprise',
+		conversion : 0.5
 	}
 };
 

package/dist/plans.d.ts

@@ -192,6 +192,62 @@ const plans = {
 		overages : { actions : '1.5' },
 		title : 'Elite',
 		conversion : 0.5
+	},
+
+	// Negotiated tier. Unlike the four sellable plans it has NO catalog price:
+	// each enterprise subscription bills from its own Stripe price, minted
+	// under STRIPE_PRODUCT_ENTERPRISE and recorded on items.plan.price.
+	//
+	// That absent price is the whole marker — this entry carries no flag of its
+	// own, deliberately. A plan with no stripePriceId cannot be sold self-serve
+	// because subscribe and change would hand Stripe `price : undefined`, so
+	// "is it selectable" reads straight off the thing that makes it true. Two
+	// flags were considered and dropped: `status : drafted | published` (it
+	// collides with subscription.status and organization.status, which extend.js
+	// attaches to the same payload) and `type : default | custom` (its one real
+	// job — catching a sellable plan whose STRIPE_PRICE_* env went missing — is
+	// already done by assertEnv at api boot). Negotiated-ness is recorded where
+	// it actually varies: subscription.type on the document, set by the admin.
+	//
+	// Every value below is a FALLBACK, not the deal. Real allowances come from
+	// subscription.overrides per customer. They deliberately mirror Elite
+	// rather than being infinite or zero: a half-configured enterprise
+	// subscription then degrades to the best sellable tier — a known-good,
+	// billable state — instead of billing nothing or granting everything.
+	//
+	// Placed LAST so the array-position direction logic in drawbridge-api
+	// (organization-subscription.js `plans.findIndex`) reads a move onto
+	// enterprise as an upgrade and a move off it as a downgrade.
+	DBENTERPRISE : {
+		features : all.features([
+			organization.advertisements.key,
+			organization.analytics.key,
+			organization.members.key,
+			organization.subdomain.key,
+			page.slug.key
+		]),
+		limits : all.limits({ actions : 100000, members : infinite, storage : gigabyte * 100 }),
+		marketing : {
+			description : 'Negotiated terms tailored to your organization.',
+			features : [
+				'Analytics',
+				'Custom subdomain / URLs',
+				'Confirmation page ads',
+				'Negotiated pricing and limits'
+			],
+			limits : [
+				[ 'Actions per month', 'Custom' ],
+				[ 'Affiliates', 'Unlimited' ],
+				[ 'Brands', 'Unlimited' ],
+				[ 'Campaigns', 'Unlimited' ],
+				[ 'Pages', 'Unlimited' ],
+				[ 'Members', 'Custom' ],
+				[ 'Storage', 'Custom' ]
+			]
+		},
+		overages : { actions : '1.5' },
+		title : 'Enterprise',
+		conversion : 0.5
 	}
 };
 

package/dist/plans.js

@@ -383,6 +383,61 @@ var plans = {
     overages: { actions: "1.5" },
     title: "Elite",
     conversion: 0.5
+  },
+  // Negotiated tier. Unlike the four sellable plans it has NO catalog price:
+  // each enterprise subscription bills from its own Stripe price, minted
+  // under STRIPE_PRODUCT_ENTERPRISE and recorded on items.plan.price.
+  //
+  // That absent price is the whole marker — this entry carries no flag of its
+  // own, deliberately. A plan with no stripePriceId cannot be sold self-serve
+  // because subscribe and change would hand Stripe `price : undefined`, so
+  // "is it selectable" reads straight off the thing that makes it true. Two
+  // flags were considered and dropped: `status : drafted | published` (it
+  // collides with subscription.status and organization.status, which extend.js
+  // attaches to the same payload) and `type : default | custom` (its one real
+  // job — catching a sellable plan whose STRIPE_PRICE_* env went missing — is
+  // already done by assertEnv at api boot). Negotiated-ness is recorded where
+  // it actually varies: subscription.type on the document, set by the admin.
+  //
+  // Every value below is a FALLBACK, not the deal. Real allowances come from
+  // subscription.overrides per customer. They deliberately mirror Elite
+  // rather than being infinite or zero: a half-configured enterprise
+  // subscription then degrades to the best sellable tier — a known-good,
+  // billable state — instead of billing nothing or granting everything.
+  //
+  // Placed LAST so the array-position direction logic in drawbridge-api
+  // (organization-subscription.js `plans.findIndex`) reads a move onto
+  // enterprise as an upgrade and a move off it as a downgrade.
+  DBENTERPRISE: {
+    features: all.features([
+      organization.advertisements.key,
+      organization.analytics.key,
+      organization.members.key,
+      organization.subdomain.key,
+      page.slug.key
+    ]),
+    limits: all.limits({ actions: 1e5, members: infinite, storage: gigabyte * 100 }),
+    marketing: {
+      description: "Negotiated terms tailored to your organization.",
+      features: [
+        "Analytics",
+        "Custom subdomain / URLs",
+        "Confirmation page ads",
+        "Negotiated pricing and limits"
+      ],
+      limits: [
+        ["Actions per month", "Custom"],
+        ["Affiliates", "Unlimited"],
+        ["Brands", "Unlimited"],
+        ["Campaigns", "Unlimited"],
+        ["Pages", "Unlimited"],
+        ["Members", "Custom"],
+        ["Storage", "Custom"]
+      ]
+    },
+    overages: { actions: "1.5" },
+    title: "Enterprise",
+    conversion: 0.5
   }
 };
 var conversionRate = (subscription) => {

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

@@ -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.91"
+  "version": "0.0.93"
 }