@ez4/database 0.7.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,67 +1,95 @@
-"use strict";var C=Object.defineProperty;var ce=Object.getOwnPropertyDescriptor;var ue=Object.getOwnPropertyNames;var be=Object.prototype.hasOwnProperty;var fe=(e,t)=>{for(var r in t)C(e,r,{get:t[r],enumerable:!0})},Te=(e,t,r,a)=>{if(t&&
-typeof t=="object"||typeof t=="function")for(let o of ue(t))!be.call(e,o)&&o!==r&&
-C(e,o,{get:()=>t[o],enumerable:!(a=ce(t,o))||a.enumerable});return e};var de=e=>Te(C({},"__esModule",{value:!0}),e);var De={};fe(De,{IncompleteHandlerError:()=>A,IncompleteServiceError:()=>x,IncompleteStreamError:()=>j,
-IncompleteTableError:()=>g,IncorrectIndexesTypeError:()=>M,IncorrectSchemaTypeError:()=>D,
-IncorrectStreamTypeError:()=>P,InvalidIndexReferenceError:()=>I,InvalidIndexTypeError:()=>h,
-InvalidIndexesTypeError:()=>S,InvalidSchemaTypeError:()=>v,InvalidStreamTypeError:()=>E,
-ServiceType:()=>k,getDatabaseServices:()=>F,getDatabaseTable:()=>q,getTableSchema:()=>N,
-isDatabaseService:()=>ye,registerTriggers:()=>ve});module.exports=de(De);var pe=require("@ez4/common/library"),me=require("@ez4/schema/library"),le=require("@ez4/project/library");var c=require("@ez4/common/library"),se=require("@ez4/reflection");var k="@ez4/database",ye=e=>e.type===k;var V=require("@ez4/common/library"),x=class extends V.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"),U=e=>(0,p.isModelDeclaration)(e)&&
-(0,p.hasHeritageType)(e,"Database.Table"),$=e=>(0,w.isTypeCallback)(e)||(0,w.isTypeFunction)(
-e),_=e=>(0,p.hasHeritageType)(e,"Database.Indexes"),B=e=>(0,p.hasHeritageType)(e,
-"Database.Schema"),G=e=>(0,p.hasHeritageType)(e,"Database.Stream");var d=require("@ez4/common/library"),y=require("@ez4/reflection");var J=require("@ez4/common/library"),g=class extends J.IncompleteTypeError{constructor(t,r){
-super("Incomplete database table",t,r)}};var u=require("@ez4/common/library"),S=class extends u.InvalidTypeError{constructor(t){
-super("Invalid table indexes type",void 0,"Database.Indexes",t)}},M=class extends u.IncorrectTypeError{constructor(r,a){
-super("Incorrect table indexes type",r,"Database.Indexes",a);this.schemaType=r}},
-h=class extends u.TypeError{constructor(r,a){super(`Invalid index type, ${r} mus\
-t follow one of the Index options.`,a);this.indexName=r}},I=class extends u.TypeError{constructor(r,a){
-super(`Invalid index reference, ${r} must be valid column.`,a);this.indexName=r}};var R=require("@ez4/reflection"),Q=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 N=(e,t,r,a)=>{if(!(0,R.isTypeReference)(e))return K(e,t,r,a);let o=r[e.path];
-return o?K(o,t,r,a):null},K=(e,t,r,a)=>(0,R.isTypeObject)(e)?(0,H.getObjectSchema)(
-e,r):(0,Q.isModelDeclaration)(e)?B(e)?(0,H.getObjectSchema)(e,r):(a.push(new D(e.
-name,e.file)),null):(a.push(new v(t.file)),null);var l=require("@ez4/common/library"),b=require("@ez4/reflection");var Y=(e,t,r,a)=>{if(!(0,b.isTypeReference)(e))return W(e,t,a);let o=r[e.path];return o?
-W(o,t,a):null},W=(e,t,r)=>(0,b.isTypeObject)(e)?X(e,(0,l.getObjectMembers)(e),r):
-(0,l.isModelDeclaration)(e)?_(e)?X(e,(0,l.getModelMembers)(e),r):(r.push(new M(e.
-name,e.file)),null):(r.push(new S(t.file)),null),X=(e,t,r)=>{let a={};for(let o of t){
-if(!(0,b.isModelProperty)(o)||o.inherited)continue;let n=o.name,i=(0,l.getPropertyString)(
-o);switch(i){case"primary":case"regular":case"unique":case"ttl":a[n]=i;break;default:
-return r.push(new h(n,e.file)),null}}return a};var m=require("@ez4/common/library"),T=require("@ez4/reflection");var f=require("@ez4/common/library"),j=class extends f.IncompleteTypeError{constructor(t,r){
-super("Incomplete table stream",t,r)}},E=class extends f.InvalidTypeError{constructor(t){
-super("Invalid table stream type",void 0,"Database.Stream",t)}},P=class extends f.IncorrectTypeError{constructor(r,a){
-super("Incorrect table stream type",r,"Database.Stream",a);this.streamType=r}};var Z=require("@ez4/common/library"),A=class extends Z.IncompleteTypeError{constructor(t,r){
-super("Incomplete stream handler",t,r)}};var L=(e,t,r)=>{if(!$(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&&xe(a)?a:(r.push(new A([...o],e.file)),null)},xe=e=>!!e.name&&!!e.file;var te=(e,t,r,a)=>{if(!(0,T.isTypeReference)(e))return ee(e,t,r,a);let o=r[e.path];
-return o?ee(o,t,r,a):null},ge=e=>!!e.handler,ee=(e,t,r,a)=>(0,T.isTypeObject)(e)?
-re(e,(0,m.getObjectMembers)(e),r,a):(0,m.isModelDeclaration)(e)?G(e)?re(e,(0,m.getModelMembers)(
-e),r,a):(a.push(new P(e.name,e.file)),null):(a.push(new E(t.file)),null),re=(e,t,r,a)=>{
-let o={},n=new Set(["handler"]);for(let i of t)if(!(!(0,T.isModelProperty)(i)||i.
-inherited))switch(i.name){case"handler":o.handler=L(i.value,r,a);break;case"time\
-out":case"memory":{let s=(0,m.getPropertyNumber)(i);s!=null&&(o[i.name]=s);break}case"\
-variables":o.variables=(0,m.getLinkedVariableList)(i,a);break}return ge(o)?o:(a.
-push(new j([...n],e.file)),null)};var q=(e,t,r)=>{if(!(0,y.isTypeReference)(e))return ae(e,t,r);let a=t[e.path];return a?
-ae(a,t,r):null},Se=e=>!!e.name&&!!e.schema&&!!e.indexes,ae=(e,t,r)=>U(e)?oe(e,(0,d.getModelMembers)(
-e),t,r):(0,y.isTypeObject)(e)?oe(e,(0,d.getObjectMembers)(e),t,r):null,oe=(e,t,r,a)=>{
-let o={},n=new Set(["name","schema","indexes"]);for(let s of t)if(!(!(0,y.isModelProperty)(
-s)||s.inherited))switch(s.name){case"name":(o.name=(0,d.getPropertyString)(s))&&
-n.delete(s.name);break;case"indexes":{(o.indexes=Y(s.value,e,r,a))&&n.delete(s.name);
-break}case"schema":{(o.schema=N(s.value,e,r,a))&&n.delete(s.name);break}case"str\
-eam":{o.stream=te(s.value,e,r,a);break}}if(!Se(o))return a.push(new g([...n],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 n in t)for(let i of n.split(":"))a[i]||o.push(new I(
-n,e.file));return o};var F=e=>{let t={},r=[];for(let a in e){let o=e[a];if(!z(o))continue;let n={type:k},
-i=new Set(["tables"]);n.name=o.name;for(let s of(0,c.getModelMembers)(o))if(!(!(0,se.isModelProperty)(
-s)||s.inherited))switch(s.name){case"tables":(n.tables=Ie(s,e,r))&&i.delete(s.name);
-break;case"variables":n.variables=(0,c.getLinkedVariableList)(s,r);break;case"se\
-rvices":n.services=(0,c.getLinkedServiceList)(s,e,r);break}if(!he(n)){r.push(new x(
-[...i],o.file));continue}t[o.name]=n}return{services:t,errors:r}},he=e=>!!e.name&&
-!!e.tables,Ie=(e,t,r)=>{let a=(0,c.getPropertyTuple)(e)??[],o=[];for(let n of a){
-let i=q(n,t,r);i&&o.push(i)}return o};var ne=e=>z(e)?e.name:null;var ie=!1,ve=()=>{ie||((0,pe.registerTriggers)(),(0,me.registerTriggers)(),(0,le.createTrigger)(
-"@ez4/database",{"metadata:getServices":F,"metadata:getLinkedService":ne}),ie=!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,62 +1,89 @@
-import{registerTriggers as Ve}from"@ez4/common/library";import{registerTriggers as Ue}from"@ez4/schema/library";
-import{createTrigger as $e}from"@ez4/project/library";import{getLinkedServiceList as Oe,getLinkedVariableList as Re,getModelMembers as Ce,
-getPropertyTuple as He}from"@ez4/common/library";import{isModelProperty as Ne}from"@ez4/reflection";var h="@ez4/database",_e=e=>e.type===h;import{IncompleteTypeError as G}from"@ez4/common/library";var m=class extends G{constructor(t,r){
-super("Incomplete database service",t,r)}};import{hasHeritageType as p,isClassDeclaration as J,isModelDeclaration as K}from"@ez4/common/library";
-import{isTypeCallback as Q,isTypeFunction as W}from"@ez4/reflection";var l=e=>J(
-e)&&p(e,"Database.Service"),I=e=>K(e)&&p(e,"Database.Table"),v=e=>Q(e)||W(e),D=e=>p(
-e,"Database.Indexes"),j=e=>p(e,"Database.Schema"),E=e=>p(e,"Database.Stream");import{getModelMembers as De,getObjectMembers as je,getPropertyString as Ee}from"@ez4/common/library";
-import{isModelProperty as Pe,isTypeObject as Ae,isTypeReference as ke}from"@ez4/reflection";import{IncompleteTypeError as X}from"@ez4/common/library";var c=class extends X{constructor(t,r){
-super("Incomplete database table",t,r)}};import{IncorrectTypeError as Y,InvalidTypeError as Z,TypeError as P}from"@ez4/common/library";
-var u=class extends Z{constructor(t){super("Invalid table indexes type",void 0,"\
-Database.Indexes",t)}},b=class extends Y{constructor(r,a){super("Incorrect table\
- indexes type",r,"Database.Indexes",a);this.schemaType=r}},f=class extends P{constructor(r,a){
-super(`Invalid index type, ${r} must follow one of the Index options.`,a);this.indexName=
-r}},T=class extends P{constructor(r,a){super(`Invalid index reference, ${r} must\
- be valid column.`,a);this.indexName=r}};import{isTypeObject as re,isTypeReference as te}from"@ez4/reflection";import{isModelDeclaration as ae}from"@ez4/common/library";
-import{getObjectSchema as A}from"@ez4/schema/library";import{IncorrectTypeError as L,InvalidTypeError as ee}from"@ez4/common/library";
-var d=class extends ee{constructor(t){super("Invalid table schema type",void 0,"\
-Database.Schema",t)}},y=class extends L{constructor(r,a){super("Incorrect table \
-schema type",r,"Database.Schema",a);this.schemaType=r}};var w=(e,t,r,a)=>{if(!te(e))return k(e,t,r,a);let o=r[e.path];return o?k(o,t,r,a):
-null},k=(e,t,r,a)=>re(e)?A(e,r):ae(e)?j(e)?A(e,r):(a.push(new y(e.name,e.file)),
-null):(a.push(new d(t.file)),null);import{isModelDeclaration as oe,getModelMembers as se,getObjectMembers as ne,getPropertyString as ie}from"@ez4/common/library";
-import{isModelProperty as pe,isTypeObject as me,isTypeReference as le}from"@ez4/reflection";var R=(e,t,r,a)=>{if(!le(e))return z(e,t,a);let o=r[e.path];return o?z(o,t,a):null},
-z=(e,t,r)=>me(e)?O(e,ne(e),r):oe(e)?D(e)?O(e,se(e),r):(r.push(new b(e.name,e.file)),
-null):(r.push(new u(t.file)),null),O=(e,t,r)=>{let a={};for(let o of t){if(!pe(o)||
-o.inherited)continue;let n=o.name,i=ie(o);switch(i){case"primary":case"regular":case"\
-unique":case"ttl":a[n]=i;break;default:return r.push(new f(n,e.file)),null}}return a};import{getLinkedVariableList as de,getModelMembers as ye,getObjectMembers as xe,
-getPropertyNumber as ge,isModelDeclaration as Se}from"@ez4/common/library";import{
-isModelProperty as Me,isTypeObject as he,isTypeReference as Ie}from"@ez4/reflection";import{IncompleteTypeError as ce,IncorrectTypeError as ue,InvalidTypeError as be}from"@ez4/common/library";
-var x=class extends ce{constructor(t,r){super("Incomplete table stream",t,r)}},g=class extends be{constructor(t){
-super("Invalid table stream type",void 0,"Database.Stream",t)}},S=class extends ue{constructor(r,a){
-super("Incorrect table stream type",r,"Database.Stream",a);this.streamType=r}};import{IncompleteTypeError as fe}from"@ez4/common/library";var M=class extends fe{constructor(t,r){
-super("Incomplete stream handler",t,r)}};var C=(e,t,r)=>{if(!v(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&&Te(a)?a:(r.push(new M([...o],e.file)),null)},Te=e=>!!e.name&&!!e.file;var q=(e,t,r,a)=>{if(!Ie(e))return H(e,t,r,a);let o=r[e.path];return o?H(o,t,r,a):
-null},ve=e=>!!e.handler,H=(e,t,r,a)=>he(e)?N(e,xe(e),r,a):Se(e)?E(e)?N(e,ye(e),r,
-a):(a.push(new S(e.name,e.file)),null):(a.push(new g(t.file)),null),N=(e,t,r,a)=>{
-let o={},n=new Set(["handler"]);for(let i of t)if(!(!Me(i)||i.inherited))switch(i.
-name){case"handler":o.handler=C(i.value,r,a);break;case"timeout":case"memory":{let s=ge(
-i);s!=null&&(o[i.name]=s);break}case"variables":o.variables=de(i,a);break}return ve(
-o)?o:(a.push(new x([...n],e.file)),null)};var U=(e,t,r)=>{if(!ke(e))return F(e,t,r);let a=t[e.path];return a?F(a,t,r):null},
-we=e=>!!e.name&&!!e.schema&&!!e.indexes,F=(e,t,r)=>I(e)?V(e,De(e),t,r):Ae(e)?V(e,
-je(e),t,r):null,V=(e,t,r,a)=>{let o={},n=new Set(["name","schema","indexes"]);for(let s of t)
-if(!(!Pe(s)||s.inherited))switch(s.name){case"name":(o.name=Ee(s))&&n.delete(s.name);
-break;case"indexes":{(o.indexes=R(s.value,e,r,a))&&n.delete(s.name);break}case"s\
-chema":{(o.schema=w(s.value,e,r,a))&&n.delete(s.name);break}case"stream":{o.stream=
-q(s.value,e,r,a);break}}if(!we(o))return a.push(new c([...n],e.file)),null;let i=ze(
-e,o.indexes,o.schema);return i.length?(a.push(...i),null):o},ze=(e,t,r)=>{let a=r.
-properties,o=[];for(let n in t)for(let i of n.split(":"))a[i]||o.push(new T(n,e.
-file));return o};var $=e=>{let t={},r=[];for(let a in e){let o=e[a];if(!l(o))continue;let n={type:h},
-i=new Set(["tables"]);n.name=o.name;for(let s of Ce(o))if(!(!Ne(s)||s.inherited))
-switch(s.name){case"tables":(n.tables=Fe(s,e,r))&&i.delete(s.name);break;case"va\
-riables":n.variables=Re(s,r);break;case"services":n.services=Oe(s,e,r);break}if(!qe(
-n)){r.push(new m([...i],o.file));continue}t[o.name]=n}return{services:t,errors:r}},
-qe=e=>!!e.name&&!!e.tables,Fe=(e,t,r)=>{let a=He(e)??[],o=[];for(let n of a){let i=U(
-n,t,r);i&&o.push(i)}return o};var _=e=>l(e)?e.name:null;var B=!1,Zr=()=>{B||(Ve(),Ue(),$e("@ez4/database",{"metadata:getServices":$,"met\
-adata:getLinkedService":_}),B=!0)};export{M 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,
-u as InvalidIndexesTypeError,d as InvalidSchemaTypeError,g as InvalidStreamTypeError,
-h as ServiceType,$ as getDatabaseServices,U as getDatabaseTable,w as getTableSchema,
-_e as isDatabaseService,Zr 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 i=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var x=Object.prototype.hasOwnProperty;var d=(r,t)=>{for(var n in t)s(r,n,{get:t[n],enumerable:!0})},y=(r,t,n,a)=>{if(t&&
-typeof t=="object"||typeof t=="function")for(let e of T(t))!x.call(r,e)&&e!==n&&
-s(r,e,{get:()=>t[e],enumerable:!(a=i(t,e))||a.enumerable});return r};var c=r=>y(s({},"__esModule",{value:!0}),r);var l={};d(l,{Database:()=>o,Index:()=>m,StreamType:()=>p});module.exports=c(l);var o;(r=>{})(o||={});var m=(e=>(e.Primary="primary",e.Regular="regular",e.Unique="unique",e.TTL="ttl",
-e))(m||{});var p=(a=>(a.Insert="insert",a.Update="update",a.Delete="delete",a))(p||{});0&&(module.exports={Database,Index,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,6 +1,9 @@
-export * from './services/query.js';
-export * from './services/client.js';
-export * from './services/database.js';
-export * from './services/indexes.js';
-export * from './services/schemas.js';
 export * from './services/streams.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,2 +1,2 @@
-var r;(s=>{})(r||={});var a=(e=>(e.Primary="primary",e.Regular="regular",e.Unique="unique",e.TTL="ttl",
-e))(a||{});var n=(t=>(t.Insert="insert",t.Update="update",t.Delete="delete",t))(n||{});export{r as Database,a as Index,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,11 +1,10 @@
-import type { TableIndexes } from './indexes.js';
-import type { TableSchemas } from './schemas.js';
+import type { TableClients } from './table.js';
+import type { Transaction } from './transaction.js';
 import type { Database } from './database.js';
-import type { Query } from './query.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.
      *
@@ -14,24 +13,10 @@ export type Client<T extends Database.Service<any>> = ClientTables<T> & {
      * @returns Returns the results for the given query.
      */
     rawQuery(query: string, values?: unknown[]): Promise<Record<string, unknown>[]>;
+    /**
+     * Prepare and execute the given transaction.
+     *
+     * @param operations Transaction operations.
+     */
+    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 string ? TableIndexes<T>[P] : never : never> : never;
-};
-/**
- * Client table.
- */
-export interface Table<T extends Database.Schema, I extends string | never> {
-    insertOne(query: Query.InsertOneInput<T>): Promise<Query.InsertOneResult>;
-    updateOne<S extends Query.SelectInput<T>>(query: Query.UpdateOneInput<T, S, I>): Promise<Query.UpdateOneResult<T, S>>;
-    findOne<S extends Query.SelectInput<T>>(query: Query.FindOneInput<T, S, I>): Promise<Query.FindOneResult<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>;
-    updateMany<S extends Query.SelectInput<T>>(query: Query.UpdateManyInput<T, S>): Promise<Query.UpdateManyResult<T, S>>;
-    findMany<S extends Query.SelectInput<T>>(query: Query.FindManyInput<T, S>): Promise<Query.FindManyResult<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.
          */
@@ -69,7 +84,12 @@ export declare namespace Database {
      */
     abstract class Service<T extends Schema[] = [Schema]> implements Service.Provider {
         /**
-         * All service tables.
+         * Determines which database engine to use.
+         * Check the provider package to know all the possible values.
+         */
+        abstract engine: string;
+        /**
+         * Describe all available tables for the service.
          */
         abstract tables: TableTypes<T>[];
         /**

package/dist/services/indexes.d.ts

@@ -1,12 +1,11 @@
 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",
-    Regular = "regular",
+    Secondary = "secondary",
     Unique = "unique",
     TTL = "ttl"
 }
@@ -15,27 +14,33 @@ export declare const enum Index {
  */
 export type DecomposeIndexName<T> = T extends `${infer L}:${infer R}` ? L | DecomposeIndexName<R> : T;
 /**
- * Given an index object `T`, it produces an index object containing only unique indexes.
+ * Given an index object `T`, it produces an object containing only primary indexes.
  */
-export type UniqueIndexes<T> = {
-    [P in keyof T as T[P] extends Index.Primary | Index.Unique ? 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 a database service `T`, it produces an object containing all tables with indexes.
+ * Given an index object `T`, it produces an object containing only secondary indexes.
  */
-export type TableIndexes<T extends Database.Service<any>> = MergeIndexes<DatabaseTables<T>>;
+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 with all tables containing indexes.
+ */
+export type IndexedTables<T extends Database.Service<any>> = MergeIndexes<DatabaseTables<T>>;
 /**
- * Given a list of tables with indexes `T`, it produces an object containing all primary
- * indexes mapped by table name.
+ * Given a list of tables with indexes `T`, it produces another object containing all the
+ * 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 an object containing all the primary 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]: DecomposeIndexName<keyof UniqueIndexes<I>>;
-} : {} : {};
+} ? N extends string ? I extends Database.Indexes ? {
+    [P in N]: I;
+} : {} : {} : {};
 export {};

package/dist/services/order.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Query order types.
+ */
+export declare const enum Order {
+    Asc = "asc",
+    Desc = "desc"
+}

package/dist/services/query.d.ts

@@ -1,40 +1,47 @@
-import type { AnyObject, PartialProperties, PartialObject, DeepPartial } from '@ez4/utils';
+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 string | never> = {
+    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 string | never> = {
+    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 string | never> = {
+    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 string | never> = {
+    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> = {
+    type FindManyInput<T extends Database.Schema, S extends Database.Schema, I extends Database.Indexes<T>> = {
         select: S;
         where?: WhereInput<T>;
+        order?: OrderInput<I>;
         cursor?: number | string;
         limit?: number;
     };
@@ -44,34 +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 WhereInput<T extends Database.Schema, I extends string | never = never> = WhereFields<T, I> & WhereNot<T, I> & WhereAnd<T, I> & WhereOr<T, I>;
-    type WhereRequiredFields<T extends Database.Schema, I extends string | never> = {
-        [P in I]: P extends keyof T ? T[P] extends AnyObject ? WhereFields<T[P], I> : T[P] | WhereOperations<T[P]> : never;
+    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 WhereOptionalFields<T extends Database.Schema, I extends string | never> = {
-        [P in Exclude<keyof T, I>]?: T[P] extends AnyObject ? WhereFields<T[P], I> : T[P] | WhereOperations<T[P]>;
+    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 WhereFields<T extends Database.Schema, I extends string | never> = WhereRequiredFields<T, I> & WhereOptionalFields<T, I>;
-    type WhereNot<T extends Database.Schema, I extends string | never> = {
+    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 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 string | never> = {
+    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 string | never> = {
+    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

@@ -0,0 +1,29 @@
+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';
+/**
+ * Transaction builder types.
+ */
+export declare namespace Transaction {
+    /**
+     * Write operations.
+     */
+    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], 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, I extends Database.Indexes<T>, R extends Relations> = {
+        insert: Query.InsertOneInput<T, I, R>;
+    };
+    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 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/service.d.ts

@@ -4,6 +4,7 @@ export declare const ServiceType = "@ez4/database";
 export type DatabaseService = ServiceMetadata & {
     type: typeof ServiceType;
     name: string;
+    engine: string;
     tables: DatabaseTable[];
 };
 export declare const isDatabaseService: (service: ServiceMetadata) => service is DatabaseService;

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.7.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.7.0"
+    "@ez4/project": "^0.9.0"
   },
   "dependencies": {
-    "@ez4/common": "^0.7.0",
-    "@ez4/reflection": "^0.7.0",
-    "@ez4/schema": "^0.7.0",
-    "@ez4/utils": "^0.7.0"
+    "@ez4/common": "^0.9.0",
+    "@ez4/reflection": "^0.9.0",
+    "@ez4/schema": "^0.9.0",
+    "@ez4/utils": "^0.9.0"
   }
 }