@forestadmin/datasource-zendesk 1.0.0

package/README.md

@@ -0,0 +1,162 @@
+# @forestadmin/datasource-zendesk
+
+Forest Admin datasource for Zendesk Support, with optional smart-action plugins.
+
+Exposes three collections wired to the Zendesk REST + Search APIs:
+
+| Forest collection       | Zendesk resource | CRUD          | Aggregation     |
+| ----------------------- | ---------------- | ------------- | --------------- |
+| `zendesk_ticket`        | Ticket           | List, create, update, delete | Count only |
+| `zendesk_user`          | User             | List, create, update, delete | Count only |
+| `zendesk_organization`  | Organization     | List, create, update, delete | Count only |
+
+The datasource introspects Zendesk **custom fields** on startup (ticket, user, organization) and registers them as Forest columns.
+
+## Installation
+
+```bash
+yarn add @forestadmin/datasource-zendesk
+```
+
+## Quick start
+
+```ts
+import { createAgent } from '@forestadmin/agent';
+import {
+  createZendeskClient,
+  createZendeskDataSource,
+  closeTicketPlugin,
+  createTicketWithNotificationPlugin,
+} from '@forestadmin/datasource-zendesk';
+
+const zendeskClient = createZendeskClient({
+  subdomain: process.env.ZENDESK_SUBDOMAIN!,
+  email: process.env.ZENDESK_EMAIL!,
+  apiToken: process.env.ZENDESK_API_TOKEN!,
+});
+
+const agent = createAgent({ /* ... */ })
+  .addDataSource(createZendeskDataSource({ client: zendeskClient }))
+
+  // Smart action on Zendesk tickets: Mark as solved / closed.
+  .customizeCollection('zendesk_ticket', collection =>
+    collection.use(closeTicketPlugin, {
+      client: zendeskClient,
+      ticketIdField: 'id',
+    }),
+  )
+
+  // Smart action on ANY collection (here: customers): create a Zendesk ticket
+  // and notify the requester by email.
+  .customizeCollection('customers', collection =>
+    collection.use(createTicketWithNotificationPlugin, {
+      client: zendeskClient,
+      requesterEmailDefault: record => String(record.email ?? ''),
+      defaultSubject: 'Follow-up about your account',
+      ticketIdField: 'last_zendesk_ticket_id',
+    }),
+  );
+```
+
+## Datasource
+
+### `createZendeskDataSource(options)`
+
+`options` accepts either an already-built `client` (recommended when also passing it to plugins) or raw credentials:
+
+```ts
+createZendeskDataSource({ client: createZendeskClient({ subdomain, email, apiToken }) });
+
+// or
+createZendeskDataSource({ subdomain, email, apiToken });
+```
+
+### Filter operators
+
+Zendesk Search supports a restricted set of operators. The datasource exposes:
+
+- `Equal`, `In` for the primary key (`id`), resolved by id lookup outside of Search
+- `Equal`, `NotEqual`, `In`, `NotIn`, `Present`, `Blank` for strings and enums
+- `Equal`, `NotEqual` for booleans
+- `Equal`, `NotEqual`, `In`, `NotIn`, `Present`, `Blank`, `GreaterThan`, `LessThan` for numbers
+- `Equal`, `Before`, `After`, `Present`, `Blank` for dates
+
+Zendesk Search has no `OR` operator. Multi-value membership (`In`/`NotIn`) on the primary key matches each value exactly (id lookup), but on other fields Zendesk ANDs the terms — so `status In ['open', 'pending']` returns nothing. Unsupported operators (`Contains`, `Or` aggregator, …) raise `UnsupportedOperatorError`. The Zendesk Search API caps result pagination at 1000 records — large skips raise the same error.
+
+### Custom fields
+
+On boot, the datasource calls `GET /ticket_fields.json`, `/user_fields.json` and `/organization_fields.json`. Active fields are mapped to Forest columns:
+
+| Zendesk type | Forest column |
+| ------------ | ------------- |
+| `text`, `textarea`, `regexp`, `partialcreditcard` | `String` |
+| `integer`, `decimal`, `lookup` | `Number` |
+| `date` | `Dateonly` |
+| `checkbox` | `Boolean` |
+| `dropdown`, `tagger` | `Enum` (or `String` if no options) |
+| `multiselect` | `Json` |
+
+Ticket custom fields are exposed as `custom_<id>`; user/organization ones use the Zendesk `key`.
+
+## Plugins
+
+Both plugins accept the same client contract as the datasource: pass an
+already-built `client`, **or** raw credentials (`subdomain`, `email`, `apiToken`)
+and the plugin builds one for you. Reusing a single client across the datasource
+and the plugins is recommended, but no longer required.
+
+```ts
+// with a shared client
+collection.use(closeTicketPlugin, { client, ticketIdField: 'id' });
+
+// or with raw credentials (client is optional)
+collection.use(closeTicketPlugin, {
+  subdomain: process.env.ZENDESK_SUBDOMAIN!,
+  email: process.env.ZENDESK_EMAIL!,
+  apiToken: process.env.ZENDESK_API_TOKEN!,
+  ticketIdField: 'id',
+});
+```
+
+### `closeTicketPlugin`
+
+Adds Single + Bulk actions to mark Zendesk tickets as `solved` or `closed`. Tickets that Zendesk reports as already closed are folded into the success message rather than counted as failures.
+
+```ts
+collection.use(closeTicketPlugin, {
+  client,
+  ticketIdField: 'zendesk_id',
+  // optional:
+  statuses: ['solved'],            // default: ['solved', 'closed']
+  scopes: ['Single'],              // default: ['Single', 'Bulk']
+});
+```
+
+### `createTicketWithNotificationPlugin`
+
+Adds a Single action that creates a Zendesk ticket. Useful on a customer-facing collection so an agent can reach out without leaving Forest. With `emailTemplates`, the form becomes two-page (template picker → body).
+
+```ts
+collection.use(createTicketWithNotificationPlugin, {
+  client,
+  actionName: 'Notify customer',                 // optional
+  emailTemplates: [
+    { title: 'Welcome', content: 'Hi {{ record.first_name }}, welcome aboard.' },
+  ],
+  requesterEmailDefault: record => String(record.email ?? ''),
+  defaultSubject: 'Follow-up',
+  priorityOverride: 'normal',                    // hides Priority from the form
+  ticketIdField: 'last_zendesk_ticket_id',       // best-effort writeback after creation
+  showInternalNote: true,                        // adds a "Send as internal note" toggle
+});
+```
+
+Template interpolation supports `{{ record.field }}` (including dotted paths like `{{ record.org.name }}`).
+
+## Errors
+
+All exceptions raised by the datasource are subclasses of Forest Admin's `BusinessError` / `ValidationError`:
+
+- `ZendeskConfigurationError` — missing/invalid client options
+- `ZendeskApiError` — Zendesk HTTP failure (carries the operation, status code and response body)
+- `UnsupportedOperatorError` — filter / aggregation that Zendesk cannot express

