@incodetech/core 2.0.0-alpha.1 → 2.0.0-alpha.3

package/src/http/api.test.ts

@@ -1,231 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { setup } from '../setup';
-import {
-  api,
-  getApi,
-  getToken,
-  isApiConfigured,
-  resetApi,
-  setToken,
-} from './api';
-
-const mockResponse = {
-  data: {},
-  status: 200,
-  headers: {},
-  ok: true,
-  statusText: 'OK',
-  url: 'https://api.test.com/test',
-};
-
-describe('api', () => {
-  beforeEach(() => {
-    resetApi();
-  });
-
-  describe('api wrapper', () => {
-    it('should throw error when accessing methods before setup()', () => {
-      expect(() => api.get('/test')).toThrow(
-        'SDK not configured. Call setup({ apiURL: "..." }) first.',
-      );
-    });
-
-    it('should have method functions after setup()', () => {
-      setup({ apiURL: 'https://api.test.com', token: 'test-token' });
-
-      expect(typeof api.get).toBe('function');
-      expect(typeof api.post).toBe('function');
-      expect(typeof api.put).toBe('function');
-      expect(typeof api.patch).toBe('function');
-      expect(typeof api.delete).toBe('function');
-    });
-  });
-
-  describe('getApi()', () => {
-    it('should throw error if setup() was not called', () => {
-      expect(() => getApi()).toThrow(
-        'SDK not configured. Call setup({ apiURL: "..." }) first.',
-      );
-    });
-
-    it('should return the client after setup()', () => {
-      setup({ apiURL: 'https://api.test.com', token: 'test-token' });
-
-      const client = getApi();
-      expect(client).toBeDefined();
-      expect(client.defaults.baseURL).toBe('https://api.test.com');
-      expect(getToken()).toBe('test-token');
-    });
-  });
-
-  describe('isApiConfigured()', () => {
-    it('should return false before setup()', () => {
-      expect(isApiConfigured()).toBe(false);
-    });
-
-    it('should return true after setup()', () => {
-      setup({ apiURL: 'https://api.test.com', token: 'test-token' });
-
-      expect(isApiConfigured()).toBe(true);
-    });
-  });
-
-  describe('resetApi()', () => {
-    it('should reset the client to null', () => {
-      setup({ apiURL: 'https://api.test.com', token: 'test-token' });
-      expect(isApiConfigured()).toBe(true);
-
-      resetApi();
-      expect(isApiConfigured()).toBe(false);
-    });
-
-    it('should cause getApi() to throw after reset', () => {
-      setup({ apiURL: 'https://api.test.com', token: 'test-token' });
-      resetApi();
-
-      expect(() => getApi()).toThrow();
-    });
-
-    it('should reset the token to null', () => {
-      setup({ apiURL: 'https://api.test.com', token: 'test-token' });
-      expect(getToken()).toBe('test-token');
-
-      resetApi();
-      expect(getToken()).toBeNull();
-    });
-  });
-
-  describe('setToken()', () => {
-    it('should set the token', () => {
-      setToken('my-token');
-      expect(getToken()).toBe('my-token');
-    });
-
-    it('should override existing token', () => {
-      setToken('first-token');
-      setToken('second-token');
-      expect(getToken()).toBe('second-token');
-    });
-  });
-
-  describe('api methods with token', () => {
-    beforeEach(() => {
-      setup({ apiURL: 'https://api.test.com', token: 'test-token' });
-    });
-
-    it('should add token header to get requests', async () => {
-      const client = getApi();
-      const getSpy = vi.spyOn(client, 'get').mockResolvedValue(mockResponse);
-
-      await api.get('/test');
-
-      expect(getSpy).toHaveBeenCalledWith('/test', {
-        headers: { 'X-Incode-Hardware-Id': 'test-token' },
-      });
-    });
-
-    it('should add token header to post requests', async () => {
-      const client = getApi();
-      const postSpy = vi.spyOn(client, 'post').mockResolvedValue(mockResponse);
-
-      await api.post('/test', { foo: 'bar' });
-
-      expect(postSpy).toHaveBeenCalledWith(
-        '/test',
-        { foo: 'bar' },
-        {
-          headers: { 'X-Incode-Hardware-Id': 'test-token' },
-        },
-      );
-    });
-
-    it('should add token header to put requests', async () => {
-      const client = getApi();
-      const putSpy = vi.spyOn(client, 'put').mockResolvedValue(mockResponse);
-
-      await api.put('/test', { foo: 'bar' });
-
-      expect(putSpy).toHaveBeenCalledWith(
-        '/test',
-        { foo: 'bar' },
-        {
-          headers: { 'X-Incode-Hardware-Id': 'test-token' },
-        },
-      );
-    });
-
-    it('should add token header to patch requests', async () => {
-      const client = getApi();
-      const patchSpy = vi
-        .spyOn(client, 'patch')
-        .mockResolvedValue(mockResponse);
-
-      await api.patch('/test', { foo: 'bar' });
-
-      expect(patchSpy).toHaveBeenCalledWith(
-        '/test',
-        { foo: 'bar' },
-        {
-          headers: { 'X-Incode-Hardware-Id': 'test-token' },
-        },
-      );
-    });
-
-    it('should add token header to delete requests', async () => {
-      const client = getApi();
-      const deleteSpy = vi
-        .spyOn(client, 'delete')
-        .mockResolvedValue(mockResponse);
-
-      await api.delete('/test');
-
-      expect(deleteSpy).toHaveBeenCalledWith('/test', {
-        headers: { 'X-Incode-Hardware-Id': 'test-token' },
-      });
-    });
-
-    it('should merge token header with existing headers', async () => {
-      const client = getApi();
-      const getSpy = vi.spyOn(client, 'get').mockResolvedValue(mockResponse);
-
-      await api.get('/test', { headers: { 'X-Custom': 'value' } });
-
-      expect(getSpy).toHaveBeenCalledWith('/test', {
-        headers: {
-          'X-Custom': 'value',
-          'X-Incode-Hardware-Id': 'test-token',
-        },
-      });
-    });
-  });
-
-  describe('api methods without token', () => {
-    beforeEach(() => {
-      setup({ apiURL: 'https://api.test.com', token: '' });
-      resetApi();
-      setup({ apiURL: 'https://api.test.com', token: '' });
-    });
-
-    it('should not add token header when token is empty', async () => {
-      setToken('');
-      const client = getApi();
-      const getSpy = vi.spyOn(client, 'get').mockResolvedValue(mockResponse);
-
-      await api.get('/test');
-
-      expect(getSpy).toHaveBeenCalledWith('/test', {});
-    });
-
-    it('should pass through config without modification when no token', async () => {
-      setToken('');
-      const client = getApi();
-      const getSpy = vi.spyOn(client, 'get').mockResolvedValue(mockResponse);
-
-      await api.get('/test', { headers: { 'X-Custom': 'value' } });
-
-      expect(getSpy).toHaveBeenCalledWith('/test', {
-        headers: { 'X-Custom': 'value' },
-      });
-    });
-  });
-});

