@saptools/service-flow 0.1.36 → 0.1.38

package/src/trace/traversal.ts

@@ -0,0 +1,4 @@
+import type { TraceEdge } from '../types.js';
+export function limitDepth(edges: TraceEdge[], depth: number): TraceEdge[] {
+  return edges.filter((edge) => edge.step <= depth);
+}

package/src/types.ts

@@ -0,0 +1,186 @@
+export type RepoKind =
+  | 'cap-service'
+  | 'cap-db-model'
+  | 'helper-package'
+  | 'mixed'
+  | 'unknown';
+export type CallType =
+  | 'remote_action'
+  | 'remote_query'
+  | 'remote_entity_read'
+  | 'remote_entity_mutation'
+  | 'remote_entity_delete'
+  | 'remote_entity_media'
+  | 'remote_entity_candidate'
+  | 'local_db_query'
+  | 'external_http'
+  | 'async_emit'
+  | 'async_subscribe'
+  | 'local_service_call'
+  | 'unknown';
+export type EdgeType =
+  | 'REPO_HAS_SERVICE'
+  | 'SERVICE_HAS_OPERATION'
+  | 'OPERATION_IMPLEMENTED_BY_HANDLER'
+  | 'HANDLER_REGISTERED_BY_SERVER'
+  | 'HANDLER_CALLS_LOCAL_FUNCTION'
+  | 'HANDLER_USES_SERVICE_ALIAS'
+  | 'HANDLER_CALLS_REMOTE_OPERATION'
+  | 'REMOTE_CALL_RESOLVES_TO_OPERATION'
+  | 'LOCAL_CALL_RESOLVES_TO_OPERATION'
+  | 'HANDLER_RUNS_DB_QUERY'
+  | 'HANDLER_RUNS_REMOTE_QUERY'
+  | 'HANDLER_ACCESSES_REMOTE_ENTITY'
+  | 'HANDLER_CALLS_EXTERNAL_HTTP'
+  | 'HANDLER_CALLS_TRANSPORT_METHOD'
+  | 'HANDLER_EMITS_EVENT'
+  | 'EVENT_CONSUMED_BY_HANDLER'
+  | 'REPO_IMPORTS_HELPER_PACKAGE'
+  | 'HELPER_PACKAGE_PROVIDES_HANDLER'
+  | 'DYNAMIC_EDGE_CANDIDATE'
+  | 'UNRESOLVED_EDGE';
+export interface DiscoveredRepository {
+  name: string;
+  absolutePath: string;
+  relativePath: string;
+  isGitRepo: boolean;
+}
+export interface CdsRequire {
+  alias: string;
+  kind?: string;
+  model?: string;
+  destination?: string;
+  servicePath?: string;
+  requestTimeout?: number;
+  rawJson: string;
+}
+export interface PackageFacts {
+  packageName?: string;
+  packageVersion?: string;
+  dependencies: Record<string, string>;
+  cdsRequires: CdsRequire[];
+  scripts: Record<string, string>;
+}
+export interface CdsServiceFact {
+  namespace?: string;
+  serviceName: string;
+  qualifiedName: string;
+  servicePath: string;
+  isExtend: boolean;
+  sourceFile: string;
+  sourceLine: number;
+  operations: CdsOperationFact[];
+}
+export interface CdsOperationFact {
+  operationType: 'action' | 'function' | 'event';
+  operationName: string;
+  operationPath: string;
+  paramsJson: string;
+  returnType?: string;
+  sourceFile: string;
+  sourceLine: number;
+}
+export interface HandlerClassFact {
+  className: string;
+  sourceFile: string;
+  sourceLine: number;
+  methods: HandlerMethodFact[];
+}
+export interface HandlerMethodFact {
+  methodName: string;
+  decoratorKind: string;
+  decoratorValue?: string;
+  decoratorRawExpression: string;
+  sourceFile: string;
+  sourceLine: number;
+}
+export interface HandlerRegistrationFact {
+  className?: string;
+  importSource?: string;
+  registrationFile: string;
+  registrationLine: number;
+  registrationKind: string;
+  confidence: number;
+}
+export interface ServiceBindingFact {
+  variableName: string;
+  alias?: string;
+  aliasExpr?: string;
+  destinationExpr?: string;
+  servicePathExpr?: string;
+  isDynamic: boolean;
+  placeholders: string[];
+  sourceFile: string;
+  sourceLine: number;
+  helperChain?: Array<Record<string, unknown>>;
+}
+export interface OutboundCallFact {
+  callType: CallType;
+  sourceSymbolQualifiedName?: string;
+  localServiceName?: string;
+  localServiceLookup?: string;
+  aliasChain?: string[];
+  serviceVariableName?: string;
+  method?: string;
+  operationPathExpr?: string;
+  queryEntity?: string;
+  eventNameExpr?: string;
+  payloadSummary?: string;
+  sourceFile: string;
+  sourceLine: number;
+  confidence: number;
+  unresolvedReason?: string;
+  evidence?: Record<string, unknown>;
+  externalTarget?: { kind: string; stableId: string; label: string; dynamic: boolean };
+}
+export interface ExecutableSymbolFact {
+  kind: string;
+  localName: string;
+  exportedName?: string;
+  qualifiedName: string;
+  sourceFile: string;
+  startLine: number;
+  endLine: number;
+  startOffset: number;
+  endOffset: number;
+  exported: boolean;
+  importExportEvidence?: Record<string, unknown>;
+}
+export interface SymbolCallFact {
+  callerQualifiedName: string;
+  calleeExpression: string;
+  calleeLocalName?: string;
+  receiverLocalName?: string;
+  importSource?: string;
+  sourceFile: string;
+  sourceLine: number;
+  evidence: Record<string, unknown>;
+}
+export interface GeneratedConstantFact {
+  name: string;
+  value: string;
+  sourceFile: string;
+  sourceLine: number;
+}
+export interface TraceStart {
+  repo?: string;
+  servicePath?: string;
+  operation?: string;
+  operationPath?: string;
+  handler?: string;
+}
+export interface TraceEdge {
+  step: number;
+  type: string;
+  from: string;
+  to: string;
+  evidence: Record<string, unknown>;
+  confidence: number;
+  unresolvedReason?: string;
+}
+export interface TraceResult {
+  start: TraceStart;
+  nodes: Array<Record<string, unknown>>;
+  edges: TraceEdge[];
+  diagnostics: Array<Record<string, unknown>>;
+}

