newscatcher-catchall-sdk 1.3.1 → 1.4.0

package/dist/esm/api/types/EntityListResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/EntityResponse.d.mts

@@ -0,0 +1,20 @@
+import type * as CatchAllApi from "../index.mjs";
+export interface EntityResponse {
+    /** Unique identifier of the entity. */
+    id: string;
+    entity_type: CatchAllApi.EntityType;
+    /** Organization that owns this entity. */
+    organization_id: string;
+    /** Entity name. */
+    name: string;
+    /** Free-text description. */
+    description?: (string | null) | undefined;
+    additional_attributes?: CatchAllApi.AdditionalAttributes | undefined;
+    status: CatchAllApi.EntityStatus;
+    /** ID of the user who created this entity. */
+    created_by_user_id?: string | undefined;
+    /** ISO 8601 timestamp of when the entity was created. Returned without timezone offset (server-local time). */
+    created_at?: string | undefined;
+    /** ISO 8601 timestamp of when the entity was last updated. Returned without timezone offset (server-local time). */
+    updated_at?: string | undefined;
+}

package/dist/esm/api/types/EntityResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/EntitySortBy.d.mts

@@ -0,0 +1,7 @@
+/** Fields available for sorting entity list results. */
+export declare const EntitySortBy: {
+    readonly CreatedAt: "created_at";
+    readonly Name: "name";
+    readonly Status: "status";
+};
+export type EntitySortBy = (typeof EntitySortBy)[keyof typeof EntitySortBy];

package/dist/esm/api/types/EntitySortBy.mjs

@@ -0,0 +1,7 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Fields available for sorting entity list results. */
+export const EntitySortBy = {
+    CreatedAt: "created_at",
+    Name: "name",
+    Status: "status",
+};

package/dist/esm/api/types/EntityStatus.d.mts

@@ -0,0 +1,15 @@
+/**
+ * Processing status of an entity.
+ *
+ * - `pending`: Entity has been created and is queued for enrichment.
+ * - `enriching`: Enrichment is in progress.
+ * - `ready`: Enrichment complete — entity is indexed and ready for use in jobs.
+ * - `failed`: Enrichment failed. The entity may still be used but matching quality may be reduced.
+ */
+export declare const EntityStatus: {
+    readonly Pending: "pending";
+    readonly Enriching: "enriching";
+    readonly Ready: "ready";
+    readonly Failed: "failed";
+};
+export type EntityStatus = (typeof EntityStatus)[keyof typeof EntityStatus];

package/dist/esm/api/types/EntityStatus.mjs

@@ -0,0 +1,15 @@
+// This file was auto-generated by Fern from our API Definition.
+/**
+ * Processing status of an entity.
+ *
+ * - `pending`: Entity has been created and is queued for enrichment.
+ * - `enriching`: Enrichment is in progress.
+ * - `ready`: Enrichment complete — entity is indexed and ready for use in jobs.
+ * - `failed`: Enrichment failed. The entity may still be used but matching quality may be reduced.
+ */
+export const EntityStatus = {
+    Pending: "pending",
+    Enriching: "enriching",
+    Ready: "ready",
+    Failed: "failed",
+};

package/dist/esm/api/types/EntitySummary.d.mts

@@ -0,0 +1,18 @@
+import type * as CatchAllApi from "../index.mjs";
+/**
+ * Abbreviated entity object returned when listing entities within a
+ * dataset. Uses a flat `attributes` key rather than the nested
+ * `additional_attributes.company_attributes` structure used in
+ * standalone entity endpoints.
+ */
+export interface EntitySummary {
+    /** Unique identifier of the entity. */
+    id: string;
+    /** Entity name. */
+    name: string;
+    entity_type: CatchAllApi.EntityType;
+    status: CatchAllApi.EntityStatus;
+    /** Free-text description. */
+    description?: (string | null) | undefined;
+    attributes?: CatchAllApi.CompanyAttributes | undefined;
+}

package/dist/esm/api/types/EntitySummary.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/EntityType.d.mts

@@ -0,0 +1,11 @@
+/**
+ * The type of entity.
+ *
+ * - `company`: A company or organization (default).
+ * - `person`: An individual person.
+ */
+export declare const EntityType: {
+    readonly Company: "company";
+    readonly Person: "person";
+};
+export type EntityType = (typeof EntityType)[keyof typeof EntityType];

package/dist/esm/api/types/EntityType.mjs

@@ -0,0 +1,11 @@
+// This file was auto-generated by Fern from our API Definition.
+/**
+ * The type of entity.
+ *
+ * - `company`: A company or organization (default).
+ * - `person`: An individual person.
+ */
+export const EntityType = {
+    Company: "company",
+    Person: "person",
+};

package/dist/esm/api/types/EntityValidationErrorBody.d.mts

