@ez4/database 0.8.0 → 0.9.0

package/dist/errors/relations.d.ts

@@ -0,0 +1,24 @@
+import { IncorrectTypeError, InvalidTypeError, TypeError } from '@ez4/common/library';
+export declare class InvalidRelationsTypeError extends InvalidTypeError {
+    constructor(fileName?: string);
+}
+export declare class IncorrectRelationsTypeError extends IncorrectTypeError {
+    schemaType: string;
+    constructor(schemaType: string, fileName?: string);
+}
+export declare class InvalidRelationTargetError extends TypeError {
+    relationSource: string;
+    constructor(relationSource: string, fileName?: string);
+}
+export declare class InvalidRelationTableError extends TypeError {
+    relationTable: string;
+    constructor(relationTable: string, fileName?: string);
+}
+export declare class InvalidRelationColumnError extends TypeError {
+    relationColumn: string;
+    constructor(relationColumn: string, fileName?: string);
+}
+export declare class InvalidRelationAliasError extends TypeError {
+    relationAlias: string;
+    constructor(relationAlias: string, fileName?: string);
+}

package/dist/library.cjs

@@ -1,68 +1,95 @@
-"use strict";var C=Object.defineProperty;var de=Object.getOwnPropertyDescriptor;var be=Object.getOwnPropertyNames;var fe=Object.prototype.hasOwnProperty;var Te=(e,t)=>{for(var r in t)C(e,r,{get:t[r],enumerable:!0})},ue=(e,t,r,a)=>{if(t&&
-typeof t=="object"||typeof t=="function")for(let o of be(t))!fe.call(e,o)&&o!==r&&
-C(e,o,{get:()=>t[o],enumerable:!(a=de(t,o))||a.enumerable});return e};var ye=e=>ue(C({},"__esModule",{value:!0}),e);var Pe={};Te(Pe,{IncompleteHandlerError:()=>k,IncompleteServiceError:()=>x,IncompleteStreamError:()=>P,
-IncompleteTableError:()=>g,IncorrectIndexesTypeError:()=>I,IncorrectSchemaTypeError:()=>D,
-IncorrectStreamTypeError:()=>E,InvalidIndexReferenceError:()=>h,InvalidIndexTypeError:()=>M,
-InvalidIndexesTypeError:()=>S,InvalidSchemaTypeError:()=>v,InvalidStreamTypeError:()=>j,
-ServiceType:()=>A,getDatabaseServices:()=>V,getDatabaseTable:()=>F,getTableSchema:()=>R,
-isDatabaseService:()=>xe,registerTriggers:()=>De});module.exports=ye(Pe);var me=require("@ez4/common/library"),le=require("@ez4/schema/library"),ce=require("@ez4/project/library");var l=require("@ez4/common/library"),se=require("@ez4/reflection");var A="@ez4/database",xe=e=>e.type===A;var U=require("@ez4/common/library"),x=class extends U.IncompleteTypeError{constructor(t,r){
-super("Incomplete database service",t,r)}};var p=require("@ez4/common/library"),w=require("@ez4/reflection"),z=e=>(0,p.isClassDeclaration)(
-e)&&(0,p.hasHeritageType)(e,"Database.Service"),_=e=>(0,p.isModelDeclaration)(e)&&
-(0,p.hasHeritageType)(e,"Database.Table"),q=e=>(0,w.isTypeCallback)(e)||(0,w.isTypeFunction)(
-e),B=e=>(0,p.hasHeritageType)(e,"Database.Indexes"),G=e=>(0,p.hasHeritageType)(e,
-"Database.Schema"),J=e=>(0,p.hasHeritageType)(e,"Database.Stream");var u=require("@ez4/common/library"),y=require("@ez4/reflection");var K=require("@ez4/common/library"),g=class extends K.IncompleteTypeError{constructor(t,r){
-super("Incomplete database table",t,r)}};var d=require("@ez4/common/library"),S=class extends d.InvalidTypeError{constructor(t){
-super("Invalid table indexes type",void 0,"Database.Indexes",t)}},I=class extends d.IncorrectTypeError{constructor(r,a){
-super("Incorrect table indexes type",r,"Database.Indexes",a);this.schemaType=r}},
-M=class extends d.TypeError{constructor(r,a){super(`Invalid index type, ${r} mus\
-t follow one of the Index options.`,a);this.indexName=r}},h=class extends d.TypeError{constructor(r,a){
-super(`Invalid index reference, ${r} must be valid column.`,a);this.indexName=r}};var N=require("@ez4/reflection"),W=require("@ez4/common/library"),H=require("@ez4/schema/library");var O=require("@ez4/common/library"),v=class extends O.InvalidTypeError{constructor(t){
-super("Invalid table schema type",void 0,"Database.Schema",t)}},D=class extends O.IncorrectTypeError{constructor(r,a){
-super("Incorrect table schema type",r,"Database.Schema",a);this.schemaType=r}};var R=(e,t,r,a)=>{if(!(0,N.isTypeReference)(e))return Q(e,t,r,a);let o=r[e.path];
-return o?Q(o,t,r,a):null},Q=(e,t,r,a)=>(0,N.isTypeObject)(e)?(0,H.getObjectSchema)(
-e,r):(0,W.isModelDeclaration)(e)?G(e)?(0,H.getObjectSchema)(e,r):(a.push(new D(e.
-name,e.file)),null):(a.push(new v(t.file)),null);var c=require("@ez4/common/library"),b=require("@ez4/reflection");var Z=(e,t,r,a)=>{if(!(0,b.isTypeReference)(e))return X(e,t,a);let o=r[e.path];return o?
-X(o,t,a):null},X=(e,t,r)=>(0,b.isTypeObject)(e)?Y(e,(0,c.getObjectMembers)(e),r):
-(0,c.isModelDeclaration)(e)?B(e)?Y(e,(0,c.getModelMembers)(e),r):(r.push(new I(e.
-name,e.file)),null):(r.push(new S(t.file)),null),Y=(e,t,r)=>{let a={};for(let o of t){
-if(!(0,b.isModelProperty)(o)||o.inherited)continue;let s=o.name,i=(0,c.getPropertyString)(
-o);switch(i){case"primary":case"secondary":case"ttl":a[s]=i;break;default:return r.
-push(new M(s,e.file)),null}}return a};var m=require("@ez4/common/library"),T=require("@ez4/reflection");var f=require("@ez4/common/library"),P=class extends f.IncompleteTypeError{constructor(t,r){
-super("Incomplete table stream",t,r)}},j=class extends f.InvalidTypeError{constructor(t){
-super("Invalid table stream type",void 0,"Database.Stream",t)}},E=class extends f.IncorrectTypeError{constructor(r,a){
-super("Incorrect table stream type",r,"Database.Stream",a);this.streamType=r}};var L=require("@ez4/common/library"),k=class extends L.IncompleteTypeError{constructor(t,r){
-super("Incomplete stream handler",t,r)}};var ee=(e,t,r)=>{if(!q(e))return null;let a={},o=new Set(["name","file","change"]);
-return e.description&&(a.description=e.description),(a.name=e.name)&&o.delete("n\
-ame"),(a.file=e.file)&&o.delete("file"),e.parameters&&o.delete("change"),o.size===
-0&&ge(a)?a:(r.push(new k([...o],e.file)),null)},ge=e=>!!e.name&&!!e.file;var ae=(e,t,r,a)=>{if(!(0,T.isTypeReference)(e))return re(e,t,r,a);let o=r[e.path];
-return o?re(o,t,r,a):null},Se=e=>!!e.handler,re=(e,t,r,a)=>(0,T.isTypeObject)(e)?
-te(e,(0,m.getObjectMembers)(e),r,a):(0,m.isModelDeclaration)(e)?J(e)?te(e,(0,m.getModelMembers)(
-e),r,a):(a.push(new E(e.name,e.file)),null):(a.push(new j(t.file)),null),te=(e,t,r,a)=>{
-let o={},s=new Set(["handler"]);for(let i of t)if(!(!(0,T.isModelProperty)(i)||i.
-inherited))switch(i.name){case"handler":o.handler=ee(i.value,r,a);break;case"tim\
-eout":case"memory":{let n=(0,m.getPropertyNumber)(i);n!=null&&(o[i.name]=n);break}case"\
-variables":o.variables=(0,m.getLinkedVariableList)(i,a);break}return Se(o)?o:(a.
-push(new P([...s],e.file)),null)};var F=(e,t,r)=>{if(!(0,y.isTypeReference)(e))return oe(e,t,r);let a=t[e.path];return a?
-oe(a,t,r):null},Ie=e=>!!e.name&&!!e.schema&&!!e.indexes,oe=(e,t,r)=>_(e)?ne(e,(0,u.getModelMembers)(
-e),t,r):(0,y.isTypeObject)(e)?ne(e,(0,u.getObjectMembers)(e),t,r):null,ne=(e,t,r,a)=>{
-let o={},s=new Set(["name","schema","indexes"]);for(let n of t)if(!(!(0,y.isModelProperty)(
-n)||n.inherited))switch(n.name){case"name":(o.name=(0,u.getPropertyString)(n))&&
-s.delete(n.name);break;case"indexes":{(o.indexes=Z(n.value,e,r,a))&&s.delete(n.name);
-break}case"schema":{(o.schema=R(n.value,e,r,a))&&s.delete(n.name);break}case"str\
-eam":{o.stream=ae(n.value,e,r,a);break}}if(!Ie(o))return a.push(new g([...s],e.file)),
-null;let i=Me(e,o.indexes,o.schema);return i.length?(a.push(...i),null):o},Me=(e,t,r)=>{
-let a=r.properties,o=[];for(let s in t)for(let i of s.split(":"))a[i]||o.push(new h(
-s,e.file));return o};var V=e=>{let t={},r=[];for(let a in e){let o=e[a];if(!z(o))continue;let s={type:A},
-i=new Set(["engine","tables"]);s.name=o.name;for(let n of(0,l.getModelMembers)(o))
-if(!(!(0,se.isModelProperty)(n)||n.inherited))switch(n.name){case"engine":{let $=(0,l.getPropertyString)(
-n);$&&(s[n.name]=$,i.delete(n.name));break}case"tables":(s.tables=ve(n,e,r))&&i.
-delete(n.name);break;case"variables":s.variables=(0,l.getLinkedVariableList)(n,r);
-break;case"services":s.services=(0,l.getLinkedServiceList)(n,e,r);break}if(!he(s)){
-r.push(new x([...i],o.file));continue}t[o.name]=s}return{services:t,errors:r}},he=e=>!!e.
-name&&!!e.tables,ve=(e,t,r)=>{let a=(0,l.getPropertyTuple)(e)??[],o=[];for(let s of a){
-let i=F(s,t,r);i&&o.push(i)}return o};var ie=e=>z(e)?e.name:null;var pe=!1,De=()=>{pe||((0,me.registerTriggers)(),(0,le.registerTriggers)(),(0,ce.createTrigger)(
-"@ez4/database",{"metadata:getServices":V,"metadata:getLinkedService":ie}),pe=!0)};0&&(module.exports={IncompleteHandlerError,IncompleteServiceError,IncompleteStreamError,
-IncompleteTableError,IncorrectIndexesTypeError,IncorrectSchemaTypeError,IncorrectStreamTypeError,
-InvalidIndexReferenceError,InvalidIndexTypeError,InvalidIndexesTypeError,InvalidSchemaTypeError,
-InvalidStreamTypeError,ServiceType,getDatabaseServices,getDatabaseTable,getTableSchema,
-isDatabaseService,registerTriggers});
+"use strict";var K=Object.defineProperty;var Ae=Object.getOwnPropertyDescriptor;var Oe=Object.getOwnPropertyNames;var Re=Object.prototype.hasOwnProperty;var ke=(e,t)=>{for(var r in t)K(e,r,{get:t[r],enumerable:!0})},ze=(e,t,r,o)=>{if(t&&
+typeof t=="object"||typeof t=="function")for(let a of Oe(t))!Re.call(e,a)&&a!==r&&
+K(e,a,{get:()=>t[a],enumerable:!(o=Ae(t,a))||o.enumerable});return e};var Ce=e=>ze(K({},"__esModule",{value:!0}),e);var Ke={};ke(Ke,{IncompleteHandlerError:()=>F,IncompleteServiceError:()=>E,IncompleteStreamError:()=>H,
+IncompleteTableError:()=>w,IncorrectIndexesTypeError:()=>O,IncorrectRelationsTypeError:()=>v,
+IncorrectSchemaTypeError:()=>C,IncorrectStreamTypeError:()=>$,InvalidIndexReferenceError:()=>k,
+InvalidIndexTypeError:()=>R,InvalidIndexesTypeError:()=>A,InvalidRelationAliasError:()=>P,
+InvalidRelationColumnError:()=>d,InvalidRelationTableError:()=>j,InvalidRelationTargetError:()=>D,
+InvalidRelationsTypeError:()=>I,InvalidSchemaTypeError:()=>z,InvalidStreamTypeError:()=>N,
+ServiceType:()=>q,getDatabaseServices:()=>Y,getDatabaseTable:()=>X,getTableSchema:()=>W,
+isDatabaseService:()=>He,registerTriggers:()=>Je});module.exports=Ce(Ke);var je=require("@ez4/common/library"),Pe=require("@ez4/schema/library"),Ee=require("@ez4/project/library");var c=require("@ez4/common/library"),Ie=require("@ez4/reflection");var u=require("@ez4/common/library"),I=class extends u.InvalidTypeError{constructor(t){
+super("Invalid table relations type",void 0,"Database.Relations",t)}},v=class extends u.IncorrectTypeError{constructor(r,o){
+super("Incorrect table relations type",r,"Database.Relations",o);this.schemaType=
+r}},D=class extends u.TypeError{constructor(r,o){super(`Target ${r} must follow \
+the pattern 'column@alias'.`,o);this.relationSource=r}},j=class extends u.TypeError{constructor(r,o){
+super(`Relation table ${r} don't exists.`,o);this.relationTable=r}},d=class extends u.TypeError{constructor(r,o){
+super(`Relation column ${r} don't exists.`,o);this.relationColumn=r}},P=class extends u.TypeError{constructor(r,o){
+super(`Relation alias ${r} can't override table columns.`,o);this.relationAlias=
+r}};var q="@ez4/database",He=e=>e.type===q;var L=require("@ez4/common/library"),E=class extends L.IncompleteTypeError{constructor(t,r){
+super("Incomplete database service",t,r)}};var p=require("@ez4/common/library"),U=require("@ez4/reflection"),_=e=>(0,p.isClassDeclaration)(
+e)&&(0,p.hasHeritageType)(e,"Database.Service"),ee=e=>(0,p.isModelDeclaration)(e)&&
+(0,p.hasHeritageType)(e,"Database.Table"),re=e=>(0,U.isTypeCallback)(e)||(0,U.isTypeFunction)(
+e),te=e=>(0,p.hasHeritageType)(e,"Database.Relations"),oe=e=>(0,p.hasHeritageType)(
+e,"Database.Indexes"),ae=e=>(0,p.hasHeritageType)(e,"Database.Schema"),se=e=>(0,p.hasHeritageType)(
+e,"Database.Stream");var M=require("@ez4/common/library"),h=require("@ez4/reflection");var ne=require("@ez4/common/library"),w=class extends ne.IncompleteTypeError{constructor(t,r){
+super("Incomplete database table",t,r)}};var T=require("@ez4/common/library"),A=class extends T.InvalidTypeError{constructor(t){
+super("Invalid table indexes type",void 0,"Database.Indexes",t)}},O=class extends T.IncorrectTypeError{constructor(r,o){
+super("Incorrect table indexes type",r,"Database.Indexes",o);this.schemaType=r}},
+R=class extends T.TypeError{constructor(r,o){super(`Invalid index type, ${r} mus\
+t follow one of the Index options.`,o);this.indexName=r}},k=class extends T.TypeError{constructor(r,o){
+super(`Invalid index reference, ${r} must be valid column.`,o);this.indexName=r}};var b=require("@ez4/common/library"),y=require("@ez4/reflection");var pe=(e,t,r,o)=>{if(!(0,y.isTypeReference)(e))return ie(e,t,o);let a=r[e.path];
+return a?ie(a,t,o):null},ie=(e,t,r)=>(0,y.isTypeObject)(e)?le(e,(0,b.getObjectMembers)(
+e),r):(0,b.isModelDeclaration)(e)?te(e)?le(e,(0,b.getModelMembers)(e),r):(r.push(
+new v(e.name,e.file)),null):(r.push(new I(t.file)),null),le=(e,t,r)=>{let o=[];for(let a of t){
+if(!(0,y.isModelProperty)(a)||a.inherited)continue;let s=(0,b.getPropertyString)(
+a);if(!s)return r.push(new D(a.name,e.file)),null;let[n,i]=a.name.split(":",2),[
+l,V]=s.split("@",2);o.push({foreign:!1,sourceTable:n,sourceColumn:i,targetColumn:l,
+targetAlias:V})}return o};var f=require("@ez4/common/library"),x=require("@ez4/reflection");var ue=(e,t,r,o)=>{if(!(0,x.isTypeReference)(e))return me(e,t,o);let a=r[e.path];
+return a?me(a,t,o):null},me=(e,t,r)=>(0,x.isTypeObject)(e)?ce(e,(0,f.getObjectMembers)(
+e),r):(0,f.isModelDeclaration)(e)?oe(e)?ce(e,(0,f.getModelMembers)(e),r):(r.push(
+new O(e.name,e.file)),null):(r.push(new A(t.file)),null),ce=(e,t,r)=>{let o=[];for(let a of t){
+if(!(0,x.isModelProperty)(a)||a.inherited)continue;let s=a.name,n=(0,f.getPropertyString)(
+a);switch(n){case"primary":case"secondary":case"unique":case"ttl":o.push({name:s,
+columns:s.split(":"),type:n});break;default:return r.push(new R(s,e.file)),null}}
+return o};var G=require("@ez4/reflection"),fe=require("@ez4/common/library"),Q=require("@ez4/schema/library");var B=require("@ez4/common/library"),z=class extends B.InvalidTypeError{constructor(t){
+super("Invalid table schema type",void 0,"Database.Schema",t)}},C=class extends B.IncorrectTypeError{constructor(r,o){
+super("Incorrect table schema type",r,"Database.Schema",o);this.schemaType=r}};var W=(e,t,r,o)=>{if(!(0,G.isTypeReference)(e))return be(e,t,r,o);let a=r[e.path];
+return a?be(a,t,r,o):null},be=(e,t,r,o)=>(0,G.isTypeObject)(e)?(0,Q.getObjectSchema)(
+e,r):(0,fe.isModelDeclaration)(e)?ae(e)?(0,Q.getObjectSchema)(e,r):(o.push(new C(
+e.name,e.file)),null):(o.push(new z(t.file)),null);var m=require("@ez4/common/library"),S=require("@ez4/reflection"),ge=require("@ez4/utils");var g=require("@ez4/common/library"),H=class extends g.IncompleteTypeError{constructor(t,r){
+super("Incomplete table stream",t,r)}},N=class extends g.InvalidTypeError{constructor(t){
+super("Invalid table stream type",void 0,"Database.Stream",t)}},$=class extends g.IncorrectTypeError{constructor(r,o){
+super("Incorrect table stream type",r,"Database.Stream",o);this.streamType=r}};var Te=require("@ez4/common/library"),F=class extends Te.IncompleteTypeError{constructor(t,r){
+super("Incomplete stream handler",t,r)}};var de=(e,t,r)=>{if(!re(e))return null;let o={},a=new Set(["name","file","change"]);
+return e.description&&(o.description=e.description),(o.name=e.name)&&a.delete("n\
+ame"),(o.file=e.file)&&a.delete("file"),e.parameters&&a.delete("change"),a.size===
+0&&$e(o)?o:(r.push(new F([...a],e.file)),null)},$e=e=>!!e.name&&!!e.file;var Se=(e,t,r,o)=>{if(!(0,S.isTypeReference)(e))return ye(e,t,r,o);let a=r[e.path];
+return a?ye(a,t,r,o):null},Fe=e=>!!e.handler,ye=(e,t,r,o)=>(0,S.isTypeObject)(e)?
+xe(e,(0,m.getObjectMembers)(e),r,o):(0,m.isModelDeclaration)(e)?se(e)?xe(e,(0,m.getModelMembers)(
+e),r,o):(o.push(new $(e.name,e.file)),null):(o.push(new N(t.file)),null),xe=(e,t,r,o)=>{
+let a={},s=new Set(["handler"]);for(let n of t)if(!(!(0,S.isModelProperty)(n)||n.
+inherited))switch(n.name){case"handler":a.handler=de(n.value,r,o);break;case"tim\
+eout":case"memory":{let i=(0,m.getPropertyNumber)(n);(0,ge.isAnyNumber)(i)&&(a[n.
+name]=i);break}case"variables":a.variables=(0,m.getLinkedVariableList)(n,o);break}
+return Fe(a)?a:(o.push(new H([...s],e.file)),null)};var X=(e,t,r)=>{if(!(0,h.isTypeReference)(e))return Me(e,t,r);let o=t[e.path];return o?
+Me(o,t,r):null},Ve=e=>!!e.name&&!!e.schema&&!!e.indexes,Me=(e,t,r)=>ee(e)?he(e,(0,M.getModelMembers)(
+e),t,r):(0,h.isTypeObject)(e)?he(e,(0,M.getObjectMembers)(e),t,r):null,he=(e,t,r,o)=>{
+let a={},s=new Set(["name","schema","indexes"]);for(let i of t)if(!(!(0,h.isModelProperty)(
+i)||i.inherited))switch(i.name){case"name":(a.name=(0,M.getPropertyString)(i))&&
+s.delete(i.name);break;case"relations":{let l=pe(i.value,e,r,o);l&&(a.relations=
+l);break}case"indexes":{(a.indexes=ue(i.value,e,r,o))&&s.delete(i.name);break}case"\
+schema":{(a.schema=W(i.value,e,r,o))&&s.delete(i.name);break}case"stream":{a.stream=
+Se(i.value,e,r,o);break}}if(!Ve(a))return o.push(new w([...s],e.file)),null;let n=qe(
+e,a.indexes,a.schema);return n.length?(o.push(...n),null):(a.relations&&Ue(a.relations,
+a.indexes),a)},qe=(e,t,r)=>{let o=r.properties,a=[];for(let{name:s,columns:n}of t)
+n.some(l=>!o[l])&&a.push(new k(s,e.file));return a},Ue=(e,t)=>{for(let r of e)r.
+foreign=!t.some(({name:o,type:a})=>a==="primary"&&o===r.targetColumn)};var Y=e=>{let t={},r=[];for(let o in e){let a=e[o];if(!_(a))continue;let s={type:q},
+n=new Set(["engine","tables"]);s.name=a.name;for(let l of(0,c.getModelMembers)(a))
+if(!(!(0,Ie.isModelProperty)(l)||l.inherited))switch(l.name){case"engine":{(s.engine=
+(0,c.getPropertyString)(l))&&n.delete(l.name);break}case"tables":(s.tables=Be(l,
+e,r))&&n.delete(l.name);break;case"variables":s.variables=(0,c.getLinkedVariableList)(
+l,r);break;case"services":s.services=(0,c.getLinkedServiceList)(l,e,r);break}if(!_e(
+s)){r.push(new E([...n],a.file));continue}let i=Ge(a,s.tables);if(i.length){r.push(
+...i);continue}t[a.name]=s}return{services:t,errors:r}},_e=e=>!!e.name&&!!e.tables,
+Be=(e,t,r)=>{let o=(0,c.getPropertyTuple)(e)??[],a=[];for(let s of o){let n=X(s,
+t,r);n&&a.push(n)}return a},Ge=(e,t)=>{let r=[];for(let{relations:o,schema:a}of t){
+if(!o)continue;let s=a.properties;for(let n of o){let{sourceTable:i,sourceColumn:l,
+targetColumn:V,targetAlias:Z}=n,J=t.find(({name:we})=>we===i)?.schema.properties;
+s[V]||r.push(new d(V,e.file)),s[Z]&&r.push(new P(Z,e.file)),J||r.push(new j(i,e.
+file)),J&&!J[l]&&r.push(new d(l,e.file))}}return r};var ve=e=>_(e)?e.name:null;var De=!1,Je=()=>{De||((0,je.registerTriggers)(),(0,Pe.registerTriggers)(),(0,Ee.createTrigger)(
+"@ez4/database",{"metadata:getServices":Y,"metadata:getLinkedService":ve}),De=!0)};0&&(module.exports={IncompleteHandlerError,IncompleteServiceError,IncompleteStreamError,
+IncompleteTableError,IncorrectIndexesTypeError,IncorrectRelationsTypeError,IncorrectSchemaTypeError,
+IncorrectStreamTypeError,InvalidIndexReferenceError,InvalidIndexTypeError,InvalidIndexesTypeError,
+InvalidRelationAliasError,InvalidRelationColumnError,InvalidRelationTableError,InvalidRelationTargetError,
+InvalidRelationsTypeError,InvalidSchemaTypeError,InvalidStreamTypeError,ServiceType,
+getDatabaseServices,getDatabaseTable,getTableSchema,isDatabaseService,registerTriggers});

