@handstage/core 0.0.6 → 0.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@handstage/core",
-	"version": "0.0.6",
+	"version": "0.0.7",
 	"type": "module",
 	"exports": {
 		".": {
@@ -24,7 +24,7 @@
 		"typescript": "^6.0.3"
 	},
 	"dependencies": {
-		"@handstage/dom": "0.0.1",
+		"@handstage/dom": "0.0.2",
 		"chrome-launcher": "^1.2.1",
 		"devtools-protocol": "^0.0.1632630",
 		"uuid": "^14.0.0",

package/src/v3/types/private/locator.ts

@@ -1,4 +1,4 @@
-import type { Buffer } from "buffer"
+import type { Buffer } from "node:buffer"
 
 export interface NormalizedFilePayload {
 	name: string

package/src/v3/types/public/locator.ts

@@ -1,4 +1,4 @@
-import type { Buffer } from "buffer"
+import type { Buffer } from "node:buffer"
 
 export type MouseButton = "left" | "right" | "middle"
 

package/src/v3/types/public/sdkErrors.ts

@@ -1,4 +1,3 @@
-import type { $ZodFormattedError } from "zod/v4/core"
 // Avoid .js extension so bundlers resolve TS source
 import { HANDSTAGE_VERSION } from "../../../version"
 
@@ -14,99 +13,6 @@ export class HandstageError extends Error {
 	}
 }
 
-export class HandstageDefaultError extends HandstageError {
-	constructor(error?: unknown) {
-		if (error instanceof Error || error instanceof HandstageError) {
-			super(
-				`\nHey! We're sorry you ran into an error. \nHandstage version: ${HANDSTAGE_VERSION} \nIf you need help, please open a Github issue or reach out to us on Discord: https://handstage.dev/discord\n\nFull error:\n${error.message}`,
-			)
-		}
-	}
-}
-
-export class HandstageEnvironmentError extends HandstageError {
-	constructor(
-		currentEnvironment: string,
-		requiredEnvironment: string,
-		feature: string,
-	) {
-		super(
-			`You seem to be setting the current environment to ${currentEnvironment}.` +
-				`Ensure the environment is set to ${requiredEnvironment} if you want to use ${feature}.`,
-		)
-	}
-}
-
-export class MissingEnvironmentVariableError extends HandstageError {
-	constructor(missingEnvironmentVariable: string, feature: string) {
-		super(
-			`${missingEnvironmentVariable} is required to use ${feature}.` +
-				`Please set ${missingEnvironmentVariable} in your environment.`,
-		)
-	}
-}
-
-export class UnsupportedModelError extends HandstageError {
-	constructor(supportedModels: string[], feature?: string) {
-		const message = feature
-			? `${feature} requires a valid model.`
-			: `Unsupported model.`
-
-		const guidance =
-			`\n\nPlease use the provider/model format (e.g., "openai/gpt-4o", "anthropic/claude-sonnet-4-5", "google/gemini-3-flash-preview").` +
-			`\n\nFor a complete list of supported models and providers, see: https://docs.handstage.dev/v3/configuration/models#configuration-setup`
-
-		super(`${message}${guidance}`)
-	}
-}
-
-export class UnsupportedModelProviderError extends HandstageError {
-	constructor(supportedProviders: string[], feature?: string) {
-		super(
-			feature
-				? `${feature} requires one of the following model providers: ${supportedProviders}`
-				: `please use one of the supported model providers: ${supportedProviders}`,
-		)
-	}
-}
-
-export class UnsupportedAISDKModelProviderError extends HandstageError {
-	constructor(provider: string, supportedProviders: string[]) {
-		super(
-			`${provider} is not currently supported for aiSDK. please use one of the supported model providers: ${supportedProviders}`,
-		)
-	}
-}
-
-export class InvalidAISDKModelFormatError extends HandstageError {
-	constructor(modelName: string) {
-		super(
-			`${modelName} does not follow correct format for specifying aiSDK models. Please define your model as 'provider/model-name'. For example: \`model: 'openai/gpt-4o-mini'\``,
-		)
-	}
-}
-
-export class CaptchaTimeoutError extends HandstageError {
-	constructor() {
-		super("Captcha timeout")
-	}
-}
-
-export class MissingLLMConfigurationError extends HandstageError {
-	constructor() {
-		super(
-			"No LLM API key or LLM Client configured. An LLM API key or a custom LLM Client " +
-				"is required to use act, extract, or observe.",
-		)
-	}
-}
-
-export class HandlerNotInitializedError extends HandstageError {
-	constructor(handlerType: string) {
-		super(`${handlerType} handler not initialized`)
-	}
-}
-
 export class HandstageInvalidArgumentError extends HandstageError {
 	constructor(message: string) {
 		super(`InvalidArgumentError: ${message}`)
@@ -131,24 +37,6 @@ export class HandstageElementNotFoundError extends HandstageError {
 	}
 }
 
-export class AgentScreenshotProviderError extends HandstageError {
-	constructor(message: string) {
-		super(`ScreenshotProviderError: ${message}`)
-	}
-}
-
-export class HandstageMissingArgumentError extends HandstageError {
-	constructor(message: string) {
-		super(`MissingArgumentError: ${message}`)
-	}
-}
-
-export class CreateChatCompletionResponseError extends HandstageError {
-	constructor(message: string) {
-		super(`CreateChatCompletionResponseError: ${message}`)
-	}
-}
-
 export class HandstageEvalError extends HandstageError {
 	constructor(message: string) {
 		super(`HandstageEvalError: ${message}`)
@@ -169,20 +57,6 @@ export class HandstageLocatorError extends HandstageError {
 	}
 }
 
-export class HandstageClickError extends HandstageError {
-	constructor(message: string, selector: string) {
-		super(
-			`Error Clicking Element with selector: ${selector} Reason: ${message}`,
-		)
-	}
-}
-
-export class LLMResponseError extends HandstageError {
-	constructor(primitive: string, message: string) {
-		super(`${primitive} LLM response error: ${message}`)
-	}
-}
-
 export class HandstageIframeError extends HandstageError {
 	constructor(frameUrl: string, message: string) {
 		super(
@@ -197,58 +71,6 @@ export class ContentFrameNotFoundError extends HandstageError {
 	}
 }
 
-export class XPathResolutionError extends HandstageError {
-	constructor(xpath: string) {
-		super(`XPath "${xpath}" does not resolve in the current page or frames`)
-	}
-}
-
-export class ZodSchemaValidationError extends Error {
-	constructor(
-		public readonly received: unknown,
-		public readonly issues: $ZodFormattedError<unknown>,
-	) {
-		super(`Zod schema validation failed
-
-— Received —
-${JSON.stringify(received, null, 2)}
-
-— Issues —
-${JSON.stringify(issues, null, 2)}`)
-		this.name = "ZodSchemaValidationError"
-	}
-}
-
-export class HandstageInitError extends HandstageError {
-	constructor(message: string) {
-		super(message)
-	}
-}
-
-export class HandstageShadowRootMissingError extends HandstageError {
-	constructor(detail?: string) {
-		super(
-			`No shadow root present on the resolved host` +
-				(detail ? `: ${detail}` : ""),
-		)
-	}
-}
-
-export class HandstageShadowSegmentEmptyError extends HandstageError {
-	constructor() {
-		super(`Empty selector segment after shadow-DOM hop ("//")`)
-	}
-}
-
-export class HandstageShadowSegmentNotFoundError extends HandstageError {
-	constructor(segment: string, hint?: string) {
-		super(
-			`Shadow segment '${segment}' matched no element inside shadow root` +
-				(hint ? ` ${hint}` : ""),
-		)
-	}
-}
-
 export class ElementNotVisibleError extends HandstageError {
 	constructor(selector: string) {
 		super(`Element not visible (no box model): ${selector}`)
@@ -285,12 +107,6 @@ export class ConnectionTimeoutError extends HandstageError {
 	}
 }
 
-export class HandstageClosedError extends HandstageError {
-	constructor() {
-		super("Handstage session was closed")
-	}
-}
-
 export class CDPConnectionClosedError extends HandstageError {
 	constructor(reason: string) {
 		super(`CDP connection closed: ${reason}`)
@@ -319,10 +135,3 @@ export class HandstageSnapshotError extends HandstageError {
 		super(`error taking snapshot${suffix}`, cause)
 	}
 }
-
-export class UnderstudyCommandException extends HandstageError {
-	constructor(message: string, cause?: unknown) {
-		super(message, cause)
-		this.name = "UnderstudyCommandException"
-	}
-}

package/src/v3/understudy/fileUploadUtils.ts

@@ -1,6 +1,6 @@
-import { Buffer } from "buffer"
-import { promises as fs, type Stats } from "fs"
-import path from "path"
+import { Buffer } from "node:buffer"
+import { promises as fs, type Stats } from "node:fs"
+import path from "node:path"
 import type { NormalizedFilePayload } from "../types/private/locator"
 import type {
 	SetInputFilePayload,

package/src/v3/understudy/initScripts.ts

@@ -1,4 +1,4 @@
-import { promises as fs } from "fs"
+import { promises as fs } from "node:fs"
 import type { InitScriptSource } from "../types/private/index"
 import { HandstageInvalidArgumentError } from "../types/public/sdkErrors"
 

package/src/v3/understudy/locator.ts

@@ -4,9 +4,9 @@ import {
 	locatorScriptSources,
 } from "@handstage/dom/build/locatorScripts.generated"
 import type { Protocol } from "devtools-protocol"
-import * as fs from "fs"
-import * as os from "os"
-import * as path from "path"
+import * as fs from "node:fs"
+import * as os from "node:os"
+import * as path from "node:path"
 import type { NormalizedFilePayload } from "../types/private/locator"
 import type {
 	MouseButton,

package/src/v3/understudy/page.ts

@@ -1,5 +1,5 @@
 import type { Protocol } from "devtools-protocol"
-import { promises as fs } from "fs"
+import { promises as fs } from "node:fs"
 import { v3Logger } from "../logger"
 import { withTimeout } from "../timeoutConfig"
 import type { InitScriptSource } from "../types/private/index"

package/src/v3/v3.ts

@@ -1,7 +1,7 @@
-import fs from "fs"
-import os from "os"
-import path from "path"
-import process from "process"
+import fs from "node:fs"
+import os from "node:os"
+import path from "node:path"
+import process from "node:process"
 import { v7 as uuidv7 } from "uuid"
 import { launchLocalChrome } from "./launch/local"
 import {