package/src/http/api.ts

@@ -1,90 +0,0 @@
-import type { HttpClient, HttpResponse } from '@incodetech/infra';
-
-type MethodConfig = {
-  headers?: Record<string, string>;
-  signal?: AbortSignal;
-  timeout?: number;
-  query?: Record<string, string | number | boolean | undefined>;
-};
-
-type ApiClient = {
-  get<T>(url: string, config?: MethodConfig): Promise<HttpResponse<T>>;
-  post<T>(
-    url: string,
-    data?: unknown,
-    config?: MethodConfig,
-  ): Promise<HttpResponse<T>>;
-  put<T>(
-    url: string,
-    data?: unknown,
-    config?: MethodConfig,
-  ): Promise<HttpResponse<T>>;
-  patch<T>(
-    url: string,
-    data?: unknown,
-    config?: MethodConfig,
-  ): Promise<HttpResponse<T>>;
-  delete<T>(url: string, config?: MethodConfig): Promise<HttpResponse<T>>;
-};
-
-let client: HttpClient | null = null;
-let currentToken: string | null = null;
-
-export function setClient(httpClient: HttpClient): void {
-  client = httpClient;
-}
-
-export function setToken(token: string): void {
-  currentToken = token;
-}
-
-export function getToken(): string | null {
-  return currentToken;
-}
-
-export function getApi(): HttpClient {
-  if (!client) {
-    throw new Error('SDK not configured. Call setup({ apiURL: "..." }) first.');
-  }
-  return client;
-}
-
-export function isApiConfigured(): boolean {
-  return client !== null;
-}
-
-export function resetApi(): void {
-  client = null;
-  currentToken = null;
-}
-
-function addTokenHeader(config?: MethodConfig): MethodConfig {
-  if (!currentToken) {
-    return config ?? {};
-  }
-  return {
-    ...config,
-    headers: {
-      ...config?.headers,
-      'X-Incode-Hardware-Id': currentToken,
-    },
-  };
-}
-
-export const api: ApiClient = {
-  get<T>(url: string, config?: MethodConfig) {
-    return getApi().get<T>(url, addTokenHeader(config));
-  },
-  post<T>(url: string, data?: unknown, config?: MethodConfig) {
-    return getApi().post<T>(url, data, addTokenHeader(config));
-  },
-  put<T>(url: string, data?: unknown, config?: MethodConfig) {
-    return getApi().put<T>(url, data, addTokenHeader(config));
-  },
-  patch<T>(url: string, data?: unknown, config?: MethodConfig) {
-    return getApi().patch<T>(url, data, addTokenHeader(config));
-  },
-  delete<T>(url: string, config?: MethodConfig) {
-    return getApi().delete<T>(url, addTokenHeader(config));
-  },
-};