package/dist/library.d.ts

@@ -5,9 +5,12 @@ export * from './metadata/schema.js';
 export * from './errors/service.js';
 export * from './errors/table.js';
 export * from './errors/schema.js';
+export * from './errors/relations.js';
 export * from './errors/indexes.js';
 export * from './errors/stream.js';
 export * from './errors/handler.js';
 export * from './types/service.js';
-export * from './types/table.js';
+export * from './types/relations.js';
+export * from './types/indexes.js';
 export * from './types/schema.js';
+export * from './types/table.js';

package/dist/library.mjs

@@ -1,63 +1,89 @@
-import{registerTriggers as _e}from"@ez4/common/library";import{registerTriggers as qe}from"@ez4/schema/library";
-import{createTrigger as Be}from"@ez4/project/library";import{getLinkedServiceList as Ne,getLinkedVariableList as Ce,getPropertyString as He,
-getPropertyTuple as Re,getModelMembers as Fe}from"@ez4/common/library";import{isModelProperty as Ve}from"@ez4/reflection";var M="@ez4/database",Ge=e=>e.type===M;import{IncompleteTypeError as J}from"@ez4/common/library";var m=class extends J{constructor(t,r){
-super("Incomplete database service",t,r)}};import{hasHeritageType as p,isClassDeclaration as K,isModelDeclaration as Q}from"@ez4/common/library";
-import{isTypeCallback as W,isTypeFunction as X}from"@ez4/reflection";var l=e=>K(
-e)&&p(e,"Database.Service"),v=e=>Q(e)&&p(e,"Database.Table"),D=e=>W(e)||X(e),P=e=>p(
-e,"Database.Indexes"),j=e=>p(e,"Database.Schema"),E=e=>p(e,"Database.Stream");import{getModelMembers as Pe,getObjectMembers as je,getPropertyString as Ee}from"@ez4/common/library";
-import{isModelProperty as ke,isTypeObject as Ae,isTypeReference as we}from"@ez4/reflection";import{IncompleteTypeError as Y}from"@ez4/common/library";var c=class extends Y{constructor(t,r){
-super("Incomplete database table",t,r)}};import{IncorrectTypeError as Z,InvalidTypeError as L,TypeError as k}from"@ez4/common/library";
-var d=class extends L{constructor(t){super("Invalid table indexes type",void 0,"\
-Database.Indexes",t)}},b=class extends Z{constructor(r,a){super("Incorrect table\
- indexes type",r,"Database.Indexes",a);this.schemaType=r}},f=class extends k{constructor(r,a){
-super(`Invalid index type, ${r} must follow one of the Index options.`,a);this.indexName=
-r}},T=class extends k{constructor(r,a){super(`Invalid index reference, ${r} must\
- be valid column.`,a);this.indexName=r}};import{isTypeObject as te,isTypeReference as ae}from"@ez4/reflection";import{isModelDeclaration as oe}from"@ez4/common/library";
-import{getObjectSchema as A}from"@ez4/schema/library";import{IncorrectTypeError as ee,InvalidTypeError as re}from"@ez4/common/library";
-var u=class extends re{constructor(t){super("Invalid table schema type",void 0,"\
-Database.Schema",t)}},y=class extends ee{constructor(r,a){super("Incorrect table\
- schema type",r,"Database.Schema",a);this.schemaType=r}};var z=(e,t,r,a)=>{if(!ae(e))return w(e,t,r,a);let o=r[e.path];return o?w(o,t,r,a):
-null},w=(e,t,r,a)=>te(e)?A(e,r):oe(e)?j(e)?A(e,r):(a.push(new y(e.name,e.file)),
-null):(a.push(new u(t.file)),null);import{isModelDeclaration as ne,getModelMembers as se,getObjectMembers as ie,getPropertyString as pe}from"@ez4/common/library";
-import{isModelProperty as me,isTypeObject as le,isTypeReference as ce}from"@ez4/reflection";var C=(e,t,r,a)=>{if(!ce(e))return O(e,t,a);let o=r[e.path];return o?O(o,t,a):null},
-O=(e,t,r)=>le(e)?N(e,ie(e),r):ne(e)?P(e)?N(e,se(e),r):(r.push(new b(e.name,e.file)),
-null):(r.push(new d(t.file)),null),N=(e,t,r)=>{let a={};for(let o of t){if(!me(o)||
-o.inherited)continue;let s=o.name,i=pe(o);switch(i){case"primary":case"secondary":case"\
-ttl":a[s]=i;break;default:return r.push(new f(s,e.file)),null}}return a};import{getLinkedVariableList as ye,getModelMembers as xe,getObjectMembers as ge,
-getPropertyNumber as Se,isModelDeclaration as Ie}from"@ez4/common/library";import{
-isModelProperty as Me,isTypeObject as he,isTypeReference as ve}from"@ez4/reflection";import{IncompleteTypeError as de,IncorrectTypeError as be,InvalidTypeError as fe}from"@ez4/common/library";
-var x=class extends de{constructor(t,r){super("Incomplete table stream",t,r)}},g=class extends fe{constructor(t){
-super("Invalid table stream type",void 0,"Database.Stream",t)}},S=class extends be{constructor(r,a){
-super("Incorrect table stream type",r,"Database.Stream",a);this.streamType=r}};import{IncompleteTypeError as Te}from"@ez4/common/library";var I=class extends Te{constructor(t,r){
-super("Incomplete stream handler",t,r)}};var H=(e,t,r)=>{if(!D(e))return null;let a={},o=new Set(["name","file","change"]);
-return e.description&&(a.description=e.description),(a.name=e.name)&&o.delete("n\
-ame"),(a.file=e.file)&&o.delete("file"),e.parameters&&o.delete("change"),o.size===
-0&&ue(a)?a:(r.push(new I([...o],e.file)),null)},ue=e=>!!e.name&&!!e.file;var V=(e,t,r,a)=>{if(!ve(e))return R(e,t,r,a);let o=r[e.path];return o?R(o,t,r,a):
-null},De=e=>!!e.handler,R=(e,t,r,a)=>he(e)?F(e,ge(e),r,a):Ie(e)?E(e)?F(e,xe(e),r,
-a):(a.push(new S(e.name,e.file)),null):(a.push(new g(t.file)),null),F=(e,t,r,a)=>{
-let o={},s=new Set(["handler"]);for(let i of t)if(!(!Me(i)||i.inherited))switch(i.
-name){case"handler":o.handler=H(i.value,r,a);break;case"timeout":case"memory":{let n=Se(
-i);n!=null&&(o[i.name]=n);break}case"variables":o.variables=ye(i,a);break}return De(
-o)?o:(a.push(new x([...s],e.file)),null)};var _=(e,t,r)=>{if(!we(e))return $(e,t,r);let a=t[e.path];return a?$(a,t,r):null},
-ze=e=>!!e.name&&!!e.schema&&!!e.indexes,$=(e,t,r)=>v(e)?U(e,Pe(e),t,r):Ae(e)?U(e,
-je(e),t,r):null,U=(e,t,r,a)=>{let o={},s=new Set(["name","schema","indexes"]);for(let n of t)
-if(!(!ke(n)||n.inherited))switch(n.name){case"name":(o.name=Ee(n))&&s.delete(n.name);
-break;case"indexes":{(o.indexes=C(n.value,e,r,a))&&s.delete(n.name);break}case"s\
-chema":{(o.schema=z(n.value,e,r,a))&&s.delete(n.name);break}case"stream":{o.stream=
-V(n.value,e,r,a);break}}if(!ze(o))return a.push(new c([...s],e.file)),null;let i=Oe(
-e,o.indexes,o.schema);return i.length?(a.push(...i),null):o},Oe=(e,t,r)=>{let a=r.
-properties,o=[];for(let s in t)for(let i of s.split(":"))a[i]||o.push(new T(s,e.
-file));return o};var q=e=>{let t={},r=[];for(let a in e){let o=e[a];if(!l(o))continue;let s={type:M},
-i=new Set(["engine","tables"]);s.name=o.name;for(let n of Fe(o))if(!(!Ve(n)||n.inherited))
-switch(n.name){case"engine":{let h=He(n);h&&(s[n.name]=h,i.delete(n.name));break}case"\
-tables":(s.tables=Ue(n,e,r))&&i.delete(n.name);break;case"variables":s.variables=
-Ce(n,r);break;case"services":s.services=Ne(n,e,r);break}if(!$e(s)){r.push(new m(
-[...i],o.file));continue}t[o.name]=s}return{services:t,errors:r}},$e=e=>!!e.name&&
-!!e.tables,Ue=(e,t,r)=>{let a=Re(e)??[],o=[];for(let s of a){let i=_(s,t,r);i&&o.
-push(i)}return o};var B=e=>l(e)?e.name:null;var G=!1,et=()=>{G||(_e(),qe(),Be("@ez4/database",{"metadata:getServices":q,"met\
-adata:getLinkedService":B}),G=!0)};export{I as IncompleteHandlerError,m as IncompleteServiceError,x as IncompleteStreamError,
-c as IncompleteTableError,b as IncorrectIndexesTypeError,y as IncorrectSchemaTypeError,
-S as IncorrectStreamTypeError,T as InvalidIndexReferenceError,f as InvalidIndexTypeError,
-d as InvalidIndexesTypeError,u as InvalidSchemaTypeError,g as InvalidStreamTypeError,
-M as ServiceType,q as getDatabaseServices,_ as getDatabaseTable,z as getTableSchema,
-Ge as isDatabaseService,et as registerTriggers};
+import{registerTriggers as dr}from"@ez4/common/library";import{registerTriggers as yr}from"@ez4/schema/library";
+import{createTrigger as xr}from"@ez4/project/library";import{getLinkedServiceList as ir,getLinkedVariableList as lr,getPropertyString as pr,
+getPropertyTuple as mr,getModelMembers as cr}from"@ez4/common/library";import{isModelProperty as ur}from"@ez4/reflection";import{IncorrectTypeError as ie,InvalidTypeError as le,TypeError as y}from"@ez4/common/library";
+var u=class extends le{constructor(o){super("Invalid table relations type",void 0,
+"Database.Relations",o)}},b=class extends ie{constructor(r,t){super("Incorrect t\
+able relations type",r,"Database.Relations",t);this.schemaType=r}},f=class extends y{constructor(r,t){
+super(`Target ${r} must follow the pattern 'column@alias'.`,t);this.relationSource=
+r}},T=class extends y{constructor(r,t){super(`Relation table ${r} don't exists.`,
+t);this.relationTable=r}},m=class extends y{constructor(r,t){super(`Relation col\
+umn ${r} don't exists.`,t);this.relationColumn=r}},d=class extends y{constructor(r,t){
+super(`Relation alias ${r} can't override table columns.`,t);this.relationAlias=
+r}};var R="@ez4/database",Mr=e=>e.type===R;import{IncompleteTypeError as pe}from"@ez4/common/library";var x=class extends pe{constructor(o,r){
+super("Incomplete database service",o,r)}};import{hasHeritageType as p,isClassDeclaration as me,isModelDeclaration as ce}from"@ez4/common/library";
+import{isTypeCallback as ue,isTypeFunction as be}from"@ez4/reflection";var g=e=>me(
+e)&&p(e,"Database.Service"),z=e=>ce(e)&&p(e,"Database.Table"),C=e=>ue(e)||be(e),
+H=e=>p(e,"Database.Relations"),N=e=>p(e,"Database.Indexes"),$=e=>p(e,"Database.S\
+chema"),F=e=>p(e,"Database.Stream");import{getModelMembers as Ze,getObjectMembers as Le,getPropertyString as er}from"@ez4/common/library";
+import{isModelProperty as rr,isTypeObject as tr,isTypeReference as or}from"@ez4/reflection";import{IncompleteTypeError as fe}from"@ez4/common/library";var S=class extends fe{constructor(o,r){
+super("Incomplete database table",o,r)}};import{IncorrectTypeError as Te,InvalidTypeError as de,TypeError as V}from"@ez4/common/library";
+var M=class extends de{constructor(o){super("Invalid table indexes type",void 0,
+"Database.Indexes",o)}},h=class extends Te{constructor(r,t){super("Incorrect tab\
+le indexes type",r,"Database.Indexes",t);this.schemaType=r}},I=class extends V{constructor(r,t){
+super(`Invalid index type, ${r} must follow one of the Index options.`,t);this.indexName=
+r}},v=class extends V{constructor(r,t){super(`Invalid index reference, ${r} must\
+ be valid column.`,t);this.indexName=r}};import{isModelDeclaration as ye,getModelMembers as xe,getObjectMembers as ge,getPropertyString as Se}from"@ez4/common/library";
+import{isModelProperty as Me,isTypeObject as he,isTypeReference as Ie}from"@ez4/reflection";var _=(e,o,r,t)=>{if(!Ie(e))return q(e,o,t);let a=r[e.path];return a?q(a,o,t):null},
+q=(e,o,r)=>he(e)?U(e,ge(e),r):ye(e)?H(e)?U(e,xe(e),r):(r.push(new b(e.name,e.file)),
+null):(r.push(new u(o.file)),null),U=(e,o,r)=>{let t=[];for(let a of o){if(!Me(a)||
+a.inherited)continue;let s=Se(a);if(!s)return r.push(new f(a.name,e.file)),null;
+let[n,i]=a.name.split(":",2),[l,c]=s.split("@",2);t.push({foreign:!1,sourceTable:n,
+sourceColumn:i,targetColumn:l,targetAlias:c})}return t};import{isModelDeclaration as De,getModelMembers as je,getObjectMembers as Pe,getPropertyString as Ee}from"@ez4/common/library";
+import{isModelProperty as we,isTypeObject as Ae,isTypeReference as Oe}from"@ez4/reflection";var J=(e,o,r,t)=>{if(!Oe(e))return B(e,o,t);let a=r[e.path];return a?B(a,o,t):null},
+B=(e,o,r)=>Ae(e)?G(e,Pe(e),r):De(e)?N(e)?G(e,je(e),r):(r.push(new h(e.name,e.file)),
+null):(r.push(new M(o.file)),null),G=(e,o,r)=>{let t=[];for(let a of o){if(!we(a)||
+a.inherited)continue;let s=a.name,n=Ee(a);switch(n){case"primary":case"secondary":case"\
+unique":case"ttl":t.push({name:s,columns:s.split(":"),type:n});break;default:return r.
+push(new I(s,e.file)),null}}return t};import{isTypeObject as ze,isTypeReference as Ce}from"@ez4/reflection";import{isModelDeclaration as He}from"@ez4/common/library";
+import{getObjectSchema as K}from"@ez4/schema/library";import{IncorrectTypeError as Re,InvalidTypeError as ke}from"@ez4/common/library";
+var D=class extends ke{constructor(o){super("Invalid table schema type",void 0,"\
+Database.Schema",o)}},j=class extends Re{constructor(r,t){super("Incorrect table\
+ schema type",r,"Database.Schema",t);this.schemaType=r}};var W=(e,o,r,t)=>{if(!Ce(e))return Q(e,o,r,t);let a=r[e.path];return a?Q(a,o,r,t):
+null},Q=(e,o,r,t)=>ze(e)?K(e,r):He(e)?$(e)?K(e,r):(t.push(new j(e.name,e.file)),
+null):(t.push(new D(o.file)),null);import{getLinkedVariableList as Ue,getModelMembers as _e,getObjectMembers as Be,
+getPropertyNumber as Ge,isModelDeclaration as Je}from"@ez4/common/library";import{
+isModelProperty as Ke,isTypeObject as Qe,isTypeReference as We}from"@ez4/reflection";
+import{isAnyNumber as Xe}from"@ez4/utils";import{IncompleteTypeError as Ne,IncorrectTypeError as $e,InvalidTypeError as Fe}from"@ez4/common/library";
+var P=class extends Ne{constructor(o,r){super("Incomplete table stream",o,r)}},E=class extends Fe{constructor(o){
+super("Invalid table stream type",void 0,"Database.Stream",o)}},w=class extends $e{constructor(r,t){
+super("Incorrect table stream type",r,"Database.Stream",t);this.streamType=r}};import{IncompleteTypeError as Ve}from"@ez4/common/library";var A=class extends Ve{constructor(o,r){
+super("Incomplete stream handler",o,r)}};var X=(e,o,r)=>{if(!C(e))return null;let t={},a=new Set(["name","file","change"]);
+return e.description&&(t.description=e.description),(t.name=e.name)&&a.delete("n\
+ame"),(t.file=e.file)&&a.delete("file"),e.parameters&&a.delete("change"),a.size===
+0&&qe(t)?t:(r.push(new A([...a],e.file)),null)},qe=e=>!!e.name&&!!e.file;var L=(e,o,r,t)=>{if(!We(e))return Y(e,o,r,t);let a=r[e.path];return a?Y(a,o,r,t):
+null},Ye=e=>!!e.handler,Y=(e,o,r,t)=>Qe(e)?Z(e,Be(e),r,t):Je(e)?F(e)?Z(e,_e(e),r,
+t):(t.push(new w(e.name,e.file)),null):(t.push(new E(o.file)),null),Z=(e,o,r,t)=>{
+let a={},s=new Set(["handler"]);for(let n of o)if(!(!Ke(n)||n.inherited))switch(n.
+name){case"handler":a.handler=X(n.value,r,t);break;case"timeout":case"memory":{let i=Ge(
+n);Xe(i)&&(a[n.name]=i);break}case"variables":a.variables=Ue(n,t);break}return Ye(
+a)?a:(t.push(new P([...s],e.file)),null)};var te=(e,o,r)=>{if(!or(e))return ee(e,o,r);let t=o[e.path];return t?ee(t,o,r):null},
+ar=e=>!!e.name&&!!e.schema&&!!e.indexes,ee=(e,o,r)=>z(e)?re(e,Ze(e),o,r):tr(e)?re(
+e,Le(e),o,r):null,re=(e,o,r,t)=>{let a={},s=new Set(["name","schema","indexes"]);
+for(let i of o)if(!(!rr(i)||i.inherited))switch(i.name){case"name":(a.name=er(i))&&
+s.delete(i.name);break;case"relations":{let l=_(i.value,e,r,t);l&&(a.relations=l);
+break}case"indexes":{(a.indexes=J(i.value,e,r,t))&&s.delete(i.name);break}case"s\
+chema":{(a.schema=W(i.value,e,r,t))&&s.delete(i.name);break}case"stream":{a.stream=
+L(i.value,e,r,t);break}}if(!ar(a))return t.push(new S([...s],e.file)),null;let n=sr(
+e,a.indexes,a.schema);return n.length?(t.push(...n),null):(a.relations&&nr(a.relations,
+a.indexes),a)},sr=(e,o,r)=>{let t=r.properties,a=[];for(let{name:s,columns:n}of o)
+n.some(l=>!t[l])&&a.push(new v(s,e.file));return a},nr=(e,o)=>{for(let r of e)r.
+foreign=!o.some(({name:t,type:a})=>a==="primary"&&t===r.targetColumn)};var oe=e=>{let o={},r=[];for(let t in e){let a=e[t];if(!g(a))continue;let s={type:R},
+n=new Set(["engine","tables"]);s.name=a.name;for(let l of cr(a))if(!(!ur(l)||l.inherited))
+switch(l.name){case"engine":{(s.engine=pr(l))&&n.delete(l.name);break}case"table\
+s":(s.tables=fr(l,e,r))&&n.delete(l.name);break;case"variables":s.variables=lr(l,
+r);break;case"services":s.services=ir(l,e,r);break}if(!br(s)){r.push(new x([...n],
+a.file));continue}let i=Tr(a,s.tables);if(i.length){r.push(...i);continue}o[a.name]=
+s}return{services:o,errors:r}},br=e=>!!e.name&&!!e.tables,fr=(e,o,r)=>{let t=mr(
+e)??[],a=[];for(let s of t){let n=te(s,o,r);n&&a.push(n)}return a},Tr=(e,o)=>{let r=[];
+for(let{relations:t,schema:a}of o){if(!t)continue;let s=a.properties;for(let n of t){
+let{sourceTable:i,sourceColumn:l,targetColumn:c,targetAlias:k}=n,O=o.find(({name:ne})=>ne===
+i)?.schema.properties;s[c]||r.push(new m(c,e.file)),s[k]&&r.push(new d(k,e.file)),
+O||r.push(new T(i,e.file)),O&&!O[l]&&r.push(new m(l,e.file))}}return r};var ae=e=>g(e)?e.name:null;var se=!1,$t=()=>{se||(dr(),yr(),xr("@ez4/database",{"metadata:getServices":oe,"\
+metadata:getLinkedService":ae}),se=!0)};export{A as IncompleteHandlerError,x as IncompleteServiceError,P as IncompleteStreamError,
+S as IncompleteTableError,h as IncorrectIndexesTypeError,b as IncorrectRelationsTypeError,
+j as IncorrectSchemaTypeError,w as IncorrectStreamTypeError,v as InvalidIndexReferenceError,
+I as InvalidIndexTypeError,M as InvalidIndexesTypeError,d as InvalidRelationAliasError,
+m as InvalidRelationColumnError,T as InvalidRelationTableError,f as InvalidRelationTargetError,
+u as InvalidRelationsTypeError,D as InvalidSchemaTypeError,E as InvalidStreamTypeError,
+R as ServiceType,oe as getDatabaseServices,te as getDatabaseTable,W as getTableSchema,
+Mr as isDatabaseService,$t as registerTriggers};

