@claudetools/cli 0.13.12 → 0.13.15

package/dist/hooks/index.js

@@ -0,0 +1,403 @@
+/**
+ * Hooks management for ClaudeTools CLI
+ *
+ * Hooks are automation scripts that run in response to Claude events.
+ * The sync engine acts as a single dispatcher that executes hook chains.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync, readdirSync, copyFileSync, chmodSync } from 'fs';
+import { homedir } from 'os';
+import { join, basename } from 'path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+const HOOKS_DIR = join(homedir(), '.claude', 'hooks');
+const SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
+// Ensure hooks directory exists
+if (!existsSync(HOOKS_DIR)) {
+    mkdirSync(HOOKS_DIR, { recursive: true });
+}
+/**
+ * List installed hooks
+ */
+export async function runHooksList(options) {
+    const hooks = listInstalledHooks();
+    if (options?.json) {
+        console.log(JSON.stringify(hooks, null, 2));
+        return;
+    }
+    console.log();
+    if (hooks.length === 0) {
+        console.log('  No hooks installed.');
+        console.log('  Add with: claudetools hook add <name>');
+        console.log();
+        return;
+    }
+    console.log(`  Installed hooks (${hooks.length}):`);
+    console.log();
+    for (const hook of hooks) {
+        const eventIcon = getEventIcon(hook.event);
+        const asyncBadge = hook.async ? ' [async]' : '';
+        console.log(`  ${eventIcon} ${hook.name}${asyncBadge}`);
+        console.log(`    Event: ${hook.event}`);
+        if (hook.matcher && hook.matcher !== '*') {
+            console.log(`    Matcher: ${hook.matcher}`);
+        }
+        console.log(`    Command: ${hook.command}`);
+        console.log();
+    }
+}
+/**
+ * Add a hook to the hooks directory
+ */
+export async function runHookAdd(name, options) {
+    if (!name) {
+        console.error('Error: Missing hook name');
+        console.log('Usage: claudetools hook add <name> [options]');
+        process.exit(1);
+    }
+    // If it's a path, copy the hook script
+    if (name.startsWith('./') || name.startsWith('/') || name.startsWith('~')) {
+        await copyHookScript(name);
+        return;
+    }
+    // Otherwise create a new hook config
+    const event = options?.event || 'PreToolUse';
+    const matcher = options?.matcher || '*';
+    const command = options?.command;
+    if (!command) {
+        console.error('Error: Missing --command option');
+        console.log('Usage: claudetools hook add <name> --event <event> --command "<command>"');
+        process.exit(1);
+    }
+    const config = {
+        name,
+        event,
+        matcher,
+        command,
+        priority: options?.priority,
+        async: options?.async,
+        onFailure: options?.onFailure,
+    };
+    const configPath = join(HOOKS_DIR, `${name}.yaml`);
+    writeFileSync(configPath, stringifyYaml(config), 'utf-8');
+    console.log();
+    console.log(`  Added hook: ${name}`);
+    console.log(`  Event: ${event}`);
+    console.log(`  Command: ${command}`);
+    console.log();
+}
+/**
+ * Remove a hook
+ */
+export async function runHookRemove(name) {
+    if (!name) {
+        console.error('Error: Missing hook name');
+        console.log('Usage: claudetools hook remove <name>');
+        process.exit(1);
+    }
+    const configPath = join(HOOKS_DIR, `${name}.yaml`);
+    const scriptPath = join(HOOKS_DIR, `${name}.sh`);
+    let removed = false;
+    if (existsSync(configPath)) {
+        rmSync(configPath);
+        removed = true;
+    }
+    if (existsSync(scriptPath)) {
+        rmSync(scriptPath);
+        removed = true;
+    }
+    if (removed) {
+        console.log();
+        console.log(`  Removed hook: ${name}`);
+        console.log();
+    }
+    else {
+        console.error(`Hook not found: ${name}`);
+        process.exit(1);
+    }
+}
+/**
+ * Sanitize hook command for safe execution
+ * Validates against command injection patterns
+ */
+function sanitizeHookCommand(command) {
+    // Block shell injection patterns
+    const dangerousPatterns = [
+        /[;&|`$(){}[\]<>]/, // Shell metacharacters
+        /\n|\r/, // Newlines
+    ];
+    for (const pattern of dangerousPatterns) {
+        if (pattern.test(command)) {
+            throw new Error('Hook command contains potentially dangerous characters');
+        }
+    }
+    return command.trim();
+}
+/**
+ * Test a hook
+ */
+export async function runHookTest(name, options) {
+    if (!name) {
+        console.error('Error: Missing hook name');
+        console.log('Usage: claudetools hook test <name> --tool <tool>');
+        process.exit(1);
+    }
+    const config = loadHookConfig(name);
+    if (!config) {
+        console.error(`Hook not found: ${name}`);
+        process.exit(1);
+    }
+    const event = options?.event || config.event;
+    const tool = options?.tool || 'TestTool';
+    console.log();
+    console.log(`  Testing hook: ${name}`);
+    console.log(`  Event: ${event}`);
+    console.log(`  Tool: ${tool}`);
+    console.log();
+    // Check if matcher would match
+    const wouldMatch = matchesPattern(config.matcher || '*', tool);
+    console.log(`  Matcher: ${config.matcher || '*'}`);
+    console.log(`  Would match: ${wouldMatch ? 'Yes' : 'No'}`);
+    console.log();
+    if (!wouldMatch) {
+        console.log('  Hook would not execute for this tool.');
+        return;
+    }
+    // Execute the hook
+    console.log('  Executing command...');
+    console.log();
+    try {
+        const sanitizedCommand = sanitizeHookCommand(config.command);
+        const { spawn } = await import('child_process');
+        const child = spawn('sh', ['-c', sanitizedCommand], {
+            env: {
+                ...process.env,
+                CLAUDETOOLS_EVENT: event,
+                CLAUDETOOLS_TOOL: tool,
+            },
+            stdio: 'inherit',
+        });
+        await new Promise((resolve) => {
+            child.on('close', (code) => {
+                console.log();
+                console.log(`  Exit code: ${code}`);
+                console.log();
+                resolve();
+            });
+        });
+    }
+    catch (error) {
+        console.log();
+        console.error(`  Error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        console.log();
+        process.exit(1);
+    }
+}
+/**
+ * Install hook dispatchers in settings.json
+ */
+export async function runHooksInstall() {
+    console.log();
+    console.log('  Installing hook dispatchers...');
+    let settings = {};
+    if (existsSync(SETTINGS_PATH)) {
+        const content = readFileSync(SETTINGS_PATH, 'utf-8');
+        settings = JSON.parse(content);
+    }
+    // Create hooks section with single dispatcher per event
+    settings.hooks = {
+        PreToolUse: [
+            {
+                matcher: '*',
+                hooks: [{ type: 'command', command: 'claudetools hook dispatch PreToolUse' }],
+            },
+        ],
+        PostToolUse: [
+            {
+                matcher: '*',
+                hooks: [{ type: 'command', command: 'claudetools hook dispatch PostToolUse' }],
+            },
+        ],
+    };
+    writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2), 'utf-8');
+    console.log('  Hook dispatchers installed in settings.json');
+    console.log();
+    console.log('  The sync engine will now execute hook chains for:');
+    console.log('    - PreToolUse: Before each tool execution');
+    console.log('    - PostToolUse: After each tool execution');
+    console.log();
+}
+/**
+ * Uninstall hook dispatchers from settings.json
+ */
+export async function runHooksUninstall() {
+    console.log();
+    console.log('  Removing hook dispatchers...');
+    if (!existsSync(SETTINGS_PATH)) {
+        console.log('  settings.json not found');
+        return;
+    }
+    const content = readFileSync(SETTINGS_PATH, 'utf-8');
+    const settings = JSON.parse(content);
+    delete settings.hooks;
+    writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2), 'utf-8');
+    console.log('  Hook dispatchers removed from settings.json');
+    console.log();
+}
+/**
+ * Dispatch hook execution (called by Claude Code)
+ */
+export async function runHookDispatch(event) {
+    if (!event) {
+        return;
+    }
+    // This would communicate with the sync engine to execute the hook chain
+    // For now, just execute hooks directly
+    const hooks = listInstalledHooks().filter((h) => h.event === event);
+    if (hooks.length === 0) {
+        return;
+    }
+    // Sort by priority
+    hooks.sort((a, b) => (a.priority || 100) - (b.priority || 100));
+    const tool = process.env.CLAUDE_TOOL_NAME || '';
+    for (const hook of hooks) {
+        if (!matchesPattern(hook.matcher || '*', tool)) {
+            continue;
+        }
+        try {
+            const sanitizedCommand = sanitizeHookCommand(hook.command);
+            const { spawnSync } = await import('child_process');
+            const result = spawnSync('sh', ['-c', sanitizedCommand], {
+                env: {
+                    ...process.env,
+                    CLAUDETOOLS_EVENT: event,
+                    CLAUDETOOLS_TOOL: tool,
+                },
+                timeout: (hook.timeout || 30) * 1000,
+            });
+            if (result.status !== 0 && hook.onFailure === 'block') {
+                process.stderr.write(result.stderr || '');
+                process.exit(2);
+            }
+        }
+        catch (error) {
+            // Hook command validation failed
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            if (hook.onFailure === 'block') {
+                process.stderr.write(`Hook '${hook.name}' failed: ${message}\n`);
+                process.exit(2);
+            }
+            // Warn or ignore based on onFailure setting
+        }
+    }
+}
+// Helper functions
+function listInstalledHooks() {
+    const hooks = [];
+    if (!existsSync(HOOKS_DIR)) {
+        return hooks;
+    }
+    const entries = readdirSync(HOOKS_DIR);
+    for (const entry of entries) {
+        if (entry.endsWith('.yaml') || entry.endsWith('.yml')) {
+            const config = loadHookConfig(entry.replace(/\.(yaml|yml)$/, ''));
+            if (config) {
+                hooks.push(config);
+            }
+        }
+    }
+    return hooks;
+}
+function loadHookConfig(name) {
+    const yamlPath = join(HOOKS_DIR, `${name}.yaml`);
+    const ymlPath = join(HOOKS_DIR, `${name}.yml`);
+    let configPath = null;
+    if (existsSync(yamlPath)) {
+        configPath = yamlPath;
+    }
+    else if (existsSync(ymlPath)) {
+        configPath = ymlPath;
+    }
+    if (!configPath) {
+        return null;
+    }
+    const content = readFileSync(configPath, 'utf-8');
+    return parseYaml(content);
+}
+async function copyHookScript(path) {
+    const resolvedPath = path.startsWith('~')
+        ? join(homedir(), path.slice(1))
+        : path;
+    if (!existsSync(resolvedPath)) {
+        throw new Error(`File not found: ${resolvedPath}`);
+    }
+    const name = basename(resolvedPath, '.sh');
+    const targetPath = join(HOOKS_DIR, `${name}.sh`);
+    copyFileSync(resolvedPath, targetPath);
+    chmodSync(targetPath, 0o755);
+    console.log();
+    console.log(`  Copied hook script: ${name}`);
+    console.log(`  Location: ${targetPath}`);
+    console.log();
+}
+function matchesPattern(pattern, value) {
+    if (pattern === '*') {
+        return true;
+    }
+    // Support pipe-separated patterns like "Write|Edit"
+    const patterns = pattern.split('|').map((p) => p.trim());
+    for (const p of patterns) {
+        if (p === value) {
+            return true;
+        }
+        // Basic glob support
+        const regex = new RegExp('^' + p.replace(/\*/g, '.*').replace(/\?/g, '.') + '$');
+        if (regex.test(value)) {
+            return true;
+        }
+    }
+    return false;
+}
+function getEventIcon(event) {
+    switch (event) {
+        case 'PreToolUse':
+            return '⏵';
+        case 'PostToolUse':
+            return '⏹';
+        default:
+            return '•';
+    }
+}
+/**
+ * Show hooks help
+ */
+export function showHookHelp() {
+    console.log(`
+claudetools hook - Manage hooks (automation scripts)
+
+Usage:
+  claudetools hook list           List installed hooks
+  claudetools hook add <name>     Add a hook
+  claudetools hook remove <name>  Remove a hook
+  claudetools hook test <name>    Test a hook
+  claudetools hooks install       Install dispatchers in settings.json
+  claudetools hooks uninstall     Remove dispatchers from settings.json
+
+Hook Events:
+  PreToolUse   - Runs before each tool execution
+  PostToolUse  - Runs after each tool execution
+
+Options (for add):
+  --event <event>       Event to trigger on (default: PreToolUse)
+  --matcher <pattern>   Tool pattern to match (default: *)
+  --command "<cmd>"     Command to execute
+  --priority <n>        Execution order (lower = first)
+  --async               Run asynchronously
+  --on-failure <action> block|warn|ignore (default: warn)
+
+Examples:
+  claudetools hook add pre-lint --event PreToolUse --matcher "Write|Edit" --command "eslint \${FILE}"
+  claudetools hook test pre-lint --tool Write
+  claudetools hook remove pre-lint
+  claudetools hooks install
+`);
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

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

package/dist/lib/api.d.ts

@@ -0,0 +1,29 @@
+export interface ApiClientOptions {
+    authenticated?: boolean;
+}
+export interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+}
+export declare class ApiError extends Error {
+    code: string;
+    details?: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, details?: Record<string, unknown> | undefined);
+}
+export declare function getApiClient(options?: ApiClientOptions): {
+    get<T>(endpoint: string): Promise<ApiResponse<T>>;
+    post<T>(endpoint: string, body: unknown): Promise<ApiResponse<T>>;
+    put<T>(endpoint: string, body: unknown): Promise<ApiResponse<T>>;
+    delete<T>(endpoint: string): Promise<ApiResponse<T>>;
+    getRaw(endpoint: string): Promise<{
+        status: number;
+        body: string;
+        headers: Headers;
+    }>;
+};
+//# sourceMappingURL=api.d.ts.map

