react-native-insider 8.0.1 → 8.0.2

package/.orbit-output/skills/custom/academy-doc-generator.md

@@ -0,0 +1,598 @@
+---
+name: academy-doc-generator
+description: Generates Insider Academy developer guide documentation (.md + .html) from a given React Native SDK module (JS + .d.ts), exposing only public APIs. Supports --format, --output, and --dry-run flags. Output is structurally identical to the iOS and Android academy-doc-generator skills so the three platform docs stay in lockstep.
+version: 1.0.0
+type: custom
+project: Insider React Native SDK
+generated_by: skill-creator-agent
+generated_from: .orbit-output/config/architecture/
+---
+
+# Academy Doc Generator
+
+Generates developer guide documentation for the Insider Academy website from a given React Native SDK module. Outputs Markdown and/or HTML formats, exposing only the public JS/TS API surface (the `.d.ts` is the source of truth for what is public).
+
+The same skill exists for the iOS SDK (`mobile-ios`) and the Android SDK (`mobileandroid`). Output structure, section order, emojis (✅ / ⛔), version-badge style, callout boxes, HTML template (pre-tokenized spans, VS Code dark theme, sticky sidebar TOC, tab switcher, copy-to-clipboard, self-contained assets) are **intentionally identical across the three platforms** so the Academy docs line up side by side.
+
+**Usage:** `/academy-doc-generator <module> [--format md|html] [--output <dir>] [--dry-run]`
+
+- `--format md` — generate only Markdown
+- `--format html` — generate only HTML
+- *(no flag)* — generate both (default)
+- `--output <dir>` — write output to a custom directory instead of `docs/{module-name}/`
+- `--dry-run` — show discovery/analysis results without writing any files
+
+## Activation
+
+<agent-activation>
+When this skill is invoked:
+
+### Step 0: Create Task List for Progress Tracking
+
+Before starting any work, create a task list using TaskCreate so the user can see step-by-step progress. Create the following tasks in a single batch:
+
+1. **"Parse input arguments"** — activeForm: "Parsing input arguments"
+2. **"Resolve module path (JS + .d.ts)"** — activeForm: "Resolving module path"
+3. **"Discover public API surface from .d.ts"** — activeForm: "Discovering public API surface"
+4. **"Analyze public API and build validation registry"** — activeForm: "Analyzing public API"
+5. **"Discover related types"** — activeForm: "Discovering related types"
+6. **"Trace entry points in index.js / index.d.ts"** — activeForm: "Tracing entry points"
+7. **"Read SDK version from package.json"** — activeForm: "Reading SDK version"
+8. **"Generate Markdown documentation"** — activeForm: "Generating Markdown documentation"
+9. **"Generate HTML documentation"** — activeForm: "Generating HTML documentation"
+10. **"Validate generated code examples"** — activeForm: "Validating generated code examples"
+11. **"Write output files"** — activeForm: "Writing output files"
+12. **"Display summary"** — activeForm: "Displaying summary"
+
+Skip (or delete) tasks that will not run based on parsed flags:
+- Skip "Generate Markdown documentation" if `--format html`
+- Skip "Generate HTML documentation" if `--format md`
+- Skip "Write output files" if `--dry-run`
+
+**Progress tracking rule:** Before starting each step, set its task to `in_progress` via TaskUpdate. After completing each step, set it to `completed`. Keep the spinner accurate throughout the run.
+
+### Step 1: Parse Input
+
+The user provides arguments in the format: `<module> [--format md|html] [--output <dir>] [--dry-run]`
+
+1. **module** (required): One of three shapes
+   - A module / class name: `InsiderAppCards`, `InsiderUser`, `InsiderEvent`, `InsiderProduct`, `InsiderIdentifier`
+   - A JS file path: `src/InsiderAppCards.js` or `index.js`
+   - A directory: a subfolder under `src/` (e.g., `src/appcards/` if one exists)
+2. **--format** (optional): `md` (Markdown only) or `html` (HTML only). Omitted → generate both.
+3. **--output** (optional): Custom output directory. Omitted → `docs/{module-name}/` at repo root.
+4. **--dry-run** (optional): Run full discovery and analysis but write no files.
+
+Parse the arguments: split on `--` flags. If `--format` is provided with an invalid value (not `md` or `html`), HALT with a clear error. If the module cannot be resolved in Step 2, HALT there.
+
+### Step 2: Resolve Module Path (JS + .d.ts)
+
+Resolve the input to a concrete `(jsPath, dtsPath, moduleName)` triple:
+
+1. If input is a file path (`src/Foo.js` or `index.js`): the `.d.ts` is the sibling with the same basename (`src/Foo.d.ts` / `index.d.ts`). Derive `moduleName` from the exported class or from the basename.
+2. If input is a bare name like `InsiderAppCards`: check, in order:
+   - `./index.js` — only if the name matches the default export (`RNInsider`)
+   - `src/{Name}.js` + `src/{Name}.d.ts`
+3. If input is a directory: collect all `*.js` files under it, find the primary module (largest public surface, or the one whose basename matches the directory name). The primary module's `.d.ts` drives discovery; sibling `.d.ts` files inside the same directory are also considered.
+
+Validate with the Read tool that both the `.js` and its `.d.ts` exist. If either is missing, HALT with a clear message — React Native docs pull their shape from `.d.ts`, so a missing `.d.ts` means there is no public API to document.
+
+**module-name derivation (for output paths and titles):**
+- Strip the `Insider` prefix from the class name
+- Convert to kebab-case
+- Examples: `InsiderAppCards` → `app-cards`, `InsiderUser` → `user`, `InsiderProduct` → `product`, `InsiderEvent` → `event`, `InsiderIdentifier` → `identifier`, `RNInsider` → `insider` (top-level facade)
+
+**IMPORTANT:** `Insider` prefix is stripped only in **file paths and document titles**. Inside code examples, type names, and prose, the original class name (`InsiderAppCards`, `RNInsiderUser`, etc.) MUST be preserved verbatim.
+
+### Step 3: Discover Public API Surface from `.d.ts`
+
+`.d.ts` files are the **single source of truth** for what is public in this codebase. Anything declared in a `.js` file but absent from its sibling `.d.ts` is internal and MUST NOT be documented.
+
+For the resolved module's `.d.ts`:
+
+1. Read the file completely with the Read tool.
+2. Extract:
+   - `export default class …` / `export class …` / `export declare class …`
+   - `export interface …` / `export type …`
+   - `export enum …` / `export const enum …`
+   - `export function …`
+   - `export { … }` re-exports
+   - Top-level `declare module 'react-native-insider' { … }` blocks (for `index.d.ts`)
+3. For each class, extract:
+   - Public methods (not prefixed with `#` or `private`): name, parameters (name + TS type + optional marker), return type
+   - Public properties / getters: name, type, read-only marker
+   - Static vs instance distinction (`static` keyword)
+   - JSDoc `/** … */` preceding each member (description, `@param`, `@returns`, `@deprecated`, `@example`)
+4. For each interface / type: name, fields (name, type, `?:` optional marker), description from JSDoc
+5. For each enum: name, values, underlying type (numeric / string)
+
+**Private field / method exclusion (MANDATORY):**
+- ES private fields (`#field`) in `.js` are never public. Even if their getter is exposed, document the getter, not the private slot.
+- TypeScript `private` / `protected` modifiers → not documented.
+- Anything in `.js` that has no counterpart in `.d.ts` → not documented.
+
+**Deprecated detection:** Scan `.d.ts` and `.js` for:
+- JSDoc `/** @deprecated … */` tags
+- `@deprecated` TypeScript annotation
+- `console.warn('… is deprecated …')` at the top of a method body
+
+If deprecations are found, record the deprecation message and any replacement API mentioned — they populate the "Deprecated APIs" section. If none are found, **omit the Deprecated APIs section entirely.**
+
+**Fluent builder detection:**
+- A class whose setters all return `this` (check `.js` bodies or `: this` in `.d.ts`) is a fluent builder.
+- In examples, show chained usage: `Insider.createNewProduct(...).setColor('red').setSize('M').setBrand('Nike');`
+- Applies to `RNInsiderUser`, `RNInsiderProduct`, `RNInsiderEvent`, `RNInsiderIdentifier`.
+
+**Static facade detection:**
+- A class whose every exported member is `static` is a static facade (e.g., `RNInsider`).
+- Emit an auto Note: `The {ClassName} class cannot be instantiated directly. Call its static methods on the default export: \`import Insider from 'react-native-insider'\`.`
+
+**Frozen singleton detection:**
+- A module exporting `Object.freeze(new SomeClass())` (e.g., `InsiderAppCards`) is a singleton accessed via a getter on the facade (`Insider.appCards`).
+- Emit an auto Note: `The {ClassName} instance cannot be constructed directly. Access it through the main Insider SDK: \`Insider.appCards\`.`
+- The "Access" subsection shows the getter usage.
+
+**Zero public API check:** If the `.d.ts` yields no public members, display:
+```
+No public API found for module at {resolved-path}.
+The .d.ts file does not export any class, interface, type, enum, or function.
+Aborting documentation generation.
+```
+Then HALT.
+
+### Step 4: Analyze Public API and Build Validation Registry
+
+Build a **validation registry** that lists every name the generated docs are allowed to reference:
+
+- All type names (classes, interfaces, type aliases, enums)
+- All method names and their full signatures
+- All property / field / enum-value names
+- All imported names from the package entry (`react-native-insider`)
+
+This registry is used in Step 10 to validate code examples. Any identifier used in a generated example that is **not** in the registry MUST be corrected before writing files.
+
+Also note characteristics that affect example generation:
+- Promise + callback duality (e.g., `getCampaigns`) → both variants shown.
+- Polymorphic second argument (e.g., `itemRemovedFromCart(productID, saleIDOrCustomParameters?, customParameters?)`) → show both shapes (string saleID, and plain object custom params).
+- Date parameters → use `new Date()` in examples; never mention epoch-millis conversion (that is bridge-internal).
+- Callback signature `(error: Error | null, value: X) => void` → used directly in callback examples.
+
+### Step 5: Discover Related Types
+
+Public methods often return or accept types defined in sibling `.d.ts` files. For each referenced type name that is **not** a TS built-in (string, number, boolean, Date, Array, Promise, Error) and **not** already processed:
+
+1. Search `src/**/*.d.ts` with the Glob tool to locate the declaration.
+2. Read that `.d.ts` and extract its public shape (same rules as Step 3).
+3. These related types MUST appear under **Core Types** in the output.
+4. Follow the chain recursively until all reachable public types are documented.
+
+Example: `InsiderAppCards.getCampaigns()` returns `Promise<InsiderAppCardsCampaignResponse>` which exposes `appCards: InsiderAppCard[]`. `InsiderAppCard` has `buttons: InsiderAppCardButton[]` and `action: InsiderAppCardAction` (polymorphic: `InsiderAppCardDeeplinkAction | InsiderAppCardFeedbackAction | InsiderAppCardOpenSettingsAction`). All of these belong under Core Types.
+
+**Do not document** types that are internal (no `.d.ts` export) or that come from `react-native` / standard library (`NativeEventEmitter`, `EmitterSubscription`, etc.).
+
+### Step 6: Trace Entry Points in `index.js` / `index.d.ts`
+
+The React Native equivalent of iOS `Insider.h` cross-reference is the top-level facade at the repo root. Read `index.js` AND `index.d.ts` and look for how the target module is reached from the `Insider` default export:
+
+- Static getter: `static get appCards(): RNInsiderAppCards` → entry is `Insider.appCards`
+- Static factory: `static createNewProduct(...): RNInsiderProduct` → entry is `Insider.createNewProduct(id, name, taxonomy, imageURL, price, currency)`
+- Static factory: `static tagEvent(name: string): RNInsiderEvent` → entry is `Insider.tagEvent('event_name')`
+- Static accessor: `static getCurrentUser(): RNInsiderUser` → entry is `Insider.getCurrentUser()`
+- Direct constructor export: `export class InsiderIdentifier` → entry is `new InsiderIdentifier().addEmail(...)`
+- Re-exported class / error: `export { InsiderAppCardsError }` → mentioned in error-handling section
+
+Use the most specific entry point for the target module. The "Getting Started → Access" subsection shows a minimal JavaScript + TypeScript example that obtains the instance or factory result.
+
+### Step 7: Read SDK Version
+
+1. Read `package.json` at the repo root.
+2. Extract the `version` field (e.g., `8.0.0`).
+3. Record today's date in `YYYY-MM-DD` format.
+
+**Version display rule:** In the document header, show only the semver (`SDK Version: 8.0.0 | Generated: YYYY-MM-DD`) — do **not** prefix with `RN-`. The `RN-` prefix is a bridge-internal SDK-identification string; it must never appear in developer-facing docs. This keeps the version badge visually identical to the iOS and Android docs.
+
+Also read from `package.json`:
+- `peerDependencies.react-native` (minimum React Native version, e.g., `>=0.83.0`)
+- `peerDependencies.react` (minimum React version, e.g., `>=19.2.0`)
+
+These populate the Prerequisites section.
+
+### Step 8: Generate Markdown Documentation
+
+**Skip this step if `--format html` was specified.**
+
+Generate a `.md` file that structurally mirrors the iOS and Android academy docs.
+
+**Template:**
+
+```
+# {Module Name}
+
+> SDK Version: {version} | Generated: {YYYY-MM-DD}
+
+{2-3 sentence module description — purpose, capabilities, ergonomics (Promise+callback duality if applicable)}
+
+> **Note:** {static facade / frozen singleton access note — only emit if the detection rule in Step 3 fired}
+
+## Contents
+
+- [Getting Started](#getting-started)
+  - [Prerequisites](#prerequisites)
+  - [Access](#access)
+- [API Reference](#api-reference)
+  - [Core Types](#core-types)
+  - [{Method Group 1}](#...)
+  - [{Method Group 2}](#...)
+- [Deprecated APIs](#deprecated-apis)   <!-- only if deprecations were found in Step 3 -->
+- [Full Example](#full-example)
+
+## Getting Started
+
+### Prerequisites
+
+- React Native >= {version from peerDependencies, fallback 0.83.0}
+- React >= {version from peerDependencies, fallback 19.2.0}
+- `react-native-insider` installed: `npm install react-native-insider`
+- iOS: `cd ios && pod install`
+- Android: no additional native setup required (autolinking)
+
+### Access
+
+{Entry point from Step 6, rendered in both JavaScript and TypeScript code blocks}
+
+**JavaScript:**
+
+```js
+import Insider from 'react-native-insider';
+
+const appCards = Insider.appCards;
+```
+
+**TypeScript:**
+
+```ts
+import Insider from 'react-native-insider';
+
+const appCards = Insider.appCards;
+```
+
+## API Reference
+
+### Core Types
+
+#### {TypeName}
+
+{Short description of the type from JSDoc, or synthesized from the module context}
+
+| Name | Type | Required | Description |
+| ---- | ---- | -------- | ----------- |
+| {field} | `{TSType}` | ✅ | {description} |
+| {field} | `{TSType}` | ⛔ | {description} |
+
+(Repeat for every Core Type discovered in Steps 3 + 5. Use the original type names verbatim — `InsiderAppCard`, not `AppCard`.)
+
+### {Method Group}
+
+#### {methodName}
+
+**JavaScript:**
+
+```js
+{method signature in JS form — e.g., Insider.appCards.getCampaigns(completion)}
+```
+
+**TypeScript:**
+
+```ts
+{method signature in TS form — e.g., Insider.appCards.getCampaigns(): Promise<InsiderAppCardsCampaignResponse>}
+```
+
+{1-3 sentence description from JSDoc or synthesized}
+
+| Name | Type | Required | Description |
+| ---- | ---- | -------- | ----------- |
+| {param} | `{TSType}` | ✅ | {description} |
+
+**Example:**
+
+**JavaScript:**
+
+```js
+import Insider from 'react-native-insider';
+
+Insider.appCards.getCampaigns((error, response) => {
+  if (error) return;
+  const cards = response.appCards;
+});
+```
+
+**TypeScript:**
+
+```ts
+import Insider, { InsiderAppCardsError } from 'react-native-insider';
+
+try {
+  const response = await Insider.appCards.getCampaigns();
+  const cards = response.appCards;
+} catch (error) {
+  if (error instanceof InsiderAppCardsError) {
+    console.warn(error.code, error.message);
+  }
+}
+```
+
+## Deprecated APIs
+
+> The following APIs are deprecated and will be removed in a future release.
+
+### {deprecatedMethodName}
+
+**Deprecated since:** {version or annotation info}
+**Replacement:** {replacement API if mentioned}
+
+{Migration guidance with before/after code in JavaScript and TypeScript}
+
+## Full Example
+
+{A complete, runnable example that uses the module end-to-end — from `Insider.init(...)` through the most important call chains. Both JavaScript and TypeScript variants.}
+```
+
+**Rules:**
+
+- **Table of Contents**: anchor-linked entries for every major section and method group.
+- **Version metadata**: SDK version and today's date as the blockquote immediately under the H1.
+- **Separate signatures**: show JavaScript and TypeScript in **separate labeled code blocks** (`**JavaScript:**` / `**TypeScript:**`) — NOT a combined "Signature" block.
+- **Required vs optional**: `✅` for required parameters/fields, `⛔` for optional (emoji glyphs, not text).
+- **Type columns**: use the exact TypeScript type from the `.d.ts`. Render backticks around types: `` `string` ``, `` `InsiderAppCard[]` ``, `` `(error: Error | null, value: X) => void` ``.
+- **`CustomParameters`** type: if a method accepts it, show the expanded form once — `{ [key: string]: string | number | boolean | Date | number[] | string[] }` — and add a sentence like "Typed key-value bag; each value's type is auto-detected and preserved across the native bridge."
+- **Promise + callback duality**: for methods that accept a completion callback AND return a Promise (App Cards), show BOTH variants in the Example block: the callback form in JavaScript, the `await` form in TypeScript (or both forms in TypeScript if space permits).
+- **Polymorphic arguments**: methods like `itemRemovedFromCart(productID, saleIDOrCustomParameters?, customParameters?)` and `visitCartPage(products, saleIDOrCustomParameters?, customParameters?)` MUST show both shapes in separate examples (string saleID AND plain object custom params). Do not rename or collapse the parameter — keep `saleIDOrCustomParameters` verbatim from `.d.ts`.
+- **Fluent builders**: show chained usage in the builder's example (`createNewProduct(...).setColor(...).setSize(...).setBrand(...)`).
+- **Method grouping**: organize methods under logical group headings — App Cards example: `Campaigns Management` (`getCampaigns`, `markAsRead`, `markAsUnread`, `delete`), `App Card Interaction` (`view`, `click`), `Button Interaction` (`clickButton`), `Error Handling` (`InsiderAppCardsError`, `InsiderAppCardsErrorCode`). For other modules, use the groupings already documented in `.orbit-output/config/architecture/API_DOCS.md` and `CODE-CATALOG.md`.
+- **Group parallelism with iOS/Android**: when a module exists on all three platforms, the group names and method order MUST match the iOS and Android docs so readers switching tabs see the same layout.
+- **Inline tips**: add `> **Tip:**` boxes where useful (observer lifecycle, convenience methods, Promise vs callback choice, etc.).
+- **Bridge details are hidden**: never mention `shouldNotProceed`, `checkParameters`, `parseObjectWithTypes`, `NativeModules.RNInsider`, 3-part product serialization, or epoch-millis-as-string conversion. Developers use the JS API; bridge plumbing is internal.
+- **Strict example validation**: every identifier (class, method, property, enum value) used in code examples MUST exist in the validation registry from Step 4.
+
+### Step 9: Generate HTML Documentation
+
+**Skip this step if `--format md` was specified.**
+
+Generate an `.html` file styled for the Insider Academy docs site. The HTML template is **intentionally identical** to the iOS and Android academy-doc-generator skill output, with only the React Native specific substitutions below.
+
+**Syntax Highlighting — Pre-tokenized Spans (MANDATORY):**
+
+Do NOT use JavaScript-based syntax highlighting (no Prism.js, no highlight.js, no runtime tokenizer). Write code blocks with **inline `<span>` elements** carrying CSS classes directly in the HTML source:
+
+```html
+<pre><code><span class="kw">const</span> <span class="param">appCards</span> = <span class="type">Insider</span>.<span class="fn">appCards</span></code></pre>
+```
+
+**CSS Classes (VS Code dark theme):**
+
+| Class | Color | Usage |
+|-------|-------|-------|
+| `.kw` | `#569cd6` (blue) | Language keywords: `const`, `let`, `var`, `function`, `class`, `if`, `else`, `for`, `in`, `return`, `await`, `async`, `import`, `from`, `export`, `default`, `new`, `try`, `catch`, `this`, `null`, `undefined`, `void`, `interface`, `type`, `enum`, `extends`, `implements`, `readonly` |
+| `.type` | `#4ec9b0` (teal) | Type names: `Insider`, `RNInsider`, `InsiderAppCards`, `InsiderAppCard`, `InsiderUser`, `String`, `Number`, `Boolean`, `Date`, `Promise`, `Error`, `Array`, `Record`, module-imported class names |
+| `.str` | `#ce9178` (orange) | String literals: `'react-native-insider'`, `"my-partner"`, template strings |
+| `.num` | `#b5cea8` (light green) | Numeric literals |
+| `.cmt` | `#6a9955` (green) | Comments: `// comment`, `/* comment */` |
+| `.ann` | `#dcdcaa` (yellow) | Decorators / annotations where applicable (`@deprecated`, JSDoc `@param`) — rare in JS/TS code, used if shown |
+| `.fn` | `#dcdcaa` (yellow) | Function / method names at call sites and declarations: `getCampaigns`, `markAsRead`, `init`, `tagEvent` |
+| `.param` | `#9cdcfe` (light blue) | Parameters and local variables: `appCards`, `error`, `response`, `completion`, `product` |
+
+**Tokenizing rules:**
+- Every identifier in `<pre><code>` blocks MUST wear one of the classes above.
+- Keywords and types outrank param when ambiguous.
+- Method names after `.` or in call position use `.fn`; variable / parameter reads use `.param`.
+- HTML entities (`&lt;`, `&gt;`, `&amp;`) must be used for `<`, `>`, `&` inside `<code>` blocks.
+
+**HTML Layout Structure:**
+
+```html
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <title>{Module Name} - Insider React Native SDK</title>
+  <style>{inline CSS — no external stylesheets}</style>
+</head>
+<body>
+  <aside class="sidebar-toc"><!-- sticky sidebar TOC, hidden below 1200px --></aside>
+  <div class="content">
+    <nav class="breadcrumb">Docs &gt; React Native SDK &gt; {Module Name}</nav>
+    <div class="version-meta">SDK Version: {version} | Generated: {YYYY-MM-DD}</div>
+    <h1>{Module Name}</h1>
+    <div class="toc"><!-- inline boxed TOC --></div>
+    <!-- Content sections: Getting Started, API Reference, Deprecated APIs (if any), Full Example -->
+  </div>
+  <script>{inline JS — tab sync + copy button + scroll-spy, no external libs}</script>
+</body>
+</html>
+```
+
+**Code block group (language switcher):**
+
+```html
+<div class="code-group">
+  <div class="lang-tabs">
+    <div class="lang-tab active" data-lang="javascript">JavaScript</div>
+    <div class="lang-tab" data-lang="typescript">TypeScript</div>
+  </div>
+  <div class="lang-content active" data-lang="javascript">
+    <div class="code-wrapper">
+      <pre><code><!-- pre-tokenized JS code with span classes --></code></pre>
+    </div>
+  </div>
+  <div class="lang-content" data-lang="typescript">
+    <div class="code-wrapper">
+      <pre><code><!-- pre-tokenized TS code with span classes --></code></pre>
+    </div>
+  </div>
+</div>
+```
+
+Tab labels are **"JavaScript"** and **"TypeScript"** (NOT "JS" / "TS", and NOT the iOS / Android pair). `data-lang` values are `javascript` and `typescript`.
+
+**Callout boxes:** `<div class="note">`, `<div class="tip">`, `<div class="warning">` — same class names as iOS and Android outputs. No `.callout` prefix.
+
+**HTML Feature Requirements:**
+
+1. **Pre-tokenized syntax highlighting** (above). No JavaScript tokenizer, no external CDN.
+2. **Copy to clipboard**: a "Copy" button injected by inline JS onto each `.code-wrapper`. Uses `navigator.clipboard.writeText(code.textContent)`.
+3. **Sticky sidebar TOC**: screens ≥ 1200px render a fixed sidebar on the left with the table of contents.
+   - `position: sticky; top: 0; height: 100vh`
+   - Highlight the current section using `IntersectionObserver` with `rootMargin: '-20% 0px -70% 0px'`
+   - Hide on narrower screens via media query
+4. **Inline TOC**: keep the boxed TOC at the top of the content area; visible on all screen sizes.
+5. **Tab switcher**: clicking a `.lang-tab` in any `.code-group` synchronizes ALL `.code-group` blocks on the page to the same `data-lang`.
+6. **Version metadata**: SDK version + generation date as a subtle bar immediately below the breadcrumb.
+7. **Deprecated APIs**: if present, render with an amber/yellow warning callout style and include migration guidance.
+8. **Self-contained**: all CSS and JS inline. No external stylesheets, fonts (beyond system-ui fallbacks), or scripts.
+9. **Light theme only** for page chrome; dark theme only inside code blocks (VS Code dark palette above).
+
+**Per-platform substitutions (vs. iOS and Android skills):**
+
+| Element | Value |
+|---------|-------|
+| Page `<title>` | `{Module Name} - Insider React Native SDK` |
+| Breadcrumb | `Docs > React Native SDK > {Module Name}` |
+| Language tab labels | `JavaScript`, `TypeScript` |
+| `data-lang` values | `javascript`, `typescript` |
+| Version badge source | `package.json` → `version` field (no `RN-` prefix) |
+
+Every other aspect of the HTML (CSS classes, layout, interactivity, callout styling, table styling, emoji choices) MUST match the iOS and Android outputs exactly.
+
+### Step 10: Validate Generated Code Examples
+
+Before writing any output file, perform a strict validation pass:
+
+1. Extract every identifier (class name, method name, property / field name, enum value, imported name) from all code examples in both the Markdown and HTML outputs.
+2. Cross-reference each against the validation registry built in Step 4.
+3. Names from the registry are valid. Names from standard JS/TS (`console`, `Error`, `Promise`, `await`, `new`, `import`, `export`, `const`, `let`, `var`, `function`, `async`, `try`, `catch`, `if`, `else`, `return`) are valid. Names from `react-native-insider` public exports (from `index.d.ts`) are valid.
+4. Any identifier not covered by the above is a validation failure:
+   - Log a warning: `Warning: Example references non-existent API: {name}`
+   - Fix the example to use a correct registry name
+   - Re-run validation until clean
+5. Proceed to Step 11 only after validation is clean (or report failures and abort if something cannot be fixed automatically).
+
+### Step 11: Write Output Files
+
+**If `--dry-run` was specified:** skip this step entirely. Display the summary (Step 12) and exit.
+
+Determine the output directory:
+- If `--output <dir>` was provided, use that directory.
+- Otherwise, use `docs/{module-name}/` (where `{module-name}` is the kebab-cased name from Step 2).
+
+Only write the file(s) matching the selected format:
+- If `--format md`: write only `{output-dir}/{module-name}.md`
+- If `--format html`: write only `{output-dir}/{module-name}.html`
+- If no `--format` flag: write both files
+
+Create the output directory if it does not exist. Use the Write tool.
+
+### Step 12: Summary
+
+Display a summary containing:
+
+- Module resolved: `{moduleName}` at `{jsPath}` (+ `.d.ts`)
+- Public classes / interfaces / enums documented (counts)
+- Public methods documented (count)
+- Core types discovered across sibling `.d.ts` files (count)
+- Deprecated APIs found (count — 0 if none)
+- Entry point(s) used for Access section
+- Example validation: `PASSED` or `N fixes applied`
+- Output format(s) generated: `md`, `html`, `both`, or `DRY RUN (no files written)`
+- SDK version and generation date
+- Output file paths (or `N/A` if dry run)
+- Reminder: run the iOS (`mobile-ios`) and Android (`mobileandroid`) `/academy-doc-generator` for the same module to keep the three platform docs in sync.
+
+</agent-activation>
+
+## Project Context
+
+- **SDK**: Insider React Native SDK (JavaScript + TypeScript declarations, native bridge to iOS / Android)
+- **Academy URL**: `https://academy.insiderone.com/docs/react-native-advanced-integration`
+- **Public API Detection**: `.d.ts` files are the source of truth. Anything exported from a `.d.ts` is public; anything in `.js` without a `.d.ts` counterpart is internal.
+- **Version Source**: `package.json` → `version` (displayed as plain semver; the bridge-internal `RN-` prefix is never shown in docs)
+- **Cross-Platform Consistency**: iOS (`mobile-ios`) and Android (`mobileandroid`) repositories have a same-named skill. Section order, emoji set, version-badge style, HTML template, callout boxes are identical across all three so the Academy pages line up.
+- **Bridge Layer**: JS → `NativeModules.RNInsider` → native Insider SDK. Bridge implementation details (`shouldNotProceed`, `checkParameters`, `parseObjectWithTypes`, 3-part product serialization, epoch-millis-string dates) are hidden from the generated docs.
+
+## Key Paths
+
+- **JS source root**: `src/` (plus `index.js` at repo root for the top-level facade)
+- **TypeScript declarations**: sibling `.d.ts` next to every public `.js`
+- **Top-level facade**: `index.js` + `index.d.ts` — `RNInsider` default export plus re-exports (`InsiderAppCardsError`, `InsiderAppCardsErrorCode`, enums)
+- **Version file**: `package.json`
+- **Architecture docs**: `.orbit-output/config/architecture/ARCHITECTURE.md`, `CODE-CATALOG.md`, `API_DOCS.md`, `project.yaml` — use for method grouping and cross-reference when generating sections
+- **Code style rules**: `.claude/rules/code-style.md` — naming, fluent API, parameter validation conventions
+- **Output (default)**: `docs/{module-name}/` at repo root
+- **iOS reference skill**: `~/Documents/development/insider/mobile-ios/.orbit-output/skills/custom/academy-doc-generator.md`
+- **Android reference skill**: `~/Documents/development/insider/mobileandroid/.orbit-output/skills/custom/academy-doc-generator.md`
+- **Reference PDF outputs**: `~/Downloads/App-Cards-iOS.pdf`, `~/Downloads/App-Cards-Android.pdf`
+
+## Examples
+
+### Example 1: Generate both formats (default)
+
+```bash
+/academy-doc-generator InsiderAppCards
+```
+
+Outputs:
+- `docs/app-cards/app-cards.md`
+- `docs/app-cards/app-cards.html`
+
+### Example 2: Generate only Markdown
+
+```bash
+/academy-doc-generator src/InsiderUser.js --format md
+```
+
+Outputs:
+- `docs/user/user.md`
+
+### Example 3: Generate only HTML with custom output directory
+
+```bash
+/academy-doc-generator InsiderProduct --format html --output ~/Desktop/rn-docs
+```
+
+Outputs:
+- `~/Desktop/rn-docs/product.html`
+
+### Example 4: Dry run to preview discovery
+
+```bash
+/academy-doc-generator InsiderEvent --dry-run
+```
+
+Outputs:
+- No files written. Summary displays resolved module, public API surface, related types, entry point, and example-validation status.
+
+### Example 5: Event builder (fluent builder example)
+
+```bash
+/academy-doc-generator InsiderEvent
+```
+
+Outputs:
+- `docs/event/event.md`
+- `docs/event/event.html`
+
+Showcases chained `tagEvent('name').addParameterWithString(...).addParameterWithInt(...).build()` usage in examples (detected via the fluent-builder rule in Step 3).
+
+### Example 6: Identifier (constructor-based entry point)
+
+```bash
+/academy-doc-generator InsiderIdentifier
+```
+
+Outputs:
+- `docs/identifier/identifier.md`
+- `docs/identifier/identifier.html`
+
+Access section shows `new InsiderIdentifier().addEmail(...)` (detected via Step 6 entry-point tracing).
+
+---
+*Generated by: skill-creator-agent | Based on: .orbit-output/config/architecture/ | Aligned with: mobile-ios and mobileandroid academy-doc-generator skills*

