@liminalfunctions/framework 1.0.0

package/dist/utils/query_validator_from_zod.js

@@ -0,0 +1,216 @@
+import { z } from "zod/v4";
+import { magic_values, z_mongodb_id } from "./mongoose_from_zod.js";
+export function query_validator_from_zod(zod_definition, mode = 'server') {
+    let retval = {
+        limit: z.coerce.number().int().optional(),
+        cursor: z_mongodb_id.optional(),
+        sort_order: z.enum(['ascending', 'descending']).optional()
+    };
+    let object_filters = parse_object(zod_definition._zod.def, '', new Set(), mode);
+    for (let filter of object_filters) {
+        retval[filter.path.slice(1)] = filter.filter;
+    }
+    retval.sort = z.enum(object_filters.filter(ele => ele.sortable).map(ele => ele.path.slice(1))).optional();
+    return z.object(retval).strict();
+}
+function parse_any(zod_definition, prefix, loop_detector = new Set(), mode = 'server') {
+    switch (zod_definition._zod.def.type) {
+        case "enum":
+            return parse_enum(zod_definition._zod.def, prefix, mode);
+        case "string":
+            return parse_string(prefix, mode);
+        case "number":
+        case "int":
+            return parse_number(prefix, mode);
+        case "object":
+            return parse_object(zod_definition._zod.def, prefix, loop_detector, mode);
+        case "boolean":
+            return parse_boolean(prefix, mode);
+        case "date":
+            return parse_date(prefix, mode);
+        case "array":
+            return parse_array(zod_definition._zod.def, prefix, loop_detector, mode);
+        case "union":
+            return parse_union(zod_definition._zod.def, prefix, mode);
+        case "custom":
+            if (!magic_values.has(zod_definition)) {
+                throw new Error(`could not find custom parser in the magic value dictionary`);
+            }
+            let { override_type } = magic_values.get(zod_definition);
+            if (override_type === 'mongodb_id') {
+                return parse_mongodb_id(prefix, mode);
+            }
+            else {
+                throw new Error(`could not find custom parser for ${override_type} in the magic value dictionary`);
+            }
+        case "default":
+            return parse_any(zod_definition._zod.def.innerType, prefix, loop_detector, mode);
+        default:
+            return [];
+    }
+}
+function parse_array(def, prefix, loop_detector, mode) {
+    let simple_children = ['enum', 'string', 'number', 'int', 'boolean'];
+    if (simple_children.includes(def.element._zod.def.type)) {
+        return parse_any(def.element, prefix, loop_detector, mode).filter(ele => ele.path == prefix);
+    }
+    else if (def.element._zod.def.type === 'custom') {
+        if (!magic_values.has(def.element)) {
+            return [];
+        }
+        let { override_type } = magic_values.get(def.element);
+        if (override_type === 'mongodb_id') {
+            return parse_mongodb_id(prefix, mode).filter(ele => ele.path == prefix);
+        }
+    }
+    return [];
+}
+function parse_object(def, prefix, loop_detector, mode) {
+    if (loop_detector.has(def)) {
+        return [];
+    }
+    loop_detector.add(def);
+    let retval = [];
+    for (let [key, value] of Object.entries(def.shape)) {
+        let filters = parse_any(value, `${prefix}.${key}`, loop_detector, mode);
+        retval.push(...filters);
+    }
+    return retval;
+}
+function parse_union(def, prefix, mode) {
+    let simple_children = ['enum', 'string', 'number', 'int', 'boolean'];
+    let filter_queue = def.options.slice().filter(ele => simple_children.includes(ele._zod.def.type));
+    let root = filter_queue.shift();
+    for (let filter of filter_queue) {
+        root = root.or(filter);
+    }
+    return [
+        {
+            path: prefix,
+            filter: root,
+            sortable: true,
+        }
+    ];
+}
+function parse_string(prefix, mode) {
+    let array_parser = mode === 'client' ? z.array(z.string()) : z.string().transform(val => val.split(',').filter(ele => ele.length > 0));
+    return [
+        {
+            path: prefix,
+            filter: z.string().optional(),
+            sortable: true,
+        },
+        {
+            path: prefix + '_gt',
+            filter: z.string().optional(),
+            sortable: false,
+        },
+        {
+            path: prefix + '_lt',
+            filter: z.string().optional(),
+            sortable: false,
+        },
+        {
+            path: prefix + '_in',
+            filter: array_parser.optional(),
+            sortable: false,
+        },
+    ];
+}
+function parse_enum(definition, prefix, mode) {
+    let array_parser = mode === 'client' ? z.array(z.enum(definition.entries)) : z.string().transform(val => val.split(',').filter(ele => ele.length > 0));
+    return [
+        {
+            path: prefix,
+            filter: z.enum(definition.entries).optional(),
+            sortable: true,
+        },
+        {
+            path: prefix + '_in',
+            filter: array_parser.optional(),
+            sortable: false,
+        },
+    ];
+}
+function parse_boolean(prefix, mode) {
+    let boolean_parser = mode === 'client' ? z.boolean() : z.stringbool();
+    return [{
+            path: prefix,
+            filter: boolean_parser.optional(),
+            sortable: true,
+        }];
+}
+function parse_number(prefix, mode) {
+    let number_parser = mode === 'client' ? z.number() : z.coerce.number();
+    return [
+        {
+            path: prefix,
+            filter: number_parser.optional(),
+            sortable: true,
+        },
+        {
+            path: prefix + '_gt',
+            filter: number_parser.optional(),
+            sortable: false,
+        },
+        {
+            path: prefix + '_gte',
+            filter: number_parser.optional(),
+            sortable: false,
+        },
+        {
+            path: prefix + '_lt',
+            filter: number_parser.optional(),
+            sortable: false,
+        },
+        {
+            path: prefix + '_lte',
+            filter: number_parser.optional(),
+            sortable: false,
+        },
+    ];
+}
+function parse_date(prefix, mode) {
+    let date_parser = mode === 'client' ? z.date() : z.coerce.date();
+    return [{
+            path: prefix,
+            filter: date_parser.optional(),
+            sortable: true,
+        },
+        {
+            path: prefix + '_gt',
+            filter: date_parser.optional(),
+            sortable: false,
+        },
+        {
+            path: prefix + '_lt',
+            filter: date_parser.optional(),
+            sortable: false,
+        }];
+}
+function parse_mongodb_id(prefix, mode) {
+    let array_parser = mode === 'client' ? z.array(z_mongodb_id) : z.string().transform(val => val.split(',').filter(ele => ele.length > 0));
+    return [
+        {
+            path: prefix,
+            filter: z_mongodb_id.optional(),
+            sortable: true,
+        },
+        {
+            path: prefix + '_gt',
+            filter: z_mongodb_id.optional(),
+            sortable: false,
+        },
+        {
+            path: prefix + '_lt',
+            filter: z_mongodb_id.optional(),
+            sortable: false,
+        },
+        {
+            path: prefix + '_in',
+            filter: array_parser.optional(),
+            sortable: false,
+        },
+    ];
+}
+//# sourceMappingURL=query_validator_from_zod.js.map

