@dappermountain/payload-plugin-achievements 0.1.0

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

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

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

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

package/dist/collections/fields/index.js

@@ -0,0 +1,5 @@
+export { scopeField } from './scopeField';
+export { userField } from './userField';
+export { buildRuleRowFields, buildRuleTreeFields } from './ruleFields';
+export { usersAchievementsGroup } from './usersAchievementsGroup';
+export { localizedDescriptionField, localizedNameField } from './localizedText';

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

@@ -0,0 +1,10 @@
+import type { Field } from 'payload';
+/**
+ * Display copy for catalog rows. Localized when the host enables Payload `localization`.
+ * Slugs stay non-localized identifiers for rules and code.
+ */
+export declare function localizedNameField(admin?: {
+    width?: string;
+}): Field;
+export declare function localizedDescriptionField(): Field;
+//# sourceMappingURL=localizedText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"localizedText.d.ts","sourceRoot":"","sources":["../../../src/collections/fields/localizedText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAQpE;AAED,wBAAgB,yBAAyB,IAAI,KAAK,CAMjD"}

package/dist/collections/fields/localizedText.js

@@ -0,0 +1,20 @@
+/**
+ * Display copy for catalog rows. Localized when the host enables Payload `localization`.
+ * Slugs stay non-localized identifiers for rules and code.
+ */
+export function localizedNameField(admin) {
+    return {
+        name: 'name',
+        type: 'text',
+        required: true,
+        localized: true,
+        ...(admin ? { admin } : {}),
+    };
+}
+export function localizedDescriptionField() {
+    return {
+        name: 'description',
+        type: 'textarea',
+        localized: true,
+    };
+}

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

@@ -0,0 +1,8 @@
+import type { Field } from 'payload';
+/**
+ * Top-level rule group: combinator + rules, with one nested group level.
+ */
+export declare function buildRuleTreeFields(): Field[];
+/** @deprecated Use {@link buildRuleTreeFields}. */
+export declare function buildRuleRowFields(): Field[];
+//# sourceMappingURL=ruleFields.d.ts.map

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

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

package/dist/collections/fields/ruleFields.js

@@ -0,0 +1,123 @@
+import { catalogFilterOptions } from './catalogFilter';
+import { collectionOf } from '../helpers';
+function combinatorField(visibleWhenGroup) {
+    return {
+        name: 'combinator',
+        type: 'select',
+        required: true,
+        defaultValue: 'and',
+        options: [
+            { label: 'All of these', value: 'and' },
+            { label: 'Any of these', value: 'or' },
+        ],
+        ...(visibleWhenGroup
+            ? { admin: { condition: (_, sibling) => sibling?.type === 'group' } }
+            : {}),
+    };
+}
+function ruleTypeSelect(includeGroup) {
+    return {
+        name: 'type',
+        type: 'select',
+        required: true,
+        options: [
+            { label: 'Tier at least', value: 'tier-at-least' },
+            { label: 'Achievement complete', value: 'achievement-complete' },
+            { label: 'Metric minimum', value: 'metric-minimum' },
+            { label: 'Event count', value: 'event-count' },
+            ...(includeGroup ? [{ label: 'Group', value: 'group' }] : []),
+        ],
+    };
+}
+function ruleParamFields() {
+    return [
+        {
+            name: 'tier',
+            type: 'relationship',
+            relationTo: collectionOf('tiers'),
+            filterOptions: catalogFilterOptions,
+            admin: {
+                condition: (_, sibling) => sibling?.type === 'tier-at-least',
+                description: 'They must be at least this tier.',
+            },
+        },
+        {
+            name: 'achievement',
+            type: 'relationship',
+            relationTo: collectionOf('achievements'),
+            filterOptions: catalogFilterOptions,
+            admin: {
+                condition: (_, sibling) => sibling?.type === 'achievement-complete',
+                description: 'They must already have this achievement.',
+            },
+        },
+        {
+            name: 'metric',
+            type: 'relationship',
+            relationTo: collectionOf('metrics'),
+            filterOptions: catalogFilterOptions,
+            admin: {
+                condition: (_, sibling) => sibling?.type === 'metric-minimum',
+                description: 'Which score to check.',
+            },
+        },
+        {
+            name: 'minimum',
+            type: 'number',
+            admin: {
+                condition: (_, sibling) => sibling?.type === 'metric-minimum',
+                description: 'They need at least this much.',
+            },
+        },
+        {
+            name: 'eventType',
+            type: 'relationship',
+            relationTo: collectionOf('eventTypes'),
+            filterOptions: catalogFilterOptions,
+            admin: {
+                condition: (_, sibling) => sibling?.type === 'event-count',
+                description: 'Which event type to count.',
+            },
+        },
+        {
+            name: 'count',
+            type: 'number',
+            admin: {
+                condition: (_, sibling) => sibling?.type === 'event-count',
+                description: 'How many times it needs to have happened.',
+            },
+        },
+    ];
+}
+function buildRuleLeafFields() {
+    return [ruleTypeSelect(false), ...ruleParamFields()];
+}
+/**
+ * Top-level rule group: combinator + rules, with one nested group level.
+ */
+export function buildRuleTreeFields() {
+    return [
+        combinatorField(),
+        {
+            name: 'rules',
+            type: 'array',
+            labels: { singular: 'Rule', plural: 'Rules' },
+            fields: [
+                ruleTypeSelect(true),
+                ...ruleParamFields(),
+                combinatorField(true),
+                {
+                    name: 'rules',
+                    type: 'array',
+                    labels: { singular: 'Rule', plural: 'Rules' },
+                    admin: { condition: (_, sibling) => sibling?.type === 'group' },
+                    fields: buildRuleLeafFields(),
+                },
+            ],
+        },
+    ];
+}
+/** @deprecated Use {@link buildRuleTreeFields}. */
+export function buildRuleRowFields() {
+    return buildRuleTreeFields();
+}

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

