@schorts/shared-kernel 4.2.1 → 4.2.3

package/src/json-api/json-api-connector.ts

@@ -1,97 +0,0 @@
-import { HTTPProvider, HTTPException } from "../http";
-import type { JSONAPIList } from "./json-api-list";
-import type { JSONAPISingle } from "./json-api-single";
-import { URLCriteriaBuilder } from "./url-criteria-builder";
-import { Criteria } from "../criteria";
-import { JSONAPIErrors } from "./exceptions";
-
-export class JSONAPIConnector {
-  constructor(private http: HTTPProvider) {}
-
-  async findOne<EntityAttributes>(
-    url: URL,
-    criteria?: Criteria,
-    include?: string[]
-  ): Promise<JSONAPISingle<EntityAttributes>> {
-    try {
-      const fullUrl = new URLCriteriaBuilder(url, criteria, include).build();
-
-      return await this.http.get(fullUrl);
-    } catch(error) {
-      this.handleError(error);
-    }
-  }
-
-  async findMany<EntityAttributes>(
-    url: URL,
-    criteria?: Criteria,
-    include?: string[]
-  ): Promise<JSONAPIList<EntityAttributes>> {
-    try {
-      const fullUrl = new URLCriteriaBuilder(url, criteria, include).build();
-
-      return await this.http.get(fullUrl);
-    } catch(error) {
-      this.handleError(error);
-    }
-  }
-
-  async create<EntityAttributes>(
-    url: URL,
-    payload: {
-      id: string;
-      type: string;
-      attributes: Omit<Partial<EntityAttributes>, "id">;
-    } | Array<{
-      id: string;
-      type: string;
-      attributes: Omit<Partial<EntityAttributes>, "id">;
-    }>,
-    meta?: Record<string, any>,
-  ): Promise<JSONAPISingle<EntityAttributes>> {
-    try {
-      const body: Record<string, any> = { data: payload };
-
-      if (meta) {
-        body["meta"] = meta;
-      }
-
-      return await this.http.post(url, body);
-    } catch(error) {
-      this.handleError(error);
-    }
-  }
-
-  async update<EntityAttributes>(
-    url: URL,
-    payload: {
-      id: string;
-      type: string;
-      attributes: Omit<Partial<EntityAttributes>, "id">;
-    }
-  ): Promise<JSONAPISingle<EntityAttributes>> {
-    try {
-      return await this.http.patch(url, { data: payload });
-    } catch(error) {
-      this.handleError(error);
-    }
-  }
-
-  async delete<EntityAttributes>(
-    url: URL
-  ): Promise<JSONAPISingle<EntityAttributes>> {
-    try {
-      return await this.http.delete(url);
-    } catch(error) {
-      this.handleError(error);
-    }
-  }
-
-  private handleError(error: unknown): never {
-    if (error instanceof HTTPException && error.body?.errors) {
-      throw new JSONAPIErrors(error.body.errors);
-    }
-
-    throw error;
-  }
-}

package/src/json-api/json-api-list.ts

@@ -1,13 +0,0 @@
-export type JSONAPIList<EntityAttributes> = {
-  data: Array<{
-    id: string;
-    type: string;
-    attributes: Omit<EntityAttributes, "id">;
-  }>;
-  included?: Array<{
-    id: string;
-    type: string;
-    attributes: Record<string, any>;
-  }>;
-  meta?: Record<string, any>;
-};

package/src/json-api/json-api-single.ts

@@ -1,13 +0,0 @@
-export type JSONAPISingle<EntityAttributes> = {
-  data: {
-    id: string;
-    type: string;
-    attributes: Omit<EntityAttributes, "id">;
-  };
-  included?: Array<{
-    id: string;
-    type: string;
-    attributes: Record<string, any>;
-  }>;
-  meta?: Record<string, any>;
-};

package/src/json-api/url-criteria-builder.ts

