@syncular/server 0.1.3 → 0.2.1

package/dist/plugins/types.d.ts

@@ -1,73 +0,0 @@
-import type { ScopeValues, SyncChange, SyncCrdtStateVectorHint, SyncOperation } from '@syncular/core';
-import type { ApplyOperationResult, ServerApplyOperationContext, ServerContext, ServerTableHandler, SyncServerAuth } from '../handlers/types';
-import type { SyncCoreDb } from '../schema';
-/**
- * Plugin priority levels for server push hooks.
- * Lower numbers execute first.
- */
-export declare const ServerPushPluginPriority: {
-    /** CRDT payload transforms should run early. */
-    readonly CRDT: 40;
-    /** Default priority for general plugins. */
-    readonly DEFAULT: 50;
-    /** Logging/telemetry should run last. */
-    readonly TELEMETRY: 100;
-};
-export interface ServerPushPluginBeforeApplyArgs<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth> {
-    ctx: ServerApplyOperationContext<DB, Auth>;
-    tableHandler: ServerTableHandler<DB, Auth>;
-    op: SyncOperation;
-    opIndex: number;
-}
-export interface ServerPushPluginAfterApplyArgs<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth> {
-    ctx: ServerApplyOperationContext<DB, Auth>;
-    tableHandler: ServerTableHandler<DB, Auth>;
-    op: SyncOperation;
-    opIndex: number;
-    applied: ApplyOperationResult;
-}
-export interface ServerPullPluginTransformChangesArgs<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth> {
-    ctx: ServerContext<DB, Auth>;
-    tableHandler: ServerTableHandler<DB, Auth>;
-    subscription: {
-        id: string;
-        table: string;
-        scopes: ScopeValues;
-        params: Record<string, unknown> | undefined;
-        cursor: number;
-        crdtStateVectors: readonly SyncCrdtStateVectorHint[];
-    };
-    changes: readonly SyncChange[];
-}
-export interface SyncServerPlugin<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth> {
-    name: string;
-    /**
-     * Plugin priority for execution order. Lower numbers execute first.
-     * @default ServerPushPluginPriority.DEFAULT (50)
-     */
-    priority?: number;
-    /**
-     * Called right before a table handler applies an operation.
-     * Use this to transform payloads (for example CRDT envelopes).
-     */
-    beforeApplyOperation?(args: ServerPushPluginBeforeApplyArgs<DB, Auth>): Promise<SyncOperation> | SyncOperation;
-    /**
-     * Called after a table handler applies an operation.
-     * Use this to transform emitted changes / conflict rows.
-     */
-    afterApplyOperation?(args: ServerPushPluginAfterApplyArgs<DB, Auth>): Promise<ApplyOperationResult> | ApplyOperationResult;
-    /**
-     * Called while building an incremental pull response for a single
-     * subscription/table, before wire integrity is calculated.
-     *
-     * Use this for scoped, protocol-level row payload transforms such as sending
-     * a CRDT update envelope instead of a full document state when the client
-     * advertised an applicable state vector.
-     */
-    transformPullChanges?(args: ServerPullPluginTransformChangesArgs<DB, Auth>): Promise<readonly SyncChange[]> | readonly SyncChange[];
-}
-export type SyncServerPushPlugin<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth> = SyncServerPlugin<DB, Auth>;
-export type SyncServerPullPlugin<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth> = SyncServerPlugin<DB, Auth>;
-export declare function sortServerPushPlugins<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth>(plugins: readonly SyncServerPushPlugin<DB, Auth>[] | undefined): SyncServerPushPlugin<DB, Auth>[];
-export declare function sortServerPullPlugins<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth>(plugins: readonly SyncServerPullPlugin<DB, Auth>[] | undefined): SyncServerPullPlugin<DB, Auth>[];
-//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

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

package/dist/plugins/types.js

@@ -1,30 +0,0 @@
-/**
- * Plugin priority levels for server push hooks.
- * Lower numbers execute first.
- */
-export const ServerPushPluginPriority = {
-    /** CRDT payload transforms should run early. */
-    CRDT: 40,
-    /** Default priority for general plugins. */
-    DEFAULT: 50,
-    /** Logging/telemetry should run last. */
-    TELEMETRY: 100,
-};
-export function sortServerPushPlugins(plugins) {
-    if (!plugins || plugins.length === 0)
-        return [];
-    return plugins
-        .map((plugin, index) => ({ plugin, index }))
-        .sort((a, b) => {
-        const aPriority = a.plugin.priority ?? ServerPushPluginPriority.DEFAULT;
-        const bPriority = b.plugin.priority ?? ServerPushPluginPriority.DEFAULT;
-        if (aPriority !== bPriority)
-            return aPriority - bPriority;
-        return a.index - b.index;
-    })
-        .map((entry) => entry.plugin);
-}
-export function sortServerPullPlugins(plugins) {
-    return sortServerPushPlugins(plugins);
-}
-//# sourceMappingURL=types.js.map

