@open-condo/miniapp-utils
Version:
A set of helper functions / components / hooks used to build new condo apps fast
375 lines (360 loc) • 12.5 kB
JavaScript
;
var __defProp = Object.defineProperty;
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
var __getOwnPropNames = Object.getOwnPropertyNames;
var __hasOwnProp = Object.prototype.hasOwnProperty;
var __export = (target, all) => {
for (var name in all)
__defProp(target, name, { get: all[name], enumerable: true });
};
var __copyProps = (to, from, except, desc) => {
if (from && typeof from === "object" || typeof from === "function") {
for (let key of __getOwnPropNames(from))
if (!__hasOwnProp.call(to, key) && key !== except)
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
}
return to;
};
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
// src/index.ts
var index_exports = {};
__export(index_exports, {
Analytics: () => Analytics,
FINGERPRINT_ID_COOKIE_NAME: () => FINGERPRINT_ID_COOKIE_NAME,
FINGERPRINT_ID_LENGTH: () => FINGERPRINT_ID_LENGTH,
SSRCookiesHelper: () => SSRCookiesHelper,
generateFingerprint: () => generateFingerprint,
generateUUIDv4: () => generateUUIDv4,
getClientSideFingerprint: () => getClientSideFingerprint,
getClientSideSenderInfo: () => getClientSideSenderInfo,
getPosthogEndpoint: () => getPosthogEndpoint,
getTracingMiddleware: () => getTracingMiddleware,
isDebug: () => isDebug,
isSSR: () => isSSR,
nonNull: () => nonNull,
prepareSSRContext: () => prepareSSRContext,
useEffectOnce: () => useEffectOnce,
usePrevious: () => usePrevious
});
module.exports = __toCommonJS(index_exports);
// src/helpers/analytics/instance.ts
var import_analytics = require("analytics");
// src/helpers/analytics/middlewares.ts
function _addGroupingProperties(data) {
const { instance } = data;
for (const groupName of instance.groups) {
const groupKey = Analytics.getGroupKey(groupName);
const groupValue = instance.storage.getItem(groupKey);
if (typeof groupValue === "string") {
const groupAttrName = `groups.${groupName}`;
data.payload.properties[groupAttrName] = groupValue;
}
}
return data;
}
var GroupingMiddlewarePlugin = {
name: "analytics-plugin-grouping",
track: _addGroupingProperties,
page: _addGroupingProperties
};
// src/helpers/analytics/instance.ts
var Analytics = class _Analytics {
constructor(config) {
this._groups = /* @__PURE__ */ new Set();
this._analytics = (0, import_analytics.Analytics)({
...config,
plugins: [
GroupingMiddlewarePlugin,
...config.plugins || []
]
});
this._analytics.groups = this._groups;
}
/**
* Tracks type-safe business events. Recommended to use in most cases in app's codebase.
* To add an event, modify "Events" generic.
*/
async track(eventName, eventData) {
await this._analytics.track(eventName, eventData);
}
/**
* Tracks untyped analytics events, used mainly for external sources (bridge / ui-kit / messages, etc.)
* @deprecated It's not recommended to use this in your business logic, consider using typed "track" instead
*/
async trackUntyped(eventName, eventData) {
await this._analytics.track(eventName, eventData);
}
/**
* Tracks page changing in SPAs
*/
async pageView(data) {
await this._analytics.page(data);
}
/**
* Identifies user in analytics provider.
* To specify all possible shape of user's data, modify "UserData" generic
*
* NOTE: Analytics plugins don't have a fixed behavior on how to handle consecutive identify calls.
* Some of them affect only subsequent events, others affect all user events.
* Therefore, it is not recommended to put cohort-specific data (organization, address, language, etc.) here.
* Instead, use something like "group" method if your plugins supports it.
*/
async identify(userId, userData) {
await this._analytics.identify(userId, userData);
}
/**
* Resets analytics providers
*/
async reset() {
for (const groupName of this._groups) {
const groupKey = _Analytics.getGroupKey(groupName);
this._analytics.storage.removeItem(groupKey);
}
this._groups.clear();
await this._analytics.reset();
}
static getGroupKey(groupName) {
return ["analytics", "groups", groupName].join(":");
}
/**
* Associates the user with a group, adding the attributes `groups.${groupName} = groupId`
* to all subsequent analytic queries for the user
* @example
* analytics.setGroup('organization', organizationId)
*/
setGroup(groupName, groupId) {
const groupKey = _Analytics.getGroupKey(groupName);
this._groups.add(groupName);
this._analytics.storage.setItem(groupKey, groupId);
}
/**
* Removes the current user from the group, stripping the “groups.${groupName}”
* attribute from all subsequent eventualities
* @example
* deleteOrganization()
* .then(() => analytics.removeGroup('organization'))
*/
removeGroup(groupName) {
const groupKey = _Analytics.getGroupKey(groupName);
this._analytics.storage.removeItem(groupKey);
this._groups.delete(groupName);
}
};
// src/helpers/apollo.ts
var import_cookie = require("cookie");
var import_cookies_next2 = require("cookies-next");
// src/helpers/sender.ts
var import_cookies_next = require("cookies-next");
// src/helpers/uuid.ts
var import_crypto = require("crypto");
function generateUUIDv4() {
let randomValues;
if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
return crypto.randomUUID();
} else if (typeof window !== "undefined" && window.crypto && window.crypto.getRandomValues) {
randomValues = new Uint8Array(16);
window.crypto.getRandomValues(randomValues);
} else {
randomValues = (0, import_crypto.randomBytes)(16);
}
randomValues[6] = randomValues[6] & 15 | 64;
randomValues[8] = randomValues[8] & 63 | 128;
return [...randomValues].map((value, index) => {
const hex = value.toString(16).padStart(2, "0");
if (index === 4 || index === 6 || index === 8 || index === 10) {
return `-${hex}`;
}
return hex;
}).join("");
}
// src/helpers/sender.ts
var FINGERPRINT_ID_COOKIE_NAME = "fingerprint";
var FINGERPRINT_ID_LENGTH = 12;
function makeId(length) {
const croppedLength = Math.min(length, 32);
return generateUUIDv4().replaceAll("-", "").substring(0, croppedLength);
}
function generateFingerprint() {
return makeId(FINGERPRINT_ID_LENGTH);
}
function getClientSideFingerprint() {
let fingerprint = (0, import_cookies_next.getCookie)(FINGERPRINT_ID_COOKIE_NAME);
if (!fingerprint) {
fingerprint = generateFingerprint();
(0, import_cookies_next.setCookie)(FINGERPRINT_ID_COOKIE_NAME, fingerprint);
}
return fingerprint;
}
function getClientSideSenderInfo() {
return {
dv: 1,
fingerprint: getClientSideFingerprint()
};
}
// src/helpers/apollo.ts
var SSR_DEFAULT_FINGERPRINT = "webAppSSR";
var COOKIE_HEADER_NAME = "cookie";
var REMOTE_APP_HEADER_NAME = "x-remote-app";
var REMOTE_VERSION_HEADER_NAME = "x-remote-version";
var REMOTE_CLIENT_HEADER_NANE = "x-remote-client";
var REMOTE_ENV_HEADER_NAME = "x-remote-env";
var TARGET_HEADER_NAME = "x-target";
var START_REQUEST_ID_HEADER_NAME = "x-start-request-id";
var PARENT_REQUEST_ID_HEADER_NAME = "x-parent-request-id";
function generateRequestId() {
return `BR${generateUUIDv4().replaceAll("-", "")}`;
}
function getTracingMiddleware(options) {
return function(operation, forward) {
operation.setContext((previousContext) => {
const { headers: previousHeaders } = previousContext;
const reqId = generateRequestId();
const headers = {
...previousHeaders,
[REMOTE_APP_HEADER_NAME]: options.serviceUrl,
[REMOTE_VERSION_HEADER_NAME]: options.codeVersion,
[PARENT_REQUEST_ID_HEADER_NAME]: reqId,
[START_REQUEST_ID_HEADER_NAME]: reqId
};
if (options.target) {
headers[TARGET_HEADER_NAME] = options.target;
}
headers[REMOTE_ENV_HEADER_NAME] = typeof document === "undefined" ? "SSR" : "CSR";
if (typeof document !== "undefined" && document.cookie) {
headers[REMOTE_CLIENT_HEADER_NANE] = getClientSideFingerprint();
} else if (headers[COOKIE_HEADER_NAME]) {
const ssrCookies = (0, import_cookie.parse)(headers[COOKIE_HEADER_NAME]);
headers[REMOTE_CLIENT_HEADER_NANE] = ssrCookies[FINGERPRINT_ID_COOKIE_NAME] || SSR_DEFAULT_FINGERPRINT;
}
return {
...previousContext,
headers
};
});
return forward(operation);
};
}
function prepareSSRContext(req, res) {
if (!req) {
return {
headers: {}
};
}
const requestCookies = (0, import_cookies_next2.getCookies)({ req, res });
if (!requestCookies[FINGERPRINT_ID_COOKIE_NAME]) {
const fingerprint = generateFingerprint();
requestCookies[FINGERPRINT_ID_COOKIE_NAME] = fingerprint;
(0, import_cookies_next2.setCookie)(FINGERPRINT_ID_COOKIE_NAME, fingerprint, { req, res });
}
const cookieHeader = Object.entries(requestCookies).map(([name, value]) => value ? (0, import_cookie.serialize)(name, value) : null).filter(Boolean).join(";");
return {
headers: {
cookie: cookieHeader
}
};
}
// src/helpers/collections.ts
function nonNull(val) {
return val !== null && val !== void 0;
}
// src/helpers/cookies.ts
var import_cookies_next3 = require("cookies-next");
var import_react = require("react");
var SSR_COOKIES_DEFAULT_PROP_NAME = "__SSR_COOKIES__";
var SSRCookiesHelper = class {
constructor(allowedCookies, propName) {
this.allowedCookies = allowedCookies;
this.propName = propName || SSR_COOKIES_DEFAULT_PROP_NAME;
this.defaultValues = Object.fromEntries(allowedCookies.map((key) => [key, null]));
this.context = (0, import_react.createContext)(this.defaultValues);
this.extractSSRCookies = this.extractSSRCookies.bind(this);
}
getContext() {
return this.context;
}
generateUseSSRCookiesExtractorHook() {
const defaultValues = this.defaultValues;
const propName = this.propName;
return function useSSRCookiesExtractor(pageProps) {
return pageProps[propName] || defaultValues;
};
}
generateUseSSRCookiesHook() {
const context = this.context;
return function useSSRCookies() {
return (0, import_react.useContext)(context);
};
}
extractSSRCookies(req, res, pageParams) {
return {
...pageParams,
props: {
...pageParams.props,
[this.propName]: Object.fromEntries(
Object.keys(this.defaultValues).map((key) => [
key,
(0, import_cookies_next3.getCookie)(key, { req, res }) || null
])
)
}
};
}
};
// src/helpers/environment.ts
function isSSR() {
return typeof window === "undefined";
}
function isDebug() {
return process.env.NODE_ENV === "development";
}
// src/helpers/posthog.ts
var POSTHOG_CLOUD_HOST_BASE = "i.posthog.com";
var POSTHOG_CLOUD_HOST_MATCHER = new RegExp(`^(\\w+)\\.${POSTHOG_CLOUD_HOST_BASE.replaceAll(".", "\\.")}$`);
function getPosthogEndpoint(posthogDomain, requestedPath) {
const posthogURL = new URL(posthogDomain);
const cloudMatch = posthogURL.host.match(POSTHOG_CLOUD_HOST_MATCHER);
if (cloudMatch && cloudMatch.length > 1) {
const region = cloudMatch[1];
if (requestedPath.length && requestedPath[0] === "static") {
posthogURL.host = `${region}-assets.${POSTHOG_CLOUD_HOST_BASE}`;
posthogURL.pathname = requestedPath.slice(1).join("/");
return posthogURL.toString();
}
}
posthogURL.pathname = requestedPath.join("/");
return posthogURL.toString();
}
// src/hooks/useEffectOnce.ts
var import_react2 = require("react");
function useEffectOnce(cb) {
(0, import_react2.useEffect)(cb, []);
}
// src/hooks/usePrevious.ts
var import_react3 = require("react");
function usePrevious(state) {
const ref = (0, import_react3.useRef)();
(0, import_react3.useEffect)(() => {
ref.current = state;
});
return ref.current;
}
// Annotate the CommonJS export names for ESM import in node:
0 && (module.exports = {
Analytics,
FINGERPRINT_ID_COOKIE_NAME,
FINGERPRINT_ID_LENGTH,
SSRCookiesHelper,
generateFingerprint,
generateUUIDv4,
getClientSideFingerprint,
getClientSideSenderInfo,
getPosthogEndpoint,
getTracingMiddleware,
isDebug,
isSSR,
nonNull,
prepareSSRContext,
useEffectOnce,
usePrevious
});
//# sourceMappingURL=index.js.map