feat: RESTful style server API handler (#405)

Co-authored-by: Jawad <jawad.stouli@gmail.com>

Author: ymc9

packages/next/src/request-handler.ts

@@ -168,7 +168,8 @@ async function handleRequest(
                 message: err.message,
             });
         } else {
-            logError(options, undefined, (err as Error).message);
+            const _err = err as Error;
+            logError(options, undefined, _err.message + (_err.stack ? '\n' + _err.stack : ''));
             res.status(500).send({
                 message: (err as Error).message,
             });

packages/runtime/src/enhancements/index.ts

@@ -2,3 +2,4 @@ export * from './omit';
 export * from './password';
 export * from './policy';
 export * from './preset';
+export * from './utils';

packages/runtime/src/enhancements/policy/policy-utils.ts

@@ -18,7 +18,13 @@ import { getVersion } from '../../version';
 import { resolveField } from '../model-meta';
 import { NestedWriteVisitor, VisitorContext } from '../nested-write-vistor';
 import { ModelMeta, PolicyDef, PolicyFunc } from '../types';
-import { enumerate, getModelFields, prismaClientKnownRequestError, prismaClientUnknownRequestError } from '../utils';
+import {
+    enumerate,
+    getIdFields,
+    getModelFields,
+    prismaClientKnownRequestError,
+    prismaClientUnknownRequestError,
+} from '../utils';
 import { Logger } from './logger';
 
 /**
@@ -858,15 +864,7 @@ export class PolicyUtil {
      * Gets "id" field for a given model.
      */
     getIdFields(model: string) {
-        const fields = this.modelMeta.fields[lowerCaseFirst(model)];
-        if (!fields) {
-            throw this.unknownError(`Unable to load fields for ${model}`);
-        }
-        const result = Object.values(fields).filter((f) => f.isId);
-        if (result.length === 0) {
-            throw this.unknownError(`model ${model} does not have an id field`);
-        }
-        return result;
+        return getIdFields(this.modelMeta, model);
     }
 
     /**

packages/runtime/src/enhancements/utils.ts

@@ -1,9 +1,11 @@
 /* eslint-disable @typescript-eslint/no-var-requires */
 
 import { AUXILIARY_FIELDS } from '@zenstackhq/sdk';
+import { lowerCaseFirst } from 'lower-case-first';
 import path from 'path';
 import * as util from 'util';
 import { DbClientContract } from '../types';
+import { ModelMeta } from './types';
 
 /**
  * Wraps a value into array if it's not already one
@@ -19,6 +21,21 @@ export function getModelFields(data: object) {
     return data ? Object.keys(data).filter((f) => !AUXILIARY_FIELDS.includes(f)) : [];
 }
 
+/**
+ * Gets id fields for the given model.
+ */
+export function getIdFields(modelMeta: ModelMeta, model: string) {
+    const fields = modelMeta.fields[lowerCaseFirst(model)];
+    if (!fields) {
+        throw new Error(`Unable to load fields for ${model}`);
+    }
+    const result = Object.values(fields).filter((f) => f.isId);
+    if (result.length === 0) {
+        throw new Error(`model ${model} does not have an id field`);
+    }
+    return result;
+}
+
 /**
  * Array or scalar
  */
@@ -35,6 +52,9 @@ export function enumerate<T>(x: Enumerable<T>) {
     }
 }
 
+/**
+ * Formats an object for pretty printing.
+ */
 export function formatObject(value: unknown) {
     return util.formatWithOptions({ depth: 10 }, value);
 }

packages/server/package.json

@@ -27,14 +27,19 @@
         "@zenstackhq/runtime": "workspace:*",
         "@zenstackhq/sdk": "workspace:*",
         "change-case": "^4.1.2",
+        "lower-case-first": "^2.0.2",
         "tiny-invariant": "^1.3.1",
+        "ts-japi": "^1.8.0",
         "upper-case-first": "^2.0.2",
+        "url-pattern": "^1.0.3",
+        "zod": "3.21.1",
         "zod-validation-error": "^0.2.1"
     },
     "devDependencies": {
         "@types/body-parser": "^1.19.2",
         "@types/express": "^4.17.17",
         "@types/jest": "^29.5.0",
+        "@types/lower-case-first": "^1.0.1",
         "@types/supertest": "^2.0.12",
         "@types/upper-case-first": "^1.1.2",
         "@zenstackhq/testtools": "workspace:*",