@allbluecn/kernel 0.2.0 → 0.2.2

package/dist/index.d.ts

@@ -1,28 +1,529 @@
 import { ComponentType } from "react";
+import { StreamChunk } from "@tanstack/ai";
+//#region src/pro-contract/billing.d.ts
+interface SubscriptionInfo {
+  planId: string;
+  planName: 'free' | 'pro' | 'enterprise' | 'open-source';
+  status: 'trialing' | 'active' | 'past_due' | 'canceled' | 'expired' | 'unpaid';
+  seats: number;
+  addonSeats: number;
+  currentPeriodStart: Date | null;
+  currentPeriodEnd: Date | null;
+  cancelAtPeriodEnd: boolean;
+  trialEndsAt: Date | null;
+  features: Record<string, boolean>;
+  currency: 'usd' | 'cny';
+}
+interface CheckoutParams {
+  userId: string;
+  planId: string;
+  successUrl: string;
+  cancelUrl: string;
+  trialDays?: number;
+  currency: 'usd' | 'cny';
+}
+interface PortalSessionParams {
+  userId: string;
+  returnUrl: string;
+}
+interface InvoiceInfo {
+  id: string;
+  providerInvoiceId: string;
+  amountDue: number;
+  amountPaid: number;
+  currency: string;
+  status: string;
+  pdfUrl: string | null;
+  hostedInvoiceUrl: string | null;
+  periodStart: Date;
+  periodEnd: Date;
+  paidAt: Date | null;
+}
+interface PlanInfo {
+  id: string;
+  name: string;
+  displayName: string;
+  description: string | null;
+  priceMonthly: number;
+  priceYearly: number | null;
+  currency: 'usd' | 'cny';
+  maxSeats: number | null;
+  aiQuotaMonthly: number | null;
+  features: Record<string, boolean>;
+  isPublic: boolean;
+  providerPriceId: string | null;
+  seatPriceMonthly: number | null;
+}
+interface SeatUpdateParams {
+  userId: string;
+  /** 目标加购席位总数（非增量），取值 [0, 100] */
+  addonSeats: number;
+  /** 首次加购跳转 Creem Checkout 付款成功后的回跳 URL（仅路径①首次加购使用） */
+  successUrl?: string;
+}
+interface SeatCheckResult {
+  available: boolean;
+  current: number;
+  max: number | null;
+  reason?: 'max_seats_reached' | 'unknown_plan';
+}
+declare class BillingUnavailableError extends Error {
+  constructor(message?: string);
+}
+declare class WebhookSignatureError extends Error {
+  constructor(message?: string);
+}
+declare class SeatsExceededError extends Error {
+  current: number;
+  max: number;
+  constructor(current: number, max: number);
+}
+interface BillingService {
+  getSubscription(userId: string): Promise<SubscriptionInfo | null>;
+  listPublicPlans(currency: 'usd' | 'cny'): Promise<PlanInfo[]>;
+  createCheckoutSession(params: CheckoutParams): Promise<{
+    url: string;
+  }>;
+  createCustomerPortalSession(params: PortalSessionParams): Promise<{
+    url: string;
+  }>;
+  listInvoices(userId: string, limit?: number): Promise<InvoiceInfo[]>;
+  checkSeatAvailability(userId: string): Promise<SeatCheckResult>;
+  handleWebhookEvent(rawBody: string, signature: string): Promise<{
+    received: boolean;
+  }>;
+  syncSubscription(userId: string): Promise<SubscriptionInfo>;
+  getEffectivePlan(userId: string): Promise<{
+    planName: string;
+    features: Record<string, boolean>;
+  }>;
+  updateSeats(params: SeatUpdateParams): Promise<SubscriptionInfo & {
+    checkoutUrl?: string;
+  }>;
+}
+//#endregion
+//#region src/pro-contract/hosted-ai.d.ts
+declare class HostedAiError extends Error {
+  readonly code: 'QUOTA_EXHAUSTED' | 'NO_SUBSCRIPTION' | 'NO_ACTIVE_WORKSPACE' | 'PROVIDER_MISCONFIGURED' | 'PROVIDER_ERROR';
+  readonly details?: {
+    used?: number;
+    limit?: number | null;
+    resetAt?: Date;
+    cause?: unknown;
+  } | undefined;
+  constructor(code: 'QUOTA_EXHAUSTED' | 'NO_SUBSCRIPTION' | 'NO_ACTIVE_WORKSPACE' | 'PROVIDER_MISCONFIGURED' | 'PROVIDER_ERROR', message: string, details?: {
+    used?: number;
+    limit?: number | null;
+    resetAt?: Date;
+    cause?: unknown;
+  } | undefined);
+}
+interface HostedAiChatParams {
+  workspaceId: string;
+  userId: string;
+  messages: Array<{
+    role: 'user' | 'assistant' | 'tool';
+    content: string;
+  }>;
+  systemPrompts?: string[];
+  model?: string;
+  threadId?: string;
+  runId?: string;
+  resume?: Array<unknown>;
+  webSearchEnabled?: boolean;
+}
+interface HostedAiChatResult {
+  content: string;
+  inputTokens: number;
+  outputTokens: number;
+  costUsd: number | null;
+  model: string;
+}
+interface AiQuota {
+  used: number;
+  limit: number | null;
+  resetAt: Date;
+  planName: string;
+}
+interface HostedAiModel {
+  id: string;
+  label: string;
+  provider: string;
+  streaming: boolean;
+}
+interface HostedAiService {
+  chatStream(params: HostedAiChatParams, signal?: AbortSignal): AsyncIterable<StreamChunk>;
+  chat(params: HostedAiChatParams, signal?: AbortSignal): Promise<HostedAiChatResult>;
+  getQuota(workspaceId: string): Promise<AiQuota>;
+  listAvailableModels(): Promise<HostedAiModel[]>;
+}
+//#endregion
+//#region src/pro-contract/sso.d.ts
+interface SsoProvider {
+  id: string;
+  type: 'saml' | 'oidc' | 'google' | 'okta' | 'azure';
+  name: string;
+  configured: boolean;
+}
+interface SsoService {
+  listProviders(workspaceId: string): Promise<SsoProvider[]>;
+  initiateLogin(providerId: string, returnUrl: string): Promise<{
+    url: string;
+  }>;
+  handleCallback(providerId: string, code: string, state: string): Promise<{
+    userId: string;
+    workspaceId: string;
+  }>;
+}
+//#endregion
+//#region src/pro-contract/audit.d.ts
+interface AuditLogEntry {
+  id: string;
+  workspaceId: string;
+  userId: string;
+  action: string;
+  resourceType: string;
+  resourceId: string;
+  metadata: Record<string, unknown>;
+  ip: string | null;
+  userAgent: string | null;
+  createdAt: Date;
+}
+interface AuditQuery {
+  workspaceId: string;
+  userId?: string;
+  action?: string;
+  startDate?: Date;
+  endDate?: Date;
+  limit?: number;
+  offset?: number;
+}
+interface AuditService {
+  log(entry: Omit<AuditLogEntry, 'id' | 'createdAt'>): Promise<void>;
+  query(q: AuditQuery): Promise<{
+    entries: AuditLogEntry[];
+    total: number;
+  }>;
+  export(workspaceId: string, format: 'csv' | 'json'): Promise<{
+    url: string;
+  }>;
+}
+//#endregion
+//#region src/pro-contract/permissions.d.ts
+type PermissionLevel = 'none' | 'read' | 'write' | 'admin';
+interface RoleDefinition {
+  id: string;
+  name: string;
+  workspaceId: string;
+  permissions: Record<string, PermissionLevel>;
+  isSystem: boolean;
+}
+interface PermissionsService {
+  listRoles(workspaceId: string): Promise<RoleDefinition[]>;
+  createRole(workspaceId: string, name: string, permissions: Record<string, PermissionLevel>): Promise<RoleDefinition>;
+  updateRole(roleId: string, updates: Partial<RoleDefinition>): Promise<void>;
+  deleteRole(roleId: string): Promise<void>;
+  checkPermission(userId: string, resource: string, action: string): Promise<PermissionLevel>;
+}
+//#endregion
+//#region src/pro-contract/license.d.ts
+interface LicenseInfo {
+  key: string;
+  customerName: string;
+  customerEmail: string;
+  plan: string;
+  seats: number;
+  features: Record<string, boolean>;
+  issuedAt: Date;
+  expiresAt: Date | null;
+}
+interface LicenseStatus {
+  valid: boolean;
+  reason: 'ok' | 'expired' | 'revoked' | 'invalid_signature' | 'not_activated' | 'fingerprint_mismatch';
+  license: LicenseInfo | null;
+  daysUntilExpiry: number | null;
+  inGracePeriod: boolean;
+}
+interface ActivationResult {
+  success: boolean;
+  message: string;
+  instanceId?: string;
+}
+interface LicenseIssueParams {
+  customerName: string;
+  customerEmail: string;
+  customerId: string;
+  plan: string;
+  seats: number;
+  features: Record<string, boolean>;
+  expiresAt: Date | null;
+}
+interface LicenseIssueResult {
+  /** 完整 license key（base64url(payload).base64url(signature)，仅签发时返回一次） */
+  key: string;
+  signature: string;
+  payload: {
+    customerName: string;
+    customerEmail: string;
+    customerId: string;
+    plan: string;
+    seats: number;
+    features: Record<string, boolean>;
+    issuedAt: string;
+    expiresAt: string | null;
+    nonce: string;
+  };
+}
+interface LicenseService {
+  activate(key: string, instanceFingerprint: string): Promise<ActivationResult>;
+  verify(): Promise<LicenseStatus>;
+  revoke(instanceId: string): Promise<void>;
+  issue?(params: LicenseIssueParams): Promise<LicenseIssueResult>;
+  heartbeat?(instanceId: string): Promise<{
+    ok: boolean;
+    revoked: boolean;
+  }>;
+}
+//#endregion
+//#region src/pro-contract/version-history.d.ts
+interface DocumentVersion {
+  id: string;
+  documentId: string;
+  versionNumber: number;
+  content: string;
+  createdBy: string;
+  createdAt: Date;
+  changeSummary: string | null;
+}
+interface VersionHistoryService {
+  saveVersion(documentId: string, content: string, changeSummary?: string): Promise<DocumentVersion>;
+  listVersions(documentId: string, limit?: number): Promise<DocumentVersion[]>;
+  getVersion(versionId: string): Promise<DocumentVersion | null>;
+  restoreVersion(versionId: string): Promise<void>;
+  diffVersions(versionIdA: string, versionIdB: string): Promise<{
+    additions: number;
+    deletions: number;
+    content: string;
+  }>;
+}
+//#endregion
+//#region src/pro-contract/automation.d.ts
+interface AutomationRule {
+  id: string;
+  workspaceId: string;
+  name: string;
+  trigger: {
+    type: 'document_created' | 'status_changed' | 'schedule';
+    config: Record<string, unknown>;
+  };
+  action: {
+    type: 'ai_classify' | 'ai_summarize' | 'assign' | 'notify';
+    config: Record<string, unknown>;
+  };
+  enabled: boolean;
+}
+interface AutomationService {
+  listRules(workspaceId: string): Promise<AutomationRule[]>;
+  createRule(workspaceId: string, rule: Omit<AutomationRule, 'id' | 'workspaceId'>): Promise<AutomationRule>;
+  updateRule(ruleId: string, updates: Partial<AutomationRule>): Promise<void>;
+  deleteRule(ruleId: string): Promise<void>;
+  triggerRule(ruleId: string, context: Record<string, unknown>): Promise<{
+    success: boolean;
+    result: unknown;
+  }>;
+}
+//#endregion
+//#region src/pro-contract/templates.d.ts
+interface DocumentTemplate {
+  id: string;
+  workspaceId: string | null;
+  name: string;
+  description: string;
+  category: string;
+  content: string;
+  icon: string;
+  createdBy: string;
+  createdAt: Date;
+}
+interface TemplatesService {
+  listTemplates(workspaceId: string | null): Promise<DocumentTemplate[]>;
+  createTemplate(workspaceId: string | null, template: Omit<DocumentTemplate, 'id' | 'createdAt'>): Promise<DocumentTemplate>;
+  updateTemplate(templateId: string, updates: Partial<DocumentTemplate>): Promise<void>;
+  deleteTemplate(templateId: string): Promise<void>;
+  instantiate(templateId: string, name: string): Promise<{
+    documentId: string;
+  }>;
+}
+//#endregion
+//#region src/pro-contract/analytics.d.ts
+interface AnalyticsQuery {
+  workspaceId: string;
+  metric: string;
+  groupBy?: string;
+  startDate: Date;
+  endDate: Date;
+}
+interface AnalyticsResult {
+  metric: string;
+  dataPoints: Array<{
+    label: string;
+    value: number;
+    date: Date;
+  }>;
+  summary: {
+    total: number;
+    average: number;
+    trend: 'up' | 'down' | 'flat';
+  };
+}
+interface CustomDashboard {
+  id: string;
+  workspaceId: string;
+  name: string;
+  widgets: Array<{
+    id: string;
+    type: string;
+    query: AnalyticsQuery;
+    title: string;
+  }>;
+}
+interface AnalyticsService {
+  query(q: AnalyticsQuery): Promise<AnalyticsResult>;
+  listDashboards(workspaceId: string): Promise<CustomDashboard[]>;
+  createDashboard(workspaceId: string, dashboard: Omit<CustomDashboard, 'id'>): Promise<CustomDashboard>;
+  exportData(workspaceId: string, format: 'csv' | 'xlsx' | 'json'): Promise<{
+    url: string;
+  }>;
+}
+//#endregion
+//#region src/pro-contract/global-search.d.ts
+interface SearchResult {
+  id: string;
+  type: 'document' | 'project' | 'story' | 'comment' | 'user' | 'tag';
+  title: string;
+  snippet: string;
+  workspaceId: string;
+  url: string;
+  score: number;
+  highlightedAt: Date;
+}
+interface SearchParams {
+  query: string;
+  workspaceId?: string | null;
+  types?: Array<SearchResult['type']>;
+  limit?: number;
+  offset?: number;
+}
+interface GlobalSearchService {
+  search(params: SearchParams): Promise<{
+    results: SearchResult[];
+    total: number;
+  }>;
+  index(documentId: string, content: string, metadata: Record<string, unknown>): Promise<void>;
+  rebuildIndex(workspaceId?: string): Promise<{
+    indexed: number;
+  }>;
+}
+//#endregion
+//#region src/pro-contract/compliance.d.ts
+interface ComplianceJobSummary {
+  id: string;
+  type: 'export' | 'delete';
+  scope: 'user' | 'workspace';
+  targetId: string;
+  status: 'pending' | 'processing' | 'completed' | 'failed';
+  downloadUrl: string | null;
+  expiresAt: Date | null;
+  error: string | null;
+  requestedBy: string | null;
+  createdAt: Date;
+  completedAt: Date | null;
+}
+interface ComplianceService {
+  createExportJob(scope: 'user' | 'workspace', targetId: string, requestedBy?: string): Promise<{
+    id: string;
+  }>;
+  createDeleteJob(scope: 'user' | 'workspace', targetId: string, requestedBy?: string): Promise<{
+    id: string;
+  }>;
+  processJob(jobId: string): Promise<{
+    status: ComplianceJobSummary['status'];
+    error?: string;
+  }>;
+  listJobs(opts: {
+    status?: ComplianceJobSummary['status'];
+    page?: number;
+    pageSize?: number;
+  }): Promise<{
+    items: ComplianceJobSummary[];
+    total: number;
+  }>;
+}
+//#endregion
+//#region src/pro-contract/module.d.ts
+type ProEdition = 'oss' | 'pro';
+type ProFeature = 'billing' | 'hostedAi' | 'sso' | 'audit' | 'permissions' | 'license' | 'versionHistory' | 'automation' | 'templates' | 'analytics' | 'globalSearch' | 'compliance';
+interface ProModule {
+  readonly isAvailable: boolean;
+  readonly edition: ProEdition;
+  readonly version: string;
+  readonly billing: BillingService | null;
+  readonly hostedAi: HostedAiService | null;
+  readonly sso: SsoService | null;
+  readonly audit: AuditService | null;
+  readonly permissions: PermissionsService | null;
+  readonly license: LicenseService | null;
+  readonly versionHistory: VersionHistoryService | null;
+  readonly automation: AutomationService | null;
+  readonly templates: TemplatesService | null;
+  readonly analytics: AnalyticsService | null;
+  readonly globalSearch: GlobalSearchService | null;
+  readonly compliance: ComplianceService | null;
+}
+//#endregion
 //#region src/contributions.d.ts
