@keystrokehq/zendesk 0.0.1

package/dist/users-BDj0GBC8.mjs

@@ -0,0 +1,323 @@
+import { zendeskBulkJobResponseSchema, zendeskUserEnvelopeSchema, zendeskUserListResponseSchema, zendeskUserSchema } from "./schemas.mjs";
+import { n as zendeskPlatformOperation, t as zendeskCustomOperation } from "./factory-BOeuadDj.mjs";
+import { n as createPlatformZendeskClient, t as createCustomZendeskClient } from "./shared-BmxcJmfq.mjs";
+import { z } from "zod";
+
+//#region src/users.ts
+const listUsersInputSchema = z.object({
+	page: z.number().int().positive().optional(),
+	perPage: z.number().int().positive().max(100).optional(),
+	role: z.string().optional()
+});
+const getUserInputSchema = z.object({ id: z.number().int().positive() });
+const searchUsersInputSchema = z.object({ query: z.string().min(1) });
+const userCreateInputSchema = z.object({
+	name: z.string().min(1),
+	email: z.email(),
+	organizationId: z.number().int().positive().optional(),
+	externalId: z.string().optional(),
+	details: z.string().optional(),
+	notes: z.string().optional(),
+	role: z.string().optional()
+});
+const userUpdateInputSchema = z.object({
+	id: z.number().int().positive(),
+	name: z.string().min(1).optional(),
+	email: z.email().optional(),
+	organizationId: z.number().int().positive().optional(),
+	externalId: z.string().optional(),
+	details: z.string().optional(),
+	notes: z.string().optional(),
+	role: z.string().optional(),
+	verified: z.boolean().optional()
+});
+const createManyUsersInputSchema = z.object({ users: z.array(userCreateInputSchema).min(1).max(100) });
+const updateManyUsersInputSchema = z.object({ users: z.array(userUpdateInputSchema).min(1).max(100) });
+const deleteUserInputSchema = z.object({ id: z.number().int().positive() });
+function mapUserInput(input) {
+	return {
+		...input.name ? { name: input.name } : {},
+		...input.email ? { email: input.email } : {},
+		...input.organizationId ? { organization_id: input.organizationId } : {},
+		...input.externalId ? { external_id: input.externalId } : {},
+		...input.details ? { details: input.details } : {},
+		...input.notes ? { notes: input.notes } : {},
+		...input.role ? { role: input.role } : {},
+		..."verified" in input && input.verified !== void 0 ? { verified: input.verified } : {}
+	};
+}
+const platformListUsers = zendeskPlatformOperation({
+	id: "list_users",
+	name: "List Zendesk Users",
+	description: "List users from Zendesk Support",
+	input: listUsersInputSchema,
+	output: zendeskUserListResponseSchema,
+	run: async (input, credentials) => {
+		return createPlatformZendeskClient(credentials).get({
+			path: "/users.json",
+			query: {
+				page: input.page,
+				per_page: input.perPage,
+				role: input.role
+			},
+			schema: zendeskUserListResponseSchema
+		});
+	}
+});
+const customListUsers = zendeskCustomOperation({
+	id: "list_users",
+	name: "List Zendesk Users",
+	description: "List users from Zendesk Support",
+	input: listUsersInputSchema,
+	output: zendeskUserListResponseSchema,
+	run: async (input, credentials) => {
+		return createCustomZendeskClient(credentials).get({
+			path: "/users.json",
+			query: {
+				page: input.page,
+				per_page: input.perPage,
+				role: input.role
+			},
+			schema: zendeskUserListResponseSchema
+		});
+	}
+});
+const platformGetUser = zendeskPlatformOperation({
+	id: "get_user",
+	name: "Get Zendesk User",
+	description: "Get a single Zendesk user by ID",
+	input: getUserInputSchema,
+	output: zendeskUserSchema,
+	run: async (input, credentials) => {
+		return (await createPlatformZendeskClient(credentials).get({
+			path: `/users/${input.id}.json`,
+			schema: zendeskUserEnvelopeSchema
+		})).user;
+	}
+});
+const customGetUser = zendeskCustomOperation({
+	id: "get_user",
+	name: "Get Zendesk User",
+	description: "Get a single Zendesk user by ID",
+	input: getUserInputSchema,
+	output: zendeskUserSchema,
+	run: async (input, credentials) => {
+		return (await createCustomZendeskClient(credentials).get({
+			path: `/users/${input.id}.json`,
+			schema: zendeskUserEnvelopeSchema
+		})).user;
+	}
+});
+const platformGetCurrentUser = zendeskPlatformOperation({
+	id: "get_current_user",
+	name: "Get Current Zendesk User",
+	description: "Get the currently authenticated Zendesk user",
+	input: z.object({}),
+	output: zendeskUserSchema,
+	run: async (_input, credentials) => {
+		return (await createPlatformZendeskClient(credentials).get({
+			path: "/users/me.json",
+			schema: zendeskUserEnvelopeSchema
+		})).user;
+	}
+});
+const customGetCurrentUser = zendeskCustomOperation({
+	id: "get_current_user",
+	name: "Get Current Zendesk User",
+	description: "Get the currently authenticated Zendesk user",
+	input: z.object({}),
+	output: zendeskUserSchema,
+	run: async (_input, credentials) => {
+		return (await createCustomZendeskClient(credentials).get({
+			path: "/users/me.json",
+			schema: zendeskUserEnvelopeSchema
+		})).user;
+	}
+});
+const platformSearchUsers = zendeskPlatformOperation({
+	id: "search_users",
+	name: "Search Zendesk Users",
+	description: "Search Zendesk users with a free-text query",
+	input: searchUsersInputSchema,
+	output: zendeskUserListResponseSchema,
+	run: async (input, credentials) => {
+		return createPlatformZendeskClient(credentials).get({
+			path: "/users/search.json",
+			query: { query: input.query },
+			schema: zendeskUserListResponseSchema
+		});
+	}
+});
+const customSearchUsers = zendeskCustomOperation({
+	id: "search_users",
+	name: "Search Zendesk Users",
+	description: "Search Zendesk users with a free-text query",
+	input: searchUsersInputSchema,
+	output: zendeskUserListResponseSchema,
+	run: async (input, credentials) => {
+		return createCustomZendeskClient(credentials).get({
+			path: "/users/search.json",
+			query: { query: input.query },
+			schema: zendeskUserListResponseSchema
+		});
+	}
+});
+const platformCreateUser = zendeskPlatformOperation({
+	id: "create_user",
+	name: "Create Zendesk User",
+	description: "Create a new Zendesk user",
+	input: userCreateInputSchema,
+	output: zendeskUserSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		return (await createPlatformZendeskClient(credentials).post({
+			path: "/users.json",
+			body: { user: mapUserInput(input) },
+			schema: zendeskUserEnvelopeSchema
+		})).user;
+	}
+});
+const customCreateUser = zendeskCustomOperation({
+	id: "create_user",
+	name: "Create Zendesk User",
+	description: "Create a new Zendesk user",
+	input: userCreateInputSchema,
+	output: zendeskUserSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		return (await createCustomZendeskClient(credentials).post({
+			path: "/users.json",
+			body: { user: mapUserInput(input) },
+			schema: zendeskUserEnvelopeSchema
+		})).user;
+	}
+});
+const platformUpdateUser = zendeskPlatformOperation({
+	id: "update_user",
+	name: "Update Zendesk User",
+	description: "Update an existing Zendesk user",
+	input: userUpdateInputSchema,
+	output: zendeskUserSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		return (await createPlatformZendeskClient(credentials).put({
+			path: `/users/${input.id}.json`,
+			body: { user: mapUserInput(input) },
+			schema: zendeskUserEnvelopeSchema
+		})).user;
+	}
+});
+const customUpdateUser = zendeskCustomOperation({
+	id: "update_user",
+	name: "Update Zendesk User",
+	description: "Update an existing Zendesk user",
+	input: userUpdateInputSchema,
+	output: zendeskUserSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		return (await createCustomZendeskClient(credentials).put({
+			path: `/users/${input.id}.json`,
+			body: { user: mapUserInput(input) },
+			schema: zendeskUserEnvelopeSchema
+		})).user;
+	}
+});
+const platformDeleteUser = zendeskPlatformOperation({
+	id: "delete_user",
+	name: "Delete Zendesk User",
+	description: "Delete a Zendesk user",
+	input: deleteUserInputSchema,
+	output: z.object({ success: z.boolean() }),
+	needsApproval: true,
+	run: async (input, credentials) => {
+		await createPlatformZendeskClient(credentials).delete({
+			path: `/users/${input.id}.json`,
+			schema: z.object({})
+		});
+		return { success: true };
+	}
+});
+const customDeleteUser = zendeskCustomOperation({
+	id: "delete_user",
+	name: "Delete Zendesk User",
+	description: "Delete a Zendesk user",
+	input: deleteUserInputSchema,
+	output: z.object({ success: z.boolean() }),
+	needsApproval: true,
+	run: async (input, credentials) => {
+		await createCustomZendeskClient(credentials).delete({
+			path: `/users/${input.id}.json`,
+			schema: z.object({})
+		});
+		return { success: true };
+	}
+});
+const platformCreateManyUsers = zendeskPlatformOperation({
+	id: "create_many_users",
+	name: "Create Many Zendesk Users",
+	description: "Create multiple Zendesk users asynchronously",
+	input: createManyUsersInputSchema,
+	output: zendeskBulkJobResponseSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		return createPlatformZendeskClient(credentials).post({
+			path: "/users/create_many.json",
+			body: { users: input.users.map(mapUserInput) },
+			schema: zendeskBulkJobResponseSchema
+		});
+	}
+});
+const customCreateManyUsers = zendeskCustomOperation({
+	id: "create_many_users",
+	name: "Create Many Zendesk Users",
+	description: "Create multiple Zendesk users asynchronously",
+	input: createManyUsersInputSchema,
+	output: zendeskBulkJobResponseSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		return createCustomZendeskClient(credentials).post({
+			path: "/users/create_many.json",
+			body: { users: input.users.map(mapUserInput) },
+			schema: zendeskBulkJobResponseSchema
+		});
+	}
+});
+const platformUpdateManyUsers = zendeskPlatformOperation({
+	id: "update_many_users",
+	name: "Update Many Zendesk Users",
+	description: "Update multiple Zendesk users asynchronously",
+	input: updateManyUsersInputSchema,
+	output: zendeskBulkJobResponseSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		return createPlatformZendeskClient(credentials).put({
+			path: "/users/update_many.json",
+			body: { users: input.users.map((user) => ({
+				id: user.id,
+				...mapUserInput(user)
+			})) },
+			schema: zendeskBulkJobResponseSchema
+		});
+	}
+});
+const customUpdateManyUsers = zendeskCustomOperation({
+	id: "update_many_users",
+	name: "Update Many Zendesk Users",
+	description: "Update multiple Zendesk users asynchronously",
+	input: updateManyUsersInputSchema,
+	output: zendeskBulkJobResponseSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		return createCustomZendeskClient(credentials).put({
+			path: "/users/update_many.json",
+			body: { users: input.users.map((user) => ({
+				id: user.id,
+				...mapUserInput(user)
+			})) },
+			schema: zendeskBulkJobResponseSchema
+		});
+	}
+});
+
+//#endregion
+export { platformUpdateManyUsers as _, customGetUser as a, customUpdateManyUsers as c, platformCreateUser as d, platformDeleteUser as f, platformSearchUsers as g, platformListUsers as h, customGetCurrentUser as i, customUpdateUser as l, platformGetUser as m, customCreateUser as n, customListUsers as o, platformGetCurrentUser as p, customDeleteUser as r, customSearchUsers as s, customCreateManyUsers as t, platformCreateManyUsers as u, platformUpdateUser as v };

