@hyperfrontend/versioning 0.1.0 → 0.2.0

package/repository/url/index.esm.js

@@ -0,0 +1,176 @@
+/**
+ * Safe copies of Map built-in via factory function.
+ *
+ * Since constructors cannot be safely captured via Object.assign, this module
+ * provides a factory function that uses Reflect.construct internally.
+ *
+ * These references are captured at module initialization time to protect against
+ * prototype pollution attacks. Import only what you need for tree-shaking.
+ *
+ * @module @hyperfrontend/immutable-api-utils/built-in-copy/map
+ */
+// Capture references at module initialization time
+const _Map = globalThis.Map;
+const _Reflect = globalThis.Reflect;
+/**
+ * (Safe copy) Creates a new Map using the captured Map constructor.
+ * Use this instead of `new Map()`.
+ *
+ * @param iterable - Optional iterable of key-value pairs.
+ * @returns A new Map instance.
+ */
+const createMap = (iterable) => _Reflect.construct(_Map, iterable ? [iterable] : []);
+
+/**
+ * Checks if a platform identifier is a known platform with built-in support.
+ *
+ * @param platform - Platform identifier to check
+ * @returns True if the platform is a known platform
+ *
+ * @example
+ * ```typescript
+ * isKnownPlatform('github')     // true
+ * isKnownPlatform('gitlab')     // true
+ * isKnownPlatform('custom')     // false
+ * isKnownPlatform('unknown')    // false
+ * ```
+ */
+function isKnownPlatform(platform) {
+    return platform === 'github' || platform === 'gitlab' || platform === 'bitbucket' || platform === 'azure-devops';
+}
+/**
+ * Known platform hostnames mapped to their platform type.
+ * Used for automatic platform detection from repository URLs.
+ *
+ * Includes both standard SaaS domains and common patterns for self-hosted instances.
+ */
+createMap([
+    // GitHub
+    ['github.com', 'github'],
+    // GitLab
+    ['gitlab.com', 'gitlab'],
+    // Bitbucket
+    ['bitbucket.org', 'bitbucket'],
+    // Azure DevOps
+    ['dev.azure.com', 'azure-devops'],
+    ['visualstudio.com', 'azure-devops'],
+]);
+
+/**
+ * Creates a platform-specific compare URL for viewing changes between two commits.
+ *
+ * Each platform has a different URL format:
+ * - **GitHub**: `{baseUrl}/compare/{fromCommit}...{toCommit}` (three dots)
+ * - **GitLab**: `{baseUrl}/-/compare/{fromCommit}...{toCommit}` (three dots, `/-/` prefix)
+ * - **Bitbucket**: `{baseUrl}/compare/{toCommit}..{fromCommit}` (two dots, reversed order)
+ * - **Azure DevOps**: `{baseUrl}/compare?version=GT{toCommit}&compareVersion=GT{fromCommit}` (query params)
+ *
+ * For `custom` platforms, a `formatCompareUrl` function must be provided in the repository config.
+ * For `unknown` platforms, returns `null`.
+ *
+ * @param options - Compare URL options including repository, fromCommit, and toCommit
+ * @returns The compare URL string, or null if URL cannot be generated
+ *
+ * @example
+ * ```typescript
+ * // GitHub
+ * createCompareUrl({
+ *   repository: { platform: 'github', baseUrl: 'https://github.com/owner/repo' },
+ *   fromCommit: 'abc1234',
+ *   toCommit: 'def5678'
+ * })
+ * // → 'https://github.com/owner/repo/compare/abc1234...def5678'
+ *
+ * // GitLab
+ * createCompareUrl({
+ *   repository: { platform: 'gitlab', baseUrl: 'https://gitlab.com/group/project' },
+ *   fromCommit: 'abc1234',
+ *   toCommit: 'def5678'
+ * })
+ * // → 'https://gitlab.com/group/project/-/compare/abc1234...def5678'
+ *
+ * // Bitbucket (reversed order)
+ * createCompareUrl({
+ *   repository: { platform: 'bitbucket', baseUrl: 'https://bitbucket.org/owner/repo' },
+ *   fromCommit: 'abc1234',
+ *   toCommit: 'def5678'
+ * })
+ * // → 'https://bitbucket.org/owner/repo/compare/def5678..abc1234'
+ *
+ * // Azure DevOps
+ * createCompareUrl({
+ *   repository: { platform: 'azure-devops', baseUrl: 'https://dev.azure.com/org/proj/_git/repo' },
+ *   fromCommit: 'abc1234',
+ *   toCommit: 'def5678'
+ * })
+ * // → 'https://dev.azure.com/org/proj/_git/repo/compare?version=GTdef5678&compareVersion=GTabc1234'
+ *
+ * // Custom formatter
+ * createCompareUrl({
+ *   repository: {
+ *     platform: 'custom',
+ *     baseUrl: 'https://my-git.internal/repo',
+ *     formatCompareUrl: (from, to) => `https://my-git.internal/diff/${from}/${to}`
+ *   },
+ *   fromCommit: 'abc1234',
+ *   toCommit: 'def5678'
+ * })
+ * // → 'https://my-git.internal/diff/abc1234/def5678'
+ * ```
+ */
+function createCompareUrl(options) {
+    const { repository, fromCommit, toCommit } = options;
+    // Validate inputs
+    if (!repository || !fromCommit || !toCommit) {
+        return null;
+    }
+    // If custom formatter is provided, use it (works for any platform including overrides)
+    if (repository.formatCompareUrl) {
+        return repository.formatCompareUrl(fromCommit, toCommit);
+    }
+    const { platform, baseUrl } = repository;
+    // Cannot generate URL for unknown platforms without a formatter
+    if (platform === 'unknown') {
+        return null;
+    }
+    // Custom platform requires a formatter
+    if (platform === 'custom') {
+        return null;
+    }
+    // Generate URL for known platforms
+    if (isKnownPlatform(platform)) {
+        return formatKnownPlatformCompareUrl(platform, baseUrl, fromCommit, toCommit);
+    }
+    return null;
+}
+/**
+ * Formats a compare URL for known platforms.
+ *
+ * @param platform - Known platform type
+ * @param baseUrl - Repository base URL
+ * @param fromCommit - Source commit hash (older version)
+ * @param toCommit - Target commit hash (newer version)
+ * @returns Formatted compare URL
+ *
+ * @internal
+ */
+function formatKnownPlatformCompareUrl(platform, baseUrl, fromCommit, toCommit) {
+    switch (platform) {
+        case 'github':
+            // GitHub: {baseUrl}/compare/{fromCommit}...{toCommit}
+            return `${baseUrl}/compare/${fromCommit}...${toCommit}`;
+        case 'gitlab':
+            // GitLab: {baseUrl}/-/compare/{fromCommit}...{toCommit}
+            return `${baseUrl}/-/compare/${fromCommit}...${toCommit}`;
+        case 'bitbucket':
+            // Bitbucket: {baseUrl}/compare/{toCommit}..{fromCommit} (reversed order, two dots)
+            return `${baseUrl}/compare/${toCommit}..${fromCommit}`;
+        case 'azure-devops':
+            // Azure DevOps: {baseUrl}/compare?version=GT{toCommit}&compareVersion=GT{fromCommit}
+            // Use encodeURIComponent for query parameter values
+            return `${baseUrl}/compare?version=GT${encodeURIComponent(toCommit)}&compareVersion=GT${encodeURIComponent(fromCommit)}`;
+    }
+}
+
+export { createCompareUrl };
+//# sourceMappingURL=index.esm.js.map

