@suronai/sdk 0.1.17 → 0.1.18

package/index.d.ts

@@ -13,6 +13,13 @@ export interface VaultOptions {
  */
 export function vault(options?: VaultOptions): Promise<void>;
 
+/**
+ * Safe wrapper around vault(). Handles all known Suron errors with
+ * console.error + process.exit(1). Unknown errors are re-thrown.
+ * Must be awaited before any code that reads process.env.
+ */
+export function Suron(options?: VaultOptions): Promise<void>;
+
 export class SuronError extends Error {}
 export class SuronConfigError extends SuronError {}
 export class SuronAppNotFoundError extends SuronError {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suronai/sdk",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "App SDK for Suron — await vault() to load secrets",
   "type": "module",
   "main": "./src/index.js",

package/src/index.js

@@ -1,4 +1,4 @@
-export { vault } from "./vault.js";
+export { vault, Suron } from "./vault.js";
 export {
   SuronError,
   SuronConfigError,

package/src/vault.js

@@ -121,3 +121,22 @@ export async function vault(options = {}) {
   // Note: JS strings are immutable — there is no way to scrub the value from
   // heap memory. The reference is dropped here and will be GC'd normally.
 }
+
+/**
+ * Drop-in safe wrapper around vault().
+ * Handles all known Suron errors with a console.error + process.exit(1).
+ * Unknown errors are re-thrown so the caller still sees them.
+ * @param {VaultOptions} [options]
+ * @returns {Promise<void>}
+ */
+export async function Suron(options = {}) {
+  try {
+    await vault(options);
+  } catch (err) {
+    if (err instanceof SuronDeniedError)      { console.error("[suron] Boot denied.");        process.exit(1); }
+    if (err instanceof SuronTimeoutError)     { console.error("[suron] Approval timed out."); process.exit(1); }
+    if (err instanceof SuronConfigError)      { console.error("[suron]", err.message);        process.exit(1); }
+    if (err instanceof SuronAppNotFoundError) { console.error("[suron]", err.message);        process.exit(1); }
+    throw err;
+  }
+}