@mhubcloud/tms_core 3.5.1 → 3.6.0-beta.1

package/src/utils/utils.ts

@@ -1,433 +0,0 @@
-import * as crypto from 'crypto';
-import { Logger } from '@azure/functions';
-import * as appInsights from 'applicationinsights';
-import {
-  SeverityLevel,
-  Telemetry,
-} from 'applicationinsights/out/Declarations/Contracts';
-import { EventPublisherBaseClass } from '../types/EventPublisher';
-import { EventToLog } from '../types/EventToLog';
-import { PlatformRequestOptions } from '../types/PlatformPublisher';
-import { TypeSafeObject } from '../types/UtilTypes';
-
-let aiClient: appInsights.TelemetryClient | null = null;
-
-if (process.env.APPLICATIONINSIGHTS_CONNECTION_STRING) {
-  appInsights
-    .setup() // Set environment variable APPLICATIONINSIGHTS_CONNECTION_STRING, so setup() can be called w/o parameters
-    .setAutoCollectDependencies(false)
-    .setAutoCollectConsole(true, false)
-    .setSendLiveMetrics(false)
-    .setAutoCollectRequests(false)
-    .setAutoCollectPerformance(false)
-    .setUseDiskRetryCaching(false)
-    .start();
-  aiClient = appInsights.defaultClient;
-}
-
-/**
- * Base class for Event Publisher classes
- * Facilitates registration (depracated) and configuration
- */
-export class EventPublisherBase implements EventPublisherBaseClass {
-  config;
-  constructor(config: TypeSafeObject) {
-    this.config = config;
-  }
-
-  /** @deprecated Please use a 'new Class(config)' notation. The .register() method will be deleted in future major version
-   * Registers a new instance of @see EventPublisherBase -derived class with array of publishers
-   * @param {EventPublisher[]} publishers Tha publishers array to register with
-   * @param {Object} config Configuration to pass to new instance
-   * Call this static method on @see EventPublisherBase -derived class.
-   * It will create its instance and pass @param config to its constructor.
-   * Than it will add resulting instance of @param publishers.
-   */
-  public static register(publishers: unknown[], config: TypeSafeObject) {
-    // ? Otestovat zpetnou kompatibilitu
-    publishers.push(
-      new this(
-        config,
-      ) /* Trick: Creates instance of the specific derived class `register` has been called on */,
-    );
-  }
-}
-
-/**
- * Logs message to Azure Function context and to Application Insights (if configured)
- */
-export function logMessage(
-  level: SeverityLevel,
-  message: string,
-  properties?: Telemetry['properties'],
-): void {
-  console.log(message);
-  aiClient?.trackTrace({
-    message,
-    severity: level,
-    properties,
-  });
-}
-
-export function logEvent(
-  publisher: string,
-  event: string,
-  region: string,
-  status: number,
-  payload: string | undefined,
-  id: string,
-): void {
-  let message = '';
-
-  if (status || status === 0) {
-    message =
-      status >= 200 && status < 300
-        ? 'Event dispatched to platform'
-        : 'Event dispatch failed';
-  } else {
-    message = 'Event dispatched to platform';
-  }
-
-  let properties: Telemetry['properties'] = {
-    publisher,
-    event,
-    region,
-    id,
-    status,
-    payload,
-  };
-
-  properties = removeUndefined(properties);
-
-  logMessage(1, message, properties);
-}
-
-/**
- * Logs exception to Azure Function context and to Application Insights (if configured)
- */
-export function logException(exception: Error) {
-  // log.warn(exception.message);
-  aiClient?.trackMetric({
-    name: `Error/${exception.name}`,
-    value: 1,
-  });
-  aiClient?.trackException({ exception: exception });
-}
-
-/**
- * Creates a deep copy of given object removing any properties or array items with undefined value
- * @param originalValue Object or array to copy. If value is neither array nor object it's returned as passed.
- * @returns Deep copy of @param originalValue (providing array or object has been passed in). Any properties or array item with undefined value are skipped when making the copy, recursively. Returns @param obj untouched if neither array nor object has been passed in.
- */
-export function removeUndefined(
-  originalValue: TypeSafeObject | unknown[],
-): TypeSafeObject | unknown[] {
-  // ? Toto bych rad otestoval. Klidne unit testy.
-  if (originalValue instanceof Array) {
-    return removeUndefinedFromArray(originalValue);
-  } else if (originalValue instanceof Object) {
-    return removeUndefinedFromObject(originalValue);
-  } else {
-    return originalValue;
-  }
-}
-
-function removeUndefinedFromObject(object: TypeSafeObject) {
-  const resultObject: TypeSafeObject = {};
-  for (const property in object) {
-    if (
-      Object.prototype.hasOwnProperty.call(object, property) &&
-      object[property] !== undefined
-    ) {
-      resultObject[property] = removeUndefined(
-        object[property] as TypeSafeObject | unknown[],
-      );
-    }
-  }
-  return resultObject;
-}
-
-function removeUndefinedFromArray(array: unknown[]) {
-  const resultArray: unknown[] = [];
-  for (const item of array) {
-    if (item !== undefined) {
-      resultArray.push(removeUndefined(item as TypeSafeObject | unknown[]));
-    }
-  }
-  return resultArray;
-}
-
-/**
- * Computes SHA-256 hash of an email string. If email is not a string, undefined is returned
- */
-export function encodeEmail(email: string) {
-  return computeSha256HashFromString(email);
-}
-
-/**
- * Computes SHA-256 hash of any string. If provided value is not a string, undefined is returned
- */
-function computeSha256HashFromString(stringToHash: string) {
-  if (typeof stringToHash !== 'string') {
-    return undefined;
-  }
-  return crypto
-    .createHash('sha256')
-    .update(stringToHash.toLowerCase(), 'ascii')
-    .digest('hex')
-    .toLowerCase();
-}
-
-interface Ad {
-  adPlatform: string;
-  visitAt: number;
-  adCodes?: Record<string, string>;
-}
-
-interface AdCodeInfo {
-  code: string;
-  visitAt: number;
-}
-
-/**
- * Extracts ad code from standardly structured event data (in legacy or new format)
- * @param data Event data to extract ad code from. As you can see the `ads` field is accepted in 2 formats the first being legacy and the later being new one.
- * @param adPlatform value of `data.ads.adPlatform` field to filter ad codes by platform (this is for new style data; ignored for legacy data)
- * @param adCode value of `data.ads.adType` field to filter items in `data.ads` by (this is for legacy style data); als used for new style data to identify the main parameter from `data.ads.adCodes` to obtain
- * @param format If this custom function is provided it forats the code returned, so the function does not return object but string formated by this function. But nothing prevents it from returning object if the consumer can hanlde it.
- */
-export function extractAdCode(
-  data: {
-    ads: Ad[];
-  },
-  adPlatform: string,
-  adCode: string,
-  format: ((code: AdCodeInfo, ad: Ad) => string | null | unknown) | null = null,
-): AdCodeInfo | null | string | unknown {
-  // ? Tady se udělalo hodně změn, protože se dal pryč legacy kód. Pro kontrolu je potřebná lepší znalost dat.
-  // ? Udelat unit test
-  const ad = data.ads
-    .filter((x) => {
-      return x.adPlatform === adPlatform;
-    })
-    .sort((a, b) => b.visitAt - a.visitAt)[0];
-  if (!ad) {
-    return null;
-  }
-  const code: string | null | undefined = ad.adCodes
-    ? ad.adCodes[adCode]
-    : null;
-  if (code) {
-    const returnValue: AdCodeInfo = { code: code, visitAt: ad.visitAt };
-    if (format) {
-      return format(returnValue, ad);
-    }
-    return returnValue;
-  }
-  return null;
-}
-
-export function extractPlatformCodes(
-  data: {
-    ads: Ad[];
-  },
-  adPlatform: string,
-) {
-  const platformCodes = data.ads
-    .filter((x) => {
-      return x.adPlatform === adPlatform;
-    })
-    .sort((a, b) => b.visitAt - a.visitAt)[0];
-  if (!platformCodes) {
-    return null;
-  } else {
-    return {
-      adCodes: platformCodes.adCodes,
-      visitAt: platformCodes.visitAt,
-    };
-  }
-}
-
-/**
- * Transforms an object to be flat, for instance for GA4
- * @param event Event that is received
- * @param separator Separator that will be used to unnest the structure. The default separator is underscore _
- * @returns
- */
-export function flatten(
-  event: TypeSafeObject,
-  separator = '_',
-): TypeSafeObject {
-  // ? Tady je pro safety potřeba celou funkci vylepšit
-  // eslint-disable-next-line @typescript-eslint/no-unsafe-return
-  return Object.assign(
-    {},
-    // eslint-disable-next-line @typescript-eslint/naming-convention, @typescript-eslint/no-unsafe-argument
-    ...(function _flatten(
-      o: TypeSafeObject,
-      separator: string,
-      parent?: string,
-    ): any {
-      return [].concat(
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-        ...Object.keys(o).map((key) => {
-          if (typeof o[key] === 'object' && o[key] !== null) {
-            const newParent = parent ? parent + separator + key : key;
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
-            return _flatten(o[key] as TypeSafeObject, separator, newParent);
-          } else {
-            const newKey = parent ? parent + separator + key : key;
-            return { [newKey]: o[key] };
-          }
-        }),
-      );
-    })(event, separator),
-  );
-}
-
-/**
- * Enhances header before sending test request to secondary target (like Pipedream)
- * @param headers Request header dictionary. This contains the original headers and will be ehnanced.
- * @param origUrl Original URL the request has been sent to
- * @param origRequest The entire original request options
- * @param origResponse Response recievend from original request
- */
-export function prepareTestRequestHeaders(
-  headers: TypeSafeObject,
-  origUrl: string,
-  origRequest: TypeSafeObject,
-  origResponse: Response,
-) {
-  headers['x-mhub-orig-url'] = origUrl;
-  headers['x-mhub-orig-method'] = origRequest.method;
-  headers['x-mhub-orig-response-status-code'] = origResponse.status;
-  headers['x-mhub-orig-response-status-message'] = origResponse.statusText;
-}
-
-interface HandleRequestParams {
-  source: string;
-  baseUrl: string;
-  requestOptions: PlatformRequestOptions;
-  query?: string;
-  event: EventToLog;
-  logger: Logger;
-  handlePlatformResponse?: boolean;
-}
-
-/**
- *
- * @param params
- * @returns
- */
-
-export async function handlePlatformRequest({
-  source,
-  baseUrl,
-  requestOptions,
-  query = '',
-  event,
-}: HandleRequestParams) {
-  if (!baseUrl || baseUrl.length < 3) {
-    // ? Mohli bychom zacit delat poradnou kontrolu validity vstupnich paramteru. Idealne pres ZOD
-    throw new Error('URL for request was not provided or was not valid');
-  }
-  const fullUrl = baseUrl + query;
-
-  const fetchRequestOptions: RequestInit = {
-    method: requestOptions.method ?? 'POST',
-    body: requestOptions.body ?? undefined,
-    // eslint-disable-next-line @typescript-eslint/naming-convention
-    headers: { ...requestOptions.headers },
-  };
-
-  let rawPlatformResponse: Response | undefined;
-
-  try {
-    rawPlatformResponse = await fetch(fullUrl, fetchRequestOptions);
-  } catch (e: unknown) {
-    logEvent(
-      source,
-      event.event,
-      event.region,
-      0,
-      requestOptions.body ? JSON.stringify(requestOptions.body) : undefined,
-      event.id,
-    );
-    throw e;
-  }
-
-  if (rawPlatformResponse) {
-    if (process.env.PUBLISHER_TESTURL) {
-      await handleTestRequest({
-        fetchRequestOptions,
-        fullUrl,
-        query,
-        rawPlatformResponse,
-      });
-    }
-
-    logEvent(
-      source,
-      event.event,
-      event.region,
-      rawPlatformResponse.status,
-      requestOptions.body ? JSON.stringify(requestOptions.body) : undefined,
-      event.id,
-    );
-
-    if (!rawPlatformResponse.ok) {
-      throw new Error(
-        `HTTP Error code: ${rawPlatformResponse.status}, event: ${
-          event.event
-        }, region: ${event.region}, body: ${await rawPlatformResponse.text()}`,
-      );
-    }
-  }
-}
-
-interface HandleTestRequestParams {
-  fetchRequestOptions: RequestInit;
-  fullUrl: string;
-  query: string | undefined;
-  rawPlatformResponse: Response;
-}
-
-async function handleTestRequest(params: HandleTestRequestParams) {
-  try {
-    params.fetchRequestOptions.headers = {
-      ...params.fetchRequestOptions.headers,
-      // eslint-disable-next-line @typescript-eslint/naming-convention
-      'x-mhub-orig-url': params.fullUrl,
-      // eslint-disable-next-line @typescript-eslint/naming-convention
-      'x-mhub-orig-method': params.fetchRequestOptions.method ?? '',
-      // eslint-disable-next-line @typescript-eslint/naming-convention
-      'x-mhub-orig-response-status-code': `${params.rawPlatformResponse.status}`,
-      // eslint-disable-next-line @typescript-eslint/naming-convention
-      'x-mhub-orig-response-status-message':
-        params.rawPlatformResponse.statusText,
-    };
-    await fetch(
-      `${process.env.PUBLISHER_TESTURL ?? ''} + ${params.query ?? ''}`,
-      params.fetchRequestOptions,
-    );
-  } catch {
-    /* empty */
-  }
-}
-
-export function formatError(error: Error | Error['message']) {
-  let formattedError: Error;
-  if (error instanceof Error) {
-    formattedError = error;
-    if (error.cause) {
-      formattedError.message = `${
-        error.message
-      } Cause: ${error.cause.toString()}`;
-    } else {
-      formattedError.message = error.message;
-    }
-  } else {
-    formattedError = new Error(error);
-  }
-  return formattedError;
-}

