feat!: support Payload 4

.claude/settings.json

@@ -1,53 +1,75 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-settings.json",
-  "env": {
-    "NODE_ENV": "development"
-  },
   "permissions": {
     "allow": [
-      "Bash(pnpm install)",
-      "Bash(pnpm test)",
-      "Bash(pnpm test:watch)",
-      "Bash(pnpm lint)",
-      "Bash(pnpm lint:fix)",
-      "Bash(pnpm typecheck)",
-      "Bash(pnpm format)",
-      "Bash(pnpm format:check)",
-      "Bash(pnpm build)",
-      "Bash(vitest *)",
-      "Bash(oxlint *)",
-      "Bash(oxfmt *)",
-      "Bash(tsc *)",
-      "Bash(rslib build *)",
+      "Bash(ls *)",
+      "Bash(cat *)",
+      "Bash(grep *)",
+      "Bash(find *)",
+      "Bash(wc *)",
+      "Bash(head *)",
+      "Bash(tail *)",
       "Bash(git status *)",
+      "Bash(git status)",
       "Bash(git log *)",
       "Bash(git diff *)",
+      "Bash(git diff)",
       "Bash(git show *)",
       "Bash(git branch *)",
-
-      "Bash(rtk pnpm install)",
-      "Bash(rtk vitest *)",
-      "Bash(rtk lint *)",
-      "Bash(rtk tsc *)",
-      "Bash(rtk grep *)",
-      "Bash(rtk ls *)",
-      "Bash(rtk read *)",
-      "Bash(rtk find *)",
-      "Bash(rtk diff *)",
-      "Bash(rtk smart *)",
-      "Bash(rtk json *)",
-      "Bash(rtk pnpm list *)",
-      "Bash(rtk git status *)",
-      "Bash(rtk git log *)",
-      "Bash(rtk git diff *)",
-
-      "WebSearch",
-      "WebFetch",
-
-      "mcp__claude_ai_Context7__resolve-library-id",
-      "mcp__claude_ai_Context7__query-docs",
-      "mcp__plugin_context7_context7__resolve-library-id",
-      "mcp__plugin_context7_context7__query-docs"
-    ]
+      "Bash(git remote *)",
+      "Bash(git describe *)",
+      "Bash(git ls-files *)",
+      "Bash(git rev-parse *)",
+      "Bash(pnpm install)",
+      "Bash(pnpm typecheck*)",
+      "Bash(pnpm build*)",
+      "Bash(pnpm test*)",
+      "Bash(pnpm format*)",
+      "Bash(pnpm lint*)",
+      "Bash(pnpm list *)",
+      "Bash(pnpm why *)",
+      "Bash(pnpm outdated*)",
+      "Bash(pnpm view *)",
+      "Bash(gh pr view *)",
+      "Bash(gh pr list *)",
+      "Bash(gh pr checks *)",
+      "Bash(gh run list *)",
+      "Bash(gh run view *)",
+      "Bash(gh release view *)",
+      "Bash(gh issue view *)"
+    ],
+    "ask": [
+      "Bash(git push *)",
+      "Bash(git tag *)",
+      "Bash(git reset --hard *)",
+      "Bash(gh pr create *)",
+      "Bash(gh pr merge *)",
+      "Bash(gh release create *)",
+      "Bash(gh release edit *)",
+      "Bash(gh release delete *)",
+      "Bash(gh repo edit *)",
+      "Bash(gh repo delete *)",
+      "Bash(gh secret *)",
+      "Bash(gh api *)",
+      "Bash(npm publish *)",
+      "Bash(pnpm publish *)"
+    ],
+    "deny": ["Read(./.env)", "Read(./.env.local)", "Read(./.env.*.local)"]
+  },
+  "attribution": {
+    "commit": "",
+    "pr": ""
+  },
+  "extraKnownMarketplaces": {
+    "seshuk": {
+      "source": { "source": "github", "repo": "maximseshuk/payload-plugin-tooling" }
+    },
+    "payload-marketplace": {
+      "source": { "source": "github", "repo": "payloadcms/payload" }
+    }
+  },
+  "enabledPlugins": {
+    "payload-plugin@seshuk": true,
+    "payload@payload-marketplace": true
   }
 }

