@apps-in-toss/native-modules 0.0.0-dev.1752049503789 → 1.0.0

package/src/utils/compareVersion.spec.ts

@@ -0,0 +1,176 @@
+import { describe, it, expect } from 'vitest';
+import { compareVersions } from './compareVersion.js';
+
+describe('compareVersions', () => {
+  it('기본 버전 비교가 올바르게 작동해야 합니다', () => {
+    expect(compareVersions('1.0.0', '1.0.0')).toBe(0);
+    expect(compareVersions('1.0.0', '1.0.1')).toBe(-1);
+    expect(compareVersions('1.0.1', '1.0.0')).toBe(1);
+    expect(compareVersions('1.1.0', '1.0.0')).toBe(1);
+    expect(compareVersions('2.0.0', '1.0.0')).toBe(1);
+  });
+
+  it('다양한 길이의 버전을 비교할 수 있어야 합니다', () => {
+    expect(compareVersions('1', '1.0.0')).toBe(0);
+    expect(compareVersions('1.0', '1.0.0')).toBe(0);
+    expect(compareVersions('1', '2')).toBe(-1);
+    expect(compareVersions('1.0', '1.1')).toBe(-1);
+    expect(compareVersions('1.1', '1.0.1')).toBe(1);
+    expect(compareVersions('11.1.10', '11.0')).toBe(1);
+    expect(compareVersions('1.1.1', '1')).toBe(1);
+    expect(compareVersions('01.1.0', '1.01')).toBe(0);
+    expect(compareVersions('10.0.0', '10.114')).toBe(-1);
+    expect(compareVersions('1.0', '1.4.1')).toBe(-1);
+  });
+
+  it('와일드카드 버전을 올바르게 처리해야 합니다', () => {
+    expect(compareVersions('1.x', '1.0.0')).toBe(0);
+    expect(compareVersions('1.*', '1.1.0')).toBe(0);
+    expect(compareVersions('1.0.X', '1.0.1')).toBe(0);
+    expect(compareVersions('3', '3.x.x')).toBe(0);
+    expect(compareVersions('3.3', '3.x.x')).toBe(0);
+    expect(compareVersions('3.3.3', '3.x.x')).toBe(0);
+    expect(compareVersions('3.x.x', '3.3.3')).toBe(0);
+    expect(compareVersions('3.3.3', '3.X.X')).toBe(0);
+    expect(compareVersions('3.3.3', '3.3.x')).toBe(0);
+    expect(compareVersions('3.3.3', '3.*.*')).toBe(0);
+    expect(compareVersions('3.3.3', '3.3.*')).toBe(0);
+    expect(compareVersions('3.0.3', '3.0.*')).toBe(0);
+    expect(compareVersions('0.7.x', '0.6.0')).toBe(1);
+    expect(compareVersions('0.7.x', '0.6.0-asdf')).toBe(1);
+    expect(compareVersions('0.7.x', '0.6.2')).toBe(1);
+    expect(compareVersions('0.7.x', '0.7.0-asdf')).toBe(1);
+    expect(compareVersions('1.2.*', '1.1.3')).toBe(1);
+    expect(compareVersions('1.2.*', '1.1.9999')).toBe(1);
+    expect(compareVersions('1.2.x', '1.0.0')).toBe(1);
+    expect(compareVersions('1.2.x', '1.1.0')).toBe(1);
+    expect(compareVersions('1.2.x', '1.1.3')).toBe(1);
+    expect(compareVersions('2.*.*', '1.0.1')).toBe(1);
+    expect(compareVersions('2.*.*', '1.1.3')).toBe(1);
+    expect(compareVersions('2.x.x', '1.0.0')).toBe(1);
+    expect(compareVersions('2.x.x', '1.1.3')).toBe(1);
+  });
+
+  it('프리릴리스 버전을 올바르게 비교해야 합니다', () => {
+    expect(compareVersions('1.0.0-alpha', '1.0.0')).toBe(-1);
+    expect(compareVersions('1.0.0', '1.0.0-alpha')).toBe(1);
+    expect(compareVersions('1.0.0-alpha', '1.0.0-beta')).toBe(-1);
+    expect(compareVersions('1.0.0-beta.2', '1.0.0-beta.1')).toBe(1);
+    expect(compareVersions('1.0.0-alpha.1', '1.0.0-alpha')).toBe(1);
+    expect(compareVersions('1.0.0-alpha', '1.0.0-alpha.1')).toBe(-1);
+    expect(compareVersions('1.0.0-alpha.1', '1.0.0-alpha.beta')).toBe(-1);
+    expect(compareVersions('1.0.0-alpha.beta', '1.0.0-beta')).toBe(-1);
+    expect(compareVersions('1.0.0-beta', '1.0.0-beta.2')).toBe(-1);
+    expect(compareVersions('1.0.0-beta.2', '1.0.0-beta.11')).toBe(-1);
+    expect(compareVersions('1.0.0-beta.11', '1.0.0-rc.1')).toBe(-1);
+    expect(compareVersions('1.0.0-rc.1', '1.0.0')).toBe(-1);
+    expect(compareVersions('1.0.0-alpha', '1')).toBe(-1);
+    expect(compareVersions('1.0.0-beta.11', '1.0.0-beta.1')).toBe(1);
+    expect(compareVersions('1.0.0-beta.10', '1.0.0-beta.9')).toBe(1);
+    expect(compareVersions('1.0.0-beta.10', '1.0.0-beta.90')).toBe(-1);
+    expect(compareVersions('0.6.1-1', '0.6.1-0')).toBe(1);
+    expect(compareVersions('v0.5.4-pre', '0.5.4-alpha')).toBe(1);
+  });
+
+  it('접두사가 있는 버전을 올바르게 처리해야 합니다', () => {
+    expect(compareVersions('v1.0.0', '1.0.0')).toBe(0);
+    expect(compareVersions('^1.0.0', '1.0.0')).toBe(0);
+    expect(compareVersions('~1.0.0', '1.0.0')).toBe(0);
+    expect(compareVersions('v1.0.0', 'v1.0.0')).toBe(0);
+    expect(compareVersions('v1.0.0-alpha', '1.0.0-alpha')).toBe(0);
+    expect(compareVersions('v3.2.1', 'v2.3.2')).toBe(1);
+  });
+
+  it('선행 0을 무시해야 합니다', () => {
+    expect(compareVersions('01.0.0', '1')).toBe(0);
+    expect(compareVersions('01.0.0', '1.0.0')).toBe(0);
+    expect(compareVersions('1.01.0', '1.01.0')).toBe(0);
+    expect(compareVersions('1.0.03', '1.0.3')).toBe(0);
+    expect(compareVersions('1.0.03-alpha', '1.0.3-alpha')).toBe(0);
+    expect(compareVersions('v01.0.0', '1.0.0')).toBe(0);
+    expect(compareVersions('v01.0.0', '2.0.0')).toBe(-1);
+  });
+
+  it('빌드 메타데이터를 무시해야 합니다', () => {
+    expect(compareVersions('1.4.0-build.3928', '1.4.0-build.3928+sha.a8d9d4f')).toBe(0);
+    expect(compareVersions('1.4.0-build.3928+sha.b8dbdb0', '1.4.0-build.3928+sha.a8d9d4f')).toBe(0);
+    expect(compareVersions('1.0.0-alpha+001', '1.0.0-alpha')).toBe(0);
+    expect(compareVersions('1.0.0-beta+exp.sha.5114f85', '1.0.0-beta+exp.sha.999999')).toBe(0);
+    expect(compareVersions('1.0.0+20130313144700', '1.0.0')).toBe(0);
+    expect(compareVersions('1.0.0+20130313144700', '2.0.0')).toBe(-1);
+    expect(compareVersions('1.0.0+20130313144700', '1.0.1+11234343435')).toBe(-1);
+    expect(compareVersions('1.0.1+1', '1.0.1+2')).toBe(0);
+    expect(compareVersions('1.0.0+a-a', '1.0.0+a-b')).toBe(0);
+  });
+
+  it('4세그먼트 버전을 올바르게 처리해야 합니다', () => {
+    expect(compareVersions('1.0.0.0', '1')).toBe(0);
+    expect(compareVersions('1.0.0.0', '1.0')).toBe(0);
+    expect(compareVersions('1.0.0.0', '1.0.0')).toBe(0);
+    expect(compareVersions('1.0.0.0', '1.0.0.0')).toBe(0);
+    expect(compareVersions('1.2.3.4', '1.2.3.4')).toBe(0);
+    expect(compareVersions('1.2.3.4', '1.2.3.04')).toBe(0);
+    expect(compareVersions('v1.2.3.4', '01.2.3.4')).toBe(0);
+    expect(compareVersions('1.2.3.4', '1.2.3.5')).toBe(-1);
+    expect(compareVersions('1.2.3.5', '1.2.3.4')).toBe(1);
+    expect(compareVersions('1.0.0.0-alpha', '1.0.0-alpha')).toBe(0);
+    expect(compareVersions('1.0.0.0-alpha', '1.0.0.0-beta')).toBe(-1);
+  });
+
+  it('단일 세그먼트 버전을 올바르게 비교해야 합니다', () => {
+    expect(compareVersions('10', '9')).toBe(1);
+    expect(compareVersions('10', '10')).toBe(0);
+    expect(compareVersions('9', '10')).toBe(-1);
+  });
+
+  it('두 세그먼트 버전을 올바르게 비교해야 합니다', () => {
+    expect(compareVersions('10.8', '10.4')).toBe(1);
+    expect(compareVersions('10.1', '10.1')).toBe(0);
+    expect(compareVersions('10.1', '10.2')).toBe(-1);
+  });
+
+  it('세 세그먼트 버전을 올바르게 비교해야 합니다', () => {
+    expect(compareVersions('10.1.8', '10.0.4')).toBe(1);
+    expect(compareVersions('10.0.1', '10.0.1')).toBe(0);
+    expect(compareVersions('10.1.1', '10.2.2')).toBe(-1);
+    expect(compareVersions('11.0.10', '11.0.2')).toBe(1);
+    expect(compareVersions('11.0.2', '11.0.10')).toBe(-1);
+  });
+
+  it('추가 비교 테스트', () => {
+    expect(compareVersions('0.1.20', '0.1.5')).toBe(1);
+    expect(compareVersions('1', '0.0.0-beta')).toBe(1);
+    expect(compareVersions('1', '0.2.3')).toBe(1);
+    expect(compareVersions('1', '0.2.4')).toBe(1);
+    expect(compareVersions('1', '1.0.0-0')).toBe(1);
+    expect(compareVersions('1', '1.0.0-beta')).toBe(1);
+    expect(compareVersions('1.0', '0.0.0')).toBe(1);
+    expect(compareVersions('1.0', '0.1.0')).toBe(1);
+    expect(compareVersions('1.0', '0.1.2')).toBe(1);
+    expect(compareVersions('1.0.0', '0.0.0')).toBe(1);
+    expect(compareVersions('1.0.0', '0.0.1')).toBe(1);
+    expect(compareVersions('1.0.0', '0.2.3')).toBe(1);
+    expect(compareVersions('1.2.2', '1.2.1')).toBe(1);
+    expect(compareVersions('2', '1.0.0')).toBe(1);
+    expect(compareVersions('2', '1.0.0-beta')).toBe(1);
+    expect(compareVersions('2', '1.9999.9999')).toBe(1);
+    expect(compareVersions('2.0.0', '1.0.0')).toBe(1);
+    expect(compareVersions('2.0.0', '1.1.1')).toBe(1);
+    expect(compareVersions('2.0.0', '1.2.9')).toBe(1);
+    expect(compareVersions('2.0.0', '1.9999.9999')).toBe(1);
+    expect(compareVersions('2.3', '2.2.1')).toBe(1);
+    expect(compareVersions('2.3', '2.2.2')).toBe(1);
+    expect(compareVersions('2.4', '2.3.0')).toBe(1);
+    expect(compareVersions('2.4', '2.3.5')).toBe(1);
+    expect(compareVersions('3.2.1', '2.3.2')).toBe(1);
+    expect(compareVersions('3.2.1', '3.2.0')).toBe(1);
+  });
+
+  it('잘못된 버전 형식에 대해 오류를 발생시켜야 합니다', () => {
+    expect(() => compareVersions('invalid', '1.0.0')).toThrow();
+    expect(() => compareVersions('1.0.0', 'invalid')).toThrow();
+    expect(() => compareVersions('6.3.', '1.0.0')).toThrow();
+    expect(() => compareVersions('1.2.3a', '1.0.0')).toThrow();
+    expect(() => compareVersions('1.2.-3a', '1.0.0')).toThrow();
+  });
+});