-type ServerMiddleware = unknown;
+type Middleware = unknown;
+type PluginRouteContext = {
+  params: Readonly<Record<string, string>>;
+  search?: unknown;
+};
 interface RouteContribution {
   path: string;
-  route: unknown;
+  beforeLoad?: (ctx: PluginRouteContext) => unknown;
+  loader?: (ctx: PluginRouteContext) => unknown;
+  component: ComponentType;
+  validateSearch?: (search: Record<string, unknown>) => Record<string, unknown>;
 }
 type QueryFactoryMap = Record<string, () => unknown>;
-type SlotComponentMap = Record<string, ComponentType>;
+interface SettingsTabContribution {
+  labelKey: string;
+  path: string;
+  icon: ComponentType;
+  group?: string;
+}
+interface UiSlotContributions {
+  navItems?: Record<string, ComponentType>;
+  settingsTabs?: SettingsTabContribution[];
+  dashboardWidgets?: Record<string, ComponentType>;
+}
 interface FeatureContribution {
   key: string;
-  tier: string;
-  module: string;
+  tier: 'oss' | 'paid' | 'enterprise';
+  module: ProFeature | null;
 }
+type ProServiceMap = Partial<Record<ProFeature, unknown>>;
 interface PrismaContribution {
   models: string[];
 }
 interface PluginContributions {
   routes?: RouteContribution[];
-  serverMiddleware?: ServerMiddleware[];
+  serverMiddleware?: Middleware[];
   queryOptions?: QueryFactoryMap;
-  uiSlots?: SlotComponentMap;
+  uiSlots?: UiSlotContributions;
   features?: FeatureContribution[];
   aiTools?: unknown[];
   prisma?: PrismaContribution;
+  services?: ProServiceMap;
 }
 //#endregion
 //#region src/types.d.ts
