Schémas Effect avec vérification de type

VérifiéSûr

Définissez des schémas Effect vérifiés par rapport aux types de domaine. Utilisez pour créer ou mettre à jour des définitions de schémas Effect avec assurance de parité de type.

Spar Skills Guide Bot
DeveloppementIntermédiaire
3002/06/2026
Claude Code
#effect#schema#typescript#type-parity#tsafe

Recommandé pour

Notre avis

Définit des schémas Effect vérifiés par rapport à des types de domaine, en utilisant 'satisfies' et 'assert<Equals>' pour garantir la cohérence.

Points forts

  • Assure une correspondance stricte entre les types et les schémas.
  • Utilise des vérifications à la compilation avec tsafe.
  • Détecte les divergences entre le schéma et le type de domaine.

Limites

  • Nécessite une connaissance de Effect et de tsafe.
  • La vérification d'égalité peut être verbeuse.
  • Ne couvre pas les validations avancées sans fonctions personnalisées.
Quand l'utiliser

Lors de la définition de nouveaux schémas Effect ou de la mise à jour de schémas existants pour assurer la parité avec les types d'interface.

Quand l'éviter

Pour des schémas simples où la cohérence des types est évidente ou lorsque le projet n'utilise pas Effect.

Analyse de sécurité

Sûr
Score qualité85/100

The skill only provides instructions for defining TypeScript types and Effect schemas with compile-time parity checks. It involves no execution of code, network access, or file system operations.

Aucun point d'attention détecté

Exemples

Define an Effect schema with type parity
Create an Effect schema for an interface IUser with fields name (string) and age (number). Use 'satisfies' and add an assert<Equals> check.
Fix schema type mismatch
My Effect schema for IFoo has a type mismatch with the interface. Add parity checks using tsafe and correct the schema.

name: effect-schema description: Define Effect schemas that are verified against domain types. Use when authoring or updating Effect Schema definitions, or when the user mentions schema/type parity, satisfies, or tsafe Equals checks.

Effect Schema Type Parity

Instructions

  • Define the domain type first (prefer interface), then define the schema and assert parity.
  • Always use satisfies Schema.Schema<YourType, any> on the schema.
  • Add assert<Equals<typeof YourSchema.Type, Readonly<YourType>>>() using tsafe.
  • If the assert<Equals<...>> isn't typed correctly but the satisfies is, you can optionally add the _check1/_check2 assignments with void (see ZerospinCommandSchema).
  • When validating unknown input against an Effect schema, prefer validateUnknown from zerospin if available.

Example

import type { Equals } from 'tsafe';

import { Schema } from 'effect';
import { assert } from 'tsafe';

export interface IFoo {
  bar: string;
}

export const ZFoo = Schema.Struct({
  bar: Schema.String,
}) satisfies Schema.Schema<IFoo, any>;

const _check1: typeof ZFoo.Type = {} as IFoo;
const _check2: IFoo = {} as typeof ZFoo.Type;
void _check1;
void _check2;
assert<Equals<typeof ZFoo.Type, Readonly<IFoo>>>();
Skills similaires