@@ -0,0 +1,7 @@
+import type { Field } from 'payload';
+/**
+ * Optional relationship to the host scope collection.
+ * Returns `null` when `options.scope.collection` is unset — callers should omit it.
+ */
+export declare function scopeField(): Field | null;
+//# sourceMappingURL=scopeField.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scopeField.d.ts","sourceRoot":"","sources":["../../../src/collections/fields/scopeField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAIpC;;;GAGG;AACH,wBAAgB,UAAU,IAAI,KAAK,GAAG,IAAI,CAiBzC"}

package/dist/collections/fields/scopeField.js

@@ -0,0 +1,22 @@
+import { getAchievementOptions } from '../../options-store';
+/**
+ * Optional relationship to the host scope collection.
+ * Returns `null` when `options.scope.collection` is unset — callers should omit it.
+ */
+export function scopeField() {
+    const options = getAchievementOptions();
+    const relationTo = options.scope?.collection;
+    if (!relationTo)
+        return null;
+    const name = options.scope?.relationField ?? 'scope';
+    return {
+        name,
+        type: 'relationship',
+        relationTo,
+        required: false,
+        index: true,
+        admin: {
+            description: 'Optional tenant or workspace this belongs to.',
+        },
+    };
+}

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

@@ -0,0 +1,4 @@
+import type { Field } from 'payload';
+/** Relationship to the users collection. */
+export declare function userField(): Field;
+//# sourceMappingURL=userField.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"userField.d.ts","sourceRoot":"","sources":["../../../src/collections/fields/userField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAIpC,4CAA4C;AAC5C,wBAAgB,SAAS,IAAI,KAAK,CAUjC"}

package/dist/collections/fields/userField.js

@@ -0,0 +1,12 @@
+import { getAchievementOptions } from '../../options-store';
+/** Relationship to the users collection. */
+export function userField() {
+    const users = getAchievementOptions().usersCollectionSlug ?? 'users';
+    return {
+        name: 'user',
+        type: 'relationship',
+        relationTo: users,
+        required: true,
+        index: true,
+    };
+}

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

