@voxgig/sdkgen 4.6.0 → 4.7.0

package/project/.sdk/tm/ts/src/feature/secrets/sekreto/provider/hashicorp.ts

@@ -0,0 +1,159 @@
+// VENDORED: @voxgig/sekreto 0.1.2 (typescript/src/provider/hashicorp.ts)
+// Source: https://github.com/voxgig/sekreto @ 65009cb5758850db767785ab666e71895f86086b
+// License: MIT (c) voxgig - see repository LICENSE. Do not edit: resync from upstream.
+/* Copyright (c) 2025 Voxgig Ltd, MIT License */
+
+import { ProviderSpec, Provider, SekretoError, checkname, nodemod, vaultref } from './support'
+import { checkaddr } from './addr'
+import { fetchjson } from './http'
+
+export function hashicorpprovider(
+  addr: string,
+  token: string,
+  options?: {
+    mount?: string
+    kv?: number
+    vaultnamespace?: string
+    auth?: ProviderSpec['auth']
+  },
+): Provider {
+  const opts = options || {}
+  const usemount = opts.mount || 'secret'
+  const kv = opts.kv || 2
+
+  // A version typo like kv: 3 must not quietly behave as v2 and turn
+  // its 404s into misses; there is nothing safe to assume it meant.
+  if (1 !== kv && 2 !== kv) {
+    throw new SekretoError('sekreto: hashicorp: unsupported kv version: ' + String(kv))
+  }
+
+  // The working token: a configured token is kept forever, a logged-in
+  // token is renewed shortly before its lease runs out - a long-running
+  // process must not keep presenting a token the vault already expired.
+  let livetoken: string | undefined = '' === token ? undefined : token
+  let renewat = Infinity
+
+  const baseheaders = (): Record<string, string> => {
+    const headers: Record<string, string> = {}
+    if (opts.vaultnamespace) {
+      headers['X-Vault-Namespace'] = opts.vaultnamespace
+    }
+    return headers
+  }
+
+  const login = async (): Promise<string> => {
+    const auth = opts.auth
+    if (!auth) {
+      throw new SekretoError('sekreto: hashicorp: no token and no auth method')
+    }
+
+    const mount = auth.mount || auth.method
+    const url = addr.replace(/\/$/, '') + '/v1/auth/' + mount + '/login'
+
+    let body: any
+    if ('kubernetes' === auth.method) {
+      let jwt = auth.jwt
+      if (undefined === jwt) {
+        const file = auth.jwtfile || '/var/run/secrets/kubernetes.io/serviceaccount/token'
+        try {
+          const { readFileSync } = nodemod<typeof import('node:fs')>('node:fs')
+          jwt = readFileSync(file, 'utf8').trim()
+        } catch (err: any) {
+          throw new SekretoError('sekreto: hashicorp: cannot read jwt file ' + file)
+        }
+      }
+      body = { role: auth.role || '', jwt }
+    } else if ('approle' === auth.method) {
+      body = { role_id: auth.roleid || '', secret_id: auth.secretid || '' }
+    } else {
+      throw new SekretoError('sekreto: hashicorp: unknown auth method: ' + String(auth.method))
+    }
+
+    const res = await fetchjson('POST', url, baseheaders(), JSON.stringify(body))
+
+    const got = res.body && res.body.auth && res.body.auth.client_token
+    if (200 !== res.status || !got) {
+      throw new SekretoError('sekreto: hashicorp login failed: ' + res.status + ': ' + url)
+    }
+
+    const lease = Number(res.body.auth.lease_duration)
+    renewat = 0 < lease ? Date.now() + Math.max(lease - 60, 1) * 1000 : Infinity
+
+    return String(got)
+  }
+
+  return {
+    lookup: async (name: string) => {
+      checkaddr(addr)
+
+      if (undefined === livetoken || Date.now() >= renewat) {
+        livetoken = await login()
+      }
+
+      const ref = vaultref(name)
+      const base = addr.replace(/\/$/, '') + '/v1/' + usemount
+      const url = 1 === kv ? base + '/' + ref.path : base + '/data/' + ref.path
+
+      const headers = baseheaders()
+      headers['X-Vault-Token'] = livetoken
+
+      const res = await fetchjson('GET', url, headers)
+
+      if (404 === res.status) {
+        return undefined
+      }
+
+      if (200 !== res.status) {
+        throw new SekretoError('sekreto: hashicorp error: ' + res.status + ': ' + url)
+      }
+
+      const data =
+        1 === kv ? res.body && res.body.data : res.body && res.body.data && res.body.data.data
+
+      const value = data ? data[ref.field] : undefined
+      return undefined === value || null === value ? undefined : String(value)
+    },
+    describe: () => 'hashicorp:' + addr + '/' + usemount,
+  }
+}
+
+/** A boru vault (https://github.com/boru-lang/boru).
+ *
+ * Two ways in, both boru's own.
+ *
+ * With no `addr`, the CLI: `boru vault get --reveal <alias>` prints the
+ * secret on stdout and nothing else. The passphrase is read by boru
+ * itself from `BORU_VAULT_PASSPHRASE`; sekreto never accepts it as
+ * config and never puts it on a command line, where it would show up in
+ * the process table.
+ *
+ * With an `addr`, boru's wire protocol: `boru vault serve` publishes a
+ * read-only, HashiCorp-shaped provision API (boru's
+ * design/VAULT-WIRE-PROTOCOL.0.md), authenticated by a capability token
+ * from `boru vault grant`. A sekreto name is already a valid boru
+ * alias, and boru aliases keep their dots, so `api.token` is the single
+ * path segment `api.token` - not the `api`/`token` split a HashiCorp KV
+ * gets. The value is the `value` field. A 404 is a miss; anything else
+ * the server refuses (a revoked capability, a sealed vault) is an
+ * error.
+ *
+ * boru's `vault proxy` and `vault mcp` remain out of bounds: they are a
+ * credential *broker*, built precisely so the caller never receives the
+ * credential. `vault serve` is the provision endpoint, built to hand
+ * the value back - that is the one sekreto uses. */
+
+
+// Registering at import is what makes this module's presence the only
+// thing that decides whether the kind exists in a build.
+import { register } from './Registry'
+
+register({
+  name: 'hashicorp',
+  needs: ['fetch', 'fs'],
+  define: (spec: ProviderSpec) => hashicorpprovider(spec.addr || '', spec.token || '', {
+    mount: spec.mount,
+    kv: spec.kv,
+    vaultnamespace: spec.vaultnamespace,
+    auth: spec.auth,
+  }),
+})

