@dappermountain/payload-plugin-achievements 0.1.0 → 0.2.1

package/dist/collections/TierRequests/hooks/prepareTierRequest.js

@@ -0,0 +1,67 @@
+import { APIError } from 'payload';
+import { collectionOf } from '../../../collections/helpers';
+import { CTX_SYSTEM_REQUEST } from '../../../services/achievement/contextFlags';
+import { syncTierChangedLog } from '../../../services/achievement/recordEvent';
+import { relationId } from '../../../services/achievement/relationId';
+function scopeIdOf(data) {
+    return relationId(data?.scope);
+}
+/**
+ * System-created requests (reconcile / progression sync) may set user freely.
+ * Member creates are not used for tiers in v1 — reviewers/system own the flow.
+ */
+export const prepareTierRequest = async ({ data, operation, req, originalDoc, }) => {
+    if (!data)
+        return data;
+    if (operation === 'create') {
+        if (!req.context?.[CTX_SYSTEM_REQUEST]) {
+            const userId = req.user?.id;
+            if (typeof userId !== 'string')
+                throw new APIError('Unauthorized', 401);
+            data.user = userId;
+        }
+        const tierId = relationId(data.tier);
+        if (!tierId)
+            throw new APIError('tier required', 400);
+        const tier = await req.payload.findByID({
+            collection: collectionOf('tiers'),
+            id: tierId,
+            depth: 0,
+            overrideAccess: true,
+            req,
+        });
+        if (!tier)
+            throw new APIError(`Unknown tier: ${tierId}`, 400);
+        if (tier.requiresReview !== true) {
+            throw new APIError('This tier does not require review.', 400);
+        }
+        data.tier = tierId;
+        if (!data.status)
+            data.status = 'pending';
+        return data;
+    }
+    if (operation === 'update' && originalDoc) {
+        data.user = originalDoc.user;
+        data.tier = originalDoc.tier;
+    }
+    return data;
+};
+export const afterTierRequestChange = async ({ doc, operation, previousDoc, req, }) => {
+    const status = doc.status;
+    if (status !== 'approved')
+        return doc;
+    const previousStatus = operation === 'update' ? previousDoc?.status : undefined;
+    if (previousStatus === 'approved')
+        return doc;
+    const userId = relationId(doc.user);
+    if (!userId)
+        return doc;
+    const scopeId = scopeIdOf(doc);
+    await syncTierChangedLog({
+        payload: req.payload,
+        req: req,
+        userId,
+        scopeId,
+    });
+    return doc;
+};

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

@@ -0,0 +1,3 @@
+import type { CollectionConfig } from 'payload';
+export declare function buildTierRequestsCollection(): CollectionConfig;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/TierRequests/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAS,MAAM,SAAS,CAAA;AAOtD,wBAAgB,2BAA2B,IAAI,gBAAgB,CA2C9D"}

package/dist/collections/TierRequests/index.js

@@ -0,0 +1,47 @@
+import { collectionAdmin, collectionOf, optionalFields, slugOf } from '../helpers';
+import { scopeField, userField } from '../fields';
+import { access } from './access';
+import { hooks } from './hooks';
+export function buildTierRequestsCollection() {
+    return {
+        slug: slugOf('tierRequests'),
+        labels: {
+            singular: 'Tier Request',
+            plural: 'Tier Requests',
+        },
+        access: { ...access },
+        hooks,
+        admin: collectionAdmin({
+            useAsTitle: 'id',
+            defaultColumns: ['user', 'tier', 'status', 'createdAt'],
+            description: 'When a member has met a tier’s unlock rules but that tier requires review before it becomes their current tier.',
+        }),
+        fields: [
+            ...optionalFields(scopeField()),
+            userField(),
+            {
+                name: 'tier',
+                type: 'relationship',
+                relationTo: collectionOf('tiers'),
+                required: true,
+                index: true,
+            },
+            {
+                name: 'status',
+                type: 'select',
+                required: true,
+                defaultValue: 'pending',
+                options: [
+                    { label: 'Pending', value: 'pending' },
+                    { label: 'Approved', value: 'approved' },
+                    { label: 'Rejected', value: 'rejected' },
+                ],
+            },
+            {
+                name: 'note',
+                type: 'textarea',
+                admin: { description: 'Optional note from the reviewer.' },
+            },
+        ],
+    };
+}

