"Claude Code Review workflow"

- Separated server-side and client-safe exports
- Main export now contains only types to prevent bundling server code
- Updated documentation with new import structure

🤖 Generated with [Claude Code](https://claude.ai/code)

.github/workflows/claude-code-review.yml

@@ -0,0 +1,54 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+    
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          prompt: |
+            Please review this pull request and provide feedback on:
+            - Code quality and best practices
+            - Potential bugs or issues
+            - Performance considerations
+            - Security concerns
+            - Test coverage
+            
+            Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
+
+            Use `gh pr comment` with your Bash tool to leave your review as a comment on the PR.
+          
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.anthropic.com/en/docs/claude-code/sdk#command-line for available options
+          claude_args: '--allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'
+

.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.anthropic.com/en/docs/claude-code/sdk#command-line for available options
+          # claude_args: '--model claude-opus-4-1-20250805 --allowed-tools Bash(gh pr:*)'
+

.github/workflows/publish.yml

@@ -0,0 +1,83 @@
+name: Publish to NPM
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 10
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run tests
+        run: pnpm test:int
+
+      - name: Build
+        run: pnpm build
+
+      - name: Check if should publish
+        id: version-check
+        run: |
+          # Get current version from package.json
+          CURRENT_VERSION=$(node -p "require('./package.json').version")
+          echo "current=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+          
+          # Check if this is a version bump commit (created by npm version)
+          COMMIT_MSG=$(git log -1 --pretty=%B)
+          if echo "$COMMIT_MSG" | grep -q "^Release v[0-9]\|^v[0-9]"; then
+            echo "changed=true" >> $GITHUB_OUTPUT
+            echo "Version bump commit detected: $COMMIT_MSG"
+          # Or check if package.json was modified in this commit
+          elif git diff --name-only HEAD~1 HEAD | grep -q "package.json"; then
+            # Check if the version actually changed
+            git show HEAD~1:package.json > prev-package.json 2>/dev/null || echo '{"version":"0.0.0"}' > prev-package.json
+            PREVIOUS_VERSION=$(node -p "require('./prev-package.json').version")
+            
+            if [ "$CURRENT_VERSION" != "$PREVIOUS_VERSION" ]; then
+              echo "changed=true" >> $GITHUB_OUTPUT
+              echo "Version changed from $PREVIOUS_VERSION to $CURRENT_VERSION"
+            else
+              echo "changed=false" >> $GITHUB_OUTPUT
+              echo "package.json modified but version unchanged: $CURRENT_VERSION"
+            fi
+          else
+            echo "changed=false" >> $GITHUB_OUTPUT
+            echo "No version change detected"
+          fi
+
+      - name: Publish to NPM
+        if: steps.version-check.outputs.changed == 'true'
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub Release
+        if: steps.version-check.outputs.changed == 'true'
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: v${{ steps.version-check.outputs.current }}
+          release_name: Release v${{ steps.version-check.outputs.current }}
+          draft: false
+          prerelease: false

README.md

@@ -27,20 +27,40 @@ yarn add @xtr-dev/payload-automation
 
 ```typescript
 import { buildConfig } from 'payload'
-import { payloadAutomation } from '@xtr-dev/payload-automation'
+import { workflowsPlugin } from '@xtr-dev/payload-automation/server'
 
 export default buildConfig({
   // ... your config
   plugins: [
-    payloadAutomation({
+    workflowsPlugin({
-      collections: ['posts', 'users'], // Collections to monitor
+      collectionTriggers: {
-      globals: ['settings'],           // Globals to monitor
+        posts: true,    // Enable all CRUD triggers for posts
+        users: { 
+          create: true, // Only enable create trigger for users
+          update: true
+        }
+      },
       enabled: true,
     }),
   ],
 })
 ```
 
+## Import Structure
+
+The plugin uses separate exports to avoid bundling server-side code in client bundles:
+
+```typescript
+// Server-side plugin and functions
+import { workflowsPlugin } from '@xtr-dev/payload-automation/server'
+
+// Client-side components  
+import { TriggerWorkflowButton } from '@xtr-dev/payload-automation/client'
+
+// Types only (safe for both server and client)
+import type { WorkflowsPluginConfig } from '@xtr-dev/payload-automation'
+```
+
 ## Step Types
 
 - **HTTP Request** - Make external API calls

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@xtr-dev/payload-workflows",
-  "version": "0.0.8",
+  "version": "0.0.11",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@xtr-dev/payload-workflows",
-      "version": "0.0.8",
+      "version": "0.0.11",
       "license": "MIT",
       "dependencies": {
         "jsonpath-plus": "^10.3.0",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xtr-dev/payload-automation",
-  "version": "0.0.8",
+  "version": "0.0.11",
   "description": "PayloadCMS Automation Plugin - Comprehensive workflow automation system with visual workflow building, execution tracking, and step types",
   "license": "MIT",
   "type": "module",
@@ -30,10 +30,10 @@
       "types": "./dist/exports/views.d.ts",
       "default": "./dist/exports/views.js"
     },
-    "./steps": {
+    "./server": {
-      "import": "./dist/steps/index.js",
+      "import": "./dist/exports/server.js",
-      "types": "./dist/steps/index.d.ts",
+      "types": "./dist/exports/server.d.ts",
-      "default": "./dist/steps/index.js"
+      "default": "./dist/exports/server.js"
     }
   },
   "main": "dist/index.js",

src/exports/server.ts

@@ -0,0 +1,26 @@
+// Server-side only exports - should never be bundled for client
+// These contain Node.js dependencies and should only be used server-side
+
+export { triggerCustomWorkflow, triggerWorkflowById } from '../core/trigger-custom-workflow.js'
+export { WorkflowExecutor } from '../core/workflow-executor.js'
+export { workflowsPlugin } from '../plugin/index.js'
+
+// Export all step handlers (server-side only)
+export {
+  createDocumentHandler,
+  deleteDocumentHandler,
+  httpStepHandler,
+  readDocumentHandler,
+  sendEmailHandler,
+  updateDocumentHandler
+} from '../steps/index.js'
+
+// Export step tasks configurations (server-side only)
+export {
+  CreateDocumentStepTask,
+  DeleteDocumentStepTask,
+  HttpRequestStepTask,
+  ReadDocumentStepTask,
+  SendEmailStepTask,
+  UpdateDocumentStepTask
+} from '../steps/index.js'

src/index.ts

@@ -1,19 +1,15 @@
-export { triggerCustomWorkflow, triggerWorkflowById } from './core/trigger-custom-workflow.js'
+// Main export contains only types and client-safe utilities
+// Server-side functions are exported via '@xtr-dev/payload-automation/server'
+
+// Types only - safe for client bundling
 export type { CustomTriggerOptions, TriggerResult } from './core/trigger-custom-workflow.js'
-export { WorkflowExecutor } from './core/workflow-executor.js'
 export type { ExecutionContext, Workflow, WorkflowStep, WorkflowTrigger } from './core/workflow-executor.js'
 export type { WorkflowsPluginConfig } from './plugin/config-types.js'
-export { workflowsPlugin } from './plugin/index.js'
 
-// Export all step tasks
+// Server-side functions are NOT re-exported here to avoid bundling issues
-export {
+// Import server-side functions from the /server export instead
-  CreateDocumentStepTask,
-  DeleteDocumentStepTask,
-  HttpRequestStepTask,
-  ReadDocumentStepTask,
-  SendEmailStepTask,
-  UpdateDocumentStepTask
-} from './steps/index.js'
 
-// UI components are exported via separate client export to avoid CSS import issues during type generation
+// Server functions and plugin should be imported from '/server':
-// Use: import { TriggerWorkflowButton } from '@xtr-dev/payload-automation/client'
+// import { workflowsPlugin } from '@xtr-dev/payload-automation/server'
+// UI components should be imported from '/client':
+// import { TriggerWorkflowButton } from '@xtr-dev/payload-automation/client'

src/plugin/cron-scheduler.ts

@@ -1,6 +1,6 @@
 import type {Config, Payload, TaskConfig} from 'payload'
 
-import * as cron from 'node-cron'
+import cron from 'node-cron'
 
 import {type Workflow, WorkflowExecutor} from '../core/workflow-executor.js'
 import {getConfigLogger} from './logger.js'

src/test/basic.test.ts

@@ -0,0 +1,14 @@
+import { describe, it, expect } from 'vitest'
+
+describe('PayloadCMS Automation Plugin', () => {
+  it('should export the plugin function from server export', async () => {
+    const { workflowsPlugin } = await import('../exports/server.js')
+    expect(workflowsPlugin).toBeDefined()
+    expect(typeof workflowsPlugin).toBe('function')
+  })
+
+  it('should have the correct package name', async () => {
+    // Basic test to ensure the plugin can be imported
+    expect(true).toBe(true)
+  })
+})

vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+  },
+})