@nordsym/apiclaw 1.0.0 → 1.1.1

package/convex/ratelimit.ts

@@ -0,0 +1,104 @@
+import { mutation, query } from "./_generated/server";
+import { v } from "convex/values";
+
+// Rate limit config per tier
+const LIMITS = {
+  free: {
+    discovery: 100,    // searches per hour
+    instant: 10,       // API calls per hour
+  },
+  subscriber: {
+    discovery: 1000,
+    instant: 100,
+  },
+  provider: {
+    discovery: 10000,
+    instant: 1000,
+  },
+};
+
+// Check and increment rate limit
+export const checkLimit = mutation({
+  args: {
+    identifier: v.string(),  // IP or agentId
+    action: v.union(v.literal("discovery"), v.literal("instant")),
+    tier: v.optional(v.union(v.literal("free"), v.literal("subscriber"), v.literal("provider"))),
+  },
+  handler: async (ctx, args) => {
+    const tier = args.tier || "free";
+    const limit = LIMITS[tier][args.action];
+    const hourKey = Math.floor(Date.now() / 3600000); // Hour bucket
+    const key = `${args.identifier}:${args.action}:${hourKey}`;
+
+    // Get current count
+    const existing = await ctx.db
+      .query("rateLimits")
+      .withIndex("by_key", (q) => q.eq("key", key))
+      .first();
+
+    if (existing) {
+      if (existing.count >= limit) {
+        return { allowed: false, remaining: 0, resetIn: 3600 - (Date.now() % 3600000) / 1000 };
+      }
+      await ctx.db.patch(existing._id, { count: existing.count + 1 });
+      return { allowed: true, remaining: limit - existing.count - 1 };
+    }
+
+    // Create new entry
+    await ctx.db.insert("rateLimits", {
+      key,
+      identifier: args.identifier,
+      action: args.action,
+      count: 1,
+      hourBucket: hourKey,
+      createdAt: Date.now(),
+    });
+
+    return { allowed: true, remaining: limit - 1 };
+  },
+});
+
+// Get current usage stats
+export const getUsage = query({
+  args: {
+    identifier: v.string(),
+  },
+  handler: async (ctx, args) => {
+    const hourKey = Math.floor(Date.now() / 3600000);
+    
+    const discovery = await ctx.db
+      .query("rateLimits")
+      .withIndex("by_key", (q) => q.eq("key", `${args.identifier}:discovery:${hourKey}`))
+      .first();
+
+    const instant = await ctx.db
+      .query("rateLimits")
+      .withIndex("by_key", (q) => q.eq("key", `${args.identifier}:instant:${hourKey}`))
+      .first();
+
+    return {
+      discovery: discovery?.count || 0,
+      instant: instant?.count || 0,
+      limits: LIMITS.free,
+    };
+  },
+});
+
+// Cleanup old rate limit entries (run via cron)
+export const cleanup = mutation({
+  args: {},
+  handler: async (ctx) => {
+    const hourAgo = Math.floor(Date.now() / 3600000) - 2; // Keep 2 hours
+    
+    const old = await ctx.db
+      .query("rateLimits")
+      .filter((q) => q.lt(q.field("hourBucket"), hourAgo))
+      .take(100);
+
+    for (const entry of old) {
+      await ctx.db.delete(entry._id);
+    }
+
+    return { deleted: old.length };
+  },
+});

package/convex/schema.ts

