@dappermountain/payload-plugin-achievements 0.4.2 → 0.5.0

package/README.md

@@ -100,7 +100,7 @@ Slugs are prefixed with `achievement-` by default so they don’t collide with y
 | `achievement.revoked` | Written when a grant is deleted |
 | `tier.changed` | Written when derived tier moves (including demotions when a tier request leaves `approved`) |
 
-Event types can require an **actor** and/or a **metric + change**. Admin only prompts for those fields when the type needs them.
+Event types can require an **actor** and/or a **metric + change**. Admin only prompts for those fields when the type needs them. Optional **Snapshot actor tiers** stores the actor’s derived ladder rank on the log at write time (`resolveCurrentTier` only — no grants or tier requests). Unscoped logs stamp every ladder scope; scoped logs stamp that tenant plus any unscoped ranks. Use that with Event count → **Actor tier** to count only events whose actor held at least that step in the rule’s scope when the event was written. Leave Actor tier empty to count every matching event. Logs without a snapshot (legacy rows, or types that do not stamp) do not match an Actor tier filter.
 
 ### Rules engine
 
@@ -118,7 +118,7 @@ Unlock (tiers), eligibility, and completion (achievements) share the same rule t
 | AND | Equal average of *requirement* children |
 | OR | Best child (max) |
 | `tier-at-least` | Gate — skipped in AND averages |
-| `event-count` / `metric-minimum` | Fraction of the target |
+| `event-count` / `metric-minimum` | Fraction of the target. `event-count` may set **Actor tier** (at-least, this scope) against the log’s actor-tier snapshot |
 | `achievement-complete` | `1` if granted; otherwise rolls up that achievement’s completion (or eligibility) rules |
 
 **Computed elapsed metrics** — `kind: computed` + `compute: elapsed` + `unit` (`seconds` | `minutes` | `hours` | `days` | `years`) + `since` (built-in `user-created-at` / `first-event`, or a host `metricAnchors` key). Gate tenure with `metric-minimum` against that metric. Years use a fixed 365-day length. System seed only creates stored `points` — product computed metrics (e.g. `days`) are host-seeded after registering anchors.

package/dist/collections/EventTypes/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/EventTypes/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAS,MAAM,SAAS,CAAA;AAqCtD,wBAAgB,yBAAyB,IAAI,gBAAgB,CAoE5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/EventTypes/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAS,MAAM,SAAS,CAAA;AAqCtD,wBAAgB,yBAAyB,IAAI,gBAAgB,CA+E5D"}

package/dist/collections/EventTypes/index.js

@@ -41,6 +41,7 @@ export function buildEventTypesCollection() {
                 'name',
                 'slug',
                 'requiresActor',
+                'snapshotActorTiers',
                 'requiresMetric',
                 ...(subjectFields.length > 0 ? ['requiresSubject'] : []),
                 'system',
@@ -66,6 +67,15 @@ export function buildEventTypesCollection() {
                     description: 'Turn this on when someone else caused the entry (for example a peer nomination). We’ll ask for that person when it’s logged.',
                 },
             },
+            {
+                name: 'snapshotActorTiers',
+                type: 'checkbox',
+                defaultValue: false,
+                label: 'Snapshot actor tiers',
+                admin: {
+                    description: 'When this entry is logged, store the actor’s derived ladder rank at write time. Unscoped logs stamp every ladder; scoped logs stamp that tenant plus unscoped ranks. Event count can then require “actor was at least this tier” in the rule’s scope. Does not grant or open requests.',
+                },
+            },
             {
                 name: 'requiresMetric',
                 type: 'checkbox',

package/dist/collections/Logs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/Logs/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAS,MAAM,SAAS,CAAA;AAqCtD,+EAA+E;AAC/E,wBAAgB,mBAAmB,IAAI,gBAAgB,CAuHtD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/Logs/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAS,MAAM,SAAS,CAAA;AAqCtD,+EAA+E;AAC/E,wBAAgB,mBAAmB,IAAI,gBAAgB,CAgJtD"}

package/dist/collections/Logs/index.js

@@ -119,6 +119,30 @@ export function buildLogsCollection() {
                 ],
             },
             ...(subjectField ? [subjectField] : []),
