@pipe0/ops 0.0.1

package/dist/searches/schemas.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+export declare const SEARCH_IDS: readonly ["people:profiles:icypeas@1", "companies:profiles:icypeas@1", "people:profiles:clado@1", "people:profiles:clado@2", "people:employees:leadmagic@1", "companies:profiles:exa@1", "people:profiles:exa@1"];
+export declare const SearchIdSchema: z.ZodEnum<{
+    "people:profiles:icypeas@1": "people:profiles:icypeas@1";
+    "companies:profiles:icypeas@1": "companies:profiles:icypeas@1";
+    "people:profiles:clado@1": "people:profiles:clado@1";
+    "people:profiles:clado@2": "people:profiles:clado@2";
+    "people:employees:leadmagic@1": "people:employees:leadmagic@1";
+    "companies:profiles:exa@1": "companies:profiles:exa@1";
+    "people:profiles:exa@1": "people:profiles:exa@1";
+}>;
+export type SearchId = z.infer<typeof SearchIdSchema>;

package/dist/searches/searches-validator.d.ts

@@ -0,0 +1,5 @@
+import type { SearchPayload, SearchesValidationResult } from "./catalog/searches-catalog.js";
+import type { Search } from "./catalog/search.js";
+export declare function validateSearches(params: {
+    searches: SearchPayload[] | Search[];
+}): SearchesValidationResult;

package/dist/searches/types.d.ts

@@ -0,0 +1,17 @@
+import type { Search } from "./catalog/search.js";
+export type AnySearchConstructor = new (_config: any) => Search;
+export interface DedupConfig<FieldName extends string = string> {
+    default: {
+        input: {
+            fields: {
+                outputField: FieldName;
+            }[];
+        }[];
+    };
+}
+export type DedupStrategy = keyof DedupConfig;
+export type OutputFieldNames<Payload extends {
+    config: {
+        output_fields?: object;
+    };
+}> = keyof NonNullable<Payload["config"]["output_fields"]>;

package/dist/searches/utils/get-search-instances.d.ts

@@ -0,0 +1,3 @@
+import { Search } from "../catalog/search.js";
+import { type SearchPayload } from "../catalog/searches-catalog.js";
+export declare function getSearchInstances(searchOrInstances: SearchPayload[] | Search[]): Search[];

package/dist/searches/utils/index.d.ts

@@ -0,0 +1,2 @@
+import type { SearchId } from "../schemas.js";
+export declare function getSearchHashKey<T extends object>(searchId: SearchId, config: T): string;

package/dist/searches/utils/is-filters-empty.d.ts

@@ -0,0 +1 @@
+export declare function isFiltersEmpty<T extends object>(o: T): boolean;

package/dist/utils/catalog-tags.d.ts

@@ -0,0 +1,25 @@
+export declare const CATALOG_TAGS: {
+    readonly EMAIL: "Email";
+    readonly TEXT: "Text";
+    readonly CHAT: "Chat";
+    readonly PERSONAL_EMAIL: "Personal Email";
+    readonly NAMES: "Names";
+    readonly WORK_EMAIL: "Work Email";
+    readonly WATERFALL: "Waterfall";
+    readonly WEBSITE: "Website";
+    readonly SCRAPE: "Scrape";
+    readonly ADDRESS: "Address";
+    readonly NEWS: "News";
+    readonly LINKEDIN: "LinkedIn";
+    readonly FINANCIAL_DATA: "Financial Data";
+    readonly AI: "AI";
+    readonly PHONE: "Phone Number";
+    readonly NEW: "New";
+    readonly BETA: "Beta";
+    readonly PEOPLE_PROFILES: "People Profiles";
+    readonly COMPANY_PROFILES: "Company Profiles";
+    readonly JSON: "Json";
+    readonly FIELDS: "Fields";
+    readonly LOGIC: "Logic";
+    readonly DEPRECATED: "Deprecated ❌";
+};

package/dist/utils/catalog-utils.d.ts

@@ -0,0 +1,11 @@
+import type { PipeCatalogEntry } from "../pipes/catalog/pipes-catalog.js";
+import type { SearchCatalogEntry } from "../searches/catalog/searches-catalog.js";
+export type BillingMode = "always" | "onSuccess";
+/**
+ * Get starting price for pipe cost
+ *
+ * @param costPerResult
+ * @returns
+ */
+export declare function getLowestPipeCreditAmount(entry: PipeCatalogEntry): number;
+export declare function getLoweestSearchesCreditAmount(entry: SearchCatalogEntry): number;

package/dist/utils/clean-object.d.ts

@@ -0,0 +1 @@
+export declare function cleanObject(obj: unknown): any;

