@nextsparkjs/core 0.1.0-beta.74 → 0.1.0-beta.76

package/dist/lib/services/route-handler.service.d.ts

@@ -0,0 +1,155 @@
+/**
+ * RouteHandlerService
+ *
+ * Service layer for route handler queries.
+ * Provides O(1) lookups for theme and plugin route handlers.
+ *
+ * @example
+ * import { RouteHandlerService } from './route-handler.service'
+ *
+ * // Get a theme route handler
+ * const handler = RouteHandlerService.getThemeHandler('default/custom', 'GET')
+ *
+ * // Get a plugin route handler
+ * const handler = RouteHandlerService.getPluginHandler('ai/generate', 'POST')
+ *
+ * // Check if route exists
+ * if (RouteHandlerService.hasPluginRoute('ai/generate', 'POST')) {
+ *   // Route exists
+ * }
+ */
+import { THEME_ROUTE_HANDLERS, PLUGIN_ROUTE_HANDLERS, type RouteHandler } from '@nextsparkjs/registries/route-handlers';
+export type { RouteHandler } from '@nextsparkjs/registries/route-handlers';
+/**
+ * RouteHandlerService
+ *
+ * Service layer for route handler queries.
+ * All methods are static for consistency with other services.
+ */
+export declare class RouteHandlerService {
+    /**
+     * Get theme route handler by route key and HTTP method
+     *
+     * @param routeKey - Route key in format 'theme-name/route-path'
+     * @param method - HTTP method (GET, POST, PUT, DELETE, PATCH)
+     * @returns RouteHandler function or null if not found
+     *
+     * @example
+     * const handler = RouteHandlerService.getThemeHandler('default/custom', 'GET')
+     * if (handler) {
+     *   const response = await handler(request, { params: Promise.resolve({}) })
+     * }
+     */
+    static getThemeHandler(routeKey: string, method: string): RouteHandler | null;
+    /**
+     * Get all registered theme route keys
+     *
+     * @returns Array of route keys
+     *
+     * @example
+     * const keys = RouteHandlerService.getThemeKeys()
+     * // ['default/custom', 'default/webhook', ...]
+     */
+    static getThemeKeys(): string[];
+    /**
+     * Check if a theme route exists
+     *
+     * @param routeKey - Route key in format 'theme-name/route-path'
+     * @param method - Optional HTTP method to check
+     * @returns true if route (and optionally method) exists
+     *
+     * @example
+     * // Check if route exists (any method)
+     * RouteHandlerService.hasThemeRoute('default/custom') // true
+     *
+     * // Check if route exists with specific method
+     * RouteHandlerService.hasThemeRoute('default/custom', 'POST') // false
+     */
+    static hasThemeRoute(routeKey: string, method?: string): boolean;
+    /**
+     * Get count of registered theme routes
+     *
+     * @returns Number of theme route keys
+     */
+    static getThemeCount(): number;
+    /**
+     * Get all theme handlers (full registry)
+     *
+     * @returns The complete THEME_ROUTE_HANDLERS registry
+     */
+    static getAllThemeHandlers(): typeof THEME_ROUTE_HANDLERS;
+    /**
+     * Get plugin route handler by route key and HTTP method
+     *
+     * @param routeKey - Route key in format 'plugin-name/route-path'
+     * @param method - HTTP method (GET, POST, PUT, DELETE, PATCH)
+     * @returns RouteHandler function or null if not found
+     *
+     * @example
+     * const handler = RouteHandlerService.getPluginHandler('ai/generate', 'POST')
+     * if (handler) {
+     *   const response = await handler(request, { params: Promise.resolve({}) })
+     * }
+     */
+    static getPluginHandler(routeKey: string, method: string): RouteHandler | null;
+    /**
+     * Get all registered plugin route keys
+     *
+     * @returns Array of route keys
+     *
+     * @example
+     * const keys = RouteHandlerService.getPluginKeys()
+     * // ['ai/generate', 'ai/embeddings', ...]
+     */
+    static getPluginKeys(): string[];
+    /**
+     * Check if a plugin route exists
+     *
+     * @param routeKey - Route key in format 'plugin-name/route-path'
+     * @param method - Optional HTTP method to check
+     * @returns true if route (and optionally method) exists
+     *
+     * @example
+     * // Check if route exists (any method)
+     * RouteHandlerService.hasPluginRoute('ai/generate') // true
+     *
+     * // Check if route exists with specific method
+     * RouteHandlerService.hasPluginRoute('ai/generate', 'POST') // true
+     */
+    static hasPluginRoute(routeKey: string, method?: string): boolean;
+    /**
+     * Get count of registered plugin routes
+     *
+     * @returns Number of plugin route keys
+     */
+    static getPluginCount(): number;
+    /**
+     * Get all plugin handlers (full registry)
+     *
+     * @returns The complete PLUGIN_ROUTE_HANDLERS registry
+     */
+    static getAllPluginHandlers(): typeof PLUGIN_ROUTE_HANDLERS;
+    /**
+     * Get total count of all registered routes (theme + plugin)
+     *
+     * @returns Total number of route keys
+     */
+    static getTotalCount(): number;
+}
+/**
+ * @deprecated Use RouteHandlerService.getThemeHandler instead
+ */
+export declare const getThemeRouteHandler: typeof RouteHandlerService.getThemeHandler;
+/**
+ * @deprecated Use RouteHandlerService.getPluginHandler instead
+ */
+export declare const getPluginRouteHandler: typeof RouteHandlerService.getPluginHandler;
+/**
+ * @deprecated Use RouteHandlerService.getThemeKeys instead
+ */
+export declare const getThemeRouteKeys: typeof RouteHandlerService.getThemeKeys;
+/**
+ * @deprecated Use RouteHandlerService.getPluginKeys instead
+ */
+export declare const getPluginRouteKeys: typeof RouteHandlerService.getPluginKeys;
+//# sourceMappingURL=route-handler.service.d.ts.map

