@fixback/node 0.2.0

package/dist/process.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Process-level capture (spec §D9, stories 4 & 5) — the *polite* `uncaughtException`
+ * and `unhandledRejection` handlers that **never change the app's exit behaviour**.
+ *
+ * The subtlety: merely *adding* an `uncaughtException` listener suppresses Node's
+ * default crash. So to stay polite:
+ *
+ * - **uncaughtException:** capture (`handled: false`), then — only when we are the
+ *   *sole* listener (the app installed none of its own) — best-effort flush and hand
+ *   off to `onFatalError`, which preserves Node's default (log + non-zero exit). When
+ *   the app has its own handler, we do nothing further: the app owns the exit.
+ * - **unhandledRejection:** capture (`handled: false`) and stop. We never escalate a
+ *   rejection to a process exit — exactly the "never turn a logged rejection into an
+ *   exit" guarantee (story 5).
+ *
+ * Everything is wrapped so a capture failure can never break the handler.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installProcessHandlers = installProcessHandlers;
+const DEFAULT_FLUSH_TIMEOUT_MS = 2_000;
+/** The real `process`, when running on Node. */
+function resolveProcess() {
+    const g = globalThis;
+    const proc = g.process;
+    return proc && typeof proc.on === "function" ? proc : undefined;
+}
+/** Node's default fatal behaviour: print the error and exit non-zero. */
+function defaultOnFatalError(proc) {
+    return (error) => {
+        try {
+            console.error(error);
+        }
+        catch {
+            /* a hostile console must not stop the exit */
+        }
+        const exit = proc.exit;
+        if (typeof exit === "function") {
+            try {
+                exit(1);
+            }
+            catch {
+                /* exit is terminal; nothing to do if it throws */
+            }
+        }
+    };
+}
+/** Race a flush against a timeout so a wedged transport can't hang a crashing process. */
+function flushWithTimeout(flush, ms) {
+    let result;
+    try {
+        result = Promise.resolve(flush());
+    }
+    catch {
+        return Promise.resolve();
+    }
+    if (ms <= 0)
+        return result.catch(() => { });
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(resolve, ms);
+    });
+    return Promise.race([result.catch(() => { }), timeout]).finally(() => {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    });
+}
+/**
+ * Install the polite process handlers for `sink`, returning an uninstall function.
+ * A no-op (and a no-op uninstall) when no `process` is available or when both gates
+ * are off.
+ */
+function installProcessHandlers(sink, options, deps = {}) {
+    const proc = deps.process ?? resolveProcess();
+    if (!proc)
+        return () => { };
+    const onFatalError = deps.onFatalError ?? defaultOnFatalError(proc);
+    const flushTimeoutMs = options.flushTimeoutMs ?? DEFAULT_FLUSH_TIMEOUT_MS;
+    const onUncaughtException = (...args) => {
+        const error = args[0];
+        try {
+            sink.captureException(error, { handled: false });
+        }
+        catch {
+            /* capture must never break the handler */
+        }
+        // If the app installed its own uncaughtException handler, it owns the exit — we
+        // must not force one (that would *change* its behaviour). Only when we are the
+        // sole listener do we preserve Node's default crash.
+        const others = proc.listeners("uncaughtException").filter((l) => l !== onUncaughtException);
+        if (others.length > 0)
+            return;
+        void flushWithTimeout(() => sink.flush(), flushTimeoutMs).finally(() => {
+            try {
+                onFatalError(error);
+            }
+            catch {
+                /* the fatal handler is terminal */
+            }
+        });
+    };
+    const onUnhandledRejection = (...args) => {
+        // Capture only — never escalate a rejection to a process exit (story 5).
+        try {
+            sink.captureException(args[0], { handled: false });
+        }
+        catch {
+            /* capture must never break the handler */
+        }
+    };
+    if (options.captureUncaughtException)
+        proc.on("uncaughtException", onUncaughtException);
+    if (options.captureUnhandledRejection)
+        proc.on("unhandledRejection", onUnhandledRejection);
+    return () => {
+        if (options.captureUncaughtException) {
+            proc.removeListener("uncaughtException", onUncaughtException);
+        }
+        if (options.captureUnhandledRejection) {
+            proc.removeListener("unhandledRejection", onUnhandledRejection);
+        }
+    };
+}
+//# sourceMappingURL=process.js.map

