@bool-ts/guard-sdk 1.1.0-beta.8 → 1.1.0-beta.9

package/dist/entities/@validators.d.ts

@@ -0,0 +1,6 @@
+export declare const headersSchema: import("zod/v4").ZodObject<{
+    authorization: import("zod/v4").ZodPipe<import("zod/v4").ZodString, import("zod/v4").ZodTransform<Readonly<{
+        schema: string;
+        token: string;
+    }>, string>>;
+}, import("zod/v4/core").$strip>;

package/dist/entities/guard.d.ts

@@ -0,0 +1,7 @@
+import type { IContext, IGuard, THttpRouteModel } from "@bool-ts/core";
+import type { IClient } from "../interfaces/client.interface";
+export declare class Guard implements IGuard {
+    private readonly clientInstance;
+    constructor(clientInstance: IClient | undefined);
+    enforce(routeModel: THttpRouteModel, requestHeaders: Headers, context: IContext): Promise<boolean>;
+}

package/dist/entities/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./guard";
+export * from "./loader";

package/dist/entities/loader.d.ts

@@ -0,0 +1,8 @@
+import type { TClientCredential, TClientDefinition, TClientOptions } from "../interfaces/client.interface";
+import { Client } from "../instances/client";
+export type TLoaderParameters = {
+    credential: TClientCredential;
+    definition?: TClientDefinition;
+    options?: TClientOptions;
+};
+export declare const loader: ({ credential, definition, options }: TLoaderParameters) => Promise<[symbol, Client]>;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type * from "./interfaces";
+export * from "./constants";
+export * from "./decorators";
+export * from "./entities";
+export * from "./instances";
+export * from "./definers";

package/dist/instances/client.d.ts

@@ -0,0 +1,50 @@
+import type { IClient, TClientCredential, TClientDefinition, TClientOptions } from "../interfaces/client.interface";
+export declare class Client implements IClient {
+    #private;
+    private readonly params;
+    private token;
+    /**
+     * Initialize BoolGuard client instance
+     * @param configs
+     * @param options
+     */
+    constructor(params: Readonly<{
+        credential: TClientCredential;
+        definition?: TClientDefinition;
+        options?: TClientOptions;
+    }>);
+    /**
+     * Sign JWT token with Ed25519 algorithm
+     * @returns
+     */
+    signToken(): Promise<string>;
+    /**
+     * Ping to BoolGuard service to check if the service is reachable
+     * This action should be done before any other actions.
+     * @returns
+     */
+    ping(): Promise<boolean>;
+    /**
+     * Create a new plain account with custom account name
+     * @param args
+     * @returns
+     */
+    createPlainAccount({ identity, password, metadata }: Parameters<IClient["createPlainAccount"]>[number]): ReturnType<IClient["createPlainAccount"]>;
+    /**
+     * Create a new email account, this action will create email record and link to account
+     * with random account alias generated by system.
+     * @param args
+     */
+    createEmailAccount({ identity, password, metadata }: Parameters<IClient["createEmailAccount"]>[number]): ReturnType<IClient["createEmailAccount"]>;
+    /**
+     * Authenticate an account with account name and password
+     * This action will return account info and JWT token if successful
+     * @param param0
+     */
+    authenticate({ identity, password }: Parameters<IClient["authenticate"]>[number]): ReturnType<IClient["authenticate"]>;
+    /**
+     * Authenticate a token and return account info if token is valid
+     * @param param0
+     */
+    verifyToken({ token }: Parameters<IClient["verifyToken"]>[number]): ReturnType<IClient["verifyToken"]>;
+}

package/dist/instances/index.d.ts

@@ -0,0 +1 @@
+export { Client } from "./client";

package/dist/interfaces/account.interface.d.ts

@@ -0,0 +1,6 @@
+export type TDefaultAccountMetadata = Record<string, string | number | Date | null | undefined>;
+export interface IAccount<T = TDefaultAccountMetadata> {
+    uuid: string;
+    status: string;
+    metadata?: T | null;
+}

package/dist/interfaces/accountCredential.interface.d.ts

@@ -0,0 +1,7 @@
+export interface IAccountCredential {
+    uuid: string;
+    identity: string;
+    status: string;
+    type: string;
+    isVerified: boolean;
+}

package/dist/interfaces/base.d.ts

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

package/dist/interfaces/client.interface.d.ts

@@ -0,0 +1,53 @@
+import type { defineResources } from "../definers";
+import type { IAccount, TDefaultAccountMetadata } from "./account.interface";
+import type { IAccountCredential } from "./accountCredential.interface";
+export type TClientCredential = Readonly<{
+    tenantId: string;
+    appId: string;
+    modeId: string;
+    secretKey: string;
+}>;
+export type TClientDefinition = Readonly<{
+    resources: ReturnType<typeof defineResources>["resources"];
+    policies: ReturnType<ReturnType<typeof defineResources>["definePolicies"]>;
+}>;
+export type TClientOptions = Readonly<{
+    version?: 1;
+    logs?: boolean;
+}>;
+export interface IClient<TAccountMetadata extends TDefaultAccountMetadata = TDefaultAccountMetadata> {
+    createPlainAccount(args: {
+        identity: string;
+        password: string;
+        metadata?: TAccountMetadata | null;
+    }): Promise<Readonly<{
+        account: IAccount<TAccountMetadata>;
+        credential: IAccountCredential;
+    }>>;
+    createEmailAccount(args: {
+        identity: string;
+        password: string | null;
+        metadata?: TAccountMetadata | null;
+    }): Promise<Readonly<{
+        account: IAccount<TAccountMetadata>;
+        credential: IAccountCredential;
+    }>>;
+    authenticate(args: {
+        identity: string;
+        password?: string | null;
+    }): Promise<{
+        token: string;
+        account: IAccount<TAccountMetadata>;
+        credential: IAccountCredential;
+    }>;
+    verifyToken(args: {
+        token: string;
+    }): Promise<{
+        account: IAccount<TAccountMetadata>;
+        credential: IAccountCredential;
+    }>;
+}
+export type TAuthState = {
+    account: IAccount;
+    credential: IAccountCredential;
+};