package/dist/collections/Tiers/hooks/afterRequiresReviewDisabled.d.ts

@@ -0,0 +1,7 @@
+import type { CollectionAfterChangeHook } from 'payload';
+/**
+ * When Requires review is turned off, approve pending tier requests for this step
+ * so each waiting user gets a tier.changed audit via existing request hooks.
+ */
+export declare const afterRequiresReviewDisabled: CollectionAfterChangeHook;
+//# sourceMappingURL=afterRequiresReviewDisabled.d.ts.map

package/dist/collections/Tiers/hooks/afterRequiresReviewDisabled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"afterRequiresReviewDisabled.d.ts","sourceRoot":"","sources":["../../../../src/collections/Tiers/hooks/afterRequiresReviewDisabled.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAOxD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,yBAmBzC,CAAA"}

package/dist/collections/Tiers/hooks/afterRequiresReviewDisabled.js

@@ -0,0 +1,15 @@
+import { didDisableRequiresReview, releasePendingTierReviews, } from '../../../services/achievement/releaseReviewGate';
+/**
+ * When Requires review is turned off, approve pending tier requests for this step
+ * so each waiting user gets a tier.changed audit via existing request hooks.
+ */
+export const afterRequiresReviewDisabled = async ({ doc, operation, previousDoc, req, }) => {
+    if (operation !== 'update')
+        return doc;
+    if (!didDisableRequiresReview(previousDoc, doc)) {
+        return doc;
+    }
+    const tierId = String(doc.id);
+    await releasePendingTierReviews({ req, tierId });
+    return doc;
+};

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/collections/Tiers/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAI/C,eAAO,MAAM,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAE3C,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/collections/Tiers/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAK/C,eAAO,MAAM,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAG3C,CAAA"}

package/dist/collections/Tiers/hooks/index.js

@@ -1,4 +1,6 @@
+import { afterRequiresReviewDisabled } from './afterRequiresReviewDisabled';
 import { validateUnlockRules } from './validateUnlockRules';
 export const hooks = {
     beforeValidate: [validateUnlockRules],
+    afterChange: [afterRequiresReviewDisabled],
 };

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/Tiers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAQ/C,wBAAgB,oBAAoB,IAAI,gBAAgB,CA+EvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/Tiers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAQ/C,wBAAgB,oBAAoB,IAAI,gBAAgB,CAwFvD"}

package/dist/collections/Tiers/index.js

@@ -11,8 +11,8 @@ export function buildTiersCollection() {
         hooks,
         admin: collectionAdmin({
             useAsTitle: 'name',
-            defaultColumns: columnsWithOptionalScope(['name', 'slug', 'rank', 'scope']),
-            description: 'Unlock rules decide when someone reaches this step. Current tier is derived by walking the ladder (lowest rank first) — there is no stored progress row.',
+            defaultColumns: columnsWithOptionalScope(['name', 'slug', 'rank', 'requiresReview', 'scope']),
+            description: 'Unlock rules decide when someone reaches this step. Current tier is derived by walking the ladder (lowest rank first). Tiers with Requires review also need an approved tier request.',
         }),
         fields: [
             ...optionalFields(scopeField()),
@@ -67,12 +67,20 @@ export function buildTiersCollection() {
                         : []),
                 ],
             },
