@wemush/wols 0.1.0

package/dist/types/parser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * WOLS Specimen Parser
+ *
+ * This module provides parsing functionality for WOLS specimen JSON.
+ *
+ * @module parser
+ */
+import { type ParseResult, type Specimen } from './types.js';
+/**
+ * Parse a JSON string into a validated Specimen object.
+ *
+ * This function performs both JSON parsing and WOLS validation.
+ * If the JSON is invalid or the parsed object doesn't conform to WOLS,
+ * it returns a failure result with a detailed error.
+ *
+ * @param json - The JSON string to parse
+ * @returns ParseResult with either the parsed Specimen or an error
+ *
+ * @example
+ * ```typescript
+ * const result = parseSpecimen('{"@context": "https://wemush.com/wols/v1", ...}');
+ * if (result.success) {
+ *   console.log('Specimen ID:', result.data.id);
+ * } else {
+ *   console.error('Parse error:', result.error.message);
+ * }
+ * ```
+ */
+export declare function parseSpecimen(json: string): ParseResult<Specimen>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/types/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,QAAQ,EAId,MAAM,YAAY,CAAC;AAyCpB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAoGjE"}

package/dist/types/qr/generate.d.ts

@@ -0,0 +1,62 @@
+/**
+ * QR Code Generation Module
+ *
+ * This module provides QR code generation functionality for WOLS specimens.
+ * Requires the 'qrcode' package as an optional peer dependency.
+ *
+ * @module qr/generate
+ */
+import type { Specimen, QRCodeOptions } from '../types.js';
+/**
+ * Check if QR code generation is available.
+ * Returns true if the qrcode library is installed.
+ */
+export declare function isQRAvailable(): Promise<boolean>;
+/**
+ * Synchronous check if QR code generation is available.
+ * Note: Only accurate after first async call to any QR function.
+ */
+export declare function isQRAvailableSync(): boolean;
+/**
+ * Generate QR code as PNG buffer.
+ *
+ * @param specimen - The specimen to encode
+ * @param options - QR code generation options
+ * @returns PNG buffer containing the QR code
+ *
+ * @example
+ * ```typescript
+ * const buffer = await toQRCode(specimen, { size: 400 });
+ * fs.writeFileSync('specimen-qr.png', buffer);
+ * ```
+ */
+export declare function toQRCode(specimen: Specimen, options?: QRCodeOptions): Promise<Buffer>;
+/**
+ * Generate QR code as data URL (base64 encoded PNG).
+ *
+ * @param specimen - The specimen to encode
+ * @param options - QR code generation options
+ * @returns Data URL string (data:image/png;base64,...)
+ *
+ * @example
+ * ```typescript
+ * const dataUrl = await toQRCodeDataURL(specimen);
+ * // Use in HTML: <img src={dataUrl} />
+ * ```
+ */
+export declare function toQRCodeDataURL(specimen: Specimen, options?: QRCodeOptions): Promise<string>;
+/**
+ * Generate QR code as SVG string.
+ *
+ * @param specimen - The specimen to encode
+ * @param options - QR code generation options
+ * @returns SVG string
+ *
+ * @example
+ * ```typescript
+ * const svg = await toQRCodeSVG(specimen, { color: { dark: '#000', light: '#fff' } });
+ * fs.writeFileSync('specimen-qr.svg', svg);
+ * ```
+ */
+export declare function toQRCodeSVG(specimen: Specimen, options?: QRCodeOptions): Promise<string>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/types/qr/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/qr/generate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAwK3D;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAGtD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa/F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAajB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/dist/types/qr/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * QR Code Submodule
+ *
+ * This module provides QR code generation functionality for WOLS specimens.
+ *
+ * @packageDocumentation
+ * @module @wemush/wols/qr
+ */
+export { toQRCode, toQRCodeDataURL, toQRCodeSVG, isQRAvailable, isQRAvailableSync, } from './generate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/qr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/qr/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,eAAe,CAAC"}

