@usagekit/store 0.1.0 → 0.3.0

package/dist/memory/state.d.ts

@@ -1,7 +1,7 @@
 import type { DispatchGrant } from "@usagekit/core";
 import type { UsageRow } from "@usagekit/core";
 import type { SettleResult, ReleaseResult } from "@usagekit/core";
-import type { AllowanceExceeded } from "@usagekit/core";
+import type { AllowanceExceeded, BudgetAlertCrossed } from "@usagekit/core";
 import type { Budget, Operation, ReserveInput, OperationRef, Quantity } from "@usagekit/core";
 import type { Clock } from "../clock.js";
 export declare class InvalidInput extends Error {
@@ -12,7 +12,10 @@ export declare class InvalidInput extends Error {
 export declare const copy: <T>(value: T) => T;
 export declare function canonical(value: unknown): string;
 export declare const key: (namespace: string, id: string) => string;
+/** Reserve identity: diagnostic ids and attribution tags are not semantic. */
 export declare function semantics(i: ReserveInput): string;
+/** Sorted tags on the stored input, or an InvalidInput when the list breaks the tag rules. */
+export declare function withNormalizedTags(i: ReserveInput): ReserveInput;
 export declare const maxMoneyUnits: bigint;
 export declare function validateQuantity(q: Quantity): void;
 export type State = {
@@ -28,6 +31,14 @@ export type State = {
         watermark: string;
         offset: number;
     }>;
+    /** Operation listing snapshots: membership and order fixed by the first page. */
+    operationCursors?: Map<string, {
+        query: string;
+        keys: string[];
+        asOf: string;
+        watermark: string;
+        offset: number;
+    }>;
     clock: Clock;
     budgets: Budget[];
     operations: Map<string, Operation>;
@@ -38,5 +49,9 @@ export type State = {
     }>;
     leaseKinds: Map<string, "lease" | "recovery">;
     warnings: Map<string, readonly AllowanceExceeded[]>;
+    /** Crossings each reserve reported, replayed verbatim. */
+    reserveAlerts: Map<string, readonly BudgetAlertCrossed[]>;
+    /** Recorded crossings keyed by namespace, budget id, epoch and threshold. */
+    alerts: Set<string>;
 };
 export declare function find(s: State, ref: OperationRef): Operation | null;

package/dist/memory/state.js

@@ -1,3 +1,4 @@
+import { normalizeTags } from "@usagekit/core";
 export class InvalidInput extends Error {
     field;
     reason;
@@ -22,14 +23,26 @@ export function canonical(value) {
     return JSON.stringify(value) ?? "null";
 }
 export const key = (namespace, id) => canonical([namespace, id]);
+/** Reserve identity: diagnostic ids and attribution tags are not semantic. */
 export function semantics(i) {
-    const { correlationId: _, parentOperationId: __, ...rest } = i;
+    const { correlationId: _, parentOperationId: __, scope, ...rest } = i;
+    const { tags: ___, ...scopeIdentity } = scope;
     return canonical({
         ...rest,
+        scope: scopeIdentity,
         estimate: [...i.estimate].sort((a, b) => a.unit.localeCompare(b.unit)),
         platformPools: [...(i.platformPools ?? [])].sort(),
     });
 }
+/** Sorted tags on the stored input, or an InvalidInput when the list breaks the tag rules. */
+export function withNormalizedTags(i) {
+    if (i.scope.tags === undefined)
+        return i;
+    const tags = normalizeTags(i.scope.tags);
+    if (!tags)
+        throw new InvalidInput("scope.tags", "1 to 16 unique tags matching the tag pattern");
+    return { ...i, scope: { ...i.scope, tags } };
+}
 export const maxMoneyUnits = 2n ** 63n - 1n;
 export function validateQuantity(q) {
     if (typeof q.value !== "bigint" ||

package/dist/reference.d.ts

@@ -1,6 +1,6 @@
 /** Synchronous reference rules shared by adapters inside their own atomic transactions. */
 export { reserve, intent, renew, claim, settle, release, expireReservations, } from "./memory/commands.js";
-export { aggregate, definedBudgets, applicableBudgets } from "./memory/reads.js";
+export { aggregate, definedBudgets, applicableBudgets, listOperations } from "./memory/reads.js";
 export { copy, find, key, canonical, InvalidInput } from "./memory/state.js";
 export type { State } from "./memory/state.js";
-export { plus, effective, currentBudgets } from "./memory/admission.js";
+export { plus, effective, currentBudgets, validateBudget, crossing, reachedAlerts, alertKey, alertThreshold, } from "./memory/admission.js";

package/dist/reference.js

@@ -1,5 +1,5 @@
 /** Synchronous reference rules shared by adapters inside their own atomic transactions. */
 export { reserve, intent, renew, claim, settle, release, expireReservations, } from "./memory/commands.js";
-export { aggregate, definedBudgets, applicableBudgets } from "./memory/reads.js";
+export { aggregate, definedBudgets, applicableBudgets, listOperations } from "./memory/reads.js";
 export { copy, find, key, canonical, InvalidInput } from "./memory/state.js";
-export { plus, effective, currentBudgets } from "./memory/admission.js";
+export { plus, effective, currentBudgets, validateBudget, crossing, reachedAlerts, alertKey, alertThreshold, } from "./memory/admission.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usagekit/store",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "module",
   "license": "Apache-2.0",
   "description": "Atomic store commands, reference store and conformance tests.",
@@ -31,7 +31,7 @@
     "prepack": "node ../../scripts/package-license.mjs"
   },
   "dependencies": {
-    "@usagekit/core": "0.1.0"
+    "@usagekit/core": "0.3.0"
   },
   "sideEffects": false,
   "publishConfig": {