package/dist/client/index.d.ts

@@ -0,0 +1,91 @@
+import type { CustomFieldEntry, SearchParams, ZendeskClientOptions, ZendeskRecord, ZendeskResource } from '../types';
+import type { Logger } from '@forestadmin/datasource-toolkit';
+export declare const MAX_PER_PAGE = 100;
+export declare const MAX_TOTAL_RESULTS = 1000;
+export type RawCustomFieldDefinition = {
+    id: number;
+    key?: string;
+    title?: string;
+    raw_title?: string;
+    type: string;
+    active?: boolean;
+    removable?: boolean;
+    custom_field_options?: Array<{
+        value: string;
+        name?: string;
+    }>;
+};
+export type ZendeskClient = {
+    search(type: ZendeskResource, params: SearchParams): Promise<ZendeskRecord[]>;
+    count(type: ZendeskResource, query: string): Promise<number>;
+    findTicket(id: number | string): Promise<ZendeskRecord | null>;
+    findUser(id: number | string): Promise<ZendeskRecord | null>;
+    findOrganization(id: number | string): Promise<ZendeskRecord | null>;
+    fetchTicketsByIds(ids: Array<number | string>): Promise<Map<number, ZendeskRecord>>;
+    fetchUsersByIds(ids: Array<number | string>): Promise<Map<number, ZendeskRecord>>;
+    fetchOrganizationsByIds(ids: Array<number | string>): Promise<Map<number, ZendeskRecord>>;
+    fetchUserEmails(ids: Array<number | string>): Promise<Map<number, string>>;
+    fetchTicketComments(ticketId: number | string): Promise<ZendeskRecord[]>;
+    fetchTicketFields(): Promise<RawCustomFieldDefinition[]>;
+    fetchUserFields(): Promise<RawCustomFieldDefinition[]>;
+    fetchOrganizationFields(): Promise<RawCustomFieldDefinition[]>;
+    createTicket(attrs: ZendeskRecord): Promise<ZendeskRecord>;
+    updateTicket(id: number | string, attrs: ZendeskRecord): Promise<ZendeskRecord>;
+    deleteTicket(id: number | string): Promise<void>;
+    createUser(attrs: ZendeskRecord): Promise<ZendeskRecord>;
+    updateUser(id: number | string, attrs: ZendeskRecord): Promise<ZendeskRecord>;
+    deleteUser(id: number | string): Promise<void>;
+    createOrganization(attrs: ZendeskRecord): Promise<ZendeskRecord>;
+    updateOrganization(id: number | string, attrs: ZendeskRecord): Promise<ZendeskRecord>;
+    deleteOrganization(id: number | string): Promise<void>;
+    readonly baseUrl: string;
+    /**
+     * Best-effort wrapper that logs and returns the default if the action throws.
+     * Used internally and exposed so embedders/plugins can degrade gracefully.
+     */
+    bestEffort<T>(operation: string, defaultValue: T, fn: () => Promise<T>): Promise<T>;
+};
+export declare class ZendeskHttpClient implements ZendeskClient {
+    readonly baseUrl: string;
+    private readonly authHeader;
+    private readonly logger?;
+    constructor(options: ZendeskClientOptions, logger?: Logger);
+    search(type: ZendeskResource, params: SearchParams): Promise<ZendeskRecord[]>;
+    count(type: ZendeskResource, query: string): Promise<number>;
+    findTicket(id: number | string): Promise<ZendeskRecord | null>;
+    findUser(id: number | string): Promise<ZendeskRecord | null>;
+    findOrganization(id: number | string): Promise<ZendeskRecord | null>;
+    fetchTicketsByIds(ids: Array<number | string>): Promise<Map<number, ZendeskRecord>>;
+    fetchUsersByIds(ids: Array<number | string>): Promise<Map<number, ZendeskRecord>>;
+    fetchOrganizationsByIds(ids: Array<number | string>): Promise<Map<number, ZendeskRecord>>;
+    fetchUserEmails(ids: Array<number | string>): Promise<Map<number, string>>;
+    fetchTicketComments(ticketId: number | string): Promise<ZendeskRecord[]>;
+    fetchTicketFields(): Promise<RawCustomFieldDefinition[]>;
+    fetchUserFields(): Promise<RawCustomFieldDefinition[]>;
+    fetchOrganizationFields(): Promise<RawCustomFieldDefinition[]>;
+    createTicket(attrs: ZendeskRecord): Promise<ZendeskRecord>;
+    updateTicket(id: number | string, attrs: ZendeskRecord): Promise<ZendeskRecord>;
+    deleteTicket(id: number | string): Promise<void>;
+    createUser(attrs: ZendeskRecord): Promise<ZendeskRecord>;
+    updateUser(id: number | string, attrs: ZendeskRecord): Promise<ZendeskRecord>;
+    deleteUser(id: number | string): Promise<void>;
+    createOrganization(attrs: ZendeskRecord): Promise<ZendeskRecord>;
+    updateOrganization(id: number | string, attrs: ZendeskRecord): Promise<ZendeskRecord>;
+    deleteOrganization(id: number | string): Promise<void>;
+    bestEffort<T>(operation: string, defaultValue: T, fn: () => Promise<T>): Promise<T>;
+    private findOne;
+    private showMany;
+    private fetchFields;
+    private createOne;
+    private updateOne;
+    private deleteOne;
+    private mustSucceed;
+    private get;
+    private post;
+    private put;
+    private delete;
+    private send;
+}
+export declare function createZendeskClient(options: ZendeskClientOptions, logger?: Logger): ZendeskClient;
+export type { CustomFieldEntry };
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.js