+            {
+                name: 'requiresReview',
+                type: 'checkbox',
+                defaultValue: false,
+                admin: {
+                    description: 'When enabled, unlock rules alone are not enough — an approved tier request is required before this step becomes the member’s current tier. Turning it off approves pending requests for this tier automatically.',
+                },
+            },
             {
                 name: 'unlockRules',
                 type: 'group',
                 label: 'Unlock rules',
                 admin: {
-                    description: 'Rules that must pass to unlock this tier (all-of or any-of). Empty rules mean this step is open. The plugin derives current tier by walking ranks; optional tier.changed logs record moves.',
+                    description: 'Rules that must pass to unlock this tier (all-of or any-of). Empty rules mean this step is open. Current tier is derived by walking ranks; optional tier.changed logs record moves.',
                 },
                 fields: buildRuleTreeFields(),
             },

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;AAuB/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;AAyB/C,qEAAqE;AACrE,wBAAgB,2BAA2B,IAAI,gBAAgB,EAAE,CAMhE"}

package/dist/collections/index.js

@@ -6,6 +6,7 @@ import { buildEventTypesCollection } from './EventTypes/index';
 import { buildGrantsCollection } from './Grants/index';
 import { buildLogsCollection } from './Logs/index';
 import { buildMetricsCollection } from './Metrics/index';
