gheim 0.1.0 → 0.1.2

package/dist/types/detectors/index.d.ts

@@ -2,7 +2,7 @@ export type { Detector, Span } from "./base.ts";
 export { DEFAULT_BASE_URL, DEFAULT_MODEL as REMOTE_DEFAULT_MODEL, RemoteDetector, } from "./remote.ts";
 export type { RemoteDetectorOptions } from "./remote.ts";
 export { LocalDetector } from "./local.ts";
-export type { LocalDetectorOptions } from "./local.ts";
+export type { LocalDetectorOptions, LocalDetectorLoadEvent } from "./local.ts";
 import type { Detector } from "./base.ts";
 /** Pick a reasonable default: remote if `GHEIM_API_KEY` is set in env, else local. */
 export declare function defaultDetector(): Detector;

package/dist/types/detectors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/detectors/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,aAAa,IAAI,oBAAoB,EACrC,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAI1C,sFAAsF;AACtF,wBAAgB,eAAe,IAAI,QAAQ,CAI1C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/detectors/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,aAAa,IAAI,oBAAoB,EACrC,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAI1C,sFAAsF;AACtF,wBAAgB,eAAe,IAAI,QAAQ,CAI1C"}

package/dist/types/detectors/local.d.ts

@@ -18,7 +18,16 @@ export declare const DEFAULT_MODEL = "joelbarmettler/gheim-ch-560m";
 export interface LocalDetectorOptions {
     /** HuggingFace model id (must be a token-classification model). */
     model?: string;
-    /** transformers.js device: "auto" | "cpu" | "wasm" | "webgpu" | "gpu" | ... */
+    /**
+     * Backend selector. Defaults to `"auto"`, which:
+     *   - in the browser, probes `navigator.gpu.requestAdapter()` and uses
+     *     WebGPU if a real adapter is available, otherwise WASM. If WebGPU
+     *     loading throws (shader compile, OOM, driver bug) it falls back
+     *     to WASM transparently.
+     *   - in Node, just uses WASM (no WebGPU bindings).
+     * Pass `"webgpu"`, `"wasm"`, `"cpu"`, etc. to force a specific backend
+     * (no probe, no fallback — your choice is respected and may throw).
+     */
     device?: string;
     /** Quantization dtype: "fp32" | "fp16" | "q8" | "q4" | "auto" */
     dtype?: string;
@@ -38,19 +47,72 @@ export interface LocalDetectorOptions {
     batchSize?: number;
     /** Optional pre-built pipeline instance (e.g. for tests). */
     pipelineInstance?: unknown;
+    /**
+     * Optional callback fired during model loading. Receives a normalized
+     * event so consumers don't need to reconcile transformers.js's
+     * 0-1-vs-0-100 inconsistency or its raw status strings. Useful for
+     * driving a download progress bar.
+     */
+    onProgress?: (event: LocalDetectorLoadEvent) => void;
 }
+/** Normalized model-load event surfaced to {@link LocalDetectorOptions.onProgress}. */
+export interface LocalDetectorLoadEvent {
+    /** Phase of the load. */
+    phase: "initiate" | "download" | "progress" | "ready" | "done";
+    /** File being processed, when applicable. */
+    file?: string;
+    /** Bytes downloaded so far (only on `phase: "progress"`). */
+    loadedBytes?: number;
+    /** Total bytes for `file` (only on `phase: "progress"`). */
+    totalBytes?: number;
+    /** Fraction in [0, 1] (only on `phase: "progress"`). Normalized so
+     *  consumers can use the value directly without bounds-clamping. */
+    fraction?: number;
+    /** Backend currently being attempted (e.g. `"webgpu"`, `"wasm"`).
+     *  When auto-fallback fires, two phase-streams may be observed: one
+     *  for the failed `"webgpu"` attempt, then a fresh stream for `"wasm"`. */
+    device?: string;
+}
+interface DetectionItem {
+    start?: number;
+    end?: number;
+    word?: string;
+    entity?: string;
+    entity_group?: string;
+    score?: number;
+}
+type PipelineCallable = (text: string | string[], opts?: {
+    aggregation_strategy?: string;
+    batch_size?: number;
+}) => Promise<DetectionItem[] | DetectionItem[][]>;
 export declare class LocalDetector implements Detector {
     readonly model: string;
+    /** Device preference as passed to the constructor (`"auto"`, `"webgpu"`, ...). */
     readonly device: string;
     readonly dtype: string;
     readonly aggregationStrategy: string;
     readonly chunkTokens: number;
     readonly chunkOverlapTokens: number;
     readonly batchSize: number;
+    /** Backend that ended up being used after `load()` resolves. `null` until
+     *  the model is loaded. Different from {@link device} only when
+     *  `device: "auto"` was requested. */
+    actualDevice: string | null;
     private _pipeline;
     private _loadPromise;
+    private readonly _onProgress?;
     constructor(opts?: LocalDetectorOptions);
-    private load;
+    /**
+     * Load the model. Idempotent; concurrent calls share a single load.
+     * With `device: "auto"`, probes `navigator.gpu.requestAdapter()` and
+     * walks the candidate-backend list, falling back from WebGPU to WASM
+     * if construction throws (and reporting both attempts via `onProgress`).
+     */
+    load(): Promise<PipelineCallable>;
+    /** Build the ordered list of backends to attempt. */
+    private _planDeviceSequence;
+    /** Translate a raw transformers.js progress callback into our normalized event. */
+    private _emitProgress;
     detect(text: string, opts?: {
         model?: string;
     }): Promise<Span[]>;
@@ -65,4 +127,5 @@ export declare class LocalDetector implements Detector {
     }): Promise<Span[][]>;
     private chunkText;
 }
