@bool-ts/guard-sdk 1.1.0-beta.1 → 1.1.0-beta.10

package/dist/types/actionGuard.d.ts

@@ -1,8 +1,8 @@
 import type { TOptionalTupleUnorderedNonEmpty } from "../ultils/types";
 import type { TResourceDefinition } from "./resources";
 export type TActionGuardOptions<T extends readonly TResourceDefinition[]> = {
-    [R in T[number] as R["type"]]: {
-        resource: R["type"];
+    [R in T[number] as R["alias"]]: {
+        resource: R["alias"];
         action: R["actions"][number] | TOptionalTupleUnorderedNonEmpty<R["actions"]>;
     };
-}[T[number]["type"]];
+}[T[number]["alias"]];

package/dist/types/controllerGuard.d.ts

@@ -1,6 +1,6 @@
 import type { TResourceDefinition } from "./resources";
 export type TControllerGuardOptions<T extends readonly TResourceDefinition[]> = {
-    [R in T[number] as R["type"]]: {
-        resource: R["type"];
+    [R in T[number] as R["alias"]]: {
+        resource: R["alias"];
     };
-}[T[number]["type"]];
+}[T[number]["alias"]];

package/dist/types/policies.d.ts

@@ -4,8 +4,8 @@ export type TPolicyDefinition<T extends readonly TResourceDefinition[] = readonl
     readonly effect: "permit" | "deny";
     readonly [key: string]: unknown;
 } & {
-    [R in T[number] as R["type"]]: {
-        readonly resource: R["type"];
+    [R in T[number] as R["alias"]]: {
+        readonly resource: R["alias"];
         readonly action: R["actions"][number];
     };
-}[T[number]["type"]];
+}[T[number]["alias"]];

package/dist/types/resources.d.ts

@@ -1,6 +1,6 @@
 import type { TNonEmptyArray } from "../ultils/types";
 export type TResourceDefinition<T extends string = string, A extends TNonEmptyArray<string> = TNonEmptyArray<string>> = {
-    readonly type: T;
+    readonly alias: T;
     readonly actions: A;
     readonly [key: string]: unknown;
 };

package/dist/ultils/functions/deepFreeze.d.ts

@@ -1,7 +1,2 @@
-type DeepReadonly<T> = T extends (...args: any[]) => any ? T : T extends readonly any[] ? {
-    readonly [K in keyof T]: DeepReadonly<T[K]>;
-} : T extends object ? {
-    readonly [K in keyof T]: DeepReadonly<T[K]>;
-} : T;
-export declare function deepFreeze<const T>(obj: T): DeepReadonly<T>;
-export {};
+import type { TDeepReadonly } from "../types";
+export declare function deepFreeze<const T>(obj: T): TDeepReadonly<T>;

package/dist/ultils/types/deepReadonly.d.ts

@@ -0,0 +1,5 @@
+export type TDeepReadonly<T> = T extends (...args: any[]) => any ? T : T extends readonly any[] ? {
+    readonly [K in keyof T]: TDeepReadonly<T[K]>;
+} : T extends object ? {
+    readonly [K in keyof T]: TDeepReadonly<T[K]>;
+} : T;

package/dist/ultils/types/enforceUnique.d.ts

@@ -4,5 +4,5 @@ type ValuesOfKey<Arr extends any[], K extends keyof any> = Arr extends [
 ] ? Head extends Record<K, any> ? [Head[K], ...ValuesOfKey<Tail, K>] : ValuesOfKey<Tail, K> : [];
 type Includes<Arr extends any[], V> = Arr extends [infer H, ...infer R] ? [V] extends [H] ? true : Includes<R, V> : false;
 type HasDuplicate<Arr extends readonly any[], K extends keyof any> = Arr extends [infer Head, ...infer Tail] ? Head extends Record<K, any> ? Includes<ValuesOfKey<Tail, K>, Head[K]> extends true ? true : HasDuplicate<Tail, K> : HasDuplicate<Tail, K> : false;
