@svadmin/core 0.39.0 → 0.40.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svadmin/core",
-  "version": "0.39.0",
+  "version": "0.40.1",
   "author": "zuohuadong",
   "repository": {
     "type": "git",

package/src/enterprise.ts

@@ -18,6 +18,68 @@ export interface EnterpriseRequestContext {
   meta?: Readonly<Record<string, unknown>>;
 }
 
+/** Provider 调用使用的严格请求上下文；三项边界标识不可省略。 */
+export interface StrictEnterpriseRequestContext {
+  tenantId: string | number;
+  requestId: string;
+  traceId: string;
+  meta?: Readonly<Record<string, unknown>>;
+}
+
+export interface EnterpriseRequestContextInput {
+  tenantId: string | number;
+  requestId?: string;
+  traceId?: string;
+  meta?: Readonly<Record<string, unknown>>;
+}
+
+function nonEmpty(value: string, field: string): string {
+  const normalized = value.trim();
+  if (!normalized) throw new Error(`${field} must not be empty.`);
+  return normalized;
+}
+
+function validatedTenantId(tenantId: string | number): string | number {
+  if (typeof tenantId === 'string') return nonEmpty(tenantId, 'tenantId');
+  if (!Number.isFinite(tenantId)) throw new Error('tenantId must be a finite number.');
+  return tenantId;
+}
+
+function createRequestId(): string {
+  const randomUUID = globalThis.crypto?.randomUUID;
+  if (!randomUUID) throw new Error('crypto.randomUUID is required to create an enterprise request context.');
+  return randomUUID.call(globalThis.crypto);
+}
+
+/** Create a validated provider context while preserving one trace across the request tree. */
+export function createEnterpriseRequestContext(
+  input: EnterpriseRequestContextInput,
+): StrictEnterpriseRequestContext {
+  const requestId = input.requestId === undefined
+    ? createRequestId()
+    : nonEmpty(input.requestId, 'requestId');
+  return {
+    tenantId: validatedTenantId(input.tenantId),
+    requestId,
+    traceId: input.traceId === undefined ? requestId : nonEmpty(input.traceId, 'traceId'),
+    ...(input.meta ? { meta: input.meta } : {}),
+  };
+}
+
+/** Narrow a legacy optional context at the provider boundary and fail closed on missing identity. */
+export function assertEnterpriseRequestContext(
+  context: EnterpriseRequestContext,
+): asserts context is StrictEnterpriseRequestContext {
+  if (context.tenantId === undefined || context.tenantId === null) {
+    throw new Error('tenantId must not be empty.');
+  }
+  validatedTenantId(context.tenantId);
+  nonEmpty(context.requestId ?? '', 'requestId');
+  nonEmpty(context.traceId ?? '', 'traceId');
+}
+
+export type EnterpriseProviderRequestContext = StrictEnterpriseRequestContext;
+
 export interface Organization {
   id: string;
   name: string;

package/src/index.ts

@@ -93,6 +93,9 @@ export type {
   EnterpriseActionError,
   EnterpriseActionResult,
   EnterpriseRequestContext,
+  EnterpriseRequestContextInput,
+  EnterpriseProviderRequestContext,
+  StrictEnterpriseRequestContext,
   EnterpriseSecurityEvent,
   EnterpriseSecurityPolicy,
   IdentityGovernanceProvider,
@@ -106,6 +109,7 @@ export type {
   SessionProvider,
   WebhookSummary,
 } from './enterprise';
+export { assertEnterpriseRequestContext, createEnterpriseRequestContext } from './enterprise';
 export { setChatProvider, getChatProvider, setChatContext, getChatContext, setAgentProvider, getAgentProvider, registerApproval, resolveApproval, hasPendingApprovals, resetChatProvider } from './chatProvider.svelte';
 export type { ChatProvider, ChatMessage, ChatContext, ChatAction, AgentProvider, AgentEvent, AgentOptions, AdminTool, AdminToolParameter, ToolResult } from './chatProvider.svelte';
 export { getTheme, setTheme, toggleTheme, getResolvedTheme, getColorTheme, setColorTheme, getColorThemes, configureTheme, getThemeConfig, clearCssOverrides, builtinPresets, registerColorPreset, getColorPresets, registerThemeOwner, updateThemeOwner, unregisterThemeOwner, resetTheme } from './theme.svelte';

package/src/route-parsing.ts

@@ -0,0 +1,14 @@
+export type ParsedResourceAction = {
+  action: 'list' | 'create' | 'edit' | 'show' | 'clone';
+  id?: string;
+};
+
+export function parseResourceActionSegments(restSegments: string[]): ParsedResourceAction {
+  if (restSegments.length === 0) return { action: 'list' };
+  if (restSegments[0] === 'create') return { action: 'create' };
+  if (restSegments[0] === 'edit' && restSegments[1]) return { action: 'edit', id: restSegments[1] };
+  if (restSegments[0] === 'show' && restSegments[1]) return { action: 'show', id: restSegments[1] };
+  if (restSegments[0] === 'clone' && restSegments[1]) return { action: 'clone', id: restSegments[1] };
+  if (restSegments[1] === 'edit') return { action: 'edit', id: restSegments[0] };
+  return { action: 'show', id: restSegments[0] };
+}

package/src/useParsed.svelte.ts

@@ -3,6 +3,7 @@
 
 import { registerRouterSync } from './router';
 import { captureAdminContext } from './context.svelte';
+import { parseResourceActionSegments } from './route-parsing';
 
 interface ParsedRoute {
   resource?: string;
@@ -107,47 +108,13 @@ export function useParsed(): ParsedRoute {
         }
       }
 
-      const restSegments = segments.slice(resourceIndex + 1);
-      if (restSegments.length === 0) {
-        result.action = 'list';
-      } else if (restSegments[0] === 'create') {
-        result.action = 'create';
-      } else if (restSegments[0] === 'edit' && restSegments[1]) {
-        result.action = 'edit';
-        result.id = restSegments[1];
-      } else if (restSegments[0] === 'show' && restSegments[1]) {
-        result.action = 'show';
-        result.id = restSegments[1];
-      } else if (restSegments[0] === 'clone' && restSegments[1]) {
-        result.action = 'clone';
-        result.id = restSegments[1];
-      } else if (restSegments[0]) {
-        // Legacy: /:resource/:id
-        result.action = 'show';
-        result.id = restSegments[0];
-      }
+      Object.assign(result, parseResourceActionSegments(segments.slice(resourceIndex + 1)));
     } else {
       // Fallback if resource definitions are not loaded yet
       result.resource = segments[0];
       result.resourcePath = segments[0];
 
-      if (segments.length === 1) {
-        result.action = 'list';
-      } else if (segments[1] === 'create') {
-        result.action = 'create';
-      } else if (segments[1] === 'edit' && segments[2]) {
-        result.action = 'edit';
-        result.id = segments[2];
-      } else if (segments[1] === 'show' && segments[2]) {
-        result.action = 'show';
-        result.id = segments[2];
-      } else if (segments[1] === 'clone' && segments[2]) {
-        result.action = 'clone';
-        result.id = segments[2];
-      } else if (segments[1]) {
-        result.action = 'show';
-        result.id = segments[1];
-      }
+      Object.assign(result, parseResourceActionSegments(segments.slice(1)));
     }
 
     return result;