@graphoria/server 0.2.0 → 0.2.1

package/src/databases/transformers/graphqlName.ts

@@ -0,0 +1,28 @@
+/**
+ * Maps a SQL identifier onto a legal GraphQL name (`/^[_A-Za-z][_0-9A-Za-z]*$/`).
+ *
+ * PostgreSQL, MySQL and SQL Server all accept identifiers GraphQL cannot spell —
+ * spaces, accents, punctuation — and an unmapped one produces an SDL document
+ * that fails to parse, taking the whole server down at boot.
+ *
+ * A name that is already legal is returned unchanged, so this cannot rename a
+ * field in any schema that boots today. Runs of illegal characters are not
+ * collapsed, and diacritics fold to their base letter rather than being dropped,
+ * both so that distinct identifiers stay distinct as often as possible.
+ */
+export const sanitizeGraphQLName = (name: string): string => {
+  const folded = name.normalize("NFD").replace(/[̀-ͯ]/g, "");
+  const replaced = folded.replace(/[^_0-9A-Za-z]/g, "_");
+
+  if (replaced.length === 0) return "_";
+
+  return /^[0-9]/.test(replaced) ? `_${replaced}` : replaced;
+};
+
+/**
+ * The GraphQL field a column is exposed as. Introspected columns carry a
+ * `fieldName` computed once at parse time; virtual columns come from
+ * configuration and carry only a name, so they are sanitised on the spot.
+ */
+export const columnFieldName = (column: { name: string; fieldName?: string }): string =>
+  column.fieldName ?? sanitizeGraphQLName(column.name);

package/src/types/zod/db.ts

@@ -8,6 +8,7 @@ import {
   TableRelationshipZod as TableRelationshipBaseZod,
 } from "../../config";
 import { genResolverName } from "../../databases/transformers/genResolverName";
+import { sanitizeGraphQLName } from "../../databases/transformers/graphqlName";
 
 // Re-export base types and schemas from the config module
 export type {
@@ -43,6 +44,9 @@ export const TableColumnZod = z
   })
   .transform((val) => ({
     name: val.name,
+    // The SQL identifier stays in `name`; `fieldName` is what GraphQL exposes it as.
+    // Nothing emitting SQL may read `fieldName`, nothing emitting SDL may read `name`.
+    fieldName: sanitizeGraphQLName(val.name),
     dataType: val.dataType,
     isNullable: typeof val.isNullable === "boolean" ? val.isNullable : val.isNullable === 1,
     description: val.description ?? null,