@explorins/pers-shared 2.1.36 → 2.1.37

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # PERS Shared Library Changelog
 
+## [2.0.18] - 2025-11-01
+
+### 🏭 **Error Handling Architecture Migration**
+
+#### Changed
+- **Error Classes**: Now exported for type checking only - instantiation via ErrorFactory required
+- **Domain Errors**: All error classes remain as canonical definitions but must use factory for creation
+- **Frontend Types**: Error classes continue to provide TypeScript types for frontend applications
+
+#### Fixed
+- **Architecture Compliance**: Error classes no longer directly instantiated in backend code
+- **Consistency**: All error creation flows through centralized ErrorFactory pattern
+- **Type Safety**: Maintained full TypeScript support while enforcing factory usage
+
+#### Migration Notes
+- **Backend**: Use `Errors.*` from `@explorins/pers-shared-patterns` instead of direct class instantiation
+- **Frontend**: Continue importing error classes as types - no changes required
+- **API Contracts**: No breaking changes to error response formats or structures
+
+---
+
 ## [2.0.17] - 2025-08-22
 
 ### 🚨 **CRITICAL: Swagger Compatibility & Architecture Refinement**

package/dist/cjs/index.d.ts

@@ -3,4 +3,6 @@ export type * from './shared-lib/interfaces';
 export type * from './shared-lib/types';
 export type * from './shared-lib/dto';
 export type * from './shared-lib/errors';
+export * from './shared-lib/errors';
+export * from './shared-patterns';
 //# 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,mBAAmB,CAAC;AAClC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,kBAAkB,CAAC;AAGtC,mBAAmB,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAClC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,kBAAkB,CAAC;AAGtC,mBAAmB,qBAAqB,CAAC;AACzC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC"}

package/dist/cjs/index.js

