From 7e998b0509ed035f02256c9e639e49c726d2658d Mon Sep 17 00:00:00 2001
From: Amrendra Vikram Singh
 <76041208+AmrendraTheCoder@users.noreply.github.com>
Date: Sat, 15 Aug 2026 03:52:23 +0530
Subject: [PATCH 1/2] fix(pkg): make the package importable from ESM and
 CommonJS

The published package could not be consumed from either module system.
package.json declares "type": "module", so every .js file in src/ is
treated as an ES module. The only export machinery in
src/social-share-button.js is a guarded `module.exports` block, and in an
ES module `module` is undefined, so that block never runs. There is no
`export` statement in the file either, so the module ends up with zero
exports. Only the `window.SocialShareButton` assignment survives, which is
why the CDN script tag path worked and the npm path did not.
src/social-share-analytics.js had the same latent problem.

The code in src/ is already written as CommonJS and is free of import and
export syntax. Rather than add `export` to those files, which would make
them a SyntaxError when loaded through the documented
<script src="...jsdelivr..."> tag, this declares the truth about them with
a nested src/package.json marking the directory as CommonJS. That revives
the existing module.exports blocks without touching a line of library
logic. Explicit .mjs entry points then re-export the class for ESM
consumers, and an "exports" map wires up both conditions.

The map keeps "./src/*" so every deep path the README documents, including
the CSS import, continues to resolve. The Preact and Qwik wrappers were
missing from the "files" array and were never published, so they are added.

Verified against a real npm pack and install on Node v22.21.0: ESM default
import, ESM named import, require(), both analytics entry points, the old
deep CSS path and the new ./css subpath all resolve. The classic script tag
was checked in a browser with no console errors, and esbuild bundles the
main entry plus the React and Preact wrappers. lint and format:check pass.

Refs #234

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 package.json                   | 26 +++++++++++++++++++++++++-
 src/package.json               |  3 +++
 src/social-share-analytics.mjs | 17 +++++++++++++++++
 src/social-share-button.mjs    | 11 +++++++++++
 4 files changed, 56 insertions(+), 1 deletion(-)
 create mode 100644 src/package.json
 create mode 100644 src/social-share-analytics.mjs
 create mode 100644 src/social-share-button.mjs

diff --git a/package.json b/package.json
index 972ad17e..f6ae4763 100644
--- a/package.json
+++ b/package.json
@@ -2,12 +2,36 @@
   "name": "@aossie-org/social-share-button",
   "version": "1.0.4",
   "description": "Lightweight social sharing component for web applications",
-  "main": "src/social-share-button.js",
+  "main": "./src/social-share-button.js",
+  "module": "./src/social-share-button.mjs",
+  "exports": {
+    ".": {
+      "import": "./src/social-share-button.mjs",
+      "require": "./src/social-share-button.js",
+      "default": "./src/social-share-button.mjs"
+    },
+    "./analytics": {
+      "import": "./src/social-share-analytics.mjs",
+      "require": "./src/social-share-analytics.js",
+      "default": "./src/social-share-analytics.mjs"
+    },
+    "./react": "./src/social-share-button-react.jsx",
+    "./preact": "./src/social-share-button-preact.jsx",
+    "./qwik": "./src/social-share-button-qwik.tsx",
+    "./css": "./src/social-share-button.css",
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
   "files": [
+    "src/package.json",
     "src/social-share-button.js",
+    "src/social-share-button.mjs",
     "src/social-share-button.css",
     "src/social-share-button-react.jsx",
+    "src/social-share-button-preact.jsx",
+    "src/social-share-button-qwik.tsx",
     "src/social-share-analytics.js",
+    "src/social-share-analytics.mjs",
     "README.md",
     "LICENSE"
   ],
diff --git a/src/package.json b/src/package.json
new file mode 100644
index 00000000..5bbefffb
--- /dev/null
+++ b/src/package.json
@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}
diff --git a/src/social-share-analytics.mjs b/src/social-share-analytics.mjs
new file mode 100644
index 00000000..aab2ccf2
--- /dev/null
+++ b/src/social-share-analytics.mjs
@@ -0,0 +1,17 @@
+/**
+ * ES module entry point for the analytics adapters.
+ *
+ * social-share-analytics.js is also usable as a classic <script> tag, so it
+ * cannot contain `export` syntax. This file is the module entry instead.
+ */
+import adapters from "./social-share-analytics.js";
+
+export default adapters;
+export const {
+  GoogleAnalyticsAdapter,
+  MixpanelAdapter,
+  SegmentAdapter,
+  PlausibleAdapter,
+  PostHogAdapter,
+  CustomAdapter,
+} = adapters;
diff --git a/src/social-share-button.mjs b/src/social-share-button.mjs
new file mode 100644
index 00000000..b44dc12f
--- /dev/null
+++ b/src/social-share-button.mjs
@@ -0,0 +1,11 @@
+/**
+ * ES module entry point for SocialShareButton.
+ *
+ * social-share-button.js is also served directly to browsers as a classic
+ * <script> tag from the CDN, so it cannot contain `export` syntax. This file
+ * is the module entry instead, and simply re-exports the class from it.
+ */
+import SocialShareButton from "./social-share-button.js";
+
+export default SocialShareButton;
+export { SocialShareButton };

From bcca369f69596dd737afb56d06a8887e82d86b36 Mon Sep 17 00:00:00 2001
From: Amrendra Vikram Singh
 <76041208+AmrendraTheCoder@users.noreply.github.com>
Date: Sat, 15 Aug 2026 03:59:23 +0530
Subject: [PATCH 2/2] fix(pkg): export SocialShareAnalyticsPlugin as a named
 ESM binding

The ESM entry for ./analytics destructured only the six adapters and left
out SocialShareAnalyticsPlugin, so `import { SocialShareAnalyticsPlugin }`
threw while `require()` and the default import both returned it. That class
is the base every adapter extends, and the docblock in
social-share-analytics.js documents `class MyAdapter extends
SocialShareAnalyticsPlugin`, so it is the binding a consumer is most likely
to reach for.

Verified against a packed install that all seven keys on the default export
now have matching named ESM bindings, and that the adapters still resolve to
this class as their prototype.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 src/social-share-analytics.mjs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/social-share-analytics.mjs b/src/social-share-analytics.mjs
index aab2ccf2..c6bf9ff6 100644
--- a/src/social-share-analytics.mjs
+++ b/src/social-share-analytics.mjs
@@ -8,6 +8,7 @@ import adapters from "./social-share-analytics.js";
 
 export default adapters;
 export const {
+  SocialShareAnalyticsPlugin,
   GoogleAnalyticsAdapter,
   MixpanelAdapter,
   SegmentAdapter,