@explorins/pers-shared 2.1.190 → 2.1.192

package/dist/cjs/shared-lib/dto/business/businessTypeCreate.request.dto.d.ts

@@ -1,6 +1,6 @@
 export declare class BusinessTypeCreateRequestDTO {
     name: string;
-    description: string;
+    description?: string;
     code?: string;
     iconUrl?: string;
 }

package/dist/cjs/shared-lib/dto/business/businessTypeCreate.request.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"businessTypeCreate.request.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/business/businessTypeCreate.request.dto.ts"],"names":[],"mappings":"AAIA,qBAAa,4BAA4B;IAKrC,IAAI,EAAG,MAAM,CAAA;IAKb,WAAW,EAAG,MAAM,CAAC;IAKrB,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"businessTypeCreate.request.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/business/businessTypeCreate.request.dto.ts"],"names":[],"mappings":"AAIA,qBAAa,4BAA4B;IAKrC,IAAI,EAAG,MAAM,CAAA;IAKb,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/cjs/shared-lib/dto/business/businessTypeCreate.request.dto.js

@@ -27,8 +27,8 @@ __decorate([
     __metadata("design:type", String)
 ], BusinessTypeCreateRequestDTO.prototype, "name", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ description: 'Business type description' }),
-    (0, class_validator_1.IsNotEmpty)(),
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Business type description' }),
+    (0, decorators_1.OptionalStrip)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], BusinessTypeCreateRequestDTO.prototype, "description", void 0);

package/dist/cjs/shared-lib/dto/business/businessTypeCreate.request.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"businessTypeCreate.request.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/business/businessTypeCreate.request.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAA8D;AAC9D,iDAAiD;AAEjD,MAAa,4BAA4B;IAKrC,IAAI,CAAS;IAKb,WAAW,CAAU;IAKrB,IAAI,CAAU;IAKd,OAAO,CAAU;CACpB;AArBD,oEAqBC;AAhBG;IAHC,IAAA,qBAAW,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAC,WAAW,EAAE,oBAAoB,EAAC,CAAC;IAChE,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;0DACE;AAKb;IAHC,IAAA,qBAAW,EAAC,EAAC,WAAW,EAAE,2BAA2B,EAAC,CAAC;IACvD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;iEACU;AAKrB;IAHC,IAAA,6BAAmB,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAC,WAAW,EAAE,oBAAoB,EAAC,CAAC;IACxE,IAAA,0BAAa,GAAE;IACf,IAAA,0BAAQ,GAAE;;0DACG;AAKd;IAHC,IAAA,6BAAmB,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAC,WAAW,EAAE,wBAAwB,EAAC,CAAC;IAC5E,IAAA,0BAAa,GAAE;IACf,IAAA,uBAAK,GAAE;;6DACS"}
+{"version":3,"file":"businessTypeCreate.request.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/business/businessTypeCreate.request.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAA8D;AAC9D,iDAAiD;AAEjD,MAAa,4BAA4B;IAKrC,IAAI,CAAS;IAKb,WAAW,CAAU;IAKrB,IAAI,CAAU;IAKd,OAAO,CAAU;CACpB;AArBD,oEAqBC;AAhBG;IAHC,IAAA,qBAAW,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAC,WAAW,EAAE,oBAAoB,EAAC,CAAC;IAChE,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;0DACE;AAKb;IAHC,IAAA,6BAAmB,EAAC,EAAC,WAAW,EAAE,2BAA2B,EAAC,CAAC;IAC/D,IAAA,0BAAa,GAAE;IACf,IAAA,0BAAQ,GAAE;;iEACU;AAKrB;IAHC,IAAA,6BAAmB,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAC,WAAW,EAAE,oBAAoB,EAAC,CAAC;IACxE,IAAA,0BAAa,GAAE;IACf,IAAA,0BAAQ,GAAE;;0DACG;AAKd;IAHC,IAAA,6BAAmB,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAC,WAAW,EAAE,wBAAwB,EAAC,CAAC;IAC5E,IAAA,0BAAa,GAAE;IACf,IAAA,uBAAK,GAAE;;6DACS"}

package/dist/cjs/shared-lib/dto/redemption/redemptionRedeem.request.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redemptionRedeem.request.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/redemption/redemptionRedeem.request.dto.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAEjF,qBAAa,0BAA0B;IACnC;;;;;;OAMG;IAUH,YAAY,EAAG,MAAM,CAAC;IAStB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAsB3B,OAAO,CAAC,EAAE,cAAc,CAAC;CAC5B"}
+{"version":3,"file":"redemptionRedeem.request.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/redemption/redemptionRedeem.request.dto.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAEjF,qBAAa,0BAA0B;IACnC;;;;;;OAMG;IAUH,YAAY,EAAG,MAAM,CAAC;IAmBtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAsB3B,OAAO,CAAC,EAAE,cAAc,CAAC;CAC5B"}

package/dist/cjs/shared-lib/dto/redemption/redemptionRedeem.request.dto.js

