@ohm_studio/sdk 0.1.0

package/README.md

@@ -0,0 +1,95 @@
+# @ohm_studio/sdk
+
+OHM Studio SDK for **JavaScript / TypeScript / React** — turn voice into structured clinical JSON, FHIR-ready, multi-language. Works in the browser, Node 18+, and Next.js (server actions, route handlers, edge runtime).
+
+> For React Native, install [`@ohm_studio/sdk-react-native`](https://www.npmjs.com/package/@ohm_studio/sdk-react-native) instead.
+
+## Install
+
+```bash
+npm install @ohm_studio/sdk
+# or
+pnpm add @ohm_studio/sdk
+# or
+yarn add @ohm_studio/sdk
+```
+
+## Quickstart
+
+```ts
+import { OHM } from "@ohm_studio/sdk";
+
+const ohm = new OHM({
+  apiKey: process.env.OHM_API_KEY!,           // ohms_live_* or ohms_test_*
+  baseUrl: "https://api.ohm.doctor",          // override for self-host
+});
+
+// Text → structured JSON
+const { data } = await ohm.extract({
+  apiSlug: "opd-clinic",
+  text: transcript,
+});
+
+// Audio → structured JSON in one call
+const { transcript, data } = await ohm.audio.extract({
+  apiSlug: "opd-clinic",
+  file: blob,                                 // File / Blob / { buffer, name?, type? }
+});
+
+// Summarize free text — patient / handover / executive / progress-note
+const { summary } = await ohm.summarize({
+  text: longConsult,
+  style: "patient",
+  maxLines: 5,
+});
+```
+
+## React hooks
+
+```tsx
+import { OHM } from "@ohm_studio/sdk";
+import { OhmProvider, useOhmAudioExtract } from "@ohm_studio/sdk/react";
+
+const ohm = new OHM({ apiKey: process.env.NEXT_PUBLIC_OHM_TEST_KEY });
+
+export default function App({ children }) {
+  return <OhmProvider client={ohm}>{children}</OhmProvider>;
+}
+
+function Recorder() {
+  const { mutateAsync, data, isPending, error } = useOhmAudioExtract({
+    apiSlug: "opd-clinic",
+  });
+  // ...
+}
+```
+
+## Error handling
+
+```ts
+import {
+  OHMAuthError,
+  OHMRateLimitError,
+  OHMValidationError,
+} from "@ohm_studio/sdk";
+
+try {
+  await ohm.extract({ apiSlug: "opd", text });
+} catch (e) {
+  if (e instanceof OHMRateLimitError) await sleep(e.retryAfterSec! * 1000);
+  if (e instanceof OHMAuthError)        rotateKey();
+  if (e instanceof OHMValidationError)  showFieldErrors(e.fields);
+}
+```
+
+## Bundle size
+
+`@ohm_studio/sdk` core ships < 25 KB gzipped. React hooks subentry adds ~3 KB. Zero polyfills for Node 18+ / modern browsers.
+
+## Documentation
+
+Full reference, cookbook, and OpenAPI playground: [docs.ohm.doctor](https://docs.ohm.doctor)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import { OHMCoreClient } from "@ohm_studio/sdk-core";
+import type { OHMClientOptions } from "@ohm_studio/sdk-core";
+export * from "@ohm_studio/sdk-core";
+/**
+ * OHM Studio SDK for JavaScript / TypeScript.
+ *
+ * Works in:
+ *   - browser (uses the global `fetch` and `FormData`)
+ *   - Node 18+ (uses native fetch)
+ *   - Next.js (server actions, route handlers, edge runtime)
+ *
+ * For React Native, use `@ohm_studio/sdk-react-native` instead — it adapts the
+ * file shape and streaming transport for the RN runtime.
+ *
+ * @example
+ *   const ohm = new OHM({ apiKey: process.env.OHM_API_KEY! });
+ *   const { data } = await ohm.extract({
+ *     apiSlug: "opd-clinic",
+ *     text: transcript,
+ *   });
+ */
+export declare class OHM extends OHMCoreClient {
+    constructor(opts: OHMClientOptions);
+    protected runMultipart<T>(opts: {
+        path: string;
+        file: any;
+        fields?: Record<string, string>;
+    }): Promise<T>;
+}
+export default OHM;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,cAAc,sBAAsB,CAAC;AAErC;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,GAAI,SAAQ,aAAa;gBACxB,IAAI,EAAE,gBAAgB;cAIlB,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;CAuBf;AAED,eAAe,GAAG,CAAC"}

package/dist/index.js

@@ -0,0 +1,51 @@
+import { OHMCoreClient } from "@ohm_studio/sdk-core";
+export * from "@ohm_studio/sdk-core";
+/**
+ * OHM Studio SDK for JavaScript / TypeScript.
+ *
+ * Works in:
+ *   - browser (uses the global `fetch` and `FormData`)
+ *   - Node 18+ (uses native fetch)
+ *   - Next.js (server actions, route handlers, edge runtime)
+ *
+ * For React Native, use `@ohm_studio/sdk-react-native` instead — it adapts the
+ * file shape and streaming transport for the RN runtime.
+ *
+ * @example
+ *   const ohm = new OHM({ apiKey: process.env.OHM_API_KEY! });
+ *   const { data } = await ohm.extract({
+ *     apiSlug: "opd-clinic",
+ *     text: transcript,
+ *   });
+ */
+export class OHM extends OHMCoreClient {
+    constructor(opts) {
+        super(opts);
+    }
+    async runMultipart(opts) {
+        const fd = new FormData();
+        // Browser File / Blob, or a Node Buffer (which the user must wrap as Blob).
+        if (typeof File !== "undefined" && opts.file instanceof File) {
+            fd.append("file", opts.file);
+        }
+        else if (typeof Blob !== "undefined" && opts.file instanceof Blob) {
+            fd.append("file", opts.file, "audio.bin");
+        }
+        else if (opts.file && typeof opts.file === "object" && "buffer" in opts.file) {
+            // Node-style { buffer, name?, type? }
+            const blob = new Blob([opts.file.buffer], {
+                type: opts.file.type || "application/octet-stream",
+            });
+            fd.append("file", blob, opts.file.name || "audio.bin");
+        }
+        else {
+            throw new Error("Unsupported file input — pass a File, Blob, or { buffer, name?, type? }");
+        }
+        for (const [k, v] of Object.entries(opts.fields || {})) {
+            fd.append(k, v);
+        }
+        return this.requestRaw("POST", opts.path, { body: fd });
+    }
+}
+export default OHM;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,cAAc,sBAAsB,CAAC;AAErC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,GAAI,SAAQ,aAAa;IACpC,YAAY,IAAsB;QAChC,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAES,KAAK,CAAC,YAAY,CAAI,IAI/B;QACC,MAAM,EAAE,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC1B,4EAA4E;QAC5E,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,IAAI,YAAY,IAAI,EAAE,CAAC;YAC7D,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;aAAM,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,IAAI,YAAY,IAAI,EAAE,CAAC;YACpE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC/E,sCAAsC;YACtC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;gBACxC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,0BAA0B;aACnD,CAAC,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,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,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,eAAe,GAAG,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,36 @@
+import { type ReactNode } from "react";
+import type { AudioExtractInput, AudioExtractResult, ExtractInput, ExtractResult, SummarizeInput, SummarizeResult } from "@ohm_studio/sdk-core";
+import { OHM } from "../index";
+export declare function OhmProvider({ client, children, }: {
+    client: OHM;
+    children: ReactNode;
+}): import("react").FunctionComponentElement<import("react").ProviderProps<OHM | null>>;
+export declare function useOhmExtract<T = Record<string, unknown>>(opts: {
+    apiSlug: string;
+}): {
+    mutateAsync: (input: Omit<ExtractInput, "apiSlug">) => Promise<ExtractResult<T>>;
+    mutate: (input: Omit<ExtractInput, "apiSlug">) => void;
+    reset: () => void;
+    data: ExtractResult<T> | null;
+    error: Error | null;
+    isPending: boolean;
+};
+export declare function useOhmAudioExtract<T = Record<string, unknown>>(opts: {
+    apiSlug: string;
+}): {
+    mutateAsync: (input: Omit<AudioExtractInput, "apiSlug">) => Promise<AudioExtractResult<T>>;
+    mutate: (input: Omit<AudioExtractInput, "apiSlug">) => void;
+    reset: () => void;
+    data: AudioExtractResult<T> | null;
+    error: Error | null;
+    isPending: boolean;
+};
+export declare function useOhmSummarize(): {
+    mutateAsync: (input: SummarizeInput) => Promise<SummarizeResult>;
+    mutate: (input: SummarizeInput) => void;
+    reset: () => void;
+    data: SummarizeResult | null;
+    error: Error | null;
+    isPending: boolean;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/react/index.js

@@ -0,0 +1,58 @@
+import { createContext, createElement, useCallback, useContext, useState, } from "react";
+/**
+ * React hooks for @ohm_studio/sdk. Mirrors `@ohm_studio/sdk-react-native/react` so a
+ * snippet copies cleanly between web and mobile codebases.
+ *
+ * The hooks are thin and DEPENDENCY-FREE — no TanStack Query required.
+ * If you'd rather use Query, the underlying `client.extract` /
+ * `client.audio.extract` calls slot into `useMutation` directly.
+ */
+const OhmContext = createContext(null);
+export function OhmProvider({ client, children, }) {
+    return createElement(OhmContext.Provider, { value: client }, children);
+}
+function useClient() {
+    const c = useContext(OhmContext);
+    if (!c) {
+        throw new Error("useOhm hooks must be wrapped in <OhmProvider client={ohm}>");
+    }
+    return c;
+}
+function useOhmMutation(fn) {
+    const client = useClient();
+    const [state, setState] = useState({
+        data: null,
+        error: null,
+        isPending: false,
+    });
+    const mutateAsync = useCallback(async (input) => {
+        setState({ data: null, error: null, isPending: true });
+        try {
+            const data = await fn(client, input);
+            setState({ data, error: null, isPending: false });
+            return data;
+        }
+        catch (err) {
+            setState({ data: null, error: err, isPending: false });
+            throw err;
+        }
+    }, [client, fn]);
+    return {
+        ...state,
+        mutateAsync,
+        mutate: (input) => {
+            void mutateAsync(input);
+        },
+        reset: () => setState({ data: null, error: null, isPending: false }),
+    };
+}
+export function useOhmExtract(opts) {
+    return useOhmMutation((c, input) => c.extract({ ...input, apiSlug: opts.apiSlug }));
+}
+export function useOhmAudioExtract(opts) {
+    return useOhmMutation((c, input) => c.audio.extract({ ...input, apiSlug: opts.apiSlug }));
+}
+export function useOhmSummarize() {
+    return useOhmMutation((c, input) => c.summarize(input));
+}
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@ohm_studio/sdk",
+  "version": "0.1.0",
+  "description": "OHM Studio SDK for JavaScript / TypeScript / React. Voice-to-structured-JSON clinical extraction APIs.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "ohm",
+    "clinical",
+    "ehr",
+    "fhir",
+    "stt",
+    "extraction",
+    "ai",
+    "llm",
+    "react"
+  ],
+  "homepage": "https://docs.ohm.doctor",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aivfkesavan/OHM_Products",
+    "directory": "packages/sdk-js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@ohm_studio/sdk-core": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": ">=17"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "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"
+  }
+}