@dappermountain/payload-plugin-achievements 0.2.5 → 0.2.7

package/dist/collections/hooks/preventCatalogDelete.js

@@ -61,7 +61,8 @@ export function preventCatalogDelete(args) {
                 parts.push(`${logs.totalDocs} log row(s)`);
             const rules = await countMatchingLeaves({
                 req,
-                match: (rule) => rule.type === 'event-count' && relationId(rule.eventType) === id,
+                match: (rule) => (rule.type === 'event-count' || rule.type === 'elapsed-since') &&
+                    relationId(rule.eventType) === id,
             });
             if (rules > 0)
                 parts.push(`${rules} rule(s)`);
@@ -75,6 +76,14 @@ export function preventCatalogDelete(args) {
             });
             if (logs.totalDocs > 0)
                 parts.push(`${logs.totalDocs} log row(s)`);
+            const balances = await req.payload.count({
+                collection: collectionOf('metricBalances'),
+                overrideAccess: true,
+                req,
+                where: { metric: { equals: id } },
+            });
+            if (balances.totalDocs > 0)
+                parts.push(`${balances.totalDocs} balance row(s)`);
             const rules = await countMatchingLeaves({
                 req,
                 match: (rule) => rule.type === 'metric-minimum' && relationId(rule.metric) === id,

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAyB/C,qEAAqE;AACrE,wBAAgB,2BAA2B,IAAI,gBAAgB,EAAE,CAMhE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AA2B/C,qEAAqE;AACrE,wBAAgB,2BAA2B,IAAI,gBAAgB,EAAE,CAMhE"}

package/dist/collections/index.js

@@ -5,11 +5,13 @@ import { buildAchievementsCollection } from './Achievements/index.js';
 import { buildEventTypesCollection } from './EventTypes/index.js';
 import { buildGrantsCollection } from './Grants/index.js';
 import { buildLogsCollection } from './Logs/index.js';
+import { buildMetricBalancesCollection } from './MetricBalances/index.js';
 import { buildMetricsCollection } from './Metrics/index.js';
 import { buildTierRequestsCollection } from './TierRequests/index.js';
 import { buildTiersCollection } from './Tiers/index.js';
 const builders = {
     metrics: buildMetricsCollection,
+    metricBalances: buildMetricBalancesCollection,
     eventTypes: buildEventTypesCollection,
     tiers: buildTiersCollection,
     achievements: buildAchievementsCollection,

package/dist/collections/slugs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slugs.d.ts","sourceRoot":"","sources":["../../src/collections/slugs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAErF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,gBAAgB,CAAA;AAEtD;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,wBAAwB,EAAE,MAAM,CASlF,CAAA;AAED,eAAO,MAAM,mBAAmB,iBAAiB,CAAA;AAEjD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAkB1C;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,MAAM,GAAG,KAAK,CAMxF"}
+{"version":3,"file":"slugs.d.ts","sourceRoot":"","sources":["../../src/collections/slugs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAErF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,gBAAgB,CAAA;AAEtD;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,wBAAwB,EAAE,MAAM,CAUlF,CAAA;AAED,eAAO,MAAM,mBAAmB,iBAAiB,CAAA;AAEjD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAkB1C;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,MAAM,GAAG,KAAK,CAMxF"}

package/dist/collections/slugs.js

@@ -18,6 +18,7 @@ export const DEFAULT_COLLECTION_BASE_SLUGS = {
     logs: 'logs',
     eventTypes: 'event-types',
     metrics: 'metrics',
+    metricBalances: 'metric-balances',
 };
 export const DEFAULT_ADMIN_GROUP = 'Achievements';
 /**

package/dist/defaults.d.ts

@@ -2,9 +2,11 @@ import type { AchievementPluginOptions } from './types.js';
 import { resolveCollectionSlugs } from './collections/slugs.js';
 export declare const DEFAULT_USERS_COLLECTION = "users";
 export declare const DEFAULT_ME_ENDPOINT_PATH = "/achievements/me";
+export declare const DEFAULT_LEADERBOARD_ENDPOINT_PATH = "/achievements/leaderboard";
 export declare const DEFAULT_RECONCILE_ENDPOINT_PATH = "/achievements/reconcile";
 export type ResolvedAchievementOptions = Omit<AchievementPluginOptions, 'users' | 'endpoints'> & {
     enabled: boolean;
+    seedSystemCatalog: boolean;
     usersCollectionSlug: string;
     users: {
         includeJoins: boolean;
@@ -15,10 +17,12 @@ export type ResolvedAchievementOptions = Omit<AchievementPluginOptions, 'users'
     adminGroup: string | false;
     endpoints: {
         me: string | false;
+        leaderboard: string | false;
         reconcile: string | false;
     };
 };
 export declare function resolveMeEndpointPath(me?: string | false): string | false;
+export declare function resolveLeaderboardEndpointPath(path?: string | false): string | false;
 export declare function resolveReconcileEndpointPath(path?: string | false): string | false;
 export declare function resolveOptions(options?: AchievementPluginOptions): ResolvedAchievementOptions;
 //# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAEL,sBAAsB,EACvB,MAAM,wBAAwB,CAAA;AAE/B,eAAO,MAAM,wBAAwB,UAAU,CAAA;AAC/C,eAAO,MAAM,wBAAwB,qBAAqB,CAAA;AAC1D,eAAO,MAAM,+BAA+B,4BAA4B,CAAA;AAExE,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,wBAAwB,EAAE,OAAO,GAAG,WAAW,CAAC,GAAG;IAC/F,OAAO,EAAE,OAAO,CAAA;IAChB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,KAAK,EAAE;QAAE,YAAY,EAAE,OAAO,CAAA;KAAE,CAAA;IAChC,+DAA+D;IAC/D,eAAe,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAA;IAC1D,oEAAoE;IACpE,UAAU,EAAE,MAAM,GAAG,KAAK,CAAA;IAC1B,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAA;KAAE,CAAA;CAC7D,CAAA;AAQD,wBAAgB,qBAAqB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAIzE;AAED,wBAAgB,4BAA4B,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAIlF;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,wBAA6B,GAAG,0BAA0B,CAejG"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAEL,sBAAsB,EACvB,MAAM,wBAAwB,CAAA;AAE/B,eAAO,MAAM,wBAAwB,UAAU,CAAA;AAC/C,eAAO,MAAM,wBAAwB,qBAAqB,CAAA;AAC1D,eAAO,MAAM,iCAAiC,8BAA8B,CAAA;AAC5E,eAAO,MAAM,+BAA+B,4BAA4B,CAAA;AAExE,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,wBAAwB,EAAE,OAAO,GAAG,WAAW,CAAC,GAAG;IAC/F,OAAO,EAAE,OAAO,CAAA;IAChB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,KAAK,EAAE;QAAE,YAAY,EAAE,OAAO,CAAA;KAAE,CAAA;IAChC,+DAA+D;IAC/D,eAAe,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAA;IAC1D,oEAAoE;IACpE,UAAU,EAAE,MAAM,GAAG,KAAK,CAAA;IAC1B,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAA;KAAE,CAAA;CAC1F,CAAA;AAQD,wBAAgB,qBAAqB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAIzE;AAED,wBAAgB,8BAA8B,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAIpF;AAED,wBAAgB,4BAA4B,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAIlF;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,wBAA6B,GAAG,0BAA0B,CAiBjG"}

package/dist/defaults.js

@@ -1,6 +1,7 @@
 import { resolveAdminGroup, resolveCollectionSlugs, } from './collections/slugs.js';
 export const DEFAULT_USERS_COLLECTION = 'users';
 export const DEFAULT_ME_ENDPOINT_PATH = '/achievements/me';
+export const DEFAULT_LEADERBOARD_ENDPOINT_PATH = '/achievements/leaderboard';
 export const DEFAULT_RECONCILE_ENDPOINT_PATH = '/achievements/reconcile';
 function normalizeEndpointPath(path, fallback) {
     const trimmed = path.trim();
@@ -15,6 +16,13 @@ export function resolveMeEndpointPath(me) {
         return DEFAULT_ME_ENDPOINT_PATH;
     return normalizeEndpointPath(me, DEFAULT_ME_ENDPOINT_PATH);
 }
+export function resolveLeaderboardEndpointPath(path) {
+    if (path === false)
+        return false;
+    if (path == null)
+        return DEFAULT_LEADERBOARD_ENDPOINT_PATH;
+    return normalizeEndpointPath(path, DEFAULT_LEADERBOARD_ENDPOINT_PATH);
+}
 export function resolveReconcileEndpointPath(path) {
     if (path === false)
         return false;
@@ -26,6 +34,7 @@ export function resolveOptions(options = {}) {
     return {
         ...options,
         enabled: options.enabled !== false,
+        seedSystemCatalog: options.seedSystemCatalog !== false,
         usersCollectionSlug: options.usersCollectionSlug ?? DEFAULT_USERS_COLLECTION,
         users: {
             includeJoins: options.users?.includeJoins !== false,
@@ -34,6 +43,7 @@ export function resolveOptions(options = {}) {
         adminGroup: resolveAdminGroup(options),
         endpoints: {
             me: resolveMeEndpointPath(options.endpoints?.me),
+            leaderboard: resolveLeaderboardEndpointPath(options.endpoints?.leaderboard),
             reconcile: resolveReconcileEndpointPath(options.endpoints?.reconcile),
         },
     };

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/endpoints/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA;AAIhE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,QAAQ,EAAE,CASzF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/endpoints/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA;AAKhE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,QAAQ,EAAE,CAYzF"}

package/dist/endpoints/index.js

@@ -1,3 +1,4 @@
+import { buildLeaderboardEndpoint } from './leaderboard.js';
 import { buildMeEndpoint } from './me.js';
 import { buildReconcileEndpoint } from './reconcile.js';
 export function buildAchievementEndpoints(options) {
@@ -5,6 +6,9 @@ export function buildAchievementEndpoints(options) {
     if (options.endpoints.me !== false) {
         endpoints.push(buildMeEndpoint(options.endpoints.me));
     }
+    if (options.endpoints.leaderboard !== false) {
+        endpoints.push(buildLeaderboardEndpoint(options.endpoints.leaderboard));
+    }
     if (options.endpoints.reconcile !== false) {
         endpoints.push(buildReconcileEndpoint(options.endpoints.reconcile));
     }

package/dist/endpoints/leaderboard.d.ts

@@ -0,0 +1,6 @@
+import type { Endpoint } from 'payload';
+/**
+ * `GET` ranked stored-metric balances. Query: `metric` (required), optional `scope` / `limit` / `page`.
+ */
+export declare function buildLeaderboardEndpoint(path: string): Endpoint;
+//# sourceMappingURL=leaderboard.d.ts.map

package/dist/endpoints/leaderboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard.d.ts","sourceRoot":"","sources":["../../src/endpoints/leaderboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,SAAS,CAAA;AAsBvD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAuC/D"}

package/dist/endpoints/leaderboard.js

@@ -0,0 +1,59 @@
+import { getUserId } from '../access/helpers/index.js';
+import { getMetricLeaderboard } from '../services/achievement/getMetricLeaderboard.js';
+function requestUrl(req) {
+    return req.url ? new URL(req.url, 'http://local') : null;
+}
+function scopeFromRequest(req) {
+    const url = requestUrl(req);
+    const raw = url?.searchParams.get('scope') ?? url?.searchParams.get('scopeId');
+    return raw && raw.length > 0 ? raw : null;
+}
+function positiveInt(raw, fallback) {
+    if (raw == null || raw === '')
+        return fallback;
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n < 1)
+        return fallback;
+    return Math.floor(n);
+}
+/**
+ * `GET` ranked stored-metric balances. Query: `metric` (required), optional `scope` / `limit` / `page`.
+ */
+export function buildLeaderboardEndpoint(path) {
+    return {
+        path,
+        method: 'get',
+        handler: async (req) => {
+            const userId = getUserId(req);
+            if (!userId) {
+                return Response.json({ errors: [{ message: 'Unauthorized' }] }, { status: 401 });
+            }
+            const params = requestUrl(req)?.searchParams;
+            const metric = params?.get('metric')?.trim();
+            if (!metric) {
+                return Response.json({ errors: [{ message: 'Query param `metric` is required.' }] }, { status: 400 });
+            }
+            try {
+                const body = await getMetricLeaderboard({
+                    payload: req.payload,
+                    req,
+                    metric,
+                    scopeId: scopeFromRequest(req),
+                    limit: positiveInt(params?.get('limit') ?? null, 20),
+                    page: positiveInt(params?.get('page') ?? null, 1),
+                });
+                return Response.json(body);
+            }
+            catch (error) {
+                const status = typeof error === 'object' &&
+                    error &&
+                    'status' in error &&
+                    typeof error.status === 'number'
+                    ? error.status
+                    : 500;
+                const message = error instanceof Error ? error.message : 'Leaderboard failed.';
+                return Response.json({ errors: [{ message }] }, { status });
+            }
+        },
+    };
+}

package/dist/extensions/elapsedSinceOptions.d.ts

@@ -0,0 +1,7 @@
+/** Admin select options for elapsed `since` (built-ins + host `metricAnchors` keys). */
+export declare function elapsedSinceSelectOptions(): Array<{
+    label: string;
+    value: string;
+}>;
+export declare function isBuiltinElapsedSince(since: string): boolean;
+//# sourceMappingURL=elapsedSinceOptions.d.ts.map

package/dist/extensions/elapsedSinceOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elapsedSinceOptions.d.ts","sourceRoot":"","sources":["../../src/extensions/elapsedSinceOptions.ts"],"names":[],"mappings":"AAOA,wFAAwF;AACxF,wBAAgB,yBAAyB,IAAI,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAMnF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/extensions/elapsedSinceOptions.js

@@ -0,0 +1,16 @@
+import { getAchievementOptions } from '../options-store.js';
+const BUILTIN_ELAPSED_SINCE_OPTIONS = [
+    { label: 'User created at', value: 'user-created-at' },
+    { label: 'First matching event log', value: 'first-event' },
+];
+/** Admin select options for elapsed `since` (built-ins + host `metricAnchors` keys). */
+export function elapsedSinceSelectOptions() {
+    const custom = Object.keys(getAchievementOptions().extensions?.metricAnchors ?? {});
+    return [
+        ...BUILTIN_ELAPSED_SINCE_OPTIONS.map((option) => ({ ...option })),
+        ...custom.map((key) => ({ label: key, value: key })),
+    ];
+}
+export function isBuiltinElapsedSince(since) {
+    return since === 'user-created-at' || since === 'first-event';
+}

package/dist/index.d.ts

@@ -3,11 +3,11 @@ export type { EngineEventTypeSlug, EngineMetricSlug } from './catalog.js';
 export { achievementPlugin } from './plugin.js';
 export { seedAchievementCatalog, seedAchievements } from './seed/index.js';
 export type { AchievementSeedAchievement, AchievementSeedCatalogRow, AchievementSeedInput, AchievementSeedLocalizedText, AchievementSeedTier, } from './seed/index.js';
-export { evaluateRules, evaluateRuleProgress, collectAchievementCompleteRefs, buildCatalogProgressGroups, getUserProgress, grantAchievement, recordEvent, recordLog, recordMetricChange, reconcileProgression, reconcileUserProgression, releasePendingAchievementReviews, releasePendingTierReviews, resolveCurrentTier, resolveTierProgress, reviewAchievementRequest, submitAchievementRequest, syncTierChangedLog, syncTierProgression, syncCompositeProgression, catalogRef, transitionLogData, transitionToId, validateRuleGroup, validateRuleNode, } from './services/achievement/index.js';
-export type { ResolvedTier, RuleGroup, TierLadderProgress, CatalogProgressGroup, CatalogProgressItem, CatalogRef, TransitionLogData, ReconcileProgressionArgs, ReconcileProgressionResult, ReleaseReviewGateResult, } from './services/achievement/index.js';
-export type { BuiltInEventType, BuiltInRuleType, AchievementCollectionKey, AchievementCollectionOverride, AchievementCollectionsOptions, AchievementEndpointsOptions, AchievementPluginOptions, AchievementRuleType, AchievementScopeConfig, AchievementUsersOptions, } from './types.js';
+export { evaluateRules, evaluateRuleProgress, collectAchievementCompleteRefs, buildCatalogProgressGroups, getUserProgress, getMetricLeaderboard, grantAchievement, loadMetricDoc, recordEvent, recordLog, recordMetricChange, rebuildMetricBalance, rebuildMetricBalancesForUser, reconcileProgression, reconcileUserProgression, releasePendingAchievementReviews, releasePendingTierReviews, resolveCurrentTier, resolveElapsedAnchor, resolveMetricValue, resolveTierProgress, reviewAchievementRequest, submitAchievementRequest, syncTierChangedLog, syncTierProgression, syncCompositeProgression, catalogRef, transitionLogData, transitionToId, validateRuleGroup, validateRuleNode, } from './services/achievement/index.js';
+export type { ResolvedTier, RuleGroup, TierLadderProgress, CatalogProgressGroup, CatalogProgressItem, CatalogRef, TransitionLogData, MetricLeaderboardResult, MetricLeaderboardRow, ReconcileProgressionArgs, ReconcileProgressionResult, ReleaseReviewGateResult, } from './services/achievement/index.js';
+export type { BuiltInEventType, BuiltInRuleType, AchievementCollectionKey, AchievementCollectionOverride, AchievementCollectionsOptions, AchievementEndpointsOptions, AchievementMetricAnchor, AchievementPluginOptions, AchievementRuleType, AchievementScopeConfig, AchievementUsersOptions, } from './types.js';
 export { DEFAULT_COLLECTION_BASE_SLUGS, DEFAULT_COLLECTION_PREFIX, DEFAULT_ADMIN_GROUP } from './collections/slugs.js';
-export { DEFAULT_ME_ENDPOINT_PATH, DEFAULT_RECONCILE_ENDPOINT_PATH } from './defaults.js';
+export { DEFAULT_ME_ENDPOINT_PATH, DEFAULT_LEADERBOARD_ENDPOINT_PATH, DEFAULT_RECONCILE_ENDPOINT_PATH, } from './defaults.js';
 export { collectionOf, slugOf } from './collections/helpers.js';
 export { isAchievementPluginEnabled } from './enabled.js';
 export { descriptionToPlaintext } from './fields/descriptionPlaintext.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,kBAAkB,EAClB,cAAc,GACf,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAC1E,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,8BAA8B,EAC9B,0BAA0B,EAC1B,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EACV,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACtH,OAAO,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAA;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,kBAAkB,EAClB,cAAc,GACf,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAC1E,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,8BAA8B,EAC9B,0BAA0B,EAC1B,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,oBAAoB,EACpB,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EACV,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACtH,OAAO,EACL,wBAAwB,EACxB,iCAAiC,EACjC,+BAA+B,GAChC,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/index.js

@@ -1,9 +1,9 @@
 export { DEFAULT_ACHIEVEMENT_METRIC, DEFAULT_ACHIEVEMENT_METRIC_SLUG, ENGINE_EVENT_TYPES, ENGINE_METRICS, } from './catalog.js';
 export { achievementPlugin } from './plugin.js';
 export { seedAchievementCatalog, seedAchievements } from './seed/index.js';
-export { evaluateRules, evaluateRuleProgress, collectAchievementCompleteRefs, buildCatalogProgressGroups, getUserProgress, grantAchievement, recordEvent, recordLog, recordMetricChange, reconcileProgression, reconcileUserProgression, releasePendingAchievementReviews, releasePendingTierReviews, resolveCurrentTier, resolveTierProgress, reviewAchievementRequest, submitAchievementRequest, syncTierChangedLog, syncTierProgression, syncCompositeProgression, catalogRef, transitionLogData, transitionToId, validateRuleGroup, validateRuleNode, } from './services/achievement/index.js';
+export { evaluateRules, evaluateRuleProgress, collectAchievementCompleteRefs, buildCatalogProgressGroups, getUserProgress, getMetricLeaderboard, grantAchievement, loadMetricDoc, recordEvent, recordLog, recordMetricChange, rebuildMetricBalance, rebuildMetricBalancesForUser, reconcileProgression, reconcileUserProgression, releasePendingAchievementReviews, releasePendingTierReviews, resolveCurrentTier, resolveElapsedAnchor, resolveMetricValue, resolveTierProgress, reviewAchievementRequest, submitAchievementRequest, syncTierChangedLog, syncTierProgression, syncCompositeProgression, catalogRef, transitionLogData, transitionToId, validateRuleGroup, validateRuleNode, } from './services/achievement/index.js';
 export { DEFAULT_COLLECTION_BASE_SLUGS, DEFAULT_COLLECTION_PREFIX, DEFAULT_ADMIN_GROUP } from './collections/slugs.js';
-export { DEFAULT_ME_ENDPOINT_PATH, DEFAULT_RECONCILE_ENDPOINT_PATH } from './defaults.js';
+export { DEFAULT_ME_ENDPOINT_PATH, DEFAULT_LEADERBOARD_ENDPOINT_PATH, DEFAULT_RECONCILE_ENDPOINT_PATH, } from './defaults.js';
 export { collectionOf, slugOf } from './collections/helpers.js';
 export { isAchievementPluginEnabled } from './enabled.js';
 export { descriptionToPlaintext } from './fields/descriptionPlaintext.js';

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,SAAS,CAAA;AAO7C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAE1D;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC3B,UAAS,wBAA6B,KAAG,MA0BzC,CAAA"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,SAAS,CAAA;AAO7C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAE1D;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC3B,UAAS,wBAA6B,KAAG,MAmCzC,CAAA"}

package/dist/plugin.js

@@ -23,9 +23,18 @@ export const achievementPlugin = (options = {}) => (config) => {
             fields: [...(collection.fields ?? []), usersAchievementsGroup(resolved)],
         };
     });
