@wemush/wols 0.1.0

package/dist/esm/validator.js

@@ -0,0 +1,304 @@
+/**
+ * WOLS Specimen Validator
+ *
+ * This module provides validation functionality for WOLS specimen objects.
+ *
+ * @module validator
+ */
+import { WolsErrorCode } from './errors.js';
+import { isGrowthStage, isSpecimenType, WOLS_CONTEXT, } from './types.js';
+import { isValidISO8601 } from './utils/iso8601.js';
+// =============================================================================
+// VALIDATION PATTERNS
+// =============================================================================
+/**
+ * Pattern for valid specimen ID: wemush:[a-z0-9]+
+ */
+const SPECIMEN_ID_PATTERN = /^wemush:[a-z0-9]+$/;
+/**
+ * Pattern for valid semver version: major.minor.patch
+ */
+const SEMVER_PATTERN = /^\d+\.\d+\.\d+$/;
+/**
+ * Pattern for valid strain generation: P, F1, F2, F3, etc.
+ */
+const GENERATION_PATTERN = /^(P|F\d+)$/;
+/**
+ * Known WOLS specimen fields (for unknown field detection).
+ */
+const KNOWN_FIELDS = new Set([
+    '@context',
+    '@type',
+    'id',
+    'version',
+    'type',
+    'species',
+    'strain',
+    'stage',
+    'created',
+    'batch',
+    'organization',
+    'creator',
+    'custom',
+    'signature',
+]);
+// =============================================================================
+// HELPER FUNCTIONS
+// =============================================================================
+/**
+ * Create a validation error.
+ */
+function error(path, code, message) {
+    return { path, code, message };
+}
+/**
+ * Create a validation warning.
+ */
+function warning(path, code, message, suggestion) {
+    const result = { path, code, message };
+    if (suggestion !== undefined) {
+        result.suggestion = suggestion;
+    }
+    return result;
+}
+/**
+ * Check if a value is a non-empty string.
+ */
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+/**
+ * Check if a value is a plain object.
+ */
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+// =============================================================================
+// FIELD VALIDATORS
+// =============================================================================
+/**
+ * Validate @context field.
+ */
+function validateContext(value, errors, _options) {
+    if (value === undefined || value === null) {
+        errors.push(error('@context', WolsErrorCode.INVALID_CONTEXT, '@context is required'));
+        return;
+    }
+    if (value !== WOLS_CONTEXT) {
+        errors.push(error('@context', WolsErrorCode.INVALID_CONTEXT, `@context must be '${WOLS_CONTEXT}', got '${value}'`));
+    }
+}
+/**
+ * Validate @type field.
+ */
+function validateType(value, errors, _options) {
+    if (value === undefined || value === null) {
+        errors.push(error('@type', WolsErrorCode.INVALID_TYPE, '@type is required'));
+        return;
+    }
+    if (value !== 'Specimen') {
+        errors.push(error('@type', WolsErrorCode.INVALID_TYPE, `@type must be 'Specimen', got '${value}'`));
+    }
+}
+/**
+ * Validate id field.
+ */
+function validateId(value, errors, _options) {
+    if (value === undefined || value === null) {
+        errors.push(error('id', WolsErrorCode.REQUIRED_FIELD, 'id is required'));
+        return;
+    }
+    if (typeof value !== 'string') {
+        errors.push(error('id', WolsErrorCode.INVALID_ID_FORMAT, 'id must be a string'));
+        return;
+    }
+    if (!SPECIMEN_ID_PATTERN.test(value)) {
+        errors.push(error('id', WolsErrorCode.INVALID_ID_FORMAT, `id must match pattern 'wemush:[a-z0-9]+', got '${value}'`));
+    }
+}
+/**
+ * Validate version field.
+ */
+function validateVersion(value, errors, _options) {
+    if (value === undefined || value === null) {
+        errors.push(error('version', WolsErrorCode.REQUIRED_FIELD, 'version is required'));
+        return;
+    }
+    if (typeof value !== 'string') {
+        errors.push(error('version', WolsErrorCode.INVALID_VERSION, 'version must be a string'));
+        return;
+    }
+    if (!SEMVER_PATTERN.test(value)) {
+        errors.push(error('version', WolsErrorCode.INVALID_VERSION, `version must be valid semver (major.minor.patch), got '${value}'`));
+    }
+}
+/**
+ * Validate specimen type field.
+ */
+function validateSpecimenType(value, errors, _options) {
+    if (value === undefined || value === null) {
+        errors.push(error('type', WolsErrorCode.REQUIRED_FIELD, 'type is required'));
+        return;
+    }
+    if (!isSpecimenType(value)) {
+        errors.push(error('type', WolsErrorCode.INVALID_SPECIMEN_TYPE, `type must be one of CULTURE, SPAWN, SUBSTRATE, FRUITING, HARVEST, got '${value}'`));
+    }
+}
+/**
+ * Validate species field.
+ */
+function validateSpecies(value, errors, _options) {
+    if (value === undefined || value === null) {
+        errors.push(error('species', WolsErrorCode.REQUIRED_FIELD, 'species is required'));
+        return;
+    }
+    if (!isNonEmptyString(value)) {
+        errors.push(error('species', WolsErrorCode.REQUIRED_FIELD, 'species must be a non-empty string'));
+    }
+}
+/**
+ * Validate optional stage field.
+ */
+function validateStage(value, errors, warnings, options) {
+    if (value === undefined || value === null) {
+        return; // Optional field
+    }
+    if (!isGrowthStage(value)) {
+        if (options.level === 'lenient') {
+            warnings.push(warning('stage', 'UNKNOWN_GROWTH_STAGE', `Unknown growth stage '${value}'`, 'Use one of: INOCULATION, COLONIZATION, FRUITING, HARVEST'));
+        }
+        else {
+            errors.push(error('stage', 'INVALID_GROWTH_STAGE', `stage must be one of INOCULATION, COLONIZATION, FRUITING, HARVEST, got '${value}'`));
+        }
+    }
+}
+/**
+ * Validate optional created field.
+ */
+function validateCreated(value, errors, warnings, options) {
+    if (value === undefined || value === null) {
+        return; // Optional field
+    }
+    if (typeof value !== 'string') {
+        errors.push(error('created', WolsErrorCode.INVALID_DATE_FORMAT, 'created must be a string'));
+        return;
+    }
+    if (!isValidISO8601(value)) {
+        if (options.level === 'lenient') {
+            warnings.push(warning('created', WolsErrorCode.INVALID_DATE_FORMAT, `Invalid ISO 8601 date format: '${value}'`, 'Use format: YYYY-MM-DDTHH:mm:ssZ'));
+        }
+        else {
+            errors.push(error('created', WolsErrorCode.INVALID_DATE_FORMAT, `created must be valid ISO 8601 datetime, got '${value}'`));
+        }
+    }
+}
+/**
+ * Validate strain object.
+ */
+function validateStrain(value, errors, _options) {
+    if (value === undefined || value === null) {
+        return; // Optional field
+    }
+    if (!isPlainObject(value)) {
+        errors.push(error('strain', WolsErrorCode.INVALID_FORMAT, 'strain must be an object'));
+        return;
+    }
+    const strain = value;
+    // name is required in Strain
+    if (!isNonEmptyString(strain.name)) {
+        errors.push(error('strain.name', WolsErrorCode.REQUIRED_FIELD, 'strain.name is required'));
+    }
+    // Validate generation format if present
+    if (strain.generation !== undefined) {
+        if (typeof strain.generation !== 'string' || !GENERATION_PATTERN.test(strain.generation)) {
+            errors.push(error('strain.generation', WolsErrorCode.INVALID_GENERATION, `strain.generation must match pattern 'P' or 'F<number>', got '${strain.generation}'`));
+        }
+    }
+    // Validate clonalGeneration if present
+    if (strain.clonalGeneration !== undefined) {
+        if (typeof strain.clonalGeneration !== 'number' ||
+            !Number.isInteger(strain.clonalGeneration) ||
+            strain.clonalGeneration < 1) {
+            errors.push(error('strain.clonalGeneration', WolsErrorCode.INVALID_FORMAT, 'strain.clonalGeneration must be a positive integer'));
+        }
+    }
+    // Validate source if present (informational, no strict enum)
+    if (strain.source !== undefined && typeof strain.source !== 'string') {
+        errors.push(error('strain.source', WolsErrorCode.INVALID_FORMAT, 'strain.source must be a string'));
+    }
+    // Validate lineage if present
+    if (strain.lineage !== undefined && typeof strain.lineage !== 'string') {
+        errors.push(error('strain.lineage', WolsErrorCode.INVALID_FORMAT, 'strain.lineage must be a string'));
+    }
+}
+/**
+ * Check for unknown fields and add warnings.
+ */
+function checkUnknownFields(specimen, warnings, options) {
+    if (options.allowUnknownFields) {
+        return;
+    }
+    for (const key of Object.keys(specimen)) {
+        if (!KNOWN_FIELDS.has(key)) {
+            warnings.push(warning(key, 'UNKNOWN_FIELD', `Unknown field '${key}'`, 'Unknown fields should be placed in the custom object'));
+        }
+    }
+}
+// =============================================================================
+// MAIN VALIDATION FUNCTION
+// =============================================================================
+/**
+ * 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 function validateSpecimen(specimen, options = {}) {
+    const errors = [];
+    const warnings = [];
+    // Default options
+    const opts = {
+        allowUnknownFields: options.allowUnknownFields ?? false,
+        level: options.level ?? 'strict',
+    };
+    // Handle null/undefined input
+    if (specimen === null || specimen === undefined) {
+        errors.push(error('', WolsErrorCode.REQUIRED_FIELD, 'Specimen is required'));
+        return { valid: false, errors, warnings };
+    }
+    // Handle non-object input
+    if (!isPlainObject(specimen)) {
+        errors.push(error('', WolsErrorCode.INVALID_FORMAT, 'Specimen must be an object'));
+        return { valid: false, errors, warnings };
+    }
+    const data = specimen;
+    // Validate required JSON-LD fields
+    validateContext(data['@context'], errors, opts);
+    validateType(data['@type'], errors, opts);
+    // Validate required specimen fields
+    validateId(data['id'], errors, opts);
+    validateVersion(data['version'], errors, opts);
+    validateSpecimenType(data['type'], errors, opts);
+    validateSpecies(data['species'], errors, opts);
+    // Validate optional fields
+    validateStage(data['stage'], errors, warnings, opts);
+    validateCreated(data['created'], errors, warnings, opts);
+    validateStrain(data['strain'], errors, opts);
+    // Check for unknown fields
+    checkUnknownFields(data, warnings, opts);
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/esm/validator.js.map

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

package/dist/types/compact-url.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Compact URL Format Functions
+ *
+ * This module provides functions to generate and parse compact URL format
+ * for WOLS specimens. The compact format is designed for small QR codes
+ * (petri dishes, culture tubes) where space is limited.
+ *
+ * Format: wemush://v1/{id}?s={species_code}&st={stage}&t={timestamp}
+ *
+ * @module compact-url
+ */
+import type { Specimen, ParseResult, SpecimenRef } from './types.js';
+/**
+ * Standard species codes from the WOLS specification
+ *
+ * @see https://github.com/wemush/open-standard for additional codes
+ */
+export declare const SPECIES_CODES: Record<string, string>;
+/**
+ * Get the full species name from a species code
+ *
+ * @param code - Species code (e.g., "POSTR")
+ * @returns Species name or undefined if code is unknown
+ *
+ * @example
+ * ```typescript
+ * getSpeciesFromCode('POSTR') // Returns "Pleurotus ostreatus"
+ * getSpeciesFromCode('XXXXX') // Returns undefined
+ * ```
+ */
+export declare function getSpeciesFromCode(code: string): string | undefined;
+/**
+ * Get the species code from a species name
+ *
+ * @param species - Full species name (e.g., "Pleurotus ostreatus")
+ * @returns Species code or undefined if species is not registered
+ *
+ * @example
+ * ```typescript
+ * getCodeFromSpecies('Pleurotus ostreatus') // Returns "POSTR"
+ * getCodeFromSpecies('Unknown species') // Returns undefined
+ * ```
+ */
+export declare function getCodeFromSpecies(species: string): string | undefined;
+/**
+ * Register a custom species code
+ *
+ * Use this to add species codes that are not in the standard WOLS list.
+ *
+ * @param code - Species code (uppercase, 5 characters recommended)
+ * @param species - Full species name
+ *
+ * @example
+ * ```typescript
+ * registerSpeciesCode('CCOMA', 'Coprinus comatus');
+ * getSpeciesFromCode('CCOMA') // Returns "Coprinus comatus"
+ * ```
+ */
+export declare function registerSpeciesCode(code: string, species: string): void;
+/**
+ * Generate a compact URL from a specimen
+ *
+ * The compact URL format is designed for small QR codes:
+ * ```
+ * wemush://v1/{id}?s={species_code}&st={stage}&t={timestamp}
+ * ```
+ *
+ * @param specimen - The specimen to encode
+ * @returns Compact URL string
+ *
+ * @example
+ * ```typescript
+ * const specimen = createSpecimen({
+ *   type: 'CULTURE',
+ *   species: 'Pleurotus ostreatus',
+ *   stage: 'COLONIZATION'
+ * });
+ *
+ * const url = toCompactUrl(specimen);
+ * // wemush://v1/clx1a2b3c4?s=POSTR&st=COLONIZATION&ty=CULTURE&t=1734307200
+ * ```
+ */
+export declare function toCompactUrl(specimen: Specimen): string;
+/**
+ * Parse a compact URL into a SpecimenRef
+ *
+ * Returns a reference object containing the minimal information
+ * encoded in the compact URL. Use the id to fetch full specimen
+ * data from the API if needed.
+ *
+ * @param url - Compact URL to parse (wemush://v1/...)
+ * @returns ParseResult with SpecimenRef on success, error on failure
+ *
+ * @example
+ * ```typescript
+ * const result = parseCompactUrl('wemush://v1/clx1a2b3c4?s=POSTR&st=COLONIZATION');
+ *
+ * if (result.success) {
+ *   console.log(result.data.species); // "Pleurotus ostreatus"
+ * }
+ * ```
+ */
+export declare function parseCompactUrl(url: string): ParseResult<SpecimenRef>;
+//# sourceMappingURL=compact-url.d.ts.map

