feat: coming closer to a first 1.0 release version

.claude/settings.local.json

@@ -0,0 +1,18 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(deno test:*)",
+      "Bash(deno add:*)",
+      "Bash(deno task:*)",
+      "Bash(deno check:*)",
+      "Bash(find:*)",
+      "Bash(deno doc:*)",
+      "WebFetch(domain:docs.eventsourcingdb.io)",
+      "Bash(cat:*)",
+      "WebSearch",
+      "Bash(ls:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

.claudeignore

@@ -0,0 +1,5 @@
+.env
+.env.*
+.otel_token
+*.pem
+*.key

.github/workflows/checks.yaml

@@ -12,62 +12,34 @@ concurrency:
 
 jobs:
   deploy:
-    name: Build & Deploy
+    name: Format, Lint, Type Check & Test
     runs-on: ubuntu-latest
     env:
       DENO_DIR: deno_cache_dir
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
 
       - name: Cache Deno dependencies
-        uses: actions/cache@v4
+        uses: actions/cache@8b402f58fbc84540c8b491a91e594a4576fec3d7
         with:
           path: ${{ env.DENO_DIR }}
-          key: deno_cache
+          key: deno-${{ runner.os }}-${{ hashFiles('deno.lock') }}
+          restore-keys: |
+            deno-${{ runner.os }}-
 
-      - uses: denoland/setup-deno@v2
+      - uses: denoland/setup-deno@e95548e56dfa95d4e1a28d6f422fafe75c4c26fb
         with:
-          deno-version: v2.3.x
+          deno-version: v2
 
-      # Check if the code is formatted correctly.
-      - name: Check formatting (core)
+      - name: Check formatting
         run: deno fmt --check
-        working-directory: ./packages/core
-      - name: Check formatting (mongodb)
-        run: deno fmt --check
-        working-directory: ./packages/mongodb
-      - name: Check formatting (oak)
-        run: deno fmt --check
-        working-directory: ./packages/oak
-      - name: Check formatting (utils)
-        run: deno fmt --check
-        working-directory: ./packages/utils
 
-      # Scan the code for syntax errors and style issues.
-      - name: Lint (core)
-        run: deno lint
-        working-directory: ./packages/core
-      - name: Lint (mongodb)
-        run: deno lint
-        working-directory: ./packages/mongodb
-      - name: Lint (oak)
+      - name: Lint
         run: deno lint
-        working-directory: ./packages/oak
-      - name: Lint (utils)
-        run: deno lint
-        working-directory: ./packages/utils
 
-      # Run all test files in the repository and collect code coverage.
-      - name: Test (core)
-        run: deno test --allow-all --permit-no-files
-        working-directory: ./packages/core
-      - name: Test (mongodb)
-        run: deno test --allow-all --permit-no-files
-        working-directory: ./packages/mongodb
-      - name: Test (oak)
-        run: deno test --allow-all --permit-no-files
-        working-directory: ./packages/oak
-      - name: Test (utils)
+      - name: Type check
+        run: deno check
+
+      - name: Test
         run: deno test --allow-all --permit-no-files
-        working-directory: ./packages/utils

.github/workflows/docs.yaml

@@ -5,12 +5,6 @@ on:
   release:
     types: [created]
 
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
 # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
 # However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
 concurrency:
@@ -20,19 +14,21 @@ concurrency:
 jobs:
   build:
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
 
       - name: Setup Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238
         with:
           node-version: 20
           cache: npm
           cache-dependency-path: "./docs/package-lock.json"
 
       - name: Setup Pages
-        uses: actions/configure-pages@v4
+        uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b
 
       - name: Install dependencies
         working-directory: ./docs
@@ -43,14 +39,17 @@ jobs:
         run: npm run build
 
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@7b1f4a764d45c48632c6b24a0339c27f5614fb0b
         with:
           path: docs/.vitepress/dist
 
   deploy:
     name: Deploy
     needs: build
     runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
 
     environment:
       name: github-pages
@@ -59,4 +58,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e

.github/workflows/publish.yaml

@@ -5,30 +5,31 @@ on:
   release:
     types: [created]
 
-permissions:
-  contents: read
-  id-token: write # The OIDC ID token is used for authentication with JSR.
-
 jobs:
   publish:
+    permissions:
+      contents: read
+      id-token: write # The OIDC ID token is used for authentication with JSR.
+
     runs-on: ubuntu-latest
+
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
 
-      - uses: denoland/setup-deno@v2
+      - uses: denoland/setup-deno@e95548e56dfa95d4e1a28d6f422fafe75c4c26fb
         with:
