@marginallyuseful/soll-native 0.0.0 → 0.5.0

package/index.d.ts

@@ -0,0 +1,115 @@
+/**
+ * TypeScript types for the @marginallyuseful/soll-native napi-rs addon.
+ *
+ * These mirror the Rust types defined in crates/napi/src/conversions.rs
+ * and the Soll class in crates/napi/src/graph_api.rs.
+ */
+
+/** Options for building the import graph from a set of source files. */
+export interface GraphOptions {
+  /** Workspace root directory (absolute path). */
+  root: string;
+  /**
+   * Explicit list of file paths to include in the graph.
+   * When empty, files are discovered automatically via git.
+   */
+  include: string[];
+}
+
+/** A file node in the affected set. */
+export interface AffectedFile {
+  /** Git-root-relative file path. */
+  path: string;
+}
+
+/** A diagnostic message produced during graph building or resolution. */
+export interface Diagnostic {
+  /** Machine-readable error code (e.g. 'ParseError', 'CycleDetected'). */
+  code: string;
+  /** Human-readable description of the issue. */
+  message: string;
+  /** File where the issue was found (if known). */
+  file?: string;
+  /** Suggestion for fixing the issue (if available). */
+  help?: string;
+}
+
+/** Result of a buildGraph() call. */
+export interface GraphResult {
+  /** Number of file nodes in the built graph. */
+  fileCount: number;
+  /** Number of directed import edges in the graph. */
+  edgeCount: number;
+  /** Any diagnostics collected during parsing and resolution. */
+  diagnostics: Diagnostic[];
+}
+
+/**
+ * Result of an affected-set computation.
+ * Returned by getAffectedFiles().
+ */
+export interface AffectedResult {
+  /**
+   * All files transitively affected by the changed files.
+   */
+  affectedFiles: AffectedFile[];
+  /** Any diagnostics collected during the computation. */
+  diagnostics: Diagnostic[];
+}
+
+/**
+ * Import graph engine for computing affected file sets.
+ *
+ * Construct with `new Soll(options)` to parse files and build
+ * the import graph, then call query methods to compute affected sets.
+ *
+ * Each instance is self-contained — no module-level state is shared.
+ *
+ * @example
+ * ```ts
+ * const scope = new Soll({ root: '/repo', include: files });
+ * console.log(scope.graph.edgeCount);
+ * const affected = scope.getAffectedFiles(['src/utils.ts']);
+ * ```
+ */
+export class Soll {
+  /** Builds the import graph from the provided options. */
+  constructor(options: GraphOptions);
+
+  /** Graph build statistics (file count, edge count, diagnostics). */
+  readonly graph: GraphResult;
+
+  /**
+   * Rebuilds the import graph incrementally for the given changed files.
+   *
+   * Re-runs the facts pipeline scoped to changedFiles and updates the internal
+   * graph state. Returns the new graph statistics. Call this in watch mode
+   * whenever the filesystem changes, before calling getAffectedFiles().
+   */
+  rebuild(changedFiles: string[]): GraphResult;
+
+  /** Returns all files transitively affected by changedFiles. */
+  getAffectedFiles(changedFiles: string[]): AffectedResult;
+
+  /** Returns all file paths in the graph. */
+  getFiles(): string[];
+}
+
+/**
+ * Returns the git repository root for a directory.
+ *
+ * Walks up from `dir` to find the `.git` directory, then returns the
+ * canonicalized working directory path. Throws if `dir` is not inside
+ * a git repository.
+ */
+export function getGitRoot(dir: string): string;
+
+/**
+ * Returns all files changed since the merge-base with the default branch.
+ *
+ * Combines committed changes (since merge-base with main/master), uncommitted
+ * changes (staged + unstaged), and untracked files. Returns absolute paths.
+ *
+ * When `baseBranch` is omitted, auto-detects the default branch (main or master).
+ */
+export function getChangedFiles(root: string, baseBranch?: string): string[];

package/index.js

@@ -0,0 +1,75 @@
+/**
+ * Platform-aware loader for the soll-napi native addon.
+ *
+ * Resolution order:
+ *   1. Prebuilt .node file co-located with this package (placed by build.mjs)
+ *   2. Debug build output under <workspace-root>/target/debug/
+ *   3. Release build output under <workspace-root>/target/release/
+ *
+ * If none are found, throws a descriptive error pointing to the build script.
+ */
+
+const { join, resolve } = require("path");
+const { existsSync } = require("fs");
+
+const { platform, arch } = process;
+
+/** Maps Node.js platform/arch to the expected .node filename. */
+function platformFilename() {
+  const key = `${platform}-${arch}`;
+  const map = {
+    "darwin-arm64": "soll-napi.darwin-arm64.node",
+    "linux-x64": "soll-napi.linux-x64-gnu.node",
+    "linux-arm64": "soll-napi.linux-arm64-gnu.node",
+    "win32-x64": "soll-napi.win32-x64-msvc.node",
+  };
+  return map[key] || null;
+}
+
+/** Workspace root is 2 directories up from crates/napi/. */
+const workspaceRoot = resolve(__dirname, "..", "..");
+
+const filename = platformFilename();
+
+const candidates = [
+  // 1. Prebuilt alongside this file (placed by `node build.mjs`)
+  filename ? join(__dirname, filename) : null,
+  // 2. Generic prebuilt name
+  join(__dirname, "soll-napi.node"),
+  // 3. Raw cargo debug output (macOS dylib)
+  join(workspaceRoot, "target", "debug", "libsoll_napi.dylib"),
+  // 4. Raw cargo debug output (Linux .so)
+  join(workspaceRoot, "target", "debug", "libsoll_napi.so"),
+  // 5. Raw cargo debug output (Windows .dll)
+  join(workspaceRoot, "target", "debug", "soll_napi.dll"),
+  // 6. Release builds
+  join(workspaceRoot, "target", "release", "libsoll_napi.dylib"),
+  join(workspaceRoot, "target", "release", "libsoll_napi.so"),
+  join(workspaceRoot, "target", "release", "soll_napi.dll"),
+].filter(Boolean);
+
+let nativeBinding = null;
+const errors = [];
+
+for (const candidate of candidates) {
+  if (!existsSync(candidate)) continue;
+  try {
+    nativeBinding = require(candidate);
+    break;
+  } catch (err) {
+    errors.push(`  ${candidate}: ${err.message}`);
+  }
+}
+
+if (!nativeBinding) {
+  const tried = candidates.map((c) => `  - ${c}`).join("\n");
+  const errDetail = errors.length ? `\nErrors:\n${errors.join("\n")}` : "";
+  throw new Error(
+    `@marginallyuseful/soll-native: could not load the native binary.\n` +
+      `Tried:\n${tried}\n\n` +
+      `Build it first:\n  pnpm --filter @marginallyuseful/soll-native build\n` +
+      `(run from the workspace root)${errDetail}`
+  );
+}
+
+module.exports = nativeBinding;

package/package.json

@@ -1 +1,16 @@
-{"name":"@marginallyuseful/soll-native","version":"0.0.0","description":"Placeholder","license":"LicenseRef-Proprietary"}
+{
+  "name": "@marginallyuseful/soll-native",
+  "version": "0.5.0",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts"
+  ],
+  "optionalDependencies": {
+    "@marginallyuseful/soll-native-darwin-arm64": "0.5.0",
+    "@marginallyuseful/soll-native-linux-x64-gnu": "0.5.0",
+    "@marginallyuseful/soll-native-linux-arm64-gnu": "0.5.0"
+  },
+  "license": "LicenseRef-Proprietary"
+}