@@ -0,0 +1,16 @@
+/**
+ * Error body returned by entity endpoints for field-level validation
+ * failures. Uses a different structure from the standard `Error` schema
+ * (`{"detail": "..."}`) used elsewhere in the API.
+ */
+export interface EntityValidationErrorBody {
+    /**
+     * Human-readable description of all validation errors, including
+     * field path, failure message, and error type.
+     */
+    message: string;
+    /** HTTP status text. */
+    status: string;
+    /** HTTP status code. */
+    status_code: number;
+}

package/dist/esm/api/types/EntityValidationErrorBody.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/ManageEntitiesResponse.d.mts

@@ -0,0 +1,6 @@
+export interface ManageEntitiesResponse {
+    /** ID of the dataset that was modified. */
+    dataset_id: string;
+    /** Number of entities that were added or removed. */
+    affected_count: number;
+}

package/dist/esm/api/types/ManageEntitiesResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/MonitorRecord.d.mts

@@ -1,6 +1,7 @@
 import type * as CatchAllApi from "../index.mjs";
 /**
  * Record with monitor-specific metadata. Used in monitor results and webhook payloads.
+ *
  * Includes timestamps tracking when records were added and updated, and citations include job tracking.
  */
 export interface MonitorRecord extends CatchAllApi.BaseRecord {

package/dist/esm/api/types/Record_.d.mts

@@ -2,4 +2,9 @@ import type * as CatchAllApi from "../index.mjs";
 export interface Record_ extends CatchAllApi.BaseRecord {
     /** Source documents that were used to extract this record. */
     citations: CatchAllApi.Citation[];
+    /**
+     * Entities from the connected dataset that are relevant to this record.
+     * Only present when the job was submitted with `connected_dataset_ids`.
+     */
+    connected_entities?: CatchAllApi.ConnectedEntity[] | undefined;
 }

package/dist/esm/api/types/SkippedRow.d.mts

@@ -0,0 +1,13 @@
+/**
+ * Details about a CSV row that was skipped during processing.
+ */
+export interface SkippedRow {
+    /**
+     * 1-based row number in the CSV file (including the header row).
+     *
+     * A value of `3` means the third line of the file (second data row).
+     */
+    row: number;
+    /** Human-readable explanation of why the row was skipped. */
+    reason: string;
+}

package/dist/esm/api/types/SkippedRow.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/SortOrder.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Sort direction for list results.
+ *
+ * - `asc`: ascending (oldest or smallest first)
+ * - `desc`: descending (newest or largest first)
+ */
+export declare const SortOrder: {
+    readonly Asc: "asc";
+    readonly Desc: "desc";
+};
+export type SortOrder = (typeof SortOrder)[keyof typeof SortOrder];

package/dist/esm/api/types/SortOrder.mjs

@@ -0,0 +1,11 @@
+// This file was auto-generated by Fern from our API Definition.
+/**
+ * Sort direction for list results.
+ *
+ * - `asc`: ascending (oldest or smallest first)
+ * - `desc`: descending (newest or largest first)
+ */
+export const SortOrder = {
+    Asc: "asc",
+    Desc: "desc",
+};

package/dist/esm/api/types/UploadCsvToDatasetResponse.d.mts

@@ -0,0 +1,8 @@
+import type * as CatchAllApi from "../index.mjs";
+export interface UploadCsvToDatasetResponse {
+    /** ID of the dataset that was updated. */
+    dataset_id: string;
+    /** Number of new entities created from the CSV. */
+    entities_created: number;
+    validation_report: CatchAllApi.ValidationReport;
+}

package/dist/esm/api/types/UploadCsvToDatasetResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/ValidationReport.d.mts

@@ -0,0 +1,17 @@
+import type * as CatchAllApi from "../index.mjs";
+/**
+ * Summary of CSV processing results.
+ */
+export interface ValidationReport {
+    /**
+     * Total number of data rows in the uploaded CSV (excluding the
+     * header row).
+     */
+    total_rows: number;
+    /** Number of rows successfully processed into entities. */
+    valid_rows: number;
+    /** Number of rows skipped due to validation errors. */
+    skipped_count: number;
+    /** Details for each skipped row. */
+    skipped_rows: CatchAllApi.SkippedRow[];
+}

package/dist/esm/api/types/ValidationReport.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/index.d.mts

@@ -1,12 +1,34 @@
+export * from "./AdditionalAttributes.mjs";
 export * from "./BaseRecord.mjs";
 export * from "./Citation.mjs";
+export * from "./CompanyAttributes.mjs";
 export * from "./CompanyEnrichmentOutput.mjs";
+export * from "./ConnectedEntity.mjs";
 export * from "./Context.mjs";
 export * from "./ContinueResponseDto.mjs";
+export * from "./CreateDatasetCsvResponse.mjs";
+export * from "./CreateEntitiesBatchResponse.mjs";
+export * from "./CreateEntityRequest.mjs";
+export * from "./CreateEntityResponse.mjs";
 export * from "./CreateMonitorResponseDto.mjs";
+export * from "./DatasetEntityIdsRequest.mjs";
+export * from "./DatasetEntityListResponse.mjs";
+export * from "./DatasetListResponse.mjs";
+export * from "./DatasetResponse.mjs";
+export * from "./DatasetSortBy.mjs";
+export * from "./DatasetStatus.mjs";
+export * from "./DatasetStatusEntry.mjs";
+export * from "./DatasetStatusHistoryResponse.mjs";
 export * from "./EndDate.mjs";
 export * from "./EnrichmentSchema.mjs";
 export * from "./EnrichmentType.mjs";
+export * from "./EntityListResponse.mjs";
+export * from "./EntityResponse.mjs";
+export * from "./EntitySortBy.mjs";
+export * from "./EntityStatus.mjs";
+export * from "./EntitySummary.mjs";
+export * from "./EntityType.mjs";
+export * from "./EntityValidationErrorBody.mjs";
 export * from "./Error_.mjs";
 export * from "./GetPlanLimitsResponseDto.mjs";
 export * from "./InitializeResponseDto.mjs";
@@ -14,6 +36,7 @@ export * from "./JobStep.mjs";
 export * from "./Limit.mjs";
 export * from "./ListMonitorsResponseDto.mjs";
 export * from "./ListUserJobsResponseDto.mjs";
+export * from "./ManageEntitiesResponse.mjs";
 export * from "./MonitorCitation.mjs";
 export * from "./MonitorJobItem.mjs";
 export * from "./MonitorListItemDto.mjs";
@@ -25,13 +48,17 @@ export * from "./PullMonitorResponseDto.mjs";
 export * from "./Query.mjs";
 export * from "./Record_.mjs";
 export * from "./ReferenceJob.mjs";
+export * from "./SkippedRow.mjs";
+export * from "./SortOrder.mjs";
 export * from "./StartDate.mjs";
 export * from "./StatusResponseDto.mjs";
 export * from "./SubmitResponseDto.mjs";
 export * from "./UpdateMonitorResponseDto.mjs";
+export * from "./UploadCsvToDatasetResponse.mjs";
 export * from "./UserJob.mjs";
 export * from "./ValidationErrorDetail.mjs";
 export * from "./ValidationErrorResponse.mjs";
+export * from "./ValidationReport.mjs";
 export * from "./ValidatorSchema.mjs";
 export * from "./WebhookDto.mjs";
 export * from "./WebhookPayload.mjs";

package/dist/esm/api/types/index.mjs

@@ -1,12 +1,34 @@
+export * from "./AdditionalAttributes.mjs";
 export * from "./BaseRecord.mjs";
 export * from "./Citation.mjs";
+export * from "./CompanyAttributes.mjs";
 export * from "./CompanyEnrichmentOutput.mjs";
+export * from "./ConnectedEntity.mjs";
 export * from "./Context.mjs";
 export * from "./ContinueResponseDto.mjs";
+export * from "./CreateDatasetCsvResponse.mjs";
+export * from "./CreateEntitiesBatchResponse.mjs";
+export * from "./CreateEntityRequest.mjs";
+export * from "./CreateEntityResponse.mjs";
 export * from "./CreateMonitorResponseDto.mjs";
+export * from "./DatasetEntityIdsRequest.mjs";
+export * from "./DatasetEntityListResponse.mjs";
+export * from "./DatasetListResponse.mjs";
+export * from "./DatasetResponse.mjs";
+export * from "./DatasetSortBy.mjs";
+export * from "./DatasetStatus.mjs";
+export * from "./DatasetStatusEntry.mjs";
+export * from "./DatasetStatusHistoryResponse.mjs";
 export * from "./EndDate.mjs";
 export * from "./EnrichmentSchema.mjs";
 export * from "./EnrichmentType.mjs";
+export * from "./EntityListResponse.mjs";
+export * from "./EntityResponse.mjs";
+export * from "./EntitySortBy.mjs";
+export * from "./EntityStatus.mjs";
+export * from "./EntitySummary.mjs";
+export * from "./EntityType.mjs";
+export * from "./EntityValidationErrorBody.mjs";
 export * from "./Error_.mjs";
 export * from "./GetPlanLimitsResponseDto.mjs";
 export * from "./InitializeResponseDto.mjs";
@@ -14,6 +36,7 @@ export * from "./JobStep.mjs";
 export * from "./Limit.mjs";
 export * from "./ListMonitorsResponseDto.mjs";
 export * from "./ListUserJobsResponseDto.mjs";
+export * from "./ManageEntitiesResponse.mjs";
 export * from "./MonitorCitation.mjs";
 export * from "./MonitorJobItem.mjs";
 export * from "./MonitorListItemDto.mjs";
@@ -25,13 +48,17 @@ export * from "./PullMonitorResponseDto.mjs";
 export * from "./Query.mjs";
 export * from "./Record_.mjs";
 export * from "./ReferenceJob.mjs";
+export * from "./SkippedRow.mjs";
+export * from "./SortOrder.mjs";
 export * from "./StartDate.mjs";
 export * from "./StatusResponseDto.mjs";
 export * from "./SubmitResponseDto.mjs";
 export * from "./UpdateMonitorResponseDto.mjs";
+export * from "./UploadCsvToDatasetResponse.mjs";
 export * from "./UserJob.mjs";
 export * from "./ValidationErrorDetail.mjs";
 export * from "./ValidationErrorResponse.mjs";
+export * from "./ValidationReport.mjs";
 export * from "./ValidatorSchema.mjs";
 export * from "./WebhookDto.mjs";
 export * from "./WebhookPayload.mjs";

package/dist/esm/core/auth/BasicAuth.d.mts

@@ -1,6 +1,6 @@
 export interface BasicAuth {
-    username: string;
-    password: string;
+    username?: string;
+    password?: string;
 }
 export declare const BasicAuth: {
     toAuthorizationHeader: (basicAuth: BasicAuth | undefined) => string | undefined;

package/dist/esm/core/auth/BasicAuth.mjs

@@ -2,10 +2,16 @@ import { base64Decode, base64Encode } from "../base64.mjs";
 const BASIC_AUTH_HEADER_PREFIX = /^Basic /i;
 export const BasicAuth = {
     toAuthorizationHeader: (basicAuth) => {
+        var _a, _b;
         if (basicAuth == null) {
             return undefined;
         }
-        const token = base64Encode(`${basicAuth.username}:${basicAuth.password}`);
+        const username = (_a = basicAuth.username) !== null && _a !== void 0 ? _a : "";
+        const password = (_b = basicAuth.password) !== null && _b !== void 0 ? _b : "";
+        if (username === "" && password === "") {
+            return undefined;
+        }
+        const token = base64Encode(`${username}:${password}`);
         return `Basic ${token}`;
     },
     fromAuthorizationHeader: (header) => {

package/dist/esm/core/exports.d.mts

@@ -1 +1,2 @@
+export * from "./file/exports.mjs";
 export * from "./logging/exports.mjs";

package/dist/esm/core/exports.mjs

@@ -1 +1,2 @@
+export * from "./file/exports.mjs";
 export * from "./logging/exports.mjs";

package/dist/esm/core/fetcher/Fetcher.d.mts

@@ -38,10 +38,12 @@ export declare namespace Fetcher {
     }
     interface TimeoutError {
         reason: "timeout";
+        cause?: unknown;
     }
     interface UnknownError {
         reason: "unknown";
         errorMessage: string;
+        cause?: unknown;
     }
 }
 export declare function fetcherImpl<R = unknown>(args: Fetcher.Args): Promise<APIResponse<R, Fetcher.Error>>;

package/dist/esm/core/fetcher/Fetcher.mjs

@@ -257,6 +257,7 @@ export function fetcherImpl(args) {
                     error: {
                         reason: "unknown",
                         errorMessage: "The user aborted a request",
+                        cause: error,
                     },
                     rawResponse: abortRawResponse,
                 };
@@ -274,6 +275,7 @@ export function fetcherImpl(args) {
                     ok: false,
                     error: {
                         reason: "timeout",
+                        cause: error,
                     },
                     rawResponse: abortRawResponse,
                 };
@@ -292,6 +294,7 @@ export function fetcherImpl(args) {
                     error: {
                         reason: "unknown",
                         errorMessage: error.message,
+                        cause: error,
                     },
                     rawResponse: unknownRawResponse,
                 };
@@ -309,6 +312,7 @@ export function fetcherImpl(args) {
                 error: {
                     reason: "unknown",
                     errorMessage: toJson(error),
+                    cause: error,
                 },
                 rawResponse: unknownRawResponse,
             };

package/dist/esm/core/file/exports.d.mts

@@ -0,0 +1 @@
+export type { Uploadable } from "./types.mjs";

package/dist/esm/core/file/exports.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/file/file.d.mts

@@ -0,0 +1,10 @@
+import type { Uploadable } from "./types.mjs";
+export declare function toBinaryUploadRequest(file: Uploadable): Promise<{
+    body: Uploadable.FileLike;
+    headers?: Record<string, string>;
+}>;
+export declare function toMultipartDataPart(file: Uploadable): Promise<{
+    data: Uploadable.FileLike;
+    filename?: string;
+    contentType?: string;
+}>;