@dappermountain/payload-plugin-achievements 0.1.0

package/dist/collections/Grants/index.js

@@ -0,0 +1,62 @@
+import { collectionAdmin, collectionOf, columnsWithOptionalScope, optionalFields, slugOf } from '../helpers';
+import { scopeField, userField } from '../fields';
+import { access } from './access';
+import { hooks } from './hooks';
+export function buildGrantsCollection() {
+    return {
+        slug: slugOf('grants'),
+        labels: {
+            singular: 'Achievement Grant',
+            plural: 'Achievement Grants',
+        },
+        access: { ...access },
+        hooks,
+        admin: collectionAdmin({
+            useAsTitle: 'title',
+            defaultColumns: columnsWithOptionalScope(['title', 'user', 'completedAt', 'scope']),
+            listSearchableFields: ['title'],
+            description: 'What someone has earned — one row per grant. Bulk create works here.',
+        }),
+        fields: [
+            {
+                name: 'title',
+                type: 'text',
+                index: true,
+                admin: {
+                    readOnly: true,
+                    description: 'Copied from the achievement name for lists and search.',
+                },
+            },
+            ...optionalFields(scopeField()),
+            userField(),
+            {
+                type: 'row',
+                fields: [
+                    {
+                        name: 'achievement',
+                        type: 'relationship',
+                        relationTo: collectionOf('achievements'),
+                        required: true,
+                        index: true,
+                        admin: { width: '60%' },
+                    },
+                    {
+                        name: 'completedAt',
+                        type: 'date',
+                        required: true,
+                        defaultValue: () => new Date().toISOString(),
+                        admin: {
+                            width: '40%',
+                            date: { pickerAppearance: 'dayAndTime' },
+                        },
+                    },
+                ],
+            },
+            {
+                name: 'note',
+                type: 'textarea',
+                admin: { description: 'Optional note about why this was granted.' },
+            },
+        ],
+    };
+}

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

@@ -0,0 +1,3 @@
+import type { CollectionConfig } from 'payload';
+export declare const access: NonNullable<CollectionConfig['access']>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/collections/Logs/access/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAK/C,eAAO,MAAM,MAAM,EAAE,WAAW,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAK1D,CAAA"}

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

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

package/dist/collections/Logs/fields/validators.d.ts

@@ -0,0 +1,5 @@
+import type { Validate } from 'payload';
+export declare const validateActor: Validate;
+export declare const validateMetric: Validate;
+export declare const validateChange: Validate;
+//# sourceMappingURL=validators.d.ts.map

package/dist/collections/Logs/fields/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../../../src/collections/Logs/fields/validators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAQvC,eAAO,MAAM,aAAa,EAAE,QAW3B,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,QAW5B,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,QAW5B,CAAA"}

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

@@ -0,0 +1,44 @@
+import { eventTypeRequiresActor, eventTypeRequiresMetric, } from '../../../services/achievement/eventTypeRequiresActor';
+import { relationId } from '../../../services/achievement/relationId';
+export const validateActor = async (value, { data, req }) => {
+    if (!req?.payload)
+        return true;
+    const typeId = relationId(data?.type);
+    if (!typeId)
+        return true;
+    if (!(await eventTypeRequiresActor({ payload: req.payload, req, typeIdOrDoc: typeId }))) {
+        return true;
+    }
+    if (!relationId(value)) {
+        return 'This log type needs an actor (who caused it).';
+    }
+    return true;
+};
+export const validateMetric = async (value, { data, req }) => {
+    if (!req?.payload)
+        return true;
+    const typeId = relationId(data?.type);
+    if (!typeId)
+        return true;
+    if (!(await eventTypeRequiresMetric({ payload: req.payload, req, typeIdOrDoc: typeId }))) {
+        return true;
+    }
+    if (!relationId(value)) {
+        return 'This log type needs a metric.';
+    }
+    return true;
+};
+export const validateChange = async (value, { data, req }) => {
+    if (!req?.payload)
+        return true;
+    const typeId = relationId(data?.type);
+    if (!typeId)
+        return true;
+    if (!(await eventTypeRequiresMetric({ payload: req.payload, req, typeIdOrDoc: typeId }))) {
+        return true;
+    }
+    if (typeof value !== 'number' || Number.isNaN(value)) {
+        return 'This log type needs a change amount.';
+    }
+    return true;
+};

package/dist/collections/Logs/hooks/ensureTypeRequirements.d.ts

@@ -0,0 +1,3 @@
+import type { CollectionBeforeValidateHook } from 'payload';
+export declare const ensureTypeRequirements: CollectionBeforeValidateHook;
+//# sourceMappingURL=ensureTypeRequirements.d.ts.map

