@goliapkg/sentori-expo 0.1.0

package/README.md

@@ -0,0 +1,111 @@
+# @goliapkg/sentori-expo
+
+Expo adapter for Sentori — Config Plugin marker, runtime init helper
+that reads `expo-application`, and an EAS post-build hook for source
+map uploads. Built on `@goliapkg/sentori-react-native@>=0.2.0`.
+
+## Install
+
+```bash
+bunx expo install @goliapkg/sentori-expo @goliapkg/sentori-react-native expo-application
+```
+
+## Wire it up
+
+### 1. app.json
+
+```json
+{
+  "expo": {
+    "plugins": ["@goliapkg/sentori-expo"]
+  }
+}
+```
+
+The plugin is currently a marker — `@goliapkg/sentori-react-native`
+ships its own `expo-module.config.json`, podspec, and Android gradle,
+so Expo Modules autolinking handles the native side. The plugin entry
+gives us a stable extension point for future native config (SDK
+version banner, opt-in crash-handler tuning, etc.) without changing
+your `app.json`.
+
+### 2. App.tsx
+
+```tsx
+import * as Application from 'expo-application'
+import { initSentoriExpo } from '@goliapkg/sentori-expo'
+
+initSentoriExpo({
+  application: Application,
+  token: process.env.EXPO_PUBLIC_SENTORI_TOKEN!,
+})
+
+export default function App() { /* ... */ }
+```
+
+`initSentoriExpo`:
+- Derives the release string `applicationId@version+build` from
+  `expo-application`.
+- Defaults the environment to `dev`/`prod` via the RN `__DEV__` flag.
+- Defaults the ingest URL to the public SaaS endpoint.
+
+You can override any of those — see `InitOptions`.
+
+If you're not on Expo's managed workflow, omit `application` and pass
+`release` explicitly:
+
+```tsx
+initSentoriExpo({
+  release: 'myapp@1.2.3+42',
+  token: process.env.EXPO_PUBLIC_SENTORI_TOKEN!,
+})
+```
+
+### 3. EAS source map upload (optional, recommended)
+
+Add to `eas.json`:
+
+```json
+{
+  "build": {
+    "production": {
+      "hooks": {
+        "postPublish": [
+          {
+            "config": "@goliapkg/sentori-expo/eas-post-build",
+            "options": {
+              "release": "$EAS_BUILD_RELEASE"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+The hook shells out to `@goliapkg/sentori-cli upload sourcemap` — install
+it as a dev dep:
+
+```bash
+bun add -D @goliapkg/sentori-cli
+```
+
+> Status: Phase 22 sub-A lands the actual `upload sourcemap` and
+> `upload dsym` CLI subcommands. Until then the hook logs a warning
+> and exits 0 — adopt the wiring now and the upload works
+> transparently when you next bump `@goliapkg/sentori-cli`.
+
+## What `initSentoriExpo` does under the hood
+
+```
+@goliapkg/sentori-expo
+  └── reads expo-application metadata
+  └── calls @goliapkg/sentori-react-native init({ token, release, ... })
+        └── starts the JS-layer global error / promise / network hooks
+        └── primes the native iOS / Android crash handlers
+```
+
+The full feature list (breadcrumbs, capture, network instrumentation,
+native crash capture) lives in `@goliapkg/sentori-react-native` —
+`-expo` only adds the auto-config + EAS plumbing.

package/app.plugin.js

@@ -0,0 +1,39 @@
+/**
+ * Sentori Expo Config Plugin.
+ *
+ * `@goliapkg/sentori-react-native` already exposes
+ * `expo-module.config.json` + iOS podspec + Android build.gradle, so
+ * Expo Modules autolinking handles the native side without any
+ * additional config-plugins work. The Config Plugin entry exists
+ * mainly as a marker so users can drop:
+ *
+ *   {
+ *     "expo": {
+ *       "plugins": ["@goliapkg/sentori-expo"]
+ *     }
+ *   }
+ *
+ * into their app.json without breaking the build, and so we can
+ * extend it later (e.g. SDK-version metadata in Info.plist /
+ * AndroidManifest, native crash-handler opt-ins) without changing
+ * the user-facing wiring.
+ *
+ * The plugin is intentionally CommonJS — Expo's plugin loader uses
+ * `require()`.
+ */
+const { withInfoPlist } = require('@expo/config-plugins')
+
+const SENTORI_VERSION_KEY = 'SentoriSdkVersion'
+
+/**
+ * @param {import('@expo/config-plugins').ExpoConfig} config
+ * @param {{ sdkVersion?: string }} [props]
+ */
+const withSentori = (config, props = {}) => {
+  return withInfoPlist(config, (cfg) => {
+    cfg.modResults[SENTORI_VERSION_KEY] = props.sdkVersion || '0.1.0'
+    return cfg
+  })
+}
+
+module.exports = withSentori

package/lib/index.d.ts

@@ -0,0 +1,35 @@
+import type { ExpoApplicationLike, InitOptions } from './types.js';
+/**
+ * Drop-in init for Expo apps. Reads bundleId / version / build from
+ * `expo-application` (which is shipped in every Expo SDK) so the
+ * caller only has to supply the token. Falls back to manual config
+ * fields when expo-application isn't installed (bare RN apps), in
+ * which case the caller MUST pass `release`.
+ *
+ *     // App.tsx
+ *     import { initSentoriExpo } from '@goliapkg/sentori-expo'
+ *     import * as Application from 'expo-application'
+ *
+ *     initSentoriExpo({
+ *       application: Application,
+ *       token: process.env.EXPO_PUBLIC_SENTORI_TOKEN!,
+ *     })
+ *
+ * Why we ask the caller to import `expo-application` and pass it in,
+ * instead of `import * as Application from 'expo-application'` here?
+ * Bundlers (Metro / Hermes) statically include every import; if this
+ * package imported expo-application directly, every consumer would
+ * be forced to install it even when running in a bare-RN context.
+ */
+export declare function initSentoriExpo(options: InitOptions): void;
+/**
+ * Build a `slug@version+build` release string from expo-application.
+ * Returns `undefined` when the module isn't available so the caller
+ * can fall back to a manually-supplied release.
+ *
+ * Exported for callers who want to use the same string outside of
+ * init (e.g. as a tag, log prefix, or metric label).
+ */
+export declare function deriveRelease(app: ExpoApplicationLike | undefined): string | undefined;
+export type { ExpoApplicationLike, InitOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAElE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAe1D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,mBAAmB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAOtF;AAWD,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}

package/lib/index.js

@@ -0,0 +1,64 @@
+// Phase 21 sub-D: Expo runtime helpers.
+//
+// The Config Plugin (app.plugin.js) is loaded by Expo at prebuild
+// time; this module is what apps import from JS at runtime.
+import { init as initSentoriRN } from '@goliapkg/sentori-react-native';
+/**
+ * Drop-in init for Expo apps. Reads bundleId / version / build from
+ * `expo-application` (which is shipped in every Expo SDK) so the
+ * caller only has to supply the token. Falls back to manual config
+ * fields when expo-application isn't installed (bare RN apps), in
+ * which case the caller MUST pass `release`.
+ *
+ *     // App.tsx
+ *     import { initSentoriExpo } from '@goliapkg/sentori-expo'
+ *     import * as Application from 'expo-application'
+ *
+ *     initSentoriExpo({
+ *       application: Application,
+ *       token: process.env.EXPO_PUBLIC_SENTORI_TOKEN!,
+ *     })
+ *
+ * Why we ask the caller to import `expo-application` and pass it in,
+ * instead of `import * as Application from 'expo-application'` here?
+ * Bundlers (Metro / Hermes) statically include every import; if this
+ * package imported expo-application directly, every consumer would
+ * be forced to install it even when running in a bare-RN context.
+ */
+export function initSentoriExpo(options) {
+    const release = options.release ?? deriveRelease(options.application);
+    if (!release) {
+        throw new Error('[sentori-expo] could not derive release. ' +
+            'Either pass `release` explicitly, or pass `application: Application` ' +
+            'from `import * as Application from "expo-application"`.');
+    }
+    initSentoriRN({
+        environment: options.environment ?? (isDev() ? 'dev' : 'prod'),
+        ingestUrl: options.ingestUrl ?? 'https://ingest.sentori.golia.jp',
+        release,
+        token: options.token,
+    });
+}
+/**
+ * Build a `slug@version+build` release string from expo-application.
+ * Returns `undefined` when the module isn't available so the caller
+ * can fall back to a manually-supplied release.
+ *
+ * Exported for callers who want to use the same string outside of
+ * init (e.g. as a tag, log prefix, or metric label).
+ */
+export function deriveRelease(app) {
+    if (!app)
+        return undefined;
+    const id = app.applicationId ?? app.nativeApplicationVersion ?? 'app';
+    const version = app.nativeApplicationVersion ?? '0.0.0';
+    const build = app.nativeBuildVersion ?? '0';
+    return `${id}@${version}+${build}`;
+}
+function isDev() {
+    // RN's __DEV__ is true under Metro dev server; bare false in
+    // Hermes release builds. typeof check keeps this safe to import in
+    // Node tests where __DEV__ doesn't exist.
+    return typeof __DEV__ !== 'undefined' && __DEV__;
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,EAAE;AACF,kEAAkE;AAClE,4DAA4D;AAE5D,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAItE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,eAAe,CAAC,OAAoB;IAClD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IACrE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,2CAA2C;YACzC,uEAAuE;YACvE,yDAAyD,CAC5D,CAAA;IACH,CAAC;IACD,aAAa,CAAC;QACZ,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9D,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,iCAAiC;QACjE,OAAO;QACP,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,GAAoC;IAChE,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAC1B,MAAM,EAAE,GACN,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,wBAAwB,IAAI,KAAK,CAAA;IAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,wBAAwB,IAAI,OAAO,CAAA;IACvD,MAAM,KAAK,GAAG,GAAG,CAAC,kBAAkB,IAAI,GAAG,CAAA;IAC3C,OAAO,GAAG,EAAE,IAAI,OAAO,IAAI,KAAK,EAAE,CAAA;AACpC,CAAC;AAED,SAAS,KAAK;IACZ,6DAA6D;IAC7D,mEAAmE;IACnE,0CAA0C;IAC1C,OAAO,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAA;AAClD,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Subset of the `expo-application` module we read for release
+ * derivation. Defining a structural type instead of importing the
+ * module keeps `expo-application` a peer dep that the Expo runtime
+ * provides — bare-RN consumers don't need to install it.
+ */
+export type ExpoApplicationLike = {
+    /** e.g. "com.example.myapp" — Android applicationId / iOS bundleId. */
+    applicationId?: null | string;
+    /** e.g. "5" — Android versionCode / iOS CFBundleVersion. */
+    nativeBuildVersion?: null | string;
+    /** e.g. "1.2.3" — iOS CFBundleShortVersionString / Android versionName. */
+    nativeApplicationVersion?: null | string;
+};
+export type InitOptions = {
+    /** Pass `import * as Application from 'expo-application'` here. */
+    application?: ExpoApplicationLike;
+    /** Override the auto-derived environment. Defaults to dev/prod via __DEV__. */
+    environment?: string;
+    /** Override ingest URL (self-hosted). Defaults to public SaaS. */
+    ingestUrl?: string;
+    /** Manual release override — required when `application` is omitted. */
+    release?: string;
+    /** Project public token, format `st_pk_...`. */
+    token: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,uEAAuE;IACvE,aAAa,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IAC7B,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IAClC,2EAA2E;IAC3E,wBAAwB,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,mEAAmE;IACnE,WAAW,CAAC,EAAE,mBAAmB,CAAA;IACjC,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAA;CACd,CAAA"}

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@goliapkg/sentori-expo",
+  "version": "0.1.0",
+  "description": "Expo adapter for Sentori — Config Plugin marker, expo-application auto-config, EAS post-build helper. Built on @goliapkg/sentori-react-native.",
+  "license": "MIT",
+  "homepage": "https://sentori.golia.jp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/goliajp/sentori.git",
+    "directory": "sdk/expo"
+  },
+  "bugs": {
+    "url": "https://github.com/goliajp/sentori/issues"
+  },
+  "keywords": [
+    "sentori",
+    "error-tracking",
+    "expo",
+    "react-native",
+    "config-plugin"
+  ],
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./app.plugin.js": "./app.plugin.js",
+    "./eas-post-build": "./scripts/eas-post-build.mjs"
+  },
+  "files": [
+    "lib/",
+    "src/",
+    "app.plugin.js",
+    "scripts/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "prepack": "bun run build"
+  },
+  "peerDependencies": {
+    "@goliapkg/sentori-react-native": ">=0.2.0",
+    "expo": ">=50",
+    "expo-application": ">=5",
+    "react-native": ">=0.74"
+  },
+  "peerDependenciesMeta": {
+    "expo-application": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@expo/config-plugins": "^9 || ^10"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/eas-post-build.mjs

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+/**
+ * EAS post-build hook for Sentori source map upload.
+ *
+ * Wire it from app.json / eas.json:
+ *
+ *   {
+ *     "build": {
+ *       "production": {
+ *         "ios": { "buildArtifactPaths": ["ios/build/**\/*.dSYM"] },
+ *         "hooks": {
+ *           "postPublish": [
+ *             {
+ *               "config": "@goliapkg/sentori-expo/eas-post-build",
+ *               "options": { "release": "myapp@1.2.3+42" }
+ *             }
+ *           ]
+ *         }
+ *       }
+ *     }
+ *   }
+ *
+ * Or call this script directly from a custom build hook:
+ *
+ *   #!/bin/sh
+ *   node ./node_modules/@goliapkg/sentori-expo/scripts/eas-post-build.mjs \
+ *     --token $SENTORI_ADMIN_TOKEN --release "$EAS_BUILD_RELEASE"
+ *
+ * The script shells out to `sentori-cli` for the actual upload (Phase 22
+ * sub-A introduces `sentori-cli upload dsym`). Until that lands this is
+ * a stub that logs what it would have done — adopt sub-D in your
+ * pipeline now and the CLI integration arrives transparently.
+ */
+
+import { spawnSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+
+const args = parseArgs(process.argv.slice(2))
+
+const token = args.token ?? process.env.SENTORI_ADMIN_TOKEN
+const release = args.release ?? process.env.EAS_BUILD_RELEASE
+const ingestUrl = args.ingest ?? process.env.SENTORI_INGEST_URL
+
+if (!token || !release) {
+  console.error(
+    '[sentori-expo:eas-post-build] missing --token or --release ' +
+      '(env: SENTORI_ADMIN_TOKEN, EAS_BUILD_RELEASE)',
+  )
+  process.exit(1)
+}
+
+const cli = resolveCli()
+if (!cli) {
+  console.warn(
+    '[sentori-expo:eas-post-build] sentori-cli not found on PATH or in node_modules. ' +
+      'Skipping upload — install @goliapkg/sentori-cli to enable. ' +
+      'Phase 22 sub-A will land the proper upload subcommand.',
+  )
+  process.exit(0)
+}
+
+const cmd = [
+  'upload',
+  'sourcemap',
+  '--token',
+  token,
+  '--release',
+  release,
+  ...(ingestUrl ? ['--ingest', ingestUrl] : []),
+  // Default Expo build output for the JS bundle + sourcemap.
+  './dist',
+]
+
+console.log(`[sentori-expo:eas-post-build] running: ${cli} ${cmd.join(' ')}`)
+const r = spawnSync(cli, cmd, { stdio: 'inherit' })
+process.exit(r.status ?? 0)
+
+function parseArgs(argv) {
+  const out = {}
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i]
+    if (a.startsWith('--')) {
+      out[a.slice(2)] = argv[i + 1]
+      i++
+    }
+  }
+  return out
+}
+
+function resolveCli() {
+  // Prefer node_modules/.bin so the locked @goliapkg/sentori-cli wins
+  // over a globally-installed older copy.
+  for (const p of [
+    './node_modules/.bin/sentori-cli',
+    './node_modules/@goliapkg/sentori-cli/bin/sentori-cli.js',
+  ]) {
+    if (existsSync(p)) return p
+  }
+  // PATH lookup as last resort.
+  const which = spawnSync('which', ['sentori-cli'])
+  const found = which.stdout?.toString().trim()
+  return found || null
+}

package/src/__tests__/derive-release.test.ts

@@ -0,0 +1,37 @@
+import { describe, expect, test } from 'bun:test'
+
+import { deriveRelease } from '../index.js'
+
+describe('deriveRelease', () => {
+  test('builds slug@version+build from expo-application fields', () => {
+    expect(
+      deriveRelease({
+        applicationId: 'com.example.myapp',
+        nativeApplicationVersion: '1.2.3',
+        nativeBuildVersion: '42',
+      }),
+    ).toBe('com.example.myapp@1.2.3+42')
+  })
+
+  test('substitutes defaults for missing fields', () => {
+    expect(
+      deriveRelease({
+        applicationId: 'com.example.myapp',
+      }),
+    ).toBe('com.example.myapp@0.0.0+0')
+  })
+
+  test('returns undefined when module is missing', () => {
+    expect(deriveRelease(undefined)).toBeUndefined()
+  })
+
+  test('handles null fields gracefully (Expo bare workflow)', () => {
+    expect(
+      deriveRelease({
+        applicationId: null,
+        nativeApplicationVersion: null,
+        nativeBuildVersion: null,
+      }),
+    ).toBe('app@0.0.0+0')
+  })
+})

package/src/index.ts

@@ -0,0 +1,75 @@
+// Phase 21 sub-D: Expo runtime helpers.
+//
+// The Config Plugin (app.plugin.js) is loaded by Expo at prebuild
+// time; this module is what apps import from JS at runtime.
+
+import { init as initSentoriRN } from '@goliapkg/sentori-react-native'
+
+import type { ExpoApplicationLike, InitOptions } from './types.js'
+
+/**
+ * Drop-in init for Expo apps. Reads bundleId / version / build from
+ * `expo-application` (which is shipped in every Expo SDK) so the
+ * caller only has to supply the token. Falls back to manual config
+ * fields when expo-application isn't installed (bare RN apps), in
+ * which case the caller MUST pass `release`.
+ *
+ *     // App.tsx
+ *     import { initSentoriExpo } from '@goliapkg/sentori-expo'
+ *     import * as Application from 'expo-application'
+ *
+ *     initSentoriExpo({
+ *       application: Application,
+ *       token: process.env.EXPO_PUBLIC_SENTORI_TOKEN!,
+ *     })
+ *
+ * Why we ask the caller to import `expo-application` and pass it in,
+ * instead of `import * as Application from 'expo-application'` here?
+ * Bundlers (Metro / Hermes) statically include every import; if this
+ * package imported expo-application directly, every consumer would
+ * be forced to install it even when running in a bare-RN context.
+ */
+export function initSentoriExpo(options: InitOptions): void {
+  const release = options.release ?? deriveRelease(options.application)
+  if (!release) {
+    throw new Error(
+      '[sentori-expo] could not derive release. ' +
+        'Either pass `release` explicitly, or pass `application: Application` ' +
+        'from `import * as Application from "expo-application"`.',
+    )
+  }
+  initSentoriRN({
+    environment: options.environment ?? (isDev() ? 'dev' : 'prod'),
+    ingestUrl: options.ingestUrl ?? 'https://ingest.sentori.golia.jp',
+    release,
+    token: options.token,
+  })
+}
+
+/**
+ * Build a `slug@version+build` release string from expo-application.
+ * Returns `undefined` when the module isn't available so the caller
+ * can fall back to a manually-supplied release.
+ *
+ * Exported for callers who want to use the same string outside of
+ * init (e.g. as a tag, log prefix, or metric label).
+ */
+export function deriveRelease(app: ExpoApplicationLike | undefined): string | undefined {
+  if (!app) return undefined
+  const id =
+    app.applicationId ?? app.nativeApplicationVersion ?? 'app'
+  const version = app.nativeApplicationVersion ?? '0.0.0'
+  const build = app.nativeBuildVersion ?? '0'
+  return `${id}@${version}+${build}`
+}
+
+function isDev(): boolean {
+  // RN's __DEV__ is true under Metro dev server; bare false in
+  // Hermes release builds. typeof check keeps this safe to import in
+  // Node tests where __DEV__ doesn't exist.
+  return typeof __DEV__ !== 'undefined' && __DEV__
+}
+
+declare const __DEV__: boolean
+
+export type { ExpoApplicationLike, InitOptions } from './types.js'

package/src/types.ts

@@ -0,0 +1,27 @@
+/**
+ * Subset of the `expo-application` module we read for release
+ * derivation. Defining a structural type instead of importing the
+ * module keeps `expo-application` a peer dep that the Expo runtime
+ * provides — bare-RN consumers don't need to install it.
+ */
+export type ExpoApplicationLike = {
+  /** e.g. "com.example.myapp" — Android applicationId / iOS bundleId. */
+  applicationId?: null | string
+  /** e.g. "5" — Android versionCode / iOS CFBundleVersion. */
+  nativeBuildVersion?: null | string
+  /** e.g. "1.2.3" — iOS CFBundleShortVersionString / Android versionName. */
+  nativeApplicationVersion?: null | string
+}
+
+export type InitOptions = {
+  /** Pass `import * as Application from 'expo-application'` here. */
+  application?: ExpoApplicationLike
+  /** Override the auto-derived environment. Defaults to dev/prod via __DEV__. */
+  environment?: string
+  /** Override ingest URL (self-hosted). Defaults to public SaaS. */
+  ingestUrl?: string
+  /** Manual release override — required when `application` is omitted. */
+  release?: string
+  /** Project public token, format `st_pk_...`. */
+  token: string
+}