@dpdpguard/react-native 0.0.0 → 1.0.0

package/README.md

@@ -9,17 +9,24 @@ https://github.com/dpdp-guard-ai/dpdpbot/blob/main/docs/specs/mobile-server-sdk.
 
 ## What's here vs. what's not
 
-This repo was scaffolded as a `create-react-native-library` turbo-module
-(`multiply()` native stub, Android/iOS native folders) intended to
-eventually bridge over native Android/iOS consent engines (ADR-005) — that
-native bridge is **not built yet**; it depends on the native
-`dpdpguard-android-sdk`/`dpdpguard-ios-sdk` consent engines (ADR-003)
-existing first, which they don't.
-
-What's implemented now is the **HTTP client layer**: a typed
+This repo was originally scaffolded as a `create-react-native-library`
+turbo-module (`multiply()` native stub, Android/iOS native folders) on the
+assumption it would eventually bridge over the native Android/iOS consent
+engines (ADR-005). That native bridge was never built, and on review it
+isn't the right shape for this package anyway: `dpdpguard-android-sdk` and
+`dpdpguard-ios-sdk` are separate, independently-versioned native libraries
+(ADR-003), and bridging to them would tie every RN release to whatever
+native SDK versions happen to be vendored alongside it, for no benefit —
+none of this SDK's functionality needs on-device native code. The
+turbo-module scaffold (native folders, `NativeReactNative.ts`,
+`multiply()`) has been removed.
+
+What's implemented instead is the **HTTP client layer**: a typed
 `DpdpGuardClient` over DPDP Guard's public `/api/v1` (spec §4.2), following
 the same pattern as `dpdpguard-server-sdk`/`dpdpguard-js-sdk` — usable
 today from RN app code via plain `fetch`, with no native module involved.
+This is also the pattern `dpdpguard-flutter-sdk` follows, for consistency
+across both hybrid SDKs.
 
 **Deliberately excluded, for security, not by omission:**
 
@@ -54,6 +61,17 @@ await client.createDsrRequest({ organizationId, type: 'erasure' });
 // Public reads need no auth at all.
 const org = await client.getOrganization('acme');
 const { notices } = await client.getNotices(org.orgId);
