@davincicoding/payload-plugin-kit 0.0.1

package/.swcrc

@@ -0,0 +1,18 @@
+{
+  "jsc": {
+    "target": "esnext",
+    "parser": {
+      "syntax": "typescript",
+      "tsx": true
+    },
+    "transform": {
+      "react": {
+        "runtime": "automatic"
+      }
+    }
+  },
+  "module": {
+    "type": "es6"
+  },
+  "sourceMaps": true
+}

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+import type { CollectionConfig } from 'payload';
+export declare const createCollectionConfigFactory: <T extends Record<string, unknown>>(factory: Omit<CollectionConfig, "slug"> | ((options: T & {
+    slug: string;
+}) => Omit<CollectionConfig, "slug">)) => (options: T & {
+    slug: string;
+}) => CollectionConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,eAAO,MAAM,6BAA6B,GACvC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAE5B,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,GAC9B,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,eAE/D,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,gBAG/B,CAAC"}

package/dist/config.js

@@ -0,0 +1,6 @@
+export const createCollectionConfigFactory = (factory)=>(options)=>({
+            slug: options.slug,
+            ...typeof factory === 'function' ? factory(options) : factory
+        });
+
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload';\n\nexport const createCollectionConfigFactory =\n  <T extends Record<string, unknown>>(\n    factory:\n      | Omit<CollectionConfig, 'slug'>\n      | ((options: T & { slug: string }) => Omit<CollectionConfig, 'slug'>),\n  ) =>\n  (options: T & { slug: string }): CollectionConfig => ({\n    slug: options.slug,\n    ...(typeof factory === 'function' ? factory(options) : factory),\n  });\n"],"names":["createCollectionConfigFactory","factory","options","slug"],"mappings":"AAEA,OAAO,MAAMA,gCACX,CACEC,UAIF,CAACC,UAAqD,CAAA;YACpDC,MAAMD,QAAQC,IAAI;YAClB,GAAI,OAAOF,YAAY,aAAaA,QAAQC,WAAWD,OAAO;QAChE,CAAA,EAAG"}

package/dist/fields.d.ts

@@ -0,0 +1,7 @@
+import type { Field } from 'payload';
+export type FieldWithPath<T extends Field> = T & {
+    path: string[];
+};
+export declare function findFields<T extends Field>(fields: Field[], condition: (field: Field) => field is T, path?: string[]): FieldWithPath<T>[];
+export declare function findFields(fields: Field[], condition: (field: Field) => boolean, path?: string[]): FieldWithPath<Field>[];
+//# sourceMappingURL=fields.d.ts.map

package/dist/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,GAAG;IAC/C,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,wBAAgB,UAAU,CAAC,CAAC,SAAS,KAAK,EACxC,MAAM,EAAE,KAAK,EAAE,EACf,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,IAAI,CAAC,EACvC,IAAI,CAAC,EAAE,MAAM,EAAE,GACd,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;AACtB,wBAAgB,UAAU,CACxB,MAAM,EAAE,KAAK,EAAE,EACf,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,EACpC,IAAI,CAAC,EAAE,MAAM,EAAE,GACd,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC"}

package/dist/fields.js

@@ -0,0 +1,55 @@
+import { uncaughtSwitchCase } from '@davincicoding/payload-utils';
+export function findFields(fields, condition, path = []) {
+    return fields.flatMap((field)=>{
+        if (condition(field)) {
+            return [
+                {
+                    ...field,
+                    path: 'name' in field ? [
+                        ...path,
+                        field.name
+                    ] : path
+                }
+            ];
+        }
+        if ('fields' in field) {
+            return findFields(field.fields, condition, 'name' in field ? [
+                ...path,
+                field.name
+            ] : path);
+        }
+        switch(field.type){
+            case 'blocks':
+                return field.blocks.flatMap((block)=>findFields(block.fields, condition, [
+                        ...path,
+                        field.name
+                    ]));
+            case 'tabs':
+                return field.tabs.flatMap((tab)=>findFields(tab.fields, condition, 'name' in tab ? [
+                        ...path,
+                        tab.name
+                    ] : path));
+            case 'text':
+            case 'richText':
+            case 'number':
+            case 'checkbox':
+            case 'date':
+            case 'email':
+            case 'select':
+            case 'json':
+            case 'code':
+            case 'join':
+            case 'point':
+            case 'radio':
+            case 'textarea':
+            case 'ui':
+            case 'relationship':
+            case 'upload':
+                return [];
+            default:
+                return uncaughtSwitchCase(field);
+        }
+    });
+}
+
+//# sourceMappingURL=fields.js.map

