@theholocron/holocron-plugin-doppler 5.0.0-alpha.278 → 5.0.0-alpha.279

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 import { AuthError, EnsureResult, PluginToken, ResolveTokenInput, Vault, VerifyTokenFailure, VerifyTokenResult, VerifyTokenResult as VerifyTokenResult$1, VerifyTokenSuccess } from "@theholocron/cli";
 import { DopplerClient, DopplerClientOptions, createDopplerClient } from "@theholocron/doppler-client";
+/** Resolves the Doppler token from `--token`, `HOLOCRON_DOPPLER_TOKEN`, `DOPPLER_TOKEN` or the keyring entry for `doppler`, and throws `AuthError` when none is set. */
 export declare const resolveToken: import("@theholocron/cli").TokenResolver;
 /** Every token this plugin takes, for `holocron doctor tokens`. */
 export declare const tokens: PluginToken[];
@@ -9,9 +10,12 @@ interface DopplerVaultOptions {
   /** Default config name — dev / stg / prd, etc. */
   config: string;
 }
+/** `vault` capability for Doppler, with references shaped `doppler://<project>/<config>/<name>`. */
 export declare class DopplerVault implements Vault {
   private readonly client;
+  /** Capability key; always `"vault"`. */
   readonly key: "vault";
+  /** Provider name; always `"doppler"`. */
   readonly providerName = "doppler";
   private readonly project;
   private readonly config;
@@ -29,19 +33,27 @@ interface VerifyTokenOptions {
   baseUrl?: string;
   fetch?: typeof fetch;
 }
+/** Checks a Doppler token by fetching the caller and reports its kind and workplace, or why it was rejected. */
 export declare function verifyToken(token: string, opts?: VerifyTokenOptions): Promise<VerifyTokenResult$1>;
+/** Options for the Doppler plugin: the token lookup inputs plus the default project and config. */
 export interface DopplerPluginOptions extends ResolveTokenInput, DopplerVaultOptions {
   /** Override base URL for tests. */
   baseUrl?: string;
   /** Override `fetch` for tests. */
   fetch?: typeof fetch;
 }
+/** Shared state for one Doppler plugin instance: its options and a lazily created client. */
 export interface PluginContext {
+  /** The options the plugin was created with. */
   options: DopplerPluginOptions;
+  /** Returns the memoized Doppler client; the token is resolved on the first call, not at plugin load. */
   client: () => DopplerClient;
 }
+/** Builds the plugin context from its options. */
 export declare function createContext(options: DopplerPluginOptions): PluginContext;
+/** Builds the `vault` capability for the context's default project and config. */
 export declare function vault(ctx: PluginContext): Vault;
+/** Creates the Doppler plugin: its `connection` probe and the `vault` capability. */
 export declare function createPlugin(options: DopplerPluginOptions): {
   name: string;
   probes: {

package/dist/index.mjs

@@ -2,6 +2,7 @@ import { AuthError, ProviderApiError, connectionProbe, createResolveToken } from
 import { createDopplerClient } from "@theholocron/doppler-client";
 import { errorMessage } from "@theholocron/misc-utils";
 // src/auth.ts
+/** Resolves the Doppler token from `--token`, `HOLOCRON_DOPPLER_TOKEN`, `DOPPLER_TOKEN` or the keyring entry for `doppler`, and throws `AuthError` when none is set. */
 const resolveToken = createResolveToken({
 	envName: "HOLOCRON_DOPPLER_TOKEN",
 	vendorEnvName: "DOPPLER_TOKEN",
@@ -26,9 +27,12 @@ const DOPPLER_INJECTED_KEYS = /* @__PURE__ */ new Set([
 	"DOPPLER_CONFIG",
 	"DOPPLER_ENVIRONMENT"
 ]);
+/** `vault` capability for Doppler, with references shaped `doppler://<project>/<config>/<name>`. */
 var DopplerVault = class {
 	client;
+	/** Capability key; always `"vault"`. */
 	key = "vault";
+	/** Provider name; always `"doppler"`. */
 	providerName = "doppler";
 	project;
 	config;
@@ -123,6 +127,7 @@ function hasAlreadyExistsBody(details) {
 	return /already exists/i.test(details);
 }
 // src/verify-token.ts
+/** Checks a Doppler token by fetching the caller and reports its kind and workplace, or why it was rejected. */
 async function verifyToken(token, opts = {}) {
 	const client = createDopplerClient({
 		token,
@@ -144,6 +149,7 @@ async function verifyToken(token, opts = {}) {
 	}
 }
 // src/index.ts
+/** Builds the plugin context from its options. */
 function createContext(options) {
 	let client;
 	return {
@@ -155,12 +161,14 @@ function createContext(options) {
 		})
 	};
 }
+/** Builds the `vault` capability for the context's default project and config. */
 function vault(ctx) {
 	return new DopplerVault(ctx.client, {
 		project: ctx.options.project,
 		config: ctx.options.config
 	});
 }
+/** Creates the Doppler plugin: its `connection` probe and the `vault` capability. */
 function createPlugin(options) {
 	const ctx = createContext(options);
 	return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/holocron-plugin-doppler",
-  "version": "5.0.0-alpha.278",
+  "version": "5.0.0-alpha.279",
   "description": "Holocron plugin for Doppler. Implements the vault capability against Doppler's REST API — projects, configs, secrets, plus verifyToken + AUTH_HINT for `holocron auth`.",
   "keywords": [
     "doppler",
@@ -40,19 +40,19 @@
     "tsx": "4.23.15",
     "typescript": "^5.9.3",
     "vitest": "^5.0.5",
-    "@theholocron/cli": "5.0.0-alpha.278",
-    "@theholocron/http-client": "^1.58.0-alpha.3",
-    "@theholocron/eslint-config": "^8.9.0-alpha.4",
-    "@theholocron/misc-utils": "^1.16.1-alpha.3",
+    "@theholocron/doppler-client": "^1.58.0-alpha.3",
     "@theholocron/tsconfig": "^8.9.0-alpha.4",
     "@theholocron/tsdown-config": "^8.9.0-alpha.4",
-    "@theholocron/doppler-client": "^1.58.0-alpha.3",
-    "@theholocron/vitest-config": "^8.9.0-alpha.4"
+    "@theholocron/cli": "5.0.0-alpha.279",
+    "@theholocron/http-client": "^1.58.0-alpha.3",
+    "@theholocron/misc-utils": "^1.16.1-alpha.3",
+    "@theholocron/vitest-config": "^8.9.0-alpha.4",
+    "@theholocron/eslint-config": "^8.9.0-alpha.4"
   },
   "peerDependencies": {
     "@theholocron/doppler-client": "^1.43.1",
     "@theholocron/misc-utils": "^1.16.0",
-    "@theholocron/cli": "5.0.0-alpha.278"
+    "@theholocron/cli": "5.0.0-alpha.279"
   },
   "engines": {
     "node": ">=22"