/netsuite-suitescript-upgrade

/netsuite-suitescript-upgrade analyze [file-path]     # Assess migration complexity for SS1.0/2.0/2.x
/netsuite-suitescript-upgrade convert [file-path]     # Convert SS1.0/2.0/2.x → SS2.1
/netsuite-suitescript-upgrade explain [api-or-concept] # Deep dive into a mapping
/netsuite-suitescript-upgrade validate [file-path]    # Check converted script

{
  "permissions": {
    "allow": [
      "Skill(netsuite-suitescript-upgrade)",
      "Skill(netsuite-sdf-leading-practices)",
      "Skill(netsuite-suitescript-reference)"
    ]
  }
}

1. Scan for @NApiVersion annotation
   → If "1.0": CONFIRMED SS1.0
   → If "2.0" or "2.x": SS2.0/SS2.x input; upgrade to SS2.1 is required
   → If "2.1": Already SS2.1

2. If no @NApiVersion found:
   → Scan for define() or require() wrapper
     → If absent: Likely SS1.0
   → Scan for nlapi*/nlobj* function calls
     → If present: CONFIRMED SS1.0
   → Scan for @NScriptType annotation
     → If absent: Likely SS1.0

3. Count indicators to determine confidence level

/netsuite-suitescript-upgrade [mode] [target] [options]

Modes:
  analyze   - Assess a SS1.0, SS2.0, or SS2.x script's migration complexity
  convert   - Convert a SS1.0, SS2.0, or SS2.x script to SS2.1
  explain   - Explain a specific API mapping or migration concept
  validate  - Check a converted SS2.1 script for leftover issues

Target:
  - File path for analyze/convert/validate mode
  - API name, object name, or concept for explain mode

Options:
  --dry-run    Show what would change without writing files (convert mode)
  --annotated  Include numbered change annotations in output (convert mode)
  --verbose    Include detailed migration notes in reports (all modes)

/netsuite-suitescript-upgrade analyze /SuiteScripts/my_ue.js
/netsuite-suitescript-upgrade convert /SuiteScripts/my_ue.js
/netsuite-suitescript-upgrade convert /SuiteScripts/my_ue.js --annotated
/netsuite-suitescript-upgrade explain nlapiSearchRecord
/netsuite-suitescript-upgrade explain nlobjRecord
/netsuite-suitescript-upgrade explain indexing
/netsuite-suitescript-upgrade explain error-handling
/netsuite-suitescript-upgrade validate /SuiteScripts/my_ue_v2.js

undefined

---

undefined

/**
 * @NApiVersion 2.1
 * @NScriptType [ScriptType]
 */
define(['N/record', 'N/search', 'N/log'], (record, search, log) => {
    // ... converted code ...
    return { /* entry points */ };
});

<!-- Remove these lines: -->
<beforeloadfunction>beforeLoad</beforeloadfunction>
<beforesubmitfunction>beforeSubmit</beforesubmitfunction>
<aftersubmitfunction>afterSubmit</aftersubmitfunction>

undefined

const rec = record.load({          // [3] nlapiLoadRecord → record.load
    type: record.Type.SALES_ORDER, // [4] String type → record.Type enum
    id: orderId,
    isDynamic: false
});

for (let i = 0; i < lineCount; i++) {  // [7] 1-based → 0-based indexing
    const qty = rec.getSublistValue({   // [8] getLineItemValue → getSublistValue
        sublistId: 'item',
        fieldId: 'quantity',
        line: i                         // [9] Was: line i+1 (1-based)
    });
}

undefined

nlapiSearchRecord(type, id, filters, columns)

const results = search.create({
    type: search.Type.SALES_ORDER,
    filters: [...],
    columns: [...]
}).run();

results.each((result) => {
    // process result
    return true; // continue
});

**For nlobj\* Objects:**
```markdown

// SS1.0
var rec = nlapiLoadRecord('salesorder', 123);
var entity = rec.getFieldValue('entity');

// SS2.1
const rec = record.load({ type: record.Type.SALES_ORDER, id: 123 });
const entity = rec.getValue({ fieldId: 'entity' });

**For Concepts:**
```markdown

[Before code]

[After code]

---

undefined

---

// SS1.0
var results = nlapiSearchRecord('salesorder', null,
    [new nlobjSearchFilter('status', null, 'is', 'SalesOrd:B')],
    [new nlobjSearchColumn('entity'), new nlobjSearchColumn('total')]
);
if (results) {
    for (var i = 0; i < results.length; i++) {
        var entity = results[i].getValue('entity');
    }
}

// SS2.1
const resultSet = search.create({
    type: search.Type.SALES_ORDER,
    filters: [['status', 'is', 'SalesOrd:B']],
    columns: ['entity', 'total']
}).run();

resultSet.each((result) => {
    const entity = result.getValue({ name: 'entity' });
    return true; // continue iteration; return false to stop
});

// SS1.0
var rec = nlapiLoadRecord('customer', 456);

// SS2.1
const rec = record.load({
    type: record.Type.CUSTOMER,
    id: 456,
    isDynamic: false  // optional, defaults to false
});

// SS1.0
var id = nlapiSubmitRecord(rec, true, false);

// SS2.1
const id = rec.save({
    enableSourcing: true,
    ignoreMandatoryFields: false
});

// SS1.0
var val = nlapiGetFieldValue('entity');
nlapiSetFieldValue('memo', 'Updated', true, false);

// SS2.1 (Client Script)
const val = currentRecord.getValue({ fieldId: 'entity' });
currentRecord.setValue({
    fieldId: 'memo',
    value: 'Updated',
    ignoreFieldChange: false  // NOTE: inverted logic from firefieldchanged!
});

// SS1.0 (User Event — beforeSubmit)
var rec = nlapiGetNewRecord();
var entity = rec.getFieldValue('entity');
rec.setFieldValue('memo', 'Updated');

// SS2.1 (User Event — beforeSubmit)
const rec = context.newRecord;
const entity = rec.getValue({ fieldId: 'entity' });
rec.setValue({ fieldId: 'memo', value: 'Updated' });

// SS1.0
var rec = nlapiCreateRecord('salesorder', {entity: 123});

// SS2.1
const rec = record.create({
    type: record.Type.SALES_ORDER,
    isDynamic: true,
    defaultValues: { entity: 123 }
});

// SS1.0 — 1-based indexing
for (var i = 1; i <= nlapiGetLineItemCount('item'); i++) {
    var qty = nlapiGetLineItemValue('item', 'quantity', i);
}

// SS2.1 — 0-based indexing
const lineCount = rec.getLineCount({ sublistId: 'item' });
for (let i = 0; i < lineCount; i++) {
    const qty = rec.getSublistValue({
        sublistId: 'item',
        fieldId: 'quantity',
        line: i  // 0-based!
    });
}