@putkoff/abstract-utilities 0.1.235 → 0.1.238

package/dist/index.d.ts

@@ -224,6 +224,30 @@ declare function parseResult(res: Response): Promise<unknown>;
  */
 declare function checkResponse(res: Response): Response;
 
+declare function urlJoin(...parts: (string | undefined | null)[]): string;
+/**
+ * Returns a full URL.
+ * If partial_url is already absolute (starts with http), it is returned as is.
+ * Otherwise, it is combined with the base URL.
+ */
+declare function get_full_url(partial_url: any, domain?: any): string;
+/**
+ * Returns a full file system path.
+ * If partial_path is already absolute, it is returned as is.
+ * Otherwise, it is joined with the base directory.
+ */
+declare function get_full_path(partial_path: any, parent_dir?: any): string;
+/**
+ * Converts a local file system path into its corresponding URL.
+ * It checks against the known directories in all_paths and replaces the matching base.
+ */
+declare function path_to_url(filePath: string, all_paths: any): string | null;
+/**
+ * Converts a URL into its corresponding local file system path.
+ * It checks against the known URL prefixes in all_paths and replaces the matching base.
+ */
+declare function url_to_path(urlStr: string, all_paths: any): string | null;
+
 declare function get_dirname(filePath: string | null): string;
 declare function get_basename(filePath: string | null): string;
 declare function get_filename(file_path: string): string;
@@ -400,5 +424,25 @@ declare function safeDivide(...args: Array<number | string | null | undefined>):
 declare function safeMultiply(...args: Array<number | string | null | undefined>): number;
 declare function roundPercentage(x: any): number;
 
-export { API_PREFIX, BASE_URL, Button, Checkbox, DEV_PREFIX, DOMAIN_NAME, Input, PROD_PREFIX, PROTOCOL, SUB_DIR, Spinner, alertIt, alertit, assureArray, assureList, assureNumber, assureString, assure_array, assure_list, assure_number, assure_string, callStorage, callWindowMethod, capitalize, capitalize_str, checkResponse, cleanArray, cleanText, create_list_string, currentUsername, currentUsernames, decodeJwt, eatAll, eatEnd, eatInner, eatOuter, ensureArray, ensureList, ensureNumber, ensureString, ensure_array, ensure_list, ensure_number, ensure_string, fetchIndexHtml, fetchIndexHtmlContainer, fetchIt, formatNumber, geAuthsUtilsDirectory, geBackupsUtilsDirectory, geConstantsUtilsDirectory, geEnvUtilsDirectory, geFetchUtilsDirectory, geFileUtilsDirectory, gePathUtilsDirectory, geStaticDirectory, geStringUtilsDirectory, geTypeUtilsDirectory, get, getAbsDir, getAbsPath, getAlphaNum, getAlphas, getAuthorizationHeader, getBaseDir, getBody, getChar, getCleanArray, getComponentsUtilsDirectory, getConfigContent, getConfigJson, getConfigVar, getDbConfigsPath, getDistDir, getDocumentProp, getEnvDir, getEnvPath, getFetchVars, getFunctionsDir, getFunctionsUtilsDirectory, getHeaders, getHooksUtilsDirectory, getHtmlDirectory, getLibUtilsDirectory, getMethod, getNums, getPublicDir, getResult, getSafeDocument, getSafeLocalStorage, getSafeWindow, getSchemasDirPath, getSchemasPath, getSrcDir, getSubstring, getToken, getWindowHost, getWindowProp, get_basename, get_dirname, get_extname, get_filename, get_key_value, get_keyword_string, get_relative_path, get_result, get_safe_path, get_splitext, get_window, get_window_location, get_window_parts, get_window_pathname, isLoggedIn, isNum, isStrInString, isTokenExpired, isType, make_path, make_sanitized_path, normalizeUrl, parseResult, processKeywords, readJsonFile, removeToken, requireToken, roundPercentage, safeDivide, safeGlobalProp, safeMultiply, safeNums, safeStorage, sanitizeFilename, stripPrefixes, truncateString, tryParse };
+/** Encode a single query value/key safely */
+declare const encode: (v: unknown) => string;
+/** Decode a single query value/key safely (never throws) */
+declare const decodeSafe: (v: string | null | undefined) => string;
+/** Decode strings that might be double-encoded (up to 2 passes) */
+declare const decodeMaybeDouble: (v: string) => string;
+/** Convert + to spaces (legacy www-form behavior) then decode */
+declare const decodeFormComponent: (v: string) => string;
+/** Build a URL with query params (skips null/undefined) */
+declare const buildUrl: (base: string, params?: Record<string, unknown>) => string;
+/** Parse a query string into an object (first value wins; arrays if repeat=true) */
+declare const parseQuery: (qs: string, opts?: {
+    repeat?: boolean;
+    form?: boolean;
+}) => Record<string, any>;
+/** Quick helper: percent-encode whole strings for placement in URLs */
+declare const encodeTextForUrl: (text: string) => string;
+/** Quick helper: decode long blobs coming from share-intents/UTMs */
+declare const decodeShareBlob: (blob: string) => string;
+
+export { API_PREFIX, BASE_URL, Button, Checkbox, DEV_PREFIX, DOMAIN_NAME, Input, PROD_PREFIX, PROTOCOL, SUB_DIR, Spinner, alertIt, alertit, assureArray, assureList, assureNumber, assureString, assure_array, assure_list, assure_number, assure_string, buildUrl, callStorage, callWindowMethod, capitalize, capitalize_str, checkResponse, cleanArray, cleanText, create_list_string, currentUsername, currentUsernames, decodeFormComponent, decodeJwt, decodeMaybeDouble, decodeSafe, decodeShareBlob, eatAll, eatEnd, eatInner, eatOuter, encode, encodeTextForUrl, ensureArray, ensureList, ensureNumber, ensureString, ensure_array, ensure_list, ensure_number, ensure_string, fetchIndexHtml, fetchIndexHtmlContainer, fetchIt, formatNumber, geAuthsUtilsDirectory, geBackupsUtilsDirectory, geConstantsUtilsDirectory, geEnvUtilsDirectory, geFetchUtilsDirectory, geFileUtilsDirectory, gePathUtilsDirectory, geStaticDirectory, geStringUtilsDirectory, geTypeUtilsDirectory, get, getAbsDir, getAbsPath, getAlphaNum, getAlphas, getAuthorizationHeader, getBaseDir, getBody, getChar, getCleanArray, getComponentsUtilsDirectory, getConfigContent, getConfigJson, getConfigVar, getDbConfigsPath, getDistDir, getDocumentProp, getEnvDir, getEnvPath, getFetchVars, getFunctionsDir, getFunctionsUtilsDirectory, getHeaders, getHooksUtilsDirectory, getHtmlDirectory, getLibUtilsDirectory, getMethod, getNums, getPublicDir, getResult, getSafeDocument, getSafeLocalStorage, getSafeWindow, getSchemasDirPath, getSchemasPath, getSrcDir, getSubstring, getToken, getWindowHost, getWindowProp, get_basename, get_dirname, get_extname, get_filename, get_full_path, get_full_url, get_key_value, get_keyword_string, get_relative_path, get_result, get_safe_path, get_splitext, get_window, get_window_location, get_window_parts, get_window_pathname, isLoggedIn, isNum, isStrInString, isTokenExpired, isType, make_path, make_sanitized_path, normalizeUrl, parseQuery, parseResult, path_to_url, processKeywords, readJsonFile, removeToken, requireToken, roundPercentage, safeDivide, safeGlobalProp, safeMultiply, safeNums, safeStorage, sanitizeFilename, stripPrefixes, truncateString, tryParse, urlJoin, url_to_path };
 export type { ApiRow, AppConfig, ChangePasswordFormProps, ChangePasswordProps, FetchVariables, FileItem, FileListResponse, InputProps, JwtPayload, LoginFormProps, LoginProps, LogoutButtonProps, Promise$1 as Promise, UrlKey };