@@ -50,6 +551,17 @@ interface ResolveResult {
 }
 declare function resolvePluginOrder(plugins: PluginDefinition[]): ResolveResult;
 //#endregion
+//#region src/assemble-input.d.ts
+declare function parseProfileImports(source: string): Map<string, string>;
+interface AssembleInput {
+  profileId: string;
+  profileModulePath: string;
+  resolved: ResolveResult;
+  imports: Map<string, string>;
+  pluginLocalNames: string[];
+}
+declare function resolveImportSpecifiers(input: AssembleInput): Map<string, string>;
+//#endregion
 //#region src/generate-assembly.d.ts
 interface GenerateAssemblyInput {
   profileId: string;
@@ -57,8 +569,33 @@ interface GenerateAssemblyInput {
   resolved: ResolveResult;
 }
 declare function generateAssemblyCode(input: GenerateAssemblyInput): string;
+interface AssemblyFiles {
+  pluginsGen: string;
+  modulesGen: string;
+  uiGen: string;
+  routeFiles: Map<string, string>;
+}
+declare function generateAssemblyFiles(input: AssembleInput): AssemblyFiles;
 //#endregion
 //#region src/dump-modules.d.ts
 declare function dumpModules(profileId: string, resolved: ResolveResult): string;
 //#endregion
-export { type FeatureContribution, type PluginContributions, type PluginDefinition, type PrismaContribution, type ProfileDefinition, type QueryFactoryMap, type ResolveResult, type RouteContribution, type SlotComponentMap, definePlugin, defineProfile, dumpModules, generateAssemblyCode, resolvePluginOrder };
+//#region src/server-seam.d.ts
+interface HostSession {
+  user?: {
+    id?: string;
+    role?: string | null;
+    [key: string]: unknown;
+  } | null;
+  [key: string]: unknown;
+}
+interface ServerSeam {
+  requireAuth: (request?: Request) => Promise<HostSession>;
+  requireUserInDb: (userId: string) => Promise<void>;
+  getCurrentSession: (request?: Request) => Promise<HostSession | null>;
+  isDesktop: () => boolean;
+}
+declare function registerServerSeam(impl: ServerSeam): void;
+declare function getServerSeam(): ServerSeam;
+//#endregion
+export { type ActivationResult, type AiQuota, type AnalyticsQuery, type AnalyticsResult, type AnalyticsService, type AssembleInput, type AssemblyFiles, type AuditLogEntry, type AuditQuery, type AuditService, type AutomationRule, type AutomationService, type BillingService, BillingUnavailableError, type CheckoutParams, type ComplianceJobSummary, type ComplianceService, type CustomDashboard, type DocumentTemplate, type DocumentVersion, type FeatureContribution, type GlobalSearchService, type HostSession, type HostedAiChatParams, type HostedAiChatResult, HostedAiError, type HostedAiModel, type HostedAiService, type InvoiceInfo, type LicenseInfo, type LicenseIssueParams, type LicenseIssueResult, type LicenseService, type LicenseStatus, type Middleware, type PermissionLevel, type PermissionsService, type PlanInfo, type PluginContributions, type PluginDefinition, type PluginRouteContext, type PortalSessionParams, type PrismaContribution, type ProEdition, type ProFeature, type ProModule, type ProServiceMap, type ProfileDefinition, type QueryFactoryMap, type ResolveResult, type RoleDefinition, type RouteContribution, type SearchParams, type SearchResult, type SeatCheckResult, SeatsExceededError, type ServerSeam, type SettingsTabContribution, type SsoProvider, type SsoService, type SubscriptionInfo, type TemplatesService, type UiSlotContributions, type VersionHistoryService, WebhookSignatureError, definePlugin, defineProfile, dumpModules, generateAssemblyCode, generateAssemblyFiles, getServerSeam, parseProfileImports, registerServerSeam, resolveImportSpecifiers, resolvePluginOrder };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { a as definePlugin, i as defineProfile, n as generateAssemblyCode, r as resolvePluginOrder, t as dumpModules } from "./src-Dvcggyr-.js";
-export { definePlugin, defineProfile, dumpModules, generateAssemblyCode, resolvePluginOrder };
+import { a as SeatsExceededError, c as generateAssemblyCode, d as resolveImportSpecifiers, f as resolvePluginOrder, i as BillingUnavailableError, l as generateAssemblyFiles, m as definePlugin, n as registerServerSeam, o as WebhookSignatureError, p as defineProfile, r as HostedAiError, s as dumpModules, t as getServerSeam, u as parseProfileImports } from "./src-B6_ZEkl9.js";
+export { BillingUnavailableError, HostedAiError, SeatsExceededError, WebhookSignatureError, definePlugin, defineProfile, dumpModules, generateAssemblyCode, generateAssemblyFiles, getServerSeam, parseProfileImports, registerServerSeam, resolveImportSpecifiers, resolvePluginOrder };