swcombine-sdk 1.0.0

package/dist/cjs/auth/scopes.js

@@ -0,0 +1,285 @@
+"use strict";
+/**
+ * OAuth Scopes for SW Combine API
+ *
+ * This module defines all available OAuth scopes and provides utilities
+ * for requesting common scope combinations.
+ *
+ * @see https://www.swcombine.com/ws/developers/permissions/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Scopes = exports.FactionInventoryScopes = exports.FactionScopes = exports.PersonalInventoryScopes = exports.MessageScopes = exports.CharacterScopes = void 0;
+exports.getAllCharacterScopes = getAllCharacterScopes;
+exports.getAllMessageScopes = getAllMessageScopes;
+exports.getAllPersonalInventoryScopes = getAllPersonalInventoryScopes;
+exports.getAllFactionScopes = getAllFactionScopes;
+exports.getAllFactionInventoryScopes = getAllFactionInventoryScopes;
+exports.getAllScopes = getAllScopes;
+exports.getReadOnlyScopes = getReadOnlyScopes;
+exports.getMinimalScopes = getMinimalScopes;
+/**
+ * Character-related scopes
+ */
+exports.CharacterScopes = {
+    /** Solely provides the character name and ID for use by clients who want to verify a character's identity */
+    AUTH: 'CHARACTER_AUTH',
+    /** Read basic character information (UID, handle, image, race, gender, etc.) */
+    READ: 'CHARACTER_READ',
+    /** Read character HP and XP */
+    STATS: 'CHARACTER_STATS',
+    /** Read character privileges */
+    PRIVILEGES: 'CHARACTER_PRIVILEGES',
+    /** Read character skills */
+    SKILLS: 'CHARACTER_SKILLS',
+    /** Read character credit information */
+    CREDITS: 'CHARACTER_CREDITS',
+    /** Transfer character credits */
+    CREDITS_WRITE: 'CHARACTER_CREDITS_WRITE',
+    /** Read character force-related information (FP, FXP, regen rate, Force Meter) */
+    FORCE: 'CHARACTER_FORCE',
+    /** Read location information in-game */
+    LOCATION: 'CHARACTER_LOCATION',
+    /** Read character events */
+    EVENTS: 'CHARACTER_EVENTS',
+    /** Access all character information (includes all above) */
+    ALL: 'CHARACTER_ALL',
+};
+/**
+ * Message-related scopes
+ */
+exports.MessageScopes = {
+    /** Read messages */
+    READ: 'MESSAGES_READ',
+    /** Send messages */
+    SEND: 'MESSAGES_SEND',
+    /** Delete messages */
+    DELETE: 'MESSAGES_DELETE',
+    /** All message permissions */
+    ALL: 'MESSAGES_ALL',
+};
+/**
+ * Generate personal inventory scopes for a specific entity type
+ */
+function generatePersonalInventoryScopes(entityType, hasRename = true) {
+    const scopes = {};
+    scopes.READ = `PERSONAL_INV_${entityType}_READ`;
+    if (hasRename) {
+        scopes.RENAME = `PERSONAL_INV_${entityType}_RENAME`;
+    }
+    scopes.ASSIGN = `PERSONAL_INV_${entityType}_ASSIGN`;
+    if (hasRename) {
+        scopes.MAKEOVER = `PERSONAL_INV_${entityType}_MAKEOVER`;
+    }
+    scopes.TAGS_READ = `PERSONAL_INV_${entityType}_TAGS_READ`;
+    scopes.TAGS_WRITE = `PERSONAL_INV_${entityType}_TAGS_WRITE`;
+    scopes.ALL = `PERSONAL_INV_${entityType}_ALL`;
+    return scopes;
+}
+/**
+ * Personal inventory scopes
+ */
+exports.PersonalInventoryScopes = {
+    /** Overview of personal inventory */
+    OVERVIEW: 'PERSONAL_INV_OVERVIEW',
+    /** Personal ship scopes */
+    SHIPS: generatePersonalInventoryScopes('SHIPS'),
+    /** Personal vehicle scopes */
+    VEHICLES: generatePersonalInventoryScopes('VEHICLES'),
+    /** Personal station scopes */
+    STATIONS: generatePersonalInventoryScopes('STATIONS'),
+    /** Personal city scopes */
+    CITIES: generatePersonalInventoryScopes('CITIES'),
+    /** Personal facility scopes */
+    FACILITIES: generatePersonalInventoryScopes('FACILITIES'),
+    /** Personal planet scopes (no RENAME/MAKEOVER) */
+    PLANETS: generatePersonalInventoryScopes('PLANETS', false),
+    /** Personal item scopes */
+    ITEMS: generatePersonalInventoryScopes('ITEMS'),
+    /** Personal NPC scopes (no RENAME) */
+    NPCS: generatePersonalInventoryScopes('NPCS', false),
+    /** Personal droid scopes */
+    DROIDS: generatePersonalInventoryScopes('DROIDS'),
+    /** Personal material scopes (no ASSIGN) */
+    MATERIALS: {
+        READ: 'PERSONAL_INV_MATERIALS_READ',
+        RENAME: 'PERSONAL_INV_MATERIALS_RENAME',
+        MAKEOVER: 'PERSONAL_INV_MATERIALS_MAKEOVER',
+        TAGS_READ: 'PERSONAL_INV_MATERIALS_TAGS_READ',
+        TAGS_WRITE: 'PERSONAL_INV_MATERIALS_TAGS_WRITE',
+        ALL: 'PERSONAL_INV_MATERIALS_ALL',
+    },
+    /** Personal creature scopes */
+    CREATURES: generatePersonalInventoryScopes('CREATURES'),
+};
+/**
+ * Faction management scopes
+ */
+exports.FactionScopes = {
+    /** Read faction information */
+    READ: 'FACTION_READ',
+    /** Read faction members */
+    MEMBERS: 'FACTION_MEMBERS',
+    /** Read faction stocks */
+    STOCKS: 'FACTION_STOCKS',
+    /** Read faction credits */
+    CREDITS_READ: 'FACTION_CREDITS_READ',
+    /** Write/transfer faction credits */
+    CREDITS_WRITE: 'FACTION_CREDITS_WRITE',
+    /** Read faction budgets */
+    BUDGETS_READ: 'FACTION_BUDGETS_READ',
+    /** Write faction budgets */
+    BUDGETS_WRITE: 'FACTION_BUDGETS_WRITE',
+    /** Read faction datacards */
+    DATACARDS_READ: 'FACTION_DATACARDS_READ',
+    /** Write faction datacards */
+    DATACARDS_WRITE: 'FACTION_DATACARDS_WRITE',
+    /** All faction permissions */
+    ALL: 'FACTION_ALL',
+};
+/**
+ * Generate faction inventory scopes for a specific entity type
+ */
+function generateFactionInventoryScopes(entityType, hasRename = true) {
+    const scopes = {};
+    scopes.READ = `FACTION_INV_${entityType}_READ`;
+    if (hasRename) {
+        scopes.RENAME = `FACTION_INV_${entityType}_RENAME`;
+    }
+    scopes.ASSIGN = `FACTION_INV_${entityType}_ASSIGN`;
+    if (hasRename) {
+        scopes.MAKEOVER = `FACTION_INV_${entityType}_MAKEOVER`;
+    }
+    scopes.TAGS_READ = `FACTION_INV_${entityType}_TAGS_READ`;
+    scopes.TAGS_WRITE = `FACTION_INV_${entityType}_TAGS_WRITE`;
+    scopes.ALL = `FACTION_INV_${entityType}_ALL`;
+    return scopes;
+}
+/**
+ * Faction inventory scopes
+ */
+exports.FactionInventoryScopes = {
+    /** Overview of faction inventory */
+    OVERVIEW: 'FACTION_INV_OVERVIEW',
+    /** Faction ship scopes */
+    SHIPS: generateFactionInventoryScopes('SHIPS'),
+    /** Faction vehicle scopes */
+    VEHICLES: generateFactionInventoryScopes('VEHICLES'),
+    /** Faction station scopes */
+    STATIONS: generateFactionInventoryScopes('STATIONS'),
+    /** Faction city scopes */
+    CITIES: generateFactionInventoryScopes('CITIES'),
+    /** Faction facility scopes */
+    FACILITIES: generateFactionInventoryScopes('FACILITIES'),
+    /** Faction planet scopes (no RENAME/MAKEOVER) */
+    PLANETS: generateFactionInventoryScopes('PLANETS', false),
+    /** Faction item scopes */
+    ITEMS: generateFactionInventoryScopes('ITEMS'),
+    /** Faction NPC scopes (no RENAME) */
+    NPCS: generateFactionInventoryScopes('NPCS', false),
+    /** Faction droid scopes */
+    DROIDS: generateFactionInventoryScopes('DROIDS'),
+    /** Faction material scopes (no ASSIGN) */
+    MATERIALS: {
+        READ: 'FACTION_INV_MATERIALS_READ',
+        RENAME: 'FACTION_INV_MATERIALS_RENAME',
+        MAKEOVER: 'FACTION_INV_MATERIALS_MAKEOVER',
+        TAGS_READ: 'FACTION_INV_MATERIALS_TAGS_READ',
+        TAGS_WRITE: 'FACTION_INV_MATERIALS_TAGS_WRITE',
+        ALL: 'FACTION_INV_MATERIALS_ALL',
+    },
+    /** Faction creature scopes */
+    CREATURES: generateFactionInventoryScopes('CREATURES'),
+};
+/**
+ * All available scopes organized by category
+ */
+exports.Scopes = {
+    Character: exports.CharacterScopes,
+    Messages: exports.MessageScopes,
+    PersonalInventory: exports.PersonalInventoryScopes,
+    Faction: exports.FactionScopes,
+    FactionInventory: exports.FactionInventoryScopes,
+};
+/**
+ * Helper function to get all character scopes
+ */
+function getAllCharacterScopes() {
+    return Object.values(exports.CharacterScopes);
+}
+/**
+ * Helper function to get all message scopes
+ */
+function getAllMessageScopes() {
+    return Object.values(exports.MessageScopes);
+}
+/**
+ * Helper function to get all personal inventory scopes
+ */
+function getAllPersonalInventoryScopes() {
+    const scopes = [exports.PersonalInventoryScopes.OVERVIEW];
+    // Add all entity-specific scopes
+    Object.entries(exports.PersonalInventoryScopes).forEach(([key, value]) => {
+        if (key !== 'OVERVIEW' && typeof value === 'object') {
+            scopes.push(...Object.values(value));
+        }
+    });
+    return scopes;
+}
+/**
+ * Helper function to get all faction scopes
+ */
+function getAllFactionScopes() {
+    return Object.values(exports.FactionScopes);
+}
+/**
+ * Helper function to get all faction inventory scopes
+ */
+function getAllFactionInventoryScopes() {
+    const scopes = [exports.FactionInventoryScopes.OVERVIEW];
+    // Add all entity-specific scopes
+    Object.entries(exports.FactionInventoryScopes).forEach(([key, value]) => {
+        if (key !== 'OVERVIEW' && typeof value === 'object') {
+            scopes.push(...Object.values(value));
+        }
+    });
+    return scopes;
+}
+/**
+ * Get all available scopes (for comprehensive testing)
+ */
+function getAllScopes() {
+    return [
+        ...getAllCharacterScopes(),
+        ...getAllMessageScopes(),
+        ...getAllPersonalInventoryScopes(),
+        ...getAllFactionScopes(),
+        ...getAllFactionInventoryScopes(),
+    ];
+}
+/**
+ * Get basic read-only scopes (good for read-only integrations)
+ */
+function getReadOnlyScopes() {
+    return [
+        exports.CharacterScopes.READ,
+        exports.CharacterScopes.STATS,
+        exports.CharacterScopes.PRIVILEGES,
+        exports.CharacterScopes.SKILLS,
+        exports.CharacterScopes.CREDITS,
+        exports.CharacterScopes.FORCE,
+        exports.CharacterScopes.LOCATION,
+        exports.CharacterScopes.EVENTS,
+        exports.MessageScopes.READ,
+        exports.PersonalInventoryScopes.OVERVIEW,
+        exports.FactionScopes.READ,
+        exports.FactionScopes.MEMBERS,
+        exports.FactionInventoryScopes.OVERVIEW,
+    ];
+}
+/**
+ * Get minimal scopes for basic character info (authentication only)
+ */
+function getMinimalScopes() {
+    return [exports.CharacterScopes.AUTH, exports.CharacterScopes.READ];
+}
+//# sourceMappingURL=scopes.js.map

