@codeguide/core 0.0.27 → 0.0.29

package/dist/services/usage/usage-service.js

@@ -11,6 +11,7 @@ class UsageService extends base_service_1.BaseService {
     }
     async checkCredits(params) {
         const queryParams = new URLSearchParams();
+        queryParams.append('model_key', params.model_key);
         if (params.input_tokens !== undefined)
             queryParams.append('input_tokens', params.input_tokens.toString());
         if (params.output_tokens !== undefined)
@@ -20,15 +21,6 @@ class UsageService extends base_service_1.BaseService {
         const url = `/usage/credit-check?${queryParams.toString()}`;
         return this.get(url);
     }
-    async getUsageSummary(params) {
-        const queryParams = new URLSearchParams();
-        if (params?.start_date)
-            queryParams.append('start_date', params.start_date);
-        if (params?.end_date)
-            queryParams.append('end_date', params.end_date);
-        const url = `/usage/summary${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
-        return this.get(url);
-    }
     async getAuthorization() {
         return this.get('/usage/authorization');
     }
@@ -64,5 +56,62 @@ class UsageService extends base_service_1.BaseService {
             return false;
         }
     }
+    // Dashboard Analytics Methods
+    async getDashboardAnalytics(params) {
+        const queryParams = new URLSearchParams();
+        if (params?.period)
+            queryParams.append('period', params.period);
+        if (params?.start_date)
+            queryParams.append('start_date', params.start_date);
+        if (params?.end_date)
+            queryParams.append('end_date', params.end_date);
+        if (params?.service_type)
+            queryParams.append('service_type', params.service_type);
+        const url = `/usage/dashboard/analytics${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.get(url);
+    }
+    async getUsageDetails(params) {
+        const queryParams = new URLSearchParams();
+        if (params?.period)
+            queryParams.append('period', params.period);
+        if (params?.start_date)
+            queryParams.append('start_date', params.start_date);
+        if (params?.end_date)
+            queryParams.append('end_date', params.end_date);
+        if (params?.service_type)
+            queryParams.append('service_type', params.service_type);
+        if (params?.page !== undefined)
+            queryParams.append('page', params.page.toString());
+        if (params?.page_size !== undefined)
+            queryParams.append('page_size', params.page_size.toString());
+        if (params?.sort_by)
+            queryParams.append('sort_by', params.sort_by);
+        if (params?.sort_order)
+            queryParams.append('sort_order', params.sort_order);
+        const url = `/usage/dashboard/details${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.get(url);
+    }
+    async getUsageSummary(params) {
+        const queryParams = new URLSearchParams();
+        if (params?.period)
+            queryParams.append('period', params.period);
+        if (params?.start_date)
+            queryParams.append('start_date', params.start_date);
+        if (params?.end_date)
+            queryParams.append('end_date', params.end_date);
+        const url = `/usage/dashboard/summary${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.get(url);
+    }
+    async getServiceBreakdown(params) {
+        const queryParams = new URLSearchParams();
+        if (params?.period)
+            queryParams.append('period', params.period);
+        if (params?.start_date)
+            queryParams.append('start_date', params.start_date);
+        if (params?.end_date)
+            queryParams.append('end_date', params.end_date);
+        const url = `/usage/dashboard/services${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.get(url);
+    }
 }
 exports.UsageService = UsageService;

package/dist/services/usage/usage-types.d.ts

@@ -11,7 +11,7 @@ export interface TrackUsageResponse {
     remaining_credits: number;
     message: string;
 }
-export interface CreditBalanceResponse {
+export interface CreditBalanceData {
     user_id: string;
     total_consumed: number;
     total_allotted: number;
@@ -24,6 +24,9 @@ export interface CreditBalanceResponse {
         status: string;
     };
 }
+export interface CreditBalanceResponse {
+    data: CreditBalanceData;
+}
 export interface CreditCheckRequest {
     model_key: string;
     input_tokens?: number;
@@ -36,43 +39,67 @@ export interface CreditCheckResponse {
     remaining_credits: number;
     model_key: string;
 }
-export interface UsageSummaryRequest {
-    start_date?: string;
-    end_date?: string;
+export interface CreditBalance {
+    total_allotted: number;
+    total_consumed: number;
+    remaining_credits: number;
+    is_over_limit: boolean;
+    utilization_percentage: number;
+    billing_cycle_start: string;
+    billing_cycle_end: string;
 }
-export interface UsageSummaryResponse {
-    user_id: string;
-    period: {
-        start_date: string;
-        end_date: string;
-    };
-    usage_summary: {
-        total_credits_used: number;
-        total_calls: number;
-        model_breakdown: Record<string, any>;
-        daily_usage: Array<{
-            date: string;
-            credits_used: number;
-            calls: number;
-        }>;
-    };
-    subscription: {
-        plan: string;
-        status: string;
+export interface LimitInfo {
+    allowed?: boolean;
+    current_usage?: number;
+    limit: number;
+    remaining?: number;
+    period_type?: string;
+    period_start?: string | null;
+    period_end?: string | null;
+    message?: string;
+    is_unlimited: boolean;
+    period?: string;
+    description?: string;
+}
+export interface PlanLimits {
+    plan_type: string;
+    limits: {
+        codespace_tasks: LimitInfo;
+        api_calls: LimitInfo;
+        storage_gb: LimitInfo;
+        projects: LimitInfo;
+        collaborators: LimitInfo;
     };
 }
-export interface AuthorizationResponse {
+export interface AuthorizationSubscription {
+    id: string;
+    status: string;
+    interval: string;
+    current_period_start: string;
+    current_period_end: string;
+    price_id: string;
+    product_name: string | null;
+    plan_name: string;
+}
+export interface AuthorizationData {
     user_id: string;
-    subscription: {
-        plan: string;
-        status: string;
-        features: string[];
-    };
-    usage_limits: {
-        monthly_credits: number;
-        max_calls_per_day: number;
-    };
-    permissions: string[];
+    subscription: AuthorizationSubscription | null;
+    credit_balance: CreditBalance;
+    has_active_subscription: boolean;
+    has_previous_subscriptions: boolean;
+    is_within_credit_limit: boolean;
+    authorization_level: string;
+    restrictions: string[];
+    can_create_tasks: boolean;
+    can_analyze_repos: boolean;
+    can_access_previous_projects: boolean;
+    plan_limits: PlanLimits;
+    codespace_task_limit: LimitInfo | null;
+}
+export interface AuthorizationResponse {
+    success: boolean;
+    data: AuthorizationData;
+    message: string;
 }
 export interface FreeUserStatusResponse {
     is_free_user: boolean;
@@ -131,3 +158,149 @@ export interface HealthResponse {
     timestamp: string;
     version: string;
 }
+export type PeriodType = "7d" | "1w" | "1m" | "3m";
+export type ServiceType = "docs" | "chat" | "codespace_task" | "api";
+export type SortOrder = "asc" | "desc";
+export type SortByField = "created_at" | "credits_consumed" | "cost_amount";
+export interface DashboardAnalyticsRequest {
+    period?: PeriodType;
+    start_date?: string;
+    end_date?: string;
+    service_type?: ServiceType;
+}
+export interface DailyUsage {
+    date: string;
+    credits_consumed: number;
+    cost_usd: number;
+    requests_count: number;
+    average_credits_per_request: number;
+}
+export interface ServiceUsage {
+    service_type: ServiceType;
+    credits_consumed: number;
+    requests_count: number;
+}
+export interface AnalyticsTotals {
+    credits_consumed: number;
+    cost_usd: number;
+    requests_count: number;
+}
+export interface AnalyticsAverages {
+    daily_credits: number;
+    daily_requests: number;
+}
+export interface AnalyticsTrends {
+    credits_consumed: number;
+    requests_count: number;
+}
+export interface PeriodInfo {
+    start: string;
+    end: string;
+    label: string;
+}
+export interface DashboardAnalyticsResponse {
+    status: string;
+    data: {
+        period: PeriodInfo;
+        daily_usage: DailyUsage[];
+        totals: AnalyticsTotals;
+        averages: AnalyticsAverages;
+        trends: AnalyticsTrends;
+        top_services: ServiceUsage[];
+    };
+}
+export interface UsageDetailsRequest {
+    period?: PeriodType;
+    start_date?: string;
+    end_date?: string;
+    service_type?: ServiceType;
+    page?: number;
+    page_size?: number;
+    sort_by?: SortByField;
+    sort_order?: SortOrder;
+}
+export interface UsageDetailRecord {
+    id: string;
+    created_at: string;
+    service_type: ServiceType;
+    model_name: string;
+    usage_type: string;
+    units_consumed: number;
+    credits_consumed: number;
+    cost_amount: number | null;
+}
+export interface UsageDetailsPagination {
+    page: number;
+    page_size: number;
+    total_count: number;
+    total_pages: number;
+    has_next: boolean;
+    has_prev: boolean;
+}
+export interface UsageDetailsFilters {
+    period: string | null;
+    start_date: string | null;
+    end_date: string | null;
+    service_type: string | null;
+}
+export interface UsageDetailsResponse {
+    status: string;
+    data: UsageDetailRecord[];
+    pagination: UsageDetailsPagination;
+    filters: UsageDetailsFilters;
+}
+export interface UsageSummaryRequest {
+    period?: PeriodType;
+    start_date?: string;
+    end_date?: string;
+}
+export interface CurrentPeriodUsage {
+    credits_consumed: number;
+    cost_usd: number;
+    requests_count: number;
+}
+export interface PreviousPeriodUsage {
+    credits_consumed: number;
+    cost_usd: number;
+    requests_count: number;
+}
+export interface BillingCycleInfo {
+    total_allotted: number;
+    total_consumed: number;
+    remaining_credits: number;
+}
+export interface UsageSummaryResponse {
+    status: string;
+    data: {
+        current_period: CurrentPeriodUsage;
+        previous_period: PreviousPeriodUsage;
+        billing_cycle: BillingCycleInfo;
+        utilization_percentage: number;
+        remaining_credits: number;
+        daily_average: number;
+        projected_monthly: number;
+    };
+}
+export interface ServiceBreakdownRequest {
+    period?: PeriodType;
+    start_date?: string;
+    end_date?: string;
+}
+export interface ServiceBreakdown {
+    service_type: ServiceType;
+    credits_consumed: number;
+    percentage: number;
+    cost_usd: number;
+    requests_count: number;
+    trend: number;
+}
+export interface ServiceBreakdownData {
+    period: PeriodInfo;
+    services: ServiceBreakdown[];
+    total_credits: number;
+    total_cost: number;
+}
+export interface ServiceBreakdownResponse {
+    status: string;
+    data: ServiceBreakdownData;
+}

package/dist/services/users/index.d.ts

@@ -0,0 +1,2 @@
+export { UserService } from './user-service';
+export * from './user-types';

package/dist/services/users/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserService = void 0;
+var user_service_1 = require("./user-service");
+Object.defineProperty(exports, "UserService", { enumerable: true, get: function () { return user_service_1.UserService; } });
+__exportStar(require("./user-types"), exports);

package/dist/services/users/user-service.d.ts

@@ -0,0 +1,12 @@
+import { BaseService } from '../base/base-service';
+import { GetCurrentClerkUserResponse } from './user-types';
+export declare class UserService extends BaseService {
+    /**
+     * Get the current Clerk user information
+     *
+     * GET /users/me/clerk
+     *
+     * @returns Promise resolving to the current Clerk user data
+     */
+    getCurrentClerkUser(): Promise<GetCurrentClerkUserResponse>;
+}

package/dist/services/users/user-service.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserService = void 0;
+const base_service_1 = require("../base/base-service");
+class UserService extends base_service_1.BaseService {
+    /**
+     * Get the current Clerk user information
+     *
+     * GET /users/me/clerk
+     *
+     * @returns Promise resolving to the current Clerk user data
+     */
+    async getCurrentClerkUser() {
+        return this.get('/users/me/clerk');
+    }
+}
+exports.UserService = UserService;

package/dist/services/users/user-types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Email address verification information
+ */
+export interface EmailVerification {
+    status: 'verified' | 'unverified';
+    strategy: string;
+}
+/**
+ * Email address information
+ */
+export interface EmailAddress {
+    id: string;
+    email_address: string;
+    verification: EmailVerification;
+}
+/**
+ * Clerk user metadata
+ */
+export interface ClerkUserMetadata {
+    [key: string]: any;
+}
+/**
+ * Clerk user data structure
+ */
+export interface ClerkUserData {
+    user_id: string;
+    first_name: string | null;
+    last_name: string | null;
+    username: string | null;
+    email_addresses: EmailAddress[];
+    phone_numbers: Array<{
+        id: string;
+        phone_number: string;
+        verification: {
+            status: 'verified' | 'unverified';
+            strategy: string;
+        };
+    }>;
+    primary_email_address: string | null;
+    primary_phone_number: string | null;
+    image_url: string | null;
+    created_at: number;
+    updated_at: number;
+    last_sign_in_at: number | null;
+    public_metadata: ClerkUserMetadata;
+    private_metadata: ClerkUserMetadata;
+    unsafe_metadata: ClerkUserMetadata;
+}
+/**
+ * Response for getting current Clerk user
+ */
+export interface GetCurrentClerkUserResponse {
+    status: 'success' | 'error';
+    data: ClerkUserData;
+}

package/dist/services/users/user-types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/docs/.vitepress/README.md

@@ -0,0 +1,51 @@
+# VitePress Documentation Setup
+
+This directory contains the VitePress configuration for the @codeguide/core documentation.
+
+## Structure
+
+- `config.ts` - Main VitePress configuration file (TypeScript)
+- `theme/` - Custom theme files
+  - `index.ts` - Theme entry point
+  - `custom.css` - Custom styles
+
+## Development
+
+To run the documentation locally:
+
+```bash
+cd packages/core
+npm install
+npm run docs:dev
+```
+
+Then open http://localhost:5173
+
+## Building
+
+To build the documentation for production:
+
+```bash
+npm run docs:build
+```
+
+The output will be in `packages/core/docs/.vitepress/dist`
+
+## Preview
+
+To preview the built documentation:
+
+```bash
+npm run docs:preview
+```
+
+## Configuration
+
+The main configuration is in `config.ts`. Key features:
+
+- TypeScript-based configuration
+- Sidebar navigation
+- Search functionality
+- Edit links to GitHub
+- Custom theme styling
+

package/docs/.vitepress/config.ts

@@ -0,0 +1,139 @@
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+  title: '@codeguide/core',
+  description: 'Documentation for @codeguide/core package - TypeScript SDK for CodeGuide API',
+  
+  // Server configuration
+  server: {
+    port: 5174,
+    host: true,
+  },
+  
+  // Base URL if deploying to a subdirectory
+  base: '/',
+  
+  // Theme configuration
+  themeConfig: {
+    // Logo (optional)
+    logo: '/logo.png', // You can add a logo later
+    
+    // Site title in nav
+    siteTitle: '@codeguide/core',
+    
+    // Navigation bar
+    nav: [
+      { text: 'Home', link: '/' },
+      { text: 'Getting Started', link: '/codeguide-client' },
+      { text: 'Services', link: '/projects-service' },
+      { text: 'GitHub', link: 'https://github.com/CodeGuide-dev/codeguide' },
+    ],
+    
+    // Sidebar navigation
+    sidebar: [
+      {
+        text: 'Getting Started',
+        items: [
+          { text: 'Overview', link: '/' },
+          { text: 'CodeGuide Client', link: '/codeguide-client' },
+          { text: 'Authentication', link: '/authentication' },
+        ],
+      },
+      {
+        text: 'Services',
+        items: [
+          { text: 'Projects Service', link: '/projects-service' },
+          { text: 'Codespace Service', link: '/codespace-service' },
+          { text: 'Codespace Models', link: '/codespace-models' },
+          { text: 'Security Keys Service', link: '/security-keys-service' },
+          { text: 'Usage Service', link: '/usage-service' },
+        ],
+      },
+    ],
+    
+    // Social links
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/CodeGuide-dev/codeguide' },
+    ],
+    
+    // Search configuration
+    search: {
+      provider: 'local',
+      options: {
+        locales: {
+          root: {
+            translations: {
+              button: {
+                buttonText: 'Search',
+                buttonAriaLabel: 'Search documentation',
+              },
+              modal: {
+                noResultsText: 'No results for',
+                resetButtonTitle: 'Reset search',
+                footer: {
+                  selectText: 'to select',
+                  navigateText: 'to navigate',
+                  closeText: 'to close',
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+    
+    // Footer
+    footer: {
+      message: 'Released under the MIT License.',
+      copyright: 'Copyright © 2024 CodeGuide Team',
+    },
+    
+    // Edit link
+    editLink: {
+      pattern: 'https://github.com/CodeGuide-dev/codeguide/blob/main/packages/core/docs/:path',
+      text: 'Edit this page on GitHub',
+    },
+    
+    // Carbon ads (optional - remove if not needed)
+    // carbonAds: {
+    //   code: 'your-code',
+    //   placement: 'your-placement'
+    // },
+    
+    // Last updated
+    lastUpdated: {
+      text: 'Last updated',
+    },
+    
+    // Outline configuration
+    outline: {
+      level: [2, 3],
+      label: 'On this page',
+    },
+    
+    // Doc footer (prev/next links)
+    docFooter: {
+      prev: 'Previous page',
+      next: 'Next page',
+    },
+  },
+  
+  // Markdown configuration
+  markdown: {
+    lineNumbers: true,
+    theme: {
+      light: 'github-light',
+      dark: 'github-dark',
+    },
+    // Disable Vue component parsing in markdown to avoid conflicts
+    breaks: false,
+  },
+  
+  // Head configuration
+  head: [
+    ['meta', { name: 'viewport', content: 'width=device-width, initial-scale=1.0' }],
+    ['meta', { name: 'description', content: 'Documentation for @codeguide/core package' }],
+    ['link', { rel: 'icon', href: '/favicon.ico' }],
+  ],
+})
+