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

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,14 @@
+export { createRtpClient } from './client.js';
+export { RTP_STATUS, RTP_EVENT, RTP_ERROR } from './constants.js';
+export type { RtpStatus, RtpEvent, RtpError } from './constants.js';
+export { isRtpPayload, findValidationErrors, toRtpRequest, isExpired, } from './validate.js';
+export { mapPushToRtp } from './push.js';
+export type { PushEnvelope } from './push.js';
+export type { RtpPayload, RtpParty, RtpRequest, RtpCredential, RtpResult, RtpReceiveOutcome, RtpTransport, RtpStorage, RtpHttpResponse, RtpClient, RtpClientOptions, RtpEventMap, RtpUnsubscribe, } from './types.js';
+export { RtpProvider, useRtp, RtpContext } from './react/RtpProvider.js';
+export type { RtpProviderProps, RtpContextValue } from './react/RtpProvider.js';
+export { createMockTransport } from './mock/mockTransport.js';
+export type { MockTransport, MockTransportOptions, RecordedCall, } from './mock/mockTransport.js';
+export { makeRtpPayload, makeExpiredPayload } from './mock/makeRtpPayload.js';
+export type { MakeRtpPayloadOverrides } from './mock/makeRtpPayload.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAU,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAa,CAAC;AAC/D,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAa,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,SAAS,GACV,MAAM,eAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAQ,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,MAAM,WAAQ,CAAC;AAG3C,YAAY,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,cAAc,GACf,MAAM,YAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,wBAAqB,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAqB,CAAC;AAG7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAsB,CAAC;AAC3D,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,YAAY,GACb,MAAM,yBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAAuB,CAAC;AAC3E,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAAuB,CAAC"}

package/lib/typescript/src/mock/makeRtpPayload.d.ts

@@ -0,0 +1,17 @@
+import type { RtpPayload } from '../types.js';
+export interface MakeRtpPayloadOverrides extends Partial<Omit<RtpPayload, 'type' | 'payer' | 'payee' | 'expiresAt'>> {
+    payer?: Partial<RtpPayload['payer']>;
+    payee?: Partial<RtpPayload['payee']>;
+    /** Milliseconds from `now` until expiry (negative = already expired). */
+    expiresInMs?: number;
+    /** Base time to compute expiry from. Defaults to Date.now(). */
+    from?: number;
+}
+/**
+ * Build a valid RTP payload for tests, fixtures and the example app.
+ * Every field is overridable so edge cases are trivial to express.
+ */
+export declare function makeRtpPayload(overrides?: MakeRtpPayloadOverrides): RtpPayload;
+/** A payload that has already expired. */
+export declare function makeExpiredPayload(overrides?: MakeRtpPayloadOverrides): RtpPayload;
+//# sourceMappingURL=makeRtpPayload.d.ts.map

package/lib/typescript/src/mock/makeRtpPayload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeRtpPayload.d.ts","sourceRoot":"","sources":["../../../../src/mock/makeRtpPayload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAU,CAAC;AAO3C,MAAM,WAAW,uBAAwB,SAAQ,OAAO,CACtD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC,CAC3D;IACC,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,SAAS,GAAE,uBAA4B,GACtC,UAAU,CAkCZ;AAED,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAChC,SAAS,GAAE,uBAA4B,GACtC,UAAU,CAEZ"}

package/lib/typescript/src/mock/mockTransport.d.ts

@@ -0,0 +1,29 @@
+import type { RtpTransport } from '../types.js';
+export interface MockTransportOptions {
+    /** Simulated network latency in ms. */
+    latencyMs?: number;
+    /** Simulate a network failure on accept. */
+    failAccept?: boolean;
+    /** Simulate a network failure on decline. */
+    failDecline?: boolean;
+    /** Backend status to return for accept. */
+    acceptStatus?: 'ACCEPTED' | 'DECLINED' | 'FAILED';
+}
+export interface RecordedCall {
+    method: 'post' | 'get';
+    path: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+}
+export interface MockTransport {
+    transport: RtpTransport;
+    /** Recorded calls, for assertions in tests and the example app. */
+    calls: RecordedCall[];
+    /** Clear recorded calls. */
+    reset: () => void;
+}
+/**
+ * Deterministic in-memory transport. No real network calls are made.
+ */
+export declare function createMockTransport(options?: MockTransportOptions): MockTransport;
+//# sourceMappingURL=mockTransport.d.ts.map

package/lib/typescript/src/mock/mockTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockTransport.d.ts","sourceRoot":"","sources":["../../../../src/mock/mockTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,aAAU,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;CACnD;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,YAAY,CAAC;IACxB,mEAAmE;IACnE,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAOD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,oBAAyB,GACjC,aAAa,CAgEf"}

