@sapiom/tools 0.7.0 → 0.8.0

package/dist/cjs/database/index.d.ts

@@ -0,0 +1,101 @@
+/**
+ * `database` capability — provision an on-demand Postgres database, retrieve it,
+ * and delete it. You get back direct connection credentials, so you can connect
+ * with any standard Postgres client or driver.
+ *
+ *   import { database } from "@sapiom/tools";              // ambient auth
+ *   const db = await database.create({ duration: "1h", handle: "analytics" });
+ *   db.connection?.connectionString;                      // a ready-to-use Postgres URI
+ *
+ *   const again = await database.get(db.id);              // or get("analytics") by handle
+ *   await database.delete(db.id);                         // or delete("analytics")
+ *
+ * Or via an explicit client: `createClient({ apiKey }).database.create(...)`.
+ *
+ * This is a provisioning surface, not a query layer: it hands you connection
+ * credentials and you run your own SQL with the client of your choice.
+ */
+import { Transport } from "../_client/index.js";
+import { DatabaseHttpError } from "./errors.js";
+export { DatabaseHttpError };
+/** How long the database lives before it is automatically removed. */
+export type DatabaseDuration = "15m" | "1h" | "4h" | "24h" | "7d";
+/** Lifecycle state of a database. */
+export type DatabaseStatus = "provisioning" | "active" | "expired" | "deleting" | "deleted";
+export interface CreateDatabaseInput {
+    /** How long the database lives before it is automatically removed (required). */
+    duration: DatabaseDuration;
+    /**
+     * Optional stable, human-friendly key you can use to look the database up later
+     * (`get(handle)` / `delete(handle)`). 3–63 chars, `^[a-z0-9][a-z0-9-]*[a-z0-9]$`.
+     * Unique within your tenant.
+     */
+    handle?: string;
+    /** Optional display name. */
+    name?: string;
+    /** Optional description (up to 500 chars). */
+    description?: string;
+    /** Optional region to provision in. Defaults to a US region. */
+    region?: string;
+    /** Optional Postgres major version. Defaults to the latest supported. */
+    pgVersion?: 15 | 16 | 17;
+}
+export interface DatabaseConnection {
+    /**
+     * The full Postgres connection URI — pass this to any Postgres client. This is
+     * the canonical value and is always present; the component fields below are
+     * parsed from it on a best-effort basis and may be absent if it can't be parsed.
+     */
+    connectionString: string;
+    /** Database host. */
+    host?: string;
+    /** Database port. */
+    port?: number;
+    /** Database user. */
+    username?: string;
+    /** Database password. */
+    password?: string;
+    /** Name of the database to connect to. */
+    databaseName?: string;
+    /** SSL mode from the connection URI, when present (e.g. "require"). */
+    sslmode?: string;
+}
+export interface Database {
+    /** Unique database identifier. */
+    id: string;
+    /** The handle you set at creation, or `null` if none was given. */
+    handle: string | null;
+    /** Display name, or `null`. */
+    name: string | null;
+    /** Description, or `null`. */
+    description: string | null;
+    /** Lifecycle state. */
+    status: DatabaseStatus;
+    /** Region the database is provisioned in. */
+    region: string;
+    /** Postgres major version. */
+    pgVersion: number;
+    /** The lifetime the database was created with. */
+    duration: DatabaseDuration | string;
+    /** Connection credentials — `null` while the database is still being provisioned. */
+    connection: DatabaseConnection | null;
+    /** ISO-8601 timestamp when the database expires, or `null`. */
+    expiresAt: string | null;
+    /** ISO-8601 timestamp when the database was created. */
+    createdAt: string;
+}
+/**
+ * Provision a new Postgres database. `duration` is required. Returns the database
+ * with connection credentials in `connection`. Failed requests throw
+ * {@link DatabaseHttpError}.
+ */
+export declare function create(input: CreateDatabaseInput, transport?: Transport, baseUrl?: string): Promise<Database>;
+/** Retrieve a database by its id or handle. */
+export declare function get(idOrHandle: string, transport?: Transport, baseUrl?: string): Promise<Database>;
+/**
+ * Delete a database by its id or handle. Exported as `delete`:
+ * `import { database } from "@sapiom/tools"; await database.delete(id)`.
+ */
+declare function deleteDatabase(idOrHandle: string, transport?: Transport, baseUrl?: string): Promise<void>;
+export { deleteDatabase as delete };
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,SAAS,EAAoB,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAY,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAO7B,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;AAElE,qCAAqC;AACrC,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,QAAQ,GACR,SAAS,GACT,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,QAAQ,EAAE,gBAAgB,CAAC;IAC3B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,mEAAmE;IACnE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uBAAuB;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAAC;IACpC,qFAAqF;IACrF,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACtC,+DAA+D;IAC/D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;CACnB;AAoED;;;;GAIG;AACH,wBAAsB,MAAM,CAC1B,KAAK,EAAE,mBAAmB,EAC1B,SAAS,GAAE,SAA8B,EACzC,OAAO,SAAmB,GACzB,OAAO,CAAC,QAAQ,CAAC,CAuBnB;AAED,+CAA+C;AAC/C,wBAAsB,GAAG,CACvB,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,SAA8B,EACzC,OAAO,SAAmB,GACzB,OAAO,CAAC,QAAQ,CAAC,CAQnB;AAED;;;GAGG;AACH,iBAAe,cAAc,CAC3B,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,SAA8B,EACzC,OAAO,SAAmB,GACzB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,OAAO,EAAE,cAAc,IAAI,MAAM,EAAE,CAAC"}

