@wemush/wols 0.1.0

package/dist/esm/specimen.js

@@ -0,0 +1,159 @@
+/**
+ * Specimen Creation and Serialization
+ *
+ * This module provides functions to create and serialize
+ * WOLS v1.1.0 compliant specimen objects.
+ *
+ * @module specimen
+ */
+import { WOLS_CONTEXT, WOLS_VERSION, asSpecimenId, isStrain } from './types.js';
+import { createSpecimenId } from './utils/cuid.js';
+/**
+ * Expand a strain input to a full Strain object.
+ * String inputs are expanded to { name: string }.
+ *
+ * @param strain - String or Strain object input
+ * @returns Strain object or undefined
+ */
+function expandStrain(strain) {
+    if (strain === undefined) {
+        return undefined;
+    }
+    if (typeof strain === 'string') {
+        return { name: strain };
+    }
+    if (isStrain(strain)) {
+        return strain;
+    }
+    return undefined;
+}
+/**
+ * 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 function createSpecimen(input) {
+    const id = asSpecimenId(createSpecimenId());
+    const strain = expandStrain(input.strain);
+    // Build specimen with required fields
+    const specimen = {
+        '@context': WOLS_CONTEXT,
+        '@type': 'Specimen',
+        id,
+        version: WOLS_VERSION,
+        type: input.type,
+        species: input.species,
+    };
+    // Add optional fields only if defined
+    if (strain !== undefined) {
+        specimen.strain = strain;
+    }
+    if (input.stage !== undefined) {
+        specimen.stage = input.stage;
+    }
+    if (input.batch !== undefined) {
+        specimen.batch = input.batch;
+    }
+    if (input.organization !== undefined) {
+        specimen.organization = input.organization;
+    }
+    if (input.creator !== undefined) {
+        specimen.creator = input.creator;
+    }
+    if (input.custom !== undefined) {
+        specimen.custom = input.custom;
+    }
+    return 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 function serializeSpecimen(specimen) {
+    // Build ordered object with JSON-LD fields first
+    const ordered = {
+        '@context': specimen['@context'],
+        '@type': specimen['@type'],
+        id: specimen.id,
+        version: specimen.version,
+        type: specimen.type,
+        species: specimen.species,
+    };
+    // Add optional fields in order, only if defined
+    if (specimen.strain !== undefined) {
+        ordered['strain'] = specimen.strain;
+    }
+    if (specimen.stage !== undefined) {
+        ordered['stage'] = specimen.stage;
+    }
+    if (specimen.created !== undefined) {
+        ordered['created'] = specimen.created;
+    }
+    if (specimen.batch !== undefined) {
+        ordered['batch'] = specimen.batch;
+    }
+    if (specimen.organization !== undefined) {
+        ordered['organization'] = specimen.organization;
+    }
+    if (specimen.creator !== undefined) {
+        ordered['creator'] = specimen.creator;
+    }
+    if (specimen.custom !== undefined) {
+        ordered['custom'] = specimen.custom;
+    }
+    if (specimen.signature !== undefined) {
+        ordered['signature'] = specimen.signature;
+    }
+    return JSON.stringify(ordered);
+}
+//# sourceMappingURL=specimen.js.map

package/dist/esm/specimen.js.map

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

package/dist/esm/types.js

@@ -0,0 +1,71 @@
+/**
+ * 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
+ */
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+/**
+ * WOLS specification version implemented by this library.
+ */
+export const WOLS_VERSION = '1.1.0';
+/**
+ * JSON-LD context URL for WOLS specimens.
+ */
+export const WOLS_CONTEXT = 'https://wemush.com/wols/v1';
+/**
+ * Create a SpecimenId from a string.
+ * Does not validate the format - use isValidSpecimenId for validation.
+ */
+export function asSpecimenId(id) {
+    return id;
+}
+/**
+ * Array of valid specimen types for validation.
+ */
+export const SPECIMEN_TYPES = [
+    'CULTURE',
+    'SPAWN',
+    'SUBSTRATE',
+    'FRUITING',
+    'HARVEST',
+];
+/**
+ * Array of valid growth stages for validation.
+ */
+export const GROWTH_STAGES = [
+    'INOCULATION',
+    'COLONIZATION',
+    'FRUITING',
+    'HARVEST',
+];
+// =============================================================================
+// TYPE GUARDS
+// =============================================================================
+/**
+ * Type guard to check if a value is a valid SpecimenType.
+ */
+export function isSpecimenType(value) {
+    return typeof value === 'string' && SPECIMEN_TYPES.includes(value);
+}
+/**
+ * Type guard to check if a value is a valid GrowthStage.
+ */
+export function isGrowthStage(value) {
+    return typeof value === 'string' && GROWTH_STAGES.includes(value);
+}
+/**
+ * Type guard to check if a value is a Strain object.
+ */
+export function isStrain(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'name' in value &&
+        typeof value.name === 'string');
+}
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +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"}