+    const incomingOnInit = config.onInit;
     return {
         ...config,
         collections: [...collections, ...achievementCollections],
         endpoints: [...(config.endpoints ?? []), ...buildAchievementEndpoints(resolved)],
+        onInit: async (payload) => {
+            if (incomingOnInit)
+                await incomingOnInit(payload);
+            if (resolved.seedSystemCatalog) {
+                const { seedAchievementCatalog } = await import('./seed/index.js');
+                await seedAchievementCatalog(payload);
+            }
+        },
     };
 };

package/dist/seed/index.d.ts

@@ -43,6 +43,16 @@ export type AchievementSeedCatalogRow = {
     slug: string;
     scope?: string;
     system?: boolean;
+    /** Metrics — `stored` (default) or `computed`. */
+    kind?: 'stored' | 'computed';
+    /** Computed metrics — v1 only `elapsed`. */
+    compute?: 'elapsed';
+    /** Computed elapsed — unit of the exposed number. */
+    unit?: 'days' | 'hours' | 'minutes';
+    /** Computed elapsed — built-in or host `metricAnchors` key. */
+    since?: string;
+    /** Computed elapsed with `since: first-event` — event type slug. */
+    eventTypeSlug?: string;
     /** Event types only — when true, logging the event requires an actor. */
     requiresActor?: boolean;
     /** Event types only — when true, logging the event requires metric + change. */

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,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,gFAAgF;IAChF,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,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;AAmMD,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

@@ -53,6 +53,18 @@ async function findIdBySlug(payload, key, slug) {
 async function upsertCatalog(payload, key, row) {
     const existing = await findIdBySlug(payload, key, row.slug);
     const nameParts = localizedParts(row.name);
+    let metricComputed = {};
+    if (key === 'metrics') {
+        metricComputed = { kind: row.kind ?? 'stored' };
+        if (row.kind === 'computed') {
+            metricComputed.compute = row.compute ?? 'elapsed';
+            metricComputed.unit = row.unit ?? 'days';
+            metricComputed.since = row.since ?? 'user-created-at';
+            if (row.eventTypeSlug) {
+                metricComputed.eventType = await findIdBySlug(payload, 'eventTypes', row.eventTypeSlug);
+            }
+        }
+    }
     const data = {
         name: nameParts.en ?? row.slug,
         slug: row.slug,
@@ -63,7 +75,7 @@ async function upsertCatalog(payload, key, row) {
                 requiresActor: row.requiresActor ?? false,
                 requiresMetric: row.requiresMetric ?? false,
             }
-            : {}),
+            : metricComputed),
     };
     let id = existing;
     if (existing) {
@@ -119,7 +131,7 @@ async function resolveRuleNode(payload, rule) {
             delete next.achievementSlug;
         }
     }
-    if (next.type === 'event-count') {
+    if (next.type === 'event-count' || next.type === 'elapsed-since') {
         const slug = typeof next.eventTypeSlug === 'string'
             ? next.eventTypeSlug
             : typeof next.eventType === 'string'

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;AA2KlF,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,EAiJjD,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;AAuJlF,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,EA+LjD,CAAA"}

package/dist/services/achievement/builtInRules.js

@@ -1,6 +1,9 @@
 import { collectionOf } from '../../collections/helpers.js';
+import { durationMs } from './duration.js';
 import { relationId } from './relationId.js';
-import { userScopeIncludingUnscopedWhere, userScopeWhere } from './where.js';
+import { resolveElapsedAnchor } from './resolveElapsedAnchor.js';
+import { resolveMetricValue } from './resolveMetricValue.js';
+import { userScopeIncludingUnscopedWhere } from './where.js';
 function clamp01(value) {
     if (!Number.isFinite(value))
         return 0;
@@ -22,22 +25,6 @@ async function resolveMetricId(args) {
     });
     return relationId(found.docs[0]);
 }
-async function metricValue(args) {
-    const logs = await args.payload.find({
-        collection: collectionOf('logs'),
-        depth: 0,
-        limit: 1000,
-        pagination: false,
-        overrideAccess: true,
-        where: {
-            and: [userScopeWhere(args.userId, args.scopeId), { metric: { equals: args.metricId } }],
-        },
-    });
-    return logs.docs.reduce((sum, doc) => {
-        const change = doc.change;
-        return sum + (typeof change === 'number' && Number.isFinite(change) ? change : 0);
-    }, 0);
-}
 async function resolveEventTypeId(args) {
     let eventTypeId = relationId(args.rule.eventType);
     if (eventTypeId) {
@@ -225,22 +212,34 @@ export const builtInRuleTypes = [
     },
     {
         type: 'metric-minimum',
-        async evaluate({ payload, rule, userId, scopeId }) {
+        async evaluate({ payload, req, rule, userId, scopeId }) {
             const resolvedId = await resolveMetricId({ payload, rule });
             if (!resolvedId)
                 return false;
             const minimum = Number(rule.minimum ?? 0);
-            const value = await metricValue({ payload, userId, scopeId, metricId: resolvedId });
+            const value = await resolveMetricValue({
+                payload,
+                req,
+                metric: resolvedId,
+                userId,
+                scopeId,
+            });
             return value >= minimum;
         },
-        async progress({ payload, rule, userId, scopeId }) {
+        async progress({ payload, req, rule, userId, scopeId }) {
             const resolvedId = await resolveMetricId({ payload, rule });
             if (!resolvedId)
                 return 0;
             const minimum = Number(rule.minimum ?? 0);
             if (!(minimum > 0))
                 return 1;
-            const value = await metricValue({ payload, userId, scopeId, metricId: resolvedId });
+            const value = await resolveMetricValue({
+                payload,
+                req,
+                metric: resolvedId,
+                userId,
+                scopeId,
+            });
             return clamp01(value / minimum);
         },
     },
@@ -277,4 +276,43 @@ export const builtInRuleTypes = [
             return clamp01(result.totalDocs / needed);
         },
     },
+    {
+        type: 'elapsed-since',
+        async evaluate({ payload, req, rule, userId, scopeId }) {
+            const needed = durationMs(Number(rule.amount ?? NaN), rule.unit);
+            if (needed == null)
+                return false;
+            const anchor = await resolveElapsedAnchor({
+                payload,
+                req,
+                since: rule.since,
+                eventType: rule.eventType,
+                eventTypeSlug: rule.eventTypeSlug,
+                userId,
+                scopeId,
+            });
+            if (!anchor)
+                return false;
+            return Date.now() - anchor.getTime() >= needed;
+        },
+        async progress({ payload, req, rule, userId, scopeId }) {
+            const needed = durationMs(Number(rule.amount ?? NaN), rule.unit);
+            if (needed == null)
+                return 0;
+            if (!(needed > 0))
+                return 1;
+            const anchor = await resolveElapsedAnchor({
+                payload,
+                req,
+                since: rule.since,
+                eventType: rule.eventType,
+                eventTypeSlug: rule.eventTypeSlug,
+                userId,
+                scopeId,
+            });
+            if (!anchor)
+                return 0;
+            return clamp01((Date.now() - anchor.getTime()) / needed);
+        },
+    },
 ];

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

@@ -0,0 +1,6 @@
+export declare function durationMs(amount: number, unit: unknown): number | null;
+export declare function unitMs(unit: unknown): number | null;
+export declare function parseDate(value: unknown): Date | null;
+/** Whole units elapsed from anchor to `now` (floor). */
+export declare function elapsedUnits(anchor: Date, unit: unknown, now?: Date): number | null;
+//# sourceMappingURL=duration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/duration.ts"],"names":[],"mappings":"AAIA,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAevE;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEnD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAOrD;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAM/F"}

package/dist/services/achievement/duration.js

@@ -0,0 +1,43 @@
+const MS_PER_MINUTE = 60_000;
+const MS_PER_HOUR = 60 * MS_PER_MINUTE;
+const MS_PER_DAY = 24 * MS_PER_HOUR;
+export function durationMs(amount, unit) {
+    if (!(typeof amount === 'number') || !Number.isFinite(amount) || amount < 0)
+        return null;
+    switch (unit) {
+        case 'minutes':
+            return amount * MS_PER_MINUTE;
+        case 'hours':
+            return amount * MS_PER_HOUR;
+        case 'days':
+        case undefined:
+        case null:
+        case '':
+            return amount * MS_PER_DAY;
+        default:
+            return null;
+    }
+}
+export function unitMs(unit) {
+    return durationMs(1, unit ?? 'days');
+}
+export function parseDate(value) {
+    if (value instanceof Date && !Number.isNaN(value.getTime()))
+        return value;
+    if (typeof value === 'string' || typeof value === 'number') {
+        const date = new Date(value);
+        if (!Number.isNaN(date.getTime()))
+            return date;
+    }
+    return null;
+}
+/** Whole units elapsed from anchor to `now` (floor). */
+export function elapsedUnits(anchor, unit, now = new Date()) {
+    const ms = unitMs(unit);
+    if (ms == null || ms <= 0)
+        return null;
+    const delta = now.getTime() - anchor.getTime();
+    if (!Number.isFinite(delta) || delta < 0)
+        return 0;
+    return Math.floor(delta / ms);
+}

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

@@ -0,0 +1,30 @@
+import type { Payload, PayloadRequest } from 'payload';
+export type MetricLeaderboardRow = {
+    user: string;
+    value: number;
+    rank: number;
+};
+export type MetricLeaderboardResult = {
+    docs: MetricLeaderboardRow[];
+    totalDocs: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+    metric: {
+        id: string;
+        slug?: string;
+    };
+    scopeId: string | null;
+};
+/**
+ * Ranked stored-metric balances for a scope (or unscoped board when `scopeId` is null).
+ */
+export declare function getMetricLeaderboard(args: {
+    payload: Payload;
+    req?: PayloadRequest;
+    metric: string;
+    scopeId?: string | null;
+    limit?: number;
+    page?: number;
+}): Promise<MetricLeaderboardResult>;
+//# sourceMappingURL=getMetricLeaderboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getMetricLeaderboard.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/getMetricLeaderboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAS,MAAM,SAAS,CAAA;AAQ7D,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,oBAAoB,EAAE,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACrC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,CAAA;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAyDnC"}