@@ -40,7 +40,17 @@ __decorate([
 ], RedemptionRedeemRequestDTO.prototype, "redemptionId", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'The business id associated with the redemption, if applicable',
+        description: `Business ID associated with this redemption transaction (optional override).
+
+**Token Recipient Priority:**
+1. \`redemption.ownerBusinessId\` - Business that created/owns the redemption (default)
+2. \`dto.businessId\` - This field (override for marketplace/facilitator scenarios)
+3. \`TENANT\` - Platform fallback for platform-wide redemptions
+
+**Use Cases:**
+- Omit for standard redemptions (tokens go to redemption owner)
+- Provide for marketplace scenarios where a facilitator business processes redemptions for another business
+- Leave null for platform-managed redemptions without a specific business owner`,
         type: String,
         nullable: true
     }),

package/dist/cjs/shared-lib/dto/redemption/redemptionRedeem.request.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"redemptionRedeem.request.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/redemption/redemptionRedeem.request.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAA+D;AAC/D,iDAAkE;AAGlE,MAAa,0BAA0B;IACnC;;;;;;OAMG;IACH;;SAEK;IAOL,YAAY,CAAU;IAStB,UAAU,CAAiB;IAsB3B,OAAO,CAAkB;CAC5B;AAjDD,gEAiDC;AAhCG;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE,MAAM;KACf,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAM,GAAE;;gEACa;AAStB;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,+DAA+D;QAC5E,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;KACjB,CAAC;IACD,IAAA,4BAAe,GAAE;IACjB,IAAA,wBAAM,GAAE;;8DACkB;AAsB3B;IApBC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE;;;;;;;;;;;;;mGAa8E;QAC3F,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,sBAAsB,EAAE;KACpH,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,0BAAQ,GAAE;;2DACc"}
+{"version":3,"file":"redemptionRedeem.request.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/redemption/redemptionRedeem.request.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAA+D;AAC/D,iDAAkE;AAGlE,MAAa,0BAA0B;IACnC;;;;;;OAMG;IACH;;SAEK;IAOL,YAAY,CAAU;IAmBtB,UAAU,CAAiB;IAsB3B,OAAO,CAAkB;CAC5B;AA3DD,gEA2DC;AA1CG;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE,MAAM;KACf,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAM,GAAE;;gEACa;AAmBtB;IAjBC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE;;;;;;;;;;gFAU2D;QACxE,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;KACjB,CAAC;IACD,IAAA,4BAAe,GAAE;IACjB,IAAA,wBAAM,GAAE;;8DACkB;AAsB3B;IApBC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE;;;;;;;;;;;;;mGAa8E;QAC3F,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,sBAAsB,EAAE;KACpH,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,0BAAQ,GAAE;;2DACc"}

package/dist/cjs/shared-lib/enum/signing-account-provider.enum.d.ts

@@ -6,6 +6,7 @@
  */
 export declare enum SigningAccountProvider {
     DFNS = "DFNS",
+    TURNKEY = "TURNKEY",
     PERS_INTERNAL = "PERS_INTERNAL"
 }
 //# sourceMappingURL=signing-account-provider.enum.d.ts.map

package/dist/cjs/shared-lib/enum/signing-account-provider.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signing-account-provider.enum.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/enum/signing-account-provider.enum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,sBAAsB;IAIhC,IAAI,SAAsB;IAE1B,aAAa,kBAAuB;CACrC"}
+{"version":3,"file":"signing-account-provider.enum.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/enum/signing-account-provider.enum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,sBAAsB;IAIhC,IAAI,SAAsB;IAC1B,OAAO,YAAsB;IAE7B,aAAa,kBAAuB;CACrC"}

package/dist/cjs/shared-lib/enum/signing-account-provider.enum.js

@@ -13,6 +13,7 @@ var SigningAccountProvider;
     WALLETCONNECT     = 'walletconnect',
     COINBASE_WALLET   = 'coinbase_wallet', */
     SigningAccountProvider["DFNS"] = "DFNS";
+    SigningAccountProvider["TURNKEY"] = "TURNKEY";
     // CUSTODIAL         = 'custodial'
     SigningAccountProvider["PERS_INTERNAL"] = "PERS_INTERNAL"; // Internal PERS managed signing accounts
 })(SigningAccountProvider || (exports.SigningAccountProvider = SigningAccountProvider = {}));

package/dist/cjs/shared-lib/enum/signing-account-provider.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"signing-account-provider.enum.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/signing-account-provider.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,sBAOX;AAPD,WAAY,sBAAsB;IAChC;;6CAEyC;IACzC,uCAA0B,CAAA;IAC1B,kCAAkC;IAClC,yDAAoC,CAAA,CAAC,yCAAyC;AAChF,CAAC,EAPW,sBAAsB,sCAAtB,sBAAsB,QAOjC"}
+{"version":3,"file":"signing-account-provider.enum.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/signing-account-provider.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,sBAQX;AARD,WAAY,sBAAsB;IAChC;;6CAEyC;IACzC,uCAA0B,CAAA;IAC1B,6CAA6B,CAAA;IAC7B,kCAAkC;IAClC,yDAAoC,CAAA,CAAC,yCAAyC;AAChF,CAAC,EARW,sBAAsB,sCAAtB,sBAAsB,QAQjC"}

