pocketbase-zod-schema 0.1.2

package/dist/mutator.js

@@ -0,0 +1,425 @@
+import { z } from 'zod';
+
+// src/schema/base.ts
+var baseSchema = {
+  id: z.string().describe("unique id"),
+  collectionId: z.string().describe("collection id"),
+  collectionName: z.string().describe("collection name"),
+  expand: z.record(z.any()).describe("expandable fields")
+};
+({
+  ...baseSchema,
+  created: z.string().describe("creation timestamp"),
+  updated: z.string().describe("last update timestamp")
+});
+({
+  ...baseSchema,
+  thumbnailURL: z.string().optional(),
+  imageFiles: z.array(z.string())
+});
+({
+  imageFiles: z.array(z.instanceof(File))
+});
+function withPermissions(schema, config) {
+  const metadata = {
+    permissions: config
+  };
+  return schema.describe(JSON.stringify(metadata));
+}
+function withIndexes(schema, indexes) {
+  let existingMetadata = {};
+  if (schema.description) {
+    try {
+      existingMetadata = JSON.parse(schema.description);
+    } catch {
+    }
+  }
+  const metadata = {
+    ...existingMetadata,
+    indexes
+  };
+  return schema.describe(JSON.stringify(metadata));
+}
+var UserInputSchema = z.object({
+  name: z.string().min(2, "Name must be longer").optional(),
+  email: z.string().email(),
+  password: z.string().min(8, "Password must be at least 8 characters"),
+  passwordConfirm: z.string(),
+  avatar: z.instanceof(File).optional()
+});
+var UserDatabaseSchema = z.object({
+  name: z.string().min(2, "Name must be longer").optional(),
+  email: z.string().email(),
+  password: z.string().min(8, "Password must be at least 8 characters"),
+  avatar: z.instanceof(File).optional()
+});
+withIndexes(
+  withPermissions(UserDatabaseSchema.extend(baseSchema), {
+    // Users can list other users (for mentions, user search, etc.)
+    listRule: "id = @request.auth.id",
+    // Users can view their own profile
+    viewRule: "id = @request.auth.id",
+    // Anyone can create an account (sign up)
+    createRule: "",
+    // Users can only update their own profile
+    updateRule: "id = @request.auth.id",
+    // Users can only delete their own account
+    deleteRule: "id = @request.auth.id",
+    // Users can only manage their own account (change email, password, etc.)
+    manageRule: "id = @request.auth.id"
+  }),
+  [
+    // Email should be unique for authentication
+    "CREATE UNIQUE INDEX idx_users_email ON users (email)",
+    // Index on name for user search and sorting
+    "CREATE INDEX idx_users_name ON users (name)"
+  ]
+);
+var BaseMutator = class {
+  pb;
+  // Define a default property that subclasses will override
+  options = {
+    expand: [],
+    filter: [],
+    sort: []
+  };
+  constructor(pb, options) {
+    this.pb = pb;
+    this.initializeOptions();
+    if (options) {
+      this.overrideOptions(options);
+    }
+  }
+  initializeOptions() {
+    this.options = this.setDefaults();
+  }
+  /**
+   * Initialize options with class-specific defaults
+   * Subclasses should override this instead of directly setting options
+   */
+  setDefaults() {
+    return {
+      expand: [],
+      filter: [],
+      sort: []
+    };
+  }
+  /**
+   * Merge provided options with current options
+   */
+  overrideOptions(newOptions) {
+    if (newOptions.expand !== void 0) {
+      this.options.expand = newOptions.expand;
+    }
+    if (newOptions.filter !== void 0) {
+      this.options.filter = newOptions.filter;
+    }
+    if (newOptions.sort !== void 0) {
+      this.options.sort = newOptions.sort;
+    }
+  }
+  toSnakeCase(str) {
+    return str.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_|_$/g, "");
+  }
+  /**
+   * Create a new entity
+   */
+  async create(input) {
+    try {
+      const data = await this.validateInput(input);
+      const record = await this.entityCreate(data);
+      return await this.processRecord(record);
+    } catch (error) {
+      return this.errorWrapper(error);
+    }
+  }
+  /**
+   * Update an existing entity
+   */
+  async update(id, input) {
+    try {
+      const record = await this.entityUpdate(id, input);
+      return await this.processRecord(record);
+    } catch (error) {
+      return this.errorWrapper(error);
+    }
+  }
+  /**
+   * Create or update entity (upsert)
+   */
+  async upsert(input) {
+    if (input?.id) {
+      return await this.update(input.id, input);
+    }
+    return await this.create(input);
+  }
+  /**
+   * Get entity by ID
+   */
+  async getById(id, expand) {
+    try {
+      const record = await this.entityGetById(id, expand);
+      return await this.processRecord(record);
+    } catch (error) {
+      return this.handleError(error, { allowNotFound: true });
+    }
+  }
+  /**
+   * Get first entity by filter
+   */
+  async getFirstByFilter(filter, expand, sort) {
+    try {
+      const record = await this.entityGetFirstByFilter(filter, expand, sort);
+      return await this.processRecord(record);
+    } catch (error) {
+      return this.handleError(error, { allowNotFound: true });
+    }
+  }
+  /**
+   * Get list of entities
+   */
+  async getList(page = 1, perPage = 100, filter, sort, expand) {
+    try {
+      const result = await this.entityGetList(page, perPage, filter, sort, expand);
+      return await this.processListResult(result);
+    } catch (error) {
+      return this.errorWrapper(error);
+    }
+  }
+  /**
+   * Delete entity by ID
+   */
+  async delete(id) {
+    try {
+      return await this.entityDelete(id);
+    } catch (error) {
+      return this.handleError(error, { returnValue: false });
+    }
+  }
+  /**
+   * Process a single record before returning it
+   * Can be overridden to handle special cases like mapped entities
+   */
+  async processRecord(record) {
+    return record;
+  }
+  /**
+   * Process a list result before returning it
+   * Can be overridden to handle special cases like mapped entities
+   */
+  async processListResult(result) {
+    const processedItems = await Promise.all(result.items.map((item) => this.processRecord(item)));
+    return {
+      ...result,
+      items: processedItems
+    };
+  }
+  /**
+   * Prepare expand parameter
+   * Combines default expands with provided expands
+   */
+  prepareExpand(expand) {
+    if (!this.options.expand.length && !expand) {
+      return void 0;
+    }
+    let expandArray = [...this.options.expand];
+    if (expand) {
+      if (typeof expand === "string") {
+        expandArray = expandArray.concat(expand.split(",").map((e) => e.trim()));
+      } else {
+        expandArray = expandArray.concat(expand);
+      }
+    }
+    const uniqueExpands = [...new Set(expandArray)].filter((e) => e !== "" && e !== void 0);
+    if (!uniqueExpands.length) {
+      return void 0;
+    }
+    return uniqueExpands.join(",");
+  }
+  /**
+   * Prepare filter parameter
+   * Combines default filters with provided filters
+   */
+  prepareFilter(filter) {
+    if (!this.options.filter.length && !filter) {
+      return void 0;
+    }
+    let filterArray = [...this.options.filter];
+    if (filter) {
+      if (typeof filter === "string") {
+        if (filter) filterArray.push(filter);
+      } else {
+        filterArray = filterArray.concat(filter);
+      }
+    }
+    const validFilters = filterArray.filter((f) => f !== "" && f !== void 0);
+    if (!validFilters.length) {
+      return void 0;
+    }
+    return validFilters.join("&&");
+  }
+  /**
+   * Prepare sort parameter
+   * Uses provided sort or falls back to default sort
+   */
+  prepareSort(sort) {
+    if (sort && sort !== "") {
+      return sort;
+    }
+    if (this.options.sort.length) {
+      const validSorts = this.options.sort.filter((s) => s !== "" && s !== void 0);
+      if (validSorts.length) {
+        return validSorts.join(",");
+      }
+    }
+    return void 0;
+  }
+  /**
+   * Perform the actual create operation
+   */
+  async entityCreate(data) {
+    return await this.getCollection().create(data);
+  }
+  /**
+   * Perform the actual update operation
+   */
+  async entityUpdate(id, data) {
+    return await this.getCollection().update(id, data);
+  }
+  /**
+   * Perform the actual getById operation
+   */
+  async entityGetById(id, expand) {
+    const finalExpand = this.prepareExpand(expand);
+    const options = finalExpand ? { expand: finalExpand } : {};
+    return await this.getCollection().getOne(id, options);
+  }
+  /**
+   * Perform the actual getFirstByFilter operation
+   */
+  async entityGetFirstByFilter(filter, expand, sort) {
+    const finalFilter = this.prepareFilter(filter);
+    const finalExpand = this.prepareExpand(expand);
+    const finalSort = this.prepareSort(sort);
+    const options = {};
+    if (finalExpand) options.expand = finalExpand;
+    if (finalSort) options.sort = finalSort;
+    return await this.getCollection().getFirstListItem(finalFilter || "", options);
+  }
+  /**
+   * Perform the actual getList operation
+   * Returns a list result with items of type T
+   */
+  async entityGetList(page, perPage, filter, sort, expand) {
+    const finalFilter = this.prepareFilter(filter);
+    const finalExpand = this.prepareExpand(expand);
+    const finalSort = this.prepareSort(sort);
+    const options = {};
+    if (finalFilter) options.filter = finalFilter;
+    if (finalExpand) options.expand = finalExpand;
+    if (finalSort) options.sort = finalSort;
+    return await this.getCollection().getList(page, perPage, options);
+  }
+  /**
+   * Perform the actual delete operation
+   */
+  async entityDelete(id) {
+    await this.getCollection().delete(id);
+    return true;
+  }
+  /**
+   * Error handler for common errors
+   * @param error The error to handle
+   * @param options Handler options
+   * @returns The value to return if the error is handled, or throws if not handled
+   */
+  handleError(error, options = { logError: true }) {
+    const { allowNotFound = false, returnValue, logError = true } = options;
+    if (logError) {
+      console.error(`Error in ${this.constructor.name}:`, error);
+    }
+    if (allowNotFound && this.isNotFoundError(error)) {
+      return null;
+    }
+    if (returnValue !== void 0) {
+      return returnValue;
+    }
+    throw error;
+  }
+  /**
+   * Check if an error is a "not found" error
+   */
+  isNotFoundError(error) {
+    return error instanceof Error && (error.message.includes("404") || error.message.toLowerCase().includes("not found"));
+  }
+  /**
+   * Standard error handling wrapper (legacy method, consider using handleError instead)
+   */
+  errorWrapper(error) {
+    console.error(`Error in ${this.constructor.name}:`, error);
+    throw error;
+  }
+  /**
+   * Subscribe to changes on a specific record
+   * @param id The ID of the record to subscribe to
+   * @param callback Function to call when changes occur
+   * @param expand Optional expand parameters
+   * @returns Promise that resolves to an unsubscribe function
+   */
+  async subscribeToRecord(id, callback, expand) {
+    const finalExpand = this.prepareExpand(expand);
+    const options = finalExpand ? { expand: finalExpand } : {};
+    return this.getCollection().subscribe(id, callback, options);
+  }
+  /**
+   * Subscribe to changes on the entire collection
+   * @param callback Function to call when changes occur
+   * @param expand Optional expand parameters
+   * @returns Promise that resolves to an unsubscribe function
+   */
+  async subscribeToCollection(callback, expand) {
+    const finalExpand = this.prepareExpand(expand);
+    const options = finalExpand ? { expand: finalExpand } : {};
+    return this.getCollection().subscribe("*", callback, options);
+  }
+  /**
+   * Unsubscribe from a specific record's changes
+   * @param id The ID of the record to unsubscribe from
+   */
+  unsubscribeFromRecord(id) {
+    this.getCollection().unsubscribe(id);
+  }
+  /**
+   * Unsubscribe from collection-wide changes
+   */
+  unsubscribeFromCollection() {
+    this.getCollection().unsubscribe("*");
+  }
+  /**
+   * Unsubscribe from all subscriptions in this collection
+   */
+  unsubscribeAll() {
+    this.getCollection().unsubscribe();
+  }
+};
+
+// src/mutator/userMutator.ts
+var UserMutator = class extends BaseMutator {
+  setDefaults() {
+    return {
+      expand: [],
+      filter: [],
+      sort: ["-updated"]
+    };
+  }
+  getCollection() {
+    return this.pb.collection("Projects");
+  }
+  async validateInput(input) {
+    return UserInputSchema.parse(input);
+  }
+};
+
+export { UserMutator };
+//# sourceMappingURL=mutator.js.map
+//# sourceMappingURL=mutator.js.map

