appflare 0.2.12 → 0.2.14

package/dist/index.d.mts

@@ -83,10 +83,6 @@ type LoadedAppflareConfig = {
     config: NormalizedAppflareConfig;
 };
 
-declare function loadConfig(configPathArg?: string): Promise<LoadedAppflareConfig>;
-
-declare function generateArtifacts(loadedConfig: LoadedAppflareConfig): Promise<void>;
-
 type ColumnType = "int" | "string" | "boolean" | "date";
 type ColumnBuilderOptions = {
     sqlName?: string;
@@ -95,12 +91,16 @@ type ColumnBuilderOptions = {
 type PrimaryKeyOptions = {
     autoIncrement?: boolean;
 };
+type ForeignKeyAction = "cascade" | "set null" | "set default" | "restrict" | "no action";
 type RelationOneOptions = {
     referenceField?: string;
     field?: string;
     fkType?: ColumnType;
     sqlName?: string;
     notNull?: boolean;
+    nullable?: boolean;
+    onDelete?: ForeignKeyAction;
+    onUpdate?: ForeignKeyAction;
 };
 type RelationManyOptions = {
     referenceField?: string;
@@ -108,6 +108,9 @@ type RelationManyOptions = {
     fkType?: ColumnType;
     sqlName?: string;
     notNull?: boolean;
+    nullable?: boolean;
+    onDelete?: ForeignKeyAction;
+    onUpdate?: ForeignKeyAction;
 };
 type ColumnReference = {
     table: string;
@@ -119,8 +122,11 @@ type ColumnDefinition = {
     sqlName?: string;
     length?: number;
     notNull?: boolean;
+    nullable?: boolean;
     primaryKey?: boolean;
     autoIncrement?: boolean;
+    /** When true the column stores a UUID generated at runtime (string type). */
+    uuidPrimaryKey?: boolean;
     unique?: true | {
         name?: string;
     };
@@ -128,6 +134,8 @@ type ColumnDefinition = {
         name?: string;
     };
     sqlDefault?: unknown;
+    /** When true, the SQL column gets DEFAULT CURRENT_TIMESTAMP and runtime inserts use `new Date()`. */
+    nowDefault?: boolean;
     runtimeDefaultFn?: () => unknown;
     references?: ColumnReference;
 };
@@ -140,6 +148,9 @@ type OneRelationDefinition = {
     fkType?: ColumnType;
     sqlName?: string;
     notNull?: boolean;
+    nullable?: boolean;
+    onDelete?: ForeignKeyAction;
+    onUpdate?: ForeignKeyAction;
 };
 type ManyRelationDefinition = {
     kind: "relation";
@@ -150,6 +161,9 @@ type ManyRelationDefinition = {
     fkType?: ColumnType;
     sqlName?: string;
     notNull?: boolean;
+    nullable?: boolean;
+    onDelete?: ForeignKeyAction;
+    onUpdate?: ForeignKeyAction;
 };
 type RelationDefinition = OneRelationDefinition | ManyRelationDefinition;
 type TableOptions = {
@@ -172,11 +186,18 @@ declare class ColumnBuilder {
     private with;
     sql(name: string): ColumnBuilder;
     notNull(): ColumnBuilder;
+    nullable(): ColumnBuilder;
     primaryKey(options?: PrimaryKeyOptions): ColumnBuilder;
     unique(name?: string): ColumnBuilder;
     index(name?: string): ColumnBuilder;
     default(value: unknown): ColumnBuilder;
     defaultFn(fn: () => unknown): ColumnBuilder;
+    /**
+     * Shorthand for date columns that should default to the current timestamp.
+     * Sets SQL `DEFAULT CURRENT_TIMESTAMP` (via `nowDefault`) and
+     * a runtime default of `new Date()`.
+     */
+    defaultNow(): ColumnBuilder;
     references(table: string, column?: string): ColumnBuilder;
     toDefinition(): ColumnDefinition;
 }
@@ -188,8 +209,14 @@ declare const v: {
     string: (options?: ColumnBuilderOptions) => ColumnBuilder;
     boolean: (options?: ColumnBuilderOptions) => ColumnBuilder;
     date: (options?: ColumnBuilderOptions) => ColumnBuilder;
+    /**
+     * UUID primary key column.
+     * Stored as a string, marked as primary key and auto-populated with
+     * `crypto.randomUUID()` at runtime (no SQL sequence).
+     */
+    uuid: (options?: ColumnBuilderOptions) => ColumnBuilder;
     one: (targetTable: string, fieldOrOptions?: string | RelationOneOptions, options?: RelationOneOptions) => OneRelationDefinition;
     many: (targetTable: string, fieldOrOptions?: string | RelationManyOptions, options?: RelationManyOptions) => ManyRelationDefinition;
 };
 
-export { type AppflareConfig, type AppflareDatabaseBinding, type AppflareKVNamespace, type AppflareR2Bucket, type ColumnDefinition, type LoadedAppflareConfig, type NormalizedAppflareConfig, type RelationDefinition, type SchemaDefinition, type TableDefinition, generateArtifacts, isSchemaDefinition, loadConfig, schema, table, v };
+export { type AppflareConfig, type AppflareDatabaseBinding, type AppflareKVNamespace, type AppflareR2Bucket, type ColumnDefinition, type LoadedAppflareConfig, type NormalizedAppflareConfig, type RelationDefinition, type SchemaDefinition, type TableDefinition, isSchemaDefinition, schema, table, v };

package/dist/index.d.ts

@@ -83,10 +83,6 @@ type LoadedAppflareConfig = {
     config: NormalizedAppflareConfig;
 };
 
-declare function loadConfig(configPathArg?: string): Promise<LoadedAppflareConfig>;
-
-declare function generateArtifacts(loadedConfig: LoadedAppflareConfig): Promise<void>;
-
 type ColumnType = "int" | "string" | "boolean" | "date";
 type ColumnBuilderOptions = {
     sqlName?: string;
@@ -95,12 +91,16 @@ type ColumnBuilderOptions = {
 type PrimaryKeyOptions = {
     autoIncrement?: boolean;
 };
+type ForeignKeyAction = "cascade" | "set null" | "set default" | "restrict" | "no action";
 type RelationOneOptions = {
     referenceField?: string;
     field?: string;
     fkType?: ColumnType;
     sqlName?: string;
     notNull?: boolean;
+    nullable?: boolean;
+    onDelete?: ForeignKeyAction;
+    onUpdate?: ForeignKeyAction;
 };
 type RelationManyOptions = {
     referenceField?: string;
@@ -108,6 +108,9 @@ type RelationManyOptions = {
     fkType?: ColumnType;
     sqlName?: string;
     notNull?: boolean;
+    nullable?: boolean;
+    onDelete?: ForeignKeyAction;
+    onUpdate?: ForeignKeyAction;
 };
 type ColumnReference = {
     table: string;
@@ -119,8 +122,11 @@ type ColumnDefinition = {
     sqlName?: string;
     length?: number;
     notNull?: boolean;
+    nullable?: boolean;
     primaryKey?: boolean;
     autoIncrement?: boolean;
+    /** When true the column stores a UUID generated at runtime (string type). */
+    uuidPrimaryKey?: boolean;
     unique?: true | {
         name?: string;
     };
@@ -128,6 +134,8 @@ type ColumnDefinition = {
         name?: string;
     };
     sqlDefault?: unknown;
+    /** When true, the SQL column gets DEFAULT CURRENT_TIMESTAMP and runtime inserts use `new Date()`. */
+    nowDefault?: boolean;
     runtimeDefaultFn?: () => unknown;
     references?: ColumnReference;
 };
@@ -140,6 +148,9 @@ type OneRelationDefinition = {
     fkType?: ColumnType;
     sqlName?: string;
     notNull?: boolean;
+    nullable?: boolean;
+    onDelete?: ForeignKeyAction;
+    onUpdate?: ForeignKeyAction;
 };
 type ManyRelationDefinition = {
     kind: "relation";
@@ -150,6 +161,9 @@ type ManyRelationDefinition = {
     fkType?: ColumnType;
     sqlName?: string;
     notNull?: boolean;
+    nullable?: boolean;
+    onDelete?: ForeignKeyAction;
+    onUpdate?: ForeignKeyAction;
 };
 type RelationDefinition = OneRelationDefinition | ManyRelationDefinition;
 type TableOptions = {
@@ -172,11 +186,18 @@ declare class ColumnBuilder {
     private with;
     sql(name: string): ColumnBuilder;
     notNull(): ColumnBuilder;
+    nullable(): ColumnBuilder;
     primaryKey(options?: PrimaryKeyOptions): ColumnBuilder;
     unique(name?: string): ColumnBuilder;
     index(name?: string): ColumnBuilder;
     default(value: unknown): ColumnBuilder;
     defaultFn(fn: () => unknown): ColumnBuilder;
+    /**
+     * Shorthand for date columns that should default to the current timestamp.
+     * Sets SQL `DEFAULT CURRENT_TIMESTAMP` (via `nowDefault`) and
+     * a runtime default of `new Date()`.
+     */
+    defaultNow(): ColumnBuilder;
     references(table: string, column?: string): ColumnBuilder;
     toDefinition(): ColumnDefinition;
 }
@@ -188,8 +209,14 @@ declare const v: {
     string: (options?: ColumnBuilderOptions) => ColumnBuilder;
     boolean: (options?: ColumnBuilderOptions) => ColumnBuilder;
     date: (options?: ColumnBuilderOptions) => ColumnBuilder;
+    /**
+     * UUID primary key column.
+     * Stored as a string, marked as primary key and auto-populated with
+     * `crypto.randomUUID()` at runtime (no SQL sequence).
+     */
+    uuid: (options?: ColumnBuilderOptions) => ColumnBuilder;
     one: (targetTable: string, fieldOrOptions?: string | RelationOneOptions, options?: RelationOneOptions) => OneRelationDefinition;
     many: (targetTable: string, fieldOrOptions?: string | RelationManyOptions, options?: RelationManyOptions) => ManyRelationDefinition;
 };
 
-export { type AppflareConfig, type AppflareDatabaseBinding, type AppflareKVNamespace, type AppflareR2Bucket, type ColumnDefinition, type LoadedAppflareConfig, type NormalizedAppflareConfig, type RelationDefinition, type SchemaDefinition, type TableDefinition, generateArtifacts, isSchemaDefinition, loadConfig, schema, table, v };
+export { type AppflareConfig, type AppflareDatabaseBinding, type AppflareKVNamespace, type AppflareR2Bucket, type ColumnDefinition, type LoadedAppflareConfig, type NormalizedAppflareConfig, type RelationDefinition, type SchemaDefinition, type TableDefinition, isSchemaDefinition, schema, table, v };

package/dist/index.js

@@ -1,2 +1 @@
-#!/usr/bin/env node
-'use strict';var chunkNKSCHJ57_js=require('./chunk-NKSCHJ57.js');require('./chunk-XVWH6PJQ.js');Object.defineProperty(exports,"generateArtifacts",{enumerable:true,get:function(){return chunkNKSCHJ57_js.f}});Object.defineProperty(exports,"isSchemaDefinition",{enumerable:true,get:function(){return chunkNKSCHJ57_js.d}});Object.defineProperty(exports,"loadConfig",{enumerable:true,get:function(){return chunkNKSCHJ57_js.a}});Object.defineProperty(exports,"schema",{enumerable:true,get:function(){return chunkNKSCHJ57_js.c}});Object.defineProperty(exports,"table",{enumerable:true,get:function(){return chunkNKSCHJ57_js.b}});Object.defineProperty(exports,"v",{enumerable:true,get:function(){return chunkNKSCHJ57_js.e}});
+'use strict';var o=class n{definition;constructor(e,t={}){if(typeof e=="string"){this.definition={kind:"column",type:e,sqlName:t.sqlName,length:t.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,t="id"){return this.with({references:{table:e,column:t}})}toDefinition(){return {...this.definition}}};function a(n,e={}){let t={},l={};for(let[i,r]of Object.entries(n)){if(r instanceof o){t[i]=r.toDefinition();continue}if(r.kind==="relation"){l[i]=r;continue}throw new Error(`Invalid table field '${i}'. Use column builders or relation helpers.`)}return {kind:"table",sqlName:e.sqlName,columns:t,relations:l}}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,t={}){let l=typeof e=="string"?e:void 0,i=typeof e=="string"?t:e??t;return {kind:"relation",relation:"one",targetTable:n,field:i.field??l,referenceField:i.referenceField,fkType:i.fkType,sqlName:i.sqlName,notNull:i.notNull,nullable:i.nullable,onDelete:i.onDelete,onUpdate:i.onUpdate}}function f(n,e,t={}){let l=typeof e=="string"?e:void 0,i=typeof e=="string"?t:e??t;return {kind:"relation",relation:"many",targetTable:n,field:i.field??l,referenceField:i.referenceField,fkType:i.fkType,sqlName:i.sqlName,notNull:i.notNull,nullable:i.nullable,onDelete:i.onDelete,onUpdate:i.onUpdate}}var m={int:(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,uuidPrimaryKey:true,runtimeDefaultFn:()=>crypto.randomUUID()}),one:(n,e,t={})=>p(n,e,t),many:(n,e,t={})=>f(n,e,t)};exports.isSchemaDefinition=s;exports.schema=u;exports.table=a;exports.v=m;

package/dist/index.mjs

@@ -1,2 +1 @@
-#!/usr/bin/env node
-export{f as generateArtifacts,d as isSchemaDefinition,a as loadConfig,c as schema,b as table,e as v}from'./chunk-6BUT7DXS.mjs';import'./chunk-4JK3AKWC.mjs';
+var o=class n{definition;constructor(e,t={}){if(typeof e=="string"){this.definition={kind:"column",type:e,sqlName:t.sqlName,length:t.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,t="id"){return this.with({references:{table:e,column:t}})}toDefinition(){return {...this.definition}}};function a(n,e={}){let t={},l={};for(let[i,r]of Object.entries(n)){if(r instanceof o){t[i]=r.toDefinition();continue}if(r.kind==="relation"){l[i]=r;continue}throw new Error(`Invalid table field '${i}'. Use column builders or relation helpers.`)}return {kind:"table",sqlName:e.sqlName,columns:t,relations:l}}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,t={}){let l=typeof e=="string"?e:void 0,i=typeof e=="string"?t:e??t;return {kind:"relation",relation:"one",targetTable:n,field:i.field??l,referenceField:i.referenceField,fkType:i.fkType,sqlName:i.sqlName,notNull:i.notNull,nullable:i.nullable,onDelete:i.onDelete,onUpdate:i.onUpdate}}function f(n,e,t={}){let l=typeof e=="string"?e:void 0,i=typeof e=="string"?t:e??t;return {kind:"relation",relation:"many",targetTable:n,field:i.field??l,referenceField:i.referenceField,fkType:i.fkType,sqlName:i.sqlName,notNull:i.notNull,nullable:i.nullable,onDelete:i.onDelete,onUpdate:i.onUpdate}}var m={int:(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,uuidPrimaryKey:true,runtimeDefaultFn:()=>crypto.randomUUID()}),one:(n,e,t={})=>p(n,e,t),many:(n,e,t={})=>f(n,e,t)};export{s as isSchemaDefinition,u as schema,a as table,m as v};

package/dist/react/index.js

@@ -1,2 +1 @@
-#!/usr/bin/env node
-'use strict';require('../chunk-XVWH6PJQ.js');var reactQuery=require('@tanstack/react-query'),react=require('react');function O(r){let t=new Error(r.message);return r.status!==void 0&&(t.status=r.status),t}function b(r,...t){let a=t[0]??{},e=t[1],o=reactQuery.useQueryClient(),i=react.useRef(e?.realtime?.onChange),p=react.useRef(e?.realtime?.onError);react.useEffect(()=>{i.current=e?.realtime?.onChange,p.current=e?.realtime?.onError;},[e?.realtime?.onChange,e?.realtime?.onError]);let u=react.useMemo(()=>e?.queryOptions?.queryKey??["appflare","query",r,a],[a,e?.queryOptions?.queryKey,r]),g=react.useMemo(()=>reactQuery.hashKey(u),[u]),f=react.useMemo(()=>reactQuery.hashKey([a]),[a]),A=react.useMemo(()=>reactQuery.hashKey([e?.realtime?.requestOptions]),[e?.realtime?.requestOptions]),m=reactQuery.useQuery({...e?.queryOptions,queryKey:u,queryFn:async()=>{let s=await r.run(a,e?.requestOptions);if(s.error)throw O(s.error);return s.data}});return react.useEffect(()=>{if(e?.realtime?.enabled===false||!r.subscribe)return;let s=new AbortController,y=r.subscribe({args:a,authToken:e.realtime?.authToken,requestOptions:e.realtime?.requestOptions,signal:s.signal,onChange:(n,c)=>{o.setQueryData(u,n),i.current?.(n,c);},onError:n=>{p.current?.(n);}});return ()=>{s.abort(),y.remove();}},[f,e?.realtime?.authToken,e?.realtime?.enabled,A,r.subscribe,o,g]),m}function h(r){let t=new Error(r.message);return r.status!==void 0&&(t.status=r.status),t}function P(r,...t){let a=t[0]??{},e=t[1],o=reactQuery.useQueryClient(),i=react.useRef(e?.realtime?.onChange),p=react.useRef(e?.realtime?.onError);react.useEffect(()=>{i.current=e?.realtime?.onChange,p.current=e?.realtime?.onError;},[e?.realtime?.onChange,e?.realtime?.onError]);let u=react.useMemo(()=>e?.queryOptions?.queryKey??["appflare","infinite-query",r,a],[a,e?.queryOptions?.queryKey,r]),g=react.useMemo(()=>reactQuery.hashKey(u),[u]),f=react.useMemo(()=>reactQuery.hashKey([a]),[a]),A=react.useMemo(()=>reactQuery.hashKey([e?.realtime?.requestOptions]),[e?.realtime?.requestOptions]),m=reactQuery.useInfiniteQuery({...e?.queryOptions,queryKey:u,queryFn:async({pageParam:s})=>{let y=s===void 0||!e?.pageParamToArgs?a:e.pageParamToArgs(a,s),n=await r.run(y,e?.requestOptions);if(n.error)throw h(n.error);return n.data}});return react.useEffect(()=>{if(e?.realtime?.enabled===false||!r.subscribe)return;let s=new AbortController,y=r.subscribe({args:a,authToken:e.realtime?.authToken,requestOptions:e.realtime?.requestOptions,signal:s.signal,onChange:(n,c)=>{o.setQueryData(u,l=>!l||l.pages.length===0?l:{...l,pages:[n,...l.pages.slice(1)]}),i.current?.(n,c);},onError:n=>{p.current?.(n);}});return ()=>{s.abort(),y.remove();}},[f,e?.realtime?.authToken,e?.realtime?.enabled,A,r.subscribe,o,g]),m}function L(r){let t=new Error(r.message);return r.status!==void 0&&(t.status=r.status),t}function C(r,t){return reactQuery.useMutation({...t,mutationFn:async a=>{let e=await r.run(a??{});if(e.error)throw L(e.error);return e.data}})}exports.useInfiniteQuery=P;exports.useMutation=C;exports.useQuery=b;
+'use strict';var reactQuery=require('@tanstack/react-query'),react=require('react');function O(r){let t=new Error(r.message);return r.status!==void 0&&(t.status=r.status),t}function b(r,...t){let a=t[0]??{},e=t[1],o=reactQuery.useQueryClient(),i=react.useRef(e?.realtime?.onChange),p=react.useRef(e?.realtime?.onError);react.useEffect(()=>{i.current=e?.realtime?.onChange,p.current=e?.realtime?.onError;},[e?.realtime?.onChange,e?.realtime?.onError]);let u=react.useMemo(()=>e?.queryOptions?.queryKey??["appflare","query",r,a],[a,e?.queryOptions?.queryKey,r]),g=react.useMemo(()=>reactQuery.hashKey(u),[u]),f=react.useMemo(()=>reactQuery.hashKey([a]),[a]),A=react.useMemo(()=>reactQuery.hashKey([e?.realtime?.requestOptions]),[e?.realtime?.requestOptions]),m=reactQuery.useQuery({...e?.queryOptions,queryKey:u,queryFn:async()=>{let s=await r.run(a,e?.requestOptions);if(s.error)throw O(s.error);return s.data}});return react.useEffect(()=>{if(e?.realtime?.enabled===false||!r.subscribe)return;let s=new AbortController,y=r.subscribe({args:a,authToken:e.realtime?.authToken,requestOptions:e.realtime?.requestOptions,signal:s.signal,onChange:(n,c)=>{o.setQueryData(u,n),i.current?.(n,c);},onError:n=>{p.current?.(n);}});return ()=>{s.abort(),y.remove();}},[f,e?.realtime?.authToken,e?.realtime?.enabled,A,r.subscribe,o,g]),m}function h(r){let t=new Error(r.message);return r.status!==void 0&&(t.status=r.status),t}function P(r,...t){let a=t[0]??{},e=t[1],o=reactQuery.useQueryClient(),i=react.useRef(e?.realtime?.onChange),p=react.useRef(e?.realtime?.onError);react.useEffect(()=>{i.current=e?.realtime?.onChange,p.current=e?.realtime?.onError;},[e?.realtime?.onChange,e?.realtime?.onError]);let u=react.useMemo(()=>e?.queryOptions?.queryKey??["appflare","infinite-query",r,a],[a,e?.queryOptions?.queryKey,r]),g=react.useMemo(()=>reactQuery.hashKey(u),[u]),f=react.useMemo(()=>reactQuery.hashKey([a]),[a]),A=react.useMemo(()=>reactQuery.hashKey([e?.realtime?.requestOptions]),[e?.realtime?.requestOptions]),m=reactQuery.useInfiniteQuery({...e?.queryOptions,queryKey:u,queryFn:async({pageParam:s})=>{let y=s===void 0||!e?.pageParamToArgs?a:e.pageParamToArgs(a,s),n=await r.run(y,e?.requestOptions);if(n.error)throw h(n.error);return n.data}});return react.useEffect(()=>{if(e?.realtime?.enabled===false||!r.subscribe)return;let s=new AbortController,y=r.subscribe({args:a,authToken:e.realtime?.authToken,requestOptions:e.realtime?.requestOptions,signal:s.signal,onChange:(n,c)=>{o.setQueryData(u,l=>!l||l.pages.length===0?l:{...l,pages:[n,...l.pages.slice(1)]}),i.current?.(n,c);},onError:n=>{p.current?.(n);}});return ()=>{s.abort(),y.remove();}},[f,e?.realtime?.authToken,e?.realtime?.enabled,A,r.subscribe,o,g]),m}function L(r){let t=new Error(r.message);return r.status!==void 0&&(t.status=r.status),t}function C(r,t){return reactQuery.useMutation({...t,mutationFn:async a=>{let e=await r.run(a??{});if(e.error)throw L(e.error);return e.data}})}exports.useInfiniteQuery=P;exports.useMutation=C;exports.useQuery=b;

package/dist/react/index.mjs

@@ -1,2 +1 @@
-#!/usr/bin/env node
-import'../chunk-4JK3AKWC.mjs';import {useQueryClient,hashKey,useQuery,useInfiniteQuery,useMutation}from'@tanstack/react-query';import {useRef,useEffect,useMemo}from'react';function O(r){let t=new Error(r.message);return r.status!==void 0&&(t.status=r.status),t}function b(r,...t){let a=t[0]??{},e=t[1],o=useQueryClient(),i=useRef(e?.realtime?.onChange),p=useRef(e?.realtime?.onError);useEffect(()=>{i.current=e?.realtime?.onChange,p.current=e?.realtime?.onError;},[e?.realtime?.onChange,e?.realtime?.onError]);let u=useMemo(()=>e?.queryOptions?.queryKey??["appflare","query",r,a],[a,e?.queryOptions?.queryKey,r]),g=useMemo(()=>hashKey(u),[u]),f=useMemo(()=>hashKey([a]),[a]),A=useMemo(()=>hashKey([e?.realtime?.requestOptions]),[e?.realtime?.requestOptions]),m=useQuery({...e?.queryOptions,queryKey:u,queryFn:async()=>{let s=await r.run(a,e?.requestOptions);if(s.error)throw O(s.error);return s.data}});return useEffect(()=>{if(e?.realtime?.enabled===false||!r.subscribe)return;let s=new AbortController,y=r.subscribe({args:a,authToken:e.realtime?.authToken,requestOptions:e.realtime?.requestOptions,signal:s.signal,onChange:(n,c)=>{o.setQueryData(u,n),i.current?.(n,c);},onError:n=>{p.current?.(n);}});return ()=>{s.abort(),y.remove();}},[f,e?.realtime?.authToken,e?.realtime?.enabled,A,r.subscribe,o,g]),m}function h(r){let t=new Error(r.message);return r.status!==void 0&&(t.status=r.status),t}function P(r,...t){let a=t[0]??{},e=t[1],o=useQueryClient(),i=useRef(e?.realtime?.onChange),p=useRef(e?.realtime?.onError);useEffect(()=>{i.current=e?.realtime?.onChange,p.current=e?.realtime?.onError;},[e?.realtime?.onChange,e?.realtime?.onError]);let u=useMemo(()=>e?.queryOptions?.queryKey??["appflare","infinite-query",r,a],[a,e?.queryOptions?.queryKey,r]),g=useMemo(()=>hashKey(u),[u]),f=useMemo(()=>hashKey([a]),[a]),A=useMemo(()=>hashKey([e?.realtime?.requestOptions]),[e?.realtime?.requestOptions]),m=useInfiniteQuery({...e?.queryOptions,queryKey:u,queryFn:async({pageParam:s})=>{let y=s===void 0||!e?.pageParamToArgs?a:e.pageParamToArgs(a,s),n=await r.run(y,e?.requestOptions);if(n.error)throw h(n.error);return n.data}});return useEffect(()=>{if(e?.realtime?.enabled===false||!r.subscribe)return;let s=new AbortController,y=r.subscribe({args:a,authToken:e.realtime?.authToken,requestOptions:e.realtime?.requestOptions,signal:s.signal,onChange:(n,c)=>{o.setQueryData(u,l=>!l||l.pages.length===0?l:{...l,pages:[n,...l.pages.slice(1)]}),i.current?.(n,c);},onError:n=>{p.current?.(n);}});return ()=>{s.abort(),y.remove();}},[f,e?.realtime?.authToken,e?.realtime?.enabled,A,r.subscribe,o,g]),m}function L(r){let t=new Error(r.message);return r.status!==void 0&&(t.status=r.status),t}function C(r,t){return useMutation({...t,mutationFn:async a=>{let e=await r.run(a??{});if(e.error)throw L(e.error);return e.data}})}export{P as useInfiniteQuery,C as useMutation,b as useQuery};
+import {useQueryClient,hashKey,useQuery,useInfiniteQuery,useMutation}from'@tanstack/react-query';import {useRef,useEffect,useMemo}from'react';function O(r){let t=new Error(r.message);return r.status!==void 0&&(t.status=r.status),t}function b(r,...t){let a=t[0]??{},e=t[1],o=useQueryClient(),i=useRef(e?.realtime?.onChange),p=useRef(e?.realtime?.onError);useEffect(()=>{i.current=e?.realtime?.onChange,p.current=e?.realtime?.onError;},[e?.realtime?.onChange,e?.realtime?.onError]);let u=useMemo(()=>e?.queryOptions?.queryKey??["appflare","query",r,a],[a,e?.queryOptions?.queryKey,r]),g=useMemo(()=>hashKey(u),[u]),f=useMemo(()=>hashKey([a]),[a]),A=useMemo(()=>hashKey([e?.realtime?.requestOptions]),[e?.realtime?.requestOptions]),m=useQuery({...e?.queryOptions,queryKey:u,queryFn:async()=>{let s=await r.run(a,e?.requestOptions);if(s.error)throw O(s.error);return s.data}});return useEffect(()=>{if(e?.realtime?.enabled===false||!r.subscribe)return;let s=new AbortController,y=r.subscribe({args:a,authToken:e.realtime?.authToken,requestOptions:e.realtime?.requestOptions,signal:s.signal,onChange:(n,c)=>{o.setQueryData(u,n),i.current?.(n,c);},onError:n=>{p.current?.(n);}});return ()=>{s.abort(),y.remove();}},[f,e?.realtime?.authToken,e?.realtime?.enabled,A,r.subscribe,o,g]),m}function h(r){let t=new Error(r.message);return r.status!==void 0&&(t.status=r.status),t}function P(r,...t){let a=t[0]??{},e=t[1],o=useQueryClient(),i=useRef(e?.realtime?.onChange),p=useRef(e?.realtime?.onError);useEffect(()=>{i.current=e?.realtime?.onChange,p.current=e?.realtime?.onError;},[e?.realtime?.onChange,e?.realtime?.onError]);let u=useMemo(()=>e?.queryOptions?.queryKey??["appflare","infinite-query",r,a],[a,e?.queryOptions?.queryKey,r]),g=useMemo(()=>hashKey(u),[u]),f=useMemo(()=>hashKey([a]),[a]),A=useMemo(()=>hashKey([e?.realtime?.requestOptions]),[e?.realtime?.requestOptions]),m=useInfiniteQuery({...e?.queryOptions,queryKey:u,queryFn:async({pageParam:s})=>{let y=s===void 0||!e?.pageParamToArgs?a:e.pageParamToArgs(a,s),n=await r.run(y,e?.requestOptions);if(n.error)throw h(n.error);return n.data}});return useEffect(()=>{if(e?.realtime?.enabled===false||!r.subscribe)return;let s=new AbortController,y=r.subscribe({args:a,authToken:e.realtime?.authToken,requestOptions:e.realtime?.requestOptions,signal:s.signal,onChange:(n,c)=>{o.setQueryData(u,l=>!l||l.pages.length===0?l:{...l,pages:[n,...l.pages.slice(1)]}),i.current?.(n,c);},onError:n=>{p.current?.(n);}});return ()=>{s.abort(),y.remove();}},[f,e?.realtime?.authToken,e?.realtime?.enabled,A,r.subscribe,o,g]),m}function L(r){let t=new Error(r.message);return r.status!==void 0&&(t.status=r.status),t}function C(r,t){return useMutation({...t,mutationFn:async a=>{let e=await r.run(a??{});if(e.error)throw L(e.error);return e.data}})}export{P as useInfiniteQuery,C as useMutation,b as useQuery};

package/index.ts

@@ -6,8 +6,6 @@ export type {
 	LoadedAppflareConfig,
 	NormalizedAppflareConfig,
 } from "./cli/types";
-export { loadConfig } from "./cli/load-config";
-export { generateArtifacts } from "./cli/generate";
 export {
 	schema,
 	table,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "appflare",
-	"version": "0.2.12",
+	"version": "0.2.14",
 	"main": "./dist/index.js",
 	"module": "./dist/index.mjs",
 	"types": "./dist/index.d.ts",
@@ -37,7 +37,6 @@
 		"@types/bun": "^1.3.9",
 		"@types/node": "^25.3.0",
 		"npm-check-updates": "^19.4.0",
-		"typescript": "^5.9.3",
 		"tsup": "^8.3.6"
 	},
 	"dependencies": {
@@ -53,6 +52,7 @@
 		"drizzle-orm": "0.45.1",
 		"hono": "4.12.0",
 		"wrangler": "4.67.0",
-		"zod": "4.3.6"
+		"zod": "4.3.6",
+		"typescript": "^5.9.3"
 	}
 }

package/schema.ts

@@ -9,12 +9,22 @@ export type PrimaryKeyOptions = {
 	autoIncrement?: boolean;
 };
 
+export type ForeignKeyAction =
+	| "cascade"
+	| "set null"
+	| "set default"
+	| "restrict"
+	| "no action";
+
 export type RelationOneOptions = {
 	referenceField?: string;
 	field?: string;
 	fkType?: ColumnType;
 	sqlName?: string;
 	notNull?: boolean;
+	nullable?: boolean;
+	onDelete?: ForeignKeyAction;
+	onUpdate?: ForeignKeyAction;
 };
 
 export type RelationManyOptions = {
@@ -23,6 +33,9 @@ export type RelationManyOptions = {
 	fkType?: ColumnType;
 	sqlName?: string;
 	notNull?: boolean;
+	nullable?: boolean;
+	onDelete?: ForeignKeyAction;
+	onUpdate?: ForeignKeyAction;
 };
 
 export type ColumnReference = {
@@ -36,11 +49,16 @@ export type ColumnDefinition = {
 	sqlName?: string;
 	length?: number;
 	notNull?: boolean;
+	nullable?: boolean;
 	primaryKey?: boolean;
 	autoIncrement?: boolean;
+	/** When true the column stores a UUID generated at runtime (string type). */
+	uuidPrimaryKey?: boolean;
 	unique?: true | { name?: string };
 	index?: true | { name?: string };
 	sqlDefault?: unknown;
+	/** When true, the SQL column gets DEFAULT CURRENT_TIMESTAMP and runtime inserts use `new Date()`. */
+	nowDefault?: boolean;
 	runtimeDefaultFn?: () => unknown;
 	references?: ColumnReference;
 };
@@ -54,6 +72,9 @@ export type OneRelationDefinition = {
 	fkType?: ColumnType;
 	sqlName?: string;
 	notNull?: boolean;
+	nullable?: boolean;
+	onDelete?: ForeignKeyAction;
+	onUpdate?: ForeignKeyAction;
 };
 
 export type ManyRelationDefinition = {
@@ -65,6 +86,9 @@ export type ManyRelationDefinition = {
 	fkType?: ColumnType;
 	sqlName?: string;
 	notNull?: boolean;
+	nullable?: boolean;
+	onDelete?: ForeignKeyAction;
+	onUpdate?: ForeignKeyAction;
 };
 
 export type RelationDefinition = OneRelationDefinition | ManyRelationDefinition;
@@ -121,7 +145,11 @@ export class ColumnBuilder {
 	}
 
 	public notNull(): ColumnBuilder {
-		return this.with({ notNull: true });
+		return this.with({ notNull: true, nullable: false });
+	}
+
+	public nullable(): ColumnBuilder {
+		return this.with({ nullable: true, notNull: false });
 	}
 
 	public primaryKey(options: PrimaryKeyOptions = {}): ColumnBuilder {
@@ -147,6 +175,18 @@ export class ColumnBuilder {
 		return this.with({ runtimeDefaultFn: fn });
 	}
 
+	/**
+	 * Shorthand for date columns that should default to the current timestamp.
+	 * Sets SQL `DEFAULT CURRENT_TIMESTAMP` (via `nowDefault`) and
+	 * a runtime default of `new Date()`.
+	 */
+	public defaultNow(): ColumnBuilder {
+		return this.with({
+			nowDefault: true,
+			runtimeDefaultFn: () => new Date(),
+		});
+	}
+
 	public references(table: string, column = "id"): ColumnBuilder {
 		return this.with({ references: { table, column } });
 	}
@@ -204,6 +244,62 @@ export function isSchemaDefinition(value: unknown): value is SchemaDefinition {
 	return candidate.kind === "schema" && typeof candidate.tables === "object";
 }
 
+// ---------------------------------------------------------------------------
+// Relation builder helpers
+// ---------------------------------------------------------------------------
+
+function buildOneRelation(
+	targetTable: string,
+	fieldOrOptions?: string | RelationOneOptions,
+	options: RelationOneOptions = {},
+): OneRelationDefinition {
+	const field = typeof fieldOrOptions === "string" ? fieldOrOptions : undefined;
+	const mergedOptions =
+		typeof fieldOrOptions === "string" ? options : (fieldOrOptions ?? options);
+
+	return {
+		kind: "relation",
+		relation: "one",
+		targetTable,
+		field: mergedOptions.field ?? field,
+		referenceField: mergedOptions.referenceField,
+		fkType: mergedOptions.fkType,
+		sqlName: mergedOptions.sqlName,
+		notNull: mergedOptions.notNull,
+		nullable: mergedOptions.nullable,
+		onDelete: mergedOptions.onDelete,
+		onUpdate: mergedOptions.onUpdate,
+	};
+}
+
+function buildManyRelation(
+	targetTable: string,
+	fieldOrOptions?: string | RelationManyOptions,
+	options: RelationManyOptions = {},
+): ManyRelationDefinition {
+	const field = typeof fieldOrOptions === "string" ? fieldOrOptions : undefined;
+	const mergedOptions =
+		typeof fieldOrOptions === "string" ? options : (fieldOrOptions ?? options);
+
+	return {
+		kind: "relation",
+		relation: "many",
+		targetTable,
+		field: mergedOptions.field ?? field,
+		referenceField: mergedOptions.referenceField,
+		fkType: mergedOptions.fkType,
+		sqlName: mergedOptions.sqlName,
+		notNull: mergedOptions.notNull,
+		nullable: mergedOptions.nullable,
+		onDelete: mergedOptions.onDelete,
+		onUpdate: mergedOptions.onUpdate,
+	};
+}
+
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+
 export const v = {
 	int: (options: ColumnBuilderOptions = {}) =>
 		new ColumnBuilder("int", options),
@@ -213,50 +309,34 @@ export const v = {
 		new ColumnBuilder("boolean", options),
 	date: (options: ColumnBuilderOptions = {}) =>
 		new ColumnBuilder("date", options),
+
+	/**
+	 * UUID primary key column.
+	 * Stored as a string, marked as primary key and auto-populated with
+	 * `crypto.randomUUID()` at runtime (no SQL sequence).
+	 */
+	uuid: (options: ColumnBuilderOptions = {}) =>
+		new ColumnBuilder({
+			kind: "column",
+			type: "string",
+			sqlName: options.sqlName,
+			length: options.length ?? 36,
+			primaryKey: true,
+			uuidPrimaryKey: true,
+			runtimeDefaultFn: () => crypto.randomUUID(),
+		}),
+
 	one: (
 		targetTable: string,
 		fieldOrOptions?: string | RelationOneOptions,
 		options: RelationOneOptions = {},
-	): OneRelationDefinition => {
-		const field =
-			typeof fieldOrOptions === "string" ? fieldOrOptions : undefined;
-		const mergedOptions =
-			typeof fieldOrOptions === "string"
-				? options
-				: (fieldOrOptions ?? options);
-
-		return {
-			kind: "relation",
-			relation: "one",
-			targetTable,
-			field: mergedOptions.field ?? field,
-			referenceField: mergedOptions.referenceField,
-			fkType: mergedOptions.fkType,
-			sqlName: mergedOptions.sqlName,
-			notNull: mergedOptions.notNull,
-		};
-	},
+	): OneRelationDefinition =>
+		buildOneRelation(targetTable, fieldOrOptions, options),
+
 	many: (
 		targetTable: string,
 		fieldOrOptions?: string | RelationManyOptions,
 		options: RelationManyOptions = {},
-	): ManyRelationDefinition => {
-		const field =
-			typeof fieldOrOptions === "string" ? fieldOrOptions : undefined;
-		const mergedOptions =
-			typeof fieldOrOptions === "string"
-				? options
-				: (fieldOrOptions ?? options);
-
-		return {
-			kind: "relation",
-			relation: "many",
-			targetTable,
-			field: mergedOptions.field ?? field,
-			referenceField: mergedOptions.referenceField,
-			fkType: mergedOptions.fkType,
-			sqlName: mergedOptions.sqlName,
-			notNull: mergedOptions.notNull,
-		};
-	},
+	): ManyRelationDefinition =>
+		buildManyRelation(targetTable, fieldOrOptions, options),
 };

package/tsup.config.ts

@@ -1,32 +1,82 @@
 import { defineConfig } from "tsup";
 
-export default defineConfig({
-	entry: ["index.ts", "cli/index.ts", "react/index.ts"],
-	format: ["esm", "cjs"],
-	dts: true,
-	splitting: true,
-	sourcemap: false,
-	clean: true,
-	minify: true,
-	treeshake: true,
-	external: [
-		"better-auth",
-		"better-auth-cloudflare",
-		"commander",
-		"hono",
-		"zod",
-		"wrangler",
-		"drizzle-kit",
-		"drizzle-orm",
-		"chokidar",
-		"bun",
-		"better-fetch",
-		"@better-auth/cli",
-		"@hono/standard-validator",
-		"react",
-		"@tanstack/react-query",
-	],
-	banner: {
-		js: "#!/usr/bin/env node",
+export default defineConfig([
+	{
+		entry: ["index.ts", "react/index.ts"],
+		format: ["esm", "cjs"],
+		dts: true,
+		splitting: false,
+		sourcemap: false,
+		clean: true,
+		minify: true,
+		treeshake: true,
+		external: [
+			"better-auth",
+			"better-auth-cloudflare",
+			"hono",
+			"zod",
+			"wrangler",
+			"drizzle-kit",
+			"drizzle-orm",
+			"bun",
+			"better-fetch",
+			"react",
+			"@tanstack/react-query",
+		],
 	},
-});
+	{
+		entry: {
+			"cli/index": "cli/index.ts",
+		},
+		format: ["esm", "cjs"],
+		platform: "neutral",
+		target: "node18",
+		dts: true,
+		splitting: false,
+		sourcemap: false,
+		clean: false, // Don't clean because the previous task cleaned it
+		minify: true,
+		treeshake: true,
+		external: [
+			"better-auth",
+			"better-auth-cloudflare",
+			"commander",
+			"hono",
+			"zod",
+			"wrangler",
+			"drizzle-kit",
+			"drizzle-orm",
+			"chokidar",
+			"bun",
+			"better-fetch",
+			"@better-auth/cli",
+			"@hono/standard-validator",
+			"react",
+			"@tanstack/react-query",
+			"typescript",
+			"fs",
+			"path",
+			"url",
+			"crypto",
+			"os",
+			"process",
+			"child_process",
+			"node:fs",
+			"node:path",
+			"node:url",
+			"node:crypto",
+			"node:os",
+			"node:process",
+			"node:child_process",
+		],
+		banner: {
+			js: "#!/usr/bin/env bun",
+		},
+		esbuildOptions(options) {
+			options.define = {
+				...options.define,
+				Bun: "Bun",
+			};
+		},
+	},
+]);

package/dist/chunk-4JK3AKWC.mjs

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-var g=Object.create;var f=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var i=Object.getOwnPropertyNames;var j=Object.getPrototypeOf,k=Object.prototype.hasOwnProperty;var m=(a=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(a,{get:(b,c)=>(typeof require<"u"?require:b)[c]}):a)(function(a){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+a+'" is not supported')});var n=(a,b)=>()=>(b||a((b={exports:{}}).exports,b),b.exports);var l=(a,b,c,e)=>{if(b&&typeof b=="object"||typeof b=="function")for(let d of i(b))!k.call(a,d)&&d!==c&&f(a,d,{get:()=>b[d],enumerable:!(e=h(b,d))||e.enumerable});return a};var o=(a,b,c)=>(c=a!=null?g(j(a)):{},l(b||!a||!a.__esModule?f(c,"default",{value:a,enumerable:true}):c,a));export{m as a,n as b,o as c};