Function resolveAppEventUrl

src/core/app-events.ts:36–66

(
  device: AppEventDevice,
  eventName: string,
  payload?: AppEventPayload,
)

}

export function resolveAppEventUrl(
  device: AppEventDevice,
  eventName: string,
  payload?: AppEventPayload,
): string {
  const platform = publicPlatformString(device);
  const template = readAppEventUrlTemplate(device);
  if (!template) {
    throw new AppError(
      'UNSUPPORTED_OPERATION',
      `No app event URL template configured for ${platform}.`,
      {
        hint: `Set AGENT_DEVICE_${platform.toUpperCase()}_APP_EVENT_URL_TEMPLATE or AGENT_DEVICE_APP_EVENT_URL_TEMPLATE, for example "myapp://agent-device/event?name={event}&payload={payload}".`,
      },
    );
  }

  const payloadText = payload ? JSON.stringify(payload) : '';
  const eventUrl = template
    .replaceAll('{event}', encodeURIComponent(eventName))
    .replaceAll('{payload}', encodeURIComponent(payloadText))
    .replaceAll('{platform}', encodeURIComponent(platform));
  if (eventUrl.length > MAX_APP_EVENT_URL_LENGTH) {
    throw new AppError('INVALID_ARGS', 'trigger-app-event URL exceeds maximum supported length', {
      hint: 'Reduce payload size or shorten AGENT_DEVICE_*_APP_EVENT_URL_TEMPLATE.',
      length: eventUrl.length,
      maxLength: MAX_APP_EVENT_URL_LENGTH,
    });
  }
  return eventUrl;
}

function parseTriggerEventPayload(
  payloadArg: string | undefined,