@affiliateo/web 0.1.0

package/README.md

@@ -0,0 +1,44 @@
+# @affiliateo/web
+
+Affiliateo web SDK — pass affiliate attribution metadata to your Stripe checkout.
+
+## Install
+
+```bash
+npm install @affiliateo/web
+```
+
+## Setup
+
+1. Make sure you have the Affiliateo tracking script on your site (for visitor tracking)
+2. Connect your Stripe account on the Affiliateo dashboard
+3. Add one line to your Stripe checkout creation:
+
+```ts
+import { getMetadata } from '@affiliateo/web';
+
+// Your existing checkout route
+const session = await stripe.checkout.sessions.create({
+  line_items: [{ price: 'price_xxx', quantity: 1 }],
+  mode: 'payment',
+  success_url: 'https://yoursite.com/success',
+  cancel_url: 'https://yoursite.com/cancel',
+  metadata: getMetadata(req),
+});
+```
+
+That's it. Affiliateo will automatically attribute the purchase to the right affiliate.
+
+## How it works
+
+1. Your tracking script (`t.js`) sets cookies when a visitor arrives via an affiliate link
+2. `getMetadata(req)` reads those cookies and returns them as Stripe metadata
+3. When the payment completes, Affiliateo's webhook reads the metadata and credits the affiliate
+
+## Framework support
+
+Works with any Node.js framework:
+- **Next.js** (App Router & Pages Router)
+- **Express**
+- **Fastify**
+- Any framework that exposes request cookies

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@affiliateo/web",
+  "version": "0.1.0",
+  "description": "Affiliateo web SDK — pass affiliate attribution metadata to your Stripe checkout",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": ["affiliateo", "affiliate", "attribution", "stripe", "web"],
+  "license": "MIT",
+  "files": ["src"]
+}

package/src/index.ts

@@ -0,0 +1,72 @@
+/**
+ * @affiliateo/web — Pass affiliate attribution metadata to your Stripe checkout.
+ *
+ * Usage:
+ * ```ts
+ * import { getMetadata } from '@affiliateo/web';
+ *
+ * const session = await stripe.checkout.sessions.create({
+ *   line_items: [...],
+ *   mode: 'payment',
+ *   metadata: getMetadata(req),
+ * });
+ * ```
+ */
+
+/**
+ * Extract affiliateo cookies from an incoming request.
+ * Works with Next.js (App Router & Pages Router), Express, and any framework
+ * that exposes cookies on the request object.
+ *
+ * Returns metadata object to pass to Stripe checkout session.
+ */
+export function getMetadata(
+  req: {
+    cookies?: Record<string, string> | { get?: (name: string) => { value: string } | undefined }
+    headers?: { cookie?: string } | Headers
+  }
+): { affiliateo_visitor_id?: string; affiliateo_ref?: string } {
+  const metadata: { affiliateo_visitor_id?: string; affiliateo_ref?: string } = {}
+
+  // Try Next.js App Router cookies (ReadonlyRequestCookies with .get())
+  if (req.cookies && typeof req.cookies === 'object' && 'get' in req.cookies && typeof req.cookies.get === 'function') {
+    const visitorId = req.cookies.get('affiliateo_visitor_id')
+    const ref = req.cookies.get('affiliateo_ref')
+    if (visitorId?.value) metadata.affiliateo_visitor_id = visitorId.value
+    if (ref?.value) metadata.affiliateo_ref = ref.value
+    return metadata
+  }
+
+  // Try plain object cookies (Express, Pages Router, etc.)
+  if (req.cookies && typeof req.cookies === 'object') {
+    const cookies = req.cookies as Record<string, string>
+    if (cookies.affiliateo_visitor_id) metadata.affiliateo_visitor_id = cookies.affiliateo_visitor_id
+    if (cookies.affiliateo_ref) metadata.affiliateo_ref = cookies.affiliateo_ref
+    return metadata
+  }
+
+  // Fallback: parse cookie header manually
+  const cookieHeader = req.headers instanceof Headers
+    ? req.headers.get('cookie')
+    : (req.headers as { cookie?: string })?.cookie
+
+  if (cookieHeader) {
+    const cookies = parseCookies(cookieHeader)
+    if (cookies.affiliateo_visitor_id) metadata.affiliateo_visitor_id = cookies.affiliateo_visitor_id
+    if (cookies.affiliateo_ref) metadata.affiliateo_ref = cookies.affiliateo_ref
+  }
+
+  return metadata
+}
+
+/**
+ * Parse a cookie header string into key-value pairs.
+ */
+function parseCookies(cookieHeader: string): Record<string, string> {
+  const cookies: Record<string, string> = {}
+  for (const pair of cookieHeader.split(';')) {
+    const [key, ...rest] = pair.trim().split('=')
+    if (key) cookies[key.trim()] = rest.join('=').trim()
+  }
+  return cookies
+}