@aeriajs/core 0.0.87 → 0.0.89

package/dist/assets.d.ts

@@ -1,7 +1,7 @@
 import type { Context, Collection, Token } from '@aeriajs/types';
 import { ACError } from '@aeriajs/types';
-export declare const internalGetCollectionAsset: <TCollectionName extends string, TAssetName extends "item" | "description" | "security" | "functions" | "contracts" | "exposedFunctions">(collectionName: TCollectionName, assetName: TAssetName) => Promise<import("@aeriajs/types").Left<ACError.ResourceNotFound> | import("@aeriajs/types").Left<ACError.AssetNotFound> | import("@aeriajs/types").Right<any>>;
-export declare const getCollectionAsset: <TCollectionName extends string, TAssetName extends "item" | "description" | "security" | "functions" | "contracts" | "exposedFunctions">(collectionName: TCollectionName, assetName: TAssetName) => Promise<import("@aeriajs/types").Left<ACError.ResourceNotFound> | import("@aeriajs/types").Left<ACError.AssetNotFound> | import("@aeriajs/types").Right<NonNullable<Collection[TAssetName]>>>;
+export declare const internalGetCollectionAsset: <TCollectionName extends string, TAssetName extends "item" | "description" | "security" | "functions" | "contracts" | "exposedFunctions">(collectionName: TCollectionName, assetName: TAssetName) => Promise<import("@aeriajs/types").Left<ACError.ResourceNotFound> | import("@aeriajs/types").Right<any>>;
+export declare const getCollectionAsset: <TCollectionName extends string, TAssetName extends "item" | "description" | "security" | "functions" | "contracts" | "exposedFunctions">(collectionName: TCollectionName, assetName: TAssetName) => Promise<import("@aeriajs/types").Left<ACError.ResourceNotFound> | import("@aeriajs/types").Right<NonNullable<Collection[TAssetName]>>>;
 export declare const getFunction: <TCollectionName extends string, TFunctionName extends string>(collectionName: TCollectionName, functionName: TFunctionName, token?: Token, options?: {
     exposedOnly: boolean;
-}) => Promise<import("@aeriajs/types").Left<ACError.ResourceNotFound> | import("@aeriajs/types").Left<ACError.AssetNotFound> | import("@aeriajs/types").Left<ACError.FunctionNotFound> | import("@aeriajs/types").Left<ACError.FunctionNotExposed> | import("@aeriajs/types").Left<ACError.AuthorizationError> | import("@aeriajs/types").Right<(payload: unknown, context: Context) => Promise<any>>>;
+}) => Promise<import("@aeriajs/types").Left<ACError.ResourceNotFound> | import("@aeriajs/types").Left<ACError.FunctionNotFound> | import("@aeriajs/types").Left<ACError.FunctionNotExposed> | import("@aeriajs/types").Left<ACError.AuthorizationError> | import("@aeriajs/types").Right<(payload: unknown, context: Context) => Promise<any>>>;

package/dist/assets.js

@@ -13,10 +13,7 @@ const internalGetCollectionAsset = async (collectionName, assetName) => {
     const collection = await (0, entrypoint_1.getCollection)(collectionName);
     const asset = collection?.[assetName];
     if (!asset) {
-        if (!collection) {
-            return (0, common_1.left)(types_1.ACError.ResourceNotFound);
-        }
-        return (0, common_1.left)(types_1.ACError.AssetNotFound);
+        return (0, common_1.left)(types_1.ACError.ResourceNotFound);
     }
     return (0, common_1.right)(asset);
 };
@@ -63,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";
@@ -11,10 +11,7 @@ export const internalGetCollectionAsset = async (collectionName, assetName) => {
   const collection = await getCollection(collectionName);
   const asset = collection?.[assetName];
   if (!asset) {
-    if (!collection) {
-      return left(ACError.ResourceNotFound);
-    }
-    return left(ACError.AssetNotFound);
+    return left(ACError.ResourceNotFound);
   }
   return right(asset);
 };
@@ -61,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

@@ -8,8 +8,7 @@ export declare const defineCollection: <TCollection extends Omit<Collection<TCol
     contracts?: TContracts;
     exposedFunctions?: TExposedFunctions;
     security?: CollectionSecurityPolicy<{
-        description: NoInfer<TDescription>;
-        functions: NoInfer<TFunctions>;
+        functions: TFunctions;
     }>;
 }) => TCollection & {
     item: SchemaWithId<TDescription>;
@@ -21,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/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"
 }

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)) {
@@ -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 { ACError, ValidationErrorCode } from "@aeriajs/types";
 import { left, right, isLeft, unwrapEither, unsafe, 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)) {
@@ -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,7 +79,7 @@ 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);

