swcombine.js 0.0.11 → 0.1.0

package/dist/src/auth/oauth-manager.d.ts

@@ -0,0 +1,168 @@
+/**
+ * OAuth Manager for handling complete OAuth flow with token management
+ */
+import type { OAuthConfig, StoredTokens, AuthorizationUrlParams, TokenResponse } from "./types.ts";
+/**
+ * Token storage interface - implement this to persist tokens
+ */
+export interface TokenStorage {
+    /** Get stored tokens */
+    get(): Promise<StoredTokens | null> | StoredTokens | null;
+    /** Store tokens */
+    set(tokens: StoredTokens): Promise<void> | void;
+    /** Clear stored tokens */
+    clear(): Promise<void> | void;
+}
+/**
+ * In-memory token storage (not persistent across restarts)
+ */
+export declare class MemoryTokenStorage implements TokenStorage {
+    private tokens;
+    get(): StoredTokens | null;
+    set(tokens: StoredTokens): void;
+    clear(): void;
+}
+/**
+ * OAuth Manager - handles complete OAuth flow with automatic token refresh
+ *
+ * Can be used in two modes:
+ * 1. Full mode (with storage): Complete OAuth flow with token persistence
+ * 2. Utility mode (without storage): Generate auth URLs and manually refresh tokens
+ *
+ * @example Full mode with storage
+ * ```ts
+ * const oauth = new OAuthManager(
+ *   {
+ *     clientId: "your-client-id",
+ *     clientSecret: "your-client-secret",
+ *     redirectUri: "https://example.com/callback",
+ *     defaultScopes: [ScopeKey.CharacterRead, ScopeKey.FactionMembers],
+ *   },
+ *   storage // TokenStorage instance
+ * );
+ *
+ * // 1. Generate authorization URL
+ * const authUrl = oauth.getAuthorizationUrl({
+ *   state: "random-state",
+ *   accessType: "offline", // Get refresh token
+ * });
+ *
+ * // 2. After user authorizes and returns with code
+ * await oauth.handleCallback("authorization-code");
+ *
+ * // 3. Get valid access token (auto-refreshes if needed)
+ * const token = await oauth.getAccessToken();
+ *
+ * // 4. Use token in API calls
+ * // ...
+ *
+ * // 5. Revoke when done
+ * await oauth.revoke();
+ * ```
+ *
+ * @example Utility mode without storage
+ * ```ts
+ * const oauth = new OAuthManager({
+ *   clientId: "your-client-id",
+ *   clientSecret: "your-client-secret",
+ *   redirectUri: "https://example.com/callback",
+ * });
+ *
+ * // Generate auth URL
+ * const authUrl = oauth.getAuthorizationUrl({ scopes: [...] });
+ *
+ * // Manually refresh a token
+ * const tokens = await oauth.refreshAccessToken(refreshToken);
+ * ```
+ */
+export declare class OAuthManager {
+    private config;
+    private storage;
+    constructor(config: OAuthConfig, storage?: TokenStorage);
+    /**
+     * Generate authorization URL to redirect users to
+     *
+     * @param options - Optional parameters (scopes, state, accessType, etc.)
+     * @returns Authorization URL
+     */
+    getAuthorizationUrl(options?: Partial<Omit<AuthorizationUrlParams, "clientId" | "redirectUri">>): string;
+    /**
+     * Handle OAuth callback by exchanging code for tokens
+     *
+     * Requires storage to be configured.
+     *
+     * @param code - Authorization code from callback
+     * @returns Token response
+     * @throws {SWCOAuthError} If storage is not configured
+     */
+    handleCallback(code: string): Promise<TokenResponse>;
+    /**
+     * Get a valid access token, automatically refreshing if expired
+     *
+     * Requires storage to be configured.
+     *
+     * @returns Current access token
+     * @throws {SWCOAuthError} If storage is not configured, no tokens are stored, or refresh fails
+     */
+    getAccessToken(): Promise<string>;
+    /**
+     * Manually refresh an access token using a refresh token
+     *
+     * This is a utility method that doesn't require storage. Useful for
+     * manually managing tokens or refreshing tokens obtained elsewhere.
+     *
+     * @param refreshToken - The refresh token to use
+     * @returns New token response with fresh access token
+     * @throws {SWCOAuthError} If refresh fails
+     */
+    refreshAccessToken(refreshToken: string): Promise<TokenResponse>;
+    /**
+     * Check if user is authenticated (has valid or refreshable tokens)
+     *
+     * Requires storage to be configured.
+     *
+     * @throws {SWCOAuthError} If storage is not configured
+     */
+    isAuthenticated(): Promise<boolean>;
+    /**
+     * Get stored tokens (if any)
+     *
+     * Requires storage to be configured.
+     *
+     * @throws {SWCOAuthError} If storage is not configured
+     */
+    getStoredTokens(): Promise<StoredTokens | null>;
+    /**
+     * Manually set tokens (useful for restoring from external storage)
+     *
+     * Requires storage to be configured.
+     *
+     * @throws {SWCOAuthError} If storage is not configured
+     */
+    setTokens(tokens: StoredTokens): Promise<void>;
+    /**
+     * Revoke the current refresh token and clear stored tokens
+     *
+     * Requires storage to be configured.
+     *
+     * @throws {SWCOAuthError} If storage is not configured
+     */
+    revoke(): Promise<void>;
+    /**
+     * Clear stored tokens without revoking them
+     *
+     * Requires storage to be configured.
+     *
+     * @throws {SWCOAuthError} If storage is not configured
+     */
+    logout(): Promise<void>;
+    /**
+     * Store tokens with expiration calculation
+     */
+    private storeTokens;
+    /**
+     * Check if storage is configured and throw error if not
+     */
+    private requireStorage;
+}
+//# sourceMappingURL=oauth-manager.d.ts.map

