@sonisoft/now-sdk-ext-core 6.6.3 → 6.8.0

package/dist/sn/metadata/MetadataModels.d.ts

@@ -0,0 +1,44 @@
+import type { FormWriteOptions } from '../../comm/http/FormRecordModels.js';
+/** Global must be requested explicitly. Named scopes resolve to one active application. */
+export type MetadataScopeRef = {
+    sysId: string;
+} | {
+    scope: string;
+} | 'global';
+export interface MetadataWriteOptions extends FormWriteOptions {
+    scope: MetadataScopeRef;
+    updateSet?: string;
+    allowMixedScopeCapture?: boolean;
+}
+export interface MetadataDeleteOptions extends Omit<MetadataWriteOptions, 'fields' | 'variables' | 'initialQuery'> {
+    confirm: {
+        table: string;
+        sysId: string;
+    };
+}
+export interface CaptureReport {
+    updateSetSysId: string;
+    updateSetName: string;
+    updateSetScope: string;
+    predictedUpdateSetSysId?: string;
+    recordScope: string;
+    action: string;
+    preferencesUnchanged: boolean;
+    preferenceRowsReplaced: string[];
+    currentUpdateSet: {
+        before?: string;
+        after?: string;
+        switched: boolean;
+    };
+}
+export interface MetadataWriteResult {
+    table: string;
+    sysId: string;
+    action: 'insert' | 'update' | 'delete';
+    scope: {
+        sysId: string;
+        scope: string;
+    };
+    capture: CaptureReport;
+    messages: string[];
+}

package/dist/sn/metadata/MetadataModels.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=MetadataModels.js.map

package/dist/sn/metadata/MetadataModels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataModels.js","sourceRoot":"","sources":["../../../src/sn/metadata/MetadataModels.ts"],"names":[],"mappings":""}

package/dist/sn/metadata/MetadataScopeError.d.ts

@@ -0,0 +1,5 @@
+/** A refusal before the form POST. Messages contain codes, never caller values. */
+export declare class MetadataScopeError extends Error {
+    readonly code: 'scope_required' | 'scope_unknown' | 'scope_ambiguous' | 'scope_mismatch' | 'scope_not_applied' | 'store_scope' | 'table_not_supported' | 'field_not_supported' | 'delete_not_supported' | 'not_permitted' | 'csrf_token_unavailable' | 'invalid_input' | 'evidence_unavailable';
+    constructor(code: 'scope_required' | 'scope_unknown' | 'scope_ambiguous' | 'scope_mismatch' | 'scope_not_applied' | 'store_scope' | 'table_not_supported' | 'field_not_supported' | 'delete_not_supported' | 'not_permitted' | 'csrf_token_unavailable' | 'invalid_input' | 'evidence_unavailable');
+}

package/dist/sn/metadata/MetadataScopeError.js

@@ -0,0 +1,10 @@
+/** A refusal before the form POST. Messages contain codes, never caller values. */
+export class MetadataScopeError extends Error {
+    code;
+    constructor(code) {
+        super(`Metadata write refused: ${code}`);
+        this.code = code;
+        this.name = 'MetadataScopeError';
+    }
+}
+//# sourceMappingURL=MetadataScopeError.js.map

package/dist/sn/metadata/MetadataScopeError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataScopeError.js","sourceRoot":"","sources":["../../../src/sn/metadata/MetadataScopeError.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACN;IAAnC,YAAmC,IAGS;QACxC,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;QAJV,SAAI,GAAJ,IAAI,CAGK;QAExC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACrC,CAAC;CACJ"}

package/dist/sn/metadata/MetadataVerificationError.d.ts