package/lib/typescript/src/push.d.ts

@@ -0,0 +1,41 @@
+import type { RtpPayload } from './types.js';
+/**
+ * A generic push notification envelope.
+ *
+ * The SDK does not know or care what a push looks like — every host platform
+ * has a different shape, and this is the single seam where that difference is
+ * absorbed. A Kotlin/Swift integration implements the equivalent of
+ * `mapPushToRtp` against the same `RtpPayload` contract.
+ */
+export interface PushEnvelope {
+    id?: string;
+    title?: string;
+    message?: string;
+    foreground?: boolean;
+    /** RTCP `onRemoteNotification` style payload. */
+    data?: Record<string, unknown>;
+    /** RTCP `onNotificationTapped` flattens the body to the top level. */
+    body?: string;
+    [key: string]: unknown;
+}
+/**
+ * Extract an RTP payload from a push envelope, or return null if the push is
+ * not an RTP request.
+ *
+ * RTCP delivers two distinct shapes for the same notification:
+ *
+ *  1. `onRemoteNotification` (foreground/background):
+ *     `{ data: { app_data: { type: 'RTP', ... } } }`
+ *
+ *  2. `onNotificationTapped`: scalars are stringified and the custom payload
+ *     arrives as a JSON string:
+ *     `{ data: { app_data: '{"type":"RTP",...}' } }`
+ *
+ * Both are normalized here so callers only ever deal with `RtpPayload`.
+ *
+ * `getData` is injectable so hosts that expose push data differently (e.g. a
+ * Map-like object on native) can plug in their accessor without changing the
+ * rest of the SDK.
+ */
+export declare function mapPushToRtp(envelope: PushEnvelope | null | undefined, getData?: (envelope: PushEnvelope) => Record<string, unknown> | undefined): RtpPayload | null;
+//# sourceMappingURL=push.d.ts.map

package/lib/typescript/src/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/push.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAS,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,EACzC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxE,UAAU,GAAG,IAAI,CAenB"}

package/lib/typescript/src/react/RtpProvider.d.ts

@@ -0,0 +1,56 @@
+import React from 'react';
+import type { RtpClient, RtpCredential, RtpRequest, RtpResult } from '../types.js';
+import type { RtpStatus } from '../constants.js';
+/**
+ * A minimal persistence port for the provider. The host supplies its own
+ * storage (e.g. react-native-default-preference / AsyncStorage) so the SDK
+ * stays dependency-free. When omitted, persistence is in-memory only.
+ */
+export interface RtpProviderStorage {
+    getItem: (key: string) => Promise<string | null> | string | null;
+    setItem: (key: string, value: string) => Promise<void> | void;
+    removeItem: (key: string) => Promise<void> | void;
+}
+export interface RtpProviderProps {
+    /** The client created via `createRtpClient`. */
+    client: RtpClient;
+    /** Whether the user is currently authenticated. Drives the auth gate. */
+    isAuthenticated: boolean;
+    /** Optional persistence used to survive cold starts / logged-out flows. */
+    storage?: RtpProviderStorage;
+    /**
+     * Called with the raw decoded payload before it is fed to the client.
+     * Use this to persist the payload yourself, log it, etc.
+     */
+    onIncomingPayload?: (payload: unknown) => void;
+    children: React.ReactNode;
+}
+export interface RtpContextValue {
+    /** The active request, if any. */
+    request: RtpRequest | null;
+    /** The active request's normalized status. */
+    status: RtpStatus | null;
+    /** True when a request is ready for the user to act on. */
+    isReady: boolean;
+    /** Accept the active request with an opaque credential. */
+    accept: (credential?: RtpCredential) => Promise<RtpResult | undefined>;
+    /** Decline the active request. */
+    decline: (reason?: string) => Promise<RtpResult | undefined>;
+    /** Dismiss the active request from the UI. */
+    dismiss: () => void;
+    /** Feed a raw decoded payload into the client (for host push adapters). */
+    receive: (payload: unknown) => void;
+    /** Last terminal result, for rendering feedback. */
+    lastResult: RtpResult | null;
+}
+export declare const RtpContext: React.Context<RtpContextValue | null>;
+/**
+ * Bridges the framework-agnostic RTP client into React. Owns no UI — hosts
+ * render their own bottom sheet / modal and react to `request` + `status`.
+ */
+export declare function RtpProvider({ client, isAuthenticated, storage, onIncomingPayload, children, }: RtpProviderProps): React.JSX.Element;
+/**
+ * Access the RTP context. Throws when used outside of an `<RtpProvider>`.
+ */
+export declare function useRtp(): RtpContextValue;
+//# sourceMappingURL=RtpProvider.d.ts.map