@@ -0,0 +1,220 @@
+import { defineSchema, defineTable } from "convex/server";
+import { v } from "convex/values";
+
+export default defineSchema({
+  // Credits per agent
+  agentCredits: defineTable({
+    agentId: v.string(),
+    balanceUsd: v.number(),
+    currency: v.string(),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+  }).index("by_agentId", ["agentId"]),
+
+  // Purchases (API access bought by agents)
+  purchases: defineTable({
+    agentId: v.string(),
+    providerId: v.string(),
+    amountUsd: v.number(),
+    creditsGranted: v.number(),
+    status: v.string(), // active, exhausted, refunded
+    credentials: v.optional(v.any()),
+    createdAt: v.number(),
+  })
+    .index("by_agentId", ["agentId"])
+    .index("by_providerId", ["providerId"])
+    .index("by_agentId_providerId", ["agentId", "providerId"]),
+
+  // Usage tracking per purchase
+  usage: defineTable({
+    purchaseId: v.id("purchases"),
+    providerId: v.string(),
+    unitsUsed: v.number(),
+    unitsRemaining: v.number(),
+    costIncurredUsd: v.number(),
+    lastUsedAt: v.number(),
+  })
+    .index("by_purchaseId", ["purchaseId"])
+    .index("by_providerId", ["providerId"]),
+
+  // Credit top-ups (from Stripe payments)
+  creditTopups: defineTable({
+    agentId: v.string(),
+    stripePaymentIntentId: v.optional(v.string()),
+    stripeSessionId: v.optional(v.string()),
+    amountUsd: v.number(),
+    creditsGranted: v.number(),
+    packageType: v.string(), // starter, growth, scale
+    status: v.string(), // pending, completed, failed
+    createdAt: v.number(),
+    completedAt: v.optional(v.number()),
+  })
+    .index("by_agentId", ["agentId"])
+    .index("by_stripeSessionId", ["stripeSessionId"])
+    .index("by_stripePaymentIntentId", ["stripePaymentIntentId"]),
+
+  // ============================================
+  // PROVIDER TABLES (for provider dashboard)
+  // ============================================
+
+  // API Providers (companies/individuals offering APIs)
+  providers: defineTable({
+    email: v.string(),
+    name: v.string(),
+    company: v.optional(v.string()),
+    website: v.optional(v.string()),
+    avatarUrl: v.optional(v.string()),
+    stripeConnectId: v.optional(v.string()), // for payouts
+    stripeOnboardingComplete: v.optional(v.boolean()),
+    status: v.string(), // pending, approved, rejected, suspended
+    createdAt: v.number(),
+    updatedAt: v.number(),
+    approvedAt: v.optional(v.number()),
+  })
+    .index("by_email", ["email"])
+    .index("by_stripeConnectId", ["stripeConnectId"])
+    .index("by_status", ["status"]),
+
+  // APIs listed by providers (self-service onboarding)
+  providerAPIs: defineTable({
+    providerId: v.id("providers"),
+    name: v.string(),
+    description: v.string(),
+    category: v.string(),
+    openApiUrl: v.optional(v.string()),
+    docsUrl: v.optional(v.string()),
+    pricingModel: v.string(), // free, freemium, paid
+    pricingNotes: v.optional(v.string()),
+    status: v.string(), // pending, approved, rejected, suspended
+    createdAt: v.number(),
+    approvedAt: v.optional(v.number()),
+    // Analytics
+    discoveryCount: v.optional(v.number()),
+    lastDiscoveredAt: v.optional(v.number()),
+  })
+    .index("by_providerId", ["providerId"])
+    .index("by_category", ["category"])
+    .index("by_status", ["status"])
+    .index("by_status_category", ["status", "category"]),
+
+  // APIs listed by providers (for full dashboard)
+  apis: defineTable({
+    providerId: v.id("providers"),
+    name: v.string(),
+    description: v.string(),
+    category: v.string(),
+    icon: v.optional(v.string()), // emoji or URL
+    baseUrl: v.string(),
+    docsUrl: v.optional(v.string()),
+    authType: v.string(), // api_key, oauth, basic, bearer
+    pricingModel: v.string(), // free, per_call, monthly, credits
+    pricePerCall: v.optional(v.number()), // in USD cents
+    monthlyPrice: v.optional(v.number()), // in USD cents
+    rateLimitPerMinute: v.optional(v.number()),
+    regions: v.optional(v.array(v.string())),
+    tags: v.optional(v.array(v.string())),
+    status: v.string(), // active, paused, pending_review
+    isPublic: v.boolean(),
+    // Credentials (encrypted in production)
+    credentialTemplate: v.optional(v.any()),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+  })
+    .index("by_providerId", ["providerId"])
+    .index("by_category", ["category"])
+    .index("by_status", ["status"]),
+
+  // API Calls / Usage logs (for analytics)
+  apiCalls: defineTable({
+    apiId: v.id("apis"),
+    providerId: v.id("providers"),
+    agentId: v.string(),
+    endpoint: v.optional(v.string()),
+    method: v.optional(v.string()),
+    statusCode: v.optional(v.number()),
+    latencyMs: v.optional(v.number()),
+    costUsd: v.number(), // cost in USD (fractional)
+    region: v.optional(v.string()),
+    timestamp: v.number(),
+  })
+    .index("by_apiId", ["apiId"])
+    .index("by_providerId", ["providerId"])
+    .index("by_agentId", ["agentId"])
+    .index("by_timestamp", ["timestamp"])
+    .index("by_providerId_timestamp", ["providerId", "timestamp"]),
+
+  // Provider Payouts
+  payouts: defineTable({
+    providerId: v.id("providers"),
+    amountUsd: v.number(),
+    status: v.string(), // pending, processing, completed, failed
+    stripePayoutId: v.optional(v.string()),
+    periodStart: v.number(),
+    periodEnd: v.number(),
+    createdAt: v.number(),
+    completedAt: v.optional(v.number()),
+  })
+    .index("by_providerId", ["providerId"])
+    .index("by_status", ["status"]),
+
+  // Magic link tokens for email auth
+  magicLinks: defineTable({
+    email: v.string(),
+    token: v.string(),
+    expiresAt: v.number(),
+    usedAt: v.optional(v.number()),
+    createdAt: v.number(),
+  })
+    .index("by_token", ["token"])
+    .index("by_email", ["email"]),
+
+  // Sessions for authenticated providers
+  sessions: defineTable({
+    providerId: v.id("providers"),
+    token: v.string(),
+    expiresAt: v.number(),
+    createdAt: v.number(),
+  })
+    .index("by_token", ["token"])
+    .index("by_providerId", ["providerId"]),
+
+  // Rate limiting
+  rateLimits: defineTable({
+    key: v.string(),
+    identifier: v.string(),
+    action: v.string(),
+    count: v.number(),
+    hourBucket: v.number(),
+    createdAt: v.number(),
+  })
+    .index("by_key", ["key"])
+    .index("by_identifier", ["identifier"]),
+
+  // Usage analytics
+  analytics: defineTable({
+    event: v.string(),  // "discovery", "instant", "search_query"
+    provider: v.optional(v.string()),
+    query: v.optional(v.string()),
+    identifier: v.string(),
+    metadata: v.optional(v.any()),
+    timestamp: v.number(),
+  })
+    .index("by_event", ["event"])
+    .index("by_timestamp", ["timestamp"])
+    .index("by_provider", ["provider"]),
+
+  // MCP Server telemetry (anonymous usage tracking)
+  telemetry: defineTable({
+    type: v.string(),  // "startup", "search", "execute", "discovery"
+    query: v.optional(v.string()),
+    apiId: v.optional(v.string()),
+    resultCount: v.optional(v.number()),
+    responseTimeMs: v.optional(v.number()),
+    version: v.string(),
+    platform: v.string(),
+    nodeVersion: v.string(),
+    timestamp: v.number(),
+  })
+    .index("by_type", ["type"])
+    .index("by_timestamp", ["timestamp"]),
+});

