@quapt/event-feedback

Trigger event-based questionnaires from Angular (after API success/failure or via a button).

npm install @quapt/event-feedback

Sometimes npm still caches the old registry error.

npm cache clean --force

Requirements: Angular 15+, HttpClient (e.g. provideHttpClient() or HttpClientModule).

Setup

Standalone — main.ts:

import { provideHttpClient } from '@angular/common/http';
import { provideEventBased } from '@quapt/event-feedback';

bootstrapApplication(AppComponent, {
  providers: [provideHttpClient(), provideEventBased()],
});

NgModule — app.module.ts:

import { HttpClientModule } from '@angular/common/http';
import { EventBasedModule } from '@quapt/event-feedback';

@NgModule({
  imports: [HttpClientModule, EventBasedModule],
})
export class AppModule {}

Every trigger call requires a valid accessId issued for your environment. The package resolves the backend internally from that ID.

Component: QuaptEventFeedback

Selector: quapt-event-feedback. Standalone; import QuaptEventFeedback from @quapt/event-feedback.

| Input | Type | Default | |-------|------|---------| | accessId | string | '' | | organizationId | string | '' | | appId | string | '' | | groupId | string | '' | | eventId | string | '' | | questionnaireType | string | '' | | eventData | EventDataItem[] | [] | | buttonLabel | string | 'Trigger event' | | buttonBgColor | string | '#f59e0b' | | buttonColor | string | '#000' | | buttonHeight | string | '40px' |

<quapt-event-feedback
  [accessId]="'ICXBEE-PROD-K7N4Q9M2X8R5'"
  [organizationId]="organizationId"
  [appId]="appId"
  [groupId]="groupId"
  [eventId]="eventId"
  [questionnaireType]="questionnaireType"
  [eventData]="eventData"
  buttonLabel="Trigger questionnaire"
  buttonBgColor="#f59e0b"
  buttonColor="#000"
  buttonHeight="40px"
/>

Service: EventBasedTriggerService

Inject and call triggerEvent(options) (e.g. in your API subscribe).

TriggerEventOptions: accessId, organizationId, appId, groupId, eventId, questionnaireType, eventData?

EventDataItem: { fieldName: string; fieldValue: string }

Invalid or missing accessId values fail immediately with Invalid Access ID. and no API request is sent.

import { EventBasedTriggerService } from '@quapt/event-feedback';

this.eventBased.triggerEvent({
  accessId: 'ICXBEE-PROD-K7N4Q9M2X8R5',
  organizationId: 'ORG-123',
  appId: 'APP-1',
  groupId: 'GRP001',
  eventId: 'EVT-1',
  questionnaireType: 'NPS',
  eventData: [
    { fieldName: 'EMAIL', fieldValue: '[email protected]' },
    { fieldName: 'NAME', fieldValue: 'User' },
  ],
}).subscribe();

Exports

QuaptEventFeedback, EventBasedTriggerService, EventBasedModule, provideEventBased, TriggerEventOptions, EventDataItem