+import { buildTierRequestsCollection } from './TierRequests/index';
 import { buildTiersCollection } from './Tiers/index';
 const builders = {
     metrics: buildMetricsCollection,
@@ -14,6 +15,7 @@ const builders = {
     achievements: buildAchievementsCollection,
     grants: buildGrantsCollection,
     achievementRequests: buildAchievementRequestsCollection,
+    tierRequests: buildTierRequestsCollection,
     logs: buildLogsCollection,
 };
 /** Build achievement collections after plugin options are stored. */

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,UAAU,CAAA;AAElF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,gBAAgB,CAAA;AAEtD;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,wBAAwB,EAAE,MAAM,CAQlF,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,UAAU,CAAA;AAElF;;;;;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"}

package/dist/collections/slugs.js

@@ -14,6 +14,7 @@ export const DEFAULT_COLLECTION_BASE_SLUGS = {
     achievements: 'definitions',
     grants: 'grants',
     achievementRequests: 'requests',
+    tierRequests: 'tier-requests',
     logs: 'logs',
     eventTypes: 'event-types',
     metrics: 'metrics',

package/dist/defaults.d.ts

@@ -2,6 +2,7 @@ import type { AchievementPluginOptions } from './types';
 import { resolveCollectionSlugs } from './collections/slugs';
 export declare const DEFAULT_USERS_COLLECTION = "users";
 export declare const DEFAULT_ME_ENDPOINT_PATH = "/achievements/me";
+export declare const DEFAULT_RECONCILE_ENDPOINT_PATH = "/achievements/reconcile";
 export type ResolvedAchievementOptions = Omit<AchievementPluginOptions, 'users' | 'endpoints'> & {
     enabled: boolean;
     usersCollectionSlug: string;
@@ -14,8 +15,10 @@ export type ResolvedAchievementOptions = Omit<AchievementPluginOptions, 'users'
     adminGroup: string | false;
     endpoints: {
         me: string | false;
+        reconcile: string | false;
     };
 };
 export declare function resolveMeEndpointPath(me?: 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,SAAS,CAAA;AACvD,OAAO,EAEL,sBAAsB,EACvB,MAAM,qBAAqB,CAAA;AAE5B,eAAO,MAAM,wBAAwB,UAAU,CAAA;AAC/C,eAAO,MAAM,wBAAwB,qBAAqB,CAAA;AAE1D,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,CAAA;KAAE,CAAA;CAClC,CAAA;AAQD,wBAAgB,qBAAqB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAIzE;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,wBAA6B,GAAG,0BAA0B,CAcjG"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AACvD,OAAO,EAEL,sBAAsB,EACvB,MAAM,qBAAqB,CAAA;AAE5B,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"}

package/dist/defaults.js

@@ -1,10 +1,11 @@
 import { resolveAdminGroup, resolveCollectionSlugs, } from './collections/slugs';
 export const DEFAULT_USERS_COLLECTION = 'users';
 export const DEFAULT_ME_ENDPOINT_PATH = '/achievements/me';
-function normalizeEndpointPath(path) {
+export const DEFAULT_RECONCILE_ENDPOINT_PATH = '/achievements/reconcile';
+function normalizeEndpointPath(path, fallback) {
     const trimmed = path.trim();
     if (!trimmed)
-        return DEFAULT_ME_ENDPOINT_PATH;
+        return fallback;
     return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
 }
 export function resolveMeEndpointPath(me) {
@@ -12,7 +13,14 @@ export function resolveMeEndpointPath(me) {
         return false;
     if (me == null)
         return DEFAULT_ME_ENDPOINT_PATH;
-    return normalizeEndpointPath(me);
+    return normalizeEndpointPath(me, DEFAULT_ME_ENDPOINT_PATH);
+}
+export function resolveReconcileEndpointPath(path) {
+    if (path === false)
+        return false;
+    if (path == null)
+        return DEFAULT_RECONCILE_ENDPOINT_PATH;
+    return normalizeEndpointPath(path, DEFAULT_RECONCILE_ENDPOINT_PATH);
 }
 export function resolveOptions(options = {}) {
     return {
@@ -26,6 +34,7 @@ export function resolveOptions(options = {}) {
         adminGroup: resolveAdminGroup(options),
         endpoints: {
             me: resolveMeEndpointPath(options.endpoints?.me),
+            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,aAAa,CAAA;AAG7D,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,QAAQ,EAAE,CAGzF"}
+{"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,aAAa,CAAA;AAI7D,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,QAAQ,EAAE,CASzF"}

package/dist/endpoints/index.js

@@ -1,6 +1,12 @@
 import { buildMeEndpoint } from './me';
+import { buildReconcileEndpoint } from './reconcile';
 export function buildAchievementEndpoints(options) {
-    if (options.endpoints.me === false)
-        return [];
-    return [buildMeEndpoint(options.endpoints.me)];
+    const endpoints = [];
+    if (options.endpoints.me !== false) {
+        endpoints.push(buildMeEndpoint(options.endpoints.me));
+    }
+    if (options.endpoints.reconcile !== false) {
+        endpoints.push(buildReconcileEndpoint(options.endpoints.reconcile));
+    }
+    return endpoints;
 }

package/dist/endpoints/reconcile.d.ts

@@ -0,0 +1,8 @@
+import type { Endpoint } from 'payload';
+/**
+ * `POST` repair progression from existing grants / requests.
+ * Body (optional): `{ userId?, scopeId?, achievementId?, achievementSlug?, tierId?, tierSlug?, limit? }`.
+ * Requires host `canReview`.
+ */
+export declare function buildReconcileEndpoint(path: string): Endpoint;
+//# sourceMappingURL=reconcile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/endpoints/reconcile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,SAAS,CAAA;AAoCvD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CA2C7D"}

package/dist/endpoints/reconcile.js

@@ -0,0 +1,73 @@
+import { getUserId } from '../access/helpers/index';
+import { getAchievementOptions } from '../options-store';
+import { reconcileProgression } from '../services/achievement/reconcile';
+function requestUrl(req) {
+    return req.url ? new URL(req.url, 'http://local') : null;
+}
+async function readBody(req) {
+    try {
+        if (typeof req.json === 'function') {
+            const body = await req.json();
+            if (body && typeof body === 'object')
+                return body;
+        }
+    }
+    catch {
+        // empty body
+    }
+    return {};
+}
+function stringParam(body, url, keys) {
+    for (const key of keys) {
+        const fromBody = body[key];
+        if (typeof fromBody === 'string' && fromBody.length > 0)
+            return fromBody;
+        const fromUrl = url?.searchParams.get(key);
+        if (fromUrl && fromUrl.length > 0)
+            return fromUrl;
+    }
+    return null;
+}
+/**
+ * `POST` repair progression from existing grants / requests.
+ * Body (optional): `{ userId?, scopeId?, achievementId?, achievementSlug?, tierId?, tierSlug?, limit? }`.
+ * Requires host `canReview`.
+ */
+export function buildReconcileEndpoint(path) {
+    return {
+        path,
+        method: 'post',
+        handler: async (req) => {
+            const actorId = getUserId(req);
+            if (!actorId || !req.user) {
+                return Response.json({ errors: [{ message: 'Unauthorized' }] }, { status: 401 });
+            }
+            const { canReview } = getAchievementOptions();
+            if (!canReview) {
+                return Response.json({ errors: [{ message: 'Forbidden' }] }, { status: 403 });
+            }
+            const body = await readBody(req);
+            const url = requestUrl(req);
+            const scopeId = stringParam(body, url, ['scopeId', 'scope']);
+            if (!(await canReview(req.user, scopeId))) {
+                return Response.json({ errors: [{ message: 'Forbidden' }] }, { status: 403 });
+            }
+            const limitRaw = body.limit;
+            const limit = typeof limitRaw === 'number' && Number.isFinite(limitRaw)
+                ? Math.floor(limitRaw)
+                : undefined;
+            const result = await reconcileProgression({
+                payload: req.payload,
+                req,
+                scopeId,
+                userId: stringParam(body, url, ['userId', 'user']),
+                achievementId: stringParam(body, url, ['achievementId']),
+                achievementSlug: stringParam(body, url, ['achievementSlug', 'achievement']),
+                tierId: stringParam(body, url, ['tierId']),
+                tierSlug: stringParam(body, url, ['tierSlug', 'tier']),
+                limit,
+            });
+            return Response.json({ ok: true, ...result });
+        },
+    };
+}

package/dist/exports/client.d.ts

@@ -1,4 +1,5 @@
 export { ActorField } from '../admin/ActorField';
 export { MetricChangeField } from '../admin/MetricChangeField';
 export { MetricField } from '../admin/MetricField';
+export { ReconcileProgressionButton } from '../admin/ReconcileProgressionButton';
 //# sourceMappingURL=client.d.ts.map

package/dist/exports/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/exports/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/exports/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAA"}

package/dist/exports/client.js

@@ -1,3 +1,4 @@
 export { ActorField } from '../admin/ActorField';
 export { MetricChangeField } from '../admin/MetricChangeField';
 export { MetricField } from '../admin/MetricField';
+export { ReconcileProgressionButton } from '../admin/ReconcileProgressionButton';

package/dist/index.d.ts

@@ -3,11 +3,11 @@ export type { EngineEventTypeSlug, EngineMetricSlug } from './catalog';
 export { achievementPlugin } from './plugin';
 export { seedAchievementCatalog, seedAchievements } from './seed/index';
 export type { AchievementSeedAchievement, AchievementSeedCatalogRow, AchievementSeedInput, AchievementSeedLocalizedText, AchievementSeedTier, } from './seed/index';
-export { evaluateRules, evaluateRuleProgress, collectAchievementCompleteRefs, buildCatalogProgressGroups, getUserProgress, grantAchievement, recordEvent, recordLog, recordMetricChange, resolveCurrentTier, resolveTierProgress, reviewAchievementRequest, submitAchievementRequest, syncTierChangedLog, validateRuleGroup, validateRuleNode, } from './services/achievement/index';
-export type { ResolvedTier, RuleGroup, TierLadderProgress, CatalogProgressGroup, CatalogProgressItem } from './services/achievement/index';
+export { evaluateRules, evaluateRuleProgress, collectAchievementCompleteRefs, buildCatalogProgressGroups, getUserProgress, grantAchievement, recordEvent, recordLog, recordMetricChange, reconcileProgression, reconcileUserProgression, releasePendingAchievementReviews, releasePendingTierReviews, resolveCurrentTier, resolveTierProgress, reviewAchievementRequest, submitAchievementRequest, syncTierChangedLog, syncTierProgression, syncCompositeProgression, validateRuleGroup, validateRuleNode, } from './services/achievement/index';
+export type { ResolvedTier, RuleGroup, TierLadderProgress, CatalogProgressGroup, CatalogProgressItem, ReconcileProgressionArgs, ReconcileProgressionResult, ReleaseReviewGateResult, } from './services/achievement/index';
 export type { BuiltInEventType, BuiltInRuleType, AchievementCollectionKey, AchievementCollectionOverride, AchievementCollectionsOptions, AchievementEndpointsOptions, AchievementPluginOptions, AchievementRuleType, AchievementScopeConfig, AchievementUsersOptions, } from './types';
 export { DEFAULT_COLLECTION_BASE_SLUGS, DEFAULT_COLLECTION_PREFIX, DEFAULT_ADMIN_GROUP } from './collections/slugs';
-export { DEFAULT_ME_ENDPOINT_PATH } from './defaults';
+export { DEFAULT_ME_ENDPOINT_PATH, DEFAULT_RECONCILE_ENDPOINT_PATH } from './defaults';
 export { collectionOf, slugOf } from './collections/helpers';
 export { isAchievementPluginEnabled } from './enabled';
 //# sourceMappingURL=index.d.ts.map

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,WAAW,CAAA;AAClB,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACvE,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,8BAA8B,EAC9B,0BAA0B,EAC1B,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,8BAA8B,CAAA;AACrC,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAC1I,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACnH,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,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,WAAW,CAAA;AAClB,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACvE,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,cAAc,CAAA;AACrB,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,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,8BAA8B,CAAA;AACrC,YAAY,EACV,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,8BAA8B,CAAA;AACrC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACnH,OAAO,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAA;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -1,8 +1,8 @@
 export { DEFAULT_ACHIEVEMENT_METRIC, DEFAULT_ACHIEVEMENT_METRIC_SLUG, ENGINE_EVENT_TYPES, ENGINE_METRICS, } from './catalog';
 export { achievementPlugin } from './plugin';
 export { seedAchievementCatalog, seedAchievements } from './seed/index';
-export { evaluateRules, evaluateRuleProgress, collectAchievementCompleteRefs, buildCatalogProgressGroups, getUserProgress, grantAchievement, recordEvent, recordLog, recordMetricChange, resolveCurrentTier, resolveTierProgress, reviewAchievementRequest, submitAchievementRequest, syncTierChangedLog, validateRuleGroup, validateRuleNode, } from './services/achievement/index';
+export { evaluateRules, evaluateRuleProgress, collectAchievementCompleteRefs, buildCatalogProgressGroups, getUserProgress, grantAchievement, recordEvent, recordLog, recordMetricChange, reconcileProgression, reconcileUserProgression, releasePendingAchievementReviews, releasePendingTierReviews, resolveCurrentTier, resolveTierProgress, reviewAchievementRequest, submitAchievementRequest, syncTierChangedLog, syncTierProgression, syncCompositeProgression, validateRuleGroup, validateRuleNode, } from './services/achievement/index';
 export { DEFAULT_COLLECTION_BASE_SLUGS, DEFAULT_COLLECTION_PREFIX, DEFAULT_ADMIN_GROUP } from './collections/slugs';
-export { DEFAULT_ME_ENDPOINT_PATH } from './defaults';
+export { DEFAULT_ME_ENDPOINT_PATH, DEFAULT_RECONCILE_ENDPOINT_PATH } from './defaults';
 export { collectionOf, slugOf } from './collections/helpers';
 export { isAchievementPluginEnabled } from './enabled';

package/dist/seed/index.d.ts

@@ -14,6 +14,8 @@ export type AchievementSeedTier = {
     /** Optional media upload id when the host configured `mediaCollection`. */
     image?: string;
     scope?: string;
+    /** When true, unlock rules are not enough — an approved tier request is required. */
+    requiresReview?: boolean;
     /** Bare rule array (AND) or `{ combinator, rules }`. Seed slugs resolved to relationships. */
     unlockRules?: Record<string, unknown>[] | {
         combinator?: string;

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;AAMtC,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,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,CAkLnG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seed/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAMtC,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,CAmLnG"}

package/dist/seed/index.js

@@ -221,6 +221,7 @@ export async function seedAchievements(payload, input) {
             slug: tier.slug,
             rank: tier.rank,
             scope: tier.scope,
+            requiresReview: tier.requiresReview ?? false,
             ...(tier.icon ? { icon: tier.icon } : {}),
             ...(tier.image ? { image: tier.image } : {}),
             unlockRules: { combinator: 'and', rules: [] },

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

@@ -0,0 +1,5 @@
+/** Shared req.context keys for grant / request side-effect guards. */
+export declare const CTX_SKIP_GRANT_SIDE_EFFECTS = "achievementSkipGrantSideEffects";
+export declare const CTX_CASCADING_REVOKE = "achievementCascadingRevoke";
+export declare const CTX_SYSTEM_REQUEST = "achievementSystemRequest";
+//# sourceMappingURL=contextFlags.d.ts.map

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

@@ -0,0 +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"}

package/dist/services/achievement/contextFlags.js

@@ -0,0 +1,4 @@
+/** Shared req.context keys for grant / request side-effect guards. */
+export const CTX_SKIP_GRANT_SIDE_EFFECTS = 'achievementSkipGrantSideEffects';
+export const CTX_CASCADING_REVOKE = 'achievementCascadingRevoke';
+export const CTX_SYSTEM_REQUEST = 'achievementSystemRequest';

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

@@ -0,0 +1,54 @@
+import type { PayloadRequest } from 'payload';
+export { CTX_CASCADING_REVOKE, CTX_SKIP_GRANT_SIDE_EFFECTS, CTX_SYSTEM_REQUEST } from './contextFlags';
+/** Create a grant row only — side effects run in Grants afterChange. */
+export declare function createGrantRow(args: {
+    req: PayloadRequest;
+    userId: string;
+    achievementId: string;
+    scopeId?: string | null;
+    note?: string | null;
+    completedAt?: string;
+}): Promise<Record<string, unknown>>;
+/** Ensure a pending achievement request exists (system / reconcile path). */
+export declare function ensureAchievementRequest(args: {
+    req: PayloadRequest;
+    userId: string;
+    achievementId: string;
+    scopeId?: string | null;
+}): Promise<{
+    doc: Record<string, unknown>;
+    created: boolean;
+}>;
+/**
+ * Auto-grant or open a request for composed achievements whose completion rules pass.
+ */
+export declare function syncCompositeProgression(args: {
+    req: PayloadRequest;
+    userId: string;
+    scopeId: string | null;
+}): Promise<{
+    granted: number;
+    requested: number;
+}>;
+/** Delete grants for composed achievements that no longer pass completion rules. */
+export declare function revokeIncompleteComposites(args: {
+    req: PayloadRequest;
+    userId: string;
+    scopeId: string | null;
+}): Promise<number>;
+export declare function runAfterGrantCreated(args: {
+    req: PayloadRequest;
+    userId: string;
+    achievementId: string;
+    scopeId: string | null;
+    achievementSlug?: string;
+}): Promise<void>;
+export declare function runAfterGrantDeleted(args: {
+    req: PayloadRequest;
+    userId: string;
+    achievementId: string;
+    scopeId: string | null;
+    achievementSlug?: string;
+    cascading?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=grantSideEffects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grantSideEffects.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/grantSideEffects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAS,MAAM,SAAS,CAAA;AAUpD,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAStG,wEAAwE;AACxE,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,cAAc,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA+BnC;AAED,6EAA6E;AAC7E,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,GAAG,EAAE,cAAc,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAuC9D;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,GAAG,EAAE,cAAc,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAsElD;AAED,oFAAoF;AACpF,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,EAAE,cAAc,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiDlB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,cAAc,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,cAAc,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuChB"}