package/dist/utils/clean-url.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Simplified URL Cleaner
+ *
+ * Cleans URLs by:
+ * - Ensuring HTTPS protocol
+ * - Preserving valid subdomains (including www)
+ * - Removing query parameters and fragments
+ * - Removing path components
+ * - Validating domain structure
+ */
+/**
+ * Cleans a URL to its canonical form
+ *
+ * @param url The URL to clean
+ * @returns The cleaned URL with HTTPS and core domain
+ */
+export declare function cleanWebsiteUrl(url: string): string;
+/**
+ * Normalizes a URL while preserving the full path and structure
+ *
+ * @param url The URL to normalize
+ * @returns The normalized URL with proper protocol and preserved path/query/fragment
+ */
+export declare function cleanUrl(url: string): string;

package/dist/utils/connection-id.d.ts

@@ -0,0 +1,8 @@
+export declare function splitConnectionString(connection: string): {
+    provider: "pipe0" | "findymail" | "zerobounce" | "millionverifier" | "googlemaps" | "gemini" | "leadmagic" | "builtwith" | "perplexity" | "serper" | "icypeas" | "prospeo" | "clado" | "resend" | "slack" | "gmail" | "firecrawl" | "exa" | "openai";
+    id: string;
+};
+export declare function joinConnectionString(connection: {
+    id: string;
+    provider: string;
+}): string;

package/dist/utils/hasher.d.ts

@@ -0,0 +1,8 @@
+export declare class ObjectHasher {
+    /**
+     * Generate a reliable hash for an object
+     * Handles consistent serialization and hashing
+     */
+    static hashObject(obj: Record<string, any>): string;
+    private static normalizeObject;
+}

package/dist/utils/icons.d.ts

@@ -0,0 +1 @@
+export type IconKey = "school" | "user" | "location" | "language" | "brain" | "book" | "web" | "plug" | "money" | "office" | "job" | "search" | "output" | "input" | "mix" | "linkedin" | "text" | "workflow" | "letter" | "source";

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export declare function getMockAvatarUrl(): string;
+export declare function isEmptyValue(value: unknown): boolean;
+export declare function getBaseSearchName(searchId: string): string;

package/dist/utils/json-schema-utils.d.ts

@@ -0,0 +1,3 @@
+import type { JSONSchema } from "zod/v4/core";
+export declare function isValidJsonSchema(schema: JSONSchema.BaseSchema): boolean | Promise<unknown>;
+export declare function isJsonSchemaEmpty(schema: object): boolean;

package/dist/utils/pixelart.d.ts

@@ -0,0 +1,13 @@
+export declare const pixelArtMap: {
+    readonly company: "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/4a186c98-5aeb-4993-8220-23391c032100/catalogpreview";
+    readonly email: "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/0df5621f-b145-44cb-a0e5-6c48dee31200/catalogpreview";
+    readonly phone: "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/5339eb51-38f1-49a8-d792-5bd95023df00/catalogpreview";
+    readonly logic: "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/4fd584fd-183e-43ae-4abe-8ded517eb300/catalogpreview";
+    readonly json: "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/65d3dc9c-8a27-4ce5-4e36-e6ddaebe8300/catalogpreview";
+    readonly ai: "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/4e92717a-2445-4a46-2042-f594c3db1a00/catalogpreview";
+    readonly linkedin: "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/30d2bfd8-8f5a-44b8-2a56-00a95807b900/catalogpreview";
+    readonly web: "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/bc7a0217-c9db-4aee-352e-adc593183f00/catalogpreview";
+    readonly people: "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/bb67686e-3cf4-470d-5328-8aeaf5b9be00/catalogpreview";
+};
+export type PixelArtKey = keyof typeof pixelArtMap;
+export declare function getPixelArt(key: PixelArtKey): "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/4a186c98-5aeb-4993-8220-23391c032100/catalogpreview" | "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/0df5621f-b145-44cb-a0e5-6c48dee31200/catalogpreview" | "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/5339eb51-38f1-49a8-d792-5bd95023df00/catalogpreview" | "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/4fd584fd-183e-43ae-4abe-8ded517eb300/catalogpreview" | "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/65d3dc9c-8a27-4ce5-4e36-e6ddaebe8300/catalogpreview" | "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/4e92717a-2445-4a46-2042-f594c3db1a00/catalogpreview" | "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/30d2bfd8-8f5a-44b8-2a56-00a95807b900/catalogpreview" | "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/bc7a0217-c9db-4aee-352e-adc593183f00/catalogpreview" | "https://imagedelivery.net/3B3AWuP94-S3Ro5eEac6JA/bb67686e-3cf4-470d-5328-8aeaf5b9be00/catalogpreview";

package/dist/utils/schemas.d.ts

