@explorins/pers-shared 2.1.122 → 2.1.123

package/dist/cjs/shared-lib/enum/token-validity-type.enum.js

@@ -5,12 +5,21 @@ exports.TOKEN_VALIDITY_TYPE_VALUES = exports.TokenValidityTypes = void 0;
  * Token Validity Type Enum
  *
  * Defines how token expiry is calculated:
+ *
+ * Static types (computed at issuance from template):
  * - FIXED_DATE: Uses expiryDate directly as absolute expiration
  * - DAYS_FROM_ISSUANCE: Computes expiry as issuance date + validityDuration days
  * - HOURS_FROM_ISSUANCE: Computes expiry as issuance date + validityDuration hours
  * - MONTHS_FROM_ISSUANCE: Computes expiry as issuance date + validityDuration months
  * - END_OF_MONTH: Token expires at end of the month when issued
  * - END_OF_YEAR: Token expires at end of the year when issued
+ *
+ * Trigger-based types (computed from runtime context):
+ * - TRIGGER_DATE: Uses date from context.validityDate (e.g., hotel check-out date)
+ * - TRIGGER_DATE_RANGE: Uses context.validityEndDate directly (for explicit start/end scenarios)
+ * - DAYS_FROM_TRIGGER: Computes expiry as context.validityDate + duration days
+ *                      Duration from context.validityDuration OR template.validityDuration
+ * - HOURS_FROM_TRIGGER: Same as above but hours
  */
 exports.TokenValidityTypes = {
     FIXED_DATE: 'fixed_date',
@@ -19,6 +28,11 @@ exports.TokenValidityTypes = {
     MONTHS_FROM_ISSUANCE: 'months_from_issuance',
     END_OF_MONTH: 'end_of_month',
     END_OF_YEAR: 'end_of_year',
+    // Trigger-based types - require context at runtime
+    TRIGGER_DATE: 'trigger_date',
+    TRIGGER_DATE_RANGE: 'trigger_date_range',
+    DAYS_FROM_TRIGGER: 'days_from_trigger',
+    HOURS_FROM_TRIGGER: 'hours_from_trigger',
 };
 exports.TOKEN_VALIDITY_TYPE_VALUES = Object.values(exports.TokenValidityTypes);
 //# sourceMappingURL=token-validity-type.enum.js.map

package/dist/cjs/shared-lib/enum/token-validity-type.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"token-validity-type.enum.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/token-validity-type.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACU,QAAA,kBAAkB,GAAG;IAC9B,UAAU,EAAE,YAAY;IACxB,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;CACpB,CAAC;AAIE,QAAA,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC,0BAAkB,CAAC,CAAC"}
+{"version":3,"file":"token-validity-type.enum.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/token-validity-type.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACU,QAAA,kBAAkB,GAAG;IAC9B,UAAU,EAAE,YAAY;IACxB,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,mDAAmD;IACnD,YAAY,EAAE,cAAc;IAC5B,kBAAkB,EAAE,oBAAoB;IACxC,iBAAiB,EAAE,mBAAmB;IACtC,kBAAkB,EAAE,oBAAoB;CAClC,CAAC;AAIE,QAAA,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC,0BAAkB,CAAC,CAAC"}

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

