zema_standard_schema 0.1.0

Standard Schema adapter for Zema — bridges zema with the standard_schema contract.

zema_standard_schema

Standard Schema adapter for Zema. Bridges any ZemaSchema into a StandardSchemaV1-compliant object that CLI frameworks, form libraries, and other Standard Schema consumers can use.

What is Standard Schema?

Standard Schema is a vendor-neutral contract that lets unrelated Dart libraries validate values through a shared interface. A validator implements one capability, a consumer accepts it once, and application developers pass their normal schema object directly.

Installation

dependencies:
  zema: ^0.6.0
  zema_standard_schema: ^0.1.0
  standard_schema: ^0.0.1

import 'package:zema/zema.dart';
import 'package:zema_standard_schema/zema_standard_schema.dart';

Quick start

final emailSchema = z.string().email().min(3);

// Wrap with .asStandard and use with any Standard Schema consumer
final standard = emailSchema.asStandard;

final result = standard.standard.validate('not-an-email');
if (result is StandardFailure) {
  for (final issue in result.issues) {
    print('${issue.path.join(".")}: ${issue.message}');
  }
}

Usage with Mamba CLI

import 'package:zema/zema.dart';
import 'package:zema_standard_schema/zema_standard_schema.dart';

// Define your schema with Zema
final userSchema = z.object({
  'name': z.string().min(2),
  'email': z.string().email(),
  'age': z.int().gte(0),
});

// Expose it as Standard Schema without modifying the original
final standard = userSchema.asStandard;

// Pass to Mamba or any other StandardSchemaV1-aware consumer
void validateInput(StandardSchemaV1<Object?, Object?> schema, Object? value) {
  final result = schema.standard.validate(value);
  if (result is StandardFailure) {
    for (final issue in result.issues) {
      print('${issue.path.join(".")}: ${issue.message}');
    }
  }
}

How it works

ZemaStandardAdapter wraps a ZemaSchema and implements StandardSchemaV1. When validate() is called, it forwards to safeParse() and maps the result:

Zema	Standard Schema
ZemaSuccess(value)	StandardSuccess(value)
ZemaFailure(errors)	StandardFailure with mapped issues

ZemaIssue fields are mapped to StandardIssue as follows:

ZemaIssue field	StandardIssue field	Notes
message	message	Direct mapping
path	path	Same structure (String or int)
code	not mapped	Standard Schema V1 does not define a code field
receivedValue	not mapped	Debug context, not in the spec
meta	not mapped	Debug context, not in the spec

Limitations

• Sync only. StandardSchemaV1.validate is synchronous in the spec. The adapter uses safeParse() (sync). If you need async validation, call the Zema API directly.
• Warnings filtered. Zema warning-level issues (refineWarn) are filtered out because Standard Schema does not have a warning concept. They remain accessible via ZemaResult.warnings when using the Zema API directly.

API reference

Member	Description
ZemaStandardAdapter(schema)	Wraps a ZemaSchema as a StandardSchemaV1
schema.asStandard	Extension getter that returns a StandardSchemaV1
zemaIssueToStandard(issue)	Maps a single ZemaIssue to a StandardIssue
zemaIssuesToStandard(issues)	Maps a list of ZemaIssues, filtering out warnings

License

BSD-3-Clause. See LICENSE for details.