package/dist/cjs/database/index.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseHttpError = void 0;
+exports.create = create;
+exports.get = get;
+exports.delete = deleteDatabase;
+/**
+ * `database` capability — provision an on-demand Postgres database, retrieve it,
+ * and delete it. You get back direct connection credentials, so you can connect
+ * with any standard Postgres client or driver.
+ *
+ *   import { database } from "@sapiom/tools";              // ambient auth
+ *   const db = await database.create({ duration: "1h", handle: "analytics" });
+ *   db.connection?.connectionString;                      // a ready-to-use Postgres URI
+ *
+ *   const again = await database.get(db.id);              // or get("analytics") by handle
+ *   await database.delete(db.id);                         // or delete("analytics")
+ *
+ * Or via an explicit client: `createClient({ apiKey }).database.create(...)`.
+ *
+ * This is a provisioning surface, not a query layer: it hands you connection
+ * credentials and you run your own SQL with the client of your choice.
+ */
+const index_js_1 = require("../_client/index.js");
+const errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "DatabaseHttpError", { enumerable: true, get: function () { return errors_js_1.DatabaseHttpError; } });
+const DEFAULT_BASE_URL = process.env.SAPIOM_DATABASE_URL || "https://neon.services.sapiom.ai";
+/**
+ * Break a Postgres connection URI into its parts. `connectionString` is always
+ * preserved (it is the value you pass to a client); the parsed components are a
+ * convenience. If the URI can't be parsed, only `connectionString` is returned.
+ */
+function parseConnectionUri(uri) {
+    try {
+        const u = new URL(uri);
+        return {
+            connectionString: uri,
+            host: u.hostname,
+            port: u.port ? Number(u.port) : 5432,
+            username: decodeURIComponent(u.username),
+            password: decodeURIComponent(u.password),
+            databaseName: u.pathname.replace(/^\//, ""),
+            sslmode: u.searchParams.get("sslmode") ?? undefined,
+        };
+    }
+    catch {
+        return { connectionString: uri };
+    }
+}
+function mapDatabase(raw) {
+    return {
+        id: raw.id,
+        handle: raw.handle,
+        name: raw.name,
+        description: raw.description,
+        status: raw.status,
+        region: raw.region,
+        pgVersion: raw.pgVersion,
+        duration: raw.duration,
+        connection: raw.connectionUri == null ? null : parseConnectionUri(raw.connectionUri),
+        expiresAt: raw.expiresAt,
+        createdAt: raw.createdAt,
+    };
+}
+// ----- Capability operations -----
+/**
+ * Provision a new Postgres database. `duration` is required. Returns the database
+ * with connection credentials in `connection`. Failed requests throw
+ * {@link DatabaseHttpError}.
+ */
+async function create(input, transport = (0, index_js_1.defaultTransport)(), baseUrl = DEFAULT_BASE_URL) {
+    if (!input.duration) {
+        throw new errors_js_1.DatabaseHttpError("duration is required", 400, {
+            message: "duration is required",
+        });
+    }
+    const body = { duration: input.duration };
+    if (input.handle !== undefined)
+        body.handle = input.handle;
+    if (input.name !== undefined)
+        body.name = input.name;
+    if (input.description !== undefined)
+        body.description = input.description;
+    if (input.region !== undefined)
+        body.region = input.region;
+    if (input.pgVersion !== undefined)
+        body.pgVersion = input.pgVersion;
+    const res = await (0, errors_js_1.ensureOk)(await transport.fetch(`${baseUrl}/v1/databases`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body),
+    }), "Failed to create database");
+    return mapDatabase((await res.json()));
+}
+/** Retrieve a database by its id or handle. */
+async function get(idOrHandle, transport = (0, index_js_1.defaultTransport)(), baseUrl = DEFAULT_BASE_URL) {
+    const res = await (0, errors_js_1.ensureOk)(await transport.fetch(`${baseUrl}/v1/databases/${encodeURIComponent(idOrHandle)}`), `Failed to get database '${idOrHandle}'`);
+    return mapDatabase((await res.json()));
+}
+/**
+ * Delete a database by its id or handle. Exported as `delete`:
+ * `import { database } from "@sapiom/tools"; await database.delete(id)`.
+ */
+async function deleteDatabase(idOrHandle, transport = (0, index_js_1.defaultTransport)(), baseUrl = DEFAULT_BASE_URL) {
+    const res = await transport.fetch(`${baseUrl}/v1/databases/${encodeURIComponent(idOrHandle)}`, { method: "DELETE" });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            parsed = text;
+        }
+        throw new errors_js_1.DatabaseHttpError(`Failed to delete database '${idOrHandle}': ${res.status} ${text}`, res.status, parsed);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/database/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/index.d.ts