package/dist/verification.d.mts

@@ -0,0 +1,9 @@
+import { WebhookRequest } from "@keystrokehq/core";
+
+//#region src/verification.d.ts
+declare const DEFAULT_TIMESTAMP_TOLERANCE_SECONDS = 300;
+declare function extractZendeskWebhookInvocationId(request: WebhookRequest): string | undefined;
+declare function calculateZendeskWebhookSignature(request: Pick<WebhookRequest, 'headers' | 'rawBody'>, secret: string): string;
+declare function verifyZendeskWebhookSignature(request: WebhookRequest, secret: string, maxAgeSeconds?: number): void;
+//#endregion
+export { DEFAULT_TIMESTAMP_TOLERANCE_SECONDS, calculateZendeskWebhookSignature, extractZendeskWebhookInvocationId, verifyZendeskWebhookSignature };

package/dist/verification.mjs

@@ -0,0 +1,41 @@
+import crypto from "node:crypto";
+
+//#region src/verification.ts
+const DEFAULT_TIMESTAMP_TOLERANCE_SECONDS = 300;
+function parseZendeskWebhookTimestampMs(timestamp) {
+	const iso = Date.parse(timestamp);
+	if (Number.isFinite(iso)) return iso;
+	const numeric = Number(timestamp);
+	if (!Number.isFinite(numeric)) return;
+	return numeric < 0xe8d4a51000 ? numeric * 1e3 : numeric;
+}
+function getHeader(headers, name) {
+	const lowerName = name.toLowerCase();
+	for (const [headerName, value] of Object.entries(headers)) if (headerName.toLowerCase() === lowerName && value) return value;
+}
+function extractZendeskWebhookInvocationId(request) {
+	return getHeader(request.headers, "x-zendesk-webhook-invocation-id");
+}
+function calculateZendeskWebhookSignature(request, secret) {
+	const timestamp = getHeader(request.headers, "x-zendesk-webhook-signature-timestamp");
+	if (!timestamp) throw new Error("Zendesk webhook signature timestamp header is missing.");
+	return crypto.createHmac("sha256", secret).update(`${timestamp}${request.rawBody}`).digest("base64");
+}
+function verifyZendeskWebhookSignature(request, secret, maxAgeSeconds = DEFAULT_TIMESTAMP_TOLERANCE_SECONDS) {
+	const signature = getHeader(request.headers, "x-zendesk-webhook-signature");
+	const timestamp = getHeader(request.headers, "x-zendesk-webhook-signature-timestamp");
+	if (!signature) throw new Error("Zendesk webhook signature header is missing.");
+	if (!timestamp) throw new Error("Zendesk webhook signature timestamp header is missing.");
+	const timestampMs = parseZendeskWebhookTimestampMs(timestamp);
+	if (timestampMs !== void 0) {
+		if (Math.abs(Date.now() - timestampMs) > maxAgeSeconds * 1e3) throw new Error("Zendesk webhook timestamp is outside the accepted tolerance window.");
+	}
+	const expectedSignature = calculateZendeskWebhookSignature(request, secret);
+	const actualBuffer = Buffer.from(signature);
+	const expectedBuffer = Buffer.from(expectedSignature);
+	if (actualBuffer.length !== expectedBuffer.length) throw new Error("Zendesk webhook signature is invalid.");
+	if (!crypto.timingSafeEqual(actualBuffer, expectedBuffer)) throw new Error("Zendesk webhook signature is invalid.");
+}
+
+//#endregion
+export { DEFAULT_TIMESTAMP_TOLERANCE_SECONDS, calculateZendeskWebhookSignature, extractZendeskWebhookInvocationId, verifyZendeskWebhookSignature };