package/LICENSE

@@ -1,7 +1,9 @@
-Copyright 2016 Insider
+MIT License
+
+Copyright (c) 2016 Insider
 
 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.
+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.

package/README.md

@@ -1,9 +1,10 @@
-# React Native Insider SDK
+# Insider ReactNative SDK
 
-Official React Native SDK for [Insider](https://useinsider.com/) - A single platform for building individualized, cross-channel customer experiences.
+Official React Native SDK for [Insider](https://www.insiderone.com) - A single platform for building individualized, cross-channel customer experiences.
 
+[![Coverus](https://github.com/useinsider/coverus-artifacts/raw/main/badges/github/useinsider/react-native-insider/coverage.svg)](http://coverus.internal.dataforce/app/project/github/useinsider/react-native-insider)
 [![npm version](https://img.shields.io/npm/v/react-native-insider.svg)](https://www.npmjs.com/package/react-native-insider)
-[![License](https://img.shields.io/badge/license-Commercial-blue.svg)](https://useinsider.com)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
 ## Features
 
@@ -699,7 +700,7 @@ function App() {
 
 ## Support
 
-- **Documentation**: [Insider Developer Hub](https://academy.useinsider.com/docs)
+- **Documentation**: [Insider Developer Hub](https://academy.insiderone.com/docs/react-native-integration)
 - **GitHub**: [useinsider/react-native-insider](https://github.com/useinsider/react-native-insider)
 - **Issues**: [Report issues](https://github.com/useinsider/react-native-insider/issues)
 - **Email**: Contact your Insider representative
@@ -707,4 +708,3 @@ function App() {
 ## License
 
 This SDK is provided by Insider. Please refer to your commercial agreement with Insider for licensing terms.
-# Test

package/RNInsider.podspec

@@ -9,12 +9,12 @@ Pod::Spec.new do |s|
   s.authors      = package_json['author']
   s.license      = 'MIT'
   s.platform     = :ios, '12.0'
-  s.source = {:http => 'https://mobilesdk.useinsider.com/iOS/15.0.1/InsiderMobileIOSFramework.zip'}
+  s.source = {:http => 'https://mobilesdk.useinsider.com/iOS/15.0.3/InsiderMobileIOSFramework.zip'}
   s.source_files = 'ios/RNInsider/*.{h,m}'
   s.requires_arc = true
   s.static_framework = true
   s.dependency 'React'
-  s.dependency 'InsiderMobile', '15.0.1'
+  s.dependency 'InsiderMobile', '15.0.3'
   s.dependency 'InsiderGeofence', '1.2.4'
   s.dependency 'InsiderHybrid', '1.7.6'
 

package/android/build.gradle

@@ -47,7 +47,7 @@ repositories {
 
 dependencies {
     implementation "com.facebook.react:react-native:${getVersionFromPartner('reactNativeVersion', '+')}"
-    implementation 'com.useinsider:insider:16.0.1'
+    implementation 'com.useinsider:insider:16.0.3'
     implementation 'com.useinsider:insiderhybrid:1.3.4'
 
     implementation 'androidx.security:security-crypto:1.1.0-alpha06'