@constructive-io/graphql-query 3.2.4 → 3.3.0

package/index.d.ts

@@ -1,4 +1,23 @@
+/**
+ * @constructive-io/graphql-query
+ *
+ * Browser-safe GraphQL query generation core.
+ * Contains the pure-function query builders, AST generators, naming helpers,
+ * introspection utilities, and client execution layer.
+ *
+ * This package is the canonical source for runtime query generation logic.
+ * @constructive-io/graphql-codegen depends on this for the core and adds
+ * Node.js-only build-time features (CLI, file output, watch mode, etc.).
+ */
 export { QueryBuilder } from './query-builder';
 export { QueryExecutor, createExecutor } from './executor';
+export * from './ast';
+export * from './custom-ast';
 export * from './types';
 export * as MetaObject from './meta-object';
+export { convertFromMetaSchema } from './meta-object/convert';
+export { validateMetaObject, type ValidationResult } from './meta-object/validate';
+export * from './generators';
+export * from './client';
+export * from './introspect';
+export { stripSmartComments } from './utils';

package/index.js

@@ -1,4 +1,15 @@
 "use strict";
+/**
+ * @constructive-io/graphql-query
+ *
+ * Browser-safe GraphQL query generation core.
+ * Contains the pure-function query builders, AST generators, naming helpers,
+ * introspection utilities, and client execution layer.
+ *
+ * This package is the canonical source for runtime query generation logic.
+ * @constructive-io/graphql-codegen depends on this for the core and adds
+ * Node.js-only build-time features (CLI, file output, watch mode, etc.).
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -36,11 +47,33 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MetaObject = exports.createExecutor = exports.QueryExecutor = exports.QueryBuilder = void 0;
+exports.stripSmartComments = exports.validateMetaObject = exports.convertFromMetaSchema = exports.MetaObject = exports.createExecutor = exports.QueryExecutor = exports.QueryBuilder = void 0;
+// QueryBuilder class (runtime query builder)
 var query_builder_1 = require("./query-builder");
 Object.defineProperty(exports, "QueryBuilder", { enumerable: true, get: function () { return query_builder_1.QueryBuilder; } });
+// QueryExecutor (server-side execution via PostGraphile)
 var executor_1 = require("./executor");
 Object.defineProperty(exports, "QueryExecutor", { enumerable: true, get: function () { return executor_1.QueryExecutor; } });
 Object.defineProperty(exports, "createExecutor", { enumerable: true, get: function () { return executor_1.createExecutor; } });
+// AST builders (getAll, getMany, getOne, createOne, patchOne, deleteOne)
+__exportStar(require("./ast"), exports);
+// Custom AST (geometry, interval, etc.)
+__exportStar(require("./custom-ast"), exports);
+// All types (core + codegen-style schema/introspection/query/mutation/selection)
 __exportStar(require("./types"), exports);
+// Meta object utilities (convert, validate)
 exports.MetaObject = __importStar(require("./meta-object"));
+// Also export meta-object functions directly for codegen backward compatibility
+var convert_1 = require("./meta-object/convert");
+Object.defineProperty(exports, "convertFromMetaSchema", { enumerable: true, get: function () { return convert_1.convertFromMetaSchema; } });
+var validate_1 = require("./meta-object/validate");
+Object.defineProperty(exports, "validateMetaObject", { enumerable: true, get: function () { return validate_1.validateMetaObject; } });
+// Generators (buildSelect, buildFindOne, buildCount, mutations, field-selector, naming-helpers)
+__exportStar(require("./generators"), exports);
+// Client utilities (TypedDocumentString, error handling, execute)
+__exportStar(require("./client"), exports);
+// Introspection utilities (infer-tables, transform, transform-schema, schema-query)
+__exportStar(require("./introspect"), exports);
+// Utility functions
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "stripSmartComments", { enumerable: true, get: function () { return utils_1.stripSmartComments; } });

package/introspect/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Introspection barrel export
+ *
+ * Re-exports introspection utilities for converting GraphQL schemas to CleanTable format.
+ */
+export * from './infer-tables';
+export * from './transform';
+export * from './transform-schema';
+export * from './schema-query';

package/introspect/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Introspection barrel export
+ *
+ * Re-exports introspection utilities for converting GraphQL schemas to CleanTable format.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./infer-tables"), exports);
+__exportStar(require("./transform"), exports);
+__exportStar(require("./transform-schema"), exports);
+__exportStar(require("./schema-query"), exports);

package/introspect/infer-tables.d.ts

@@ -0,0 +1,42 @@
+import type { IntrospectionQueryResponse } from '../types/introspection';
+import type { CleanTable } from '../types/schema';
+/**
+ * PostGraphile naming patterns for type detection
+ */
+declare const PATTERNS: {
+    connection: RegExp;
+    edge: RegExp;
+    filter: RegExp;
+    condition: RegExp;
+    orderBy: RegExp;
+    patch: RegExp;
+    createInput: RegExp;
+    updateInput: RegExp;
+    deleteInput: RegExp;
+    createPayload: RegExp;
+    updatePayload: RegExp;
+    deletePayload: RegExp;
+    createMutation: RegExp;
+    updateMutation: RegExp;
+    deleteMutation: RegExp;
+};
+export interface InferTablesOptions {
+    /**
+     * Custom pattern overrides (for non-standard PostGraphile configurations)
+     */
+    patterns?: Partial<typeof PATTERNS>;
+    /**
+     * Include PostgreSQL COMMENT descriptions on tables and fields.
+     * @default true
+     */
+    comments?: boolean;
+}
+/**
+ * Infer CleanTable[] from GraphQL introspection by recognizing PostGraphile patterns
+ *
+ * @param introspection - Standard GraphQL introspection response
+ * @param options - Optional configuration
+ * @returns Array of CleanTable objects compatible with existing generators
+ */
+export declare function inferTablesFromIntrospection(introspection: IntrospectionQueryResponse, options?: InferTablesOptions): CleanTable[];
+export {};