settlekit/packages/usage/test/meter.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

106 lines
3.7 KiB
TypeScript

import { describe, expect, it } from "vitest";
import {
aggregateForPeriod,
createMeter,
recordUsage,
resetForNewPeriod,
} from "../src/index.js";
const base = {
organizationId: "org_1",
customerId: "cus_1",
productId: "prod_1",
metric: "api_calls",
} as const;
describe("createMeter", () => {
it("opens an empty meter with a derived monthly period window", () => {
const start = new Date("2026-01-01T00:00:00.000Z");
const meter = createMeter({ ...base, periodStart: start, period: "monthly" });
expect(meter.value).toBe(0);
expect(meter.metric).toBe("api_calls");
expect(meter.periodStart).toBe("2026-01-01T00:00:00.000Z");
expect(meter.periodEnd).toBe("2026-02-01T00:00:00.000Z");
expect(meter.id.startsWith("um_") || meter.id.length > 0).toBe(true);
});
it("rejects empty identity fields", () => {
const start = new Date("2026-01-01T00:00:00.000Z");
expect(() => createMeter({ ...base, metric: " ", periodStart: start, period: "monthly" })).toThrow();
});
});
describe("recordUsage", () => {
const start = new Date("2026-01-01T00:00:00.000Z");
it("accumulates quantity into a new meter without mutating the original", () => {
const meter = createMeter({ ...base, periodStart: start, period: "monthly" });
const after1 = recordUsage(meter, "api_calls", 5);
const after2 = recordUsage(after1, "api_calls", 3);
expect(meter.value).toBe(0);
expect(after1.value).toBe(5);
expect(after2.value).toBe(8);
expect(after2).not.toBe(after1);
});
it("supports fractional quantities", () => {
const meter = createMeter({ ...base, periodStart: start, period: "monthly" });
const after = recordUsage(meter, "api_calls", 2.5);
expect(after.value).toBe(2.5);
});
it("throws on a metric mismatch", () => {
const meter = createMeter({ ...base, periodStart: start, period: "monthly" });
expect(() => recordUsage(meter, "bandwidth", 1)).toThrow();
});
it("throws on a negative or non-finite quantity", () => {
const meter = createMeter({ ...base, periodStart: start, period: "monthly" });
expect(() => recordUsage(meter, "api_calls", -1)).toThrow();
expect(() => recordUsage(meter, "api_calls", Number.NaN)).toThrow();
});
});
describe("aggregateForPeriod", () => {
it("sums only meters matching metric and period window", () => {
const start = new Date("2026-01-01T00:00:00.000Z");
const m1 = recordUsage(createMeter({ ...base, periodStart: start, period: "monthly" }), "api_calls", 4);
const m2 = recordUsage(createMeter({ ...base, periodStart: start, period: "monthly" }), "api_calls", 6);
const otherMetric = recordUsage(
createMeter({ ...base, metric: "bandwidth", periodStart: start, period: "monthly" }),
"bandwidth",
100,
);
const otherPeriod = recordUsage(
createMeter({ ...base, periodStart: new Date("2026-02-01T00:00:00.000Z"), period: "monthly" }),
"api_calls",
999,
);
const total = aggregateForPeriod(
[m1, m2, otherMetric, otherPeriod],
"api_calls",
"2026-01-01T00:00:00.000Z",
"2026-02-01T00:00:00.000Z",
);
expect(total).toBe(10);
});
});
describe("resetForNewPeriod", () => {
it("returns a fresh zeroed meter advanced to a new period", () => {
const start = new Date("2026-01-01T00:00:00.000Z");
const used = recordUsage(createMeter({ ...base, periodStart: start, period: "monthly" }), "api_calls", 42);
const next = resetForNewPeriod(used, new Date("2026-02-01T00:00:00.000Z"), "monthly");
expect(next.value).toBe(0);
expect(next.periodStart).toBe("2026-02-01T00:00:00.000Z");
expect(next.periodEnd).toBe("2026-03-01T00:00:00.000Z");
expect(next.id).not.toBe(used.id);
expect(next.metric).toBe(used.metric);
});
});