package/project/.sdk/tm/ts/src/feature/secrets/sekreto/provider/http.ts

@@ -0,0 +1,66 @@
+// VENDORED: @voxgig/sekreto 0.1.2 (typescript/src/provider/http.ts)
+// Source: https://github.com/voxgig/sekreto @ 65009cb5758850db767785ab666e71895f86086b
+// License: MIT (c) voxgig - see repository LICENSE. Do not edit: resync from upstream.
+/* Copyright (c) 2025 Voxgig Ltd, MIT License */
+
+import { SekretoError } from './support'
+import { checkaddr } from './addr'
+
+// Moved here with fetchjson, its only consumer.
+const HTTP_TIMEOUT_MS = 10000
+
+export async function fetchjson(
+  method: string,
+  url: string,
+  headers: Record<string, string>,
+  body?: string,
+): Promise<{ status: number; body: any }> {
+  let res: Response
+  try {
+    res = await fetch(url, {
+      method,
+      headers,
+      body,
+      // A vault API never legitimately redirects, and a followed redirect
+      // carries X-Vault-Token to the redirect's host (and can downgrade
+      // https to http), which checkaddr - it only validates the configured
+      // address - cannot see. Refuse to follow one.
+      redirect: 'error',
+      // Bound the wait so an accepted-but-silent endpoint cannot hang the
+      // caller (and the app's startup) forever.
+      signal: AbortSignal.timeout(HTTP_TIMEOUT_MS),
+    })
+  } catch (err: any) {
+    throw new SekretoError('sekreto: cannot reach ' + url.split('?')[0] + ': ' + err.message)
+  }
+
+  let parsed: any = undefined
+  try {
+    parsed = await res.json()
+  } catch (err: any) {
+    // A success status promised JSON; a body that does not parse means
+    // the store could not answer coherently, and treating it as a miss
+    // would fall through to a weaker store. Error statuses may carry
+    // any body - they are decided on status alone.
+    if (200 === res.status) {
+      throw new SekretoError('sekreto: malformed response from ' + url.split('?')[0])
+    }
+  }
+
+  return { status: res.status, body: parsed }
+}
+
+/** HashiCorp Vault.
+ *
+ * KV v2 (the default): `api.token` reads `{addr}/v1/{mount}/data/api`
+ * and takes the `token` field of `data.data`. KV v1 (`kv: 1`) reads
+ * `{addr}/v1/{mount}/api` and takes the field of `data`. A 404 means
+ * "not here" - a miss - so a vault can sit in a chain with fallbacks.
+ *
+ * A Vault Enterprise namespace rides the X-Vault-Namespace header, on
+ * logins as well as reads.
+ *
+ * Instead of being handed a token, the provider can log in: Kubernetes
+ * auth (the pod's service-account JWT, from its conventional path) or
+ * AppRole. A failed login is an error, never a miss - it means this
+ * store could not answer at all. */

