@aeriajs/core 0.0.85 → 0.0.87

package/dist/assets.d.ts

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

package/dist/assets.js

@@ -14,9 +14,9 @@ const internalGetCollectionAsset = async (collectionName, assetName) => {
     const asset = collection?.[assetName];
     if (!asset) {
         if (!collection) {
-            return (0, common_1.left)(types_1.ACErrors.ResourceNotFound);
+            return (0, common_1.left)(types_1.ACError.ResourceNotFound);
         }
-        return (0, common_1.left)(types_1.ACErrors.AssetNotFound);
+        return (0, common_1.left)(types_1.ACError.AssetNotFound);
     }
     return (0, common_1.right)(asset);
 };
@@ -45,18 +45,18 @@ const getFunction = async (collectionName, functionName, token, options = {
     }
     const functions = (0, common_1.unwrapEither)(functionsEither);
     if (!(functionName in functions)) {
-        return (0, common_1.left)(types_1.ACErrors.FunctionNotFound);
+        return (0, common_1.left)(types_1.ACError.FunctionNotFound);
     }
     const collection = await (0, entrypoint_1.getCollection)(collectionName);
     const fn = functions[functionName];
     if (!collection) {
-        return (0, common_1.left)(types_1.ACErrors.ResourceNotFound);
+        return (0, common_1.left)(types_1.ACError.ResourceNotFound);
     }
     if (options.exposedOnly) {
         const exposedStatus = await (0, accessControl_js_1.isFunctionExposed)(collection, functionName, token);
         switch (exposedStatus) {
-            case accessControl_js_1.FunctionExposedStatus.FunctionNotExposed: return (0, common_1.left)(types_1.ACErrors.FunctionNotExposed);
-            case accessControl_js_1.FunctionExposedStatus.FunctionNotGranted: return (0, common_1.left)(types_1.ACErrors.AuthorizationError);
+            case accessControl_js_1.FunctionExposedStatus.FunctionNotExposed: return (0, common_1.left)(types_1.ACError.FunctionNotExposed);
+            case accessControl_js_1.FunctionExposedStatus.FunctionNotGranted: return (0, common_1.left)(types_1.ACError.AuthorizationError);
         }
     }
     const wrapper = async (payload, context) => {
@@ -65,9 +65,10 @@ const getFunction = async (collectionName, functionName, token, options = {
             if (securityPolicy.rateLimiting) {
                 const rateLimitingEither = await (0, security_1.limitRate)(securityPolicy.rateLimiting, context);
                 if ((0, common_1.isLeft)(rateLimitingEither)) {
-                    return (0, common_1.left)({
-                        error: (0, common_1.unwrapEither)(rateLimitingEither),
-                        httpCode: 429,
+                    const error = (0, common_1.unwrapEither)(rateLimitingEither);
+                    return context.error(types_1.HTTPStatus.TooManyRequests, {
+                        code: error,
+                        message: 'rate limit was achieved for this resource',
                     });
                 }
             }

package/dist/assets.mjs

@@ -1,5 +1,5 @@
 "use strict";
-import { ACErrors } from "@aeriajs/types";
+import { ACError, HTTPStatus } from "@aeriajs/types";
 import { left, right, isLeft, unwrapEither } from "@aeriajs/common";
 import { limitRate } from "@aeriajs/security";
 import { getCollection } from "@aeriajs/entrypoint";
@@ -12,9 +12,9 @@ export const internalGetCollectionAsset = async (collectionName, assetName) => {
   const asset = collection?.[assetName];
   if (!asset) {
     if (!collection) {
-      return left(ACErrors.ResourceNotFound);
+      return left(ACError.ResourceNotFound);
     }
-    return left(ACErrors.AssetNotFound);
+    return left(ACError.AssetNotFound);
   }
   return right(asset);
 };
@@ -41,20 +41,20 @@ export const getFunction = async (collectionName, functionName, token, options =
   }
   const functions = unwrapEither(functionsEither);
   if (!(functionName in functions)) {
-    return left(ACErrors.FunctionNotFound);
+    return left(ACError.FunctionNotFound);
   }
   const collection = await getCollection(collectionName);
   const fn = functions[functionName];
   if (!collection) {
-    return left(ACErrors.ResourceNotFound);
+    return left(ACError.ResourceNotFound);
   }
   if (options.exposedOnly) {
     const exposedStatus = await isFunctionExposed(collection, functionName, token);
     switch (exposedStatus) {
       case FunctionExposedStatus.FunctionNotExposed:
-        return left(ACErrors.FunctionNotExposed);
+        return left(ACError.FunctionNotExposed);
       case FunctionExposedStatus.FunctionNotGranted:
-        return left(ACErrors.AuthorizationError);
+        return left(ACError.AuthorizationError);
     }
   }
   const wrapper = async (payload, context) => {
@@ -63,9 +63,10 @@ export const getFunction = async (collectionName, functionName, token, options =
       if (securityPolicy.rateLimiting) {
         const rateLimitingEither = await limitRate(securityPolicy.rateLimiting, context);
         if (isLeft(rateLimitingEither)) {
-          return left({
-            error: unwrapEither(rateLimitingEither),
-            httpCode: 429
+          const error = unwrapEither(rateLimitingEither);
+          return context.error(HTTPStatus.TooManyRequests, {
+            code: error,
+            message: "rate limit was achieved for this resource"
           });
         }
       }

package/dist/collection/define.d.ts

@@ -1,27 +1,27 @@
-import type { SchemaWithId, Collection, Context, Contract, ContractToFunction, Description, CollectionSecurityPolicy, AccessCondition } from '@aeriajs/types';
+import type { SchemaWithId, Collection, StrictContext, Contract, ContractToFunction, Description, CollectionSecurityPolicy, AccessCondition, RoleFromAccessCondition } from '@aeriajs/types';
 export type ExtendCollection<TLeftCollection extends Collection, TRightCollection> = Omit<TLeftCollection & TRightCollection, 'item'> & {
     item: SchemaWithId<(TLeftCollection & TRightCollection)['description']>;
 };
-export declare const defineCollection: <TCollection extends Omit<Collection<TCollection extends Collection ? TCollection : never>, "item" | "description" | "security" | "functions" | "exposedFunctions">, const TDescription extends Description<TDescription>, const TFunctionContracts extends { [P in keyof TFunctions]?: Contract | undefined; }, const TFunctions extends Record<string, (payload: any, context: Context) => any> & { [P_1 in keyof TFunctionContracts]: ContractToFunction<NonNullable<TFunctionContracts[P_1]>, Context<TDescription>>; }>(collection: TCollection & {
+export declare const defineCollection: <TCollection extends Omit<Collection<TCollection extends Collection ? TCollection : never>, "item" | "description" | "security" | "functions" | "exposedFunctions">, const TDescription extends Description<TDescription>, const TContracts extends { [P in keyof TFunctions]?: Contract | undefined; }, const TExposedFunctions extends Partial<Record<keyof TFunctions, AccessCondition>>, const TFunctions extends Record<string, (payload: any, context: StrictContext<any>) => any> & { [P_1 in keyof TContracts | keyof TExposedFunctions]: ContractToFunction<P_1 extends keyof TContracts ? NonNullable<TContracts[P_1]> : any, StrictContext<P_1 extends keyof TExposedFunctions ? RoleFromAccessCondition<TExposedFunctions[P_1]> : never, TDescription>>; }>(collection: TCollection & {
     description: TDescription;
     functions?: TFunctions;
-    functionContracts?: TFunctionContracts;
-    exposedFunctions?: Partial<Record<keyof TFunctions, AccessCondition>>;
+    contracts?: TContracts;
+    exposedFunctions?: TExposedFunctions;
     security?: CollectionSecurityPolicy<{
         description: NoInfer<TDescription>;
-        functions: TFunctions;
+        functions: NoInfer<TFunctions>;
     }>;
 }) => TCollection & {
     item: SchemaWithId<TDescription>;
     description: TDescription;
     functions: TFunctions;
-    functionContracts: TFunctionContracts;
+    contracts: TContracts;
 };
 export declare const extendCollection: <const TLeftCollection extends Collection, const TRightCollection extends {
     description?: Partial<Description> | undefined;
     item?: Partial<any> | undefined;
     security?: Partial<CollectionSecurityPolicy<any> | undefined>;
-    functions?: Partial<Record<string, (payload: any, context: Context, ...args: any[]) => any> | undefined>;
-    functionContracts?: Partial<Record<string, Contract> | undefined>;
+    functions?: Partial<Record<string, (payload: any, context: import("@aeriajs/types").Context, ...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/traverseDocument.d.ts

@@ -1,4 +1,4 @@
-import type { Description, Property, ACErrors, ValidationError, Context } from '@aeriajs/types';
+import type { Description, Property, ACError, ValidationError, Context } from '@aeriajs/types';
 import { ObjectId } from 'mongodb';
 export type TraverseOptions = {
     autoCast?: boolean;
@@ -30,5 +30,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<ACErrors | ValidationError>>;
+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 {};

package/dist/context.js

@@ -76,8 +76,10 @@ const createContext = async (options = {}) => {
             created_at: new Date(),
         });
     };
-    context.error = (endpointError) => {
-        return (0, common_1.error)(endpointError, context);
+    context.error = (httpStatus, endpointError) => {
+        return (0, common_1.error)(Object.assign({
+            httpStatus,
+        }, endpointError), context);
     };
     context.limitRate = (params) => {
         return (0, security_1.limitRate)(params, context);

package/dist/context.mjs

@@ -51,8 +51,10 @@ export const createContext = async (options = {}) => {
       created_at: /* @__PURE__ */ new Date()
     });
   };
-  context.error = (endpointError) => {
-    return error(endpointError, context);
+  context.error = (httpStatus, endpointError) => {
+    return error(Object.assign({
+      httpStatus
+    }, endpointError), context);
   };
   context.limitRate = (params) => {
     return limitRate(params, context);

package/dist/endpoints.js

@@ -37,7 +37,7 @@ const getEndpoints = async () => {
         const collection = typeof candidate === 'function'
             ? candidate()
             : candidate;
-        const { description, functions: collectionFunctions, functionContracts, exposedFunctions = {}, } = collection;
+        const { description, functions: collectionFunctions, contracts, exposedFunctions = {}, } = collection;
         if (collectionFunctions) {
             for (const fnName in collectionFunctions) {
                 const exposedStatus = await (0, accessControl_js_1.isFunctionExposed)(collection, fnName);
@@ -51,22 +51,22 @@ const getEndpoints = async () => {
                     : exposed
                         ? await (0, entrypoint_1.getAvailableRoles)()
                         : [];
-                const contracts = {
+                const endpointContracts = {
                     POST: null,
                 };
                 if (roles.length) {
-                    contracts.POST ??= {};
-                    contracts.POST.roles = roles;
+                    endpointContracts.POST ??= {};
+                    endpointContracts.POST.roles = roles;
                 }
-                if (functionContracts && fnName in functionContracts) {
-                    contracts.POST ??= {};
-                    Object.assign(contracts.POST, functionContracts[fnName]);
+                if (contracts && fnName in contracts) {
+                    endpointContracts.POST ??= {};
+                    Object.assign(endpointContracts.POST, contracts[fnName]);
                 }
                 if (fnName in builtinFunctions) {
-                    contracts.POST ??= {};
-                    contracts.POST.builtin = true;
+                    endpointContracts.POST ??= {};
+                    endpointContracts.POST.builtin = true;
                 }
-                functions[endpoint] = contracts;
+                functions[endpoint] = endpointContracts;
             }
         }
     }

package/dist/endpoints.mjs

@@ -13,7 +13,7 @@ export const getEndpoints = async () => {
     const {
       description,
       functions: collectionFunctions,
-      functionContracts,
+      contracts,
       exposedFunctions = {}
     } = collection;
     if (collectionFunctions) {
@@ -25,22 +25,22 @@ export const getEndpoints = async () => {
         const endpoint = `/${description.$id}/${fnName}`;
         const exposed = exposedFunctions[fnName];
         const roles = Array.isArray(exposed) ? exposed : exposed ? await getAvailableRoles() : [];
-        const contracts = {
+        const endpointContracts = {
           POST: null
         };
         if (roles.length) {
-          contracts.POST ??= {};
-          contracts.POST.roles = roles;
+          endpointContracts.POST ??= {};
+          endpointContracts.POST.roles = roles;
         }
-        if (functionContracts && fnName in functionContracts) {
-          contracts.POST ??= {};
-          Object.assign(contracts.POST, functionContracts[fnName]);
+        if (contracts && fnName in contracts) {
+          endpointContracts.POST ??= {};
+          Object.assign(endpointContracts.POST, contracts[fnName]);
         }
         if (fnName in builtinFunctions) {
-          contracts.POST ??= {};
-          contracts.POST.builtin = true;
+          endpointContracts.POST ??= {};
+          endpointContracts.POST.builtin = true;
         }
-        functions[endpoint] = contracts;
+        functions[endpoint] = endpointContracts;
       }
     }
   }

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

@@ -2,4 +2,4 @@ import type { Context, SchemaWithId, InsertPayload } 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").ACErrors | import("@aeriajs/types").ValidationError> | import("@aeriajs/types").Right<SchemaWithId<TContext["description"]>>>;
+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"]>>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aeriajs/core",
-  "version": "0.0.85",
+  "version": "0.0.87",
   "description": "",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -41,13 +41,13 @@
     "mongodb-memory-server": "^9.2.0"
   },
   "peerDependencies": {
-    "@aeriajs/builtins": "^0.0.85",
-    "@aeriajs/common": "^0.0.51",
-    "@aeriajs/entrypoint": "^0.0.51",
-    "@aeriajs/http": "^0.0.59",
-    "@aeriajs/security": "^0.0.85",
-    "@aeriajs/types": "^0.0.48",
-    "@aeriajs/validation": "^0.0.54"
+    "@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"
   },
   "dependencies": {
     "mongodb": "^6.5.0",