@ez4/database 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Silas B.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+# EZ4: Database

package/dist/errors/handler.d.ts

@@ -0,0 +1,4 @@
+import { IncompleteTypeError } from '@ez4/common/library';
+export declare class IncompleteHandlerError extends IncompleteTypeError {
+    constructor(properties: string[], fileName?: string);
+}

package/dist/errors/indexes.d.ts

@@ -0,0 +1,16 @@
+import { IncorrectTypeError, InvalidTypeError, TypeError } from '@ez4/common/library';
+export declare class InvalidIndexesTypeError extends InvalidTypeError {
+    constructor(fileName?: string);
+}
+export declare class IncorrectIndexesTypeError extends IncorrectTypeError {
+    schemaType: string;
+    constructor(schemaType: string, fileName?: string);
+}
+export declare class InvalidIndexTypeError extends TypeError {
+    indexName: string;
+    constructor(indexName: string, fileName?: string);
+}
+export declare class InvalidIndexReferenceError extends TypeError {
+    indexName: string;
+    constructor(indexName: string, fileName?: string);
+}

package/dist/errors/schema.d.ts

@@ -0,0 +1,8 @@
+import { IncorrectTypeError, InvalidTypeError } from '@ez4/common/library';
+export declare class InvalidSchemaTypeError extends InvalidTypeError {
+    constructor(fileName?: string);
+}
+export declare class IncorrectSchemaTypeError extends IncorrectTypeError {
+    schemaType: string;
+    constructor(schemaType: string, fileName?: string);
+}

package/dist/errors/service.d.ts

@@ -0,0 +1,4 @@
+import { IncompleteTypeError } from '@ez4/common/library';
+export declare class IncompleteServiceError extends IncompleteTypeError {
+    constructor(properties: string[], fileName?: string);
+}

package/dist/errors/stream.d.ts

@@ -0,0 +1,4 @@
+import { IncompleteTypeError } from '@ez4/common/library';
+export declare class IncompleteStreamError extends IncompleteTypeError {
+    constructor(properties: string[], fileName?: string);
+}

package/dist/errors/table.d.ts

@@ -0,0 +1,4 @@
+import { IncompleteTypeError } from '@ez4/common/library';
+export declare class IncompleteTableError extends IncompleteTypeError {
+    constructor(properties: string[], fileName?: string);
+}

package/dist/library.cjs