package/package.json

@@ -0,0 +1,172 @@
+{
+  "name": "@keystrokehq/zendesk",
+  "version": "0.0.1",
+  "private": false,
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    },
+    "./client": {
+      "import": "./dist/client.mjs",
+      "default": "./dist/client.mjs",
+      "types": "./dist/client.d.mts"
+    },
+    "./schemas": {
+      "import": "./dist/schemas.mjs",
+      "default": "./dist/schemas.mjs",
+      "types": "./dist/schemas.d.mts"
+    },
+    "./_official": {
+      "import": "./dist/_official/index.mjs",
+      "default": "./dist/_official/index.mjs",
+      "types": "./dist/_official/index.d.mts"
+    },
+    "./events": {
+      "import": "./dist/events.mjs",
+      "default": "./dist/events.mjs",
+      "types": "./dist/events.d.mts"
+    },
+    "./messaging": {
+      "import": "./dist/messaging.mjs",
+      "default": "./dist/messaging.mjs",
+      "types": "./dist/messaging.d.mts"
+    },
+    "./verification": {
+      "import": "./dist/verification.mjs",
+      "default": "./dist/verification.mjs",
+      "types": "./dist/verification.d.mts"
+    },
+    "./platform": {
+      "import": "./dist/platform.mjs",
+      "default": "./dist/platform.mjs",
+      "types": "./dist/platform.d.mts"
+    },
+    "./platform/connection": {
+      "import": "./dist/platform/connection.mjs",
+      "default": "./dist/platform/connection.mjs",
+      "types": "./dist/platform/connection.d.mts"
+    },
+    "./platform/tickets": {
+      "import": "./dist/platform/tickets.mjs",
+      "default": "./dist/platform/tickets.mjs",
+      "types": "./dist/platform/tickets.d.mts"
+    },
+    "./platform/users": {
+      "import": "./dist/platform/users.mjs",
+      "default": "./dist/platform/users.mjs",
+      "types": "./dist/platform/users.d.mts"
+    },
+    "./platform/organizations": {
+      "import": "./dist/platform/organizations.mjs",
+      "default": "./dist/platform/organizations.mjs",
+      "types": "./dist/platform/organizations.d.mts"
+    },
+    "./platform/search": {
+      "import": "./dist/platform/search.mjs",
+      "default": "./dist/platform/search.mjs",
+      "types": "./dist/platform/search.d.mts"
+    },
+    "./platform/jobs": {
+      "import": "./dist/platform/jobs.mjs",
+      "default": "./dist/platform/jobs.mjs",
+      "types": "./dist/platform/jobs.d.mts"
+    },
+    "./platform/triggers": {
+      "import": "./dist/platform/triggers.mjs",
+      "default": "./dist/platform/triggers.mjs",
+      "types": "./dist/platform/triggers.d.mts"
+    },
+    "./custom": {
+      "import": "./dist/custom.mjs",
+      "default": "./dist/custom.mjs",
+      "types": "./dist/custom.d.mts"
+    },
+    "./custom/connection": {
+      "import": "./dist/custom/connection.mjs",
+      "default": "./dist/custom/connection.mjs",
+      "types": "./dist/custom/connection.d.mts"
+    },
+    "./custom/tickets": {
+      "import": "./dist/custom/tickets.mjs",
+      "default": "./dist/custom/tickets.mjs",
+      "types": "./dist/custom/tickets.d.mts"
+    },
+    "./custom/users": {
+      "import": "./dist/custom/users.mjs",
+      "default": "./dist/custom/users.mjs",
+      "types": "./dist/custom/users.d.mts"
+    },
+    "./custom/organizations": {
+      "import": "./dist/custom/organizations.mjs",
+      "default": "./dist/custom/organizations.mjs",
+      "types": "./dist/custom/organizations.d.mts"
+    },
+    "./custom/search": {
+      "import": "./dist/custom/search.mjs",
+      "default": "./dist/custom/search.mjs",
+      "types": "./dist/custom/search.d.mts"
+    },
+    "./custom/jobs": {
+      "import": "./dist/custom/jobs.mjs",
+      "default": "./dist/custom/jobs.mjs",
+      "types": "./dist/custom/jobs.d.mts"
+    },
+    "./custom/triggers": {
+      "import": "./dist/custom/triggers.mjs",
+      "default": "./dist/custom/triggers.mjs",
+      "types": "./dist/custom/triggers.d.mts"
+    },
+    "./_runtime": {
+      "import": "./dist/_runtime/index.mjs",
+      "default": "./dist/_runtime/index.mjs",
+      "types": "./dist/_runtime/index.d.mts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "typecheck": "tsgo --build",
+    "build": "tsdown",
+    "lint": "biome check .",
+    "test:unit": "vitest run --passWithNoTests --project unit",
+    "test:int": "vitest run --passWithNoTests --project int",
+    "prepublishOnly": "pnpm build && pnpm test:unit",
+    "lint:fix": "biome check --write ."
+  },
+  "dependencies": {
+    "@keystrokehq/integration-authoring": "^0.0.1",
+    "@keystrokehq/core": "^0.0.5",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "@keystrokehq/test-utils": "workspace:*",
+    "@keystrokehq/typescript-config": "workspace:*",
+    "tsdown": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  },
+  "keywords": [
+    "zendesk",
+    "keystroke",
+    "integration",
+    "support"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/keystrokehq/integrations",
+    "directory": "integrations/zendesk"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}