@nehorai/credits 2.0.0 → 2.1.0

package/dist/index.cjs

@@ -769,11 +769,13 @@ var creditSystemConfigSchema = import_zod.z.object({
   /**
    * Operation costs in credits
    * Keys are operation type names (any non-empty string)
-   * Values are positive numbers representing credit cost
+   * Values are non-negative numbers representing credit cost. 0 marks a free
+   * operation: `withCredits` runs it without touching the ledger. Amounts that
+   * move credits stay strictly positive, so `reserveCredits` refuses a 0.
    */
   operationCosts: import_zod.z.record(
     import_zod.z.string().min(1),
-    import_zod.z.number().positive()
+    import_zod.z.number().nonnegative()
   ),
   /**
    * Display labels for operation types (English canonical labels).
@@ -3106,9 +3108,11 @@ function createGenericAdapter(config) {
           return handler(user, data, dummyReservation);
         }
         let reservation;
+        let isFree = false;
         try {
           const cost = options.customCost ?? getOperationCost2(options.operationType);
-          reservation = await reserveCreditsForOperation(
+          isFree = options.customCost === void 0 && cost === 0;
+          reservation = isFree ? { ...createDummyReservation(user.id, options.operationType), id: "free-operation" } : await reserveCreditsForOperation(
             repository,
             user.id,
             cost,
@@ -3131,7 +3135,7 @@ function createGenericAdapter(config) {
         try {
           const result = await handler(user, data, reservation);
           if (result.success) {
-            await commitReservationWithJournal(repository, user.id, reservation.id);
+            if (!isFree) await commitReservationWithJournal(repository, user.id, reservation.id);
             logUsage({
               userId: user.id,
               operationType: options.operationType,
@@ -3142,7 +3146,7 @@ function createGenericAdapter(config) {
               requestId
             });
           } else {
-            await releaseReservationWithJournal(repository, user.id, reservation.id);
+            if (!isFree) await releaseReservationWithJournal(repository, user.id, reservation.id);
             logUsage({
               userId: user.id,
               operationType: options.operationType,
@@ -3157,7 +3161,7 @@ function createGenericAdapter(config) {
           return result;
         } catch (error) {
           const message = error instanceof Error ? error.message : "An unexpected error occurred";
-          await releaseReservationWithJournal(repository, user.id, reservation.id);
+          if (!isFree) await releaseReservationWithJournal(repository, user.id, reservation.id);
           logUsage({
             userId: user.id,
             operationType: options.operationType,