@@ -0,0 +1,65 @@
+"use strict";var P=Object.defineProperty;var me=Object.getOwnPropertyDescriptor;var le=Object.getOwnPropertyNames;var ce=Object.prototype.hasOwnProperty;var ue=(e,t)=>{for(var r in t)P(e,r,{get:t[r],enumerable:!0})},be=(e,t,r,o)=>{if(t&&
+typeof t=="object"||typeof t=="function")for(let a of le(t))!ce.call(e,a)&&a!==r&&
+P(e,a,{get:()=>t[a],enumerable:!(o=me(t,a))||o.enumerable});return e};var fe=e=>be(P({},"__esModule",{value:!0}),e);var ve={};ue(ve,{IncompleteHandlerError:()=>j,IncompleteServiceError:()=>y,IncompleteStreamError:()=>D,
+IncompleteTableError:()=>g,IncorrectIndexesTypeError:()=>x,IncorrectSchemaTypeError:()=>I,
+InvalidIndexReferenceError:()=>h,InvalidIndexTypeError:()=>M,InvalidIndexesTypeError:()=>S,
+InvalidSchemaTypeError:()=>v,ServiceType:()=>E,getDatabaseServices:()=>R,getDatabaseTable:()=>H,
+getTableSchema:()=>C,isDatabaseService:()=>Te,registerTriggers:()=>he});module.exports=
+fe(ve);var ne=require("@ez4/common/library"),ie=require("@ez4/schema/library"),pe=require("@ez4/project");var c=require("@ez4/common/library"),ae=require("@ez4/reflection");var E="@ez4/database",Te=e=>e.type===E;var V=require("@ez4/common/library"),y=class extends V.IncompleteTypeError{constructor(t,r){
+super("Incomplete database service",t,r)}};var T=require("@ez4/common/library"),d=require("@ez4/reflection");var N=require("@ez4/common/library"),g=class extends N.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)}},x=class extends u.IncorrectTypeError{constructor(r,o){
+super("Incorrect table indexes type",r,"Database.Indexes",o);this.schemaType=r}},
+M=class extends u.TypeError{constructor(r,o){super(`Invalid index type, ${r} mus\
+t follow one of the Index options.`,o);this.indexName=r}},h=class extends u.TypeError{constructor(r,o){
+super(`Invalid index reference, ${r} must be valid column.`,o);this.indexName=r}};var p=require("@ez4/common/library"),k=require("@ez4/reflection"),A=e=>(0,p.isClassDeclaration)(
+e)&&(0,p.hasHeritageType)(e,"Database.Service"),q=e=>(0,p.isModelDeclaration)(e)&&
+(0,p.hasHeritageType)(e,"Database.Table"),U=e=>(0,p.hasHeritageType)(e,"Database\
+.Schema"),$=e=>(0,p.hasHeritageType)(e,"Database.Indexes"),_=e=>(0,p.isModelDeclaration)(
+e)&&(0,p.hasHeritageType)(e,"Database.Stream"),B=e=>(0,k.isTypeCallback)(e)||(0,k.isTypeFunction)(
+e);var w=require("@ez4/reflection"),J=require("@ez4/common/library"),z=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)}},I=class extends O.IncorrectTypeError{constructor(r,o){
+super("Incorrect table schema type",r,"Database.Schema",o);this.schemaType=r}};var C=(e,t,r,o)=>{if(!(0,w.isTypeReference)(e))return G(e,t,r,o);let a=r[e.path];
+return a?G(a,t,r,o):null},G=(e,t,r,o)=>(0,w.isTypeObject)(e)?(0,z.getObjectSchema)(
+e,r):(0,J.isModelDeclaration)(e)?U(e)?(0,z.getObjectSchema)(e,r):(o.push(new I(e.
+name,e.file)),null):(o.push(new v(t.file)),null);var m=require("@ez4/common/library"),b=require("@ez4/reflection");var W=(e,t,r,o)=>{if(!(0,b.isTypeReference)(e))return K(e,t,o);let a=r[e.path];return a?
+K(a,t,o):null},K=(e,t,r)=>(0,b.isTypeObject)(e)?Q(e,(0,m.getObjectMembers)(e),r):
+(0,m.isModelDeclaration)(e)?$(e)?Q(e,(0,m.getModelMembers)(e),r):(r.push(new x(e.
+name,e.file)),null):(r.push(new S(t.file)),null),Q=(e,t,r)=>{let o={};for(let a of t){
+if(!(0,b.isModelProperty)(a))continue;let s=a.name,i=(0,m.getPropertyString)(a);
+switch(i){case"primary":case"regular":case"unique":case"ttl":o[s]=i;break;default:
+return r.push(new M(s,e.file)),null}}return o};var l=require("@ez4/common/library"),f=require("@ez4/reflection");var X=require("@ez4/common/library"),D=class extends X.IncompleteTypeError{constructor(t,r){
+super("Incomplete table stream",t,r)}};var Y=require("@ez4/common/library"),j=class extends Y.IncompleteTypeError{constructor(t,r){
+super("Incomplete stream handler",t,r)}};var Z=(e,t,r)=>{if(!B(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&&de(o)?o:(r.push(new j([...a],e.file)),null)},de=e=>!!e.name&&!!e.file;var re=(e,t,r)=>{if(!(0,f.isTypeReference)(e))return L(e,t,r);let o=t[e.path];return o?
+L(o,t,r):null},ye=e=>!!e.handler,L=(e,t,r)=>_(e)?ee(e,(0,l.getModelMembers)(e),t,
+r):(0,f.isTypeObject)(e)?ee(e,(0,l.getObjectMembers)(e),t,r):null,ee=(e,t,r,o)=>{
+let a={},s=new Set(["handler"]);for(let i of t)if((0,f.isModelProperty)(i))switch(i.
+name){case"timeout":case"memory":{let n=(0,l.getPropertyNumber)(i);n!=null&&(a[i.
+name]=n);break}case"handler":a.handler=Z(i.value,r,o);break;case"variables":a.variables=
+(0,l.getLinkedVariables)(i,o);break}return ye(a)?a:(o.push(new D([...s],e.file)),
+null)};var H=(e,t,r)=>{if(!(0,d.isTypeReference)(e))return te(e,t,r);let o=t[e.path];return o?
+te(o,t,r):null},ge=e=>!!e.name&&!!e.schema&&!!e.indexes,te=(e,t,r)=>q(e)?oe(e,(0,T.getModelMembers)(
+e),t,r):(0,d.isTypeObject)(e)?oe(e,(0,T.getObjectMembers)(e),t,r):null,oe=(e,t,r,o)=>{
+let a={},s=new Set(["name","schema","indexes"]);for(let n of t)if((0,d.isModelProperty)(
+n))switch(n.name){case"name":(a.name=(0,T.getPropertyString)(n))&&s.delete(n.name);
+break;case"schema":{(a.schema=C(n.value,e,r,o))&&s.delete(n.name);break}case"ind\
+exes":{(a.indexes=W(n.value,e,r,o))&&s.delete(n.name);break}case"stream":{a.stream=
+re(n.value,r,o);break}}if(!ge(a))return o.push(new g([...s],e.file)),null;let i=Se(
+e,a.indexes,a.schema);return i.length?(o.push(...i),null):a},Se=(e,t,r)=>{let o=r.
+properties,a=[];for(let s in t)for(let i of s.split(":"))o[i]||a.push(new h(s,e.
+file));return a};var R=e=>{let t={},r=[];for(let o in e){let a=e[o];if(!A(a))continue;let s={type:E},
+i=new Set(["tables"]);s.name=a.name;for(let n of(0,c.getModelMembers)(a))if((0,ae.isModelProperty)(
+n))switch(n.name){case"tables":(s.tables=Me(n,e,r))&&i.delete(n.name);break;case"\
+variables":s.variables=(0,c.getLinkedVariables)(n,r);break;case"services":s.services=
+(0,c.getLinkedServices)(n,e,r);break}if(!xe(s)){r.push(new y([...i],a.file));continue}
+t[a.name]=s}return{services:t,errors:r}},xe=e=>!!e.name&&!!e.tables,Me=(e,t,r)=>{
+let o=(0,c.getPropertyTuple)(e)??[],a=[];for(let s of o){let i=H(s,t,r);i&&a.push(
+i)}return a};var se=e=>A(e)?e.name:null;var F=!1,he=()=>(F||((0,ne.registerTriggers)(),(0,ie.registerTriggers)(),(0,pe.createTrigger)(
+"@ez4/database",{"metadata:getServices":R,"metadata:getLinkedService":se}),F=!0),
+F);0&&(module.exports={IncompleteHandlerError,IncompleteServiceError,IncompleteStreamError,
+IncompleteTableError,IncorrectIndexesTypeError,IncorrectSchemaTypeError,InvalidIndexReferenceError,
+InvalidIndexTypeError,InvalidIndexesTypeError,InvalidSchemaTypeError,ServiceType,
+getDatabaseServices,getDatabaseTable,getTableSchema,isDatabaseService,registerTriggers});

package/dist/library.d.ts

@@ -0,0 +1,13 @@
+export * from './triggers/register.js';
+export * from './metadata/service.js';
+export * from './metadata/table.js';
+export * from './metadata/schema.js';
+export * from './errors/service.js';
+export * from './errors/table.js';
+export * from './errors/schema.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/schema.js';

package/dist/library.mjs

@@ -0,0 +1,56 @@
+import{registerTriggers as He}from"@ez4/common/library";import{registerTriggers as Re}from"@ez4/schema/library";
+import{createTrigger as Fe}from"@ez4/project";import{getLinkedServices as ke,getLinkedVariables as Ae,getModelMembers as Oe,getPropertyTuple as we}from"@ez4/common/library";
+import{isModelProperty as Pe}from"@ez4/reflection";var x="@ez4/database",Ve=e=>e.type===x;import{IncompleteTypeError as B}from"@ez4/common/library";var m=class extends B{constructor(t,r){
+super("Incomplete database service",t,r)}};import{getModelMembers as xe,getObjectMembers as Me,getPropertyString as he}from"@ez4/common/library";
+import{isModelProperty as ve,isTypeObject as Ie,isTypeReference as De}from"@ez4/reflection";import{IncompleteTypeError as G}from"@ez4/common/library";var l=class extends G{constructor(t,r){
+super("Incomplete database table",t,r)}};import{IncorrectTypeError as J,InvalidTypeError as K,TypeError as h}from"@ez4/common/library";
+var c=class extends K{constructor(t){super("Invalid table indexes type",void 0,"\
+Database.Indexes",t)}},u=class extends J{constructor(r,o){super("Incorrect table\
+ indexes type",r,"Database.Indexes",o);this.schemaType=r}},b=class extends h{constructor(r,o){
+super(`Invalid index type, ${r} must follow one of the Index options.`,o);this.indexName=
+r}},f=class extends h{constructor(r,o){super(`Invalid index reference, ${r} must\
+ be valid column.`,o);this.indexName=r}};import{hasHeritageType as p,isClassDeclaration as Q,isModelDeclaration as v}from"@ez4/common/library";
+import{isTypeCallback as W,isTypeFunction as X}from"@ez4/reflection";var T=e=>Q(
+e)&&p(e,"Database.Service"),I=e=>v(e)&&p(e,"Database.Table"),D=e=>p(e,"Database.\
+Schema"),j=e=>p(e,"Database.Indexes"),E=e=>v(e)&&p(e,"Database.Stream"),k=e=>W(e)||
+X(e);import{isTypeObject as L,isTypeReference as ee}from"@ez4/reflection";import{isModelDeclaration as re}from"@ez4/common/library";
+import{getObjectSchema as A}from"@ez4/schema/library";import{IncorrectTypeError as Y,InvalidTypeError as Z}from"@ez4/common/library";var d=class extends Z{constructor(t){
+super("Invalid table schema type",void 0,"Database.Schema",t)}},y=class extends Y{constructor(r,o){
+super("Incorrect table schema type",r,"Database.Schema",o);this.schemaType=r}};var w=(e,t,r,o)=>{if(!ee(e))return O(e,t,r,o);let a=r[e.path];return a?O(a,t,r,o):
+null},O=(e,t,r,o)=>L(e)?A(e,r):re(e)?D(e)?A(e,r):(o.push(new y(e.name,e.file)),null):
+(o.push(new d(t.file)),null);import{isModelDeclaration as te,getModelMembers as oe,getObjectMembers as ae,getPropertyString as se}from"@ez4/common/library";
+import{isModelProperty as ne,isTypeObject as ie,isTypeReference as pe}from"@ez4/reflection";var C=(e,t,r,o)=>{if(!pe(e))return P(e,t,o);let a=r[e.path];return a?P(a,t,o):null},
+P=(e,t,r)=>ie(e)?z(e,ae(e),r):te(e)?j(e)?z(e,oe(e),r):(r.push(new u(e.name,e.file)),
+null):(r.push(new c(t.file)),null),z=(e,t,r)=>{let o={};for(let a of t){if(!ne(a))
+continue;let s=a.name,i=se(a);switch(i){case"primary":case"regular":case"unique":case"\
+ttl":o[s]=i;break;default:return r.push(new b(s,e.file)),null}}return o};import{getLinkedVariables as ue,getModelMembers as be,getObjectMembers as fe,getPropertyNumber as Te}from"@ez4/common/library";
+import{isModelProperty as de,isTypeObject as ye,isTypeReference as ge}from"@ez4/reflection";import{IncompleteTypeError as me}from"@ez4/common/library";var g=class extends me{constructor(t,r){
+super("Incomplete table stream",t,r)}};import{IncompleteTypeError as le}from"@ez4/common/library";var S=class extends le{constructor(t,r){
+super("Incomplete stream handler",t,r)}};var H=(e,t,r)=>{if(!k(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&&ce(o)?o:(r.push(new S([...a],e.file)),null)},ce=e=>!!e.name&&!!e.file;var V=(e,t,r)=>{if(!ge(e))return R(e,t,r);let o=t[e.path];return o?R(o,t,r):null},
+Se=e=>!!e.handler,R=(e,t,r)=>E(e)?F(e,be(e),t,r):ye(e)?F(e,fe(e),t,r):null,F=(e,t,r,o)=>{
+let a={},s=new Set(["handler"]);for(let i of t)if(de(i))switch(i.name){case"time\
+out":case"memory":{let n=Te(i);n!=null&&(a[i.name]=n);break}case"handler":a.handler=
+H(i.value,r,o);break;case"variables":a.variables=ue(i,o);break}return Se(a)?a:(o.
+push(new g([...s],e.file)),null)};var U=(e,t,r)=>{if(!De(e))return N(e,t,r);let o=t[e.path];return o?N(o,t,r):null},
+je=e=>!!e.name&&!!e.schema&&!!e.indexes,N=(e,t,r)=>I(e)?q(e,xe(e),t,r):Ie(e)?q(e,
+Me(e),t,r):null,q=(e,t,r,o)=>{let a={},s=new Set(["name","schema","indexes"]);for(let n of t)
+if(ve(n))switch(n.name){case"name":(a.name=he(n))&&s.delete(n.name);break;case"s\
+chema":{(a.schema=w(n.value,e,r,o))&&s.delete(n.name);break}case"indexes":{(a.indexes=
+C(n.value,e,r,o))&&s.delete(n.name);break}case"stream":{a.stream=V(n.value,r,o);
+break}}if(!je(a))return o.push(new l([...s],e.file)),null;let i=Ee(e,a.indexes,a.
+schema);return i.length?(o.push(...i),null):a},Ee=(e,t,r)=>{let o=r.properties,a=[];
+for(let s in t)for(let i of s.split(":"))o[i]||a.push(new f(s,e.file));return a};var $=e=>{let t={},r=[];for(let o in e){let a=e[o];if(!T(a))continue;let s={type:x},
+i=new Set(["tables"]);s.name=a.name;for(let n of Oe(a))if(Pe(n))switch(n.name){case"\
+tables":(s.tables=Ce(n,e,r))&&i.delete(n.name);break;case"variables":s.variables=
+Ae(n,r);break;case"services":s.services=ke(n,e,r);break}if(!ze(s)){r.push(new m(
+[...i],a.file));continue}t[a.name]=s}return{services:t,errors:r}},ze=e=>!!e.name&&
+!!e.tables,Ce=(e,t,r)=>{let o=we(e)??[],a=[];for(let s of o){let i=U(s,t,r);i&&a.
+push(i)}return a};var _=e=>T(e)?e.name:null;var M=!1,Kr=()=>(M||(He(),Re(),Fe("@ez4/database",{"metadata:getServices":$,"met\
+adata:getLinkedService":_}),M=!0),M);export{S as IncompleteHandlerError,m as IncompleteServiceError,g as IncompleteStreamError,
+l as IncompleteTableError,u as IncorrectIndexesTypeError,y as IncorrectSchemaTypeError,
+f as InvalidIndexReferenceError,b as InvalidIndexTypeError,c as InvalidIndexesTypeError,
+d as InvalidSchemaTypeError,x as ServiceType,$ as getDatabaseServices,U as getDatabaseTable,
+w as getTableSchema,Ve as isDatabaseService,Kr as registerTriggers};

package/dist/main.cjs

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

package/dist/main.d.ts

@@ -0,0 +1,5 @@
+export * from './services/client.js';
+export * from './services/helpers.js';
+export * from './services/database.js';
+export * from './services/indexes.js';
+export * from './services/stream.js';

package/dist/main.mjs

@@ -0,0 +1,2 @@
+var r;(o=>{})(r||={});var a=(e=>(e.Primary="primary",e.Regular="regular",e.Unique="unique",e.TTL="ttl",
+e))(a||{});var m=(t=>(t.Insert="insert",t.Update="update",t.Delete="delete",t))(m||{});export{r as Database,a as Index,m as StreamType};

package/dist/metadata/handler.d.ts

@@ -0,0 +1,3 @@
+import type { AllType, SourceMap } from '@ez4/reflection';
+import type { StreamHandler } from '../types/handler.js';
+export declare const getStreamHandler: (type: AllType, _reflection: SourceMap, errorList: Error[]) => StreamHandler | null;

package/dist/metadata/indexes.d.ts

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

package/dist/metadata/schema.d.ts

@@ -0,0 +1,4 @@
+import type { AllType, SourceMap, TypeModel, TypeObject } from '@ez4/reflection';
+type TypeParent = TypeModel | TypeObject;
+export declare const getTableSchema: (type: AllType, parent: TypeParent, reflection: SourceMap, errorList: Error[]) => import("@ez4/schema/library").ObjectSchema | null;
+export {};

package/dist/metadata/service.d.ts

@@ -0,0 +1,6 @@
+import type { SourceMap } from '@ez4/reflection';
+import type { DatabaseService } from '../types/service.js';
+export declare const getDatabaseServices: (reflection: SourceMap) => {
+    services: Record<string, DatabaseService>;
+    errors: Error[];
+};

package/dist/metadata/stream.d.ts

@@ -0,0 +1,3 @@
+import type { AllType, SourceMap } from '@ez4/reflection';
+import type { TableStream } from '../types/stream.js';
+export declare const getTableStream: (type: AllType, reflection: SourceMap, errorList: Error[]) => TableStream | null;

package/dist/metadata/table.d.ts

@@ -0,0 +1,3 @@
+import type { AllType, SourceMap } from '@ez4/reflection';
+import type { DatabaseTable } from '../types/table.js';
+export declare const getDatabaseTable: (type: AllType, reflection: SourceMap, errorList: Error[]) => DatabaseTable | null;

package/dist/metadata/utils.d.ts

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

package/dist/richtypes/schema.d.ts

@@ -0,0 +1,10 @@
+export declare namespace Schema {
+    /**
+     * Set property to be a primary index.
+     */
+    type Primary<T> = T;
+    /**
+     * Set property to be a regular index.
+     */
+    type Index<T> = T;
+}

package/dist/richtypes/utils.d.ts

@@ -0,0 +1,104 @@
+import type { EveryType, TypeObject } from '@ez4/reflection';
+export type RichTypes = {
+    index?: string;
+    type: EveryType;
+};
+export declare const getRichTypes: (type: TypeObject) => RichTypes | null;
+export declare const createRichType: (richType: RichTypes) => {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Object;
+    file?: string;
+    members?: import("@ez4/reflection").EveryMemberType[];
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Any;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Void;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Never;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Unknown;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Undefined;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Null;
+    literal?: boolean;
+    default?: boolean;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Boolean;
+    literal?: boolean;
+    default?: boolean;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Number;
+    literal?: number;
+    default?: number;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.String;
+    literal?: string;
+    default?: string;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Reference;
+    namespace?: string;
+    internal?: boolean;
+    path: string;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Union;
+    elements: EveryType[];
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Array;
+    element: EveryType;
+    spread?: boolean;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Tuple;
+    elements: EveryType[];
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Callback;
+    name?: string;
+    file?: string;
+    description?: string;
+    parameters?: import("@ez4/reflection").TypeParameter[];
+    return?: EveryType;
+} | null;

package/dist/services/client.d.ts

@@ -0,0 +1,119 @@
+import type { AnyObject, PartialProperties, PartialObject, DeepPartial } from '@ez4/utils';
+import type { TableSchemas } from './helpers.js';
+import type { Database } from './database.js';
+/**
+ * Database client.
+ */
+export interface Client<T extends Database.Service<any>> {
+    /**
+     * Prepare and execute the given query.
+     *
+     * @param query Query statement.
+     * @param values Optional values to prepare the query.
+     * @returns Returns the results for the given query.
+     */
+    rawQuery(query: string, values?: unknown[]): Promise<Record<string, unknown>[]>;
+    /**
+     * Table clients.
+     */
+    table: ClientTables<T>;
+}
+export type ClientTables<T extends Database.Service<any>> = {
+    [P in keyof TableSchemas<T>]: TableSchemas<T>[P] extends Database.Schema ? Table<TableSchemas<T>[P]> : never;
+};
+export interface Table<T extends Database.Schema> {
+    insertOne(query: Query.InsertOneInput<T>): Promise<Query.InsertOneResult>;
+    updateMany<U extends Query.SelectInput<T>>(query: Query.UpdateManyInput<T, U>): Promise<Query.UpdateManyResult<T, U>>;
+    findFirst<U extends Query.SelectInput<T>>(query: Query.FindFirstInput<T, U>): Promise<Query.FindFirstResult<T, U>>;
+    findMany<U extends Query.SelectInput<T>>(query: Query.FindManyInput<T, U>): Promise<Query.FindManyResult<T, U>>;
+    deleteMany<U extends Query.SelectInput<T>>(query: Query.DeleteManyInput<T, U>): Promise<Query.DeleteManyResult<T, U>>;
+}
+export declare namespace Query {
+    type InsertOneInput<T extends Database.Schema> = {
+        data: T;
+    };
+    type UpdateManyInput<T extends Database.Schema, S extends Database.Schema> = {
+        select?: S;
+        data: DeepPartial<T>;
+        where: WhereInput<T>;
+        cursor?: number | string;
+        limit?: number;
+    };
+    type FindManyInput<T extends Database.Schema, S extends Database.Schema> = {
+        select: S;
+        where: WhereInput<T>;
+        cursor?: number | string;
+        limit?: number;
+    };
+    type DeleteManyInput<T extends Database.Schema, S extends Database.Schema> = {
+        select?: S;
+        where: WhereInput<T>;
+        cursor?: number | string;
+        limit?: number;
+    };
+    type FindFirstInput<T extends Database.Schema, S extends Database.Schema> = {
+        select: S;
+        where: WhereInput<T>;
+    };
+    type InsertOneResult = void;
+    type UpdateManyResult<T extends Database.Schema, S extends AnyObject> = Record<T, S>[];
+    type FindFirstResult<T extends Database.Schema, S extends AnyObject> = Record<T, S> | undefined;
+    type FindManyResult<T extends Database.Schema, S extends AnyObject> = {
+        records: Record<T, S>[];
+        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> = WhereFields<T> & WhereNot<T> & WhereAnd<T> & WhereOr<T>;
+    type WhereFields<T extends Database.Schema> = {
+        [P in keyof T]?: T[P] extends AnyObject ? WhereFields<T[P]> : T[P] | WhereOperations<T[P]>;
+    };
+    type WhereNot<T extends Database.Schema> = {
+        NOT?: WhereInput<T> | WhereAnd<T> | WhereOr<T>;
+    };
+    type WhereAnd<T extends Database.Schema> = {
+        AND?: (WhereInput<T> | WhereOr<T> | WhereNot<T>)[];
+    };
+    type WhereOr<T extends Database.Schema> = {
+        OR?: (WhereInput<T> | WhereAnd<T> | WhereNot<T>)[];
+    };
+    type WhereOperations<T> = WhereNegate<T> | WhereEqual<T> | WhereGreaterThan<T> | WhereGreaterThanOrEqual<T> | WhereLessThan<T> | WhereLessThanOrEqual<T> | WhereIn<T> | WhereBetween<T> | WhereIsMissing | WhereIsNull | WhereStartsWith | WhereContains;
+    type WhereOperators = keyof (WhereNegate<any> & WhereEqual<any> & WhereGreaterThan<any> & WhereGreaterThanOrEqual<any> & WhereLessThan<any> & WhereLessThanOrEqual<any> & WhereIn<any> & WhereBetween<any> & WhereIsMissing & WhereIsNull & WhereStartsWith & WhereContains);
+    type WhereNegate<T> = {
+        not: T | WhereOperations<T>;
+    };
+    type WhereEqual<T> = {
+        equal: T;
+    };
+    type WhereGreaterThan<T> = {
+        gt: T;
+    };
+    type WhereGreaterThanOrEqual<T> = {
+        gte: T;
+    };
+    type WhereLessThan<T> = {
+        lt: T;
+    };
+    type WhereLessThanOrEqual<T> = {
+        lte: T;
+    };
+    type WhereIn<T> = {
+        isIn: T[];
+    };
+    type WhereBetween<T> = {
+        isBetween: [T, T];
+    };
+    type WhereIsMissing = {
+        isMissing: boolean;
+    };
+    type WhereIsNull = {
+        isNull: boolean;
+    };
+    type WhereStartsWith = {
+        startsWith: string;
+    };
+    type WhereContains = {
+        contains: string;
+    };
+}

package/dist/services/database.d.ts

@@ -0,0 +1,80 @@
+import type { Service } from '@ez4/common';
+import type { LinkedVariables } from '@ez4/project';
+import type { TableTypes } from './helpers.js';
+import type { StreamChange } from './stream.js';
+import type { Index } from './indexes.js';
+import type { Client } from './client.js';
+/**
+ * Provide all contracts for a self-managed database service.
+ */
+export declare namespace Database {
+    /**
+     * Table schema.
+     */
+    interface Schema {
+    }
+    /**
+     * Table indexes.
+     */
+    type Indexes<T extends Schema = Schema> = {
+        [P in `${string & keyof T}:${string & keyof T}` | keyof T]?: Index;
+    };
+    /**
+     * Table stream.
+     */
+    interface Stream<T extends Schema = Schema> {
+        /**
+         * Stream handler.
+         *
+         * @param change Stream change.
+         * @param context Handler context.
+         */
+        handler: (change: StreamChange<T>, context: Service.Context<Service<any>>) => void | Promise<void>;
+        /**
+         * Variables associated to the route.
+         */
+        variables?: LinkedVariables;
+        /**
+         * Max route execution time (in seconds) for the handler.
+         */
+        timeout?: number;
+        /**
+         * Amount of memory available for the handler.
+         */
+        memory?: number;
+    }
+    /**
+     * Database table.
+     */
+    interface Table<T extends Schema = Schema> {
+        /**
+         * Table name.
+         */
+        name: string;
+        /**
+         * Table schema.
+         */
+        schema: T;
+        /**
+         * Table indexes.
+         */
+        indexes: Indexes<T>;
+        /**
+         * Table stream configuration.
+         */
+        stream?: Stream<T>;
+    }
+    /**
+     * Database service.
+     */
+    abstract class Service<T extends Schema[] = [Schema]> implements Service.Provider {
+        /**
+         * All service tables.
+         */
+        abstract tables: TableTypes<T>[];
+        /**
+         * Service client.
+         */
+        client: Client<Service<T>>;
+    }
+}

package/dist/services/helpers.d.ts

@@ -0,0 +1,30 @@
+import type { ArrayRest, IsArrayEmpty, IsAny } from '@ez4/utils';
+import type { Database } from './database.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 a database service `T`, it returns a map containing all its tables and schemas.
+ */
+export type TableSchemas<T extends Database.Service<any>> = MergeTables<ServiceTables<T>>;
+/**
+ * Given a database service `T`, it returns all its table types.
+ */
+type ServiceTables<T> = T extends {
+    tables: infer U;
+} ? U : [];
+/**
+ * Given a list of database tables `T`, it returns an object containing all table names and schemas.
+ */
+type MergeTables<T extends Database.Table[]> = IsArrayEmpty<T> extends true ? {} : TableRecord<T[0]> & MergeTables<ArrayRest<T>>;
+/**
+ * Given a database table `T`, it returns a table record containing its `name` and `schema`.
+ */
+type TableRecord<T> = T extends {
+    name: infer N;
+    schema: infer S;
+} ? N extends string ? {
+    [P in N]: S;
+} : {} : {};
+export {};

package/dist/services/indexes.d.ts

@@ -0,0 +1,9 @@
+/**
+ * All supported index types.
+ */
+export declare const enum Index {
+    Primary = "primary",
+    Regular = "regular",
+    Unique = "unique",
+    TTL = "ttl"
+}

package/dist/services/stream.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Stream change for `insert`, `update` or `delete` operations.
+ */
+export type StreamChange<T> = StreamInsertChange<T> | StreamUpdateChange<T> | StreamDeleteChange<T>;
+/**
+ * Stream change for an `insert` operation.
+ */
+export type StreamInsertChange<T> = {
+    type: StreamType.Insert;
+    record: T;
+};
+/**
+ * Stream change for an `update` operation.
+ */
+export type StreamUpdateChange<T> = {
+    type: StreamType.Update;
+    oldRecord: T;
+    newRecord: T;
+};
+/**
+ * Stream change for an `delete` operation.
+ */
+export type StreamDeleteChange<T> = {
+    type: StreamType.Delete;
+    record: T;
+};
+/**
+ * Stream change types.
+ */
+export declare const enum StreamType {
+    Insert = "insert",
+    Update = "update",
+    Delete = "delete"
+}

package/dist/triggers/register.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Register all triggers.
+ */
+export declare const registerTriggers: () => true;

package/dist/triggers/richtypes.d.ts

@@ -0,0 +1,100 @@
+import type { TypeObject } from '@ez4/reflection';
+export declare const applyRichTypePath: (file: string) => string | null;
+export declare const applyRichTypeObject: (type: TypeObject) => {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Object;
+    file?: string;
+    members?: import("@ez4/reflection").EveryMemberType[];
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Any;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Void;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Never;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Unknown;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Undefined;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Null;
+    literal?: boolean;
+    default?: boolean;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Boolean;
+    literal?: boolean;
+    default?: boolean;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Number;
+    literal?: number;
+    default?: number;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.String;
+    literal?: string;
+    default?: string;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Reference;
+    namespace?: string;
+    internal?: boolean;
+    path: string;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Union;
+    elements: import("@ez4/reflection").EveryType[];
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Array;
+    element: import("@ez4/reflection").EveryType;
+    spread?: boolean;
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Tuple;
+    elements: import("@ez4/reflection").EveryType[];
+} | {
+    extra: {
+        index: "primary" | "regular";
+    };
+    type: import("@ez4/reflection").TypeName.Callback;
+    name?: string;
+    file?: string;
+    description?: string;
+    parameters?: import("@ez4/reflection").TypeParameter[];
+    return?: import("@ez4/reflection").EveryType;
+} | null;

package/dist/triggers/service.d.ts

@@ -0,0 +1,2 @@
+import type { TypeClass } from '@ez4/reflection';
+export declare const getLinkedService: (statement: TypeClass) => string | null;

package/dist/types/handler.d.ts

@@ -0,0 +1,5 @@
+export type StreamHandler = {
+    name: string;
+    file: string;
+    description?: string;
+};

package/dist/types/indexes.d.ts

@@ -0,0 +1,2 @@
+import type { Index } from '../services/indexes.js';
+export type TableIndexes = Record<string, Index>;

package/dist/types/schema.d.ts

@@ -0,0 +1,2 @@
+import type { ObjectSchema } from '@ez4/schema';
+export type TableSchema = ObjectSchema;

package/dist/types/service.d.ts

@@ -0,0 +1,9 @@
+import type { ServiceMetadata } from '@ez4/project';
+import type { DatabaseTable } from './table.js';
+export declare const ServiceType = "@ez4/database";
+export type DatabaseService = ServiceMetadata & {
+    type: typeof ServiceType;
+    name: string;
+    tables: DatabaseTable[];
+};
+export declare const isDatabaseService: (service: ServiceMetadata) => service is DatabaseService;

package/dist/types/stream.d.ts

@@ -0,0 +1,8 @@
+import type { LinkedVariables } from '@ez4/project';
+import type { StreamHandler } from './handler.js';
+export type TableStream = {
+    handler: StreamHandler;
+    variables?: LinkedVariables | null;
+    timeout?: number;
+    memory?: number;
+};

package/dist/types/table.d.ts

@@ -0,0 +1,9 @@
+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;
+    stream?: TableStream;
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@ez4/database",
+  "description": "EZ4: Components to build database services",
+  "version": "0.1.0",
+  "author": "Silas B.",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/main.d.ts",
+      "require": "./dist/main.cjs",
+      "import": "./dist/main.mjs"
+    },
+    "./library": {
+      "types": "./dist/library.d.ts",
+      "require": "./dist/library.cjs",
+      "import": "./dist/library.mjs"
+    }
+  },
+  "workspaces": [
+    "packages/*"
+  ],
+  "scripts": {
+    "clean": "rm -f *.tsbuildinfo && rm -rf dist/*",
+    "build": "tsc -p tsconfig.json && node tools/bundler.mjs",
+    "test": "npm run test:types && node --test --import ../../tools/tsnode.mjs test/*.spec.ts",
+    "test:only": "npm run test:types && node --test-only --test --import ../../tools/tsnode.mjs test/*.spec.ts",
+    "test:types": "npm run build && tsc -p tsconfig.test.json",
+    "local:publish": "npm run build && npm run clean:registry && npm publish --registry http://localhost:4873",
+    "clean:registry": "rm -rf ../../.registry/@ez4/database",
+    "live:publish": "npm run test && npm publish --access public"
+  },
+  "dependencies": {
+    "@ez4/common": "^0.1.0",
+    "@ez4/project": "^0.1.0",
+    "@ez4/reflection": "^0.1.0",
+    "@ez4/schema": "^0.1.0",
+    "@ez4/utils": "^0.1.0"
+  }
+}