@dappermountain/payload-plugin-achievements 0.2.6 → 0.2.8

package/dist/services/achievement/metricBalances.js

@@ -0,0 +1,137 @@
+import { collectionOf } from '../../collections/helpers.js';
+import { relationId } from './relationId.js';
+import { userScopeWhere } from './where.js';
+export function metricBalanceKey(userId, scopeId, metricId) {
+    return `${userId}:${scopeId ?? ''}:${metricId}`;
+}
+export async function findMetricBalance(args) {
+    const key = metricBalanceKey(args.userId, args.scopeId, args.metricId);
+    const found = await args.payload.find({
+        collection: collectionOf('metricBalances'),
+        depth: 0,
+        limit: 1,
+        overrideAccess: true,
+        req: args.req,
+        where: { key: { equals: key } },
+    });
+    const doc = found.docs[0];
+    const id = relationId(doc);
+    if (!id)
+        return null;
+    const value = typeof doc?.value === 'number' && Number.isFinite(doc.value) ? doc.value : 0;
+    return { id, value };
+}
+export async function applyMetricBalanceDelta(args) {
+    const existing = await findMetricBalance(args);
+    const nextValue = (existing?.value ?? 0) + args.change;
+    const key = metricBalanceKey(args.userId, args.scopeId, args.metricId);
+    if (existing) {
+        const updated = await args.payload.update({
+            collection: collectionOf('metricBalances'),
+            id: existing.id,
+            data: { value: nextValue },
+            overrideAccess: true,
+            req: args.req,
+        });
+        return { id: existing.id, value: typeof updated.value === 'number' ? updated.value : nextValue };
+    }
+    const created = await args.payload.create({
+        collection: collectionOf('metricBalances'),
+        data: {
+            user: args.userId,
+            scope: args.scopeId ?? undefined,
+            metric: args.metricId,
+            value: nextValue,
+            key,
+        },
+        overrideAccess: true,
+        req: args.req,
+    });
+    return {
+        id: String(created.id),
+        value: typeof created.value === 'number' ? created.value : nextValue,
+    };
+}
+/** Sum metric.delta log changes and upsert the balance projection. */
+export async function rebuildMetricBalance(args) {
+    const scopeId = args.scopeId ?? null;
+    const logs = await args.payload.find({
+        collection: collectionOf('logs'),
+        depth: 0,
+        limit: 10_000,
+        pagination: false,
+        overrideAccess: true,
+        req: args.req,
+        where: {
+            and: [userScopeWhere(args.userId, scopeId), { metric: { equals: args.metricId } }],
+        },
+    });
+    const value = logs.docs.reduce((sum, doc) => {
+        const change = doc.change;
+        return sum + (typeof change === 'number' && Number.isFinite(change) ? change : 0);
+    }, 0);
+    const existing = await findMetricBalance({
+        payload: args.payload,
+        req: args.req,
+        userId: args.userId,
+        scopeId,
+        metricId: args.metricId,
+    });
+    const key = metricBalanceKey(args.userId, scopeId, args.metricId);
+    if (existing) {
+        await args.payload.update({
+            collection: collectionOf('metricBalances'),
+            id: existing.id,
+            data: { value },
+            overrideAccess: true,
+            req: args.req,
+        });
+        return { id: existing.id, value };
+    }
+    const created = await args.payload.create({
+        collection: collectionOf('metricBalances'),
+        data: {
+            user: args.userId,
+            scope: scopeId ?? undefined,
+            metric: args.metricId,
+            value,
+            key,
+        },
+        overrideAccess: true,
+        req: args.req,
+    });
+    return { id: String(created.id), value };
+}
+/** Rebuild balances for every distinct metric seen in this user’s metric.delta logs. */
+export async function rebuildMetricBalancesForUser(args) {
+    const scopeId = args.scopeId ?? null;
+    const logs = await args.payload.find({
+        collection: collectionOf('logs'),
+        depth: 0,
+        limit: 10_000,
+        pagination: false,
+        overrideAccess: true,
+        req: args.req,
+        where: {
+            and: [userScopeWhere(args.userId, scopeId), { metric: { exists: true } }],
+        },
+    });
+    const metricIds = new Set();
+    for (const doc of logs.docs) {
+        const id = relationId(doc.metric);
+        if (id)
+            metricIds.add(id);
+    }
+    let rebuilt = 0;
+    for (const metricId of metricIds) {
+        await rebuildMetricBalance({
+            payload: args.payload,
+            req: args.req,
+            userId: args.userId,
+            scopeId,
+            metricId,
+        });
+        rebuilt += 1;
+    }
+    return rebuilt;
+}

