@theholocron/holocron-plugin-sentry 3.54.0 → 3.55.0

package/README.md

@@ -2,7 +2,7 @@
 
 # `@theholocron/holocron-plugin-sentry`
 
-Sentry plugin for [Holocron](../cli). Implements the `observability`
+Sentry plugin for [Holocron](../cli). Implements the `errors`
 capability against the [Sentry management API](https://docs.sentry.io/api/).
 
 ## Install
@@ -33,7 +33,7 @@ user-owned and org-owned tokens are accepted.
 ```jsonc
 {
   "providers": {
-    "observability": ["sentry", { "org": "my-org-slug", "team": "my-team" }],
+    "errors": ["sentry", { "org": "my-org-slug", "team": "my-team" }],
   },
 }
 
@@ -51,6 +51,8 @@ user-owned and org-owned tokens are accepted.
 | `whoami`        | Fetches the org by slug to verify the token and confirm the org exists.                                                                                      |
 | `ensureProject` | Looks up the project by slug (derived from `name`); creates it under the configured team if absent. Returns the DSN and an `alreadyExists` flag. Idempotent. |
 
-`holocron setup` calls `ensureProject` and pushes both `SENTRY_DSN` and
-`NEXT_PUBLIC_SENTRY_DSN` to GitHub Secrets (same DSN value, both keys
-required by the Sentry Next.js SDK).
+A provider entry in `holocron.config` is only needed to enable `holocron
+setup` provisioning (`ensureProject` + pushing `SENTRY_DSN` /
+`NEXT_PUBLIC_SENTRY_DSN` to Secrets) and `holocron doctor` connectivity
+checks — not for runtime error reporting, which the CLI activates directly
+from `HOLOCRON_SENTRY_DSN` (fallback `SENTRY_DSN`).

package/dist/index.d.mts

@@ -1,21 +1,21 @@
-import { AuthError, Observability, ResolveTokenInput } from "@theholocron/cli";
+import { AuthError, Errors, ResolveTokenInput } from "@theholocron/cli";
 import { SentryClient, SentryClientOptions, createSentryClient } from "@theholocron/sentry-client";
 //#region src/auth.d.ts
 declare const resolveToken: (input?: ResolveTokenInput) => string;
 //#endregion
-//#region src/capabilities/observability.d.ts
-interface SentryObservabilityOptions {
-  /** Sentry organization slug. Required. */
-  org: string;
+//#region src/capabilities/errors.d.ts
+interface SentryErrorsOptions {
+  /** Sentry organization slug. Required for `whoami` and `ensureProject`. */
+  org?: string;
   /** Default team slug for project creation. Defaults to org slug. */
   team?: string;
 }
-declare class SentryObservability implements Observability {
+declare class SentryErrors implements Errors {
   private readonly client;
   private readonly opts;
-  readonly key: "observability";
+  readonly key: "errors";
   readonly providerName = "sentry";
-  constructor(client: SentryClient, opts: SentryObservabilityOptions);
+  constructor(client: SentryClient, opts: SentryErrorsOptions);
   describe(): Promise<{
     provider: string;
     envKeys: string[];
@@ -30,6 +30,12 @@ declare class SentryObservability implements Observability {
     dsn: string;
     alreadyExists: boolean;
   }>;
+  /**
+   * `org` is optional at construction (the `errors` capability activates from
+   * env vars alone), but the management-API calls need it. Validate here so
+   * the runtime is never blocked at plugin-load time.
+   */
+  private requireOrg;
 }
 //#endregion
 //#region src/verify-token.d.ts
@@ -49,9 +55,13 @@ interface VerifyTokenOptions {
 declare function verifyToken(token: string, opts?: VerifyTokenOptions): Promise<VerifyTokenResult>;
 //#endregion
 //#region src/index.d.ts
-interface SentryPluginOptions extends ResolveTokenInput, SentryObservabilityOptions {
-  /** Sentry organization slug. Required. Narrows ResolveTokenInput.org (optional) to string. */
-  org: string;
+interface SentryPluginOptions extends ResolveTokenInput, SentryErrorsOptions {
+  /**
+   * Sentry organization slug. Optional at load time — the `errors` capability
+   * activates from env vars alone — but required for `whoami` / `ensureProject`
+   * (validated at call time, not construction).
+   */
+  org?: string;
   /** Override base URL for tests. */
   baseUrl?: string;
   fetch?: typeof fetch;
@@ -61,13 +71,13 @@ interface PluginContext {
   client: SentryClient;
 }
 declare function createContext(options: SentryPluginOptions): PluginContext;
-declare function observability(ctx: PluginContext): Observability;
+declare function errors(ctx: PluginContext): Errors;
 declare function createPlugin(options: SentryPluginOptions): {
   name: string;
   capabilities: {
-    observability: () => Observability;
+    errors: () => Errors;
   };
 };
 declare const AUTH_HINT: string;
 //#endregion
-export { AUTH_HINT, AuthError, PluginContext, type ResolveTokenInput, type SentryClient, type SentryClientOptions, SentryObservability, type SentryObservabilityOptions, SentryPluginOptions, type VerifyTokenFailure, type VerifyTokenResult, type VerifyTokenSuccess, createContext, createPlugin, createSentryClient, observability, resolveToken, verifyToken };
+export { AUTH_HINT, AuthError, PluginContext, type ResolveTokenInput, type SentryClient, type SentryClientOptions, SentryErrors, type SentryErrorsOptions, SentryPluginOptions, type VerifyTokenFailure, type VerifyTokenResult, type VerifyTokenSuccess, createContext, createPlugin, createSentryClient, errors, resolveToken, verifyToken };

package/dist/index.mjs

@@ -8,16 +8,15 @@ const resolveToken = createResolveToken({
 	errorMessage: "no Sentry auth token found. Pass --token <TOKEN>, set HOLOCRON_SENTRY_TOKEN / SENTRY_AUTH_TOKEN, or run: holocron auth set sentry <TOKEN>"
 });
 //#endregion
-//#region src/capabilities/observability.ts
-var SentryObservability = class {
+//#region src/capabilities/errors.ts
+var SentryErrors = class {
 	client;
 	opts;
-	key = "observability";
+	key = "errors";
 	providerName = "sentry";
 	constructor(client, opts) {
 		this.client = client;
 		this.opts = opts;
-		if (!opts.org) throw new Error("SentryObservability requires `org` in options");
 	}
 	async describe() {
 		return {
@@ -26,13 +25,14 @@ var SentryObservability = class {
 		};
 	}
 	async whoami() {
-		return { org: (await this.client.auth.getOrg(this.opts.org)).slug };
+		return { org: (await this.client.auth.getOrg(this.requireOrg())).slug };
 	}
 	async ensureProject(input) {
+		const org = this.requireOrg();
 		const slug = toSlug(input.name);
 		try {
-			const existing = await this.client.projects.get(this.opts.org, slug);
-			const dsn = (await this.client.projects.keys(this.opts.org, existing.slug))[0]?.dsn.public;
+			const existing = await this.client.projects.get(org, slug);
+			const dsn = (await this.client.projects.keys(org, existing.slug))[0]?.dsn.public;
 			/* c8 ignore next */
 			if (!dsn) throw new ProviderApiError(`Sentry project ${slug} has no keys`, 404, void 0);
 			return {
@@ -42,12 +42,12 @@ var SentryObservability = class {
 		} catch (err) {
 			if (!(err instanceof ProviderApiError) || err.status !== 404) throw err;
 		}
-		const team = this.opts.team ?? this.opts.org;
-		const project = await this.client.projects.create(this.opts.org, team, {
+		const team = this.opts.team ?? org;
+		const project = await this.client.projects.create(org, team, {
 			name: input.name,
 			platform: input.platform ?? "node"
 		});
-		const dsn = (await this.client.projects.keys(this.opts.org, project.slug))[0]?.dsn.public;
+		const dsn = (await this.client.projects.keys(org, project.slug))[0]?.dsn.public;
 		/* c8 ignore next */
 		if (!dsn) throw new ProviderApiError(`Sentry project ${project.slug} has no keys after creation`, 500, void 0);
 		return {
@@ -55,6 +55,15 @@ var SentryObservability = class {
 			alreadyExists: false
 		};
 	}
+	/**
+	* `org` is optional at construction (the `errors` capability activates from
+	* env vars alone), but the management-API calls need it. Validate here so
+	* the runtime is never blocked at plugin-load time.
+	*/
+	requireOrg() {
+		if (!this.opts.org) throw new Error("@theholocron/holocron-plugin-sentry requires `org` in options for this operation");
+		return this.opts.org;
+	}
 };
 function toSlug(name) {
 	return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
@@ -82,7 +91,6 @@ async function verifyToken(token, opts = {}) {
 //#endregion
 //#region src/index.ts
 function createContext(options) {
-	if (!options.org) throw new Error("@theholocron/holocron-plugin-sentry requires `org` in options");
 	return {
 		options,
 		client: createSentryClient({
@@ -92,8 +100,8 @@ function createContext(options) {
 		})
 	};
 }
-function observability(ctx) {
-	return new SentryObservability(ctx.client, {
+function errors(ctx) {
+	return new SentryErrors(ctx.client, {
 		org: ctx.options.org,
 		team: ctx.options.team
 	});
@@ -102,9 +110,9 @@ function createPlugin(options) {
 	const ctx = createContext(options);
 	return {
 		name: "@theholocron/holocron-plugin-sentry",
-		capabilities: { observability: () => observability(ctx) }
+		capabilities: { errors: () => errors(ctx) }
 	};
 }
 const AUTH_HINT = "generate an auth token at https://sentry.io/settings/account/api/auth-tokens/ with project:read, project:write, and org:read scopes, then run: holocron auth set sentry <TOKEN>";
 //#endregion
-export { AUTH_HINT, AuthError, SentryObservability, createContext, createPlugin, createSentryClient, observability, resolveToken, verifyToken };
+export { AUTH_HINT, AuthError, SentryErrors, createContext, createPlugin, createSentryClient, errors, resolveToken, verifyToken };

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@theholocron/holocron-plugin-sentry",
-  "version": "3.54.0",
-  "description": "Holocron plugin for Sentry. Implements the observability capability against Sentry's management API — project provisioning and DSN retrieval.",
+  "version": "3.55.0",
+  "description": "Holocron plugin for Sentry. Implements the errors capability against Sentry's management API — project provisioning and DSN retrieval.",
   "keywords": [
+    "errors",
     "holocron",
-    "observability",
     "plugin",
     "sentry"
   ],
@@ -46,11 +46,11 @@
     "tsx": "4.23.12",
     "typescript": "^5.9.3",
     "vitest": "^4.1.11",
-    "@theholocron/cli": "3.54.0"
+    "@theholocron/cli": "3.55.0"
   },
   "peerDependencies": {
     "@theholocron/sentry-client": "^1.14.2",
-    "@theholocron/cli": "3.54.0"
+    "@theholocron/cli": "3.55.0"
   },
   "peerDependenciesMeta": {
     "@theholocron/sentry-client": {}