@@ -31,6 +31,11 @@ export * as fileStorage from "./file-storage/index.js";
 export { FileStorageHttpError } from "./file-storage/index.js";
 export * as contentGeneration from "./content-generation/index.js";
 export { ContentGenerationHttpError } from "./content-generation/index.js";
+export { VIDEO_RESULT_SIGNAL } from "./content-generation/index.js";
+export type { VideoResultPayload } from "./content-generation/index.js";
+export { toVideoResumePayload } from "./content-generation/index.js";
 export * as search from "./search/index.js";
 export { SearchHttpError } from "./search/index.js";
+export * as database from "./database/index.js";
+export { DatabaseHttpError } from "./database/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIvE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,OAAO,KAAK,YAAY,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD,YAAY,EACV,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,oCAAoC,GACrC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAGzE,YAAY,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAE/E,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,iBAAiB,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIvE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,OAAO,KAAK,YAAY,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD,YAAY,EACV,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,oCAAoC,GACrC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAGzE,YAAY,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAE/E,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,iBAAiB,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAGpE,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/cjs/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SearchHttpError = exports.search = exports.ContentGenerationHttpError = exports.contentGeneration = exports.FileStorageHttpError = exports.fileStorage = exports.OrchestrationResultSchemaError = exports.orchestrationResultSchema = exports.ORCHESTRATIONS_RESULT_SIGNAL = exports.orchestrations = exports.EXECUTION_ENVIRONMENT_BLAXEL_SANDBOX = exports.toResumePayload = exports.CodingResultSchemaError = exports.codingResultSchema = exports.CODING_RESULT_SIGNAL = exports.agent = exports.Repository = exports.repositories = exports.Sandbox = exports.sandboxes = exports.createClientFromEnv = exports.createClient = void 0;
+exports.DatabaseHttpError = exports.database = exports.SearchHttpError = exports.search = exports.toVideoResumePayload = exports.VIDEO_RESULT_SIGNAL = exports.ContentGenerationHttpError = exports.contentGeneration = exports.FileStorageHttpError = exports.fileStorage = exports.OrchestrationResultSchemaError = exports.orchestrationResultSchema = exports.ORCHESTRATIONS_RESULT_SIGNAL = exports.orchestrations = exports.EXECUTION_ENVIRONMENT_BLAXEL_SANDBOX = exports.toResumePayload = exports.CodingResultSchemaError = exports.codingResultSchema = exports.CODING_RESULT_SIGNAL = exports.agent = exports.Repository = exports.repositories = exports.Sandbox = exports.sandboxes = exports.createClientFromEnv = exports.createClient = void 0;
 /**
  * `@sapiom/tools` — the typed Sapiom capability client.
  *
@@ -81,7 +81,16 @@ Object.defineProperty(exports, "FileStorageHttpError", { enumerable: true, get:
 exports.contentGeneration = __importStar(require("./content-generation/index.js"));
 var index_js_8 = require("./content-generation/index.js");
 Object.defineProperty(exports, "ContentGenerationHttpError", { enumerable: true, get: function () { return index_js_8.ContentGenerationHttpError; } });
+// Surfaced top-level for the static `pause: { signal }` decl on a workflow step.
+var index_js_9 = require("./content-generation/index.js");
+Object.defineProperty(exports, "VIDEO_RESULT_SIGNAL", { enumerable: true, get: function () { return index_js_9.VIDEO_RESULT_SIGNAL; } });
+// Map a live VideoGenerationResult to the wire shape the resumed step receives.
+var index_js_10 = require("./content-generation/index.js");
+Object.defineProperty(exports, "toVideoResumePayload", { enumerable: true, get: function () { return index_js_10.toVideoResumePayload; } });
 exports.search = __importStar(require("./search/index.js"));
-var index_js_9 = require("./search/index.js");
-Object.defineProperty(exports, "SearchHttpError", { enumerable: true, get: function () { return index_js_9.SearchHttpError; } });
+var index_js_11 = require("./search/index.js");
+Object.defineProperty(exports, "SearchHttpError", { enumerable: true, get: function () { return index_js_11.SearchHttpError; } });
+exports.database = __importStar(require("./database/index.js"));
+var index_js_12 = require("./database/index.js");
+Object.defineProperty(exports, "DatabaseHttpError", { enumerable: true, get: function () { return index_js_12.DatabaseHttpError; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;GAYG;AACH,yCAAgE;AAAvD,yGAAA,YAAY,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAQ1C,kEAAkD;AAClD,iDAA+C;AAAtC,mGAAA,OAAO,OAAA;AAEhB,wEAAwD;AACxD,oDAAqD;AAA5C,sGAAA,UAAU,OAAA;AAEnB,0DAA0C;AAC1C,iFAAiF;AACjF,6CAAwD;AAA/C,gHAAA,oBAAoB,OAAA;AAO7B,+EAA+E;AAC/E,2CAA2C;AAC3C,6CAK0B;AAJxB,8GAAA,kBAAkB,OAAA;AAClB,mHAAA,uBAAuB,OAAA;AACvB,2GAAA,eAAe,OAAA;AACf,gIAAA,oCAAoC,OAAA;AAGtC,4EAA4D;AAC5D,iFAAiF;AACjF,sDAAyE;AAAhE,wHAAA,4BAA4B,OAAA;AAIrC,oEAAoE;AACpE,sDAGmC;AAFjC,qHAAA,yBAAyB,OAAA;AACzB,0HAAA,8BAA8B,OAAA;AAGhC,uEAAuD;AACvD,oDAA+D;AAAtD,gHAAA,oBAAoB,OAAA;AAE7B,mFAAmE;AACnE,0DAA2E;AAAlE,sHAAA,0BAA0B,OAAA;AAEnC,4DAA4C;AAC5C,8CAAoD;AAA3C,2GAAA,eAAe,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;GAYG;AACH,yCAAgE;AAAvD,yGAAA,YAAY,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAQ1C,kEAAkD;AAClD,iDAA+C;AAAtC,mGAAA,OAAO,OAAA;AAEhB,wEAAwD;AACxD,oDAAqD;AAA5C,sGAAA,UAAU,OAAA;AAEnB,0DAA0C;AAC1C,iFAAiF;AACjF,6CAAwD;AAA/C,gHAAA,oBAAoB,OAAA;AAO7B,+EAA+E;AAC/E,2CAA2C;AAC3C,6CAK0B;AAJxB,8GAAA,kBAAkB,OAAA;AAClB,mHAAA,uBAAuB,OAAA;AACvB,2GAAA,eAAe,OAAA;AACf,gIAAA,oCAAoC,OAAA;AAGtC,4EAA4D;AAC5D,iFAAiF;AACjF,sDAAyE;AAAhE,wHAAA,4BAA4B,OAAA;AAIrC,oEAAoE;AACpE,sDAGmC;AAFjC,qHAAA,yBAAyB,OAAA;AACzB,0HAAA,8BAA8B,OAAA;AAGhC,uEAAuD;AACvD,oDAA+D;AAAtD,gHAAA,oBAAoB,OAAA;AAE7B,mFAAmE;AACnE,0DAA2E;AAAlE,sHAAA,0BAA0B,OAAA;AACnC,iFAAiF;AACjF,0DAAoE;AAA3D,+GAAA,mBAAmB,OAAA;AAI5B,gFAAgF;AAChF,2DAAqE;AAA5D,iHAAA,oBAAoB,OAAA;AAE7B,4DAA4C;AAC5C,+CAAoD;AAA3C,4GAAA,eAAe,OAAA;AAExB,gEAAgD;AAChD,iDAAwD;AAA/C,8GAAA,iBAAiB,OAAA"}

package/dist/cjs/search/index.d.ts

@@ -2,15 +2,19 @@
  * `search` capability — find information across the web and beyond.
  *
  * This is the home for Sapiom's search primitives: searching the web, reading the
- * contents of a page, and looking up professional email addresses. Today it
- * offers `webSearch` (search the web) and `scrape` (read a page); more operations
- * follow.
+ * contents of a page, and looking up professional email addresses. It offers
+ * `webSearch` (search the web), `scrape` (read a page), and `emailSearch` (find,
+ * verify, and discover professional email addresses); more operations follow.
  *
  *   import { search } from "@sapiom/tools";        // ambient auth
  *   const hits = await search.webSearch({ query: "what is an LLM agent?" });
  *   hits.answer;     // a synthesized answer
  *   const page = await search.scrape({ url: "https://example.com" });
  *   page.markdown;   // the page content as markdown
+ *   const found = await search.emailSearch.findEmail({
+ *     domain: "example.com", fullName: "Ada Lovelace",
+ *   });
+ *   found.email;     // the discovered email, or null when not found
  *
  * Or via an explicit client: `createClient({ apiKey }).search.webSearch(...)`.
  *
@@ -102,4 +106,129 @@ export interface WebSearchResponse {
  * Failed requests throw {@link SearchHttpError}.
  */
 export declare function webSearch(input: WebSearchInput, transport?: Transport, baseUrl?: string): Promise<WebSearchResponse>;
