@beignet/cli 0.0.48 → 0.0.50

package/src/analysis/contract-factories.ts

@@ -0,0 +1,256 @@
+import ts from "typescript";
+
+const contractFactoryModule = "@beignet/core/contracts";
+
+export type ContractFactoryName = "defineContract" | "defineContractGroup";
+
+export type ContractFactoryBindings = {
+  localNames: Record<ContractFactoryName, Set<string>>;
+  namespaceNames: Set<string>;
+};
+
+export type ContractBindingNames = {
+  contracts: Set<string>;
+  groups: Set<string>;
+};
+
+type ContractCall = {
+  name: string;
+  node: ts.CallExpression;
+};
+
+type ContractCallChain = {
+  baseIdentifier?: string;
+  rootCall?: ContractCall;
+  calls: ContractCall[];
+};
+
+const contractGroupMethods = new Set([
+  "defineContractGroup",
+  "deprecated",
+  "errors",
+  "headers",
+  "meta",
+  "namespace",
+  "prefix",
+  "responses",
+]);
+
+const httpContractMethods = new Set([
+  "delete",
+  "get",
+  "head",
+  "options",
+  "patch",
+  "post",
+  "put",
+]);
+
+export function contractFactoryBindings(
+  sourceFile: ts.SourceFile,
+): ContractFactoryBindings {
+  const bindings: ContractFactoryBindings = {
+    localNames: {
+      defineContract: new Set(),
+      defineContractGroup: new Set(),
+    },
+    namespaceNames: new Set(),
+  };
+
+  for (const statement of sourceFile.statements) {
+    if (
+      !ts.isImportDeclaration(statement) ||
+      !ts.isStringLiteral(statement.moduleSpecifier) ||
+      statement.moduleSpecifier.text !== contractFactoryModule ||
+      !statement.importClause ||
+      statement.importClause.isTypeOnly
+    ) {
+      continue;
+    }
+
+    const namedBindings = statement.importClause.namedBindings;
+    if (namedBindings && ts.isNamespaceImport(namedBindings)) {
+      bindings.namespaceNames.add(namedBindings.name.text);
+      continue;
+    }
+    if (!namedBindings || !ts.isNamedImports(namedBindings)) continue;
+
+    for (const element of namedBindings.elements) {
+      if (element.isTypeOnly) continue;
+      const importedName = (element.propertyName ?? element.name).text;
+      if (!isContractFactoryName(importedName)) continue;
+      bindings.localNames[importedName].add(element.name.text);
+    }
+  }
+
+  return bindings;
+}
+
+export function isImportedContractFactoryCall(
+  call: ts.CallExpression,
+  name: ContractFactoryName,
+  bindings: ContractFactoryBindings,
+): boolean {
+  const callee = unwrapExpression(call.expression);
+  if (ts.isIdentifier(callee)) {
+    return bindings.localNames[name].has(callee.text);
+  }
+  if (!ts.isPropertyAccessExpression(callee) || callee.name.text !== name) {
+    return false;
+  }
+
+  const receiver = unwrapExpression(callee.expression);
+  return (
+    ts.isIdentifier(receiver) && bindings.namespaceNames.has(receiver.text)
+  );
+}
+
+/** Follow imported factories through local group and contract builder aliases. */
+export function contractBindingNames(
+  sourceFile: ts.SourceFile,
+  bindings: ContractFactoryBindings,
+): ContractBindingNames {
+  const declarations = sourceFile.statements
+    .filter(ts.isVariableStatement)
+    .flatMap((statement) => [...statement.declarationList.declarations]);
+  const names: ContractBindingNames = {
+    contracts: new Set(),
+    groups: new Set(),
+  };
+
+  let changed = true;
+  while (changed) {
+    changed = false;
+    for (const declaration of declarations) {
+      if (
+        !ts.isIdentifier(declaration.name) ||
+        !declaration.initializer ||
+        names.contracts.has(declaration.name.text) ||
+        names.groups.has(declaration.name.text)
+      ) {
+        continue;
+      }
+      const chain = contractCallChain(declaration.initializer);
+      if (!chain) continue;
+
+      if (
+        contractFactoryCall(chain, "defineContract", bindings) ||
+        (chain.baseIdentifier && names.contracts.has(chain.baseIdentifier))
+      ) {
+        names.contracts.add(declaration.name.text);
+        changed = true;
+        continue;
+      }
+
+      if (!isContractGroupDerived(chain, bindings, names.groups)) continue;
+      if (chain.calls.some((call) => httpContractMethods.has(call.name))) {
+        names.contracts.add(declaration.name.text);
+        changed = true;
+        continue;
+      }
+
+      if (chain.calls.some((call) => !contractGroupMethods.has(call.name))) {
+        continue;
+      }
+      names.groups.add(declaration.name.text);
+      changed = true;
+    }
+  }
+
+  return names;
+}
+
+/** Determine whether an expression declares a direct or group-built contract. */
+export function isImportedContractDeclaration(
+  expression: ts.Expression,
+  bindings: ContractFactoryBindings,
+  names: ContractBindingNames,
+): boolean {
+  const chain = contractCallChain(expression);
+  if (!chain) return false;
+  if (
+    contractFactoryCall(chain, "defineContract", bindings) ||
+    (chain.baseIdentifier && names.contracts.has(chain.baseIdentifier))
+  ) {
+    return true;
+  }
+  return (
+    isContractGroupDerived(chain, bindings, names.groups) &&
+    chain.calls.some((call) => httpContractMethods.has(call.name))
+  );
+}
+
+function isContractGroupDerived(
+  chain: ContractCallChain,
+  bindings: ContractFactoryBindings,
+  groupNames: ReadonlySet<string>,
+): boolean {
+  return Boolean(
+    contractFactoryCall(chain, "defineContractGroup", bindings) ||
+      (chain.baseIdentifier && groupNames.has(chain.baseIdentifier)),
+  );
+}
+
+function contractFactoryCall(
+  chain: ContractCallChain,
+  name: ContractFactoryName,
+  bindings: ContractFactoryBindings,
+): ContractCall | undefined {
+  const calls = chain.rootCall ? [chain.rootCall, ...chain.calls] : chain.calls;
+  return calls.find((call) =>
+    isImportedContractFactoryCall(call.node, name, bindings),
+  );
+}
+
+function contractCallChain(
+  rawExpression: ts.Expression,
+): ContractCallChain | undefined {
+  const calls: ContractCall[] = [];
+  let expression = rawExpression;
+
+  while (true) {
+    expression = unwrapExpression(expression);
+    if (ts.isPropertyAccessExpression(expression)) {
+      expression = expression.expression;
+      continue;
+    }
+    if (ts.isCallExpression(expression)) {
+      const callee = unwrapExpression(expression.expression);
+      if (ts.isPropertyAccessExpression(callee)) {
+        calls.unshift({ name: callee.name.text, node: expression });
+        expression = callee.expression;
+        continue;
+      }
+      if (ts.isIdentifier(callee)) {
+        return {
+          baseIdentifier: callee.text,
+          rootCall: { name: callee.text, node: expression },
+          calls,
+        };
+      }
+      return undefined;
+    }
+    if (ts.isIdentifier(expression)) {
+      return { baseIdentifier: expression.text, calls };
+    }
+    return undefined;
+  }
+}
+
+function isContractFactoryName(value: string): value is ContractFactoryName {
+  return value === "defineContract" || value === "defineContractGroup";
+}
+
+function unwrapExpression(expression: ts.Expression): ts.Expression {
+  let current = expression;
+  while (
+    ts.isParenthesizedExpression(current) ||
+    ts.isAsExpression(current) ||
+    ts.isTypeAssertionExpression(current) ||
+    ts.isNonNullExpression(current) ||
+    ts.isSatisfiesExpression(current)
+  ) {
+    current = current.expression;
+  }
+  return current;
+}

