@tenonhq/dovetail-servicenow 0.0.20 → 0.0.21

package/dist/createClientFromEnvFile.d.ts

@@ -0,0 +1,29 @@
+import type { ServiceNowClient } from "./client";
+import type { ServiceNowClientConfig } from "./types";
+/**
+ * Build a ServiceNowClientConfig from a `.env`-style file WITHOUT mutating the
+ * global process.env.
+ *
+ * Unlike `loadEnvFile` (which calls `dotenv.config()` and is correct for a
+ * one-shot CLI), this reads the file into a local object via `dotenv.parse` so
+ * it is safe to call repeatedly inside a long-lived process — e.g. a per-call
+ * retarget in the MCP server, where a global dotenv mutation would race across
+ * concurrent reads.
+ *
+ * Instance/auth precedence within the file mirrors `createClient`'s env
+ * precedence (SN_* > SN_DEV_* > SN_PROD_*) so a file written for either the
+ * dev-style or prod-style variable names resolves the same way. The resolved
+ * values are returned as an explicit config object — they are never read from
+ * the surrounding process.env, so the file fully determines the target.
+ *
+ * Throws if the file cannot be read, or if it does not define an instance and
+ * a complete credential pair — failing loudly rather than silently falling
+ * back to whatever instance the host process happens to be pointed at.
+ */
+export declare function resolveConfigFromEnvFile(envPath: string): ServiceNowClientConfig;
+/**
+ * Construct a ServiceNowClient bound to the instance/credentials defined in a
+ * `.env`-style file, without touching the global process.env. See
+ * `resolveConfigFromEnvFile` for the precedence and failure rules.
+ */
+export declare function createClientFromEnvFile(envPath: string): ServiceNowClient;

package/dist/createClientFromEnvFile.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConfigFromEnvFile = resolveConfigFromEnvFile;
+exports.createClientFromEnvFile = createClientFromEnvFile;
+const fs_1 = __importDefault(require("fs"));
+const dotenv_1 = __importDefault(require("dotenv"));
+const client_1 = require("./client");
+/**
+ * Build a ServiceNowClientConfig from a `.env`-style file WITHOUT mutating the
+ * global process.env.
+ *
+ * Unlike `loadEnvFile` (which calls `dotenv.config()` and is correct for a
+ * one-shot CLI), this reads the file into a local object via `dotenv.parse` so
+ * it is safe to call repeatedly inside a long-lived process — e.g. a per-call
+ * retarget in the MCP server, where a global dotenv mutation would race across
+ * concurrent reads.
+ *
+ * Instance/auth precedence within the file mirrors `createClient`'s env
+ * precedence (SN_* > SN_DEV_* > SN_PROD_*) so a file written for either the
+ * dev-style or prod-style variable names resolves the same way. The resolved
+ * values are returned as an explicit config object — they are never read from
+ * the surrounding process.env, so the file fully determines the target.
+ *
+ * Throws if the file cannot be read, or if it does not define an instance and
+ * a complete credential pair — failing loudly rather than silently falling
+ * back to whatever instance the host process happens to be pointed at.
+ */
+function resolveConfigFromEnvFile(envPath) {
+    if (typeof envPath !== "string" || envPath.length === 0) {
+        throw new Error("resolveConfigFromEnvFile: envPath must be a non-empty string.");
+    }
+    var raw;
+    try {
+        raw = fs_1.default.readFileSync(envPath, "utf8");
+    }
+    catch (e) {
+        throw new Error("Cannot read env file '" + envPath + "': " + (e && e.message ? e.message : String(e)));
+    }
+    var parsed = dotenv_1.default.parse(raw);
+    var instance = parsed.SN_INSTANCE || parsed.SN_DEV_INSTANCE || parsed.SN_PROD_INSTANCE || "";
+    var user = parsed.SN_USER || parsed.SN_DEV_USERNAME || parsed.SN_PROD_USERNAME || "";
+    var password = parsed.SN_PASSWORD || parsed.SN_DEV_PASSWORD || parsed.SN_PROD_PASSWORD || "";
+    if (!instance) {
+        throw new Error("env file '" + envPath + "' does not define a ServiceNow instance — " +
+            "set SN_INSTANCE (preferred) or SN_DEV_INSTANCE / SN_PROD_INSTANCE.");
+    }
+    if (!user || !password) {
+        throw new Error("env file '" + envPath + "' is missing ServiceNow credentials — " +
+            "set SN_USER/SN_PASSWORD (preferred) or SN_DEV_USERNAME/SN_DEV_PASSWORD (or SN_PROD_*).");
+    }
+    return { instance: instance, user: user, password: password };
+}
+/**
+ * Construct a ServiceNowClient bound to the instance/credentials defined in a
+ * `.env`-style file, without touching the global process.env. See
+ * `resolveConfigFromEnvFile` for the precedence and failure rules.
+ */
+function createClientFromEnvFile(envPath) {
+    return (0, client_1.createClient)(resolveConfigFromEnvFile(envPath));
+}

