@explorins/pers-shared 2.1.121 → 2.1.123

package/dist/esm/shared-lib/dto/tenant/tenantUpdate.request.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tenantUpdate.request.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/tenant/tenantUpdate.request.dto.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAElF,qBAAa,sBAAsB;IAO/B,WAAW,CAAC,EAAE,MAAM,CAAA;IAMpB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAI3B,YAAY,CAAC,EAAE,MAAM,CAAA;IAIrB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAI5B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAI7B,UAAU,CAAC,EAAE,MAAM,CAAA;IAQnB,+BAA+B,CAAC,EAAE,OAAO,CAAA;IAIzC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAWzB,cAAc,CAAC,EAAE,MAAM,CAAA;IAKvB,YAAY,CAAC,EAAE,MAAM,CAAA;IAKrB,eAAe,CAAC,EAAE,MAAM,CAAA;IAUxB,mBAAmB,CAAC,EAAE,4BAA4B,EAAE,CAAA;CACrD"}
+{"version":3,"file":"tenantUpdate.request.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/tenant/tenantUpdate.request.dto.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAElF,qBAAa,sBAAsB;IAO/B,WAAW,CAAC,EAAE,MAAM,CAAA;IAMpB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAI3B,YAAY,CAAC,EAAE,MAAM,CAAA;IAIrB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAI5B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAI7B,UAAU,CAAC,EAAE,MAAM,CAAA;IAQnB,+BAA+B,CAAC,EAAE,OAAO,CAAA;IAIzC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAWzB,cAAc,CAAC,EAAE,MAAM,CAAA;IAKvB,YAAY,CAAC,EAAE,MAAM,CAAA;IAKrB,eAAe,CAAC,EAAE,MAAM,CAAA;IAOxB,cAAc,CAAC,EAAE,MAAM,CAAA;IAUvB,mBAAmB,CAAC,EAAE,4BAA4B,EAAE,CAAA;CACrD"}

package/dist/esm/shared-lib/dto/tenant/tenantUpdate.request.dto.js

