@ainsleydev/payload-helper 0.1.0 → 0.1.2

package/README.md

@@ -48,6 +48,157 @@ export default buildConfig({
 })
 ```
 
+## Available Exports
+
+The payload-helper package exports a variety of utilities, collections, globals, and components that you can use directly in your Payload projects.
+
+### Collections
+
+Pre-built Payload collections ready to use:
+
+```typescript
+import { Media, Redirects, imageSizes, imageSizesWithAvif } from '@ainsleydev/payload-helper'
+
+// Use in your Payload config
+export default buildConfig({
+	collections: [
+		Media({ includeAvif: true, additionalFields: [...] }),
+		Redirects(),
+	],
+})
+```
+
+**Subpath imports** (optional):
+```typescript
+import { Media, Redirects } from '@ainsleydev/payload-helper/collections'
+```
+
+### Globals
+
+Pre-configured global types for common website needs:
+
+```typescript
+import { Settings, Navigation, countries, languages } from '@ainsleydev/payload-helper'
+
+export default buildConfig({
+	globals: [
+		Settings({ additionalTabs: [...] }),
+		Navigation({ includeFooter: true }),
+	],
+})
+```
+
+**Subpath imports** (optional):
+```typescript
+import { Settings, Navigation } from '@ainsleydev/payload-helper/globals'
+```
+
+### Utilities
+
+Helpful utility functions for validation, field operations, and Lexical conversion:
+
+```typescript
+import {
+	env,
+	fieldHasName,
+	validateURL,
+	validatePostcode,
+	htmlToLexical,
+	lexicalToHtml,
+} from '@ainsleydev/payload-helper'
+
+// Use in field validation
+{
+	name: 'website',
+	type: 'text',
+	validate: validateURL,
+}
+
+// Convert HTML to Lexical format
+const lexicalData = await htmlToLexical('<p>Hello world</p>')
+
+// Convert Lexical to HTML
+const html = await lexicalToHtml(lexicalData)
+```
+
+**Subpath imports** (optional):
+```typescript
+import { validateURL, htmlToLexical } from '@ainsleydev/payload-helper/util'
+```
+
+### Common/Reusable Fields
+
+Reusable field definitions:
+
+```typescript
+import { SEOFields } from '@ainsleydev/payload-helper'
+import { seoPlugin } from '@payloadcms/plugin-seo'
+
+export default buildConfig({
+	plugins: [
+		seoPlugin({
+			collections: ['pages'],
+			fields: SEOFields,
+		}),
+	],
+})
+```
+
+**Subpath imports** (optional):
+```typescript
+import { SEOFields } from '@ainsleydev/payload-helper/common'
+```
+
+### Endpoints
+
+Custom API endpoints:
+
+```typescript
+import { findBySlug } from '@ainsleydev/payload-helper'
+
+// Use in your collection config
+export const Pages: CollectionConfig = {
+	slug: 'pages',
+	endpoints: [findBySlug],
+}
+```
+
+**Subpath imports** (optional):
+```typescript
+import { findBySlug } from '@ainsleydev/payload-helper/endpoints'
+```
+
+### Email Components
+
+Customizable email templates for authentication flows:
+
+```typescript
+import { ForgotPasswordEmail, VerifyAccountEmail } from '@ainsleydev/payload-helper'
+import type { ForgotPasswordEmailProps, VerifyAccountEmailProps } from '@ainsleydev/payload-helper'
+
+// Use directly in custom email handlers
+const emailHtml = ForgotPasswordEmail({
+	resetPasswordToken: 'token123',
+	frontEndUrl: 'https://yoursite.com',
+	// ...other props
+})
+```
+
+### Schema Utilities
+
+For projects that need JSON schema generation (e.g., Go type generation):
+
+```typescript
+import { fieldMapper, schemas, addGoJSONSchema } from '@ainsleydev/payload-helper'
+import type { SchemaOptions } from '@ainsleydev/payload-helper'
+
+// Apply Go schema mappings
+const config = fieldMapper(sanitizedConfig, {
+	useWebKitMedia: true,
+	assignRelationships: true,
+})
+```
+
 ## Configuration
 
 ### Admin configuration

package/dist/collections/index.d.ts

@@ -0,0 +1,3 @@
+export { Media, imageSizes, imageSizesWithAvif } from './Media.js';
+export type { MediaArgs } from './Media.js';
+export { Redirects } from './Redirects.js';

package/dist/collections/index.js

@@ -0,0 +1,4 @@
+export { Media, imageSizes, imageSizesWithAvif } from './Media.js';
+export { Redirects } from './Redirects.js';
+
+//# sourceMappingURL=index.js.map

package/dist/collections/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/collections/index.ts"],"sourcesContent":["export { Media, imageSizes, imageSizesWithAvif } from './Media.js';\nexport type { MediaArgs } from './Media.js';\nexport { Redirects } from './Redirects.js';\n"],"names":["Media","imageSizes","imageSizesWithAvif","Redirects"],"mappings":"AAAA,SAASA,KAAK,EAAEC,UAAU,EAAEC,kBAAkB,QAAQ,aAAa;AAEnE,SAASC,SAAS,QAAQ,iBAAiB"}

package/dist/common/index.d.ts

@@ -0,0 +1 @@
+export { SEOFields } from './SEO.js';

package/dist/common/index.js

@@ -0,0 +1,3 @@
+export { SEOFields } from './SEO.js';
+
+//# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/common/index.ts"],"sourcesContent":["export { SEOFields } from './SEO.js';\n"],"names":["SEOFields"],"mappings":"AAAA,SAASA,SAAS,QAAQ,WAAW"}

package/dist/endpoints/index.d.ts

@@ -0,0 +1 @@
+export { findBySlug } from './slug.js';

package/dist/endpoints/index.js

@@ -0,0 +1,3 @@
+export { findBySlug } from './slug.js';
+
+//# sourceMappingURL=index.js.map

package/dist/endpoints/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/endpoints/index.ts"],"sourcesContent":["export { findBySlug } from './slug.js';\n"],"names":["findBySlug"],"mappings":"AAAA,SAASA,UAAU,QAAQ,YAAY"}

package/dist/globals/index.d.ts

@@ -0,0 +1,5 @@
+export { Settings } from './Settings.js';
+export type { SettingsArgs } from './Settings.js';
+export { Navigation } from './Navigation.js';
+export { countries } from './countries.js';
+export { languages } from './locales.js';

package/dist/globals/index.js

@@ -0,0 +1,6 @@
+export { Settings } from './Settings.js';
+export { Navigation } from './Navigation.js';
+export { countries } from './countries.js';
+export { languages } from './locales.js';
+
+//# sourceMappingURL=index.js.map

package/dist/globals/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/globals/index.ts"],"sourcesContent":["export { Settings } from './Settings.js';\nexport type { SettingsArgs } from './Settings.js';\nexport { Navigation } from './Navigation.js';\nexport { countries } from './countries.js';\nexport { languages } from './locales.js';\n"],"names":["Settings","Navigation","countries","languages"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,gBAAgB;AAEzC,SAASC,UAAU,QAAQ,kBAAkB;AAC7C,SAASC,SAAS,QAAQ,iBAAiB;AAC3C,SAASC,SAAS,QAAQ,eAAe"}

package/dist/index.d.ts

@@ -1,17 +1,17 @@
-import type { Config } from 'payload';
-import type { PayloadHelperPluginConfig } from './types.js';
-/**
- * Payload Helper Plugin for websites at ainsley.dev
- *
- * @constructor
- * @param pluginOptions
- */
-export declare const payloadHelper: (pluginOptions: PayloadHelperPluginConfig) => (incomingConfig: Config) => Config;
-export type { IconProps } from './admin/components/Icon.js';
-export type { LogoProps } from './admin/components/Logo.js';
+export { payloadHelper } from './plugin.js';
+export type { PayloadHelperPluginConfig, AdminConfig, AdminIconConfig, AdminLogoConfig, EmailConfig, EmailContentOverrides, SettingsConfig, WebServerConfig, } from './types.js';
+export type { MediaArgs } from './collections/Media.js';
+export { Media, imageSizes, imageSizesWithAvif, Redirects } from './collections/index.js';
+export type { SettingsArgs } from './globals/Settings.js';
+export { Settings, Navigation, countries, languages } from './globals/index.js';
 export { ForgotPasswordEmail } from './email/ForgotPasswordEmail.js';
 export type { ForgotPasswordEmailProps } from './email/ForgotPasswordEmail.js';
 export { VerifyAccountEmail } from './email/VerifyAccountEmail.js';
 export type { VerifyAccountEmailProps } from './email/VerifyAccountEmail.js';
-export { default as env } from './util/env.js';
-export type { AdminConfig, AdminIconConfig, AdminLogoConfig, EmailConfig, EmailContentOverrides, PayloadHelperPluginConfig, } from './types.js';
+export type { IconProps } from './admin/components/Icon.js';
+export type { LogoProps } from './admin/components/Logo.js';
+export { env, fieldHasName, validateURL, validatePostcode, htmlToLexical, lexicalToHtml, } from './util/index.js';
+export { SEOFields } from './common/index.js';
+export { findBySlug } from './endpoints/index.js';
+export type { SchemaOptions } from './plugin/schema.js';
+export { fieldMapper, schemas, addGoJSONSchema } from './plugin/schema.js';

package/dist/index.js

@@ -1,81 +1,16 @@
-import { injectAdminIcon, injectAdminLogo } from './plugin/admin.js';
-import { injectEmailTemplates } from './plugin/email.js';
-import { cacheHookCollections, cacheHookGlobals } from './plugin/hooks.js';
-/**
- * Payload Helper Plugin for websites at ainsley.dev
- *
- * @constructor
- * @param pluginOptions
- */ export const payloadHelper = (pluginOptions)=>(incomingConfig)=>{
-        // TODO: Validate Config
-        let config = incomingConfig;
-        // Update typescript generation file
-        config.typescript = config.typescript || {};
-        config.typescript.outputFile = './src/types/payload.ts';
-        // Inject admin Logo component if logo config is provided
-        if (pluginOptions.admin?.logo) {
-            config = injectAdminLogo(config, pluginOptions.admin.logo, pluginOptions.siteName);
-        }
-        // Inject admin Icon component if icon config is provided
-        if (pluginOptions.admin?.icon) {
-            config = injectAdminIcon(config, pluginOptions.admin.icon, pluginOptions.siteName);
-        }
-        // Inject email templates for auth-enabled collections if email config is provided
-        if (pluginOptions.email) {
-            config = injectEmailTemplates(config, pluginOptions.email);
-        }
-        // Map collections & add hooks
-        config.collections = (config.collections || []).map((collection)=>{
-            if (collection.upload !== undefined && collection.upload !== true) {
-                return collection;
-            }
-            const hooks = collection.hooks || {};
-            // Add afterChange hook only if webServer is defined
-            if (pluginOptions.webServer) {
-                hooks.afterChange = [
-                    ...hooks.afterChange || [],
-                    cacheHookCollections({
-                        server: pluginOptions.webServer,
-                        slug: collection.slug,
-                        fields: collection.fields,
-                        isCollection: true
-                    })
-                ];
-            }
-            return {
-                ...collection,
-                hooks
-            };
-        });
-        // Map globals & add hooks
-        config.globals = (config.globals || []).map((global)=>{
-            const hooks = global.hooks || {};
-            // Add afterChange hook only if webServer is defined
-            if (pluginOptions.webServer) {
-                hooks.afterChange = [
-                    ...hooks.afterChange || [],
-                    cacheHookGlobals({
-                        server: pluginOptions.webServer,
-                        slug: global.slug,
-                        fields: global.fields,
-                        isCollection: true
-                    })
-                ];
-            }
-            return {
-                ...global,
-                hooks
-            };
-        });
-        // Store plugin options in config.custom for CLI access (e.g., preview-emails command)
-        config.custom = {
-            ...config.custom,
-            payloadHelperOptions: pluginOptions
-        };
-        return config;
-    };
+// Main plugin
+export { payloadHelper } from './plugin.js';
+export { Media, imageSizes, imageSizesWithAvif, Redirects } from './collections/index.js';
+export { Settings, Navigation, countries, languages } from './globals/index.js';
+// Email Components
 export { ForgotPasswordEmail } from './email/ForgotPasswordEmail.js';
 export { VerifyAccountEmail } from './email/VerifyAccountEmail.js';
-export { default as env } from './util/env.js';
+// Utilities
+export { env, fieldHasName, validateURL, validatePostcode, htmlToLexical, lexicalToHtml } from './util/index.js';
+// Common/Reusable
+export { SEOFields } from './common/index.js';
+// Endpoints
+export { findBySlug } from './endpoints/index.js';
+export { fieldMapper, schemas, addGoJSONSchema } from './plugin/schema.js';
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { CollectionConfig, Config } from 'payload';\nimport { injectAdminIcon, injectAdminLogo } from './plugin/admin.js';\nimport { injectEmailTemplates } from './plugin/email.js';\nimport { cacheHookCollections, cacheHookGlobals } from './plugin/hooks.js';\nimport type { PayloadHelperPluginConfig } from './types.js';\n\n/**\n * Payload Helper Plugin for websites at ainsley.dev\n *\n * @constructor\n * @param pluginOptions\n */\nexport const payloadHelper =\n\t(pluginOptions: PayloadHelperPluginConfig) =>\n\t(incomingConfig: Config): Config => {\n\t\t// TODO: Validate Config\n\n\t\tlet config = incomingConfig;\n\n\t\t// Update typescript generation file\n\t\tconfig.typescript = config.typescript || {};\n\t\tconfig.typescript.outputFile = './src/types/payload.ts';\n\n\t\t// Inject admin Logo component if logo config is provided\n\t\tif (pluginOptions.admin?.logo) {\n\t\t\tconfig = injectAdminLogo(config, pluginOptions.admin.logo, pluginOptions.siteName);\n\t\t}\n\n\t\t// Inject admin Icon component if icon config is provided\n\t\tif (pluginOptions.admin?.icon) {\n\t\t\tconfig = injectAdminIcon(config, pluginOptions.admin.icon, pluginOptions.siteName);\n\t\t}\n\n\t\t// Inject email templates for auth-enabled collections if email config is provided\n\t\tif (pluginOptions.email) {\n\t\t\tconfig = injectEmailTemplates(config, pluginOptions.email);\n\t\t}\n\n\t\t// Map collections & add hooks\n\t\tconfig.collections = (config.collections || []).map((collection): CollectionConfig => {\n\t\t\tif (collection.upload !== undefined && collection.upload !== true) {\n\t\t\t\treturn collection;\n\t\t\t}\n\n\t\t\tconst hooks = collection.hooks || {};\n\n\t\t\t// Add afterChange hook only if webServer is defined\n\t\t\tif (pluginOptions.webServer) {\n\t\t\t\thooks.afterChange = [\n\t\t\t\t\t...(hooks.afterChange || []),\n\t\t\t\t\tcacheHookCollections({\n\t\t\t\t\t\tserver: pluginOptions.webServer,\n\t\t\t\t\t\tslug: collection.slug,\n\t\t\t\t\t\tfields: collection.fields,\n\t\t\t\t\t\tisCollection: true,\n\t\t\t\t\t}),\n\t\t\t\t];\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\t...collection,\n\t\t\t\thooks,\n\t\t\t};\n\t\t});\n\n\t\t// Map globals & add hooks\n\t\tconfig.globals = (config.globals || []).map((global) => {\n\t\t\tconst hooks = global.hooks || {};\n\n\t\t\t// Add afterChange hook only if webServer is defined\n\t\t\tif (pluginOptions.webServer) {\n\t\t\t\thooks.afterChange = [\n\t\t\t\t\t...(hooks.afterChange || []),\n\t\t\t\t\tcacheHookGlobals({\n\t\t\t\t\t\tserver: pluginOptions.webServer,\n\t\t\t\t\t\tslug: global.slug,\n\t\t\t\t\t\tfields: global.fields,\n\t\t\t\t\t\tisCollection: true,\n\t\t\t\t\t}),\n\t\t\t\t];\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\t...global,\n\t\t\t\thooks,\n\t\t\t};\n\t\t});\n\n\t\t// Store plugin options in config.custom for CLI access (e.g., preview-emails command)\n\t\tconfig.custom = {\n\t\t\t...config.custom,\n\t\t\tpayloadHelperOptions: pluginOptions,\n\t\t};\n\n\t\treturn config;\n\t};\n\nexport type { IconProps } from './admin/components/Icon.js';\nexport type { LogoProps } from './admin/components/Logo.js';\nexport { ForgotPasswordEmail } from './email/ForgotPasswordEmail.js';\nexport type { ForgotPasswordEmailProps } from './email/ForgotPasswordEmail.js';\nexport { VerifyAccountEmail } from './email/VerifyAccountEmail.js';\nexport type { VerifyAccountEmailProps } from './email/VerifyAccountEmail.js';\nexport { default as env } from './util/env.js';\nexport type {\n\tAdminConfig,\n\tAdminIconConfig,\n\tAdminLogoConfig,\n\tEmailConfig,\n\tEmailContentOverrides,\n\tPayloadHelperPluginConfig,\n} from './types.js';\n"],"names":["injectAdminIcon","injectAdminLogo","injectEmailTemplates","cacheHookCollections","cacheHookGlobals","payloadHelper","pluginOptions","incomingConfig","config","typescript","outputFile","admin","logo","siteName","icon","email","collections","map","collection","upload","undefined","hooks","webServer","afterChange","server","slug","fields","isCollection","globals","global","custom","payloadHelperOptions","ForgotPasswordEmail","VerifyAccountEmail","default","env"],"mappings":"AACA,SAASA,eAAe,EAAEC,eAAe,QAAQ,oBAAoB;AACrE,SAASC,oBAAoB,QAAQ,oBAAoB;AACzD,SAASC,oBAAoB,EAAEC,gBAAgB,QAAQ,oBAAoB;AAG3E;;;;;CAKC,GACD,OAAO,MAAMC,gBACZ,CAACC,gBACD,CAACC;QACA,wBAAwB;QAExB,IAAIC,SAASD;QAEb,oCAAoC;QACpCC,OAAOC,UAAU,GAAGD,OAAOC,UAAU,IAAI,CAAC;QAC1CD,OAAOC,UAAU,CAACC,UAAU,GAAG;QAE/B,yDAAyD;QACzD,IAAIJ,cAAcK,KAAK,EAAEC,MAAM;YAC9BJ,SAASP,gBAAgBO,QAAQF,cAAcK,KAAK,CAACC,IAAI,EAAEN,cAAcO,QAAQ;QAClF;QAEA,yDAAyD;QACzD,IAAIP,cAAcK,KAAK,EAAEG,MAAM;YAC9BN,SAASR,gBAAgBQ,QAAQF,cAAcK,KAAK,CAACG,IAAI,EAAER,cAAcO,QAAQ;QAClF;QAEA,kFAAkF;QAClF,IAAIP,cAAcS,KAAK,EAAE;YACxBP,SAASN,qBAAqBM,QAAQF,cAAcS,KAAK;QAC1D;QAEA,8BAA8B;QAC9BP,OAAOQ,WAAW,GAAG,AAACR,CAAAA,OAAOQ,WAAW,IAAI,EAAE,AAAD,EAAGC,GAAG,CAAC,CAACC;YACpD,IAAIA,WAAWC,MAAM,KAAKC,aAAaF,WAAWC,MAAM,KAAK,MAAM;gBAClE,OAAOD;YACR;YAEA,MAAMG,QAAQH,WAAWG,KAAK,IAAI,CAAC;YAEnC,oDAAoD;YACpD,IAAIf,cAAcgB,SAAS,EAAE;gBAC5BD,MAAME,WAAW,GAAG;uBACfF,MAAME,WAAW,IAAI,EAAE;oBAC3BpB,qBAAqB;wBACpBqB,QAAQlB,cAAcgB,SAAS;wBAC/BG,MAAMP,WAAWO,IAAI;wBACrBC,QAAQR,WAAWQ,MAAM;wBACzBC,cAAc;oBACf;iBACA;YACF;YAEA,OAAO;gBACN,GAAGT,UAAU;gBACbG;YACD;QACD;QAEA,0BAA0B;QAC1Bb,OAAOoB,OAAO,GAAG,AAACpB,CAAAA,OAAOoB,OAAO,IAAI,EAAE,AAAD,EAAGX,GAAG,CAAC,CAACY;YAC5C,MAAMR,QAAQQ,OAAOR,KAAK,IAAI,CAAC;YAE/B,oDAAoD;YACpD,IAAIf,cAAcgB,SAAS,EAAE;gBAC5BD,MAAME,WAAW,GAAG;uBACfF,MAAME,WAAW,IAAI,EAAE;oBAC3BnB,iBAAiB;wBAChBoB,QAAQlB,cAAcgB,SAAS;wBAC/BG,MAAMI,OAAOJ,IAAI;wBACjBC,QAAQG,OAAOH,MAAM;wBACrBC,cAAc;oBACf;iBACA;YACF;YAEA,OAAO;gBACN,GAAGE,MAAM;gBACTR;YACD;QACD;QAEA,sFAAsF;QACtFb,OAAOsB,MAAM,GAAG;YACf,GAAGtB,OAAOsB,MAAM;YAChBC,sBAAsBzB;QACvB;QAEA,OAAOE;IACR,EAAE;AAIH,SAASwB,mBAAmB,QAAQ,iCAAiC;AAErE,SAASC,kBAAkB,QAAQ,gCAAgC;AAEnE,SAASC,WAAWC,GAAG,QAAQ,gBAAgB"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Main plugin\nexport { payloadHelper } from './plugin.js';\n\n// Types\nexport type {\n\tPayloadHelperPluginConfig,\n\tAdminConfig,\n\tAdminIconConfig,\n\tAdminLogoConfig,\n\tEmailConfig,\n\tEmailContentOverrides,\n\tSettingsConfig,\n\tWebServerConfig,\n} from './types.js';\n\n// Collections\nexport type { MediaArgs } from './collections/Media.js';\nexport { Media, imageSizes, imageSizesWithAvif, Redirects } from './collections/index.js';\n\n// Globals\nexport type { SettingsArgs } from './globals/Settings.js';\nexport { Settings, Navigation, countries, languages } from './globals/index.js';\n\n// Email Components\nexport { ForgotPasswordEmail } from './email/ForgotPasswordEmail.js';\nexport type { ForgotPasswordEmailProps } from './email/ForgotPasswordEmail.js';\nexport { VerifyAccountEmail } from './email/VerifyAccountEmail.js';\nexport type { VerifyAccountEmailProps } from './email/VerifyAccountEmail.js';\n\n// Admin Components\nexport type { IconProps } from './admin/components/Icon.js';\nexport type { LogoProps } from './admin/components/Logo.js';\n\n// Utilities\nexport {\n\tenv,\n\tfieldHasName,\n\tvalidateURL,\n\tvalidatePostcode,\n\thtmlToLexical,\n\tlexicalToHtml,\n} from './util/index.js';\n\n// Common/Reusable\nexport { SEOFields } from './common/index.js';\n\n// Endpoints\nexport { findBySlug } from './endpoints/index.js';\n\n// Schema utilities\nexport type { SchemaOptions } from './plugin/schema.js';\nexport { fieldMapper, schemas, addGoJSONSchema } from './plugin/schema.js';\n"],"names":["payloadHelper","Media","imageSizes","imageSizesWithAvif","Redirects","Settings","Navigation","countries","languages","ForgotPasswordEmail","VerifyAccountEmail","env","fieldHasName","validateURL","validatePostcode","htmlToLexical","lexicalToHtml","SEOFields","findBySlug","fieldMapper","schemas","addGoJSONSchema"],"mappings":"AAAA,cAAc;AACd,SAASA,aAAa,QAAQ,cAAc;AAgB5C,SAASC,KAAK,EAAEC,UAAU,EAAEC,kBAAkB,EAAEC,SAAS,QAAQ,yBAAyB;AAI1F,SAASC,QAAQ,EAAEC,UAAU,EAAEC,SAAS,EAAEC,SAAS,QAAQ,qBAAqB;AAEhF,mBAAmB;AACnB,SAASC,mBAAmB,QAAQ,iCAAiC;AAErE,SAASC,kBAAkB,QAAQ,gCAAgC;AAOnE,YAAY;AACZ,SACCC,GAAG,EACHC,YAAY,EACZC,WAAW,EACXC,gBAAgB,EAChBC,aAAa,EACbC,aAAa,QACP,kBAAkB;AAEzB,kBAAkB;AAClB,SAASC,SAAS,QAAQ,oBAAoB;AAE9C,YAAY;AACZ,SAASC,UAAU,QAAQ,uBAAuB;AAIlD,SAASC,WAAW,EAAEC,OAAO,EAAEC,eAAe,QAAQ,qBAAqB"}

package/dist/plugin.d.ts

@@ -0,0 +1,9 @@
+import type { Config } from 'payload';
+import type { PayloadHelperPluginConfig } from './types.js';
+/**
+ * Payload Helper Plugin for websites at ainsley.dev
+ *
+ * @constructor
+ * @param pluginOptions
+ */
+export declare const payloadHelper: (pluginOptions: PayloadHelperPluginConfig) => (incomingConfig: Config) => Config;

package/dist/plugin.js

@@ -0,0 +1,78 @@
+import { injectAdminIcon, injectAdminLogo } from './plugin/admin.js';
+import { injectEmailTemplates } from './plugin/email.js';
+import { cacheHookCollections, cacheHookGlobals } from './plugin/hooks.js';
+/**
+ * Payload Helper Plugin for websites at ainsley.dev
+ *
+ * @constructor
+ * @param pluginOptions
+ */ export const payloadHelper = (pluginOptions)=>(incomingConfig)=>{
+        // TODO: Validate Config
+        let config = incomingConfig;
+        // Update typescript generation file
+        config.typescript = config.typescript || {};
+        config.typescript.outputFile = './src/types/payload.ts';
+        // Inject admin Logo component if logo config is provided
+        if (pluginOptions.admin?.logo) {
+            config = injectAdminLogo(config, pluginOptions.admin.logo, pluginOptions.siteName);
+        }
+        // Inject admin Icon component if icon config is provided
+        if (pluginOptions.admin?.icon) {
+            config = injectAdminIcon(config, pluginOptions.admin.icon, pluginOptions.siteName);
+        }
+        // Inject email templates for auth-enabled collections if email config is provided
+        if (pluginOptions.email) {
+            config = injectEmailTemplates(config, pluginOptions.email);
+        }
+        // Map collections & add hooks
+        config.collections = (config.collections || []).map((collection)=>{
+            if (collection.upload !== undefined && collection.upload !== true) {
+                return collection;
+            }
+            const hooks = collection.hooks || {};
+            // Add afterChange hook only if webServer is defined
+            if (pluginOptions.webServer) {
+                hooks.afterChange = [
+                    ...hooks.afterChange || [],
+                    cacheHookCollections({
+                        server: pluginOptions.webServer,
+                        slug: collection.slug,
+                        fields: collection.fields,
+                        isCollection: true
+                    })
+                ];
+            }
+            return {
+                ...collection,
+                hooks
+            };
+        });
+        // Map globals & add hooks
+        config.globals = (config.globals || []).map((global)=>{
+            const hooks = global.hooks || {};
+            // Add afterChange hook only if webServer is defined
+            if (pluginOptions.webServer) {
+                hooks.afterChange = [
+                    ...hooks.afterChange || [],
+                    cacheHookGlobals({
+                        server: pluginOptions.webServer,
+                        slug: global.slug,
+                        fields: global.fields,
+                        isCollection: true
+                    })
+                ];
+            }
+            return {
+                ...global,
+                hooks
+            };
+        });
+        // Store plugin options in config.custom for CLI access (e.g., preview-emails command)
+        config.custom = {
+            ...config.custom,
+            payloadHelperOptions: pluginOptions
+        };
+        return config;
+    };
+
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["import type { CollectionConfig, Config } from 'payload';\nimport { injectAdminIcon, injectAdminLogo } from './plugin/admin.js';\nimport { injectEmailTemplates } from './plugin/email.js';\nimport { cacheHookCollections, cacheHookGlobals } from './plugin/hooks.js';\nimport type { PayloadHelperPluginConfig } from './types.js';\n\n/**\n * Payload Helper Plugin for websites at ainsley.dev\n *\n * @constructor\n * @param pluginOptions\n */\nexport const payloadHelper =\n\t(pluginOptions: PayloadHelperPluginConfig) =>\n\t(incomingConfig: Config): Config => {\n\t\t// TODO: Validate Config\n\n\t\tlet config = incomingConfig;\n\n\t\t// Update typescript generation file\n\t\tconfig.typescript = config.typescript || {};\n\t\tconfig.typescript.outputFile = './src/types/payload.ts';\n\n\t\t// Inject admin Logo component if logo config is provided\n\t\tif (pluginOptions.admin?.logo) {\n\t\t\tconfig = injectAdminLogo(config, pluginOptions.admin.logo, pluginOptions.siteName);\n\t\t}\n\n\t\t// Inject admin Icon component if icon config is provided\n\t\tif (pluginOptions.admin?.icon) {\n\t\t\tconfig = injectAdminIcon(config, pluginOptions.admin.icon, pluginOptions.siteName);\n\t\t}\n\n\t\t// Inject email templates for auth-enabled collections if email config is provided\n\t\tif (pluginOptions.email) {\n\t\t\tconfig = injectEmailTemplates(config, pluginOptions.email);\n\t\t}\n\n\t\t// Map collections & add hooks\n\t\tconfig.collections = (config.collections || []).map((collection): CollectionConfig => {\n\t\t\tif (collection.upload !== undefined && collection.upload !== true) {\n\t\t\t\treturn collection;\n\t\t\t}\n\n\t\t\tconst hooks = collection.hooks || {};\n\n\t\t\t// Add afterChange hook only if webServer is defined\n\t\t\tif (pluginOptions.webServer) {\n\t\t\t\thooks.afterChange = [\n\t\t\t\t\t...(hooks.afterChange || []),\n\t\t\t\t\tcacheHookCollections({\n\t\t\t\t\t\tserver: pluginOptions.webServer,\n\t\t\t\t\t\tslug: collection.slug,\n\t\t\t\t\t\tfields: collection.fields,\n\t\t\t\t\t\tisCollection: true,\n\t\t\t\t\t}),\n\t\t\t\t];\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\t...collection,\n\t\t\t\thooks,\n\t\t\t};\n\t\t});\n\n\t\t// Map globals & add hooks\n\t\tconfig.globals = (config.globals || []).map((global) => {\n\t\t\tconst hooks = global.hooks || {};\n\n\t\t\t// Add afterChange hook only if webServer is defined\n\t\t\tif (pluginOptions.webServer) {\n\t\t\t\thooks.afterChange = [\n\t\t\t\t\t...(hooks.afterChange || []),\n\t\t\t\t\tcacheHookGlobals({\n\t\t\t\t\t\tserver: pluginOptions.webServer,\n\t\t\t\t\t\tslug: global.slug,\n\t\t\t\t\t\tfields: global.fields,\n\t\t\t\t\t\tisCollection: true,\n\t\t\t\t\t}),\n\t\t\t\t];\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\t...global,\n\t\t\t\thooks,\n\t\t\t};\n\t\t});\n\n\t\t// Store plugin options in config.custom for CLI access (e.g., preview-emails command)\n\t\tconfig.custom = {\n\t\t\t...config.custom,\n\t\t\tpayloadHelperOptions: pluginOptions,\n\t\t};\n\n\t\treturn config;\n\t};\n"],"names":["injectAdminIcon","injectAdminLogo","injectEmailTemplates","cacheHookCollections","cacheHookGlobals","payloadHelper","pluginOptions","incomingConfig","config","typescript","outputFile","admin","logo","siteName","icon","email","collections","map","collection","upload","undefined","hooks","webServer","afterChange","server","slug","fields","isCollection","globals","global","custom","payloadHelperOptions"],"mappings":"AACA,SAASA,eAAe,EAAEC,eAAe,QAAQ,oBAAoB;AACrE,SAASC,oBAAoB,QAAQ,oBAAoB;AACzD,SAASC,oBAAoB,EAAEC,gBAAgB,QAAQ,oBAAoB;AAG3E;;;;;CAKC,GACD,OAAO,MAAMC,gBACZ,CAACC,gBACD,CAACC;QACA,wBAAwB;QAExB,IAAIC,SAASD;QAEb,oCAAoC;QACpCC,OAAOC,UAAU,GAAGD,OAAOC,UAAU,IAAI,CAAC;QAC1CD,OAAOC,UAAU,CAACC,UAAU,GAAG;QAE/B,yDAAyD;QACzD,IAAIJ,cAAcK,KAAK,EAAEC,MAAM;YAC9BJ,SAASP,gBAAgBO,QAAQF,cAAcK,KAAK,CAACC,IAAI,EAAEN,cAAcO,QAAQ;QAClF;QAEA,yDAAyD;QACzD,IAAIP,cAAcK,KAAK,EAAEG,MAAM;YAC9BN,SAASR,gBAAgBQ,QAAQF,cAAcK,KAAK,CAACG,IAAI,EAAER,cAAcO,QAAQ;QAClF;QAEA,kFAAkF;QAClF,IAAIP,cAAcS,KAAK,EAAE;YACxBP,SAASN,qBAAqBM,QAAQF,cAAcS,KAAK;QAC1D;QAEA,8BAA8B;QAC9BP,OAAOQ,WAAW,GAAG,AAACR,CAAAA,OAAOQ,WAAW,IAAI,EAAE,AAAD,EAAGC,GAAG,CAAC,CAACC;YACpD,IAAIA,WAAWC,MAAM,KAAKC,aAAaF,WAAWC,MAAM,KAAK,MAAM;gBAClE,OAAOD;YACR;YAEA,MAAMG,QAAQH,WAAWG,KAAK,IAAI,CAAC;YAEnC,oDAAoD;YACpD,IAAIf,cAAcgB,SAAS,EAAE;gBAC5BD,MAAME,WAAW,GAAG;uBACfF,MAAME,WAAW,IAAI,EAAE;oBAC3BpB,qBAAqB;wBACpBqB,QAAQlB,cAAcgB,SAAS;wBAC/BG,MAAMP,WAAWO,IAAI;wBACrBC,QAAQR,WAAWQ,MAAM;wBACzBC,cAAc;oBACf;iBACA;YACF;YAEA,OAAO;gBACN,GAAGT,UAAU;gBACbG;YACD;QACD;QAEA,0BAA0B;QAC1Bb,OAAOoB,OAAO,GAAG,AAACpB,CAAAA,OAAOoB,OAAO,IAAI,EAAE,AAAD,EAAGX,GAAG,CAAC,CAACY;YAC5C,MAAMR,QAAQQ,OAAOR,KAAK,IAAI,CAAC;YAE/B,oDAAoD;YACpD,IAAIf,cAAcgB,SAAS,EAAE;gBAC5BD,MAAME,WAAW,GAAG;uBACfF,MAAME,WAAW,IAAI,EAAE;oBAC3BnB,iBAAiB;wBAChBoB,QAAQlB,cAAcgB,SAAS;wBAC/BG,MAAMI,OAAOJ,IAAI;wBACjBC,QAAQG,OAAOH,MAAM;wBACrBC,cAAc;oBACf;iBACA;YACF;YAEA,OAAO;gBACN,GAAGE,MAAM;gBACTR;YACD;QACD;QAEA,sFAAsF;QACtFb,OAAOsB,MAAM,GAAG;YACf,GAAGtB,OAAOsB,MAAM;YAChBC,sBAAsBzB;QACvB;QAEA,OAAOE;IACR,EAAE"}

package/dist/util/index.d.ts

@@ -0,0 +1,4 @@
+export { default as env } from './env.js';
+export { fieldHasName } from './fields.js';
+export { validateURL, validatePostcode } from './validation.js';
+export { htmlToLexical, lexicalToHtml } from './lexical.js';

package/dist/util/index.js

@@ -0,0 +1,6 @@
+export { default as env } from './env.js';
+export { fieldHasName } from './fields.js';
+export { validateURL, validatePostcode } from './validation.js';
+export { htmlToLexical, lexicalToHtml } from './lexical.js';
+
+//# sourceMappingURL=index.js.map

package/dist/util/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/util/index.ts"],"sourcesContent":["export { default as env } from './env.js';\nexport { fieldHasName } from './fields.js';\nexport { validateURL, validatePostcode } from './validation.js';\nexport { htmlToLexical, lexicalToHtml } from './lexical.js';\n"],"names":["default","env","fieldHasName","validateURL","validatePostcode","htmlToLexical","lexicalToHtml"],"mappings":"AAAA,SAASA,WAAWC,GAAG,QAAQ,WAAW;AAC1C,SAASC,YAAY,QAAQ,cAAc;AAC3C,SAASC,WAAW,EAAEC,gBAAgB,QAAQ,kBAAkB;AAChE,SAASC,aAAa,EAAEC,aAAa,QAAQ,eAAe"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainsleydev/payload-helper",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Payload CMS utilities, collections and global types for ainsley.dev builds",
   "license": "MIT",
   "type": "module",
@@ -29,6 +29,26 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./collections": {
+      "types": "./dist/collections/index.d.ts",
+      "import": "./dist/collections/index.js"
+    },
+    "./globals": {
+      "types": "./dist/globals/index.d.ts",
+      "import": "./dist/globals/index.js"
+    },
+    "./util": {
+      "types": "./dist/util/index.d.ts",
+      "import": "./dist/util/index.js"
+    },
+    "./common": {
+      "types": "./dist/common/index.d.ts",
+      "import": "./dist/common/index.js"
+    },
+    "./endpoints": {
+      "types": "./dist/endpoints/index.d.ts",
+      "import": "./dist/endpoints/index.js"
+    },
     "./dist/admin/components/*": {
       "types": "./dist/admin/components/*.d.ts",
       "import": "./dist/admin/components/*.js",
@@ -50,8 +70,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@lexical/headless": "0.38.2",
-    "@lexical/html": "0.38.2",
+    "@lexical/headless": "0.39.0",
+    "@lexical/html": "0.39.0",
     "@nouance/payload-better-fields-plugin": "^2.0.2",
     "@payloadcms/db-sqlite": "3.63.0",
     "@payloadcms/plugin-form-builder": "3.63.0",
@@ -62,10 +82,10 @@
     "commander": "^14.0.2",
     "dotenv": "^16.4.5",
     "jsdom": "^27.2.0",
-    "lexical": "0.38.2",
+    "lexical": "0.39.0",
     "mime-types": "^3.0.1",
     "payload": "3.63.0",
-    "@ainsleydev/email-templates": "0.0.3"
+    "@ainsleydev/email-templates": "0.0.4"
   },
   "peerDependencies": {
     "@payloadcms/ui": "3.x",
@@ -79,8 +99,8 @@
     "@types/jest": "^30.0.0",
     "@types/jsdom": "^27.0.0",
     "@types/mime-types": "^3.0.1",
-    "@types/node": "^24.10.1",
-    "@types/react": "^18.3.26",
+    "@types/node": "^25.0.3",
+    "@types/react": "^19.0.0",
     "jest": "^30.2.0",
     "json-schema": "^0.4.0",
     "next": "^16.0.1",
@@ -88,7 +108,7 @@
     "rimraf": "6.1.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.5.4",
-    "vitest": "^2.0.5",
+    "vitest": "^4.0.16",
     "@ainsleydev/eslint-config": "0.0.9"
   },
   "engines": {