@@ -0,0 +1,243 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZendeskHttpClient = exports.MAX_TOTAL_RESULTS = exports.MAX_PER_PAGE = void 0;
+exports.createZendeskClient = createZendeskClient;
+const superagent_1 = __importDefault(require("superagent"));
+const errors_1 = require("../errors");
+exports.MAX_PER_PAGE = 100;
+exports.MAX_TOTAL_RESULTS = 1000;
+const RESOURCE_PLURAL = {
+    ticket: 'tickets',
+    user: 'users',
+    organization: 'organizations',
+};
+function composeQuery(type, query) {
+    const parts = [type ? `type:${type}` : null, (query ?? '').trim()].filter(Boolean);
+    return parts.join(' ').trim();
+}
+function extractResource(body, key, operation) {
+    const resource = body[key];
+    if (resource && typeof resource === 'object' && !Array.isArray(resource)) {
+        return resource;
+    }
+    throw new errors_1.ZendeskApiError(operation, undefined, body, new Error(`Zendesk API returned an unexpected body shape (missing '${key}')`));
+}
+function validate(options) {
+    const missing = [];
+    if (!options?.subdomain?.trim())
+        missing.push('subdomain');
+    if (!options?.email?.trim())
+        missing.push('email');
+    if (!options?.apiToken?.trim())
+        missing.push('apiToken');
+    if (missing.length > 0) {
+        throw new errors_1.ZendeskConfigurationError(`Zendesk client is missing required configuration: ${missing.join(', ')}`);
+    }
+}
+class ZendeskHttpClient {
+    constructor(options, logger) {
+        validate(options);
+        this.baseUrl = `https://${options.subdomain}.zendesk.com/api/v2`;
+        const credentials = Buffer.from(`${options.email}/token:${options.apiToken}`).toString('base64');
+        this.authHeader = `Basic ${credentials}`;
+        this.logger = logger;
+    }
+    async search(type, params) {
+        const query = composeQuery(type, params.query);
+        const perPage = Math.min(params.perPage ?? exports.MAX_PER_PAGE, exports.MAX_PER_PAGE);
+        return this.mustSucceed(`search(${type})`, async () => {
+            const queryParams = {
+                query,
+                per_page: perPage,
+                page: params.page ?? 1,
+            };
+            if (params.sortBy)
+                queryParams.sort_by = params.sortBy;
+            if (params.sortOrder)
+                queryParams.sort_order = params.sortOrder;
+            const body = await this.get('/search.json', queryParams);
+            return Array.isArray(body.results) ? body.results : [];
+        });
+    }
+    async count(type, query) {
+        return this.mustSucceed(`count(${type})`, async () => {
+            const body = await this.get('/search/count.json', { query: composeQuery(type, query) });
+            return typeof body.count === 'number' ? body.count : 0;
+        });
+    }
+    findTicket(id) {
+        return this.findOne('ticket', id);
+    }
+    findUser(id) {
+        return this.findOne('user', id);
+    }
+    findOrganization(id) {
+        return this.findOne('organization', id);
+    }
+    fetchTicketsByIds(ids) {
+        return this.showMany('ticket', ids, (r) => [Number(r.id), r]);
+    }
+    fetchUsersByIds(ids) {
+        return this.bestEffort('fetch_users_by_ids', new Map(), () => this.showMany('user', ids, r => [Number(r.id), r]));
+    }
+    fetchOrganizationsByIds(ids) {
+        return this.bestEffort('fetch_organizations_by_ids', new Map(), () => this.showMany('organization', ids, r => [Number(r.id), r]));
+    }
+    fetchUserEmails(ids) {
+        return this.bestEffort('fetch_user_emails', new Map(), () => this.showMany('user', ids, r => [Number(r.id), String(r.email ?? '')]));
+    }
+    async fetchTicketComments(ticketId) {
+        return this.mustSucceed(`fetch_ticket_comments(${ticketId})`, async () => {
+            const body = await this.get(`/tickets/${encodeURIComponent(String(ticketId))}/comments.json`);
+            return Array.isArray(body.comments) ? body.comments : [];
+        });
+    }
+    fetchTicketFields() {
+        return this.fetchFields('ticket_fields');
+    }
+    fetchUserFields() {
+        return this.fetchFields('user_fields');
+    }
+    fetchOrganizationFields() {
+        return this.fetchFields('organization_fields');
+    }
+    createTicket(attrs) {
+        return this.createOne('ticket', attrs);
+    }
+    updateTicket(id, attrs) {
+        return this.updateOne('ticket', id, attrs);
+    }
+    deleteTicket(id) {
+        return this.deleteOne('ticket', id);
+    }
+    createUser(attrs) {
+        return this.createOne('user', attrs);
+    }
+    updateUser(id, attrs) {
+        return this.updateOne('user', id, attrs);
+    }
+    deleteUser(id) {
+        return this.deleteOne('user', id);
+    }
+    createOrganization(attrs) {
+        return this.createOne('organization', attrs);
+    }
+    updateOrganization(id, attrs) {
+        return this.updateOne('organization', id, attrs);
+    }
+    deleteOrganization(id) {
+        return this.deleteOne('organization', id);
+    }
+    async bestEffort(operation, defaultValue, fn) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            this.logger?.('Warn', `[datasource-zendesk] ${operation} failed; degrading: ${err instanceof Error ? err.message : String(err)}`);
+            return defaultValue;
+        }
+    }
+    // ===== Internal helpers =====
+    async findOne(type, id) {
+        const plural = RESOURCE_PLURAL[type];
+        const path = `/${plural}/${encodeURIComponent(String(id))}.json`;
+        try {
+            const body = await this.mustSucceed(`find(${plural}/${id})`, () => this.get(path));
+            return body[type] ?? null;
+        }
+        catch (err) {
+            if (err instanceof errors_1.ZendeskApiError && err.status === 404)
+                return null;
+            throw err;
+        }
+    }
+    async showMany(type, ids, project) {
+        const plural = RESOURCE_PLURAL[type];
+        const uniqueIds = Array.from(new Set(ids.filter(id => id !== null && id !== undefined)));
+        const result = new Map();
+        if (uniqueIds.length === 0)
+            return result;
+        for (let i = 0; i < uniqueIds.length; i += exports.MAX_PER_PAGE) {
+            const chunk = uniqueIds.slice(i, i + exports.MAX_PER_PAGE);
+            // eslint-disable-next-line no-await-in-loop
+            const body = await this.mustSucceed(`fetch_${plural}_by_ids`, () => this.get(`/${plural}/show_many.json`, { ids: chunk.join(',') }));
+            const records = Array.isArray(body[plural]) ? body[plural] : [];
+            for (const record of records) {
+                const [key, value] = project(record);
+                result.set(key, value);
+            }
+        }
+        return result;
+    }
+    async fetchFields(path) {
+        return this.mustSucceed(`fetch_${path}`, async () => {
+            const body = await this.get(`/${path}.json`);
+            return Array.isArray(body[path]) ? body[path] : [];
+        });
+    }
+    async createOne(type, attrs) {
+        const plural = RESOURCE_PLURAL[type];
+        return this.mustSucceed(`create(${plural})`, async () => {
+            const body = await this.post(`/${plural}.json`, { [type]: attrs });
+            return extractResource(body, type, `create(${plural})`);
+        });
+    }
+    async updateOne(type, id, attrs) {
+        const plural = RESOURCE_PLURAL[type];
+        return this.mustSucceed(`update(${plural}/${id})`, async () => {
+            const body = await this.put(`/${plural}/${encodeURIComponent(String(id))}.json`, {
+                [type]: attrs,
+            });
+            return extractResource(body, type, `update(${plural}/${id})`);
+        });
+    }
+    async deleteOne(type, id) {
+        const plural = RESOURCE_PLURAL[type];
+        await this.mustSucceed(`delete(${plural}/${id})`, async () => {
+            await this.delete(`/${plural}/${encodeURIComponent(String(id))}.json`);
+            return null;
+        });
+    }
+    async mustSucceed(operation, fn) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            if (err instanceof errors_1.ZendeskApiError)
+                throw err;
+            const status = err?.status;
+            const body = err?.response?.body;
+            throw new errors_1.ZendeskApiError(operation, status, body, err);
+        }
+    }
+    get(path, query) {
+        const request = superagent_1.default.get(`${this.baseUrl}${path}`);
+        if (query)
+            request.query(query);
+        return this.send(request);
+    }
+    post(path, body) {
+        return this.send(superagent_1.default.post(`${this.baseUrl}${path}`).send(body));
+    }
+    put(path, body) {
+        return this.send(superagent_1.default.put(`${this.baseUrl}${path}`).send(body));
+    }
+    delete(path) {
+        return this.send(superagent_1.default.delete(`${this.baseUrl}${path}`));
+    }
+    async send(request) {
+        const response = await request
+            .set('Authorization', this.authHeader)
+            .set('Accept', 'application/json')
+            .set('Content-Type', 'application/json');
+        return (response.body ?? {});
+    }
+}
+exports.ZendeskHttpClient = ZendeskHttpClient;
+function createZendeskClient(options, logger) {
+    return new ZendeskHttpClient(options, logger);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xpZW50L2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7OztBQTRYQSxrREFFQztBQXBYRCw0REFBb0M7QUFFcEMsc0NBQXVFO0FBRTFELFFBQUEsWUFBWSxHQUFHLEdBQUcsQ0FBQztBQUNuQixRQUFBLGlCQUFpQixHQUFHLElBQUksQ0FBQztBQUV0QyxNQUFNLGVBQWUsR0FBb0M7SUFDdkQsTUFBTSxFQUFFLFNBQVM7SUFDakIsSUFBSSxFQUFFLE9BQU87SUFDYixZQUFZLEVBQUUsZUFBZTtDQUM5QixDQUFDO0FBNENGLFNBQVMsWUFBWSxDQUFDLElBQTRCLEVBQUUsS0FBYTtJQUMvRCxNQUFNLEtBQUssR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsUUFBUSxJQUFJLEVBQUUsQ0FBQyxDQUFDLENBQUMsSUFBSSxFQUFFLENBQUMsS0FBSyxJQUFJLEVBQUUsQ0FBQyxDQUFDLElBQUksRUFBRSxDQUFDLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBYSxDQUFDO0lBRS9GLE9BQU8sS0FBSyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQyxJQUFJLEVBQUUsQ0FBQztBQUNoQyxDQUFDO0FBRUQsU0FBUyxlQUFlLENBQ3RCLElBQW1CLEVBQ25CLEdBQW9CLEVBQ3BCLFNBQWlCO0lBRWpCLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUUzQixJQUFJLFFBQVEsSUFBSSxPQUFPLFFBQVEsS0FBSyxRQUFRLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxFQUFFLENBQUM7UUFDekUsT0FBTyxRQUF5QixDQUFDO0lBQ25DLENBQUM7SUFFRCxNQUFNLElBQUksd0JBQWUsQ0FDdkIsU0FBUyxFQUNULFNBQVMsRUFDVCxJQUFJLEVBQ0osSUFBSSxLQUFLLENBQUMsMkRBQTJELEdBQUcsSUFBSSxDQUFDLENB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

package/dist/client-options.d.ts

@@ -0,0 +1,16 @@
+import type { ZendeskClient } from './client';
+import type { ZendeskClientOptions } from './types';
+import type { Logger } from '@forestadmin/datasource-toolkit';
+/**
+ * A Zendesk client can always be supplied directly, or built on-the-fly from raw
+ * credentials. The datasource factory and the smart-action plugins share this
+ * contract so users never have to instantiate a client by hand when they don't
+ * already have one.
+ */
+export type ZendeskClientProvider = {
+    client: ZendeskClient;
+} | ({
+    client?: never;
+} & ZendeskClientOptions);
+export declare function resolveZendeskClient(options: ZendeskClientProvider, logger?: Logger): ZendeskClient;
+//# sourceMappingURL=client-options.d.ts.map

package/dist/client-options.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveZendeskClient = resolveZendeskClient;
+const client_1 = require("./client");
+function resolveZendeskClient(options, logger) {
+    return 'client' in options && options.client
+        ? options.client
+        : (0, client_1.createZendeskClient)(options, logger);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpZW50LW9wdGlvbnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY2xpZW50LW9wdGlvbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFnQkEsb0RBT0M7QUFuQkQscUNBQStDO0FBWS9DLFNBQWdCLG9CQUFvQixDQUNsQyxPQUE4QixFQUM5QixNQUFlO0lBRWYsT0FBTyxRQUFRLElBQUksT0FBTyxJQUFJLE9BQU8sQ0FBQyxNQUFNO1FBQzFDLENBQUMsQ0FBQyxPQUFPLENBQUMsTUFBTTtRQUNoQixDQUFDLENBQUMsSUFBQSw0QkFBbUIsRUFBQyxPQUErQixFQUFFLE1BQU0sQ0FBQyxDQUFDO0FBQ25FLENBQUMifQ==

package/dist/collections/base-zendesk-collection.d.ts

@@ -0,0 +1,52 @@
+import type { ZendeskClient } from '../client';
+import type { CustomFieldEntry, ZendeskRecord, ZendeskResource } from '../types';
+import type { AggregateResult, Aggregation, Caller, ConditionTree, DataSource, Filter, Logger, PaginatedFilter, Projection, RecordData, Sort } from '@forestadmin/datasource-toolkit';
+import { BaseCollection } from '@forestadmin/datasource-toolkit';
+export { BOOLEAN_OPS, DATE_OPS, ID_OPS, NUMBER_OPS, STRING_OPS } from '../query/operators';
+export default abstract class BaseZendeskCollection extends BaseCollection {
+    protected readonly client: ZendeskClient;
+    protected readonly resource: ZendeskResource;
+    protected readonly sortableFields: Record<string, string>;
+    protected readonly logger?: Logger;
+    protected readonly zendeskIdToColumnName: Map<number, string>;
+    constructor(name: string, datasource: DataSource, client: ZendeskClient, resource: ZendeskResource, sortableFields: Record<string, string>, logger?: Logger);
+    abstract create(caller: Caller, data: RecordData[]): Promise<RecordData[]>;
+    abstract list(caller: Caller, filter: PaginatedFilter, projection: Projection): Promise<RecordData[]>;
+    abstract update(caller: Caller, filter: Filter, patch: RecordData): Promise<void>;
+    abstract delete(caller: Caller, filter: Filter): Promise<void>;
+    aggregate(caller: Caller, filter: Filter, aggregation: Aggregation, limit?: number): Promise<AggregateResult[]>;
+    /** Fetch a single resource by primary key, or null when it does not exist (404). */
+    protected abstract findOne(id: number | string): Promise<ZendeskRecord | null>;
+    /** Convert a raw Zendesk payload into the Forest column layout this collection exposes. */
+    protected abstract serializeRecord(record: ZendeskRecord): RecordData;
+    /**
+     * Count the records matching the filter. An exact id-lookup is resolved by fetching the
+     * referenced records and re-applying the full condition tree in memory, so that non-existent
+     * ids and sibling conditions (scope/segment) are honored rather than blindly trusted.
+     */
+    protected aggregateCount(caller: Caller, filter: Filter): Promise<number>;
+    protected addCustomFields(customFields: CustomFieldEntry[]): void;
+    protected translateSort(sort: Sort | undefined): {
+        sortBy?: string;
+        sortOrder?: 'asc' | 'desc';
+    };
+    protected searchRecords(filter: PaginatedFilter | undefined): Promise<ZendeskRecord[]>;
+    protected fetchRecordsByIds(ids: number[]): Promise<ZendeskRecord[]>;
+    protected serializeForFilter(records: ZendeskRecord[]): Promise<RecordData[]>;
+    protected refine(records: RecordData[], filter: PaginatedFilter | undefined, timezone: string): RecordData[];
+    protected buildZendeskQuery(filter: Filter | PaginatedFilter | undefined): string;
+    /**
+     * Returns the list of primary-key values if the condition tree is an exact `id`
+     * lookup (Equal N or In [N1, N2, ...]), otherwise null. Lets `list/update/delete`
+     * bypass the Search API and hit the resource endpoint directly.
+     */
+    protected extractIdLookup(tree: ConditionTree | undefined): number[] | null;
+    /**
+     * Resolve the primary keys targeted by update/delete. A pure id-lookup is authoritative; an
+     * id-lookup combined with other conditions (scope/segment) is re-checked in memory so we never
+     * mutate a record outside the caller's perimeter. Otherwise every matching page is collected.
+     */
+    protected resolveIds(filter: Filter | undefined, timezone: string): Promise<number[]>;
+    private searchAllIds;
+}
+//# sourceMappingURL=base-zendesk-collection.d.ts.map