@inno-isw/react-native-rtp 0.0.0-stage → 0.2.0

package/src/validate.ts

@@ -0,0 +1,141 @@
+import type { RtpParty, RtpPayload, RtpRequest } from './types';
+
+/** Required top-level fields for a valid RTP payload. */
+const REQUIRED_FIELDS = [
+  'rtpId',
+  'amount',
+  'currency',
+  'payer',
+  'payee',
+  'expiresAt',
+] as const;
+
+/**
+ * Type guard for RTP payloads.
+ *
+ * NOTE: this intentionally inspects the *decoded* payload, not a push
+ * envelope. Hosts are responsible for extracting the payload from their own
+ * notification system first.
+ *
+ * `amount` is accepted as either a number (minor units) or a numeric string,
+ * because push payloads frequently stringify scalars in transit.
+ */
+export function isRtpPayload(payload: unknown): payload is RtpPayload {
+  if (!payload || typeof payload !== 'object') {
+    return false;
+  }
+  const candidate = payload as Record<string, unknown>;
+  return candidate.type === 'RTP' && typeof candidate.rtpId === 'string';
+}
+
+/**
+ * Returns the list of missing/invalid required fields. Empty array means the
+ * payload is structurally valid.
+ */
+export function findValidationErrors(payload: RtpPayload): string[] {
+  const errors: string[] = [];
+  const record = payload as unknown as Record<string, unknown>;
+
+  for (const field of REQUIRED_FIELDS) {
+    if (record[field] === undefined || record[field] === null) {
+      errors.push(field);
+    }
+  }
+
+  if (
+    payload.expiresAt !== undefined &&
+    Number.isNaN(new Date(payload.expiresAt).getTime())
+  ) {
+    errors.push('expiresAt');
+  }
+
+  for (const side of ['payer', 'payee'] as const) {
+    const party = payload[side] as RtpParty | undefined;
+    if (!party || typeof party !== 'object' || typeof party.name !== 'string') {
+      errors.push(`${side}.name`);
+    }
+  }
+
+  return errors;
+}
+
+/** Coerce an amount that may arrive as a number or numeric string. */
+function toAmount(value: unknown): number {
+  if (typeof value === 'number') {
+    return value;
+  }
+  const parsed = Number(value);
+  return Number.isNaN(parsed) ? 0 : parsed;
+}
+
+/** Map a validated payload into the normalized request held by the SDK. */
+export function toRtpRequest(payload: RtpPayload): RtpRequest {
+  return {
+    id: payload.rtpId,
+    amount: toAmount(payload.amount),
+    currency: payload.currency,
+    payer: payload.payer,
+    payee: payload.payee,
+    narration: payload.narration,
+    transactionRef: payload.transactionRef,
+    orderNumber: payload.orderNumber,
+    deepLink: payload.deepLink,
+    actionMessage: payload.actionMessage,
+    expiresAt: payload.expiresAt,
+    recipient: payload.recipient,
+  };
+}
+
+/**
+ * Build a partial-request patch from an incoming payload, copying only the
+ * fields that are actually present. Used to overlay retrieved backend details
+ * without a partial response erasing data already held from the push.
+ */
+export function toRequestPatch(
+  payload: Partial<RtpPayload>
+): Partial<RtpRequest> {
+  const patch: Partial<RtpRequest> = {};
+  if (payload.rtpId !== undefined) patch.id = payload.rtpId;
+  if (payload.amount !== undefined) patch.amount = toAmount(payload.amount);
+  if (payload.currency !== undefined) patch.currency = payload.currency;
+  if (payload.payer !== undefined) patch.payer = payload.payer;
+  if (payload.payee !== undefined) patch.payee = payload.payee;
+  if (payload.narration !== undefined) patch.narration = payload.narration;
+  if (payload.transactionRef !== undefined)
+    patch.transactionRef = payload.transactionRef;
+  if (payload.orderNumber !== undefined)
+    patch.orderNumber = payload.orderNumber;
+  if (payload.deepLink !== undefined) patch.deepLink = payload.deepLink;
+  if (payload.actionMessage !== undefined)
+    patch.actionMessage = payload.actionMessage;
+  if (payload.expiresAt !== undefined) patch.expiresAt = payload.expiresAt;
+  if (payload.recipient !== undefined) patch.recipient = payload.recipient;
+  return patch;
+}
+
+/**
+ * Overlay a patch onto an existing request. Only defined, non-null values are
+ * copied so a partial response never erases information already held.
+ */
+export function mergeRequest(
+  current: RtpRequest,
+  patch: Partial<RtpRequest>
+): RtpRequest {
+  const next: RtpRequest = { ...current };
+  for (const key of Object.keys(patch) as (keyof RtpRequest)[]) {
+    const value = patch[key];
+    if (value !== undefined && value !== null) {
+      (next as any)[key] = value;
+    }
+  }
+  return next;
+}
+
+/** Pure expiry check. Re-evaluated on every transition, not just on receive. */
+export function isExpired(request: RtpRequest, now: number): boolean {
+  const expiry = new Date(request.expiresAt).getTime();
+  if (Number.isNaN(expiry)) {
+    return false;
+  }
+  return expiry <= now;
+}