@oobe-protocol-labs/synapse-sap-sdk 0.1.0

package/dist/types/plugin/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugin/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4ExB;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiHf,CAAC;AAMX;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDlB,CAAC;AAMX;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CrB,CAAC;AAMX;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8EhB,CAAC;AAMX;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Hf,CAAC;AAMX;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoIf,CAAC;AAMX;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsElB,CAAC;AAMX;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkFhB,CAAC"}

package/dist/types/postgres/adapter.d.ts

@@ -0,0 +1,355 @@
+/**
+ * @module postgres/adapter
+ * @description PostgreSQL adapter for SAP v2 — syncs on-chain accounts
+ * to a relational database for off-chain querying and analytics.
+ *
+ * The adapter uses `pg` (node-postgres) as the database driver.
+ * It is database-driver agnostic at the interface level — you can
+ * substitute any client that implements the `PgClient` interface.
+ *
+ * @category Postgres
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { SapPostgres } from "@synapse-sap/sdk/postgres";
+ * import { Pool } from "pg";
+ *
+ * const pool = new Pool({ connectionString: "postgresql://..." });
+ * const pg = new SapPostgres(pool, sapClient);
+ *
+ * // Run schema migration
+ * await pg.migrate();
+ *
+ * // Sync all agents to PostgreSQL
+ * await pg.syncAgents();
+ *
+ * // Full sync (all account types)
+ * await pg.syncAll();
+ *
+ * // Query off-chain
+ * const agents = await pg.query("SELECT * FROM sap_agents WHERE is_active = true");
+ * ```
+ */
+import type { SapClient } from "../core/client";
+import type { SyncOptions, SyncCursorRow, SapAccountType } from "./types";
+/**
+ * @interface PgClient
+ * @description Minimal PostgreSQL client interface.
+ * Compatible with `pg.Pool`, `pg.Client`, or any wrapper
+ * that provides `query()`.
+ * @category Postgres
+ * @since v0.1.0
+ */
+export interface PgClient {
+    query(text: string, values?: unknown[]): Promise<{
+        rows: unknown[];
+        rowCount: number;
+    }>;
+}
+/**
+ * @name SapPostgres
+ * @description PostgreSQL off-chain mirror for SAP v2 on-chain data.
+ *
+ * Connects to a PostgreSQL database and synchronizes all 22 on-chain
+ * account types into relational tables. Supports incremental sync,
+ * event logging, and cursor-based pagination.
+ *
+ * @category Postgres
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { SapPostgres } from "@synapse-sap/sdk/postgres";
+ * import { Pool } from "pg";
+ * import { SapClient } from "@synapse-sap/sdk";
+ *
+ * const pool = new Pool({ connectionString: process.env.DATABASE_URL });
+ * const sap = SapClient.from(provider);
+ * const pg = new SapPostgres(pool, sap);
+ *
+ * await pg.migrate();        // Create tables
+ * await pg.syncAll();         // Mirror on-chain state
+ *
+ * // Read from PostgreSQL
+ * const { rows } = await pg.query(
+ *   "SELECT * FROM sap_agents WHERE is_active = true ORDER BY reputation_score DESC"
+ * );
+ * ```
+ */
+export declare class SapPostgres {
+    private readonly db;
+    private readonly client;
+    private readonly debug;
+    constructor(db: PgClient, client: SapClient, debug?: boolean);
+    /**
+     * @name migrate
+     * @description Run the SQL schema migration to create all SAP tables,
+     * indexes, views, and enum types. Safe to call multiple times
+     * (uses `CREATE IF NOT EXISTS`).
+     * @returns {Promise<void>}
+     * @since v0.1.0
+     */
+    migrate(): Promise<void>;
+    /**
+     * @name migrateWithSQL
+     * @description Run migration with a custom SQL string.
+     * Useful when the schema.sql file is bundled differently.
+     * @param sql - The full SQL schema to execute.
+     * @since v0.1.0
+     */
+    migrateWithSQL(sql: string): Promise<void>;
+    /**
+     * @name query
+     * @description Execute a raw SQL query against the database.
+     * @param text - SQL query string.
+     * @param values - Parameterized values.
+     * @returns Query result with rows and rowCount.
+     * @since v0.1.0
+     */
+    query<T = unknown>(text: string, values?: unknown[]): Promise<{
+        rows: T[];
+        rowCount: number;
+    }>;
+    /**
+     * @name upsert
+     * @description Insert or update a row in the specified table.
+     * Uses `ON CONFLICT (pda) DO UPDATE` for idempotent writes.
+     * @param table - Target table name.
+     * @param row - Key-value record to insert.
+     * @since v0.1.0
+     */
+    upsert(table: string, row: Record<string, unknown>): Promise<void>;
+    /**
+     * @name upsertBatch
+     * @description Upsert multiple rows in a single transaction.
+     * @param table - Target table name.
+     * @param rows - Array of key-value records.
+     * @since v0.1.0
+     */
+    upsertBatch(table: string, rows: Record<string, unknown>[]): Promise<void>;
+    /**
+     * @name getCursor
+     * @description Get the sync cursor for a given account type.
+     * @param accountType - The account type to check.
+     * @since v0.1.0
+     */
+    getCursor(accountType: SapAccountType): Promise<SyncCursorRow | null>;
+    /**
+     * @name updateCursor
+     * @description Update the sync cursor after a successful sync.
+     * @param accountType - The account type synced.
+     * @param slot - The last synced slot.
+     * @param signature - Optional last TX signature.
+     * @since v0.1.0
+     */
+    updateCursor(accountType: SapAccountType | string, slot: number, signature?: string): Promise<void>;
+    /**
+     * @name syncGlobal
+     * @description Sync the GlobalRegistry singleton to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncGlobal(): Promise<void>;
+    /**
+     * @name syncAgents
+     * @description Sync all AgentAccount PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncAgents(): Promise<number>;
+    /**
+     * @name syncAgentStats
+     * @description Sync all AgentStats PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncAgentStats(): Promise<number>;
+    /**
+     * @name syncFeedbacks
+     * @description Sync all FeedbackAccount PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncFeedbacks(): Promise<number>;
+    /**
+     * @name syncTools
+     * @description Sync all ToolDescriptor PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncTools(): Promise<number>;
+    /**
+     * @name syncEscrows
+     * @description Sync all EscrowAccount PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncEscrows(): Promise<number>;
+    /**
+     * @name syncAttestations
+     * @description Sync all AgentAttestation PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncAttestations(): Promise<number>;
+    /**
+     * @name syncVaults
+     * @description Sync all MemoryVault PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncVaults(): Promise<number>;
+    /**
+     * @name syncSessions
+     * @description Sync all SessionLedger PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncSessions(): Promise<number>;
+    /**
+     * @name syncLedgers
+     * @description Sync all MemoryLedger PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncLedgers(): Promise<number>;
+    /**
+     * @name syncLedgerPages
+     * @description Sync all LedgerPage PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncLedgerPages(): Promise<number>;
+    /**
+     * @name syncCapabilityIndexes
+     * @description Sync all CapabilityIndex PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncCapabilityIndexes(): Promise<number>;
+    /**
+     * @name syncProtocolIndexes
+     * @description Sync all ProtocolIndex PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncProtocolIndexes(): Promise<number>;
+    /**
+     * @name syncToolCategoryIndexes
+     * @description Sync all ToolCategoryIndex PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncToolCategoryIndexes(): Promise<number>;
+    /**
+     * @name syncEpochPages
+     * @description Sync all EpochPage PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncEpochPages(): Promise<number>;
+    /**
+     * @name syncDelegates
+     * @description Sync all VaultDelegate PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncDelegates(): Promise<number>;
+    /**
+     * @name syncCheckpoints
+     * @description Sync all SessionCheckpoint PDAs to PostgreSQL.
+     * @since v0.1.0
+     */
+    syncCheckpoints(): Promise<number>;
+    /**
+     * @name syncAll
+     * @description Sync all on-chain account types to PostgreSQL.
+     *
+     * Fetches every account via `program.account.*.all()` and
+     * upserts into the corresponding table. Reports progress
+     * via the `onProgress` callback.
+     *
+     * @param options - Optional sync configuration.
+     * @returns Summary of synced account counts.
+     * @since v0.1.0
+     *
+     * @example
+     * ```ts
+     * const result = await pg.syncAll({
+     *   onProgress: (synced, total, type) => {
+     *     console.log(`[${type}] ${synced}/${total}`);
+     *   },
+     * });
+     * console.log("Total synced:", result.totalRecords);
+     * ```
+     */
+    syncAll(options?: SyncOptions): Promise<SyncAllResult>;
+    /**
+     * @name syncEvent
+     * @description Store a parsed SAP event in the events log table.
+     * @param eventName - The event name (e.g. "RegisteredEvent").
+     * @param txSignature - The transaction signature.
+     * @param slot - The Solana slot.
+     * @param data - The parsed event data.
+     * @param agentPda - Optional agent PDA for indexing.
+     * @param wallet - Optional wallet for indexing.
+     * @since v0.1.0
+     */
+    syncEvent(eventName: string, txSignature: string, slot: number, data: Record<string, unknown>, agentPda?: string, wallet?: string): Promise<void>;
+    /**
+     * @name getAgent
+     * @description Fetch a single agent by PDA or wallet.
+     * @param pdaOrWallet - Agent PDA (base58) or owner wallet.
+     * @since v0.1.0
+     */
+    getAgent(pdaOrWallet: string): Promise<unknown | null>;
+    /**
+     * @name getActiveAgents
+     * @description Fetch all active agents, ordered by reputation.
+     * @param limit - Max agents to return (default: 100).
+     * @since v0.1.0
+     */
+    getActiveAgents(limit?: number): Promise<unknown[]>;
+    /**
+     * @name getEscrowBalance
+     * @description Fetch escrow balance for a specific agent/depositor pair.
+     * @param agentPda - Agent PDA (base58).
+     * @param depositor - Depositor wallet (base58).
+     * @since v0.1.0
+     */
+    getEscrowBalance(agentPda: string, depositor: string): Promise<unknown | null>;
+    /**
+     * @name getAgentTools
+     * @description Fetch all active tools for a given agent.
+     * @param agentPda - Agent PDA (base58).
+     * @since v0.1.0
+     */
+    getAgentTools(agentPda: string): Promise<unknown[]>;
+    /**
+     * @name getRecentEvents
+     * @description Fetch the most recent events.
+     * @param limit - Max events to return (default: 50).
+     * @param eventName - Optional filter by event name.
+     * @since v0.1.0
+     */
+    getRecentEvents(limit?: number, eventName?: string): Promise<unknown[]>;
+    /**
+     * @name getSyncStatus
+     * @description Get the sync status for all account types.
+     * @since v0.1.0
+     */
+    getSyncStatus(): Promise<SyncCursorRow[]>;
+    private log;
+}
+/**
+ * @interface SyncAllResult
+ * @description Result of a full sync operation.
+ * @category Postgres
+ * @since v0.1.0
+ */
+export interface SyncAllResult {
+    agents: number;
+    agentStats: number;
+    feedbacks: number;
+    tools: number;
+    escrows: number;
+    attestations: number;
+    vaults: number;
+    sessions: number;
+    epochPages: number;
+    delegates: number;
+    checkpoints: number;
+    ledgers: number;
+    ledgerPages: number;
+    capabilityIndexes: number;
+    protocolIndexes: number;
+    toolCategoryIndexes: number;
+    totalRecords: number;
+    durationMs: number;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/types/postgres/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/postgres/adapter.ts"],"names":[],"mappings":"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"}

package/dist/types/postgres/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @module postgres
+ * @description PostgreSQL off-chain mirror for SAP v2.
+ *
+ * Re-exports all public types, the adapter, sync engine,
+ * and serializer functions.
+ *
+ * @category Postgres
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import {
+ *   SapPostgres,
+ *   SapSyncEngine,
+ *   SAP_TABLE_MAP,
+ * } from "@synapse-sap/sdk/postgres";
+ * ```
+ */
+export { SapPostgres, type PgClient, type SyncAllResult } from "./adapter";
+export { SapSyncEngine } from "./sync";
+export { SAP_TABLE_MAP, type SapPostgresConfig, type SapAccountType, type SyncMeta, type AgentRow, type EscrowRow, type ToolRow, type LedgerRow, type EventRow, type SyncCursorRow, type SyncOptions, } from "./types";
+export { serializeGlobalRegistry, serializeAgent, serializeAgentStats, serializeFeedback, serializeCapabilityIndex, serializeProtocolIndex, serializeVault, serializeSession, serializeEpochPage, serializeDelegate, serializeTool, serializeCheckpoint, serializeEscrow, serializeToolCategoryIndex, serializeAttestation, serializeLedger, serializeLedgerPage, } from "./serializers";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/postgres/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/postgres/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAGvC,OAAO,EACL,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,EACf,mBAAmB,GACpB,MAAM,eAAe,CAAC"}

package/dist/types/postgres/serializers.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @module postgres/serializers
+ * @description Transforms on-chain account data into PostgreSQL-ready row objects.
+ *
+ * Each serializer takes the deserialized Anchor account data and the PDA
+ * address, then returns a flat key-value record suitable for SQL INSERT/UPSERT.
+ *
+ * @category Postgres
+ * @since v0.1.0
+ * @internal
+ */
+import type { AgentAccountData, AgentStatsData, FeedbackAccountData, CapabilityIndexData, ProtocolIndexData, ToolCategoryIndexData, GlobalRegistryData, MemoryVaultData, SessionLedgerData, EpochPageData, VaultDelegateData, SessionCheckpointData, ToolDescriptorData, EscrowAccountData, AgentAttestationData, MemoryLedgerData, LedgerPageData } from "../types";
+export declare function serializeGlobalRegistry(pda: string, d: GlobalRegistryData, slot: number): Record<string, unknown>;
+export declare function serializeAgent(pda: string, d: AgentAccountData, slot: number): Record<string, unknown>;
+export declare function serializeAgentStats(pda: string, d: AgentStatsData, slot: number): Record<string, unknown>;
+export declare function serializeFeedback(pda: string, d: FeedbackAccountData, slot: number): Record<string, unknown>;
+export declare function serializeCapabilityIndex(pda: string, d: CapabilityIndexData, slot: number): Record<string, unknown>;
+export declare function serializeProtocolIndex(pda: string, d: ProtocolIndexData, slot: number): Record<string, unknown>;
+export declare function serializeVault(pda: string, d: MemoryVaultData, slot: number): Record<string, unknown>;
+export declare function serializeSession(pda: string, d: SessionLedgerData, slot: number): Record<string, unknown>;
+export declare function serializeEpochPage(pda: string, d: EpochPageData, slot: number): Record<string, unknown>;
+export declare function serializeDelegate(pda: string, d: VaultDelegateData, slot: number): Record<string, unknown>;
+export declare function serializeTool(pda: string, d: ToolDescriptorData, slot: number): Record<string, unknown>;
+export declare function serializeCheckpoint(pda: string, d: SessionCheckpointData, slot: number): Record<string, unknown>;
+export declare function serializeEscrow(pda: string, d: EscrowAccountData, slot: number): Record<string, unknown>;
+export declare function serializeToolCategoryIndex(pda: string, d: ToolCategoryIndexData, slot: number): Record<string, unknown>;
+export declare function serializeAttestation(pda: string, d: AgentAttestationData, slot: number): Record<string, unknown>;
+export declare function serializeLedger(pda: string, d: MemoryLedgerData, slot: number): Record<string, unknown>;
+export declare function serializeLedgerPage(pda: string, d: LedgerPageData, slot: number): Record<string, unknown>;
+//# sourceMappingURL=serializers.d.ts.map

package/dist/types/postgres/serializers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializers.d.ts","sourceRoot":"","sources":["../../../src/postgres/serializers.ts"],"names":[],"mappings":"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"}

package/dist/types/postgres/sync.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @module postgres/sync
+ * @description Real-time and scheduled sync engine for the SAP PostgreSQL
+ * adapter. Provides cron-like periodic sync and WebSocket-based
+ * live event streaming.
+ *
+ * @category Postgres
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { SapSyncEngine } from "@synapse-sap/sdk/postgres";
+ * import { SapPostgres }   from "@synapse-sap/sdk/postgres";
+ * import { SapClient }     from "@synapse-sap/sdk";
+ * import { Pool }          from "pg";
+ *
+ * const pool = new Pool({ connectionString: "postgresql://..." });
+ * const sap  = SapClient.from(provider);
+ * const pg   = new SapPostgres(pool, sap);
+ * const sync = new SapSyncEngine(pg, sap);
+ *
+ * // One-shot full sync
+ * await sync.run();
+ *
+ * // Periodic sync (every 60 seconds)
+ * sync.start(60_000);
+ *
+ * // Live event streaming via WebSocket
+ * await sync.startEventStream();
+ *
+ * // Graceful shutdown
+ * await sync.stop();
+ * ```
+ */
+import type { SapClient } from "../core/client";
+import type { SapPostgres, SyncAllResult } from "./adapter";
+import type { SyncOptions } from "./types";
+/**
+ * @name SapSyncEngine
+ * @description Orchestrates periodic and real-time sync between
+ * Solana on-chain state and the PostgreSQL mirror.
+ *
+ * Two operational modes:
+ *
+ * 1. **Periodic sync** — polls all account types at a configurable
+ *    interval and upserts into PostgreSQL.
+ *
+ * 2. **Event streaming** — subscribes to SAP program logs via
+ *    WebSocket and inserts events in real-time.
+ *
+ * Both modes can run simultaneously.
+ *
+ * @category Postgres
+ * @since v0.1.0
+ */
+export declare class SapSyncEngine {
+    private readonly pg;
+    private readonly client;
+    private readonly debug;
+    private intervalId;
+    private logSubId;
+    private running;
+    constructor(pg: SapPostgres, client: SapClient, debug?: boolean);
+    /**
+     * @name run
+     * @description Execute a single full sync cycle.
+     * @param options - Optional sync configuration.
+     * @returns Sync result summary.
+     * @since v0.1.0
+     */
+    run(options?: SyncOptions): Promise<SyncAllResult>;
+    /**
+     * @name start
+     * @description Start periodic sync at the given interval.
+     * Safe to call when already running — resets the interval.
+     *
+     * @param intervalMs - Sync interval in milliseconds (default: 60_000).
+     * @param options - Optional sync configuration.
+     * @since v0.1.0
+     *
+     * @example
+     * ```ts
+     * // Sync every 30 seconds
+     * sync.start(30_000);
+     * ```
+     */
+    start(intervalMs?: number, options?: SyncOptions): void;
+    /**
+     * @name stop
+     * @description Stop all sync activity (periodic + event stream).
+     * @since v0.1.0
+     */
+    stop(): Promise<void>;
+    private stopInterval;
+    /**
+     * @name startEventStream
+     * @description Subscribe to SAP program logs via WebSocket and
+     * insert parsed events into the `sap_events` table in real-time.
+     *
+     * @since v0.1.0
+     *
+     * @example
+     * ```ts
+     * // Start streaming events
+     * await sync.startEventStream();
+     *
+     * // Later, stop the stream
+     * await sync.stopEventStream();
+     * ```
+     */
+    startEventStream(): Promise<void>;
+    /**
+     * @name stopEventStream
+     * @description Unsubscribe from the program log stream.
+     * @since v0.1.0
+     */
+    stopEventStream(): Promise<void>;
+    /**
+     * @name isRunning
+     * @description Check whether the periodic sync is active.
+     * @since v0.1.0
+     */
+    isRunning(): boolean;
+    /**
+     * @name isStreaming
+     * @description Check whether the event stream is active.
+     * @since v0.1.0
+     */
+    isStreaming(): boolean;
+    private log;
+}
+//# sourceMappingURL=sync.d.ts.map

package/dist/types/postgres/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/postgres/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAM3C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAEhC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,OAAO,CAAS;gBAEZ,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,UAAQ;IAU7D;;;;;;OAMG;IACG,GAAG,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAWxD;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,UAAU,SAAS,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAcvD;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,OAAO,CAAC,YAAY;IAWpB;;;;;;;;;;;;;;;OAeG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAyCvC;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAatC;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAQtB,OAAO,CAAC,GAAG;CAKZ"}