@@ -0,0 +1,11 @@
+import type { CaptureReport } from './MetadataModels.js';
+/** A submit was attempted. Read the evidence before deciding how to clean up. Never replay automatically. */
+export declare class MetadataVerificationError extends Error {
+    readonly code: 'scope_not_applied' | 'not_captured' | 'captured_elsewhere' | 'mixed_scope_capture' | 'session_changed' | 'delete_not_applied' | 'delete_not_captured' | 'write_not_applied' | 'verification_unavailable' | 'csrf_rejected';
+    readonly table: string;
+    readonly sysId: string;
+    readonly capture?: Partial<CaptureReport>;
+    readonly messages: string[];
+    readonly writeAttempted: boolean;
+    constructor(code: 'scope_not_applied' | 'not_captured' | 'captured_elsewhere' | 'mixed_scope_capture' | 'session_changed' | 'delete_not_applied' | 'delete_not_captured' | 'write_not_applied' | 'verification_unavailable' | 'csrf_rejected', table: string, sysId: string, capture?: Partial<CaptureReport>, messages?: string[], writeAttempted?: boolean);
+}

package/dist/sn/metadata/MetadataVerificationError.js

@@ -0,0 +1,20 @@
+/** A submit was attempted. Read the evidence before deciding how to clean up. Never replay automatically. */
+export class MetadataVerificationError extends Error {
+    code;
+    table;
+    sysId;
+    capture;
+    messages;
+    writeAttempted;
+    constructor(code, table, sysId, capture, messages = [], writeAttempted = true) {
+        super(`Metadata submit verification failed: ${code}`);
+        this.code = code;
+        this.table = table;
+        this.sysId = sysId;
+        this.capture = capture;
+        this.messages = messages;
+        this.writeAttempted = writeAttempted;
+        this.name = 'MetadataVerificationError';
+    }
+}
+//# sourceMappingURL=MetadataVerificationError.js.map

package/dist/sn/metadata/MetadataVerificationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataVerificationError.js","sourceRoot":"","sources":["../../../src/sn/metadata/MetadataVerificationError.ts"],"names":[],"mappings":"AACA,6GAA6G;AAC7G,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACb;IAGf;IAA+B;IAC/B;IAAkD;IAAyC;IAJ/G,YAAmC,IAEmC,EAClD,KAAa,EAAkB,KAAa,EAC5C,OAAgC,EAAkB,WAAqB,EAAE,EAAkB,iBAAiB,IAAI;QAChI,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;QALvB,SAAI,GAAJ,IAAI,CAE+B;QAClD,UAAK,GAAL,KAAK,CAAQ;QAAkB,UAAK,GAAL,KAAK,CAAQ;QAC5C,YAAO,GAAP,OAAO,CAAyB;QAAkB,aAAQ,GAAR,QAAQ,CAAe;QAAkB,mBAAc,GAAd,cAAc,CAAO;QAEhI,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC5C,CAAC;CACJ"}

package/dist/sn/metadata/internal/MetadataPreferences.d.ts

@@ -0,0 +1,12 @@
+import type { MetadataRow } from './MetadataReader.js';
+export declare function preferenceValue(rows: MetadataRow[], name: string): string | undefined;
+export declare function comparePreferences(before: MetadataRow[], after: MetadataRow[], expectedSet?: string | string[]): {
+    valid: boolean;
+    unchanged: boolean;
+    replaced: string[];
+    currentUpdateSet: {
+        before: string;
+        after: string;
+        switched: boolean;
+    };
+};

package/dist/sn/metadata/internal/MetadataPreferences.js

