craft-native 0.0.174 → 0.0.176

package/dist/android/templates/build.gradle.kts.app.template

@@ -59,6 +59,9 @@ android {
 
     buildFeatures {
         viewBinding = true
+        // BuildConfig.DEBUG: debug-only code (the crash reporter's test
+        // crash) is a constant false in release, so R8 removes it.
+        buildConfig = true
     }
 
     // Android's default AAPT ignore pattern drops underscore-prefixed asset
@@ -94,8 +97,7 @@ dependencies {
     // Google Play Location Services (for geolocation)
     implementation("com.google.android.gms:play-services-location:21.1.0")
 
-    // Native STX Map overlays and trail routes
-    implementation("com.google.android.gms:play-services-maps:18.2.0")
+{{GOOGLE_MAPS_DEPENDENCY}}
 
     // Google Play In-App Review
     implementation("com.google.android.play:review:2.0.1")

package/dist/api/mobile.d.ts

@@ -762,6 +762,36 @@ export declare const speech: {
     /** Stop speaking at once. Every pending `speak()` resolves `false`. */
     stop(): Promise<void>;
 };
+export interface CrashReporterContext {
+    enabled: boolean;
+    platform?: 'ios' | 'android';
+    release?: string;
+    environment?: string;
+    session?: {
+        id: string;
+        startedAt: string;
+    };
+    contexts?: Record<string, Record<string, unknown>>;
+    [key: string]: unknown;
+}
+export declare const crashReporter: {
+    /** True inside an app whose config turns crash reporting on. */
+    isAvailable(): boolean;
+    /** Queue an event in the bughq ingest shape (`type`, `message`, `stack`, ...). */
+    capture(event: Record<string, unknown>): Promise<boolean>;
+    /** The app's own user id (never an email), or null on sign-out. */
+    setUser(id: string | number | null): Promise<boolean>;
+    addBreadcrumb(breadcrumb: {
+        type?: string;
+        category?: string;
+        level?: string;
+        message?: string;
+        data?: Record<string, unknown>;
+    }): Promise<boolean>;
+    flush(): Promise<boolean>;
+    /** The release, session and device context the native reporter stamps on events. */
+    context(): Promise<CrashReporterContext | null>;
+};
 export type MusicAuthorization = 'authorized' | 'denied' | 'restricted' | 'notDetermined' | 'unavailable';
 export type MusicPlaybackState = 'stopped' | 'playing' | 'paused' | 'interrupted' | 'seekingForward' | 'seekingBackward' | 'unknown';
 export interface NowPlaying {
@@ -1640,6 +1670,7 @@ declare const mobile: {
     keepAwake: typeof keepAwake;
     brightness: typeof brightness;
     speech: typeof speech;
+    crashReporter: typeof crashReporter;
     music: typeof music;
     heartRate: typeof heartRate;
     scheduledWorkouts: typeof scheduledWorkouts;

package/dist/cli.js

@@ -3303,7 +3303,7 @@ function pinCraftNativeDependency(packagePath, craftVersion) {
 `);
 }
 // package.json
-var version = "0.0.174";
+var version = "0.0.176";
 
 // bin/cli.ts
 var spawnedFrom = process6.env[CRAFT_CLI_SPAWN_MARKER];

package/dist/components/index.d.ts

@@ -314,6 +314,16 @@ export interface ViewProps extends BaseProps {
     /** Pointer events behavior */
     pointerEvents?: 'auto' | 'none' | 'box-none' | 'box-only';
 }
+/** Safe-area container props used by native iOS and Android screens. */
+export interface SafeAreaViewProps extends ViewProps {
+    /** Insets to apply; omitted means all edges. */
+    edges?: Array<'top' | 'right' | 'bottom' | 'left'>;
+}
+/** Keyboard-aware container props used by native screens. */
+export interface KeyboardAvoidingViewProps extends ViewProps {
+    behavior?: 'height' | 'position' | 'padding';
+    keyboardVerticalOffset?: number;
+}
 /**
  * Text component props.
  */
@@ -331,6 +341,29 @@ export interface TextProps extends BaseProps {
     /** Long press handler */
     onLongPress?: () => void;
 }
+/** Native button/link action props. */
+export interface ButtonProps extends BaseProps {
+    title?: string;
+    onPress?: () => void;
+    disabled?: boolean;
+    color?: string;
+}
+/** Link is a button with link semantics in the native renderer. */
+export interface LinkProps extends ButtonProps {
+    href?: string;
+    to?: string;
+}
+export interface TouchableOpacityProps extends ViewProps {
+    activeOpacity?: number;
+    disabled?: boolean;
+}
+export interface TouchableHighlightProps extends ViewProps {
+    underlayColor?: string;
+    activeOpacity?: number;
+    disabled?: boolean;
+    onShowUnderlay?: () => void;
+    onHideUnderlay?: () => void;
+}
 /**
  * Image source type.
  */
@@ -367,6 +400,84 @@ export interface ImageProps extends BaseProps {
     /** Alt text for accessibility */
     alt?: string;
 }
+export interface IconProps extends BaseProps {
+    name?: string;
+    symbol?: string;
+    color?: string;
+}
+export interface VideoProps extends BaseProps {
+    source?: string | {
+        uri: string;
+    };
+    src?: string;
+    controls?: boolean;
+    autoplay?: boolean;
+    autoPlay?: boolean;
+    loop?: boolean;
+    muted?: boolean;
+    paused?: boolean;
+    resizeMode?: 'contain' | 'cover' | 'stretch';
+    onLoad?: (event: {
+        duration: number;
+    }) => void;
+    onPlay?: () => void;
+    onPause?: () => void;
+    onEnd?: () => void;
+    onProgress?: (event: {
+        currentTime: number;
+        duration: number;
+    }) => void;
+    onError?: (event: {
+        message: string;
+    }) => void;
+}
+export interface MapRegion {
+    center: {
+        latitude: number;
+        longitude: number;
+    };
+    span: {
+        latitudeDelta: number;
+        longitudeDelta: number;
+    };
+}
+export interface MapProps extends BaseProps {
+    region?: MapRegion;
+    fitToBounds?: boolean;
+    showsUserLocation?: boolean;
+    scrollEnabled?: boolean;
+    zoomEnabled?: boolean;
+    rotateEnabled?: boolean;
+    mapType?: 'standard' | 'satellite' | 'hybrid' | 'terrain';
+    onMarkerPress?: (event: {
+        nativeEvent: {
+            id: string;
+        };
+    }) => void;
+}
+export interface MapPolylineProps extends BaseProps {
+    geometry: number[];
+    strokeColor?: string;
+    strokeWidth?: number;
+}
+export interface MapMarkerProps extends BaseProps {
+    geometry: number[];
+    id: string;
+    title?: string;
+    onPress?: (event: {
+        nativeEvent: {
+            id: string;
+        };
+    }) => void;
+    onMarkerPress?: (event: {
+        nativeEvent: {
+            id: string;
+        };
+    }) => void;
+}
+export interface ImageBackgroundProps extends ImageProps {
+    imageStyle?: ImageStyle | ImageStyle[];
+}
 /**
  * ScrollView component props.
  */
@@ -454,9 +565,9 @@ export interface TextInputProps extends BaseProps {
     /** Placeholder text color */
     placeholderTextColor?: string;
     /** Keyboard type */
-    keyboardType?: 'default' | 'email-address' | 'numeric' | 'phone-pad' | 'decimal-pad' | 'url';
+    keyboardType?: KeyboardType;
     /** Return key type */
-    returnKeyType?: 'done' | 'go' | 'next' | 'search' | 'send';
+    returnKeyType?: ReturnKeyType;
     /** Auto capitalize */
     autoCapitalize?: 'none' | 'sentences' | 'words' | 'characters';
     /** Auto correct */
@@ -486,6 +597,71 @@ export interface TextInputProps extends BaseProps {
     /** End editing handler */
     onEndEditing?: () => void;
 }
+export type KeyboardType = 'default' | 'email-address' | 'numeric' | 'phone-pad' | 'number-pad' | 'decimal-pad' | 'url' | 'web-search' | 'visible-password' | 'ascii-capable' | 'numbers-and-punctuation' | 'name-phone-pad' | 'twitter';
+export type ReturnKeyType = 'done' | 'go' | 'next' | 'search' | 'send' | 'join' | 'route' | 'continue' | 'emergency-call' | 'default';
+export interface SwitchProps extends BaseProps {
+    value?: boolean;
+    onValueChange?: (value: boolean) => void;
+    disabled?: boolean;
+    trackColor?: {
+        false?: string;
+        true?: string;
+    };
+    thumbColor?: string;
+    ios_backgroundColor?: string;
+}
+export interface CheckboxProps extends BaseProps {
+    value?: boolean;
+    checked?: boolean;
+    indeterminate?: boolean;
+    label?: string;
+    onValueChange?: (value: boolean) => void;
+    disabled?: boolean;
+    color?: string;
+}
+export interface SliderProps extends BaseProps {
+    value?: number;
+    minimumValue?: number;
+    maximumValue?: number;
+    step?: number;
+    onValueChange?: (value: number) => void;
+    onSlidingComplete?: (value: number) => void;
+    disabled?: boolean;
+    minimumTrackTintColor?: string;
+    maximumTrackTintColor?: string;
+    thumbTintColor?: string;
+}
+export interface PickerOption {
+    label: string;
+    value: string | number;
+}
+export interface PickerProps extends BaseProps {
+    items: PickerOption[];
+    selectedValue?: string | number;
+    onValueChange?: (value: string | number, index: number) => void;
+    disabled?: boolean;
+}
+export interface DatePickerChange {
+    value: string;
+    iso: string;
+    timestamp: number;
+}
+export interface DatePickerProps extends BaseProps {
+    mode?: 'date' | 'time' | 'datetime' | 'countdown';
+    value?: string | number;
+    minimumDate?: string | number;
+    maximumDate?: string | number;
+    minuteInterval?: number;
+    display?: 'compact' | 'inline' | 'wheels';
+    onValueChange?: (event: DatePickerChange) => void;
+    disabled?: boolean;
+}
+export interface ActivityIndicatorProps extends BaseProps {
+    color?: string;
+    animating?: boolean;
+    hidesWhenStopped?: boolean;
+    size?: 'small' | 'large' | number;
+}
 /**
  * FlatList component props.
  */
@@ -530,6 +706,31 @@ export interface FlatListProps<T> extends ScrollViewProps {
     /** Refreshing state */
     refreshing?: boolean;
 }
+export interface SectionListSection<T> {
+    data: T[];
+    key?: string;
+    title?: string;
+}
+export interface SectionListProps<T> extends ScrollViewProps {
+    sections: SectionListSection<T>[];
+    renderItem: (info: {
+        item: T;
+        index: number;
+        section: SectionListSection<T>;
+    }) => any;
+    renderSectionHeader?: (info: {
+        section: SectionListSection<T>;
+    }) => any;
+    keyExtractor?: (item: T, index: number) => string;
+}
+export interface ModalProps extends BaseProps {
+    visible?: boolean;
+    transparent?: boolean;
+    animationType?: 'none' | 'fade' | 'slide';
+    onShow?: () => void;
+    onDismiss?: () => void;
+    onRequestClose?: () => void;
+}
 /**
  * Layout event.
  */

package/dist/index.cjs

@@ -310,7 +310,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.174";
+var version = "0.0.176";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;

package/dist/index.d.cts

@@ -30,7 +30,7 @@ export * from './utils/index.js';
 export * from './api/index.js';
 export * as components from './components/index.js';
 export { createTahoeSidebar, createArcSidebar, createOrbStackSidebar, sidebarItem, sidebarSection, sidebarSeparator, tahoeStyle, arcStyle, orbstackStyle, createSplitView, SplitViewInstance, createFileBrowser, FileBrowserInstance, createOutlineView, OutlineViewInstance, createTableView, TableViewInstance, showQuickLook, hideQuickLook, canQuickLook, showColorPicker, showFontPicker, showDatePicker, createProgress, ProgressInstance, setToolbar, updateToolbarItem, setToolbarVisible, setTouchBar, updateTouchBarItem, StyleSheet, Animated, } from './components/index.js';
-export type { ContextMenuItem, SidebarStyle, SidebarPosition, SidebarHeaderConfig, SidebarFooterConfig, SidebarEventType, SidebarEventMap, SidebarEventHandler, ComponentProps, ComponentInstance, SplitViewOrientation, SplitViewDividerStyle, SplitViewConfig, FileBrowserConfig, FileBrowserSelection, OutlineItem, OutlineViewConfig, TableRow, TableViewConfig, QuickLookConfig, ColorPickerConfig, FontPickerConfig, FontResult, DatePickerConfig, ProgressConfig, ToolbarItem, ToolbarConfig, TouchBarConfig, FlexStyle, LayoutStyle, SpacingStyle, BorderStyle, ColorStyle, ShadowStyle, TransformStyle, ViewStyle, TextStyleProps, TextStyle, ImageStyleProps, ImageStyle, BaseProps, ViewProps, TextProps, ImageSource, ImageProps, ScrollViewProps, PressableProps, TextInputProps, FlatListProps, LayoutEvent, ScrollEvent, } from './components/index.js';
+export type { ContextMenuItem, SidebarStyle, SidebarPosition, SidebarHeaderConfig, SidebarFooterConfig, SidebarEventType, SidebarEventMap, SidebarEventHandler, ComponentProps, ComponentInstance, SplitViewOrientation, SplitViewDividerStyle, SplitViewConfig, FileBrowserConfig, FileBrowserSelection, OutlineItem, OutlineViewConfig, TableRow, TableViewConfig, QuickLookConfig, ColorPickerConfig, FontPickerConfig, FontResult, DatePickerConfig, ProgressConfig, ToolbarItem, ToolbarConfig, TouchBarConfig, FlexStyle, LayoutStyle, SpacingStyle, BorderStyle, ColorStyle, ShadowStyle, TransformStyle, ViewStyle, TextStyleProps, TextStyle, ImageStyleProps, ImageStyle, BaseProps, ViewProps, SafeAreaViewProps, KeyboardAvoidingViewProps, TextProps, ButtonProps, LinkProps, TouchableOpacityProps, TouchableHighlightProps, ImageSource, ImageProps, ImageBackgroundProps, IconProps, VideoProps, MapRegion, MapProps, MapPolylineProps, MapMarkerProps, ScrollViewProps, PressableProps, TextInputProps, KeyboardType, ReturnKeyType, SwitchProps, CheckboxProps, SliderProps, PickerOption, PickerProps, DatePickerChange, DatePickerProps, ActivityIndicatorProps, FlatListProps, SectionListSection, SectionListProps, ModalProps, LayoutEvent, ScrollEvent, } from './components/index.js';
 export * from './styles/headwind.js';
 export * from './styles/index.js';
 export * from './optimizations/index.js';

package/dist/index.d.ts

@@ -30,7 +30,7 @@ export * from './utils/index.js';
 export * from './api/index.js';
 export * as components from './components/index.js';
 export { createTahoeSidebar, createArcSidebar, createOrbStackSidebar, sidebarItem, sidebarSection, sidebarSeparator, tahoeStyle, arcStyle, orbstackStyle, createSplitView, SplitViewInstance, createFileBrowser, FileBrowserInstance, createOutlineView, OutlineViewInstance, createTableView, TableViewInstance, showQuickLook, hideQuickLook, canQuickLook, showColorPicker, showFontPicker, showDatePicker, createProgress, ProgressInstance, setToolbar, updateToolbarItem, setToolbarVisible, setTouchBar, updateTouchBarItem, StyleSheet, Animated, } from './components/index.js';
-export type { ContextMenuItem, SidebarStyle, SidebarPosition, SidebarHeaderConfig, SidebarFooterConfig, SidebarEventType, SidebarEventMap, SidebarEventHandler, ComponentProps, ComponentInstance, SplitViewOrientation, SplitViewDividerStyle, SplitViewConfig, FileBrowserConfig, FileBrowserSelection, OutlineItem, OutlineViewConfig, TableRow, TableViewConfig, QuickLookConfig, ColorPickerConfig, FontPickerConfig, FontResult, DatePickerConfig, ProgressConfig, ToolbarItem, ToolbarConfig, TouchBarConfig, FlexStyle, LayoutStyle, SpacingStyle, BorderStyle, ColorStyle, ShadowStyle, TransformStyle, ViewStyle, TextStyleProps, TextStyle, ImageStyleProps, ImageStyle, BaseProps, ViewProps, TextProps, ImageSource, ImageProps, ScrollViewProps, PressableProps, TextInputProps, FlatListProps, LayoutEvent, ScrollEvent, } from './components/index.js';
+export type { ContextMenuItem, SidebarStyle, SidebarPosition, SidebarHeaderConfig, SidebarFooterConfig, SidebarEventType, SidebarEventMap, SidebarEventHandler, ComponentProps, ComponentInstance, SplitViewOrientation, SplitViewDividerStyle, SplitViewConfig, FileBrowserConfig, FileBrowserSelection, OutlineItem, OutlineViewConfig, TableRow, TableViewConfig, QuickLookConfig, ColorPickerConfig, FontPickerConfig, FontResult, DatePickerConfig, ProgressConfig, ToolbarItem, ToolbarConfig, TouchBarConfig, FlexStyle, LayoutStyle, SpacingStyle, BorderStyle, ColorStyle, ShadowStyle, TransformStyle, ViewStyle, TextStyleProps, TextStyle, ImageStyleProps, ImageStyle, BaseProps, ViewProps, SafeAreaViewProps, KeyboardAvoidingViewProps, TextProps, ButtonProps, LinkProps, TouchableOpacityProps, TouchableHighlightProps, ImageSource, ImageProps, ImageBackgroundProps, IconProps, VideoProps, MapRegion, MapProps, MapPolylineProps, MapMarkerProps, ScrollViewProps, PressableProps, TextInputProps, KeyboardType, ReturnKeyType, SwitchProps, CheckboxProps, SliderProps, PickerOption, PickerProps, DatePickerChange, DatePickerProps, ActivityIndicatorProps, FlatListProps, SectionListSection, SectionListProps, ModalProps, LayoutEvent, ScrollEvent, } from './components/index.js';
 export * from './styles/headwind.js';
 export * from './styles/index.js';
 export * from './optimizations/index.js';

package/dist/index.js

@@ -58,7 +58,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.174";
+var version = "0.0.176";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;

package/dist/ios/src/index.d.ts

@@ -239,6 +239,25 @@ export interface CraftConfig {
      * `craft.secureStorage.getSync('auth.token')`. Turns on secure storage.
      */
     shareStorage?: Record<string, string>;
+    /**
+     * Crash and error reporting to bughq (CraftCrashReporter.swift): crashes
+     * and hangs (signal handlers, NSException, MetricKit), uncaught JavaScript
+     * errors in native screens and the app script, and what the page sends
+     * through `craft.crashReporter`. Queued on disk and sent when online.
+     */
+    crashReporting?: CraftCrashReporting;
+}
+export interface CraftCrashReporting {
+    /** The bughq project's public ingest key. Ships in the app; it is not a secret. */
+    key: string;
+    /** The bughq host. Default https://bughq.org. */
+    host?: string;
+    /** Default `production`. */
+    environment?: string;
+    /** The release every event names. Default `<version>+<build>`, e.g. `1.0.0+41`. */
+    release?: string;
+    /** One session per launch, for crash-free sessions per release. Default on. */
+    sessions?: boolean;
 }
 export interface CraftTab {
     /** The tab's root path; comes back to the page in `craftTabSelect`. */

package/dist/ios/src/index.js

@@ -643,7 +643,9 @@ function renderFeatureSettings(config) {
 }
 function renderPrivacyManifest(config) {
   const privacy = config.privacy ?? {};
-  const collected = privacy.collectedDataTypes ?? [];
+  const collected = [...privacy.collectedDataTypes ?? []];
+  if (config.crashReporting?.key && !collected.some((item) => item.type === "NSPrivacyCollectedDataTypeCrashData"))
+    collected.push({ type: "NSPrivacyCollectedDataTypeCrashData", linked: true, tracking: false, purposes: ["NSPrivacyCollectedDataTypePurposeAppFunctionality"] });
   const accessed = privacy.accessedApiTypes ?? [];
   const collectedXml = collected.map((item) => `        <dict>
             <key>NSPrivacyCollectedDataType</key>
@@ -1009,6 +1011,7 @@ function writeShell(output, config) {
   cpSync(join3(TEMPLATES_DIR, "CraftNativeFiles.swift"), join3(output, "Sources", "CraftNativeFiles.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftWebAudio.swift"), join3(output, "Sources", "CraftWebAudio.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftHybrid.swift"), join3(output, "Sources", "CraftHybrid.swift"));
+  writeFileSync2(join3(output, "Sources", "CraftCrashReporter.swift"), readFileSync2(join3(TEMPLATES_DIR, "CraftCrashReporter.swift"), "utf-8").replace(/\{\{CRAFT_VERSION\}\}/g, CRAFT_VERSION));
   cpSync(join3(TEMPLATES_DIR, "CraftActivityAttributes.swift"), join3(output, "Shared", "CraftActivityAttributes.swift"));
   for (const [enabled, folder, template, filename] of [
     [config.enableLiveActivities, "WidgetExtension", "CraftLiveActivityWidget.swift.template", `${name}LiveActivity.swift`],
@@ -1083,6 +1086,7 @@ async function init(options) {
       - Shared
     settings:
       INFOPLIST_FILE: WidgetExtension/Info.plist
+      PRODUCT_NAME: "$(TARGET_NAME)"
       PRODUCT_BUNDLE_IDENTIFIER: ${finalBundleId}.liveactivity
       SWIFT_VERSION: "5.0"
       APPLICATION_EXTENSION_API_ONLY: YES
@@ -1098,6 +1102,7 @@ async function init(options) {
     settings:
       INFOPLIST_FILE: WatchApp/Info.plist
       CODE_SIGN_ENTITLEMENTS: WatchApp/Watch.entitlements
+      PRODUCT_NAME: "$(TARGET_NAME)"
       PRODUCT_BUNDLE_IDENTIFIER: ${finalBundleId}.watchkitapp
       SWIFT_VERSION: "5.0"
       SKIP_INSTALL: YES
@@ -1112,6 +1117,7 @@ async function init(options) {
     settings:
       INFOPLIST_FILE: WatchExtension/Info.plist
       CODE_SIGN_ENTITLEMENTS: WatchExtension/Watch.entitlements
+      PRODUCT_NAME: "$(TARGET_NAME)"
       PRODUCT_BUNDLE_IDENTIFIER: ${finalBundleId}.watchkitapp.watchkitextension
       SWIFT_VERSION: "5.0"
       APPLICATION_EXTENSION_API_ONLY: YES

package/dist/ios/templates/CraftApp.swift

@@ -194,8 +194,10 @@ struct CraftRecoveryBudget {
 
 final class CraftAppDelegate: NSObject, UIApplicationDelegate, UNUserNotificationCenterDelegate {
     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool {
-        UNUserNotificationCenter.current().delegate = self
         let config = CraftConfig.bundled()
+        // First, so a crash anywhere in the rest of launch is reported too.
+        CraftCrashReporter.shared.start(config)
+        UNUserNotificationCenter.current().delegate = self
         // Before launch finishes, which is the only time iOS accepts it.
         CraftBackgroundWork.shared.registerRefresh(config)
         // The shell, the app script and an all-native app's services now,
@@ -1297,6 +1299,9 @@ struct CraftConfig: Codable {
     /// The bundle route of the app script: a screen-less script that runs for
     /// the app's whole life and hears the app's events (CraftHybrid.swift).
     var nativeApp: String? = nil
+    /// Crash and error reporting to bughq (CraftCrashReporter.swift). Off
+    /// unless the config names a project key.
+    var crashReporting: CrashReporting? = nil
 
     struct Tab: Codable {
         var id: String
@@ -1311,6 +1316,18 @@ struct CraftConfig: Codable {
         /// The soonest iOS may run it again, in minutes (15 if unset).
         var minimumIntervalMinutes: Double? = nil
     }
+
+    struct CrashReporting: Codable {
+        /// The bughq project's public ingest key.
+        var key: String
+        /// The bughq host; https://bughq.org if unset.
+        var host: String? = nil
+        var environment: String? = nil
+        /// The release events name; `<version>+<build>` if unset.
+        var release: String? = nil
+        /// A session per launch, for crash-free sessions. On unless false.
+        var sessions: Bool? = nil
+    }
 }
 
 extension CraftConfig {
@@ -3458,6 +3475,7 @@ struct CraftWebView: UIViewRepresentable {
                     heartRate: \(config.enableHeartRate),
                     scheduledWorkouts: \(config.enableScheduledWorkouts),
                     speech: true,
+                    crashReporter: \(CraftCrashReporter.shared.enabled),
                     network: true,
                     deviceInfo: true,
                     badge: true,
@@ -4451,6 +4469,38 @@ struct CraftWebView: UIViewRepresentable {
                     }
                 },
 
+                // Crash and error reporting (CraftCrashReporter.swift). The
+                // page's error SDK hands its events here, so they share the
+                // app's on-disk outbox (sent when online), its session and the
+                // device's own context. Each resolves at once: the work is a
+                // file write, and the send happens later.
+                crashReporter: {
+                    _post: function(message) {
+                        var self = window.craft;
+                        var id = 'cb_' + (++self._callbackId);
+                        message.callbackId = id;
+                        window.webkit.messageHandlers.craft.postMessage(message);
+                        return new Promise(function(resolve, reject) {
+                            self._callbacks[id] = {resolve: resolve, reject: reject};
+                        });
+                    },
+                    capture: function(event) {
+                        return this._post({action: 'crashReporterCapture', event: event || {}});
+                    },
+                    setUser: function(id) {
+                        return this._post({action: 'crashReporterSetUser', id: id == null ? null : String(id)});
+                    },
+                    addBreadcrumb: function(breadcrumb) {
+                        return this._post({action: 'crashReporterAddBreadcrumb', breadcrumb: breadcrumb || {}});
+                    },
+                    flush: function() {
+                        return this._post({action: 'crashReporterFlush'});
+                    },
+                    context: function() {
+                        return this._post({action: 'crashReporterContext'});
+                    }
+                },
+
                 // Orientation Lock
                 lockOrientation: function(orientation) {
                     var self = this;