@latchway/react-native 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -7,6 +7,31 @@ Versioning once package publication begins.
 
 ## [Unreleased]
 
+## [1.1.0] - 2026-09-07
+
+### Added
+
+- Explicit `@latchway/react-native/polyfills` bootstrap for Hermes async symbols,
+  streaming UTF-8 decoding, web streams, URL and abort compatibility. Complete
+  existing globals are retained; the ordinary SDK import does not install it.
+- Optional `withLatchwayBabel` configuration helper for LangChain class and
+  export-namespace compatibility without depending on LangChain at runtime.
+- Standalone npm-only LatchwayChat with Firebase authentication, temporary
+  multi-turn LangChain weather tools, direct fetch, cancellation and diagnostics.
+- Isolated runtime regressions and a LangChain quickstart.
+
+### Fixed
+
+- Metro now resolves the published built JavaScript entry without a custom
+  `.js`-to-TypeScript resolver. Native Codegen retains its original TS schema.
+
+### Compatibility
+
+- Shared client, iOS App Attest and Android SDK dependencies remain 1.0.0;
+  the native authentication/credential boundary and wire protocol are unchanged.
+- Supported baseline remains React Native 0.82 / New Architecture. Android
+  physical Play Integrity evidence is deferred, not inferred from a build.
+
 ## [1.0.0] - 2026-09-01
 
 ### Changed

package/README.md

@@ -2,7 +2,14 @@
 
 `@latchway/react-native` gives iOS and Android applications one fetch-shaped API for a self-hosted Latchway gateway. The JavaScript layer never accepts an upstream AI-provider key. P-256 installation keys, DPoP signing, refresh-token storage, and platform attestation stay in the native Latchway SDKs.
 
-> **Release status:** `1.0.0` is the intended stable source candidate, but has not yet been published. Use a workspace dependency or the archive produced by `pnpm pack:check`; do not assume an npm or native artifact exists until the release is announced.
+Version 1.1.0 adds an optional [LangChain quickstart](docs/langchain.md), runtime
+bootstrap and Babel helper, with standard Metro resolution. Native SDK
+dependencies remain 1.0.0 from CocoaPods and Maven Central.
+
+For a standalone npm-only consumer with Firebase login, LangChain weather tools,
+streaming chat and direct-fetch Settings, see
+[LatchwayChat](Examples/LatchwayChat/README.md). The existing `example/` remains
+the separate workspace/conformance application.
 
 ## Requirements
 

package/babel.cjs

@@ -0,0 +1,22 @@
+/** Opt-in compiler compatibility for LangChain on the supported RN baseline. */
+function withLatchwayBabel(config = {}) {
+  if (config.assumptions?.noClassCalls === false) {
+    throw new Error("LangChain on React Native requires assumptions.noClassCalls=true. Remove the conflicting assumption.");
+  }
+  const namespacePlugin = require.resolve("@babel/plugin-transform-export-namespace-from");
+  const plugins = config.plugins ?? [];
+  const hasNamespacePlugin = plugins.some((entry) => {
+    const plugin = Array.isArray(entry) ? entry[0] : entry;
+    return plugin === namespacePlugin || plugin === "@babel/plugin-transform-export-namespace-from";
+  });
+  return {
+    ...config,
+    // LangChain's Symbol.hasInstance reads fields initialized by super(). The
+    // Babel pre-constructor instanceof assertion runs too early. Classes must
+    // still be called with new; LangChain's own type checks remain unchanged.
+    assumptions: { ...config.assumptions, noClassCalls: true },
+    plugins: hasNamespacePlugin ? [...plugins] : [namespacePlugin, ...plugins],
+  };
+}
+
+module.exports = { withLatchwayBabel };

package/babel.d.cts

@@ -0,0 +1,7 @@
+interface BabelConfiguration {
+  assumptions?: Record<string, boolean>;
+  plugins?: unknown[];
+  [key: string]: unknown;
+}
+/** Preserves existing configuration and adds explicit LangChain compatibility. */
+export function withLatchwayBabel(config?: BabelConfiguration): BabelConfiguration;

package/docs/langchain.md