package/dist/src/auth/oauth-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-manager.d.ts","sourceRoot":"","sources":["../../../src/auth/oauth-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,GAAG,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,YAAY,GAAG,IAAI,CAAC;IAC1D,mBAAmB;IACnB,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAChD,0BAA0B;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,MAAM,CAA6B;IAE3C,GAAG,IAAI,YAAY,GAAG,IAAI;IAI1B,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAI/B,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAsB;gBAEzB,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,YAAY;IAKvD;;;;;OAKG;IACH,mBAAmB,CACjB,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,UAAU,GAAG,aAAa,CAAC,CAAC,GAC1E,MAAM;IAWT;;;;;;;;OAQG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAgB1D;;;;;;;OAOG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAuCvC;;;;;;;;;OASG;IACG,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAQtE;;;;;;OAMG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAazC;;;;;;OAMG;IACG,eAAe,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAKrD;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD;;;;;;OAMG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB7B;;;;;;OAMG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B;;OAEG;YACW,WAAW;IAazB;;OAEG;IACH,OAAO,CAAC,cAAc;CASvB"}

package/dist/src/auth/oauth.d.ts

@@ -0,0 +1,101 @@
+/**
+ * OAuth 2.0 implementation for SWC Combine API
+ *
+ * Key quirks:
+ * - Uses "Authorization: OAuth TOKEN" instead of "Bearer"
+ * - Refresh tokens only returned on first exchange with access_type=offline
+ * - Consent is persisted after initial grant
+ */
+import type { AuthorizationUrlParams, TokenExchangeParams, TokenRefreshParams, TokenResponse, OAuthError, TokenRevokeParams } from "./types.ts";
+/**
+ * SWC Combine OAuth error
+ */
+export declare class SWCOAuthError extends Error {
+    code: string;
+    description?: string | undefined;
+    constructor(message: string, code: string, description?: string | undefined);
+    static fromResponse(error: OAuthError): SWCOAuthError;
+}
+/**
+ * Generate the OAuth authorization URL
+ *
+ * @param params - Authorization URL parameters
+ * @returns The complete authorization URL to redirect users to
+ *
+ * @example
+ * ```ts
+ * const url = generateAuthorizationUrl({
+ *   clientId: "your-client-id",
+ *   redirectUri: "https://example.com/callback",
+ *   scopes: [ScopeKey.CharacterRead, ScopeKey.FactionMembers],
+ *   state: "random-state-string",
+ *   accessType: "offline", // To get refresh token
+ * });
+ *
+ * // Redirect user to this URL
+ * window.location.href = url;
+ * ```
+ */
+export declare function generateAuthorizationUrl(params: AuthorizationUrlParams): string;
+/**
+ * Exchange authorization code for access token
+ *
+ * @param params - Token exchange parameters
+ * @returns Token response with access_token and optional refresh_token
+ * @throws {SWCOAuthError} If the exchange fails
+ *
+ * @example
+ * ```ts
+ * // After user is redirected back with code
+ * const tokens = await exchangeCodeForToken({
+ *   code: "authorization-code-from-callback",
+ *   clientId: "your-client-id",
+ *   clientSecret: "your-client-secret",
+ *   redirectUri: "https://example.com/callback",
+ * });
+ *
+ * console.log(tokens.access_token);
+ * if (tokens.refresh_token) {
+ *   // Store refresh token securely for future use
+ * }
+ * ```
+ */
+export declare function exchangeCodeForToken(params: TokenExchangeParams): Promise<TokenResponse>;
+/**
+ * Refresh an access token using a refresh token
+ *
+ * @param params - Token refresh parameters
+ * @returns New token response with fresh access_token
+ * @throws {SWCOAuthError} If the refresh fails
+ *
+ * @example
+ * ```ts
+ * const newTokens = await refreshAccessToken({
+ *   refreshToken: "stored-refresh-token",
+ *   clientId: "your-client-id",
+ *   clientSecret: "your-client-secret",
+ * });
+ *
+ * console.log(newTokens.access_token);
+ * // Note: refresh_token is NOT included in response
+ * ```
+ */
+export declare function refreshAccessToken(params: TokenRefreshParams): Promise<TokenResponse>;
+/**
+ * Revoke a token (typically a refresh token)
+ *
+ * @param params - Token revocation parameters
+ * @throws {SWCOAuthError} If the revocation fails
+ *
+ * @example
+ * ```ts
+ * await revokeToken({
+ *   token: "refresh-token-to-revoke",
+ *   clientId: "your-client-id",
+ * });
+ *
+ * console.log("Token revoked successfully");
+ * ```
+ */
+export declare function revokeToken(params: TokenRevokeParams): Promise<void>;
+//# sourceMappingURL=oauth.d.ts.map

