nucleus-core-ts 0.9.710 → 0.9.712

package/dist/src/Client/ApiCaller/system-tables.d.ts

@@ -166,6 +166,9 @@ export declare const SYSTEM_TABLES: readonly [{
         readonly type: "varchar";
         readonly length: 10;
         readonly notNull: true;
+    }, {
+        readonly name: "policy";
+        readonly type: "jsonb";
     }];
     readonly indexes: readonly [{
         readonly columns: readonly ["action"];

package/dist/src/ElysiaPlugin/routes/authorization/index.d.ts

@@ -16,6 +16,19 @@ export interface AuthorizationRoutesConfig {
      * still returns effective LIMITS but omits live usage.
      */
     readCounters?: (keys: string[]) => Promise<number[]>;
+    /**
+     * Increments usage counters for the quota `/consume` (metering) endpoint. Wired to
+     * RedisManager.incrementCounter; when absent, `/consume` returns 503. Each item carries an
+     * optional TTL (rolling daily buckets self-expire; the `total` counter is permanent).
+     */
+    incrementCounters?: (items: Array<{
+        key: string;
+        delta: number;
+        ttlSeconds?: number;
+    }>) => Promise<Array<{
+        key: string;
+        value: number;
+    }>>;
 }
 /**
  * Endpoint-discovery admin + manifest routes.

package/dist/src/Managers/Redis/index.d.ts

@@ -33,6 +33,14 @@ export declare class RedisManager {
      * gate usage; the counters themselves are maintained (INCR'd) by the spender.
      */
     readCounters(keys: string[]): Promise<number[]>;
+    /**
+     * Atomically add `delta` to a numeric counter and return the new value. Direct mode
+     * uses INCRBYFLOAT (atomic); Dapr mode falls back to read-modify-write (best-effort —
+     * fine for low-concurrency metering). An optional TTL (seconds) is (re)applied — pass it
+     * for rolling daily buckets so they self-expire; omit it for cumulative `total` counters.
+     * Used by the quota `/consume` endpoint (the spender reports usage here).
+     */
+    incrementCounter(key: string, delta: number, ttlSeconds?: number): Promise<number>;
     /**
      * Returns the underlying ioredis client when running in direct mode.
      * Returns null in Dapr mode — raw Redis commands (INFO, KEYS, …) are not

package/dist/src/Services/Authorization/Quota/index.d.ts

@@ -1,4 +1,4 @@
 export { aggregateLimit, evaluateQuota, parseQuotaPolicy } from './evaluate';
 export { type ResolvedQuota, resolveUserQuotas } from './resolve';
 export type { CounterReader, QuotaAggregate, QuotaContext, QuotaEvaluation, QuotaOp, QuotaPolicy, QuotaWindow, } from './types';
-export { bucketDatesForWindow, buildQuotaKeys } from './windows';
+export { bucketDatesForWindow, buildIncrementKeys, buildQuotaKeys } from './windows';

package/dist/src/Services/Authorization/Quota/windows.d.ts

@@ -9,3 +9,14 @@ export declare function bucketDatesForWindow(window: QuotaWindow, now: Date): st
  * then `{date}` per bucket (or none for `total`). The spender maintains these; nucleus reads them.
  */
 export declare function buildQuotaKeys(policy: QuotaPolicy, ctx: QuotaContext): string[];
+/**
+ * The counter key(s) a SPEND should increment for one policy: TODAY's bucket for a
+ * `calendar_day`/`rolling` window (a rolling window reads several past buckets but a
+ * spend only lands in today's), or the single `total` key for a `total` window. Daily
+ * buckets get a TTL so they self-expire past the widest window; the total key never
+ * expires. Used by the quota `/consume` (metering) endpoint.
+ */
+export declare function buildIncrementKeys(policy: QuotaPolicy, ctx: QuotaContext): Array<{
+    key: string;
+    ttlSeconds?: number;
+}>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nucleus-core-ts",
-	"version": "0.9.710",
+	"version": "0.9.712",
 	"description": "Production-ready, enterprise-grade TypeScript framework for building multi-tenant APIs",
 	"author": "Hidayet Can Özcan <hidayetcan@gmail.com>",
 	"license": "SEE LICENSE IN LICENSE",