@userflow-tech/react-native 0.1.0 → 0.1.1

package/README.md

@@ -9,10 +9,10 @@ release for every content change.
 
 ## Requirements
 
-| Peer dependency                             | Required? | Why                                                           |
+| Peer / dependency                           | Required? | Why                                                           |
 | ------------------------------------------- | --------- | ------------------------------------------------------------- |
 | `react`, `react-native`                     | Yes       | Host runtime.                                                 |
-| `@react-native-async-storage/async-storage` | Yes       | Persists the anonymous user id across launches.               |
+| `@react-native-async-storage/async-storage` | Yes (dep) | Persists the anonymous user id. Installed with this package.  |
 | `react-native-safe-area-context`            | Optional  | Correct insets for modal/tooltip surfaces.                    |
 | `@react-navigation/native`                  | Optional  | Screen tracking + NAVIGATE routing (React Navigation).        |
 | `expo-router`                               | Optional  | Screen tracking + NAVIGATE routing (Expo Router).             |
@@ -29,15 +29,28 @@ compatible with Expo Go.
 
 ## Install
 
+Packages publish to the private `@userflow-tech` npm org. Create a **granular
+access token** on npm (Read-only, limited to `@userflow-tech`) and put it in
+the host app’s `.npmrc` via an env var — do not commit the token:
+
+```ini
+@userflow-tech:registry=https://registry.npmjs.org/
+//registry.npmjs.org/:_authToken=${NPM_TOKEN}
+```
+
 ```bash
-# Expo (dev build) — include the config plugin for Builder deep-link schemes
-npx expo install @userflow-tech/react-native @userflow-tech/expo @react-native-async-storage/async-storage
+# Expo (dev build)
+npx expo install @userflow-tech/react-native
 
 # Bare React Native
-npm install @userflow-tech/react-native @react-native-async-storage/async-storage
+npm install @userflow-tech/react-native
 cd ios && pod install
 ```
 
+`@react-native-async-storage/async-storage` is a dependency of this package and
+is installed automatically. If autolinking misses it, run
+`npx expo install @react-native-async-storage/async-storage`.
+
 Optional peers as needed:
 
 ```bash
@@ -45,11 +58,8 @@ npx expo install react-native-safe-area-context @react-native-community/netinfo
 # and either expo-router or @react-navigation/native, depending on your router
 ```
 
-For local tarball installs from this monorepo (before the private registry is
-set up), pack with `pnpm pack:all` at the repo root and install **all four**
-tarballs together — a single `@userflow-tech/react-native` tarball alone will fail
-because `@userflow-tech/core@0.1.0` is not on the public registry, and Expo hosts
-need `@userflow-tech/expo` for scheme registration. Steps:
+For local tarball installs from this monorepo, pack with `pnpm pack:all` at the
+repo root and install the single `@userflow-tech/react-native` tarball. Steps:
 `docs/local-testing.md` in the monorepo.
 
 ## Quick start
@@ -196,9 +206,9 @@ Full contract, prop priority, missing-target behavior, and duplicate-id rules:
 To preview draft flows from the Userflow builder onto a device (QR / deep link):
 
 1. Register the environment's **`scheme_id`** (e.g. `userflow-257587` — **not**
-   the env UUID) with the `@userflow-tech/expo` config plugin, then **rebuild
-   native** (`npx expo prebuild` / a new development client). Metro reload is
-   not enough.
+   the env UUID) with the `@userflow-tech/react-native` config plugin, then
+   **rebuild native** (`npx expo prebuild` / a new development client). Metro
+   reload is not enough.
 2. Call `Userflow.init` (optionally with `pairingEndpoint` / `serverEndpoint`
    for staging or local stacks) and wrap the tree in `UserflowProvider`.
 3. Open the builder Preview dialog → **Pair a device** → scan/open the QR. The
@@ -208,7 +218,7 @@ To preview draft flows from the Userflow builder onto a device (QR / deep link):
 ```json
 {
   "expo": {
-    "plugins": [["@userflow-tech/expo", { "schemeId": "userflow-257587" }]]
+    "plugins": [["@userflow-tech/react-native", { "schemeId": "userflow-257587" }]]
   }
 }
 ```

package/app.plugin.js

@@ -0,0 +1,3 @@
+// Expo loads this file as the config plugin entry.
+// Hosts register: plugins: [['@userflow-tech/react-native', { schemeId: 'userflow-…' }]]
+module.exports = require('./expo-plugin/withUserflow.js');

package/babel-plugin/index.d.ts

@@ -0,0 +1,43 @@
+import type { PluginObj, PluginPass, types as BabelTypes } from '@babel/core';
+export interface UserflowBabelPluginOptions {
+    rootDir?: string;
+    allowlist?: string[];
+    injectUfidProp?: boolean;
+    exclude?: string[];
+    /**
+     * When true (the default), only stamp `nativeID` (and `collapsable={false}`
+     * when needed). Skips the SDK import, `__ufRef` helper, ref wrapping, hints,
+     * and scope capture. Use this against the current official SDK, which
+     * resolves anchors via fiber `nativeID` matching and does not yet export
+     * `__userflowAutoAnchor`.
+     *
+     * Set to `false` only when the host SDK provides `__userflowAutoAnchor`
+     * (full auto-register mode). Enabling full mode without that export will
+     * inject a broken import into every stamped module.
+     */
+    stampOnly?: boolean;
+}
+interface PluginState extends PluginPass {
+    ufStamped?: boolean;
+    ufCallSiteCounters?: Map<string, Map<string, number>>;
+    /**
+     * Parent-scoped ordinals precomputed against the pristine JSX tree, keyed by
+     * opening-element node. Populated in `Program.enter` before `@babel/preset-react`
+     * rewrites `<El>` into `_jsx(El, …)` — otherwise earlier same-type siblings are
+     * already gone by the time we visit a later one and every element mis-reads as
+     * `#0`, colliding their `uf_<hash>` ids.
+     */
+    ufOrdinals?: WeakMap<BabelTypes.Node, {
+        ordinal: number;
+        siblingIndex: number;
+    }>;
+}
+export default function userflowAutoStamp(api: {
+    types: typeof BabelTypes;
+    template: {
+        statement: (tpl: string) => (replacements?: Record<string, unknown>) => BabelTypes.Statement;
+    };
+    env?: (name?: string) => boolean;
+}): PluginObj<PluginState>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/babel-plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAY,SAAS,EAAE,UAAU,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAyiBxF,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,WAAY,SAAQ,UAAU;IACtC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClF;AA8GD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,GAAG,EAAE;IAC7C,KAAK,EAAE,OAAO,UAAU,CAAC;IACzB,QAAQ,EAAE;QACR,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,UAAU,CAAC,SAAS,CAAC;KAC9F,CAAC;IACF,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CAClC,GAAG,SAAS,CAAC,WAAW,CAAC,CA+TzB"}