+export interface FindEmailInput {
+    /** Company domain to search at, e.g. `"example.com"`. Provide this or `company`. */
+    domain?: string;
+    /** Company name, as an alternative to `domain`. Provide this or `domain`. */
+    company?: string;
+    /** Person's first name. Provide with `lastName`, or use `fullName`. */
+    firstName?: string;
+    /** Person's last name. Provide with `firstName`, or use `fullName`. */
+    lastName?: string;
+    /** Person's full name, as an alternative to `firstName` + `lastName`. */
+    fullName?: string;
+}
+export interface FindEmailResult {
+    /** The discovered email address, or `null` when none was found. */
+    email: string | null;
+    /** Confidence score (0–100) that the email is correct. */
+    score?: number;
+    /** First name associated with the result. */
+    firstName?: string;
+    /** Last name associated with the result. */
+    lastName?: string;
+    /** Job title / position associated with the result. */
+    position?: string;
+    /** Company associated with the result. */
+    company?: string;
+    /** LinkedIn profile URL associated with the result. */
+    linkedinUrl?: string;
+    /** Deliverability verification for the discovered email, when available. */
+    verification?: {
+        status?: string;
+        date?: string;
+    };
+}
+/**
+ * Find a person's professional email address.
+ *
+ * You must provide enough to identify both the person and where they work:
+ * a `domain` OR `company`, AND either a `fullName` OR both `firstName` and
+ * `lastName`. Calling without a valid combination throws {@link SearchHttpError}
+ * before any request is made.
+ *
+ * Returns the best match, with `email` set to `null` when none was found. Failed
+ * requests throw {@link SearchHttpError}.
+ */
+export declare function findEmail(input: FindEmailInput, transport?: Transport, baseUrl?: string): Promise<FindEmailResult>;
+export interface VerifyEmailInput {
+    /** The email address to verify. */
+    email: string;
+}
+export interface VerifyEmailResult {
+    /** The email address that was verified (echoes the input). */
+    email: string;
+    /** Overall deliverability status. */
+    status?: string;
+    /** Verification result classification. */
+    result?: string;
+    /** Confidence score (0–100) in the verification. */
+    score?: number;
+    /** Whether the mail server accepted the address at the SMTP level. */
+    smtpCheck?: boolean;
+    /** Whether the domain accepts mail for any address (so a positive is weak). */
+    acceptAll?: boolean;
+    /** Whether the address belongs to a disposable email provider. */
+    disposable?: boolean;
+    /** Whether the address belongs to a public webmail provider. */
+    webmail?: boolean;
+}
+/**
+ * Verify that an email address is deliverable — returns a status, confidence
+ * score, SMTP/accept-all checks, and disposable/webmail flags. Use it before
+ * sending to avoid bounces.
+ *
+ * Failed requests throw {@link SearchHttpError}.
+ */
+export declare function verifyEmail(input: VerifyEmailInput, transport?: Transport, baseUrl?: string): Promise<VerifyEmailResult>;
+export interface DomainSearchInput {
+    /** Company domain to search, e.g. `"example.com"`. */
+    domain: string;
+    /** Maximum number of emails to return (max 100, default 10). */
+    limit?: number;
+    /** Filter by email type. */
+    type?: "personal" | "generic";
+    /** Filter to one or more seniority levels. */
+    seniority?: ("junior" | "senior" | "executive")[];
+    /** Filter to one or more departments (e.g. `"engineering"`, `"sales"`). */
+    department?: string[];
+}
+export interface DomainEmail {
+    /** The email address. */
+    email: string;
+    /** Email type (e.g. `"personal"` or `"generic"`). */
+    type?: string;
+    /** Confidence score (0–100) that the address is valid. */
+    confidence?: number;
+    /** First name associated with the address. */
+    firstName?: string;
+    /** Last name associated with the address. */
+    lastName?: string;
+    /** Job title / position associated with the address. */
+    position?: string;
+    /** Department associated with the address. */
+    department?: string;
+    /** Seniority level associated with the address. */
+    seniority?: string;
+}
+export interface DomainSearchResult {
+    /** The domain that was searched (echoes the input). */
+    domain: string;
+    /** The organization name for the domain, when known. */
+    organization?: string;
+    /** The detected email pattern for the domain (e.g. `"{first}.{last}"`). */
+    pattern?: string;
+    /** Whether the domain accepts mail for any address. */
+    acceptAll?: boolean;
+    /** The emails discovered at the domain. */
+    emails: DomainEmail[];
+}
+/**
+ * Discover the professional emails published at a company domain. Filter the
+ * results by `type`, `seniority`, and `department` to home in on the people you
+ * care about.
+ *
+ * Failed requests throw {@link SearchHttpError}.
+ */
+export declare function domainSearch(input: DomainSearchInput, transport?: Transport, baseUrl?: string): Promise<DomainSearchResult>;
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/search/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/search/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,SAAS,EAAoB,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAY,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,CAAC;AAU3B,sEAAsE;AACtE,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,MAAM,GACN,SAAS,GACT,YAAY,GACZ,OAAO,CAAC;AAEZ,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,+DAA+D;IAC/D,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAkED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAC1B,KAAK,EAAE,WAAW,EAClB,SAAS,GAAE,SAA8B,EACzC,OAAO,SAAmB,GACzB,OAAO,CAAC,YAAY,CAAC,CAkBvB;AAID,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,KAAK,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAyCD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,cAAc,EACrB,SAAS,GAAE,SAA8B,EACzC,OAAO,SAA8B,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAsB5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/search/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/search/index.js

