@karixi/payload-ai 0.1.1

package/dist/index.d.mts

@@ -0,0 +1,148 @@
+import { z } from "zod";
+import { Config, PayloadRequest } from "payload";
+
+//#region src/types.d.ts
+/** Plugin configuration */
+type AIPluginConfig = {
+  /** AI provider: 'anthropic' or 'openai' */provider: 'anthropic' | 'openai'; /** Environment variable name for the API key */
+  apiKeyEnvVar: string; /** Feature flags */
+  features?: {
+    /** Enable admin UI components (AI Fill buttons, bulk panel) */adminUI?: boolean; /** Enable dev tools (screenshot, visual diff, form testing) */
+    devTools?: boolean;
+  }; /** Per-collection AI generation config */
+  collections?: Record<string, CollectionAIConfig>; /** Rate limiting */
+  rateLimit?: {
+    maxTokensPerBatch?: number;
+    delayBetweenRequests?: number;
+    maxConcurrentRequests?: number;
+  }; /** Rollback on bulk generation failure */
+  rollbackOnError?: boolean; /** Max concurrent browser instances for dev tools */
+  maxConcurrentBrowserInstances?: number;
+};
+type CollectionAIConfig = {
+  /** Per-field AI generation config */fields?: Record<string, {
+    enabled: boolean;
+    prompt?: string;
+  }>;
+};
+/** AI Provider interface */
+interface AIProvider {
+  generate(prompt: string, outputSchema: Record<string, unknown>): Promise<unknown[]>;
+  analyzeImage(imageBuffer: Buffer): Promise<string>;
+}
+/** Analyzed collection schema */
+type CollectionSchema = {
+  slug: string;
+  fields: FieldSchema[];
+  relationships: RelationshipInfo[];
+  requiredFields: string[];
+  populatable: boolean;
+  lexicalFeatures?: string[];
+};
+/** Analyzed field schema */
+type FieldSchema = {
+  name: string;
+  type: string;
+  required: boolean;
+  path: string;
+  options?: Array<{
+    label: string;
+    value: string;
+  }>;
+  relationTo?: string | string[];
+  hasMany?: boolean;
+  fields?: FieldSchema[];
+  blocks?: Array<{
+    slug: string;
+    fields: FieldSchema[];
+  }>;
+  lexicalFeatures?: string[];
+};
+/** Relationship info between collections */
+type RelationshipInfo = {
+  field: string;
+  collection: string | string[];
+  hasMany: boolean;
+  isSelfReferential: boolean;
+};
+/** Entry in the deletion log for rollback */
+type DeletionLogEntry = {
+  collection: string;
+  id: string;
+  createdAt: Date;
+};
+/** Progress event from bulk operations */
+type ProgressEvent = {
+  phase: string;
+  collection: string;
+  created: number;
+  failed: number;
+  total: number;
+  elapsed: number;
+};
+//#endregion
+//#region src/core/prompt-builder.d.ts
+type GenerationContext = {
+  count: number;
+  theme?: string;
+  locale?: string;
+  existingIds?: Record<string, string[]>;
+};
+//#endregion
+//#region src/mcp/prompts.d.ts
+type MCPPrompt = {
+  name: string;
+  title: string;
+  description: string;
+  argsSchema: Record<string, z.ZodTypeAny>;
+  handler: (args: Record<string, unknown>, req: PayloadRequest, extra: unknown) => {
+    messages: Array<{
+      content: {
+        text: string;
+        type: 'text';
+      };
+      role: 'user' | 'assistant';
+    }>;
+  };
+};
+declare function getAIPrompts(): MCPPrompt[];
+//#endregion
+//#region src/mcp/resources.d.ts
+type MCPResource = {
+  name: string;
+  title: string;
+  description: string;
+  uri: string;
+  mimeType: string;
+  handler: (...args: unknown[]) => {
+    contents: Array<{
+      text: string;
+      uri: string;
+    }>;
+  };
+};
+declare function getAIResources(): MCPResource[];
+//#endregion
+//#region src/mcp/tools.d.ts
+type MCPTool = {
+  name: string;
+  description: string;
+  parameters: Record<string, z.ZodTypeAny>;
+  handler: (args: Record<string, unknown>, req: PayloadRequest, extra: unknown) => Promise<{
+    content: Array<{
+      text: string;
+      type: 'text';
+    }>;
+  }>;
+};
+declare function getAITools(pluginConfig: AIPluginConfig): MCPTool[];
+//#endregion
+//#region src/plugin.d.ts
+/**
+ * Payload AI Plugin — adds AI-powered data generation and admin features.
+ * Auto-injects MCP custom tools if @payloadcms/plugin-mcp is present.
+ */
+declare function aiPlugin(config: AIPluginConfig): (incomingConfig: Config) => Config;
+//#endregion
+export { type AIPluginConfig, type AIProvider, type CollectionAIConfig, type CollectionSchema, type DeletionLogEntry, type FieldSchema, type GenerationContext, type MCPPrompt, type MCPResource, type MCPTool, type ProgressEvent, type RelationshipInfo, aiPlugin, getAIPrompts, getAIResources, getAITools };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/core/prompt-builder.ts","../src/mcp/prompts.ts","../src/mcp/resources.ts","../src/mcp/tools.ts","../src/plugin.ts"],"mappings":";;;;;KACY,cAAA;6CAEV,QAAA,0BAFU;EAIV,YAAA;EAEA,QAAA;IAJA,+DAME,OAAA,YAFF;IAIE,QAAA;EAAA,GAGF;EAAA,WAAA,GAAc,MAAA,SAAe,kBAAA,GAAA;EAE7B,SAAA;IACE,iBAAA;IACA,oBAAA;IACA,qBAAA;EAAA,GAKF;EAFA,eAAA,YAE6B;EAA7B,6BAAA;AAAA;AAAA,KAGU,kBAAA;EAEK,qCAAf,MAAA,GAAS,MAAA;IAGL,OAAA;IACA,MAAA;EAAA;AAAA;;UAMW,UAAA;EACf,QAAA,CAAS,MAAA,UAAgB,YAAA,EAAc,MAAA,oBAA0B,OAAA;EACjE,YAAA,CAAa,WAAA,EAAa,MAAA,GAAS,OAAA;AAAA;;KAIzB,gBAAA;EACV,IAAA;EACA,MAAA,EAAQ,WAAA;EACR,aAAA,EAAe,gBAAA;EACf,cAAA;EACA,WAAA;EACA,eAAA;AAAA;;KAIU,WAAA;EACV,IAAA;EACA,IAAA;EACA,QAAA;EACA,IAAA;EACA,OAAA,GAAU,KAAA;IAAQ,KAAA;IAAe,KAAA;EAAA;EACjC,UAAA;EACA,OAAA;EACA,MAAA,GAAS,WAAA;EACT,MAAA,GAAS,KAAA;IAAQ,IAAA;IAAc,MAAA,EAAQ,WAAA;EAAA;EACvC,eAAA;AAAA;;KAIU,gBAAA;EACV,KAAA;EACA,UAAA;EACA,OAAA;EACA,iBAAA;AAAA;;KAIU,gBAAA;EACV,UAAA;EACA,EAAA;EACA,SAAA,EAAW,IAAA;AAAA;;KAID,aAAA;EACV,KAAA;EACA,UAAA;EACA,OAAA;EACA,MAAA;EACA,KAAA;EACA,OAAA;AAAA;;;KCxFU,iBAAA;EACV,KAAA;EACA,KAAA;EACA,MAAA;EACA,WAAA,GAAc,MAAA;AAAA;;;KCHJ,SAAA;EACV,IAAA;EACA,KAAA;EACA,WAAA;EACA,UAAA,EAAY,MAAA,SAAe,CAAA,CAAE,UAAA;EAC7B,OAAA,GACE,IAAA,EAAM,MAAA,mBACN,GAAA,EAAK,cAAA,EACL,KAAA;IACK,QAAA,EAAU,KAAA;MAAQ,OAAA;QAAW,IAAA;QAAc,IAAA;MAAA;MAAgB,IAAA;IAAA;EAAA;AAAA;AAAA,iBAGpD,YAAA,CAAA,GAAgB,SAAA;;;KCfpB,WAAA;EACV,IAAA;EACA,KAAA;EACA,WAAA;EACA,GAAA;EACA,QAAA;EACA,OAAA,MAAa,IAAA;IAAsB,QAAA,EAAU,KAAA;MAAQ,IAAA;MAAc,GAAA;IAAA;EAAA;AAAA;AAAA,iBAGrD,cAAA,CAAA,GAAkB,WAAA;;;KCDtB,OAAA;EACV,IAAA;EACA,WAAA;EACA,UAAA,EAAY,MAAA,SAAe,CAAA,CAAE,UAAA;EAC7B,OAAA,GACE,IAAA,EAAM,MAAA,mBACN,GAAA,EAAK,cAAA,EACL,KAAA,cACG,OAAA;IAAU,OAAA,EAAS,KAAA;MAAQ,IAAA;MAAc,IAAA;IAAA;EAAA;AAAA;AAAA,iBAGhC,UAAA,CAAW,YAAA,EAAc,cAAA,GAAiB,OAAA;;;;;AJlB1D;;iBKQgB,QAAA,CAAS,MAAA,EAAQ,cAAA,IACvB,cAAA,EAAgB,MAAA,KAAS,MAAA"}