jmapcloud-ng-core-types 1.0.16 → 1.0.19

package/index.ts

@@ -13,6 +13,7 @@ export interface JCoreService extends JCoreMainService {
   Geometry: JGeometryService
   MouseOver: JMouseOverService
   Form: JFormService
+  FormJMC: JFormJMCService
   Query: JQueryService
   Event: JEventService
   History: JHistoryService
@@ -154,6 +155,7 @@ export interface JFeatureService {
   // TODO: see if the future endpoint will return detail about individual deleted features success or failure
   // https://k2geospatial.atlassian.net/browse/JMAP8-1589
   deleteByIds(layerId: JId, featureIds: JId[]): Promise<JId[]>
+  geometryCreate(params: JFeatureGeometryCreateParams): Promise<GeoJSON.Feature>
 }
 
 export interface JCoreMainService {
@@ -574,6 +576,10 @@ export interface JServerState extends JServerInfo {
 
 export type JHistoryListener = (oldValue: string | undefined, newValue: string | undefined) => void
 
+export interface JFormJMCService {
+  getJsonForm(layerId: string): JJsonFormSchemas
+}
+
 export interface JFormService {
   // REPO METHODS
   getFormsMetaDataByLayerId(layerId: JId): Promise<JFormMetaData[]>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jmapcloud-ng-core-types",
-  "version": "1.0.16",
+  "version": "1.0.19",
   "description": "JMap Cloud specific version of JMap Cloud NG Core types and interfaces",
   "main": "index.js",
   "scripts": {

package/public/core.d.ts

@@ -506,7 +506,7 @@ declare namespace JMap {
      *
      * Change the feature geometry for the given layer id, feature id and geometry (projection EPSG:4326).
      *
-     * @param params contains the JMap layer id, the JMap feature id, and the geojson geometry
+     * @param params contains the JMap layer id, the JMap feature id, the geojson geometry, and optionally its attributes
      * @throws if layer or feature not found, or if feature is invalid (undefined, wrong geometry type, etc ...)
      * @example
      * ```ts
@@ -565,6 +565,46 @@ declare namespace JMap {
     // TODO: see if the future endpoint will return detail about individual deleted features success or failure
     // https://k2geospatial.atlassian.net/browse/JMAP8-1589
     function deleteByIds(layerId: JId, featureIds: JId[]): Promise<JId[]>
+
+    /**
+     * **JMap.Feature.geometryCreate**
+     *
+     * Creates a new Geometry
+     *
+     * @param params An object containing the parameters for geometry creation.
+     * params.layerId:  The JMap layer id (string).
+     * params.geometry: The GeoJSON geometry object.
+     * params.properties: The values of the feature's attributes.
+     * params.crs: An object representing the coordinate reference system of the geometry.
+     * @throws Will throw an error if the layerId is not found.
+     * @returns A promise that resolves with the created GeoJSON feature.
+     *
+     * @example
+     * ```ts
+     * // Create a feature
+     * JMap.Feature
+     *   .geometryCreate({
+     *     layerId: "123e4567-e89b-12d3-a456-426614174000",
+     *     crs: {
+     *       type: "EPSG",
+     *       properties: {
+     *         code: 4326
+     *       }
+     *     },
+     *     geometry: {
+     *       type: "Point",
+     *       coordinates: [-73.56, 45.51]
+     *     },
+     *     properties: {
+     *       property1: "value1",
+     *       property2: "value2"
+     *     }
+     *   })
+     *   .then(() => console.info("Feature has been created"))
+     *   .catch(error => console.error("An error occurred", error));
+     * ```
+     */
+    function geometryCreate(params: JFeatureGeometryCreateParams): Promise<GeoJSON.Feature>
   }
 
   /**
@@ -8931,7 +8971,7 @@ declare namespace JMap {
         /**
          * ***JMap.Event.Map.on.mapLoad***
          *
-         * This event is triggered when a layer is deleted.
+         * This event is triggered when the map is created and ready.
          *
          * @param listenerId Your listener id (must be unique for all map events)
          * @param fn Your listener function
@@ -10183,6 +10223,33 @@ declare namespace JMap {
     function renderMouseOver(layer: JLayer, feature: GeoJSON.Feature): Array<JExtensionMouseOver | undefined>
   }
 
+  /**
+   * **JMap.FormJMC**
+   *
+   * Here you'll find all form related methods
+   */
+  namespace FormJMC {
+    /**
+     * ***JMap.FormJMC.getJsonForm***
+     *
+     * Returns the jsonForm schema and uiSchema for a layer.
+     *
+     * fetch the attributes of a layer and then builds and returns the schema and uiSchema required for jsonForms. The schemas will be null if there is no attributes on the layer
+     *
+     * @param layerId the JMap layer id
+     * @example
+     * ```ts
+     * // returns the schema and uiSchema for layer id=f47ac10b-58cc-4372-a567-0e02b2c3d479
+
+
+     * JMap.FormJMC
+     *  .getJsonForm("f47ac10b-58cc-4372-a567-0e02b2c3d479")
+     *  .then(schemas => console.log("jsonForms schemas of layer f47ac10b-58cc-4372-a567-0e02b2c3d479", schemas))
+     *  .catch(error => console.error("An error occurred when getting jsonForm schema", error))
+     * ```
+     */
+    function getJsonForm(layerId: JId): JJsonFormSchemas
+  }
   /**
    * **JMap.Form**
    *

package/public/jmap/features.d.ts

@@ -6,6 +6,7 @@ declare interface JFeatureGeometryUpdateParams {
   layerId: JId
   featureId: JId
   geometry: GeoJSON.Geometry
+  properties?: JAttributeValueByName
 }
 
 declare interface JFeatureEventGeometryUpdateParams {
@@ -30,3 +31,15 @@ declare interface JFeatureEventCreateParams {
   featureGeometry: GeoJSON.Geometry
   featureProperties: JAttributeValueByName
 }
+
+declare interface JFeatureGeometryCreateParams {
+  layerId: JId
+  geometry: GeoJSON.Geometry
+  properties?: JAttributeValueByName
+  crs: {
+    type: string
+    property: {
+      code: number
+    }
+  }
+}

package/public/jmap/formJMC.d.ts

@@ -0,0 +1,28 @@
+declare interface JJsonFormSchemas {
+  schema: JJsonFormSchema | null
+  uiSchema: JJsonFormUISchema | null
+}
+
+declare interface JJsonFormSchema {
+  type: "object"
+  properties: {
+    [key: string]: {
+      type: string
+      format?: string
+    }
+  }
+  required: string[]
+}
+declare interface JJsonFormControlElement {
+  type: "Control"
+  scope: string
+  label: string
+  options?: {
+    [key: string]: any
+  }
+}
+
+declare interface JJsonFormUISchema {
+  type: "VerticalLayout"
+  elements: JJsonFormControlElement[]
+}

package/public/jmap/layer.d.ts

@@ -271,11 +271,11 @@ declare interface JLayerGeometry {
 }
 
 declare interface JLayerPermissions {
-  ADD: boolean
-  DELETE: boolean
-  DUPLICATE: boolean
-  EDIT_ATTRIBUTE_VALUES: boolean
-  EDIT_GEOMETRY: boolean
+  ADD_FEATURE: boolean
+  DELETE_FEATURE: boolean
+  EXTRACT_FEATURE: boolean
+  EDIT_FEATURE_ATTRIBUTES: boolean
+  EDIT_FEATURE_GEOMETRY: boolean
   EDIT_ONLY_OWN: boolean
 }
 
@@ -302,7 +302,6 @@ declare interface JLayer extends JLayerTreeElement {
   queries: JQuery[]
   extent: JBoundaryBox | null
   permissions: JLayerPermissions
-  canEditGeometry: boolean
   hasAttributeForm: boolean
   hasExternalForms: boolean
   selectable: boolean