package/dist/mutator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema/base.ts","../src/schema/user.ts","../src/mutator/baseMutator.ts","../src/mutator/userMutator.ts"],"names":["z"],"mappings":"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","file":"mutator.js","sourcesContent":["import { z } from \"zod\";\nimport type { PermissionSchema, PermissionTemplateConfig } from \"./permissions\";\n\n/**\n * Base schema fields that PocketBase automatically adds to all records\n * These fields are managed by PocketBase and should not be set manually\n */\nexport const baseSchema = {\n  id: z.string().describe(\"unique id\"),\n  collectionId: z.string().describe(\"collection id\"),\n  collectionName: z.string().describe(\"collection name\"),\n  expand: z.record(z.any()).describe(\"expandable fields\"),\n};\n\n/**\n * Extended base schema with timestamp fields\n * Includes created and updated autodate fields\n */\nexport const baseSchemaWithTimestamps = {\n  ...baseSchema,\n  created: z.string().describe(\"creation timestamp\"),\n  updated: z.string().describe(\"last update timestamp\"),\n};\n\n/**\n * Base schema for image file collections\n * Extends base schema with thumbnail URL and image files array\n */\nexport const baseImageFileSchema = {\n  ...baseSchema,\n  thumbnailURL: z.string().optional(),\n  imageFiles: z.array(z.string()),\n};\n\n/**\n * Input schema for image file uploads\n * Used in forms where users upload File objects\n * Requires Node.js 20+ or browser environment with File API\n */\nexport const inputImageFileSchema = {\n  imageFiles: z.array(z.instanceof(File)),\n};\n\n/**\n * Helper constant for omitting image files from schemas\n * Used with Zod's .omit() method\n */\nexport const omitImageFilesSchema = {\n  imageFiles: true,\n} as const;\n\n// ============================================================================\n// Common PocketBase Field Type Patterns\n// ============================================================================\n\n/**\n * Creates a text field schema with optional constraints\n * @param options - Optional constraints for the text field\n */\nexport function textField(options?: { min?: number; max?: number; pattern?: RegExp }) {\n  let schema = z.string();\n  if (options?.min !== undefined) schema = schema.min(options.min);\n  if (options?.max !== undefined) schema = schema.max(options.max);\n  if (options?.pattern !== undefined) schema = schema.regex(options.pattern);\n  return schema;\n}\n\n/**\n * Creates an email field schema\n * Maps to PocketBase 'email' field type\n */\nexport function emailField() {\n  return z.string().email();\n}\n\n/**\n * Creates a URL field schema\n * Maps to PocketBase 'url' field type\n */\nexport function urlField() {\n  return z.string().url();\n}\n\n/**\n * Creates a number field schema with optional constraints\n * @param options - Optional constraints for the number field\n */\nexport function numberField(options?: { min?: number; max?: number }) {\n  let schema = z.number();\n  if (options?.min !== undefined) schema = schema.min(options.min);\n  if (options?.max !== undefined) schema = schema.max(options.max);\n  return schema;\n}\n\n/**\n * Creates a boolean field schema\n * Maps to PocketBase 'bool' field type\n */\nexport function boolField() {\n  return z.boolean();\n}\n\n/**\n * Creates a date field schema\n * Maps to PocketBase 'date' field type\n */\nexport function dateField() {\n  return z.date();\n}\n\n/**\n * Creates a select field schema from enum values\n * Maps to PocketBase 'select' field type\n * @param values - Array of allowed string values\n */\nexport function selectField<T extends [string, ...string[]]>(values: T) {\n  return z.enum(values);\n}\n\n/**\n * Creates a JSON field schema\n * Maps to PocketBase 'json' field type\n * @param schema - Optional Zod schema for the JSON structure\n */\nexport function jsonField<T extends z.ZodTypeAny>(schema?: T) {\n  return schema ?? z.record(z.any());\n}\n\n/**\n * Creates a single file field schema for form input\n * Maps to PocketBase 'file' field type with maxSelect=1\n * Requires Node.js 20+ or browser environment with File API\n */\nexport function fileField() {\n  return z.instanceof(File);\n}\n\n/**\n * Creates a multiple file field schema for form input\n * Maps to PocketBase 'file' field type with maxSelect>1\n * Requires Node.js 20+ or browser environment with File API\n * @param options - Optional constraints for the file field\n */\nexport function filesField(options?: { min?: number; max?: number }) {\n  let schema = z.array(z.instanceof(File));\n  if (options?.min !== undefined) schema = schema.min(options.min);\n  if (options?.max !== undefined) schema = schema.max(options.max);\n  return schema;\n}\n\n/**\n * Creates a single relation field schema\n * Maps to PocketBase 'relation' field type with maxSelect=1\n * Field name should start with uppercase to be detected as relation\n */\nexport function relationField() {\n  return z.string();\n}\n\n/**\n * Creates a multiple relation field schema\n * Maps to PocketBase 'relation' field type with maxSelect>1\n * Field name should contain uppercase to be detected as relation\n * @param options - Optional constraints for the relation field\n */\nexport function relationsField(options?: { min?: number; max?: number }) {\n  let schema = z.array(z.string());\n  if (options?.min !== undefined) schema = schema.min(options.min);\n  if (options?.max !== undefined) schema = schema.max(options.max);\n  return schema;\n}\n\n/**\n * Creates an editor field schema (rich text)\n * Maps to PocketBase 'editor' field type\n */\nexport function editorField() {\n  return z.string();\n}\n\n/**\n * Creates a geo point field schema\n * Maps to PocketBase 'geoPoint' field type\n */\nexport function geoPointField() {\n  return z.object({\n    lon: z.number(),\n    lat: z.number(),\n  });\n}\n\n/**\n * Attach permission metadata to a Zod schema\n *\n * This helper function allows you to define PocketBase API rules alongside your\n * entity schema definitions. The permissions are stored as metadata using Zod's\n * describe() method and will be extracted during migration generation.\n *\n * @param schema - The Zod schema to attach permissions to\n * @param config - Either a PermissionTemplateConfig (for template-based permissions)\n *                 or a PermissionSchema (for custom permissions)\n * @returns The schema with permission metadata attached\n *\n * @example\n * // Using a template\n * const ProjectSchema = withPermissions(\n *   z.object({ title: z.string(), User: z.string() }),\n *   { template: 'owner-only', ownerField: 'User' }\n * );\n *\n * @example\n * // Using custom rules\n * const ProjectSchema = withPermissions(\n *   z.object({ title: z.string() }),\n *   { listRule: '@request.auth.id != \"\"', viewRule: '' }\n * );\n *\n * @example\n * // Using template with custom rule overrides\n * const ProjectSchema = withPermissions(\n *   z.object({ title: z.string(), User: z.string() }),\n *   {\n *     template: 'owner-only',\n *     ownerField: 'User',\n *     customRules: { listRule: '@request.auth.id != \"\"' }\n *   }\n * );\n */\nexport function withPermissions<T extends z.ZodTypeAny>(\n  schema: T,\n  config: PermissionTemplateConfig | PermissionSchema\n): T {\n  // Create metadata object with permissions config directly\n  // The PermissionAnalyzer will handle resolving templates vs direct schemas\n  const metadata = {\n    permissions: config,\n  };\n\n  // Attach permission metadata to schema using Zod's describe() method\n  // The metadata is serialized as JSON and stored in the schema's description\n  return schema.describe(JSON.stringify(metadata)) as T;\n}\n\n/**\n * Attach index definitions to a Zod schema\n *\n * This helper function allows you to define PocketBase indexes alongside your\n * entity schema definitions. The indexes are stored as metadata using Zod's\n * describe() method and will be extracted during migration generation.\n *\n * @param schema - The Zod schema to attach indexes to\n * @param indexes - Array of PocketBase index SQL statements\n * @returns The schema with index metadata attached\n *\n * @example\n * // Define indexes for a user schema\n * const UserSchema = withIndexes(\n *   withPermissions(\n *     z.object({ name: z.string(), email: z.string().email() }),\n *     userPermissions\n *   ),\n *   [\n *     'CREATE UNIQUE INDEX idx_users_email ON users (email)',\n *     'CREATE INDEX idx_users_name ON users (name)'\n *   ]\n * );\n *\n * @example\n * // Single index\n * const ProjectSchema = withIndexes(\n *   ProjectDatabaseSchema,\n *   ['CREATE INDEX idx_projects_status ON projects (status)']\n * );\n */\nexport function withIndexes<T extends z.ZodTypeAny>(schema: T, indexes: string[]): T {\n  // Extract existing metadata if present\n  let existingMetadata: any = {};\n\n  if (schema.description) {\n    try {\n      existingMetadata = JSON.parse(schema.description);\n    } catch {\n      // If description is not JSON, ignore it\n    }\n  }\n\n  // Merge indexes with existing metadata\n  const metadata = {\n    ...existingMetadata,\n    indexes,\n  };\n\n  // Attach metadata to schema using Zod's describe() method\n  return schema.describe(JSON.stringify(metadata)) as T;\n}\n","import { z } from \"zod\";\nimport { baseSchema, withIndexes, withPermissions } from \"./base\";\n\n/** -- User Collections -- */\n// Input schema for forms (includes passwordConfirm for validation)\nexport const UserInputSchema = z.object({\n  name: z.string().min(2, \"Name must be longer\").optional(),\n  email: z.string().email(),\n  password: z.string().min(8, \"Password must be at least 8 characters\"),\n  passwordConfirm: z.string(),\n  avatar: z.instanceof(File).optional(),\n});\n\n// Database schema (excludes passwordConfirm, includes avatar as file field)\nconst UserDatabaseSchema = z.object({\n  name: z.string().min(2, \"Name must be longer\").optional(),\n  email: z.string().email(),\n  password: z.string().min(8, \"Password must be at least 8 characters\"),\n  avatar: z.instanceof(File).optional(),\n});\n\n// Apply permissions and indexes for auth collection\n// Users can view all profiles, but only manage their own\nexport const UserSchema = withIndexes(\n  withPermissions(UserDatabaseSchema.extend(baseSchema), {\n    // Users can list other users (for mentions, user search, etc.)\n    listRule: \"id = @request.auth.id\",\n    // Users can view their own profile\n    viewRule: \"id = @request.auth.id\",\n    // Anyone can create an account (sign up)\n    createRule: \"\",\n    // Users can only update their own profile\n    updateRule: \"id = @request.auth.id\",\n    // Users can only delete their own account\n    deleteRule: \"id = @request.auth.id\",\n    // Users can only manage their own account (change email, password, etc.)\n    manageRule: \"id = @request.auth.id\",\n  }),\n  [\n    // Email should be unique for authentication\n    \"CREATE UNIQUE INDEX idx_users_email ON users (email)\",\n    // Index on name for user search and sorting\n    \"CREATE INDEX idx_users_name ON users (name)\",\n  ]\n);\n","import {\n  RecordService,\n  type ListResult,\n  type RecordListOptions,\n  type RecordModel,\n  type RecordOptions,\n  type RecordSubscribeOptions,\n  type RecordSubscription,\n  type UnsubscribeFunc,\n} from \"pocketbase\";\nimport type { TypedPocketBase } from \"../types\";\n\nexport interface MutatorOptions {\n  expand: string[];\n  filter: string[];\n  sort: string[];\n}\n\n// T represents the output model type that extends RecordModel\n// InputType represents the input type for creation operations\nexport abstract class BaseMutator<T extends RecordModel, InputType> {\n  protected pb: TypedPocketBase;\n\n  // Define a default property that subclasses will override\n  protected options: MutatorOptions = {\n    expand: [],\n    filter: [],\n    sort: [],\n  };\n\n  constructor(pb: TypedPocketBase, options?: Partial<MutatorOptions>) {\n    this.pb = pb;\n\n    // Initialize with default options first\n    this.initializeOptions();\n    if (options) {\n      this.overrideOptions(options);\n    }\n  }\n\n  private initializeOptions(): void {\n    this.options = this.setDefaults();\n  }\n  /**\n   * Initialize options with class-specific defaults\n   * Subclasses should override this instead of directly setting options\n   */\n  protected setDefaults(): MutatorOptions {\n    return {\n      expand: [],\n      filter: [],\n      sort: [],\n    };\n  }\n\n  /**\n   * Merge provided options with current options\n   */\n  protected overrideOptions(newOptions: Partial<MutatorOptions>): void {\n    if (newOptions.expand !== undefined) {\n      this.options.expand = newOptions.expand;\n    }\n    if (newOptions.filter !== undefined) {\n      this.options.filter = newOptions.filter;\n    }\n    if (newOptions.sort !== undefined) {\n      this.options.sort = newOptions.sort;\n    }\n  }\n\n  /**\n   * Get the collection instance\n   */\n  protected abstract getCollection(): RecordService<T>;\n\n  toSnakeCase(str: string): string {\n    return str\n      .trim()\n      .toLowerCase()\n      .replace(/[^a-z0-9]+/g, \"_\")\n      .replace(/^_|_$/g, \"\");\n  }\n\n  /**\n   * Create a new entity\n   */\n  async create(input: InputType): Promise<T> {\n    try {\n      const data = await this.validateInput(input);\n      const record = await this.entityCreate(data);\n      return await this.processRecord(record);\n    } catch (error) {\n      return this.errorWrapper(error);\n    }\n  }\n\n  /**\n   * Update an existing entity\n   */\n  async update(id: string, input: Partial<T>): Promise<T> {\n    try {\n      const record = await this.entityUpdate(id, input);\n      return await this.processRecord(record);\n    } catch (error) {\n      return this.errorWrapper(error);\n    }\n  }\n\n  /**\n   * Create or update entity (upsert)\n   */\n  async upsert(input: InputType & { id?: string }): Promise<T> {\n    if (input?.id) {\n      return await this.update(input.id, input as Partial<T>);\n    }\n\n    // Implementations should override this method if they need\n    // more specific upsert logic like checking for existing entities\n    return await this.create(input);\n  }\n\n  /**\n   * Get entity by ID\n   */\n  async getById(id: string, expand?: string | string[]): Promise<T | null> {\n    try {\n      const record = await this.entityGetById(id, expand);\n      return await this.processRecord(record);\n    } catch (error) {\n      return this.handleError(error, { allowNotFound: true });\n    }\n  }\n\n  /**\n   * Get first entity by filter\n   */\n  async getFirstByFilter(filter: string | string[], expand?: string | string[], sort?: string): Promise<T | null> {\n    try {\n      const record = await this.entityGetFirstByFilter(filter, expand, sort);\n      return await this.processRecord(record);\n    } catch (error) {\n      return this.handleError(error, { allowNotFound: true });\n    }\n  }\n\n  /**\n   * Get list of entities\n   */\n  async getList(\n    page = 1,\n    perPage = 100,\n    filter?: string | string[],\n    sort?: string,\n    expand?: string | string[]\n  ): Promise<ListResult<T>> {\n    try {\n      const result = await this.entityGetList(page, perPage, filter, sort, expand);\n      return await this.processListResult(result);\n    } catch (error) {\n      return this.errorWrapper(error);\n    }\n  }\n\n  /**\n   * Delete entity by ID\n   */\n  async delete(id: string): Promise<boolean> {\n    try {\n      return await this.entityDelete(id);\n    } catch (error) {\n      return this.handleError(error, { returnValue: false });\n    }\n  }\n\n  /**\n   * Process a single record before returning it\n   * Can be overridden to handle special cases like mapped entities\n   */\n  protected async processRecord(record: T): Promise<T> {\n    return record;\n  }\n\n  /**\n   * Process a list result before returning it\n   * Can be overridden to handle special cases like mapped entities\n   */\n  protected async processListResult(result: ListResult<T>): Promise<ListResult<T>> {\n    // Process each item in the list\n    const processedItems = await Promise.all(result.items.map((item) => this.processRecord(item)));\n\n    return {\n      ...result,\n      items: processedItems,\n    };\n  }\n\n  /**\n   * Prepare expand parameter\n   * Combines default expands with provided expands\n   */\n  protected prepareExpand(expand?: string | string[]): string | undefined {\n    // Handle empty defaults case\n    if (!this.options.expand.length && !expand) {\n      return undefined;\n    }\n\n    // Convert all inputs to arrays for easy processing\n    let expandArray: string[] = [...this.options.expand];\n\n    if (expand) {\n      // If expand is a string, split it and add the parts\n      if (typeof expand === \"string\") {\n        expandArray = expandArray.concat(expand.split(\",\").map((e) => e.trim()));\n      }\n      // If expand is already an array, concatenate\n      else {\n        expandArray = expandArray.concat(expand);\n      }\n    }\n\n    // Filter out duplicates, empty strings, and undefined values\n    const uniqueExpands = [...new Set(expandArray)].filter((e) => e !== \"\" && e !== undefined);\n\n    // If no valid expands, return undefined\n    if (!uniqueExpands.length) {\n      return undefined;\n    }\n\n    // Join with comma and space\n    return uniqueExpands.join(\",\");\n  }\n\n  /**\n   * Prepare filter parameter\n   * Combines default filters with provided filters\n   */\n  protected prepareFilter(filter?: string | string[]): string | undefined {\n    // Handle empty case\n    if (!this.options.filter.length && !filter) {\n      return undefined;\n    }\n\n    // Convert all inputs to arrays for easy processing\n    let filterArray: string[] = [...this.options.filter];\n\n    if (filter) {\n      // If filter is a string, add it as is (it might contain && already)\n      if (typeof filter === \"string\") {\n        if (filter) filterArray.push(filter);\n      }\n      // If filter is an array, concatenate\n      else {\n        filterArray = filterArray.concat(filter);\n      }\n    }\n\n    // Filter out empty strings and undefined values\n    const validFilters = filterArray.filter((f) => f !== \"\" && f !== undefined);\n\n    // If no valid filters, return undefined\n    if (!validFilters.length) {\n      return undefined;\n    }\n\n    // Join with AND operator\n    return validFilters.join(\"&&\");\n  }\n\n  /**\n   * Prepare sort parameter\n   * Uses provided sort or falls back to default sort\n   */\n  protected prepareSort(sort?: string): string | undefined {\n    // If explicit sort is provided and not empty, use it (overriding defaults)\n    if (sort && sort !== \"\") {\n      return sort;\n    }\n\n    // If no explicit sort but we have defaults\n    if (this.options.sort.length) {\n      // Filter out empty and undefined values\n      const validSorts = this.options.sort.filter((s) => s !== \"\" && s !== undefined);\n\n      // If we have valid sort items after filtering\n      if (validSorts.length) {\n        return validSorts.join(\",\");\n      }\n    }\n\n    // No sort specified\n    return undefined;\n  }\n\n  /**\n   * Perform the actual create operation\n   */\n  protected async entityCreate(data: InputType): Promise<T> {\n    return await this.getCollection().create(data as Record<string, any>);\n  }\n\n  /**\n   * Perform the actual update operation\n   */\n  protected async entityUpdate(id: string, data: Partial<T>): Promise<T> {\n    return await this.getCollection().update(id, data);\n  }\n\n  /**\n   * Perform the actual getById operation\n   */\n  protected async entityGetById(id: string, expand?: string | string[]): Promise<T> {\n    const finalExpand = this.prepareExpand(expand);\n    const options: RecordOptions = finalExpand ? { expand: finalExpand } : {};\n    return await this.getCollection().getOne(id, options);\n  }\n\n  /**\n   * Perform the actual getFirstByFilter operation\n   */\n  protected async entityGetFirstByFilter(\n    filter: string | string[],\n    expand?: string | string[],\n    sort?: string\n  ): Promise<T> {\n    const finalFilter = this.prepareFilter(filter);\n    const finalExpand = this.prepareExpand(expand);\n    const finalSort = this.prepareSort(sort);\n\n    const options: RecordListOptions = {};\n    if (finalExpand) options.expand = finalExpand;\n    if (finalSort) options.sort = finalSort;\n\n    return await this.getCollection().getFirstListItem(finalFilter || \"\", options);\n  }\n\n  /**\n   * Perform the actual getList operation\n   * Returns a list result with items of type T\n   */\n  protected async entityGetList(\n    page: number,\n    perPage: number,\n    filter?: string | string[],\n    sort?: string,\n    expand?: string | string[]\n  ): Promise<ListResult<T>> {\n    const finalFilter = this.prepareFilter(filter);\n    const finalExpand = this.prepareExpand(expand);\n    const finalSort = this.prepareSort(sort);\n\n    const options: RecordListOptions = {};\n    if (finalFilter) options.filter = finalFilter;\n    if (finalExpand) options.expand = finalExpand;\n    if (finalSort) options.sort = finalSort;\n\n    return await this.getCollection().getList(page, perPage, options);\n  }\n\n  /**\n   * Perform the actual delete operation\n   */\n  protected async entityDelete(id: string): Promise<boolean> {\n    await this.getCollection().delete(id);\n    return true;\n  }\n\n  /**\n   * Error handler for common errors\n   * @param error The error to handle\n   * @param options Handler options\n   * @returns The value to return if the error is handled, or throws if not handled\n   */\n  protected handleError<R>(\n    error: any,\n    options: {\n      allowNotFound?: boolean;\n      returnValue?: R;\n      logError?: boolean;\n    } = { logError: true }\n  ): R {\n    const { allowNotFound = false, returnValue, logError = true } = options;\n\n    // Log the error if requested\n    if (logError) {\n      console.error(`Error in ${this.constructor.name}:`, error);\n    }\n\n    // Handle 404 errors if allowed\n    if (allowNotFound && this.isNotFoundError(error)) {\n      return null as R;\n    }\n\n    // Return specified value or rethrow\n    if (returnValue !== undefined) {\n      return returnValue;\n    }\n\n    // Rethrow the error\n    throw error;\n  }\n\n  /**\n   * Check if an error is a \"not found\" error\n   */\n  protected isNotFoundError(error: any): boolean {\n    return (\n      error instanceof Error && (error.message.includes(\"404\") || error.message.toLowerCase().includes(\"not found\"))\n    );\n  }\n\n  /**\n   * Standard error handling wrapper (legacy method, consider using handleError instead)\n   */\n  protected errorWrapper(error: any): never {\n    console.error(`Error in ${this.constructor.name}:`, error);\n    throw error;\n  }\n\n  /**\n   * Validate input data before creating/updating\n   * Should be implemented by child classes\n   */\n  protected abstract validateInput(input: InputType): Promise<InputType>;\n\n  /**\n   * Subscribe to changes on a specific record\n   * @param id The ID of the record to subscribe to\n   * @param callback Function to call when changes occur\n   * @param expand Optional expand parameters\n   * @returns Promise that resolves to an unsubscribe function\n   */\n  async subscribeToRecord(\n    id: string,\n    callback: (data: RecordSubscription<T>) => void,\n    expand?: string | string[]\n  ): Promise<UnsubscribeFunc> {\n    const finalExpand = this.prepareExpand(expand);\n    const options: RecordSubscribeOptions = finalExpand ? { expand: finalExpand } : {};\n\n    return this.getCollection().subscribe(id, callback, options);\n  }\n\n  /**\n   * Subscribe to changes on the entire collection\n   * @param callback Function to call when changes occur\n   * @param expand Optional expand parameters\n   * @returns Promise that resolves to an unsubscribe function\n   */\n  async subscribeToCollection(\n    callback: (data: RecordSubscription<T>) => void,\n    expand?: string | string[]\n  ): Promise<UnsubscribeFunc> {\n    const finalExpand = this.prepareExpand(expand);\n    const options: RecordSubscribeOptions = finalExpand ? { expand: finalExpand } : {};\n\n    return this.getCollection().subscribe(\"*\", callback, options);\n  }\n\n  /**\n   * Unsubscribe from a specific record's changes\n   * @param id The ID of the record to unsubscribe from\n   */\n  unsubscribeFromRecord(id: string): void {\n    this.getCollection().unsubscribe(id);\n  }\n\n  /**\n   * Unsubscribe from collection-wide changes\n   */\n  unsubscribeFromCollection(): void {\n    this.getCollection().unsubscribe(\"*\");\n  }\n\n  /**\n   * Unsubscribe from all subscriptions in this collection\n   */\n  unsubscribeAll(): void {\n    this.getCollection().unsubscribe();\n  }\n}\n","import { UserInputSchema } from \"../schema\";\nimport type { UserInputType, UserType } from \"../types\";\nimport { BaseMutator, type MutatorOptions } from \"./baseMutator\";\n\nexport class UserMutator extends BaseMutator<UserType, UserInputType> {\n  protected setDefaults(): MutatorOptions {\n    return {\n      expand: [],\n      filter: [],\n      sort: [\"-updated\"],\n    };\n  }\n\n  protected getCollection() {\n    return this.pb.collection(\"Projects\");\n  }\n\n  protected async validateInput(input: UserInputType) {\n    return UserInputSchema.parse(input);\n  }\n}\n"]}