package/dist/cjs/shared-lib/interfaces/eligibility.interface.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Generic, reusable eligibility primitives.
+ *
+ * A domain-agnostic way to express "can this actor perform this action?" as an
+ * aggregate verdict (`isEligible`) plus a set of self-describing, per-gate checks.
+ * Specialize `Eligibility<TChecks>` per domain by supplying a typed `checks` shape.
+ */
+/**
+ * Result of a single eligibility gate.
+ *
+ * When `passed` is true, `reason` and `detail` are omitted/null.
+ *
+ * @typeParam TCode - Stable machine-readable failure code (defaults to `string`).
+ * @typeParam TDetail - Structured, check-specific detail on failure (defaults to `unknown`).
+ */
+export interface EligibilityCheck<TCode extends string = string, TDetail = unknown> {
+    /** True if this gate is satisfied. */
+    passed: boolean;
+    /** Why the gate failed. Null/omitted when passed. */
+    reason?: {
+        code: TCode;
+        message: string;
+    } | null;
+    /** Structured, check-specific detail. Only present when failed (and applicable). */
+    detail?: TDetail;
+}
+/**
+ * Aggregate eligibility verdict: an overall flag plus a map of named gate results.
+ *
+ * @typeParam TChecks - Record of named gates to their {@link EligibilityCheck} results.
+ */
+export interface Eligibility<TChecks extends Record<string, EligibilityCheck> = Record<string, EligibilityCheck>> {
+    /** AND of every check in `checks`. True only when every gate passes. */
+    isEligible: boolean;
+    /** Per-gate results. Each gate is self-describing on failure. */
+    checks: TChecks;
+}
+//# sourceMappingURL=eligibility.interface.d.ts.map

package/dist/cjs/shared-lib/interfaces/eligibility.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligibility.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/eligibility.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,GAAG,OAAO;IAC9E,sCAAsC;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,KAAK,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,oFAAoF;IACpF,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW,CACxB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAEnF,wEAAwE;IACxE,UAAU,EAAE,OAAO,CAAC;IACpB,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;CACnB"}

package/dist/cjs/shared-lib/interfaces/eligibility.interface.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Generic, reusable eligibility primitives.
+ *
+ * A domain-agnostic way to express "can this actor perform this action?" as an
+ * aggregate verdict (`isEligible`) plus a set of self-describing, per-gate checks.
+ * Specialize `Eligibility<TChecks>` per domain by supplying a typed `checks` shape.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=eligibility.interface.js.map

package/dist/cjs/shared-lib/interfaces/eligibility.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligibility.interface.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/eligibility.interface.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/cjs/shared-lib/interfaces/eligible-business-summary.interface.d.ts

@@ -1,3 +1,4 @@
+import { BusinessTypeDTO } from '../dto/business/business-type.dto';
 /**
  * Minimal business info for eligible business selectors.
  *
@@ -13,5 +14,7 @@ export interface EligibleBusinessSummary {
     displayName: string;
     /** Optional logo/image URL */
     imageUrl?: string | null;
+    /** Business type (for filtering/grouping/display) */
+    businessType?: BusinessTypeDTO | null;
 }
 //# sourceMappingURL=eligible-business-summary.interface.d.ts.map

package/dist/cjs/shared-lib/interfaces/eligible-business-summary.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eligible-business-summary.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/eligible-business-summary.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACpC,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B"}
+{"version":3,"file":"eligible-business-summary.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/eligible-business-summary.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACpC,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qDAAqD;IACrD,YAAY,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CACzC"}

package/dist/cjs/shared-lib/interfaces/index.d.ts

@@ -25,4 +25,5 @@ export * from './ws-relay.types';
 export * from './external-token-issuer.interface';
 export * from './email-config.interface';
 export * from './eligible-business-summary.interface';
+export * from './eligibility.interface';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/shared-lib/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,kCAAkC,CAAC;AAEjD,cAAc,yBAAyB,CAAC;AAExC,cAAc,4CAA4C,CAAC;AAE3D,cAAc,YAAY,CAAC;AAE3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AAEpD,cAAc,kBAAkB,CAAC;AAEjC,cAAc,mCAAmC,CAAC;AAElD,cAAc,0BAA0B,CAAC;AAEzC,cAAc,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,kCAAkC,CAAC;AAEjD,cAAc,yBAAyB,CAAC;AAExC,cAAc,4CAA4C,CAAC;AAE3D,cAAc,YAAY,CAAC;AAE3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AAEpD,cAAc,kBAAkB,CAAC;AAEjC,cAAc,mCAAmC,CAAC;AAElD,cAAc,0BAA0B,CAAC;AAEzC,cAAc,uCAAuC,CAAC;AAEtD,cAAc,yBAAyB,CAAC"}

package/dist/cjs/shared-lib/interfaces/index.js

@@ -42,4 +42,5 @@ __exportStar(require("./ws-relay.types"), exports);
 __exportStar(require("./external-token-issuer.interface"), exports);
 __exportStar(require("./email-config.interface"), exports);
 __exportStar(require("./eligible-business-summary.interface"), exports);
