@aeriajs/core 0.0.88 → 0.0.90

package/dist/assets.js

@@ -60,13 +60,9 @@ const getFunction = async (collectionName, functionName, token, options = {
         const securityPolicy = collection.security?.functions?.[functionName];
         if (securityPolicy) {
             if (securityPolicy.rateLimiting) {
-                const rateLimitingEither = await (0, security_1.limitRate)(securityPolicy.rateLimiting, context);
-                if ((0, common_1.isLeft)(rateLimitingEither)) {
-                    const error = (0, common_1.unwrapEither)(rateLimitingEither);
-                    return context.error(types_1.HTTPStatus.TooManyRequests, {
-                        code: error,
-                        message: 'rate limit was achieved for this resource',
-                    });
+                const rate = await (0, security_1.limitRate)(securityPolicy.rateLimiting, context);
+                if ((0, common_1.isError)(rate)) {
+                    return rate;
                 }
             }
         }

package/dist/assets.mjs

@@ -1,6 +1,6 @@
 "use strict";
-import { ACError, HTTPStatus } from "@aeriajs/types";
-import { left, right, isLeft, unwrapEither } from "@aeriajs/common";
+import { ACError } from "@aeriajs/types";
+import { isError, left, right, isLeft, unwrapEither } from "@aeriajs/common";
 import { limitRate } from "@aeriajs/security";
 import { getCollection } from "@aeriajs/entrypoint";
 import { isFunctionExposed, FunctionExposedStatus } from "./accessControl.mjs";
@@ -58,13 +58,9 @@ export const getFunction = async (collectionName, functionName, token, options =
     const securityPolicy = collection.security?.functions?.[functionName];
     if (securityPolicy) {
       if (securityPolicy.rateLimiting) {
-        const rateLimitingEither = await limitRate(securityPolicy.rateLimiting, context);
-        if (isLeft(rateLimitingEither)) {
-          const error = unwrapEither(rateLimitingEither);
-          return context.error(HTTPStatus.TooManyRequests, {
-            code: error,
-            message: "rate limit was achieved for this resource"
-          });
+        const rate = await limitRate(securityPolicy.rateLimiting, context);
+        if (isError(rate)) {
+          return rate;
         }
       }
     }

package/dist/collection/define.d.ts

@@ -20,7 +20,7 @@ export declare const extendCollection: <const TLeftCollection extends Collection
     description?: Partial<Description> | undefined;
     item?: Partial<any> | undefined;
     security?: Partial<CollectionSecurityPolicy<any> | undefined>;
-    functions?: Partial<Record<string, (payload: any, context: import("@aeriajs/types").Context, ...args: any[]) => any> | undefined>;
+    functions?: Partial<Record<string, (payload: any, context: import("@aeriajs/types").Context<any>, ...args: any[]) => any> | undefined>;
     contracts?: Partial<Record<string, Contract> | undefined>;
     exposedFunctions?: Partial<Record<string, AccessCondition> | undefined>;
 }>(left: TLeftCollection, right: TRightCollection) => ExtendCollection<TLeftCollection, TRightCollection>;

package/dist/collection/fill.d.ts

@@ -0,0 +1,2 @@
+import type { Description } from '@aeriajs/types';
+export declare const fill: <TDocument extends OptionalId<any>>(doc: TDocument & Record<string, any>, description: Description) => Record<string, any> & TDocument;

package/dist/collection/fill.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fill = void 0;
+const common_1 = require("@aeriajs/common");
+const fill = (doc, description) => {
+    const docCopy = Object.assign({}, doc);
+    for (const key in docCopy) {
+        if (docCopy[key] === null) {
+            delete docCopy[key];
+        }
+    }
+    return Object.assign((0, common_1.freshItem)(description), docCopy);
+};
+exports.fill = fill;

package/dist/collection/fill.mjs

@@ -0,0 +1,11 @@
+"use strict";
+import { freshItem } from "@aeriajs/common";
+export const fill = (doc, description) => {
+  const docCopy = Object.assign({}, doc);
+  for (const key in docCopy) {
+    if (docCopy[key] === null) {
+      delete docCopy[key];
+    }
+  }
+  return Object.assign(freshItem(description), docCopy);
+};

package/dist/collection/index.d.ts

@@ -1,8 +1,10 @@
 export * from './cascadingRemove.js';
 export * from './define.js';
 export * from './description.js';
+export * from './fill.js';
+export * from './normalizeProjection.js';
 export * from './pagination.js';
 export * from './preload.js';
+export * from './prepareInsert.js';
 export * from './reference.js';
 export * from './traverseDocument.js';
-export * from './utils.js';

package/dist/collection/index.js

@@ -17,8 +17,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./cascadingRemove.js"), exports);
 __exportStar(require("./define.js"), exports);
 __exportStar(require("./description.js"), exports);
+__exportStar(require("./fill.js"), exports);
+__exportStar(require("./normalizeProjection.js"), exports);
 __exportStar(require("./pagination.js"), exports);
 __exportStar(require("./preload.js"), exports);
+__exportStar(require("./prepareInsert.js"), exports);
 __exportStar(require("./reference.js"), exports);
 __exportStar(require("./traverseDocument.js"), exports);
-__exportStar(require("./utils.js"), exports);

package/dist/collection/index.mjs

@@ -2,8 +2,10 @@
 export * from "./cascadingRemove.mjs";
 export * from "./define.mjs";
 export * from "./description.mjs";
+export * from "./fill.mjs";
+export * from "./normalizeProjection.mjs";
 export * from "./pagination.mjs";
 export * from "./preload.mjs";
+export * from "./prepareInsert.mjs";
 export * from "./reference.mjs";
 export * from "./traverseDocument.mjs";
-export * from "./utils.mjs";

package/dist/collection/normalizeProjection.d.ts

@@ -0,0 +1,2 @@
+import type { Description } from '@aeriajs/types';
+export declare const normalizeProjection: <TDescription extends Pick<Description, "properties">, TProjectedProperties extends (keyof TDescription["properties"])[]>(properties: TProjectedProperties, description: TDescription) => {} | null;

package/dist/collection/normalizeProjection.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeProjection = void 0;
+const normalizeProjection = (properties, description) => {
+    const target = Array.from(properties);
+    if (target.length === 0) {
+        target.push(...Object.keys(description.properties));
+    }
+    const projection = target.reduce((a, key) => {
+        if (key !== '_id' && description.properties[key].hidden) {
+            return a;
+        }
+        return {
+            ...a,
+            [key]: 1,
+        };
+    }, {});
+    return Object.keys(projection).length === 0
+        ? null
+        : projection;
+};
+exports.normalizeProjection = normalizeProjection;

package/dist/collection/normalizeProjection.mjs

@@ -0,0 +1,17 @@
+"use strict";
+export const normalizeProjection = (properties, description) => {
+  const target = Array.from(properties);
+  if (target.length === 0) {
+    target.push(...Object.keys(description.properties));
+  }
+  const projection = target.reduce((a, key) => {
+    if (key !== "_id" && description.properties[key].hidden) {
+      return a;
+    }
+    return {
+      ...a,
+      [key]: 1
+    };
+  }, {});
+  return Object.keys(projection).length === 0 ? null : projection;
+};

package/dist/collection/pagination.js

@@ -6,7 +6,7 @@ const makePagination = async (payload, documents, context) => {
         ? payload.limit
         : context.config.paginationLimit;
     const offset = payload.offset || 0;
-    const recordsTotal = context.collection.functions.count
+    const recordsTotal = context.collection.originalFunctions.count
         ? await context.collection.functions.count({
             filters: payload.filters,
         })

package/dist/collection/pagination.mjs

@@ -2,7 +2,7 @@
 export const makePagination = async (payload, documents, context) => {
   const limit = payload.limit ? payload.limit : context.config.paginationLimit;
   const offset = payload.offset || 0;
-  const recordsTotal = context.collection.functions.count ? await context.collection.functions.count({
+  const recordsTotal = context.collection.originalFunctions.count ? await context.collection.functions.count({
     filters: payload.filters
   }) : await context.collection.model.countDocuments(payload.filters);
   return {

package/dist/collection/prepareInsert.d.ts

@@ -0,0 +1,2 @@
+import type { Description } from '@aeriajs/types';
+export declare const prepareInsert: <TPayload extends Record<string, any>>(payload: TPayload, description: Description) => Record<string, any>;

package/dist/collection/prepareInsert.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareInsert = void 0;
+const prepareCreate = (doc, description) => {
+    const result = Object.assign({}, description.defaults || {});
+    for (const propName in doc) {
+        const value = doc[propName];
+        if (value === null || value === undefined) {
+            continue;
+        }
+        result[propName] = value;
+    }
+    return result;
+};
+const prepareUpdate = (doc) => {
+    const result = {
+        $set: {},
+        $unset: {},
+    };
+    for (const propName in doc) {
+        const value = doc[propName];
+        if (value === null || value === undefined) {
+            result.$unset[propName] = value;
+            continue;
+        }
+        result.$set[propName] = value;
+    }
+    return result;
+};
+const prepareInsert = (payload, description) => {
+    const doc = Object.assign({}, payload);
+    const docId = payload._id;
+    delete doc._id;
+    delete doc.created_at;
+    delete doc.updated_at;
+    const what = docId
+        ? prepareUpdate(doc)
+        : prepareCreate(doc, description);
+    Object.keys(what).forEach((k) => {
+        if (typeof what[k] === 'object' && Object.keys(what[k]).length === 0) {
+            delete what[k];
+        }
+    });
+    return what;
+};
+exports.prepareInsert = prepareInsert;

package/dist/collection/prepareInsert.mjs

@@ -0,0 +1,41 @@
+"use strict";
+const prepareCreate = (doc, description) => {
+  const result = Object.assign({}, description.defaults || {});
+  for (const propName in doc) {
+    const value = doc[propName];
+    if (value === null || value === void 0) {
+      continue;
+    }
+    result[propName] = value;
+  }
+  return result;
+};
+const prepareUpdate = (doc) => {
+  const result = {
+    $set: {},
+    $unset: {}
+  };
+  for (const propName in doc) {
+    const value = doc[propName];
+    if (value === null || value === void 0) {
+      result.$unset[propName] = value;
+      continue;
+    }
+    result.$set[propName] = value;
+  }
+  return result;
+};
+export const prepareInsert = (payload, description) => {
+  const doc = Object.assign({}, payload);
+  const docId = payload._id;
+  delete doc._id;
+  delete doc.created_at;
+  delete doc.updated_at;
+  const what = docId ? prepareUpdate(doc) : prepareCreate(doc, description);
+  Object.keys(what).forEach((k) => {
+    if (typeof what[k] === "object" && Object.keys(what[k]).length === 0) {
+      delete what[k];
+    }
+  });
+  return what;
+};

package/dist/collection/reference.js

@@ -101,7 +101,7 @@ const getReferences = async (properties, options) => {
             }
         }
         else {
-            const description = (0, common_1.unsafe)(await (0, assets_js_1.getCollectionAsset)(refProperty.$ref, 'description'));
+            const description = (0, common_1.throwIfLeft)(await (0, assets_js_1.getCollectionAsset)(refProperty.$ref, 'description'));
             const deepReferences = await (0, exports.getReferences)(description.properties, {
                 depth: depth + 1,
                 memoize: `${memoize}.${propName}`,
@@ -159,7 +159,7 @@ const buildLookupStages = async (reference, propName, options) => {
         else {
             const subPipeline = [];
             if (reference.deepReferences) {
-                const subProperties = (0, common_1.unsafe)(await (0, assets_js_1.getCollectionAsset)(reference.referencedCollection, 'description')).properties;
+                const subProperties = (0, common_1.throwIfLeft)(await (0, assets_js_1.getCollectionAsset)(reference.referencedCollection, 'description')).properties;
                 subPipeline.push(...await (0, exports.buildLookupPipeline)(reference.deepReferences, {
                     project: reference.populatedProperties,
                     properties: subProperties,
@@ -227,7 +227,7 @@ const buildLookupStages = async (reference, propName, options) => {
                 continue;
             }
             if (refMap.referencedCollection) {
-                const description = (0, common_1.unsafe)(await (0, assets_js_1.getCollectionAsset)(refMap.referencedCollection, 'description'));
+                const description = (0, common_1.throwIfLeft)(await (0, assets_js_1.getCollectionAsset)(refMap.referencedCollection, 'description'));
                 const { stages: result } = await buildLookupStages(refMap, refName, {
                     depth: depth + 1,
                     parent: withParent(propName),

package/dist/collection/reference.mjs

@@ -1,5 +1,5 @@
 "use strict";
-import { unsafe, getReferenceProperty } from "@aeriajs/common";
+import { throwIfLeft, getReferenceProperty } from "@aeriajs/common";
 import { getCollectionAsset } from "../assets.mjs";
 import { prepareCollectionName } from "../database.mjs";
 const referenceMemo = {};
@@ -90,7 +90,7 @@ export const getReferences = async (properties, options) => {
         }
       }
     } else {
-      const description = unsafe(await getCollectionAsset(refProperty.$ref, "description"));
+      const description = throwIfLeft(await getCollectionAsset(refProperty.$ref, "description"));
       const deepReferences = await getReferences(description.properties, {
         depth: depth + 1,
         memoize: `${memoize}.${propName}`
@@ -147,7 +147,7 @@ const buildLookupStages = async (reference, propName, options) => {
     } else {
       const subPipeline = [];
       if (reference.deepReferences) {
-        const subProperties = unsafe(await getCollectionAsset(reference.referencedCollection, "description")).properties;
+        const subProperties = throwIfLeft(await getCollectionAsset(reference.referencedCollection, "description")).properties;
         subPipeline.push(...await buildLookupPipeline(reference.deepReferences, {
           project: reference.populatedProperties,
           properties: subProperties
@@ -210,7 +210,7 @@ const buildLookupStages = async (reference, propName, options) => {
         continue;
       }
       if (refMap.referencedCollection) {
-        const description = unsafe(await getCollectionAsset(refMap.referencedCollection, "description"));
+        const description = throwIfLeft(await getCollectionAsset(refMap.referencedCollection, "description"));
         const { stages: result2 } = await buildLookupStages(refMap, refName, {
           depth: depth + 1,
           parent: withParent(propName),

package/dist/collection/traverseDocument.d.ts

@@ -1,10 +1,11 @@
-import type { Description, Property, ACError, ValidationError, Context } from '@aeriajs/types';
+import type { Description, Property, ValidationError, Context } from '@aeriajs/types';
+import { ACError } from '@aeriajs/types';
 import { ObjectId } from 'mongodb';
 export type TraverseOptions = {
     autoCast?: boolean;
     getters?: boolean;
     validate?: boolean;
-    validateRequired?: string[];
+    validateRequired?: Description['required'];
     moveFiles?: boolean;
     fromProperties?: boolean;
     allowOperators?: boolean;
@@ -16,7 +17,7 @@ export type TraverseNormalized = {
     description: Description;
     pipe: <T = unknown>(value: unknown, phaseContext: PhaseContext) => T | Promise<T>;
 };
-export declare enum TraverseErrors {
+export declare enum TraverseError {
     InvalidDocumentId = "INVALID_DOCUMENT_ID",
     InvalidTempfile = "INVALID_TEMPFILE"
 }
@@ -30,5 +31,5 @@ type PhaseContext = {
     property: Property;
     options: TraverseOptions & TraverseNormalized;
 };
-export declare const traverseDocument: <const TWhat extends Record<string, any>>(what: TWhat, description: Description, _options: TraverseOptions) => Promise<import("@aeriajs/types").Right<any> | import("@aeriajs/types").Left<ACError | ValidationError>>;
+export declare const traverseDocument: <const TWhat extends Record<string, unknown>>(what: TWhat, description: Description, _options: TraverseOptions) => Promise<import("@aeriajs/types").Right<any> | import("@aeriajs/types").Left<ACError.InsecureOperator | ValidationError>>;
 export {};

package/dist/collection/traverseDocument.js

@@ -23,7 +23,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.traverseDocument = exports.TraverseErrors = void 0;
+exports.traverseDocument = exports.TraverseError = void 0;
 const types_1 = require("@aeriajs/types");
 const common_1 = require("@aeriajs/common");
 const validation_1 = require("@aeriajs/validation");
@@ -31,11 +31,11 @@ const mongodb_1 = require("mongodb");
 const assets_js_1 = require("../assets.js");
 const preload_js_1 = require("./preload.js");
 const fs = __importStar(require("fs/promises"));
-var TraverseErrors;
-(function (TraverseErrors) {
-    TraverseErrors["InvalidDocumentId"] = "INVALID_DOCUMENT_ID";
-    TraverseErrors["InvalidTempfile"] = "INVALID_TEMPFILE";
-})(TraverseErrors || (exports.TraverseErrors = TraverseErrors = {}));
+var TraverseError;
+(function (TraverseError) {
+    TraverseError["InvalidDocumentId"] = "INVALID_DOCUMENT_ID";
+    TraverseError["InvalidTempfile"] = "INVALID_TEMPFILE";
+})(TraverseError || (exports.TraverseError = TraverseError = {}));
 const getProperty = (propertyName, parentProperty) => {
     if (propertyName === '_id') {
         return {
@@ -65,7 +65,7 @@ const disposeOldFiles = async (ctx, options = {}) => {
         },
     });
     if (!doc) {
-        return (0, common_1.left)(TraverseErrors.InvalidDocumentId);
+        return (0, common_1.left)(TraverseError.InvalidDocumentId);
     }
     let fileIds = (0, common_1.getValueFromPath)(doc, ctx.propPath);
     if (options.fromIds) {
@@ -196,7 +196,7 @@ const moveFiles = async (value, ctx) => {
         _id: new mongodb_1.ObjectId(value.tempId),
     });
     if (!tempFile) {
-        return (0, common_1.left)(TraverseErrors.InvalidTempfile);
+        return (0, common_1.left)(TraverseError.InvalidTempfile);
     }
     if (ctx.root._id) {
         await disposeOldFiles(ctx);
@@ -268,12 +268,13 @@ const recurse = async (target, ctx) => {
             // if first propName is preceded by '$' we assume
             // it contains MongoDB query operators
             if (Object.keys(value)[0]?.startsWith('$')) {
-                if (ctx.options.allowOperators) {
-                    entries.push([
-                        propName,
-                        value,
-                    ]);
+                if (!ctx.options.allowOperators) {
+                    return (0, common_1.left)(types_1.ACError.InsecureOperator);
                 }
+                entries.push([
+                    propName,
+                    value,
+                ]);
                 continue;
             }
             if (Array.isArray(value)) {
@@ -306,7 +307,7 @@ const recurse = async (target, ctx) => {
                     ? property.items
                     : property;
                 if ('$ref' in propCast && value && !(value instanceof mongodb_1.ObjectId)) {
-                    const targetDescription = await (0, preload_js_1.preloadDescription)((0, common_1.unsafe)(await (0, assets_js_1.getCollectionAsset)(propCast.$ref, 'description')));
+                    const targetDescription = await (0, preload_js_1.preloadDescription)((0, common_1.throwIfLeft)(await (0, assets_js_1.getCollectionAsset)(propCast.$ref, 'description')));
                     if (Array.isArray(value)) {
                         const documents = [];
                         for (const elem of value) {
@@ -412,7 +413,7 @@ const traverseDocument = async (what, description, _options) => {
     }
     if (validationError) {
         return (0, common_1.left)((0, validation_1.makeValidationError)({
-            code: types_1.ValidationErrorCodes.InvalidProperties,
+            code: types_1.ValidationErrorCode.InvalidProperties,
             errors: validationError,
         }));
     }

package/dist/collection/traverseDocument.mjs

@@ -1,16 +1,16 @@
 "use strict";
-import { ValidationErrorCodes } from "@aeriajs/types";
-import { left, right, isLeft, unwrapEither, unsafe, pipe, isReference, getValueFromPath, isObjectId } from "@aeriajs/common";
+import { ACError, ValidationErrorCode } from "@aeriajs/types";
+import { left, right, isLeft, unwrapEither, throwIfLeft, pipe, isReference, getValueFromPath, isObjectId } from "@aeriajs/common";
 import { makeValidationError, validateProperty, validateWholeness } from "@aeriajs/validation";
 import { ObjectId } from "mongodb";
 import { getCollectionAsset } from "../assets.mjs";
 import { preloadDescription } from "./preload.mjs";
 import * as fs from "fs/promises";
-export var TraverseErrors = /* @__PURE__ */ ((TraverseErrors2) => {
-  TraverseErrors2["InvalidDocumentId"] = "INVALID_DOCUMENT_ID";
-  TraverseErrors2["InvalidTempfile"] = "INVALID_TEMPFILE";
-  return TraverseErrors2;
-})(TraverseErrors || {});
+export var TraverseError = /* @__PURE__ */ ((TraverseError2) => {
+  TraverseError2["InvalidDocumentId"] = "INVALID_DOCUMENT_ID";
+  TraverseError2["InvalidTempfile"] = "INVALID_TEMPFILE";
+  return TraverseError2;
+})(TraverseError || {});
 const getProperty = (propertyName, parentProperty) => {
   if (propertyName === "_id") {
     return {
@@ -230,12 +230,13 @@ const recurse = async (target, ctx) => {
     }
     if (!property && value && (value.constructor === Object || value.constructor === Array)) {
       if (Object.keys(value)[0]?.startsWith("$")) {
-        if (ctx.options.allowOperators) {
-          entries.push([
-            propName,
-            value
-          ]);
+        if (!ctx.options.allowOperators) {
+          return left(ACError.InsecureOperator);
         }
+        entries.push([
+          propName,
+          value
+        ]);
         continue;
       }
       if (Array.isArray(value)) {
@@ -266,7 +267,7 @@ const recurse = async (target, ctx) => {
       if (ctx.options.recurseReferences) {
         const propCast = "items" in property ? property.items : property;
         if ("$ref" in propCast && value && !(value instanceof ObjectId)) {
-          const targetDescription = await preloadDescription(unsafe(await getCollectionAsset(propCast.$ref, "description")));
+          const targetDescription = await preloadDescription(throwIfLeft(await getCollectionAsset(propCast.$ref, "description")));
           if (Array.isArray(value)) {
             const documents = [];
             for (const elem of value) {
@@ -370,7 +371,7 @@ export const traverseDocument = async (what, description, _options) => {
   }
   if (validationError) {
     return left(makeValidationError({
-      code: ValidationErrorCodes.InvalidProperties,
+      code: ValidationErrorCode.InvalidProperties,
       errors: validationError
     }));
   }

package/dist/context.d.ts

@@ -1,2 +1,2 @@
 import type { ContextOptions } from '@aeriajs/types';
-export declare const createContext: (options?: ContextOptions) => Promise<import("@aeriajs/types").RouteContext<null> & import("@aeriajs/types").CollectionContext<any, any>>;
+export declare const createContext: (options?: ContextOptions) => Promise<import("@aeriajs/types").RouteContext<null> & import("@aeriajs/types").CollectionContext<import("@aeriajs/types").Description, any>>;

package/dist/context.js

@@ -79,13 +79,13 @@ const createContext = async (options = {}) => {
     context.error = (httpStatus, endpointError) => {
         return (0, common_1.error)(Object.assign({
             httpStatus,
-        }, endpointError), context);
+        }, endpointError));
     };
     context.limitRate = (params) => {
         return (0, security_1.limitRate)(params, context);
     };
     if (collectionName) {
-        const description = (0, common_1.unsafe)(await getCollectionAsset(collectionName, 'description'));
+        const description = (0, common_1.throwIfLeft)(await getCollectionAsset(collectionName, 'description'));
         context.description = await (0, preload_js_1.preloadDescription)(description);
         context.collectionName = collectionName;
         context.collection = indepthCollection(collectionName, collections, context);

package/dist/context.mjs

@@ -1,5 +1,5 @@
 "use strict";
-import { unsafe, error } from "@aeriajs/common";
+import { throwIfLeft, error } from "@aeriajs/common";
 import { getCollections } from "@aeriajs/entrypoint";
 import { limitRate } from "@aeriajs/security";
 import { getDatabaseCollection } from "./database.mjs";
@@ -54,13 +54,13 @@ export const createContext = async (options = {}) => {
   context.error = (httpStatus, endpointError) => {
     return error(Object.assign({
       httpStatus
-    }, endpointError), context);
+    }, endpointError));
   };
   context.limitRate = (params) => {
     return limitRate(params, context);
   };
   if (collectionName) {
-    const description = unsafe(await getCollectionAsset(collectionName, "description"));
+    const description = throwIfLeft(await getCollectionAsset(collectionName, "description"));
     context.description = await preloadDescription(description);
     context.collectionName = collectionName;
     context.collection = indepthCollection(collectionName, collections, context);

package/dist/functions/builtin/count.js

@@ -6,9 +6,9 @@ const common_1 = require("@aeriajs/common");
 const index_js_1 = require("../../collection/index.js");
 const count = async (payload, context) => {
     const security = (0, security_1.useSecurity)(context);
-    const { filters } = (0, common_1.unsafe)(await security.beforeRead(payload));
+    const { filters } = (0, common_1.throwIfLeft)(await security.beforeRead(payload));
     const { $text, ...filtersRest } = filters;
-    const traversedFilters = (0, common_1.unsafe)(await (0, index_js_1.traverseDocument)(filtersRest, context.description, {
+    const traversedFilters = (0, common_1.throwIfLeft)(await (0, index_js_1.traverseDocument)(filtersRest, context.description, {
         autoCast: true,
         allowOperators: true,
     }));

package/dist/functions/builtin/count.mjs

@@ -1,12 +1,12 @@
 "use strict";
 import { useSecurity } from "@aeriajs/security";
-import { unsafe } from "@aeriajs/common";
+import { throwIfLeft } from "@aeriajs/common";
 import { traverseDocument } from "../../collection/index.mjs";
 export const count = async (payload, context) => {
   const security = useSecurity(context);
-  const { filters } = unsafe(await security.beforeRead(payload));
+  const { filters } = throwIfLeft(await security.beforeRead(payload));
   const { $text, ...filtersRest } = filters;
-  const traversedFilters = unsafe(await traverseDocument(filtersRest, context.description, {
+  const traversedFilters = throwIfLeft(await traverseDocument(filtersRest, context.description, {
     autoCast: true,
     allowOperators: true
   }));

package/dist/functions/builtin/get.d.ts

@@ -1,5 +1,5 @@
-import type { Context, SchemaWithId, GetPayload } from '@aeriajs/types';
+import type { Context, SchemaWithId, GetPayload, GetReturnType } from '@aeriajs/types';
 export type GetOptions = {
     bypassSecurity?: boolean;
 };
-export declare const get: <TContext extends Context>(payload: GetPayload<SchemaWithId<TContext['description']>>, context: TContext extends Context<any> ? TContext : never, options?: GetOptions) => Promise<SchemaWithId<TContext['description']> | null>;
+export declare const get: <TContext extends Context>(payload: GetPayload<SchemaWithId<TContext['description']>>, context: TContext extends Context<any> ? TContext : never, options?: GetOptions) => Promise<GetReturnType<TContext['description']>>;

package/dist/functions/builtin/get.js

@@ -1,13 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.get = void 0;
+const types_1 = require("@aeriajs/types");
 const security_1 = require("@aeriajs/security");
 const common_1 = require("@aeriajs/common");
 const index_js_1 = require("../../collection/index.js");
 const get = async (payload, context, options) => {
     const security = (0, security_1.useSecurity)(context);
     const { filters = {}, project = [], } = !options?.bypassSecurity
-        ? (0, common_1.unsafe)(await security.beforeRead(payload))
+        ? (0, common_1.throwIfLeft)(await security.beforeRead(payload))
         : payload;
     if (Object.keys(filters).length === 0) {
         throw new Error('no filters were passed');
@@ -17,7 +18,7 @@ const get = async (payload, context, options) => {
         memoize: context.description.$id,
     });
     pipeline.push({
-        $match: (0, common_1.unsafe)(await (0, index_js_1.traverseDocument)(filters, context.description, {
+        $match: (0, common_1.throwIfLeft)(await (0, index_js_1.traverseDocument)(filters, context.description, {
             autoCast: true,
             allowOperators: true,
         })),
@@ -35,9 +36,11 @@ const get = async (payload, context, options) => {
     }));
     const result = await context.collection.model.aggregate(pipeline).next();
     if (!result) {
-        return null;
+        return context.error(types_1.HTTPStatus.NotFound, {
+            code: types_1.ACError.ResourceNotFound,
+        });
     }
-    return (0, index_js_1.fill)((0, common_1.unsafe)(await (0, index_js_1.traverseDocument)(result, context.description, {
+    return (0, index_js_1.fill)((0, common_1.throwIfLeft)(await (0, index_js_1.traverseDocument)(result, context.description, {
         getters: true,
         fromProperties: true,
         recurseReferences: true,