package/dist/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fields.ts"],"sourcesContent":["import { uncaughtSwitchCase } from '@davincicoding/payload-utils';\nimport type { Field } from 'payload';\n\nexport type FieldWithPath<T extends Field> = T & {\n  path: string[];\n};\n\nexport function findFields<T extends Field>(\n  fields: Field[],\n  condition: (field: Field) => field is T,\n  path?: string[],\n): FieldWithPath<T>[];\nexport function findFields(\n  fields: Field[],\n  condition: (field: Field) => boolean,\n  path?: string[],\n): FieldWithPath<Field>[];\nexport function findFields(\n  fields: Field[],\n  condition: (field: Field) => boolean,\n  path: string[] = [],\n): FieldWithPath<Field>[] {\n  return fields.flatMap((field) => {\n    if (condition(field)) {\n      return [\n        { ...field, path: 'name' in field ? [...path, field.name] : path },\n      ];\n    }\n\n    if ('fields' in field) {\n      return findFields(\n        field.fields,\n        condition,\n        'name' in field ? [...path, field.name] : path,\n      );\n    }\n\n    switch (field.type) {\n      case 'blocks':\n        return field.blocks.flatMap((block) =>\n          findFields(block.fields, condition, [...path, field.name]),\n        );\n      case 'tabs':\n        return field.tabs.flatMap((tab) =>\n          findFields(\n            tab.fields,\n            condition,\n            'name' in tab ? [...path, tab.name] : path,\n          ),\n        );\n      case 'text':\n      case 'richText':\n      case 'number':\n      case 'checkbox':\n      case 'date':\n      case 'email':\n      case 'select':\n      case 'json':\n      case 'code':\n      case 'join':\n      case 'point':\n      case 'radio':\n      case 'textarea':\n      case 'ui':\n      case 'relationship':\n      case 'upload':\n        return [];\n      default:\n        return uncaughtSwitchCase(field);\n    }\n  });\n}\n"],"names":["uncaughtSwitchCase","findFields","fields","condition","path","flatMap","field","name","type","blocks","block","tabs","tab"],"mappings":"AAAA,SAASA,kBAAkB,QAAQ,+BAA+B;AAiBlE,OAAO,SAASC,WACdC,MAAe,EACfC,SAAoC,EACpCC,OAAiB,EAAE;IAEnB,OAAOF,OAAOG,OAAO,CAAC,CAACC;QACrB,IAAIH,UAAUG,QAAQ;YACpB,OAAO;gBACL;oBAAE,GAAGA,KAAK;oBAAEF,MAAM,UAAUE,QAAQ;2BAAIF;wBAAME,MAAMC,IAAI;qBAAC,GAAGH;gBAAK;aAClE;QACH;QAEA,IAAI,YAAYE,OAAO;YACrB,OAAOL,WACLK,MAAMJ,MAAM,EACZC,WACA,UAAUG,QAAQ;mBAAIF;gBAAME,MAAMC,IAAI;aAAC,GAAGH;QAE9C;QAEA,OAAQE,MAAME,IAAI;YAChB,KAAK;gBACH,OAAOF,MAAMG,MAAM,CAACJ,OAAO,CAAC,CAACK,QAC3BT,WAAWS,MAAMR,MAAM,EAAEC,WAAW;2BAAIC;wBAAME,MAAMC,IAAI;qBAAC;YAE7D,KAAK;gBACH,OAAOD,MAAMK,IAAI,CAACN,OAAO,CAAC,CAACO,MACzBX,WACEW,IAAIV,MAAM,EACVC,WACA,UAAUS,MAAM;2BAAIR;wBAAMQ,IAAIL,IAAI;qBAAC,GAAGH;YAG5C,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;gBACH,OAAO,EAAE;YACX;gBACE,OAAOJ,mBAAmBM;QAC9B;IACF;AACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from '@davincicoding/payload-utils';
+export { createCollectionConfigFactory } from './config';
+export { type FieldWithPath, findFields } from './fields';
+export { defineProcedure, type Procedure, type ProcedureBuilder, } from './procedure';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,KAAK,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,EACL,eAAe,EACf,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// Re-export everything from payload-utils
+export * from '@davincicoding/payload-utils';
+export { createCollectionConfigFactory } from './config';
+export { findFields } from './fields';
+// Plugin-kit specific exports
+export { defineProcedure } from './procedure';
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Re-export everything from payload-utils\nexport * from '@davincicoding/payload-utils';\nexport { createCollectionConfigFactory } from './config';\nexport { type FieldWithPath, findFields } from './fields';\n// Plugin-kit specific exports\nexport {\n  defineProcedure,\n  type Procedure,\n  type ProcedureBuilder,\n} from './procedure';\n"],"names":["createCollectionConfigFactory","findFields","defineProcedure"],"mappings":"AAAA,0CAA0C;AAC1C,cAAc,+BAA+B;AAC7C,SAASA,6BAA6B,QAAQ,WAAW;AACzD,SAA6BC,UAAU,QAAQ,WAAW;AAC1D,8BAA8B;AAC9B,SACEC,eAAe,QAGV,cAAc"}