+export {};
 //# sourceMappingURL=local.d.ts.map

package/dist/types/detectors/local.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/detectors/local.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEhD,eAAO,MAAM,aAAa,iCAAiC,CAAC;AAQ5D,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAsCD,qBAAa,aAAc,YAAW,QAAQ;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,YAAY,CAA0C;gBAElD,IAAI,GAAE,oBAAyB;YAkB7B,IAAI;IAuBZ,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAYtE;;;;;OAKG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAyFlE,SAAS;CAkBxB"}
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/detectors/local.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -8,13 +8,16 @@
  *   - StreamDeanonymizer (low-level)
  */
 export { Session } from "./core/session.ts";
+export type { Normalizer, SessionOptions } from "./core/session.ts";
 export { LABEL_TO_TAG, SENTINEL_RE, isPossibleSentinelPrefix, labelTag, parseSentinel, renderSentinel, } from "./core/sentinels.ts";
 export type { Sentinel } from "./core/sentinels.ts";
 export { StreamDeanonymizer } from "./core/stream.ts";
 export type { Detector, Span } from "./detectors/base.ts";
 export { DEFAULT_BASE_URL, REMOTE_DEFAULT_MODEL, RemoteDetector, LocalDetector, defaultDetector, } from "./detectors/index.ts";
-export type { RemoteDetectorOptions, LocalDetectorOptions } from "./detectors/index.ts";
+export type { RemoteDetectorOptions, LocalDetectorOptions, LocalDetectorLoadEvent, } from "./detectors/index.ts";
 export { anonymizeMessages, anonymizeText, deanonymizeStream, deanonymizeText, } from "./plain.ts";
 export type { ChatMessage } from "./plain.ts";
-export declare const VERSION = "0.1.0";
+export declare const VERSION = "0.1.2";
+export { mergeAdjacent } from "./core/session.ts";
+export type { MergedSpan } from "./core/session.ts";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,wBAAwB,EACxB,QAAQ,EACR,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,WAAW,EACX,wBAAwB,EACxB,QAAQ,EACR,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types/normalizers.d.ts

@@ -43,9 +43,12 @@
 /**
  * A normalizer takes a raw surface and returns a canonical form, or
  * `null` if the surface is unparseable (caller falls back to the
- * default NFKC+lowercase key).
+ * default NFKC+lowercase key). Re-exported from the core for ergonomics
+ * — the canonical declaration lives in `core/session.ts` so that the
+ * main `gheim` entry doesn't pull in `node:module`.
  */