+            {
+                name: 'actorTiers',
+                type: 'array',
+                admin: {
+                    readOnly: true,
+                    description: 'Derived ladder rank of the actor when this entry was written. Filled only when the event type snapshots actor tiers.',
+                },
+                fields: [
+                    ...optionalFields(scopeField()),
+                    {
+                        name: 'tier',
+                        type: 'relationship',
+                        relationTo: collectionOf('tiers'),
+                        required: true,
+                        admin: { description: 'Which ladder step they held.' },
+                    },
+                    {
+                        name: 'rank',
+                        type: 'number',
+                        required: true,
+                        admin: { description: 'Ladder rank at write time (higher is further along).' },
+                    },
+                ],
+            },
             {
                 type: 'collapsible',
                 label: 'Details',

package/dist/collections/fields/ruleFields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ruleFields.d.ts","sourceRoot":"","sources":["../../../src/collections/fields/ruleFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAqGpC;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,KAAK,EAAE,CAqB7C;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,IAAI,KAAK,EAAE,CAE5C"}
+{"version":3,"file":"ruleFields.d.ts","sourceRoot":"","sources":["../../../src/collections/fields/ruleFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAgHpC;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,KAAK,EAAE,CAqB7C;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,IAAI,KAAK,EAAE,CAE5C"}

package/dist/collections/fields/ruleFields.js

@@ -87,6 +87,16 @@ function ruleParamFields() {
                 description: 'How many times it needs to have happened.',
             },
         },
+        {
+            name: 'actorTier',
+            type: 'relationship',
+            relationTo: collectionOf('tiers'),
+            filterOptions: catalogFilterOptions,
+            admin: {
+                condition: (_, sibling) => sibling?.type === 'event-count',
+                description: 'Only count events whose actor held at least this tier in this scope when the event was written. Requires the event type to snapshot actor tiers. Leave empty to count every matching event.',
+            },
+        },
     ];
 }
 function buildRuleLeafFields() {

package/dist/seed/index.d.ts

@@ -59,6 +59,8 @@ export type AchievementSeedCatalogRow = {
     requiresMetric?: boolean;
     /** Event types only — when true, logging the event requires a polymorphic `subject`. */
     requiresSubject?: boolean;
+    /** Event types only — stamp the actor’s derived ladder ranks on the log at write time. */
+    snapshotActorTiers?: boolean;
     /**
      * Event types only — allowed host collections for `subject.relationTo`.
      * Empty / omit = any collection from plugin `subjects.collections`.

package/dist/seed/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seed/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAOtC,mGAAmG;AACnG,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAExG,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,4BAA4B,CAAA;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,4BAA4B,CAAA;IAC1C,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qFAAqF;IACrF,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAA;CACrG,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,4BAA4B,CAAA;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,4BAA4B,CAAA;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAA;IACzG,qGAAqG;IACrG,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAA;CACzG,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,4BAA4B,CAAA;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kDAAkD;IAClD,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;IAC5B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,qDAAqD;IACrD,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;IACzD,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,gFAAgF;IAChF,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,wFAAwF;IACxF,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,CAAC,EAAE,yBAAyB,EAAE,CAAA;IACxC,OAAO,CAAC,EAAE,yBAAyB,EAAE,CAAA;IACrC,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC7B,YAAY,CAAC,EAAE,0BAA0B,EAAE,CAAA;IAC3C,gEAAgE;IAChE,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAA;CAClC,CAAA;AA4ND,2FAA2F;AAC3F,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB5F;AAiCD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqLnG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seed/index.ts"],"names":[],"mappings":"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"}

package/dist/seed/index.js

@@ -75,6 +75,7 @@ async function upsertCatalog(payload, key, row) {
                 requiresActor: row.requiresActor ?? false,
                 requiresMetric: row.requiresMetric ?? false,
                 requiresSubject: row.requiresSubject ?? false,
+                snapshotActorTiers: row.snapshotActorTiers ?? false,
                 ...(row.subjectRelationTo && row.subjectRelationTo.length > 0
                     ? { subjectRelationTo: row.subjectRelationTo }
                     : { subjectRelationTo: [] }),
@@ -153,6 +154,14 @@ async function resolveRuleNode(payload, rule) {
                 delete next.eventTypeSlug;
             }
         }
+        // Optional at-least floor against the log’s actor-tier snapshot.
+        if (!next.actorTier && typeof next.actorTierSlug === 'string') {
+            const id = await findIdBySlug(payload, 'tiers', next.actorTierSlug);
+            if (id) {
+                next.actorTier = id;
+                delete next.actorTierSlug;
+            }
+        }
     }
     if (next.type === 'metric-minimum') {
         const slug = typeof next.metricSlug === 'string' ? next.metricSlug : typeof next.metric === 'string' ? next.metric : '';

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

@@ -0,0 +1,40 @@
+import type { Payload, PayloadRequest } from 'payload';
+export type ActorTierSnapshotRow = {
+    scope?: string | null;
+    tier: string;
+    rank: number;
+};
+/**
+ * Unscoped logs stamp every ladder (a later scoped count can still see the actor’s rank).
+ * Scoped logs stamp that tenant plus any unscoped ranks.
+ */
+export declare function scopeIdsForActorSnapshot(args: {
+    logScopeId: string | null;
+    ladderScopeIds: Array<string | null>;
+}): Array<string | null>;
+/** Normalize log `actorTiers` rows for matching. */
+export declare function readActorTierSnapshotRows(value: unknown): Array<{
+    scopeId: string | null;
+    rank: number;
+}>;
+/**
+ * True when a snapshot includes this scope at rank ≥ `minimumRank`.
+ * Missing snapshot (legacy logs) never matches — the event was not stamped.
+ */
+export declare function actorSnapshotMeetsTier(args: {
+    rows: unknown;
+    scopeId: string | null;
+    minimumRank: number;
+}): boolean;
+/**
+ * Read-only derived ladder ranks for an actor across configured scopes.
+ * Does not reconcile, grant, or open tier requests.
+ */
+export declare function snapshotActorDerivedTiers(args: {
+    payload: Payload;
+    req?: PayloadRequest;
+    userId: string;
+    /** Log `scope` — `null` stamps every ladder scope. */
+    logScopeId?: string | null;
+}): Promise<ActorTierSnapshotRow[]>;
+//# sourceMappingURL=actorTierSnapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actorTierSnapshot.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/actorTierSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAQtD,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAyBD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,cAAc,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CACrC,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAcvB;AAED,oDAAoD;AACpD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAAC;IAC/D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;CACb,CAAC,CAWD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;CACpB,GAAG,OAAO,CAIV;AAmDD;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA0BlC"}

package/dist/services/achievement/actorTierSnapshot.js

@@ -0,0 +1,138 @@
+import { collectionOf } from '../../collections/helpers.js';
+import { getAchievementOptions } from '../../options-store.js';
+import { CTX_ACTOR_TIER_RESOLVE } from './contextFlags.js';
+import { relationId } from './relationId.js';
+import { resolveCurrentTier } from './resolveCurrentTier.js';
+function resolveCache(req) {
+    if (!req)
+        return null;
+    const context = (req.context ?? {});
+    const existing = context[CTX_ACTOR_TIER_RESOLVE];
+    if (existing instanceof Map)
+        return existing;
+    const created = new Map();
+    req.context = { ...req.context, [CTX_ACTOR_TIER_RESOLVE]: created };
+    return created;
+}
+function cacheKey(userId, scopeId) {
+    return `${userId}:${scopeId ?? ''}`;
+}
+function pushUniqueScope(out, seen, id) {
+    const key = id ?? '';
+    if (seen.has(key))
+        return;
+    seen.add(key);
+    out.push(id);
+}
+/**
+ * Unscoped logs stamp every ladder (a later scoped count can still see the actor’s rank).
+ * Scoped logs stamp that tenant plus any unscoped ranks.
+ */
+export function scopeIdsForActorSnapshot(args) {
+    const out = [];
+    const seen = new Set();
+    if (args.logScopeId == null) {
+        for (const id of args.ladderScopeIds)
+            pushUniqueScope(out, seen, id);
+        return out;
+    }
+    pushUniqueScope(out, seen, args.logScopeId);
+    for (const id of args.ladderScopeIds) {
+        if (id == null)
+            pushUniqueScope(out, seen, null);
+    }
+    return out;
+}
+/** Normalize log `actorTiers` rows for matching. */
+export function readActorTierSnapshotRows(value) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    for (const row of value) {
+        if (!row || typeof row !== 'object')
+            continue;
+        const rec = row;
+        const rank = Number(rec.rank);
+        if (!Number.isFinite(rank))
+            continue;
+        out.push({ scopeId: relationId(rec.scope) ?? null, rank });
+    }
+    return out;
+}
+/**
+ * True when a snapshot includes this scope at rank ≥ `minimumRank`.
+ * Missing snapshot (legacy logs) never matches — the event was not stamped.
+ */
+export function actorSnapshotMeetsTier(args) {
+    return readActorTierSnapshotRows(args.rows).some((row) => row.scopeId === args.scopeId && row.rank >= args.minimumRank);
+}
+async function listLadderScopeIds(args) {
+    if (!getAchievementOptions().scope?.collection)
+        return [null];
+    const { docs } = await args.payload.find({
+        collection: collectionOf('tiers'),
+        depth: 0,
+        overrideAccess: true,
+        pagination: false,
+        req: args.req,
+        select: { scope: true },
+    });
+    const ids = new Set();
+    let unscoped = false;
+    for (const doc of docs) {
+        const scopeId = relationId(doc.scope);
+        if (scopeId)
+            ids.add(scopeId);
+        else
+            unscoped = true;
+    }
+    const out = [...ids];
+    if (unscoped || out.length === 0)
+        out.push(null);
+    return out;
+}
+async function currentTierMemoized(args) {
+    const cache = resolveCache(args.req);
+    const key = cacheKey(args.userId, args.scopeId);
+    const hit = cache?.get(key);
+    if (hit)
+        return hit;
+    const pending = resolveCurrentTier({
+        payload: args.payload,
+        req: args.req,
+        userId: args.userId,
+        scopeId: args.scopeId,
+    });
+    cache?.set(key, pending);
+    return pending;
+}
+/**
+ * Read-only derived ladder ranks for an actor across configured scopes.
+ * Does not reconcile, grant, or open tier requests.
+ */
+export async function snapshotActorDerivedTiers(args) {
+    if (!args.userId)
+        return [];
+    const ladderScopeIds = await listLadderScopeIds({ payload: args.payload, req: args.req });
+    const scopeIds = scopeIdsForActorSnapshot({
+        logScopeId: args.logScopeId ?? null,
+        ladderScopeIds,
+    });
+    const rows = [];
+    for (const scopeId of scopeIds) {
+        const current = await currentTierMemoized({
+            payload: args.payload,
+            req: args.req,
+            userId: args.userId,
+            scopeId,
+        });
+        if (!current)
+            continue;
+        rows.push({
+            ...(scopeId ? { scope: scopeId } : {}),
+            tier: current.id,
+            rank: current.rank,
+        });
+    }
+    return rows;
+}

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

@@ -1,6 +1,7 @@
 import type { Payload, PayloadRequest } from 'payload';
 export declare const UNLOCK_REQUIREMENT_RELATION_FIELDS: {
     readonly tier: "tiers";
+    readonly actorTier: "tiers";
     readonly achievement: "achievements";
     readonly metric: "metrics";
     readonly eventType: "eventTypes";

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

@@ -1 +1 @@
-{"version":3,"file":"buildUnlockRequirementLeaves.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/buildUnlockRequirementLeaves.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAOtD,eAAO,MAAM,kCAAkC;;;;;CAKyC,CAAA;AAExF,MAAM,MAAM,8BAA8B,GACxC,CAAC,OAAO,kCAAkC,CAAC,CAAC,MAAM,OAAO,kCAAkC,CAAC,CAAA;AAE9F,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,MAAM,OAAO,kCAAkC,CAAA;IACtD,aAAa,EAAE,8BAA8B,CAAA;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,OAAO,CAAA;IACZ,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,yBAAyB,EAAE,CAAA;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAqHD;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0BAA0B,CAAC,EAAE,OAAO,CAAA;CACrC,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA8EnC"}
+{"version":3,"file":"buildUnlockRequirementLeaves.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/buildUnlockRequirementLeaves.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAOtD,eAAO,MAAM,kCAAkC;;;;;;CAMyC,CAAA;AAExF,MAAM,MAAM,8BAA8B,GACxC,CAAC,OAAO,kCAAkC,CAAC,CAAC,MAAM,OAAO,kCAAkC,CAAC,CAAA;AAE9F,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,MAAM,OAAO,kCAAkC,CAAA;IACtD,aAAa,EAAE,8BAA8B,CAAA;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,OAAO,CAAA;IACZ,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,yBAAyB,EAAE,CAAA;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAqHD;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0BAA0B,CAAC,EAAE,OAAO,CAAA;CACrC,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA8EnC"}

package/dist/services/achievement/buildUnlockRequirementLeaves.js

@@ -4,6 +4,7 @@ import { evaluateRuleProgress, evaluateRules } from './evaluateRules.js';
 import { relationId } from './relationId.js';
 export const UNLOCK_REQUIREMENT_RELATION_FIELDS = {
     tier: 'tiers',
+    actorTier: 'tiers',
     achievement: 'achievements',
     metric: 'metrics',
     eventType: 'eventTypes',

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

@@ -1 +1 @@
-{"version":3,"file":"builtInRules.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/builtInRules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAqJlF,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,EA6JjD,CAAA"}
+{"version":3,"file":"builtInRules.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/builtInRules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AA4OlF,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,EA6IjD,CAAA"}

package/dist/services/achievement/builtInRules.js

@@ -1,4 +1,5 @@
 import { collectionOf } from '../../collections/helpers.js';
+import { actorSnapshotMeetsTier } from './actorTierSnapshot.js';
 import { relationId } from './relationId.js';
 import { resolveMetricValue } from './resolveMetricValue.js';
 import { userScopeIncludingUnscopedWhere } from './where.js';
@@ -52,6 +53,78 @@ async function resolveEventTypeId(args) {
     });
     return relationId(found.docs[0]);
 }
+async function resolveActorTierMinimumRank(args) {
+    const fromRelation = relationId(args.rule.actorTier);
+    const slug = typeof args.rule.actorTierSlug === 'string' && args.rule.actorTierSlug
+        ? args.rule.actorTierSlug
+        : '';
+    if (!fromRelation && !slug)
+        return null;
+    if (fromRelation) {
+        try {
+            const doc = (await args.payload.findByID({
+                collection: collectionOf('tiers'),
+                id: fromRelation,
+                depth: 0,
+                overrideAccess: true,
+                select: { rank: true },
+            }));
+            if (doc && typeof doc.rank === 'number' && Number.isFinite(doc.rank))
+                return doc.rank;
+        }
+        catch {
+            /* fall through to slug */
+        }
+    }
+    if (!slug)
+        return null;
+    const found = await args.payload.find({
+        collection: collectionOf('tiers'),
+        depth: 0,
+        limit: 1,
+        overrideAccess: true,
+        where: { slug: { equals: slug } },
+        select: { rank: true },
+    });
+    const rank = found.docs[0]?.rank;
+    return typeof rank === 'number' && Number.isFinite(rank) ? rank : null;
+}
+async function countMatchingEventLogs(args) {
+    const eventTypeId = await resolveEventTypeId({ payload: args.payload, rule: args.rule });
+    if (!eventTypeId)
+        return 0;
+    const where = {
+        and: [
+            userScopeIncludingUnscopedWhere(args.userId, args.scopeId),
+            { type: { equals: eventTypeId } },
+        ],
+    };
+    const minimumRank = await resolveActorTierMinimumRank({
+        payload: args.payload,
+        rule: args.rule,
+    });
+    if (minimumRank == null) {
+        const result = await args.payload.count({
+            collection: collectionOf('logs'),
+            overrideAccess: true,
+            where,
+        });
+        return result.totalDocs;
+    }
+    const { docs } = await args.payload.find({
+        collection: collectionOf('logs'),
+        depth: 0,
+        overrideAccess: true,
+        pagination: false,
+        select: { actorTiers: true },
+        where,
+    });
+    return docs.filter((doc) => actorSnapshotMeetsTier({
+        rows: doc.actorTiers,
+        scopeId: args.scopeId,
+        minimumRank,
+    })).length;
+}
 async function resolveAchievementRef(args) {
     let requiredId = relationId(args.rule.achievement);
     let requiredSlug = typeof args.rule.achievementSlug === 'string' ? args.rule.achievementSlug : '';
@@ -244,34 +317,16 @@ export const builtInRuleTypes = [
     {
         type: 'event-count',
         async evaluate({ payload, rule, userId, scopeId }) {
-            const eventTypeId = await resolveEventTypeId({ payload, rule });
-            if (!eventTypeId)
-                return false;
             const needed = Number(rule.count ?? 1);
-            const result = await payload.count({
-                collection: collectionOf('logs'),
-                overrideAccess: true,
-                where: {
-                    and: [userScopeIncludingUnscopedWhere(userId, scopeId), { type: { equals: eventTypeId } }],
-                },
-            });
-            return result.totalDocs >= needed;
+            const total = await countMatchingEventLogs({ payload, rule, userId, scopeId });
+            return total >= needed;
         },
         async progress({ payload, rule, userId, scopeId }) {
-            const eventTypeId = await resolveEventTypeId({ payload, rule });
-            if (!eventTypeId)
-                return 0;
             const needed = Number(rule.count ?? 1);
             if (!(needed > 0))
                 return 1;
-            const result = await payload.count({
-                collection: collectionOf('logs'),
-                overrideAccess: true,
-                where: {
-                    and: [userScopeIncludingUnscopedWhere(userId, scopeId), { type: { equals: eventTypeId } }],
-                },
-            });
-            return clamp01(result.totalDocs / needed);
+            const total = await countMatchingEventLogs({ payload, rule, userId, scopeId });
+            return clamp01(total / needed);
         },
     },
 ];

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

@@ -2,4 +2,6 @@
 export declare const CTX_SKIP_GRANT_SIDE_EFFECTS = "achievementSkipGrantSideEffects";
 export declare const CTX_CASCADING_REVOKE = "achievementCascadingRevoke";
 export declare const CTX_SYSTEM_REQUEST = "achievementSystemRequest";
+/** Memo for read-only {@link resolveCurrentTier} during actor-tier snapshots. */
+export declare const CTX_ACTOR_TIER_RESOLVE = "achievementActorTierResolve";
 //# sourceMappingURL=contextFlags.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"contextFlags.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/contextFlags.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,eAAO,MAAM,2BAA2B,oCAAoC,CAAA;AAC5E,eAAO,MAAM,oBAAoB,+BAA+B,CAAA;AAChE,eAAO,MAAM,kBAAkB,6BAA6B,CAAA"}
+{"version":3,"file":"contextFlags.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/contextFlags.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,eAAO,MAAM,2BAA2B,oCAAoC,CAAA;AAC5E,eAAO,MAAM,oBAAoB,+BAA+B,CAAA;AAChE,eAAO,MAAM,kBAAkB,6BAA6B,CAAA;AAC5D,iFAAiF;AACjF,eAAO,MAAM,sBAAsB,gCAAgC,CAAA"}

package/dist/services/achievement/contextFlags.js

@@ -2,3 +2,5 @@
 export const CTX_SKIP_GRANT_SIDE_EFFECTS = 'achievementSkipGrantSideEffects';
 export const CTX_CASCADING_REVOKE = 'achievementCascadingRevoke';
 export const CTX_SYSTEM_REQUEST = 'achievementSystemRequest';
+/** Memo for read-only {@link resolveCurrentTier} during actor-tier snapshots. */
+export const CTX_ACTOR_TIER_RESOLVE = 'achievementActorTierResolve';

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

@@ -3,6 +3,8 @@ export type EventTypeFlags = {
     requiresActor: boolean;
     requiresMetric: boolean;
     requiresSubject: boolean;
+    /** Stamp the actor's derived ladder ranks on the log at write time. */
+    snapshotActorTiers: boolean;
     /** Allowed host collections for `subject.relationTo` (empty = any plugin allowlist entry). */
     subjectRelationTo: string[];
 };

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

@@ -1 +1 @@
-{"version":3,"file":"eventTypeRequiresActor.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/eventTypeRequiresActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAMtD,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,OAAO,CAAA;IACtB,cAAc,EAAE,OAAO,CAAA;IACvB,eAAe,EAAE,OAAO,CAAA;IACxB,8FAA8F;IAC9F,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAC5B,CAAA;AAkBD,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAsBtE;AAMD,wDAAwD;AACxD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwC1B;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnB;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnB;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnB;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOpB"}
+{"version":3,"file":"eventTypeRequiresActor.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/eventTypeRequiresActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAMtD,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,OAAO,CAAA;IACtB,cAAc,EAAE,OAAO,CAAA;IACvB,eAAe,EAAE,OAAO,CAAA;IACxB,uEAAuE;IACvE,kBAAkB,EAAE,OAAO,CAAA;IAC3B,8FAA8F;IAC9F,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAC5B,CAAA;AAmBD,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAyBtE;AAMD,wDAAwD;AACxD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2C1B;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnB;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnB;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnB;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOpB"}

package/dist/services/achievement/eventTypeRequiresActor.js

@@ -5,6 +5,7 @@ const emptyFlags = {
     requiresActor: false,
     requiresMetric: false,
     requiresSubject: false,
+    snapshotActorTiers: false,
     subjectRelationTo: [],
 };
 function readSubjectRelationTo(value) {
@@ -25,6 +26,7 @@ export function readEventTypeFlags(doc) {
     const hasFlagKeys = 'requiresActor' in row ||
         'requiresMetric' in row ||
         'requiresSubject' in row ||
+        'snapshotActorTiers' in row ||
         'subjectRelationTo' in row ||
         typeof row.slug === 'string';
     if (!hasFlagKeys)
@@ -33,6 +35,7 @@ export function readEventTypeFlags(doc) {
         requiresActor: Boolean(row.requiresActor),
         requiresMetric: Boolean(row.requiresMetric) || row.slug === 'metric.delta',
         requiresSubject: Boolean(row.requiresSubject),
+        snapshotActorTiers: Boolean(row.snapshotActorTiers),
         subjectRelationTo: readSubjectRelationTo(row.subjectRelationTo),
     };
 }
@@ -47,6 +50,7 @@ export async function getEventTypeFlags(args) {
         if ('requiresActor' in row ||
             'requiresMetric' in row ||
             'requiresSubject' in row ||
+            'snapshotActorTiers' in row ||
             'subjectRelationTo' in row ||
             'slug' in row) {
             return embedded;
@@ -65,6 +69,7 @@ export async function getEventTypeFlags(args) {
             requiresActor: true,
             requiresMetric: true,
             requiresSubject: true,
+            snapshotActorTiers: true,
             subjectRelationTo: true,
             slug: true,
         },

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;AAUtD,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,iBAAiB,CAAA;AAQpE,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;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACtC,CAAA;AAgBD,6DAA6D;AAC7D,wBAAsB,SAAS,CAAC,IAAI,EAAE,cAAc,wEA0EnD;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"}
+{"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;AAUtD,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,iBAAiB,CAAA;AASpE,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;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACtC,CAAA;AAgBD,6DAA6D;AAC7D,wBAAsB,SAAS,CAAC,IAAI,EAAE,cAAc,wEAqFnD;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

@@ -8,6 +8,7 @@ import { applyMetricBalanceDelta } from './metricBalances.js';
 import { transitionLogData, transitionToId } from './logData.js';
 import { loadMetricDoc } from './resolveMetricValue.js';
 import { resolveCatalogId } from './resolveCatalog.js';
+import { snapshotActorDerivedTiers } from './actorTierSnapshot.js';
 import { resolveCurrentTier } from './resolveCurrentTier.js';
 import { userScopeWhere } from './where.js';
 async function catalogId(args) {
@@ -65,6 +66,14 @@ export async function recordLog(args) {
             throw new APIError(`This log type only allows subjects from: ${allowed.join(', ')}.`, 400);
         }
     }
+    const actorTiers = flags.snapshotActorTiers && args.actorId
+        ? await snapshotActorDerivedTiers({
+            payload: args.payload,
+            req: args.req,
+            userId: args.actorId,
+            logScopeId: scopeId,
+        })
+        : undefined;
     return args.payload.create({
         collection: collectionOf('logs'),
         data: {
@@ -76,6 +85,7 @@ export async function recordLog(args) {
             change: args.change,
             reason: args.reason,
             ...(subject ? { subject } : {}),
+            ...(actorTiers && actorTiers.length > 0 ? { actorTiers } : {}),
             data: args.data ?? undefined,
         },
         overrideAccess: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dappermountain/payload-plugin-achievements",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "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",