@ooneex/analytics 0.0.19 → 1.0.0

package/README.md

@@ -1,10 +1,8 @@
 # @ooneex/analytics
 
-An analytics and event tracking integration library for TypeScript applications. This package provides seamless integration with PostHog for user behavior insights, product analytics, and event tracking across your applications.
+PostHog-powered analytics integration for tracking user behavior, product events, and feature usage with decorator-based service registration.
 
 ![Bun](https://img.shields.io/badge/Bun-Compatible-orange?style=flat-square&logo=bun)
-![Deno](https://img.shields.io/badge/Deno-Compatible-blue?style=flat-square&logo=deno)
-![Node.js](https://img.shields.io/badge/Node.js-Compatible-green?style=flat-square&logo=node.js)
 ![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square&logo=typescript)
 ![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)
 
@@ -24,26 +22,10 @@ An analytics and event tracking integration library for TypeScript applications.
 
 ## Installation
 
-### Bun
 ```bash
 bun add @ooneex/analytics
 ```
 
-### pnpm
-```bash
-pnpm add @ooneex/analytics
-```
-
-### Yarn
-```bash
-yarn add @ooneex/analytics
-```
-
-### npm
-```bash
-npm install @ooneex/analytics
-```
-
 ## Usage
 
 ### Basic Event Tracking
@@ -132,12 +114,12 @@ Main analytics class for PostHog integration.
 
 **Constructor:**
 ```typescript
-new PostHogAnalytics(options?: { apiKey?: string; host?: string })
+new PostHogAnalytics(config?: PostHogConfigType)
 ```
 
 **Parameters:**
-- `options.apiKey` - PostHog API key (optional if set via environment variable)
-- `options.host` - PostHog host URL (optional, defaults to EU region)
+- `config.apiKey` - PostHog API key (optional if set via environment variable)
+- `config.host` - PostHog host URL (optional, defaults to EU region)
 
 **Methods:**
 
@@ -175,6 +157,15 @@ interface IAnalytics<T = any> {
 
 ### Types
 
+#### `PostHogConfigType`
+
+```typescript
+type PostHogConfigType = {
+  apiKey?: string;
+  host?: string;
+};
+```
+
 #### `PostHogCaptureOptionsType`
 
 ```typescript

package/dist/index.d.ts

@@ -7,6 +7,10 @@ type AnalyticsClassType = new (...args: any[]) => IAnalytics;
 interface IAnalytics<T = any> {
 	capture: (options: T) => void;
 }
+type PostHogConfigType = {
+	apiKey?: string;
+	host?: string;
+};
 type PostHogCaptureOptionsType = {
 	id: string;
 	event: string;
@@ -18,7 +22,7 @@ declare const decorator: {
 };
 declare class PostHogAnalytics<T extends PostHogCaptureOptionsType = PostHogCaptureOptionsType> implements IAnalytics<T> {
 	private client;
-	constructor();
+	constructor(config?: PostHogConfigType);
 	capture(options: T): void;
 }
-export { decorator, PostHogCaptureOptionsType, PostHogAnalytics, IAnalytics, AnalyticsException, AnalyticsClassType };
+export { decorator, PostHogConfigType, PostHogCaptureOptionsType, PostHogAnalytics, IAnalytics, AnalyticsException, AnalyticsClassType };

package/dist/index.js

@@ -1,4 +1,4 @@
 // @bun
-var l=function(t,e,r,n){var s=arguments.length,o=s<3?e:n===null?n=Object.getOwnPropertyDescriptor(e,r):n,p;if(typeof Reflect==="object"&&typeof Reflect.decorate==="function")o=Reflect.decorate(t,e,r,n);else for(var c=t.length-1;c>=0;c--)if(p=t[c])o=(s<3?p(o):s>3?p(e,r,o):p(e,r))||o;return s>3&&o&&Object.defineProperty(e,r,o),o};var u=(t,e)=>{if(typeof Reflect==="object"&&typeof Reflect.metadata==="function")return Reflect.metadata(t,e)};import{Exception as y}from"@ooneex/exception";import{HttpStatus as d}from"@ooneex/http-status";class i extends y{constructor(t,e={}){super(t,{status:d.Code.InternalServerError,data:e});this.name="AnalyticsException"}}import{container as A,EContainerScope as T}from"@ooneex/container";var m={analytics:(t=T.Singleton)=>{return(e)=>{A.add(e,t)}}};import{PostHog as h}from"posthog-node";class a{client=null;constructor(){let t=Bun.env.ANALYTICS_POSTHOG_API_KEY;if(!t)throw new i("PostHog API key is required. Please provide an API key either through the constructor options or set the ANALYTICS_POSTHOG_API_KEY environment variable.");this.client=new h(t,{host:Bun.env.ANALYTICS_POSTHOG_HOST||"https://eu.i.posthog.com"})}capture(t){this.client?.capture({distinctId:t.id,event:t.event,properties:{$set:t.properties},timestamp:new Date,...t.groups&&{groups:t.groups}}),this.client?.shutdown()}}a=l([m.analytics(),u("design:paramtypes",[])],a);export{m as decorator,a as PostHogAnalytics,i as AnalyticsException};
+var l=function(t,e,r,n){var s=arguments.length,o=s<3?e:n===null?n=Object.getOwnPropertyDescriptor(e,r):n,p;if(typeof Reflect==="object"&&typeof Reflect.decorate==="function")o=Reflect.decorate(t,e,r,n);else for(var c=t.length-1;c>=0;c--)if(p=t[c])o=(s<3?p(o):s>3?p(e,r,o):p(e,r))||o;return s>3&&o&&Object.defineProperty(e,r,o),o};var y=(t,e)=>{if(typeof Reflect==="object"&&typeof Reflect.metadata==="function")return Reflect.metadata(t,e)};import{Exception as u}from"@ooneex/exception";import{HttpStatus as d}from"@ooneex/http-status";class i extends u{constructor(t,e={}){super(t,{status:d.Code.InternalServerError,data:e});this.name="AnalyticsException"}}import{container as T,EContainerScope as h}from"@ooneex/container";var m={analytics:(t=h.Singleton)=>{return(e)=>{T.add(e,t)}}};import{PostHog as A}from"posthog-node";class a{client=null;constructor(t){let e=t?.apiKey||Bun.env.ANALYTICS_POSTHOG_API_KEY?.trim();if(!e)throw new i("PostHog API key is required. Please provide an API key either through the constructor options or set the ANALYTICS_POSTHOG_API_KEY environment variable.");this.client=new A(e,{host:t?.host||Bun.env.ANALYTICS_POSTHOG_HOST?.trim()||"https://eu.i.posthog.com"})}capture(t){this.client?.capture({distinctId:t.id,event:t.event,properties:{$set:t.properties},timestamp:new Date,...t.groups&&{groups:t.groups}}),this.client?.shutdown()}}a=l([m.analytics(),y("design:paramtypes",[typeof PostHogConfigType==="undefined"?Object:PostHogConfigType])],a);export{m as decorator,a as PostHogAnalytics,i as AnalyticsException};
 
-//# debugId=21DFF7C92F21B38E64756E2164756E21
+//# debugId=C749A77AE7365C8764756E2164756E21

package/dist/index.js.map

@@ -4,9 +4,9 @@
   "sourcesContent": [
     "import { Exception } from \"@ooneex/exception\";\nimport { HttpStatus } from \"@ooneex/http-status\";\n\nexport class AnalyticsException extends Exception {\n  constructor(message: string, data: Record<string, unknown> = {}) {\n    super(message, {\n      status: HttpStatus.Code.InternalServerError,\n      data,\n    });\n\n    this.name = \"AnalyticsException\";\n  }\n}\n",
     "import { container, EContainerScope } from \"@ooneex/container\";\nimport type { AnalyticsClassType } from \"./types\";\n\nexport const decorator = {\n  analytics: (scope: EContainerScope = EContainerScope.Singleton) => {\n    return (target: AnalyticsClassType): void => {\n      container.add(target, scope);\n    };\n  },\n};\n",
-    "import { PostHog } from \"posthog-node\";\nimport { AnalyticsException } from \"./AnalyticsException\";\nimport { decorator } from \"./decorators\";\nimport type { IAnalytics, PostHogCaptureOptionsType } from \"./types\";\n\n@decorator.analytics()\nexport class PostHogAnalytics<T extends PostHogCaptureOptionsType = PostHogCaptureOptionsType>\n  implements IAnalytics<T>\n{\n  private client: PostHog | null = null;\n\n  constructor() {\n    const apiKey = Bun.env.ANALYTICS_POSTHOG_API_KEY;\n\n    if (!apiKey) {\n      throw new AnalyticsException(\n        \"PostHog API key is required. Please provide an API key either through the constructor options or set the ANALYTICS_POSTHOG_API_KEY environment variable.\",\n      );\n    }\n\n    this.client = new PostHog(apiKey, {\n      host: Bun.env.ANALYTICS_POSTHOG_HOST || \"https://eu.i.posthog.com\",\n    });\n  }\n\n  public capture(options: T): void {\n    this.client?.capture({\n      distinctId: options.id,\n      event: options.event,\n      properties: {\n        $set: options.properties,\n      },\n      timestamp: new Date(),\n      ...(options.groups && { groups: options.groups }),\n    });\n    this.client?.shutdown();\n  }\n}\n"
+    "import { PostHog } from \"posthog-node\";\nimport { AnalyticsException } from \"./AnalyticsException\";\nimport { decorator } from \"./decorators\";\nimport type { IAnalytics, PostHogCaptureOptionsType, PostHogConfigType } from \"./types\";\n\n@decorator.analytics()\nexport class PostHogAnalytics<T extends PostHogCaptureOptionsType = PostHogCaptureOptionsType>\n  implements IAnalytics<T>\n{\n  private client: PostHog | null = null;\n\n  constructor(config?: PostHogConfigType) {\n    const apiKey = config?.apiKey || Bun.env.ANALYTICS_POSTHOG_API_KEY?.trim();\n\n    if (!apiKey) {\n      throw new AnalyticsException(\n        \"PostHog API key is required. Please provide an API key either through the constructor options or set the ANALYTICS_POSTHOG_API_KEY environment variable.\",\n      );\n    }\n\n    this.client = new PostHog(apiKey, {\n      host: config?.host || Bun.env.ANALYTICS_POSTHOG_HOST?.trim() || \"https://eu.i.posthog.com\",\n    });\n  }\n\n  public capture(options: T): void {\n    this.client?.capture({\n      distinctId: options.id,\n      event: options.event,\n      properties: {\n        $set: options.properties,\n      },\n      timestamp: new Date(),\n      ...(options.groups && { groups: options.groups }),\n    });\n    this.client?.shutdown();\n  }\n}\n"
   ],
-  "mappings": ";ybAAA,oBAAS,0BACT,qBAAS,4BAEF,MAAM,UAA2B,CAAU,CAChD,WAAW,CAAC,EAAiB,EAAgC,CAAC,EAAG,CAC/D,MAAM,EAAS,CACb,OAAQ,EAAW,KAAK,oBACxB,MACF,CAAC,EAED,KAAK,KAAO,qBAEhB,CCZA,oBAAS,qBAAW,0BAGb,IAAM,EAAY,CACvB,UAAW,CAAC,EAAyB,EAAgB,YAAc,CACjE,MAAO,CAAC,IAAqC,CAC3C,EAAU,IAAI,EAAQ,CAAK,GAGjC,ECTA,kBAAS,qBAMF,MAAM,CAEb,CACU,OAAyB,KAEjC,WAAW,EAAG,CACZ,IAAM,EAAS,IAAI,IAAI,0BAEvB,GAAI,CAAC,EACH,MAAM,IAAI,EACR,0JACF,EAGF,KAAK,OAAS,IAAI,EAAQ,EAAQ,CAChC,KAAM,IAAI,IAAI,wBAA0B,0BAC1C,CAAC,EAGI,OAAO,CAAC,EAAkB,CAC/B,KAAK,QAAQ,QAAQ,CACnB,WAAY,EAAQ,GACpB,MAAO,EAAQ,MACf,WAAY,CACV,KAAM,EAAQ,UAChB,EACA,UAAW,IAAI,QACX,EAAQ,QAAU,CAAE,OAAQ,EAAQ,MAAO,CACjD,CAAC,EACD,KAAK,QAAQ,SAAS,EAE1B,CA/Ba,EAAN,GADN,EAAU,UAAU,EACd,2BAAM",
-  "debugId": "21DFF7C92F21B38E64756E2164756E21",
+  "mappings": ";ybAAA,oBAAS,0BACT,qBAAS,4BAEF,MAAM,UAA2B,CAAU,CAChD,WAAW,CAAC,EAAiB,EAAgC,CAAC,EAAG,CAC/D,MAAM,EAAS,CACb,OAAQ,EAAW,KAAK,oBACxB,MACF,CAAC,EAED,KAAK,KAAO,qBAEhB,CCZA,oBAAS,qBAAW,0BAGb,IAAM,EAAY,CACvB,UAAW,CAAC,EAAyB,EAAgB,YAAc,CACjE,MAAO,CAAC,IAAqC,CAC3C,EAAU,IAAI,EAAQ,CAAK,GAGjC,ECTA,kBAAS,qBAMF,MAAM,CAEb,CACU,OAAyB,KAEjC,WAAW,CAAC,EAA4B,CACtC,IAAM,EAAS,GAAQ,QAAU,IAAI,IAAI,2BAA2B,KAAK,EAEzE,GAAI,CAAC,EACH,MAAM,IAAI,EACR,0JACF,EAGF,KAAK,OAAS,IAAI,EAAQ,EAAQ,CAChC,KAAM,GAAQ,MAAQ,IAAI,IAAI,wBAAwB,KAAK,GAAK,0BAClE,CAAC,EAGI,OAAO,CAAC,EAAkB,CAC/B,KAAK,QAAQ,QAAQ,CACnB,WAAY,EAAQ,GACpB,MAAO,EAAQ,MACf,WAAY,CACV,KAAM,EAAQ,UAChB,EACA,UAAW,IAAI,QACX,EAAQ,QAAU,CAAE,OAAQ,EAAQ,MAAO,CACjD,CAAC,EACD,KAAK,QAAQ,SAAS,EAE1B,CA/Ba,EAAN,GADN,EAAU,UAAU,EACd,0FAAM",
+  "debugId": "C749A77AE7365C8764756E2164756E21",
   "names": []
 }

package/package.json

@@ -1,16 +1,13 @@
 {
   "name": "@ooneex/analytics",
-  "description": "Analytics and event tracking integration with PostHog for user behavior insights and product analytics",
-  "version": "0.0.19",
-  "type": "module",
-  "files": [
-    "dist",
-    "LICENSE",
-    "README.md",
-    "package.json"
-  ],
+  "version": "1.0.0",
   "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@ooneex/container": "0.0.19",
+    "@ooneex/exception": "0.0.18",
+    "@ooneex/http-status": "0.0.18",
+    "posthog-node": "^5.11.0"
+  },
   "exports": {
     ".": {
       "import": {
@@ -20,19 +17,13 @@
     },
     "./package.json": "./package.json"
   },
-  "license": "MIT",
-  "scripts": {
-    "test": "bun test tests",
-    "build": "bunup",
-    "lint": "tsgo --noEmit && bunx biome lint",
-    "npm:publish": "bun publish --tolerate-republish --access public"
-  },
-  "dependencies": {
-    "@ooneex/container": "0.0.18",
-    "@ooneex/exception": "0.0.17",
-    "@ooneex/http-status": "0.0.17",
-    "posthog-node": "^5.11.0"
-  },
+  "description": "PostHog-powered analytics integration for tracking user behavior, product events, and feature usage with decorator-based service registration",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
   "keywords": [
     "analytics",
     "bun",
@@ -42,5 +33,14 @@
     "statistics",
     "tracking",
     "typescript"
-  ]
+  ],
+  "license": "MIT",
+  "scripts": {
+    "test": "bun test tests",
+    "build": "bunup",
+    "lint": "tsgo --noEmit && bunx biome lint",
+    "npm:publish": "bun publish --tolerate-republish --access public"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts"
 }