@forestadmin/agent-client 0.1.0 → 1.0.0

package/dist/domains/collection.js

@@ -0,0 +1,109 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const action_1 = __importDefault(require("./action"));
+const collection_chart_1 = __importDefault(require("./collection-chart"));
+const relation_1 = __importDefault(require("./relation"));
+const segment_1 = __importDefault(require("./segment"));
+const field_form_states_1 = __importDefault(require("../action-fields/field-form-states"));
+const query_serializer_1 = __importDefault(require("../query-serializer"));
+class Collection extends collection_chart_1.default {
+    constructor(name, httpRequester, actionEndpoints) {
+        super(name, httpRequester);
+        this.name = name;
+        this.actionEndpoints = actionEndpoints;
+    }
+    async action(actionName, actionContext) {
+        const actionPath = this.getActionPath(this.actionEndpoints, this.name, actionName);
+        const ids = (actionContext?.recordIds ?? [actionContext?.recordId]).filter(Boolean).map(String);
+        const fieldsFormStates = new field_form_states_1.default(actionName, actionPath, this.name, this.httpRequester, ids);
+        const action = new action_1.default(this.name, this.httpRequester, actionPath, fieldsFormStates, ids);
+        await fieldsFormStates.loadInitialState();
+        return action;
+    }
+    segment(name) {
+        return new segment_1.default(name, this.name, this.httpRequester);
+    }
+    liveQuerySegment(options) {
+        // there is no name for live query
+        return new segment_1.default(undefined, this.name, this.httpRequester, options);
+    }
+    relation(name, parentId) {
+        return new relation_1.default(name, this.name, parentId, this.httpRequester);
+    }
+    async search(content) {
+        return this.list({ search: content });
+    }
+    async list(options) {
+        return this.httpRequester.query({
+            method: 'get',
+            path: `/forest/${this.name}`,
+            query: query_serializer_1.default.serialize(options, this.name),
+        });
+    }
+    async exportCsv(stream, options) {
+        await this.httpRequester.stream({
+            path: `/forest/${this.name}.csv`,
+            contentType: 'text/csv',
+            query: {
+                ...query_serializer_1.default.serialize(options, this.name),
+                ...{ header: JSON.stringify(options?.fields) },
+            },
+            stream,
+        });
+    }
+    async count(options) {
+        return Number((await this.httpRequester.query({
+            method: 'get',
+            path: `/forest/${this.name}/count`,
+            query: query_serializer_1.default.serialize(options, this.name),
+        })).count);
+    }
+    async delete(ids) {
+        const serializedIds = ids.map((id) => id.toString());
+        const requestBody = {
+            data: {
+                attributes: { collection_name: this.name, ids: serializedIds },
+                type: 'action-requests',
+            },
+        };
+        return this.httpRequester.query({
+            method: 'delete',
+            path: `/forest/${this.name}`,
+            body: requestBody,
+        });
+    }
+    async create(attributes) {
+        const requestBody = { data: { attributes, type: this.name } };
+        return this.httpRequester.query({
+            method: 'post',
+            path: `/forest/${this.name}`,
+            body: requestBody,
+        });
+    }
+    async update(id, attributes) {
+        const requestBody = { data: { attributes, type: this.name, id: id.toString() } };
+        return this.httpRequester.query({
+            method: 'put',
+            path: `/forest/${this.name}/${id.toString()}`,
+            body: requestBody,
+        });
+    }
+    getActionPath(actionEndpoints, collectionName, actionName) {
+        const collection = actionEndpoints[collectionName];
+        if (!collection)
+            throw new Error(`Collection ${collectionName} not found in schema`);
+        const action = collection[actionName];
+        if (!action) {
+            throw new Error(`Action ${actionName} not found in collection ${collectionName}`);
+        }
+        if (!action.endpoint) {
+            throw new Error(`Action ${actionName} not found in collection ${collectionName}`);
+        }
+        return action.endpoint;
+    }
+}
+exports.default = Collection;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29sbGVjdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9kb21haW5zL2NvbGxlY3Rpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFJQSxzREFBa0Y7QUFDbEYsMEVBQWlEO0FBQ2pELDBEQUFrQztBQUNsQyx3REFBZ0M7QUFDaEMsMkZBQWlFO0FBRWpFLDJFQUFrRDtBQUVsRCxNQUFxQixVQUEwQixTQUFRLDBCQUFlO0lBSXBFLFlBQ0UsSUFBWSxFQUNaLGFBQTRCLEVBQzVCLGVBQTRDO1FBRTVDLEtBQUssQ0FBQyxJQUFJLEVBQUUsYUFBYSxDQUFDLENBQUM7UUFFM0IsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUM7UUFDakIsSUFBSSxDQUFDLGVBQWUsR0FBRyxlQUFlLENBQUM7SUFDekMsQ0FBQztJQUVELEtBQUssQ0FBQyxNQUFNLENBQ1YsVUFBa0IsRUFDbEIsYUFBaUM7UUFFakMsTUFBTSxVQUFVLEdBQUcsSUFBSSxDQUFDLGFBQWEsQ0FBQyxJQUFJLENBQUMsZUFBZSxFQUFFLElBQUksQ0FBQyxJQUFJLEVBQUUsVUFBVSxDQUFDLENBQUM7UUFDbkYsTUFBTSxHQUFHLEdBQUcsQ0FBQyxhQUFhLEVBQUUsU0FBUyxJQUFJLENBQUMsYUFBYSxFQUFFLFFBQVEsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBQyxDQUFDLEdBQUcsQ0FBQyxNQUFNLENBQUMsQ0FBQztRQUVoRyxNQUFNLGdCQUFnQixHQUFHLElBQUksMkJBQWUsQ0FDMUMsVUFBVSxFQUNWLFVBQVUsRUFDVixJQUFJLENBQUMsSUFBSSxFQUNULElBQUksQ0FBQyxhQUFhLEVBQ2xCLEdBQUcsQ0FDSixDQUFDO1FBRUYsTUFBTSxNQUFNLEdBQUcsSUFBSSxnQkFBTSxDQUN2QixJQUFJLENBQUMsSUFBSSxFQUNULElBQUksQ0FBQyxhQUFhLEVBQ2xCLFVBQVUsRUFDVixnQkFBZ0IsRUFDaEIsR0FBRyxDQUNKLENBQUM7UUFF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

