@enricai/barnacle 1.0.0

package/dist/types/dispatch-metrics.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Structured metrics payload attached to dispatch responses so Vivian can
+ * forward step-level detail into Segment events for A/B warehouse analysis.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DispatchMetricsSchema = void 0;
+const v4_1 = require("zod/v4");
+exports.DispatchMetricsSchema = v4_1.z.object({
+    totalDurationMs: v4_1.z.number(),
+    path: v4_1.z.enum(["http", "browser"]),
+    steps: v4_1.z.array(v4_1.z.object({
+        step: v4_1.z.string(),
+        durationMs: v4_1.z.number(),
+        status: v4_1.z.enum(["success", "failed", "skipped"]),
+        error: v4_1.z.string().optional(),
+    })),
+    errorType: v4_1.z.string().optional(),
+    errorStep: v4_1.z.string().optional(),
+    attemptCount: v4_1.z.number(),
+    startedAt: v4_1.z.string(),
+    endedAt: v4_1.z.string(),
+    recordedAt: v4_1.z.string(),
+});
+//# sourceMappingURL=dispatch-metrics.js.map

package/dist/types/dispatch-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-metrics.js","sourceRoot":"","sources":["../../src/types/dispatch-metrics.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,+BAA2B;AAqBd,QAAA,qBAAqB,GAAG,MAAC,CAAC,MAAM,CAAC;IAC5C,eAAe,EAAE,MAAC,CAAC,MAAM,EAAE;IAC3B,IAAI,EAAE,MAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,KAAK,EAAE,MAAC,CAAC,KAAK,CACZ,MAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,MAAC,CAAC,MAAM,EAAE;QAChB,UAAU,EAAE,MAAC,CAAC,MAAM,EAAE;QACtB,MAAM,EAAE,MAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAChD,KAAK,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC7B,CAAC,CACH;IACD,SAAS,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,YAAY,EAAE,MAAC,CAAC,MAAM,EAAE;IACxB,SAAS,EAAE,MAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,MAAC,CAAC,MAAM,EAAE;IACnB,UAAU,EAAE,MAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC"}

package/dist/types/logging.d.ts

@@ -0,0 +1,11 @@
+import type pino from "pino";
+/**
+ * Project-wide logger type. Extends pino's Logger with `errorWithStack` so
+ * callers can log an Error object and its stack trace in a single call without
+ * having to serialize the stack manually. All logger instances returned by
+ * `getLogger()` satisfy this interface.
+ */
+export interface Logger extends pino.Logger {
+    errorWithStack: (error: unknown, msg?: string) => void;
+}
+//# sourceMappingURL=logging.d.ts.map

package/dist/types/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/types/logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;GAKG;AACH,MAAM,WAAW,MAAO,SAAQ,IAAI,CAAC,MAAM;IACzC,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACxD"}

package/dist/types/logging.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=logging.js.map