@@ -0,0 +1,27 @@
+import { MetadataScopeError } from '../MetadataScopeError.js';
+export function preferenceValue(rows, name) {
+    const values = [...new Set(rows.filter(row => row.name === name).map(row => row.value))];
+    if (values.length > 1)
+        throw new MetadataScopeError('evidence_unavailable');
+    return values[0];
+}
+function multiset(rows) {
+    return rows.map(row => JSON.stringify([row.name, row.value])).sort();
+}
+export function comparePreferences(before, after, expectedSet) {
+    const oldSet = preferenceValue(before, 'sys_update_set');
+    const newSet = preferenceValue(after, 'sys_update_set');
+    const switched = oldSet !== newSet;
+    const unchanged = JSON.stringify(multiset(before)) === JSON.stringify(multiset(after));
+    const destinations = Array.isArray(expectedSet) ? expectedSet : [expectedSet];
+    const allowed = switched && !!newSet && destinations.includes(newSet) &&
+        before.filter(row => row.name === 'sys_update_set').length === 1 &&
+        after.filter(row => row.name === 'sys_update_set').length === 1;
+    const remaining = (rows) => allowed ? rows.filter(row => row.name !== 'sys_update_set') : rows;
+    const valid = JSON.stringify(multiset(remaining(before))) === JSON.stringify(multiset(remaining(after)));
+    const oldIds = new Set(before.map(row => JSON.stringify([row.sys_id, row.name, row.value])));
+    const replaced = [...new Set(after.filter(row => !oldIds.has(JSON.stringify([row.sys_id, row.name, row.value])) &&
+            before.some(old => old.name === row.name && old.value === row.value)).map(row => row.name))].sort();
+    return { valid, unchanged, replaced, currentUpdateSet: { before: oldSet, after: newSet, switched } };
+}
+//# sourceMappingURL=MetadataPreferences.js.map

package/dist/sn/metadata/internal/MetadataPreferences.js.map

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

package/dist/sn/metadata/internal/MetadataReader.d.ts

@@ -0,0 +1,9 @@
+import type { ServiceNowRequest } from '../../../comm/http/ServiceNowRequest.js';
+export type MetadataRow = Record<string, string>;
+/** Read-only, bounded pagination on the same authenticated request as the forms. */
+export declare class MetadataReader {
+    private _request;
+    constructor(_request: ServiceNowRequest);
+    rows(table: string, query: string, fields: string): Promise<MetadataRow[]>;
+    exact(table: string, sysId: string, fields: string): Promise<MetadataRow | undefined>;
+}

package/dist/sn/metadata/internal/MetadataReader.js

@@ -0,0 +1,55 @@
+import { READ_ONLY } from '../../../policy/PolicyTypes.js';
+import { MetadataScopeError } from '../MetadataScopeError.js';
+/** Read-only, bounded pagination on the same authenticated request as the forms. */
+export class MetadataReader {
+    _request;
+    constructor(_request) {
+        this._request = _request;
+    }
+    async rows(table, query, fields) {
+        const result = [];
+        const ids = new Set();
+        let expectedCount;
+        for (let page = 0; page < 100; page++) {
+            const response = await this._request.get({ path: `/api/now/table/${table}`,
+                headers: { Accept: 'application/json' }, body: null, requires: READ_ONLY, sensitive: true,
+                query: { sysparm_query: `${query}^ORDERBYsys_id`, sysparm_fields: fields,
+                    sysparm_display_value: 'false', sysparm_exclude_reference_link: 'true', sysparm_no_count: 'false',
+                    sysparm_limit: '200', sysparm_offset: String(page * 200) } });
+            const rows = response.bodyObject?.result;
+            if (response.status !== 200 || !Array.isArray(rows) || rows.length > 200)
+                throw new MetadataScopeError('evidence_unavailable');
+            const countHeader = response.headers?.['x-total-count'];
+            const count = Number(countHeader);
+            if (countHeader === undefined || !Number.isSafeInteger(count) || count < 0 || count > 20000 ||
+                (expectedCount !== undefined && expectedCount !== count))
+                throw new MetadataScopeError('evidence_unavailable');
+            expectedCount = count;
+            for (const value of rows) {
+                if (!value || typeof value !== 'object')
+                    throw new MetadataScopeError('evidence_unavailable');
+                const row = value;
+                if (typeof row.sys_id !== 'string' || !row.sys_id || ids.has(row.sys_id) ||
+                    fields.split(',').some(field => typeof row[field] !== 'string'))
+                    throw new MetadataScopeError('evidence_unavailable');
+                ids.add(row.sys_id);
+                result.push(row);
+            }
+            if (result.length > expectedCount)
+                throw new MetadataScopeError('evidence_unavailable');
+            if (rows.length < 200) {
+                if (result.length !== expectedCount)
+                    throw new MetadataScopeError('evidence_unavailable');
+                return result;
+            }
+        }
+        throw new MetadataScopeError('evidence_unavailable');
+    }
+    async exact(table, sysId, fields) {
+        const rows = await this.rows(table, `sys_id=${sysId}`, `sys_id,${fields}`);
+        if (rows.some(row => row.sys_id !== sysId) || rows.length > 1)
+            throw new MetadataScopeError('evidence_unavailable');
+        return rows[0];
+    }
+}
+//# sourceMappingURL=MetadataReader.js.map

