@velony/domain 1.0.0

package/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all"
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VelonY
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/eslint.config.mjs

@@ -0,0 +1,55 @@
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import securityPlugin from 'eslint-plugin-security';
+import prettierPlugin from 'eslint-plugin-prettier/recommended';
+import prettierConfig from 'eslint-config-prettier';
+
+export default [
+  // Base configs
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+
+  {
+    settings: {
+      'import/resolver': {
+        typescript: {
+          project: './tsconfig.json',
+        },
+      },
+    },
+  },
+
+  // Security
+  securityPlugin.configs.recommended,
+
+  // TypeScript-specific rules
+  {
+    files: ['**/*.ts'],
+    rules: {
+      'no-console': 'warn',
+      '@typescript-eslint/no-unused-vars': [
+        'warn',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+        },
+      ],
+      '@typescript-eslint/interface-name-prefix': 'off',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-explicit-any': 'off',
+    },
+  },
+
+  // Prettier integration
+  prettierPlugin,
+
+  // Ignore patterns
+  {
+    ignores: ['node_modules/', 'dist/', '.eslintrc.js', 'eslint.config.mjs'],
+  },
+
+  // Disable rules conflicting with Prettier (must be last)
+  prettierConfig,
+];

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@velony/domain",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint src"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/velony-ai/domain.git"
+  },
+  "author": "velony-ai",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/velony-ai/domain/issues"
+  },
+  "homepage": "https://github.com/velony-ai/domain#readme",
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-security": "^3.0.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.51.0"
+  },
+  "dependencies": {
+    "uuid": "^13.0.0"
+  }
+}

package/src/Id.ts

@@ -0,0 +1,9 @@
+import { PrimitiveValueObject } from './primitive-value-object';
+
+declare const ID_BRAND: unique symbol;
+
+export abstract class Id<
+  T extends string | number,
+> extends PrimitiveValueObject<T> {
+  private readonly [ID_BRAND]: void;
+}

package/src/aggregate-root.ts

@@ -0,0 +1,23 @@
+import { DomainEvent } from './domain-event';
+import { Entity } from './entity';
+import { Id } from './Id';
+
+declare const AGGREGATE_ROOT_BRAND: unique symbol;
+
+export abstract class AggregateRoot<
+  TIdentifier extends Id<string | number>,
+> extends Entity<TIdentifier> {
+  private readonly [AGGREGATE_ROOT_BRAND]: void;
+
+  private _domainEvents: DomainEvent<any>[] = [];
+
+  public pullDomainEvents(): DomainEvent<any>[] {
+    const events = [...this._domainEvents];
+    this._domainEvents = [];
+    return events;
+  }
+
+  protected addDomainEvent(event: DomainEvent<any>): void {
+    this._domainEvents.push(event);
+  }
+}

package/src/domain-event.ts

@@ -0,0 +1,25 @@
+import { v7 as uuidv7 } from 'uuid';
+
+export declare const DOMAIN_EVENT_BRAND: unique symbol;
+
+export abstract class DomainEvent<TPayload> {
+  private readonly [DOMAIN_EVENT_BRAND]: void;
+
+  public static readonly type: string;
+
+  public readonly id: string;
+  public readonly aggregateId: string;
+  public readonly payload: TPayload;
+  public readonly occurredAt: Date;
+
+  protected constructor(aggregateId: string, payload: TPayload) {
+    this.id = uuidv7();
+    this.aggregateId = aggregateId;
+    this.occurredAt = new Date();
+    this.payload = payload;
+  }
+
+  public get type(): string {
+    return (this.constructor as typeof DomainEvent<TPayload>).type;
+  }
+}

package/src/entity.ts

@@ -0,0 +1,21 @@
+import { Id } from './Id';
+
+declare const ENTITY_BRAND: unique symbol;
+
+export abstract class Entity<TIdentifier extends Id<string | number>> {
+  private readonly [ENTITY_BRAND]: void;
+
+  protected readonly _id: TIdentifier;
+
+  protected constructor(id: TIdentifier) {
+    this._id = id;
+  }
+
+  public get id(): TIdentifier {
+    return this._id;
+  }
+
+  public equals(other: this): boolean {
+    return this._id.equals(other._id);
+  }
+}

package/src/primitive-value-object.ts

@@ -0,0 +1,17 @@
+import { ValueObject } from './value-object';
+
+declare const PRIMITIVE_VO_BRAND: unique symbol;
+
+export abstract class PrimitiveValueObject<
+  T extends string | number | boolean,
+> extends ValueObject<T> {
+  private readonly [PRIMITIVE_VO_BRAND]: void;
+
+  public equals(other: this): boolean {
+    return this._value === other.value;
+  }
+
+  public toString(): string {
+    return String(this._value);
+  }
+}

package/src/value-object.ts

@@ -0,0 +1,19 @@
+declare const VO_BRAND: unique symbol;
+
+export abstract class ValueObject<TValue> {
+  private readonly [VO_BRAND]: void;
+
+  protected readonly _value: TValue;
+
+  protected constructor(value: TValue) {
+    this._value = value;
+  }
+
+  public get value(): TValue {
+    return this._value;
+  }
+
+  public abstract equals(other: this): boolean;
+
+  public abstract toString(): string;
+}

package/src/value-objects/storage-path.vo.ts

@@ -0,0 +1,34 @@
+import { PrimitiveValueObject } from '../primitive-value-object';
+
+declare const STORAGE_PATH_VO_BRAND: unique symbol;
+
+export class StoragePath extends PrimitiveValueObject<string> {
+  private readonly [STORAGE_PATH_VO_BRAND]: void;
+
+  private constructor(value: string) {
+    super(value);
+  }
+
+  public static create(value: string): StoragePath {
+    if (value.startsWith('/')) {
+      throw new Error('Storage path should not start with /');
+    }
+    if (value.includes('//')) {
+      throw new Error('Storage path contains invalid double slashes');
+    }
+    if (value.includes('..')) {
+      throw new Error('Storage path cannot contain ..');
+    }
+
+    return new StoragePath(value);
+  }
+
+  public toUrl(baseUrl: string): string {
+    return `${baseUrl.replace(/\/$/, '')}/${this._value}`;
+  }
+
+  public get extension(): string {
+    const parts = this._value.split('.');
+    return parts.at(-1)?.toLowerCase() ?? '';
+  }
+}

package/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "resolvePackageJsonExports": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "declaration": true,
+    "removeComments": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2023",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}