package/convex/telemetry.ts

@@ -0,0 +1,81 @@
+import { mutation, query } from "./_generated/server";
+import { v } from "convex/values";
+
+export const track = mutation({
+  args: {
+    event: v.object({
+      type: v.string(),
+      query: v.optional(v.string()),
+      apiId: v.optional(v.string()),
+      resultCount: v.optional(v.number()),
+      responseTimeMs: v.optional(v.number()),
+      version: v.optional(v.string()),
+      platform: v.optional(v.string()),
+      nodeVersion: v.optional(v.string()),
+      timestamp: v.optional(v.number()),
+    }),
+  },
+  handler: async (ctx, { event }) => {
+    await ctx.db.insert("telemetry", {
+      type: event.type,
+      query: event.query,
+      apiId: event.apiId,
+      resultCount: event.resultCount,
+      responseTimeMs: event.responseTimeMs,
+      version: event.version || "unknown",
+      platform: event.platform || "unknown",
+      nodeVersion: event.nodeVersion || "unknown",
+      timestamp: event.timestamp || Date.now(),
+    });
+  },
+});
+
+export const getStats = query({
+  args: {},
+  handler: async (ctx) => {
+    const events = await ctx.db.query("telemetry").collect();
+    
+    const startups = events.filter(e => e.type === "startup").length;
+    const searches = events.filter(e => e.type === "search").length;
+    const executes = events.filter(e => e.type === "execute").length;
+    
+    const uniqueUsers = new Set(events.map(e => `${e.platform}-${e.nodeVersion}`)).size;
+    
+    const topQueries = events
+      .filter(e => e.type === "search" && e.query)
+      .reduce((acc, e) => {
+        acc[e.query!] = (acc[e.query!] || 0) + 1;
+        return acc;
+      }, {} as Record<string, number>);
+    
+    const topAPIs = events
+      .filter(e => e.type === "execute" && e.apiId)
+      .reduce((acc, e) => {
+        acc[e.apiId!] = (acc[e.apiId!] || 0) + 1;
+        return acc;
+      }, {} as Record<string, number>);
+    
+    return {
+      totalStartups: startups,
+      totalSearches: searches,
+      totalExecutes: executes,
+      estimatedUniqueUsers: uniqueUsers,
+      topQueries: Object.entries(topQueries)
+        .sort(([,a], [,b]) => b - a)
+        .slice(0, 10),
+      topAPIs: Object.entries(topAPIs)
+        .sort(([,a], [,b]) => b - a)
+        .slice(0, 10),
+    };
+  },
+});
+
+export const getRecent = query({
+  args: { limit: v.optional(v.number()) },
+  handler: async (ctx, { limit = 50 }) => {
+    return await ctx.db
+      .query("telemetry")
+      .order("desc")
+      .take(limit);
+  },
+});