package/src/utils/compareVersion.ts

@@ -0,0 +1,104 @@
+/**
+ * Allowed arithmetic operators
+ */
+export type CompareOperator = '>' | '>=' | '=' | '<' | '<=' | '!=';
+
+/**
+ * RegExp to match semver versions like:
+ * - 1.0.0
+ * - ^1.2.3-alpha+build
+ * - v2.3
+ */
+const SEMVER_REGEX =
+  /^[v^~<>=]*?(\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+))?(?:-([\da-z\\-]+(?:\.[\da-z\\-]+)*))?(?:\+[\da-z\\-]+(?:\.[\da-z\\-]+)*)?)?)?$/i;
+
+const isWildcard = (val: string) => ['*', 'x', 'X'].includes(val);
+
+const tryParse = (val: string): string | number => {
+  const num = parseInt(val, 10);
+  return isNaN(num) ? val : num;
+};
+
+const coerceTypes = (a: string | number, b: string | number): [string | number, string | number] => {
+  return typeof a === typeof b ? [a, b] : [String(a), String(b)];
+};
+
+const compareValues = (a: string, b: string): number => {
+  if (isWildcard(a) || isWildcard(b)) {
+    return 0;
+  }
+
+  const [aVal, bVal] = coerceTypes(tryParse(a), tryParse(b));
+  if (aVal > bVal) {
+    return 1;
+  }
+  if (aVal < bVal) {
+    return -1;
+  }
+  return 0;
+};
+
+const parseVersion = (version: string): (string | undefined)[] => {
+  if (typeof version !== 'string') {
+    throw new TypeError('Invalid argument: expected a string');
+  }
+
+  const match = version.match(SEMVER_REGEX);
+  if (!match) {
+    throw new Error(`Invalid semver: '${version}'`);
+  }
+
+  const [, major, minor, patch, build, preRelease] = match;
+  return [major, minor, patch, build, preRelease];
+};
+
+const compareSegments = (a: (string | undefined)[], b: (string | undefined)[]): number => {
+  const maxLength = Math.max(a.length, b.length);
+
+  for (let i = 0; i < maxLength; i++) {
+    const segA = a[i] ?? '0';
+    const segB = b[i] ?? '0';
+    const result = compareValues(segA, segB);
+    if (result !== 0) {
+      return result;
+    }
+  }
+
+  return 0;
+};
+
+/**
+ * Compare [semver](https://semver.org/) version strings.
+ * Supports versions like `1`, `1.0`, `1.0.0`, and pre-release like `1.0.0-alpha`.
+ *
+ * @param v1 - First version
+ * @param v2 - Second version
+ * @returns 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+ */
+export const compareVersions = (v1: string, v2: string): number => {
+  const seg1 = parseVersion(v1);
+  const seg2 = parseVersion(v2);
+
+  const preRelease1 = seg1.pop();
+  const preRelease2 = seg2.pop();
+
+  const mainCompare = compareSegments(seg1, seg2);
+  if (mainCompare !== 0) {
+    return mainCompare;
+  }
+
+  // If both have pre-release
+  if (preRelease1 && preRelease2) {
+    return compareSegments(preRelease1.split('.'), preRelease2.split('.'));
+  }
+
+  // If only one has pre-release, it's considered lower precedence
+  if (preRelease1) {
+    return -1;
+  }
+  if (preRelease2) {
+    return 1;
+  }
+
+  return 0;
+};

package/src/utils/generateUUID.ts

@@ -0,0 +1,5 @@
+export function generateUUID(placeholder?: any): string {
+  return placeholder
+    ? (placeholder ^ ((Math.random() * 16) >> (placeholder / 4))).toString(16)
+    : (String(1e7) + 1e3 + 4e3 + 8e3 + 1e11).replace(/[018]/g, generateUUID);
+}