@lakeql/schema-generator 0.4.6 → 1.0.0

package/dist/endpoint-schema.d.mts

@@ -1,34 +1,28 @@
 import { z } from "zod";
-//#region src/endpoint-schema.d.ts
+import { LoadStrategy, LoadStrategy as LoadStrategy$1 } from "@lakeql/datasource";
 /**
  * Regex pattern for field names: alphanumeric + underscore, no leading digit, max 64 chars.
  */
-declare const fieldNamePattern: RegExp;
+export declare const fieldNamePattern: RegExp;
 /**
  * Regex pattern for metadata fields (tableName, catalog, schema): alphanumeric + underscore,
  * no leading digit, max 128 chars.
  */
-declare const metadataFieldPattern: RegExp;
+export declare const metadataFieldPattern: RegExp;
 /**
  * Supported load strategies for the mutation write pipeline.
  */
-declare const loadStrategies: readonly ["full_load", "full_load_append", "append"];
-type LoadStrategy = (typeof loadStrategies)[number];
-/**
- * Supported storage adapter types.
- */
-declare const storageTypes: readonly ["s3", "minio"];
-type StorageType = (typeof storageTypes)[number];
+export declare const loadStrategies: readonly ["full_load", "full_load_append", "append"];
 /**
  * Supported partitioning format granularities.
  */
-declare const partitioningFormats: readonly ["year", "year/month", "year/month/day"];
-type PartitioningFormat = (typeof partitioningFormats)[number];
+export declare const partitioningFormats: readonly ["year", "year/month", "year/month/day"];
+export type PartitioningFormat = (typeof partitioningFormats)[number];
 /**
  * Supported date components for custom partition format segments.
  */
-declare const partitioningComponents: readonly ["year", "month", "day", "hour", "minute", "second"];
-type PartitioningComponent = (typeof partitioningComponents)[number];
+export declare const partitioningComponents: readonly ["year", "month", "day", "hour", "minute", "second"];
+export type PartitioningComponent = (typeof partitioningComponents)[number];
 /**
  * Validates a custom partitioning format string.
  * - If the value contains no `/` and no `:`, it must match fieldNamePattern (legacy single-field mode).
@@ -39,33 +33,22 @@ type PartitioningComponent = (typeof partitioningComponents)[number];
  *
  * Returns null if valid, or an error message string if invalid.
  */
-declare function validatePartitioningFormat(value: string): string | null;
+export declare function validatePartitioningFormat(value: string): string | null;
 /**
  * Partitioning configuration value:
  * - true: partition by write timestamp (default)
  * - false: no partitioning (flat layout)
  * - string: partition by named field
  */
-type PartitioningValue = boolean | string;
+export type PartitioningValue = boolean | string;
 /**
  * Mutation pipeline configuration for an endpoint.
  */
