@restura/core 0.1.0-alpha.7 → 0.1.0-alpha.9

package/dist/index.d.mts

@@ -1,23 +1,58 @@
 import winston from 'winston';
 import * as express from 'express';
 import { z } from 'zod';
+import { PoolConfig, Pool } from 'pg';
+import { IncomingHttpHeaders } from 'http2';
 
 declare const logger: winston.Logger;
 
+interface RsErrorInternalData {
+    err: ErrorCode;
+    msg: string;
+    stack: string;
+    status: number;
+    message?: string;
+}
+declare enum HtmlStatusCodes {
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    METHOD_NOT_ALLOWED = 405,
+    CONFLICT = 409,
+    VERSION_OUT_OF_DATE = 418,// Technically this is the I'm a teapot code that was a joke.
+    SERVER_ERROR = 500,
+    SERVICE_UNAVAILABLE = 503,
+    NETWORK_CONNECT_TIMEOUT = 599
+}
+type ErrorCode = 'UNKNOWN_ERROR' | 'NOT_FOUND' | 'EMAIL_TAKEN' | 'UNAUTHORIZED' | 'FORBIDDEN' | 'CONFLICT' | 'UPDATE_FORBIDDEN' | 'CREATE_FORBIDDEN' | 'DELETE_FORBIDDEN' | 'DELETE_FAILURE' | 'BAD_REQUEST' | 'INVALID_TOKEN' | 'INCORRECT_EMAIL_OR_PASSWORD' | 'DUPLICATE_TOKEN' | 'DUPLICATE_USERNAME' | 'DUPLICATE_EMAIL' | 'DUPLICATE' | 'EMAIL_NOT_VERIFIED' | 'UPDATE_WITHOUT_ID' | 'CONNECTION_ERROR' | 'INVALID_PAYMENT' | 'DECLINED_PAYMENT' | 'INTEGRATION_ERROR' | 'CANNOT_RESERVE' | 'REFUND_FAILURE' | 'INVALID_INVOICE' | 'INVALID_COUPON' | 'SERVICE_UNAVAILABLE' | 'METHOD_UNALLOWED' | 'LOGIN_EXPIRED' | 'THIRD_PARTY_ERROR' | 'ACCESS_DENIED' | 'DATABASE_ERROR' | 'SCHEMA_ERROR';
+declare class RsError {
+    err: ErrorCode;
+    msg: string;
+    status?: number;
+    stack: string;
+    constructor(errCode: ErrorCode, message?: string);
+    static htmlStatus(code: ErrorCode): number;
+    static isRsError(error: any): error is RsError;
+}
+
 declare const resturaConfigSchema: z.ZodObject<{
     authToken: z.ZodString;
     sendErrorStackTrace: z.ZodDefault<z.ZodBoolean>;
     schemaFilePath: z.ZodDefault<z.ZodString>;
+    customApiFolderPath: z.ZodDefault<z.ZodString>;
     generatedTypesPath: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     authToken: string;
     sendErrorStackTrace: boolean;
     schemaFilePath: string;
+    customApiFolderPath: string;
     generatedTypesPath: string;
 }, {
     authToken: string;
     sendErrorStackTrace?: boolean | undefined;
     schemaFilePath?: string | undefined;
+    customApiFolderPath?: string | undefined;
     generatedTypesPath?: string | undefined;
 }>;
 type ResturaConfigSchema = z.infer<typeof resturaConfigSchema>;
