@snutils/snu 0.3.4 → 0.3.5

package/dist/nowsdk/NowSdkBuild.js

@@ -0,0 +1,152 @@
+"use strict";
+// Build, pack and deploy-message helpers for ServiceNow SDK (NOW SDK) projects,
+// shared by the "Deploy NOW SDK app" editor command and the `sdk_deploy` agent
+// command. The package itself is installed by the SN Utils helper tab
+// (deployAppPackage in scriptsync.js), which asks the user to confirm first.
+//
+// Kept free of `vscode` imports. 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.DEPLOY_TIMEOUT_MS = exports.CLI_TIMEOUT_MS = exports.MAX_PACKAGE_BYTES = void 0;
+exports.runNowSdk = runNowSdk;
+exports.buildNowSdkPackage = buildNowSdkPackage;
+exports.buildDeployMessage = buildDeployMessage;
+exports.summarizeDeployResult = summarizeDeployResult;
+const cp = __importStar(require("child_process"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const NowSdkProject_1 = require("./NowSdkProject");
+exports.MAX_PACKAGE_BYTES = 25 * 1024 * 1024;
+exports.CLI_TIMEOUT_MS = 5 * 60 * 1000;
+/** Covers the confirmation in the helper tab plus the install and flow activation. */
+exports.DEPLOY_TIMEOUT_MS = 15 * 60 * 1000;
+function localCli(root) {
+    const bin = path.join(root, 'node_modules', '.bin', process.platform === 'win32' ? 'now-sdk.cmd' : 'now-sdk');
+    if (!fs.existsSync(bin)) {
+        throw new NowSdkProject_1.NowSdkProjectError(`The ServiceNow SDK is not installed in ${path.basename(root)}. Run npm install in the project first.`);
+    }
+    return bin;
+}
+/** Run the project's own `now-sdk` with fixed arguments; resolves with its output. */
+function runNowSdk(root, args, onOutput) {
+    const bin = localCli(root);
+    return new Promise((resolve, reject) => {
+        onOutput?.(`> now-sdk ${args.join(' ')}\n`);
+        const isWin = process.platform === 'win32';
+        // .cmd shims can only be spawned through a shell on Windows; the
+        // arguments are fixed literals, never user input.
+        const child = cp.spawn(isWin ? `"${bin}"` : bin, args, { cwd: root, shell: isWin, env: process.env });
+        let out = '';
+        const timer = setTimeout(() => {
+            child.kill();
+            reject(new Error(`now-sdk ${args[0]} timed out after ${exports.CLI_TIMEOUT_MS / 1000}s`));
+        }, exports.CLI_TIMEOUT_MS);
+        const collect = (chunk) => {
+            const text = chunk.toString();
+            out += text;
+            onOutput?.(text);
+        };
+        child.stdout.on('data', collect);
+        child.stderr.on('data', collect);
+        child.on('error', (e) => { clearTimeout(timer); reject(e); });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            if (code === 0)
+                resolve(out);
+            else
+                reject(new Error(`now-sdk ${args[0]} failed (exit ${code}).${tail(out)}`));
+        });
+    });
+}
+function tail(output) {
+    const lines = output.trim().split(/\r?\n/).filter(Boolean).slice(-5);
+    return lines.length ? `\n${lines.join('\n')}` : '';
+}
+/** Build and pack the project and read the package for the helper tab. */
+async function buildNowSdkPackage(root, onOutput) {
+    const project = (0, NowSdkProject_1.readNowSdkProject)(root);
+    (0, NowSdkProject_1.assertSupportedProject)(project);
+    (0, NowSdkProject_1.assertSupportedSdk)(project.root);
+    await runNowSdk(project.root, ['build'], onOutput);
+    const packOut = await runNowSdk(project.root, ['pack'], onOutput);
+    const reported = (0, NowSdkProject_1.parsePackOutput)(packOut);
+    const zipPath = reported && fs.existsSync(reported) ? reported : (0, NowSdkProject_1.findNewestZip)(project.packOutputDir);
+    if (!zipPath)
+        throw new NowSdkProject_1.NowSdkProjectError(`No package found in ${project.packOutputDir} after now-sdk pack.`);
+    const zip = fs.readFileSync(zipPath);
+    if (zip.length > exports.MAX_PACKAGE_BYTES) {
+        throw new NowSdkProject_1.NowSdkProjectError(`Package is ${Math.round(zip.length / 1024 / 1024)} MB; the limit is ${exports.MAX_PACKAGE_BYTES / 1024 / 1024} MB.`);
+    }
+    const { flows, actions } = (0, NowSdkProject_1.listFlowRecordIds)(project.appOutputDir);
+    return { project, zipPath, sizeBytes: zip.length, packageBase64: zip.toString('base64'), flows, actions };
+}
+/**
+ * The `deployAppPackage` message for the helper tab. `initiatedBy` tells the
+ * tab whether a person started the deploy in the editor or an agent did; only
+ * editor deploys go through while agents are paused.
+ */
+function buildDeployMessage(requestId, pkg, instance, initiatedBy) {
+    return {
+        action: 'deployAppPackage',
+        agentRequestId: requestId,
+        appName: initiatedBy === 'editor' ? 'VS Code' : 'Agent',
+        initiatedBy,
+        instance: { name: instance.name, url: instance.url, g_ck: instance.g_ck },
+        app: { name: pkg.project.name, scope: pkg.project.scope, scopeId: pkg.project.scopeId, version: pkg.project.version },
+        fileName: path.basename(pkg.zipPath),
+        packageBase64: pkg.packageBase64,
+        flows: pkg.flows,
+        actions: pkg.actions,
+    };
+}
+/** Normalize the helper tab's `deployAppPackageResponse`. */
+function summarizeDeployResult(result) {
+    const flowActivation = result?.flowActivation ?? null;
+    const installed = result?.success === true;
+    const partial = installed && !!flowActivation && flowActivation.ok === false;
+    const outcome = { success: installed && !partial, installed, partial, flowActivation };
+    for (const key of ['code', 'error', 'reason', 'statusMessage', 'trackerUrl', 'rollbackUrl']) {
+        if (typeof result?.[key] === 'string' && result[key])
+            outcome[key] = result[key];
+    }
+    if (typeof result?.durationMs === 'number')
+        outcome.durationMs = result.durationMs;
+    if (!installed && !outcome.error)
+        outcome.error = 'Install failed';
+    return outcome;
+}
+//# sourceMappingURL=NowSdkBuild.js.map