package/dist/context.mjs

@@ -54,7 +54,7 @@ export const createContext = async (options = {}) => {
   context.error = (httpStatus, endpointError) => {
     return error(Object.assign({
       httpStatus
-    }, endpointError), context);
+    }, endpointError));
   };
   context.limitRate = (params) => {
     return limitRate(params, context);

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,6 +1,7 @@
 "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");
@@ -35,7 +36,9 @@ 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, {
         getters: true,

package/dist/functions/builtin/get.mjs

@@ -1,4 +1,5 @@
 "use strict";
+import { HTTPStatus, ACError } from "@aeriajs/types";
 import { useSecurity } from "@aeriajs/security";
 import { unsafe } from "@aeriajs/common";
 import {
@@ -40,7 +41,9 @@ export const get = async (payload, context, options) => {
   }));
   const result = await context.collection.model.aggregate(pipeline).next();
   if (!result) {
-    return null;
+    return context.error(HTTPStatus.NotFound, {
+      code: ACError.ResourceNotFound
+    });
   }
   return fill(unsafe(await traverseDocument(result, context.description, {
     getters: true,

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

@@ -1,5 +1,30 @@
-import type { Context, SchemaWithId, InsertPayload } from '@aeriajs/types';
+import type { Context, SchemaWithId, InsertPayload, InsertReturnType } from '@aeriajs/types';
+import { HTTPStatus, ACError, ValidationErrorCode } from '@aeriajs/types';
 export type InsertOptions = {
     bypassSecurity?: boolean;
 };
-export declare const insert: <TContext extends Context>(payload: InsertPayload<SchemaWithId<TContext['description']>>, context: TContext, options?: InsertOptions) => Promise<import("@aeriajs/types").Left<import("@aeriajs/types").ACError | import("@aeriajs/types").ValidationError> | import("@aeriajs/types").Right<SchemaWithId<TContext["description"]>>>;
+export declare const insertErrorSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly value: {
+            readonly type: "object";
+            readonly required: readonly ["httpStatus", "code"];
+            readonly properties: {
+                readonly httpStatus: {
+                    readonly enum: (HTTPStatus.NotFound | HTTPStatus.UnprocessableContent)[];
+                };
+                readonly code: {
+                    readonly enum: (ACError | ValidationErrorCode)[];
+                };
+                readonly message: {
+                    readonly type: "string";
+                };
+                readonly details: {
+                    readonly type: "object";
+                    readonly variable: true;
+                };
+            };
+        };
+    };
+};
+export declare const insert: <TContext extends Context>(payload: InsertPayload<SchemaWithId<TContext['description']>>, context: TContext, options?: InsertOptions) => Promise<InsertReturnType<SchemaWithId<TContext['description']>>>;

package/dist/functions/builtin/insert.js

@@ -1,9 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.insert = void 0;
+exports.insert = exports.insertErrorSchema = 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");
+exports.insertErrorSchema = (0, common_1.endpointErrorSchema)({
+    httpStatus: [
+        types_1.HTTPStatus.UnprocessableContent,
+        types_1.HTTPStatus.NotFound,
+    ],
+    code: [
+        types_1.ACError.InsecureOperator,
+        types_1.ACError.OwnershipError,
+        types_1.ACError.ResourceNotFound,
+        types_1.ACError.TargetImmutable,
+        types_1.ValidationErrorCode.EmptyTarget,
+        types_1.ValidationErrorCode.InvalidProperties,
+        types_1.ValidationErrorCode.MissingProperties,
+    ],
+});
 const insert = async (payload, context, options) => {
     const security = (0, security_1.useSecurity)(context);
     const query = !options?.bypassSecurity
@@ -21,52 +37,69 @@ const insert = async (payload, context, options) => {
     });
     if ((0, common_1.isLeft)(whatEither)) {
         const error = (0, common_1.unwrapEither)(whatEither);
-        return (0, common_1.left)(error);
+        if (typeof error === 'string') {
+            return context.error(types_1.HTTPStatus.UnprocessableContent, {
+                code: error,
+            });
+        }
+        return context.error(types_1.HTTPStatus.UnprocessableContent, {
+            code: error.code,
+            details: error.errors,
+        });
     }
     const what = (0, common_1.unwrapEither)(whatEither);
     const docId = '_id' in what
         ? what._id
         : null;
-    const readyWhat = (0, index_js_1.prepareInsert)(what, context.description);
+    const content = (0, index_js_1.prepareInsert)(what, context.description);
     const projection = payload.project
         ? (0, index_js_1.normalizeProjection)(payload.project, context.description)
         : {};
     let newId = docId;
     if (!newId) {
         const now = new Date();
-        Object.assign(readyWhat, {
+        Object.assign(content, {
             created_at: now,
             updated_at: now,
         });
-        newId = (await context.collection.model.insertOne(readyWhat)).insertedId;
+        newId = (await context.collection.model.insertOne(content)).insertedId;
     }
     else {
-        readyWhat.$set ??= {};
-        readyWhat.$set.updated_at = new Date();
+        content.$set ??= {};
+        content.$set.updated_at = new Date();
         await context.collection.model.updateOne({
             _id: docId,
-        }, readyWhat);
+        }, content);
     }
+    let doc;
     if (context.collection.originalFunctions.get) {
-        const document = await context.collection.originalFunctions.get({
+        doc = await context.collection.originalFunctions.get({
             filters: {
                 _id: newId,
             },
-        }, context, {
+        }, Object.assign({
+            inherited: true,
+        }, context), {
             bypassSecurity: true,
         });
-        return (0, common_1.right)(document);
     }
-    const document = await context.collection.model.findOne({
-        _id: newId,
-    }, {
-        projection,
-    });
-    const result = (0, common_1.unsafe)(await (0, index_js_1.traverseDocument)(document, context.description, {
+    else {
+        doc = await context.collection.model.findOne({
+            _id: newId,
+        }, {
+            projection,
+        });
+    }
+    if (!doc) {
+        return context.error(types_1.HTTPStatus.NotFound, {
+            code: types_1.ACError.ResourceNotFound,
+        });
+    }
+    const result = (0, common_1.unsafe)(await (0, index_js_1.traverseDocument)(doc, context.description, {
         getters: true,
         fromProperties: true,
         recurseReferences: true,
     }));
-    return (0, common_1.right)(result);
+    return result;
 };
 exports.insert = insert;

package/dist/functions/builtin/insert.mjs

@@ -1,7 +1,23 @@
 "use strict";
+import { HTTPStatus, ACError, ValidationErrorCode } from "@aeriajs/types";
 import { useSecurity } from "@aeriajs/security";
-import { left, right, isLeft, unwrapEither, unsafe } from "@aeriajs/common";
+import { isLeft, unwrapEither, unsafe, endpointErrorSchema } from "@aeriajs/common";
 import { traverseDocument, normalizeProjection, prepareInsert } from "../../collection/index.mjs";
+export const insertErrorSchema = endpointErrorSchema({
+  httpStatus: [
+    HTTPStatus.UnprocessableContent,
+    HTTPStatus.NotFound
+  ],
+  code: [
+    ACError.InsecureOperator,
+    ACError.OwnershipError,
+    ACError.ResourceNotFound,
+    ACError.TargetImmutable,
+    ValidationErrorCode.EmptyTarget,
+    ValidationErrorCode.InvalidProperties,
+    ValidationErrorCode.MissingProperties
+  ]
+});
 export const insert = async (payload, context, options) => {
   const security = useSecurity(context);
   const query = !options?.bypassSecurity ? unsafe(await security.beforeWrite(payload)) : payload;
@@ -15,46 +31,62 @@ export const insert = async (payload, context, options) => {
   });
   if (isLeft(whatEither)) {
     const error = unwrapEither(whatEither);
-    return left(error);
+    if (typeof error === "string") {
+      return context.error(HTTPStatus.UnprocessableContent, {
+        code: error
+      });
+    }
+    return context.error(HTTPStatus.UnprocessableContent, {
+      code: error.code,
+      details: error.errors
+    });
   }
   const what = unwrapEither(whatEither);
   const docId = "_id" in what ? what._id : null;
-  const readyWhat = prepareInsert(what, context.description);
+  const content = prepareInsert(what, context.description);
   const projection = payload.project ? normalizeProjection(payload.project, context.description) : {};
   let newId = docId;
   if (!newId) {
     const now = /* @__PURE__ */ new Date();
-    Object.assign(readyWhat, {
+    Object.assign(content, {
       created_at: now,
       updated_at: now
     });
-    newId = (await context.collection.model.insertOne(readyWhat)).insertedId;
+    newId = (await context.collection.model.insertOne(content)).insertedId;
   } else {
-    readyWhat.$set ??= {};
-    readyWhat.$set.updated_at = /* @__PURE__ */ new Date();
+    content.$set ??= {};
+    content.$set.updated_at = /* @__PURE__ */ new Date();
     await context.collection.model.updateOne({
       _id: docId
-    }, readyWhat);
+    }, content);
   }
+  let doc;
   if (context.collection.originalFunctions.get) {
-    const document2 = await context.collection.originalFunctions.get({
+    doc = await context.collection.originalFunctions.get({
       filters: {
         _id: newId
       }
-    }, context, {
+    }, Object.assign({
+      inherited: true
+    }, context), {
       bypassSecurity: true
     });
-    return right(document2);
+  } else {
+    doc = await context.collection.model.findOne({
+      _id: newId
+    }, {
+      projection
+    });
   }
-  const document = await context.collection.model.findOne({
-    _id: newId
-  }, {
-    projection
-  });
-  const result = unsafe(await traverseDocument(document, context.description, {
+  if (!doc) {
+    return context.error(HTTPStatus.NotFound, {
+      code: ACError.ResourceNotFound
+    });
+  }
+  const result = unsafe(await traverseDocument(doc, context.description, {
     getters: true,
     fromProperties: true,
     recurseReferences: true
   }));
-  return right(result);
+  return result;
 };

package/dist/functions/builtin/remove.js

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.remove = void 0;
+const types_1 = require("@aeriajs/types");
 const common_1 = require("@aeriajs/common");
 const index_js_1 = require("../../collection/index.js");
 const remove = async (payload, context) => {
     if (!payload.filters._id) {
-        return (0, common_1.left)({
-            message: 'you must pass an _id as filter',
+        return context.error(types_1.HTTPStatus.NotFound, {
+            code: types_1.ACError.ResourceNotFound,
         });
     }
     const filters = (0, common_1.unsafe)(await (0, index_js_1.traverseDocument)(payload.filters, context.description, {
@@ -14,8 +15,8 @@ const remove = async (payload, context) => {
     }));
     const target = await context.collection.model.findOne(filters);
     if (!target) {
-        return (0, common_1.left)({
-            message: 'target not found',
+        return context.error(types_1.HTTPStatus.NotFound, {
+            code: types_1.ACError.ResourceNotFound,
         });
     }
     await (0, index_js_1.cascadingRemove)(target, context);

package/dist/functions/builtin/remove.mjs

@@ -1,10 +1,11 @@
 "use strict";
-import { left, unsafe } from "@aeriajs/common";
+import { HTTPStatus, ACError } from "@aeriajs/types";
+import { unsafe } from "@aeriajs/common";
 import { traverseDocument, cascadingRemove } from "../../collection/index.mjs";
 export const remove = async (payload, context) => {
   if (!payload.filters._id) {
-    return left({
-      message: "you must pass an _id as filter"
+    return context.error(HTTPStatus.NotFound, {
+      code: ACError.ResourceNotFound
     });
   }
   const filters = unsafe(await traverseDocument(payload.filters, context.description, {
@@ -12,8 +13,8 @@ export const remove = async (payload, context) => {
   }));
   const target = await context.collection.model.findOne(filters);
   if (!target) {
-    return left({
-      message: "target not found"
+    return context.error(HTTPStatus.NotFound, {
+      code: ACError.ResourceNotFound
     });
   }
   await cascadingRemove(target, context);

package/dist/use.d.ts

@@ -1 +1 @@
-export declare const createAeria: () => Promise<import("@aeriajs/types").RouteContext<null> & import("@aeriajs/types").CollectionContext<any, any>>;
+export declare const createAeria: () => Promise<import("@aeriajs/types").RouteContext<null> & import("@aeriajs/types").CollectionContext<import("@aeriajs/types").Description, any>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aeriajs/core",
-  "version": "0.0.87",
+  "version": "0.0.89",
   "description": "",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -41,13 +41,13 @@
     "mongodb-memory-server": "^9.2.0"
   },
   "peerDependencies": {
-    "@aeriajs/builtins": "^0.0.87",
-    "@aeriajs/common": "^0.0.53",
-    "@aeriajs/entrypoint": "^0.0.53",
-    "@aeriajs/http": "^0.0.61",
-    "@aeriajs/security": "^0.0.87",
-    "@aeriajs/types": "^0.0.50",
-    "@aeriajs/validation": "^0.0.56"
+    "@aeriajs/builtins": "^0.0.89",
+    "@aeriajs/common": "^0.0.55",
+    "@aeriajs/entrypoint": "^0.0.55",
+    "@aeriajs/http": "^0.0.63",
+    "@aeriajs/security": "^0.0.89",
+    "@aeriajs/types": "^0.0.52",
+    "@aeriajs/validation": "^0.0.58"
   },
   "dependencies": {
     "mongodb": "^6.5.0",

package/dist/collection/utils.d.ts

@@ -1,4 +0,0 @@
-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;
-export declare const fill: <TDocument extends OptionalId<any>>(item: TDocument & Record<string, any>, description: Pick<Description, 'properties' | 'freshItem'>) => Record<string, any> & TDocument;
-export declare const prepareInsert: (payload: any, description: Pick<Description, 'properties' | 'form' | 'writable' | 'owned' | 'defaults'>) => Record<string, any>;

package/dist/collection/utils.js

@@ -1,89 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.prepareInsert = exports.fill = exports.normalizeProjection = void 0;
-const common_1 = require("@aeriajs/common");
-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;
-const fill = (item, description) => {
-    const itemCopy = Object.assign({}, item);
-    for (const key in itemCopy) {
-        if (itemCopy[key] === null) {
-            delete itemCopy[key];
-        }
-    }
-    return Object.assign((0, common_1.freshItem)(description), itemCopy);
-};
-exports.fill = fill;
-const prepareInsert = (payload, description) => {
-    const rest = Object.assign({}, payload);
-    const docId = payload._id;
-    delete rest._id;
-    delete rest.created_at;
-    delete rest.updated_at;
-    const forbidden = (key) => {
-        return description.properties[key].readOnly
-            || (description.writable && !description.writable.includes(key));
-    };
-    const prepareUpdate = () => Object.entries(rest).reduce((a, [key, value]) => {
-        // it's a mongodb operator
-        if (key[0] === '$') {
-            // it's not possible to use mongodb operators when user specifies
-            // writable properties nor when it is a creation operation
-            if (!description.writable && docId) {
-                a[key] = value;
-            }
-            return a;
-        }
-        if (forbidden(key)) {
-            return a;
-        }
-        if (value === null || value === undefined) {
-            a.$unset[key] = 1;
-            return a;
-        }
-        a.$set[key] = value;
-        return a;
-    }, {
-        $set: description.defaults || {},
-        $unset: {},
-    });
-    const prepareCreate = () => Object.entries(rest).reduce((a, [key, value]) => {
-        if (forbidden(key) || [
-            undefined,
-            null,
-        ].includes(value)) {
-            return a;
-        }
-        return {
-            ...a,
-            [key]: value,
-        };
-    }, description.defaults || {});
-    const what = docId
-        ? prepareUpdate()
-        : prepareCreate();
-    Object.keys(what).forEach((k) => {
-        if (typeof what[k] === 'object' && JSON.stringify(what) === '{}') {
-            delete what[k];
-        }
-    });
-    return what;
-};
-exports.prepareInsert = prepareInsert;

package/dist/collection/utils.mjs

@@ -1,76 +0,0 @@
-"use strict";
-import { freshItem } from "@aeriajs/common";
-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;
-};
-export const fill = (item, description) => {
-  const itemCopy = Object.assign({}, item);
-  for (const key in itemCopy) {
-    if (itemCopy[key] === null) {
-      delete itemCopy[key];
-    }
-  }
-  return Object.assign(freshItem(description), itemCopy);
-};
-export const prepareInsert = (payload, description) => {
-  const rest = Object.assign({}, payload);
-  const docId = payload._id;
-  delete rest._id;
-  delete rest.created_at;
-  delete rest.updated_at;
-  const forbidden = (key) => {
-    return description.properties[key].readOnly || description.writable && !description.writable.includes(key);
-  };
-  const prepareUpdate = () => Object.entries(rest).reduce((a, [key, value]) => {
-    if (key[0] === "$") {
-      if (!description.writable && docId) {
-        a[key] = value;
-      }
-      return a;
-    }
-    if (forbidden(key)) {
-      return a;
-    }
-    if (value === null || value === void 0) {
-      a.$unset[key] = 1;
-      return a;
-    }
-    a.$set[key] = value;
-    return a;
-  }, {
-    $set: description.defaults || {},
-    $unset: {}
-  });
-  const prepareCreate = () => Object.entries(rest).reduce((a, [key, value]) => {
-    if (forbidden(key) || [
-      void 0,
-      null
-    ].includes(value)) {
-      return a;
-    }
-    return {
-      ...a,
-      [key]: value
-    };
-  }, description.defaults || {});
-  const what = docId ? prepareUpdate() : prepareCreate();
-  Object.keys(what).forEach((k) => {
-    if (typeof what[k] === "object" && JSON.stringify(what) === "{}") {
-      delete what[k];
-    }
-  });
-  return what;
-};