@lumerahq/cli 0.35.2 → 0.36.0-dev.0

package/dist/{chunk-5TQ3BQ2X.js → chunk-DXHA72QY.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-2EHJH2QU.js";
 import {
   userContextHeaders
-} from "./chunk-2A2DSLIE.js";
+} from "./chunk-RV7WQAK3.js";
 import {
   fetchWithRetry
 } from "./chunk-FJFIWC7G.js";

package/dist/{chunk-A27HZEU6.js → chunk-MFAEFPHY.js}

@@ -4,7 +4,7 @@ import {
 import {
   createApiClient,
   isApiErrorStatus
-} from "./chunk-2A2DSLIE.js";
+} from "./chunk-RV7WQAK3.js";
 import {
   findProjectRoot,
   getAppName

package/dist/{chunk-2A2DSLIE.js → chunk-RV7WQAK3.js}

@@ -171,6 +171,13 @@ var ApiClient = class {
   async getCollection(id) {
     return this.request(`/api/pb/collections/${id}`);
   }
+  /** Runs a read-only SQL query in the project's scope. */
+  async querySql(sql) {
+    return this.request("/api/pb/sql", {
+      method: "POST",
+      body: JSON.stringify({ sql })
+    });
+  }
   async ensureCollection(name, def) {
     return this.request(`/api/pb/collections/${name}`, {
       method: "PUT",

package/dist/{deps-DLJUDFNK.js → deps-OUTYSIZU.js}

@@ -2,9 +2,9 @@ import {
   deps,
   syncDeps,
   syncResourceShareDeps
-} from "./chunk-A27HZEU6.js";
+} from "./chunk-MFAEFPHY.js";
 import "./chunk-2CR762KB.js";
-import "./chunk-2A2DSLIE.js";
+import "./chunk-RV7WQAK3.js";
 import "./chunk-JLVVHTBY.js";
 import "./chunk-FJFIWC7G.js";
 import "./chunk-PNKVD2UK.js";

package/dist/{dev-E2O6R7WW.js → dev-NEHWUIWB.js}

@@ -1,19 +1,19 @@
 import {
   dev
-} from "./chunk-5TQ3BQ2X.js";
+} from "./chunk-DXHA72QY.js";
 import "./chunk-UGAIWMQV.js";
 import "./chunk-2EHJH2QU.js";
 import "./chunk-XZ5VCTGY.js";
 import "./chunk-5FGDEZSJ.js";
 import {
   syncDeps
-} from "./chunk-A27HZEU6.js";
+} from "./chunk-MFAEFPHY.js";
 import {
   loadEnv
 } from "./chunk-2CR762KB.js";
 import {
   createApiClient
-} from "./chunk-2A2DSLIE.js";
+} from "./chunk-RV7WQAK3.js";
 import {
   findProjectRoot,
   getApiUrl,

package/dist/index.js

@@ -243,32 +243,32 @@ async function main() {
     switch (command) {
       // Resource commands
       case "plan":
-        await import("./resources-E32DYKLL.js").then((m) => m.plan(args.slice(1)));
+        await import("./resources-IW5JT7A3.js").then((m) => m.plan(args.slice(1)));
         break;
       case "apply":
-        await import("./resources-E32DYKLL.js").then((m) => m.apply(args.slice(1)));
+        await import("./resources-IW5JT7A3.js").then((m) => m.apply(args.slice(1)));
         break;
       case "pull":
-        await import("./resources-E32DYKLL.js").then((m) => m.pull(args.slice(1)));
+        await import("./resources-IW5JT7A3.js").then((m) => m.pull(args.slice(1)));
         break;
       case "destroy":
-        await import("./resources-E32DYKLL.js").then((m) => m.destroy(args.slice(1)));
+        await import("./resources-IW5JT7A3.js").then((m) => m.destroy(args.slice(1)));
         break;
       case "list":
-        await import("./resources-E32DYKLL.js").then((m) => m.list(args.slice(1)));
+        await import("./resources-IW5JT7A3.js").then((m) => m.list(args.slice(1)));
         break;
       case "show":
-        await import("./resources-E32DYKLL.js").then((m) => m.show(args.slice(1)));
+        await import("./resources-IW5JT7A3.js").then((m) => m.show(args.slice(1)));
         break;
       case "diff":
-        await import("./resources-E32DYKLL.js").then((m) => m.diff(args.slice(1)));
+        await import("./resources-IW5JT7A3.js").then((m) => m.diff(args.slice(1)));
         break;
       // Development
       case "dev":
-        await import("./dev-E2O6R7WW.js").then((m) => m.dev(args.slice(1)));
+        await import("./dev-NEHWUIWB.js").then((m) => m.dev(args.slice(1)));
         break;
       case "run":
-        await import("./run-BJ7PXSEH.js").then((m) => m.run(args.slice(1)));
+        await import("./run-TMJPC4PK.js").then((m) => m.run(args.slice(1)));
         break;
       case "functions":
         await import("./functions-5OOHGQT7.js").then(
@@ -282,10 +282,10 @@ async function main() {
         break;
       // Project
       case "init":
-        await import("./init-MJEVA5HK.js").then((m) => m.init(args.slice(1)));
+        await import("./init-LZAXKILN.js").then((m) => m.init(args.slice(1)));
         break;
       case "register":
-        await import("./register-RUDM4ITV.js").then((m) => m.register(args.slice(1)));
+        await import("./register-MOO266NL.js").then((m) => m.register(args.slice(1)));
         break;
       case "templates":
         await import("./templates-LNUOTNLN.js").then((m) => m.templates(subcommand, args.slice(2)));
@@ -302,7 +302,7 @@ async function main() {
         break;
       // Dependencies
       case "deps":
-        await import("./deps-DLJUDFNK.js").then((m) => m.deps(args.slice(1)));
+        await import("./deps-OUTYSIZU.js").then((m) => m.deps(args.slice(1)));
         break;
       // Feature flags (read the in-sandbox snapshot)
       case "flags":

package/dist/{init-MJEVA5HK.js → init-LZAXKILN.js}

@@ -12,7 +12,7 @@ import {
 import {
   createApiClient,
   validateProjectNameLength
-} from "./chunk-2A2DSLIE.js";
+} from "./chunk-RV7WQAK3.js";
 import {
   getToken,
   init_auth,

package/dist/{register-RUDM4ITV.js → register-MOO266NL.js}

@@ -7,7 +7,7 @@ import {
 import {
   createApiClient,
   validateProjectExternalId
-} from "./chunk-2A2DSLIE.js";
+} from "./chunk-RV7WQAK3.js";
 import {
   findProjectRoot,
   getAppName,

package/dist/{resources-E32DYKLL.js → resources-IW5JT7A3.js}

@@ -1,14 +1,14 @@
 import {
   deploy,
   deployAppAPI
-} from "./chunk-5TQ3BQ2X.js";
+} from "./chunk-DXHA72QY.js";
 import "./chunk-UGAIWMQV.js";
 import "./chunk-2EHJH2QU.js";
 import "./chunk-XZ5VCTGY.js";
 import "./chunk-5FGDEZSJ.js";
 import {
   syncDeps
-} from "./chunk-A27HZEU6.js";
+} from "./chunk-MFAEFPHY.js";
 import {
   loadEnv
 } from "./chunk-2CR762KB.js";
@@ -17,7 +17,7 @@ import {
   createApiClient,
   isApiErrorStatus,
   validateCollectionNameLength
-} from "./chunk-2A2DSLIE.js";
+} from "./chunk-RV7WQAK3.js";
 import {
   findProjectRoot,
   getApiUrl,
@@ -474,16 +474,18 @@ var collectionSchemaRule = {
         if (typeof field.type !== "string" || field.type.trim() === "") {
           issues.push(error(target, `Field ${typeof field.name === "string" ? `"${field.name}"` : `at index ${i}`} is missing required string field "type".`));
         }
-        if (field.type === "lumera_file" || field.type === "file") {
+        const legacyFile = field.type === "lumera_file" || field.type === "file";
+        if (legacyFile || field.type === "lumera_file_v2" || field.type === "file_v2") {
           const label = typeof field.name === "string" ? `"${field.name}"` : `at index ${i}`;
           const ignored = [
             ...isRecord3(field.options) && field.options.maxSelect !== void 0 ? ['"options.maxSelect"'] : [],
             ...field.multiple !== void 0 ? ['"multiple"'] : []
           ];
           if (ignored.length > 0) {
+            const fixed = legacyFile ? " A lumera_file field's maxSelect cannot change after it is first deployed; use lumera_file_v2 if it needs to." : "";
             issues.push(warning(
               target,
-              `File field ${label} sets ${ignored.join(" and ")}, which collection files ignore; it deploys with maxSelect ${field.maxSelect ?? 1}. Set top-level "maxSelect" instead. A file field's maxSelect cannot change after it is first deployed.`
+              `File field ${label} sets ${ignored.join(" and ")}, which collection files ignore; it deploys with maxSelect ${field.maxSelect ?? 1}. Set top-level "maxSelect" instead.${fixed}`
             ));
           }
         }
@@ -1373,6 +1375,7 @@ var FIELD_OPTION_KEYS_BY_TYPE = {
   relation: ["cascadeDelete", "minSelect", "maxSelect"],
   json: ["maxSize"],
   lumera_file: ["maxSelect", "maxSize", "mimeTypes", "protected"],
+  lumera_file_v2: ["maxSelect", "maxSize", "mimeTypes", "protected"],
   editor: ["maxSize", "convertURLs"],
   date: ["min", "max"],
   select: ["values", "maxSelect"],
@@ -1384,6 +1387,7 @@ var FIELD_OPTION_DEFAULTS = {
   relation: { cascadeDelete: false, minSelect: 0, maxSelect: 1 },
   json: { maxSize: 0 },
   lumera_file: { maxSelect: 1, maxSize: 0, mimeTypes: [], protected: false },
+  lumera_file_v2: { maxSelect: 1, maxSize: 0, mimeTypes: [], protected: false },
   editor: { maxSize: 0, convertURLs: false },
   date: { min: "", max: "" },
   select: { values: [], maxSelect: 1 },
@@ -2098,6 +2102,7 @@ function mapFieldType(type) {
     select: "select",
     relation: "relation",
     file: "lumera_file",
+    file_v2: "lumera_file_v2",
     json: "json",
     editor: "editor",
     currency: "currency"
@@ -2145,10 +2150,76 @@ function lumeraFileMaxSelectErrors(local, remote) {
     const requestedMaxSelect = Math.max(Number(normalizeFieldOption("lumera_file", "maxSelect", field.maxSelect)), 1);
     if (deployedMaxSelect === requestedMaxSelect) continue;
     const requested = field.maxSelect === void 0 ? "omitting maxSelect (defaults to 1)" : `maxSelect ${requestedMaxSelect}`;
-    errors.push(`File field "${field.name}" is deployed with maxSelect ${deployedMaxSelect}; ${requested} would change it, which is not supported. Keep maxSelect ${deployedMaxSelect}.`);
+    errors.push(`File field "${field.name}" is deployed with maxSelect ${deployedMaxSelect}; ${requested} would change it, which is not supported. Keep maxSelect ${deployedMaxSelect}. To change the limit, move the field to lumera_file_v2.`);
   }
   return errors;
 }
+function fieldTypeChangeErrors(local, remote) {
+  const remoteFields = new Map(remote.schema.map((f) => [f.name, f]));
+  const errors = [];
+  for (const field of local.fields) {
+    const deployed = remoteFields.get(field.name);
+    const requestedType = mapFieldType(field.type);
+    if (!deployed || deployed.type === requestedType) continue;
+    errors.push(`Field "${field.name}" is deployed as ${deployed.type}; changing it to ${requestedType} would drop its data, which is not supported. Add a field with a new name instead.`);
+  }
+  return errors;
+}
+function legacyFileFieldWarnings(fields) {
+  return fields.filter((field) => mapFieldType(field.type) === "lumera_file").map((field) => `File field "${field.name}" uses lumera_file; use lumera_file_v2 for new file fields so maxSelect can change later.`);
+}
+function quoteSqlIdentifier(name) {
+  return `"${name.replaceAll('"', '""')}"`;
+}
+async function countRecords(api, sql) {
+  try {
+    const total = Number((await api.querySql(sql)).rows?.[0]?.total);
+    return Number.isFinite(total) ? total : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function readOnlyRecords(count, condition, fix) {
+  if (count === void 0) return `Records ${condition} become read-only until ${fix}.`;
+  return `${count} record${count === 1 ? "" : "s"} ${condition} ${count === 1 ? "becomes" : "become"} read-only until ${fix}.`;
+}
+async function lumeraFileV2TighteningWarnings(api, local, remote) {
+  const remoteFields = new Map(remote.schema.map((f) => [f.name, f]));
+  const warnings = [];
+  for (const field of local.fields) {
+    const deployed = remoteFields.get(field.name);
+    if (mapFieldType(field.type) !== "lumera_file_v2" || deployed?.type !== "lumera_file_v2") continue;
+    const option = (key, value) => normalizeFieldOption("lumera_file_v2", key, value);
+    const label = `${local.name}.${field.name}`;
+    const from = `FROM ${quoteSqlIdentifier(remote.name)} WHERE`;
+    const column = quoteSqlIdentifier(field.name);
+    const deployedMaxSelect = Math.max(Number(option("maxSelect", deployed.options?.maxSelect)), 1);
+    const requestedMaxSelect = Math.max(Number(option("maxSelect", field.maxSelect)), 1);
+    if (requestedMaxSelect < deployedMaxSelect) {
+      const count = await countRecords(api, `SELECT count(*) AS total ${from} jsonb_array_length(${column}) > ${requestedMaxSelect}`);
+      if (count !== 0) {
+        warnings.push(`${label}: maxSelect ${deployedMaxSelect} \u2192 ${requestedMaxSelect}. ${readOnlyRecords(count, `with more than ${requestedMaxSelect} file${requestedMaxSelect === 1 ? "" : "s"}`, "trimmed or deleted")}`);
+      }
+    }
+    if (field.required && !deployed.required) {
+      const count = await countRecords(api, `SELECT count(*) AS total ${from} jsonb_array_length(${column}) = 0`);
+      if (count !== 0) {
+        warnings.push(`${label}: now required. ${readOnlyRecords(count, "with no files", "a file is added or they are deleted")}`);
+      }
+    }
+    const deployedMaxSize = Number(option("maxSize", deployed.options?.maxSize));
+    const requestedMaxSize = Number(option("maxSize", field.maxSize));
+    if (requestedMaxSize > 0 && (deployedMaxSize === 0 || requestedMaxSize < deployedMaxSize)) {
+      warnings.push(`${label}: maxSize lowered to ${requestedMaxSize} bytes. ${readOnlyRecords(void 0, "with larger files", "fixed or deleted")}`);
+    }
+    const deployedTypes = option("mimeTypes", deployed.options?.mimeTypes);
+    const requestedTypes = option("mimeTypes", field.mimeTypes);
+    if (requestedTypes.length > 0 && (deployedTypes.length === 0 || deployedTypes.some((type) => !requestedTypes.includes(type)))) {
+      warnings.push(`${label}: mimeTypes narrowed. ${readOnlyRecords(void 0, "with other file types", "fixed or deleted")}`);
+    }
+  }
+  return warnings;
+}
 function localIndexesToSql(local, appName) {
   if (!local.indexes || local.indexes.length === 0) return [];
   return local.indexes.map((idx) => buildIndexSql(local, idx, appName)).sort();
@@ -2209,6 +2280,7 @@ async function planCollections(api, localCollections, appName, projectId) {
       }
     }
     if (!remote) {
+      const createWarnings = legacyFileFieldWarnings(local.fields);
       changes.push({
         type: "create",
         resource: "collection",
@@ -2223,7 +2295,8 @@ async function planCollections(api, localCollections, appName, projectId) {
           name: f.name,
           type: f.type,
           required: f.required
-        }))
+        })),
+        ...createWarnings.length > 0 ? { warnings: createWarnings } : {}
       });
     } else {
       const localFieldNames = new Set(local.fields.map((f) => f.name));
@@ -2262,7 +2335,11 @@ async function planCollections(api, localCollections, appName, projectId) {
           const f = remoteFieldMap.get(name);
           fieldDetails.push({ action: "-", name: f.name, type: f.type, required: f.required });
         }
-        const errors = lumeraFileMaxSelectErrors(local, remote);
+        const errors = [...fieldTypeChangeErrors(local, remote), ...lumeraFileMaxSelectErrors(local, remote)];
+        const warnings = [
+          ...legacyFileFieldWarnings(added.map((name) => localFieldMap.get(name))),
+          ...await lumeraFileV2TighteningWarnings(api, local, remote)
+        ];
         changes.push({
           type: "update",
           resource: "collection",
@@ -2270,7 +2347,8 @@ async function planCollections(api, localCollections, appName, projectId) {
           name: local.name,
           details: details.join(", "),
           fieldDetails,
-          ...errors.length > 0 ? { errors } : {}
+          ...errors.length > 0 ? { errors } : {},
+          ...warnings.length > 0 ? { warnings } : {}
         });
       }
     }
@@ -4570,6 +4648,7 @@ async function plan(args) {
           warnings.push(`Collection "${change.name}" will have ${removals.length} field(s) removed.`);
         }
       }
+      warnings.push(...change.warnings ?? []);
     }
     const validationErrors = planValidationErrors + collectionErrorCount;
     console.log(JSON.stringify({ changes: allChanges, warnings, validationErrors, lintWarnings: serializeLintWarnings(lintWarnings, projectRoot) }));
@@ -4595,6 +4674,10 @@ async function plan(args) {
       for (const message of change.errors) console.log(pc2.red(`      \u2717 ${message}`));
       console.log();
     }
+    if (change.warnings && change.warnings.length > 0) {
+      for (const message of change.warnings) console.log(pc2.yellow(`      \u26A0 ${message}`));
+      console.log();
+    }
     if (change.textDiffs && change.textDiffs.length > 0) {
       const maxDiffLines = 20;
       for (const td of change.textDiffs) {
@@ -4769,6 +4852,7 @@ async function apply(args) {
       const color = change.type === "create" ? pc2.green : pc2.yellow;
       const details = change.details ? ` (${change.details})` : "";
       console.log(`  ${color(icon)} ${change.resource}: ${change.name}${pc2.dim(details)}`);
+      for (const message of change.warnings ?? []) console.log(pc2.yellow(`      \u26A0 ${message}`));
     }
     if (willDeployApp) console.log(`  ${pc2.blue("\u25CF")} app: frontend build + deploy`);
     console.log();
@@ -5354,12 +5438,14 @@ export {
   convertCollectionToApiFormat,
   destroy,
   diff,
+  fieldTypeChangeErrors,
   lintAgentFiles,
   list,
   loadLocalCollections,
   loadLocalSkills,
   localProjectSkillSlug,
   lumeraFileMaxSelectErrors,
+  lumeraFileV2TighteningWarnings,
   plan,
   planAgents,
   planCollections,

package/dist/{run-BJ7PXSEH.js → run-TMJPC4PK.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-2CR762KB.js";
 import {
   createApiClient
-} from "./chunk-2A2DSLIE.js";
+} from "./chunk-RV7WQAK3.js";
 import {
   findProjectRoot,
   getApiUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumerahq/cli",
-  "version": "0.35.2",
+  "version": "0.36.0-dev.0",
   "description": "CLI for building and deploying Lumera apps",
   "type": "module",
   "engines": {