@glion/util-semver 0.14.1

package/dist/range.d.ts

@@ -0,0 +1,73 @@
+import type { Comparator } from "./types";
+/**
+ * Pre-parsed range expression for efficient reuse.
+ *
+ * Parse a range once and reuse it for multiple version checks,
+ * avoiding repeated parsing overhead.
+ *
+ * @example
+ *   ```typescript
+ *   // Parse once
+ *   const range = new Range(">=2.0 <3.0");
+ *
+ *   // Reuse many times (much faster than re-parsing)
+ *   satisfies("2.5.1", range); // => true
+ *   satisfies("2.3.0", range); // => true
+ *   satisfies("3.0.0", range); // => false
+ *   ```;
+ */
+export declare class Range {
+    readonly comparators: readonly Comparator[];
+    readonly raw: string;
+    constructor(range: string);
+    /**
+     * Test if a version satisfies this range.
+     *
+     * @param version - Version string to test
+     * @returns True if version satisfies all comparators
+     * @throws {VersionParseError} If version string is invalid
+     */
+    test(version: string): boolean;
+}
+/**
+ * Checks if a version satisfies a range expression.
+ *
+ * Range expressions consist of one or more space-separated comparators.
+ * Each comparator is an optional operator followed by a version.
+ *
+ * Supported operators:
+ *
+ * - `=` (or no operator): exact match
+ * - `<`: less than
+ * - `<=`: less than or equal
+ * - `>`: greater than
+ * - `>=`: greater than or equal
+ *
+ * Multiple comparators create AND conditions - all must be satisfied.
+ *
+ * For performance when checking many versions against the same range,
+ * use a Range object instead of a string.
+ *
+ * @example
+ *   ```typescript
+ *   // String range (parsed every call)
+ *   satisfies("2.5.1", ">=2.0 <3.0"); // => true
+ *   satisfies("2.5.1", "2.5.1"); // => true (exact match)
+ *   satisfies("2.5.1", ">=2.6"); // => false
+ *
+ *   // Range object (parse once, reuse many times - much faster)
+ *   const range = new Range(">=2.0 <3.0");
+ *   satisfies("2.5.1", range); // => true
+ *   satisfies("2.3.0", range); // => true
+ *   satisfies("3.0.0", range); // => false
+ *   ```;
+ *
+ * @param version - Version string to test
+ * @param range - Range expression string or pre-parsed Range object
+ * @returns True if version satisfies all comparators, false for empty range
+ * @throws {VersionParseError} If version string is invalid
+ * @throws {RangeParseError} If range expression is invalid or exceeds length
+ *   limit
+ */
+export declare function satisfies(version: string, range: string | Range): boolean;
+//# sourceMappingURL=range.d.ts.map

package/dist/range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../src/range.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAqD1C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,KAAK,EAAE,MAAM;IAczB;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAc/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAGzE"}

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Represents a semantic version with major, minor, and patch components.
+ */
+export interface Hl7Version {
+    major: number;
+    minor: number;
+    patch: number;
+}
+/**
+ * Comparison operators supported in version ranges.
+ */
+export type ComparisonOperator = "=" | "<" | "<=" | ">" | ">=";
+/**
+ * Internal representation of a version range comparator.
+ */
+export interface Comparator {
+    op: ComparisonOperator;
+    v: Hl7Version;
+}
+/**
+ * Result of a comparison operation.
+ */
+export type ComparisonResult = -1 | 0 | 1;
+/**
+ * Security constraints for input validation.
+ */
+export declare const MAX_VERSION_STRING_LENGTH = 100;
+export declare const MAX_RANGE_STRING_LENGTH = 1000;
+export declare const MAX_SAFE_VERSION_COMPONENT: number;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,kBAAkB,CAAC;IACvB,CAAC,EAAE,UAAU,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,0BAA0B,QAAc,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@glion/util-semver",
+  "version": "0.14.1",
+  "description": "Tiny, fast HL7v2 version and range utilities (basic comparators only)",
+  "keywords": [
+    "health",
+    "healthcare",
+    "hl7",
+    "hl7v2",
+    "nodejs",
+    "typescript"
+  ],
+  "homepage": "https://glion.dev",
+  "license": "MIT",
+  "author": {
+    "name": "Melek Somai",
+    "email": "melek@rethinkhealth.io"
+  },
+  "repository": "rethinkhealth/glion.git",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@vitest/coverage-v8": "4.1.2",
+    "tsdown": "0.21.7",
+    "typescript": "^5.9.3",
+    "vitest": "4.1.2",
+    "@glion/testing": "0.0.2",
+    "@glion/tsconfig": "0.0.1"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsdown && tsc --emitDeclarationOnly",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest"
+  }
+}