@@ -0,0 +1,8 @@
+import type { Field } from 'payload';
+import type { ResolvedAchievementOptions } from '../../defaults';
+/**
+ * Group on the users collection: reverse joins into grants + requests.
+ * Nested JSON shape: `user.achievements.grants` / `.requests`.
+ */
+export declare function usersAchievementsGroup(options: ResolvedAchievementOptions): Field;
+//# sourceMappingURL=usersAchievementsGroup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usersAchievementsGroup.d.ts","sourceRoot":"","sources":["../../../src/collections/fields/usersAchievementsGroup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA;AAEhE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,0BAA0B,GAAG,KAAK,CAgCjF"}

package/dist/collections/fields/usersAchievementsGroup.js

@@ -0,0 +1,36 @@
+/**
+ * Group on the users collection: reverse joins into grants + requests.
+ * Nested JSON shape: `user.achievements.grants` / `.requests`.
+ */
+export function usersAchievementsGroup(options) {
+    const slugs = options.collectionSlugs;
+    return {
+        name: 'achievements',
+        type: 'group',
+        admin: {
+            description: 'Their grants and open requests.',
+        },
+        fields: [
+            {
+                name: 'grants',
+                type: 'join',
+                collection: slugs.grants,
+                on: 'user',
+                admin: {
+                    allowCreate: false,
+                    defaultColumns: ['achievement', 'completedAt', 'scope'],
+                },
+            },
+            {
+                name: 'requests',
+                type: 'join',
+                collection: slugs.achievementRequests,
+                on: 'user',
+                admin: {
+                    allowCreate: false,
+                    defaultColumns: ['achievement', 'status', 'createdAt'],
+                },
+            },
+        ],
+    };
+}

package/dist/collections/helpers.d.ts

@@ -0,0 +1,16 @@
+import type { CollectionConfig, Field } from 'payload';
+import type { AchievementCollectionKey } from '../types';
+/** Resolved slug for a logical achievement collection. */
+export declare function slugOf(key: AchievementCollectionKey): string;
+/**
+ * Local API / relationship target. Host `generate:types` owns the real CollectionSlug union;
+ * plugins cast loosely at the boundary.
+ */
+export declare function collectionOf(key: AchievementCollectionKey): any;
+/** Drop nullish optional fields (e.g. scope when unset). */
+export declare function optionalFields(...fields: Array<Field | null | undefined>): Field[];
+/** Admin defaultColumns — strips `scope` when the host did not configure a scope collection. */
+export declare function columnsWithOptionalScope(columns: string[]): string[];
+/** Shared admin bits (sidebar group + caller overrides). */
+export declare function collectionAdmin(admin: NonNullable<CollectionConfig['admin']>): NonNullable<CollectionConfig['admin']>;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/collections/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AAGxD,0DAA0D;AAC1D,wBAAgB,MAAM,CAAC,GAAG,EAAE,wBAAwB,GAAG,MAAM,CAE5D;AAED;;;GAGG;AAEH,wBAAgB,YAAY,CAAC,GAAG,EAAE,wBAAwB,GAAG,GAAG,CAE/D;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,KAAK,EAAE,CAElF;AAED,gGAAgG;AAChG,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAGpE;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAC5C,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAMxC"}

package/dist/collections/helpers.js

@@ -0,0 +1,31 @@
+import { getAchievementOptions } from '../options-store';
+/** Resolved slug for a logical achievement collection. */
+export function slugOf(key) {
+    return getAchievementOptions().collectionSlugs[key];
+}
+/**
+ * Local API / relationship target. Host `generate:types` owns the real CollectionSlug union;
+ * plugins cast loosely at the boundary.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- host owns CollectionSlug
+export function collectionOf(key) {
+    return slugOf(key);
+}
+/** Drop nullish optional fields (e.g. scope when unset). */
+export function optionalFields(...fields) {
+    return fields.filter((field) => field != null);
+}
+/** Admin defaultColumns — strips `scope` when the host did not configure a scope collection. */
+export function columnsWithOptionalScope(columns) {
+    if (getAchievementOptions().scope?.collection)
+        return columns;
+    return columns.filter((column) => column !== 'scope');
+}
+/** Shared admin bits (sidebar group + caller overrides). */
+export function collectionAdmin(admin) {
+    const group = getAchievementOptions().adminGroup;
+    return {
+        ...admin,
+        ...(group === false ? {} : { group }),
+    };
+}

