payload-ai 0.0.1

package/.editorconfig

@@ -0,0 +1,10 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+end_of_line = lf
+max_line_length = null

package/.eslintrc.js

@@ -0,0 +1,17 @@
+module.exports = {
+  root: true,
+  extends: ['./eslint-config'],
+  overrides: [
+    // Temporary overrides
+    {
+      files: ['dev/**/*.ts'],
+      rules: {
+        'import/no-relative-packages': 'off',
+        'no-process-env': 'off',
+      },
+    },
+  ],
+  excludes: [
+    'dev/plugin.spec.ts',
+  ]
+}

package/.github/workflows/publish.yml

@@ -0,0 +1,21 @@
+name: Publish New Version
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+        with:
+          node-version: '14.x'
+          registry-url: 'https://registry.npmjs.org'
+      - run: yarn install
+      - run: yarn test
+      - run: yarn build
+      - run: yarn publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/test.yml

@@ -0,0 +1,20 @@
+name: Test
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+        with:
+          node-version: '14.x'
+          registry-url: 'https://registry.npmjs.org'
+      - run: yarn install
+      - run: cd dev && yarn install
+      - run: yarn test

package/.prettierrc.js

@@ -0,0 +1,8 @@
+module.exports = {
+  printWidth: 100,
+  parser: "typescript",
+  semi: false,
+  singleQuote: true,
+  trailingComma: "all",
+  arrowParens: "avoid",
+};

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Payload
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,237 @@
+# Payload Plugin Template
+
+Translate content to different languages using GPT.
+
+Planned features:
+
+- generate image alt text from GPT
+- generate by field
+- string translation using i18next
+- generate SEO Text
+- generate structured content
+- custom access control
+- custom overrides for translation
+- generate images based on input
+
+Payload is built with a robust infrastructure intended to support Plugins with ease. This provides a simple, modular, and reusable way for developers to extend the core capabilities of Payload.
+
+To build your own Payload plugin, all you need is:
+
+* An understanding of the basic Payload concepts
+* And some JavaScript/Typescript experience
+
+## Background
+
+Here is a short recap on how to integrate plugins with Payload, to learn more visit the [plugin overview page](https://payloadcms.com/docs/plugins/overview).
+
+### How to install a plugin
+
+To install any plugin, simply add it to your payload.config() in the Plugin array.
+
+```ts
+import samplePlugin from 'sample-plugin';
+
+export const config = buildConfig({
+  plugins: [
+    // You can pass options to the plugin
+    samplePlugin({
+		  enabled: true,
+    }),
+  ]
+});
+```
+
+### Initialization
+
+The initialization process goes in the following order:
+
+1. Incoming config is validated
+2. **Plugins execute**
+3. Default options are integrated
+4. Sanitization cleans and validates data
+5. Final config gets initialized
+
+## Building the Plugin
+
+When you build a plugin, you are purely building a feature for your project and then abstracting it outside of the project.
+
+### Template Files
+
+In the [payload-plugin-template](https://github.com/payloadcms/payload-plugin-template), you will see a common file structure that is used across all plugins:
+
+1. root folder
+2. /src folder
+3. /dev folder
+
+#### Root
+
+In the root folder, you will see various files that relate to the configuration of the plugin. We set up our environment in a similar manner in Payload core and across other projects, so hopefully these will look familiar:
+
+* **README**.md* - This contains instructions on how to use the template. When you are ready, update this to contain instructions on how to use your Plugin.
+* **package**.json* - Contains necessary scripts and dependencies. Overwrite the metadata in this file to describe your Plugin.
+* .**editorconfig** - Defines settings to maintain consistent coding styles.
+* .**eslintrc**.js - Eslint configuration for reporting on problematic patterns.
+* .**gitignore** - List specific untracked files to omit from Git.
+* .**prettierrc**.js - Configuration for Prettier code formatting.
+* **LICENSE** - As part of the open-source community, we ship all plugins with an MIT license but it is not required.
+* **tsconfig**.json - Configures the compiler options for TypeScript
+
+**IMPORTANT***: You will need to modify these files.
+
+#### Dev
+
+In the dev folder, you’ll find a basic payload project, created with `npx create-payload-app` and the blank template.
+
+The `samplePlugin` has already been installed to the `payload.config()` file in this project.
+
+```ts
+plugins: [
+  samplePlugin({
+    enabled: false,
+  })
+]
+```
+
+Later when you rename the plugin or add additional options, make sure to update them here.
+
+You may wish to add collections or expand the test project depending on the purpose of your plugin. Just make sure to keep this dev environment as simplified as possible - users should be able to install your plugin without additional configuration required.
+
+When you’re ready to start development, navigate into this folder with `cd dev`
+
+And then start the project with `yarn dev` and pull up [http://localhost:3000/](http://localhost:3000/) in your browser.
+
+#### Src
+
+Now that we have our environment setup and we have a dev project ready to - it’s time to build the plugin!
+
+**index.ts**
+
+First up, the `src/index.ts` file. It is best practice not to build the plugin directly in this file, instead we use this to export the plugin and types from separate files.
+
+**Plugin.ts**
+
+To reiterate, the essence of a payload plugin is simply to extend the payload config - and that is exactly what we are doing in this file.
+
+```ts
+export const samplePlugin =
+  (pluginOptions: PluginTypes) =>
+    (incomingConfig: Config): Config => {
+      let config = { ...incomingConfig }
+
+      // do something cool with the config here
+
+      return config
+    }
+
+```
+
+First, we receive the existing payload config along with any plugin options.
+
+Then we set the variable `config` to be equal to the existing config.
+
+From here, you can extend the config as you wish.
+
+Finally, you return the config and that is it!
+
+##### Spread Syntax
+
+Spread syntax (or the spread operator) is a feature in JavaScript that uses the dot notation **(...)** to spread elements from arrays, strings, or objects into various contexts.
+
+We are going to use spread syntax to allow us to add data to existing arrays without losing the existing data. It is crucial to spread the existing data correctly – else this can cause adverse behavior and conflicts with Payload config and other plugins.
+
+Let’s say you want to build a plugin that adds a new collection:
+
+```ts
+config.collections = [
+  ...(config.collections || []),
+  // Add additional collections here
+]
+```
+
+First we spread the `config.collections` to ensure that we don’t lose the existing collections, then you can add any additional collections just as you would in a regular payload config.
+
+This same logic is applied to other properties like admin, hooks, globals:
+
+```ts
+config.globals = [
+  ...(config.globals || []),
+  // Add additional globals here
+]
+
+config.hooks = {
+  ...(incomingConfig.hooks || {}),
+  // Add additional hooks here
+}
+```
+
+Some properties will be slightly different to extend, for instance the onInit property:
+
+```ts
+import { onInitExtension } from './onInitExtension' // example file
+
+config.onInit = async payload => {
+  if (incomingConfig.onInit) await incomingConfig.onInit(payload)
+  // Add additional onInit code by defining an onInitExtension function
+  onInitExtension(pluginOptions, payload)
+}
+```
+
+If you wish to add to the onInit, you must include the async/await. We don’t use spread syntax in this case, instead you must await the existing onInit before running additional functionality.
+
+In the template, we have stubbed out a basic `onInitExtension` file that you can use, if not needed feel free to delete it.
+
+##### File Aliasing
+
+If your plugin uses packages or dependencies that are not browser compatible (fs, stripe, nodemailer, etc), you will need to alias them using your bundler to prevent getting errors in build.
+
+You can read more about aliasing files with Webpack or Vite in the [excluding server modules](https://payloadcms.com/docs/admin/excluding-server-code#aliasing-server-only-modules) docs.
+
+##### Types.ts
+
+If your plugin has options, you should define and provide types for these options in a separate file which gets exported from the main index.ts.
+
+```ts
+export interface PluginTypes {
+  /**
+   * Enable or disable plugin
+   * @default false
+   */
+  enabled?: boolean
+}
+```
+
+If possible, include JSDoc comments to describe the options and their types. This allows a developer to see details about the options in their editor.
+
+##### Testing
+
+Having a test suite for your plugin is essential to ensure quality and stability. Jest is a popular testing framework, widely used for testing JavaScript and particularly for applications built with React.
+
+Jest organizes tests into test suites and cases. We recommend creating individual tests based on the expected behavior of your plugin from start to finish.
+
+Writing tests with Jest is very straightforward and you can learn more about how it works in the [Jest documentation.](https://jestjs.io/)
+
+For this template, we stubbed out `plugin.spec.ts` in the `dev` folder where you can write your tests.
+
+```ts
+describe('Plugin tests', () => {
+  // Create tests to ensure expected behavior from the plugin
+  it('some condition that must be met', () => {
+   // Write your test logic here
+   expect(...)
+  })
+})
+```
+
+## Best practices
+
+With this tutorial and the `payload-plugin-template`, you should have everything you need to start building your own plugin.
+In addition to the setup, here are other best practices aim we follow:
+
+* **Providing an enable / disable option:** For a better user experience, provide a way to disable the plugin without uninstalling it. This is especially important if your plugin adds additional webpack aliases, this will allow you to still let the webpack run to prevent errors.
+* **Include tests in your GitHub CI workflow**: If you’ve configured tests for your package, integrate them into your workflow to run the tests each time you commit to the plugin repository. Learn more about [how to configure tests into your GitHub CI workflow.](https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs)
+* **Publish your finished plugin to NPM**: The best way to share and allow others to use your plugin once it is complete is to publish an NPM package. This process is straightforward and well documented, find out more [creating and publishing a NPM package here.](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages/).
+* **Add payload-plugin topic tag**: Apply the tag **payload-plugin **to your GitHub repository. This will boost the visibility of your plugin and ensure it gets listed with [existing payload plugins](https://github.com/topics/payload-plugin).
+* **Use [Semantic Versioning](https://semver.org/) (SemVar)** - With the SemVar system you release version numbers that reflect the nature of changes (major, minor, patch). Ensure all major versions reference their Payload compatibility.
+
+# Questions
+Please contact [Payload](mailto:dev@payloadcms.com) with any questions about using this plugin template.

package/dev/.env.example

@@ -0,0 +1,3 @@
+DATABASE_URI=mongodb://127.0.0.1/plugin-development
+PAYLOAD_SECRET=hellohereisasecretforyou
+OPENAI_API_KEY=

package/dev/Dockerfile

@@ -0,0 +1,27 @@
+FROM node:18.8-alpine as base
+
+FROM base as builder
+
+WORKDIR /home/node/app
+COPY package*.json ./
+
+COPY . .
+RUN yarn install
+RUN yarn build
+
+FROM base as runtime
+
+ENV NODE_ENV=production
+ENV PAYLOAD_CONFIG_PATH=dist/payload.config.js
+
+WORKDIR /home/node/app
+COPY package*.json  ./
+COPY yarn.lock ./
+
+RUN yarn install --production
+COPY --from=builder /home/node/app/dist ./dist
+COPY --from=builder /home/node/app/build ./build
+
+EXPOSE 3000
+
+CMD ["node", "dist/server.js"]

package/dev/docker-compose.yml

@@ -0,0 +1,31 @@
+version: '3'
+
+services:
+  payload:
+    image: node:18-alpine
+    ports:
+      - '3000:3000'
+    volumes:
+      - .:/home/node/app
+      - node_modules:/home/node/app/node_modules
+    working_dir: /home/node/app/
+    command: sh -c "yarn install && yarn dev"
+    depends_on:
+      - mongo
+    env_file:
+      - .env
+
+  mongo:
+    image: mongo:latest
+    ports:
+      - '27017:27017'
+    command:
+      - --storageEngine=wiredTiger
+    volumes:
+      - data:/data/db
+    logging:
+      driver: none
+
+volumes:
+  data:
+  node_modules:

package/dev/jest.config.js

@@ -0,0 +1,12 @@
+module.exports = {
+  verbose: true,
+  testEnvironment: 'node',
+  transform: {
+    '^.+\\.(t|j)sx?$': '<rootDir>/node_modules/@swc/jest',
+  },
+  moduleNameMapper: {
+    '\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$':
+      '<rootDir>/src/mocks/fileStub.js',
+    '\\.(css|scss)$': '<rootDir>/src/mocks/fileStub.js',
+  },
+}

package/dev/nodemon.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json.schemastore.org/nodemon.json",
+  "ext": "ts",
+  "exec": "ts-node src/server.ts -- -I",
+  "stdin": false
+}

package/dev/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "Payload2Blank",
+  "description": "A blank template to get started with Payload",
+  "version": "1.0.0",
+  "main": "dist/server.js",
+  "license": "MIT",
+  "scripts": {
+    "dev": "cross-env PAYLOAD_CONFIG_PATH=src/payload.config.ts nodemon",
+    "build:payload": "cross-env PAYLOAD_CONFIG_PATH=src/payload.config.ts payload build",
+    "build:server": "tsc",
+    "build": "yarn copyfiles && yarn build:payload && yarn build:server",
+    "serve": "cross-env PAYLOAD_CONFIG_PATH=dist/payload.config.js NODE_ENV=production node dist/server.js",
+    "copyfiles": "copyfiles -u 1 \"src/**/*.{html,css,scss,ttf,woff,woff2,eot,svg,jpg,png}\" dist/",
+    "generate:types": "cross-env PAYLOAD_CONFIG_PATH=src/payload.config.ts payload generate:types",
+    "generate:graphQLSchema": "cross-env PAYLOAD_CONFIG_PATH=src/payload.config.ts payload generate:graphQLSchema",
+    "payload": "cross-env PAYLOAD_CONFIG_PATH=src/payload.config.ts payload"
+  },
+  "dependencies": {
+    "@payloadcms/bundler-webpack": "^1.0.0",
+    "@payloadcms/db-mongodb": "^1.0.0",
+    "@payloadcms/plugin-cloud": "^2.0.0",
+    "@payloadcms/richtext-slate": "^1.0.0",
+    "cross-env": "^7.0.3",
+    "dotenv": "^8.2.0",
+    "express": "^4.17.1",
+    "payload": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.9",
+    "copyfiles": "^2.4.1",
+    "nodemon": "^2.0.6",
+    "ts-node": "^9.1.1",
+    "typescript": "^4.8.4"
+  }
+}

package/dev/plugin.spec.ts

@@ -0,0 +1,30 @@
+import type { Server } from 'http'
+import mongoose from 'mongoose'
+import payload from 'payload'
+import { start } from './src/server'
+
+describe('Plugin tests', () => {
+  let server: Server
+
+  beforeAll(async () => {
+    await start({ local: true })
+  })
+
+  afterAll(async () => {
+    await mongoose.connection.dropDatabase()
+    await mongoose.connection.close()
+    server.close()
+  })
+
+  // Add tests to ensure that the plugin works as expected
+
+  // Example test to check for seeded data
+  it('seeds data accordingly', async () => {
+    const newCollectionQuery = await payload.find({
+      collection: 'new-collection',
+      sort: 'createdAt',
+    })
+
+    expect(newCollectionQuery.totalDocs).toEqual(1)
+  })
+})

package/dev/src/collections/Examples.ts

@@ -0,0 +1,18 @@
+import { CollectionConfig } from 'payload/types'
+
+// Example Collection - For reference only, this must be added to payload.config.ts to be used.
+const Examples: CollectionConfig = {
+  slug: 'examples',
+  admin: {
+    useAsTitle: 'someField',
+  },
+  fields: [
+    {
+      name: 'richText',
+      type: 'text',
+      localized: true,
+    },
+  ],
+}
+
+export default Examples

package/dev/src/collections/Users.ts

@@ -0,0 +1,15 @@
+import { CollectionConfig } from 'payload/types';
+
+const Users: CollectionConfig = {
+  slug: 'users',
+  auth: true,
+  admin: {
+    useAsTitle: 'email',
+  },
+  fields: [
+    // Email added by default
+    // Add more fields as needed
+  ],
+};
+
+export default Users;

package/dev/src/mocks/fileStub.js

@@ -0,0 +1 @@
+export default 'file-stub'

package/dev/src/payload.config.ts

@@ -0,0 +1,57 @@
+import { buildConfig } from 'payload/config'
+import path from 'path'
+import Users from './collections/Users'
+import Examples from './collections/Examples'
+import { mongooseAdapter } from '@payloadcms/db-mongodb'
+import { webpackBundler } from '@payloadcms/bundler-webpack'
+import { slateEditor } from '@payloadcms/richtext-slate'
+import { aiTranslatorPlugin } from '../../src/index'
+
+export default buildConfig({
+  admin: {
+    user: Users.slug,
+    bundler: webpackBundler(),
+    webpack: config => {
+      const newConfig = {
+        ...config,
+        resolve: {
+          ...config.resolve,
+          alias: {
+            ...(config?.resolve?.alias || {}),
+            react: path.join(__dirname, '../node_modules/react'),
+            'react-dom': path.join(__dirname, '../node_modules/react-dom'),
+            payload: path.join(__dirname, '../node_modules/payload'),
+          },
+        },
+      }
+      return newConfig
+    },
+  },
+  editor: slateEditor({}),
+  collections: [Examples, Users],
+  localization: {
+    locales: ['en', 'es', 'de'],
+    defaultLocale: 'en',
+    fallback: true,
+  },
+  typescript: {
+    outputFile: path.resolve(__dirname, 'payload-types.ts'),
+  },
+  graphQL: {
+    schemaOutputFile: path.resolve(__dirname, 'generated-schema.graphql'),
+  },
+  plugins: [
+    aiTranslatorPlugin({
+      enabled: true,
+      collections: {
+        examples: {
+          fields: ['richText'],
+          // adapter: theAdapterToUse, // see docs for the adapter you want to use
+        },
+      },
+    }),
+  ],
+  db: mongooseAdapter({
+    url: process.env.DATABASE_URI,
+  }),
+})

package/dev/src/server.ts

@@ -0,0 +1,29 @@
+import express from 'express'
+import payload from 'payload'
+import { InitOptions } from 'payload/config'
+
+require('dotenv').config()
+const app = express()
+
+// Redirect root to Admin panel
+app.get('/', (_, res) => {
+  res.redirect('/admin')
+})
+
+export const start = async (args?: Partial<InitOptions>) => {
+  // Initialize Payload
+  await payload.init({
+    secret: process.env.PAYLOAD_SECRET,
+    express: app,
+    onInit: async () => {
+      payload.logger.info(`Payload Admin URL: ${payload.getAdminURL()}`)
+    },
+    ...(args || {}),
+  })
+
+  // Add your own express routes here
+
+  app.listen(3000)
+}
+
+start()

package/dev/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "es5",
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": true,
+    "strict": false,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "jsx": "react",
+    "paths": {
+      "payload/generated-types": [
+        "./src/payload-types.ts"
+      ]
+    }
+  },
+  "include": [
+    "src"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist",
+    "build"
+  ],
+  "ts-node": {
+    "transpileOnly": true,
+    "swc": true
+  }
+}

package/dist/aiTranslate.d.ts

@@ -0,0 +1,5 @@
+import type { CollectionAfterChangeHook } from 'payload/types';
+declare const aiTranslate: ({ collection }: {
+    collection: object;
+}, fallback?: string) => CollectionAfterChangeHook;
+export default aiTranslate;