@wemush/wols 0.1.0

package/dist/cjs/errors.js

@@ -0,0 +1,188 @@
+"use strict";
+/**
+ * WOLS Error Types
+ *
+ * This module defines all error classes and error codes
+ * used by the WOLS TypeScript library.
+ *
+ * @module errors
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WolsEncryptionError = exports.WolsValidationError = exports.WolsParseError = exports.WolsError = exports.WolsErrorCode = void 0;
+exports.requiredFieldError = requiredFieldError;
+exports.invalidFormatError = invalidFormatError;
+exports.parseErrorFromException = parseErrorFromException;
+// =============================================================================
+// ERROR CODES
+// =============================================================================
+/**
+ * WOLS error codes (stable, for programmatic handling).
+ */
+var WolsErrorCode;
+(function (WolsErrorCode) {
+    /** General parse error */
+    WolsErrorCode["PARSE_ERROR"] = "WOLS_PARSE_ERROR";
+    /** Invalid JSON syntax */
+    WolsErrorCode["INVALID_JSON"] = "WOLS_INVALID_JSON";
+    /** Not a valid WOLS format */
+    WolsErrorCode["INVALID_FORMAT"] = "WOLS_INVALID_FORMAT";
+    /** Missing or invalid @context field */
+    WolsErrorCode["INVALID_CONTEXT"] = "WOLS_INVALID_CONTEXT";
+    /** Missing or invalid @type field */
+    WolsErrorCode["INVALID_TYPE"] = "WOLS_INVALID_TYPE";
+    /** ID doesn't match wemush:[a-z0-9]+ pattern */
+    WolsErrorCode["INVALID_ID_FORMAT"] = "WOLS_INVALID_ID_FORMAT";
+    /** Version not valid semver */
+    WolsErrorCode["INVALID_VERSION"] = "WOLS_INVALID_VERSION";
+    /** Type not in SpecimenType enum */
+    WolsErrorCode["INVALID_SPECIMEN_TYPE"] = "WOLS_INVALID_SPECIMEN_TYPE";
+    /** Required field is missing */
+    WolsErrorCode["REQUIRED_FIELD"] = "WOLS_REQUIRED_FIELD";
+    /** Date not in ISO 8601 format */
+    WolsErrorCode["INVALID_DATE_FORMAT"] = "WOLS_INVALID_DATE_FORMAT";
+    /** Strain generation format is invalid */
+    WolsErrorCode["INVALID_GENERATION"] = "WOLS_INVALID_GENERATION";
+    /** Invalid compact URL format */
+    WolsErrorCode["INVALID_URL"] = "WOLS_INVALID_URL";
+    /** Encryption operation failed */
+    WolsErrorCode["ENCRYPTION_ERROR"] = "WOLS_ENCRYPTION_ERROR";
+    /** Decryption operation failed */
+    WolsErrorCode["DECRYPTION_ERROR"] = "WOLS_DECRYPTION_ERROR";
+    /** Invalid encryption key */
+    WolsErrorCode["INVALID_KEY"] = "WOLS_INVALID_KEY";
+    /** Payload exceeds QR code capacity */
+    WolsErrorCode["SIZE_EXCEEDED"] = "WOLS_SIZE_EXCEEDED";
+    /** Unknown or unspecified error */
+    WolsErrorCode["UNKNOWN_ERROR"] = "WOLS_UNKNOWN_ERROR";
+})(WolsErrorCode || (exports.WolsErrorCode = WolsErrorCode = {}));
+// =============================================================================
+// ERROR CLASSES
+// =============================================================================
+/**
+ * Base WOLS error class.
+ * All WOLS-specific errors extend this class.
+ */
+class WolsError extends Error {
+    /** Error code for programmatic handling */
+    code;
+    /** Additional error details */
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'WolsError';
+        this.code = code;
+        this.details = details ?? undefined;
+        // Maintains proper stack trace for where error was thrown (V8 engines)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, WolsError);
+        }
+    }
+    /**
+     * Convert error to JSON for serialization.
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            details: this.details,
+        };
+    }
+}
+exports.WolsError = WolsError;
+/**
+ * Parse error (JSON/format issues).
+ * Thrown when parsing JSON or WOLS data fails.
+ */
+class WolsParseError extends WolsError {
+    /** Character position in the input where error occurred */
+    position;
+    constructor(code, message, details) {
+        super(code, message, details);
+        this.name = 'WolsParseError';
+        this.position = details?.position ?? undefined;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, WolsParseError);
+        }
+    }
+}
+exports.WolsParseError = WolsParseError;
+/**
+ * Validation error (schema violations).
+ * Thrown when specimen data fails validation.
+ */
+class WolsValidationError extends WolsError {
+    /** Array of validation errors */
+    errors;
+    constructor(message, errors) {
+        super(WolsErrorCode.INVALID_FORMAT, message, { errors });
+        this.name = 'WolsValidationError';
+        this.errors = errors;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, WolsValidationError);
+        }
+    }
+}
+exports.WolsValidationError = WolsValidationError;
+/**
+ * Encryption/decryption error.
+ * Thrown when crypto operations fail.
+ */
+class WolsEncryptionError extends WolsError {
+    constructor(code, message, details) {
+        super(code, message, details);
+        this.name = 'WolsEncryptionError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, WolsEncryptionError);
+        }
+    }
+}
+exports.WolsEncryptionError = WolsEncryptionError;
+// =============================================================================
+// ERROR FACTORY FUNCTIONS
+// =============================================================================
+/**
+ * Create a required field error.
+ */
+function requiredFieldError(field, path = field) {
+    return new WolsValidationError(`Required field '${field}' is missing`, [
+        {
+            path,
+            code: WolsErrorCode.REQUIRED_FIELD,
+            message: `Field '${field}' is required`,
+        },
+    ]);
+}
+/**
+ * Create an invalid format error.
+ */
+function invalidFormatError(field, expected, path = field) {
+    return new WolsValidationError(`Invalid format for '${field}': expected ${expected}`, [
+        {
+            path,
+            code: WolsErrorCode.INVALID_FORMAT,
+            message: `Expected ${expected}`,
+        },
+    ]);
+}
+/**
+ * Create a parse error from a caught exception.
+ */
+function parseErrorFromException(error, _input) {
+    if (error instanceof SyntaxError) {
+        // Extract position from JSON.parse error message
+        const match = /position (\d+)/i.exec(error.message);
+        const position = match?.[1] ? parseInt(match[1], 10) : undefined;
+        const details = { originalError: error.message };
+        if (position !== undefined) {
+            details['position'] = position;
+        }
+        return new WolsParseError(WolsErrorCode.INVALID_JSON, error.message, details);
+    }
+    if (error instanceof WolsParseError) {
+        return error;
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return new WolsParseError(WolsErrorCode.PARSE_ERROR, message);
+}
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAuJH,gDAQC;AAKD,gDAYC;AAKD,0DAoBC;AArMD,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;GAEG;AACH,IAAY,aAmCX;AAnCD,WAAY,aAAa;IACvB,0BAA0B;IAC1B,iDAAgC,CAAA;IAChC,0BAA0B;IAC1B,mDAAkC,CAAA;IAClC,8BAA8B;IAC9B,uDAAsC,CAAA;IACtC,wCAAwC;IACxC,yDAAwC,CAAA;IACxC,qCAAqC;IACrC,mDAAkC,CAAA;IAClC,gDAAgD;IAChD,6DAA4C,CAAA;IAC5C,+BAA+B;IAC/B,yDAAwC,CAAA;IACxC,oCAAoC;IACpC,qEAAoD,CAAA;IACpD,gCAAgC;IAChC,uDAAsC,CAAA;IACtC,kCAAkC;IAClC,iEAAgD,CAAA;IAChD,0CAA0C;IAC1C,+DAA8C,CAAA;IAC9C,iCAAiC;IACjC,iDAAgC,CAAA;IAChC,kCAAkC;IAClC,2DAA0C,CAAA;IAC1C,kCAAkC;IAClC,2DAA0C,CAAA;IAC1C,6BAA6B;IAC7B,iDAAgC,CAAA;IAChC,uCAAuC;IACvC,qDAAoC,CAAA;IACpC,mCAAmC;IACnC,qDAAoC,CAAA;AACtC,CAAC,EAnCW,aAAa,6BAAb,aAAa,QAmCxB;AAED,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;;GAGG;AACH,MAAa,SAAU,SAAQ,KAAK;IAClC,2CAA2C;IAClC,IAAI,CAAgB;IAC7B,+BAA+B;IACtB,OAAO,CAAsC;IAEtD,YAAY,IAAmB,EAAE,OAAe,EAAE,OAAiC;QACjF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,SAAS,CAAC;QAEpC,uEAAuE;QACvE,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AA7BD,8BA6BC;AAED;;;GAGG;AACH,MAAa,cAAe,SAAQ,SAAS;IAC3C,2DAA2D;IAClD,QAAQ,CAAqB;IAEtC,YACE,IAAmB,EACnB,OAAe,EACf,OAAyD;QAEzD,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,SAAS,CAAC;QAE/C,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF;AAjBD,wCAiBC;AAED;;;GAGG;AACH,MAAa,mBAAoB,SAAQ,SAAS;IAChD,iCAAiC;IACxB,MAAM,CAAoB;IAEnC,YAAY,OAAe,EAAE,MAAyB;QACpD,KAAK,CAAC,aAAa,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;CACF;AAbD,kDAaC;AAED;;;GAGG;AACH,MAAa,mBAAoB,SAAQ,SAAS;IAChD,YAAY,IAAmB,EAAE,OAAe,EAAE,OAAiC;QACjF,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAElC,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;CACF;AATD,kDASC;AAED,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;GAEG;AACH,SAAgB,kBAAkB,CAAC,KAAa,EAAE,OAAe,KAAK;IACpE,OAAO,IAAI,mBAAmB,CAAC,mBAAmB,KAAK,cAAc,EAAE;QACrE;YACE,IAAI;YACJ,IAAI,EAAE,aAAa,CAAC,cAAc;YAClC,OAAO,EAAE,UAAU,KAAK,eAAe;SACxC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAChC,KAAa,EACb,QAAgB,EAChB,OAAe,KAAK;IAEpB,OAAO,IAAI,mBAAmB,CAAC,uBAAuB,KAAK,eAAe,QAAQ,EAAE,EAAE;QACpF;YACE,IAAI;YACJ,IAAI,EAAE,aAAa,CAAC,cAAc;YAClC,OAAO,EAAE,YAAY,QAAQ,EAAE;SAChC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CAAC,KAAc,EAAE,MAAe;IACrE,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,iDAAiD;QACjD,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEjE,MAAM,OAAO,GAA4B,EAAE,aAAa,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC1E,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC;QACjC,CAAC;QAED,OAAO,IAAI,cAAc,CAAC,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,IAAI,cAAc,CAAC,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isQRAvailableSync = exports.isQRAvailable = exports.toQRCodeSVG = exports.toQRCodeDataURL = exports.toQRCode = exports.decryptSpecimen = exports.isEncrypted = exports.encryptSpecimen = exports.registerSpeciesCode = exports.getCodeFromSpecies = exports.getSpeciesFromCode = exports.SPECIES_CODES = exports.parseCompactUrl = exports.toCompactUrl = exports.parseSpecimen = exports.validateSpecimen = exports.serializeSpecimen = exports.createSpecimen = exports.WolsEncryptionError = exports.WolsValidationError = exports.WolsParseError = exports.WolsError = exports.WolsErrorCode = exports.GROWTH_STAGES = exports.SPECIMEN_TYPES = exports.isStrain = exports.isGrowthStage = exports.isSpecimenType = exports.asSpecimenId = exports.WOLS_CONTEXT = exports.WOLS_VERSION = void 0;
+// =============================================================================
+// Constants
+// =============================================================================
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "WOLS_VERSION", { enumerable: true, get: function () { return types_js_1.WOLS_VERSION; } });
+Object.defineProperty(exports, "WOLS_CONTEXT", { enumerable: true, get: function () { return types_js_1.WOLS_CONTEXT; } });
+// =============================================================================
+// Type utilities
+// =============================================================================
+var types_js_2 = require("./types.js");
+Object.defineProperty(exports, "asSpecimenId", { enumerable: true, get: function () { return types_js_2.asSpecimenId; } });
+Object.defineProperty(exports, "isSpecimenType", { enumerable: true, get: function () { return types_js_2.isSpecimenType; } });
+Object.defineProperty(exports, "isGrowthStage", { enumerable: true, get: function () { return types_js_2.isGrowthStage; } });
+Object.defineProperty(exports, "isStrain", { enumerable: true, get: function () { return types_js_2.isStrain; } });
+Object.defineProperty(exports, "SPECIMEN_TYPES", { enumerable: true, get: function () { return types_js_2.SPECIMEN_TYPES; } });
+Object.defineProperty(exports, "GROWTH_STAGES", { enumerable: true, get: function () { return types_js_2.GROWTH_STAGES; } });
+// =============================================================================
+// Errors
+// =============================================================================
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "WolsErrorCode", { enumerable: true, get: function () { return errors_js_1.WolsErrorCode; } });
+Object.defineProperty(exports, "WolsError", { enumerable: true, get: function () { return errors_js_1.WolsError; } });
+Object.defineProperty(exports, "WolsParseError", { enumerable: true, get: function () { return errors_js_1.WolsParseError; } });
+Object.defineProperty(exports, "WolsValidationError", { enumerable: true, get: function () { return errors_js_1.WolsValidationError; } });
+Object.defineProperty(exports, "WolsEncryptionError", { enumerable: true, get: function () { return errors_js_1.WolsEncryptionError; } });
+// =============================================================================
+// Core Functions - Specimen
+// =============================================================================
+var specimen_js_1 = require("./specimen.js");
+Object.defineProperty(exports, "createSpecimen", { enumerable: true, get: function () { return specimen_js_1.createSpecimen; } });
+Object.defineProperty(exports, "serializeSpecimen", { enumerable: true, get: function () { return specimen_js_1.serializeSpecimen; } });
+// =============================================================================
+// Core Functions - Validation
+// =============================================================================
+var validator_js_1 = require("./validator.js");
+Object.defineProperty(exports, "validateSpecimen", { enumerable: true, get: function () { return validator_js_1.validateSpecimen; } });
+// =============================================================================
+// Core Functions - Parser
+// =============================================================================
+var parser_js_1 = require("./parser.js");
+Object.defineProperty(exports, "parseSpecimen", { enumerable: true, get: function () { return parser_js_1.parseSpecimen; } });
+// =============================================================================
+// Core Functions - Compact URL
+// =============================================================================
+var compact_url_js_1 = require("./compact-url.js");
+Object.defineProperty(exports, "toCompactUrl", { enumerable: true, get: function () { return compact_url_js_1.toCompactUrl; } });
+Object.defineProperty(exports, "parseCompactUrl", { enumerable: true, get: function () { return compact_url_js_1.parseCompactUrl; } });
+Object.defineProperty(exports, "SPECIES_CODES", { enumerable: true, get: function () { return compact_url_js_1.SPECIES_CODES; } });
+Object.defineProperty(exports, "getSpeciesFromCode", { enumerable: true, get: function () { return compact_url_js_1.getSpeciesFromCode; } });
+Object.defineProperty(exports, "getCodeFromSpecies", { enumerable: true, get: function () { return compact_url_js_1.getCodeFromSpecies; } });
+Object.defineProperty(exports, "registerSpeciesCode", { enumerable: true, get: function () { return compact_url_js_1.registerSpeciesCode; } });
+// =============================================================================
+// Core Functions - Encryption
+// =============================================================================
+var index_js_1 = require("./crypto/index.js");
+Object.defineProperty(exports, "encryptSpecimen", { enumerable: true, get: function () { return index_js_1.encryptSpecimen; } });
+Object.defineProperty(exports, "isEncrypted", { enumerable: true, get: function () { return index_js_1.isEncrypted; } });
+Object.defineProperty(exports, "decryptSpecimen", { enumerable: true, get: function () { return index_js_1.decryptSpecimen; } });
+// =============================================================================
+// Core Functions - QR Code Generation
+// =============================================================================
+var index_js_2 = require("./qr/index.js");
+Object.defineProperty(exports, "toQRCode", { enumerable: true, get: function () { return index_js_2.toQRCode; } });
+Object.defineProperty(exports, "toQRCodeDataURL", { enumerable: true, get: function () { return index_js_2.toQRCodeDataURL; } });
+Object.defineProperty(exports, "toQRCodeSVG", { enumerable: true, get: function () { return index_js_2.toQRCodeSVG; } });
+Object.defineProperty(exports, "isQRAvailable", { enumerable: true, get: function () { return index_js_2.isQRAvailable; } });
+Object.defineProperty(exports, "isQRAvailableSync", { enumerable: true, get: function () { return index_js_2.isQRAvailableSync; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAChF,uCAAwD;AAA/C,wGAAA,YAAY,OAAA;AAAE,wGAAA,YAAY,OAAA;AAoCnC,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAChF,uCAOoB;AANlB,wGAAA,YAAY,OAAA;AACZ,0GAAA,cAAc,OAAA;AACd,yGAAA,aAAa,OAAA;AACb,oGAAA,QAAQ,OAAA;AACR,0GAAA,cAAc,OAAA;AACd,yGAAA,aAAa,OAAA;AAGf,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAChF,yCAMqB;AALnB,0GAAA,aAAa,OAAA;AACb,sGAAA,SAAS,OAAA;AACT,2GAAA,cAAc,OAAA;AACd,gHAAA,mBAAmB,OAAA;AACnB,gHAAA,mBAAmB,OAAA;AAGrB,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAChF,6CAAkE;AAAzD,6GAAA,cAAc,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAE1C,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAChF,+CAAkD;AAAzC,gHAAA,gBAAgB,OAAA;AAEzB,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAChF,yCAA4C;AAAnC,0GAAA,aAAa,OAAA;AAEtB,gFAAgF;AAChF,+BAA+B;AAC/B,gFAAgF;AAChF,mDAO0B;AANxB,8GAAA,YAAY,OAAA;AACZ,iHAAA,eAAe,OAAA;AACf,+GAAA,aAAa,OAAA;AACb,oHAAA,kBAAkB,OAAA;AAClB,oHAAA,kBAAkB,OAAA;AAClB,qHAAA,mBAAmB,OAAA;AAGrB,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAChF,8CAAkF;AAAzE,2GAAA,eAAe,OAAA;AAAE,uGAAA,WAAW,OAAA;AAAE,2GAAA,eAAe,OAAA;AAEtD,gFAAgF;AAChF,sCAAsC;AACtC,gFAAgF;AAChF,0CAMuB;AALrB,oGAAA,QAAQ,OAAA;AACR,2GAAA,eAAe,OAAA;AACf,uGAAA,WAAW,OAAA;AACX,yGAAA,aAAa,OAAA;AACb,6GAAA,iBAAiB,OAAA"}

package/dist/cjs/parser.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * WOLS Specimen Parser
+ *
+ * This module provides parsing functionality for WOLS specimen JSON.
+ *
+ * @module parser
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSpecimen = parseSpecimen;
+const errors_js_1 = require("./errors.js");
+const types_js_1 = require("./types.js");
+const validator_js_1 = require("./validator.js");
+// =============================================================================
+// HELPER FUNCTIONS
+// =============================================================================
+/**
+ * Check if a value is a plain object.
+ */
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Get the first validation error code from a ValidationResult.
+ */
+function getFirstErrorCode(errors) {
+    if (errors.length === 0) {
+        return errors_js_1.WolsErrorCode.INVALID_FORMAT;
+    }
+    const firstError = errors[0];
+    if (!firstError) {
+        return errors_js_1.WolsErrorCode.INVALID_FORMAT;
+    }
+    const code = firstError.code;
+    // Map string codes to WolsErrorCode enum
+    if (Object.values(errors_js_1.WolsErrorCode).includes(code)) {
+        return code;
+    }
+    return errors_js_1.WolsErrorCode.INVALID_FORMAT;
+}
+// =============================================================================
+// MAIN PARSE FUNCTION
+// =============================================================================
+/**
+ * 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);
+ * }
+ * ```
+ */
+function parseSpecimen(json) {
+    // Step 1: Parse JSON
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: (0, errors_js_1.parseErrorFromException)(err, json),
+        };
+    }
+    // Step 2: Verify it's an object
+    if (!isPlainObject(parsed)) {
+        return {
+            success: false,
+            error: new errors_js_1.WolsParseError(errors_js_1.WolsErrorCode.INVALID_FORMAT, 'Specimen must be a JSON object', {
+                receivedType: parsed === null ? 'null' : typeof parsed,
+            }),
+        };
+    }
+    // Step 3: Validate against WOLS schema
+    const validation = (0, validator_js_1.validateSpecimen)(parsed);
+    if (!validation.valid) {
+        // Get the most specific error code
+        const errorCode = getFirstErrorCode(validation.errors);
+        const firstError = validation.errors[0];
+        // Create appropriate error
+        const errorMessage = validation.errors.map(e => `${e.path}: ${e.message}`).join('; ');
+        if (validation.errors.length === 1 && firstError) {
+            return {
+                success: false,
+                error: new errors_js_1.WolsParseError(errorCode, firstError.message, {
+                    path: firstError.path,
+                }),
+            };
+        }
+        return {
+            success: false,
+            error: new errors_js_1.WolsValidationError(`Validation failed: ${errorMessage}`, validation.errors),
+        };
+    }
+    // Step 4: Cast to Specimen type (validation guarantees the shape)
+    const data = parsed;
+    const specimen = {
+        '@context': types_js_1.WOLS_CONTEXT,
+        '@type': 'Specimen',
+        id: (0, types_js_1.asSpecimenId)(data['id']),
+        version: data['version'],
+        type: data['type'],
+        species: data['species'],
+    };
+    // Copy optional fields if present
+    const strainValue = data['strain'];
+    if (strainValue !== undefined && strainValue !== null) {
+        specimen.strain = strainValue;
+    }
+    const stageValue = data['stage'];
+    if (stageValue !== undefined && stageValue !== null) {
+        specimen.stage = stageValue;
+    }
+    if (data['created'] !== undefined) {
+        specimen.created = data['created'];
+    }
+    if (data['batch'] !== undefined) {
+        specimen.batch = data['batch'];
+    }
+    if (data['organization'] !== undefined) {
+        specimen.organization = data['organization'];
+    }
+    if (data['creator'] !== undefined) {
+        specimen.creator = data['creator'];
+    }
+    if (data['custom'] !== undefined) {
+        specimen.custom = data['custom'];
+    }
+    if (data['signature'] !== undefined) {
+        specimen.signature = data['signature'];
+    }
+    return {
+        success: true,
+        data: specimen,
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/cjs/parser.js.map

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