@@ -0,0 +1,96 @@
+/**
+ * Dynamic Context Interface
+ *
+ * Used for runtime context injection in ERC721 token generation.
+ * Supports both AI prompt placeholders and trigger-based validity computation.
+ *
+ * Trust levels and filtering:
+ * - Dynamic context (TriggerSource.context): Admin-controlled (QR/NFC) → always trusted
+ * - External context (CampaignClaimRequest.context): User API request → only if allowExternalContextOverwrite=true
+ *
+ * Context merge order (later overrides earlier on conflict):
+ * 1. TokenMetadata.defaultPromptContext (admin-defined defaults)
+ * 2. Dynamic context (location/trigger-specific, always included)
+ * 3. External context (user-provided, only if allowExternalContextOverwrite=true)
+ *
+ * @example Hotel stay scenario
+ * ```typescript
+ * const context: DynamicContext = {
+ *   // Validity - token expires on check-out
+ *   validityEndDate: '2026-04-20T11:00:00Z',
+ *
+ *   // AI prompt context - available as {{context.xxx}}
+ *   guestName: 'John Doe',
+ *   roomNumber: '305',
+ *   roomType: 'Suite',
+ * };
+ * ```
+ *
+ * @example Event ticket scenario
+ * ```typescript
+ * const context: DynamicContext = {
+ *   // Validity - token valid until event end + 2 hours
+ *   validityDate: '2026-06-15T22:00:00Z',
+ *   validityDuration: 2, // hours (with HOURS_FROM_TRIGGER)
+ *
+ *   // AI prompt context
+ *   eventName: 'Summer Festival',
+ *   ticketType: 'VIP',
+ *   seatNumber: 'A12',
+ * };
+ * ```
+ */
+export interface DynamicContext {
+    /**
+     * Base date for trigger-based validity types.
+     * Used by: TRIGGER_DATE, DAYS_FROM_TRIGGER, HOURS_FROM_TRIGGER
+     *
+     * @example '2026-04-15T14:00:00Z' (hotel check-in date)
+     */
+    validityDate?: string | Date;
+    /**
+     * End date for date range scenarios.
+     * Used by: TRIGGER_DATE_RANGE
+     * Takes precedence over validityDate for expiry calculation.
+     *
+     * @example '2026-04-20T11:00:00Z' (hotel check-out date)
+     */
+    validityEndDate?: string | Date;
+    /**
+     * Dynamic duration override (days or hours depending on validity type).
+     * Used by: DAYS_FROM_TRIGGER, HOURS_FROM_TRIGGER
+     * Overrides TokenMetadata.validityDuration when provided.
+     *
+     * @example 5 (5-night hotel stay, or 5 hours for event)
+     */
+    validityDuration?: number;
+    /**
+     * Additional arbitrary keys for AI prompt placeholders.
+     * Available in prompts as {{context.keyName}}.
+     *
+     * Common examples:
+     * - guestName, customerName, userName
+     * - roomNumber, seatNumber, orderNumber
+     * - productCategory, eventType, tierLevel
+     */
+    [key: string]: string | number | boolean | Date | undefined | null;
+}
+/**
+ * Type guard to check if context has validity date
+ */
+export declare const hasValidityDate: (context?: DynamicContext) => context is DynamicContext & {
+    validityDate: string | Date;
+};
+/**
+ * Type guard to check if context has validity end date
+ */
+export declare const hasValidityEndDate: (context?: DynamicContext) => context is DynamicContext & {
+    validityEndDate: string | Date;
+};
+/**
+ * Type guard to check if context has validity duration
+ */
+export declare const hasValidityDuration: (context?: DynamicContext) => context is DynamicContext & {
+    validityDuration: number;
+};
+//# sourceMappingURL=dynamic-context.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-context.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/dynamic-context.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,WAAW,cAAc;IAK3B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAM1B;;;;;;;;OAQG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;CACtE;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,cAAc,KAAG,OAAO,IAAI,cAAc,GAAG;IAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAEnH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,cAAc,KAAG,OAAO,IAAI,cAAc,GAAG;IAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAEzH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,UAAU,cAAc,KAAG,OAAO,IAAI,cAAc,GAAG;IAAE,gBAAgB,EAAE,MAAM,CAAA;CAEpH,CAAC"}

package/dist/cjs/shared-lib/interfaces/dynamic-context.interface.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasValidityDuration = exports.hasValidityEndDate = exports.hasValidityDate = void 0;
+/**
+ * Type guard to check if context has validity date
+ */
+const hasValidityDate = (context) => {
+    return !!context?.validityDate;
+};
+exports.hasValidityDate = hasValidityDate;
+/**
+ * Type guard to check if context has validity end date
+ */
+const hasValidityEndDate = (context) => {
+    return !!context?.validityEndDate;
+};
+exports.hasValidityEndDate = hasValidityEndDate;
+/**
+ * Type guard to check if context has validity duration
+ */
+const hasValidityDuration = (context) => {
+    return typeof context?.validityDuration === 'number' && context.validityDuration > 0;
+};
+exports.hasValidityDuration = hasValidityDuration;
+//# sourceMappingURL=dynamic-context.interface.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-context.interface.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/dynamic-context.interface.ts"],"names":[],"mappings":";;;AAyFA;;GAEG;AACI,MAAM,eAAe,GAAG,CAAC,OAAwB,EAA+D,EAAE;IACrH,OAAO,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC;AACnC,CAAC,CAAC;AAFW,QAAA,eAAe,mBAE1B;AAEF;;GAEG;AACI,MAAM,kBAAkB,GAAG,CAAC,OAAwB,EAAkE,EAAE;IAC3H,OAAO,CAAC,CAAC,OAAO,EAAE,eAAe,CAAC;AACtC,CAAC,CAAC;AAFW,QAAA,kBAAkB,sBAE7B;AAEF;;GAEG;AACI,MAAM,mBAAmB,GAAG,CAAC,OAAwB,EAA4D,EAAE;IACtH,OAAO,OAAO,OAAO,EAAE,gBAAgB,KAAK,QAAQ,IAAI,OAAO,CAAC,gBAAgB,GAAG,CAAC,CAAC;AACzF,CAAC,CAAC;AAFW,QAAA,mBAAmB,uBAE9B"}

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

@@ -19,6 +19,8 @@ export * from './counterfactual-wallet-response.interface';
 export * from './campaign';
 export * from './ai-prompt-config.interface';
 export * from './balance-filter-options.interface';
+export * from './dynamic-context.interface';
+export * from './trigger-source-metadata.interface';
 export * from './ws-relay.types';
 export * from './external-token-issuer.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;AAEnD,cAAc,kBAAkB,CAAC;AAEjC,cAAc,mCAAmC,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"}

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

@@ -36,6 +36,8 @@ __exportStar(require("./counterfactual-wallet-response.interface"), exports);
 __exportStar(require("./campaign"), exports);
 __exportStar(require("./ai-prompt-config.interface"), exports);
 __exportStar(require("./balance-filter-options.interface"), exports);
