pocketbase-zod-schema 0.7.0 → 0.7.2

package/dist/server.cjs

@@ -481,13 +481,16 @@ function withIndexes(schema, indexes) {
   return schema.describe(JSON.stringify(metadata));
 }
 function defineCollection(config) {
-  const { collectionName, schema, permissions, indexes, type, ...futureOptions } = config;
+  const { collectionName, schema, permissions, indexes, type, viewQuery, ...futureOptions } = config;
   const metadata = {
     collectionName
   };
   if (type) {
     metadata.type = type;
   }
+  if (viewQuery !== void 0) {
+    metadata.viewQuery = viewQuery;
+  }
   if (permissions) {
     metadata.permissions = permissions;
   }
@@ -753,6 +756,88 @@ function GeoPointField() {
   };
   return schema.describe(JSON.stringify(metadata));
 }
+function dedentSql(value) {
+  const lines = value.replace(/\r\n/g, "\n").split("\n");
+  while (lines.length > 0 && lines[0].trim() === "") {
+    lines.shift();
+  }
+  while (lines.length > 0 && lines[lines.length - 1].trim() === "") {
+    lines.pop();
+  }
+  if (lines.length === 0) {
+    return "";
+  }
+  let minIndent = Infinity;
+  for (const line of lines) {
+    if (line.trim() === "") continue;
+    const indent = line.length - line.trimStart().length;
+    if (indent < minIndent) {
+      minIndent = indent;
+    }
+  }
+  if (!Number.isFinite(minIndent) || minIndent === 0) {
+    return lines.map((line) => line.trimEnd()).join("\n");
+  }
+  return lines.map((line) => line.slice(minIndent).trimEnd()).join("\n");
+}
+function sql(strings, ...values) {
+  let result = "";
+  for (let i = 0; i < strings.length; i++) {
+    result += strings[i];
+    if (i < values.length) {
+      result += String(values[i]);
+    }
+  }
+  return dedentSql(result);
+}
+function stripLeadingComments(query) {
+  let remaining = query.trim();
+  while (remaining.length > 0) {
+    if (remaining.startsWith("--")) {
+      const newline = remaining.indexOf("\n");
+      remaining = newline === -1 ? "" : remaining.slice(newline + 1).trim();
+      continue;
+    }
+    if (remaining.startsWith("/*")) {
+      const end = remaining.indexOf("*/");
+      remaining = end === -1 ? "" : remaining.slice(end + 2).trim();
+      continue;
+    }
+    break;
+  }
+  return remaining;
+}
+function validateViewQuery(collectionName, viewQuery) {
+  if (typeof viewQuery !== "string" || viewQuery.trim() === "") {
+    throw new Error(
+      `View collection "${collectionName}" requires a non-empty viewQuery. Provide the SQL SELECT statement backing the view.`
+    );
+  }
+  const body = stripLeadingComments(viewQuery);
+  if (!/^(select|with)\b/i.test(body)) {
+    throw new Error(
+      `View collection "${collectionName}" has an invalid viewQuery: it must start with SELECT or WITH. Received: ${body.slice(0, 40)}${body.length > 40 ? "..." : ""}`
+    );
+  }
+}
+function defineView(config) {
+  const { collectionName, schema, viewQuery, permissions } = config;
+  validateViewQuery(collectionName, viewQuery);
+  return defineCollection({
+    collectionName,
+    schema,
+    type: "view",
+    viewQuery,
+    // Write rules are always locked for views - PocketBase rejects anything else
+    permissions: {
+      listRule: permissions?.listRule ?? null,
+      viewRule: permissions?.viewRule ?? null,
+      createRule: null,
+      updateRule: null,
+      deleteRule: null
+    }
+  });
+}
 
 // src/utils/permission-templates.ts
 var PermissionTemplates = {
@@ -2299,13 +2384,26 @@ function extractCollectionTypeFromSchema(zodSchema) {
   }
   try {
     const metadata = JSON.parse(zodSchema.description);
-    if (metadata.type === "base" || metadata.type === "auth") {
+    if (metadata.type === "base" || metadata.type === "auth" || metadata.type === "view") {
       return metadata.type;
     }
   } catch {
   }
   return null;
 }
+function extractViewQueryFromSchema(zodSchema) {
+  if (!zodSchema.description) {
+    return null;
+  }
+  try {
+    const metadata = JSON.parse(zodSchema.description);
+    if (typeof metadata.viewQuery === "string") {
+      return metadata.viewQuery;
+    }
+  } catch {
+  }
+  return null;
+}
 function extractSchemaDefinitions(module, patterns = ["Schema", "InputSchema", "Collection"]) {
   const result = {};
   if (module.default instanceof zod.z.ZodObject) {
@@ -2464,6 +2562,15 @@ function convertZodSchemaToCollectionSchema(collectionName, zodSchema) {
   const rawFields = extractFieldDefinitions(zodSchema);
   const explicitType = extractCollectionTypeFromSchema(zodSchema);
   const collectionType = explicitType ?? (isAuthCollection(rawFields) ? "auth" : "base");
+  const isView = collectionType === "view";
+  const viewQuery = extractViewQueryFromSchema(zodSchema);
+  if (isView) {
+    validateViewQuery(collectionName, viewQuery);
+  } else if (viewQuery !== null) {
+    console.warn(
+      `[${collectionName}] viewQuery is only used by view collections and will be ignored. Use defineView() or set type: "view" to define a view collection.`
+    );
+  }
   const fields = rawFields.filter((f) => !["created", "updated"].includes(f.name)).map(({ name, zodType }) => buildFieldDefinition(name, zodType));
   if (collectionType === "auth") {
     const authSystemFields = [
@@ -2523,26 +2630,43 @@ function convertZodSchemaToCollectionSchema(collectionName, zodSchema) {
     }
   }
   const indexes = extractIndexes(zodSchema) || [];
+  if (isView && indexes.length > 0) {
+    throw new Error(
+      `View collection "${collectionName}" cannot declare indexes. PocketBase view collections are backed by a SQL query and do not support indexes.`
+    );
+  }
   const permissionAnalyzer = new PermissionAnalyzer();
   let permissions = void 0;
   const schemaDescription = zodSchema.description;
   const extractedPermissions = permissionAnalyzer.extractPermissions(schemaDescription);
   if (extractedPermissions) {
     const resolvedPermissions = permissionAnalyzer.resolvePermissions(extractedPermissions);
-    const validationResults = permissionAnalyzer.validatePermissions(
-      collectionName,
-      resolvedPermissions,
-      fields,
-      collectionType === "auth"
-    );
-    for (const [ruleType, result] of validationResults) {
-      if (!result.valid) {
-        console.error(`[${collectionName}] Permission validation failed for ${ruleType}:`);
-        result.errors.forEach((error) => console.error(`  - ${error}`));
+    if (isView) {
+      for (const ruleType of ["createRule", "updateRule", "deleteRule", "manageRule"]) {
+        if (resolvedPermissions[ruleType]) {
+          console.warn(
+            `[${collectionName}] ${ruleType} is not supported on view collections and will be set to null.`
+          );
+        }
+        resolvedPermissions[ruleType] = null;
       }
-      if (result.warnings.length > 0) {
-        console.warn(`[${collectionName}] Permission warnings for ${ruleType}:`);
-        result.warnings.forEach((warning) => console.warn(`  - ${warning}`));
+    }
+    if (!isView) {
+      const validationResults = permissionAnalyzer.validatePermissions(
+        collectionName,
+        resolvedPermissions,
+        fields,
+        collectionType === "auth"
+      );
+      for (const [ruleType, result] of validationResults) {
+        if (!result.valid) {
+          console.error(`[${collectionName}] Permission validation failed for ${ruleType}:`);
+          result.errors.forEach((error) => console.error(`  - ${error}`));
+        }
+        if (result.warnings.length > 0) {
+          console.warn(`[${collectionName}] Permission warnings for ${ruleType}:`);
+          result.warnings.forEach((warning) => console.warn(`  - ${warning}`));
+        }
       }
     }
     permissions = permissionAnalyzer.mergeWithDefaults(resolvedPermissions);
@@ -2563,6 +2687,9 @@ function convertZodSchemaToCollectionSchema(collectionName, zodSchema) {
     },
     permissions
   };
+  if (isView) {
+    collectionSchema.viewQuery = viewQuery;
+  }
   return collectionSchema;
 }
 var tsxLoaderRegistered = false;
@@ -2844,8 +2971,9 @@ function convertPocketBaseField(pbField) {
 }
 function convertPocketBaseCollection(pbCollection) {
   const fields = [];
+  const isView = pbCollection.type === "view";
   const systemFieldNames = ["id", "created", "updated", "collectionId", "collectionName", "expand"];
-  if (pbCollection.fields && Array.isArray(pbCollection.fields)) {
+  if (!isView && pbCollection.fields && Array.isArray(pbCollection.fields)) {
     for (const pbField of pbCollection.fields) {
       if (pbField.system || systemFieldNames.includes(pbField.name)) {
         const isAuthSystemField = pbCollection.type === "auth" && ["email", "emailVisibility", "verified", "password", "tokenKey"].includes(pbField.name);
@@ -2865,6 +2993,9 @@ function convertPocketBaseCollection(pbCollection) {
   if (pbCollection.id) {
     schema.id = pbCollection.id;
   }
+  if (typeof pbCollection.viewQuery === "string") {
+    schema.viewQuery = dedentSql(pbCollection.viewQuery);
+  }
   if (pbCollection.indexes && Array.isArray(pbCollection.indexes)) {
     schema.indexes = pbCollection.indexes;
   }
@@ -2966,6 +3097,24 @@ function findMigrationsAfterSnapshot(migrationsPath, snapshotTimestamp) {
     return [];
   }
 }
+function skipTemplateLiteral(content, start) {
+  let i = start + 1;
+  while (i < content.length) {
+    const char = content[i];
+    if (char === "\\") {
+      i += 2;
+      continue;
+    }
+    if (char === "`") {
+      return i + 1;
+    }
+    i++;
+  }
+  return i;
+}
+function unescapeTemplateLiteral(raw) {
+  return raw.replace(/\\(`|\$\{|\\)/g, "$1");
+}
 function parseMigrationOperationsFromContent(content) {
   const collectionsToCreate = [];
   const collectionsToDelete = [];
@@ -3054,6 +3203,10 @@ function parseMigrationOperationsFromContent(content) {
       while (i < content.length && bCount > 0) {
         const char = content[i];
         const prev = i > 0 ? content[i - 1] : "";
+        if (!inStr && char === "`") {
+          i = skipTemplateLiteral(content, i);
+          continue;
+        }
         if (!inStr && (char === '"' || char === "'")) {
           inStr = true;
           strChar = char;
@@ -3243,6 +3396,95 @@ function parseMigrationOperationsFromContent(content) {
         }
       }
     }
+    const viewQueryRegex = /(\w+)\.viewQuery\s*=\s*/g;
+    let viewQueryMatch;
+    while ((viewQueryMatch = viewQueryRegex.exec(content)) !== null) {
+      const varInfo = variables.get(viewQueryMatch[1]);
+      if (!varInfo || varInfo.type !== "collection") continue;
+      const valueStart = viewQueryMatch.index + viewQueryMatch[0].length;
+      if (content[valueStart] === "`") {
+        const end = skipTemplateLiteral(content, valueStart);
+        const raw = content.substring(valueStart + 1, end - 1);
+        getUpdate(varInfo.name).viewQuery = dedentSql(unescapeTemplateLiteral(raw));
+        viewQueryRegex.lastIndex = end;
+      } else {
+        const terminator = content.indexOf(";", valueStart);
+        const valueStr = content.substring(valueStart, terminator === -1 ? content.length : terminator);
+        try {
+          getUpdate(varInfo.name).viewQuery = dedentSql(new Function("app", `return ${valueStr}`)(mockApp));
+        } catch {
+          getUpdate(varInfo.name).viewQuery = dedentSql(valueStr.trim());
+        }
+      }
+    }
+    const unmarshalRegex = /unmarshal\s*\(/g;
+    let unmarshalMatch;
+    while ((unmarshalMatch = unmarshalRegex.exec(content)) !== null) {
+      let i = unmarshalMatch.index + unmarshalMatch[0].length;
+      while (i < content.length && /\s/.test(content[i])) i++;
+      if (content[i] !== "{") continue;
+      const objStart = i;
+      let braceCount = 1;
+      let inStr = false;
+      let strChar = null;
+      i++;
+      while (i < content.length && braceCount > 0) {
+        const ch = content[i];
+        const prev = i > 0 ? content[i - 1] : "";
+        if (!inStr && ch === "`") {
+          i = skipTemplateLiteral(content, i);
+          continue;
+        }
+        if (!inStr && (ch === '"' || ch === "'")) {
+          inStr = true;
+          strChar = ch;
+        } else if (inStr && ch === strChar && prev !== "\\") {
+          inStr = false;
+          strChar = null;
+        }
+        if (!inStr) {
+          if (ch === "{") braceCount++;
+          if (ch === "}") braceCount--;
+        }
+        i++;
+      }
+      if (braceCount !== 0) continue;
+      const objStr = content.substring(objStart, i);
+      while (i < content.length && /[\s,]/.test(content[i])) i++;
+      const varStart = i;
+      while (i < content.length && /\w/.test(content[i])) i++;
+      const colVarName = content.substring(varStart, i);
+      const colInfo = variables.get(colVarName);
+      if (!colInfo || colInfo.type !== "collection") continue;
+      const keyValRegex = /"(\w+Rule)"\s*:\s*([^,}\n]+)/g;
+      let kvMatch;
+      while ((kvMatch = keyValRegex.exec(objStr)) !== null) {
+        const ruleKey = kvMatch[1];
+        const valStr = kvMatch[2].trim();
+        try {
+          const value = new Function("app", `return ${valStr}`)(mockApp);
+          getUpdate(colInfo.name).rulesToUpdate[ruleKey] = value;
+        } catch {
+          getUpdate(colInfo.name).rulesToUpdate[ruleKey] = valStr;
+        }
+      }
+      const viewQueryKey = objStr.match(/"viewQuery"\s*:\s*/);
+      if (viewQueryKey) {
+        const valueStart = viewQueryKey.index + viewQueryKey[0].length;
+        if (objStr[valueStart] === "`") {
+          const end = skipTemplateLiteral(objStr, valueStart);
+          const raw = objStr.substring(valueStart + 1, end - 1);
+          getUpdate(colInfo.name).viewQuery = dedentSql(unescapeTemplateLiteral(raw));
+        } else {
+          const valStr = objStr.substring(valueStart).replace(/[,}\s]+$/, "");
+          try {
+            getUpdate(colInfo.name).viewQuery = dedentSql(new Function("app", `return ${valStr}`)(mockApp));
+          } catch {
+            getUpdate(colInfo.name).viewQuery = dedentSql(valStr);
+          }
+        }
+      }
+    }
     const idxPushRegex = /(\w+)\.indexes\.push\s*\(/g;
     let match;
     while ((match = idxPushRegex.exec(content)) !== null) {
@@ -3372,6 +3614,10 @@ function parseMigrationOperations(migrationContent) {
     while (i < migrationContent.length && braceCount > 0) {
       const char = migrationContent[i];
       const prevChar = i > 0 ? migrationContent[i - 1] : "";
+      if (!inString && char === "`") {
+        i = skipTemplateLiteral(migrationContent, i);
+        continue;
+      }
       if (!inString && (char === '"' || char === "'")) {
         inString = true;
         stringChar = char;
@@ -3707,6 +3953,9 @@ function applyMigrationOperations(snapshot, operations) {
           collection.indexes = collection.indexes.filter((idx) => !update.indexesToRemove.includes(idx));
         }
       }
+      if (update.viewQuery !== void 0) {
+        collection.viewQuery = update.viewQuery;
+      }
       if (Object.keys(update.rulesToUpdate).length > 0) {
         if (!collection.rules) collection.rules = {};
         if (!collection.permissions) collection.permissions = {};
@@ -4326,7 +4575,45 @@ function compareCollectionFields(currentCollection, previousCollection, config,
   fieldsToRemove = fieldsToRemove.filter((_, index) => !processedRemoveIndices.has(index));
   return { fieldsToAdd, fieldsToRemove, fieldsToModify };
 }
+function normalizeSql(query) {
+  if (!query) {
+    return "";
+  }
+  return query.split("\n").map((line) => line.trim()).join(" ").replace(/\s+/g, " ").trim();
+}
+function compareViewQuery(currentCollection, previousCollection) {
+  const newValue = currentCollection.viewQuery;
+  if (typeof newValue !== "string") {
+    return void 0;
+  }
+  if (normalizeSql(newValue) === normalizeSql(previousCollection.viewQuery)) {
+    return void 0;
+  }
+  return {
+    oldValue: previousCollection.viewQuery ?? null,
+    newValue
+  };
+}
 function buildCollectionModification(currentCollection, previousCollection, config, collectionIdToName) {
+  const isView = currentCollection.type === "view" || previousCollection.type === "view";
+  if (isView) {
+    return {
+      collection: currentCollection.name,
+      fieldsToAdd: [],
+      fieldsToRemove: [],
+      fieldsToModify: [],
+      indexesToAdd: [],
+      indexesToRemove: [],
+      rulesToUpdate: compareRules(
+        currentCollection.rules,
+        previousCollection.rules,
+        currentCollection.permissions,
+        previousCollection.permissions
+      ),
+      permissionsToUpdate: comparePermissions(currentCollection.permissions, previousCollection.permissions),
+      viewQueryUpdate: compareViewQuery(currentCollection, previousCollection)
+    };
+  }
   const { fieldsToAdd, fieldsToRemove, fieldsToModify } = compareCollectionFields(
     currentCollection,
     previousCollection,
@@ -4358,6 +4645,9 @@ function detectDestructiveChanges(diff, config) {
   const destructiveChanges = [];
   const mergedConfig = mergeConfig3(config);
   for (const collection of diff.collectionsToDelete) {
+    if (collection.type === "view") {
+      continue;
+    }
     destructiveChanges.push({
       type: "collection_delete",
       severity: "high",
@@ -4445,7 +4735,11 @@ function categorizeChangesBySeverity(diff, _config) {
   const destructive = [];
   const nonDestructive = [];
   for (const collection of diff.collectionsToDelete) {
-    destructive.push(`Delete collection: ${collection.name}`);
+    if (collection.type === "view") {
+      nonDestructive.push(`Delete view collection: ${collection.name}`);
+    } else {
+      destructive.push(`Delete collection: ${collection.name}`);
+    }
   }
   for (const collection of diff.collectionsToCreate) {
     nonDestructive.push(`Create collection: ${collection.name}`);
@@ -4480,6 +4774,9 @@ function categorizeChangesBySeverity(diff, _config) {
     for (const rule of modification.rulesToUpdate) {
       nonDestructive.push(`Update rule: ${collectionName}.${rule.ruleType}`);
     }
+    if (modification.viewQueryUpdate) {
+      nonDestructive.push(`Update view query: ${collectionName}`);
+    }
   }
   return { destructive, nonDestructive };
 }
@@ -4492,6 +4789,7 @@ function generateChangeSummary(diff, config) {
   let indexChanges = 0;
   let ruleChanges = 0;
   let permissionChanges = 0;
+  let viewQueryChanges = 0;
   for (const modification of diff.collectionsToModify) {
     fieldsToAdd += modification.fieldsToAdd.length;
     fieldsToRemove += modification.fieldsToRemove.length;
@@ -4499,6 +4797,9 @@ function generateChangeSummary(diff, config) {
     indexChanges += modification.indexesToAdd.length + modification.indexesToRemove.length;
     ruleChanges += modification.rulesToUpdate.length;
     permissionChanges += modification.permissionsToUpdate.length;
+    if (modification.viewQueryUpdate) {
+      viewQueryChanges += 1;
+    }
   }
   return {
     totalChanges: diff.collectionsToCreate.length + diff.collectionsToDelete.length + diff.collectionsToModify.length,
@@ -4511,6 +4812,7 @@ function generateChangeSummary(diff, config) {
     indexChanges,
     ruleChanges,
     permissionChanges,
+    viewQueryChanges,
     destructiveChanges,
     nonDestructiveChanges: nonDestructive
   };
@@ -4540,12 +4842,11 @@ function filterDiff(diff, options) {
   });
   let collectionsToDelete = diff.collectionsToDelete;
   if (skipDestructive) {
-    collectionsToDelete = [];
-  } else {
-    collectionsToDelete = collectionsToDelete.filter((col) => {
-      return matchesPattern(col.name, patterns);
-    });
+    collectionsToDelete = collectionsToDelete.filter((col) => col.type === "view");
   }
+  collectionsToDelete = collectionsToDelete.filter((col) => {
+    return matchesPattern(col.name, patterns);
+  });
   const collectionsToModify = diff.collectionsToModify.map((mod) => {
     const collectionMatches = matchesPattern(mod.collection, patterns);
     const fieldsToAdd = mod.fieldsToAdd.filter((field) => {
@@ -4570,6 +4871,7 @@ function filterDiff(diff, options) {
     const indexesToRemove = collectionMatches ? mod.indexesToRemove : [];
     const rulesToUpdate = collectionMatches ? mod.rulesToUpdate : [];
     const permissionsToUpdate = collectionMatches ? mod.permissionsToUpdate : [];
+    const viewQueryUpdate = collectionMatches ? mod.viewQueryUpdate : void 0;
     return {
       ...mod,
       fieldsToAdd,
@@ -4578,10 +4880,11 @@ function filterDiff(diff, options) {
       indexesToAdd,
       indexesToRemove,
       rulesToUpdate,
-      permissionsToUpdate
+      permissionsToUpdate,
+      viewQueryUpdate
     };
   }).filter((mod) => {
-    return mod.fieldsToAdd.length > 0 || mod.fieldsToRemove.length > 0 || mod.fieldsToModify.length > 0 || mod.indexesToAdd.length > 0 || mod.indexesToRemove.length > 0 || mod.rulesToUpdate.length > 0 || mod.permissionsToUpdate.length > 0;
+    return mod.fieldsToAdd.length > 0 || mod.fieldsToRemove.length > 0 || mod.fieldsToModify.length > 0 || mod.indexesToAdd.length > 0 || mod.indexesToRemove.length > 0 || mod.rulesToUpdate.length > 0 || mod.permissionsToUpdate.length > 0 || mod.viewQueryUpdate !== void 0;
   });
   return {
     ...diff,
@@ -4593,7 +4896,7 @@ function filterDiff(diff, options) {
 
 // src/migration/diff/index.ts
 function hasChanges(modification) {
-  return modification.fieldsToAdd.length > 0 || modification.fieldsToRemove.length > 0 || modification.fieldsToModify.length > 0 || modification.indexesToAdd.length > 0 || modification.indexesToRemove.length > 0 || modification.rulesToUpdate.length > 0 || modification.permissionsToUpdate.length > 0;
+  return modification.fieldsToAdd.length > 0 || modification.fieldsToRemove.length > 0 || modification.fieldsToModify.length > 0 || modification.indexesToAdd.length > 0 || modification.indexesToRemove.length > 0 || modification.rulesToUpdate.length > 0 || modification.permissionsToUpdate.length > 0 || modification.viewQueryUpdate !== void 0;
 }
 function aggregateChanges(currentSchema, previousSnapshot, config) {
   const collectionIdToName = /* @__PURE__ */ new Map();
@@ -4808,6 +5111,13 @@ function formatValue(value) {
   }
   return String(value);
 }
+function formatSqlTemplate(query, indent = "      ") {
+  const escaped = query.replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$\{/g, "\\${");
+  const body = escaped.split("\n").map((line) => line.trim() === "" ? "" : `${indent}${line}`).join("\n");
+  return `\`
+${body}
+${indent.slice(0, -2)}\``;
+}
 function getFieldConstructorName(fieldType) {
   const constructorMap = {
     text: "TextField",
@@ -4846,6 +5156,36 @@ function getSystemFields() {
     }
   ];
 }
+function getSystemTimestampFields() {
+  return [
+    {
+      name: "created",
+      id: "autodate2990389176",
+      type: "autodate",
+      required: false,
+      options: {
+        hidden: false,
+        onCreate: true,
+        onUpdate: false,
+        presentable: false,
+        system: true
+      }
+    },
+    {
+      name: "updated",
+      id: "autodate3332085495",
+      type: "autodate",
+      required: false,
+      options: {
+        hidden: false,
+        onCreate: true,
+        onUpdate: true,
+        presentable: false,
+        system: true
+      }
+    }
+  ];
+}
 function getAuthSystemFields() {
   return [
     {
@@ -5138,6 +5478,15 @@ function generateCollectionRules(rules, collectionType = "base") {
   if (!rules) {
     return "";
   }
+  if (collectionType === "view") {
+    return [
+      `"listRule": ${formatValue(rules.listRule ?? null)}`,
+      `"viewRule": ${formatValue(rules.viewRule ?? null)}`,
+      `"createRule": null`,
+      `"updateRule": null`,
+      `"deleteRule": null`
+    ].join(",\n    ");
+  }
   const parts = [];
   if (rules.listRule !== void 0) {
     parts.push(`"listRule": ${formatValue(rules.listRule)}`);
@@ -5163,6 +5512,15 @@ function generateCollectionPermissions(permissions, collectionType = "base") {
   if (!permissions) {
     return "";
   }
+  if (collectionType === "view") {
+    return [
+      `"listRule": ${formatValue(permissions.listRule ?? null)}`,
+      `"viewRule": ${formatValue(permissions.viewRule ?? null)}`,
+      `"createRule": null`,
+      `"updateRule": null`,
+      `"deleteRule": null`
+    ].join(",\n    ");
+  }
   const parts = [];
   if (permissions.listRule !== void 0) {
     parts.push(`"listRule": ${formatValue(permissions.listRule)}`);
@@ -5200,6 +5558,28 @@ function generatePermissionUpdate(collectionName, ruleType, newValue, varName, i
   lines.push(isLast ? `  return app.save(${collectionVar});` : `  app.save(${collectionVar});`);
   return lines.join("\n");
 }
+function generateViewQueryUpdate(collectionName, viewQuery, varName, isLast = false, collectionIdMap) {
+  const lines = [];
+  const collectionVar = varName || `collection_${collectionName}_viewQuery`;
+  lines.push(`  const ${collectionVar} = ${generateFindCollectionCode(collectionName, collectionIdMap)};`);
+  lines.push(`  unmarshal({`);
+  lines.push(`    "viewQuery": ${formatSqlTemplate(viewQuery, "      ")},`);
+  lines.push(`  }, ${collectionVar})`);
+  lines.push(isLast ? `  return app.save(${collectionVar});` : `  app.save(${collectionVar});`);
+  return lines.join("\n");
+}
+function generateGroupedRuleUpdates(collectionName, entries, varSuffix, isLast = false, collectionIdMap) {
+  const collectionVar = `collection_${collectionName}_${varSuffix}`;
+  const lines = [];
+  lines.push(`  const ${collectionVar} = ${generateFindCollectionCode(collectionName, collectionIdMap)};`);
+  lines.push(`  unmarshal({`);
+  for (const entry of entries) {
+    lines.push(`    "${entry.ruleType}": ${formatValue(entry.value)},`);
+  }
+  lines.push(`  }, ${collectionVar})`);
+  lines.push(isLast ? `  return app.save(${collectionVar});` : `  app.save(${collectionVar});`);
+  return lines.join("\n");
+}
 
 // src/migration/generator/collections.ts
 function generateCollectionCreation(collection, varName = "collection", isLast = false, collectionIdMap) {
@@ -5218,16 +5598,24 @@ function generateCollectionCreation(collection, varName = "collection", isLast =
   } else if (rulesCode) {
     lines.push(`    ${rulesCode},`);
   }
+  if (collection.type === "view") {
+    lines.push(`    "viewQuery": ${formatSqlTemplate(collection.viewQuery ?? "")},`);
+    lines.push(`  });`);
+    lines.push(``);
+    lines.push(isLast ? `  return app.save(${varName});` : `  app.save(${varName});`);
+    return lines.join("\n");
+  }
   const systemFieldNames = ["created", "updated", "id"];
   if (collection.type === "auth") {
     systemFieldNames.push(...getAuthSystemFields().map((f) => f.name));
   }
   const userFields = collection.fields.filter((f) => !systemFieldNames.includes(f.name));
-  const allFields = [...getSystemFields().filter((f) => f.name === "id")];
+  const allFields = [...getSystemFields()];
   if (collection.type === "auth") {
     allFields.push(...getAuthSystemFields());
   }
   allFields.push(...userFields);
+  allFields.push(...getSystemTimestampFields());
   lines.push(`    "fields": ${generateFieldsArray(allFields, collectionIdMap)},`);
   let allIndexes = [...collection.indexes || []];
   if (collection.type === "auth") {
@@ -5257,7 +5645,21 @@ function generateOperationUpMigration(operation, collectionIdMap) {
     const modification = operation.modifications;
     const collectionName = typeof operation.collection === "string" ? operation.collection : operation.collection?.name ?? modification.collection;
     let operationCount = 0;
-    const totalOperations = modification.fieldsToAdd.length + modification.fieldsToModify.length + modification.fieldsToRemove.length + modification.indexesToAdd.length + modification.indexesToRemove.length + modification.rulesToUpdate.length + modification.permissionsToUpdate.length;
+    const totalOperations = modification.fieldsToAdd.length + modification.fieldsToModify.length + modification.fieldsToRemove.length + modification.indexesToAdd.length + modification.indexesToRemove.length + (modification.viewQueryUpdate ? 1 : 0) + (modification.permissionsToUpdate.length > 0 ? 1 : modification.rulesToUpdate.length > 0 ? 1 : 0);
+    if (modification.viewQueryUpdate) {
+      operationCount++;
+      const isLast = operationCount === totalOperations;
+      lines.push(
+        generateViewQueryUpdate(
+          collectionName,
+          modification.viewQueryUpdate.newValue,
+          void 0,
+          isLast,
+          collectionIdMap
+        )
+      );
+      if (!isLast) lines.push("");
+    }
     for (let i = 0; i < modification.fieldsToAdd.length; i++) {
       const field = modification.fieldsToAdd[i];
       operationCount++;
@@ -5297,23 +5699,29 @@ function generateOperationUpMigration(operation, collectionIdMap) {
       if (!isLast) lines.push("");
     }
     if (modification.permissionsToUpdate && modification.permissionsToUpdate.length > 0) {
-      for (const permission of modification.permissionsToUpdate) {
-        operationCount++;
+      operationCount++;
+      const isLast = operationCount === totalOperations;
+      if (modification.permissionsToUpdate.length >= 2) {
+        const entries = modification.permissionsToUpdate.map((p) => ({ ruleType: p.ruleType, value: p.newValue }));
+        lines.push(generateGroupedRuleUpdates(collectionName, entries, "rules", isLast, collectionIdMap));
+      } else {
+        const permission = modification.permissionsToUpdate[0];
         const varName = `collection_${collectionName}_perm_${permission.ruleType}`;
-        const isLast = operationCount === totalOperations;
-        lines.push(
-          generatePermissionUpdate(collectionName, permission.ruleType, permission.newValue, varName, isLast, collectionIdMap)
-        );
-        if (!isLast) lines.push("");
+        lines.push(generatePermissionUpdate(collectionName, permission.ruleType, permission.newValue, varName, isLast, collectionIdMap));
       }
+      if (!isLast) lines.push("");
     } else if (modification.rulesToUpdate.length > 0) {
-      for (const rule of modification.rulesToUpdate) {
-        operationCount++;
+      operationCount++;
+      const isLast = operationCount === totalOperations;
+      if (modification.rulesToUpdate.length >= 2) {
+        const entries = modification.rulesToUpdate.map((r) => ({ ruleType: r.ruleType, value: r.newValue }));
+        lines.push(generateGroupedRuleUpdates(collectionName, entries, "rules", isLast, collectionIdMap));
+      } else {
+        const rule = modification.rulesToUpdate[0];
         const varName = `collection_${collectionName}_rule_${rule.ruleType}`;
-        const isLast = operationCount === totalOperations;
         lines.push(generateRuleUpdate(collectionName, rule.ruleType, rule.newValue, varName, isLast, collectionIdMap));
-        if (!isLast) lines.push("");
       }
+      if (!isLast) lines.push("");
     }
   } else if (operation.type === "delete") {
     const collectionName = typeof operation.collection === "string" ? operation.collection : operation.collection.name;
@@ -5352,25 +5760,45 @@ function generateOperationDownMigration(operation, collectionIdMap) {
     const modification = operation.modifications;
     const collectionName = typeof operation.collection === "string" ? operation.collection : operation.collection?.name ?? modification.collection;
     let operationCount = 0;
-    const totalOperations = modification.fieldsToAdd.length + modification.fieldsToModify.length + modification.fieldsToRemove.length + modification.indexesToAdd.length + modification.indexesToRemove.length + modification.rulesToUpdate.length + modification.permissionsToUpdate.length;
+    const totalOperations = modification.fieldsToAdd.length + modification.fieldsToModify.length + modification.fieldsToRemove.length + modification.indexesToAdd.length + modification.indexesToRemove.length + (modification.viewQueryUpdate ? 1 : 0) + (modification.permissionsToUpdate.length > 0 ? 1 : modification.rulesToUpdate.length > 0 ? 1 : 0);
+    if (modification.viewQueryUpdate) {
+      operationCount++;
+      const isLast = operationCount === totalOperations;
+      lines.push(
+        generateViewQueryUpdate(
+          collectionName,
+          modification.viewQueryUpdate.oldValue ?? "",
+          `collection_${collectionName}_revert_viewQuery`,
+          isLast,
+          collectionIdMap
+        )
+      );
+      if (!isLast) lines.push("");
+    }
     if (modification.permissionsToUpdate && modification.permissionsToUpdate.length > 0) {
-      for (const permission of modification.permissionsToUpdate) {
-        operationCount++;
+      operationCount++;
+      const isLast = operationCount === totalOperations;
+      if (modification.permissionsToUpdate.length >= 2) {
+        const entries = modification.permissionsToUpdate.map((p) => ({ ruleType: p.ruleType, value: p.oldValue }));
+        lines.push(generateGroupedRuleUpdates(collectionName, entries, "revert_rules", isLast, collectionIdMap));
+      } else {
+        const permission = modification.permissionsToUpdate[0];
         const varName = `collection_${collectionName}_revert_perm_${permission.ruleType}`;
-        const isLast = operationCount === totalOperations;
-        lines.push(
-          generatePermissionUpdate(collectionName, permission.ruleType, permission.oldValue, varName, isLast, collectionIdMap)
-        );
-        if (!isLast) lines.push("");
+        lines.push(generatePermissionUpdate(collectionName, permission.ruleType, permission.oldValue, varName, isLast, collectionIdMap));
       }
+      if (!isLast) lines.push("");
     } else if (modification.rulesToUpdate.length > 0) {
-      for (const rule of modification.rulesToUpdate) {
-        operationCount++;
+      operationCount++;
+      const isLast = operationCount === totalOperations;
+      if (modification.rulesToUpdate.length >= 2) {
+        const entries = modification.rulesToUpdate.map((r) => ({ ruleType: r.ruleType, value: r.oldValue }));
+        lines.push(generateGroupedRuleUpdates(collectionName, entries, "revert_rules", isLast, collectionIdMap));
+      } else {
+        const rule = modification.rulesToUpdate[0];
         const varName = `collection_${collectionName}_revert_rule_${rule.ruleType}`;
-        const isLast = operationCount === totalOperations;
         lines.push(generateRuleUpdate(collectionName, rule.ruleType, rule.oldValue, varName, isLast, collectionIdMap));
-        if (!isLast) lines.push("");
       }
+      if (!isLast) lines.push("");
     }
     for (let i = 0; i < modification.indexesToRemove.length; i++) {
       operationCount++;
@@ -5477,6 +5905,19 @@ function generateUpMigration(diff) {
     lines.push(`  // Modify existing collections`);
     for (const modification of diff.collectionsToModify) {
       const collectionName = modification.collection;
+      if (modification.viewQueryUpdate) {
+        lines.push(`  // Update the view query of ${collectionName}`);
+        lines.push(
+          generateViewQueryUpdate(
+            collectionName,
+            modification.viewQueryUpdate.newValue,
+            void 0,
+            false,
+            collectionIdMap
+          )
+        );
+        lines.push(``);
+      }
       if (modification.fieldsToAdd.length > 0) {
         lines.push(`  // Add fields to ${collectionName}`);
         for (let i = 0; i < modification.fieldsToAdd.length; i++) {
@@ -5522,20 +5963,26 @@ function generateUpMigration(diff) {
       }
       if (modification.permissionsToUpdate && modification.permissionsToUpdate.length > 0) {
         lines.push(`  // Update permissions for ${collectionName}`);
-        for (const permission of modification.permissionsToUpdate) {
+        if (modification.permissionsToUpdate.length >= 2) {
+          const entries = modification.permissionsToUpdate.map((p) => ({ ruleType: p.ruleType, value: p.newValue }));
+          lines.push(generateGroupedRuleUpdates(collectionName, entries, "rules", false, collectionIdMap));
+        } else {
+          const permission = modification.permissionsToUpdate[0];
           const varName = `collection_${collectionName}_perm_${permission.ruleType}`;
-          lines.push(
-            generatePermissionUpdate(collectionName, permission.ruleType, permission.newValue, varName, false, collectionIdMap)
-          );
-          lines.push(``);
+          lines.push(generatePermissionUpdate(collectionName, permission.ruleType, permission.newValue, varName, false, collectionIdMap));
         }
+        lines.push(``);
       } else if (modification.rulesToUpdate.length > 0) {
         lines.push(`  // Update rules for ${collectionName}`);
-        for (const rule of modification.rulesToUpdate) {
+        if (modification.rulesToUpdate.length >= 2) {
+          const entries = modification.rulesToUpdate.map((r) => ({ ruleType: r.ruleType, value: r.newValue }));
+          lines.push(generateGroupedRuleUpdates(collectionName, entries, "rules", false, collectionIdMap));
+        } else {
+          const rule = modification.rulesToUpdate[0];
           const varName = `collection_${collectionName}_rule_${rule.ruleType}`;
           lines.push(generateRuleUpdate(collectionName, rule.ruleType, rule.newValue, varName, false, collectionIdMap));
-          lines.push(``);
         }
+        lines.push(``);
       }
     }
   }
@@ -5607,22 +6054,41 @@ function generateDownMigration(diff) {
     lines.push(`  // Revert modifications`);
     for (const modification of diff.collectionsToModify) {
       const collectionName = modification.collection;
+      if (modification.viewQueryUpdate) {
+        lines.push(`  // Restore the view query of ${collectionName}`);
+        lines.push(
+          generateViewQueryUpdate(
+            collectionName,
+            modification.viewQueryUpdate.oldValue ?? "",
+            `collection_${collectionName}_revert_viewQuery`,
+            false,
+            collectionIdMap
+          )
+        );
+        lines.push(``);
+      }
       if (modification.permissionsToUpdate && modification.permissionsToUpdate.length > 0) {
         lines.push(`  // Revert permissions for ${collectionName}`);
-        for (const permission of modification.permissionsToUpdate) {
+        if (modification.permissionsToUpdate.length >= 2) {
+          const entries = modification.permissionsToUpdate.map((p) => ({ ruleType: p.ruleType, value: p.oldValue }));
+          lines.push(generateGroupedRuleUpdates(collectionName, entries, "revert_rules", false, collectionIdMap));
+        } else {
+          const permission = modification.permissionsToUpdate[0];
           const varName = `collection_${collectionName}_revert_perm_${permission.ruleType}`;
-          lines.push(
-            generatePermissionUpdate(collectionName, permission.ruleType, permission.oldValue, varName, false, collectionIdMap)
-          );
-          lines.push(``);
+          lines.push(generatePermissionUpdate(collectionName, permission.ruleType, permission.oldValue, varName, false, collectionIdMap));
         }
+        lines.push(``);
       } else if (modification.rulesToUpdate.length > 0) {
         lines.push(`  // Revert rules for ${collectionName}`);
-        for (const rule of modification.rulesToUpdate) {
+        if (modification.rulesToUpdate.length >= 2) {
+          const entries = modification.rulesToUpdate.map((r) => ({ ruleType: r.ruleType, value: r.oldValue }));
+          lines.push(generateGroupedRuleUpdates(collectionName, entries, "revert_rules", false, collectionIdMap));
+        } else {
+          const rule = modification.rulesToUpdate[0];
           const varName = `collection_${collectionName}_revert_rule_${rule.ruleType}`;
           lines.push(generateRuleUpdate(collectionName, rule.ruleType, rule.oldValue, varName, false, collectionIdMap));
-          lines.push(``);
         }
+        lines.push(``);
       }
       if (modification.indexesToRemove.length > 0) {
         lines.push(`  // Restore indexes to ${collectionName}`);
@@ -5952,6 +6418,9 @@ var MigrationGenerator = class {
 function detectCollectionDeletions(diff) {
   const changes = [];
   for (const collection of diff.collectionsToDelete) {
+    if (collection.type === "view") {
+      continue;
+    }
     changes.push({
       type: "collection_deletion" /* COLLECTION_DELETION */,
       description: `Delete collection: ${collection.name}`,
@@ -6366,7 +6835,11 @@ function formatChangeSummary(diff) {
     lines.push(chalk__default.default.green.bold(`\u2713 ${totalCollectionsToCreate} collection(s) to create:`));
     for (const collection of diff.collectionsToCreate) {
       lines.push(chalk__default.default.green(`  + ${collection.name} (${collection.type})`));
-      lines.push(chalk__default.default.gray(`    ${collection.fields.length} field(s)`));
+      if (collection.type === "view") {
+        lines.push(chalk__default.default.gray(`    fields derived from the view query`));
+      } else {
+        lines.push(chalk__default.default.gray(`    ${collection.fields.length} field(s)`));
+      }
     }
     lines.push("");
   }
@@ -6411,6 +6884,9 @@ function formatChangeSummary(diff) {
       if (modification.rulesToUpdate.length > 0) {
         lines.push(chalk__default.default.yellow(`    ~ ${modification.rulesToUpdate.length} rule(s) to update`));
       }
+      if (modification.viewQueryUpdate) {
+        lines.push(chalk__default.default.yellow(`    ~ view query to update`));
+      }
       lines.push("");
     }
   }
@@ -6884,7 +7360,9 @@ exports.convertPocketBaseMigration = convertPocketBaseMigration;
 exports.convertZodSchemaToCollectionSchema = convertZodSchemaToCollectionSchema;
 exports.createMigrationFileStructure = createMigrationFileStructure;
 exports.createPermissions = createPermissions;
+exports.dedentSql = dedentSql;
 exports.defineCollection = defineCollection;
+exports.defineView = defineView;
 exports.detectDestructiveChanges = detectDestructiveChanges;
 exports.detectDestructiveChangesValidation = detectDestructiveChanges2;
 exports.detectFieldChanges = detectFieldChanges;
@@ -6979,12 +7457,14 @@ exports.saveSnapshot = saveSnapshot;
 exports.selectSchemaForCollection = selectSchemaForCollection;
 exports.singularize = singularize;
 exports.snapshotExists = snapshotExists;
+exports.sql = sql;
 exports.summarizeDestructiveChanges = summarizeDestructiveChanges;
 exports.toCollectionName = toCollectionName;
 exports.unwrapZodType = unwrapZodType;
 exports.validatePermissionConfig = validatePermissionConfig;
 exports.validateRuleExpression = validateRuleExpression;
 exports.validateSnapshot = validateSnapshot;
+exports.validateViewQuery = validateViewQuery;
 exports.withIndexes = withIndexes;
 exports.withPermissions = withPermissions;
 exports.withProgress = withProgress;