package/dist/interfaces/index.d.ts

@@ -0,0 +1,4 @@
+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";

package/dist/types/actionGuard.d.ts

@@ -0,0 +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"];
+        action: R["actions"][number] | TOptionalTupleUnorderedNonEmpty<R["actions"]>;
+    };
+}[T[number]["type"]];

package/dist/types/controllerGuard.d.ts

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

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./actionGuard";
+export * from "./policies";
+export * from "./resources";

package/dist/types/policies.d.ts

@@ -0,0 +1,11 @@
+import type { TResourceDefinition } from "./resources";
+export type TPolicyDefinition<T extends readonly TResourceDefinition[] = readonly TResourceDefinition[]> = {
+    readonly alias: string;
+    readonly effect: "permit" | "deny";
+    readonly [key: string]: unknown;
+} & {
+    [R in T[number] as R["type"]]: {
+        readonly resource: R["type"];
+        readonly action: R["actions"][number];
+    };
+}[T[number]["type"]];

package/dist/types/resources.d.ts

@@ -0,0 +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 actions: A;
+    readonly [key: string]: unknown;
+};

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

@@ -0,0 +1,7 @@
+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 {};

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

@@ -0,0 +1 @@
+export { deepFreeze } from "./deepFreeze";

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

@@ -0,0 +1 @@
+export type TConstructor<T, K extends any[] = any[]> = new (...args: K) => T;

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

@@ -0,0 +1,8 @@
+type ValuesOfKey<Arr extends any[], K extends keyof any> = Arr extends [
+    infer Head,
+    ...infer Tail
+] ? 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 {};

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

@@ -0,0 +1,3 @@
+export type TError<Message extends string> = {
+    __error__: Message;
+};

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

@@ -0,0 +1 @@
+export type ExtractTuple<T> = T extends readonly [...infer U] ? U : never;

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

@@ -0,0 +1 @@
+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;

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

@@ -0,0 +1,14 @@
+export type { TConstructor } from "./constructor";
+export type { TEnforceUnique } from "./enforceUnique";
+export type { TError } from "./error";
+export type { ExtractTuple } from "./extractTuple";
+export type { TInArray } from "./inArray";
+export type { MergeTuple } from "./mergeTuple";
+export type { TNonEmptyArray } from "./noneEmptyArray";
+export type { TPartialTuple } from "./partialTuple";
+export type { TPartialTupleUnordered as TOptionalTupleUnordered } from "./partialTupleUnordered";
+export type { TOptionalTupleUnorderedNonEmpty } from "./partialTupleUnorderedNonEmpty";
+export type { TPartialTupleNonEmpty } from "./partialTurpleNonEmpty";
+export type { TPermutationTuple } from "./permutationTuple";
+export type { TShuffleTuple } from "./shuffleTuple";
+export type { TStrictPartial } from "./strictPartial";

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

@@ -0,0 +1,3 @@
+export type MergeTuple<T extends readonly any[], U> = {
+    [K in keyof T]: T[K] & U;
+};

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

@@ -0,0 +1 @@
+export type TNonEmptyArray<T> = readonly [T, ...T[]];

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

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

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

@@ -0,0 +1,3 @@
+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;

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

@@ -0,0 +1,3 @@
+import type { TPartialTupleNonEmpty } from "./partialTurpleNonEmpty";
+import type { TPermutationTuple } from "./permutationTuple";
+export type TOptionalTupleUnorderedNonEmpty<T extends readonly any[]> = TPartialTupleNonEmpty<T> extends infer S ? S extends readonly any[] ? TPermutationTuple<S[number]> : never : never;

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

@@ -0,0 +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;

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

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

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

@@ -0,0 +1,5 @@
+type Values<T> = T[keyof T];
+export type TShuffleTuple<U extends string | number> = [U] extends [never] ? [] : Values<{
+    [K in U]: [K, ...TShuffleTuple<Exclude<U, K>>];
+}>;
+export {};

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

@@ -0,0 +1,5 @@
+export type TStrictPartial<T> = {
+    [K in keyof T]?: T[K];
+} & {
+    [K in keyof T as K extends string ? never : never]: never;
+};

package/package.json

@@ -41,10 +41,10 @@
         "url": "git+https://github.com/BoolTS/guard-sdk.git"
     },
     "scripts": {
-        "build": "tsc --emitDeclarationOnly && bun run ./app.build.ts",
+        "build": "bun run ./app.build.ts && tsc --emitDeclarationOnly",
         "format": "prettier \"**/*.ts\" --write",
         "test": "bun --hot run __test/index.ts"
     },
     "types": "./dist/index.d.ts",
-    "version": "1.1.0-beta.8"
+    "version": "1.1.0-beta.9"
 }