@rocapine/rocalytics-sdk 0.0.0-stage → 0.3.0

package/docs/paywall-presentation-contract.md

@@ -0,0 +1,139 @@
+# Paywall presentation contract
+
+Version 1 (`schema_version: 1`). This document is normative. The [JSON Schema](paywall-presentation.schema.json) and the [TypeScript types](paywall-presentation.types.ts) implement it, and [examples](paywall-presentation.examples.ts) illustrate it. Where they disagree, this text wins and the others are bugs.
+
+A **presentation** is one paywall shown to one device: from the moment a paywall is resolved for display until it closes. The tracker in `@rocapine/rocalytics-sdk/paywall` sends it as up to three snapshots. Its envelope (`schema_version`, `seq`, `sent_at`, `context`) is the [onboarding run contract](onboarding-run-contract.md)'s, unchanged.
+
+## Contents
+
+1. [Decisions](#1-decisions)
+2. [A complete payload](#2-a-complete-payload)
+3. [Fields](#3-fields)
+4. [Rules beyond the schema](#4-rules-beyond-the-schema)
+5. [Transport](#5-transport)
+6. [Measures](#6-measures)
+7. [Versioning](#7-versioning)
+
+## 1. Decisions
+
+| # | Topic | Decision |
+|---|---|---|
+| P1 | Unit | One presentation is one `present()` call, or one display of a `Paywall` onboarding step, that resolved to a paywall. Calls refused before resolution (`unknown-moment`, `already-presenting`) send nothing. Errors after resolution (`parse-error`, `render-error`, `unknown-custom-screen`, `host-never-presented`, `paywall-disappeared`) send a start and an `error` end. |
+| P2 | Identity | `presentation_id` is a client-minted lowercase UUIDv7. The ingest keys rows on `(roca_id, presentation_id)`. |
+| P3 | Envelope | `schema_version`, `seq`, `sent_at` and `context` are exactly as in the onboarding run contract (D4, D5, D24). |
+| P4 | Sends | At most three per presentation: on start (`in_progress`, `shown_at` null), on shown, and on end (`ended`). Each send is a full snapshot that replaces the previous one. |
+| P5 | Terminal | `ended` is terminal: the first ended snapshot the server accepts wins, and anything after it is `ignored`. |
+| P6 | Immutable | `presentation_id`, `started_at`, `paywall`, `surface`, `onboarding_run` and `context` never change within a presentation. A snapshot that changes one is `rejected`. |
+| P7 | Shown | `shown_at` is set when the host acknowledges that the paywall is on screen. A presentation that ends without it was never seen, and counts toward no user-facing measure. |
+| P8 | Outcome | One of `purchased`, `dismissed`, `cancelled` or `error`. `reason` appears only with `error`, carrying the SDK's error reason. `transaction` appears only with `purchased`. |
+| P9 | Join key | `transaction.original_transaction_identifier` is the exact value the app passes to Rocalytics' `purchase` call (`TrackPurchaseParams.originalTransactionIdentifier`, required there). iOS: it is StoreKit's original transaction id and joins the store-notification rows' `original_transaction_identifier` directly, with no lookup. Android: `transaction.purchase_token` is the Play purchase token and is the join key; `original_transaction_identifier` carries the Play order id (`GPA.…`) there and is not used to join. |
+| P10 | Unattributed | A `purchased` outcome without the platform's join key (iOS: `original_transaction_identifier`; Android: `purchase_token`) is a valid snapshot. It counts as a conversion and earns no proceeds. |
+| P11 | Time | Analytics buckets a presentation by the server's receive time of its first snapshot, as onboarding D13. Within a presentation the client clamps timestamps to be monotonic. |
+| P12 | No money | The client never sends a price. Proceeds come from store transaction rows joined on P9. |
+| P13 | Restored | `transaction.restored: true` marks a `purchased` outcome that only restored existing access: a restore or a web redemption. It counts in neither `purchases` nor conversions. Only `true` is ever sent; an absent field means a new purchase. |
+
+## 2. A complete payload
+
+The last of three sends of a purchased presentation on Android:
+
+```json
+{
+  "schema_version": 1,
+  "presentation_id": "0192f1a2-7c3d-7e4f-8a5b-6c7d8e9f0a1b",
+  "seq": 3,
+  "status": "ended",
+  "started_at": "2026-01-10T09:00:00.000Z",
+  "shown_at": "2026-01-10T09:00:00.350Z",
+  "ended_at": "2026-01-10T09:00:41.120Z",
+  "sent_at": "2026-01-10T09:00:41.120Z",
+  "paywall": {
+    "moment_key": "settings_upgrade",
+    "paywall_id": "4b1f0e7c-2d1a-4c55-9a0e-6f2d3c1b7a90",
+    "audience_id": "a9e1c3d2-7b6f-4e21-8c0d-5f4a3b2c1d0e",
+    "render_mode": "custom",
+    "billing": "store"
+  },
+  "surface": "present",
+  "context": {
+    "app_version": "2.4.0",
+    "build": "412",
+    "platform": "android",
+    "os_version": "15",
+    "locale": "en-US",
+    "timezone": "America/New_York",
+    "library_version": "0.1.0"
+  },
+  "outcome": {
+    "status": "purchased",
+    "transaction": {
+      "original_transaction_identifier": "GPA.3311-4849-7511-34728",
+      "purchase_token": "mboecpopplapdphlhgegnpol.AO-J1OxExampleToken",
+      "product_id": "pro_annual"
+    }
+  }
+}
+```
+
+## 3. Fields
+
+| Field | Type | Meaning |
+|---|---|---|
+| `schema_version` | `1` | This document's revision. |
+| `presentation_id` | lowercase UUID | Minted by the client when the presentation starts (P2). |
+| `seq` | integer ≥ 1 | Increases with every send of this presentation (onboarding D4). |
+| `status` | `in_progress` \| `ended` | `ended` is terminal (P5). |
+| `started_at` | timestamp | When the paywall was resolved for display. |
+| `shown_at` | timestamp \| null | When the host acknowledged the paywall on screen (P7). |
+| `ended_at` | timestamp \| null | Set exactly when `status` is `ended`. |
+| `sent_at` | timestamp | Device clock at send time. Advisory only. |
+| `paywall.moment_key` | string | The moment the host presented. |
+| `paywall.paywall_id` | string | The paywall the moment resolved to. |
+| `paywall.audience_id` | string \| null | The audience that matched, if the catalog carried one. |
+| `paywall.render_mode` | `elements` \| `custom` | How the paywall was rendered. |
+| `paywall.billing` | `store` \| `stripe` | The paywall's billing path. |
+| `paywall.variant_key`, `paywall.deployment_id` | string, optional | Present only when the catalog carries them. |
+| `surface` | `present` \| `paywall_step` | A `present()` call, or a `Paywall` step inside an onboarding. |
+| `onboarding_run` | object, optional | Only with `paywall_step`: the onboarding run's `run_id` and `step_key`. |
+| `outcome` | object \| null | Set exactly when `status` is `ended` (P8). |
+| `outcome.reason` | string, optional | Only with `error`. |
+| `outcome.transaction` | object, optional | Only with `purchased`, never empty. Fields: `original_transaction_identifier`, `purchase_token`, `product_id`, `restored` (P9, P10, P13). |
+| `context` | object | The onboarding contract's run context, captured once at start (onboarding D5). |
+
+All timestamps have exactly three fractional digits (onboarding D24). A snapshot is at most 16 KiB.
+
+## 4. Rules beyond the schema
+
+- `ended_at` and `outcome` are non-null exactly when `status` is `ended`.
+- `shown_at`, when set, is not before `started_at`.
+- `ended_at`, when set, is not before `shown_at` (or `started_at` when never shown).
+- `sent_at` is not before `started_at`.
+- `reason` appears only with outcome status `error`.
+- `transaction` appears only with outcome status `purchased`, and is never an empty object.
+- A `purchased` outcome requires `shown_at`.
+- `onboarding_run` appears only with surface `paywall_step`.
+
+## 5. Transport
+
+**Endpoint.** `POST /functions/v1/paywall-presentations` on the Rocalytics API. The sender is identified by the same headers the onboarding endpoint uses (`X-Roca-ID`, `X-Application-ID`, `X-Platform`); the body is the bare snapshot, with no device identifiers in it.
+
+**Acceptance.** The server keys a presentation on the sender's `roca_id` and `presentation_id`, and answers each snapshot in its body:
+
+- `ignored` when the stored snapshot is already `ended` (P5), or when the incoming `seq` is not higher than the stored one.
+- `rejected` when the snapshot fails the schema or section 4, exceeds 16 KiB, or changes an immutable field (P6).
+- `accepted` otherwise: the snapshot replaces the stored one.
+
+**Outcomes and retries.** As onboarding D27: the outcome is always in the response body, on a 2xx and on a 4xx alike. A response without an outcome, and no response at all, are transient and retried with backoff. `accepted`, `ignored` and `rejected` settle the snapshot for good.
+
+## 6. Measures
+
+Per moment and per paywall, over presentations bucketed by P11:
+
+- **Users:** distinct senders with a presentation that was shown or purchased.
+- **Conversions:** distinct senders with a `purchased` presentation that is not `restored` (P13).
+- **Conversion rate:** conversions divided by users.
+- **Unattributed purchases:** `purchased`, not restored, and missing the platform's join key (P10).
+- **Proceeds:** the store transaction rows joined on P9. Never a client-sent price (P12).
+
+## 7. Versioning
+
+The schema is closed, so every change increments `schema_version`, as onboarding D20. An additive change is one an older payload needs no conversion for; anything else is breaking.

package/docs/paywall-presentation.examples.ts

@@ -0,0 +1,42 @@
+import type { PaywallPresentationSnapshot } from "./paywall-presentation.types";
+
+const context = {
+  app_version: "2.4.0", build: "412", platform: "android", os_version: "15",
+  locale: "en-US", timezone: "America/New_York", library_version: "0.1.0",
+} as const;
+const paywall = {
+  moment_key: "settings_upgrade", paywall_id: "4b1f0e7c-2d1a-4c55-9a0e-6f2d3c1b7a90",
+  audience_id: "a9e1c3d2-7b6f-4e21-8c0d-5f4a3b2c1d0e", render_mode: "custom", billing: "store",
+} as const;
+const id = "0192f1a2-7c3d-7e4f-8a5b-6c7d8e9f0a1b";
+
+/** The three sends of one purchased presentation on Android. */
+export const PURCHASED_ANDROID: PaywallPresentationSnapshot[] = [
+  { schema_version: 1, presentation_id: id, seq: 1, status: "in_progress", started_at: "2026-01-10T09:00:00.000Z",
+    shown_at: null, ended_at: null, sent_at: "2026-01-10T09:00:00.000Z", paywall, surface: "present", outcome: null, context },
+  { schema_version: 1, presentation_id: id, seq: 2, status: "in_progress", started_at: "2026-01-10T09:00:00.000Z",
+    shown_at: "2026-01-10T09:00:00.350Z", ended_at: null, sent_at: "2026-01-10T09:00:00.350Z", paywall, surface: "present", outcome: null, context },
+  { schema_version: 1, presentation_id: id, seq: 3, status: "ended", started_at: "2026-01-10T09:00:00.000Z",
+    shown_at: "2026-01-10T09:00:00.350Z", ended_at: "2026-01-10T09:00:41.120Z", sent_at: "2026-01-10T09:00:41.120Z",
+    paywall, surface: "present", context,
+    outcome: { status: "purchased", transaction: {
+      original_transaction_identifier: "GPA.3311-4849-7511-34728",
+      purchase_token: "mboecpopplapdphlhgegnpol.AO-J1OxExampleToken", product_id: "pro_annual" } } },
+];
+
+export const DISMISSED_STEP: PaywallPresentationSnapshot = {
+  schema_version: 1, presentation_id: "0192f1a2-7c3d-7e4f-8a5b-6c7d8e9f0a1c", seq: 3, status: "ended",
+  started_at: "2026-01-10T09:00:00.000Z", shown_at: "2026-01-10T09:00:00.200Z", ended_at: "2026-01-10T09:00:05.000Z",
+  sent_at: "2026-01-10T09:00:05.000Z", paywall: { ...paywall, moment_key: "onboarding_end" }, surface: "paywall_step",
+  onboarding_run: { run_id: "0192f1a2-0000-7000-8000-000000000001", step_key: "paywall" },
+  outcome: { status: "dismissed" }, context: { ...context, platform: "ios", os_version: "18.1" },
+};
+
+export const RENDER_ERROR: PaywallPresentationSnapshot = {
+  schema_version: 1, presentation_id: "0192f1a2-7c3d-7e4f-8a5b-6c7d8e9f0a1d", seq: 2, status: "ended",
+  started_at: "2026-01-10T09:00:00.000Z", shown_at: null, ended_at: "2026-01-10T09:00:00.010Z",
+  sent_at: "2026-01-10T09:00:00.010Z", paywall, surface: "present",
+  outcome: { status: "error", reason: "unknown-custom-screen" }, context,
+};
+
+export const ALL_EXAMPLES: PaywallPresentationSnapshot[] = [...PURCHASED_ANDROID, DISMISSED_STEP, RENDER_ERROR];

package/docs/paywall-presentation.schema.json

@@ -0,0 +1,268 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:rocalytics-sdk:paywall-presentation:1",
+  "title": "Paywall presentation snapshot, schema_version 1",
+  "description": "One send of a paywall presentation. Each send replaces the presentation's previous snapshot. Normative text: paywall-presentation-contract.md. The schema is closed: an unknown field is an error.",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "presentation_id",
+    "seq",
+    "status",
+    "started_at",
+    "shown_at",
+    "ended_at",
+    "sent_at",
+    "paywall",
+    "surface",
+    "outcome",
+    "context"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "presentation_id": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
+    },
+    "seq": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "status": {
+      "enum": [
+        "in_progress",
+        "ended"
+      ]
+    },
+    "started_at": {
+      "$ref": "#/$defs/timestamp"
+    },
+    "shown_at": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/timestamp"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "ended_at": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/timestamp"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "sent_at": {
+      "$ref": "#/$defs/timestamp"
+    },
+    "paywall": {
+      "type": "object",
+      "required": [
+        "moment_key",
+        "paywall_id",
+        "audience_id",
+        "render_mode",
+        "billing"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "moment_key": {
+          "$ref": "#/$defs/id"
+        },
+        "paywall_id": {
+          "$ref": "#/$defs/id"
+        },
+        "audience_id": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/id"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "render_mode": {
+          "enum": [
+            "elements",
+            "custom"
+          ]
+        },
+        "billing": {
+          "enum": [
+            "store",
+            "stripe"
+          ]
+        },
+        "variant_key": {
+          "$ref": "#/$defs/id"
+        },
+        "deployment_id": {
+          "$ref": "#/$defs/id"
+        }
+      }
+    },
+    "surface": {
+      "enum": [
+        "present",
+        "paywall_step"
+      ]
+    },
+    "onboarding_run": {
+      "type": "object",
+      "required": [
+        "run_id",
+        "step_key"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "run_id": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
+        },
+        "step_key": {
+          "$ref": "#/$defs/key"
+        }
+      }
+    },
+    "outcome": {
+      "anyOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "object",
+          "required": [
+            "status"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "status": {
+              "enum": [
+                "purchased",
+                "dismissed",
+                "cancelled",
+                "error"
+              ]
+            },
+            "reason": {
+              "$ref": "#/$defs/key"
+            },
+            "transaction": {
+              "type": "object",
+              "required": [],
+              "additionalProperties": false,
+              "properties": {
+                "original_transaction_identifier": {
+                  "$ref": "#/$defs/storeId"
+                },
+                "purchase_token": {
+                  "$ref": "#/$defs/storeId"
+                },
+                "product_id": {
+                  "$ref": "#/$defs/storeId"
+                },
+                "restored": {
+                  "type": "boolean"
+                }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "context": {
+      "description": "Captured once, when the run starts. Country is not sent: the server derives it.",
+      "type": "object",
+      "required": [
+        "app_version",
+        "build",
+        "platform",
+        "os_version",
+        "locale",
+        "timezone"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "app_version": {
+          "$ref": "#/$defs/shortText"
+        },
+        "build": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/shortText"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "platform": {
+          "enum": [
+            "ios",
+            "android",
+            "web"
+          ]
+        },
+        "os_version": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/shortText"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "locale": {
+          "description": "BCP 47 language tag.",
+          "type": "string",
+          "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8})*$"
+        },
+        "timezone": {
+          "description": "IANA time zone name.",
+          "type": "string",
+          "pattern": "^[A-Za-z][A-Za-z0-9_+-]*(/[A-Za-z0-9_+-]+)*$",
+          "maxLength": 64
+        },
+        "library_version": {
+          "$ref": "#/$defs/shortText"
+        }
+      }
+    }
+  },
+  "$defs": {
+    "timestamp": {
+      "description": "RFC 3339 in UTC with exactly three fractional digits and a Z suffix, e.g. 2026-01-10T09:00:00.000Z. A pattern rather than format: date-time, because format is annotation-only in draft 2020-12.",
+      "type": "string",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+    },
+    "key": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$"
+    },
+    "shortText": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 32
+    },
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "storeId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024
+    }
+  }
+}

package/docs/paywall-presentation.types.ts

@@ -0,0 +1,73 @@
+// Paywall presentation contract v1: the payload types.
+// Normative text: docs/paywall-presentation-contract.md. src/paywall/contract.ts
+// is this file, byte for byte, except its import line (test/paywall-docs.test.ts).
+import type { RunContext, Timestamp } from "./onboarding-run.types";
+
+export type PresentationStatus = "in_progress" | "ended";
+export type PresentationOutcomeStatus = "purchased" | "dismissed" | "cancelled" | "error";
+export type PresentationSurface = "present" | "paywall_step";
+
+export interface PresentationPaywall {
+  /** The moment's key: what the host passed to `present()`. */
+  moment_key: string;
+  /** The Studio paywall id the moment's audience waterfall picked. */
+  paywall_id: string;
+  /** The audience that matched; null when the catalog carried none. */
+  audience_id: string | null;
+  render_mode: "elements" | "custom";
+  billing: "store" | "stripe";
+  variant_key?: string;
+  deployment_id?: string;
+}
+
+export interface PresentationTransaction {
+  /**
+   * The exact value the app passes to Rocalytics' `purchase` call (`originalTransactionIdentifier`).
+   * iOS: StoreKit's original transaction id, the join key to the store-notification rows.
+   * Android: the Play order id (GPA.…); not used to join.
+   */
+  original_transaction_identifier?: string;
+  /** Android only: the Play purchase token, the proceeds join key on Android. */
+  purchase_token?: string;
+  product_id?: string;
+  /** True when the purchase only restored existing access (a restore, a web redemption). Not a conversion. */
+  restored?: boolean;
+}
+
+export interface PresentationOutcome {
+  status: PresentationOutcomeStatus;
+  /** Only with status "error": the SDK's reason, e.g. "render-error". */
+  reason?: string;
+  /** Only with status "purchased". Absent when the host reported none. */
+  transaction?: PresentationTransaction;
+}
+
+interface PresentationBase {
+  schema_version: 1;
+  /** Client-minted, lowercase UUID. One per presentation. */
+  presentation_id: string;
+  /** Starts at 1 and increases with every send of this presentation. */
+  seq: number;
+  started_at: Timestamp;
+  shown_at: Timestamp | null;
+  sent_at: Timestamp;
+  paywall: PresentationPaywall;
+  surface: PresentationSurface;
+  /** Only for surface "paywall_step": the onboarding run it sits in. */
+  onboarding_run?: { run_id: string; step_key: string };
+  context: RunContext;
+}
+
+export interface InProgressPresentationSnapshot extends PresentationBase {
+  status: "in_progress";
+  ended_at: null;
+  outcome: null;
+}
+
+export interface EndedPresentationSnapshot extends PresentationBase {
+  status: "ended";
+  ended_at: Timestamp;
+  outcome: PresentationOutcome;
+}
+
+export type PaywallPresentationSnapshot = InProgressPresentationSnapshot | EndedPresentationSnapshot;

package/onboarding/package.json

@@ -0,0 +1,4 @@
+{
+  "main": "../dist/onboarding/index.js",
+  "types": "../dist/onboarding/index.d.ts"
+}

package/package.json

@@ -1,6 +1,122 @@
 {
   "name": "@rocapine/rocalytics-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "Headless client SDK for Onboarding Studio: a typed onboarding run tracker for any onboarding, including hand-coded ones, and the Rocalytics client",
+  "keywords": [
+    "onboarding",
+    "analytics",
+    "funnel",
+    "react-native",
+    "headless",
+    "rocalytics"
+  ],
+  "author": "Rocapine",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Rocapine/rocalytics-sdk.git"
+  },
+  "sideEffects": false,
+  "exports": {
+    "./onboarding": {
+      "types": "./dist/onboarding/index.d.ts",
+      "default": "./dist/onboarding/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "default": "./dist/core/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "default": "./dist/client/index.js"
+    },
+    "./paywall": {
+      "types": "./dist/paywall/index.d.ts",
+      "default": "./dist/paywall/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "onboarding": [
+        "./dist/onboarding/index.d.ts"
+      ],
+      "core": [
+        "./dist/core/index.d.ts"
+      ],
+      "client": [
+        "./dist/client/index.d.ts"
+      ],
+      "paywall": [
+        "./dist/paywall/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "docs",
+    "onboarding",
+    "core",
+    "client",
+    "paywall",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run lint && npm run type:check:tests && npm test && npm run build && npm run check:exports",
+    "type:check": "tsc -p tsconfig.json --noEmit",
+    "type:check:tests": "tsc -p tsconfig.test.json",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "gen:schema-types": "UPDATE_SCHEMA_TYPES=1 vitest run test/schema-types.test.ts test/paywall-schema-types.test.ts",
+    "check:exports": "node scripts/check-exports.mjs"
+  },
+  "peerDependencies": {
+    "expo-application": "*",
+    "expo-crypto": "*",
+    "expo-device": "*",
+    "expo-modules-core": "*",
+    "expo-network": "*",
+    "expo-secure-store": "*",
+    "react-native": "*"
+  },
+  "peerDependenciesMeta": {
+    "expo-application": {
+      "optional": true
+    },
+    "expo-crypto": {
+      "optional": true
+    },
+    "expo-device": {
+      "optional": true
+    },
+    "expo-modules-core": {
+      "optional": true
+    },
+    "expo-network": {
+      "optional": true
+    },
+    "expo-secure-store": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.5",
+    "@types/node": "^22.20.4",
+    "eslint": "^9.39.5",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.71.0",
+    "vitest": "^4.1.11"
+  }
+}

package/paywall/package.json

@@ -0,0 +1 @@
+{"main":"../dist/paywall/index.js","types":"../dist/paywall/index.d.ts"}