package/project/.sdk/tm/ts/src/feature/secrets/sekreto/provider/infisical.ts

@@ -0,0 +1,107 @@
+// VENDORED: @voxgig/sekreto 0.1.2 (typescript/src/provider/infisical.ts)
+// Source: https://github.com/voxgig/sekreto @ 65009cb5758850db767785ab666e71895f86086b
+// License: MIT (c) voxgig - see repository LICENSE. Do not edit: resync from upstream.
+/* Copyright (c) 2025 Voxgig Ltd, MIT License */
+
+import { ProviderSpec, Provider, SekretoError, envkey } from './support'
+import { checkaddr } from './addr'
+import { fetchjson } from './http'
+
+export function infisicalprovider(options?: {
+  addr?: string
+  token?: string
+  clientid?: string
+  clientsecret?: string
+  project?: string
+  environment?: string
+  path?: string
+}): Provider {
+  const opts = options || {}
+
+  // A configured token is kept forever; a universal-auth token carries
+  // expiresIn and is renewed shortly before it runs out.
+  let livetoken: string | undefined
+  let renewat = Infinity
+
+  const login = async (addr: string): Promise<string> => {
+    if (opts.token) {
+      return opts.token
+    }
+
+    if (!opts.clientid || !opts.clientsecret) {
+      throw new SekretoError('sekreto: infisical: no token and no client credentials')
+    }
+
+    const res = await fetchjson(
+      'POST',
+      addr + '/api/v1/auth/universal-auth/login',
+      { 'content-type': 'application/json' },
+      JSON.stringify({ clientId: opts.clientid, clientSecret: opts.clientsecret }),
+    )
+
+    const got = res.body && res.body.accessToken
+    if (200 !== res.status || !got) {
+      throw new SekretoError('sekreto: infisical login failed: ' + res.status)
+    }
+
+    const expires = Number(res.body.expiresIn)
+    renewat = 0 < expires ? Date.now() + Math.max(expires - 60, 1) * 1000 : Infinity
+
+    return String(got)
+  }
+
+  return {
+    lookup: async (name: string) => {
+      const addr = (opts.addr || 'https://app.infisical.com').replace(/\/$/, '')
+      checkaddr(addr)
+
+      const project = opts.project || ''
+      const environment = opts.environment || ''
+      if ('' === project || '' === environment) {
+        throw new SekretoError('sekreto: infisical: no project/environment')
+      }
+
+      if (undefined === livetoken || Date.now() >= renewat) {
+        livetoken = await login(addr)
+      }
+
+      const url =
+        addr +
+        '/api/v3/secrets/raw/' +
+        envkey(name) +
+        '?workspaceId=' +
+        encodeURIComponent(project) +
+        '&environment=' +
+        encodeURIComponent(environment) +
+        '&secretPath=' +
+        encodeURIComponent(opts.path || '/')
+
+      const res = await fetchjson('GET', url, { authorization: 'Bearer ' + livetoken })
+
+      if (404 === res.status) {
+        return undefined
+      }
+
+      if (200 !== res.status) {
+        throw new SekretoError('sekreto: infisical error: ' + res.status)
+      }
+
+      const value = res.body && res.body.secret && res.body.secret.secretValue
+      return undefined === value || null === value ? undefined : String(value)
+    },
+    describe: () => 'infisical:' + (opts.project || '') + '/' + (opts.environment || ''),
+  }
+}
+
+/** Build a provider from its declarative form. */
+
+
+// Registering at import is what makes this module's presence the only
+// thing that decides whether the kind exists in a build.
+import { register } from './Registry'
+
+register({
+  name: 'infisical',
+  needs: ['fetch'],
+  define: (spec: ProviderSpec) => infisicalprovider(spec),
+})

