@blossu/ui 0.4.0

package/dist/react/types.d.ts

@@ -0,0 +1,51 @@
+export interface BlossuConfig {
+    programSlug: string;
+    apiUrl?: string;
+    trackingParam?: string;
+    cookieName?: string;
+    cookieExpiryDays?: number;
+    debug?: boolean;
+    autoTrack?: boolean;
+}
+export interface TrackClickData {
+    code: string;
+    referrer?: string;
+    url?: string;
+}
+export interface TrackSignupData {
+    email?: string;
+    externalCustomerId?: string;
+    metadata?: Record<string, any>;
+}
+export interface TrackSaleData {
+    externalCustomerId: string;
+    amount: number;
+    currency: string;
+    provider?: string;
+    metadata?: Record<string, any>;
+}
+export interface ReferralInfo {
+    code: string;
+    refId: string;
+    timestamp: number;
+}
+export interface PartnerBrand {
+    color?: string;
+    backgroundImageUrl?: string;
+}
+export interface PublicPartnerInfo {
+    firstName: string | null;
+    lastName: string | null;
+    avatarUrl: string | null;
+    company: string | null;
+    website: string | null;
+    brand: PartnerBrand | null;
+}
+export interface PublicReferralInfo {
+    partner: PublicPartnerInfo;
+    code: {
+        code: string;
+        displayName: string | null;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/react/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;CACH"}

package/dist/react/usePartner.d.ts

@@ -0,0 +1,3 @@
+import { UsePartnerConfig, UsePartnerReturn } from './types';
+export declare function usePartner(config: UsePartnerConfig): UsePartnerReturn;
+//# sourceMappingURL=usePartner.d.ts.map

package/dist/react/usePartner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePartner.d.ts","sourceRoot":"","sources":["../../src/react/usePartner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAuC,MAAM,SAAS,CAAC;AAIlG,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAmIrE"}

package/dist/react/utils.d.ts

@@ -0,0 +1,20 @@
+import { ReferralInfo } from "./types";
+export declare function generateRefId(): string;
+export declare function setCookie(name: string, value: string, days: number): void;
+export declare function getCookie(name: string): string | null;
+export declare function deleteCookie(name: string): void;
+export declare function getUrlParam(param: string): string | null;
+export declare function saveReferralInfo(code: string, cookieName?: string, expiryDays?: number): ReferralInfo;
+export declare function getReferralInfo(cookieName?: string): ReferralInfo | null;
+export declare function clearReferralInfo(cookieName?: string): void;
+export declare function getBrowserInfo(): {
+    userAgent: string;
+    language: string;
+    timezone: string;
+};
+export declare function getPageInfo(): {
+    url: string;
+    referrer: string;
+    title: string;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/react/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAUzE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBrD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG/C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKxD;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAoB,EAChC,UAAU,GAAE,MAA2B,GACtC,YAAY,CAWd;AAED,wBAAgB,eAAe,CAC7B,UAAU,GAAE,MAAoB,GAC/B,YAAY,GAAG,IAAI,CASrB;AAED,wBAAgB,iBAAiB,CAAC,UAAU,GAAE,MAAoB,GAAG,IAAI,CAExE;AAED,wBAAgB,cAAc,IAAI;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAUA;AAED,wBAAgB,WAAW,IAAI;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAUA"}

package/dist/tracker.d.ts

@@ -0,0 +1,53 @@
+export interface TrackerConfig {
+    apiUrl: string;
+    programSlug: string;
+    debug: boolean;
+}
+export interface TrackPayload {
+    event: "click" | "signup" | "sale" | "pageview";
+    data: Record<string, any>;
+    meta: {
+        url: string;
+        referrer: string;
+        userAgent: string;
+        language: string;
+        timezone: string;
+        timestamp: number;
+        sdkVersion: string;
+    };
+}
+export declare class Tracker {
+    private config;
+    constructor(config: Partial<TrackerConfig> & {
+        programSlug: string;
+    });
+    private log;
+    private getEndpoint;
+    private getMeta;
+    send(event: "click" | "signup" | "sale" | "pageview", data: Record<string, any>): Promise<boolean>;
+    trackClick(data: {
+        code: string;
+        refId: string;
+    }): Promise<boolean>;
+    trackSignup(data: {
+        code: string;
+        refId: string;
+        email?: string;
+        externalCustomerId?: string;
+        metadata?: Record<string, any>;
+    }): Promise<boolean>;
+    trackSale(data: {
+        code: string;
+        refId: string;
+        externalCustomerId: string;
+        amount: number;
+        currency: string;
+        provider?: string;
+        metadata?: Record<string, any>;
+    }): Promise<boolean>;
+    trackPageview(data: {
+        code: string;
+        refId: string;
+    }): Promise<boolean>;
+}
+//# sourceMappingURL=tracker.d.ts.map

package/dist/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../src/tracker.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAChD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;IAQpE,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,OAAO;IAgBT,IAAI,CACR,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,EAC/C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,OAAO,CAAC;IA0CnB,UAAU,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAInE,WAAW,CAAC,IAAI,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpB,SAAS,CAAC,IAAI,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,kBAAkB,EAAE,MAAM,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpB,aAAa,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAGvE"}

package/dist/types.d.ts

@@ -0,0 +1,51 @@
+export interface BlossuConfig {
+    programSlug: string;
+    apiUrl?: string;
+    trackingParam?: string;
+    cookieName?: string;
+    cookieExpiryDays?: number;
+    debug?: boolean;
+    autoTrack?: boolean;
+}
+export interface TrackClickData {
+    code: string;
+    referrer?: string;
+    url?: string;
+}
+export interface TrackSignupData {
+    email?: string;
+    externalCustomerId?: string;
+    metadata?: Record<string, any>;
+}
+export interface TrackSaleData {
+    externalCustomerId: string;
+    amount: number;
+    currency: string;
+    provider?: string;
+    metadata?: Record<string, any>;
+}
+export interface ReferralInfo {
+    code: string;
+    refId: string;
+    timestamp: number;
+}
+export interface PartnerBrand {
+    color?: string;
+    backgroundImageUrl?: string;
+}
+export interface PublicPartnerInfo {
+    firstName: string | null;
+    lastName: string | null;
+    avatarUrl: string | null;
+    company: string | null;
+    website: string | null;
+    brand: PartnerBrand | null;
+}
+export interface PublicReferralInfo {
+    partner: PublicPartnerInfo;
+    code: {
+        code: string;
+        displayName: string | null;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;CACH"}

package/dist/utils.d.ts

@@ -0,0 +1,20 @@
+import { ReferralInfo } from "./types";
+export declare function generateRefId(): string;
+export declare function setCookie(name: string, value: string, days: number): void;
+export declare function getCookie(name: string): string | null;
+export declare function deleteCookie(name: string): void;
+export declare function getUrlParam(param: string): string | null;
+export declare function saveReferralInfo(code: string, cookieName?: string, expiryDays?: number): ReferralInfo;
+export declare function getReferralInfo(cookieName?: string): ReferralInfo | null;
+export declare function clearReferralInfo(cookieName?: string): void;
+export declare function getBrowserInfo(): {
+    userAgent: string;
+    language: string;
+    timezone: string;
+};
+export declare function getPageInfo(): {
+    url: string;
+    referrer: string;
+    title: string;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAUzE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBrD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG/C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKxD;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAoB,EAChC,UAAU,GAAE,MAA2B,GACtC,YAAY,CAWd;AAED,wBAAgB,eAAe,CAC7B,UAAU,GAAE,MAAoB,GAC/B,YAAY,GAAG,IAAI,CASrB;AAED,wBAAgB,iBAAiB,CAAC,UAAU,GAAE,MAAoB,GAAG,IAAI,CAExE;AAED,wBAAgB,cAAc,IAAI;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAUA;AAED,wBAAgB,WAAW,IAAI;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAUA"}

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@blossu/ui",
+  "version": "0.4.0",
+  "description": "Blossu UI SDK - Client-side tracking for affiliate/referral programs",
+  "main": "dist/blossu.js",
+  "module": "dist/blossu.esm.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/blossu.esm.js",
+      "require": "./dist/blossu.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react/index.esm.js",
+      "require": "./dist/react/index.js",
+      "types": "./dist/react/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run clean && npm run build:bundle",
+    "build:bundle": "rollup -c rollup.config.js",
+    "build:watch": "rollup -c rollup.config.js --watch",
+    "clean": "rm -rf dist",
+    "format": "prettier --write 'src/**/*.{ts,tsx}'",
+    "lint": "eslint 'src/**/*.{ts,tsx}'",
+    "lint:fix": "eslint 'src/**/*.{ts,tsx}' --fix",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm test && npm run lint",
+    "publish-beta": "npm run build && npm publish --tag beta",
+    "publish-stable": "npm run build && npm publish",
+    "release": "npm run clean && npm run lint && npm run test && npm run build && npm publish",
+    "release:patch": "npm version patch && npm run release",
+    "release:minor": "npm version minor && npm run release",
+    "release:major": "npm version major && npm run release"
+  },
+  "keywords": [
+    "blossu",
+    "affiliate",
+    "referral",
+    "tracking",
+    "sdk",
+    "client",
+    "browser",
+    "typescript"
+  ],
+  "author": "Blossu",
+  "license": "MIT",
+  "homepage": "https://blossu.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/blossu/blossu-ui.git"
+  },
+  "bugs": {
+    "url": "https://github.com/blossu/blossu-ui/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.4",
+    "@rollup/plugin-node-resolve": "^15.2.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^11.1.4",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.29",
+    "@types/react": "^18.2.0",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "prettier": "^3.2.5",
+    "react": "^18.2.0",
+    "rollup": "^3.29.4",
+    "ts-jest": "^29.1.2",
+    "tslib": "^2.8.1",
+    "typescript": "^5.3.3"
+  }
+}