@ez4/database 0.1.0 → 0.2.0

package/README.md

@@ -1 +1,3 @@
 # EZ4: Database
+
+It uses the power of [reflection](../reflection/) to provide an API which determines how to build and connect database components.

package/dist/library.cjs

@@ -5,7 +5,7 @@ IncompleteTableError:()=>g,IncorrectIndexesTypeError:()=>x,IncorrectSchemaTypeEr
 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){
+fe(ve);var ne=require("@ez4/common/library"),ie=require("@ez4/schema/library"),pe=require("@ez4/project/library");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){

package/dist/library.mjs

@@ -1,5 +1,5 @@
 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{createTrigger as Fe}from"@ez4/project/library";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){

package/dist/main.cjs

@@ -1,4 +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&&
+"use strict";var o=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var T=Object.prototype.hasOwnProperty;var l=(r,t)=>{for(var m in t)o(r,m,{get:t[m],enumerable:!0})},S=(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",
+o(r,e,{get:()=>t[e],enumerable:!(a=s(t,e))||a.enumerable});return r};var x=r=>S(o({},"__esModule",{value:!0}),r);var d={};l(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/services/client.d.ts

@@ -4,7 +4,7 @@ import type { Database } from './database.js';
 /**
  * Database client.
  */
-export interface Client<T extends Database.Service<any>> {
+export type Client<T extends Database.Service<any>> = ClientTables<T> & {
     /**
      * Prepare and execute the given query.
      *
@@ -13,18 +13,15 @@ export interface Client<T extends Database.Service<any>> {
      * @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>;
+    findOne<U extends Query.SelectInput<T>>(query: Query.FindOneInput<T, U>): Promise<Query.FindOneResult<T, U>>;
+    upsertOne<U extends Query.SelectInput<T>>(query: Query.UpsertOneInput<T, U>): Promise<Query.UpsertOneResult<T, U>>;
     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>>;
 }
@@ -32,6 +29,16 @@ export declare namespace Query {
     type InsertOneInput<T extends Database.Schema> = {
         data: T;
     };
+    type FindOneInput<T extends Database.Schema, S extends Database.Schema> = {
+        select: S;
+        where: WhereInput<T>;
+    };
+    type UpsertOneInput<T extends Database.Schema, S extends Database.Schema> = {
+        select?: S;
+        insert: T;
+        update: DeepPartial<T>;
+        where: WhereInput<T>;
+    };
     type UpdateManyInput<T extends Database.Schema, S extends Database.Schema> = {
         select?: S;
         data: DeepPartial<T>;
@@ -51,13 +58,10 @@ export declare namespace Query {
         cursor?: number | string;
         limit?: number;
     };
-    type FindFirstInput<T extends Database.Schema, S extends Database.Schema> = {
-        select: S;
-        where: WhereInput<T>;
-    };
     type InsertOneResult = void;
+    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 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;

package/dist/services/database.d.ts

@@ -1,5 +1,5 @@
 import type { Service } from '@ez4/common';
-import type { LinkedVariables } from '@ez4/project';
+import type { LinkedVariables } from '@ez4/project/library';
 import type { TableTypes } from './helpers.js';
 import type { StreamChange } from './stream.js';
 import type { Index } from './indexes.js';

package/dist/types/service.d.ts

@@ -1,4 +1,4 @@
-import type { ServiceMetadata } from '@ez4/project';
+import type { ServiceMetadata } from '@ez4/project/library';
 import type { DatabaseTable } from './table.js';
 export declare const ServiceType = "@ez4/database";
 export type DatabaseService = ServiceMetadata & {

package/dist/types/stream.d.ts

@@ -1,4 +1,4 @@
-import type { LinkedVariables } from '@ez4/project';
+import type { LinkedVariables } from '@ez4/project/library';
 import type { StreamHandler } from './handler.js';
 export type TableStream = {
     handler: StreamHandler;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ez4/database",
   "description": "EZ4: Components to build database services",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "author": "Silas B.",
   "license": "MIT",
   "type": "module",
@@ -31,10 +31,10 @@
     "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"
+    "@ez4/common": "^0.2.0",
+    "@ez4/project": "^0.2.0",
+    "@ez4/reflection": "^0.2.0",
+    "@ez4/schema": "^0.2.0",
+    "@ez4/utils": "^0.2.0"
   }
 }