@@ -3,19 +3,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SearchHttpError = void 0;
 exports.scrape = scrape;
 exports.webSearch = webSearch;
+exports.findEmail = findEmail;
+exports.verifyEmail = verifyEmail;
+exports.domainSearch = domainSearch;
 /**
  * `search` capability — find information across the web and beyond.
  *
  * This is the home for Sapiom's search primitives: searching the web, reading the
- * contents of a page, and looking up professional email addresses. Today it
- * offers `webSearch` (search the web) and `scrape` (read a page); more operations
- * follow.
+ * contents of a page, and looking up professional email addresses. It offers
+ * `webSearch` (search the web), `scrape` (read a page), and `emailSearch` (find,
+ * verify, and discover professional email addresses); more operations follow.
  *
  *   import { search } from "@sapiom/tools";        // ambient auth
  *   const hits = await search.webSearch({ query: "what is an LLM agent?" });
  *   hits.answer;     // a synthesized answer
  *   const page = await search.scrape({ url: "https://example.com" });
  *   page.markdown;   // the page content as markdown
+ *   const found = await search.emailSearch.findEmail({
+ *     domain: "example.com", fullName: "Ada Lovelace",
+ *   });
+ *   found.email;     // the discovered email, or null when not found
  *
  * Or via an explicit client: `createClient({ apiKey }).search.webSearch(...)`.
  *
@@ -26,6 +33,7 @@ const errors_js_1 = require("./errors.js");
 Object.defineProperty(exports, "SearchHttpError", { enumerable: true, get: function () { return errors_js_1.SearchHttpError; } });
 const DEFAULT_BASE_URL = process.env.SAPIOM_SCRAPE_URL || "https://firecrawl.services.sapiom.ai";
 const DEFAULT_WEB_SEARCH_BASE_URL = process.env.SAPIOM_SEARCH_URL || "https://api.sapiom.ai";
+const DEFAULT_EMAIL_SEARCH_BASE_URL = process.env.SAPIOM_EMAIL_SEARCH_URL || "https://hunter.services.sapiom.ai";
 /** Collapse a field that may be a single value or an array down to one value. */
 function firstOf(value) {
     return Array.isArray(value) ? value[0] : value;
@@ -126,4 +134,153 @@ async function webSearch(input, transport = (0, index_js_1.defaultTransport)(),
     }, { authHeader: "x-api-key" }), "Failed to search the web");
     return mapWebSearch(input.query, (await res.json()));
 }
