react-native-newinstance-chat 0.1.0

package/package.json

@@ -0,0 +1,166 @@
+{
+  "name": "react-native-newinstance-chat",
+  "version": "0.1.0",
+  "description": "New instance LiveAndAiChat React Native SDK — AI + live-agent chat, drop-in native chat screen for iOS and Android.",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-newinstance-chat-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version",
+    "web": "vite",
+    "build:web": "vite build"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/talktothelaw/react-native-newinstance-chat.git"
+  },
+  "author": "lawrence <nwokolawrence6@gmail.com> (https://github.com/talktothelaw)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/talktothelaw/react-native-newinstance-chat/issues"
+  },
+  "homepage": "https://github.com/talktothelaw/react-native-newinstance-chat#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^2.0.3",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^10.0.1",
+    "@jest/globals": "^30.0.0",
+    "@react-native/babel-preset": "0.85.0",
+    "@react-native/eslint-config": "0.85.0",
+    "@react-native/jest-preset": "0.85.0",
+    "@release-it/conventional-changelog": "^10.0.6",
+    "@types/react": "^19.2.0",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.5",
+    "jest": "^30.3.0",
+    "prettier": "^3.8.1",
+    "react": "19.2.3",
+    "react-native": "0.85.0",
+    "react-native-builder-bob": "^0.41.0",
+    "react-native-web": "~0.21.1",
+    "release-it": "^19.2.4",
+    "turbo": "^2.8.21",
+    "typescript": "^6.0.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "NewinstanceChatSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.newinstancechat"
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "@react-native/jest-preset",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint",
+      "jest",
+      "release-it",
+      "vite"
+    ],
+    "version": "0.62.0"
+  }
+}

package/src/NativeNewinstanceChat.ts

