@apollo-deploy/core

Shared business logic, types, and infrastructure for the Apollo Deploy platform.

This package provides the foundational layer consumed by all Apollo applications in the monorepo. It contains no UI components — only services, state management, types, hooks, and utilities.

Architecture

src/
├── auth/                        # Authentication domain
│   ├── mfa/                     # Multi-factor authentication
│   └── passkey/                 # WebAuthn/Passkey support
│
├── client/                      # Apollo SDK client integration
│
├── data/                        # Data layer
│   ├── providers/               # React data providers
│   └── stores/                  # Zustand state management
│
├── errors/                      # API error handling
│
├── hooks/                       # Shared React hooks
│
├── logger/                      # Logging infrastructure
│
├── types/                       # Shared TypeScript types (deprecated)
│
└── utils/                       # Utilities & libraries
    ├── callback.ts              # URL/callback generation
    ├── time.ts                  # Date/time arithmetic
    ├── eventloop-tasks/         # Async primitives (wait, microtask, etc.)
    ├── favicon/                 # Favicon manipulation
    ├── formatters/              # Date formatting (date-fns)
    ├── fuzzy-filter/            # Fuzzy string matching
    ├── lru-map/                 # LRU cache Map
    ├── observable/              # Observable values, sets, maps
    ├── platform/                # Platform-specific (Android permissions)
    ├── react-observable/        # React bindings for observables
    ├── relative-time/           # Relative time formatting & component
    ├── scheduler/               # Priority-based task scheduling
    ├── user-agent/              # UA parsing & display component
    └── visible/                 # DOM visibility detection

Import Paths

| Import Path | Description | |---|---| | @apollo-deploy/core | Root barrel — re-exports everything | | @apollo-deploy/core/sdk | Apollo SDK client, provider, hooks | | @apollo-deploy/core/store | All Zustand stores | | @apollo-deploy/core/providers | React data providers | | @apollo-deploy/core/mfa | Multi-factor authentication | | @apollo-deploy/core/passkey | WebAuthn/Passkey support | | @apollo-deploy/core/hooks | Shared React hooks | | @apollo-deploy/core/logger | Logging facade | | @apollo-deploy/core/errors | Error codes and messages | | @apollo-deploy/core/types | Shared TypeScript types | | @apollo-deploy/core/formatters | Date formatting | | @apollo-deploy/core/eventloop-tasks | Async scheduling primitives | | @apollo-deploy/core/scheduler | Priority task scheduler | | @apollo-deploy/core/observable | Observable data structures | | @apollo-deploy/core/react-observable | React observable bindings | | @apollo-deploy/core/fuzzy-filter | Fuzzy string matching | | @apollo-deploy/core/lru-map | LRU cache | | @apollo-deploy/core/favicon | Favicon utilities | | @apollo-deploy/core/visible | DOM visibility detection | | @apollo-deploy/core/platform | Platform utilities (Android) | | @apollo-deploy/core/relative-time | Relative time formatting | | @apollo-deploy/core/user-agent | UA parsing & display | | @apollo-deploy/core/utils | All utilities combined |

Development

bun run typecheck
bun run lint