package/dist/main.cjs

@@ -1,4 +1,5 @@
-"use strict";var s=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var i=Object.getOwnPropertyNames;var T=Object.prototype.hasOwnProperty;var y=(r,t)=>{for(var a in t)s(r,a,{get:t[a],enumerable:!0})},c=(r,t,a,e)=>{if(t&&
-typeof t=="object"||typeof t=="function")for(let n of i(t))!T.call(r,n)&&n!==a&&
-s(r,n,{get:()=>t[n],enumerable:!(e=d(t,n))||e.enumerable});return r};var I=r=>c(s({},"__esModule",{value:!0}),r);var l={};y(l,{Database:()=>x,Index:()=>m,Order:()=>o,StreamType:()=>p});module.exports=
-I(l);var o=(a=>(a.Asc="asc",a.Desc="desc",a))(o||{});var m=(e=>(e.Primary="primary",e.Secondary="secondary",e.TTL="ttl",e))(m||{});var p=(e=>(e.Insert="insert",e.Update="update",e.Delete="delete",e))(p||{});var x;(r=>{})(x||={});0&&(module.exports={Database,Index,Order,StreamType});
+"use strict";var s=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var T=Object.prototype.hasOwnProperty;var c=(r,t)=>{for(var a in t)s(r,a,{get:t[a],enumerable:!0})},y=(r,t,a,n)=>{if(t&&
+typeof t=="object"||typeof t=="function")for(let e of d(t))!T.call(r,e)&&e!==a&&
+s(r,e,{get:()=>t[e],enumerable:!(n=i(t,e))||n.enumerable});return r};var l=r=>y(s({},"__esModule",{value:!0}),r);var b={};c(b,{Database:()=>o,Index:()=>m,Order:()=>p,StreamType:()=>x});module.exports=
+l(b);var x=(n=>(n.Insert="insert",n.Update="update",n.Delete="delete",n))(x||{});var o;(r=>{})(o||={});var m=(e=>(e.Primary="primary",e.Secondary="secondary",e.Unique="unique",e.TTL="\
+ttl",e))(m||{});var p=(a=>(a.Asc="asc",a.Desc="desc",a))(p||{});0&&(module.exports={Database,Index,Order,StreamType});

