npm - @ohm_studio/sdk-react-native - Versions diffs - 0.1.0 → 0.3.0 - Mend

@ohm_studio/sdk-react-native 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/README.md CHANGED Viewed

@@ -1,8 +1,10 @@
-# @ohm_studio/sdk-react-native
+# OHM RN SDK · `@ohm_studio/sdk-react-native`
+> The **short name** is `OHM RN SDK`. The **full npm name** is `@ohm_studio/sdk-react-native` — that's what you install. Both names refer to the same package.
 OHM Studio SDK for **React Native / Expo** — voice-to-structured-JSON clinical extraction inside your mobile app. Multi-language STT, FHIR-shaped outputs, formulary-aware prescriptions.
-> For web / Node, install [`@ohm_studio/sdk`](https://www.npmjs.com/package/@ohm_studio/sdk) instead.
+> For web / Node, install [`@ohm_studio/sdk`](https://www.npmjs.com/package/@ohm_studio/sdk) (**OHM SDK**) instead.
 ## Install

package/dist/index.d.ts CHANGED Viewed

@@ -1,6 +1,8 @@
 import { OHMCoreClient } from "@ohm_studio/sdk-core";
-import type { OHMClientOptions } from "@ohm_studio/sdk-core";
+import type { OHMInit } from "@ohm_studio/sdk-core";
 export * from "@ohm_studio/sdk-core";
+export { ExpoRecorder, RecorderError, isExpoAvAvailable, } from "./recorder";
+export type { ExpoRecorderOptions, RNFile, RecorderState, RecorderErrorCode, } from "./recorder";
 /**
  * OHM Studio SDK for React Native.
  *
@@ -24,12 +26,13 @@ export * from "@ohm_studio/sdk-core";
  *   });
  */
 export declare class OHM extends OHMCoreClient {
-    constructor(opts: OHMClientOptions);
+    constructor(init: OHMInit);
     protected runMultipart<T>(opts: {
         path: string;
         file: any;
         fields?: Record<string, string>;
     }): Promise<T>;
+    protected buildMultipartBody(file: unknown, fields?: Record<string, string>): Promise<unknown>;
 }
 export default OHM;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,~~EAAE~~,~~gBAAgB~~,EAAE,MAAM,sBAAsB,CAAC;~~AAE7D~~,cAAc,sBAAsB,CAAC;~~AAYrC~~;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,GAAI,SAAQ,aAAa;gBACxB,IAAI,EAAE,~~gBAAgB~~;~~cAclB~~,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE;QACpC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,GAAG,CAAC;QACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,GAAG,OAAO,CAAC,CAAC,CAAC;~~CA2Bf~~;AAED,eAAe,GAAG,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAoB,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEtE,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,mBAAmB,EACnB,MAAM,EACN,aAAa,EACb,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAYpB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,GAAI,SAAQ,aAAa;gBACxB,IAAI,EAAE,OAAO;cAiBT,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE;QACpC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,GAAG,CAAC;QACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,GAAG,OAAO,CAAC,CAAC,CAAC;cAQE,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;CAuBpB;AAED,eAAe,GAAG,CAAC"}

package/dist/index.js CHANGED Viewed

@@ -1,5 +1,6 @@
 import { OHMConfigError, OHMCoreClient } from "@ohm_studio/sdk-core";
 export * from "@ohm_studio/sdk-core";
+export { ExpoRecorder, RecorderError, isExpoAvAvailable, } from "./recorder";
 /** Detect React Native runtime — used to gate the bundled-key safeguard. */
 function isReactNative() {
     return (
@@ -31,8 +32,10 @@ function isReactNative() {
  *   });
  */
 export class OHM extends OHMCoreClient {
-    constructor(opts) {
-        if (isReactNative() &&
+    constructor(init) {
+        const opts = typeof init === "string" ? { apiKey: init } : init;
+        if (!opts.mock &&
+            isReactNative() &&
             opts.apiKey?.startsWith("ohms_live_") &&
             !opts.acknowledgeBundledKey) {
             throw new OHMConfigError({
@@ -42,29 +45,31 @@ export class OHM extends OHMCoreClient {
         super(opts);
     }
     async runMultipart(opts) {
+        const fd = (await this.buildMultipartBody(opts.file, opts.fields));
+        return this.requestRaw("POST", opts.path, { body: fd });
+    }
+    async buildMultipartBody(file, fields) {
         const fd = new FormData();
-        if (opts.file &&
-            typeof opts.file === "object" &&
-            "uri" in opts.file) {
-            // RN FormData accepts this shape directly.
+        if (file && typeof file === "object" && "uri" in file) {
+            const f = file;
+            // RN FormData accepts the { uri, name, type } shape directly.
             // @ts-ignore — RN's FormData type isn't standard.
             fd.append("file", {
-                uri: opts.file.uri,
-                name: opts.file.name || "audio.m4a",
-                type: opts.file.type || "audio/mp4",
+                uri: f.uri,
+                name: f.name || "audio.m4a",
+                type: f.type || "audio/mp4",
             });
         }
-        else if (typeof Blob !== "undefined" && opts.file instanceof Blob) {
-            // Some RN polyfills support Blob.
-            fd.append("file", opts.file, "audio.bin");
+        else if (typeof Blob !== "undefined" && file instanceof Blob) {
+            fd.append("file", file, "audio.bin");
         }
         else {
             throw new Error("Unsupported file input on React Native — pass `{ uri, name, type }`");
         }
-        for (const [k, v] of Object.entries(opts.fields || {})) {
+        for (const [k, v] of Object.entries(fields || {})) {
             fd.append(k, v);
         }
-        return this.requestRaw("POST", opts.path, { body: fd });
+        return fd;
     }
 }
 export default OHM;

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrE,cAAc,sBAAsB,CAAC;~~AAErC~~,4EAA4E;AAC5E,SAAS,aAAa;IACpB,OAAO;IACL,+BAA+B;IAC/B,OAAO,SAAS,KAAK,WAAW;QAChC,aAAa;QACb,SAAS,CAAC,OAAO,KAAK,aAAa,CACpC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,GAAI,SAAQ,aAAa;IACpC,YAAY,~~IAAsB~~;~~QAChC~~,IACE,aAAa,EAAE;YACf,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,YAAY,CAAC;YACrC,CAAC,IAAI,CAAC,qBAAqB,EAC3B,CAAC;YACD,MAAM,IAAI,cAAc,CAAC;gBACvB,OAAO,EACL,kOAAkO;aACrO,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAES,KAAK,CAAC,YAAY,CAAI,IAI/B;QACC,MAAM,EAAE,GAAG,IAAI,~~QAAQ~~,~~EAAE~~,CAAC~~;QAC1B~~,~~IACE~~,IAAI,CAAC,~~IAAI~~;~~YACT~~,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;~~YAC7B~~,~~KAAK~~,IAAI,IAAI,~~CAAC~~,IAAI,~~EAClB~~,CAAC;~~YACD~~,~~2CAA2C~~;~~YAC3C~~,kDAAkD;YAClD,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE;gBAChB,GAAG,EAAE,~~IAAI,~~CAAC,~~IAAI,~~CAAC,GAAG;~~gBAClB~~,IAAI,EAAE,~~IAAI,~~CAAC,~~IAAI,~~CAAC,IAAI,IAAI,WAAW;~~gBACnC~~,IAAI,EAAE,~~IAAI,~~CAAC,~~IAAI,~~CAAC,IAAI,IAAI,WAAW;~~aACpC~~,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,~~CAAC,IAAI,~~YAAY,IAAI,EAAE,CAAC;~~YACpE~~,~~kCAAkC;YAClC,~~EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,~~IAAI,CAAC,~~IAAW,EAAE,WAAW,CAAC,CAAC;~~QACnD~~,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,~~IAAI,CAAC,~~MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;~~YACvD~~,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,~~IAAI,CAAC,UAAU,CAAI,MAAM,~~EAAE,~~IAAI,~~CAAC~~,IAAI,EAAE,EAAE,IAAI,EAAE,EAAS,EAAE,CAAC,CAAC~~;~~IACpE~~,CAAC;CACF;AAED,eAAe,GAAG,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrE,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAQpB,4EAA4E;AAC5E,SAAS,aAAa;IACpB,OAAO;IACL,+BAA+B;IAC/B,OAAO,SAAS,KAAK,WAAW;QAChC,aAAa;QACb,SAAS,CAAC,OAAO,KAAK,aAAa,CACpC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,GAAI,SAAQ,aAAa;IACpC,YAAY,IAAa;QACvB,MAAM,IAAI,GACR,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACrD,IACE,CAAC,IAAI,CAAC,IAAI;YACV,aAAa,EAAE;YACf,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,YAAY,CAAC;YACrC,CAAC,IAAI,CAAC,qBAAqB,EAC3B,CAAC;YACD,MAAM,IAAI,cAAc,CAAC;gBACvB,OAAO,EACL,kOAAkO;aACrO,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAES,KAAK,CAAC,YAAY,CAAI,IAI/B;QACC,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,kBAAkB,CACvC,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,MAAM,CACZ,CAAwB,CAAC;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAI,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IAES,KAAK,CAAC,kBAAkB,CAChC,IAAa,EACb,MAA+B;QAE/B,MAAM,EAAE,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC1B,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,IAAK,IAAY,EAAE,CAAC;YAC/D,MAAM,CAAC,GAAG,IAAqD,CAAC;YAChE,8DAA8D;YAC9D,kDAAkD;YAClD,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE;gBAChB,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,WAAW;gBAC3B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,WAAW;aAC5B,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;YAC/D,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,IAAW,EAAE,WAAW,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;YAClD,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,eAAe,GAAG,CAAC"}

package/dist/react/index.d.ts CHANGED Viewed

@@ -1,6 +1,7 @@
 import { type ReactNode } from "react";
 import type { AudioExtractInput, AudioExtractResult, ExtractInput, ExtractResult, SummarizeInput, SummarizeResult } from "@ohm_studio/sdk-core";
 import { OHM } from "../index";
+import { RecorderError, type ExpoRecorderOptions, type RecorderState, type RNFile } from "../recorder";
 export declare function OhmProvider({ client, children, }: {
     client: OHM;
     children: ReactNode;
@@ -33,4 +34,56 @@ export declare function useOhmSummarize(): {
     error: Error | null;
     isPending: boolean;
 };
+export interface UseRecorderOptions extends Omit<ExpoRecorderOptions, "onStateChange" | "onLevel" | "onError"> {
+    /**
+     * Pass `Audio` from `expo-av` here. Required.
+     *
+     *   import { Audio } from "expo-av";
+     *   useRecorder({ audio: Audio, ... });
+     */
+    audio: any;
+    /**
+     * If supplied, on stop the recording is automatically sent to
+     * `ohm.audio.extract({ apiSlug, file })` and exposed on `data`/`transcript`.
+     * Requires <OhmProvider client={...}> above.
+     */
+    apiSlug?: string;
+    extractInputs?: Record<string, unknown>;
+    extractLanguage?: string;
+}
+export interface UseRecorderReturn<T> {
+    state: RecorderState;
+    isRecording: boolean;
+    isPaused: boolean;
+    /** Linear level 0–1, derived from Expo's dB metering. */
+    level: number;
+    /** Recorded duration in seconds. */
+    durationSec: number;
+    file: RNFile | null;
+    error: RecorderError | null;
+    start: () => Promise<void>;
+    stop: () => Promise<RNFile | null>;
+    pause: () => Promise<void>;
+    resume: () => Promise<void>;
+    cancel: () => Promise<void>;
+    reset: () => void;
+    extracting: boolean;
+    transcript: string | null;
+    data: T | null;
+    extractError: Error | null;
+}
+/**
+ * `useRecorder` for React Native — same shape as the web hook.
+ *
+ *   import { Audio } from "expo-av";
+ *   const r = useRecorder({
+ *     audio: Audio,
+ *     apiSlug: "opd",
+ *     silenceAutoStop: { ms: 6000 },
+ *   });
+ *   <Pressable onPress={r.isRecording ? r.stop : r.start}>
+ *     <Text>{r.isRecording ? `Stop ${r.durationSec.toFixed(0)}s` : "Record"}</Text>
+ *   </Pressable>
+ */
+export declare function useRecorder<T = Record<string, unknown>>(opts: UseRecorderOptions): UseRecorderReturn<T>;
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,~~EAML~~,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;~~AAa~~/B,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,SAAS,CAAC;CACrB,uFAEA;AAoDD,wBAAgB,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE;IAC/D,OAAO,EAAE,MAAM,CAAC;CACjB;;;;;WAxCQ,KAAK,GAAG,IAAI;eACR,OAAO;EA4CnB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE;IACpE,OAAO,EAAE,MAAM,CAAC;CACjB;;;;;WAjDQ,KAAK,GAAG,IAAI;eACR,OAAO;EAqDnB;AAED,wBAAgB,eAAe;;;;;WAxDtB,KAAK,GAAG,IAAI;eACR,OAAO;EA2DnB"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAEL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,MAAM,EACZ,MAAM,aAAa,CAAC;AAarB,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,SAAS,CAAC;CACrB,uFAEA;AAoDD,wBAAgB,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE;IAC/D,OAAO,EAAE,MAAM,CAAC;CACjB;;;;;WAxCQ,KAAK,GAAG,IAAI;eACR,OAAO;EA4CnB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE;IACpE,OAAO,EAAE,MAAM,CAAC;CACjB;;;;;WAjDQ,KAAK,GAAG,IAAI;eACR,OAAO;EAqDnB;AAED,wBAAgB,eAAe;;;;;WAxDtB,KAAK,GAAG,IAAI;eACR,OAAO;EA2DnB;AAID,MAAM,WAAW,kBACf,SAAQ,IAAI,CAAC,mBAAmB,EAAE,eAAe,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1E;;;;;OAKG;IACH,KAAK,EAAE,GAAG,CAAC;IAEX;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,YAAY,EAAE,KAAK,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrD,IAAI,EAAE,kBAAkB,GACvB,iBAAiB,CAAC,CAAC,CAAC,CA2ItB"}

package/dist/react/index.js CHANGED Viewed

@@ -1,4 +1,5 @@
-import { createContext, createElement, useCallback, useContext, useState, } from "react";
+import { createContext, createElement, useCallback, useContext, useEffect, useMemo, useRef, useState, } from "react";
+import { ExpoRecorder, } from "../recorder";
 /**
  * React hooks for @ohm_studio/sdk. Mirrors `@ohm_studio/sdk-react-native/react` so a
  * snippet copies cleanly between web and mobile codebases.
@@ -55,4 +56,149 @@ export function useOhmAudioExtract(opts) {
 export function useOhmSummarize() {
     return useOhmMutation((c, input) => c.summarize(input));
 }
+/**
+ * `useRecorder` for React Native — same shape as the web hook.
+ *
+ *   import { Audio } from "expo-av";
+ *   const r = useRecorder({
+ *     audio: Audio,
+ *     apiSlug: "opd",
+ *     silenceAutoStop: { ms: 6000 },
+ *   });
+ *   <Pressable onPress={r.isRecording ? r.stop : r.start}>
+ *     <Text>{r.isRecording ? `Stop ${r.durationSec.toFixed(0)}s` : "Record"}</Text>
+ *   </Pressable>
+ */
+export function useRecorder(opts) {
+    const client = useContext(OhmContext);
+    const recRef = useRef(null);
+    const [state, setState] = useState("idle");
+    const [level, setLevel] = useState(0);
+    const [durationSec, setDurationSec] = useState(0);
+    const [file, setFile] = useState(null);
+    const [error, setError] = useState(null);
+    const [extracting, setExtracting] = useState(false);
+    const [transcript, setTranscript] = useState(null);
+    const [data, setData] = useState(null);
+    const [extractError, setExtractError] = useState(null);
+    const optsRef = useRef(opts);
+    optsRef.current = opts;
+    const ensureRecorder = useCallback(() => {
+        if (recRef.current)
+            return recRef.current;
+        const { audio, apiSlug, extractInputs, extractLanguage, ...recOpts } = optsRef.current;
+        const r = new ExpoRecorder(audio, {
+            ...recOpts,
+            onStateChange: (s) => setState(s),
+            onLevel: (l) => setLevel(l),
+            onStatus: (s) => setDurationSec(s.durationMillis / 1000),
+            onError: (e) => setError(e),
+        });
+        recRef.current = r;
+        return r;
+    }, []);
+    useEffect(() => {
+        return () => {
+            void recRef.current?.cancel().catch(() => {
+                /* ignore */
+            });
+            recRef.current = null;
+        };
+    }, []);
+    const start = useCallback(async () => {
+        setError(null);
+        setFile(null);
+        setTranscript(null);
+        setData(null);
+        setExtractError(null);
+        setDurationSec(0);
+        const r = ensureRecorder();
+        await r.start();
+    }, [ensureRecorder]);
+    const stop = useCallback(async () => {
+        const r = recRef.current;
+        if (!r)
+            return null;
+        const f = await r.stop();
+        setFile(f);
+        if (optsRef.current.apiSlug && client) {
+            setExtracting(true);
+            try {
+                const res = await client.audio.extract({
+                    apiSlug: optsRef.current.apiSlug,
+                    file: f,
+                    inputs: optsRef.current.extractInputs,
+                    language: optsRef.current.extractLanguage,
+                });
+                setTranscript(res.transcript ?? null);
+                setData(res.data);
+            }
+            catch (e) {
+                setExtractError(e);
+            }
+            finally {
+                setExtracting(false);
+            }
+        }
+        return f;
+    }, [client]);
+    const pause = useCallback(async () => {
+        await recRef.current?.pause();
+    }, []);
+    const resume = useCallback(async () => {
+        await recRef.current?.resume();
+    }, []);
+    const cancel = useCallback(async () => {
+        await recRef.current?.cancel();
+    }, []);
+    const reset = useCallback(() => {
+        void recRef.current?.cancel().catch(() => {
+            /* ignore */
+        });
+        recRef.current = null;
+        setState("idle");
+        setLevel(0);
+        setDurationSec(0);
+        setFile(null);
+        setError(null);
+        setTranscript(null);
+        setData(null);
+        setExtractError(null);
+    }, []);
+    return useMemo(() => ({
+        state,
+        isRecording: state === "recording",
+        isPaused: state === "paused",
+        level,
+        durationSec,
+        file,
+        error,
+        start,
+        stop,
+        pause,
+        resume,
+        cancel,
+        reset,
+        extracting,
+        transcript,
+        data,
+        extractError,
+    }), [
+        state,
+        level,
+        durationSec,
+        file,
+        error,
+        start,
+        stop,
+        pause,
+        resume,
+        cancel,
+        reset,
+        extracting,
+        transcript,
+        data,
+        extractError,
+    ]);
+}
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,UAAU,EACV,QAAQ,GAET,MAAM,OAAO,CAAC;~~AAWf~~;;;;;;;GAOG;AAEH,MAAM,UAAU,GAAG,aAAa,CAAa,IAAI,CAAC,CAAC;AAEnD,MAAM,UAAU,WAAW,CAAC,EAC1B,MAAM,EACN,QAAQ,GAIT;IACC,OAAO,aAAa,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,SAAS;IAChB,MAAM,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAQD,SAAS,cAAc,CACrB,EAAoD;IAEpD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAyB;QACzD,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,WAAW,CAC7B,KAAK,EAAE,KAAa,EAAE,EAAE;QACtB,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACrC,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YACvD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,CACb,CAAC;IACF,OAAO;QACL,GAAG,KAAK;QACR,WAAW;QACX,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxB,KAAK,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CACV,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAA8B,IAE1D;IACC,OAAO,cAAc,CAGnB,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAI,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAA8B,IAE/D;IACC,OAAO,cAAc,CAGnB,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAI,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,cAAc,CAAkC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAClE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CACnB,CAAC;AACJ,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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"}

package/dist/recorder.d.ts ADDED Viewed

@@ -0,0 +1,174 @@
+/**
+ * React Native audio recorder for clinical consults — Expo flavour.
+ *
+ * Wraps `expo-av`'s `Audio.Recording` with clinically-tuned defaults
+ * (16 kHz mono AAC), iOS audio-session setup so recording works in
+ * silent mode, dB → linear level metering, pause/resume, duration
+ * tracking, silence auto-stop, max-duration cap, and typed errors.
+ *
+ *   import { Audio } from "expo-av";
+ *   import { ExpoRecorder } from "@ohm_studio/sdk-react-native";
+ *
+ *   const rec = new ExpoRecorder(Audio, {
+ *     onLevel: setVu,
+ *     silenceAutoStop: { ms: 6000 },
+ *     maxDurationMs: 15 * 60_000,
+ *   });
+ *   await rec.start();
+ *   const file = await rec.stop();   // → { uri, name, type }
+ *   const { transcript, data } = await ohm.audio.extract({ apiSlug, file });
+ *
+ * We don't take a hard dependency on `expo-av` so apps using bare RN
+ * with `react-native-audio-recorder-player` aren't forced to install
+ * Expo. The Audio module is passed in as a parameter at runtime.
+ */
+/** The shape `ohm.audio.extract` expects on React Native. */
+export interface RNFile {
+    uri: string;
+    name: string;
+    type: string;
+}
+export type RecorderState = "idle" | "starting" | "recording" | "paused" | "stopping";
+export type RecorderErrorCode = "NotSupported" | "PermissionDenied" | "NoMicrophone" | "InvalidState" | "Interrupted" | "Unknown";
+export declare class RecorderError extends Error {
+    code: RecorderErrorCode;
+    cause?: unknown;
+    constructor(code: RecorderErrorCode, message: string, cause?: unknown);
+}
+/** Minimal subset of `expo-av`'s Audio module we depend on. */
+interface ExpoAudioModule {
+    requestPermissionsAsync: () => Promise<{
+        status: string;
+        granted?: boolean;
+    }>;
+    getPermissionsAsync?: () => Promise<{
+        status: string;
+        granted?: boolean;
+    }>;
+    setAudioModeAsync?: (mode: any) => Promise<void>;
+    Recording: {
+        createAsync: (options: any, onStatusUpdate?: ((status: any) => void) | null, progressUpdateIntervalMillis?: number) => Promise<{
+            recording: ExpoAudioRecording;
+            status: any;
+        }>;
+    };
+    RecordingOptionsPresets?: {
+        HIGH_QUALITY?: any;
+        LOW_QUALITY?: any;
+    };
+    IOSOutputFormat?: {
+        LINEARPCM?: number;
+        MPEG4AAC?: number;
+    };
+    AndroidOutputFormat?: {
+        MPEG_4?: number;
+    };
+    AndroidAudioEncoder?: {
+        AAC?: number;
+    };
+    IOSAudioQuality?: {
+        HIGH?: number;
+        MEDIUM?: number;
+    };
+    InterruptionModeIOS?: {
+        DoNotMix?: number;
+        MixWithOthers?: number;
+    };
+}
+interface ExpoAudioRecording {
+    startAsync?: () => Promise<unknown>;
+    pauseAsync?: () => Promise<unknown>;
+    stopAndUnloadAsync: () => Promise<unknown>;
+    getURI: () => string | null;
+    setProgressUpdateInterval?: (ms: number) => void;
+    setOnRecordingStatusUpdate?: (cb: (s: any) => void) => void;
+}
+export interface ExpoRecorderOptions {
+    /**
+     * Override the recording options entirely. If omitted, the SDK uses a
+     * 16 kHz mono AAC clinical preset. Pass an Expo `RecordingOptionsPresets`
+     * value or a fully custom RecordingOptions object.
+     */
+    recordingOptions?: any;
+    /** Mime type tag attached to the file shape — default `audio/mp4`. */
+    mimeType?: string;
+    /** Filename tag attached to the file shape — default `rec.m4a`. */
+    fileName?: string;
+    /**
+     * Set up the iOS audio session before recording so the mic still works
+     * when the device is in silent mode. Default true.
+     */
+    configureIosAudioSession?: boolean;
+    /**
+     * Hard cap — auto-stop after this many ms of recording. Default off.
+     */
+    maxDurationMs?: number;
+    /**
+     * Auto-stop after sustained silence. dB below `thresholdDb` (default
+     * -40 dBFS) for `ms` continuous milliseconds triggers stop. Default off.
+     */
+    silenceAutoStop?: {
+        ms?: number;
+        thresholdDb?: number;
+    };
+    /**
+     * Optional keep-awake hooks. Wire to `expo-keep-awake`'s
+     * `activateKeepAwake()` / `deactivateKeepAwake()` to prevent the device
+     * from sleeping during long consults. Optional — not bundled.
+     */
+    keepAwake?: {
+        activate: () => void | Promise<void>;
+        deactivate: () => void | Promise<void>;
+    };
+    /** Recording state changes. */
+    onStateChange?: (state: RecorderState) => void;
+    /** Periodic linear level 0–1. Wire to a VU meter. */
+    onLevel?: (linearLevel: number) => void;
+    /** Progress updates from Expo (durationMillis, metering, isDoneRecording…). */
+    onStatus?: (status: {
+        durationMillis: number;
+        metering?: number;
+        isRecording: boolean;
+        isDoneRecording: boolean;
+    }) => void;
+    /** All recorder errors flow through here in addition to the awaited rejection. */
+    onError?: (err: RecorderError) => void;
+}
+/** True if `expo-av` is installed in the host RN app. */
+export declare function isExpoAvAvailable(): boolean;
+export declare class ExpoRecorder {
+    private audio;
+    private recording;
+    private opts;
+    private state;
+    private durationMs;
+    private maxStopTimer;
+    private silenceSinceMs;
+    private keepAwakeActive;
+    constructor(expoAudio: ExpoAudioModule, opts?: ExpoRecorderOptions);
+    /** Probe permission without prompting. */
+    probePermission(): Promise<"granted" | "denied" | "undetermined">;
+    /** Current state. */
+    get currentState(): RecorderState;
+    /** Recorded duration in ms (live; zero when idle). */
+    getDuration(): number;
+    /** Request mic permission and start recording. */
+    start(): Promise<void>;
+    /** Pause recording (resumable via `resume()`). */
+    pause(): Promise<void>;
+    /** Resume after `pause()`. */
+    resume(): Promise<void>;
+    /**
+     * Stop recording and return the file shape `ohm.audio.extract` expects.
+     */
+    stop(): Promise<RNFile>;
+    /** Convenience — stop after `ms` from now. */
+    stopAfter(ms: number): Promise<RNFile>;
+    /** Discard the in-progress recording without producing a file. */
+    cancel(): Promise<void>;
+    private handleStatusUpdate;
+    private cleanup;
+    private setState;
+}
+export {};
+//# sourceMappingURL=recorder.d.ts.map

package/dist/recorder.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"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"}

package/dist/recorder.js ADDED Viewed

@@ -0,0 +1,334 @@
+/**
+ * React Native audio recorder for clinical consults — Expo flavour.
+ *
+ * Wraps `expo-av`'s `Audio.Recording` with clinically-tuned defaults
+ * (16 kHz mono AAC), iOS audio-session setup so recording works in
+ * silent mode, dB → linear level metering, pause/resume, duration
+ * tracking, silence auto-stop, max-duration cap, and typed errors.
+ *
+ *   import { Audio } from "expo-av";
+ *   import { ExpoRecorder } from "@ohm_studio/sdk-react-native";
+ *
+ *   const rec = new ExpoRecorder(Audio, {
+ *     onLevel: setVu,
+ *     silenceAutoStop: { ms: 6000 },
+ *     maxDurationMs: 15 * 60_000,
+ *   });
+ *   await rec.start();
+ *   const file = await rec.stop();   // → { uri, name, type }
+ *   const { transcript, data } = await ohm.audio.extract({ apiSlug, file });
+ *
+ * We don't take a hard dependency on `expo-av` so apps using bare RN
+ * with `react-native-audio-recorder-player` aren't forced to install
+ * Expo. The Audio module is passed in as a parameter at runtime.
+ */
+export class RecorderError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.name = "RecorderError";
+        this.code = code;
+        this.cause = cause;
+    }
+}
+/**
+ * Clinical-tuned RecordingOptions: 16 kHz mono AAC, 32 kbps. Plenty for
+ * speech; keeps file size small for upload over flaky hospital wifi.
+ *
+ * We build this dynamically so we tolerate constant renames across Expo SDKs.
+ */
+function clinicalRecordingOptions(audio) {
+    // Expo SDK 50+ uses string outputs ("aac ") on iOS; older SDKs used
+    // numeric enums via Audio.IOSOutputFormat. We pass both shapes so
+    // whichever the runtime understands wins.
+    const iosOutputFormat = audio.IOSOutputFormat?.MPEG4AAC ?? "aac ";
+    const iosAudioQuality = audio.IOSAudioQuality?.MEDIUM ?? 0x40;
+    const androidOutputFormat = audio.AndroidOutputFormat?.MPEG_4 ?? 2;
+    const androidAudioEncoder = audio.AndroidAudioEncoder?.AAC ?? 3;
+    return {
+        isMeteringEnabled: true,
+        android: {
+            extension: ".m4a",
+            outputFormat: androidOutputFormat,
+            audioEncoder: androidAudioEncoder,
+            sampleRate: 16_000,
+            numberOfChannels: 1,
+            bitRate: 32_000,
+        },
+        ios: {
+            extension: ".m4a",
+            outputFormat: iosOutputFormat,
+            audioQuality: iosAudioQuality,
+            sampleRate: 16_000,
+            numberOfChannels: 1,
+            bitRate: 32_000,
+            linearPCMBitDepth: 16,
+            linearPCMIsBigEndian: false,
+            linearPCMIsFloat: false,
+        },
+        web: {
+            mimeType: "audio/webm;codecs=opus",
+            bitsPerSecond: 32_000,
+        },
+    };
+}
+/**
+ * Convert Expo's `metering` (dBFS, typically -160..0) to a linear 0..1
+ * level useful for a VU meter. Mic floor is mapped to 0, peak to 1.
+ */
+function dbToLinear(db, floorDb = -50) {
+    if (!Number.isFinite(db))
+        return 0;
+    if (db <= floorDb)
+        return 0;
+    if (db >= 0)
+        return 1;
+    return (db - floorDb) / -floorDb;
+}
+/** True if `expo-av` is installed in the host RN app. */
+export function isExpoAvAvailable() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        require.resolve("expo-av");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export class ExpoRecorder {
+    audio;
+    recording = null;
+    opts;
+    state = "idle";
+    durationMs = 0;
+    maxStopTimer = null;
+    silenceSinceMs = 0;
+    keepAwakeActive = false;
+    constructor(expoAudio, opts = {}) {
+        this.audio = expoAudio;
+        this.opts = opts;
+    }
+    /** Probe permission without prompting. */
+    async probePermission() {
+        if (!this.audio.getPermissionsAsync)
+            return "undetermined";
+        const r = await this.audio.getPermissionsAsync();
+        return r?.status || "undetermined";
+    }
+    /** Current state. */
+    get currentState() {
+        return this.state;
+    }
+    /** Recorded duration in ms (live; zero when idle). */
+    getDuration() {
+        return this.durationMs;
+    }
+    /** Request mic permission and start recording. */
+    async start() {
+        if (this.state !== "idle") {
+            throw new RecorderError("InvalidState", `Cannot start while "${this.state}".`);
+        }
+        this.setState("starting");
+        let perm;
+        try {
+            perm = await this.audio.requestPermissionsAsync();
+        }
+        catch (e) {
+            this.setState("idle");
+            const err = new RecorderError("Unknown", "Failed to request microphone permission", e);
+            this.opts.onError?.(err);
+            throw err;
+        }
+        if (perm.status !== "granted") {
+            this.setState("idle");
+            const err = new RecorderError("PermissionDenied", "Microphone permission denied");
+            this.opts.onError?.(err);
+            throw err;
+        }
+        if (this.opts.configureIosAudioSession !== false && this.audio.setAudioModeAsync) {
+            try {
+                await this.audio.setAudioModeAsync({
+                    allowsRecordingIOS: true,
+                    playsInSilentModeIOS: true,
+                    staysActiveInBackground: false,
+                    interruptionModeIOS: this.audio.InterruptionModeIOS?.DoNotMix ?? 1,
+                    shouldDuckAndroid: true,
+                    playThroughEarpieceAndroid: false,
+                });
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+        const recordingOptions = this.opts.recordingOptions ?? clinicalRecordingOptions(this.audio);
+        let result;
+        try {
+            result = await this.audio.Recording.createAsync(recordingOptions, (status) => this.handleStatusUpdate(status), 100);
+        }
+        catch (e) {
+            this.setState("idle");
+            const err = new RecorderError("Unknown", "Failed to start recording: " + (e?.message || ""), e);
+            this.opts.onError?.(err);
+            throw err;
+        }
+        this.recording = result.recording;
+        this.durationMs = 0;
+        this.silenceSinceMs = 0;
+        if (this.opts.maxDurationMs && this.opts.maxDurationMs > 0) {
+            this.maxStopTimer = setTimeout(() => {
+                this.stop().catch(() => {
+                    /* swallow */
+                });
+            }, this.opts.maxDurationMs);
+        }
+        if (this.opts.keepAwake) {
+            try {
+                await this.opts.keepAwake.activate();
+                this.keepAwakeActive = true;
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+        this.setState("recording");
+    }
+    /** Pause recording (resumable via `resume()`). */
+    async pause() {
+        if (this.state !== "recording" || !this.recording) {
+            throw new RecorderError("InvalidState", `Cannot pause while "${this.state}".`);
+        }
+        if (typeof this.recording.pauseAsync !== "function") {
+            throw new RecorderError("NotSupported", "This Expo SDK doesn't support pause().");
+        }
+        await this.recording.pauseAsync();
+        this.setState("paused");
+    }
+    /** Resume after `pause()`. */
+    async resume() {
+        if (this.state !== "paused" || !this.recording) {
+            throw new RecorderError("InvalidState", `Cannot resume while "${this.state}".`);
+        }
+        if (typeof this.recording.startAsync !== "function") {
+            throw new RecorderError("NotSupported", "This Expo SDK doesn't support resume().");
+        }
+        await this.recording.startAsync();
+        this.setState("recording");
+    }
+    /**
+     * Stop recording and return the file shape `ohm.audio.extract` expects.
+     */
+    async stop() {
+        if (!this.recording || (this.state !== "recording" && this.state !== "paused")) {
+            throw new RecorderError("InvalidState", `Cannot stop while "${this.state}".`);
+        }
+        this.setState("stopping");
+        try {
+            await this.recording.stopAndUnloadAsync();
+        }
+        catch (e) {
+            const err = new RecorderError("Unknown", "Failed to stop recording", e);
+            this.opts.onError?.(err);
+            this.cleanup();
+            throw err;
+        }
+        const uri = this.recording.getURI();
+        this.cleanup();
+        if (!uri) {
+            const err = new RecorderError("Unknown", "Recording produced no file URI");
+            this.opts.onError?.(err);
+            throw err;
+        }
+        return {
+            uri,
+            name: this.opts.fileName ?? "rec.m4a",
+            type: this.opts.mimeType ?? "audio/mp4",
+        };
+    }
+    /** Convenience — stop after `ms` from now. */
+    stopAfter(ms) {
+        return new Promise((resolve, reject) => {
+            setTimeout(() => {
+                this.stop().then(resolve, reject);
+            }, ms);
+        });
+    }
+    /** Discard the in-progress recording without producing a file. */
+    async cancel() {
+        if (this.recording) {
+            try {
+                await this.recording.stopAndUnloadAsync();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        this.cleanup();
+    }
+    // ─── internals ──────────────────────────────────────────────────────
+    handleStatusUpdate(status) {
+        if (!status)
+            return;
+        if (typeof status.durationMillis === "number") {
+            this.durationMs = status.durationMillis;
+        }
+        let linear = 0;
+        if (typeof status.metering === "number") {
+            linear = dbToLinear(status.metering);
+            this.opts.onLevel?.(linear);
+        }
+        this.opts.onStatus?.({
+            durationMillis: this.durationMs,
+            metering: status.metering,
+            isRecording: !!status.isRecording,
+            isDoneRecording: !!status.isDoneRecording,
+        });
+        // Silence auto-stop
+        if (this.opts.silenceAutoStop &&
+            this.state === "recording" &&
+            typeof status.metering === "number") {
+            const silenceMs = this.opts.silenceAutoStop.ms ?? 6000;
+            const thresholdDb = this.opts.silenceAutoStop.thresholdDb ?? -40;
+            if (status.metering < thresholdDb) {
+                if (this.silenceSinceMs === 0)
+                    this.silenceSinceMs = Date.now();
+                else if (Date.now() - this.silenceSinceMs >= silenceMs) {
+                    this.silenceSinceMs = 0;
+                    this.stop().catch(() => {
+                        /* swallow */
+                    });
+                }
+            }
+            else {
+                this.silenceSinceMs = 0;
+            }
+        }
+    }
+    cleanup() {
+        if (this.maxStopTimer) {
+            clearTimeout(this.maxStopTimer);
+            this.maxStopTimer = null;
+        }
+        if (this.keepAwakeActive && this.opts.keepAwake) {
+            try {
+                this.opts.keepAwake.deactivate();
+            }
+            catch {
+                /* ignore */
+            }
+            this.keepAwakeActive = false;
+        }
+        this.recording = null;
+        this.durationMs = 0;
+        this.silenceSinceMs = 0;
+        this.setState("idle");
+    }
+    setState(next) {
+        if (this.state === next)
+            return;
+        this.state = next;
+        this.opts.onStateChange?.(next);
+    }
+}
+//# sourceMappingURL=recorder.js.map

package/dist/recorder.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ohm_studio/sdk-react-native",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "OHM Studio SDK for React Native. Voice-to-structured-JSON clinical extraction APIs in your mobile app.",
   "license": "MIT",
   "type": "module",
@@ -18,10 +18,7 @@
       "import": "./dist/react/index.js"
     }
   },
-  "files": [
-    "dist",
-    "README.md"
-  ],
+  "files": ["dist", "README.md"],
   "keywords": [
     "ohm",
     "react-native",
@@ -41,28 +38,24 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
   "dependencies": {
-    "@ohm_studio/sdk-core": "0.1.0"
+    "@ohm_studio/sdk-core": "workspace:*"
   },
   "peerDependencies": {
     "react": ">=17",
     "react-native": ">=0.71"
   },
   "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    },
-    "react-native": {
-      "optional": true
-    }
+    "react": { "optional": true },
+    "react-native": { "optional": true }
   },
   "devDependencies": {
     "@types/react": "^18.3.23",
     "react": "^18.3.1",
     "typescript": "^5.8.3"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
   }
-}
+}