+// ----- search.emailSearch -----
+//
+// Three operations for working with professional email addresses: find an email
+// for a known person, verify an address is deliverable, and discover the emails
+// published at a company domain.
+// ----- Shared request/response helpers -----
+/**
+ * Build a query string from a set of params. Skips any value that is null or
+ * undefined (so a JS caller passing an optional as `null` doesn't put `null` on
+ * the wire), and stringifies everything else.
+ */
+function toQuery(params) {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value != null)
+            search.set(key, String(value));
+    }
+    const qs = search.toString();
+    return qs ? `?${qs}` : "";
+}
+async function getEnvelope(transport, url, errorPrefix) {
+    const res = await (0, errors_js_1.ensureOk)(await transport.fetch(url, { method: "GET" }), errorPrefix);
+    const body = (await res.json());
+    return body.data;
+}
+function mapFindEmail(raw) {
+    const d = raw ?? {};
+    // `!= null` so fields that come back null (a miss) are treated as absent rather
+    // than surfaced as `field: null`.
+    return {
+        email: d.email != null ? d.email : null,
+        ...(d.score != null && { score: d.score }),
+        ...(d.first_name != null && { firstName: d.first_name }),
+        ...(d.last_name != null && { lastName: d.last_name }),
+        ...(d.position != null && { position: d.position }),
+        ...(d.company != null && { company: d.company }),
+        ...(d.linkedin_url != null && { linkedinUrl: d.linkedin_url }),
+        ...(d.verification != null && { verification: d.verification }),
+    };
+}
+/**
+ * Find a person's professional email address.
+ *
+ * You must provide enough to identify both the person and where they work:
+ * a `domain` OR `company`, AND either a `fullName` OR both `firstName` and
+ * `lastName`. Calling without a valid combination throws {@link SearchHttpError}
+ * before any request is made.
+ *
+ * Returns the best match, with `email` set to `null` when none was found. Failed
+ * requests throw {@link SearchHttpError}.
+ */
+async function findEmail(input, transport = (0, index_js_1.defaultTransport)(), baseUrl = DEFAULT_EMAIL_SEARCH_BASE_URL) {
+    // Guard the required combination client-side so an under-specified lookup fails
+    // fast and clearly, never as a confusing network round-trip. `!= null` plus a
+    // truthiness check rejects null/undefined/empty-string for JS callers.
+    const hasOrg = Boolean(input.domain) || Boolean(input.company);
+    const hasPerson = Boolean(input.fullName) ||
+        (Boolean(input.firstName) && Boolean(input.lastName));
+    if (!hasOrg || !hasPerson) {
+        throw new errors_js_1.SearchHttpError("findEmail requires (domain or company) and (fullName or firstName + lastName)", 400, undefined);
+    }
+    const query = toQuery({
+        domain: input.domain,
+        company: input.company,
+        first_name: input.firstName,
+        last_name: input.lastName,
+        full_name: input.fullName,
+    });
+    const data = await getEnvelope(transport, `${baseUrl}/v2/email-finder${query}`, "Failed to find email");
+    return mapFindEmail(data);
+}
+function mapVerifyEmail(email, raw) {
+    const d = raw ?? {};
+    return {
+        email: d.email ?? email,
+        ...(d.status != null && { status: d.status }),
+        ...(d.result != null && { result: d.result }),
+        ...(d.score != null && { score: d.score }),
+        ...(d.smtp_check != null && { smtpCheck: d.smtp_check }),
+        ...(d.accept_all != null && { acceptAll: d.accept_all }),
+        ...(d.disposable != null && { disposable: d.disposable }),
+        ...(d.webmail != null && { webmail: d.webmail }),
+    };
+}
+/**
+ * Verify that an email address is deliverable — returns a status, confidence
+ * score, SMTP/accept-all checks, and disposable/webmail flags. Use it before
+ * sending to avoid bounces.
+ *
+ * Failed requests throw {@link SearchHttpError}.
+ */
+async function verifyEmail(input, transport = (0, index_js_1.defaultTransport)(), baseUrl = DEFAULT_EMAIL_SEARCH_BASE_URL) {
+    if (!input.email) {
+        throw new errors_js_1.SearchHttpError("verifyEmail requires an email", 400, undefined);
+    }
+    const query = toQuery({ email: input.email });
+    const data = await getEnvelope(transport, `${baseUrl}/v2/email-verifier${query}`, "Failed to verify email");
+    return mapVerifyEmail(input.email, data);
+}
+function mapDomainEmail(raw) {
+    return {
+        email: raw.value ?? "",
+        ...(raw.type != null && { type: raw.type }),
+        ...(raw.confidence != null && { confidence: raw.confidence }),
+        ...(raw.first_name != null && { firstName: raw.first_name }),
+        ...(raw.last_name != null && { lastName: raw.last_name }),
+        ...(raw.position != null && { position: raw.position }),
+        ...(raw.department != null && { department: raw.department }),
+        ...(raw.seniority != null && { seniority: raw.seniority }),
+    };
+}
+function mapDomainSearch(domain, raw) {
+    const d = raw ?? {};
+    const emails = Array.isArray(d.emails) ? d.emails.map(mapDomainEmail) : [];
+    return {
+        domain: d.domain ?? domain,
+        ...(d.organization != null && { organization: d.organization }),
+        ...(d.pattern != null && { pattern: d.pattern }),
+        ...(d.accept_all != null && { acceptAll: d.accept_all }),
+        emails,
+    };
+}
+/**
+ * Discover the professional emails published at a company domain. Filter the
+ * results by `type`, `seniority`, and `department` to home in on the people you
+ * care about.
+ *
+ * Failed requests throw {@link SearchHttpError}.
+ */
+async function domainSearch(input, transport = (0, index_js_1.defaultTransport)(), baseUrl = DEFAULT_EMAIL_SEARCH_BASE_URL) {
+    if (!input.domain) {
+        throw new errors_js_1.SearchHttpError("domainSearch requires a domain", 400, undefined);
+    }
+    // Array filters travel as comma-separated values; an empty array becomes
+    // nothing on the wire (filtered by `toQuery`).
+    const query = toQuery({
+        domain: input.domain,
+        limit: input.limit,
+        type: input.type,
+        seniority: input.seniority != null && input.seniority.length > 0
+            ? input.seniority.join(",")
+            : undefined,
+        department: input.department != null && input.department.length > 0
+            ? input.department.join(",")
+            : undefined,
+    });
+    const data = await getEnvelope(transport, `${baseUrl}/v2/domain-search${query}`, "Failed to search domain");
+    return mapDomainSearch(input.domain, data);
+}
 //# sourceMappingURL=index.js.map