@ms-cloudpack/path-string-parsing 1.2.7 → 1.3.0

package/README.md

@@ -1,3 +1,5 @@
 # @ms-cloudpack/path-string-parsing
 
 Common path-related string parsing utilities for Cloudpack.
+
+Some of the utilities from this package are used in the overlay UX in the browser, so it can't reference any Node libraries.

package/lib/addHashUrl.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Adds hash after name and version in a URL.
+ * If hash already exists, replaces it.
+ *
+ * @param params - Parameters for adding hash to URL
+ * @param params.url - URL to add hash to
+ * @param params.packageName - Package name
+ * @param params.version - Package version
+ * @param params.hash - Hash to add
+ * @returns URL with hash added or replaced
+ *
+ * @example
+ * ```ts
+ * addHashUrl({
+ *   url: 'http://localhost:3000/react@17.5.0/v0/bundled/index.js',
+ *   packageName: 'react',
+ *   version: '17.5.0',
+ *   hash: 'abc123'
+ * });
+ * // Returns: 'http://localhost:3000/react@17.5.0/h-abc123/v0/bundled/index.js'
+ * ```
+ */
+export declare function addHashUrl(params: {
+    /** URL to add hash to */
+    url: string;
+    /** Package name */
+    packageName: string;
+    /** Package version */
+    version: string;
+    /** Hash to add */
+    hash: string;
+}): string;
+//# sourceMappingURL=addHashUrl.d.ts.map

package/lib/addHashUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addHashUrl.d.ts","sourceRoot":"","sources":["../src/addHashUrl.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAUT"}

package/lib/addHashUrl.js

@@ -0,0 +1,35 @@
+import { removeHashFromUrl } from './removeHashFromUrl.js';
+/**
+ * Adds hash after name and version in a URL.
+ * If hash already exists, replaces it.
+ *
+ * @param params - Parameters for adding hash to URL
+ * @param params.url - URL to add hash to
+ * @param params.packageName - Package name
+ * @param params.version - Package version
+ * @param params.hash - Hash to add
+ * @returns URL with hash added or replaced
+ *
+ * @example
+ * ```ts
+ * addHashUrl({
+ *   url: 'http://localhost:3000/react@17.5.0/v0/bundled/index.js',
+ *   packageName: 'react',
+ *   version: '17.5.0',
+ *   hash: 'abc123'
+ * });
+ * // Returns: 'http://localhost:3000/react@17.5.0/h-abc123/v0/bundled/index.js'
+ * ```
+ */
+export function addHashUrl(params) {
+    const { url, packageName, version, hash } = params;
+    const packageId = `${packageName}@${version}`;
+    const packageUrlIndex = url.indexOf(packageId);
+    if (packageUrlIndex !== -1) {
+        const hashIndex = packageUrlIndex + packageId.length;
+        const urlWithoutHash = removeHashFromUrl(url);
+        return urlWithoutHash.slice(0, hashIndex) + `/h-${hash}` + urlWithoutHash.slice(hashIndex);
+    }
+    return url;
+}
+//# sourceMappingURL=addHashUrl.js.map

package/lib/addHashUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addHashUrl.js","sourceRoot":"","sources":["../src/addHashUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,UAAU,CAAC,MAS1B;IACC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACnD,MAAM,SAAS,GAAG,GAAG,WAAW,IAAI,OAAO,EAAE,CAAC;IAC9C,MAAM,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,eAAe,KAAK,CAAC,CAAC,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,eAAe,GAAG,SAAS,CAAC,MAAM,CAAC;QACrD,MAAM,cAAc,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC9C,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,MAAM,IAAI,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["import { removeHashFromUrl } from './removeHashFromUrl.js';\n\n/**\n * Adds hash after name and version in a URL.\n * If hash already exists, replaces it.\n *\n * @param params - Parameters for adding hash to URL\n * @param params.url - URL to add hash to\n * @param params.packageName - Package name\n * @param params.version - Package version\n * @param params.hash - Hash to add\n * @returns URL with hash added or replaced\n *\n * @example\n * ```ts\n * addHashUrl({\n *   url: 'http://localhost:3000/react@17.5.0/v0/bundled/index.js',\n *   packageName: 'react',\n *   version: '17.5.0',\n *   hash: 'abc123'\n * });\n * // Returns: 'http://localhost:3000/react@17.5.0/h-abc123/v0/bundled/index.js'\n * ```\n */\nexport function addHashUrl(params: {\n  /** URL to add hash to */\n  url: string;\n  /** Package name */\n  packageName: string;\n  /** Package version */\n  version: string;\n  /** Hash to add */\n  hash: string;\n}): string {\n  const { url, packageName, version, hash } = params;\n  const packageId = `${packageName}@${version}`;\n  const packageUrlIndex = url.indexOf(packageId);\n  if (packageUrlIndex !== -1) {\n    const hashIndex = packageUrlIndex + packageId.length;\n    const urlWithoutHash = removeHashFromUrl(url);\n    return urlWithoutHash.slice(0, hashIndex) + `/h-${hash}` + urlWithoutHash.slice(hashIndex);\n  }\n  return url;\n}\n"]}

