@liminalfunctions/framework 1.0.0

package/.mocharc.json

@@ -0,0 +1,5 @@
+{
+    "$schema": "https://json.schemastore.org/mocharc.json",
+    "require": "tsx",
+    "spec": "test/*.ts"
+  }

package/dist/F_Client_Collection_Registry.d.ts

@@ -0,0 +1,18 @@
+import * as z from 'zod/v4';
+import { F_Collection } from './F_Collection.js';
+export declare class F_Layer<Layer_ID extends string, Layers = {}, Collections = {}> {
+    path: string[];
+    layer_id: Layer_ID;
+    collections: Collections;
+    layers: Layers;
+    constructor(layer_id: Layer_ID);
+    add_layer<Child_Layer_ID extends string, Child_Layers, Child_Collections>(layer: F_Layer<Child_Layer_ID, Child_Layers, Child_Collections>): F_Layer<Layer_ID, Layers & {
+        [key in Child_Layer_ID]: F_Layer<Child_Layer_ID, Child_Layers, Child_Collections>;
+    }, Collections>;
+    add_collection<Collection_ID extends string, ZodSchema extends z.ZodObject>(collection: F_Collection<Collection_ID, ZodSchema>): F_Layer<Layer_ID, Layers, Collections & {
+        [key in Collection_ID]: F_Collection<Collection_ID, ZodSchema>;
+    }>;
+    clone(): typeof this;
+    layer<Layer_ID extends keyof Layers>(layer_id: Layer_ID): Layers[Layer_ID];
+    collection<Collection_ID extends keyof Collections>(collection_id: Collection_ID): Collections[Collection_ID];
+}

package/dist/F_Client_Collection_Registry.js

@@ -0,0 +1,36 @@
+export class F_Layer {
+    path;
+    layer_id;
+    collections;
+    layers;
+    constructor(layer_id) {
+        this.layer_id = layer_id;
+        this.collections = {};
+        this.layers = {};
+    }
+    add_layer(layer) {
+        let result = this.clone();
+        result.layers[layer.layer_id] = layer;
+        return result;
+    }
+    add_collection(collection) {
+        let result = this.clone();
+        result.collections[collection.collection_id] = collection;
+        return result;
+    }
+    clone() {
+        let clone = new F_Layer(this.layer_id);
+        clone.collections = Object.assign({}, this.collections);
+        for (let [child_layer_id, child_layer] of Object.entries(this.layers)) {
+            clone.layers[child_layer_id] = child_layer.clone();
+        }
+        return clone;
+    }
+    layer(layer_id) {
+        return this.layers[layer_id];
+    }
+    collection(collection_id) {
+        return this.collections[collection_id];
+    }
+}
+//# sourceMappingURL=F_Client_Collection_Registry.js.map

package/dist/F_Client_Collection_Registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"F_Client_Collection_Registry.js","sourceRoot":"","sources":["../src/F_Client_Collection_Registry.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,OAAO;IAChB,IAAI,CAAU;IACd,QAAQ,CAAU;IAClB,WAAW,CAAc;IACzB,MAAM,CAAS;IAEf,YAAY,QAAkB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,EAAiB,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,EAAY,CAAC;IAC/B,CAAC;IAED,SAAS,CAAiE,KAA+D;QAMrI,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,EAItB,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;QACtC,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,cAAc,CAA8D,UAAkD;QAM1H,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,EAItB,CAAC;QAEF,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC;QAC1D,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,KAAK;QACD,IAAI,KAAK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAgB,CAAC;QACtD,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACxD,KAAI,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAC,CAAC;YAElE,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC;QACvD,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,KAAK,CAAgC,QAAkB;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,UAAU,CAA0C,aAA4B;QAC5E,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC;CACJ"}

package/dist/F_Collection.d.ts

@@ -0,0 +1,21 @@
+import * as z from "zod/v4";
+import { Model } from "mongoose";
+import { F_Security_Model } from "./F_Security_Models/F_Security_Model.js";
+export type F_Layer<Collection_ID extends string, ZodSchema extends z.ZodObject> = {
+    layers: string[];
+    security_models: F_Security_Model<Collection_ID, ZodSchema>[];
+};
+export declare 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);
+    add_layers(layers: string[], security_models: F_Security_Model<Collection_ID, ZodSchema>[], is_layer_owner?: boolean): void;
+}

package/dist/F_Collection.js