package/dist/process.js.map

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

package/dist/stack.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Turning a thrown value into the pieces a capture needs: the distilled
+ * `type | value | stack` a fingerprint is built from ({@link extractError}), and the
+ * **structured stack frames** for the wire ({@link extractStructuredFrames}).
+ *
+ * The distillation mirrors the browser SDK's exactly (`packages/sdk/src/error-capture.ts`)
+ * — `type = error.name`, `value = error.message`, `stack = error.stack` — so the same
+ * logical error yields the same shared-core fingerprint on either surface (the
+ * ADR-0028 parity guarantee). Frame parsing keeps the full script path (server-side
+ * symbolication matches it against uploaded sourcemaps) but scrubs each URL through
+ * the shared-core scrubber before it can leave the process.
+ */
+import { type CapturedFrame } from "@fixback/sdk-core";
+/** The distilled shape a fingerprint and a report are built from. */
+export interface ExtractedError {
+    readonly type: string;
+    readonly value: string;
+    readonly stack?: string;
+}
+/**
+ * Distil any thrown value into `{ type, value, stack }`. An `Error` (or error-shaped
+ * object) contributes its `name` / `message` / `stack`; a thrown string becomes the
+ * value; any other value is stringified. Never throws.
+ */
+export declare function extractError(input: unknown): ExtractedError;
+/**
+ * Extract structured frames from a stack for the wire (#117, ADR-0024), top of stack
+ * first. Keeps the full (scrubbed) script path so server-side symbolication can match
+ * it against uploaded sourcemaps; skips unlocatable frames (`native`, `<anonymous>`,
+ * eval); caps the count. V8 is Node's format; the Firefox/Safari form is handled too
+ * so the parser matches the browser SDK's exactly.
+ */
+export declare function extractStructuredFrames(stack: string | undefined, limit?: number): CapturedFrame[];