package/dist/lib/services/route-handler.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-handler.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/route-handler.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,YAAY,EAClB,MAAM,wCAAwC,CAAA;AAG/C,YAAY,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAE1E;;;;;GAKG;AACH,qBAAa,mBAAmB;IAG9B;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAM7E;;;;;;;;OAQG;IACH,MAAM,CAAC,YAAY,IAAI,MAAM,EAAE;IAI/B;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAOhE;;;;OAIG;IACH,MAAM,CAAC,aAAa,IAAI,MAAM;IAI9B;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,IAAI,OAAO,oBAAoB;IAMzD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAM9E;;;;;;;;OAQG;IACH,MAAM,CAAC,aAAa,IAAI,MAAM,EAAE;IAIhC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAOjE;;;;OAIG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM;IAI/B;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,IAAI,OAAO,qBAAqB;IAM3D;;;;OAIG;IACH,MAAM,CAAC,aAAa,IAAI,MAAM;CAG/B;AAKD;;GAEG;AACH,eAAO,MAAM,oBAAoB,4CAAsC,CAAA;AAEvE;;GAEG;AACH,eAAO,MAAM,qBAAqB,6CAAuC,CAAA;AAEzE;;GAEG;AACH,eAAO,MAAM,iBAAiB,yCAAmC,CAAA;AAEjE;;GAEG;AACH,eAAO,MAAM,kBAAkB,0CAAoC,CAAA"}

package/dist/lib/services/scope.service.d.ts