package/src/http/endpoints.ts

@@ -1,17 +0,0 @@
-export const endpoints = {
-  createSession: '/omni/start',
-  flow: '/omni/onboarding/flow',
-  events: '/omni/interview-events',
-  selfie: '/omni/add/face',
-  recordingCreateSessionV2: '/omni/recordings/create-session/v2',
-  recordingStartV2: '/omni/recordings/record-start/v2',
-  recordingStopV2: '/omni/recordings/record-stop/v2',
-  phone: '/omni/add/phone',
-  phoneInstant: '/omni/instant/add/phone',
-  getPhone: '/omni/get/phone',
-  startInfo: '/omni/start-info',
-  sendSmsOtp: '/omni/send/sms-otp',
-  compareOtp: '/omni/compare/otp',
-  email: '/omni/add/email',
-  getEmail: '/omni/get/email',
-} as const;

package/src/index.ts

@@ -1,33 +0,0 @@
-export {
-  createApi,
-  type HttpClient,
-  type WasmPipeline,
-  warmupWasm,
-} from '@incodetech/infra';
-export {
-  type Browser,
-  type DeviceClass,
-  getBrowser,
-  getDeviceClass,
-} from './device';
-export { api, getApi } from './http/api';
-export {
-  checkPermission as checkCameraPermission,
-  type PermissionResult,
-  type PermissionStatus,
-  requestPermission as requestCameraPermission,
-} from './permissions';
-export {
-  type CreateSessionOptions,
-  createSession,
-  type Session,
-} from './session';
-export {
-  initializeWasmUtil,
-  isConfigured,
-  reset,
-  type SetupOptions,
-  setup,
-  setWasmConfig,
-  type WasmConfig,
-} from './setup';

package/src/permissions/index.ts

@@ -1,2 +0,0 @@
-export { checkPermission, requestPermission } from './permissionServices';
-export type { PermissionResult, PermissionStatus } from './types';

package/src/permissions/permissionServices.ts

@@ -1,31 +0,0 @@
-import {
-  queryCameraPermission,
-  requestCameraAccess,
-  stopCameraStream,
-} from '@incodetech/infra';
-import type { PermissionResult } from './types';
-
-/**
- * Checks the current camera permission state without prompting the user.
- */
-export async function checkPermission(): Promise<PermissionResult> {
-  return queryCameraPermission();
-}
-
-/**
- * Requests camera permission by attempting to access the camera, then immediately
- * stops the obtained stream. This function does not keep or return the stream.
- */
-export async function requestPermission(): Promise<PermissionResult> {
-  try {
-    const stream = await requestCameraAccess({ video: true });
-    stopCameraStream(stream);
-    return 'granted';
-  } catch (error) {
-    const name = error instanceof Error ? error.name : undefined;
-    if (name === 'NotAllowedError' || name === 'PermissionDeniedError') {
-      return 'denied';
-    }
-    return 'prompt';
-  }
-}

package/src/permissions/types.ts

@@ -1,3 +0,0 @@
-export type PermissionResult = 'granted' | 'denied' | 'prompt';
-
-export type PermissionStatus = 'idle' | 'requesting' | 'denied' | 'learnMore';