@@ -0,0 +1,135 @@
+# LangChain on React Native
+
+Use `@latchway/react-native@1.1.0` for native authenticated transport and
+`@latchway/langchain@1.1.0` for the optional LangChain adapter. No provider key
+belongs in the application. Secure Enclave/Keystore, App Attest/Play Integrity,
+DPoP and refresh credentials stay native.
+
+## Install
+
+The tested baseline is React Native 0.82 / React 19.1, New Architecture:
+
+```sh
+npm install --save-exact @latchway/react-native@1.1.0 @latchway/langchain@1.1.0 \
+  @latchway/client@1.0.0 @langchain/core@1.2.9 @langchain/openai@1.5.10 openai@7.8.0
+cd ios && pod install && cd ..
+```
+
+Keep the lockfile. LangChain is not a dependency of the base React Native SDK.
+The native dependencies remain the public iOS/Android SDKs 1.0.0. Normal native
+signing, Firebase/other identity and gateway platform policy setup still applies.
+
+## Two explicit setup lines
+
+Put the bootstrap **first** in the application entrypoint, before importing
+React Native, Latchway, LangChain or any stream-dependent application module:
+
+```js
+import '@latchway/react-native/polyfills';
+import {AppRegistry} from 'react-native';
+import App from './App';
+```
+
+Use the optional compiler helper in `babel.config.js`:
+
+```js
+const {withLatchwayBabel} = require('@latchway/react-native/babel');
+module.exports = withLatchwayBabel({
+  presets: ['module:@react-native/babel-preset'],
+});
+```
+
+Use standard Metro; no resolver override, source alias or local SDK link is
+needed. Rebuild the native app after installation. Clear Metro's cache if it
+still resolves the old 1.0.0 source entry.
+
+The bootstrap installs missing async symbols before stream dependencies,
+incremental UTF-8 decoding, web streams, random values and abort compatibility.
+It only replaces URL when a capability probe fails, preserves working globals,
+and never replaces fetch or native security. The standard SDK import does not
+initialize globals. The decoder currently uses the pinned, deprecated
+`text-encoding@0.7.0` implementation for incremental decoding; this is a known
+maintenance dependency, not a claim of comprehensive runtime compatibility.
+
+The Babel helper enables `noClassCalls` and the export-namespace transform while
+preserving the rest of your config. Classes must still be constructed with
+`new`; LangChain's own type checks are not removed.
+
+## Create a model
+
+Create `latchway` using the ordinary SDK configuration and your current user's
+identity-token callback. Then pass that client directly—no transport wrapper:
+
+```ts
+import {createLatchwayResponsesModel} from '@latchway/langchain';
+
+const model = createLatchwayResponsesModel({
+  latchway,
+  feature: 'assistant',
+  reasoning: {effort: 'none'}, // only if your configured model supports this
+  chatOptions: {maxTokens: 1024},
+});
+const controller = new AbortController();
+for await (const chunk of await model.stream('Explain Latchway', {
+  signal: controller.signal,
+})) {
+  // Render text chunks; retain original messages for usage/callback metadata.
+}
+// controller.abort() cancels native networking too.
+```
+
+The feature must route `openai_responses`, with the matching trusted accounting
+profile, on gateway 1.0.2+. The server selects the physical model. The helper
+does not guess reasoning capabilities from the placeholder model alias: omit
+`reasoning` for routes that do not accept it. Stateless storage settings do not
+guarantee retention behavior across all upstream providers.
+
+For an `openai_chat` feature use the existing `createLatchwayChatOpenAI` instead.
+Both factories default to no automatic framework retries. Native pre-dispatch
+session recovery is separate; uncertain provider dispatches must not be replayed
+casually. Explicit `chatOptions.maxRetries` is an application policy choice.
+
+## Tools and local history
+
+```ts
+import {bindLatchwayTools, toLatchwayReplayMessage} from '@latchway/langchain';
+import {HumanMessage, type BaseMessage} from '@langchain/core/messages';
+
+// weather is your ordinary LangChain tool; the SDK never executes tools for you.
+const modelWithTools = bindLatchwayTools(model, [weather]);
+const history: BaseMessage[] = [new HumanMessage('Weather in Singapore?')];
+const answer = await modelWithTools.invoke(history);
+const replay = toLatchwayReplayMessage(answer);
+history.push(replay);
+// Dispatch only an allowlisted tool with validated arguments. Append the
+// returned ToolMessage, preserving the model's tool_call_id, then invoke again.
+```
+
+The binding helper
+defaults to `strict:true` and `parallel_tool_calls:false`; ordinary LangChain
+options can override these deliberately. Supply strict-compatible schemas
+(all required fields, `additionalProperties:false`; nullable instead of optional
+properties when necessary).
+
+Use `toLatchwayReplayMessage` only after a successful complete response (or
+aggregating all stream chunks). It preserves text and function-call IDs while
+removing provider item IDs and observational metadata. It rejects non-text,
+opaque reasoning/refusal, malformed calls and duplicate IDs. Keep the original
+message separately for usage information. Do not save failed/partial turns as
+history. The helper does not store history, execute tools or enforce loop limits.
+
+Set explicit tool-call limits, timeouts, cancellation and history bounds in your
+app. Standard LangChain `withStructuredOutput(..., {method:'jsonSchema', strict:true})`
+is available when the gateway route/model supports the schema.
+
+## Example and evidence
+
+The repository's `Examples/LatchwayChat` demonstrates Firebase login, a bounded
+streaming weather-tool loop, ephemeral chat, direct fetch, Stop and diagnostics.
+It consumes npm packages. Its verification report distinguishes physical iOS
+evidence from Android build-only evidence. Request framework attribution remains
+native-owned `react-native-fetch`, including when called through LangChain.
+
+References: [Metro exports](https://metrobundler.dev/docs/package-exports/),
+[Babel assumptions](https://babeljs.io/docs/assumptions#noclasscalls),
+[LangChain ChatOpenAI](https://docs.langchain.com/oss/javascript/integrations/chat/openai).

package/lib/polyfills.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Explicit, opt-in React Native compatibility bootstrap. Import this before
+ * LangChain or any SDK/stream dependency. The ordinary SDK entry has no global
+ * initialization side effects. Native keys and attestation are never polyfilled.
+ */
+import "./runtime-symbols.js";
+import "react-native-get-random-values";
+//# sourceMappingURL=polyfills.d.ts.map

package/lib/polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfills.d.ts","sourceRoot":"","sources":["../src/polyfills.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,sBAAsB,CAAC;AAC9B,OAAO,gCAAgC,CAAC"}

package/lib/polyfills.js

@@ -0,0 +1,56 @@
+/**
+ * Explicit, opt-in React Native compatibility bootstrap. Import this before
+ * LangChain or any SDK/stream dependency. The ordinary SDK entry has no global
+ * initialization side effects. Native keys and attestation are never polyfilled.
+ */
+import "./runtime-symbols.js";
+import "react-native-get-random-values";
+import { URL as CompatibleURL, URLSearchParams as CompatibleURLSearchParams } from "react-native-url-polyfill";
+import { ReadableStream, TransformStream, WritableStream } from "web-streams-polyfill";
+import { TextDecoder, TextEncoder } from "text-encoding";
+// React Native's built-in URL is present but incomplete. Replace it only when
+// this small capability check fails, retaining complete application polyfills.
+function hasWorkingURL() {
+    try {
+        const url = new globalThis.URL("child?q=hello%20world", "https://example.invalid/root/");
+        return url.href === "https://example.invalid/root/child?q=hello%20world" &&
+            url.searchParams.get("q") === "hello world" &&
+            new globalThis.URLSearchParams({ q: "hello world" }).get("q") === "hello world";
+    }
+    catch {
+        return false;
+    }
+}
+if (!hasWorkingURL())
+    Object.assign(globalThis, { URL: CompatibleURL, URLSearchParams: CompatibleURLSearchParams });
+if (typeof globalThis.TextEncoder === "undefined")
+    Object.assign(globalThis, { TextEncoder });
+if (typeof globalThis.TextDecoder === "undefined")
+    Object.assign(globalThis, { TextDecoder });
+if (typeof globalThis.ReadableStream === "undefined")
+    Object.assign(globalThis, { ReadableStream });
+if (typeof globalThis.TransformStream === "undefined")
+    Object.assign(globalThis, { TransformStream });
+if (typeof globalThis.WritableStream === "undefined")
+    Object.assign(globalThis, { WritableStream });
+if (typeof AbortSignal.prototype.throwIfAborted === "undefined") {
+    Object.defineProperty(AbortSignal.prototype, "throwIfAborted", {
+        configurable: true,
+        writable: true,
+        value() {
+            if (!this.aborted)
+                return;
+            if (this.reason !== undefined)
+                throw this.reason;
+            const error = new Error("The operation was aborted.");
+            error.name = "AbortError";
+            throw error;
+        },
+    });
+}
+// LangChain expects a string when navigator exists. This is runtime detection,
+// not caller-supplied trust or framework attribution in the native protocol.
+if (typeof navigator !== "undefined" && typeof navigator.userAgent !== "string") {
+    Object.defineProperty(navigator, "userAgent", { value: "ReactNative/0.82", configurable: true });
+}
+//# sourceMappingURL=polyfills.js.map

package/lib/polyfills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfills.js","sourceRoot":"","sources":["../src/polyfills.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,sBAAsB,CAAC;AAC9B,OAAO,gCAAgC,CAAC;AACxC,OAAO,EAAE,GAAG,IAAI,aAAa,EAAE,eAAe,IAAI,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC/G,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEzD,8EAA8E;AAC9E,+EAA+E;AAC/E,SAAS,aAAa;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,uBAAuB,EAAE,+BAA+B,CAAC,CAAC;QACzF,OAAO,GAAG,CAAC,IAAI,KAAK,oDAAoD;YACtE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,aAAa;YAC3C,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,aAAa,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,CAAC,aAAa,EAAE;IAAE,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,eAAe,EAAE,yBAAyB,EAAE,CAAC,CAAC;AACpH,IAAI,OAAO,UAAU,CAAC,WAAW,KAAK,WAAW;IAAE,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;AAC9F,IAAI,OAAO,UAAU,CAAC,WAAW,KAAK,WAAW;IAAE,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;AAC9F,IAAI,OAAO,UAAU,CAAC,cAAc,KAAK,WAAW;IAAE,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;AACpG,IAAI,OAAO,UAAU,CAAC,eAAe,KAAK,WAAW;IAAE,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC;AACtG,IAAI,OAAO,UAAU,CAAC,cAAc,KAAK,WAAW;IAAE,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;AAEpG,IAAI,OAAO,WAAW,CAAC,SAAS,CAAC,cAAc,KAAK,WAAW,EAAE,CAAC;IAChE,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,SAAS,EAAE,gBAAgB,EAAE;QAC7D,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,IAAI;QACd,KAAK;YACH,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO;YAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;gBAAE,MAAM,IAAI,CAAC,MAAM,CAAC;YACjD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YACtD,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC;YAC1B,MAAM,KAAK,CAAC;QACd,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAC/E,6EAA6E;AAC7E,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,OAAO,SAAS,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;IAChF,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;AACnG,CAAC"}

package/lib/runtime-symbols.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-symbols.d.ts.map

package/lib/runtime-symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-symbols.d.ts","sourceRoot":"","sources":["../src/runtime-symbols.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC"}

package/lib/runtime-symbols.js

@@ -0,0 +1,9 @@
+// This module deliberately has no imports. Computed stream methods must see
+// these symbols before any dependency is evaluated on Hermes 0.82.
+for (const name of ["asyncIterator", "asyncDispose", "dispose"]) {
+    if (typeof Symbol[name] === "undefined") {
+        Object.defineProperty(Symbol, name, { value: Symbol.for(`Symbol.${name}`) });
+    }
+}
+export {};
+//# sourceMappingURL=runtime-symbols.js.map

package/lib/runtime-symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-symbols.js","sourceRoot":"","sources":["../src/runtime-symbols.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,mEAAmE;AACnE,KAAK,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,cAAc,EAAE,SAAS,CAAU,EAAE,CAAC;IACzE,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;QACxC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC"}

package/lib/version.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION = "1.0.0";
+export declare const SDK_VERSION = "1.1.0";
 export declare const CONTRACT_VERSION = "1.0.0";
 export declare const PROTOCOL_VERSION = 2;
 export declare const SUPPORTED_PROTOCOL_VERSIONS: readonly [1, 2];

package/lib/version.js

@@ -1,4 +1,4 @@
-export const SDK_VERSION = "1.0.0";
+export const SDK_VERSION = "1.1.0";
 export const CONTRACT_VERSION = "1.0.0";
 export const PROTOCOL_VERSION = 2;
 export const SUPPORTED_PROTOCOL_VERSIONS = Object.freeze([1, PROTOCOL_VERSION]);

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "@latchway/react-native",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Hardware-backed React Native client for the Latchway AI gateway",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./lib/index.js",
   "module": "./lib/index.js",
   "types": "./lib/index.d.ts",
-  "react-native": "./src/index.ts",
-  "sideEffects": false,
+  "react-native": "./lib/index.js",
+  "sideEffects": [
+    "./lib/polyfills.js",
+    "./lib/runtime-symbols.js"
+  ],
   "engines": {
     "node": ">=24.19.0",
     "pnpm": "10.15.0"
@@ -27,6 +30,8 @@
     "ios",
     "lib",
     "src",
+    "babel.cjs",
+    "babel.d.cts",
     "CHANGELOG.md",
     "LICENSE",
     "NOTICE",
@@ -40,10 +45,21 @@
   "exports": {
     ".": {
       "types": "./lib/index.d.ts",
-      "react-native": "./src/index.ts",
+      "react-native": "./lib/index.js",
       "import": "./lib/index.js",
       "default": "./lib/index.js"
     },
+    "./polyfills": {
+      "types": "./lib/polyfills.d.ts",
+      "react-native": "./lib/polyfills.js",
+      "import": "./lib/polyfills.js",
+      "default": "./lib/polyfills.js"
+    },
+    "./babel": {
+      "types": "./babel.d.cts",
+      "require": "./babel.cjs",
+      "default": "./babel.cjs"
+    },
     "./testing": {
       "types": "./lib/testing.d.ts",
       "import": "./lib/testing.js",
@@ -52,7 +68,11 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
+    "@babel/plugin-transform-export-namespace-from": "7.29.7",
     "@latchway/client": "1.0.0",
+    "react-native-get-random-values": "1.11.0",
+    "react-native-url-polyfill": "2.0.0",
+    "text-encoding": "0.7.0",
     "web-streams-polyfill": "4.3.0"
   },
   "peerDependencies": {
@@ -69,6 +89,7 @@
     "@react-native/gradle-plugin": "0.82.0",
     "@types/node": "24.13.3",
     "@types/react": "19.2.18",
+    "@types/text-encoding": "0.0.40",
     "ai": "7.0.85",
     "eslint": "10.9.1",
     "globals": "17.11.0",
@@ -117,7 +138,7 @@
   ],
   "scripts": {
     "build": "node scripts/clean.mjs && tsc -p tsconfig.build.json",
-    "check": "pnpm verify:contracts && pnpm verify:compatibility && pnpm lint && pnpm typecheck && pnpm test && pnpm codegen:check && pnpm build && pnpm example:check && pnpm example:bundle:check && pnpm native:boundary",
+    "check": "pnpm verify:contracts && pnpm verify:compatibility && pnpm lint && pnpm typecheck && pnpm test:runtime && pnpm test && pnpm codegen:check && pnpm build && pnpm example:check && pnpm example:bundle:check && pnpm native:boundary",
     "codegen:check": "node scripts/verify-codegen.mjs",
     "docs:bundle": "python3 scripts/build_docs_bundle.py",
     "example:check": "tsc -p tsconfig.example.json --noEmit",
@@ -134,6 +155,7 @@
     "consumer:check": "node scripts/verify-consumer.mjs",
     "test": "vitest run && node --test scripts/test-npm-release-evidence.mjs scripts/test-android-release-evidence.mjs scripts/test-ci-lock-output.mjs scripts/test-package-archive.mjs && python3 -m unittest scripts/test_build_docs_bundle.py scripts/test_maintainer_release.py scripts/test_public_core_release.py && python3 scripts/test-dependency-vulnerability-scan.py",
     "test:watch": "vitest",
+    "test:runtime": "node --test scripts/test-runtime.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "verify:bundle": "node scripts/verify-contract-bundle.mjs",
     "verify:compatibility": "node scripts/verify-compatibility.mjs",

package/release-compatibility.json

@@ -17,7 +17,7 @@
   },
   "react_native": {
     "package": "@latchway/react-native",
-    "version": "1.0.0",
+    "version": "1.1.0",
     "baseline": "0.82.0",
     "cli": "20.0.0",
     "react": "19.1.1",

package/src/polyfills.ts

@@ -0,0 +1,50 @@
+/**
+ * Explicit, opt-in React Native compatibility bootstrap. Import this before
+ * LangChain or any SDK/stream dependency. The ordinary SDK entry has no global
+ * initialization side effects. Native keys and attestation are never polyfilled.
+ */
+import "./runtime-symbols.js";
+import "react-native-get-random-values";
+import { URL as CompatibleURL, URLSearchParams as CompatibleURLSearchParams } from "react-native-url-polyfill";
+import { ReadableStream, TransformStream, WritableStream } from "web-streams-polyfill";
+import { TextDecoder, TextEncoder } from "text-encoding";
+
+// React Native's built-in URL is present but incomplete. Replace it only when
+// this small capability check fails, retaining complete application polyfills.
+function hasWorkingURL(): boolean {
+  try {
+    const url = new globalThis.URL("child?q=hello%20world", "https://example.invalid/root/");
+    return url.href === "https://example.invalid/root/child?q=hello%20world" &&
+      url.searchParams.get("q") === "hello world" &&
+      new globalThis.URLSearchParams({ q: "hello world" }).get("q") === "hello world";
+  } catch {
+    return false;
+  }
+}
+
+if (!hasWorkingURL()) Object.assign(globalThis, { URL: CompatibleURL, URLSearchParams: CompatibleURLSearchParams });
+if (typeof globalThis.TextEncoder === "undefined") Object.assign(globalThis, { TextEncoder });
+if (typeof globalThis.TextDecoder === "undefined") Object.assign(globalThis, { TextDecoder });
+if (typeof globalThis.ReadableStream === "undefined") Object.assign(globalThis, { ReadableStream });
+if (typeof globalThis.TransformStream === "undefined") Object.assign(globalThis, { TransformStream });
+if (typeof globalThis.WritableStream === "undefined") Object.assign(globalThis, { WritableStream });
+
+if (typeof AbortSignal.prototype.throwIfAborted === "undefined") {
+  Object.defineProperty(AbortSignal.prototype, "throwIfAborted", {
+    configurable: true,
+    writable: true,
+    value(this: AbortSignal): void {
+      if (!this.aborted) return;
+      if (this.reason !== undefined) throw this.reason;
+      const error = new Error("The operation was aborted.");
+      error.name = "AbortError";
+      throw error;
+    },
+  });
+}
+
+// LangChain expects a string when navigator exists. This is runtime detection,
+// not caller-supplied trust or framework attribution in the native protocol.
+if (typeof navigator !== "undefined" && typeof navigator.userAgent !== "string") {
+  Object.defineProperty(navigator, "userAgent", { value: "ReactNative/0.82", configurable: true });
+}

package/src/runtime-symbols.ts

@@ -0,0 +1,9 @@
+// This module deliberately has no imports. Computed stream methods must see
+// these symbols before any dependency is evaluated on Hermes 0.82.
+for (const name of ["asyncIterator", "asyncDispose", "dispose"] as const) {
+  if (typeof Symbol[name] === "undefined") {
+    Object.defineProperty(Symbol, name, { value: Symbol.for(`Symbol.${name}`) });
+  }
+}
+
+export {};

package/src/version.ts

@@ -1,4 +1,4 @@
-export const SDK_VERSION = "1.0.0";
+export const SDK_VERSION = "1.1.0";
 export const CONTRACT_VERSION = "1.0.0";
 export const PROTOCOL_VERSION = 2;
 export const SUPPORTED_PROTOCOL_VERSIONS = Object.freeze([1, PROTOCOL_VERSION] as const);