package/dist/types/compact-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-url.d.ts","sourceRoot":"","sources":["../../src/compact-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAA6B,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhG;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWhD,CAAC;AAYF;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEtE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CASvE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAsDvD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC,WAAW,CAAC,CA6GrE"}

package/dist/types/crypto/decrypt.d.ts

@@ -0,0 +1,33 @@
+/**
+ * WOLS Decryption Module
+ *
+ * Provides AES-256-GCM decryption for encrypted specimens using Web Crypto API.
+ * Supports both password-based (PBKDF2) and raw CryptoKey decryption.
+ *
+ * @module crypto/decrypt
+ */
+import type { Specimen, EncryptedSpecimen, DecryptionOptions, ParseResult } from '../types.js';
+/**
+ * Decrypt an encrypted specimen using AES-256-GCM
+ *
+ * @param encrypted - The encrypted specimen wrapper
+ * @param options - Decryption options (key required)
+ * @returns Promise resolving to ParseResult with decrypted specimen or error
+ *
+ * @example
+ * ```typescript
+ * import { decryptSpecimen } from '@wemush/wols/crypto';
+ *
+ * const result = await decryptSpecimen(encrypted, {
+ *   key: 'my-secret-password',
+ * });
+ *
+ * if (result.success) {
+ *   console.log(result.data);
+ * } else {
+ *   console.error(result.error);
+ * }
+ * ```
+ */
+export declare function decryptSpecimen(encrypted: EncryptedSpecimen, options: DecryptionOptions): Promise<ParseResult<Specimen>>;
+//# sourceMappingURL=decrypt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decrypt.d.ts","sourceRoot":"","sources":["../../../src/crypto/decrypt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAqE/F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAqDhC"}