package/project/.sdk/tm/ts/src/feature/secrets/sekreto/provider/memory.ts

@@ -0,0 +1,33 @@
+// VENDORED: @voxgig/sekreto 0.1.2 (typescript/src/provider/memory.ts)
+// Source: https://github.com/voxgig/sekreto @ 65009cb5758850db767785ab666e71895f86086b
+// License: MIT (c) voxgig - see repository LICENSE. Do not edit: resync from upstream.
+/* Copyright (c) 2025 Voxgig Ltd, MIT License */
+
+import { ProviderSpec, Provider, envkey } from './support'
+
+export function memoryprovider(values: Record<string, string>, prefix?: string): Provider {
+  return {
+    lookup: (name: string) => values[envkey(name, prefix)],
+    describe: () => 'memory' + (prefix ? ':' + prefix : ''),
+  }
+}
+
+/** A directory of one-secret-per-file entries, keyed like the
+ * environment: `api.token` reads `<dir>/API_TOKEN`.
+ *
+ * This is the shape of a mounted Kubernetes Secret, a Docker or Swarm
+ * secret, and a systemd credentials directory, so those all work with no
+ * further configuration. One trailing newline is stripped - tools that
+ * write these files disagree about it, and a newline is never part of a
+ * secret on purpose. */
+
+
+// Registering at import is what makes this module's presence the only
+// thing that decides whether the kind exists in a build.
+import { register } from './Registry'
+
+register({
+  name: 'memory',
+  needs: [],
+  define: (spec: ProviderSpec) => memoryprovider(spec.values || {}, spec.prefix),
+})

package/project/.sdk/tm/ts/src/feature/secrets/sekreto/provider/onepassword.ts

@@ -0,0 +1,120 @@
+// VENDORED: @voxgig/sekreto 0.1.2 (typescript/src/provider/onepassword.ts)
+// Source: https://github.com/voxgig/sekreto @ 65009cb5758850db767785ab666e71895f86086b
+// License: MIT (c) voxgig - see repository LICENSE. Do not edit: resync from upstream.
+/* Copyright (c) 2025 Voxgig Ltd, MIT License */
+
+import {
+  ProviderSpec, Provider, SekretoError, checkname, vaultref,
+} from './support'
+import { checkaddr } from './addr'
+import { fetchjson } from './http'
+
+export function onepasswordprovider(options?: {
+  addr?: string
+  token?: string
+  vault?: string
+}): Provider {
+  const opts = options || {}
+
+  let vaultid: string | undefined
+
+  const auth = (): Record<string, string> => ({
+    authorization: 'Bearer ' + (opts.token || ''),
+  })
+
+  const resolvevault = async (addr: string): Promise<string> => {
+    const want = opts.vault || ''
+    if ('' === want) {
+      throw new SekretoError('sekreto: onepassword: no vault')
+    }
+
+    const res = await fetchjson('GET', addr + '/v1/vaults', auth())
+
+    if (200 !== res.status || !Array.isArray(res.body)) {
+      throw new SekretoError('sekreto: onepassword error: ' + res.status + ': listing vaults')
+    }
+
+    for (const entry of res.body) {
+      if (entry && (want === entry.id || want === entry.name)) {
+        return String(entry.id)
+      }
+    }
+
+    throw new SekretoError('sekreto: onepassword: no vault named ' + want)
+  }
+
+  return {
+    lookup: async (name: string) => {
+      checkname(name)
+
+      const addr = (opts.addr || '').replace(/\/$/, '')
+      if ('' === addr) {
+        throw new SekretoError('sekreto: onepassword: no addr')
+      }
+      checkaddr(addr)
+
+      if (undefined === vaultid) {
+        vaultid = await resolvevault(addr)
+      }
+
+      const filter = encodeURIComponent('title eq "' + name + '"')
+      const found = await fetchjson(
+        'GET',
+        addr + '/v1/vaults/' + vaultid + '/items?filter=' + filter,
+        auth(),
+      )
+
+      if (200 !== found.status || !Array.isArray(found.body)) {
+        throw new SekretoError('sekreto: onepassword error: ' + found.status + ': finding ' + name)
+      }
+
+      if (0 === found.body.length) {
+        return undefined
+      }
+
+      const item = await fetchjson(
+        'GET',
+        addr + '/v1/vaults/' + vaultid + '/items/' + found.body[0].id,
+        auth(),
+      )
+
+      if (200 !== item.status) {
+        throw new SekretoError('sekreto: onepassword error: ' + item.status + ': reading ' + name)
+      }
+
+      const fields = (item.body && item.body.fields) || []
+
+      for (const field of fields) {
+        if (field && 'PASSWORD' === field.purpose) {
+          return undefined === field.value || null === field.value ? undefined : String(field.value)
+        }
+      }
+      for (const field of fields) {
+        if (field && 'value' === field.label) {
+          return undefined === field.value || null === field.value ? undefined : String(field.value)
+        }
+      }
+
+      return undefined
+    },
+    describe: () => 'onepassword:' + (opts.vault || ''),
+  }
+}
+
+/** Doppler.
+ *
+ * The whole config is downloaded once - Doppler's own bulk endpoint -
+ * and answered from memory, like a remote .env: `api.token` is the
+ * `API_TOKEN` entry. A service token is config-scoped, so project and
+ * config are only needed with broader tokens. */
+
+
+// Registering at import is what makes this module's presence the only
+// thing that decides whether the kind exists in a build.
+import { register } from './Registry'
+
+register({
+  name: 'onepassword',
+  needs: ['fetch'],
+  define: (spec: ProviderSpec) => onepasswordprovider(spec),
+})