package/dist/types/specimen.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Specimen Creation and Serialization
+ *
+ * This module provides functions to create and serialize
+ * WOLS v1.1.0 compliant specimen objects.
+ *
+ * @module specimen
+ */
+import type { Specimen, SpecimenInput } from './types.js';
+/**
+ * Create a new specimen with auto-generated ID and JSON-LD fields.
+ *
+ * This function creates a fully-formed WOLS v1.1.0 compliant Specimen
+ * with automatic ID generation, version assignment, and JSON-LD context.
+ *
+ * @param input - Specimen creation parameters
+ * @returns Fully-formed Specimen with JSON-LD fields
+ *
+ * @example
+ * ```typescript
+ * // Minimal specimen
+ * const culture = createSpecimen({
+ *   type: 'CULTURE',
+ *   species: 'Pleurotus ostreatus',
+ * });
+ *
+ * // Full specimen with strain info
+ * const substrate = createSpecimen({
+ *   type: 'SUBSTRATE',
+ *   species: 'Hericium erinaceus',
+ *   strain: {
+ *     name: "Lion's Mane Premium",
+ *     generation: 'F2',
+ *     clonalGeneration: 3,
+ *   },
+ *   stage: 'COLONIZATION',
+ *   batch: 'batch_2025_12_001',
+ *   organization: 'org_mushoh',
+ * });
+ *
+ * // String strain shorthand
+ * const spawn = createSpecimen({
+ *   type: 'SPAWN',
+ *   species: 'Ganoderma lucidum',
+ *   strain: 'Reishi Red',  // Auto-expands to { name: 'Reishi Red' }
+ * });
+ * ```
+ */
+export declare function createSpecimen(input: SpecimenInput): Specimen;
+/**
+ * Serialize a specimen to JSON-LD string.
+ *
+ * The output is formatted with JSON-LD fields (@context, @type) first,
+ * followed by id, version, and remaining fields. Undefined fields are omitted.
+ *
+ * @param specimen - Specimen to serialize
+ * @returns JSON string suitable for QR encoding
+ *
+ * @example
+ * ```typescript
+ * const specimen = createSpecimen({
+ *   type: 'CULTURE',
+ *   species: 'Pleurotus ostreatus',
+ * });
+ *
+ * const json = serializeSpecimen(specimen);
+ * // Returns: '{"@context":"https://wemush.com/wols/v1","@type":"Specimen",...}'
+ * ```
+ */
+export declare function serializeSpecimen(specimen: Specimen): string;
+//# sourceMappingURL=specimen.d.ts.map

package/dist/types/specimen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specimen.d.ts","sourceRoot":"","sources":["../../src/specimen.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAU,MAAM,YAAY,CAAC;AA2BlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,QAAQ,CAwC7D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CA6C5D"}

package/dist/types/types.d.ts