package/dist/procedure.d.ts

@@ -0,0 +1,34 @@
+import type { Endpoint, PayloadRequest } from 'payload';
+type Method = 'get' | 'post' | 'put' | 'patch' | 'delete';
+/** Any Zod-like schema with safeParse and inferred output */
+interface ZodLike<TOutput = unknown> {
+    safeParse(data: unknown): {
+        success: true;
+        data: TOutput;
+    } | {
+        success: false;
+        error: unknown;
+    };
+}
+type InferOutput<T> = T extends ZodLike<infer O> ? O : never;
+interface ProcedureConfig<TSchema extends ZodLike | undefined = undefined> {
+    path: `/${string}`;
+    method: Method;
+    input?: TSchema;
+}
+export interface Procedure<TInput, TOutput> {
+    path: `/${string}`;
+    method: Method;
+    endpoint(handler: (req: PayloadRequest, ...args: TInput extends void ? [] : [input: TInput]) => Promise<unknown | Response>): Endpoint;
+    call(apiUrl: string, ...args: TInput extends void ? [] : [input: TInput]): Promise<TOutput>;
+}
+export interface ProcedureBuilder<TInput> {
+    path: string;
+    method: Method;
+    returns<TOutput>(): Procedure<TInput, TOutput>;
+    endpoint(handler: (req: PayloadRequest, ...args: TInput extends void ? [] : [input: TInput]) => Promise<unknown | Response>): Endpoint;
+    call(apiUrl: string, ...args: TInput extends void ? [] : [input: TInput]): Promise<unknown>;
+}
+export declare function defineProcedure<TSchema extends ZodLike | undefined = undefined>(config: ProcedureConfig<TSchema>): ProcedureBuilder<TSchema extends ZodLike ? InferOutput<TSchema> : void>;
+export {};
+//# sourceMappingURL=procedure.d.ts.map

package/dist/procedure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure.d.ts","sourceRoot":"","sources":["../src/procedure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAExD,KAAK,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1D,6DAA6D;AAC7D,UAAU,OAAO,CAAC,OAAO,GAAG,OAAO;IACjC,SAAS,CACP,IAAI,EAAE,OAAO,GACZ;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1E;AAED,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE7D,UAAU,eAAe,CAAC,OAAO,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS;IACvE,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,SAAS,CAAC,MAAM,EAAE,OAAO;IACxC,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CACN,OAAO,EAAE,CACP,GAAG,EAAE,cAAc,EACnB,GAAG,IAAI,EAAE,MAAM,SAAS,IAAI,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,KAChD,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,GAC/B,QAAQ,CAAC;IACZ,IAAI,CACF,MAAM,EAAE,MAAM,EACd,GAAG,IAAI,EAAE,MAAM,SAAS,IAAI,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAClD,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB,CAAC,MAAM;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,QAAQ,CACN,OAAO,EAAE,CACP,GAAG,EAAE,cAAc,EACnB,GAAG,IAAI,EAAE,MAAM,SAAS,IAAI,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,KAChD,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,GAC/B,QAAQ,CAAC;IACZ,IAAI,CACF,MAAM,EAAE,MAAM,EACd,GAAG,IAAI,EAAE,MAAM,SAAS,IAAI,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAClD,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AA4GD,wBAAgB,eAAe,CAC7B,OAAO,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EAE/C,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,GAC/B,gBAAgB,CAAC,OAAO,SAAS,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAazE"}

package/dist/procedure.js

