@boltic/sdk 0.1.2 → 0.1.3

package/dist/databases/testing.d.ts

@@ -1,3 +1,12 @@
+/** Properties describing the activity to execute (dynamic, varies by integration) */
+declare type ActivityProperties = Record<string, unknown>;
+
+/** Result/context payload sent alongside activity nodes */
+declare interface ActivityResultPayload {
+    payload: Record<string, unknown>;
+    global_variables: Record<string, unknown>;
+}
+
 declare interface AddIndexRequest {
     field_names: string[];
     method: 'btree' | 'hash' | 'spgist' | 'gin' | 'brin';
@@ -51,6 +60,41 @@ declare class AuthManager {
     toJSON(): object;
 }
 
+/**
+ * Base API Client — provides common functionality for all API clients.
+ *
+ * Subclasses pass a `servicePath` to target different backend services
+ * while sharing auth, headers, error handling, and HTTP infrastructure.
+ */
+declare abstract class BaseApiClient {
+    protected httpAdapter: HttpAdapter;
+    protected config: BaseApiClientConfig;
+    protected baseURL: string;
+    protected environment: Environment;
+    protected region: Region;
+    constructor(apiKey: string, config?: Omit<BaseApiClientConfig, 'apiKey'>, servicePath?: string);
+    /**
+     * Resolve a secondary service URL using the same region/environment
+     * but a different service path.
+     */
+    protected resolveAdditionalServiceURL(servicePath: string): string;
+    protected buildHeaders(): Record<string, string>;
+    protected formatErrorResponse(error: unknown, prefix?: string): BolticErrorResponse;
+    toString(): string;
+    toJSON(): object;
+}
+
+declare interface BaseApiClientConfig {
+    apiKey: string;
+    environment?: Environment;
+    region?: Region;
+    timeout?: number;
+    debug?: boolean;
+    retryAttempts?: number;
+    retryDelay?: number;
+    headers?: Record<string, string>;
+}
+
 declare class BaseClient {
     private httpAdapter;
     private authManager;
@@ -80,6 +124,7 @@ declare class BolticClient {
     private sqlResource;
     private indexResource;
     private databaseResource;
+    private workflowResource;
     private currentDatabase;
     private clientOptions;
     constructor(apiKey: string, options?: ClientOptions);
@@ -128,10 +173,6 @@ declare class BolticClient {
             message: string;
         }>>;
         rename: (oldName: string, newName: string) => Promise<BolticSuccessResponse<TableRecord>>;
-        setAccess: (request: {
-            table_name: string;
-            is_shared: boolean;
-        }) => Promise<BolticSuccessResponse<TableRecord>>;
     };
     get columns(): {
         create: (tableName: string, column: FieldDefinition) => Promise<BolticErrorResponse | BolticSuccessResponse<ColumnRecord>>;
@@ -196,7 +237,32 @@ declare class BolticClient {
     record(tableName: string): RecordBuilder;
     get sql(): {
         textToSQL: (prompt: string, options?: TextToSQLOptions) => Promise<AsyncIterable<string>>;
-        executeSQL: (query: string) => Promise<BolticErrorResponse | ExecuteSQLApiResponse_2>;
+        executeSQL: (query: string) => Promise<BolticErrorResponse | ExecuteSQLApiResponse>;
+    };
+    /**
+     * Workflow integration operations.
+     *
+     * @example
+     * ```typescript
+     * // Execute and poll for result
+     * const result = await client.workflow.executeIntegration({
+     *   nodes: [{ id: 'api1', data: { ... }, activity_data: { ... } }],
+     * });
+     *
+     * // Get execution result by ID
+     * const exec = await client.workflow.getIntegrationExecuteById('run-uuid');
+     *
+     * // List integrations
+     * const integrations = await client.workflow.getIntegrations();
+     * ```
+     */
+    get workflow(): {
+        executeIntegration: (params: ExecuteIntegrationParams) => Promise<BolticErrorResponse | BolticSuccessResponse<ExecuteActivityResponseData | IntegrationExecutionData>>;
+        getIntegrationExecuteById: (executionId: string) => Promise<BolticErrorResponse | BolticSuccessResponse<IntegrationExecutionData>>;
+        getIntegrations: (params?: GetIntegrationsParams) => Promise<BolticErrorResponse | BolticSuccessResponse<IntegrationsListData>>;
+        getCredentials: (params: GetCredentialsParams) => Promise<BolticErrorResponse | BolticSuccessResponse<CredentialsListData>>;
+        getIntegrationResource: (params: GetIntegrationResourceParams) => Promise<BolticErrorResponse | BolticSuccessResponse<IntegrationResourceData>>;
+        getIntegrationForm: (params: GetIntegrationFormParams) => Promise<BolticErrorResponse | BolticSuccessResponse<Record<string, unknown> | IntegrationFormJsonSchema>>;
     };
     getSqlResource(): SqlResource;
     updateApiKey(newApiKey: string): void;
@@ -231,25 +297,6 @@ declare interface BolticErrorResponse {
     };
 }
 
-declare interface BolticErrorResponse_2 {
-    data?: never;
-    message?: string;
-    error: {
-        code?: string;
-        message?: string;
-        meta?: string[];
-    };
-}
-
-declare interface BolticErrorResponse_3 {
-    data?: never;
-    error: {
-        code?: string;
-        message?: string;
-        meta?: string[];
-    };
-}
-
 declare interface BolticListResponse<T> {
     data: T[];
     pagination?: {
@@ -267,18 +314,6 @@ declare interface BolticListResponse<T> {
     };
 }
 
-declare interface BolticListResponse_2<T = unknown> {
-    data: T[];
-    pagination?: {
-        total_count: number;
-        total_pages: number;
-        current_page: number;
-        per_page: number;
-        type: string;
-    };
-    message?: string;
-}
-
 declare interface BolticSuccessResponse<T> {
     data: T;
     message?: string;
@@ -289,11 +324,6 @@ declare interface BolticSuccessResponse<T> {
     };
 }
 
-declare interface BolticSuccessResponse_2<T = unknown> {
-    data: T;
-    message?: string;
-}
-
 declare interface ClientConfig extends EnvironmentConfig {
     apiKey: string;
     environment: Environment;
@@ -407,6 +437,9 @@ export declare function createMockResponse<T>(data: T, pagination?: PaginationIn
 
 export declare function createTestClient(options?: MockClientOptions): BolticClient;
 
+/** Data returned from the get-credentials API */
+declare type CredentialsListData = Record<string, unknown>;
+
 declare interface DatabaseContext {
     databaseId?: string;
     dbInternalName?: string;
@@ -560,25 +593,39 @@ declare interface EnvironmentConfig {
 
 declare type ErrorInterceptor = (error: unknown) => unknown | Promise<unknown>;
 
-declare interface ExecuteSQLApiResponse {
-    data: Record<string, unknown>[];
-    count?: number;
-    pagination?: {
-        total_count: number;
-        total_pages: number;
-        current_page: number;
-        per_page: number;
+/** Data returned from the execute-activity API */
+declare interface ExecuteActivityResponseData {
+    execution_id: string;
+    [key: string]: unknown;
+}
+
+/**
+ * Parameters accepted by `workflow.executeIntegration()`.
+ *
+ * @remarks
+ * When `executeOnly` is `false` (default), the SDK will poll
+ * `getIntegrationExecuteById` until the execution reaches a terminal state.
+ */
+declare interface ExecuteIntegrationParams {
+    /**
+     * If `true`, return immediately after the execute call without polling.
+     * @defaultValue false
+     */
+    executeOnly?: boolean;
+    /** Activity data describing what to execute. The SDK wraps this into the `nodes[]` structure the API expects. */
+    data: {
         type: string;
+        name: string;
+        properties: ActivityProperties;
     };
-    message?: string;
-    error?: {
-        code?: string;
-        message?: string;
-        meta?: string[];
-    };
+    /**
+     * Result/context payload for the execute request.
+     * Falls back to a sensible default when omitted.
+     */
+    result?: ActivityResultPayload;
 }
 
-declare interface ExecuteSQLApiResponse_2 {
+declare interface ExecuteSQLApiResponse {
     data: Record<string, unknown>[];
     count?: number;
     pagination?: {
@@ -634,6 +681,73 @@ declare interface FilterParams {
     values: any[];
 }
 
+/** Parameters accepted by `workflow.getCredentials()`. */
+declare interface GetCredentialsParams {
+    /** Integration name (e.g. "freshsales"). Automatically uppercased by the SDK. */
+    entity: string;
+    /**
+     * Current page number for pagination.
+     * @defaultValue 1
+     */
+    current_page?: number;
+    /**
+     * Number of items per page.
+     * @defaultValue 999
+     */
+    page_size?: number;
+}
+
+/** Parameters accepted by `workflow.getIntegrationForm()`. */
+declare interface GetIntegrationFormParams {
+    /** Integration slug identifier (e.g. "blt-int.asana"). */
+    integration_slug: string;
+    /** Resource type (e.g. "project", "task"). */
+    resource: string;
+    /** Operation type (e.g. "create", "update", "read"). */
+    operation: string;
+    /** Credential secret for the integration. */
+    secret: string;
+    /**
+     * When `true`, returns only the form schema without executing.
+     * @defaultValue true
+     */
+    getFormOnly?: boolean;
+    /**
+     * When `true`, the response `data` is returned as a JSON Schema object
+     * describing the expected input shape (type, required, default, enum).
+     *
+     * When `false` or omitted, the response `data` is a flat JSON object
+     * with default/fallback values for each field.
+     *
+     * @defaultValue false
+     */
+    asJsonSchema?: boolean;
+}
+
+/** Parameters accepted by `workflow.getIntegrationResource()`. */
+declare interface GetIntegrationResourceParams {
+    /** Integration slug identifier (e.g. "blt-int.asana"). */
+    integration_slug: string;
+}
+
+/** Parameters accepted by `workflow.getIntegrations()`. */
+declare interface GetIntegrationsParams {
+    /**
+     * Page number for pagination.
+     * @defaultValue 1
+     */
+    page?: number;
+    /**
+     * Number of items per page.
+     * @defaultValue 999
+     */
+    per_page?: number;
+}
+
+declare interface HttpAdapter {
+    request<T = unknown>(config: HttpRequestConfig): Promise<HttpResponse<T>>;
+}
+
 declare interface HttpRequestConfig {
     url: string;
     method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
@@ -665,6 +779,21 @@ declare interface IndexListItem {
     created_by?: string;
 }
 
+/** Data returned from the get-execution-by-id API */
+declare type IntegrationExecutionData = Record<string, unknown>;
+
+/** JSON Schema output for an integration form */
+declare interface IntegrationFormJsonSchema {
+    type: 'object';
+    properties: Record<string, JsonSchemaProperty>;
+}
+
+/** Data returned from the get-integration-resource API */
+declare type IntegrationResourceData = Record<string, unknown>;
+
+/** Data returned from the get-integrations API */
+declare type IntegrationsListData = Record<string, unknown>;
+
 declare interface InterceptorManager {
     request: {
         use(interceptor: RequestInterceptor): number;
@@ -693,6 +822,15 @@ declare class InterceptorManagerImpl implements InterceptorManager {
     executeErrorInterceptors(error: unknown): Promise<unknown>;
 }
 
+/** A single property in the generated JSON Schema */
+declare interface JsonSchemaProperty {
+    type: string;
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+    enum?: string[];
+}
+
 declare interface ListIndexesQuery {
     page?: {
         page_no: number;
@@ -998,7 +1136,7 @@ export declare class SqlTestClient {
     /**
      * Test helper for SQL execution
      */
-    executeSQL(query: string): Promise<BolticErrorResponse_2 | ExecuteSQLApiResponse_2>;
+    executeSQL(query: string): Promise<BolticErrorResponse | ExecuteSQLApiResponse>;
     /**
      * Utility to simulate streaming text-to-SQL for testing
      */
@@ -1011,7 +1149,6 @@ export declare class SqlTestClient {
 declare class TableBuilder {
     private tableName;
     private description?;
-    private isPublic;
     private fields;
     private tablesApiClient?;
     constructor(options: TableBuilderOptions, tablesApiClient?: TablesApiClient);
@@ -1023,10 +1160,6 @@ declare class TableBuilder {
      * Set table description
      */
     describe(description: string): TableBuilder;
-    /**
-     * Set if table is public
-     */
-    public(isPublic?: boolean): TableBuilder;
     /**
      * Add a text field
      */
@@ -1195,7 +1328,6 @@ declare interface TableCreateResponse {
 declare interface TableListOptions extends TableQueryOptions {
     page?: number;
     pageSize?: number;
-    isShared?: boolean;
     db_id?: string;
 }
 
@@ -1205,7 +1337,6 @@ declare interface TableQueryOptions {
         name?: string;
         db_id?: string;
         resource_id?: string;
-        is_public?: boolean;
         created_by?: string;
         created_at?: {
             $gte?: string;
@@ -1234,6 +1365,7 @@ declare interface TableRecord {
     type?: string;
     parent_table_id?: string;
     is_deleted: boolean;
+    /** @deprecated All tables are now public by default. This field is always true and ineffective. */
     is_public: boolean;
     created_by: string;
     created_at: string;
@@ -1244,67 +1376,45 @@ declare interface TableRecord {
     source?: 'boltic' | 'copilot';
 }
 
-/**
- * Tables API Client - handles all table-related API operations
- */
-declare class TablesApiClient {
-    private httpAdapter;
-    private config;
-    private baseURL;
-    constructor(apiKey: string, config?: Omit<TablesApiClientConfig, 'apiKey'>);
-    private getBaseURL;
+declare class TablesApiClient extends BaseApiClient {
+    constructor(apiKey: string, config?: Omit<BaseApiClientConfig, 'apiKey'>);
     /**
      * Create a new table
      */
-    createTable(request: TableCreateRequest, options?: TableCreateOptions): Promise<BolticSuccessResponse_2<TableCreateResponse> | BolticErrorResponse_3>;
+    createTable(request: TableCreateRequest, options?: TableCreateOptions): Promise<BolticSuccessResponse<TableCreateResponse> | BolticErrorResponse>;
     /**
      * List tables with filtering and pagination
      */
-    listTables(options?: TableListOptions): Promise<BolticListResponse_2<TableRecord> | BolticErrorResponse_3>;
+    listTables(options?: TableListOptions): Promise<BolticListResponse<TableRecord> | BolticErrorResponse>;
     /**
      * Get a specific table by ID
      */
     getTable(tableId: string, options?: {
         fields?: Array<keyof TableRecord>;
         db_id?: string;
-    }): Promise<BolticSuccessResponse_2<TableRecord> | BolticErrorResponse_3>;
+    }): Promise<BolticSuccessResponse<TableRecord> | BolticErrorResponse>;
     /**
      * Update an existing table
      */
     updateTable(tableId: string, updates: {
         name?: string;
         description?: string;
-        is_shared?: boolean;
         fields?: Array<keyof TableRecord>;
         db_id?: string;
-    }): Promise<BolticSuccessResponse_2<TableRecord> | BolticErrorResponse_3>;
+    }): Promise<BolticSuccessResponse<TableRecord> | BolticErrorResponse>;
     /**
      * Delete a table
      */
     deleteTable(tableId: string, options?: {
         db_id?: string;
-    }): Promise<BolticSuccessResponse_2<{
+    }): Promise<BolticSuccessResponse<{
         message: string;
-    }> | BolticErrorResponse_3>;
-    private buildHeaders;
-    private formatErrorResponse;
-}
-
-declare interface TablesApiClientConfig {
-    apiKey: string;
-    environment?: Environment;
-    region?: Region;
-    timeout?: number;
-    debug?: boolean;
-    retryAttempts?: number;
-    retryDelay?: number;
-    headers?: Record<string, string>;
+    }> | BolticErrorResponse>;
 }
 
 declare interface TableUpdateRequest {
     name?: string;
     description?: string;
-    is_shared?: boolean;
     fields?: Array<keyof TableRecord>;
 }
 

package/dist/databases/testing.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./test-client-Bo_BCApL.js");class t{static async*fromSSE(e){if(!e.body)throw new Error("Response body is null");const t=e.body.getReader(),s=new TextDecoder;try{for(;;){const{done:e,value:o}=await t.read();if(e)break;const r=s.decode(o,{stream:!0}).split("\n");for(const t of r)if(t.startsWith("data: ")){const e=t.slice(6);"[DONE]"!==e&&(yield e)}}}finally{t.releaseLock()}}static async*fromChunked(e){if(!e.body)throw new Error("Response body is null");const t=e.body.getReader(),s=new TextDecoder;try{for(;;){const{done:e,value:o}=await t.read();if(e)break;const r=s.decode(o,{stream:!0});yield r}}finally{t.releaseLock()}}static async collectAll(e){let t="";for await(const s of e)t+=s;return t}static async*fromString(e,t=10){for(let s=0;s<e.length;s+=t)yield e.slice(s,s+t),await new Promise(e=>setTimeout(e,50))}static async*map(e,t){for await(const s of e)yield await t(s)}static async*filter(e,t){for await(const s of e)await t(s)&&(yield s)}static async*take(e,t){let s=0;for await(const o of e){if(s>=t)break;yield o,s++}}}exports.createErrorResponse=e.createErrorResponse,exports.createMockResponse=e.createMockResponse,exports.createTestClient=e.createTestClient,exports.SqlTestClient=class{constructor(e){this.sql=e}async generateSQL(e,s){const o=await this.sql.textToSQL(e,s);return t.collectAll(o)}async executeSQL(e){return this.sql.executeSQL(e)}async*simulateStreamingSQL(e,t=10,s=50){for(let o=0;o<e.length;o+=t)yield e.slice(o,o+t),await new Promise(e=>setTimeout(e,s))}},exports.TEST_UTILS_VERSION="1.0.0";
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./test-client-BgkvBtst.js");class t{static async*fromSSE(e){if(!e.body)throw new Error("Response body is null");const t=e.body.getReader(),s=new TextDecoder;try{for(;;){const{done:e,value:o}=await t.read();if(e)break;const r=s.decode(o,{stream:!0}).split("\n");for(const t of r)if(t.startsWith("data: ")){const e=t.slice(6);"[DONE]"!==e&&(yield e)}}}finally{t.releaseLock()}}static async*fromChunked(e){if(!e.body)throw new Error("Response body is null");const t=e.body.getReader(),s=new TextDecoder;try{for(;;){const{done:e,value:o}=await t.read();if(e)break;const r=s.decode(o,{stream:!0});yield r}}finally{t.releaseLock()}}static async collectAll(e){let t="";for await(const s of e)t+=s;return t}static async*fromString(e,t=10){for(let s=0;s<e.length;s+=t)yield e.slice(s,s+t),await new Promise(e=>setTimeout(e,50))}static async*map(e,t){for await(const s of e)yield await t(s)}static async*filter(e,t){for await(const s of e)await t(s)&&(yield s)}static async*take(e,t){let s=0;for await(const o of e){if(s>=t)break;yield o,s++}}}exports.createErrorResponse=e.createErrorResponse,exports.createMockResponse=e.createMockResponse,exports.createTestClient=e.createTestClient,exports.SqlTestClient=class{constructor(e){this.sql=e}async generateSQL(e,s){const o=await this.sql.textToSQL(e,s);return t.collectAll(o)}async executeSQL(e){return this.sql.executeSQL(e)}async*simulateStreamingSQL(e,t=10,s=50){for(let o=0;o<e.length;o+=t)yield e.slice(o,o+t),await new Promise(e=>setTimeout(e,s))}},exports.TEST_UTILS_VERSION="1.0.0";
 //# sourceMappingURL=testing.js.map

package/dist/databases/testing.mjs

@@ -1,2 +1,2 @@
-import{o as e,p as t,q as s}from"./test-client-C9T839dW.mjs";class a{static async*fromSSE(e){if(!e.body)throw new Error("Response body is null");const t=e.body.getReader(),s=new TextDecoder;try{for(;;){const{done:e,value:a}=await t.read();if(e)break;const o=s.decode(a,{stream:!0}).split("\n");for(const t of o)if(t.startsWith("data: ")){const e=t.slice(6);"[DONE]"!==e&&(yield e)}}}finally{t.releaseLock()}}static async*fromChunked(e){if(!e.body)throw new Error("Response body is null");const t=e.body.getReader(),s=new TextDecoder;try{for(;;){const{done:e,value:a}=await t.read();if(e)break;const o=s.decode(a,{stream:!0});yield o}}finally{t.releaseLock()}}static async collectAll(e){let t="";for await(const s of e)t+=s;return t}static async*fromString(e,t=10){for(let s=0;s<e.length;s+=t)yield e.slice(s,s+t),await new Promise(e=>setTimeout(e,50))}static async*map(e,t){for await(const s of e)yield await t(s)}static async*filter(e,t){for await(const s of e)await t(s)&&(yield s)}static async*take(e,t){let s=0;for await(const a of e){if(s>=t)break;yield a,s++}}}class o{constructor(e){this.sql=e}async generateSQL(e,t){const s=await this.sql.textToSQL(e,t);return a.collectAll(s)}async executeSQL(e){return this.sql.executeSQL(e)}async*simulateStreamingSQL(e,t=10,s=50){for(let a=0;a<e.length;a+=t)yield e.slice(a,a+t),await new Promise(e=>setTimeout(e,s))}}const r="1.0.0";export{o as SqlTestClient,r as TEST_UTILS_VERSION,e as createErrorResponse,t as createMockResponse,s as createTestClient};
+import{o as e,p as t,q as s}from"./test-client-BEAX5vfC.mjs";class a{static async*fromSSE(e){if(!e.body)throw new Error("Response body is null");const t=e.body.getReader(),s=new TextDecoder;try{for(;;){const{done:e,value:a}=await t.read();if(e)break;const o=s.decode(a,{stream:!0}).split("\n");for(const t of o)if(t.startsWith("data: ")){const e=t.slice(6);"[DONE]"!==e&&(yield e)}}}finally{t.releaseLock()}}static async*fromChunked(e){if(!e.body)throw new Error("Response body is null");const t=e.body.getReader(),s=new TextDecoder;try{for(;;){const{done:e,value:a}=await t.read();if(e)break;const o=s.decode(a,{stream:!0});yield o}}finally{t.releaseLock()}}static async collectAll(e){let t="";for await(const s of e)t+=s;return t}static async*fromString(e,t=10){for(let s=0;s<e.length;s+=t)yield e.slice(s,s+t),await new Promise(e=>setTimeout(e,50))}static async*map(e,t){for await(const s of e)yield await t(s)}static async*filter(e,t){for await(const s of e)await t(s)&&(yield s)}static async*take(e,t){let s=0;for await(const a of e){if(s>=t)break;yield a,s++}}}class o{constructor(e){this.sql=e}async generateSQL(e,t){const s=await this.sql.textToSQL(e,t);return a.collectAll(s)}async executeSQL(e){return this.sql.executeSQL(e)}async*simulateStreamingSQL(e,t=10,s=50){for(let a=0;a<e.length;a+=t)yield e.slice(a,a+t),await new Promise(e=>setTimeout(e,s))}}const r="1.0.0";export{o as SqlTestClient,r as TEST_UTILS_VERSION,e as createErrorResponse,t as createMockResponse,s as createTestClient};
 //# sourceMappingURL=testing.mjs.map