@wemush/wols 0.1.0 → 1.2.0

package/dist/cjs/types.js

@@ -3,14 +3,22 @@
  * 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.2.0.
  *
  * @packageDocumentation
  * @module @wemush/wols
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GROWTH_STAGES = exports.SPECIMEN_TYPES = exports.WOLS_CONTEXT = exports.WOLS_VERSION = void 0;
+exports.GROWTH_STAGES = exports.WOLS_TO_PLATFORM_MAP = exports.SPECIMEN_TYPES = exports.WOLS_CONTEXT = exports.WOLS_VERSION = void 0;
 exports.asSpecimenId = asSpecimenId;
+exports.registerTypeAlias = registerTypeAlias;
+exports.resolveTypeAlias = resolveTypeAlias;
+exports.getTypeAliases = getTypeAliases;
+exports.mapToWolsType = mapToWolsType;
+exports.mapFromWolsType = mapFromWolsType;
+exports.registerPlatformType = registerPlatformType;
+exports.normalizeGeneration = normalizeGeneration;
+exports.isValidGeneration = isValidGeneration;
 exports.isSpecimenType = isSpecimenType;
 exports.isGrowthStage = isGrowthStage;
 exports.isStrain = isStrain;
@@ -20,7 +28,7 @@ exports.isStrain = isStrain;
 /**
  * WOLS specification version implemented by this library.
  */
-exports.WOLS_VERSION = '1.1.0';
+exports.WOLS_VERSION = '1.2.0';
 /**
  * JSON-LD context URL for WOLS specimens.
  */
