@wemush/wols 0.1.0 → 1.3.0

package/dist/esm/types.js

@@ -2,7 +2,7 @@
  * 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.
+ * for the WeMush Open Labeling Standard (WOLS) v1.3.0.
  *
  * @packageDocumentation
  * @module @wemush/wols
@@ -13,7 +13,7 @@
 /**
  * WOLS specification version implemented by this library.
  */
-export const WOLS_VERSION = '1.1.0';
+export const WOLS_VERSION = '1.3.0';
 /**
  * JSON-LD context URL for WOLS specimens.
  */
@@ -35,15 +35,330 @@ export const SPECIMEN_TYPES = [
     'FRUITING',
     'HARVEST',
 ];
+// =============================================================================
+// TYPE ALIAS SYSTEM (v1.2.0)
+// =============================================================================
+/**
+ * Type alias registry for mapping platform-specific types to WOLS types.
+ * @internal
+ */
+const TYPE_ALIAS_REGISTRY = new Map([
+    // Culture aliases
+    ['LIQUID_CULTURE', 'CULTURE'],
+    ['LC', 'CULTURE'],
+    ['AGAR', 'CULTURE'],
+    ['PETRI', 'CULTURE'],
+    ['SLANT', 'CULTURE'],
+    ['CULTURE_PLATE', 'CULTURE'],
+    // Spawn aliases
+    ['GRAIN_SPAWN', 'SPAWN'],
+    ['SAWDUST_SPAWN', 'SPAWN'],
+    ['PLUG_SPAWN', 'SPAWN'],
+    ['DOWEL', 'SPAWN'],
+    // Substrate aliases
+    ['BLOCK', 'SUBSTRATE'],
+    ['BAG', 'SUBSTRATE'],
+    ['BED', 'SUBSTRATE'],
+    ['LOG', 'SUBSTRATE'],
+    ['BUCKET', 'SUBSTRATE'],
+    // Fruiting aliases
+    ['FLUSH', 'FRUITING'],
+    ['PINNING', 'FRUITING'],
+    // PRIMORDIA is a reserved alias (v1.3.0): it resolves to FRUITING, and
+    // createSpecimen() additionally sets stage PRIMORDIA. See PRIMORDIA_TYPE_ALIAS.
+    ['PRIMORDIA', 'FRUITING'],
+    ['FRUIT', 'FRUITING'],
+    ['FIRST_FLUSH', 'FRUITING'],
+    // Harvest aliases
+    ['FRESH', 'HARVEST'],
+    ['DRIED', 'HARVEST'],
+    ['PROCESSED', 'HARVEST'],
+    ['EXTRACT', 'HARVEST'],
+]);
+/**
+ * Reserved type alias with special handling (WOLS v1.3.0).
+ *
+ * `PRIMORDIA` is a GrowthStage, not a SpecimenType. When it is supplied as a
+ * type, it resolves to `FRUITING` and `createSpecimen()` sets
+ * `stage: 'PRIMORDIA'` unless a stage was supplied.
+ *
+ * @since 1.3.0
+ */
+export const PRIMORDIA_TYPE_ALIAS = 'PRIMORDIA';
+/**
+ * Register a custom type alias.
+ *
+ * @param alias - The alias string (case-insensitive, stored uppercase)
+ * @param wolsType - The canonical WOLS SpecimenType
+ * @throws Error if `alias` is the reserved `PRIMORDIA` alias
+ *
+ * @example
+ * ```typescript
+ * registerTypeAlias('MYCELIUM_BLOCK', 'SUBSTRATE');
+ * ```
+ */
+export function registerTypeAlias(alias, wolsType) {
+    const upper = alias.toUpperCase();
+    if (upper === PRIMORDIA_TYPE_ALIAS && wolsType !== 'FRUITING') {
+        throw new Error(`'${PRIMORDIA_TYPE_ALIAS}' is a reserved alias for FRUITING and cannot be remapped`);
+    }
+    TYPE_ALIAS_REGISTRY.set(upper, wolsType);
+}
+/**
+ * Resolve a type alias to its canonical WOLS type.
+ * Returns the input if it's already a valid SpecimenType or no alias exists.
+ *
+ * @param typeOrAlias - Type string or alias to resolve
+ * @returns Canonical SpecimenType or original string if not found
+ *
+ * @example
+ * ```typescript
+ * resolveTypeAlias('LIQUID_CULTURE') // Returns 'CULTURE'
+ * resolveTypeAlias('CULTURE')        // Returns 'CULTURE'
+ * resolveTypeAlias('unknown')        // Returns 'unknown'
+ * ```
+ *
+ * @remarks Maps the type only. `PRIMORDIA` resolves to `FRUITING` here and
+ * the PRIMORDIA stage is lost; use {@link resolveTypeAndStage} when building
+ * a specimen from user input.
+ */
+export function resolveTypeAlias(typeOrAlias) {
+    const upper = typeOrAlias.toUpperCase();
+    // Already a valid type?
+    if (SPECIMEN_TYPES.includes(upper)) {
+        return upper;
+    }
+    // Check alias registry
+    const resolved = TYPE_ALIAS_REGISTRY.get(upper);
+    return resolved ?? typeOrAlias;
+}
+/**
+ * Resolve a supplied specimen type (canonical or alias, any case) together
+ * with its stage, applying the reserved `PRIMORDIA` rule (WOLS v1.3.0).
+ *
+ * This is the single source of truth used by `createSpecimen()` and
+ * `serializeSpecimen()`. `resolveTypeAlias()` and `mapToWolsType()` map the
+ * type only; integrations that map a type and then build a specimen
+ * themselves should use this function so the `PRIMORDIA` stage is not lost.
+ *
+ * - `PRIMORDIA` resolves to `FRUITING`, and `stage` becomes `'PRIMORDIA'`
+ *   only when no stage was supplied (a supplied stage is never overridden).
+ *   `primordia` is `true` so callers can warn.
+ * - Other aliases resolve the type and leave `stage` unchanged.
+ * - Unknown types return `null`.
+ *
+ * @example
+ * ```typescript
+ * resolveTypeAndStage('primordia')            // { type: 'FRUITING', stage: 'PRIMORDIA', primordia: true }
+ * resolveTypeAndStage('PRIMORDIA', 'FRUITING') // { type: 'FRUITING', stage: 'FRUITING', primordia: true }
+ * resolveTypeAndStage('LC')                    // { type: 'CULTURE', stage: undefined, primordia: false }
+ * ```
+ *
+ * @since 1.3.0
+ */
+export function resolveTypeAndStage(type, stage) {
+    if (typeof type !== 'string') {
+        return null;
+    }
+    if (type.toUpperCase() === PRIMORDIA_TYPE_ALIAS) {
+        return { type: 'FRUITING', stage: stage ?? 'PRIMORDIA', primordia: true };
+    }
+    const resolved = resolveTypeAlias(type);
+    return isSpecimenType(resolved) ? { type: resolved, stage, primordia: false } : null;
+}
+/**
+ * Get all registered type aliases.
+ *
+ * @returns ReadonlyMap of alias -> SpecimenType mappings
+ */
+export function getTypeAliases() {
+    return TYPE_ALIAS_REGISTRY;
+}
+// =============================================================================
+// TYPE MAPPING EXPORTS (v1.2.0)
+// =============================================================================
+/**
+ * Mapping from WOLS types to common platform type names.
+ *
+ * This provides a centralized lookup for integrations that need to
+ * display user-friendly type names or map to platform-specific values.
+ *
+ * @since 1.2.0
+ */
+export const WOLS_TO_PLATFORM_MAP = {
+    CULTURE: ['Liquid Culture', 'LC', 'Agar', 'Petri', 'Slant', 'Culture Plate'],
+    SPAWN: ['Grain Spawn', 'Sawdust Spawn', 'Plug Spawn', 'Dowel'],
+    SUBSTRATE: ['Block', 'Bag', 'Bed', 'Log', 'Bucket'],
+    FRUITING: ['Pinning', 'Primordia', 'Fruiting', 'Flush', 'First Flush'],
+    HARVEST: ['Fresh', 'Dried', 'Processed', 'Extract'],
+};
+/**
+ * Map a platform-specific type to a WOLS SpecimenType.
+ *
+ * First checks registered aliases, then falls back to direct lookup.
+ *
+ * @param platformType - Platform-specific type name
+ * @returns Matching SpecimenType or null if not found
+ *
+ * @example
+ * ```typescript
+ * mapToWolsType('Liquid Culture') // Returns 'CULTURE'
+ * mapToWolsType('LC')             // Returns 'CULTURE'
+ * mapToWolsType('Unknown Type')   // Returns null
+ * ```
+ *
+ * @remarks Maps the type only. `PRIMORDIA` maps to `FRUITING` and the
+ * PRIMORDIA stage is lost; use {@link resolveTypeAndStage} when building a
+ * specimen from user input.
+ *
+ * @since 1.2.0
+ */
+export function mapToWolsType(platformType) {
+    // First try the alias registry
+    const resolved = resolveTypeAlias(platformType);
+    if (isSpecimenType(resolved)) {
+        return resolved;
+    }
+    // Fall back to searching WOLS_TO_PLATFORM_MAP
+    const normalized = platformType.toUpperCase().replace(/\s+/g, '_');
+    for (const [wolsType, platformTypes] of Object.entries(WOLS_TO_PLATFORM_MAP)) {
+        for (const pt of platformTypes) {
+            if (pt.toUpperCase().replace(/\s+/g, '_') === normalized) {
+                return wolsType;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Get all platform type names for a WOLS SpecimenType.
+ *
+ * @param wolsType - WOLS SpecimenType
+ * @returns Array of platform type names
+ *
+ * @example
+ * ```typescript
+ * mapFromWolsType('CULTURE')
+ * // Returns ['Liquid Culture', 'LC', 'Agar', 'Petri', 'Slant', 'Culture Plate']
+ * ```
+ *
+ * @since 1.2.0
+ */
+export function mapFromWolsType(wolsType) {
+    return WOLS_TO_PLATFORM_MAP[wolsType] ?? [];
+}
+/**
+ * Register a custom platform type mapping.
+ *
+ * This adds to both the alias registry (for resolveTypeAlias) and
+ * can be used for custom platform integrations.
+ *
+ * @param platformType - Platform-specific type name
+ * @param wolsType - WOLS SpecimenType to map to
+ *
+ * @example
+ * ```typescript
+ * registerPlatformType('Mycelium Block', 'SUBSTRATE');
+ * mapToWolsType('Mycelium Block') // Returns 'SUBSTRATE'
+ * ```
+ *
+ * @since 1.2.0
+ */
+export function registerPlatformType(platformType, wolsType) {
+    // Add to alias registry for resolveTypeAlias support
+    registerTypeAlias(platformType, wolsType);
+}
 /**
  * Array of valid growth stages for validation.
+ * Ordered by typical lifecycle progression.
  */
 export const GROWTH_STAGES = [
     'INOCULATION',
+    'INCUBATION',
     'COLONIZATION',
+    'PRIMORDIA',
     'FRUITING',
+    'SENESCENCE',
     'HARVEST',
 ];
+/**
+ * Pattern for parsing generation strings.
+ * Matches: P, P1, F{n}, G{n}, or plain numbers.
+ */
+const GENERATION_PARSE_PATTERN = /^(P|P1|F(\d+)|G(\d+)|(\d+))$/i;
+/**
+ * Normalize a generation string to the specified format.
+ *
+ * Accepts multiple input formats:
+ * - Filial: F1, F2, F3, etc.
+ * - Parental: P or P1
+ * - Generational: G1, G2, G3, etc.
+ * - Numeric: 1, 2, 3, etc.
+ *
+ * @param generation - The generation string to normalize
+ * @param format - Target format (default: 'preserve')
+ * @returns Normalized generation string, or original if not parseable
+ *
+ * @example
+ * ```typescript
+ * normalizeGeneration('G2', 'filial')  // Returns 'F2'
+ * normalizeGeneration('3', 'filial')   // Returns 'F3'
+ * normalizeGeneration('F1', 'numeric') // Returns '1'
+ * normalizeGeneration('P', 'filial')   // Returns 'P'
+ * ```
+ *
+ * @since 1.2.0
+ */
+export function normalizeGeneration(generation, format = 'preserve') {
+    const trimmed = generation.trim().toUpperCase();
+    // Handle parental generation specially
+    if (trimmed === 'P' || trimmed === 'P1') {
+        return format === 'numeric' ? '0' : 'P';
+    }
+    const match = GENERATION_PARSE_PATTERN.exec(trimmed);
+    if (!match) {
+        return generation; // Return original if not parseable
+    }
+    // Extract the numeric value
+    let numericValue;
+    if (match[2] !== undefined) {
+        // F{n} format
+        numericValue = parseInt(match[2], 10);
+    }
+    else if (match[3] !== undefined) {
+        // G{n} format
+        numericValue = parseInt(match[3], 10);
+    }
+    else if (match[4] !== undefined) {
+        // Plain number
+        numericValue = parseInt(match[4], 10);
+    }
+    else {
+        return generation; // Shouldn't reach here
+    }
+    switch (format) {
+        case 'preserve':
+            return trimmed;
+        case 'filial':
+            return `F${numericValue}`;
+        case 'numeric':
+            return String(numericValue);
+        default:
+            return generation;
+    }
+}
+/**
+ * Check if a generation string is valid.
+ *
+ * @param generation - The generation string to validate
+ * @returns True if valid, false otherwise
+ *
+ * @since 1.2.0
+ */
+export function isValidGeneration(generation) {
+    const trimmed = generation.trim().toUpperCase();
+    return GENERATION_PARSE_PATTERN.test(trimmed);
+}
 // =============================================================================
 // TYPE GUARDS
 // =============================================================================

package/dist/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAkBzD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,EAAgB,CAAC;AAC1B,CAAC;AAWD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,SAAS;IACT,OAAO;IACP,WAAW;IACX,UAAU;IACV,SAAS;CACD,CAAC;AAOX;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,aAAa;IACb,cAAc;IACd,UAAU;IACV,SAAS;CACD,CAAC;AAgPX,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,cAAc,CAAC,QAAQ,CAAC,KAAqB,CAAC,CAAC;AACrF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAoB,CAAC,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAQ,KAAgB,CAAC,IAAI,KAAK,QAAQ,CAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils/cuid.js

@@ -134,12 +134,14 @@ export function createSpecimenId() {
     return `wemush:${createId()}`;
 }
 /**
- * Validate a specimen ID format.
+ * Validate a specimen ID: the `wemush:` prefix followed by any non-empty suffix
+ * (WOLS v1.3.0). Pass `strict: true` for the CUID-style `wemush:[a-z0-9]+` check.
  *
  * @param id - The ID to validate
- * @returns true if the ID matches the expected format
+ * @param strict - Require a lowercase alphanumeric suffix
+ * @returns true if the ID is valid
  */
-export function isValidSpecimenId(id) {
-    return /^wemush:[a-z0-9]+$/.test(id);
+export function isValidSpecimenId(id, strict = false) {
+    return strict ? /^wemush:[a-z0-9]+$/.test(id) : id.startsWith('wemush:') && id.length > 7;
 }
 //# sourceMappingURL=cuid.js.map

package/dist/esm/utils/cuid.js.map

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

package/dist/esm/utils/environment.js

@@ -0,0 +1,193 @@
+/**
+ * Environment Detection Utilities
+ *
+ * This module provides runtime environment detection for selecting
+ * appropriate crypto implementations and other environment-specific behavior.
+ *
+ * @module utils/environment
+ * @since 1.2.0
+ */
+// =============================================================================
+// ENVIRONMENT DETECTION
+// =============================================================================
+/**
+ * Check if running in a server-side Node.js environment.
+ *
+ * @returns True if running in Node.js, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (isServer()) {
+ *   // Use Node.js crypto module
+ * }
+ * ```
+ *
+ * @since 1.2.0
+ */
+export function isServer() {
+    return (typeof globalThis !== 'undefined' &&
+        typeof globalThis.process
+            ?.versions?.node === 'string');
+}
+/**
+ * Check if running in a browser environment.
+ *
+ * @returns True if running in a browser, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (isBrowser()) {
+ *   // Use Web Crypto API
+ * }
+ * ```
+ *
+ * @since 1.2.0
+ */
+export function isBrowser() {
+    return (typeof globalThis !== 'undefined' &&
+        typeof globalThis.window !== 'undefined' &&
+        typeof globalThis.document !== 'undefined');
+}
+/**
+ * Check if running in a Web Worker environment.
+ *
+ * @returns True if running in a Web Worker, false otherwise
+ *
+ * @since 1.2.0
+ */
+export function isWebWorker() {
+    // Check if WorkerGlobalScope exists and if self is an instance of it
+    // In a Web Worker, self instanceof WorkerGlobalScope is true
+    // In the main thread, WorkerGlobalScope doesn't exist or self is not an instance
+    if (typeof globalThis === 'undefined') {
+        return false;
+    }
+    const global = globalThis;
+    return (typeof global.WorkerGlobalScope !== 'undefined' &&
+        typeof global.self !== 'undefined' &&
+        global.self instanceof global.WorkerGlobalScope);
+}
+/**
+ * Check if running in Deno environment.
+ *
+ * @returns True if running in Deno, false otherwise
+ *
+ * @since 1.2.0
+ */
+export function isDeno() {
+    return (typeof globalThis !== 'undefined' &&
+        typeof globalThis.Deno !== 'undefined');
+}
+/**
+ * Check if running in Bun environment.
+ *
+ * @returns True if running in Bun, false otherwise
+ *
+ * @since 1.2.0
+ */
+export function isBun() {
+    return (typeof globalThis !== 'undefined' &&
+        typeof globalThis.Bun !== 'undefined');
+}
+/**
+ * Get the current runtime environment.
+ *
+ * @returns The detected runtime environment
+ *
+ * @example
+ * ```typescript
+ * const env = getRuntimeEnvironment();
+ * console.log(`Running in: ${env}`);
+ * ```
+ *
+ * @since 1.2.0
+ */
+export function getRuntimeEnvironment() {
+    if (isBun())
+        return 'bun';
+    if (isDeno())
+        return 'deno';
+    if (isServer())
+        return 'node';
+    if (isWebWorker())
+        return 'webworker';
+    if (isBrowser())
+        return 'browser';
+    return 'unknown';
+}
+// =============================================================================
+// CRYPTO SUPPORT DETECTION
+// =============================================================================
+/**
+ * Check if Web Crypto API is available.
+ *
+ * @returns True if Web Crypto API is available, false otherwise
+ *
+ * @since 1.2.0
+ */
+export function supportsWebCrypto() {
+    return (typeof globalThis !== 'undefined' &&
+        typeof globalThis.crypto?.subtle !==
+            'undefined');
+}
+/**
+ * Check if Node.js crypto module is available.
+ *
+ * Note: This performs a synchronous check and does not actually import the module.
+ *
+ * @returns True if likely running in Node.js with crypto support, false otherwise
+ *
+ * @since 1.2.0
+ */
+export function supportsNodeCrypto() {
+    return isServer() || isBun();
+}
+/**
+ * Check if any cryptographic support is available.
+ *
+ * This is useful for determining if encryption/decryption features can be used.
+ *
+ * @returns True if crypto is supported, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (isCryptoSupported()) {
+ *   const encrypted = await encryptSpecimen(specimen, { key: password });
+ * } else {
+ *   console.warn('Crypto not supported in this environment');
+ * }
+ * ```
+ *
+ * @since 1.2.0
+ */
+export function isCryptoSupported() {
+    return supportsWebCrypto() || supportsNodeCrypto();
+}
+// =============================================================================
+// FEATURE DETECTION
+// =============================================================================
+/**
+ * Check if TextEncoder/TextDecoder are available.
+ *
+ * @returns True if text encoding is supported, false otherwise
+ *
+ * @since 1.2.0
+ */
+export function supportsTextEncoding() {
+    return (typeof globalThis !== 'undefined' &&
+        typeof globalThis.TextEncoder !== 'undefined' &&
+        typeof globalThis.TextDecoder !== 'undefined');
+}
+/**
+ * Check if URL and URLSearchParams are available.
+ *
+ * @returns True if URL APIs are supported, false otherwise
+ *
+ * @since 1.2.0
+ */
+export function supportsURLAPIs() {
+    return (typeof globalThis !== 'undefined' &&
+        typeof globalThis.URL !== 'undefined' &&
+        typeof globalThis.URLSearchParams !== 'undefined');
+}
+//# sourceMappingURL=environment.js.map

package/dist/esm/utils/environment.js.map

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