package/dist/domains/relation.d.ts

@@ -0,0 +1,11 @@
+import type HttpRequester from '../http-requester';
+import type { SelectOptions } from '../types';
+export default class Relation<TypingsSchema> {
+    private readonly name;
+    private readonly collectionName;
+    private readonly parentId;
+    private readonly httpRequester;
+    constructor(name: string, collectionName: string, parentId: string | number, httpRequester: HttpRequester);
+    list<Data = unknown>(options?: SelectOptions): Promise<Data[]>;
+}
+//# sourceMappingURL=relation.d.ts.map

package/dist/domains/relation.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const query_serializer_1 = __importDefault(require("../query-serializer"));
+class Relation {
+    constructor(name, collectionName, parentId, httpRequester) {
+        this.name = name;
+        this.collectionName = collectionName;
+        this.httpRequester = httpRequester;
+        this.parentId = parentId;
+    }
+    list(options) {
+        return this.httpRequester.query({
+            method: 'get',
+            path: `/forest/${this.collectionName}/${this.parentId}/relationships/${this.name}`,
+            query: query_serializer_1.default.serialize(options, this.collectionName),
+        });
+    }
+}
+exports.default = Relation;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVsYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZG9tYWlucy9yZWxhdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQUdBLDJFQUFrRDtBQUVsRCxNQUFxQixRQUFRO0lBTTNCLFlBQ0UsSUFBWSxFQUNaLGNBQXNCLEVBQ3RCLFFBQXlCLEVBQ3pCLGFBQTRCO1FBRTVCLElBQUksQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFDO1FBQ2pCLElBQUksQ0FBQyxjQUFjLEdBQUcsY0FBYyxDQUFDO1FBQ3JDLElBQUksQ0FBQyxhQUFhLEdBQUcsYUFBYSxDQUFDO1FBQ25DLElBQUksQ0FBQyxRQUFRLEdBQUcsUUFBUSxDQUFDO0lBQzNCLENBQUM7SUFFRCxJQUFJLENBQWlCLE9BQXVCO1FBQzFDLE9BQU8sSUFBSSxDQUFDLGFBQWEsQ0FBQyxLQUFLLENBQVM7WUFDdEMsTUFBTSxFQUFFLEtBQUs7WUFDYixJQUFJLEVBQUUsV0FBVyxJQUFJLENBQUMsY0FBYyxJQUFJLElBQUksQ0FBQyxRQUFRLGtCQUFrQixJQUFJLENBQUMsSUFBSSxFQUFFO1lBQ2xGLEtBQUssRUFBRSwwQkFBZSxDQUFDLFNBQVMsQ0FBQyxPQUFPLEVBQUUsSUFBSSxDQUFDLGNBQWMsQ0FBQztTQUMvRCxDQUFDLENBQUM7SUFDTCxDQUFDO0NBQ0Y7QUF6QkQsMkJBeUJDIn0=