package/src/analysis/layers.ts

@@ -0,0 +1,266 @@
+import path from "node:path";
+import {
+  clientDirPath,
+  directoryPath,
+  normalizePath,
+  type ResolvedBeignetConfig,
+} from "../config.js";
+
+export type SourceLayer =
+  | "app"
+  | "app-context"
+  | "agent-capability"
+  | "client"
+  | "component"
+  | "contract"
+  | "domain"
+  | "feature-helper"
+  | "feature-port"
+  | "infra"
+  | "lib"
+  | "policy"
+  | "port"
+  | "route"
+  | "schema"
+  | "seed"
+  | "server"
+  | "test"
+  | "use-case"
+  | "workflow"
+  | "unknown";
+
+type FeatureLayerConvention = {
+  path: string;
+  layer: SourceLayer;
+};
+
+const canonicalFeatureDirectories = {
+  client: "client",
+  components: "component",
+  domain: "domain",
+  jobs: "workflow",
+  listeners: "workflow",
+  notifications: "workflow",
+  schedules: "workflow",
+  seeds: "seed",
+  tasks: "workflow",
+  tests: "test",
+  uploads: "workflow",
+  "use-cases": "use-case",
+} as const satisfies Record<string, SourceLayer>;
+
+const canonicalFeatureRootFiles = {
+  "agent-capabilities": "agent-capability",
+  contracts: "contract",
+  policy: "policy",
+  ports: "feature-port",
+  routes: "route",
+  schemas: "schema",
+} as const satisfies Record<string, SourceLayer>;
+
+const featureDirectoryAliases = {
+  command: "tasks",
+  commands: "tasks",
+  event: "domain/events",
+  events: "domain/events",
+  job: "jobs",
+  listener: "listeners",
+  notification: "notifications",
+  schedule: "schedules",
+  scheduled: "schedules",
+  task: "tasks",
+  upload: "uploads",
+} as const;
+
+export function classifySourcePath(
+  filePath: string,
+  config: ResolvedBeignetConfig,
+): SourceLayer {
+  const normalizedPath = stripKnownExtension(normalizePath(filePath));
+  const featuresPath = directoryPath(config.paths.features);
+  const portsDir = directoryPath(path.dirname(config.paths.ports));
+
+  if (
+    isTestPath(normalizedPath) ||
+    isUnder(normalizedPath, directoryPath(config.paths.tests))
+  ) {
+    return "test";
+  }
+  if (normalizedPath === stripKnownExtension(config.paths.appContext)) {
+    return "app-context";
+  }
+
+  const featurePath = featureRelativePath(normalizedPath, featuresPath);
+  if (featurePath) {
+    const layerSegment = featurePath.split("/")[1];
+    if (!layerSegment) return "feature-helper";
+    const convention = featureDirectoryConvention(layerSegment);
+    if (convention) return convention.layer;
+    const rootConvention = featureRootFileConvention(layerSegment);
+    if (rootConvention) return rootConvention.layer;
+    if (layerSegment.endsWith("-contracts")) return "contract";
+    return "feature-helper";
+  }
+
+  if (
+    directoryPath(config.paths.contracts) !== featuresPath &&
+    isUnder(normalizedPath, directoryPath(config.paths.contracts))
+  ) {
+    return "contract";
+  }
+  if (
+    directoryPath(config.paths.useCases) !== featuresPath &&
+    isUnder(normalizedPath, directoryPath(config.paths.useCases))
+  ) {
+    return "use-case";
+  }
+  if (
+    directoryPath(config.paths.policies) !== featuresPath &&
+    isUnder(normalizedPath, directoryPath(config.paths.policies))
+  ) {
+    return "policy";
+  }
+
+  if (
+    isUnder(normalizedPath, directoryPath(path.dirname(config.paths.server)))
+  ) {
+    return "server";
+  }
+  if (
+    isUnder(
+      normalizedPath,
+      directoryPath(path.dirname(config.paths.portWiring)),
+    )
+  ) {
+    return "infra";
+  }
+  if (isUnder(normalizedPath, portsDir)) return "port";
+  if (isUnder(normalizedPath, clientDirPath(config))) return "client";
+  if (isUnder(normalizedPath, "components")) return "component";
+  if (isUnder(normalizedPath, legacySharedDomainPath(config))) return "domain";
+  if (isUnder(normalizedPath, "lib")) return "lib";
+  if (
+    isUnder(normalizedPath, directoryPath(path.dirname(config.paths.routes)))
+  ) {
+    return "app";
+  }
+
+  return "unknown";
+}
+
+export function canonicalFeatureLayerPath(
+  filePath: string,
+  config: ResolvedBeignetConfig,
+): string | undefined {
+  const featuresPath = directoryPath(config.paths.features);
+  const relativePath = featureRelativePath(
+    normalizePath(filePath),
+    featuresPath,
+  );
+  if (!relativePath) return undefined;
+
+  const [feature, segment, ...rest] = relativePath.split("/");
+  if (!feature || !segment) return undefined;
+
+  if (isTestSourceFile(segment, rest) && segment !== "tests") {
+    return path.posix.join(
+      featuresPath,
+      feature,
+      "tests",
+      ...(rest.length > 0 ? rest : [segment]),
+    );
+  }
+
+  if (rest.length > 0) {
+    const convention = featureDirectoryConvention(segment);
+    if (!convention || convention.path === segment) return undefined;
+    return path.posix.join(featuresPath, feature, convention.path, ...rest);
+  }
+
+  const extension = path.posix.extname(segment);
+  const stem = extension ? segment.slice(0, -extension.length) : segment;
+  const convention = featureRootFileConvention(stem);
+  if (!convention || convention.path === stem) return undefined;
+  return path.posix.join(
+    featuresPath,
+    feature,
+    `${convention.path}${extension}`,
+  );
+}
+
+function isTestSourceFile(segment: string, rest: string[]): boolean {
+  const fileName = rest.at(-1) ?? segment;
+  return /\.(?:test|spec)\.(?:ts|tsx|mts|cts)$/.test(fileName);
+}
+
+function featureDirectoryConvention(
+  segment: string,
+): FeatureLayerConvention | undefined {
+  const canonical = Object.entries(canonicalFeatureDirectories).find(
+    ([candidate]) =>
+      normalizeLayerSegment(candidate) === normalizeLayerSegment(segment),
+  );
+  if (canonical) return { path: canonical[0], layer: canonical[1] };
+
+  const alias =
+    featureDirectoryAliases[
+      normalizeLayerSegment(segment) as keyof typeof featureDirectoryAliases
+    ];
+  if (!alias) return undefined;
+  return {
+    path: alias,
+    layer:
+      alias === "domain/events"
+        ? "domain"
+        : canonicalFeatureDirectories[
+            alias as keyof typeof canonicalFeatureDirectories
+          ],
+  };
+}
+
+function featureRootFileConvention(
+  segment: string,
+): FeatureLayerConvention | undefined {
+  const canonical = Object.entries(canonicalFeatureRootFiles).find(
+    ([candidate]) =>
+      normalizeLayerSegment(candidate) === normalizeLayerSegment(segment),
+  );
+  return canonical ? { path: canonical[0], layer: canonical[1] } : undefined;
+}
+
+function normalizeLayerSegment(segment: string): string {
+  return segment.replaceAll("-", "").replaceAll("_", "").toLowerCase();
+}
+
+function stripKnownExtension(filePath: string): string {
+  return filePath.replace(/\.(c|m)?tsx?$/, "");
+}
+
+function isTestPath(filePath: string): boolean {
+  return (
+    filePath.includes("/tests/") ||
+    filePath.endsWith(".test") ||
+    filePath.endsWith(".spec")
+  );
+}
+
+function isUnder(filePath: string, directory: string): boolean {
+  const normalizedDir = directoryPath(directory);
+  if (!normalizedDir || normalizedDir === ".") return false;
+  return filePath === normalizedDir || filePath.startsWith(`${normalizedDir}/`);
+}
+
+function featureRelativePath(
+  filePath: string,
+  featuresPath: string,
+): string | undefined {
+  if (!isUnder(filePath, featuresPath)) return undefined;
+  return filePath.slice(`${directoryPath(featuresPath)}/`.length);
+}
+
+function legacySharedDomainPath(config: ResolvedBeignetConfig): string {
+  const featuresDir = directoryPath(config.paths.features);
+  const featuresParent = directoryPath(path.dirname(featuresDir));
+  if (!featuresParent || featuresParent === ".") return "domain";
+  return path.join(featuresParent, "domain");
+}