@ontrails/core 1.0.0-beta.0

package/src/workspace.ts

@@ -0,0 +1,77 @@
+/**
+ * Workspace detection utilities.
+ *
+ * Walks the filesystem to find monorepo workspace roots and provides
+ * helpers for working with paths relative to a workspace.
+ */
+
+import { resolve, relative, dirname, join, isAbsolute } from 'node:path';
+
+import { NotFoundError } from './errors.js';
+import { Result } from './result.js';
+
+/** Check if a directory has a package.json with a `workspaces` field. */
+const hasWorkspacesField = async (dir: string): Promise<boolean> => {
+  const pkgPath = join(dir, 'package.json');
+  const file = Bun.file(pkgPath);
+  if (!(await file.exists())) {
+    return false;
+  }
+  try {
+    const pkg: unknown = await file.json();
+    return typeof pkg === 'object' && pkg !== null && 'workspaces' in pkg;
+  } catch {
+    return false;
+  }
+};
+
+/**
+ * Walks up from `startDir` (defaults to `process.cwd()`) looking for a
+ * `package.json` that contains a `"workspaces"` field.
+ *
+ * Returns the directory path of the workspace root on success, or a
+ * `NotFoundError` if no workspace root is found.
+ */
+export const findWorkspaceRoot = async (
+  startDir?: string
+): Promise<Result<string, NotFoundError>> => {
+  let current = resolve(startDir ?? process.cwd());
+
+  // eslint-disable-next-line no-constant-condition
+  while (true) {
+    if (await hasWorkspacesField(current)) {
+      return Result.ok(current);
+    }
+
+    const parent = dirname(current);
+
+    if (parent === current) {
+      return Result.err(
+        new NotFoundError(
+          `No workspace root found from "${startDir ?? process.cwd()}"`
+        )
+      );
+    }
+
+    current = parent;
+  }
+};
+
+/**
+ * Returns `true` if `filePath` is inside `workspaceRoot`.
+ */
+export const isInsideWorkspace = (
+  filePath: string,
+  workspaceRoot: string
+): boolean => {
+  const rel = relative(resolve(workspaceRoot), resolve(filePath));
+  return rel !== '' && !rel.startsWith('..') && !isAbsolute(rel);
+};
+
+/**
+ * Returns the relative path from `workspaceRoot` to `filePath`.
+ */
+export const getRelativePath = (
+  filePath: string,
+  workspaceRoot: string
+): string => relative(resolve(workspaceRoot), resolve(filePath));

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"],
+  "exclude": ["**/__tests__/**", "**/*.test.ts", "dist"]
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/adapters.ts","./src/blob-ref.ts","./src/branded.ts","./src/collections.ts","./src/context.ts","./src/derive.ts","./src/errors.ts","./src/event.ts","./src/fetch.ts","./src/guards.ts","./src/health.ts","./src/hike.ts","./src/index.ts","./src/job.ts","./src/layer.ts","./src/path-security.ts","./src/resilience.ts","./src/result.ts","./src/serialization.ts","./src/topo.ts","./src/trail.ts","./src/types.ts","./src/validate-topo.ts","./src/validation.ts","./src/workspace.ts","./src/patterns/bulk.ts","./src/patterns/change.ts","./src/patterns/date-range.ts","./src/patterns/index.ts","./src/patterns/pagination.ts","./src/patterns/progress.ts","./src/patterns/sorting.ts","./src/patterns/status.ts","./src/patterns/timestamps.ts","./src/redaction/index.ts","./src/redaction/patterns.ts","./src/redaction/redactor.ts"],"version":"5.9.3"}