appflare 0.2.35 → 0.2.37

package/dist/index.d.mts

@@ -85,10 +85,37 @@ type LoadedAppflareConfig = {
     config: NormalizedAppflareConfig;
 };
 
-type ColumnType = "int" | "string" | "boolean" | "date";
+type ColumnType = "int" | "string" | "boolean" | "date" | "enum" | "json";
+type JsonShape = {
+    kind: "array";
+    element: JsonShape;
+} | {
+    kind: "object";
+    shape: Record<string, JsonShape>;
+} | {
+    kind: "string";
+} | {
+    kind: "number";
+} | {
+    kind: "boolean";
+} | {
+    kind: "date";
+} | {
+    kind: "unknown";
+};
+type EnumDefinition = {
+    kind: "enum";
+    name: string;
+    sqlName?: string;
+    values: readonly string[];
+};
 type ColumnBuilderOptions = {
     sqlName?: string;
     length?: number;
+    enumValues?: readonly string[];
+    enumRef?: string;
+    isArray?: boolean;
+    jsonShape?: JsonShape;
 };
 type PrimaryKeyOptions = {
     autoIncrement?: boolean;
@@ -153,6 +180,14 @@ type ColumnDefinition = {
     nowDefault?: boolean;
     runtimeDefaultFn?: () => unknown;
     references?: ColumnReference;
+    /** For enum columns: the allowed values. */
+    enumValues?: readonly string[];
+    /** For enum columns: reference to a named enum definition. */
+    enumRef?: string;
+    /** When true, the column stores an array of enum values. */
+    isArray?: boolean;
+    /** For JSON columns: the shape of the stored data. */
+    jsonShape?: JsonShape;
 };
 type OneRelationDefinition = {
     kind: "relation";
@@ -208,7 +243,21 @@ type TableDefinition = {
 type SchemaDefinition = {
     kind: "schema";
     tables: Record<string, TableDefinition>;
+    enums: Record<string, EnumDefinition>;
 };
+declare class EnumBuilder<T extends string> {
+    private def;
+    constructor(name: string, values: readonly T[]);
+    sql(name: string): EnumBuilder<T>;
+    toDefinition(): EnumDefinition;
+    getValues(): readonly T[];
+}
+declare class JsonArrayBuilder {
+    private _element;
+    constructor(element: JsonShape);
+    get shape(): JsonShape;
+    toColumnBuilder(): ColumnBuilder;
+}
 declare class ColumnBuilder {
     private definition;
     constructor(typeOrDefinition: ColumnType | ColumnDefinition, options?: ColumnBuilderOptions);
@@ -228,12 +277,19 @@ declare class ColumnBuilder {
      */
     defaultNow(): ColumnBuilder;
     references(table: string, column?: string, actions?: Pick<ColumnReference, "onDelete" | "onUpdate">): ColumnBuilder;
+    /** Marks the column as an array (e.g., for enum arrays). */
+    array(): ColumnBuilder;
     toDefinition(): ColumnDefinition;
 }
 declare function table(shape: TableShape, options?: TableOptions): TableDefinition;
-declare function schema(tables: Record<string, TableDefinition>): SchemaDefinition;
+type SchemaOptions = {
+    enums?: Record<string, EnumDefinition>;
+};
+declare function schema(tables: Record<string, TableDefinition>, options?: SchemaOptions): SchemaDefinition;
 declare function isSchemaDefinition(value: unknown): value is SchemaDefinition;
 declare const v: {
+    /** Define a reusable enum that can be referenced by multiple columns. */
+    defineEnum: <T extends string>(name: string, values: readonly T[]) => EnumBuilder<T>;
     int: (options?: ColumnBuilderOptions) => ColumnBuilder;
     number: (options?: ColumnBuilderOptions) => ColumnBuilder;
     string: (options?: ColumnBuilderOptions) => ColumnBuilder;
@@ -245,6 +301,29 @@ declare const v: {
      * `crypto.randomUUID()` at runtime (no SQL sequence).
      */
     uuid: (options?: ColumnBuilderOptions) => ColumnBuilder;
+    /**
+     * Enum column builder.
+     * Pass an EnumBuilder (from v.defineEnum) or inline values.
+     */
+    enum: <T extends string>(valuesOrEnum: readonly T[] | EnumBuilder<T>, options?: ColumnBuilderOptions) => ColumnBuilder;
+    /**
+     * Enum array column builder.
+     * Stores multiple enum values in a single column.
+     */
+    enumArray: <T extends string>(valuesOrEnum: readonly T[] | EnumBuilder<T>, options?: ColumnBuilderOptions) => ColumnBuilder;
+    /**
+     * JSON array column builder.
+     * Stored as JSON text, auto-serialized on insert/query.
+     * Use v.string(), v.number(), v.object(), or v.array() as the element type.
+     * Example: v.array(v.string()), v.array(v.object({ name: v.string() }))
+     */
+    array: (element: JsonArrayBuilder | ColumnBuilder) => ColumnBuilder;
+    /**
+     * JSON object column builder.
+     * Stored as JSON text, auto-serialized on insert/query.
+     * Pass a shape record: v.object({ name: v.string(), count: v.number() })
+     */
+    object: <TShape extends Record<string, JsonShape | ColumnBuilder>>(shape: TShape) => ColumnBuilder;
     one: (targetTable: string, fieldOrOptions?: string | RelationOneOptions, options?: RelationOneOptions) => OneRelationDefinition;
     many: (targetTable: string, fieldOrOptions?: string | RelationManyOptions, options?: RelationManyOptions) => ManyRelationDefinition;
     manyToMany: (targetTable: string, options?: RelationManyToManyOptions) => ManyToManyRelationDefinition;

package/dist/index.d.ts

@@ -85,10 +85,37 @@ type LoadedAppflareConfig = {
     config: NormalizedAppflareConfig;
 };
 
-type ColumnType = "int" | "string" | "boolean" | "date";
+type ColumnType = "int" | "string" | "boolean" | "date" | "enum" | "json";
+type JsonShape = {
+    kind: "array";
+    element: JsonShape;
+} | {
+    kind: "object";
+    shape: Record<string, JsonShape>;
+} | {
+    kind: "string";
+} | {
+    kind: "number";
+} | {
+    kind: "boolean";
+} | {
+    kind: "date";
+} | {
+    kind: "unknown";
+};
+type EnumDefinition = {
+    kind: "enum";
+    name: string;
+    sqlName?: string;
+    values: readonly string[];
+};
 type ColumnBuilderOptions = {
     sqlName?: string;
     length?: number;
+    enumValues?: readonly string[];
+    enumRef?: string;
+    isArray?: boolean;
+    jsonShape?: JsonShape;
 };
 type PrimaryKeyOptions = {
     autoIncrement?: boolean;
@@ -153,6 +180,14 @@ type ColumnDefinition = {
     nowDefault?: boolean;
     runtimeDefaultFn?: () => unknown;
     references?: ColumnReference;
+    /** For enum columns: the allowed values. */
+    enumValues?: readonly string[];
+    /** For enum columns: reference to a named enum definition. */
+    enumRef?: string;
+    /** When true, the column stores an array of enum values. */
+    isArray?: boolean;
+    /** For JSON columns: the shape of the stored data. */
+    jsonShape?: JsonShape;
 };
 type OneRelationDefinition = {
     kind: "relation";
@@ -208,7 +243,21 @@ type TableDefinition = {
 type SchemaDefinition = {
     kind: "schema";
     tables: Record<string, TableDefinition>;
+    enums: Record<string, EnumDefinition>;
 };
+declare class EnumBuilder<T extends string> {
+    private def;
+    constructor(name: string, values: readonly T[]);
+    sql(name: string): EnumBuilder<T>;
+    toDefinition(): EnumDefinition;
+    getValues(): readonly T[];
+}
+declare class JsonArrayBuilder {
+    private _element;
+    constructor(element: JsonShape);
+    get shape(): JsonShape;
+    toColumnBuilder(): ColumnBuilder;
+}
 declare class ColumnBuilder {
     private definition;
     constructor(typeOrDefinition: ColumnType | ColumnDefinition, options?: ColumnBuilderOptions);
@@ -228,12 +277,19 @@ declare class ColumnBuilder {
      */
     defaultNow(): ColumnBuilder;
     references(table: string, column?: string, actions?: Pick<ColumnReference, "onDelete" | "onUpdate">): ColumnBuilder;
+    /** Marks the column as an array (e.g., for enum arrays). */
+    array(): ColumnBuilder;
     toDefinition(): ColumnDefinition;
 }
 declare function table(shape: TableShape, options?: TableOptions): TableDefinition;
-declare function schema(tables: Record<string, TableDefinition>): SchemaDefinition;
+type SchemaOptions = {
+    enums?: Record<string, EnumDefinition>;
+};
+declare function schema(tables: Record<string, TableDefinition>, options?: SchemaOptions): SchemaDefinition;
 declare function isSchemaDefinition(value: unknown): value is SchemaDefinition;
 declare const v: {
+    /** Define a reusable enum that can be referenced by multiple columns. */
+    defineEnum: <T extends string>(name: string, values: readonly T[]) => EnumBuilder<T>;
     int: (options?: ColumnBuilderOptions) => ColumnBuilder;
     number: (options?: ColumnBuilderOptions) => ColumnBuilder;
     string: (options?: ColumnBuilderOptions) => ColumnBuilder;
@@ -245,6 +301,29 @@ declare const v: {
      * `crypto.randomUUID()` at runtime (no SQL sequence).
      */
     uuid: (options?: ColumnBuilderOptions) => ColumnBuilder;
+    /**
+     * Enum column builder.
+     * Pass an EnumBuilder (from v.defineEnum) or inline values.
+     */
+    enum: <T extends string>(valuesOrEnum: readonly T[] | EnumBuilder<T>, options?: ColumnBuilderOptions) => ColumnBuilder;
+    /**
+     * Enum array column builder.
+     * Stores multiple enum values in a single column.
+     */
+    enumArray: <T extends string>(valuesOrEnum: readonly T[] | EnumBuilder<T>, options?: ColumnBuilderOptions) => ColumnBuilder;
+    /**
+     * JSON array column builder.
+     * Stored as JSON text, auto-serialized on insert/query.
+     * Use v.string(), v.number(), v.object(), or v.array() as the element type.
+     * Example: v.array(v.string()), v.array(v.object({ name: v.string() }))
+     */
+    array: (element: JsonArrayBuilder | ColumnBuilder) => ColumnBuilder;
+    /**
+     * JSON object column builder.
+     * Stored as JSON text, auto-serialized on insert/query.
+     * Pass a shape record: v.object({ name: v.string(), count: v.number() })
+     */
+    object: <TShape extends Record<string, JsonShape | ColumnBuilder>>(shape: TShape) => ColumnBuilder;
     one: (targetTable: string, fieldOrOptions?: string | RelationOneOptions, options?: RelationOneOptions) => OneRelationDefinition;
     many: (targetTable: string, fieldOrOptions?: string | RelationManyOptions, options?: RelationManyOptions) => ManyRelationDefinition;
     manyToMany: (targetTable: string, options?: RelationManyToManyOptions) => ManyToManyRelationDefinition;

package/dist/index.js

@@ -1 +1 @@
-'use strict';var l=class n{definition;constructor(e,i={}){if(typeof e=="string"){this.definition={kind:"column",type:e,sqlName:i.sqlName,length:i.length};return}this.definition={...e};}with(e){return new n({...this.definition,...e})}sql(e){return this.with({sqlName:e})}notNull(){return this.with({notNull:true,nullable:false})}nullable(){return this.with({nullable:true,notNull:false})}primaryKey(e={}){return this.with({primaryKey:true,autoIncrement:e.autoIncrement??this.definition.autoIncrement})}unique(e){return this.with({unique:e?{name:e}:true})}index(e){return this.with({index:e?{name:e}:true})}default(e){return this.with({sqlDefault:e})}defaultFn(e){return this.with({runtimeDefaultFn:e})}defaultNow(){return this.with({nowDefault:true,runtimeDefaultFn:()=>new Date})}references(e,i="id",o={}){return this.with({references:{table:e,column:i,onDelete:o.onDelete,onUpdate:o.onUpdate}})}toDefinition(){return {...this.definition}}};function a(n,e={}){let i={},o={};for(let[t,r]of Object.entries(n)){if(r instanceof l){i[t]=r.toDefinition();continue}if(r.kind==="relation"){o[t]=r;continue}throw new Error(`Invalid table field '${t}'. Use column builders or relation helpers.`)}return {kind:"table",sqlName:e.sqlName,columns:i,relations:o}}function u(n){return {kind:"schema",tables:n}}function s(n){if(typeof n!="object"||n===null)return  false;let e=n;return e.kind==="schema"&&typeof e.tables=="object"}function p(n,e,i={}){let o=typeof e=="string"?e:void 0,t=typeof e=="string"?i:e??i;return {kind:"relation",relation:"one",targetTable:n,field:t.field??o,referenceField:t.referenceField,fkType:t.fkType,sqlName:t.sqlName,notNull:t.notNull,nullable:t.nullable,onDelete:t.onDelete,onUpdate:t.onUpdate}}function d(n,e,i={}){let o=typeof e=="string"?e:void 0,t=typeof e=="string"?i:e??i;return {kind:"relation",relation:"many",targetTable:n,field:t.field??o,referenceField:t.referenceField,fkType:t.fkType,sqlName:t.sqlName,notNull:t.notNull,nullable:t.nullable,onDelete:t.onDelete,onUpdate:t.onUpdate}}function f(n,e={}){return {kind:"relation",relation:"manyToMany",targetTable:n,referenceField:e.referenceField,targetReferenceField:e.targetReferenceField,junctionTable:e.junctionTable,sourceField:e.sourceField,targetField:e.targetField,sourceSqlName:e.sourceSqlName,targetSqlName:e.targetSqlName,onDelete:e.onDelete,onUpdate:e.onUpdate}}var c={int:(n={})=>new l("int",n),number:(n={})=>new l("int",n),string:(n={})=>new l("string",n),boolean:(n={})=>new l("boolean",n),date:(n={})=>new l("date",n),uuid:(n={})=>new l({kind:"column",type:"string",sqlName:n.sqlName,length:n.length??36,primaryKey:true,notNull:true,nullable:false,uuidPrimaryKey:true,runtimeDefaultFn:()=>crypto.randomUUID()}),one:(n,e,i={})=>p(n,e,i),many:(n,e,i={})=>d(n,e,i),manyToMany:(n,e={})=>f(n,e)};exports.isSchemaDefinition=s;exports.schema=u;exports.table=a;exports.v=c;
+'use strict';var l=class n{def;constructor(e,t){this.def={kind:"enum",name:e,values:t};}sql(e){return new n(e,this.def.values)}toDefinition(){return {...this.def}}getValues(){return this.def.values}};function d(n,e){return new l(n,e)}var u=class{_element;constructor(e){this._element=e;}get shape(){return {kind:"array",element:this._element}}toColumnBuilder(){return new o("json",{jsonShape:this.shape})}};var o=class n{definition;constructor(e,t={}){if(typeof e=="string"){this.definition={kind:"column",type:e,sqlName:t.sqlName,length:t.length,enumValues:t.enumValues,enumRef:t.enumRef,jsonShape:t.jsonShape};return}this.definition={...e};}with(e){return new n({...this.definition,...e})}sql(e){return this.with({sqlName:e})}notNull(){return this.with({notNull:true,nullable:false})}nullable(){return this.with({nullable:true,notNull:false})}primaryKey(e={}){return this.with({primaryKey:true,autoIncrement:e.autoIncrement??this.definition.autoIncrement})}unique(e){return this.with({unique:e?{name:e}:true})}index(e){return this.with({index:e?{name:e}:true})}default(e){return this.with({sqlDefault:e})}defaultFn(e){return this.with({runtimeDefaultFn:e})}defaultNow(){return this.with({nowDefault:true,runtimeDefaultFn:()=>new Date})}references(e,t="id",r={}){return this.with({references:{table:e,column:t,onDelete:r.onDelete,onUpdate:r.onUpdate}})}array(){return this.with({isArray:true})}toDefinition(){return {...this.definition}}};function p(n,e={}){let t={},r={};for(let[i,a]of Object.entries(n)){if(a instanceof o){t[i]=a.toDefinition();continue}if(a.kind==="relation"){r[i]=a;continue}throw new Error(`Invalid table field '${i}'. Use column builders or relation helpers.`)}return {kind:"table",sqlName:e.sqlName,columns:t,relations:r}}function m(n,e={}){return {kind:"schema",tables:n,enums:e.enums??{}}}function f(n){if(typeof n!="object"||n===null)return  false;let e=n;return e.kind==="schema"&&typeof e.tables=="object"&&(typeof e.enums=="object"||e.enums===void 0)}function c(n,e,t={}){let r=typeof e=="string"?e:void 0,i=typeof e=="string"?t:e??t;return {kind:"relation",relation:"one",targetTable:n,field:i.field??r,referenceField:i.referenceField,fkType:i.fkType,sqlName:i.sqlName,notNull:i.notNull,nullable:i.nullable,onDelete:i.onDelete,onUpdate:i.onUpdate}}function y(n,e,t={}){let r=typeof e=="string"?e:void 0,i=typeof e=="string"?t:e??t;return {kind:"relation",relation:"many",targetTable:n,field:i.field??r,referenceField:i.referenceField,fkType:i.fkType,sqlName:i.sqlName,notNull:i.notNull,nullable:i.nullable,onDelete:i.onDelete,onUpdate:i.onUpdate}}function g(n,e={}){return {kind:"relation",relation:"manyToMany",targetTable:n,referenceField:e.referenceField,targetReferenceField:e.targetReferenceField,junctionTable:e.junctionTable,sourceField:e.sourceField,targetField:e.targetField,sourceSqlName:e.sourceSqlName,targetSqlName:e.targetSqlName,onDelete:e.onDelete,onUpdate:e.onUpdate}}function s(n){let e=n.toDefinition();return e.jsonShape?e.jsonShape:e.type==="int"?{kind:"number"}:e.type==="string"?{kind:"string"}:e.type==="boolean"?{kind:"boolean"}:e.type==="date"?{kind:"date"}:e.type==="enum"&&e.enumValues?{kind:"string"}:{kind:"unknown"}}var h={defineEnum:(n,e)=>d(n,e),int:(n={})=>new o("int",n),number:(n={})=>new o("int",n),string:(n={})=>new o("string",n),boolean:(n={})=>new o("boolean",n),date:(n={})=>new o("date",n),uuid:(n={})=>new o({kind:"column",type:"string",sqlName:n.sqlName,length:n.length??36,primaryKey:true,notNull:true,nullable:false,uuidPrimaryKey:true,runtimeDefaultFn:()=>crypto.randomUUID()}),enum:(n,e={})=>{if(n instanceof l){let t=n.toDefinition();return new o("enum",{...e,enumValues:t.values,enumRef:t.name})}return new o("enum",{...e,enumValues:n})},enumArray:(n,e={})=>{if(n instanceof l){let t=n.toDefinition();return new o("enum",{...e,enumValues:t.values,enumRef:t.name,isArray:true})}return new o("enum",{...e,enumValues:n,isArray:true})},array:n=>{if(n instanceof u)return n.toColumnBuilder();if(n instanceof o){let e=n.toDefinition();if(e.jsonShape)return new o("json",{jsonShape:e.jsonShape});let t={kind:"array",element:s(n)};return new o("json",{jsonShape:t})}return new o("json",{jsonShape:{kind:"unknown"}})},object:n=>{let e={};for(let[t,r]of Object.entries(n))r instanceof o?e[t]=s(r):e[t]=r;return new o("json",{jsonShape:{kind:"object",shape:e}})},one:(n,e,t={})=>c(n,e,t),many:(n,e,t={})=>y(n,e,t),manyToMany:(n,e={})=>g(n,e)};exports.isSchemaDefinition=f;exports.schema=m;exports.table=p;exports.v=h;

package/dist/index.mjs

@@ -1 +1 @@
-var l=class n{definition;constructor(e,i={}){if(typeof e=="string"){this.definition={kind:"column",type:e,sqlName:i.sqlName,length:i.length};return}this.definition={...e};}with(e){return new n({...this.definition,...e})}sql(e){return this.with({sqlName:e})}notNull(){return this.with({notNull:true,nullable:false})}nullable(){return this.with({nullable:true,notNull:false})}primaryKey(e={}){return this.with({primaryKey:true,autoIncrement:e.autoIncrement??this.definition.autoIncrement})}unique(e){return this.with({unique:e?{name:e}:true})}index(e){return this.with({index:e?{name:e}:true})}default(e){return this.with({sqlDefault:e})}defaultFn(e){return this.with({runtimeDefaultFn:e})}defaultNow(){return this.with({nowDefault:true,runtimeDefaultFn:()=>new Date})}references(e,i="id",o={}){return this.with({references:{table:e,column:i,onDelete:o.onDelete,onUpdate:o.onUpdate}})}toDefinition(){return {...this.definition}}};function a(n,e={}){let i={},o={};for(let[t,r]of Object.entries(n)){if(r instanceof l){i[t]=r.toDefinition();continue}if(r.kind==="relation"){o[t]=r;continue}throw new Error(`Invalid table field '${t}'. Use column builders or relation helpers.`)}return {kind:"table",sqlName:e.sqlName,columns:i,relations:o}}function u(n){return {kind:"schema",tables:n}}function s(n){if(typeof n!="object"||n===null)return  false;let e=n;return e.kind==="schema"&&typeof e.tables=="object"}function p(n,e,i={}){let o=typeof e=="string"?e:void 0,t=typeof e=="string"?i:e??i;return {kind:"relation",relation:"one",targetTable:n,field:t.field??o,referenceField:t.referenceField,fkType:t.fkType,sqlName:t.sqlName,notNull:t.notNull,nullable:t.nullable,onDelete:t.onDelete,onUpdate:t.onUpdate}}function d(n,e,i={}){let o=typeof e=="string"?e:void 0,t=typeof e=="string"?i:e??i;return {kind:"relation",relation:"many",targetTable:n,field:t.field??o,referenceField:t.referenceField,fkType:t.fkType,sqlName:t.sqlName,notNull:t.notNull,nullable:t.nullable,onDelete:t.onDelete,onUpdate:t.onUpdate}}function f(n,e={}){return {kind:"relation",relation:"manyToMany",targetTable:n,referenceField:e.referenceField,targetReferenceField:e.targetReferenceField,junctionTable:e.junctionTable,sourceField:e.sourceField,targetField:e.targetField,sourceSqlName:e.sourceSqlName,targetSqlName:e.targetSqlName,onDelete:e.onDelete,onUpdate:e.onUpdate}}var c={int:(n={})=>new l("int",n),number:(n={})=>new l("int",n),string:(n={})=>new l("string",n),boolean:(n={})=>new l("boolean",n),date:(n={})=>new l("date",n),uuid:(n={})=>new l({kind:"column",type:"string",sqlName:n.sqlName,length:n.length??36,primaryKey:true,notNull:true,nullable:false,uuidPrimaryKey:true,runtimeDefaultFn:()=>crypto.randomUUID()}),one:(n,e,i={})=>p(n,e,i),many:(n,e,i={})=>d(n,e,i),manyToMany:(n,e={})=>f(n,e)};export{s as isSchemaDefinition,u as schema,a as table,c as v};
+var l=class n{def;constructor(e,t){this.def={kind:"enum",name:e,values:t};}sql(e){return new n(e,this.def.values)}toDefinition(){return {...this.def}}getValues(){return this.def.values}};function d(n,e){return new l(n,e)}var u=class{_element;constructor(e){this._element=e;}get shape(){return {kind:"array",element:this._element}}toColumnBuilder(){return new o("json",{jsonShape:this.shape})}};var o=class n{definition;constructor(e,t={}){if(typeof e=="string"){this.definition={kind:"column",type:e,sqlName:t.sqlName,length:t.length,enumValues:t.enumValues,enumRef:t.enumRef,jsonShape:t.jsonShape};return}this.definition={...e};}with(e){return new n({...this.definition,...e})}sql(e){return this.with({sqlName:e})}notNull(){return this.with({notNull:true,nullable:false})}nullable(){return this.with({nullable:true,notNull:false})}primaryKey(e={}){return this.with({primaryKey:true,autoIncrement:e.autoIncrement??this.definition.autoIncrement})}unique(e){return this.with({unique:e?{name:e}:true})}index(e){return this.with({index:e?{name:e}:true})}default(e){return this.with({sqlDefault:e})}defaultFn(e){return this.with({runtimeDefaultFn:e})}defaultNow(){return this.with({nowDefault:true,runtimeDefaultFn:()=>new Date})}references(e,t="id",r={}){return this.with({references:{table:e,column:t,onDelete:r.onDelete,onUpdate:r.onUpdate}})}array(){return this.with({isArray:true})}toDefinition(){return {...this.definition}}};function p(n,e={}){let t={},r={};for(let[i,a]of Object.entries(n)){if(a instanceof o){t[i]=a.toDefinition();continue}if(a.kind==="relation"){r[i]=a;continue}throw new Error(`Invalid table field '${i}'. Use column builders or relation helpers.`)}return {kind:"table",sqlName:e.sqlName,columns:t,relations:r}}function m(n,e={}){return {kind:"schema",tables:n,enums:e.enums??{}}}function f(n){if(typeof n!="object"||n===null)return  false;let e=n;return e.kind==="schema"&&typeof e.tables=="object"&&(typeof e.enums=="object"||e.enums===void 0)}function c(n,e,t={}){let r=typeof e=="string"?e:void 0,i=typeof e=="string"?t:e??t;return {kind:"relation",relation:"one",targetTable:n,field:i.field??r,referenceField:i.referenceField,fkType:i.fkType,sqlName:i.sqlName,notNull:i.notNull,nullable:i.nullable,onDelete:i.onDelete,onUpdate:i.onUpdate}}function y(n,e,t={}){let r=typeof e=="string"?e:void 0,i=typeof e=="string"?t:e??t;return {kind:"relation",relation:"many",targetTable:n,field:i.field??r,referenceField:i.referenceField,fkType:i.fkType,sqlName:i.sqlName,notNull:i.notNull,nullable:i.nullable,onDelete:i.onDelete,onUpdate:i.onUpdate}}function g(n,e={}){return {kind:"relation",relation:"manyToMany",targetTable:n,referenceField:e.referenceField,targetReferenceField:e.targetReferenceField,junctionTable:e.junctionTable,sourceField:e.sourceField,targetField:e.targetField,sourceSqlName:e.sourceSqlName,targetSqlName:e.targetSqlName,onDelete:e.onDelete,onUpdate:e.onUpdate}}function s(n){let e=n.toDefinition();return e.jsonShape?e.jsonShape:e.type==="int"?{kind:"number"}:e.type==="string"?{kind:"string"}:e.type==="boolean"?{kind:"boolean"}:e.type==="date"?{kind:"date"}:e.type==="enum"&&e.enumValues?{kind:"string"}:{kind:"unknown"}}var h={defineEnum:(n,e)=>d(n,e),int:(n={})=>new o("int",n),number:(n={})=>new o("int",n),string:(n={})=>new o("string",n),boolean:(n={})=>new o("boolean",n),date:(n={})=>new o("date",n),uuid:(n={})=>new o({kind:"column",type:"string",sqlName:n.sqlName,length:n.length??36,primaryKey:true,notNull:true,nullable:false,uuidPrimaryKey:true,runtimeDefaultFn:()=>crypto.randomUUID()}),enum:(n,e={})=>{if(n instanceof l){let t=n.toDefinition();return new o("enum",{...e,enumValues:t.values,enumRef:t.name})}return new o("enum",{...e,enumValues:n})},enumArray:(n,e={})=>{if(n instanceof l){let t=n.toDefinition();return new o("enum",{...e,enumValues:t.values,enumRef:t.name,isArray:true})}return new o("enum",{...e,enumValues:n,isArray:true})},array:n=>{if(n instanceof u)return n.toColumnBuilder();if(n instanceof o){let e=n.toDefinition();if(e.jsonShape)return new o("json",{jsonShape:e.jsonShape});let t={kind:"array",element:s(n)};return new o("json",{jsonShape:t})}return new o("json",{jsonShape:{kind:"unknown"}})},object:n=>{let e={};for(let[t,r]of Object.entries(n))r instanceof o?e[t]=s(r):e[t]=r;return new o("json",{jsonShape:{kind:"object",shape:e}})},one:(n,e,t={})=>c(n,e,t),many:(n,e,t={})=>y(n,e,t),manyToMany:(n,e={})=>g(n,e)};export{f as isSchemaDefinition,m as schema,p as table,h as v};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "appflare",
-	"version": "0.2.35",
+	"version": "0.2.37",
 	"main": "./dist/index.js",
 	"module": "./dist/index.mjs",
 	"types": "./dist/index.d.ts",

package/schema.ts

@@ -1,8 +1,28 @@
-export type ColumnType = "int" | "string" | "boolean" | "date";
+export type ColumnType = "int" | "string" | "boolean" | "date" | "enum" | "json";
+
+export type JsonShape =
+	| { kind: "array"; element: JsonShape }
+	| { kind: "object"; shape: Record<string, JsonShape> }
+	| { kind: "string" }
+	| { kind: "number" }
+	| { kind: "boolean" }
+	| { kind: "date" }
+	| { kind: "unknown" };
+
+export type EnumDefinition = {
+	kind: "enum";
+	name: string;
+	sqlName?: string;
+	values: readonly string[];
+};
 
 export type ColumnBuilderOptions = {
 	sqlName?: string;
 	length?: number;
+	enumValues?: readonly string[];
+	enumRef?: string;
+	isArray?: boolean;
+	jsonShape?: JsonShape;
 };
 
 export type PrimaryKeyOptions = {
@@ -75,6 +95,14 @@ export type ColumnDefinition = {
 	nowDefault?: boolean;
 	runtimeDefaultFn?: () => unknown;
 	references?: ColumnReference;
+	/** For enum columns: the allowed values. */
+	enumValues?: readonly string[];
+	/** For enum columns: reference to a named enum definition. */
+	enumRef?: string;
+	/** When true, the column stores an array of enum values. */
+	isArray?: boolean;
+	/** For JSON columns: the shape of the stored data. */
+	jsonShape?: JsonShape;
 };
 
 export type OneRelationDefinition = {
@@ -141,8 +169,72 @@ export type TableDefinition = {
 export type SchemaDefinition = {
 	kind: "schema";
 	tables: Record<string, TableDefinition>;
+	enums: Record<string, EnumDefinition>;
 };
 
+export class EnumBuilder<T extends string> {
+	private def: EnumDefinition;
+
+	public constructor(name: string, values: readonly T[]) {
+		this.def = {
+			kind: "enum",
+			name,
+			values: values as readonly string[],
+		};
+	}
+
+	public sql(name: string): EnumBuilder<T> {
+		return new EnumBuilder<T>(name, this.def.values as readonly T[]);
+	}
+
+	public toDefinition(): EnumDefinition {
+		return { ...this.def };
+	}
+
+	public getValues(): readonly T[] {
+		return this.def.values as readonly T[];
+	}
+}
+
+export function defineEnum<T extends string>(
+	name: string,
+	values: readonly T[],
+): EnumBuilder<T> {
+	return new EnumBuilder(name, values);
+}
+
+export class JsonArrayBuilder {
+	private _element: JsonShape;
+
+	public constructor(element: JsonShape) {
+		this._element = element;
+	}
+
+	public get shape(): JsonShape {
+		return { kind: "array", element: this._element };
+	}
+
+	public toColumnBuilder(): ColumnBuilder {
+		return new ColumnBuilder("json", { jsonShape: this.shape });
+	}
+}
+
+export class JsonObjectBuilder<TShape extends Record<string, JsonShape>> {
+	private _shape: TShape;
+
+	public constructor(shape: TShape) {
+		this._shape = shape;
+	}
+
+	public get shape(): JsonShape {
+		return { kind: "object", shape: this._shape };
+	}
+
+	public toColumnBuilder(): ColumnBuilder {
+		return new ColumnBuilder("json", { jsonShape: this.shape });
+	}
+}
+
 export class ColumnBuilder {
 	private definition: ColumnDefinition;
 
@@ -156,6 +248,9 @@ export class ColumnBuilder {
 				type: typeOrDefinition,
 				sqlName: options.sqlName,
 				length: options.length,
+				enumValues: options.enumValues,
+				enumRef: options.enumRef,
+				jsonShape: options.jsonShape,
 			};
 			return;
 		}
@@ -234,6 +329,11 @@ export class ColumnBuilder {
 		});
 	}
 
+	/** Marks the column as an array (e.g., for enum arrays). */
+	public array(): ColumnBuilder {
+		return this.with({ isArray: true });
+	}
+
 	public toDefinition(): ColumnDefinition {
 		return { ...this.definition };
 	}
@@ -270,12 +370,18 @@ export function table(
 	};
 }
 
+export type SchemaOptions = {
+	enums?: Record<string, EnumDefinition>;
+};
+
 export function schema(
 	tables: Record<string, TableDefinition>,
+	options: SchemaOptions = {},
 ): SchemaDefinition {
 	return {
 		kind: "schema",
 		tables,
+		enums: options.enums ?? {},
 	};
 }
 
@@ -283,8 +389,16 @@ export function isSchemaDefinition(value: unknown): value is SchemaDefinition {
 	if (typeof value !== "object" || value === null) {
 		return false;
 	}
-	const candidate = value as { kind?: string; tables?: unknown };
-	return candidate.kind === "schema" && typeof candidate.tables === "object";
+	const candidate = value as {
+		kind?: string;
+		tables?: unknown;
+		enums?: unknown;
+	};
+	return (
+		candidate.kind === "schema" &&
+		typeof candidate.tables === "object" &&
+		(typeof candidate.enums === "object" || candidate.enums === undefined)
+	);
 }
 
 // ---------------------------------------------------------------------------
@@ -363,7 +477,28 @@ function buildManyToManyRelation(
 // Public API
 // ---------------------------------------------------------------------------
 
+function columnBuilderToJsonShape(builder: ColumnBuilder): JsonShape {
+	const def = builder.toDefinition();
+	if (def.jsonShape) return def.jsonShape;
+	if (def.type === "int") return { kind: "number" };
+	if (def.type === "string") return { kind: "string" };
+	if (def.type === "boolean") return { kind: "boolean" };
+	if (def.type === "date") return { kind: "date" };
+	if (def.type === "enum" && def.enumValues) {
+		return {
+			kind: "string",
+		};
+	}
+	return { kind: "unknown" };
+}
+
 export const v = {
+	/** Define a reusable enum that can be referenced by multiple columns. */
+	defineEnum: <T extends string>(
+		name: string,
+		values: readonly T[],
+	): EnumBuilder<T> => defineEnum(name, values),
+
 	int: (options: ColumnBuilderOptions = {}) =>
 		new ColumnBuilder("int", options),
 	number: (options: ColumnBuilderOptions = {}) =>
@@ -393,6 +528,97 @@ export const v = {
 			runtimeDefaultFn: () => crypto.randomUUID(),
 		}),
 
+	/**
+	 * Enum column builder.
+	 * Pass an EnumBuilder (from v.defineEnum) or inline values.
+	 */
+	enum: <T extends string>(
+		valuesOrEnum: readonly T[] | EnumBuilder<T>,
+		options: ColumnBuilderOptions = {},
+	): ColumnBuilder => {
+		if (valuesOrEnum instanceof EnumBuilder) {
+			const def = valuesOrEnum.toDefinition();
+			return new ColumnBuilder("enum", {
+				...options,
+				enumValues: def.values,
+				enumRef: def.name,
+			});
+		}
+		return new ColumnBuilder("enum", {
+			...options,
+			enumValues: valuesOrEnum,
+		});
+	},
+
+	/**
+	 * Enum array column builder.
+	 * Stores multiple enum values in a single column.
+	 */
+	enumArray: <T extends string>(
+		valuesOrEnum: readonly T[] | EnumBuilder<T>,
+		options: ColumnBuilderOptions = {},
+	): ColumnBuilder => {
+		if (valuesOrEnum instanceof EnumBuilder) {
+			const def = valuesOrEnum.toDefinition();
+			return new ColumnBuilder("enum", {
+				...options,
+				enumValues: def.values,
+				enumRef: def.name,
+				isArray: true,
+			});
+		}
+		return new ColumnBuilder("enum", {
+			...options,
+			enumValues: valuesOrEnum,
+			isArray: true,
+		});
+	},
+
+	/**
+	 * JSON array column builder.
+	 * Stored as JSON text, auto-serialized on insert/query.
+	 * Use v.string(), v.number(), v.object(), or v.array() as the element type.
+	 * Example: v.array(v.string()), v.array(v.object({ name: v.string() }))
+	 */
+	array: (element: JsonArrayBuilder | ColumnBuilder): ColumnBuilder => {
+		if (element instanceof JsonArrayBuilder) {
+			return element.toColumnBuilder();
+		}
+		if (element instanceof ColumnBuilder) {
+			const def = element.toDefinition();
+			if (def.jsonShape) {
+				return new ColumnBuilder("json", { jsonShape: def.jsonShape });
+			}
+			const shape: JsonShape = {
+				kind: "array",
+				element: columnBuilderToJsonShape(element),
+			};
+			return new ColumnBuilder("json", { jsonShape: shape });
+		}
+		return new ColumnBuilder("json", { jsonShape: { kind: "unknown" } });
+	},
+
+	/**
+	 * JSON object column builder.
+	 * Stored as JSON text, auto-serialized on insert/query.
+	 * Pass a shape record: v.object({ name: v.string(), count: v.number() })
+	 */
+	object: <TShape extends Record<string, JsonShape | ColumnBuilder>>(
+		shape: TShape,
+	): ColumnBuilder => {
+		const resolved: Record<string, JsonShape> = {};
+		for (const [key, value] of Object.entries(shape)) {
+			if (value instanceof ColumnBuilder) {
+				resolved[key] = columnBuilderToJsonShape(value);
+			} else {
+				resolved[key] = value;
+			}
+		}
+		return new ColumnBuilder("json", {
+			jsonShape: { kind: "object", shape: resolved },
+		});
+	},
+
 	one: (
 		targetTable: string,
 		fieldOrOptions?: string | RelationOneOptions,