@snutils/snu 0.3.3 → 0.3.5

package/dist/nowsdk/NowSdkFlows.js

@@ -0,0 +1,203 @@
+"use strict";
+// Deploy and pull for NOW SDK apps as used by agents and the `snu` CLI, in
+// both the VS Code bridge and the standalone `snu serve` bridge. Each host
+// passes its own transport to the SN Utils helper tab; the steps and the
+// outcomes are the same everywhere. The editor commands (NowSdkDeploy.ts) use
+// the same building blocks with interactive prompts instead of flags.
+//
+// Kept free of `vscode` imports. packages/snu/src/nowsdk/ holds a
+// byte-identical copy; src/test/nowSdkShared.test.ts fails when they drift.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NowSdkFlowError = void 0;
+exports.describeChange = describeChange;
+exports.deployFlow = deployFlow;
+exports.pullFlow = pullFlow;
+const NowSdkProject_1 = require("./NowSdkProject");
+const NowSdkBuild_1 = require("./NowSdkBuild");
+const NowSdkPull_1 = require("./NowSdkPull");
+class NowSdkFlowError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+    }
+}
+exports.NowSdkFlowError = NowSdkFlowError;
+function loadProject(root) {
+    try {
+        const project = (0, NowSdkProject_1.readNowSdkProject)(root);
+        (0, NowSdkProject_1.assertSupportedProject)(project);
+        (0, NowSdkProject_1.assertSupportedSdk)(project.root);
+        return project;
+    }
+    catch (e) {
+        throw new NowSdkFlowError('E_INVALID_PARAMS', e?.message || String(e));
+    }
+}
+const hasAppId = (project) => /^[0-9a-f]{32}$/.test(project.scopeId);
+/** "UI Page Todo Board (html; built from your UI source)" */
+function describeChange(c) {
+    const parts = [
+        c.status === 'removed' ? 'deleted on the instance' : c.status === 'new' ? 'new on the instance' : '',
+        c.fields && c.fields.length ? c.fields.join(', ') : '',
+        c.reason || '',
+    ].filter(Boolean);
+    return parts.length ? `${c.label} (${parts.join('; ')})` : c.label;
+}
+const describe = (changes) => {
+    const shown = changes.slice(0, 5).map(describeChange).join(', ');
+    return changes.length > 5 ? `${shown} and ${changes.length - 5} more` : shown;
+};
+/**
+ * Build, check the instance for changes made since the last deploy or pull,
+ * and install. Changes on the instance stop the deploy unless `force` is set.
+ */
+async function deployFlow(root, transport, opts = {}) {
+    const project = loadProject(root);
+    const log = (text) => transport.log?.(text);
+    const app = { name: project.name, scope: project.scope, version: project.version };
+    const canCheck = transport.canDownload && hasAppId(project) && (0, NowSdkPull_1.hasBaseline)(project.root, transport.instanceName);
+    // The instance download runs while the app builds; the comparison needs both.
+    let checkError = null;
+    const download = canCheck
+        ? transport.download(project).catch((e) => {
+            checkError = e;
+            return null;
+        })
+        : Promise.resolve(null);
+    let pkg;
+    try {
+        pkg = await (0, NowSdkBuild_1.buildNowSdkPackage)(project.root, log);
+    }
+    catch (e) {
+        throw new NowSdkFlowError(e instanceof NowSdkProject_1.NowSdkProjectError ? 'E_INVALID_PARAMS' : 'E_COMMAND_FAILED', e?.message || String(e));
+    }
+    const instanceZip = await download;
+    if (checkError) {
+        const why = checkError?.message || String(checkError);
+        log(`Could not check ${transport.instanceName} for changes: ${why}`);
+        // The deploy would be refused for the same reason.
+        if (['E_PRO_REQUIRED', 'E_PAUSED'].includes(checkError?.code))
+            throw new NowSdkFlowError(checkError.code, why, { app });
+        // Without the check a deploy could overwrite work on the instance unseen.
+        if (!opts.force) {
+            throw new NowSdkFlowError('E_CONFIRM_REQUIRED', `Could not check ${transport.instanceName} for changes made since the last deploy or pull (${why}). Retry, or deploy with force to install without the check.`, { checkFailed: true, app });
+        }
+    }
+    const conflicts = instanceZip ? (0, NowSdkPull_1.deployConflicts)(project.root, transport.instanceName, instanceZip, project.appOutputDir) : null;
+    const changes = conflicts?.overwritten || [];
+    if (changes.length > 0 && !opts.force) {
+        const unpullable = changes.filter((c) => c.generated);
+        throw new NowSdkFlowError('E_INSTANCE_CHANGED', `The deploy would overwrite ${changes.length} change${changes.length === 1 ? '' : 's'} made on ${transport.instanceName} since the last deploy or pull: ${describe(changes)}. ` +
+            (unpullable.length === changes.length
+                ? 'A pull cannot bring these in: copy the changes into the source by hand, or deploy with force to overwrite them.'
+                : 'Pull them into the project first (snu sdk pull), or deploy with force to overwrite them.' +
+                    (unpullable.length ? ` A pull cannot bring in ${unpullable.map((c) => c.label).join(', ')}; copy those by hand.` : '')), { changes, instanceOnly: conflicts?.instanceOnly || [], app });
+    }
+    let raw;
+    try {
+        raw = await transport.deploy(pkg);
+    }
+    catch (e) {
+        if (e?.code === 'E_TIMEOUT') {
+            throw new NowSdkFlowError('E_TIMEOUT', `No deploy result within ${NowSdkBuild_1.DEPLOY_TIMEOUT_MS / 60000} minutes. The install may still have finished: check the app on the instance before deploying again.`);
+        }
+        throw e;
+    }
+    const outcome = (0, NowSdkBuild_1.summarizeDeployResult)(raw);
+    if (!outcome.installed) {
+        const code = ['E_PRO_REQUIRED', 'E_USER_REJECTED', 'E_PAUSED'].includes(outcome.code || '') ? outcome.code : 'E_COMMAND_FAILED';
+        const reason = outcome.reason ? ` (${outcome.reason})` : '';
+        throw new NowSdkFlowError(code, `${outcome.error}${reason}`, { ...outcome, app });
+    }
+    (0, NowSdkProject_1.writeDeployLink)(project.root, { instance: transport.instanceName, url: transport.instanceUrl });
+    (0, NowSdkPull_1.markDeployed)(project.root, transport.instanceName);
+    let baselineRecorded = false;
+    if (transport.canDownload && hasAppId(project)) {
+        try {
+            await (0, NowSdkPull_1.saveBaselineFromPackage)(project.root, transport.instanceName, await transport.download(project));
+            baselineRecorded = true;
+        }
+        catch (e) {
+            log(`Could not record the ${transport.instanceName} baseline: ${e?.message || e}`);
+        }
+    }
+    return {
+        ...outcome,
+        app,
+        instance: transport.instanceName,
+        ...(changes.length > 0 ? { overwritten: changes } : {}),
+        ...(conflicts?.instanceOnly.length ? { instanceOnly: conflicts.instanceOnly } : {}),
+        baselineRecorded,
+        // Whether the deploy was checked against changes on the instance.
+        instanceChecked: instanceZip !== null,
+    };
+}
+/**
+ * Pull the instance's version of the app into the project. Applied when git
+ * can show and undo it (the affected files have no uncommitted edits);
+ * otherwise it stops unless `force` is set. `dryRun` only lists the changes.
+ */
+async function pullFlow(root, transport, opts = {}) {
+    const project = loadProject(root);
+    const log = (text) => transport.log?.(text);
+    const app = { name: project.name, scope: project.scope, version: project.version };
+    if (!hasAppId(project)) {
+        throw new NowSdkFlowError('E_INVALID_PARAMS', `Pull needs the application sys_id as scopeId in now.config.json; ${project.name} has "${project.scopeId}".`);
+    }
+    if (!transport.canDownload) {
+        throw new NowSdkFlowError('E_UNSUPPORTED_HOST', 'The connected SN Utils helper tab cannot pull NOW SDK apps. Update SN Utils and reopen the ScriptSync helper tab.');
+    }
+    const zip = await transport.download(project);
+    let staged;
+    try {
+        staged = await (0, NowSdkPull_1.stagePull)(project.root, zip, log);
+    }
+    catch (e) {
+        throw new NowSdkFlowError(e instanceof NowSdkProject_1.NowSdkProjectError ? 'E_INVALID_PARAMS' : 'E_COMMAND_FAILED', e?.message || String(e));
+    }
+    try {
+        const changes = staged.changes.map((c) => ({ path: c.path, status: c.status }));
+        const toApply = staged.changes.filter((c) => c.status !== 'removed');
+        const notOnInstance = staged.changes.filter((c) => c.status === 'removed').map((c) => c.path);
+        const base = { app, instance: transport.instanceName, changes };
+        if (opts.dryRun)
+            return { ...base, applied: [], dryRun: true };
+        if (toApply.length > 0) {
+            const dirty = await (0, NowSdkPull_1.gitUncommittedPaths)(project.root, toApply.map((c) => c.path));
+            if ((dirty === null || dirty.length > 0) && !opts.force) {
+                const why = dirty === null
+                    ? 'The project is not in a git repository, so a pull cannot be reviewed or undone there.'
+                    : `${dirty.length} file${dirty.length === 1 ? '' : 's'} the pull would change ${dirty.length === 1 ? 'has' : 'have'} uncommitted edits: ${dirty.join(', ')}. Commit or stash them first.`;
+                throw new NowSdkFlowError('E_CONFIRM_REQUIRED', `${why} Pull with force to apply anyway, or with dryRun to only list the changes.`, { ...base, uncommitted: dirty });
+            }
+            (0, NowSdkPull_1.applyPullWithUndo)(project.root, staged.stagingRoot, toApply);
+        }
+        const firstPull = !(0, NowSdkPull_1.hasPulledBefore)(project.root);
+        (0, NowSdkPull_1.markPulled)(project.root, transport.instanceName);
+        (0, NowSdkProject_1.writeDeployLink)(project.root, { instance: transport.instanceName, url: transport.instanceUrl });
+        // Changes the SDK's pull cannot bring in stay at their old version in
+        // the baseline, so the next deploy keeps warning about them.
+        const notPulled = (await (0, NowSdkPull_1.instanceChangesFromPackage)(project.root, transport.instanceName, zip)).filter((c) => c.generated);
+        try {
+            await (0, NowSdkPull_1.saveBaselineFromPackage)(project.root, transport.instanceName, zip, log, notPulled.map((c) => c.file).filter(Boolean));
+        }
+        catch (e) {
+            log(`Could not record the ${transport.instanceName} baseline: ${e?.message || e}`);
+        }
+        return {
+            ...base,
+            applied: toApply.map((c) => c.path),
+            upToDate: staged.changes.length === 0,
+            ...(notOnInstance.length ? { notOnInstance } : {}),
+            ...(firstPull && toApply.length ? { firstPull: true } : {}),
+            ...(notPulled.length ? { notPulled: notPulled.map(({ label, status, reason }) => ({ label, status, reason })) } : {}),
+        };
+    }
+    finally {
+        (0, NowSdkPull_1.cleanupPull)(staged.tempDir);
+    }
+}
+//# sourceMappingURL=NowSdkFlows.js.map