@@ -0,0 +1,36 @@
+import { mongoose_from_zod, schema_from_zod } from "./utils/mongoose_from_zod.js";
+import { query_validator_from_zod } from "./utils/query_validator_from_zod.js";
+export class F_Collection {
+    collection_id;
+    validator;
+    mongoose_schema;
+    mongoose_model;
+    query_validator_server;
+    query_validator_client;
+    put_validator;
+    post_validator;
+    is_compiled;
+    access_layers;
+    constructor(collection_name, validator) {
+        this.collection_id = collection_name;
+        this.validator = validator;
+        this.mongoose_schema = schema_from_zod(validator);
+        this.mongoose_model = mongoose_from_zod(collection_name, validator);
+        this.query_validator_server = query_validator_from_zod(validator, 'server');
+        this.query_validator_client = query_validator_from_zod(validator, 'client');
+        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, security_models, 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
+        });
+    }
+}
+//# sourceMappingURL=F_Collection.js.map

package/dist/F_Collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"F_Collection.js","sourceRoot":"","sources":["../src/F_Collection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGlF,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAQ/E,MAAM,OAAO,YAAY;IACrB,aAAa,CAAgB;IAC7B,SAAS,CAAY;IACrB,eAAe,CAAM;IACrB,cAAc,CAA4B;IAE1C,sBAAsB,CAAY;IAClC,sBAAsB,CAAY;IAClC,aAAa,CAAY;IACzB,cAAc,CAAY;IAC1B,WAAW,CAAU;IAErB,aAAa,CAAsC;IAEnD,YAAY,eAA8B,EAAE,SAAoB;QAC5D,IAAI,CAAC,aAAa,GAAG,eAAe,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,cAAc,GAAG,iBAAiB,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;QAGpE,IAAI,CAAC,sBAAsB,GAAG,wBAAwB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC5E,IAAI,CAAC,sBAAsB,GAAG,wBAAwB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAE5E,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QACzC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,EAAC,GAAG,EAAE,IAAI,EAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvH,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED,UAAU,CAAC,MAAgB,EAAE,eAA6D,EAAE,cAAc,GAAG,KAAK;QAC9G,IAAG,IAAI,CAAC,WAAW,EAAC,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QAAC,CAAC;QAC/F,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;YACpB,MAAM,EAAE,MAAM;YACd,eAAe,EAAE,eAAe;SACnC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/F_Collection_Registry.d.ts

@@ -0,0 +1,11 @@
+import * as z from 'zod/v4';
+import { F_Collection } from './F_Collection.js';
+import { Router } from 'express';
+export declare class F_Collection_Registry<Collections = {}> {
+    collections: Collections;
+    constructor();
+    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>;
+    }>;
+    compile(app: Router, api_prefix: string): void;
+}

package/dist/F_Collection_Registry.js

@@ -0,0 +1,18 @@
+import { compile } from './F_Compile.js';
+export class F_Collection_Registry {
+    collections;
+    constructor() {
+        this.collections = {};
+    }
+    register(collection) {
+        let collections = this.collections;
+        collections[collection.collection_id] = collection;
+        return this;
+    }
+    compile(app, api_prefix) {
+        for (let collection of Object.values(this.collections)) {
+            compile(app, collection, api_prefix);
+        }
+    }
+}
+//# sourceMappingURL=F_Collection_Registry.js.map

package/dist/F_Collection_Registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"F_Collection_Registry.js","sourceRoot":"","sources":["../src/F_Collection_Registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAkB,MAAM,gBAAgB,CAAA;AAKxD,MAAM,OAAO,qBAAqB;IAC9B,WAAW,CAAc;IAIzB;QACI,IAAI,CAAC,WAAW,GAAG,EAAiB,CAAC;IACzC,CAAC;IAED,QAAQ,CAA8D,UAAkD;QACpH,IAAI,WAAW,GAAG,IAAI,CAAC,WAA8F,CAAC;QAEtH,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC;QACnD,OAAO,IAA8G,CAAC;IAC1H,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,UAAkB;QACnC,KAAI,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAC,CAAC;YACnD,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;QACxC,CAAC;IACL,CAAC;CACJ"}

package/dist/F_Compile.d.ts

@@ -0,0 +1,4 @@
+import * as z from "zod/v4";
+import { Router } from "express";
+import { F_Collection } from "./F_Collection.js";
+export declare function compile<Collection_ID extends string, ZodSchema extends z.ZodObject>(app: Router, collection: F_Collection<Collection_ID, ZodSchema>, api_prefix: string): void;