@@ -234,18 +269,18 @@ declare const resturaZodSchema: z.ZodObject<{
                 tableName: z.ZodOptional<z.ZodString>;
                 columnName: z.ZodOptional<z.ZodString>;
                 operator: z.ZodOptional<z.ZodEnum<["=", "<", ">", "<=", ">=", "!=", "LIKE", "IN", "NOT IN", "STARTS WITH", "ENDS WITH"]>>;
-                value: z.ZodOptional<z.ZodString>;
+                value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
                 custom: z.ZodOptional<z.ZodString>;
                 conjunction: z.ZodOptional<z.ZodEnum<["AND", "OR"]>>;
             }, "strict", z.ZodTypeAny, {
-                value?: string | undefined;
+                value?: string | number | undefined;
                 custom?: string | undefined;
                 columnName?: string | undefined;
                 tableName?: string | undefined;
                 operator?: "=" | "<" | ">" | "<=" | ">=" | "!=" | "LIKE" | "IN" | "NOT IN" | "STARTS WITH" | "ENDS WITH" | undefined;
                 conjunction?: "AND" | "OR" | undefined;
             }, {
-                value?: string | undefined;
+                value?: string | number | undefined;
                 custom?: string | undefined;
                 columnName?: string | undefined;
                 tableName?: string | undefined;
@@ -311,18 +346,18 @@ declare const resturaZodSchema: z.ZodObject<{
                         tableName: z.ZodOptional<z.ZodString>;
                         columnName: z.ZodOptional<z.ZodString>;
                         operator: z.ZodOptional<z.ZodEnum<["=", "<", ">", "<=", ">=", "!=", "LIKE", "IN", "NOT IN", "STARTS WITH", "ENDS WITH"]>>;
-                        value: z.ZodOptional<z.ZodString>;
+                        value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
                         custom: z.ZodOptional<z.ZodString>;
                         conjunction: z.ZodOptional<z.ZodEnum<["AND", "OR"]>>;
                     }, "strict", z.ZodTypeAny, {
-                        value?: string | undefined;
+                        value?: string | number | undefined;
                         custom?: string | undefined;
                         columnName?: string | undefined;
                         tableName?: string | undefined;
                         operator?: "=" | "<" | ">" | "<=" | ">=" | "!=" | "LIKE" | "IN" | "NOT IN" | "STARTS WITH" | "ENDS WITH" | undefined;
                         conjunction?: "AND" | "OR" | undefined;
                     }, {
-                        value?: string | undefined;
+                        value?: string | number | undefined;
                         custom?: string | undefined;
                         columnName?: string | undefined;
                         tableName?: string | undefined;
@@ -364,7 +399,7 @@ declare const resturaZodSchema: z.ZodObject<{
                         alias?: string | undefined;
                     }[];
                     where: {
-                        value?: string | undefined;
+                        value?: string | number | undefined;
                         custom?: string | undefined;
                         columnName?: string | undefined;
                         tableName?: string | undefined;
@@ -392,7 +427,7 @@ declare const resturaZodSchema: z.ZodObject<{
                         alias?: string | undefined;
                     }[];
                     where: {
-                        value?: string | undefined;
+                        value?: string | number | undefined;
                         custom?: string | undefined;
                         columnName?: string | undefined;
                         tableName?: string | undefined;
@@ -424,7 +459,7 @@ declare const resturaZodSchema: z.ZodObject<{
                         alias?: string | undefined;
                     }[];
                     where: {
-                        value?: string | undefined;
+                        value?: string | number | undefined;
                         custom?: string | undefined;
                         columnName?: string | undefined;
                         tableName?: string | undefined;
@@ -456,7 +491,7 @@ declare const resturaZodSchema: z.ZodObject<{
                         alias?: string | undefined;
                     }[];
                     where: {
-                        value?: string | undefined;
+                        value?: string | number | undefined;
                         custom?: string | undefined;
                         columnName?: string | undefined;
                         tableName?: string | undefined;
@@ -512,7 +547,7 @@ declare const resturaZodSchema: z.ZodObject<{
                 alias?: string | undefined;
             }[];
             where: {
-                value?: string | undefined;
+                value?: string | number | undefined;
                 custom?: string | undefined;
                 columnName?: string | undefined;
                 tableName?: string | undefined;
@@ -548,7 +583,7 @@ declare const resturaZodSchema: z.ZodObject<{
                         alias?: string | undefined;
                     }[];
                     where: {
-                        value?: string | undefined;
+                        value?: string | number | undefined;
                         custom?: string | undefined;
                         columnName?: string | undefined;
                         tableName?: string | undefined;
@@ -590,7 +625,7 @@ declare const resturaZodSchema: z.ZodObject<{
                 alias?: string | undefined;
             }[];
             where: {
-                value?: string | undefined;
+                value?: string | number | undefined;
                 custom?: string | undefined;
                 columnName?: string | undefined;
                 tableName?: string | undefined;
@@ -626,7 +661,7 @@ declare const resturaZodSchema: z.ZodObject<{
                         alias?: string | undefined;
                     }[];
                     where: {
-                        value?: string | undefined;
+                        value?: string | number | undefined;
                         custom?: string | undefined;
                         columnName?: string | undefined;
                         tableName?: string | undefined;
@@ -692,6 +727,9 @@ declare const resturaZodSchema: z.ZodObject<{
                 name: string;
                 required: boolean;
             }>, "many">>;
+            table: z.ZodUndefined;
+            joins: z.ZodUndefined;
+            assignments: z.ZodUndefined;
             fileUploadType: z.ZodOptional<z.ZodEnum<["SINGLE", "MULTIPLE"]>>;
         }>, "strict", z.ZodTypeAny, {
             path: string;
@@ -701,6 +739,9 @@ declare const resturaZodSchema: z.ZodObject<{
             description: string;
             roles: string[];
             responseType: string;
+            table?: undefined;
+            joins?: undefined;
+            assignments?: undefined;
             request?: {
                 validator: {
                     type: "TYPE_CHECK" | "MIN" | "MAX" | "ONE_OF";
@@ -719,6 +760,9 @@ declare const resturaZodSchema: z.ZodObject<{
             description: string;
             roles: string[];
             responseType: string;
+            table?: undefined;
+            joins?: undefined;
+            assignments?: undefined;
             request?: {
                 validator: {
                     type: "TYPE_CHECK" | "MIN" | "MAX" | "ONE_OF";
@@ -748,7 +792,7 @@ declare const resturaZodSchema: z.ZodObject<{
                 alias?: string | undefined;
             }[];
             where: {
-                value?: string | undefined;
+                value?: string | number | undefined;
                 custom?: string | undefined;
                 columnName?: string | undefined;
                 tableName?: string | undefined;
@@ -784,7 +828,7 @@ declare const resturaZodSchema: z.ZodObject<{
                         alias?: string | undefined;
                     }[];
                     where: {
-                        value?: string | undefined;
+                        value?: string | number | undefined;
                         custom?: string | undefined;
                         columnName?: string | undefined;
                         tableName?: string | undefined;
@@ -820,6 +864,9 @@ declare const resturaZodSchema: z.ZodObject<{
             description: string;
             roles: string[];
             responseType: string;
+            table?: undefined;
+            joins?: undefined;
+            assignments?: undefined;
             request?: {
                 validator: {
                     type: "TYPE_CHECK" | "MIN" | "MAX" | "ONE_OF";
@@ -849,7 +896,7 @@ declare const resturaZodSchema: z.ZodObject<{
                 alias?: string | undefined;
             }[];
             where: {
-                value?: string | undefined;
+                value?: string | number | undefined;
                 custom?: string | undefined;
                 columnName?: string | undefined;
                 tableName?: string | undefined;
@@ -885,7 +932,7 @@ declare const resturaZodSchema: z.ZodObject<{
                         alias?: string | undefined;
                     }[];
                     where: {
-                        value?: string | undefined;
+                        value?: string | number | undefined;
                         custom?: string | undefined;
                         columnName?: string | undefined;
                         tableName?: string | undefined;
@@ -921,6 +968,9 @@ declare const resturaZodSchema: z.ZodObject<{
             description: string;
             roles: string[];
             responseType: string;
+            table?: undefined;
+            joins?: undefined;
+            assignments?: undefined;
             request?: {
                 validator: {
                     type: "TYPE_CHECK" | "MIN" | "MAX" | "ONE_OF";
@@ -992,7 +1042,7 @@ declare const resturaZodSchema: z.ZodObject<{
                 alias?: string | undefined;
             }[];
             where: {
-                value?: string | undefined;
+                value?: string | number | undefined;
                 custom?: string | undefined;
                 columnName?: string | undefined;
                 tableName?: string | undefined;
@@ -1028,7 +1078,7 @@ declare const resturaZodSchema: z.ZodObject<{
                         alias?: string | undefined;
                     }[];
                     where: {
-                        value?: string | undefined;
+                        value?: string | number | undefined;
                         custom?: string | undefined;
                         columnName?: string | undefined;
                         tableName?: string | undefined;
@@ -1064,6 +1114,9 @@ declare const resturaZodSchema: z.ZodObject<{
             description: string;
             roles: string[];
             responseType: string;
+            table?: undefined;
+            joins?: undefined;
+            assignments?: undefined;
             request?: {
                 validator: {
                     type: "TYPE_CHECK" | "MIN" | "MAX" | "ONE_OF";
@@ -1134,7 +1187,7 @@ declare const resturaZodSchema: z.ZodObject<{
                 alias?: string | undefined;
             }[];
             where: {
-                value?: string | undefined;
+                value?: string | number | undefined;
                 custom?: string | undefined;
                 columnName?: string | undefined;
                 tableName?: string | undefined;
@@ -1170,7 +1223,7 @@ declare const resturaZodSchema: z.ZodObject<{
                         alias?: string | undefined;
                     }[];
                     where: {
-                        value?: string | undefined;
+                        value?: string | number | undefined;
                         custom?: string | undefined;
                         columnName?: string | undefined;
                         tableName?: string | undefined;
@@ -1206,6 +1259,9 @@ declare const resturaZodSchema: z.ZodObject<{
             description: string;
             roles: string[];
             responseType: string;
+            table?: undefined;
+            joins?: undefined;
+            assignments?: undefined;
             request?: {
                 validator: {
                     type: "TYPE_CHECK" | "MIN" | "MAX" | "ONE_OF";
@@ -1223,21 +1279,108 @@ declare const resturaZodSchema: z.ZodObject<{
 }>;
 type ResturaSchema = z.infer<typeof resturaZodSchema>;
 
-interface RequesterDetails {
-    role?: string;
-    host: string;
-    ipAddress: string;
+interface SchemaChangeValue {
+    name: string;
+    changeType: 'NEW' | 'MODIFIED' | 'DELETED';
 }
-interface RsRequest<T = unknown> extends express.Request {
-    requesterDetails: RequesterDetails;
+interface SchemaPreview {
+    commands: string;
+    endPoints: SchemaChangeValue[];
+    globalParams: SchemaChangeValue[];
+    roles: SchemaChangeValue[];
+    customTypes: boolean;
+}
+interface LoginDetails {
+    token: string;
+    refreshToken: string;
+    expiresOn: string;
+    user: {
+        firstName: string;
+        lastName: string;
+        email: string;
+    };
+}
+type ValidatorString = 'boolean' | 'string' | 'number' | 'object' | 'any';
+interface ResponseType {
+    isOptional?: boolean;
+    isArray?: boolean;
+    validator: ValidatorString | ResponseTypeMap | string[];
+}
+interface ResponseTypeMap {
+    [property: string]: ResponseType;
+}
+type StandardOrderTypes = 'ASC' | 'DESC' | 'RAND' | 'NONE';
+type ConjunctionTypes = 'AND' | 'OR';
+type MatchTypes = 'exact' | 'fuzzy' | 'like' | 'greaterThan' | 'greaterThanEqual' | 'lessThan' | 'lessThanEqual';
+interface RsResponseData<T> {
     data: T;
 }
+interface RsErrorData {
+    err: string;
+    msg: string;
+    stack?: string;
+}
+interface RsPagedResponseData<T> extends RsResponseData<T> {
+    total: number;
+}
+interface PageQuery {
+    page: number;
+    perPage: number;
+    sortBy: string;
+    sortOrder: StandardOrderTypes;
+    filter?: string;
+    [key: string]: string | number | boolean | object | null | undefined;
+}
+interface AuthenticationUserDetails {
+    role: string;
+    userId?: number;
+    [key: string]: string | number | boolean | object | null | undefined;
+}
+type ValidAuthenticationCallback = (userDetails: AuthenticationUserDetails) => void;
+type AuthenticateHandler = (req: RsRequest<unknown>, res: RsResponse<unknown>, onValid: ValidAuthenticationCallback) => Promise<void>;
 
-interface RoleWithOptionalUserDetails {
+interface RsHeaders extends IncomingHttpHeaders {
+    'x-auth-token'?: string;
+}
+type ApiMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS';
+type RequesterDetails<T extends object = {}> = {
     role: string;
-    [key: string]: string | number | boolean | object | null;
+    host: string;
+    ipAddress: string;
+    userId?: number;
+    isSystemUser?: boolean;
+} & T;
+interface RsRequest<T = unknown, U extends object = Record<string, never>> extends express.Request {
+    requesterDetails: RequesterDetails<U>;
+    data: T;
+}
+type DynamicObject<T = unknown> = {
+    [key: string]: T;
+};
+interface RsResponse<T = unknown> extends express.Response {
+    sendData: (data: T, statusCode?: number) => void;
+    sendNoWrap: (data: T, statusCode?: number) => void;
+    sendError: (err: ErrorCode, msg: string, htmlStatusCode?: HtmlStatusCodes, stack?: string) => void;
+    sendPaginated: (pagedData: RsPagedResponseData<T>, statusCode?: number) => void;
+    _contentLength?: number;
+}
+type RsRouteHandler<T = unknown, U = unknown> = (req: RsRequest<T>, res: RsResponse<U>, next?: express.NextFunction) => Promise<void>;
+interface AsyncExpressApplication {
+    get: (url: string, handler: RsRouteHandler, nextFunction?: RsRouteHandler) => Promise<void> | void;
+    post: (url: string, handler: RsRouteHandler, nextFunction?: RsRouteHandler) => Promise<void> | void;
+    put: (url: string, handler: RsRouteHandler, nextFunction?: RsRouteHandler) => Promise<void> | void;
+    patch: (url: string, handler: RsRouteHandler, nextFunction?: RsRouteHandler) => Promise<void> | void;
+    delete: (url: string, handler: RsRouteHandler, nextFunction?: RsRouteHandler) => Promise<void> | void;
+}
+
+declare class PsqlPool {
+    poolConfig: PoolConfig;
+    pool: Pool;
+    constructor(poolConfig: PoolConfig);
+    queryOne(query: string, options: any[], requesterDetails: RequesterDetails): Promise<any>;
+    runQuery(query: string, options: any[], requesterDetails: RequesterDetails): Promise<any[]>;
+    private logSqlStatement;
 }
-type AuthenticateHandler = (req: RsRequest<unknown>, onValid: (userDetails: RoleWithOptionalUserDetails) => void, onReject: (errorMessage: string) => void) => Promise<void>;
 
 declare class ResturaEngine {
     resturaConfig: ResturaConfigSchema;
@@ -1247,13 +1390,16 @@ declare class ResturaEngine {
     private schema;
     private responseValidator;
     private authenticationHandler;
+    private customTypeValidation;
+    private psqlConnectionPool;
+    private psqlEngine;
     /**
      * Initializes the Restura engine with the provided Express application.
      *
      * @param app - The Express application instance to initialize with Restura.
      * @returns A promise that resolves when the initialization is complete.
      */
-    init(app: express.Application, authenticationHandler: AuthenticateHandler): Promise<void>;
+    init(app: express.Application, authenticationHandler: AuthenticateHandler, psqlConnectionPool: PsqlPool): Promise<void>;
     /**
      * Determines if a given endpoint is public based on the HTTP method and full URL. This
      * is determined on whether the endpoint in the schema has no roles assigned to it.
@@ -1318,6 +1464,7 @@ declare class ResturaEngine {
     private getSchemaAndTypes;
     private executeRouteLogic;
     private isCustomRoute;
+    private runCustomRouteLogic;
     private generateHashForSchema;
     private storeFileSystemSchema;
     private resetPublicEndpoints;
@@ -1326,4 +1473,11 @@ declare class ResturaEngine {
 }
 declare const restura: ResturaEngine;
 
-export { logger, restura };
+declare function escapeColumnName(columnName: string | undefined): string;
+declare function questionMarksToOrderedParams(query: string): string;
+declare function insertObjectQuery(table: string, obj: DynamicObject): string;
+declare function updateObjectQuery(table: string, obj: DynamicObject, whereStatement: string): string;
+declare function isValueNumber(value: unknown): value is number;
+declare function SQL(strings: any, ...values: any): any;
+
+export { type ApiMethod, type AsyncExpressApplication, type AuthenticateHandler, type AuthenticationUserDetails, type ConjunctionTypes, type DynamicObject, type ErrorCode, HtmlStatusCodes, type LoginDetails, type MatchTypes, type PageQuery, PsqlPool, type RequesterDetails, type ResponseType, type ResponseTypeMap, RsError, type RsErrorData, type RsErrorInternalData, type RsHeaders, type RsPagedResponseData, type RsRequest, type RsResponse, type RsResponseData, type RsRouteHandler, SQL, type SchemaChangeValue, type SchemaPreview, type StandardOrderTypes, type ValidAuthenticationCallback, type ValidatorString, escapeColumnName, insertObjectQuery, isValueNumber, logger, questionMarksToOrderedParams, restura, updateObjectQuery };