@velony/contracts 1.0.0

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/README.md

@@ -0,0 +1,62 @@
+# @velony/contracts
+
+A TypeScript contracts library providing integration event interfaces for event-driven architecture.
+
+## Installation
+
+```bash
+npm install @velony/contracts
+```
+
+## Overview
+
+This package provides TypeScript interfaces for integration events used across VelonY microservices. Integration events enable loose coupling between services in an event-driven architecture.
+
+## Usage
+
+```typescript
+import { 
+  UserCreatedIntegrationEvent,
+  UserEmailUpdatedIntegrationEvent,
+  UserPhoneAddedIntegrationEvent 
+} from '@velony/contracts';
+
+// Example: Handle a user created event
+const event: UserCreatedIntegrationEvent = {
+  type: 'user.created',
+  payload: {
+    id: 'user-123',
+    createdAt: new Date()
+  }
+};
+```
+
+## Available Integration Events
+
+### Identity Domain
+
+- `UserCreatedIntegrationEvent` - Fired when a new user is created
+- `UserDeletedIntegrationEvent` - Fired when a user is deleted
+- `UserNameUpdatedIntegrationEvent` - Fired when a user's name is updated
+- `UserUsernameUpdatedIntegrationEvent` - Fired when a user's username is updated
+- `UserEmailAddedIntegrationEvent` - Fired when an email is added to a user
+- `UserEmailRemovedIntegrationEvent` - Fired when an email is removed from a user
+- `UserEmailUpdatedIntegrationEvent` - Fired when a user's email is updated
+- `UserPhoneAddedIntegrationEvent` - Fired when a phone number is added to a user
+- `UserPhoneRemovedIntegrationEvent` - Fired when a phone number is removed from a user
+- `UserPhoneUpdatedIntegrationEvent` - Fired when a user's phone number is updated
+- `UserAvatarPathAddedIntegrationEvent` - Fired when an avatar path is added to a user
+- `UserAvatarPathRemovedIntegrationEvent` - Fired when an avatar path is removed from a user
+- `UserAvatarPathUpdatedIntegrationEvent` - Fired when a user's avatar path is updated
+
+## License
+
+MIT
+
+## Repository
+
+[https://github.com/velony-ai/contracts](https://github.com/velony-ai/contracts)
+
+## Issues
+
+[https://github.com/velony-ai/contracts/issues](https://github.com/velony-ai/contracts/issues)

package/dist/identity/user-avatar-path-added.integration-event.d.ts

@@ -0,0 +1,11 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.avatar-path.added';
+interface Payload {
+    userId: string;
+    avatarPath: string;
+}
+export interface UserAvatarPathAddedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-avatar-path-added.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-avatar-path-added.integration-event.js.map

package/dist/identity/user-avatar-path-added.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-avatar-path-added.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-avatar-path-added.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-avatar-path-changed.integration-event.d.ts

@@ -0,0 +1,11 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.avatar-path.changed';
+interface Payload {
+    userId: string;
+    avatarPath: string;
+}
+export interface UserAvatarPathChangedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-avatar-path-changed.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-avatar-path-changed.integration-event.js.map

package/dist/identity/user-avatar-path-changed.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-avatar-path-changed.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-avatar-path-changed.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-avatar-path-removed.integration-event.d.ts

@@ -0,0 +1,10 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.avatar-path.removed';
+interface Payload {
+    userId: string;
+}
+export interface UserAvatarPathRemovedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-avatar-path-removed.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-avatar-path-removed.integration-event.js.map

package/dist/identity/user-avatar-path-removed.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-avatar-path-removed.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-avatar-path-removed.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-deleted.integration-event.d.ts

@@ -0,0 +1,10 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.deleted';
+interface Payload {
+    userId: string;
+}
+export interface UserDeletedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-deleted.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-deleted.integration-event.js.map

package/dist/identity/user-deleted.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-deleted.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-deleted.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-email-added.integration-event.d.ts

@@ -0,0 +1,11 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.email.added';
+interface Payload {
+    userId: string;
+    email: string;
+}
+export interface UserEmailAddedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-email-added.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-email-added.integration-event.js.map

package/dist/identity/user-email-added.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-email-added.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-email-added.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-email-change-issued.integration-event.d.ts

@@ -0,0 +1,11 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.email-change.issued';
+interface Payload {
+    userId: string;
+    email: string;
+}
+export interface UserEmailChangeIssuedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-email-change-issued.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-email-change-issued.integration-event.js.map

package/dist/identity/user-email-change-issued.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-email-change-issued.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-email-change-issued.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-email-change-revoked.integration-event.d.ts

@@ -0,0 +1,10 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.email-change.revoked';
+interface Payload {
+    userId: string;
+}
+export interface UserEmailChangeRevokedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-email-change-revoked.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-email-change-revoked.integration-event.js.map

package/dist/identity/user-email-change-revoked.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-email-change-revoked.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-email-change-revoked.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-email-changed.integration-event.d.ts

@@ -0,0 +1,11 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.email.changed';
+interface Payload {
+    userId: string;
+    email: string;
+}
+export interface UserEmailChangedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-email-changed.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-email-changed.integration-event.js.map

package/dist/identity/user-email-changed.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-email-changed.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-email-changed.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-email-removed.integration-event.d.ts

@@ -0,0 +1,10 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.email.removed';
+interface Payload {
+    userId: string;
+}
+export interface UserEmailRemovedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-email-removed.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-email-removed.integration-event.js.map

package/dist/identity/user-email-removed.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-email-removed.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-email-removed.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-name-changed.integration-event.d.ts

@@ -0,0 +1,11 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.name.changed';
+interface Payload {
+    userId: string;
+    name: string;
+}
+export interface UserNameChangedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-name-changed.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-name-changed.integration-event.js.map

package/dist/identity/user-name-changed.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-name-changed.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-name-changed.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-phone-number-added.integration-event.d.ts

@@ -0,0 +1,11 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.phone-number.added';
+interface Payload {
+    userId: string;
+    phoneNumber: string;
+}
+export interface UserPhoneNumberAddedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-phone-number-added.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-phone-number-added.integration-event.js.map

package/dist/identity/user-phone-number-added.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-phone-number-added.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-phone-number-added.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-phone-number-change-issued.integration-event.d.ts

@@ -0,0 +1,11 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.phone-number-change.issued';
+interface Payload {
+    userId: string;
+    phoneNumber: string;
+}
+export interface UserPhoneNumberChangeIssuedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-phone-number-change-issued.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-phone-number-change-issued.integration-event.js.map

package/dist/identity/user-phone-number-change-issued.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-phone-number-change-issued.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-phone-number-change-issued.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-phone-number-change-revoked.integration-event.d.ts

@@ -0,0 +1,10 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.phone-number-change.revoked';
+interface Payload {
+    userId: string;
+}
+export interface UserPhoneNumberChangeRevokedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-phone-number-change-revoked.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-phone-number-change-revoked.integration-event.js.map

package/dist/identity/user-phone-number-change-revoked.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-phone-number-change-revoked.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-phone-number-change-revoked.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-phone-number-changed.integration-event.d.ts

@@ -0,0 +1,11 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.phone-number.changed';
+interface Payload {
+    userId: string;
+    phoneNumber: string;
+}
+export interface UserPhoneNumberChangedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-phone-number-changed.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-phone-number-changed.integration-event.js.map

package/dist/identity/user-phone-number-changed.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-phone-number-changed.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-phone-number-changed.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-phone-number-removed.integration-event.d.ts

@@ -0,0 +1,10 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.phone-number.removed';
+interface Payload {
+    userId: string;
+}
+export interface UserPhoneNumberRemovedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-phone-number-removed.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-phone-number-removed.integration-event.js.map

package/dist/identity/user-phone-number-removed.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-phone-number-removed.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-phone-number-removed.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-registered-local.integration-event.d.ts

@@ -0,0 +1,12 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.registered-local';
+interface Payload {
+    userId: string;
+    name: string;
+    username: string;
+}
+export interface UserRegisteredLocalIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-registered-local.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-registered-local.integration-event.js.map

package/dist/identity/user-registered-local.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-registered-local.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-registered-local.integration-event.ts"],"names":[],"mappings":""}

package/dist/identity/user-username-changed.integration-event.d.ts

@@ -0,0 +1,11 @@
+import { IntegrationEvent } from '../integration-event.interface';
+type Type = 'user.username.changed';
+interface Payload {
+    userId: string;
+    username: string;
+}
+export interface UserUsernameChangedIntegrationEvent extends IntegrationEvent<Type, Payload> {
+    type: Type;
+    payload: Payload;
+}
+export {};

package/dist/identity/user-username-changed.integration-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-username-changed.integration-event.js.map

package/dist/identity/user-username-changed.integration-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-username-changed.integration-event.js","sourceRoot":"","sources":["../../src/identity/user-username-changed.integration-event.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export type { IntegrationEvent } from './integration-event.interface';
+export type { UserAvatarPathAddedIntegrationEvent } from './identity/user-avatar-path-added.integration-event';
+export type { UserAvatarPathChangedIntegrationEvent } from './identity/user-avatar-path-changed.integration-event';
+export type { UserAvatarPathRemovedIntegrationEvent } from './identity/user-avatar-path-removed.integration-event';
+export type { UserDeletedIntegrationEvent } from './identity/user-deleted.integration-event';
+export type { UserEmailAddedIntegrationEvent } from './identity/user-email-added.integration-event';
+export type { UserEmailChangeIssuedIntegrationEvent } from './identity/user-email-change-issued.integration-event';
+export type { UserEmailChangeRevokedIntegrationEvent } from './identity/user-email-change-revoked.integration-event';
+export type { UserEmailChangedIntegrationEvent } from './identity/user-email-changed.integration-event';
+export type { UserEmailRemovedIntegrationEvent } from './identity/user-email-removed.integration-event';
+export type { UserNameChangedIntegrationEvent } from './identity/user-name-changed.integration-event';
+export type { UserPhoneNumberAddedIntegrationEvent } from './identity/user-phone-number-added.integration-event';
+export type { UserPhoneNumberChangeIssuedIntegrationEvent } from './identity/user-phone-number-change-issued.integration-event';
+export type { UserPhoneNumberChangeRevokedIntegrationEvent } from './identity/user-phone-number-change-revoked.integration-event';
+export type { UserPhoneNumberChangedIntegrationEvent } from './identity/user-phone-number-changed.integration-event';
+export type { UserPhoneNumberRemovedIntegrationEvent } from './identity/user-phone-number-removed.integration-event';
+export type { UserRegisteredLocalIntegrationEvent } from './identity/user-registered-local.integration-event';
+export type { UserUsernameChangedIntegrationEvent } from './identity/user-username-changed.integration-event';

package/dist/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/integration-event.interface.d.ts

@@ -0,0 +1,10 @@
+export interface IntegrationEvent<TType extends string, TPayload> {
+    id: string;
+    type: TType;
+    version: string;
+    occurredAt: Date;
+    payload: TPayload;
+    partitionKey: string;
+    createdAt: Date;
+    publishedAt: Date | null;
+}

package/dist/integration-event.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=integration-event.interface.js.map

package/dist/integration-event.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-event.interface.js","sourceRoot":"","sources":["../src/integration-event.interface.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@velony/contracts",
+  "version": "1.0.0",
+  "description": "TypeScript contracts library providing integration event interfaces for event-driven architecture",
+  "keywords": [
+    "contracts",
+    "integration-events",
+    "typescript",
+    "event-driven",
+    "interfaces",
+    "types"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint src"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/velony-ai/contracts.git"
+  },
+  "author": "velony-ai",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/velony-ai/contracts/issues"
+  },
+  "homepage": "https://github.com/velony-ai/contracts#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"
+  }
+}