package/dist/utils/query_validator_from_zod.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@liminalfunctions/framework",
+  "version": "1.0.0",
+  "main": "index.js",
+  "type": "module",
+  "scripts": {
+    "test": "npm run-script build && mocha",
+    "build": "tsc && rimraf \"./dist/code_generation/templates\" && copyfiles -a -u 3 \"./src/code_generation/templates/*.mustache\" \"./dist/code_generation/templates\""
+  },
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "devDependencies": {
+    "@openapitools/openapi-generator-cli": "^2.22.0",
+    "@types/express": "^5.0.0",
+    "@types/mocha": "^10.0.10",
+    "@types/mustache": "^4.2.6",
+    "@types/node": "^22.10.7",
+    "copyfiles": "^2.4.1",
+    "got": "^14.4.6",
+    "mocha": "^11.1.0",
+    "rimraf": "^6.0.1",
+    "tsx": "^4.19.3",
+    "typescript": "^5.7.3",
+    "zod": "^4.0.17"
+  },
+  "peerDependencies": {
+    "express": "^4.21.2",
+    "ky": "^1.9.0",
+    "mongoose": "^8.17.0",
+    "zod": "^4.0.0"
+  },
+  "dependencies": {
+    "mustache": "^4.2.0"
+  }
+}

package/src/F_Collection.ts

