@cedarjs/gqlorm 5.0.7-next.338 → 5.0.7

package/dist/cjs/queryBuilder.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Main query builder entry point that combines parsing and generation
+ * This is the primary API that users will interact with
+ */
+import { GraphQLGenerateError } from './generator/graphqlGenerator.js';
+import type { GraphQLQuery } from './generator/graphqlGenerator.js';
+import { QueryParseError } from './parser/queryParser.js';
+import type { QueryAST, QueryOperation } from './types/ast.js';
+import { type FindFirstArgs, type FindManyArgs, type FindUniqueArgs, type FrameworkDbClient, type QueryFunction } from './types/orm.js';
+import type { ModelSchema } from './types/schema.js';
+export declare class QueryBuilderError extends Error {
+    cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+type GenericQueryArgs = FindManyArgs<unknown> | FindUniqueArgs<unknown> | FindFirstArgs<unknown>;
+export interface QueryBuilderOptions {
+    /**
+     * Whether to validate queries against schema (future feature)
+     */
+    readonly validateSchema?: boolean;
+    /**
+     * Whether to optimize queries (future feature)
+     */
+    readonly optimizeQueries?: boolean;
+    /**
+     * Custom field name mappings (future feature)
+     */
+    fieldMappings?: Record<string, string>;
+    /**
+     * Whether to automatically add @live directive to queries
+     * @default false
+     */
+    readonly enableLiveQueries?: boolean;
+    /**
+     * Whether to force @live directive on all queries (overrides
+     * enableLiveQueries)
+     * @default false
+     */
+    readonly forceLiveQueries?: boolean;
+    /**
+     * Model schema defining scalar fields for each model
+     */
+    readonly schema?: ModelSchema;
+}
+export declare class QueryBuilder {
+    #private;
+    constructor(options?: QueryBuilderOptions);
+    /**
+     * Build GraphQL query from ORM-style query
+     */
+    build(model: string, operation: QueryOperation, args?: GenericQueryArgs, options?: {
+        isLive?: boolean;
+    }): GraphQLQuery;
+    /**
+     * Build GraphQL query from a query function (used with useLiveQuery)
+     */
+    buildFromFunction<T, TDb extends object = FrameworkDbClient>(queryFn: QueryFunction<T, TDb>, options?: {
+        isLive?: boolean;
+    }): GraphQLQuery;
+    /**
+     * Capture query details from a query function using a proxy
+     */
+    private captureQuery;
+    /**
+     * Create a proxy database client that captures method calls
+     */
+    private createProxyDatabase;
+    /**
+     * Create a proxy model delegate that captures method calls
+     */
+    private createModelDelegate;
+    /**
+     * Parse AST from query (exposed for advanced usage)
+     */
+    parseAST(model: string, operation: QueryOperation, args?: GenericQueryArgs): QueryAST;
+    /**
+     * Generate GraphQL from AST (exposed for advanced usage)
+     */
+    generateGraphQL(ast: QueryAST): GraphQLQuery;
+    /**
+     * Get query builder options
+     */
+    getOptions(): QueryBuilderOptions;
+    /**
+     * 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?: {
+    isLive?: boolean;
+}): GraphQLQuery;
+export declare function buildQueryFromFunction<T, TDb extends object = FrameworkDbClient>(queryFn: QueryFunction<T, TDb>, options?: {
+    isLive?: boolean;
+}): GraphQLQuery;
+/**
+ * Build a live GraphQL query from ORM-style query (convenience function)
+ */
+export declare function buildLiveQuery(model: string, operation: QueryOperation, args?: GenericQueryArgs): GraphQLQuery;
+/**
+ * Build a live GraphQL query from a query function (convenience function)
+ */
+export declare function buildLiveQueryFromFunction<T, TDb extends object = FrameworkDbClient>(queryFn: QueryFunction<T, TDb>): GraphQLQuery;
+export { GraphQLGenerateError, QueryParseError };
+export type { GraphQLQuery, QueryAST, QueryOperation, ModelSchema };
+//# sourceMappingURL=queryBuilder.d.ts.map

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

@@ -0,0 +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;IA8Bf;;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;IAI7D;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;CAwBvD;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"}

package/dist/cjs/queryBuilder.js

@@ -0,0 +1,238 @@
+"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 queryBuilder_exports = {};
+__export(queryBuilder_exports, {
+  GraphQLGenerateError: () => import_graphqlGenerator.GraphQLGenerateError,
+  QueryBuilder: () => QueryBuilder,
+  QueryBuilderError: () => QueryBuilderError,
+  QueryParseError: () => import_queryParser.QueryParseError,
+  buildLiveQuery: () => buildLiveQuery,
+  buildLiveQueryFromFunction: () => buildLiveQueryFromFunction,
+  buildQuery: () => buildQuery,
+  buildQueryFromFunction: () => buildQueryFromFunction,
+  queryBuilder: () => queryBuilder
+});
+module.exports = __toCommonJS(queryBuilder_exports);
+var import_graphqlGenerator = require("./generator/graphqlGenerator.js");
+var import_queryParser = require("./parser/queryParser.js");
+class QueryBuilderError extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "QueryBuilderError";
+  }
+  cause;
+}
+class QueryBuilder {
+  #parser = new import_queryParser.QueryParser();
+  #generator;
+  #options;
+  constructor(options = {}) {
+    this.#options = structuredClone(options);
+    this.#generator = new import_graphqlGenerator.GraphQLGenerator(options.schema);
+  }
+  /**
+   * Build GraphQL query from ORM-style query
+   */
+  build(model, operation, args, options) {
+    try {
+      const ast = this.#parser.parseQuery(model, operation, args);
+      if (this.#shouldUseLiveQuery(options?.isLive)) {
+        ast.isLive = true;
+      }
+      this.#parser.validateAST(ast);
+      const graphqlQuery = this.#generator.generate(ast);
+      return graphqlQuery;
+    } catch (error) {
+      if (error instanceof import_queryParser.QueryParseError || error instanceof import_graphqlGenerator.GraphQLGenerateError) {
+        throw new QueryBuilderError(
+          `Failed to build query: ${error.message}`,
+          error
+        );
+      }
+      throw error;
+    }
+  }
+  buildFromFunction(queryFn, options) {
+    const capturedQuery = this.captureQuery(queryFn);
+    if (!capturedQuery) {
+      throw new QueryBuilderError(
+        "No query was captured from the provided function"
+      );
+    }
+    return this.build(
+      capturedQuery.model,
+      capturedQuery.operation,
+      capturedQuery.args,
+      options
+    );
+  }
+  /**
+   * Capture query details from a query function using a proxy
+   */
+  captureQuery(queryFn) {
+    let capturedQuery = null;
+    const proxyDb = this.createProxyDatabase((model, operation, args) => {
+      capturedQuery = { model, operation, args };
+      return {};
+    });
+    try {
+      queryFn(proxyDb);
+      return capturedQuery;
+    } catch (error) {
+      const e = error instanceof Error ? error : new Error(String(error));
+      throw new QueryBuilderError("Failed to capture query from function", e);
+    }
+  }
+  /**
+   * Create a proxy database client that captures method calls
+   */
+  createProxyDatabase(onQuery) {
+    const proxyTarget = {};
+    return new Proxy(proxyTarget, {
+      get: (_, modelName) => {
+        if (typeof modelName !== "string") {
+          return void 0;
+        }
+        return this.createModelDelegate(modelName, onQuery);
+      }
+    });
+  }
+  /**
+   * Create a proxy model delegate that captures method calls
+   */
+  createModelDelegate(model, onQuery) {
+    return {
+      findMany: (args) => {
+        onQuery(model, "findMany", args);
+        return Promise.resolve([]);
+      },
+      findUnique: (args) => {
+        onQuery(model, "findUnique", args);
+        return Promise.resolve(null);
+      },
+      findFirst: (args) => {
+        onQuery(model, "findFirst", args);
+        return Promise.resolve(null);
+      },
+      findUniqueOrThrow: (args) => {
+        onQuery(model, "findUniqueOrThrow", args);
+        return Promise.resolve(void 0);
+      },
+      findFirstOrThrow: (args) => {
+        onQuery(model, "findFirstOrThrow", args);
+        return Promise.resolve(void 0);
+      }
+    };
+  }
+  /**
+   * Parse AST from query (exposed for advanced usage)
+   */
+  parseAST(model, operation, args) {
+    try {
+      return this.#parser.parseQuery(model, operation, args);
+    } catch (error) {
+      if (error instanceof import_queryParser.QueryParseError) {
+        throw new QueryBuilderError(
+          `Failed to parse query: ${error.message}`,
+          error
+        );
+      }
+      throw error;
+    }
+  }
+  /**
+   * Generate GraphQL from AST (exposed for advanced usage)
+   */
+  generateGraphQL(ast) {
+    try {
+      return this.#generator.generate(ast);
+    } catch (error) {
+      if (error instanceof import_graphqlGenerator.GraphQLGenerateError) {
+        throw new QueryBuilderError(
+          `Failed to generate GraphQL: ${error.message}`,
+          error
+        );
+      }
+      throw error;
+    }
+  }
+  /**
+   * Get query builder options
+   */
+  getOptions() {
+    return structuredClone(this.#options);
+  }
+  /**
+   * Update query builder options
+   */
+  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
+   */
+  #shouldUseLiveQuery(explicitIsLive) {
+    if (explicitIsLive !== void 0) {
+      return explicitIsLive;
+    }
+    if (this.#options.forceLiveQueries) {
+      return true;
+    }
+    return this.#options.enableLiveQueries || false;
+  }
+}
+const queryBuilder = new QueryBuilder();
+function buildQuery(model, operation, args, options) {
+  return queryBuilder.build(model, operation, args, options);
+}
+function buildQueryFromFunction(queryFn, options) {
+  return queryBuilder.buildFromFunction(queryFn, options);
+}
+function buildLiveQuery(model, operation, args) {
+  return queryBuilder.build(model, operation, args, { isLive: true });
+}
+function buildLiveQueryFromFunction(queryFn) {
+  return queryBuilder.buildFromFunction(queryFn, { isLive: true });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GraphQLGenerateError,
+  QueryBuilder,
+  QueryBuilderError,
+  QueryParseError,
+  buildLiveQuery,
+  buildLiveQueryFromFunction,
+  buildQuery,
+  buildQueryFromFunction,
+  queryBuilder
+});

