@suiteportal/connector 0.3.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +42 -10
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +7 -4
- package/dist/index.d.ts +7 -4
- package/dist/index.js +42 -10
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/dist/index.cjs
CHANGED
|
@@ -53,8 +53,9 @@ module.exports = __toCommonJS(index_exports);
|
|
|
53
53
|
|
|
54
54
|
// src/auth/oauth.ts
|
|
55
55
|
var import_node_crypto = require("crypto");
|
|
56
|
+
var RFC5849_EXTRA = /[!'()*]/g;
|
|
56
57
|
function percentEncode(str) {
|
|
57
|
-
return encodeURIComponent(str).replace(
|
|
58
|
+
return encodeURIComponent(str).replace(RFC5849_EXTRA, (c) => {
|
|
58
59
|
return `%${c.charCodeAt(0).toString(16).toUpperCase()}`;
|
|
59
60
|
});
|
|
60
61
|
}
|
|
@@ -65,9 +66,12 @@ function generateTimestamp() {
|
|
|
65
66
|
return Math.floor(Date.now() / 1e3).toString();
|
|
66
67
|
}
|
|
67
68
|
function buildSignatureBaseString(method, baseUrl, params) {
|
|
68
|
-
const sorted =
|
|
69
|
-
|
|
70
|
-
|
|
69
|
+
const sorted = params.slice().sort((a, b) => {
|
|
70
|
+
if (a[0] < b[0]) return -1;
|
|
71
|
+
if (a[0] > b[0]) return 1;
|
|
72
|
+
if (a[1] < b[1]) return -1;
|
|
73
|
+
if (a[1] > b[1]) return 1;
|
|
74
|
+
return 0;
|
|
71
75
|
});
|
|
72
76
|
const paramString = sorted.map(([k, v]) => `${percentEncode(k)}=${percentEncode(v)}`).join("&");
|
|
73
77
|
return [
|
|
@@ -91,12 +95,18 @@ function generateOAuthSignature(params) {
|
|
|
91
95
|
oauth_signature_method: "HMAC-SHA256",
|
|
92
96
|
oauth_version: "1.0"
|
|
93
97
|
};
|
|
94
|
-
const
|
|
95
|
-
const baseUrl =
|
|
98
|
+
const qIdx = params.url.indexOf("?");
|
|
99
|
+
const baseUrl = qIdx === -1 ? params.url : params.url.slice(0, qIdx);
|
|
96
100
|
const allParams = Object.entries(oauthParams);
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
101
|
+
if (qIdx !== -1) {
|
|
102
|
+
const qs = params.url.slice(qIdx + 1);
|
|
103
|
+
for (const pair of qs.split("&")) {
|
|
104
|
+
const eqIdx = pair.indexOf("=");
|
|
105
|
+
if (eqIdx !== -1) {
|
|
106
|
+
allParams.push([decodeURIComponent(pair.slice(0, eqIdx)), decodeURIComponent(pair.slice(eqIdx + 1))]);
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
}
|
|
100
110
|
const baseString = buildSignatureBaseString(params.method, baseUrl, allParams);
|
|
101
111
|
const signature = signHmacSha256(baseString, params.consumerSecret, params.tokenSecret);
|
|
102
112
|
return { signature, oauthParams };
|
|
@@ -243,6 +253,7 @@ var TokenBucket = class {
|
|
|
243
253
|
refillRate;
|
|
244
254
|
// tokens per ms
|
|
245
255
|
lastRefill;
|
|
256
|
+
pendingTimers = /* @__PURE__ */ new Set();
|
|
246
257
|
constructor(options) {
|
|
247
258
|
this.maxTokens = options.burstSize ?? options.requestsPerSecond;
|
|
248
259
|
this.refillRate = options.requestsPerSecond / 1e3;
|
|
@@ -261,7 +272,13 @@ var TokenBucket = class {
|
|
|
261
272
|
return;
|
|
262
273
|
}
|
|
263
274
|
const waitMs = (1 - this.tokens) / this.refillRate;
|
|
264
|
-
await new Promise((resolve) =>
|
|
275
|
+
await new Promise((resolve) => {
|
|
276
|
+
const timer = setTimeout(() => {
|
|
277
|
+
this.pendingTimers.delete(timer);
|
|
278
|
+
resolve();
|
|
279
|
+
}, waitMs);
|
|
280
|
+
this.pendingTimers.add(timer);
|
|
281
|
+
});
|
|
265
282
|
this.refill();
|
|
266
283
|
this.tokens--;
|
|
267
284
|
}
|
|
@@ -270,6 +287,13 @@ var TokenBucket = class {
|
|
|
270
287
|
this.refill();
|
|
271
288
|
return this.tokens;
|
|
272
289
|
}
|
|
290
|
+
/** Cancel all pending timers. Call on client teardown. */
|
|
291
|
+
destroy() {
|
|
292
|
+
for (const timer of this.pendingTimers) {
|
|
293
|
+
clearTimeout(timer);
|
|
294
|
+
}
|
|
295
|
+
this.pendingTimers.clear();
|
|
296
|
+
}
|
|
273
297
|
refill() {
|
|
274
298
|
const now = Date.now();
|
|
275
299
|
const elapsed = now - this.lastRefill;
|
|
@@ -305,6 +329,10 @@ var RequestThrottler = class {
|
|
|
305
329
|
get waitingCount() {
|
|
306
330
|
return this.semaphore.waitingCount;
|
|
307
331
|
}
|
|
332
|
+
/** Cancel pending token bucket timers. Call on client teardown. */
|
|
333
|
+
destroy() {
|
|
334
|
+
this.tokenBucket?.destroy();
|
|
335
|
+
}
|
|
308
336
|
};
|
|
309
337
|
|
|
310
338
|
// src/http/retry.ts
|
|
@@ -369,6 +397,10 @@ var NetSuiteClient = class {
|
|
|
369
397
|
get resolvedConfig() {
|
|
370
398
|
return this.config;
|
|
371
399
|
}
|
|
400
|
+
/** Release resources (cancel pending token bucket timers). */
|
|
401
|
+
destroy() {
|
|
402
|
+
this.throttler.destroy();
|
|
403
|
+
}
|
|
372
404
|
async executeRequest(options) {
|
|
373
405
|
const url = this.buildUrl(options.path, options.query);
|
|
374
406
|
const realm = getRealm(this.config.accountId);
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts","../src/auth/oauth.ts","../src/auth/headers.ts","../src/config.ts","../src/http/errors.ts","../src/http/rate-limiter.ts","../src/http/token-bucket.ts","../src/http/request-throttler.ts","../src/http/retry.ts","../src/http/client.ts","../src/suiteql/executor.ts","../src/suiteql/paginator.ts","../src/rest/record.ts","../src/rest/transform.ts"],"sourcesContent":["// Core client\nexport { NetSuiteClient } from './http/client.js';\n\n// SuiteQL\nexport { executeSuiteQL } from './suiteql/executor.js';\nexport { executeSuiteQLPaginated } from './suiteql/paginator.js';\nexport type { PaginationOptions } from './suiteql/paginator.js';\n\n// Auth (exposed for advanced use / testing)\nexport { buildAuthorizationHeader } from './auth/headers.js';\nexport {\n generateOAuthSignature,\n percentEncode,\n buildSignatureBaseString,\n signHmacSha256,\n generateNonce,\n generateTimestamp,\n} from './auth/oauth.js';\n\n// REST Record API\nexport { createRecord, updateRecord, deleteRecord, upsertRecord, getRecord } from './rest/record.js';\nexport { transformRecord } from './rest/transform.js';\nexport type { TransformOptions, TransformResult } from './rest/transform.js';\n\n// Config\nexport { resolveConfig, deriveBaseUrl, getRealm } from './config.js';\nexport type { ResolvedConfig } from './config.js';\n\n// Errors\nexport {\n NetSuiteError,\n AuthError,\n RateLimitError,\n TimeoutError,\n isRetryableStatus,\n} from './http/errors.js';\n\n// Rate limiter\nexport { RateLimiter } from './http/rate-limiter.js';\n\n// Token bucket + throttler\nexport { TokenBucket } from './http/token-bucket.js';\nexport type { TokenBucketOptions } from './http/token-bucket.js';\nexport { RequestThrottler } from './http/request-throttler.js';\nexport type { ThrottlerOptions } from './http/request-throttler.js';\n\n// Retry\nexport { withRetry } from './http/retry.js';\nexport type { RetryOptions } from './http/retry.js';\n\n// Types\nexport type {\n NetSuiteConfig,\n SuiteQLRow,\n SuiteQLResult,\n SuiteQLResponse,\n OAuthParams,\n RequestOptions,\n NetSuiteResponse,\n} from './types.js';\n","import { createHmac, randomBytes } from 'node:crypto';\nimport type { OAuthParams } from '../types.js';\n\n/**\n * RFC 5849 §3.6 percent-encoding.\n * Encodes all characters except unreserved (ALPHA, DIGIT, '-', '.', '_', '~').\n */\nexport function percentEncode(str: string): string {\n return encodeURIComponent(str).replace(/[!'()*]/g, (c) => {\n return `%${c.charCodeAt(0).toString(16).toUpperCase()}`;\n });\n}\n\n/** Generate a random nonce for OAuth requests. */\nexport function generateNonce(): string {\n return randomBytes(16).toString('hex');\n}\n\n/** Generate a Unix timestamp string. */\nexport function generateTimestamp(): string {\n return Math.floor(Date.now() / 1000).toString();\n}\n\n/**\n * Build the OAuth signature base string per RFC 5849 §3.4.1.\n */\nexport function buildSignatureBaseString(\n method: string,\n baseUrl: string,\n params: Array<[string, string]>,\n): string {\n // Sort params lexicographically by key, then by value\n const sorted = [...params].sort((a, b) => {\n const keyCompare = a[0]!.localeCompare(b[0]!);\n return keyCompare !== 0 ? keyCompare : a[1]!.localeCompare(b[1]!);\n });\n\n const paramString = sorted\n .map(([k, v]) => `${percentEncode(k!)}=${percentEncode(v!)}`)\n .join('&');\n\n return [\n method.toUpperCase(),\n percentEncode(baseUrl),\n percentEncode(paramString),\n ].join('&');\n}\n\n/**\n * Sign the base string with HMAC-SHA256.\n * Signing key = percentEncode(consumerSecret) & percentEncode(tokenSecret)\n */\nexport function signHmacSha256(\n baseString: string,\n consumerSecret: string,\n tokenSecret: string,\n): string {\n const signingKey = `${percentEncode(consumerSecret)}&${percentEncode(tokenSecret)}`;\n return createHmac('sha256', signingKey).update(baseString).digest('base64');\n}\n\n/**\n * Generate the full OAuth 1.0a signature for a request.\n * Returns the signature string and the oauth params used (for header construction).\n */\nexport function generateOAuthSignature(params: OAuthParams): {\n signature: string;\n oauthParams: Record<string, string>;\n} {\n const timestamp = params.timestamp ?? generateTimestamp();\n const nonce = params.nonce ?? generateNonce();\n\n const oauthParams: Record<string, string> = {\n oauth_consumer_key: params.consumerKey,\n oauth_token: params.tokenId,\n oauth_nonce: nonce,\n oauth_timestamp: timestamp,\n oauth_signature_method: 'HMAC-SHA256',\n oauth_version: '1.0',\n };\n\n // Strip query string from URL for base string\n const urlObj = new URL(params.url);\n const baseUrl = `${urlObj.protocol}//${urlObj.host}${urlObj.pathname}`;\n\n // Collect all params: oauth params + query string params\n const allParams: Array<[string, string]> = Object.entries(oauthParams);\n urlObj.searchParams.forEach((value, key) => {\n allParams.push([key, value]);\n });\n\n const baseString = buildSignatureBaseString(params.method, baseUrl, allParams);\n const signature = signHmacSha256(baseString, params.consumerSecret, params.tokenSecret);\n\n return { signature, oauthParams };\n}\n","import { generateOAuthSignature, percentEncode } from './oauth.js';\nimport type { OAuthParams } from '../types.js';\n\n/**\n * Build the OAuth Authorization header value.\n * Format: OAuth realm=\"...\", oauth_consumer_key=\"...\", ..., oauth_signature=\"...\"\n */\nexport function buildAuthorizationHeader(params: OAuthParams): string {\n const { signature, oauthParams } = generateOAuthSignature(params);\n\n const headerParams: Record<string, string> = {\n realm: params.realm,\n ...oauthParams,\n oauth_signature: signature,\n };\n\n const parts = Object.entries(headerParams)\n .map(([key, value]) => `${percentEncode(key)}=\"${percentEncode(value)}\"`)\n .join(', ');\n\n return `OAuth ${parts}`;\n}\n","import type { NetSuiteConfig } from './types.js';\n\nconst REQUIRED_FIELDS = [\n 'accountId',\n 'consumerKey',\n 'consumerSecret',\n 'tokenId',\n 'tokenSecret',\n] as const;\n\nconst DEFAULTS = {\n timeout: 30_000,\n concurrency: 5,\n maxRetries: 3,\n} as const;\n\nexport interface ResolvedConfig extends Required<Omit<NetSuiteConfig, 'baseUrl' | 'requestsPerSecond' | 'burstSize'>> {\n baseUrl: string;\n requestsPerSecond?: number;\n burstSize?: number;\n}\n\n/** Validate config and fill defaults. */\nexport function resolveConfig(config: NetSuiteConfig): ResolvedConfig {\n for (const field of REQUIRED_FIELDS) {\n if (!config[field]) {\n throw new Error(`NetSuiteConfig: \"${field}\" is required`);\n }\n }\n\n return {\n accountId: config.accountId,\n consumerKey: config.consumerKey,\n consumerSecret: config.consumerSecret,\n tokenId: config.tokenId,\n tokenSecret: config.tokenSecret,\n timeout: config.timeout ?? DEFAULTS.timeout,\n concurrency: config.concurrency ?? DEFAULTS.concurrency,\n maxRetries: config.maxRetries ?? DEFAULTS.maxRetries,\n requestsPerSecond: config.requestsPerSecond,\n burstSize: config.burstSize,\n baseUrl: config.baseUrl ?? deriveBaseUrl(config.accountId),\n };\n}\n\n/**\n * Derive the NetSuite REST API base URL from the account ID.\n * Account IDs with underscores (sandbox) have underscores replaced with hyphens.\n * Example: \"1234567_SB1\" → \"https://1234567-sb1.suitetalk.api.netsuite.com\"\n */\nexport function deriveBaseUrl(accountId: string): string {\n const normalized = accountId.toLowerCase().replace(/_/g, '-');\n return `https://${normalized}.suitetalk.api.netsuite.com`;\n}\n\n/** Get the realm (account ID in uppercase, underscores preserved). */\nexport function getRealm(accountId: string): string {\n return accountId.toUpperCase().replace(/-/g, '_');\n}\n","/** Base error class for all NetSuite connector errors. */\nexport class NetSuiteError extends Error {\n constructor(\n message: string,\n public readonly status?: number,\n public readonly code?: string,\n public readonly details?: unknown,\n ) {\n super(message);\n this.name = 'NetSuiteError';\n }\n}\n\n/** Authentication or authorization failure. */\nexport class AuthError extends NetSuiteError {\n constructor(message: string, status?: number, details?: unknown) {\n super(message, status, 'AUTH_ERROR', details);\n this.name = 'AuthError';\n }\n}\n\n/** Rate limit (429) exceeded. */\nexport class RateLimitError extends NetSuiteError {\n constructor(\n public readonly retryAfterMs: number,\n details?: unknown,\n ) {\n super(`Rate limited. Retry after ${retryAfterMs}ms`, 429, 'RATE_LIMIT', details);\n this.name = 'RateLimitError';\n }\n}\n\n/** Request timeout via AbortController. */\nexport class TimeoutError extends NetSuiteError {\n constructor(timeoutMs: number) {\n super(`Request timed out after ${timeoutMs}ms`, undefined, 'TIMEOUT');\n this.name = 'TimeoutError';\n }\n}\n\n/** HTTP status codes that are safe to retry. */\nconst RETRYABLE_STATUSES = new Set([408, 429, 502, 503, 504]);\n\n/** Check if an HTTP status code is retryable. */\nexport function isRetryableStatus(status: number): boolean {\n return RETRYABLE_STATUSES.has(status);\n}\n","/**\n * Async semaphore for concurrency governance.\n * Limits the number of in-flight requests to prevent overwhelming NetSuite.\n */\nexport class RateLimiter {\n private active = 0;\n private queue: Array<() => void> = [];\n\n constructor(private readonly maxConcurrent: number) {}\n\n /** Acquire a slot. Resolves when a slot is available. */\n async acquire(): Promise<void> {\n if (this.active < this.maxConcurrent) {\n this.active++;\n return;\n }\n\n return new Promise<void>((resolve) => {\n this.queue.push(() => {\n this.active++;\n resolve();\n });\n });\n }\n\n /** Release a slot, unblocking the next waiter if any. */\n release(): void {\n this.active--;\n const next = this.queue.shift();\n if (next) {\n next();\n }\n }\n\n /** Run an async function within the concurrency limit. */\n async run<T>(fn: () => Promise<T>): Promise<T> {\n await this.acquire();\n try {\n return await fn();\n } finally {\n this.release();\n }\n }\n\n /** Number of currently active tasks. */\n get activeCount(): number {\n return this.active;\n }\n\n /** Number of tasks waiting for a slot. */\n get waitingCount(): number {\n return this.queue.length;\n }\n}\n","export interface TokenBucketOptions {\n /** Maximum requests per second. */\n requestsPerSecond: number;\n /** Maximum burst capacity. Defaults to requestsPerSecond. */\n burstSize?: number;\n}\n\n/**\n * Token bucket rate limiter for proactive request throttling.\n * Smooths request rate to stay within NetSuite's rate limits\n * instead of reacting to 429 errors.\n */\nexport class TokenBucket {\n private tokens: number;\n private readonly maxTokens: number;\n private readonly refillRate: number; // tokens per ms\n private lastRefill: number;\n\n constructor(options: TokenBucketOptions) {\n this.maxTokens = options.burstSize ?? options.requestsPerSecond;\n this.refillRate = options.requestsPerSecond / 1000;\n this.tokens = this.maxTokens;\n this.lastRefill = Date.now();\n }\n\n /**\n * Acquire a token, waiting if necessary.\n * Resolves immediately if a token is available, otherwise\n * delays until the bucket refills enough for one token.\n */\n async acquire(): Promise<void> {\n this.refill();\n\n if (this.tokens >= 1) {\n this.tokens--;\n return;\n }\n\n const waitMs = (1 - this.tokens) / this.refillRate;\n await new Promise<void>((resolve) => setTimeout(resolve, waitMs));\n this.refill();\n this.tokens--;\n }\n\n /** Number of tokens currently available. */\n get availableTokens(): number {\n this.refill();\n return this.tokens;\n }\n\n private refill(): void {\n const now = Date.now();\n const elapsed = now - this.lastRefill;\n if (elapsed <= 0) return;\n\n this.tokens = Math.min(this.maxTokens, this.tokens + elapsed * this.refillRate);\n this.lastRefill = now;\n }\n}\n","import { RateLimiter } from './rate-limiter.js';\nimport { TokenBucket } from './token-bucket.js';\n\nexport interface ThrottlerOptions {\n /** Max concurrent requests. Default: 5. */\n concurrency?: number;\n /** Proactive rate limit (requests/sec). Undefined = disabled. */\n requestsPerSecond?: number;\n /** Burst capacity for the token bucket. Defaults to requestsPerSecond. */\n burstSize?: number;\n}\n\n/**\n * Composes concurrency limiting (semaphore) with proactive rate limiting (token bucket).\n * Token bucket fires first (delays to stay under rate limit), then the semaphore\n * limits parallelism.\n */\nexport class RequestThrottler {\n private readonly semaphore: RateLimiter;\n private readonly tokenBucket: TokenBucket | null;\n\n constructor(options: ThrottlerOptions = {}) {\n this.semaphore = new RateLimiter(options.concurrency ?? 5);\n this.tokenBucket =\n options.requestsPerSecond != null\n ? new TokenBucket({\n requestsPerSecond: options.requestsPerSecond,\n burstSize: options.burstSize,\n })\n : null;\n }\n\n /** Run an async function within both rate and concurrency limits. */\n async run<T>(fn: () => Promise<T>): Promise<T> {\n if (this.tokenBucket) {\n await this.tokenBucket.acquire();\n }\n return this.semaphore.run(fn);\n }\n\n /** Number of currently active tasks. */\n get activeCount(): number {\n return this.semaphore.activeCount;\n }\n\n /** Number of tasks waiting for a slot. */\n get waitingCount(): number {\n return this.semaphore.waitingCount;\n }\n}\n","import { RateLimitError, isRetryableStatus, NetSuiteError } from './errors.js';\n\nexport interface RetryOptions {\n maxRetries: number;\n /** Base delay in ms before first retry. Default: 500. */\n baseDelay?: number;\n /** Maximum delay in ms. Default: 30000. */\n maxDelay?: number;\n}\n\n/**\n * Execute a function with exponential backoff + jitter.\n * Respects `Retry-After` from RateLimitError.\n */\nexport async function withRetry<T>(\n fn: () => Promise<T>,\n options: RetryOptions,\n): Promise<T> {\n const { maxRetries, baseDelay = 500, maxDelay = 30_000 } = options;\n let lastError: unknown;\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n try {\n return await fn();\n } catch (error) {\n lastError = error;\n\n if (attempt >= maxRetries) break;\n\n // Don't retry auth errors — they won't resolve by retrying\n if (error instanceof NetSuiteError && error.code === 'AUTH_ERROR') {\n throw error;\n }\n\n // Only retry on retryable status codes or network errors\n if (error instanceof NetSuiteError && error.status != null && !isRetryableStatus(error.status)) {\n throw error;\n }\n\n let delay: number;\n if (error instanceof RateLimitError) {\n delay = error.retryAfterMs;\n } else {\n // Exponential backoff with full jitter\n const exponential = baseDelay * Math.pow(2, attempt);\n delay = Math.min(exponential, maxDelay) * Math.random();\n }\n\n await sleep(delay);\n }\n }\n\n throw lastError;\n}\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import { buildAuthorizationHeader } from '../auth/headers.js';\nimport { resolveConfig, getRealm, type ResolvedConfig } from '../config.js';\nimport type { NetSuiteConfig, RequestOptions, NetSuiteResponse } from '../types.js';\nimport { NetSuiteError, AuthError, RateLimitError, TimeoutError } from './errors.js';\nimport { RequestThrottler } from './request-throttler.js';\nimport { withRetry } from './retry.js';\n\n/**\n * Core HTTP client for the NetSuite REST API.\n * Handles OAuth signing, retries, rate limiting, and timeouts.\n */\nexport class NetSuiteClient {\n private readonly config: ResolvedConfig;\n private readonly throttler: RequestThrottler;\n\n constructor(config: NetSuiteConfig) {\n this.config = resolveConfig(config);\n this.throttler = new RequestThrottler({\n concurrency: this.config.concurrency,\n requestsPerSecond: this.config.requestsPerSecond,\n burstSize: this.config.burstSize,\n });\n }\n\n /** Make an authenticated request to the NetSuite REST API. */\n async request<T = unknown>(options: RequestOptions): Promise<NetSuiteResponse<T>> {\n const shouldRetry = options.retry ?? options.method === 'GET';\n return this.throttler.run(() =>\n withRetry(\n () => this.executeRequest<T>(options),\n { maxRetries: shouldRetry ? this.config.maxRetries : 0 },\n ),\n );\n }\n\n /** Get the resolved base URL. */\n get baseUrl(): string {\n return this.config.baseUrl;\n }\n\n /** Get the resolved config (read-only). */\n get resolvedConfig(): Readonly<ResolvedConfig> {\n return this.config;\n }\n\n private async executeRequest<T>(options: RequestOptions): Promise<NetSuiteResponse<T>> {\n const url = this.buildUrl(options.path, options.query);\n const realm = getRealm(this.config.accountId);\n\n const authHeader = buildAuthorizationHeader({\n consumerKey: this.config.consumerKey,\n consumerSecret: this.config.consumerSecret,\n tokenId: this.config.tokenId,\n tokenSecret: this.config.tokenSecret,\n realm,\n method: options.method,\n url,\n });\n\n const headers: Record<string, string> = {\n Authorization: authHeader,\n 'Content-Type': 'application/json',\n Accept: 'application/json',\n ...options.headers,\n };\n\n const timeoutMs = options.timeout ?? this.config.timeout;\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\n try {\n const response = await fetch(url, {\n method: options.method,\n headers,\n body: options.body != null ? JSON.stringify(options.body) : undefined,\n signal: controller.signal,\n });\n\n clearTimeout(timeoutId);\n\n if (!response.ok) {\n await this.handleErrorResponse(response);\n }\n\n // 204 No Content — no body to parse\n const data = response.status === 204\n ? (undefined as T)\n : (await response.json()) as T;\n return { status: response.status, headers: response.headers, data };\n } catch (error) {\n clearTimeout(timeoutId);\n\n if (error instanceof NetSuiteError) throw error;\n\n if (error instanceof DOMException && error.name === 'AbortError') {\n throw new TimeoutError(timeoutMs);\n }\n\n throw new NetSuiteError(\n `Network error: ${error instanceof Error ? error.message : String(error)}`,\n undefined,\n 'NETWORK_ERROR',\n );\n }\n }\n\n private buildUrl(path: string, query?: Record<string, string>): string {\n const url = new URL(path, this.config.baseUrl);\n if (query) {\n for (const [key, value] of Object.entries(query)) {\n url.searchParams.set(key, value);\n }\n }\n return url.toString();\n }\n\n private async handleErrorResponse(response: Response): Promise<never> {\n let body: unknown;\n try {\n body = await response.json();\n } catch {\n body = await response.text().catch(() => undefined);\n }\n\n if (response.status === 401 || response.status === 403) {\n throw new AuthError(\n `Authentication failed: ${response.status} ${response.statusText}`,\n response.status,\n body,\n );\n }\n\n if (response.status === 429) {\n const retryAfter = response.headers.get('Retry-After');\n const retryMs = retryAfter ? parseInt(retryAfter, 10) * 1000 : 5000;\n throw new RateLimitError(retryMs, body);\n }\n\n throw new NetSuiteError(\n `HTTP ${response.status}: ${response.statusText}`,\n response.status,\n undefined,\n body,\n );\n }\n}\n","import type { NetSuiteClient } from '../http/client.js';\nimport type { SuiteQLResult, SuiteQLResponse, SuiteQLRow } from '../types.js';\n\nconst SUITEQL_PATH = '/services/rest/query/v1/suiteql';\n\n/**\n * Execute a SuiteQL query and return the first page of results.\n */\nexport async function executeSuiteQL<T = SuiteQLRow>(\n client: NetSuiteClient,\n query: string,\n options?: { limit?: number; offset?: number },\n): Promise<SuiteQLResult<T>> {\n const limit = options?.limit ?? 1000;\n const offset = options?.offset ?? 0;\n\n const response = await client.request<SuiteQLResponse>({\n method: 'POST',\n path: SUITEQL_PATH,\n body: { q: query },\n headers: {\n Prefer: 'transient',\n },\n query: {\n limit: limit.toString(),\n offset: offset.toString(),\n },\n retry: true, // POST-for-query is idempotent\n });\n\n // Strip HATEOAS `links` metadata from each row\n const items = (response.data.items ?? []).map(({ links, ...rest }: any) => rest) as T[];\n\n return {\n items,\n totalResults: response.data.totalResults,\n hasMore: response.data.hasMore,\n };\n}\n","import type { NetSuiteClient } from '../http/client.js';\nimport type { SuiteQLRow } from '../types.js';\nimport { executeSuiteQL } from './executor.js';\n\nexport interface PaginationOptions {\n /** Page size per request. Default: 1000. */\n pageSize?: number;\n /** Maximum total rows to fetch. Default: unlimited. */\n maxRows?: number;\n}\n\n/**\n * Execute a SuiteQL query and automatically paginate through all results.\n * Collects all pages into a single array.\n */\nexport async function executeSuiteQLPaginated<T = SuiteQLRow>(\n client: NetSuiteClient,\n query: string,\n options?: PaginationOptions,\n): Promise<T[]> {\n const pageSize = options?.pageSize ?? 1000;\n const maxRows = options?.maxRows ?? Infinity;\n const allItems: T[] = [];\n let offset = 0;\n\n while (allItems.length < maxRows) {\n const limit = Math.min(pageSize, maxRows - allItems.length);\n const result = await executeSuiteQL<T>(client, query, { limit, offset });\n\n allItems.push(...result.items);\n\n if (!result.hasMore || result.items.length === 0) {\n break;\n }\n\n offset += result.items.length;\n }\n\n return allItems;\n}\n","import type { NetSuiteClient } from '../http/client.js';\n\nconst RECORD_BASE = '/services/rest/record/v1';\n\n/**\n * Create a new record via the REST Record API.\n * POST /services/rest/record/v1/{recordType}\n */\nexport async function createRecord(\n client: NetSuiteClient,\n recordType: string,\n data: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'POST',\n path: `${RECORD_BASE}/${recordType}`,\n body: data,\n });\n return response.data;\n}\n\n/**\n * Update an existing record via the REST Record API.\n * PATCH /services/rest/record/v1/{recordType}/{id}\n */\nexport async function updateRecord(\n client: NetSuiteClient,\n recordType: string,\n id: string | number,\n data: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'PATCH',\n path: `${RECORD_BASE}/${recordType}/${id}`,\n body: data,\n });\n return response.data;\n}\n\n/**\n * Delete a record via the REST Record API.\n * DELETE /services/rest/record/v1/{recordType}/{id}\n */\nexport async function deleteRecord(\n client: NetSuiteClient,\n recordType: string,\n id: string | number,\n): Promise<void> {\n await client.request({\n method: 'DELETE',\n path: `${RECORD_BASE}/${recordType}/${id}`,\n });\n}\n\n/**\n * Upsert a record via the REST Record API (create or update by externalId).\n * PUT /services/rest/record/v1/{recordType}/eid:{externalId}\n */\nexport async function upsertRecord(\n client: NetSuiteClient,\n recordType: string,\n externalId: string,\n data: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'PUT',\n path: `${RECORD_BASE}/${recordType}/eid:${externalId}`,\n body: data,\n });\n return response.data;\n}\n\n/**\n * Get a single record by ID via the REST Record API.\n * GET /services/rest/record/v1/{recordType}/{id}\n */\nexport async function getRecord(\n client: NetSuiteClient,\n recordType: string,\n id: string | number,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'GET',\n path: `${RECORD_BASE}/${recordType}/${id}`,\n });\n return response.data;\n}\n","import type { NetSuiteClient } from '../http/client.js';\n\nconst RECORD_BASE = '/services/rest/record/v1';\nconst DEFAULT_TRANSFORM_TIMEOUT = 120_000; // 2 minutes\n\nexport interface TransformOptions {\n /** Request body (field overrides on the target record). */\n body?: Record<string, unknown>;\n /** Timeout in ms. Default: 120000 (2 minutes). */\n timeout?: number;\n}\n\nexport interface TransformResult {\n /** The internal ID of the newly created record. */\n id: string;\n /** The target record type. */\n type: string;\n}\n\n/**\n * Transform a record from one type to another via the NetSuite REST API.\n *\n * POST /services/rest/record/v1/{sourceType}/{sourceId}/!transform/{targetType}\n *\n * Uses a longer default timeout (120s) since transforms can be slow.\n * Never retries — transforms are non-idempotent mutations.\n */\nexport async function transformRecord(\n client: NetSuiteClient,\n sourceType: string,\n sourceId: string | number,\n targetType: string,\n options?: TransformOptions,\n): Promise<TransformResult> {\n const response = await client.request<Record<string, unknown>>({\n method: 'POST',\n path: `${RECORD_BASE}/${sourceType}/${sourceId}/!transform/${targetType}`,\n body: options?.body ?? {},\n timeout: options?.timeout ?? DEFAULT_TRANSFORM_TIMEOUT,\n retry: false,\n });\n\n // Extract ID from the Location header or response body\n const location = response.headers.get('Location');\n let id: string | undefined;\n\n if (location) {\n // Location: /services/rest/record/v1/{targetType}/{id}\n const match = location.match(/\\/(\\d+)$/);\n if (match) {\n id = match[1];\n }\n }\n\n // Fall back to response body if Location header doesn't have the ID\n if (!id && response.data) {\n const rawId = response.data['id'] ?? response.data['internalid'] ?? response.data['internalId'];\n if (rawId != null) {\n id = String(rawId);\n }\n }\n\n if (!id) {\n throw new Error(\n `Transform succeeded (HTTP ${response.status}) but could not extract the new record ID. ` +\n `Location header: ${location ?? '(none)'}`,\n );\n }\n\n return { id, type: targetType };\n}\n"],"mappings":"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","names":["RECORD_BASE"]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/auth/oauth.ts","../src/auth/headers.ts","../src/config.ts","../src/http/errors.ts","../src/http/rate-limiter.ts","../src/http/token-bucket.ts","../src/http/request-throttler.ts","../src/http/retry.ts","../src/http/client.ts","../src/suiteql/executor.ts","../src/suiteql/paginator.ts","../src/rest/record.ts","../src/rest/transform.ts"],"sourcesContent":["// Core client\nexport { NetSuiteClient } from './http/client.js';\n\n// SuiteQL\nexport { executeSuiteQL } from './suiteql/executor.js';\nexport { executeSuiteQLPaginated } from './suiteql/paginator.js';\nexport type { PaginationOptions } from './suiteql/paginator.js';\n\n// Auth (exposed for advanced use / testing)\nexport { buildAuthorizationHeader } from './auth/headers.js';\nexport {\n generateOAuthSignature,\n percentEncode,\n buildSignatureBaseString,\n signHmacSha256,\n generateNonce,\n generateTimestamp,\n} from './auth/oauth.js';\n\n// REST Record API\nexport { createRecord, updateRecord, deleteRecord, upsertRecord, getRecord } from './rest/record.js';\nexport { transformRecord } from './rest/transform.js';\nexport type { TransformOptions, TransformResult } from './rest/transform.js';\n\n// Config\nexport { resolveConfig, deriveBaseUrl, getRealm } from './config.js';\nexport type { ResolvedConfig } from './config.js';\n\n// Errors\nexport {\n NetSuiteError,\n AuthError,\n RateLimitError,\n TimeoutError,\n isRetryableStatus,\n} from './http/errors.js';\n\n// Rate limiter\nexport { RateLimiter } from './http/rate-limiter.js';\n\n// Token bucket + throttler\nexport { TokenBucket } from './http/token-bucket.js';\nexport type { TokenBucketOptions } from './http/token-bucket.js';\nexport { RequestThrottler } from './http/request-throttler.js';\nexport type { ThrottlerOptions } from './http/request-throttler.js';\n\n// Retry\nexport { withRetry } from './http/retry.js';\nexport type { RetryOptions } from './http/retry.js';\n\n// Types\nexport type {\n NetSuiteConfig,\n SuiteQLRow,\n SuiteQLResult,\n SuiteQLResponse,\n OAuthParams,\n RequestOptions,\n NetSuiteResponse,\n} from './types.js';\n","import { createHmac, randomBytes } from 'node:crypto';\nimport type { OAuthParams } from '../types.js';\n\n/**\n * RFC 5849 §3.6 percent-encoding.\n * Encodes all characters except unreserved (ALPHA, DIGIT, '-', '.', '_', '~').\n */\nconst RFC5849_EXTRA = /[!'()*]/g;\n\nexport function percentEncode(str: string): string {\n return encodeURIComponent(str).replace(RFC5849_EXTRA, (c) => {\n return `%${c.charCodeAt(0).toString(16).toUpperCase()}`;\n });\n}\n\n/** Generate a random nonce for OAuth requests. */\nexport function generateNonce(): string {\n return randomBytes(16).toString('hex');\n}\n\n/** Generate a Unix timestamp string. */\nexport function generateTimestamp(): string {\n return Math.floor(Date.now() / 1000).toString();\n}\n\n/**\n * Build the OAuth signature base string per RFC 5849 §3.4.1.\n */\nexport function buildSignatureBaseString(\n method: string,\n baseUrl: string,\n params: Array<[string, string]>,\n): string {\n // Sort params lexicographically by key, then by value (ASCII order per RFC 5849)\n const sorted = params.slice().sort((a, b) => {\n if (a[0]! < b[0]!) return -1;\n if (a[0]! > b[0]!) return 1;\n if (a[1]! < b[1]!) return -1;\n if (a[1]! > b[1]!) return 1;\n return 0;\n });\n\n const paramString = sorted\n .map(([k, v]) => `${percentEncode(k!)}=${percentEncode(v!)}`)\n .join('&');\n\n return [\n method.toUpperCase(),\n percentEncode(baseUrl),\n percentEncode(paramString),\n ].join('&');\n}\n\n/**\n * Sign the base string with HMAC-SHA256.\n * Signing key = percentEncode(consumerSecret) & percentEncode(tokenSecret)\n */\nexport function signHmacSha256(\n baseString: string,\n consumerSecret: string,\n tokenSecret: string,\n): string {\n const signingKey = `${percentEncode(consumerSecret)}&${percentEncode(tokenSecret)}`;\n return createHmac('sha256', signingKey).update(baseString).digest('base64');\n}\n\n/**\n * Generate the full OAuth 1.0a signature for a request.\n * Returns the signature string and the oauth params used (for header construction).\n */\nexport function generateOAuthSignature(params: OAuthParams): {\n signature: string;\n oauthParams: Record<string, string>;\n} {\n const timestamp = params.timestamp ?? generateTimestamp();\n const nonce = params.nonce ?? generateNonce();\n\n const oauthParams: Record<string, string> = {\n oauth_consumer_key: params.consumerKey,\n oauth_token: params.tokenId,\n oauth_nonce: nonce,\n oauth_timestamp: timestamp,\n oauth_signature_method: 'HMAC-SHA256',\n oauth_version: '1.0',\n };\n\n // Strip query string from URL for base string (avoid expensive URL constructor)\n const qIdx = params.url.indexOf('?');\n const baseUrl = qIdx === -1 ? params.url : params.url.slice(0, qIdx);\n\n // Collect all params: oauth params + query string params\n const allParams: Array<[string, string]> = Object.entries(oauthParams);\n if (qIdx !== -1) {\n const qs = params.url.slice(qIdx + 1);\n for (const pair of qs.split('&')) {\n const eqIdx = pair.indexOf('=');\n if (eqIdx !== -1) {\n allParams.push([decodeURIComponent(pair.slice(0, eqIdx)), decodeURIComponent(pair.slice(eqIdx + 1))]);\n }\n }\n }\n\n const baseString = buildSignatureBaseString(params.method, baseUrl, allParams);\n const signature = signHmacSha256(baseString, params.consumerSecret, params.tokenSecret);\n\n return { signature, oauthParams };\n}\n","import { generateOAuthSignature, percentEncode } from './oauth.js';\nimport type { OAuthParams } from '../types.js';\n\n/**\n * Build the OAuth Authorization header value.\n * Format: OAuth realm=\"...\", oauth_consumer_key=\"...\", ..., oauth_signature=\"...\"\n */\nexport function buildAuthorizationHeader(params: OAuthParams): string {\n const { signature, oauthParams } = generateOAuthSignature(params);\n\n const headerParams: Record<string, string> = {\n realm: params.realm,\n ...oauthParams,\n oauth_signature: signature,\n };\n\n const parts = Object.entries(headerParams)\n .map(([key, value]) => `${percentEncode(key)}=\"${percentEncode(value)}\"`)\n .join(', ');\n\n return `OAuth ${parts}`;\n}\n","import type { NetSuiteConfig } from './types.js';\n\nconst REQUIRED_FIELDS = [\n 'accountId',\n 'consumerKey',\n 'consumerSecret',\n 'tokenId',\n 'tokenSecret',\n] as const;\n\nconst DEFAULTS = {\n timeout: 30_000,\n concurrency: 5,\n maxRetries: 3,\n} as const;\n\nexport interface ResolvedConfig extends Required<Omit<NetSuiteConfig, 'baseUrl' | 'requestsPerSecond' | 'burstSize'>> {\n baseUrl: string;\n requestsPerSecond?: number;\n burstSize?: number;\n}\n\n/** Validate config and fill defaults. */\nexport function resolveConfig(config: NetSuiteConfig): ResolvedConfig {\n for (const field of REQUIRED_FIELDS) {\n if (!config[field]) {\n throw new Error(`NetSuiteConfig: \"${field}\" is required`);\n }\n }\n\n return {\n accountId: config.accountId,\n consumerKey: config.consumerKey,\n consumerSecret: config.consumerSecret,\n tokenId: config.tokenId,\n tokenSecret: config.tokenSecret,\n timeout: config.timeout ?? DEFAULTS.timeout,\n concurrency: config.concurrency ?? DEFAULTS.concurrency,\n maxRetries: config.maxRetries ?? DEFAULTS.maxRetries,\n requestsPerSecond: config.requestsPerSecond,\n burstSize: config.burstSize,\n baseUrl: config.baseUrl ?? deriveBaseUrl(config.accountId),\n };\n}\n\n/**\n * Derive the NetSuite REST API base URL from the account ID.\n * Account IDs with underscores (sandbox) have underscores replaced with hyphens.\n * Example: \"1234567_SB1\" → \"https://1234567-sb1.suitetalk.api.netsuite.com\"\n */\nexport function deriveBaseUrl(accountId: string): string {\n const normalized = accountId.toLowerCase().replace(/_/g, '-');\n return `https://${normalized}.suitetalk.api.netsuite.com`;\n}\n\n/** Get the realm (account ID in uppercase, underscores preserved). */\nexport function getRealm(accountId: string): string {\n return accountId.toUpperCase().replace(/-/g, '_');\n}\n","/** Base error class for all NetSuite connector errors. */\nexport class NetSuiteError extends Error {\n constructor(\n message: string,\n public readonly status?: number,\n public readonly code?: string,\n public readonly details?: unknown,\n ) {\n super(message);\n this.name = 'NetSuiteError';\n }\n}\n\n/** Authentication or authorization failure. */\nexport class AuthError extends NetSuiteError {\n constructor(message: string, status?: number, details?: unknown) {\n super(message, status, 'AUTH_ERROR', details);\n this.name = 'AuthError';\n }\n}\n\n/** Rate limit (429) exceeded. */\nexport class RateLimitError extends NetSuiteError {\n constructor(\n public readonly retryAfterMs: number,\n details?: unknown,\n ) {\n super(`Rate limited. Retry after ${retryAfterMs}ms`, 429, 'RATE_LIMIT', details);\n this.name = 'RateLimitError';\n }\n}\n\n/** Request timeout via AbortController. */\nexport class TimeoutError extends NetSuiteError {\n constructor(timeoutMs: number) {\n super(`Request timed out after ${timeoutMs}ms`, undefined, 'TIMEOUT');\n this.name = 'TimeoutError';\n }\n}\n\n/** HTTP status codes that are safe to retry. */\nconst RETRYABLE_STATUSES = new Set([408, 429, 502, 503, 504]);\n\n/** Check if an HTTP status code is retryable. */\nexport function isRetryableStatus(status: number): boolean {\n return RETRYABLE_STATUSES.has(status);\n}\n","/**\n * Async semaphore for concurrency governance.\n * Limits the number of in-flight requests to prevent overwhelming NetSuite.\n */\nexport class RateLimiter {\n private active = 0;\n private queue: Array<() => void> = [];\n\n constructor(private readonly maxConcurrent: number) {}\n\n /** Acquire a slot. Resolves when a slot is available. */\n async acquire(): Promise<void> {\n if (this.active < this.maxConcurrent) {\n this.active++;\n return;\n }\n\n return new Promise<void>((resolve) => {\n this.queue.push(() => {\n this.active++;\n resolve();\n });\n });\n }\n\n /** Release a slot, unblocking the next waiter if any. */\n release(): void {\n this.active--;\n const next = this.queue.shift();\n if (next) {\n next();\n }\n }\n\n /** Run an async function within the concurrency limit. */\n async run<T>(fn: () => Promise<T>): Promise<T> {\n await this.acquire();\n try {\n return await fn();\n } finally {\n this.release();\n }\n }\n\n /** Number of currently active tasks. */\n get activeCount(): number {\n return this.active;\n }\n\n /** Number of tasks waiting for a slot. */\n get waitingCount(): number {\n return this.queue.length;\n }\n}\n","export interface TokenBucketOptions {\n /** Maximum requests per second. */\n requestsPerSecond: number;\n /** Maximum burst capacity. Defaults to requestsPerSecond. */\n burstSize?: number;\n}\n\n/**\n * Token bucket rate limiter for proactive request throttling.\n * Smooths request rate to stay within NetSuite's rate limits\n * instead of reacting to 429 errors.\n */\nexport class TokenBucket {\n private tokens: number;\n private readonly maxTokens: number;\n private readonly refillRate: number; // tokens per ms\n private lastRefill: number;\n private readonly pendingTimers = new Set<ReturnType<typeof setTimeout>>();\n\n constructor(options: TokenBucketOptions) {\n this.maxTokens = options.burstSize ?? options.requestsPerSecond;\n this.refillRate = options.requestsPerSecond / 1000;\n this.tokens = this.maxTokens;\n this.lastRefill = Date.now();\n }\n\n /**\n * Acquire a token, waiting if necessary.\n * Resolves immediately if a token is available, otherwise\n * delays until the bucket refills enough for one token.\n */\n async acquire(): Promise<void> {\n this.refill();\n\n if (this.tokens >= 1) {\n this.tokens--;\n return;\n }\n\n const waitMs = (1 - this.tokens) / this.refillRate;\n await new Promise<void>((resolve) => {\n const timer = setTimeout(() => {\n this.pendingTimers.delete(timer);\n resolve();\n }, waitMs);\n this.pendingTimers.add(timer);\n });\n this.refill();\n this.tokens--;\n }\n\n /** Number of tokens currently available. */\n get availableTokens(): number {\n this.refill();\n return this.tokens;\n }\n\n /** Cancel all pending timers. Call on client teardown. */\n destroy(): void {\n for (const timer of this.pendingTimers) {\n clearTimeout(timer);\n }\n this.pendingTimers.clear();\n }\n\n private refill(): void {\n const now = Date.now();\n const elapsed = now - this.lastRefill;\n if (elapsed <= 0) return;\n\n this.tokens = Math.min(this.maxTokens, this.tokens + elapsed * this.refillRate);\n this.lastRefill = now;\n }\n}\n","import { RateLimiter } from './rate-limiter.js';\nimport { TokenBucket } from './token-bucket.js';\n\nexport interface ThrottlerOptions {\n /** Max concurrent requests. Default: 5. */\n concurrency?: number;\n /** Proactive rate limit (requests/sec). Undefined = disabled. */\n requestsPerSecond?: number;\n /** Burst capacity for the token bucket. Defaults to requestsPerSecond. */\n burstSize?: number;\n}\n\n/**\n * Composes concurrency limiting (semaphore) with proactive rate limiting (token bucket).\n * Token bucket fires first (delays to stay under rate limit), then the semaphore\n * limits parallelism.\n */\nexport class RequestThrottler {\n private readonly semaphore: RateLimiter;\n private readonly tokenBucket: TokenBucket | null;\n\n constructor(options: ThrottlerOptions = {}) {\n this.semaphore = new RateLimiter(options.concurrency ?? 5);\n this.tokenBucket =\n options.requestsPerSecond != null\n ? new TokenBucket({\n requestsPerSecond: options.requestsPerSecond,\n burstSize: options.burstSize,\n })\n : null;\n }\n\n /** Run an async function within both rate and concurrency limits. */\n async run<T>(fn: () => Promise<T>): Promise<T> {\n if (this.tokenBucket) {\n await this.tokenBucket.acquire();\n }\n return this.semaphore.run(fn);\n }\n\n /** Number of currently active tasks. */\n get activeCount(): number {\n return this.semaphore.activeCount;\n }\n\n /** Number of tasks waiting for a slot. */\n get waitingCount(): number {\n return this.semaphore.waitingCount;\n }\n\n /** Cancel pending token bucket timers. Call on client teardown. */\n destroy(): void {\n this.tokenBucket?.destroy();\n }\n}\n","import { RateLimitError, isRetryableStatus, NetSuiteError } from './errors.js';\n\nexport interface RetryOptions {\n maxRetries: number;\n /** Base delay in ms before first retry. Default: 500. */\n baseDelay?: number;\n /** Maximum delay in ms. Default: 30000. */\n maxDelay?: number;\n}\n\n/**\n * Execute a function with exponential backoff + jitter.\n * Respects `Retry-After` from RateLimitError.\n */\nexport async function withRetry<T>(\n fn: () => Promise<T>,\n options: RetryOptions,\n): Promise<T> {\n const { maxRetries, baseDelay = 500, maxDelay = 30_000 } = options;\n let lastError: unknown;\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n try {\n return await fn();\n } catch (error) {\n lastError = error;\n\n if (attempt >= maxRetries) break;\n\n // Don't retry auth errors — they won't resolve by retrying\n if (error instanceof NetSuiteError && error.code === 'AUTH_ERROR') {\n throw error;\n }\n\n // Only retry on retryable status codes or network errors\n if (error instanceof NetSuiteError && error.status != null && !isRetryableStatus(error.status)) {\n throw error;\n }\n\n let delay: number;\n if (error instanceof RateLimitError) {\n delay = error.retryAfterMs;\n } else {\n // Exponential backoff with full jitter\n const exponential = baseDelay * Math.pow(2, attempt);\n delay = Math.min(exponential, maxDelay) * Math.random();\n }\n\n await sleep(delay);\n }\n }\n\n throw lastError;\n}\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import { buildAuthorizationHeader } from '../auth/headers.js';\nimport { resolveConfig, getRealm, type ResolvedConfig } from '../config.js';\nimport type { NetSuiteConfig, RequestOptions, NetSuiteResponse } from '../types.js';\nimport { NetSuiteError, AuthError, RateLimitError, TimeoutError } from './errors.js';\nimport { RequestThrottler } from './request-throttler.js';\nimport { withRetry } from './retry.js';\n\n/**\n * Core HTTP client for the NetSuite REST API.\n * Handles OAuth signing, retries, rate limiting, and timeouts.\n */\nexport class NetSuiteClient {\n private readonly config: ResolvedConfig;\n private readonly throttler: RequestThrottler;\n\n constructor(config: NetSuiteConfig) {\n this.config = resolveConfig(config);\n this.throttler = new RequestThrottler({\n concurrency: this.config.concurrency,\n requestsPerSecond: this.config.requestsPerSecond,\n burstSize: this.config.burstSize,\n });\n }\n\n /** Make an authenticated request to the NetSuite REST API. */\n async request<T = unknown>(options: RequestOptions): Promise<NetSuiteResponse<T>> {\n const shouldRetry = options.retry ?? options.method === 'GET';\n return this.throttler.run(() =>\n withRetry(\n () => this.executeRequest<T>(options),\n { maxRetries: shouldRetry ? this.config.maxRetries : 0 },\n ),\n );\n }\n\n /** Get the resolved base URL. */\n get baseUrl(): string {\n return this.config.baseUrl;\n }\n\n /** Get the resolved config (read-only). */\n get resolvedConfig(): Readonly<ResolvedConfig> {\n return this.config;\n }\n\n /** Release resources (cancel pending token bucket timers). */\n destroy(): void {\n this.throttler.destroy();\n }\n\n private async executeRequest<T>(options: RequestOptions): Promise<NetSuiteResponse<T>> {\n const url = this.buildUrl(options.path, options.query);\n const realm = getRealm(this.config.accountId);\n\n const authHeader = buildAuthorizationHeader({\n consumerKey: this.config.consumerKey,\n consumerSecret: this.config.consumerSecret,\n tokenId: this.config.tokenId,\n tokenSecret: this.config.tokenSecret,\n realm,\n method: options.method,\n url,\n });\n\n const headers: Record<string, string> = {\n Authorization: authHeader,\n 'Content-Type': 'application/json',\n Accept: 'application/json',\n ...options.headers,\n };\n\n const timeoutMs = options.timeout ?? this.config.timeout;\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\n try {\n const response = await fetch(url, {\n method: options.method,\n headers,\n body: options.body != null ? JSON.stringify(options.body) : undefined,\n signal: controller.signal,\n });\n\n clearTimeout(timeoutId);\n\n if (!response.ok) {\n await this.handleErrorResponse(response);\n }\n\n // 204 No Content — no body to parse\n const data = response.status === 204\n ? (undefined as T)\n : (await response.json()) as T;\n return { status: response.status, headers: response.headers, data };\n } catch (error) {\n clearTimeout(timeoutId);\n\n if (error instanceof NetSuiteError) throw error;\n\n if (error instanceof DOMException && error.name === 'AbortError') {\n throw new TimeoutError(timeoutMs);\n }\n\n throw new NetSuiteError(\n `Network error: ${error instanceof Error ? error.message : String(error)}`,\n undefined,\n 'NETWORK_ERROR',\n );\n }\n }\n\n private buildUrl(path: string, query?: Record<string, string>): string {\n const url = new URL(path, this.config.baseUrl);\n if (query) {\n for (const [key, value] of Object.entries(query)) {\n url.searchParams.set(key, value);\n }\n }\n return url.toString();\n }\n\n private async handleErrorResponse(response: Response): Promise<never> {\n let body: unknown;\n try {\n body = await response.json();\n } catch {\n body = await response.text().catch(() => undefined);\n }\n\n if (response.status === 401 || response.status === 403) {\n throw new AuthError(\n `Authentication failed: ${response.status} ${response.statusText}`,\n response.status,\n body,\n );\n }\n\n if (response.status === 429) {\n const retryAfter = response.headers.get('Retry-After');\n const retryMs = retryAfter ? parseInt(retryAfter, 10) * 1000 : 5000;\n throw new RateLimitError(retryMs, body);\n }\n\n throw new NetSuiteError(\n `HTTP ${response.status}: ${response.statusText}`,\n response.status,\n undefined,\n body,\n );\n }\n}\n","import type { NetSuiteClient } from '../http/client.js';\nimport type { SuiteQLResult, SuiteQLResponse, SuiteQLRow } from '../types.js';\n\nconst SUITEQL_PATH = '/services/rest/query/v1/suiteql';\n\n/**\n * Execute a SuiteQL query and return the first page of results.\n */\nexport async function executeSuiteQL<T = SuiteQLRow>(\n client: NetSuiteClient,\n query: string,\n options?: { limit?: number; offset?: number },\n): Promise<SuiteQLResult<T>> {\n const limit = options?.limit ?? 1000;\n const offset = options?.offset ?? 0;\n\n const response = await client.request<SuiteQLResponse>({\n method: 'POST',\n path: SUITEQL_PATH,\n body: { q: query },\n headers: {\n Prefer: 'transient',\n },\n query: {\n limit: limit.toString(),\n offset: offset.toString(),\n },\n retry: true, // POST-for-query is idempotent\n });\n\n // Strip HATEOAS `links` metadata from each row\n const items = (response.data.items ?? []).map(({ links, ...rest }: any) => rest) as T[];\n\n return {\n items,\n totalResults: response.data.totalResults,\n hasMore: response.data.hasMore,\n };\n}\n","import type { NetSuiteClient } from '../http/client.js';\nimport type { SuiteQLRow } from '../types.js';\nimport { executeSuiteQL } from './executor.js';\n\nexport interface PaginationOptions {\n /** Page size per request. Default: 1000. */\n pageSize?: number;\n /** Maximum total rows to fetch. Default: unlimited. */\n maxRows?: number;\n}\n\n/**\n * Execute a SuiteQL query and automatically paginate through all results.\n * Collects all pages into a single array.\n */\nexport async function executeSuiteQLPaginated<T = SuiteQLRow>(\n client: NetSuiteClient,\n query: string,\n options?: PaginationOptions,\n): Promise<T[]> {\n const pageSize = options?.pageSize ?? 1000;\n const maxRows = options?.maxRows ?? Infinity;\n const allItems: T[] = [];\n let offset = 0;\n\n while (allItems.length < maxRows) {\n const limit = Math.min(pageSize, maxRows - allItems.length);\n const result = await executeSuiteQL<T>(client, query, { limit, offset });\n\n allItems.push(...result.items);\n\n if (!result.hasMore || result.items.length === 0) {\n break;\n }\n\n offset += result.items.length;\n }\n\n return allItems;\n}\n","import type { NetSuiteClient } from '../http/client.js';\n\nconst RECORD_BASE = '/services/rest/record/v1';\n\n/**\n * Create a new record via the REST Record API.\n * POST /services/rest/record/v1/{recordType}\n */\nexport async function createRecord(\n client: NetSuiteClient,\n recordType: string,\n data: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'POST',\n path: `${RECORD_BASE}/${recordType}`,\n body: data,\n });\n return response.data;\n}\n\n/**\n * Update an existing record via the REST Record API.\n * PATCH /services/rest/record/v1/{recordType}/{id}\n */\nexport async function updateRecord(\n client: NetSuiteClient,\n recordType: string,\n id: string | number,\n data: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'PATCH',\n path: `${RECORD_BASE}/${recordType}/${id}`,\n body: data,\n });\n return response.data;\n}\n\n/**\n * Delete a record via the REST Record API.\n * DELETE /services/rest/record/v1/{recordType}/{id}\n */\nexport async function deleteRecord(\n client: NetSuiteClient,\n recordType: string,\n id: string | number,\n): Promise<void> {\n await client.request({\n method: 'DELETE',\n path: `${RECORD_BASE}/${recordType}/${id}`,\n });\n}\n\n/**\n * Upsert a record via the REST Record API (create or update by externalId).\n * PUT /services/rest/record/v1/{recordType}/eid:{externalId}\n */\nexport async function upsertRecord(\n client: NetSuiteClient,\n recordType: string,\n externalId: string,\n data: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'PUT',\n path: `${RECORD_BASE}/${recordType}/eid:${externalId}`,\n body: data,\n });\n return response.data;\n}\n\n/**\n * Get a single record by ID via the REST Record API.\n * GET /services/rest/record/v1/{recordType}/{id}\n */\nexport async function getRecord(\n client: NetSuiteClient,\n recordType: string,\n id: string | number,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'GET',\n path: `${RECORD_BASE}/${recordType}/${id}`,\n });\n return response.data;\n}\n","import type { NetSuiteClient } from '../http/client.js';\n\nconst RECORD_BASE = '/services/rest/record/v1';\nconst DEFAULT_TRANSFORM_TIMEOUT = 120_000; // 2 minutes\n\nexport interface TransformOptions {\n /** Request body (field overrides on the target record). */\n body?: Record<string, unknown>;\n /** Timeout in ms. Default: 120000 (2 minutes). */\n timeout?: number;\n}\n\nexport interface TransformResult {\n /** The internal ID of the newly created record. */\n id: string;\n /** The target record type. */\n type: string;\n}\n\n/**\n * Transform a record from one type to another via the NetSuite REST API.\n *\n * POST /services/rest/record/v1/{sourceType}/{sourceId}/!transform/{targetType}\n *\n * Uses a longer default timeout (120s) since transforms can be slow.\n * Never retries — transforms are non-idempotent mutations.\n */\nexport async function transformRecord(\n client: NetSuiteClient,\n sourceType: string,\n sourceId: string | number,\n targetType: string,\n options?: TransformOptions,\n): Promise<TransformResult> {\n const response = await client.request<Record<string, unknown>>({\n method: 'POST',\n path: `${RECORD_BASE}/${sourceType}/${sourceId}/!transform/${targetType}`,\n body: options?.body ?? {},\n timeout: options?.timeout ?? DEFAULT_TRANSFORM_TIMEOUT,\n retry: false,\n });\n\n // Extract ID from the Location header or response body\n const location = response.headers.get('Location');\n let id: string | undefined;\n\n if (location) {\n // Location: /services/rest/record/v1/{targetType}/{id}\n const match = location.match(/\\/(\\d+)$/);\n if (match) {\n id = match[1];\n }\n }\n\n // Fall back to response body if Location header doesn't have the ID\n if (!id && response.data) {\n const rawId = response.data['id'] ?? response.data['internalid'] ?? response.data['internalId'];\n if (rawId != null) {\n id = String(rawId);\n }\n }\n\n if (!id) {\n throw new Error(\n `Transform succeeded (HTTP ${response.status}) but could not extract the new record ID. ` +\n `Location header: ${location ?? '(none)'}`,\n );\n }\n\n return { id, type: targetType };\n}\n"],"mappings":"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","names":["RECORD_BASE"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -107,6 +107,8 @@ declare class NetSuiteClient {
|
|
|
107
107
|
get baseUrl(): string;
|
|
108
108
|
/** Get the resolved config (read-only). */
|
|
109
109
|
get resolvedConfig(): Readonly<ResolvedConfig>;
|
|
110
|
+
/** Release resources (cancel pending token bucket timers). */
|
|
111
|
+
destroy(): void;
|
|
110
112
|
private executeRequest;
|
|
111
113
|
private buildUrl;
|
|
112
114
|
private handleErrorResponse;
|
|
@@ -138,10 +140,6 @@ declare function executeSuiteQLPaginated<T = SuiteQLRow>(client: NetSuiteClient,
|
|
|
138
140
|
*/
|
|
139
141
|
declare function buildAuthorizationHeader(params: OAuthParams): string;
|
|
140
142
|
|
|
141
|
-
/**
|
|
142
|
-
* RFC 5849 §3.6 percent-encoding.
|
|
143
|
-
* Encodes all characters except unreserved (ALPHA, DIGIT, '-', '.', '_', '~').
|
|
144
|
-
*/
|
|
145
143
|
declare function percentEncode(str: string): string;
|
|
146
144
|
/** Generate a random nonce for OAuth requests. */
|
|
147
145
|
declare function generateNonce(): string;
|
|
@@ -273,6 +271,7 @@ declare class TokenBucket {
|
|
|
273
271
|
private readonly maxTokens;
|
|
274
272
|
private readonly refillRate;
|
|
275
273
|
private lastRefill;
|
|
274
|
+
private readonly pendingTimers;
|
|
276
275
|
constructor(options: TokenBucketOptions);
|
|
277
276
|
/**
|
|
278
277
|
* Acquire a token, waiting if necessary.
|
|
@@ -282,6 +281,8 @@ declare class TokenBucket {
|
|
|
282
281
|
acquire(): Promise<void>;
|
|
283
282
|
/** Number of tokens currently available. */
|
|
284
283
|
get availableTokens(): number;
|
|
284
|
+
/** Cancel all pending timers. Call on client teardown. */
|
|
285
|
+
destroy(): void;
|
|
285
286
|
private refill;
|
|
286
287
|
}
|
|
287
288
|
|
|
@@ -308,6 +309,8 @@ declare class RequestThrottler {
|
|
|
308
309
|
get activeCount(): number;
|
|
309
310
|
/** Number of tasks waiting for a slot. */
|
|
310
311
|
get waitingCount(): number;
|
|
312
|
+
/** Cancel pending token bucket timers. Call on client teardown. */
|
|
313
|
+
destroy(): void;
|
|
311
314
|
}
|
|
312
315
|
|
|
313
316
|
interface RetryOptions {
|
package/dist/index.d.ts
CHANGED
|
@@ -107,6 +107,8 @@ declare class NetSuiteClient {
|
|
|
107
107
|
get baseUrl(): string;
|
|
108
108
|
/** Get the resolved config (read-only). */
|
|
109
109
|
get resolvedConfig(): Readonly<ResolvedConfig>;
|
|
110
|
+
/** Release resources (cancel pending token bucket timers). */
|
|
111
|
+
destroy(): void;
|
|
110
112
|
private executeRequest;
|
|
111
113
|
private buildUrl;
|
|
112
114
|
private handleErrorResponse;
|
|
@@ -138,10 +140,6 @@ declare function executeSuiteQLPaginated<T = SuiteQLRow>(client: NetSuiteClient,
|
|
|
138
140
|
*/
|
|
139
141
|
declare function buildAuthorizationHeader(params: OAuthParams): string;
|
|
140
142
|
|
|
141
|
-
/**
|
|
142
|
-
* RFC 5849 §3.6 percent-encoding.
|
|
143
|
-
* Encodes all characters except unreserved (ALPHA, DIGIT, '-', '.', '_', '~').
|
|
144
|
-
*/
|
|
145
143
|
declare function percentEncode(str: string): string;
|
|
146
144
|
/** Generate a random nonce for OAuth requests. */
|
|
147
145
|
declare function generateNonce(): string;
|
|
@@ -273,6 +271,7 @@ declare class TokenBucket {
|
|
|
273
271
|
private readonly maxTokens;
|
|
274
272
|
private readonly refillRate;
|
|
275
273
|
private lastRefill;
|
|
274
|
+
private readonly pendingTimers;
|
|
276
275
|
constructor(options: TokenBucketOptions);
|
|
277
276
|
/**
|
|
278
277
|
* Acquire a token, waiting if necessary.
|
|
@@ -282,6 +281,8 @@ declare class TokenBucket {
|
|
|
282
281
|
acquire(): Promise<void>;
|
|
283
282
|
/** Number of tokens currently available. */
|
|
284
283
|
get availableTokens(): number;
|
|
284
|
+
/** Cancel all pending timers. Call on client teardown. */
|
|
285
|
+
destroy(): void;
|
|
285
286
|
private refill;
|
|
286
287
|
}
|
|
287
288
|
|
|
@@ -308,6 +309,8 @@ declare class RequestThrottler {
|
|
|
308
309
|
get activeCount(): number;
|
|
309
310
|
/** Number of tasks waiting for a slot. */
|
|
310
311
|
get waitingCount(): number;
|
|
312
|
+
/** Cancel pending token bucket timers. Call on client teardown. */
|
|
313
|
+
destroy(): void;
|
|
311
314
|
}
|
|
312
315
|
|
|
313
316
|
interface RetryOptions {
|
package/dist/index.js
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
// src/auth/oauth.ts
|
|
2
2
|
import { createHmac, randomBytes } from "crypto";
|
|
3
|
+
var RFC5849_EXTRA = /[!'()*]/g;
|
|
3
4
|
function percentEncode(str) {
|
|
4
|
-
return encodeURIComponent(str).replace(
|
|
5
|
+
return encodeURIComponent(str).replace(RFC5849_EXTRA, (c) => {
|
|
5
6
|
return `%${c.charCodeAt(0).toString(16).toUpperCase()}`;
|
|
6
7
|
});
|
|
7
8
|
}
|
|
@@ -12,9 +13,12 @@ function generateTimestamp() {
|
|
|
12
13
|
return Math.floor(Date.now() / 1e3).toString();
|
|
13
14
|
}
|
|
14
15
|
function buildSignatureBaseString(method, baseUrl, params) {
|
|
15
|
-
const sorted =
|
|
16
|
-
|
|
17
|
-
|
|
16
|
+
const sorted = params.slice().sort((a, b) => {
|
|
17
|
+
if (a[0] < b[0]) return -1;
|
|
18
|
+
if (a[0] > b[0]) return 1;
|
|
19
|
+
if (a[1] < b[1]) return -1;
|
|
20
|
+
if (a[1] > b[1]) return 1;
|
|
21
|
+
return 0;
|
|
18
22
|
});
|
|
19
23
|
const paramString = sorted.map(([k, v]) => `${percentEncode(k)}=${percentEncode(v)}`).join("&");
|
|
20
24
|
return [
|
|
@@ -38,12 +42,18 @@ function generateOAuthSignature(params) {
|
|
|
38
42
|
oauth_signature_method: "HMAC-SHA256",
|
|
39
43
|
oauth_version: "1.0"
|
|
40
44
|
};
|
|
41
|
-
const
|
|
42
|
-
const baseUrl =
|
|
45
|
+
const qIdx = params.url.indexOf("?");
|
|
46
|
+
const baseUrl = qIdx === -1 ? params.url : params.url.slice(0, qIdx);
|
|
43
47
|
const allParams = Object.entries(oauthParams);
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
48
|
+
if (qIdx !== -1) {
|
|
49
|
+
const qs = params.url.slice(qIdx + 1);
|
|
50
|
+
for (const pair of qs.split("&")) {
|
|
51
|
+
const eqIdx = pair.indexOf("=");
|
|
52
|
+
if (eqIdx !== -1) {
|
|
53
|
+
allParams.push([decodeURIComponent(pair.slice(0, eqIdx)), decodeURIComponent(pair.slice(eqIdx + 1))]);
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
}
|
|
47
57
|
const baseString = buildSignatureBaseString(params.method, baseUrl, allParams);
|
|
48
58
|
const signature = signHmacSha256(baseString, params.consumerSecret, params.tokenSecret);
|
|
49
59
|
return { signature, oauthParams };
|
|
@@ -190,6 +200,7 @@ var TokenBucket = class {
|
|
|
190
200
|
refillRate;
|
|
191
201
|
// tokens per ms
|
|
192
202
|
lastRefill;
|
|
203
|
+
pendingTimers = /* @__PURE__ */ new Set();
|
|
193
204
|
constructor(options) {
|
|
194
205
|
this.maxTokens = options.burstSize ?? options.requestsPerSecond;
|
|
195
206
|
this.refillRate = options.requestsPerSecond / 1e3;
|
|
@@ -208,7 +219,13 @@ var TokenBucket = class {
|
|
|
208
219
|
return;
|
|
209
220
|
}
|
|
210
221
|
const waitMs = (1 - this.tokens) / this.refillRate;
|
|
211
|
-
await new Promise((resolve) =>
|
|
222
|
+
await new Promise((resolve) => {
|
|
223
|
+
const timer = setTimeout(() => {
|
|
224
|
+
this.pendingTimers.delete(timer);
|
|
225
|
+
resolve();
|
|
226
|
+
}, waitMs);
|
|
227
|
+
this.pendingTimers.add(timer);
|
|
228
|
+
});
|
|
212
229
|
this.refill();
|
|
213
230
|
this.tokens--;
|
|
214
231
|
}
|
|
@@ -217,6 +234,13 @@ var TokenBucket = class {
|
|
|
217
234
|
this.refill();
|
|
218
235
|
return this.tokens;
|
|
219
236
|
}
|
|
237
|
+
/** Cancel all pending timers. Call on client teardown. */
|
|
238
|
+
destroy() {
|
|
239
|
+
for (const timer of this.pendingTimers) {
|
|
240
|
+
clearTimeout(timer);
|
|
241
|
+
}
|
|
242
|
+
this.pendingTimers.clear();
|
|
243
|
+
}
|
|
220
244
|
refill() {
|
|
221
245
|
const now = Date.now();
|
|
222
246
|
const elapsed = now - this.lastRefill;
|
|
@@ -252,6 +276,10 @@ var RequestThrottler = class {
|
|
|
252
276
|
get waitingCount() {
|
|
253
277
|
return this.semaphore.waitingCount;
|
|
254
278
|
}
|
|
279
|
+
/** Cancel pending token bucket timers. Call on client teardown. */
|
|
280
|
+
destroy() {
|
|
281
|
+
this.tokenBucket?.destroy();
|
|
282
|
+
}
|
|
255
283
|
};
|
|
256
284
|
|
|
257
285
|
// src/http/retry.ts
|
|
@@ -316,6 +344,10 @@ var NetSuiteClient = class {
|
|
|
316
344
|
get resolvedConfig() {
|
|
317
345
|
return this.config;
|
|
318
346
|
}
|
|
347
|
+
/** Release resources (cancel pending token bucket timers). */
|
|
348
|
+
destroy() {
|
|
349
|
+
this.throttler.destroy();
|
|
350
|
+
}
|
|
319
351
|
async executeRequest(options) {
|
|
320
352
|
const url = this.buildUrl(options.path, options.query);
|
|
321
353
|
const realm = getRealm(this.config.accountId);
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/auth/oauth.ts","../src/auth/headers.ts","../src/config.ts","../src/http/errors.ts","../src/http/rate-limiter.ts","../src/http/token-bucket.ts","../src/http/request-throttler.ts","../src/http/retry.ts","../src/http/client.ts","../src/suiteql/executor.ts","../src/suiteql/paginator.ts","../src/rest/record.ts","../src/rest/transform.ts"],"sourcesContent":["import { createHmac, randomBytes } from 'node:crypto';\nimport type { OAuthParams } from '../types.js';\n\n/**\n * RFC 5849 §3.6 percent-encoding.\n * Encodes all characters except unreserved (ALPHA, DIGIT, '-', '.', '_', '~').\n */\nexport function percentEncode(str: string): string {\n return encodeURIComponent(str).replace(/[!'()*]/g, (c) => {\n return `%${c.charCodeAt(0).toString(16).toUpperCase()}`;\n });\n}\n\n/** Generate a random nonce for OAuth requests. */\nexport function generateNonce(): string {\n return randomBytes(16).toString('hex');\n}\n\n/** Generate a Unix timestamp string. */\nexport function generateTimestamp(): string {\n return Math.floor(Date.now() / 1000).toString();\n}\n\n/**\n * Build the OAuth signature base string per RFC 5849 §3.4.1.\n */\nexport function buildSignatureBaseString(\n method: string,\n baseUrl: string,\n params: Array<[string, string]>,\n): string {\n // Sort params lexicographically by key, then by value\n const sorted = [...params].sort((a, b) => {\n const keyCompare = a[0]!.localeCompare(b[0]!);\n return keyCompare !== 0 ? keyCompare : a[1]!.localeCompare(b[1]!);\n });\n\n const paramString = sorted\n .map(([k, v]) => `${percentEncode(k!)}=${percentEncode(v!)}`)\n .join('&');\n\n return [\n method.toUpperCase(),\n percentEncode(baseUrl),\n percentEncode(paramString),\n ].join('&');\n}\n\n/**\n * Sign the base string with HMAC-SHA256.\n * Signing key = percentEncode(consumerSecret) & percentEncode(tokenSecret)\n */\nexport function signHmacSha256(\n baseString: string,\n consumerSecret: string,\n tokenSecret: string,\n): string {\n const signingKey = `${percentEncode(consumerSecret)}&${percentEncode(tokenSecret)}`;\n return createHmac('sha256', signingKey).update(baseString).digest('base64');\n}\n\n/**\n * Generate the full OAuth 1.0a signature for a request.\n * Returns the signature string and the oauth params used (for header construction).\n */\nexport function generateOAuthSignature(params: OAuthParams): {\n signature: string;\n oauthParams: Record<string, string>;\n} {\n const timestamp = params.timestamp ?? generateTimestamp();\n const nonce = params.nonce ?? generateNonce();\n\n const oauthParams: Record<string, string> = {\n oauth_consumer_key: params.consumerKey,\n oauth_token: params.tokenId,\n oauth_nonce: nonce,\n oauth_timestamp: timestamp,\n oauth_signature_method: 'HMAC-SHA256',\n oauth_version: '1.0',\n };\n\n // Strip query string from URL for base string\n const urlObj = new URL(params.url);\n const baseUrl = `${urlObj.protocol}//${urlObj.host}${urlObj.pathname}`;\n\n // Collect all params: oauth params + query string params\n const allParams: Array<[string, string]> = Object.entries(oauthParams);\n urlObj.searchParams.forEach((value, key) => {\n allParams.push([key, value]);\n });\n\n const baseString = buildSignatureBaseString(params.method, baseUrl, allParams);\n const signature = signHmacSha256(baseString, params.consumerSecret, params.tokenSecret);\n\n return { signature, oauthParams };\n}\n","import { generateOAuthSignature, percentEncode } from './oauth.js';\nimport type { OAuthParams } from '../types.js';\n\n/**\n * Build the OAuth Authorization header value.\n * Format: OAuth realm=\"...\", oauth_consumer_key=\"...\", ..., oauth_signature=\"...\"\n */\nexport function buildAuthorizationHeader(params: OAuthParams): string {\n const { signature, oauthParams } = generateOAuthSignature(params);\n\n const headerParams: Record<string, string> = {\n realm: params.realm,\n ...oauthParams,\n oauth_signature: signature,\n };\n\n const parts = Object.entries(headerParams)\n .map(([key, value]) => `${percentEncode(key)}=\"${percentEncode(value)}\"`)\n .join(', ');\n\n return `OAuth ${parts}`;\n}\n","import type { NetSuiteConfig } from './types.js';\n\nconst REQUIRED_FIELDS = [\n 'accountId',\n 'consumerKey',\n 'consumerSecret',\n 'tokenId',\n 'tokenSecret',\n] as const;\n\nconst DEFAULTS = {\n timeout: 30_000,\n concurrency: 5,\n maxRetries: 3,\n} as const;\n\nexport interface ResolvedConfig extends Required<Omit<NetSuiteConfig, 'baseUrl' | 'requestsPerSecond' | 'burstSize'>> {\n baseUrl: string;\n requestsPerSecond?: number;\n burstSize?: number;\n}\n\n/** Validate config and fill defaults. */\nexport function resolveConfig(config: NetSuiteConfig): ResolvedConfig {\n for (const field of REQUIRED_FIELDS) {\n if (!config[field]) {\n throw new Error(`NetSuiteConfig: \"${field}\" is required`);\n }\n }\n\n return {\n accountId: config.accountId,\n consumerKey: config.consumerKey,\n consumerSecret: config.consumerSecret,\n tokenId: config.tokenId,\n tokenSecret: config.tokenSecret,\n timeout: config.timeout ?? DEFAULTS.timeout,\n concurrency: config.concurrency ?? DEFAULTS.concurrency,\n maxRetries: config.maxRetries ?? DEFAULTS.maxRetries,\n requestsPerSecond: config.requestsPerSecond,\n burstSize: config.burstSize,\n baseUrl: config.baseUrl ?? deriveBaseUrl(config.accountId),\n };\n}\n\n/**\n * Derive the NetSuite REST API base URL from the account ID.\n * Account IDs with underscores (sandbox) have underscores replaced with hyphens.\n * Example: \"1234567_SB1\" → \"https://1234567-sb1.suitetalk.api.netsuite.com\"\n */\nexport function deriveBaseUrl(accountId: string): string {\n const normalized = accountId.toLowerCase().replace(/_/g, '-');\n return `https://${normalized}.suitetalk.api.netsuite.com`;\n}\n\n/** Get the realm (account ID in uppercase, underscores preserved). */\nexport function getRealm(accountId: string): string {\n return accountId.toUpperCase().replace(/-/g, '_');\n}\n","/** Base error class for all NetSuite connector errors. */\nexport class NetSuiteError extends Error {\n constructor(\n message: string,\n public readonly status?: number,\n public readonly code?: string,\n public readonly details?: unknown,\n ) {\n super(message);\n this.name = 'NetSuiteError';\n }\n}\n\n/** Authentication or authorization failure. */\nexport class AuthError extends NetSuiteError {\n constructor(message: string, status?: number, details?: unknown) {\n super(message, status, 'AUTH_ERROR', details);\n this.name = 'AuthError';\n }\n}\n\n/** Rate limit (429) exceeded. */\nexport class RateLimitError extends NetSuiteError {\n constructor(\n public readonly retryAfterMs: number,\n details?: unknown,\n ) {\n super(`Rate limited. Retry after ${retryAfterMs}ms`, 429, 'RATE_LIMIT', details);\n this.name = 'RateLimitError';\n }\n}\n\n/** Request timeout via AbortController. */\nexport class TimeoutError extends NetSuiteError {\n constructor(timeoutMs: number) {\n super(`Request timed out after ${timeoutMs}ms`, undefined, 'TIMEOUT');\n this.name = 'TimeoutError';\n }\n}\n\n/** HTTP status codes that are safe to retry. */\nconst RETRYABLE_STATUSES = new Set([408, 429, 502, 503, 504]);\n\n/** Check if an HTTP status code is retryable. */\nexport function isRetryableStatus(status: number): boolean {\n return RETRYABLE_STATUSES.has(status);\n}\n","/**\n * Async semaphore for concurrency governance.\n * Limits the number of in-flight requests to prevent overwhelming NetSuite.\n */\nexport class RateLimiter {\n private active = 0;\n private queue: Array<() => void> = [];\n\n constructor(private readonly maxConcurrent: number) {}\n\n /** Acquire a slot. Resolves when a slot is available. */\n async acquire(): Promise<void> {\n if (this.active < this.maxConcurrent) {\n this.active++;\n return;\n }\n\n return new Promise<void>((resolve) => {\n this.queue.push(() => {\n this.active++;\n resolve();\n });\n });\n }\n\n /** Release a slot, unblocking the next waiter if any. */\n release(): void {\n this.active--;\n const next = this.queue.shift();\n if (next) {\n next();\n }\n }\n\n /** Run an async function within the concurrency limit. */\n async run<T>(fn: () => Promise<T>): Promise<T> {\n await this.acquire();\n try {\n return await fn();\n } finally {\n this.release();\n }\n }\n\n /** Number of currently active tasks. */\n get activeCount(): number {\n return this.active;\n }\n\n /** Number of tasks waiting for a slot. */\n get waitingCount(): number {\n return this.queue.length;\n }\n}\n","export interface TokenBucketOptions {\n /** Maximum requests per second. */\n requestsPerSecond: number;\n /** Maximum burst capacity. Defaults to requestsPerSecond. */\n burstSize?: number;\n}\n\n/**\n * Token bucket rate limiter for proactive request throttling.\n * Smooths request rate to stay within NetSuite's rate limits\n * instead of reacting to 429 errors.\n */\nexport class TokenBucket {\n private tokens: number;\n private readonly maxTokens: number;\n private readonly refillRate: number; // tokens per ms\n private lastRefill: number;\n\n constructor(options: TokenBucketOptions) {\n this.maxTokens = options.burstSize ?? options.requestsPerSecond;\n this.refillRate = options.requestsPerSecond / 1000;\n this.tokens = this.maxTokens;\n this.lastRefill = Date.now();\n }\n\n /**\n * Acquire a token, waiting if necessary.\n * Resolves immediately if a token is available, otherwise\n * delays until the bucket refills enough for one token.\n */\n async acquire(): Promise<void> {\n this.refill();\n\n if (this.tokens >= 1) {\n this.tokens--;\n return;\n }\n\n const waitMs = (1 - this.tokens) / this.refillRate;\n await new Promise<void>((resolve) => setTimeout(resolve, waitMs));\n this.refill();\n this.tokens--;\n }\n\n /** Number of tokens currently available. */\n get availableTokens(): number {\n this.refill();\n return this.tokens;\n }\n\n private refill(): void {\n const now = Date.now();\n const elapsed = now - this.lastRefill;\n if (elapsed <= 0) return;\n\n this.tokens = Math.min(this.maxTokens, this.tokens + elapsed * this.refillRate);\n this.lastRefill = now;\n }\n}\n","import { RateLimiter } from './rate-limiter.js';\nimport { TokenBucket } from './token-bucket.js';\n\nexport interface ThrottlerOptions {\n /** Max concurrent requests. Default: 5. */\n concurrency?: number;\n /** Proactive rate limit (requests/sec). Undefined = disabled. */\n requestsPerSecond?: number;\n /** Burst capacity for the token bucket. Defaults to requestsPerSecond. */\n burstSize?: number;\n}\n\n/**\n * Composes concurrency limiting (semaphore) with proactive rate limiting (token bucket).\n * Token bucket fires first (delays to stay under rate limit), then the semaphore\n * limits parallelism.\n */\nexport class RequestThrottler {\n private readonly semaphore: RateLimiter;\n private readonly tokenBucket: TokenBucket | null;\n\n constructor(options: ThrottlerOptions = {}) {\n this.semaphore = new RateLimiter(options.concurrency ?? 5);\n this.tokenBucket =\n options.requestsPerSecond != null\n ? new TokenBucket({\n requestsPerSecond: options.requestsPerSecond,\n burstSize: options.burstSize,\n })\n : null;\n }\n\n /** Run an async function within both rate and concurrency limits. */\n async run<T>(fn: () => Promise<T>): Promise<T> {\n if (this.tokenBucket) {\n await this.tokenBucket.acquire();\n }\n return this.semaphore.run(fn);\n }\n\n /** Number of currently active tasks. */\n get activeCount(): number {\n return this.semaphore.activeCount;\n }\n\n /** Number of tasks waiting for a slot. */\n get waitingCount(): number {\n return this.semaphore.waitingCount;\n }\n}\n","import { RateLimitError, isRetryableStatus, NetSuiteError } from './errors.js';\n\nexport interface RetryOptions {\n maxRetries: number;\n /** Base delay in ms before first retry. Default: 500. */\n baseDelay?: number;\n /** Maximum delay in ms. Default: 30000. */\n maxDelay?: number;\n}\n\n/**\n * Execute a function with exponential backoff + jitter.\n * Respects `Retry-After` from RateLimitError.\n */\nexport async function withRetry<T>(\n fn: () => Promise<T>,\n options: RetryOptions,\n): Promise<T> {\n const { maxRetries, baseDelay = 500, maxDelay = 30_000 } = options;\n let lastError: unknown;\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n try {\n return await fn();\n } catch (error) {\n lastError = error;\n\n if (attempt >= maxRetries) break;\n\n // Don't retry auth errors — they won't resolve by retrying\n if (error instanceof NetSuiteError && error.code === 'AUTH_ERROR') {\n throw error;\n }\n\n // Only retry on retryable status codes or network errors\n if (error instanceof NetSuiteError && error.status != null && !isRetryableStatus(error.status)) {\n throw error;\n }\n\n let delay: number;\n if (error instanceof RateLimitError) {\n delay = error.retryAfterMs;\n } else {\n // Exponential backoff with full jitter\n const exponential = baseDelay * Math.pow(2, attempt);\n delay = Math.min(exponential, maxDelay) * Math.random();\n }\n\n await sleep(delay);\n }\n }\n\n throw lastError;\n}\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import { buildAuthorizationHeader } from '../auth/headers.js';\nimport { resolveConfig, getRealm, type ResolvedConfig } from '../config.js';\nimport type { NetSuiteConfig, RequestOptions, NetSuiteResponse } from '../types.js';\nimport { NetSuiteError, AuthError, RateLimitError, TimeoutError } from './errors.js';\nimport { RequestThrottler } from './request-throttler.js';\nimport { withRetry } from './retry.js';\n\n/**\n * Core HTTP client for the NetSuite REST API.\n * Handles OAuth signing, retries, rate limiting, and timeouts.\n */\nexport class NetSuiteClient {\n private readonly config: ResolvedConfig;\n private readonly throttler: RequestThrottler;\n\n constructor(config: NetSuiteConfig) {\n this.config = resolveConfig(config);\n this.throttler = new RequestThrottler({\n concurrency: this.config.concurrency,\n requestsPerSecond: this.config.requestsPerSecond,\n burstSize: this.config.burstSize,\n });\n }\n\n /** Make an authenticated request to the NetSuite REST API. */\n async request<T = unknown>(options: RequestOptions): Promise<NetSuiteResponse<T>> {\n const shouldRetry = options.retry ?? options.method === 'GET';\n return this.throttler.run(() =>\n withRetry(\n () => this.executeRequest<T>(options),\n { maxRetries: shouldRetry ? this.config.maxRetries : 0 },\n ),\n );\n }\n\n /** Get the resolved base URL. */\n get baseUrl(): string {\n return this.config.baseUrl;\n }\n\n /** Get the resolved config (read-only). */\n get resolvedConfig(): Readonly<ResolvedConfig> {\n return this.config;\n }\n\n private async executeRequest<T>(options: RequestOptions): Promise<NetSuiteResponse<T>> {\n const url = this.buildUrl(options.path, options.query);\n const realm = getRealm(this.config.accountId);\n\n const authHeader = buildAuthorizationHeader({\n consumerKey: this.config.consumerKey,\n consumerSecret: this.config.consumerSecret,\n tokenId: this.config.tokenId,\n tokenSecret: this.config.tokenSecret,\n realm,\n method: options.method,\n url,\n });\n\n const headers: Record<string, string> = {\n Authorization: authHeader,\n 'Content-Type': 'application/json',\n Accept: 'application/json',\n ...options.headers,\n };\n\n const timeoutMs = options.timeout ?? this.config.timeout;\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\n try {\n const response = await fetch(url, {\n method: options.method,\n headers,\n body: options.body != null ? JSON.stringify(options.body) : undefined,\n signal: controller.signal,\n });\n\n clearTimeout(timeoutId);\n\n if (!response.ok) {\n await this.handleErrorResponse(response);\n }\n\n // 204 No Content — no body to parse\n const data = response.status === 204\n ? (undefined as T)\n : (await response.json()) as T;\n return { status: response.status, headers: response.headers, data };\n } catch (error) {\n clearTimeout(timeoutId);\n\n if (error instanceof NetSuiteError) throw error;\n\n if (error instanceof DOMException && error.name === 'AbortError') {\n throw new TimeoutError(timeoutMs);\n }\n\n throw new NetSuiteError(\n `Network error: ${error instanceof Error ? error.message : String(error)}`,\n undefined,\n 'NETWORK_ERROR',\n );\n }\n }\n\n private buildUrl(path: string, query?: Record<string, string>): string {\n const url = new URL(path, this.config.baseUrl);\n if (query) {\n for (const [key, value] of Object.entries(query)) {\n url.searchParams.set(key, value);\n }\n }\n return url.toString();\n }\n\n private async handleErrorResponse(response: Response): Promise<never> {\n let body: unknown;\n try {\n body = await response.json();\n } catch {\n body = await response.text().catch(() => undefined);\n }\n\n if (response.status === 401 || response.status === 403) {\n throw new AuthError(\n `Authentication failed: ${response.status} ${response.statusText}`,\n response.status,\n body,\n );\n }\n\n if (response.status === 429) {\n const retryAfter = response.headers.get('Retry-After');\n const retryMs = retryAfter ? parseInt(retryAfter, 10) * 1000 : 5000;\n throw new RateLimitError(retryMs, body);\n }\n\n throw new NetSuiteError(\n `HTTP ${response.status}: ${response.statusText}`,\n response.status,\n undefined,\n body,\n );\n }\n}\n","import type { NetSuiteClient } from '../http/client.js';\nimport type { SuiteQLResult, SuiteQLResponse, SuiteQLRow } from '../types.js';\n\nconst SUITEQL_PATH = '/services/rest/query/v1/suiteql';\n\n/**\n * Execute a SuiteQL query and return the first page of results.\n */\nexport async function executeSuiteQL<T = SuiteQLRow>(\n client: NetSuiteClient,\n query: string,\n options?: { limit?: number; offset?: number },\n): Promise<SuiteQLResult<T>> {\n const limit = options?.limit ?? 1000;\n const offset = options?.offset ?? 0;\n\n const response = await client.request<SuiteQLResponse>({\n method: 'POST',\n path: SUITEQL_PATH,\n body: { q: query },\n headers: {\n Prefer: 'transient',\n },\n query: {\n limit: limit.toString(),\n offset: offset.toString(),\n },\n retry: true, // POST-for-query is idempotent\n });\n\n // Strip HATEOAS `links` metadata from each row\n const items = (response.data.items ?? []).map(({ links, ...rest }: any) => rest) as T[];\n\n return {\n items,\n totalResults: response.data.totalResults,\n hasMore: response.data.hasMore,\n };\n}\n","import type { NetSuiteClient } from '../http/client.js';\nimport type { SuiteQLRow } from '../types.js';\nimport { executeSuiteQL } from './executor.js';\n\nexport interface PaginationOptions {\n /** Page size per request. Default: 1000. */\n pageSize?: number;\n /** Maximum total rows to fetch. Default: unlimited. */\n maxRows?: number;\n}\n\n/**\n * Execute a SuiteQL query and automatically paginate through all results.\n * Collects all pages into a single array.\n */\nexport async function executeSuiteQLPaginated<T = SuiteQLRow>(\n client: NetSuiteClient,\n query: string,\n options?: PaginationOptions,\n): Promise<T[]> {\n const pageSize = options?.pageSize ?? 1000;\n const maxRows = options?.maxRows ?? Infinity;\n const allItems: T[] = [];\n let offset = 0;\n\n while (allItems.length < maxRows) {\n const limit = Math.min(pageSize, maxRows - allItems.length);\n const result = await executeSuiteQL<T>(client, query, { limit, offset });\n\n allItems.push(...result.items);\n\n if (!result.hasMore || result.items.length === 0) {\n break;\n }\n\n offset += result.items.length;\n }\n\n return allItems;\n}\n","import type { NetSuiteClient } from '../http/client.js';\n\nconst RECORD_BASE = '/services/rest/record/v1';\n\n/**\n * Create a new record via the REST Record API.\n * POST /services/rest/record/v1/{recordType}\n */\nexport async function createRecord(\n client: NetSuiteClient,\n recordType: string,\n data: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'POST',\n path: `${RECORD_BASE}/${recordType}`,\n body: data,\n });\n return response.data;\n}\n\n/**\n * Update an existing record via the REST Record API.\n * PATCH /services/rest/record/v1/{recordType}/{id}\n */\nexport async function updateRecord(\n client: NetSuiteClient,\n recordType: string,\n id: string | number,\n data: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'PATCH',\n path: `${RECORD_BASE}/${recordType}/${id}`,\n body: data,\n });\n return response.data;\n}\n\n/**\n * Delete a record via the REST Record API.\n * DELETE /services/rest/record/v1/{recordType}/{id}\n */\nexport async function deleteRecord(\n client: NetSuiteClient,\n recordType: string,\n id: string | number,\n): Promise<void> {\n await client.request({\n method: 'DELETE',\n path: `${RECORD_BASE}/${recordType}/${id}`,\n });\n}\n\n/**\n * Upsert a record via the REST Record API (create or update by externalId).\n * PUT /services/rest/record/v1/{recordType}/eid:{externalId}\n */\nexport async function upsertRecord(\n client: NetSuiteClient,\n recordType: string,\n externalId: string,\n data: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'PUT',\n path: `${RECORD_BASE}/${recordType}/eid:${externalId}`,\n body: data,\n });\n return response.data;\n}\n\n/**\n * Get a single record by ID via the REST Record API.\n * GET /services/rest/record/v1/{recordType}/{id}\n */\nexport async function getRecord(\n client: NetSuiteClient,\n recordType: string,\n id: string | number,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'GET',\n path: `${RECORD_BASE}/${recordType}/${id}`,\n });\n return response.data;\n}\n","import type { NetSuiteClient } from '../http/client.js';\n\nconst RECORD_BASE = '/services/rest/record/v1';\nconst DEFAULT_TRANSFORM_TIMEOUT = 120_000; // 2 minutes\n\nexport interface TransformOptions {\n /** Request body (field overrides on the target record). */\n body?: Record<string, unknown>;\n /** Timeout in ms. Default: 120000 (2 minutes). */\n timeout?: number;\n}\n\nexport interface TransformResult {\n /** The internal ID of the newly created record. */\n id: string;\n /** The target record type. */\n type: string;\n}\n\n/**\n * Transform a record from one type to another via the NetSuite REST API.\n *\n * POST /services/rest/record/v1/{sourceType}/{sourceId}/!transform/{targetType}\n *\n * Uses a longer default timeout (120s) since transforms can be slow.\n * Never retries — transforms are non-idempotent mutations.\n */\nexport async function transformRecord(\n client: NetSuiteClient,\n sourceType: string,\n sourceId: string | number,\n targetType: string,\n options?: TransformOptions,\n): Promise<TransformResult> {\n const response = await client.request<Record<string, unknown>>({\n method: 'POST',\n path: `${RECORD_BASE}/${sourceType}/${sourceId}/!transform/${targetType}`,\n body: options?.body ?? {},\n timeout: options?.timeout ?? DEFAULT_TRANSFORM_TIMEOUT,\n retry: false,\n });\n\n // Extract ID from the Location header or response body\n const location = response.headers.get('Location');\n let id: string | undefined;\n\n if (location) {\n // Location: /services/rest/record/v1/{targetType}/{id}\n const match = location.match(/\\/(\\d+)$/);\n if (match) {\n id = match[1];\n }\n }\n\n // Fall back to response body if Location header doesn't have the ID\n if (!id && response.data) {\n const rawId = response.data['id'] ?? response.data['internalid'] ?? response.data['internalId'];\n if (rawId != null) {\n id = String(rawId);\n }\n }\n\n if (!id) {\n throw new Error(\n `Transform succeeded (HTTP ${response.status}) but could not extract the new record ID. ` +\n `Location header: ${location ?? '(none)'}`,\n );\n }\n\n return { id, type: targetType };\n}\n"],"mappings":"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","names":["RECORD_BASE"]}
|
|
1
|
+
{"version":3,"sources":["../src/auth/oauth.ts","../src/auth/headers.ts","../src/config.ts","../src/http/errors.ts","../src/http/rate-limiter.ts","../src/http/token-bucket.ts","../src/http/request-throttler.ts","../src/http/retry.ts","../src/http/client.ts","../src/suiteql/executor.ts","../src/suiteql/paginator.ts","../src/rest/record.ts","../src/rest/transform.ts"],"sourcesContent":["import { createHmac, randomBytes } from 'node:crypto';\nimport type { OAuthParams } from '../types.js';\n\n/**\n * RFC 5849 §3.6 percent-encoding.\n * Encodes all characters except unreserved (ALPHA, DIGIT, '-', '.', '_', '~').\n */\nconst RFC5849_EXTRA = /[!'()*]/g;\n\nexport function percentEncode(str: string): string {\n return encodeURIComponent(str).replace(RFC5849_EXTRA, (c) => {\n return `%${c.charCodeAt(0).toString(16).toUpperCase()}`;\n });\n}\n\n/** Generate a random nonce for OAuth requests. */\nexport function generateNonce(): string {\n return randomBytes(16).toString('hex');\n}\n\n/** Generate a Unix timestamp string. */\nexport function generateTimestamp(): string {\n return Math.floor(Date.now() / 1000).toString();\n}\n\n/**\n * Build the OAuth signature base string per RFC 5849 §3.4.1.\n */\nexport function buildSignatureBaseString(\n method: string,\n baseUrl: string,\n params: Array<[string, string]>,\n): string {\n // Sort params lexicographically by key, then by value (ASCII order per RFC 5849)\n const sorted = params.slice().sort((a, b) => {\n if (a[0]! < b[0]!) return -1;\n if (a[0]! > b[0]!) return 1;\n if (a[1]! < b[1]!) return -1;\n if (a[1]! > b[1]!) return 1;\n return 0;\n });\n\n const paramString = sorted\n .map(([k, v]) => `${percentEncode(k!)}=${percentEncode(v!)}`)\n .join('&');\n\n return [\n method.toUpperCase(),\n percentEncode(baseUrl),\n percentEncode(paramString),\n ].join('&');\n}\n\n/**\n * Sign the base string with HMAC-SHA256.\n * Signing key = percentEncode(consumerSecret) & percentEncode(tokenSecret)\n */\nexport function signHmacSha256(\n baseString: string,\n consumerSecret: string,\n tokenSecret: string,\n): string {\n const signingKey = `${percentEncode(consumerSecret)}&${percentEncode(tokenSecret)}`;\n return createHmac('sha256', signingKey).update(baseString).digest('base64');\n}\n\n/**\n * Generate the full OAuth 1.0a signature for a request.\n * Returns the signature string and the oauth params used (for header construction).\n */\nexport function generateOAuthSignature(params: OAuthParams): {\n signature: string;\n oauthParams: Record<string, string>;\n} {\n const timestamp = params.timestamp ?? generateTimestamp();\n const nonce = params.nonce ?? generateNonce();\n\n const oauthParams: Record<string, string> = {\n oauth_consumer_key: params.consumerKey,\n oauth_token: params.tokenId,\n oauth_nonce: nonce,\n oauth_timestamp: timestamp,\n oauth_signature_method: 'HMAC-SHA256',\n oauth_version: '1.0',\n };\n\n // Strip query string from URL for base string (avoid expensive URL constructor)\n const qIdx = params.url.indexOf('?');\n const baseUrl = qIdx === -1 ? params.url : params.url.slice(0, qIdx);\n\n // Collect all params: oauth params + query string params\n const allParams: Array<[string, string]> = Object.entries(oauthParams);\n if (qIdx !== -1) {\n const qs = params.url.slice(qIdx + 1);\n for (const pair of qs.split('&')) {\n const eqIdx = pair.indexOf('=');\n if (eqIdx !== -1) {\n allParams.push([decodeURIComponent(pair.slice(0, eqIdx)), decodeURIComponent(pair.slice(eqIdx + 1))]);\n }\n }\n }\n\n const baseString = buildSignatureBaseString(params.method, baseUrl, allParams);\n const signature = signHmacSha256(baseString, params.consumerSecret, params.tokenSecret);\n\n return { signature, oauthParams };\n}\n","import { generateOAuthSignature, percentEncode } from './oauth.js';\nimport type { OAuthParams } from '../types.js';\n\n/**\n * Build the OAuth Authorization header value.\n * Format: OAuth realm=\"...\", oauth_consumer_key=\"...\", ..., oauth_signature=\"...\"\n */\nexport function buildAuthorizationHeader(params: OAuthParams): string {\n const { signature, oauthParams } = generateOAuthSignature(params);\n\n const headerParams: Record<string, string> = {\n realm: params.realm,\n ...oauthParams,\n oauth_signature: signature,\n };\n\n const parts = Object.entries(headerParams)\n .map(([key, value]) => `${percentEncode(key)}=\"${percentEncode(value)}\"`)\n .join(', ');\n\n return `OAuth ${parts}`;\n}\n","import type { NetSuiteConfig } from './types.js';\n\nconst REQUIRED_FIELDS = [\n 'accountId',\n 'consumerKey',\n 'consumerSecret',\n 'tokenId',\n 'tokenSecret',\n] as const;\n\nconst DEFAULTS = {\n timeout: 30_000,\n concurrency: 5,\n maxRetries: 3,\n} as const;\n\nexport interface ResolvedConfig extends Required<Omit<NetSuiteConfig, 'baseUrl' | 'requestsPerSecond' | 'burstSize'>> {\n baseUrl: string;\n requestsPerSecond?: number;\n burstSize?: number;\n}\n\n/** Validate config and fill defaults. */\nexport function resolveConfig(config: NetSuiteConfig): ResolvedConfig {\n for (const field of REQUIRED_FIELDS) {\n if (!config[field]) {\n throw new Error(`NetSuiteConfig: \"${field}\" is required`);\n }\n }\n\n return {\n accountId: config.accountId,\n consumerKey: config.consumerKey,\n consumerSecret: config.consumerSecret,\n tokenId: config.tokenId,\n tokenSecret: config.tokenSecret,\n timeout: config.timeout ?? DEFAULTS.timeout,\n concurrency: config.concurrency ?? DEFAULTS.concurrency,\n maxRetries: config.maxRetries ?? DEFAULTS.maxRetries,\n requestsPerSecond: config.requestsPerSecond,\n burstSize: config.burstSize,\n baseUrl: config.baseUrl ?? deriveBaseUrl(config.accountId),\n };\n}\n\n/**\n * Derive the NetSuite REST API base URL from the account ID.\n * Account IDs with underscores (sandbox) have underscores replaced with hyphens.\n * Example: \"1234567_SB1\" → \"https://1234567-sb1.suitetalk.api.netsuite.com\"\n */\nexport function deriveBaseUrl(accountId: string): string {\n const normalized = accountId.toLowerCase().replace(/_/g, '-');\n return `https://${normalized}.suitetalk.api.netsuite.com`;\n}\n\n/** Get the realm (account ID in uppercase, underscores preserved). */\nexport function getRealm(accountId: string): string {\n return accountId.toUpperCase().replace(/-/g, '_');\n}\n","/** Base error class for all NetSuite connector errors. */\nexport class NetSuiteError extends Error {\n constructor(\n message: string,\n public readonly status?: number,\n public readonly code?: string,\n public readonly details?: unknown,\n ) {\n super(message);\n this.name = 'NetSuiteError';\n }\n}\n\n/** Authentication or authorization failure. */\nexport class AuthError extends NetSuiteError {\n constructor(message: string, status?: number, details?: unknown) {\n super(message, status, 'AUTH_ERROR', details);\n this.name = 'AuthError';\n }\n}\n\n/** Rate limit (429) exceeded. */\nexport class RateLimitError extends NetSuiteError {\n constructor(\n public readonly retryAfterMs: number,\n details?: unknown,\n ) {\n super(`Rate limited. Retry after ${retryAfterMs}ms`, 429, 'RATE_LIMIT', details);\n this.name = 'RateLimitError';\n }\n}\n\n/** Request timeout via AbortController. */\nexport class TimeoutError extends NetSuiteError {\n constructor(timeoutMs: number) {\n super(`Request timed out after ${timeoutMs}ms`, undefined, 'TIMEOUT');\n this.name = 'TimeoutError';\n }\n}\n\n/** HTTP status codes that are safe to retry. */\nconst RETRYABLE_STATUSES = new Set([408, 429, 502, 503, 504]);\n\n/** Check if an HTTP status code is retryable. */\nexport function isRetryableStatus(status: number): boolean {\n return RETRYABLE_STATUSES.has(status);\n}\n","/**\n * Async semaphore for concurrency governance.\n * Limits the number of in-flight requests to prevent overwhelming NetSuite.\n */\nexport class RateLimiter {\n private active = 0;\n private queue: Array<() => void> = [];\n\n constructor(private readonly maxConcurrent: number) {}\n\n /** Acquire a slot. Resolves when a slot is available. */\n async acquire(): Promise<void> {\n if (this.active < this.maxConcurrent) {\n this.active++;\n return;\n }\n\n return new Promise<void>((resolve) => {\n this.queue.push(() => {\n this.active++;\n resolve();\n });\n });\n }\n\n /** Release a slot, unblocking the next waiter if any. */\n release(): void {\n this.active--;\n const next = this.queue.shift();\n if (next) {\n next();\n }\n }\n\n /** Run an async function within the concurrency limit. */\n async run<T>(fn: () => Promise<T>): Promise<T> {\n await this.acquire();\n try {\n return await fn();\n } finally {\n this.release();\n }\n }\n\n /** Number of currently active tasks. */\n get activeCount(): number {\n return this.active;\n }\n\n /** Number of tasks waiting for a slot. */\n get waitingCount(): number {\n return this.queue.length;\n }\n}\n","export interface TokenBucketOptions {\n /** Maximum requests per second. */\n requestsPerSecond: number;\n /** Maximum burst capacity. Defaults to requestsPerSecond. */\n burstSize?: number;\n}\n\n/**\n * Token bucket rate limiter for proactive request throttling.\n * Smooths request rate to stay within NetSuite's rate limits\n * instead of reacting to 429 errors.\n */\nexport class TokenBucket {\n private tokens: number;\n private readonly maxTokens: number;\n private readonly refillRate: number; // tokens per ms\n private lastRefill: number;\n private readonly pendingTimers = new Set<ReturnType<typeof setTimeout>>();\n\n constructor(options: TokenBucketOptions) {\n this.maxTokens = options.burstSize ?? options.requestsPerSecond;\n this.refillRate = options.requestsPerSecond / 1000;\n this.tokens = this.maxTokens;\n this.lastRefill = Date.now();\n }\n\n /**\n * Acquire a token, waiting if necessary.\n * Resolves immediately if a token is available, otherwise\n * delays until the bucket refills enough for one token.\n */\n async acquire(): Promise<void> {\n this.refill();\n\n if (this.tokens >= 1) {\n this.tokens--;\n return;\n }\n\n const waitMs = (1 - this.tokens) / this.refillRate;\n await new Promise<void>((resolve) => {\n const timer = setTimeout(() => {\n this.pendingTimers.delete(timer);\n resolve();\n }, waitMs);\n this.pendingTimers.add(timer);\n });\n this.refill();\n this.tokens--;\n }\n\n /** Number of tokens currently available. */\n get availableTokens(): number {\n this.refill();\n return this.tokens;\n }\n\n /** Cancel all pending timers. Call on client teardown. */\n destroy(): void {\n for (const timer of this.pendingTimers) {\n clearTimeout(timer);\n }\n this.pendingTimers.clear();\n }\n\n private refill(): void {\n const now = Date.now();\n const elapsed = now - this.lastRefill;\n if (elapsed <= 0) return;\n\n this.tokens = Math.min(this.maxTokens, this.tokens + elapsed * this.refillRate);\n this.lastRefill = now;\n }\n}\n","import { RateLimiter } from './rate-limiter.js';\nimport { TokenBucket } from './token-bucket.js';\n\nexport interface ThrottlerOptions {\n /** Max concurrent requests. Default: 5. */\n concurrency?: number;\n /** Proactive rate limit (requests/sec). Undefined = disabled. */\n requestsPerSecond?: number;\n /** Burst capacity for the token bucket. Defaults to requestsPerSecond. */\n burstSize?: number;\n}\n\n/**\n * Composes concurrency limiting (semaphore) with proactive rate limiting (token bucket).\n * Token bucket fires first (delays to stay under rate limit), then the semaphore\n * limits parallelism.\n */\nexport class RequestThrottler {\n private readonly semaphore: RateLimiter;\n private readonly tokenBucket: TokenBucket | null;\n\n constructor(options: ThrottlerOptions = {}) {\n this.semaphore = new RateLimiter(options.concurrency ?? 5);\n this.tokenBucket =\n options.requestsPerSecond != null\n ? new TokenBucket({\n requestsPerSecond: options.requestsPerSecond,\n burstSize: options.burstSize,\n })\n : null;\n }\n\n /** Run an async function within both rate and concurrency limits. */\n async run<T>(fn: () => Promise<T>): Promise<T> {\n if (this.tokenBucket) {\n await this.tokenBucket.acquire();\n }\n return this.semaphore.run(fn);\n }\n\n /** Number of currently active tasks. */\n get activeCount(): number {\n return this.semaphore.activeCount;\n }\n\n /** Number of tasks waiting for a slot. */\n get waitingCount(): number {\n return this.semaphore.waitingCount;\n }\n\n /** Cancel pending token bucket timers. Call on client teardown. */\n destroy(): void {\n this.tokenBucket?.destroy();\n }\n}\n","import { RateLimitError, isRetryableStatus, NetSuiteError } from './errors.js';\n\nexport interface RetryOptions {\n maxRetries: number;\n /** Base delay in ms before first retry. Default: 500. */\n baseDelay?: number;\n /** Maximum delay in ms. Default: 30000. */\n maxDelay?: number;\n}\n\n/**\n * Execute a function with exponential backoff + jitter.\n * Respects `Retry-After` from RateLimitError.\n */\nexport async function withRetry<T>(\n fn: () => Promise<T>,\n options: RetryOptions,\n): Promise<T> {\n const { maxRetries, baseDelay = 500, maxDelay = 30_000 } = options;\n let lastError: unknown;\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n try {\n return await fn();\n } catch (error) {\n lastError = error;\n\n if (attempt >= maxRetries) break;\n\n // Don't retry auth errors — they won't resolve by retrying\n if (error instanceof NetSuiteError && error.code === 'AUTH_ERROR') {\n throw error;\n }\n\n // Only retry on retryable status codes or network errors\n if (error instanceof NetSuiteError && error.status != null && !isRetryableStatus(error.status)) {\n throw error;\n }\n\n let delay: number;\n if (error instanceof RateLimitError) {\n delay = error.retryAfterMs;\n } else {\n // Exponential backoff with full jitter\n const exponential = baseDelay * Math.pow(2, attempt);\n delay = Math.min(exponential, maxDelay) * Math.random();\n }\n\n await sleep(delay);\n }\n }\n\n throw lastError;\n}\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import { buildAuthorizationHeader } from '../auth/headers.js';\nimport { resolveConfig, getRealm, type ResolvedConfig } from '../config.js';\nimport type { NetSuiteConfig, RequestOptions, NetSuiteResponse } from '../types.js';\nimport { NetSuiteError, AuthError, RateLimitError, TimeoutError } from './errors.js';\nimport { RequestThrottler } from './request-throttler.js';\nimport { withRetry } from './retry.js';\n\n/**\n * Core HTTP client for the NetSuite REST API.\n * Handles OAuth signing, retries, rate limiting, and timeouts.\n */\nexport class NetSuiteClient {\n private readonly config: ResolvedConfig;\n private readonly throttler: RequestThrottler;\n\n constructor(config: NetSuiteConfig) {\n this.config = resolveConfig(config);\n this.throttler = new RequestThrottler({\n concurrency: this.config.concurrency,\n requestsPerSecond: this.config.requestsPerSecond,\n burstSize: this.config.burstSize,\n });\n }\n\n /** Make an authenticated request to the NetSuite REST API. */\n async request<T = unknown>(options: RequestOptions): Promise<NetSuiteResponse<T>> {\n const shouldRetry = options.retry ?? options.method === 'GET';\n return this.throttler.run(() =>\n withRetry(\n () => this.executeRequest<T>(options),\n { maxRetries: shouldRetry ? this.config.maxRetries : 0 },\n ),\n );\n }\n\n /** Get the resolved base URL. */\n get baseUrl(): string {\n return this.config.baseUrl;\n }\n\n /** Get the resolved config (read-only). */\n get resolvedConfig(): Readonly<ResolvedConfig> {\n return this.config;\n }\n\n /** Release resources (cancel pending token bucket timers). */\n destroy(): void {\n this.throttler.destroy();\n }\n\n private async executeRequest<T>(options: RequestOptions): Promise<NetSuiteResponse<T>> {\n const url = this.buildUrl(options.path, options.query);\n const realm = getRealm(this.config.accountId);\n\n const authHeader = buildAuthorizationHeader({\n consumerKey: this.config.consumerKey,\n consumerSecret: this.config.consumerSecret,\n tokenId: this.config.tokenId,\n tokenSecret: this.config.tokenSecret,\n realm,\n method: options.method,\n url,\n });\n\n const headers: Record<string, string> = {\n Authorization: authHeader,\n 'Content-Type': 'application/json',\n Accept: 'application/json',\n ...options.headers,\n };\n\n const timeoutMs = options.timeout ?? this.config.timeout;\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\n try {\n const response = await fetch(url, {\n method: options.method,\n headers,\n body: options.body != null ? JSON.stringify(options.body) : undefined,\n signal: controller.signal,\n });\n\n clearTimeout(timeoutId);\n\n if (!response.ok) {\n await this.handleErrorResponse(response);\n }\n\n // 204 No Content — no body to parse\n const data = response.status === 204\n ? (undefined as T)\n : (await response.json()) as T;\n return { status: response.status, headers: response.headers, data };\n } catch (error) {\n clearTimeout(timeoutId);\n\n if (error instanceof NetSuiteError) throw error;\n\n if (error instanceof DOMException && error.name === 'AbortError') {\n throw new TimeoutError(timeoutMs);\n }\n\n throw new NetSuiteError(\n `Network error: ${error instanceof Error ? error.message : String(error)}`,\n undefined,\n 'NETWORK_ERROR',\n );\n }\n }\n\n private buildUrl(path: string, query?: Record<string, string>): string {\n const url = new URL(path, this.config.baseUrl);\n if (query) {\n for (const [key, value] of Object.entries(query)) {\n url.searchParams.set(key, value);\n }\n }\n return url.toString();\n }\n\n private async handleErrorResponse(response: Response): Promise<never> {\n let body: unknown;\n try {\n body = await response.json();\n } catch {\n body = await response.text().catch(() => undefined);\n }\n\n if (response.status === 401 || response.status === 403) {\n throw new AuthError(\n `Authentication failed: ${response.status} ${response.statusText}`,\n response.status,\n body,\n );\n }\n\n if (response.status === 429) {\n const retryAfter = response.headers.get('Retry-After');\n const retryMs = retryAfter ? parseInt(retryAfter, 10) * 1000 : 5000;\n throw new RateLimitError(retryMs, body);\n }\n\n throw new NetSuiteError(\n `HTTP ${response.status}: ${response.statusText}`,\n response.status,\n undefined,\n body,\n );\n }\n}\n","import type { NetSuiteClient } from '../http/client.js';\nimport type { SuiteQLResult, SuiteQLResponse, SuiteQLRow } from '../types.js';\n\nconst SUITEQL_PATH = '/services/rest/query/v1/suiteql';\n\n/**\n * Execute a SuiteQL query and return the first page of results.\n */\nexport async function executeSuiteQL<T = SuiteQLRow>(\n client: NetSuiteClient,\n query: string,\n options?: { limit?: number; offset?: number },\n): Promise<SuiteQLResult<T>> {\n const limit = options?.limit ?? 1000;\n const offset = options?.offset ?? 0;\n\n const response = await client.request<SuiteQLResponse>({\n method: 'POST',\n path: SUITEQL_PATH,\n body: { q: query },\n headers: {\n Prefer: 'transient',\n },\n query: {\n limit: limit.toString(),\n offset: offset.toString(),\n },\n retry: true, // POST-for-query is idempotent\n });\n\n // Strip HATEOAS `links` metadata from each row\n const items = (response.data.items ?? []).map(({ links, ...rest }: any) => rest) as T[];\n\n return {\n items,\n totalResults: response.data.totalResults,\n hasMore: response.data.hasMore,\n };\n}\n","import type { NetSuiteClient } from '../http/client.js';\nimport type { SuiteQLRow } from '../types.js';\nimport { executeSuiteQL } from './executor.js';\n\nexport interface PaginationOptions {\n /** Page size per request. Default: 1000. */\n pageSize?: number;\n /** Maximum total rows to fetch. Default: unlimited. */\n maxRows?: number;\n}\n\n/**\n * Execute a SuiteQL query and automatically paginate through all results.\n * Collects all pages into a single array.\n */\nexport async function executeSuiteQLPaginated<T = SuiteQLRow>(\n client: NetSuiteClient,\n query: string,\n options?: PaginationOptions,\n): Promise<T[]> {\n const pageSize = options?.pageSize ?? 1000;\n const maxRows = options?.maxRows ?? Infinity;\n const allItems: T[] = [];\n let offset = 0;\n\n while (allItems.length < maxRows) {\n const limit = Math.min(pageSize, maxRows - allItems.length);\n const result = await executeSuiteQL<T>(client, query, { limit, offset });\n\n allItems.push(...result.items);\n\n if (!result.hasMore || result.items.length === 0) {\n break;\n }\n\n offset += result.items.length;\n }\n\n return allItems;\n}\n","import type { NetSuiteClient } from '../http/client.js';\n\nconst RECORD_BASE = '/services/rest/record/v1';\n\n/**\n * Create a new record via the REST Record API.\n * POST /services/rest/record/v1/{recordType}\n */\nexport async function createRecord(\n client: NetSuiteClient,\n recordType: string,\n data: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'POST',\n path: `${RECORD_BASE}/${recordType}`,\n body: data,\n });\n return response.data;\n}\n\n/**\n * Update an existing record via the REST Record API.\n * PATCH /services/rest/record/v1/{recordType}/{id}\n */\nexport async function updateRecord(\n client: NetSuiteClient,\n recordType: string,\n id: string | number,\n data: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'PATCH',\n path: `${RECORD_BASE}/${recordType}/${id}`,\n body: data,\n });\n return response.data;\n}\n\n/**\n * Delete a record via the REST Record API.\n * DELETE /services/rest/record/v1/{recordType}/{id}\n */\nexport async function deleteRecord(\n client: NetSuiteClient,\n recordType: string,\n id: string | number,\n): Promise<void> {\n await client.request({\n method: 'DELETE',\n path: `${RECORD_BASE}/${recordType}/${id}`,\n });\n}\n\n/**\n * Upsert a record via the REST Record API (create or update by externalId).\n * PUT /services/rest/record/v1/{recordType}/eid:{externalId}\n */\nexport async function upsertRecord(\n client: NetSuiteClient,\n recordType: string,\n externalId: string,\n data: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'PUT',\n path: `${RECORD_BASE}/${recordType}/eid:${externalId}`,\n body: data,\n });\n return response.data;\n}\n\n/**\n * Get a single record by ID via the REST Record API.\n * GET /services/rest/record/v1/{recordType}/{id}\n */\nexport async function getRecord(\n client: NetSuiteClient,\n recordType: string,\n id: string | number,\n): Promise<Record<string, unknown>> {\n const response = await client.request<Record<string, unknown>>({\n method: 'GET',\n path: `${RECORD_BASE}/${recordType}/${id}`,\n });\n return response.data;\n}\n","import type { NetSuiteClient } from '../http/client.js';\n\nconst RECORD_BASE = '/services/rest/record/v1';\nconst DEFAULT_TRANSFORM_TIMEOUT = 120_000; // 2 minutes\n\nexport interface TransformOptions {\n /** Request body (field overrides on the target record). */\n body?: Record<string, unknown>;\n /** Timeout in ms. Default: 120000 (2 minutes). */\n timeout?: number;\n}\n\nexport interface TransformResult {\n /** The internal ID of the newly created record. */\n id: string;\n /** The target record type. */\n type: string;\n}\n\n/**\n * Transform a record from one type to another via the NetSuite REST API.\n *\n * POST /services/rest/record/v1/{sourceType}/{sourceId}/!transform/{targetType}\n *\n * Uses a longer default timeout (120s) since transforms can be slow.\n * Never retries — transforms are non-idempotent mutations.\n */\nexport async function transformRecord(\n client: NetSuiteClient,\n sourceType: string,\n sourceId: string | number,\n targetType: string,\n options?: TransformOptions,\n): Promise<TransformResult> {\n const response = await client.request<Record<string, unknown>>({\n method: 'POST',\n path: `${RECORD_BASE}/${sourceType}/${sourceId}/!transform/${targetType}`,\n body: options?.body ?? {},\n timeout: options?.timeout ?? DEFAULT_TRANSFORM_TIMEOUT,\n retry: false,\n });\n\n // Extract ID from the Location header or response body\n const location = response.headers.get('Location');\n let id: string | undefined;\n\n if (location) {\n // Location: /services/rest/record/v1/{targetType}/{id}\n const match = location.match(/\\/(\\d+)$/);\n if (match) {\n id = match[1];\n }\n }\n\n // Fall back to response body if Location header doesn't have the ID\n if (!id && response.data) {\n const rawId = response.data['id'] ?? response.data['internalid'] ?? response.data['internalId'];\n if (rawId != null) {\n id = String(rawId);\n }\n }\n\n if (!id) {\n throw new Error(\n `Transform succeeded (HTTP ${response.status}) but could not extract the new record ID. ` +\n `Location header: ${location ?? '(none)'}`,\n );\n }\n\n return { id, type: targetType };\n}\n"],"mappings":"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","names":["RECORD_BASE"]}
|