vident-sdk 0.11.0

package/README.md

@@ -0,0 +1,216 @@
+# @spanwise/sdk
+
+TypeScript SDK for Spanwise observability - monitoring, tracing, and error tracking.
+
+## Installation
+
+```bash
+npm install @spanwise/sdk
+```
+
+## Quick Start
+
+```typescript
+import { Spanwise } from "@spanwise/sdk"
+
+const client = new Spanwise({ apiKey: "sw_..." })
+
+// Wrap your cron job - automatically tracks start/success/fail
+await client.wrap("check-id", async () => {
+  await myDatabaseBackup()
+})
+```
+
+## Usage
+
+### Wrapping Jobs (Recommended)
+
+The `wrap()` method automatically sends start/success/fail signals:
+
+```typescript
+await client.wrap("check-id", async () => {
+  // Your job logic here
+  await syncUsers()
+  await sendReports()
+})
+// Sends "start" → runs function → sends "success" (or "fail" if error thrown)
+```
+
+### Manual Pinging
+
+For more control, use `ping()` directly:
+
+```typescript
+await client.ping("check-id")                              // Success
+await client.ping("check-id", { type: "start" })           // Job started
+await client.ping("check-id", { type: "fail" })            // Job failed
+await client.ping("check-id", { type: "fail", body: "Error details" })
+```
+
+## Configuration
+
+```typescript
+const client = new Spanwise({
+  apiKey: "sw_...",
+  timeout: 30000, // optional, default 30s
+  retries: 2,     // optional, default 2 retries with exponential backoff
+})
+```
+
+### Development Mode (No-op)
+
+When `apiKey` is undefined, `ping()` and `wrap()` silently no-op. This allows running in development without setting up monitoring:
+
+```typescript
+const client = new Spanwise({ apiKey: process.env.SPANWISE_API_KEY })
+
+// Works in dev (no-op) and prod (sends pings)
+await client.wrap("check-id", async () => {
+  await myJob()
+})
+```
+
+Management APIs (projects, checks, etc.) still require an API key and will throw if accessed without one.
+
+## API Reference
+
+### Projects
+
+```typescript
+const projects = await client.projects.list()
+const project = await client.projects.get("project-id")
+const project = await client.projects.create({ name: "My Project", slug: "my-project", orgId: "org-id" })
+await client.projects.update("project-id", { name: "New Name" })
+await client.projects.delete("project-id")
+```
+
+### Checks
+
+```typescript
+const checks = await client.checks.list("project-id")
+const check = await client.checks.get("check-id")
+const check = await client.checks.create("project-id", {
+  name: "DB Backup",
+  scheduleType: "PERIOD",
+  scheduleValue: "3600", // every hour
+})
+await client.checks.update("check-id", { name: "New Name" })
+await client.checks.pause("check-id")
+await client.checks.resume("check-id")
+await client.checks.delete("check-id")
+
+// Uptime stats
+const stats = await client.checks.stats("check-id", 90) // last 90 days
+```
+
+### Channels (Notifications)
+
+```typescript
+const channels = await client.channels.list("project-id")
+const channel = await client.channels.create("project-id", {
+  type: "SLACK_WEBHOOK",
+  name: "Slack Alerts",
+  config: { webhookUrl: "https://hooks.slack.com/..." },
+})
+await client.channels.update("project-id", "channel-id", { name: "New Name" })
+await client.channels.test("project-id", "channel-id") // Test notification
+await client.channels.delete("project-id", "channel-id")
+```
+
+### Incidents
+
+```typescript
+const incidents = await client.incidents.list("project-id")
+const incidents = await client.incidents.list("project-id", { status: "INVESTIGATING" })
+
+const incident = await client.incidents.create("project-id", {
+  title: "API Degradation",
+  impact: "MINOR",
+})
+
+await client.incidents.update("project-id", "incident-id", { status: "IDENTIFIED" })
+
+// Add status update
+await client.incidents.addUpdate("project-id", "incident-id", {
+  status: "MONITORING",
+  message: "Fix deployed, monitoring for stability",
+})
+
+await client.incidents.delete("project-id", "incident-id")
+```
+
+### Maintenance Windows
+
+```typescript
+const windows = await client.maintenance.list("project-id")
+const windows = await client.maintenance.list("project-id", { upcoming: true })
+
+const maintenance = await client.maintenance.create("project-id", {
+  title: "Database Migration",
+  startsAt: "2024-01-15T03:00:00Z",
+  endsAt: "2024-01-15T05:00:00Z",
+  checkIds: ["check-1", "check-2"],
+})
+
+await client.maintenance.update("project-id", "maintenance-id", { title: "Updated Title" })
+await client.maintenance.delete("project-id", "maintenance-id")
+```
+
+### Organizations
+
+```typescript
+const orgs = await client.organizations.list()
+const org = await client.organizations.get("org-id")
+const org = await client.organizations.create({ name: "My Org", slug: "my-org" })
+await client.organizations.update("org-id", { autoCreateIncidents: true })
+await client.organizations.delete("org-id")
+```
+
+### API Keys
+
+```typescript
+const keys = await client.apiKeys.list("project-id")
+const newKey = await client.apiKeys.create("project-id", { name: "CI/CD" })
+console.log(newKey.key) // Full key shown only once
+await client.apiKeys.delete("project-id", "key-id")
+```
+
+## Error Handling
+
+```typescript
+import { SpanwiseError, NotFoundError, UnauthorizedError } from "@spanwise/sdk"
+
+try {
+  await client.checks.get("invalid-id")
+} catch (error) {
+  if (error instanceof NotFoundError) {
+    console.log("Check not found")
+  } else if (error instanceof UnauthorizedError) {
+    console.log("Invalid API key")
+  } else if (error instanceof SpanwiseError) {
+    console.log(`Error: ${error.message} (${error.code})`)
+  }
+}
+```
+
+## Types
+
+All types are exported for TypeScript users:
+
+```typescript
+import type {
+  Check,
+  CheckStatus,
+  Channel,
+  ChannelType,
+  Incident,
+  IncidentStatus,
+  Maintenance,
+  Organization,
+  Project,
+} from "@spanwise/sdk"
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,100 @@
+import { ApiKeysClient } from "./resources/api-keys.js";
+import { ChannelsClient } from "./resources/channels.js";
+import { ChecksClient } from "./resources/checks.js";
+import { OrganizationsClient } from "./resources/organizations.js";
+import { ProjectsClient } from "./resources/projects.js";
+import type { PingOptions, SpanInterface, SpanOptions, TraceOptions, VidentConfig, WrapOptions } from "./types.js";
+export declare class Vident {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeout;
+    private readonly retries;
+    private readonly enabled;
+    private readonly tracingClient;
+    private readonly metricsClient;
+    private readonly eventsClient;
+    private readonly instrumentations;
+    readonly projects: ProjectsClient;
+    readonly checks: ChecksClient;
+    readonly channels: ChannelsClient;
+    readonly organizations: OrganizationsClient;
+    readonly apiKeys: ApiKeysClient;
+    constructor(config?: VidentConfig);
+    private request;
+    ping(slug: string, options?: PingOptions): Promise<void>;
+    /**
+     * Wraps an async function with success/fail pings.
+     * Optionally sends a start ping before execution for duration tracking.
+     * Rethrows the original error after sending fail ping.
+     * If no apiKey configured, just runs the function without pings.
+     */
+    wrap<T>(slug: string, fn: () => Promise<T>, options?: WrapOptions): Promise<T>;
+    /**
+     * Wrap an async operation with tracing.
+     * Automatically handles span creation and error recording.
+     */
+    trace<T>(name: string, fn: (span: SpanInterface) => Promise<T>, options?: TraceOptions): Promise<T>;
+    /**
+     * Manually start a span. Call span.end() when done.
+     */
+    startSpan(name: string, options?: SpanOptions): SpanInterface;
+    /**
+     * Capture an error without an associated span.
+     */
+    captureError(error: Error, context?: Record<string, string>): void;
+    /**
+     * Flush pending spans immediately.
+     */
+    flushSpans(): Promise<void>;
+    /**
+     * Record a counter metric (increments by value, default 1).
+     */
+    counter(name: string, value?: number, attributes?: Record<string, string>): void;
+    /**
+     * Record a gauge metric (point-in-time value).
+     */
+    gauge(name: string, value: number, attributes?: Record<string, string>): void;
+    /**
+     * Record a histogram metric (for distributions).
+     */
+    histogram(name: string, value: number, attributes?: Record<string, string>): void;
+    /**
+     * Simple metric helper (defaults to gauge).
+     */
+    metric(name: string, value: number, attributes?: Record<string, string>): void;
+    /**
+     * Flush pending metrics immediately.
+     */
+    flushMetrics(): Promise<void>;
+    /**
+     * Record a structured event with info level.
+     * Auto-links to active trace if available.
+     */
+    event(name: string, message: string, attributes?: Record<string, string>): void;
+    /**
+     * Record a debug-level event.
+     */
+    debug(name: string, message: string, attributes?: Record<string, string>): void;
+    /**
+     * Record an info-level event.
+     */
+    info(name: string, message: string, attributes?: Record<string, string>): void;
+    /**
+     * Record a warn-level event.
+     */
+    warn(name: string, message: string, attributes?: Record<string, string>): void;
+    /**
+     * Record an error-level event.
+     */
+    errorEvent(name: string, message: string, attributes?: Record<string, string>): void;
+    /**
+     * Flush pending events immediately.
+     */
+    flushEvents(): Promise<void>;
+    /**
+     * Destroy the client and clean up resources.
+     * Stops any pending flush timers and discards pending data.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,249 @@
+import { BadRequestError } from "./errors.js";
+import { fetchWithRetry, handleResponse } from "./http.js";
+import { ApiKeysClient } from "./resources/api-keys.js";
+import { ChannelsClient } from "./resources/channels.js";
+import { ChecksClient } from "./resources/checks.js";
+import { EventsClient } from "./resources/events.js";
+import { MetricsClient } from "./resources/metrics.js";
+import { OrganizationsClient } from "./resources/organizations.js";
+import { ProjectsClient } from "./resources/projects.js";
+import { TracingClient } from "./resources/tracing.js";
+import { alwaysOnSampler, parentBasedSampler } from "./sampler.js";
+// No-op span for disabled mode - zero overhead
+const noopSpan = {
+    spanId: "",
+    traceId: "",
+    name: "",
+    end: () => { },
+    setAttributes: () => { },
+    updateName: () => { },
+    context: () => ({ traceId: "", spanId: "" }),
+};
+export class Vident {
+    baseUrl;
+    apiKey;
+    timeout;
+    retries;
+    enabled;
+    tracingClient;
+    metricsClient;
+    eventsClient;
+    instrumentations;
+    projects;
+    checks;
+    channels;
+    organizations;
+    apiKeys;
+    constructor(config = {}) {
+        // Determine if SDK should be enabled
+        // Disabled when: explicit enabled:false, or no apiKey
+        this.enabled = config.enabled !== false && !!config.apiKey;
+        if (config.apiKey && !config.apiKey.startsWith("sw_")) {
+            throw new BadRequestError("Invalid API key format. Expected key starting with 'sw_'");
+        }
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl ?? "https://api.vident.dev";
+        this.timeout = config.timeout ?? 30000;
+        this.retries = config.retries ?? 2;
+        const request = this.request.bind(this);
+        this.projects = new ProjectsClient(request);
+        this.checks = new ChecksClient(request);
+        this.channels = new ChannelsClient(request);
+        this.organizations = new OrganizationsClient(request);
+        this.apiKeys = new ApiKeysClient(request);
+        // When disabled: no clients, no timers, no async hooks
+        if (!this.enabled) {
+            this.tracingClient = null;
+            this.metricsClient = null;
+            this.eventsClient = null;
+            this.instrumentations = [];
+            return;
+        }
+        // Default: parent-based with 100% root sampling
+        const sampler = config.sampler ?? parentBasedSampler({ root: alwaysOnSampler() });
+        this.tracingClient = new TracingClient(request, config.serviceName ?? "unknown", this.enabled, sampler);
+        this.metricsClient = new MetricsClient(request, config.serviceName ?? "unknown", this.enabled);
+        this.eventsClient = new EventsClient(request, config.serviceName ?? "unknown", this.enabled);
+        this.instrumentations = config.instrumentations ?? [];
+        for (const inst of this.instrumentations) {
+            inst.init(this);
+        }
+    }
+    async request(method, path, body) {
+        if (!this.enabled) {
+            throw new BadRequestError("API key is required for management APIs. Set apiKey in Vident config.");
+        }
+        const response = await fetchWithRetry(`${this.baseUrl}${path}`, {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        }, this.timeout, this.retries);
+        return handleResponse(response);
+    }
+    async ping(slug, options = {}) {
+        if (!this.enabled)
+            return;
+        const { type = "success", body } = options;
+        let path = `/ping/${slug}`;
+        if (type === "start")
+            path += "/start";
+        else if (type === "fail")
+            path += "/fail";
+        try {
+            const response = await fetchWithRetry(`${this.baseUrl}${path}`, {
+                method: body ? "POST" : "GET",
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: body ?? undefined,
+            }, this.timeout, this.retries);
+            if (!response.ok) {
+                console.warn(`[vident] ping failed for "${slug}": ${response.status}`);
+            }
+        }
+        catch (error) {
+            console.warn(`[vident] ping failed for "${slug}": ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Wraps an async function with success/fail pings.
+     * Optionally sends a start ping before execution for duration tracking.
+     * Rethrows the original error after sending fail ping.
+     * If no apiKey configured, just runs the function without pings.
+     */
+    async wrap(slug, fn, options = {}) {
+        if (!this.enabled)
+            return fn();
+        const { trackDuration = false } = options;
+        if (trackDuration) {
+            await this.ping(slug, { type: "start" });
+        }
+        try {
+            // Wrap in trace to create span context for child operations
+            const result = await this.trace(`cron:${slug}`, () => fn(), {
+                kind: "internal",
+            });
+            await this.ping(slug, { type: "success" });
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error
+                ? `${error.name}: ${error.message}`
+                : String(error);
+            await this.ping(slug, { type: "fail", body: errorMessage });
+            throw error;
+        }
+    }
+    /**
+     * Wrap an async operation with tracing.
+     * Automatically handles span creation and error recording.
+     */
+    async trace(name, fn, options) {
+        if (!this.tracingClient)
+            return fn(noopSpan);
+        return this.tracingClient.trace(name, fn, options);
+    }
+    /**
+     * Manually start a span. Call span.end() when done.
+     */
+    startSpan(name, options) {
+        if (!this.tracingClient)
+            return noopSpan;
+        return this.tracingClient.startSpan(name, options);
+    }
+    /**
+     * Capture an error without an associated span.
+     */
+    captureError(error, context) {
+        this.tracingClient?.captureError(error, context);
+    }
+    /**
+     * Flush pending spans immediately.
+     */
+    async flushSpans() {
+        return this.tracingClient?.flush();
+    }
+    /**
+     * Record a counter metric (increments by value, default 1).
+     */
+    counter(name, value, attributes) {
+        this.metricsClient?.counter(name, value, attributes);
+    }
+    /**
+     * Record a gauge metric (point-in-time value).
+     */
+    gauge(name, value, attributes) {
+        this.metricsClient?.gauge(name, value, attributes);
+    }
+    /**
+     * Record a histogram metric (for distributions).
+     */
+    histogram(name, value, attributes) {
+        this.metricsClient?.histogram(name, value, attributes);
+    }
+    /**
+     * Simple metric helper (defaults to gauge).
+     */
+    metric(name, value, attributes) {
+        this.metricsClient?.metric(name, value, attributes);
+    }
+    /**
+     * Flush pending metrics immediately.
+     */
+    async flushMetrics() {
+        return this.metricsClient?.flush();
+    }
+    /**
+     * Record a structured event with info level.
+     * Auto-links to active trace if available.
+     */
+    event(name, message, attributes) {
+        this.eventsClient?.event(name, message, attributes);
+    }
+    /**
+     * Record a debug-level event.
+     */
+    debug(name, message, attributes) {
+        this.eventsClient?.debug(name, message, attributes);
+    }
+    /**
+     * Record an info-level event.
+     */
+    info(name, message, attributes) {
+        this.eventsClient?.info(name, message, attributes);
+    }
+    /**
+     * Record a warn-level event.
+     */
+    warn(name, message, attributes) {
+        this.eventsClient?.warn(name, message, attributes);
+    }
+    /**
+     * Record an error-level event.
+     */
+    errorEvent(name, message, attributes) {
+        this.eventsClient?.error(name, message, attributes);
+    }
+    /**
+     * Flush pending events immediately.
+     */
+    async flushEvents() {
+        return this.eventsClient?.flush();
+    }
+    /**
+     * Destroy the client and clean up resources.
+     * Stops any pending flush timers and discards pending data.
+     */
+    destroy() {
+        for (const inst of this.instrumentations) {
+            inst.destroy?.();
+        }
+        this.tracingClient?.destroy();
+        this.metricsClient?.destroy();
+        this.eventsClient?.destroy();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,15 @@
+import type { SpanInterface } from "./types.js";
+/**
+ * Enable debug mode to trace context propagation issues.
+ * When enabled, logs a stack trace whenever a span is created without parent context.
+ */
+export declare function enableContextDebug(): void;
+/**
+ * Check if debug mode is enabled.
+ */
+export declare function isContextDebugEnabled(): boolean;
+export declare function getActiveSpan(): SpanInterface | undefined;
+export declare function isTracingSuppressed(): boolean;
+export declare function runWithSpan<T>(span: SpanInterface, fn: () => T): T;
+export declare function suppressTracing<T>(fn: () => T): T;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAoB/C;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAgB,aAAa,IAAI,aAAa,GAAG,SAAS,CAEzD;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAIlE;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAIjD"}

package/dist/context.js

@@ -0,0 +1,41 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+// Lazy-initialize to avoid conflicts with test runners (Vitest, Jest)
+// that also use async_hooks for module mocking
+let store = null;
+function getStore() {
+    if (!store) {
+        store = new AsyncLocalStorage();
+    }
+    return store;
+}
+let debugMode = false;
+/**
+ * Enable debug mode to trace context propagation issues.
+ * When enabled, logs a stack trace whenever a span is created without parent context.
+ */
+export function enableContextDebug() {
+    debugMode = true;
+}
+/**
+ * Check if debug mode is enabled.
+ */
+export function isContextDebugEnabled() {
+    return debugMode;
+}
+export function getActiveSpan() {
+    return getStore().getStore()?.span;
+}
+export function isTracingSuppressed() {
+    return getStore().getStore()?.suppressed === true;
+}
+export function runWithSpan(span, fn) {
+    const s = getStore();
+    const current = s.getStore();
+    return s.run({ ...current, span }, fn);
+}
+export function suppressTracing(fn) {
+    const s = getStore();
+    const current = s.getStore();
+    return s.run({ ...current, suppressed: true }, fn);
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAQpD,sEAAsE;AACtE,+CAA+C;AAC/C,IAAI,KAAK,GAA6C,IAAI,CAAA;AAE1D,SAAS,QAAQ;IAChB,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,KAAK,GAAG,IAAI,iBAAiB,EAAkB,CAAA;IAChD,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC;AAED,IAAI,SAAS,GAAG,KAAK,CAAA;AAErB;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IACjC,SAAS,GAAG,IAAI,CAAA;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACpC,OAAO,SAAS,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,aAAa;IAC5B,OAAO,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAA;AACnC,CAAC;AAED,MAAM,UAAU,mBAAmB;IAClC,OAAO,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,UAAU,KAAK,IAAI,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,WAAW,CAAI,IAAmB,EAAE,EAAW;IAC9D,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAA;IACpB,MAAM,OAAO,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC5B,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,eAAe,CAAI,EAAW;IAC7C,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAA;IACpB,MAAM,OAAO,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC5B,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;AACnD,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,18 @@
+export declare class VidentError extends Error {
+    code: string;
+    status: number;
+    constructor(message: string, code: string, status: number);
+}
+export declare class NotFoundError extends VidentError {
+    constructor(message?: string);
+}
+export declare class UnauthorizedError extends VidentError {
+    constructor(message?: string);
+}
+export declare class ForbiddenError extends VidentError {
+    constructor(message?: string);
+}
+export declare class BadRequestError extends VidentError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;IAG7B,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,MAAM;gBAFrB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;CAKtB;AAED,qBAAa,aAAc,SAAQ,WAAW;gBACjC,OAAO,SAAuB;CAI1C;AAED,qBAAa,iBAAkB,SAAQ,WAAW;gBACrC,OAAO,SAAiB;CAIpC;AAED,qBAAa,cAAe,SAAQ,WAAW;gBAClC,OAAO,SAAc;CAIjC;AAED,qBAAa,eAAgB,SAAQ,WAAW;gBACnC,OAAO,SAAgB;CAInC"}