package/lib/index.d.ts

@@ -4,4 +4,6 @@ export { slash } from './slash.js';
 export { parseImportString, type ImportStringResult } from './parseImportString.js';
 export { parseNamedImports } from './parseNamedImports.js';
 export { makeUrl } from './makeUrl.js';
+export { addHashUrl } from './addHashUrl.js';
+export { removeHashFromUrl } from './removeHashFromUrl.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/lib/index.js

@@ -4,4 +4,6 @@ export { slash } from './slash.js';
 export { parseImportString } from './parseImportString.js';
 export { parseNamedImports } from './parseNamedImports.js';
 export { makeUrl } from './makeUrl.js';
+export { addHashUrl } from './addHashUrl.js';
+export { removeHashFromUrl } from './removeHashFromUrl.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAA2B,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export { safeRelativePath } from './safeRelativePath.js';\nexport { normalizeRelativePath } from './normalizeRelativePath.js';\nexport { slash } from './slash.js';\nexport { parseImportString, type ImportStringResult } from './parseImportString.js';\nexport { parseNamedImports } from './parseNamedImports.js';\nexport { makeUrl } from './makeUrl.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAA2B,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC","sourcesContent":["export { safeRelativePath } from './safeRelativePath.js';\nexport { normalizeRelativePath } from './normalizeRelativePath.js';\nexport { slash } from './slash.js';\nexport { parseImportString, type ImportStringResult } from './parseImportString.js';\nexport { parseNamedImports } from './parseNamedImports.js';\nexport { makeUrl } from './makeUrl.js';\nexport { addHashUrl } from './addHashUrl.js';\nexport { removeHashFromUrl } from './removeHashFromUrl.js';\n"]}

package/lib/removeHashFromUrl.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Removes hash segment from URL for comparison purposes.
+ *
+ * This function normalizes URLs by removing the hash segment (e.g., `/h-abc123/`)
+ * that appears after the package name and version. This is useful for comparing
+ * URLs that point to the same resource but with different hash values.
+ *
+ * The hash segment is used for cache-busting and content versioning. By removing it,
+ * we can check if two URLs refer to the same logical resource regardless of their
+ * specific hash values.
+ *
+ * @param url - URL to remove hash from
+ * @returns URL with hash segment removed, or original URL if no hash segment is found
+ *
+ * @example
+ * ```ts
+ * // Remove hash from a URL
+ * removeHashFromUrl('http://localhost:3000/react@17.5.0/h-abc123/v0/bundled/index.js');
+ * // Returns: 'http://localhost:3000/react@17.5.0/v0/bundled/index.js'
+ *
+ * // URL without hash is returned unchanged
+ * removeHashFromUrl('http://localhost:3000/react@17.5.0/v0/bundled/index.js');
+ * // Returns: 'http://localhost:3000/react@17.5.0/v0/bundled/index.js'
+ *
+ * // Compare URLs with different hashes
+ * const url1 = 'http://localhost:3000/pkg@1.0.0/h-old/bundled/index.js';
+ * const url2 = 'http://localhost:3000/pkg@1.0.0/h-new/bundled/index.js';
+ * removeHashFromUrl(url1) === removeHashFromUrl(url2); // true
+ * ```
+ */
+export declare function removeHashFromUrl(url: string): string;
+//# sourceMappingURL=removeHashFromUrl.d.ts.map

package/lib/removeHashFromUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeHashFromUrl.d.ts","sourceRoot":"","sources":["../src/removeHashFromUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAerD"}

package/lib/removeHashFromUrl.js