package/dist/domains/remote-agent-client.d.ts

@@ -0,0 +1,42 @@
+import { RawTreeWithSources } from '@forestadmin/forestadmin-client';
+import { ActionEndpointsByCollection } from './action';
+import Chart from './chart';
+import Collection from './collection';
+import HttpRequester from '../http-requester';
+export type SmartActionPermissionsOverride = Partial<{
+    triggerEnabled: boolean;
+    triggerConditions: RawTreeWithSources;
+    approvalRequired: boolean;
+    approvalRequiredConditions: RawTreeWithSources;
+    userApprovalEnabled: boolean;
+    userApprovalConditions: RawTreeWithSources;
+    selfApprovalEnabled: boolean;
+}>;
+export type CollectionPermissionsOverride = Partial<{
+    browseEnabled: boolean;
+    deleteEnabled: boolean;
+    editEnabled: boolean;
+    exportEnabled: boolean;
+    addEnabled: boolean;
+    readEnabled: boolean;
+}>;
+export type PermissionsOverride = Record<string, {
+    collection: CollectionPermissionsOverride;
+    actions: Record<string, SmartActionPermissionsOverride>;
+}>;
+type CollectionName<T> = keyof T & string;
+export default class RemoteAgentClient<TypingsSchema extends Record<string, unknown> = Record<string, unknown>> extends Chart {
+    protected actionEndpoints?: ActionEndpointsByCollection;
+    private overridePermissions?;
+    constructor(params?: {
+        actionEndpoints?: ActionEndpointsByCollection;
+        httpRequester: HttpRequester;
+        overridePermissions?: (permissions: PermissionsOverride) => Promise<void>;
+    });
+    overrideCollectionPermission(collectionName: CollectionName<TypingsSchema>, permissions: CollectionPermissionsOverride): Promise<void>;
+    overrideActionPermission(collectionName: CollectionName<TypingsSchema>, actionName: string, permissions: SmartActionPermissionsOverride): Promise<void>;
+    clearPermissionOverride(): Promise<void>;
+    collection(name: CollectionName<TypingsSchema>): Collection<TypingsSchema>;
+}
+export {};
+//# sourceMappingURL=remote-agent-client.d.ts.map

package/dist/domains/remote-agent-client.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chart_1 = __importDefault(require("./chart"));
+const collection_1 = __importDefault(require("./collection"));
+class RemoteAgentClient extends chart_1.default {
+    constructor(params) {
+        super();
+        if (!params)
+            return;
+        this.httpRequester = params.httpRequester;
+        this.actionEndpoints = params.actionEndpoints;
+        this.overridePermissions = params.overridePermissions;
+    }
+    async overrideCollectionPermission(collectionName, permissions) {
+        await this.overridePermissions?.({
+            [collectionName]: {
+                collection: permissions,
+                actions: {},
+            },
+        });
+    }
+    async overrideActionPermission(collectionName, actionName, permissions) {
+        await this.overridePermissions?.({
+            [collectionName]: {
+                collection: {},
+                actions: {
+                    [actionName]: permissions,
+                },
+            },
+        });
+    }
+    async clearPermissionOverride() {
+        await this.overridePermissions?.({});
+    }
+    collection(name) {
+        return new collection_1.default(name, this.httpRequester, this.actionEndpoints);
+    }
+}
+exports.default = RemoteAgentClient;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVtb3RlLWFnZW50LWNsaWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9kb21haW5zL3JlbW90ZS1hZ2VudC1jbGllbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFHQSxvREFBNEI7QUFDNUIsOERBQXNDO0FBZ0N0QyxNQUFxQixpQkFFbkIsU0FBUSxlQUFLO0lBS2IsWUFBWSxNQUlYO1FBQ0MsS0FBSyxFQUFFLENBQUM7UUFDUixJQUFJLENBQUMsTUFBTTtZQUFFLE9BQU87UUFDcEIsSUFBSSxDQUFDLGFBQWEsR0FBRyxNQUFNLENBQUMsYUFBYSxDQUFDO1FBQzFDLElBQUksQ0FBQyxlQUFlLEdBQUcsTUFBTSxDQUFDLGVBQWUsQ0FBQztRQUM5QyxJQUFJLENBQUMsbUJBQW1CLEdBQUcsTUFBTSxDQUFDLG1CQUFtQixDQUFDO0lBQ3hELENBQUM7SUFFRCxLQUFLLENBQUMsNEJBQTRCLENBQ2hDLGNBQTZDLEVBQzdDLFdBQTBDO1FBRTFDLE1BQU0sSUFBSSxDQUFDLG1CQUFtQixFQUFFLENBQUM7WUFDL0IsQ0FBQyxjQUFjLENBQUMsRUFBRTtnQkFDaEIsVUFBVSxFQUFFLFdBQVc7Z0JBQ3ZCLE9BQU8sRUFBRSxFQUFFO2FBQ1o7U0FDRixDQUFDLENBQUM7SUFDTCxDQUFDO0lBRUQsS0FBSyxDQUFDLHdCQUF3QixDQUM1QixjQUE2QyxFQUM3QyxVQUFrQixFQUNsQixXQUEyQztRQUUzQyxNQUFNLElBQUksQ0FBQyxtQkFBbUIsRUFBRSxDQUFDO1lBQy9CLENBQUMsY0FBYyxDQUFDLEVBQUU7Z0JBQ2hCLFVBQVUsRUFBRSxFQUFFO2dCQUNkLE9BQU8sRUFBRTtvQkFDUCxDQUFDLFVBQVUsQ0FBQyxFQUFFLFdBQVc7aUJBQzFCO2FBQ0Y7U0FDRixDQUFDLENBQUM7SUFDTCxDQUFDO0lBRUQsS0FBSyxDQUFDLHVCQUF1QjtRQUMzQixNQUFNLElBQUksQ0FBQyxtQkFBbUIsRUFBRSxDQUFDLEVBQUUsQ0FBQyxDQUFDO0lBQ3ZDLENBQUM7SUFFRCxVQUFVLENBQUMsSUFBbUM7UUFDNUMsT0FBTyxJQUFJLG9CQUFVLENBQWdCLElBQUksRUFBRSxJQUFJLENBQUMsYUFBYSxFQUFFLElBQUksQ0FBQyxlQUFlLENBQUMsQ0FBQztJQUN2RixDQUFDO0NBQ0Y7QUFyREQsb0NBcURDIn0=