@@ -0,0 +1,30 @@
+import { TurboModuleRegistry, type TurboModule } from 'react-native';
+
+/**
+ * TurboModule spec for the LiveAndAiChat React Native bridge. Codegen
+ * produces native protocol stubs from this file:
+ *   - iOS:     ios/build/.../NewinstanceChatSpec/NewinstanceChatSpec.h
+ *   - Android: android/build/.../NativeNewinstanceChatSpec.java
+ *
+ * Dict-shaped arguments use `Object` because Codegen can't enforce
+ * deep object schemas; the JS class enforces the shapes via TypeScript
+ * before calling in.
+ */
+export interface Spec extends TurboModule {
+  configure(config: Object): Promise<void>;
+  setUser(user: Object): void;
+  initialize(): Promise<void>;
+  openChat(): void;
+  closeChat(): void;
+  sendMessage(text: string): void;
+  retryMessage(messageId: string): void;
+  attachFile(opts: Object): Promise<void>;
+  destroy(): void;
+
+  // NativeEventEmitter on iOS calls these to track listener counts.
+  // Required even though native emit goes via RCTDeviceEventEmitter.
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('NewinstanceChat');

package/src/index.tsx

@@ -0,0 +1,120 @@
+import {
+  NativeEventEmitter,
+  NativeModules,
+  type EmitterSubscription,
+} from 'react-native';
+
+import NativeNewinstanceChat from './NativeNewinstanceChat';
+import type {
+  AttachmentInput,
+  ChatUser,
+  EventHandler,
+  EventName,
+  NewinstanceChatConfig,
+} from './types';
+
+export type {
+  AttachmentInput,
+  ChatMessage,
+  ChatUser,
+  ConnectionState,
+  EventMap,
+  EventName,
+  NewinstanceChatConfig,
+  NewinstanceChatError,
+  NewinstanceChatErrorType,
+} from './types';
+
+// Bridge mode (old arch) exposes the module on NativeModules; new arch
+// goes through TurboModuleRegistry. NativeEventEmitter accepts either —
+// we feed it the legacy handle so listener counts get tracked.
+const emitterSource: any =
+  NativeModules.NewinstanceChat ?? (NativeNewinstanceChat as unknown);
+const emitter = new NativeEventEmitter(emitterSource);
+
+/**
+ * React Native binding for the native LiveAndAiChat iOS / Android SDKs.
+ *
+ * Construct, optionally set a user, call `initialize()`, then `openChat()`
+ * when the host wants to surface the native chat screen. Subscribe to
+ * events with `addListener` — the returned function unsubscribes.
+ *
+ * Multiple `new NewinstanceChat(...)` calls reconfigure the same underlying
+ * native instance — the most recent `configure` wins.
+ */
+export class NewinstanceChat {
+  /** Resolves once the native SDK is configured. */
+  readonly ready: Promise<void>;
+
+  constructor(config: NewinstanceChatConfig) {
+    this.ready = NativeNewinstanceChat.configure(config);
+  }
+
+  /**
+   * Identify the customer. Safe to call before or after `initialize()`. If
+   * called before `configure()` resolves, the user is queued and applied
+   * once the native instance exists.
+   */
+  setUser(user: ChatUser): void {
+    NativeNewinstanceChat.setUser(user);
+  }
+
+  /**
+   * Fetch org config, restore the saved conversation, and connect the
+   * subscription transport in the background. Concurrent callers share
+   * the same in-flight init.
+   */
+  initialize(): Promise<void> {
+    return NativeNewinstanceChat.initialize();
+  }
+
+  /** Present the native chat screen modally over the current RN host. */
+  openChat(): void {
+    NativeNewinstanceChat.openChat();
+  }
+
+  /** Dismiss the native chat screen. */
+  closeChat(): void {
+    NativeNewinstanceChat.closeChat();
+  }
+
+  sendMessage(text: string): void {
+    NativeNewinstanceChat.sendMessage(text);
+  }
+
+  retryMessage(messageId: string): void {
+    NativeNewinstanceChat.retryMessage(messageId);
+  }
+
+  /**
+   * Queue a local file as an attachment. The native side reads bytes from
+   * `uri`, pushes them through the SDK's upload pipeline, and bundles the
+   * uploaded reference into the next `sendMessage()`.
+   */
+  attachFile(opts: AttachmentInput): Promise<void> {
+    return NativeNewinstanceChat.attachFile(opts);
+  }
+
+  /**
+   * Subscribe to a native event. Returns an unsubscribe function — call it
+   * when your component unmounts to avoid leaks.
+   */
+  addListener<K extends EventName>(
+    event: K,
+    handler: EventHandler<K>
+  ): () => void {
+    const sub: EmitterSubscription = emitter.addListener(
+      event,
+      handler as (e: unknown) => void
+    );
+    return () => sub.remove();
+  }
+
+  /**
+   * Tear down the native SDK. After this the instance is unusable —
+   * construct a new one if you need to chat again.
+   */
+  destroy(): void {
+    NativeNewinstanceChat.destroy();
+  }
+}

package/src/types.ts

@@ -0,0 +1,86 @@
+/**
+ * Public types for `react-native-newinstance-chat`.
+ *
+ * Shapes match what the native bridges produce, normalised across
+ * iOS / Android (e.g. message status / error type / connection state
+ * are lowercased string enums, not platform-specific enum values).
+ */
+
+export interface NewinstanceChatConfig {
+  /** API key id from your newinstance.cloud dashboard. Never embed the secret half. */
+  apiKey: string;
+  /** Backend base URL. Defaults to `https://service.newinstance.cloud`. */
+  baseUrl?: string;
+  /** Subscription transport. `'sse'` (default in production), `'ws'`, or omit to let the server choose. */
+  transport?: 'sse' | 'ws';
+  /** Optional message pre-seeded as the first outbound message. */
+  initialMessage?: string;
+}
+
+export interface ChatUser {
+  customerName: string;
+  customerEmail?: string;
+  customerId?: string;
+}
+
+/** A local file the native side reads bytes from. */
+export interface AttachmentInput {
+  /** Local file URI: `file://...` (iOS) or `content://...` / `file://...` (Android). */
+  uri: string;
+  name: string;
+  mimeType: string;
+}
+
+export type ConnectionState =
+  | 'idle'
+  | 'connecting'
+  | 'connected'
+  | 'disconnected'
+  | 'offline';
+
+export interface ChatMessage {
+  id: string;
+  /** Client-side id used to dedupe a sent message against its server echo. */
+  clientId?: string;
+  conversationId: string;
+  content: string;
+  /** Lowercased enum from the native side: `'text'`, `'image'`, etc. */
+  type: string;
+  /** Lowercased enum: `'sent'`, `'delivered'`, `'failed'`, etc. */
+  status: string;
+  /** Server-assigned monotonic sequence number for ordering. */
+  seq?: number;
+  /** ISO-8601 timestamp string. */
+  sentAt?: string;
+  /**
+   * Total persisted messages in the conversation as of this envelope.
+   * Only present on `messageReceived`. The SDK uses this for silent
+   * gap-fill — if the locally-rendered count is below this, it refetches.
+   */
+  totalMessages?: number;
+}
+
+export type NewinstanceChatErrorType =
+  | 'network'
+  | 'validation'
+  | 'auth'
+  | 'system';
+
+export interface NewinstanceChatError {
+  type: NewinstanceChatErrorType;
+  message: string;
+  recoverable: boolean;
+}
+
+/** Native event names. Subscribe with `sdk.addListener(event, handler)`. */
+export interface EventMap {
+  messageReceived: (message: ChatMessage) => void;
+  messageSent: (message: ChatMessage) => void;
+  agentTypingChanged: (isTyping: boolean) => void;
+  connectionStateChanged: (state: ConnectionState) => void;
+  unreadCountChanged: (count: number) => void;
+  error: (e: NewinstanceChatError) => void;
+}
+
+export type EventName = keyof EventMap;
+export type EventHandler<K extends EventName> = EventMap[K];