package/dist/collections/hooks/eachRuleLeaf.d.ts

@@ -0,0 +1,3 @@
+export type LeafVisitor = (rule: Record<string, unknown>) => void;
+export declare function eachRuleLeaf(node: unknown, visit: LeafVisitor): void;
+//# sourceMappingURL=eachRuleLeaf.d.ts.map

package/dist/collections/hooks/eachRuleLeaf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eachRuleLeaf.d.ts","sourceRoot":"","sources":["../../../src/collections/hooks/eachRuleLeaf.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;AAEjE,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAgBpE"}

package/dist/collections/hooks/eachRuleLeaf.js

@@ -0,0 +1,20 @@
+export function eachRuleLeaf(node, visit) {
+    if (Array.isArray(node)) {
+        for (const item of node)
+            eachRuleLeaf(item, visit);
+        return;
+    }
+    if (!node || typeof node !== 'object')
+        return;
+    const rec = node;
+    if (rec.type === 'group') {
+        eachRuleLeaf(rec.rules, visit);
+        return;
+    }
+    if (Array.isArray(rec.rules) && (rec.combinator === 'and' || rec.combinator === 'or' || !rec.type)) {
+        eachRuleLeaf(rec.rules, visit);
+        return;
+    }
+    if (typeof rec.type === 'string')
+        visit(rec);
+}

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

@@ -0,0 +1,4 @@
+export { eachRuleLeaf } from './eachRuleLeaf';
+export { lockSystemCatalogFields } from './lockSystemCatalogFields';
+export { preventCatalogDelete } from './preventCatalogDelete';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/collections/hooks/index.js

@@ -0,0 +1,3 @@
+export { eachRuleLeaf } from './eachRuleLeaf';
+export { lockSystemCatalogFields } from './lockSystemCatalogFields';
+export { preventCatalogDelete } from './preventCatalogDelete';

package/dist/collections/hooks/lockSystemCatalogFields.d.ts

@@ -0,0 +1,7 @@
+import type { CollectionBeforeChangeHook } from 'payload';
+/**
+ * System catalog rows keep a fixed slug and stay marked system on update
+ * so engine lookups by slug cannot be broken from Admin.
+ */
+export declare const lockSystemCatalogFields: CollectionBeforeChangeHook;
+//# sourceMappingURL=lockSystemCatalogFields.d.ts.map

package/dist/collections/hooks/lockSystemCatalogFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockSystemCatalogFields.d.ts","sourceRoot":"","sources":["../../../src/collections/hooks/lockSystemCatalogFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAEzD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,0BASrC,CAAA"}

package/dist/collections/hooks/lockSystemCatalogFields.js

@@ -0,0 +1,15 @@
+/**
+ * System catalog rows keep a fixed slug and stay marked system on update
+ * so engine lookups by slug cannot be broken from Admin.
+ */
+export const lockSystemCatalogFields = ({ data, originalDoc, operation }) => {
+    if (!data || operation !== 'update')
+        return data;
+    if (!originalDoc?.system)
+        return data;
+    data.system = true;
+    if (typeof originalDoc.slug === 'string') {
+        data.slug = originalDoc.slug;
+    }
+    return data;
+};

package/dist/collections/hooks/preventCatalogDelete.d.ts

@@ -0,0 +1,5 @@
+import type { CollectionBeforeDeleteHook } from 'payload';
+export declare function preventCatalogDelete(args: {
+    kind: 'eventType' | 'metric';
+}): CollectionBeforeDeleteHook;
+//# sourceMappingURL=preventCatalogDelete.d.ts.map

package/dist/collections/hooks/preventCatalogDelete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preventCatalogDelete.d.ts","sourceRoot":"","sources":["../../../src/collections/hooks/preventCatalogDelete.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AA6CzD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAA;CAC7B,GAAG,0BAA0B,CAqD7B"}

package/dist/collections/hooks/preventCatalogDelete.js