@@ -0,0 +1,113 @@
+import { z } from "zod";
+export declare const FieldNameSchema: z.ZodEnum<{
+    company_description: "company_description";
+    cleaned_company_name: "cleaned_company_name";
+    company_industry: "company_industry";
+    company_region: "company_region";
+    location_hint: "location_hint";
+    estimated_revenue: "estimated_revenue";
+    founded_year: "founded_year";
+    technology_list: "technology_list";
+    spending_trend: "spending_trend";
+    technology_match_builtwith: "technology_match_builtwith";
+    number_of_social_followers: "number_of_social_followers";
+    email: "email";
+    personal_email: "personal_email";
+    alternate_personal_emails: "alternate_personal_emails";
+    company_news_summary: "company_news_summary";
+    work_email: "work_email";
+    headcount: "headcount";
+    company_website_url: "company_website_url";
+    company_name: "company_name";
+    first_name: "first_name";
+    addressee_name: "addressee_name";
+    address_line_1: "address_line_1";
+    address_line_2: "address_line_2";
+    job_title: "job_title";
+    job_description: "job_description";
+    profile_headline: "profile_headline";
+    address_city: "address_city";
+    address_country: "address_country";
+    address_state: "address_state";
+    zip_code: "zip_code";
+    last_name: "last_name";
+    is_work_email: "is_work_email";
+    name: "name";
+    ip_address: "ip_address";
+    skills: "skills";
+    avatar_url: "avatar_url";
+    estimated_salary: "estimated_salary";
+    is_email_valid: "is_email_valid";
+    profile_url: "profile_url";
+    company_profile_url: "company_profile_url";
+    profile_posts: "profile_posts";
+    clado_person_match: "clado_person_match";
+    clado_person_match_v2: "clado_person_match_v2";
+    icypeas_person_match: "icypeas_person_match";
+    icypeas_company_match: "icypeas_company_match";
+    clado_person_profile: "clado_person_profile";
+    resend_email_success: "resend_email_success";
+    email_body: "email_body";
+    email_subject: "email_subject";
+    profile: "profile";
+    mobile: "mobile";
+    landline: "landline";
+    phone: "phone";
+    message: "message";
+    slack_message_success: "slack_message_success";
+    funding_history: "funding_history";
+    funding_total_usd: "funding_total_usd";
+    template_output: "template_output";
+    gmail_email_success: "gmail_email_success";
+    zerobounce_validation_status: "zerobounce_validation_status";
+    zerobounce_validation_match: "zerobounce_validation_match";
+    leadmagic_competitor_list: "leadmagic_competitor_list";
+    leadmagic_acquisition_history: "leadmagic_acquisition_history";
+    leadmagic_company_news_list: "leadmagic_company_news_list";
+    merge_result: "merge_result";
+    mapped_links: "mapped_links";
+    website_markdown: "website_markdown";
+    website_html: "website_html";
+    website_url: "website_url";
+    urls: "urls";
+    website_links: "website_links";
+    firecrawl_extract_result: "firecrawl_extract_result";
+    exa_match_evaluation: "exa_match_evaluation";
+    email_validation_status: "email_validation_status";
+    million_validation_match: "million_validation_match";
+    scrape_list_response: "scrape_list_response";
+    resend_contact_id: "resend_contact_id";
+    sheet_record_id: "sheet_record_id";
+    sheet_record_ids: "sheet_record_ids";
+    input_objects: "input_objects";
+    professional_profile_url: "professional_profile_url";
+    professional_profile: "professional_profile";
+    company_social_url: "company_social_url";
+    mobile_number: "mobile_number";
+}>;
+export type FieldName = z.infer<typeof FieldNameSchema>;
+export declare const ProviderNameSchema: z.ZodEnum<{
+    pipe0: "pipe0";
+    findymail: "findymail";
+    zerobounce: "zerobounce";
+    millionverifier: "millionverifier";
+    googlemaps: "googlemaps";
+    gemini: "gemini";
+    leadmagic: "leadmagic";
+    builtwith: "builtwith";
+    perplexity: "perplexity";
+    serper: "serper";
+    icypeas: "icypeas";
+    prospeo: "prospeo";
+    clado: "clado";
+    resend: "resend";
+    slack: "slack";
+    gmail: "gmail";
+    firecrawl: "firecrawl";
+    exa: "exa";
+    openai: "openai";
+}>;
+export type ProviderRateLimitOperation = "pipe0_logic" | "pipe0_generic" | "pipe0-sheet-operation" | "pipe0_scraper" | "findymail_generic" | "findymail_email_lookup" | "findymail_phone_lookup" | "dropcontact_generic" | "hunter_generic" | "zerobounce_generic" | "millionverifier_generic" | "googlemaps_generic" | "gemini_25_flash_preview" | "gemini_20_flash" | "leadmagic_company_search" | "leadmagic_email_lookup" | "leadmagic_email_to_b2b_profile" | "leadmagic_personal_email_finder" | "leadmagic_mobile_number_lookup" | "leadmagic_company_funding" | "contactout_generic" | "builtwith_generic" | "perplexity_generic" | "serper_search" | "clado_search_people" | "clado_contact_information" | "icypeas_scrape_profile" | "icypeas_lead_database" | "icypeas_company_database" | "icypeas_email_lookup" | "prospeo_phone_number_lookup" | "prospeo_social_profile_lookup" | "clado_social_profile_lookup" | "prospeo_email_lookup" | "resend_generic" | "slack_post_message" | "gmail_send_email" | "leadmagic_employee_finder" | "firecrawl_generic" | "firecrawl_map_requests" | "firecrawl_extract" | "exa_websets" | "openai_gpt-5" | "openai_gpt-5-mini";
+export type ProviderName = z.infer<typeof ProviderNameSchema>;
+export type ExternalProviderName = Exclude<ProviderName, "pipe0">;
+export type BillableOperation = "builtwith-get-financial-profile1" | "pipe0-get-company-identity" | "pipe0-get-company-news-summary" | "pipe0-get-company-overview" | "gemini-flash-latest-prompt" | "prospeo-get-work-email" | "leadmagic-get-work-email" | "icypeas-get-work-email" | "pipe0-get-website-url" | "pipe0-extract-json" | "pipe0-is-workemail-check" | "pipe0-join-name" | "pipe0-split-name" | "leadmagic-mobile-from-profile" | "leadmagic-mobile-from-workemail" | "prospeo-mobile-from-profile" | "clado-personal-email-from-profile" | "leadmagic-personal-email-from-profile" | "icypeas-get-professional-profile" | "prospeo-get-professional-profile" | "clado-get-professional-profile" | "leadmagic-profile-url-from-email" | "pipe0-get-profileurl-from-name" | "pipe0-split-name" | "zerobounce-validate-email" | "millionverifier-validate-email" | "builtwith-get-technology-stack" | "send-email-resend" | "gemini-flash-latest-write-email" | "gemini-flash-latest-write-message" | "openai-gpt-latest-write-message" | "openai-gpt-mini-latest-write-message" | "send-message-slack" | "findymail-get-work-email" | "findymail-mobile-from-profile" | "get-company-funding-leadmagic" | "template-fill" | "send-email-gmail" | "pipe0-field-or" | "firecrawl-website-scrape" | "firecrawl-list-url-scrape" | "firecrawl-website-extract" | "firecrawl-website-maplinks" | "openai-gpt-latest-write-email" | "openai-gpt-mini-latest-write-email" | "openai-gpt-latest-prompt" | "openai-gpt-mini-latest-prompt" | "contact-create-resend" | "sheets-append-pipe0" | "sheets-appendexpand-pipe0";

