@forgrit/shared-contracts-platform

Type-only contracts + NestJS DI Symbol tokens for the ForGrit platform infrastructure layer — auth (RoleGuard), logger (ILoggerService), db (IPrismaService).

Status: early-access (v0.x). Internal-monorepo seam package extracted for public consumption. Pre-1.0 releases may include breaking changes in minor bumps.

Type-only + Symbol-token package. Zero runtime logic. Consumers wire their own concrete implementations.

Install

npm install @forgrit/shared-contracts-platform

Peer: @nestjs/common (for @Injectable, guards, decorators).

Sub-modules

// Top-level barrel
import { ... } from '@forgrit/shared-contracts-platform';

// Sub-paths
import { IPrismaService, PRISMA_SERVICE } from '@forgrit/shared-contracts-platform/db';
import { ILoggerService, LOGGER_SERVICE } from '@forgrit/shared-contracts-platform/logger';
import { RoleGuard, Roles, IAuthUser } from '@forgrit/shared-contracts-platform/auth';

Pattern (use with useExisting)

@Module({
  providers: [
    MyPrismaService, // your concrete impl
    { provide: PRISMA_SERVICE, useExisting: MyPrismaService }, // wire token → concrete
  ],
  exports: [PRISMA_SERVICE],
})
export class PlatformProvidersModule {}

License

MIT — see LICENSE.

Sibling packages

• @forgrit/contracts — domain Zod schemas + types
• @forgrit/shared-contracts-jobs-queue — IJobsService / IQueueService contracts
• @forgrit/shared-contracts-prompt — prompt-pipeline contracts
• @forgrit/shared-contracts-design-composition — design-composition contracts