package/dist/types/functions/fetch_utils/src/index.d.ts

@@ -1,2 +1,3 @@
 export * from './fetch_utils';
 export * from './utils';
+export * from './url_utils';

package/dist/types/functions/index.d.ts

@@ -14,3 +14,4 @@ export * from './safe_utils';
 export * from './read_utils';
 export * from './variable_utils';
 export * from './math_utils';
+export * from './url_utils';

package/dist/types/functions/url_utils/index.d.ts

@@ -0,0 +1 @@
+export * from './uri_utils';

package/dist/types/functions/url_utils/uri_utils.d.ts

@@ -0,0 +1,19 @@
+/** Encode a single query value/key safely */
+export declare const encode: (v: unknown) => string;
+/** Decode a single query value/key safely (never throws) */
+export declare const decodeSafe: (v: string | null | undefined) => string;
+/** Decode strings that might be double-encoded (up to 2 passes) */
+export declare const decodeMaybeDouble: (v: string) => string;
+/** Convert + to spaces (legacy www-form behavior) then decode */
+export declare const decodeFormComponent: (v: string) => string;
+/** Build a URL with query params (skips null/undefined) */
+export declare const buildUrl: (base: string, params?: Record<string, unknown>) => string;
+/** Parse a query string into an object (first value wins; arrays if repeat=true) */
+export declare const parseQuery: (qs: string, opts?: {
+    repeat?: boolean;
+    form?: boolean;
+}) => Record<string, any>;
+/** Quick helper: percent-encode whole strings for placement in URLs */
+export declare const encodeTextForUrl: (text: string) => string;
+/** Quick helper: decode long blobs coming from share-intents/UTMs */
+export declare const decodeShareBlob: (blob: string) => string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@putkoff/abstract-utilities",
-  "version": "0.1.235",
+  "version": "0.1.238",
   "description": "Reusable abstract utility functions and components for both Node and React.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",