@dappermountain/payload-plugin-achievements 0.2.1 → 0.2.3

package/README.md

@@ -30,6 +30,8 @@ bun add @dappermountain/payload-plugin-achievements
 
 Other clients also work (`npm install @dappermountain/payload-plugin-achievements`, etc.).
 
+Next.js hosts should list the package in `transpilePackages` so `'use client'` admin components compile. Host imports stay on the package name; relative `.js` specifiers are internal to this package.
+
 ## Quick start
 
 ```ts
@@ -279,6 +281,18 @@ await runReconcileCli({ config })
 
 Pass catalog **slugs** (or ids) for `type` and `metric`. Metric totals are the sum of `change` on matching logs. Creating or deleting **grants** (Admin or API) writes `achievement.granted` / `achievement.revoked`, syncs composed achievements, and may open tier requests / write `tier.changed`.
 
+Engine log `data` for those system events uses a shared transition envelope:
+
+```ts
+{ from: { id, slug? } | null, to: { id, slug? } | null }
+```
+
+| type | `from` | `to` |
+| --- | --- | --- |
+| `tier.changed` | previous tier (null on first climb) | current tier |
+| `achievement.granted` | `null` | achievement |
+| `achievement.revoked` | achievement | `null` |
+
 Turning **Requires review** off on a definition or tier **approves pending requests** for that row only (each waiting user goes through the existing request hooks).
 
 **Admin:** Grants list includes **Repair progression**, which `POST`s the reconcile endpoint (requires `canReview`).

package/dist/access/index.d.ts

@@ -1,3 +1,3 @@
-export * from './helpers/index';
-export * from './roles/index';
+export * from './helpers/index.js';
+export * from './roles/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/access/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/access/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA"}

package/dist/access/index.js

@@ -1,2 +1,2 @@
-export * from './helpers/index';
-export * from './roles/index';
+export * from './helpers/index.js';
+export * from './roles/index.js';

package/dist/access/roles/index.d.ts

@@ -1,5 +1,5 @@
 import type { AccessArgs } from 'payload';
-import type { AchievementCollectionKey } from '../../types';
+import type { AchievementCollectionKey } from '../../types.js';
 /** Authenticated user may read/write rows tied to themselves. */
 export declare const isSelfUser: (userRelationField?: string) => ({ req, data }: AccessArgs) => boolean | {
     [x: string]: {

package/dist/access/roles/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/access/roles/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAM3D,iEAAiE;AACjE,eAAO,MAAM,UAAU,GACpB,0BAA0B,MAC1B,eAAe,UAAU;;;;CAgBzB,CAAA;AA0BH;;;GAGG;AACH,eAAO,MAAM,UAAU,GACpB,gBAAgB,wBAAwB,MAClC,MAAM,UAAU,qBAMtB,CAAA;AAEH,eAAO,MAAM,eAAe,GAAI,SAAS,UAAU,YAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/access/roles/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAM9D,iEAAiE;AACjE,eAAO,MAAM,UAAU,GACpB,0BAA0B,MAC1B,eAAe,UAAU;;;;CAgBzB,CAAA;AA0BH;;;GAGG;AACH,eAAO,MAAM,UAAU,GACpB,gBAAgB,wBAAwB,MAClC,MAAM,UAAU,qBAMtB,CAAA;AAEH,eAAO,MAAM,eAAe,GAAI,SAAS,UAAU,YAAsB,CAAA"}

package/dist/access/roles/index.js

@@ -1,7 +1,7 @@
-import { collectionOf } from '../../collections/helpers';
-import { getAchievementOptions } from '../../options-store';
-import { relationId } from '../../services/achievement/relationId';
-import { getUserId } from '../helpers/index';
+import { collectionOf } from '../../collections/helpers.js';
+import { getAchievementOptions } from '../../options-store.js';
+import { relationId } from '../../services/achievement/relationId.js';
+import { getUserId } from '../helpers/index.js';
 /** Authenticated user may read/write rows tied to themselves. */
 export const isSelfUser = (userRelationField = 'user') => ({ req, data }) => {
     const userId = getUserId(req);

package/dist/admin/ActorField.js

@@ -2,7 +2,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { RelationshipField, useField } from '@payloadcms/ui';
 import { useEffect } from 'react';
-import { useEventTypeFlags } from './useEventTypeFlags';
+import { useEventTypeFlags } from './useEventTypeFlags.js';
 /** Relationship field that only renders when the selected event type requires an actor. */
 export function ActorField(props) {
     const { eventTypesSlug, ...fieldArgs } = props;

package/dist/admin/MetricChangeField.js

@@ -2,7 +2,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { NumberField, useField, useFormFields } from '@payloadcms/ui';
 import { useEffect } from 'react';
-import { useEventTypeFlags } from './useEventTypeFlags';
+import { useEventTypeFlags } from './useEventTypeFlags.js';
 /** Signed change amount — only when the type adjusts a metric and a metric is selected. */
 export function MetricChangeField(props) {
     const { eventTypesSlug, ...fieldArgs } = props;

package/dist/admin/MetricField.js

@@ -2,7 +2,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { RelationshipField, useField } from '@payloadcms/ui';
 import { useEffect } from 'react';
-import { useEventTypeFlags } from './useEventTypeFlags';
+import { useEventTypeFlags } from './useEventTypeFlags.js';
 /** Metric relationship — only for event types that adjust a score. */
 export function MetricField(props) {
     const { eventTypesSlug, ...fieldArgs } = props;

package/dist/cli/index.d.ts

@@ -1,3 +1,3 @@
-export { parseReconcileCliArgs, printReconcileCliHelp, runReconcileCli, } from './reconcile';
-export type { ReconcileCliFilters } from './reconcile';
+export { parseReconcileCliArgs, printReconcileCliHelp, runReconcileCli, } from './reconcile.js';
+export type { ReconcileCliFilters } from './reconcile.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,GAChB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,GAChB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/cli/index.js

@@ -1 +1 @@
-export { parseReconcileCliArgs, printReconcileCliHelp, runReconcileCli, } from './reconcile';
+export { parseReconcileCliArgs, printReconcileCliHelp, runReconcileCli, } from './reconcile.js';

package/dist/cli/reconcile.d.ts

@@ -1,5 +1,5 @@
 import { type SanitizedConfig } from 'payload';
-import { type ReconcileProgressionArgs, type ReconcileProgressionResult } from '../services/achievement/reconcile';
+import { type ReconcileProgressionArgs, type ReconcileProgressionResult } from '../services/achievement/reconcile.js';
 export type ReconcileCliFilters = Omit<ReconcileProgressionArgs, 'payload' | 'req'>;
 /** Parse `--user`, `--achievement`, `--tier`, `--scope`, `--limit` (ids or slugs). */
 export declare function parseReconcileCliArgs(argv?: string[]): ReconcileCliFilters;

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

@@ -1 +1 @@
-{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/cli/reconcile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAE1D,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAChC,MAAM,mCAAmC,CAAA;AAE1C,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,KAAK,CAAC,CAAA;AA2BnF,sFAAsF;AACtF,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,mBAAmB,CAUjG;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAc5C;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAClD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAC7B,kFAAkF;IAClF,IAAI,CAAC,EAAE,OAAO,CAAA;CACf,GAAG,OAAO,CAAC,0BAA0B,CAAC,CA2BtC"}
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/cli/reconcile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAE1D,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAChC,MAAM,sCAAsC,CAAA;AAE7C,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,KAAK,CAAC,CAAA;AA2BnF,sFAAsF;AACtF,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,mBAAmB,CAUjG;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAc5C;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAClD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAC7B,kFAAkF;IAClF,IAAI,CAAC,EAAE,OAAO,CAAA;CACf,GAAG,OAAO,CAAC,0BAA0B,CAAC,CA2BtC"}

package/dist/cli/reconcile.js

@@ -1,5 +1,5 @@
 import { getPayload } from 'payload';
-import { reconcileProgression, } from '../services/achievement/reconcile';
+import { reconcileProgression, } from '../services/achievement/reconcile.js';
 function readFlag(argv, names) {
     for (const name of names) {
         const prefix = `${name}=`;

package/dist/collections/AchievementRequests/access/index.js

@@ -1,5 +1,5 @@
-import { isAuthenticated, requireOne } from '../../../access/index';
-import { isReviewer, isSelfUser } from '../../../access/roles/index';
+import { isAuthenticated, requireOne } from '../../../access/index.js';
+import { isReviewer, isSelfUser } from '../../../access/roles/index.js';
 export const access = {
     read: requireOne(isReviewer('achievementRequests'), isSelfUser('user')),
     create: isAuthenticated,

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

@@ -1,4 +1,4 @@
-import { grantOnApprovedRequest, prepareAchievementRequest } from './prepareAchievementRequest';
+import { grantOnApprovedRequest, prepareAchievementRequest } from './prepareAchievementRequest.js';
 export const hooks = {
     beforeValidate: [prepareAchievementRequest],
     afterChange: [grantOnApprovedRequest],

package/dist/collections/AchievementRequests/hooks/prepareAchievementRequest.js

@@ -1,9 +1,9 @@
 import { APIError } from 'payload';
-import { collectionOf } from '../../../collections/helpers';
-import { CTX_SYSTEM_REQUEST } from '../../../services/achievement/contextFlags';
-import { evaluateRules, ruleGroupHasProgressRequirements } from '../../../services/achievement/evaluateRules';
-import { grantAchievement } from '../../../services/achievement/submitAchievementRequest';
-import { relationId } from '../../../services/achievement/relationId';
+import { collectionOf } from '../../../collections/helpers.js';
+import { CTX_SYSTEM_REQUEST } from '../../../services/achievement/contextFlags.js';
+import { evaluateRules, ruleGroupHasProgressRequirements } from '../../../services/achievement/evaluateRules.js';
+import { grantAchievement } from '../../../services/achievement/submitAchievementRequest.js';
+import { relationId } from '../../../services/achievement/relationId.js';
 function scopeIdOf(data) {
     const scope = data?.scope;
     if (!scope)

package/dist/collections/AchievementRequests/index.js

@@ -1,7 +1,7 @@
-import { collectionAdmin, collectionOf, optionalFields, slugOf } from '../helpers';
-import { scopeField, userField } from '../fields';
-import { access } from './access';
-import { hooks } from './hooks';
+import { collectionAdmin, collectionOf, optionalFields, slugOf } from '../helpers.js';
+import { scopeField, userField } from '../fields/index.js';
+import { access } from './access/index.js';
+import { hooks } from './hooks/index.js';
 export function buildAchievementRequestsCollection() {
     return {
         slug: slugOf('achievementRequests'),

package/dist/collections/Achievements/access/index.js

@@ -1,2 +1,2 @@
-import { definitionAccess } from '../../access/definitions';
+import { definitionAccess } from '../../access/definitions.js';
 export const access = definitionAccess('achievements');

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

@@ -1,4 +1,4 @@
-import { didDisableRequiresReview, releasePendingAchievementReviews, } from '../../../services/achievement/releaseReviewGate';
+import { didDisableRequiresReview, releasePendingAchievementReviews, } from '../../../services/achievement/releaseReviewGate.js';
 /**
  * When Requires review is turned off, approve pending requests for this achievement
  * so each waiting user is granted via existing request hooks.

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

@@ -1,5 +1,5 @@
-import { afterRequiresReviewDisabled } from './afterRequiresReviewDisabled';
-import { validateAchievementRules } from './validateEligibilityRules';
+import { afterRequiresReviewDisabled } from './afterRequiresReviewDisabled.js';
+import { validateAchievementRules } from './validateEligibilityRules.js';
 export const hooks = {
     beforeValidate: [validateAchievementRules],
     afterChange: [afterRequiresReviewDisabled],

package/dist/collections/Achievements/hooks/validateEligibilityRules.js

@@ -1,4 +1,4 @@
-import { assertRuleGroupValid } from '../../../services/achievement/validateRules';
+import { assertRuleGroupValid } from '../../../services/achievement/validateRules.js';
 export const validateAchievementRules = ({ data }) => {
     if (!data)
         return data;

package/dist/collections/Achievements/index.js

@@ -1,7 +1,7 @@
-import { buildRuleTreeFields, localizedDescriptionField, localizedNameField, scopeField } from '../fields';
-import { collectionAdmin, columnsWithOptionalScope, optionalFields, slugOf } from '../helpers';
-import { access } from './access';
-import { hooks } from './hooks';
+import { buildRuleTreeFields, localizedDescriptionField, localizedNameField, scopeField } from '../fields/index.js';
+import { collectionAdmin, columnsWithOptionalScope, optionalFields, slugOf } from '../helpers.js';
+import { access } from './access/index.js';
+import { hooks } from './hooks/index.js';
 export function buildAchievementsCollection() {
     return {
         slug: slugOf('achievements'),

package/dist/collections/EventTypes/access/index.js

@@ -1,2 +1,2 @@
-import { definitionAccess } from '../../access/definitions';
+import { definitionAccess } from '../../access/definitions.js';
 export const access = definitionAccess('eventTypes');

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

@@ -1,5 +1,5 @@
-import { lockSystemCatalogFields } from '../../hooks/lockSystemCatalogFields';
-import { preventCatalogDelete } from '../../hooks/preventCatalogDelete';
+import { lockSystemCatalogFields } from '../../hooks/lockSystemCatalogFields.js';
+import { preventCatalogDelete } from '../../hooks/preventCatalogDelete.js';
 export const hooks = {
     beforeChange: [lockSystemCatalogFields],
     beforeDelete: [preventCatalogDelete({ kind: 'eventType' })],

package/dist/collections/EventTypes/index.js

@@ -1,7 +1,7 @@
-import { collectionAdmin, collectionOf, columnsWithOptionalScope, optionalFields, slugOf } from '../helpers';
-import { localizedNameField, scopeField } from '../fields';
-import { access } from './access';
-import { hooks } from './hooks';
+import { collectionAdmin, collectionOf, columnsWithOptionalScope, optionalFields, slugOf } from '../helpers.js';
+import { localizedNameField, scopeField } from '../fields/index.js';
+import { access } from './access/index.js';
+import { hooks } from './hooks/index.js';
 export function buildEventTypesCollection() {
     return {
         slug: slugOf('eventTypes'),

package/dist/collections/Grants/access/index.js

@@ -1,5 +1,5 @@
-import { requireOne } from '../../../access/index';
-import { isReviewer, isSelfUser } from '../../../access/roles/index';
+import { requireOne } from '../../../access/index.js';
+import { isReviewer, isSelfUser } from '../../../access/roles/index.js';
 export const access = {
     read: requireOne(isReviewer('grants'), isSelfUser('user')),
     create: requireOne(isReviewer('grants')),

package/dist/collections/Grants/hooks/afterGrantMutation.js

@@ -1,6 +1,6 @@
-import { CTX_CASCADING_REVOKE, CTX_SKIP_GRANT_SIDE_EFFECTS, runAfterGrantCreated, runAfterGrantDeleted } from '../../../services/achievement/grantSideEffects';
-import { relationId } from '../../../services/achievement/relationId';
-import { collectionOf } from '../../../collections/helpers';
+import { CTX_CASCADING_REVOKE, CTX_SKIP_GRANT_SIDE_EFFECTS, runAfterGrantCreated, runAfterGrantDeleted } from '../../../services/achievement/grantSideEffects.js';
+import { relationId } from '../../../services/achievement/relationId.js';
+import { collectionOf } from '../../../collections/helpers.js';
 async function achievementSlug(req, achievementId) {
     try {
         const def = (await req.payload.findByID({

package/dist/collections/Grants/hooks/ensureUniqueGrant.js

@@ -1,6 +1,6 @@
 import { APIError } from 'payload';
-import { collectionOf } from '../../helpers';
-import { relationId } from '../../../services/achievement/relationId';
+import { collectionOf } from '../../helpers.js';
+import { relationId } from '../../../services/achievement/relationId.js';
 /** Reject a second grant of the same achievement for the same user (+ scope). */
 export const ensureUniqueGrant = async ({ data, originalDoc, operation, req, }) => {
     if (!req?.payload || !data)

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

@@ -1,6 +1,6 @@
-import { ensureUniqueGrant } from './ensureUniqueGrant';
-import { fillGrantTitle, setGrantTitle } from './setGrantTitle';
-import { afterGrantChange, afterGrantDelete } from './afterGrantMutation';
+import { ensureUniqueGrant } from './ensureUniqueGrant.js';
+import { fillGrantTitle, setGrantTitle } from './setGrantTitle.js';
+import { afterGrantChange, afterGrantDelete } from './afterGrantMutation.js';
 export const hooks = {
     beforeValidate: [ensureUniqueGrant],
     beforeChange: [setGrantTitle],

package/dist/collections/Grants/hooks/setGrantTitle.js

@@ -1,5 +1,5 @@
-import { relationId } from '../../../services/achievement/relationId';
-import { collectionOf } from '../../helpers';
+import { relationId } from '../../../services/achievement/relationId.js';
+import { collectionOf } from '../../helpers.js';
 async function achievementName(args) {
     const id = relationId(args.value);
     if (!id)

package/dist/collections/Grants/index.js

@@ -1,8 +1,8 @@
-import { collectionAdmin, collectionOf, columnsWithOptionalScope, optionalFields, slugOf } from '../helpers';
-import { scopeField, userField } from '../fields';
-import { getAchievementOptions } from '../../options-store';
-import { access } from './access';
-import { hooks } from './hooks';
+import { collectionAdmin, collectionOf, columnsWithOptionalScope, optionalFields, slugOf } from '../helpers.js';
+import { scopeField, userField } from '../fields/index.js';
+import { getAchievementOptions } from '../../options-store.js';
+import { access } from './access/index.js';
+import { hooks } from './hooks/index.js';
 export function buildGrantsCollection() {
     const reconcilePath = getAchievementOptions().endpoints?.reconcile;
     const apiPath = typeof reconcilePath === 'string' && reconcilePath.length > 0

package/dist/collections/Logs/access/index.js

@@ -1,5 +1,5 @@
-import { requireOne } from '../../../access/index';
-import { isReviewer, isSelfUser } from '../../../access/roles/index';
+import { requireOne } from '../../../access/index.js';
+import { isReviewer, isSelfUser } from '../../../access/roles/index.js';
 export const access = {
     read: requireOne(isReviewer('logs'), isSelfUser('user')),
     create: requireOne(isReviewer('logs')),

package/dist/collections/Logs/fields/validators.js

@@ -1,5 +1,5 @@
-import { eventTypeRequiresActor, eventTypeRequiresMetric, } from '../../../services/achievement/eventTypeRequiresActor';
-import { relationId } from '../../../services/achievement/relationId';
+import { eventTypeRequiresActor, eventTypeRequiresMetric, } from '../../../services/achievement/eventTypeRequiresActor.js';
+import { relationId } from '../../../services/achievement/relationId.js';
 export const validateActor = async (value, { data, req }) => {
     if (!req?.payload)
         return true;

package/dist/collections/Logs/hooks/ensureTypeRequirements.js

@@ -1,6 +1,6 @@
 import { APIError } from 'payload';
-import { eventTypeRequiresActor, eventTypeRequiresMetric, } from '../../../services/achievement/eventTypeRequiresActor';
-import { relationId } from '../../../services/achievement/relationId';
+import { eventTypeRequiresActor, eventTypeRequiresMetric, } from '../../../services/achievement/eventTypeRequiresActor.js';
+import { relationId } from '../../../services/achievement/relationId.js';
 export const ensureTypeRequirements = async ({ data, req }) => {
     if (!data)
         return data;

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

@@ -1,4 +1,4 @@
-import { ensureTypeRequirements } from './ensureTypeRequirements';
+import { ensureTypeRequirements } from './ensureTypeRequirements.js';
 export const hooks = {
     beforeValidate: [ensureTypeRequirements],
 };

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

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

package/dist/collections/Logs/index.js

@@ -1,10 +1,10 @@
-import { catalogFilterOptions } from '../fields/catalogFilter';
-import { collectionAdmin, collectionOf, optionalFields, slugOf } from '../helpers';
-import { getAchievementOptions } from '../../options-store';
-import { scopeField, userField } from '../fields';
-import { access } from './access';
-import { validateActor, validateChange, validateMetric } from './fields/validators';
-import { hooks } from './hooks';
+import { catalogFilterOptions } from '../fields/catalogFilter.js';
+import { collectionAdmin, collectionOf, optionalFields, slugOf } from '../helpers.js';
+import { getAchievementOptions } from '../../options-store.js';
+import { scopeField, userField } from '../fields/index.js';
+import { access } from './access/index.js';
+import { validateActor, validateChange, validateMetric } from './fields/validators.js';
+import { hooks } from './hooks/index.js';
 /** Append-only occurrence log. `type` / `metric` are catalog relationships. */
 export function buildLogsCollection() {
     const users = getAchievementOptions().usersCollectionSlug ?? 'users';
@@ -104,7 +104,9 @@ export function buildLogsCollection() {
                     {
                         name: 'data',
                         type: 'json',
-                        admin: { description: 'Any extra structured details.' },
+                        admin: {
+                            description: 'Engine transition envelope: `{ from, to }` each `{ id, slug? }` or null (tier.changed, achievement.granted/revoked). Hosts may add extra keys.',
+                        },
                     },
                 ],
             },

package/dist/collections/Metrics/access/index.js

@@ -1,2 +1,2 @@
-import { definitionAccess } from '../../access/definitions';
+import { definitionAccess } from '../../access/definitions.js';
 export const access = definitionAccess('metrics');

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

@@ -1,5 +1,5 @@
-import { lockSystemCatalogFields } from '../../hooks/lockSystemCatalogFields';
-import { preventCatalogDelete } from '../../hooks/preventCatalogDelete';
+import { lockSystemCatalogFields } from '../../hooks/lockSystemCatalogFields.js';
+import { preventCatalogDelete } from '../../hooks/preventCatalogDelete.js';
 export const hooks = {
     beforeChange: [lockSystemCatalogFields],
     beforeDelete: [preventCatalogDelete({ kind: 'metric' })],

package/dist/collections/Metrics/index.js

@@ -1,7 +1,7 @@
-import { collectionAdmin, columnsWithOptionalScope, optionalFields, slugOf } from '../helpers';
-import { localizedNameField, scopeField } from '../fields';
-import { access } from './access';
-import { hooks } from './hooks';
+import { collectionAdmin, columnsWithOptionalScope, optionalFields, slugOf } from '../helpers.js';
+import { localizedNameField, scopeField } from '../fields/index.js';
+import { access } from './access/index.js';
+import { hooks } from './hooks/index.js';
 export function buildMetricsCollection() {
     return {
         slug: slugOf('metrics'),

package/dist/collections/TierRequests/access/index.js

@@ -1,5 +1,5 @@
-import { isAuthenticated, requireOne } from '../../../access/index';
-import { isReviewer, isSelfUser } from '../../../access/roles/index';
+import { isAuthenticated, requireOne } from '../../../access/index.js';
+import { isReviewer, isSelfUser } from '../../../access/roles/index.js';
 export const access = {
     read: requireOne(isReviewer('tierRequests'), isSelfUser('user')),
     create: isAuthenticated,

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

@@ -1,4 +1,4 @@
-import { afterTierRequestChange, prepareTierRequest } from './prepareTierRequest';
+import { afterTierRequestChange, prepareTierRequest } from './prepareTierRequest.js';
 export const hooks = {
     beforeValidate: [prepareTierRequest],
     afterChange: [afterTierRequestChange],

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

@@ -1,8 +1,8 @@
 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';
+import { collectionOf } from '../../../collections/helpers.js';
+import { CTX_SYSTEM_REQUEST } from '../../../services/achievement/contextFlags.js';
+import { syncTierChangedLog } from '../../../services/achievement/recordEvent.js';
+import { relationId } from '../../../services/achievement/relationId.js';
 function scopeIdOf(data) {
     return relationId(data?.scope);
 }

package/dist/collections/TierRequests/index.js

@@ -1,7 +1,7 @@
-import { collectionAdmin, collectionOf, optionalFields, slugOf } from '../helpers';
-import { scopeField, userField } from '../fields';
-import { access } from './access';
-import { hooks } from './hooks';
+import { collectionAdmin, collectionOf, optionalFields, slugOf } from '../helpers.js';
+import { scopeField, userField } from '../fields/index.js';
+import { access } from './access/index.js';
+import { hooks } from './hooks/index.js';
 export function buildTierRequestsCollection() {
     return {
         slug: slugOf('tierRequests'),

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

@@ -1,2 +1,2 @@
-import { definitionAccess } from '../../access/definitions';
+import { definitionAccess } from '../../access/definitions.js';
 export const access = definitionAccess('tiers');

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

@@ -1,4 +1,4 @@
-import { didDisableRequiresReview, releasePendingTierReviews, } from '../../../services/achievement/releaseReviewGate';
+import { didDisableRequiresReview, releasePendingTierReviews, } from '../../../services/achievement/releaseReviewGate.js';
 /**
  * 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.

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

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

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

@@ -1,4 +1,4 @@
-import { assertRuleGroupValid } from '../../../services/achievement/validateRules';
+import { assertRuleGroupValid } from '../../../services/achievement/validateRules.js';
 export const validateUnlockRules = ({ data }) => {
     if (!data)
         return data;

package/dist/collections/Tiers/index.js

@@ -1,8 +1,8 @@
-import { collectionAdmin, columnsWithOptionalScope, optionalFields, slugOf } from '../helpers';
-import { buildRuleTreeFields, localizedDescriptionField, localizedNameField, scopeField } from '../fields';
-import { getAchievementOptions } from '../../options-store';
-import { access } from './access';
-import { hooks } from './hooks';
+import { collectionAdmin, columnsWithOptionalScope, optionalFields, slugOf } from '../helpers.js';
+import { buildRuleTreeFields, localizedDescriptionField, localizedNameField, scopeField } from '../fields/index.js';
+import { getAchievementOptions } from '../../options-store.js';
+import { access } from './access/index.js';
+import { hooks } from './hooks/index.js';
 export function buildTiersCollection() {
     const mediaCollection = getAchievementOptions().mediaCollection?.trim();
     return {

package/dist/collections/access/definitions.d.ts

@@ -1,5 +1,5 @@
 import type { CollectionConfig } from 'payload';
-import type { AchievementCollectionKey } from '../../types';
+import type { AchievementCollectionKey } from '../../types.js';
 /** Catalog / definition collections (writes gated by `canReview`). */
 export declare function definitionAccess(collectionKey: AchievementCollectionKey): NonNullable<CollectionConfig['access']>;
 //# sourceMappingURL=definitions.d.ts.map

package/dist/collections/access/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/collections/access/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAI3D,sEAAsE;AACtE,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,wBAAwB,GACtC,WAAW,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAOzC"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/collections/access/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAI9D,sEAAsE;AACtE,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,wBAAwB,GACtC,WAAW,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAOzC"}

package/dist/collections/access/definitions.js

@@ -1,5 +1,5 @@
-import { isAuthenticated, requireOne } from '../../access/index';
-import { isReviewer } from '../../access/roles/index';
+import { isAuthenticated, requireOne } from '../../access/index.js';
+import { isReviewer } from '../../access/roles/index.js';
 /** Catalog / definition collections (writes gated by `canReview`). */
 export function definitionAccess(collectionKey) {
     return {

package/dist/collections/applyOverrides.d.ts

@@ -1,5 +1,5 @@
 import type { CollectionConfig } from 'payload';
-import type { AchievementCollectionOverride } from '../types';
+import type { AchievementCollectionOverride } from '../types.js';
 /**
  * Layer host overrides on a plugin collection:
  * - `access` / `admin` / `labels`: shallow merge (host wins per key)

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

@@ -1 +1 @@
-{"version":3,"file":"applyOverrides.d.ts","sourceRoot":"","sources":["../../src/collections/applyOverrides.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAA;AAE7D;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,CAAC,EAAE,6BAA6B,GACvC,gBAAgB,CA6BlB"}
+{"version":3,"file":"applyOverrides.d.ts","sourceRoot":"","sources":["../../src/collections/applyOverrides.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA;AAEhE;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,CAAC,EAAE,6BAA6B,GACvC,gBAAgB,CA6BlB"}

package/dist/collections/fields/catalogFilter.js

@@ -1,4 +1,4 @@
-import { relationId } from '../../services/achievement/relationId';
+import { relationId } from '../../services/achievement/relationId.js';
 /** Relationship picker: same scope as the parent doc, or unscoped (global) catalog rows. */
 export function catalogFilterOptions({ data }) {
     const scopeId = relationId(data?.scope);

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

@@ -1,6 +1,6 @@
-export { scopeField } from './scopeField';
-export { userField } from './userField';
-export { buildRuleRowFields, buildRuleTreeFields } from './ruleFields';
-export { usersAchievementsGroup } from './usersAchievementsGroup';
-export { localizedDescriptionField, localizedNameField } from './localizedText';
+export { scopeField } from './scopeField.js';
+export { userField } from './userField.js';
+export { buildRuleRowFields, buildRuleTreeFields } from './ruleFields.js';
+export { usersAchievementsGroup } from './usersAchievementsGroup.js';
+export { localizedDescriptionField, localizedNameField } from './localizedText.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/fields/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/fields/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA"}