@schorts/shared-kernel 4.2.1 → 4.2.3

package/src/criteria/exceptions/offset-not-valid.ts

@@ -1,11 +0,0 @@
-import { TranslationResolver } from "../../i18n";
-
-export class OffsetNotValid extends Error {
-  constructor(offset: number, translationResolver?: TranslationResolver) {
-    const message = translationResolver
-      ? translationResolver.resolve("criteria.errors.offset_not_valid", { offset })
-      : `Offset Not Valid: ${offset}`;
-
-    super(message);
-  }
-}

package/src/criteria/index.ts

@@ -1,5 +0,0 @@
-export type { Operator } from "./operator";
-export type { Order } from "./order";
-export type { Direction } from "./direction";
-export { Criteria } from "./criteria";
-export * from "./exceptions";

package/src/criteria/operator.ts

@@ -1,12 +0,0 @@
-export type Operator =
-  | "EQUAL"
-  | "GREATER_THAN"
-  | "LESS_THAN"
-  | "GREATER_THAN_OR_EQUAL"
-  | "LESS_THAN_OR_EQUAL"
-  | "NOT_EQUAL"
-  | "IN"
-  | "NOT_IN"
-  | "LIKE"
-  | "BETWEEN"
-  | "GEO_RADIUS";

package/src/criteria/order.ts

@@ -1,4 +0,0 @@
-export type Order = {
-  field: string;
-  direction: "ASC" | "DESC" | "NONE";
-}

package/src/dao/dao.ts

@@ -1,16 +0,0 @@
-import { BaseModel } from "../models";
-import { Entity as BaseEntity } from "../entities";
-import { Criteria } from "../criteria";
-import { UnitOfWork } from "../unit-of-work";
-import { ValueObject } from "../value-objects";
-
-export interface DAO<Model extends BaseModel, Entity extends BaseEntity<ValueObject, Model>> {
-  getAll(): Promise<Entity[]>;
-  findByID(id: Entity["id"]["value"]): Promise<Entity | null>;
-  findOneBy(criteria: Criteria): Promise<Entity | null>;
-  search(criteria: Criteria): Promise<Entity[]>;
-  countBy(criteria: Criteria): Promise<number>;
-  create(entity: Entity, uow?: UnitOfWork): Promise<Entity>;
-  update(entity: Entity, uow?: UnitOfWork): Promise<Entity>;
-  delete(entity: Entity, uow?: UnitOfWork): Promise<Entity>;
-}

package/src/dao/index.ts

@@ -1 +0,0 @@
-export type { DAO } from "./dao";

package/src/domain-events/domain-event-primitives.ts

@@ -1,10 +0,0 @@
-export type DomainEventPrimitives<PayloadSchema = {}> = {
-  id: string;
-  occurred_at: string;
-  type: string;
-  version: number;
-  payload: PayloadSchema;
-  meta: {
-    retries: number;
-  },
-};

package/src/domain-events/domain-event-registry.ts

@@ -1,40 +0,0 @@
-import { DomainEvent, DomainEventPrimitives } from ".";
-import { DomainEventNotRegistered } from "./exceptions";
-
-type DomainEventConstructor<PayloadSchema = any> = {
-  new (
-    id: string,
-    occurredAt: Date,
-    type: string,
-    version: number,
-    payload: PayloadSchema,
-    meta: {
-      retries: number,
-    },
-  ): DomainEvent<PayloadSchema>;
-};
-
-export class DomainEventRegistry {
-  private static registry = new Map<string, DomainEventConstructor>();
-
-  static register(eventName: string, constructor: DomainEventConstructor): void {
-    this.registry.set(eventName, constructor);
-  }
-
-  static create(primitives: DomainEventPrimitives): DomainEvent {
-    const Constructor = this.registry.get(primitives.type);
-
-    if (!Constructor) {
-      throw new DomainEventNotRegistered(primitives.type);
-    }
-
-    return new Constructor(
-      primitives.id,
-      new Date(primitives.occurred_at),
-      primitives.type,
-      primitives.version,
-      primitives.payload,
-      primitives.meta,
-    );
-  }
-}