package/dist/F_Compile.js

@@ -0,0 +1,298 @@
+import * as z from "zod/v4";
+import { isValidObjectId } from "mongoose";
+import { F_Security_Model } from "./F_Security_Models/F_Security_Model.js";
+import { query_object_to_mongodb_limits, query_object_to_mongodb_query } from "./utils/query_object_to_mongodb_query.js";
+export function compile(app, collection, api_prefix) {
+    for (let access_layers of collection.access_layers) {
+        let base_layers_path_components = access_layers.layers.flatMap(ele => [ele, ':' + ele]);
+        let get_one_path = [
+            api_prefix,
+            ...base_layers_path_components,
+            `${collection.collection_id}/:document_id`
+        ].join('/');
+        app.get(get_one_path, async (req, res) => {
+            if (!isValidObjectId(req.params.document_id)) {
+                res.status(400);
+                res.json({ error: `${req.params.document_id} is not a valid document ID.` });
+                return;
+            }
+            let find = { '_id': req.params.document_id };
+            for (let layer of access_layers.layers) {
+                find[`${layer}_id`] = req.params[layer];
+            }
+            let permissive_security_model = await F_Security_Model.model_with_permission(access_layers.security_models, req, res, find, 'get');
+            if (!permissive_security_model) {
+                res.status(403);
+                res.json({ error: `You do not have permission to fetch documents from ${req.params.document_type}.` });
+                return;
+            }
+            let document;
+            try {
+                document = await collection.mongoose_model.findOne(find, undefined, { 'lean': true });
+            }
+            catch (err) {
+                res.status(500);
+                res.json({ error: `there was a novel error` });
+                console.error(err);
+                return;
+            }
+            if (!document) {
+                let sendable = await permissive_security_model.handle_empty_query_results(req, res, 'get');
+                res.json(sendable);
+            }
+            else {
+                res.json({ data: document });
+            }
+        });
+        let get_multiple_path = [
+            api_prefix,
+            ...base_layers_path_components,
+            collection.collection_id
+        ].join('/');
+        app.get(get_multiple_path, async (req, res) => {
+            let validated_query_args;
+            try {
+                validated_query_args = collection.query_validator_server.parse(req.query);
+            }
+            catch (err) {
+                if (err instanceof z.ZodError) {
+                    res.status(400);
+                    res.json({ error: err.issues });
+                    return;
+                }
+                else {
+                    console.error(err);
+                    res.status(500);
+                    res.json({ error: `there was a novel error` });
+                    return;
+                }
+            }
+            let find = query_object_to_mongodb_query(validated_query_args);
+            for (let layer of access_layers.layers) {
+                find[`${layer}_id`] = req.params[layer];
+            }
+            let permissive_security_model = await F_Security_Model.model_with_permission(access_layers.security_models, req, res, find, 'get');
+            if (!permissive_security_model) {
+                res.status(403);
+                res.json({ error: `You do not have permission to fetch documents from ${req.params.document_type}.` });
+                return;
+            }
+            let documents;
+            try {
+                let query = collection.mongoose_model.find(find, undefined, { 'lean': true });
+                let fetch = query_object_to_mongodb_limits(query, collection.query_validator_server);
+                documents = await fetch;
+            }
+            catch (err) {
+                if (err.name == 'CastError') {
+                    res.status(400);
+                    res.json({ error: 'one of the IDs you passed to the query was not a valid MongoDB object ID.' });
+                    return;
+                }
+                else {
+                    res.status(500);
+                    res.send({ error: 'there was a novel error' });
+                    console.error(err);
+                    return;
+                }
+            }
+            if (!documents) {
+                let sendable = await permissive_security_model.handle_empty_query_results(req, res, 'get');
+                res.json(sendable);
+            }
+            else {
+                res.json({ data: documents });
+            }
+        });
+        let put_path = [
+            api_prefix,
+            ...base_layers_path_components,
+            `${collection.collection_id}/:document_id`
+        ].join('/');
+        app.put(put_path, async (req, res) => {
+            if (!isValidObjectId(req.params.document_id)) {
+                res.status(400);
+                res.json({ error: `${req.params.document_id} is not a valid document ID.` });
+                return;
+            }
+            let find = { '_id': req.params.document_id };
+            for (let layer of access_layers.layers) {
+                find[`${layer}_id`] = req.params[layer];
+            }
+            let permissive_security_model = await F_Security_Model.model_with_permission(access_layers.security_models, req, res, find, 'update');
+            if (!permissive_security_model) {
+                res.status(403);
+                res.json({ error: `You do not have permission to fetch documents from ${req.params.document_type}.` });
+                return;
+            }
+            if (collection.mongoose_schema.updated_by?.type === String) {
+                if (req.auth?.user_id) {
+                    req.body.updated_by = req.auth?.user_id;
+                }
+                else {
+                    req.body.updated_by = null;
+                }
+            }
+            if (collection.mongoose_schema.updated_at?.type === Date) {
+                req.body.updated_at = new Date();
+            }
+            let validated_request_body;
+            try {
+                validated_request_body = await collection.put_validator.parse(req.body);
+            }
+            catch (err) {
+                if (err instanceof z.ZodError) {
+                    res.status(400);
+                    res.json({ error: err.issues });
+                    return;
+                }
+                else {
+                    console.error(err);
+                    res.status(500);
+                    res.json({ error: `there was a novel error` });
+                    return;
+                }
+            }
+            for (let layer of access_layers.layers) {
+                if (validated_request_body[`${layer}_id`] && validated_request_body[`${layer}_id`] !== req.params[layer]) {
+                    res.status(403);
+                    res.json({ error: `The system does not support changing the ${layer}_id of the document with this endpoint.` });
+                    return;
+                }
+            }
+            let results;
+            try {
+                results = await collection.mongoose_model.findOneAndUpdate(find, validated_request_body, { returnDocument: 'after', lean: true });
+            }
+            catch (err) {
+                res.status(500);
+                res.json({ error: `there was a novel error` });
+                console.error(err);
+                return;
+            }
+            if (!results) {
+                let sendable = await permissive_security_model.handle_empty_query_results(req, res, 'update');
+                res.json(sendable);
+            }
+            else {
+                res.json({ data: results });
+            }
+        });
+        let post_path = [
+            api_prefix,
+            ...base_layers_path_components,
+            `${collection.collection_id}`
+        ].join('/');
+        app.post(post_path, async (req, res) => {
+            let permissive_security_model = await F_Security_Model.model_with_permission(access_layers.security_models, req, res, undefined, 'create');
+            if (!permissive_security_model) {
+                res.status(403);
+                res.json({ error: `You do not have permission to fetch documents from ${req.params.document_type}.` });
+                return;
+            }
+            if (collection.mongoose_schema.updated_by?.type === String) {
+                if (req.auth?.user_id) {
+                    req.body.updated_by = req.auth?.user_id;
+                }
+                else {
+                    req.body.updated_by = null;
+                }
+            }
+            if (collection.mongoose_schema.updated_at?.type === Date) {
+                req.body.updated_at = new Date();
+            }
+            if (collection.mongoose_schema.created_by?.type === String) {
+                if (req.auth?.user_id) {
+                    req.body.created_by = req.auth?.user_id;
+                }
+                else {
+                    req.body.created_by = null;
+                }
+            }
+            if (collection.mongoose_schema.created_at?.type === Date) {
+                req.body.created_at = new Date();
+            }
+            let validated_request_body;
+            try {
+                validated_request_body = await collection.post_validator.parse(req.body);
+            }
+            catch (err) {
+                if (err instanceof z.ZodError) {
+                    res.status(400);
+                    res.json({ error: err.issues });
+                    return;
+                }
+                else {
+                    console.error(err);
+                    res.status(500);
+                    res.json({ error: `there was a novel error` });
+                    return;
+                }
+            }
+            for (let layer of access_layers.layers) {
+                if (validated_request_body[`${layer}_id`] && validated_request_body[`${layer}_id`] !== req.params[layer]) {
+                    res.status(403);
+                    res.json({ error: `The system does not support changing the ${layer}_id of the document with this endpoint.` });
+                    return;
+                }
+            }
+            let results;
+            try {
+                results = await collection.mongoose_model.create(validated_request_body);
+            }
+            catch (err) {
+                res.status(500);
+                res.json({ error: `there was a novel error` });
+                console.error(err);
+                return;
+            }
+            if (!results) {
+                let sendable = await permissive_security_model.handle_empty_query_results(req, res, 'create');
+                res.json(sendable);
+            }
+            else {
+                res.json({ data: results });
+            }
+        });
+        let delete_path = [
+            api_prefix,
+            ...base_layers_path_components,
+            `${collection.collection_id}/:document_id`
+        ].join('/');
+        app.delete(delete_path, async (req, res) => {
+            if (!isValidObjectId(req.params.document_id)) {
+                res.status(400);
+                res.json({ error: `${req.params.document_id} is not a valid document ID.` });
+                return;
+            }
+            let find = { '_id': req.params.document_id };
+            for (let layer of access_layers.layers) {
+                find[`${layer}_id`] = req.params[layer];
+            }
+            let permissive_security_model = await F_Security_Model.model_with_permission(access_layers.security_models, req, res, find, 'delete');
+            if (!permissive_security_model) {
+                res.status(403);
+                res.json({ error: `You do not have permission to fetch documents from ${req.params.document_type}.` });
+                return;
+            }
+            let results;
+            try {
+                results = await collection.mongoose_model.findOneAndDelete(find, { lean: true });
+            }
+            catch (err) {
+                res.status(500);
+                res.json({ error: `there was a novel error` });
+                console.error(err);
+                return;
+            }
+            if (!results) {
+                let sendable = await permissive_security_model.handle_empty_query_results(req, res, 'delete');
+                res.json(sendable);
+            }
+            else {
+                res.json({ data: results });
+            }
+        });
+    }
+}
+//# sourceMappingURL=F_Compile.js.map