package/dist/index.d.ts

@@ -5,6 +5,7 @@
  * REST API so every change lands in the target update set and scope.
  */
 export { createClient } from "./client";
+export { createClientFromEnvFile, resolveConfigFromEnvFile } from "./createClientFromEnvFile";
 export type { ServiceNowClient, TableQueryOptions, TableSchema, TableSchemaField } from "./client";
 export { addChoicesToField } from "./choices";
 export { formatAddChoicesResult } from "./formatter";

package/dist/index.js

@@ -6,9 +6,12 @@
  * REST API so every change lands in the target update set and scope.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_SAVE_ACTION = exports.DEFAULT_SUPER_CLASS = exports.TYPE_MAP = exports.defaultAccessFlags = exports.applyTableSaveOverlay = exports.resolveType = exports.normalizeColumns = exports.buildColumnXml = exports.projectTableGraph = exports.createTable = exports.WriteOrderError = exports.executeWritePlan = exports.topoSort = exports.generateSysId = exports.DEFAULT_RUN_FLOW_PATH = exports.testFlow = exports.editFlow = exports.buildPublishModel = exports.createFlow = exports.copyFlow = exports.publishFlow = exports.readActionType = exports.readFlow = exports.editActionType = exports.publishActionType = exports.triggerPublication = exports.cloneActionType = exports.cloneSubflow = exports.verifyArtifact = exports.listTemplates = exports.sincPlugin = exports.formatCreateViewResult = exports.formatLayoutResult = exports.setRelatedLists = exports.setFormLayout = exports.setListLayout = exports.createView = exports.formatAddChoicesResult = exports.addChoicesToField = exports.createClient = void 0;
+exports.DEFAULT_SAVE_ACTION = exports.DEFAULT_SUPER_CLASS = exports.TYPE_MAP = exports.defaultAccessFlags = exports.applyTableSaveOverlay = exports.resolveType = exports.normalizeColumns = exports.buildColumnXml = exports.projectTableGraph = exports.createTable = exports.WriteOrderError = exports.executeWritePlan = exports.topoSort = exports.generateSysId = exports.DEFAULT_RUN_FLOW_PATH = exports.testFlow = exports.editFlow = exports.buildPublishModel = exports.createFlow = exports.copyFlow = exports.publishFlow = exports.readActionType = exports.readFlow = exports.editActionType = exports.publishActionType = exports.triggerPublication = exports.cloneActionType = exports.cloneSubflow = exports.verifyArtifact = exports.listTemplates = exports.sincPlugin = exports.formatCreateViewResult = exports.formatLayoutResult = exports.setRelatedLists = exports.setFormLayout = exports.setListLayout = exports.createView = exports.formatAddChoicesResult = exports.addChoicesToField = exports.resolveConfigFromEnvFile = exports.createClientFromEnvFile = exports.createClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "createClient", { enumerable: true, get: function () { return client_1.createClient; } });
+var createClientFromEnvFile_1 = require("./createClientFromEnvFile");
+Object.defineProperty(exports, "createClientFromEnvFile", { enumerable: true, get: function () { return createClientFromEnvFile_1.createClientFromEnvFile; } });
+Object.defineProperty(exports, "resolveConfigFromEnvFile", { enumerable: true, get: function () { return createClientFromEnvFile_1.resolveConfigFromEnvFile; } });
 var choices_1 = require("./choices");
 Object.defineProperty(exports, "addChoicesToField", { enumerable: true, get: function () { return choices_1.addChoicesToField; } });
 var formatter_1 = require("./formatter");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tenonhq/dovetail-servicenow",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "engines": {
     "node": ">=22"
   },