@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/types/freshbooks.d.ts

@@ -0,0 +1,276 @@
+/**
+ * FreshBooks entity type definitions
+ * These match the structure returned by @freshbooks/api SDK
+ */
+/**
+ * Money type - decimal amount with currency code
+ */
+export interface Money {
+    amount: string;
+    code: string;
+}
+/**
+ * Visibility state enum
+ * 0 = active, 1 = deleted, 2 = archived
+ */
+export type VisState = 0 | 1 | 2;
+/**
+ * Timer embedded in TimeEntry
+ */
+export interface Timer {
+    id: number;
+    isRunning: boolean | null;
+}
+/**
+ * Time Entry entity
+ */
+export interface TimeEntry {
+    id: number;
+    identityId?: number;
+    isLogged: boolean;
+    startedAt: string;
+    createdAt: string;
+    clientId?: number | null;
+    projectId?: number | null;
+    pendingClient?: string | null;
+    pendingProject?: string | null;
+    pendingTask?: string | null;
+    taskId?: number | null;
+    serviceId?: number | null;
+    note?: string | null;
+    active?: boolean;
+    billable?: boolean;
+    billed?: boolean;
+    internal?: boolean;
+    retainerId?: number | null;
+    duration: number;
+    timer?: Timer | null;
+}
+/**
+ * Project billing method enum
+ */
+export type BillingMethod = 'project_rate' | 'service_rate' | 'flat_rate' | 'team_member_rate';
+/**
+ * Project type enum
+ */
+export type ProjectType = 'fixed_price' | 'hourly_rate';
+/**
+ * Project billed status enum
+ */
+export type BilledStatus = 'unbilled' | 'partial' | 'billed';
+/**
+ * Project entity
+ */
+export interface Project {
+    id: number;
+    title: string;
+    description?: string | null;
+    dueDate?: string | null;
+    clientId?: string | null;
+    internal?: boolean;
+    budget?: string | null;
+    fixedPrice?: string | null;
+    rate?: string | null;
+    billingMethod?: BillingMethod | null;
+    projectType?: ProjectType;
+    projectManagerId?: string | null;
+    active?: boolean;
+    complete?: boolean;
+    sample?: boolean;
+    createdAt: string;
+    updatedAt: string;
+    loggedDuration?: number | null;
+    billedAmount?: number;
+    billedStatus?: BilledStatus;
+    retainerId?: string | null;
+    expenseMarkup?: number;
+    groupId?: string | null;
+}
+/**
+ * Service entity
+ */
+export interface Service {
+    id: number;
+    businessId: number;
+    name: string;
+    billable?: boolean;
+    visState?: VisState;
+}
+/**
+ * Service rate configuration
+ */
+export interface ServiceRate {
+    rate: string;
+    code: string;
+}
+/**
+ * Task entity
+ */
+export interface Task {
+    id: number;
+    taskid?: number;
+    name?: string | null;
+    tname?: string | null;
+    description?: string | null;
+    tdesc?: string | null;
+    billable?: boolean;
+    rate?: Money;
+    visState?: VisState;
+    updated?: string;
+}
+/**
+ * Client entity
+ */
+export interface Client {
+    id: number;
+    fName?: string | null;
+    lName?: string | null;
+    organization?: string | null;
+    email?: string | null;
+    busPhone?: string;
+    homePhone?: string | null;
+    mobPhone?: string;
+    fax?: string;
+    note?: string | null;
+    pStreet?: string;
+    pStreet2?: string;
+    pCity?: string;
+    pProvince?: string;
+    pCode?: string;
+    pCountry?: string;
+    sStreet?: string;
+    sStreet2?: string;
+    sCity?: string;
+    sProvince?: string;
+    sCode?: string;
+    sCountry?: string;
+    currencyCode?: string;
+    language?: string | null;
+    vatNumber?: string | null;
+    vatName?: string | null;
+    visState?: VisState;
+    signupDate?: string | null;
+    updated?: string | null;
+    allowLateFees?: boolean;
+    allowLateNotifications?: boolean;
+    hasRetainer?: boolean | null;
+    retainerId?: string | null;
+}
+/**
+ * Pagination metadata
+ */
+export interface PaginationMeta {
+    page: number;
+    pages: number;
+    total: number;
+    perPage: number;
+}
+/**
+ * Standard FreshBooks API response wrapper
+ */
+export interface FreshBooksResponse<T> {
+    ok: boolean;
+    data?: T;
+    error?: FreshBooksAPIError;
+}
+/**
+ * FreshBooks API error structure
+ */
+export interface FreshBooksAPIError {
+    code: string;
+    message: string;
+    field?: string;
+    errno?: number;
+}
+/**
+ * Time Entry list response
+ */
+export interface TimeEntryListData {
+    timeEntries: TimeEntry[];
+    pages: PaginationMeta;
+}
+/**
+ * Time Entry single response
+ */
+export interface TimeEntrySingleData {
+    timeEntry: TimeEntry;
+}
+/**
+ * Project list response
+ */
+export interface ProjectListData {
+    projects: Project[];
+    pages: PaginationMeta;
+}
+/**
+ * Project single response
+ */
+export interface ProjectSingleData {
+    project: Project;
+}
+/**
+ * Service list response
+ */
+export interface ServiceListData {
+    services: Service[];
+    pages: PaginationMeta;
+}
+/**
+ * Service single response
+ */
+export interface ServiceSingleData {
+    service: Service;
+}
+/**
+ * Task list response
+ */
+export interface TaskListData {
+    tasks: Task[];
+    pages: PaginationMeta;
+}
+/**
+ * Task single response
+ */
+export interface TaskSingleData {
+    task: Task;
+}
+/**
+ * OAuth token response
+ */
+export interface OAuthTokenResponse {
+    access_token: string;
+    refresh_token: string;
+    token_type: string;
+    expires_in: number;
+    created_at: number;
+}
+/**
+ * OAuth error response
+ */
+export interface OAuthErrorResponse {
+    error: string;
+    error_description: string;
+}
+/**
+ * Business membership for account selection
+ */
+export interface BusinessMembership {
+    id: number;
+    role: string;
+    business: {
+        id: number;
+        name: string;
+        account_id: string;
+    };
+}
+/**
+ * Account list response
+ */
+export interface AccountListResponse {
+    response: {
+        result: {
+            business_memberships: BusinessMembership[];
+        };
+    };
+}
+//# sourceMappingURL=freshbooks.d.ts.map

