@zenstackhq/runtime 0.3.9 → 0.3.11

package/lib/request-handler.js

@@ -0,0 +1,37 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requestHandler = void 0;
+const handler_1 = require("./handler");
+/**
+ * Creates a Next.js API endpoint request handler which encapsulates RESTful APIs generated by ZenStack.
+ * The created handler should be mounted at /api/zenstack endpoint.
+ *
+ * @param service ZenStack service which wraps a Prisma db client inside
+ * @param options Options for initialization
+ * @returns An API endpoint request handler
+ */
+function requestHandler(service, options) {
+    const dataHandler = new handler_1.DataHandler(service, options);
+    return (req, res) => __awaiter(this, void 0, void 0, function* () {
+        const [route, ...rest] = req.query.path;
+        switch (route) {
+            // "/data" route is for handling data-access requests
+            case 'data':
+                return dataHandler.handle(req, res, rest);
+            default:
+                service.warn(`Unknown route: ${route}`);
+                res.status(404).json({ error: `Unknown route: ${route}` });
+        }
+    });
+}
+exports.requestHandler = requestHandler;
+//# sourceMappingURL=request-handler.js.map

package/lib/request-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-handler.js","sourceRoot":"","sources":["../../src/request-handler.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,uCAAwC;AAiBxC;;;;;;;GAOG;AACH,SAAgB,cAAc,CAC1B,OAA0B,EAC1B,OAA8B;IAE9B,MAAM,WAAW,GAAG,IAAI,qBAAW,CAC/B,OAAoC,EACpC,OAAO,CACV,CAAC;IACF,OAAO,CAAO,GAAmB,EAAE,GAAoB,EAAE,EAAE;QACvD,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAgB,CAAC;QACpD,QAAQ,KAAK,EAAE;YACX,qDAAqD;YACrD,KAAK,MAAM;gBACP,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAE9C;gBACI,OAAO,CAAC,IAAI,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;gBACxC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,kBAAkB,KAAK,EAAE,EAAE,CAAC,CAAC;SAClE;IACL,CAAC,CAAA,CAAC;AACN,CAAC;AApBD,wCAoBC"}

package/lib/request.d.ts

@@ -0,0 +1,16 @@
+import type { MutatorCallback, MutatorOptions, SWRResponse } from 'swr/dist/types';
+import { RequestOptions } from './types';
+/**
+ * Makes a GET request with SWR.
+ *
+ * @param url The request URL.
+ * @param args The request args object, which will be JSON-stringified and appended as "?q=" parameter
+ * @returns SWR response
+ */
+export declare function get<Data, Error = any>(url: string | null, args?: unknown, options?: RequestOptions): SWRResponse<Data, Error>;
+export declare function post<Data, Result>(url: string, data: Data, mutate: Mutator): Promise<Result>;
+export declare function put<Data, Result>(url: string, data: Data, mutate: Mutator): Promise<Result>;
+export declare function del<Result>(url: string, args: unknown, mutate: Mutator): Promise<Result>;
+type Mutator = (key: string, prefix: boolean, data?: unknown | Promise<unknown> | MutatorCallback, opts?: boolean | MutatorOptions) => Promise<unknown[]>;
+export declare function getMutate(): Mutator;
+export {};

package/lib/request.js