package/dist/cjs/react/useLiveQuery.d.ts

@@ -0,0 +1,12 @@
+/**
+ * React hook for live data fetching using GraphQL queries with `@live`
+ * generated from Prisma-like query functions.
+ */
+import { useQuery as cedarUseQuery } from '@cedarjs/web';
+import type { FrameworkDbClient, QueryFunction } from '../types/orm.js';
+export type UseLiveQueryOptions = Omit<NonNullable<Parameters<typeof cedarUseQuery>[1]>, 'variables'>;
+export type UseLiveQueryResult<T> = Omit<ReturnType<typeof cedarUseQuery>, 'data'> & {
+    data: T | undefined;
+};
+export declare function useLiveQuery<T, TDb extends object = FrameworkDbClient>(queryFn: QueryFunction<T, TDb>, options?: UseLiveQueryOptions): UseLiveQueryResult<T>;
+//# sourceMappingURL=useLiveQuery.d.ts.map

package/dist/cjs/react/useLiveQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveQuery.d.ts","sourceRoot":"","sources":["../../../src/react/useLiveQuery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,cAAc,CAAA;AAGxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAKvE,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,WAAW,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,EAChD,WAAW,CACZ,CAAA;AAED,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,IAAI,CACtC,UAAU,CAAC,OAAO,aAAa,CAAC,EAChC,MAAM,CACP,GAAG;IACF,IAAI,EAAE,CAAC,GAAG,SAAS,CAAA;CACpB,CAAA;AAYD,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,GAAG,iBAAiB,EACpE,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,kBAAkB,CAAC,CAAC,CAAC,CA4BvB"}

