@graphorin/embedder-transformersjs 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @graphorin/embedder-transformersjs
 
+## 0.6.1
+
+### Patch Changes
+
+- [#142](https://github.com/o-stepper/graphorin/pull/142) [`436d6ca`](https://github.com/o-stepper/graphorin/commit/436d6ca5ebbd16df094e915682d3915c279a8430) Thanks [@o-stepper](https://github.com/o-stepper)! - Version constants and version-bearing strings now derive from each package's manifest at build time (`VERSION = pkg.version`; writer ids, client/server info, OTLP framework attributes, build-info metrics interpolate it). No behavioral change at the current version: the rendered strings are byte-identical. A release bump no longer edits source; the new `check-version-consistency` gate fails any reintroduced hardcoded framework version.
+
+- Updated dependencies [[`436d6ca`](https://github.com/o-stepper/graphorin/commit/436d6ca5ebbd16df094e915682d3915c279a8430)]:
+  - @graphorin/core@0.6.1
+
 ## 0.6.0
 
 ### Patch Changes

package/README.md

@@ -81,4 +81,4 @@ MIT © 2026 Oleksiy Stepurenko.
 
 ---
 
-**Project Graphorin** · v0.6.0 · MIT License · © 2026 Oleksiy Stepurenko · <https://github.com/o-stepper/graphorin>
+**Project Graphorin** · v0.6.1 · MIT License · © 2026 Oleksiy Stepurenko · <https://github.com/o-stepper/graphorin>

package/dist/index.d.ts

@@ -2,8 +2,7 @@ import { EmbedOptions, EmbedderProvider } from "@graphorin/core/contracts";
 
 //#region src/index.d.ts
 
-/** Canonical version constant. Mirrors the `package.json` version. */
-declare const VERSION = "0.6.0";
+declare const VERSION: string;
 /**
  * Pooling strategy. Defaults to `'mean'` per the multilingual-e5 model
  * card.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;AAiGY,cAlFC,OAAA,GAkFc,OAId;AAWb;AAWA;AAWA;;;;AAsE2B,KArLf,OAAA,GAqLe,MAAA,GAAA,KAAA,GAAA,aAAA,GAAA,KAAA,GAAA,YAAA,GAAA,MAAA;;;;;AAkF3B;AAsBgB,UAtRC,6BAAA,CAsRQ;EAYT;;;qBA9RK;;;;;;;;;;;;;;;;;;;;;;;6BAuBQ;;;;;;;;;;;;;;;;;;;;;;;;;KA0BjB,gBAAA;YAEY;;WAAuC;MAC1D;QACG;;;;;;;;;KAUI,eAAA;;;;;MAIP,QAAQ;;;;;;;cAWA,sBAAA,SAA+B,KAAA;;;;;;;;;;iBAW5B,4BAAA,WACL,gCACR;;;;;;cASU,sBAAA,YAAkC;;uBAexB;;;;;;;;;;;;;;eAqDZ,8BACD,eACL,QAAQ,cAAc;;;iBAkFX,oCAAA,CAAA;;;;;;;iBAsBA,SAAA;;;;;;;;;iBAYA,mBAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;AAwFY,cAvEC,OAuED,EAAA,MAAA;AAWZ;AAeA;AAWA;AAWA;;;AAqEU,KApLE,OAAA,GAoLF,MAAA,GAAA,KAAA,GAAA,aAAA,GAAA,KAAA,GAAA,YAAA,GAAA,MAAA;;;;;;AAmFM,UAhQC,6BAAA,CAgQmC;EAsBpC;EAYA,SAAA,KAAA,CAAA,EAAA,MAAmB;;qBA9Rd;;;;;;;;;;;;;;;;;;;;;;;6BAuBQ;;;;;;;;;;;;;;;;;;;;;;;;;KA0BjB,gBAAA;YAEY;;WAAuC;MAC1D;QACG;;;;;;;;;KAUI,eAAA;;;;;MAIP,QAAQ;;;;;;;cAWA,sBAAA,SAA+B,KAAA;;;;;;;;;;iBAW5B,4BAAA,WACL,gCACR;;;;;;cASU,sBAAA,YAAkC;;uBAexB;;;;;;;;;;;;;;eAqDZ,8BACD,eACL,QAAQ,cAAc;;;iBAkFX,oCAAA,CAAA;;;;;;;iBAsBA,SAAA;;;;;;;;;iBAYA,mBAAA"}

package/dist/index.js

@@ -1,3 +1,4 @@
+import { version } from "./package.js";
 import { createHash } from "node:crypto";
 
 //#region src/index.ts
@@ -11,8 +12,8 @@ import { createHash } from "node:crypto";
 *
 * @packageDocumentation
 */
-/** Canonical version constant. Mirrors the `package.json` version. */
-const VERSION = "0.6.0";
+/** Canonical version constant, derived from `package.json` at build time. */
+const VERSION = version;
 const DEFAULT_MODEL = "Xenova/multilingual-e5-base";
 const DEFAULT_DIM = 768;
 /**

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["#model","#pooling","#normalize","#revision","#cacheDir","#dtype","#device","#pipelineFactory","#taskPrefix","#resolvedDim","#getExtractor","out: Float32Array[]","#extractor","#loading","CACHED_PIPELINE_FACTORY: PipelineFactory | null","KNOWN_DIMS: ReadonlyMap<string, number>"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @graphorin/embedder-transformersjs - default in-process embedder.\n *\n * Wraps `@huggingface/transformers@^4.1.0` to produce dense embeddings\n * inside the Graphorin process. Default model\n * `Xenova/multilingual-e5-base` (768-dim, multilingual; DEC-130 /\n * ADR-025).\n *\n * @packageDocumentation\n */\n\nimport { createHash } from 'node:crypto';\nimport type { EmbedderProvider, EmbedOptions } from '@graphorin/core/contracts';\n\n/** Canonical version constant. Mirrors the `package.json` version. */\nexport const VERSION = '0.6.0';\n\n/**\n * Pooling strategy. Defaults to `'mean'` per the multilingual-e5 model\n * card.\n *\n * @stable\n */\nexport type Pooling = 'mean' | 'cls' | 'first_token' | 'eos' | 'last_token' | 'none';\n\n/**\n * Configuration accepted by {@link createTransformersJsEmbedder}.\n *\n * @stable\n */\nexport interface TransformersJsEmbedderOptions {\n  /** Default `'Xenova/multilingual-e5-base'` (768-dim). */\n  readonly model?: string;\n  /** Default `'mean'`. */\n  readonly pooling?: Pooling;\n  /** Default `true`. */\n  readonly normalize?: boolean;\n  /** Optional model revision pin (`'main'` if unset). */\n  readonly revision?: string;\n  /**\n   * Optional cache directory. When unset, the embedder honours\n   * `process.env.GRAPHORIN_CACHE_DIR`, otherwise falls back to the\n   * Hugging Face default (`os.homedir()/.cache/huggingface/hub`).\n   */\n  readonly cacheDir?: string;\n  /**\n   * Optional dtype hint (`'fp32' | 'fp16' | 'q8' | 'q4'`). When unset,\n   * the runtime picks the model's recommended default.\n   */\n  readonly dtype?: string;\n  /** Override device (`'cpu'`, `'webgpu'`, …). Default `'cpu'`. */\n  readonly device?: string;\n  /**\n   * Override the underlying `pipeline` factory - used by the test\n   * suite to inject a stub. Production callers should leave this\n   * unset so the package lazily loads `@huggingface/transformers`.\n   */\n  readonly pipelineFactory?: PipelineFactory;\n  /**\n   * Optional dimensionality hint. When the caller knows the output\n   * dimension up-front, it is included in the canonical id without\n   * waiting for the first `embed()` call.\n   */\n  readonly dim?: number;\n  /**\n   * Disable the automatic E5 `query:` / `passage:` prefixing (PS-10). The\n   * prefixes are applied by default for E5-family models (the multilingual-e5\n   * default and any model whose id carries an `e5` token), because the E5 model\n   * card requires them and omitting them measurably degrades retrieval. Set\n   * this to `true` only if your inputs are already prefixed or you use a\n   * non-standard E5 export. Toggling it changes the canonical `configHash`\n   * (and thus the embedder id), which triggers a re-embedding migration.\n   */\n  readonly disableTaskPrefix?: boolean;\n}\n\n/**\n * Tiny structural shape of `@huggingface/transformers`' feature-\n * extraction pipeline used by this package. Declared inline so the\n * embedder does not import the heavy peer at build time.\n *\n * @internal\n */\nexport type FeatureExtractor = (\n  texts: string | readonly string[],\n  options?: { pooling?: Pooling; normalize?: boolean; signal?: AbortSignal },\n) => Promise<{\n  data: Float32Array;\n  dims: readonly number[];\n  tolist?(): unknown;\n}>;\n\n/**\n * Pipeline-factory shape used for dependency injection in tests.\n *\n * @internal\n */\nexport type PipelineFactory = (\n  task: 'feature-extraction',\n  model: string,\n  opts: { revision?: string; cache_dir?: string; dtype?: string; device?: string },\n) => Promise<FeatureExtractor>;\n\nconst DEFAULT_MODEL = 'Xenova/multilingual-e5-base';\nconst DEFAULT_DIM = 768;\n\n/**\n * Raised when the underlying transformer model cannot be loaded\n * (offline / corporate firewall / wrong cache dir).\n *\n * @stable\n */\nexport class EmbedderModelLoadError extends Error {\n  override readonly name = 'EmbedderModelLoadError';\n}\n\n/**\n * Build a `TransformersJsEmbedder` instance. Lazy: the underlying\n * pipeline is constructed on the first `embed()` call so packaging\n * the embedder does not pay the model-load cost.\n *\n * @stable\n */\nexport function createTransformersJsEmbedder(\n  options: TransformersJsEmbedderOptions = {},\n): TransformersJsEmbedder {\n  return new TransformersJsEmbedder(options);\n}\n\n/**\n * `EmbedderProvider` implementation backed by `@huggingface/transformers`.\n *\n * @stable\n */\nexport class TransformersJsEmbedder implements EmbedderProvider {\n  readonly #model: string;\n  readonly #pooling: Pooling;\n  readonly #normalize: boolean;\n  readonly #revision: string | undefined;\n  readonly #cacheDir: string | undefined;\n  readonly #dtype: string | undefined;\n  readonly #device: string | undefined;\n  readonly #pipelineFactory: PipelineFactory | undefined;\n  /** Whether to apply E5 `query:` / `passage:` prefixes (PS-10). */\n  readonly #taskPrefix: boolean;\n  #extractor: FeatureExtractor | null = null;\n  #loading: Promise<FeatureExtractor> | null = null;\n  #resolvedDim: number | null;\n\n  constructor(options: TransformersJsEmbedderOptions) {\n    this.#model = options.model ?? DEFAULT_MODEL;\n    this.#pooling = options.pooling ?? 'mean';\n    this.#normalize = options.normalize ?? true;\n    this.#revision = options.revision;\n    this.#cacheDir = options.cacheDir ?? process.env.GRAPHORIN_CACHE_DIR;\n    this.#dtype = options.dtype;\n    this.#device = options.device;\n    this.#pipelineFactory = options.pipelineFactory;\n    this.#resolvedDim = options.dim ?? guessDefaultDim(this.#model);\n    this.#taskPrefix = isE5Model(this.#model) && options.disableTaskPrefix !== true;\n  }\n\n  id(): string {\n    return `transformersjs:${this.#model}@${this.dim()}`;\n  }\n\n  /**\n   * Output dimension - the explicit `dim` option, a known-model\n   * default, or the width resolved from the first `embed()`.\n   * periphery-05 (the PS-11 fix ported from the Ollama embedder):\n   * throws for an unknown model with no `dim` hint instead of silently\n   * assuming 768 - a wrong assumed width bakes a wrong-width id AND a\n   * wrong-width vec0 table, and the id then CHANGES after the first\n   * `embed()` resolves the truth, which `lock-on-first` reads as an\n   * embedder swap.\n   */\n  dim(): number {\n    if (this.#resolvedDim !== null) return this.#resolvedDim;\n    throw new Error(\n      `[graphorin/embedder-transformersjs] Unknown embedding width for model '${this.#model}'. ` +\n        `Pass { dim: <width> } to createTransformersJsEmbedder(...) (or call embed() once before ` +\n        `registration so the width is resolved from the model output).`,\n    );\n  }\n\n  configHash(): string {\n    return canonicalConfigHash({\n      adapter: 'transformersjs',\n      model: this.#model,\n      pooling: this.#pooling,\n      normalize: this.#normalize,\n      revision: this.#revision ?? null,\n      dtype: this.#dtype ?? null,\n      device: this.#device ?? null,\n      // PS-10: the prefix policy changes the embeddings, so it must change the\n      // id. Only added when active (E5 + not disabled) so non-E5 ids - and the\n      // historical hash of an E5 model with prefixing turned off - are stable.\n      ...(this.#taskPrefix ? { taskPrefix: 'e5' as const } : {}),\n    });\n  }\n\n  async embed(\n    texts: ReadonlyArray<string>,\n    opts: EmbedOptions = {},\n  ): Promise<ReadonlyArray<Float32Array>> {\n    if (texts.length === 0) return [];\n    const extractor = await this.#getExtractor();\n    // PS-10: E5 models require an asymmetric `query:` / `passage:` prefix.\n    // Default to `passage` (the indexing role) when the caller doesn't specify.\n    const inputs = this.#taskPrefix\n      ? texts.map((t) => `${opts.taskType ?? 'passage'}: ${t}`)\n      : [...texts];\n    const result = await extractor(inputs, {\n      pooling: this.#pooling,\n      normalize: this.#normalize,\n      ...(opts.signal !== undefined ? { signal: opts.signal } : {}),\n    });\n    const lastDim = result.dims[result.dims.length - 1] ?? this.#resolvedDim ?? DEFAULT_DIM;\n    // periphery-05: a width already published (via `dim` option or a\n    // prior embed) must not silently drift - the vec0 table and the\n    // canonical id were derived from it.\n    if (this.#resolvedDim !== null && lastDim !== this.#resolvedDim) {\n      throw new Error(\n        `[graphorin/embedder-transformersjs] Model '${this.#model}' produced ${lastDim}-dim ` +\n          `vectors but the embedder is bound to ${this.#resolvedDim} - check the 'dim' option.`,\n      );\n    }\n    if (this.#resolvedDim === null) {\n      this.#resolvedDim = lastDim;\n    }\n    const dim = lastDim;\n    const out: Float32Array[] = [];\n    for (let i = 0; i < texts.length; i++) {\n      const start = i * dim;\n      out.push(result.data.slice(start, start + dim));\n    }\n    return out;\n  }\n\n  async #getExtractor(): Promise<FeatureExtractor> {\n    if (this.#extractor !== null) return this.#extractor;\n    if (this.#loading !== null) return this.#loading;\n    const loader = this.#pipelineFactory ?? (await loadDefaultPipelineFactory());\n    this.#loading = loader('feature-extraction', this.#model, {\n      ...(this.#revision !== undefined ? { revision: this.#revision } : {}),\n      ...(this.#cacheDir !== undefined ? { cache_dir: this.#cacheDir } : {}),\n      ...(this.#dtype !== undefined ? { dtype: this.#dtype } : {}),\n      ...(this.#device !== undefined ? { device: this.#device } : {}),\n    })\n      .then((pipe) => {\n        this.#extractor = pipe;\n        this.#loading = null;\n        return pipe;\n      })\n      .catch((err) => {\n        this.#loading = null;\n        throw new EmbedderModelLoadError(\n          `[graphorin/embedder-transformersjs] failed to load model '${this.#model}'. ` +\n            'See the offline-install guide for instructions on pre-downloading the model.',\n          { cause: err },\n        );\n      });\n    return this.#loading;\n  }\n}\n\n/** @internal */\nlet CACHED_PIPELINE_FACTORY: PipelineFactory | null = null;\n\nasync function loadDefaultPipelineFactory(): Promise<PipelineFactory> {\n  if (CACHED_PIPELINE_FACTORY !== null) return CACHED_PIPELINE_FACTORY;\n  try {\n    const mod = (await import('@huggingface/transformers')) as unknown as {\n      pipeline: PipelineFactory;\n    };\n    CACHED_PIPELINE_FACTORY = mod.pipeline;\n    return CACHED_PIPELINE_FACTORY;\n  } catch (err) {\n    throw new EmbedderModelLoadError(\n      \"[graphorin/embedder-transformersjs] required peer '@huggingface/transformers' is not installed.\",\n      { cause: err },\n    );\n  }\n}\n\n/** Test-only cache reset. */\nexport function _resetPipelineFactoryCacheForTesting(): void {\n  CACHED_PIPELINE_FACTORY = null;\n}\n\nconst KNOWN_DIMS: ReadonlyMap<string, number> = new Map([\n  ['Xenova/multilingual-e5-small', 384],\n  ['Xenova/multilingual-e5-base', 768],\n  ['Xenova/multilingual-e5-large', 1024],\n  ['Xenova/bge-m3', 1024],\n  ['onnx-community/all-MiniLM-L6-v2-ONNX', 384],\n]);\n\nfunction guessDefaultDim(model: string): number | null {\n  return KNOWN_DIMS.get(model) ?? null;\n}\n\n/**\n * True when a model id belongs to the E5 family, which requires asymmetric\n * `query:` / `passage:` prefixes (PS-10). Matches an `e5` token bounded by a\n * path / dash / underscore so it covers `multilingual-e5-base`, `e5-large`,\n * `intfloat/e5-mistral`, etc. without false-matching unrelated names.\n */\nexport function isE5Model(model: string): boolean {\n  return /(?:^|[/_-])e5(?:[/_-]|$)/i.test(model);\n}\n\n/**\n * Canonical-JSON deterministic hash of an embedder configuration.\n * Object keys are sorted lexicographically; primitives flow through as\n * `JSON.stringify` would render them. Used by the multi-table per-\n * embedder vec0 layout to tell drift apart from a true model swap.\n *\n * @stable\n */\nexport function canonicalConfigHash(config: unknown): string {\n  const canonical = canonicalize(config);\n  return createHash('sha256').update(canonical, 'utf8').digest('hex');\n}\n\nfunction canonicalize(value: unknown): string {\n  if (value === null) return 'null';\n  if (typeof value === 'boolean') return value ? 'true' : 'false';\n  if (typeof value === 'number') return Number.isFinite(value) ? value.toString() : 'null';\n  if (typeof value === 'string') return JSON.stringify(value);\n  if (Array.isArray(value)) {\n    return `[${value.map(canonicalize).join(',')}]`;\n  }\n  if (typeof value === 'object') {\n    const obj = value as Record<string, unknown>;\n    const keys = Object.keys(obj).sort();\n    return `{${keys.map((k) => `${JSON.stringify(k)}:${canonicalize(obj[k])}`).join(',')}}`;\n  }\n  return 'null';\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["VERSION: string","pkg.version","#model","#pooling","#normalize","#revision","#cacheDir","#dtype","#device","#pipelineFactory","#taskPrefix","#resolvedDim","#getExtractor","out: Float32Array[]","#extractor","#loading","CACHED_PIPELINE_FACTORY: PipelineFactory | null","KNOWN_DIMS: ReadonlyMap<string, number>"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @graphorin/embedder-transformersjs - default in-process embedder.\n *\n * Wraps `@huggingface/transformers@^4.1.0` to produce dense embeddings\n * inside the Graphorin process. Default model\n * `Xenova/multilingual-e5-base` (768-dim, multilingual; DEC-130 /\n * ADR-025).\n *\n * @packageDocumentation\n */\n\nimport { createHash } from 'node:crypto';\nimport type { EmbedderProvider, EmbedOptions } from '@graphorin/core/contracts';\n\n/** Canonical version constant, derived from `package.json` at build time. */\nimport pkg from '../package.json' with { type: 'json' };\n\nexport const VERSION: string = pkg.version;\n\n/**\n * Pooling strategy. Defaults to `'mean'` per the multilingual-e5 model\n * card.\n *\n * @stable\n */\nexport type Pooling = 'mean' | 'cls' | 'first_token' | 'eos' | 'last_token' | 'none';\n\n/**\n * Configuration accepted by {@link createTransformersJsEmbedder}.\n *\n * @stable\n */\nexport interface TransformersJsEmbedderOptions {\n  /** Default `'Xenova/multilingual-e5-base'` (768-dim). */\n  readonly model?: string;\n  /** Default `'mean'`. */\n  readonly pooling?: Pooling;\n  /** Default `true`. */\n  readonly normalize?: boolean;\n  /** Optional model revision pin (`'main'` if unset). */\n  readonly revision?: string;\n  /**\n   * Optional cache directory. When unset, the embedder honours\n   * `process.env.GRAPHORIN_CACHE_DIR`, otherwise falls back to the\n   * Hugging Face default (`os.homedir()/.cache/huggingface/hub`).\n   */\n  readonly cacheDir?: string;\n  /**\n   * Optional dtype hint (`'fp32' | 'fp16' | 'q8' | 'q4'`). When unset,\n   * the runtime picks the model's recommended default.\n   */\n  readonly dtype?: string;\n  /** Override device (`'cpu'`, `'webgpu'`, …). Default `'cpu'`. */\n  readonly device?: string;\n  /**\n   * Override the underlying `pipeline` factory - used by the test\n   * suite to inject a stub. Production callers should leave this\n   * unset so the package lazily loads `@huggingface/transformers`.\n   */\n  readonly pipelineFactory?: PipelineFactory;\n  /**\n   * Optional dimensionality hint. When the caller knows the output\n   * dimension up-front, it is included in the canonical id without\n   * waiting for the first `embed()` call.\n   */\n  readonly dim?: number;\n  /**\n   * Disable the automatic E5 `query:` / `passage:` prefixing (PS-10). The\n   * prefixes are applied by default for E5-family models (the multilingual-e5\n   * default and any model whose id carries an `e5` token), because the E5 model\n   * card requires them and omitting them measurably degrades retrieval. Set\n   * this to `true` only if your inputs are already prefixed or you use a\n   * non-standard E5 export. Toggling it changes the canonical `configHash`\n   * (and thus the embedder id), which triggers a re-embedding migration.\n   */\n  readonly disableTaskPrefix?: boolean;\n}\n\n/**\n * Tiny structural shape of `@huggingface/transformers`' feature-\n * extraction pipeline used by this package. Declared inline so the\n * embedder does not import the heavy peer at build time.\n *\n * @internal\n */\nexport type FeatureExtractor = (\n  texts: string | readonly string[],\n  options?: { pooling?: Pooling; normalize?: boolean; signal?: AbortSignal },\n) => Promise<{\n  data: Float32Array;\n  dims: readonly number[];\n  tolist?(): unknown;\n}>;\n\n/**\n * Pipeline-factory shape used for dependency injection in tests.\n *\n * @internal\n */\nexport type PipelineFactory = (\n  task: 'feature-extraction',\n  model: string,\n  opts: { revision?: string; cache_dir?: string; dtype?: string; device?: string },\n) => Promise<FeatureExtractor>;\n\nconst DEFAULT_MODEL = 'Xenova/multilingual-e5-base';\nconst DEFAULT_DIM = 768;\n\n/**\n * Raised when the underlying transformer model cannot be loaded\n * (offline / corporate firewall / wrong cache dir).\n *\n * @stable\n */\nexport class EmbedderModelLoadError extends Error {\n  override readonly name = 'EmbedderModelLoadError';\n}\n\n/**\n * Build a `TransformersJsEmbedder` instance. Lazy: the underlying\n * pipeline is constructed on the first `embed()` call so packaging\n * the embedder does not pay the model-load cost.\n *\n * @stable\n */\nexport function createTransformersJsEmbedder(\n  options: TransformersJsEmbedderOptions = {},\n): TransformersJsEmbedder {\n  return new TransformersJsEmbedder(options);\n}\n\n/**\n * `EmbedderProvider` implementation backed by `@huggingface/transformers`.\n *\n * @stable\n */\nexport class TransformersJsEmbedder implements EmbedderProvider {\n  readonly #model: string;\n  readonly #pooling: Pooling;\n  readonly #normalize: boolean;\n  readonly #revision: string | undefined;\n  readonly #cacheDir: string | undefined;\n  readonly #dtype: string | undefined;\n  readonly #device: string | undefined;\n  readonly #pipelineFactory: PipelineFactory | undefined;\n  /** Whether to apply E5 `query:` / `passage:` prefixes (PS-10). */\n  readonly #taskPrefix: boolean;\n  #extractor: FeatureExtractor | null = null;\n  #loading: Promise<FeatureExtractor> | null = null;\n  #resolvedDim: number | null;\n\n  constructor(options: TransformersJsEmbedderOptions) {\n    this.#model = options.model ?? DEFAULT_MODEL;\n    this.#pooling = options.pooling ?? 'mean';\n    this.#normalize = options.normalize ?? true;\n    this.#revision = options.revision;\n    this.#cacheDir = options.cacheDir ?? process.env.GRAPHORIN_CACHE_DIR;\n    this.#dtype = options.dtype;\n    this.#device = options.device;\n    this.#pipelineFactory = options.pipelineFactory;\n    this.#resolvedDim = options.dim ?? guessDefaultDim(this.#model);\n    this.#taskPrefix = isE5Model(this.#model) && options.disableTaskPrefix !== true;\n  }\n\n  id(): string {\n    return `transformersjs:${this.#model}@${this.dim()}`;\n  }\n\n  /**\n   * Output dimension - the explicit `dim` option, a known-model\n   * default, or the width resolved from the first `embed()`.\n   * periphery-05 (the PS-11 fix ported from the Ollama embedder):\n   * throws for an unknown model with no `dim` hint instead of silently\n   * assuming 768 - a wrong assumed width bakes a wrong-width id AND a\n   * wrong-width vec0 table, and the id then CHANGES after the first\n   * `embed()` resolves the truth, which `lock-on-first` reads as an\n   * embedder swap.\n   */\n  dim(): number {\n    if (this.#resolvedDim !== null) return this.#resolvedDim;\n    throw new Error(\n      `[graphorin/embedder-transformersjs] Unknown embedding width for model '${this.#model}'. ` +\n        `Pass { dim: <width> } to createTransformersJsEmbedder(...) (or call embed() once before ` +\n        `registration so the width is resolved from the model output).`,\n    );\n  }\n\n  configHash(): string {\n    return canonicalConfigHash({\n      adapter: 'transformersjs',\n      model: this.#model,\n      pooling: this.#pooling,\n      normalize: this.#normalize,\n      revision: this.#revision ?? null,\n      dtype: this.#dtype ?? null,\n      device: this.#device ?? null,\n      // PS-10: the prefix policy changes the embeddings, so it must change the\n      // id. Only added when active (E5 + not disabled) so non-E5 ids - and the\n      // historical hash of an E5 model with prefixing turned off - are stable.\n      ...(this.#taskPrefix ? { taskPrefix: 'e5' as const } : {}),\n    });\n  }\n\n  async embed(\n    texts: ReadonlyArray<string>,\n    opts: EmbedOptions = {},\n  ): Promise<ReadonlyArray<Float32Array>> {\n    if (texts.length === 0) return [];\n    const extractor = await this.#getExtractor();\n    // PS-10: E5 models require an asymmetric `query:` / `passage:` prefix.\n    // Default to `passage` (the indexing role) when the caller doesn't specify.\n    const inputs = this.#taskPrefix\n      ? texts.map((t) => `${opts.taskType ?? 'passage'}: ${t}`)\n      : [...texts];\n    const result = await extractor(inputs, {\n      pooling: this.#pooling,\n      normalize: this.#normalize,\n      ...(opts.signal !== undefined ? { signal: opts.signal } : {}),\n    });\n    const lastDim = result.dims[result.dims.length - 1] ?? this.#resolvedDim ?? DEFAULT_DIM;\n    // periphery-05: a width already published (via `dim` option or a\n    // prior embed) must not silently drift - the vec0 table and the\n    // canonical id were derived from it.\n    if (this.#resolvedDim !== null && lastDim !== this.#resolvedDim) {\n      throw new Error(\n        `[graphorin/embedder-transformersjs] Model '${this.#model}' produced ${lastDim}-dim ` +\n          `vectors but the embedder is bound to ${this.#resolvedDim} - check the 'dim' option.`,\n      );\n    }\n    if (this.#resolvedDim === null) {\n      this.#resolvedDim = lastDim;\n    }\n    const dim = lastDim;\n    const out: Float32Array[] = [];\n    for (let i = 0; i < texts.length; i++) {\n      const start = i * dim;\n      out.push(result.data.slice(start, start + dim));\n    }\n    return out;\n  }\n\n  async #getExtractor(): Promise<FeatureExtractor> {\n    if (this.#extractor !== null) return this.#extractor;\n    if (this.#loading !== null) return this.#loading;\n    const loader = this.#pipelineFactory ?? (await loadDefaultPipelineFactory());\n    this.#loading = loader('feature-extraction', this.#model, {\n      ...(this.#revision !== undefined ? { revision: this.#revision } : {}),\n      ...(this.#cacheDir !== undefined ? { cache_dir: this.#cacheDir } : {}),\n      ...(this.#dtype !== undefined ? { dtype: this.#dtype } : {}),\n      ...(this.#device !== undefined ? { device: this.#device } : {}),\n    })\n      .then((pipe) => {\n        this.#extractor = pipe;\n        this.#loading = null;\n        return pipe;\n      })\n      .catch((err) => {\n        this.#loading = null;\n        throw new EmbedderModelLoadError(\n          `[graphorin/embedder-transformersjs] failed to load model '${this.#model}'. ` +\n            'See the offline-install guide for instructions on pre-downloading the model.',\n          { cause: err },\n        );\n      });\n    return this.#loading;\n  }\n}\n\n/** @internal */\nlet CACHED_PIPELINE_FACTORY: PipelineFactory | null = null;\n\nasync function loadDefaultPipelineFactory(): Promise<PipelineFactory> {\n  if (CACHED_PIPELINE_FACTORY !== null) return CACHED_PIPELINE_FACTORY;\n  try {\n    const mod = (await import('@huggingface/transformers')) as unknown as {\n      pipeline: PipelineFactory;\n    };\n    CACHED_PIPELINE_FACTORY = mod.pipeline;\n    return CACHED_PIPELINE_FACTORY;\n  } catch (err) {\n    throw new EmbedderModelLoadError(\n      \"[graphorin/embedder-transformersjs] required peer '@huggingface/transformers' is not installed.\",\n      { cause: err },\n    );\n  }\n}\n\n/** Test-only cache reset. */\nexport function _resetPipelineFactoryCacheForTesting(): void {\n  CACHED_PIPELINE_FACTORY = null;\n}\n\nconst KNOWN_DIMS: ReadonlyMap<string, number> = new Map([\n  ['Xenova/multilingual-e5-small', 384],\n  ['Xenova/multilingual-e5-base', 768],\n  ['Xenova/multilingual-e5-large', 1024],\n  ['Xenova/bge-m3', 1024],\n  ['onnx-community/all-MiniLM-L6-v2-ONNX', 384],\n]);\n\nfunction guessDefaultDim(model: string): number | null {\n  return KNOWN_DIMS.get(model) ?? null;\n}\n\n/**\n * True when a model id belongs to the E5 family, which requires asymmetric\n * `query:` / `passage:` prefixes (PS-10). Matches an `e5` token bounded by a\n * path / dash / underscore so it covers `multilingual-e5-base`, `e5-large`,\n * `intfloat/e5-mistral`, etc. without false-matching unrelated names.\n */\nexport function isE5Model(model: string): boolean {\n  return /(?:^|[/_-])e5(?:[/_-]|$)/i.test(model);\n}\n\n/**\n * Canonical-JSON deterministic hash of an embedder configuration.\n * Object keys are sorted lexicographically; primitives flow through as\n * `JSON.stringify` would render them. Used by the multi-table per-\n * embedder vec0 layout to tell drift apart from a true model swap.\n *\n * @stable\n */\nexport function canonicalConfigHash(config: unknown): string {\n  const canonical = canonicalize(config);\n  return createHash('sha256').update(canonical, 'utf8').digest('hex');\n}\n\nfunction canonicalize(value: unknown): string {\n  if (value === null) return 'null';\n  if (typeof value === 'boolean') return value ? 'true' : 'false';\n  if (typeof value === 'number') return Number.isFinite(value) ? value.toString() : 'null';\n  if (typeof value === 'string') return JSON.stringify(value);\n  if (Array.isArray(value)) {\n    return `[${value.map(canonicalize).join(',')}]`;\n  }\n  if (typeof value === 'object') {\n    const obj = value as Record<string, unknown>;\n    const keys = Object.keys(obj).sort();\n    return `{${keys.map((k) => `${JSON.stringify(k)}:${canonicalize(obj[k])}`).join(',')}}`;\n  }\n  return 'null';\n}\n"],"mappings":"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"}

package/dist/package.js

@@ -0,0 +1,6 @@
+//#region package.json
+var version = "0.6.1";
+
+//#endregion
+export { version };
+//# sourceMappingURL=package.js.map

package/dist/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","names":[],"sources":["../package.json"],"sourcesContent":["{\n  \"name\": \"@graphorin/embedder-transformersjs\",\n  \"version\": \"0.6.1\",\n  \"description\": \"Default in-process embedder for the Graphorin framework. Wraps `@huggingface/transformers@^4.1.0` to produce dense vectors with the multilingual `Xenova/multilingual-e5-base` model (768-dim) by default. Implements the `EmbedderProvider` contract from `@graphorin/core/contracts` with deterministic `configHash`, batched embed, lazy model download (cache honours `GRAPHORIN_CACHE_DIR`), and an actionable error if the model cannot be fetched.\",\n  \"license\": \"MIT\",\n  \"author\": \"Oleksiy Stepurenko\",\n  \"homepage\": \"https://github.com/o-stepper/graphorin/tree/main/packages/embedder-transformersjs\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/o-stepper/graphorin.git\",\n    \"directory\": \"packages/embedder-transformersjs\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/o-stepper/graphorin/issues\"\n  },\n  \"keywords\": [\n    \"graphorin\",\n    \"ai\",\n    \"agents\",\n    \"framework\",\n    \"embeddings\",\n    \"transformersjs\",\n    \"huggingface\",\n    \"multilingual\"\n  ],\n  \"type\": \"module\",\n  \"engines\": {\n    \"node\": \">=22.0.0\"\n  },\n  \"main\": \"./dist/index.js\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"README.md\",\n    \"CHANGELOG.md\",\n    \"LICENSE\"\n  ],\n  \"scripts\": {\n    \"build\": \"tsdown\",\n    \"typecheck\": \"tsc --noEmit && tsc -p tsconfig.tests.json\",\n    \"test\": \"vitest run\",\n    \"lint\": \"biome check .\",\n    \"clean\": \"rimraf dist .turbo *.tsbuildinfo\"\n  },\n  \"dependencies\": {\n    \"@graphorin/core\": \"workspace:*\"\n  },\n  \"peerDependencies\": {\n    \"@huggingface/transformers\": \"^4.1.0\"\n  },\n  \"peerDependenciesMeta\": {\n    \"@huggingface/transformers\": {\n      \"optional\": false\n    }\n  },\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  },\n  \"devDependencies\": {\n    \"@huggingface/transformers\": \"^4.1.0\"\n  }\n}\n"],"mappings":";cAEa"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphorin/embedder-transformersjs",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Default in-process embedder for the Graphorin framework. Wraps `@huggingface/transformers@^4.1.0` to produce dense vectors with the multilingual `Xenova/multilingual-e5-base` model (768-dim) by default. Implements the `EmbedderProvider` contract from `@graphorin/core/contracts` with deterministic `configHash`, batched embed, lazy model download (cache honours `GRAPHORIN_CACHE_DIR`), and an actionable error if the model cannot be fetched.",
   "license": "MIT",
   "author": "Oleksiy Stepurenko",
@@ -44,7 +44,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@graphorin/core": "0.6.0"
+    "@graphorin/core": "0.6.1"
   },
   "peerDependencies": {
     "@huggingface/transformers": "^4.1.0"