package/dist/F_Compile.js.map

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

package/dist/F_Security_Models/F_SM_Open_Access.d.ts

@@ -0,0 +1,11 @@
+import * as z from "zod/v4";
+import { Request, Response } from "express";
+import { Empty_Query_Possibilities, F_Security_Model, Operation } from "./F_Security_Model.js";
+import { F_Collection } from "../F_Collection.js";
+export declare class F_SM_Open_Access<Collection_ID extends string, ZodSchema extends z.ZodObject> extends F_Security_Model<Collection_ID, ZodSchema> {
+    constructor(collection: F_Collection<Collection_ID, ZodSchema>);
+    has_permission(req: Request, res: Response, find: {
+        [key: string]: any;
+    }, operation: Operation): Promise<boolean>;
+    handle_empty_query_results(req: Request, res: Response, operation: Operation): Promise<Empty_Query_Possibilities>;
+}

package/dist/F_Security_Models/F_SM_Open_Access.js

@@ -0,0 +1,14 @@
+import { F_Security_Model } from "./F_Security_Model.js";
+export class F_SM_Open_Access extends F_Security_Model {
+    constructor(collection) {
+        super(collection);
+        this.needs_auth_user = false;
+    }
+    async has_permission(req, res, find, operation) {
+        return true;
+    }
+    async handle_empty_query_results(req, res, operation) {
+        return { data: null };
+    }
+}
+//# sourceMappingURL=F_SM_Open_Access.js.map

