ropegeo-common 1.2.5 → 1.2.6

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export type { RopewikiImageView } from './types/api/getRopewikiPageView/ropewiki
 export type { RopewikiBetaSectionView } from './types/api/getRopewikiPageView/ropewikiBetaSectionView';
 export type { RopewikiPageView } from './types/api/getRopewikiPageView/ropewikiPageView';
 export { Cursor, CursorType } from './types/cursors/cursor';
+export { CursorPaginationParams } from './types/params/cursorPaginationParams';
 export { SearchCursor } from './types/cursors/searchCursor';
 export type { SearchCursorType } from './types/cursors/searchCursor';
 export { SearchParams } from './types/api/search/searchParams';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,YAAY,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AACvG,YAAY,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AACzF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAC;AAC1F,YAAY,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,4BAA4B,EAAE,MAAM,oEAAoE,CAAC;AAClH,OAAO,EAAE,4BAA4B,EAAE,MAAM,oEAAoE,CAAC;AAClH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6DAA6D,CAAC;AACtG,YAAY,EAAE,0BAA0B,EAAE,MAAM,6DAA6D,CAAC;AAC9G,OAAO,EAAE,0BAA0B,EAAE,MAAM,gEAAgE,CAAC;AAC5G,OAAO,EAAE,0BAA0B,EAAE,MAAM,gEAAgE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,YAAY,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AACvG,YAAY,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AACzF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAC;AAC1F,YAAY,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,4BAA4B,EAAE,MAAM,oEAAoE,CAAC;AAClH,OAAO,EAAE,4BAA4B,EAAE,MAAM,oEAAoE,CAAC;AAClH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6DAA6D,CAAC;AACtG,YAAY,EAAE,0BAA0B,EAAE,MAAM,6DAA6D,CAAC;AAC9G,OAAO,EAAE,0BAA0B,EAAE,MAAM,gEAAgE,CAAC;AAC5G,OAAO,EAAE,0BAA0B,EAAE,MAAM,gEAAgE,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RopewikiRegionImagesResult = exports.RopewikiRegionImagesParams = exports.RopewikiRegionImageView = exports.RegionImagesCursor = exports.RopewikiRegionPreviewsResult = exports.RopewikiRegionPreviewsParams = exports.RegionPreviewsCursor = exports.RopewikiRegionView = exports.SearchResults = exports.SearchParams = exports.SearchCursor = exports.CursorType = exports.Cursor = exports.RoutesParams = exports.RoutesGeojson = exports.RouteType = exports.Route = exports.RegionPreview = exports.PagePreview = exports.PreviewType = exports.Preview = exports.PermitStatus = exports.DifficultyWater = exports.DifficultyTime = exports.DifficultyTechnical = exports.DifficultyRisk = exports.Difficulty = exports.PageDataSource = void 0;
+exports.RopewikiRegionImagesResult = exports.RopewikiRegionImagesParams = exports.RopewikiRegionImageView = exports.RegionImagesCursor = exports.RopewikiRegionPreviewsResult = exports.RopewikiRegionPreviewsParams = exports.RegionPreviewsCursor = exports.RopewikiRegionView = exports.SearchResults = exports.SearchParams = exports.SearchCursor = exports.CursorPaginationParams = exports.CursorType = exports.Cursor = exports.RoutesParams = exports.RoutesGeojson = exports.RouteType = exports.Route = exports.RegionPreview = exports.PagePreview = exports.PreviewType = exports.Preview = exports.PermitStatus = exports.DifficultyWater = exports.DifficultyTime = exports.DifficultyTechnical = exports.DifficultyRisk = exports.Difficulty = exports.PageDataSource = void 0;
 var pageDataSource_1 = require("./types/pageDataSource");
 Object.defineProperty(exports, "PageDataSource", { enumerable: true, get: function () { return pageDataSource_1.PageDataSource; } });
 var difficulty_1 = require("./types/difficulty");