package/dist/cjs/react/useLiveQuery.js

@@ -0,0 +1,62 @@
+"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 useLiveQuery_exports = {};
+__export(useLiveQuery_exports, {
+  useLiveQuery: () => useLiveQuery
+});
+module.exports = __toCommonJS(useLiveQuery_exports);
+var import_react = require("react");
+var import_graphql = require("graphql");
+var import_web = require("@cedarjs/web");
+var import_queryBuilder = require("../queryBuilder.js");
+function extractRootFieldData(payload) {
+  if (!payload) {
+    return void 0;
+  }
+  return Object.values(payload)[0];
+}
+function useLiveQuery(queryFn, options) {
+  const { query, variables } = (0, import_react.useMemo)(() => {
+    try {
+      const graphqlQuery = import_queryBuilder.queryBuilder.buildFromFunction(queryFn, {
+        isLive: true
+      });
+      return {
+        query: graphqlQuery.query,
+        variables: graphqlQuery.variables ?? {}
+      };
+    } catch (error) {
+      const errorMsg = error instanceof Error ? error.message : String(error);
+      throw new Error(`Failed to build GraphQL query: ${errorMsg}`);
+    }
+  }, [queryFn]);
+  const document = (0, import_react.useMemo)(() => (0, import_graphql.parse)(query), [query]);
+  const queryResult = (0, import_web.useQuery)(document, {
+    ...options ?? {},
+    variables
+  });
+  return {
+    ...queryResult,
+    data: extractRootFieldData(queryResult.data)
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useLiveQuery
+});

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/cjs/types/ast.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Abstract Syntax Tree (AST) types for representing parsed ORM queries
+ * These types form the intermediate representation between ORM syntax and
+ * GraphQL queries
+ */
+export interface ASTNode {
+    type: string;
+}
+export type QueryOperation = 'findMany' | 'findUnique' | 'findFirst' | 'findUniqueOrThrow' | 'findFirstOrThrow';
+export interface QueryAST extends ASTNode {
+    type: 'Query';
+    model: string;
+    operation: QueryOperation;
+    args?: QueryArgsAST;
+    isLive?: boolean;
+}
+export interface QueryArgsAST extends ASTNode {
+    type: 'QueryArgs';
+    where?: WhereAST;
+    select?: SelectAST;
+    include?: IncludeAST;
+    orderBy?: OrderByAST;
+    take?: number;
+    skip?: number;
+}
+export interface WhereAST extends ASTNode {
+    type: 'Where';
+    conditions: WhereCondition[];
+}
+export type WhereCondition = FieldCondition | LogicalCondition | RelationCondition;
+export interface FieldCondition extends ASTNode {
+    type: 'FieldCondition';
+    field: string;
+    operator: ComparisonOperator;
+    value: any;
+}
+export interface LogicalCondition extends ASTNode {
+    type: 'LogicalCondition';
+    operator: LogicalOperator;
+    conditions: WhereCondition[];
+}
+export interface RelationCondition extends ASTNode {
+    type: 'RelationCondition';
+    relation: string;
+    condition: WhereAST;
+}
+export type ComparisonOperator = 'equals' | 'not' | 'in' | 'notIn' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains' | 'startsWith' | 'endsWith' | 'isNull' | 'isNotNull';
+export type LogicalOperator = 'AND' | 'OR' | 'NOT';
+export interface SelectAST extends ASTNode {
+    type: 'Select';
+    fields: FieldSelection[];
+}
+export interface FieldSelection extends ASTNode {
+    type: 'FieldSelection';
+    field: string;
+    selected: boolean;
+    nested?: SelectAST | IncludeAST;
+}
+export interface IncludeAST extends ASTNode {
+    type: 'Include';
+    relations: RelationInclusion[];
+}
+export interface RelationInclusion extends ASTNode {
+    type: 'RelationInclusion';
+    relation: string;
+    included: boolean;
+    nested?: IncludeAST;
+    args?: QueryArgsAST;
+}
+export interface OrderByAST extends ASTNode {
+    type: 'OrderBy';
+    fields: OrderByField[];
+}
+export interface OrderByField extends ASTNode {
+    type: 'OrderByField';
+    field: string;
+    direction: 'asc' | 'desc';
+}
+export type ASTNodeType = QueryAST | QueryArgsAST | WhereAST | SelectAST | IncludeAST | OrderByAST | FieldCondition | LogicalCondition | RelationCondition | FieldSelection | RelationInclusion | OrderByField;
+//# sourceMappingURL=ast.d.ts.map

package/dist/cjs/types/ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../../src/types/ast.ts"],"names":[],"mappings":"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"}

package/dist/cjs/types/ast.js

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 ast_exports = {};
+module.exports = __toCommonJS(ast_exports);