@fixback/expo 0.2.0 → 0.3.0

package/dist/breadcrumbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.js","sourceRoot":"","sources":["../src/breadcrumbs.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -8,39 +8,35 @@
  * (`FixbackProvider`) is a thin shell over this: it feeds accelerometer
  * samples, listens for `present` events, and renders the composer.
  *
+ * `start()` is deliberately three named steps — {@link FixbackOptions} validation,
+ * `resolveIdentity`, then `armCapture` — rather than one long procedure, so the
+ * lifecycle reads as what it is and each step is testable on its own.
+ *
  * Every platform touchpoint is an injected adapter (`FixbackAdapters`), so the
  * whole orchestration is unit-tested without React Native. Every path is
  * defensive: a Fixback problem leaves the host app untouched — `start` resolves
  * to a `disabled` client instead of throwing.
  */
-import { type BootAnswer } from "./boot";
-import { type BeforeBreadcrumb, type ConsoleLike, type XhrConstructor } from "./breadcrumbs";
+import { type BootAnswer, type CaptureToggles, type CommonCaptureInitOptions, DEFAULT_API_URL, type FetchLike, type IdentityInputs, type ReporterIdentity } from "@fixback/sdk-core";
+import { type ConsoleLike, type XhrConstructor } from "./breadcrumbs";
+import { type OpenAuthSession } from "./connect";
+import { type SecureStorageLike } from "./reporter-session-store";
 import { type AppStateLike, type ErrorUtilsLike } from "./error-capture";
-import type { FetchLike, FormDataFactory } from "./http";
+import type { FormDataFactory } from "./http";
 import { type StorageLike } from "./identity";
+import { canonicalizeOrigin } from "./origin";
 import { type EnvironmentInputs } from "./report";
-import { type BeforeSend } from "./scrub";
-import { type ShakeTuning } from "./shake";
+import { type ResolvedShakeConfig, type ShakeOptions } from "./shake";
 import { type ScreenshotFile, type SubmitResult } from "./submit";