package/repository/url/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/map/index.ts","../../../../../../../../../../libs/versioning/src/repository/models/platform.ts","../../../../../../../../../../libs/versioning/src/repository/url/compare.ts"],"sourcesContent":[null,null,null],"names":[],"mappings":"AAAA;;;;;;;;;;AAUG;AAEH;AACA,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG;AAC3B,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO;AAGnC;;;;;;AAMG;AACI,MAAM,SAAS,GAAG,CAAO,QAA2C,KAC9D,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;;ACHjE;;;;;;;;;;;;;AAaG;AACG,SAAU,eAAe,CAAC,QAA4B,EAAA;AAC1D,IAAA,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,cAAc;AAClH;AAEA;;;;;AAKG;AACmE,SAAS,CAAwB;;IAErG,CAAC,YAAY,EAAE,QAAQ,CAAC;;IAGxB,CAAC,YAAY,EAAE,QAAQ,CAAC;;IAGxB,CAAC,eAAe,EAAE,WAAW,CAAC;;IAG9B,CAAC,eAAe,EAAE,cAAc,CAAC;IACjC,CAAC,kBAAkB,EAAE,cAAc,CAAC;AACrC,CAAA;;ACjCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DG;AACG,SAAU,gBAAgB,CAAC,OAAgC,EAAA;IAC/D,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,OAAO;;IAGpD,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ,EAAE;AAC3C,QAAA,OAAO,IAAI;IACb;;AAGA,IAAA,IAAI,UAAU,CAAC,gBAAgB,EAAE;QAC/B,OAAO,UAAU,CAAC,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC1D;AAEA,IAAA,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,UAAU;;AAGxC,IAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;AAC1B,QAAA,OAAO,IAAI;IACb;;AAGA,IAAA,IAAI,QAAQ,KAAK,QAAQ,EAAE;AACzB,QAAA,OAAO,IAAI;IACb;;AAGA,IAAA,IAAI,eAAe,CAAC,QAAQ,CAAC,EAAE;QAC7B,OAAO,6BAA6B,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC;IAC/E;AAEA,IAAA,OAAO,IAAI;AACb;AAEA;;;;;;;;;;AAUG;AACH,SAAS,6BAA6B,CAAC,QAAuB,EAAE,OAAe,EAAE,UAAkB,EAAE,QAAgB,EAAA;IACnH,QAAQ,QAAQ;AACd,QAAA,KAAK,QAAQ;;AAEX,YAAA,OAAO,GAAG,OAAO,CAAA,SAAA,EAAY,UAAU,CAAA,GAAA,EAAM,QAAQ,EAAE;AAEzD,QAAA,KAAK,QAAQ;;AAEX,YAAA,OAAO,GAAG,OAAO,CAAA,WAAA,EAAc,UAAU,CAAA,GAAA,EAAM,QAAQ,EAAE;AAE3D,QAAA,KAAK,WAAW;;AAEd,YAAA,OAAO,GAAG,OAAO,CAAA,SAAA,EAAY,QAAQ,CAAA,EAAA,EAAK,UAAU,EAAE;AAExD,QAAA,KAAK,cAAc;;;AAGjB,YAAA,OAAO,CAAA,EAAG,OAAO,CAAA,mBAAA,EAAsB,kBAAkB,CAAC,QAAQ,CAAC,CAAA,kBAAA,EAAqB,kBAAkB,CAAC,UAAU,CAAC,EAAE;;AAE9H;;;;"}