geoserver-node-client 1.6.2 → 2.0.0

package/dist/types/src/util/geoserver.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Utility functions and classes
+ */
+/**
+ * Return the GeoServer response text if available.
+ *
+ * @param {Response} response The response of the GeoServer
+ *
+ * @returns {String} The response text if available
+ */
+export function getGeoServerResponseText(response: Response): string;
+/**
+ * Generic GeoServer error
+ */
+export class GeoServerResponseError extends Error {
+    /**
+     * @param {String} [message=GeoServer Response Error] The error message
+     * @param {String} [geoServerOutput] The error output from GeoServer (useful for debugging)
+     */
+    constructor(message?: string, geoServerOutput?: string);
+    geoServerOutput: string | undefined;
+}

package/dist/types/src/workspace.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Client for GeoServer workspaces
+ *
+ * @module WorkspaceClient
+ */
+export default class WorkspaceClient {
+    /**
+     * Creates a GeoServer REST WorkspaceClient instance.
+     *
+     * WARNING: For most cases the 'NameSpaceClient' seems to fit better.
+     *
+     * @param {String} url The URL of the GeoServer REST API endpoint
+     * @param {String} auth The Basic Authentication string
+     */
+    constructor(url: string, auth: string);
+    url: string;
+    auth: string;
+    /**
+     * Returns all workspaces.
+     *
+     * @throws Error if request fails
+     *
+     * @returns {Object} An Object describing the workspaces
+     */
+    getAll(): Object;
+    /**
+     * Returns a workspace.
+     *
+     * @param {String} name Name of the workspace
+     *
+     * @throws Error if request fails
+     *
+     * @returns {Object} An object describing the workspaces
+     */
+    get(name: string): Object;
+    /**
+     * Creates a new workspace.
+     *
+     * @param {String} name Name of the new workspace
+     *
+     * @throws Error if request fails
+     *
+     * @returns {String} The name of the created workspace
+     */
+    create(name: string): string;
+    /**
+     * Deletes a workspace.
+     *
+     * @param {String} name Name of the workspace to delete
+     * @param {Boolean} recurse Flag to enable recursive deletion
+     *
+     * @throws Error if request fails
+     */
+    delete(name: string, recurse: boolean): Promise<void>;
+}

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "geoserver-node-client",
-  "version": "1.6.2",
+  "version": "2.0.0",
   "description": "Node.js client for GeoServer REST API",
   "type": "module",
   "main": "geoserver-rest-client.js",
+  "types": "./dist/types/geoserver-rest-client.d.ts",
   "scripts": {
     "demo": "node demo/index.js",
     "docs": "./node_modules/.bin/jsdoc geoserver-rest-client.js src/*.js DOCS_HOME.md && cp img/*.png out/",
@@ -14,14 +15,18 @@
     "test:reset-gs": "node test/reset-gs.js",
     "release": "release-it",
     "release:dry": "release-it --dry-run",
-    "build": "npm run build:clean && npm run build:babel && npm run build:fixup",
+    "build": "npm run build:clean && npm run build:babel && npm run build:types && npm run build:fixup",
     "build:clean": "rm -rf dist",
     "build:babel": "babel geoserver-rest-client.js -d dist && babel src -d dist/src",
+    "build:types": "tsc -p tsconfig.json",
     "build:fixup": "node scripts/create-custom-package-json.js"
   },
   "exports": {
-    "import": "./geoserver-rest-client.js",
-    "require": "./dist/geoserver-rest-client.js"
+    ".": {
+      "types": "./dist/types/geoserver-rest-client.d.ts",
+      "import": "./geoserver-rest-client.js",
+      "require": "./dist/geoserver-rest-client.js"
+    }
   },
   "files": [
     "geoserver-rest-client.js",
@@ -45,6 +50,7 @@
     "@babel/plugin-transform-runtime": "^8.0.0",
     "@babel/preset-env": "^8.0.0",
     "@eslint/compat": "^2.0.0",
+    "@types/node": "^26.0.0",
     "chai": "^6.0.1",
     "eslint": "^9.29.0",
     "eslint-config-prettier": "^10.1.5",
@@ -53,6 +59,7 @@
     "mocha": "^11.7.1",
     "neostandard": "^0.13.0",
     "prettier": "^3.6.1",
-    "release-it": "^20.0.0"
+    "release-it": "^20.0.0",
+    "typescript": "^6.0.3"
   }
 }

package/src/datastore.js