package/convex.json

@@ -0,0 +1,3 @@
+{
+  "functions": "convex/"
+}

package/dist/credentials.d.ts

@@ -0,0 +1,19 @@
+import { APICredentials } from './types.js';
+/**
+ * Get real credentials for a provider
+ * Returns null if provider not supported
+ */
+export declare function getCredentials(providerId: string): APICredentials | null;
+/**
+ * Check if a provider has real (non-demo) credentials available
+ */
+export declare function hasRealCredentials(providerId: string): boolean;
+/**
+ * List all supported providers
+ */
+export declare function listProviders(): string[];
+/**
+ * Get credential type for a provider
+ */
+export declare function getCredentialType(providerId: string): string | null;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqH5C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAIxE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CA0B9D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEnE"}

package/dist/credentials.js

@@ -0,0 +1,158 @@
+// Real credential providers for APIClaw Connected tier
+// Reads from environment variables or ~/.secrets/
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+// Load env file helper
+function loadEnvFile(filename) {
+    const paths = [
+        join(homedir(), '.secrets', filename),
+        join(process.cwd(), filename),
+        join(process.cwd(), '.env.local'),
+    ];
+    for (const path of paths) {
+        if (existsSync(path)) {
+            const content = readFileSync(path, 'utf-8');
+            const vars = {};
+            for (const line of content.split('\n')) {
+                const match = line.match(/^([^=]+)=(.*)$/);
+                if (match) {
+                    vars[match[1].trim()] = match[2].trim().replace(/^["']|["']$/g, '');
+                }
+            }
+            return vars;
+        }
+    }
+    return {};
+}
+// Provider credential getters
+const providers = {
+    '46elks': {
+        type: 'basic',
+        get() {
+            const env = loadEnvFile('46elks.env');
+            const user = env.ELKS_API_USER || process.env.ELKS_API_USER;
+            const pass = env.ELKS_API_PASSWORD || process.env.ELKS_API_PASSWORD;
+            if (!user || !pass)
+                return null;
+            return {
+                type: 'basic',
+                username: user,
+                password: pass,
+            };
+        },
+    },
+    twilio: {
+        type: 'basic',
+        get() {
+            const env = loadEnvFile('twilio.env');
+            const sid = env.TWILIO_ACCOUNT_SID || process.env.TWILIO_ACCOUNT_SID;
+            const token = env.TWILIO_AUTH_TOKEN || process.env.TWILIO_AUTH_TOKEN;
+            if (!sid || !token)
+                return null;
+            return {
+                type: 'basic',
+                username: sid,
+                password: token,
+            };
+        },
+    },
+    // Real credential providers
+    resend: {
+        type: 'api_key',
+        get() {
+            const env = loadEnvFile('resend.env');
+            const key = env.RESEND_API_KEY || process.env.RESEND_API_KEY;
+            if (key) {
+                return { type: 'api_key', api_key: key };
+            }
+            return null;
+        },
+    },
+    brave_search: {
+        type: 'api_key',
+        get() {
+            const env = loadEnvFile('brave.env');
+            const key = env.BRAVE_API_KEY || process.env.BRAVE_API_KEY;
+            if (key) {
+                return { type: 'api_key', api_key: key };
+            }
+            return null;
+        },
+    },
+    openrouter: {
+        type: 'bearer',
+        get() {
+            const env = loadEnvFile('openrouter.env');
+            const key = env.OPENROUTER_API_KEY || process.env.OPENROUTER_API_KEY;
+            if (key) {
+                return { type: 'bearer', api_key: key };
+            }
+            return null;
+        },
+    },
+    elevenlabs: {
+        type: 'api_key',
+        get() {
+            const env = loadEnvFile('elevenlabs.env');
+            const key = env.ELEVENLABS_API_KEY || process.env.ELEVENLABS_API_KEY;
+            if (key) {
+                return { type: 'api_key', api_key: key };
+            }
+            return null;
+        },
+    },
+};
+/**
+ * Get real credentials for a provider
+ * Returns null if provider not supported
+ */
+export function getCredentials(providerId) {
+    const provider = providers[providerId];
+    if (!provider)
+        return null;
+    return provider.get();
+}
+/**
+ * Check if a provider has real (non-demo) credentials available
+ */
+export function hasRealCredentials(providerId) {
+    if (providerId === '46elks') {
+        const env = loadEnvFile('46elks.env');
+        return !!(env.ELKS_API_USER || process.env.ELKS_API_USER);
+    }
+    if (providerId === 'twilio') {
+        const env = loadEnvFile('twilio.env');
+        return !!(env.TWILIO_ACCOUNT_SID || process.env.TWILIO_ACCOUNT_SID);
+    }
+    if (providerId === 'resend') {
+        const env = loadEnvFile('resend.env');
+        return !!(env.RESEND_API_KEY || process.env.RESEND_API_KEY);
+    }
+    if (providerId === 'brave_search') {
+        const env = loadEnvFile('brave.env');
+        return !!(env.BRAVE_API_KEY || process.env.BRAVE_API_KEY);
+    }
+    if (providerId === 'openrouter') {
+        const env = loadEnvFile('openrouter.env');
+        return !!(env.OPENROUTER_API_KEY || process.env.OPENROUTER_API_KEY);
+    }
+    if (providerId === 'elevenlabs') {
+        const env = loadEnvFile('elevenlabs.env');
+        return !!(env.ELEVENLABS_API_KEY || process.env.ELEVENLABS_API_KEY);
+    }
+    return false;
+}
+/**
+ * List all supported providers
+ */
+export function listProviders() {
+    return Object.keys(providers);
+}
+/**
+ * Get credential type for a provider
+ */
+export function getCredentialType(providerId) {
+    return providers[providerId]?.type || null;
+}
+//# sourceMappingURL=credentials.js.map

package/dist/credentials.js.map

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

package/dist/credits.d.ts

@@ -1,4 +1,5 @@
-import { AgentCredits, Purchase, UsageRecord, TransactionFee } from './types.js';
+import { AgentCredits, Purchase, UsageRecord } from './types.js';
+type StorageBackend = 'memory' | 'convex';
 /**
  * Get or create agent credits account
  */
@@ -9,7 +10,7 @@ export declare function getAgentCredits(agentId: string): AgentCredits;
 export declare function addCredits(agentId: string, amountUsd: number): AgentCredits;
 /**
  * Purchase API access
- * Returns credentials if successful
+ * Returns real credentials for 46elks and Twilio
  */
 export declare function purchaseAPIAccess(agentId: string, providerId: string, amountUsd: number): {
     success: boolean;
@@ -35,20 +36,22 @@ export declare function getBalanceSummary(agentId: string): {
     credits: AgentCredits;
     active_purchases: Purchase[];
     total_spent_usd: number;
+    real_credentials_available: string[];
 };
 /**
- * Calculate transaction fee based on user's subscription
- * Pro users: 2% fee
- * Free users: 5% fee
+ * Check which providers have real credentials
  */
-export declare function calculateTransactionFee(userId: string, amountUsd: number): Promise<TransactionFee>;
-/**
- * Purchase API access with subscription-aware fees
- */
-export declare function purchaseAPIAccessWithFees(agentId: string, userId: string, providerId: string, amountUsd: number): Promise<{
+export declare function getProvidersWithRealCredentials(): string[];
+export declare function getAgentCreditsAsync(agentId: string): Promise<AgentCredits | null>;
+export declare function addCreditsAsync(agentId: string, amountUsd: number): Promise<AgentCredits | null>;
+export declare function purchaseAPIAccessAsync(agentId: string, providerId: string, amountUsd: number): Promise<{
     success: boolean;
     purchase?: Purchase;
-    fee?: TransactionFee;
     error?: string;
 }>;
+export declare function getBackendInfo(): {
+    type: StorageBackend;
+    convexUrl: string | null;
+};
+export {};
 //# sourceMappingURL=credits.d.ts.map

package/dist/credits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credits.d.ts","sourceRoot":"","sources":["../src/credits.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAkB,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAkCjG;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAW7D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAK3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAiD3D;AAkBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CAE7D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAE/D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAgBtG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG;IAClD,OAAO,EAAE,YAAY,CAAC;IACtB,gBAAgB,EAAE,QAAQ,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;CACzB,CAWA;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC,CAYzB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAC,CAgCD"}
+{"version":3,"file":"credits.d.ts","sourceRoot":"","sources":["../src/credits.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAkB,WAAW,EAAE,MAAM,YAAY,CAAC;AAKjF,KAAK,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAwD1C;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAW7D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAK3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAyD3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CAE7D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAE/D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAgBtG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG;IAClD,OAAO,EAAE,YAAY,CAAC;IACtB,gBAAgB,EAAE,QAAQ,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,0BAA0B,EAAE,MAAM,EAAE,CAAC;CACtC,CAeA;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,MAAM,EAAE,CAE1D;AAwDD,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAOxF;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAOtG;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBpE;AAGD,wBAAgB,cAAc,IAAI;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAKnF"}