package/src/phone/__mocks__/phoneMocks.ts

@@ -1,71 +0,0 @@
-import { vi } from 'vitest';
-import type { PhoneConfig, StartInfo, VerifyOtpResponse } from '../types';
-
-export const mockPhoneConfig: PhoneConfig = {
-  otpVerification: true,
-  otpExpirationInMinutes: 5,
-  prefill: false,
-  isInstantVerify: false,
-  optinEnabled: false,
-  maxOtpAttempts: 3,
-};
-
-export const mockPhoneConfigNoOtp: PhoneConfig = {
-  ...mockPhoneConfig,
-  otpVerification: false,
-};
-
-export const mockPhoneConfigWithPrefill: PhoneConfig = {
-  ...mockPhoneConfig,
-  prefill: true,
-};
-
-export const mockStartInfo: StartInfo = {
-  ipIsoCode: 'US',
-  phonePrefix: '+1',
-  country: 'United States',
-};
-
-export const mockPrefilledPhone = '+14155551234';
-
-export function createMockFetchPhone(phone = mockPrefilledPhone) {
-  return vi.fn().mockResolvedValue({ phone });
-}
-
-export function createMockFetchStartInfo(startInfo = mockStartInfo) {
-  return vi.fn().mockResolvedValue(startInfo);
-}
-
-export function createMockAddPhone(success = true) {
-  return vi.fn().mockResolvedValue({ success });
-}
-
-export function createMockSendOtp() {
-  return vi.fn().mockResolvedValue(undefined);
-}
-
-export function createMockVerifyOtp(
-  success = true,
-): () => Promise<VerifyOtpResponse> {
-  return vi.fn().mockResolvedValue({ success });
-}
-
-export function createFailingMockFetchPhone(error: string) {
-  return vi.fn().mockRejectedValue(new Error(error));
-}
-
-export function createFailingMockAddPhone(error: string) {
-  return vi.fn().mockRejectedValue(new Error(error));
-}
-
-export function createFailingMockVerifyOtp(error: string) {
-  return vi.fn().mockRejectedValue(new Error(error));
-}
-
-export function createDelayedMock<T>(value: T, delayMs = 1000) {
-  return vi
-    .fn()
-    .mockImplementation(
-      () => new Promise((resolve) => setTimeout(() => resolve(value), delayMs)),
-    );
-}

package/src/phone/index.ts

@@ -1,39 +0,0 @@
-/**
- * Phone verification module - supports headless and UI-driven usage.
- *
- * ## Headless Usage (Programmatic)
- *
- * Use `createPhoneManager` to control phone verification without any UI.
- * Perfect for custom UI implementations, backend integrations, or automated testing.
- *
- * ```typescript
- * import { createPhoneManager } from '@incodetech/core/phone';
- *
- * const manager = createPhoneManager({
- *   config: { otpVerification: true, otpExpirationInMinutes: 5, prefill: false },
- * });
- *
- * manager.subscribe((state) => console.log(state.status));
- * manager.load();
- * manager.setPhoneNumber('+14155551234', true);
- * manager.submit();
- * manager.submitOtp('ABC123');
- * manager.stop();
- * ```
- *
- * ## UI Usage
- *
- * For a ready-to-use UI, import the Phone component from `@incodetech/ui/phone`.
- *
- * @module @incodetech/core/phone
- * @see {@link createPhoneManager} for headless API documentation
- * @see {@link PhoneConfig} for configuration options
- * @see {@link PhoneState} for state machine states
- */
-export {
-  createPhoneManager,
-  type PhoneManager,
-  type PhoneState,
-} from './phoneManager';
-export { phoneMachine } from './phoneStateMachine';
-export type { PhoneConfig } from './types';

package/src/phone/phoneActor.ts

@@ -1,15 +0,0 @@
-import { type ActorRefFrom, createActor } from '@incodetech/infra';
-import { type PhoneMachine, phoneMachine } from './phoneStateMachine';
-import type { PhoneConfig } from './types';
-
-export type CreatePhoneActorOptions = {
-  config: PhoneConfig;
-};
-
-export type PhoneActor = ActorRefFrom<PhoneMachine>;
-
-export function createPhoneActor(options: CreatePhoneActorOptions): PhoneActor {
-  return createActor(phoneMachine, {
-    input: { config: options.config },
-  }).start();
-}