@biref/scanner 0.1.0 → 0.2.0

package/dist/index.cjs

@@ -935,10 +935,10 @@ var MySQLQueryEngine = class {
       sql += ` ORDER BY ${orderPieces.join(", ")}`;
     }
     if (spec.limit !== void 0) {
-      sql += ` LIMIT ${params.add(spec.limit)}`;
+      sql += ` LIMIT ${Number(spec.limit)}`;
     }
     if (spec.offset !== void 0) {
-      sql += ` OFFSET ${params.add(spec.offset)}`;
+      sql += ` OFFSET ${Number(spec.offset)}`;
     }
     return {
       command: sql,
@@ -2851,6 +2851,50 @@ var ChainBuilder = class _ChainBuilder {
     const rows = await this.ctx.executor.execute(limited, this.ctx.model);
     return rows[0] ?? null;
   }
+  /**
+   * Build and return every SQL query that `findMany` would execute,
+   * without running them. Walks the full plan tree including nested
+   * includes, returning the root query and one child per include level.
+   *
+   * Include children use placeholder `IN (?)` filters since the real
+   * parent key values are only known at execution time.
+   *
+   * Accepts a `QueryEngine` to produce adapter-specific SQL. Pass the
+   * adapter's engine for the dialect you want to inspect:
+   *
+   *   const explained = chain.toSQL(biref.adapters.get('postgres').engine);
+   */
+  toSQL(engine) {
+    return _ChainBuilder.explainPlan(this.plan, engine, this.ctx.model);
+  }
+  static explainPlan(plan, engine, model) {
+    const built = engine.build(plan.spec, model);
+    const childExplained = [];
+    for (const include of plan.includes) {
+      const childPlan = _ChainBuilder.buildExplainChildPlan(include);
+      childExplained.push(_ChainBuilder.explainPlan(childPlan, engine, model));
+    }
+    return {
+      entity: `${plan.spec.namespace}.${plan.spec.entity}`,
+      sql: built.command,
+      params: built.params,
+      includes: childExplained
+    };
+  }
+  static buildExplainChildPlan(include) {
+    const filters = [...include.plan.spec.filters ?? []];
+    for (const childKey of include.childKeys) {
+      filters.push({
+        field: childKey,
+        operator: "in",
+        value: ["?"]
+      });
+    }
+    return {
+      ...include.plan,
+      spec: { ...include.plan.spec, filters }
+    };
+  }
   /**
    * Escape hatch for advanced callers (tests, tooling): exposes the
    * accumulated plan without executing it. The typed builder's public