@theholocron/holocron-plugin-infisical 5.0.0-alpha.277 → 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 { InfisicalClient, InfisicalClient as InfisicalClient$1, InfisicalClientOptions, createInfisicalClient } from "@theholocron/infisical-client";
+/** Resolves the Infisical token from `--token`, `HOLOCRON_INFISICAL_TOKEN`, `INFISICAL_TOKEN` or the keyring entry for `infisical`, 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 InfisicalVaultOptions {
   /** Default environment slug — e.g., "dev", "stg", "prd". */
   environment: string;
 }
+/** `vault` capability for Infisical, with references shaped `infisical://<workspaceId>/<environment>/<name>`. */
 export declare class InfisicalVault implements Vault {
   private readonly client;
+  /** Capability key; always `"vault"`. */
   readonly key: "vault";
+  /** Provider name; always `"infisical"`. */
   readonly providerName = "infisical";
   private readonly workspace;
   private readonly environment;
@@ -36,19 +40,27 @@ interface VerifyTokenOptions {
   baseUrl?: string;
   fetch?: typeof fetch;
 }
+/** Checks an Infisical token by listing workspaces; a 403 is reported as a valid but scope-limited token. */
 export declare function verifyToken(token: string, opts?: VerifyTokenOptions): Promise<VerifyTokenResult$1>;
+/** Options for the Infisical plugin: the token lookup inputs plus the default workspace and environment. */
 export interface InfisicalPluginOptions extends ResolveTokenInput, InfisicalVaultOptions {
   /** Override base URL for tests (or self-hosted Infisical). */
   baseUrl?: string;
   /** Override `fetch` for tests. */
   fetch?: typeof fetch;
 }
+/** Shared state for one Infisical plugin instance: its options and a lazily created client. */
 export interface PluginContext {
+  /** The options the plugin was created with. */
   options: InfisicalPluginOptions;
+  /** Returns the memoized Infisical client; the token is resolved on the first call, not at plugin load. */
   client: () => InfisicalClient;
 }
+/** Builds the plugin context from its options. */
 export declare function createContext(options: InfisicalPluginOptions): PluginContext;
+/** Builds the `vault` capability for the context's default workspace and environment. */
 export declare function vault(ctx: PluginContext): Vault;
+/** Creates the Infisical plugin: its `connection` probe and the `vault` capability. */
 export declare function createPlugin(options: InfisicalPluginOptions): {
   name: string;
   probes: {

package/dist/index.mjs

@@ -2,6 +2,7 @@ import { AuthError, ProviderApiError, connectionProbe, createResolveToken } from
 import { createInfisicalClient } from "@theholocron/infisical-client";
 import { errorMessage } from "@theholocron/misc-utils";
 // src/auth.ts
+/** Resolves the Infisical token from `--token`, `HOLOCRON_INFISICAL_TOKEN`, `INFISICAL_TOKEN` or the keyring entry for `infisical`, and throws `AuthError` when none is set. */
 const resolveToken = createResolveToken({
 	envName: "HOLOCRON_INFISICAL_TOKEN",
 	vendorEnvName: "INFISICAL_TOKEN",
@@ -11,9 +12,12 @@ const resolveToken = createResolveToken({
 /** Every token this plugin takes, for `holocron doctor tokens`. */
 const tokens = [resolveToken.token];
 // src/capabilities/vault.ts
+/** `vault` capability for Infisical, with references shaped `infisical://<workspaceId>/<environment>/<name>`. */
 var InfisicalVault = class {
 	client;
+	/** Capability key; always `"vault"`. */
 	key = "vault";
+	/** Provider name; always `"infisical"`. */
 	providerName = "infisical";
 	workspace;
 	environment;
@@ -154,6 +158,7 @@ function hasAlreadyExistsBody(details) {
 *     actually has access to.
 *   - 401 or other → token is invalid.
 */
+/** Checks an Infisical token by listing workspaces; a 403 is reported as a valid but scope-limited token. */
 async function verifyToken(token, opts = {}) {
 	const client = createInfisicalClient({
 		token,
@@ -181,6 +186,7 @@ async function verifyToken(token, opts = {}) {
 	}
 }
 // src/index.ts
+/** Builds the plugin context from its options. */
 function createContext(options) {
 	let client;
 	return {
@@ -192,12 +198,14 @@ function createContext(options) {
 		})
 	};
 }
+/** Builds the `vault` capability for the context's default workspace and environment. */
 function vault(ctx) {
 	return new InfisicalVault(ctx.client, {
 		workspace: ctx.options.workspace,
 		environment: ctx.options.environment
 	});
 }
+/** Creates the Infisical 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-infisical",
-  "version": "5.0.0-alpha.277",
+  "version": "5.0.0-alpha.279",
   "description": "Holocron plugin for Infisical. Implements the vault capability against Infisical's REST API, plus exports verifyToken + AUTH_HINT for `holocron auth`.",
   "keywords": [
     "holocron",
@@ -40,19 +40,19 @@
     "tsx": "4.23.15",
     "typescript": "^5.9.3",
     "vitest": "^5.0.5",
-    "@theholocron/cli": "5.0.0-alpha.277",
-    "@theholocron/eslint-config": "^8.9.0-alpha.3",
-    "@theholocron/http-client": "^1.58.0-alpha.3",
-    "@theholocron/misc-utils": "^1.16.1-alpha.2",
-    "@theholocron/tsconfig": "^8.9.0-alpha.3",
-    "@theholocron/tsdown-config": "^8.9.0-alpha.3",
+    "@theholocron/cli": "5.0.0-alpha.279",
+    "@theholocron/eslint-config": "^8.9.0-alpha.4",
     "@theholocron/infisical-client": "^1.58.0-alpha.3",
-    "@theholocron/vitest-config": "^8.9.0-alpha.3"
+    "@theholocron/tsconfig": "^8.9.0-alpha.4",
+    "@theholocron/http-client": "^1.58.0-alpha.3",
+    "@theholocron/tsdown-config": "^8.9.0-alpha.4",
+    "@theholocron/misc-utils": "^1.16.1-alpha.3",
+    "@theholocron/vitest-config": "^8.9.0-alpha.4"
   },
   "peerDependencies": {
     "@theholocron/infisical-client": "^1.43.1",
     "@theholocron/misc-utils": "^1.16.0",
-    "@theholocron/cli": "5.0.0-alpha.277"
+    "@theholocron/cli": "5.0.0-alpha.279"
   },
   "peerDependenciesMeta": {
     "@theholocron/infisical-client": {}