package/dist/esm/utils/cuid.js

@@ -0,0 +1,145 @@
+/**
+ * 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
+ */
+// Character set for base36 encoding (0-9, a-z)
+const ALPHABET = '0123456789abcdefghijklmnopqrstuvwxyz';
+// Default length for generated IDs
+const DEFAULT_LENGTH = 24;
+// Counter for additional entropy
+let counter = 0;
+/**
+ * Get cryptographically secure random bytes.
+ * Uses Web Crypto API (works in Node.js 18+ and modern browsers).
+ */
+function getRandomBytes(length) {
+    const bytes = new Uint8Array(length);
+    // Use globalThis.crypto for cross-platform compatibility
+    const cryptoObj = typeof globalThis !== 'undefined'
+        ? globalThis.crypto
+        : undefined;
+    if (cryptoObj?.getRandomValues) {
+        cryptoObj.getRandomValues(bytes);
+    }
+    else {
+        // Fallback for older environments (should not happen with Node 18+)
+        for (let i = 0; i < length; i++) {
+            bytes[i] = Math.floor(Math.random() * 256);
+        }
+    }
+    return bytes;
+}
+/**
+ * Convert a byte array to a base36 string.
+ */
+function toBase36(bytes) {
+    let result = '';
+    for (const byte of bytes) {
+        result += ALPHABET[byte % 36];
+    }
+    return result;
+}
+/**
+ * Get a timestamp component for the ID.
+ * Uses high-resolution time when available.
+ */
+function getTimestamp() {
+    const now = Date.now();
+    return now.toString(36);
+}
+/**
+ * Get counter component to ensure uniqueness within same millisecond.
+ */
+function getCounter() {
+    counter = (counter + 1) % 1679616; // Max 4 base36 chars
+    return counter.toString(36).padStart(4, '0');
+}
+/**
+ * Generate a fingerprint based on environment.
+ * In browsers, uses navigator info. In Node.js, uses process info.
+ */
+function getFingerprint() {
+    const parts = [];
+    // Node.js environment - use globalThis for cross-platform compatibility
+    const processObj = typeof globalThis !== 'undefined'
+        ? globalThis.process
+        : undefined;
+    const navigatorObj = typeof globalThis !== 'undefined'
+        ? globalThis.navigator
+        : undefined;
+    if (processObj?.pid) {
+        parts.push(processObj.pid.toString(36));
+        const hrtime = processObj.hrtime?.();
+        if (hrtime) {
+            parts.push((hrtime[1] ?? 0).toString(36));
+        }
+    }
+    // Browser environment
+    if (navigatorObj) {
+        parts.push((navigatorObj.userAgent?.length ?? 0).toString(36));
+        parts.push((navigatorObj.language?.length ?? 0).toString(36));
+    }
+    // Fallback random
+    if (parts.length === 0) {
+        const random = getRandomBytes(4);
+        parts.push(toBase36(random));
+    }
+    return parts.join('').slice(0, 4);
+}
+/**
+ * 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 function createId(length = DEFAULT_LENGTH) {
+    const timestamp = getTimestamp();
+    const count = getCounter();
+    const fingerprint = getFingerprint();
+    // Calculate random bytes needed
+    const fixedLength = timestamp.length + count.length + fingerprint.length;
+    const randomLength = Math.max(0, length - fixedLength);
+    // Generate random component
+    const randomBytes = getRandomBytes(randomLength);
+    const random = toBase36(randomBytes);
+    // Combine components
+    const id = (random + timestamp + count + fingerprint).slice(0, length);
+    return id;
+}
+/**
+ * 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 function createSpecimenId() {
+    return `wemush:${createId()}`;
+}
+/**
+ * Validate a specimen ID format.
+ *
+ * @param id - The ID to validate
+ * @returns true if the ID matches the expected format
+ */
+export function isValidSpecimenId(id) {
+    return /^wemush:[a-z0-9]+$/.test(id);
+}
+//# sourceMappingURL=cuid.js.map

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

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