@@ -1,49 +0,0 @@
-import { URLWithParamsBuilder } from "../utils";
-import { Criteria } from "../criteria";
-
-export class URLCriteriaBuilder {
-  constructor(
-    private readonly base: URL,
-    private readonly criteria?: Criteria,
-    private readonly include?: string[]
-  ) {}
-
-  build(): URL {
-    const builder = new URLWithParamsBuilder(new URL(this.base.href));
-
-    if (this.include?.length) {
-      builder.with({ include: this.include });
-    }
-
-    if (this.criteria) {
-      Object.entries(this.criteria.filters).forEach(([field, { operator, value }]) => {
-        const encodedField = field.replace(/\./g, "."); // allows nested filters like roles.name
-
-        if (operator === "EQUAL") {
-          builder.with({ [`filter[${encodedField}]`]: value });
-        } else if (operator === "IN" && Array.isArray(value)) {
-          builder.with({ [`filter[${encodedField}]`]: value.join(",") });
-        } else {
-          builder.with({ [`filter[${encodedField}][${operator}]`]: value });
-        }
-      });
-
-      if (this.criteria.orders.length > 0) {
-        const sortParam = this.criteria.orders
-          .map(({ field, direction }) => (direction === "DESC" ? `-${field}` : field))
-          .join(",");
-        builder.with({ sort: sortParam });
-      }
-
-      if (this.criteria.limit !== undefined) {
-        builder.with({ "page[limit]": this.criteria.limit });
-      }
-
-      if (this.criteria.offset !== undefined) {
-        builder.with({ "page[offset]": this.criteria.offset });
-      }
-    }
-
-    return builder.build();
-  }
-}

package/src/messages/index.ts

@@ -1 +0,0 @@
-export type { Message } from "./message";

package/src/messages/message.ts

@@ -1,3 +0,0 @@
-export interface Message<Primitives = {}> {
-  toPrimitives(): Primitives;
-}

package/src/models/base-model.ts

@@ -1,3 +0,0 @@
-export type BaseModel = {
-  id: string | number;
-} & Record<string, any>;

package/src/models/index.ts

@@ -1 +0,0 @@
-export type { BaseModel } from "./base-model";

package/src/pub-sub/index.ts

@@ -1,2 +0,0 @@
-export type { Publisher } from "./publisher";
-export type { Subscription } from "./subscription";

package/src/pub-sub/publisher.ts

@@ -1,3 +0,0 @@
-export interface Publisher {
-  publish(channel: string, event: string, payload: any): Promise<void>;
-}

package/src/pub-sub/subscription.ts

@@ -1,6 +0,0 @@
-export interface Subscription {
-  connect(): void;
-  subscribe(channel: string, event: string, handler: (payload: any) => void): void;
-  unsubscribe(channel: string): void;
-  disconnect(): void;
-}

package/src/rbac/base-resource.ts

@@ -1,3 +0,0 @@
-export type BaseResource = {
-  name: string;
-};

package/src/rbac/exceptions/index.ts

@@ -1 +0,0 @@
-export { NotAuthorized } from "./not-authorized";

package/src/rbac/exceptions/not-authorized.ts

@@ -1 +0,0 @@
-export class NotAuthorized extends Error {}

package/src/rbac/index.ts

@@ -1,5 +0,0 @@
-export type { Permission } from "./permission";
-export type { BaseResource } from "./base-resource";
-
-export { RBACPolicy } from "./rbac-policy"; 
-export * from "./exceptions";

package/src/rbac/permission.ts

@@ -1,4 +0,0 @@
-export type Permission = {
-  resource: string;
-  action: "read" | "write" | "delete" | "manage";
-}

package/src/rbac/rbac-policy.ts

@@ -1,41 +0,0 @@
-import { Permission } from './permission';
-import { BaseResource } from './base-resource';
-import { Predicate } from '../abac';
-
-export abstract class RBACPolicy {
-  abstract getPermissions(role: string): Permission[];
-
-  can(role: string, action: Permission['action'], resource: BaseResource): boolean {
-    const permissions = this.getPermissions(role);
-
-    return permissions.some(
-      (perm) =>
-        (perm.resource === '*' || perm.resource === resource.name) &&
-        (perm.action === action || perm.action === 'manage')
-    );
-  }
-
-  canWithAttributes<User extends  { id: string }, Resource extends BaseResource>(
-    user: User,
-    role: string,
-    action: Permission['action'],
-    resource: Resource,
-    predicates: Predicate<User, Resource>[],
-  ): boolean {
-    if (!this.can(role, action, resource)) return false;
-
-    return predicates.every((predicate) => predicate(user, resource));
-  }
-
-  canAnyWithAttributes<User extends { id: string }, Resource extends BaseResource>(
-    user: User,
-    role: string,
-    action: Permission['action'],
-    resource: Resource,
-    predicates: Predicate<User, Resource>[]
-  ): boolean {
-    if (!this.can(role, action, resource)) return false;
-
-    return predicates.some((predicate) => predicate(user, resource));
-  }
-}