package/dist/sn/metadata/internal/MetadataReader.js.map

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

package/dist/sn/variables/VariableDefinitions.d.ts

@@ -0,0 +1,23 @@
+import { ServiceNowInstance } from "../ServiceNowInstance.js";
+import { ListVariableDefinitionsOptions, VariableDefinition } from "./VariableModels.js";
+/**
+ * Reads variable definitions (`var_dictionary`) for a variable model, e.g. the variables
+ * a workflow activity type exposes (`var__m_<activity definition sys_id>`).
+ *
+ * Layout-only elements (names starting with `.`, such as `.begin_split`) are skipped:
+ * they never hold a value. Results are cached per model and language for the lifetime
+ * of the instance object.
+ */
+export declare class VariableDefinitions {
+    private _tableAPI;
+    private _cache;
+    constructor(instance: ServiceNowInstance);
+    /**
+     * List the variables in a model, in display order.
+     *
+     * @param model Variable model table name, e.g. `var__m_3961a1da0a0a0b5c00ecd84822f70d85`
+     */
+    list(model: string, options?: ListVariableDefinitionsOptions): Promise<VariableDefinition[]>;
+    private load;
+    private read;
+}

package/dist/sn/variables/VariableDefinitions.js

@@ -0,0 +1,106 @@
+import { TableAPIRequest } from "../../comm/http/TableAPIRequest.js";
+import { InvalidParameterException } from "../../exception/InvalidParameterException.js";
+const MODEL = /^var__m_[a-z0-9_]+$/i;
+const DEFINITION_FIELDS = [
+    "sys_id", "name", "element", "column_label", "internal_type", "default_value", "reference",
+    "mandatory", "order", "hint", "choice", "active",
+].join(",");
+/**
+ * Reads variable definitions (`var_dictionary`) for a variable model, e.g. the variables
+ * a workflow activity type exposes (`var__m_<activity definition sys_id>`).
+ *
+ * Layout-only elements (names starting with `.`, such as `.begin_split`) are skipped:
+ * they never hold a value. Results are cached per model and language for the lifetime
+ * of the instance object.
+ */
+export class VariableDefinitions {
+    _tableAPI;
+    _cache = new Map();
+    constructor(instance) {
+        this._tableAPI = new TableAPIRequest(instance);
+    }
+    /**
+     * List the variables in a model, in display order.
+     *
+     * @param model Variable model table name, e.g. `var__m_3961a1da0a0a0b5c00ecd84822f70d85`
+     */
+    async list(model, options = {}) {
+        if (!MODEL.test(model ?? "")) {
+            throw new InvalidParameterException(`Invalid variable model name '${model}'`);
+        }
+        const language = options.language ?? "en";
+        if (!/^[a-z]{2}(_[a-z]{2})?$/i.test(language)) {
+            throw new InvalidParameterException(`Invalid language '${language}'`);
+        }
+        const key = `${model}|${language}|${options.includeInactive ? 1 : 0}`;
+        if (!this._cache.has(key)) {
+            const pending = this.load(model, language, !!options.includeInactive);
+            this._cache.set(key, pending);
+            pending.catch(() => this._cache.delete(key));
+        }
+        return this._cache.get(key);
+    }
+    async load(model, language, includeInactive) {
+        const active = includeInactive ? "" : "^active=true";
+        const rows = await this.read("var_dictionary", `name=${model}${active}^ORDERBYorder`, DEFINITION_FIELDS);
+        const definitions = rows
+            .filter(row => !str(row.element).startsWith("."))
+            .map(row => toDefinition(row, model));
+        if (definitions.some(d => d.choices)) {
+            const choices = await this.read("sys_choice", `name=${model}^language=${language}^inactive=false^ORDERBYsequence`, "element,value,label,sequence");
+            for (const definition of definitions) {
+                if (!definition.choices)
+                    continue;
+                definition.choices = choices
+                    .filter(c => str(c.element) === definition.element)
+                    .map((c) => ({ value: str(c.value) === "NULL_OVERRIDE" ? "" : str(c.value), label: str(c.label) }));
+                // Reference variables can carry a choice flag with no choice rows.
+                if (!definition.choices.length)
+                    delete definition.choices;
+            }
+        }
+        return definitions;
+    }
+    async read(table, query, fields) {
+        const params = { sysparm_query: query, sysparm_fields: fields, sysparm_limit: "1000", sysparm_exclude_reference_link: "true" };
+        let response = await this._tableAPI.get(table, params);
+        // 202: the instance queued the request behind others in this session; ask again.
+        for (let attempt = 1; response?.status === 202 && attempt <= 3; attempt++) {
+            await new Promise(resolve => setTimeout(resolve, 500 * attempt));
+            response = await this._tableAPI.get(table, params);
+        }
+        if (response?.status !== 200 || !Array.isArray(response.bodyObject?.result)) {
+            throw new Error(`Failed to read ${table}. Status: ${response?.status ?? "unknown"}`);
+        }
+        return response.bodyObject.result;
+    }
+}
+function toDefinition(row, model) {
+    const definition = {
+        sysId: str(row.sys_id),
+        model,
+        element: str(row.element),
+        label: str(row.column_label),
+        internalType: str(row.internal_type),
+        defaultValue: str(row.default_value),
+        mandatory: str(row.mandatory) === "true",
+        order: Number(str(row.order)) || 0,
+    };
+    if (str(row.reference))
+        definition.reference = str(row.reference);
+    if (str(row.hint))
+        definition.hint = str(row.hint);
+    if (str(row.choice) !== "" && str(row.choice) !== "0")
+        definition.choices = [];
+    return definition;
+}
+function str(value) {
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    if (value && typeof value === "object" && "value" in value)
+        return str(value.value);
+    return "";
+}
+//# sourceMappingURL=VariableDefinitions.js.map