package/dist/main.d.ts

@@ -1,8 +1,9 @@
-export * from './services/client.js';
-export * from './services/transaction.js';
-export * from './services/query.js';
-export * from './services/order.js';
-export * from './services/indexes.js';
-export * from './services/schemas.js';
 export * from './services/streams.js';
-export * from './services/database.js';
+export { Client } from './services/client.js';
+export { Database } from './services/database.js';
+export { Transaction } from './services/transaction.js';
+export { Relations } from './services/relations.js';
+export { Index } from './services/indexes.js';
+export { Table } from './services/table.js';
+export { Query } from './services/query.js';
+export { Order } from './services/order.js';

package/dist/main.mjs

@@ -1 +1,2 @@
-var r=(t=>(t.Asc="asc",t.Desc="desc",t))(r||{});var a=(e=>(e.Primary="primary",e.Secondary="secondary",e.TTL="ttl",e))(a||{});var n=(e=>(e.Insert="insert",e.Update="update",e.Delete="delete",e))(n||{});var s;(o=>{})(s||={});export{s as Database,a as Index,r as Order,n as StreamType};
+var o=(t=>(t.Insert="insert",t.Update="update",t.Delete="delete",t))(o||{});var a;(m=>{})(a||={});var n=(e=>(e.Primary="primary",e.Secondary="secondary",e.Unique="unique",e.TTL="\
+ttl",e))(n||{});var s=(r=>(r.Asc="asc",r.Desc="desc",r))(s||{});export{a as Database,n as Index,s as Order,o as StreamType};