package/tests/AffiliatePort.js

@@ -1,133 +0,0 @@
-const localSettings = require('../local.settings.json').Values;
-process.env = { ...process.env, ...localSettings };
-const publisher = require('../dist/index.js').publisher.AffiliatePort;
-const defaultPublisher = require('../dist/index.js').DefaultPublisher;
-const utils = require('../dist/index.js').utils;
-const testUtils = require('../dist/index.js').testUtils;
-
-describe('test AffiliatePort publisher', function () {
-  it('purchase', async function () {
-    var serviceBusMessage = {
-      event: {
-        region: 'smarty.cz',
-        id: '825333270-1011.1659006863812',
-        code: 'purchase',
-      },
-      user: {
-        ts: 'customer.HL',
-        email: 'jan.brzobohaty@crossmasters.com',
-        id: 'a2992fb8-40ac-4b88-9cf5-7fba02f1f611',
-      },
-      session: {
-        userAgent:
-          'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.2 Safari/605.1.15',
-        ip: '217.195.174.253',
-      },
-      permissions: [],
-      currencyCode: 'CZK',
-      publisher: {
-        code: 'www.smarty.cz',
-        tm: 'GTM-NVNTFG',
-        tmv: '193',
-      },
-      $schema: 'https://schema.measurementhub.net/mhub/2021-12-27/purchase',
-      id: '3511111111',
-      revenue: 10,
-      products: [
-        {
-          id: '67137',
-          price: 10,
-          quantity: 1,
-          category: 'Playstation',
-          masterType: 'Konzole',
-        },
-        {
-          id: '67137',
-          price: 20,
-          quantity: 1,
-          category: 'Monitor',
-          masterType: 'Video',
-        },
-      ],
-      location: 'https://www.smarty.cz/checkoutSuccess',
-      referrer:
-        'https://www.smarty.cz/Order/AddReservation?productId=57873&shopAddressId=24798',
-      enqueuedAt: 1659006864038,
-      ads: [
-        {
-          adPlatform: 'affiliateport',
-          adCodes: {
-            transaction_id: '816f5670dbf52c3dc27a7e849903c327d705ef643993fbab3',
-          },
-          visitAt: 1658392668000,
-        },
-      ],
-      EventProcessedUtcTime: '2022-07-28T11:54:50.2528883Z',
-      PartitionId: 0,
-      EventEnqueuedUtcTime: '2022-07-28T11:14:24.1170000Z',
-    };
-    await test(serviceBusMessage);
-  });
-});
-
-/**
- * Test function
- * @param [object] object obsahující nastavení testovací parametry
- */
-async function test(serviceBusMessage) {
-  await defaultPublisher(
-    testUtils.context,
-    serviceBusMessage,
-    'AffiliatePort',
-    publisher,
-    trigger,
-  );
-}
-
-// eslint-disable-next-line @typescript-eslint/require-await
-async function trigger(data) {
-  const publishers = [];
-  let publisher;
-
-  // Dummy config, replace with your own
-  const config = {
-    offerId: 123,
-  };
-
-  switch (data.event?.code) {
-    case 'purchase':
-      publisher = AffiliatePortPurchasePublisher;
-      publisher.register(publishers, config);
-      break;
-  }
-  return publishers;
-}
-
-/**
- * Implements Purchase event publisher for Facebook
- * @implements {EventPublisher<{id: string, access_token: string}>}
- */
-class AffiliatePortPurchasePublisher extends utils.EventPublisherBase {
-  /**
-   * Maps `purchase` event data to AffiliatePort payload
-   * @param {Object} data `purchase` event data
-   * @returns {Object} Data mapped from incoming Service Bus message to platform payload
-   */
-  map(data) {
-    return {
-      orderId: data.id,
-      revenue: data.revenue, // should be without VAT and shipping, payment fees
-      products: data.products.map((pr) => ({
-        quantity: pr.quantity, // e.g. 1
-        price: pr.price, // e.g. 109
-        category: pr.category.replace(/ /g, '-'), // e.g. Playstation
-        masterType: pr.masterType, // e.g. Konzole
-      })),
-      transactionID: utils.extractAdCode(
-        data,
-        'affiliateport',
-        'transaction_id',
-      )?.code, // AffiliatePort identificator taken automatically from URL
-    };
-  }
-}