@jam-nodes/nodes 0.1.2 → 0.2.0

package/dist/integrations/apollo/search-contacts.d.ts

@@ -0,0 +1,158 @@
+import { z } from 'zod';
+export declare const SearchContactsInputSchema: z.ZodObject<{
+    /** Job titles to search for */
+    personTitles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Person locations (cities/countries) */
+    personLocations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Organization locations */
+    organizationLocations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Company employee count ranges (e.g., "1-10", "11-50") */
+    employeeRanges: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Keywords for search */
+    keywords: z.ZodOptional<z.ZodString>;
+    /** Maximum number of contacts to return */
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /** Include similar job titles */
+    includeSimilarTitles: z.ZodOptional<z.ZodBoolean>;
+    /** Seniority levels (e.g., "vp", "director", "manager") */
+    personSeniorities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Technologies used by the company */
+    technologies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Industry tag IDs */
+    industryTagIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Departments (e.g., "engineering", "sales") */
+    departments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    keywords?: string | undefined;
+    personTitles?: string[] | undefined;
+    personLocations?: string[] | undefined;
+    organizationLocations?: string[] | undefined;
+    employeeRanges?: string[] | undefined;
+    includeSimilarTitles?: boolean | undefined;
+    personSeniorities?: string[] | undefined;
+    technologies?: string[] | undefined;
+    industryTagIds?: string[] | undefined;
+    departments?: string[] | undefined;
+}, {
+    keywords?: string | undefined;
+    limit?: number | undefined;
+    personTitles?: string[] | undefined;
+    personLocations?: string[] | undefined;
+    organizationLocations?: string[] | undefined;
+    employeeRanges?: string[] | undefined;
+    includeSimilarTitles?: boolean | undefined;
+    personSeniorities?: string[] | undefined;
+    technologies?: string[] | undefined;
+    industryTagIds?: string[] | undefined;
+    departments?: string[] | undefined;
+}>;
+export type SearchContactsInput = z.infer<typeof SearchContactsInputSchema>;
+export declare const SearchContactsOutputSchema: z.ZodObject<{
+    contacts: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        firstName: z.ZodOptional<z.ZodString>;
+        lastName: z.ZodOptional<z.ZodString>;
+        email: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        company: z.ZodString;
+        linkedinUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        location: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        company: string;
+        name: string;
+        email: string;
+        title?: string | undefined;
+        firstName?: string | undefined;
+        lastName?: string | undefined;
+        linkedinUrl?: string | null | undefined;
+        location?: string | null | undefined;
+    }, {
+        id: string;
+        company: string;
+        name: string;
+        email: string;
+        title?: string | undefined;
+        firstName?: string | undefined;
+        lastName?: string | undefined;
+        linkedinUrl?: string | null | undefined;
+        location?: string | null | undefined;
+    }>, "many">;
+    totalFound: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    totalFound: number;
+    contacts: {
+        id: string;
+        company: string;
+        name: string;
+        email: string;
+        title?: string | undefined;
+        firstName?: string | undefined;
+        lastName?: string | undefined;
+        linkedinUrl?: string | null | undefined;
+        location?: string | null | undefined;
+    }[];
+}, {
+    totalFound: number;
+    contacts: {
+        id: string;
+        company: string;
+        name: string;
+        email: string;
+        title?: string | undefined;
+        firstName?: string | undefined;
+        lastName?: string | undefined;
+        linkedinUrl?: string | null | undefined;
+        location?: string | null | undefined;
+    }[];
+}>;
+export type SearchContactsOutput = z.infer<typeof SearchContactsOutputSchema>;
+/**
+ * Search Contacts Node
+ *
+ * Searches for contacts using Apollo.io API with email enrichment.
+ * Requires `context.services.apollo` to be provided by the host application.
+ *
+ * Process:
+ * 1. Search Apollo for contacts matching criteria
+ * 2. Enrich contacts to reveal email addresses
+ * 3. Return contacts with verified emails
+ *
+ * @example
+ * ```typescript
+ * const result = await searchContactsNode.executor({
+ *   personTitles: ['CTO', 'VP Engineering'],
+ *   personLocations: ['San Francisco'],
+ *   limit: 25
+ * }, context);
+ * ```
+ */
+export declare const searchContactsNode: import("@jam-nodes/core").NodeDefinition<{
+    keywords?: string | undefined;
+    limit?: number | undefined;
+    personTitles?: string[] | undefined;
+    personLocations?: string[] | undefined;
+    organizationLocations?: string[] | undefined;
+    employeeRanges?: string[] | undefined;
+    includeSimilarTitles?: boolean | undefined;
+    personSeniorities?: string[] | undefined;
+    technologies?: string[] | undefined;
+    industryTagIds?: string[] | undefined;
+    departments?: string[] | undefined;
+}, {
+    totalFound: number;
+    contacts: {
+        id: string;
+        company: string;
+        name: string;
+        email: string;
+        title?: string | undefined;
+        firstName?: string | undefined;
+        lastName?: string | undefined;
+        linkedinUrl?: string | null | undefined;
+        location?: string | null | undefined;
+    }[];
+}>;
+//# sourceMappingURL=search-contacts.d.ts.map