@@ -42,15 +50,271 @@ exports.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', 'FRUITING'], // Scientifically precise term for pin initiation stage
+    ['FRUIT', 'FRUITING'],
+    ['FIRST_FLUSH', 'FRUITING'],
+    // Harvest aliases
+    ['FRESH', 'HARVEST'],
+    ['DRIED', 'HARVEST'],
+    ['PROCESSED', 'HARVEST'],
+    ['EXTRACT', 'HARVEST'],
+]);
+/**
+ * Register a custom type alias.
+ *
+ * @param alias - The alias string (case-insensitive, stored uppercase)
+ * @param wolsType - The canonical WOLS SpecimenType
+ *
+ * @example
+ * ```typescript
+ * registerTypeAlias('MYCELIUM_BLOCK', 'SUBSTRATE');
+ * ```
+ */
+function registerTypeAlias(alias, wolsType) {
+    TYPE_ALIAS_REGISTRY.set(alias.toUpperCase(), 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'
+ * ```
+ */
+function resolveTypeAlias(typeOrAlias) {
+    const upper = typeOrAlias.toUpperCase();
+    // Already a valid type?
+    if (exports.SPECIMEN_TYPES.includes(upper)) {
+        return upper;
+    }
+    // Check alias registry
+    const resolved = TYPE_ALIAS_REGISTRY.get(upper);
+    return resolved ?? typeOrAlias;
+}
+/**
+ * Get all registered type aliases.
+ *
+ * @returns ReadonlyMap of alias -> SpecimenType mappings
+ */
+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
+ */
+exports.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
+ * ```
+ *
+ * @since 1.2.0
+ */
+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(exports.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
+ */
+function mapFromWolsType(wolsType) {
+    return exports.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
+ */
+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.
  */
 exports.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
+ */
+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
+ */
+function isValidGeneration(generation) {
+    const trimmed = generation.trim().toUpperCase();
+    return GENERATION_PARSE_PATTERN.test(trimmed);
+}
 // =============================================================================
 // TYPE GUARDS
 // =============================================================================

package/dist/cjs/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAoCH,oCAEC;AA0RD,wCAEC;AAKD,sCAEC;AAKD,4BAOC;AAnVD,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;GAEG;AACU,QAAA,YAAY,GAAG,OAAO,CAAC;AAEpC;;GAEG;AACU,QAAA,YAAY,GAAG,4BAA4B,CAAC;AAkBzD;;;GAGG;AACH,SAAgB,YAAY,CAAC,EAAU;IACrC,OAAO,EAAgB,CAAC;AAC1B,CAAC;AAWD;;GAEG;AACU,QAAA,cAAc,GAA4B;IACrD,SAAS;IACT,OAAO;IACP,WAAW;IACX,UAAU;IACV,SAAS;CACD,CAAC;AAOX;;GAEG;AACU,QAAA,aAAa,GAA2B;IACnD,aAAa;IACb,cAAc;IACd,UAAU;IACV,SAAS;CACD,CAAC;AAgPX,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,sBAAc,CAAC,QAAQ,CAAC,KAAqB,CAAC,CAAC;AACrF,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,qBAAa,CAAC,QAAQ,CAAC,KAAoB,CAAC,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,SAAgB,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":";AAAA;;;;;;;;GAQG;;;AAoCH,oCAEC;AAyED,8CAEC;AAgBD,4CAWC;AAOD,wCAEC;AAuCD,sCAkBC;AAgBD,0CAEC;AAmBD,oDAGC;AAiFD,kDAyCC;AAUD,8CAGC;AAiWD,wCAEC;AAKD,sCAEC;AAKD,4BAOC;AAjvBD,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;GAEG;AACU,QAAA,YAAY,GAAG,OAAO,CAAC;AAEpC;;GAEG;AACU,QAAA,YAAY,GAAG,4BAA4B,CAAC;AAkBzD;;;GAGG;AACH,SAAgB,YAAY,CAAC,EAAU;IACrC,OAAO,EAAgB,CAAC;AAC1B,CAAC;AAWD;;GAEG;AACU,QAAA,cAAc,GAA4B;IACrD,SAAS;IACT,OAAO;IACP,WAAW;IACX,UAAU;IACV,SAAS;CACD,CAAC;AAEX,gFAAgF;AAChF,6BAA6B;AAC7B,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,mBAAmB,GAA8B,IAAI,GAAG,CAAC;IAC7D,kBAAkB;IAClB,CAAC,gBAAgB,EAAE,SAAS,CAAC;IAC7B,CAAC,IAAI,EAAE,SAAS,CAAC;IACjB,CAAC,MAAM,EAAE,SAAS,CAAC;IACnB,CAAC,OAAO,EAAE,SAAS,CAAC;IACpB,CAAC,OAAO,EAAE,SAAS,CAAC;IACpB,CAAC,eAAe,EAAE,SAAS,CAAC;IAC5B,gBAAgB;IAChB,CAAC,aAAa,EAAE,OAAO,CAAC;IACxB,CAAC,eAAe,EAAE,OAAO,CAAC;IAC1B,CAAC,YAAY,EAAE,OAAO,CAAC;IACvB,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,oBAAoB;IACpB,CAAC,OAAO,EAAE,WAAW,CAAC;IACtB,CAAC,KAAK,EAAE,WAAW,CAAC;IACpB,CAAC,KAAK,EAAE,WAAW,CAAC;IACpB,CAAC,KAAK,EAAE,WAAW,CAAC;IACpB,CAAC,QAAQ,EAAE,WAAW,CAAC;IACvB,mBAAmB;IACnB,CAAC,OAAO,EAAE,UAAU,CAAC;IACrB,CAAC,SAAS,EAAE,UAAU,CAAC;IACvB,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,uDAAuD;IAClF,CAAC,OAAO,EAAE,UAAU,CAAC;IACrB,CAAC,aAAa,EAAE,UAAU,CAAC;IAC3B,kBAAkB;IAClB,CAAC,OAAO,EAAE,SAAS,CAAC;IACpB,CAAC,OAAO,EAAE,SAAS,CAAC;IACpB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,SAAS,EAAE,SAAS,CAAC;CACvB,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,SAAgB,iBAAiB,CAAC,KAAa,EAAE,QAAsB;IACrE,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,gBAAgB,CAAC,WAAmB;IAClD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IAExC,wBAAwB;IACxB,IAAI,sBAAc,CAAC,QAAQ,CAAC,KAAqB,CAAC,EAAE,CAAC;QACnD,OAAO,KAAqB,CAAC;IAC/B,CAAC;IAED,uBAAuB;IACvB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChD,OAAO,QAAQ,IAAI,WAAW,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc;IAC5B,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAEhF;;;;;;;GAOG;AACU,QAAA,oBAAoB,GAAsD;IACrF,OAAO,EAAE,CAAC,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC;IAC5E,KAAK,EAAE,CAAC,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,OAAO,CAAC;IAC9D,SAAS,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;IACnD,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,CAAC;IACtE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC;CACpD,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,aAAa,CAAC,YAAoB;IAChD,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,8CAA8C;IAC9C,MAAM,UAAU,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnE,KAAK,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,4BAAoB,CAAC,EAAE,CAAC;QAC7E,KAAK,MAAM,EAAE,IAAI,aAAa,EAAE,CAAC;YAC/B,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,UAAU,EAAE,CAAC;gBACzD,OAAO,QAAwB,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,eAAe,CAAC,QAAsB;IACpD,OAAO,4BAAoB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,oBAAoB,CAAC,YAAoB,EAAE,QAAsB;IAC/E,qDAAqD;IACrD,iBAAiB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAuBD;;;GAGG;AACU,QAAA,aAAa,GAA2B;IACnD,aAAa;IACb,YAAY;IACZ,cAAc;IACd,WAAW;IACX,UAAU;IACV,YAAY;IACZ,SAAS;CACD,CAAC;AAiBX;;;GAGG;AACH,MAAM,wBAAwB,GAAG,+BAA+B,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,mBAAmB,CACjC,UAAkB,EAClB,SAA2B,UAAU;IAErC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEhD,uCAAuC;IACvC,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1C,CAAC;IAED,MAAM,KAAK,GAAG,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,UAAU,CAAC,CAAC,mCAAmC;IACxD,CAAC;IAED,4BAA4B;IAC5B,IAAI,YAAoB,CAAC;IACzB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC3B,cAAc;QACd,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;SAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAClC,cAAc;QACd,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;SAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAClC,eAAe;QACf,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,OAAO,UAAU,CAAC,CAAC,uBAAuB;IAC5C,CAAC;IAED,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU;YACb,OAAO,OAAO,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,IAAI,YAAY,EAAE,CAAC;QAC5B,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC;QAC9B;YACE,OAAO,UAAU,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAAC,UAAkB;IAClD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,OAAO,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAChD,CAAC;AA0VD,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,sBAAc,CAAC,QAAQ,CAAC,KAAqB,CAAC,CAAC;AACrF,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,qBAAa,CAAC,QAAQ,CAAC,KAAoB,CAAC,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,SAAgB,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"}

package/dist/cjs/utils/environment.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isServer = isServer;
+exports.isBrowser = isBrowser;
+exports.isWebWorker = isWebWorker;
+exports.isDeno = isDeno;
+exports.isBun = isBun;
+exports.getRuntimeEnvironment = getRuntimeEnvironment;
+exports.supportsWebCrypto = supportsWebCrypto;
+exports.supportsNodeCrypto = supportsNodeCrypto;
+exports.isCryptoSupported = isCryptoSupported;
+exports.supportsTextEncoding = supportsTextEncoding;
+exports.supportsURLAPIs = supportsURLAPIs;
+// =============================================================================
+// 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
+ */
+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
+ */
+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
+ */
+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
+ */
+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
+ */
+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
+ */
+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
+ */
+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
+ */
+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
+ */
+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
+ */
+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
+ */
+function supportsURLAPIs() {
+    return (typeof globalThis !== 'undefined' &&
+        typeof globalThis.URL !== 'undefined' &&
+        typeof globalThis.URLSearchParams !== 'undefined');
+}
+//# sourceMappingURL=environment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/utils/environment.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AA+BH,4BAMC;AAgBD,8BAMC;AASD,kCAkBC;AASD,wBAKC;AASD,sBAKC;AAeD,sDAOC;AAaD,8CAMC;AAWD,gDAEC;AAoBD,8CAEC;AAaD,oDAMC;AASD,0CAMC;AAnND,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF;;;;;;;;;;;;;GAaG;AACH,SAAgB,QAAQ;IACtB,OAAO,CACL,OAAO,UAAU,KAAK,WAAW;QACjC,OAAQ,UAAwE,CAAC,OAAO;YACtF,EAAE,QAAQ,EAAE,IAAI,KAAK,QAAQ,CAChC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,SAAS;IACvB,OAAO,CACL,OAAO,UAAU,KAAK,WAAW;QACjC,OAAQ,UAA8C,CAAC,MAAM,KAAK,WAAW;QAC7E,OAAQ,UAAgD,CAAC,QAAQ,KAAK,WAAW,CAClF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,WAAW;IACzB,qEAAqE;IACrE,6DAA6D;IAC7D,iFAAiF;IACjF,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,UAGd,CAAC;IAEF,OAAO,CACL,OAAO,MAAM,CAAC,iBAAiB,KAAK,WAAW;QAC/C,OAAO,MAAM,CAAC,IAAI,KAAK,WAAW;QAClC,MAAM,CAAC,IAAI,YAAY,MAAM,CAAC,iBAAiB,CAChD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,MAAM;IACpB,OAAO,CACL,OAAO,UAAU,KAAK,WAAW;QACjC,OAAQ,UAA4C,CAAC,IAAI,KAAK,WAAW,CAC1E,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,KAAK;IACnB,OAAO,CACL,OAAO,UAAU,KAAK,WAAW;QACjC,OAAQ,UAA2C,CAAC,GAAG,KAAK,WAAW,CACxE,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,qBAAqB;IACnC,IAAI,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAC1B,IAAI,MAAM,EAAE;QAAE,OAAO,MAAM,CAAC;IAC5B,IAAI,QAAQ,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,IAAI,WAAW,EAAE;QAAE,OAAO,WAAW,CAAC;IACtC,IAAI,SAAS,EAAE;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;;;;;GAMG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,CACL,OAAO,UAAU,KAAK,WAAW;QACjC,OAAQ,UAA2D,CAAC,MAAM,EAAE,MAAM;YAChF,WAAW,CACd,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,kBAAkB;IAChC,OAAO,QAAQ,EAAE,IAAI,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,iBAAiB,EAAE,IAAI,kBAAkB,EAAE,CAAC;AACrD,CAAC;AAED,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;;GAMG;AACH,SAAgB,oBAAoB;IAClC,OAAO,CACL,OAAO,UAAU,KAAK,WAAW;QACjC,OAAQ,UAAmD,CAAC,WAAW,KAAK,WAAW;QACvF,OAAQ,UAAmD,CAAC,WAAW,KAAK,WAAW,CACxF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,eAAe;IAC7B,OAAO,CACL,OAAO,UAAU,KAAK,WAAW;QACjC,OAAQ,UAA2C,CAAC,GAAG,KAAK,WAAW;QACvE,OAAQ,UAAuD,CAAC,eAAe,KAAK,WAAW,CAChG,CAAC;AACJ,CAAC"}