Epic 7: AMS Integration & SDK

Enable seamless image generation from within AMS through embeddable SDK

Epic 76 User Stories

AMS Integration & SDK

Enable seamless image generation from within AMS through embeddable SDK

User Stories

Story 7.1

SDK Package Structure

Distributable SDK package with UMD and ESM bundles for AMS integration.

Acceptance Criteria
  • UMD bundle for script tag inclusion
  • ESM bundle for npm install
  • TypeScript types included
  • Bundle size <100KB gzipped
Story 7.2

SDK Authentication Flow

Seamless authentication using signed JWT tokens from parent application.

Acceptance Criteria
  • Receive signed JWT from AMS
  • Validate JWT with API
  • Establish authenticated session
  • Graceful error handling
Story 7.3

Context Passing from AMS

SDK receives context (event/blog/email, dimensions, metadata) from parent application.

Acceptance Criteria
  • Context type passed (event, blog, edm)
  • Entity ID and dimensions received
  • AI uses context for suggestions
  • Metadata captured for analytics
Story 7.4

Embedded Generation Modal

Full generation experience rendered as modal overlay in parent application.

Acceptance Criteria
  • Modal overlays AMS page
  • All generation features available
  • Styled to complement AMS
  • Escape key closes modal
Story 7.5

Image Selection Callback

Return selected image data to parent application via callback.

Acceptance Criteria
  • onImageSelected callback with URL, dimensions
  • Modal closes automatically
  • Image also saved to library
  • onCancel callback available
Story 7.6

Webhook Notifications

Send webhook events for generation completion with retry logic.

Acceptance Criteria
  • generation.completed event sent
  • Payload includes jobId, imageUrls, context
  • Webhook signed with secret
  • Retry on failure (3 attempts)

Want to see ams integration & sdk in action?

Book a demo to see how imAgend can transform your association's visual content creation.

Request a Demo