@@ -0,0 +1,213 @@
+/**
+ * ScopeService - Provides runtime API scope queries
+ *
+ * This service layer abstracts scope-registry access, making the registry
+ * a pure data structure (Data-Only pattern). All query logic lives here.
+ *
+ * Performance: All operations are O(1) with zero I/O.
+ *
+ * @example
+ * ```typescript
+ * import { ScopeService } from './'
+ *
+ * // Get base scopes for authentication
+ * const baseScopes = ScopeService.getBaseScopes()
+ *
+ * // Get scopes for a role
+ * const adminScopes = ScopeService.getRoleScopes('admin')
+ *
+ * // Get restriction rules
+ * const rules = ScopeService.getRestrictionRules('restricted')
+ * ```
+ */
+import { type ScopeConfig, type ApiConfig } from '@nextsparkjs/registries/scope-registry';
+export type { ScopeConfig, ApiConfig };
+/**
+ * Restriction rule structure
+ */
+export interface RestrictionRule {
+    remove?: string[];
+    allow_only?: string[];
+}
+/**
+ * ScopeService
+ *
+ * Static service class for API scope queries.
+ * All methods are static - this class is not meant to be instantiated.
+ */
+export declare class ScopeService {
+    /**
+     * Get base scopes for authentication
+     *
+     * @returns Array of base scope strings
+     *
+     * @example
+     * ```typescript
+     * const scopes = ScopeService.getBaseScopes()
+     * // ['tasks:read', 'tasks:write', ...]
+     * ```
+     */
+    static getBaseScopes(): string[];
+    /**
+     * Get scopes for a specific role
+     *
+     * @param role - Role name (e.g., 'admin', 'member')
+     * @returns Array of scope strings for the role
+     *
+     * @example
+     * ```typescript
+     * const scopes = ScopeService.getRoleScopes('admin')
+     * // ['admin:users', 'tasks:delete', ...]
+     * ```
+     */
+    static getRoleScopes(role: string): string[];
+    /**
+     * Get scopes for a specific flag
+     *
+     * @param flag - Flag name (e.g., 'beta_tester', 'vip')
+     * @returns Array of scope strings for the flag
+     *
+     * @example
+     * ```typescript
+     * const scopes = ScopeService.getFlagScopes('vip')
+     * // ['vip:features', 'advanced:export']
+     * ```
+     */
+    static getFlagScopes(flag: string): string[];
+    /**
+     * Get allowed API filters
+     *
+     * @returns Array of allowed filter names
+     *
+     * @example
+     * ```typescript
+     * const filters = ScopeService.getAllowedFilters()
+     * // ['status', 'role', 'completed', 'userId']
+     * ```
+     */
+    static getAllowedFilters(): string[];
+    /**
+     * Get restriction rules for a flag
+     *
+     * @param flag - Flag name (e.g., 'restricted', 'limited_access')
+     * @returns Restriction rules object or empty object
+     *
+     * @example
+     * ```typescript
+     * const rules = ScopeService.getRestrictionRules('restricted')
+     * // { remove: ['delete', 'admin'] }
+     * ```
+     */
+    static getRestrictionRules(flag: string): RestrictionRule;
+    /**
+     * Get entity API paths for route optimization
+     *
+     * @returns Array of entity API paths
+     *
+     * @example
+     * ```typescript
+     * const paths = ScopeService.getEntityApiPaths()
+     * // ['/api/v1/tasks', '/api/v1/products', ...]
+     * ```
+     */
+    static getEntityApiPaths(): string[];
+    /**
+     * Get all available roles
+     *
+     * @returns Array of role names
+     *
+     * @example
+     * ```typescript
+     * const roles = ScopeService.getRoles()
+     * // ['superadmin', 'admin', 'manager', 'member']
+     * ```
+     */
+    static getRoles(): string[];
+    /**
+     * Get all available flags
+     *
+     * @returns Array of flag names
+     *
+     * @example
+     * ```typescript
+     * const flags = ScopeService.getFlags()
+     * // ['beta_tester', 'vip', 'early_adopter', 'power_user']
+     * ```
+     */
+    static getFlags(): string[];
+    /**
+     * Check if a role exists
+     *
+     * @param role - Role name to check
+     * @returns True if role exists
+     *
+     * @example
+     * ```typescript
+     * ScopeService.hasRole('admin') // true
+     * ScopeService.hasRole('invalid') // false
+     * ```
+     */
+    static hasRole(role: string): boolean;
+    /**
+     * Check if a flag exists
+     *
+     * @param flag - Flag name to check
+     * @returns True if flag exists
+     *
+     * @example
+     * ```typescript
+     * ScopeService.hasFlag('vip') // true
+     * ScopeService.hasFlag('invalid') // false
+     * ```
+     */
+    static hasFlag(flag: string): boolean;
+    /**
+     * Get the full scope configuration
+     *
+     * @returns The complete SCOPE_CONFIG object
+     *
+     * @example
+     * ```typescript
+     * const config = ScopeService.getScopeConfig()
+     * // { base: [...], roles: {...}, flags: {...}, restrictions: {...} }
+     * ```
+     */
+    static getScopeConfig(): ScopeConfig;
+    /**
+     * Get the full API configuration
+     *
+     * @returns The complete API_CONFIG object
+     *
+     * @example
+     * ```typescript
+     * const config = ScopeService.getApiConfig()
+     * // { filters: { allowed: [...] }, entityPaths: [...] }
+     * ```
+     */
+    static getApiConfig(): ApiConfig;
+}
+/**
+ * @deprecated Use ScopeService.getBaseScopes() instead
+ */
+export declare const getBaseScopes: typeof ScopeService.getBaseScopes;
+/**
+ * @deprecated Use ScopeService.getRoleScopes() instead
+ */
+export declare const getRoleScopes: typeof ScopeService.getRoleScopes;
+/**
+ * @deprecated Use ScopeService.getFlagScopes() instead
+ */
+export declare const getFlagScopes: typeof ScopeService.getFlagScopes;
+/**
+ * @deprecated Use ScopeService.getAllowedFilters() instead
+ */
+export declare const getAllowedFilters: typeof ScopeService.getAllowedFilters;
+/**
+ * @deprecated Use ScopeService.getRestrictionRules() instead
+ */
+export declare const getRestrictionRules: typeof ScopeService.getRestrictionRules;
+/**
+ * @deprecated Use ScopeService.getEntityApiPaths() instead
+ */
+export declare const getEntityApiPaths: typeof ScopeService.getEntityApiPaths;
+//# sourceMappingURL=scope.service.d.ts.map

