@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/journal-entry-account/journalentryaccount-list.js

@@ -0,0 +1,102 @@
+/**
+ * JournalEntryAccount List Tool
+ *
+ * List chart of accounts for use in journal entries.
+ */
+import { JournalEntryAccountListInputSchema, JournalEntryAccountListOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Tool definition for journalentryaccount_list
+ */
+export const journalEntryAccountListTool = {
+    name: "journalentryaccount_list",
+    description: `List the chart of accounts from FreshBooks.
+
+WHEN TO USE:
+- User needs to create a journal entry and needs account IDs
+- User asks "show chart of accounts", "list accounting accounts"
+- Need to find the correct subAccountId for journal entries
+- User wants to see available accounts for debits/credits
+
+WHAT IT RETURNS:
+Complete chart of accounts with:
+- Account categories (asset, liability, equity, revenue, expense)
+- Sub-accounts with IDs (use these IDs in journal entries)
+- Account numbers and descriptions
+- Current balances
+
+ACCOUNT TYPES:
+- asset: Cash, inventory, equipment, accounts receivable
+- liability: Loans, accounts payable, credit cards
+- equity: Owner's equity, retained earnings
+- revenue: Sales, service income
+- expense: Operating expenses, cost of goods sold
+
+FILTERING:
+- Use accountType to show only specific categories
+- Use pagination for large charts of accounts
+
+EXAMPLE PROMPTS:
+- "Show me the chart of accounts"
+- "List all expense accounts"
+- "What are the available asset accounts?"
+- "I need account IDs for a journal entry"
+
+IMPORTANT FOR JOURNAL ENTRIES:
+Use the subAccount ID (not the parent account ID) when creating journal entries.
+Each detail line in a journal entry requires a subAccountId.
+
+RETURNS:
+Chart of accounts with sub-accounts and their IDs for use in journal entries.`,
+    inputSchema: JournalEntryAccountListInputSchema,
+    outputSchema: JournalEntryAccountListOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('journalentryaccount_list', async (input, _context) => {
+            const { accountId, page, perPage, accountType } = input;
+            const result = await client.executeWithRetry('journalentryaccount_list', async (fbClient) => {
+                const { PaginationQueryBuilder, SearchQueryBuilder } = await import('@freshbooks/api/dist/models/builders/index.js');
+                // Build query builders array
+                const queryBuilders = [];
+                // Add pagination if specified
+                if (page !== undefined || perPage !== undefined) {
+                    const pagination = new PaginationQueryBuilder();
+                    if (page !== undefined)
+                        pagination.page(page);
+                    if (perPage !== undefined)
+                        pagination.perPage(perPage);
+                    queryBuilders.push(pagination);
+                }
+                // Add account type filter if specified
+                if (accountType !== undefined) {
+                    const search = new SearchQueryBuilder();
+                    search.equals("account_type", accountType);
+                    queryBuilders.push(search);
+                }
+                const response = await fbClient.journalEntryAccounts.list(accountId, queryBuilders);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // Extract data
+            const accounts = result.accounts || result.journalEntryAccounts || [];
+            const paginationData = result.pages || {
+                page: 1,
+                pages: 1,
+                total: accounts.length,
+                per_page: 30,
+            };
+            return {
+                accounts,
+                pagination: {
+                    page: paginationData.page,
+                    pages: paginationData.pages,
+                    perPage: paginationData.per_page || paginationData.perPage || 30,
+                    total: paginationData.total,
+                },
+            };
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=journalentryaccount-list.js.map

package/dist/tools/journal-entry-account/journalentryaccount-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journalentryaccount-list.js","sourceRoot":"","sources":["../../../src/tools/journal-entry-account/journalentryaccount-list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kCAAkC,EAAE,mCAAmC,EAAE,MAAM,cAAc,CAAC;AACvG,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8EAqC+D;IAE5E,WAAW,EAAE,kCAAkC;IAC/C,YAAY,EAAE,mCAAmC;IAEjD,KAAK,CAAC,OAAO,CACX,KAAyD,EACzD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,0BAA0B,EAC1B,KAAK,EAAE,KAAyD,EAAE,QAAqB,EAAE,EAAE;YACzF,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;YAExD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,0BAA0B,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC1F,MAAM,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CACjE,+CAA+C,CAChD,CAAC;gBAEF,6BAA6B;gBAC7B,MAAM,aAAa,GAAU,EAAE,CAAC;gBAEhC,8BAA8B;gBAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAChD,MAAM,UAAU,GAAG,IAAI,sBAAsB,EAAE,CAAC;oBAChD,IAAI,IAAI,KAAK,SAAS;wBAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC9C,IAAI,OAAO,KAAK,SAAS;wBAAE,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBACvD,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACjC,CAAC;gBAED,uCAAuC;gBACvC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;oBAC9B,MAAM,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;oBACxC,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;oBAC3C,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC7B,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;gBAEpF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,eAAe;YACf,MAAM,QAAQ,GAAI,MAAc,CAAC,QAAQ,IAAK,MAAc,CAAC,oBAAoB,IAAI,EAAE,CAAC;YACxF,MAAM,cAAc,GAAI,MAAc,CAAC,KAAK,IAAI;gBAC9C,IAAI,EAAE,CAAC;gBACP,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,QAAQ,CAAC,MAAM;gBACtB,QAAQ,EAAE,EAAE;aACb,CAAC;YAEF,OAAO;gBACL,QAAQ;gBACR,UAAU,EAAE;oBACV,IAAI,EAAE,cAAc,CAAC,IAAI;oBACzB,KAAK,EAAE,cAAc,CAAC,KAAK;oBAC3B,OAAO,EAAE,cAAc,CAAC,QAAQ,IAAI,cAAc,CAAC,OAAO,IAAI,EAAE;oBAChE,KAAK,EAAE,cAAc,CAAC,KAAK;iBAC5B;aACF,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}

package/dist/tools/journal-entry-account/schemas.d.ts

@@ -0,0 +1,344 @@
+/**
+ * Zod schemas for JournalEntryAccount entity
+ *
+ * Chart of accounts schemas for FreshBooks API
+ */
+import { z } from 'zod';
+/**
+ * Sub-account schema (individual account in the chart)
+ */
+export declare const SubAccountSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    accountId: z.ZodNumber;
+    name: z.ZodString;
+    accountNumber: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    accountType: z.ZodString;
+    balance: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodString;
+        code: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        amount: string;
+    }, {
+        code: string;
+        amount: string;
+    }>>;
+    customName: z.ZodOptional<z.ZodString>;
+    subName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    accountId: number;
+    name: string;
+    id: number;
+    accountType: string;
+    description?: string | undefined;
+    accountNumber?: string | undefined;
+    balance?: {
+        code: string;
+        amount: string;
+    } | undefined;
+    customName?: string | undefined;
+    subName?: string | undefined;
+}, {
+    accountId: number;
+    name: string;
+    id: number;
+    accountType: string;
+    description?: string | undefined;
+    accountNumber?: string | undefined;
+    balance?: {
+        code: string;
+        amount: string;
+    } | undefined;
+    customName?: string | undefined;
+    subName?: string | undefined;
+}>;
+/**
+ * Full JournalEntryAccount (chart of accounts) schema
+ */
+export declare const JournalEntryAccountSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    accountType: z.ZodString;
+    name: z.ZodString;
+    subAccounts: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        accountId: z.ZodNumber;
+        name: z.ZodString;
+        accountNumber: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        accountType: z.ZodString;
+        balance: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>>;
+        customName: z.ZodOptional<z.ZodString>;
+        subName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: number;
+        name: string;
+        id: number;
+        accountType: string;
+        description?: string | undefined;
+        accountNumber?: string | undefined;
+        balance?: {
+            code: string;
+            amount: string;
+        } | undefined;
+        customName?: string | undefined;
+        subName?: string | undefined;
+    }, {
+        accountId: number;
+        name: string;
+        id: number;
+        accountType: string;
+        description?: string | undefined;
+        accountNumber?: string | undefined;
+        balance?: {
+            code: string;
+            amount: string;
+        } | undefined;
+        customName?: string | undefined;
+        subName?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: number;
+    accountType: string;
+    subAccounts: {
+        accountId: number;
+        name: string;
+        id: number;
+        accountType: string;
+        description?: string | undefined;
+        accountNumber?: string | undefined;
+        balance?: {
+            code: string;
+            amount: string;
+        } | undefined;
+        customName?: string | undefined;
+        subName?: string | undefined;
+    }[];
+}, {
+    name: string;
+    id: number;
+    accountType: string;
+    subAccounts: {
+        accountId: number;
+        name: string;
+        id: number;
+        accountType: string;
+        description?: string | undefined;
+        accountNumber?: string | undefined;
+        balance?: {
+            code: string;
+            amount: string;
+        } | undefined;
+        customName?: string | undefined;
+        subName?: string | undefined;
+    }[];
+}>;
+/**
+ * Input schema for listing journal entry accounts
+ */
+export declare const JournalEntryAccountListInputSchema: z.ZodObject<{
+    accountId: z.ZodString;
+    page: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    perPage: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    accountType: z.ZodOptional<z.ZodEnum<["asset", "liability", "equity", "revenue", "expense"]>>;
+}, "strip", z.ZodTypeAny, {
+    accountId: string;
+    page?: number | undefined;
+    perPage?: number | undefined;
+    accountType?: "asset" | "liability" | "equity" | "revenue" | "expense" | undefined;
+}, {
+    accountId: string;
+    page?: number | undefined;
+    perPage?: number | undefined;
+    accountType?: "asset" | "liability" | "equity" | "revenue" | "expense" | undefined;
+}>;
+/**
+ * Pagination metadata schema
+ */
+export declare const PaginationMetadataSchema: z.ZodObject<{
+    page: z.ZodNumber;
+    pages: z.ZodNumber;
+    perPage: z.ZodNumber;
+    total: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    total: number;
+    page: number;
+    perPage: number;
+    pages: number;
+}, {
+    total: number;
+    page: number;
+    perPage: number;
+    pages: number;
+}>;
+/**
+ * Output schema for journal entry account list
+ */
+export declare const JournalEntryAccountListOutputSchema: z.ZodObject<{
+    accounts: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        accountType: z.ZodString;
+        name: z.ZodString;
+        subAccounts: z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            accountId: z.ZodNumber;
+            name: z.ZodString;
+            accountNumber: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            accountType: z.ZodString;
+            balance: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodString;
+                code: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                amount: string;
+            }, {
+                code: string;
+                amount: string;
+            }>>;
+            customName: z.ZodOptional<z.ZodString>;
+            subName: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            accountId: number;
+            name: string;
+            id: number;
+            accountType: string;
+            description?: string | undefined;
+            accountNumber?: string | undefined;
+            balance?: {
+                code: string;
+                amount: string;
+            } | undefined;
+            customName?: string | undefined;
+            subName?: string | undefined;
+        }, {
+            accountId: number;
+            name: string;
+            id: number;
+            accountType: string;
+            description?: string | undefined;
+            accountNumber?: string | undefined;
+            balance?: {
+                code: string;
+                amount: string;
+            } | undefined;
+            customName?: string | undefined;
+            subName?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        id: number;
+        accountType: string;
+        subAccounts: {
+            accountId: number;
+            name: string;
+            id: number;
+            accountType: string;
+            description?: string | undefined;
+            accountNumber?: string | undefined;
+            balance?: {
+                code: string;
+                amount: string;
+            } | undefined;
+            customName?: string | undefined;
+            subName?: string | undefined;
+        }[];
+    }, {
+        name: string;
+        id: number;
+        accountType: string;
+        subAccounts: {
+            accountId: number;
+            name: string;
+            id: number;
+            accountType: string;
+            description?: string | undefined;
+            accountNumber?: string | undefined;
+            balance?: {
+                code: string;
+                amount: string;
+            } | undefined;
+            customName?: string | undefined;
+            subName?: string | undefined;
+        }[];
+    }>, "many">;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        pages: z.ZodNumber;
+        perPage: z.ZodNumber;
+        total: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        total: number;
+        page: number;
+        perPage: number;
+        pages: number;
+    }, {
+        total: number;
+        page: number;
+        perPage: number;
+        pages: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    pagination: {
+        total: number;
+        page: number;
+        perPage: number;
+        pages: number;
+    };
+    accounts: {
+        name: string;
+        id: number;
+        accountType: string;
+        subAccounts: {
+            accountId: number;
+            name: string;
+            id: number;
+            accountType: string;
+            description?: string | undefined;
+            accountNumber?: string | undefined;
+            balance?: {
+                code: string;
+                amount: string;
+            } | undefined;
+            customName?: string | undefined;
+            subName?: string | undefined;
+        }[];
+    }[];
+}, {
+    pagination: {
+        total: number;
+        page: number;
+        perPage: number;
+        pages: number;
+    };
+    accounts: {
+        name: string;
+        id: number;
+        accountType: string;
+        subAccounts: {
+            accountId: number;
+            name: string;
+            id: number;
+            accountType: string;
+            description?: string | undefined;
+            accountNumber?: string | undefined;
+            balance?: {
+                code: string;
+                amount: string;
+            } | undefined;
+            customName?: string | undefined;
+            subName?: string | undefined;
+        }[];
+    }[];
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/journal-entry-account/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/journal-entry-account/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;EAY7C,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAKnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG9C,CAAC"}

package/dist/tools/journal-entry-account/schemas.js

@@ -0,0 +1,65 @@
+/**
+ * Zod schemas for JournalEntryAccount entity
+ *
+ * Chart of accounts schemas for FreshBooks API
+ */
+import { z } from 'zod';
+/**
+ * Sub-account schema (individual account in the chart)
+ */
+export const SubAccountSchema = z.object({
+    id: z.number().describe('Sub-account ID'),
+    accountId: z.number().describe('Parent account ID'),
+    name: z.string().describe('Account name'),
+    accountNumber: z.string().optional().describe('Account number (e.g., "1000")'),
+    description: z.string().optional().describe('Account description'),
+    accountType: z.string().describe('Account type (e.g., "asset", "liability", "equity", "revenue", "expense")'),
+    balance: z.object({
+        amount: z.string().describe('Current balance amount'),
+        code: z.string().describe('Currency code'),
+    }).optional().describe('Current account balance'),
+    customName: z.string().optional().describe('Custom account name'),
+    subName: z.string().optional().describe('Sub-account name'),
+});
+/**
+ * Full JournalEntryAccount (chart of accounts) schema
+ */
+export const JournalEntryAccountSchema = z.object({
+    id: z.number().describe('Account ID'),
+    accountType: z.string().describe('Account type category'),
+    name: z.string().describe('Account name'),
+    subAccounts: z.array(SubAccountSchema).describe('Sub-accounts under this account'),
+});
+/**
+ * Input schema for listing journal entry accounts
+ */
+export const JournalEntryAccountListInputSchema = z.object({
+    accountId: z.string().describe('FreshBooks account ID'),
+    page: z.number().int().min(1).default(1).optional().describe('Page number (1-indexed)'),
+    perPage: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(30)
+        .optional()
+        .describe('Number of results per page (max 100)'),
+    accountType: z.enum(['asset', 'liability', 'equity', 'revenue', 'expense']).optional().describe('Filter by account type'),
+});
+/**
+ * Pagination metadata schema
+ */
+export const PaginationMetadataSchema = z.object({
+    page: z.number().describe('Current page number'),
+    pages: z.number().describe('Total number of pages'),
+    perPage: z.number().describe('Results per page'),
+    total: z.number().describe('Total number of results'),
+});
+/**
+ * Output schema for journal entry account list
+ */
+export const JournalEntryAccountListOutputSchema = z.object({
+    accounts: z.array(JournalEntryAccountSchema).describe('Array of chart of accounts'),
+    pagination: PaginationMetadataSchema.describe('Pagination information'),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/journal-entry-account/schemas.js.map

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

package/dist/tools/metadata.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Tool Metadata Registry
+ *
+ * Provides metadata for all tools including category classification
+ * and read-only status. This is used by the hosted server to
+ * filter tools based on user permissions.
+ */
+import { ToolCategory, ToolMetadata, CategoryMetadata } from './types.js';
+/**
+ * Registry mapping tool names to their metadata
+ */
+export declare const toolMetadataRegistry: Map<string, ToolMetadata>;
+/**
+ * Get metadata for a specific tool
+ */
+export declare function getToolMetadata(toolName: string): ToolMetadata | undefined;
+/**
+ * Check if a tool is read-only
+ */
+export declare function isToolReadOnly(toolName: string): boolean;
+/**
+ * Get all tools in a specific category
+ */
+export declare function getToolsByCategory(category: ToolCategory): ToolMetadata[];
+/**
+ * All categories with their metadata
+ */
+export declare const allCategories: CategoryMetadata[];
+/**
+ * Map of category ID to category metadata
+ */
+export declare const categoryMetadataMap: Map<ToolCategory, CategoryMetadata>;
+/**
+ * Get a summary of tool counts
+ */
+export declare function getToolCounts(): {
+    total: number;
+    readOnly: number;
+    write: number;
+};
+/**
+ * Get all read-only tool names
+ */
+export declare function getReadOnlyToolNames(): string[];
+/**
+ * Get all write tool names
+ */
+export declare function getWriteToolNames(): string[];
+//# sourceMappingURL=metadata.d.ts.map

package/dist/tools/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/tools/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAyXpB;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAE1D,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,EAAE,CAIzE;AAoBD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,gBAAgB,EAEhB,CAAC;AAE7B;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,GAAG,CAAC,YAAY,EAAE,gBAAgB,CAEnE,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAQA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAI/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAI5C"}