@@ -0,0 +1,89 @@
+import { APIError } from 'payload';
+import { collectionOf } from '../helpers';
+import { relationId } from '../../services/achievement/relationId';
+import { eachRuleLeaf } from './eachRuleLeaf';
+async function countMatchingLeaves(args) {
+    let count = 0;
+    const visit = (rule) => {
+        if (args.match(rule))
+            count += 1;
+    };
+    const [tiers, achievements] = await Promise.all([
+        args.req.payload.find({
+            collection: collectionOf('tiers'),
+            depth: 0,
+            limit: 1000,
+            pagination: false,
+            overrideAccess: true,
+            req: args.req,
+        }),
+        args.req.payload.find({
+            collection: collectionOf('achievements'),
+            depth: 0,
+            limit: 1000,
+            pagination: false,
+            overrideAccess: true,
+            req: args.req,
+        }),
+    ]);
+    for (const doc of tiers.docs) {
+        eachRuleLeaf(doc.unlockRules, visit);
+    }
+    for (const doc of achievements.docs) {
+        eachRuleLeaf(doc.eligibilityRules, visit);
+        eachRuleLeaf(doc.completionRules, visit);
+    }
+    return count;
+}
+export function preventCatalogDelete(args) {
+    const { kind } = args;
+    return async ({ id, req }) => {
+        const collectionKey = kind === 'eventType' ? 'eventTypes' : 'metrics';
+        const doc = (await req.payload.findByID({
+            collection: collectionOf(collectionKey),
+            id,
+            depth: 0,
+            overrideAccess: true,
+            req,
+        }));
+        if (doc?.system) {
+            throw new APIError('System catalog entries cannot be deleted.', 400);
+        }
+        const parts = [];
+        if (kind === 'eventType') {
+            const logs = await req.payload.count({
+                collection: collectionOf('logs'),
+                overrideAccess: true,
+                req,
+                where: { type: { equals: id } },
+            });
+            if (logs.totalDocs > 0)
+                parts.push(`${logs.totalDocs} log row(s)`);
+            const rules = await countMatchingLeaves({
+                req,
+                match: (rule) => rule.type === 'event-count' && relationId(rule.eventType) === id,
+            });
+            if (rules > 0)
+                parts.push(`${rules} rule(s)`);
+        }
+        else {
+            const logs = await req.payload.count({
+                collection: collectionOf('logs'),
+                overrideAccess: true,
+                req,
+                where: { metric: { equals: id } },
+            });
+            if (logs.totalDocs > 0)
+                parts.push(`${logs.totalDocs} log row(s)`);
+            const rules = await countMatchingLeaves({
+                req,
+                match: (rule) => rule.type === 'metric-minimum' && relationId(rule.metric) === id,
+            });
+            if (rules > 0)
+                parts.push(`${rules} rule(s)`);
+        }
+        if (parts.length > 0) {
+            throw new APIError(`Cannot delete "${doc?.name ?? id}": in use by ${parts.join(', ')}.`, 400);
+        }
+    };
+}

package/dist/collections/index.d.ts

@@ -0,0 +1,4 @@
+import type { CollectionConfig } from 'payload';
+/** Build achievement collections after plugin options are stored. */
+export declare function buildAchievementCollections(): CollectionConfig[];
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/collections/index.js

@@ -0,0 +1,23 @@
+import { getAchievementOptions } from '../options-store';
+import { applyCollectionOverrides } from './applyOverrides';
+import { buildAchievementRequestsCollection } from './AchievementRequests/index';
+import { buildAchievementsCollection } from './Achievements/index';
+import { buildEventTypesCollection } from './EventTypes/index';
+import { buildGrantsCollection } from './Grants/index';
+import { buildLogsCollection } from './Logs/index';
+import { buildMetricsCollection } from './Metrics/index';
+import { buildTiersCollection } from './Tiers/index';
+const builders = {
+    metrics: buildMetricsCollection,
+    eventTypes: buildEventTypesCollection,
+    tiers: buildTiersCollection,
+    achievements: buildAchievementsCollection,
+    grants: buildGrantsCollection,
+    achievementRequests: buildAchievementRequestsCollection,
+    logs: buildLogsCollection,
+};
+/** Build achievement collections after plugin options are stored. */
+export function buildAchievementCollections() {
+    const overrides = getAchievementOptions().collections?.overrides;
+    return Object.keys(builders).map((key) => applyCollectionOverrides(builders[key](), overrides?.[key]));
+}