package/dist/metadata/indexes.d.ts

@@ -1,5 +1,5 @@
 import type { AllType, SourceMap, TypeModel, TypeObject } from '@ez4/reflection';
-import type { TableIndexes } from '../types/indexes.js';
+import type { TableIndex } from '../types/indexes.js';
 type TypeParent = TypeModel | TypeObject;
-export declare const getTableIndexes: (type: AllType, parent: TypeParent, reflection: SourceMap, errorList: Error[]) => TableIndexes | null;
+export declare const getTableIndexes: (type: AllType, parent: TypeParent, reflection: SourceMap, errorList: Error[]) => TableIndex[] | null;
 export {};

package/dist/metadata/relations.d.ts

@@ -0,0 +1,5 @@
+import type { AllType, SourceMap, TypeModel, TypeObject } from '@ez4/reflection';
+import type { TableRelation } from '../types/relations.js';
+type TypeParent = TypeModel | TypeObject;
+export declare const getTableRelations: (type: AllType, parent: TypeParent, reflection: SourceMap, errorList: Error[]) => TableRelation[] | null;
+export {};

package/dist/metadata/utils.d.ts

@@ -2,6 +2,7 @@ import type { AllType, TypeCallback, TypeClass, TypeFunction, TypeModel } from '
 export declare const isDatabaseService: (type: AllType) => type is TypeClass;
 export declare const isDatabaseTable: (type: AllType) => type is TypeModel;
 export declare const isStreamHandler: (type: AllType) => type is TypeCallback | TypeFunction;