package/dist/nowsdk/NowSdkFlows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NowSdkFlows.js","sourceRoot":"","sources":["../../src/nowsdk/NowSdkFlows.ts"],"names":[],"mappings":"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"}

package/dist/nowsdk/NowSdkProject.d.ts

@@ -0,0 +1,71 @@
+export declare const NOW_CONFIG_FILE = "now.config.json";
+export interface NowSdkProject {
+    root: string;
+    name: string;
+    scope: string;
+    scopeId: string;
+    version: string;
+    appOutputDir: string;
+    packOutputDir: string;
+    /** now.config.json `type`: 'package' (default) or 'configuration'. */
+    type: string;
+    /** now.config.json `installAs`, e.g. 'store'. */
+    installAs: string;
+    hasHostedPlugins: boolean;
+}
+/** ServiceNow SDK versions whose packages and install protocol match what ScriptSync sends. */
+export declare const SUPPORTED_SDK: {
+    min: string;
+    belowMajor: number;
+};
+export interface NowSdkDeployLink {
+    instance: string;
+    url: string;
+}
+export declare class NowSdkProjectError extends Error {
+}
+/**
+ * The NOW SDK project root that contains `filePath`, or null. When `stopAt` is
+ * given, only directories from the file's folder up to and including `stopAt`
+ * are checked, so a project outside that folder never matches.
+ */
+export declare function findNowSdkProjectRoot(filePath: string, stopAt?: string): string | null;
+export declare function readNowSdkProject(root: string): NowSdkProject;
+/**
+ * Refuse app types ScriptSync does not deploy or pull the way the SDK does,
+ * with a pointer to `now-sdk install` / `now-sdk transform` for them.
+ */
+export declare function assertSupportedProject(project: NowSdkProject): void;
+/** The ServiceNow SDK version installed in the project, or null when it is not installed. */
+export declare function readSdkVersion(root: string): string | null;
+/** Refuse SDK versions outside the range whose packages ScriptSync handles. */
+export declare function assertSupportedSdk(root: string): string;
+/**
+ * Flow and action record ids in the built app, for activating them after an
+ * install (the SDK's own post-install step). Read from the build output file
+ * names, which follow `<table>_<sys_id>.xml`.
+ */
+export declare function listFlowRecordIds(appOutputDir: string): {
+    flows: string[];
+    actions: string[];
+};
+/** The zip path reported by `now-sdk pack`, or null. */
+export declare function parsePackOutput(output: string): string | null;
+/** Newest `.zip` in a folder, used when the pack output could not be parsed. */
+export declare function findNewestZip(dir: string): string | null;
+/**
+ * The instance this project deploys to. Stored in `.snu/deploy.json` inside the
+ * project, next to a `.gitignore` that keeps the folder out of git: the link is
+ * a personal choice, not project configuration.
+ */
+export declare function readDeployLink(root: string): NowSdkDeployLink | null;
+export declare function writeDeployLink(root: string, link: NowSdkDeployLink): void;
+/** NOW SDK project roots under `root`, a few levels deep, skipping build and dependency folders. */
+export declare function findNowSdkProjects(root: string, maxDepth?: number): string[];
+/**
+ * The project an agent asked for. `projectPath` (relative to `root`, or
+ * absolute) must stay inside `root`, symlinks included. Without it, `root`
+ * must contain exactly one project.
+ */
+export declare function resolveNowSdkProjectRoot(root: string, projectPath?: string): string;
+//# sourceMappingURL=NowSdkProject.d.ts.map

