{ micro: { min: 0, max: 9 }, small: { min: 10, max: 49 }, medium: { min: 50, max: 199 }, large: { min: 200, max: Infinity } }

enum ErrorSeverity { INFO, WARNING, ERROR, CRITICAL }
enum ErrorCategory {
  VALIDATION, AUTHENTICATION, AUTHORIZATION, NOT_FOUND,
  NETWORK, FIRESTORE, STORAGE, RATE_LIMIT, BUSINESS_LOGIC,
  EXTERNAL_API, AI_SERVICE, EMAIL_SERVICE, UNKNOWN
}

interface SystemEvent<T = Record<string, unknown>> {
  eventId?: string;           // Stable ID for idempotency
  occurredAt?: string;        // ISO timestamp for persistence/replay
  type: SystemEventType;
  organizationId: string;
  userId: string;
  severity: EventSeverity;
  timestamp: Date;
  payload: T;
  metadata?: {
    source?: string;
    version?: string;
    correlationId?: string;
    schemaVersion?: string;
    criticality?: 'durable-critical' | 'ephemeral';
  };
}

type TypedSystemEvent<E extends keyof EventPayloadMap & SystemEventType> =
  Omit<SystemEvent, 'type' | 'payload'> & { type: E; payload: EventPayloadMap[E] };

type CanonicalStatus = 'pending' | 'progress' | 'blocked' | 'completed' | 'failed';

type CanonicalStatusDomain =
  | 'grant_lifecycle' | 'expense_audit' | 'journal_workflow' | 'agent_run'
  | 'billing' | 'compliance' | 'project' | 'project_lifecycle' | 'extension';

type CanonicalEntityType =
  | 'grant' | 'expense' | 'journal' | 'agent_run'
  | 'billing' | 'compliance' | 'project' | 'extension';

// Import from specific subpaths for tree-shaking
import { SystemRole, Permission, ProjectPhase } from '@grantmaster/shared/types';
import { requiredStringSchema, currencyCodeSchema } from '@grantmaster/shared/schemas';
import { NotFoundError, FeatureNotAvailableError } from '@grantmaster/shared/errors';
import { SystemEventType, type GrantWonPayload } from '@grantmaster/shared/events';
import { Feature, tierIncludesFeature, TIER_LIMITS } from '@grantmaster/shared/config';

// Check feature availability
if (!tierIncludesFeature(currentTier, Feature.GRANT_DISCOVERY)) {
  throw new FeatureNotAvailableError(
    'Grant Discovery',
    currentTier,
    getMinimumTierForFeature(Feature.GRANT_DISCOVERY)
  );
}

// Validate form input with shared schema
const schema = z.object({
  name: requiredStringSchema,
  currency: currencyCodeSchema,
  amount: currencyAmountSchema,
});

// Type-safe event handling
function handleEvent(event: TypedSystemEvent<SystemEventType.GRANT_WON>) {
  const { grantTitle, awardedAmount } = event.payload; // fully typed
}

// Import from root barrel or specific subpaths
import {
  SystemEventType,
  EventSeverity,
  type SystemEvent,
  ProjectBase,
  EmployeeBase,
} from '@grantmaster/shared';

import { AppError, FirestoreError } from '@grantmaster/shared/errors';
import { canonicalEventEnvelopeSchema } from '@grantmaster/shared/canonical';

// Validate incoming canonical event
function processCanonicalEvent(data: unknown) {
  const result = canonicalEventEnvelopeSchema.safeParse(data);
  if (!result.success) {
    throw new ValidationError(result.error.message);
  }
  // result.data is typed as CanonicalEventEnvelope
}

// Use shared entity types for AI/search processing
function processProject(project: ProjectBase) {
  // Only fields needed by functions are available
  console.log(project.name, project.phase, project.fundingSource);
}

// Wrap Firestore errors
try {
  await db.collection('projects').doc(id).get();
} catch (error) {
  throw new FirestoreError('getProject', error, { projectId: id });
}

import {
  requiresPersistence,
  requiresDurableDelivery,
  SystemEventType,
} from '@grantmaster/shared/events';

function routeEvent(event: SystemEvent) {
  if (requiresPersistence(event.type)) {
    await persistToFirestore(event);
  }
  if (requiresDurableDelivery(event.type)) {
    await enqueueForGuaranteedDelivery(event);
  }
}

import {
  canTransitionCanonicalStatus,
  summarizeCanonicalStatuses,
  type CanonicalStatusProjection,
} from '@grantmaster/shared/canonical';

// Validate a status change
if (!canTransitionCanonicalStatus('progress', 'completed')) {
  throw new Error('Invalid status transition');
}

// Summarize projections for a dashboard widget
const summary = summarizeCanonicalStatuses(projections, {
  domains: ['grant_lifecycle', 'expense_audit'],
});
// => { total: 42, pending: 5, progress: 20, blocked: 3, completed: 12, failed: 2 }