package/src/domain-events/domain-event.ts

@@ -1,29 +0,0 @@
-import { Message } from "../messages";
-import { DomainEventPrimitives } from "./domain-event-primitives";
-
-export abstract class DomainEvent<PayloadSchema = {}> implements Message<DomainEventPrimitives<PayloadSchema>> {  
-  constructor(
-    readonly id: string,
-    readonly occurredAt: Date,
-    readonly type: string,
-    readonly version: number,
-    readonly payload: PayloadSchema,
-    public meta = { retries: 0 },
-  ) {}
-
-  abstract getEventName(): string;
-
-  toPrimitives(): DomainEventPrimitives<PayloadSchema> {
-    return {
-      id: this.id,
-      occurred_at: this.occurredAt.toString(),
-      type: this.type,
-      version: this.version,
-      payload: this.payload,
-      meta: this.meta,
-    };
-  }
-
-  ack?: () => void;
-  requeue?: () => void;
-}

package/src/domain-events/exceptions/domain-event-not-registered.ts

@@ -1,11 +0,0 @@
-import { TranslationResolver } from "../../i18n";
-
-export class DomainEventNotRegistered extends Error {
-  constructor(domainEventName: string, translationResolver?: TranslationResolver) {
-    const message = translationResolver
-      ? translationResolver.resolve("domain_events.errors.domain_event_not_registered")
-      : `DomainEvent Not Registered: ${domainEventName}`;
-
-    super(message);
-  }
-}

package/src/domain-events/exceptions/index.ts

@@ -1 +0,0 @@
-export { DomainEventNotRegistered } from "./domain-event-not-registered";

package/src/domain-events/index.ts

@@ -1,4 +0,0 @@
-export { DomainEvent } from "./domain-event";
-export type { DomainEventPrimitives } from "./domain-event-primitives";
-export * from "./exceptions";
-export { DomainEventRegistry } from "./domain-event-registry";

package/src/entities/entity-registry.ts

@@ -1,30 +0,0 @@
-import { BaseModel } from "../models";
-import { Entity } from "./entity";
-import { EntityNotRegistered } from "./exceptions";
-import { ValueObject } from "../value-objects";
-
-type EntityConstructor<Model extends BaseModel = BaseModel> = {
-  fromPrimitives(model: Model): Entity<ValueObject, Model>;
-};
-
-export class EntityRegistry {
-  private static registry = new Map<string, EntityConstructor>();
-
-  static register<Model extends BaseModel>(tableOrCollectionName: string, entity: EntityConstructor<Model>): void {
-    this.registry.set(tableOrCollectionName, entity);
-  }
-
-  static resolve<Model extends BaseModel>(tableOrCollectionName: string): EntityConstructor<Model> | null {
-    return (this.registry.get(tableOrCollectionName) || null) as EntityConstructor<Model> | null;
-  }
-
-  static create<Model extends BaseModel>(tableOrCollectionName: string, model: Model): Entity<ValueObject, Model> {
-    const entity = this.resolve<Model>(tableOrCollectionName);
-
-    if (!entity) {
-      throw new EntityNotRegistered(tableOrCollectionName);
-    }
-
-    return entity.fromPrimitives(model);
-  }
-}

package/src/entities/entity.ts

