@flowdular/sdk 0.2.3 → 0.3.0

package/modules/automations/src/services/trigger-service.ts

@@ -17,11 +17,13 @@ import type {
 } from '../domain/types.ts';
 import { AutomationsServiceError } from './automations-service.ts';
 import type {
+	AutomationListPage,
+	AutomationListQuery,
 	AutomationsRepository,
 	StoredAutomationTrigger,
 	StoredAutomationTriggerWithSecret,
 } from './repository.ts';
-import type { SecretVault } from './secret-vault.ts';
+import { secretContext, type SecretVault } from './secret-vault.ts';
 import {
 	createAutomationTargetRegistry,
 	type AutomationTargetJsonValue,
@@ -51,10 +53,6 @@ export interface TriggerFireRequest {
 	readonly timestamp: string | null;
 }
 
-function secretContext(tenantId: string, triggerId: string): string {
-	return `${tenantId}:${triggerId}:automation-trigger`;
-}
-
 function bounded(value: string, field: string, max: number): string {
 	const normalized = value.trim();
 	if (normalized.length < 1 || normalized.length > max) {
@@ -174,12 +172,17 @@ export class AutomationTriggerService {
 		this.#limiter = limiter ?? new TriggerRateLimiter();
 	}
 
-	async list(tenantId: string): Promise<readonly AutomationTrigger[]> {
-		return Promise.all(
-			(await this.repository.listTriggers(tenantId)).map((record) =>
-				this.present(record),
+	async list(
+		tenantId: string,
+		query: AutomationListQuery,
+	): Promise<AutomationListPage<AutomationTrigger>> {
+		const page = await this.repository.listTriggersPage(tenantId, query);
+		return {
+			items: await Promise.all(
+				page.items.map((record) => this.present(record)),
 			),
-		);
+			next: page.next,
+		};
 	}
 
 	async create(

package/modules/automations/translations/en.json

@@ -20,10 +20,14 @@
 	"common.paused": "Paused",
 	"common.refresh": "Refresh",
 	"common.refreshing": "Refreshing…",
+	"common.pagination.previous": "Previous",
+	"common.pagination.next": "Next",
+	"common.pagination.summary": "Page {page} · from row {from}",
 	"common.requestFailed": "The automations operation failed.",
 	"common.saving": "Saving…",
 	"common.state": "State",
 	"common.target": "Target",
+	"common.updated": "Updated",
 	"common.targetUnavailable": "Unavailable {kind}",
 	"common.view": "View",
 	"targetKind.agent": "Agent",
@@ -34,6 +38,7 @@
 	"cadence.hours": "Every {count} hours",
 	"cadence.hoursMinutes": "Every {hours} h {minutes} min",
 	"cadence.minutes": "Every {count} min",
+	"cadence.cron": "Cron {expression}",
 	"schedules.column.cadence": "Cadence",
 	"schedules.column.lastRun": "Last run",
 	"schedules.column.nextRun": "Next run",
@@ -58,6 +63,11 @@
 	"schedules.form.interval": "Every (minutes)",
 	"schedules.form.intervalHelp": "A fixed interval from 1 minute to 7 days. A missed slot is skipped, never replayed.",
 	"schedules.form.labelPlaceholder": "Nightly order summary",
+	"schedules.form.cadenceMode": "Runs",
+	"schedules.form.cadenceModeInterval": "At a fixed interval",
+	"schedules.form.cadenceModeCron": "On a cron expression",
+	"schedules.form.cron": "Cron expression",
+	"schedules.form.cronHelp": "Five fields: minute hour day-of-month month day-of-week. Use *, lists (0,30), ranges (9-17) and steps (*/15). Read in {zone}; a slot the clock change skips is skipped, never replayed.",
 	"schedules.form.noAgents": "No agent is active in this workspace. Activate one before a schedule can queue its runs.",
 	"schedules.form.noTargets": "No agent or published workflow is available with your current permissions.",
 	"schedules.form.save": "Save schedule",
@@ -65,12 +75,14 @@
 	"schedules.new": "New schedule",
 	"schedules.note": "Automatic runs use the permissions saved when the target was configured. An unavailable target stops the schedule and records the reason.",
 	"schedules.notice.queued": "Queued run {id} for {label}.",
+	"schedules.pagination.label": "Schedule pages",
 	"schedules.runNow": "Run now",
 	"schedules.search.label": "Filter schedules",
 	"schedules.search.placeholder": "Filter by label or target",
 	"schedules.table.caption": "Automation schedules",
-	"schedules.table.count": "{enabled} enabled · {total} defined",
+	"schedules.table.count": "{count} on page {page}",
 	"schedules.table.title": "Workspace schedules",
+	"schedules.timeZoneNote": "Times are shown and cron slots are computed in the workspace zone {zone}.",
 	"schedules.title": "Schedules",
 	"template.available": "Available variables",
 	"template.empty": "No matching variables.",
@@ -114,11 +126,12 @@
 	"triggers.loading": "Loading webhook triggers…",
 	"triggers.new": "New trigger",
 	"triggers.note": "Every rejected request returns the same response. Requests are limited per trigger and signatures older than five minutes are refused.",
+	"triggers.pagination.label": "Trigger pages",
 	"triggers.search.label": "Filter webhook triggers",
 	"triggers.search.placeholder": "Filter by label or target",
 	"triggers.secretRevision": "secret r{revision}",
 	"triggers.table.caption": "Webhook triggers",
-	"triggers.table.count": "{enabled} enabled · {total} defined",
+	"triggers.table.count": "{count} on page {page}",
 	"triggers.table.title": "Workspace triggers",
 	"triggers.title": "Webhook triggers",
 	"settings.schedulerPollMs.label": "Scheduler poll interval (ms)",

package/modules/automations/translations/pl.json

@@ -20,10 +20,14 @@
 	"common.paused": "Wstrzymany",
 	"common.refresh": "Odśwież",
 	"common.refreshing": "Odświeżanie…",
+	"common.pagination.previous": "Poprzednia",
+	"common.pagination.next": "Następna",
+	"common.pagination.summary": "Strona {page} · od wiersza {from}",
 	"common.requestFailed": "Operacja automatyzacji nie powiodła się.",
 	"common.saving": "Zapisywanie…",
 	"common.state": "Stan",
 	"common.target": "Cel",
+	"common.updated": "Zaktualizowano",
 	"common.targetUnavailable": "Niedostępny cel: {kind}",
 	"common.view": "Zobacz",
 	"targetKind.agent": "Agent",
@@ -34,6 +38,7 @@
 	"cadence.hours": "Co {count} godz.",
 	"cadence.hoursMinutes": "Co {hours} godz. {minutes} min",
 	"cadence.minutes": "Co {count} min",
+	"cadence.cron": "Cron {expression}",
 	"schedules.column.cadence": "Częstotliwość",
 	"schedules.column.lastRun": "Ostatnie uruchomienie",
 	"schedules.column.nextRun": "Następne uruchomienie",
@@ -58,6 +63,11 @@
 	"schedules.form.interval": "Co ile minut",
 	"schedules.form.intervalHelp": "Stały odstęp od 1 minuty do 7 dni. Pominięty termin nie jest uruchamiany ponownie.",
 	"schedules.form.labelPlaceholder": "Nocne podsumowanie zamówień",
+	"schedules.form.cadenceMode": "Uruchamianie",
+	"schedules.form.cadenceModeInterval": "W stałych odstępach",
+	"schedules.form.cadenceModeCron": "Według wyrażenia cron",
+	"schedules.form.cron": "Wyrażenie cron",
+	"schedules.form.cronHelp": "Pięć pól: minuta godzina dzień-miesiąca miesiąc dzień-tygodnia. Użyj *, list (0,30), zakresów (9-17) i kroków (*/15). Odczyt w strefie {zone}; termin pominięty przez zmianę czasu nie jest uruchamiany ponownie.",
 	"schedules.form.noAgents": "W tej przestrzeni nie ma aktywnego agenta. Aktywuj agenta, zanim harmonogram zacznie dodawać przebiegi do kolejki.",
 	"schedules.form.noTargets": "Przy obecnych uprawnieniach nie jest dostępny żaden agent ani opublikowany workflow.",
 	"schedules.form.save": "Zapisz harmonogram",
@@ -65,12 +75,14 @@
 	"schedules.new": "Nowy harmonogram",
 	"schedules.note": "Automatyczne przebiegi używają uprawnień zapisanych podczas konfiguracji celu. Niedostępny cel zatrzymuje harmonogram i zapisuje przyczynę.",
 	"schedules.notice.queued": "Dodano przebieg {id} dla harmonogramu {label}.",
+	"schedules.pagination.label": "Strony harmonogramów",
 	"schedules.runNow": "Uruchom teraz",
 	"schedules.search.label": "Filtruj harmonogramy",
 	"schedules.search.placeholder": "Szukaj po nazwie lub celu",
 	"schedules.table.caption": "Harmonogramy automatyzacji",
-	"schedules.table.count": "włączone: {enabled} · wszystkie: {total}",
+	"schedules.table.count": "na stronie {page}: {count}",
 	"schedules.table.title": "Harmonogramy obszaru roboczego",
+	"schedules.timeZoneNote": "Czasy są pokazywane, a terminy cron wyliczane w strefie obszaru roboczego {zone}.",
 	"schedules.title": "Harmonogramy",
 	"template.available": "Dostępne zmienne",
 	"template.empty": "Brak pasujących zmiennych.",
@@ -114,11 +126,12 @@
 	"triggers.loading": "Wczytywanie wyzwalaczy webhook…",
 	"triggers.new": "Nowy wyzwalacz",
 	"triggers.note": "Każde odrzucone żądanie dostaje tę samą odpowiedź. Obowiązuje limit na wyzwalacz, a podpisy starsze niż pięć minut są odrzucane.",
+	"triggers.pagination.label": "Strony wyzwalaczy",
 	"triggers.search.label": "Filtruj wyzwalacze webhook",
 	"triggers.search.placeholder": "Szukaj po nazwie lub celu",
 	"triggers.secretRevision": "sekret r{revision}",
 	"triggers.table.caption": "Wyzwalacze webhook",
-	"triggers.table.count": "włączone: {enabled} · wszystkie: {total}",
+	"triggers.table.count": "na stronie {page}: {count}",
 	"triggers.table.title": "Wyzwalacze obszaru roboczego",
 	"triggers.title": "Wyzwalacze webhook",
 	"settings.schedulerPollMs.label": "Częstotliwość sprawdzania harmonogramów (ms)",

package/modules/connectors/migrations/0001_connectors_core.down.sql

@@ -0,0 +1,3 @@
+DROP TABLE IF EXISTS connectors_audit;
+DROP TABLE IF EXISTS connectors_calls;
+DROP TABLE IF EXISTS connectors_instances;

package/modules/connectors/migrations/0001_connectors_core.up.sql

@@ -0,0 +1,72 @@
+CREATE TABLE IF NOT EXISTS connectors_instances (
+  id TEXT PRIMARY KEY,
+  tenant_id TEXT NOT NULL,
+  definition_key TEXT NOT NULL,
+  name TEXT NOT NULL,
+  name_normalized TEXT NOT NULL,
+  base_url TEXT NOT NULL,
+  auth_kind TEXT NOT NULL CHECK (auth_kind IN ('none', 'api-key', 'bearer', 'oauth2-client-credentials')),
+  credential_key_id TEXT,
+  credential_iv TEXT,
+  credential_tag TEXT,
+  credential_ciphertext TEXT,
+  credential_fingerprint TEXT,
+  allowed_hosts_json TEXT NOT NULL,
+  allow_workflows SMALLINT NOT NULL DEFAULT 0 CHECK (allow_workflows IN (0, 1)),
+  allow_agents SMALLINT NOT NULL DEFAULT 0 CHECK (allow_agents IN (0, 1)),
+  status TEXT NOT NULL CHECK (status IN ('active', 'disabled')),
+  last_call_at BIGINT,
+  created_at BIGINT NOT NULL,
+  updated_at BIGINT NOT NULL
+);
+CREATE UNIQUE INDEX IF NOT EXISTS connectors_instances_name_normalized_idx
+  ON connectors_instances (tenant_id, name_normalized);
+CREATE INDEX IF NOT EXISTS connectors_instances_tenant_status_idx
+  ON connectors_instances (tenant_id, status, name_normalized);
+ALTER TABLE connectors_instances ENABLE ROW LEVEL SECURITY;
+ALTER TABLE connectors_instances FORCE ROW LEVEL SECURITY;
+CREATE POLICY connectors_instances_tenant_policy ON connectors_instances
+  USING (tenant_id = current_setting('coreloom.tenant_id', true))
+  WITH CHECK (tenant_id = current_setting('coreloom.tenant_id', true));
+
+CREATE TABLE IF NOT EXISTS connectors_calls (
+  id TEXT PRIMARY KEY,
+  tenant_id TEXT NOT NULL,
+  instance_id TEXT NOT NULL,
+  operation TEXT NOT NULL,
+  caller TEXT NOT NULL CHECK (caller IN ('test', 'workflow', 'agent')),
+  caller_ref TEXT,
+  outcome TEXT NOT NULL CHECK (outcome IN ('succeeded', 'failed', 'refused')),
+  status INTEGER,
+  error_class TEXT,
+  duration_ms INTEGER NOT NULL,
+  request_bytes INTEGER NOT NULL,
+  response_bytes INTEGER NOT NULL,
+  occurred_at BIGINT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS connectors_calls_tenant_time_idx
+  ON connectors_calls (tenant_id, occurred_at DESC, id DESC);
+CREATE INDEX IF NOT EXISTS connectors_calls_instance_idx
+  ON connectors_calls (tenant_id, instance_id, occurred_at DESC);
+ALTER TABLE connectors_calls ENABLE ROW LEVEL SECURITY;
+ALTER TABLE connectors_calls FORCE ROW LEVEL SECURITY;
+CREATE POLICY connectors_calls_tenant_policy ON connectors_calls
+  USING (tenant_id = current_setting('coreloom.tenant_id', true))
+  WITH CHECK (tenant_id = current_setting('coreloom.tenant_id', true));
+
+CREATE TABLE IF NOT EXISTS connectors_audit (
+  id TEXT PRIMARY KEY,
+  tenant_id TEXT NOT NULL,
+  actor_id TEXT NOT NULL,
+  action TEXT NOT NULL CHECK (action IN ('instance.created', 'instance.updated', 'instance.consent-changed', 'instance.enabled', 'instance.disabled', 'instance.deleted')),
+  instance_id TEXT NOT NULL,
+  metadata_json TEXT NOT NULL,
+  occurred_at BIGINT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS connectors_audit_tenant_time_idx
+  ON connectors_audit (tenant_id, occurred_at DESC, id DESC);
+ALTER TABLE connectors_audit ENABLE ROW LEVEL SECURITY;
+ALTER TABLE connectors_audit FORCE ROW LEVEL SECURITY;
+CREATE POLICY connectors_audit_tenant_policy ON connectors_audit
+  USING (tenant_id = current_setting('coreloom.tenant_id', true))
+  WITH CHECK (tenant_id = current_setting('coreloom.tenant_id', true));

package/modules/connectors/migrations/0002_connectors_call_keys.down.sql

@@ -0,0 +1,3 @@
+DROP POLICY IF EXISTS connectors_call_keys_tenant_policy ON connectors_call_keys;
+DROP INDEX IF EXISTS connectors_call_keys_tenant_claimed_idx;
+DROP TABLE IF EXISTS connectors_call_keys;

package/modules/connectors/migrations/0002_connectors_call_keys.up.sql

@@ -0,0 +1,18 @@
+CREATE TABLE IF NOT EXISTS connectors_call_keys (
+  id TEXT PRIMARY KEY,
+  tenant_id TEXT NOT NULL,
+  idempotency_key TEXT NOT NULL CHECK (length(idempotency_key) BETWEEN 8 AND 128),
+  operation_id TEXT NOT NULL CHECK (length(operation_id) BETWEEN 3 AND 200),
+  input_digest TEXT NOT NULL CHECK (length(input_digest) = 64),
+  call_id TEXT,
+  claimed_at BIGINT NOT NULL,
+  completed_at BIGINT,
+  UNIQUE (tenant_id, idempotency_key)
+);
+CREATE INDEX IF NOT EXISTS connectors_call_keys_tenant_claimed_idx
+  ON connectors_call_keys (tenant_id, claimed_at, id);
+ALTER TABLE connectors_call_keys ENABLE ROW LEVEL SECURITY;
+ALTER TABLE connectors_call_keys FORCE ROW LEVEL SECURITY;
+CREATE POLICY connectors_call_keys_tenant_policy ON connectors_call_keys
+  USING (tenant_id = current_setting('coreloom.tenant_id', true))
+  WITH CHECK (tenant_id = current_setting('coreloom.tenant_id', true));

package/modules/connectors/migrations/README.md

@@ -0,0 +1,3 @@
+# Migrations
+
+Migrations in this directory are append-only after release.

package/modules/connectors/module.json

@@ -0,0 +1,28 @@
+{
+	"$schema": "../../packages/contracts/schemas/module.schema.json",
+	"schemaVersion": 1,
+	"id": "connectors.core",
+	"package": "@flowdular/module-connectors",
+	"version": "0.1.5",
+	"platformApi": "^0.1.0",
+	"profile": "full",
+	"capabilities": ["api", "database", "client", "translations"],
+	"platform": {
+		"server": true,
+		"client": true
+	},
+	"dependencies": [
+		{
+			"id": "system.core",
+			"range": "^0.7.0"
+		},
+		{
+			"id": "auth.core",
+			"range": "^0.13.0"
+		}
+	],
+	"tenancy": "required",
+	"locales": ["en", "pl"],
+	"stability": "experimental",
+	"provides": ["connectors.definitions.v1", "connectors.calls.v1"]
+}

package/modules/{automations-workflows-integration → connectors}/package.json

@@ -1,36 +1,15 @@
 {
-	"name": "@flowdular/module-automations-workflows-integration",
-	"version": "0.1.0",
+	"name": "@flowdular/module-connectors",
+	"version": "0.1.5",
+	"private": true,
 	"type": "module",
 	"exports": {
 		".": "./src/index.ts",
+		"./client": "./src/client/index.ts",
 		"./server": "./src/server/index.ts",
 		"./platform": "./src/platform.ts",
 		"./module.json": "./module.json"
 	},
-	"scripts": {
-		"typecheck": "tsc --noEmit -p tsconfig.json",
-		"test": "vitest run"
-	},
-	"dependencies": {
-		"@flowdular/contracts": "workspace:*",
-		"@flowdular/harness": "workspace:*",
-		"@flowdular/kernel": "workspace:*",
-		"@flowdular/module-auth": "workspace:*",
-		"@flowdular/module-automations": "workspace:*",
-		"@flowdular/module-workflows": "workspace:*"
-	},
-	"devDependencies": {
-		"@types/node": "24.13.3",
-		"typescript": "5.9.3",
-		"vitest": "4.1.11"
-	},
-	"license": "MIT",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/Flowdular/flowdular.git",
-		"directory": "modules/automations-workflows-integration"
-	},
 	"files": [
 		"src",
 		"schemas",
@@ -44,5 +23,27 @@
 		"README.md",
 		"LICENSE"
 	],
-	"private": true
+	"scripts": {
+		"typecheck": "tsrx-tsc --noEmit -p tsconfig.json",
+		"test": "vitest run"
+	},
+	"dependencies": {
+		"@flowdular/client": "workspace:*",
+		"@flowdular/contracts": "workspace:*",
+		"@flowdular/database": "workspace:*",
+		"@flowdular/harness": "workspace:*",
+		"@flowdular/kernel": "workspace:*",
+		"@flowdular/module-auth": "workspace:*",
+		"@flowdular/server": "workspace:*",
+		"@flowdular/ui": "workspace:*",
+		"octane": "0.1.51",
+		"segment-state": "0.2.1"
+	},
+	"devDependencies": {
+		"@flowdular/database-testing": "workspace:*",
+		"@tsrx/typescript-plugin": "0.3.120",
+		"@types/node": "24.13.3",
+		"typescript": "5.9.3",
+		"vitest": "4.1.11"
+	}
 }