# abenezeratnafu/better-media architecture

> Architecture diagram of the GitHub repository abenezeratnafu/better-media, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-06-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abenezeratnafu/better-media
- Repository: https://github.com/abenezeratnafu/better-media

## Overview

1. **Repository shape**
   This is a TypeScript monorepo centered on a media-processing framework. The root packages split into four architectural layers: `core` contracts, `better-media` orchestration/runtime, `adapters` for infrastructure, and `plugins` for pipeline behavior. There are also framework examples (`express`, `nestjs`, `nextjs`) and a separate `platform` app that serves docs/blog content.

2. **Core is the boundary layer**
   `packages/core` defines the stable interfaces and shared types only. It contains contracts for storage, database, jobs, plugins, runtime context, hook names/modes, and media metadata. This is the main architectural boundary: everything else plugs into these interfaces rather than depending on concrete infrastructure.

3. **Framework orchestrates the pipeline**
   `packages/better-media` is the executable framework layer. Its internal modules suggest the runtime flow: `file-loader`, `lifecycle-engine`, `pipeline-executor`, `secure-context`, `streaming-router`, `job-runner`, webhook emission, and a small PostgreSQL helper. This package wires adapters and plugins together and coordinates the upload lifecycle, but does not own the infrastructure implementations.

4. **Primary data flow**
   The typical flow is: an application receives media input, the framework loads/normalizes the file, runs plugin hooks, persists metadata/state through the database adapter, stores the binary through the storage adapter, and emits events/webhooks as needed. For background work, the framework serializes a job payload containing file key, metadata, hook name, and plugin name, then hands it to the job system.

5. **Plugin pipeline**
   Plugins are the functional units of the framework and are organized by hook-based lifecycle execution. The repo includes validation, virus scanning, media processing, audio streaming, and video streaming plugins. Each plugin has its own runtime helpers and options types, and can run either synchronously during the request or asynchronously in the background.

6. **Background jobs are optional and adapter-driven**
   `packages/adapters/jobs` and `packages/adapters/jobs-bullmq` show that background execution is abstracted behind a job adapter. The framework itself does not implement queue polling or scheduling; a worker process owns that. The BullMQ package includes a worker helper, reinforcing that background processing is an external runtime concern rather than part of the core framework loop.

7. **Storage is a pluggable persistence boundary**
   Storage adapters live under `packages/adapters/storages`. The repo supports memory, filesystem, S3, and GCS backends. This is the main binary-blob persistence boundary, and the examples indicate the filesystem adapter is compatible with local multipart ingest flows while S3/GCS support cloud or object-store deployments.

8. **Database is a separate metadata boundary**
   Database adapters live under `packages/adapters/databases` and include in-memory, Kysely-based SQL, and MongoDB implementations. The `core` package also has database schema/migration utilities, so persistent media state and lifecycle records are modeled separately from raw file storage. The architecture keeps metadata persistence independent from blob storage.

9. **Infrastructure plugins and runtime add-ons**
   The `validation-plugin` includes validators for file type, size, dimensions, filename, checksum uniqueness, and security scanning. The virus-scan plugin has concrete scanners for ClamAV and VirusTotal. These plugins indicate the framework is designed to insert policy/security checks into the upload lifecycle before or alongside processing/storage.

10. **Integration examples define the app boundary**
   The `examples/express`, `examples/nestjs`, and `examples/nextjs` apps demonstrate how host applications integrate the framework in different runtimes. They show API routes, workers, and framework modules rather than a single built-in server, which means the repo is a library/platform architecture, not a standalone application.

11. **Public documentation site is separate from runtime**
   `platform` is a Next.js app that serves the website, documentation, blog, and search API. It is content/marketing infrastructure for the project, not part of the media pipeline itself. Still, its docs mirror the architecture in the codebase, so it reflects how the system is intended to be deployed and used.

12. **Tooling and release model**
   The repo uses pnpm workspaces, Turbo, tsup builds, Jest tests, ESLint/Prettier, GitHub Actions, Changesets, and Husky. These tools support a multi-package library release workflow, which matches the modular architecture: packages are versioned and shipped independently but share a common TypeScript build and test system.

