deepline 0.3.257 → 0.3.259

package/dist/bundling-sources/sdk/src/http.ts

@@ -32,6 +32,7 @@ import {
   TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
 } from '../../shared_libs/plays/tool-execution-error';
 import { SDK_API_CONTRACT, SDK_VERSION } from './version.js';
+import { apiErrorCodeFromResponse, apiErrorMessage } from './api-error';
 import type { LiveEventEnvelope } from './types.js';
 import { detectAgentRuntime, isCoworkLikeSandbox } from './agent-runtime.js';
 import { readSdkSkillsLocalVersion } from './skills-version.js';
@@ -987,13 +988,6 @@ function isMonitorRateLimitEnvelope(parsed: unknown): boolean {
   );
 }
 
-function apiErrorCodeFromResponse(parsed: unknown): string {
-  const response = asRecord(parsed);
-  const error = asRecord(response?.error);
-  const code = error?.code ?? response?.code;
-  return typeof code === 'string' ? code : 'API_ERROR';
-}
-
 function asRecord(value: unknown): Record<string, unknown> | null {
   return typeof value === 'object' && value !== null
     ? (value as Record<string, unknown>)
@@ -1052,33 +1046,6 @@ function detectHtmlErrorBody(
   };
 }
 
-function apiErrorMessage(parsed: unknown, status: number): string {
-  const errorValue =
-    typeof parsed === 'object' && parsed && 'error' in parsed
-      ? (parsed as Record<string, unknown>).error
-      : undefined;
-  if (typeof errorValue === 'string') {
-    return errorValue;
-  }
-  if (
-    errorValue &&
-    typeof errorValue === 'object' &&
-    'message' in errorValue &&
-    typeof (errorValue as Record<string, unknown>).message === 'string'
-  ) {
-    return (errorValue as Record<string, string>).message;
-  }
-  if (
-    typeof parsed === 'object' &&
-    parsed &&
-    'message' in parsed &&
-    typeof (parsed as Record<string, unknown>).message === 'string'
-  ) {
-    return (parsed as Record<string, string>).message;
-  }
-  return `HTTP ${status}`;
-}
-
 /** Parse the `Retry-After` header as milliseconds. Falls back to 5000ms. */
 function parseRetryAfter(response: Response): number {
   return parseOptionalRetryAfter(response) ?? 5000;

package/dist/bundling-sources/sdk/src/index.ts

@@ -5,6 +5,14 @@ export type {
   PlaySettingsResult,
   PlaySettingsPathsPage,
 } from '../../shared_libs/plays/settings-contract';
+export type {
+  PlayCronTriggerConfig,
+  PlayTriggerConfigUpdate,
+  PlayTriggerConfigUpdateResult,
+  PlayTriggerConfigView,
+  PlayWebhookAuthConfig,
+  PlayWebhookTriggerConfig,
+} from '../../shared_libs/plays/trigger-config-contract';
 /**
  * Deepline SDK — TypeScript client for the Deepline enrichment platform.
  *

package/dist/bundling-sources/sdk/src/plays/csv-data-input.ts

@@ -0,0 +1,139 @@
+/**
+ * Strict parse of a Play's CSV DATA input (the `csv` key, the row source).
+ * The CLI runs it on the local file before staging; the dashboard runs it on a
+ * dropped file before enabling Run. Same parser, same options, same errors.
+ *
+ * Kept apart from `./run-request` so the SDK client entrypoint does not carry
+ * the CSV parser. Browser-safe: uses csv-parse's self-contained browser build.
+ */
+import { parse as parseCsvSync } from 'csv-parse/browser/esm/sync';
+import { DeeplineError } from '../../../shared_libs/plays/tool-execution-error';
+
+export type CsvDataInputSource = {
+  /** Dotted path into the run input, for error messages. */
+  inputPath: string;
+  /** What the caller supplied: a CLI path or a dropped file's name. */
+  value: string;
+};
+
+export type ParsedCsvDataInput = {
+  /** Trimmed header names, in column order. */
+  headers: string[];
+  /** Trimmed data records, positional (one entry per header, ragged allowed). */
+  records: string[][];
+};
+
+/**
+ * STRICT validation of the play's CSV DATA input (the row source):
+ *
+ * - parses with `relax_quotes: false` so an unclosed/ragged quote is a LOUD
+ *   error naming the line/character (prod run 20260611t145823-710 swallowed an
+ *   entire `"https://...`-no-closing-quote row into one giant linkedin_url),
+ * - detects EXACT-after-trim duplicate header names (prod run
+ *   20260611t145821-917 had two `linkedin_url` columns; the second silently
+ *   won) — case-DIFFERENT duplicates are handled play-side and not rejected,
+ * - rejects a header-only CSV with zero data rows.
+ *
+ * Any violation throws a `DeeplineError` (code `PLAY_INPUT_FILE_PREFLIGHT`)
+ * before any staging or API call, so no run is created and nothing is billed.
+ */
+export function parseCsvDataInput(
+  source: CsvDataInputSource,
+  content: string,
+  options: {
+    /**
+     * Called after each parsed record (header included) with the running
+     * count. Observation only: it cannot change, drop, or reorder records.
+     * The dashboard's parser worker uses it to report row progress.
+     */
+    onRecord?: (recordCount: number) => void;
+  } = {},
+): ParsedCsvDataInput {
+  const onRecord = options.onRecord;
+  let recordCount = 0;
+  // Parse into an array-of-arrays so we can both surface quoting errors AND
+  // inspect the raw header row for duplicates. `columns: false` keeps every
+  // record positional; the first record is the header.
+  let records: string[][];
+  try {
+    records = parseCsvSync(content, {
+      bom: true,
+      columns: false,
+      skip_empty_lines: true,
+      relax_column_count: true,
+      // STRICT RFC quoting: an unclosed quote or ragged quoting is a hard
+      // error rather than being swallowed into one giant field.
+      relax_quotes: false,
+      trim: true,
+      ...(onRecord
+        ? {
+            on_record: (record: string[]) => {
+              recordCount += 1;
+              onRecord(recordCount);
+              return record;
+            },
+          }
+        : {}),
+    }) as string[][];
+  } catch (error) {
+    throw new DeeplineError(
+      `Input ${source.inputPath} could not be parsed as CSV (${source.value}): ${
+        error instanceof Error ? error.message : String(error)
+      }. This usually means an unclosed quote or ragged quoting. No run was created.`,
+      undefined,
+      'PLAY_INPUT_FILE_PREFLIGHT',
+      { inputPath: source.inputPath, path: source.value },
+    );
+  }
+
+  if (records.length === 0) {
+    // Nothing parsed at all: there is no header row to speak of either.
+    throw new DeeplineError(
+      `${source.value} is empty: it has no header row and no data rows. No run was created.`,
+      undefined,
+      'PLAY_INPUT_FILE_PREFLIGHT',
+      { inputPath: source.inputPath, path: source.value },
+    );
+  }
+
+  // Duplicate header detection (exact match after trim). Report both raw
+  // spellings and the 1-based column positions.
+  const header = records[0]!;
+  const seen = new Map<string, { index: number; raw: string }>();
+  for (let i = 0; i < header.length; i++) {
+    const raw = header[i] ?? '';
+    const name = raw.trim();
+    if (name.length === 0) continue;
+    const prior = seen.get(name);
+    if (prior) {
+      throw new DeeplineError(
+        `Input ${source.inputPath} (${source.value}) has a duplicate CSV header "${name}" (columns ${
+          prior.index + 1
+        } and ${i + 1}). The second column would silently overwrite the first. Rename one of them. No run was created.`,
+        undefined,
+        'PLAY_INPUT_FILE_PREFLIGHT',
+        {
+          inputPath: source.inputPath,
+          path: source.value,
+          duplicateHeader: name,
+          columns: [prior.index + 1, i + 1],
+          rawSpellings: [prior.raw, raw],
+        },
+      );
+    }
+    seen.set(name, { index: i, raw });
+  }
+
+  if (records.length - 1 < 1) {
+    throw new DeeplineError(
+      `${source.value} has a header row but no data rows. No run was created.`,
+      undefined,
+      'PLAY_INPUT_FILE_PREFLIGHT',
+      { inputPath: source.inputPath, path: source.value },
+    );
+  }
+  return {
+    headers: header.map((name) => name.trim()),
+    records: records.slice(1),
+  };
+}