package/dist/F_Security_Models/F_SM_Open_Access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"F_SM_Open_Access.js","sourceRoot":"","sources":["../../src/F_Security_Models/F_SM_Open_Access.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6B,gBAAgB,EAAa,MAAM,uBAAuB,CAAC;AAG/F,MAAM,OAAO,gBAA8E,SAAQ,gBAA0C;IAEzI,YAAY,UAAkD;QAC1D,KAAK,CAAC,UAAU,CAAC,CAAC;QAClB,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,GAAY,EAAE,GAAa,EAAE,IAA0B,EAAE,SAAoB;QAC9F,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,0BAA0B,CAAC,GAAY,EAAE,GAAa,EAAE,SAAoB;QAC9E,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACzB,CAAC;CAEJ"}

package/dist/F_Security_Models/F_SM_Ownership.d.ts

@@ -0,0 +1,12 @@
+import * as z from "zod/v4";
+import { Request, Response } from "express";
+import { F_Collection } from "../F_Collection.js";
+import { Authenticated_Request, Empty_Query_Possibilities, F_Security_Model, Operation } from "./F_Security_Model.js";
+export declare class F_SM_Ownership<Collection_ID extends string, ZodSchema extends z.ZodObject> extends F_Security_Model<Collection_ID, ZodSchema> {
+    user_id_field: string;
+    constructor(collection: F_Collection<Collection_ID, ZodSchema>, user_id_field?: string);
+    has_permission(req: Authenticated_Request, res: Response, find: {
+        [key: string]: any;
+    }, operation: Operation): Promise<boolean>;
+    handle_empty_query_results(req: Request, res: Response, operation: Operation): Promise<Empty_Query_Possibilities>;
+}

package/dist/F_Security_Models/F_SM_Ownership.js

