lakesync 0.1.0

package/dist/src-WZNPHANQ.js

@@ -0,0 +1,426 @@
+import {
+  BaseSourcePoller,
+  Err,
+  LakeSyncError,
+  Ok,
+  extractDelta
+} from "./chunk-ICNT7I3K.js";
+import "./chunk-7D4SUZUM.js";
+
+// ../connector-salesforce/src/errors.ts
+var SalesforceApiError = class extends LakeSyncError {
+  /** HTTP status code returned by Salesforce. */
+  statusCode;
+  /** Raw response body from Salesforce. */
+  responseBody;
+  constructor(statusCode, responseBody, cause) {
+    super(`Salesforce API error (${statusCode}): ${responseBody}`, "SALESFORCE_API_ERROR", cause);
+    this.statusCode = statusCode;
+    this.responseBody = responseBody;
+  }
+};
+var SalesforceAuthError = class extends LakeSyncError {
+  constructor(message, cause) {
+    super(message, "SALESFORCE_AUTH_ERROR", cause);
+  }
+};
+
+// ../connector-salesforce/src/client.ts
+var DEFAULT_API_VERSION = "v62.0";
+var MAX_RETRY_ATTEMPTS = 3;
+var DEFAULT_RETRY_AFTER_MS = 1e4;
+var SalesforceClient = class {
+  config;
+  apiVersion;
+  loginUrl;
+  accessToken = null;
+  instanceUrl;
+  constructor(config) {
+    this.config = config;
+    this.apiVersion = config.apiVersion ?? DEFAULT_API_VERSION;
+    this.loginUrl = config.isSandbox ? "https://test.salesforce.com" : "https://login.salesforce.com";
+    this.instanceUrl = config.instanceUrl;
+  }
+  /**
+   * Authenticate via OAuth 2.0 Username-Password flow.
+   *
+   * Stores access token and updates instance URL from the response.
+   */
+  async authenticate() {
+    const body = new URLSearchParams({
+      grant_type: "password",
+      client_id: this.config.clientId,
+      client_secret: this.config.clientSecret,
+      username: this.config.username,
+      password: this.config.password
+    });
+    let response;
+    try {
+      response = await fetch(`${this.loginUrl}/services/oauth2/token`, {
+        method: "POST",
+        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        body: body.toString()
+      });
+    } catch (err) {
+      return Err(
+        new SalesforceAuthError(
+          `Failed to connect to Salesforce auth endpoint: ${err instanceof Error ? err.message : String(err)}`,
+          err instanceof Error ? err : void 0
+        )
+      );
+    }
+    if (!response.ok) {
+      const text = await response.text();
+      return Err(
+        new SalesforceAuthError(`Salesforce authentication failed (${response.status}): ${text}`)
+      );
+    }
+    const data = await response.json();
+    this.accessToken = data.access_token;
+    this.instanceUrl = data.instance_url;
+    return Ok(void 0);
+  }
+  /**
+   * Execute a SOQL query with auto-pagination.
+   *
+   * Automatically authenticates on first call and re-authenticates on 401.
+   */
+  async query(soql) {
+    if (!this.accessToken) {
+      const authResult = await this.authenticate();
+      if (!authResult.ok) return authResult;
+    }
+    const allRecords = [];
+    let url = `${this.instanceUrl}/services/data/${this.apiVersion}/query?q=${encodeURIComponent(soql)}`;
+    while (true) {
+      const result = await this.request(url);
+      if (!result.ok && result.error instanceof SalesforceApiError && result.error.statusCode === 401) {
+        const authResult = await this.authenticate();
+        if (!authResult.ok) return authResult;
+        const retryResult = await this.request(url);
+        if (!retryResult.ok) return retryResult;
+        for (const record of retryResult.value.records) {
+          allRecords.push(record);
+        }
+        if (retryResult.value.done || !retryResult.value.nextRecordsUrl) break;
+        url = `${this.instanceUrl}${retryResult.value.nextRecordsUrl}`;
+        continue;
+      }
+      if (!result.ok) return result;
+      for (const record of result.value.records) {
+        allRecords.push(record);
+      }
+      if (result.value.done || !result.value.nextRecordsUrl) break;
+      url = `${this.instanceUrl}${result.value.nextRecordsUrl}`;
+    }
+    return Ok(allRecords);
+  }
+  // -----------------------------------------------------------------------
+  // Internal HTTP helpers
+  // -----------------------------------------------------------------------
+  /** Make an HTTP request with rate-limit retry logic. */
+  async request(url) {
+    for (let attempt = 0; attempt <= MAX_RETRY_ATTEMPTS; attempt++) {
+      const headers = {
+        Authorization: `Bearer ${this.accessToken}`,
+        Accept: "application/json"
+      };
+      const response = await fetch(url, { method: "GET", headers });
+      if (response.ok) {
+        const data = await response.json();
+        return Ok(data);
+      }
+      if (response.status === 503) {
+        const retryAfter = response.headers.get("Retry-After");
+        const waitMs = retryAfter ? Number.parseInt(retryAfter, 10) * 1e3 : DEFAULT_RETRY_AFTER_MS;
+        if (attempt < MAX_RETRY_ATTEMPTS) {
+          await sleep(waitMs);
+          continue;
+        }
+        const responseBody2 = await response.text();
+        return Err(new SalesforceApiError(503, responseBody2));
+      }
+      const responseBody = await response.text();
+      return Err(new SalesforceApiError(response.status, responseBody));
+    }
+    return Err(new SalesforceApiError(0, "Unknown error after retries"));
+  }
+};
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// ../connector-salesforce/src/mapping.ts
+function mapAccount(account) {
+  return {
+    rowId: account.Id,
+    row: {
+      sf_id: account.Id,
+      name: account.Name ?? null,
+      type: account.Type ?? null,
+      industry: account.Industry ?? null,
+      website: account.Website ?? null,
+      phone: account.Phone ?? null,
+      billing_city: account.BillingCity ?? null,
+      billing_state: account.BillingState ?? null,
+      billing_country: account.BillingCountry ?? null,
+      annual_revenue: account.AnnualRevenue ?? null,
+      number_of_employees: account.NumberOfEmployees ?? null,
+      owner_name: account.Owner?.Name ?? null,
+      created_date: account.CreatedDate ?? null,
+      last_modified_date: account.LastModifiedDate ?? null
+    }
+  };
+}
+function mapContact(contact) {
+  return {
+    rowId: contact.Id,
+    row: {
+      sf_id: contact.Id,
+      first_name: contact.FirstName ?? null,
+      last_name: contact.LastName ?? null,
+      email: contact.Email ?? null,
+      phone: contact.Phone ?? null,
+      title: contact.Title ?? null,
+      account_id: contact.AccountId ?? null,
+      account_name: contact.Account?.Name ?? null,
+      mailing_city: contact.MailingCity ?? null,
+      mailing_state: contact.MailingState ?? null,
+      mailing_country: contact.MailingCountry ?? null,
+      owner_name: contact.Owner?.Name ?? null,
+      created_date: contact.CreatedDate ?? null,
+      last_modified_date: contact.LastModifiedDate ?? null
+    }
+  };
+}
+function mapOpportunity(opportunity) {
+  return {
+    rowId: opportunity.Id,
+    row: {
+      sf_id: opportunity.Id,
+      name: opportunity.Name ?? null,
+      stage_name: opportunity.StageName ?? null,
+      amount: opportunity.Amount ?? null,
+      close_date: opportunity.CloseDate ?? null,
+      probability: opportunity.Probability ?? null,
+      account_id: opportunity.AccountId ?? null,
+      account_name: opportunity.Account?.Name ?? null,
+      type: opportunity.Type ?? null,
+      lead_source: opportunity.LeadSource ?? null,
+      is_closed: opportunity.IsClosed ?? null,
+      is_won: opportunity.IsWon ?? null,
+      owner_name: opportunity.Owner?.Name ?? null,
+      created_date: opportunity.CreatedDate ?? null,
+      last_modified_date: opportunity.LastModifiedDate ?? null
+    }
+  };
+}
+function mapLead(lead) {
+  return {
+    rowId: lead.Id,
+    row: {
+      sf_id: lead.Id,
+      first_name: lead.FirstName ?? null,
+      last_name: lead.LastName ?? null,
+      company: lead.Company ?? null,
+      email: lead.Email ?? null,
+      phone: lead.Phone ?? null,
+      title: lead.Title ?? null,
+      status: lead.Status ?? null,
+      lead_source: lead.LeadSource ?? null,
+      is_converted: lead.IsConverted ?? null,
+      converted_account_id: lead.ConvertedAccountId ?? null,
+      converted_contact_id: lead.ConvertedContactId ?? null,
+      converted_opportunity_id: lead.ConvertedOpportunityId ?? null,
+      owner_name: lead.Owner?.Name ?? null,
+      created_date: lead.CreatedDate ?? null,
+      last_modified_date: lead.LastModifiedDate ?? null
+    }
+  };
+}
+
+// ../connector-salesforce/src/poller.ts
+var DEFAULT_INTERVAL_MS = 3e4;
+var ACCOUNT_FIELDS = [
+  "Id",
+  "Name",
+  "Type",
+  "Industry",
+  "Website",
+  "Phone",
+  "BillingCity",
+  "BillingState",
+  "BillingCountry",
+  "AnnualRevenue",
+  "NumberOfEmployees",
+  "Owner.Name",
+  "CreatedDate",
+  "LastModifiedDate"
+].join(", ");
+var CONTACT_FIELDS = [
+  "Id",
+  "FirstName",
+  "LastName",
+  "Email",
+  "Phone",
+  "Title",
+  "AccountId",
+  "Account.Name",
+  "MailingCity",
+  "MailingState",
+  "MailingCountry",
+  "Owner.Name",
+  "CreatedDate",
+  "LastModifiedDate"
+].join(", ");
+var OPPORTUNITY_FIELDS = [
+  "Id",
+  "Name",
+  "StageName",
+  "Amount",
+  "CloseDate",
+  "Probability",
+  "AccountId",
+  "Account.Name",
+  "Type",
+  "LeadSource",
+  "IsClosed",
+  "IsWon",
+  "Owner.Name",
+  "CreatedDate",
+  "LastModifiedDate"
+].join(", ");
+var LEAD_FIELDS = [
+  "Id",
+  "FirstName",
+  "LastName",
+  "Company",
+  "Email",
+  "Phone",
+  "Title",
+  "Status",
+  "LeadSource",
+  "IsConverted",
+  "ConvertedAccountId",
+  "ConvertedContactId",
+  "ConvertedOpportunityId",
+  "Owner.Name",
+  "CreatedDate",
+  "LastModifiedDate"
+].join(", ");
+var SalesforceSourcePoller = class extends BaseSourcePoller {
+  connectionConfig;
+  client;
+  /** Per-entity cursors: max LastModifiedDate from the last poll. */
+  cursors = {
+    accounts: void 0,
+    contacts: void 0,
+    opportunities: void 0,
+    leads: void 0
+  };
+  constructor(connectionConfig, ingestConfig, name, gateway, client) {
+    super({
+      name,
+      intervalMs: ingestConfig?.intervalMs ?? DEFAULT_INTERVAL_MS,
+      gateway,
+      memory: {
+        chunkSize: ingestConfig?.chunkSize,
+        memoryBudgetBytes: ingestConfig?.memoryBudgetBytes
+      }
+    });
+    this.connectionConfig = connectionConfig;
+    this.client = client ?? new SalesforceClient(connectionConfig);
+  }
+  /** Execute a single poll cycle across all enabled entity types. */
+  async poll() {
+    const includeAccounts = this.connectionConfig.includeAccounts ?? true;
+    if (includeAccounts) {
+      await this.pollEntity(
+        "Account",
+        ACCOUNT_FIELDS,
+        "accounts",
+        "sf_accounts",
+        mapAccount
+      );
+    }
+    const includeContacts = this.connectionConfig.includeContacts ?? true;
+    if (includeContacts) {
+      await this.pollEntity(
+        "Contact",
+        CONTACT_FIELDS,
+        "contacts",
+        "sf_contacts",
+        mapContact
+      );
+    }
+    const includeOpportunities = this.connectionConfig.includeOpportunities ?? true;
+    if (includeOpportunities) {
+      await this.pollEntity(
+        "Opportunity",
+        OPPORTUNITY_FIELDS,
+        "opportunities",
+        "sf_opportunities",
+        mapOpportunity
+      );
+    }
+    const includeLeads = this.connectionConfig.includeLeads ?? true;
+    if (includeLeads) {
+      await this.pollEntity("Lead", LEAD_FIELDS, "leads", "sf_leads", mapLead);
+    }
+    await this.flushAccumulator();
+  }
+  // -----------------------------------------------------------------------
+  // Generic entity polling via LastModifiedDate cursor
+  // -----------------------------------------------------------------------
+  async pollEntity(sObjectType, fields, cursorKey, table, mapFn) {
+    const cursor = this.cursors[cursorKey];
+    const soql = this.buildSoql(sObjectType, fields, cursor);
+    const result = await this.client.query(soql);
+    if (!result.ok) return;
+    const records = result.value;
+    if (records.length === 0) return;
+    let maxLastModified = cursor;
+    for (const record of records) {
+      const { rowId, row } = mapFn(record);
+      const delta = await extractDelta(null, row, {
+        table,
+        rowId,
+        clientId: this.clientId,
+        hlc: this.hlc.now()
+      });
+      if (delta) {
+        await this.accumulateDelta(delta);
+      }
+      const lastModified = record.LastModifiedDate;
+      if (lastModified && (!maxLastModified || lastModified > maxLastModified)) {
+        maxLastModified = lastModified;
+      }
+    }
+    this.cursors[cursorKey] = maxLastModified;
+  }
+  // -----------------------------------------------------------------------
+  // SOQL query builder
+  // -----------------------------------------------------------------------
+  buildSoql(sObjectType, fields, cursor) {
+    const clauses = [];
+    if (cursor) {
+      clauses.push(`LastModifiedDate > ${cursor}`);
+    }
+    if (this.connectionConfig.soqlFilter) {
+      clauses.push(this.connectionConfig.soqlFilter);
+    }
+    const where = clauses.length > 0 ? ` WHERE ${clauses.join(" AND ")}` : "";
+    return `SELECT ${fields} FROM ${sObjectType}${where} ORDER BY LastModifiedDate ASC`;
+  }
+};
+export {
+  SalesforceApiError,
+  SalesforceAuthError,
+  SalesforceClient,
+  SalesforceSourcePoller,
+  mapAccount,
+  mapContact,
+  mapLead,
+  mapOpportunity
+};
+//# sourceMappingURL=src-WZNPHANQ.js.map

