@bsb/base 9.0.5 → 9.1.0

package/lib/interfaces/result.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * BSB (Better-Service-Base) is an event-bus based microservice framework.
  * Copyright (C) 2016 - 2025 BetterCorp (PTY) Ltd
@@ -25,15 +24,6 @@
  * You should have received a copy of the GNU Affero General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Ok = Ok;
-exports.Err = Err;
-exports.mapResult = mapResult;
-exports.mapError = mapError;
-exports.flatMapResult = flatMapResult;
-exports.unwrap = unwrap;
-exports.unwrapOr = unwrapOr;
-exports.fromPromise = fromPromise;
 /**
  * Creates a successful result
  *
@@ -44,7 +34,7 @@ exports.fromPromise = fromPromise;
  * @category Utilities
  * @see {@link https://bsbcode.dev/languages/nodejs/types/functions/Ok.html | API: Ok}
  */
-function Ok(data) {
+export function Ok(data) {
     return { success: true, data };
 }
 /**
@@ -56,7 +46,7 @@ function Ok(data) {
  * @group Errors
  * @category Utilities
  */
-function Err(error) {
+export function Err(error) {
     return { success: false, error };
 }
 /**
@@ -69,7 +59,7 @@ function Err(error) {
  * @group Errors
  * @category Utilities
  */
-function mapResult(result, fn) {
+export function mapResult(result, fn) {
     if (result.success) {
         return Ok(fn(result.data));
     }
@@ -86,7 +76,7 @@ function mapResult(result, fn) {
  * @category Utilities
  * @see {@link https://bsbcode.dev/languages/nodejs/types/functions/mapError.html | API: mapError}
  */
-function mapError(result, fn) {
+export function mapError(result, fn) {
     if (!result.success) {
         return Err(fn(result.error));
     }
@@ -102,7 +92,7 @@ function mapError(result, fn) {
  * @group Errors
  * @category Utilities
  */
-function flatMapResult(result, fn) {
+export function flatMapResult(result, fn) {
     if (result.success) {
         return fn(result.data);
     }
@@ -118,7 +108,7 @@ function flatMapResult(result, fn) {
  * @group Errors
  * @category Utilities
  */
-function unwrap(result) {
+export function unwrap(result) {
     if (result.success) {
         return result.data;
     }
@@ -134,7 +124,7 @@ function unwrap(result) {
  * @group Errors
  * @category Utilities
  */
-function unwrapOr(result, defaultValue) {
+export function unwrapOr(result, defaultValue) {
     if (result.success) {
         return result.data;
     }
@@ -150,7 +140,7 @@ function unwrapOr(result, defaultValue) {
  * @category Utilities
  * @see {@link https://bsbcode.dev/languages/nodejs/types/functions/fromPromise.html | API: fromPromise}
  */
-async function fromPromise(promise) {
+export async function fromPromise(promise) {
     try {
         const data = await promise;
         return Ok(data);

package/lib/interfaces/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/interfaces/result.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;AAsBH,gBAEC;AAWD,kBAEC;AAYD,8BAQC;AAaD,4BAQC;AAYD,sCAQC;AAYD,wBAKC;AAYD,4BAKC;AAYD,kCAOC;AA3ID;;;;;;;;;GASG;AACH,SAAgB,EAAE,CAAI,IAAO;IAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,SAAS,CACvB,MAAoB,EACpB,EAAmB;IAEnB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,QAAQ,CACtB,MAAoB,EACpB,EAAmB;IAEnB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAC3B,MAAoB,EACpB,EAA8B;IAE9B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,MAAM,CAAO,MAAoB;IAC/C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,MAAM,MAAM,CAAC,KAAK,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,QAAQ,CAAO,MAAoB,EAAE,YAAe;IAClE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;;GASG;AACI,KAAK,UAAU,WAAW,CAAI,OAAmB;IACtD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;QAC3B,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/interfaces/result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAYH;;;;;;;;;GASG;AACH,MAAM,UAAU,EAAE,CAAI,IAAO;IAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CACvB,MAAoB,EACpB,EAAmB;IAEnB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAoB,EACpB,EAAmB;IAEnB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAoB,EACpB,EAA8B;IAE9B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CAAO,MAAoB;IAC/C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,MAAM,MAAM,CAAC,KAAK,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAO,MAAoB,EAAE,YAAe;IAClE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,OAAmB;IACtD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;QAC3B,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}

package/lib/interfaces/schema-events.d.ts

@@ -24,7 +24,7 @@
  * You should have received a copy of the GNU Affero General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
-import { BSBType, InferBSBType } from './schema-types';
+import { AnyValiDocument, BSBType, InferBSBType } from './schema-types.js';
 /**
  * Schema definition for a returnable event with input/output validation.
  * Type-branded to ensure returnable events are only used in appropriate categories.
@@ -286,22 +286,7 @@ export type EventCategory = 'emitEvents' | 'onEvents' | 'emitReturnableEvents' |
  * JSON Schema type definition for cross-language code generation.
  * Uses standard JSON Schema format with BSB-specific extensions.
  */
-export interface JSONSchemaType {
-    $schema?: string;
-    type?: string | string[];
-    format?: string;
-    properties?: Record<string, JSONSchemaType>;
-    items?: JSONSchemaType;
-    required?: string[];
-    enum?: any[];
-    description?: string;
-    minLength?: number;
-    maxLength?: number;
-    minimum?: number;
-    maximum?: number;
-    'x-bsb-type'?: string;
-    [key: string]: any;
-}
+export type JSONSchemaType = AnyValiDocument;
 /**
  * Exported event definition in JSON format.
  * Contains all information needed for cross-language client generation.
@@ -316,9 +301,9 @@ export interface EventExportDefinition {
     /** Default timeout in seconds for returnable event calls */
     defaultTimeout?: number;
     /** JSON Schema for input validation */
-    inputSchema: JSONSchemaType;
+    inputSchema: AnyValiDocument;
     /** JSON Schema for output validation (null for fire-and-forget/broadcast) */
-    outputSchema: JSONSchemaType | null;
+    outputSchema: AnyValiDocument | null;
 }
 /**
  * Complete exported schema for a plugin.

package/lib/interfaces/schema-events.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * BSB (Better-Service-Base) is an event-bus based microservice framework.
  * Copyright (C) 2016 - 2025 BetterCorp (PTY) Ltd
@@ -25,12 +24,7 @@
  * You should have received a copy of the GNU Affero General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createFireAndForgetEvent = createFireAndForgetEvent;
-exports.createReturnableEvent = createReturnableEvent;
-exports.createBroadcastEvent = createBroadcastEvent;
-exports.createEventSchemas = createEventSchemas;
-exports.exportEventSchemas = exportEventSchemas;
+import { bsbToJsonSchema } from './schema-types.js';
 /**
  * Helper function to create a fire-and-forget event schema.
  * Type-branded to ensure compile-time category validation.
@@ -40,7 +34,7 @@ exports.exportEventSchemas = exportEventSchemas;
  * @returns Event schema object with type brand
  * @see {@link https://bsbcode.dev/languages/nodejs/types/functions/createFireAndForgetEvent.html | API: createFireAndForgetEvent}
  */
-function createFireAndForgetEvent(input, description) {
+export function createFireAndForgetEvent(input, description) {
     return { input, description, __brand: 'fire-and-forget' };
 }
 /**
@@ -53,7 +47,7 @@ function createFireAndForgetEvent(input, description) {
  * @returns Event schema object with type brand
  * @see {@link https://bsbcode.dev/languages/nodejs/types/functions/createReturnableEvent.html | API: createReturnableEvent}
  */
-function createReturnableEvent(input, output, description, defaultTimeout) {
+export function createReturnableEvent(input, output, description, defaultTimeout) {
     return { input, output, description, defaultTimeout, __brand: 'returnable' };
 }
 /**
@@ -66,7 +60,7 @@ function createReturnableEvent(input, output, description, defaultTimeout) {
  * @returns Event schema object with type brand
  * @see {@link https://bsbcode.dev/languages/nodejs/types/functions/createBroadcastEvent.html | API: createBroadcastEvent}
  */
-function createBroadcastEvent(input, description) {
+export function createBroadcastEvent(input, description) {
     return { input, description, __brand: 'broadcast' };
 }
 /**
@@ -119,7 +113,7 @@ function createBroadcastEvent(input, description) {
  * // }
  * ```
  */
-function createEventSchemas(schemas) {
+export function createEventSchemas(schemas) {
     // Runtime duplicate name detection for developer clarity
     // Note: Duplicate names across categories are not technically invalid, but can be confusing
     if (process.env.NODE_ENV !== 'production') {
@@ -193,7 +187,7 @@ function createEventSchemas(schemas) {
  *
  * @see {@link https://bsbcode.dev/languages/nodejs/types/functions/exportEventSchemas.html | API: exportEventSchemas}
  */
-function exportEventSchemas(pluginName, version, schemas) {
+export function exportEventSchemas(pluginName, version, schemas) {
     const events = {};
     // Helper to process a category of events
     const processCategory = (category, categorySchemas) => {
@@ -212,7 +206,6 @@ function exportEventSchemas(pluginName, version, schemas) {
                 type = 'fire-and-forget';
             }
             // Convert BSBType input schema to JSON Schema
-            const { bsbToJsonSchema } = require('./schema-types');
             const inputSchema = bsbToJsonSchema(eventDef.input);
             // Convert output schema (if returnable)
             let outputSchema = null;

package/lib/interfaces/schema-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-events.js","sourceRoot":"","sources":["../../src/interfaces/schema-events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema-events.js","sourceRoot":"","sources":["../../src/interfaces/schema-events.ts"],"names":[],"mappings":"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"}

package/lib/interfaces/schema-types.d.ts

@@ -24,384 +24,64 @@
  * You should have received a copy of the GNU Affero General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
-import { z } from 'zod';
-/**
- * Base interface for all BSB types.
- * These are pure data structures that can be serialized to JSON and
- * shared across different programming languages.
- */
-export interface BSBTypeBase {
-    /** Type discriminator for JSON serialization */
-    _bsb: string;
-    /** Human-readable description for documentation */
-    description?: string;
-    /** Whether this field is optional */
-    optional?: boolean;
-    /** Whether this field can be null */
-    nullable?: boolean;
-}
-/**
- * String type with optional validation constraints.
- */
-export interface BSBStringType extends BSBTypeBase {
-    _bsb: 'string';
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    format?: 'uuid' | 'datetime' | 'email' | 'uri' | 'url';
-}
-/**
- * Numeric type with optional range constraints.
- */
-export interface BSBNumberType extends BSBTypeBase {
-    _bsb: 'number';
-    numberType: 'int32' | 'int64' | 'float' | 'double';
-    min?: number;
-    max?: number;
-}
-/**
- * Boolean type.
- */
-export interface BSBBooleanType extends BSBTypeBase {
-    _bsb: 'boolean';
-}
-/**
- * Bytes type for binary data (byte arrays).
- * Maps to Uint8Array in JavaScript, byte[] in C#/Java/Go, bytes in Python.
- */
-export interface BSBBytesType extends BSBTypeBase {
-    _bsb: 'bytes';
-}
-/**
- * Array type with element type and optional size constraints.
- */
-export interface BSBArrayType extends BSBTypeBase {
-    _bsb: 'array';
-    items: BSBType;
-    minItems?: number;
-    maxItems?: number;
-}
-/**
- * Object type with named properties.
- */
-export interface BSBObjectType extends BSBTypeBase {
-    _bsb: 'object';
-    properties: Record<string, BSBType>;
-    required: string[];
-}
-/**
- * Enum type with fixed string values.
- */
-export interface BSBEnumType extends BSBTypeBase {
-    _bsb: 'enum';
-    values: string[];
-}
-/**
- * Union type representing one of multiple possible types.
- */
-export interface BSBUnionType extends BSBTypeBase {
-    _bsb: 'union';
-    types: BSBType[];
-}
-/**
- * Union of all BSB type interfaces.
- */
-export type BSBType = BSBStringType | BSBNumberType | BSBBooleanType | BSBBytesType | BSBArrayType | BSBObjectType | BSBEnumType | BSBUnionType;
-/**
- * BSB type builder providing a fluent API for creating cross-language type definitions.
- *
- * @example
- * ```typescript
- * import { bsb, optional } from '@bsb/base';
- *
- * const UserSchema = bsb.object({
- *   id: bsb.uuid('User unique identifier'),
- *   name: bsb.string({ min: 1, max: 100, description: 'User full name' }),
- *   email: bsb.string({ description: 'User email address' }),
- *   age: optional(bsb.int32({ min: 0, max: 150, description: 'User age' })),
- * });
- * ```
- */
+import * as av from '@anyvali/js';
+export type BSBType = av.BaseSchema<any, any>;
+export type InferBSBType<T extends BSBType> = av.Infer<T>;
+export type AnyValiDocument = av.AnyValiDocument;
+export declare function withDescription<T extends BSBType>(schema: T, description?: string): T;
 export declare const bsb: {
-    /**
-     * Create a string type with optional constraints.
-     */
     string(options?: {
         min?: number;
         max?: number;
         pattern?: string;
         description?: string;
-    }): BSBStringType;
-    /**
-     * Create a UUID string type (RFC 4122).
-     *
-     * Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
-     *
-     * Language mappings:
-     * - JavaScript/TypeScript: string
-     * - C#: Guid
-     * - Go: uuid.UUID
-     * - Java: UUID
-     */
-    uuid(description?: string): BSBStringType;
-    /**
-     * Create an ISO 8601 datetime string type.
-     *
-     * Format: 2024-01-01T12:00:00Z
-     *
-     * Language mappings:
-     * - JavaScript/TypeScript: Date | string
-     * - C#: DateTime
-     * - Go: time.Time
-     * - Java: Instant
-     */
-    datetime(description?: string): BSBStringType;
-    /**
-     * Create an email address string type.
-     */
-    email(description?: string): BSBStringType;
-    /**
-     * Create a URI string type.
-     */
-    uri(description?: string): BSBStringType;
-    /**
-     * Create a URL string type.
-     */
-    url(description?: string): BSBStringType;
-    /**
-     * Create a 32-bit signed integer type.
-     *
-     * Range: -2,147,483,648 to 2,147,483,647
-     *
-     * Language mappings:
-     * - JavaScript/TypeScript: number
-     * - C#: int
-     * - Go: int32
-     * - Java: int
-     */
+    }): av.StringSchema;
+    uuid(description?: string): av.StringSchema;
+    datetime(description?: string): av.StringSchema;
+    email(description?: string): av.StringSchema;
+    uri(description?: string): av.StringSchema;
+    url(description?: string): av.StringSchema;
     int32(options?: {
         min?: number;
         max?: number;
         description?: string;
-    }): BSBNumberType;
-    /**
-     * Create a 64-bit signed integer type.
-     *
-     * Range: -9,223,372,036,854,775,808 to 9,223,372,036,854,775,807
-     *
-     * Note: JavaScript can only safely represent integers up to 2^53.
-     *
-     * Language mappings:
-     * - JavaScript/TypeScript: number
-     * - C#: long
-     * - Go: int64
-     * - Java: long
-     */
+    }): BSBType;
     int64(options?: {
         min?: number;
         max?: number;
         description?: string;
-    }): BSBNumberType;
-    /**
-     * Create a 32-bit floating point number type.
-     *
-     * Language mappings:
-     * - JavaScript/TypeScript: number
-     * - C#: float
-     * - Go: float32
-     * - Java: float
-     */
+    }): BSBType;
     float(options?: {
         min?: number;
         max?: number;
         description?: string;
-    }): BSBNumberType;
-    /**
-     * Create a 64-bit floating point number type.
-     *
-     * Language mappings:
-     * - JavaScript/TypeScript: number
-     * - C#: double
-     * - Go: float64
-     * - Java: double
-     */
+    }): BSBType;
     double(options?: {
         min?: number;
         max?: number;
         description?: string;
-    }): BSBNumberType;
-    /**
-     * Create a boolean type.
-     *
-     * Language mappings:
-     * - JavaScript/TypeScript: boolean
-     * - C#: bool
-     * - Go: bool
-     * - Java: boolean
-     */
-    boolean(description?: string): BSBBooleanType;
-    /**
-     * Create a bytes type for binary data.
-     * Maps to:
-     * - JavaScript/TypeScript: Uint8Array or Buffer
-     * - C#: byte[]
-     * - Go: []byte
-     * - Java: byte[]
-     * - Python: bytes
-     */
-    bytes(description?: string): BSBBytesType;
-    /**
-     * Create an array type with element type and optional size constraints.
-     *
-     * @example
-     * ```typescript
-     * const TagsSchema = bsb.array(
-     *   bsb.string({ max: 50 }),
-     *   { min: 1, max: 10, description: 'List of tags' }
-     * );
-     * ```
-     */
-    array(items: BSBType, options?: {
+    }): BSBType;
+    number(options?: {
         min?: number;
         max?: number;
         description?: string;
-    }): BSBArrayType;
-    /**
-     * Create an object type with named properties.
-     *
-     * Required fields are automatically determined based on the optional flag.
-     *
-     * @example
-     * ```typescript
-     * const UserSchema = bsb.object({
-     *   id: bsb.uuid('User ID'),
-     *   name: bsb.string({ min: 1, max: 100, description: 'Full name' }),
-     *   email: optional(bsb.email('Email address')),
-     * }, 'User object');
-     * ```
-     */
-    object<const T>(properties: T, description?: string): {
-        _bsb: "object";
-        properties: T;
-        required: string[];
-        description?: string;
-        optional?: boolean;
-        nullable?: boolean;
-    };
-    /**
-     * Create an enum type with fixed string values.
-     *
-     * @example
-     * ```typescript
-     * const StatusSchema = bsb.enum(
-     *   ['pending', 'in-progress', 'completed', 'failed'],
-     *   'Task status'
-     * );
-     * ```
-     */
-    enum(values: readonly string[], description?: string): BSBEnumType;
-    /**
-     * Create a union type representing one of multiple possible types.
-     *
-     * @example
-     * ```typescript
-     * const IdSchema = bsb.union([
-     *   bsb.uuid('UUID identifier'),
-     *   bsb.int32({ description: 'Numeric identifier' }),
-     * ], 'Flexible identifier');
-     * ```
-     */
-    union(types: BSBType[], description?: string): BSBUnionType;
-    /**
-     * Create a generic number type (defaults to double for floating point).
-     * This is a convenience wrapper for double().
-     */
-    number(options?: {
+    }): BSBType;
+    boolean(description?: string): av.BoolSchema;
+    bytes(description?: string): av.UnknownSchema;
+    array(items: BSBType, options?: {
         min?: number;
         max?: number;
         description?: string;
-    }): BSBNumberType;
-    /**
-     * Create a void type for functions that don't return a value.
-     */
-    void(): BSBType;
-    /**
-     * Create an unknown type for dynamic/any data.
-     */
-    unknown(description?: string): BSBType;
-    /**
-     * Create a record/map type with string keys and a value type.
-     */
-    record<K extends BSBType, V extends BSBType>(keyType: K, valueType: V, description?: string): BSBType;
-};
-/**
- * Mark a type as optional.
- * Optional fields are not required in object schemas.
- *
- * @example
- * ```typescript
- * const UserSchema = bsb.object({
- *   name: bsb.string(),           // Required
- *   bio: optional(bsb.string()),  // Optional
- * });
- * ```
- */
-export declare function optional<T extends BSBType>(type: T): T & {
-    optional: true;
+    }): av.ArraySchema<BSBType>;
+    object<T extends Record<string, BSBType>>(properties: T, description?: string): av.ObjectSchema<T>;
+    enum(values: readonly (string | number)[], description?: string): av.EnumSchema<readonly (string | number)[]>;
+    union(types: BSBType[], description?: string): av.UnknownSchema | av.UnionSchema<[BSBType, ...BSBType[]]>;
+    void(): av.UnknownSchema;
+    unknown(description?: string): av.UnknownSchema;
+    record<K extends BSBType, V extends BSBType>(_keyType: K, valueType: V, description?: string): av.RecordSchema<V>;
 };
-/**
- * Mark a type as nullable.
- * Nullable fields can have null values in addition to their defined type.
- *
- * @example
- * ```typescript
- * const UserSchema = bsb.object({
- *   lastLogin: nullable(bsb.datetime('Last login time')),
- * });
- * ```
- */
-export declare function nullable<T extends BSBType>(type: T): T;
-type Prev = [never, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, ...0[]];
-/**
- * Infer TypeScript type from BSB type definition with recursion depth limiting.
- * Provides compile-time type safety when using BSB schemas.
- * Limits recursion to prevent "excessively deep" errors.
- *
- * @example
- * ```typescript
- * const UserSchema = bsb.object({
- *   id: bsb.uuid(),
- *   name: bsb.string(),
- *   age: optional(bsb.int32()),
- * });
- *
- * type User = InferBSBType<typeof UserSchema>;
- * // Results in: { id: string; name: string; age?: number }
- * ```
- */
-export type InferBSBType<T, Depth extends number = 10> = [
-    T
-] extends [never] ? never : Depth extends 0 ? any : T extends BSBStringType ? string : T extends BSBNumberType ? number : T extends BSBBooleanType ? boolean : T extends BSBBytesType ? Uint8Array : T extends BSBArrayType ? InferBSBType<T['items'], Prev[Depth]>[] : T extends {
-    _bsb: 'object';
-    properties: infer Props;
-} ? ({
-    [K in keyof Props as Props[K] extends {
-        optional: true;
-    } ? never : K]: Props[K] extends BSBType ? InferBSBType<Props[K], Prev[Depth]> : never;
-} & {
-    [K in keyof Props as Props[K] extends {
-        optional: true;
-    } ? K : never]?: Props[K] extends BSBType ? InferBSBType<Props[K], Prev[Depth]> : never;
-}) : T extends BSBEnumType ? T['values'][number] : T extends BSBUnionType ? InferBSBType<T['types'][number], Prev[Depth]> : never;
-/**
- * Convert BSB type to JSON Schema format.
- * Used for schema export and client code generation.
- */
-export declare function bsbToJsonSchema(type: BSBType): any;
-/**
- * Convert BSB type to Zod schema for runtime validation.
- * This is only used in Node.js plugins for runtime validation.
- * Other languages will have their own validation implementations.
- */
-export declare function bsbToZod(type: BSBType): z.ZodTypeAny;
-export {};
+export declare function optional<T extends BSBType>(type: T): av.OptionalSchema<T>;
+export declare function nullable<T extends BSBType>(type: T): av.NullableSchema<T>;
+export declare function bsbToJsonSchema(type: BSBType): AnyValiDocument;
+export declare function exportPortableSchema(type: BSBType): AnyValiDocument;
+export declare function importPortableSchema(document: AnyValiDocument): BSBType;