@@ -214,7 +214,7 @@ export default class DatastoreClient {
    * @param {String} coverageStore The name of the new GeoTIFF store
    * @param {String} layerName The published name of the new layer
    * @param {String} layerTitle The published title of the new layer
-   * @param {Stream} readStream The stream of the GeoTIFF file
+   * @param {fs.ReadStream} readStream The stream of the GeoTIFF file
    * @param {Number} fileSizeInBytes The number of bytes of the stream
    *
    * @throws Error if request fails

package/src/layer.js

@@ -254,11 +254,11 @@ export default class LayerClient {
    * Publishes a FeatureType in the default data store of the workspace.
    *
    * @param {String} workspace Workspace to publish FeatureType in
-   * @param {String} [nativeName] Native name of FeatureType
-   * @param {String} name Published name of FeatureType
-   * @param {String} [title] Published title of FeatureType
+   * @param {String} nativeName Native name of FeatureType
+   * @param {String} [name] Published name of FeatureType, defaults to `nativeName`
+   * @param {String} [title] Published title of FeatureType, defaults to `name` or `nativeName`
    * @param {String} [srs="EPSG:4326"] The SRS of the FeatureType
-   * @param {String} enabled Flag to enable FeatureType by default
+   * @param {Boolean} [enabled=true] Flag to enable FeatureType by default
    * @param {String} [abstract] The abstract of the layer
    *
    * @throws Error if request fails
@@ -274,11 +274,11 @@ export default class LayerClient {
   ) {
     const body = {
       featureType: {
-        name: name,
-        nativeName: nativeName || name,
-        title: title || name,
+        nativeName: nativeName,
+        name: name || nativeName,
+        title: title || name || nativeName,
         srs: srs || 'EPSG:4326',
-        enabled: enabled,
+        enabled: typeof enabled === 'boolean' ? enabled : true,
         abstract: abstract || ''
       }
     };
@@ -304,11 +304,11 @@ export default class LayerClient {
    *
    * @param {String} workspace Workspace to publish FeatureType in
    * @param {String} dataStore The datastore where the FeatureType's data is in
-   * @param {String} [nativeName] Native name of FeatureType
-   * @param {String} name Published name of FeatureType
-   * @param {String} [title] Published title of FeatureType
+   * @param {String} nativeName Native name of FeatureType
+   * @param {String} [name] Published name of FeatureType, defaults to `nativeName`
+   * @param {String} [title] Published title of FeatureType, defaults to `name` or `nativeName`
    * @param {String} [srs="EPSG:4326"] The SRS of the FeatureType
-   * @param {String} enabled Flag to enable FeatureType by default
+   * @param {Boolean} [enabled=true] Flag to enable FeatureType by default
    * @param {String} [abstract] The abstract of the layer
    * @param {String} [nativeBoundingBox] The native BoundingBox of the FeatureType (has to be set if no data is in store at creation time)
    *
@@ -335,11 +335,11 @@ export default class LayerClient {
 
     const body = {
       featureType: {
-        name: name || nativeName,
         nativeName: nativeName,
-        title: title || name,
+        name: name || nativeName,
+        title: title || name || nativeName,
         srs: srs || 'EPSG:4326',
-        enabled: enabled,
+        enabled: typeof enabled === 'boolean' ? enabled : true,
         abstract: abstract || '',
         nativeBoundingBox: nativeBoundingBox
       }
@@ -449,10 +449,10 @@ export default class LayerClient {
    * @param {String} workspace Workspace to publish WMS layer in
    * @param {String} dataStore The datastore where the WMS is connected
    * @param {String} nativeName Native name of WMS layer
-   * @param {String} [name] Published name of WMS layer
-   * @param {String} [title] Published title of WMS layer
+   * @param {String} [name] Published name of WMS layer, defaults to `nativeName`
+   * @param {String} [title] Published title of WMS layer, defaults to `name` or `nativeName`
    * @param {String} [srs="EPSG:4326"] The SRS of the WMS layer
-   * @param {String} enabled Flag to enable WMS layer by default
+   * @param {Boolean} [enabled=true] Flag to enable WMS layer by default
    * @param {String} [abstract] The abstract of the layer
    *
    * @throws Error if request fails
@@ -460,11 +460,11 @@ export default class LayerClient {
   async publishWmsLayer(workspace, dataStore, nativeName, name, title, srs, enabled, abstract) {
     const body = {
       wmsLayer: {
-        name: name || nativeName,
         nativeName: nativeName,
+        name: name || nativeName,
         title: title || name || nativeName,
         srs: srs || 'EPSG:4326',
-        enabled: enabled,
+        enabled: typeof enabled === 'boolean' ? enabled : true,
         abstract: abstract || ''
       }
     };
@@ -494,10 +494,10 @@ export default class LayerClient {
    * @param {String} workspace Workspace to publish layer in
    * @param {String} coverageStore The coveragestore where the layer's data is in
    * @param {String} nativeName Native name of raster
-   * @param {String} name Published name of layer
-   * @param {String} [title] Published title of layer
+   * @param {String} [name] Published name of layer, defaults to `nativeName`
+   * @param {String} [title] Published title of layer, defaults to `name` or `nativeName`
    * @param {String} [srs="EPSG:4326"] The SRS of the layer
-   * @param {String} enabled Flag to enable layer by default
+   * @param {Boolean} [enabled=true] Flag to enable layer by default
    * @param {String} [abstract] The abstract of the layer
    *
    * @throws Error if request fails
@@ -505,9 +505,9 @@ export default class LayerClient {
   async publishDbRaster(workspace, coverageStore, nativeName, name, title, srs, enabled, abstract) {
     const body = {
       coverage: {
-        name: name || nativeName,
         nativeName: nativeName,
-        title: title || name,
+        name: name || nativeName,
+        title: title || name || nativeName,
         srs: srs,
         enabled: enabled,
         abstract: abstract || ''