Main entry points: [`packages/core`](https://github.com/abenezeratnafu/better-media/tree/main/packages/core) (Core contracts), [`packages/better-media/src/core/pipeline-executor.ts`](https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/core/pipeline-executor.ts) (Pipeline executor), [`packages/better-media/src`](https://github.com/abenezeratnafu/better-media/tree/main/packages/better-media/src) (Framework entry), [`packages/better-media/src/core/lifecycle-engine.ts`](https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/core/lifecycle-engine.ts) (Lifecycle engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_core["Core boundary"]
  node_core_contracts["Core contracts<br/>interfaces + schema"]
  node_core_db_schema["DB schema<br/>migration + plan"]
  node_core_adapter_lookup(("Adapter lookup<br/>resolver"))
end

subgraph group_group_runtime["Framework runtime"]
  node_runtime_entry["Framework entry<br/>public API"]
  node_file_loader["File loader<br/>ingest<br/>[file-loader.ts]"]
  node_lifecycle_engine{{"Lifecycle engine<br/>hook orchestrator"}}
  node_pipeline_executor{{"Pipeline executor<br/>pipeline runner"}}
  node_secure_context(("Secure context<br/>runtime guard<br/>[secure-context.ts]"))
  node_stream_router["Stream router<br/>stream routing"]
  node_job_runner["Job runner<br/>background dispatch<br/>[job-runner.ts]"]
  node_webhook_emitter["Webhook emitter<br/>events<br/>[webhook-emitter.ts]"]
  node_postgres_helper[("Postgres helper<br/>db helper<br/>[postgres.ts]")]
end

subgraph group_group_adapters["Adapters"]
  node_storage_memory[("Memory storage<br/>storage adapter")]
  node_storage_fs[("Filesystem storage<br/>storage adapter")]
  node_storage_s3[("S3 storage<br/>storage adapter")]
  node_storage_gcs[("GCS storage<br/>storage adapter")]
  node_db_memory[("Memory DB<br/>db adapter")]
  node_db_kysely[("SQL DB<br/>db adapter")]
  node_db_mongo[("Mongo DB<br/>db adapter")]
  node_jobs_adapter["Jobs API<br/>job adapter"]
  node_bullmq_worker["BullMQ worker<br/>job runtime"]
end

subgraph group_group_plugins["Plugins"]
  node_validation_plugin{{"Validation<br/>plugin"}}
  node_media_processing_plugin{{"Media processing<br/>plugin"}}
  node_virus_scan_plugin{{"Virus scan<br/>plugin"}}
  node_audio_streaming_plugin{{"Audio streaming<br/>plugin"}}
  node_video_processing_plugin{{"Video processing<br/>plugin"}}
  node_video_streaming_plugin{{"Video streaming<br/>plugin"}}
end

subgraph group_group_apps["Apps"]
  node_express_example["Express example<br/>integration app"]
  node_nestjs_example["NestJS example<br/>integration app"]
  node_nextjs_example["Next.js example<br/>integration app"]
  node_platform_site["Platform site<br/>docs app"]
end

node_runtime_entry -->|"uses contracts"| node_core_contracts
node_runtime_entry -->|"loads files"| node_file_loader
node_file_loader -->|"starts lifecycle"| node_lifecycle_engine
node_lifecycle_engine -->|"runs hooks"| node_pipeline_executor
node_pipeline_executor -->|"isolates runtime"| node_secure_context
node_lifecycle_engine -->|"offloads work"| node_job_runner
node_job_runner -->|"dispatches jobs"| node_jobs_adapter
node_jobs_adapter -->|"implemented by"| node_bullmq_worker
node_lifecycle_engine -->|"emits events"| node_webhook_emitter
node_runtime_entry -->|"serves streams"| node_stream_router
node_runtime_entry -->|"uses postgres"| node_postgres_helper
node_runtime_entry -->|"resolves adapters"| node_core_adapter_lookup
node_core_contracts -->|"storage contract"| node_storage_memory
node_core_contracts -->|"storage contract"| node_storage_fs
node_core_contracts -->|"storage contract"| node_storage_s3
node_core_contracts -->|"storage contract"| node_storage_gcs
node_core_contracts -->|"db contract"| node_db_memory
node_core_contracts -->|"db contract"| node_db_kysely
node_core_contracts -->|"db contract"| node_db_mongo
node_core_contracts -->|"job contract"| node_jobs_adapter
node_core_contracts -->|"plugin contract"| node_validation_plugin
node_core_contracts -->|"plugin contract"| node_media_processing_plugin
node_core_contracts -->|"plugin contract"| node_virus_scan_plugin
node_core_contracts -->|"plugin contract"| node_audio_streaming_plugin
node_core_contracts -->|"plugin contract"| node_video_processing_plugin
node_core_contracts -->|"plugin contract"| node_video_streaming_plugin
node_pipeline_executor -->|"invokes"| node_validation_plugin
node_pipeline_executor -->|"invokes"| node_media_processing_plugin
node_pipeline_executor -->|"invokes"| node_virus_scan_plugin
node_pipeline_executor -->|"invokes"| node_audio_streaming_plugin
node_pipeline_executor -->|"invokes"| node_video_processing_plugin
node_pipeline_executor -->|"invokes"| node_video_streaming_plugin
node_express_example -->|"integrates"| node_runtime_entry
node_nestjs_example -->|"integrates"| node_runtime_entry
node_nextjs_example -->|"integrates"| node_runtime_entry
node_platform_site -->|"documents"| node_core_contracts

click node_core_contracts "https://github.com/abenezeratnafu/better-media/tree/main/packages/core"
click node_core_db_schema "https://github.com/abenezeratnafu/better-media/tree/main/packages/core/src/database"
click node_core_adapter_lookup "https://github.com/abenezeratnafu/better-media/tree/main/packages/core/src/adapter"
click node_runtime_entry "https://github.com/abenezeratnafu/better-media/tree/main/packages/better-media/src"
click node_file_loader "https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/core/file-loader.ts"
click node_lifecycle_engine "https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/core/lifecycle-engine.ts"
click node_pipeline_executor "https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/core/pipeline-executor.ts"
click node_secure_context "https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/core/secure-context.ts"
click node_stream_router "https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/stream/streaming-router.ts"
click node_job_runner "https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/jobs/job-runner.ts"
click node_webhook_emitter "https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/events/webhook-emitter.ts"
click node_postgres_helper "https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/db/postgres.ts"
click node_storage_memory "https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/storages/storage-memory"
click node_storage_fs "https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/storages/storage-filesystem"
click node_storage_s3 "https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/storages/storage-s3"
click node_storage_gcs "https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/storages/storage-gcs"
click node_db_memory "https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/databases/db-memory"
click node_db_kysely "https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/databases/db-kysely"
click node_db_mongo "https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/databases/mongodb-adapter"
click node_jobs_adapter "https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/jobs"
click node_bullmq_worker "https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/jobs-bullmq"
click node_validation_plugin "https://github.com/abenezeratnafu/better-media/tree/main/packages/plugins/validation-plugin"
click node_media_processing_plugin "https://github.com/abenezeratnafu/better-media/tree/main/packages/plugins/media-processing-plugin"
click node_virus_scan_plugin "https://github.com/abenezeratnafu/better-media/tree/main/packages/plugins/virus-scan-plugin"
click node_audio_streaming_plugin "https://github.com/abenezeratnafu/better-media/tree/main/packages/plugins/audio-streaming-plugin"
click node_video_processing_plugin "https://github.com/abenezeratnafu/better-media/tree/main/packages/plugins/video-processing-plugin"
click node_video_streaming_plugin "https://github.com/abenezeratnafu/better-media/tree/main/packages/plugins/video-streaming-plugin"
click node_express_example "https://github.com/abenezeratnafu/better-media/tree/main/examples/express"
click node_nestjs_example "https://github.com/abenezeratnafu/better-media/tree/main/examples/nestjs"
click node_nextjs_example "https://github.com/abenezeratnafu/better-media/tree/main/examples/nextjs"
click node_platform_site "https://github.com/abenezeratnafu/better-media/tree/main/platform"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_core_contracts,node_core_db_schema,node_core_adapter_lookup toneBlue
class node_runtime_entry,node_file_loader,node_lifecycle_engine,node_pipeline_executor,node_secure_context,node_stream_router,node_job_runner,node_webhook_emitter,node_postgres_helper toneAmber
class node_storage_memory,node_storage_fs,node_storage_s3,node_storage_gcs,node_db_memory,node_db_kysely,node_db_mongo,node_jobs_adapter,node_bullmq_worker toneMint
class node_validation_plugin,node_media_processing_plugin,node_virus_scan_plugin,node_audio_streaming_plugin,node_video_processing_plugin,node_video_streaming_plugin toneRose
class node_express_example,node_nestjs_example,node_nextjs_example,node_platform_site toneIndigo
```

## Components

### Core boundary

Stable contracts, shared types, and schema utilities.

- [Core contracts](https://github.com/abenezeratnafu/better-media/tree/main/packages/core): interfaces + schema · Stable plugin, storage, job, and database contracts plus shared metadata and hook types. · `packages/core`
- [DB schema](https://github.com/abenezeratnafu/better-media/tree/main/packages/core/src/database): migration + plan · Database schema, migration planning, naming, SQL, and Postgres helpers. · `packages/core/src/database`
- [Adapter lookup](https://github.com/abenezeratnafu/better-media/tree/main/packages/core/src/adapter): resolver · Utilities for selecting or resolving the active adapter implementation. · `packages/core/src/adapter`

### Framework runtime

Executable orchestration layer that wires files, hooks, jobs, storage, and events.

- [Framework entry](https://github.com/abenezeratnafu/better-media/tree/main/packages/better-media/src): public API · Main package exports and CLI entry point for the media framework. · `packages/better-media/src`
- [File loader](https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/core/file-loader.ts): ingest · Normalizes incoming media input before lifecycle execution. · `packages/better-media/src/core/file-loader.ts`
- [Lifecycle engine](https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/core/lifecycle-engine.ts): hook orchestrator · Coordinates hook order and lifecycle state across plugins and persistence. · `packages/better-media/src/core/lifecycle-engine.ts`
- [Pipeline executor](https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/core/pipeline-executor.ts): pipeline runner · Executes plugin pipeline steps and bridges sync and async processing. · `packages/better-media/src/core/pipeline-executor.ts`
- [Secure context](https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/core/secure-context.ts): runtime guard · Builds a constrained execution context for plugins and framework internals. · `packages/better-media/src/core/secure-context.ts`
- [Stream router](https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/stream/streaming-router.ts): stream routing · Routes streaming reads and helpers for media delivery flows. · `packages/better-media/src/stream/streaming-router.ts`
- [Job runner](https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/jobs/job-runner.ts): background dispatch · Turns lifecycle work into job payloads and hands them to the configured job adapter. · `packages/better-media/src/jobs/job-runner.ts`
- [Webhook emitter](https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/events/webhook-emitter.ts): events · Emits lifecycle events and webhook notifications after framework actions. · `packages/better-media/src/events/webhook-emitter.ts`
- [Postgres helper](https://github.com/abenezeratnafu/better-media/blob/main/packages/better-media/src/db/postgres.ts): db helper · Small PostgreSQL integration helper used by the runtime package. · `packages/better-media/src/db/postgres.ts`

### Adapters

Pluggable infrastructure implementations for storage, database, and jobs.

- [Memory storage](https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/storages/storage-memory): storage adapter · In-memory blob storage backend for tests and lightweight deployments. · `packages/adapters/storages/storage-memory`
- [Filesystem storage](https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/storages/storage-filesystem): storage adapter · Local filesystem backend for multipart and on-disk media flows. · `packages/adapters/storages/storage-filesystem`
- [S3 storage](https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/storages/storage-s3): storage adapter · Object-storage backend for S3 deployments. · `packages/adapters/storages/storage-s3`
- [GCS storage](https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/storages/storage-gcs): storage adapter · Object-storage backend for Google Cloud Storage deployments. · `packages/adapters/storages/storage-gcs`
- [Memory DB](https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/databases/db-memory): db adapter · In-memory metadata store for development and testing. · `packages/adapters/databases/db-memory`
- [SQL DB](https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/databases/db-kysely): db adapter · Kysely-based relational metadata adapter. · `packages/adapters/databases/db-kysely`
- [Mongo DB](https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/databases/mongodb-adapter): db adapter · MongoDB metadata adapter for document persistence. · `packages/adapters/databases/mongodb-adapter`
- [Jobs API](https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/jobs): job adapter · Abstract job adapter boundary used by the framework for background execution. · `packages/adapters/jobs`
- [BullMQ worker](https://github.com/abenezeratnafu/better-media/tree/main/packages/adapters/jobs-bullmq): job runtime · BullMQ-backed worker helper that owns queue polling and execution. · `packages/adapters/jobs-bullmq`

### Plugins

Hook-driven pipeline behavior for validation, processing, and streaming.

- [Validation](https://github.com/abenezeratnafu/better-media/tree/main/packages/plugins/validation-plugin): plugin · File type, size, dimensions, filename, checksum, and security validation hooks. · `packages/plugins/validation-plugin`
- [Media processing](https://github.com/abenezeratnafu/better-media/tree/main/packages/plugins/media-processing-plugin): plugin · General media transformation and processing hook implementation. · `packages/plugins/media-processing-plugin`
- [Virus scan](https://github.com/abenezeratnafu/better-media/tree/main/packages/plugins/virus-scan-plugin): plugin · Virus scanning hooks with ClamAV and VirusTotal scanner implementations. · `packages/plugins/virus-scan-plugin`
- [Audio streaming](https://github.com/abenezeratnafu/better-media/tree/main/packages/plugins/audio-streaming-plugin): plugin · Audio streaming and upload-oriented hook runtime. · `packages/plugins/audio-streaming-plugin`
- [Video processing](https://github.com/abenezeratnafu/better-media/tree/main/packages/plugins/video-processing-plugin): plugin · Video transformation and processing hook runtime. · `packages/plugins/video-processing-plugin`
- [Video streaming](https://github.com/abenezeratnafu/better-media/tree/main/packages/plugins/video-streaming-plugin): plugin · Video streaming and upload-oriented hook runtime. · `packages/plugins/video-streaming-plugin`

### Apps

Integration examples and public documentation site.

- [Express example](https://github.com/abenezeratnafu/better-media/tree/main/examples/express): integration app · Express host application showing API and worker integration. · `examples/express`
- [NestJS example](https://github.com/abenezeratnafu/better-media/tree/main/examples/nestjs): integration app · NestJS integration with framework module and controller wiring. · `examples/nestjs`
- [Next.js example](https://github.com/abenezeratnafu/better-media/tree/main/examples/nextjs): integration app · Next.js app routes demonstrating upload and demo endpoints. · `examples/nextjs`
- [Platform site](https://github.com/abenezeratnafu/better-media/tree/main/platform): docs app · Public docs, blog, search API, and marketing pages. · `platform`

## Connections

- Framework entry → Core contracts: uses contracts · Runtime depends on the stable core interfaces and types.
- Framework entry → File loader: loads files · Entry wiring starts media ingestion through the loader.
- File loader → Lifecycle engine: starts lifecycle · Loaded media is passed into the lifecycle orchestration flow.
- Lifecycle engine → Pipeline executor: runs hooks · Lifecycle engine delegates hook execution to the pipeline runner.
- Pipeline executor → Secure context: isolates runtime · Plugins run inside a constrained secure context.
- Lifecycle engine → Job runner: offloads work · Async lifecycle steps can be serialized into background jobs.
- Job runner → Jobs API: dispatches jobs · Background work is handed to the configured job adapter boundary.
- Jobs API → BullMQ worker: implemented by · BullMQ provides the concrete worker/queue runtime.
- Lifecycle engine → Webhook emitter: emits events · Lifecycle transitions can produce webhook and event notifications.
- Framework entry → Stream router: serves streams · Runtime exposes streaming delivery paths for media access.
- Framework entry → Postgres helper: uses postgres · Framework package includes a small Postgres-specific helper.
- Framework entry → Adapter lookup: resolves adapters · Runtime selects infrastructure implementations through core adapter lookup.
- Core contracts → Memory storage: storage contract · Memory storage implements the core storage boundary.
- Core contracts → Filesystem storage: storage contract · Filesystem storage implements the core storage boundary.
- Core contracts → S3 storage: storage contract · S3 storage implements the core storage boundary.
- Core contracts → GCS storage: storage contract · GCS storage implements the core storage boundary.
- Core contracts → Memory DB: db contract · Memory database implements the metadata boundary.
- Core contracts → SQL DB: db contract · Kysely adapter implements the metadata boundary.
- Core contracts → Mongo DB: db contract · MongoDB adapter implements the metadata boundary.
- Core contracts → Jobs API: job contract · Job adapter interface is defined at the core boundary.
- Core contracts → Validation: plugin contract · Plugins are typed against shared core plugin interfaces.
- Core contracts → Media processing: plugin contract · Plugins are typed against shared core plugin interfaces.
- Core contracts → Virus scan: plugin contract · Plugins are typed against shared core plugin interfaces.
- Core contracts → Audio streaming: plugin contract · Plugins are typed against shared core plugin interfaces.
- Core contracts → Video processing: plugin contract · Plugins are typed against shared core plugin interfaces.
- Core contracts → Video streaming: plugin contract · Plugins are typed against shared core plugin interfaces.
- Pipeline executor → Validation: invokes · Validation can run as an early lifecycle hook.
- Pipeline executor → Media processing: invokes · Media processing executes as part of the hook pipeline.
- Pipeline executor → Virus scan: invokes · Virus scanning participates in the pipeline as policy enforcement.
- Pipeline executor → Audio streaming: invokes · Audio streaming plugin participates in streaming-oriented hooks.
- Pipeline executor → Video processing: invokes · Video processing plugin participates in transformation hooks.
- Pipeline executor → Video streaming: invokes · Video streaming plugin participates in delivery hooks.
- Express example → Framework entry: integrates · Express example shows host app integration with the framework.
- NestJS example → Framework entry: integrates · NestJS example shows module-based framework integration.
- Next.js example → Framework entry: integrates · Next.js example shows route-level framework integration.
- Platform site → Core contracts: documents · Docs site reflects the public architecture and reference model.
