@nehorai/credits 1.6.0 → 1.7.0

package/dist/index.d.cts

@@ -3,7 +3,7 @@ export { A as AIProviderType, B as BuiltinTier, g as CreditCheckResult, a as Cre
 export { CreditError, CreditErrorCode, CreditErrorCodeType, commitReservationWithJournal, createInsufficientCreditsError, createInvalidOperationTypeError, createReservationAlreadyProcessedError, createReservationExpiredError, createReservationNotFoundError, createUserNotFoundError, isCreditError, isInsufficientCreditsError, releaseReservationWithJournal, reserveCreditsForOperation } from './core/index.cjs';
 export { D as DeferredExecutor, c as createDeferredExecutor, g as genericDeferred, n as noopDeferred, s as synchronousDeferred } from './deferred-C7rrRfkm.cjs';
 import { z } from 'zod';
-export { C as CreateJournalEntryInput, a as CreateReservationInput, b as CreateTransactionInput, c as CreateUsageLogInput, d as CreditBalanceUpdate, e as CreditRepositoryFactory, I as ICreditRepository, J as JournalEntryQuery, T as TierUpdateInput, U as UsageLogQuery, t as toClientUserCredits } from './types-CZNv1U3e.cjs';
+export { A as AddCreditsAtomicOptions, C as CreateJournalEntryInput, a as CreateReservationInput, b as CreateTransactionInput, c as CreateUsageLogInput, d as CreditBalanceUpdate, e as CreditRepositoryFactory, I as ICreditRepository, J as JournalEntryQuery, T as TierUpdateInput, U as UsageLogQuery, t as toClientUserCredits } from './types-DFe5BoJY.cjs';
 export { InMemoryCreditRepository, createInMemoryCreditRepository, generateId, getNextMonthlyReset } from './repository/index.cjs';
 export { C as CreditsAuthProviderFactory, a as CreditsUser, I as ICreditsAuthProvider } from './types-OZU3I5OM.cjs';
 export { ApiKeyCreditsProvider, createApiKeyProvider, verifyAdminApiKey, verifyBearerToken } from './auth/index.cjs';

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { A as AIProviderType, B as BuiltinTier, g as CreditCheckResult, a as Cre
 export { CreditError, CreditErrorCode, CreditErrorCodeType, commitReservationWithJournal, createInsufficientCreditsError, createInvalidOperationTypeError, createReservationAlreadyProcessedError, createReservationExpiredError, createReservationNotFoundError, createUserNotFoundError, isCreditError, isInsufficientCreditsError, releaseReservationWithJournal, reserveCreditsForOperation } from './core/index.js';
 export { D as DeferredExecutor, c as createDeferredExecutor, g as genericDeferred, n as noopDeferred, s as synchronousDeferred } from './deferred-C7rrRfkm.js';
 import { z } from 'zod';
-export { C as CreateJournalEntryInput, a as CreateReservationInput, b as CreateTransactionInput, c as CreateUsageLogInput, d as CreditBalanceUpdate, e as CreditRepositoryFactory, I as ICreditRepository, J as JournalEntryQuery, T as TierUpdateInput, U as UsageLogQuery, t as toClientUserCredits } from './types-G4WK0rM-.js';
+export { A as AddCreditsAtomicOptions, C as CreateJournalEntryInput, a as CreateReservationInput, b as CreateTransactionInput, c as CreateUsageLogInput, d as CreditBalanceUpdate, e as CreditRepositoryFactory, I as ICreditRepository, J as JournalEntryQuery, T as TierUpdateInput, U as UsageLogQuery, t as toClientUserCredits } from './types-_bSybQnb.js';
 export { InMemoryCreditRepository, createInMemoryCreditRepository, generateId, getNextMonthlyReset } from './repository/index.js';
 export { C as CreditsAuthProviderFactory, a as CreditsUser, I as ICreditsAuthProvider } from './types-OZU3I5OM.js';
 export { ApiKeyCreditsProvider, createApiKeyProvider, verifyAdminApiKey, verifyBearerToken } from './auth/index.js';

package/dist/index.js

@@ -798,23 +798,39 @@ var InMemoryCreditRepository = class {
     this.users.set(userId, credits);
     await this.updateReservationStatus(userId, reservationId, "released", /* @__PURE__ */ new Date());
   }
-  async addCreditsAtomic(userId, amount, description, paymentRef) {
+  async addCreditsAtomic(userId, amount, description, paymentRef, options) {
     const credits = this.users.get(userId);
     if (!credits) {
       throw new Error(`User ${userId} not found`);
     }
-    const previousBalance = credits.bonusCredits;
+    const previousTotal = credits.balance + credits.bonusCredits;
     credits.bonusCredits += amount;
     credits.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     this.users.set(userId, credits);
-    await this.createTransaction({
+    const newTotal = credits.balance + credits.bonusCredits;
+    const transaction = await this.createTransaction({
       userId,
       type: "purchase",
       amount,
       description,
       paymentRef,
-      previousBalance,
-      newBalance: credits.bonusCredits
+      previousBalance: previousTotal,
+      newBalance: newTotal
+    });
+    const journalMetadata = {
+      ...paymentRef ? { paymentRef } : {},
+      ...options?.metadata ?? {}
+    };
+    await this.createJournalEntry({
+      userId,
+      entryType: "credit",
+      amount,
+      balanceAfter: newTotal,
+      source: options?.source ?? "purchase",
+      referenceId: transaction.id ?? paymentRef ?? "unknown",
+      referenceType: options?.referenceType ?? "transaction",
+      description,
+      metadata: Object.keys(journalMetadata).length > 0 ? journalMetadata : void 0
     });
   }
   async deductCreditsAtomic(userId, amount) {
@@ -1396,9 +1412,11 @@ var CreditsService = class {
    * @param amount - Credits to add
    * @param description - Transaction description
    * @param paymentRef - Optional payment reference
+   * @param options - Optional journal source / reference type / extra metadata
+   *   for the credit journal entry (e.g. revenue-attribution fields).
    */
-  async addCredits(userId, amount, description, paymentRef) {
-    return this.repository.addCreditsAtomic(userId, amount, description, paymentRef);
+  async addCredits(userId, amount, description, paymentRef, options) {
+    return this.repository.addCreditsAtomic(userId, amount, description, paymentRef, options);
   }
   /**
    * One-shot atomic "deduct-if-sufficient" credit charge.