package/dist/domains/segment.d.ts

@@ -0,0 +1,14 @@
+import type HttpRequester from '../http-requester';
+import type { ExportOptions, LiveQueryOptions, SelectOptions } from '../types';
+import { WriteStream } from 'node:fs';
+export default class Segment<TypingsSchema> {
+    private readonly name?;
+    private readonly collectionName;
+    private readonly httpRequester;
+    private readonly liveQuerySegment?;
+    constructor(name: string | undefined, collectionName: string, httpRequester: HttpRequester, liveQuerySegment?: LiveQueryOptions);
+    list<Data = unknown>(options?: SelectOptions): Promise<Data[]>;
+    exportCsv(stream: WriteStream, options?: ExportOptions): Promise<void>;
+    private serializeQuery;
+}
+//# sourceMappingURL=segment.d.ts.map

package/dist/domains/segment.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const query_serializer_1 = __importDefault(require("../query-serializer"));
+class Segment {
+    constructor(name, collectionName, httpRequester, liveQuerySegment) {
+        this.name = name;
+        this.collectionName = collectionName;
+        this.httpRequester = httpRequester;
+        this.liveQuerySegment = liveQuerySegment;
+    }
+    async list(options) {
+        return this.httpRequester.query({
+            method: 'get',
+            path: `/forest/${this.collectionName}`,
+            query: this.serializeQuery(options),
+        });
+    }
+    async exportCsv(stream, options) {
+        await this.httpRequester.stream({
+            path: `/forest/${this.collectionName}.csv`,
+            contentType: 'text/csv',
+            query: {
+                ...this.serializeQuery(options),
+                ...{ header: JSON.stringify(options?.fields) },
+            },
+            stream,
+        });
+    }
+    serializeQuery(options) {
+        if (this.liveQuerySegment) {
+            return query_serializer_1.default.serialize({
+                ...(options ?? {}),
+                ...{
+                    segmentQuery: this.liveQuerySegment.query,
+                    connectionName: this.liveQuerySegment.connectionName,
+                },
+            }, this.collectionName);
+        }
+        return {
+            ...query_serializer_1.default.serialize(options, this.collectionName),
+            segment: this.name,
+        };
+    }
+}
+exports.default = Segment;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VnbWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9kb21haW5zL3NlZ21lbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFLQSwyRUFBa0Q7QUFFbEQsTUFBcUIsT0FBTztJQU0xQixZQUNFLElBQXdCLEVBQ3hCLGNBQXNCLEVBQ3RCLGFBQTRCLEVBQzVCLGdCQUFtQztRQUVuQyxJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQztRQUNqQixJQUFJLENBQUMsY0FBYyxHQUFHLGNBQWMsQ0FBQztRQUNyQyxJQUFJLENBQUMsYUFBYSxHQUFHLGFBQWEsQ0FBQztRQUNuQyxJQUFJLENBQUMsZ0JBQWdCLEdBQUcsZ0JBQWdCLENBQUM7SUFDM0MsQ0FBQztJQUVELEtBQUssQ0FBQyxJQUFJLENBQWlCLE9BQXVCO1FBQ2hELE9BQU8sSUFBSSxDQUFDLGFBQWEsQ0FBQyxLQUFLLENBQVM7WUFDdEMsTUFBTSxFQUFFLEtBQUs7WUFDYixJQUFJLEVBQUUsV0FBVyxJQUFJLENBQUMsY0FBYyxFQUFFO1lBQ3RDLEtBQUssRUFBRSxJQUFJLENBQUMsY0FBYyxDQUFDLE9BQU8sQ0FBQztTQUNwQyxDQUFDLENBQUM7SUFDTCxDQUFDO0lBRUQsS0FBSyxDQUFDLFNBQVMsQ0FBQyxNQUFtQixFQUFFLE9BQXVCO1FBQzFELE1BQU0sSUFBSSxDQUFDLGFBQWEsQ0FBQyxNQUFNLENBQUM7WUFDOUIsSUFBSSxFQUFFLFdBQVcsSUFBSSxDQUFDLGNBQWMsTUFBTTtZQUMxQyxXQUFXLEVBQUUsVUFBVTtZQUN2QixLQUFLLEVBQUU7Z0JBQ0wsR0FBRyxJQUFJLENBQUMsY0FBYyxDQUFDLE9BQU8sQ0FBQztnQkFDL0IsR0FBRyxFQUFFLE1BQU0sRUFBRSxJQUFJLENBQUMsU0FBUyxDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsRUFBRTthQUMvQztZQUNELE1BQU07U0FDUCxDQUFDLENBQUM7SUFDTCxDQUFDO0lBRU8sY0FBYyxDQUFDLE9BQXVCO1FBQzVDLElBQUksSUFBSSxDQUFDLGdCQUFnQixFQUFFLENBQUM7WUFDMUIsT0FBTywwQkFBZSxDQUFDLFNBQVMsQ0FDOUI7Z0JBQ0UsR0FBRyxDQUFDLE9BQU8sSUFBSSxFQUFFLENBQUM7Z0JBQ2xCLEdBQUc7b0JBQ0QsWUFBWSxFQUFFLElBQUksQ0FBQyxnQkFBZ0IsQ0FBQyxLQUFLO29CQUN6QyxjQUFjLEVBQUUsSUFBSSxDQUFDLGdCQUFnQixDQUFDLGNBQWM7aUJBQ3JEO2FBQ0YsRUFDRCxJQUFJLENBQUMsY0FBYyxDQUNwQixDQUFDO1FBQ0osQ0FBQztRQUVELE9BQU87WUFDTCxHQUFHLDBCQUFlLENBQUMsU0FBUyxDQUFDLE9BQU8sRUFBRSxJQUFJLENBQUMsY0FBYyxDQUFDO1lBQzFELE9BQU8sRUFBRSxJQUFJLENBQUMsSUFBSTtTQUNuQixDQUFDO0lBQ0osQ0FBQztDQUNGO0FBekRELDBCQXlEQyJ9