package/dist/permissions-ZHafVSIx.d.cts

@@ -0,0 +1,71 @@
+/**
+ * Permission schema types and interfaces for PocketBase API rules
+ *
+ * This module defines the core types for managing collection-level permissions
+ * that control access to list, view, create, update, delete, and manage operations.
+ */
+/**
+ * PocketBase API rule types
+ *
+ * Each rule type corresponds to a specific API operation:
+ * - listRule: Controls who can list/query records
+ * - viewRule: Controls who can view individual records
+ * - createRule: Controls who can create new records
+ * - updateRule: Controls who can update existing records
+ * - deleteRule: Controls who can delete records
+ * - manageRule: Controls who can manage auth records (auth collections only)
+ */
+type APIRuleType = "listRule" | "viewRule" | "createRule" | "updateRule" | "deleteRule" | "manageRule";
+/**
+ * Rule expression - can be null (locked), empty string (public), or filter expression
+ *
+ * - null: Locked to superusers only
+ * - "" (empty string): Public access - anyone can perform the operation
+ * - string: Filter expression using PocketBase syntax (e.g., "@request.auth.id != ''")
+ */
+type RuleExpression = string | null;
+/**
+ * Permission schema definition
+ *
+ * Defines the complete set of API rules for a collection.
+ * All fields are optional - undefined rules will default to null (locked).
+ */
+interface PermissionSchema {
+    listRule?: RuleExpression;
+    viewRule?: RuleExpression;
+    createRule?: RuleExpression;
+    updateRule?: RuleExpression;
+    deleteRule?: RuleExpression;
+    manageRule?: RuleExpression;
+}
+/**
+ * Permission template types for common patterns
+ *
+ * Predefined templates that generate standard permission configurations:
+ * - public: All operations are publicly accessible
+ * - authenticated: Requires user authentication for all operations
+ * - owner-only: Users can only manage their own records
+ * - admin-only: Only admin/superusers can perform operations
+ * - read-public: Public read access, authenticated write access
+ * - custom: Fully custom rules defined by the developer
+ */
+type PermissionTemplate = "public" | "authenticated" | "owner-only" | "admin-only" | "read-public" | "custom";
+/**
+ * Template configuration
+ *
+ * Configuration object for applying permission templates with customization options.
+ * Allows templates to be parameterized (e.g., specifying the owner field name)
+ * and overridden with custom rules.
+ */
+interface PermissionTemplateConfig {
+    /** The template to apply */
+    template: PermissionTemplate;
+    /** Field name for owner relation (default: 'User') - used with 'owner-only' template */
+    ownerField?: string;
+    /** Field name for role checking - used with 'admin-only' template */
+    roleField?: string;
+    /** Custom rules that override template-generated rules */
+    customRules?: Partial<PermissionSchema>;
+}
+
+export type { APIRuleType as A, PermissionSchema as P, RuleExpression as R, PermissionTemplate as a, PermissionTemplateConfig as b };