package/src/result/index.ts

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

package/src/result/result.ts

@@ -1,35 +0,0 @@
-export class Result<Type> {
-  private readonly success: boolean;
-  private readonly value: Type | undefined;
-  private readonly error: Error | undefined;
-
-  private constructor(success: boolean, value?: Type, error?: Error) {
-    this.success = success;
-    this.value = value;
-    this.error = error;
-  }
-
-  static success<Type>(value: Type): Result<Type> {
-    return new Result<Type>(true, value);
-  }
-
-  static error<Type>(error: Error): Result<Type> {
-    return new Result<Type>(false, undefined, error);
-  }
-
-  isSuccess(): boolean {
-    return this.success;
-  }
-  
-  isFailure(): boolean {
-    return !this.isSuccess();
-  }
-
-  getValue(): Type | undefined {
-    return this.value;
-  }
-
-  getError(): Error | undefined {
-    return this.error;
-  }
-}

package/src/state-manager/in-memory-state-manager.ts

@@ -1,22 +0,0 @@
-import { StateManager } from './state-manager';
-
-export class InMemoryStateManager<Schema extends Record<string, any>> extends StateManager<Schema> {
-  constructor(initialState: Schema = {} as Schema) {
-    super(initialState);
-  }
-
-  async getValue<Key extends keyof Schema>(key: Key): Promise<Schema[Key]> {
-    return this.state[key];
-  }
-
-  async setValue<Key extends keyof Schema>(key: Key, value: Schema[Key]): Promise<void> {
-    this.state[key] = value;
-
-    this.notifyListeners();
-  }
-
-  async removeValue<Key extends keyof Schema>(key: Key): Promise<void> {
-    delete this.state[key];
-    this.notifyListeners();
-  }
-}

package/src/state-manager/index.ts

@@ -1,3 +0,0 @@
-export { StateManager } from "./state-manager";
-export { SessionStorageStateManager } from "./session-storage-state-manager";
-export { InMemoryStateManager } from "./in-memory-state-manager";

package/src/state-manager/session-storage-state-manager.ts

@@ -1,47 +0,0 @@
-import { StateManager } from './state-manager';
-
-export class SessionStorageStateManager<Schema extends Record<string, any>> extends StateManager<Schema> {
-  constructor(initialState: Schema) {
-    super(initialState); 
-    this.loadPersistedState();
-  }
-
-  private loadPersistedState(): void {
-    const keys = Object.keys(this.state) as Array<keyof Schema>;
-
-    for (const key of keys) {
-      const storageKey = String(key); 
-      const persistedValue = sessionStorage.getItem(storageKey);
-      this.state[key] = JSON.parse(persistedValue || "null");
-    }
-  }
-
-  private persistValue<Key extends keyof Schema>(key: Key, value: Schema[Key]): void {
-    const storageKey = String(key); 
-
-    sessionStorage.setItem(storageKey, JSON.stringify(value));
-  }
-
-  public async getValue<Key extends keyof Schema>(key: Key): Promise<Schema[Key]> {
-    return this.state[key];
-  }
-
-  public async setValue<Key extends keyof Schema>(key: Key, value: Schema[Key]): Promise<void> {
-    this.state = {
-      ...this.state,
-      [key]: value
-    };
-
-    this.persistValue(key, value);
-    this.notifyListeners();
-  }
-
-  public async removeValue<Key extends keyof Schema>(key: Key): Promise<void> {
-    const storageKey = String(key);
-    const { [key]: _, ...newState } = this.state;
-    this.state = newState as Schema;
-
-    sessionStorage.removeItem(storageKey);
-    this.notifyListeners();
-  }
-}

package/src/state-manager/state-manager.ts

@@ -1,28 +0,0 @@
-export abstract class StateManager<Schema extends Record<string, any>> {
-  protected state: Schema;
-  private listeners: Array<(state: Schema) => void> = [];
-
-  constructor(initialState: Schema = {} as Schema) {
-    this.state = initialState;
-  }
-
-  abstract getValue<Key extends keyof Schema>(key: Key): Promise<Schema[Key]>;
-  abstract setValue<Key extends keyof Schema>(key: Key, value: Schema[Key]): Promise<void>;
-  abstract removeValue<Key extends keyof Schema>(key: Key): Promise<void>;
-
-  getState(): Schema {
-    return this.state;
-  }
-
-  subscribe(listener: (state: Schema) => void): () => void {
-    this.listeners.push(listener);
-
-    return () => {
-      this.listeners = this.listeners.filter(l => l !== listener);
-    };
-  }
-
-  protected notifyListeners(): void {
-    this.listeners.forEach(listener => listener(this.state));
-  }
-}