package/dist/sn/variables/VariableDefinitions.js.map

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

package/dist/sn/variables/VariableModels.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Models for variable (glide_var) definitions — the `var_dictionary` rows that describe
+ * the variables a record such as a workflow activity carries.
+ */
+/**
+ * One choice offered by a choice variable.
+ */
+export interface VariableChoice {
+    /** Stored value. The platform's NULL_OVERRIDE ("none") choice is reported as an empty string, which is what it stores. */
+    value: string;
+    /** Display label */
+    label: string;
+}
+/**
+ * Definition of one variable in a variable model.
+ */
+export interface VariableDefinition {
+    /** sys_id of the var_dictionary row (what `sys_variable_value.variable` references) */
+    sysId: string;
+    /** Variable model table name, e.g. `var__m_<activity definition sys_id>` */
+    model: string;
+    /** Element name — the key used when reading or writing the variable */
+    element: string;
+    /** Label shown on the form */
+    label: string;
+    /** Internal type, e.g. `string`, `script`, `boolean`, `glide_duration`, `reference`, `glide_list`, `conditions` */
+    internalType: string;
+    /** Default value, verbatim (may be a `javascript:` expression evaluated by the form) */
+    defaultValue: string;
+    /** Referenced table, for reference and glide_list variables */
+    reference?: string;
+    /** Whether the variable is mandatory */
+    mandatory: boolean;
+    /** Display order */
+    order: number;
+    /** Help text */
+    hint?: string;
+    /** Choices, for choice variables */
+    choices?: VariableChoice[];
+}
+/**
+ * Options for listing variable definitions.
+ */
+export interface ListVariableDefinitionsOptions {
+    /** Choice label language. Defaults to `en`. */
+    language?: string;
+    /** Include inactive variables. Defaults to false. */
+    includeInactive?: boolean;
+}