package/dist/lib/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH;AAED,qBAAa,QAAS,SAAQ,KAAK;IAExB,IAAI,EAAE,MAAM;IAEZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAK3C;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,gBAA0C;QAElE,CAAC,YAAY,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;SAI5C,CAAC,YAAY,MAAM,QAAQ,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAI7D,CAAC,YAAY,MAAM,QAAQ,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;WAIzD,CAAC,YAAY,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;qBAInC,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;EAI9F"}

package/dist/lib/api.js

@@ -0,0 +1,213 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { getCredential, getRefreshToken, storeCredential } from '../auth/keychain.js';
+import { loadConfig, saveConfig } from '../auth/config.js';
+const API_BASE = process.env.CLAUDETOOLS_API_URL || 'https://claudetools.com/api';
+// Read CLI version from package.json for User-Agent header
+const __api_filename = fileURLToPath(import.meta.url);
+const __api_dirname = dirname(__api_filename);
+const cliVersion = (() => {
+    try {
+        const pkg = JSON.parse(readFileSync(join(__api_dirname, '..', '..', 'package.json'), 'utf-8'));
+        return pkg.version;
+    }
+    catch {
+        return '0.0.0';
+    }
+})();
+const USER_AGENT = `claudetools-cli/${cliVersion}`;
+export class ApiError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'ApiError';
+    }
+}
+export function getApiClient(options = { authenticated: true }) {
+    return {
+        async get(endpoint) {
+            return makeRequest('GET', endpoint, undefined, options.authenticated);
+        },
+        async post(endpoint, body) {
+            return makeRequest('POST', endpoint, body, options.authenticated);
+        },
+        async put(endpoint, body) {
+            return makeRequest('PUT', endpoint, body, options.authenticated);
+        },
+        async delete(endpoint) {
+            return makeRequest('DELETE', endpoint, undefined, options.authenticated);
+        },
+        async getRaw(endpoint) {
+            return makeRawRequest('GET', endpoint, undefined, options.authenticated);
+        },
+    };
+}
+/**
+ * Refresh access token using refresh token
+ */
+async function refreshAccessToken() {
+    const refreshToken = await getRefreshToken();
+    if (!refreshToken) {
+        return null;
+    }
+    try {
+        const response = await fetch(`${API_BASE}/auth/refresh`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'User-Agent': USER_AGENT,
+            },
+            body: JSON.stringify({ refresh_token: refreshToken }),
+        });
+        if (!response.ok) {
+            // Refresh token is invalid or expired
+            return null;
+        }
+        const json = (await response.json());
+        if (!json.data) {
+            return null;
+        }
+        const { access_token, expires_in } = json.data;
+        // Calculate new expiration
+        const expiresAt = Date.now() + (expires_in * 1000);
+        // Store new access token (keep same refresh token)
+        await storeCredential(access_token, refreshToken);
+        saveConfig({
+            tokenExpiresAt: expiresAt,
+        });
+        return access_token;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if token is expired or will expire soon (within 5 minutes)
+ */
+function isTokenExpired() {
+    const config = loadConfig();
+    if (!config.tokenExpiresAt) {
+        return false; // Let server validate — don't assume expired
+    }
+    const bufferMs = 5 * 60 * 1000; // 5 minutes
+    return Date.now() >= (config.tokenExpiresAt - bufferMs);
+}
+const MAX_RETRIES = 3;
+/**
+ * Wait for the specified duration in milliseconds
+ */
+function delay(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+const MAX_RETRY_AFTER_MS = 60_000;
+/**
+ * Parse Retry-After header value into milliseconds.
+ * Supports both delta-seconds (e.g. "5") and HTTP-date formats.
+ * Falls back to the provided default if unparseable.
+ * Capped at 60 seconds to prevent a malicious server from blocking the client.
+ */
+function parseRetryAfter(headerValue, fallbackMs) {
+    if (!headerValue) {
+        return Math.min(fallbackMs, MAX_RETRY_AFTER_MS);
+    }
+    const seconds = Number(headerValue);
+    if (!Number.isNaN(seconds) && seconds >= 0) {
+        return Math.min(seconds * 1000, MAX_RETRY_AFTER_MS);
+    }
+    // Try HTTP-date format
+    const dateMs = Date.parse(headerValue);
+    if (!Number.isNaN(dateMs)) {
+        const waitMs = dateMs - Date.now();
+        return Math.min(Math.max(waitMs, 0), MAX_RETRY_AFTER_MS);
+    }
+    return Math.min(fallbackMs, MAX_RETRY_AFTER_MS);
+}
+/**
+ * Shared logic: refresh token if needed, build headers, execute fetch with
+ * 429 retry. Returns the raw Response for callers to process.
+ */
+async function fetchWithRetry(method, endpoint, body, authenticated = true) {
+    // Check if token needs refresh before making request
+    if (authenticated && isTokenExpired()) {
+        await refreshAccessToken();
+        // If refresh fails, still try with existing token — server may accept it
+        // (session tokens with 7-day expiry may still be valid even if client thinks expired)
+    }
+    const requestHeaders = {
+        'Content-Type': 'application/json',
+        'User-Agent': USER_AGENT,
+    };
+    if (authenticated) {
+        const accessToken = await getCredential();
+        if (!accessToken) {
+            throw new ApiError('AUTH_REQUIRED', 'No stored credentials found. Run: claudetools login');
+        }
+        requestHeaders['Authorization'] = `Bearer ${accessToken}`;
+    }
+    const url = `${API_BASE}${endpoint}`;
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+        const response = await fetch(url, {
+            method,
+            headers: requestHeaders,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        // Handle 429 rate limiting with retry
+        if (response.status === 429 && attempt < MAX_RETRIES) {
+            const retryAfterMs = parseRetryAfter(response.headers.get('Retry-After'), (attempt + 1) * 1000);
+            await delay(retryAfterMs);
+            continue;
+        }
+        return response;
+    }
+    // Should not reach here, but handle gracefully
+    throw new ApiError('RATE_LIMITED', 'Request rate limited after maximum retries. Try again later.');
+}
+/**
+ * Throw an ApiError from a JSON error payload (string or structured object).
+ */
+function throwApiError(rawError, json, status, statusText) {
+    if (rawError) {
+        if (typeof rawError === 'string') {
+            throw new ApiError(rawError, rawError);
+        }
+        if (json.error && typeof json.error === 'object') {
+            throw new ApiError(json.error.code, json.error.message, json.error.details);
+        }
+    }
+    throw new ApiError('UNKNOWN_ERROR', `HTTP ${status}: ${statusText}`);
+}
+async function makeRawRequest(method, endpoint, body, authenticated = true) {
+    const response = await fetchWithRetry(method, endpoint, body, authenticated);
+    const responseBody = await response.text();
+    if (!response.ok) {
+        try {
+            const json = JSON.parse(responseBody);
+            throwApiError(json.error, json, response.status, response.statusText);
+        }
+        catch (parseError) {
+            if (parseError instanceof ApiError)
+                throw parseError;
+            // Not JSON, throw generic error
+        }
+        throw new ApiError('UNKNOWN_ERROR', `HTTP ${response.status}: ${response.statusText}`);
+    }
+    return {
+        status: response.status,
+        body: responseBody,
+        headers: response.headers,
+    };
+}
+async function makeRequest(method, endpoint, body, authenticated = true) {
+    const response = await fetchWithRetry(method, endpoint, body, authenticated);
+    const json = (await response.json());
+    if (!response.ok) {
+        const rawError = json.error;
+        throwApiError(rawError, json, response.status, response.statusText);
+    }
+    return json;
+}
+//# sourceMappingURL=api.js.map