package/dist/plugins/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,gDAAgD;IAChD,IAAI,EAAE,EAAE;IACR,4CAA4C;IAC5C,OAAO,EAAE,EAAE;IACX,yCAAyC;IACzC,SAAS,EAAE,GAAG;CACN,CAAC;AA2FX,MAAM,UAAU,qBAAqB,CAInC,OAA8D;IAE9D,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhD,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;SAC3C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,wBAAwB,CAAC,OAAO,CAAC;QACxE,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,wBAAwB,CAAC,OAAO,CAAC;QACxE,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,SAAS,GAAG,SAAS,CAAC;QAC1D,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAC3B,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAInC,OAA8D;IAE9D,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC"}

package/dist/postgres/index.d.ts

@@ -1,68 +0,0 @@
-/**
- * @syncular/server/postgres - PostgreSQL Server Sync Dialect
- *
- * Driver-agnostic PostgreSQL dialect for sync. Works with any Postgres-compatible
- * Kysely dialect (pg, pglite, neon, etc.).
- *
- * Tables:
- * - sync_commits: commit log (idempotency + ordering)
- * - sync_table_commits: commit routing index (fast pull by table)
- * - sync_changes: change log (JSONB scopes for filtering)
- * - sync_client_cursors: per-client cursor tracking (pruning/observability)
- */
-import type { ScopeValues, StoredScopes } from '@syncular/core';
-import type { DbExecutor } from '@syncular/server';
-import { type AuditRowHistoryArgs, type AuditRowHistoryRow, BaseServerSyncDialect, type IncrementalPullRow, type IncrementalPullRowsArgs } from '@syncular/server';
-import type { SyncChangeRow, SyncCoreDb } from '@syncular/server/schema';
-import type { Kysely, RawBuilder, Transaction } from 'kysely';
-export declare class PostgresServerSyncDialect extends BaseServerSyncDialect<'postgres'> {
-    readonly family: 'postgres';
-    readonly supportsForUpdate = true;
-    readonly supportsSavepoints = true;
-    readonly supportsInsertReturning = true;
-    protected buildNumberListFilter(values: number[]): RawBuilder<unknown>;
-    protected buildStringListFilter(values: string[]): RawBuilder<unknown>;
-    ensureSyncSchema<DB extends SyncCoreDb>(db: Kysely<DB>): Promise<void>;
-    executeInTransaction<DB extends SyncCoreDb, T>(db: Kysely<DB>, fn: (executor: DbExecutor<DB>) => Promise<T>): Promise<T>;
-    setRepeatableRead<DB extends SyncCoreDb>(trx: DbExecutor<DB>): Promise<void>;
-    readCommitSeqsForPull<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, args: {
-        cursor: number;
-        limitCommits: number;
-        tables: string[];
-        partitionId?: string;
-    }): Promise<number[]>;
-    recordClientCursor<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, args: {
-        partitionId?: string;
-        clientId: string;
-        actorId: string;
-        cursor: number;
-        effectiveScopes: ScopeValues;
-        realtimeSubscriptions?: unknown;
-    }): Promise<void>;
-    readChangesForCommits<DB extends SyncCoreDb>(db: DbExecutor<DB>, args: {
-        commitSeqs: number[];
-        table: string;
-        scopes: ScopeValues;
-        partitionId?: string;
-    }): Promise<SyncChangeRow[]>;
-    readAuditRowHistory<DB extends SyncCoreDb>(db: DbExecutor<DB>, args: AuditRowHistoryArgs): Promise<AuditRowHistoryRow[]>;
-    protected readIncrementalPullRowsBatch<DB extends SyncCoreDb>(db: DbExecutor<DB>, args: Omit<IncrementalPullRowsArgs, 'batchSize'>): Promise<IncrementalPullRow[]>;
-    compactChanges<DB extends SyncCoreDb>(db: DbExecutor<DB>, args: {
-        fullHistoryHours: number;
-    }): Promise<number>;
-    scopesToDb(scopes: StoredScopes): StoredScopes;
-    dbToArray(value: unknown): string[];
-    arrayToDb(values: string[]): string[];
-    ensureConsoleSchema<DB extends SyncCoreDb>(db: Kysely<DB>): Promise<void>;
-    private ensureIndex;
-}
-export declare function createPostgresServerDialect(): PostgresServerSyncDialect;
-/**
- * Explicit server-side dialect alias for Neon-backed Postgres runtimes.
- *
- * Neon uses the same SQL family and sync schema behavior as Postgres, but this
- * helper makes the runtime/provider intent visible in app code and host
- * integrations.
- */
-export declare function createNeonServerDialect(): PostgresServerSyncDialect;
-//# sourceMappingURL=index.d.ts.map

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

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