@@ -0,0 +1,46 @@
+import { F_Security_Model } from "./F_Security_Model.js";
+export class F_SM_Ownership extends F_Security_Model {
+    user_id_field;
+    constructor(collection, user_id_field = 'user_id') {
+        super(collection);
+        this.needs_auth_user = true;
+        this.user_id_field = user_id_field;
+    }
+    async has_permission(req, res, find, operation) {
+        let user_id = '' + req.auth.user_id;
+        if (operation === 'get') {
+            if (req.params.document_id) {
+                find[this.user_id_field] = user_id;
+                return true;
+            }
+            if (find[this.user_id_field] === user_id) {
+                return true;
+            }
+        }
+        if (operation === 'update') {
+            find[this.user_id_field] = user_id;
+            return true;
+        }
+        if (operation === 'create') {
+            if (req.body[this.user_id_field] === user_id) {
+                return true;
+            }
+        }
+        if (operation === 'delete') {
+            find[this.user_id_field] = user_id;
+            return true;
+        }
+        return false;
+    }
+    async handle_empty_query_results(req, res, operation) {
+        if (req.params.document_id) {
+            let document_result = await this.collection.mongoose_model.findById(req.params.document_id);
+            if (document_result) {
+                res.status(403);
+                return { error: `You do not have permission to ${operation} documents from ${req.params.document_type}.` };
+            }
+        }
+        return { data: null };
+    }
+}
+//# sourceMappingURL=F_SM_Ownership.js.map

package/dist/F_Security_Models/F_SM_Ownership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"F_SM_Ownership.js","sourceRoot":"","sources":["../../src/F_Security_Models/F_SM_Ownership.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoD,gBAAgB,EAAa,MAAM,uBAAuB,CAAC;AAEtH,MAAM,OAAO,cAA4E,SAAQ,gBAA0C;IACvI,aAAa,CAAS;IAEtB,YAAY,UAAkD,EAAE,aAAa,GAAG,SAAS;QACrF,KAAK,CAAC,UAAU,CAAC,CAAC;QAClB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,GAA0B,EAAE,GAAa,EAAE,IAA0B,EAAE,SAAoB;QAC5G,IAAI,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;QAEpC,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YAItB,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC;gBAEnC,OAAO,IAAI,CAAC;YAChB,CAAC;YAID,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,OAAO,EAAE,CAAC;gBACvC,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;QAID,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC;YACnC,OAAO,IAAI,CAAC;QAChB,CAAC;QAID,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YACzB,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,OAAO,EAAE,CAAC;gBAC3C,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;QAID,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC;YACnC,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,0BAA0B,CAAC,GAAY,EAAE,GAAa,EAAE,SAAoB;QAC9E,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACzB,IAAI,eAAe,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAE5F,IAAI,eAAe,EAAE,CAAC;gBAClB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChB,OAAO,EAAE,KAAK,EAAE,iCAAiC,SAAS,mBAAmB,GAAG,CAAC,MAAM,CAAC,aAAa,GAAG,EAAE,CAAC;YAC/G,CAAC;QACL,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC1B,CAAC;CACJ"}

package/dist/F_Security_Models/F_SM_Role_Membership.d.ts

@@ -0,0 +1,19 @@
+import * as z from "zod/v4";
+import { Request, Response } from "express";
+import { F_Collection } from "../F_Collection.js";
+import { Cache } from "../utils/cache.js";
+import { Authenticated_Request, Empty_Query_Possibilities, F_Security_Model, Operation } from "./F_Security_Model.js";
+export declare class F_SM_Role_Membership<Collection_ID extends string, ZodSchema extends z.ZodObject> extends F_Security_Model<Collection_ID, ZodSchema> {
+    user_id_field: string;
+    role_id_field: string;
+    layer_collection_id: string;
+    role_membership_collection: F_Collection<string, any>;
+    role_membership_cache: Cache<any>;
+    role_collection: F_Collection<string, any>;
+    role_cache: Cache<any>;
+    constructor(collection: F_Collection<Collection_ID, ZodSchema>, layer_collection: F_Collection<string, any>, role_membership_collection: F_Collection<string, any>, role_collection: F_Collection<string, any>, role_membership_cache?: Cache<any>, role_cache?: Cache<any>, user_id_field?: string, role_id_field?: string);
+    has_permission(req: Authenticated_Request, res: Response, find: {
+        [key: string]: any;
+    }, operation: Operation): Promise<boolean>;
+    handle_empty_query_results(req: Request, res: Response, operation: Operation): Promise<Empty_Query_Possibilities>;
+}