package/dist/services/achievement/reconcile.d.ts

@@ -6,6 +6,7 @@ export type ReconcileProgressionResult = {
     achievementRequestsEnsured: number;
     tierRequestsEnsured: number;
     tierLogsWritten: number;
+    metricBalancesRebuilt: number;
 };
 export type ReconcileProgressionArgs = {
     payload: Payload;

package/dist/services/achievement/reconcile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/reconcile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAS,MAAM,SAAS,CAAA;AAa7D,MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,iBAAiB,EAAE,MAAM,CAAA;IACzB,0BAA0B,EAAE,MAAM,CAAA;IAClC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAwFD,wFAAwF;AACxF,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,GAAG,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,cAAc,CAAC,CAAC,CAoC5D;AA2LD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,0BAA0B,CAAC,CA8CrC"}
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/reconcile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAS,MAAM,SAAS,CAAA;AAc7D,MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,iBAAiB,EAAE,MAAM,CAAA;IACzB,0BAA0B,EAAE,MAAM,CAAA;IAClC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,eAAe,EAAE,MAAM,CAAA;IACvB,qBAAqB,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAwFD,wFAAwF;AACxF,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,GAAG,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,cAAc,CAAC,CAAC,CA2C5D;AA2LD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,0BAA0B,CAAC,CAgDrC"}

package/dist/services/achievement/reconcile.js

@@ -2,6 +2,7 @@ import { collectionOf } from '../../collections/helpers.js';
 import { syncCompositeProgression, } from './grantSideEffects.js';
 import { transitionLogData, transitionToId } from './logData.js';
 import { recordLog, syncTierChangedLog } from './recordEvent.js';
+import { rebuildMetricBalancesForUser } from './metricBalances.js';
 import { relationId } from './relationId.js';
 import { resolveCatalogId } from './resolveCatalog.js';
 import { syncTierProgression } from './tierProgression.js';
@@ -88,6 +89,12 @@ export async function reconcileUserProgression(args) {
     if (!req.context)
         req.context = {};
     const grantedLogsBackfilled = await backfillGrantedLogs({ req, userId: args.userId, scopeId });
+    const metricBalancesRebuilt = await rebuildMetricBalancesForUser({
+        payload: args.payload,
+        req,
+        userId: args.userId,
+        scopeId,
+    });
     const composites = await syncCompositeProgression({
         req,
         userId: args.userId,
@@ -106,6 +113,7 @@ export async function reconcileUserProgression(args) {
     });
     return {
         grantedLogsBackfilled,
+        metricBalancesRebuilt,
         compositesGranted: composites.granted,
         achievementRequestsEnsured: composites.requested,
         tierRequestsEnsured: tiers.requested,
@@ -276,6 +284,7 @@ export async function reconcileProgression(args) {
         achievementRequestsEnsured: 0,
         tierRequestsEnsured: 0,
         tierLogsWritten: 0,
+        metricBalancesRebuilt: 0,
     };
     for (const pair of pairs) {
         const result = await reconcileUserProgression({
@@ -290,6 +299,7 @@ export async function reconcileProgression(args) {
         totals.achievementRequestsEnsured += result.achievementRequestsEnsured;
         totals.tierRequestsEnsured += result.tierRequestsEnsured;
         totals.tierLogsWritten += result.tierLogsWritten;
+        totals.metricBalancesRebuilt += result.metricBalancesRebuilt;
     }
     return totals;
 }

package/dist/services/achievement/recordEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recordEvent.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/recordEvent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAWtD,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACtC,CAAA;AAgBD,6DAA6D;AAC7D,wBAAsB,SAAS,CAAC,IAAI,EAAE,cAAc,wEAuCnD;AAED,4CAA4C;AAC5C,eAAO,MAAM,WAAW,kBAAY,CAAA;AAEpC;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,wEAiCA;AAED,6FAA6F;AAC7F,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,iFA0DA"}
+{"version":3,"file":"recordEvent.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/recordEvent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAatD,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACtC,CAAA;AAgBD,6DAA6D;AAC7D,wBAAsB,SAAS,CAAC,IAAI,EAAE,cAAc,wEAuCnD;AAED,4CAA4C;AAC5C,eAAO,MAAM,WAAW,kBAAY,CAAA;AAEpC;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,wEAsDA;AAED,6FAA6F;AAC7F,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,iFA0DA"}

package/dist/services/achievement/recordEvent.js

@@ -2,7 +2,9 @@ import { APIError } from 'payload';
 import { DEFAULT_ACHIEVEMENT_METRIC_SLUG } from '../../catalog.js';
 import { collectionOf } from '../../collections/helpers.js';
 import { eventTypeRequiresActor } from './eventTypeRequiresActor.js';
+import { applyMetricBalanceDelta } from './metricBalances.js';
 import { transitionLogData, transitionToId } from './logData.js';
+import { loadMetricDoc } from './resolveMetricValue.js';
 import { resolveCatalogId } from './resolveCatalog.js';
 import { resolveCurrentTier } from './resolveCurrentTier.js';
 import { userScopeWhere } from './where.js';
@@ -60,6 +62,17 @@ export const recordEvent = recordLog;
 export async function recordMetricChange(args) {
     const metricSlug = args.metric ?? DEFAULT_ACHIEVEMENT_METRIC_SLUG;
     const scopeId = args.scopeId ?? null;
+    const metricDoc = await loadMetricDoc({
+        payload: args.payload,
+        req: args.req,
+        metric: metricSlug,
+    });
+    if (!metricDoc) {
+        throw new APIError(`Unknown metric "${metricSlug}".`, 400);
+    }
+    if ((metricDoc.kind ?? 'stored') === 'computed') {
+        throw new APIError('Computed metrics cannot be changed with recordMetricChange.', 400);
+    }
     const log = await recordLog({
         payload: args.payload,
         req: args.req,
@@ -67,10 +80,18 @@ export async function recordMetricChange(args) {
         scopeId,
         type: 'metric.delta',
         actorId: args.actorId,
-        metric: metricSlug,
+        metric: metricDoc.id,
         change: args.change,
         reason: args.reason,
     });
+    await applyMetricBalanceDelta({
+        payload: args.payload,
+        req: args.req,
+        userId: args.userId,
+        scopeId,
+        metricId: metricDoc.id,
+        change: args.change,
+    });
     if (args.req) {
         const { syncTierProgression } = await import('./tierProgression.js');
         await syncTierProgression({

package/dist/services/achievement/resolveElapsedAnchor.d.ts

@@ -0,0 +1,15 @@
+import type { Payload, PayloadRequest } from 'payload';
+/**
+ * Resolve the start timestamp for elapsed rules / computed metrics.
+ * Built-ins: `user-created-at`, `first-event`. Host keys: `extensions.metricAnchors`.
+ */
+export declare function resolveElapsedAnchor(args: {
+    payload: Payload;
+    req?: PayloadRequest;
+    since?: unknown;
+    eventType?: unknown;
+    eventTypeSlug?: unknown;
+    userId: string;
+    scopeId: string | null;
+}): Promise<Date | null>;
+//# sourceMappingURL=resolveElapsedAnchor.d.ts.map

package/dist/services/achievement/resolveElapsedAnchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveElapsedAnchor.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/resolveElapsedAnchor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AA8CtD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CA0DvB"}

package/dist/services/achievement/resolveElapsedAnchor.js

@@ -0,0 +1,98 @@
+import { collectionOf } from '../../collections/helpers.js';
+import { getAchievementOptions } from '../../options-store.js';
+import { parseDate } from './duration.js';
+import { relationId } from './relationId.js';
+import { userScopeIncludingUnscopedWhere } from './where.js';
+async function resolveEventTypeId(args) {
+    let eventTypeId = relationId(args.eventType);
+    if (eventTypeId) {
+        const byId = await args.payload.find({
+            collection: collectionOf('eventTypes'),
+            depth: 0,
+            limit: 1,
+            overrideAccess: true,
+            req: args.req,
+            where: { id: { equals: eventTypeId } },
+        });
+        if (byId.docs[0])
+            return eventTypeId;
+    }
+    const slug = typeof args.eventTypeSlug === 'string'
+        ? args.eventTypeSlug
+        : typeof args.eventType === 'string'
+            ? args.eventType
+            : '';
+    if (!slug)
+        return null;
+    const found = await args.payload.find({
+        collection: collectionOf('eventTypes'),
+        depth: 0,
+        limit: 1,
+        overrideAccess: true,
+        req: args.req,
+        where: { slug: { equals: slug } },
+    });
+    return relationId(found.docs[0]);
+}
+/**
+ * Resolve the start timestamp for elapsed rules / computed metrics.
+ * Built-ins: `user-created-at`, `first-event`. Host keys: `extensions.metricAnchors`.
+ */
+export async function resolveElapsedAnchor(args) {
+    const since = String(args.since ?? 'user-created-at');
+    if (since === 'user-created-at') {
+        const usersSlug = getAchievementOptions().usersCollectionSlug ?? 'users';
+        try {
+            const user = (await args.payload.findByID({
+                collection: usersSlug,
+                id: args.userId,
+                depth: 0,
+                overrideAccess: true,
+                req: args.req,
+            }));
+            return parseDate(user?.createdAt);
+        }
+        catch {
+            return null;
+        }
+    }
+    if (since === 'first-event') {
+        const eventTypeId = await resolveEventTypeId({
+            payload: args.payload,
+            req: args.req,
+            eventType: args.eventType,
+            eventTypeSlug: args.eventTypeSlug,
+        });
+        if (!eventTypeId)
+            return null;
+        const logs = await args.payload.find({
+            collection: collectionOf('logs'),
+            depth: 0,
+            limit: 1,
+            overrideAccess: true,
+            req: args.req,
+            sort: 'createdAt',
+            where: {
+                and: [
+                    userScopeIncludingUnscopedWhere(args.userId, args.scopeId),
+                    { type: { equals: eventTypeId } },
+                ],
+            },
+        });
+        return parseDate(logs.docs[0]?.createdAt);
+    }
+    const hostAnchor = getAchievementOptions().extensions?.metricAnchors?.[since];
+    if (!hostAnchor)
+        return null;
+    try {
+        return parseDate(await hostAnchor({
+            payload: args.payload,
+            req: args.req,
+            userId: args.userId,
+            scopeId: args.scopeId,
+        }));
+    }
+    catch {
+        return null;
+    }
+}

package/dist/services/achievement/resolveMetricValue.d.ts

@@ -0,0 +1,32 @@
+import type { Payload, PayloadRequest } from 'payload';
+export type MetricDoc = {
+    id?: unknown;
+    slug?: string;
+    kind?: string | null;
+    compute?: string | null;
+    unit?: string | null;
+    since?: string | null;
+    eventType?: unknown;
+};
+export declare function loadMetricDoc(args: {
+    payload: Payload;
+    req?: PayloadRequest;
+    metric: string;
+}): Promise<(MetricDoc & {
+    id: string;
+}) | null>;
+/**
+ * Current numeric value for a metric (stored balance or computed elapsed).
+ */
+export declare function resolveMetricValue(args: {
+    payload: Payload;
+    req?: PayloadRequest;
+    /** Metric document id or slug, or a loaded metric doc. */
+    metric: string | (MetricDoc & {
+        id: string;
+    });
+    userId: string;
+    scopeId: string | null;
+    now?: Date;
+}): Promise<number>;
+//# sourceMappingURL=resolveMetricValue.d.ts.map

package/dist/services/achievement/resolveMetricValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveMetricValue.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/resolveMetricValue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAQtD,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC,CAAC,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAAC,CA+B/C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,GAAG,CAAC,SAAS,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,GAAG,CAAC,EAAE,IAAI,CAAA;CACX,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BlB"}

package/dist/services/achievement/resolveMetricValue.js

@@ -0,0 +1,73 @@
+import { collectionOf } from '../../collections/helpers.js';
+import { elapsedUnits } from './duration.js';
+import { findMetricBalance } from './metricBalances.js';
+import { relationId } from './relationId.js';
+import { resolveElapsedAnchor } from './resolveElapsedAnchor.js';
+export async function loadMetricDoc(args) {
+    const byId = relationId(args.metric);
+    if (byId && args.metric === byId) {
+        try {
+            const doc = (await args.payload.findByID({
+                collection: collectionOf('metrics'),
+                id: byId,
+                depth: 0,
+                overrideAccess: true,
+                req: args.req,
+            }));
+            if (doc)
+                return { ...doc, id: byId };
+        }
+        catch {
+            // fall through to slug lookup
+        }
+    }
+    const found = await args.payload.find({
+        collection: collectionOf('metrics'),
+        depth: 0,
+        limit: 1,
+        overrideAccess: true,
+        req: args.req,
+        where: {
+            or: [{ id: { equals: args.metric } }, { slug: { equals: args.metric } }],
+        },
+    });
+    const doc = found.docs[0];
+    const id = relationId(doc);
+    if (!doc || !id)
+        return null;
+    return { ...doc, id };
+}
+/**
+ * Current numeric value for a metric (stored balance or computed elapsed).
+ */
+export async function resolveMetricValue(args) {
+    const doc = typeof args.metric === 'string'
+        ? await loadMetricDoc({ payload: args.payload, req: args.req, metric: args.metric })
+        : args.metric;
+    if (!doc)
+        return 0;
+    const kind = doc.kind ?? 'stored';
+    if (kind === 'computed') {
+        if ((doc.compute ?? 'elapsed') !== 'elapsed')
+            return 0;
+        const anchor = await resolveElapsedAnchor({
+            payload: args.payload,
+            req: args.req,
+            since: doc.since,
+            eventType: doc.eventType,
+            userId: args.userId,
+            scopeId: args.scopeId,
+        });
+        if (!anchor)
+            return 0;
+        return elapsedUnits(anchor, doc.unit ?? 'days', args.now ?? new Date()) ?? 0;
+    }
+    const balance = await findMetricBalance({
+        payload: args.payload,
+        req: args.req,
+        userId: args.userId,
+        scopeId: args.scopeId,
+        metricId: doc.id,
+    });
+    return balance?.value ?? 0;
+}

package/dist/services/achievement/validateRules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateRules.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/validateRules.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEvE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAuD7E;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAC9D,MAAM,GAAG,IAAI,CAOf;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,EAC/D,KAAK,EAAE,MAAM,GACZ,IAAI,CAKN"}
+{"version":3,"file":"validateRules.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/validateRules.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEvE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CA0E7E;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAC9D,MAAM,GAAG,IAAI,CAOf;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,EAC/D,KAAK,EAAE,MAAM,GACZ,IAAI,CAKN"}

package/dist/services/achievement/validateRules.js

@@ -49,6 +49,25 @@ export function validateRuleNode(rule) {
         }
         return null;
     }
+    if (type === 'elapsed-since') {
+        const since = String(rule.since ?? 'user-created-at');
+        if (since === 'first-event') {
+            if (!relationId(rule.eventType) && typeof rule.eventTypeSlug !== 'string') {
+                return 'Elapsed since (first event) needs an event type.';
+            }
+        }
+        else if (since !== 'user-created-at') {
+            return 'Elapsed since needs a valid since source.';
+        }
+        if (typeof rule.amount !== 'number' || Number.isNaN(rule.amount) || rule.amount < 0) {
+            return 'Elapsed since needs a non-negative amount.';
+        }
+        const unit = rule.unit ?? 'days';
+        if (unit !== 'days' && unit !== 'hours' && unit !== 'minutes') {
+            return 'Elapsed since unit must be days, hours, or minutes.';
+        }
+        return null;
+    }
     if (!type) {
         return 'Each rule needs a type.';
     }

package/dist/types.d.ts

@@ -1,4 +1,11 @@
-import type { CollectionConfig, PayloadRequest, TypedUser } from 'payload';
+import type { CollectionConfig, Payload, PayloadRequest, TypedUser } from 'payload';
+/** Host-registered date anchors for computed elapsed metrics / `elapsed-since` rules. */
+export type AchievementMetricAnchor = (args: {
+    payload: Payload;
+    req?: PayloadRequest;
+    userId: string;
+    scopeId: string | null;
+}) => Date | null | Promise<Date | null>;
 export type AchievementScopeConfig = {
     collection: string;
     relationField?: string;
@@ -33,7 +40,7 @@ export type AchievementRuleType = {
     progressRole?: 'requirement' | 'gate';
 };
 /** Logical collection ids — map to configurable slugs via `collections`. */
-export type AchievementCollectionKey = 'tiers' | 'achievements' | 'grants' | 'achievementRequests' | 'tierRequests' | 'logs' | 'eventTypes' | 'metrics';
+export type AchievementCollectionKey = 'tiers' | 'achievements' | 'grants' | 'achievementRequests' | 'tierRequests' | 'logs' | 'eventTypes' | 'metrics' | 'metricBalances';
 /**
  * Host overrides layered onto a plugin collection (Form Builder–style).
  * Access/admin merge shallowly; hook arrays are appended after plugin hooks.
@@ -80,6 +87,12 @@ export type AchievementEndpointsOptions = {
      * Pass `false` to skip registering the endpoint.
      */
     me?: string | false;
+    /**
+     * Root REST path for a stored-metric leaderboard (`GET`).
+     * Default: `'/achievements/leaderboard'`. Requires an authenticated user.
+     * Pass `false` to skip.
+     */
+    leaderboard?: string | false;
     /**
      * Root REST path to repair progression from existing grants (`POST`).
      * Default: `'/achievements/reconcile'`. Requires host `canReview`.
@@ -101,7 +114,17 @@ export type AchievementPluginOptions = {
     extensions?: {
         /** Custom rule evaluators merged with built-ins. */
         ruleTypes?: AchievementRuleType[];
+        /**
+         * Named date anchors for computed `elapsed` metrics and `elapsed-since` rules.
+         * Keys appear in Admin `since` selects; missing keys resolve to null at eval time.
+         */
+        metricAnchors?: Record<string, AchievementMetricAnchor>;
     };
+    /**
+     * When true (default), ensure system metrics + event types exist on Payload `onInit`
+     * (`seedAchievementCatalog`). Host product catalogs still seed via `seedAchievements`.
+     */
+    seedSystemCatalog?: boolean;
     /**
      * Host upload collection slug (e.g. `'media'`). When set, tiers gain an optional
      * `image` upload field for ladder badges. Icon keys still work without this.
@@ -117,7 +140,7 @@ export type AchievementPluginOptions = {
     users?: AchievementUsersOptions;
     usersCollectionSlug?: string;
 };
-export type BuiltInRuleType = 'achievement-complete' | 'event-count' | 'metric-minimum' | 'tier-at-least';
+export type BuiltInRuleType = 'achievement-complete' | 'elapsed-since' | 'event-count' | 'metric-minimum' | 'tier-at-least';
 /** Engine log-type catalog slugs (seeded as system catalog rows). */
 export type BuiltInEventType = 'achievement.granted' | 'achievement.revoked' | 'metric.delta' | 'tier.changed';
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dappermountain/payload-plugin-achievements",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "A robust, Admin-configured achievements engine for Payload: composable unlock rules, derived rank progress, request/review grants, metrics, and scoped multi-tenant support.",
   "license": "MIT",
   "type": "module",