+
+// Recording consent from a banner shown *before* login (ADR-004 D6) needs
+// no auth either — just a client-generated anonymousId. Reconcile it into
+// the signed-in user's profile later with linkAnonymousConsent().
+await client.giveConsentAnonymous({
+  organizationId: org.orgId,
+  noticeId: notices[0]._id,
+  purpose: 'Analytics',
+  dataTypes: ['deviceId'],
+  anonymousId,
+});
 ```
 
 Every non-2xx response throws a `DpdpGuardApiError` with a `code` from the

package/package.json

@@ -1,49 +1,39 @@
 {
   "name": "@dpdpguard/react-native",
-  "version": "0.0.0",
-  "description": "DPDP Guard React Native SDK - bridge over the native Android/iOS consent engines",
+  "version": "1.0.0",
+  "description": "DPDP Guard React Native SDK - typed HTTP client over the DPDP Guard /api/v1 surface, usable via plain fetch (no native module)",
   "main": "src/index",
+  "files": [
+    "src",
+    "!src/**/*.test.ts",
+    "!src/generated",
+    "scripts/codegen.mjs"
+  ],
   "scripts": {
     "codegen": "node scripts/codegen.mjs",
     "postinstall": "node scripts/codegen.mjs",
     "test": "jest",
     "typecheck": "tsc --noEmit"
   },
-  "codegenConfig": {
-    "name": "ReactNativeSpec",
-    "type": "modules",
-    "jsSrcsDir": "src",
-    "android": {
-      "javaPackageName": "com.dpdpguard.reactnative"
-    }
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
   },
-  "author": " <> ()",
+  "author": "DPDP Guard",
   "license": "MIT",
-  "homepage": "#readme",
+  "homepage": "https://github.com/dpdp-guard-ai/dpdpguard-react-native-sdk#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dpdp-guard-ai/dpdpguard-react-native-sdk"
+  },
   "devDependencies": {
-    "@react-native/babel-preset": "0.85.0",
     "@types/jest": "^29.5.14",
     "@types/node": "^22.20.1",
-    "@types/react": "^19.2.0",
     "jest": "^29.7.0",
-    "react": "19.2.3",
-    "react-native": "0.85.0",
     "ts-jest": "^29.4.11",
     "typescript": "~5.8"
   },
-  "create-react-native-library": {
-    "type": "turbo-module",
-    "languages": "kotlin-objc",
-    "tools": [
-      "eslint",
-      "jest",
-      "lefthook",
-      "release-it",
-      "vite"
-    ],
-    "version": "0.63.0"
-  },
   "dependencies": {
-    "@dpdpguard/contract": "^0.2.0"
+    "@dpdpguard/contract": "^1.0.1"
   }
 }

package/src/client.ts

@@ -149,6 +149,33 @@ export class DpdpGuardClient {
 		});
 	}
 
+	/**
+	 * Records consent for a not-yet-authenticated guest (ADR-004 D6), e.g.
+	 * from a consent banner shown before login. Unauthenticated, rate-limited
+	 * public write, keyed by a client-generated `anonymousId`.
+	 */
+	giveConsentAnonymous(
+		input: {
+			organizationId: string;
+			noticeId: string;
+			purpose: string;
+			dataTypes: string[];
+			anonymousId: string;
+		},
+		idempotencyKey?: string,
+	): Promise<{
+		consentId: string;
+		purpose: string;
+		dataTypes: string[];
+		givenAt: number;
+	}> {
+		const options: RequestOptions = { body: input, auth: "none" };
+		if (idempotencyKey !== undefined) {
+			options.headers = { "Idempotency-Key": idempotencyKey };
+		}
+		return this.request("POST", "/api/v1/consents/anonymous", options);
+	}
+
 	// --- DSR (spec §4.2) ---
 
 	listDsrRequests(): Promise<{ requests: DsrRequest[] }> {

package/src/{index.tsx → index.ts}

@@ -1,5 +1,3 @@
-export { multiply } from './multiply';
-
 export { DpdpGuardClient } from './client';
 export type { DpdpGuardClientOptions } from './client';
 export { DpdpGuardApiError, ERROR_CATALOG } from './errorCatalog';

package/.github/workflows/ci.yml

@@ -1,15 +0,0 @@
-name: CI
-on: [push, pull_request]
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with: { node-version: 20 }
-      # npm install runs codegen via postinstall (scripts/codegen.mjs), which
-      # regenerates src/generated/api-types.ts from the installed
-      # @dpdpguard/contract's openapi/v1.yaml.
-      - run: npm install
-      - run: npm run typecheck
-      - run: npm test

package/ReactNative.podspec

@@ -1,20 +0,0 @@
-require "json"
-
-package = JSON.parse(File.read(File.join(__dir__, "package.json")))
-
-Pod::Spec.new do |s|
-  s.name         = "ReactNative"
-  s.version      = package["version"]
-  s.summary      = package["description"]
-  s.homepage     = package["homepage"]
-  s.license      = package["license"]
-  s.authors      = package["author"]
-
-  s.platforms    = { :ios => min_ios_version_supported }
-  s.source       = { :git => ".git", :tag => "#{s.version}" }
-
-  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
-  s.private_header_files = "ios/**/*.h"
-
-  install_modules_dependencies(s)
-end

package/android/build.gradle

@@ -1,51 +0,0 @@
-buildscript {
-  ext.ReactNative = [
-    kotlinVersion: "2.0.21",
-    minSdkVersion: 24,
-    compileSdkVersion: 36
-  ]
-
-  ext.getExtOrDefault = { prop ->
-    if (rootProject.ext.has(prop)) {
-      return rootProject.ext.get(prop)
-    }
-
-    return ReactNative[prop]
-  }
-
-  repositories {
-    google()
-    mavenCentral()
-  }
-
-  dependencies {
-    classpath "com.android.tools.build:gradle:8.7.2"
-    // noinspection DifferentKotlinGradleVersion
-    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
-  }
-}
-
-
-apply plugin: "com.android.library"
-apply plugin: "kotlin-android"
-
-apply plugin: "com.facebook.react"
-
-android {
-  namespace "com.dpdpguard.reactnative"
-
-  compileSdkVersion getExtOrDefault("compileSdkVersion")
-
-  defaultConfig {
-    minSdkVersion getExtOrDefault("minSdkVersion")
-  }
-
-  compileOptions {
-    sourceCompatibility JavaVersion.VERSION_17
-    targetCompatibility JavaVersion.VERSION_17
-  }
-}
-
-dependencies {
-  implementation "com.facebook.react:react-android"
-}

package/android/src/main/AndroidManifest.xml

@@ -1,2 +0,0 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
-</manifest>

package/android/src/main/java/com/dpdpguard/reactnative/ReactNativeModule.kt

@@ -1,15 +0,0 @@
-package com.dpdpguard.reactnative
-
-import com.facebook.react.bridge.ReactApplicationContext
-
-class ReactNativeModule(reactContext: ReactApplicationContext) :
-  NativeReactNativeSpec(reactContext) {
-
-  override fun multiply(a: Double, b: Double): Double {
-    return a * b
-  }
-
-  companion object {
-    const val NAME = NativeReactNativeSpec.NAME
-  }
-}

package/android/src/main/java/com/dpdpguard/reactnative/ReactNativePackage.kt

@@ -1,31 +0,0 @@
-package com.dpdpguard.reactnative
-
-import com.facebook.react.BaseReactPackage
-import com.facebook.react.bridge.NativeModule
-import com.facebook.react.bridge.ReactApplicationContext
-import com.facebook.react.module.model.ReactModuleInfo
-import com.facebook.react.module.model.ReactModuleInfoProvider
-import java.util.HashMap
-
-class ReactNativePackage : BaseReactPackage() {
-  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
-    return if (name == ReactNativeModule.NAME) {
-      ReactNativeModule(reactContext)
-    } else {
-      null
-    }
-  }
-
-  override fun getReactModuleInfoProvider() = ReactModuleInfoProvider {
-    mapOf(
-      ReactNativeModule.NAME to ReactModuleInfo(
-        name = ReactNativeModule.NAME,
-        className = ReactNativeModule.NAME,
-        canOverrideExistingModule = false,
-        needsEagerInit = false,
-        isCxxModule = false,
-        isTurboModule = true
-      )
-    )
-  }
-}

package/example/.bundle/config

@@ -1,2 +0,0 @@
-BUNDLE_PATH: "vendor/bundle"
-BUNDLE_FORCE_RUBY_PLATFORM: 1

package/example/.watchmanconfig

@@ -1 +0,0 @@
-{}

package/example/Gemfile

@@ -1,17 +0,0 @@
-source 'https://rubygems.org'
-
-# You may use http://rbenv.org/ or https://rvm.io/ to install and use this version
-ruby ">= 2.6.10"
-
-# Exclude problematic versions of cocoapods and activesupport that causes build failures.
-gem 'cocoapods', '>= 1.13', '!= 1.15.0', '!= 1.15.1'
-gem 'activesupport', '>= 6.1.7.5', '!= 7.1.0'
-gem 'xcodeproj', '< 1.26.0'
-gem 'concurrent-ruby', '< 1.3.4'
-
-# Ruby 3.4.0 has removed some libraries from the standard library.
-gem 'bigdecimal'
-gem 'logger'
-gem 'benchmark'
-gem 'mutex_m'
-gem 'nkf'

package/example/README.md

@@ -1,97 +0,0 @@
-This is a new [**React Native**](https://reactnative.dev) project, bootstrapped using [`@react-native-community/cli`](https://github.com/react-native-community/cli).
-
-# Getting Started
-
-> **Note**: Make sure you have completed the [Set Up Your Environment](https://reactnative.dev/docs/set-up-your-environment) guide before proceeding.
-
-## Step 1: Start Metro
-
-First, you will need to run **Metro**, the JavaScript build tool for React Native.
-
-To start the Metro dev server, run the following command from the root of your React Native project:
-
-```sh
-# Using npm
-npm start
-
-# OR using Yarn
-yarn start
-```
-
-## Step 2: Build and run your app
-
-With Metro running, open a new terminal window/pane from the root of your React Native project, and use one of the following commands to build and run your Android or iOS app:
-
-### Android
-
-```sh
-# Using npm
-npm run android
-
-# OR using Yarn
-yarn android
-```
-
-### iOS
-
-For iOS, remember to install CocoaPods dependencies (this only needs to be run on first clone or after updating native deps).
-
-The first time you create a new project, run the Ruby bundler to install CocoaPods itself:
-
-```sh
-bundle install
-```
-
-Then, and every time you update your native dependencies, run:
-
-```sh
-bundle exec pod install
-```
-
-For more information, please visit [CocoaPods Getting Started guide](https://guides.cocoapods.org/using/getting-started.html).
-
-```sh
-# Using npm
-npm run ios
-
-# OR using Yarn
-yarn ios
-```
-
-If everything is set up correctly, you should see your new app running in the Android Emulator, iOS Simulator, or your connected device.
-
-This is one way to run your app — you can also build it directly from Android Studio or Xcode.
-
-## Step 3: Modify your app
-
-Now that you have successfully run the app, let's make changes!
-
-Open `App.tsx` in your text editor of choice and make some changes. When you save, your app will automatically update and reflect these changes — this is powered by [Fast Refresh](https://reactnative.dev/docs/fast-refresh).
-
-When you want to forcefully reload, for example to reset the state of your app, you can perform a full reload:
-
-- **Android**: Press the <kbd>R</kbd> key twice or select **"Reload"** from the **Dev Menu**, accessed via <kbd>Ctrl</kbd> + <kbd>M</kbd> (Windows/Linux) or <kbd>Cmd ⌘</kbd> + <kbd>M</kbd> (macOS).
-- **iOS**: Press <kbd>R</kbd> in iOS Simulator.
-
-## Congratulations! :tada:
-
-You've successfully run and modified your React Native App. :partying_face:
-
-### Now what?
-
-- If you want to add this new React Native code to an existing application, check out the [Integration guide](https://reactnative.dev/docs/integration-with-existing-apps).
-- If you're curious to learn more about React Native, check out the [docs](https://reactnative.dev/docs/getting-started).
-
-# Troubleshooting
-
-If you're having issues getting the above steps to work, see the [Troubleshooting](https://reactnative.dev/docs/troubleshooting) page.
-
-# Learn More
-
-To learn more about React Native, take a look at the following resources:
-
-- [React Native Website](https://reactnative.dev) - learn more about React Native.
-- [Getting Started](https://reactnative.dev/docs/environment-setup) - an **overview** of React Native and how setup your environment.
-- [Learn the Basics](https://reactnative.dev/docs/getting-started) - a **guided tour** of the React Native **basics**.
-- [Blog](https://reactnative.dev/blog) - read the latest official React Native **Blog** posts.
-- [`@facebook/react-native`](https://github.com/facebook/react-native) - the Open Source; GitHub **repository** for React Native.

package/example/android/app/build.gradle

@@ -1,119 +0,0 @@
-apply plugin: "com.android.application"
-apply plugin: "org.jetbrains.kotlin.android"
-apply plugin: "com.facebook.react"
-
-/**
- * This is the configuration block to customize your React Native Android app.
- * By default you don't need to apply any configuration, just uncomment the lines you need.
- */
-react {
-    /* Folders */
-    //   The root of your project, i.e. where "package.json" lives. Default is '../..'
-    // root = file("../../")
-    //   The folder where the react-native NPM package is. Default is ../../node_modules/react-native
-    // reactNativeDir = file("../../node_modules/react-native")
-    //   The folder where the react-native Codegen package is. Default is ../../node_modules/@react-native/codegen
-    // codegenDir = file("../../node_modules/@react-native/codegen")
-    //   The cli.js file which is the React Native CLI entrypoint. Default is ../../node_modules/react-native/cli.js
-    // cliFile = file("../../node_modules/react-native/cli.js")
-
-    /* Variants */
-    //   The list of variants to that are debuggable. For those we're going to
-    //   skip the bundling of the JS bundle and the assets. Default is "debug", "debugOptimized".
-    //   If you add flavors like lite, prod, etc. you'll have to list your debuggableVariants.
-    // debuggableVariants = ["liteDebug", "liteDebugOptimized", "prodDebug", "prodDebugOptimized"]
-
-    /* Bundling */
-    //   A list containing the node command and its flags. Default is just 'node'.
-    // nodeExecutableAndArgs = ["node"]
-    //
-    //   The command to run when bundling. By default is 'bundle'
-    // bundleCommand = "ram-bundle"
-    //
-    //   The path to the CLI configuration file. Default is empty.
-    // bundleConfig = file(../rn-cli.config.js)
-    //
-    //   The name of the generated asset file containing your JS bundle
-    // bundleAssetName = "MyApplication.android.bundle"
-    //
-    //   The entry file for bundle generation. Default is 'index.android.js' or 'index.js'
-    // entryFile = file("../js/MyApplication.android.js")
-    //
-    //   A list of extra flags to pass to the 'bundle' commands.
-    //   See https://github.com/react-native-community/cli/blob/main/docs/commands.md#bundle
-    // extraPackagerArgs = []
-
-    /* Hermes Commands */
-    //   The hermes compiler command to run. By default it is 'hermesc'
-    // hermesCommand = "$rootDir/my-custom-hermesc/bin/hermesc"
-    //
-    //   The list of flags to pass to the Hermes compiler. By default is "-O", "-output-source-map"
-    // hermesFlags = ["-O", "-output-source-map"]
-
-    /* Autolinking */
-    autolinkLibrariesWithApp()
-}
-
-/**
- * Set this to true to Run Proguard on Release builds to minify the Java bytecode.
- */
-def enableProguardInReleaseBuilds = false
-
-/**
- * The preferred build flavor of JavaScriptCore (JSC)
- *
- * For example, to use the international variant, you can use:
- * `def jscFlavor = io.github.react-native-community:jsc-android-intl:2026004.+`
- *
- * The international variant includes ICU i18n library and necessary data
- * allowing to use e.g. `Date.toLocaleString` and `String.localeCompare` that
- * give correct results when using with locales other than en-US. Note that
- * this variant is about 6MiB larger per architecture than default.
- */
-def jscFlavor = 'io.github.react-native-community:jsc-android:2026004.+'
-
-android {
-    ndkVersion rootProject.ext.ndkVersion
-    buildToolsVersion rootProject.ext.buildToolsVersion
-    compileSdk rootProject.ext.compileSdkVersion
-
-    namespace "dpdpguard.reactnative.example"
-    defaultConfig {
-        applicationId "dpdpguard.reactnative.example"
-        minSdkVersion rootProject.ext.minSdkVersion
-        targetSdkVersion rootProject.ext.targetSdkVersion
-        versionCode 1
-        versionName "1.0"
-    }
-    signingConfigs {
-        debug {
-            storeFile file('debug.keystore')
-            storePassword 'android'
-            keyAlias 'androiddebugkey'
-            keyPassword 'android'
-        }
-    }
-    buildTypes {
-        debug {
-            signingConfig signingConfigs.debug
-        }
-        release {
-            // Caution! In production, you need to generate your own keystore file.
-            // see https://reactnative.dev/docs/signed-apk-android.
-            signingConfig signingConfigs.debug
-            minifyEnabled enableProguardInReleaseBuilds
-            proguardFiles getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro"
-        }
-    }
-}
-
-dependencies {
-    // The version of react-native is set by the React Native Gradle Plugin
-    implementation("com.facebook.react:react-android")
-
-    if (hermesEnabled.toBoolean()) {
-        implementation("com.facebook.react:hermes-android")
-    } else {
-        implementation jscFlavor
-    }
-}

package/example/android/app/proguard-rules.pro

@@ -1,10 +0,0 @@
-# Add project specific ProGuard rules here.
-# By default, the flags in this file are appended to flags specified
-# in /usr/local/Cellar/android-sdk/24.3.3/tools/proguard/proguard-android.txt
-# You can edit the include path and order by changing the proguardFiles
-# directive in build.gradle.
-#
-# For more details, see
-#   http://developer.android.com/guide/developing/tools/proguard.html
-
-# Add any project specific keep options here:

package/example/android/app/src/main/AndroidManifest.xml

@@ -1,27 +0,0 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
-
-    <uses-permission android:name="android.permission.INTERNET" />
-
-    <application
-      android:name=".MainApplication"
-      android:label="@string/app_name"
-      android:icon="@mipmap/ic_launcher"
-      android:roundIcon="@mipmap/ic_launcher_round"
-      android:allowBackup="false"
-      android:theme="@style/AppTheme"
-      android:usesCleartextTraffic="${usesCleartextTraffic}"
-      android:supportsRtl="true">
-      <activity
-        android:name=".MainActivity"
-        android:label="@string/app_name"
-        android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
-        android:launchMode="singleTask"
-        android:windowSoftInputMode="adjustResize"
-        android:exported="true">
-        <intent-filter>
-            <action android:name="android.intent.action.MAIN" />
-            <category android:name="android.intent.category.LAUNCHER" />
-        </intent-filter>
-      </activity>
-    </application>
-</manifest>

package/example/android/app/src/main/java/com/dpdpguard.reactnative.example/MainActivity.kt

@@ -1,22 +0,0 @@
-package dpdpguard.reactnative.example
-
-import com.facebook.react.ReactActivity
-import com.facebook.react.ReactActivityDelegate
-import com.facebook.react.defaults.DefaultNewArchitectureEntryPoint.fabricEnabled
-import com.facebook.react.defaults.DefaultReactActivityDelegate
-
-class MainActivity : ReactActivity() {
-
-  /**
-   * Returns the name of the main component registered from JavaScript. This is used to schedule
-   * rendering of the component.
-   */
-  override fun getMainComponentName(): String = "ReactNativeExample"
-
-  /**
-   * Returns the instance of the [ReactActivityDelegate]. We use [DefaultReactActivityDelegate]
-   * which allows you to enable New Architecture with a single boolean flags [fabricEnabled]
-   */
-  override fun createReactActivityDelegate(): ReactActivityDelegate =
-      DefaultReactActivityDelegate(this, mainComponentName, fabricEnabled)
-}

package/example/android/app/src/main/java/com/dpdpguard.reactnative.example/MainApplication.kt

@@ -1,27 +0,0 @@
-package dpdpguard.reactnative.example
-
-import android.app.Application
-import com.facebook.react.PackageList
-import com.facebook.react.ReactApplication
-import com.facebook.react.ReactHost
-import com.facebook.react.ReactNativeApplicationEntryPoint.loadReactNative
-import com.facebook.react.defaults.DefaultReactHost.getDefaultReactHost
-
-class MainApplication : Application(), ReactApplication {
-
-  override val reactHost: ReactHost by lazy {
-    getDefaultReactHost(
-      context = applicationContext,
-      packageList =
-        PackageList(this).packages.apply {
-          // Packages that cannot be autolinked yet can be added manually here, for example:
-          // add(MyReactNativePackage())
-        },
-    )
-  }
-
-  override fun onCreate() {
-    super.onCreate()
-    loadReactNative(this)
-  }
-}