Merge pull request #66 from pawcoding/next

🚀 Release

Author: pawcoding

.github/workflows/copilot-setup-steps.yml

@@ -28,7 +28,7 @@ jobs:
 
       # Setup Node
       - name: 📦 Setup Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version-file: .nvmrc
 

.github/workflows/release.yaml

@@ -27,7 +27,7 @@ jobs:
 
       # Setup Node
       - name: 📦 Setup Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version-file: .nvmrc
 
@@ -80,9 +80,10 @@ jobs:
         if: github.repository == 'pawcoding/astro-loader-pocketbase'
         id: release
         uses: cycjimmy/semantic-release-action@v5
+        with:
+          semantic_version: 25
         env:
           GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
 
       # Update project on website
       - name: 🖥️ Update website

.github/workflows/test.yaml

@@ -1,11 +1,15 @@
 name: 🧪 Test code
-# Run this on every push except master and next
+
 on:
+  # Run this on every push except master and next
   push:
     branches:
       - "**"
       - "!master"
       - "!next"
+  # Run this every week to make sure the latest PocketBase version still works
+  schedule:
+    - cron: "0 4 * * 6"
 
 env:
   HUSKY: 0
@@ -28,7 +32,7 @@ jobs:
 
       # Setup Node
       - name: 📦 Setup Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version-file: .nvmrc
 

.github/workflows/trigger-pawcode-update.yaml

@@ -17,7 +17,7 @@ jobs:
           echo "release_url=${{ github.event.release.html_url }}" >> $GITHUB_OUTPUT
 
       - name: 🚀 Trigger pawcode-astro update
-        uses: peter-evans/repository-dispatch@v3
+        uses: peter-evans/repository-dispatch@v4
         with:
           token: ${{ secrets.PAWCODE_ASTRO_TOKEN }}
           repository: pawcoding/pawcode-astro

.nvmrc

@@ -1 +1 @@
-22
+24

.oxlintrc.json

@@ -15,6 +15,9 @@
   },
   "rules": {
     // Correctness (in addition to the default rules)
+    "typescript/no-base-to-string": "off",
+    "typescript/restrict-template-expressions": "off",
+    "typescript/unbound-method": "off",
     "promise/no-new-statics": "error",
     "promise/valid-params": "error",
     // Perf
@@ -32,8 +35,8 @@
     "eslint/no-empty-function": "warn",
     "eslint/no-eq-null": "error",
     "eslint/no-iterator": "error",
+    "eslint/no-param-reassign": "warn",
     "eslint/no-proto": "error",
-    "eslint/no-unused-expressions": "warn",
     "eslint/no-var": "error",
     "import/no-commonjs": "error",
     "import/no-cycle": "error",
@@ -115,8 +118,8 @@
     "eslint/no-redeclare": "error",
     "eslint/no-self-compare": "error",
     "eslint/no-throw-literal": "error",
-    "eslint/require-await": "warn",
     "eslint/symbol-description": "error",
+    "typescript/ban-ts-comment": "warn",
     "typescript/no-unsafe-argument": "error",
     "typescript/no-unsafe-assignment": "error",
     "typescript/no-unsafe-call": "error",
@@ -131,6 +134,7 @@
     "unicorn/consistent-empty-array-spread": "warn",
     "unicorn/explicit-length-check": "warn",
     "unicorn/new-for-builtins": "warn",
+    "unicorn/no-array-callback-reference": "error",
     "unicorn/no-instanceof-array": "error",
     "unicorn/no-negation-in-equality-check": "warn",
     "unicorn/no-static-only-class": "error",
@@ -141,12 +145,14 @@
     "unicorn/no-useless-switch-case": "warn",
     "unicorn/prefer-array-flat": "error",
     "unicorn/prefer-array-some": "warn",
+    "unicorn/prefer-at": "warn",
     "unicorn/prefer-date-now": "warn",
     "unicorn/prefer-math-min-max": "warn",
     "unicorn/prefer-math-trunc": "error",
     "unicorn/prefer-string-replace-all": "warn",
     "unicorn/prefer-string-slice": "warn",
     "unicorn/prefer-type-error": "warn",
+    "unicorn/require-module-specifiers": "error",
     // Style
     "eslint/arrow-body-style": "warn",
     "eslint/curly": "error",
@@ -216,6 +222,13 @@
         "eslint/max-lines": "off",
         "eslint/max-lines-per-function": "off",
         "eslint/max-nested-callbacks": "off",
+        "typescript/no-unsafe-argument": "off",
+        "typescript/no-unsafe-assignment": "off",
+        "typescript/no-unsafe-call": "off",
+        "typescript/no-unsafe-return": "off",
+        "typescript/no-unsafe-member-access": "off",
+        "typescript/no-unsafe-type-assertion": "off",
+        "typescript/no-explicit-any": "off",
         // Vitest specific rules
         "vitest/no-import-node-test": "warn",
         "vitest/prefer-to-be-falsy": "warn",

.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+  "recommendations": [
+    "oxc.oxc-vscode",
+    "esbenp.prettier-vscode",
+    "vitest.explorer"
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+  "oxc.typeAware": true,
+  "oxc.unusedDisableDirectives": "warn",
+  "oxc.lint.run": "onType"
+}

.zed/settings.json

@@ -0,0 +1,20 @@
+// Folder-specific settings
+//
+// For a full list of overridable settings, and general information on folder-specific settings,
+// see the documentation: https://zed.dev/docs/configuring-zed#settings-files
+{
+  "lsp": {
+    "oxc": {
+      "initialization_options": {
+        "options": {
+          "run": "onType",
+          "configPath": null,
+          "tsConfigPath": null,
+          "unusedDisableDirectives": "warn",
+          "typeAware": true,
+          "flags": {}
+        }
+      }
+    }
+  }
+}

README.md

@@ -172,7 +172,9 @@ const blog = defineCollection({
 });
 ```
 
-_It's recommended to use an [impersonate token (API token)](https://pocketbase.io/docs/authentication/#api-keys) instead of the email and password, as this is more secure and can be easily revoked._
+> [!TIP]
+> It's recommended to use an [impersonate token (API token)](https://pocketbase.io/docs/authentication/#api-keys) instead of the email and password, as this is more secure and can be easily revoked.
+> This also prevents the loader from hitting some rate limits with PocketBase, since the default is 2 authentication requests per 3 second interval.
 
 Under the hood, the loader will use the [PocketBase API](https://pocketbase.io/docs/api-collections/#view-collection) to fetch the schema of your collection and generate types with Zod based on that schema.
 
@@ -307,6 +309,17 @@ const blogLive = defineLiveCollection({
 });
 ```
 
+### Error handling
+
+The live content loader follows Astro's standard error handling conventions for live collections. For more information on how to handle errors in your components, see the [Astro documentation on error handling](https://docs.astro.build/en/reference/experimental-flags/live-content-collections/#error-handling).
+
+| Error                           | When it's returned                                                                                            |
+| ------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `PocketBaseAuthenticationError` | Authentication or authorization fails (missing credentials or invalid token)                                  |
+| `LiveEntryNotFoundError`        | The requested entry doesn't exist or doesn't match the applied filters                                        |
+| `LiveCollectionValidationError` | The data returned by PocketBase doesn't match the Zod schema or the `updatedField` doesn't contain valid data |
+| `LiveCollectionError`           | Any other error occurs (network errors, invalid filter syntax, PocketBase server errors, etc.)                |
+
 ### Caveats
 
 Live content loaders do not (yet 🤞🏼) support zod schemas and thus schema generation and entry transformation.