-/** Where reports go when no `apiUrl` is configured (mirrors the web SDK). */
-export declare const DEFAULT_API_URL = "https://api.fixback.dev";
-/** How often the accelerometer reports while the gesture is armed. */
-export declare const DEFAULT_SHAKE_SAMPLE_INTERVAL_MS = 80;
-/** The shake gesture's init options: the tuning plus an off switch. */
-export interface ShakeOptions extends Partial<ShakeTuning> {
-    /** Arm the shake gesture. Defaults to `true`. */
-    readonly enabled?: boolean;
-    /**
-     * The accelerometer update interval to request, in ms. Defaults to
-     * {@link DEFAULT_SHAKE_SAMPLE_INTERVAL_MS}. The interval is global to the
-     * sensor in `expo-sensors` — the SDK only sets it when no other listener is
-     * registered, and apps that drive the accelerometer themselves should align
-     * this with their own setting.
-     */
-    readonly sampleIntervalMs?: number;
-}
-/** Everything `FixbackProvider` / `createFixbackClient` accepts. */
-export interface FixbackOptions {
+export { DEFAULT_API_URL };
+export { canonicalizeOrigin };
+export { DEFAULT_SHAKE_SAMPLE_INTERVAL_MS, type ResolvedShakeConfig, type ShakeOptions, } from "./shake";
+/**
+ * Everything `FixbackProvider` / `createFixbackClient` accepts: the shared init
+ * vocabulary (`apiUrl`, `release`, `environment`, `enabled`, `scrub`, `beforeSend`,
+ * `beforeBreadcrumb`, `capture`) plus what only a React Native app has.
+ */
+export interface FixbackOptions extends CommonCaptureInitOptions, IdentityInputs {
     /** The Project's publishable key. Required. */
     readonly key: string;
     /**
@@ -49,32 +45,29 @@ export interface FixbackOptions {
      * Project — e.g. `https://com.acme.myapp` or the product's web origin.
      */
     readonly origin: string;
-    /** The Fixback API base URL. Defaults to {@link DEFAULT_API_URL}. */
-    readonly apiUrl?: string;
-    /** A customer-server-minted signed identity (spec 0003 §F). */
-    readonly signedIdentity?: string;
-    /** A persisted Reporter handle, when the host app manages one. */
-    readonly reporterId?: string;
-    /** Override the SDK-managed anonymous id. */
-    readonly anonymousId?: string;
-    /** Display-only Reporter name/email riding on every submission. */
-    readonly reporterName?: string;
-    readonly reporterEmail?: string;
-    /** Per-stream capture toggles; unset streams follow the boot answer. */
-    readonly capture?: {
-        readonly console?: boolean;
-        readonly network?: boolean;
-    };
-    /** Automatic error capture. Defaults to `true` (ADR-0011). */
+    /**
+     * Where the platform's connect page returns after a Connect (ADR-0032; ticket #251)
+     * — a scheme (`myapp://fixback-connect`) or universal link the app handles, declared
+     * once here and passed to the in-app auth session. Its origin must be allowlisted on
+     * the Project (the server validates the return URL). Without it, `signIn` stays a
+     * no-op — a report still files anonymously where the Gate allows.
+     */
+    readonly returnUrl?: string;
+    /**
+     * Automatic error capture — the SDK files uncaught JS errors as `source: error`
+     * Feedback with no prompt (spec 0004 §E, ADR-0011). Defaults to `true`; set
+     * `false` for the per-project toggle that turns it off. It is gated by boot's
+     * `canSubmit` either way, so an auto-error is never filed where a manual report
+     * would be refused.
+     */
     readonly autoCapture?: boolean;
+    /**
+     * Per-stream capture toggles; unset streams follow the boot answer. Session
+     * replay is web-only, so only the two mobile streams are accepted here.
+     */
+    readonly capture?: Omit<CaptureToggles, "replay">;
     /** Capture a screenshot when the composer opens. Defaults to `true`. */
     readonly screenshots?: boolean;
-    /** The per-project client scrub hook (spec 0003 §C). */
-    readonly beforeSend?: BeforeSend;
-    /** Run the built-in default scrubbers. Defaults to `true`. */
-    readonly scrub?: boolean;
-    /** A per-crumb filter for the trace buffer. */
-    readonly beforeBreadcrumb?: BeforeBreadcrumb | null;
     /** Shake gesture tuning / off switch. */
     readonly shake?: ShakeOptions;
 }
@@ -85,6 +78,17 @@ export interface FixbackOptions {
 export interface FixbackAdapters {
     /** Anonymous-id persistence (AsyncStorage). Absent ⇒ ephemeral ids. */
     readonly storage?: StorageLike | null;
+    /**
+     * Secure persistence for the Reporter session token after a Connect (SecureStore).
+     * Absent ⇒ no persisted session (Connect still works for this launch).
+     */
+    readonly secureStore?: SecureStorageLike | null;
+    /**
+     * Opens the platform's connect page in an in-app auth session and resolves when it
+     * returns via the app's `returnUrl` (`expo-web-browser`). Absent ⇒ `signIn` is a
+     * no-op.
+     */
+    readonly openAuthSession?: OpenAuthSession | null;
     /** Reads the device environment (window size, OS description). */
     readonly environment?: () => EnvironmentInputs;
     /** Captures the current screen as a file reference; `null` on failure. */
@@ -100,7 +104,7 @@ export interface FixbackAdapters {
     /** The `AppState` seam for occurrence flushes. */
     readonly appState?: AppStateLike | null;
     /** The transport seams. */
-    readonly fetchImpl?: FetchLike;
+    readonly fetch?: FetchLike;
     readonly formData?: FormDataFactory;
     /** A development-only warning sink (silent in production builds). */
     readonly warn?: (message: string) => void;
@@ -119,11 +123,6 @@ export interface ComposerDraft {
     /** The screenshot to attach (the presented one, unless removed). */
     readonly screenshot?: ScreenshotFile | null;
 }
-/** The resolved shake configuration the provider arms the gesture with. */
-export interface ResolvedShakeConfig extends ShakeTuning {
-    readonly enabled: boolean;
-    readonly sampleIntervalMs: number;
-}
 /** The headless client `FixbackProvider` drives. */
 export interface FixbackClient {
     /** Boot and arm capture. Idempotent; never throws. */
@@ -153,22 +152,21 @@ export interface FixbackClient {
     discardScreenshot(screenshot: ScreenshotFile | null | undefined): void;
     /** The resolved shake tuning for the provider to arm. */
     shakeConfig(): ResolvedShakeConfig;
+    /**
+     * Start a **Connect** (ADR-0032): open the platform's connect page in an in-app auth
+     * session, bind the signed-in Account to this app as a Reporter session (stored in
+     * SecureStore), and re-boot — so a gated Project's shake gesture arms once the Account
+     * is eligible. Resolves to the resulting identity. Never throws.
+     */
+    signIn(): Promise<ReporterIdentity>;
+    /** Clear the Reporter session — revoke it server-side, forget the token, re-boot. */
+    signOut(): Promise<void>;
+    /** The current Reporter identity — anonymous, or a connected Account with its tier. */
+    identity(): ReporterIdentity;
+    /** Subscribe to identity changes (boot, sign in, sign out). Returns an unsubscribe. */
+    onIdentity(listener: (identity: ReporterIdentity) => void): () => void;
     /** Tear down every hook. Safe to call repeatedly. */
     destroy(): void;
 }
-/**
- * Canonicalize the configured origin exactly as the server's `normalizeOrigin`
- * does when an allowlist entry is stored (`apps/api/src/projects/origin.ts`):
- * lowercase the scheme and host, elide default ports, and drop any userinfo,
- * path, query, or fragment. The server compares the `Origin` header by exact
- * string equality against those canonical rows — on the web the browser
- * serializes the header, but here the SDK is the serializer, so without this a
- * pasted `https://com.acme.MyApp` (bundle ids legally carry uppercase) would
- * silently never match its own allowlist entry. Implemented without `URL`
- * (React Native's polyfill is partial); a value that doesn't parse as an
- * http(s) origin is kept trimmed — boot will simply refuse it. IDN hosts are
- * not punycoded (the one divergence from the server; use the encoded form).
- */
-export declare function canonicalizeOrigin(value: string): string;
 /** Create the headless client. See the module doc. */
 export declare function createFixbackClient(options: FixbackOptions, adapters?: FixbackAdapters): FixbackClient;