package/dist/lib/services/scope.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/scope.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,wCAAwC,CAAA;AAG/C,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,CAAA;AAEtC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACvB;;;;;;;;;;OAUG;IACH,MAAM,CAAC,aAAa,IAAI,MAAM,EAAE;IAIhC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAI5C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAI5C;;;;;;;;;;OAUG;IACH,MAAM,CAAC,iBAAiB,IAAI,MAAM,EAAE;IAIpC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAIzD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,iBAAiB,IAAI,MAAM,EAAE;IAMpC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE;IAI3B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE;IAI3B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,cAAc,IAAI,WAAW;IAIpC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,YAAY,IAAI,SAAS;CAGjC;AAQD;;GAEG;AACH,eAAO,MAAM,aAAa,mCAA6B,CAAA;AAEvD;;GAEG;AACH,eAAO,MAAM,aAAa,mCAA6B,CAAA;AAEvD;;GAEG;AACH,eAAO,MAAM,aAAa,mCAA6B,CAAA;AAEvD;;GAEG;AACH,eAAO,MAAM,iBAAiB,uCAAiC,CAAA;AAE/D;;GAEG;AACH,eAAO,MAAM,mBAAmB,yCAAmC,CAAA;AAEnE;;GAEG;AACH,eAAO,MAAM,iBAAiB,uCAAiC,CAAA"}

package/dist/lib/services/subscription.service.d.ts

