astro-loader-pocketbase 3.0.1 → 3.1.0-next.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astro-loader-pocketbase",
-  "version": "3.0.1",
+  "version": "3.1.0-next.1",
   "description": "A content loader for Astro that uses the PocketBase API",
   "keywords": [
     "astro",
@@ -50,15 +50,15 @@
     "@commitlint/cli": "20.5.0",
     "@commitlint/config-conventional": "20.5.0",
     "@types/node": "24.10.1",
-    "@vitest/coverage-v8": "4.1.3",
-    "astro": "6.1.5",
-    "globals": "17.4.0",
+    "@vitest/coverage-v8": "4.1.4",
+    "astro": "6.1.8",
+    "globals": "17.5.0",
     "husky": "9.1.7",
     "lint-staged": "16.4.0",
-    "oxfmt": "0.44.0",
-    "oxlint": "1.59.0",
-    "oxlint-tsgolint": "0.20.0",
-    "vitest": "4.1.3",
+    "oxfmt": "0.45.0",
+    "oxlint": "1.60.0",
+    "oxlint-tsgolint": "0.21.1",
+    "vitest": "4.1.4",
     "zod-to-ts": "2.0.0"
   },
   "peerDependencies": {

package/src/schema/generate-schema.ts

@@ -13,9 +13,19 @@ import { transformFiles } from "./transform-files";
  * Basic schema for every PocketBase collection.
  */
 const BASIC_SCHEMA = z.object({
-  id: z.string(),
-  collectionId: z.string(),
-  collectionName: z.string()
+  id: z.string().meta({
+    title: "id",
+    description: "The unique identifier for the entry."
+  }),
+  collectionId: z.string().meta({
+    title: "collectionId",
+    description:
+      "The unique identifier for the collection the entity belongs to."
+  }),
+  collectionName: z.string().meta({
+    title: "collectionName",
+    description: "The name of the collection the entity belongs to."
+  })
 });
 
 /**

package/src/schema/parse-schema.ts

@@ -45,7 +45,6 @@ export function parseSchema(
     let fieldType: z.ZodType;
 
     // Determine the field type and create the corresponding Zod type
-    // oxlint-disable-next-line switch-exhaustiveness-check
     switch (field.type) {
       case "number":
         fieldType = z.number();
@@ -120,7 +119,11 @@ export function parseSchema(
     }
 
     // Add the field to the fields object
-    fields[field.name] = fieldType;
+    fields[field.name] = fieldType.meta({
+      id: field.id,
+      title: field.name,
+      description: getFieldDescription(field)
+    });
   }
 
   return fields;
@@ -145,3 +148,23 @@ function parseSingleOrMultipleValues(
 
   return z.array(type);
 }
+
+/**
+ * Get the description for a field based on its help text and type.
+ */
+function getFieldDescription(field: PocketBaseSchemaEntry): string | undefined {
+  switch (true) {
+    case !!field.help:
+      return field.help;
+    case field.type === "autodate" && field.onUpdate:
+      return "Date when the entry was last updated. This field is automatically updated by PocketBase whenever the entry is updated.";
+    case field.type === "autodate" && field.onCreate:
+      return "Date when the entry was created. This field is automatically set by PocketBase when the entry is created.";
+    case field.name === "id":
+      return "The unique identifier for the entry.";
+    case field.hidden:
+      return "This field is hidden and may require superuser credentials to access.";
+    default:
+      return undefined;
+  }
+}

package/src/types/pocketbase-schema.type.ts

@@ -9,10 +9,19 @@ export const pocketBaseSchemaEntry = z.object({
    * Hidden fields are not returned in the API response.
    */
   hidden: z.optional(z.boolean()),
+  /**
+   * Unique identifier for the field.
+   */
+  id: z.string(),
   /**
    * Name of the field.
    */
   name: z.string(),
+  /**
+   * Help text for the field.
+   * This is only present if the field has help text defined.
+   */
+  help: z.optional(z.string()),
   /**
    * Type of the field.
    */