@@ -0,0 +1,269 @@
+/**
+ * WOLS TypeScript Library - Core Types
+ *
+ * This module defines all the core types, interfaces, and enums
+ * for the WeMush Open Labeling Standard (WOLS) v1.1.0.
+ *
+ * @packageDocumentation
+ * @module @wemush/wols
+ */
+/**
+ * WOLS specification version implemented by this library.
+ */
+export declare const WOLS_VERSION = "1.1.0";
+/**
+ * JSON-LD context URL for WOLS specimens.
+ */
+export declare const WOLS_CONTEXT = "https://wemush.com/wols/v1";
+/**
+ * Branded type pattern for nominal typing.
+ * Creates a compile-time unique type that is runtime-compatible with the base type.
+ */
+export type Brand<K, T> = K & {
+    readonly __brand: T;
+};
+/**
+ * Specimen ID type (format: "wemush:{cuid}").
+ * This is a branded string type for type safety.
+ */
+export type SpecimenId = Brand<string, 'SpecimenId'>;
+/**
+ * Create a SpecimenId from a string.
+ * Does not validate the format - use isValidSpecimenId for validation.
+ */
+export declare function asSpecimenId(id: string): SpecimenId;
+/**
+ * Specimen type enum representing cultivation stages.
+ */
+export type SpecimenType = 'CULTURE' | 'SPAWN' | 'SUBSTRATE' | 'FRUITING' | 'HARVEST';
+/**
+ * Array of valid specimen types for validation.
+ */
+export declare const SPECIMEN_TYPES: readonly SpecimenType[];
+/**
+ * Growth stage enum representing specimen lifecycle.
+ */
+export type GrowthStage = 'INOCULATION' | 'COLONIZATION' | 'FRUITING' | 'HARVEST';
+/**
+ * Array of valid growth stages for validation.
+ */
+export declare const GROWTH_STAGES: readonly GrowthStage[];
+/**
+ * Strain information for a specimen.
+ */
+export interface Strain {
+    /** Strain name or identifier */
+    name: string;
+    /** Filial generation (e.g., "F1", "F2", "P") */
+    generation?: string;
+    /** Subculture/clone count (1, 2, 3...) */
+    clonalGeneration?: number;
+    /** Parent specimen ID reference */
+    lineage?: string;
+    /** Origin: "spore", "tissue", "agar", "liquid" */
+    source?: string;
+}
+/**
+ * Primary specimen entity following WOLS v1.1.0 JSON-LD schema.
+ */
+export interface Specimen {
+    /** JSON-LD context URL */
+    '@context': typeof WOLS_CONTEXT;
+    /** JSON-LD entity type */
+    '@type': 'Specimen';
+    /** Unique specimen ID (format: wemush:{cuid}) */
+    id: SpecimenId;
+    /** WOLS specification version */
+    version: string;
+    /** Cultivation stage type */
+    type: SpecimenType;
+    /** Scientific species name */
+    species: string;
+    /** Strain/genetic information */
+    strain?: Strain;
+    /** Current growth stage */
+    stage?: GrowthStage;
+    /** Creation timestamp (ISO 8601) */
+    created?: string;
+    /** Batch identifier */
+    batch?: string;
+    /** Organization ID */
+    organization?: string;
+    /** Creator user ID */
+    creator?: string;
+    /** Custom vendor-specific fields */
+    custom?: Record<string, unknown>;
+    /** Cryptographic signature */
+    signature?: string;
+}
+/**
+ * Input type for createSpecimen().
+ * Strain can be a string (auto-expanded) or full Strain object.
+ */
+export interface SpecimenInput {
+    /** Cultivation stage type */
+    type: SpecimenType;
+    /** Scientific species name */
+    species: string;
+    /** String shorthand expands to { name: string } */
+    strain?: string | Strain;
+    /** Current growth stage */
+    stage?: GrowthStage;
+    /** Batch identifier */
+    batch?: string;
+    /** Organization ID */
+    organization?: string;
+    /** Creator user ID */
+    creator?: string;
+    /** Custom vendor-specific fields */
+    custom?: Record<string, unknown>;
+}
+/**
+ * Import error types for use in ParseResult.
+ * Circular dependency avoided by using forward reference.
+ */
+import type { WolsError } from './errors.js';
+/**
+ * Parse result discriminated union.
+ * @template T The type of data on success
+ */
+export type ParseResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: WolsError;
+};
+/**
+ * Validation error detail.
+ */
+export interface ValidationError {
+    /** JSON path to invalid field (e.g., "strain.name") */
+    path: string;
+    /** Stable error code */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+}
+/**
+ * Validation warning detail.
+ */
+export interface ValidationWarning {
+    /** JSON path to field */
+    path: string;
+    /** Warning code */
+    code: string;
+    /** Human-readable warning message */
+    message: string;
+    /** Suggested fix */
+    suggestion?: string;
+}
+/**
+ * Validation result with errors and warnings.
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** Validation errors (causes valid: false) */
+    errors: ValidationError[];
+    /** Validation warnings (informational) */
+    warnings: ValidationWarning[];
+}
+/**
+ * Validation options.
+ */
+export interface ValidationOptions {
+    /** Allow unknown fields in custom namespace */
+    allowUnknownFields?: boolean;
+    /** Validation strictness level */
+    level?: 'strict' | 'lenient';
+}
+/**
+ * Reference data extracted from a compact URL.
+ *
+ * Contains the minimal information encoded in the compact format.
+ * Full specimen data must be retrieved via API lookup using the id.
+ */
+export interface SpecimenRef {
+    /** Full specimen ID with wemush: prefix */
+    id: string;
+    /** Species name (resolved from code if known) */
+    species: string;
+    /** Specimen type (CULTURE, SPAWN, etc.) */
+    type?: SpecimenType;
+    /** Growth stage */
+    stage?: GrowthStage;
+    /** Unix timestamp of creation */
+    timestamp?: number;
+    /** Batch identifier */
+    batch?: string;
+    /** Strain information */
+    strain?: {
+        name: string;
+        generation?: string;
+    };
+    /** Version (from URL path) */
+    version: string;
+}
+/**
+ * QR code generation options.
+ */
+export interface QRCodeOptions {
+    /** Width/height in pixels (default: 300) */
+    size?: number;
+    /** Error correction level (default: 'M') */
+    errorCorrection?: 'L' | 'M' | 'Q' | 'H';
+    /** Encoding format (default: 'embedded') */
+    format?: 'embedded' | 'compact';
+    /** Quiet zone modules (default: 1) */
+    margin?: number;
+    /** QR code colors */
+    color?: {
+        dark?: string;
+        light?: string;
+    };
+}
+/**
+ * Encryption options.
+ */
+export interface EncryptionOptions {
+    /** CryptoKey or password string for PBKDF2 */
+    key: CryptoKey | string;
+    /** Fields to encrypt (partial encryption) */
+    fields?: string[];
+}
+/**
+ * Encrypted specimen wrapper.
+ */
+export interface EncryptedSpecimen {
+    /** Flag indicating this is encrypted */
+    encrypted: true;
+    /** Base64url encoded ciphertext */
+    payload: string;
+    /** Base64url encoded initialization vector */
+    iv: string;
+    /** Encryption algorithm used */
+    algorithm: 'AES-256-GCM';
+    /** Authentication tag (for GCM) */
+    tag?: string;
+}
+/**
+ * Decryption options.
+ */
+export interface DecryptionOptions {
+    /** CryptoKey or password string for PBKDF2 */
+    key: CryptoKey | string;
+}
+/**
+ * Type guard to check if a value is a valid SpecimenType.
+ */
+export declare function isSpecimenType(value: unknown): value is SpecimenType;
+/**
+ * Type guard to check if a value is a valid GrowthStage.
+ */
+export declare function isGrowthStage(value: unknown): value is GrowthStage;
+/**
+ * Type guard to check if a value is a Strain object.
+ */
+export declare function isStrain(value: unknown): value is Strain;
+//# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

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

