@consentera/react-native-consent 2.0.0

package/package.json

@@ -0,0 +1,130 @@
+{
+  "name": "@consentera/react-native-consent",
+  "version": "2.0.0",
+  "description": "Consentera Consent SDK for React Native \u2014 DPDP Act 2023 compliant consent collection",
+  "main": "lib/commonjs/index",
+  "module": "lib/module/index",
+  "types": "lib/typescript/src/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "files": [
+    "src",
+    "lib",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "npm run --workspace @consentera/react-native-consent-example",
+    "test": "jest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "clean": "del-cli android/build lib",
+    "prepare": "bob build"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "consent",
+    "privacy",
+    "dpdp",
+    "india",
+    "consentera"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/consentera-platform/consentera-sdks.git",
+    "directory": "react-native"
+  },
+  "author": "ConsentEra <sdk@consentera.in>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/consentera-platform/consentera-sdks/issues"
+  },
+  "homepage": "https://github.com/consentera-platform/consentera-sdks/tree/main/react-native#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^18.4.3",
+    "@evilmartians/lefthook": "^1.5.5",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^18.3.12",
+    "commitlint": "^18.4.3",
+    "del-cli": "^5.1.0",
+    "eslint": "^9.14.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.1.2",
+    "jest": "^29.7.0",
+    "prettier": "^3.3.3",
+    "react": "18.3.1",
+    "react-native": "0.76.5",
+    "react-native-builder-bob": "^0.23.2",
+    "typescript": "^5.6.3",
+    "@eslint/js": "^9.14.0",
+    "typescript-eslint": "^8.13.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.2.0",
+    "react-native": ">=0.73.0"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./lib/typescript/src/index.d.ts",
+      "react-native": "./src/index.ts",
+      "import": "./lib/module/index.js",
+      "require": "./lib/commonjs/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "peerDependenciesMeta": {
+    "react-native-inappbrowser-reborn": {
+      "optional": true
+    },
+    "react-native-get-random-values": {
+      "optional": true
+    }
+  }
+}

package/src/gate.ts

@@ -0,0 +1,81 @@
+import type { ConsenteraSession, PrincipalRef } from './session';
+
+/**
+ * ConsentGate — the mobile equivalent of cookie consent (RN twin of the
+ * Android SDK's gate package). Gate third-party SDKs (analytics, ads,
+ * attribution) and advertising identifiers on the DP's live consent state:
+ * `init` runs only after the purpose validates ALLOW; `revoke` runs when a
+ * previously-allowed purpose stops validating (stop the SDK, flush queues,
+ * clear stored identifiers). Never "initialize then opt out".
+ *
+ * Call refresh() on app start and whenever the app returns to the foreground
+ * (AppState 'active') — the deep-link callback is best-effort only.
+ */
+export interface Tracker {
+  purposeCode: string;
+  name: string;
+  init: () => void;
+  revoke: () => void;
+}
+
+export interface GateState {
+  name: string;
+  purposeCode: string;
+  allowed: boolean;
+}
+
+export class ConsentGate {
+  private trackers: Tracker[] = [];
+  private started = new Set<string>();
+  private listeners = new Set<(states: GateState[]) => void>();
+  states: GateState[] = [];
+
+  /**
+   * @param who the person this gate is about, in the ONE shape the lifecycle
+   *   roads accept. It was a bare `dataPrincipalRef: string` until 2026-09-22,
+   *   which no longer type-checked against `validate` (tsc: "Argument of type
+   *   'string' is not assignable to parameter of type 'PrincipalRef'") and could
+   *   not express the identifiers the API now requires.
+   */
+  constructor(private session: ConsenteraSession, private who: PrincipalRef) {}
+
+  register(tracker: Tracker): void {
+    this.trackers.push(tracker);
+    this.states = [...this.states, { name: tracker.name, purposeCode: tracker.purposeCode, allowed: false }];
+  }
+
+  onChange(fn: (states: GateState[]) => void): () => void {
+    this.listeners.add(fn);
+    return () => this.listeners.delete(fn);
+  }
+
+  /** Re-validate every registered purpose; fail-closed on errors. */
+  async refresh(): Promise<GateState[]> {
+    const next: GateState[] = [];
+    for (const t of this.trackers) {
+      let allowed = false;
+      try {
+        const d = await this.session.validate(this.who, t.purposeCode);
+        allowed = (d.decision ?? '').toUpperCase() === 'ALLOW';
+      } catch {
+        allowed = false;
+      }
+      const wasStarted = this.started.has(t.name);
+      if (allowed && !wasStarted) {
+        try { t.init(); } catch { /* tracker init must never crash the app */ }
+        this.started.add(t.name);
+      } else if (!allowed && wasStarted) {
+        try { t.revoke(); } catch { /* ditto */ }
+        this.started.delete(t.name);
+      }
+      next.push({ name: t.name, purposeCode: t.purposeCode, allowed });
+    }
+    this.states = next;
+    this.listeners.forEach((fn) => fn(next));
+    return next;
+  }
+
+  isAllowed(purposeCode: string): boolean {
+    return this.states.some((s) => s.purposeCode === purposeCode && s.allowed);
+  }
+}

package/src/index.ts

@@ -0,0 +1,50 @@
+/**
+ * @consentera/react-native-consent — DPDP consent for React Native apps.
+ *
+ * Reoriented 2026-07-20 to the proven hosted-collect session flow (the old
+ * native-module cookie/ad-category model targeted a phantom /v1/sdk/* API and
+ * could never collect DPDP consent — see ../MOBILE-P0-FINDINGS.md).
+ *
+ * Pure JS — no native module, no pod install, works in any RN app:
+ *   const session = new ConsenteraSession({ backendBaseUrl, callbackScheme });
+ *   const s = await session.createSession({ dataPrincipalRef, noticeInternalName });
+ *   session.presentConsent(s.consent_url);       // hosted page in the browser
+ *   // on AppState 'active': re-validate (deep link is best-effort)
+ *   const d = await session.validate(dataPrincipalRef, 'product_analytics');
+ *   await session.withdraw(dataPrincipalRef, ['product_analytics']);
+ *   await session.openPortal(dataPrincipalRef);        // full DP portal, one tap
+ *
+ * ConsentGate = the mobile equivalent of cookie consent: register each
+ * third-party SDK with init/revoke hooks; refresh() starts/stops them on the
+ * live consent state.
+ */
+export {
+  ConsenteraSession,
+  ConsenteraError,
+  SDK_VERSION,
+  SDK_IDENTIFIER,
+  SDK_USER_AGENT,
+  setInAppBrowser,
+  resolveInAppBrowser,
+  newCallbackState,
+  parseRetryAfter,
+  callbackUrlFor,
+  callbackStatusOf,
+  portalIdentifier,
+  readErrorEnvelope,
+} from './session';
+export type {
+  SessionConfig,
+  ConsentSession,
+  ConsentCallback,
+  CallbackStatus,
+  ConsentDecision,
+  PortalSession,
+  CreateSessionRequest,
+  PrincipalRef,
+  DataPrincipalIdentifiers,
+  GuardianVerificationPending,
+  InAppBrowserAdapter,
+} from './session';
+export { ConsentGate } from './gate';
+export type { Tracker, GateState } from './gate';