package/dist/integrations/apollo/search-contacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-contacts.d.ts","sourceRoot":"","sources":["../../../src/integrations/apollo/search-contacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,yBAAyB;IACpC,+BAA+B;;IAE/B,0CAA0C;;IAE1C,6BAA6B;;IAE7B,4DAA4D;;IAE5D,0BAA0B;;IAE1B,2CAA2C;;IAE3C,iCAAiC;;IAEjC,2DAA2D;;IAE3D,uCAAuC;;IAEvC,uBAAuB;;IAEvB,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;EAEjD,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAarC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;EA4G7B,CAAC"}

package/dist/integrations/apollo/search-contacts.js

@@ -0,0 +1,161 @@
+import { z } from 'zod';
+import { defineNode } from '@jam-nodes/core';
+// =============================================================================
+// Schemas
+// =============================================================================
+export const SearchContactsInputSchema = z.object({
+    /** Job titles to search for */
+    personTitles: z.array(z.string()).optional(),
+    /** Person locations (cities/countries) */
+    personLocations: z.array(z.string()).optional(),
+    /** Organization locations */
+    organizationLocations: z.array(z.string()).optional(),
+    /** Company employee count ranges (e.g., "1-10", "11-50") */
+    employeeRanges: z.array(z.string()).optional(),
+    /** Keywords for search */
+    keywords: z.string().optional(),
+    /** Maximum number of contacts to return */
+    limit: z.number().optional().default(10),
+    /** Include similar job titles */
+    includeSimilarTitles: z.boolean().optional(),
+    /** Seniority levels (e.g., "vp", "director", "manager") */
+    personSeniorities: z.array(z.string()).optional(),
+    /** Technologies used by the company */
+    technologies: z.array(z.string()).optional(),
+    /** Industry tag IDs */
+    industryTagIds: z.array(z.string()).optional(),
+    /** Departments (e.g., "engineering", "sales") */
+    departments: z.array(z.string()).optional(),
+});
+export const SearchContactsOutputSchema = z.object({
+    contacts: z.array(z.object({
+        id: z.string(),
+        name: z.string(),
+        firstName: z.string().optional(),
+        lastName: z.string().optional(),
+        email: z.string(),
+        title: z.string().optional(),
+        company: z.string(),
+        linkedinUrl: z.string().nullable().optional(),
+        location: z.string().nullable().optional(),
+    })),
+    totalFound: z.number(),
+});
+// =============================================================================
+// Node Definition
+// =============================================================================
+/**
+ * Search Contacts Node
+ *
+ * Searches for contacts using Apollo.io API with email enrichment.
+ * Requires `context.services.apollo` to be provided by the host application.
+ *
+ * Process:
+ * 1. Search Apollo for contacts matching criteria
+ * 2. Enrich contacts to reveal email addresses
+ * 3. Return contacts with verified emails
+ *
+ * @example
+ * ```typescript
+ * const result = await searchContactsNode.executor({
+ *   personTitles: ['CTO', 'VP Engineering'],
+ *   personLocations: ['San Francisco'],
+ *   limit: 25
+ * }, context);
+ * ```
+ */
+export const searchContactsNode = defineNode({
+    type: 'search_contacts',
+    name: 'Search Contacts',
+    description: 'Search for contacts using Apollo.io People Search API',
+    category: 'integration',
+    inputSchema: SearchContactsInputSchema,
+    outputSchema: SearchContactsOutputSchema,
+    estimatedDuration: 5,
+    capabilities: {
+        supportsEnrichment: true,
+        supportsBulkActions: true,
+        supportsRerun: true,
+    },
+    executor: async (input, context) => {
+        try {
+            // Require Apollo service
+            if (!context.services?.apollo) {
+                return {
+                    success: false,
+                    error: 'Apollo service not configured. Please provide context.services.apollo.',
+                };
+            }
+            // Search contacts
+            const results = await context.services.apollo.searchContacts({
+                personTitles: input.personTitles,
+                personLocations: input.personLocations,
+                organizationLocations: input.organizationLocations,
+                keywords: input.keywords,
+                limit: Math.min(input.limit || 10, 100),
+                personSeniorities: input.personSeniorities,
+                technologies: input.technologies,
+            });
+            if (results.length === 0) {
+                return {
+                    success: true,
+                    output: {
+                        contacts: [],
+                        totalFound: 0,
+                    },
+                };
+            }
+            // Enrich contacts to get emails
+            const enrichedContacts = [];
+            for (const contact of results) {
+                if (contact.id) {
+                    try {
+                        const enriched = await context.services.apollo.enrichContact(contact.id);
+                        if (enriched.email) {
+                            enrichedContacts.push({
+                                id: enriched.id,
+                                name: enriched.name,
+                                firstName: enriched.firstName,
+                                lastName: enriched.lastName,
+                                email: enriched.email,
+                                title: enriched.title,
+                                company: enriched.company,
+                                linkedinUrl: enriched.linkedinUrl,
+                                location: enriched.location,
+                            });
+                        }
+                    }
+                    catch {
+                        // Skip contacts that fail to enrich
+                    }
+                }
+            }
+            // Transform to output format
+            const contacts = enrichedContacts.map(person => ({
+                id: person.id,
+                name: person.name,
+                firstName: person.firstName,
+                lastName: person.lastName,
+                email: person.email,
+                title: person.title,
+                company: person.company || 'Unknown',
+                linkedinUrl: person.linkedinUrl || null,
+                location: person.location || null,
+            }));
+            return {
+                success: true,
+                output: {
+                    contacts,
+                    totalFound: results.length,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Failed to search contacts',
+            };
+        }
+    },
+});
+//# sourceMappingURL=search-contacts.js.map

package/dist/integrations/apollo/search-contacts.js.map

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

package/dist/integrations/dataforseo/index.d.ts

@@ -0,0 +1,3 @@
+export { seoKeywordResearchNode, SeoKeywordResearchInputSchema, SeoKeywordResearchOutputSchema, type SeoKeywordResearchInput, type SeoKeywordResearchOutput, } from './keyword-research';
+export { seoAuditNode, SeoAuditInputSchema, SeoAuditOutputSchema, type SeoAuditInput, type SeoAuditOutput, type SeoIssue, } from './seo-audit';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/dataforseo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/dataforseo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,8BAA8B,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,QAAQ,GACd,MAAM,aAAa,CAAC"}

package/dist/integrations/dataforseo/index.js

@@ -0,0 +1,3 @@
+export { seoKeywordResearchNode, SeoKeywordResearchInputSchema, SeoKeywordResearchOutputSchema, } from './keyword-research';
+export { seoAuditNode, SeoAuditInputSchema, SeoAuditOutputSchema, } from './seo-audit';
+//# sourceMappingURL=index.js.map

package/dist/integrations/dataforseo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/dataforseo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,8BAA8B,GAG/B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,GAIrB,MAAM,aAAa,CAAC"}

package/dist/integrations/dataforseo/keyword-research.d.ts

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+export declare const SeoKeywordResearchInputSchema: z.ZodObject<{
+    /** Seed keywords to research */
+    seedKeywords: z.ZodArray<z.ZodString, "many">;
+    /** Location code (default: 2840 = US) */
+    locationCode: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /** Language code (default: 'en') */
+    languageCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** Maximum keywords to return per seed */
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    seedKeywords: string[];
+    locationCode: number;
+    languageCode: string;
+}, {
+    seedKeywords: string[];
+    limit?: number | undefined;
+    locationCode?: number | undefined;
+    languageCode?: string | undefined;
+}>;
+export type SeoKeywordResearchInput = z.infer<typeof SeoKeywordResearchInputSchema>;
+export declare const SeoKeywordResearchOutputSchema: z.ZodObject<{
+    keywords: z.ZodArray<z.ZodObject<{
+        keyword: z.ZodString;
+        searchVolume: z.ZodNumber;
+        keywordDifficulty: z.ZodNumber;
+        cpc: z.ZodString;
+        searchIntent: z.ZodEnum<["informational", "commercial", "navigational", "transactional"]>;
+    }, "strip", z.ZodTypeAny, {
+        keyword: string;
+        searchVolume: number;
+        keywordDifficulty: number;
+        cpc: string;
+        searchIntent: "informational" | "commercial" | "navigational" | "transactional";
+    }, {
+        keyword: string;
+        searchVolume: number;
+        keywordDifficulty: number;
+        cpc: string;
+        searchIntent: "informational" | "commercial" | "navigational" | "transactional";
+    }>, "many">;
+    totalResearched: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    keywords: {
+        keyword: string;
+        searchVolume: number;
+        keywordDifficulty: number;
+        cpc: string;
+        searchIntent: "informational" | "commercial" | "navigational" | "transactional";
+    }[];
+    totalResearched: number;
+}, {
+    keywords: {
+        keyword: string;
+        searchVolume: number;
+        keywordDifficulty: number;
+        cpc: string;
+        searchIntent: "informational" | "commercial" | "navigational" | "transactional";
+    }[];
+    totalResearched: number;
+}>;
+export type SeoKeywordResearchOutput = z.infer<typeof SeoKeywordResearchOutputSchema>;
+/**
+ * SEO Keyword Research Node
+ *
+ * Takes seed keywords and enriches them with search volume, keyword difficulty,
+ * CPC, and search intent data using DataForSEO API.
+ *
+ * Requires `context.services.dataForSeo` to be provided by the host application.
+ *
+ * @example
+ * ```typescript
+ * const result = await seoKeywordResearchNode.executor({
+ *   seedKeywords: ['typescript tutorial', 'nodejs best practices'],
+ *   locationCode: 2840, // US
+ *   limit: 20
+ * }, context);
+ * ```
+ */
+export declare const seoKeywordResearchNode: import("@jam-nodes/core").NodeDefinition<{
+    seedKeywords: string[];
+    limit?: number | undefined;
+    locationCode?: number | undefined;
+    languageCode?: string | undefined;
+}, {
+    keywords: {
+        keyword: string;
+        searchVolume: number;
+        keywordDifficulty: number;
+        cpc: string;
+        searchIntent: "informational" | "commercial" | "navigational" | "transactional";
+    }[];
+    totalResearched: number;
+}>;
+//# sourceMappingURL=keyword-research.d.ts.map

package/dist/integrations/dataforseo/keyword-research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-research.d.ts","sourceRoot":"","sources":["../../../src/integrations/dataforseo/keyword-research.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,6BAA6B;IACxC,gCAAgC;;IAEhC,yCAAyC;;IAEzC,oCAAoC;;IAEpC,0CAA0C;;;;;;;;;;;;EAE1C,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAMtF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;EA2EjC,CAAC"}

package/dist/integrations/dataforseo/keyword-research.js

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+import { defineNode } from '@jam-nodes/core';
+// =============================================================================
+// Schemas
+// =============================================================================
+export const SeoKeywordResearchInputSchema = z.object({
+    /** Seed keywords to research */
+    seedKeywords: z.array(z.string()),
+    /** Location code (default: 2840 = US) */
+    locationCode: z.number().optional().default(2840),
+    /** Language code (default: 'en') */
+    languageCode: z.string().optional().default('en'),
+    /** Maximum keywords to return per seed */
+    limit: z.number().optional().default(30),
+});
+export const SeoKeywordResearchOutputSchema = z.object({
+    keywords: z.array(z.object({
+        keyword: z.string(),
+        searchVolume: z.number(),
+        keywordDifficulty: z.number(),
+        cpc: z.string(),
+        searchIntent: z.enum(['informational', 'commercial', 'navigational', 'transactional']),
+    })),
+    totalResearched: z.number(),
+});
+// =============================================================================
+// Node Definition
+// =============================================================================
+/**
+ * SEO Keyword Research Node
+ *
+ * Takes seed keywords and enriches them with search volume, keyword difficulty,
+ * CPC, and search intent data using DataForSEO API.
+ *
+ * Requires `context.services.dataForSeo` to be provided by the host application.
+ *
+ * @example
+ * ```typescript
+ * const result = await seoKeywordResearchNode.executor({
+ *   seedKeywords: ['typescript tutorial', 'nodejs best practices'],
+ *   locationCode: 2840, // US
+ *   limit: 20
+ * }, context);
+ * ```
+ */
+export const seoKeywordResearchNode = defineNode({
+    type: 'seo_keyword_research',
+    name: 'Keyword Research',
+    description: 'Research keywords to get search volume, difficulty, and intent data',
+    category: 'integration',
+    inputSchema: SeoKeywordResearchInputSchema,
+    outputSchema: SeoKeywordResearchOutputSchema,
+    estimatedDuration: 10,
+    capabilities: {
+        supportsRerun: true,
+    },
+    executor: async (input, context) => {
+        try {
+            // Require DataForSEO service
+            if (!context.services?.dataForSeo) {
+                return {
+                    success: false,
+                    error: 'DataForSEO service not configured. Please provide context.services.dataForSeo.',
+                };
+            }
+            const researchedKeywords = [];
+            const processedKeywords = new Set();
+            // Research each seed keyword
+            for (const seedKeyword of input.seedKeywords) {
+                if (!seedKeyword.trim())
+                    continue;
+                try {
+                    const results = await context.services.dataForSeo.getRelatedKeywords([seedKeyword], {
+                        locationCode: input.locationCode ?? 2840,
+                        languageCode: input.languageCode ?? 'en',
+                        limit: input.limit ?? 30,
+                    });
+                    for (const kw of results) {
+                        // Skip duplicates
+                        if (processedKeywords.has(kw.keyword.toLowerCase()))
+                            continue;
+                        processedKeywords.add(kw.keyword.toLowerCase());
+                        researchedKeywords.push({
+                            keyword: kw.keyword,
+                            searchVolume: kw.searchVolume,
+                            keywordDifficulty: kw.keywordDifficulty,
+                            cpc: kw.cpc.toString(),
+                            searchIntent: kw.searchIntent,
+                        });
+                    }
+                }
+                catch (kwError) {
+                    // Continue with other keywords on individual failures
+                    console.warn(`Error researching keyword "${seedKeyword}":`, kwError);
+                }
+            }
+            // Sort by search volume descending
+            researchedKeywords.sort((a, b) => b.searchVolume - a.searchVolume);
+            return {
+                success: true,
+                output: {
+                    keywords: researchedKeywords,
+                    totalResearched: researchedKeywords.length,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Failed to research keywords',
+            };
+        }
+    },
+});
+//# sourceMappingURL=keyword-research.js.map

package/dist/integrations/dataforseo/keyword-research.js.map

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