astro-loader-pocketbase 2.1.0 → 2.2.0-next.2

package/README.md

@@ -108,6 +108,23 @@ The loader will also automatically convert the value into a slug to be easily us
 It's recommended to use e.g. the title of the entry to be easily searchable and readable.
 **Do not use e.g. rich text fields as ids.**
 
+### Improved types
+
+By default PocketBase reports `number` and `boolean` fields as not required, even though the API will always return at least `0` and `false` respectively.
+This means that the loader will add `undefined` to the type of these fields.
+If you want to enforce that these fields are always present, you can set the `improveTypes` option to `true`.
+
+```ts
+const blog = defineCollection({
+  loader: pocketbaseLoader({
+    ...options,
+    improveTypes: true
+  })
+});
+```
+
+This will remove `undefined` from the type of these fields and mark them as required.
+
 ## Type generation
 
 The loader can automatically generate types for your collection.
@@ -167,6 +184,7 @@ This manual schema will **always override the automatic type generation**.
 | `superuserCredentials` | `{ email: string, password: string }` |          | The email and password of the superuser of the PocketBase instance. This is used for automatic type generation. |
 | `localSchema`          | `string`                              |          | The path to a local schema file. This is used for automatic type generation.                                    |
 | `jsonSchemas`          | `Record<string, z.ZodSchema>`         |          | A record of Zod schemas to use for type generation of `json` fields.                                            |
+| `improveTypes`         | `boolean`                             |          | Whether to improve the types of `number` and `boolean` fields, removing `undefined` from them.                  |
 
 ## Special cases
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astro-loader-pocketbase",
-  "version": "2.1.0",
+  "version": "2.2.0-next.2",
   "description": "A content loader for Astro that uses the PocketBase API",
   "license": "MIT",
   "author": "Luis Wolf <development@pawcode.de> (https://pawcode.de)",
@@ -22,14 +22,14 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.18.0",
-    "@stylistic/eslint-plugin": "^2.12.1",
-    "@types/node": "^22.10.5",
-    "astro": "^5.1.5",
+    "@stylistic/eslint-plugin": "^2.13.0",
+    "@types/node": "^22.10.7",
+    "astro": "^5.1.8",
     "eslint": "^9.18.0",
     "globals": "^15.14.0",
     "husky": "^9.1.7",
     "typescript": "^5.7.3",
-    "typescript-eslint": "^8.19.1"
+    "typescript-eslint": "^8.21.0"
   },
   "keywords": [
     "astro",

package/src/generate-schema.ts

@@ -60,7 +60,8 @@ export async function generateSchema(
   const fields = parseSchema(
     collection,
     options.jsonSchemas,
-    hasSuperuserRights
+    hasSuperuserRights,
+    options.improveTypes ?? false
   );
 
   // Check if custom id field is present

package/src/types/pocketbase-loader-options.type.ts

@@ -65,4 +65,12 @@ export interface PocketBaseLoaderOptions {
    * Note that this will only be used for fields of type `json`.
    */
   jsonSchemas?: Record<string, z.ZodSchema>;
+  /**
+   * Whether to improve the types of the generated schema.
+   * With this option enabled, the schema will not include `undefined` as possible value for number and boolean fields and mark them as required.
+   *
+   * Why do we need this option?
+   * The PocketBase API does always return at least `0` or `false` as the default values, even though the fields are not marked as required in the schema.
+   */
+  improveTypes?: boolean;
 }

package/src/utils/parse-schema.ts

@@ -7,7 +7,8 @@ import type {
 export function parseSchema(
   collection: PocketBaseCollection,
   customSchemas: Record<string, z.ZodType> | undefined,
-  hasSuperuserRights: boolean
+  hasSuperuserRights: boolean,
+  improveTypes: boolean
 ): Record<string, z.ZodType> {
   // Prepare the schemas fields
   const fields: Record<string, z.ZodType> = {};
@@ -25,11 +26,11 @@ export function parseSchema(
     switch (field.type) {
       case "number":
         // Coerce the value to a number
-        fieldType = z.coerce.number();
+        fieldType = z.number();
         break;
       case "bool":
         // Coerce the value to a boolean
-        fieldType = z.coerce.boolean();
+        fieldType = z.boolean();
         break;
       case "date":
       case "autodate":
@@ -73,9 +74,13 @@ export function parseSchema(
         break;
     }
 
-    // Check if the field is required (onCreate autodate fields are always set)
     const isRequired =
-      field.required || (field.type === "autodate" && field.onCreate);
+      // Check if the field is required
+      field.required ||
+      // `onCreate autodate` fields are always set
+      (field.type === "autodate" && field.onCreate) ||
+      // Improve number and boolean types by providing default values
+      (improveTypes && (field.type === "number" || field.type === "bool"));
 
     // If the field is not required, mark it as optional
     if (!isRequired) {