-          deno-version: v2.3.x
+          deno-version: v2
 
       - name: Publish core package
         working-directory: ./packages/core
-        run: deno publish --allow-slow-types
+        run: deno publish
 
       - name: Publish mongodb package
         working-directory: ./packages/mongodb
         run: deno publish
 
-      - name: Publish oak package
-        working-directory: ./packages/oak
+      - name: Publish hono package
+        working-directory: ./packages/hono
         run: deno publish
 
       - name: Publish utils package

.zed/settings.json

@@ -0,0 +1,40 @@
+{
+  "lsp": {
+    "deno": {
+      "settings": {
+        "deno": {
+          "enable": true
+        }
+      }
+    }
+  },
+  "languages": {
+    "JavaScript": {
+      "language_servers": [
+        "deno",
+        "!typescript-language-server",
+        "!vtsls",
+        "!eslint"
+      ],
+      "formatter": "language_server"
+    },
+    "TypeScript": {
+      "language_servers": [
+        "deno",
+        "!typescript-language-server",
+        "!vtsls",
+        "!eslint"
+      ],
+      "formatter": "language_server"
+    },
+    "TSX": {
+      "language_servers": [
+        "deno",
+        "!typescript-language-server",
+        "!vtsls",
+        "!eslint"
+      ],
+      "formatter": "language_server"
+    }
+  }
+}

CLAUDE.md

@@ -0,0 +1,10 @@
+# Format, Lint, Type Check & Test
+
+Whenever something is changed in the examples or packages, run the following commands to format, lint, type check and test the code. Running these commands from the repository root will check all examples and packages.
+
+```
+deno fmt --check
+deno lint
+deno check
+deno test
+```

README.md

@@ -1,17 +1,20 @@
-<img 
-    src="https://raw.githubusercontent.com/overlap-dev/Nimbus/main/media/intro.png" 
+<img
+    src="https://raw.githubusercontent.com/overlap-dev/Nimbus/main/media/intro.png"
     alt="Nimbus"
 />
 
 # Installation
 
-Find all packages and installation instructions at [jsr.io/@nimbus](https://jsr.io/@nimbus).
+Find all packages and installation instructions at
+[jsr.io/@nimbus](https://jsr.io/@nimbus).
 
 # Documentation
 
-Find the full documentation at [https://nimbus.overlap.at/](https://nimbus.overlap.at/).
+Find the full documentation at
+[https://nimbus.overlap.at/](https://nimbus.overlap.at/).
 
-In addition code documentation is automatically generated and can be found for each package at [jsr.io/@nimbus](https://jsr.io/@nimbus).
+In addition code documentation is automatically generated and can be found for
+each package at [jsr.io/@nimbus](https://jsr.io/@nimbus).
 
 # License
 

RELEASE.md

@@ -1,21 +1,21 @@
 # How to release a new version of the packages
 
-For each package make sure the version in the `packages/<PACKAGE_NAME>/deno.json` is set correctly and stick to semantic versioning.
+For each package make sure the version in the
+`packages/<PACKAGE_NAME>/deno.json` is set correctly and stick to semantic
+versioning.
 
 Once everything is ready make a new commit with a message of this type:
 
 ```
 chore: release 0.0.0
 ```
 
-Push to `main` and create a new release on GitHub from there on the GitHub workflow will take care of the rest.
+Push to `main` and create a new release on GitHub from there on the GitHub
+workflow will take care of the rest.
 
 ## Manually publish to JSR
 
 ```
 cd packages/<PACKAGE_NAME>
-deno publish --allow-slow-types
+deno publish
 ```
-
-**Slow Types**  
-Because of some Zod inferred types, the `--allow-slow-types` flag is required to publish the package to JSR.

deno.json

@@ -2,12 +2,39 @@
   "compilerOptions": {
     "strict": true
   },
+  "exclude": [
+    "docs/"
+  ],
   "workspace": [
     "./packages/core",
     "./packages/mongodb",
-    "./packages/oak",
+    "./packages/hono",
     "./packages/utils",
-    "./examples/the-expense"
+    "./examples/hono-demo"
   ],
-  "nodeModulesDir": "none"
-}
+  "nodeModulesDir": "none",
+  "fmt": {
+    "include": [
+      "examples/",
+      "packages/"
+    ]
+  },
+  "lint": {
+    "include": [
+      "examples/",
+      "packages/"
+    ]
+  },
+  "check": {
+    "include": [
+      "examples/",
+      "packages/"
+    ]
+  },
+  "test": {
+    "include": [
+      "examples/",
+      "packages/"
+    ]
+  }
+}