package/src/telemetry/console-telemetry.ts

@@ -1,27 +0,0 @@
-import { Telemetry } from "./telemetry";
-
-export class ConsoleTelemetry implements Telemetry {
-  private readonly customContext: Record<string, string> = {};
-  private transaction: string | null = null;
-
-  init(): void {
-    console.log("Telemetry initialized");
-  }
-
-  trackError(error: Error): void {
-    console.error({
-      error,
-      timestamp: new Date(),
-      customContext: this.customContext,
-      transaction: this.transaction,
-    });
-  }
-
-  setCustomContext(key: string, value: string): void {
-    this.customContext[key] = value;
-  }
-
-  setTransaction(name: string): void {
-    this.transaction = name;
-  }
-}

package/src/telemetry/index.ts

@@ -1,2 +0,0 @@
-export type { Telemetry } from "./telemetry";
-export { ConsoleTelemetry } from "./console-telemetry";

package/src/telemetry/telemetry.ts

@@ -1,5 +0,0 @@
-export interface Telemetry {
-  trackError(error: Error): void;
-  setCustomContext(key: string, value: string): void;
-  setTransaction(name: string): void;
-}

package/src/unit-of-work/index.ts

@@ -1 +0,0 @@
-export type { UnitOfWork } from "./unit-of-work";

package/src/unit-of-work/unit-of-work.ts

@@ -1,5 +0,0 @@
-export interface UnitOfWork {
-  begin(): Promise<void>;
-  commit(): Promise<void>;
-  rollback(): Promise<void>;
-}

package/src/utils/index.ts

@@ -1,2 +0,0 @@
-export * from "./url";
-export * from "./value-objects";

package/src/utils/url/index.ts

@@ -1 +0,0 @@
-export { URLWithParamsBuilder } from "./url-with-params-builder";

package/src/utils/url/url-with-params-builder.ts

@@ -1,19 +0,0 @@
-export class URLWithParamsBuilder {
-  constructor(private readonly base: URL) {}
-
-  with(params: Record<string, string | number | boolean | Array<string | number>>): URLWithParamsBuilder {
-    Object.entries(params).forEach(([key, value]) => {
-      if (Array.isArray(value)) {
-        value.forEach(v => this.base.searchParams.append(key, String(v)));
-      } else {
-        this.base.searchParams.set(key, String(value));
-      }
-    });
-
-    return this;
-  }
-
-  build(): URL {
-    return this.base;
-  }
-}

package/src/utils/value-objects/index.ts

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

package/src/utils/value-objects/rule.ts

@@ -1,3 +0,0 @@
-import { ValidationRule } from "../../value-objects/array-value";
-
-export const rule = <Type extends ValidationRule<any>>(r: Type): Type => r;

package/src/value-objects/array-value.ts