package/dist/types/crypto/encrypt.d.ts

@@ -0,0 +1,32 @@
+/**
+ * WOLS Encryption Module
+ *
+ * Provides AES-256-GCM encryption for specimens using Web Crypto API.
+ * Supports both password-based (PBKDF2) and raw CryptoKey encryption.
+ *
+ * @module crypto/encrypt
+ */
+import type { Specimen, EncryptedSpecimen, EncryptionOptions } from '../types.js';
+/**
+ * Encrypt a specimen using AES-256-GCM
+ *
+ * @param specimen - The specimen to encrypt
+ * @param options - Encryption options (key required)
+ * @returns Promise resolving to encrypted specimen wrapper
+ *
+ * @example
+ * ```typescript
+ * import { encryptSpecimen } from '@wemush/wols/crypto';
+ *
+ * const encrypted = await encryptSpecimen(specimen, {
+ *   key: 'my-secret-password',
+ * });
+ * // Returns: { encrypted: true, payload: "...", iv: "...", algorithm: "AES-256-GCM" }
+ * ```
+ */
+export declare function encryptSpecimen(specimen: Specimen, options: EncryptionOptions): Promise<EncryptedSpecimen>;
+/**
+ * Type guard to check if an object is an encrypted specimen
+ */
+export declare function isEncrypted(value: unknown): value is EncryptedSpecimen;
+//# sourceMappingURL=encrypt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encrypt.d.ts","sourceRoot":"","sources":["../../../src/crypto/encrypt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAwElF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAgC5B;AA+CD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAStE"}

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

