Skip to content

armgit / macro

Public Imported from GitHub
0

Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.

2.7 KB
Raw Blame
/** PostHog feature flag used to configure the connector steps in onboarding. */
export const ONBOARDING_CONNECTORS_FEATURE_FLAG = 'onboarding-v4-connectors';

export const ONBOARDING_CONNECTORS = [
  { key: 'linear', serverName: 'Linear' },
  { key: 'notion', serverName: 'Notion' },
  { key: 'slack', serverName: 'Slack' },
  { key: 'github', serverName: 'GitHub' },
] as const;

const ONBOARDING_STEP_ORDER = [
  'welcome',
  'vision',
  'tools',
  'privacy',
  'security',
  'explore',
  'introduction',
  'email',
  ...ONBOARDING_CONNECTORS.map(({ key }) => `connect-${key}`),
  'team',
  'customize',
  'building',
  'summary',
  'plan',
];

export type OnboardingConnectorServerName =
  (typeof ONBOARDING_CONNECTORS)[number]['serverName'];

/**
 * Resolves the connector steps from the PostHog flag payload.
 *
 * The supported payload is a JSON object with connector keys and boolean
 * values, for example:
 *
 * `{ "linear": true, "notion": true, "slack": false, "github": true }`
 *
 * Existing behavior is fail-open: the flag must be enabled and a connector
 * must be explicitly set to `false` to hide it.
 */
export function resolveOnboardingConnectorNames(
  flagEnabled: boolean,
  payload: unknown
): OnboardingConnectorServerName[] {
  if (!flagEnabled || !isObject(payload)) {
    return ONBOARDING_CONNECTORS.map(({ serverName }) => serverName);
  }

  return ONBOARDING_CONNECTORS.filter(({ key }) => payload[key] !== false).map(
    ({ serverName }) => serverName
  );
}

/**
 * Finds the active step in a feature-flag-filtered step list. If the active
 * step was hidden, onboarding falls forward to the next visible step.
 */
export function resolveOnboardingStepIndex(
  visibleStepKeys: readonly string[],
  activeStepKey: string
): number {
  const exactIndex = visibleStepKeys.indexOf(activeStepKey);
  if (exactIndex !== -1) return exactIndex;
  if (
    (activeStepKey === 'explore' || activeStepKey === 'introduction') &&
    visibleStepKeys.includes('team')
  ) {
    return visibleStepKeys.indexOf('team');
  }
  // OAuth callbacks from the previous per-tool flow resume in the catalog.
  if (
    activeStepKey.startsWith('connect-') &&
    visibleStepKeys.includes('tools')
  ) {
    return visibleStepKeys.indexOf('tools');
  }
  const activeOrder = Math.max(ONBOARDING_STEP_ORDER.indexOf(activeStepKey), 0);
  const nextVisibleIndex = visibleStepKeys.findIndex(
    (key) => ONBOARDING_STEP_ORDER.indexOf(key) >= activeOrder
  );

  return nextVisibleIndex === -1
    ? Math.max(visibleStepKeys.length - 1, 0)
    : nextVisibleIndex;
}

function isObject(value: unknown): value is Record<string, unknown> {
  return typeof value === 'object' && value !== null && !Array.isArray(value);
}