@jarkkojs/readseek-api 0.9.5

package/dist/json.d.ts

@@ -0,0 +1,2 @@
+export declare function cleanReadSeekErrorText(stderr: string): string;
+export declare function parseReadSeekJson(stdout: string): unknown;

package/dist/platform.d.ts

@@ -0,0 +1,13 @@
+export declare const READSEEK_PLATFORM_PACKAGES: Readonly<Record<string, string>>;
+export type ModuleResolver = {
+    resolve: (specifier: string, options?: {
+        paths?: string[];
+    }) => string;
+};
+export declare function readSeekBinaryName(platform?: string): string;
+export declare function readSeekPlatformKey(platform?: string, arch?: string): string;
+export declare function resolveReadSeekBinaryFromPackages(resolver?: ModuleResolver["resolve"] | ModuleResolver, options?: {
+    platform?: string;
+    arch?: string;
+    metaPackage?: string;
+}): string;

package/dist/process-bun.d.ts

@@ -0,0 +1,4 @@
+import { type ProcessRunOptions, type ProcessRunResult } from "./process.ts";
+export declare function runReadSeekBun(binaryPath: string, args: readonly string[], options?: ProcessRunOptions): Promise<ProcessRunResult>;
+export declare function runReadSeekBunText(binaryPath: string, args: readonly string[], options?: ProcessRunOptions): Promise<string>;
+export declare function runReadSeekBunJson(binaryPath: string, args: readonly string[], options?: ProcessRunOptions): Promise<unknown>;

package/dist/process-node.d.ts

@@ -0,0 +1,4 @@
+import { type ProcessRunOptions, type ProcessRunResult } from "./process.ts";
+export declare function runReadSeekNode(binaryPath: string, args: readonly string[], options?: ProcessRunOptions): Promise<ProcessRunResult>;
+export declare function runReadSeekNodeText(binaryPath: string, args: readonly string[], options?: ProcessRunOptions): Promise<string>;
+export declare function runReadSeekNodeJson(binaryPath: string, args: readonly string[], options?: ProcessRunOptions): Promise<unknown>;

package/dist/process.d.ts

@@ -0,0 +1,30 @@
+export declare const DEFAULT_READSEEK_TIMEOUT_MS = 120000;
+export declare const DEFAULT_MAX_OUTPUT_BYTES: number;
+export type ProcessRunOptions = {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    stdin?: string;
+    cwd?: string;
+    cancelable?: boolean;
+    maxOutputBytes?: number;
+};
+export type ProcessRunResult = {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    signal: string | null;
+};
+export declare function resolveProcessLimits(options?: ProcessRunOptions): {
+    timeoutMs: number;
+    maxOutputBytes: number;
+    cancelable: boolean;
+};
+export declare function readSeekCancellationError(signal: AbortSignal | undefined): Error;
+export declare function failureFromProcessResult(result: ProcessRunResult, options?: {
+    timedOut?: boolean;
+    timeoutMs?: number;
+    overflow?: "stdout" | "stderr";
+    maxOutputBytes?: number;
+}): Error;
+export declare function ensureSuccessfulStdout(result: ProcessRunResult): string;
+export declare function parseSuccessfulJson(result: ProcessRunResult): unknown;

package/dist/validation.d.ts

@@ -0,0 +1,33 @@
+export type ValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+export type GitSelectionInput = {
+    cached?: boolean;
+    others?: boolean;
+    ignored?: boolean;
+};
+export declare function validateGitSelection(input: GitSelectionInput): ValidationResult;
+export type RefsScopeInput = {
+    name?: string;
+    scope?: boolean;
+    line?: number;
+    column?: number;
+};
+export declare function validateRefsNameVsScope(input: RefsScopeInput): ValidationResult;
+export type VisionInput = {
+    visionMode?: string;
+    visionLevel?: string;
+    outline?: boolean;
+};
+export declare function validateVisionLevelVsMode(input: VisionInput): ValidationResult;
+export type EditObject = Record<string, unknown>;
+export declare function validateExactlyOneEditVariant(edits: unknown): {
+    ok: true;
+    edits: EditObject[];
+} | {
+    ok: false;
+    error: string;
+};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@jarkkojs/readseek-api",
+  "version": "0.9.5",
+  "description": "Shared ReadSeek CLI contract, validation, argv builders, and bounded process runners",
+  "type": "module",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/jarkkojs/readseek/tree/main/packages/readseek-api#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jarkkojs/readseek.git",
+    "directory": "packages/readseek-api"
+  },
+  "bugs": {
+    "url": "https://github.com/jarkkojs/readseek/issues"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && bun build ./src/index.ts --outfile dist/index.js --target=node --format=esm --packages=external && tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "readseek",
+    "cli",
+    "structural-search",
+    "ast-grep",
+    "hashline"
+  ],
+  "dependencies": {
+    "@jarkkojs/readseek": "^0.9.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  }
+}