@@ -0,0 +1,50 @@
+import * as z from "zod/v4";
+import { mongoose_from_zod, schema_from_zod } from "./utils/mongoose_from_zod.js";
+import { Model } from "mongoose";
+import { F_Security_Model } from "./F_Security_Models/F_Security_Model.js";
+import { query_validator_from_zod } from "./utils/query_validator_from_zod.js";
+import ky, { SearchParamsOption } from 'ky';
+
+export type F_Layer<Collection_ID extends string, ZodSchema extends z.ZodObject> = {
+    layers: string[],
+    security_models: F_Security_Model<Collection_ID, ZodSchema>[]
+}
+
+export class F_Collection<Collection_ID extends string, ZodSchema extends z.ZodObject> {
+    collection_id: Collection_ID;
+    validator: ZodSchema;
+    mongoose_schema: any;
+    mongoose_model: Model<z.infer<ZodSchema>>;
+    
+    query_validator_server: z.ZodType;
+    query_validator_client: z.ZodType;
+    put_validator: z.ZodType;
+    post_validator: z.ZodType;
+    is_compiled: boolean;
+
+    access_layers: F_Layer<Collection_ID, ZodSchema>[];
+
+    constructor(collection_name: Collection_ID, validator: ZodSchema){
+        this.collection_id = collection_name;
+        this.validator = validator;
+        this.mongoose_schema = schema_from_zod(validator);
+        this.mongoose_model = mongoose_from_zod(collection_name, validator);
+        // TODO: validate that the model doesn't use any fields that have special meaning in the query validator; for example: [param]_gt, [param]_in, sort,
+        //@ts-ignore
+        this.query_validator_server = query_validator_from_zod(validator, 'server');
+        this.query_validator_client = query_validator_from_zod(validator, 'client');
+        // TODO: we can make this more closely match the mongoDB PUT operation and allow updates to eg array.3.element fields
+        this.put_validator = validator.partial();
+        this.post_validator = Object.hasOwn(this.validator._zod.def.shape, '_id') ? validator.partial({_id: true}) : validator;
+        this.access_layers = [];
+        this.is_compiled = false;
+    }
+
+    add_layers(layers: string[], security_models: F_Security_Model<Collection_ID, ZodSchema>[], is_layer_owner = false){
+        if(this.is_compiled){ throw new Error(`Manipulating a model post-compilation doesn't work.`); }
+        this.access_layers.push({
+            layers: layers,
+            security_models: security_models
+        });
+    }
+}

package/src/F_Collection_Registry.ts

@@ -0,0 +1,29 @@
+import * as z from 'zod/v4'
+import { F_Collection } from './F_Collection.js';
+import { compile/*, to_openapi*/ } from './F_Compile.js'
+import { Router } from 'express';
+//import { createDocument } from 'zod-openapi';
+
+
+export class F_Collection_Registry<Collections = {}> {
+    collections: Collections;
+
+
+
+    constructor() {
+        this.collections = {} as Collections;
+    }
+
+    register<Collection_ID extends string, ZodSchema extends z.ZodObject>(collection: F_Collection<Collection_ID, ZodSchema>): F_Collection_Registry<Collections & { [key in Collection_ID]: F_Collection<Collection_ID, ZodSchema>}>{
+        let collections = this.collections as Collections & { [key in Collection_ID]: F_Collection<Collection_ID, ZodSchema>};
+        // @ts-expect-error
+        collections[collection.collection_id] = collection;
+        return this as F_Collection_Registry<Collections & { [key in Collection_ID]: F_Collection<Collection_ID, ZodSchema>}>;
+    }
+
+    compile(app: Router, api_prefix: string) {
+        for(let collection of Object.values(this.collections)){
+            compile(app, collection, api_prefix)
+        }
+    }
+}