@@ -0,0 +1,171 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMutate = exports.del = exports.put = exports.post = exports.get = void 0;
+const decimal_js_1 = __importDefault(require("decimal.js"));
+const swr_1 = __importStar(require("swr"));
+function isBuffer(value) {
+    return (!!value &&
+        value.type === 'Buffer' &&
+        Array.isArray(value.data));
+}
+function isBigInt(value) {
+    return (!!value &&
+        value.type === 'BigInt' &&
+        typeof value.data === 'string');
+}
+function isDate(value) {
+    return (!!value &&
+        value.type === 'Date' &&
+        typeof value.data === 'string');
+}
+function isDecimal(value) {
+    return (!!value &&
+        value.type === 'Decimal' &&
+        typeof value.data === 'string');
+}
+const dataReviver = (key, value) => {
+    // Buffer
+    if (isBuffer(value)) {
+        return Buffer.from(value.data);
+    }
+    // BigInt
+    if (isBigInt(value)) {
+        return BigInt(value.data);
+    }
+    // Date
+    if (isDate(value)) {
+        return new Date(value.data);
+    }
+    // Decimal
+    if (isDecimal(value)) {
+        return new decimal_js_1.default(value.data);
+    }
+    return value;
+};
+const fetcher = (url, options) => __awaiter(void 0, void 0, void 0, function* () {
+    const res = yield fetch(url, options);
+    if (!res.ok) {
+        const error = new Error('An error occurred while fetching the data.');
+        error.info = yield res.json();
+        error.status = res.status;
+        throw error;
+    }
+    const textResult = yield res.text();
+    console.log;
+    try {
+        return JSON.parse(textResult, dataReviver);
+    }
+    catch (err) {
+        console.error(`Unable to deserialize data:`, textResult);
+        throw err;
+    }
+});
+function makeUrl(url, args) {
+    return args ? url + `?q=${encodeURIComponent(JSON.stringify(args))}` : url;
+}
+/**
+ * Makes a GET request with SWR.
+ *
+ * @param url The request URL.
+ * @param args The request args object, which will be JSON-stringified and appended as "?q=" parameter
+ * @returns SWR response
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function get(url, args, options) {
+    const reqUrl = (options === null || options === void 0 ? void 0 : options.disabled) ? null : url ? makeUrl(url, args) : null;
+    return (0, swr_1.default)(reqUrl, fetcher);
+}
+exports.get = get;
+function post(url, data, mutate) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const r = yield fetcher(url, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+            },
+            body: JSON.stringify(data),
+        });
+        mutate(url, true);
+        return r;
+    });
+}
+exports.post = post;
+function put(url, data, mutate) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const r = yield fetcher(url, {
+            method: 'PUT',
+            headers: {
+                'content-type': 'application/json',
+            },
+            body: JSON.stringify(data),
+        });
+        mutate(url, true);
+        return r;
+    });
+}
+exports.put = put;
+function del(url, args, mutate) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const reqUrl = makeUrl(url, args);
+        const r = yield fetcher(reqUrl, {
+            method: 'DELETE',
+        });
+        const path = url.split('/');
+        path.pop();
+        mutate(path.join('/'), true);
+        return r;
+    });
+}
+exports.del = del;
+function getMutate() {
+    // https://swr.vercel.app/docs/advanced/cache#mutate-multiple-keys-from-regex
+    const { cache, mutate } = (0, swr_1.useSWRConfig)();
+    return (key, prefix, data, opts) => {
+        if (!prefix) {
+            return mutate(key, data, opts);
+        }
+        if (!(cache instanceof Map)) {
+            throw new Error('mutate requires the cache provider to be a Map instance');
+        }
+        const keys = Array.from(cache.keys()).filter((k) => typeof k === 'string' && k.startsWith(key));
+        const mutations = keys.map((key) => mutate(key, data, opts));
+        return Promise.all(mutations);
+    };
+}
+exports.getMutate = getMutate;
+//# sourceMappingURL=request.js.map

package/lib/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/request.ts"],"names":[],"mappings":"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"}

package/lib/service.d.ts

@@ -0,0 +1,32 @@
+/// <reference types="node" />
+import { EventEmitter } from 'stream';
+import { ServiceConfig } from './config';
+import { FieldInfo, LogEvent, LogLevel, PolicyOperationKind, QueryContext, Service } from './types';
+export declare abstract class DefaultService<DbClient extends {
+    $on: (eventType: any, handler: (event: any) => void) => void;
+}> implements Service<DbClient> {
+    protected config: ServiceConfig;
+    private prisma;
+    protected readonly logEmitter: EventEmitter;
+    private readonly logSettings;
+    private guardModule;
+    private fieldConstraintModule;
+    private readonly prismaLogLevels;
+    constructor();
+    private initialize;
+    $on(level: LogLevel, callback: (event: LogEvent) => void): void;
+    private handleLog;
+    private loadConfig;
+    get db(): DbClient;
+    resolveField(model: string, field: string): Promise<FieldInfo | undefined>;
+    buildQueryGuard(model: string, operation: PolicyOperationKind, context: QueryContext): Promise<unknown>;
+    validateModelPayload(model: string, mode: 'create' | 'update', payload: unknown): Promise<void>;
+    verbose(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    reinitialize(): void;
+    protected abstract initializePrisma(): DbClient;
+    protected abstract loadGuardModule(): Promise<any>;
+    protected abstract loadFieldConstraintModule(): Promise<any>;
+}

package/lib/service.js

@@ -0,0 +1,185 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultService = void 0;
+const colors_1 = __importDefault(require("colors"));
+const fs = __importStar(require("fs"));
+const stream_1 = require("stream");
+const validation_1 = require("./validation");
+class DefaultService {
+    constructor() {
+        this.logEmitter = new stream_1.EventEmitter();
+        this.logSettings = {
+            query: { stdout: false, emit: false },
+            verbose: { stdout: false, emit: false },
+            info: { stdout: true, emit: false },
+            warn: { stdout: true, emit: false },
+            error: { stdout: true, emit: false },
+        };
+        this.prismaLogLevels = [
+            'query',
+            'info',
+            'warn',
+            'error',
+        ];
+        this.initialize();
+    }
+    initialize() {
+        this.config = this.loadConfig();
+        // initialize log sink mapping
+        if (this.config.log) {
+            // reset all levels
+            for (const key of Object.keys(this.logSettings)) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                this.logSettings[key] = { stdout: false, emit: false };
+            }
+            for (const entry of this.config.log) {
+                const level = typeof entry === 'string' ? entry : entry.level;
+                if (!Object.keys(this.logSettings).includes(level)) {
+                    console.error(`Unknown log level "${level}"`);
+                    continue;
+                }
+                if (typeof entry === 'string') {
+                    this.logSettings[level].stdout = true;
+                }
+                else if (entry.emit === 'stdout') {
+                    this.logSettings[level].stdout = true;
+                }
+                else {
+                    this.logSettings[level].emit = true;
+                }
+            }
+        }
+        console.log('Initializing ZenStack service with config:', JSON.stringify(this.config));
+        this.prisma = this.initializePrisma();
+        for (const level of this.prismaLogLevels) {
+            if (this.logSettings[level].emit) {
+                this.verbose(`Hooking prisma log level ${level}`);
+                this.prisma.$on(level, (e) => {
+                    this.logEmitter.emit(level, e);
+                });
+            }
+        }
+    }
+    $on(level, callback) {
+        this.logEmitter.on(level, callback);
+    }
+    handleLog(level, message) {
+        if (this.logSettings[level].stdout) {
+            switch (level) {
+                case 'verbose':
+                    console.log(colors_1.default.blue(`zenstack:${level}`), message);
+                    break;
+                case 'info':
+                    console.log(colors_1.default.cyan(`zenstack:${level}`), message);
+                    break;
+                case 'warn':
+                    console.warn(colors_1.default.yellow(`zenstack:${level}`), message);
+                    break;
+                case 'error':
+                    console.error(colors_1.default.red(`zenstack:${level}`), message);
+                    break;
+            }
+        }
+        if (this.logSettings[level].emit) {
+            this.logEmitter.emit(level, { timestamp: new Date(), message });
+        }
+    }
+    loadConfig() {
+        const configFile = './zenstack.config.json';
+        if (fs.existsSync(configFile)) {
+            try {
+                const config = JSON.parse(fs.readFileSync(configFile).toString('utf-8'));
+                return config;
+            }
+            catch (err) {
+                console.error('Failed to load zenstack.config.json', err);
+            }
+        }
+        return {};
+    }
+    get db() {
+        return this.prisma;
+    }
+    resolveField(model, field) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.guardModule) {
+                this.guardModule = yield this.loadGuardModule();
+            }
+            return (_b = (_a = this.guardModule._fieldMapping) === null || _a === void 0 ? void 0 : _a[model]) === null || _b === void 0 ? void 0 : _b[field];
+        });
+    }
+    buildQueryGuard(model, operation, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.guardModule) {
+                this.guardModule = yield this.loadGuardModule();
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const provider = this.guardModule[model + '_' + operation];
+            return provider(context);
+        });
+    }
+    validateModelPayload(model, mode, payload) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.fieldConstraintModule) {
+                this.fieldConstraintModule = yield this.loadFieldConstraintModule();
+            }
+            const validator = this.fieldConstraintModule[`${model}_${mode}_validator`];
+            if (validator) {
+                (0, validation_1.validate)(validator, payload);
+            }
+        });
+    }
+    verbose(message) {
+        this.handleLog('verbose', message);
+    }
+    info(message) {
+        this.handleLog('info', message);
+    }
+    warn(message) {
+        this.handleLog('warn', message);
+    }
+    error(message) {
+        this.handleLog('error', message);
+    }
+    reinitialize() {
+        this.initialize();
+    }
+}
+exports.DefaultService = DefaultService;
+//# sourceMappingURL=service.js.map

package/lib/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"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"}

package/lib/types.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Weakly-typed database access methods
+ */
+export interface DbOperations {
+    findMany(args: unknown): Promise<unknown[]>;
+    findFirst(args: unknown): Promise<unknown>;
+    findUnique(args: unknown): Promise<unknown>;
+    create(args: unknown): Promise<unknown>;
+    update(args: unknown): Promise<unknown>;
+    delete(args: unknown): Promise<unknown>;
+    deleteMany(args: unknown): Promise<unknown>;
+    count(args: unknown): Promise<number>;
+}
+/**
+ * Kinds of access policy
+ */
+export type PolicyKind = 'allow' | 'deny';
+/**
+ * Kinds of operations controlled by access policies
+ */
+export type PolicyOperationKind = 'create' | 'update' | 'read' | 'delete';
+/**
+ * Current login user info
+ *
+ * @todo Support for non-string "id" field
+ */
+export type AuthUser = {
+    id: string;
+} & Record<string, unknown>;
+/**
+ * Context for database query
+ */
+export type QueryContext = {
+    /**
+     * Current login user (provided by @see RequestHandlerOptions)
+     */
+    user?: AuthUser;
+};
+export type RuntimeAttribute = {
+    name: string;
+    args: Array<{
+        name?: string;
+        value: unknown;
+    }>;
+};
+/**
+ * Runtime information of a data model field
+ */
+export type FieldInfo = {
+    name: string;
+    type: string;
+    isDataModel: boolean;
+    isArray: boolean;
+    isOptional: boolean;
+    attributes: RuntimeAttribute[];
+};
+export type DbClientContract = Record<string, DbOperations> & {
+    $transaction: <T>(action: (tx: Record<string, DbOperations>) => Promise<T>) => Promise<T>;
+};
+/**
+ * Logging levels
+ */
+export type LogLevel = 'verbose' | 'info' | 'query' | 'warn' | 'error';
+/**
+ * The main service of ZenStack. Implementation of this interface is automatically generated.
+ */
+export interface Service<DbClient = any> {
+    /**
+     * Returns the wrapped Prisma db client
+     */
+    get db(): DbClient;
+    /**
+     * Resolves information of a data model field.
+     *
+     * @param model Model name
+     * @param field Field name
+     */
+    resolveField(model: string, field: string): Promise<FieldInfo | undefined>;
+    /**
+     * Builds policy check guard object for an operation over a model, which will be injected to
+     * the query body sent to Prisma client.
+     *
+     * @param model Model name
+     * @param operation Operation kind
+     * @param context Query context
+     */
+    buildQueryGuard(model: string, operation: PolicyOperationKind, context: QueryContext): Promise<unknown>;
+    validateModelPayload(model: string, mode: 'create' | 'update', payload: unknown): Promise<void>;
+    /**
+     * Generates a log message with verbose level.
+     */
+    verbose(message: string): void;
+    /**
+     * Generates a log message with info level.
+     */
+    info(message: string): void;
+    /**
+     * Generates a log message with warn level.
+     */
+    warn(message: string): void;
+    /**
+     * Generates a log message with error level.
+     */
+    error(message: string): void;
+    /**
+     * Registers a listener to log events.
+     */
+    $on(level: LogLevel, callback: (event: LogEvent) => void): void;
+}
+/**
+ * Error codes for errors on server side
+ */
+export declare enum ServerErrorCode {
+    /**
+     * The specified entity cannot be found
+     */
+    ENTITY_NOT_FOUND = "ENTITY_NOT_FOUND",
+    /**
+     * The request parameter is invalid, either containing invalid fields or missing required fields
+     */
+    INVALID_REQUEST_PARAMS = "INVALID_REQUEST_PARAMS",
+    /**
+     * The request is rejected by policy checks
+     */
+    DENIED_BY_POLICY = "DENIED_BY_POLICY",
+    /**
+     * Violation of database unique constraints
+     */
+    UNIQUE_CONSTRAINT_VIOLATION = "UNIQUE_CONSTRAINT_VIOLATION",
+    /**
+     * Violation of database reference constraint (aka. foreign key constraints)
+     */
+    REFERENCE_CONSTRAINT_VIOLATION = "REFERENCE_CONSTRAINT_VIOLATION",
+    /**
+     * A write operation succeeded but the result cannot be read back due to policy control
+     */
+    READ_BACK_AFTER_WRITE_DENIED = "READ_BACK_AFTER_WRITE_DENIED",
+    /**
+     * Unknown error
+     */
+    UNKNOWN = "UNKNOWN"
+}
+export declare function getServerErrorMessage(code: ServerErrorCode): string;
+export type LogEventHandler = (LogEvent: any, handler: (event: LogEvent) => void) => void;
+export type LogEvent = {
+    timestamp: Date;
+    query?: string;
+    params?: string;
+    duration?: number;
+    target?: string;
+    message?: string;
+};
+/**
+ * Client request options
+ */
+export type RequestOptions = {
+    disabled: boolean;
+};
+/**
+ * Hooks invocation error
+ */
+export type HooksError = {
+    status: number;
+    info: {
+        code: ServerErrorCode;
+        message: string;
+    };
+};