package/dist/http-requester.d.ts

@@ -0,0 +1,28 @@
+import { WriteStream } from 'fs';
+export default class HttpRequester {
+    private readonly token;
+    private readonly options;
+    private readonly deserializer;
+    private get baseUrl();
+    constructor(token: string, options: {
+        prefix?: string;
+        url: string;
+    });
+    query<Data = unknown>({ method, path, body, query, maxTimeAllowed, contentType, }: {
+        method: 'get' | 'post' | 'put' | 'delete';
+        path: string;
+        body?: Record<string, unknown>;
+        query?: Record<string, unknown>;
+        maxTimeAllowed?: number;
+        contentType?: 'application/json' | 'text/csv';
+    }): Promise<Data>;
+    stream({ path: reqPath, query, contentType, maxTimeAllowed, stream, }: {
+        path: string;
+        query?: Record<string, unknown>;
+        contentType: 'text/csv';
+        maxTimeAllowed?: number;
+        stream: WriteStream;
+    }): Promise<void>;
+    static escapeUrlSlug(name: string): string;
+}
+//# sourceMappingURL=http-requester.d.ts.map

package/dist/http-requester.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsonapi_serializer_1 = require("jsonapi-serializer");
+const superagent_1 = __importDefault(require("superagent"));
+class HttpRequester {
+    get baseUrl() {
+        const prefix = this.options.prefix ? `/${this.options.prefix}` : '';
+        return `${this.options.url}${prefix}`;
+    }
+    constructor(token, options) {
+        this.token = token;
+        this.options = options;
+        this.deserializer = new jsonapi_serializer_1.Deserializer({ keyForAttribute: 'camelCase' });
+    }
+    async query({ method, path, body, query, maxTimeAllowed, contentType, }) {
+        try {
+            const url = new URL(`${this.baseUrl}${HttpRequester.escapeUrlSlug(path)}`).toString();
+            const req = superagent_1.default[method](url)
+                .timeout(maxTimeAllowed ?? 10000)
+                .set('Authorization', `Bearer ${this.token}`)
+                .set('Content-Type', contentType ?? 'application/json')
+                .query({ timezone: 'Europe/Paris', ...query });
+            if (body)
+                req.send(body);
+            const response = await req;
+            try {
+                return (await this.deserializer.deserialize(response.body));
+            }
+            catch {
+                return (response.body ?? response.text);
+            }
+        }
+        catch (error) {
+            if (!error.response)
+                throw error;
+            throw new Error(JSON.stringify({ error: error.response.error, body }, null, 4));
+        }
+    }
+    async stream({ path: reqPath, query, contentType = 'text/csv', maxTimeAllowed, stream, }) {
+        const url = new URL(`${this.baseUrl}${HttpRequester.escapeUrlSlug(reqPath)}`).toString();
+        return new Promise((resolve, reject) => {
+            superagent_1.default
+                .get(url)
+                .timeout(maxTimeAllowed ?? 10000)
+                .set('Authorization', `Bearer ${this.token}`)
+                .set('Accept', contentType)
+                .query({ timezone: 'Europe/Paris', ...query })
+                .pipe(stream)
+                .on('finish', () => {
+                resolve();
+            })
+                .on('error', err => {
+                console.error('Error occurred while streaming response:', err);
+                reject(err);
+            });
+        });
+    }
+    static escapeUrlSlug(name) {
+        return encodeURI(name).replace(/([+?*])/g, '\\$1');
+    }
+}
+exports.default = HttpRequester;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaHR0cC1yZXF1ZXN0ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaHR0cC1yZXF1ZXN0ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFDQSwyREFBa0Q7QUFDbEQsNERBQW9DO0FBRXBDLE1BQXFCLGFBQWE7SUFHaEMsSUFBWSxPQUFPO1FBQ2pCLE1BQU0sTUFBTSxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxJQUFJLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztRQUVwRSxPQUFPLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FBQyxHQUFHLEdBQUcsTUFBTSxFQUFFLENBQUM7SUFDeEMsQ0FBQztJQUVELFlBQ21CLEtBQWEsRUFDYixPQUF5QztRQUR6QyxVQUFLLEdBQUwsS0FBSyxDQUFRO1FBQ2IsWUFBTyxHQUFQLE9BQU8sQ0FBa0M7UUFFMUQsSUFBSSxDQUFDLFlBQVksR0FBRyxJQUFJLGlDQUFZLENBQUMsRUFBRSxlQUFlLEVBQUUsV0FBVyxFQUFFLENBQUMsQ0FBQztJQUN6RSxDQUFDO0lBRUQsS0FBSyxDQUFDLEtBQUssQ0FBaUIsRUFDMUIsTUFBTSxFQUNOLElBQUksRUFDSixJQUFJLEVBQ0osS0FBSyxFQUNMLGNBQWMsRUFDZCxXQUFXLEdBUVo7UUFDQyxJQUFJLENBQUM7WUFDSCxNQUFNLEdBQUcsR0FBRyxJQUFJLEdBQUcsQ0FBQyxHQUFHLElBQUksQ0FBQyxPQUFPLEdBQUcsYUFBYSxDQUFDLGFBQWEsQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUMsUUFBUSxFQUFFLENBQUM7WUFFdEYsTUFBTSxHQUFHLEdBQUcsb0JBQVUsQ0FBQyxNQUFNLENBQUMsQ0FBQyxHQUFHLENBQUM7aUJBQ2hDLE9BQU8sQ0FBQyxjQUFjLElBQUksS0FBTSxDQUFDO2lCQUNqQyxHQUFHLENBQUMsZUFBZSxFQUFFLFVBQVUsSUFBSSxD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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { ActionEndpointsByCollection } from './domains/action';
+import RemoteAgentClient, { PermissionsOverride } from './domains/remote-agent-client';
+export declare function createRemoteAgentClient(params: {
+    overridePermissions?: (permissions: PermissionsOverride) => Promise<void>;
+    actionEndpoints?: ActionEndpointsByCollection;
+    token?: string;
+    url: string;
+}): RemoteAgentClient<Record<string, unknown>>;
+export type { SelectOptions } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRemoteAgentClient = createRemoteAgentClient;
+const remote_agent_client_1 = __importDefault(require("./domains/remote-agent-client"));
+const http_requester_1 = __importDefault(require("./http-requester"));
+// eslint-disable-next-line import/prefer-default-export
+function createRemoteAgentClient(params) {
+    const httpRequester = new http_requester_1.default(params.token, { url: params.url });
+    return new remote_agent_client_1.default({
+        actionEndpoints: params.actionEndpoints,
+        httpRequester,
+        overridePermissions: params.overridePermissions,
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFLQSwwREFhQztBQWpCRCx3RkFBdUY7QUFDdkYsc0VBQTZDO0FBRTdDLHdEQUF3RDtBQUN4RCxTQUFnQix1QkFBdUIsQ0FBQyxNQUt2QztJQUNDLE1BQU0sYUFBYSxHQUFHLElBQUksd0JBQWEsQ0FBQyxNQUFNLENBQUMsS0FBSyxFQUFFLEVBQUUsR0FBRyxFQUFFLE1BQU0sQ0FBQyxHQUFHLEVBQUUsQ0FBQyxDQUFDO0lBRTNFLE9BQU8sSUFBSSw2QkFBaUIsQ0FBQztRQUMzQixlQUFlLEVBQUUsTUFBTSxDQUFDLGVBQWU7UUFDdkMsYUFBYTtRQUNiLG1CQUFtQixFQUFFLE1BQU0sQ0FBQyxtQkFBbUI7S0FDaEQsQ0FBQyxDQUFDO0FBQ0wsQ0FBQyJ9

package/dist/query-serializer.d.ts

@@ -0,0 +1,8 @@
+import type { SelectOptions } from './types';
+export default class QuerySerializer {
+    static serialize(query: SelectOptions, collectionName: string): Record<string, unknown>;
+    private static formatSort;
+    private static formatFilters;
+    private static formatFields;
+}
+//# sourceMappingURL=query-serializer.d.ts.map

package/dist/query-serializer.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const http_requester_1 = __importDefault(require("./http-requester"));
+class QuerySerializer {
+    static serialize(query, collectionName) {
+        if (!query)
+            return {};
+        return {
+            ...query,
+            ...query.filters,
+            sort: QuerySerializer.formatSort(query.sort),
+            filters: QuerySerializer.formatFilters(query.filters),
+            searchExtended: !!query.shouldSearchInRelation,
+            'page[size]': query.pagination?.size,
+            'page[number]': query.pagination?.number,
+            ...(query.fields?.length ? QuerySerializer.formatFields(collectionName, query.fields) : {}),
+        };
+    }
+    static formatSort(sort) {
+        if (!sort)
+            return undefined;
+        return sort.ascending ? sort.field : `-${sort.field}`;
+    }
+    static formatFilters(filters) {
+        if (!filters)
+            return undefined;
+        return JSON.stringify(filters);
+    }
+    static formatFields(collectionName, fields) {
+        if (!fields)
+            return {};
+        const projectionName = `fields[${http_requester_1.default.escapeUrlSlug(collectionName)}]`;
+        const projection = {
+            [projectionName]: [],
+        };
+        fields.forEach(field => {
+            // Skip empty or whitespace-only field names
+            const trimmedField = field.trim();
+            if (!trimmedField)
+                return;
+            if (trimmedField.includes('@@@')) {
+                const separatorIndex = trimmedField.indexOf('@@@');
+                const relatedCollection = trimmedField.substring(0, separatorIndex);
+                const relatedField = trimmedField.substring(separatorIndex + 3);
+                const trimmedRelation = relatedCollection.trim();
+                const trimmedRelatedField = relatedField?.trim();
+                // Validate: both relation name and field must be non-empty
+                if (!trimmedRelation || !trimmedRelatedField) {
+                    // Skip malformed separators like "@@@field", "relation@@@", or "@@@"
+                    return;
+                }
+                // Avoid duplicate relation names in the projection array
+                if (!projection[projectionName].includes(trimmedRelation)) {
+                    projection[projectionName].push(trimmedRelation);
+                }
+                // Add related field to its collection projection
+                const relatedProjectionName = `fields[${http_requester_1.default.escapeUrlSlug(trimmedRelation)}]`;
+                if (!projection[relatedProjectionName]) {
+                    projection[relatedProjectionName] = [];
+                }
+                if (!projection[relatedProjectionName].includes(trimmedRelatedField)) {
+                    projection[relatedProjectionName].push(trimmedRelatedField);
+                }
+            }
+            else if (!projection[projectionName].includes(trimmedField)) {
+                // Avoid duplicate field names
+                projection[projectionName].push(trimmedField);
+            }
+        });
+        return projection;
+    }
+}
+exports.default = QuerySerializer;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicXVlcnktc2VyaWFsaXplci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9xdWVyeS1zZXJpYWxpemVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7O0FBR0Esc0VBQTZDO0FBRTdDLE1BQXFCLGVBQWU7SUFDbEMsTUFBTSxDQUFDLFNBQVMsQ0FBQyxLQUFvQixFQUFFLGNBQXNCO1FBQzNELElBQUksQ0FBQyxLQUFLO1lBQUUsT0FBTyxFQUFFLENBQUM7UUFFdEIsT0FBTztZQUNMLEdBQUcsS0FBSztZQUNSLEdBQUcsS0FBSyxDQUFDLE9BQU87WUFDaEIsSUFBSSxFQUFFLGVBQWUsQ0FBQyxVQUFVLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQztZQUM1QyxPQUFPLEVBQUUsZUFBZSxDQUFDLGFBQWEsQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDO1lBQ3JELGNBQWMsRUFBRSxDQUFDLENBQUMsS0FBSyxDQUFDLHNCQUFzQjtZQUM5QyxZQUFZLEVBQUUsS0FBSyxDQUFDLFVBQVUsRUFBRSxJQUFJO1lBQ3BDLGNBQWMsRUFBRSxLQUFLLENBQUMsVUFBVSxFQUFFLE1BQU07WUFDeEMsR0FBRyxDQUFDLEtBQUssQ0FBQyxNQUFNLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FBQyxlQUFlLENBQUMsWUFBWSxDQUFDLGNBQWMsRUFBRSxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztTQUM1RixDQUFDO0lBQ0osQ0FBQztJQUVPLE1BQU0sQ0FBQyxVQUFVLENBQUMsSUFBcUI7UUFDN0MsSUFBSSxDQUFDLElBQUk7WUFBRSxPQUFPLFNBQVMsQ0FBQztRQUU1QixPQUFPLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLElBQUksSUFBSSxDQUFDLEtBQUssRUFBRSxDQUFDO0lBQ3hELENBQUM7SUFFTyxNQUFNLENBQUMsYUFBYSxDQUFDLE9BQXFDO1FBQ2hF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

package/dist/types.d.ts

@@ -0,0 +1,26 @@
+import { PlainFilter, PlainSortClause } from '@forestadmin/datasource-toolkit';
+export type BaseOptions = {
+    filters?: PlainFilter['conditionTree'];
+    sort?: PlainSortClause;
+    search?: string;
+    fields?: string[];
+    shouldSearchInRelation?: boolean;
+};
+export type ExportOptions = BaseOptions;
+export type LiveQueryOptions = {
+    connectionName: string;
+    query: string;
+};
+export type SegmentOptions = BaseOptions & {
+    liveQuerySegment?: {
+        connectionName: string;
+        query: string;
+    };
+};
+export type SelectOptions = BaseOptions & {
+    pagination?: {
+        size?: number;
+        number?: number;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forestadmin/agent-client",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "main": "dist/index.js",
   "license": "GPL-3.0",
   "publishConfig": {
@@ -12,21 +12,11 @@
     "directory": "packages/agent-client"
   },
   "dependencies": {
-    "@forestadmin/datasource-customizer": "1.67.1",
     "@forestadmin/datasource-toolkit": "1.50.0",
-    "@forestadmin/forestadmin-client": "1.36.14",
+    "@forestadmin/forestadmin-client": "1.37.0",
     "jsonapi-serializer": "^3.6.9",
-    "jsonwebtoken": "^9.0.0",
     "superagent": "^10.2.3"
   },
-  "peerDependencies": {
-    "@forestadmin/agent": "^1.0.0"
-  },
-  "peerDependenciesMeta": {
-    "@forestadmin/agent": {
-      "optional": true
-    }
-  },
   "files": [
     "dist/**/*.js",
     "dist/**/*.d.ts"
@@ -39,8 +29,6 @@
     "test": "jest"
   },
   "devDependencies": {
-    "@forestadmin/agent": "1.66.2",
-    "@types/jsonwebtoken": "^9.0.1",
     "@types/superagent": "^8.1.9"
   }
 }