@@ -1,25 +0,0 @@
-import { ValueObject } from "../value-objects";
-import { BaseModel } from "../models";
-import { DomainEvent } from "../domain-events";
-
-export abstract class Entity<IDValue extends ValueObject, Model extends BaseModel> {
-  private domainEvents: Array<DomainEvent> = [];
-
-  constructor(readonly id: IDValue) {}
-
-  pullDomainEvents(): Array<DomainEvent> {
-    const domainEvents = [...this.domainEvents];
-    this.domainEvents = [];
-
-    return domainEvents;
-  }
-
-  recordDomainEvent(domainEvent: DomainEvent): void {
-    this.domainEvents.push(domainEvent);
-  }
-
-  abstract toPrimitives(): Model;
-  static fromPrimitives<Model extends BaseModel>(_model: Model) {
-    throw new Error("Method not implemented.");
-  }
-}

package/src/entities/exceptions/entity-not-registered.ts

@@ -1,11 +0,0 @@
-import { TranslationResolver } from "../../i18n";
-
-export class EntityNotRegistered extends Error {
-  constructor(tableOrCollectionName: string, translationResolver?: TranslationResolver) {
-    const message = translationResolver
-      ? translationResolver.resolve("entities.errors.entity_not_registered")
-      : `Entity Not Registered: ${tableOrCollectionName}`;
-
-    super(message);
-  }
-}

package/src/entities/exceptions/index.ts

@@ -1 +0,0 @@
-export { EntityNotRegistered } from "./entity-not-registered";

package/src/entities/index.ts

@@ -1,4 +0,0 @@
-export { Entity } from "./entity";
-export { EntityRegistry } from "./entity-registry";
-export * from "./exceptions";
-export { RegisterEntity } from "./register-entity.decorator";

package/src/entities/register-entity.decorator.ts

@@ -1,16 +0,0 @@
-import { EntityRegistry } from "./entity-registry";
-import { BaseModel } from "../models";
-import { Entity as BaseEntity } from "./entity";
-import { ValueObject } from "../value-objects";
-
-type EntityConstructor<Model extends BaseModel = BaseModel> = {
-  fromPrimitives(model: Model): BaseEntity<ValueObject, Model>;
-};
-
-export function RegisterEntity<Model extends BaseModel = BaseModel>(type: string) {
-  return function <Entity extends EntityConstructor<Model>>(entity: Entity): Entity {
-    EntityRegistry.register(type, entity);
-
-    return entity;
-  };
-}

package/src/event-bus/event-store.ts

@@ -1,9 +0,0 @@
-import { DomainEventPrimitives } from "../domain-events";
-
-export interface EventStore {
-  save(primitives: DomainEventPrimitives): void;
-  all(): DomainEventPrimitives[];
-  delete(id: string): void;
-  requeue(primitives: DomainEventPrimitives): void;
-  clear(): void;
-}

package/src/event-bus/event-subscriber.ts

@@ -1,5 +0,0 @@
-import { DomainEvent } from "../domain-events";
-
-export interface EventSubscriber<Event extends DomainEvent = DomainEvent> {
-  handle(event: Event): void | Promise<void>;
-}

package/src/event-bus/in-memory/async-in-memory-event-bus.ts

