@nvisy/sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,555 @@
+import createClient from 'openapi-fetch';
+
+// src/client.ts
+
+// src/config.ts
+var ENV_VARS = {
+  API_KEY: "NVISY_API_KEY",
+  BASE_URL: "NVISY_BASE_URL",
+  TIMEOUT: "NVISY_TIMEOUT",
+  MAX_RETRIES: "NVISY_MAX_RETRIES"
+};
+var DEFAULTS = {
+  baseUrl: "https://api.nvisy.com",
+  timeout: 3e4,
+  maxRetries: 3,
+  headers: {}
+};
+function loadConfigFromEnv() {
+  const config = {};
+  const apiKey = process.env[ENV_VARS.API_KEY];
+  if (apiKey) {
+    config.apiKey = apiKey;
+  }
+  const baseUrl = process.env[ENV_VARS.BASE_URL];
+  if (baseUrl) {
+    config.baseUrl = baseUrl;
+  }
+  const timeout = process.env[ENV_VARS.TIMEOUT];
+  if (timeout) {
+    const timeoutMs = parseInt(timeout, 10);
+    if (!Number.isNaN(timeoutMs)) {
+      config.timeout = timeoutMs;
+    }
+  }
+  const maxRetries = process.env[ENV_VARS.MAX_RETRIES];
+  if (maxRetries) {
+    const retries = parseInt(maxRetries, 10);
+    if (!Number.isNaN(retries)) {
+      config.maxRetries = retries;
+    }
+  }
+  return config;
+}
+function resolveConfig(userConfig) {
+  const envConfig = loadConfigFromEnv();
+  const mergedConfig = { ...envConfig, ...userConfig };
+  return {
+    apiKey: mergedConfig.apiKey || "",
+    baseUrl: mergedConfig.baseUrl || DEFAULTS.baseUrl,
+    timeout: mergedConfig.timeout ?? DEFAULTS.timeout,
+    maxRetries: mergedConfig.maxRetries ?? DEFAULTS.maxRetries,
+    headers: { ...DEFAULTS.headers, ...mergedConfig.headers }
+  };
+}
+function getEnvironmentVariables() {
+  return { ...ENV_VARS };
+}
+
+// src/errors.ts
+var ClientError = class extends Error {
+  name;
+  constructor(message) {
+    super(message);
+    this.name = this.constructor.name;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+  /**
+   * Convert error to JSON representation
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      context: ""
+    };
+  }
+};
+var ConfigError = class _ConfigError extends ClientError {
+  /** Field that caused the error (for validation errors) */
+  field;
+  /** Reason why the configuration is invalid */
+  reason;
+  constructor(message, options) {
+    super(message);
+    this.field = options?.field;
+    this.reason = options?.reason;
+  }
+  /**
+   * Create error for missing API key
+   */
+  static missingApiKey() {
+    return new _ConfigError("API key is required", {
+      field: "apiKey",
+      reason: "API key must be provided in configuration"
+    });
+  }
+  /**
+   * Create error for invalid configuration field
+   */
+  static invalidField(field, reason) {
+    return new _ConfigError(`Invalid configuration for ${field}: ${reason}`, {
+      field,
+      reason
+    });
+  }
+  /**
+   * Create error for missing required field
+   */
+  static missingField(field) {
+    return new _ConfigError(`Missing required configuration field: ${field}`, {
+      field,
+      reason: "This field is required"
+    });
+  }
+  /**
+   * Convert error to JSON representation
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      context: this.field || this.reason ? `field: ${this.field}, reason: ${this.reason}` : ""
+    };
+  }
+};
+var NetworkError = class _NetworkError extends ClientError {
+  /** Original error that caused this network error */
+  cause;
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+  }
+  /**
+   * Create error for network/connection issues
+   */
+  static connection(message, cause) {
+    return new _NetworkError(message, cause);
+  }
+  /**
+   * Create error for request timeout
+   */
+  static timeout(timeoutMs) {
+    return new _NetworkError(`Request timed out after ${timeoutMs}ms`);
+  }
+  /**
+   * Create error for aborted request
+   */
+  static aborted() {
+    return new _NetworkError("Request was aborted");
+  }
+  /**
+   * Create error for DNS resolution failure
+   */
+  static dnsResolution(hostname) {
+    return new _NetworkError(`Failed to resolve hostname: ${hostname}`);
+  }
+  /**
+   * Convert error to JSON representation
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      context: this.cause ? `cause: ${this.cause.message}` : ""
+    };
+  }
+};
+var ApiError = class _ApiError extends ClientError {
+  /** Error response from server */
+  errorResponse;
+  /** HTTP status code */
+  statusCode;
+  /** Request ID for debugging */
+  requestId;
+  constructor(message, statusCode, options) {
+    super(message);
+    this.statusCode = statusCode;
+    this.errorResponse = options?.errorResponse;
+    this.requestId = options?.requestId;
+  }
+  /**
+   * Create error from HTTP response
+   */
+  static fromResponse(response, errorData, requestId) {
+    const message = errorData?.message || `HTTP ${response.status}: ${response.statusText}`;
+    return new _ApiError(message, response.status, {
+      errorResponse: errorData,
+      requestId
+    });
+  }
+  /**
+   * Create error for rate limiting
+   */
+  static rateLimited(retryAfter, requestId) {
+    const message = retryAfter ? `Rate limited. Retry after ${retryAfter} seconds` : "Rate limited";
+    return new _ApiError(message, 429, {
+      requestId,
+      errorResponse: {
+        name: "RateLimitError",
+        message,
+        context: retryAfter ? `retryAfter: ${retryAfter}` : ""
+      }
+    });
+  }
+  /**
+   * Check if error is a client error (4xx)
+   */
+  isClientError() {
+    return this.statusCode ? this.statusCode >= 400 && this.statusCode < 500 : false;
+  }
+  /**
+   * Check if error is a server error (5xx)
+   */
+  isServerError() {
+    return this.statusCode ? this.statusCode >= 500 : false;
+  }
+  /**
+   * Check if error is retryable based on HTTP status
+   */
+  isRetryable() {
+    if (!this.statusCode) return false;
+    return this.statusCode >= 500 || // Server errors
+    this.statusCode === 408 || // Request timeout
+    this.statusCode === 429;
+  }
+  /**
+   * Get retry delay in milliseconds (returns null if not retryable)
+   */
+  getRetryDelay() {
+    if (!this.isRetryable()) return null;
+    if (this.statusCode === 429 && this.errorResponse?.context) {
+      const match = this.errorResponse.context.match(/retryAfter: (\d+)/);
+      if (match) {
+        const retryAfter = parseInt(match[1], 10);
+        return retryAfter * 1e3;
+      }
+    }
+    if (this.statusCode >= 500) {
+      return 1e3;
+    }
+    return 1e3;
+  }
+  /**
+   * Convert error to JSON representation
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      context: `statusCode: ${this.statusCode}${this.requestId ? `, requestId: ${this.requestId}` : ""}${this.errorResponse ? `, errorResponse: ${JSON.stringify(this.errorResponse)}` : ""}`
+    };
+  }
+};
+
+// src/client.ts
+var Client = class _Client {
+  #config;
+  #openApiClient;
+  /**
+   * Create a new Nvisy client instance
+   */
+  constructor(userConfig) {
+    try {
+      this.#validateConfig(userConfig);
+      this.#config = resolveConfig(userConfig);
+    } catch (error) {
+      if (error instanceof ConfigError) {
+        throw error;
+      }
+      throw ConfigError.invalidField(
+        "config",
+        `Configuration error: ${String(error)}`
+      );
+    }
+    this.#openApiClient = createClient({
+      baseUrl: this.#config.baseUrl,
+      headers: {
+        Authorization: `Bearer ${this.#config.apiKey}`,
+        "Content-Type": "application/json",
+        "User-Agent": this.#buildUserAgent(),
+        ...this.#config.headers
+      }
+    });
+  }
+  /**
+   * Create a new ClientBuilder for fluent configuration
+   */
+  static builder() {
+    return new ClientBuilder();
+  }
+  /**
+   * Create a client from environment variables
+   */
+  static fromEnvironment() {
+    return ClientBuilder.fromEnvironment().build();
+  }
+  /**
+   * Get the current configuration (readonly copy)
+   */
+  getConfig() {
+    return Object.freeze({ ...this.#config });
+  }
+  /**
+   * Get the underlying openapi-fetch client for advanced usage
+   */
+  getOpenApiClient() {
+    return this.#openApiClient;
+  }
+  /**
+   * Validate configuration by reusing ClientBuilder validation
+   */
+  #validateConfig(config) {
+    const builder = new ClientBuilder().withApiKey(config.apiKey);
+    if (config.baseUrl !== void 0) {
+      builder.withBaseUrl(config.baseUrl);
+    }
+    if (config.timeout !== void 0) {
+      builder.withTimeout(config.timeout);
+    }
+    if (config.maxRetries !== void 0) {
+      builder.withMaxRetries(config.maxRetries);
+    }
+    if (config.headers !== void 0) {
+      builder.withHeaders(config.headers);
+    }
+  }
+  /**
+   * Build user agent string
+   */
+  #buildUserAgent() {
+    const sdkVersion = "1.0.0";
+    const nodeVersion = process.version;
+    const platform = process.platform;
+    return `@nvisy/sdk/${sdkVersion} (${platform}; Node.js ${nodeVersion})`;
+  }
+  /**
+   * Create a new client with modified configuration
+   */
+  withConfig(configChanges) {
+    const newConfig = {
+      apiKey: this.#config.apiKey,
+      baseUrl: this.#config.baseUrl,
+      timeout: this.#config.timeout,
+      maxRetries: this.#config.maxRetries,
+      headers: this.#config.headers,
+      ...configChanges
+    };
+    return new _Client(newConfig);
+  }
+  /**
+   * Create a new client with additional headers
+   */
+  withHeaders(additionalHeaders) {
+    return this.withConfig({
+      headers: { ...this.#config.headers, ...additionalHeaders }
+    });
+  }
+  /**
+   * Create a new client with a different timeout
+   */
+  withTimeout(timeoutMs) {
+    return this.withConfig({ timeout: timeoutMs });
+  }
+  /**
+   * Create a new client with different retry settings
+   */
+  withMaxRetries(maxRetries) {
+    return this.withConfig({ maxRetries });
+  }
+};
+
+// src/builder.ts
+var RESERVED_HEADERS = ["authorization", "content-type", "user-agent"];
+var ClientBuilder = class _ClientBuilder {
+  #config = {};
+  /**
+   * Create a ClientBuilder instance with an API key
+   */
+  static fromApiKey(apiKey) {
+    return new _ClientBuilder().withApiKey(apiKey);
+  }
+  /**
+   * Create a ClientBuilder instance from environment variables
+   */
+  static fromEnvironment() {
+    const envConfig = loadConfigFromEnv();
+    if (!envConfig.apiKey) {
+      throw ConfigError.missingApiKey();
+    }
+    const builder = new _ClientBuilder().withApiKey(envConfig.apiKey);
+    if (envConfig.baseUrl) {
+      builder.withBaseUrl(envConfig.baseUrl);
+    }
+    if (envConfig.timeout) {
+      builder.withTimeout(envConfig.timeout);
+    }
+    if (envConfig.maxRetries !== void 0) {
+      builder.withMaxRetries(envConfig.maxRetries);
+    }
+    if (envConfig.headers) {
+      builder.withHeaders(envConfig.headers);
+    }
+    return builder;
+  }
+  /**
+   * Set the API key for authentication
+   */
+  withApiKey(apiKey) {
+    this.#validateString("apiKey", apiKey);
+    const trimmedKey = apiKey.trim();
+    if (trimmedKey.length < 10) {
+      throw ConfigError.invalidField(
+        "apiKey",
+        "must be at least 10 characters"
+      );
+    }
+    if (!/^[a-zA-Z0-9_-]+$/.test(trimmedKey)) {
+      throw ConfigError.invalidField("apiKey", "contains invalid characters");
+    }
+    this.#config.apiKey = trimmedKey;
+    return this;
+  }
+  /**
+   * Set the base URL for the API
+   */
+  withBaseUrl(baseUrl) {
+    this.#validateString("baseUrl", baseUrl);
+    this.#validateUrl(baseUrl);
+    this.#config.baseUrl = baseUrl;
+    return this;
+  }
+  /**
+   * Set the request timeout in milliseconds
+   */
+  withTimeout(timeoutMs) {
+    this.#validateInteger("timeout", timeoutMs, 1e3, 3e5);
+    this.#config.timeout = timeoutMs;
+    return this;
+  }
+  /**
+   * Set the maximum number of retry attempts
+   */
+  withMaxRetries(maxRetries) {
+    this.#validateInteger("maxRetries", maxRetries, 0, 5);
+    this.#config.maxRetries = maxRetries;
+    return this;
+  }
+  /**
+   * Add a single custom header (merges with existing headers)
+   */
+  withHeader(name, value) {
+    this.#validateSingleHeader(name, value);
+    if (!this.#config.headers) {
+      this.#config.headers = {};
+    }
+    this.#config.headers[name] = value;
+    return this;
+  }
+  /**
+   * Set custom headers (merges with existing headers)
+   */
+  withHeaders(headers) {
+    if (!headers || typeof headers !== "object" || Array.isArray(headers)) {
+      throw ConfigError.invalidField("headers", "must be a valid object");
+    }
+    for (const [name, value] of Object.entries(headers)) {
+      this.withHeader(name, value);
+    }
+    return this;
+  }
+  /**
+   * Build and return the configured client instance
+   */
+  build() {
+    if (!this.#config.apiKey) {
+      throw ConfigError.missingApiKey();
+    }
+    return new Client(this.#config);
+  }
+  /**
+   * Get the current configuration (for debugging/testing)
+   */
+  getConfig() {
+    return { ...this.#config };
+  }
+  /**
+   * Validate string field
+   */
+  #validateString(fieldName, value) {
+    if (!value || typeof value !== "string" || value.trim().length === 0) {
+      throw ConfigError.invalidField(fieldName, "must be a non-empty string");
+    }
+  }
+  /**
+   * Validate integer field with range
+   */
+  #validateInteger(fieldName, value, min, max) {
+    if (!Number.isInteger(value) || value < min) {
+      throw ConfigError.invalidField(fieldName, `must be an integer >= ${min}`);
+    }
+    if (value > max) {
+      throw ConfigError.invalidField(fieldName, `must not exceed ${max}`);
+    }
+  }
+  /**
+   * Validate URL format
+   */
+  #validateUrl(baseUrl) {
+    let url;
+    try {
+      url = new URL(baseUrl);
+    } catch {
+      throw ConfigError.invalidField("baseUrl", "must be a valid URL");
+    }
+    const allowedProtocols = ["https:", "http:"];
+    if (!allowedProtocols.includes(url.protocol)) {
+      throw ConfigError.invalidField(
+        "baseUrl",
+        `protocol must be one of: ${allowedProtocols.join(", ")}`
+      );
+    }
+  }
+  /**
+   * Validate single header name and value
+   */
+  #validateSingleHeader(name, value) {
+    if (!name || typeof name !== "string" || name.trim().length === 0) {
+      throw ConfigError.invalidField(
+        "header name",
+        "must be a non-empty string"
+      );
+    }
+    if (typeof value !== "string") {
+      throw ConfigError.invalidField("header value", "must be a string");
+    }
+    if (!/^[a-zA-Z0-9!#$%&'*+\-.^_`|~]+$/.test(name)) {
+      throw ConfigError.invalidField(
+        "header name",
+        `invalid header name: ${name}`
+      );
+    }
+    if (RESERVED_HEADERS.includes(name.toLowerCase())) {
+      throw ConfigError.invalidField(
+        "header name",
+        `header "${name}" is reserved and cannot be overridden`
+      );
+    }
+  }
+};
+
+export { ApiError, Client, ClientBuilder, ClientError, ConfigError, NetworkError, getEnvironmentVariables, loadConfigFromEnv, resolveConfig };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/errors.ts","../src/client.ts","../src/builder.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Configuration options for the Nvisy client\n */\nexport interface ClientConfig {\n\t/**\n\t * API key for authentication\n\t */\n\tapiKey: string;\n\n\t/**\n\t * Base URL for the Nvisy API\n\t * @default \"https://api.nvisy.com\"\n\t */\n\tbaseUrl?: string;\n\n\t/**\n\t * Request timeout in milliseconds\n\t * @default 30000\n\t */\n\ttimeout?: number;\n\n\t/**\n\t * Maximum number of retry attempts for failed requests\n\t * @default 3\n\t */\n\tmaxRetries?: number;\n\n\t/**\n\t * Custom headers to include with requests\n\t */\n\theaders?: Record<string, string>;\n}\n\n/**\n * Internal fully-resolved configuration\n */\nexport type ResolvedClientConfig = Required<ClientConfig>;\n\n/**\n * Environment variable names for configuration\n */\nconst ENV_VARS = {\n\tAPI_KEY: \"NVISY_API_KEY\",\n\tBASE_URL: \"NVISY_BASE_URL\",\n\tTIMEOUT: \"NVISY_TIMEOUT\",\n\tMAX_RETRIES: \"NVISY_MAX_RETRIES\",\n} as const;\n\n/**\n * Default configuration values\n */\nconst DEFAULTS = {\n\tbaseUrl: \"https://api.nvisy.com\",\n\ttimeout: 30_000,\n\tmaxRetries: 3,\n\theaders: {},\n} as const;\n\n/**\n * Load configuration from environment variables\n */\nexport function loadConfigFromEnv(): Partial<ClientConfig> {\n\tconst config: Partial<ClientConfig> = {};\n\n\tconst apiKey = process.env[ENV_VARS.API_KEY];\n\tif (apiKey) {\n\t\tconfig.apiKey = apiKey;\n\t}\n\n\tconst baseUrl = process.env[ENV_VARS.BASE_URL];\n\tif (baseUrl) {\n\t\tconfig.baseUrl = baseUrl;\n\t}\n\n\tconst timeout = process.env[ENV_VARS.TIMEOUT];\n\tif (timeout) {\n\t\tconst timeoutMs = parseInt(timeout, 10);\n\t\tif (!Number.isNaN(timeoutMs)) {\n\t\t\tconfig.timeout = timeoutMs;\n\t\t}\n\t}\n\n\tconst maxRetries = process.env[ENV_VARS.MAX_RETRIES];\n\tif (maxRetries) {\n\t\tconst retries = parseInt(maxRetries, 10);\n\t\tif (!Number.isNaN(retries)) {\n\t\t\tconfig.maxRetries = retries;\n\t\t}\n\t}\n\n\treturn config;\n}\n\n/**\n * Resolve configuration with defaults\n */\nexport function resolveConfig(userConfig: ClientConfig): ResolvedClientConfig {\n\tconst envConfig = loadConfigFromEnv();\n\tconst mergedConfig = { ...envConfig, ...userConfig };\n\n\treturn {\n\t\tapiKey: mergedConfig.apiKey || \"\",\n\t\tbaseUrl: mergedConfig.baseUrl || DEFAULTS.baseUrl,\n\t\ttimeout: mergedConfig.timeout ?? DEFAULTS.timeout,\n\t\tmaxRetries: mergedConfig.maxRetries ?? DEFAULTS.maxRetries,\n\t\theaders: { ...DEFAULTS.headers, ...mergedConfig.headers },\n\t};\n}\n\n/**\n * Get available environment variable names\n */\nexport function getEnvironmentVariables(): Record<string, string> {\n\treturn { ...ENV_VARS };\n}\n","/**\n * Error response structure from server\n */\nexport interface ErrorResponse {\n\t/** Error type/name */\n\tname: string;\n\t/** Human-readable error message */\n\tmessage: string;\n\t/** Additional error context */\n\tcontext: string;\n}\n\n/**\n * Abstract base error class for all Nvisy SDK errors\n */\nexport abstract class ClientError extends Error {\n\tpublic readonly name: string;\n\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = this.constructor.name;\n\n\t\t// Maintains proper stack trace for where our error was thrown (only available on V8)\n\t\tif (Error.captureStackTrace) {\n\t\t\tError.captureStackTrace(this, this.constructor);\n\t\t}\n\t}\n\n\t/**\n\t * Convert error to JSON representation\n\t */\n\ttoJSON(): ErrorResponse {\n\t\treturn {\n\t\t\tname: this.name,\n\t\t\tmessage: this.message,\n\t\t\tcontext: \"\",\n\t\t};\n\t}\n}\n\n/**\n * Configuration error - thrown when client configuration is invalid\n */\nexport class ConfigError extends ClientError {\n\t/** Field that caused the error (for validation errors) */\n\tpublic readonly field?: string;\n\t/** Reason why the configuration is invalid */\n\tpublic readonly reason?: string;\n\n\tconstructor(\n\t\tmessage: string,\n\t\toptions?: {\n\t\t\tfield?: string;\n\t\t\treason?: string;\n\t\t},\n\t) {\n\t\tsuper(message);\n\t\tthis.field = options?.field;\n\t\tthis.reason = options?.reason;\n\t}\n\n\t/**\n\t * Create error for missing API key\n\t */\n\tstatic missingApiKey(): ConfigError {\n\t\treturn new ConfigError(\"API key is required\", {\n\t\t\tfield: \"apiKey\",\n\t\t\treason: \"API key must be provided in configuration\",\n\t\t});\n\t}\n\n\t/**\n\t * Create error for invalid configuration field\n\t */\n\tstatic invalidField(field: string, reason: string): ConfigError {\n\t\treturn new ConfigError(`Invalid configuration for ${field}: ${reason}`, {\n\t\t\tfield,\n\t\t\treason,\n\t\t});\n\t}\n\n\t/**\n\t * Create error for missing required field\n\t */\n\tstatic missingField(field: string): ConfigError {\n\t\treturn new ConfigError(`Missing required configuration field: ${field}`, {\n\t\t\tfield,\n\t\t\treason: \"This field is required\",\n\t\t});\n\t}\n\n\t/**\n\t * Convert error to JSON representation\n\t */\n\ttoJSON(): ErrorResponse {\n\t\treturn {\n\t\t\tname: this.name,\n\t\t\tmessage: this.message,\n\t\t\tcontext:\n\t\t\t\tthis.field || this.reason\n\t\t\t\t\t? `field: ${this.field}, reason: ${this.reason}`\n\t\t\t\t\t: \"\",\n\t\t};\n\t}\n}\n\n/**\n * Network error - thrown when network requests fail\n */\nexport class NetworkError extends ClientError {\n\t/** Original error that caused this network error */\n\tpublic readonly cause?: Error;\n\n\tconstructor(message: string, cause?: Error) {\n\t\tsuper(message);\n\t\tthis.cause = cause;\n\t}\n\n\t/**\n\t * Create error for network/connection issues\n\t */\n\tstatic connection(message: string, cause?: Error): NetworkError {\n\t\treturn new NetworkError(message, cause);\n\t}\n\n\t/**\n\t * Create error for request timeout\n\t */\n\tstatic timeout(timeoutMs: number): NetworkError {\n\t\treturn new NetworkError(`Request timed out after ${timeoutMs}ms`);\n\t}\n\n\t/**\n\t * Create error for aborted request\n\t */\n\tstatic aborted(): NetworkError {\n\t\treturn new NetworkError(\"Request was aborted\");\n\t}\n\n\t/**\n\t * Create error for DNS resolution failure\n\t */\n\tstatic dnsResolution(hostname: string): NetworkError {\n\t\treturn new NetworkError(`Failed to resolve hostname: ${hostname}`);\n\t}\n\n\t/**\n\t * Convert error to JSON representation\n\t */\n\ttoJSON(): ErrorResponse {\n\t\treturn {\n\t\t\tname: this.name,\n\t\t\tmessage: this.message,\n\t\t\tcontext: this.cause ? `cause: ${this.cause.message}` : \"\",\n\t\t};\n\t}\n}\n\n/**\n * API error - thrown when server responds with an error\n */\nexport class ApiError extends ClientError {\n\t/** Error response from server */\n\tpublic readonly errorResponse?: ErrorResponse;\n\t/** HTTP status code */\n\tpublic readonly statusCode: number;\n\t/** Request ID for debugging */\n\tpublic readonly requestId?: string;\n\n\tconstructor(\n\t\tmessage: string,\n\t\tstatusCode: number,\n\t\toptions?: {\n\t\t\terrorResponse?: ErrorResponse;\n\t\t\trequestId?: string;\n\t\t},\n\t) {\n\t\tsuper(message);\n\t\tthis.statusCode = statusCode;\n\t\tthis.errorResponse = options?.errorResponse;\n\t\tthis.requestId = options?.requestId;\n\t}\n\n\t/**\n\t * Create error from HTTP response\n\t */\n\tstatic fromResponse(\n\t\tresponse: Response,\n\t\terrorData?: ErrorResponse,\n\t\trequestId?: string,\n\t): ApiError {\n\t\tconst message =\n\t\t\terrorData?.message || `HTTP ${response.status}: ${response.statusText}`;\n\n\t\treturn new ApiError(message, response.status, {\n\t\t\terrorResponse: errorData,\n\t\t\trequestId,\n\t\t});\n\t}\n\n\t/**\n\t * Create error for rate limiting\n\t */\n\tstatic rateLimited(retryAfter?: number, requestId?: string): ApiError {\n\t\tconst message = retryAfter\n\t\t\t? `Rate limited. Retry after ${retryAfter} seconds`\n\t\t\t: \"Rate limited\";\n\n\t\treturn new ApiError(message, 429, {\n\t\t\trequestId,\n\t\t\terrorResponse: {\n\t\t\t\tname: \"RateLimitError\",\n\t\t\t\tmessage,\n\t\t\t\tcontext: retryAfter ? `retryAfter: ${retryAfter}` : \"\",\n\t\t\t},\n\t\t});\n\t}\n\n\t/**\n\t * Check if error is a client error (4xx)\n\t */\n\tisClientError(): boolean {\n\t\treturn this.statusCode\n\t\t\t? this.statusCode >= 400 && this.statusCode < 500\n\t\t\t: false;\n\t}\n\n\t/**\n\t * Check if error is a server error (5xx)\n\t */\n\tisServerError(): boolean {\n\t\treturn this.statusCode ? this.statusCode >= 500 : false;\n\t}\n\n\t/**\n\t * Check if error is retryable based on HTTP status\n\t */\n\tisRetryable(): boolean {\n\t\tif (!this.statusCode) return false;\n\n\t\t// Retry on server errors and specific client errors\n\t\treturn (\n\t\t\tthis.statusCode >= 500 || // Server errors\n\t\t\tthis.statusCode === 408 || // Request timeout\n\t\t\tthis.statusCode === 429 // Rate limited\n\t\t);\n\t}\n\n\t/**\n\t * Get retry delay in milliseconds (returns null if not retryable)\n\t */\n\tgetRetryDelay(): number | null {\n\t\tif (!this.isRetryable()) return null;\n\n\t\t// For rate limiting, check if we have retry-after info\n\t\tif (this.statusCode === 429 && this.errorResponse?.context) {\n\t\t\tconst match = this.errorResponse.context.match(/retryAfter: (\\d+)/);\n\t\t\tif (match) {\n\t\t\t\tconst retryAfter = parseInt(match[1], 10);\n\t\t\t\treturn retryAfter * 1000; // Convert seconds to milliseconds\n\t\t\t}\n\t\t}\n\n\t\t// Default delays based on error type\n\t\tif (this.statusCode >= 500) {\n\t\t\treturn 1000; // 1 second for server errors\n\t\t}\n\n\t\treturn 1000; // Default 1 second\n\t}\n\n\t/**\n\t * Convert error to JSON representation\n\t */\n\ttoJSON(): ErrorResponse {\n\t\treturn {\n\t\t\tname: this.name,\n\t\t\tmessage: this.message,\n\t\t\tcontext: `statusCode: ${this.statusCode}${\n\t\t\t\tthis.requestId ? `, requestId: ${this.requestId}` : \"\"\n\t\t\t}${\n\t\t\t\tthis.errorResponse\n\t\t\t\t\t? `, errorResponse: ${JSON.stringify(this.errorResponse)}`\n\t\t\t\t\t: \"\"\n\t\t\t}`,\n\t\t};\n\t}\n}\n","import createClient from \"openapi-fetch\";\nimport { ClientBuilder } from \"./builder.js\";\nimport {\n\ttype ClientConfig,\n\ttype ResolvedClientConfig,\n\tresolveConfig,\n} from \"./config.js\";\nimport { ConfigError } from \"./errors.js\";\n\n/**\n * Main client class for interacting with the Nvisy document redaction API\n */\nexport class Client {\n\t#config: ResolvedClientConfig;\n\t#openApiClient: ReturnType<typeof createClient>;\n\n\t/**\n\t * Create a new Nvisy client instance\n\t */\n\tconstructor(userConfig: ClientConfig) {\n\t\ttry {\n\t\t\t// Validate configuration first\n\t\t\tthis.#validateConfig(userConfig);\n\t\t\t// Resolve configuration with defaults\n\t\t\tthis.#config = resolveConfig(userConfig);\n\t\t} catch (error) {\n\t\t\tif (error instanceof ConfigError) {\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tthrow ConfigError.invalidField(\n\t\t\t\t\"config\",\n\t\t\t\t`Configuration error: ${String(error)}`,\n\t\t\t);\n\t\t}\n\n\t\t// Create openapi-fetch client with proper headers\n\t\tthis.#openApiClient = createClient({\n\t\t\tbaseUrl: this.#config.baseUrl,\n\t\t\theaders: {\n\t\t\t\tAuthorization: `Bearer ${this.#config.apiKey}`,\n\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\"User-Agent\": this.#buildUserAgent(),\n\t\t\t\t...this.#config.headers,\n\t\t\t},\n\t\t});\n\t}\n\n\t/**\n\t * Create a new ClientBuilder for fluent configuration\n\t */\n\tstatic builder(): ClientBuilder {\n\t\treturn new ClientBuilder();\n\t}\n\n\t/**\n\t * Create a client from environment variables\n\t */\n\tstatic fromEnvironment(): Client {\n\t\treturn ClientBuilder.fromEnvironment().build();\n\t}\n\n\t/**\n\t * Get the current configuration (readonly copy)\n\t */\n\tgetConfig(): Readonly<ResolvedClientConfig> {\n\t\treturn Object.freeze({ ...this.#config });\n\t}\n\n\t/**\n\t * Get the underlying openapi-fetch client for advanced usage\n\t */\n\tgetOpenApiClient(): ReturnType<typeof createClient> {\n\t\treturn this.#openApiClient;\n\t}\n\n\t/**\n\t * Validate configuration by reusing ClientBuilder validation\n\t */\n\t#validateConfig(config: ClientConfig): void {\n\t\tconst builder = new ClientBuilder().withApiKey(config.apiKey);\n\n\t\tif (config.baseUrl !== undefined) {\n\t\t\tbuilder.withBaseUrl(config.baseUrl);\n\t\t}\n\n\t\tif (config.timeout !== undefined) {\n\t\t\tbuilder.withTimeout(config.timeout);\n\t\t}\n\n\t\tif (config.maxRetries !== undefined) {\n\t\t\tbuilder.withMaxRetries(config.maxRetries);\n\t\t}\n\n\t\tif (config.headers !== undefined) {\n\t\t\tbuilder.withHeaders(config.headers);\n\t\t}\n\t}\n\n\t/**\n\t * Build user agent string\n\t */\n\t#buildUserAgent(): string {\n\t\t// In a real implementation, this would import from package.json\n\t\tconst sdkVersion = \"1.0.0\";\n\t\tconst nodeVersion = process.version;\n\t\tconst platform = process.platform;\n\n\t\treturn `@nvisy/sdk/${sdkVersion} (${platform}; Node.js ${nodeVersion})`;\n\t}\n\n\t/**\n\t * Create a new client with modified configuration\n\t */\n\twithConfig(configChanges: Partial<ClientConfig>): Client {\n\t\tconst newConfig: ClientConfig = {\n\t\t\tapiKey: this.#config.apiKey,\n\t\t\tbaseUrl: this.#config.baseUrl,\n\t\t\ttimeout: this.#config.timeout,\n\t\t\tmaxRetries: this.#config.maxRetries,\n\t\t\theaders: this.#config.headers,\n\t\t\t...configChanges,\n\t\t};\n\t\treturn new Client(newConfig);\n\t}\n\n\t/**\n\t * Create a new client with additional headers\n\t */\n\twithHeaders(additionalHeaders: Record<string, string>): Client {\n\t\treturn this.withConfig({\n\t\t\theaders: { ...this.#config.headers, ...additionalHeaders },\n\t\t});\n\t}\n\n\t/**\n\t * Create a new client with a different timeout\n\t */\n\twithTimeout(timeoutMs: number): Client {\n\t\treturn this.withConfig({ timeout: timeoutMs });\n\t}\n\n\t/**\n\t * Create a new client with different retry settings\n\t */\n\twithMaxRetries(maxRetries: number): Client {\n\t\treturn this.withConfig({ maxRetries });\n\t}\n}\n","import { Client } from \"./client.js\";\nimport type { ClientConfig } from \"./config.js\";\nimport { loadConfigFromEnv } from \"./config.js\";\nimport { ConfigError } from \"./errors.js\";\n\n/**\n * Reserved headers that cannot be overridden\n */\nconst RESERVED_HEADERS = [\"authorization\", \"content-type\", \"user-agent\"];\n\n/**\n * Builder class for constructing client instances with a fluent API\n */\nexport class ClientBuilder {\n\t#config: Partial<ClientConfig> = {};\n\n\t/**\n\t * Create a ClientBuilder instance with an API key\n\t */\n\tstatic fromApiKey(apiKey: string): ClientBuilder {\n\t\treturn new ClientBuilder().withApiKey(apiKey);\n\t}\n\n\t/**\n\t * Create a ClientBuilder instance from environment variables\n\t */\n\tstatic fromEnvironment(): ClientBuilder {\n\t\tconst envConfig = loadConfigFromEnv();\n\n\t\tif (!envConfig.apiKey) {\n\t\t\tthrow ConfigError.missingApiKey();\n\t\t}\n\n\t\tconst builder = new ClientBuilder().withApiKey(envConfig.apiKey);\n\n\t\tif (envConfig.baseUrl) {\n\t\t\tbuilder.withBaseUrl(envConfig.baseUrl);\n\t\t}\n\t\tif (envConfig.timeout) {\n\t\t\tbuilder.withTimeout(envConfig.timeout);\n\t\t}\n\t\tif (envConfig.maxRetries !== undefined) {\n\t\t\tbuilder.withMaxRetries(envConfig.maxRetries);\n\t\t}\n\t\tif (envConfig.headers) {\n\t\t\tbuilder.withHeaders(envConfig.headers);\n\t\t}\n\n\t\treturn builder;\n\t}\n\n\t/**\n\t * Set the API key for authentication\n\t */\n\twithApiKey(apiKey: string): this {\n\t\tthis.#validateString(\"apiKey\", apiKey);\n\n\t\tconst trimmedKey = apiKey.trim();\n\t\tif (trimmedKey.length < 10) {\n\t\t\tthrow ConfigError.invalidField(\n\t\t\t\t\"apiKey\",\n\t\t\t\t\"must be at least 10 characters\",\n\t\t\t);\n\t\t}\n\n\t\tif (!/^[a-zA-Z0-9_-]+$/.test(trimmedKey)) {\n\t\t\tthrow ConfigError.invalidField(\"apiKey\", \"contains invalid characters\");\n\t\t}\n\n\t\tthis.#config.apiKey = trimmedKey;\n\t\treturn this;\n\t}\n\n\t/**\n\t * Set the base URL for the API\n\t */\n\twithBaseUrl(baseUrl: string): this {\n\t\tthis.#validateString(\"baseUrl\", baseUrl);\n\t\tthis.#validateUrl(baseUrl);\n\t\tthis.#config.baseUrl = baseUrl;\n\t\treturn this;\n\t}\n\n\t/**\n\t * Set the request timeout in milliseconds\n\t */\n\twithTimeout(timeoutMs: number): this {\n\t\tthis.#validateInteger(\"timeout\", timeoutMs, 1000, 300_000);\n\t\tthis.#config.timeout = timeoutMs;\n\t\treturn this;\n\t}\n\n\t/**\n\t * Set the maximum number of retry attempts\n\t */\n\twithMaxRetries(maxRetries: number): this {\n\t\tthis.#validateInteger(\"maxRetries\", maxRetries, 0, 5);\n\t\tthis.#config.maxRetries = maxRetries;\n\t\treturn this;\n\t}\n\n\t/**\n\t * Add a single custom header (merges with existing headers)\n\t */\n\twithHeader(name: string, value: string): this {\n\t\tthis.#validateSingleHeader(name, value);\n\n\t\tif (!this.#config.headers) {\n\t\t\tthis.#config.headers = {};\n\t\t}\n\n\t\tthis.#config.headers[name] = value;\n\t\treturn this;\n\t}\n\n\t/**\n\t * Set custom headers (merges with existing headers)\n\t */\n\twithHeaders(headers: Record<string, string>): this {\n\t\tif (!headers || typeof headers !== \"object\" || Array.isArray(headers)) {\n\t\t\tthrow ConfigError.invalidField(\"headers\", \"must be a valid object\");\n\t\t}\n\n\t\tfor (const [name, value] of Object.entries(headers)) {\n\t\t\tthis.withHeader(name, value);\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t/**\n\t * Build and return the configured client instance\n\t */\n\tbuild(): Client {\n\t\tif (!this.#config.apiKey) {\n\t\t\tthrow ConfigError.missingApiKey();\n\t\t}\n\n\t\treturn new Client(this.#config as ClientConfig);\n\t}\n\n\t/**\n\t * Get the current configuration (for debugging/testing)\n\t */\n\tgetConfig(): Readonly<Partial<ClientConfig>> {\n\t\treturn { ...this.#config };\n\t}\n\n\t/**\n\t * Validate string field\n\t */\n\t#validateString(fieldName: string, value: string): void {\n\t\tif (!value || typeof value !== \"string\" || value.trim().length === 0) {\n\t\t\tthrow ConfigError.invalidField(fieldName, \"must be a non-empty string\");\n\t\t}\n\t}\n\n\t/**\n\t * Validate integer field with range\n\t */\n\t#validateInteger(\n\t\tfieldName: string,\n\t\tvalue: number,\n\t\tmin: number,\n\t\tmax: number,\n\t): void {\n\t\tif (!Number.isInteger(value) || value < min) {\n\t\t\tthrow ConfigError.invalidField(fieldName, `must be an integer >= ${min}`);\n\t\t}\n\n\t\tif (value > max) {\n\t\t\tthrow ConfigError.invalidField(fieldName, `must not exceed ${max}`);\n\t\t}\n\t}\n\n\t/**\n\t * Validate URL format\n\t */\n\t#validateUrl(baseUrl: string): void {\n\t\tlet url: URL;\n\t\ttry {\n\t\t\turl = new URL(baseUrl);\n\t\t} catch {\n\t\t\tthrow ConfigError.invalidField(\"baseUrl\", \"must be a valid URL\");\n\t\t}\n\n\t\tconst allowedProtocols = [\"https:\", \"http:\"];\n\t\tif (!allowedProtocols.includes(url.protocol)) {\n\t\t\tthrow ConfigError.invalidField(\n\t\t\t\t\"baseUrl\",\n\t\t\t\t`protocol must be one of: ${allowedProtocols.join(\", \")}`,\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Validate single header name and value\n\t */\n\t#validateSingleHeader(name: string, value: string): void {\n\t\tif (!name || typeof name !== \"string\" || name.trim().length === 0) {\n\t\t\tthrow ConfigError.invalidField(\n\t\t\t\t\"header name\",\n\t\t\t\t\"must be a non-empty string\",\n\t\t\t);\n\t\t}\n\t\tif (typeof value !== \"string\") {\n\t\t\tthrow ConfigError.invalidField(\"header value\", \"must be a string\");\n\t\t}\n\n\t\t// Check for invalid header names (RFC 7230)\n\t\tif (!/^[a-zA-Z0-9!#$%&'*+\\-.^_`|~]+$/.test(name)) {\n\t\t\tthrow ConfigError.invalidField(\n\t\t\t\t\"header name\",\n\t\t\t\t`invalid header name: ${name}`,\n\t\t\t);\n\t\t}\n\n\t\t// Check for reserved headers\n\t\tif (RESERVED_HEADERS.includes(name.toLowerCase())) {\n\t\t\tthrow ConfigError.invalidField(\n\t\t\t\t\"header name\",\n\t\t\t\t`header \"${name}\" is reserved and cannot be overridden`,\n\t\t\t);\n\t\t}\n\t}\n}\n"]}