package/dist/src-WZNPHANQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../connector-salesforce/src/errors.ts","../../connector-salesforce/src/client.ts","../../connector-salesforce/src/mapping.ts","../../connector-salesforce/src/poller.ts"],"sourcesContent":["import { LakeSyncError } from \"@lakesync/core\";\n\n/** HTTP error from the Salesforce REST API. */\nexport class SalesforceApiError extends LakeSyncError {\n\t/** HTTP status code returned by Salesforce. */\n\treadonly statusCode: number;\n\t/** Raw response body from Salesforce. */\n\treadonly responseBody: string;\n\n\tconstructor(statusCode: number, responseBody: string, cause?: Error) {\n\t\tsuper(`Salesforce API error (${statusCode}): ${responseBody}`, \"SALESFORCE_API_ERROR\", cause);\n\t\tthis.statusCode = statusCode;\n\t\tthis.responseBody = responseBody;\n\t}\n}\n\n/** Authentication failure from the Salesforce OAuth token endpoint. */\nexport class SalesforceAuthError extends LakeSyncError {\n\tconstructor(message: string, cause?: Error) {\n\t\tsuper(message, \"SALESFORCE_AUTH_ERROR\", cause);\n\t}\n}\n","// ---------------------------------------------------------------------------\n// SalesforceClient — HTTP wrapper for Salesforce REST API\n// ---------------------------------------------------------------------------\n\nimport { Err, Ok, type Result } from \"@lakesync/core\";\nimport { SalesforceApiError, SalesforceAuthError } from \"./errors\";\nimport type {\n\tSalesforceAuthResponse,\n\tSalesforceConnectorConfig,\n\tSalesforceQueryResponse,\n} from \"./types\";\n\nconst DEFAULT_API_VERSION = \"v62.0\";\nconst MAX_RETRY_ATTEMPTS = 3;\nconst DEFAULT_RETRY_AFTER_MS = 10_000;\n\n/**\n * HTTP client for the Salesforce REST API.\n *\n * Uses OAuth 2.0 Username-Password flow for authentication and global `fetch`.\n * All public methods return `Result<T, SalesforceApiError | SalesforceAuthError>`.\n */\nexport class SalesforceClient {\n\tprivate readonly config: SalesforceConnectorConfig;\n\tprivate readonly apiVersion: string;\n\tprivate readonly loginUrl: string;\n\n\tprivate accessToken: string | null = null;\n\tprivate instanceUrl: string;\n\n\tconstructor(config: SalesforceConnectorConfig) {\n\t\tthis.config = config;\n\t\tthis.apiVersion = config.apiVersion ?? DEFAULT_API_VERSION;\n\t\tthis.loginUrl = config.isSandbox\n\t\t\t? \"https://test.salesforce.com\"\n\t\t\t: \"https://login.salesforce.com\";\n\t\tthis.instanceUrl = config.instanceUrl;\n\t}\n\n\t/**\n\t * Authenticate via OAuth 2.0 Username-Password flow.\n\t *\n\t * Stores access token and updates instance URL from the response.\n\t */\n\tasync authenticate(): Promise<Result<void, SalesforceAuthError>> {\n\t\tconst body = new URLSearchParams({\n\t\t\tgrant_type: \"password\",\n\t\t\tclient_id: this.config.clientId,\n\t\t\tclient_secret: this.config.clientSecret,\n\t\t\tusername: this.config.username,\n\t\t\tpassword: this.config.password,\n\t\t});\n\n\t\tlet response: Response;\n\t\ttry {\n\t\t\tresponse = await fetch(`${this.loginUrl}/services/oauth2/token`, {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n\t\t\t\tbody: body.toString(),\n\t\t\t});\n\t\t} catch (err) {\n\t\t\treturn Err(\n\t\t\t\tnew SalesforceAuthError(\n\t\t\t\t\t`Failed to connect to Salesforce auth endpoint: ${err instanceof Error ? err.message : String(err)}`,\n\t\t\t\t\terr instanceof Error ? err : undefined,\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\n\t\tif (!response.ok) {\n\t\t\tconst text = await response.text();\n\t\t\treturn Err(\n\t\t\t\tnew SalesforceAuthError(`Salesforce authentication failed (${response.status}): ${text}`),\n\t\t\t);\n\t\t}\n\n\t\tconst data = (await response.json()) as SalesforceAuthResponse;\n\t\tthis.accessToken = data.access_token;\n\t\tthis.instanceUrl = data.instance_url;\n\n\t\treturn Ok(undefined);\n\t}\n\n\t/**\n\t * Execute a SOQL query with auto-pagination.\n\t *\n\t * Automatically authenticates on first call and re-authenticates on 401.\n\t */\n\tasync query<T>(soql: string): Promise<Result<T[], SalesforceApiError | SalesforceAuthError>> {\n\t\t// Ensure we have a token\n\t\tif (!this.accessToken) {\n\t\t\tconst authResult = await this.authenticate();\n\t\t\tif (!authResult.ok) return authResult;\n\t\t}\n\n\t\tconst allRecords: T[] = [];\n\t\tlet url = `${this.instanceUrl}/services/data/${this.apiVersion}/query?q=${encodeURIComponent(soql)}`;\n\n\t\twhile (true) {\n\t\t\tconst result = await this.request<SalesforceQueryResponse<T>>(url);\n\n\t\t\t// Re-auth on 401 and retry once\n\t\t\tif (\n\t\t\t\t!result.ok &&\n\t\t\t\tresult.error instanceof SalesforceApiError &&\n\t\t\t\tresult.error.statusCode === 401\n\t\t\t) {\n\t\t\t\tconst authResult = await this.authenticate();\n\t\t\t\tif (!authResult.ok) return authResult;\n\n\t\t\t\tconst retryResult = await this.request<SalesforceQueryResponse<T>>(url);\n\t\t\t\tif (!retryResult.ok) return retryResult;\n\n\t\t\t\tfor (const record of retryResult.value.records) {\n\t\t\t\t\tallRecords.push(record);\n\t\t\t\t}\n\n\t\t\t\tif (retryResult.value.done || !retryResult.value.nextRecordsUrl) break;\n\t\t\t\turl = `${this.instanceUrl}${retryResult.value.nextRecordsUrl}`;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (!result.ok) return result;\n\n\t\t\tfor (const record of result.value.records) {\n\t\t\t\tallRecords.push(record);\n\t\t\t}\n\n\t\t\tif (result.value.done || !result.value.nextRecordsUrl) break;\n\t\t\turl = `${this.instanceUrl}${result.value.nextRecordsUrl}`;\n\t\t}\n\n\t\treturn Ok(allRecords);\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Internal HTTP helpers\n\t// -----------------------------------------------------------------------\n\n\t/** Make an HTTP request with rate-limit retry logic. */\n\tprivate async request<T>(\n\t\turl: string,\n\t): Promise<Result<T, SalesforceApiError | SalesforceAuthError>> {\n\t\tfor (let attempt = 0; attempt <= MAX_RETRY_ATTEMPTS; attempt++) {\n\t\t\tconst headers: Record<string, string> = {\n\t\t\t\tAuthorization: `Bearer ${this.accessToken}`,\n\t\t\t\tAccept: \"application/json\",\n\t\t\t};\n\n\t\t\tconst response = await fetch(url, { method: \"GET\", headers });\n\n\t\t\tif (response.ok) {\n\t\t\t\tconst data = (await response.json()) as T;\n\t\t\t\treturn Ok(data);\n\t\t\t}\n\n\t\t\t// Rate limit: 503 with Retry-After\n\t\t\tif (response.status === 503) {\n\t\t\t\tconst retryAfter = response.headers.get(\"Retry-After\");\n\t\t\t\tconst waitMs = retryAfter ? Number.parseInt(retryAfter, 10) * 1000 : DEFAULT_RETRY_AFTER_MS;\n\n\t\t\t\tif (attempt < MAX_RETRY_ATTEMPTS) {\n\t\t\t\t\tawait sleep(waitMs);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tconst responseBody = await response.text();\n\t\t\t\treturn Err(new SalesforceApiError(503, responseBody));\n\t\t\t}\n\n\t\t\tconst responseBody = await response.text();\n\t\t\treturn Err(new SalesforceApiError(response.status, responseBody));\n\t\t}\n\n\t\treturn Err(new SalesforceApiError(0, \"Unknown error after retries\"));\n\t}\n}\n\n/** Sleep for the given number of milliseconds. */\nfunction sleep(ms: number): Promise<void> {\n\treturn new Promise((resolve) => setTimeout(resolve, ms));\n}\n","// ---------------------------------------------------------------------------\n// Salesforce Entity → Flat LakeSync Row Mapping\n// ---------------------------------------------------------------------------\n\nimport type { SfAccount, SfContact, SfLead, SfOpportunity } from \"./types\";\n\n/**\n * Map a Salesforce Account to a flat row for the `sf_accounts` table.\n *\n * The row ID is the Salesforce record Id.\n */\nexport function mapAccount(account: SfAccount): { rowId: string; row: Record<string, unknown> } {\n\treturn {\n\t\trowId: account.Id,\n\t\trow: {\n\t\t\tsf_id: account.Id,\n\t\t\tname: account.Name ?? null,\n\t\t\ttype: account.Type ?? null,\n\t\t\tindustry: account.Industry ?? null,\n\t\t\twebsite: account.Website ?? null,\n\t\t\tphone: account.Phone ?? null,\n\t\t\tbilling_city: account.BillingCity ?? null,\n\t\t\tbilling_state: account.BillingState ?? null,\n\t\t\tbilling_country: account.BillingCountry ?? null,\n\t\t\tannual_revenue: account.AnnualRevenue ?? null,\n\t\t\tnumber_of_employees: account.NumberOfEmployees ?? null,\n\t\t\towner_name: account.Owner?.Name ?? null,\n\t\t\tcreated_date: account.CreatedDate ?? null,\n\t\t\tlast_modified_date: account.LastModifiedDate ?? null,\n\t\t},\n\t};\n}\n\n/**\n * Map a Salesforce Contact to a flat row for the `sf_contacts` table.\n *\n * The row ID is the Salesforce record Id.\n */\nexport function mapContact(contact: SfContact): { rowId: string; row: Record<string, unknown> } {\n\treturn {\n\t\trowId: contact.Id,\n\t\trow: {\n\t\t\tsf_id: contact.Id,\n\t\t\tfirst_name: contact.FirstName ?? null,\n\t\t\tlast_name: contact.LastName ?? null,\n\t\t\temail: contact.Email ?? null,\n\t\t\tphone: contact.Phone ?? null,\n\t\t\ttitle: contact.Title ?? null,\n\t\t\taccount_id: contact.AccountId ?? null,\n\t\t\taccount_name: contact.Account?.Name ?? null,\n\t\t\tmailing_city: contact.MailingCity ?? null,\n\t\t\tmailing_state: contact.MailingState ?? null,\n\t\t\tmailing_country: contact.MailingCountry ?? null,\n\t\t\towner_name: contact.Owner?.Name ?? null,\n\t\t\tcreated_date: contact.CreatedDate ?? null,\n\t\t\tlast_modified_date: contact.LastModifiedDate ?? null,\n\t\t},\n\t};\n}\n\n/**\n * Map a Salesforce Opportunity to a flat row for the `sf_opportunities` table.\n *\n * The row ID is the Salesforce record Id.\n */\nexport function mapOpportunity(opportunity: SfOpportunity): {\n\trowId: string;\n\trow: Record<string, unknown>;\n} {\n\treturn {\n\t\trowId: opportunity.Id,\n\t\trow: {\n\t\t\tsf_id: opportunity.Id,\n\t\t\tname: opportunity.Name ?? null,\n\t\t\tstage_name: opportunity.StageName ?? null,\n\t\t\tamount: opportunity.Amount ?? null,\n\t\t\tclose_date: opportunity.CloseDate ?? null,\n\t\t\tprobability: opportunity.Probability ?? null,\n\t\t\taccount_id: opportunity.AccountId ?? null,\n\t\t\taccount_name: opportunity.Account?.Name ?? null,\n\t\t\ttype: opportunity.Type ?? null,\n\t\t\tlead_source: opportunity.LeadSource ?? null,\n\t\t\tis_closed: opportunity.IsClosed ?? null,\n\t\t\tis_won: opportunity.IsWon ?? null,\n\t\t\towner_name: opportunity.Owner?.Name ?? null,\n\t\t\tcreated_date: opportunity.CreatedDate ?? null,\n\t\t\tlast_modified_date: opportunity.LastModifiedDate ?? null,\n\t\t},\n\t};\n}\n\n/**\n * Map a Salesforce Lead to a flat row for the `sf_leads` table.\n *\n * The row ID is the Salesforce record Id.\n */\nexport function mapLead(lead: SfLead): { rowId: string; row: Record<string, unknown> } {\n\treturn {\n\t\trowId: lead.Id,\n\t\trow: {\n\t\t\tsf_id: lead.Id,\n\t\t\tfirst_name: lead.FirstName ?? null,\n\t\t\tlast_name: lead.LastName ?? null,\n\t\t\tcompany: lead.Company ?? null,\n\t\t\temail: lead.Email ?? null,\n\t\t\tphone: lead.Phone ?? null,\n\t\t\ttitle: lead.Title ?? null,\n\t\t\tstatus: lead.Status ?? null,\n\t\t\tlead_source: lead.LeadSource ?? null,\n\t\t\tis_converted: lead.IsConverted ?? null,\n\t\t\tconverted_account_id: lead.ConvertedAccountId ?? null,\n\t\t\tconverted_contact_id: lead.ConvertedContactId ?? null,\n\t\t\tconverted_opportunity_id: lead.ConvertedOpportunityId ?? null,\n\t\t\towner_name: lead.Owner?.Name ?? null,\n\t\t\tcreated_date: lead.CreatedDate ?? null,\n\t\t\tlast_modified_date: lead.LastModifiedDate ?? null,\n\t\t},\n\t};\n}\n","// ---------------------------------------------------------------------------\n// SalesforceSourcePoller — polls Salesforce CRM and pushes deltas to SyncGateway\n// ---------------------------------------------------------------------------\n\nimport { BaseSourcePoller, extractDelta, type PushTarget } from \"@lakesync/core\";\nimport { SalesforceClient } from \"./client\";\nimport { mapAccount, mapContact, mapLead, mapOpportunity } from \"./mapping\";\nimport type {\n\tSalesforceConnectorConfig,\n\tSalesforceIngestConfig,\n\tSfAccount,\n\tSfContact,\n\tSfLead,\n\tSfOpportunity,\n} from \"./types\";\n\nconst DEFAULT_INTERVAL_MS = 30_000;\n\n// ---------------------------------------------------------------------------\n// SOQL field lists\n// ---------------------------------------------------------------------------\n\nconst ACCOUNT_FIELDS = [\n\t\"Id\",\n\t\"Name\",\n\t\"Type\",\n\t\"Industry\",\n\t\"Website\",\n\t\"Phone\",\n\t\"BillingCity\",\n\t\"BillingState\",\n\t\"BillingCountry\",\n\t\"AnnualRevenue\",\n\t\"NumberOfEmployees\",\n\t\"Owner.Name\",\n\t\"CreatedDate\",\n\t\"LastModifiedDate\",\n].join(\", \");\n\nconst CONTACT_FIELDS = [\n\t\"Id\",\n\t\"FirstName\",\n\t\"LastName\",\n\t\"Email\",\n\t\"Phone\",\n\t\"Title\",\n\t\"AccountId\",\n\t\"Account.Name\",\n\t\"MailingCity\",\n\t\"MailingState\",\n\t\"MailingCountry\",\n\t\"Owner.Name\",\n\t\"CreatedDate\",\n\t\"LastModifiedDate\",\n].join(\", \");\n\nconst OPPORTUNITY_FIELDS = [\n\t\"Id\",\n\t\"Name\",\n\t\"StageName\",\n\t\"Amount\",\n\t\"CloseDate\",\n\t\"Probability\",\n\t\"AccountId\",\n\t\"Account.Name\",\n\t\"Type\",\n\t\"LeadSource\",\n\t\"IsClosed\",\n\t\"IsWon\",\n\t\"Owner.Name\",\n\t\"CreatedDate\",\n\t\"LastModifiedDate\",\n].join(\", \");\n\nconst LEAD_FIELDS = [\n\t\"Id\",\n\t\"FirstName\",\n\t\"LastName\",\n\t\"Company\",\n\t\"Email\",\n\t\"Phone\",\n\t\"Title\",\n\t\"Status\",\n\t\"LeadSource\",\n\t\"IsConverted\",\n\t\"ConvertedAccountId\",\n\t\"ConvertedContactId\",\n\t\"ConvertedOpportunityId\",\n\t\"Owner.Name\",\n\t\"CreatedDate\",\n\t\"LastModifiedDate\",\n].join(\", \");\n\n/**\n * Polls Salesforce CRM for accounts, contacts, opportunities, and leads\n * and pushes detected changes into a gateway via streaming accumulation.\n *\n * Uses {@link BaseSourcePoller.accumulateDelta} to push deltas in\n * memory-bounded chunks instead of collecting all deltas in a single array.\n */\nexport class SalesforceSourcePoller extends BaseSourcePoller {\n\tprivate readonly connectionConfig: SalesforceConnectorConfig;\n\tprivate readonly client: SalesforceClient;\n\n\t/** Per-entity cursors: max LastModifiedDate from the last poll. */\n\tprivate cursors: Record<string, string | undefined> = {\n\t\taccounts: undefined,\n\t\tcontacts: undefined,\n\t\topportunities: undefined,\n\t\tleads: undefined,\n\t};\n\n\tconstructor(\n\t\tconnectionConfig: SalesforceConnectorConfig,\n\t\tingestConfig: SalesforceIngestConfig | undefined,\n\t\tname: string,\n\t\tgateway: PushTarget,\n\t\tclient?: SalesforceClient,\n\t) {\n\t\tsuper({\n\t\t\tname,\n\t\t\tintervalMs: ingestConfig?.intervalMs ?? DEFAULT_INTERVAL_MS,\n\t\t\tgateway,\n\t\t\tmemory: {\n\t\t\t\tchunkSize: ingestConfig?.chunkSize,\n\t\t\t\tmemoryBudgetBytes: ingestConfig?.memoryBudgetBytes,\n\t\t\t},\n\t\t});\n\t\tthis.connectionConfig = connectionConfig;\n\t\tthis.client = client ?? new SalesforceClient(connectionConfig);\n\t}\n\n\t/** Execute a single poll cycle across all enabled entity types. */\n\tasync poll(): Promise<void> {\n\t\tconst includeAccounts = this.connectionConfig.includeAccounts ?? true;\n\t\tif (includeAccounts) {\n\t\t\tawait this.pollEntity<SfAccount>(\n\t\t\t\t\"Account\",\n\t\t\t\tACCOUNT_FIELDS,\n\t\t\t\t\"accounts\",\n\t\t\t\t\"sf_accounts\",\n\t\t\t\tmapAccount,\n\t\t\t);\n\t\t}\n\n\t\tconst includeContacts = this.connectionConfig.includeContacts ?? true;\n\t\tif (includeContacts) {\n\t\t\tawait this.pollEntity<SfContact>(\n\t\t\t\t\"Contact\",\n\t\t\t\tCONTACT_FIELDS,\n\t\t\t\t\"contacts\",\n\t\t\t\t\"sf_contacts\",\n\t\t\t\tmapContact,\n\t\t\t);\n\t\t}\n\n\t\tconst includeOpportunities = this.connectionConfig.includeOpportunities ?? true;\n\t\tif (includeOpportunities) {\n\t\t\tawait this.pollEntity<SfOpportunity>(\n\t\t\t\t\"Opportunity\",\n\t\t\t\tOPPORTUNITY_FIELDS,\n\t\t\t\t\"opportunities\",\n\t\t\t\t\"sf_opportunities\",\n\t\t\t\tmapOpportunity,\n\t\t\t);\n\t\t}\n\n\t\tconst includeLeads = this.connectionConfig.includeLeads ?? true;\n\t\tif (includeLeads) {\n\t\t\tawait this.pollEntity<SfLead>(\"Lead\", LEAD_FIELDS, \"leads\", \"sf_leads\", mapLead);\n\t\t}\n\n\t\tawait this.flushAccumulator();\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Generic entity polling via LastModifiedDate cursor\n\t// -----------------------------------------------------------------------\n\n\tprivate async pollEntity<T extends { Id: string; LastModifiedDate: string | null }>(\n\t\tsObjectType: string,\n\t\tfields: string,\n\t\tcursorKey: string,\n\t\ttable: string,\n\t\tmapFn: (record: T) => { rowId: string; row: Record<string, unknown> },\n\t): Promise<void> {\n\t\tconst cursor = this.cursors[cursorKey];\n\t\tconst soql = this.buildSoql(sObjectType, fields, cursor);\n\n\t\tconst result = await this.client.query<T>(soql);\n\t\tif (!result.ok) return;\n\n\t\tconst records = result.value;\n\t\tif (records.length === 0) return;\n\n\t\tlet maxLastModified = cursor;\n\n\t\tfor (const record of records) {\n\t\t\tconst { rowId, row } = mapFn(record);\n\n\t\t\tconst delta = await extractDelta(null, row, {\n\t\t\t\ttable,\n\t\t\t\trowId,\n\t\t\t\tclientId: this.clientId,\n\t\t\t\thlc: this.hlc.now(),\n\t\t\t});\n\n\t\t\tif (delta) {\n\t\t\t\tawait this.accumulateDelta(delta);\n\t\t\t}\n\n\t\t\tconst lastModified = record.LastModifiedDate;\n\t\t\tif (lastModified && (!maxLastModified || lastModified > maxLastModified)) {\n\t\t\t\tmaxLastModified = lastModified;\n\t\t\t}\n\t\t}\n\n\t\tthis.cursors[cursorKey] = maxLastModified;\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// SOQL query builder\n\t// -----------------------------------------------------------------------\n\n\tprivate buildSoql(sObjectType: string, fields: string, cursor: string | undefined): string {\n\t\tconst clauses: string[] = [];\n\n\t\tif (cursor) {\n\t\t\tclauses.push(`LastModifiedDate > ${cursor}`);\n\t\t}\n\n\t\tif (this.connectionConfig.soqlFilter) {\n\t\t\tclauses.push(this.connectionConfig.soqlFilter);\n\t\t}\n\n\t\tconst where = clauses.length > 0 ? ` WHERE ${clauses.join(\" AND \")}` : \"\";\n\t\treturn `SELECT ${fields} FROM ${sObjectType}${where} ORDER BY LastModifiedDate ASC`;\n\t}\n}\n"],"mappings":"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","names":["responseBody"]}