+__exportStar(require("./dynamic-context.interface"), exports);
+__exportStar(require("./trigger-source-metadata.interface"), exports);
 __exportStar(require("./ws-relay.types"), exports);
 __exportStar(require("./external-token-issuer.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;AAEnD,mDAAiC;AAEjC,oEAAkD"}
+{"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"}

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

@@ -4,6 +4,7 @@ import { Address } from "../value-objects";
 import { AccountOwnerType } from "../enum/owner-type.enum";
 import { NativeTokenType } from "../types";
 import { TransactionRole } from "../enum/transaction-role.enum";
+import type { DynamicContext } from "./dynamic-context.interface";
 export interface TxParticipant {
     /** Account identifier (user ID, business ID, etc.) */
     accountId?: string | null;
@@ -30,6 +31,18 @@ export interface ITokenTransactionInputData {
     overrideTokenName?: string;
     overrideTokenDescription?: string;
     customAttributes?: Record<string, any>;
+    /**
+     * **ERC721 only** - Admin-defined dynamic context from trigger source (QR code, NFC tag, etc.).
+     * Always applied to AI prompts as {{dynamic.xxx}} - trusted source.
+     * Also used for trigger-based validity (validityDate, validityEndDate, validityDuration).
+     */
+    dynamicContext?: DynamicContext;
+    /**
+     * **ERC721 only** - User-provided external context from claim request.
+     * Only applied if TokenMetadata.allowExternalContextOverwrite is true.
+     * Available in AI prompts as {{external.xxx}} when allowed.
+     */
+    externalContext?: DynamicContext;
     /** Business commercially involved in this transaction (for stats/reporting) */
     engagedBusinessId: string | null;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"token-transaction-input-data.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/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,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC1B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,sBAAsB;IACtB,WAAW,EAAE,gBAAgB,CAAC;IAE9B,iDAAiD;IACjD,cAAc,EAAE,OAAO,CAAC;IAExB,sCAAsC;IACtC,IAAI,EAAE,eAAe,CAAC;CACzB;AAGD,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,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,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;IAEvC,+EAA+E;IAC/E,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC"}
+{"version":3,"file":"token-transaction-input-data.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/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,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,aAAa;IAC1B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,sBAAsB;IACtB,WAAW,EAAE,gBAAgB,CAAC;IAE9B,iDAAiD;IACjD,cAAc,EAAE,OAAO,CAAC;IAExB,sCAAsC;IACtC,IAAI,EAAE,eAAe,CAAC;CACzB;AAGD,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,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,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;IAEvC;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;OAIG;IACH,eAAe,CAAC,EAAE,cAAc,CAAC;IAEjC,+EAA+E;IAC/E,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC"}

package/dist/cjs/shared-lib/interfaces/trigger-source-metadata.interface.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Token configuration override for trigger sources.
+ * Allows specific trigger sources (e.g., QR codes) to mint different token variants.
+ */
+export interface TriggerSourceTokenConfig {
+    /**
+     * Override the tokenMetadataIncrementalId for this trigger source.
+     * Useful for QR codes that mint specific token variants.
+     *
+     * @example '2' (mint token metadata ID 2 instead of campaign default)
+     */
+    tokenId?: string | number;
+}
+/**
+ * Trigger Source Metadata Interface
+ *
+ * Typed metadata structure for trigger sources (QR codes, NFC tags, etc.).
+ * Contains ONLY token configuration overrides.
+ *
+ * NOTE: Dynamic context is now at TriggerSource.context (top-level),
+ * consistent with CampaignClaimRequest.context API design.
+ *
+ * @example QR code with specific token variant
+ * ```typescript
+ * const metadata: TriggerSourceMetadata = {
+ *   tokenConfig: { tokenId: '2' },  // This QR mints token variant 2
+ * };
+ *
+ * // Context is now top-level:
+ * const triggerSource = {
+ *   metadata: { tokenConfig: { tokenId: '2' } },
+ *   context: { location: 'Main Lobby', deviceId: 'kiosk-001' }
+ * };
+ * ```
+ */
+export interface TriggerSourceMetadata {
+    /**
+     * Token configuration override.
+     * Allows this trigger source to mint a different token variant than campaign default.
+     */
+    tokenConfig?: TriggerSourceTokenConfig;
+    /**
+     * Additional arbitrary metadata for custom use cases.
+     * Not processed by the system - available for integrations.
+     */
+    [key: string]: any;
+}
+//# sourceMappingURL=trigger-source-metadata.interface.d.ts.map

package/dist/cjs/shared-lib/interfaces/trigger-source-metadata.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-source-metadata.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/trigger-source-metadata.interface.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,wBAAwB,CAAC;IAEvC;;;OAGG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB"}

package/dist/cjs/shared-lib/interfaces/trigger-source-metadata.interface.js

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

package/dist/cjs/shared-lib/interfaces/trigger-source-metadata.interface.js.map

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

package/dist/cjs/shared-lib/value-objects/token-transaction-entity-reference-input.vo.d.ts

@@ -2,6 +2,7 @@ import { Web3TransactionType } from '../enum/transaction-type.enum';
 import { AccountSelector } from '../../shared-lib/types/account-selector.type';
 import { AccountSelectorVo } from './account-selector.vo';
 import { AccountOwnerType } from '../enum';
+import type { DynamicContext } from '../interfaces/dynamic-context.interface';
 /**
  * Token Transaction Entity Reference Input VO
  *
@@ -29,6 +30,18 @@ export declare class TokenTransactionEntityReferenceInputVo {
     readonly overrideTokenName?: string;
     readonly overrideTokenDescription?: string;
     readonly customAttributes?: Record<string, any>;
+    /**
+     * **ERC721 only** - Admin-defined dynamic context from trigger source (QR code, NFC tag, etc.).
+     * Always applied to AI prompts as {{dynamic.xxx}} - trusted source.
+     * Also used for trigger-based validity (validityDate, validityEndDate, validityDuration).
+     */
+    readonly dynamicContext?: DynamicContext;
+    /**
+     * **ERC721 only** - User-provided external context from claim request.
+     * Only applied if TokenMetadata.allowExternalContextOverwrite is true.
+     * Available in AI prompts as {{external.xxx}} when allowed.
+     */
+    readonly externalContext?: DynamicContext;
     /** Business commercially involved in this transaction (for stats/reporting) */
     readonly engagedBusinessId: string | null;
     /** Entity authorized to submit this transaction (defaults to sender if not specified) */
@@ -48,6 +61,8 @@ export declare class TokenTransactionEntityReferenceInputVo {
         overrideTokenName?: string;
         overrideTokenDescription?: string;
         customAttributes?: Record<string, any>;
+        dynamicContext?: DynamicContext;
+        externalContext?: DynamicContext;
         engagedBusinessId: string | null;
         authorizedSubmitterId?: string | null;
         authorizedSubmitterType?: AccountOwnerType | null;
@@ -69,6 +84,8 @@ export declare class TokenTransactionEntityReferenceInputVo {
         overrideTokenName?: string;
         overrideTokenDescription?: string;
         customAttributes?: Record<string, any>;
+        dynamicContext?: DynamicContext;
+        externalContext?: DynamicContext;
         engagedBusinessId: string | null;
         authorizedSubmitterId: string | null;
         authorizedSubmitterType: AccountOwnerType | null;

package/dist/cjs/shared-lib/value-objects/token-transaction-entity-reference-input.vo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-transaction-entity-reference-input.vo.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/token-transaction-entity-reference-input.vo.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"token-transaction-entity-reference-input.vo.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/token-transaction-entity-reference-input.vo.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAC9E;;;;;;;;;GASG;AACH,qBAAa,sCAAsC;IAGjD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,SAEgB,aAAa,EAAE,MAAM,CAAC;IAEtC;;;OAGG;IAGI,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC,SAGgB,MAAM,EAAE,iBAAiB,CAAC;IAE1C,SAGgB,SAAS,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAErD,SAEgB,MAAM,EAAE,MAAM,CAAC;IAE/B,SAEgB,IAAI,EAAE,mBAAmB,CAAC;IAG1C,SAEgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElC,SAEgB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1C,SAEgB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3C,SAEgB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElD,SAEgB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEvD;;;;OAIG;IACH,SAEgB,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhD;;;;OAIG;IACH,SAEgB,eAAe,CAAC,EAAE,cAAc,CAAC;IAEjD,+EAA+E;IAC/E,SAEgB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjD,yFAAyF;IACzF,SAEgB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IAErD,2DAA2D;IAC3D,SAEgB,uBAAuB,EAAE,gBAAgB,GAAG,IAAI,CAAC;gBAErD,IAAI,EAAE;QAChB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,MAAM,EAAE,eAAe,CAAC;QACxB,SAAS,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;QACnC,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,mBAAmB,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACvC,cAAc,CAAC,EAAE,cAAc,CAAC;QAChC,eAAe,CAAC,EAAE,cAAc,CAAC;QACjC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtC,uBAAuB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;KACnD;IAwBD,OAAO,CAAC,qBAAqB;IAI7B;;OAEG;IACH,iBAAiB,IAAI;QACnB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,MAAM,EAAE,eAAe,CAAC;QACxB,SAAS,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;QACnC,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,mBAAmB,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACvC,cAAc,CAAC,EAAE,cAAc,CAAC;QAChC,eAAe,CAAC,EAAE,cAAc,CAAC;QACjC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;QACrC,uBAAuB,EAAE,gBAAgB,GAAG,IAAI,CAAC;KAClD;CAqBF"}

package/dist/cjs/shared-lib/value-objects/token-transaction-entity-reference-input.vo.js

@@ -43,6 +43,18 @@ class TokenTransactionEntityReferenceInputVo {
     overrideTokenName;
     overrideTokenDescription;
     customAttributes;
+    /**
+     * **ERC721 only** - Admin-defined dynamic context from trigger source (QR code, NFC tag, etc.).
+     * Always applied to AI prompts as {{dynamic.xxx}} - trusted source.
+     * Also used for trigger-based validity (validityDate, validityEndDate, validityDuration).
+     */
+    dynamicContext;
+    /**
+     * **ERC721 only** - User-provided external context from claim request.
+     * Only applied if TokenMetadata.allowExternalContextOverwrite is true.
+     * Available in AI prompts as {{external.xxx}} when allowed.
+     */
+    externalContext;
     /** Business commercially involved in this transaction (for stats/reporting) */
     engagedBusinessId;
     /** Entity authorized to submit this transaction (defaults to sender if not specified) */
@@ -63,6 +75,8 @@ class TokenTransactionEntityReferenceInputVo {
         this.overrideTokenName = data.overrideTokenName;
         this.overrideTokenDescription = data.overrideTokenDescription;
         this.customAttributes = data.customAttributes;
+        this.dynamicContext = data.dynamicContext;
+        this.externalContext = data.externalContext;
         this.engagedBusinessId = data.engagedBusinessId ?? null;
         this.authorizedSubmitterId = data.authorizedSubmitterId ?? null;
         this.authorizedSubmitterType = data.authorizedSubmitterType ?? null;
@@ -88,6 +102,8 @@ class TokenTransactionEntityReferenceInputVo {
             overrideTokenName: this.overrideTokenName,
             overrideTokenDescription: this.overrideTokenDescription,
             customAttributes: this.customAttributes,
+            dynamicContext: this.dynamicContext,
+            externalContext: this.externalContext,
             engagedBusinessId: this.engagedBusinessId,
             authorizedSubmitterId: this.authorizedSubmitterId,
             authorizedSubmitterType: this.authorizedSubmitterType
@@ -159,6 +175,16 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", Object)
 ], TokenTransactionEntityReferenceInputVo.prototype, "customAttributes", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], TokenTransactionEntityReferenceInputVo.prototype, "dynamicContext", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], TokenTransactionEntityReferenceInputVo.prototype, "externalContext", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),

package/dist/cjs/shared-lib/value-objects/token-transaction-entity-reference-input.vo.js.map

@@ -1 +1 @@
-{"version":3,"file":"token-transaction-entity-reference-input.vo.js","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/token-transaction-entity-reference-input.vo.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAA+G;AAC/G,yDAAyC;AAEzC,yEAAoE;AAEpE,+DAA0D;AAC1D,kCAA2C;AAC3C;;;;;;;;;GASG;AACH,MAAa,sCAAsC;IAGjD,aAAa,CAAgB;IAIb,aAAa,CAAS,CAAC,qEAAqE;IAE5G;;;OAGG;IAGI,eAAe,CAAgB;IAKtB,MAAM,CAAoB;IAK1B,SAAS,CAA4B,CAAC,oCAAoC;IAI1E,MAAM,CAAS;IAIf,IAAI,CAAsB;IAE1C,2DAA2D;IAG3C,QAAQ,CAAU;IAIlB,gBAAgB,CAAU;IAI1B,iBAAiB,CAAU;IAI3B,wBAAwB,CAAU;IAIlC,gBAAgB,CAAuB;IAEvD,+EAA+E;IAG/D,iBAAiB,CAAgB;IAEjD,yFAAyF;IAGzE,qBAAqB,CAAgB;IAErD,2DAA2D;IAG3C,uBAAuB,CAA0B;IAEjE,YAAY,IAgBX;QACC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC;QAChD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;QACpD,IAAI,CAAC,MAAM,GAAG,IAAI,uCAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,uCAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/E,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAElB,yBAAyB;QAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC9C,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAChD,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAC,wBAAwB,CAAC;QAC9D,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC9C,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC;QACxD,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,qBAAqB,IAAI,IAAI,CAAC;QAChE,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC,uBAAuB,IAAI,IAAI,CAAC;QAEpE,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC/B,CAAC;IAEO,qBAAqB;QAC3B,qCAAqC;IACvC,CAAC;IAED;;OAEG;IACH,iBAAiB;QAiBf,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE;YACvC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,IAAI;YACrE,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,wBAAwB,EAAE,IAAI,CAAC,wBAAwB;YACvD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;YACjD,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;SACtD,CAAC;IACJ,CAAC;CACF;AAvJD,wFAuJC;AApJC;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;6EACgB;AAIb;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;6EACyB;AAQ/B;IAFN,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;+EACyB;AAKtB;IAHf,IAAA,4BAAU,GAAE;IACZ,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,uCAAiB,CAAC,CAAC,qCAAqC;;8BAC5C,uCAAiB;sEAAC;AAK1B;IAHf,IAAA,4BAAU,GAAE;IACZ,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,uCAAiB,CAAC,CAAC,qCAAqC;;;yEACf;AAIrC;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;sEACkB;AAIf;IAFf,IAAA,wBAAM,EAAC,2CAAmB,CAAC;IAC3B,IAAA,4BAAU,GAAE;;oEAC6B;AAK1B;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;wEACqB;AAIlB;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;gFAC6B;AAI1B;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;iFAC8B;AAI3B;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;wFACqC;AAIlC;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;gFAC0C;AAKvC;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;iFACoC;AAKjC;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;qFACwC;AAKrC;IAFf,IAAA,wBAAM,EAAC,uBAAgB,CAAC;IACxB,IAAA,4BAAU,GAAE;;uFACoD"}
+{"version":3,"file":"token-transaction-entity-reference-input.vo.js","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/token-transaction-entity-reference-input.vo.ts"],"names":[],"mappings":"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"}

package/dist/cjs/shared-lib/value-objects/token-transaction-input.vo.d.ts

@@ -3,6 +3,7 @@ import { Web3TransactionType } from '../enum/transaction-type.enum';
 import { Address } from './address.value-object';
 import { type ITokenTransactionInputData, type TxParticipant } from '../interfaces/token-transaction-input-data.interface';
 import { type NativeTokenType } from '../types/native-token.type';
+import type { DynamicContext } from '../interfaces/dynamic-context.interface';
 export declare class TokenTransactionInputDataVo implements ITokenTransactionInputData {
     transactionId: string | null;
     readonly chainId: number;
@@ -23,6 +24,18 @@ export declare class TokenTransactionInputDataVo implements ITokenTransactionInp
     readonly overrideTokenName?: string;
     readonly overrideTokenDescription?: string;
     readonly customAttributes?: Record<string, any>;
+    /**
+     * **ERC721 only** - Admin-defined dynamic context from trigger source (QR code, NFC tag, etc.).
+     * Always applied to AI prompts as {{dynamic.xxx}} - trusted source.
+     * Also used for trigger-based validity (validityDate, validityEndDate, validityDuration).
+     */
+    readonly dynamicContext?: DynamicContext;
+    /**
+     * **ERC721 only** - User-provided external context from claim request.
+     * Only applied if TokenMetadata.allowExternalContextOverwrite is true.
+     * Available in AI prompts as {{external.xxx}} when allowed.
+     */
+    readonly externalContext?: DynamicContext;
     /** Business commercially involved in this transaction (for stats/reporting) */
     readonly engagedBusinessId: string | null;
     constructor(data: ITokenTransactionInputData);

package/dist/cjs/shared-lib/value-objects/token-transaction-input.vo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-transaction-input.vo.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/token-transaction-input.vo.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,KAAK,0BAA0B,EAAE,KAAK,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAC3H,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,qBAAa,2BAA4B,YAAW,0BAA0B;IAG5E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,SAEgB,OAAO,EAAE,MAAM,CAAC;IAEhC,SAIgB,oBAAoB,EAAE,OAAO,CAAC;IAE9C,SACgB,WAAW,EAAE,WAAW,CAAC;IAGzC,SAGgB,MAAM,EAAE,aAAa,CAAC;IAEtC,SAIgB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5C;;;OAGG;IAGI,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC,SAEgB,MAAM,EAAE,MAAM,CAAC;IAE/B,SAEgB,IAAI,EAAE,mBAAmB,CAAC;IAC1C,SACgB,SAAS,EAAE,eAAe,CAAC;IAI3C,SAEgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElC,SAEgB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1C,SAEgB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3C,SAEgB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElD,SAEgB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEvD,+EAA+E;IAC/E,SAAgB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;gBAErC,IAAI,EAAE,0BAA0B;CAgC7C"}
+{"version":3,"file":"token-transaction-input.vo.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/token-transaction-input.vo.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,KAAK,0BAA0B,EAAE,KAAK,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAC3H,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAE9E,qBAAa,2BAA4B,YAAW,0BAA0B;IAG5E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,SAEgB,OAAO,EAAE,MAAM,CAAC;IAEhC,SAIgB,oBAAoB,EAAE,OAAO,CAAC;IAE9C,SACgB,WAAW,EAAE,WAAW,CAAC;IAGzC,SAGgB,MAAM,EAAE,aAAa,CAAC;IAEtC,SAIgB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5C;;;OAGG;IAGI,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC,SAEgB,MAAM,EAAE,MAAM,CAAC;IAE/B,SAEgB,IAAI,EAAE,mBAAmB,CAAC;IAC1C,SACgB,SAAS,EAAE,eAAe,CAAC;IAI3C,SAEgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElC,SAEgB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1C,SAEgB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3C,SAEgB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElD,SAEgB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEvD;;;;OAIG;IACH,SAEgB,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhD;;;;OAIG;IACH,SAEgB,eAAe,CAAC,EAAE,cAAc,CAAC;IAEjD,+EAA+E;IAC/E,SAAgB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;gBAErC,IAAI,EAAE,0BAA0B;CAkC7C"}

package/dist/cjs/shared-lib/value-objects/token-transaction-input.vo.js

@@ -37,6 +37,18 @@ class TokenTransactionInputDataVo {
     overrideTokenName;
     overrideTokenDescription;
     customAttributes;
+    /**
+     * **ERC721 only** - Admin-defined dynamic context from trigger source (QR code, NFC tag, etc.).
+     * Always applied to AI prompts as {{dynamic.xxx}} - trusted source.
+     * Also used for trigger-based validity (validityDate, validityEndDate, validityDuration).
+     */
+    dynamicContext;
+    /**
+     * **ERC721 only** - User-provided external context from claim request.
+     * Only applied if TokenMetadata.allowExternalContextOverwrite is true.
+     * Available in AI prompts as {{external.xxx}} when allowed.
+     */
+    externalContext;
     /** Business commercially involved in this transaction (for stats/reporting) */
     engagedBusinessId;
     constructor(data) {
@@ -56,6 +68,8 @@ class TokenTransactionInputDataVo {
         this.overrideTokenName = data.overrideTokenName;
         this.overrideTokenDescription = data.overrideTokenDescription;
         this.customAttributes = data.customAttributes;
+        this.dynamicContext = data.dynamicContext;
+        this.externalContext = data.externalContext;
         this.engagedBusinessId = data.engagedBusinessId;
         // Basic validation (can be enhanced with class-validator if this VO is used in DTOs that are validated)
         if (this.amount <= 0 && this.type) {
@@ -152,4 +166,14 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", Object)
 ], TokenTransactionInputDataVo.prototype, "customAttributes", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], TokenTransactionInputDataVo.prototype, "dynamicContext", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], TokenTransactionInputDataVo.prototype, "externalContext", void 0);
 //# sourceMappingURL=token-transaction-input.vo.js.map

package/dist/cjs/shared-lib/value-objects/token-transaction-input.vo.js.map

@@ -1 +1 @@
-{"version":3,"file":"token-transaction-input.vo.js","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/token-transaction-input.vo.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAwH;AACxH,yDAAyC;AAEzC,yEAAoE;AACpE,iEAAiD;AAIjD,MAAa,2BAA2B;IAGtC,aAAa,CAAgB;IAIb,OAAO,CAAS;IAMhB,oBAAoB,CAAU;IAG9B,WAAW,CAAc;IAEzC,cAAc;IAIE,MAAM,CAAgB;IAMtB,UAAU,CAAkB;IAC5C;;;OAGG;IAGI,eAAe,CAAgB;IAItB,MAAM,CAAS;IAIf,IAAI,CAAsB,CAAA,sCAAsC;IAEhE,SAAS,CAAkB,CAAC,sCAAsC;IAClF,8CAA8C;IAE9C,2DAA2D;IAG3C,QAAQ,CAAU;IAIlB,gBAAgB,CAAU;IAI1B,iBAAiB,CAAU;IAI3B,wBAAwB,CAAU;IAIlC,gBAAgB,CAAuB;IAEvD,+EAA+E;IAC/D,iBAAiB,CAAgB;IAEjD,YAAY,IAAgC;QAE1C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAC,CAAC,mEAAmE;QAC1H,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAEhC,6BAA6B;QAC7B,IAAI,CAAC,QAAQ,GAAG,wCAAwC,CAAC,IAAI,CAAC,QAAQ,CAAC;QACvE,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC9C,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAChD,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAC,wBAAwB,CAAC;QAC9D,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC9C,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAEhD,wGAAwG;QACxG,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,2CAAmB,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YAC/F,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;CACF;AAxGD,kEAwGC;AArGC;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;kEACgB;AAIb;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;4DACmB;AAMhB;IAJf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;IACZ,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,8BAAO,CAAC,CAAC,uFAAuF;;8BACtE,8BAAO;yEAAC;AAG9B;IADf,IAAA,4BAAU,GAAE,CAAC,gDAAgD;;;gEACrB;AAMzB;IAHf,IAAA,4BAAU,GAAE;IACZ,IAAA,gCAAc,GAAE;IACjB,8BAA8B;;;2DACQ;AAMtB;IAJf,IAAA,4BAAU,GAAE;IACZ,IAAA,gCAAc,GAAE;IAChB,IAAA,yBAAO,GAAE;IACV,8BAA8B;;;+DACc;AAOrC;IAFN,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;oEACyB;AAItB;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;2DACkB;AAIf;IAFf,IAAA,wBAAM,EAAC,2CAAmB,CAAC;IAC3B,IAAA,4BAAU,GAAE;;yDAC6B;AAE1B;IADf,IAAA,4BAAU,GAAE;;8DAC8B;AAM3B;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;6DACqB;AAIlB;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;qEAC6B;AAI1B;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;sEAC8B;AAI3B;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;6EACqC;AAIlC;IAFf,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;qEAC0C"}
+{"version":3,"file":"token-transaction-input.vo.js","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/token-transaction-input.vo.ts"],"names":[],"mappings":"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"}

package/dist/cjs/shared-patterns/functions/token-metadata.functions.d.ts

@@ -6,6 +6,7 @@
  */
 import { type TokenValidityType } from '../../shared-lib/enum/token-validity-type.enum';
 import { TokenStorageData } from '../../shared-lib/interfaces/token-storage-data.interface';
+import type { DynamicContext } from '../../shared-lib/interfaces/dynamic-context.interface';
 /**
  * Checks if a token ID is a URI (IPFS or HTTP).
  * Used for determining how to resolve token metadata.
@@ -18,12 +19,20 @@ export declare const checkIfTokenIdIsUri: (tokenId: string | null) => boolean;
  * Computes the expiry date based on validity configuration.
  *
  * @param validityType - The type of validity calculation
- * @param validityDuration - Duration in days or hours (for relative types)
+ * @param validityDuration - Duration in days or hours (for relative types) - can be overridden by triggerDuration
  * @param fixedExpiryDate - Fixed expiry date (for fixed_date type)
  * @param issuanceDate - The date of issuance (defaults to now)
+ * @param triggerContext - Runtime context for trigger-based types:
+ *   - triggerDate: Base date (e.g., check-in date) for TRIGGER_DATE, DAYS_FROM_TRIGGER
+ *   - triggerEndDate: End date (e.g., check-out date) for TRIGGER_DATE_RANGE
+ *   - triggerDuration: Dynamic duration override for DAYS_FROM_TRIGGER, HOURS_FROM_TRIGGER
  * @returns The computed expiry date, or undefined if no validity is configured
  */
-export declare const computeExpiryDate: (validityType?: TokenValidityType, validityDuration?: number, fixedExpiryDate?: Date, issuanceDate?: Date) => Date | undefined;
+export declare const computeExpiryDate: (validityType?: TokenValidityType, validityDuration?: number, fixedExpiryDate?: Date, issuanceDate?: Date, triggerContext?: {
+    triggerDate?: Date;
+    triggerEndDate?: Date;
+    triggerDuration?: number;
+}) => Date | undefined;
 /**
  * Checks if a token has expired based on its expiry date.
  *
@@ -69,4 +78,31 @@ export declare const extractTagsFromMetadata: (metadata: TokenStorageData | null
  * extractBusinessIdsFromMetadata(metadata); // Returns ['uuid-1', 'uuid-2']
  */
 export declare const extractBusinessIdsFromMetadata: (metadata: TokenStorageData | null) => string[];
+/**
+ * Merges dynamic and external contexts with security enforcement.
+ * This is a DOMAIN RULE - enforces trust levels for context injection.
+ *
+ * Trust levels:
+ * - dynamicContext: Admin-controlled (QR/NFC) → ALWAYS applied
+ * - externalContext: User request → ONLY if allowExternalContextOverwrite=true
+ *
+ * This function should be used by any code that needs to merge contexts
+ * for ERC721 token generation, ensuring consistent security enforcement.
+ *
+ * @param allowExternalContextOverwrite - Whether user-provided external context is allowed (from TokenMetadata)
+ * @param dynamicContext - Admin-controlled context (always trusted)
+ * @param externalContext - User-provided context (requires explicit opt-in)
+ * @returns Merged context or undefined if empty
+ *
+ * @example
+ * // Admin context only (user context not allowed)
+ * mergeContexts(false, { location: 'Lobby' }, { hack: 'attempt' })
+ * // Returns: { location: 'Lobby' }
+ *
+ * @example
+ * // Both contexts merged (user context allowed)
+ * mergeContexts(true, { location: 'Lobby' }, { guestName: 'John' })
+ * // Returns: { location: 'Lobby', guestName: 'John' }
+ */
+export declare const mergeContexts: (allowExternalContextOverwrite: boolean, dynamicContext?: DynamicContext, externalContext?: DynamicContext) => DynamicContext | undefined;
 //# sourceMappingURL=token-metadata.functions.d.ts.map

package/dist/cjs/shared-patterns/functions/token-metadata.functions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-metadata.functions.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/functions/token-metadata.functions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAkC,MAAM,0DAA0D,CAAC;AAE5H;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,GAAG,IAAI,KAAG,OAM5D,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,eAAe,iBAAiB,EAChC,mBAAmB,MAAM,EACzB,kBAAkB,IAAI,EACtB,eAAc,IAAiB,KAC9B,IAAI,GAAG,SA6CT,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,aAAa,IAAI,GAAG,IAAI,EACxB,gBAAe,IAAiB,KAC/B,OAAO,GAAG,SAGZ,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,6BAA6B,GAAI,UAAU,gBAAgB,GAAG,IAAI,KAAG,IAAI,GAAG,IAaxF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,GAAI,UAAU,gBAAgB,GAAG,IAAI,KAAG,MAAM,EAiBjF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,8BAA8B,GAAI,UAAU,gBAAgB,GAAG,IAAI,KAAG,MAAM,EAmBxF,CAAA"}
+{"version":3,"file":"token-metadata.functions.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/functions/token-metadata.functions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAkC,MAAM,0DAA0D,CAAC;AAC5H,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAC;AAE5F;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,GAAG,IAAI,KAAG,OAM5D,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,GAC5B,eAAe,iBAAiB,EAChC,mBAAmB,MAAM,EACzB,kBAAkB,IAAI,EACtB,eAAc,IAAiB,EAC/B,iBAAiB;IACf,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,KACA,IAAI,GAAG,SAuET,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,aAAa,IAAI,GAAG,IAAI,EACxB,gBAAe,IAAiB,KAC/B,OAAO,GAAG,SAGZ,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,6BAA6B,GAAI,UAAU,gBAAgB,GAAG,IAAI,KAAG,IAAI,GAAG,IAaxF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,GAAI,UAAU,gBAAgB,GAAG,IAAI,KAAG,MAAM,EAiBjF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,8BAA8B,GAAI,UAAU,gBAAgB,GAAG,IAAI,KAAG,MAAM,EAmBxF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,aAAa,GACxB,+BAA+B,OAAO,EACtC,iBAAiB,cAAc,EAC/B,kBAAkB,cAAc,KAC/B,cAAc,GAAG,SAanB,CAAA"}