package/dist/collections/Logs/hooks/ensureTypeRequirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureTypeRequirements.d.ts","sourceRoot":"","sources":["../../../../src/collections/Logs/hooks/ensureTypeRequirements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAA;AAS3D,eAAO,MAAM,sBAAsB,EAAE,4BAkCpC,CAAA"}

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

@@ -0,0 +1,35 @@
+import { APIError } from 'payload';
+import { eventTypeRequiresActor, eventTypeRequiresMetric, } from '../../../services/achievement/eventTypeRequiresActor';
+import { relationId } from '../../../services/achievement/relationId';
+export const ensureTypeRequirements = async ({ data, req }) => {
+    if (!data)
+        return data;
+    const typeId = relationId(data.type);
+    if (!typeId)
+        return data;
+    const flags = {
+        requiresActor: await eventTypeRequiresActor({
+            payload: req.payload,
+            req,
+            typeIdOrDoc: typeId,
+        }),
+        requiresMetric: await eventTypeRequiresMetric({
+            payload: req.payload,
+            req,
+            typeIdOrDoc: typeId,
+        }),
+    };
+    if (flags.requiresActor && !relationId(data.actor)) {
+        throw new APIError('This log type needs an actor (who caused it).', 400);
+    }
+    if (flags.requiresMetric) {
+        if (!relationId(data.metric)) {
+            throw new APIError('This log type needs a metric.', 400);
+        }
+        const change = data.change;
+        if (typeof change !== 'number' || Number.isNaN(change)) {
+            throw new APIError('This log type needs a change amount.', 400);
+        }
+    }
+    return data;
+};

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

@@ -0,0 +1,3 @@
+import type { CollectionConfig } from 'payload';
+export declare const hooks: CollectionConfig['hooks'];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/collections/Logs/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"}

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

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

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

@@ -0,0 +1,4 @@
+import type { CollectionConfig } from 'payload';
+/** Append-only occurrence log. `type` / `metric` are catalog relationships. */
+export declare function buildLogsCollection(): CollectionConfig;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/collections/Logs/index.js

