@hitc/netsuite-types 2025.1.12 → 2025.1.14

package/N/email.d.ts

@@ -11,7 +11,7 @@ interface SendOptions {
      * A maximum of 10 recipients (recipient + cc + bcc) is allowed.
      * Note: Only the first recipient displays on the Communication tab (under the Recipient column).
      */
-    recipients: number[]|string[]|number|string;
+    recipients: number|string|number[]|string[]|readonly number[]|readonly string[];
     /**
      * The email address that appears in the reply-to header when an email is sent out.
      */
@@ -21,13 +21,13 @@ interface SendOptions {
      * For multiple recipients, use an array of internal IDs or email addresses. You can use an array that contains a combination of internal IDs and email addresses.
      * A maximum of 10 recipients (recipient + cc + bcc) is allowed.
      */
-    cc?: string[]|number[];
+    cc?: number[]|string[]|readonly number[]|readonly string[];
     /**
      * The internal ID or email address of the secondary recipient to blind copy.
      * For multiple recipients, use an array of internal IDs or email addresses. You can use an array that contains a combination of internal IDs and email addresses.
      * A maximum of 10 recipients (recipient + cc + bcc) is allowed.
      */
-    bcc?: string[]|number[];
+    bcc?: number[]|string[]|readonly number[]|readonly string[];
     /**
      * Subject of the outgoing message
      */
@@ -41,7 +41,7 @@ interface SendOptions {
      * An individual attachment must not exceed 5MB and the total message size must be 15MB or less.
      * Note: Supported for server-side scripts only.
      */
-    attachments?: File[];
+    attachments?: File[]|readonly File[];
     /**
      * Object that contains key/value pairs to associate the Message record with related records (including custom records).
      */
@@ -49,7 +49,7 @@ interface SendOptions {
     /**
      * If true, the Message record is not visible to an external Entity (for example, a customer or contact). Default is false.
      */
-    isInternalOnly?: boolean;   
+    isInternalOnly?: boolean;
 }
 
 interface RelatedRecordTypes {

package/N/llm.d.ts

@@ -3,34 +3,177 @@
  * You can use this module to send requests to the large language models (LLMs) supported by NetSuite and to receive LLM responses to use in your scripts.
  */
 
+import type {File} from './file';
+
 /** The chat message object returned by the llm.createChatMessage(options) method. */
 interface ChatMessage {
     text: string;
     readonly role: ChatRole;
 }
 
+/**
+ * A citation returned from the LLM when source documents are provided to llm.generateText(options) or llm.generateText.promise(options).
+ *
+ * A citation represents the content from source documents where the LLM found relevant information for its response.
+ * Citations are created using retrieval-augmented generation (RAG), which lets you provide additional context that the LLM can use to generate its responses.
+ * For more information about RAG, see What Is Retrieval-Augmented Generation (RAG)?
+ *
+ * Citation objects are included in the llm.Response object that is returned from llm.generateText(options) or llm.generateText.promise(options), if applicable, through the Response.citations property.
+ * You can use the citation object to identify the documents that the LLM used for its response, as well as where the cited text appears in the response.
+ * The object includes properties that specify the documents used (Citation.documentIds), the start and end points of the cited text (Citation.start and Citation.end), and the content itself (Citation.text).
+ */
+interface Citation {
+    documentIds: string[];
+    readonly end: number;
+    readonly start: number;
+    readonly text: string;
+}
+
 /** The response returned from LLM. Use the llm.generateText(options) or the llm.generateText.promise(options) method to retrieve a response from the LLM. */
 interface Response {
+    readonly citations: Citation[];
+    readonly documents: Document[];
     readonly text: string;
     readonly model: string;
     readonly chatHistory: ChatMessage[];
 }
 
+interface StreamedResponse {
+    readonly citations: Citation[];
+    readonly documents: Document[];
+    readonly text: string;
+    readonly model: string;
+    readonly chatHistory: ChatMessage[];
+}
+
+/**
+ * Creates a chat message based on a specified role and text.
+ * Chat messages can be used in the chatHistory parameter of the llm.generateText(options) method.
+ * Supported roles are defined by the llm.ChatRole enum.
+ */
 export function createChatMessage(options: { role: string, text: string }): ChatMessage;
 
+/**
+ * Creates a document with the specified ID and content.
+ *
+ * A document represents source content that you can provide as additional context to the LLM when you call llm.generateText(options) or llm.generateText.promise(options).
+ * The LLM uses information in the provided documents to augment its response using retrieval-augmented generation (RAG).
+ * For more information about RAG, see What Is Retrieval-Augmented Generation (RAG)?
+ *
+ * You do not need to use this method to create a document before providing the document to llm.generateText(options) or llm.generateText.promise(options).
+ * You can also provide a plain JavaScript object that uses the id and data properties.
+ */
+export function createDocument(options: { data: string, id: string }): Document;
+
+export const embed: IEmbededFunction
+
+/**
+ * Takes the ID of an existing prompt and values for variables used in the prompt and returns the response from the LLM.
+ *
+ * You can use this method to evaluate a prompt that is available in Prompt Studio by providing values for any variables that the prompt uses.
+ * The resulting prompt is sent to the LLM, and this method returns the LLM response, similar to the llm.generateText(options) method.
+ * For more information about Prompt Studio, see Prompt Studio.
+ *
+ * When unlimited usage mode is used, this method accepts the OCI configuration parameters.
+ * You can also specify OCI configuration parameters on the SuiteScript tab of the AI Preferences page.
+ * For more information, see Using Your Own OCI Configuration for SuiteScript Generative AI APIs.
+ */
+export const evaluatePrompt: IEvaluatePromptFunction;
+
+export const evaluatePromptStreamed: IEvaluatePromptStreamedFunction;
+
 export const generateText: GenerateTextFunction;
 
+/**
+ * Returns the streamed response from the LLM for a given prompt.
+ *
+ * This method is similar to llm.generateText(options) but returns the LLM response as a stream.
+ * After calling this method, you can access the partial response (using the StreamedResponse.text property of the returned llm.StreamedResponse object) before the entire response has been generated.
+ * You can also use an iterator to examine each token returned by the LLM.
+ */
+export const generateTextStreamed: GenerateTextStreamedFunction;
+
 /** Returns the number of free requests in the current month. */
 export const getRemainingFreeUsage: GetRemainingFreeUsageFunction;
 
+/** Returns the number of free embeddings requests in the current month. This method tracks free requests for embed API calls, such as llm.embed(options). To track free requests for non-embed API calls (such as llm.generateText(options)), use llm.getRemainingFreeUsage() instead. */
+export const getRemainingFreeEmbedUsage: GetRemainingFreeUsageFunction;
+
+interface IEmbededFunction {
+    (options: IEmbedOptions): EmbeddedResponse;
+    promise(options: IEmbedOptions): Promise<EmbeddedResponse>;
+}
+
+interface IEvaluatePromptFunction {
+    (options: IEvaluatePromptOptions): Response;
+    promise(options: IEvaluatePromptOptions): Promise<Response>;
+}
+
+interface IEvaluatePromptStreamedFunction {
+    (options: IEvaluatePromptOptions): StreamedResponse;
+    promise(options: IEvaluatePromptOptions): Promise<StreamedResponse>;
+}
+
 interface GenerateTextFunction {
     (options: IGenerateTextOptions): Response;
-    promise(options: IGenerateTextOptions): Response;
+    promise(options: IGenerateTextOptions): Promise<Response>;
+}
+
+interface GenerateTextStreamedFunction {
+    (options: IGenerateTextOptions): StreamedResponse;
+    promise(options: IGenerateTextOptions): Promise<StreamedResponse>;
 }
 
 interface GetRemainingFreeUsageFunction {
     (): number;
-    promise(): number;
+    promise(): Promise<number>;
+}
+
+interface EmbeddedResponse {
+    readonly embeddings: number[];
+    /** The list of inputs used to generate the embeddings response. */
+    readonly inputs: string[];
+    /** The model used to generate the embeddings response. */
+    readonly model: string;
+}
+
+interface IEmbedOptions {
+    /** An array of inputs to get embeddings for. */
+    inputs: string[] | readonly string[];
+    /** The embed model family to use. Use values from llm.EmbedModelFamily to set this value. If not specified, the Cohere Embed Multilingual model is used. */
+    embededModelFamily?: string;
+    /** Configuration needed for unlimited usage through OCI Generative AI Service. Required only when accessing the LLM through an Oracle Cloud Account and the OCI Generative AI Service. SuiteApps installed to target accounts are prevented from using the free usage pool for N/llm and must use the OCI configuration. */
+    ociConfig?: IOCIConfig;
+    /** The amount of time to wait for a response from the LLM, in milliseconds. If not specified, the default value is 30,000. */
+    timeout?: number;
+    /** The truncation method to use when embeddings input exceeds 512 tokens. Use values from llm.Truncate to set this value. If not specified, no truncation method is used. */
+    truncate?: string;
+}
+
+interface IEvaluatePromptOptions {
+    id: string|number;
+    /**
+     * Configuration needed for unlimited usage through OCI Generative AI Service.
+     * Required only when accessing the LLM through an Oracle Cloud Account and the OCI Generative AI Service.
+     * SuiteApps installed to target accounts are prevented from using the free usage pool for N/llm and must use the OCI configuration.
+     *
+     * Instead of specifying OCI configuration details using this parameter, you can specify them on the SuiteScript tab of the AI Preferences page.
+     * When you do so, those OCI configuration details are used for all scripts in your account that use N/llm module methods, and unlimited usage mode is enabled for those scripts.
+     * If you specify OCI configuration details in both places (using this parameter and using the SuiteScript tab of the AI Preferences page), the details provided in this parameter override those that are specified on the SuiteScript tab.
+     * For more information, see Using Your Own OCI Configuration for SuiteScript Generative AI APIs.
+     */
+    ociConfig?: IOCIConfig;
+    /** Timeout in milliseconds, defaults to 30,000. */
+    timeout?: number;
+    /**
+     * Values for the variables that are used in the prompt. Provide these values as an object with key-value pairs.
+     * For an example, see the Syntax section.
+     *
+     * You can use Prompt Studio to generate a SuiteScript example that uses this method and includes the variables for a prompt in the correct format.
+     * When viewing a prompt in Prompt Studio, click Show SuiteScript Example to generate SuiteScript code with all the variables that prompt uses.
+     * You can then use this code in your scripts and provide a value for each variable.
+     */
+    variables?: object;
 }
 
 interface IGenerateTextOptions {
@@ -38,6 +181,16 @@ interface IGenerateTextOptions {
     prompt: string;
     /** Chat history to be taken into consideration. */
     chatHistory?: ChatMessage[];
+    /** A list of documents to provide additional context for the LLM to generate the response. */
+    documents?: Document[];
+    /**
+     * An image to query. You can send an image (as a file.File object) to the LLM and ask questions about the image and get text outputs, such as:
+     * - Advanced image captions
+     * - Detailed description of an image
+     * - Answers to questions about an image
+     * - Information about charts and graphs in an image
+     */
+    image?: File;
     /** Specifies the LLM to use. Use llm.ModelFamily to set the value. If not specified, the Cohere Command R LLM is used. */
     modelFamily?: ModelFamily;
     modelParameters?: IModelParameters;
@@ -47,10 +200,17 @@ interface IGenerateTextOptions {
      * SuiteApps installed to target accounts are prevented from using the free usage pool for N/llm and must use the OCI configuration.
      */
     ociConfig?: IOCIConfig;
+    /** Preamble override for the LLM. A preamble is the Initial context or guiding message for an LLM. For more details about using a preamble, refer to About the Chat Models in Generative AI (Chat Model Parameters section) in the Oracle Cloud Infrastructure Documentation. */
     preamble?: string;
+    /** Timeout in milliseconds, defaults to 30,000. */
     timeout?: number;
 }
 
+interface Document {
+    readonly data: string;
+    readonly id: string;
+}
+
 interface IModelParameters {
     /** A penalty that is assigned to a token when that token appears frequently. The higher the value, the stronger a penalty is applied to previously present tokens, proportional to how many times they have already appeared in the prompt or prior generation. See Model Parameter Values by LLM for valid values. */
     frequencyPenalty?: number;
@@ -109,6 +269,16 @@ declare enum ChatRole {
     CHATBOT = "CHATBOT"
 }
 
+/** The large language model to be used to generate embeddings. */
+declare enum EmbedModelFamily {
+    COHERE_EMBED_ENGLISH = 'cohere.embed-english-v3.0',
+    /** Light versions of embedding models might generate embeddings faster than regular embedding models, but the output might not be as accurate. */
+    COHERE_EMBED_ENGLISH_LIGHT = 'cohere.embed-english-light-v3.0',
+    COHERE_EMBED_MULTILINGUAL = 'cohere.embed-multilingual-v3.0',
+    /** Light versions of embedding models might generate embeddings faster than regular embedding models, but the output might not be as accurate. */
+    COHERE_EMBED_MULTILINGUAL_LIGHT = 'cohere.embed-multilingual-light-v3.0'
+}
+
 /** The large language model to be used. */
 declare enum ModelFamily {
     /** Always uses the latest supported Cohere model. Cohere Command-R is the default when the options.modelFamily parameter is omitted. */
@@ -116,3 +286,10 @@ declare enum ModelFamily {
     /** Always uses the latest supported Meta Llama model. */
     META_LLAMA = 'meta.llama-3.1-70b-instruct'
 }
+
+/** The truncation method to use when embeddings input exceeds 512 tokens. Use this enum to set the value of the options.truncate parameter in llm.embed(options). */
+declare enum Truncate {
+    END = 'END',
+    NONE = 'NONE',
+    START = 'START'
+}

package/N/log.d.ts

@@ -1,12 +1,12 @@
 interface LogOptions {
     /** String to appear in the Title column on the Execution Log tab of the script deployment. Maximum length is 99 characters. */
-    title?: string;
+    title: string;
     /**
      * You can pass any value for this parameter.
      * If the value is a JavaScript object type, JSON.stringify(obj) is called on the object before displaying the value.
      * NetSuite truncates any resulting string over 3999 characters.
      */
-    details: any;
+    details?: any;
 }
 
 interface LogFunction {

package/N/query.d.ts

@@ -54,7 +54,13 @@ interface CreateConditionOptions {
      * Array of values to use for the condition.
      * Required if options.fieldId and options.operator are used, and options.operator does not have a value of query.Operator.EMPTY or query.Operator.EMPTY_NOT.
      */
-    values: string | boolean | string[] | boolean[] | number[] | Date[] | RelativeDate[] | Period[]; // You wouldn't have multiple boolean values in an array, obviously. But you might specify it like: [true].
+    values: string | boolean |
+        string[] | readonly string[] |
+        boolean[] | readonly boolean[] | // You wouldn't have multiple boolean values in an array, obviously. But you might specify it like: [true].
+        number[] | readonly number[] |
+        Date[] | readonly Date[] |
+        RelativeDate[] | readonly RelativeDate[] |
+        Period[] | readonly Period[];
 
     /**
      * If you use the options.formula parameter, use this parameter to explicitly define the formula’s return type. This value sets the Condition.type property.
@@ -112,8 +118,8 @@ interface CreateColumnOptions {
 
     /**
      * An alias for this column. An alias is an alternate name for a column, and the alias is used in mapped results.
-     * In general, the alias is an optional property. 
-     * 
+     * In general, the alias is an optional property.
+     *
      * To use mapped results, you must specify an alias in the following situations:
      * 1. You must specify an alias for a column when the column uses a formula.
      * 2. You must specify an alias when two columns in a joined query use the same field ID.
@@ -149,8 +155,8 @@ interface CreateColumnWithFormulaOptions {
 
     /**
      * An alias for this column. An alias is an alternate name for a column, and the alias is used in mapped results.
-     * In general, the alias is an optional property. 
-     * 
+     * In general, the alias is an optional property.
+     *
      * To use mapped results, you must specify an alias in the following situations:
      * 1. You must specify an alias for a column when the column uses a formula.
      * 2. You must specify an alias when two columns in a joined query use the same field ID.
@@ -185,9 +191,9 @@ interface CreateSortOptions {
 interface CreateQueryOptions {
     /** The query type. Use the Type enum. */
     type: string;
-    columns?: Column[];
+    columns?: Column[] | readonly Column[];
     condition?: Condition;
-    sort?: Sort[];
+    sort?: Sort[] | readonly Sort[];
 }
 
 interface LoadQueryOptions {
@@ -206,8 +212,9 @@ export interface RunSuiteQLOptions {
      */
     query: string;
 
-    params?: Array<string | number | boolean>;
-        
+    params?: Array<string | number | boolean> |
+        ReadonlyArray<string | number | boolean>;
+
     customScriptId?: string;
 }
 
@@ -753,7 +760,7 @@ interface Period {
     readonly code: string;
     /**
      * The type of the period. This property uses values from the query.PeriodType enum.
-     * If you create a period using query.createPeriod(options) and do not specify a value for the options.type 
+     * If you create a period using query.createPeriod(options) and do not specify a value for the options.type
      * parameter, the default value of this property is query.PeriodType.START.
      */
     readonly type: string;
@@ -1260,7 +1267,7 @@ export enum FieldContext {
     CONVERTED = "CONVERTED",
     /** Displays consolidated currency amounts in the base currency. */
     CURRENCY_CONSOLIDATED = "CURRENCY_CONSOLIDATED",
-    /** 
+    /**
      * Displays user-friendly field values.
      * For example, for the entity field on Transaction records, using the DISPLAY enum value displays the name of the entity instead of its ID.
      */

package/N/types.d.ts

@@ -194,7 +194,7 @@ export namespace EntryPoints {
 
         interface beforeSubmitContext {
             newRecord: N_record.Record;
-            oldRecord?: N_record.Record;
+            oldRecord: N_record.Record | null;
             type: UserEventType;
             UserEventType: UserEventTypes;
         }
@@ -203,7 +203,7 @@ export namespace EntryPoints {
 
         interface afterSubmitContext {
             newRecord: N_record.Record & { id: number };
-            oldRecord?: N_record.Record;
+            oldRecord: N_record.Record | null;
             type: UserEventType;
             UserEventType: UserEventTypes;
         }
@@ -364,7 +364,7 @@ export namespace EntryPoints {
     namespace WorkflowAction {
         interface onActionContext {
             newRecord: N_record.Record;
-            oldRecord?: N_record.Record;
+            oldRecord: N_record.Record | null;
             form?: N_ui_serverWidget.Form;
             type?: string;
             workflowId?: number;

package/package.json

@@ -8,7 +8,7 @@
     "posttest": "npm run cleanup"
   },
   "homepage": "https://github.com/headintheclouddev/typings-suitescript-2.0",
-  "version": "2025.1.12",
+  "version": "2025.1.14",
   "author": "Head in the Cloud Development <gurus@headintheclouddev.com> (www.headintheclouddev.com)",
   "license": "MIT",
   "repository": {