-export type Normalizer = (s: string) => string | null;
+export type { Normalizer } from "./core/session.ts";
+type Normalizer = (s: string) => string | null;
 /** Options for {@link e164}. */
 export interface E164Options {
     /**

package/dist/types/normalizers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalizers.d.ts","sourceRoot":"","sources":["../../src/normalizers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;AAEtD,gCAAgC;AAChC,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgDD;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,IAAI,GAAE,WAAgB,GAAG,UAAU,CAavD;AAED,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;CACvE;AAmBD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,GAAE,cAAmB,GAAG,UAAU,CAQ7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,UAAU,CAclD;AAQD,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAUvE"}
+{"version":3,"file":"normalizers.d.ts","sourceRoot":"","sources":["../../src/normalizers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH;;;;;;GAMG;AACH,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,KAAK,UAAU,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;AAE/C,gCAAgC;AAChC,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgDD;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,IAAI,GAAE,WAAgB,GAAG,UAAU,CAavD;AAED,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;CACvE;AAmBD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,GAAE,cAAmB,GAAG,UAAU,CAQ7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,UAAU,CAclD;AAQD,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAUvE"}

package/dist/types/openai/_chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_chat.d.ts","sourceRoot":"","sources":["../../../src/openai/_chat.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,OAAO,KAAK,WAAW,MAAM,QAAQ,CAAC;AAGtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAqC,KAAK,UAAU,EAAsB,MAAM,YAAY,CAAC;AAmGpG,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,EACnC,UAAU,EAAE,QAAQ;IAGjC,MAAM,CACV,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,sCAAsC,GAAG,UAAU,GACrF,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;IACjD,MAAM,CACV,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,mCAAmC,GAAG,UAAU,GAClF,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;CAoB5E;AAED,qBAAa,SAAS;IACpB,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;gBAC/B,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,QAAQ;CAGpE"}
+{"version":3,"file":"_chat.d.ts","sourceRoot":"","sources":["../../../src/openai/_chat.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,OAAO,KAAK,WAAW,MAAM,QAAQ,CAAC;AAGtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAqC,KAAK,UAAU,EAAsB,MAAM,YAAY,CAAC;AAoIpG,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,EACnC,UAAU,EAAE,QAAQ;IAGjC,MAAM,CACV,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,sCAAsC,GAAG,UAAU,GACrF,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;IACjD,MAAM,CACV,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,mCAAmC,GAAG,UAAU,GAClF,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;CAoB5E;AAED,qBAAa,SAAS;IACpB,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;gBAC/B,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,QAAQ;CAGpE"}

package/dist/types/openai/_client.d.ts

@@ -6,13 +6,26 @@ import { GheimChat } from "./_chat.ts";
 import { GheimCompletions } from "./_completions.ts";
 import { GheimResponses } from "./_responses.ts";
 import { GheimEmbeddings, GheimImages, GheimModerations } from "./_anonymize_only.ts";
-export interface GheimOpenAIOptions {
+/** Options for constructing a gheim-wrapped OpenAI client.
+ *
+ * gheim-specific keys (`gheimDetector`, `gheimStrict`, `openaiClient`,
+ * `clientOptions`) configure the wrapper itself. Any other key is
+ * forwarded to the underlying `new OpenAI(...)` constructor — so
+ * `apiKey`, `baseURL`, `organization` etc. work at the top level, like
+ * the openai SDK itself. This mirrors gheim-py's behavior, where
+ * everything except `gheim_*` kwargs gets forwarded via `**kwargs`.
+ *
+ * If both top-level passthrough AND `clientOptions` carry the same key,
+ * the top-level value wins.
+ */
+export interface GheimOpenAIOptions extends Omit<NonNullable<ConstructorParameters<typeof OpenAIClass>[0]>, never> {
     gheimDetector?: Detector;
     /** Strict mode: raise on access to unwrapped endpoints. Default true. */
     gheimStrict?: boolean;
     /** Pre-built openai client to wrap (useful for tests). */
     openaiClient?: OpenAIClass;
-    /** Forwarded to ``new OpenAI(...)`` when constructing the underlying client. */
+    /** Explicit shape for the inner `new OpenAI(...)` opts. Any key here is
+     *  overridden by the same key passed at the top level. */
     clientOptions?: ConstructorParameters<typeof OpenAIClass>[0];
 }
 export declare class OpenAI {

package/dist/types/openai/_client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_client.d.ts","sourceRoot":"","sources":["../../../src/openai/_client.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,KAAK,WAAW,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACL,eAAe,EACf,WAAW,EACX,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,gFAAgF;IAChF,aAAa,CAAC,EAAE,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9D;AAqBD,qBAAa,MAAM;IACjB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,sEAAsE;IACtE,GAAG,EAAE,WAAW,GAAG,SAAS,CAAC;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;gBAE1C,IAAI,GAAE,kBAAuB;IAiCnC,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;CAGpC;AAED,eAAO,MAAM,WAAW,eAAS,CAAC;AAClC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC"}
+{"version":3,"file":"_client.d.ts","sourceRoot":"","sources":["../../../src/openai/_client.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,KAAK,WAAW,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACL,eAAe,EACf,WAAW,EACX,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAG9B;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBACf,SAAQ,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;IAC9E,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B;8DAC0D;IAC1D,aAAa,CAAC,EAAE,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9D;AAqBD,qBAAa,MAAM;IACjB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,sEAAsE;IACtE,GAAG,EAAE,WAAW,GAAG,SAAS,CAAC;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;gBAE1C,IAAI,GAAE,kBAAuB;IA+CnC,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;CAGpC;AAED,eAAO,MAAM,WAAW,eAAS,CAAC;AAClC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gheim",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "PII round-trip for LLM APIs: anonymize before the request, de-anonymize the stream on the way back.",
   "license": "Apache-2.0",
   "author": "Joel Barmettler <joel.barmettler@gmail.com>",
@@ -13,7 +13,17 @@
     "url": "git+https://github.com/joelbarmettlerUZH/gheim.git",
     "directory": "packages/gheim-js"
   },
-  "keywords": ["pii", "privacy", "redaction", "openai", "llm", "anonymization", "ner", "swiss", "transformers"],
+  "keywords": [
+    "pii",
+    "privacy",
+    "redaction",
+    "openai",
+    "llm",
+    "anonymization",
+    "ner",
+    "swiss",
+    "transformers"
+  ],
   "type": "module",
   "main": "./dist/cjs/index.cjs",
   "module": "./dist/esm/index.js",
@@ -33,10 +43,14 @@
     },
     "./package.json": "./package.json"
   },
-  "files": ["dist", "README.md", "LICENSE"],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "rm -rf dist && bun run build:esm && bun run build:cjs && bun run build:types",
-    "build:esm": "bun build ./src/index.ts ./src/openai/index.ts --outdir ./dist/esm --target node --format esm --external openai --external @huggingface/transformers",
+    "build:esm": "bun build ./src/index.ts ./src/openai/index.ts --outdir ./dist/esm --target browser --format esm --external openai --external @huggingface/transformers --external libphonenumber-js --external chrono-node --external node:module",
     "build:cjs": "bun build ./src/index.ts ./src/openai/index.ts --outdir ./dist/cjs --target node --format cjs --entry-naming '[dir]/[name].cjs' --external openai --external @huggingface/transformers",
     "build:types": "tsc --emitDeclarationOnly --outDir dist/types",
     "test": "bun test",
@@ -55,13 +69,21 @@
     "@huggingface/transformers": ">=3.0.0 <5.0.0",
     "chrono-node": "^2.7.0",
     "libphonenumber-js": "^1.10.0",
-    "openai": ">=4.0.0 <6.0.0"
+    "openai": ">=4.0.0 <7.0.0"
   },
   "peerDependenciesMeta": {
-    "openai": { "optional": true },
-    "@huggingface/transformers": { "optional": true },
-    "libphonenumber-js": { "optional": true },
-    "chrono-node": { "optional": true }
+    "openai": {
+      "optional": true
+    },
+    "@huggingface/transformers": {
+      "optional": true
+    },
+    "libphonenumber-js": {
+      "optional": true
+    },
+    "chrono-node": {
+      "optional": true
+    }
   },
   "engines": {
     "node": ">=18"