@dappermountain/payload-plugin-achievements 0.2.6 → 0.2.7

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"}

package/dist/services/achievement/getMetricLeaderboard.js

@@ -0,0 +1,62 @@
+import { APIError } from 'payload';
+import { collectionOf } from '../../collections/helpers.js';
+import { getAchievementOptions } from '../../options-store.js';
+import { loadMetricDoc } from './resolveMetricValue.js';
+import { relationId } from './relationId.js';
+/**
+ * Ranked stored-metric balances for a scope (or unscoped board when `scopeId` is null).
+ */
+export async function getMetricLeaderboard(args) {
+    const metric = await loadMetricDoc({
+        payload: args.payload,
+        req: args.req,
+        metric: args.metric,
+    });
+    if (!metric) {
+        throw new APIError('Metric not found.', 404);
+    }
+    if ((metric.kind ?? 'stored') === 'computed') {
+        throw new APIError('Leaderboards are only available for stored metrics.', 400);
+    }
+    const limit = Math.min(Math.max(args.limit ?? 20, 1), 100);
+    const page = Math.max(args.page ?? 1, 1);
+    const scopeId = args.scopeId ?? null;
+    const scopeConfigured = Boolean(getAchievementOptions().scope?.collection);
+    const clauses = [{ metric: { equals: metric.id } }];
+    if (scopeId) {
+        clauses.push({ scope: { equals: scopeId } });
+    }
+    else if (scopeConfigured) {
+        clauses.push({
+            or: [{ scope: { exists: false } }, { scope: { equals: null } }],
+        });
+    }
+    const result = await args.payload.find({
+        collection: collectionOf('metricBalances'),
+        depth: 0,
+        limit,
+        page,
+        overrideAccess: true,
+        req: args.req,
+        sort: '-value,id',
+        where: { and: clauses },
+    });
+    const offset = (page - 1) * limit;
+    const docs = result.docs.map((doc, index) => {
+        const row = doc;
+        return {
+            user: relationId(row.user) ?? String(row.user ?? ''),
+            value: typeof row.value === 'number' && Number.isFinite(row.value) ? row.value : 0,
+            rank: offset + index + 1,
+        };
+    });
+    return {
+        docs,
+        totalDocs: result.totalDocs,
+        page: result.page ?? page,
+        limit,
+        totalPages: result.totalPages ?? Math.max(1, Math.ceil(result.totalDocs / limit)),
+        metric: { id: metric.id, slug: metric.slug },
+        scopeId,
+    };
+}

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

@@ -3,6 +3,11 @@ export type { RuleGroup, AchievementCompleteRef } from './evaluateRules.js';
 export { buildCatalogProgressGroups } from './buildCatalogProgressGroups.js';
 export type { CatalogProgressGroup, CatalogProgressItem } from './buildCatalogProgressGroups.js';
 export { getUserProgress } from './getUserProgress.js';
+export { getMetricLeaderboard } from './getMetricLeaderboard.js';
+export type { MetricLeaderboardResult, MetricLeaderboardRow } from './getMetricLeaderboard.js';
+export { applyMetricBalanceDelta, findMetricBalance, metricBalanceKey, rebuildMetricBalance, rebuildMetricBalancesForUser, } from './metricBalances.js';
+export { resolveMetricValue, loadMetricDoc } from './resolveMetricValue.js';
+export { resolveElapsedAnchor } from './resolveElapsedAnchor.js';
 export { recordEvent, recordLog, recordMetricChange, syncTierChangedLog } from './recordEvent.js';
 export { resolveCurrentTier } from './resolveCurrentTier.js';
 export type { ResolvedTier } from './resolveCurrentTier.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAA;AAC5H,YAAY,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAC5E,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAChG,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AACxE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAC/E,YAAY,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA;AAC1F,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AACrE,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,cAAc,GACf,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAA;AAC5H,YAAY,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAC5E,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAChG,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,YAAY,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAC9F,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AACxE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAC/E,YAAY,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA;AAC1F,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AACrE,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,cAAc,GACf,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA"}

package/dist/services/achievement/index.js

@@ -1,6 +1,10 @@
 export { evaluateRules, evaluateRuleProgress, normalizeRuleGroup, collectAchievementCompleteRefs } from './evaluateRules.js';
 export { buildCatalogProgressGroups } from './buildCatalogProgressGroups.js';
 export { getUserProgress } from './getUserProgress.js';
+export { getMetricLeaderboard } from './getMetricLeaderboard.js';
+export { applyMetricBalanceDelta, findMetricBalance, metricBalanceKey, rebuildMetricBalance, rebuildMetricBalancesForUser, } from './metricBalances.js';
+export { resolveMetricValue, loadMetricDoc } from './resolveMetricValue.js';
+export { resolveElapsedAnchor } from './resolveElapsedAnchor.js';
 export { recordEvent, recordLog, recordMetricChange, syncTierChangedLog } from './recordEvent.js';
 export { resolveCurrentTier } from './resolveCurrentTier.js';
 export { resolveTierProgress } from './resolveTierProgress.js';

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

@@ -0,0 +1,42 @@
+import type { Payload, PayloadRequest } from 'payload';
+export declare function metricBalanceKey(userId: string, scopeId: string | null, metricId: string): string;
+export declare function findMetricBalance(args: {
+    payload: Payload;
+    req?: PayloadRequest;
+    userId: string;
+    scopeId: string | null;
+    metricId: string;
+}): Promise<{
+    id: string;
+    value: number;
+} | null>;
+export declare function applyMetricBalanceDelta(args: {
+    payload: Payload;
+    req?: PayloadRequest;
+    userId: string;
+    scopeId: string | null;
+    metricId: string;
+    change: number;
+}): Promise<{
+    id: string;
+    value: number;
+}>;
+/** Sum metric.delta log changes and upsert the balance projection. */
+export declare function rebuildMetricBalance(args: {
+    payload: Payload;
+    req?: PayloadRequest;
+    userId: string;
+    scopeId?: string | null;
+    metricId: string;
+}): Promise<{
+    id: string;
+    value: number;
+}>;
+/** Rebuild balances for every distinct metric seen in this user’s metric.delta logs. */
+export declare function rebuildMetricBalancesForUser(args: {
+    payload: Payload;
+    req?: PayloadRequest;
+    userId: string;
+    scopeId?: string | null;
+}): Promise<number>;
+//# sourceMappingURL=metricBalances.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metricBalances.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/metricBalances.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAMtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjG;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;CACjB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAehD;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCzC;AAED,sEAAsE;AACtE,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,QAAQ,EAAE,MAAM,CAAA;CACjB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAoDzC;AAED,wFAAwF;AACxF,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,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,MAAM,CAAC,CAgClB"}