parth 4.2.3 → 5.0.0

package/README.md

@@ -6,14 +6,12 @@
 [todo](#todo) -
 [why](#why)
 
-[![build][badge-build]][x-travis]
-
 ## sample
 
 ```js
-var Parth = require('parth');
+import Parth from 'parth';
 
-var parth = new Parth();
+const parth = new Parth();
 var props = {handle: function(){}};
 
 parth.set('(get|post) /:page/:view', props)
@@ -37,11 +35,11 @@ parth.set('(get|post) /:page/:view', props)
 
 ## documentation
 
-The `module.exports` a `Parth` constructor
+Parth exports a `Parth` class (default export)
 
-````js
-var Parth = require('parth');
-````
+```js
+import Parth from 'parth';
+```
 
 which can take the options below
 
@@ -55,7 +53,7 @@ _options_ type `object`, can be
 example:
 
 ```js
-var parth = new Parth({ defaultRE: /[^\s\/?#]+/ });
+const parth = new Parth({ defaultRE: /[^\s\/?#]+/ });
 
 parth.set('/page/:view') // no regex given after ":view"
      .get('/page/10/?query=here')
@@ -124,11 +122,13 @@ _return_
 > NOTE: the returned object is a deep copy of the original `options`
 > given in `parth.set` to avoid mutation
 
-### parth properties
+### TypeScript
 
- - `parth.store`: all paths set for match are here
- - `parth.regex`: array of carefully ordered regexes
- - `parth.regex.master`: regex aggregating all learned
+Parth is written in TypeScript and ships with type definitions. Import types as needed:
+
+```ts
+import Parth, { ParthOptions, ParthResult } from 'parth';
+```
 
 ## why
 
@@ -142,45 +142,23 @@ With [npm](http://npmjs.org)
 
 ### examples
 
-Run the [`example.js`](example.js) file.
+Run the [`example.ts`](example.ts) file: `npx tsx example.ts` (or `npm run dist` then run with Node after changing the import to `./dist`).
 
 ### test
 
     npm test
 
 ```
-➜  parth (master) ✓ npm t
-parth
-  paths
-    ✓ object
-    ✓ raw object paths
-    ✓ unix paths
-    ✓ raw unix paths
-    ✓ urls
-    ✓ raw urls
-    ✓ urls: querystring is stripped
-    ✓ urls: hash is stripped
-    ✓ urls: parameters are not mistaken as querystrings
-    ✓ space separated paths
-    ✓ raw, space separated paths
-    ✓ unix, object and url paths together
-    ✓ raw: unix, object and urls paths together
-  params
-    ✓ can be given as a string regex
-    ✓ will contain all parameter keys at _
-    ✓ parameter values should be at params
-  notFound
-    ✓ should be false for perfect match
-    ✓ should have what is left of the path
-
-
-18 passing (16ms)
+➜  parth npm test
+PASS test/paths.test.ts
+PASS test/params.test.ts
+PASS test/options.test.ts
+PASS test/notFound.test.ts
+
+Test Suites: 4 passed, 4 total
+Tests:       20 passed, 20 total
 ```
 
-### todo
-
- - [ ] set support for regexp input
-
 ### license
 
 The MIT License (MIT)
@@ -194,7 +172,5 @@ The above copyright notice and this permission notice shall be included in all c
 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 THE SOFTWARE.
 
 [x-npm]: https://npmjs.org/package/parth
-[x-travis]: https://travis-ci.org/stringparser/parth/builds
-[badge-build]: http://img.shields.io/travis/stringparser/parth/master.svg?style=flat-square
 [badge-version]: http://img.shields.io/npm/v/parth.svg?style=flat-square
 [badge-downloads]: http://img.shields.io/npm/dm/parth.svg?style=flat-square

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import type { ParthOptions, ParthResult, PathOpt } from './types';
+export type { ParthOptions, ParthResult };
+export declare class Parth {
+    #private;
+    constructor(options?: ParthOptions);
+    set(path: string, opt?: Partial<PathOpt>): this;
+    get(path: string): ParthResult | null;
+}
+export default Parth;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,OAAO,EAGR,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AAO1C,qBAAa,KAAK;;gBAIJ,OAAO,CAAC,EAAE,YAAY;IAUlC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IA8D/C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;CAwCtC;AAED,eAAe,KAAK,CAAC"}

package/dist/index.js

@@ -0,0 +1,145 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Parth_store, _Parth_regex;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Parth = void 0;
+const _ = __importStar(require("./lib"));
+const qshRE = /[?#][^/\s]*/g;
+const depthRE = /((^|[/?#.\s]+)[(:\w])/g;
+const paramRE = /:([-\w]+)(\([^\s]+?[)][?)]*)?/g;
+const noParamRE = /(^|[/.=\s]+)(\(.+?\)+)/g;
+class Parth {
+    constructor(options) {
+        _Parth_store.set(this, {});
+        _Parth_regex.set(this, void 0);
+        __classPrivateFieldSet(this, _Parth_regex, [], "f");
+        __classPrivateFieldGet(this, _Parth_regex, "f").master = new RegExp('(?:[])');
+        __classPrivateFieldGet(this, _Parth_regex, "f").defaultRE = /[^?#./\s]+/;
+        if (options?.defaultRE) {
+            __classPrivateFieldGet(this, _Parth_regex, "f").defaultRE = options.defaultRE;
+        }
+    }
+    set(path, opt) {
+        if (typeof path !== 'string') {
+            return this;
+        }
+        const o = _.cloneDeep(opt || {});
+        o.path = path.replace(/\s+/g, ' ').trim();
+        if (__classPrivateFieldGet(this, _Parth_store, "f")[o.path]) {
+            Object.assign(__classPrivateFieldGet(this, _Parth_store, "f")[o.path], o);
+            return this;
+        }
+        __classPrivateFieldGet(this, _Parth_regex, "f").push((__classPrivateFieldGet(this, _Parth_store, "f")[o.path] = o));
+        let index = -1;
+        const defaultRE = '(' + __classPrivateFieldGet(this, _Parth_regex, "f").defaultRE.source + ')';
+        o.stem = o.path.replace(noParamRE, function ($0, $1, $2) {
+            return $1 + ':' + (++index) + $2;
+        });
+        const url = (o.stem.match(/[^\s]*\/\S*/) || [null]).pop();
+        const qsh = _.getQueryString(url);
+        if (url && !qsh) {
+            o.stem = o.stem.replace(url, url.replace(/\/$/, '$1') + ':qs(?:\\/)?(' + qshRE.source + ')?');
+        }
+        o.depth = o.stem.split(depthRE).length || -1;
+        o.regex = new RegExp('^' +
+            o
+                .stem.replace(/\S+/g, function (s) {
+                return s.replace(paramRE, function ($0, $1, $2) {
+                    return $2 || defaultRE;
+                });
+            })
+                .replace(/[^?( )+*$]+(?=\(|$)/g, function escapeRegExp($0) {
+                return $0.replace(/[\\^$.*+?()[\]{}|]/g, '\\$&');
+            }));
+        __classPrivateFieldGet(this, _Parth_regex, "f").sort(function (x, y) {
+            return y.depth - x.depth || y.stem.localeCompare(x.stem);
+        });
+        __classPrivateFieldGet(this, _Parth_regex, "f").master = new RegExp('(' +
+            __classPrivateFieldGet(this, _Parth_regex, "f")
+                .map(function (el) {
+                return el.regex.source.replace(/\((?=[^?])/g, '(?:');
+            })
+                .join(')|(') +
+            ')');
+        return this;
+    }
+    get(path) {
+        if (typeof path !== 'string') {
+            return null;
+        }
+        path = path.replace(/\s+/g, ' ').trim();
+        if (__classPrivateFieldGet(this, _Parth_store, "f")[path]) {
+            return Object.assign(_.cloneDeep(__classPrivateFieldGet(this, _Parth_store, "f")[path]), {
+                match: path,
+                notFound: '',
+                params: {},
+            });
+        }
+        const found = __classPrivateFieldGet(this, _Parth_regex, "f").master.exec(path);
+        if (!found) {
+            return null;
+        }
+        const o = {
+            match: found.shift(),
+            params: {},
+            notFound: '',
+        };
+        const matchIndex = found.indexOf(o.match);
+        const foundEntry = __classPrivateFieldGet(this, _Parth_regex, "f")[matchIndex];
+        o.notFound = path.slice(o.match.length);
+        let paramIndex = -1;
+        const params = foundEntry.regex.exec(path).slice(1);
+        foundEntry.stem.replace(paramRE, function ($0, $1) {
+            o.params[$1] = params[++paramIndex];
+            return $0;
+        });
+        return Object.assign(_.cloneDeep(foundEntry), o);
+    }
+}
+exports.Parth = Parth;
+_Parth_store = new WeakMap(), _Parth_regex = new WeakMap();
+exports.default = Parth;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yCAA2B;AAW3B,MAAM,KAAK,GAAG,cAAc,CAAC;AAC7B,MAAM,OAAO,GAAG,wBAAwB,CAAC;AACzC,MAAM,OAAO,GAAG,gCAAgC,CAAC;AACjD,MAAM,SAAS,GAAG,yBAAyB,CAAC;AAE5C,MAAa,KAAK;IAIhB,YAAY,OAAsB;QAHlC,uBAAkC,EAAE,EAAC;QACrC,+BAAmB;QAGjB,uBAAA,IAAI,gBAAU,EAA2B,MAAA,CAAC;QAC1C,uBAAA,IAAI,oBAAO,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1C,uBAAA,IAAI,oBAAO,CAAC,SAAS,GAAG,YAAY,CAAC;QAErC,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;YACvB,uBAAA,IAAI,oBAAO,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,GAAsB;QACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,CAAY,CAAC;QAC5C,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAE1C,IAAI,uBAAA,IAAI,oBAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,MAAM,CAAC,uBAAA,IAAI,oBAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,uBAAA,IAAI,oBAAO,CAAC,IAAI,CAAC,CAAC,uBAAA,IAAI,oBAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAe,CAAC,CAAC;QAE1D,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;QACf,MAAM,SAAS,GAAG,GAAG,GAAG,uBAAA,IAAI,oBAAO,CAAC,SAAS,CAAC,MAAM,GAAG,GAAG,CAAC;QAE3D,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,EAAU,EAAE,EAAU;YACrE,OAAO,EAAE,GAAG,GAAG,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAK,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC3D,MAAM,GAAG,GAAG,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAChB,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAK,CAAC,OAAO,CACtB,GAAG,EACH,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,cAAc,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAChE,CAAC;QACJ,CAAC;QAED,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;QAC9C,CAAC,CAAC,KAAK,GAAG,IAAI,MAAM,CAClB,GAAG;YACD,CAAC;iBACE,IAAK,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC;gBAChC,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE;oBAC5C,OAAO,EAAE,IAAI,SAAS,CAAC;gBACzB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC;iBACD,OAAO,CAAC,sBAAsB,EAAE,SAAS,YAAY,CAAC,EAAE;gBACvD,OAAO,EAAE,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC,CAAC,CACP,CAAC;QAEF,uBAAA,IAAI,oBAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,uBAAA,IAAI,oBAAO,CAAC,MAAM,GAAG,IAAI,MAAM,CAC7B,GAAG;YACD,uBAAA,IAAI,oBAAO;iBACR,GAAG,CAAC,UAAU,EAAE;gBACf,OAAO,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;YACvD,CAAC,CAAC;iBACD,IAAI,CAAC,KAAK,CAAC;YACd,GAAG,CACN,CAAC;QAEF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,IAAY;QACd,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAExC,IAAI,uBAAA,IAAI,oBAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,uBAAA,IAAI,oBAAO,CAAC,IAAI,CAAC,CAAC,EAAE;gBACnD,KAAK,EAAE,IAAI;gBACX,QAAQ,EAAE,EAAE;gBACZ,MAAM,EAAE,EAAE;aACX,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,uBAAA,IAAI,oBAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,CAAC,GAAgB;YACrB,KAAK,EAAE,KAAK,CAAC,KAAK,EAAG;YACrB,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAG,uBAAA,IAAI,oBAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAExC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC;QACpB,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAErD,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE;YAC/C,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC;YACpC,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;CACF;AApHD,sBAoHC;;AAED,kBAAe,KAAK,CAAC"}

package/dist/lib.d.ts

@@ -0,0 +1,4 @@
+import cloneDeep from 'lodash.clonedeep';
+export { cloneDeep };
+export declare function getQueryString(url: string | null | undefined): string | null;
+//# sourceMappingURL=lib.d.ts.map

package/dist/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAY5E"}

package/dist/lib.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cloneDeep = void 0;
+exports.getQueryString = getQueryString;
+const lodash_clonedeep_1 = __importDefault(require("lodash.clonedeep"));
+exports.cloneDeep = lodash_clonedeep_1.default;
+function getQueryString(url) {
+    if (!url) {
+        return null;
+    }
+    const index = url.indexOf('?');
+    if (index > -1 && url.charAt(index + 1) !== ':') {
+        return url.substring(index);
+    }
+    else {
+        return null;
+    }
+}
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":";;;;;;AAIA,wCAYC;AAhBD,wEAAyC;AAEhC,oBAFF,0BAAS,CAEE;AAElB,SAAgB,cAAc,CAAC,GAA8B;IAC3D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAE/B,IAAI,KAAK,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;QAChD,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -1,13 +1,9 @@
 {
   "name": "parth",
-  "main": "index.js",
-  "version": "4.2.3",
+  "main": "dist/index.js",
+  "version": "5.0.0",
   "engines": {
-    "node": ">= 0.10.0"
-  },
-  "dependencies": {
-    "lodash.clone": "^3.0.3",
-    "lodash.merge": "^3.3.2"
+    "node": ">= 14"
   },
   "author": "Javier Carrillo",
   "description": "path to regex madness",
@@ -17,13 +13,25 @@
     "url": "https://github.com/stringparser/parth/issues"
   },
   "scripts": {
-    "lint": "eslint lib *.js",
-    "test": "npm run lint && mocha test"
+    "lint": "eslint src test example.ts --fix",
+    "test": "jest",
+    "posttest": "npm run verify:publish",
+    "dist": "tsc",
+    "prepublishOnly": "npm run dist",
+    "verify:publish": "bash test/verify-publish/test.sh"
   },
   "devDependencies": {
-    "mocha": "*",
-    "should": "*",
-    "eslint": "*"
+    "@types/jest": "30.0.0",
+    "@types/lodash.clonedeep": "4.5.8",
+    "@types/node": "25.2.1",
+    "eslint": "^9.39.2",
+    "jest": "30.2.0",
+    "ts-jest": "29.4.6",
+    "typescript": "5.9.3",
+    "typescript-eslint": "^8.54.0"
+  },
+  "dependencies": {
+    "lodash.clonedeep": "4.5.0"
   },
   "keywords": [
     "url",
@@ -34,5 +42,9 @@
     "params",
     "cached"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ]
 }

package/.editorconfig

@@ -1,14 +0,0 @@
-
-# editorconfig.org
-root = true
-
-[*]
-indent_style = space
-indent_size = 2
-end_of_line = lf
-charset = utf-8
-trim_trailing_whitespace = true
-insert_final_newline = true
-
-[*.md]
-trim_trailing_whitespace = false

package/.eslintrc

@@ -1,23 +0,0 @@
-{
-  "env": {
-    "node": true,
-    "mocha": true
-  },
-  "rules": {
-    "strict": 2,
-    "quotes": [2, "single", "avoid-escape"],
-    "indent": ["error", 2, {"SwitchCase": 1}],
-    "eol-last": 2,
-    "no-shadow": 2,
-    "dot-notation": 2,
-    "dot-location": [2, "property"],
-    "comma-dangle": [2, "never"],
-    "no-unused-vars": 2,
-    "no-multi-spaces": 2,
-    "no-process-exit": 0,
-    "consistent-return": 2,
-    "no-use-before-define": 0,
-    "no-underscore-dangle": 0,
-    "no-unused-expressions": 2
-  }
-}

package/.npmignore

@@ -1 +0,0 @@
-node_modules

package/.travis.yml

@@ -1,7 +0,0 @@
-language: node_js
-node_js:
-  - "0.10"
-  - "4"
-  - "stable"
-notifications:
-  email: true

package/example.js

@@ -1,69 +0,0 @@
-'use strict';
-
-var input, result;
-var parth = require('./.')();
-
-// #set
-input = [
-  '/',
-  '/page',
-  '/page/:number(\\d+)',
-  'get /',
-  'get /page',
-  'get /:page',
-  'get :page/:view',
-  'get /:page/:view',
-  'get /page/:number(\\d+)',
-  'get /:page(\\w+)/number',
-  'get /:page(\\w+)/:number(\\d+)',
-  '(get|post) /page/number',
-  '(get|post) /:page(\\w+)/number',
-  '(get|post) /:page(\\w+)/:Number(\\d+)',
-  'get /page/number',
-  '(get|post) /:page(\\w+)/:view([^.\\/\\s]+)',
-  '1', '2', '1 2',
-  'obj.path',
-  'obj.:path(\\S+).:number(\\d+)',
-  'obj.:number(\\d+).:path(\\S+)',
-  'obj.path.:here',
-  'obj.(prop|path).:here',
-  ':obj.(method|prop).:here'
-
-];
-
-input.forEach(function(stem){
-  parth.set(stem);
-});
-
-// #get
-input = [
-  '1',
-  '2',
-  '1 2',
-  'obj.path.10',
-  'obj.10.prop',
-  'obj.10.10',
-  'array.method.prop',
-  'get weekend/baby?query=string#hash user.10.beers',
-  'get /weekend/baby?query=string#hash user.10.beers now',
-  'get /user/view/#hash',
-  'post /user/page/photo?query=name&path=tree#hash'
-];
-
-console.log(' -- parth.get -- ');
-input.forEach(function(stem, index){
-  result = parth.get(stem);
-  console.log(' input =', stem);
-  console.log('result =', result);
-  console.log((input[index + 1] ? ' -- ' : '' ));
-});
-
-if(process.argv.indexOf('-l') < 0){ return; }
-Object.keys(parth).forEach(function(prop){
-  console.log(parth[prop]);
-  console.log(' --\n');
-});
-
-parth.regex.forEach(function(re){
-  console.log(re.stem);
-});

package/index.js

@@ -1,115 +0,0 @@
-'use strict';
-
-var util = require('./lib/util');
-
-exports = module.exports = Parth;
-
-function Parth(options){
-  if(!(this instanceof Parth)){
-    return new Parth(options);
-  }
-
-  this.store = {};
-  this.regex = [];
-  this.regex.master = new RegExp('(?:[])');
-  this.regex.defaultRE = /[^?#./\s]+/;
-
-  if(options){
-    this.regex.defaultRE = options.defaultRE || this.regex.defaultRE;
-  }
-}
-
-var qshRE = /[?#][^\/\s]*/g;
-var depthRE = /((^|[/?#.\s]+)[(:\w])/g;
-var paramRE = /:([-\w]+)(\([^\s]+?[)][?)]*)?/g;
-var noParamRE = /(^|[/.=\s]+)(\(.+?\)+)/g
-
-Parth.prototype.set = function(path, opt){
-  if(typeof path !== 'string'){
-    return this;
-  }
-
-  var o = util.clone(opt || {}, true);
-  o.path = path.replace(/\s+/g, ' ').trim();
-
-  if(this.store[o.path]){
-    util.merge(this.store[o.path], o);
-    return this;
-  }
-  this.regex.push(this.store[o.path] = o);
-
-  var index = -1;
-  var defaultRE = '(' + this.regex.defaultRE.source + ')';
-
-  o.stem = o.path.replace(noParamRE, function($0, $1, $2){
-    return $1 + ':' + (++index) + $2;
-  });
-
-  var url = (o.stem.match(/[^\s]*\/\S*/) || [null]).pop();
-  var qsh = util.getQueryString(url);
-
-  if(url && !qsh){
-    o.stem = o.stem.replace(url, url.replace(/\/$/, '$1') +
-      ':qs(?:\\/)?(' + qshRE.source + ')?'
-    );
-  }
-
-  o.depth = o.stem.split(depthRE).length || -1;
-  o.regex = new RegExp('^' +
-    o.stem.replace(/\S+/g, function(s){
-      return s.replace(paramRE, function($0, $1, $2){
-        return ($2 || defaultRE);
-      });
-    }).replace(/[^?( )+*$]+(?=\(|$)/g, function escapeRegExp($0){
-      return $0.replace(/[\\^$.*+?()[\]{}|]/g, '\\$&');
-    })
-  );
-
-  // order regexes according to depth (# of separation tokes) or,
-  // if that fails, use localCompare
-
-  this.regex.sort(function(x, y){
-    return (y.depth - x.depth) || y.stem.localeCompare(x.stem);
-  });
-
-  // sum up all learned (void all groups and make a giant regex)
-  this.regex.master = new RegExp( '(' +
-    this.regex.map(function voidRegExp(el){
-      return el.regex.source.replace(/\((?=[^?])/g, '(?:');
-    }).join(')|(') + ')'
-  );
-
-  return this;
-};
-
-Parth.prototype.get = function(path){
-  if(typeof path !== 'string'){
-    return null;
-  }
-
-  path = path.replace(/\s+/g, ' ').trim();
-
-  if(this.store[path]){
-    return util.merge(util.clone(this.store[path], true), {
-      match: path,
-      notFound: ''
-    });
-  }
-
-  var found = this.regex.master.exec(path);
-  if(!found){ return null; }
-
-  var o = {match: found.shift(), params: {}};
-
-  found = this.regex[found.indexOf(o.match)];
-  o.notFound = path.slice(o.match.length);
-
-  var index = -1;
-  var params = found.regex.exec(path).slice(1);
-
-  found.stem.replace(paramRE, function($0, $1){
-    o.params[$1] = params[++index];
-  });
-
-  return util.merge(util.clone(found, true), o);
-};

package/lib/util.js

@@ -1,22 +0,0 @@
-'use strict';
-
-exports = module.exports = {};
-
-// dependencies
-//
-exports.clone = require('lodash.clone');
-exports.merge = require('lodash.merge');
-
-// assorted
-//
-exports.getQueryString = function(url){
-  if(!url){ return null; }
-
-  var index = url.indexOf('?');
-
-  if(index > -1 && url.charAt(index + 1) !== ':'){
-    return url.substring(index);
-  } else {
-    return null;
-  }
-};

package/test/index.js

@@ -1,19 +0,0 @@
-'use strict';
-
-var path = require('path');
-var pack = require('../');
-
-require('should');
-
-[
-  'paths.js',
-  'params.js',
-  'options.js',
-  'notFound.js'
-].forEach(function(file){
-  if(file === 'index.js'){ return; }
-  var suite = path.basename(file, path.extname(file));
-  describe(suite, function(){
-    require('./' + file)(pack);
-  });
-});

package/test/notFound.js

@@ -1,24 +0,0 @@
-'use strict';
-
-var path, stems, result;
-
-module.exports = function(Parth){
-  var parth = new Parth();
-
-  it('should be empty string for perfect match', function(){
-    stems = ':method(get) /hello/:there';
-    path = 'get /hello/awesome?query#hash';
-
-    result = parth.set(stems).get(path);
-    result.should.not.be.eql(null);
-    result.notFound.should.be.eql('');
-  });
-
-  it('should have what is left of the path', function(){
-    stems = ':method(get) /hello/:there';
-    path = 'get /hello/awesome/human';
-    result = parth.set(stems).get(path);
-    result.should.not.be.eql(null);
-    result.notFound.should.be.eql('human');
-  });
-};

package/test/options.js

@@ -1,19 +0,0 @@
-'use strict';
-
-var path, stems, result;
-
-module.exports = function(Parth){
-
-  it('default regex can be changed using options', function(){
-    var parth = new Parth({
-      defaultRE: /\S+/
-    });
-
-    stems = 'do :src :dest';
-    path = 'do /src/**/*.js /dest/';
-
-    result = parth.set(stems).get(path);
-    result.notFound.should.be.eql('');
-    result.regex.source.should.match(/[\\]+S\+/);
-  });
-};

package/test/params.js

@@ -1,59 +0,0 @@
-'use strict';
-
-var stem, path, result;
-
-module.exports = function(Parth){
-  var parth = new Parth();
-
-  it('can be given as part of the input string', function(){
-    stem = 'post /:number(\\d+)';
-    path = 'post /1';
-    result = parth.set(stem).get(path);
-    result.should.have.properties({
-      params: {
-        number: '1'
-      }
-    });
-  });
-
-  it('may not contain labels', function(){
-    stem = '(get|post) /hello/:there/:you';
-    path = 'post /hello/awesome/10';
-    result = parth.set(stem).get(path);
-    result.should.have.properties({
-      params: {
-        '0': 'post',
-        you: '10',
-        there: 'awesome'
-      }
-    });
-  });
-
-  it('query fragment is setup by default for an url', function(){
-    stem = '(get|post) /hello/:there/:you';
-    path = 'post /hello/awesome/10?query=string#here';
-    result = parth.set(stem).get(path);
-    result.should.have.properties({
-      params: {
-        '0': 'post',
-        you: '10',
-        there: 'awesome',
-        qs: '?query=string#here'
-      }
-    });
-  });
-
-  it('querystring may contain parameters', function(){
-    stem = 'post /:page\\/?:query(\\?[^/#\\s]+)?:fragment(#[^?\\s]+)?';
-    path = 'post /page?query=here#hash';
-    result = parth.set(stem).get(path);
-
-    result.should.have.properties({
-      params: {
-        page: 'page',
-        query: '?query=here',
-        fragment: '#hash'
-      }
-    });
-  });
-};

package/test/paths.js

@@ -1,91 +0,0 @@
-'use strict';
-
-var path, match;
-
-function check(result) {
-  result.should.have.properties({
-    path: path,
-    match: match
-  });
-}
-
-module.exports = function(Parth){
-  var parth = new Parth();
-
-  it('object', function(){
-    path = 'hello.:there';
-    match = 'hello.awesome';
-    check(parth.set(path).get(match));
-  });
-
-  it('raw object paths', function(){
-    match = path = 'hello.there';
-    check(parth.set(path).get(match));
-  });
-
-  it('unix paths', function(){
-    path = '/hello/:there/:you';
-    match = '/hello/awesome/human';
-    check(parth.set(path).get(match));
-  });
-
-  it('raw unix paths', function(){
-    path = '/hello/there/you';
-    match = '/hello/there/you?here';
-    check(parth.set(path).get(match));
-  });
-
-  it('urls', function(){
-    path = '/hello/:there';
-    match = '/hello/awesome/?query';
-    check(parth.set(path).get(match));
-  });
-
-  it('raw urls', function(){
-    path = '/hello/there';
-    match = '/hello/there/?query';
-    check(parth.set(path).get(match));
-  });
-
-  it('urls: querystring is stripped', function(){
-    path = 'get page.thing /hello/there';
-    match = 'get page.thing /hello/there/?query';
-    check(parth.set(path).get(match));
-  });
-
-  it('urls: hash is stripped', function(){
-    path = 'get page.thing /hello/there';
-    match = 'get page.thing /hello/there#hello';
-    check(parth.set(path).get(match));
-  });
-
-  it('urls: parameters are not mistaken as querystrings', function(){
-    path = 'get page.thing /hello/:here(?:\\w+you)';
-    match = 'get page.thing /hello/helloyou';
-    check(parth.set(path).get(match));
-  });
-
-  it('space separated paths', function(){
-    path = 'you are an :there :you';
-    match = 'you are an awesome human';
-    check(parth.set(path).get(match));
-  });
-
-  it('raw, space separated paths', function(){
-    match = path = 'you are an there you';
-    check(parth.set(path).get(match));
-  });
-
-  it('unix, object and url paths together', function(){
-    path = 'get page.:thing /hello/:there';
-    match = 'get page.data /hello/awesome/?query';
-    check(parth.set(path).get(match));
-  });
-
-  it('raw: unix, object and urls paths together', function(){
-    path = 'get page.thing /hello/there';
-    match = 'get page.thing /hello/there/?query';
-    check(parth.set(path).get(match));
-  });
-
-};