@constructive-io/graphql-query 3.21.1 → 3.22.0

package/esm/index.js

@@ -30,4 +30,4 @@ export * from './client';
 // Introspection utilities (infer-tables, transform, transform-schema, schema-query)
 export * from './introspect';
 // Utility functions
-export { stripSmartComments } from './utils';
+export { parseSmartTags, stripSmartComments } from './utils';

package/esm/introspect/infer-tables.js

@@ -13,7 +13,7 @@
  * - Mutation operations: create{Name}, update{Name}, delete{Name}
  */
 import { lcFirst, pluralize, singularize, ucFirst } from 'inflekt';
-import { stripSmartComments } from '../utils';
+import { parseSmartTags, stripSmartComments } from '../utils';
 import { getBaseTypeName, isList, isNonNull, unwrapType } from '../types/introspection';
 // ============================================================================
 // Pattern Matching Constants
@@ -203,6 +203,8 @@ function buildCleanTable(entityName, entityType, typeMap, queryFields, mutationF
     };
     // Extract description from entity type (PostgreSQL COMMENT), strip smart comments
     const description = commentsEnabled ? stripSmartComments(entityType.description) : undefined;
+    // Parse smart tags from raw description before they are stripped
+    const smartTags = parseSmartTags(entityType.description);
     return {
         table: {
             name: entityName,
@@ -212,6 +214,7 @@ function buildCleanTable(entityName, entityType, typeMap, queryFields, mutationF
             inflection,
             query,
             constraints,
+            ...(smartTags ? { smartTags } : {}),
         },
         hasRealOperation,
     };

package/esm/utils.js

@@ -67,3 +67,29 @@ export function stripSmartComments(description, enabled = true) {
         return undefined;
     return result;
 }
+/**
+ * Parse PostGraphile smart tags from a description string.
+ *
+ * Smart tags are lines starting with `@` in PostgreSQL COMMENTs.
+ * Each line is parsed as `@tagName` (boolean true) or `@tagName value`.
+ *
+ * Returns undefined if no smart tags are found.
+ */
+export function parseSmartTags(description) {
+    if (!description)
+        return undefined;
+    const lines = description.split('\n');
+    let tags;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith('@'))
+            continue;
+        const spaceIdx = trimmed.indexOf(' ');
+        const tagName = spaceIdx === -1 ? trimmed : trimmed.slice(0, spaceIdx);
+        const tagValue = spaceIdx === -1 ? true : trimmed.slice(spaceIdx + 1).trim();
+        if (!tags)
+            tags = {};
+        tags[tagName] = tagValue || true;
+    }
+    return tags;
+}

package/index.d.ts

@@ -20,4 +20,4 @@ export { validateMetaObject, type ValidationResult } from './meta-object/validat
 export * from './generators';
 export * from './client';
 export * from './introspect';
-export { stripSmartComments } from './utils';
+export { parseSmartTags, stripSmartComments } from './utils';

package/index.js

@@ -47,7 +47,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stripSmartComments = exports.validateMetaObject = exports.convertFromMetaSchema = exports.MetaObject = exports.createExecutor = exports.QueryExecutor = exports.QueryBuilder = void 0;
+exports.stripSmartComments = exports.parseSmartTags = 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; } });
@@ -75,4 +75,5 @@ __exportStar(require("./client"), exports);
 __exportStar(require("./introspect"), exports);
 // Utility functions
 var utils_1 = require("./utils");
+Object.defineProperty(exports, "parseSmartTags", { enumerable: true, get: function () { return utils_1.parseSmartTags; } });
 Object.defineProperty(exports, "stripSmartComments", { enumerable: true, get: function () { return utils_1.stripSmartComments; } });

package/introspect/infer-tables.js

@@ -206,6 +206,8 @@ function buildCleanTable(entityName, entityType, typeMap, queryFields, mutationF
     };
     // Extract description from entity type (PostgreSQL COMMENT), strip smart comments
     const description = commentsEnabled ? (0, utils_1.stripSmartComments)(entityType.description) : undefined;
+    // Parse smart tags from raw description before they are stripped
+    const smartTags = (0, utils_1.parseSmartTags)(entityType.description);
     return {
         table: {
             name: entityName,
@@ -215,6 +217,7 @@ function buildCleanTable(entityName, entityType, typeMap, queryFields, mutationF
             inflection,
             query,
             constraints,
+            ...(smartTags ? { smartTags } : {}),
         },
         hasRealOperation,
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-query",
-  "version": "3.21.1",
+  "version": "3.22.0",
   "description": "Constructive GraphQL Query",
   "author": "Constructive <developers@constructive.io>",
   "main": "index.js",
@@ -36,7 +36,7 @@
     "grafast": "1.0.0",
     "graphile-build-pg": "5.0.0",
     "graphile-config": "1.0.0",
-    "graphile-settings": "^4.30.2",
+    "graphile-settings": "^4.31.1",
     "graphql": "16.13.0",
     "inflection": "^3.0.0",
     "inflekt": "^0.7.1",
@@ -53,5 +53,5 @@
   "devDependencies": {
     "makage": "^0.3.0"
   },
-  "gitHead": "0fcb26c8f3379de5c2bf486e7ad78bb61a76e497"
+  "gitHead": "90016935b53d6fb84e0b83879377f0c2eb9abce6"
 }

package/types/schema.d.ts

@@ -17,6 +17,8 @@ export interface Table {
     query?: TableQueryNames;
     /** Constraint information */
     constraints?: TableConstraints;
+    /** Smart tags parsed from PostGraphile @-prefixed comment directives */
+    smartTags?: Record<string, string | true>;
 }
 /**
  * PostGraphile-generated names for this table

package/utils.d.ts

@@ -15,3 +15,12 @@
  * @returns Cleaned description, or undefined if empty/boilerplate
  */
 export declare function stripSmartComments(description: string | null | undefined, enabled?: boolean): string | undefined;
+/**
+ * Parse PostGraphile smart tags from a description string.
+ *
+ * Smart tags are lines starting with `@` in PostgreSQL COMMENTs.
+ * Each line is parsed as `@tagName` (boolean true) or `@tagName value`.
+ *
+ * Returns undefined if no smart tags are found.
+ */
+export declare function parseSmartTags(description: string | null | undefined): Record<string, string | true> | undefined;

package/utils.js

@@ -4,6 +4,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stripSmartComments = stripSmartComments;
+exports.parseSmartTags = parseSmartTags;
 /**
  * PostGraphile boilerplate description prefixes that should be suppressed
  */
@@ -70,3 +71,29 @@ function stripSmartComments(description, enabled = true) {
         return undefined;
     return result;
 }
+/**
+ * Parse PostGraphile smart tags from a description string.
+ *
+ * Smart tags are lines starting with `@` in PostgreSQL COMMENTs.
+ * Each line is parsed as `@tagName` (boolean true) or `@tagName value`.
+ *
+ * Returns undefined if no smart tags are found.
+ */
+function parseSmartTags(description) {
+    if (!description)
+        return undefined;
+    const lines = description.split('\n');
+    let tags;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith('@'))
+            continue;
+        const spaceIdx = trimmed.indexOf(' ');
+        const tagName = spaceIdx === -1 ? trimmed : trimmed.slice(0, spaceIdx);
+        const tagValue = spaceIdx === -1 ? true : trimmed.slice(spaceIdx + 1).trim();
+        if (!tags)
+            tags = {};
+        tags[tagName] = tagValue || true;
+    }
+    return tags;
+}