@explorins/pers-shared 2.1.10 → 2.1.11

package/dist/cjs/index.d.ts

@@ -1,8 +1,6 @@
 export * from './enum';
-export * from './value-objects';
 export * from './interfaces';
 export * from './types';
-export * from './dto';
+export type * from './dto';
 export * from './errors';
-export * from './types/backend';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AAGtB,cAAc,UAAU,CAAC;AAGzB,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,mBAAmB,OAAO,CAAC;AAG3B,cAAc,UAAU,CAAC"}

package/dist/cjs/index.js

@@ -18,14 +18,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 // Core domain contracts
 __exportStar(require("./enum"), exports);
-__exportStar(require("./value-objects"), exports);
 __exportStar(require("./interfaces"), exports);
 __exportStar(require("./types"), exports);
-__exportStar(require("./dto"), exports);
 // Error handling system
 __exportStar(require("./errors"), exports);
-// Backend-only exports (Node.js environment)
-__exportStar(require("./types/backend"), exports);
 // Note: Architecture patterns (orchestrators, database schemas) moved to @explorins/pers-shared-patterns
 // This library now contains only pure data contracts safe for external consumption
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,8FAA8F;;;;;;;;;;;;;;;;AAE9F,wBAAwB;AACxB,yCAAuB;AACvB,kDAAgC;AAChC,+CAA6B;AAC7B,0CAAwB;AACxB,wCAAsB;AAEtB,wBAAwB;AACxB,2CAAyB;AAEzB,6CAA6C;AAC7C,kDAAgC;AAEhC,yGAAyG;AACzG,mFAAmF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,8FAA8F;;;;;;;;;;;;;;;;AAE9F,wBAAwB;AACxB,yCAAuB;AACvB,+CAA6B;AAC7B,0CAAwB;AAGxB,wBAAwB;AACxB,2CAAyB;AAEzB,yGAAyG;AACzG,mFAAmF"}

package/dist/cjs/interfaces/token-transaction-input-data.interface.d.ts

@@ -1,6 +1,7 @@
 import type { ContractAbi } from "web3";
 import { Web3TransactionType } from "../enum/transaction-type.enum";