package/dist/types/freshbooks.d.ts.map

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

package/dist/types/freshbooks.js

@@ -0,0 +1,6 @@
+/**
+ * FreshBooks entity type definitions
+ * These match the structure returned by @freshbooks/api SDK
+ */
+export {};
+//# sourceMappingURL=freshbooks.js.map

package/dist/types/freshbooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshbooks.js","sourceRoot":"","sources":["../../src/types/freshbooks.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/index.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Shared TypeScript types for FreshBooks MCP Server
+ */
+export * from './freshbooks.js';
+/**
+ * Log levels for the application logger
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * OAuth2 token storage structure
+ */
+export interface TokenStore {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+    accountId: string;
+}
+/**
+ * OAuth2 configuration
+ */
+export interface OAuthConfig {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+    authorizationUrl: string;
+    tokenUrl: string;
+    revokeUrl: string;
+}
+/**
+ * Server configuration
+ */
+export interface ServerConfig {
+    freshbooks: OAuthConfig & {
+        apiBaseUrl: string;
+    };
+    server: {
+        logLevel: LogLevel;
+        tokenStorePath: string;
+    };
+}
+/**
+ * MCP error with FreshBooks context
+ */
+export interface MCPError {
+    code: number;
+    message: string;
+    data: {
+        freshbooksError?: {
+            code: string;
+            message: string;
+            field?: string;
+        };
+        context?: Record<string, unknown>;
+        recoverable: boolean;
+        suggestion?: string;
+    };
+}
+/**
+ * FreshBooks API error structure
+ */
+export interface FreshBooksError {
+    code?: string;
+    message: string;
+    field?: string;
+    statusCode?: number;
+}
+/**
+ * Pagination parameters
+ */
+export interface PaginationParams {
+    page?: number;
+    perPage?: number;
+}
+/**
+ * Pagination metadata in responses
+ */
+export interface PaginationMetadata {
+    page: number;
+    pages: number;
+    perPage: number;
+    total: number;
+}
+/**
+ * Standard list response wrapper
+ */
+export interface ListResponse<T> {
+    data: T[];
+    meta: {
+        pagination: PaginationMetadata;
+    };
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,iBAAiB,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,WAAW,GAAG;QACxB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,MAAM,EAAE;QACN,QAAQ,EAAE,QAAQ,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACJ,eAAe,CAAC,EAAE;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC;QACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,IAAI,EAAE;QACJ,UAAU,EAAE,kBAAkB,CAAC;KAChC,CAAC;CACH"}

package/dist/types/index.js

@@ -0,0 +1,6 @@
+/**
+ * Shared TypeScript types for FreshBooks MCP Server
+ */
+// Re-export FreshBooks entity types
+export * from './freshbooks.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oCAAoC;AACpC,cAAc,iBAAiB,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utility exports
+ */
+export { logger } from './logger.js';
+export { PaginationSchema, getPaginationParams, createPaginationMetadata, hasMorePages, getNextPage, getPreviousPage, } from './pagination.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,EACZ,WAAW,EACX,eAAe,GAChB,MAAM,iBAAiB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,6 @@
+/**
+ * Utility exports
+ */
+export { logger } from './logger.js';
+export { PaginationSchema, getPaginationParams, createPaginationMetadata, hasMorePages, getNextPage, getPreviousPage, } from './pagination.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,EACZ,WAAW,EACX,eAAe,GAChB,MAAM,iBAAiB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Logging utility for FreshBooks MCP Server
+ *
+ * IMPORTANT: All logs go to stderr (stdout is reserved for MCP protocol)
+ */
+import type { LogLevel } from '../types/index.js';
+declare class Logger {
+    private currentLevel;
+    private requestId;
+    constructor(level?: LogLevel);
+    /**
+     * Set the current log level
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Set request ID for correlation
+     */
+    setRequestId(id: string): void;
+    /**
+     * Clear request ID
+     */
+    clearRequestId(): void;
+    /**
+     * Check if a log level should be output
+     */
+    private shouldLog;
+    /**
+     * Sanitize data to prevent logging sensitive information
+     */
+    private sanitize;
+    /**
+     * Write structured log to stderr
+     */
+    private write;
+    /**
+     * Log debug message
+     */
+    debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log info message
+     */
+    info(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log error message
+     */
+    error(message: string, error?: Error | unknown, context?: Record<string, unknown>): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AASlD,cAAM,MAAM;IACV,OAAO,CAAC,YAAY,CAAW;IAC/B,OAAO,CAAC,SAAS,CAAuB;gBAE5B,KAAK,GAAE,QAAiB;IAIpC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,cAAc,IAAI,IAAI;IAItB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAqChB;;OAEG;IACH,OAAO,CAAC,KAAK;IAiBb;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAezF;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,133 @@
+/**
+ * Logging utility for FreshBooks MCP Server
+ *
+ * IMPORTANT: All logs go to stderr (stdout is reserved for MCP protocol)
+ */
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+class Logger {
+    currentLevel;
+    requestId = null;
+    constructor(level = 'info') {
+        this.currentLevel = level;
+    }
+    /**
+     * Set the current log level
+     */
+    setLevel(level) {
+        this.currentLevel = level;
+    }
+    /**
+     * Set request ID for correlation
+     */
+    setRequestId(id) {
+        this.requestId = id;
+    }
+    /**
+     * Clear request ID
+     */
+    clearRequestId() {
+        this.requestId = null;
+    }
+    /**
+     * Check if a log level should be output
+     */
+    shouldLog(level) {
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.currentLevel];
+    }
+    /**
+     * Sanitize data to prevent logging sensitive information
+     */
+    sanitize(data) {
+        if (typeof data !== 'object' || data === null) {
+            return data;
+        }
+        if (Array.isArray(data)) {
+            return data.map((item) => this.sanitize(item));
+        }
+        const sanitized = {};
+        const sensitiveKeys = [
+            'token',
+            'accessToken',
+            'refreshToken',
+            'access_token',
+            'refresh_token',
+            'secret',
+            'password',
+            'clientSecret',
+            'client_secret',
+            'authorization',
+            'apiKey',
+            'api_key',
+        ];
+        for (const [key, value] of Object.entries(data)) {
+            const lowerKey = key.toLowerCase();
+            if (sensitiveKeys.some((sensitive) => lowerKey.includes(sensitive))) {
+                sanitized[key] = '[REDACTED]';
+            }
+            else {
+                sanitized[key] = this.sanitize(value);
+            }
+        }
+        return sanitized;
+    }
+    /**
+     * Write structured log to stderr
+     */
+    write(level, message, context) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        const logEntry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            ...(this.requestId && { requestId: this.requestId }),
+            ...(context && { context: this.sanitize(context) }),
+        };
+        // Write to stderr only (stdout reserved for MCP protocol)
+        process.stderr.write(JSON.stringify(logEntry) + '\n');
+    }
+    /**
+     * Log debug message
+     */
+    debug(message, context) {
+        this.write('debug', message, context);
+    }
+    /**
+     * Log info message
+     */
+    info(message, context) {
+        this.write('info', message, context);
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, context) {
+        this.write('warn', message, context);
+    }
+    /**
+     * Log error message
+     */
+    error(message, error, context) {
+        const errorContext = context ? { ...context } : {};
+        if (error instanceof Error) {
+            errorContext.error = {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+            };
+        }
+        else if (error) {
+            errorContext.error = this.sanitize(error);
+        }
+        this.write('error', message, errorContext);
+    }
+}
+// Export singleton instance
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/pagination.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Pagination utilities for FreshBooks API
+ */
+import { z } from 'zod';
+import type { PaginationParams, PaginationMetadata } from '../types/index.js';
+/**
+ * Standard pagination schema for tool inputs
+ */
+export declare const PaginationSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodNumber>;
+    perPage: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    perPage: number;
+}, {
+    page?: number | undefined;
+    perPage?: number | undefined;
+}>;
+/**
+ * Extract pagination parameters from input
+ */
+export declare function getPaginationParams(input: unknown): PaginationParams;
+/**
+ * Create pagination metadata for responses
+ */
+export declare function createPaginationMetadata(page: number, perPage: number, total: number): PaginationMetadata;
+/**
+ * Check if there are more pages available
+ */
+export declare function hasMorePages(pagination: PaginationMetadata): boolean;
+/**
+ * Get next page number, or null if no more pages
+ */
+export declare function getNextPage(pagination: PaginationMetadata): number | null;
+/**
+ * Get previous page number, or null if on first page
+ */
+export declare function getPreviousPage(pagination: PaginationMetadata): number | null;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/utils/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAS3B,CAAC;AAEH;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAYpE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,kBAAkB,CASpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAEpE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAEzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAE7E"}