package/dist/types/utils/cuid.d.ts

@@ -0,0 +1,44 @@
+/**
+ * CUID2 Generator - Zero-dependency implementation
+ *
+ * Generates collision-resistant unique identifiers following the CUID2 algorithm.
+ * This is a minimal implementation focused on the needs of WOLS specimen IDs.
+ *
+ * @module utils/cuid
+ */
+/**
+ * Generate a CUID2-style identifier.
+ *
+ * The ID format is: [random][timestamp][counter][fingerprint][random]
+ * All components are base36 encoded for URL safety.
+ *
+ * @param length - Length of the generated ID (default: 24)
+ * @returns A unique, URL-safe identifier
+ *
+ * @example
+ * ```typescript
+ * const id = createId();
+ * // Returns something like: "clx1a2b3c4d5e6f7g8h9i0j1"
+ * ```
+ */
+export declare function createId(length?: number): string;
+/**
+ * Generate a specimen ID with the WOLS prefix.
+ *
+ * @returns A specimen ID in format "wemush:{cuid}"
+ *
+ * @example
+ * ```typescript
+ * const specimenId = createSpecimenId();
+ * // Returns: "wemush:clx1a2b3c4d5e6f7g8h9i0j1"
+ * ```
+ */
+export declare function createSpecimenId(): string;
+/**
+ * Validate a specimen ID format.
+ *
+ * @param id - The ID to validate
+ * @returns true if the ID matches the expected format
+ */
+export declare function isValidSpecimenId(id: string): boolean;
+//# sourceMappingURL=cuid.d.ts.map