@@ -0,0 +1,10 @@
+/**
+ * WOLS Crypto Module
+ *
+ * Provides AES-256-GCM encryption and decryption for specimens.
+ *
+ * @module crypto
+ */
+export { encryptSpecimen, isEncrypted } from './encrypt.js';
+export { decryptSpecimen } from './decrypt.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/crypto/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/errors.d.ts

@@ -0,0 +1,103 @@
+/**
+ * WOLS Error Types
+ *
+ * This module defines all error classes and error codes
+ * used by the WOLS TypeScript library.
+ *
+ * @module errors
+ */
+import type { ValidationError } from './types.js';
+/**
+ * WOLS error codes (stable, for programmatic handling).
+ */
+export declare enum WolsErrorCode {
+    /** General parse error */
+    PARSE_ERROR = "WOLS_PARSE_ERROR",
+    /** Invalid JSON syntax */
+    INVALID_JSON = "WOLS_INVALID_JSON",
+    /** Not a valid WOLS format */
+    INVALID_FORMAT = "WOLS_INVALID_FORMAT",
+    /** Missing or invalid @context field */
+    INVALID_CONTEXT = "WOLS_INVALID_CONTEXT",
+    /** Missing or invalid @type field */
+    INVALID_TYPE = "WOLS_INVALID_TYPE",
+    /** ID doesn't match wemush:[a-z0-9]+ pattern */
+    INVALID_ID_FORMAT = "WOLS_INVALID_ID_FORMAT",
+    /** Version not valid semver */
+    INVALID_VERSION = "WOLS_INVALID_VERSION",
+    /** Type not in SpecimenType enum */
+    INVALID_SPECIMEN_TYPE = "WOLS_INVALID_SPECIMEN_TYPE",
+    /** Required field is missing */
+    REQUIRED_FIELD = "WOLS_REQUIRED_FIELD",
+    /** Date not in ISO 8601 format */
+    INVALID_DATE_FORMAT = "WOLS_INVALID_DATE_FORMAT",
+    /** Strain generation format is invalid */
+    INVALID_GENERATION = "WOLS_INVALID_GENERATION",
+    /** Invalid compact URL format */
+    INVALID_URL = "WOLS_INVALID_URL",
+    /** Encryption operation failed */
+    ENCRYPTION_ERROR = "WOLS_ENCRYPTION_ERROR",
+    /** Decryption operation failed */
+    DECRYPTION_ERROR = "WOLS_DECRYPTION_ERROR",
+    /** Invalid encryption key */
+    INVALID_KEY = "WOLS_INVALID_KEY",
+    /** Payload exceeds QR code capacity */
+    SIZE_EXCEEDED = "WOLS_SIZE_EXCEEDED",
+    /** Unknown or unspecified error */
+    UNKNOWN_ERROR = "WOLS_UNKNOWN_ERROR"
+}
+/**
+ * Base WOLS error class.
+ * All WOLS-specific errors extend this class.
+ */
+export declare class WolsError extends Error {
+    /** Error code for programmatic handling */
+    readonly code: WolsErrorCode;
+    /** Additional error details */
+    readonly details: Record<string, unknown> | undefined;
+    constructor(code: WolsErrorCode, message: string, details?: Record<string, unknown>);
+    /**
+     * Convert error to JSON for serialization.
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Parse error (JSON/format issues).
+ * Thrown when parsing JSON or WOLS data fails.
+ */
+export declare class WolsParseError extends WolsError {
+    /** Character position in the input where error occurred */
+    readonly position: number | undefined;
+    constructor(code: WolsErrorCode, message: string, details?: Record<string, unknown> & {
+        position?: number;
+    });
+}
+/**
+ * Validation error (schema violations).
+ * Thrown when specimen data fails validation.
+ */
+export declare class WolsValidationError extends WolsError {
+    /** Array of validation errors */
+    readonly errors: ValidationError[];
+    constructor(message: string, errors: ValidationError[]);
+}
+/**
+ * Encryption/decryption error.
+ * Thrown when crypto operations fail.
+ */
+export declare class WolsEncryptionError extends WolsError {
+    constructor(code: WolsErrorCode, message: string, details?: Record<string, unknown>);
+}
+/**
+ * Create a required field error.
+ */
+export declare function requiredFieldError(field: string, path?: string): WolsValidationError;
+/**
+ * Create an invalid format error.
+ */
+export declare function invalidFormatError(field: string, expected: string, path?: string): WolsValidationError;
+/**
+ * Create a parse error from a caught exception.
+ */
+export declare function parseErrorFromException(error: unknown, _input?: string): WolsParseError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD;;GAEG;AACH,oBAAY,aAAa;IACvB,0BAA0B;IAC1B,WAAW,qBAAqB;IAChC,0BAA0B;IAC1B,YAAY,sBAAsB;IAClC,8BAA8B;IAC9B,cAAc,wBAAwB;IACtC,wCAAwC;IACxC,eAAe,yBAAyB;IACxC,qCAAqC;IACrC,YAAY,sBAAsB;IAClC,gDAAgD;IAChD,iBAAiB,2BAA2B;IAC5C,+BAA+B;IAC/B,eAAe,yBAAyB;IACxC,oCAAoC;IACpC,qBAAqB,+BAA+B;IACpD,gCAAgC;IAChC,cAAc,wBAAwB;IACtC,kCAAkC;IAClC,mBAAmB,6BAA6B;IAChD,0CAA0C;IAC1C,kBAAkB,4BAA4B;IAC9C,iCAAiC;IACjC,WAAW,qBAAqB;IAChC,kCAAkC;IAClC,gBAAgB,0BAA0B;IAC1C,kCAAkC;IAClC,gBAAgB,0BAA0B;IAC1C,6BAA6B;IAC7B,WAAW,qBAAqB;IAChC,uCAAuC;IACvC,aAAa,uBAAuB;IACpC,mCAAmC;IACnC,aAAa,uBAAuB;CACrC;AAMD;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;gBAE1C,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYnF;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,SAAS;IAC3C,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;gBAGpC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;CAU5D;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE;CASvD;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQpF;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAc,GAAG,mBAAmB,CAQ3F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAc,GACnB,mBAAmB,CAQrB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc,CAoBvF"}

package/dist/types/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @wemush/wols - Official WOLS TypeScript Library
+ *
+ * WeMush Open Labeling Standard (WOLS) v1.1.0 implementation
+ * for biological specimen labeling and traceability.
+ *
+ * @packageDocumentation
+ * @module @wemush/wols
+ * @version 1.1.0
+ */
+export { WOLS_VERSION, WOLS_CONTEXT } from './types.js';
+export type { Brand, SpecimenId, SpecimenType, GrowthStage, Strain, Specimen, SpecimenInput, ParseResult, ValidationResult, ValidationError, ValidationWarning, ValidationOptions, SpecimenRef, QRCodeOptions, EncryptionOptions, DecryptionOptions, EncryptedSpecimen, } from './types.js';
+export { asSpecimenId, isSpecimenType, isGrowthStage, isStrain, SPECIMEN_TYPES, GROWTH_STAGES, } from './types.js';
+export { WolsErrorCode, WolsError, WolsParseError, WolsValidationError, WolsEncryptionError, } from './errors.js';
+export { createSpecimen, serializeSpecimen } from './specimen.js';
+export { validateSpecimen } from './validator.js';
+export { parseSpecimen } from './parser.js';
+export { toCompactUrl, parseCompactUrl, SPECIES_CODES, getSpeciesFromCode, getCodeFromSpecies, registerSpeciesCode, } from './compact-url.js';
+export { encryptSpecimen, isEncrypted, decryptSpecimen } from './crypto/index.js';
+export { toQRCode, toQRCodeDataURL, toQRCodeSVG, isQRAvailable, isQRAvailableSync, } from './qr/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAKxD,YAAY,EAEV,KAAK,EACL,UAAU,EAGV,YAAY,EACZ,WAAW,EACX,MAAM,EACN,QAAQ,EACR,aAAa,EAGb,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EAGjB,WAAW,EAGX,aAAa,EAGb,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,QAAQ,EACR,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,aAAa,EACb,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAKlE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAKlD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKlF,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,eAAe,CAAC"}