@@ -0,0 +1,111 @@
+function wrapOutput(output) {
+    if (output instanceof Response) return output;
+    return Response.json(output);
+}
+function createProcedure(config, inputSchema) {
+    return {
+        path: config.path,
+        method: config.method,
+        endpoint (handler) {
+            return {
+                path: config.path,
+                method: config.method,
+                handler: async (req)=>{
+                    if (inputSchema) {
+                        if (config.method === 'get') {
+                            const routeParams = req.routeParams ?? {};
+                            const searchParams = req.searchParams ? Object.fromEntries(req.searchParams.entries()) : {};
+                            const merged = {
+                                ...searchParams,
+                                ...routeParams
+                            };
+                            const result = inputSchema.safeParse(merged);
+                            if (!result.success) {
+                                return Response.json({
+                                    error: result.error
+                                }, {
+                                    status: 400
+                                });
+                            }
+                            // biome-ignore lint/complexity/noBannedTypes: ugly type cast
+                            const output = await handler(req, result.data);
+                            return wrapOutput(output);
+                        }
+                        const { addDataAndFileToRequest } = await import(/* webpackIgnore: true */ 'payload');
+                        await addDataAndFileToRequest(req);
+                        const result = inputSchema.safeParse(req.data);
+                        if (!result.success) {
+                            return Response.json({
+                                error: result.error
+                            }, {
+                                status: 400
+                            });
+                        }
+                        // biome-ignore lint/complexity/noBannedTypes: ugly type cast
+                        const output = await handler(req, result.data);
+                        return wrapOutput(output);
+                    }
+                    // biome-ignore lint/complexity/noBannedTypes: ugly type cast
+                    const output = await handler(req);
+                    return wrapOutput(output);
+                }
+            };
+        },
+        call (apiUrl, ...args) {
+            const input = args[0];
+            if (config.method === 'get') {
+                let resolvedPath = config.path;
+                const queryParams = {};
+                if (input) {
+                    for (const [key, value] of Object.entries(input)){
+                        if (value == null) continue;
+                        if (resolvedPath.includes(`:${key}`)) {
+                            resolvedPath = resolvedPath.replace(`:${key}`, encodeURIComponent(String(value)));
+                        } else {
+                            queryParams[key] = String(value);
+                        }
+                    }
+                }
+                const queryString = new URLSearchParams(queryParams).toString();
+                const url = `${apiUrl}${resolvedPath}${queryString ? `?${queryString}` : ''}`;
+                return fetch(url, {
+                    method: 'GET',
+                    credentials: 'include'
+                }).then(async (response)=>{
+                    if (!response.ok) {
+                        throw new Error(`Request failed: ${response.status} ${response.statusText}`);
+                    }
+                    return response.json();
+                });
+            }
+            const url = `${apiUrl}${config.path}`;
+            return fetch(url, {
+                method: config.method.toUpperCase(),
+                credentials: 'include',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: input ? JSON.stringify(input) : undefined
+            }).then(async (response)=>{
+                if (!response.ok) {
+                    throw new Error(`Request failed: ${response.status} ${response.statusText}`);
+                }
+                return response.json();
+            });
+        }
+    };
+}
+export function defineProcedure(config) {
+    const proc = createProcedure(config, config.input);
+    return {
+        path: config.path,
+        method: config.method,
+        returns () {
+            return createProcedure(config, config.input);
+        },
+        endpoint: proc.endpoint,
+        call: proc.call
+    };
+}
+
+//# sourceMappingURL=procedure.js.map