package/dist/utils/types.d.ts

@@ -0,0 +1,4 @@
+import type { ProviderName } from "./schemas.js";
+export type ProviderEntry = {
+    provider: ProviderName;
+};

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@pipe0/ops",
+  "version": "0.0.1",
+  "private": false,
+  "description": "",
+  "type": "module",
+  "author": "pipe0",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "keywords": [
+    "data enrichment",
+    "prospecting",
+    "company data",
+    "people data",
+    "sales technology",
+    "sales engineering"
+  ],
+  "exports": {
+    ".": {
+      "@pipezero/dev": "./src/index.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "provenance": false,
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "@asteasolutions/zod-to-openapi": "8.0.0",
+    "ajv": "^8.17.1",
+    "date-fns": "^4.1.0",
+    "immer": "^10.1.1",
+    "json-schema-traverse": "^1.0.0",
+    "json-schema-typed": "^8.0.1",
+    "lodash": "^4.17.21",
+    "openapi-fetch": "^0.13.4",
+    "xxhash-wasm": "^1.1.0",
+    "zod": "4.1.12"
+  },
+  "devDependencies": {
+    "@types/json-schema": "^7.0.15",
+    "@types/lodash": "^4.17.20",
+    "eslint": "^9.30.1",
+    "openapi-typescript": "^7.6.1",
+    "tsc-alias": "^1.8.10",
+    "typescript": "^5.8.0",
+    "vite": "npm:rolldown-vite@latest",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.7",
+    "@pipe0/eslint-config": "0.0.0"
+  },
+  "scripts": {
+    "dev": " tsc -b ./tsconfig.production.json --watch --noEmit",
+    "build": "rm -rf ./dist && vite build && pnpm run types",
+    "types": "tsc --emitDeclarationOnly -p ./tsconfig.production.json",
+    "test": "vitest run",
+    "lint": "eslint . && npx madge --circular ."
+  }
+}