@keystrokehq/sentry 0.0.1

package/dist/organizations.mjs

@@ -0,0 +1,334 @@
+import { orgScopeInputSchema, sentryEnvironmentSchema, sentryJsonArraySchema, sentryJsonObjectSchema, sentryListInputSchema, sentryOrganizationDetailsSchema, sentryProjectSummarySchema, sentrySlugSchema } from "./schemas.mjs";
+import { t as defineSentryEndpoint } from "./endpoint-factory-BwjbcPwW.mjs";
+import { t as SENTRY_SCOPE } from "./scopes-RRU0vt-a.mjs";
+import { z } from "zod";
+
+//#region src/organizations.ts
+/**
+* Operations for Sentry organization-level endpoints.
+* Maps to PLAN.md §6.1 (15 actions).
+*/
+const ORG_PATH_PARAMS = [{
+	name: "organization_slug",
+	placeholder: "{organization_slug}"
+}];
+const getOrganizationByIdOrSlug = defineSentryEndpoint({
+	id: "get_organization_by_id_or_slug",
+	name: "Get Organization By ID or Slug",
+	description: "Return metadata for a single organization identified by its slug or numeric ID.",
+	method: "GET",
+	path: "/api/0/organizations/{organization_slug}/",
+	pathParams: ORG_PATH_PARAMS,
+	input: orgScopeInputSchema,
+	output: sentryOrganizationDetailsSchema,
+	requiredOAuthScopes: [...SENTRY_SCOPE.orgRead]
+});
+const getOrganizationDetails = defineSentryEndpoint({
+	id: "get_organization_details",
+	name: "Get Organization Details",
+	description: "Alias of `get_organization_by_id_or_slug` preserved for Composio parity.",
+	method: "GET",
+	path: "/api/0/organizations/{organization_slug}/",
+	pathParams: ORG_PATH_PARAMS,
+	input: orgScopeInputSchema,
+	output: sentryOrganizationDetailsSchema,
+	requiredOAuthScopes: [...SENTRY_SCOPE.orgRead]
+});
+const modifyOrganizationSettings = defineSentryEndpoint({
+	id: "modify_organization_settings",
+	name: "Modify Organization Settings",
+	description: "Update organization settings such as display name, slug, or feature flags.",
+	method: "PUT",
+	path: "/api/0/organizations/{organization_slug}/",
+	pathParams: ORG_PATH_PARAMS,
+	input: orgScopeInputSchema.extend({
+		name: z.string().min(1).optional(),
+		slug: sentrySlugSchema.optional(),
+		defaultRole: z.string().optional(),
+		openMembership: z.boolean().optional(),
+		allowSharedIssues: z.boolean().optional(),
+		enhancedPrivacy: z.boolean().optional(),
+		dataScrubber: z.boolean().optional(),
+		dataScrubberDefaults: z.boolean().optional(),
+		scrubIPAddresses: z.boolean().optional(),
+		storeCrashReports: z.number().int().optional(),
+		attachmentsRole: z.string().optional(),
+		debugFilesRole: z.string().optional(),
+		eventsMemberAdmin: z.boolean().optional(),
+		alertsMemberWrite: z.boolean().optional(),
+		codecovAccess: z.boolean().optional(),
+		githubOpenPRBot: z.boolean().optional(),
+		githubNudgeInvite: z.boolean().optional()
+	}),
+	bodyFields: [
+		"name",
+		"slug",
+		"defaultRole",
+		"openMembership",
+		"allowSharedIssues",
+		"enhancedPrivacy",
+		"dataScrubber",
+		"dataScrubberDefaults",
+		"scrubIPAddresses",
+		"storeCrashReports",
+		"attachmentsRole",
+		"debugFilesRole",
+		"eventsMemberAdmin",
+		"alertsMemberWrite",
+		"codecovAccess",
+		"githubOpenPRBot",
+		"githubNudgeInvite"
+	],
+	output: sentryOrganizationDetailsSchema,
+	needsApproval: true,
+	requiredOAuthScopes: [...SENTRY_SCOPE.orgWrite]
+});
+const getOrganizationEnvironments = defineSentryEndpoint({
+	id: "get_organization_environments",
+	name: "Get Organization Environments",
+	description: "List the environments visible to the organization across all projects.",
+	method: "GET",
+	path: "/api/0/organizations/{organization_slug}/environments/",
+	pathParams: ORG_PATH_PARAMS,
+	input: orgScopeInputSchema.extend({ visibility: z.enum([
+		"visible",
+		"hidden",
+		"all"
+	]).optional() }),
+	queryFields: ["visibility"],
+	output: z.array(sentryEnvironmentSchema),
+	requiredOAuthScopes: [...SENTRY_SCOPE.projectRead]
+});
+const getOrganizationSessions = defineSentryEndpoint({
+	id: "get_organization_sessions",
+	name: "Get Organization Sessions",
+	description: "Fetch session-health aggregates for the organization. Supports Release Health queries.",
+	method: "GET",
+	path: "/api/0/organizations/{organization_slug}/sessions/",
+	pathParams: ORG_PATH_PARAMS,
+	input: orgScopeInputSchema.extend({
+		project: z.array(z.number().int()).optional(),
+		environment: z.array(z.string()).optional(),
+		field: z.array(z.string()).min(1),
+		statsPeriod: z.string().optional(),
+		interval: z.string().optional(),
+		groupBy: z.array(z.string()).optional(),
+		query: z.string().optional(),
+		orderBy: z.string().optional(),
+		per_page: z.number().int().optional(),
+		includeTotals: z.number().int().optional(),
+		includeSeries: z.number().int().optional()
+	}),
+	queryFields: [
+		"project",
+		"environment",
+		"field",
+		"statsPeriod",
+		"interval",
+		"groupBy",
+		"query",
+		"orderBy",
+		"per_page",
+		"includeTotals",
+		"includeSeries"
+	],
+	output: sentryJsonObjectSchema,
+	requiredOAuthScopes: [...SENTRY_SCOPE.projectRead]
+});
+const getOrganizationStatsSummary = defineSentryEndpoint({
+	id: "get_organization_stats_summary",
+	name: "Get Organization Stats Summary",
+	description: "Return a high-level stats summary for the organization.",
+	method: "GET",
+	path: "/api/0/organizations/{organization_slug}/stats-summary/",
+	pathParams: ORG_PATH_PARAMS,
+	input: orgScopeInputSchema.extend({
+		project: z.array(z.number().int()).optional(),
+		statsPeriod: z.string().optional(),
+		start: z.string().optional(),
+		end: z.string().optional(),
+		field: z.array(z.string()).optional(),
+		category: z.array(z.string()).optional(),
+		outcome: z.array(z.string()).optional(),
+		reason: z.array(z.string()).optional()
+	}),
+	queryFields: [
+		"project",
+		"statsPeriod",
+		"start",
+		"end",
+		"field",
+		"category",
+		"outcome",
+		"reason"
+	],
+	output: sentryJsonObjectSchema,
+	requiredOAuthScopes: [...SENTRY_SCOPE.orgRead]
+});
+const retrieveOrganizationStatsV2 = defineSentryEndpoint({
+	id: "retrieve_organization_stats_v2",
+	name: "Retrieve Organization Stats (v2)",
+	description: "Return the v2 stats endpoint for outcomes/categories.",
+	method: "GET",
+	path: "/api/0/organizations/{organization_slug}/stats_v2/",
+	pathParams: ORG_PATH_PARAMS,
+	input: orgScopeInputSchema.extend({
+		field: z.array(z.string()).min(1),
+		statsPeriod: z.string().optional(),
+		interval: z.string().optional(),
+		groupBy: z.array(z.string()).optional(),
+		project: z.array(z.number().int()).optional(),
+		category: z.array(z.string()).optional(),
+		outcome: z.array(z.string()).optional(),
+		reason: z.array(z.string()).optional(),
+		start: z.string().optional(),
+		end: z.string().optional()
+	}),
+	queryFields: [
+		"field",
+		"statsPeriod",
+		"interval",
+		"groupBy",
+		"project",
+		"category",
+		"outcome",
+		"reason",
+		"start",
+		"end"
+	],
+	output: sentryJsonObjectSchema,
+	requiredOAuthScopes: [...SENTRY_SCOPE.orgRead]
+});
+const retrieveOrganizationRelayUsage = defineSentryEndpoint({
+	id: "retrieve_organization_relay_usage",
+	name: "Retrieve Organization Relay Usage",
+	description: "Return Relay (Sentry ingest proxy) usage metrics for the organization.",
+	method: "GET",
+	path: "/api/0/organizations/{organization_slug}/relay_usage/",
+	pathParams: ORG_PATH_PARAMS,
+	input: orgScopeInputSchema,
+	output: sentryJsonObjectSchema,
+	requiredOAuthScopes: [...SENTRY_SCOPE.orgRead]
+});
+const retrieveOrganizationProjects = defineSentryEndpoint({
+	id: "retrieve_organization_projects",
+	name: "Retrieve Organization Projects",
+	description: "List projects in an organization with pagination.",
+	method: "GET",
+	path: "/api/0/organizations/{organization_slug}/projects/",
+	pathParams: ORG_PATH_PARAMS,
+	input: sentryListInputSchema.merge(orgScopeInputSchema),
+	queryFields: [
+		"query",
+		"cursor",
+		"per_page"
+	],
+	output: z.array(sentryProjectSummarySchema),
+	pagination: "cursor",
+	requiredOAuthScopes: [...SENTRY_SCOPE.projectRead]
+});
+const postSpikeProtectionForOrganization = defineSentryEndpoint({
+	id: "post_spike_protection_for_organization",
+	name: "Enable / Disable Spike Protection",
+	description: "Toggle spike-protection on or off at the organization level.",
+	method: "POST",
+	path: "/api/0/organizations/{organization_slug}/spike-protections/",
+	pathParams: ORG_PATH_PARAMS,
+	input: orgScopeInputSchema.extend({ projects: z.array(z.union([z.string(), z.number()])).min(1) }),
+	bodyFields: ["projects"],
+	output: sentryJsonObjectSchema,
+	needsApproval: true,
+	requiredOAuthScopes: [...SENTRY_SCOPE.projectWrite]
+});
+const retrieveOrgIntegrationConfig = defineSentryEndpoint({
+	id: "retrieve_org_integration_config",
+	name: "Retrieve Organization Integration Config",
+	description: "Fetch the configuration schema for the set of integrations the org can install.",
+	method: "GET",
+	path: "/api/0/organizations/{organization_slug}/config/integrations/",
+	pathParams: ORG_PATH_PARAMS,
+	input: orgScopeInputSchema.extend({ providerKey: z.string().optional() }),
+	queryFields: ["providerKey"],
+	output: sentryJsonObjectSchema,
+	requiredOAuthScopes: [...SENTRY_SCOPE.orgRead]
+});
+const retrieveOrganizationIntegrationsList = defineSentryEndpoint({
+	id: "retrieve_organization_integrations_list",
+	name: "List Installed Organization Integrations",
+	description: "Return every provider integration installed on the organization.",
+	method: "GET",
+	path: "/api/0/organizations/{organization_slug}/integrations/",
+	pathParams: ORG_PATH_PARAMS,
+	input: orgScopeInputSchema.extend({
+		providerKey: z.string().optional(),
+		features: z.array(z.string()).optional(),
+		includeConfig: z.boolean().optional()
+	}),
+	queryFields: [
+		"providerKey",
+		"features",
+		"includeConfig"
+	],
+	output: sentryJsonArraySchema,
+	requiredOAuthScopes: [...SENTRY_SCOPE.orgRead]
+});
+const getIntegrationDetailsByOrg = defineSentryEndpoint({
+	id: "get_integration_details_by_org",
+	name: "Get Organization Integration Details",
+	description: "Fetch one installed integration record by its integration id.",
+	method: "GET",
+	path: "/api/0/organizations/{organization_slug}/integrations/{integration_id}/",
+	pathParams: [...ORG_PATH_PARAMS, {
+		name: "integration_id",
+		placeholder: "{integration_id}"
+	}],
+	input: orgScopeInputSchema.extend({ integration_id: z.string().min(1) }),
+	output: sentryJsonObjectSchema,
+	requiredOAuthScopes: [...SENTRY_SCOPE.orgRead]
+});
+const deleteOrganizationIntegration = defineSentryEndpoint({
+	id: "delete_organization_integration",
+	name: "Delete Organization Integration",
+	description: "Uninstall an integration installation from the organization.",
+	method: "DELETE",
+	path: "/api/0/organizations/{organization_slug}/integrations/{integration_id}/",
+	pathParams: [...ORG_PATH_PARAMS, {
+		name: "integration_id",
+		placeholder: "{integration_id}"
+	}],
+	input: orgScopeInputSchema.extend({ integration_id: z.string().min(1) }),
+	output: z.unknown(),
+	needsApproval: true,
+	requiredOAuthScopes: [...SENTRY_SCOPE.orgAdmin]
+});
+const getSentryAppInstallationsForOrganization = defineSentryEndpoint({
+	id: "get_sentry_app_installations_for_organization",
+	name: "List Sentry App Installations for Organization",
+	description: "List all Sentry-app (integration platform) installations for the organization.",
+	method: "GET",
+	path: "/api/0/organizations/{organization_slug}/sentry-app-installations/",
+	pathParams: ORG_PATH_PARAMS,
+	input: orgScopeInputSchema,
+	output: sentryJsonArraySchema,
+	requiredOAuthScopes: [...SENTRY_SCOPE.orgRead]
+});
+const sentryOrganizationOperations = {
+	getOrganizationByIdOrSlug,
+	getOrganizationDetails,
+	modifyOrganizationSettings,
+	getOrganizationEnvironments,
+	getOrganizationSessions,
+	getOrganizationStatsSummary,
+	retrieveOrganizationStatsV2,
+	retrieveOrganizationRelayUsage,
+	retrieveOrganizationProjects,
+	postSpikeProtectionForOrganization,
+	retrieveOrgIntegrationConfig,
+	retrieveOrganizationIntegrationsList,
+	getIntegrationDetailsByOrg,
+	deleteOrganizationIntegration,
+	getSentryAppInstallationsForOrganization
+};
+
+//#endregion
+export { deleteOrganizationIntegration, getIntegrationDetailsByOrg, getOrganizationByIdOrSlug, getOrganizationDetails, getOrganizationEnvironments, getOrganizationSessions, getOrganizationStatsSummary, getSentryAppInstallationsForOrganization, modifyOrganizationSettings, postSpikeProtectionForOrganization, retrieveOrgIntegrationConfig, retrieveOrganizationIntegrationsList, retrieveOrganizationProjects, retrieveOrganizationRelayUsage, retrieveOrganizationStatsV2, sentryOrganizationOperations };