package/dist/types-Bs-QyOe-.d.ts

@@ -0,0 +1,143 @@
+import { L as LakeSyncError, R as Result, H as HLCTimestamp } from './result-CojzlFE2.js';
+
+/** Error during action execution (may be retryable). */
+declare class ActionExecutionError extends LakeSyncError {
+    readonly retryable: boolean;
+    constructor(message: string, retryable: boolean, cause?: Error);
+}
+/** The requested action type is not supported by the connector. */
+declare class ActionNotSupportedError extends LakeSyncError {
+    constructor(message: string, cause?: Error);
+}
+/** Action payload failed structural validation. */
+declare class ActionValidationError extends LakeSyncError {
+    constructor(message: string, cause?: Error);
+}
+
+/** Supported comparison operators for sync rule filters */
+type SyncRuleOp = "eq" | "in" | "neq" | "gt" | "lt" | "gte" | "lte";
+/** A single filter condition within a bucket definition */
+interface SyncRuleFilter {
+    /** Column name to match against */
+    column: string;
+    /** Comparison operator */
+    op: SyncRuleOp;
+    /** Literal value or JWT claim reference (prefixed with "jwt:") */
+    value: string;
+}
+/** A named bucket defining which rows a client should receive */
+interface BucketDefinition {
+    /** Unique bucket name */
+    name: string;
+    /** Tables this bucket applies to. Empty array = all tables. */
+    tables: string[];
+    /** Row-level filter conditions (conjunctive — all must match). Empty = no row filtering. */
+    filters: SyncRuleFilter[];
+}
+/** Top-level sync rules configuration */
+interface SyncRulesConfig {
+    /** Configuration version (for future schema evolution) */
+    version: number;
+    /** Bucket definitions */
+    buckets: BucketDefinition[];
+}
+/** Resolved JWT claims as a flat record */
+type ResolvedClaims = Record<string, string | string[]>;
+/** Context for evaluating sync rules against a specific client */
+interface SyncRulesContext {
+    /** Resolved JWT claims for the requesting client */
+    claims: ResolvedClaims;
+    /** The sync rules configuration to evaluate */
+    rules: SyncRulesConfig;
+}
+
+/** Describes an action type supported by a connector. */
+interface ActionDescriptor {
+    /** The action type identifier (e.g. "create_pr", "send_message"). */
+    actionType: string;
+    /** Human-readable description of what this action does. */
+    description: string;
+    /** Optional JSON Schema for the action's params. */
+    paramsSchema?: Record<string, unknown>;
+}
+/** Authentication context passed to action handlers for permission checks. */
+interface AuthContext {
+    /** Resolved JWT claims for resource-level permission checks. */
+    claims: ResolvedClaims;
+}
+/**
+ * Interface for connectors that can execute imperative actions.
+ *
+ * Separate from `DatabaseAdapter` — not all connectors support actions
+ * (e.g. S3 doesn't). A connector can implement `DatabaseAdapter` (read/write
+ * data), `ActionHandler` (execute commands), or both.
+ */
+interface ActionHandler {
+    /** Descriptors for all action types this handler supports. */
+    readonly supportedActions: ActionDescriptor[];
+    /** Execute a single action against the external system. */
+    executeAction(action: Action, context?: AuthContext): Promise<Result<ActionResult, ActionExecutionError | ActionNotSupportedError>>;
+}
+/** Type guard: check whether an object implements the ActionHandler interface. */
+declare function isActionHandler(obj: unknown): obj is ActionHandler;
+
+/** Discovery response listing available connectors and their supported actions. */
+interface ActionDiscovery {
+    /** Map of connector name to its supported action descriptors. */
+    connectors: Record<string, ActionDescriptor[]>;
+}
+/** An imperative action to execute against an external system. */
+interface Action {
+    /** Unique action identifier (deterministic SHA-256 hash). */
+    actionId: string;
+    /** Client that initiated the action. */
+    clientId: string;
+    /** HLC timestamp when the action was created. */
+    hlc: HLCTimestamp;
+    /** Target connector name (e.g. "github", "slack", "linear"). */
+    connector: string;
+    /** Action type within the connector (e.g. "create_pr", "send_message"). */
+    actionType: string;
+    /** Action parameters — connector-specific payload. */
+    params: Record<string, unknown>;
+    /** Optional idempotency key for at-most-once delivery. */
+    idempotencyKey?: string;
+}
+/** Successful result of executing an action. */
+interface ActionResult {
+    /** The action that was executed. */
+    actionId: string;
+    /** Result data returned by the connector. */
+    data: Record<string, unknown>;
+    /** Server HLC after processing. */
+    serverHlc: HLCTimestamp;
+}
+/** Error result of executing an action. */
+interface ActionErrorResult {
+    /** The action that failed. */
+    actionId: string;
+    /** Error code. */
+    code: string;
+    /** Human-readable error message. */
+    message: string;
+    /** Whether the client can retry this action. */
+    retryable: boolean;
+}
+/** Batch of actions pushed by a client. */
+interface ActionPush {
+    /** Client identifier. */
+    clientId: string;
+    /** Actions to execute. */
+    actions: Action[];
+}
+/** Gateway response to an action push. */
+interface ActionResponse {
+    /** Results for each action (success or error). */
+    results: Array<ActionResult | ActionErrorResult>;
+    /** Server HLC after processing. */
+    serverHlc: HLCTimestamp;
+}
+/** Type guard: check whether a result is an error. */
+declare function isActionError(result: ActionResult | ActionErrorResult): result is ActionErrorResult;
+
+export { type Action as A, type BucketDefinition as B, type ResolvedClaims as R, type SyncRulesConfig as S, ActionValidationError as a, type SyncRulesContext as b, type ActionDescriptor as c, type ActionDiscovery as d, type ActionErrorResult as e, ActionExecutionError as f, type ActionHandler as g, ActionNotSupportedError as h, type ActionPush as i, type ActionResponse as j, type ActionResult as k, type AuthContext as l, type SyncRuleFilter as m, type SyncRuleOp as n, isActionError as o, isActionHandler as p };