Pylon V2

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "cSpell.words": [
+        "consola"
+    ]
+}

NOTICE

@@ -0,0 +1,5 @@
+Pylon
+Copyright 2024 Nico Schett <[email protected]>
+
+This product includes software developed at
+cronit (https://www.cronit.io/).

README.md

@@ -1,40 +1,137 @@
-:warning: **Pylon Requires Bun:** This project currently depends on the [Bun runtime](https://bun.sh). If you need support for a different runtime, please upvote and follow the discussion on Issue https://github.com/getcronit/pylon/issues/6 to help us prioritize it.
+![Pylon cover](https://github.com/user-attachments/assets/c28e49b2-5672-4849-826e-8b2eab0360cc)
 
-<p align="center">
-  <a href="https://pylon.cronit.io">
-    <img src="https://github.com/getcronit/pylon/assets/52858351/ec8aa54e-6b24-45cb-82a1-03b9c8b8f45f" height="100" alt="gqty" />
-  </a>
-</p>
+<div align="center"><strong>Pylon</strong></div>
+<div align="center">The next generation of building APIs.<br />Automatic schema generation for your service logic.</div>
+<br />
+<div align="center">
+<a href="https://pylon.cronit.io">Website</a> 
+<span> · </span>
+<a href="https://github.com/getcronit/pylon">GitHub</a> 
+<span> · </span>
+<a href="https://discord.com/invite/cbJjkVrnHe">Discord</a>
 
-<h2 align="center">
-  From Functions to APIs - Instantly
+<br />
+<br />
 
-[![Documentation](https://img.shields.io/badge/documentation-documentation?color=C00B84)](https://pylon.cronit.io)
+[![Documentation](https://img.shields.io/badge/documentation-documentation?color=000000)](https://pylon.cronit.io/docs)
 [![NPM](https://img.shields.io/npm/v/%40getcronit%2Fpylon)](https://www.npmjs.com/package/@getcronit/pylon)
 
-</h2>
+</div>
 
-[![Pylon Hero Section](https://github.com/getcronit/pylon/assets/52858351/9ce5833f-c4ce-4dc5-85a9-6eb3910b40bd)](https://pylon.cronit.io)
+## Introduction
 
-The GraphQL schema is generated in real-time from your TypeScript definitions,
-allowing you to focus solely on writing your service logic.
-This approach significantly improves development speed, enhances type safety, and reduces errors.
+A framework for building GraphQL APIs without defining any kind of schema.
+It reduces the time spent on writing and maintaining API definitions, allowing you to focus solely on writing your service logic.
 
-Any breaking changes in your code are instantly reflected in your API,
-enabling you to immediately see how changes impact its functionality.
+## Why
 
-**Head over to [pylon.cronit.io](https://pylon.cronit.io) to explore features and
-documentations!**
+We believe that the current approach to building APIs is outdated. Writing and maintaining API definitions is time-consuming and error-prone. When you already have TypeScript definitions, why not use them to infer the API schema? Pylon does exactly that.
 
-## Get involved
+Pylon also provides a set of tools to help you build, test, and deploy your APIs. We believe that building services should be easy and fun. Major functionalities like authentication, authorization, and context management are built-in, so you can focus on what matters most: your service logic.
+
+With Pylon, you can build APIs faster, with fewer errors, and with less code.
+
+## Create
+
+To create a new Pylon project, run the following command:
+
+```bash
+npm create pylon
+```
+
+Afterwards, you can navigate to the newly created project and start the development server:
+
+```bash
+cd my-pylon
+npm run dev
+```
+
+This will start the development server on `http://localhost:3000`.
+
+Open the [Pylon Playground](https://pylon.cronit.io/docs/getting-started#built-in-graphql-playground) in your browser and start building your API.
+
+## Develop
+
+Update your service logic in the `src` directory.
+
+```typescript
+import {app} from '@getcronit/pylon'
+
+export const graphql = {
+  Query: {
+    sum: (a: number, b: number) => {
+      console.log(`Calculating sum of ${a} and ${b}`)
+      return a + b
+    }
+  },
+  Mutation: {
+    divide: (a: number, b: number) => {
+      if (b === 0) {
+        console.error('Attempt to divide by zero')
+        throw new Error('Division by zero is not allowed')
+      }
+      console.log(`Dividing ${a} by ${b}`)
+      return a / b
+    }
+  }
+}
+
+export default app
+```
+
+## Deploy
+
+Pylon is fully compatible with Cloudflare Workers, allowing you to deploy your service to the edge in just one minute.
+Watch the video below to see how easy it is to deploy a Pylon.
+
+[![Cloudflare Workers](https://video.com)]
+
+If you prefer to deploy your service to a different platform, you can use the provided Dockerfile to build a Docker image and deploy it to your favorite cloud provider.
+
+```bash
+docker build -t my-pylon .
+docker run -p 3000:3000 my-pylon
+```
+
+## Runtimes
+
+Designed to be flexible, Pylon can be run on various platforms, including:
+
+| <img src="https://bun.sh/logo.svg" width="48px" height="48px" alt="Bun.js logo"> | <img src="https://nodejs.org/static/logos/jsIconWhite.svg" width="48px" height="48px" alt="Node.JS"> | <img src="https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQgW7cAlhYN23JXGKy9Uji4Ae2mnHOR9eXX9g&s" width="48px" height="48px" alt="Gmail logo"> |
+| :------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------: |
+|                                      Bun.js                                      |                                               Node.js                                                |                                                                  Cloudflare Workers                                                                  |
+
+## Features
+
+Pylon offers a comprehensive set of features to streamline the development of modern web services:
+
+| Feature                              | Description                                                                                                                          |
+| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
+| **Automatic Schema Generation**      | Pylon generates GraphQL schemas based on your TypeScript definitions, ensuring type safety and reducing manual coding effort.        |
+| **Type Safety**                      | By leveraging TypeScript, Pylon ensures that your services are type-safe, catching errors at compile time.                           |
+| **Authentication and Authorization** | Built-in support for OIDC standard and integration with ZITADEL for managing user authentication and role-based access control.      |
+| **Logging and Monitoring**           | Sentry for error tracking, providing robust monitoring capabilities.                                                                 |
+| **Database Integration**             | Seamlessly works with Prisma to generate extended models that support automatic resolution of relations and paginatable connections. |
+| **Deployment Ready**                 | Includes pre-configured Dockerfile for easy deployment using Docker or manual methods.                                               |
+
+## Playground
+
+You can try Pylon in the [Playground](https://pylon.cronit.io/playground) without installing anything.
+Or simply click the image below to open the Playground.
+
+[![Playground](https://github.com/user-attachments/assets/39df08d0-4094-4836-a36b-37ad62e292cf)](https://pylon.cronit.io/playground)
+
+## Contributing
 
 Documentation, bug reports, pull requests, and other contributions are welcomed!
 See [`CONTRIBUTING.md`](CONTRIBUTING.md) for more information.
 
-## Getting help
+## Support
 
 - **Community Support:** Join the Pylon community on GitHub to report bugs and request features.
 - **Professional Support:** For professional support and consulting services, contact [[email protected]](mailto:[email protected]).
+- Join the [Pylon Discord server](https://discord.gg/cbJjkVrnHe) to connect with other users and contributors.
+
 ---
 
 Pylon is brought to you by Cronit.

package.json

@@ -3,11 +3,12 @@
   "private": true,
   "workspaces": {
     "packages": [
+      "packages/pylon-telemetry",
       "packages/*"
     ]
   },
   "scripts": {
-    "build": "bun run --filter ./packages/pylon build && bun run --filter ./packages/pylon-builder build && bun run --filter ./packages/pylon-server build && bun run --filter ./packages/pylon-cli build"
+    "build": "bun run --filter ./packages/pylon-telemetry build && bun run --filter ./packages/pylon-builder build && bun run --filter ./packages/pylon build &&  bun run --filter ./packages/pylon-dev build && bun run --filter ./packages/create-pylon build"
   },
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.3",

packages/create-pylon/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "create-pylon",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "CLI for creating a Pylon",
+  "scripts": {
+    "build": "bun build ./src/index.ts --target=bun --outdir=./dist --sourcemap=inline --packages external"
+  },
+  "bin": "./dist/index.js",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "author": "Nico Schett <[email protected]>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/getcronit/pylon.git",
+    "directory": "packages/create-pylon"
+  },
+  "homepage": "https://pylon.cronit.io",
+  "dependencies": {
+    "@inquirer/prompts": "^5.4.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "consola": "^3.2.3",
+    "detect-package-manager": "^3.0.2",
+    "@getcronit/pylon-telemetry": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}