package/dist/pagination-PlgAqbZt.mjs

@@ -0,0 +1,116 @@
+//#region src/pagination.ts
+function parseSentryLinkHeader(header) {
+	if (header == null || header.length === 0) return {
+		previous: null,
+		next: null
+	};
+	let previous = null;
+	let next = null;
+	for (const entry of splitLinkEntries(header)) {
+		const parsed = parseLinkEntry(entry);
+		if (!parsed) continue;
+		if (parsed.rel === "previous") previous = toPageLink(parsed.url);
+		else if (parsed.rel === "next") next = toPageLink(parsed.url);
+	}
+	return {
+		previous,
+		next
+	};
+}
+/**
+* Splits a single raw `Link` header value into its comma-separated entries.
+* Naive splitting on `,` is unsafe because cursor strings can legally contain
+* commas; we track angle-bracket depth.
+*/
+function splitLinkEntries(header) {
+	const entries = [];
+	let depth = 0;
+	let start = 0;
+	for (let i = 0; i < header.length; i += 1) {
+		const ch = header.charAt(i);
+		if (ch === "<") depth += 1;
+		else if (ch === ">") depth -= 1;
+		else if (ch === "," && depth === 0) {
+			entries.push(header.slice(start, i));
+			start = i + 1;
+		}
+	}
+	entries.push(header.slice(start));
+	return entries.map((e) => e.trim()).filter(Boolean);
+}
+function parseLinkEntry(entry) {
+	const openBracket = entry.indexOf("<");
+	const closeBracket = entry.indexOf(">", openBracket);
+	if (openBracket === -1 || closeBracket === -1) return null;
+	const url = entry.slice(openBracket + 1, closeBracket);
+	const params = parseLinkParams(entry.slice(closeBracket + 1));
+	const rel = params.rel ?? "";
+	const results = params.results === "true";
+	if (!rel) return null;
+	return {
+		url,
+		rel,
+		results
+	};
+}
+function parseLinkParams(paramsSection) {
+	const params = {};
+	for (const part of paramsSection.split(";").map((s) => s.trim())) {
+		if (!part) continue;
+		const eq = part.indexOf("=");
+		if (eq === -1) continue;
+		const key = part.slice(0, eq).trim();
+		let value = part.slice(eq + 1).trim();
+		if (value.startsWith("\"") && value.endsWith("\"")) value = value.slice(1, -1);
+		if (key) params[key] = value;
+	}
+	return params;
+}
+function toPageLink(url) {
+	return {
+		url,
+		cursor: extractCursor(url),
+		results: extractResults(url)
+	};
+}
+function extractCursor(url) {
+	const queryIndex = url.indexOf("?");
+	if (queryIndex === -1) return null;
+	const query = url.slice(queryIndex + 1);
+	for (const pair of query.split("&")) {
+		const eq = pair.indexOf("=");
+		if (eq === -1) continue;
+		if (pair.slice(0, eq) === "cursor") return decodeURIComponent(pair.slice(eq + 1));
+	}
+	return null;
+}
+function extractResults(url) {
+	const queryIndex = url.indexOf("?");
+	if (queryIndex === -1) return false;
+	const query = url.slice(queryIndex + 1);
+	for (const pair of query.split("&")) {
+		const eq = pair.indexOf("=");
+		if (eq === -1) continue;
+		if (pair.slice(0, eq) === "results") return pair.slice(eq + 1) === "true";
+	}
+	return false;
+}
+/**
+* Detects a Sentry DSN pasted where a bearer auth token was expected. DSNs
+* look like `https://<publicKey>@o<org>.ingest.sentry.io/<projectId>` (or
+* http(s) against a self-hosted host with an `@` before the host). We never
+* want to send these to the management API.
+*/
+function looksLikeSentryDsn(value) {
+	if (!value.includes("://")) return false;
+	try {
+		const parsed = new URL(value);
+		if (parsed.protocol !== "https:" && parsed.protocol !== "http:") return false;
+		return parsed.username.length > 0;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+export { parseSentryLinkHeader as n, looksLikeSentryDsn as t };