@bluecopa/core 0.1.57 → 0.1.59

package/README.md

@@ -24,6 +24,7 @@ The core package provides essential API utilities and functions for data managem
     - [Quick Start](#quick-start)
     - [CRUD](#crud)
     - [Query Operators](#query-operators)
+    - [Aggregate Queries](#aggregate-queries)
     - [Framework Integration](#framework-integration)
     - [WebSocket Provider (optional)](#websocket-provider-optional)
     - [Cleanup](#cleanup)
@@ -248,6 +249,70 @@ const unsub = copaInputTableDb.collection("invoices").count((n) => console.log(n
 | `in`      | in array        |
 | `not-in`  | not in array    |
 
+### Aggregate Queries
+
+Compute server-side aggregates (`sum`, `avg`, `count`, `min`, `max`) without fetching all rows. Combines with `where()`, `limit()`, and `skip()` filters.
+
+```typescript
+// Column aggregates
+const result = await copaInputTableDb
+  .collection("invoices")
+  .where("status", "==", "active")
+  .aggregate({ amount: ["sum", "avg"], price: ["min", "max"] });
+// => { amount: { sum: 1234.56, avg: 123.45 }, price: { min: 10, max: 999 } }
+
+// Row count
+const result = await copaInputTableDb
+  .collection("invoices")
+  .aggregate({ _count: true });
+// => { _count: 42 }
+
+// Column count (non-null values) + row count
+const result = await copaInputTableDb
+  .collection("invoices")
+  .aggregate({ name: ["count"], _count: true });
+// => { name: { count: 38 }, _count: 42 }
+```
+
+`.aggregate()` is a **terminal method** — it bypasses local RxDB and hits PostgREST directly. Errors throw `InputTableError`. An empty spec `{}` returns `{}` without calling the API.
+
+### Grouped Aggregates
+
+Add a `{ groupBy: [...columns] }` second argument to get per-group breakdowns. Returns an array instead of a single object.
+
+```typescript
+// Sum per status group
+const rows = await copaInputTableDb
+  .collection("invoices")
+  .aggregate({ amount: ["sum"] }, { groupBy: ["status"] });
+// => [{ status: "active", amount: { sum: 1234 } }, { status: "draft", amount: { sum: 100 } }]
+
+// Multi-column groupBy with filters and ordering
+const rows = await copaInputTableDb
+  .collection("invoices")
+  .where("year", "==", 2024)
+  .orderBy("order_date", "asc")
+  .aggregate({ amount: ["sum", "avg"] }, { groupBy: ["order_date", "status"] });
+
+// Count per group
+const rows = await copaInputTableDb
+  .collection("invoices")
+  .aggregate({ _count: true }, { groupBy: ["status"] });
+// => [{ status: "active", _count: 10 }, { status: "draft", _count: 4 }]
+
+// Distinct values (no aggregate functions)
+const rows = await copaInputTableDb
+  .collection("invoices")
+  .aggregate({}, { groupBy: ["status"] });
+// => [{ status: "active" }, { status: "draft" }]
+```
+
+**Notes:**
+- `orderBy()` is forwarded to PostgREST when `groupBy` is present (ignored otherwise)
+- `limit()`/`skip()` apply to the number of _groups_, not input rows
+- A column cannot appear in both the aggregate spec and `groupBy` — throws `InputTableError`
+- Empty `groupBy: []` behaves like no groupBy — returns a single object
+
 ### Framework Integration
 
 **Svelte 5**

package/dist/api/index.d.ts

@@ -21,3 +21,4 @@ export * as permissions from './permissions';
 export * as clientIp from './clientIp';
 export * as emailEngine from './emailEngine';
 export * as tcn from './tcn';
+export * as webcron from './webcron';

package/dist/api/webcron/executions.d.ts

@@ -0,0 +1,4 @@
+import { Execution, ListExecutionsParams } from './types';
+export declare function listExecutions(params?: ListExecutionsParams): Promise<Execution[]>;
+export declare function getExecution(id: string): Promise<Execution>;
+export declare function retryExecution(id: string): Promise<Execution>;

package/dist/api/webcron/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types';
+export * from './webhooks';
+export * from './schedules';
+export * from './executions';
+export * from './tasks';
+export * from './inspection';
+export * from './trigger';

package/dist/api/webcron/inspection.d.ts

@@ -0,0 +1,7 @@
+import { InspectionBin, CreateInspectionBinRequest, InspectionRequest, PaginationParams } from './types';
+export declare function listBins(): Promise<InspectionBin[]>;
+export declare function createBin(data: CreateInspectionBinRequest): Promise<InspectionBin>;
+export declare function getBin(id: string): Promise<InspectionBin>;
+export declare function deleteBin(id: string): Promise<void>;
+export declare function getBinRequests(id: string, params?: PaginationParams): Promise<InspectionRequest[]>;
+export declare function clearBinRequests(id: string): Promise<void>;

package/dist/api/webcron/schedules.d.ts

@@ -0,0 +1,9 @@
+import { Schedule, UpdateScheduleRequest } from './types';
+export declare function getSchedule(id: string): Promise<Schedule>;
+export declare function updateSchedule(id: string, data: UpdateScheduleRequest): Promise<Schedule>;
+export declare function deleteSchedule(id: string): Promise<void>;
+export declare function pauseSchedule(id: string): Promise<Schedule>;
+export declare function resumeSchedule(id: string): Promise<Schedule>;
+export declare function triggerSchedule(id: string): Promise<{
+    executionId: string;
+}>;

package/dist/api/webcron/tasks.d.ts

@@ -0,0 +1,10 @@
+import { Task, CreateTaskRequest, TaskProgressRequest, TaskSignalRequest } from './types';
+export declare function listTasks(): Promise<Task[]>;
+export declare function createTask(data: CreateTaskRequest): Promise<Task>;
+export declare function getTask(id: string): Promise<Task>;
+export declare function cancelTask(id: string): Promise<Task>;
+export declare function retryTask(id: string): Promise<{
+    taskId: string;
+}>;
+export declare function progressTask(id: string, data: TaskProgressRequest): Promise<void>;
+export declare function signalTask(id: string, data: TaskSignalRequest, branchId?: string): Promise<Task>;

package/dist/api/webcron/trigger.d.ts

@@ -0,0 +1,15 @@
+export interface TriggerWorkflowRequest {
+    triggerData?: Record<string, unknown>;
+}
+export interface TriggerWorkflowResponse {
+    workflow_id: string;
+    trigger_id: string;
+    workflow_instance_id: string;
+}
+/**
+ * Triggers a workflow execution by process sheet ID
+ * @param id - The workflow/process sheet ID
+ * @param data - Optional trigger data payload
+ * @returns Trigger response with workflow instance details
+ */
+export declare function triggerWorkflowById(id: string, data?: TriggerWorkflowRequest): Promise<TriggerWorkflowResponse[]>;

package/dist/api/webcron/types.d.ts

@@ -0,0 +1,170 @@
+export interface Webhook {
+    id: string;
+    name: string;
+    description?: string;
+    url: string;
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: string;
+    maxRetries: number;
+    retryDelaySeconds: number;
+    timeoutSeconds: number;
+    authType?: ("hmac" | "basic" | "bearer")[];
+    notificationUrl?: string;
+    notifyOnSuccess: boolean;
+    notifyOnFailure: boolean;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateWebhookRequest {
+    name: string;
+    description?: string;
+    url: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: string;
+    maxRetries?: number;
+    retryDelaySeconds?: number;
+    timeoutSeconds?: number;
+    authType?: ("hmac" | "basic" | "bearer")[];
+    signingSecret?: string;
+    basicAuthUsername?: string;
+    basicAuthPassword?: string;
+    bearerToken?: string;
+    notificationUrl?: string;
+    notifyOnSuccess?: boolean;
+    notifyOnFailure?: boolean;
+    isActive?: boolean;
+}
+export interface UpdateWebhookRequest extends Partial<CreateWebhookRequest> {
+}
+export interface Schedule {
+    id: string;
+    webhookId: string;
+    type: "one_time" | "recurring";
+    scheduledAt?: string;
+    cronExpression?: string;
+    timezone?: string;
+    status: "active" | "paused" | "completed" | "cancelled";
+    lastRunAt?: string;
+    nextRunAt?: string;
+    runCount: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateScheduleRequest {
+    type: "one_time" | "recurring";
+    scheduledAt?: string;
+    cronExpression?: string;
+    timezone?: string;
+}
+export interface UpdateScheduleRequest {
+    cronExpression?: string;
+    timezone?: string;
+}
+export interface Execution {
+    id: string;
+    webhookId: string;
+    scheduleId?: string;
+    status: "pending" | "running" | "success" | "failed" | "retrying";
+    attemptNumber: number;
+    maxAttempts: number;
+    requestUrl: string;
+    requestMethod: string;
+    requestHeaders?: Record<string, string>;
+    requestBody?: string;
+    responseStatus?: number;
+    responseHeaders?: Record<string, string>;
+    responseBody?: string;
+    startedAt?: string;
+    completedAt?: string;
+    durationMs?: number;
+    errorMessage?: string;
+    errorCode?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ListExecutionsParams {
+    limit?: number;
+    offset?: number;
+    status?: string;
+    webhookId?: string;
+    from?: string;
+    to?: string;
+}
+export interface Task {
+    id: string;
+    status: "pending" | "running" | "waiting" | "sleeping" | "fan_out" | "complete" | "failed" | "cancelled";
+    webhookId: string;
+    initialInput?: Record<string, unknown>;
+    continuation?: Record<string, unknown>;
+    currentStep: number;
+    form?: Record<string, unknown>;
+    result?: Record<string, unknown>;
+    error?: string;
+    errorCode?: string;
+    parentTaskId?: string;
+    branchId?: string;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+}
+export interface CreateTaskRequest {
+    webhookId: string;
+    initialInput?: Record<string, unknown>;
+    maxSteps?: number;
+    stepTimeoutMs?: number;
+}
+export interface TaskProgressRequest {
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface TaskSignalRequest {
+    payload: Record<string, unknown>;
+}
+export interface InspectionBin {
+    id: string;
+    name: string;
+    slug: string;
+    responseStatusCode: number;
+    responseHeaders?: Record<string, string>;
+    responseBody?: string;
+    responseDelayMs: number;
+    maxRequests: number;
+    requestCount: number;
+    expiresAt?: string;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateInspectionBinRequest {
+    name: string;
+    responseStatusCode?: number;
+    responseHeaders?: Record<string, string>;
+    responseBody?: string;
+    responseDelayMs?: number;
+    maxRequests?: number;
+}
+export interface InspectionRequest {
+    id: string;
+    binId: string;
+    method: string;
+    path: string;
+    queryString?: string;
+    headers: Record<string, string>;
+    body?: string;
+    contentType?: string;
+    clientIp?: string;
+    userAgent?: string;
+    receivedAt: string;
+}
+export interface PaginationParams {
+    limit?: number;
+    offset?: number;
+}
+export interface WebcronHealth {
+    status: string;
+    database: string;
+    timestamp: string;
+}

package/dist/api/webcron/webhooks.d.ts

@@ -0,0 +1,12 @@
+import { Webhook, CreateWebhookRequest, UpdateWebhookRequest, Schedule, Execution, CreateScheduleRequest, PaginationParams } from './types';
+export declare function listWebhooks(): Promise<Webhook[]>;
+export declare function createWebhook(data: CreateWebhookRequest): Promise<Webhook>;
+export declare function getWebhook(id: string): Promise<Webhook>;
+export declare function updateWebhook(id: string, data: UpdateWebhookRequest): Promise<Webhook>;
+export declare function deleteWebhook(id: string): Promise<void>;
+export declare function testWebhook(id: string): Promise<{
+    executionId: string;
+}>;
+export declare function getWebhookExecutions(id: string, params?: PaginationParams): Promise<Execution[]>;
+export declare function getWebhookSchedules(id: string): Promise<Schedule[]>;
+export declare function createWebhookSchedule(webhookId: string, data: CreateScheduleRequest): Promise<Schedule>;

package/dist/config.d.ts

@@ -6,6 +6,8 @@ export interface Config {
     workspaceId: string;
     userId: string;
     solutionId?: string;
+    solutionBranch?: string;
+    solutionBranchType?: string;
     websocketProvider?: IWebsocketProvider;
 }
 declare class ConfigSingleton {

package/dist/index.d.ts

@@ -44,3 +44,5 @@ export type { TcnProcessDialData } from './api/tcn/processManualDial';
 export type { TcnConnectedParty } from './api/tcn/agentGetConnectedParty';
 export type { TcnCallData } from './api/tcn/getCallData';
 export type { FilterOnSenderId, EmailMessage, PageChunkEmailMessage, } from './api/emailEngine/getMessageBySenderId';
+export type { Webhook, CreateWebhookRequest, UpdateWebhookRequest, Schedule, CreateScheduleRequest, UpdateScheduleRequest, Execution, ListExecutionsParams, Task, CreateTaskRequest, TaskProgressRequest, TaskSignalRequest, InspectionBin, CreateInspectionBinRequest, InspectionRequest, PaginationParams, WebcronHealth, } from './api/webcron/types';
+export type { TriggerWorkflowRequest, TriggerWorkflowResponse, } from './api/webcron/trigger';