package/dist/nowsdk/NowSdkProject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NowSdkProject.d.ts","sourceRoot":"","sources":["../../src/nowsdk/NowSdkProject.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,eAAe,oBAAoB,CAAC;AAIjD,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;CAC1B;AAED,+FAA+F;AAC/F,eAAO,MAAM,aAAa;;;CAAkC,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,qBAAa,kBAAmB,SAAQ,KAAK;CAAG;AAqBhD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYtF;AAoBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAwB7D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAWnE;AAOD,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO1D;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYvD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAgB9F;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7D;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBxD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAQpE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAM1E;AAID,oGAAoG;AACpG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,EAAE,CAsBvE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBnF"}

package/dist/nowsdk/NowSdkProject.js

@@ -0,0 +1,341 @@
+"use strict";
+// ServiceNow SDK (NOW SDK / Fluent) project support.
+//
+// A folder containing `now.config.json` is a NOW SDK project. Its sources
+// (`*.now.ts`, `src/server/**`) compile into an application package; they are
+// never ScriptSync field files, so the field sync must skip them entirely and
+// the app is deployed as a whole package instead (see NowSdkDeploy.ts).
+//
+// Kept free of `vscode` imports so it can be unit tested under plain Node.
+// packages/snu/src/nowsdk/ holds a byte-identical copy for the standalone
+// bridge; src/test/nowSdkShared.test.ts fails when the two drift.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NowSdkProjectError = exports.SUPPORTED_SDK = exports.NOW_CONFIG_FILE = void 0;
+exports.findNowSdkProjectRoot = findNowSdkProjectRoot;
+exports.readNowSdkProject = readNowSdkProject;
+exports.assertSupportedProject = assertSupportedProject;
+exports.readSdkVersion = readSdkVersion;
+exports.assertSupportedSdk = assertSupportedSdk;
+exports.listFlowRecordIds = listFlowRecordIds;
+exports.parsePackOutput = parsePackOutput;
+exports.findNewestZip = findNewestZip;
+exports.readDeployLink = readDeployLink;
+exports.writeDeployLink = writeDeployLink;
+exports.findNowSdkProjects = findNowSdkProjects;
+exports.resolveNowSdkProjectRoot = resolveNowSdkProjectRoot;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+exports.NOW_CONFIG_FILE = 'now.config.json';
+const LINK_DIR = '.snu';
+const LINK_FILE = 'deploy.json';
+/** ServiceNow SDK versions whose packages and install protocol match what ScriptSync sends. */
+exports.SUPPORTED_SDK = { min: '4.1.0', belowMajor: 5 };
+class NowSdkProjectError extends Error {
+}
+exports.NowSdkProjectError = NowSdkProjectError;
+// Directory -> "contains now.config.json", briefly cached because the field
+// sync asks for every saved and watched file.
+const CACHE_TTL_MS = 5000;
+const configCache = new Map();
+function dirHasNowConfig(dir) {
+    const cached = configCache.get(dir);
+    const now = Date.now();
+    if (cached && now - cached.at < CACHE_TTL_MS)
+        return cached.has;
+    let has = false;
+    try {
+        has = fs.statSync(path.join(dir, exports.NOW_CONFIG_FILE)).isFile();
+    }
+    catch {
+        has = false;
+    }
+    configCache.set(dir, { has, at: now });
+    return has;
+}
+/**
+ * The NOW SDK project root that contains `filePath`, or null. When `stopAt` is
+ * given, only directories from the file's folder up to and including `stopAt`
+ * are checked, so a project outside that folder never matches.
+ */
+function findNowSdkProjectRoot(filePath, stopAt) {
+    if (!filePath)
+        return null;
+    const limit = stopAt ? path.resolve(stopAt) : undefined;
+    let dir = path.dirname(path.resolve(filePath));
+    if (limit && dir !== limit && !dir.startsWith(limit + path.sep))
+        return null;
+    while (true) {
+        if (dirHasNowConfig(dir))
+            return dir;
+        if (limit && dir === limit)
+            return null;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+function readJson(file) {
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch (e) {
+        throw new NowSdkProjectError(`Could not read ${path.basename(file)}: ${e?.message || e}`);
+    }
+}
+/** Resolve a configured output folder, refusing anything outside the project. */
+function projectDir(root, configured, fallback) {
+    const rel = typeof configured === 'string' && configured.trim() ? configured.trim() : fallback;
+    const resolved = path.resolve(root, rel);
+    if (resolved !== root && !resolved.startsWith(root + path.sep)) {
+        throw new NowSdkProjectError(`Output folder "${rel}" is outside the project.`);
+    }
+    return resolved;
+}
+function readNowSdkProject(root) {
+    const resolvedRoot = path.resolve(root);
+    const config = readJson(path.join(resolvedRoot, exports.NOW_CONFIG_FILE));
+    const pkg = readJson(path.join(resolvedRoot, 'package.json'));
+    const scope = String(config?.scope || '');
+    const scopeId = String(config?.scopeId || '');
+    const version = String(pkg?.version || '');
+    if (!/^[a-z][a-z0-9_]{1,17}$/.test(scope))
+        throw new NowSdkProjectError(`Invalid scope "${scope}" in ${exports.NOW_CONFIG_FILE}.`);
+    if (!/^([0-9a-f]{32}|global)$/.test(scopeId))
+        throw new NowSdkProjectError(`Invalid scopeId "${scopeId}" in ${exports.NOW_CONFIG_FILE}.`);
+    if (!/^[0-9A-Za-z.+-]{1,32}$/.test(version))
+        throw new NowSdkProjectError(`Invalid or missing version in package.json.`);
+    return {
+        root: resolvedRoot,
+        name: String(config?.name || scope),
+        scope,
+        scopeId,
+        version,
+        appOutputDir: projectDir(resolvedRoot, config?.appOutputDir, path.join('dist', 'app')),
+        packOutputDir: projectDir(resolvedRoot, config?.packOutputDir, 'target'),
+        type: String(config?.type || 'package'),
+        installAs: String(config?.installAs || ''),
+        hasHostedPlugins: !!config?.hostedPlugins && Object.keys(config.hostedPlugins).length > 0,
+    };
+}
+/**
+ * Refuse app types ScriptSync does not deploy or pull the way the SDK does,
+ * with a pointer to `now-sdk install` / `now-sdk transform` for them.
+ */
+function assertSupportedProject(project) {
+    const fallback = 'Use the ServiceNow SDK itself (now-sdk install / now-sdk transform) for this app.';
+    if (project.type === 'configuration') {
+        throw new NowSdkProjectError(`${project.name} is a configuration project, which the SDK installs into an update set. That is not supported yet. ${fallback}`);
+    }
+    if (project.installAs === 'store' || project.hasHostedPlugins) {
+        throw new NowSdkProjectError(`${project.name} installs as a Store app (installAs "store" or hostedPlugins). That is not supported yet. ${fallback}`);
+    }
+    if (project.scope === 'global' || project.scopeId === 'global') {
+        throw new NowSdkProjectError(`${project.name} is a global-scope app. That is not supported yet. ${fallback}`);
+    }
+}
+function versionParts(version) {
+    const m = /^(\d+)\.(\d+)\.(\d+)/.exec(version || '');
+    return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
+}
+/** The ServiceNow SDK version installed in the project, or null when it is not installed. */
+function readSdkVersion(root) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(root, 'node_modules', '@servicenow', 'sdk', 'package.json'), 'utf8'));
+        return typeof pkg?.version === 'string' ? pkg.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Refuse SDK versions outside the range whose packages ScriptSync handles. */
+function assertSupportedSdk(root) {
+    const version = readSdkVersion(root);
+    if (!version) {
+        throw new NowSdkProjectError(`The ServiceNow SDK is not installed in ${path.basename(root)}. Run npm install in the project first.`);
+    }
+    const have = versionParts(version);
+    const min = versionParts(exports.SUPPORTED_SDK.min);
+    const tooOld = !have || have[0] < min[0] || (have[0] === min[0] && (have[1] < min[1] || (have[1] === min[1] && have[2] < min[2])));
+    if (tooOld || (have && have[0] >= exports.SUPPORTED_SDK.belowMajor)) {
+        throw new NowSdkProjectError(`${path.basename(root)} uses ServiceNow SDK ${version}; ScriptSync supports ${exports.SUPPORTED_SDK.min} up to ${exports.SUPPORTED_SDK.belowMajor - 1}.x. Use now-sdk install and now-sdk transform, or update the SDK in the project.`);
+    }
+    return version;
+}
+/**
+ * Flow and action record ids in the built app, for activating them after an
+ * install (the SDK's own post-install step). Read from the build output file
+ * names, which follow `<table>_<sys_id>.xml`.
+ */
+function listFlowRecordIds(appOutputDir) {
+    const flows = [];
+    const actions = [];
+    let files = [];
+    try {
+        files = fs.readdirSync(path.join(appOutputDir, 'update'));
+    }
+    catch {
+        return { flows, actions };
+    }
+    for (const f of files) {
+        let m = /^sys_hub_flow_([0-9a-f]{32})\.xml$/.exec(f);
+        if (m) {
+            flows.push(m[1]);
+            continue;
+        }
+        m = /^sys_hub_action_type_definition_([0-9a-f]{32})\.xml$/.exec(f);
+        if (m)
+            actions.push(m[1]);
+    }
+    return { flows, actions };
+}
+/** The zip path reported by `now-sdk pack`, or null. */
+function parsePackOutput(output) {
+    const m = /artifact emitted as "([^"]+\.zip)"/i.exec(output || '');
+    return m ? m[1] : null;
+}
+/** Newest `.zip` in a folder, used when the pack output could not be parsed. */
+function findNewestZip(dir) {
+    let newest = null;
+    let entries = [];
+    try {
+        entries = fs.readdirSync(dir);
+    }
+    catch {
+        return null;
+    }
+    for (const f of entries) {
+        if (!f.toLowerCase().endsWith('.zip'))
+            continue;
+        const full = path.join(dir, f);
+        try {
+            const mtime = fs.statSync(full).mtimeMs;
+            if (!newest || mtime > newest.mtime)
+                newest = { file: full, mtime };
+        }
+        catch { }
+    }
+    return newest ? newest.file : null;
+}
+/**
+ * The instance this project deploys to. Stored in `.snu/deploy.json` inside the
+ * project, next to a `.gitignore` that keeps the folder out of git: the link is
+ * a personal choice, not project configuration.
+ */
+function readDeployLink(root) {
+    try {
+        const link = JSON.parse(fs.readFileSync(path.join(root, LINK_DIR, LINK_FILE), 'utf8'));
+        if (link && typeof link.instance === 'string' && link.instance && typeof link.url === 'string' && /^https?:\/\//.test(link.url)) {
+            return { instance: link.instance, url: link.url };
+        }
+    }
+    catch { }
+    return null;
+}
+function writeDeployLink(root, link) {
+    const dir = path.join(root, LINK_DIR);
+    fs.mkdirSync(dir, { recursive: true });
+    const ignore = path.join(dir, '.gitignore');
+    if (!fs.existsSync(ignore))
+        fs.writeFileSync(ignore, '*\n');
+    fs.writeFileSync(path.join(dir, LINK_FILE), JSON.stringify({ instance: link.instance, url: link.url }, null, 2) + '\n');
+}
+const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'target', '.snu', '.vscode']);
+/** NOW SDK project roots under `root`, a few levels deep, skipping build and dependency folders. */
+function findNowSdkProjects(root, maxDepth = 3) {
+    const found = [];
+    const walk = (dir, depth) => {
+        if (dirHasNowConfig(dir)) {
+            found.push(dir);
+            return; // a project does not contain further projects
+        }
+        if (depth >= maxDepth)
+            return;
+        let entries = [];
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (e.isDirectory() && !e.isSymbolicLink() && !SKIP_DIRS.has(e.name) && !e.name.startsWith('.')) {
+                walk(path.join(dir, e.name), depth + 1);
+            }
+        }
+    };
+    walk(path.resolve(root), 0);
+    return found.sort();
+}
+/**
+ * The project an agent asked for. `projectPath` (relative to `root`, or
+ * absolute) must stay inside `root`, symlinks included. Without it, `root`
+ * must contain exactly one project.
+ */
+function resolveNowSdkProjectRoot(root, projectPath) {
+    const base = path.resolve(root);
+    let realBase = base;
+    try {
+        realBase = fs.realpathSync(base);
+    }
+    catch { }
+    if (projectPath) {
+        const target = path.resolve(base, projectPath);
+        const inside = (p, r) => p === r || p.startsWith(r + path.sep);
+        if (!inside(target, base))
+            throw new NowSdkProjectError(`projectPath must be inside ${base}.`);
+        let realTarget = target;
+        try {
+            realTarget = fs.realpathSync(target);
+        }
+        catch {
+            throw new NowSdkProjectError(`projectPath not found: ${projectPath}`);
+        }
+        if (!inside(realTarget, realBase))
+            throw new NowSdkProjectError(`projectPath must be inside ${base}.`);
+        const dir = fs.statSync(realTarget).isDirectory() ? realTarget : path.dirname(realTarget);
+        if (!dirHasNowConfig(dir))
+            throw new NowSdkProjectError(`No ${exports.NOW_CONFIG_FILE} in ${projectPath}.`);
+        return dir;
+    }
+    const projects = findNowSdkProjects(base);
+    if (projects.length === 1)
+        return projects[0];
+    if (projects.length === 0)
+        throw new NowSdkProjectError(`No NOW SDK project (${exports.NOW_CONFIG_FILE}) found under ${base}.`);
+    throw new NowSdkProjectError(`Several NOW SDK projects found; pass projectPath: ${projects.map((p) => path.relative(base, p) || '.').join(', ')}`);
+}
+//# sourceMappingURL=NowSdkProject.js.map