@@ -28,6 +28,8 @@ Object.defineProperty(exports, "RoutesParams", { enumerable: true, get: function
 var cursor_1 = require("./types/cursors/cursor");
 Object.defineProperty(exports, "Cursor", { enumerable: true, get: function () { return cursor_1.Cursor; } });
 Object.defineProperty(exports, "CursorType", { enumerable: true, get: function () { return cursor_1.CursorType; } });
+var cursorPaginationParams_1 = require("./types/params/cursorPaginationParams");
+Object.defineProperty(exports, "CursorPaginationParams", { enumerable: true, get: function () { return cursorPaginationParams_1.CursorPaginationParams; } });
 var searchCursor_1 = require("./types/cursors/searchCursor");
 Object.defineProperty(exports, "SearchCursor", { enumerable: true, get: function () { return searchCursor_1.SearchCursor; } });
 var searchParams_1 = require("./types/api/search/searchParams");

package/dist/types/api/getRopewikiRegionImages/ropewikiRegionImagesParams.d.ts

@@ -1,18 +1,13 @@
+import { CursorPaginationParams } from '../../params/cursorPaginationParams';
 import { RegionImagesCursor } from '../../cursors/regionImagesCursor';
 /**
  * Validated params for getRopewikiRegionImages (GET /ropewiki/region/{id}/images).
  * Cursor is stored decoded (RegionImagesCursor | null).
  * The constructor accepts an encoded cursor string and decodes it.
  */
-export declare class RopewikiRegionImagesParams {
-    readonly limit: number;
-    readonly cursor: RegionImagesCursor | null;
-    constructor(limit: number, cursorEncoded: string | null);
-    /**
-     * Returns an object suitable for use as query string parameters.
-     * Cursor is encoded for the query string.
-     */
-    toQueryStringParams(): Record<string, string>;
+export declare class RopewikiRegionImagesParams extends CursorPaginationParams<RegionImagesCursor> {
+    constructor(limit: number, cursorEncoded?: string);
+    withCursor(cursorEncoded: string | null): RopewikiRegionImagesParams;
     /**
      * Parses query string parameters and returns validated params.
      * Validation is performed by the constructor.

package/dist/types/api/getRopewikiRegionImages/ropewikiRegionImagesParams.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ropewikiRegionImagesParams.d.ts","sourceRoot":"","sources":["../../../../src/types/api/getRopewikiRegionImages/ropewikiRegionImagesParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAItE;;;;GAIG;AACH,qBAAa,0BAA0B;IACnC,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;gBAEtC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IA0BvD;;;OAGG;IACH,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAU7C;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CACxB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,0BAA0B;CAOhC"}
+{"version":3,"file":"ropewikiRegionImagesParams.d.ts","sourceRoot":"","sources":["../../../../src/types/api/getRopewikiRegionImages/ropewikiRegionImagesParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAItE;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,sBAAsB,CAAC,kBAAkB,CAAC;gBAC1E,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;IAsBjD,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,0BAA0B;IAOpE;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CACxB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,0BAA0B;CAOhC"}

package/dist/types/api/getRopewikiRegionImages/ropewikiRegionImagesParams.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RopewikiRegionImagesParams = void 0;
+const cursorPaginationParams_1 = require("../../params/cursorPaginationParams");
 const regionImagesCursor_1 = require("../../cursors/regionImagesCursor");
 const DEFAULT_LIMIT = 20;
 /**
@@ -8,7 +9,7 @@ const DEFAULT_LIMIT = 20;
  * Cursor is stored decoded (RegionImagesCursor | null).
  * The constructor accepts an encoded cursor string and decodes it.
  */
-class RopewikiRegionImagesParams {
+class RopewikiRegionImagesParams extends cursorPaginationParams_1.CursorPaginationParams {
     constructor(limit, cursorEncoded) {
         const limitNum = Number(limit);
         if (Number.isNaN(limitNum) ||
@@ -16,31 +17,17 @@ class RopewikiRegionImagesParams {
             limitNum < 1) {
             throw new Error('Query parameter "limit" must be a whole number greater than 0');
         }
-        this.limit = limit;
-        if (cursorEncoded === null || cursorEncoded === '') {
-            this.cursor = null;
-        }
-        else {
-            try {
-                this.cursor = regionImagesCursor_1.RegionImagesCursor.decodeBase64(cursorEncoded);
-            }
-            catch {
-                throw new Error('Invalid or malformed query parameter: cursor');
-            }
+        const cursorNorm = cursorEncoded === undefined || cursorEncoded === null || cursorEncoded === ''
+            ? null
+            : cursorEncoded;
+        let cursor = null;
+        if (cursorNorm !== null) {
+            cursor = regionImagesCursor_1.RegionImagesCursor.decodeBase64(cursorNorm);
         }
+        super(limitNum, cursor);
     }
-    /**
-     * Returns an object suitable for use as query string parameters.
-     * Cursor is encoded for the query string.
-     */
-    toQueryStringParams() {
-        const params = {
-            limit: String(this.limit),
-        };
-        if (this.cursor !== null) {
-            params.cursor = this.cursor.encodeBase64();
-        }
-        return params;
+    withCursor(cursorEncoded) {
+        return new RopewikiRegionImagesParams(this.limit, cursorEncoded === null || cursorEncoded === '' ? undefined : cursorEncoded);
     }
     /**
      * Parses query string parameters and returns validated params.
@@ -50,7 +37,7 @@ class RopewikiRegionImagesParams {
         const limitParam = q.limit ?? q.Limit ?? '';
         const limit = limitParam === '' ? DEFAULT_LIMIT : Number(limitParam);
         const cursorRaw = (q.cursor ?? q.Cursor ?? '').trim();
-        const cursorEncoded = cursorRaw === '' ? null : cursorRaw;
+        const cursorEncoded = cursorRaw === '' ? undefined : cursorRaw;
         return new RopewikiRegionImagesParams(limit, cursorEncoded);
     }
 }

package/dist/types/api/getRopewikiRegionPreviews/ropewikiRegionPreviewsParams.d.ts

@@ -1,18 +1,13 @@
+import { CursorPaginationParams } from '../../params/cursorPaginationParams';
 import { RegionPreviewsCursor } from '../../cursors/regionPreviewsCursor';
 /**
  * Validated params for getRopewikiRegionPreviews (GET /ropewiki/region/{id}/previews).
  * Cursor is stored decoded (RegionPreviewsCursor | null).
  * The constructor accepts an encoded cursor string and decodes it.
  */
-export declare class RopewikiRegionPreviewsParams {
-    readonly limit: number;
-    readonly cursor: RegionPreviewsCursor | null;
-    constructor(limit: number, cursorEncoded: string | null);
-    /**
-     * Returns an object suitable for use as query string parameters.
-     * Cursor is encoded for the query string.
-     */
-    toQueryStringParams(): Record<string, string>;
+export declare class RopewikiRegionPreviewsParams extends CursorPaginationParams<RegionPreviewsCursor> {
+    constructor(limit: number, cursorEncoded?: string);
+    withCursor(cursorEncoded: string | null): RopewikiRegionPreviewsParams;
     /**
      * Parses query string parameters and returns validated params.
      * Validation is performed by the constructor.

package/dist/types/api/getRopewikiRegionPreviews/ropewikiRegionPreviewsParams.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ropewikiRegionPreviewsParams.d.ts","sourceRoot":"","sources":["../../../../src/types/api/getRopewikiRegionPreviews/ropewikiRegionPreviewsParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAI1E;;;;GAIG;AACH,qBAAa,4BAA4B;IACrC,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;gBAExC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IA0BvD;;;OAGG;IACH,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAU7C;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CACxB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,4BAA4B;CAOlC"}
+{"version":3,"file":"ropewikiRegionPreviewsParams.d.ts","sourceRoot":"","sources":["../../../../src/types/api/getRopewikiRegionPreviews/ropewikiRegionPreviewsParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAI1E;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,sBAAsB,CAAC,oBAAoB,CAAC;gBAC9E,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;IAsBjD,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,4BAA4B;IAOtE;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CACxB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,4BAA4B;CAOlC"}

package/dist/types/api/getRopewikiRegionPreviews/ropewikiRegionPreviewsParams.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RopewikiRegionPreviewsParams = void 0;
+const cursorPaginationParams_1 = require("../../params/cursorPaginationParams");
 const regionPreviewsCursor_1 = require("../../cursors/regionPreviewsCursor");
 const DEFAULT_LIMIT = 20;
 /**
@@ -8,7 +9,7 @@ const DEFAULT_LIMIT = 20;
  * Cursor is stored decoded (RegionPreviewsCursor | null).
  * The constructor accepts an encoded cursor string and decodes it.
  */
-class RopewikiRegionPreviewsParams {
+class RopewikiRegionPreviewsParams extends cursorPaginationParams_1.CursorPaginationParams {
     constructor(limit, cursorEncoded) {
         const limitNum = Number(limit);
         if (Number.isNaN(limitNum) ||
@@ -16,31 +17,17 @@ class RopewikiRegionPreviewsParams {
             limitNum < 1) {
             throw new Error('Query parameter "limit" must be a whole number greater than 0');
         }
-        this.limit = limit;
-        if (cursorEncoded === null || cursorEncoded === '') {
-            this.cursor = null;
-        }
-        else {
-            try {
-                this.cursor = regionPreviewsCursor_1.RegionPreviewsCursor.decodeBase64(cursorEncoded);
-            }
-            catch {
-                throw new Error('Invalid or malformed query parameter: cursor');
-            }
+        const cursorNorm = cursorEncoded === undefined || cursorEncoded === null || cursorEncoded === ''
+            ? null
+            : cursorEncoded;
+        let cursor = null;
+        if (cursorNorm !== null) {
+            cursor = regionPreviewsCursor_1.RegionPreviewsCursor.decodeBase64(cursorNorm);
         }
+        super(limitNum, cursor);
     }
-    /**
-     * Returns an object suitable for use as query string parameters.
-     * Cursor is encoded for the query string.
-     */
-    toQueryStringParams() {
-        const params = {
-            limit: String(this.limit),
-        };
-        if (this.cursor !== null) {
-            params.cursor = this.cursor.encodeBase64();
-        }
-        return params;
+    withCursor(cursorEncoded) {
+        return new RopewikiRegionPreviewsParams(this.limit, cursorEncoded === null || cursorEncoded === '' ? undefined : cursorEncoded);
     }
     /**
      * Parses query string parameters and returns validated params.
@@ -50,7 +37,7 @@ class RopewikiRegionPreviewsParams {
         const limitParam = q.limit ?? q.Limit ?? '';
         const limit = limitParam === '' ? DEFAULT_LIMIT : Number(limitParam);
         const cursorRaw = (q.cursor ?? q.Cursor ?? '').trim();
-        const cursorEncoded = cursorRaw === '' ? null : cursorRaw;
+        const cursorEncoded = cursorRaw === '' ? undefined : cursorRaw;
         return new RopewikiRegionPreviewsParams(limit, cursorEncoded);
     }
 }

package/dist/types/api/getRoutes/routesParams.d.ts

@@ -11,9 +11,9 @@ export declare class RoutesParams {
     } | null;
     constructor(source: PageDataSource | undefined, regionId: string | undefined);
     /**
-     * Returns an object suitable for use as query string parameters.
+     * Returns a URL-encoded query string.
      */
-    toQueryStringParams(): Record<string, string>;
+    toQueryString(): string;
     /**
      * Parses query string parameters and returns validated params.
      * Validation is performed by the constructor.

package/dist/types/api/getRoutes/routesParams.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routesParams.d.ts","sourceRoot":"","sources":["../../../../src/types/api/getRoutes/routesParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,qBAAa,YAAY;IACrB,sEAAsE;IACtE,SAAgB,MAAM,EAAE;QAAE,MAAM,EAAE,cAAc,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;gBAE1D,MAAM,EAAE,cAAc,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS;IAiB5E;;OAEG;IACH,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAU7C;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CACxB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,YAAY;IAWf,OAAO,CAAC,MAAM,CAAC,WAAW;CAQ7B"}
+{"version":3,"file":"routesParams.d.ts","sourceRoot":"","sources":["../../../../src/types/api/getRoutes/routesParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,qBAAa,YAAY;IACrB,sEAAsE;IACtE,SAAgB,MAAM,EAAE;QAAE,MAAM,EAAE,cAAc,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;gBAE1D,MAAM,EAAE,cAAc,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS;IAiB5E;;OAEG;IACH,aAAa,IAAI,MAAM;IAUvB;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CACxB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,YAAY;IAWf,OAAO,CAAC,MAAM,CAAC,WAAW;CAQ7B"}

package/dist/types/api/getRoutes/routesParams.js

@@ -21,16 +21,16 @@ class RoutesParams {
                 : null;
     }
     /**
-     * Returns an object suitable for use as query string parameters.
+     * Returns a URL-encoded query string.
      */
-    toQueryStringParams() {
+    toQueryString() {
         if (this.region === null) {
-            return {};
+            return '';
         }
-        return {
+        return new URLSearchParams({
             source: this.region.source,
             region: this.region.id,
-        };
+        }).toString();
     }
     /**
      * Parses query string parameters and returns validated params.

package/dist/types/api/search/searchParams.d.ts

@@ -1,10 +1,11 @@
+import { CursorPaginationParams } from '../../params/cursorPaginationParams';
 import { SearchCursor } from '../../cursors/searchCursor';
 export type SearchOrder = 'similarity' | 'quality';
 /**
  * Validated search parameters. Cursor is stored decoded (SearchCursor | null).
  * The constructor accepts an encoded cursor string and decodes it.
  */
-export declare class SearchParams {
+export declare class SearchParams extends CursorPaginationParams<SearchCursor> {
     readonly name: string;
     readonly similarityThreshold: number;
     readonly includePages: boolean;
@@ -12,14 +13,12 @@ export declare class SearchParams {
     readonly includeAka: boolean;
     readonly regionId: string | null;
     readonly order: SearchOrder;
-    readonly limit: number;
-    readonly cursor: SearchCursor | null;
-    constructor(name: string, similarityThreshold: number, includePages: boolean, includeRegions: boolean, includeAka: boolean, regionId: string | null, order: SearchOrder, limit: number, cursorEncoded: string | null);
+    constructor(name: string, similarityThreshold: number, includePages: boolean, includeRegions: boolean, includeAka: boolean, regionId: string | null, order: SearchOrder, limit: number, cursorEncoded?: string);
     /**
-     * Returns an object suitable for use as query string parameters.
-     * Cursor is encoded for the query string.
+     * Returns a URL-encoded query string. Cursor is encoded for the query string.
      */
-    toQueryStringParams(): Record<string, string>;
+    toQueryString(): string;
+    withCursor(cursorEncoded: string | null): SearchParams;
     /**
      * Parses query string parameters and returns validated params.
      * Validation is performed by the constructor.

package/dist/types/api/search/searchParams.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"searchParams.d.ts","sourceRoot":"","sources":["../../../../src/types/api/search/searchParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,SAAS,CAAC;AAOnD;;;GAGG;AACH,qBAAa,YAAY;IACrB,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,mBAAmB,EAAE,MAAM,CAAC;IAC5C,SAAgB,YAAY,EAAE,OAAO,CAAC;IACtC,SAAgB,cAAc,EAAE,OAAO,CAAC;IACxC,SAAgB,UAAU,EAAE,OAAO,CAAC;IACpC,SAAgB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;gBAGxC,IAAI,EAAE,MAAM,EACZ,mBAAmB,EAAE,MAAM,EAC3B,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,EACvB,UAAU,EAAE,OAAO,EACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GAAG,IAAI;IAqEhC;;;OAGG;IACH,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAmB7C;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CACxB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,YAAY;IA2Cf;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;CAY9B"}
+{"version":3,"file":"searchParams.d.ts","sourceRoot":"","sources":["../../../../src/types/api/search/searchParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,SAAS,CAAC;AAOnD;;;GAGG;AACH,qBAAa,YAAa,SAAQ,sBAAsB,CAAC,YAAY,CAAC;IAClE,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,mBAAmB,EAAE,MAAM,CAAC;IAC5C,SAAgB,YAAY,EAAE,OAAO,CAAC;IACtC,SAAgB,cAAc,EAAE,OAAO,CAAC;IACxC,SAAgB,UAAU,EAAE,OAAO,CAAC;IACpC,SAAgB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,SAAgB,KAAK,EAAE,WAAW,CAAC;gBAG/B,IAAI,EAAE,MAAM,EACZ,mBAAmB,EAAE,MAAM,EAC3B,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,EACvB,UAAU,EAAE,OAAO,EACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM;IAkE1B;;OAEG;IACH,aAAa,IAAI,MAAM;IAmBvB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY;IActD;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CACxB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,YAAY;IA2Cf;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;CAY9B"}

package/dist/types/api/search/searchParams.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SearchParams = void 0;
+const cursorPaginationParams_1 = require("../../params/cursorPaginationParams");
 const searchCursor_1 = require("../../cursors/searchCursor");
 const DEFAULT_LIMIT = 20;
 /** UUID v4 format: 8-4-4-4-12 hex digits */
@@ -9,7 +10,7 @@ const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12
  * Validated search parameters. Cursor is stored decoded (SearchCursor | null).
  * The constructor accepts an encoded cursor string and decodes it.
  */
-class SearchParams {
+class SearchParams extends cursorPaginationParams_1.CursorPaginationParams {
     constructor(name, similarityThreshold, includePages, includeRegions, includeAka, regionId, order, limit, cursorEncoded) {
         if (typeof name !== 'string' || name.trim() === '') {
             throw new Error('Missing or empty required query parameter: name');
@@ -39,6 +40,14 @@ class SearchParams {
         if (trimmedRegionId !== null && !UUID_REGEX.test(trimmedRegionId)) {
             throw new Error('Query parameter "region" must be a valid UUID');
         }
+        const cursorNorm = cursorEncoded === undefined || cursorEncoded === null || cursorEncoded === ''
+            ? null
+            : cursorEncoded;
+        let cursor = null;
+        if (cursorNorm !== null) {
+            cursor = searchCursor_1.SearchCursor.decodeBase64(cursorNorm);
+        }
+        super(limitNum, cursor);
         this.name = name;
         this.similarityThreshold = similarityThreshold;
         this.includePages = includePages;
@@ -46,24 +55,11 @@ class SearchParams {
         this.includeAka = includeAka;
         this.regionId = trimmedRegionId;
         this.order = order;
-        this.limit = limit;
-        if (cursorEncoded === null || cursorEncoded === '') {
-            this.cursor = null;
-        }
-        else {
-            try {
-                this.cursor = searchCursor_1.SearchCursor.decodeBase64(cursorEncoded);
-            }
-            catch {
-                throw new Error('Invalid or malformed query parameter: cursor');
-            }
-        }
     }
     /**
-     * Returns an object suitable for use as query string parameters.
-     * Cursor is encoded for the query string.
+     * Returns a URL-encoded query string. Cursor is encoded for the query string.
      */
-    toQueryStringParams() {
+    toQueryString() {
         const params = {
             name: this.name,
             similarity: String(this.similarityThreshold),
@@ -79,7 +75,10 @@ class SearchParams {
         if (this.cursor !== null) {
             params.cursor = this.cursor.encodeBase64();
         }
-        return params;
+        return new URLSearchParams(params).toString();
+    }
+    withCursor(cursorEncoded) {
+        return new SearchParams(this.name, this.similarityThreshold, this.includePages, this.includeRegions, this.includeAka, this.regionId, this.order, this.limit, cursorEncoded === null || cursorEncoded === '' ? undefined : cursorEncoded);
     }
     /**
      * Parses query string parameters and returns validated params.
@@ -90,7 +89,7 @@ class SearchParams {
         const limitParam = q.limit ?? q.Limit ?? '';
         const limit = limitParam === '' ? DEFAULT_LIMIT : Number(limitParam);
         const cursorRaw = (q.cursor ?? q.Cursor ?? '').trim();
-        const cursorEncoded = cursorRaw === '' ? null : cursorRaw;
+        const cursorEncoded = cursorRaw === '' ? undefined : cursorRaw;
         const similarityParam = q.similarity ?? q.Similarity ?? '';
         const similarity = similarityParam === '' ? 0.5 : Number(similarityParam);
         const orderParam = (q.order ?? q.Order ?? '').trim().toLowerCase();

package/dist/types/params/cursorPaginationParams.d.ts

@@ -0,0 +1,21 @@
+import { Cursor } from '../cursors/cursor';
+/**
+ * Abstract base for params that paginate with a limit and an optional cursor.
+ * Subclasses specify their own cursor type via the generic.
+ */
+export declare abstract class CursorPaginationParams<C extends Cursor = Cursor> {
+    readonly limit: number;
+    readonly cursor: C | null;
+    constructor(limit: number, cursor: C | null);
+    /**
+     * Returns a URL-encoded query string (e.g. "limit=10" or "limit=10&cursor=...").
+     * Default implementation uses limit and cursor; subclasses with extra params override.
+     */
+    toQueryString(): string;
+    /**
+     * Returns a new params instance with the given cursor (for the next page).
+     * Each subclass implements this.
+     */
+    abstract withCursor(cursorEncoded: string | null): CursorPaginationParams;
+}
+//# sourceMappingURL=cursorPaginationParams.d.ts.map

package/dist/types/params/cursorPaginationParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursorPaginationParams.d.ts","sourceRoot":"","sources":["../../../src/types/params/cursorPaginationParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;;GAGG;AACH,8BAAsB,sBAAsB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;aAE9C,KAAK,EAAE,MAAM;aACb,MAAM,EAAE,CAAC,GAAG,IAAI;gBADhB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,GAAG,IAAI;IAGpC;;;OAGG;IACH,aAAa,IAAI,MAAM;IAUvB;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,sBAAsB;CAC5E"}

package/dist/types/params/cursorPaginationParams.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CursorPaginationParams = void 0;
+/**
+ * Abstract base for params that paginate with a limit and an optional cursor.
+ * Subclasses specify their own cursor type via the generic.
+ */
+class CursorPaginationParams {
+    constructor(limit, cursor) {
+        this.limit = limit;
+        this.cursor = cursor;
+    }
+    /**
+     * Returns a URL-encoded query string (e.g. "limit=10" or "limit=10&cursor=...").
+     * Default implementation uses limit and cursor; subclasses with extra params override.
+     */
+    toQueryString() {
+        const params = {
+            limit: String(this.limit),
+        };
+        if (this.cursor != null) {
+            params.cursor = this.cursor.encodeBase64();
+        }
+        return new URLSearchParams(params).toString();
+    }
+}
+exports.CursorPaginationParams = CursorPaginationParams;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ropegeo-common",
-    "version": "1.2.5",
+    "version": "1.2.6",
     "description": "Shared types and utilities for RopeGeo and WebScraper",
     "license": "ISC",
     "repository": {