@mapomodule/utils 1.0.0-alpha.9 → 2.0.0-beta.1

package/dist/types/normalizeEndpoint.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Ensures an API endpoint path has exactly one leading and one trailing slash.
+ * Query strings are preserved unchanged — the slash is inserted before the `?`.
+ * Used by `useCrud` to normalize user-provided endpoint paths before making requests.
+ *
+ * @example
+ * normalizeEndpoint('api/articles')          // '/api/articles/'
+ * normalizeEndpoint('/api/articles')         // '/api/articles/'
+ * normalizeEndpoint('/api/articles/')        // '/api/articles/'
+ * normalizeEndpoint('/api/articles/?q=1')    // '/api/articles/?q=1'
+ */
+export declare function normalizeEndpoint(endpoint: string): string;
+/**
+ * Splits an endpoint string into its clean path and parsed query params.
+ * Useful when an endpoint carries baked-in params (e.g. `?fields=id,title`) that
+ * must be merged into request params while CRUD mutations target the bare path.
+ *
+ * @example
+ * splitEndpointParams('/api/articles/?fields=id,title')
+ *  { path: '/api/articles/', params: { fields: 'id,title' } }
+ * splitEndpointParams('/api/articles/')
+ *  { path: '/api/articles/', params: {} }
+ */
+export declare function splitEndpointParams(endpoint: string): {
+    path: string;
+    params: Record<string, string>;
+};
+//# sourceMappingURL=normalizeEndpoint.d.ts.map

package/dist/types/normalizeEndpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeEndpoint.d.ts","sourceRoot":"","sources":["../../src/normalizeEndpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAOA"}

package/dist/types/objectDiff.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Computes a deep diff between two objects and returns only changed fields.
+ *
+ * Nested objects are diffed recursively. Arrays are compared deeply and, when changed,
+ * are returned as the full current array value.
+ *
+ * @param base Base object used as the comparison reference.
+ * @param current Current object to compare against `base`.
+ * @returns A partial object containing only keys whose values differ from `base`.
+ */
+export declare function objectDiff<T extends object>(base: T, current: T): Partial<T>;
+//# sourceMappingURL=objectDiff.d.ts.map

package/dist/types/objectDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectDiff.d.ts","sourceRoot":"","sources":["../../src/objectDiff.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA2B5E"}

package/dist/types/objectHelpers.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Deep-clones a value and returns a detached copy.
+ *
+ * The function first unwraps Vue reactive proxies (when present), then:
+ * - uses `structuredClone` when available
+ * - falls back to recursive cloning for plain objects/arrays
+ *
+ * The recursive fallback does not support circular references.
+ */
+export declare function deepClone<T>(value: T): T;
+/**
+ * Type guard that returns true when `value` is a browser `File`.
+ */
+export declare function isFile(value: unknown): value is File;
+/**
+ * Type guard that returns true when `value` is a browser `Blob`.
+ */
+export declare function isBlob(value: unknown): value is Blob;
+/**
+ * Type guard that returns true when `value` is either a `File` or a `Blob`.
+ */
+export declare function isFileOrBlob(value: unknown): value is File | Blob;
+/**
+ * Return all dot-notation paths in `obj` where the predicate is truthy.
+ */
+export declare function findPropPaths(obj: unknown, predicate: (val: unknown) => boolean, _prefix?: string): string[];
+/** Return all paths in `obj` that hold a File or Blob. */
+export declare function filesInObject(obj: unknown): string[];
+/**
+ * Return a shallow copy of `obj` containing only the listed top-level keys.
+ */
+export declare function filterObj<T extends Record<string, unknown>>(obj: T, keys: (keyof T)[]): Partial<T>;
+//# sourceMappingURL=objectHelpers.d.ts.map

package/dist/types/objectHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectHelpers.d.ts","sourceRoot":"","sources":["../../src/objectHelpers.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAkBxC;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,IAAI,CAEjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,EACpC,OAAO,SAAK,GACX,MAAM,EAAE,CAaV;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAEpD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAChB,OAAO,CAAC,CAAC,CAAC,CAQZ"}

package/dist/types/slotNamespace.d.ts

@@ -0,0 +1,12 @@
+import type { Slots } from "vue";
+/**
+ * Creates a namespaced view of slots, including only those that start with the given prefix.
+ *
+ * Filtered slot names are normalized by removing the prefix from the slot key.
+ *
+ * @param slots Source Vue slots object.
+ * @param prefix Prefix used to select which slots to include.
+ * @returns A new `Slots` object containing only prefixed slots, renamed without the prefix.
+ */
+export declare function slotNamespace(slots: Slots, prefix: string): Slots;
+//# sourceMappingURL=slotNamespace.d.ts.map

package/dist/types/slotNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slotNamespace.d.ts","sourceRoot":"","sources":["../../src/slotNamespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC;AAEjC;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAMjE"}

package/package.json

@@ -1,16 +1,47 @@
 {
   "name": "@mapomodule/utils",
-  "version": "1.0.0-alpha.9",
+  "version": "2.0.0-beta.1",
+  "description": "Mapo typed utilities",
+  "type": "module",
   "license": "MIT",
-  "description": "This is part of Mapo nuxt module. Provides a set of utils for the project.",
-  "author": "bnznamco <gabriele.baldi.01@gmail.com>",
-  "repository": "https://github.com/lotrekagency/mapo",
-  "main": "./index.js",
-  "dependencies": {
-    "js-cookie": "^2.2.1"
+  "author": "Lotrek Agency (https://lotrek.it)",
+  "homepage": "https://lotrekagency.github.io/mapo-new/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lotrekagency/mapo-new.git",
+    "directory": "packages/@mapomodule/utils"
+  },
+  "bugs": {
+    "url": "https://github.com/lotrekagency/mapo-new/issues"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "tag": "next"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./jsonSchema": {
+      "types": "./dist/types/jsonSchema/index.d.ts",
+      "import": "./dist/jsonSchema/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsc -p tsconfig.json --watch",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
   },
-  "gitHead": "a75142247a9371981aea57b76828bd354b375aea"
+  "devDependencies": {
+    "vue": "^3.5.32",
+    "vue-router": "^5.0.4"
+  }
 }

