nana800-analytics 1.0.0

package/dist/platform/PlatformDetector.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Platform types supported by the SDK
+ */
+export declare enum PlatformType {
+    BROWSER = "BROWSER",
+    REACT_NATIVE = "REACT_NATIVE",
+    NODE = "NODE",
+    ELECTRON = "ELECTRON",
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * Detects the current platform
+ */
+export declare const detectPlatform: () => PlatformType;

package/dist/storage/StorageManager.d.ts

@@ -0,0 +1,15 @@
+import { StorageAdapter, Nana800AnalyticsEvent, Nana800AnalyticsUserIdentity } from '../types';
+import { PlatformType } from '../platform/PlatformDetector';
+/**
+ * Manages storage operations across different platforms
+ */
+export declare class StorageManager {
+    private storageAdapter;
+    constructor(platformType: PlatformType, customAdapter?: StorageAdapter, disableStorage?: boolean);
+    private initializeDefaultStorage;
+    isAvailable(): boolean;
+    saveEvents(events: Nana800AnalyticsEvent[]): void;
+    saveUserProps(userProps: Nana800AnalyticsUserIdentity[]): void;
+    loadEvents(): Promise<Nana800AnalyticsEvent[]>;
+    loadUserProps(): Promise<Nana800AnalyticsUserIdentity[]>;
+}

package/dist/types.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Custom analytics event properties type
+ */
+export type Nana800AnalyticsEventProperties = Record<string, string>;
+/**
+ * Analytics event interface
+ */
+export interface Nana800AnalyticsEvent {
+    /**
+     * Name of the tracked event
+     */
+    analytics_event_name: string;
+    /**
+     * User identifier (optional, can be null for anonymous users)
+     */
+    user_id: string | null;
+    /**
+     * Custom event properties as key-value pairs
+     */
+    properties: Nana800AnalyticsEventProperties;
+    /**
+     * Event timestamp
+     */
+    event_time: Date;
+}
+/**
+ * User identification properties
+ */
+export interface Nana800AnalyticsUserIdentity {
+    /**
+     * User identifier
+     */
+    user_id: string;
+    /**
+     * User properties to update
+     */
+    properties: Nana800AnalyticsEventProperties;
+}
+/**
+ * Storage adapter interface for cross-platform storage support
+ * Implement this interface to provide custom storage for different platforms
+ *
+ * @example
+ * ```typescript
+ * // React Native with AsyncStorage
+ * import AsyncStorage from '@react-native-async-storage/async-storage';
+ *
+ * const analytics = new Nana800Analytics({
+ *   apiKey: 'your-api-key',
+ *   appProjectId: 'your-project-id',
+ *   storageAdapter: AsyncStorage
+ * });
+ * ```
+ */
+export interface StorageAdapter {
+    setItem(key: string, value: string): Promise<void> | void;
+    getItem(key: string): Promise<string | null> | string | null;
+    removeItem(key: string): Promise<void> | void;
+}
+/**
+ * Configuration for initializing Nana800Analytics
+ */
+export interface Nana800AnalyticsConfig {
+    /**
+     * API key for authentication
+     */
+    apiKey: string;
+    /**
+     * Analytics project identifier
+     */
+    appProjectId: string;
+    /**
+     * Base URL for the analytics API (optional, defaults to https://api.analytics.nana800.io)
+     */
+    baseUrl?: string;
+    /**
+     * Interval in milliseconds for automatic event flushing (default: 20000ms / 20s)
+     */
+    flushIntervalMs?: number;
+    /**
+     * Maximum number of events to include in a single batch (default: 100)
+     */
+    maxBatchSize?: number;
+    /**
+     * Enable automatic flushing on interval (default: true)
+     */
+    enableAutoFlush?: boolean;
+    /**
+     * Custom storage adapter for non-browser environments (optional)
+     * Use this to provide AsyncStorage for React Native or custom storage
+     */
+    storageAdapter?: StorageAdapter;
+    /**
+     * Disable persistent storage (events will only be kept in memory)
+     */
+    disableStorage?: boolean;
+    /**
+     * Enable debug mode with detailed logging (default: false)
+     */
+    debug?: boolean;
+}
+/**
+ * API response from the backend
+ */
+export interface Nana800AnalyticsApiResponse {
+    success: boolean;
+    message?: string;
+}
+/**
+ * Request body for tracking events
+ */
+export interface TrackEventsRequestBody {
+    events: Array<{
+        analytics_event_name: string;
+        user_id: string | null;
+        properties: Nana800AnalyticsEventProperties;
+        event_time?: Date;
+    }>;
+    app_project_id: string;
+    api_key: string;
+}
+/**
+ * Request body for identifying users
+ */
+export interface IdentifyUsersRequestBody {
+    list: Array<{
+        user_id: string;
+        properties: Nana800AnalyticsEventProperties;
+    }>;
+    app_project_id: string;
+    api_key: string;
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "nana800-analytics",
+  "version": "1.0.0",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/main.cjs.js",
+  "module": "./dist/main.esm.js",
+  "exports": {
+    ".": {
+      "require": "./dist/main.cjs.js",
+      "import": "./dist/main.esm.js",
+      "types": "./dist/main.d.ts"
+    }
+  },
+  "types": "dist/main.d.ts",
+  "scripts": {
+    "build": "tsc --emitDeclarationOnly && node scripts/build.js",
+    "build:cdn": "node scripts/build-cdn.js",
+    "build:all": "yarn build && yarn build:cdn",
+    "release": "yarn build:all && npm publish --access public"
+  },
+  "devDependencies": {
+    "@types/lodash": "^4.17.10",
+    "@types/node": "^24.7.0",
+    "@typescript-eslint/eslint-plugin": "^6.14.0",
+    "@typescript-eslint/parser": "^6.14.0",
+    "esbuild": "^0.18.1",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.0.1",
+    "prettier": "^3.1.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.1.3"
+  },
+  "dependencies": {
+    "axios": "1.7.7",
+    "lodash": "^4.17.21"
+  },
+  "keywords": [
+    "analytics",
+    "nana800",
+    "telemetry",
+    "tracking",
+    "events",
+    "amplitude",
+    "web analytics",
+    "user tracking",
+    "event tracking",
+    "nana800 analytics",
+    "react native",
+    "react-native",
+    "electron",
+    "nodejs",
+    "next.js",
+    "nextjs",
+    "cross-platform",
+    "mobile analytics",
+    "desktop analytics"
+  ]
+}