@kalaa/node 1.0.8 → 1.0.9

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 (3) hide show
  1. package/README.md +2 -0
  2. package/costmeter.js +76 -138
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -58,6 +58,8 @@ kalaa.withContext('nightly-digest', () => {
58
58
  - Gemini: `generateContent` and `generateContentStream` — both `@google/genai` (current) and `@google/generative-ai` (legacy) are supported
59
59
  - Whisper/audio transcription duration
60
60
 
61
+
62
+ > **Order matters for Gemini:** call `kalaa.observe()` before you `require('@google/genai')` anywhere in your app. (OpenAI and Anthropic aren't order-sensitive — only the current Gemini SDK's instance-bound methods require this.)
61
63
  ## Configuration
62
64
 
63
65
  | Option | Env var | Default |
package/costmeter.js CHANGED
@@ -475,152 +475,90 @@ function patchAnthropicModule() {
475
475
  Anthropic.__cm_patched = true;
476
476
  log('anthropic module patched (prototype-level)');
477
477
  }
478
- function patchGeminiModule() {
479
- patchGeminiLegacy();
480
- patchGeminiUnified();
481
- }
482
-
483
- // Old SDK: @google/generative-ai — GoogleGenerativeAI().getGenerativeModel().generateContent()
484
- function patchGeminiLegacy() {
485
- let Mod;
486
- try { Mod = require('@google/generative-ai'); } catch { return; } // not installed, skip
487
- const GoogleGenerativeAI = Mod.GoogleGenerativeAI;
488
- if (!GoogleGenerativeAI || GoogleGenerativeAI.__cm_patched) return;
489
-
490
- let GenerativeModel;
491
- try {
492
- const probe = new GoogleGenerativeAI('cm_probe');
493
- const model = probe.getGenerativeModel({ model: 'gemini-1.5-flash' });
494
- GenerativeModel = Object.getPrototypeOf(model).constructor;
495
- } catch (e) {
496
- log('gemini (legacy) probe failed:', e.message);
497
- return;
498
- }
499
-
500
- if (GenerativeModel?.prototype?.generateContent && !GenerativeModel.prototype.generateContent.__cm) {
501
- const orig = GenerativeModel.prototype.generateContent;
502
- const wrapped = async function (params, ...rest) {
503
- const t0 = Date.now();
504
- const modelName = (this.model || 'gemini').replace(/^models\//, '');
505
- let _user, clean = params;
506
- if (params && typeof params === 'object' && !Array.isArray(params) && '_user' in params) {
507
- ({ _user, ...clean } = params);
508
- }
509
- try {
510
- const resp = await orig.call(this, clean, ...rest);
511
- const usage = resp?.response?.usageMetadata || {};
512
- track({ provider: 'gemini', model: modelName, usage, latencyMs: Date.now() - t0, endUser: _user });
513
- return resp;
514
- } catch (err) {
515
- track({ provider: 'gemini', model: modelName, usage: {}, latencyMs: Date.now() - t0, status: 'error', meta: { error: String(err.message).slice(0, 200) }, endUser: _user });
516
- throw err;
517
- }
518
- };
519
- wrapped.__cm = true;
520
- GenerativeModel.prototype.generateContent = wrapped;
521
- }
522
-
523
- if (GenerativeModel?.prototype?.generateContentStream && !GenerativeModel.prototype.generateContentStream.__cm) {
524
- const orig = GenerativeModel.prototype.generateContentStream;
525
- const wrapped = async function (params, ...rest) {
526
- const t0 = Date.now();
527
- const modelName = (this.model || 'gemini').replace(/^models\//, '');
528
- let _user, clean = params;
529
- if (params && typeof params === 'object' && !Array.isArray(params) && '_user' in params) {
530
- ({ _user, ...clean } = params);
531
- }
532
- try {
533
- const result = await orig.call(this, clean, ...rest);
534
- result.response.then(finalResp => {
535
- const usage = finalResp?.usageMetadata || {};
536
- track({ provider: 'gemini', model: modelName, usage, latencyMs: Date.now() - t0, status: Object.keys(usage).length ? 'ok' : 'no_usage_streamed', endUser: _user });
537
- }).catch(() => {});
538
- return result;
539
- } catch (err) {
540
- track({ provider: 'gemini', model: modelName, usage: {}, latencyMs: Date.now() - t0, status: 'error', meta: { error: String(err.message).slice(0, 200) }, endUser: _user });
541
- throw err;
542
- }
543
- };
544
- wrapped.__cm = true;
545
- GenerativeModel.prototype.generateContentStream = wrapped;
546
- }
547
-
548
- GoogleGenerativeAI.__cm_patched = true;
549
- log('gemini (legacy @google/generative-ai) module patched (prototype-level)');
550
- }
551
-
552
- // New SDK: @google/genai — new GoogleGenAI({apiKey}).models.generateContent({model, contents})
478
+ // New SDK: @google/genai — generateContent/generateContentStream are bound
479
+ // per-instance in the Models constructor, not on Models.prototype. Prototype
480
+ // patching is a no-op here; we wrap the instance's own methods instead, right
481
+ // after GoogleGenAI's constructor creates them.
553
482
  function patchGeminiUnified() {
554
483
  let Mod;
555
484
  try { Mod = require('@google/genai'); } catch { return; } // not installed, skip
556
- const GoogleGenAI = Mod.GoogleGenAI;
557
- if (!GoogleGenAI || GoogleGenAI.__cm_patched) return;
485
+ const OrigGoogleGenAI = Mod.GoogleGenAI;
486
+ if (!OrigGoogleGenAI || OrigGoogleGenAI.__cm_patched) return;
487
+
488
+ function wrapModelsInstance(models) {
489
+ if (!models || models.__cm_wrapped) return;
490
+
491
+ if (typeof models.generateContent === 'function' && !models.generateContent.__cm) {
492
+ const orig = models.generateContent.bind(models);
493
+ const wrapped = async function (params, ...rest) {
494
+ const t0 = Date.now();
495
+ const { _user, ...clean } = params || {};
496
+ const modelName = (clean.model || 'gemini').replace(/^models\//, '');
497
+ try {
498
+ const resp = await orig(clean, ...rest);
499
+ track({ provider: 'gemini', model: modelName, usage: resp?.usageMetadata || {}, latencyMs: Date.now() - t0, endUser: _user });
500
+ return resp;
501
+ } catch (err) {
502
+ track({ provider: 'gemini', model: modelName, usage: {}, latencyMs: Date.now() - t0, status: 'error', meta: { error: String(err.message).slice(0, 200) }, endUser: _user });
503
+ throw err;
504
+ }
505
+ };
506
+ wrapped.__cm = true;
507
+ models.generateContent = wrapped;
508
+ }
558
509
 
559
- let Models;
560
- try {
561
- const probe = new GoogleGenAI({ apiKey: 'cm_probe' });
562
- Models = Object.getPrototypeOf(probe.models).constructor;
563
- } catch (e) {
564
- log('gemini (unified) probe failed:', e.message);
565
- return;
566
- }
510
+ if (typeof models.generateContentStream === 'function' && !models.generateContentStream.__cm) {
511
+ const orig = models.generateContentStream.bind(models);
512
+ const wrapped = async function (params, ...rest) {
513
+ const t0 = Date.now();
514
+ const { _user, ...clean } = params || {};
515
+ const modelName = (clean.model || 'gemini').replace(/^models\//, '');
516
+ try {
517
+ const stream = await orig(clean, ...rest);
518
+ const origIterator = stream[Symbol.asyncIterator].bind(stream);
519
+ let lastUsage = null;
520
+ stream[Symbol.asyncIterator] = function () {
521
+ const it = origIterator();
522
+ return {
523
+ async next() {
524
+ const result = await it.next();
525
+ if (!result.done && result.value?.usageMetadata) lastUsage = result.value.usageMetadata;
526
+ if (result.done) {
527
+ track({ provider: 'gemini', model: modelName, usage: lastUsage || {}, latencyMs: Date.now() - t0, status: lastUsage ? 'ok' : 'no_usage_streamed', endUser: _user });
528
+ }
529
+ return result;
530
+ },
531
+ return(v) { return it.return ? it.return(v) : Promise.resolve({ value: v, done: true }); },
532
+ throw(err) { return it.throw ? it.throw(err) : Promise.reject(err); },
533
+ };
534
+ };
535
+ return stream;
536
+ } catch (err) {
537
+ track({ provider: 'gemini', model: modelName, usage: {}, latencyMs: Date.now() - t0, status: 'error', meta: { error: String(err.message).slice(0, 200) }, endUser: _user });
538
+ throw err;
539
+ }
540
+ };
541
+ wrapped.__cm = true;
542
+ models.generateContentStream = wrapped;
543
+ }
567
544
 
568
- if (Models?.prototype?.generateContent && !Models.prototype.generateContent.__cm) {
569
- const orig = Models.prototype.generateContent;
570
- const wrapped = async function (params, ...rest) {
571
- const t0 = Date.now();
572
- const { _user, ...clean } = params || {};
573
- const modelName = (clean.model || 'gemini').replace(/^models\//, '');
574
- try {
575
- const resp = await orig.call(this, clean, ...rest);
576
- track({ provider: 'gemini', model: modelName, usage: resp?.usageMetadata || {}, latencyMs: Date.now() - t0, endUser: _user });
577
- return resp;
578
- } catch (err) {
579
- track({ provider: 'gemini', model: modelName, usage: {}, latencyMs: Date.now() - t0, status: 'error', meta: { error: String(err.message).slice(0, 200) }, endUser: _user });
580
- throw err;
581
- }
582
- };
583
- wrapped.__cm = true;
584
- Models.prototype.generateContent = wrapped;
545
+ models.__cm_wrapped = true;
585
546
  }
586
547
 
587
- if (Models?.prototype?.generateContentStream && !Models.prototype.generateContentStream.__cm) {
588
- const orig = Models.prototype.generateContentStream;
589
- const wrapped = async function (params, ...rest) {
590
- const t0 = Date.now();
591
- const { _user, ...clean } = params || {};
592
- const modelName = (clean.model || 'gemini').replace(/^models\//, '');
593
- try {
594
- const stream = await orig.call(this, clean, ...rest);
595
- const origIterator = stream[Symbol.asyncIterator].bind(stream);
596
- let lastUsage = null;
597
- stream[Symbol.asyncIterator] = function () {
598
- const it = origIterator();
599
- return {
600
- async next() {
601
- const result = await it.next();
602
- if (!result.done && result.value?.usageMetadata) lastUsage = result.value.usageMetadata;
603
- if (result.done) {
604
- track({ provider: 'gemini', model: modelName, usage: lastUsage || {}, latencyMs: Date.now() - t0, status: lastUsage ? 'ok' : 'no_usage_streamed', endUser: _user });
605
- }
606
- return result;
607
- },
608
- return(v) { return it.return ? it.return(v) : Promise.resolve({ value: v, done: true }); },
609
- throw(err) { return it.throw ? it.throw(err) : Promise.reject(err); },
610
- };
611
- };
612
- return stream;
613
- } catch (err) {
614
- track({ provider: 'gemini', model: modelName, usage: {}, latencyMs: Date.now() - t0, status: 'error', meta: { error: String(err.message).slice(0, 200) }, endUser: _user });
615
- throw err;
616
- }
617
- };
618
- wrapped.__cm = true;
619
- Models.prototype.generateContentStream = wrapped;
620
- }
548
+ // Proxy the constructor: every `new GoogleGenAI(...)` still runs the real
549
+ // constructor untouched, we just reach into the instance it produces and
550
+ // wrap `.models` before handing the instance back.
551
+ const PatchedGoogleGenAI = new Proxy(OrigGoogleGenAI, {
552
+ construct(Target, args) {
553
+ const instance = new Target(...args);
554
+ wrapModelsInstance(instance.models);
555
+ return instance;
556
+ },
557
+ });
558
+ PatchedGoogleGenAI.__cm_patched = true;
621
559
 
622
- GoogleGenAI.__cm_patched = true;
623
- log('gemini (unified @google/genai) module patched (prototype-level)');
560
+ Mod.GoogleGenAI = PatchedGoogleGenAI;
561
+ log('gemini (unified @google/genai) module patched (instance-level via constructor proxy)');
624
562
  }
625
563
 
626
564
  // ── PUBLIC API ───────────────────────────────────────────────────────
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kalaa/node",
3
- "version": "1.0.8",
3
+ "version": "1.0.9",
4
4
  "description": "Drop-in AI cost tracking for Node.js and TypeScript. Auto-instruments OpenAI, Anthropic, and Gemini at the class level, with zero code at each call site.",
5
5
  "main": "costmeter.js",
6
6
  "types": "costmeter.d.ts",