nana800-analytics 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Bekender
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,158 @@
+# Nana800 Analytics from NANA800.io 📊
+
+Official JavaScript/TypeScript SDK for Nana800 Analytics - a powerful analytics and telemetry service similar to Amplitude.
+
+Track events, identify users, and analyze behavior in your web applications with ease. Nana800 Analytics provides a simple, reliable, and cost-effective alternative to services like Amplitude, Mixpanel, and Google Analytics.
+
+### Detail Documentation
+
+[NANA800 Documentation 📊](https://nana800.gitbook.io/doc)
+
+[Analytics Dashboard](https://cloud.nana800.io/analytics)
+
+### Why Nana800 Analytics?
+
+- 🚀 **Fast & Lightweight** - Minimal bundle size, maximum performance
+- 💰 **Cost-Effective** - Affordable pricing compared to alternatives
+- 🔒 **Privacy-Focused** - Your data stays on your infrastructure
+- 📊 **Powerful Insights** - Real-time analytics and user behavior tracking
+- 🛠 **Easy Integration** - Simple API, works with any JavaScript framework
+- 🌍 **Self-Hosted Option** - Full control over your analytics data
+- 🔧 **Cross-Platform** - Works on Web, React Native, Node.js, Electron, and more
+
+## Supported Platforms
+
+| Platform | Support | Storage | Notes |
+|----------|---------|---------|-------|
+| 🌐 **Web (Browser)** | ✅ Full | localStorage | Works out of the box |
+| ⚛️ **React Native** | ✅ Full | AsyncStorage | Requires AsyncStorage adapter |
+| 🖥 **Electron** | ✅ Full | localStorage | Auto-detected |
+| 🟢 **Node.js** | ✅ Full | Memory only | Server-side tracking |
+| ⚡️ **Next.js** | ✅ Full | localStorage | SSR compatible |
+| 📱 **Expo** | ✅ Full | AsyncStorage | Same as React Native |
+| 🎯 **Vue.js** | ✅ Full | localStorage | Works as standard web |
+| ⚙️ **Angular** | ✅ Full | localStorage | Works as standard web |
+| 🔷 **TypeScript** | ✅ Full | - | Full type definitions included |
+
+## Installation
+
+```bash
+npm install nana800-analytics
+```
+
+or 
+
+```bash
+yarn add nana800-analytics
+```
+
+## Quick Start
+
+### Web / Next.js / Browser
+
+```typescript
+import { createNana800Analytics } from 'nana800-analytics';
+
+const analytics = createNana800Analytics({
+  apiKey: 'your-api-key',
+  appProjectId: 'your-project-id',
+  flushIntervalMs: 20000,
+  debug: false,
+});
+
+analytics.track('page_view', { page: '/home' });
+
+analytics.identify('user123', {
+  name: 'John Doe',
+  email: 'john@example.com',
+});
+```
+
+### React Native / Expo
+
+```typescript
+import { createNana800Analytics } from 'nana800-analytics';
+import AsyncStorage from '@react-native-async-storage/async-storage';
+
+const analytics = createNana800Analytics({
+  apiKey: 'your-api-key',
+  appProjectId: 'your-project-id',
+  storageAdapter: AsyncStorage,
+  flushIntervalMs: 20000,
+});
+
+analytics.track('app_opened', { platform: 'ios' });
+```
+
+### Node.js (Server-side)
+
+```typescript
+import { createNana800Analytics } from 'nana800-analytics';
+
+const analytics = createNana800Analytics({
+  apiKey: 'your-api-key',
+  appProjectId: 'your-project-id',
+  disableStorage: true,
+  flushIntervalMs: 10000,
+});
+
+analytics.track('api_request', { endpoint: '/api/users' });
+```
+
+## Configuration
+
+```typescript
+interface Nana800AnalyticsConfig {
+  apiKey: string;
+  appProjectId: string;
+  baseUrl?: string;            // default: https://api.analytics.nana800.io
+  flushIntervalMs?: number;    // default: 20000
+  maxBatchSize?: number;       // default: 100
+  enableAutoFlush?: boolean;   // default: true
+  storageAdapter?: StorageAdapter;
+  disableStorage?: boolean;
+  debug?: boolean;             // default: false
+}
+```
+
+## API Reference
+
+### `createNana800Analytics(config)`
+Creates and initializes a new analytics instance.
+
+### `track(eventName, properties?, userId?)`
+Tracks an analytics event.
+
+### `identify(userId, properties?)`
+Sets the current user and updates user properties.
+
+### `setUserProperties(userId, properties)`
+Updates user properties.
+
+### `flush()`
+Manually sends all pending events.
+
+### `destroy()`
+Stops automatic flushing and cleans up resources.
+
+## FAQ
+
+### Where is the API key?
+Get your API key from [https://cloud.nana800.io/settings](https://cloud.nana800.io/settings)
+
+### Where is the "app_project_id"?
+Create an analytics project at [https://cloud.nana800.io/analytics](https://cloud.nana800.io/analytics)
+
+## Contacts
+
+No-Code & Business & Analytics Cloud Platform [NANA800.io](https://nana800.io)
+
+Platform Console [CLOUD.NANA800.io](https://cloud.nana800.io)
+
+Platform Documentation [NANA800 Documentation](https://nana800.gitbook.io/doc)
+
+Support Email: support@nana800.io
+
+## License
+
+MIT

package/dist/BekenderAnalytics.d.ts

@@ -0,0 +1,136 @@
+import { BekenderAnalyticsConfig, BekenderAnalyticsEventProperties } from './types';
+/**
+ * BekenderAnalytics SDK class for tracking events and user properties
+ *
+ * Works across multiple platforms: Web, React Native, Node.js, Electron, Next.js
+ *
+ * @internal Use createBekenderAnalytics() instead of instantiating directly
+ *
+ * @example
+ * ```typescript
+ * import { createBekenderAnalytics } from 'bekender-analytics';
+ *
+ * // Browser / Next.js
+ * const analytics = createBekenderAnalytics({
+ *   apiKey: 'your-api-key',
+ *   appProjectId: 'your-project-id',
+ *   debug: false
+ * });
+ *
+ * // React Native
+ * import AsyncStorage from '@react-native-async-storage/async-storage';
+ * const analytics = createBekenderAnalytics({
+ *   apiKey: 'your-api-key',
+ *   appProjectId: 'your-project-id',
+ *   storageAdapter: AsyncStorage
+ * });
+ *
+ * // Start tracking immediately - no init() needed!
+ * analytics.track('page_view', { page: '/home' });
+ * analytics.identify('user123', { email: 'user@example.com' });
+ * ```
+ */
+export declare class BekenderAnalytics {
+    private config;
+    private eventsQueue;
+    private userPropsQueue;
+    private flushIntervalId;
+    private initialFlushTimeoutId;
+    private isInitialized;
+    private currentUserId;
+    private storageManager;
+    private apiClient;
+    /**
+     * Creates a new BekenderAnalytics instance
+     *
+     * @param config - Configuration options for the analytics SDK
+     */
+    constructor(config: BekenderAnalyticsConfig);
+    /**
+     * Initializes the analytics SDK and starts automatic event flushing
+     *
+     * @returns true if initialization was successful
+     */
+    init(): boolean;
+    /**
+     * Tracks an analytics event
+     *
+     * @param eventName - Name of the event to track
+     * @param properties - Optional event properties as key-value pairs
+     * @param userId - Optional user identifier (uses current user if not provided)
+     *
+     * @example
+     * ```typescript
+     * analytics.track('button_clicked', { button_id: 'signup_btn' });
+     * analytics.track('page_view', { page: '/dashboard' }, 'user123');
+     * ```
+     */
+    track(eventName: string, properties?: BekenderAnalyticsEventProperties, userId?: string): void;
+    /**
+     * Sets the current user identifier and optionally updates user properties
+     *
+     * @param userId - User identifier
+     * @param properties - Optional user properties to update
+     *
+     * @example
+     * ```typescript
+     * analytics.identify('user123', { name: 'John Doe', email: 'john@example.com' });
+     * ```
+     */
+    identify(userId: string, properties?: BekenderAnalyticsEventProperties): void;
+    /**
+     * Updates user properties without changing the current user
+     *
+     * @param userId - User identifier
+     * @param properties - User properties to update
+     *
+     * @example
+     * ```typescript
+     * analytics.setUserProperties('user123', { subscription: 'premium' });
+     * ```
+     */
+    setUserProperties(userId: string, properties: BekenderAnalyticsEventProperties): void;
+    /**
+     * Manually flushes all pending events and user properties to the server
+     *
+     * @returns Promise that resolves when flush is complete
+     *
+     * @example
+     * ```typescript
+     * await analytics.flush();
+     * ```
+     */
+    flush(): Promise<void>;
+    /**
+     * Clears the current user identifier
+     */
+    reset(): void;
+    /**
+     * Stops automatic event flushing and clears the interval
+     */
+    destroy(): void;
+    /**
+     * Gets the current user identifier
+     *
+     * @returns Current user ID or null if not set
+     */
+    getUserId(): string | null;
+    /**
+     * Gets the number of pending events in the queue
+     *
+     * @returns Number of pending events
+     */
+    getPendingEventsCount(): number;
+    /**
+     * Gets the number of pending user property updates in the queue
+     *
+     * @returns Number of pending user property updates
+     */
+    getPendingUserPropsCount(): number;
+    private startAutoFlush;
+    private sendEvents;
+    private sendUserProperties;
+    private saveToStorage;
+    private loadFromStorage;
+    private log;
+}

package/dist/Nana800Analytics.d.ts

@@ -0,0 +1,136 @@
+import { Nana800AnalyticsConfig, Nana800AnalyticsEventProperties } from './types';
+/**
+ * Nana800Analytics SDK class for tracking events and user properties
+ *
+ * Works across multiple platforms: Web, React Native, Node.js, Electron, Next.js
+ *
+ * @internal Use createNana800Analytics() instead of instantiating directly
+ *
+ * @example
+ * ```typescript
+ * import { createNana800Analytics } from 'nana800-analytics';
+ *
+ * // Browser / Next.js
+ * const analytics = createNana800Analytics({
+ *   apiKey: 'your-api-key',
+ *   appProjectId: 'your-project-id',
+ *   debug: false
+ * });
+ *
+ * // React Native
+ * import AsyncStorage from '@react-native-async-storage/async-storage';
+ * const analytics = createNana800Analytics({
+ *   apiKey: 'your-api-key',
+ *   appProjectId: 'your-project-id',
+ *   storageAdapter: AsyncStorage
+ * });
+ *
+ * // Start tracking immediately - no init() needed!
+ * analytics.track('page_view', { page: '/home' });
+ * analytics.identify('user123', { email: 'user@example.com' });
+ * ```
+ */
+export declare class Nana800Analytics {
+    private config;
+    private eventsQueue;
+    private userPropsQueue;
+    private flushIntervalId;
+    private initialFlushTimeoutId;
+    private isInitialized;
+    private currentUserId;
+    private storageManager;
+    private apiClient;
+    /**
+     * Creates a new Nana800Analytics instance
+     *
+     * @param config - Configuration options for the analytics SDK
+     */
+    constructor(config: Nana800AnalyticsConfig);
+    /**
+     * Initializes the analytics SDK and starts automatic event flushing
+     *
+     * @returns true if initialization was successful
+     */
+    init(): boolean;
+    /**
+     * Tracks an analytics event
+     *
+     * @param eventName - Name of the event to track
+     * @param properties - Optional event properties as key-value pairs
+     * @param userId - Optional user identifier (uses current user if not provided)
+     *
+     * @example
+     * ```typescript
+     * analytics.track('button_clicked', { button_id: 'signup_btn' });
+     * analytics.track('page_view', { page: '/dashboard' }, 'user123');
+     * ```
+     */
+    track(eventName: string, properties?: Nana800AnalyticsEventProperties, userId?: string): void;
+    /**
+     * Sets the current user identifier and optionally updates user properties
+     *
+     * @param userId - User identifier
+     * @param properties - Optional user properties to update
+     *
+     * @example
+     * ```typescript
+     * analytics.identify('user123', { name: 'John Doe', email: 'john@example.com' });
+     * ```
+     */
+    identify(userId: string, properties?: Nana800AnalyticsEventProperties): void;
+    /**
+     * Updates user properties without changing the current user
+     *
+     * @param userId - User identifier
+     * @param properties - User properties to update
+     *
+     * @example
+     * ```typescript
+     * analytics.setUserProperties('user123', { subscription: 'premium' });
+     * ```
+     */
+    setUserProperties(userId: string, properties: Nana800AnalyticsEventProperties): void;
+    /**
+     * Manually flushes all pending events and user properties to the server
+     *
+     * @returns Promise that resolves when flush is complete
+     *
+     * @example
+     * ```typescript
+     * await analytics.flush();
+     * ```
+     */
+    flush(): Promise<void>;
+    /**
+     * Clears the current user identifier
+     */
+    reset(): void;
+    /**
+     * Stops automatic event flushing and clears the interval
+     */
+    destroy(): void;
+    /**
+     * Gets the current user identifier
+     *
+     * @returns Current user ID or null if not set
+     */
+    getUserId(): string | null;
+    /**
+     * Gets the number of pending events in the queue
+     *
+     * @returns Number of pending events
+     */
+    getPendingEventsCount(): number;
+    /**
+     * Gets the number of pending user property updates in the queue
+     *
+     * @returns Number of pending user property updates
+     */
+    getPendingUserPropsCount(): number;
+    private startAutoFlush;
+    private sendEvents;
+    private sendUserProperties;
+    private saveToStorage;
+    private loadFromStorage;
+    private log;
+}

package/dist/api/ApiClient.d.ts

@@ -0,0 +1,13 @@
+import { Nana800AnalyticsEvent, Nana800AnalyticsUserIdentity, Nana800AnalyticsApiResponse } from '../types';
+/**
+ * Handles API communication with the analytics backend
+ */
+export declare class ApiClient {
+    private axiosClient;
+    private apiKey;
+    private appProjectId;
+    constructor(baseUrl: string, apiKey: string, appProjectId: string);
+    sendEvents(events: Nana800AnalyticsEvent[]): Promise<Nana800AnalyticsApiResponse>;
+    sendUserProperties(userProps: Nana800AnalyticsUserIdentity[]): Promise<Nana800AnalyticsApiResponse>;
+    private extractData;
+}