package/dist/src/auth/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../../src/auth/oauth.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAG7B,IAAI,EAAE,MAAM;IACZ,WAAW,CAAC,EAAE,MAAM;gBAF3B,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,YAAA;IAM7B,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa;CAOtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,sBAAsB,GAC7B,MAAM,CAuBR;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAwBxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,aAAa,CAAC,CAuBxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAa1E"}

package/dist/src/auth/scopes.d.ts

@@ -0,0 +1,61 @@
+/**
+ * OAuth scopes for SWC Combine API
+ *
+ * Scopes define what permissions your application has access to.
+ * Many scopes inherit from others, granting all permissions of their parent scopes.
+ */
+/**
+ * All available OAuth scope keys as string literals
+ */
+export type ScopeKey = "character_auth" | "character_read" | "character_stats" | "character_privileges" | "character_skills" | "character_credits" | "character_credits_write" | "character_force" | "character_location" | "character_events" | "character_all" | "messages_read" | "messages_send" | "messages_delete" | "messages_all" | "personal_inv_overview" | "personal_inv_ships_read" | "personal_inv_ships_rename" | "personal_inv_ships_assign" | "personal_inv_ships_makeover" | "personal_inv_ships_tags_read" | "personal_inv_ships_tags_write" | "personal_inv_ships_all" | "personal_inv_vehicles_read" | "personal_inv_vehicles_rename" | "personal_inv_vehicles_assign" | "personal_inv_vehicles_makeover" | "personal_inv_vehicles_tags_read" | "personal_inv_vehicles_tags_write" | "personal_inv_vehicles_all" | "personal_inv_stations_read" | "personal_inv_stations_rename" | "personal_inv_stations_assign" | "personal_inv_stations_makeover" | "personal_inv_stations_tags_read" | "personal_inv_stations_tags_write" | "personal_inv_stations_all" | "personal_inv_cities_read" | "personal_inv_cities_rename" | "personal_inv_cities_assign" | "personal_inv_cities_makeover" | "personal_inv_cities_tags_read" | "personal_inv_cities_tags_write" | "personal_inv_cities_all" | "personal_inv_facilities_read" | "personal_inv_facilities_rename" | "personal_inv_facilities_assign" | "personal_inv_facilities_makeover" | "personal_inv_facilities_tags_read" | "personal_inv_facilities_tags_write" | "personal_inv_facilities_all" | "personal_inv_planets_read" | "personal_inv_planets_assign" | "personal_inv_planets_tags_read" | "personal_inv_planets_tags_write" | "personal_inv_planets_all" | "personal_inv_items_read" | "personal_inv_items_rename" | "personal_inv_items_assign" | "personal_inv_items_makeover" | "personal_inv_items_tags_read" | "personal_inv_items_tags_write" | "personal_inv_items_all" | "personal_inv_npcs_read" | "personal_inv_npcs_assign" | "personal_inv_npcs_makeover" | "personal_inv_npcs_tags_read" | "personal_inv_npcs_tags_write" | "personal_inv_npcs_all" | "personal_inv_droids_read" | "personal_inv_droids_rename" | "personal_inv_droids_assign" | "personal_inv_droids_makeover" | "personal_inv_droids_tags_read" | "personal_inv_droids_tags_write" | "personal_inv_droids_all" | "personal_inv_materials_read" | "personal_inv_materials_rename" | "personal_inv_materials_makeover" | "personal_inv_materials_tags_read" | "personal_inv_materials_tags_write" | "personal_inv_materials_all" | "personal_inv_creatures_read" | "personal_inv_creatures_rename" | "personal_inv_creatures_assign" | "personal_inv_creatures_makeover" | "personal_inv_creatures_tags_read" | "personal_inv_creatures_tags_write" | "personal_inv_creatures_all" | "faction_inv_overview" | "faction_inv_ships_read" | "faction_inv_ships_rename" | "faction_inv_ships_assign" | "faction_inv_ships_makeover" | "faction_inv_ships_tags_read" | "faction_inv_ships_tags_write" | "faction_inv_ships_all" | "faction_inv_vehicles_read" | "faction_inv_vehicles_rename" | "faction_inv_vehicles_assign" | "faction_inv_vehicles_makeover" | "faction_inv_vehicles_tags_read" | "faction_inv_vehicles_tags_write" | "faction_inv_vehicles_all" | "faction_inv_stations_read" | "faction_inv_stations_rename" | "faction_inv_stations_assign" | "faction_inv_stations_makeover" | "faction_inv_stations_tags_read" | "faction_inv_stations_tags_write" | "faction_inv_stations_all" | "faction_inv_cities_read" | "faction_inv_cities_rename" | "faction_inv_cities_assign" | "faction_inv_cities_makeover" | "faction_inv_cities_tags_read" | "faction_inv_cities_tags_write" | "faction_inv_cities_all" | "faction_inv_facilities_read" | "faction_inv_facilities_rename" | "faction_inv_facilities_assign" | "faction_inv_facilities_makeover" | "faction_inv_facilities_tags_read" | "faction_inv_facilities_tags_write" | "faction_inv_facilities_all" | "faction_inv_planets_read" | "faction_inv_planets_assign" | "faction_inv_planets_tags_read" | "faction_inv_planets_tags_write" | "faction_inv_planets_all" | "faction_inv_items_read" | "faction_inv_items_rename" | "faction_inv_items_assign" | "faction_inv_items_makeover" | "faction_inv_items_tags_read" | "faction_inv_items_tags_write" | "faction_inv_items_all" | "faction_inv_npcs_read" | "faction_inv_npcs_assign" | "faction_inv_npcs_makeover" | "faction_inv_npcs_tags_read" | "faction_inv_npcs_tags_write" | "faction_inv_npcs_all" | "faction_inv_droids_read" | "faction_inv_droids_rename" | "faction_inv_droids_assign" | "faction_inv_droids_makeover" | "faction_inv_droids_tags_read" | "faction_inv_droids_tags_write" | "faction_inv_droids_all" | "faction_inv_materials_read" | "faction_inv_materials_rename" | "faction_inv_materials_makeover" | "faction_inv_materials_tags_read" | "faction_inv_materials_tags_write" | "faction_inv_materials_all" | "faction_inv_creatures_read" | "faction_inv_creatures_rename" | "faction_inv_creatures_assign" | "faction_inv_creatures_makeover" | "faction_inv_creatures_tags_read" | "faction_inv_creatures_tags_write" | "faction_inv_creatures_all" | "faction_read" | "faction_members" | "faction_stocks" | "faction_credits_read" | "faction_credits_write" | "faction_budgets_read" | "faction_budgets_write" | "faction_datacards_read" | "faction_datacards_write" | "faction_all";
+/**
+ * Scope information
+ */
+export interface Scope {
+    /** Scope name */
+    name: ScopeKey;
+    /** Human-readable description of what this scope allows */
+    description: string;
+    /** Scopes that this scope inherits from */
+    inherits: ScopeKey[];
+}
+/**
+ * Record of all available scopes with their metadata
+ *
+ * @example
+ * ```typescript
+ * const scope = Scopes['character_read'];
+ * console.log(scope.description); // "Read basic character information..."
+ * console.log(scope.inherits); // []
+ * ```
+ */
+export declare const Scopes: Record<ScopeKey, Scope>;
+/**
+ * Array of all scope keys for iteration
+ */
+export declare const ALL_SCOPE_KEYS: ScopeKey[];
+/**
+ * Check if a string is a valid scope key
+ */
+export declare function isValidScope(scope: string): scope is ScopeKey;
+/**
+ * Convert an array of ScopeKeys to a space-delimited string for OAuth
+ *
+ * @example
+ * ```typescript
+ * const scopeString = scopesToString(['character_read', 'faction_members']);
+ * // Returns: "character_read faction_members"
+ * ```
+ */
+export declare function scopesToString(scopes: ScopeKey[]): string;
+/**
+ * Parse a space-delimited scope string into an array of ScopeKeys
+ *
+ * @example
+ * ```typescript
+ * const scopes = scopesFromString("character_read faction_members");
+ * // Returns: ['character_read', 'faction_members']
+ * ```
+ */
+export declare function scopesFromString(scopeString: string): ScopeKey[];
+//# sourceMappingURL=scopes.d.ts.map