package/project/.sdk/tm/ts/src/feature/secrets/sekreto/provider/support.ts

@@ -0,0 +1,176 @@
+// VENDORED: @voxgig/sekreto 0.1.2 (typescript/src/provider/support.ts)
+// Source: https://github.com/voxgig/sekreto @ 65009cb5758850db767785ab666e71895f86086b
+// License: MIT (c) voxgig - see repository LICENSE. Do not edit: resync from upstream.
+// The providers a Sekreto chains together.
+//
+// A provider answers one question: "do you have this secret?" It returns
+// the value, or undefined to mean "ask the next one". Nothing else about
+// a provider is visible to the caller - which is the point: an app reads
+// `api.token` and never learns whether it came from the environment, a
+// .env file, HashiCorp Vault, AWS, GCP, Azure or a boru vault.
+//
+// Two failure shapes, and they are never interchangeable. A store that
+// does not hold the secret is a MISS (undefined) - the chain carries on.
+// A store that could not answer - bad credentials, unreachable host,
+// missing configuration - is an ERROR: falling through there would
+// quietly reach for a weaker store.
+
+import {
+  SekretoError,
+  awsparam,
+  checkname,
+  envkey,
+  flatname,
+  parsedotenv,
+  vaultref,
+} from '../Sekreto'
+
+// NODE BUILTINS, LOADED ON FIRST USE.
+//
+// These were top-level imports, which made them a side effect of importing
+// sekreto AT ALL: `child_process`, `fs` and `path` entered the module graph
+// for a caller who only ever used a `memory` or `env` provider, and any
+// runtime lacking them failed at import time rather than at the point of
+// use. Sekreto.ts imports makeprovider from this module, so the chain
+// reached everything.
+//
+// A plain require(), not `await import()`: dotenvprovider, fileprovider and
+// boruprovider all have SYNCHRONOUS lookups, and making them async to
+// accommodate a dynamic import would change observable behaviour for anyone
+// calling a provider directly. The package is CommonJS ("type":
+// "commonjs"), so require is available and synchronous.
+//
+// What this buys and what it does not: the builtins are no longer evaluated
+// at import time, so importing sekreto is safe in a runtime that lacks them
+// and a bundler can drop an unreachable provider along with its edge. It is
+// NOT by itself a complete browser story — a bundler still resolves a
+// require it can see statically, so a browser build wants conditional
+// exports ("browser" field) as well. That is a packaging change, tracked
+// separately.
+const nodemods: Record<string, any> = {}
+
+function nodemod<T = any>(name: string): T {
+  let mod = nodemods[name]
+
+  if (undefined === mod) {
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-require-imports
+      mod = nodemods[name] = require(name)
+    } catch (err: any) {
+      throw new SekretoError(
+        'sekreto: this provider needs ' +
+          name +
+          ', which this runtime does not provide: ' +
+          err.message,
+      )
+    }
+  }
+
+  return mod as T
+}
+
+export type Provider = {
+  /** The value, or undefined if this provider does not have it. */
+  lookup: (name: string) => Promise<string | undefined> | string | undefined
+  /** A short description, shown by `Sekreto.sources()`. */
+  describe: () => string
+}
+
+/** The declarative form of a provider, as used in config and in the
+ * shared spec. */
+export type ProviderSpec = {
+  kind:
+    | 'env'
+    | 'dotenv'
+    | 'memory'
+    | 'file'
+    | 'hashicorp'
+    | 'boru'
+    | 'awssecrets'
+    | 'awsparams'
+    | 'gcpsecrets'
+    | 'azuresecrets'
+    | 'onepassword'
+    | 'doppler'
+    | 'infisical'
+  /** The store name `Sekreto.getfrom` addresses. Defaults to `kind`. */
+  name?: string
+  prefix?: string
+  /** dotenv: the file to read. */
+  file?: string
+  /** memory: literal values, keyed like environment variables. */
+  values?: Record<string, string>
+  /** file: the directory of one-secret-per-file entries. */
+  dir?: string
+  /** hashicorp / boru (wire) / gcp / 1password / doppler / infisical:
+   * the base URL. */
+  addr?: string
+  /** hashicorp / boru (wire) / gcp / azure / 1password / doppler /
+   * infisical: the access token. */
+  token?: string
+  /** hashicorp / boru (wire): the KV mount (default `secret`). */
+  mount?: string
+  /** hashicorp: KV engine version, 1 or 2 (default 2). */
+  kv?: number
+  /** hashicorp: Vault Enterprise namespace (X-Vault-Namespace). */
+  vaultnamespace?: string
+  /** hashicorp: log in for a token instead of being handed one. */
+  auth?: {
+    method: 'kubernetes' | 'approle'
+    /** The auth mount, defaulting to the method name. */
+    mount?: string
+    /** kubernetes: the Vault role to log in as. */
+    role?: string
+    /** kubernetes: the service-account JWT itself (tests). */
+    jwt?: string
+    /** kubernetes: where the JWT lives; the conventional pod path by
+     * default. */
+    jwtfile?: string
+    /** approle: the role and secret ids. */
+    roleid?: string
+    secretid?: string
+  }
+  /** boru: the executable to run (default `boru`). */
+  command?: string
+  /** boru: the namespace qualifying the alias. */
+  namespace?: string
+  /** boru: the vault home, passed as BORU_HOME. */
+  home?: string
+  /** aws: region and credentials; the standard AWS_* environment
+   * variables fill whichever are not given. */
+  region?: string
+  keyid?: string
+  secret?: string
+  session?: string
+  /** gcp / doppler / infisical: the project (GCP project id, Doppler
+   * project slug, Infisical workspace id). */
+  project?: string
+  /** azure: the Key Vault name or full URL. 1password: the vault name
+   * or id. */
+  vault?: string
+  /** azure: client-credential login. infisical: universal-auth login
+   * (tenant is Azure-only). */
+  tenant?: string
+  clientid?: string
+  clientsecret?: string
+  /** azure: where to log in / where IMDS answers. gcp: where the
+   * metadata server answers. Overridable for tests and for clouds with
+   * nonstandard endpoints. */
+  loginaddr?: string
+  imdsaddr?: string
+  metadataaddr?: string
+  /** azure: the Key Vault API version (default 7.4). */
+  apiversion?: string
+  /** doppler: the config slug (with `project`). */
+  config?: string
+  /** infisical: the environment slug and secret path. */
+  environment?: string
+  path?: string
+}
+
+/** Environment variables: `api.token` from `API_TOKEN`. */
+
+export {
+  SekretoError, awsparam, checkname, envkey, flatname, parsedotenv, vaultref,
+}
+export { nodemod }