@@ -1,67 +0,0 @@
-import { DomainEvent, DomainEventRegistry } from "../../domain-events";
-import { InMemoryEventStore } from "./in-memory-event-store";
-import { EventStore } from "../event-store";
-import { EventSubscriber } from "../event-subscriber";
-
-export class AsyncInMemoryEventBus {
-  private readonly subscribers = new Map<string, EventSubscriber[]>();
-  private readonly store: EventStore;
-  private readonly maxRetries: number;
-
-  constructor(store: EventStore = new InMemoryEventStore(), maxRetries = 3) {
-    this.store = store;
-    this.maxRetries = maxRetries;
-  }
-
-  subscribe<Event extends DomainEvent>(eventName: string, subscriber: EventSubscriber<Event>): void {
-    if (!this.subscribers.has(eventName)) {
-      this.subscribers.set(eventName, []);
-    }
-
-    this.subscribers.get(eventName)!.push(subscriber);
-  }
-
-  async publish<Event extends DomainEvent>(event: Event): Promise<void> {
-    const primitives = event.toPrimitives();
-
-    this.store.save(primitives);
-
-    await this.dispatch(event);
-  }
-
-  private async dispatch(event: DomainEvent): Promise<void> {
-    const eventName = event.getEventName();
-    const subs = this.subscribers.get(eventName) ?? [];
-    const primitives = event.toPrimitives();
-
-    event.ack = () => this.store.delete(event.id);
-    event.requeue = () => {
-      event.ack?.();
-
-      if (event.meta.retries < this.maxRetries) {
-        const updatedPrimitives = {
-          ...primitives,
-          meta: { ...primitives.meta, retries: event.meta.retries + 1 },
-        };
-
-        this.store.requeue(updatedPrimitives);
-        this.publish(DomainEventRegistry.create(updatedPrimitives));
-      } else {
-        console.warn(`Event ${event.id} exceeded max retries (${this.maxRetries}). Dropping.`);
-      }
-    };
-
-    for (const sub of subs) {
-      await sub.handle(event);
-    }
-  }
-
-  async replay(): Promise<void> {
-    const events = this.store.all();
-
-    for (const primitives of events) {
-      const event = DomainEventRegistry.create(primitives);
-      await this.dispatch(event);
-    }
-  }
-}

package/src/event-bus/in-memory/in-memory-event-store.ts

@@ -1,28 +0,0 @@
-import { DomainEventPrimitives } from "../../domain-events";
-import { EventStore } from "../event-store";
-
-export class InMemoryEventStore implements EventStore {
-  private readonly events: DomainEventPrimitives[] = [];
-
-  save(primitives: DomainEventPrimitives): void {
-    this.events.push(primitives);
-  }
-
-  all(): DomainEventPrimitives[] {
-    return [...this.events];
-  }
-
-  delete(id: string): void {
-    const index = this.events.findIndex(e => e.id === id);
-
-    if (index !== -1) this.events.splice(index, 1);
-  }
-
-  requeue(primitives: DomainEventPrimitives): void {
-    this.events.push(primitives);
-  }
-
-  clear(): void {
-    this.events.length = 0;
-  }
-}

package/src/event-bus/in-memory/index.ts

@@ -1,2 +0,0 @@
-export { InMemoryEventStore } from "./in-memory-event-store";
-export { AsyncInMemoryEventBus } from "./async-in-memory-event-bus"

package/src/event-bus/index.ts

@@ -1,3 +0,0 @@
-export type { EventSubscriber } from "./event-subscriber";
-export type { EventStore } from "./event-store";
-export * from "./in-memory";

package/src/formatters/index.ts

@@ -1 +0,0 @@
-export { PascalCamelToSnake } from "./pascal-camel-to-snake";

package/src/formatters/pascal-camel-to-snake.ts

@@ -1,8 +0,0 @@
-export class PascalCamelToSnake {
-  static format(text: string) {
-    return text
-      .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
-      .replace(/([A-Z]+)([A-Z][a-z])/g, '$1_$2')
-      .toLowerCase();
-  }
-}

package/src/http/exceptions/http-exception.ts

@@ -1,8 +0,0 @@
-export class HTTPException extends Error {
-  constructor(
-    readonly statusCode: number,
-    readonly body: any,
-  ) {
-    super()
-  }
-}

package/src/http/exceptions/index.ts

@@ -1 +0,0 @@
-export { HTTPException } from "./http-exception";

package/src/http/fetch-http-provider.ts