package/CHANGELOG.md

@@ -1,22 +0,0 @@
-# Change Log
-
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-# [1.0.0-alpha.9](https://github.com/lotrekagency/mapo/compare/v1.0.0-alpha.8...v1.0.0-alpha.9) (2022-02-08)
-
-
-### Bug Fixes
-
-* **core:** fix object setPointed to create missing nesting ([7a26510](https://github.com/lotrekagency/mapo/commit/7a26510d6c1648156bd5a8f18d3851e4fe195d29))
-
-
-
-
-
-# [1.0.0-alpha.8](https://github.com/lotrekagency/mapo/compare/v1.0.0-alpha.7...v1.0.0-alpha.8) (2022-01-23)
-
-
-### Features
-
-* **quickedit:** merge detail component logics in to quickedit ([691f610](https://github.com/lotrekagency/mapo/commit/691f610b156f58a5d30598d89bf06425d90451d8))

package/LICENSE.md

@@ -1,20 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) Lotrek 2021
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN

package/helpers/auth.js

@@ -1,21 +0,0 @@
-const Cookies = require('js-cookie')
-
-const TokenKey = '__mapo_session'
-
-function getToken() {
-  return Cookies.get(TokenKey)
-}
-
-function setToken(token) {
-  return Cookies.set(TokenKey, token)
-}
-
-function removeToken() {
-  return Cookies.remove(TokenKey)
-}
-
-module.exports = {
-  getToken,
-  setToken,
-  removeToken
-}

package/helpers/debounce.js

@@ -1,18 +0,0 @@
-function debounce(func, wait, immediate) {
-    var timeout;
-    return function () {
-        var context = this, args = arguments;
-        var later = function () {
-            timeout = null;
-            if (!immediate) func.apply(context, args);
-        };
-        var callNow = immediate && !timeout;
-        clearTimeout(timeout);
-        timeout = setTimeout(later, wait);
-        if (callNow) func.apply(context, args);
-    };
-};
-
-module.exports = {
-    debounce
-}

package/helpers/formatters.js

@@ -1,27 +0,0 @@
-function humanFileSize(bytes, si = false, dp = 1) {
-    const thresh = si ? 1000 : 1024;
-
-    if (Math.abs(bytes) < thresh) {
-        return bytes + " B";
-    }
-
-    const units = si
-        ? ["kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"]
-        : ["KiB", "MiB", "GiB", "TiB", "PiB", "EiB", "ZiB", "YiB"];
-    let u = -1;
-    const r = 10 ** dp;
-
-    do {
-        bytes /= thresh;
-        ++u;
-    } while (
-        Math.round(Math.abs(bytes) * r) / r >= thresh &&
-        u < units.length - 1
-    );
-
-    return bytes.toFixed(dp) + " " + units[u];
-}
-
-module.exports = {
-    humanFileSize
-}

package/helpers/objHelpers.js

@@ -1,53 +0,0 @@
-function deepClone(obj) {
-    const clone = obj instanceof Array ? Object.assign([]) : Object.assign({});
-    for (const i in obj) {
-        if (obj[i] != null && typeof (obj[i]) == 'object' && !(obj[i] instanceof File) && !(obj[i] instanceof Date)) {
-            clone[i] = deepClone(obj[i]);
-        } else {
-            clone[i] = obj[i];
-        }
-    }
-    return clone;
-}
-
-function getPointed(obj, kpointed, def) {
-    const result = kpointed.split(".").reduce((o, k) => typeof (o) == 'object' ? o[k] : o, obj)
-    return result === undefined ? def : result
-}
-
-function setPointed(obj, kpointed, val) {
-    const arr = typeof kpointed == 'string' ? kpointed.split(".") : kpointed
-    if (arr.length == 1) {
-        obj[arr[0]] = val
-        return obj
-    }
-    obj[arr[0]] = obj[arr[0]] || {}
-    return setPointed(obj[arr[0]], arr.slice(1), val)
-}
-
-function filterObj(obj, kpointedArr) {
-    return (kpointedArr || []).reduce((acc, kpointed) => {
-        setPointed(acc, kpointed, getPointed(obj, kpointed))
-        return acc
-    }, {})
-}
-function diffObjs(obj1, obj2) {
-    const a = deepClone(obj1)
-    const b = deepClone(obj2)
-    for (const i in b){
-        if (JSON.stringify(a[i]) === JSON.stringify(b[i])){
-            delete b[i]
-        } else if (!Array.isArray(b[i]) && typeof b[i] == 'object') {
-            b[i] = diffObjs(a[i], b[i])
-        }
-    }
-    return b;
-}
-
-module.exports = {
-    deepClone,
-    getPointed,
-    setPointed,
-    filterObj,
-    diffObjs
-}

package/index.js

@@ -1,11 +0,0 @@
-const auth = require('./helpers/auth');
-const debounce = require('./helpers/debounce');
-const formatters = require('./helpers/formatters');
-const objHelpers = require('./helpers/objHelpers');
-
-module.exports = {
-    auth,
-    debounce,
-    formatters,
-    objHelpers
-}

package/loaders/dummy-loader.js

@@ -1 +0,0 @@
-module.exports = function (source, map) { this.callback(null, "export default function (Component) {}", map) }