-import { Address, NativeTokenType } from "..";
+import { Address } from "../value-objects";
+import { NativeTokenType } from "..";
 import { AccountOwnerType } from "../enum/owner-type.enum";
 export interface TxParticipants {
     senderAddress: Address;

package/dist/cjs/interfaces/token-transaction-input-data.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-transaction-input-data.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/token-transaction-input-data.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,MAAM,WAAW,cAAc;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,kBAAkB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC5C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACvC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,eAAe,CAAC;IAG3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC1C"}
+{"version":3,"file":"token-transaction-input-data.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/token-transaction-input-data.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,MAAM,WAAW,cAAc;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,kBAAkB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC5C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACvC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,eAAe,CAAC;IAG3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC1C"}

package/dist/cjs/internal/database/index.d.ts

@@ -0,0 +1,6 @@
+export * from './models/base.model';
+export * from './models/fixture.model';
+export * from './schemas/fixture-fields.schema';
+export * from './schemas/tenant-fields.schema';
+export * from './schemas/shared-fields.schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/internal/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/internal/database/index.ts"],"names":[],"mappings":"AAEA,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AAIvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC"}

package/dist/cjs/internal/database/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Exporting models
+__exportStar(require("./models/base.model"), exports);
+__exportStar(require("./models/fixture.model"), exports);
+// Exporting schemas for shared fields
+__exportStar(require("./schemas/fixture-fields.schema"), exports);
+__exportStar(require("./schemas/tenant-fields.schema"), exports);
+__exportStar(require("./schemas/shared-fields.schema"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/internal/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/database/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,mBAAmB;AACnB,sDAAoC;AACpC,yDAAuC;AAGvC,sCAAsC;AACtC,kEAAgD;AAChD,iEAA+C;AAC/C,iEAA+C"}

package/dist/cjs/internal/database/models/base.model.d.ts

@@ -0,0 +1,7 @@
+export declare abstract class BaseModel {
+    id?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+}
+//# sourceMappingURL=base.model.d.ts.map

package/dist/cjs/internal/database/models/base.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.model.d.ts","sourceRoot":"","sources":["../../../../../src/internal/database/models/base.model.ts"],"names":[],"mappings":"AAAA,8BAAsB,SAAS;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB"}

package/dist/cjs/internal/database/models/base.model.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseModel = void 0;
+class BaseModel {
+    id;
+    createdAt;
+    updatedAt;
+    deletedAt;
+}
+exports.BaseModel = BaseModel;
+//# sourceMappingURL=base.model.js.map

package/dist/cjs/internal/database/models/base.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.model.js","sourceRoot":"","sources":["../../../../../src/internal/database/models/base.model.ts"],"names":[],"mappings":";;;AAAA,MAAsB,SAAS;IAC7B,EAAE,CAAU;IACZ,SAAS,CAAQ;IACjB,SAAS,CAAQ;IACjB,SAAS,CAAQ;CAClB;AALD,8BAKC"}

package/dist/cjs/internal/database/models/fixture.model.d.ts

@@ -0,0 +1,4 @@
+export declare abstract class FixtureModel {
+    id?: number;
+}
+//# sourceMappingURL=fixture.model.d.ts.map

package/dist/cjs/internal/database/models/fixture.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.model.d.ts","sourceRoot":"","sources":["../../../../../src/internal/database/models/fixture.model.ts"],"names":[],"mappings":"AAAA,8BAAsB,YAAY;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb"}

package/dist/cjs/internal/database/models/fixture.model.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FixtureModel = void 0;
+class FixtureModel {
+    id;
+}
+exports.FixtureModel = FixtureModel;
+//# sourceMappingURL=fixture.model.js.map

package/dist/cjs/internal/database/models/fixture.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.model.js","sourceRoot":"","sources":["../../../../../src/internal/database/models/fixture.model.ts"],"names":[],"mappings":";;;AAAA,MAAsB,YAAY;IAChC,EAAE,CAAU;CACb;AAFD,oCAEC"}

package/dist/cjs/internal/database/schemas/fixture-fields.schema.d.ts

@@ -0,0 +1,5 @@
+import { EntitySchemaColumnOptions } from "typeorm";
+export declare const fixtureFields: {
+    [key: string]: EntitySchemaColumnOptions;
+};
+//# sourceMappingURL=fixture-fields.schema.d.ts.map

package/dist/cjs/internal/database/schemas/fixture-fields.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-fields.schema.d.ts","sourceRoot":"","sources":["../../../../../src/internal/database/schemas/fixture-fields.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAEnD,eAAO,MAAM,aAAa,EAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAI,yBAAyB,CAAA;CAMvE,CAAC"}

package/dist/cjs/internal/database/schemas/fixture-fields.schema.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fixtureFields = void 0;
+exports.fixtureFields = {
+    id: {
+        type: Number,
+        primary: true,
+        generated: 'increment',
+    },
+};
+//# sourceMappingURL=fixture-fields.schema.js.map

package/dist/cjs/internal/database/schemas/fixture-fields.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-fields.schema.js","sourceRoot":"","sources":["../../../../../src/internal/database/schemas/fixture-fields.schema.ts"],"names":[],"mappings":";;;AAEa,QAAA,aAAa,GAAmD;IAC3E,EAAE,EAAE;QACF,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,WAAW;KACvB;CACF,CAAC"}

package/dist/cjs/internal/database/schemas/shared-fields.schema.d.ts

@@ -0,0 +1,44 @@
+import { EntitySchemaColumnOptions } from "typeorm";
+/**
+ * Shared TypeORM Entity Fields
+ *
+ * MANDATORY for ALL TypeORM schemas in PERS Loyalty Backend
+ *
+ * Usage Pattern:
+ * ```typescript
+ * import { sharedFields } from '../../../base/infrastructure/typeorm/shared-fields.schema';
+ *
+ * // For non-tenant entities (system-wide data)
+ * export const SystemSchema = new EntitySchema<SystemModel>({
+ *     columns: {
+ *         ...sharedFields,     // ALWAYS include first
+ *         // entity-specific fields below
+ *     }
+ * });
+ *
+ * // For tenant-specific entities (most common case)
+ * import { tenantFields } from '../../../base/infrastructure/typeorm/multi-tenant-fields.schema';
+ *
+ * export const TenantSchema = new EntitySchema<TenantModel>({
+ *     columns: {
+ *         ...sharedFields,     // ALWAYS include first
+ *         ...tenantFields,     // Include for tenant isolation
+ *         // entity-specific fields below
+ *     },
+ *     indices: [
+ *         {
+ *             name: 'IDX_tenant_entities_tenant_id',
+ *             columns: ['tenantId'],  // REQUIRED for tenant schemas
+ *         },
+ *     ],
+ * });
+ * ```
+ *
+ * Provides: id (UUID), createdAt, updatedAt, deletedAt (soft delete)
+ * Combines with: tenantFields for multi-tenant support
+ * See: /documentation/domain-model-best-practices.md
+ */
+export declare const sharedFields: {
+    [key: string]: EntitySchemaColumnOptions;
+};
+//# sourceMappingURL=shared-fields.schema.d.ts.map

package/dist/cjs/internal/database/schemas/shared-fields.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-fields.schema.d.ts","sourceRoot":"","sources":["../../../../../src/internal/database/schemas/shared-fields.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,YAAY,EAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAI,yBAAyB,CAAA;CAoBtE,CAAC"}

package/dist/cjs/internal/database/schemas/shared-fields.schema.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sharedFields = void 0;
+/**
+ * Shared TypeORM Entity Fields
+ *
+ * MANDATORY for ALL TypeORM schemas in PERS Loyalty Backend
+ *
+ * Usage Pattern:
+ * ```typescript
+ * import { sharedFields } from '../../../base/infrastructure/typeorm/shared-fields.schema';
+ *
+ * // For non-tenant entities (system-wide data)
+ * export const SystemSchema = new EntitySchema<SystemModel>({
+ *     columns: {
+ *         ...sharedFields,     // ALWAYS include first
+ *         // entity-specific fields below
+ *     }
+ * });
+ *
+ * // For tenant-specific entities (most common case)
+ * import { tenantFields } from '../../../base/infrastructure/typeorm/multi-tenant-fields.schema';
+ *
+ * export const TenantSchema = new EntitySchema<TenantModel>({
+ *     columns: {
+ *         ...sharedFields,     // ALWAYS include first
+ *         ...tenantFields,     // Include for tenant isolation
+ *         // entity-specific fields below
+ *     },
+ *     indices: [
+ *         {
+ *             name: 'IDX_tenant_entities_tenant_id',
+ *             columns: ['tenantId'],  // REQUIRED for tenant schemas
+ *         },
+ *     ],
+ * });
+ * ```
+ *
+ * Provides: id (UUID), createdAt, updatedAt, deletedAt (soft delete)
+ * Combines with: tenantFields for multi-tenant support
+ * See: /documentation/domain-model-best-practices.md
+ */
+exports.sharedFields = {
+    id: {
+        type: 'uuid',
+        primary: true,
+        generated: 'uuid',
+    },
+    createdAt: {
+        type: Date,
+        createDate: true,
+    },
+    updatedAt: {
+        type: Date,
+        nullable: true,
+        updateDate: true,
+    },
+    deletedAt: {
+        type: Date,
+        nullable: true,
+        deleteDate: true,
+    },
+};
+//# sourceMappingURL=shared-fields.schema.js.map

package/dist/cjs/internal/database/schemas/shared-fields.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-fields.schema.js","sourceRoot":"","sources":["../../../../../src/internal/database/schemas/shared-fields.schema.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACU,QAAA,YAAY,GAAmD;IAC1E,EAAE,EAAE;QACF,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,MAAM;KAClB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,IAAI;QACV,UAAU,EAAE,IAAI;KACjB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;KACjB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;KACjB;CACF,CAAC"}

package/dist/cjs/internal/database/schemas/tenant-fields.schema.d.ts

@@ -0,0 +1,51 @@
+import { EntitySchemaColumnOptions } from "typeorm";
+/**
+ * Multi-Tenant TypeORM Entity Fields
+ *
+ * MANDATORY for tenant-specific data in PERS Loyalty Backend
+ *
+ * ✅ ALWAYS INCLUDE tenantFields for:
+ * - User-specific data: SigningAccount, UserWallet, UserProfile, UserPreferences
+ * - Business domain data: Campaign, Redemption, Transaction, TokenBalance
+ * - API keys and authentication: ApiKey, RefreshToken, UserSession
+ * - Tenant-specific configuration: BusinessSettings, CampaignTemplates
+ * - Any data that varies by tenant/client
+ *
+ * ❌ EXCLUDE tenantFields for:
+ * - System-wide shared data: TokenContract, GeolocationData, SystemSettings
+ * - Static reference data: Country codes, currency rates, blockchain configs
+ * - Cross-tenant shared resources (explicitly designed to be shared)
+ *
+ * Usage Pattern:
+ * ```typescript
+ * export const MySchema = new EntitySchema<MyModel>({
+ *     columns: {
+ *         ...sharedFields,     // Base fields (id, timestamps, soft delete)
+ *         ...tenantFields,     // Multi-tenant support (tenantId with RLS)
+ *         // entity-specific fields below
+ *     }
+ * });
+ * ```
+ *
+ * CRITICAL: When using tenantFields, MUST include RLS module:
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     TypeOrmModule.forFeature([MySchema]),
+ *     RLSModule.forFeature([MySchema]),    // REQUIRED for Row Level Security
+ *   ],
+ * })
+ * ```
+ *
+ * Technical Details:
+ * - Provides: tenantId with RLS (Row Level Security) automatic population
+ * - RLS Function: Uses current_setting('rls.tenant_id') for automatic tenant isolation
+ * - Database-level security: Prevents cross-tenant data leaks automatically
+ * - Transparent filtering: All queries automatically filter by current tenant
+ *
+ * See: /documentation/domain-model-best-practices.md for complete patterns
+ */
+export declare const tenantFields: {
+    [key: string]: EntitySchemaColumnOptions;
+};
+//# sourceMappingURL=tenant-fields.schema.d.ts.map

package/dist/cjs/internal/database/schemas/tenant-fields.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-fields.schema.d.ts","sourceRoot":"","sources":["../../../../../src/internal/database/schemas/tenant-fields.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,eAAO,MAAM,YAAY,EAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAI,yBAAyB,CAAA;CAMtE,CAAC"}

package/dist/cjs/internal/database/schemas/tenant-fields.schema.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tenantFields = void 0;
+/**
+ * Multi-Tenant TypeORM Entity Fields
+ *
+ * MANDATORY for tenant-specific data in PERS Loyalty Backend
+ *
+ * ✅ ALWAYS INCLUDE tenantFields for:
+ * - User-specific data: SigningAccount, UserWallet, UserProfile, UserPreferences
+ * - Business domain data: Campaign, Redemption, Transaction, TokenBalance
+ * - API keys and authentication: ApiKey, RefreshToken, UserSession
+ * - Tenant-specific configuration: BusinessSettings, CampaignTemplates
+ * - Any data that varies by tenant/client
+ *
+ * ❌ EXCLUDE tenantFields for:
+ * - System-wide shared data: TokenContract, GeolocationData, SystemSettings
+ * - Static reference data: Country codes, currency rates, blockchain configs
+ * - Cross-tenant shared resources (explicitly designed to be shared)
+ *
+ * Usage Pattern:
+ * ```typescript
+ * export const MySchema = new EntitySchema<MyModel>({
+ *     columns: {
+ *         ...sharedFields,     // Base fields (id, timestamps, soft delete)
+ *         ...tenantFields,     // Multi-tenant support (tenantId with RLS)
+ *         // entity-specific fields below
+ *     }
+ * });
+ * ```
+ *
+ * CRITICAL: When using tenantFields, MUST include RLS module:
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     TypeOrmModule.forFeature([MySchema]),
+ *     RLSModule.forFeature([MySchema]),    // REQUIRED for Row Level Security
+ *   ],
+ * })
+ * ```
+ *
+ * Technical Details:
+ * - Provides: tenantId with RLS (Row Level Security) automatic population
+ * - RLS Function: Uses current_setting('rls.tenant_id') for automatic tenant isolation
+ * - Database-level security: Prevents cross-tenant data leaks automatically
+ * - Transparent filtering: All queries automatically filter by current tenant
+ *
+ * See: /documentation/domain-model-best-practices.md for complete patterns
+ */
+exports.tenantFields = {
+    tenantId: {
+        type: String,
+        nullable: true,
+        default: () => "current_setting('rls.tenant_id')",
+    },
+};
+//# sourceMappingURL=tenant-fields.schema.js.map

package/dist/cjs/internal/database/schemas/tenant-fields.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-fields.schema.js","sourceRoot":"","sources":["../../../../../src/internal/database/schemas/tenant-fields.schema.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACU,QAAA,YAAY,GAAmD;IAC1E,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,GAAG,EAAE,CAAC,kCAAkC;KAClD;CACF,CAAC"}

package/dist/cjs/internal/enums/lambda.enum.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Lambda function enums for internal microservice communication
+ * Used across multiple domains for lambda-based orchestration
+ */
+/**
+ * Domain enum for Lambda function names
+ * Contains business-meaningful function categories
+ */
+export declare enum LambdaFunctionName {
+    TRANSACTION = "transaction"
+}
+/**
+ * Domain enum for specific invokable Lambda functions
+ * Represents the business operations available through Lambda
+ */
+export declare enum LambdaInvokableFunctionName {
+    RUN_TRANSACTION_ASYNC = "runTransactionAsync",
+    SUBMIT_SIGNED_TRANSACTION = "submitSignedTransaction"
+}
+/**
+ * Domain enum for Lambda invocation types
+ * Business perspective on synchronous vs asynchronous operations
+ */
+export declare enum LambdaInvocationType {
+    SYNCHRONOUS = "RequestResponse",
+    ASYNCHRONOUS = "Event"
+}
+//# sourceMappingURL=lambda.enum.d.ts.map

package/dist/cjs/internal/enums/lambda.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda.enum.d.ts","sourceRoot":"","sources":["../../../../src/internal/enums/lambda.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,oBAAY,kBAAkB;IAC5B,WAAW,gBAAgB;CAC5B;AAED;;;GAGG;AACH,oBAAY,2BAA2B;IACrC,qBAAqB,wBAAwB;IAC7C,yBAAyB,4BAA4B;CACtD;AAED;;;GAGG;AACH,oBAAY,oBAAoB;IAC9B,WAAW,oBAAoB;IAC/B,YAAY,UAAU;CACvB"}

package/dist/cjs/internal/enums/lambda.enum.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Lambda function enums for internal microservice communication
+ * Used across multiple domains for lambda-based orchestration
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LambdaInvocationType = exports.LambdaInvokableFunctionName = exports.LambdaFunctionName = void 0;
+/**
+ * Domain enum for Lambda function names
+ * Contains business-meaningful function categories
+ */
+var LambdaFunctionName;
+(function (LambdaFunctionName) {
+    LambdaFunctionName["TRANSACTION"] = "transaction";
+})(LambdaFunctionName || (exports.LambdaFunctionName = LambdaFunctionName = {}));
+/**
+ * Domain enum for specific invokable Lambda functions
+ * Represents the business operations available through Lambda
+ */
+var LambdaInvokableFunctionName;
+(function (LambdaInvokableFunctionName) {
+    LambdaInvokableFunctionName["RUN_TRANSACTION_ASYNC"] = "runTransactionAsync";
+    LambdaInvokableFunctionName["SUBMIT_SIGNED_TRANSACTION"] = "submitSignedTransaction";
+})(LambdaInvokableFunctionName || (exports.LambdaInvokableFunctionName = LambdaInvokableFunctionName = {}));
+/**
+ * Domain enum for Lambda invocation types
+ * Business perspective on synchronous vs asynchronous operations
+ */
+var LambdaInvocationType;
+(function (LambdaInvocationType) {
+    LambdaInvocationType["SYNCHRONOUS"] = "RequestResponse";
+    LambdaInvocationType["ASYNCHRONOUS"] = "Event";
+})(LambdaInvocationType || (exports.LambdaInvocationType = LambdaInvocationType = {}));
+//# sourceMappingURL=lambda.enum.js.map

package/dist/cjs/internal/enums/lambda.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda.enum.js","sourceRoot":"","sources":["../../../../src/internal/enums/lambda.enum.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;;GAGG;AACH,IAAY,kBAEX;AAFD,WAAY,kBAAkB;IAC5B,iDAA2B,CAAA;AAC7B,CAAC,EAFW,kBAAkB,kCAAlB,kBAAkB,QAE7B;AAED;;;GAGG;AACH,IAAY,2BAGX;AAHD,WAAY,2BAA2B;IACrC,4EAA6C,CAAA;IAC7C,oFAAqD,CAAA;AACvD,CAAC,EAHW,2BAA2B,2CAA3B,2BAA2B,QAGtC;AAED;;;GAGG;AACH,IAAY,oBAGX;AAHD,WAAY,oBAAoB;IAC9B,uDAA+B,CAAA;IAC/B,8CAAsB,CAAA;AACxB,CAAC,EAHW,oBAAoB,oCAApB,oBAAoB,QAG/B"}

package/dist/cjs/internal/exceptions/base/error-classification-enums.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Error Classification Enums and Interfaces
+ *
+ * This file defines the error categorization system used throughout the application.
+ *
+ * 🎯 DEVELOPER GUIDANCE:
+ *
+ * When creating errors, choose the appropriate category:
+ *
+ * 1. DOMAIN_RULE: Business logic violations
+ *    → Use BusinessLogicError subclasses (e.g., TokenTypeNotFoundError)
+ *
+ * 2. TECHNICAL: Application/config issues
+ *    → Use TechnicalError.withMessage() for meaningful technical errors
+ *
+ * 3. VALIDATION: Input format/validation failures
+ *    → Let NestJS validation decorators handle these automatically
+ *
+ * 4. INFRASTRUCTURE: External system failures
+ *    → These are usually classified automatically from generic Error() instances
+ *
+ * 5. SECURITY: Auth/authorization issues
+ *    → Use NestJS guards and filters for consistent security errors
+ *
+ * 💡 TIP: Prefer structured errors (BusinessLogicError/TechnicalError) over generic Error()
+ *         for better user experience and debugging capability.
+ *
+ * 📊 QUICK REFERENCE TABLE:
+ * ┌─────────────────┬─────────────┬─────────────────────────────────────┬───────────┐
+ * │ Category        │ HTTP Status │ Example                             │ Retryable │
+ * ├─────────────────┼─────────────┼─────────────────────────────────────┼───────────┤
+ * │ VALIDATION      │ 400         │ "Email format invalid"              │ No        │
+ * │ DOMAIN_RULE     │ 422         │ "Insufficient balance"              │ No        │
+ * │ TECHNICAL       │ 422         │ "Invalid file format"               │ Maybe     │
+ * │ INFRASTRUCTURE  │ 503         │ "Database connection failed"        │ Yes       │
+ * │ SECURITY        │ 403         │ "Access denied"                     │ No        │
+ * │ RATE_LIMIT      │ 429         │ "API rate limit exceeded"           │ Yes       │
+ * │ TIMEOUT         │ 504         │ "Request timeout"                   │ Yes       │
+ * │ UNKNOWN         │ 500         │ Generic Error() instances           │ Yes       │
+ * └─────────────────┴─────────────┴─────────────────────────────────────┴───────────┘
+ */
+/**
+ * Error severity levels for prioritization and alerting
+ *
+ * Determines the urgency of response and escalation procedures:
+ * - Monitoring alert thresholds
+ * - On-call escalation policies
+ * - SLA response times
+ * - Business impact assessment
+ */
+export declare enum ErrorSeverity {
+    /**
+     * Low severity - Minor issues, degraded experience but service functional
+     * Examples: Optional feature failures, cosmetic issues, non-critical warnings
+     * Response Time: 24-48 hours
+     * Escalation: Development team during business hours
+     * Business Impact: Minimal
+     */
+    LOW = "LOW",
+    /**
+     * Medium severity - Noticeable issues, some functionality impaired
+     * Examples: Performance degradation, secondary feature failures, data sync delays
+     * Response Time: 4-8 hours
+     * Escalation: Development team within same day
+     * Business Impact: Moderate
+     */
+    MEDIUM = "MEDIUM",
+    /**
+     * High severity - Significant issues, core functionality impaired
+     * Examples: Payment failures, authentication issues, critical feature outages
+     * Response Time: 1-2 hours
+     * Escalation: Immediate development team notification
+     * Business Impact: High
+     */
+    HIGH = "HIGH",
+    /**
+     * Critical severity - System down, major business impact
+     * Examples: Complete service outage, data corruption, security breaches
+     * Response Time: Immediate (< 15 minutes)
+     * Escalation: Page on-call engineer, notify leadership
+     * Business Impact: Severe
+     */
+    CRITICAL = "CRITICAL"
+}
+/**
+ * API error response format including correlation tracking
+ */
+export interface ApiErrorResponse {
+    code: string;
+    domain: string;
+    message: string;
+    developerMessage?: string;
+    action?: string;
+    timestamp: string;
+    category: string;
+    correlationId: string;
+    retryable: boolean;
+    severity: ErrorSeverity;
+}
+/**
+ * HTTP Status codes used by our error classification system
+ *
+ * Centralized here to maintain consistency across error classification
+ * and avoid duplication with NestJS HttpStatus values.
+ */
+export declare enum ErrorHttpStatus {
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    CONFLICT = 409,
+    UNPROCESSABLE_ENTITY = 422,
+    TOO_MANY_REQUESTS = 429,
+    INTERNAL_SERVER_ERROR = 500,
+    SERVICE_UNAVAILABLE = 503,
+    GATEWAY_TIMEOUT = 504
+}
+//# sourceMappingURL=error-classification-enums.d.ts.map

package/dist/cjs/internal/exceptions/base/error-classification-enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classification-enums.d.ts","sourceRoot":"","sources":["../../../../../src/internal/exceptions/base/error-classification-enums.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAKH;;;;;;;;GAQG;AACH,oBAAY,aAAa;IACvB;;;;;;OAMG;IACH,GAAG,QAAQ;IAEX;;;;;;OAMG;IACH,MAAM,WAAW;IAEjB;;;;;;OAMG;IACH,IAAI,SAAS;IAEb;;;;;;OAMG;IACH,QAAQ,aAAa;CACtB;AAID;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAID;;;;;GAKG;AACH,oBAAY,eAAe;IACzB,WAAW,MAAM;IACjB,YAAY,MAAM;IAClB,SAAS,MAAM;IACf,SAAS,MAAM;IACf,QAAQ,MAAM;IACd,oBAAoB,MAAM;IAC1B,iBAAiB,MAAM;IACvB,qBAAqB,MAAM;IAC3B,mBAAmB,MAAM;IACzB,eAAe,MAAM;CACtB"}