-export type TEnforceUnique<Arr extends readonly any[], K extends keyof Arr[number]> = HasDuplicate<Arr, K> extends true ? ["Duplicate key found"] : Arr;
+export type TEnforceUnique<Arr extends readonly any[], K extends keyof Arr[number]> = HasDuplicate<Arr, K> extends true ? `Duplicate key "${K & string}" found` : Arr;
 export {};

package/dist/ultils/types/index.d.ts

@@ -1,4 +1,5 @@
 export type { TConstructor } from "./constructor";
+export type { TDeepReadonly } from "./deepReadonly";
 export type { TEnforceUnique } from "./enforceUnique";
 export type { TError } from "./error";
 export type { ExtractTuple } from "./extractTuple";

package/dist/ultils/types/partialTuple.d.ts

@@ -1 +1,4 @@
-export type TPartialTuple<T extends readonly any[]> = T extends readonly [infer Head, ...infer Tail] ? TPartialTuple<Tail> | [Head, ...TPartialTuple<Tail>] : [];
+export type TPartialTuple<T extends readonly any[]> = T extends readonly [
+    infer Head,
+    ...infer Tail
+] ? TPartialTuple<Tail> | [Head, ...TPartialTuple<Tail>] : [];

package/dist/ultils/types/partialTurpleNonEmpty.d.ts

@@ -1,5 +1,2 @@
 import type { TPartialTuple } from "./partialTuple";
-export type TPartialTupleNonEmpty<T extends readonly any[]> = T extends readonly [
-    infer Head,
-    ...infer Tail
-] ? [Head, ...TPartialTuple<Tail>] | TPartialTupleNonEmpty<Tail> : never;
+export type TPartialTupleNonEmpty<T extends readonly any[]> = T extends readonly [infer Head, ...infer Tail] ? [Head, ...TPartialTuple<Tail>] | TPartialTupleNonEmpty<Tail> : never;

package/package.json

@@ -4,11 +4,14 @@
         "url": "https://github.com/BoolTS/guard-sdk/issues"
     },
     "dependencies": {
-        "jose": "^6.1.0",
-        "zod": "^4.1.12"
+        "jose": "^6.2.1",
+        "reflect-metadata": "^0.2.2",
+        "zod": "^4.3.6"
     },
     "devDependencies": {
+        "@bool-ts/core": "^2.3.3",
         "@types/bun": "latest",
+        "prettier": "^3.8.1",
         "typescript": "^5.9.3"
     },
     "files": [
@@ -29,10 +32,6 @@
     "license": "MIT",
     "main": "./dist/index.js",
     "name": "@bool-ts/guard-sdk",
-    "peerDependencies": {
-        "@bool-ts/core": "^2.0.4",
-        "reflect-metadata": "^0.2.2"
-    },
     "private": false,
     "publishConfig": {
         "access": "public"
@@ -42,9 +41,10 @@
         "url": "git+https://github.com/BoolTS/guard-sdk.git"
     },
     "scripts": {
-        "build": "tsc --emitDeclarationOnly && bun run app.build.ts",
+        "build": "tsc --emitDeclarationOnly && bun run ./app.build.ts",
+        "format": "prettier \"**/*.ts\" --write",
         "test": "bun --hot run __test/index.ts"
     },
     "types": "./dist/index.d.ts",
-    "version": "1.1.0-beta.1"
+    "version": "1.1.0-beta.10"
 }

package/src/decorators/actionGuard.decorator.ts

@@ -5,7 +5,8 @@ import { Keys } from "../constants";
 
 export const ActionGuard =
     <
