databar 2.0.9__tar.gz → 2.2.0__tar.gz

{databar-2.0.9/src/databar.egg-info → databar-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: databar
-Version: 2.0.9
+Version: 2.2.0
 Summary: Official Databar.ai Python SDK and CLI — connect to enrichments, waterfalls, and tables via api.databar.ai
 Author-email: "Databar.ai Team" <info@databar.ai>
 License: MIT License
@@ -55,7 +55,7 @@ Dynamic: license-file
 
 # Databar Python SDK
 
-Official Python SDK and CLI for [Databar.ai](https://databar.ai) — run data enrichments, waterfall lookups, and manage tables via `api.databar.ai/v1`.
+Official Python SDK and CLI for [Databar.ai](https://databar.ai) — run data enrichments, waterfall lookups, flows, and manage tables via `api.databar.ai/v1`.
 
 [![PyPI](https://img.shields.io/pypi/v/databar-ai)](https://pypi.org/project/databar-ai/)
 [![Python](https://img.shields.io/pypi/pyversions/databar-ai)](https://pypi.org/project/databar-ai/)
@@ -132,6 +132,13 @@ enrichments = client.list_enrichments()
 # Search enrichments
 enrichments = client.list_enrichments(q="phone")
 
+# Paginated list (returns EnrichmentListResponse)
+page = client.list_enrichments(page=1, limit=50, category="Company Data")
+for e in page.items:
+    print(f"  [{e.id}] {e.name} — {e.price} credits")
+if page.has_next_page:
+    page2 = client.list_enrichments(page=2, limit=50)
+
 # Get full details (params, response fields)
 enrichment = client.get_enrichment(123)
 for param in enrichment.params:
@@ -144,7 +151,11 @@ data = client.poll_task(task.task_id)
 # Run single enrichment (sync convenience wrapper)
 data = client.run_enrichment_sync(123, {"email": "alice@example.com"})
 
-# Bulk run
+# Run with pagination (for list-style enrichments)
+data = client.run_enrichment_sync(123, {"query": "CEO"}, pages=3)
+
+# Bulk run — results are aligned to inputs: one element per input, in input
+# order, with None for inputs that returned no data (len(data) == len(inputs)).
 data = client.run_enrichment_bulk_sync(123, [
     {"email": "alice@example.com"},
     {"email": "bob@example.com"},
@@ -182,20 +193,48 @@ results = client.run_waterfall_bulk_sync(
 )
 ```
 
+### Flows
+
+```python
+# List saved flows
+flows = client.list_flows()
+
+# Inspect a flow's declared inputs
+flow = client.get_flow("flow-uuid")
+for inp in flow.inputs:
+    print(f"  {inp.id} (required={inp.required}): {inp.description}")
+
+# Run a flow (submit + poll in one call).
+# inputs maps each flow input id → value.
+result = client.run_flow_sync("flow-uuid", {"email": "alice@example.com"})
+
+# Or submit and poll manually
+task = client.run_flow("flow-uuid", {"email": "alice@example.com"})
+result = client.poll_task(task.task_id)
+```
+
 ### Tables
 
 ```python
-# List tables
+# List and manage tables
 tables = client.list_tables()
-
-# Create a table
 table = client.create_table(name="My Leads", columns=["email", "name", "company"])
+client.rename_table(table.identifier, "Leads 2026")
+client.delete_table(table.identifier)
 
-# Get columns
+# Columns
 columns = client.get_columns(table.identifier)
+col = client.create_column(table.identifier, "Phone", type="text")
+client.rename_column(table.identifier, col.identifier, "Mobile")
+client.delete_column(table.identifier, col.identifier)
 
-# Get rows (paginated)
+# Get rows with optional server-side filter
+import json
 data = client.get_rows(table.identifier, page=1, per_page=500)
+filtered = client.get_rows(
+    table.identifier,
+    filter=json.dumps({"company": {"contains": "OpenAI"}}),
+)
 
 # Insert rows (auto-batched at 50)
 from databar import InsertRow, InsertOptions, DedupeOptions
@@ -213,15 +252,112 @@ print(f"Created: {len([r for r in response.results if r.action == 'created'])}")
 
 # Update rows by UUID
 from databar import BatchUpdateRow
-
 rows = [BatchUpdateRow(id=row_id, fields={"name": "Updated Name"})]
-response = client.patch_rows(table.identifier, rows)
+client.patch_rows(table.identifier, rows)
 
 # Upsert rows by key column
 from databar import UpsertRow
-
 rows = [UpsertRow(key={"email": "alice@example.com"}, fields={"name": "Alice"})]
-response = client.upsert_rows(table.identifier, rows)
+client.upsert_rows(table.identifier, rows)
+
+# Delete specific rows
+client.delete_rows(table.identifier, ["row-uuid-1", "row-uuid-2"])
+```
+
+### Enrichments on tables
+
+```python
+# Add an enrichment (with column mapping)
+result = client.add_enrichment(
+    table.identifier,
+    enrichment_id=123,
+    mapping={
+        "email": {"type": "mapping", "value": "email_col"},   # from column
+        "country": {"type": "simple", "value": "US"},          # static value
+    },
+    launch_strategy="run_on_click",  # or "run_on_update"
+)
+print(f"Added enrichment #{result.id}: {result.enrichment_name}")
+
+# Run it (run_strategy: run_all | run_empty | run_errors)
+status = client.run_table_enrichment(
+    table.identifier,
+    enrichment_id=str(result.id),
+    run_strategy="run_empty",
+)
+print(f"Processing {status.processing_rows} rows")
+```
+
+### Waterfalls on tables
+
+```python
+# Add a waterfall
+wf = client.add_waterfall(
+    table.identifier,
+    waterfall_identifier="email_getter",
+    enrichments=[833, 966],
+    mapping={"first_name": "first_name", "company": "company"},
+    email_verifier=10,
+)
+print(f"Added waterfall #{wf.id}: {wf.waterfall_name}")
+
+# List installed waterfalls
+installed = client.get_table_waterfalls(table.identifier)
+
+# Run the waterfall
+client.run_table_enrichment(table.identifier, enrichment_id=str(wf.id))
+```
+
+### Exporters
+
+```python
+# List available exporters
+exporters = client.list_exporters()              # plain list
+page = client.list_exporters(page=1, limit=50)  # paginated envelope
+
+# Get exporter details (params, authorization info)
+detail = client.get_exporter(exporters[0].id)
+print(detail.params, detail.authorization.required)
+
+# Add an exporter to a table
+result = client.add_exporter(
+    table.identifier,
+    exporter_id=detail.id,
+    mapping={"email": {"type": "mapping", "value": "email_col"}},
+)
+client.run_table_enrichment(table.identifier, enrichment_id=str(result.id))
+```
+
+### Connectors
+
+```python
+# Create a custom HTTP API connector
+connector = client.create_connector(
+    name="My Scoring API",
+    method="post",
+    url="https://api.example.com/v1/score",
+    headers=[{"name": "Authorization", "value": "Bearer sk-xxx"}],
+    body=[{"name": "domain", "value": ""}],
+    rate_limit=60,
+)
+
+# CRUD
+connectors = client.list_connectors()
+c = client.get_connector(connector.id)
+client.update_connector(connector.id, name="Updated API", method="post", url="https://...")
+client.delete_connector(connector.id)
+```
+
+### Folders
+
+```python
+# Organize tables in folders
+folder = client.create_folder("My Leads")
+folders = client.list_folders()
+client.rename_folder(folder.id, "Leads 2026")
+client.move_table_to_folder(table.identifier, folder_id=folder.id)
+client.move_table_to_folder(table.identifier)          # remove from folder
+client.delete_folder(folder.id)                        # tables move to root
 ```
 
 ### Error handling
@@ -312,6 +448,21 @@ databar waterfall run email_getter --params '{"linkedin_url": "https://linkedin.
 databar waterfall bulk email_getter --input leads.csv --out results.csv
 ```
 
+### Flows
+
+```bash
+# List saved flows
+databar flow list
+databar flow list --query "buyer"
+
+# Get flow details (declared inputs)
+databar flow get <flow-id>
+
+# Run a flow (--inputs maps each flow input id → value)
+databar flow run <flow-id> --inputs '{"email": "alice@example.com"}'
+databar flow run <flow-id> --inputs '{"email": "alice@example.com"}' --format json
+```
+
 ### Tables
 
 ```bash

{databar-2.0.9 → databar-2.2.0}/README.md

@@ -1,6 +1,6 @@
 # Databar Python SDK
 
-Official Python SDK and CLI for [Databar.ai](https://databar.ai) — run data enrichments, waterfall lookups, and manage tables via `api.databar.ai/v1`.
+Official Python SDK and CLI for [Databar.ai](https://databar.ai) — run data enrichments, waterfall lookups, flows, and manage tables via `api.databar.ai/v1`.
 
 [![PyPI](https://img.shields.io/pypi/v/databar-ai)](https://pypi.org/project/databar-ai/)
 [![Python](https://img.shields.io/pypi/pyversions/databar-ai)](https://pypi.org/project/databar-ai/)
@@ -77,6 +77,13 @@ enrichments = client.list_enrichments()
 # Search enrichments
 enrichments = client.list_enrichments(q="phone")
 
+# Paginated list (returns EnrichmentListResponse)
+page = client.list_enrichments(page=1, limit=50, category="Company Data")
+for e in page.items:
+    print(f"  [{e.id}] {e.name} — {e.price} credits")
+if page.has_next_page:
+    page2 = client.list_enrichments(page=2, limit=50)
+
 # Get full details (params, response fields)
 enrichment = client.get_enrichment(123)
 for param in enrichment.params:
@@ -89,7 +96,11 @@ data = client.poll_task(task.task_id)
 # Run single enrichment (sync convenience wrapper)
 data = client.run_enrichment_sync(123, {"email": "alice@example.com"})
 
-# Bulk run
+# Run with pagination (for list-style enrichments)
+data = client.run_enrichment_sync(123, {"query": "CEO"}, pages=3)
+
+# Bulk run — results are aligned to inputs: one element per input, in input
+# order, with None for inputs that returned no data (len(data) == len(inputs)).
 data = client.run_enrichment_bulk_sync(123, [
     {"email": "alice@example.com"},
     {"email": "bob@example.com"},
@@ -127,20 +138,48 @@ results = client.run_waterfall_bulk_sync(
 )
 ```
 
+### Flows
+
+```python
+# List saved flows
+flows = client.list_flows()
+
+# Inspect a flow's declared inputs
+flow = client.get_flow("flow-uuid")
+for inp in flow.inputs:
+    print(f"  {inp.id} (required={inp.required}): {inp.description}")
+
+# Run a flow (submit + poll in one call).
+# inputs maps each flow input id → value.
+result = client.run_flow_sync("flow-uuid", {"email": "alice@example.com"})
+
+# Or submit and poll manually
+task = client.run_flow("flow-uuid", {"email": "alice@example.com"})
+result = client.poll_task(task.task_id)
+```
+
 ### Tables
 
 ```python
-# List tables
+# List and manage tables
 tables = client.list_tables()
-
-# Create a table
 table = client.create_table(name="My Leads", columns=["email", "name", "company"])
+client.rename_table(table.identifier, "Leads 2026")
+client.delete_table(table.identifier)
 
-# Get columns
+# Columns
 columns = client.get_columns(table.identifier)
+col = client.create_column(table.identifier, "Phone", type="text")
+client.rename_column(table.identifier, col.identifier, "Mobile")
+client.delete_column(table.identifier, col.identifier)
 
-# Get rows (paginated)
+# Get rows with optional server-side filter
+import json
 data = client.get_rows(table.identifier, page=1, per_page=500)
+filtered = client.get_rows(
+    table.identifier,
+    filter=json.dumps({"company": {"contains": "OpenAI"}}),
+)
 
 # Insert rows (auto-batched at 50)
 from databar import InsertRow, InsertOptions, DedupeOptions
@@ -158,15 +197,112 @@ print(f"Created: {len([r for r in response.results if r.action == 'created'])}")
 
 # Update rows by UUID
 from databar import BatchUpdateRow
-
 rows = [BatchUpdateRow(id=row_id, fields={"name": "Updated Name"})]
-response = client.patch_rows(table.identifier, rows)
+client.patch_rows(table.identifier, rows)
 
 # Upsert rows by key column
 from databar import UpsertRow
-
 rows = [UpsertRow(key={"email": "alice@example.com"}, fields={"name": "Alice"})]
-response = client.upsert_rows(table.identifier, rows)
+client.upsert_rows(table.identifier, rows)
+
+# Delete specific rows
+client.delete_rows(table.identifier, ["row-uuid-1", "row-uuid-2"])
+```
+
+### Enrichments on tables
+
+```python
+# Add an enrichment (with column mapping)
+result = client.add_enrichment(
+    table.identifier,
+    enrichment_id=123,
+    mapping={
+        "email": {"type": "mapping", "value": "email_col"},   # from column
+        "country": {"type": "simple", "value": "US"},          # static value
+    },
+    launch_strategy="run_on_click",  # or "run_on_update"
+)
+print(f"Added enrichment #{result.id}: {result.enrichment_name}")
+
+# Run it (run_strategy: run_all | run_empty | run_errors)
+status = client.run_table_enrichment(
+    table.identifier,
+    enrichment_id=str(result.id),
+    run_strategy="run_empty",
+)
+print(f"Processing {status.processing_rows} rows")
+```
+
+### Waterfalls on tables
+
+```python
+# Add a waterfall
+wf = client.add_waterfall(
+    table.identifier,
+    waterfall_identifier="email_getter",
+    enrichments=[833, 966],
+    mapping={"first_name": "first_name", "company": "company"},
+    email_verifier=10,
+)
+print(f"Added waterfall #{wf.id}: {wf.waterfall_name}")
+
+# List installed waterfalls
+installed = client.get_table_waterfalls(table.identifier)
+
+# Run the waterfall
+client.run_table_enrichment(table.identifier, enrichment_id=str(wf.id))
+```
+
+### Exporters
+
+```python
+# List available exporters
+exporters = client.list_exporters()              # plain list
+page = client.list_exporters(page=1, limit=50)  # paginated envelope
+
+# Get exporter details (params, authorization info)
+detail = client.get_exporter(exporters[0].id)
+print(detail.params, detail.authorization.required)
+
+# Add an exporter to a table
+result = client.add_exporter(
+    table.identifier,
+    exporter_id=detail.id,
+    mapping={"email": {"type": "mapping", "value": "email_col"}},
+)
+client.run_table_enrichment(table.identifier, enrichment_id=str(result.id))
+```
+
+### Connectors
+
+```python
+# Create a custom HTTP API connector
+connector = client.create_connector(
+    name="My Scoring API",
+    method="post",
+    url="https://api.example.com/v1/score",
+    headers=[{"name": "Authorization", "value": "Bearer sk-xxx"}],
+    body=[{"name": "domain", "value": ""}],
+    rate_limit=60,
+)
+
+# CRUD
+connectors = client.list_connectors()
+c = client.get_connector(connector.id)
+client.update_connector(connector.id, name="Updated API", method="post", url="https://...")
+client.delete_connector(connector.id)
+```
+
+### Folders
+
+```python
+# Organize tables in folders
+folder = client.create_folder("My Leads")
+folders = client.list_folders()
+client.rename_folder(folder.id, "Leads 2026")
+client.move_table_to_folder(table.identifier, folder_id=folder.id)
+client.move_table_to_folder(table.identifier)          # remove from folder
+client.delete_folder(folder.id)                        # tables move to root
 ```
 
 ### Error handling
@@ -257,6 +393,21 @@ databar waterfall run email_getter --params '{"linkedin_url": "https://linkedin.
 databar waterfall bulk email_getter --input leads.csv --out results.csv
 ```
 
+### Flows
+
+```bash
+# List saved flows
+databar flow list
+databar flow list --query "buyer"
+
+# Get flow details (declared inputs)
+databar flow get <flow-id>
+
+# Run a flow (--inputs maps each flow input id → value)
+databar flow run <flow-id> --inputs '{"email": "alice@example.com"}'
+databar flow run <flow-id> --inputs '{"email": "alice@example.com"}' --format json
+```
+
 ### Tables
 
 ```bash

{databar-2.0.9 → databar-2.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "databar"
-version = "2.0.9"
+version = "2.2.0"
 description = "Official Databar.ai Python SDK and CLI — connect to enrichments, waterfalls, and tables via api.databar.ai"
 readme = "README.md"
 license = { file = "LICENSE" }

{databar-2.0.9 → databar-2.2.0}/src/databar/__init__.py

@@ -16,6 +16,11 @@ Quick start::
     # Work with tables
     tables = client.list_tables()
     rows = client.get_rows(tables[0].identifier)
+
+    # Manage exporters, connectors and folders
+    exporters = client.list_exporters()
+    folder = client.create_folder("My Leads")
+    client.move_table_to_folder(tables[0].identifier, folder.id)
 """
 
 from .client import DatabarClient
@@ -31,34 +36,70 @@ from .exceptions import (
     DatabarValidationError,
 )
 from .models import (
-    BatchInsertResponse,
-    BatchUpdateResponse,
-    BatchUpdateRow,
+    # Pricing / Category
+    PricingInfo,
+    CategoryInfo,
+    # User
+    User,
+    # Enrichments
     ChoiceItem,
     Choices,
-    ChoicesResponse,
-    Column,
-    DedupeOptions,
-    Enrichment,
     EnrichmentParam,
     EnrichmentResponseField,
+    PaginationInfo,
+    PaginationOptions,
     EnrichmentSummary,
-    InsertOptions,
-    InsertRow,
-    RowsResponse,
+    Enrichment,
+    EnrichmentListResponse,
+    ChoicesResponse,
+    # Tasks
     RunResponse,
-    Table,
-    TableEnrichment,
     TaskResponse,
     TaskStatus,
-    UpsertResponse,
-    UpsertRow,
-    User,
+    # Waterfalls
     Waterfall,
     WaterfallEnrichment,
+    # Flows
+    Flow,
+    FlowInput,
+    FlowOutput,
+    # Tables
+    Table,
+    Column,
+    CreateColumnResponse,
+    TableEnrichment,
+    AddEnrichmentResponse,
+    AddWaterfallResponse,
+    InstalledWaterfall,
+    AddExporterResponse,
+    InstalledExporter,
+    RunEnrichmentResponse,
+    # Rows
+    RowsResponse,
+    InsertRow,
+    InsertOptions,
+    DedupeOptions,
+    BatchInsertResponse,
+    BatchUpdateRow,
+    BatchUpdateResponse,
+    UpsertRow,
+    UpsertResponse,
+    # Exporters
+    Exporter,
+    ExporterListResponse,
+    ExporterParam,
+    ExporterResponseField,
+    Connection,
+    AuthorizationInfo,
+    ExporterDetail,
+    # Connectors
+    NameValue,
+    Connector,
+    # Folders
+    Folder,
 )
 
-__version__ = "2.0.9"
+__version__ = "2.2.0"
 __all__ = [
     "DatabarClient",
     # exceptions
@@ -71,23 +112,45 @@ __all__ = [
     "DatabarRateLimitError",
     "DatabarTaskFailedError",
     "DatabarTimeoutError",
-    # models
+    # pricing / category
+    "PricingInfo",
+    "CategoryInfo",
+    # user
     "User",
-    "Enrichment",
+    # enrichments
     "EnrichmentSummary",
+    "Enrichment",
+    "EnrichmentListResponse",
     "EnrichmentParam",
     "EnrichmentResponseField",
+    "PaginationInfo",
+    "PaginationOptions",
     "ChoiceItem",
     "Choices",
     "ChoicesResponse",
+    # tasks
     "RunResponse",
     "TaskResponse",
     "TaskStatus",
+    # waterfalls
     "Waterfall",
     "WaterfallEnrichment",
+    # flows
+    "Flow",
+    "FlowInput",
+    "FlowOutput",
+    # tables
     "Table",
     "Column",
+    "CreateColumnResponse",
     "TableEnrichment",
+    "AddEnrichmentResponse",
+    "AddWaterfallResponse",
+    "InstalledWaterfall",
+    "AddExporterResponse",
+    "InstalledExporter",
+    "RunEnrichmentResponse",
+    # rows
     "RowsResponse",
     "InsertRow",
     "InsertOptions",
@@ -97,4 +160,17 @@ __all__ = [
     "BatchUpdateResponse",
     "UpsertRow",
     "UpsertResponse",
+    # exporters
+    "Exporter",
+    "ExporterListResponse",
+    "ExporterParam",
+    "ExporterResponseField",
+    "Connection",
+    "AuthorizationInfo",
+    "ExporterDetail",
+    # connectors
+    "NameValue",
+    "Connector",
+    # folders
+    "Folder",
 ]

{databar-2.0.9 → databar-2.2.0}/src/databar/cli/_guide.py

@@ -128,6 +128,16 @@ databar waterfall run <identifier> --params '{"key": "value"}' --format json
 databar waterfall bulk <identifier> --input data.csv --out results.csv
 ```
 
+### Flows
+```bash
+databar flow list --format json
+databar flow get <flow-id> --format json                     # declared inputs
+databar flow run <flow-id> --inputs '{"input_id": "value"}' --format json
+```
+
+NOTE: `flow run` uses `--inputs` (maps each flow input id → value), NOT `--params`.
+See `flow get` for the list of declared inputs.
+
 ### Tables
 ```bash
 databar table list --format json
@@ -174,6 +184,13 @@ result = client.run_enrichment_sync(123, {"email": "alice@example.com"})
 result = client.run_waterfall_sync("email_getter", {"linkedin_url": "..."})
 # waterfall.identifier (also .slug) → slug like "email_getter"
 
+# Flows
+flows = client.list_flows()
+flow  = client.get_flow("flow-uuid")
+# flow.id (also .identifier) → flow UUID
+# flow.inputs[i].id → input key to use in the run inputs dict
+result = client.run_flow_sync("flow-uuid", {"email": "alice@example.com"})
+
 # Tables
 tables = client.list_tables()
 # table.identifier (also .id, .uuid) → UUID string
@@ -201,6 +218,7 @@ client.create_rows(table.identifier, [InsertRow(fields={"email": "alice@example.
 
 - `Table`: `.id`, `.uuid` → `.identifier`
 - `Waterfall`: `.slug` → `.identifier`
+- `Flow`: `.identifier` → `.id`
 - `EnrichmentParam`: `.slug` → `.name`, `.label` → `.description`, `.required` → `.is_required`
 - `EnrichmentResponseField`: `.slug` → `.name`
 

{databar-2.0.9 → databar-2.2.0}/src/databar/cli/app.py

@@ -10,7 +10,7 @@ import typer
 
 from databar import __version__
 
-from . import enrichments, tables, tasks, waterfalls
+from . import enrichments, flows, tables, tasks, waterfalls
 from ._auth import app as auth_app
 
 app = typer.Typer(
@@ -29,6 +29,7 @@ app.add_typer(auth_app, name=None)  # merged at root level
 # Subcommand groups
 app.add_typer(enrichments.app, name="enrich")
 app.add_typer(waterfalls.app, name="waterfall")
+app.add_typer(flows.app, name="flow")
 app.add_typer(tables.app, name="table")
 app.add_typer(tasks.app, name="task")