package/dist/stack.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Turning a thrown value into the pieces a capture needs: the distilled
+ * `type | value | stack` a fingerprint is built from ({@link extractError}), and the
+ * **structured stack frames** for the wire ({@link extractStructuredFrames}).
+ *
+ * The distillation mirrors the browser SDK's exactly (`packages/sdk/src/error-capture.ts`)
+ * — `type = error.name`, `value = error.message`, `stack = error.stack` — so the same
+ * logical error yields the same shared-core fingerprint on either surface (the
+ * ADR-0028 parity guarantee). Frame parsing keeps the full script path (server-side
+ * symbolication matches it against uploaded sourcemaps) but scrubs each URL through
+ * the shared-core scrubber before it can leave the process.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractError = extractError;
+exports.extractStructuredFrames = extractStructuredFrames;
+const sdk_core_1 = require("@fixback/sdk-core");
+/** The most structured frames shipped per error (mirrors the server's cap). */
+const STRUCTURED_FRAME_LIMIT = 30;
+/** Coerce any value to a string without throwing (a hostile `toString` can throw). */
+function asString(value) {
+    if (typeof value === "string")
+        return value;
+    if (value == null)
+        return "";
+    try {
+        return String(value);
+    }
+    catch {
+        return "";
+    }
+}
+/** Best-effort JSON for a non-Error thrown object, falling back to `String`. */
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value) ?? asString(value);
+    }
+    catch {
+        return asString(value);
+    }
+}
+/** True for a duck-typed error (a cross-realm Error, or an error-shaped throwable). */
+function isErrorLike(value) {
+    const err = value;
+    return (typeof err.message === "string" ||
+        typeof err.stack === "string" ||
+        typeof err.name === "string");
+}
+/**
+ * Distil any thrown value into `{ type, value, stack }`. An `Error` (or error-shaped
+ * object) contributes its `name` / `message` / `stack`; a thrown string becomes the
+ * value; any other value is stringified. Never throws.
+ */
+function extractError(input) {
+    if (input instanceof Error) {
+        return {
+            type: asString(input.name) || "Error",
+            value: asString(input.message),
+            stack: typeof input.stack === "string" ? input.stack : undefined,
+        };
+    }
+    if (typeof input === "string") {
+        return { type: "Error", value: input, stack: undefined };
+    }
+    if (input && typeof input === "object") {
+        if (isErrorLike(input)) {
+            const err = input;
+            return {
+                type: asString(err.name) || "Error",
+                value: asString(err.message),
+                stack: typeof err.stack === "string" ? err.stack : undefined,
+            };
+        }
+        return { type: "Error", value: safeStringify(input), stack: undefined };
+    }
+    return { type: "Error", value: asString(input), stack: undefined };
+}
+/** Split a `file:line:col` location into parts; `null` when it has no line. */
+function parseLocation(location) {
+    // The file may itself contain colons (https://…, node:internal/…), so split from
+    // the right: the trailing `:line(:col)?` are the numeric groups.
+    const match = location.match(/^(.*?):(\d+)(?::(\d+))?$/);
+    if (!match)
+        return null;
+    const file = match[1] ?? "";
+    if (file.length === 0 || file === "native" || file.includes("<anonymous>")) {
+        return null;
+    }
+    const line = Number(match[2]);
+    if (!Number.isFinite(line))
+        return null;
+    const column = match[3] !== undefined ? Number(match[3]) : null;
+    return { file, line, column };
+}
+/**
+ * Extract structured frames from a stack for the wire (#117, ADR-0024), top of stack
+ * first. Keeps the full (scrubbed) script path so server-side symbolication can match
+ * it against uploaded sourcemaps; skips unlocatable frames (`native`, `<anonymous>`,
+ * eval); caps the count. V8 is Node's format; the Firefox/Safari form is handled too
+ * so the parser matches the browser SDK's exactly.
+ */
+function extractStructuredFrames(stack, limit = STRUCTURED_FRAME_LIMIT) {
+    if (typeof stack !== "string" || stack.length === 0)
+        return [];
+    const frames = [];
+    for (const raw of stack.split("\n")) {
+        if (frames.length >= limit)
+            break;
+        const line = raw.trim();
+        let fn = null;
+        let location = null;
+        // V8: "at fn (loc)" | "at loc"
+        const v8Named = line.match(/^at\s+(.+?)\s+\((.+)\)$/);
+        const v8Bare = v8Named ? null : line.match(/^at\s+(.+)$/);
+        const geckoAt = v8Named || v8Bare ? -1 : line.indexOf("@");
+        if (v8Named) {
+            fn = v8Named[1] ?? null;
+            location = v8Named[2] ?? null;
+        }
+        else if (v8Bare) {
+            location = v8Bare[1] ?? null;
+        }
+        else if (geckoAt >= 0) {
+            // Firefox / Safari: "fn@loc" | "@loc"
+            fn = geckoAt > 0 ? line.slice(0, geckoAt) : null;
+            location = line.slice(geckoAt + 1);
+        }
+        if (!location)
+            continue;
+        const parsed = parseLocation(location);
+        if (!parsed)
+            continue;
+        frames.push({
+            file: (0, sdk_core_1.scrubUrl)(parsed.file),
+            line: parsed.line,
+            column: parsed.column,
+            function: fn && fn.length > 0 ? fn : null,
+        });
+    }
+    return frames;
+}
+//# sourceMappingURL=stack.js.map