package/dist/nowsdk/NowSdkBuild.js.map

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

package/dist/nowsdk/NowSdkFlows.d.ts

@@ -0,0 +1,99 @@
+import { NowSdkProject } from './NowSdkProject';
+import { NowSdkPackage } from './NowSdkBuild';
+import { InstanceChange } from './NowSdkPull';
+export declare class NowSdkFlowError extends Error {
+    code: string;
+    details?: any | undefined;
+    constructor(code: string, message: string, details?: any | undefined);
+}
+export interface NowSdkTransport {
+    instanceName: string;
+    instanceUrl: string;
+    /** The helper tab can download app packages (needed for pull and the change check). */
+    canDownload: boolean;
+    /** Download the app package; rejects with an error carrying `code` on failure. */
+    download(project: NowSdkProject): Promise<Buffer>;
+    /** Send the package to the helper tab and resolve with its raw deployAppPackageResponse. */
+    deploy(pkg: NowSdkPackage): Promise<any>;
+    log?(text: string): void;
+}
+/** "UI Page Todo Board (html; built from your UI source)" */
+export declare function describeChange(c: InstanceChange): string;
+/**
+ * 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.
+ */
+export declare function deployFlow(root: string, transport: NowSdkTransport, opts?: {
+    force?: boolean;
+}): Promise<{
+    baselineRecorded: boolean;
+    instanceChecked: boolean;
+    instanceOnly?: InstanceChange[] | undefined;
+    overwritten?: InstanceChange[] | undefined;
+    app: {
+        name: string;
+        scope: string;
+        version: string;
+    };
+    instance: string;
+    success: boolean;
+    installed: boolean;
+    partial: boolean;
+    code?: string;
+    error?: string;
+    reason?: string;
+    statusMessage?: string;
+    trackerUrl?: string;
+    rollbackUrl?: string;
+    flowActivation?: {
+        ok: boolean;
+        total?: number;
+        succeeded?: number;
+        failed?: number;
+        error?: string;
+    } | null;
+    durationMs?: number;
+}>;
+/**
+ * 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.
+ */
+export declare function pullFlow(root: string, transport: NowSdkTransport, opts?: {
+    force?: boolean;
+    dryRun?: boolean;
+}): Promise<{
+    applied: never[];
+    dryRun: boolean;
+    app: {
+        name: string;
+        scope: string;
+        version: string;
+    };
+    instance: string;
+    changes: {
+        path: string;
+        status: import("./NowSdkPull").PullChangeStatus;
+    }[];
+} | {
+    notPulled?: {
+        label: string;
+        status: "removed" | "changed" | "new";
+        reason: string | undefined;
+    }[] | undefined;
+    firstPull?: boolean | undefined;
+    notOnInstance?: string[] | undefined;
+    applied: string[];
+    upToDate: boolean;
+    app: {
+        name: string;
+        scope: string;
+        version: string;
+    };
+    instance: string;
+    changes: {
+        path: string;
+        status: import("./NowSdkPull").PullChangeStatus;
+    }[];
+}>;
+//# sourceMappingURL=NowSdkFlows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NowSdkFlows.d.ts","sourceRoot":"","sources":["../../src/nowsdk/NowSdkFlows.ts"],"names":[],"mappings":"AASA,OAAO,EACN,aAAa,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAgE,MAAM,eAAe,CAAC;AAC5G,OAAO,EACN,cAAc,EAEd,MAAM,cAAc,CAAC;AAEtB,qBAAa,eAAgB,SAAQ,KAAK;IACtB,IAAI,EAAE,MAAM;IAA0B,OAAO,CAAC,EAAE,GAAG;gBAAnD,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAS,OAAO,CAAC,EAAE,GAAG,YAAA;CAGtE;AAED,MAAM,WAAW,eAAe;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,WAAW,EAAE,OAAO,CAAC;IACrB,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,4FAA4F;IAC5F,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAcD,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAOxD;AAOD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO;;;;;;;;;;;;;;;;;;;;;;aA/B3E,CAAC;iBAAmB,CAAC;cAE3C,CAAC;aAAe,CAAC;;;GAsHxB;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DxH"}

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"}