-        const T extends readonly TResourceDefinition[] = readonly TResourceDefinition[],
+        const T extends readonly TResourceDefinition[] =
+            readonly TResourceDefinition[],
         K extends TConstructor<Object> | Object = Object
     >(
         options?: TActionGuardOptions<T>

package/src/decorators/index.ts

@@ -1 +1,3 @@
+export { ActionGuard } from "./actionGuard.decorator";
 export { AuthState } from "./authState.decorator";
+export { ControllerGuard } from "./controllerGuard.decorator";

package/src/definers/policies.ts

@@ -7,6 +7,7 @@ export const definePolicies = <const K extends readonly TPolicyDefinition[]>(
     policies: TEnforceUnique<K, "alias">
 ) => {
     if (
+        policies === `Duplicate key "alias" found` ||
         new Set([
             ...policies
                 .map((policy) =>

package/src/definers/resources.ts

@@ -1,29 +1,58 @@
 import type { TPolicyDefinition, TResourceDefinition } from "../types";
-import type { TEnforceUnique } from "../ultils/types";
+import type { TDeepReadonly, TEnforceUnique } from "../ultils/types";
 
 import { deepFreeze } from "../ultils/functions";
 
-export const defineResources = <const T extends readonly TResourceDefinition[]>(
-    resources: TEnforceUnique<T, "type">
+export const defineResources = <
+    const T extends readonly TResourceDefinition[],
+    D extends TDeepReadonly<T>
+>(
+    resources: TEnforceUnique<T, "alias">
 ) => {
     if (
+        resources === `Duplicate key "alias" found` ||
         new Set([
             ...resources
                 .map((resource) =>
-                    typeof resource === "string" ? undefined : resource.type
+                    typeof resource === "string" ? undefined : resource.alias
                 )
                 .filter((resourceType) => typeof resourceType !== "undefined")
         ]).size !== resources.length
     ) {
-        throw new Error("Duplicated resource type.");
+        throw new Error("Duplicated resource alias.");
+    }
+
+    const resourceFreezed = deepFreeze(resources);
+
+    if (resourceFreezed === `Duplicate key "alias" found`) {
+        throw new Error("Duplicated resource alias.");
     }
 
     return Object.freeze({
-        resources: deepFreeze(resources),
+        getResource: <
+            K extends D extends never ? never : D[number]["alias"],
+            R extends D extends never ? never : Extract<D[number], { alias: K }>
+        >(
+            alias: K
+        ): R => {
+            const index = resourceFreezed.findIndex(
+                ({ alias: resourceAlias }) => alias === resourceAlias
+            );
+
+            if (index === -1) {
+                throw new Error(
+                    "Resource not found, intialize resources error."
+                );
+            }
+
+            return resourceFreezed[index] as R;
+        },
+        resources: resourceFreezed,
         definePolicies: <const K extends readonly TPolicyDefinition<T>[]>(
             policies: TEnforceUnique<K, "alias">
         ) => {
             if (
+                policies === `Duplicate key "alias" found` ||
                 new Set([
                     ...policies
                         .map((policy) =>

package/src/entities/@validators.ts

@@ -0,0 +1,22 @@
+import { jwt, NEVER, object, string } from "zod/v4";
+
+export const headersSchema = object({
+    authorization: string()
+        .startsWith("Bearer ")
+        .transform((value, ctx) => {
+            const [schema, token] = value.split(" ");
+
+            const jwtValidation = jwt().safeParse(token);
+
+            if (!jwtValidation.success) {
+                ctx.addIssue("Token must be match jsonwebtoken format.");
+
+                return NEVER;
+            }
+
+            return Object.freeze({
+                schema,
+                token
+            });
+        })
+});

package/src/entities/guard.ts

@@ -0,0 +1,81 @@
+import type { IContext, IGuard, THttpRouteModel } from "@bool-ts/core";
+import type { IClient, TAuthState } from "../interfaces/client.interface";
+
+import {
+    Guard as BoolTsGuard,
+    Context,
+    Inject,
+    RequestHeaders,
+    RouteModel
+} from "@bool-ts/core";
+import { Keys } from "../constants";
+import { headersSchema } from "./@validators";
+
+@BoolTsGuard()
+export class Guard implements IGuard {
+    constructor(
+        @Inject(Keys.guardClient)
+        private readonly clientInstance: IClient | undefined
+    ) {}
+
+    async enforce(
+        @RouteModel()
+        routeModel: THttpRouteModel,
+        @RequestHeaders()
+        requestHeaders: Headers,
+        @Context()
+        context: IContext
+    ) {
+        if (!this.clientInstance) {
+            throw new Error("Bool guard instance not found.");
+        }
+
+        const actionMetadataKeys = Reflect.getOwnMetadataKeys(
+            routeModel.class,
+            routeModel.funcName
+        );
+
+        const controllerMetadataKeys = Reflect.getOwnMetadataKeys(
+            routeModel.class
+        );
+
+        const isAuthAction = actionMetadataKeys.includes(Keys.guardMetadata);
+        const isAuthController = controllerMetadataKeys.includes(
+            Keys.guardMetadata
+        );
+
+        if (!isAuthAction && !isAuthController) {
+            return true;
+        }
+
+        const headersValidation = await headersSchema.safeParseAsync(
+            requestHeaders.toJSON()
+        );
+
+        if (!headersValidation.success) {
+            return false;
+        }
+
+        try {
+            const {
+                authorization: { token }
+            } = headersValidation.data;
+
+            const { account, credential } =
+                await this.clientInstance.verifyToken({
+                    token: token
+                });
+
+            const authState: TAuthState = Object.freeze({
+                account: account,
+                credential: credential
+            });
+
+            context.set(Keys.authState, authState);
+
+            return true;
+        } catch {
+            return false;
+        }
+    }
+}

package/src/entities/index.ts

@@ -1,3 +1,2 @@
-export * from "./interceptor";
+export * from "./guard";
 export * from "./loader";
-export * from "./middleware";

package/src/entities/loader.ts

@@ -17,7 +17,7 @@ export const loader = async ({
     credential,
     definition,
     options
-}: TLoaderParameters) => {
+}: TLoaderParameters): Promise<[symbol, Client]> => {
     const boolGuardClient = new Client({ credential, definition, options });
 
     await boolGuardClient.signToken();

package/src/index.ts

@@ -4,3 +4,4 @@ export * from "./constants";
 export * from "./decorators";
 export * from "./entities";
 export * from "./instances";
+export * from "./definers";

package/src/interfaces/account.interface.ts

@@ -1,4 +1,7 @@
-export type TDefaultAccountMetadata = Record<string, string | number | Date | null | undefined>;
+export type TDefaultAccountMetadata = Record<
+    string,
+    string | number | Date | null | undefined
+>;
 
 export interface IAccount<T = TDefaultAccountMetadata> {
     uuid: string;

package/src/interfaces/base.ts

@@ -1,3 +1,7 @@
 export type TApiResponse<T> = Readonly<{
-    data: Awaited<ReturnType<T extends (...args: any) => Promise<infer R> ? () => R : never>>;
+    data: Awaited<
+        ReturnType<
+            T extends (...args: any) => Promise<infer R> ? () => R : never
+        >
+    >;
 }>;

package/src/interfaces/client.interface.ts

@@ -50,9 +50,7 @@ export interface IClient<
         account: IAccount<TAccountMetadata>;
         credential: IAccountCredential;
     }>;
-    verifyToken(args: {
-        token: string;
-    }): Promise<{
+    verifyToken(args: { token: string }): Promise<{
         account: IAccount<TAccountMetadata>;
         credential: IAccountCredential;
     }>;

package/src/interfaces/index.ts

@@ -1,5 +1,9 @@
 export type { IAccount } from "./account.interface";
 export type { IAccountCredential } from "./accountCredential.interface";
 export type { TApiResponse } from "./base";
-export type { IClient, TAuthState, TClientCredential as TClientConfigs, TClientOptions } from "./client.interface";
-
+export type {
+    IClient,
+    TAuthState,
+    TClientCredential as TClientConfigs,
+    TClientOptions
+} from "./client.interface";

package/src/types/actionGuard.ts

@@ -2,10 +2,10 @@ import type { TOptionalTupleUnorderedNonEmpty } from "../ultils/types";
 import type { TResourceDefinition } from "./resources";
 
 export type TActionGuardOptions<T extends readonly TResourceDefinition[]> = {
-    [R in T[number] as R["type"]]: {
-        resource: R["type"];
+    [R in T[number] as R["alias"]]: {
+        resource: R["alias"];
         action:
             | R["actions"][number]
             | TOptionalTupleUnorderedNonEmpty<R["actions"]>;
     };
-}[T[number]["type"]];
+}[T[number]["alias"]];

package/src/types/controllerGuard.ts

@@ -2,7 +2,7 @@ import type { TResourceDefinition } from "./resources";
 
 export type TControllerGuardOptions<T extends readonly TResourceDefinition[]> =
     {
-        [R in T[number] as R["type"]]: {
-            resource: R["type"];
+        [R in T[number] as R["alias"]]: {
+            resource: R["alias"];
         };
-    }[T[number]["type"]];
+    }[T[number]["alias"]];

package/src/types/policies.ts

@@ -7,11 +7,11 @@ export type TPolicyDefinition<
     readonly effect: "permit" | "deny";
     readonly [key: string]: unknown;
 } & {
-    [R in T[number] as R["type"]]: {
-        readonly resource: R["type"];
+    [R in T[number] as R["alias"]]: {
+        readonly resource: R["alias"];
         readonly action: R["actions"][number];
     };
-}[T[number]["type"]];
+}[T[number]["alias"]];
 
 // export type TPolicyAttributes<
 //     T extends readonly TResourceDefinition[],

package/src/types/resources.ts

@@ -4,7 +4,7 @@ export type TResourceDefinition<
     T extends string = string,
     A extends TNonEmptyArray<string> = TNonEmptyArray<string>
 > = {
-    readonly type: T;
+    readonly alias: T;
     readonly actions: A;
     readonly [key: string]: unknown;
 };

package/src/ultils/functions/deepFreeze.ts

@@ -1,12 +1,6 @@
-type DeepReadonly<T> = T extends (...args: any[]) => any
-    ? T
-    : T extends readonly any[]
-    ? { readonly [K in keyof T]: DeepReadonly<T[K]> }
-    : T extends object
-    ? { readonly [K in keyof T]: DeepReadonly<T[K]> }
-    : T;
+import type { TDeepReadonly } from "../types";
 
-export function deepFreeze<const T>(obj: T): DeepReadonly<T> {
+export function deepFreeze<const T>(obj: T): TDeepReadonly<T> {
     if (typeof obj !== "object" || obj === null) return obj as any;
     Object.freeze(obj);
     for (const key of Object.keys(obj)) {

package/src/ultils/types/deepReadonly.ts

@@ -0,0 +1,7 @@
+export type TDeepReadonly<T> = T extends (...args: any[]) => any
+    ? T
+    : T extends readonly any[]
+      ? { readonly [K in keyof T]: TDeepReadonly<T[K]> }
+      : T extends object
+        ? { readonly [K in keyof T]: TDeepReadonly<T[K]> }
+        : T;

package/src/ultils/types/enforceUnique.ts

@@ -27,4 +27,7 @@ type HasDuplicate<
 export type TEnforceUnique<
     Arr extends readonly any[],
     K extends keyof Arr[number]
-> = HasDuplicate<Arr, K> extends true ? ["Duplicate key found"] : Arr;
+> =
+    HasDuplicate<Arr, K> extends true
+        ? `Duplicate key "${K & string}" found`
+        : Arr;

package/src/ultils/types/inArray.ts

@@ -1,7 +1,7 @@
 export type TInArray<T, X> = T extends readonly [X, ...infer _Rest]
     ? true
     : T extends readonly [X]
-    ? true
-    : T extends readonly [infer _, ...infer Rest]
-    ? TInArray<Rest, X>
-    : false;
+      ? true
+      : T extends readonly [infer _, ...infer Rest]
+        ? TInArray<Rest, X>
+        : false;

package/src/ultils/types/index.ts

@@ -1,4 +1,5 @@
 export type { TConstructor } from "./constructor";
+export type { TDeepReadonly } from "./deepReadonly";
 export type { TEnforceUnique } from "./enforceUnique";
 export type { TError } from "./error";
 export type { ExtractTuple } from "./extractTuple";

package/src/ultils/types/partialTuple.ts

@@ -1,3 +1,6 @@
-export type TPartialTuple<T extends readonly any[]> = T extends readonly [infer Head, ...infer Tail]
+export type TPartialTuple<T extends readonly any[]> = T extends readonly [
+    infer Head,
+    ...infer Tail
+]
     ? TPartialTuple<Tail> | [Head, ...TPartialTuple<Tail>]
     : [];

package/src/ultils/types/partialTupleUnordered.ts

@@ -1,8 +1,9 @@
 import type { TPartialTuple } from "./partialTuple";
 import type { TPermutationTuple } from "./permutationTuple";
 
-export type TPartialTupleUnordered<T extends readonly any[]> = TPartialTuple<T> extends infer S
-    ? S extends readonly any[]
-        ? TPermutationTuple<S[number]>
-        : never
-    : never;
+export type TPartialTupleUnordered<T extends readonly any[]> =
+    TPartialTuple<T> extends infer S
+        ? S extends readonly any[]
+            ? TPermutationTuple<S[number]>
+            : never
+        : never;

package/src/ultils/types/partialTurpleNonEmpty.ts

@@ -1,8 +1,6 @@
 import type { TPartialTuple } from "./partialTuple";
 
-export type TPartialTupleNonEmpty<T extends readonly any[]> = T extends readonly [
-    infer Head,
-    ...infer Tail
-]
-    ? [Head, ...TPartialTuple<Tail>] | TPartialTupleNonEmpty<Tail>
-    : never;
+export type TPartialTupleNonEmpty<T extends readonly any[]> =
+    T extends readonly [infer Head, ...infer Tail]
+        ? [Head, ...TPartialTuple<Tail>] | TPartialTupleNonEmpty<Tail>
+        : never;

package/src/ultils/types/permutationTuple.ts

@@ -1,5 +1,5 @@
 export type TPermutationTuple<T, K = T> = [T] extends [never]
     ? []
     : T extends any
-    ? [T, ...TPermutationTuple<Exclude<K, T>>]
-    : never;
+      ? [T, ...TPermutationTuple<Exclude<K, T>>]
+      : never;

package/dist/entities/interceptor.d.ts

@@ -1,5 +0,0 @@
-import type { IInterceptor, THttpRouteModel } from "@bool-ts/core";
-import type { TAuthState } from "../interfaces/client.interface";
-export declare class Interceptor implements IInterceptor {
-    open(routeModel: THttpRouteModel, authState: TAuthState): void;
-}

package/dist/entities/middleware.d.ts

@@ -1,19 +0,0 @@
-import type { IContext, IMiddleware } from "@bool-ts/core";
-import type { IClient } from "../interfaces/client.interface";
-/**
- * Bool guard middleware for Bool Typescript framework
- */
-export declare class Middleware implements IMiddleware {
-    private readonly clientInstance;
-    /**
-     *
-     * @param tenantAppModesService
-     */
-    constructor(clientInstance: IClient);
-    /**
-     *
-     * @param context
-     * @param requestHeaders
-     */
-    start(context: IContext, requestHeaders: Headers): Promise<ThisType<IContext>>;
-}

package/src/entities/interceptor.ts

@@ -1,47 +0,0 @@
-import type { IInterceptor, THttpRouteModel } from "@bool-ts/core";
-import type { TAuthState } from "../interfaces/client.interface";
-
-import { Interceptor as BoolInterceptor, HttpClientError, RouteModel } from "@bool-ts/core";
-import { Keys } from "../constants";
-import { AuthState } from "../decorators/authState.decorator";
-
-@BoolInterceptor()
-export class Interceptor implements IInterceptor {
-    open(
-        @RouteModel()
-        routeModel: THttpRouteModel,
-        @AuthState()
-        authState: TAuthState
-    ) {
-        const actionMetadataKeys = Reflect.getOwnMetadataKeys(
-            routeModel.class.prototype,
-            routeModel.funcName
-        );
-
-        if (actionMetadataKeys.includes(Keys.authState)) {
-            if (!authState) {
-                throw new HttpClientError({
-                    httpCode: 401,
-                    message: "Unauthorized",
-                    data: undefined
-                });
-            }
-
-            return;
-        }
-
-        const controllerMetadataKeys = Reflect.getOwnMetadataKeys(routeModel.class);
-
-        if (controllerMetadataKeys.includes(Keys.authState)) {
-            if (!authState) {
-                throw new HttpClientError({
-                    httpCode: 401,
-                    message: "Unauthorized",
-                    data: undefined
-                });
-            }
-
-            return;
-        }
-    }
-}