@@ -1,151 +0,0 @@
-import type { HTTPProvider } from "./http-provider";
-import { HTTPException } from "./exceptions";
-import type { HTTPInterceptor } from "./http-interceptor";
-
-export class FetchHTTPProvider implements HTTPProvider {
-  private ongoingRequests = new Map<string, Promise<any>>();
-  private readonly init: {
-    credentials?: RequestCredentials;
-    headers?: HeadersInit;
-  } | undefined;
-  private readonly getAuthorization: (() => string) | undefined;
-  private readonly interceptors: HTTPInterceptor[] = [];
-
-  constructor(
-    getAuthorization?: () => string,
-    init?: {
-      credentials?: RequestCredentials;
-      headers?: HeadersInit;
-    }
-  ) {
-    this.getAuthorization = getAuthorization;
-    this.init = init;
-  }
-
-  useInterceptor(interceptor: HTTPInterceptor) {
-    this.interceptors.push(interceptor);
-  }
-
-  get<ResponseType>(url: URL): Promise<ResponseType> {
-    return this.request("GET", url);
-  }
-
-  post<RequestBodySchema, ResponseType>(
-    url: URL,
-    body: RequestBodySchema
-  ): Promise<ResponseType> {
-    return this.request("POST", url, body);
-  }
-
-  put<RequestBodySchema, ResponseType>(
-    url: URL,
-    body: RequestBodySchema
-  ): Promise<ResponseType> {
-    return this.request("PUT", url, body);
-  }
-
-  patch<RequestBodySchema, ResponseType>(
-    url: URL,
-    body: RequestBodySchema
-  ): Promise<ResponseType> {
-    return this.request("PATCH", url, body);
-  }
-
-  delete<ResponseType>(url: URL): Promise<ResponseType> {
-    return this.request("DELETE", url);
-  }
-
-  private async request<ResponseType>(
-    method: string,
-    url: URL,
-    body?: unknown
-  ): Promise<ResponseType> {
-    const key = this.generateRequestKey(method, url, body);
-
-    if (this.ongoingRequests.has(key)) {
-      return this.ongoingRequests.get(key) as Promise<ResponseType>;
-    }
-
-    const baseHeaders = this.init?.headers ?? {};
-    const authHeader = this.getAuthorization ? { Authorization: this.getAuthorization() } : {};
-    const contentTypeHeader = body !== undefined ? { "Content-Type": "application/json" } : {};
-
-    const headers: HeadersInit = {
-      ...baseHeaders,
-      ...contentTypeHeader,
-      ...authHeader,
-    };
-
-    let init: RequestInit = {
-      method,
-      body: body !== undefined ? JSON.stringify(body) : null,
-      headers,
-    };
-    
-    if (this.init?.credentials !== undefined) {
-      init.credentials = this.init.credentials;
-    }
-
-    for (const interceptor of this.interceptors) {
-      init = interceptor.intercept(init, url);
-    }
-
-    const request = (async () => {
-      const response = await fetch(url.href, init);
-
-      if (!response) {
-        throw new HTTPException(0, undefined);
-      }
-
-      if (response.status === 204) {
-        return undefined as ResponseType;
-      }
-
-      const contentType = response.headers.get("Content-Type") ?? "";
-      let parsed: any;
-
-      try {
-        if (contentType.includes("application/json")) {
-          parsed = await response.json();
-        } else if (contentType.includes("text/")) {
-          parsed = await response.text();
-        } else {
-          parsed = await response.blob();
-        }
-      } catch {
-        parsed = undefined;
-      }
-
-      if (!response.ok) {
-        throw new HTTPException(response.status, parsed);
-      }
-
-      return parsed as ResponseType;
-    })().finally(() => {
-      this.ongoingRequests.delete(key);
-    });
-
-    this.ongoingRequests.set(key, request);
-
-    return request;
-  }
-
-  private generateRequestKey(method: string, url: URL, body?: unknown): string {
-    const base = `${method}:${url.href}`;
-    const bodyHash = body !== undefined ? this.hashString(JSON.stringify(body)) : "";
-
-    return `${base}:${bodyHash}`;
-  }
-
-  private hashString(input: string): string {
-    let hash = 0;
-
-    for (let i = 0; i < input.length; i++) {
-      const chr = input.charCodeAt(i);
-      hash = (hash << 5) - hash + chr;
-      hash |= 0;
-    }
-
-    return hash.toString();
-  }
-}