.github/ISSUE_TEMPLATE/01-bug-report.yml

@@ -12,7 +12,7 @@ body:
       options:
         - label: I have searched existing issues to ensure this bug hasn't been reported already
           required: true
-        - label: I have read the [documentation](https://github.com/maximseshuk/payload-plugin-openapi#readme)
+        - label: I have read the [documentation](https://payload-plugin-openapi.seshuk.im)
           required: true
 
   - type: textarea
@@ -31,14 +31,14 @@ body:
       required: true
 
   - type: textarea
-    id: config
+    id: options
     attributes:
-      label: Plugin Configuration
-      description: Share your plugin setup
+      label: Plugin Options
+      description: Share your plugin setup (**remove API keys and sensitive data**)
       placeholder: |
         ```typescript
         openapi({
-          metadata: {
+          info: {
             title: 'My API',
             version: '1.0.0',
           },
@@ -56,10 +56,11 @@ body:
         Paste output from `pnpm payload info` or list your versions.
         Please use specific version numbers instead of "latest" to help us debug faster.
       placeholder: |
-        @seshuk/payload-plugin-openapi: 0.1.0
-        payload: 3.53.0
-        next: 15.4.4
-        node: 20.9.0
+        @seshuk/payload-plugin-openapi: 1.0.0
+        payload: 4.0.0
+        next: 16.4.0
+        node: 24.15.0
+        database adapter: @payloadcms/db-sqlite 4.0.0
       render: shell
     validations:
       required: true

.github/ISSUE_TEMPLATE/02-question.yml

@@ -8,7 +8,7 @@ body:
   - type: markdown
     attributes:
       value: |
-        **Before asking:** Please check the [documentation](https://github.com/maximseshuk/payload-plugin-openapi#readme) and [existing issues](https://github.com/maximseshuk/payload-plugin-openapi/issues).
+        **Before asking:** Please check the [documentation](https://payload-plugin-openapi.seshuk.im) and [existing issues](https://github.com/maximseshuk/payload-plugin-openapi/issues).
 
   - type: textarea
     id: question
@@ -25,14 +25,14 @@ body:
       required: true
 
   - type: textarea
-    id: current-config
+    id: current-options
     attributes:
-      label: Current Configuration (if relevant)
-      description: Share your plugin setup
+      label: Current Options (if relevant)
+      description: Share your plugin setup (**remove API keys and sensitive data**)
       placeholder: |
         ```typescript
         openapi({
-          metadata: {
+          info: {
             title: 'My API',
             version: '1.0.0',
           },

.github/ISSUE_TEMPLATE/03-feature-request.yml

@@ -12,33 +12,59 @@ body:
       options:
         - label: I have searched existing issues to make sure this feature hasn't been requested before
           required: true
-        - label: I have checked the [documentation](https://github.com/maximseshuk/payload-plugin-openapi#readme) to confirm this feature doesn't already exist
+        - label: I have checked the [documentation](https://payload-plugin-openapi.seshuk.im) to confirm this feature doesn't already exist
           required: true
 
   - type: textarea
     id: description
     attributes:
       label: Feature Description
-      description: What would you like to see, and what problem does it solve?
+      description: What feature would you like to see implemented, and why?
       placeholder: |
-        - What problem does this solve?
+        Describe the feature you'd like to see:
+        - What problem does this solve, and who is it for?
         - How should it work?
+        - What would the options look like?
+        - Any current workarounds you're using?
     validations:
       required: true
 
   - type: textarea
-    id: config-example
+    id: options-example
     attributes:
-      label: Example Configuration (optional)
-      description: If this involves config changes, show what you imagine it would look like
+      label: Example Options (optional)
+      description: If this involves option changes, show what you imagine it would look like
       placeholder: |
         ```typescript
         openapi({
-          metadata: {
+          info: {
             title: 'My API',
             version: '1.0.0',
           },
-          // Your proposed option here
+          // Your proposed feature here
+          newFeature: {
+            // example options
+          },
         })
         ```
       render: typescript
+
+  - type: checkboxes
+    id: implementation
+    attributes:
+      label: Implementation
+      description: Are you willing to help implement this feature?
+      options:
+        - label: I'm willing to submit a pull request for this feature
+        - label: I can help with testing the implementation
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context (optional)
+      description: Any other information that would help understand this feature request
+      placeholder: |
+        Any additional details:
+        - Alternative solutions you've considered
+        - Links to similar features in other tools
+        - Screenshots or examples

.github/ISSUE_TEMPLATE/config.yml

@@ -1,5 +1,8 @@
 blank_issues_enabled: false
 contact_links:
-  - name: Documentation
-    url: https://github.com/maximseshuk/payload-plugin-openapi#readme
+  - name: 📚 Documentation
+    url: https://payload-plugin-openapi.seshuk.im
     about: Check the documentation for setup and configuration guides
+  - name: 🔄 Upgrade Guide
+    url: https://payload-plugin-openapi.seshuk.im/v1/upgrade-guide
+    about: How to upgrade from 0.x

.github/dependabot.yml

@@ -0,0 +1,75 @@
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5
+    versioning-strategy: increase-if-necessary
+    cooldown:
+      default-days: 2
+    commit-message:
+      prefix: chore
+      include: scope
+    ignore:
+      - dependency-name: payload
+        update-types: [version-update:semver-major]
+      - dependency-name: payload
+        versions: ['>=4.0.0-i <4.0.0-j']
+      - dependency-name: '@payloadcms/*'
+        update-types: [version-update:semver-major]
+      - dependency-name: '@payloadcms/*'
+        versions: ['>=4.0.0-i <4.0.0-j']
+      - dependency-name: next
+        update-types: [version-update:semver-major]
+      - dependency-name: react
+        update-types: [version-update:semver-major]
+      - dependency-name: react-dom
+        update-types: [version-update:semver-major]
+    groups:
+      payload:
+        patterns:
+          - payload
+          - '@payloadcms/*'
+          - next
+          - '@next/*'
+          - react
+          - react-dom
+          - '@types/react'
+          - '@types/react-dom'
+      dev:
+        dependency-type: development
+        update-types: [minor, patch]
+        exclude-patterns:
+          - payload
+          - '@payloadcms/*'
+          - next
+          - '@next/*'
+          - react
+          - react-dom
+          - '@types/react'
+          - '@types/react-dom'
+      runtime:
+        dependency-type: production
+        update-types: [minor, patch]
+        exclude-patterns:
+          - payload
+          - '@payloadcms/*'
+          - next
+          - '@next/*'
+          - react
+          - react-dom
+          - '@types/react'
+          - '@types/react-dom'
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    commit-message:
+      prefix: ci
+    cooldown:
+      default-days: 2
+    groups:
+      actions:
+        patterns: ['*']

.github/pull_request_template.md

@@ -0,0 +1,18 @@
+## What
+
+<!-- What does this PR change? One or two sentences. -->
+
+## Why
+
+<!-- The problem it solves. Link the issue: Closes #123 -->
+
+## How I tested it
+
+<!-- Unit tests, or manual steps in the dev app. -->
+
+## Checklist
+
+- [ ] `pnpm typecheck && pnpm lint && pnpm format && pnpm test:unit` pass
+- [ ] Tests added or updated for the behavior change
+- [ ] `README.md` and `docs/` updated if users will notice the change
+- [ ] Commit subjects follow Conventional Commits (`fix: ...`, `feat: ...`)