@clicadigital/vault-sdk 0.1.0 → 0.3.0

package/src/index.ts

@@ -1,167 +1,177 @@
-import { writeFile } from "node:fs/promises";
-import { createClientFromEnv, VaultClient, type VaultClientOptions } from "./client.js";
-import { toDotEnv, varsToRecord } from "./dotenv.js";
-import type { EnvVar, ProjectTree } from "./types.js";
-
-export type { EnvVar, ProjectTree, ProjectTreeEnv } from "./types.js";
-export { VaultClient, createClientFromEnv, type VaultClientOptions };
-export { toDotEnv, varsToRecord };
-
-export type ResolveOptions = {
-  project: string;
-  env: string;
-  client?: VaultClient;
-};
-
-export type EnsureOptions = ResolveOptions & {
-  createProject?: boolean;
-};
-
-export type PullOptions = ResolveOptions & {
-  out?: string;
-  inject?: boolean;
-};
-
-export type CreateEnvOptions = {
-  project: string;
-  env: string;
-  /** URL da API do vault na VPN (cluster-internal) */
-  url?: string;
-  vars?: Record<string, string>;
-  client?: VaultClient;
-};
-
-async function findProject(
-  client: VaultClient,
-  name: string,
-): Promise<ProjectTree | undefined> {
-  const tree = await client.listProjects();
-  return tree.find((p) => p.name === name);
-}
-
-function resolveClient(opts: { client?: VaultClient; url?: string }): VaultClient {
-  if (opts.client) return opts.client;
-  if (opts.url) return new VaultClient({ baseUrl: opts.url });
-  return createClientFromEnv();
-}
-
-export async function resolveEnvironment(
-  opts: ResolveOptions,
-): Promise<{ projectId: string; environmentId: string }> {
-  const client = opts.client ?? createClientFromEnv();
-  const project = await findProject(client, opts.project);
-  if (!project) throw new Error(`Project not found: ${opts.project}`);
-  const environment = project.environments.find((e) => e.name === opts.env);
-  if (!environment) {
-    throw new Error(`Environment "${opts.env}" not found in project "${opts.project}"`);
-  }
-  return { projectId: project.id, environmentId: environment.id };
-}
-
-/** Garante projeto + environment na VPN (cria se não existir). */
-export async function ensureEnvironment(opts: EnsureOptions): Promise<{
-  projectId: string;
-  environmentId: string;
-  createdProject: boolean;
-  createdEnvironment: boolean;
-}> {
-  const client = opts.client ?? createClientFromEnv();
-  let createdProject = false;
-  let createdEnvironment = false;
-
-  let project = await findProject(client, opts.project);
-  if (!project) {
-    if (opts.createProject === false) {
-      throw new Error(`Project not found: ${opts.project}`);
-    }
-    await client.createProject(opts.project);
-    createdProject = true;
-    project = await findProject(client, opts.project);
-    if (!project) throw new Error(`Failed to create project: ${opts.project}`);
-  }
-
-  let environment = project.environments.find((e) => e.name === opts.env);
-  if (!environment) {
-    await client.createEnvironment(project.id, opts.env);
-    createdEnvironment = true;
-    const refreshed = await findProject(client, opts.project);
-    if (!refreshed) throw new Error(`Failed to reload project: ${opts.project}`);
-    project = refreshed;
-    environment = project.environments.find((e) => e.name === opts.env);
-    if (!environment) throw new Error(`Failed to create environment: ${opts.env}`);
-  }
-
-  return {
-    projectId: project.id,
-    environmentId: environment.id,
-    createdProject,
-    createdEnvironment,
-  };
-}
-
-/**
- * Cria (ou garante) o environment no vault via URL da VPN
- * e opcionalmente faz upsert das variáveis.
- */
-export async function createEnv(opts: CreateEnvOptions): Promise<{
-  projectId: string;
-  environmentId: string;
-  createdProject: boolean;
-  createdEnvironment: boolean;
-  upserted: string[];
-}> {
-  const client = resolveClient(opts);
-  const ensured = await ensureEnvironment({
-    project: opts.project,
-    env: opts.env,
-    client,
-  });
-
-  const upserted: string[] = [];
-  if (opts.vars) {
-    for (const [key, value] of Object.entries(opts.vars)) {
-      await client.upsertVar(ensured.environmentId, key, value);
-      upserted.push(key);
-    }
-  }
-
-  return { ...ensured, upserted };
-}
-
-export async function fetchVars(opts: ResolveOptions): Promise<EnvVar[]> {
-  const client = opts.client ?? createClientFromEnv();
-  const { environmentId } = await resolveEnvironment({ ...opts, client });
-  return client.listVars(environmentId);
-}
-
-export async function loadVault(
-  opts: ResolveOptions,
-): Promise<Record<string, string>> {
-  const rows = await fetchVars(opts);
-  const record = varsToRecord(rows);
-  for (const [key, value] of Object.entries(record)) {
-    process.env[key] = value;
-  }
-  return record;
-}
-
-export async function pullVault(opts: PullOptions): Promise<{
-  vars: Record<string, string>;
-  out?: string;
-}> {
-  const rows = await fetchVars(opts);
-  const vars = varsToRecord(rows);
-
-  if (opts.inject !== false) {
-    for (const [key, value] of Object.entries(vars)) {
-      process.env[key] = value;
-    }
-  }
-
-  const out = opts.out;
-  if (out) {
-    await writeFile(out, toDotEnv(vars), "utf8");
-  }
-
-  return out ? { vars, out } : { vars };
-}
+import { writeFile } from "node:fs/promises";
+import {
+  createClientFromEnv,
+  DEFAULT_VAULT_URL,
+  VaultClient,
+  type VaultClientOptions,
+} from "./client.js";
+import { toDotEnv, varsToRecord } from "./dotenv.js";
+import type { EnvVar, ProjectTree } from "./types.js";
+
+export type { EnvVar, ProjectTree, ProjectTreeEnv } from "./types.js";
+export {
+  VaultClient,
+  createClientFromEnv,
+  DEFAULT_VAULT_URL,
+  type VaultClientOptions,
+};
+export { toDotEnv, varsToRecord };
+
+export type ResolveOptions = {
+  project: string;
+  env: string;
+  client?: VaultClient;
+};
+
+export type EnsureOptions = ResolveOptions & {
+  createProject?: boolean;
+};
+
+export type PullOptions = ResolveOptions & {
+  out?: string;
+  inject?: boolean;
+};
+
+export type CreateEnvOptions = {
+  project: string;
+  env: string;
+  /** URL da API do vault na VPN (cluster-internal) */
+  url?: string;
+  vars?: Record<string, string>;
+  client?: VaultClient;
+};
+
+async function findProject(
+  client: VaultClient,
+  name: string,
+): Promise<ProjectTree | undefined> {
+  const tree = await client.listProjects();
+  return tree.find((p) => p.name === name);
+}
+
+function resolveClient(opts: { client?: VaultClient; url?: string }): VaultClient {
+  if (opts.client) return opts.client;
+  if (opts.url) return new VaultClient({ baseUrl: opts.url });
+  return createClientFromEnv();
+}
+
+export async function resolveEnvironment(
+  opts: ResolveOptions,
+): Promise<{ projectId: string; environmentId: string }> {
+  const client = opts.client ?? createClientFromEnv();
+  const project = await findProject(client, opts.project);
+  if (!project) throw new Error(`Project not found: ${opts.project}`);
+  const environment = project.environments.find((e) => e.name === opts.env);
+  if (!environment) {
+    throw new Error(`Environment "${opts.env}" not found in project "${opts.project}"`);
+  }
+  return { projectId: project.id, environmentId: environment.id };
+}
+
+/** Garante projeto + environment na VPN (cria se não existir). */
+export async function ensureEnvironment(opts: EnsureOptions): Promise<{
+  projectId: string;
+  environmentId: string;
+  createdProject: boolean;
+  createdEnvironment: boolean;
+}> {
+  const client = opts.client ?? createClientFromEnv();
+  let createdProject = false;
+  let createdEnvironment = false;
+
+  let project = await findProject(client, opts.project);
+  if (!project) {
+    if (opts.createProject === false) {
+      throw new Error(`Project not found: ${opts.project}`);
+    }
+    await client.createProject(opts.project);
+    createdProject = true;
+    project = await findProject(client, opts.project);
+    if (!project) throw new Error(`Failed to create project: ${opts.project}`);
+  }
+
+  let environment = project.environments.find((e) => e.name === opts.env);
+  if (!environment) {
+    await client.createEnvironment(project.id, opts.env);
+    createdEnvironment = true;
+    const refreshed = await findProject(client, opts.project);
+    if (!refreshed) throw new Error(`Failed to reload project: ${opts.project}`);
+    project = refreshed;
+    environment = project.environments.find((e) => e.name === opts.env);
+    if (!environment) throw new Error(`Failed to create environment: ${opts.env}`);
+  }
+
+  return {
+    projectId: project.id,
+    environmentId: environment.id,
+    createdProject,
+    createdEnvironment,
+  };
+}
+
+/**
+ * Cria (ou garante) o environment no vault via URL da VPN
+ * e opcionalmente faz upsert das variáveis.
+ */
+export async function createEnv(opts: CreateEnvOptions): Promise<{
+  projectId: string;
+  environmentId: string;
+  createdProject: boolean;
+  createdEnvironment: boolean;
+  upserted: string[];
+}> {
+  const client = resolveClient(opts);
+  const ensured = await ensureEnvironment({
+    project: opts.project,
+    env: opts.env,
+    client,
+  });
+
+  const upserted: string[] = [];
+  if (opts.vars) {
+    for (const [key, value] of Object.entries(opts.vars)) {
+      await client.upsertVar(ensured.environmentId, key, value);
+      upserted.push(key);
+    }
+  }
+
+  return { ...ensured, upserted };
+}
+
+export async function fetchVars(opts: ResolveOptions): Promise<EnvVar[]> {
+  const client = opts.client ?? createClientFromEnv();
+  const { environmentId } = await resolveEnvironment({ ...opts, client });
+  return client.listVars(environmentId);
+}
+
+export async function loadVault(
+  opts: ResolveOptions,
+): Promise<Record<string, string>> {
+  const rows = await fetchVars(opts);
+  const record = varsToRecord(rows);
+  for (const [key, value] of Object.entries(record)) {
+    process.env[key] = value;
+  }
+  return record;
+}
+
+export async function pullVault(opts: PullOptions): Promise<{
+  vars: Record<string, string>;
+  out?: string;
+}> {
+  const rows = await fetchVars(opts);
+  const vars = varsToRecord(rows);
+
+  if (opts.inject !== false) {
+    for (const [key, value] of Object.entries(vars)) {
+      process.env[key] = value;
+    }
+  }
+
+  const out = opts.out;
+  if (out) {
+    await writeFile(out, toDotEnv(vars), "utf8");
+  }
+
+  return out ? { vars, out } : { vars };
+}

package/src/types.ts

@@ -1,14 +1,14 @@
-export type ProjectTreeEnv = { id: string; name: string };
-
-export type ProjectTree = {
-  id: string;
-  name: string;
-  environments: ProjectTreeEnv[];
-};
-
-export type EnvVar = {
-  id: string;
-  key: string;
-  value: string;
-  updated_at: string;
-};
+export type ProjectTreeEnv = { id: string; name: string };
+
+export type ProjectTree = {
+  id: string;
+  name: string;
+  environments: ProjectTreeEnv[];
+};
+
+export type EnvVar = {
+  id: string;
+  key: string;
+  value: string;
+  updated_at: string;
+};