+export declare const isTableRelations: (type: TypeModel) => boolean;
 export declare const isTableIndexes: (type: TypeModel) => boolean;
 export declare const isTableSchema: (type: TypeModel) => boolean;
 export declare const isTableStream: (type: TypeModel) => boolean;

package/dist/services/client.d.ts

@@ -1,12 +1,10 @@
-import type { Indexes, TableIndexes } from './indexes.js';
-import type { TableSchemas } from './schemas.js';
-import type { Database } from './database.js';
+import type { TableClients } from './table.js';
 import type { Transaction } from './transaction.js';
-import type { Query } from './query.js';
+import type { Database } from './database.js';
 /**
  * Database client.
  */
-export type Client<T extends Database.Service<any>> = ClientTables<T> & {
+export type Client<T extends Database.Service<any>> = TableClients<T> & {
     /**
      * Prepare and execute the given query.
      *
@@ -22,23 +20,3 @@ export type Client<T extends Database.Service<any>> = ClientTables<T> & {
      */
     transaction<O extends Transaction.WriteOperations<T>>(operations: O): Promise<void>;
 };
-/**
- * Client tables.
- */
-export type ClientTables<T extends Database.Service<any>> = {
-    [P in keyof TableSchemas<T>]: TableSchemas<T>[P] extends Database.Schema ? Table<TableSchemas<T>[P], P extends keyof TableIndexes<T> ? TableIndexes<T>[P] extends Indexes ? TableIndexes<T>[P] : {} : {}> : never;
-};
-/**
- * Client table.
- */
-export interface Table<T extends Database.Schema, I extends Indexes> {
-    insertOne(query: Query.InsertOneInput<T>): Promise<Query.InsertOneResult>;
-    findOne<S extends Query.SelectInput<T>>(query: Query.FindOneInput<T, S, I>): Promise<Query.FindOneResult<T, S>>;
-    updateOne<S extends Query.SelectInput<T>>(query: Query.UpdateOneInput<T, S, I>): Promise<Query.UpdateOneResult<T, S>>;
-    upsertOne<S extends Query.SelectInput<T>>(query: Query.UpsertOneInput<T, S, I>): Promise<Query.UpsertOneResult<T, S>>;
-    deleteOne<S extends Query.SelectInput<T>>(query: Query.DeleteOneInput<T, S, I>): Promise<Query.DeleteOneResult<T, S>>;
-    insertMany(query: Query.InsertManyInput<T>): Promise<Query.InsertManyResult>;
-    findMany<S extends Query.SelectInput<T>>(query: Query.FindManyInput<T, S, I>): Promise<Query.FindManyResult<T, S>>;
-    updateMany<S extends Query.SelectInput<T>>(query: Query.UpdateManyInput<T, S>): Promise<Query.UpdateManyResult<T, S>>;
-    deleteMany<S extends Query.SelectInput<T>>(query: Query.DeleteManyInput<T, S>): Promise<Query.DeleteManyResult<T, S>>;
-}

package/dist/services/database.d.ts

@@ -1,9 +1,15 @@
 import type { Service } from '@ez4/common';
 import type { LinkedVariables } from '@ez4/project/library';
 import type { StreamChange } from './streams.js';
-import type { TableTypes } from './helpers.js';
+import type { TableTypes } from './table.js';
 import type { Client } from './client.js';
 import type { Index } from './indexes.js';
+/**
+ * Given a database service `T`, it returns all its table.
+ */
+export type DatabaseTables<T> = T extends {
+    tables: infer U;
+} ? U : [];
 /**
  * Provide all contracts for a self-managed database service.
  */
@@ -13,11 +19,16 @@ export declare namespace Database {
      */
     interface Schema {
     }
+    /**
+     * Table relations.
+     */
+    interface Relations {
+    }
     /**
      * Table indexes.
      */
     type Indexes<T extends Schema = Schema> = {
-        [P in `${string & keyof T}:${string & keyof T}` | keyof T]?: Index;
+        [P in keyof T]?: Index;
     };
     /**
      * Table stream.
@@ -55,6 +66,10 @@ export declare namespace Database {
          * Table schema.
          */
         schema: T;
+        /**
+         * Table relations.
+         */
+        relations?: Relations;
         /**
          * Table indexes.
          */

package/dist/services/indexes.d.ts

@@ -1,59 +1,46 @@
 import type { ArrayRest, IsArrayEmpty } from '@ez4/utils';
-import type { DatabaseTables } from './helpers.js';
-import type { Database } from './database.js';
+import type { Database, DatabaseTables } from './database.js';
 /**
  * All supported index types.
  */
 export declare const enum Index {
     Primary = "primary",
     Secondary = "secondary",
+    Unique = "unique",
     TTL = "ttl"
 }
-/**
- * An object containing only indexes.
- */
-export type Indexes = {
-    [name: string]: Index;
-};
 /**
  * Given an index name `T`, it produces the decomposed index names.
  */
 export type DecomposeIndexName<T> = T extends `${infer L}:${infer R}` ? L | DecomposeIndexName<R> : T;
 /**
- * Given an index object `T`, it produces another object containing only primary indexes.
+ * Given an index object `T`, it produces an object containing only primary indexes.
  */
-export type PrimaryIndexes<T> = {
-    [P in keyof T as T[P] extends Index.Primary ? P : never]: T[P];
+export type PrimaryIndexes<T extends Database.Indexes> = {
+    [P in keyof T as Index.Primary extends T[P] ? P : never]: T[P];
 };
 /**
- * Given an index object `T`, it produces another object containing only secondary indexes.
+ * Given an index object `T`, it produces an object containing only secondary indexes.
  */
-export type SecondaryIndexes<T> = {
-    [P in keyof T as T[P] extends Index.Secondary ? P : never]: T[P];
+export type SecondaryIndexes<T extends Database.Indexes> = {
+    [P in keyof T as Index.Secondary | Index.Unique | Index.TTL extends T[P] ? P : never]: T[P];
 };
 /**
- * Given a database service `T`, it produces an object containing all tables with indexes.
+ * Given a database service `T`, it produces an object with all tables containing indexes.
  */
-export type TableIndexes<T extends Database.Service<any>> = MergeIndexes<DatabaseTables<T>>;
+export type IndexedTables<T extends Database.Service<any>> = MergeIndexes<DatabaseTables<T>>;
 /**
  * Given a list of tables with indexes `T`, it produces another object containing all the
- * table indexes mapped by table name.
+ * table indexes.
  */
-type MergeIndexes<T extends Database.Table[]> = IsArrayEmpty<T> extends true ? {} : TableIndex<T[0]> & MergeIndexes<ArrayRest<T>>;
+type MergeIndexes<T extends Database.Table[]> = IsArrayEmpty<T> extends false ? TableIndexes<T[0]> & MergeIndexes<ArrayRest<T>> : {};
 /**
- * Given a database table `T`, it produces another object containing all its index names.
+ * Given a database table `T`, it produces an object containing all the table indexes.
  */
-type TableIndex<T> = T extends {
+type TableIndexes<T> = T extends {
     name: infer N;
     indexes: infer I;
-} ? N extends string ? {
-    [P in N]: IndexProperties<Index.Secondary, DecomposeIndexName<keyof SecondaryIndexes<I>>> | IndexProperties<Index.Primary, DecomposeIndexName<keyof PrimaryIndexes<I>>>;
-} : {} : {};
-/**
- * Given a union of indexes `U`, it produces another object containing the index type `T`
- * for each index within the union.
- */
-type IndexProperties<T extends Index, U extends string> = U extends never ? {} : {
-    [P in U]: T;
-};
+} ? N extends string ? I extends Database.Indexes ? {
+    [P in N]: I;
+} : {} : {} : {};
 export {};

package/dist/services/order.d.ts

@@ -1,5 +1,5 @@
 /**
- * Query order.
+ * Query order types.
  */
 export declare const enum Order {
     Asc = "asc",

package/dist/services/query.d.ts

@@ -1,43 +1,44 @@
-import type { AnyObject, PartialProperties, PartialObject, DeepPartial } from '@ez4/utils';
-import type { Indexes, PrimaryIndexes } from './indexes.js';
+import type { DecomposeIndexName, PrimaryIndexes } from './indexes.js';
+import type { Relations } from './relations.js';
 import type { Database } from './database.js';
 import type { Order } from './order.js';
+import type { AnyObject, PartialProperties, PartialObject, DeepPartial, FlatObject, IsObject } from '@ez4/utils';
 /**
  * Query builder types.
  */
 export declare namespace Query {
-    type InsertOneInput<T extends Database.Schema> = {
-        data: T;
+    type InsertOneInput<T extends Database.Schema, I extends Database.Indexes<T>, R extends Relations> = {
+        data: T | (Omit<T, DecomposeIndexName<keyof I>> & R);
     };
-    type UpdateOneInput<T extends Database.Schema, S extends Database.Schema, I extends Indexes> = {
+    type UpdateOneInput<T extends Database.Schema, S extends Database.Schema, I extends Database.Indexes<T>, R extends Relations> = {
         select?: S;
-        data: DeepPartial<T>;
+        data: DeepPartial<T | FlatObject<Omit<T, DecomposeIndexName<keyof I>> & R>>;
         where: WhereInput<T, I>;
     };
-    type FindOneInput<T extends Database.Schema, S extends Database.Schema, I extends Indexes> = {
+    type FindOneInput<T extends Database.Schema, S extends Database.Schema, I extends Database.Indexes<T>> = {
         select: S;
         where: WhereInput<T, I>;
     };
-    type UpsertOneInput<T extends Database.Schema, S extends Database.Schema, I extends Indexes> = {
+    type UpsertOneInput<T extends Database.Schema, S extends Database.Schema, I extends Database.Indexes<T>, R extends Relations> = {
         select?: S;
-        insert: T;
-        update: DeepPartial<T>;
+        insert: T | (Omit<T, DecomposeIndexName<keyof I>> & R);
+        update: DeepPartial<T | FlatObject<Omit<T, DecomposeIndexName<keyof I>> & R>>;
         where: WhereInput<T, I>;
     };
-    type DeleteOneInput<T extends Database.Schema, S extends Database.Schema, I extends Indexes> = {
+    type DeleteOneInput<T extends Database.Schema, S extends Database.Schema, I extends Database.Indexes<T>> = {
         select?: S;
         where: WhereInput<T, I>;
     };
     type InsertManyInput<T extends Database.Schema> = {
         data: T[];
     };
-    type UpdateManyInput<T extends Database.Schema, S extends Database.Schema> = {
+    type UpdateManyInput<T extends Database.Schema, S extends Database.Schema, I extends Database.Indexes<T>, R extends Relations> = {
         select?: S;
-        data: DeepPartial<T>;
+        data: DeepPartial<T | FlatObject<Omit<T, DecomposeIndexName<keyof I>> & R>>;
         where?: WhereInput<T>;
         limit?: number;
     };
-    type FindManyInput<T extends Database.Schema, S extends Database.Schema, I extends Indexes> = {
+    type FindManyInput<T extends Database.Schema, S extends Database.Schema, I extends Database.Indexes<T>> = {
         select: S;
         where?: WhereInput<T>;
         order?: OrderInput<I>;
@@ -50,37 +51,37 @@ export declare namespace Query {
         limit?: number;
     };
     type InsertOneResult = void;
-    type UpdateOneResult<T extends Database.Schema, S extends AnyObject> = FindOneResult<T, S> | undefined;
-    type FindOneResult<T extends Database.Schema, S extends AnyObject> = Record<T, S> | undefined;
-    type UpsertOneResult<T extends Database.Schema, S extends AnyObject> = FindOneResult<T, S> | undefined;
-    type DeleteOneResult<T extends Database.Schema, S extends AnyObject> = FindOneResult<T, S> | undefined;
+    type UpdateOneResult<T extends Database.Schema, S extends AnyObject, R extends Relations> = Record<T, S, R> | undefined;
+    type FindOneResult<T extends Database.Schema, S extends AnyObject, R extends Relations> = Record<T, S, R> | undefined;
+    type UpsertOneResult<T extends Database.Schema, S extends AnyObject, R extends Relations> = Record<T, S, R> | undefined;
+    type DeleteOneResult<T extends Database.Schema, S extends AnyObject, R extends Relations> = Record<T, S, R> | undefined;
     type InsertManyResult = void;
-    type UpdateManyResult<T extends Database.Schema, S extends AnyObject> = Record<T, S>[];
-    type FindManyResult<T extends Database.Schema, S extends AnyObject> = {
-        records: Record<T, S>[];
+    type UpdateManyResult<T extends Database.Schema, S extends AnyObject, R extends Relations> = Record<T, S, R>[];
+    type FindManyResult<T extends Database.Schema, S extends AnyObject, R extends Relations> = {
+        records: Record<T, S, R>[];
         cursor?: number | string;
     };
-    type DeleteManyResult<T extends Database.Schema, S extends AnyObject> = Record<T, S>[];
-    type Record<T extends Database.Schema, S extends AnyObject> = PartialObject<T, S, false>;
-    type SelectInput<T extends Database.Schema> = PartialProperties<T>;
-    type OrderInput<I extends Indexes> = {
-        [P in keyof I]?: Order;
+    type DeleteManyResult<T extends Database.Schema, S extends AnyObject, R extends Relations> = Record<T, S, R>[];
+    type Record<T extends Database.Schema, S extends AnyObject, R extends Relations> = PartialObject<T & R, S, false>;
+    type SelectInput<T extends Database.Schema, R extends Relations> = PartialProperties<T & R>;
+    type OrderInput<I extends Database.Indexes> = {
+        [P in DecomposeIndexName<keyof I>]?: Order;
     };
-    type WhereInput<T extends Database.Schema, I extends Indexes = never> = WhereFields<T, I> & WhereNot<T, I> & WhereAnd<T, I> & WhereOr<T, I>;
-    type WhereRequiredFields<T extends Database.Schema, I extends Indexes> = {
-        [P in keyof PrimaryIndexes<I>]: P extends keyof T ? T[P] extends AnyObject ? WhereFields<T[P], I> : T[P] | WhereOperations<T[P]> : never;
+    type WhereInput<T extends Database.Schema, I extends Database.Indexes<T> = {}> = WhereFields<T, I> & WhereNot<T, I> & WhereAnd<T, I> & WhereOr<T, I>;
+    type WhereRequiredFields<T extends Database.Schema, I extends Database.Indexes<T>> = {
+        [P in DecomposeIndexName<keyof PrimaryIndexes<I>>]: P extends keyof T ? IsObject<T[P]> extends true ? WhereFields<NonNullable<T[P]>, I> : T[P] | WhereOperations<T[P]> : never;
     };
-    type WhereOptionalFields<T extends Database.Schema, I extends Indexes> = {
-        [P in Exclude<keyof T, I>]?: T[P] extends AnyObject ? WhereFields<T[P], I> : T[P] | WhereOperations<T[P]>;
+    type WhereOptionalFields<T extends Database.Schema, I extends Database.Indexes<T>> = {
+        [P in Exclude<keyof T, DecomposeIndexName<keyof PrimaryIndexes<I>>>]?: IsObject<T[P]> extends true ? WhereFields<NonNullable<T[P]>, I> : T[P] | WhereOperations<T[P]>;
     };
-    type WhereFields<T extends Database.Schema, I extends Indexes> = WhereRequiredFields<T, I> & WhereOptionalFields<T, I>;
-    type WhereNot<T extends Database.Schema, I extends Indexes> = {
+    type WhereFields<T extends Database.Schema, I extends Database.Indexes<T>> = WhereRequiredFields<T, I> & WhereOptionalFields<T, I>;
+    type WhereNot<T extends Database.Schema, I extends Database.Indexes<T>> = {
         NOT?: WhereInput<T, I> | WhereAnd<T, I> | WhereOr<T, I>;
     };
-    type WhereAnd<T extends Database.Schema, I extends Indexes> = {
+    type WhereAnd<T extends Database.Schema, I extends Database.Indexes<T>> = {
         AND?: (WhereInput<T, I> | WhereOr<T, I> | WhereNot<T, I>)[];
     };
-    type WhereOr<T extends Database.Schema, I extends Indexes> = {
+    type WhereOr<T extends Database.Schema, I extends Database.Indexes<T>> = {
         OR?: (WhereInput<T, I> | WhereAnd<T, I> | WhereNot<T, I>)[];
     };
     type WhereOperations<T> = WhereNegate<T> | WhereEqual<T> | WhereGreaterThan<T> | WhereGreaterThanOrEqual<T> | WhereLessThan<T> | WhereLessThanOrEqual<T> | WhereIn<T> | WhereBetween<T> | WhereIsMissing | WhereIsNull | WhereStartsWith | WhereContains;

package/dist/services/relations.d.ts

@@ -0,0 +1,63 @@
+import type { ArrayRest, IsArrayEmpty, PropertyType } from '@ez4/utils';
+import type { IndexedTables, PrimaryIndexes } from './indexes.js';
+import type { Database, DatabaseTables } from './database.js';
+import type { TableSchemas } from './schemas.js';
+/**
+ * Internal relation type.
+ */
+export type Relations = Record<string, unknown>;
+/**
+ * Given a relation source name `T`, it produces the source table name.
+ */
+export type RelationSourceTable<T> = T extends `${infer U}:${string}` ? U : never;
+/**
+ * Given a relation source name `T`, it produces the source column name.
+ */
+export type RelationSourceColumn<T> = T extends `${string}:${infer U}` ? U : never;
+/**
+ * Given a relation target name `T`, it produces the target column name.
+ */
+export type RelationTargetColumn<T> = T extends `${infer U}@${string}` ? U : never;
+/**
+ * Given a relation target name `T`, it produces the target alias name.
+ */
+export type RelationTargetAlias<T> = T extends `${string}@${infer U}` ? U : never;
+/**
+ * Given a database service `T`, it produces an object with all relation tables.
+ */
+export type RelationTables<T extends Database.Service<any>> = MergeRelations<DatabaseTables<T>, TableSchemas<T>, IndexedTables<T>>;
+/**
+ * Given a list of tables with relations `T`, it produces an object containing all the
+ * relation tables.
+ */
+type MergeRelations<T extends Database.Table[], S extends Record<string, Database.Schema>, I extends Record<string, Database.Indexes>> = IsArrayEmpty<T> extends false ? TableRelation<T[0], S, I> & MergeRelations<ArrayRest<T>, S, I> : {};
+/**
+ * Given a database table `T`, it produces an object containing all its relations.
+ */
+type TableRelation<T, S extends Record<string, Database.Schema>, I extends Record<string, Database.Indexes>> = T extends {
+    name: infer N;
+    relations: infer R;
+} ? N extends string ? R extends Relations ? {
+    [P in N]: RequiredRelationSchemas<PropertyType<N, S>, S, I, R> & OptionalRelationSchemas<PropertyType<N, S>, S, I, R>;
+} : {} : {} : {};
+/**
+ * Produce an object containing only required relation schemas.
+ */
+type RequiredRelationSchemas<T extends Database.Schema, S extends Record<string, Database.Schema>, I extends Record<string, Database.Indexes>, R extends Relations> = {
+    [C in keyof R as IsOptionalRelation<C, R[C], T, I> extends true ? never : RelationTargetAlias<R[C]>]: RelationSchema<C, S, I>;
+};
+/**
+ * Produce an object containing only optional relation schemas.
+ */
+type OptionalRelationSchemas<T extends Database.Schema, S extends Record<string, Database.Schema>, I extends Record<string, Database.Indexes>, R extends Relations> = {
+    [C in keyof R as IsOptionalRelation<C, R[C], T, I> extends true ? RelationTargetAlias<R[C]> : never]?: RelationSchema<C, S, I>;
+};
+/**
+ * Check whether a relation is optional or not.
+ */
+type IsOptionalRelation<C, V, S extends Database.Schema, I extends Record<string, Database.Indexes>> = RelationSourceColumn<C> extends keyof PrimaryIndexes<PropertyType<RelationSourceTable<C>, I>> ? undefined extends PropertyType<RelationTargetColumn<V>, S> ? true : false : true;
+/**
+ * Produce a relation schema according to its indexation.
+ */
+type RelationSchema<C, S extends Record<string, Database.Schema>, I extends Record<string, Database.Indexes>> = RelationSourceColumn<C> extends keyof PrimaryIndexes<PropertyType<RelationSourceTable<C>, I>> ? PropertyType<RelationSourceTable<C>, S> : Omit<PropertyType<RelationSourceTable<C>, S>, RelationSourceColumn<C>>[];
+export {};

package/dist/services/schemas.d.ts

@@ -1,22 +1,20 @@
 import type { ArrayRest, IsArrayEmpty } from '@ez4/utils';
-import type { DatabaseTables } from './helpers.js';
-import type { Database } from './database.js';
+import type { Database, DatabaseTables } from './database.js';
 /**
  * Given a database service `T`, it produces an object containing all tables with schemas.
  */
 export type TableSchemas<T extends Database.Service<any>> = MergeTables<DatabaseTables<T>>;
 /**
- * Given a list of tables with schema `T`, it produces an object containing all schemas
- * mapped by table name.
+ * Given a list of tables with schema `T`, it produces an object containing all schemas.
  */
-type MergeTables<T extends Database.Table[]> = IsArrayEmpty<T> extends true ? {} : TableSchema<T[0]> & MergeTables<ArrayRest<T>>;
+type MergeTables<T extends Database.Table[]> = IsArrayEmpty<T> extends false ? TableSchema<T[0]> & MergeTables<ArrayRest<T>> : {};
 /**
- * Given a database table `T`, it produces an object containing the `schema`.
+ * Given a database table `T`, it produces an object containing the table schema.
  */
 type TableSchema<T> = T extends {
     name: infer N;
     schema: infer S;
-} ? N extends string ? {
+} ? N extends string ? S extends Database.Schema ? {
     [P in N]: S;
-} : {} : {};
+} : {} : {} : {};
 export {};

package/dist/services/table.d.ts

@@ -0,0 +1,85 @@
+import type { AnyObject, ArrayRest, IsArrayEmpty, IsAny, PropertyExists } from '@ez4/utils';
+import type { Relations, RelationTables } from './relations.js';
+import type { IndexedTables } from './indexes.js';
+import type { TableSchemas } from './schemas.js';
+import type { Database } from './database.js';
+import type { Query } from './query.js';
+/**
+ * Given an array of schemas `T`, it returns an union of `Database.Table` for each schema.
+ */
+export type TableTypes<T extends Database.Schema[]> = IsAny<T> extends true ? any : IsArrayEmpty<T> extends true ? Database.Table<Database.Schema> : Database.Table<T[0]> | TableTypes<ArrayRest<T>>;
+/**
+ * Given an indexed table `T` and a property `P`, it returns all the indexes corresponding
+ * to the given property.
+ */
+export type TableIndex<P, T extends AnyObject> = PropertyExists<P, T> extends true ? (T[P] extends Database.Indexes ? T[P] : {}) : {};
+/**
+ * Given a table `T` and a property `P`, it returns all the relations corresponding
+ * to the given property.
+ */
+export type TableRelation<P, T extends AnyObject> = PropertyExists<P, T> extends true ? (T[P] extends Relations ? T[P] : {}) : {};
+/**
+ * Given a database service `T`, it returns all table clients.
+ */
+export type TableClients<T extends Database.Service<any>> = {
+    [P in keyof TableSchemas<T>]: TableSchemas<T>[P] extends Database.Schema ? Table<TableSchemas<T>[P], TableIndex<P, IndexedTables<T>>, TableRelation<P, RelationTables<T>>> : never;
+};
+/**
+ * Table client.
+ */
+export interface Table<T extends Database.Schema, I extends Database.Indexes<T>, R extends Relations> {
+    /**
+     * Insert one record into the database.
+     *
+     * @param query Input query.
+     */
+    insertOne(query: Query.InsertOneInput<T, I, R>): Promise<Query.InsertOneResult>;
+    /**
+     * Find one database record.
+     *
+     * @param query Input query.
+     */
+    findOne<S extends Query.SelectInput<T, R>>(query: Query.FindOneInput<T, S, I>): Promise<Query.FindOneResult<T, S, R>>;
+    /**
+     * Update one database record.
+     *
+     * @param query Input query.
+     */
+    updateOne<S extends Query.SelectInput<T, R>>(query: Query.UpdateOneInput<T, S, I, R>): Promise<Query.UpdateOneResult<T, S, R>>;
+    /**
+     * Try to insert a database record, and if it already exists, perform an update instead.
+     *
+     * @param query Input query.
+     */
+    upsertOne<S extends Query.SelectInput<T, R>>(query: Query.UpsertOneInput<T, S, I, R>): Promise<Query.UpsertOneResult<T, S, R>>;
+    /**
+     * Delete one database record.
+     *
+     * @param query Input query.
+     */
+    deleteOne<S extends Query.SelectInput<T, R>>(query: Query.DeleteOneInput<T, S, I>): Promise<Query.DeleteOneResult<T, S, R>>;
+    /**
+     * Insert multiple records into the database.
+     *
+     * @param query Input query.
+     */
+    insertMany(query: Query.InsertManyInput<T>): Promise<Query.InsertManyResult>;
+    /**
+     * Find multiple database records.
+     *
+     * @param query Input query.
+     */
+    findMany<S extends Query.SelectInput<T, R>>(query: Query.FindManyInput<T, S, I>): Promise<Query.FindManyResult<T, S, R>>;
+    /**
+     * Update multiple database records.
+     *
+     * @param query Input query.
+     */
+    updateMany<S extends Query.SelectInput<T, R>>(query: Query.UpdateManyInput<T, S, I, R>): Promise<Query.UpdateManyResult<T, S, R>>;
+    /**
+     * Delete multiple database records.
+     *
+     * @param query Input query.
+     */
+    deleteMany<S extends Query.SelectInput<T, R>>(query: Query.DeleteManyInput<T, S>): Promise<Query.DeleteManyResult<T, S, R>>;
+}

package/dist/services/transaction.d.ts

@@ -1,4 +1,6 @@
-import type { Indexes, TableIndexes } from './indexes.js';
+import type { Relations, RelationTables } from './relations.js';
+import type { TableIndex, TableRelation } from './table.js';
+import type { IndexedTables } from './indexes.js';
 import type { TableSchemas } from './schemas.js';
 import type { Database } from './database.js';
 import type { Query } from './query.js';
@@ -11,17 +13,17 @@ export declare namespace Transaction {
      */
     export type WriteOperations<T extends Database.Service<any>> = {
         [P in keyof TableSchemas<T>]?: TableSchemas<T>[P] extends Database.Schema ? {
-            [alias: string]: InsertOperation<TableSchemas<T>[P]> | UpdateOperation<TableSchemas<T>[P], P extends keyof TableIndexes<T> ? TableIndexes<T>[P] extends Indexes ? TableIndexes<T>[P] : never : never> | DeleteOperation<TableSchemas<T>[P], P extends keyof TableIndexes<T> ? TableIndexes<T>[P] extends Indexes ? TableIndexes<T>[P] : never : never>;
+            [alias: string]: InsertOperation<TableSchemas<T>[P], TableIndex<P, IndexedTables<T>>, TableRelation<P, RelationTables<T>>> | UpdateOperation<TableSchemas<T>[P], TableIndex<P, IndexedTables<T>>, TableRelation<P, RelationTables<T>>> | DeleteOperation<TableSchemas<T>[P], TableIndex<P, IndexedTables<T>>, TableRelation<P, RelationTables<T>>>;
         } : never;
     };
-    type InsertOperation<T extends Database.Schema> = {
-        insert: Query.InsertOneInput<T>;
+    type InsertOperation<T extends Database.Schema, I extends Database.Indexes<T>, R extends Relations> = {
+        insert: Query.InsertOneInput<T, I, R>;
     };
-    type UpdateOperation<T extends Database.Schema, I extends Indexes> = {
-        update: Omit<Query.UpdateOneInput<T, Query.SelectInput<T>, I>, 'select'>;
+    type UpdateOperation<T extends Database.Schema, I extends Database.Indexes<T>, R extends Relations> = {
+        update: Omit<Query.UpdateOneInput<T, Query.SelectInput<T, R>, I, R>, 'select'>;
     };
-    type DeleteOperation<T extends Database.Schema, I extends Indexes> = {
-        delete: Omit<Query.DeleteOneInput<T, Query.SelectInput<T>, I>, 'select'>;
+    type DeleteOperation<T extends Database.Schema, I extends Database.Indexes<T>, R extends Relations> = {
+        delete: Omit<Query.DeleteOneInput<T, Query.SelectInput<T, R>, I>, 'select'>;
     };
     export {};
 }

package/dist/types/indexes.d.ts

@@ -1,2 +1,6 @@
 import type { Index } from '../services/indexes.js';
-export type TableIndexes = Record<string, Index>;
+export type TableIndex = {
+    name: string;
+    columns: string[];
+    type: Index;
+};

package/dist/types/relations.d.ts

@@ -0,0 +1,7 @@
+export type TableRelation = {
+    sourceTable: string;
+    sourceColumn: string;
+    targetColumn: string;
+    targetAlias: string;
+    foreign: boolean;
+};

package/dist/types/table.d.ts

@@ -1,9 +1,11 @@
+import type { TableRelation } from './relations.js';
+import type { TableIndex } from './indexes.js';
 import type { TableSchema } from './schema.js';
-import type { TableIndexes } from './indexes.js';
 import type { TableStream } from './stream.js';
 export type DatabaseTable = {
     name: string;
     schema: TableSchema;
-    indexes: TableIndexes;
+    relations?: TableRelation[];
+    indexes: TableIndex[];
     stream?: TableStream;
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ez4/database",
   "description": "EZ4: Components to build database services",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "author": "Silas B.",
   "license": "MIT",
   "type": "module",
@@ -42,12 +42,12 @@
     "live:publish": "npm run test && npm publish --access public"
   },
   "peerDependencies": {
-    "@ez4/project": "^0.8.0"
+    "@ez4/project": "^0.9.0"
   },
   "dependencies": {
-    "@ez4/common": "^0.8.0",
-    "@ez4/reflection": "^0.8.0",
-    "@ez4/schema": "^0.8.0",
-    "@ez4/utils": "^0.8.0"
+    "@ez4/common": "^0.9.0",
+    "@ez4/reflection": "^0.9.0",
+    "@ez4/schema": "^0.9.0",
+    "@ez4/utils": "^0.9.0"
   }
 }