package/dist/src/auth/scopes.d.ts.map

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

package/dist/src/auth/types.d.ts

@@ -0,0 +1,118 @@
+/**
+ * OAuth 2.0 types for SWC Combine API
+ */
+import type { ScopeKey } from "./scopes.ts";
+/**
+ * Access type for OAuth authorization
+ * - online: Access token only (default)
+ * - offline: Includes refresh token for long-lived access
+ */
+export type AccessType = "online" | "offline";
+/**
+ * Parameters for generating the OAuth authorization URL
+ */
+export interface AuthorizationUrlParams {
+    /** Your registered application client ID */
+    clientId: string;
+    /** Registered redirect URI where the authorization response will be sent */
+    redirectUri: string;
+    /** Array of permission scopes the application requests */
+    scopes: ScopeKey[];
+    /** Custom value returned in response for state management (CSRF protection) */
+    state?: string;
+    /** Access type: 'online' (default) or 'offline' for refresh token */
+    accessType?: AccessType;
+    /** Set to 'yes' to renew previously granted permissions not in current scope */
+    renewPreviouslyGranted?: boolean;
+}
+/**
+ * Authorization response from the OAuth callback
+ */
+export interface AuthorizationResponse {
+    /** Authorization code to exchange for access token */
+    code?: string;
+    /** Error code if authorization was denied */
+    error?: string;
+    /** State value passed in the authorization request */
+    state?: string;
+}
+/**
+ * Parameters for exchanging authorization code for tokens
+ */
+export interface TokenExchangeParams {
+    /** Authorization code from the callback */
+    code: string;
+    /** Your application's client ID */
+    clientId: string;
+    /** Your application's client secret */
+    clientSecret: string;
+    /** Redirect URI used in authorization (must match exactly) */
+    redirectUri: string;
+}
+/**
+ * Parameters for refreshing an access token
+ */
+export interface TokenRefreshParams {
+    /** Refresh token obtained during initial token exchange */
+    refreshToken: string;
+    /** Your application's client ID */
+    clientId: string;
+    /** Your application's client secret */
+    clientSecret: string;
+}
+/**
+ * Successful token response from the API
+ */
+export interface TokenResponse {
+    /** Bearer token for API calls */
+    access_token: string;
+    /** Token lifetime in seconds */
+    expires_in: number;
+    /** Refresh token (only present if access_type=offline was used) */
+    refresh_token?: string;
+    /** Token type (always "Bearer") */
+    token_type?: string;
+}
+/**
+ * Error response from OAuth endpoints
+ */
+export interface OAuthError {
+    /** Error code */
+    error: string;
+    /** Human-readable error description */
+    error_description?: string;
+}
+/**
+ * Parameters for revoking a token
+ */
+export interface TokenRevokeParams {
+    /** The token to revoke (typically refresh_token) */
+    token: string;
+    /** Your application's client ID */
+    clientId: string;
+}
+/**
+ * Configuration for OAuth client
+ */
+export interface OAuthConfig {
+    /** Your application's client ID */
+    clientId: string;
+    /** Your application's client secret */
+    clientSecret: string;
+    /** Registered redirect URI */
+    redirectUri: string;
+    /** Default scopes to request */
+    defaultScopes?: ScopeKey[];
+}
+/**
+ * Stored token information
+ */
+export interface StoredTokens {
+    /** Access token */
+    accessToken: string;
+    /** Refresh token (if available) */
+    refreshToken?: string;
+    /** Expiration timestamp (milliseconds since epoch) */
+    expiresAt: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/auth/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/auth/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,gFAAgF;IAChF,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/src/client/base-resource.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Base class for all API resource classes
+ */
+import type { SWCClient } from "./client.ts";
+import type { RequestOptions } from "./types.ts";
+/**
+ * Base resource class that provides HTTP methods for child resources
+ */
+export declare abstract class BaseResource {
+    protected readonly client: SWCClient;
+    constructor(client: SWCClient);
+    /**
+     * Make a GET request
+     */
+    protected request_get(endpoint: string, options?: RequestOptions): Promise<any>;
+    /**
+     * Make a POST request
+     */
+    protected request_post(endpoint: string, body?: any, options?: RequestOptions): Promise<any>;
+    /**
+     * Make a PUT request
+     */
+    protected request_put(endpoint: string, body?: any, options?: RequestOptions): Promise<any>;
+    /**
+     * Make a PATCH request
+     */
+    protected request_patch(endpoint: string, body?: any, options?: RequestOptions): Promise<any>;
+    /**
+     * Make a DELETE request
+     */
+    protected request_delete(endpoint: string, body?: any, options?: RequestOptions): Promise<any>;
+}
+//# sourceMappingURL=base-resource.d.ts.map

package/dist/src/client/base-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-resource.d.ts","sourceRoot":"","sources":["../../../src/client/base-resource.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,8BAAsB,YAAY;IACpB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS;gBAAjB,MAAM,EAAE,SAAS;IAEhD;;OAEG;cACa,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC;IAQrF;;OAEG;cACa,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,GAAG,CAAC;IASf;;OAEG;cACa,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,GAAG,CAAC;IASf;;OAEG;cACa,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,GAAG,CAAC;IASf;;OAEG;cACa,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,GAAG,CAAC;CAQhB"}

package/dist/src/client/client.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Main SWC API Client
+ */
+import type { OAuthManager } from "../auth/oauth-manager.ts";
+import type { RequestConfig, SWCResponse } from "./types.ts";
+import { ApiResource, CharacterResource, FactionResource, InventoryResource } from "./resources/index.ts";
+/**
+ * Configuration options for SWCClient
+ */
+export interface SWCClientConfig {
+    /** Authentication: either an OAuthManager instance or a direct access token string */
+    auth: OAuthManager | string;
+    /** Base URL for the API (defaults to SWC API v2.0) */
+    baseUrl?: string;
+}
+/**
+ * Main client for interacting with the Star Wars Combine API
+ *
+ * @example With OAuthManager
+ * ```typescript
+ * import { OAuthManager, SWCClient } from "swcombine.js";
+ *
+ * const oauth = new OAuthManager(
+ *   {
+ *     clientId: "your-client-id",
+ *     clientSecret: "your-client-secret",
+ *     redirectUri: "https://example.com/callback",
+ *   },
+ *   storage
+ * );
+ *
+ * const client = new SWCClient({ auth: oauth });
+ *
+ * // Access resources
+ * const character = await client.character.get();
+ * const skills = await client.character.skills.get();
+ * const faction = await client.faction.get();
+ * ```
+ *
+ * @example With direct access token
+ * ```typescript
+ * import { SWCClient } from "swcombine.js";
+ *
+ * const client = new SWCClient({ auth: "your-access-token" });
+ *
+ * // Access resources (token won't auto-refresh)
+ * const character = await client.character.get();
+ * ```
+ */
+export declare class SWCClient {
+    private readonly httpClient;
+    /** API utility endpoints */
+    readonly api: ApiResource;
+    /** Character resource */
+    readonly character: CharacterResource;
+    /** Faction resource */
+    readonly faction: FactionResource;
+    /** Inventory resource */
+    readonly inventory: InventoryResource;
+    /**
+     * Create a new SWC API client
+     *
+     * @param oauth - OAuth manager instance for authentication (deprecated, use config object)
+     * @param baseUrl - Optional base URL (defaults to https://www.swcombine.com/ws/v2.0)
+     * @deprecated Use config object instead: `new SWCClient({ auth: oauth })`
+     */
+    constructor(oauth: OAuthManager, baseUrl?: string);
+    /**
+     * Create a new SWC API client
+     *
+     * @param config - Client configuration
+     */
+    constructor(config: SWCClientConfig);
+    /**
+     * Internal method used by resources to make requests
+     * @internal
+     */
+    request(config: RequestConfig): Promise<any>;
+    /**
+     * Internal method used by resources to make requests with full response
+     * @internal
+     */
+    requestWithResponse(config: RequestConfig): Promise<SWCResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC5B,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC,4BAA4B;IAC5B,SAAgB,GAAG,EAAE,WAAW,CAAC;IAEjC,yBAAyB;IACzB,SAAgB,SAAS,EAAE,iBAAiB,CAAC;IAE7C,uBAAuB;IACvB,SAAgB,OAAO,EAAE,eAAe,CAAC;IAEzC,yBAAyB;IACzB,SAAgB,SAAS,EAAE,iBAAiB,CAAC;IAE7C;;;;;;OAMG;gBACS,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM;IAEjD;;;;OAIG;gBACS,MAAM,EAAE,eAAe;IAkCnC;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC;IAKlD;;;OAGG;IACG,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;CAGvE"}

package/dist/src/client/errors.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Error classes for SWC API client
+ */
+import type { RateLimitInfo } from "./types.ts";
+/**
+ * Base error class for all SWC client errors
+ */
+export declare class SWCError extends Error {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Network-level errors (fetch failures, timeouts, etc.)
+ */
+export declare class NetworkError extends SWCError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Base class for API errors (4xx, 5xx status codes)
+ */
+export declare class APIError extends SWCError {
+    readonly statusCode: number;
+    readonly response?: any | undefined;
+    constructor(message: string, statusCode: number, response?: any | undefined);
+}
+/**
+ * Authentication error (401 Unauthorized)
+ */
+export declare class AuthenticationError extends APIError {
+    constructor(message: string, response?: any);
+}
+/**
+ * Authorization error (403 Forbidden)
+ */
+export declare class AuthorizationError extends APIError {
+    constructor(message: string, response?: any);
+}
+/**
+ * Validation error (400 Bad Request)
+ */
+export declare class ValidationError extends APIError {
+    constructor(message: string, response?: any);
+}
+/**
+ * Rate limit error (429 Too Many Requests)
+ */
+export declare class RateLimitError extends APIError {
+    readonly rateLimit: RateLimitInfo;
+    constructor(message: string, rateLimit: RateLimitInfo, response?: any);
+}
+/**
+ * Resource not found error (404 Not Found)
+ */
+export declare class NotFoundError extends APIError {
+    constructor(message: string, response?: any);
+}
+/**
+ * Server error (5xx status codes)
+ */
+export declare class ServerError extends APIError {
+    constructor(message: string, statusCode: number, response?: any);
+}
+//# sourceMappingURL=errors.d.ts.map