settlekit/packages/usage/test/service.test.ts
caelum0x 3fe0c88942 feat: implement all 77 SettleKit packages with real code
Core engine: entitlements (§14), delivery action runner (§21).
Payment rails: arc (viem USDC verify), circle (REST), x402 middleware, payments, webhooks (HMAC), notifications (Resend).
Integrations: github (Octokit App), discord (REST v10).
Commerce: saas billing, bundles, license-keys, api-keys, file-delivery (signed URLs + SigV4), usage/credits, agent-services, escrow, marketplace-core, risk.
Persistence: database (Drizzle/Postgres, 48 tables §25).
Plus supporting domain packages.

561 tests passing across 117 files; tsc -b green for every package.
2026-06-15 03:24:19 +03:00

105 lines
3.3 KiB
TypeScript

import { money, SettleKitError } from "@settlekit/common";
import { describe, expect, it } from "vitest";
import { InMemoryMeterStore, UsageService } from "../src/index.js";
const meterRef = {
organizationId: "org_1",
customerId: "cus_1",
productId: "prod_1",
metric: "api_calls",
} as const;
const balanceRef = {
organizationId: "org_1",
customerId: "cus_1",
productId: "prod_1",
} as const;
const jan = new Date("2026-01-01T00:00:00.000Z");
const feb = new Date("2026-02-01T00:00:00.000Z");
function svc() {
return new UsageService(new InMemoryMeterStore(), "monthly");
}
describe("UsageService metering", () => {
it("creates a meter on first record and accumulates across calls", async () => {
const service = svc();
await service.record(meterRef, 5, jan);
const meter = await service.record(meterRef, 7, jan);
expect(meter.value).toBe(12);
const fetched = await service.getMeter(meterRef, jan);
expect(fetched?.value).toBe(12);
});
it("computes a charge from persisted usage", async () => {
const service = svc();
await service.record(meterRef, 1000, jan);
const charge = await service.charge(meterRef, jan, money("0.001"));
expect(charge).toEqual(money("1.000000"));
});
it("throws not_found when charging a non-existent meter", async () => {
const service = svc();
await expect(service.charge(meterRef, jan, money("0.001"))).rejects.toBeInstanceOf(SettleKitError);
});
it("evaluates limits, treating a missing meter as zero usage", async () => {
const service = svc();
const empty = await service.limit(meterRef, jan, 100);
expect(empty.value).toBe(0);
expect(empty.withinLimit).toBe(true);
await service.record(meterRef, 150, jan);
const over = await service.limit(meterRef, jan, 100);
expect(over.exceeded).toBe(true);
});
it("rolls a period into a fresh zeroed meter", async () => {
const service = svc();
await service.record(meterRef, 50, jan);
const next = await service.rollPeriod(meterRef, feb);
expect(next.value).toBe(0);
expect(next.periodStart).toBe("2026-02-01T00:00:00.000Z");
const janMeter = await service.getMeter(meterRef, jan);
expect(janMeter?.value).toBe(50);
});
});
describe("UsageService credits", () => {
it("grants on first use and accumulates", async () => {
const service = svc();
await service.grant(balanceRef, 100);
const bal = await service.grant(balanceRef, 50);
expect(bal.creditsRemaining).toBe(150);
expect(bal.creditsGranted).toBe(150);
});
it("consumes credits and persists the new remaining", async () => {
const service = svc();
await service.grant(balanceRef, 100);
const after = await service.consume(balanceRef, 30);
expect(after.creditsRemaining).toBe(70);
const fetched = await service.getBalance(balanceRef);
expect(fetched?.creditsRemaining).toBe(70);
});
it("throws insufficient_credits when over-consuming", async () => {
const service = svc();
await service.grant(balanceRef, 10);
await expect(service.consume(balanceRef, 25)).rejects.toMatchObject({
code: "insufficient_credits",
});
});
it("throws not_found when consuming with no balance", async () => {
const service = svc();
await expect(service.consume(balanceRef, 1)).rejects.toMatchObject({ code: "not_found" });
});
});