package/lib/typescript/src/react/RtpProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RtpProvider.d.ts","sourceRoot":"","sources":["../../../../src/react/RtpProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAU,CAAC;AAEhF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAc,CAAC;AAI9C;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IACjE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9D,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,MAAM,EAAE,SAAS,CAAC;IAClB,yEAAyE;IACzE,eAAe,EAAE,OAAO,CAAC;IACzB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,8CAA8C;IAC9C,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACvE,kCAAkC;IAClC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAC7D,8CAA8C;IAC9C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,2EAA2E;IAC3E,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,oDAAoD;IACpD,UAAU,EAAE,SAAS,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,UAAU,uCAA8C,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,eAAe,EACf,OAAO,EACP,iBAAiB,EACjB,QAAQ,GACT,EAAE,gBAAgB,qBAkHlB;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,eAAe,CAQxC"}

package/lib/typescript/src/types.d.ts

@@ -0,0 +1,142 @@
+import type { RtpError, RtpStatus } from './constants.js';
+/**
+ * The decoded RTP payload.
+ *
+ * IMPORTANT: this is the *decoded* payload, not a push notification envelope.
+ * Each host platform is responsible for mapping its own push shape (RTCP,
+ * raw FCM, APNs, etc.) into this structure via an adapter. This keeps the SDK
+ * portable across React Native, Kotlin and Swift.
+ */
+export interface RtpPayload {
+    /** Payload schema version. Unknown fields must be ignored, not rejected. */
+    version?: string;
+    /** Discriminator. Only `'RTP'` payloads are handled by this SDK. */
+    type: 'RTP';
+    /** Stable, unique id for the request (idempotency key). */
+    rtpId: string;
+    /** Amount in the currency's minor unit (e.g. kobo). Integer to avoid floats. */
+    amount: number;
+    /** ISO 4217 currency code. e.g. "NGN". */
+    currency: string;
+    /** Party being asked to pay. */
+    payer: RtpParty;
+    /** Party that will receive the money. */
+    payee: RtpParty;
+    /** Human-readable reason for the request. */
+    narration?: string;
+    /** Backend reference for the transaction. */
+    transactionRef?: string;
+    /** ISO 8601 timestamp after which the request can no longer be actioned. */
+    expiresAt: string;
+    /** Alias (phone/email) the request is addressed to, for identity matching. */
+    recipient?: string;
+    /** Arbitrary passthrough data. Ignored by the SDK. */
+    [key: string]: unknown;
+}
+/** A party on either side of a request (payer or payee). */
+export interface RtpParty {
+    name: string;
+    accountNumber?: string;
+    bank?: string;
+    /** Optional display URL for a logo/avatar. */
+    logoUrl?: string;
+}
+/** A normalized, validated request held by the SDK. */
+export interface RtpRequest {
+    id: string;
+    amount: number;
+    currency: string;
+    payer: RtpParty;
+    payee: RtpParty;
+    narration?: string;
+    transactionRef?: string;
+    expiresAt: string;
+    recipient?: string;
+}
+/**
+ * Credential produced by the host platform to authorise an accept.
+ * The SDK never inspects this — it is opaque and forwarded to the backend.
+ *
+ * For React Native this is typically `{ secureData, pinBlock, authData }`
+ * produced by the app's card/PIN service.
+ */
+export type RtpCredential = Record<string, unknown>;
+export interface RtpResult {
+    id: string;
+    status: RtpStatus;
+    error?: RtpError | string;
+    data?: unknown;
+}
+/** Outcome of feeding a raw payload into the client. */
+export interface RtpReceiveOutcome {
+    /** False when the payload was not an RTP payload. */
+    handled: boolean;
+    request?: RtpRequest;
+    status?: RtpStatus;
+    error?: RtpError | string;
+}
+export interface RtpHttpResponse<T = any> {
+    data?: T;
+    status?: number;
+}
+/**
+ * Minimal HTTP contract. Hosts inject an implementation backed by their own
+ * client (`ky`, `axios`, native, ...). The SDK never imports a network library.
+ */
+export interface RtpTransport {
+    post: <T = any>(path: string, body?: unknown, headers?: Record<string, string>) => Promise<RtpHttpResponse<T>>;
+    get: <T = any>(path: string, headers?: Record<string, string>) => Promise<RtpHttpResponse<T>>;
+}
+/** Key/value storage for persistence across cold starts and auth gates. */
+export interface RtpStorage {
+    getItem: (key: string) => Promise<string | null> | string | null;
+    setItem: (key: string, value: string) => Promise<void> | void;
+    removeItem: (key: string) => Promise<void> | void;
+}
+export interface RtpClientOptions {
+    /** Injected HTTP client. */
+    transport: RtpTransport;
+    /**
+     * Returns auth headers for an outgoing request. Called per request so the
+     * host can refresh tokens / compute MACs.
+     */
+    getAuthHeaders?: () => Promise<Record<string, string>> | Record<string, string>;
+    /**
+     * Returns the currently authenticated user's alias (phone/email), or null
+     * when logged out. Used for the auth gate and recipient matching.
+     */
+    getCurrentUser?: () => string | null | undefined;
+    /** Injectable clock (ms since epoch) for deterministic expiry tests. */
+    now?: () => number;
+    /** Optional sink for diagnostics. */
+    logger?: (...args: unknown[]) => void;
+    /** Endpoint base path for RTP routes. Defaults to `/rtp`. */
+    basePath?: string;
+}
+export type RtpUnsubscribe = () => void;
+export interface RtpEventMap {
+    request: (request: RtpRequest) => void;
+    state: (event: {
+        id: string;
+        status: RtpStatus;
+    }) => void;
+    result: (result: RtpResult) => void;
+}
+export interface RtpClient {
+    isRtp: (payload: unknown) => payload is RtpPayload;
+    receive: (payload: unknown) => Promise<RtpReceiveOutcome>;
+    resumeAuth: () => void;
+    accept: (params: {
+        id: string;
+        credential?: RtpCredential;
+    }) => Promise<RtpResult>;
+    decline: (params: {
+        id: string;
+        reason?: string;
+    }) => Promise<RtpResult>;
+    getStatus: (id: string) => RtpStatus | undefined;
+    getRequest: (id: string) => RtpRequest | undefined;
+    acknowledge: (id: string) => void;
+    on: <E extends keyof RtpEventMap>(event: E, handler: RtpEventMap[E]) => RtpUnsubscribe;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/validate.d.ts

@@ -0,0 +1,22 @@
+import type { RtpPayload, RtpRequest } from './types.js';
+/**
+ * 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 declare function isRtpPayload(payload: unknown): payload is RtpPayload;
+/**
+ * Returns the list of missing/invalid required fields. Empty array means the
+ * payload is structurally valid.
+ */
+export declare function findValidationErrors(payload: RtpPayload): string[];
+/** Map a validated payload into the normalized request held by the SDK. */
+export declare function toRtpRequest(payload: RtpPayload): RtpRequest;
+/** Pure expiry check. Re-evaluated on every transition, not just on receive. */
+export declare function isExpired(request: RtpRequest, now: number): boolean;
+//# sourceMappingURL=validate.d.ts.map

package/lib/typescript/src/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,UAAU,EAAE,UAAU,EAAE,MAAM,YAAS,CAAC;AAYhE;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,UAAU,CAMpE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,EAAE,CAyBlE;AAWD,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAY5D;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAMnE"}

package/package.json

@@ -1,6 +1,143 @@
 {
   "name": "@inno-isw/react-native-rtp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Request to Pay SDK for React Native",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "react-native-rtp-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-rtp-example",
+    "clean": "del-cli lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "request-to-pay",
+    "rtp",
+    "payments"
+  ],
+  "author": "Michael Chinweike",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^21.2.0",
+    "@eslint/compat": "^2.1.0",
+    "@eslint/eslintrc": "^3.3.6",
+    "@eslint/js": "^9.39.5",
+    "@jest/globals": "^29.7.0",
+    "@react-native/babel-preset": "0.86.2",
+    "@react-native/eslint-config": "0.86.2",
+    "@react-native/jest-preset": "0.86.2",
+    "@types/react": "^19.2.0",
+    "commitlint": "^21.2.1",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.5",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.6",
+    "jest": "^29.7.0",
+    "lefthook": "^2.1.10",
+    "prettier": "^3.9.6",
+    "react": "19.2.3",
+    "react-native": "0.86.3",
+    "react-native-builder-bob": "^0.43.2",
+    "turbo": "^2.10.8",
+    "typescript": "^6.0.3"
+  },
+  "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"
+        }
+      ]
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "@react-native/jest-preset",
+    "testEnvironmentOptions": {
+      "customExportConditions": [
+        "require",
+        "react-native",
+        "react-native-rtp-source"
+      ]
+    },
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "create-react-native-library": {
+    "type": "library",
+    "languages": "js",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook"
+    ],
+    "version": "0.63.1"
+  }
+}