package/dist/esm/utils/iso8601.js

@@ -0,0 +1,122 @@
+/**
+ * ISO 8601 Date Utilities
+ *
+ * Provides parsing and formatting for ISO 8601 date strings
+ * as used in WOLS specimens.
+ *
+ * @module utils/iso8601
+ */
+/**
+ * Regular expression for validating ISO 8601 date strings.
+ * Matches formats like:
+ * - 2025-12-16T10:30:00Z
+ * - 2025-12-16T10:30:00.000Z
+ * - 2025-12-16T10:30:00+00:00
+ * - 2025-12-16T10:30:00-05:00
+ */
+const ISO8601_REGEX = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?(?:Z|[+-]\d{2}:\d{2})$/;
+/**
+ * Simple date-only regex for partial dates
+ */
+const DATE_ONLY_REGEX = /^\d{4}-\d{2}-\d{2}$/;
+/**
+ * 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 function isValidISO8601(value) {
+    if (!ISO8601_REGEX.test(value)) {
+        return false;
+    }
+    // Also verify it's a parseable date
+    const date = new Date(value);
+    return !isNaN(date.getTime());
+}
+/**
+ * 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 function isValidDateOnly(value) {
+    if (!DATE_ONLY_REGEX.test(value)) {
+        return false;
+    }
+    const date = new Date(value + 'T00:00:00Z');
+    return !isNaN(date.getTime());
+}
+/**
+ * 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 function getCurrentISO8601() {
+    return new Date().toISOString();
+}
+/**
+ * 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 function parseISO8601(value) {
+    if (!isValidISO8601(value)) {
+        return null;
+    }
+    return new Date(value);
+}
+/**
+ * Format a Date object to ISO 8601 string.
+ *
+ * @param date - The Date to format
+ * @returns ISO 8601 string
+ */
+export function formatISO8601(date) {
+    return date.toISOString();
+}
+/**
+ * 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 function toUnixTimestamp(value) {
+    const date = parseISO8601(value);
+    if (!date) {
+        return null;
+    }
+    return Math.floor(date.getTime() / 1000);
+}
+/**
+ * Convert Unix timestamp to ISO 8601 string.
+ *
+ * @param timestamp - Unix timestamp in seconds
+ * @returns ISO 8601 string
+ */
+export function fromUnixTimestamp(timestamp) {
+    return new Date(timestamp * 1000).toISOString();
+}
+//# sourceMappingURL=iso8601.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iso8601.js","sourceRoot":"","sources":["../../../src/utils/iso8601.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,MAAM,aAAa,GAAG,0EAA0E,CAAC;AAEjG;;GAEG;AACH,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAE9C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oCAAoC;IACpC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,CAAC;IAC5C,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AAClD,CAAC"}