@@ -18,6 +18,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 // Core domain contracts
 __exportStar(require("./shared-lib/enum"), 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
+__exportStar(require("./shared-lib/errors"), exports); // Export actual error classes and functions
+// Shared patterns (architecture components)
+__exportStar(require("./shared-patterns"), exports);
+// Note: This library contains both pure data contracts and internal architecture patterns
+// External consumers should only use the type exports and documented public APIs
 //# 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,oDAAkC;AAQlC,yGAAyG;AACzG,mFAAmF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,8FAA8F;;;;;;;;;;;;;;;;AAE9F,wBAAwB;AACxB,oDAAkC;AAOlC,sDAAoC,CAAC,4CAA4C;AAEjF,4CAA4C;AAC5C,oDAAkC;AAElC,0FAA0F;AAC1F,iFAAiF"}

package/dist/cjs/shared-lib/errors/domains/wallet-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-errors.js","sourceRoot":"","sources":["../../../../../src/shared-lib/errors/domains/wallet-errors.ts"],"names":[],"mappings":";;;AAqBA,kEAGG;AAxBH,2CAA4C;AAC5C,gEAA6F;AAC7F,gDAAgE;AAEhE;;GAEG;AAEH,MAAa,yBAA0B,SAAQ,qCAAe;IAC5D,YAAY,aAAqB,EAAE,MAAc;QAC/C,KAAK,CACH,8BAAgB,CAAC,sBAAsB,EACvC,0BAAY,CAAC,MAAM,EACnB,uCAAuC,EACvC,UAAU,aAAa,qBAAqB,MAAM,EAAE,EACpD,mBAAU,CAAC,oBAAoB,EAC/B,+CAA+C,CAChD,CAAC;IACJ,CAAC;CACF;AAXD,8DAWC;AAED,SAAgB,2BAA2B,CAAC,KAAU;IAClD,OAAO,KAAK,EAAE,SAAS,KAAK,wBAAwB;QAC9C,KAAK,EAAE,QAAQ,EAAE,IAAI,KAAK,wBAAwB,CAAC;AAC3D,CAAC;AAEH,MAAa,mBAAoB,SAAQ,qCAAe;IACtD,YAAY,YAAoB;QAC9B,KAAK,CACH,8BAAgB,CAAC,gBAAgB,EACjC,0BAAY,CAAC,MAAM,EACnB,kCAAkC,EAClC,sCAAsC,YAAY,EAAE,EACpD,mBAAU,CAAC,SAAS,EACpB,8BAA8B,CAC/B,CAAC;IACJ,CAAC;CACF;AAXD,kDAWC;AAED,MAAa,0BAA2B,SAAQ,oCAAc;IAC5D,YAAY,MAAc;QACxB,KAAK,CACH,8BAAgB,CAAC,8BAA8B,EAC/C,0BAAY,CAAC,MAAM,EACnB,4CAA4C,EAC5C,mCAAmC,MAAM,EAAE,EAC3C,mBAAU,CAAC,oBAAoB,EAC/B,+CAA+C,EAC/C,IAAI,CAAC,YAAY;SAClB,CAAC;IACJ,CAAC;CACF;AAZD,gEAYC"}
+{"version":3,"file":"wallet-errors.js","sourceRoot":"","sources":["../../../../../src/shared-lib/errors/domains/wallet-errors.ts"],"names":[],"mappings":";;;AAqBA,kEAGG;AAxBH,2CAA4C;AAC5C,gEAA6F;AAC7F,gDAAgE;AAEhE;;GAEG;AAEH,MAAa,yBAA0B,SAAQ,qCAAe;IAC5D,YAAY,aAAqB,EAAE,MAAc;QAC/C,KAAK,CACH,8BAAgB,CAAC,sBAAsB,EACvC,0BAAY,CAAC,MAAM,EACnB,uCAAuC,EACvC,UAAU,aAAa,qBAAqB,MAAM,EAAE,EACpD,mBAAU,CAAC,oBAAoB,EAC/B,+CAA+C,CAChD,CAAC;IACJ,CAAC;CACF;AAXD,8DAWC;AAED,SAAgB,2BAA2B,CAAC,KAAU;IACpD,OAAO,KAAK,EAAE,SAAS,KAAK,wBAAwB;QAC5C,KAAK,EAAE,QAAQ,EAAE,IAAI,KAAK,wBAAwB,CAAC;AAC3D,CAAC;AAEH,MAAa,mBAAoB,SAAQ,qCAAe;IACtD,YAAY,YAAoB;QAC9B,KAAK,CACH,8BAAgB,CAAC,gBAAgB,EACjC,0BAAY,CAAC,MAAM,EACnB,kCAAkC,EAClC,sCAAsC,YAAY,EAAE,EACpD,mBAAU,CAAC,SAAS,EACpB,8BAA8B,CAC/B,CAAC;IACJ,CAAC;CACF;AAXD,kDAWC;AAED,MAAa,0BAA2B,SAAQ,oCAAc;IAC5D,YAAY,MAAc;QACxB,KAAK,CACH,8BAAgB,CAAC,8BAA8B,EAC/C,0BAAY,CAAC,MAAM,EACnB,4CAA4C,EAC5C,mCAAmC,MAAM,EAAE,EAC3C,mBAAU,CAAC,oBAAoB,EAC/B,+CAA+C,EAC/C,IAAI,CAAC,YAAY;SAClB,CAAC;IACJ,CAAC;CACF;AAZD,gEAYC"}

package/dist/cjs/shared-patterns/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/shared-patterns/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/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/shared-patterns/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/shared-patterns/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-patterns/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/shared-patterns/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/shared-patterns/database/models/base.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.model.d.ts","sourceRoot":"","sources":["../../../../../src/shared-patterns/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/shared-patterns/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/shared-patterns/database/models/base.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.model.js","sourceRoot":"","sources":["../../../../../src/shared-patterns/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/shared-patterns/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/shared-patterns/database/models/fixture.model.d.ts.map

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

package/dist/cjs/shared-patterns/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/shared-patterns/database/models/fixture.model.js.map

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

package/dist/cjs/shared-patterns/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/shared-patterns/database/schemas/fixture-fields.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-fields.schema.d.ts","sourceRoot":"","sources":["../../../../../src/shared-patterns/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/shared-patterns/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/shared-patterns/database/schemas/fixture-fields.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-fields.schema.js","sourceRoot":"","sources":["../../../../../src/shared-patterns/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/shared-patterns/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/shared-patterns/database/schemas/shared-fields.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-fields.schema.d.ts","sourceRoot":"","sources":["../../../../../src/shared-patterns/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/shared-patterns/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/shared-patterns/database/schemas/shared-fields.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-fields.schema.js","sourceRoot":"","sources":["../../../../../src/shared-patterns/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/shared-patterns/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/shared-patterns/database/schemas/tenant-fields.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-fields.schema.d.ts","sourceRoot":"","sources":["../../../../../src/shared-patterns/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/shared-patterns/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/shared-patterns/database/schemas/tenant-fields.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-fields.schema.js","sourceRoot":"","sources":["../../../../../src/shared-patterns/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/shared-patterns/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/shared-patterns/enums/lambda.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda.enum.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/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/shared-patterns/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/shared-patterns/enums/lambda.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda.enum.js","sourceRoot":"","sources":["../../../../src/shared-patterns/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"}