package/dist/cjs/auth/scopes.js.map

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

package/dist/cjs/http/HttpClient.js

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * HTTP client for making requests to SW Combine API
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const errors_js_1 = require("./errors.js");
+/**
+ * HTTP client that handles requests, retries, and token refresh
+ */
+class HttpClient {
+    constructor(options, tokenManager) {
+        this.tokenManager = tokenManager;
+        this.maxRetries = options.maxRetries ?? 3;
+        this.retryDelay = options.retryDelay ?? 1000;
+        this.debug = options.debug ?? false;
+        // Create axios instance
+        this.axios = axios_1.default.create({
+            baseURL: options.baseURL ?? 'https://www.swcombine.com/ws/v2.0/',
+            timeout: options.timeout ?? 30000,
+            headers: {
+                'Accept': 'application/json',
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+        });
+        // Set up interceptors
+        this.setupRequestInterceptor();
+        this.setupResponseInterceptor();
+    }
+    /**
+     * Set up request interceptor to add auth token
+     */
+    setupRequestInterceptor() {
+        this.axios.interceptors.request.use(async (config) => {
+            // Add access token if available
+            if (this.tokenManager) {
+                try {
+                    const token = await this.tokenManager.getAccessToken();
+                    if (token) {
+                        // Try query parameter method instead of header
+                        // SW Combine API docs say: "Access tokens are sent to a Resource in the HTTP
+                        // Authorization header, or as a query string parameter"
+                        config.params = config.params || {};
+                        config.params.access_token = token;
+                        if (this.debug) {
+                            console.log(`[SWC SDK] Added auth token as query param: ${token.substring(0, 20)}...`);
+                        }
+                    }
+                    else {
+                        if (this.debug) {
+                            console.log(`[SWC SDK] No token available from TokenManager`);
+                        }
+                    }
+                }
+                catch (error) {
+                    if (this.debug) {
+                        console.log(`[SWC SDK] Error getting token: ${error.message}`);
+                    }
+                    // Don't fail the request, just proceed without token
+                }
+            }
+            if (this.debug) {
+                console.log(`[SWC SDK] ${config.method?.toUpperCase()} ${config.url}`);
+                console.log(`[SWC SDK] Query params:`, config.params);
+            }
+            return config;
+        }, (error) => {
+            return Promise.reject(error);
+        });
+    }
+    /**
+     * Set up response interceptor to handle errors and retries
+     */
+    setupResponseInterceptor() {
+        this.axios.interceptors.response.use((response) => {
+            // Extract data from swcapi wrapper if present
+            if (response.data && typeof response.data === 'object' && 'swcapi' in response.data) {
+                const swcapiData = response.data.swcapi;
+                // Get the first key's value (e.g., swcapi.character -> character data)
+                const keys = Object.keys(swcapiData);
+                if (keys.length === 1) {
+                    response.data = swcapiData[keys[0]];
+                }
+                else {
+                    // If multiple keys or no keys, return the swcapi object itself
+                    response.data = swcapiData;
+                }
+            }
+            return response;
+        }, async (error) => {
+            const config = error.config;
+            // Handle 401 - attempt token refresh
+            if (error.response?.status === 401 && this.tokenManager) {
+                try {
+                    await this.tokenManager.refreshToken();
+                    // Retry the request with new token
+                    return this.axios.request(config);
+                }
+                catch (refreshError) {
+                    // Token refresh failed, throw auth error
+                    throw errors_js_1.SWCError.fromHttpResponse(401, error.response?.data, error.response?.headers['x-request-id']);
+                }
+            }
+            // Handle retryable errors
+            if (this.shouldRetry(error, config._retryCount ?? 0)) {
+                config._retryCount = (config._retryCount ?? 0) + 1;
+                // Wait before retrying (exponential backoff)
+                const delay = this.retryDelay * Math.pow(2, config._retryCount - 1);
+                await this.sleep(delay);
+                if (this.debug) {
+                    console.log(`[SWC SDK] Retrying request (attempt ${config._retryCount}/${this.maxRetries})`);
+                }
+                return this.axios.request(config);
+            }
+            // Convert to SWCError
+            if (error.response) {
+                throw errors_js_1.SWCError.fromHttpResponse(error.response.status, error.response.data, error.response.headers['x-request-id']);
+            }
+            else if (error.request) {
+                throw errors_js_1.SWCError.fromNetworkError(error);
+            }
+            else {
+                throw new errors_js_1.SWCError(error.message, {
+                    type: 'unknown',
+                    cause: error,
+                });
+            }
+        });
+    }
+    /**
+     * Determine if a request should be retried
+     */
+    shouldRetry(error, retryCount) {
+        // Don't retry if we've exceeded max retries
+        if (retryCount >= this.maxRetries) {
+            return false;
+        }
+        // Network errors are retryable
+        if (!error.response) {
+            return true;
+        }
+        const status = error.response.status;
+        const responseData = error.response.data;
+        // Check if HTTP 400 is actually a rate limit error
+        const isRateLimitError = status === 400 &&
+            (responseData?.error === 'rate_limit_exceeded' ||
+                responseData?.message?.toLowerCase().includes('rate limit') ||
+                responseData?.error_description?.toLowerCase().includes('rate limit'));
+        // Retry rate limit errors (429 or 400 with rate limit content)
+        if (status === 429 || isRateLimitError) {
+            return true;
+        }
+        // Don't retry other 4xx errors
+        if (status >= 400 && status < 500) {
+            return false;
+        }
+        // Retry 5xx server errors
+        if (status >= 500) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Make a GET request
+     */
+    async get(url, config) {
+        const response = await this.axios.get(url, config);
+        return response.data;
+    }
+    /**
+     * Make a POST request
+     */
+    async post(url, data, config) {
+        const response = await this.axios.post(url, data, config);
+        return response.data;
+    }
+    /**
+     * Make a PUT request
+     */
+    async put(url, data, config) {
+        const response = await this.axios.put(url, data, config);
+        return response.data;
+    }
+    /**
+     * Make a DELETE request
+     */
+    async delete(url, config) {
+        const response = await this.axios.delete(url, config);
+        return response.data;
+    }
+    /**
+     * Make a custom request
+     */
+    async request(config) {
+        const response = await this.axios.request(config);
+        return response.data;
+    }
+    /**
+     * Set token manager (useful for late initialization)
+     */
+    setTokenManager(tokenManager) {
+        this.tokenManager = tokenManager;
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=HttpClient.js.map

package/dist/cjs/http/HttpClient.js.map

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

package/dist/cjs/http/errors.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * Error handling for SW Combine SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SWCError = void 0;
+/**
+ * Custom error class for SW Combine API errors
+ */
+class SWCError extends Error {
+    constructor(message, options) {
+        super(message);
+        this.name = 'SWCError';
+        this.type = options.type;
+        this.statusCode = options.statusCode;
+        this.requestId = options.requestId;
+        this.response = options.response;
+        this.retryable = options.retryable ?? this.determineRetryable(options.type, options.statusCode);
+        this.retryAfter = options.retryAfter;
+        this.cause = options.cause;
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, SWCError);
+        }
+    }
+    /**
+     * Determine if an error is retryable based on type and status code
+     */
+    determineRetryable(type, statusCode) {
+        // Network errors are always retryable
+        if (type === 'network') {
+            return true;
+        }
+        // Server errors (5xx) are retryable
+        if (type === 'server' || (statusCode && statusCode >= 500 && statusCode < 600)) {
+            return true;
+        }
+        // Rate limit errors are technically retryable (with backoff)
+        if (type === 'rate_limit') {
+            return true;
+        }
+        // Everything else is not retryable
+        return false;
+    }
+    /**
+     * Create an error from an HTTP status code and response
+     */
+    static fromHttpResponse(statusCode, response, requestId) {
+        let type;
+        let message;
+        // Check if this is a rate limit error (SW Combine uses HTTP 400 for rate limiting)
+        const isRateLimitError = statusCode === 400 &&
+            (response?.error === 'rate_limit_exceeded' ||
+                response?.message?.toLowerCase().includes('rate limit') ||
+                response?.error_description?.toLowerCase().includes('rate limit'));
+        // Determine error type from status code and content
+        if (isRateLimitError) {
+            type = 'rate_limit';
+            message = 'Rate limit exceeded. Please wait before making more requests.';
+        }
+        else {
+            switch (statusCode) {
+                case 401:
+                    type = 'auth';
+                    message = 'Authentication failed. Check your credentials or token.';
+                    break;
+                case 403:
+                    type = 'auth';
+                    message = 'Forbidden. You do not have permission to access this resource.';
+                    break;
+                case 404:
+                    type = 'not_found';
+                    message = 'Resource not found.';
+                    break;
+                case 400:
+                case 422:
+                    type = 'validation';
+                    message = 'Invalid request parameters.';
+                    break;
+                case 429:
+                    type = 'rate_limit';
+                    message = 'Rate limit exceeded. Please wait before making more requests.';
+                    break;
+                default:
+                    if (statusCode >= 500) {
+                        type = 'server';
+                        message = 'Server error occurred. Please try again later.';
+                    }
+                    else {
+                        type = 'unknown';
+                        message = 'An unknown error occurred.';
+                    }
+            }
+        }
+        // Use error message from response if available
+        if (response?.error_description) {
+            message = response.error_description;
+        }
+        else if (response?.message) {
+            message = response.message;
+        }
+        else if (response?.error) {
+            message = typeof response.error === 'string' ? response.error : message;
+        }
+        // Extract retry-after header for rate limit errors
+        const retryAfter = type === 'rate_limit' ? response?.retry_after : undefined;
+        return new SWCError(message, {
+            type,
+            statusCode,
+            requestId,
+            response,
+            retryAfter,
+        });
+    }
+    /**
+     * Create an error from a network failure
+     */
+    static fromNetworkError(error) {
+        return new SWCError(`Network error: ${error.message}`, {
+            type: 'network',
+            retryable: true,
+            cause: error,
+        });
+    }
+    /**
+     * Check if an error is a SWCError
+     */
+    static isSWCError(error) {
+        return error instanceof SWCError;
+    }
+    /**
+     * Get a user-friendly error message
+     */
+    toUserFriendlyMessage() {
+        switch (this.type) {
+            case 'auth':
+                return 'Authentication failed. Please check your credentials and try again.';
+            case 'rate_limit':
+                return this.retryAfter
+                    ? `Rate limit exceeded. Please wait ${this.retryAfter} seconds before trying again.`
+                    : 'Rate limit exceeded. Please wait before making more requests.';
+            case 'not_found':
+                return 'The requested resource was not found.';
+            case 'validation':
+                return 'Invalid request. Please check your parameters and try again.';
+            case 'server':
+                return 'A server error occurred. Please try again later.';
+            case 'network':
+                return 'Network connection failed. Please check your internet connection and try again.';
+            default:
+                return 'An unexpected error occurred. Please try again.';
+        }
+    }
+}
+exports.SWCError = SWCError;
+//# sourceMappingURL=errors.js.map