+__exportStar(require("./eligibility.interface"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/shared-lib/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAkD;AAClD,mEAAiD;AACjD,uEAAqD;AACrD,iEAA+C;AAC/C,iEAA+C;AAC/C,0DAAwC;AACxC,+DAA6C;AAC7C,2EAAyD;AACzD,iEAA+C;AAC/C,qDAAmC;AACnC,gEAA8C;AAC9C,kEAAgD;AAChD,sEAAoD;AACpD,8DAA4C;AAC5C,kEAAgD;AAChD,4EAA0D;AAC1D,mEAAiD;AAEjD,0DAAwC;AAExC,6EAA2D;AAE3D,6CAA2B;AAE3B,+DAA6C;AAC7C,qEAAmD;AACnD,8DAA4C;AAC5C,sEAAoD;AAEpD,mDAAiC;AAEjC,oEAAkD;AAElD,2DAAyC;AAEzC,wEAAsD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAkD;AAClD,mEAAiD;AACjD,uEAAqD;AACrD,iEAA+C;AAC/C,iEAA+C;AAC/C,0DAAwC;AACxC,+DAA6C;AAC7C,2EAAyD;AACzD,iEAA+C;AAC/C,qDAAmC;AACnC,gEAA8C;AAC9C,kEAAgD;AAChD,sEAAoD;AACpD,8DAA4C;AAC5C,kEAAgD;AAChD,4EAA0D;AAC1D,mEAAiD;AAEjD,0DAAwC;AAExC,6EAA2D;AAE3D,6CAA2B;AAE3B,+DAA6C;AAC7C,qEAAmD;AACnD,8DAA4C;AAC5C,sEAAoD;AAEpD,mDAAiC;AAEjC,oEAAkD;AAElD,2DAAyC;AAEzC,wEAAsD;AAEtD,0DAAwC"}

package/dist/cjs/shared-lib/types/data-source.type.d.ts

@@ -19,14 +19,15 @@
  *
  * ## Example Scenarios
  *
- * | Scenario                    | channel   | medium     | campaign     | source       |
- * |-----------------------------|-----------|------------|--------------|--------------|
- * | User clicks email link      | `web`     | `email`    | `summer_promo`| `mailchimp` |
- * | Mobile app registration     | `mobile`  | `app`      | -            | -            |
- * | Partner API integration     | `api`     | `affiliate`| -            | `partner_xyz`|
- * | QR code scan in hotel       | `mobile`  | `referral` | `lobby_qr`   | `qr_code`    |
- * | Admin creates user          | `admin`   | -          | -            | -            |
- * | Webhook from Stripe         | `webhook` | -          | -            | `stripe`     |
+ * | Scenario                    | channel   | platform.deviceType | platform.app/browser | Notes |
+ * |-----------------------------|-----------|---------------------|----------------------|-------|
+ * | Desktop browser             | `web`     | `desktop`           | `browser: Chrome`    | -     |
+ * | Mobile browser (Safari)     | `web`     | `phone`             | `browser: Safari`    | NOT 'mobile' channel |
+ * | Native iOS app              | `mobile`  | `phone`             | `app: MyApp`         | Requires x-source-channel |
+ * | Native Android app          | `mobile`  | `phone`             | `app: MyApp`         | Requires x-source-channel |
+ * | Partner API integration     | `api`     | -                   | -                    | -     |
+ * | Admin creates user          | `admin`   | -                   | -                    | -     |
+ * | Webhook from Stripe         | `webhook` | -                   | -                    | -     |
  *
  * @example
  * // Simple usage - just channel
@@ -43,6 +44,10 @@
  */
 /**
  * Primary ingestion channels for data source tracking.
+ *
+ * IMPORTANT:
+ * - 'web' = ANY browser (desktop OR mobile) - use platform.deviceType to distinguish
+ * - 'mobile' = Native apps ONLY (iOS/Android) - must include platform.app
  */
 export declare const DATA_SOURCE_CHANNELS: readonly ["web", "mobile", "api", "admin", "system", "import", "webhook", "sync", "migration", "unknown"];
 export type DataSourceChannel = typeof DATA_SOURCE_CHANNELS[number];
@@ -51,11 +56,19 @@ export type DataSourceChannel = typeof DATA_SOURCE_CHANNELS[number];
  *
  * Provides both simple channel categorization and optional
  * detailed attribution fields for analytics.
+ *
+ * CHANNEL USAGE:
+ * - 'web': ANY browser (desktop/mobile) - check platform.deviceType and platform.browser
+ * - 'mobile': Native apps ONLY - check platform.app and platform.appVersion
+ * - Use platform field to get detailed device/environment information
  */
 export interface DataSource {
     /**
      * Primary ingestion channel.
      * Required field for basic source categorization.
+     *
+     * - 'web' = Browser (desktop or mobile) - use platform.deviceType to distinguish
+     * - 'mobile' = Native mobile app - requires platform.app to be set
      */
     channel: DataSourceChannel;
     /**
@@ -83,6 +96,19 @@ export interface DataSource {
      * SDK provides this - backend stores as-is.
      */
     platform?: Platform;
+    /**
+     * Source of platform data.
+     * Indicates whether platform info came from SDK headers or auto-detection.
+     *
+     * - 'sdk': Explicitly sent via x-platform header (authoritative, trusted)
+     * - 'auto': Parsed from User-Agent header (best-effort, may be inaccurate)
+     *
+     * Use this to:
+     * - Identify incomplete SDK integrations (platformSource='auto' or missing)
+     * - Filter for high-quality data (platformSource='sdk')
+     * - Track SDK adoption progress
+     */
+    platformSource?: 'sdk' | 'auto';
 }
 /**
  * Platform/device information for analytics.
@@ -135,17 +161,37 @@ export declare const KNOWN_SOURCE_DOMAINS: Record<string, string>;
  * detectSourceFromReferrer('https://partner.example.com') // 'example'
  */
 export declare function detectSourceFromReferrer(referrer?: string): string | undefined;
+/**
+ * Parse User-Agent string for platform information (fallback when SDK doesn't provide).
+ *
+ * Extracts OS, browser, device type from standard User-Agent patterns.
+ * This is best-effort - SDK headers are authoritative.
+ *
+ * @param userAgent - User-Agent header value
+ * @returns Platform object with detected fields, or undefined if unparseable
+ *
+ * @example
+ * parseUserAgentForPlatform('Mozilla/5.0 (iPhone; CPU iPhone OS 17_4...')
+ * // { os: 'iOS', osVersion: '17.4', browser: 'Safari', deviceType: 'phone' }
+ */
+export declare function parseUserAgentForPlatform(userAgent?: string): Platform | undefined;
 /**
  * Auto-detect channel from User-Agent string.
  *
+ * IMPORTANT DESIGN:
+ * - Mobile browsers (Safari on iPhone, Chrome on Android) → 'web' (NOT 'mobile')
+ * - Native apps MUST send explicit x-source-channel: mobile header
+ * - Use platform.deviceType to distinguish mobile web from desktop web
+ *
  * @param userAgent - User-Agent header value
  * @param path - Optional request path for webhook detection
  * @returns Detected channel
  *
  * @example
- * detectChannelFromUserAgent('Mozilla/5.0 (iPhone; ...)') // 'mobile'
- * detectChannelFromUserAgent('Mozilla/5.0 (Windows NT...)') // 'web'
+ * detectChannelFromUserAgent('Mozilla/5.0 (iPhone; ...) Safari') // 'web' (mobile browser)
+ * detectChannelFromUserAgent('Mozilla/5.0 (Windows NT...)') // 'web' (desktop browser)
  * detectChannelFromUserAgent('', '/webhook/stripe') // 'webhook'
+ * detectChannelFromUserAgent('MyApp/1.0') // 'unknown' (native app without header)
  */
 export declare function detectChannelFromUserAgent(userAgent?: string, path?: string): DataSourceChannel;
 /**

package/dist/cjs/shared-lib/types/data-source.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-source.type.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/data-source.type.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"data-source.type.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/data-source.type.ts"],"names":[],"mappings":"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"}

package/dist/cjs/shared-lib/types/data-source.type.js

@@ -20,14 +20,15 @@
  *
  * ## Example Scenarios
  *
- * | Scenario                    | channel   | medium     | campaign     | source       |
- * |-----------------------------|-----------|------------|--------------|--------------|
- * | User clicks email link      | `web`     | `email`    | `summer_promo`| `mailchimp` |
- * | Mobile app registration     | `mobile`  | `app`      | -            | -            |
- * | Partner API integration     | `api`     | `affiliate`| -            | `partner_xyz`|
- * | QR code scan in hotel       | `mobile`  | `referral` | `lobby_qr`   | `qr_code`    |
- * | Admin creates user          | `admin`   | -          | -            | -            |
- * | Webhook from Stripe         | `webhook` | -          | -            | `stripe`     |
+ * | Scenario                    | channel   | platform.deviceType | platform.app/browser | Notes |
+ * |-----------------------------|-----------|---------------------|----------------------|-------|
+ * | Desktop browser             | `web`     | `desktop`           | `browser: Chrome`    | -     |
+ * | Mobile browser (Safari)     | `web`     | `phone`             | `browser: Safari`    | NOT 'mobile' channel |
+ * | Native iOS app              | `mobile`  | `phone`             | `app: MyApp`         | Requires x-source-channel |
+ * | Native Android app          | `mobile`  | `phone`             | `app: MyApp`         | Requires x-source-channel |
+ * | Partner API integration     | `api`     | -                   | -                    | -     |
+ * | Admin creates user          | `admin`   | -                   | -                    | -     |
+ * | Webhook from Stripe         | `webhook` | -                   | -                    | -     |
  *
  * @example
  * // Simple usage - just channel
@@ -46,14 +47,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.KNOWN_SOURCE_DOMAINS = exports.DEFAULT_DATA_SOURCE = exports.DATA_SOURCE_CHANNELS = void 0;
 exports.isDataSourceChannel = isDataSourceChannel;
 exports.detectSourceFromReferrer = detectSourceFromReferrer;
+exports.parseUserAgentForPlatform = parseUserAgentForPlatform;
 exports.detectChannelFromUserAgent = detectChannelFromUserAgent;
 exports.parseUtmParams = parseUtmParams;
 /**
  * Primary ingestion channels for data source tracking.
+ *
+ * IMPORTANT:
+ * - 'web' = ANY browser (desktop OR mobile) - use platform.deviceType to distinguish
+ * - 'mobile' = Native apps ONLY (iOS/Android) - must include platform.app
  */
 exports.DATA_SOURCE_CHANNELS = [
-    'web', // Web application/browser
-    'mobile', // Mobile app (iOS/Android)
+    'web', // Web browser (desktop or mobile) - check platform.deviceType
+    'mobile', // Native mobile app ONLY (iOS/Android) - requires platform.app
     'api', // Direct API integration
     'admin', // Admin panel/back-office
     'system', // System-generated (automated)
@@ -181,17 +187,114 @@ function detectSourceFromReferrer(referrer) {
         return undefined;
     }
 }
+/**
+ * Parse User-Agent string for platform information (fallback when SDK doesn't provide).
+ *
+ * Extracts OS, browser, device type from standard User-Agent patterns.
+ * This is best-effort - SDK headers are authoritative.
+ *
+ * @param userAgent - User-Agent header value
+ * @returns Platform object with detected fields, or undefined if unparseable
+ *
+ * @example
+ * parseUserAgentForPlatform('Mozilla/5.0 (iPhone; CPU iPhone OS 17_4...')
+ * // { os: 'iOS', osVersion: '17.4', browser: 'Safari', deviceType: 'phone' }
+ */
+function parseUserAgentForPlatform(userAgent) {
+    if (!userAgent)
+        return undefined;
+    const ua = userAgent;
+    const platform = {};
+    // Detect OS and device type
+    if (/iPhone|iPod/i.test(ua)) {
+        platform.os = 'iOS';
+        const match = ua.match(/OS (\d+)[_\.](\d+)/);
+        if (match)
+            platform.osVersion = `${match[1]}.${match[2]}`;
+        platform.deviceType = 'phone';
+    }
+    else if (/iPad/i.test(ua)) {
+        platform.os = 'iOS';
+        const match = ua.match(/OS (\d+)[_\.](\d+)/);
+        if (match)
+            platform.osVersion = `${match[1]}.${match[2]}`;
+        platform.deviceType = 'tablet';
+    }
+    else if (/Android/i.test(ua)) {
+        platform.os = 'Android';
+        const match = ua.match(/Android ([\d\.]+)/);
+        if (match)
+            platform.osVersion = match[1];
+        platform.deviceType = /Mobile/i.test(ua) ? 'phone' : 'tablet';
+    }
+    else if (/Windows NT/i.test(ua)) {
+        platform.os = 'Windows';
+        const match = ua.match(/Windows NT ([\d\.]+)/);
+        if (match)
+            platform.osVersion = match[1];
+        platform.deviceType = 'desktop';
+    }
+    else if (/Macintosh|Mac OS X/i.test(ua)) {
+        platform.os = 'macOS';
+        const match = ua.match(/Mac OS X ([\d_]+)/);
+        if (match)
+            platform.osVersion = match[1].replace(/_/g, '.');
+        platform.deviceType = 'desktop';
+    }
+    else if (/Linux/i.test(ua) && !/Android/i.test(ua)) {
+        platform.os = 'Linux';
+        platform.deviceType = 'desktop';
+    }
+    // Detect browser (web channel)
+    if (/Edg\//i.test(ua)) {
+        platform.browser = 'Edge';
+        const match = ua.match(/Edg\/([\d\.]+)/);
+        if (match)
+            platform.browserVersion = match[1];
+    }
+    else if (/Chrome\//i.test(ua) && !/Edg/i.test(ua)) {
+        platform.browser = 'Chrome';
+        const match = ua.match(/Chrome\/([\d\.]+)/);
+        if (match)
+            platform.browserVersion = match[1];
+    }
+    else if (/Safari\//i.test(ua) && !/Chrome/i.test(ua)) {
+        platform.browser = 'Safari';
+        const match = ua.match(/Version\/([\d\.]+)/);
+        if (match)
+            platform.browserVersion = match[1];
+    }
+    else if (/Firefox\//i.test(ua)) {
+        platform.browser = 'Firefox';
+        const match = ua.match(/Firefox\/([\d\.]+)/);
+        if (match)
+            platform.browserVersion = match[1];
+    }
+    else if (/Opera|OPR\//i.test(ua)) {
+        platform.browser = 'Opera';
+        const match = ua.match(/(?:Opera|OPR)\/([\d\.]+)/);
+        if (match)
+            platform.browserVersion = match[1];
+    }
+    return Object.keys(platform).length > 0 ? platform : undefined;
+}
 /**
  * Auto-detect channel from User-Agent string.
  *
+ * IMPORTANT DESIGN:
+ * - Mobile browsers (Safari on iPhone, Chrome on Android) → 'web' (NOT 'mobile')
+ * - Native apps MUST send explicit x-source-channel: mobile header
+ * - Use platform.deviceType to distinguish mobile web from desktop web
+ *
  * @param userAgent - User-Agent header value
  * @param path - Optional request path for webhook detection
  * @returns Detected channel
  *
  * @example
- * detectChannelFromUserAgent('Mozilla/5.0 (iPhone; ...)') // 'mobile'
- * detectChannelFromUserAgent('Mozilla/5.0 (Windows NT...)') // 'web'
+ * detectChannelFromUserAgent('Mozilla/5.0 (iPhone; ...) Safari') // 'web' (mobile browser)
+ * detectChannelFromUserAgent('Mozilla/5.0 (Windows NT...)') // 'web' (desktop browser)
  * detectChannelFromUserAgent('', '/webhook/stripe') // 'webhook'
+ * detectChannelFromUserAgent('MyApp/1.0') // 'unknown' (native app without header)
  */
 function detectChannelFromUserAgent(userAgent, path) {
     // Check for webhook paths
@@ -199,16 +302,18 @@ function detectChannelFromUserAgent(userAgent, path) {
         return 'webhook';
     }
     const ua = (userAgent || '').toLowerCase();
-    // Check for mobile user-agents
-    if (/mobile|android|iphone|ipad|ipod|blackberry|windows phone/i.test(ua)) {
-        return 'mobile';
-    }
     // Check for bot/crawler patterns (system)
     if (/bot|crawler|spider|scraper|curl|wget|python|node-fetch|axios/i.test(ua)) {
         return 'api';
     }
-    // Default to web for browser-like user agents
-    return 'web';
+    // Check for ANY browser pattern (desktop OR mobile)
+    // Mobile browsers are 'web' channel - use platform.deviceType to distinguish
+    if (ua && /mozilla|chrome|safari|firefox|edge|opera|msie|trident/i.test(ua)) {
+        return 'web';
+    }
+    // Unknown: Native apps MUST send x-source-channel: mobile header
+    // If we see 'unknown', it means SDK integration is incomplete
+    return 'unknown';
 }
 /**
  * Parse UTM parameters from a URL (deep link, referrer, etc.).

package/dist/cjs/shared-lib/types/data-source.type.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-source.type.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/data-source.type.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"data-source.type.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/data-source.type.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;;;AAmHH,kDAEC;AAwFD,4DA8BC;AAeD,8DA6DC;AAoBD,gEAsBC;AAwCD,wCAuBC;AA9ZD;;;;;;GAMG;AACU,QAAA,oBAAoB,GAAG;IAClC,KAAK,EAAQ,8DAA8D;IAC3E,QAAQ,EAAK,+DAA+D;IAC5E,KAAK,EAAQ,yBAAyB;IACtC,OAAO,EAAM,0BAA0B;IACvC,QAAQ,EAAK,+BAA+B;IAC5C,QAAQ,EAAK,yBAAyB;IACtC,SAAS,EAAI,4BAA4B;IACzC,MAAM,EAAO,uCAAuC;IACpD,WAAW,EAAE,iBAAiB;IAC9B,SAAS,EAAI,2CAA2C;CAChD,CAAC;AA4FX;;GAEG;AACH,SAAgB,mBAAmB,CAAC,KAAc;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,4BAAoB,CAAC,QAAQ,CAAC,KAA0B,CAAC,CAAC;AAChG,CAAC;AAED;;;;;;GAMG;AACU,QAAA,mBAAmB,GAAe;IAC7C,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF;;;GAGG;AACU,QAAA,oBAAoB,GAA2B;IAC1D,SAAS;IACT,YAAY,EAAE,QAAQ;IACtB,cAAc,EAAE,QAAQ;IACxB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,eAAe,EAAE,QAAQ;IACzB,WAAW,EAAE,QAAQ;IACrB,eAAe,EAAE,QAAQ;IACzB,cAAc,EAAE,QAAQ;IACxB,cAAc,EAAE,QAAQ;IACxB,WAAW;IACX,cAAc,EAAE,UAAU;IAC1B,QAAQ,EAAE,UAAU;IACpB,gBAAgB,EAAE,UAAU;IAC5B,gBAAgB,EAAE,UAAU;IAC5B,iBAAiB,EAAE,UAAU;IAC7B,YAAY;IACZ,eAAe,EAAE,WAAW;IAC5B,iBAAiB,EAAE,WAAW;IAC9B,YAAY;IACZ,aAAa,EAAE,SAAS;IACxB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,oBAAoB,EAAE,SAAS;IAC/B,WAAW;IACX,cAAc,EAAE,UAAU;IAC1B,SAAS,EAAE,UAAU;IACrB,UAAU;IACV,aAAa,EAAE,SAAS;IACxB,UAAU,EAAE,SAAS;IACrB,eAAe,EAAE,SAAS;IAC1B,SAAS;IACT,YAAY,EAAE,QAAQ;IACtB,eAAe,EAAE,QAAQ;IACzB,eAAe;IACf,eAAe,EAAE,WAAW;IAC5B,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,cAAc,EAAE,UAAU;IAC1B,iBAAiB;IACjB,UAAU,EAAE,MAAM;IAClB,WAAW,EAAE,OAAO;IACpB,gBAAgB,EAAE,YAAY;IAC9B,WAAW,EAAE,OAAO;IACpB,YAAY,EAAE,QAAQ;IACtB,WAAW,EAAE,QAAQ;IACrB,8CAA8C;IAC9C,iBAAiB,EAAE,OAAO;IAC1B,kBAAkB,EAAE,SAAS;IAC7B,oBAAoB,EAAE,SAAS;CAChC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,SAAgB,wBAAwB,CAAC,QAAiB;IACxD,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAElE,0BAA0B;QAC1B,IAAI,4BAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,OAAO,4BAAoB,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;QAED,4DAA4D;QAC5D,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,4BAAoB,CAAC,EAAE,CAAC;YACpE,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC;gBACpC,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,+EAA+E;QAC/E,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,2CAA2C;QAC7E,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,gCAAgC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,yBAAyB,CAAC,SAAkB;IAC1D,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjC,MAAM,EAAE,GAAG,SAAS,CAAC;IACrB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,4BAA4B;IAC5B,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5B,QAAQ,CAAC,EAAE,GAAG,KAAK,CAAC;QACpB,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC7C,IAAI,KAAK;YAAE,QAAQ,CAAC,SAAS,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,QAAQ,CAAC,UAAU,GAAG,OAAO,CAAC;IAChC,CAAC;SAAM,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5B,QAAQ,CAAC,EAAE,GAAG,KAAK,CAAC;QACpB,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC7C,IAAI,KAAK;YAAE,QAAQ,CAAC,SAAS,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC;IACjC,CAAC;SAAM,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC/B,QAAQ,CAAC,EAAE,GAAG,SAAS,CAAC;QACxB,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC5C,IAAI,KAAK;YAAE,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzC,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IAChE,CAAC;SAAM,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAClC,QAAQ,CAAC,EAAE,GAAG,SAAS,CAAC;QACxB,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC/C,IAAI,KAAK;YAAE,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzC,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;IAClC,CAAC;SAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1C,QAAQ,CAAC,EAAE,GAAG,OAAO,CAAC;QACtB,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC5C,IAAI,KAAK;YAAE,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5D,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;IAClC,CAAC;SAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACrD,QAAQ,CAAC,EAAE,GAAG,OAAO,CAAC;QACtB,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;IAClC,CAAC;IAED,+BAA+B;IAC/B,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACtB,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC;QAC1B,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACzC,IAAI,KAAK;YAAE,QAAQ,CAAC,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;SAAM,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACpD,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC;QAC5B,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC5C,IAAI,KAAK;YAAE,QAAQ,CAAC,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;SAAM,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACvD,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC;QAC5B,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC7C,IAAI,KAAK;YAAE,QAAQ,CAAC,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;SAAM,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACjC,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC;QAC7B,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC7C,IAAI,KAAK;YAAE,QAAQ,CAAC,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;SAAM,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACnC,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;QAC3B,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACnD,IAAI,KAAK;YAAE,QAAQ,CAAC,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,0BAA0B,CAAC,SAAkB,EAAE,IAAa;IAC1E,0BAA0B;IAC1B,IAAI,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAE3C,0CAA0C;IAC1C,IAAI,+DAA+D,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oDAAoD;IACpD,6EAA6E;IAC7E,IAAI,EAAE,IAAI,wDAAwD,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iEAAiE;IACjE,8DAA8D;IAC9D,OAAO,SAAS,CAAC;AACnB,CAAC;AAuBD;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,cAAc,CAAC,GAAW;IACxC,MAAM,MAAM,GAAc,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QAEzC,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAEhD,IAAI,MAAM;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACnC,IAAI,MAAM;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACnC,IAAI,QAAQ;YAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzC,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QAC7B,IAAI,OAAO;YAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cjs/shared-lib/validation/index.d.ts

@@ -1,4 +1,6 @@
 export * from './validation.types';
 export * from './validators';
 export * from './field-validation';
+export * from './status-hierarchy';
+export * from './redemption-eligibility';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/shared-lib/validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/validation/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AAGnC,cAAc,cAAc,CAAC;AAG7B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/validation/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AAGnC,cAAc,cAAc,CAAC;AAG7B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,0BAA0B,CAAC"}

package/dist/cjs/shared-lib/validation/index.js

@@ -20,4 +20,8 @@ __exportStar(require("./validation.types"), exports);
 __exportStar(require("./validators"), exports);
 // Field validation functions (also re-exports types and validators)
 __exportStar(require("./field-validation"), exports);
+// Status hierarchy resolution (pure)
+__exportStar(require("./status-hierarchy"), exports);
+// Redemption eligibility types + pure aggregator
+__exportStar(require("./redemption-eligibility"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/shared-lib/validation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/validation/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,qDAAmC;AAEnC,wBAAwB;AACxB,+CAA6B;AAE7B,oEAAoE;AACpE,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/validation/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,qDAAmC;AAEnC,wBAAwB;AACxB,+CAA6B;AAE7B,oEAAoE;AACpE,qDAAmC;AAEnC,qCAAqC;AACrC,qDAAmC;AAEnC,iDAAiD;AACjD,2DAAyC"}