-interface MutationConfig {
+export interface MutationConfig {
   /** Load strategy for the write pipeline. */
-  loadStrategy: LoadStrategy;
-  /**
-   * Storage adapter type.
-   * @default "s3"
-   */
-  type: StorageType;
-  /** S3/MinIO bucket name for endpoint data. */
-  bucket: string;
+  loadStrategy: LoadStrategy$1;
   /** Base path for endpoint data. */
   basePath: string;
-  /** Optional region override (falls back to AWS_DEFAULT_REGION env var for S3). */
-  region?: string;
-  /** Optional custom endpoint. Required for MinIO, optional for S3. */
-  endpoint?: string;
   /**
    * Partitioning mode. `true` partitions by write timestamp, `false` disables partitioning, or a string for field-based/custom partitioning.
    * @default true
@@ -80,52 +63,38 @@ interface MutationConfig {
 /**
  * Zod schema for the mutation configuration object.
  */
-declare const mutationConfigSchema: z.ZodObject<{
+export declare const mutationConfigSchema: z.ZodObject<{
   loadStrategy: z.ZodEnum<{
     full_load: "full_load";
     full_load_append: "full_load_append";
     append: "append";
   }>;
-  type: z.ZodDefault<z.ZodEnum<{
-    s3: "s3";
-    minio: "minio";
-  }>>;
-  bucket: z.ZodString;
   basePath: z.ZodString;
-  region: z.ZodOptional<z.ZodString>;
-  endpoint: z.ZodOptional<z.ZodString>;
   partitioning: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
   partitioningFormat: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
  * Zod schema for the mutation field: either `false` (disabled) or a config object (enabled).
  */
-declare const mutationSchema: z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
+export declare const mutationSchema: z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
   loadStrategy: z.ZodEnum<{
     full_load: "full_load";
     full_load_append: "full_load_append";
     append: "append";
   }>;
-  type: z.ZodDefault<z.ZodEnum<{
-    s3: "s3";
-    minio: "minio";
-  }>>;
-  bucket: z.ZodString;
   basePath: z.ZodString;
-  region: z.ZodOptional<z.ZodString>;
-  endpoint: z.ZodOptional<z.ZodString>;
   partitioning: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
   partitioningFormat: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>]>;
 /**
  * Supported primitive types for field definitions.
  */
-declare const primitiveTypes: readonly ["String", "Integer", "Float", "Boolean", "Date", "DateTime"];
-type PrimitiveType = (typeof primitiveTypes)[number];
+export declare const primitiveTypes: readonly ["String", "Integer", "Float", "Boolean", "Date", "DateTime"];
+export type PrimitiveType = (typeof primitiveTypes)[number];
 /**
  * Field-level validation refinement types.
  */
-type FieldValidation = {
+export type FieldValidation = {
   type: "email";
 } | {
   type: "url";
@@ -144,7 +113,7 @@ type FieldValidation = {
 /**
  * Field-level options for mutation input validation.
  */
-interface FieldOptions {
+export interface FieldOptions {
   /**
    * Whether the field is required in mutation input.
    * @default false
@@ -164,16 +133,16 @@ interface FieldOptions {
 /**
  * Zod schema for field validation refinements.
  */
-declare const fieldValidationSchema: z.ZodType<FieldValidation>;
+export declare const fieldValidationSchema: z.ZodType<FieldValidation>;
 /**
  * Zod schema for field-level options.
  */
-declare const fieldOptionsSchema: z.ZodType<FieldOptions>;
-interface ArrayItemDefinition {
+export declare const fieldOptionsSchema: z.ZodType<FieldOptions>;
+export interface ArrayItemDefinition {
   type: PrimitiveType | "Object";
   fields?: FieldDefinition[];
 }
-interface FieldDefinition {
+export interface FieldDefinition {
   name: string;
   type: PrimitiveType | "Object" | "Array";
   fields?: FieldDefinition[];
@@ -184,15 +153,16 @@ interface FieldDefinition {
  * Zod schema for field definitions using a discriminated union on "type".
  * Supports recursive nesting via z.lazy for Object fields and Array items.
  */
-declare const fieldDefinitionSchema: z.ZodType<FieldDefinition>;
+export declare const fieldDefinitionSchema: z.ZodType<FieldDefinition>;
 /**
  * Zod schema for the complete endpoint definition format.
  */
-declare const endpointDefinitionSchema: z.ZodObject<{
+export declare const endpointDefinitionSchema: z.ZodObject<{
   version: z.ZodLiteral<"1.0">;
   tableName: z.ZodString;
   catalog: z.ZodString;
   schema: z.ZodString;
+  dataSource: z.ZodOptional<z.ZodString>;
   fields: z.ZodArray<z.ZodType<FieldDefinition, unknown, z.core.$ZodTypeInternals<FieldDefinition, unknown>>>;
   mutation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
     loadStrategy: z.ZodEnum<{
@@ -200,26 +170,18 @@ declare const endpointDefinitionSchema: z.ZodObject<{
       full_load_append: "full_load_append";
       append: "append";
     }>;
-    type: z.ZodDefault<z.ZodEnum<{
-      s3: "s3";
-      minio: "minio";
-    }>>;
-    bucket: z.ZodString;
     basePath: z.ZodString;
-    region: z.ZodOptional<z.ZodString>;
-    endpoint: z.ZodOptional<z.ZodString>;
     partitioning: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
     partitioningFormat: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>]>>;
 }, z.core.$strip>;
-type EndpointDefinitionFormat = z.infer<typeof endpointDefinitionSchema>;
+export type EndpointDefinitionFormat = z.infer<typeof endpointDefinitionSchema>;
 /**
  * Checks for duplicate field names at the same nesting level within a list of field definitions.
  * Returns an array of objects describing each duplicate found, including the field name and path.
  */
-declare function findDuplicateFieldNames(fields: FieldDefinition[], path?: string[]): {
+export declare function findDuplicateFieldNames(fields: FieldDefinition[], path?: string[]): {
   name: string;
   path: string[];
 }[];
-//#endregion
-export { ArrayItemDefinition, EndpointDefinitionFormat, FieldDefinition, FieldOptions, FieldValidation, LoadStrategy, MutationConfig, PartitioningComponent, PartitioningFormat, PartitioningValue, PrimitiveType, StorageType, endpointDefinitionSchema, fieldDefinitionSchema, fieldNamePattern, fieldOptionsSchema, fieldValidationSchema, findDuplicateFieldNames, loadStrategies, metadataFieldPattern, mutationConfigSchema, mutationSchema, partitioningComponents, partitioningFormats, primitiveTypes, storageTypes, validatePartitioningFormat };
+export type { LoadStrategy };

package/dist/endpoint-schema.mjs

@@ -1 +1 @@
-import{z as e}from"zod";const t=/^[a-zA-Z_][a-zA-Z0-9_]{0,63}$/u,n=/^[a-zA-Z_][a-zA-Z0-9_]{0,127}$/u,r=[`full_load`,`full_load_append`,`append`],i=[`s3`,`minio`],a=[`year`,`year/month`,`year/month/day`],o=[`year`,`month`,`day`,`hour`,`minute`,`second`];function s(e){if(!(e.includes(`/`)||e.includes(`:`)))return t.test(e)?null:`Invalid partition field name "${e}". Must match pattern: letters/underscores, no leading digit, max 64 chars.`;let n=e.split(`/`);for(let r of n){if(r===``)return`Invalid partition format: empty segment found in "${e}".`;if(r.includes(`:`)){let e=r.split(`:`);if(e.length!==2)return`Invalid partition segment "${r}": expected format "fieldname:component".`;let[n,i]=e;if(!t.test(n))return`Invalid field name "${n}" in partition segment "${r}".`;if(!o.includes(i))return`Invalid date component "${i}" in partition segment "${r}". Expected one of: ${o.join(`, `)}.`}else if(!t.test(r))return`Invalid field name "${r}" in partition format.`}return null}const c=e.object({loadStrategy:e.enum(r),type:e.enum(i).default(`s3`),bucket:e.string().min(1),basePath:e.string().min(1),region:e.string().optional(),endpoint:e.string().optional(),partitioning:e.union([e.boolean(),e.string().min(1)]).optional(),partitioningFormat:e.string().optional()}).superRefine((e,t)=>{if(e.type===`minio`&&!e.endpoint&&t.addIssue({code:`custom`,path:[`endpoint`],message:`Endpoint is required when storage type is 'minio'. Provide the MinIO server URL (e.g. http://minio:9000).`}),e.partitioning!==!1){if(typeof e.partitioning==`string`){let n=s(e.partitioning);if(n){t.addIssue({code:`custom`,path:[`partitioning`],message:n});return}if(e.partitioning.includes(`/`)||e.partitioning.includes(`:`))return}e.partitioningFormat!==void 0&&!a.includes(e.partitioningFormat)&&t.addIssue({code:`invalid_value`,values:[...a],path:[`partitioningFormat`],message:`Invalid partitioning format. Expected one of: ${a.join(`, `)}`})}}),l=e.union([e.literal(!1),c]),u=[`String`,`Integer`,`Float`,`Boolean`,`Date`,`DateTime`],d=e.union([e.object({type:e.literal(`email`)}),e.object({type:e.literal(`url`)}),e.object({type:e.literal(`uuid`)}),e.object({type:e.literal(`min`),value:e.number()}),e.object({type:e.literal(`max`),value:e.number()}),e.object({type:e.literal(`regex`),pattern:e.string()})]),f=e.object({required:e.boolean().optional(),validations:e.array(d).optional(),readOnly:e.boolean().optional()}),p=e.lazy(()=>e.discriminatedUnion(`type`,[e.object({name:e.string().regex(t),type:e.literal(`String`),options:f.optional()}),e.object({name:e.string().regex(t),type:e.literal(`Integer`),options:f.optional()}),e.object({name:e.string().regex(t),type:e.literal(`Float`),options:f.optional()}),e.object({name:e.string().regex(t),type:e.literal(`Boolean`),options:f.optional()}),e.object({name:e.string().regex(t),type:e.literal(`Date`),options:f.optional()}),e.object({name:e.string().regex(t),type:e.literal(`DateTime`),options:f.optional()}),e.object({name:e.string().regex(t),type:e.literal(`Object`),fields:e.array(p).min(1),options:f.optional()}),e.object({name:e.string().regex(t),type:e.literal(`Array`),items:e.union([e.object({type:e.enum(u)}),e.object({type:e.literal(`Object`),fields:e.array(p).min(1)})]),options:f.optional()})])),m=e.object({version:e.literal(`1.0`),tableName:e.string().regex(n),catalog:e.string().regex(n),schema:e.string().regex(n),fields:e.array(p),mutation:l.optional()});function h(e,t=[]){let n=[],r=new Set;for(let i of e)r.has(i.name)?n.push({name:i.name,path:t}):r.add(i.name),i.type===`Object`&&i.fields&&n.push(...h(i.fields,[...t,i.name])),i.type===`Array`&&i.items?.type===`Object`&&i.items.fields&&n.push(...h(i.items.fields,[...t,i.name,`items`]));return n}export{m as endpointDefinitionSchema,p as fieldDefinitionSchema,t as fieldNamePattern,f as fieldOptionsSchema,d as fieldValidationSchema,h as findDuplicateFieldNames,r as loadStrategies,n as metadataFieldPattern,c as mutationConfigSchema,l as mutationSchema,o as partitioningComponents,a as partitioningFormats,u as primitiveTypes,i as storageTypes,s as validatePartitioningFormat};
+import{z as e}from"zod";const t=/^[a-zA-Z_][a-zA-Z0-9_]{0,63}$/u,n=/^[a-zA-Z_][a-zA-Z0-9_]{0,127}$/u,r=[`full_load`,`full_load_append`,`append`],i=[`year`,`year/month`,`year/month/day`],a=[`year`,`month`,`day`,`hour`,`minute`,`second`];function o(e){if(!(e.includes(`/`)||e.includes(`:`)))return t.test(e)?null:`Invalid partition field name "${e}". Must match pattern: letters/underscores, no leading digit, max 64 chars.`;let n=e.split(`/`);for(let r of n){if(r===``)return`Invalid partition format: empty segment found in "${e}".`;if(r.includes(`:`)){let e=r.split(`:`);if(e.length!==2)return`Invalid partition segment "${r}": expected format "fieldname:component".`;let[n,i]=e;if(!t.test(n))return`Invalid field name "${n}" in partition segment "${r}".`;if(!a.includes(i))return`Invalid date component "${i}" in partition segment "${r}". Expected one of: ${a.join(`, `)}.`}else if(!t.test(r))return`Invalid field name "${r}" in partition format.`}return null}const s=e.object({loadStrategy:e.enum(r),basePath:e.string().min(1),partitioning:e.union([e.boolean(),e.string().min(1)]).optional(),partitioningFormat:e.string().optional()}).superRefine((e,t)=>{if(e.partitioning!==!1){if(typeof e.partitioning==`string`){let n=o(e.partitioning);if(n){t.addIssue({code:`custom`,path:[`partitioning`],message:n});return}if(e.partitioning.includes(`/`)||e.partitioning.includes(`:`))return}e.partitioningFormat!==void 0&&!i.includes(e.partitioningFormat)&&t.addIssue({code:`invalid_value`,values:[...i],path:[`partitioningFormat`],message:`Invalid partitioning format. Expected one of: ${i.join(`, `)}`})}}),c=e.union([e.literal(!1),s]),l=[`String`,`Integer`,`Float`,`Boolean`,`Date`,`DateTime`],u=e.union([e.object({type:e.literal(`email`)}),e.object({type:e.literal(`url`)}),e.object({type:e.literal(`uuid`)}),e.object({type:e.literal(`min`),value:e.number()}),e.object({type:e.literal(`max`),value:e.number()}),e.object({type:e.literal(`regex`),pattern:e.string()})]),d=e.object({required:e.boolean().optional(),validations:e.array(u).optional(),readOnly:e.boolean().optional()}),f=e.lazy(()=>e.discriminatedUnion(`type`,[e.object({name:e.string().regex(t),type:e.literal(`String`),options:d.optional()}),e.object({name:e.string().regex(t),type:e.literal(`Integer`),options:d.optional()}),e.object({name:e.string().regex(t),type:e.literal(`Float`),options:d.optional()}),e.object({name:e.string().regex(t),type:e.literal(`Boolean`),options:d.optional()}),e.object({name:e.string().regex(t),type:e.literal(`Date`),options:d.optional()}),e.object({name:e.string().regex(t),type:e.literal(`DateTime`),options:d.optional()}),e.object({name:e.string().regex(t),type:e.literal(`Object`),fields:e.array(f).min(1),options:d.optional()}),e.object({name:e.string().regex(t),type:e.literal(`Array`),items:e.union([e.object({type:e.enum(l)}),e.object({type:e.literal(`Object`),fields:e.array(f).min(1)})]),options:d.optional()})])),p=e.object({version:e.literal(`1.0`),tableName:e.string().regex(n),catalog:e.string().regex(n),schema:e.string().regex(n),dataSource:e.string().min(1).optional(),fields:e.array(f),mutation:c.optional()});function m(e,t=[]){let n=[],r=/* @__PURE__ */ new Set;for(let i of e)r.has(i.name)?n.push({name:i.name,path:t}):r.add(i.name),i.type===`Object`&&i.fields&&n.push(...m(i.fields,[...t,i.name])),i.type===`Array`&&i.items?.type===`Object`&&i.items.fields&&n.push(...m(i.items.fields,[...t,i.name,`items`]));return n}export{p as endpointDefinitionSchema,f as fieldDefinitionSchema,t as fieldNamePattern,d as fieldOptionsSchema,u as fieldValidationSchema,m as findDuplicateFieldNames,r as loadStrategies,n as metadataFieldPattern,s as mutationConfigSchema,c as mutationSchema,a as partitioningComponents,i as partitioningFormats,l as primitiveTypes,o as validatePartitioningFormat};

package/dist/graphql-schema.d.mts

@@ -1,6 +1,5 @@
 import { JSONSchema7 } from "json-schema";
-//#region src/graphql-schema.d.ts
-interface CurrentModelResponse {
+export interface CurrentModelResponse {
   name: string;
   rawFieldName: string;
   transformed: boolean;
@@ -12,7 +11,7 @@ interface CurrentModelResponse {
   nullable: boolean;
   filter: boolean;
 }
-interface ModelResponse {
+export interface ModelResponse {
   root: boolean;
   modelName: string;
   interfaceName: string;
@@ -20,11 +19,11 @@ interface ModelResponse {
   transformFields: string[][];
   dateTimeFields: string[];
 }
-interface FilterFieldInput {
+export interface FilterFieldInput {
   name: string;
   type: string;
 }
-type FieldDefinitionResponse = {
+export type FieldDefinitionResponse = {
   graphqlType: string;
   graphqlTplType: string;
   interfaceType: string;
@@ -44,7 +43,7 @@ type FieldDefinitionResponse = {
 /**
  * Parameters for generateModel.
  */
-interface GenerateModelProps {
+export interface GenerateModelProps {
   /** The JSON Schema source definition to generate a model from. */
   source: JSONSchema7;
   /** The name of the model being generated. */
@@ -59,15 +58,15 @@ interface GenerateModelProps {
 /**
  * Sanitizes a raw field name into a valid GraphQL/TypeScript identifier-like key.
  */
-declare function sanitizeFieldName(rawFieldName: string): string;
+export declare function sanitizeFieldName(rawFieldName: string): string;
 /**
  * Generates a GraphQL model definition from JSON Schema.
  */
-declare const generateModel: ({ source, name, parent, models, isRoot }: GenerateModelProps) => Record<string, ModelResponse>;
+export declare const generateModel: ({ source, name, parent, models, isRoot }: GenerateModelProps) => Record<string, ModelResponse>;
 /**
  * Parameters for generateFieldDefinition.
  */
-interface GenerateFieldDefinitionProps {
+export interface GenerateFieldDefinitionProps {
   /** The sanitized field name. */
   fieldName: string;
   /** The original raw field name from the schema. */
@@ -80,6 +79,4 @@ interface GenerateFieldDefinitionProps {
 /**
  * Generates field definitions for a single model property.
  */
-declare const generateFieldDefinition: ({ fieldName, rawFieldName, fieldDefinition, parent }: GenerateFieldDefinitionProps) => FieldDefinitionResponse;
-//#endregion
-export { CurrentModelResponse, FieldDefinitionResponse, FilterFieldInput, GenerateFieldDefinitionProps, GenerateModelProps, ModelResponse, generateFieldDefinition, generateModel, sanitizeFieldName };
+export declare const generateFieldDefinition: ({ fieldName, rawFieldName, fieldDefinition, parent }: GenerateFieldDefinitionProps) => FieldDefinitionResponse;

package/dist/graphql-schema.mjs

@@ -1 +1 @@
-import e from"@lakeql/helpers/special-characters";import{capitalize as t,omit as n}from"lodash-es";function r(t){let n=e(t).replaceAll(/[^a-zA-Z0-9_]/gu,`_`).replaceAll(/_+/gu,`_`).replaceAll(/^_+|_+$/gu,``);return n.length===0?`field`:n.replace(/^(?<digit>\d)/u,`_$<digit>`)}function i(e,t,n){if(!t.has(e))return t.add(e),e;throw Error(`Field name collision after normalization: "${n}" -> "${e}".`)}const a=({source:e,name:s,parent:c,models:l={},isRoot:u=!0})=>{let d=n(e,[`additionalProperties`]),f={...l},p=new Set,m={};for(let[e,t]of Object.entries(d.properties)){let n=i(r(e),p,e),l=o({fieldDefinition:t,fieldName:n,parent:c??s,rawFieldName:e});m[n]={filter:l.filter,graphqlTplType:l.graphqlTplType,graphqlType:l.graphqlType,interfaceName:l.interfaceName,interfaceType:l.interfaceType,isArray:l.isArray??!1,name:n,nullable:!0,rawFieldName:e,transformed:n!==e},l.subModel!==!1&&Object.assign(f,a({isRoot:!1,models:f,name:n,parent:c??s,source:l.subModel}))}let h=u?s:`${c}_${t(s)}`;return f[h]={dateTimeFields:Object.values(m).filter(e=>e.graphqlType===`DateTime`).map(e=>e.rawFieldName),fields:m,interfaceName:`${h}Interface`,modelName:h,root:u,transformFields:Object.values(m).filter(e=>e.transformed).map(e=>[e.name,e.rawFieldName])},f},o=({fieldName:e,rawFieldName:n,fieldDefinition:r,parent:i})=>{let a=t(e);switch(r.type){case`string`:switch(r.format){case`date`:return{filter:!0,graphqlTplType:`'Date'`,graphqlType:`Date`,interfaceType:`Date`,subModel:!1};case`date-time`:return{filter:!0,graphqlTplType:`'DateTime'`,graphqlType:`DateTime`,interfaceType:`Date`,subModel:!1};default:return{filter:!0,graphqlTplType:`'String'`,graphqlType:`String`,interfaceType:`string`,subModel:!1}}case`number`:return{filter:!0,graphqlTplType:`'Float'`,graphqlType:`Float`,interfaceType:`number`,subModel:!1};case`integer`:return{filter:!0,graphqlTplType:`'Int'`,graphqlType:`Int`,interfaceType:`number`,subModel:!1};case`boolean`:return{filter:!0,graphqlTplType:`'Boolean'`,graphqlType:`Boolean`,interfaceType:`boolean`,subModel:!1};case`array`:if(r.items.type!==`object`){let t=o({fieldDefinition:r.items,fieldName:e,rawFieldName:n});return{filter:!1,graphqlTplType:`['${t.graphqlType}']`,graphqlType:`[${t.graphqlType}]`,interfaceType:`${t.interfaceType}[]`,isArray:!0,subModel:!1}}return{filter:!1,graphqlTplType:`[${i}_${a}]`,graphqlType:`[${i}_${a}]`,interfaceName:`${i}_${a}Interface[]`,interfaceType:`${i}_${a}[]`,isArray:!0,subModel:r.items};case`object`:return{filter:!1,graphqlTplType:`${i}_${a}`,graphqlType:`${i}_${a}`,interfaceName:`${i}_${a}Interface`,interfaceType:`${i}_${a}`,subModel:r};default:return{filter:!1,graphqlTplType:`Null`,graphqlType:`Null`,interfaceType:`null`,subModel:!1}}};export{o as generateFieldDefinition,a as generateModel,r as sanitizeFieldName};
+import e from"@lakeql/helpers/special-characters";import{toCapitalize as t}from"@lakeql/helpers/string-case";import{omit as n}from"es-toolkit";function r(t){let n=e(t).replaceAll(/[^a-zA-Z0-9_]/gu,`_`).replaceAll(/_+/gu,`_`).replaceAll(/^_+|_+$/gu,``);return n.length===0?`field`:n.replace(/^(?<digit>\d)/u,`_$<digit>`)}function i(e,t,n){if(!t.has(e))return t.add(e),e;throw Error(`Field name collision after normalization: "${n}" -> "${e}".`)}const a=({source:e,name:s,parent:c,models:l={},isRoot:u=!0})=>{let d=n(e,[`additionalProperties`]),f={...l},p=/* @__PURE__ */ new Set,m={};for(let[e,t]of Object.entries(d.properties)){let n=i(r(e),p,e),l=o({fieldDefinition:t,fieldName:n,parent:c??s,rawFieldName:e});m[n]={filter:l.filter,graphqlTplType:l.graphqlTplType,graphqlType:l.graphqlType,interfaceName:l.interfaceName,interfaceType:l.interfaceType,isArray:l.isArray??!1,name:n,nullable:!0,rawFieldName:e,transformed:n!==e},l.subModel!==!1&&Object.assign(f,a({isRoot:!1,models:f,name:n,parent:c??s,source:l.subModel}))}let h=u?s:`${c}_${t(s)}`;return f[h]={dateTimeFields:Object.values(m).filter(e=>e.graphqlType===`DateTime`).map(e=>e.rawFieldName),fields:m,interfaceName:`${h}Interface`,modelName:h,root:u,transformFields:Object.values(m).filter(e=>e.transformed).map(e=>[e.name,e.rawFieldName])},f},o=({fieldName:e,rawFieldName:n,fieldDefinition:r,parent:i})=>{let a=t(e);switch(r.type){case`string`:switch(r.format){case`date`:return{filter:!0,graphqlTplType:`'Date'`,graphqlType:`Date`,interfaceType:`Date`,subModel:!1};case`date-time`:return{filter:!0,graphqlTplType:`'DateTime'`,graphqlType:`DateTime`,interfaceType:`Date`,subModel:!1};default:return{filter:!0,graphqlTplType:`'String'`,graphqlType:`String`,interfaceType:`string`,subModel:!1}}case`number`:return{filter:!0,graphqlTplType:`'Float'`,graphqlType:`Float`,interfaceType:`number`,subModel:!1};case`integer`:return{filter:!0,graphqlTplType:`'Int'`,graphqlType:`Int`,interfaceType:`number`,subModel:!1};case`boolean`:return{filter:!0,graphqlTplType:`'Boolean'`,graphqlType:`Boolean`,interfaceType:`boolean`,subModel:!1};case`array`:if(r.items.type!==`object`){let t=o({fieldDefinition:r.items,fieldName:e,rawFieldName:n});return{filter:!1,graphqlTplType:`['${t.graphqlType}']`,graphqlType:`[${t.graphqlType}]`,interfaceType:`${t.interfaceType}[]`,isArray:!0,subModel:!1}}return{filter:!1,graphqlTplType:`[${i}_${a}]`,graphqlType:`[${i}_${a}]`,interfaceName:`${i}_${a}Interface[]`,interfaceType:`${i}_${a}[]`,isArray:!0,subModel:r.items};case`object`:return{filter:!1,graphqlTplType:`${i}_${a}`,graphqlType:`${i}_${a}`,interfaceName:`${i}_${a}Interface`,interfaceType:`${i}_${a}`,subModel:r};default:return{filter:!1,graphqlTplType:`Null`,graphqlType:`Null`,interfaceType:`null`,subModel:!1}}};export{o as generateFieldDefinition,a as generateModel,r as sanitizeFieldName};

package/dist/hive-table.d.mts

@@ -1,5 +1,4 @@
 import { JSONSchema7 } from "json-schema";
-//#region src/hive-table.d.ts
 type SqlFieldDefinition = [string, string];
 interface SchemaDefinition {
   type: string;
@@ -15,29 +14,29 @@ type ParquetField = Record<string, string | [string, ParquetField] | [string, {
 /**
  * Parameters for generateSqlSchema.
  */
-interface GenerateSqlSchemaProps {
+export interface GenerateSqlSchemaProps {
   /** The JSON Schema property definitions to generate SQL columns from. */
   definition: Record<string, SchemaDefinition>;
 }
 /**
  * Generates SQL column definitions from parsed columns.
  */
-declare function generateSqlSchema({ definition }: GenerateSqlSchemaProps): SqlFieldDefinition[];
+export declare function generateSqlSchema({ definition }: GenerateSqlSchemaProps): SqlFieldDefinition[];
 /**
  * Parameters for parquetTransformer.
  */
-interface ParquetTransformerProps {
+export interface ParquetTransformerProps {
   /** The JSON Schema property definitions to transform for Parquet format. */
   definition: Record<string, JSONSchema7>;
 }
 /**
  * Transforms column definitions for Parquet format.
  */
-declare function parquetTransformer({ definition }: ParquetTransformerProps): ParquetField;
+export declare function parquetTransformer({ definition }: ParquetTransformerProps): ParquetField;
 /**
  * Parameters for generateCreateTableStatement.
  */
-interface GenerateCreateTableStatementProps {
+export interface GenerateCreateTableStatementProps {
   /** The Hive schema name. */
   schema: string;
   /** The table name. */
@@ -52,6 +51,5 @@ interface GenerateCreateTableStatementProps {
 /**
  * Generates a full CREATE TABLE DDL statement.
  */
-declare function generateCreateTableStatement({ schema, tableName, bucketName, bucketPath, definition }: GenerateCreateTableStatementProps): string;
-//#endregion
-export { GenerateCreateTableStatementProps, GenerateSqlSchemaProps, ParquetTransformerProps, generateCreateTableStatement, generateSqlSchema, parquetTransformer };
+export declare function generateCreateTableStatement({ schema, tableName, bucketName, bucketPath, definition }: GenerateCreateTableStatementProps): string;
+export {};

package/dist/json-schema.d.mts

@@ -1,8 +1,7 @@
 import { FieldDefinition } from "./endpoint-schema.mjs";
 import { JSONSchema7 } from "json-schema";
 import { JSONType } from "json-column-parser/lib/common/types/type.common";
-//#region src/json-schema.d.ts
-declare function generateJsonSchema(parsedColumns: Record<string, JSONType>): JSONSchema7;
+export declare function generateJsonSchema(parsedColumns: Record<string, JSONType>): JSONSchema7;
 /**
  * Converts an array of FieldDefinitions to a complete JSON Schema Draft-07 document.
  *
@@ -18,6 +17,4 @@ declare function generateJsonSchema(parsedColumns: Record<string, JSONType>): JS
  * - Array (primitive) → {type: "array", items: {primitive schema}}
  * - Array (object) → {type: "array", items: {type: "object", properties: {...}, additionalProperties: false}}
  */
-declare function generateJsonSchemaFromFields(fields: FieldDefinition[]): JSONSchema7;
-//#endregion
-export { generateJsonSchema, generateJsonSchemaFromFields };
+export declare function generateJsonSchemaFromFields(fields: FieldDefinition[]): JSONSchema7;

package/dist/json-schema.mjs

@@ -1 +1 @@
-import{isObject as e}from"@lakeql/helpers/object-helper";import{createRegExp as t,global as n,not as r}from"magic-regexp";function i(e){return{$schema:`https://json-schema.org/draft-07/schema#`,...s(e),additionalProperties:!1}}function a(e){let i=t(r.letter,[n]),a=e.toString().replace(i,``);switch(a){case`varchar`:return{type:`string`};case`decimal`:case`double`:case`float`:return{type:`number`};case`integer`:case`bigint`:return{type:`integer`};case`boolean`:return{type:`boolean`};case`timestamp`:return{format:`date-time`,type:`string`};case`date`:return{format:`date`,type:`string`};default:throw Error(`Type ${a.toString()} is unknown.`)}}function o(t){if(t.length>1)throw Error("We expect that an array has only one element ( e.g. a primitive like `varchar` or an object like `row()`.");if(Array.isArray(t[0]))throw TypeError(`We currently do not support 'array of array'. Feel free to raise an issue.`);if(typeof t[0]==`string`)return{items:a(t[0]),type:`array`};if(e(t[0]))return{items:s(t[0]),type:`array`};throw Error("Unexpected case in `json-generator.handleArray`")}function s(t){let n={additionalProperties:!1,properties:{},type:`object`};for(let[r,i]of Object.entries(t))typeof i==`string`&&(n.properties[r]=a(i)),Array.isArray(i)&&(n.properties[r]=o(i)),e(i)&&(n.properties[r]=s(i));return n}function c(e){switch(e){case`String`:return{type:`string`};case`Integer`:return{type:`integer`};case`Float`:return{type:`number`};case`Boolean`:return{type:`boolean`};case`Date`:return{type:`string`,format:`date`};case`DateTime`:return{type:`string`,format:`date-time`};default:return{type:`string`}}}function l(e){return e.type===`Object`&&e.fields?{type:`object`,properties:d(e.fields),additionalProperties:!1}:c(e.type)}function u(e){switch(e.type){case`Object`:return{type:`object`,properties:d(e.fields??[]),additionalProperties:!1};case`Array`:return{type:`array`,items:e.items?l(e.items):{type:`string`}};default:return c(e.type)}}function d(e){let t={};for(let n of e)t[n.name]=u(n);return t}function f(e){return{$schema:`https://json-schema.org/draft-07/schema#`,type:`object`,properties:d(e),additionalProperties:!1}}export{i as generateJsonSchema,f as generateJsonSchemaFromFields};
+import{isObject as e}from"@lakeql/helpers/object-helper";const t=/[^a-zA-Z]/gu;function n(e){return{$schema:`https://json-schema.org/draft-07/schema#`,...a(e),additionalProperties:!1}}function r(e){let n=e.toString().replaceAll(t,``);switch(n){case`varchar`:return{type:`string`};case`decimal`:case`double`:case`float`:return{type:`number`};case`integer`:case`bigint`:return{type:`integer`};case`boolean`:return{type:`boolean`};case`timestamp`:return{format:`date-time`,type:`string`};case`date`:return{format:`date`,type:`string`};default:throw Error(`Type ${n.toString()} is unknown.`)}}function i(t){if(t.length>1)throw Error("We expect that an array has only one element ( e.g. a primitive like `varchar` or an object like `row()`.");if(Array.isArray(t[0]))throw TypeError(`We currently do not support 'array of array'. Feel free to raise an issue.`);if(typeof t[0]==`string`)return{items:r(t[0]),type:`array`};if(e(t[0]))return{items:a(t[0]),type:`array`};throw Error("Unexpected case in `json-generator.handleArray`")}function a(t){let n={additionalProperties:!1,properties:{},type:`object`};for(let[o,s]of Object.entries(t))typeof s==`string`&&(n.properties[o]=r(s)),Array.isArray(s)&&(n.properties[o]=i(s)),e(s)&&(n.properties[o]=a(s));return n}function o(e){switch(e){case`String`:return{type:`string`};case`Integer`:return{type:`integer`};case`Float`:return{type:`number`};case`Boolean`:return{type:`boolean`};case`Date`:return{type:`string`,format:`date`};case`DateTime`:return{type:`string`,format:`date-time`};default:return{type:`string`}}}function s(e){return e.type===`Object`&&e.fields?{type:`object`,properties:l(e.fields),additionalProperties:!1}:o(e.type)}function c(e){switch(e.type){case`Object`:return{type:`object`,properties:l(e.fields??[]),additionalProperties:!1};case`Array`:return{type:`array`,items:e.items?s(e.items):{type:`string`}};default:return o(e.type)}}function l(e){let t={};for(let n of e)t[n.name]=c(n);return t}function u(e){return{$schema:`https://json-schema.org/draft-07/schema#`,type:`object`,properties:l(e),additionalProperties:!1}}export{n as generateJsonSchema,u as generateJsonSchemaFromFields};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lakeql/schema-generator",
-  "version": "0.4.6",
-  "description": "Generates GraphQL schemas, Hive table definitions, and JSON schemas from Trino metadata",
+  "version": "1.0.0",
+  "description": "Generates GraphQL schemas, Hive table definitions, and JSON schemas from data source metadata",
   "keywords": [
     "codegen",
     "graphql",
@@ -51,22 +51,21 @@
     }
   },
   "dependencies": {
-    "kysely": "0.29.4",
-    "lodash-es": "4.18.1",
-    "magic-regexp": "0.11.0",
-    "zod": "4.4.3",
-    "@lakeql/helpers": "0.1.7"
+    "@lakeql/datasource": "1.0.0",
+    "@lakeql/helpers": "1.0.0",
+    "es-toolkit": "1.53.2",
+    "zod": "4.6.7"
   },
   "devDependencies": {
+    "@lakeql/tsconfig": "0.1.0",
+    "@lakeql/vitest-config": "0.1.0",
     "@types/json-schema": "7.0.15",
-    "@types/lodash-es": "4.17.12",
-    "@types/node": "24.13.3",
-    "fast-check": "^4.9.0",
+    "@types/node": "24.19.2",
+    "fast-check": "4.10.2",
     "json-column-parser": "2.0.0",
-    "tsdown": "0.22.13",
+    "tsdown": "0.23.7",
     "typescript": "6.0.3",
-    "vitest": "4.1.10",
-    "@lakeql/tsconfig": "0.1.0"
+    "vitest": "5.1.0"
   },
   "scripts": {
     "build": "tsdown",