package/dist/types/utils/cuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cuid.d.ts","sourceRoot":"","sources":["../../../src/utils/cuid.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuGH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,MAAM,GAAE,MAAuB,GAAG,MAAM,CAiBhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/types/utils/iso8601.d.ts

@@ -0,0 +1,79 @@
+/**
+ * ISO 8601 Date Utilities
+ *
+ * Provides parsing and formatting for ISO 8601 date strings
+ * as used in WOLS specimens.
+ *
+ * @module utils/iso8601
+ */
+/**
+ * Check if a string is a valid ISO 8601 date.
+ *
+ * @param value - The string to validate
+ * @returns true if valid ISO 8601 format
+ *
+ * @example
+ * ```typescript
+ * isValidISO8601('2025-12-16T10:30:00Z'); // true
+ * isValidISO8601('2025-12-16'); // false (date-only)
+ * isValidISO8601('invalid'); // false
+ * ```
+ */
+export declare function isValidISO8601(value: string): boolean;
+/**
+ * Check if a string is a valid date-only format (YYYY-MM-DD).
+ *
+ * @param value - The string to validate
+ * @returns true if valid date-only format
+ */
+export declare function isValidDateOnly(value: string): boolean;
+/**
+ * Get the current timestamp in ISO 8601 format.
+ *
+ * @returns Current time as ISO 8601 string
+ *
+ * @example
+ * ```typescript
+ * const now = getCurrentISO8601();
+ * // Returns: "2025-12-16T10:30:00.000Z"
+ * ```
+ */
+export declare function getCurrentISO8601(): string;
+/**
+ * Parse an ISO 8601 date string to a Date object.
+ *
+ * @param value - The ISO 8601 string to parse
+ * @returns The parsed Date, or null if invalid
+ *
+ * @example
+ * ```typescript
+ * const date = parseISO8601('2025-12-16T10:30:00Z');
+ * // Returns: Date object
+ *
+ * const invalid = parseISO8601('invalid');
+ * // Returns: null
+ * ```
+ */
+export declare function parseISO8601(value: string): Date | null;
+/**
+ * Format a Date object to ISO 8601 string.
+ *
+ * @param date - The Date to format
+ * @returns ISO 8601 string
+ */
+export declare function formatISO8601(date: Date): string;
+/**
+ * Get Unix timestamp (seconds since epoch) from ISO 8601 string.
+ *
+ * @param value - The ISO 8601 string
+ * @returns Unix timestamp in seconds, or null if invalid
+ */
+export declare function toUnixTimestamp(value: string): number | null;
+/**
+ * Convert Unix timestamp to ISO 8601 string.
+ *
+ * @param timestamp - Unix timestamp in seconds
+ * @returns ISO 8601 string
+ */
+export declare function fromUnixTimestamp(timestamp: number): string;
+//# sourceMappingURL=iso8601.d.ts.map

package/dist/types/utils/iso8601.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iso8601.d.ts","sourceRoot":"","sources":["../../../src/utils/iso8601.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAQrD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAKvD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM5D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/types/validator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * WOLS Specimen Validator
+ *
+ * This module provides validation functionality for WOLS specimen objects.
+ *
+ * @module validator
+ */
+import { type Specimen, type ValidationOptions, type ValidationResult } from './types.js';
+/**
+ * Validate a specimen object against the WOLS v1.1.0 schema.
+ *
+ * @param specimen - The specimen object to validate
+ * @param options - Validation options
+ * @returns ValidationResult with errors and warnings
+ *
+ * @example
+ * ```typescript
+ * const result = validateSpecimen(specimen);
+ * if (!result.valid) {
+ *   console.error('Validation errors:', result.errors);
+ * }
+ * ```
+ */
+export declare function validateSpecimen(specimen: Specimen | unknown, options?: ValidationOptions): ValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/types/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAGL,KAAK,QAAQ,EAGb,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAGtB,MAAM,YAAY,CAAC;AAmZpB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,GAAG,OAAO,EAC5B,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CA+ClB"}