package/dist/sn/variables/VariableModels.js

@@ -0,0 +1,6 @@
+/**
+ * Models for variable (glide_var) definitions — the `var_dictionary` rows that describe
+ * the variables a record such as a workflow activity carries.
+ */
+export {};
+//# sourceMappingURL=VariableModels.js.map

package/dist/sn/variables/VariableModels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariableModels.js","sourceRoot":"","sources":["../../../src/sn/variables/VariableModels.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/sn/workflow/WorkflowConversionModels.d.ts

@@ -0,0 +1,209 @@
+import { WorkflowExport } from "./WorkflowModels.js";
+/**
+ * Models for planning the move of a legacy workflow to Flow Designer.
+ */
+/** How completely a step carries over. */
+export type FlowPlanConfidence = 'direct' | 'partial' | 'manual';
+/** A value for a Flow Designer action input. */
+export type FlowPlanValue = {
+    kind: 'literal';
+    value: string | number | boolean;
+}
+/** A data pill: `expr` is a Fluent expression such as `params.trigger.request_item.requested_for.manager` */
+ | {
+    kind: 'pill';
+    expr: string;
+    type: string;
+}
+/** Text mixing literals and data pills, e.g. a subject line */
+ | {
+    kind: 'text';
+    parts: Array<string | {
+        expr: string;
+        type: string;
+    }>;
+}
+/** A field map (`TemplateValue({...})`) */
+ | {
+    kind: 'template';
+    fields: Record<string, FlowPlanValue>;
+}
+/** Approval rules (`wfa.approvalRules({...})`) */
+ | {
+    kind: 'approvalRules';
+    ruleType: 'Any' | 'All' | 'Res';
+    action: 'Approves' | 'Rejects' | 'ApprovesRejects';
+    users: FlowPlanValue[];
+    groups: FlowPlanValue[];
+}
+/** A duration (`Duration({...})`) */
+ | {
+    kind: 'duration';
+    seconds: number;
+}
+/** A list of values */
+ | {
+    kind: 'list';
+    items: FlowPlanValue[];
+};
+/** A flow condition: an encoded query whose fields may be data pills. */
+export interface FlowPlanCondition {
+    /** The condition as a Fluent template literal body, e.g. `${wfa.dataPill(x, "string")}=1` — empty when it could not be derived */
+    expression: string;
+    /** The legacy condition or exit it came from */
+    source: string;
+    /** False when the condition has to be written by hand */
+    derived: boolean;
+}
+/** Where a planned step came from. */
+export interface FlowPlanSource {
+    activity: string;
+    name: string;
+    type: string;
+    /** Step number in the workflow outline */
+    number: number;
+}
+/** A node of the planned flow body. */
+export type FlowPlanNode = {
+    kind: 'action';
+    id: string;
+    source: FlowPlanSource;
+    /** Fluent action, e.g. `action.core.askForApproval` */
+    action: string;
+    label: string;
+    inputs: Record<string, FlowPlanValue>;
+    /** Variable name the action's outputs are captured in, when later steps use them */
+    output?: string;
+    confidence: FlowPlanConfidence;
+    notes: string[];
+    stage?: string;
+    waits: boolean;
+} | {
+    kind: 'waitForADuration';
+    id: string;
+    source: FlowPlanSource;
+    seconds: number;
+    confidence: FlowPlanConfidence;
+    notes: string[];
+} | {
+    kind: 'if';
+    id: string;
+    source: FlowPlanSource;
+    /** if, then elseIf… in order */
+    branches: Array<{
+        label: string;
+        condition: FlowPlanCondition;
+        body: FlowPlanNode[];
+    }>;
+    /** else, when present */
+    otherwise?: {
+        label: string;
+        body: FlowPlanNode[];
+    };
+    confidence: FlowPlanConfidence;
+    notes: string[];
+} | {
+    kind: 'parallel';
+    id: string;
+    source: FlowPlanSource;
+    lanes: FlowPlanNode[][];
+    notes: string[];
+} | {
+    /** Set flow variables (a script that only wrote workflow.scratchpad keys) */
+    kind: 'setFlowVariables';
+    id: string;
+    source: FlowPlanSource;
+    values: Record<string, FlowPlanValue>;
+    notes: string[];
+} | {
+    kind: 'endFlow';
+    id: string;
+    source: FlowPlanSource;
+} | {
+    /** A step that has to be designed by hand: a script, a loop, a goto, a spoke, … */
+    kind: 'todo';
+    id: string;
+    source: FlowPlanSource;
+    reason: string;
+    /** Legacy detail to work from (script body, inputs, condition) */
+    detail?: string;
+    /** Set when the path continues at a step the flow already has elsewhere (a goto): that step's activity sys_id */
+    continueAt?: string;
+};
+/** The trigger of the planned flow, or the inputs of a planned subflow. */
+export interface FlowPlanTrigger {
+    /** `serviceCatalog` for catalog item workflows, `record` for table workflows, `subflow` when nothing triggers it */
+    kind: 'serviceCatalog' | 'record' | 'subflow';
+    table: string;
+    /** Record trigger: created or created-or-updated, and its condition */
+    recordEvent?: 'created' | 'createdOrUpdated';
+    condition?: string;
+    /** Catalog items whose workflow this is (the flow is bound to them, not to its trigger) */
+    catalogItems: Array<{
+        sysId: string;
+        name: string;
+    }>;
+    /** Subflow inputs, from the workflow's inputs */
+    inputs: Array<{
+        name: string;
+        label: string;
+        type: string;
+        mandatory: boolean;
+    }>;
+    /** Fluent expression for the record the workflow ran on */
+    recordPill: string;
+    notes: string[];
+}
+/** A decision the conversion leaves to a person (or agent). */
+export interface FlowPlanDecision {
+    topic: 'script' | 'loop' | 'goto' | 'catalogVariable' | 'spoke' | 'subflow' | 'stage' | 'trigger' | 'mergeWithoutJoin' | 'deadExit' | 'unreachable' | 'approval' | 'task' | 'other';
+    detail: string;
+    /** Activities involved (sys_ids) */
+    activities: string[];
+}
+/**
+ * A plan for rebuilding a legacy workflow in Flow Designer: the trigger, flow variables
+ * from the scratchpad, a flow-shaped body mapped step by step, and the decisions that
+ * need a person.
+ */
+export interface FlowConversionPlan {
+    format: 'now-sdk-ext/flow-conversion-plan@1';
+    source: {
+        workflowSysId: string;
+        versionSysId: string;
+        name: string;
+        table: string;
+    };
+    kind: 'flow' | 'subflow';
+    /** Suggested flow name and a code-safe identifier */
+    name: string;
+    identifier: string;
+    trigger: FlowPlanTrigger;
+    /** workflow.scratchpad keys used across steps become flow variables */
+    flowVariables: Array<{
+        name: string;
+        type: 'string' | 'boolean' | 'integer';
+        setBy: string[];
+        usedBy: string[];
+    }>;
+    steps: FlowPlanNode[];
+    openDecisions: FlowPlanDecision[];
+    /** How many activities map directly, partly, or need design work */
+    coverage: {
+        direct: number;
+        partial: number;
+        manual: number;
+    };
+}
+/** One generated source file. */
+export interface FluentSourceFile {
+    /** Suggested path inside a now-sdk app, e.g. `src/fluent/flows/laptop-request.now.ts` */
+    path: string;
+    content: string;
+}
+/** A workflow version's move to Flow Designer: its export, the plan and the Fluent skeleton. */
+export interface WorkflowFlowConversion {
+    export: WorkflowExport;
+    plan: FlowConversionPlan;
+    files: FluentSourceFile[];
+}

package/dist/sn/workflow/WorkflowConversionModels.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=WorkflowConversionModels.js.map