@@ -0,0 +1,113 @@
+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';
+/** Append-only occurrence log. `type` / `metric` are catalog relationships. */
+export function buildLogsCollection() {
+    const users = getAchievementOptions().usersCollectionSlug ?? 'users';
+    const eventTypesSlug = collectionOf('eventTypes');
+    return {
+        slug: slugOf('logs'),
+        labels: {
+            singular: 'Achievement Log',
+            plural: 'Achievement Logs',
+        },
+        access: { ...access },
+        hooks,
+        admin: collectionAdmin({
+            useAsTitle: 'id',
+            defaultColumns: ['type', 'user', 'actor', 'metric', 'change', 'createdAt'],
+            description: 'A running history of what happened — grants, score changes, tier moves, and anything else you log.',
+        }),
+        fields: [
+            ...optionalFields(scopeField()),
+            userField(),
+            {
+                type: 'row',
+                fields: [
+                    {
+                        name: 'type',
+                        type: 'relationship',
+                        relationTo: collectionOf('eventTypes'),
+                        required: true,
+                        index: true,
+                        filterOptions: catalogFilterOptions,
+                        admin: { width: '50%', description: 'What kind of thing happened.' },
+                    },
+                    {
+                        name: 'actor',
+                        type: 'relationship',
+                        relationTo: users,
+                        index: true,
+                        validate: validateActor,
+                        admin: {
+                            width: '50%',
+                            description: 'Who caused it.',
+                            components: {
+                                Field: {
+                                    path: '@dappermountain/payload-plugin-achievements/client#ActorField',
+                                    clientProps: { eventTypesSlug },
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'metric',
+                        type: 'relationship',
+                        relationTo: collectionOf('metrics'),
+                        filterOptions: catalogFilterOptions,
+                        validate: validateMetric,
+                        admin: {
+                            width: '50%',
+                            description: 'Which score moved.',
+                            components: {
+                                Field: {
+                                    path: '@dappermountain/payload-plugin-achievements/client#MetricField',
+                                    clientProps: { eventTypesSlug },
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'change',
+                        type: 'number',
+                        validate: validateChange,
+                        admin: {
+                            width: '50%',
+                            description: 'How much it changed (for example 10 or −3).',
+                            components: {
+                                Field: {
+                                    path: '@dappermountain/payload-plugin-achievements/client#MetricChangeField',
+                                    clientProps: { eventTypesSlug },
+                                },
+                            },
+                        },
+                    },
+                ],
+            },
+            {
+                type: 'collapsible',
+                label: 'Details',
+                admin: {
+                    initCollapsed: true,
+                    description: 'Extra detail if you need it.',
+                },
+                fields: [
+                    {
+                        name: 'reason',
+                        type: 'text',
+                        admin: { description: 'A short note about why this was recorded.' },
+                    },
+                    {
+                        name: 'data',
+                        type: 'json',
+                        admin: { description: 'Any extra structured details.' },
+                    },
+                ],
+            },
+        ],
+    };
+}

package/dist/collections/Metrics/access/index.d.ts

@@ -0,0 +1,12 @@
+export declare const access: {
+    admin?: ({ req }: {
+        req: import("payload").PayloadRequest;
+    }) => boolean | Promise<boolean>;
+    create?: import("payload").Access;
+    delete?: import("payload").Access;
+    read?: import("payload").Access;
+    readVersions?: import("payload").Access;
+    unlock?: import("payload").Access;
+    update?: import("payload").Access;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/collections/Metrics/access/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM;;;;;;;;;;CAA8B,CAAA"}

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

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

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

@@ -0,0 +1,3 @@
+import type { CollectionConfig } from 'payload';
+export declare const hooks: CollectionConfig['hooks'];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/collections/Metrics/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/Metrics/hooks/index.js

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/Metrics/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAO/C,wBAAgB,sBAAsB,IAAI,gBAAgB,CA8BzD"}

package/dist/collections/Metrics/index.js

@@ -0,0 +1,35 @@
+import { collectionAdmin, columnsWithOptionalScope, optionalFields, slugOf } from '../helpers';
+import { localizedNameField, scopeField } from '../fields';
+import { access } from './access';
+import { hooks } from './hooks';
+export function buildMetricsCollection() {
+    return {
+        slug: slugOf('metrics'),
+        access: { ...access },
+        hooks,
+        admin: collectionAdmin({
+            useAsTitle: 'name',
+            defaultColumns: columnsWithOptionalScope(['name', 'slug', 'system', 'scope']),
+            description: 'Scores and totals you track for someone — like points or a streak.',
+        }),
+        fields: [
+            ...optionalFields(scopeField()),
+            {
+                type: 'row',
+                fields: [
+                    localizedNameField({ width: '50%' }),
+                    { name: 'slug', type: 'text', required: true, unique: true, index: true, admin: { width: '50%' } },
+                ],
+            },
+            {
+                name: 'system',
+                type: 'checkbox',
+                defaultValue: false,
+                admin: {
+                    readOnly: true,
+                    description: 'Built-in metric. It can’t be deleted.',
+                },
+            },
+        ],
+    };
+}

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

@@ -0,0 +1,3 @@
+import type { CollectionConfig } from 'payload';
+export declare const access: NonNullable<CollectionConfig['access']>;
+//# sourceMappingURL=index.d.ts.map

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

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

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

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

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

@@ -0,0 +1,3 @@
+import type { CollectionConfig } from 'payload';
+export declare const hooks: CollectionConfig['hooks'];
+//# sourceMappingURL=index.d.ts.map

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

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

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

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

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

@@ -0,0 +1,3 @@
+import type { CollectionBeforeValidateHook } from 'payload';
+export declare const validateUnlockRules: CollectionBeforeValidateHook;
+//# sourceMappingURL=validateUnlockRules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validateUnlockRules.d.ts","sourceRoot":"","sources":["../../../../src/collections/Tiers/hooks/validateUnlockRules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAA;AAI3D,eAAO,MAAM,mBAAmB,EAAE,4BAOjC,CAAA"}

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

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

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

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

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

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

package/dist/collections/Tiers/index.js

@@ -0,0 +1,81 @@
+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';
+export function buildTiersCollection() {
+    const mediaCollection = getAchievementOptions().mediaCollection?.trim();
+    return {
+        slug: slugOf('tiers'),
+        access: { ...access },
+        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.',
+        }),
+        fields: [
+            ...optionalFields(scopeField()),
+            {
+                type: 'row',
+                fields: [
+                    localizedNameField({ width: '40%' }),
+                    {
+                        name: 'slug',
+                        type: 'text',
+                        required: true,
+                        unique: true,
+                        index: true,
+                        admin: { width: '35%' },
+                    },
+                    {
+                        name: 'rank',
+                        type: 'number',
+                        required: true,
+                        defaultValue: 0,
+                        admin: {
+                            width: '25%',
+                            description: 'Lower numbers are earlier on the ladder (0 is the first step).',
+                        },
+                    },
+                ],
+            },
+            localizedDescriptionField(),
+            {
+                type: 'row',
+                fields: [
+                    {
+                        name: 'icon',
+                        type: 'text',
+                        admin: {
+                            width: mediaCollection ? '50%' : '100%',
+                            description: 'Optional icon key your app maps (e.g. Lucide names: sparkles, shield, crown, gem). Used on the rank ladder when no image is set.',
+                        },
+                    },
+                    ...(mediaCollection
+                        ? [
+                            {
+                                name: 'image',
+                                type: 'upload',
+                                relationTo: mediaCollection,
+                                admin: {
+                                    width: '50%',
+                                    description: 'Optional badge image. Wins over icon when both are set.',
+                                },
+                            },
+                        ]
+                        : []),
+                ],
+            },
+            {
+                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.',
+                },
+                fields: buildRuleTreeFields(),
+            },
+        ],
+    };
+}

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

@@ -0,0 +1,5 @@
+import type { CollectionConfig } from 'payload';
+import type { AchievementCollectionKey } from '../../types';
+/** 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

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

package/dist/collections/access/definitions.js

@@ -0,0 +1,11 @@
+import { isAuthenticated, requireOne } from '../../access/index';
+import { isReviewer } from '../../access/roles/index';
+/** Catalog / definition collections (writes gated by `canReview`). */
+export function definitionAccess(collectionKey) {
+    return {
+        read: isAuthenticated,
+        create: requireOne(isReviewer(collectionKey)),
+        update: requireOne(isReviewer(collectionKey)),
+        delete: requireOne(isReviewer(collectionKey)),
+    };
+}

package/dist/collections/applyOverrides.d.ts

@@ -0,0 +1,9 @@
+import type { CollectionConfig } from 'payload';
+import type { AchievementCollectionOverride } from '../types';
+/**
+ * Layer host overrides on a plugin collection:
+ * - `access` / `admin` / `labels`: shallow merge (host wins per key)
+ * - `hooks`: append host hook arrays after the plugin’s (plugin runs first)
+ */
+export declare function applyCollectionOverrides(collection: CollectionConfig, override?: AchievementCollectionOverride): CollectionConfig;
+//# sourceMappingURL=applyOverrides.d.ts.map

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

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

package/dist/collections/applyOverrides.js

@@ -0,0 +1,34 @@
+/**
+ * Layer host overrides on a plugin collection:
+ * - `access` / `admin` / `labels`: shallow merge (host wins per key)
+ * - `hooks`: append host hook arrays after the plugin’s (plugin runs first)
+ */
+export function applyCollectionOverrides(collection, override) {
+    if (!override)
+        return collection;
+    const hooks = { ...(collection.hooks ?? {}) };
+    if (override.hooks) {
+        for (const key of Object.keys(override.hooks)) {
+            const hostHooks = override.hooks[key];
+            if (hostHooks == null)
+                continue;
+            const existing = hooks[key];
+            const base = (Array.isArray(existing) ? existing : existing ? [existing] : []);
+            const extra = (Array.isArray(hostHooks) ? hostHooks : [hostHooks]);
+            hooks[key] = [...base, ...extra];
+        }
+    }
+    return {
+        ...collection,
+        access: {
+            ...collection.access,
+            ...override.access,
+        },
+        admin: {
+            ...collection.admin,
+            ...override.admin,
+        },
+        ...(override.labels ? { labels: override.labels } : {}),
+        hooks,
+    };
+}

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

@@ -0,0 +1,8 @@
+import type { Where } from 'payload';
+/** Relationship picker: same scope as the parent doc, or unscoped (global) catalog rows. */
+export declare function catalogFilterOptions({ data }: {
+    data?: {
+        scope?: unknown;
+    };
+}): Where | true;
+//# sourceMappingURL=catalogFilter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalogFilter.d.ts","sourceRoot":"","sources":["../../../src/collections/fields/catalogFilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAIpC,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAAG,KAAK,GAAG,IAAI,CAM3F"}

package/dist/collections/fields/catalogFilter.js

@@ -0,0 +1,10 @@
+import { relationId } from '../../services/achievement/relationId';
+/** Relationship picker: same scope as the parent doc, or unscoped (global) catalog rows. */
+export function catalogFilterOptions({ data }) {
+    const scopeId = relationId(data?.scope);
+    if (!scopeId)
+        return true;
+    return {
+        or: [{ scope: { equals: scopeId } }, { scope: { exists: false } }, { scope: { equals: null } }],
+    };
+}