@parlr/react-native 0.1.0

package/lib/module/core/api.js

@@ -0,0 +1,305 @@
+"use strict";
+
+// ---------------------------------------------------------------------------
+// Parlr React Native SDK - REST API Client
+// ---------------------------------------------------------------------------
+//
+// Wraps all widget-facing REST endpoints with automatic retry, exponential
+// backoff, session-token injection, and response validation.
+// ---------------------------------------------------------------------------
+
+import axios from 'axios';
+import { ParlrAuthError, ParlrNetworkError, ParlrValidationError } from "./errors.js";
+// ---------------------------------------------------------------------------
+// Retry configuration
+// ---------------------------------------------------------------------------
+
+const MAX_RETRIES = 3;
+const BASE_DELAY_MS = 500;
+const RETRYABLE_STATUS = new Set([408, 429, 500, 502, 503, 504]);
+function delay(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+function isRetryable(error) {
+  if (!error.response) return true; // network error
+  return RETRYABLE_STATUS.has(error.response.status);
+}
+
+// ---------------------------------------------------------------------------
+// Response validators
+// ---------------------------------------------------------------------------
+
+function validateSession(data) {
+  if (!data || typeof data !== 'object') {
+    throw new ParlrValidationError('Invalid session response: expected an object');
+  }
+  const d = data;
+  // Accept both "token" and "sessionToken" from the server.
+  const token = typeof d.token === 'string' ? d.token : d.sessionToken;
+  if (typeof token !== 'string' || typeof d.contactId !== 'string' || typeof d.workspaceId !== 'string' || typeof d.expiresAt !== 'string') {
+    throw new ParlrValidationError('Invalid session response: missing required fields (token, contactId, workspaceId, expiresAt)');
+  }
+  return {
+    token,
+    contactId: d.contactId,
+    workspaceId: d.workspaceId,
+    expiresAt: d.expiresAt
+  };
+}
+function validateMessage(data) {
+  if (!data || typeof data !== 'object') {
+    throw new ParlrValidationError('Invalid message response: expected an object');
+  }
+  const d = data;
+  if (typeof d.id !== 'string' || typeof d.conversationId !== 'string' || typeof d.senderType !== 'string') {
+    throw new ParlrValidationError('Invalid message response: missing required fields (id, conversationId, senderType)');
+  }
+  return {
+    id: d.id,
+    conversationId: d.conversationId,
+    content: typeof d.content === 'string' ? d.content : '',
+    contentType: typeof d.contentType === 'string' ? d.contentType : 'text',
+    senderType: d.senderType,
+    senderName: typeof d.senderName === 'string' ? d.senderName : undefined,
+    senderAvatarUrl: typeof d.senderAvatarUrl === 'string' ? d.senderAvatarUrl : undefined,
+    createdAt: typeof d.createdAt === 'string' ? d.createdAt : new Date().toISOString(),
+    clientId: typeof d.clientId === 'string' ? d.clientId : undefined,
+    attachments: Array.isArray(d.attachments) ? d.attachments : [],
+    status: 'sent'
+  };
+}
+function validateConversation(data) {
+  if (!data || typeof data !== 'object') {
+    throw new ParlrValidationError('Invalid conversation response: expected an object');
+  }
+  const d = data;
+  if (typeof d.id !== 'string' || typeof d.status !== 'string') {
+    throw new ParlrValidationError('Invalid conversation response: missing required fields (id, status)');
+  }
+  return {
+    id: d.id,
+    status: d.status,
+    subject: typeof d.subject === 'string' ? d.subject : null,
+    lastMessageAt: typeof d.lastMessageAt === 'string' ? d.lastMessageAt : null,
+    unreadCount: typeof d.unreadCount === 'number' ? d.unreadCount : 0,
+    assignee: d.assignee && typeof d.assignee === 'object' ? d.assignee : null
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Error mapper
+// ---------------------------------------------------------------------------
+
+function mapAxiosError(error) {
+  if (!error.response) {
+    return new ParlrNetworkError(error.message || 'Network request failed', undefined, {
+      cause: error
+    });
+  }
+  const status = error.response.status;
+  if (status === 401 || status === 403) {
+    return new ParlrAuthError(`Authentication failed (HTTP ${status})`, {
+      cause: error
+    });
+  }
+  return new ParlrNetworkError(`HTTP ${status}: ${error.message}`, status, {
+    cause: error
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Client factory
+// ---------------------------------------------------------------------------
+
+/**
+ * Create a configured API client bound to a resolved config and an optional
+ * session token accessor (so the token can be refreshed externally).
+ */
+export function createApiClient(config, getToken) {
+  const http = axios.create({
+    baseURL: config.apiBaseUrl,
+    timeout: 15_000,
+    headers: {
+      'Content-Type': 'application/json',
+      Accept: 'application/json',
+      'X-Workspace-Id': config.workspaceId
+    }
+  });
+
+  // --- Inject session token and identity token on every request --------------
+  http.interceptors.request.use(req => {
+    const token = getToken();
+    if (token) {
+      req.headers.set('X-Session-Token', token);
+    }
+    if (config.identityToken) {
+      req.headers.set('X-Identity-Token', config.identityToken);
+    }
+    return req;
+  });
+
+  // --- Retry interceptor -----------------------------------------------------
+  http.interceptors.response.use(undefined, async error => {
+    const requestConfig = error.config;
+    if (!requestConfig) throw mapAxiosError(error);
+    requestConfig._retryCount = requestConfig._retryCount ?? 0;
+    if (requestConfig._retryCount >= MAX_RETRIES || !isRetryable(error)) {
+      throw mapAxiosError(error);
+    }
+    requestConfig._retryCount += 1;
+    const jitter = Math.random() * 200;
+    const backoff = BASE_DELAY_MS * Math.pow(2, requestConfig._retryCount - 1) + jitter;
+    if (config.debug) {
+      console.log(`[@parlr/react-native] Retry #${requestConfig._retryCount} after ${Math.round(backoff)}ms`);
+    }
+    await delay(backoff);
+    return http.request(requestConfig);
+  });
+
+  // --- Public API methods ----------------------------------------------------
+  return {
+    async createSession() {
+      const {
+        data
+      } = await http.post('/sessions', {
+        workspaceId: config.workspaceId
+      });
+      return validateSession(data);
+    },
+    async identify(user) {
+      await http.post('/identify', user);
+    },
+    async listConversations(page = 1) {
+      const {
+        data
+      } = await http.get('/conversations', {
+        params: {
+          page
+        }
+      });
+      // Handle both paginated ({ data: [...], meta: {...} }) and plain array responses.
+      if (Array.isArray(data)) {
+        const convs = data.map(validateConversation);
+        return {
+          data: convs,
+          meta: {
+            total: convs.length,
+            page: 1,
+            perPage: convs.length,
+            hasMore: false
+          }
+        };
+      }
+      return data;
+    },
+    async createConversation(initialMessage) {
+      const {
+        data
+      } = await http.post('/conversations', {
+        ...(initialMessage ? {
+          message: initialMessage
+        } : {})
+      });
+      return validateConversation(data);
+    },
+    async getMessages(conversationId, page = 1) {
+      const {
+        data
+      } = await http.get(`/conversations/${encodeURIComponent(conversationId)}/messages`, {
+        params: {
+          page
+        }
+      });
+      // Handle both paginated ({ data: [...], meta: {...} }) and plain array responses.
+      if (Array.isArray(data)) {
+        const messages = data.map(validateMessage);
+        return {
+          data: messages,
+          meta: {
+            total: messages.length,
+            page: 1,
+            perPage: messages.length,
+            hasMore: false
+          }
+        };
+      }
+      return data;
+    },
+    async sendMessage(conversationId, content, clientId) {
+      const {
+        data
+      } = await http.post(`/conversations/${encodeURIComponent(conversationId)}/messages`, {
+        content,
+        clientId
+      });
+      return validateMessage(data);
+    },
+    async sendTypingIndicator(conversationId, isTyping) {
+      await http.post(`/conversations/${encodeURIComponent(conversationId)}/typing`, {
+        isTyping
+      });
+    },
+    async closeConversation(conversationId) {
+      const {
+        data
+      } = await http.post(`/conversations/${encodeURIComponent(conversationId)}/close`);
+      return validateConversation(data);
+    },
+    async reopenConversation(conversationId) {
+      const {
+        data
+      } = await http.post(`/conversations/${encodeURIComponent(conversationId)}/reopen`);
+      return validateConversation(data);
+    },
+    async uploadAttachment(conversationId, formData) {
+      const {
+        data
+      } = await http.post(`/conversations/${encodeURIComponent(conversationId)}/attachments`, formData, {
+        headers: {
+          'Content-Type': 'multipart/form-data'
+        }
+      });
+      return data;
+    },
+    async subscribePush(token, platform) {
+      await http.post('/push/subscribe', {
+        token,
+        platform
+      });
+    },
+    async unsubscribePush(token) {
+      await http.post('/push/unsubscribe', {
+        token
+      });
+    },
+    async submitRating(conversationId, score, comment) {
+      await http.post(`/conversations/${encodeURIComponent(conversationId)}/rating`, {
+        score,
+        comment
+      });
+    },
+    async searchMessages(conversationId, query) {
+      const {
+        data
+      } = await http.get(`/conversations/${encodeURIComponent(conversationId)}/messages/search`, {
+        params: {
+          q: query
+        }
+      });
+      if (Array.isArray(data)) {
+        const messages = data.map(validateMessage);
+        return {
+          data: messages,
+          meta: {
+            total: messages.length,
+            page: 1,
+            perPage: messages.length,
+            hasMore: false
+          }
+        };
+      }
+      return data;
+    }
+  };
+}
+//# sourceMappingURL=api.js.map

package/lib/module/core/api.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["axios","ParlrAuthError","ParlrNetworkError","ParlrValidationError","MAX_RETRIES","BASE_DELAY_MS","RETRYABLE_STATUS","Set","delay","ms","Promise","resolve","setTimeout","isRetryable","error","response","has","status","validateSession","data","d","token","sessionToken","contactId","workspaceId","expiresAt","validateMessage","id","conversationId","senderType","content","contentType","senderName","undefined","senderAvatarUrl","createdAt","Date","toISOString","clientId","attachments","Array","isArray","validateConversation","subject","lastMessageAt","unreadCount","assignee","mapAxiosError","message","cause","createApiClient","config","getToken","http","create","baseURL","apiBaseUrl","timeout","headers","Accept","interceptors","request","use","req","set","identityToken","requestConfig","_retryCount","jitter","Math","random","backoff","pow","debug","console","log","round","createSession","post","identify","user","listConversations","page","get","params","convs","map","meta","total","length","perPage","hasMore","createConversation","initialMessage","getMessages","encodeURIComponent","messages","sendMessage","sendTypingIndicator","isTyping","closeConversation","reopenConversation","uploadAttachment","formData","subscribePush","platform","unsubscribePush","submitRating","score","comment","searchMessages","query","q"],"sourceRoot":"../../../src","sources":["core/api.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/config.js

@@ -0,0 +1,36 @@
+"use strict";
+
+// ---------------------------------------------------------------------------
+// Parlr React Native SDK - Configuration
+// ---------------------------------------------------------------------------
+
+const DEFAULTS = {
+  apiBaseUrl: 'https://api.parlr.chat/api/v1/widget',
+  // WebSocket disabled by default — the Java backend uses STOMP protocol,
+  // not the custom JSON protocol this SDK expects. Enable when the Rust
+  // Gateway is deployed: wsUrl: 'wss://ws.parlr.chat/ws'
+  wsUrl: '',
+  locale: 'fr',
+  debug: false
+};
+
+/**
+ * Resolve a partial user-supplied config into a fully-qualified config with
+ * all defaults applied.
+ *
+ * @throws {Error} if `workspaceId` is missing or empty.
+ */
+export function resolveConfig(partial) {
+  if (!partial.workspaceId || partial.workspaceId.trim().length === 0) {
+    throw new Error('[@parlr/react-native] workspaceId is required. ' + 'Pass it as a prop to <ParlrProvider workspaceId="ws_xxx" />.');
+  }
+  return {
+    workspaceId: partial.workspaceId.trim(),
+    apiBaseUrl: (partial.apiBaseUrl ?? DEFAULTS.apiBaseUrl).replace(/\/+$/, ''),
+    wsUrl: (partial.wsUrl ?? DEFAULTS.wsUrl).replace(/\/+$/, ''),
+    locale: partial.locale ?? DEFAULTS.locale,
+    debug: partial.debug ?? DEFAULTS.debug,
+    identityToken: partial.identityToken
+  };
+}
+//# sourceMappingURL=config.js.map

package/lib/module/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULTS","apiBaseUrl","wsUrl","locale","debug","resolveConfig","partial","workspaceId","trim","length","Error","replace","identityToken"],"sourceRoot":"../../../src","sources":["core/config.ts"],"mappings":";;AAAA;AACA;AACA;;AAIA,MAAMA,QAAQ,GAAG;EACfC,UAAU,EAAE,sCAAsC;EAClD;EACA;EACA;EACAC,KAAK,EAAE,EAAE;EACTC,MAAM,EAAE,IAAI;EACZC,KAAK,EAAE;AACT,CAAU;;AAEV;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,OAAoB,EAAkB;EAClE,IAAI,CAACA,OAAO,CAACC,WAAW,IAAID,OAAO,CAACC,WAAW,CAACC,IAAI,CAAC,CAAC,CAACC,MAAM,KAAK,CAAC,EAAE;IACnE,MAAM,IAAIC,KAAK,CACb,iDAAiD,GAC/C,8DACJ,CAAC;EACH;EAEA,OAAO;IACLH,WAAW,EAAED,OAAO,CAACC,WAAW,CAACC,IAAI,CAAC,CAAC;IACvCP,UAAU,EAAE,CAACK,OAAO,CAACL,UAAU,IAAID,QAAQ,CAACC,UAAU,EAAEU,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAC3ET,KAAK,EAAE,CAACI,OAAO,CAACJ,KAAK,IAAIF,QAAQ,CAACE,KAAK,EAAES,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAC5DR,MAAM,EAAEG,OAAO,CAACH,MAAM,IAAIH,QAAQ,CAACG,MAAM;IACzCC,KAAK,EAAEE,OAAO,CAACF,KAAK,IAAIJ,QAAQ,CAACI,KAAK;IACtCQ,aAAa,EAAEN,OAAO,CAACM;EACzB,CAAC;AACH","ignoreList":[]}

package/lib/module/core/errors.js

@@ -0,0 +1,64 @@
+"use strict";
+
+// ---------------------------------------------------------------------------
+// Parlr React Native SDK - Error Hierarchy
+// ---------------------------------------------------------------------------
+//
+// Typed error classes for structured error handling throughout the SDK.
+// Consumers can use `instanceof` checks to differentiate error types.
+// ---------------------------------------------------------------------------
+
+/**
+ * Base error class for all Parlr SDK errors.
+ */
+export class ParlrError extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = 'ParlrError';
+  }
+}
+
+/**
+ * Network-level error (timeout, DNS failure, no internet).
+ */
+export class ParlrNetworkError extends ParlrError {
+  constructor(message, statusCode, options) {
+    super(message, options);
+    this.name = 'ParlrNetworkError';
+    this.statusCode = statusCode;
+  }
+}
+
+/**
+ * Authentication / session error (expired token, invalid session).
+ */
+export class ParlrAuthError extends ParlrError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = 'ParlrAuthError';
+  }
+}
+
+/**
+ * Validation error (invalid payload from API or WebSocket).
+ */
+export class ParlrValidationError extends ParlrError {
+  constructor(message, field, options) {
+    super(message, options);
+    this.name = 'ParlrValidationError';
+    this.field = field;
+  }
+}
+
+/**
+ * WebSocket connection error (failed to connect, unexpected close).
+ */
+export class ParlrConnectionError extends ParlrError {
+  constructor(message, code, reason, options) {
+    super(message, options);
+    this.name = 'ParlrConnectionError';
+    this.code = code;
+    this.reason = reason;
+  }
+}
+//# sourceMappingURL=errors.js.map

package/lib/module/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ParlrError","Error","constructor","message","options","name","ParlrNetworkError","statusCode","ParlrAuthError","ParlrValidationError","field","ParlrConnectionError","code","reason"],"sourceRoot":"../../../src","sources":["core/errors.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA,OAAO,MAAMA,UAAU,SAASC,KAAK,CAAC;EACpCC,WAAWA,CAACC,OAAe,EAAEC,OAAsB,EAAE;IACnD,KAAK,CAACD,OAAO,EAAEC,OAAO,CAAC;IACvB,IAAI,CAACC,IAAI,GAAG,YAAY;EAC1B;AACF;;AAEA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,SAASN,UAAU,CAAC;EAGhDE,WAAWA,CAACC,OAAe,EAAEI,UAAmB,EAAEH,OAAsB,EAAE;IACxE,KAAK,CAACD,OAAO,EAAEC,OAAO,CAAC;IACvB,IAAI,CAACC,IAAI,GAAG,mBAAmB;IAC/B,IAAI,CAACE,UAAU,GAAGA,UAAU;EAC9B;AACF;;AAEA;AACA;AACA;AACA,OAAO,MAAMC,cAAc,SAASR,UAAU,CAAC;EAC7CE,WAAWA,CAACC,OAAe,EAAEC,OAAsB,EAAE;IACnD,KAAK,CAACD,OAAO,EAAEC,OAAO,CAAC;IACvB,IAAI,CAACC,IAAI,GAAG,gBAAgB;EAC9B;AACF;;AAEA;AACA;AACA;AACA,OAAO,MAAMI,oBAAoB,SAAST,UAAU,CAAC;EAGnDE,WAAWA,CAACC,OAAe,EAAEO,KAAc,EAAEN,OAAsB,EAAE;IACnE,KAAK,CAACD,OAAO,EAAEC,OAAO,CAAC;IACvB,IAAI,CAACC,IAAI,GAAG,sBAAsB;IAClC,IAAI,CAACK,KAAK,GAAGA,KAAK;EACpB;AACF;;AAEA;AACA;AACA;AACA,OAAO,MAAMC,oBAAoB,SAASX,UAAU,CAAC;EAInDE,WAAWA,CAACC,OAAe,EAAES,IAAa,EAAEC,MAAe,EAAET,OAAsB,EAAE;IACnF,KAAK,CAACD,OAAO,EAAEC,OAAO,CAAC;IACvB,IAAI,CAACC,IAAI,GAAG,sBAAsB;IAClC,IAAI,CAACO,IAAI,GAAGA,IAAI;IAChB,IAAI,CAACC,MAAM,GAAGA,MAAM;EACtB;AACF","ignoreList":[]}

package/lib/module/core/offlineQueue.js

@@ -0,0 +1,82 @@
+"use strict";
+
+// ---------------------------------------------------------------------------
+// Parlr React Native SDK - Offline Message Queue
+// ---------------------------------------------------------------------------
+//
+// AsyncStorage-based queue for messages sent while offline. Messages are
+// persisted and flushed automatically when connectivity is restored.
+// ---------------------------------------------------------------------------
+
+const QUEUE_KEY = '@parlr/offline_queue';
+
+// In-memory queue that mirrors persistent storage.
+let memoryQueue = [];
+
+// Lazy AsyncStorage accessor — returns null when unavailable.
+function getAsyncStorage() {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    return require('@react-native-async-storage/async-storage').default;
+  } catch {
+    return null;
+  }
+}
+async function persist() {
+  try {
+    const storage = getAsyncStorage();
+    if (storage) {
+      await storage.setItem(QUEUE_KEY, JSON.stringify(memoryQueue));
+    }
+  } catch {
+    // Persistence is best-effort — the in-memory queue is always available.
+  }
+}
+async function hydrate() {
+  try {
+    const storage = getAsyncStorage();
+    if (storage) {
+      const raw = await storage.getItem(QUEUE_KEY);
+      if (raw) {
+        memoryQueue = JSON.parse(raw);
+      }
+    }
+  } catch {
+    // Start with an empty queue if hydration fails.
+  }
+}
+
+// Hydrate on module load (non-blocking).
+hydrate();
+
+/** Enqueue a message for later delivery. */
+export async function queueMessage(msg) {
+  memoryQueue.push(msg);
+  await persist();
+}
+
+/** Return all currently queued messages. */
+export async function getQueuedMessages() {
+  return [...memoryQueue];
+}
+
+/** Remove a single message from the queue by clientId. */
+export async function removeFromQueue(clientId) {
+  memoryQueue = memoryQueue.filter(m => m.clientId !== clientId);
+  await persist();
+}
+
+/** Attempt to send all queued messages via the API, removing successful ones. */
+export async function flushQueue(api) {
+  const snapshot = [...memoryQueue];
+  for (const msg of snapshot) {
+    try {
+      await api.sendMessage(msg.conversationId, msg.content, msg.clientId);
+      await removeFromQueue(msg.clientId);
+    } catch {
+      // Leave failed messages in the queue for the next flush attempt.
+      break;
+    }
+  }
+}
+//# sourceMappingURL=offlineQueue.js.map

package/lib/module/core/offlineQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["QUEUE_KEY","memoryQueue","getAsyncStorage","require","default","persist","storage","setItem","JSON","stringify","hydrate","raw","getItem","parse","queueMessage","msg","push","getQueuedMessages","removeFromQueue","clientId","filter","m","flushQueue","api","snapshot","sendMessage","conversationId","content"],"sourceRoot":"../../../src","sources":["core/offlineQueue.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAWA,MAAMA,SAAS,GAAG,sBAAsB;;AAExC;AACA,IAAIC,WAA4B,GAAG,EAAE;;AAErC;AACA,SAASC,eAAeA,CAAA,EAGf;EACP,IAAI;IACF;IACA,OAAOC,OAAO,CAAC,2CAA2C,CAAC,CAACC,OAAO;EACrE,CAAC,CAAC,MAAM;IACN,OAAO,IAAI;EACb;AACF;AAEA,eAAeC,OAAOA,CAAA,EAAkB;EACtC,IAAI;IACF,MAAMC,OAAO,GAAGJ,eAAe,CAAC,CAAC;IACjC,IAAII,OAAO,EAAE;MACX,MAAMA,OAAO,CAACC,OAAO,CAACP,SAAS,EAAEQ,IAAI,CAACC,SAAS,CAACR,WAAW,CAAC,CAAC;IAC/D;EACF,CAAC,CAAC,MAAM;IACN;EAAA;AAEJ;AAEA,eAAeS,OAAOA,CAAA,EAAkB;EACtC,IAAI;IACF,MAAMJ,OAAO,GAAGJ,eAAe,CAAC,CAAC;IACjC,IAAII,OAAO,EAAE;MACX,MAAMK,GAAG,GAAG,MAAML,OAAO,CAACM,OAAO,CAACZ,SAAS,CAAC;MAC5C,IAAIW,GAAG,EAAE;QACPV,WAAW,GAAGO,IAAI,CAACK,KAAK,CAACF,GAAG,CAAoB;MAClD;IACF;EACF,CAAC,CAAC,MAAM;IACN;EAAA;AAEJ;;AAEA;AACAD,OAAO,CAAC,CAAC;;AAET;AACA,OAAO,eAAeI,YAAYA,CAACC,GAAkB,EAAiB;EACpEd,WAAW,CAACe,IAAI,CAACD,GAAG,CAAC;EACrB,MAAMV,OAAO,CAAC,CAAC;AACjB;;AAEA;AACA,OAAO,eAAeY,iBAAiBA,CAAA,EAA6B;EAClE,OAAO,CAAC,GAAGhB,WAAW,CAAC;AACzB;;AAEA;AACA,OAAO,eAAeiB,eAAeA,CAACC,QAAgB,EAAiB;EACrElB,WAAW,GAAGA,WAAW,CAACmB,MAAM,CAAEC,CAAC,IAAKA,CAAC,CAACF,QAAQ,KAAKA,QAAQ,CAAC;EAChE,MAAMd,OAAO,CAAC,CAAC;AACjB;;AAEA;AACA,OAAO,eAAeiB,UAAUA,CAACC,GAAmB,EAAiB;EACnE,MAAMC,QAAQ,GAAG,CAAC,GAAGvB,WAAW,CAAC;EAEjC,KAAK,MAAMc,GAAG,IAAIS,QAAQ,EAAE;IAC1B,IAAI;MACF,MAAMD,GAAG,CAACE,WAAW,CAACV,GAAG,CAACW,cAAc,EAAEX,GAAG,CAACY,OAAO,EAAEZ,GAAG,CAACI,QAAQ,CAAC;MACpE,MAAMD,eAAe,CAACH,GAAG,CAACI,QAAQ,CAAC;IACrC,CAAC,CAAC,MAAM;MACN;MACA;IACF;EACF;AACF","ignoreList":[]}

package/lib/module/core/pushNotifications.js

@@ -0,0 +1,16 @@
+"use strict";
+
+// ---------------------------------------------------------------------------
+// Parlr React Native SDK - Push Notification Helpers
+// ---------------------------------------------------------------------------
+
+/** Register a device push token with the Parlr backend. */
+export async function registerPushToken(api, token, platform) {
+  await api.subscribePush(token, platform);
+}
+
+/** Unregister a previously registered push token. */
+export async function unregisterPushToken(api, token) {
+  await api.unsubscribePush(token);
+}
+//# sourceMappingURL=pushNotifications.js.map

package/lib/module/core/pushNotifications.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["registerPushToken","api","token","platform","subscribePush","unregisterPushToken","unsubscribePush"],"sourceRoot":"../../../src","sources":["core/pushNotifications.ts"],"mappings":";;AAAA;AACA;AACA;;AAIA;AACA,OAAO,eAAeA,iBAAiBA,CACrCC,GAAmB,EACnBC,KAAa,EACbC,QAA2B,EACZ;EACf,MAAMF,GAAG,CAACG,aAAa,CAACF,KAAK,EAAEC,QAAQ,CAAC;AAC1C;;AAEA;AACA,OAAO,eAAeE,mBAAmBA,CACvCJ,GAAmB,EACnBC,KAAa,EACE;EACf,MAAMD,GAAG,CAACK,eAAe,CAACJ,KAAK,CAAC;AAClC","ignoreList":[]}

package/lib/module/core/session.js

@@ -0,0 +1,122 @@
+"use strict";
+
+// ---------------------------------------------------------------------------
+// Parlr React Native SDK - Session Manager
+// ---------------------------------------------------------------------------
+//
+// Manages the widget session lifecycle. Uses expo-secure-store when available,
+// falls back to in-memory storage otherwise.
+// ---------------------------------------------------------------------------
+
+const STORE_KEY_PREFIX = 'parlr_session_';
+function storeKey(workspaceId) {
+  return `${STORE_KEY_PREFIX}${workspaceId}`;
+}
+
+// ---------------------------------------------------------------------------
+// Storage abstraction with fallback
+// ---------------------------------------------------------------------------
+
+/** In-memory fallback when expo-secure-store is not available. */
+const memoryStore = new Map();
+const memoryAdapter = {
+  async getItem(key) {
+    return memoryStore.get(key) ?? null;
+  },
+  async setItem(key, value) {
+    memoryStore.set(key, value);
+  },
+  async deleteItem(key) {
+    memoryStore.delete(key);
+  }
+};
+let _adapter = null;
+function getAdapter() {
+  if (_adapter) return _adapter;
+  try {
+    // Dynamic import to keep expo-secure-store truly optional.
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const SecureStore = require('expo-secure-store');
+    if (SecureStore?.setItemAsync) {
+      _adapter = {
+        getItem: key => SecureStore.getItemAsync(key),
+        setItem: (key, value) => SecureStore.setItemAsync(key, value),
+        deleteItem: key => SecureStore.deleteItemAsync(key)
+      };
+      return _adapter;
+    }
+  } catch {
+    // expo-secure-store not available — use memory fallback.
+  }
+  _adapter = memoryAdapter;
+  return _adapter;
+}
+
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+
+/** Persist session to secure storage (or memory fallback). */
+export async function saveSession(workspaceId, session) {
+  const adapter = getAdapter();
+  await adapter.setItem(storeKey(workspaceId), JSON.stringify(session));
+}
+
+/** Retrieve persisted session, or null if none exists. */
+export async function loadSession(workspaceId) {
+  const adapter = getAdapter();
+  try {
+    const raw = await adapter.getItem(storeKey(workspaceId));
+    if (!raw) return null;
+    const session = JSON.parse(raw);
+
+    // Validate required fields.
+    if (typeof session.token !== 'string' || typeof session.contactId !== 'string' || typeof session.expiresAt !== 'string') {
+      console.warn('[@parlr/react-native] Stored session has invalid shape, clearing.');
+      await clearSession(workspaceId);
+      return null;
+    }
+    return session;
+  } catch (err) {
+    // Corrupted data — clear and return null.
+    console.warn('[@parlr/react-native] Failed to load session, clearing:', err);
+    await clearSession(workspaceId);
+    return null;
+  }
+}
+
+/**
+ * Returns true when the session token has not yet expired.
+ * Adds a 60-second safety margin to avoid edge-case failures.
+ */
+export function isSessionValid(session) {
+  try {
+    const expiresAt = new Date(session.expiresAt).getTime();
+    if (isNaN(expiresAt)) {
+      console.warn('[@parlr/react-native] Invalid expiresAt date:', session.expiresAt);
+      return false;
+    }
+    const margin = 60_000; // 60 s
+    return Date.now() < expiresAt - margin;
+  } catch (err) {
+    console.warn('[@parlr/react-native] Error checking session validity:', err);
+    return false;
+  }
+}
+
+/** Delete persisted session for a workspace. */
+export async function clearSession(workspaceId) {
+  const adapter = getAdapter();
+  try {
+    await adapter.deleteItem(storeKey(workspaceId));
+  } catch {
+    // Best-effort — nothing to do if deletion fails.
+  }
+}
+
+/** Reset the storage adapter (for testing). */
+export function _resetAdapter() {
+  _adapter = null;
+  memoryStore.clear();
+}
+//# sourceMappingURL=session.js.map