@tinkerlandai/indiana-react-native 0.0.0-stage → 0.6.4

package/README.md

@@ -1,3 +1,53 @@
-# Temporary Holding Version
+# Indiana React Native SDK
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Customer identity, holdings, entitlement checks and backend-mediated usage reporting for React Native 0.79+ / Metro 0.82+. This independent npm package uses Fetch and AbortController. It needs no DOM, WebView, native linking or React peer dependency. It does not include store purchases or Funnel native UI.
+
+Install the exact package version:
+
+```sh
+npm install --save-exact @tinkerlandai/indiana-react-native@0.6.4
+```
+
+```ts
+import { createIndianaReactNative } from "@tinkerlandai/indiana-react-native";
+
+const indiana = createIndianaReactNative({
+  scope: { projectId: "YOUR_APP_UUID", environment: "sandbox" },
+  baseUrl: "https://api.dev.tinker.cash",
+  usageReporter: async (command) => {
+    const response = await fetch("https://your-app.example/api/usage", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${yourAppSessionToken}`,
+      },
+      body: JSON.stringify(command),
+    });
+    if (!response.ok) throw new Error("Usage reporting failed");
+    return response.json();
+  },
+});
+
+// Your backend issues a Customer Token for its authenticated app user.
+indiana.identify(customerToken);
+const holdings = await indiana.readHoldings();
+const entitlement = await indiana.checkEntitlement({
+  requirement: {
+    internal_feature_id: "YOUR_FEATURE_UUID",
+    quantity: "1",
+    properties: {},
+  },
+});
+await indiana.trackUsage({
+  eventName: "images",
+  quantity: "1",
+  idempotencyKey: "stable-id-for-this-usage-event",
+});
+indiana.reset();
+```
+
+Never ship a Server Key in the app. `usageReporter` receives only a validated usage command. Your backend authenticates its own app session, selects the Customer and invokes the server SDK with its Server Key; return that SDK's complete usage response unchanged. Preserve the event's idempotency key across retries. The SDK validates response schema and App/environment and rejects results if identity changes while reporting. The callback owns its network timeout and retry policy.
+
+Credentials stay in memory. Call `reset()` at logout. Customer creation and token issuance belong on your backend. The existing `@tinkerlandai/indiana-sdk/react-native` subpath uses the same source implementation; install only one entry in an application.
+
+Package versions use the shared `sdk-vX.Y.Z` release. The package includes ESM, CommonJS and TypeScript declarations and a portable URL parser for React Native hosts whose built-in URL is incomplete. It does not replace application globals; its only runtime dependency is Zod. See the repository's [mobile integration guide](https://github.com/tinkerlandai/Indiana/blob/main/docs/mobile-sdk.md) and [release commands](https://github.com/tinkerlandai/Indiana/blob/main/docs/automated-releases.md).

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,27 @@
+# whatwg-url-minimum 0.2.0
+
+Bundled URL implementation from https://github.com/expo/whatwg-url-minimum.
+
+MIT License
+
+Copyright (c) Phil Pluckthun,
+Copyright (c) 650 Industries, Inc. (aka Expo),
+Copyright (c) Sebastian Mayr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.