package/src/http/http-interceptor.ts

@@ -1,3 +0,0 @@
-export interface HTTPInterceptor {
-  intercept(init: RequestInit, url: URL): RequestInit;
-}

package/src/http/http-provider.ts

@@ -1,7 +0,0 @@
-export interface HTTPProvider {
-  get<ResponseType>(url: URL): Promise<ResponseType>;
-  post<RequestBodySchema, ResponseType>(url: URL, body: RequestBodySchema): Promise<ResponseType>;
-  put<RequestBodySchema, ResponseType>(url: URL, body: RequestBodySchema): Promise<ResponseType>;
-  patch<RequestBodySchema, ResponseType>(url: URL, body: RequestBodySchema): Promise<ResponseType>;
-  delete<ResponseType>(url: URL): Promise<ResponseType>;
-}

package/src/http/index.ts

@@ -1,5 +0,0 @@
-export type { HTTPProvider } from "./http-provider";
-export type { HTTPInterceptor } from "./http-interceptor";
-
-export { HTTPException } from "./exceptions";
-export { FetchHTTPProvider } from "./fetch-http-provider";

package/src/i18n/index.ts

@@ -1,2 +0,0 @@
-export type { TranslationResolver } from "./translation-resolver";
-export { SharedKernelTranslationKeys } from "./shared-kernel-translation-keys";

package/src/i18n/shared-kernel-translation-keys.ts

@@ -1,19 +0,0 @@
-export const SharedKernelTranslationKeys = {
-  auth: {
-    errors: {
-      NotAuthenticated: "auth.errors.not_authenticated",
-      RequireAuthNotImplementedCorrectly: "auth.errors.require_auth_not_implemented_correctly",
-    },
-  },
-  criteria: {
-    errors: {
-      LimitNotValid: "criteria.errors.limit_not_valid",
-      OffsetNotValid: "criteria.errors.offset_not_valid",
-    },
-  },
-  entities: {
-    errors: {
-      EntityNotRegistered: "entities.errors.entity_not_registered",
-    },
-  },
-};

package/src/i18n/translation-resolver.ts

@@ -1,3 +0,0 @@
-export interface TranslationResolver {
-  resolve(key: string, params?: Record<string, any>): string;
-}

package/src/index.ts

@@ -1,21 +0,0 @@
-export * from "./auth";
-export * from "./converters";
-export * from "./criteria";
-export * from "./dao";
-export * from "./domain-events";
-export * from "./entities";
-export * from "./event-bus";
-export * from "./formatters";
-export * from "./http";
-export * from "./i18n";
-export * from "./json-api";
-export * from "./messages";
-export * from "./models";
-export * from "./pub-sub";
-export * from "./rbac";
-export * from "./result";
-export * from "./state-manager";
-export * from "./telemetry";
-export * from "./unit-of-work";
-export * from "./utils";
-export * from "./value-objects";

package/src/json-api/exceptions/index.ts

@@ -1 +0,0 @@
-export { JSONAPIErrors } from "./json-api-errors";

package/src/json-api/exceptions/json-api-errors.ts

@@ -1,17 +0,0 @@
-export class JSONAPIErrors extends Error {
-  readonly errors: Array<{
-    id?: string;
-    status: string;
-    code: string;
-    title: string;
-    detail: string;
-    source?: { pointer: string } | { parameter: string } | { header: string };
-    meta?: Record<string, any>;
-  }>;
-
-  constructor(errors: JSONAPIErrors["errors"]) {
-    super();
-
-    this.errors = errors;
-  }
-}

package/src/json-api/index.ts

@@ -1,5 +0,0 @@
-export type { JSONAPISingle } from "./json-api-single";
-export type { JSONAPIList } from "./json-api-list";
-export { URLCriteriaBuilder } from "./url-criteria-builder";
-export { JSONAPIConnector } from "./json-api-connector";
-export * from "./exceptions";