package/dist/permissions-ZHafVSIx.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Permission schema types and interfaces for PocketBase API rules
+ *
+ * This module defines the core types for managing collection-level permissions
+ * that control access to list, view, create, update, delete, and manage operations.
+ */
+/**
+ * PocketBase API rule types
+ *
+ * Each rule type corresponds to a specific API operation:
+ * - listRule: Controls who can list/query records
+ * - viewRule: Controls who can view individual records
+ * - createRule: Controls who can create new records
+ * - updateRule: Controls who can update existing records
+ * - deleteRule: Controls who can delete records
+ * - manageRule: Controls who can manage auth records (auth collections only)
+ */
+type APIRuleType = "listRule" | "viewRule" | "createRule" | "updateRule" | "deleteRule" | "manageRule";
+/**
+ * Rule expression - can be null (locked), empty string (public), or filter expression
+ *
+ * - null: Locked to superusers only
+ * - "" (empty string): Public access - anyone can perform the operation
+ * - string: Filter expression using PocketBase syntax (e.g., "@request.auth.id != ''")
+ */
+type RuleExpression = string | null;
+/**
+ * Permission schema definition
+ *
+ * Defines the complete set of API rules for a collection.
+ * All fields are optional - undefined rules will default to null (locked).
+ */
+interface PermissionSchema {
+    listRule?: RuleExpression;
+    viewRule?: RuleExpression;
+    createRule?: RuleExpression;
+    updateRule?: RuleExpression;
+    deleteRule?: RuleExpression;
+    manageRule?: RuleExpression;
+}
+/**
+ * Permission template types for common patterns
+ *
+ * Predefined templates that generate standard permission configurations:
+ * - public: All operations are publicly accessible
+ * - authenticated: Requires user authentication for all operations
+ * - owner-only: Users can only manage their own records
+ * - admin-only: Only admin/superusers can perform operations
+ * - read-public: Public read access, authenticated write access
+ * - custom: Fully custom rules defined by the developer
+ */
+type PermissionTemplate = "public" | "authenticated" | "owner-only" | "admin-only" | "read-public" | "custom";
+/**
+ * Template configuration
+ *
+ * Configuration object for applying permission templates with customization options.
+ * Allows templates to be parameterized (e.g., specifying the owner field name)
+ * and overridden with custom rules.
+ */
+interface PermissionTemplateConfig {
+    /** The template to apply */
+    template: PermissionTemplate;
+    /** Field name for owner relation (default: 'User') - used with 'owner-only' template */
+    ownerField?: string;
+    /** Field name for role checking - used with 'admin-only' template */
+    roleField?: string;
+    /** Custom rules that override template-generated rules */
+    customRules?: Partial<PermissionSchema>;
+}
+
+export type { APIRuleType as A, PermissionSchema as P, RuleExpression as R, PermissionTemplate as a, PermissionTemplateConfig as b };