@cedarjs/gqlorm 3.1.2-next.0 → 3.1.2-next.128

package/dist/cjs/generator/graphqlGenerator.d.ts

@@ -15,6 +15,12 @@ export interface GraphQLQuery {
 export declare class GraphQLGenerator {
     #private;
     constructor(schema?: ModelSchema);
+    /**
+     * Update the model schema used for automatic field selection.
+     * Pass `undefined` to revert to the id-only fallback.
+     * Safe to call multiple times — last call wins.
+     */
+    setSchema(schema: ModelSchema | undefined): void;
     /**
      * Generate GraphQL query from AST
      */

package/dist/cjs/generator/graphqlGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphqlGenerator.d.ts","sourceRoot":"","sources":["../../../src/generator/graphqlGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAOV,QAAQ,EAKT,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAOrD,qBAAa,oBAAqB,SAAQ,KAAK;IAGpC,OAAO,CAAC,EAAE,GAAG;gBADpB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,GAAG,YAAA;CAKvB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAChC;AAED,qBAAa,gBAAgB;;gBASf,MAAM,CAAC,EAAE,WAAW;IAIhC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,YAAY;CAodtC;AAGD,eAAO,MAAM,gBAAgB,kBAAyB,CAAA"}
+{"version":3,"file":"graphqlGenerator.d.ts","sourceRoot":"","sources":["../../../src/generator/graphqlGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAOV,QAAQ,EAKT,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAOrD,qBAAa,oBAAqB,SAAQ,KAAK;IAGpC,OAAO,CAAC,EAAE,GAAG;gBADpB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,GAAG,YAAA;CAKvB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAChC;AAED,qBAAa,gBAAgB;;gBASf,MAAM,CAAC,EAAE,WAAW;IAIhC;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI;IAIhD;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,YAAY;CAodtC;AAGD,eAAO,MAAM,gBAAgB,kBAAyB,CAAA"}

package/dist/cjs/generator/graphqlGenerator.js

@@ -30,6 +30,7 @@ class GraphQLGenerateError extends Error {
     this.context = context;
     this.name = "GraphQLGenerateError";
   }
+  context;
 }
 class GraphQLGenerator {
   #variableCounter = 0;
@@ -42,6 +43,14 @@ class GraphQLGenerator {
   constructor(schema) {
     this.#schema = schema;
   }
+  /**
+   * Update the model schema used for automatic field selection.
+   * Pass `undefined` to revert to the id-only fallback.
+   * Safe to call multiple times — last call wins.
+   */
+  setSchema(schema) {
+    this.#schema = schema;
+  }
   /**
    * Generate GraphQL query from AST
    */
@@ -56,6 +65,9 @@ class GraphQLGenerator {
       const variableDefinitions = this.#generateVariableDefinitions();
       query += `(${variableDefinitions})`;
     }
+    if (ast.isLive) {
+      query += " @live";
+    }
     query += ` {
 ${queryBody}
 }`;
@@ -85,7 +97,7 @@ ${queryBody}
    * Generate main query body
    */
   #generateQueryBody(ast) {
-    const { model, operation, args, isLive } = ast;
+    const { model, operation, args } = ast;
     const fieldName = this.#getGraphQLFieldName(model, operation);
     let query = `  ${fieldName}`;
     if (args) {
@@ -94,9 +106,6 @@ ${queryBody}
         query += `(${argsString})`;
       }
     }
-    if (isLive) {
-      query += " @live";
-    }
     const fields = this.#generateFieldSelection(args, model);
     query += ` {
 ${fields}
@@ -295,7 +304,7 @@ ${fields}
       const fields = this.#schema[model];
       return fields.map((field) => `    ${field}`).join("\n");
     }
-    return "    id\n    createdAt\n    updatedAt";
+    return "    id";
   }
   /**
    * Generate fields from SELECT clause

package/dist/cjs/parser/queryParser.js

@@ -30,6 +30,7 @@ class QueryParseError extends Error {
     this.context = context;
     this.name = "QueryParseError";
   }
+  context;
 }
 class QueryParser {
   /**

package/dist/cjs/queryBuilder.d.ts

@@ -85,6 +85,14 @@ export declare class QueryBuilder {
      * Update query builder options
      */
     updateOptions(newOptions: Partial<QueryBuilderOptions>): void;
+    /**
+     * Configure the query builder options.
+     * Merges the provided options over the current options (non-destructive).
+     * When the `schema` key is present in the options object, it is forwarded
+     * to the generator — including `undefined`, which reverts to the id-only
+     * fallback. Safe to call multiple times — last call wins.
+     */
+    configure(options: Partial<QueryBuilderOptions>): void;
 }
 export declare const queryBuilder: QueryBuilder;
 export declare function buildQuery(model: string, operation: QueryOperation, args?: GenericQueryArgs, options?: {

package/dist/cjs/queryBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queryBuilder.d.ts","sourceRoot":"","sources":["../../src/queryBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,oBAAoB,EAErB,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AACnE,OAAO,EAAE,eAAe,EAAe,MAAM,yBAAyB,CAAA;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EAEtB,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,qBAAa,iBAAkB,SAAQ,KAAK;IAGxB,KAAK,CAAC,EAAE,KAAK;gBAD7B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED,KAAK,gBAAgB,GACjB,YAAY,CAAC,OAAO,CAAC,GACrB,cAAc,CAAC,OAAO,CAAC,GACvB,aAAa,CAAC,OAAO,CAAC,CAAA;AAE1B,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;IAEjC;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;IAElC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEtC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAEnC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,qBAAa,YAAY;;gBAKX,OAAO,GAAE,mBAAwB;IAK7C;;OAEG;IACH,KAAK,CACH,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,cAAc,EACzB,IAAI,CAAC,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,YAAY;IA+Bf;;OAEG;IACH,iBAAiB,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,GAAG,iBAAiB,EACzD,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,EAC9B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,YAAY;IAsBf;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgC3B;;OAEG;IACH,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,cAAc,EACzB,IAAI,CAAC,EAAE,gBAAgB,GACtB,QAAQ;IAcX;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,YAAY;IAc5C;;OAEG;IACH,UAAU,IAAI,mBAAmB;IAIjC;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;CAqB9D;AAUD,eAAO,MAAM,YAAY,cAAqB,CAAA;AAG9C,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,cAAc,EACzB,IAAI,CAAC,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,YAAY,CAEd;AAED,wBAAgB,sBAAsB,CACpC,CAAC,EACD,GAAG,SAAS,MAAM,GAAG,iBAAiB,EAEtC,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,EAC9B,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,YAAY,CAEd;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,cAAc,EACzB,IAAI,CAAC,EAAE,gBAAgB,GACtB,YAAY,CAEd;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,CAAC,EACD,GAAG,SAAS,MAAM,GAAG,iBAAiB,EACtC,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,YAAY,CAE9C;AAGD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,CAAA;AAEhD,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"queryBuilder.d.ts","sourceRoot":"","sources":["../../src/queryBuilder.ts"],"names":[],"mappings":"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"}

package/dist/cjs/queryBuilder.js

@@ -37,6 +37,7 @@ class QueryBuilderError extends Error {
     this.cause = cause;
     this.name = "QueryBuilderError";
   }
+  cause;
 }
 class QueryBuilder {
   #parser = new import_queryParser.QueryParser();
@@ -52,8 +53,7 @@ class QueryBuilder {
   build(model, operation, args, options) {
     try {
       const ast = this.#parser.parseQuery(model, operation, args);
-      const isLive = this.#shouldUseLiveQuery(options?.isLive);
-      if (isLive) {
+      if (this.#shouldUseLiveQuery(options?.isLive)) {
         ast.isLive = true;
       }
       this.#parser.validateAST(ast);
@@ -185,6 +185,19 @@ class QueryBuilder {
   updateOptions(newOptions) {
     this.#options = { ...this.#options, ...newOptions };
   }
+  /**
+   * Configure the query builder options.
+   * Merges the provided options over the current options (non-destructive).
+   * When the `schema` key is present in the options object, it is forwarded
+   * to the generator — including `undefined`, which reverts to the id-only
+   * fallback. Safe to call multiple times — last call wins.
+   */
+  configure(options) {
+    this.#options = { ...this.#options, ...options };
+    if ("schema" in options) {
+      this.#generator.setSchema(options.schema);
+    }
+  }
   /**
    * Determine if a query should use @live directive
    */

package/dist/cjs/setup.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Public setup API for gqlorm.
+ *
+ * Call `configureGqlorm()` once at app startup — typically at the top of
+ * `App.tsx` or in a dedicated bootstrap file — before any `useLiveQuery`
+ * invocations.
+ *
+ * @example
+ * import { configureGqlorm } from '@cedarjs/gqlorm/setup'
+ * import schema from '.cedar/gqlorm-schema.json'
+ *
+ * configureGqlorm({ schema })
+ */
+import type { ModelSchema } from './types/schema.js';
+export interface ConfigureGqlormOptions {
+    /**
+     * The model schema mapping lowercase model names to their visible scalar
+     * field names. Typically imported from `.cedar/gqlorm-schema.json`, which
+     * is auto-generated by Cedar's codegen pipeline.
+     *
+     * When `undefined`, gqlorm falls back to requesting only the `id` field in
+     * auto-generated queries (the behaviour before any schema is configured).
+     * Passing `undefined` explicitly is useful in test environments where a
+     * full schema is not available.
+     */
+    schema: ModelSchema | undefined;
+}
+/**
+ * Configure gqlorm at app startup.
+ *
+ * Applies the provided `ModelSchema` to the global `queryBuilder` singleton so
+ * that `useLiveQuery((db) => db.post.findMany())` — with no explicit `select`
+ * — generates a GraphQL query requesting all visible scalar fields for the
+ * model instead of only `id`.
+ *
+ * The call is idempotent and safe to invoke multiple times; the last call wins.
+ */
+export declare function configureGqlorm(options: ConfigureGqlormOptions): void;
+//# sourceMappingURL=setup.d.ts.map

package/dist/cjs/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;OASG;IACH,MAAM,EAAE,WAAW,GAAG,SAAS,CAAA;CAChC;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAErE"}

package/dist/cjs/setup.js

@@ -0,0 +1,31 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var setup_exports = {};
+__export(setup_exports, {
+  configureGqlorm: () => configureGqlorm
+});
+module.exports = __toCommonJS(setup_exports);
+var import_queryBuilder = require("./queryBuilder.js");
+function configureGqlorm(options) {
+  import_queryBuilder.queryBuilder.configure({ schema: options.schema });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  configureGqlorm
+});

package/dist/generator/graphqlGenerator.d.ts

@@ -15,6 +15,12 @@ export interface GraphQLQuery {
 export declare class GraphQLGenerator {
     #private;
     constructor(schema?: ModelSchema);
+    /**
+     * Update the model schema used for automatic field selection.
+     * Pass `undefined` to revert to the id-only fallback.
+     * Safe to call multiple times — last call wins.
+     */
+    setSchema(schema: ModelSchema | undefined): void;
     /**
      * Generate GraphQL query from AST
      */

package/dist/generator/graphqlGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphqlGenerator.d.ts","sourceRoot":"","sources":["../../src/generator/graphqlGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAOV,QAAQ,EAKT,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAOrD,qBAAa,oBAAqB,SAAQ,KAAK;IAGpC,OAAO,CAAC,EAAE,GAAG;gBADpB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,GAAG,YAAA;CAKvB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAChC;AAED,qBAAa,gBAAgB;;gBASf,MAAM,CAAC,EAAE,WAAW;IAIhC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,YAAY;CAodtC;AAGD,eAAO,MAAM,gBAAgB,kBAAyB,CAAA"}
+{"version":3,"file":"graphqlGenerator.d.ts","sourceRoot":"","sources":["../../src/generator/graphqlGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAOV,QAAQ,EAKT,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAOrD,qBAAa,oBAAqB,SAAQ,KAAK;IAGpC,OAAO,CAAC,EAAE,GAAG;gBADpB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,GAAG,YAAA;CAKvB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAChC;AAED,qBAAa,gBAAgB;;gBASf,MAAM,CAAC,EAAE,WAAW;IAIhC;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI;IAIhD;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,YAAY;CAodtC;AAGD,eAAO,MAAM,gBAAgB,kBAAyB,CAAA"}

package/dist/generator/graphqlGenerator.js

@@ -1,3 +1,4 @@
+import {} from "../types/schema.js";
 import {
   isFieldCondition,
   isLogicalCondition,
@@ -9,6 +10,7 @@ class GraphQLGenerateError extends Error {
     this.context = context;
     this.name = "GraphQLGenerateError";
   }
+  context;
 }
 class GraphQLGenerator {
   #variableCounter = 0;
@@ -21,6 +23,14 @@ class GraphQLGenerator {
   constructor(schema) {
     this.#schema = schema;
   }
+  /**
+   * Update the model schema used for automatic field selection.
+   * Pass `undefined` to revert to the id-only fallback.
+   * Safe to call multiple times — last call wins.
+   */
+  setSchema(schema) {
+    this.#schema = schema;
+  }
   /**
    * Generate GraphQL query from AST
    */
@@ -35,6 +45,9 @@ class GraphQLGenerator {
       const variableDefinitions = this.#generateVariableDefinitions();
       query += `(${variableDefinitions})`;
     }
+    if (ast.isLive) {
+      query += " @live";
+    }
     query += ` {
 ${queryBody}
 }`;
@@ -64,7 +77,7 @@ ${queryBody}
    * Generate main query body
    */
   #generateQueryBody(ast) {
-    const { model, operation, args, isLive } = ast;
+    const { model, operation, args } = ast;
     const fieldName = this.#getGraphQLFieldName(model, operation);
     let query = `  ${fieldName}`;
     if (args) {
@@ -73,9 +86,6 @@ ${queryBody}
         query += `(${argsString})`;
       }
     }
-    if (isLive) {
-      query += " @live";
-    }
     const fields = this.#generateFieldSelection(args, model);
     query += ` {
 ${fields}
@@ -274,7 +284,7 @@ ${fields}
       const fields = this.#schema[model];
       return fields.map((field) => `    ${field}`).join("\n");
     }
-    return "    id\n    createdAt\n    updatedAt";
+    return "    id";
   }
   /**
    * Generate fields from SELECT clause

package/dist/live/types.js

@@ -0,0 +1 @@
+import {} from "../types/schema.js";

package/dist/parser/queryParser.js

@@ -5,6 +5,7 @@ class QueryParseError extends Error {
     this.context = context;
     this.name = "QueryParseError";
   }
+  context;
 }
 class QueryParser {
   /**

package/dist/queryBuilder.d.ts

@@ -85,6 +85,14 @@ export declare class QueryBuilder {
      * Update query builder options
      */
     updateOptions(newOptions: Partial<QueryBuilderOptions>): void;
+    /**
+     * Configure the query builder options.
+     * Merges the provided options over the current options (non-destructive).
+     * When the `schema` key is present in the options object, it is forwarded
+     * to the generator — including `undefined`, which reverts to the id-only
+     * fallback. Safe to call multiple times — last call wins.
+     */
+    configure(options: Partial<QueryBuilderOptions>): void;
 }
 export declare const queryBuilder: QueryBuilder;
 export declare function buildQuery(model: string, operation: QueryOperation, args?: GenericQueryArgs, options?: {

package/dist/queryBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queryBuilder.d.ts","sourceRoot":"","sources":["../src/queryBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,oBAAoB,EAErB,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AACnE,OAAO,EAAE,eAAe,EAAe,MAAM,yBAAyB,CAAA;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EAEtB,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,qBAAa,iBAAkB,SAAQ,KAAK;IAGxB,KAAK,CAAC,EAAE,KAAK;gBAD7B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED,KAAK,gBAAgB,GACjB,YAAY,CAAC,OAAO,CAAC,GACrB,cAAc,CAAC,OAAO,CAAC,GACvB,aAAa,CAAC,OAAO,CAAC,CAAA;AAE1B,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;IAEjC;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;IAElC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEtC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAEnC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,qBAAa,YAAY;;gBAKX,OAAO,GAAE,mBAAwB;IAK7C;;OAEG;IACH,KAAK,CACH,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,cAAc,EACzB,IAAI,CAAC,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,YAAY;IA+Bf;;OAEG;IACH,iBAAiB,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,GAAG,iBAAiB,EACzD,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,EAC9B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,YAAY;IAsBf;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgC3B;;OAEG;IACH,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,cAAc,EACzB,IAAI,CAAC,EAAE,gBAAgB,GACtB,QAAQ;IAcX;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,YAAY;IAc5C;;OAEG;IACH,UAAU,IAAI,mBAAmB;IAIjC;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;CAqB9D;AAUD,eAAO,MAAM,YAAY,cAAqB,CAAA;AAG9C,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,cAAc,EACzB,IAAI,CAAC,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,YAAY,CAEd;AAED,wBAAgB,sBAAsB,CACpC,CAAC,EACD,GAAG,SAAS,MAAM,GAAG,iBAAiB,EAEtC,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,EAC9B,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,YAAY,CAEd;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,cAAc,EACzB,IAAI,CAAC,EAAE,gBAAgB,GACtB,YAAY,CAEd;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,CAAC,EACD,GAAG,SAAS,MAAM,GAAG,iBAAiB,EACtC,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,YAAY,CAE9C;AAGD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,CAAA;AAEhD,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"queryBuilder.d.ts","sourceRoot":"","sources":["../src/queryBuilder.ts"],"names":[],"mappings":"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"}

package/dist/queryBuilder.js

@@ -3,12 +3,15 @@ import {
   GraphQLGenerator
 } from "./generator/graphqlGenerator.js";
 import { QueryParseError, QueryParser } from "./parser/queryParser.js";
+import {
+} from "./types/orm.js";
 class QueryBuilderError extends Error {
   constructor(message, cause) {
     super(message);
     this.cause = cause;
     this.name = "QueryBuilderError";
   }
+  cause;
 }
 class QueryBuilder {
   #parser = new QueryParser();
@@ -24,8 +27,7 @@ class QueryBuilder {
   build(model, operation, args, options) {
     try {
       const ast = this.#parser.parseQuery(model, operation, args);
-      const isLive = this.#shouldUseLiveQuery(options?.isLive);
-      if (isLive) {
+      if (this.#shouldUseLiveQuery(options?.isLive)) {
         ast.isLive = true;
       }
       this.#parser.validateAST(ast);
@@ -157,6 +159,19 @@ class QueryBuilder {
   updateOptions(newOptions) {
     this.#options = { ...this.#options, ...newOptions };
   }
+  /**
+   * Configure the query builder options.
+   * Merges the provided options over the current options (non-destructive).
+   * When the `schema` key is present in the options object, it is forwarded
+   * to the generator — including `undefined`, which reverts to the id-only
+   * fallback. Safe to call multiple times — last call wins.
+   */
+  configure(options) {
+    this.#options = { ...this.#options, ...options };
+    if ("schema" in options) {
+      this.#generator.setSchema(options.schema);
+    }
+  }
   /**
    * Determine if a query should use @live directive
    */

package/dist/setup.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Public setup API for gqlorm.
+ *
+ * Call `configureGqlorm()` once at app startup — typically at the top of
+ * `App.tsx` or in a dedicated bootstrap file — before any `useLiveQuery`
+ * invocations.
+ *
+ * @example
+ * import { configureGqlorm } from '@cedarjs/gqlorm/setup'
+ * import schema from '.cedar/gqlorm-schema.json'
+ *
+ * configureGqlorm({ schema })
+ */
+import type { ModelSchema } from './types/schema.js';
+export interface ConfigureGqlormOptions {
+    /**
+     * The model schema mapping lowercase model names to their visible scalar
+     * field names. Typically imported from `.cedar/gqlorm-schema.json`, which
+     * is auto-generated by Cedar's codegen pipeline.
+     *
+     * When `undefined`, gqlorm falls back to requesting only the `id` field in
+     * auto-generated queries (the behaviour before any schema is configured).
+     * Passing `undefined` explicitly is useful in test environments where a
+     * full schema is not available.
+     */
+    schema: ModelSchema | undefined;
+}
+/**
+ * Configure gqlorm at app startup.
+ *
+ * Applies the provided `ModelSchema` to the global `queryBuilder` singleton so
+ * that `useLiveQuery((db) => db.post.findMany())` — with no explicit `select`
+ * — generates a GraphQL query requesting all visible scalar fields for the
+ * model instead of only `id`.
+ *
+ * The call is idempotent and safe to invoke multiple times; the last call wins.
+ */
+export declare function configureGqlorm(options: ConfigureGqlormOptions): void;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;OASG;IACH,MAAM,EAAE,WAAW,GAAG,SAAS,CAAA;CAChC;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAErE"}

package/dist/setup.js

@@ -0,0 +1,7 @@
+import { queryBuilder } from "./queryBuilder.js";
+function configureGqlorm(options) {
+  queryBuilder.configure({ schema: options.schema });
+}
+export {
+  configureGqlorm
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cedarjs/gqlorm",
-  "version": "3.1.2-next.0+be2d452c1",
+  "version": "3.1.2-next.128+165de00ea8",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cedarjs/cedar.git",
@@ -19,6 +19,16 @@
         "default": "./dist/cjs/queryBuilder.js"
       }
     },
+    "./setup": {
+      "import": {
+        "types": "./dist/setup.d.ts",
+        "default": "./dist/setup.js"
+      },
+      "require": {
+        "types": "./dist/cjs/setup.d.ts",
+        "default": "./dist/cjs/setup.js"
+      }
+    },
     "./queryBuilder": {
       "import": {
         "types": "./dist/queryBuilder.d.ts",
@@ -128,18 +138,16 @@
     "test:watch": "vitest watch"
   },
   "dependencies": {
-    "@cedarjs/auth": "3.1.2-next.0+be2d452c1",
-    "@cedarjs/server-store": "3.1.2-next.0+be2d452c1",
-    "@cedarjs/web": "3.1.2-next.0+be2d452c1",
-    "graphql": "16.13.1",
-    "react": "18.3.1",
-    "react-dom": "18.3.1"
+    "@cedarjs/auth": "3.1.2-next.128+165de00ea8",
+    "@cedarjs/server-store": "3.1.2-next.128+165de00ea8",
+    "@cedarjs/web": "3.1.2-next.128+165de00ea8",
+    "graphql": "16.13.2"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.2",
     "@babel/cli": "7.28.6",
     "@babel/core": "^7.26.10",
-    "@cedarjs/framework-tools": "3.1.2-next.1",
+    "@cedarjs/framework-tools": "3.1.2-next.128",
     "@testing-library/jest-dom": "6.9.1",
     "@types/react": "^18.2.55",
     "@types/react-dom": "^18.2.19",
@@ -160,5 +168,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "be2d452c12f5f60784eab652d896b13f70b27e99"
+  "gitHead": "165de00ea86321332d0905102862b1165bcb726f"
 }