@ampsec/platform-client 27.1.1 → 27.3.0

package/build/src/dto/findings.dto.d.ts

@@ -2,6 +2,12 @@ import { BaseDto, BaseUpsertDto } from './base.dto';
 import { Category, FindingKind } from './enums';
 import { FindingSeverity } from './enums/finding.severity';
 import { FindingStatus } from './enums/finding.status';
+export type FindingsStatusPathDto = {
+    /** Id of the connector to which the finding applies */
+    id: string;
+    /** Status of the finding, e.g. OPEN */
+    status: FindingStatus.PENDING_VERIFICATION | FindingStatus.OPEN;
+};
 export type FindingUpsertDto = BaseUpsertDto & {
     /** Date the finding was closed */
     closedAt?: string;

package/build/src/services/AmpSdk.d.ts

@@ -11,7 +11,7 @@ export type AmpSdkOptions = AmpRestClientOptions;
  * This client is a wrapper around the AMP REST API meant to be used by
  * service accounts, i.e. plugins and platform extensions. If you are
  * trying to implement a simple web client you should leverage the AmpApi
- * instead (see {@link AmpApi} ).
+ * of EngageApi instead (see {@link AmpApi} and {@link EngageApi} ).
  *
  * This client provides CRUD access to all of the AMP API.
  */

package/build/src/services/AmpSdk.js

@@ -11,7 +11,7 @@ const settings_service_1 = require("./settings.service");
  * This client is a wrapper around the AMP REST API meant to be used by
  * service accounts, i.e. plugins and platform extensions. If you are
  * trying to implement a simple web client you should leverage the AmpApi
- * instead (see {@link AmpApi} ).
+ * of EngageApi instead (see {@link AmpApi} and {@link EngageApi} ).
  *
  * This client provides CRUD access to all of the AMP API.
  */

package/build/src/services/EngageApi.d.ts

@@ -0,0 +1,37 @@
+import { ConnectorDto, FindingDto, FindingsStatusPathDto as FindingsStatusPatchDto, NotificationDto, ProviderDto } from '../dto';
+import { AmpDataService, AmpPatchDataService } from './data.service';
+import { AmpRestClientOptions, RestClient } from './rest';
+import { AmpReportService } from './reports.service';
+import { AmpSettingsService } from './settings.service';
+import { UserIdentityService } from './rest/UserIdentityService';
+export type EngageApiOptions = AmpRestClientOptions;
+/**
+ * Engage API
+ * This client is a wrapper around the AMP REST API meant to be used by
+ * end users, i.e. Amplifier Security's managed users. If you are trying to implement
+ * a plugin leverage the AmpSdk instead (see {@link AmpSdkServices} ), or
+ * a an extension for Agents use AmpApi instead (see {@link AmpApi}).
+ *
+ * This client provides READ_ONLY access to The folloing resoureces:
+ * - Connectors: {@link EngageApi.connectors}
+ * - Findings: {@link EngageApi.findings}
+ * - Identity: {@link EngageApi.identity}
+ * - Notifications: {@link EngageApi.notifications}
+ * - Providers: {@link EngageApi.providers}
+ * - Reporting: {@link EngageApi.reports}
+ * - Settings: {@link EngageApi.settings}
+ *
+ * This client provides PATCH access to The folloing resoureces:
+ * - Findings: {@link EngageApi.findings}
+ */
+export declare class EngageApi {
+    readonly connectors: AmpDataService<ConnectorDto>;
+    readonly findings: AmpPatchDataService<FindingsStatusPatchDto, FindingDto>;
+    readonly identity: UserIdentityService;
+    readonly notifications: AmpDataService<NotificationDto>;
+    readonly providers: AmpDataService<ProviderDto>;
+    readonly reports: AmpReportService;
+    readonly settings: AmpSettingsService;
+    constructor(rest: RestClient);
+    static instance(options: EngageApiOptions): EngageApi;
+}

package/build/src/services/EngageApi.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EngageApi = void 0;
+const entity_service_1 = require("./entity.service");
+const data_service_1 = require("./data.service");
+const rest_1 = require("./rest");
+const constants_1 = require("./constants");
+const reports_service_1 = require("./reports.service");
+const settings_service_1 = require("./settings.service");
+const UserIdentityService_1 = require("./rest/UserIdentityService");
+/**
+ * Engage API
+ * This client is a wrapper around the AMP REST API meant to be used by
+ * end users, i.e. Amplifier Security's managed users. If you are trying to implement
+ * a plugin leverage the AmpSdk instead (see {@link AmpSdkServices} ), or
+ * a an extension for Agents use AmpApi instead (see {@link AmpApi}).
+ *
+ * This client provides READ_ONLY access to The folloing resoureces:
+ * - Connectors: {@link EngageApi.connectors}
+ * - Findings: {@link EngageApi.findings}
+ * - Identity: {@link EngageApi.identity}
+ * - Notifications: {@link EngageApi.notifications}
+ * - Providers: {@link EngageApi.providers}
+ * - Reporting: {@link EngageApi.reports}
+ * - Settings: {@link EngageApi.settings}
+ *
+ * This client provides PATCH access to The folloing resoureces:
+ * - Findings: {@link EngageApi.findings}
+ */
+class EngageApi {
+    constructor(rest) {
+        this.connectors = new entity_service_1.AmpEntityServiceImpl(rest, constants_1.KIND.CONNECTORS, constants_1.TARGET_API_ENGAGE); // TODO: add /eng endpoint... needed?
+        this.findings = new data_service_1.AmpPatchDataServiceImpl(rest, constants_1.KIND.FINDINGS, constants_1.TARGET_API_ENGAGE);
+        this.identity = new UserIdentityService_1.UserIdentityService(rest);
+        this.notifications = new data_service_1.AmpDataServiceImpl(rest, constants_1.KIND.NOTIFICATIONS, constants_1.TARGET_API_ENGAGE); // TODO: add /eng endpoint
+        this.providers = new data_service_1.AmpDataServiceImpl(rest, constants_1.KIND.PROVIDERS, constants_1.TARGET_API_ENGAGE); // TODO: add /eng endpoint... needed?
+        this.reports = new reports_service_1.AmpReportServiceImpl(rest);
+        this.settings = new settings_service_1.AmpSettingsService(rest); // TODO: add /eng endpoint
+    }
+    static instance(options) {
+        const rest = (0, rest_1.getAmpRestClient)(options);
+        return new EngageApi(rest);
+    }
+}
+exports.EngageApi = EngageApi;
+//# sourceMappingURL=EngageApi.js.map

package/build/src/services/EngageApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EngageApi.js","sourceRoot":"","sources":["../../../src/services/EngageApi.ts"],"names":[],"mappings":";;;AACA,qDAAsD;AACtD,iDAAgH;AAChH,iCAA0E;AAC1E,2CAAoD;AACpD,uDAAyE;AACzE,yDAAsD;AACtD,oEAA+D;AAI/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,SAAS;IASpB,YAAY,IAAgB;QAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,qCAAoB,CAAmC,IAAI,EAAE,gBAAI,CAAC,UAAU,EAAE,6BAAiB,CAAC,CAAC,CAAC,qCAAqC;QAC7J,IAAI,CAAC,QAAQ,GAAG,IAAI,sCAAuB,CAAqC,IAAI,EAAE,gBAAI,CAAC,QAAQ,EAAE,6BAAiB,CAAC,CAAC;QACxH,IAAI,CAAC,QAAQ,GAAG,IAAI,yCAAmB,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,aAAa,GAAG,IAAI,iCAAkB,CAAkB,IAAI,EAAE,gBAAI,CAAC,aAAa,EAAE,6BAAiB,CAAC,CAAC,CAAC,0BAA0B;QACrI,IAAI,CAAC,SAAS,GAAG,IAAI,iCAAkB,CAAc,IAAI,EAAE,gBAAI,CAAC,SAAS,EAAE,6BAAiB,CAAC,CAAC,CAAC,qCAAqC;QACpI,IAAI,CAAC,OAAO,GAAG,IAAI,sCAAoB,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,IAAI,qCAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,0BAA0B;IAC1E,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,OAAyB;QACvC,MAAM,IAAI,GAAG,IAAA,uBAAgB,EAAC,OAAO,CAAC,CAAC;QACvC,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAvBD,8BAuBC"}

package/build/src/services/constants.d.ts

@@ -2,9 +2,10 @@ export interface ErrorHandler<T> {
     (_error: unknown): T;
 }
 export declare const DEFAULT_TREND_WINDOW_MONTHS = 6;
-export type TargetApi = 'api' | 'platform';
+export type TargetApi = 'api' | 'platform' | 'eng';
 export declare const TARGET_API_PLATFORM: TargetApi;
 export declare const TARGET_API_AGENT: TargetApi;
+export declare const TARGET_API_ENGAGE: TargetApi;
 export declare const KIND: {
     AGENTS: string;
     ASSETS: string;

package/build/src/services/constants.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REPORTS = exports.KIND = exports.TARGET_API_AGENT = exports.TARGET_API_PLATFORM = exports.DEFAULT_TREND_WINDOW_MONTHS = void 0;
+exports.REPORTS = exports.KIND = exports.TARGET_API_ENGAGE = exports.TARGET_API_AGENT = exports.TARGET_API_PLATFORM = exports.DEFAULT_TREND_WINDOW_MONTHS = void 0;
 exports.DEFAULT_TREND_WINDOW_MONTHS = 6;
 exports.TARGET_API_PLATFORM = 'platform';
 exports.TARGET_API_AGENT = 'api';
+exports.TARGET_API_ENGAGE = 'eng';
 exports.KIND = {
     AGENTS: 'agents',
     ASSETS: 'assets',

package/build/src/services/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/services/constants.ts"],"names":[],"mappings":";;;AAIa,QAAA,2BAA2B,GAAG,CAAC,CAAC;AAGhC,QAAA,mBAAmB,GAAc,UAAU,CAAC;AAC5C,QAAA,gBAAgB,GAAc,KAAK,CAAC;AAEpC,QAAA,IAAI,GAAG;IAClB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,gBAAgB,EAAE,aAAa;IAC/B,kBAAkB,EAAE,eAAe;IACnC,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,gBAAgB;IAChC,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,eAAe;IAC9B,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;IAChC,iBAAiB,EAAE,mBAAmB;IACtC,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,iBAAiB;IAClC,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,iBAAiB,EAAE,oBAAoB;CACxC,CAAC;AAEW,QAAA,OAAO,GAAG;IACrB,YAAY,EAAE,cAAc;IAC5B,yBAAyB,EAAE,qCAAqC;IAChE,yBAAyB,EAAE,qCAAqC;IAChE,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;IACtC,qBAAqB,EAAE,uBAAuB;IAC9C,2BAA2B,EAAE,6BAA6B;IAC1D,YAAY,EAAE,0BAA0B;IACxC,qBAAqB,EAAE,uBAAuB;IAC9C,gBAAgB,EAAE,kBAAkB;IACpC,WAAW,EAAE,aAAa;IAC1B,mBAAmB;IACnB,kBAAkB,EAAE,sBAAsB;CAC3C,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/services/constants.ts"],"names":[],"mappings":";;;AAIa,QAAA,2BAA2B,GAAG,CAAC,CAAC;AAGhC,QAAA,mBAAmB,GAAc,UAAU,CAAC;AAC5C,QAAA,gBAAgB,GAAc,KAAK,CAAC;AACpC,QAAA,iBAAiB,GAAc,KAAK,CAAC;AAErC,QAAA,IAAI,GAAG;IAClB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,gBAAgB,EAAE,aAAa;IAC/B,kBAAkB,EAAE,eAAe;IACnC,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,gBAAgB;IAChC,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,eAAe;IAC9B,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;IAChC,iBAAiB,EAAE,mBAAmB;IACtC,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,iBAAiB;IAClC,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,iBAAiB,EAAE,oBAAoB;CACxC,CAAC;AAEW,QAAA,OAAO,GAAG;IACrB,YAAY,EAAE,cAAc;IAC5B,yBAAyB,EAAE,qCAAqC;IAChE,yBAAyB,EAAE,qCAAqC;IAChE,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;IACtC,qBAAqB,EAAE,uBAAuB;IAC9C,2BAA2B,EAAE,6BAA6B;IAC1D,YAAY,EAAE,0BAA0B;IACxC,qBAAqB,EAAE,uBAAuB;IAC9C,gBAAgB,EAAE,kBAAkB;IACpC,WAAW,EAAE,aAAa;IAC1B,mBAAmB;IACnB,kBAAkB,EAAE,sBAAsB;CAC3C,CAAC"}

package/build/src/services/data.service.d.ts

@@ -1,11 +1,17 @@
-import { BaseDto, Page } from '../dto';
+import { BaseDto, BaseUpsertDto, Page } from '../dto';
 import { FilterCriteria } from '../FilterCriteria';
 import { ErrorHandler, TargetApi } from './constants';
 import { RestClient, RestRequest } from './rest';
+export type DataServiceCallOptions = {
+    params: unknown;
+};
 export interface AmpDataService<ReadT extends BaseDto> {
     list(_filter: FilterCriteria): Promise<Page<ReadT>>;
     getById(_id: string): Promise<Page<ReadT>>;
 }
+export interface AmpPatchDataService<WriteT extends BaseUpsertDto, ReadT extends BaseDto> extends AmpDataService<ReadT> {
+    patch(_model: WriteT | WriteT[], _options: DataServiceCallOptions): Promise<Page<ReadT>>;
+}
 export declare class AmpDataServiceImpl<ReadT extends BaseDto> implements AmpDataService<ReadT> {
     protected readonly rest: RestClient;
     protected readonly kind: string;
@@ -16,3 +22,7 @@ export declare class AmpDataServiceImpl<ReadT extends BaseDto> implements AmpDat
     list(filter: FilterCriteria): Promise<Page<ReadT>>;
     getById(id: string): Promise<Page<ReadT>>;
 }
+export declare class AmpPatchDataServiceImpl<WriteT extends BaseUpsertDto, ReadT extends BaseDto> extends AmpDataServiceImpl<ReadT> implements AmpPatchDataService<WriteT, ReadT> {
+    constructor(rest: RestClient, kind: string, targetApi?: TargetApi);
+    patch(model: WriteT | WriteT[], options: DataServiceCallOptions): Promise<Page<ReadT>>;
+}

package/build/src/services/data.service.js

@@ -1,6 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AmpDataServiceImpl = void 0;
+exports.AmpPatchDataServiceImpl = exports.AmpDataServiceImpl = void 0;
+const lodash_1 = __importDefault(require("lodash"));
 class AmpDataServiceImpl {
     constructor(rest, kind, targetApi = 'api') {
         this.rest = rest;
@@ -45,4 +49,19 @@ class AmpDataServiceImpl {
     }
 }
 exports.AmpDataServiceImpl = AmpDataServiceImpl;
+class AmpPatchDataServiceImpl extends AmpDataServiceImpl {
+    constructor(rest, kind, targetApi = 'api') {
+        super(rest, kind, targetApi);
+    }
+    patch(model, options) {
+        const url = lodash_1.default.isArray(model) ? `/${this.targetApi}/v1/${this.kind}` : `/${this.targetApi}/v1/${this.kind}/${model.id}`;
+        return this.getPage({
+            url,
+            method: 'PATCH',
+            params: options.params,
+            data: model,
+        });
+    }
+}
+exports.AmpPatchDataServiceImpl = AmpPatchDataServiceImpl;
 //# sourceMappingURL=data.service.js.map

package/build/src/services/data.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"data.service.js","sourceRoot":"","sources":["../../../src/services/data.service.ts"],"names":[],"mappings":";;;AAUA,MAAa,kBAAkB;IAK7B,YAAY,IAAgB,EAAE,IAAY,EAAE,YAAuB,KAAK;QACtE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAES,KAAK,CAAC,IAAI,CAAI,GAAgB,EAAE,YAA6B;QACrE,IAAI;YACF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtC,OAAO,GAAG,CAAC,IAAS,CAAC;SACtB;QAAC,OAAO,KAAc,EAAE;YACvB,IAAI,KAAK,YAAY,KAAK,EAAE;gBAC1B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;aAC9B;YACD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;SAC5B;IACH,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,GAAgB;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAc,EAAE,EAAE;YACvC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YACzE,OAAO;gBACL,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;gBAC7B,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,EAAE;aACV,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,MAAsB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,GAAG,EAAE,IAAI,IAAI,CAAC,SAAS,OAAO,IAAI,CAAC,IAAI,EAAE;YACzC,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,GAAG,EAAE,IAAI,IAAI,CAAC,SAAS,OAAO,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE;YAC/C,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;IACL,CAAC;CACF;AAjDD,gDAiDC"}
+{"version":3,"file":"data.service.js","sourceRoot":"","sources":["../../../src/services/data.service.ts"],"names":[],"mappings":";;;;;;AAAA,oDAAuB;AAoBvB,MAAa,kBAAkB;IAK7B,YAAY,IAAgB,EAAE,IAAY,EAAE,YAAuB,KAAK;QACtE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAES,KAAK,CAAC,IAAI,CAAI,GAAgB,EAAE,YAA6B;QACrE,IAAI;YACF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtC,OAAO,GAAG,CAAC,IAAS,CAAC;SACtB;QAAC,OAAO,KAAc,EAAE;YACvB,IAAI,KAAK,YAAY,KAAK,EAAE;gBAC1B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;aAC9B;YACD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;SAC5B;IACH,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,GAAgB;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAc,EAAE,EAAE;YACvC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YACzE,OAAO;gBACL,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;gBAC7B,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,EAAE;aACV,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,MAAsB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,GAAG,EAAE,IAAI,IAAI,CAAC,SAAS,OAAO,IAAI,CAAC,IAAI,EAAE;YACzC,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,GAAG,EAAE,IAAI,IAAI,CAAC,SAAS,OAAO,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE;YAC/C,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;IACL,CAAC;CACF;AAjDD,gDAiDC;AAED,MAAa,uBAA6E,SAAQ,kBAAyB;IACzH,YAAY,IAAgB,EAAE,IAAY,EAAE,YAAuB,KAAK;QACtE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,KAAwB,EAAE,OAA+B;QAC7D,MAAM,GAAG,GAAG,gBAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,OAAO,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;QACvH,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,GAAG;YACH,MAAM,EAAE,OAAO;YACf,MAAM,EAAE,OAAO,CAAC,MAAkB;YAClC,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;CACF;AAdD,0DAcC"}

package/build/src/services/entity.service.d.ts

@@ -6,31 +6,31 @@ export type EntityCallOptions = {
     params: unknown;
 };
 export interface AmpEntityService<WriteT extends BaseUpsertDto, ReadT extends BaseDto> extends AmpDataService<ReadT> {
-    create(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
-    update(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
+    create(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
+    update(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
     delete(_id: string, _options?: EntityCallOptions): Promise<Page<ReadT>>;
 }
 export interface AmpSdkTenantService<WriteT extends BaseUpsertDto, ReadT extends BaseDto> extends AmpDataService<ReadT> {
-    create(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
-    update(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
+    create(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
+    update(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
     delete(_id: string, _options?: EntityCallOptions): Promise<Page<ReadT>>;
 }
 export interface AmpGlobalEntityService<WriteT extends BaseUpsertDto, ReadT extends BaseDto> extends AmpDataService<ReadT> {
-    create(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
-    update(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
+    create(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
+    update(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
     delete(_id: string, _options?: EntityCallOptions): Promise<Page<ReadT>>;
     getLookupIds(_tid: string, _options?: EntityCallOptions): Promise<ExtKeyMap>;
 }
 export interface AmpSaaSEntityService<WriteT extends BaseUpsertDto, ReadT extends BaseDto> extends AmpDataService<ReadT> {
-    create(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
-    update(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
+    create(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
+    update(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
     delete(_id: string, _options?: EntityCallOptions): Promise<Page<ReadT>>;
     getLookupIds(_cid: string, _options?: EntityCallOptions): Promise<ExtKeyMap>;
 }
 export declare class AmpEntityServiceImpl<WriteT extends BaseUpsertDto, ReadT extends BaseDto> extends AmpDataServiceImpl<ReadT> implements AmpEntityService<WriteT, ReadT> {
     constructor(rest: RestClient, kind: string, targetApi?: TargetApi);
-    create(model: WriteT, options?: EntityCallOptions): Promise<Page<ReadT>>;
-    update(model: WriteT, options?: EntityCallOptions): Promise<Page<ReadT>>;
+    create(model: WriteT | WriteT[], options?: EntityCallOptions): Promise<Page<ReadT>>;
+    update(model: WriteT | WriteT[], options?: EntityCallOptions): Promise<Page<ReadT>>;
     delete(id: string, options?: EntityCallOptions): Promise<Page<ReadT>>;
 }
 export declare class AmpGlobalEntityServiceImpl<WriteT extends BaseUpsertDto, ReadT extends BaseDto> extends AmpEntityServiceImpl<WriteT, ReadT> implements AmpGlobalEntityService<WriteT, ReadT> {

package/build/src/services/entity.service.js

@@ -1,6 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AmpSaaSEntityServiceImpl = exports.AmpGlobalEntityServiceImpl = exports.AmpEntityServiceImpl = void 0;
+const lodash_1 = __importDefault(require("lodash"));
 const constants_1 = require("./constants");
 const data_service_1 = require("./data.service");
 class AmpEntityServiceImpl extends data_service_1.AmpDataServiceImpl {
@@ -16,8 +20,9 @@ class AmpEntityServiceImpl extends data_service_1.AmpDataServiceImpl {
         });
     }
     update(model, options) {
+        const url = lodash_1.default.isArray(model) ? `/${this.targetApi}/v1/${this.kind}` : `/${this.targetApi}/v1/${this.kind}/${model.id}`;
         return this.getPage({
-            url: `/${this.targetApi}/v1/${this.kind}/${model.id}`,
+            url,
             method: 'PUT',
             params: options === null || options === void 0 ? void 0 : options.params,
             data: model,

package/build/src/services/entity.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity.service.js","sourceRoot":"","sources":["../../../src/services/entity.service.ts"],"names":[],"mappings":";;;AACA,2CAAsE;AACtE,iDAAkE;AAgClE,MAAa,oBAA0E,SAAQ,iCAAyB;IACtH,YAAY,IAAgB,EAAE,IAAY,EAAE,YAAuB,4BAAgB;QACjF,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,OAA2B;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,GAAG,EAAE,IAAI,IAAI,CAAC,SAAS,OAAO,IAAI,CAAC,IAAI,EAAE;YACzC,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAkB;YACnC,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,OAA2B;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,GAAG,EAAE,IAAI,IAAI,CAAC,SAAS,OAAO,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,EAAE;YACrD,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAkB;YACnC,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,OAA2B;QAClD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;YACzB,MAAM,GAAG,GAAgB;gBACvB,GAAG,EAAE,IAAI,IAAI,CAAC,SAAS,OAAO,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE;gBAC/C,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAkB;aACpC,CAAC;YACF,MAAM,EAAC,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAc,EAAE,EAAE;gBACtD,IAAI,KAAK,YAAY,KAAK,EAAE;oBAC1B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;iBAC9B;gBACD,OAAO,EAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAC,CAAC;YACjC,CAAC,CAAC,CAAC;YACH,IAAI,KAAK,EAAE;gBACT,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,IAAI,aAAa,EAAE,GAAG,CAAC,CAAC;aAClE;SACF;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AA3CD,oDA2CC;AAED,MAAM,oBAAoB,GAA4B,CAAC,KAAc,EAAE,EAAE;IACvE,IAAI,KAAK,YAAY,KAAK,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;KAC9B;IACD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF,MAAa,0BACX,SAAQ,oBAAmC;IAG3C,YAAY,IAAgB,EAAE,IAAY,EAAE,YAAuB,4BAAgB;QACjF,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;IACD,YAAY,CAAC,GAAW,EAAE,OAA2B;;QACnD,MAAM,GAAG,GAAgB;YACvB,GAAG,EAAE,IAAI,IAAI,CAAC,SAAS,OAAO,IAAI,CAAC,IAAI,cAAc;YACrD,MAAM,EAAE,KAAK;YACb,MAAM,EAAE;gBACN,GAAG,CAAC,MAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAmB,mCAAI,EAAE,CAAC;gBACxC,GAAG;aACJ;SACF,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;IAC9C,CAAC;CACF;AAlBD,gEAkBC;AAED,MAAa,wBACX,SAAQ,oBAAmC;IAG3C,YAAY,IAAgB,EAAE,IAAY,EAAE,YAAuB,4BAAgB;QACjF,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;IACD,YAAY,CAAC,GAAW,EAAE,OAA2B;;QACnD,MAAM,GAAG,GAAgB;YACvB,GAAG,EAAE,IAAI,IAAI,CAAC,SAAS,OAAO,IAAI,CAAC,IAAI,cAAc;YACrD,MAAM,EAAE,KAAK;YACb,MAAM,EAAE;gBACN,GAAG,CAAC,MAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAmB,mCAAI,EAAE,CAAC;gBACxC,GAAG;aACJ;SACF,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;IAC9C,CAAC;CACF;AAlBD,4DAkBC"}
+{"version":3,"file":"entity.service.js","sourceRoot":"","sources":["../../../src/services/entity.service.ts"],"names":[],"mappings":"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"}

package/build/src/services/rest/RestRequest.d.ts

@@ -4,5 +4,5 @@ export type RestRequest = {
     headers?: HeadersMap;
     params?: QueryMap;
     data?: unknown;
-    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
 };

package/build/src/services/rest/UserIdentityService.d.ts

@@ -0,0 +1,10 @@
+import { AmpJwtToken } from '../../dto';
+import { RestClient } from './RestClient';
+export type TokenResponse = {
+    token: string;
+};
+export declare class UserIdentityService {
+    protected readonly rest: RestClient;
+    constructor(rest: RestClient);
+    me(): Promise<AmpJwtToken>;
+}

package/build/src/services/rest/UserIdentityService.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserIdentityService = void 0;
+class UserIdentityService {
+    constructor(rest) {
+        this.rest = rest;
+    }
+    async me() {
+        const res = await this.rest.call({
+            url: '/eng/v1/me',
+            method: 'GET',
+        });
+        return res.data;
+    }
+}
+exports.UserIdentityService = UserIdentityService;
+//# sourceMappingURL=UserIdentityService.js.map

package/build/src/services/rest/UserIdentityService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserIdentityService.js","sourceRoot":"","sources":["../../../../src/services/rest/UserIdentityService.ts"],"names":[],"mappings":";;;AAOA,MAAa,mBAAmB;IAE9B,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IACD,KAAK,CAAC,EAAE;QACN,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAC/B,GAAG,EAAE,YAAY;YACjB,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAmB,CAAC;IACjC,CAAC;CACF;AAZD,kDAYC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampsec/platform-client",
-  "version": "27.1.1",
+  "version": "27.3.0",
   "description": "",
   "main": "build/src/index.js",
   "runkitExampleFilename": "example/main.js",

package/src/dto/findings.dto.ts

@@ -3,6 +3,13 @@ import {Category, FindingKind} from './enums';
 import {FindingSeverity} from './enums/finding.severity';
 import {FindingStatus} from './enums/finding.status';
 
+export type FindingsStatusPathDto = {
+  /** Id of the connector to which the finding applies */
+  id: string;
+  /** Status of the finding, e.g. OPEN */
+  status: FindingStatus.PENDING_VERIFICATION | FindingStatus.OPEN;
+};
+
 export type FindingUpsertDto = BaseUpsertDto & {
   /** Date the finding was closed */
   closedAt?: string;

package/src/services/AmpSdk.ts

@@ -51,7 +51,7 @@ export type AmpSdkOptions = AmpRestClientOptions;
  * This client is a wrapper around the AMP REST API meant to be used by
  * service accounts, i.e. plugins and platform extensions. If you are
  * trying to implement a simple web client you should leverage the AmpApi
- * instead (see {@link AmpApi} ).
+ * of EngageApi instead (see {@link AmpApi} and {@link EngageApi} ).
  *
  * This client provides CRUD access to all of the AMP API.
  */

package/src/services/EngageApi.ts

@@ -0,0 +1,54 @@
+import {ConnectorDto, ConnectorUpsertDto, FindingDto, FindingsStatusPathDto as FindingsStatusPatchDto, NotificationDto, ProviderDto} from '../dto';
+import {AmpEntityServiceImpl} from './entity.service';
+import {AmpDataService, AmpDataServiceImpl, AmpPatchDataService, AmpPatchDataServiceImpl} from './data.service';
+import {AmpRestClientOptions, RestClient, getAmpRestClient} from './rest';
+import {KIND, TARGET_API_ENGAGE} from './constants';
+import {AmpReportService, AmpReportServiceImpl} from './reports.service';
+import {AmpSettingsService} from './settings.service';
+import {UserIdentityService} from './rest/UserIdentityService';
+
+export type EngageApiOptions = AmpRestClientOptions;
+
+/**
+ * Engage API
+ * This client is a wrapper around the AMP REST API meant to be used by
+ * end users, i.e. Amplifier Security's managed users. If you are trying to implement
+ * a plugin leverage the AmpSdk instead (see {@link AmpSdkServices} ), or
+ * a an extension for Agents use AmpApi instead (see {@link AmpApi}).
+ *
+ * This client provides READ_ONLY access to The folloing resoureces:
+ * - Connectors: {@link EngageApi.connectors}
+ * - Findings: {@link EngageApi.findings}
+ * - Identity: {@link EngageApi.identity}
+ * - Notifications: {@link EngageApi.notifications}
+ * - Providers: {@link EngageApi.providers}
+ * - Reporting: {@link EngageApi.reports}
+ * - Settings: {@link EngageApi.settings}
+ *
+ * This client provides PATCH access to The folloing resoureces:
+ * - Findings: {@link EngageApi.findings}
+ */
+export class EngageApi {
+  readonly connectors: AmpDataService<ConnectorDto>;
+  readonly findings: AmpPatchDataService<FindingsStatusPatchDto, FindingDto>;
+  readonly identity: UserIdentityService;
+  readonly notifications: AmpDataService<NotificationDto>;
+  readonly providers: AmpDataService<ProviderDto>;
+  readonly reports: AmpReportService;
+  readonly settings: AmpSettingsService;
+
+  constructor(rest: RestClient) {
+    this.connectors = new AmpEntityServiceImpl<ConnectorUpsertDto, ConnectorDto>(rest, KIND.CONNECTORS, TARGET_API_ENGAGE); // TODO: add /eng endpoint... needed?
+    this.findings = new AmpPatchDataServiceImpl<FindingsStatusPatchDto, FindingDto>(rest, KIND.FINDINGS, TARGET_API_ENGAGE);
+    this.identity = new UserIdentityService(rest);
+    this.notifications = new AmpDataServiceImpl<NotificationDto>(rest, KIND.NOTIFICATIONS, TARGET_API_ENGAGE); // TODO: add /eng endpoint
+    this.providers = new AmpDataServiceImpl<ProviderDto>(rest, KIND.PROVIDERS, TARGET_API_ENGAGE); // TODO: add /eng endpoint... needed?
+    this.reports = new AmpReportServiceImpl(rest);
+    this.settings = new AmpSettingsService(rest); // TODO: add /eng endpoint
+  }
+
+  static instance(options: EngageApiOptions): EngageApi {
+    const rest = getAmpRestClient(options);
+    return new EngageApi(rest);
+  }
+}

package/src/services/constants.ts

@@ -4,9 +4,10 @@ export interface ErrorHandler<T> {
 
 export const DEFAULT_TREND_WINDOW_MONTHS = 6;
 
-export type TargetApi = 'api' | 'platform';
+export type TargetApi = 'api' | 'platform' | 'eng';
 export const TARGET_API_PLATFORM: TargetApi = 'platform';
 export const TARGET_API_AGENT: TargetApi = 'api';
+export const TARGET_API_ENGAGE: TargetApi = 'eng';
 
 export const KIND = {
   AGENTS: 'agents',

package/src/services/data.service.ts

@@ -1,13 +1,23 @@
-import {BaseDto, Page} from '../dto';
+import _ from 'lodash';
+import {BaseDto, BaseUpsertDto, Page} from '../dto';
 import {FilterCriteria} from '../FilterCriteria';
 import {ErrorHandler, TargetApi} from './constants';
 import {RestClient, RestRequest} from './rest';
+import {QueryMap} from './rest/utils';
+
+export type DataServiceCallOptions = {
+  params: unknown;
+};
 
 export interface AmpDataService<ReadT extends BaseDto> {
   list(_filter: FilterCriteria): Promise<Page<ReadT>>;
   getById(_id: string): Promise<Page<ReadT>>;
 }
 
+export interface AmpPatchDataService<WriteT extends BaseUpsertDto, ReadT extends BaseDto> extends AmpDataService<ReadT> {
+  patch(_model: WriteT | WriteT[], _options: DataServiceCallOptions): Promise<Page<ReadT>>;
+}
+
 export class AmpDataServiceImpl<ReadT extends BaseDto> implements AmpDataService<ReadT> {
   protected readonly rest: RestClient;
   protected readonly kind: string;
@@ -58,3 +68,19 @@ export class AmpDataServiceImpl<ReadT extends BaseDto> implements AmpDataService
     });
   }
 }
+
+export class AmpPatchDataServiceImpl<WriteT extends BaseUpsertDto, ReadT extends BaseDto> extends AmpDataServiceImpl<ReadT> implements AmpPatchDataService<WriteT, ReadT> {
+  constructor(rest: RestClient, kind: string, targetApi: TargetApi = 'api') {
+    super(rest, kind, targetApi);
+  }
+
+  patch(model: WriteT | WriteT[], options: DataServiceCallOptions): Promise<Page<ReadT>> {
+    const url = _.isArray(model) ? `/${this.targetApi}/v1/${this.kind}` : `/${this.targetApi}/v1/${this.kind}/${model.id}`;
+    return this.getPage({
+      url,
+      method: 'PATCH',
+      params: options.params as QueryMap,
+      data: model,
+    });
+  }
+}

package/src/services/entity.service.ts

@@ -1,3 +1,4 @@
+import _ from 'lodash';
 import {BaseDto, BaseUpsertDto, ExtKeyMap, Page} from '../dto';
 import {TargetApi, TARGET_API_AGENT, ErrorHandler} from './constants';
 import {AmpDataService, AmpDataServiceImpl} from './data.service';
@@ -9,25 +10,25 @@ export type EntityCallOptions = {
 };
 
 export interface AmpEntityService<WriteT extends BaseUpsertDto, ReadT extends BaseDto> extends AmpDataService<ReadT> {
-  create(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
-  update(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
+  create(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
+  update(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
   delete(_id: string, _options?: EntityCallOptions): Promise<Page<ReadT>>;
 }
 
 export interface AmpSdkTenantService<WriteT extends BaseUpsertDto, ReadT extends BaseDto> extends AmpDataService<ReadT> {
-  create(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
-  update(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
+  create(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
+  update(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
   delete(_id: string, _options?: EntityCallOptions): Promise<Page<ReadT>>;
 }
 export interface AmpGlobalEntityService<WriteT extends BaseUpsertDto, ReadT extends BaseDto> extends AmpDataService<ReadT> {
-  create(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
-  update(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
+  create(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
+  update(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
   delete(_id: string, _options?: EntityCallOptions): Promise<Page<ReadT>>;
   getLookupIds(_tid: string, _options?: EntityCallOptions): Promise<ExtKeyMap>;
 }
 export interface AmpSaaSEntityService<WriteT extends BaseUpsertDto, ReadT extends BaseDto> extends AmpDataService<ReadT> {
-  create(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
-  update(_model: WriteT, _options?: EntityCallOptions): Promise<Page<ReadT>>;
+  create(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
+  update(_model: WriteT | WriteT[], _options?: EntityCallOptions): Promise<Page<ReadT>>;
   delete(_id: string, _options?: EntityCallOptions): Promise<Page<ReadT>>;
   getLookupIds(_cid: string, _options?: EntityCallOptions): Promise<ExtKeyMap>;
 }
@@ -37,7 +38,7 @@ export class AmpEntityServiceImpl<WriteT extends BaseUpsertDto, ReadT extends Ba
     super(rest, kind, targetApi);
   }
 
-  create(model: WriteT, options?: EntityCallOptions): Promise<Page<ReadT>> {
+  create(model: WriteT | WriteT[], options?: EntityCallOptions): Promise<Page<ReadT>> {
     return this.getPage({
       url: `/${this.targetApi}/v1/${this.kind}`,
       method: 'POST',
@@ -46,9 +47,10 @@ export class AmpEntityServiceImpl<WriteT extends BaseUpsertDto, ReadT extends Ba
     });
   }
 
-  update(model: WriteT, options?: EntityCallOptions): Promise<Page<ReadT>> {
+  update(model: WriteT | WriteT[], options?: EntityCallOptions): Promise<Page<ReadT>> {
+    const url = _.isArray(model) ? `/${this.targetApi}/v1/${this.kind}` : `/${this.targetApi}/v1/${this.kind}/${model.id}`;
     return this.getPage({
-      url: `/${this.targetApi}/v1/${this.kind}/${model.id}`,
+      url,
       method: 'PUT',
       params: options?.params as QueryMap,
       data: model,

package/src/services/rest/RestRequest.ts

@@ -5,5 +5,5 @@ export type RestRequest = {
   headers?: HeadersMap;
   params?: QueryMap;
   data?: unknown;
-  method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+  method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
 };

package/src/services/rest/UserIdentityService.ts

@@ -0,0 +1,20 @@
+import {AmpJwtToken} from '../../dto';
+import {RestClient} from './RestClient';
+
+export type TokenResponse = {
+  token: string;
+};
+
+export class UserIdentityService {
+  protected readonly rest: RestClient;
+  constructor(rest: RestClient) {
+    this.rest = rest;
+  }
+  async me(): Promise<AmpJwtToken> {
+    const res = await this.rest.call({
+      url: '/eng/v1/me',
+      method: 'GET',
+    });
+    return res.data as AmpJwtToken;
+  }
+}