@@ -0,0 +1,45 @@
+/**
+ * Removes hash segment from URL for comparison purposes.
+ *
+ * This function normalizes URLs by removing the hash segment (e.g., `/h-abc123/`)
+ * that appears after the package name and version. This is useful for comparing
+ * URLs that point to the same resource but with different hash values.
+ *
+ * The hash segment is used for cache-busting and content versioning. By removing it,
+ * we can check if two URLs refer to the same logical resource regardless of their
+ * specific hash values.
+ *
+ * @param url - URL to remove hash from
+ * @returns URL with hash segment removed, or original URL if no hash segment is found
+ *
+ * @example
+ * ```ts
+ * // Remove hash from a URL
+ * removeHashFromUrl('http://localhost:3000/react@17.5.0/h-abc123/v0/bundled/index.js');
+ * // Returns: 'http://localhost:3000/react@17.5.0/v0/bundled/index.js'
+ *
+ * // URL without hash is returned unchanged
+ * removeHashFromUrl('http://localhost:3000/react@17.5.0/v0/bundled/index.js');
+ * // Returns: 'http://localhost:3000/react@17.5.0/v0/bundled/index.js'
+ *
+ * // Compare URLs with different hashes
+ * const url1 = 'http://localhost:3000/pkg@1.0.0/h-old/bundled/index.js';
+ * const url2 = 'http://localhost:3000/pkg@1.0.0/h-new/bundled/index.js';
+ * removeHashFromUrl(url1) === removeHashFromUrl(url2); // true
+ * ```
+ */
+export function removeHashFromUrl(url) {
+    // Find the start of the hash segment (e.g., '/h-abc123/')
+    const hashStart = url.indexOf('/h-');
+    if (hashStart === -1) {
+        return url;
+    }
+    // Find the end of the hash segment (the next '/' after '/h-')
+    const hashEnd = url.indexOf('/', hashStart + 1);
+    if (hashEnd === -1) {
+        return url;
+    }
+    // Remove the hash segment by concatenating everything before and after it
+    return url.slice(0, hashStart) + url.slice(hashEnd);
+}
+//# sourceMappingURL=removeHashFromUrl.js.map

package/lib/removeHashFromUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeHashFromUrl.js","sourceRoot":"","sources":["../src/removeHashFromUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,0DAA0D;IAC1D,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,8DAA8D;IAC9D,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;IAChD,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;QACnB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,0EAA0E;IAC1E,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC","sourcesContent":["/**\n * Removes hash segment from URL for comparison purposes.\n *\n * This function normalizes URLs by removing the hash segment (e.g., `/h-abc123/`)\n * that appears after the package name and version. This is useful for comparing\n * URLs that point to the same resource but with different hash values.\n *\n * The hash segment is used for cache-busting and content versioning. By removing it,\n * we can check if two URLs refer to the same logical resource regardless of their\n * specific hash values.\n *\n * @param url - URL to remove hash from\n * @returns URL with hash segment removed, or original URL if no hash segment is found\n *\n * @example\n * ```ts\n * // Remove hash from a URL\n * removeHashFromUrl('http://localhost:3000/react@17.5.0/h-abc123/v0/bundled/index.js');\n * // Returns: 'http://localhost:3000/react@17.5.0/v0/bundled/index.js'\n *\n * // URL without hash is returned unchanged\n * removeHashFromUrl('http://localhost:3000/react@17.5.0/v0/bundled/index.js');\n * // Returns: 'http://localhost:3000/react@17.5.0/v0/bundled/index.js'\n *\n * // Compare URLs with different hashes\n * const url1 = 'http://localhost:3000/pkg@1.0.0/h-old/bundled/index.js';\n * const url2 = 'http://localhost:3000/pkg@1.0.0/h-new/bundled/index.js';\n * removeHashFromUrl(url1) === removeHashFromUrl(url2); // true\n * ```\n */\nexport function removeHashFromUrl(url: string): string {\n  // Find the start of the hash segment (e.g., '/h-abc123/')\n  const hashStart = url.indexOf('/h-');\n  if (hashStart === -1) {\n    return url;\n  }\n\n  // Find the end of the hash segment (the next '/' after '/h-')\n  const hashEnd = url.indexOf('/', hashStart + 1);\n  if (hashEnd === -1) {\n    return url;\n  }\n\n  // Remove the hash segment by concatenating everything before and after it\n  return url.slice(0, hashStart) + url.slice(hashEnd);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ms-cloudpack/path-string-parsing",
-  "version": "1.2.7",
+  "version": "1.3.0",
   "description": "Common path-related string parsing utilities for Cloudpack",
   "license": "MIT",
   "type": "module",