@dyrected/core 2.1.0 → 2.4.0

package/dist/index.cjs

@@ -36,7 +36,9 @@ __export(index_exports, {
   defineGlobal: () => defineGlobal,
   generateAIPrompt: () => generateAIPrompt,
   generateFreshSetupPrompt: () => generateFreshSetupPrompt,
-  normalizeConfig: () => normalizeConfig
+  normalizeConfig: () => normalizeConfig,
+  parseMongoWhere: () => parseMongoWhere,
+  parseSqlWhere: () => parseSqlWhere
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -136,7 +138,10 @@ function buildConstraintsSection() {
 - RESILIENCE         : If Dyrected backend is unreachable, fall back to
                        initialData and show stale content \u2014 never an error page.
                        All relationship fields must handle null gracefully.
-                       Every block renderer must have a default fallback case.`;
+                       Every block renderer must have a default fallback case.
+- AUTO-SEEDING        : Use initialData: [...] in CollectionConfig or GlobalConfig
+                        to automatically populate the database on first run.
+                        This is great for demo content or default settings.`;
 }
 function buildSchemaRulesSection() {
   return `
@@ -145,8 +150,10 @@ function buildSchemaRulesSection() {
 \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
 - Never drop existing fields from the schema. Mark unused fields as deprecated only.
 - All new fields must have a defaultValue.
-- Never rename a field slug \u2014 add a new field and migrate data separately.
-- For Cloud deployments, run npx @dyrected/cli sync:schema after every config change. Self-hosted deployments sync automatically on startup.`;
+- Use renameTo: 'oldName' to lazily migrate data when renaming fields.
+- Use promoted: true for fields that need high-performance SQL indexing or unique constraints.
+- For Cloud deployments, run npx @dyrected/cli sync:schema after every config change. Self-hosted deployments sync automatically on startup.
+`;
 }
 function buildDoNotSection() {
   return `
@@ -193,6 +200,8 @@ FIELD OPTIONS:
 - unique             \u2014 database-level uniqueness constraint
 - hasMany            \u2014 allow multiple values (for relationship, select, image)
 - defaultValue       \u2014 fallback value (required on all new fields added to existing schemas)
+- promoted           \u2014 extracts field to a real SQL column for native indexing (SQL adapters only)
+- renameTo           \u2014 name of the old field key to migrate data from (lazy migration)
 - admin.condition    \u2014 Jexl expression string to conditionally show/hide field
                        e.g. "status == \\"published\\""
 - admin.readOnly     \u2014 display only, not editable
@@ -291,6 +300,7 @@ const settings = defineGlobal({
 export default defineConfig({
   collections: [media, pages],
   globals:     [settings],
+  // Use SqliteAdapter for local, PostgresAdapter or MySqlAdapter for production
   db: new SqliteAdapter({ filename: './dyrected.db' }),
 })
 \`\`\``;
@@ -915,6 +925,162 @@ function normalizeConfig(config) {
   };
 }
 
+// src/utils/parse-where.ts
+function assertNever(op, context) {
+  throw new Error(`[dyrected/core] Unhandled where operator "${op}" in ${context}`);
+}
+function parseSqlWhere(where, getJsonField, placeholder = "?") {
+  const params = [];
+  let pgIndex = 1;
+  function next() {
+    return placeholder === "pg" ? `$${pgIndex++}` : "?";
+  }
+  function col(field) {
+    return field === "id" ? "id" : getJsonField(field);
+  }
+  function buildOperator(field, value) {
+    const c = col(field);
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+      params.push(value);
+      return `${c} = ${next()}`;
+    }
+    const entries = Object.entries(value);
+    if (entries.length !== 1) {
+      return entries.map(([op2, operand2]) => buildSingleOp(c, op2, operand2)).join(" AND ");
+    }
+    const [op, operand] = entries[0];
+    return buildSingleOp(c, op, operand);
+  }
+  function buildSingleOp(c, op, operand) {
+    switch (op) {
+      case "equals":
+        params.push(operand);
+        return `${c} = ${next()}`;
+      case "not_equals":
+        params.push(operand);
+        return `${c} != ${next()}`;
+      case "in": {
+        const vals = Array.isArray(operand) ? operand : [operand];
+        if (vals.length === 0) return "1=0";
+        const placeholders = vals.map((v) => {
+          params.push(v);
+          return next();
+        });
+        return `${c} IN (${placeholders.join(", ")})`;
+      }
+      case "not_in": {
+        const vals = Array.isArray(operand) ? operand : [operand];
+        if (vals.length === 0) return "1=1";
+        const placeholders = vals.map((v) => {
+          params.push(v);
+          return next();
+        });
+        return `${c} NOT IN (${placeholders.join(", ")})`;
+      }
+      case "gt":
+        params.push(operand);
+        return `${c} > ${next()}`;
+      case "gte":
+        params.push(operand);
+        return `${c} >= ${next()}`;
+      case "lt":
+        params.push(operand);
+        return `${c} < ${next()}`;
+      case "lte":
+        params.push(operand);
+        return `${c} <= ${next()}`;
+      case "contains":
+        params.push(`%${operand}%`);
+        return `${c} LIKE ${next()}`;
+      case "starts_with":
+        params.push(`${operand}%`);
+        return `${c} LIKE ${next()}`;
+      case "exists":
+        return operand ? `${c} IS NOT NULL` : `${c} IS NULL`;
+      default:
+        return assertNever(op, "parseSqlWhere");
+    }
+  }
+  function buildClause(w) {
+    const parts = [];
+    for (const [field, value] of Object.entries(w)) {
+      if (field === "OR" && Array.isArray(value)) {
+        const sub = value.map((v) => `(${buildClause(v)})`).join(" OR ");
+        parts.push(`(${sub})`);
+      } else if (field === "AND" && Array.isArray(value)) {
+        const sub = value.map((v) => `(${buildClause(v)})`).join(" AND ");
+        parts.push(`(${sub})`);
+      } else {
+        parts.push(buildOperator(field, value));
+      }
+    }
+    return parts.length ? parts.join(" AND ") : "1=1";
+  }
+  const sql = buildClause(where);
+  return { sql, params };
+}
+function parseMongoWhere(where) {
+  function buildOperator(field, value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+      return { [field]: { $eq: value } };
+    }
+    const entries = Object.entries(value);
+    if (entries.length !== 1) {
+      const merged = {};
+      for (const [op2, operand2] of entries) {
+        Object.assign(merged, buildSingleOp(field, op2, operand2)[field]);
+      }
+      return { [field]: merged };
+    }
+    const [op, operand] = entries[0];
+    return buildSingleOp(field, op, operand);
+  }
+  function buildSingleOp(field, op, operand) {
+    switch (op) {
+      case "equals":
+        return { [field]: { $eq: operand } };
+      case "not_equals":
+        return { [field]: { $ne: operand } };
+      case "in":
+        return { [field]: { $in: Array.isArray(operand) ? operand : [operand] } };
+      case "not_in":
+        return { [field]: { $nin: Array.isArray(operand) ? operand : [operand] } };
+      case "gt":
+        return { [field]: { $gt: operand } };
+      case "gte":
+        return { [field]: { $gte: operand } };
+      case "lt":
+        return { [field]: { $lt: operand } };
+      case "lte":
+        return { [field]: { $lte: operand } };
+      case "contains":
+        return { [field]: { $regex: operand, $options: "i" } };
+      case "starts_with":
+        return { [field]: { $regex: `^${operand}`, $options: "i" } };
+      case "exists":
+        return { [field]: { $exists: operand } };
+      default:
+        return assertNever(op, "parseMongoWhere");
+    }
+  }
+  function buildClause(w) {
+    const conditions = [];
+    for (const [field, value] of Object.entries(w)) {
+      if (field === "OR" && Array.isArray(value)) {
+        conditions.push({ $or: value.map(buildClause) });
+      } else if (field === "AND" && Array.isArray(value)) {
+        conditions.push({ $and: value.map(buildClause) });
+      } else {
+        conditions.push(buildOperator(field, value));
+      }
+    }
+    if (conditions.length === 0) return {};
+    if (conditions.length === 1) return conditions[0];
+    return { $and: conditions };
+  }
+  return buildClause(where);
+}
+
 // src/app.ts
 var import_hono = require("hono");
 var import_cors = require("hono/cors");
@@ -1029,7 +1195,14 @@ var DefaultsService = class {
   static apply(fields, data = {}) {
     const result = { ...data || {} };
     fields.forEach((field) => {
-      const value = result[field.name];
+      let value = result[field.name];
+      if ((value === void 0 || value === null) && field.renameTo) {
+        const legacyValue = result[field.renameTo];
+        if (legacyValue !== void 0 && legacyValue !== null) {
+          value = legacyValue;
+          result[field.name] = legacyValue;
+        }
+      }
       if (value === void 0 || value === null) {
         if (field.defaultValue !== void 0) {
           result[field.name] = field.defaultValue;
@@ -1108,6 +1281,19 @@ var CollectionController = class {
       sort,
       where
     });
+    if (result.total === 0 && this.collection.initialData && !where && page === 1) {
+      console.log(`[dyrected/core] Auto-seeding collection "${this.collection.slug}" from config.initialData`);
+      for (const data of this.collection.initialData) {
+        await db.create({ collection: this.collection.slug, data });
+      }
+      result = await db.find({
+        collection: this.collection.slug,
+        limit,
+        page,
+        sort,
+        where
+      });
+    }
     result.docs = result.docs.map((doc) => DefaultsService.apply(this.collection.fields, doc));
     if (depth > 0) {
       const populationService = new PopulationService(db, config.collections);
@@ -1260,6 +1446,54 @@ var CollectionController = class {
     }
     return c.json({ message: "Deleted" });
   }
+  async deleteMany(c) {
+    const config = c.get("config");
+    const db = config.db;
+    if (!db) return c.json({ message: "Database not configured" }, 500);
+    const user = c.get("user");
+    let ids = [];
+    try {
+      const body = await c.req.json().catch(() => null);
+      if (body?.ids && Array.isArray(body.ids)) {
+        ids = body.ids;
+      }
+    } catch {
+    }
+    if (!ids.length) {
+      const raw = c.req.queries("ids") ?? c.req.queries("ids[]") ?? [];
+      ids = raw.filter(Boolean);
+    }
+    if (!ids.length) return c.json({ message: "No IDs provided" }, 400);
+    const deleted = [];
+    const failed = [];
+    for (const id of ids) {
+      try {
+        let before = null;
+        if (this.collection.audit) {
+          before = await db.findOne({ collection: this.collection.slug, id });
+        }
+        await db.delete({ collection: this.collection.slug, id });
+        deleted.push(id);
+        if (this.collection.audit) {
+          AuditService.log(db, {
+            operation: "delete",
+            collection: this.collection.slug,
+            documentId: id,
+            user: user ? { id: user.sub, collection: user.collection, email: user.email } : void 0,
+            before,
+            after: null
+          });
+        }
+      } catch (err) {
+        failed.push({ id, error: err?.message ?? "Unknown error" });
+      }
+    }
+    return c.json({
+      message: `Deleted ${deleted.length} document(s)`,
+      deleted,
+      ...failed.length ? { failed } : {}
+    });
+  }
   async seed(c) {
     const config = c.get("config");
     const db = config.db;
@@ -1294,7 +1528,13 @@ var GlobalController = class {
     const db = config.db;
     if (!db) return c.json({ message: "Database not configured" }, 500);
     const depth = c.req.query("depth") !== void 0 ? Number(c.req.query("depth")) : 1;
-    const data = await db.getGlobal({ slug: this.global.slug });
+    let data = await db.getGlobal({ slug: this.global.slug });
+    const isEmpty = !data || Object.keys(data).length === 0;
+    if (isEmpty && this.global.initialData) {
+      console.log(`[dyrected/core] Auto-seeding global "${this.global.slug}" from config.initialData`);
+      await db.updateGlobal({ slug: this.global.slug, data: this.global.initialData });
+      data = this.global.initialData;
+    }
     const dataWithDefaults = DefaultsService.apply(this.global.fields, data);
     if (depth > 0 && dataWithDefaults) {
       const populationService = new PopulationService(db, config.collections);
@@ -2509,6 +2749,7 @@ function registerRoutes(app, config) {
     app.get(path, accessGate(collection, "read"), (c) => controller.find(c));
     app.post(path, accessGate(collection, "create"), (c) => controller.create(c));
     app.post(`${path}/media`, accessGate(collection, "create"), (c) => controller.create(c));
+    app.delete(`${path}/delete-many`, accessGate(collection, "delete"), (c) => controller.deleteMany(c));
     app.get(`${path}/:id`, accessGate(collection, "read"), (c) => controller.findOne(c));
     app.patch(`${path}/:id`, accessGate(collection, "update"), (c) => controller.update(c));
     app.delete(`${path}/:id`, accessGate(collection, "delete"), (c) => controller.delete(c));
@@ -2559,8 +2800,10 @@ function registerRoutes(app, config) {
         if (id) {
           if (method === "GET") return controller.findOne(c);
           if (method === "PATCH") return controller.update(c);
+          if (method === "DELETE" && id === "delete-many") return controller.deleteMany(c);
           if (method === "DELETE") return controller.delete(c);
           if (method === "POST" && id === "media") return controller.create(c);
+          if (method === "POST" && id === "seed") return controller.seed(c);
         } else {
           if (method === "GET") return controller.find(c);
           if (method === "POST") return controller.create(c);
@@ -2646,5 +2889,7 @@ function defineConfig(config) {
   defineGlobal,
   generateAIPrompt,
   generateFreshSetupPrompt,
-  normalizeConfig
+  normalizeConfig,
+  parseMongoWhere,
+  parseSqlWhere
 });

package/dist/index.d.cts

@@ -21,6 +21,69 @@ declare function generateAIPrompt(activeTab: "next" | "nuxt" | "react" | "vue",
  */
 declare function normalizeConfig(config: DyrectedConfig): DyrectedConfig;
 
+/**
+ * Dyrected Where Clause DSL — shared query language across all database adapters.
+ *
+ * Adapters translate this DSL into their native format:
+ *   - SQL adapters (SQLite, Postgres, MySQL): use parseSqlWhere()
+ *   - MongoDB adapter: use parseMongoWhere()
+ *   - Future adapters: implement their own translator against WhereClause
+ *
+ * Exhaustive operator handling is enforced at compile time via `assertNever`,
+ * so adding a new operator without handling it will produce a TypeScript error
+ * in every adapter translator.
+ */
+type WhereOperatorName = 'equals' | 'not_equals' | 'in' | 'not_in' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'starts_with' | 'exists';
+type WhereOperator = {
+    equals: any;
+} | {
+    not_equals: any;
+} | {
+    in: any[];
+} | {
+    not_in: any[];
+} | {
+    gt: any;
+} | {
+    gte: any;
+} | {
+    lt: any;
+} | {
+    lte: any;
+} | {
+    contains: string;
+} | {
+    starts_with: string;
+} | {
+    exists: boolean;
+};
+/** Top-level where clause. Fields map to operator objects or shorthand scalar values. */
+type WhereClause = {
+    [field: string]: WhereOperator | any;
+    OR?: WhereClause[];
+    AND?: WhereClause[];
+};
+interface SqlWhereResult {
+    sql: string;
+    params: any[];
+}
+/**
+ * Translates a WhereClause into a parameterized SQL WHERE fragment.
+ *
+ * @param where         The Dyrected where DSL object
+ * @param getJsonField  Returns the SQL expression for a JSON-stored field (dialect-specific):
+ *                        SQLite:   (f) => `json_extract(data, '$.${f}')`
+ *                        Postgres: (f) => `data->>'${f}'`
+ *                        MySQL:    (f) => `JSON_UNQUOTE(JSON_EXTRACT(data, '$.${f}'))`
+ * @param placeholder   '?' for SQLite/MySQL, 'pg' for auto-incrementing Postgres $1/$2/…
+ */
+declare function parseSqlWhere(where: WhereClause, getJsonField: (field: string) => string, placeholder?: '?' | 'pg'): SqlWhereResult;
+/**
+ * Translates a WhereClause into a MongoDB filter object.
+ * Handles nested OR/AND via $or/$and, and all operators via $eq/$in/$gt etc.
+ */
+declare function parseMongoWhere(where: WhereClause): Record<string, any>;
+
 /**
  * Define a collection configuration with full type safety.
  */
@@ -34,4 +97,4 @@ declare function defineGlobal(config: GlobalConfig): GlobalConfig;
  */
 declare function defineConfig(config: DyrectedConfig): DyrectedConfig;
 
-export { CollectionConfig, DyrectedConfig, GlobalConfig, type SetupPromptConfig, defineCollection, defineConfig, defineGlobal, generateAIPrompt, generateFreshSetupPrompt, normalizeConfig };
+export { CollectionConfig, DyrectedConfig, GlobalConfig, type SetupPromptConfig, type SqlWhereResult, type WhereClause, type WhereOperator, type WhereOperatorName, defineCollection, defineConfig, defineGlobal, generateAIPrompt, generateFreshSetupPrompt, normalizeConfig, parseMongoWhere, parseSqlWhere };

package/dist/index.d.ts

@@ -21,6 +21,69 @@ declare function generateAIPrompt(activeTab: "next" | "nuxt" | "react" | "vue",
  */
 declare function normalizeConfig(config: DyrectedConfig): DyrectedConfig;
 
+/**
+ * Dyrected Where Clause DSL — shared query language across all database adapters.
+ *
+ * Adapters translate this DSL into their native format:
+ *   - SQL adapters (SQLite, Postgres, MySQL): use parseSqlWhere()
+ *   - MongoDB adapter: use parseMongoWhere()
+ *   - Future adapters: implement their own translator against WhereClause
+ *
+ * Exhaustive operator handling is enforced at compile time via `assertNever`,
+ * so adding a new operator without handling it will produce a TypeScript error
+ * in every adapter translator.
+ */
+type WhereOperatorName = 'equals' | 'not_equals' | 'in' | 'not_in' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'starts_with' | 'exists';
+type WhereOperator = {
+    equals: any;
+} | {
+    not_equals: any;
+} | {
+    in: any[];
+} | {
+    not_in: any[];
+} | {
+    gt: any;
+} | {
+    gte: any;
+} | {
+    lt: any;
+} | {
+    lte: any;
+} | {
+    contains: string;
+} | {
+    starts_with: string;
+} | {
+    exists: boolean;
+};
+/** Top-level where clause. Fields map to operator objects or shorthand scalar values. */
+type WhereClause = {
+    [field: string]: WhereOperator | any;
+    OR?: WhereClause[];
+    AND?: WhereClause[];
+};
+interface SqlWhereResult {
+    sql: string;
+    params: any[];
+}
+/**
+ * Translates a WhereClause into a parameterized SQL WHERE fragment.
+ *
+ * @param where         The Dyrected where DSL object
+ * @param getJsonField  Returns the SQL expression for a JSON-stored field (dialect-specific):
+ *                        SQLite:   (f) => `json_extract(data, '$.${f}')`
+ *                        Postgres: (f) => `data->>'${f}'`
+ *                        MySQL:    (f) => `JSON_UNQUOTE(JSON_EXTRACT(data, '$.${f}'))`
+ * @param placeholder   '?' for SQLite/MySQL, 'pg' for auto-incrementing Postgres $1/$2/…
+ */
+declare function parseSqlWhere(where: WhereClause, getJsonField: (field: string) => string, placeholder?: '?' | 'pg'): SqlWhereResult;
+/**
+ * Translates a WhereClause into a MongoDB filter object.
+ * Handles nested OR/AND via $or/$and, and all operators via $eq/$in/$gt etc.
+ */
+declare function parseMongoWhere(where: WhereClause): Record<string, any>;
+
 /**
  * Define a collection configuration with full type safety.
  */
@@ -34,4 +97,4 @@ declare function defineGlobal(config: GlobalConfig): GlobalConfig;
  */
 declare function defineConfig(config: DyrectedConfig): DyrectedConfig;
 
-export { CollectionConfig, DyrectedConfig, GlobalConfig, type SetupPromptConfig, defineCollection, defineConfig, defineGlobal, generateAIPrompt, generateFreshSetupPrompt, normalizeConfig };
+export { CollectionConfig, DyrectedConfig, GlobalConfig, type SetupPromptConfig, type SqlWhereResult, type WhereClause, type WhereOperator, type WhereOperatorName, defineCollection, defineConfig, defineGlobal, generateAIPrompt, generateFreshSetupPrompt, normalizeConfig, parseMongoWhere, parseSqlWhere };