@@ -25,6 +25,7 @@ export class TenantUpdateRequestDTO {
     projectWebsite;
     projectEmail;
     projectImageUrl;
+    projectLogoUrl;
     allowedTokenIssuers;
 }
 __decorate([
@@ -83,6 +84,13 @@ __decorate([
     OptionalNullify(),
     IsUrl()
 ], TenantUpdateRequestDTO.prototype, "projectImageUrl", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Logo URL for the project (smaller icon/avatar)',
+    }),
+    OptionalNullify(),
+    IsUrl()
+], TenantUpdateRequestDTO.prototype, "projectLogoUrl", void 0);
 __decorate([
     ApiPropertyOptional({
         description: 'List of allowed external JWT token issuers for this tenant. Each object must have an issuer URL.',

package/dist/esm/shared-lib/dto/tenant/tenantUpdate.request.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"tenantUpdate.request.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/tenant/tenantUpdate.request.dto.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAElF,MAAM,OAAO,sBAAsB;IAO/B,WAAW,CAAS;IAMpB,kBAAkB,CAAS;IAI3B,YAAY,CAAS;IAIrB,mBAAmB,CAAS;IAI5B,oBAAoB,CAAS;IAI7B,UAAU,CAAS;IAQnB,+BAA+B,CAAU;IAIzC,gBAAgB,CAAS;IAEzB;kCAC8B;IAE9B;kCAC8B;IAK9B,cAAc,CAAS;IAKvB,YAAY,CAAS;IAKrB,eAAe,CAAS;IAUxB,mBAAmB,CAAiC;CACrD;AAlEC;IALC,mBAAmB,CAAC;QACnB,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,YAAY;KACtB,CAAC;IACD,eAAe,EAAE;2DACE;AAMpB;IAJC,mBAAmB,CAAC;QACnB,WAAW,EAAE,yBAAyB;KACvC,CAAC;IACD,eAAe,EAAE;kEACS;AAI3B;IAFC,mBAAmB,EAAE;IACrB,eAAe,EAAE;4DACG;AAIrB;IAFC,mBAAmB,EAAE;IACrB,eAAe,EAAE;mEACU;AAI5B;IAFC,mBAAmB,EAAE;IACrB,eAAe,EAAE;oEACW;AAI7B;IAFC,mBAAmB,EAAE;IACrB,eAAe,EAAE;0DACC;AAQnB;IANC,mBAAmB,CAAC;QACnB,WAAW,EAAE,4EAA4E;QACzF,IAAI,EAAE,OAAO;KACd,CAAC;IACD,eAAe,EAAE;IACjB,SAAS,EAAE;+EAC6B;AAIzC;IAFC,mBAAmB,EAAE;IACrB,eAAe,EAAE;gEACO;AAWzB;IAHC,mBAAmB,EAAE;IACrB,eAAe,EAAE;IACjB,KAAK,EAAE;8DACe;AAKvB;IAHC,mBAAmB,EAAE;IACrB,eAAe,EAAE;IACjB,OAAO,EAAE;4DACW;AAKrB;IAHC,mBAAmB,EAAE;IACrB,eAAe,EAAE;IACjB,KAAK,EAAE;+DACgB;AAUxB;IARC,mBAAmB,CAAC;QACnB,WAAW,EAAE,kGAAkG;QAC/G,IAAI,EAAE,CAAC,4BAA4B,CAAC;KACrC,CAAC;IACD,eAAe,EAAE;IACjB,OAAO,EAAE;IACT,cAAc,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG,EAAE,CAAC,4BAA4B,CAAC;mEACW"}
+{"version":3,"file":"tenantUpdate.request.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/tenant/tenantUpdate.request.dto.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAElF,MAAM,OAAO,sBAAsB;IAO/B,WAAW,CAAS;IAMpB,kBAAkB,CAAS;IAI3B,YAAY,CAAS;IAIrB,mBAAmB,CAAS;IAI5B,oBAAoB,CAAS;IAI7B,UAAU,CAAS;IAQnB,+BAA+B,CAAU;IAIzC,gBAAgB,CAAS;IAEzB;kCAC8B;IAE9B;kCAC8B;IAK9B,cAAc,CAAS;IAKvB,YAAY,CAAS;IAKrB,eAAe,CAAS;IAOxB,cAAc,CAAS;IAUvB,mBAAmB,CAAiC;CACrD;AAzEC;IALC,mBAAmB,CAAC;QACnB,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,YAAY;KACtB,CAAC;IACD,eAAe,EAAE;2DACE;AAMpB;IAJC,mBAAmB,CAAC;QACnB,WAAW,EAAE,yBAAyB;KACvC,CAAC;IACD,eAAe,EAAE;kEACS;AAI3B;IAFC,mBAAmB,EAAE;IACrB,eAAe,EAAE;4DACG;AAIrB;IAFC,mBAAmB,EAAE;IACrB,eAAe,EAAE;mEACU;AAI5B;IAFC,mBAAmB,EAAE;IACrB,eAAe,EAAE;oEACW;AAI7B;IAFC,mBAAmB,EAAE;IACrB,eAAe,EAAE;0DACC;AAQnB;IANC,mBAAmB,CAAC;QACnB,WAAW,EAAE,4EAA4E;QACzF,IAAI,EAAE,OAAO;KACd,CAAC;IACD,eAAe,EAAE;IACjB,SAAS,EAAE;+EAC6B;AAIzC;IAFC,mBAAmB,EAAE;IACrB,eAAe,EAAE;gEACO;AAWzB;IAHC,mBAAmB,EAAE;IACrB,eAAe,EAAE;IACjB,KAAK,EAAE;8DACe;AAKvB;IAHC,mBAAmB,EAAE;IACrB,eAAe,EAAE;IACjB,OAAO,EAAE;4DACW;AAKrB;IAHC,mBAAmB,EAAE;IACrB,eAAe,EAAE;IACjB,KAAK,EAAE;+DACgB;AAOxB;IALC,mBAAmB,CAAC;QACnB,WAAW,EAAE,gDAAgD;KAC9D,CAAC;IACD,eAAe,EAAE;IACjB,KAAK,EAAE;8DACe;AAUvB;IARC,mBAAmB,CAAC;QACnB,WAAW,EAAE,kGAAkG;QAC/G,IAAI,EAAE,CAAC,4BAA4B,CAAC;KACrC,CAAC;IACD,eAAe,EAAE;IACjB,OAAO,EAAE;IACT,cAAc,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG,EAAE,CAAC,4BAA4B,CAAC;mEACW"}

package/dist/esm/shared-lib/dto/token/token-metadata.dto.d.ts

@@ -1,5 +1,6 @@
 import { type TokenValidityType } from '../../enum/token-validity-type.enum';
 import { AiPromptConfigDTO } from '../ai/ai-prompt-config.dto';
+import type { DynamicContext } from '../../interfaces/dynamic-context.interface';
 /**
  * Token Metadata - NFT Template/Blueprint
  *
@@ -36,6 +37,8 @@ export declare class TokenMetadataCreateRequestDTO {
     previewUrl?: string;
     tags?: string[];
     aiPromptConfigs?: AiPromptConfigDTO[];
+    allowExternalContextOverwrite?: boolean;
+    defaultPromptContext?: DynamicContext;
     businessIds?: string[];
 }
 export declare class TokenMetadataDTO extends TokenMetadataCreateRequestDTO {

package/dist/esm/shared-lib/dto/token/token-metadata.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-metadata.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/token/token-metadata.dto.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,6BAA6B;IAOtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAOlB,WAAW,CAAC,EAAE,MAAM,CAAC;IAOrB,WAAW,CAAC,EAAE,MAAM,CAAA;IAOpB,IAAI,CAAC,EAAE,MAAM,CAAA;IASb,YAAY,CAAC,EAAE,iBAAiB,CAAA;IAQhC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAOzB,UAAU,CAAC,EAAE,IAAI,CAAA;IAOjB,YAAY,CAAC,EAAE,MAAM,CAAA;IAOrB,UAAU,CAAC,EAAE,MAAM,CAAA;IAOnB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAO9B,UAAU,CAAC,EAAE,MAAM,CAAC;IAUpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAchB,eAAe,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAUtC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAGD,qBAAa,gBAAiB,SAAQ,6BAA6B;IAK/D,EAAE,EAAE,MAAM,CAAK;IAKf,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAKhC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAK7B,cAAc,CAAC,EAAE,MAAM,CAAA;IAKvB,0BAA0B,EAAE,MAAM,CAAK;IAKvC,QAAQ,EAAE,OAAO,CAAS;IAO1B,IAAI,EAAE,MAAM,EAAE,CAAM;IAOpB,WAAW,EAAE,MAAM,EAAE,CAAM;CAC9B"}
+{"version":3,"file":"token-metadata.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/token/token-metadata.dto.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,6BAA6B;IAOtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAOlB,WAAW,CAAC,EAAE,MAAM,CAAC;IAmBrB,WAAW,CAAC,EAAE,MAAM,CAAA;IAmBpB,IAAI,CAAC,EAAE,MAAM,CAAA;IASb,YAAY,CAAC,EAAE,iBAAiB,CAAA;IAQhC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAOzB,UAAU,CAAC,EAAE,IAAI,CAAA;IAOjB,YAAY,CAAC,EAAE,MAAM,CAAA;IAOrB,UAAU,CAAC,EAAE,MAAM,CAAA;IAOnB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAO9B,UAAU,CAAC,EAAE,MAAM,CAAC;IAUpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAoBhB,eAAe,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAetC,6BAA6B,CAAC,EAAE,OAAO,CAAC;IAaxC,oBAAoB,CAAC,EAAE,cAAc,CAAC;IAUtC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAGD,qBAAa,gBAAiB,SAAQ,6BAA6B;IAK/D,EAAE,EAAE,MAAM,CAAK;IAKf,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAKhC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAK7B,cAAc,CAAC,EAAE,MAAM,CAAA;IAKvB,0BAA0B,EAAE,MAAM,CAAK;IAKvC,QAAQ,EAAE,OAAO,CAAS;IAO1B,IAAI,EAAE,MAAM,EAAE,CAAM;IAOpB,WAAW,EAAE,MAAM,EAAE,CAAM;CAC9B"}

package/dist/esm/shared-lib/dto/token/token-metadata.dto.js

@@ -5,7 +5,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
-import { IsUrl, IsString, IsDateString, IsEnum, IsNumber, IsArray, ValidateNested } from 'class-validator';
+import { IsUrl, IsString, IsDateString, IsEnum, IsNumber, IsArray, ValidateNested, IsObject } from 'class-validator';
 import { Type } from 'class-transformer';
 import { OptionalStrip, OptionalStripNumber } from '../../decorators/index.js';
 import { TokenValidityTypes } from '../../enum/token-validity-type.enum.js';
@@ -46,6 +46,8 @@ export class TokenMetadataCreateRequestDTO {
     previewUrl;
     tags;
     aiPromptConfigs;
+    allowExternalContextOverwrite;
+    defaultPromptContext;
     businessIds;
 }
 __decorate([
@@ -64,14 +66,38 @@ __decorate([
 ], TokenMetadataCreateRequestDTO.prototype, "externalUrl", void 0);
 __decorate([
     ApiPropertyOptional({
-        description: 'A human-readable description of the item. Markdown is supported.'
+        description: `A human-readable description of the item. Markdown is supported.
+
+**ERC721 Template Interpolation:** Supports \`{{placeholder}}\` syntax for dynamic personalization at mint time (without AI costs).
+
+**Available placeholders:**
+- \`{{user.firstName}}\`, \`{{user.lastName}}\` - User data
+- \`{{campaign.name}}\`, \`{{business.displayName}}\` - Campaign/business
+- \`{{context.xxx}}\` - Dynamic context values (TriggerSource.context or claim request)
+- \`{{defaults.xxx}}\` - Default values from defaultPromptContext
+
+**Example:** \`"Thank you {{user.firstName}} for visiting {{business.displayName}}! Your exclusive reward for {{context.eventName}}."\`
+
+**Processing order:** Template interpolation runs first, then AI processing (if configured) can further enhance the result.`
     }),
     OptionalStrip(),
     IsString()
 ], TokenMetadataCreateRequestDTO.prototype, "description", void 0);
 __decorate([
     ApiPropertyOptional({
-        description: 'Name of the item.'
+        description: `Name of the item.
+
+**ERC721 Template Interpolation:** Supports \`{{placeholder}}\` syntax for dynamic personalization at mint time (without AI costs).
+
+**Available placeholders:**
+- \`{{user.firstName}}\`, \`{{user.lastName}}\` - User data
+- \`{{campaign.name}}\`, \`{{business.displayName}}\` - Campaign/business
+- \`{{context.xxx}}\` - Dynamic context values (TriggerSource.context or claim request)
+- \`{{defaults.xxx}}\` - Default values from defaultPromptContext
+
+**Example:** \`"Welcome {{context.guestName}} - VIP Pass"\` or \`"{{user.firstName}}'s {{campaign.name}} Reward"\`
+
+**Processing order:** Template interpolation runs first, then AI processing (if configured) can further enhance the result.`
     }),
     OptionalStrip(),
     IsString()
@@ -140,11 +166,17 @@ __decorate([
 ], TokenMetadataCreateRequestDTO.prototype, "tags", void 0);
 __decorate([
     ApiPropertyOptional({
-        description: '**ERC721 only** - AI prompt configurations for dynamic content generation at mint time. Results are mapped by key to override static fields (name, description, imageUrl). Ignored for ERC1155 tokens.',
+        description: `**ERC721 only** - AI prompt configurations for dynamic content generation at mint time.
+
+AI processing runs AFTER template interpolation, so prompts can reference already-interpolated values.
+
+Results are mapped by key to override static fields (name, description, imageUrl). Ignored for ERC1155 tokens.
+
+**Note:** For simple personalization without AI costs, use \`{{placeholder}}\` syntax directly in name/description fields instead.`,
         type: [AiPromptConfigDTO],
         example: [
-            { type: 'TEXT_GENERATION', key: 'name', prompt: 'Generate a unique reward name for {{user.name}}' },
-            { type: 'IMAGE_GENERATION', key: 'imageUrl', prompt: 'A golden trophy badge' }
+            { type: 'TEXT_GENERATION', key: 'name', prompt: 'Generate a unique reward name for {{user.firstName}} at {{business.displayName}}' },
+            { type: 'IMAGE_GENERATION', key: 'imageUrl', prompt: 'A {{defaults.style}} trophy badge for {{context.eventName}}' }
         ]
     }),
     OptionalStrip(),
@@ -152,6 +184,34 @@ __decorate([
     ValidateNested({ each: true }),
     Type(() => AiPromptConfigDTO)
 ], TokenMetadataCreateRequestDTO.prototype, "aiPromptConfigs", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: `**ERC721 only** - Allow USER-PROVIDED external context from claim/redeem requests to be used in template interpolation and AI prompts.
+
+**Security model:**
+- \`false\` (default): Only admin-controlled context (TriggerSource.context, Redemption.context, defaultPromptContext) is available
+- \`true\`: User-provided context from API requests is also merged and available as \`{{context.xxx}}\`
+
+**Note:** Admin-controlled context (QR/NFC data) is ALWAYS applied regardless of this flag.`,
+        type: Boolean,
+        default: false,
+        example: true
+    }),
+    OptionalStrip()
+], TokenMetadataCreateRequestDTO.prototype, "allowExternalContextOverwrite", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: `**ERC721 only** - Default context values for template interpolation and AI prompts. Available as \`{{defaults.xxx}}\` placeholders.
+
+Always applied regardless of allowExternalContextOverwrite. Use for brand defaults, styling preferences, or fallback values.
+
+**Example usage in name:** \`"{{defaults.brand}} - {{user.firstName}}'s Reward"\``,
+        type: 'object',
+        example: { brand: 'PERS Rewards', style: 'minimal', defaultLocation: 'Online' }
+    }),
+    OptionalStrip(),
+    IsObject()
+], TokenMetadataCreateRequestDTO.prototype, "defaultPromptContext", void 0);
 __decorate([
     ApiPropertyOptional({
         description: 'Business IDs where this token can be redeemed/spent. If empty, token can be spent at any business in the tenant. Used to restrict token usage to specific participating businesses.',

package/dist/esm/shared-lib/dto/token/token-metadata.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"token-metadata.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/token/token-metadata.dto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"token-metadata.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/token/token-metadata.dto.ts"],"names":[],"mappings":"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"}

package/dist/esm/shared-lib/enum/token-validity-type.enum.d.ts

@@ -2,12 +2,21 @@
  * 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
  */
 export declare const TokenValidityTypes: {
     readonly FIXED_DATE: "fixed_date";
@@ -16,7 +25,11 @@ export declare const TokenValidityTypes: {
     readonly MONTHS_FROM_ISSUANCE: "months_from_issuance";
     readonly END_OF_MONTH: "end_of_month";
     readonly END_OF_YEAR: "end_of_year";
+    readonly TRIGGER_DATE: "trigger_date";
+    readonly TRIGGER_DATE_RANGE: "trigger_date_range";
+    readonly DAYS_FROM_TRIGGER: "days_from_trigger";
+    readonly HOURS_FROM_TRIGGER: "hours_from_trigger";
 };
 export type TokenValidityType = typeof TokenValidityTypes[keyof typeof TokenValidityTypes];
-export declare const TOKEN_VALIDITY_TYPE_VALUES: ("fixed_date" | "days_from_issuance" | "hours_from_issuance" | "months_from_issuance" | "end_of_month" | "end_of_year")[];
+export declare const TOKEN_VALIDITY_TYPE_VALUES: ("fixed_date" | "days_from_issuance" | "hours_from_issuance" | "months_from_issuance" | "end_of_month" | "end_of_year" | "trigger_date" | "trigger_date_range" | "days_from_trigger" | "hours_from_trigger")[];
 //# sourceMappingURL=token-validity-type.enum.d.ts.map

package/dist/esm/shared-lib/enum/token-validity-type.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-validity-type.enum.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/enum/token-validity-type.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB;;;;;;;CAOrB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,OAAO,kBAAkB,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE3F,eAAO,MAAM,0BAA0B,2HAAoC,CAAC"}
+{"version":3,"file":"token-validity-type.enum.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/enum/token-validity-type.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;CAYrB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,OAAO,kBAAkB,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE3F,eAAO,MAAM,0BAA0B,gNAAoC,CAAC"}

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

@@ -2,12 +2,21 @@
  * 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
  */
 export const TokenValidityTypes = {
     FIXED_DATE: 'fixed_date',
@@ -16,6 +25,11 @@ export const 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',
 };
 export const TOKEN_VALIDITY_TYPE_VALUES = Object.values(TokenValidityTypes);
 //# sourceMappingURL=token-validity-type.enum.js.map

package/dist/esm/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;AACH,MAAM,CAAC,MAAM,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;AAIX,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,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;AACH,MAAM,CAAC,MAAM,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;AAIX,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/esm/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/esm/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/esm/shared-lib/interfaces/dynamic-context.interface.js

@@ -0,0 +1,19 @@
+/**
+ * Type guard to check if context has validity date
+ */
+export const hasValidityDate = (context) => {
+    return !!context?.validityDate;
+};
+/**
+ * Type guard to check if context has validity end date
+ */
+export const hasValidityEndDate = (context) => {
+    return !!context?.validityEndDate;
+};
+/**
+ * Type guard to check if context has validity duration
+ */
+export const hasValidityDuration = (context) => {
+    return typeof context?.validityDuration === 'number' && context.validityDuration > 0;
+};
+//# sourceMappingURL=dynamic-context.interface.js.map

package/dist/esm/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;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAwB,EAA+D,EAAE;IACrH,OAAO,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC;AACnC,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAwB,EAAkE,EAAE;IAC3H,OAAO,CAAC,CAAC,OAAO,EAAE,eAAe,CAAC;AACtC,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,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"}

package/dist/esm/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/esm/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/esm/shared-lib/interfaces/index.js

@@ -20,6 +20,8 @@ export * from './counterfactual-wallet-response.interface.js';
 export * from './campaign/index.js';
 export * from './ai-prompt-config.interface.js';
 export * from './balance-filter-options.interface.js';
+export * from './dynamic-context.interface.js';
+export * from './trigger-source-metadata.interface.js';
 export * from './ws-relay.types.js';
 export * from './external-token-issuer.interface.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/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,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.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,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/esm/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/esm/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/esm/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/esm/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/esm/shared-lib/interfaces/trigger-source-metadata.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trigger-source-metadata.interface.js.map

package/dist/esm/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/esm/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/esm/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":"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"}