@vforsh/argus 0.1.5 → 0.1.7

package/dist/commands/domDiff.js

@@ -0,0 +1,279 @@
+import { fetchJson } from '../httpClient.js';
+import { formatDomDiff, formatSnapshotList, formatSnapshotCreated } from '../output/domDiff.js';
+import { createOutput } from '../output/io.js';
+import { writeWatcherCandidates } from '../watchers/candidates.js';
+import { resolveWatcher } from '../watchers/resolveWatcher.js';
+const formatError = (error) => {
+    if (!error) {
+        return 'unknown error';
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+};
+const parseSelectors = (selector) => {
+    // Split by comma, trim, filter empty
+    return selector
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+};
+/**
+ * Run the dom diff --snapshot command to take a snapshot.
+ */
+export const runDomDiffSnapshot = async (id, options) => {
+    const output = createOutput(options);
+    if (!options.selector || options.selector.trim() === '') {
+        output.writeWarn('--selector is required');
+        process.exitCode = 2;
+        return;
+    }
+    if (!options.snapshot || options.snapshot.trim() === '') {
+        output.writeWarn('--snapshot name is required');
+        process.exitCode = 2;
+        return;
+    }
+    const resolved = await resolveWatcher({ id });
+    if (!resolved.ok) {
+        output.writeWarn(resolved.error);
+        if (resolved.candidates && resolved.candidates.length > 0) {
+            writeWatcherCandidates(resolved.candidates, output);
+            output.writeWarn('Hint: run `argus list` to see all watchers.');
+        }
+        process.exitCode = resolved.exitCode;
+        return;
+    }
+    const { watcher } = resolved;
+    const selectors = parseSelectors(options.selector);
+    const url = `http://${watcher.host}:${watcher.port}/dom/snapshot`;
+    let response;
+    try {
+        response = await fetchJson(url, {
+            method: 'POST',
+            body: {
+                selectors,
+                name: options.snapshot,
+                persist: options.persist ?? false,
+            },
+            timeoutMs: 30_000,
+            returnErrorResponse: true,
+        });
+    }
+    catch (error) {
+        output.writeWarn(`${watcher.id}: failed to reach watcher (${formatError(error)})`);
+        process.exitCode = 1;
+        return;
+    }
+    if (!response.ok) {
+        const errorResp = response;
+        if (options.json) {
+            output.writeJson(response);
+        }
+        else {
+            output.writeWarn(`Error: ${errorResp.error.message}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const successResp = response;
+    if (options.json) {
+        output.writeJson(successResp);
+        return;
+    }
+    const formatted = formatSnapshotCreated(successResp.snapshot.name, successResp.snapshot.elements.length, successResp.file);
+    output.writeHuman(formatted);
+};
+/**
+ * Run the dom diff --compare command to compare against a baseline snapshot.
+ */
+export const runDomDiffCompare = async (id, options) => {
+    const output = createOutput(options);
+    if (!options.selector || options.selector.trim() === '') {
+        output.writeWarn('--selector is required');
+        process.exitCode = 2;
+        return;
+    }
+    if (!options.compare || options.compare.trim() === '') {
+        output.writeWarn('--compare baseline name is required');
+        process.exitCode = 2;
+        return;
+    }
+    const resolved = await resolveWatcher({ id });
+    if (!resolved.ok) {
+        output.writeWarn(resolved.error);
+        if (resolved.candidates && resolved.candidates.length > 0) {
+            writeWatcherCandidates(resolved.candidates, output);
+            output.writeWarn('Hint: run `argus list` to see all watchers.');
+        }
+        process.exitCode = resolved.exitCode;
+        return;
+    }
+    const { watcher } = resolved;
+    const selectors = parseSelectors(options.selector);
+    const url = `http://${watcher.host}:${watcher.port}/dom/diff`;
+    let response;
+    try {
+        response = await fetchJson(url, {
+            method: 'POST',
+            body: {
+                baseline: options.compare,
+                selectors,
+            },
+            timeoutMs: 30_000,
+            returnErrorResponse: true,
+        });
+    }
+    catch (error) {
+        output.writeWarn(`${watcher.id}: failed to reach watcher (${formatError(error)})`);
+        process.exitCode = 1;
+        return;
+    }
+    if (!response.ok) {
+        const errorResp = response;
+        if (options.json) {
+            output.writeJson(response);
+        }
+        else {
+            output.writeWarn(`Error: ${errorResp.error.message}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const successResp = response;
+    if (options.json) {
+        output.writeJson(successResp);
+        return;
+    }
+    const formatted = formatDomDiff(successResp);
+    output.writeHuman(formatted);
+};
+/**
+ * Run the dom diff action command with before/after eval expressions.
+ */
+export const runDomDiffAction = async (id, options) => {
+    const output = createOutput(options);
+    if (!options.selector || options.selector.trim() === '') {
+        output.writeWarn('--selector is required');
+        process.exitCode = 2;
+        return;
+    }
+    if (!options.beforeEval && !options.afterEval) {
+        output.writeWarn('At least one of --before-eval or --after-eval is required');
+        process.exitCode = 2;
+        return;
+    }
+    const resolved = await resolveWatcher({ id });
+    if (!resolved.ok) {
+        output.writeWarn(resolved.error);
+        if (resolved.candidates && resolved.candidates.length > 0) {
+            writeWatcherCandidates(resolved.candidates, output);
+            output.writeWarn('Hint: run `argus list` to see all watchers.');
+        }
+        process.exitCode = resolved.exitCode;
+        return;
+    }
+    const { watcher } = resolved;
+    const selectors = parseSelectors(options.selector);
+    const afterDelay = parsePositiveInt(options.delay) ?? 500;
+    const beforeDelay = parsePositiveInt(options.beforeDelay) ?? 0;
+    const url = `http://${watcher.host}:${watcher.port}/dom/diff/action`;
+    let response;
+    try {
+        response = await fetchJson(url, {
+            method: 'POST',
+            body: {
+                selectors,
+                beforeEval: options.beforeEval,
+                afterEval: options.afterEval,
+                beforeDelay,
+                afterDelay,
+            },
+            timeoutMs: 60_000, // Longer timeout for action mode
+            returnErrorResponse: true,
+        });
+    }
+    catch (error) {
+        output.writeWarn(`${watcher.id}: failed to reach watcher (${formatError(error)})`);
+        process.exitCode = 1;
+        return;
+    }
+    if (!response.ok) {
+        const errorResp = response;
+        if (options.json) {
+            output.writeJson(response);
+        }
+        else {
+            output.writeWarn(`Error: ${errorResp.error.message}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const successResp = response;
+    if (options.json) {
+        output.writeJson(successResp);
+        return;
+    }
+    const formatted = formatDomDiff(successResp);
+    output.writeHuman(formatted);
+};
+/**
+ * Run the dom diff list command to list stored snapshots.
+ */
+export const runDomDiffList = async (id, options) => {
+    const output = createOutput(options);
+    const resolved = await resolveWatcher({ id });
+    if (!resolved.ok) {
+        output.writeWarn(resolved.error);
+        if (resolved.candidates && resolved.candidates.length > 0) {
+            writeWatcherCandidates(resolved.candidates, output);
+            output.writeWarn('Hint: run `argus list` to see all watchers.');
+        }
+        process.exitCode = resolved.exitCode;
+        return;
+    }
+    const { watcher } = resolved;
+    const url = `http://${watcher.host}:${watcher.port}/dom/snapshot/list`;
+    let response;
+    try {
+        response = await fetchJson(url, {
+            method: 'GET',
+            timeoutMs: 10_000,
+            returnErrorResponse: true,
+        });
+    }
+    catch (error) {
+        output.writeWarn(`${watcher.id}: failed to reach watcher (${formatError(error)})`);
+        process.exitCode = 1;
+        return;
+    }
+    if (!response.ok) {
+        const errorResp = response;
+        if (options.json) {
+            output.writeJson(response);
+        }
+        else {
+            output.writeWarn(`Error: ${errorResp.error.message}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const successResp = response;
+    if (options.json) {
+        output.writeJson(successResp);
+        return;
+    }
+    const formatted = formatSnapshotList(successResp.snapshots);
+    output.writeHuman(formatted);
+};
+const parsePositiveInt = (value) => {
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed < 0 || !Number.isInteger(parsed)) {
+        return undefined;
+    }
+    return parsed;
+};
+//# sourceMappingURL=domDiff.js.map

package/dist/commands/domDiff.js.map

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

package/dist/commands/extension/attach.d.ts

@@ -0,0 +1,8 @@
+export type ExtensionAttachOptions = {
+    tabId?: string;
+    url?: string;
+    title?: string;
+    json?: boolean;
+};
+export declare const runExtensionAttach: (id: string | undefined, options: ExtensionAttachOptions) => Promise<void>;
+//# sourceMappingURL=attach.d.ts.map

package/dist/commands/extension/attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../../src/commands/extension/attach.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,sBAAsB,GAAG;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAU,IAAI,MAAM,GAAG,SAAS,EAAE,SAAS,sBAAsB,KAAG,OAAO,CAAC,IAAI,CAsH9G,CAAA"}

package/dist/commands/extension/attach.js

@@ -0,0 +1,171 @@
+import { fetchJson } from '../../httpClient.js';
+import { createOutput } from '../../output/io.js';
+import { resolveWatcher } from '../../watchers/resolveWatcher.js';
+import { writeWatcherCandidates } from '../../watchers/candidates.js';
+export const runExtensionAttach = async (id, options) => {
+    const output = createOutput(options);
+    const resolved = await resolveWatcher({ id });
+    if (!resolved.ok) {
+        output.writeWarn(resolved.error);
+        if (resolved.candidates && resolved.candidates.length > 0) {
+            writeWatcherCandidates(resolved.candidates, output);
+        }
+        process.exitCode = resolved.exitCode;
+        return;
+    }
+    const { watcher } = resolved;
+    const baseUrl = `http://${watcher.host}:${watcher.port}`;
+    // If tabId is provided directly, use it
+    if (options.tabId) {
+        const tabIdNum = parseInt(options.tabId, 10);
+        if (isNaN(tabIdNum)) {
+            output.writeWarn(`Invalid tabId: ${options.tabId}`);
+            process.exitCode = 2;
+            return;
+        }
+        await attachToTab(baseUrl, tabIdNum, options.tabId, output, options.json);
+        return;
+    }
+    // Otherwise, we need to find a matching tab
+    if (!options.url && !options.title) {
+        output.writeWarn('Either --tab-id, --url, or --title is required.');
+        output.writeWarn('');
+        output.writeWarn('Examples:');
+        output.writeWarn('  argus ext attach app --tab-id 123456789');
+        output.writeWarn('  argus ext attach app --url localhost:3000');
+        output.writeWarn('  argus ext attach app --title "My App"');
+        process.exitCode = 2;
+        return;
+    }
+    // Fetch available targets
+    let targetsResponse;
+    try {
+        targetsResponse = await fetchJson(`${baseUrl}/targets`, { timeoutMs: 5_000, returnErrorResponse: true });
+    }
+    catch (error) {
+        output.writeWarn(`Failed to fetch targets: ${error instanceof Error ? error.message : error}`);
+        process.exitCode = 1;
+        return;
+    }
+    if (!targetsResponse.ok || !targetsResponse.targets) {
+        const message = targetsResponse.error?.message ?? 'Unknown error';
+        if (targetsResponse.error?.code === 'not_available' || targetsResponse.error?.code === 'not_found') {
+            output.writeWarn(`Watcher "${watcher.id}" is not in extension mode.`);
+            output.writeWarn('Start the watcher with --source extension to use this command.');
+        }
+        else {
+            output.writeWarn(`Failed to list targets: ${message}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const { targets } = targetsResponse;
+    // Filter to non-attached targets
+    const available = targets.filter((t) => !t.attached);
+    if (available.length === 0) {
+        output.writeWarn('No available tabs to attach.');
+        const attached = targets.filter((t) => t.attached);
+        if (attached.length > 0) {
+            output.writeWarn(`Already attached to ${attached.length} tab(s).`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    // Find matching tabs
+    const matches = available.filter((target) => {
+        if (options.url && !target.url.toLowerCase().includes(options.url.toLowerCase())) {
+            return false;
+        }
+        if (options.title && !target.title.toLowerCase().includes(options.title.toLowerCase())) {
+            return false;
+        }
+        return true;
+    });
+    if (matches.length === 0) {
+        output.writeWarn('No tabs match the specified criteria.');
+        output.writeWarn('');
+        output.writeWarn('Available tabs:');
+        for (const target of available.slice(0, 5)) {
+            output.writeWarn(`  [${target.id}] ${truncate(target.title, 40)} - ${truncate(target.url, 50)}`);
+        }
+        if (available.length > 5) {
+            output.writeWarn(`  ... and ${available.length - 5} more`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (matches.length > 1) {
+        output.writeWarn(`Multiple tabs match (${matches.length}). Be more specific or use --tab-id.`);
+        output.writeWarn('');
+        output.writeWarn('Matching tabs:');
+        for (const target of matches.slice(0, 5)) {
+            output.writeWarn(`  [${target.id}] ${truncate(target.title, 40)} - ${truncate(target.url, 50)}`);
+        }
+        if (matches.length > 5) {
+            output.writeWarn(`  ... and ${matches.length - 5} more`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    // Attach to the single match
+    const target = matches[0];
+    const tabIdNum = parseInt(target.id, 10);
+    await attachToTab(baseUrl, tabIdNum, target.id, output, options.json, target);
+};
+const attachToTab = async (baseUrl, tabId, tabIdStr, output, json, target) => {
+    let response;
+    try {
+        response = await fetchJson(`${baseUrl}/attach`, {
+            method: 'POST',
+            body: { tabId },
+            timeoutMs: 5_000,
+            returnErrorResponse: true,
+        });
+    }
+    catch (error) {
+        if (json) {
+            output.writeJson({ success: false, error: error instanceof Error ? error.message : String(error) });
+        }
+        else {
+            output.writeWarn(`Failed to attach: ${error instanceof Error ? error.message : error}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (!response.ok) {
+        const message = response.error?.message ?? 'Unknown error';
+        if (json) {
+            output.writeJson({ success: false, error: message });
+        }
+        else {
+            output.writeWarn(`Failed to attach: ${message}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (json) {
+        output.writeJson({
+            success: true,
+            tabId: tabIdStr,
+            title: target?.title ?? null,
+            url: target?.url ?? null,
+        });
+    }
+    else {
+        output.writeHuman('');
+        output.writeHuman(`Attach request sent for tab ${tabIdStr}`);
+        if (target) {
+            output.writeHuman(`  Title: ${target.title}`);
+            output.writeHuman(`  URL:   ${target.url}`);
+        }
+        output.writeHuman('');
+        output.writeHuman('The extension will attach shortly. Chrome will show a debugging indicator.');
+        output.writeHuman('');
+    }
+};
+const truncate = (str, maxLen) => {
+    if (str.length <= maxLen)
+        return str;
+    return str.slice(0, maxLen - 3) + '...';
+};
+//# sourceMappingURL=attach.js.map

package/dist/commands/extension/attach.js.map

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

package/dist/commands/extension/detach.d.ts

@@ -0,0 +1,6 @@
+export type ExtensionDetachOptions = {
+    tabId?: string;
+    json?: boolean;
+};
+export declare const runExtensionDetach: (id: string | undefined, options: ExtensionDetachOptions) => Promise<void>;
+//# sourceMappingURL=detach.d.ts.map

package/dist/commands/extension/detach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detach.d.ts","sourceRoot":"","sources":["../../../src/commands/extension/detach.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,sBAAsB,GAAG;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAU,IAAI,MAAM,GAAG,SAAS,EAAE,SAAS,sBAAsB,KAAG,OAAO,CAAC,IAAI,CA6E9G,CAAA"}

package/dist/commands/extension/detach.js

@@ -0,0 +1,132 @@
+import { fetchJson } from '../../httpClient.js';
+import { createOutput } from '../../output/io.js';
+import { resolveWatcher } from '../../watchers/resolveWatcher.js';
+import { writeWatcherCandidates } from '../../watchers/candidates.js';
+export const runExtensionDetach = async (id, options) => {
+    const output = createOutput(options);
+    const resolved = await resolveWatcher({ id });
+    if (!resolved.ok) {
+        output.writeWarn(resolved.error);
+        if (resolved.candidates && resolved.candidates.length > 0) {
+            writeWatcherCandidates(resolved.candidates, output);
+        }
+        process.exitCode = resolved.exitCode;
+        return;
+    }
+    const { watcher } = resolved;
+    const baseUrl = `http://${watcher.host}:${watcher.port}`;
+    // If tabId is provided directly, use it
+    if (options.tabId) {
+        const tabIdNum = parseInt(options.tabId, 10);
+        if (isNaN(tabIdNum)) {
+            output.writeWarn(`Invalid tabId: ${options.tabId}`);
+            process.exitCode = 2;
+            return;
+        }
+        await detachFromTab(baseUrl, tabIdNum, options.tabId, output, options.json);
+        return;
+    }
+    // Otherwise, find attached tabs and detach from the first one (or all)
+    let targetsResponse;
+    try {
+        targetsResponse = await fetchJson(`${baseUrl}/targets`, { timeoutMs: 5_000, returnErrorResponse: true });
+    }
+    catch (error) {
+        output.writeWarn(`Failed to fetch targets: ${error instanceof Error ? error.message : error}`);
+        process.exitCode = 1;
+        return;
+    }
+    if (!targetsResponse.ok || !targetsResponse.targets) {
+        const message = targetsResponse.error?.message ?? 'Unknown error';
+        if (targetsResponse.error?.code === 'not_available' || targetsResponse.error?.code === 'not_found') {
+            output.writeWarn(`Watcher "${watcher.id}" is not in extension mode.`);
+            output.writeWarn('Start the watcher with --source extension to use this command.');
+        }
+        else {
+            output.writeWarn(`Failed to list targets: ${message}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const { targets } = targetsResponse;
+    const attached = targets.filter((t) => t.attached);
+    if (attached.length === 0) {
+        if (options.json) {
+            output.writeJson({ success: false, error: 'No tabs currently attached' });
+        }
+        else {
+            output.writeWarn('No tabs currently attached.');
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (attached.length > 1) {
+        output.writeWarn(`Multiple tabs attached (${attached.length}). Use --tab-id to specify which one.`);
+        output.writeWarn('');
+        output.writeWarn('Attached tabs:');
+        for (const target of attached) {
+            output.writeWarn(`  [${target.id}] ${truncate(target.title, 40)} - ${truncate(target.url, 50)}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    // Detach from the single attached tab
+    const target = attached[0];
+    const tabIdNum = parseInt(target.id, 10);
+    await detachFromTab(baseUrl, tabIdNum, target.id, output, options.json, target);
+};
+const detachFromTab = async (baseUrl, tabId, tabIdStr, output, json, target) => {
+    let response;
+    try {
+        response = await fetchJson(`${baseUrl}/detach`, {
+            method: 'POST',
+            body: { tabId },
+            timeoutMs: 5_000,
+            returnErrorResponse: true,
+        });
+    }
+    catch (error) {
+        if (json) {
+            output.writeJson({ success: false, error: error instanceof Error ? error.message : String(error) });
+        }
+        else {
+            output.writeWarn(`Failed to detach: ${error instanceof Error ? error.message : error}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (!response.ok) {
+        const message = response.error?.message ?? 'Unknown error';
+        if (json) {
+            output.writeJson({ success: false, error: message });
+        }
+        else {
+            output.writeWarn(`Failed to detach: ${message}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (json) {
+        output.writeJson({
+            success: true,
+            tabId: tabIdStr,
+            title: target?.title ?? null,
+            url: target?.url ?? null,
+        });
+    }
+    else {
+        output.writeHuman('');
+        output.writeHuman(`Detach request sent for tab ${tabIdStr}`);
+        if (target) {
+            output.writeHuman(`  Title: ${target.title}`);
+            output.writeHuman(`  URL:   ${target.url}`);
+        }
+        output.writeHuman('');
+    }
+};
+const truncate = (str, maxLen) => {
+    if (str.length <= maxLen)
+        return str;
+    return str.slice(0, maxLen - 3) + '...';
+};
+//# sourceMappingURL=detach.js.map

package/dist/commands/extension/detach.js.map

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

package/dist/commands/extension/targets.d.ts

@@ -0,0 +1,13 @@
+export type ExtensionTarget = {
+    id: string;
+    title: string;
+    url: string;
+    type?: string;
+    faviconUrl?: string;
+    attached?: boolean;
+};
+export type ExtensionTargetsOptions = {
+    json?: boolean;
+};
+export declare const runExtensionTargets: (id: string | undefined, options: ExtensionTargetsOptions) => Promise<void>;
+//# sourceMappingURL=targets.d.ts.map

package/dist/commands/extension/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../../src/commands/extension/targets.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,eAAe,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAQD,MAAM,MAAM,uBAAuB,GAAG;IACrC,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAU,IAAI,MAAM,GAAG,SAAS,EAAE,SAAS,uBAAuB,KAAG,OAAO,CAAC,IAAI,CA0EhH,CAAA"}