package/dist/types/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/types/logging.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,283 @@
+{
+  "name": "@enricai/barnacle",
+  "version": "1.0.0",
+  "description": "Site-agnostic browser automation engine. POST a structured payload to a typed endpoint; Barnacle drives a Steel + Stagehand session through the target site and returns a structured result.",
+  "license": "MIT",
+  "author": "Enricai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/enricai/barnacle.git"
+  },
+  "bugs": {
+    "url": "https://github.com/enricai/barnacle/issues"
+  },
+  "homepage": "https://github.com/enricai/barnacle#readme",
+  "keywords": [
+    "browser-automation",
+    "stagehand",
+    "steel",
+    "scraping",
+    "fastify"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@10.4.1",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    },
+    "./api/errors": {
+      "types": "./dist/api/errors.d.ts",
+      "default": "./dist/api/errors.js"
+    },
+    "./api/plugins/auth": {
+      "types": "./dist/api/plugins/auth.d.ts",
+      "default": "./dist/api/plugins/auth.js"
+    },
+    "./api/plugins/error-handler": {
+      "types": "./dist/api/plugins/error-handler.d.ts",
+      "default": "./dist/api/plugins/error-handler.js"
+    },
+    "./api/schemas/common": {
+      "types": "./dist/api/schemas/common.d.ts",
+      "default": "./dist/api/schemas/common.js"
+    },
+    "./cache/keyed-ttl-cache": {
+      "types": "./dist/cache/keyed-ttl-cache.d.ts",
+      "default": "./dist/cache/keyed-ttl-cache.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "default": "./dist/config.js"
+    },
+    "./lib/applicant-payload": {
+      "types": "./dist/lib/applicant-payload.d.ts",
+      "default": "./dist/lib/applicant-payload.js"
+    },
+    "./lib/application-answers": {
+      "types": "./dist/lib/application-answers.d.ts",
+      "default": "./dist/lib/application-answers.js"
+    },
+    "./lib/case-insensitive-headers": {
+      "types": "./dist/lib/case-insensitive-headers.d.ts",
+      "default": "./dist/lib/case-insensitive-headers.js"
+    },
+    "./lib/chromium-client-hints": {
+      "types": "./dist/lib/chromium-client-hints.d.ts",
+      "default": "./dist/lib/chromium-client-hints.js"
+    },
+    "./lib/dispatch-metrics": {
+      "types": "./dist/lib/dispatch-metrics.d.ts",
+      "default": "./dist/lib/dispatch-metrics.js"
+    },
+    "./lib/errors": {
+      "types": "./dist/lib/errors.d.ts",
+      "default": "./dist/lib/errors.js"
+    },
+    "./lib/job-tracking": {
+      "types": "./dist/lib/job-tracking.d.ts",
+      "default": "./dist/lib/job-tracking.js"
+    },
+    "./lib/llm/anthropic-client": {
+      "types": "./dist/lib/llm/anthropic-client.d.ts",
+      "default": "./dist/lib/llm/anthropic-client.js"
+    },
+    "./lib/logging": {
+      "types": "./dist/lib/logging.d.ts",
+      "default": "./dist/lib/logging.js"
+    },
+    "./lib/multipart": {
+      "types": "./dist/lib/multipart.d.ts",
+      "default": "./dist/lib/multipart.js"
+    },
+    "./lib/option-matcher": {
+      "types": "./dist/lib/option-matcher.d.ts",
+      "default": "./dist/lib/option-matcher.js"
+    },
+    "./lib/phone": {
+      "types": "./dist/lib/phone.d.ts",
+      "default": "./dist/lib/phone.js"
+    },
+    "./lib/url-capture": {
+      "types": "./dist/lib/url-capture.d.ts",
+      "default": "./dist/lib/url-capture.js"
+    },
+    "./lib/us-states": {
+      "types": "./dist/lib/us-states.d.ts",
+      "default": "./dist/lib/us-states.js"
+    },
+    "./lib/zod-multipart": {
+      "types": "./dist/lib/zod-multipart.d.ts",
+      "default": "./dist/lib/zod-multipart.js"
+    },
+    "./plugins/loader": {
+      "types": "./dist/plugins/loader.d.ts",
+      "default": "./dist/plugins/loader.js"
+    },
+    "./scraper/errors": {
+      "types": "./dist/scraper/errors.d.ts",
+      "default": "./dist/scraper/errors.js"
+    },
+    "./scraper/flow-runner": {
+      "types": "./dist/scraper/flow-runner.d.ts",
+      "default": "./dist/scraper/flow-runner.js"
+    },
+    "./scraper/http-status-classifier": {
+      "types": "./dist/scraper/http-status-classifier.d.ts",
+      "default": "./dist/scraper/http-status-classifier.js"
+    },
+    "./scraper/navigate": {
+      "types": "./dist/scraper/navigate.d.ts",
+      "default": "./dist/scraper/navigate.js"
+    },
+    "./scraper/parse-json-response": {
+      "types": "./dist/scraper/parse-json-response.d.ts",
+      "default": "./dist/scraper/parse-json-response.js"
+    },
+    "./scraper/rate-limited-json-client": {
+      "types": "./dist/scraper/rate-limited-json-client.d.ts",
+      "default": "./dist/scraper/rate-limited-json-client.js"
+    },
+    "./scraper/raw-fetch": {
+      "types": "./dist/scraper/raw-fetch.d.ts",
+      "default": "./dist/scraper/raw-fetch.js"
+    },
+    "./scraper/require-response-field": {
+      "types": "./dist/scraper/require-response-field.d.ts",
+      "default": "./dist/scraper/require-response-field.js"
+    },
+    "./scraper/session": {
+      "types": "./dist/scraper/session.d.ts",
+      "default": "./dist/scraper/session.js"
+    },
+    "./scraper/session-browserbase": {
+      "types": "./dist/scraper/session-browserbase.d.ts",
+      "default": "./dist/scraper/session-browserbase.js"
+    },
+    "./scraper/stagehand-guard": {
+      "types": "./dist/scraper/stagehand-guard.d.ts",
+      "default": "./dist/scraper/stagehand-guard.js"
+    },
+    "./site-plugin": {
+      "types": "./dist/site-plugin.d.ts",
+      "default": "./dist/site-plugin.js"
+    },
+    "./testing/answers-fixture": {
+      "types": "./dist/testing/answers-fixture.d.ts",
+      "default": "./dist/testing/answers-fixture.js"
+    },
+    "./testing/contract-parity-suite": {
+      "types": "./dist/testing/contract-parity-suite.d.ts",
+      "default": "./dist/testing/contract-parity-suite.js"
+    },
+    "./testing/mock-fetch-response": {
+      "types": "./dist/testing/mock-fetch-response.d.ts",
+      "default": "./dist/testing/mock-fetch-response.js"
+    },
+    "./testing/persona-fixture": {
+      "types": "./dist/testing/persona-fixture.d.ts",
+      "default": "./dist/testing/persona-fixture.js"
+    },
+    "./testing/replay-integration-suite": {
+      "types": "./dist/testing/replay-integration-suite.d.ts",
+      "default": "./dist/testing/replay-integration-suite.js"
+    },
+    "./testing/resume-fixture": {
+      "types": "./dist/testing/resume-fixture.d.ts",
+      "default": "./dist/testing/resume-fixture.js"
+    },
+    "./types/logging": {
+      "types": "./dist/types/logging.d.ts",
+      "default": "./dist/types/logging.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && (test -d src/sites && find src/sites -type d -name fixtures | while read d; do mkdir -p \"dist/${d#src/}\" && cp -r \"$d/.\" \"dist/${d#src/}/\"; done || true) && (test -d src/testing/fixtures && mkdir -p dist/testing/fixtures && cp -r src/testing/fixtures/. dist/testing/fixtures/ || true) && rm -f dist/tsconfig.tsbuildinfo",
+    "clean": "rm -rf node_modules dist",
+    "dev": "tsx watch --env-file=.env src/server.ts",
+    "start": "node --import dd-trace/initialize dist/server.js",
+    "lint": "biome check src",
+    "lint:fix": "biome check src --fix",
+    "format": "biome format src --write",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:integration": "INTEGRATION=true vitest run --testNamePattern integration",
+    "prepare": "husky",
+    "smoke": "tsx --env-file=.env src/scripts/smoke-test.ts",
+    "recon:browser": "tsx --env-file=.env src/scripts/recon-browser.ts",
+    "recon:generate": "tsx src/scripts/recon-generate.ts",
+    "recon:heal": "tsx --env-file=.env src/scripts/recon-heal.ts",
+    "recon:http": "tsx src/scripts/recon-http.ts",
+    "recon:summarize": "tsx src/scripts/recon-summarize.ts",
+    "judge:llm": "tsx --env-file=.env src/scripts/judge-llm-batch.ts",
+    "heal:llm": "tsx --env-file=.env src/scripts/llm-heal.ts",
+    "probe:warmup": "tsx --env-file=.env src/scripts/probe-warmup-reliability.ts"
+  },
+  "dependencies": {
+    "@ai-sdk/amazon-bedrock": "^5.0.14",
+    "@anthropic-ai/sdk": "^0.110.0",
+    "@aws-sdk/client-s3": "^3.1083.0",
+    "@browserbasehq/stagehand": "^3.6.0",
+    "@fastify/compress": "^9.0.0",
+    "@fastify/helmet": "^13.1.0",
+    "@fastify/multipart": "^10.1.0",
+    "@fastify/rate-limit": "^11.1.0",
+    "@fastify/swagger": "^9.8.0",
+    "@fastify/swagger-ui": "^6.1.0",
+    "bcryptjs": "^3.0.3",
+    "bottleneck": "^2.19.5",
+    "date-fns": "^4.4.0",
+    "dd-trace": "^6",
+    "dotenv": "^17.4.2",
+    "fastify": "^5.10.0",
+    "fastify-plugin": "^6.0.0",
+    "fastify-type-provider-zod": "^5.0.2",
+    "hot-shots": "^16",
+    "http-status-codes": "^2.3.0",
+    "lru-cache": "^11.5.2",
+    "nanoid": "^5.1.16",
+    "normalize-url": "^9.0.1",
+    "p-queue": "^9.3.1",
+    "p-retry": "^8.0.0",
+    "pino": "^10.3.1",
+    "steel-sdk": "^0.18.0",
+    "typescript": "^6.0.3",
+    "undici": "8",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.2",
+    "@types/bcryptjs": "^3.0.0",
+    "@types/node": "^26.1.0",
+    "@vitest/coverage-v8": "^4.1.10",
+    "husky": "^9.1.6",
+    "pino-pretty": "^13.0.0",
+    "tsc-alias": "^1.9.0",
+    "tsx": "^4.23.0",
+    "vitest": "^4.1.10"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ],
+    "patchedDependencies": {
+      "@browserbasehq/stagehand": "patches/@browserbasehq__stagehand.patch",
+      "@browserbasehq/sdk": "patches/@browserbasehq__sdk.patch"
+    }
+  }
+}