# Fix Provider

> Fix Provider, Collector, Transformer compilation errors

- Skill: `wrtnlabs/fix-provider` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wrtnlabs/fix-provider`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wrtnlabs/fix-provider/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: wrtnlabs (https://skillmd.com/u/wrtnlabs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wrtnlabs/fix-provider

---


# Fix Provider Errors

Fix provider, collector, and transformer compilation errors according to code conventions.

## FORBIDDEN

**NEVER use:**
- `as` keyword (type assertion)
- `any` type

Fix type issues by properly defining Collectors and Transformers.

---

## Purpose

Fix compilation errors in provider files to ensure `npm run build:main` passes.

## Workflow

```
┌─────────────────────────────────────┐
│  Step 1: Run Build                  │
│  npm run build:main                 │
└───────────────┬─────────────────────┘
                │
                ▼
┌─────────────────────────────────────┐
│  Step 2: Parse Provider Errors      │
│  - as any usage                     │
│  - Type mismatches                  │
│  - Missing imports                  │
└───────────────┬─────────────────────┘
                │
                ▼
┌─────────────────────────────────────┐
│  Step 3: Fix by Convention          │
│  - Create Collectors                │
│  - Create Transformers              │
│  - Remove type assertions           │
└───────────────┬─────────────────────┘
                │
                ▼
┌─────────────────────────────────────┐
│  Step 4: Re-run Build               │
│  Loop until 0 errors                │
└─────────────────────────────────────┘
```

---

## Step 1: Run Build

```bash
npm run build:main 2>&1 | head -100
```

Capture provider-related errors.

---

## Step 2: Find Issues

```bash
# Find as any usage
grep -rn "as any" src/providers/ --include="*.ts"

# Find any type
grep -rn ": any" src/providers/ --include="*.ts"

# Find type assertions
grep -rn " as " src/providers/ --include="*.ts" | grep -v "import"
```

---

## Step 3: Fix by Convention

### Create Collector (if missing)

```typescript
// src/collectors/{Prefix}{Entity}Collector.ts
import { I{Prefix}{Entity} } from "@ORGANIZATION/PROJECT-api/lib/structures/I{Prefix}{Entity}";
import { Prisma } from "@prisma/sdk";
import { v4 } from "uuid";

export namespace {Prefix}{Entity}Collector {
  export function collect(props: {
    body: I{Prefix}{Entity}.ICreate;
  }): Prisma.{table_name}CreateInput {
    const id = v4();
    const now = new Date();

    return {
      id,
      field_name: props.body.field_name,
      optional_field: props.body.optional_field ?? null,
      parent: props.body.parent_id
        ? { connect: { id: props.body.parent_id } }
        : undefined,
      created_at: now,
      updated_at: now,
      deleted_at: null,
    };
  }
}
```

### Create Transformer (if missing)

```typescript
// src/transformers/{Prefix}{Entity}Transformer.ts
import { I{Prefix}{Entity} } from "@ORGANIZATION/PROJECT-api/lib/structures/I{Prefix}{Entity}";
import { {table_name} } from "@prisma/sdk";

export namespace {Prefix}{Entity}Transformer {
  export function transform(record: {table_name}): I{Prefix}{Entity} {
    return {
      id: record.id,
      name: record.name,
      status: record.status,
      created_at: record.created_at.toISOString(),
      updated_at: record.updated_at.toISOString(),
      deleted_at: record.deleted_at
        ? record.deleted_at.toISOString()
        : null,
    };
  }

  export function toSummary(record: {table_name}): I{Prefix}{Entity}.ISummary {
    return {
      id: record.id,
      name: record.name,
      status: record.status,
      created_at: record.created_at.toISOString(),
    };
  }

  export function transformMany(records: {table_name}[]): I{Prefix}{Entity}[] {
    return records.map(transform);
  }

  export function toSummaryList(records: {table_name}[]): I{Prefix}{Entity}.ISummary[] {
    return records.map(toSummary);
  }
}
```

### Fix POST Provider

```typescript
// Before
const createData: any = { ... };
return { id: created.id as string & tags.Format<"uuid">, ... };

// After
import { {Prefix}{Entity}Collector } from "../collectors/{Prefix}{Entity}Collector";
import { {Prefix}{Entity}Transformer } from "../transformers/{Prefix}{Entity}Transformer";

export async function post{Prefix}{Entity}(props: {
  body: I{Prefix}{Entity}.ICreate;
}): Promise<I{Prefix}{Entity}> {
  const data = {Prefix}{Entity}Collector.collect({ body: props.body });
  const created = await MyGlobal.prisma.{table}.create({ data });
  return {Prefix}{Entity}Transformer.transform(created);
}
```

### Fix GET Provider

```typescript
// Before
return {
  id: record.id as string & tags.Format<"uuid">,
  ...
};

// After
import { {Prefix}{Entity}Transformer } from "../transformers/{Prefix}{Entity}Transformer";

export async function get{Prefix}{Entity}(props: { id: string }): Promise<I{Prefix}{Entity}> {
  const record = await MyGlobal.prisma.{table}.findUnique({ where: { id: props.id } });
  if (!record) throw new HttpException("Not found", 404);
  return {Prefix}{Entity}Transformer.transform(record);
}
```

---

## Step 4: Verify

```bash
npm run build:main
```

Repeat Steps 2-4 until no provider errors.

---

## Common Fixes

| Error Pattern | Fix |
|---------------|-----|
| `as any` | Create proper Collector/Transformer |
| Type assertion | Use Transformer for conversion |
| Missing import | Add import statement |
| Null reference | Add null check before transform |

---

## Exit Condition

- `npm run build:main` completes with no errors
- No `as any` in providers
- No type assertions in providers
- All providers use Collector + Transformer