@substrat-run/engine-metering 0.0.0 → 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,224 @@
+import { z } from 'zod';
+import { type EntityRef } from '@substrat-run/contracts';
+import { type ModuleRegistration, type OperationContext } from '@substrat-run/kernel';
+export declare const PERM: {
+    read: string & z.$brand<"PermissionKey">;
+    record: string & z.$brand<"PermissionKey">;
+    configure: string & z.$brand<"PermissionKey">;
+    close: string & z.$brand<"PermissionKey">;
+};
+export declare const meteringManifest: {
+    id: string & z.$brand<"ModuleId">;
+    version: string;
+    kernelContract: string;
+    permissions: {
+        key: string & z.$brand<"PermissionKey">;
+        description: string;
+    }[];
+    events: {
+        emits: {
+            type: string;
+            schemaVersion: number;
+        }[];
+        consumes: {
+            type: string;
+            schemaVersion: number;
+        }[];
+    };
+    migrations: {
+        journalDir: string;
+        compatibleFrom: string;
+    };
+    attachmentTargets: {
+        entityType: string;
+        readPermission: string & z.$brand<"PermissionKey">;
+        writePermission?: (string & z.$brand<"PermissionKey">) | undefined;
+    }[];
+    entityRelations?: {
+        entityType: string;
+        parentType: string;
+    }[] | undefined;
+    guards?: {
+        before: string;
+        predicate: string;
+        config: Record<string, unknown>;
+    }[] | undefined;
+    schedules?: {
+        operation: string;
+        cadence: {
+            everyMinutes: number;
+        };
+        input?: Record<string, unknown> | undefined;
+        permissions: (string & z.$brand<"PermissionKey">)[];
+    }[] | undefined;
+    withdraws?: string[] | undefined;
+    entitlementKey: string;
+    envSpec?: {
+        key: string;
+        label?: string | undefined;
+        description: string;
+        placeholder?: string | undefined;
+        required: boolean;
+        secret: boolean;
+        default?: string | undefined;
+        group?: string | undefined;
+    }[] | undefined;
+    ownerGrants?: (string & z.$brand<"PermissionKey">)[] | undefined;
+    entitlements?: string[] | undefined;
+    provides?: string[] | undefined;
+    requires?: string[] | undefined;
+    api?: string | undefined;
+    searchables?: {
+        entityType: string;
+        fields: string[];
+    }[] | undefined;
+    ui?: {
+        routes?: {
+            path: string;
+            screen: string;
+            permission: string & z.$brand<"PermissionKey">;
+        }[] | undefined;
+        nav?: {
+            label: string;
+            icon?: string | undefined;
+            to: string;
+            permission: string & z.$brand<"PermissionKey">;
+        }[] | undefined;
+        entityViews?: {
+            entityType: string;
+            view: string;
+        }[] | undefined;
+        widgets?: {
+            slot: string;
+            component: string;
+            permission: string & z.$brand<"PermissionKey">;
+        }[] | undefined;
+        settingsPanels?: {
+            label: string;
+            component: string;
+            permission: string & z.$brand<"PermissionKey">;
+        }[] | undefined;
+    } | undefined;
+};
+export declare const meteringMigrations: {
+    version: string;
+    sql: string;
+}[];
+export type MeterKind = 'counter' | 'gauge';
+export interface Meter {
+    key: string;
+    kind: MeterKind;
+    unit: string;
+    description: string | null;
+    active: boolean;
+    createdAt: string;
+}
+export interface UsageEntry {
+    id: string;
+    meterKey: string;
+    qty: string;
+    subject: EntityRef | null;
+    occurredAt: string;
+    dedupeKey: string;
+    note: string | null;
+    createdBy: string;
+    createdAt: string;
+}
+export interface MeteringPeriod {
+    id: string;
+    from: string;
+    to: string;
+    closedBy: string;
+    closedAt: string;
+}
+/** One meter's frozen aggregate for a closed period. Unpriced, by design (D-E). */
+export interface PeriodLine {
+    meterKey: string;
+    kind: MeterKind;
+    unit: string;
+    qty: string;
+    entryCount: number;
+}
+export declare const configureMeterInput: z.ZodObject<{
+    key: z.ZodString;
+    kind: z.ZodEnum<{
+        counter: "counter";
+        gauge: "gauge";
+    }>;
+    unit: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    active: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ConfigureMeterInput = z.infer<typeof configureMeterInput>;
+/**
+ * Register or update a meter. `kind` and `unit` are FROZEN after creation:
+ * changing a meter's unit mid-period corrupts every aggregate that spans the
+ * change — a new unit is a new meter key (D-B). `description`/`active` update.
+ */
+export declare function configureMeter(ctx: OperationContext, rawInput: ConfigureMeterInput): Meter;
+export declare function listMeters(ctx: OperationContext): Meter[];
+export declare const recordUsageInput: z.ZodObject<{
+    meter: z.ZodString;
+    qty: z.ZodString;
+    subject: z.ZodOptional<z.ZodObject<{
+        entityType: z.ZodString;
+        entityId: z.ZodString;
+    }, z.core.$strip>>;
+    occurredAt: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    dedupeKey: z.ZodString;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RecordUsageInput = z.infer<typeof recordUsageInput>;
+/**
+ * The idempotent ingest (D-C): a replay with the same (meter, dedupeKey) and
+ * the same qty returns the existing entry — no second row, no second event, no
+ * double bill. The same key with a DIFFERENT qty throws: that is an upstream
+ * bug, and swallowing it would hide exactly the defect the key exists to catch.
+ */
+export declare function recordUsage(ctx: OperationContext, rawInput: RecordUsageInput): {
+    entry: UsageEntry;
+    deduped: boolean;
+};
+/**
+ * A window aggregate over half-open [from, to) — the same code path a close
+ * would freeze, so a preview and the eventual line can never disagree. Null
+ * means the meter has nothing to say for the window (see aggregateMeter).
+ */
+export declare function usageTotal(ctx: OperationContext, input: {
+    meter: string;
+    from: string;
+    to: string;
+}): {
+    qty: string;
+    entryCount: number;
+} | null;
+export declare function listEntries(ctx: OperationContext, input?: {
+    meter?: string;
+    subject?: EntityRef;
+    from?: string;
+    to?: string;
+}): UsageEntry[];
+export declare const closePeriodInput: z.ZodObject<{
+    from: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    to: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export type ClosePeriodInput = z.infer<typeof closePeriodInput>;
+/**
+ * Freeze [from, to): aggregate EVERY meter (inactive ones too — usage recorded
+ * while a meter lived still bills after deactivation), write immutable period +
+ * line rows, advance the close horizon, and emit ONE fat event carrying the
+ * unpriced lines — the vertical prices them and feeds invoicing (D-E), the
+ * same wiring as timesheet.period-closed. Closes are monotonic and
+ * non-overlapping; gaps are allowed (metering may start mid-life), rewinds are
+ * not (D-D).
+ */
+export declare function closePeriod(ctx: OperationContext, rawInput: ClosePeriodInput): {
+    period: MeteringPeriod;
+    lines: PeriodLine[];
+};
+export declare function listPeriods(ctx: OperationContext): MeteringPeriod[];
+export declare function periodLines(ctx: OperationContext, input: {
+    periodId: string;
+}): PeriodLine[];
+export declare const meteringModule: ModuleRegistration;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,456 @@
+import { z } from 'zod';
+import { addDecimal, compareDecimal, entityRef, moduleManifest, permissionKey, } from '@substrat-run/contracts';
+import { assertAllowed, ulid, } from '@substrat-run/kernel';
+// ============================================================================
+// The metering engine (docs/design/engine-metering.md, #646). Owns an
+// APPEND-ONLY usage ledger over configured meters, idempotent ingest keyed by
+// (meter, dedupe key), window aggregation (counters sum; gauges sample and
+// carry forward), and an append-only period-close journal whose latest close is
+// a hard horizon no new entry may land behind — a closed period's lines stay
+// reproducible from its entries forever.
+//
+// It owns QUANTITIES, never prices: no currency, no rates, no plans (D-E) —
+// pricing is vertical vocabulary, and the vertical feeds invoicing from the fat
+// `metering.period-closed` event exactly like the timesheet hand-off. It is the
+// BILLABLE plane; platform metering stays Analytics Engine (D-A).
+// ============================================================================
+export const PERM = {
+    read: permissionKey.parse('metering:read'),
+    record: permissionKey.parse('metering:record'),
+    configure: permissionKey.parse('metering:configure'),
+    close: permissionKey.parse('metering:close'),
+};
+export const meteringManifest = moduleManifest.parse({
+    id: '@substrat-run/engine-metering',
+    version: '0.0.1',
+    kernelContract: '^0.0.1',
+    permissions: [
+        { key: 'metering:read', description: 'Read meters, usage entries, totals and closed periods' },
+        { key: 'metering:record', description: 'Record usage entries against a meter' },
+        { key: 'metering:configure', description: 'Configure meters (register keys; kind/unit are frozen after creation)' },
+        { key: 'metering:close', description: 'Close a billing period, freezing its aggregates' },
+    ],
+    events: {
+        emits: [
+            { type: 'metering.meter-configured', schemaVersion: 1 },
+            { type: 'metering.usage-recorded', schemaVersion: 1 },
+            { type: 'metering.period-closed', schemaVersion: 1 },
+        ],
+        consumes: [],
+    },
+    migrations: { journalDir: './migrations', compatibleFrom: '0.0.1' },
+    attachmentTargets: [],
+    entityRelations: [],
+    entitlementKey: 'metering',
+    // No schedules: WHEN to close a period is billing policy — vertical
+    // vocabulary. The vertical calls closePeriod from its own schedule.
+    schedules: [],
+});
+export const meteringMigrations = [
+    {
+        version: '0001-init',
+        sql: `
+      CREATE TABLE metering_meters (
+        key         TEXT PRIMARY KEY,
+        kind        TEXT NOT NULL CHECK (kind IN ('counter','gauge')),
+        unit        TEXT NOT NULL,
+        description TEXT,
+        active      INTEGER NOT NULL DEFAULT 1,
+        created_at  TEXT NOT NULL
+      );
+      CREATE TABLE metering_entries (
+        id           TEXT PRIMARY KEY,
+        meter_key    TEXT NOT NULL,
+        qty          TEXT NOT NULL,
+        subject_type TEXT,
+        subject_id   TEXT,
+        occurred_at  TEXT NOT NULL,
+        dedupe_key   TEXT NOT NULL,
+        note         TEXT,
+        created_by   TEXT NOT NULL,
+        created_at   TEXT NOT NULL,
+        UNIQUE (meter_key, dedupe_key)
+      );
+      CREATE INDEX metering_entries_by_meter_time
+        ON metering_entries (meter_key, occurred_at);
+      CREATE TABLE metering_periods (
+        id        TEXT PRIMARY KEY,
+        from_at   TEXT NOT NULL,
+        to_at     TEXT NOT NULL,
+        closed_by TEXT NOT NULL,
+        closed_at TEXT NOT NULL
+      );
+      CREATE TABLE metering_period_lines (
+        id          TEXT PRIMARY KEY,
+        period_id   TEXT NOT NULL,
+        meter_key   TEXT NOT NULL,
+        kind        TEXT NOT NULL,
+        unit        TEXT NOT NULL,
+        qty         TEXT NOT NULL,
+        entry_count INTEGER NOT NULL
+      );
+    `,
+    },
+];
+// ---------------------------------------------------------------------------
+// Schemas & shapes
+// ---------------------------------------------------------------------------
+/**
+ * Instants are UTC ISO-8601, normalized to millisecond precision so
+ * lexicographic order IS chronological order — mixed precision would break
+ * every string comparison below ('…T00:00:00Z' sorts AFTER '…T00:00:00.000Z').
+ */
+const isoInstant = z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,3})?Z$/, 'must be a UTC ISO-8601 instant (…Z)')
+    .transform((s) => new Date(s).toISOString());
+const nonNegDecimal = z.string().regex(/^\d+(\.\d{1,6})?$/, 'must be a non-negative decimal');
+const signedDecimal = z.string().regex(/^-?\d+(\.\d{1,6})?$/, 'must be a decimal');
+const toMeter = (r) => ({
+    key: r.key,
+    kind: r.kind,
+    unit: r.unit,
+    description: r.description,
+    active: r.active === 1,
+    createdAt: r.created_at,
+});
+const toEntry = (r) => ({
+    id: r.id,
+    meterKey: r.meter_key,
+    qty: r.qty,
+    subject: r.subject_type !== null && r.subject_id !== null
+        ? { entityType: r.subject_type, entityId: r.subject_id }
+        : null,
+    occurredAt: r.occurred_at,
+    dedupeKey: r.dedupe_key,
+    note: r.note,
+    createdBy: r.created_by,
+    createdAt: r.created_at,
+});
+const toPeriod = (r) => ({
+    id: r.id,
+    from: r.from_at,
+    to: r.to_at,
+    closedBy: r.closed_by,
+    closedAt: r.closed_at,
+});
+const toLine = (r) => ({
+    meterKey: r.meter_key,
+    kind: r.kind,
+    unit: r.unit,
+    qty: r.qty,
+    entryCount: r.entry_count,
+});
+function getMeterRow(ctx, key) {
+    const row = ctx.sql.query('SELECT * FROM metering_meters WHERE key = ?', [key])[0];
+    if (!row)
+        throw new Error(`meter not found: ${key}`);
+    return row;
+}
+/** The latest closed `to` — nothing may be recorded behind it (D-D). */
+function closeHorizon(ctx) {
+    return (ctx.sql.query('SELECT MAX(to_at) AS horizon FROM metering_periods')[0]?.horizon ?? null);
+}
+/**
+ * One meter's aggregate over half-open [from, to) — the SINGLE code path shared
+ * by `usageTotal` and `closePeriod`, so a preview can never disagree with the
+ * frozen line. Returns null when the meter has nothing to say for the window:
+ * a counter with no entries (a zero sum bills nothing), or a gauge never
+ * sampled at all. A gauge with no in-window samples carries the latest earlier
+ * sample forward with entryCount 0 — a level persists between observations.
+ */
+function aggregateMeter(ctx, meter, from, to) {
+    const rows = ctx.sql.query(`SELECT qty FROM metering_entries
+      WHERE meter_key = ? AND occurred_at >= ? AND occurred_at < ?
+      ORDER BY occurred_at, id`, [meter.key, from, to]);
+    if (meter.kind === 'counter') {
+        if (rows.length === 0)
+            return null;
+        return { qty: rows.reduce((sum, r) => addDecimal(sum, r.qty), '0'), entryCount: rows.length };
+    }
+    if (rows.length > 0) {
+        const max = rows.reduce((m, r) => (compareDecimal(r.qty, m) > 0 ? r.qty : m), rows[0].qty);
+        return { qty: max, entryCount: rows.length };
+    }
+    const carried = ctx.sql.query(`SELECT qty FROM metering_entries
+      WHERE meter_key = ? AND occurred_at < ?
+      ORDER BY occurred_at DESC, id DESC LIMIT 1`, [meter.key, from])[0];
+    return carried ? { qty: carried.qty, entryCount: 0 } : null;
+}
+// ---------------------------------------------------------------------------
+// In-scope functions (K-16) — composable from vertical operations, same
+// transaction. The registered operations below are their default bindings.
+// The CALLER is responsible for the permission check.
+// ---------------------------------------------------------------------------
+export const configureMeterInput = z.object({
+    key: z.string().min(1),
+    kind: z.enum(['counter', 'gauge']),
+    unit: z.string().min(1),
+    description: z.string().optional(),
+    active: z.boolean().optional(),
+});
+/**
+ * Register or update a meter. `kind` and `unit` are FROZEN after creation:
+ * changing a meter's unit mid-period corrupts every aggregate that spans the
+ * change — a new unit is a new meter key (D-B). `description`/`active` update.
+ */
+export function configureMeter(ctx, rawInput) {
+    const input = configureMeterInput.parse(rawInput);
+    const existing = ctx.sql.query('SELECT * FROM metering_meters WHERE key = ?', [
+        input.key,
+    ])[0];
+    if (existing) {
+        if (existing.kind !== input.kind || existing.unit !== input.unit) {
+            throw new Error(`meter '${input.key}' is ${existing.kind}/${existing.unit} — kind and unit are frozen after creation; a new unit is a new meter key`);
+        }
+        ctx.sql.exec(`UPDATE metering_meters SET description = COALESCE(?, description), active = COALESCE(?, active) WHERE key = ?`, [
+            input.description ?? null,
+            input.active === undefined ? null : input.active ? 1 : 0,
+            input.key,
+        ]);
+    }
+    else {
+        ctx.sql.exec(`INSERT INTO metering_meters (key, kind, unit, description, active, created_at)
+       VALUES (?, ?, ?, ?, ?, ?)`, [
+            input.key,
+            input.kind,
+            input.unit,
+            input.description ?? null,
+            input.active === false ? 0 : 1,
+            new Date().toISOString(),
+        ]);
+    }
+    const row = getMeterRow(ctx, input.key);
+    ctx.emit({
+        type: 'metering.meter-configured',
+        schemaVersion: 1,
+        entity: { entityType: 'metering-meter', entityId: row.key },
+        piiClass: 'none',
+        payload: { key: row.key, kind: row.kind, unit: row.unit, active: row.active === 1 },
+    });
+    return toMeter(row);
+}
+export function listMeters(ctx) {
+    return ctx.sql.query('SELECT * FROM metering_meters ORDER BY key').map(toMeter);
+}
+export const recordUsageInput = z.object({
+    meter: z.string().min(1),
+    /** Counters take signed deltas (a correction is a compensating entry, never
+     *  an edit); gauges take non-negative level samples — enforced per kind. */
+    qty: signedDecimal,
+    subject: entityRef.optional(),
+    /** Defaults to now. Must not fall behind the close horizon (D-D). */
+    occurredAt: isoInstant.optional(),
+    /** Caller-supplied idempotency key, unique per meter (D-C) — e.g. a turn id. */
+    dedupeKey: z.string().min(1),
+    note: z.string().optional(),
+});
+/**
+ * The idempotent ingest (D-C): a replay with the same (meter, dedupeKey) and
+ * the same qty returns the existing entry — no second row, no second event, no
+ * double bill. The same key with a DIFFERENT qty throws: that is an upstream
+ * bug, and swallowing it would hide exactly the defect the key exists to catch.
+ */
+export function recordUsage(ctx, rawInput) {
+    const input = recordUsageInput.parse(rawInput);
+    const meter = getMeterRow(ctx, input.meter);
+    if (meter.active !== 1)
+        throw new Error(`meter '${meter.key}' is inactive`);
+    if (meter.kind === 'gauge')
+        nonNegDecimal.parse(input.qty);
+    const existing = ctx.sql.query('SELECT * FROM metering_entries WHERE meter_key = ? AND dedupe_key = ?', [meter.key, input.dedupeKey])[0];
+    if (existing) {
+        if (compareDecimal(existing.qty, input.qty) !== 0) {
+            throw new Error(`dedupe key '${input.dedupeKey}' on meter '${meter.key}' was recorded with qty ${existing.qty}, now ${input.qty} — a dedupe key must name one observation`);
+        }
+        return { entry: toEntry(existing), deduped: true };
+    }
+    const occurredAt = input.occurredAt ?? new Date().toISOString();
+    const horizon = closeHorizon(ctx);
+    if (horizon !== null && occurredAt < horizon) {
+        throw new Error(`occurred_at ${occurredAt} is behind the close horizon ${horizon} — the period covering it is closed; record late usage at observation time`);
+    }
+    const id = ulid();
+    ctx.sql.exec(`INSERT INTO metering_entries
+       (id, meter_key, qty, subject_type, subject_id, occurred_at, dedupe_key, note, created_by, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+        id,
+        meter.key,
+        input.qty,
+        input.subject?.entityType ?? null,
+        input.subject?.entityId ?? null,
+        occurredAt,
+        input.dedupeKey,
+        input.note ?? null,
+        ctx.principal,
+        new Date().toISOString(),
+    ]);
+    const entry = toEntry(ctx.sql.query('SELECT * FROM metering_entries WHERE id = ?', [id])[0]);
+    ctx.emit({
+        type: 'metering.usage-recorded',
+        schemaVersion: 1,
+        entity: { entityType: 'metering-entry', entityId: id },
+        piiClass: 'none',
+        payload: {
+            entryId: id,
+            meterKey: meter.key,
+            kind: meter.kind,
+            unit: meter.unit,
+            qty: input.qty,
+            subject: input.subject ?? null,
+            occurredAt,
+            dedupeKey: input.dedupeKey,
+        },
+    });
+    return { entry, deduped: false };
+}
+/**
+ * A window aggregate over half-open [from, to) — the same code path a close
+ * would freeze, so a preview and the eventual line can never disagree. Null
+ * means the meter has nothing to say for the window (see aggregateMeter).
+ */
+export function usageTotal(ctx, input) {
+    const from = isoInstant.parse(input.from);
+    const to = isoInstant.parse(input.to);
+    if (to <= from)
+        throw new Error(`to ${to} must be after from ${from}`);
+    return aggregateMeter(ctx, getMeterRow(ctx, input.meter), from, to);
+}
+export function listEntries(ctx, input) {
+    const where = [];
+    const params = [];
+    if (input?.meter) {
+        where.push('meter_key = ?');
+        params.push(input.meter);
+    }
+    if (input?.subject) {
+        where.push('subject_type = ? AND subject_id = ?');
+        params.push(input.subject.entityType, input.subject.entityId);
+    }
+    if (input?.from) {
+        where.push('occurred_at >= ?');
+        params.push(isoInstant.parse(input.from));
+    }
+    if (input?.to) {
+        where.push('occurred_at < ?');
+        params.push(isoInstant.parse(input.to));
+    }
+    const sql = `SELECT * FROM metering_entries${where.length ? ` WHERE ${where.join(' AND ')}` : ''} ORDER BY occurred_at, id`;
+    return ctx.sql.query(sql, params).map(toEntry);
+}
+export const closePeriodInput = z.object({
+    from: isoInstant,
+    to: isoInstant,
+});
+/**
+ * Freeze [from, to): aggregate EVERY meter (inactive ones too — usage recorded
+ * while a meter lived still bills after deactivation), write immutable period +
+ * line rows, advance the close horizon, and emit ONE fat event carrying the
+ * unpriced lines — the vertical prices them and feeds invoicing (D-E), the
+ * same wiring as timesheet.period-closed. Closes are monotonic and
+ * non-overlapping; gaps are allowed (metering may start mid-life), rewinds are
+ * not (D-D).
+ */
+export function closePeriod(ctx, rawInput) {
+    const input = closePeriodInput.parse(rawInput);
+    if (input.to <= input.from)
+        throw new Error(`to ${input.to} must be after from ${input.from}`);
+    const horizon = closeHorizon(ctx);
+    if (horizon !== null && input.from < horizon) {
+        throw new Error(`period from ${input.from} overlaps the close horizon ${horizon} — closes are monotonic and non-overlapping`);
+    }
+    const id = ulid();
+    const now = new Date().toISOString();
+    ctx.sql.exec(`INSERT INTO metering_periods (id, from_at, to_at, closed_by, closed_at) VALUES (?, ?, ?, ?, ?)`, [id, input.from, input.to, ctx.principal, now]);
+    const lines = [];
+    for (const meter of ctx.sql.query('SELECT * FROM metering_meters ORDER BY key')) {
+        const agg = aggregateMeter(ctx, meter, input.from, input.to);
+        if (!agg)
+            continue;
+        ctx.sql.exec(`INSERT INTO metering_period_lines (id, period_id, meter_key, kind, unit, qty, entry_count)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`, [ulid(), id, meter.key, meter.kind, meter.unit, agg.qty, agg.entryCount]);
+        lines.push({
+            meterKey: meter.key,
+            kind: meter.kind,
+            unit: meter.unit,
+            qty: agg.qty,
+            entryCount: agg.entryCount,
+        });
+    }
+    ctx.emit({
+        type: 'metering.period-closed',
+        schemaVersion: 1,
+        entity: { entityType: 'metering-period', entityId: id },
+        piiClass: 'none',
+        payload: { periodId: id, from: input.from, to: input.to, lines },
+    });
+    return {
+        period: { id, from: input.from, to: input.to, closedBy: String(ctx.principal), closedAt: now },
+        lines,
+    };
+}
+export function listPeriods(ctx) {
+    return ctx.sql
+        .query('SELECT * FROM metering_periods ORDER BY from_at, id')
+        .map(toPeriod);
+}
+export function periodLines(ctx, input) {
+    const period = ctx.sql.query('SELECT * FROM metering_periods WHERE id = ?', [
+        input.periodId,
+    ])[0];
+    if (!period)
+        throw new Error(`metering period not found: ${input.periodId}`);
+    return ctx.sql
+        .query('SELECT * FROM metering_period_lines WHERE period_id = ? ORDER BY meter_key', [input.periodId])
+        .map(toLine);
+}
+// ---------------------------------------------------------------------------
+// Default operation bindings — each starts with the permission check.
+// ---------------------------------------------------------------------------
+const configureMeterOp = async (ctx, input) => {
+    assertAllowed(await ctx.check(PERM.configure));
+    return configureMeter(ctx, input);
+};
+const listMetersOp = async (ctx) => {
+    assertAllowed(await ctx.check(PERM.read));
+    return listMeters(ctx);
+};
+const recordOp = async (ctx, input) => {
+    assertAllowed(await ctx.check(PERM.record));
+    return recordUsage(ctx, input);
+};
+const totalOp = async (ctx, input) => {
+    assertAllowed(await ctx.check(PERM.read));
+    return usageTotal(ctx, input);
+};
+const listEntriesOp = async (ctx, input) => {
+    assertAllowed(await ctx.check(PERM.read));
+    return listEntries(ctx, input);
+};
+const closePeriodOp = async (ctx, input) => {
+    assertAllowed(await ctx.check(PERM.close));
+    return closePeriod(ctx, input);
+};
+const listPeriodsOp = async (ctx) => {
+    assertAllowed(await ctx.check(PERM.read));
+    return listPeriods(ctx);
+};
+const periodLinesOp = async (ctx, input) => {
+    assertAllowed(await ctx.check(PERM.read));
+    return periodLines(ctx, input);
+};
+export const meteringModule = {
+    manifest: meteringManifest,
+    migrations: meteringMigrations,
+    operations: {
+        'metering/configure-meter': configureMeterOp,
+        'metering/list-meters': listMetersOp,
+        'metering/record': recordOp,
+        'metering/total': totalOp,
+        'metering/list-entries': listEntriesOp,
+        'metering/close-period': closePeriodOp,
+        'metering/list-periods': listPeriodsOp,
+        'metering/period-lines': periodLinesOp,
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@substrat-run/engine-metering",
-  "version": "0.0.0",
+  "version": "0.1.1",
   "description": "Substrat engine: billable usage — an append-only, idempotent meter ledger (counters and gauges) whose closed periods are frozen billing evidence",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -24,19 +24,19 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit",
-    "test": "vitest run"
-  },
   "dependencies": {
-    "@substrat-run/contracts": "workspace:^",
-    "@substrat-run/kernel": "workspace:^",
-    "zod": "^4.4.3"
+    "zod": "^4.4.3",
+    "@substrat-run/kernel": "^0.66.0",
+    "@substrat-run/contracts": "^0.66.0"
   },
   "devDependencies": {
     "typescript": "^7.0.0",
-    "@substrat-run/engine-test-kit": "workspace:^",
-    "vitest": "^3.0.0"
+    "vitest": "^3.0.0",
+    "@substrat-run/engine-test-kit": "^0.0.64"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit",
+    "test": "vitest run"
   }
-}
+}