package/dist/stack.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,90 @@
+/**
+ * The **batched secret-key transport** (ADR-0026): the SDK buffers captured errors
+ * and flushes them to `POST /api/errors` as a JSON batch authenticated with the
+ * Project secret key as an `Authorization: Bearer` token.
+ *
+ * - **Batched:** a server emits many errors, so they buffer and flush together
+ *   (on the batch cap, on an interval, on demand, and on `close`).
+ * - **Coalesced:** repeats of one fingerprint in a flush window fold into a single
+ *   item with a summed occurrence count — the client half of the crash-loop defence
+ *   (the server folds across flushes, ADR-0027).
+ * - **Backed off:** a `429` opens the shared-core {@link AutoReportBackoff} window
+ *   (honouring `Retry-After`); while it is open captures are shed without a request.
+ * - **Fail-quiet (story 34):** an unreachable, timing-out, or refusing endpoint never
+ *   throws to the host and never grows the buffer without bound (`maxQueueSize`).
+ */
+import { AutoReportBackoff } from "@fixback/sdk-core";
+import type { ServerErrorPayload } from "./wire";
+/** The response slice the transport reads. Satisfied by the global `fetch` Response. */
+export interface FetchResponseLike {
+    readonly ok: boolean;
+    readonly status: number;
+    readonly headers?: {
+        get(name: string): string | null;
+    } | null;
+}
+/** The request init the transport sends — a subset of the standard `RequestInit`. */
+export interface FetchRequestInit {
+    readonly method: string;
+    readonly headers?: Record<string, string>;
+    readonly body?: string;
+}
+/** A `fetch`-shaped function, injectable for tests. */
+export type FetchLike = (url: string, init: FetchRequestInit) => Promise<FetchResponseLike>;
+/**
+ * The narrow transport surface the client depends on — buffer one error, flush, and
+ * close. {@link Transport} is the real implementation; tests inject a fake recorder.
+ */
+export interface CaptureTransport {
+    enqueue(payload: ServerErrorPayload): void;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+/** The transport's configuration (a slice of the resolved SDK config). */
+export interface TransportConfig {
+    readonly endpoint: string;
+    readonly secretKey: string;
+    readonly maxBatchSize: number;
+    readonly maxQueueSize: number;
+    readonly flushIntervalMs: number;
+    readonly timeoutMs: number;
+}
+/** Injectable collaborators, defaulted to the real implementations. */
+export interface TransportDeps {
+    readonly fetchImpl?: FetchLike;
+    readonly backoff?: AutoReportBackoff;
+}
+export declare class Transport implements CaptureTransport {
+    private readonly config;
+    private readonly fetchImpl;
+    private readonly backoff;
+    /** Insertion-ordered buffer keyed by fingerprint, so a coalesce is O(1). */
+    private readonly buffer;
+    private timer;
+    private inFlight;
+    private closed;
+    constructor(config: TransportConfig, deps?: TransportDeps);
+    /**
+     * Buffer one captured error for the next flush. Coalesces onto an existing
+     * fingerprint (summing occurrences, keeping the first occurrence's evidence);
+     * drops the capture while the backoff window is open or the buffer is full; and
+     * triggers an immediate flush once the batch cap is reached.
+     */
+    enqueue(payload: ServerErrorPayload): void;
+    /** Flush the buffer to ingest. Never rejects (fail-quiet). Coalesces concurrent calls. */
+    flush(): Promise<void>;
+    /** Stop the flush timer and drain what remains. Safe to call more than once. */
+    close(): Promise<void>;
+    /** Send batches until the buffer drains, the window opens, or a send fails. */
+    private drain;
+    /** Remove and return up to `maxBatchSize` buffered errors, oldest first. */
+    private takeBatch;
+    /**
+     * POST one batch. Returns `true` on acceptance; on a `429` it opens the backoff
+     * window from `Retry-After` and returns `false`; any other failure (unreachable,
+     * timeout, refusal) returns `false` without throwing.
+     */
+    private send;
+    /** Race a request against the configured timeout (`0` disables it). */
+    private withTimeout;
+}

package/dist/transport.js

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * The **batched secret-key transport** (ADR-0026): the SDK buffers captured errors
+ * and flushes them to `POST /api/errors` as a JSON batch authenticated with the
+ * Project secret key as an `Authorization: Bearer` token.
+ *
+ * - **Batched:** a server emits many errors, so they buffer and flush together
+ *   (on the batch cap, on an interval, on demand, and on `close`).
+ * - **Coalesced:** repeats of one fingerprint in a flush window fold into a single
+ *   item with a summed occurrence count — the client half of the crash-loop defence
+ *   (the server folds across flushes, ADR-0027).
+ * - **Backed off:** a `429` opens the shared-core {@link AutoReportBackoff} window
+ *   (honouring `Retry-After`); while it is open captures are shed without a request.
+ * - **Fail-quiet (story 34):** an unreachable, timing-out, or refusing endpoint never
+ *   throws to the host and never grows the buffer without bound (`maxQueueSize`).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Transport = void 0;
+const sdk_core_1 = require("@fixback/sdk-core");
+/** The global `fetch`, adapted to {@link FetchLike}, or `undefined` when unavailable. */
+function resolveFetch() {
+    const g = globalThis;
+    if (typeof g.fetch !== "function")
+        return undefined;
+    const bound = g.fetch.bind(globalThis);
+    return (url, init) => bound(url, init);
+}
+/** Read a response header defensively — `null` when unavailable or on any throw. */
+function safeHeader(response, name) {
+    try {
+        return response.headers?.get?.(name) ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+class Transport {
+    config;
+    fetchImpl;
+    backoff;
+    /** Insertion-ordered buffer keyed by fingerprint, so a coalesce is O(1). */
+    buffer = new Map();
+    timer;
+    inFlight = null;
+    closed = false;
+    constructor(config, deps = {}) {
+        this.config = config;
+        this.fetchImpl = deps.fetchImpl ?? resolveFetch();
+        this.backoff = deps.backoff ?? new sdk_core_1.AutoReportBackoff();
+        if (config.flushIntervalMs > 0) {
+            this.timer = setInterval(() => {
+                void this.flush();
+            }, config.flushIntervalMs);
+            // Never keep the process alive for the flush timer.
+            const handle = this.timer;
+            if (typeof handle.unref === "function")
+                handle.unref();
+        }
+    }
+    /**
+     * Buffer one captured error for the next flush. Coalesces onto an existing
+     * fingerprint (summing occurrences, keeping the first occurrence's evidence);
+     * drops the capture while the backoff window is open or the buffer is full; and
+     * triggers an immediate flush once the batch cap is reached.
+     */
+    enqueue(payload) {
+        const signature = payload.errorSignature;
+        if (this.closed || typeof signature !== "string" || signature.length === 0)
+            return;
+        // Shed while the 429 window is open — the client half of the flood defence.
+        if (this.backoff.isPaused())
+            return;
+        const existing = this.buffer.get(signature);
+        if (existing) {
+            existing.occurrences = (existing.occurrences ?? 1) + (payload.occurrences ?? 1);
+        }
+        else {
+            if (this.buffer.size >= this.config.maxQueueSize)
+                return; // bounded — drop the newest
+            this.buffer.set(signature, { ...payload });
+        }
+        if (this.buffer.size >= this.config.maxBatchSize)
+            void this.flush();
+    }
+    /** Flush the buffer to ingest. Never rejects (fail-quiet). Coalesces concurrent calls. */
+    flush() {
+        if (this.inFlight)
+            return this.inFlight;
+        this.inFlight = this.drain().finally(() => {
+            this.inFlight = null;
+        });
+        return this.inFlight;
+    }
+    /** Stop the flush timer and drain what remains. Safe to call more than once. */
+    async close() {
+        this.closed = true;
+        if (this.timer !== undefined) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        await this.flush();
+    }
+    /** Send batches until the buffer drains, the window opens, or a send fails. */
+    async drain() {
+        while (this.buffer.size > 0) {
+            if (this.backoff.isPaused())
+                return;
+            const ok = await this.send(this.takeBatch());
+            if (!ok)
+                return; // 429 (held) or unreachable/refused — stop; the rest waits or is dropped
+        }
+    }
+    /** Remove and return up to `maxBatchSize` buffered errors, oldest first. */
+    takeBatch() {
+        const batch = [];
+        for (const [signature, entry] of this.buffer) {
+            batch.push(entry);
+            this.buffer.delete(signature);
+            if (batch.length >= this.config.maxBatchSize)
+                break;
+        }
+        return batch;
+    }
+    /**
+     * POST one batch. Returns `true` on acceptance; on a `429` it opens the backoff
+     * window from `Retry-After` and returns `false`; any other failure (unreachable,
+     * timeout, refusal) returns `false` without throwing.
+     */
+    async send(batch) {
+        const doFetch = this.fetchImpl;
+        if (!doFetch || batch.length === 0)
+            return false;
+        let response;
+        try {
+            response = await this.withTimeout(doFetch(this.config.endpoint, {
+                method: "POST",
+                headers: {
+                    authorization: `Bearer ${this.config.secretKey}`,
+                    "content-type": "application/json",
+                },
+                body: JSON.stringify({ errors: batch }),
+            }));
+        }
+        catch {
+            return false; // unreachable or timed out — fail quiet
+        }
+        if (!response.ok) {
+            if (response.status === 429) {
+                this.backoff.hold(safeHeader(response, "retry-after"));
+                return false;
+            }
+            return false; // refused — fail quiet
+        }
+        return true;
+    }
+    /** Race a request against the configured timeout (`0` disables it). */
+    withTimeout(request) {
+        const ms = this.config.timeoutMs;
+        if (ms <= 0)
+            return request;
+        let timer;
+        const timeout = new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error("fixback: request timed out")), ms);
+        });
+        return Promise.race([request, timeout]).finally(() => {
+            if (timer !== undefined)
+                clearTimeout(timer);
+        });
+    }
+}
+exports.Transport = Transport;
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The backend SDK's own version string, reported to ingest as
+ * `environment.sdkVersion`. Kept as an inlined constant rather than a runtime
+ * `package.json` import so the published build stays self-contained (the same
+ * posture as `packages/sdk/src/version.ts` and `packages/expo/src/version.ts`).
+ *
+ * It must equal `package.json`'s `version`. Two things keep it there: the
+ * Changesets `version` step syncs it automatically (`scripts/sync-sdk-version.mjs`,
+ * wired into `version-packages`), and `version.test.ts` fails the build if the two
+ * ever drift. Do not hand-edit this line to a value other than `package.json`'s
+ * version.
+ */
+export declare const NODE_SDK_VERSION = "0.2.0";

package/dist/version.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NODE_SDK_VERSION = void 0;
+/**
+ * The backend SDK's own version string, reported to ingest as
+ * `environment.sdkVersion`. Kept as an inlined constant rather than a runtime
+ * `package.json` import so the published build stays self-contained (the same
+ * posture as `packages/sdk/src/version.ts` and `packages/expo/src/version.ts`).
+ *
+ * It must equal `package.json`'s `version`. Two things keep it there: the
+ * Changesets `version` step syncs it automatically (`scripts/sync-sdk-version.mjs`,
+ * wired into `version-packages`), and `version.test.ts` fails the build if the two
+ * ever drift. Do not hand-edit this line to a value other than `package.json`'s
+ * version.
+ */
+exports.NODE_SDK_VERSION = "0.2.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;GAWG;AACU,QAAA,gBAAgB,GAAG,OAAO,CAAC"}