@putkoff/abstract-utilities 0.1.236 → 0.1.239

package/dist/index.d.ts

@@ -424,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_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, parseResult, path_to_url, processKeywords, readJsonFile, removeToken, requireToken, roundPercentage, safeDivide, safeGlobalProp, safeMultiply, safeNums, safeStorage, sanitizeFilename, stripPrefixes, truncateString, tryParse, urlJoin, url_to_path };
+/** 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/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.236",
+  "version": "0.1.239",
   "description": "Reusable abstract utility functions and components for both Node and React.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -19,6 +19,7 @@
     "@testing-library/react": "^14.2.1",
     "@types/jest": "^29.5.12",
     "@types/node": "^24.0.13",
+    "@types/path-browserify": "^1.0.3",
     "@types/react": "^18.3.23",
     "@types/react-dom": "^18.3.7",
     "jest": "^29.7.0",