package/src/utils/diagnostics.ts

@@ -0,0 +1,10 @@
+export interface DiagnosticInput {
+  severity: 'info' | 'warning' | 'error';
+  code: string;
+  message: string;
+  sourceFile?: string;
+  sourceLine?: number;
+}
+export function errorMessage(error: unknown): string {
+  return error instanceof Error ? error.message : String(error);
+}

package/src/utils/hashing.ts

@@ -0,0 +1,10 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+export async function sha256File(filePath: string): Promise<string> {
+  return createHash('sha256')
+    .update(await readFile(filePath))
+    .digest('hex');
+}
+export function sha256Text(text: string): string {
+  return createHash('sha256').update(text).digest('hex');
+}

package/src/utils/path-utils.ts

@@ -0,0 +1,13 @@
+import path from 'node:path';
+export function normalizePath(value: string): string {
+  return value.split(path.sep).join('/');
+}
+export function relativePath(root: string, value: string): string {
+  return normalizePath(path.relative(root, value) || '.');
+}
+export function ensureLeadingSlash(value: string): string {
+  return value.startsWith('/') ? value : `/${value}`;
+}
+export function stripQuotes(value: string): string {
+  return value.replace(/^['"`]|['"`]$/g, '');
+}

package/src/utils/redaction.ts

@@ -0,0 +1,20 @@
+const SENSITIVE = /authorization|cookie|token|secret|password|key|credential/i;
+export function redactText(text: string): string {
+  return text.replace(
+    /(authorization|cookie|token|secret|password|key|credential)\s*[:=]\s*(['"`]?)[^,'"`}\s]+\2/gi,
+    '$1: [REDACTED]'
+  );
+}
+export function redactValue(value: unknown): unknown {
+  if (Array.isArray(value)) return value.map(redactValue);
+  if (value && typeof value === 'object') {
+    const out: Record<string, unknown> = {};
+    for (const [k, v] of Object.entries(value))
+      out[k] = SENSITIVE.test(k) ? '[REDACTED]' : redactValue(v);
+    return out;
+  }
+  return typeof value === 'string' ? redactText(value) : value;
+}
+export function summarizeExpression(text: string): string {
+  return redactText(text).slice(0, 240);
+}

package/src/version.ts

@@ -0,0 +1,4 @@
+import packageJson from '../package.json' with { type: 'json' };
+
+export const VERSION = packageJson.version;
+export const ANALYZER_VERSION = packageJson.version;