open-index/open-npm huggingface dataset:
npm package: @foundrynorth/compass-schema
Description: Canonical Drizzle ORM schema for Foundry Compass (rough-waterfall database)
Latest version: 1.0.22

# @foundrynorth/compass-schema

Canonical Drizzle ORM schema for the Foundry Compass database (`rough-waterfall-94134914`). 161 tables, 27 enums.

## Install

```bash
npm install @foundrynorth/compass-schema
```

## Usage

```typescript
import { mediaOrders, partners, plans } from "@foundrynorth/compass-schema";
import { relations } from "@foundrynorth/compass-schema/relations";
```

| Export | Purpose |
|--------|---------|
| `@foundrynorth/compass-schema` | All table and enum definitions |
| `@foundrynorth/compass-schema/relations` | Drizzle relation definitions |

## Consumers

- **fn-legacy** (Compass) — also keeps a local copy in `shared/schema.ts` (drift-checked)
- **fn-worker** (BullMQ processor)
- **fn-v2** (Trigger.dev tasks)

## Schema Change Workflow

**Only fn-legacy has `drizzle-kit push` authority** for this database.

1. Edit `src/schema.ts` in this repo
2. `npm run build && npm version patch && npm publish`
3. Update fn-legacy: `npm install @foundrynorth/compass-schema@latest`
4. Also update fn-legacy's `shared/schema.ts` (local copy)
5. Run `npm run check` in fn-legacy to verify no drift
6. Run `npm run db:push` in fn-legacy to apply to database
7. Update fn-worker and fn-v2 to the new version

## Full Documentation

See [fn-docs: Shared Packages](https://fn-docs.vercel.app/docs/compass-v2/shared-packages) for the complete publish workflow and consumer matrix.
npm package: @foundrynorth/core
Description: Shared resilience, observability, and event utilities for Foundry North platforms
Latest version: 1.0.1

# @foundrynorth/core

Shared resilience, observability, event, environment, type, text, and cache utilities for Foundry North platforms.

## Install

```bash
npm install @foundrynorth/core
```

## Subpath Exports

This package uses subpath exports — import from the specific module you need:

```typescript
import { withRetry, circuitBreaker } from "@foundrynorth/core/resilience";
import { createLogger } from "@foundrynorth/core/observability";
import { signHmac, verifyHmac } from "@foundrynorth/core/events";
import { requireEnv, optionalEnv } from "@foundrynorth/core/env";
import { slugify, truncate } from "@foundrynorth/core/text";
import { createCache } from "@foundrynorth/core/cache";
```

| Export | Purpose |
|--------|---------|
| `@foundrynorth/core/resilience` | Retry with backoff, circuit breaker, timeout wrapper |
| `@foundrynorth/core/observability` | Structured logging, metric helpers |
| `@foundrynorth/core/events` | HMAC signing/verification for cross-app events |
| `@foundrynorth/core/env` | Type-safe environment variable access |
| `@foundrynorth/core/types` | Shared TypeScript types |
| `@foundrynorth/core/text` | Text manipulation utilities |
| `@foundrynorth/core/cache` | Caching utilities |

## Consumers

- **fn-legacy** (Compass)
- **fn-flux** (Compass Ops)
- **fn-worker** (BullMQ processor)

## Development

```bash
npm run build    # Compile TypeScript
npm version patch  # Bump version
npm publish      # Publish to npm
```

After publishing, update consumers: `npm install @foundrynorth/core@latest`

## Full Documentation

See [fn-docs: Shared Packages](https://fn-docs.vercel.app/docs/compass-v2/shared-packages) for detailed API reference and publish workflow.