@@ -1,92 +0,0 @@
-import { ValueObject } from "./value-object";
-
-type Primitive = string | number | boolean | null | undefined;
-
-export type ValidationRule<Type> =
-  | { required: true }
-  | { greater_than: number }
-  | { greater_than_or_equal: number }
-  | { less_than: number }
-  | { less_than_or_equal: number }
-  | { type: "string" | "number" | "boolean" }
-  | { custom: (value: Type) => boolean };
-
-type ObjectSchema<Type> = {
-  [Key in keyof Type]?: Type[Key] extends Primitive
-    ? ValidationRule<Type[Key]>[]
-    : ObjectSchema<Type[Key]>;
-};
-
-export abstract class ArrayValue<Type = any> implements ValueObject {
-  readonly valueType = "Array";
-  readonly value: Type[];
-  readonly schema: ObjectSchema<Type> | ValidationRule<Type>[];
-  abstract readonly attributeName: string;
-  abstract readonly isPrimitive: boolean;
-
-  constructor(
-    value: Type[],
-    schema: ObjectSchema<Type> | ValidationRule<Type>[],
-  ) {
-    this.value = this.deepFreeze(value);
-    this.schema = schema;
-  }
-
-  get isValid(): boolean {
-    return this.value.every((item) => {
-      return this.isPrimitive
-        ? (this.schema as ValidationRule<Type>[]).every(rule => this.validateRule(item, rule))
-        : this.validateObject(item, this.schema as ObjectSchema<Type>);
-    });
-  }
-
-  private validateObject(obj: any, schema: ObjectSchema<any>): boolean {
-    return Object.entries(schema).every(([key, rulesOrNested]) => {
-      const value = obj[key];
-
-      if (Array.isArray(rulesOrNested)) {
-        return rulesOrNested.every((rule) => this.validateRule(value, rule));
-      }
-
-      if (typeof rulesOrNested === "object" && value !== null && typeof value === "object") {
-        return this.validateObject(value, rulesOrNested as ObjectSchema<any>);
-      }
-
-      return true;
-    });
-  }
-
-  private validateRule(value: any, rule: ValidationRule<any>): boolean {
-    if ("required" in rule) return value !== undefined && value !== null;
-    if ("greater_than" in rule) return typeof value === "number" && value > rule.greater_than;
-    if ("greater_than_or_equal" in rule) return typeof value === "number" && value >= rule.greater_than_or_equal;
-    if ("less_than" in rule) return typeof value === "number" && value < rule.less_than;
-    if ("less_than_or_equal" in rule) return typeof value === "number" && value <= rule.less_than_or_equal;
-    if ("type" in rule) return typeof value === rule.type;
-    if ("custom" in rule) return rule.custom(value);
-
-    return true;
-  }
-
-  equals(valueObject: unknown): boolean {
-    if (!(valueObject instanceof ArrayValue)) return false;
-    if (!this.isValid || !valueObject.isValid) return false;
-
-    return JSON.stringify(this.value) === JSON.stringify(valueObject.value);
-  }
-
-  private deepFreeze<Type>(obj: Type): Type {
-    if (Array.isArray(obj)) {
-      obj.forEach(item => this.deepFreeze(item));
-    } else if (obj && typeof obj === "object") {
-      Object.getOwnPropertyNames(obj).forEach(prop => {
-        const value = (obj as any)[prop];
-        if (value && typeof value === "object") {
-          this.deepFreeze(value);
-        }
-      });
-    }
-  
-    return Object.freeze(obj);
-  }
-}

package/src/value-objects/boolean-value.ts

@@ -1,23 +0,0 @@
-import { ValueObject } from "./";
-
-export abstract class BooleanValue implements ValueObject {
-  readonly valueType = "Boolean";
-  readonly value: boolean;
-
-  constructor(value: boolean) {
-    this.value = value;
-  }
-
-  get isValid(): boolean {
-    return true;
-  }
-
-  equals(valueObject: unknown): boolean {
-    if (!(valueObject instanceof BooleanValue)) return false;
-    if (!this.isValid || !valueObject.isValid) return false;
-
-    return this.value === valueObject.value;
-  }
-
-  abstract readonly attributeName: string;
-}

package/src/value-objects/coordinates-value.ts

@@ -1,50 +0,0 @@
-import { ValueObject } from "./";
-
-const EPSILON = 1e-6;
-
-export abstract class CoordinatesValue implements ValueObject {
-  readonly valueType = "Coordinates";
-  readonly value: {
-    latitude: number,
-    longitude: number,
-  };
-
-  constructor(value: CoordinatesValue["value"]) {
-    this.value = value;
-  }
-
-  get isValid(): boolean {
-    const validLatitud = -90 <= this.value.latitude && this.value.latitude <= 90;
-    const validLongitude = -180 <= this.value.longitude && this.value.longitude <= 180;
-
-    return validLatitud && validLongitude;
-  }
-
-  get latitude(): number | null {
-    if (this.isValid) {
-      return this.value.latitude;
-    }
-
-    return null
-  }
-
-  get longitude(): number | null {
-    if (this.isValid) {
-      return this.value.longitude;
-    }
-
-    return null;
-  }
-
-  equals(valueObject: unknown): boolean {
-    if (!(valueObject instanceof CoordinatesValue)) return false;
-    if (!this.isValid || !valueObject.isValid) return false;
-  
-    const latDiff = Math.abs(this.value.latitude - valueObject.value.latitude);
-    const lonDiff = Math.abs(this.value.longitude - valueObject.value.longitude);
-  
-    return latDiff < EPSILON && lonDiff < EPSILON;
-  }
-
-  abstract readonly attributeName: string;
-}