package/dist/collections/slugs.d.ts

@@ -0,0 +1,22 @@
+import type { AchievementCollectionKey, AchievementPluginOptions } from '../types';
+/**
+ * Default slug prefix — always applied unless a per-collection `slugs` override is set.
+ * Drives collection slug, REST `/api/{slug}`, and default DB table names.
+ * Keeps plugin collections from colliding with host slugs.
+ * Admin nav grouping is separate (`adminGroup`).
+ */
+export declare const DEFAULT_COLLECTION_PREFIX = "achievement";
+/**
+ * Base names combined with {@link DEFAULT_COLLECTION_PREFIX}.
+ * Example: `definitions` → `achievement-definitions` (avoids `achievement-achievements`).
+ */
+export declare const DEFAULT_COLLECTION_BASE_SLUGS: Record<AchievementCollectionKey, string>;
+export declare const DEFAULT_ADMIN_GROUP = "Achievements";
+/**
+ * Resolve final collection slugs from plugin options.
+ * Per-key `collections.slugs` overrides are absolute (ignore `prefix`);
+ * otherwise `${prefix}-${base}` with {@link DEFAULT_COLLECTION_PREFIX} when `prefix` is omitted.
+ */
+export declare function resolveCollectionSlugs(options?: AchievementPluginOptions): Record<AchievementCollectionKey, string>;
+export declare function resolveAdminGroup(options?: AchievementPluginOptions): string | false;
+//# sourceMappingURL=slugs.d.ts.map

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

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

package/dist/collections/slugs.js

@@ -0,0 +1,51 @@
+/**
+ * Default slug prefix — always applied unless a per-collection `slugs` override is set.
+ * Drives collection slug, REST `/api/{slug}`, and default DB table names.
+ * Keeps plugin collections from colliding with host slugs.
+ * Admin nav grouping is separate (`adminGroup`).
+ */
+export const DEFAULT_COLLECTION_PREFIX = 'achievement';
+/**
+ * Base names combined with {@link DEFAULT_COLLECTION_PREFIX}.
+ * Example: `definitions` → `achievement-definitions` (avoids `achievement-achievements`).
+ */
+export const DEFAULT_COLLECTION_BASE_SLUGS = {
+    tiers: 'tiers',
+    achievements: 'definitions',
+    grants: 'grants',
+    achievementRequests: 'requests',
+    logs: 'logs',
+    eventTypes: 'event-types',
+    metrics: 'metrics',
+};
+export const DEFAULT_ADMIN_GROUP = 'Achievements';
+/**
+ * Resolve final collection slugs from plugin options.
+ * Per-key `collections.slugs` overrides are absolute (ignore `prefix`);
+ * otherwise `${prefix}-${base}` with {@link DEFAULT_COLLECTION_PREFIX} when `prefix` is omitted.
+ */
+export function resolveCollectionSlugs(options = {}) {
+    const rawPrefix = options.collections?.prefix ?? options.slugPrefix;
+    const prefix = typeof rawPrefix === 'string' && rawPrefix.trim()
+        ? rawPrefix.trim()
+        : DEFAULT_COLLECTION_PREFIX;
+    const overrides = options.collections?.slugs ?? {};
+    const slugs = {};
+    for (const key of Object.keys(DEFAULT_COLLECTION_BASE_SLUGS)) {
+        const override = overrides[key]?.trim();
+        if (override) {
+            slugs[key] = override;
+            continue;
+        }
+        slugs[key] = `${prefix}-${DEFAULT_COLLECTION_BASE_SLUGS[key]}`;
+    }
+    return slugs;
+}
+export function resolveAdminGroup(options = {}) {
+    if (options.collections?.adminGroup === false)
+        return false;
+    if (typeof options.collections?.adminGroup === 'string') {
+        return options.collections.adminGroup;
+    }
+    return DEFAULT_ADMIN_GROUP;
+}