package/dist/procedure.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/procedure.ts"],"sourcesContent":["import type { Endpoint, PayloadRequest } from 'payload';\n\ntype Method = 'get' | 'post' | 'put' | 'patch' | 'delete';\n\n/** Any Zod-like schema with safeParse and inferred output */\ninterface ZodLike<TOutput = unknown> {\n  safeParse(\n    data: unknown,\n  ): { success: true; data: TOutput } | { success: false; error: unknown };\n}\n\ntype InferOutput<T> = T extends ZodLike<infer O> ? O : never;\n\ninterface ProcedureConfig<TSchema extends ZodLike | undefined = undefined> {\n  path: `/${string}`;\n  method: Method;\n  input?: TSchema;\n}\n\nexport interface Procedure<TInput, TOutput> {\n  path: `/${string}`;\n  method: Method;\n  endpoint(\n    handler: (\n      req: PayloadRequest,\n      ...args: TInput extends void ? [] : [input: TInput]\n    ) => Promise<unknown | Response>,\n  ): Endpoint;\n  call(\n    apiUrl: string,\n    ...args: TInput extends void ? [] : [input: TInput]\n  ): Promise<TOutput>;\n}\n\nexport interface ProcedureBuilder<TInput> {\n  path: string;\n  method: Method;\n  returns<TOutput>(): Procedure<TInput, TOutput>;\n  endpoint(\n    handler: (\n      req: PayloadRequest,\n      ...args: TInput extends void ? [] : [input: TInput]\n    ) => Promise<unknown | Response>,\n  ): Endpoint;\n  call(\n    apiUrl: string,\n    ...args: TInput extends void ? [] : [input: TInput]\n  ): Promise<unknown>;\n}\n\nfunction wrapOutput(output: unknown): Response {\n  if (output instanceof Response) return output;\n  return Response.json(output);\n}\n\nfunction createProcedure<TInput, TOutput>(\n  config: ProcedureConfig<ZodLike | undefined>,\n  inputSchema: ZodLike | undefined,\n): Procedure<TInput, TOutput> {\n  return {\n    path: config.path,\n    method: config.method,\n    endpoint(handler) {\n      return {\n        path: config.path,\n        method: config.method,\n        handler: async (req) => {\n          if (inputSchema) {\n            if (config.method === 'get') {\n              const routeParams = req.routeParams ?? {};\n              const searchParams = req.searchParams\n                ? Object.fromEntries(req.searchParams.entries())\n                : {};\n              const merged = { ...searchParams, ...routeParams };\n              const result = inputSchema.safeParse(merged);\n              if (!result.success) {\n                return Response.json({ error: result.error }, { status: 400 });\n              }\n              // biome-ignore lint/complexity/noBannedTypes: ugly type cast\n              const output = await (handler as Function)(req, result.data);\n              return wrapOutput(output);\n            }\n\n            const { addDataAndFileToRequest } = await import(\n              /* webpackIgnore: true */ 'payload'\n            );\n            await addDataAndFileToRequest(req);\n            const result = inputSchema.safeParse(req.data);\n            if (!result.success) {\n              return Response.json({ error: result.error }, { status: 400 });\n            }\n            // biome-ignore lint/complexity/noBannedTypes: ugly type cast\n            const output = await (handler as Function)(req, result.data);\n            return wrapOutput(output);\n          }\n          // biome-ignore lint/complexity/noBannedTypes: ugly type cast\n          const output = await (handler as Function)(req);\n          return wrapOutput(output);\n        },\n      };\n    },\n    call(apiUrl, ...args) {\n      const input = args[0] as Record<string, unknown> | undefined;\n\n      if (config.method === 'get') {\n        let resolvedPath = config.path;\n        const queryParams: Record<string, string> = {};\n\n        if (input) {\n          for (const [key, value] of Object.entries(input)) {\n            if (value == null) continue;\n            if (resolvedPath.includes(`:${key}`)) {\n              resolvedPath = resolvedPath.replace(\n                `:${key}`,\n                encodeURIComponent(String(value)),\n              ) as `/${string}`;\n            } else {\n              queryParams[key] = String(value);\n            }\n          }\n        }\n\n        const queryString = new URLSearchParams(queryParams).toString();\n        const url = `${apiUrl}${resolvedPath}${queryString ? `?${queryString}` : ''}`;\n\n        return fetch(url, {\n          method: 'GET',\n          credentials: 'include',\n        }).then(async (response) => {\n          if (!response.ok) {\n            throw new Error(\n              `Request failed: ${response.status} ${response.statusText}`,\n            );\n          }\n          return response.json();\n        }) as Promise<TOutput>;\n      }\n\n      const url = `${apiUrl}${config.path}`;\n      return fetch(url, {\n        method: config.method.toUpperCase(),\n        credentials: 'include',\n        headers: { 'Content-Type': 'application/json' },\n        body: input ? JSON.stringify(input) : undefined,\n      }).then(async (response) => {\n        if (!response.ok) {\n          throw new Error(\n            `Request failed: ${response.status} ${response.statusText}`,\n          );\n        }\n        return response.json();\n      }) as Promise<TOutput>;\n    },\n  };\n}\n\nexport function defineProcedure<\n  TSchema extends ZodLike | undefined = undefined,\n>(\n  config: ProcedureConfig<TSchema>,\n): ProcedureBuilder<TSchema extends ZodLike ? InferOutput<TSchema> : void> {\n  type TInput = TSchema extends ZodLike ? InferOutput<TSchema> : undefined;\n  const proc = createProcedure<TInput, unknown>(config, config.input);\n\n  return {\n    path: config.path,\n    method: config.method,\n    returns<TOutput>(): Procedure<TInput, TOutput> {\n      return createProcedure<TInput, TOutput>(config, config.input);\n    },\n    endpoint: proc.endpoint as unknown as ProcedureBuilder<TInput>['endpoint'],\n    call: proc.call as ProcedureBuilder<TInput>['call'],\n  };\n}\n"],"names":["wrapOutput","output","Response","json","createProcedure","config","inputSchema","path","method","endpoint","handler","req","routeParams","searchParams","Object","fromEntries","entries","merged","result","safeParse","success","error","status","data","addDataAndFileToRequest","call","apiUrl","args","input","resolvedPath","queryParams","key","value","includes","replace","encodeURIComponent","String","queryString","URLSearchParams","toString","url","fetch","credentials","then","response","ok","Error","statusText","toUpperCase","headers","body","JSON","stringify","undefined","defineProcedure","proc","returns"],"mappings":"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"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@davincicoding/payload-plugin-kit",
+  "version": "0.0.1",
+  "description": "Developer toolkit for building Payload CMS plugins — procedures, field utilities, build scripts, and base configuration.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/davincicoding-org/payload-plugins.git",
+    "directory": "packages/plugin-kit"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./base.tsconfig.json": "./tsconfig.base.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "generate-types": "./scripts/generate-types.js",
+    "plugin-build": "./scripts/build.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "tsconfig.base.json",
+    ".swcrc"
+  ],
+  "scripts": {
+    "build": "swc src -d dist --config-file .swcrc --strip-leading-paths --ignore '**/*.test.ts' && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "check:types": "tsc --noEmit",
+    "clean": "rm -rf dist && rm -rf node_modules",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@commander-js/extra-typings": "^14.0.0",
+    "@davincicoding/payload-utils": "workspace:*",
+    "@swc/cli": "^0.6.0",
+    "@swc/core": "^1.11.0",
+    "commander": "^14.0.2",
+    "tsc-alias": "^1.8.0",
+    "tsx": "^4.0.0",
+    "zod": "catalog:"
+  },
+  "devDependencies": {
+    "@payloadcms/ui": "catalog:payload-stack",
+    "@types/node": "^22.5.4",
+    "payload": "catalog:payload-stack",
+    "typescript": "catalog:payload-stack",
+    "vitest": "^3.1.2"
+  },
+  "peerDependencies": {
+    "payload": ">=3.72.0"
+  },
+  "engines": {
+    "node": "^18.20.2 || >=20.9.0"
+  }
+}

package/scripts/build.js

@@ -0,0 +1,141 @@
+#!/usr/bin/env node
+// @ts-check
+import { execSync, spawn } from 'node:child_process';
+import {
+  copyFileSync,
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  rmSync,
+  watch,
+  writeFileSync,
+} from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Command } from '@commander-js/extra-typings';
+
+const program = new Command()
+  .name('plugin-build')
+  .description('Build a Payload plugin using SWC + tsc')
+  .option('-w, --watch', 'run in watch mode')
+  .parse();
+
+const opts = program.opts();
+const cwd = process.cwd();
+const commonDir = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
+const swcrc = path.join(commonDir, '.swcrc');
+
+// Local bin first (package's own tsc), then common bin (swc, tsc-alias)
+const localBin = path.join(cwd, 'node_modules', '.bin');
+const commonBin = path.join(commonDir, 'node_modules', '.bin');
+process.env.PATH = [localBin, commonBin, process.env.PATH].join(path.delimiter);
+
+const ASSET_RE = /\.(css|scss|html|json|ttf|woff|woff2|eot|svg|jpg|png)$/;
+const SWC_IGNORE =
+  '**/*.test.ts,**/*.test.tsx,**/*.spec.ts,**/*.spec.tsx,**/payload-types.ts';
+const tsconfig = existsSync(path.join(cwd, 'tsconfig.build.json'))
+  ? 'tsconfig.build.json'
+  : 'tsconfig.json';
+
+// Note: execSync is used here with hardcoded build tool commands (swc, tsc, tsc-alias)
+// and no user-controlled input, so shell injection is not a concern.
+/** @param {string} cmd @param {import('node:child_process').ExecSyncOptions} [o] */
+const exec = (cmd, o) => execSync(cmd, { cwd, stdio: 'inherit', ...o });
+
+/**
+ * Remove the `declare module 'payload'` augmentation from the built
+ * payload-types.d.ts so plugins don't pollute the consumer's type space.
+ * The interfaces themselves (User, Notification, etc.) are kept so that
+ * exported plugin types referencing them still resolve.
+ */
+function stripPayloadAugmentation() {
+  const dts = path.join(cwd, 'dist', 'payload-types.d.ts');
+  if (!existsSync(dts)) return;
+  const content = readFileSync(dts, 'utf-8');
+  const stripped = content.replace(
+    /\n*declare module ['"]payload['"] \{[\s\S]*?\n\}\n/,
+    '\n',
+  );
+  if (stripped !== content) writeFileSync(dts, stripped);
+}
+
+function copyAssets() {
+  const srcDir = path.join(cwd, 'src');
+  if (!existsSync(srcDir)) return;
+  for (const entry of readdirSync(srcDir, { recursive: true })) {
+    const file = String(entry);
+    if (!ASSET_RE.test(file)) continue;
+    const dest = path.join(cwd, 'dist', file);
+    mkdirSync(path.dirname(dest), { recursive: true });
+    copyFileSync(path.join(srcDir, file), dest);
+  }
+}
+
+if (opts.watch) {
+  /** @type {import('node:child_process').ChildProcess[]} */
+  const children = [];
+  const cleanup = () => {
+    for (const c of children) c.kill();
+  };
+  process.on('SIGINT', cleanup);
+  process.on('SIGTERM', cleanup);
+  process.on('exit', cleanup);
+
+  /** @param {string} cmd @param {string[]} args */
+  const start = (cmd, args) => {
+    const child = spawn(cmd, args, { cwd, stdio: 'inherit', shell: true });
+    child.on('error', (err) => {
+      process.stderr.write(`[${cmd}] ${err.message}\n`);
+      process.exit(1);
+    });
+    children.push(child);
+  };
+
+  copyAssets();
+
+  const srcDir = path.join(cwd, 'src');
+  watch(srcDir, { recursive: true }, (_event, filename) => {
+    if (!filename || !ASSET_RE.test(filename)) return;
+    const src = path.join(srcDir, filename);
+    if (!existsSync(src)) return;
+    const dest = path.join(cwd, 'dist', filename);
+    mkdirSync(path.dirname(dest), { recursive: true });
+    copyFileSync(src, dest);
+  });
+
+  start('swc', [
+    'src',
+    '-d',
+    'dist',
+    '--config-file',
+    swcrc,
+    '--strip-leading-paths',
+    '--ignore',
+    SWC_IGNORE,
+    '--watch',
+  ]);
+  start('tsc', [
+    '-p',
+    tsconfig,
+    '--emitDeclarationOnly',
+    '--watch',
+    '--preserveWatchOutput',
+  ]);
+  start('tsc-alias', ['-p', tsconfig, '--watch']);
+} else {
+  if (existsSync(path.join(cwd, 'dist')))
+    rmSync(path.join(cwd, 'dist'), { recursive: true, force: true });
+  for (const f of ['tsconfig.tsbuildinfo', 'tsconfig.build.tsbuildinfo']) {
+    const p = path.join(cwd, f);
+    if (existsSync(p)) rmSync(p);
+  }
+
+  copyAssets();
+  exec(
+    `swc src -d dist --config-file "${swcrc}" --strip-leading-paths --ignore "${SWC_IGNORE}"`,
+  );
+  exec(`tsc -p ${tsconfig} --emitDeclarationOnly`);
+  exec(`tsc-alias -p ${tsconfig}`);
+  stripPayloadAugmentation();
+}

package/scripts/generate-types.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+// @ts-check
+
+// tsx v4 requires --import flag. If not already loaded with tsx,
+// respawn this script with the proper flag.
+if (!process.env.__GEN_TYPES_TSX) {
+  const { execFileSync } = await import('node:child_process');
+  const { fileURLToPath, pathToFileURL } = await import('node:url');
+  const { createRequire } = await import('node:module');
+
+  const require = createRequire(import.meta.url);
+  const tsxPath = pathToFileURL(require.resolve('tsx')).href;
+
+  process.env.__GEN_TYPES_TSX = '1';
+  try {
+    execFileSync(
+      process.execPath,
+      [
+        '--import',
+        tsxPath,
+        fileURLToPath(import.meta.url),
+        ...process.argv.slice(2),
+      ],
+      { stdio: 'inherit' },
+    );
+  } catch (e) {
+    process.exit(/** @type {any} */ (e).status ?? 1);
+  }
+  process.exit(0);
+}
+
+// Note: execSync is used here with a hardcoded npx payload command
+// and no user-controlled input, so shell injection is not a concern.
+import { execSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { Command, InvalidArgumentError } from '@commander-js/extra-typings';
+
+const cwd = process.cwd();
+
+const program = new Command()
+  .name('generate-types')
+  .description('Generate Payload types for a plugin')
+  .option(
+    '-e, --export <name>',
+    'plugin export name (default: derived from package name)',
+  )
+  .option(
+    '-o, --opt <key=value>',
+    'plugin option (repeatable)',
+    (val, acc) => {
+      const eq = val.indexOf('=');
+      if (eq === -1)
+        throw new InvalidArgumentError(`expected key=value, got "${val}"`);
+      acc[val.slice(0, eq)] = val.slice(eq + 1);
+      return acc;
+    },
+    /** @type {Record<string, string>} */ ({}),
+  )
+  .parse();
+
+const plugin = await resolvePlugin();
+const configPath = generateMinimalPayloadConfig(plugin);
+try {
+  generateTypes(configPath);
+} finally {
+  cleanup(configPath);
+}
+
+/** @returns {Promise<{ exportName: string; call: string }>} */
+async function resolvePlugin() {
+  const opts = program.opts();
+  const explicit = opts.export != null;
+  const exportName = opts.export ?? deriveExportName();
+
+  const mod = await import(path.join(cwd, 'src/index.ts'));
+  if (typeof mod[exportName] !== 'function') {
+    const fns = Object.entries(mod)
+      .filter(([, v]) => typeof v === 'function')
+      .map(([name]) => name);
+
+    if (explicit) {
+      console.error(
+        `"${exportName}" is not a function export in src/index.ts.`,
+      );
+    } else {
+      console.error(
+        `Could not find a plugin export matching the naming convention "${exportName}").`,
+      );
+    }
+    if (fns.length > 0) {
+      console.error(`Available function exports: ${fns.join(', ')}`);
+      console.error(`Fix: generate-types -e ${fns[0]}`);
+    }
+    process.exit(1);
+  }
+
+  return {
+    exportName,
+    call: `${exportName}(${JSON.stringify(opts.opt)} as any)`,
+  };
+}
+
+/** @returns {string} */
+function deriveExportName() {
+  const pkg = JSON.parse(
+    fs.readFileSync(path.join(cwd, 'package.json'), 'utf-8'),
+  );
+  /** @type {string} */
+  const name = pkg.name.replace(/^payload-/, '');
+  return `${name}-plugin`.replace(/-([a-z])/g, (_, /** @type {string} */ c) =>
+    c.toUpperCase(),
+  );
+}
+
+/**
+ * @param {{ exportName: string; call: string }} plugin
+ * @returns {string}
+ */
+function generateMinimalPayloadConfig(plugin) {
+  const importPath = path.join(cwd, 'src/index').replaceAll('\\', '/');
+  const configPath = path.join(cwd, '.payload-gen.config.ts');
+
+  fs.writeFileSync(
+    configPath,
+    `
+import { buildConfig } from 'payload';
+import { ${plugin.exportName} } from '${importPath}';
+
+export default buildConfig({
+  secret: '',
+  db: {
+    defaultIDType: 'text',
+    init: () => {
+      throw new Error('Not implemented');
+    },
+  },
+  email: ({ payload }) => ({
+    defaultFromAddress: '',
+    defaultFromName: '',
+    name: '',
+    sendEmail: async () => void 0,
+  }),
+  admin: {
+    user: 'users',
+  },
+  collections: [{ slug: 'users', auth: true, fields: [] }],
+  plugins: [${plugin.call}],
+});
+`,
+  );
+  return configPath;
+}
+
+/** @param {string} configPath */
+function generateTypes(configPath) {
+  execSync('npx payload generate:types', {
+    stdio: 'inherit',
+    cwd,
+    env: {
+      ...process.env,
+      PAYLOAD_CONFIG_PATH: configPath,
+      PAYLOAD_TS_OUTPUT_PATH: path.join(cwd, 'src/payload-types.ts'),
+    },
+  });
+}
+
+/** @param {string} configPath */
+function cleanup(configPath) {
+  fs.rmSync(configPath);
+}

package/tsconfig.base.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "lib": ["DOM", "DOM.Iterable", "ESNext"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "target": "ES2022",
+    "jsx": "react-jsx",
+    "jsxImportSource": "react",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "incremental": true,
+    "allowJs": true,
+    "checkJs": true,
+    "composite": true,
+    "declaration": true,
+    "declarationMap": true
+  }
+}