@@ -0,0 +1,270 @@
+/**
+ * Subscription Service
+ *
+ * Provides core subscription management functions including queries,
+ * mutations, feature checks, and quota enforcement.
+ *
+ * @module SubscriptionService
+ */
+import type { Subscription, SubscriptionWithPlan, SubscriptionStatus, QuotaInfo, CanPerformActionResult, BillingInterval } from '../billing/types';
+export interface CreateSubscriptionOptions {
+    billingInterval?: BillingInterval;
+    trialDays?: number;
+    paymentProvider?: 'stripe' | 'paddle' | 'lemonsqueezy';
+    externalSubscriptionId?: string;
+    externalCustomerId?: string;
+}
+export interface ChangePlanResult {
+    success: boolean;
+    subscription?: SubscriptionWithPlan;
+    downgradeWarnings?: string[];
+    error?: string;
+}
+export declare class SubscriptionService {
+    /**
+     * Get subscription by ID
+     *
+     * @param id - Subscription ID
+     * @returns Subscription or null if not found
+     *
+     * @example
+     * const sub = await SubscriptionService.getById('sub-uuid-123')
+     */
+    static getById(id: string): Promise<Subscription | null>;
+    /**
+     * Get active subscription for a team with plan details
+     *
+     * @param teamId - Team ID
+     * @returns Active subscription with plan or null
+     *
+     * @example
+     * const sub = await SubscriptionService.getActive('team-uuid-123')
+     * console.log(sub?.plan.name) // 'Pro Plan'
+     */
+    static getActive(teamId: string): Promise<SubscriptionWithPlan | null>;
+    /**
+     * Get subscription by team ID (alias for getActive)
+     *
+     * @param teamId - Team ID
+     * @returns Active subscription with plan or null
+     */
+    static getByTeamId(teamId: string): Promise<SubscriptionWithPlan | null>;
+    /**
+     * Get subscription by user ID (B2C optimization)
+     * Uses optional userId field to avoid JOIN
+     *
+     * @param userId - User ID
+     * @returns Active subscription with plan or null
+     *
+     * @example
+     * const sub = await SubscriptionService.getByUserId('user-uuid-123')
+     */
+    static getByUserId(userId: string): Promise<SubscriptionWithPlan | null>;
+    /**
+     * Create a new subscription
+     *
+     * @param teamId - Team ID
+     * @param planId - Plan ID
+     * @param options - Creation options
+     * @returns Created subscription
+     *
+     * @example
+     * const sub = await SubscriptionService.create('team-123', 'plan-456')
+     */
+    static create(teamId: string, planId: string, options?: CreateSubscriptionOptions): Promise<Subscription>;
+    /**
+     * Create default subscription (free plan) for a team
+     *
+     * @param teamId - Team ID
+     * @returns Created subscription
+     *
+     * @example
+     * const sub = await SubscriptionService.createDefault('team-123')
+     */
+    static createDefault(teamId: string): Promise<Subscription>;
+    /**
+     * Update subscription status
+     *
+     * @param subscriptionId - Subscription ID
+     * @param status - New status
+     * @returns Updated subscription
+     *
+     * @example
+     * await SubscriptionService.updateStatus('sub-123', 'canceled')
+     */
+    static updateStatus(subscriptionId: string, status: SubscriptionStatus): Promise<Subscription>;
+    /**
+     * Cancel subscription
+     *
+     * @param subscriptionId - Subscription ID
+     * @param cancelAtPeriodEnd - If true, cancel at end of current period
+     *
+     * @example
+     * await SubscriptionService.cancel('sub-123', true)
+     */
+    static cancel(subscriptionId: string, cancelAtPeriodEnd?: boolean): Promise<Subscription>;
+    /**
+     * Change subscription plan (upgrade or downgrade)
+     *
+     * @param teamId - Team ID
+     * @param targetPlanSlug - Target plan slug
+     * @param billingInterval - Billing interval
+     * @returns Change result with warnings if downgrade
+     *
+     * @example
+     * const result = await SubscriptionService.changePlan('team-123', 'pro', 'monthly')
+     * if (result.downgradeWarnings) {
+     *   console.log('Warnings:', result.downgradeWarnings)
+     * }
+     */
+    static changePlan(teamId: string, targetPlanSlug: string, billingInterval?: BillingInterval): Promise<ChangePlanResult>;
+    /**
+     * Pause subscription
+     *
+     * @param subscriptionId - Subscription ID
+     * @returns Updated subscription
+     *
+     * @example
+     * await SubscriptionService.pause('sub-123')
+     */
+    static pause(subscriptionId: string): Promise<Subscription>;
+    /**
+     * Resume a paused subscription
+     *
+     * @param subscriptionId - Subscription ID
+     * @returns Updated subscription
+     *
+     * @example
+     * await SubscriptionService.resume('sub-123')
+     */
+    static resume(subscriptionId: string): Promise<Subscription>;
+    /**
+     * List subscriptions by status
+     *
+     * @param status - Subscription status to filter
+     * @param options - Pagination options
+     * @returns Array of subscriptions with plans
+     *
+     * @example
+     * const activeSubscriptions = await SubscriptionService.listByStatus('active')
+     * const trialingSubs = await SubscriptionService.listByStatus('trialing', { limit: 50 })
+     */
+    static listByStatus(status: SubscriptionStatus, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<SubscriptionWithPlan[]>;
+    /**
+     * List subscriptions expiring soon
+     *
+     * @param days - Number of days to look ahead
+     * @returns Array of subscriptions expiring within the specified days
+     *
+     * @example
+     * const expiringSoon = await SubscriptionService.listExpiringSoon(7)
+     */
+    static listExpiringSoon(days?: number): Promise<SubscriptionWithPlan[]>;
+    /**
+     * List subscriptions by plan
+     *
+     * @param planSlug - Plan slug to filter by
+     * @param options - Pagination and status filter options
+     * @returns Array of subscriptions on the specified plan
+     *
+     * @example
+     * const proSubscriptions = await SubscriptionService.listByPlan('pro')
+     * const activeProSubs = await SubscriptionService.listByPlan('pro', { status: 'active' })
+     */
+    static listByPlan(planSlug: string, options?: {
+        status?: SubscriptionStatus;
+        limit?: number;
+        offset?: number;
+    }): Promise<SubscriptionWithPlan[]>;
+    /**
+     * Get subscription by external (Stripe) subscription ID
+     *
+     * @param externalId - External subscription ID from payment provider
+     * @returns Subscription with plan or null
+     *
+     * @example
+     * const sub = await SubscriptionService.getByExternalId('sub_1234567890')
+     */
+    static getByExternalId(externalId: string): Promise<SubscriptionWithPlan | null>;
+    /**
+     * Count subscriptions by plan
+     *
+     * @param planSlug - Optional plan slug to filter
+     * @returns Count per plan or total
+     *
+     * @example
+     * const counts = await SubscriptionService.countByPlan()
+     * // { free: 100, pro: 50, enterprise: 10 }
+     */
+    static countByPlan(planSlug?: string): Promise<Record<string, number> | number>;
+    /**
+     * Get subscription history for a team
+     *
+     * @param teamId - Team ID
+     * @returns Array of all subscriptions (including canceled)
+     *
+     * @example
+     * const history = await SubscriptionService.getHistory('team-123')
+     */
+    static getHistory(teamId: string): Promise<SubscriptionWithPlan[]>;
+    /**
+     * Check if team has a specific feature
+     *
+     * @param teamId - Team ID
+     * @param featureSlug - Feature slug to check
+     * @returns True if team has access to feature
+     *
+     * @example
+     * const hasAnalytics = await SubscriptionService.hasFeature('team-123', 'advanced_analytics')
+     */
+    static hasFeature(teamId: string, featureSlug: string): Promise<boolean>;
+    /**
+     * Check quota for a specific limit
+     *
+     * @param teamId - Team ID
+     * @param limitSlug - Limit slug to check
+     * @returns Quota information including allowed status
+     *
+     * @example
+     * const quota = await SubscriptionService.checkQuota('team-123', 'projects')
+     * if (!quota.allowed) {
+     *   console.log('Quota exceeded:', quota.current, '/', quota.max)
+     * }
+     */
+    static checkQuota(teamId: string, limitSlug: string): Promise<QuotaInfo>;
+    /**
+     * Check if action is allowed (RBAC + feature + quota)
+     *
+     * The system verifies 3 levels in order:
+     * 1. Permission (RBAC) - Does the role allow this action?
+     * 2. Feature (Plan) - Does the plan include this feature?
+     * 3. Quota (Limits) - Is there available quota?
+     *
+     * @param userId - User ID performing the action
+     * @param teamId - Team ID context
+     * @param action - Action slug to check
+     * @returns Result with allowed status and reason if blocked
+     *
+     * @example
+     * const result = await SubscriptionService.canPerformAction('user-123', 'team-456', 'projects.create')
+     * if (!result.allowed) {
+     *   console.log('Blocked:', result.reason)
+     * }
+     */
+    static canPerformAction(userId: string, teamId: string, action: string): Promise<CanPerformActionResult>;
+    /**
+     * Process expired trials (batch job)
+     * Moves trialing subscriptions to active or expired
+     *
+     * @returns Number of subscriptions processed
+     *
+     * @example
+     * const count = await SubscriptionService.processExpiredTrials()
+     * console.log(`Processed ${count} expired trials`)
+     */
+    static processExpiredTrials(): Promise<number>;
+}
+//# sourceMappingURL=subscription.service.d.ts.map

package/dist/lib/services/subscription.service.d.ts.map

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