@syncular/testkit 0.0.6-96 → 0.1.0

package/dist/audit.d.ts

@@ -0,0 +1,22 @@
+export interface RedactedAuditChange {
+    redaction?: {
+        payload?: unknown;
+        reason?: unknown;
+    };
+    rowJson?: unknown;
+    scopes?: unknown;
+    [key: string]: unknown;
+}
+export interface RedactedAuditDebugExport {
+    commits?: Array<{
+        changes?: RedactedAuditChange[];
+        [key: string]: unknown;
+    }>;
+    [key: string]: unknown;
+}
+export declare function assertAuditChangeRedacted(change: RedactedAuditChange, message?: string): void;
+export declare function assertAuditJsonExcludes(value: unknown, forbiddenNeedles: readonly string[], message?: string): void;
+export declare function assertAuditDebugExportRedacted(value: RedactedAuditDebugExport, forbiddenNeedles?: readonly string[], message?: string): void;
+export declare function readJsonResponse<T>(response: Response): Promise<T>;
+export declare function readTextResponse(response: Response): Promise<string>;
+//# sourceMappingURL=audit.d.ts.map

package/dist/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;QAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC,CAAC;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,SAAyC,GAC/C,IAAI,CAeN;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,gBAAgB,EAAE,SAAS,MAAM,EAAE,EACnC,OAAO,SAAwC,GAC9C,IAAI,CAQN;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,wBAAwB,EAC/B,gBAAgB,GAAE,SAAS,MAAM,EAAO,EACxC,OAAO,SAA+C,GACrD,IAAI,CAON;AAED,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAExE;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1E"}

package/dist/audit.js

@@ -0,0 +1,40 @@
+import { isDeepStrictEqual } from 'node:util';
+export function assertAuditChangeRedacted(change, message = 'Expected audit change to be redacted') {
+    if ('rowJson' in change) {
+        throw new Error(`${message}: rowJson must be omitted`);
+    }
+    if ('scopes' in change) {
+        throw new Error(`${message}: raw scopes must be omitted`);
+    }
+    if (!isDeepStrictEqual(change.redaction, {
+        payload: 'omitted',
+        reason: 'audit_redacted_by_default',
+    })) {
+        throw new Error(`${message}: missing canonical redaction marker`);
+    }
+}
+export function assertAuditJsonExcludes(value, forbiddenNeedles, message = 'Audit JSON leaked forbidden content') {
+    const serialized = JSON.stringify(value);
+    for (const needle of forbiddenNeedles) {
+        if (!needle)
+            continue;
+        if (serialized.includes(needle)) {
+            throw new Error(`${message}: ${needle}`);
+        }
+    }
+}
+export function assertAuditDebugExportRedacted(value, forbiddenNeedles = [], message = 'Expected audit debug export to be redacted') {
+    for (const commit of value.commits ?? []) {
+        for (const change of commit.changes ?? []) {
+            assertAuditChangeRedacted(change, message);
+        }
+    }
+    assertAuditJsonExcludes(value, forbiddenNeedles, message);
+}
+export async function readJsonResponse(response) {
+    return (await response.json());
+}
+export async function readTextResponse(response) {
+    return await response.text();
+}
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAoB9C,MAAM,UAAU,yBAAyB,CACvC,MAA2B,EAC3B,OAAO,GAAG,sCAAsC;IAEhD,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,2BAA2B,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,8BAA8B,CAAC,CAAC;IAC5D,CAAC;IACD,IACE,CAAC,iBAAiB,CAAC,MAAM,CAAC,SAAS,EAAE;QACnC,OAAO,EAAE,SAAS;QAClB,MAAM,EAAE,2BAA2B;KACpC,CAAC,EACF,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,sCAAsC,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAAc,EACd,gBAAmC,EACnC,OAAO,GAAG,qCAAqC;IAE/C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,KAAK,MAAM,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,KAA+B,EAC/B,gBAAgB,GAAsB,EAAE,EACxC,OAAO,GAAG,4CAA4C;IAEtD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QACzC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAC1C,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAI,QAAkB;IAC1D,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAkB;IACvD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC/B,CAAC"}

package/dist/client-bridge.d.ts

@@ -0,0 +1,77 @@
+import type { SyncularAuthLeaseRecord, SyncularBridge, SyncularBridgeMutationBatch, SyncularBridgeQueryRequest, SyncularBridgeQueryResult, SyncularBridgeStatus, SyncularClientEventMap, SyncularClientEventSink, SyncularClientEventType, SyncularConflictResolution, SyncularConflictSummary, SyncularDiagnosticSnapshot, SyncularPresenceEntry, SyncularSubscriptionSpec, SyncularSyncResult } from '@syncular/client';
+import type { SyncAuthLeaseIssueRequest, SyncOperation } from '@syncular/core';
+import type { AsyncDisposableResource } from './disposable';
+export type ClientBridgeSeed = Record<string, readonly Record<string, unknown>[]>;
+export type ClientBridgeTauriInvoke = <TResult>(command: string, args?: Record<string, unknown>) => Promise<TResult>;
+export type ClientBridgeTauriListen = <TPayload>(event: string, handler: (event: {
+    payload: TPayload;
+}) => void) => Promise<() => void>;
+export type ClientBridgeNativeEventSubscription = (() => void) | {
+    remove(): void;
+};
+export interface ClientBridgeNativeModule {
+    executeSql<Row extends Record<string, unknown> = Record<string, unknown>>(request: SyncularBridgeQueryRequest): Promise<SyncularBridgeQueryResult<Row>> | SyncularBridgeQueryResult<Row>;
+    applyMutationsCommit(batch: SyncularBridgeMutationBatch): Promise<string> | string;
+    applyLeasedMutationsCommit?(batch: SyncularBridgeMutationBatch): Promise<string> | string;
+    sync?(): Promise<SyncularSyncResult>;
+    resumeFromBackground?(): Promise<SyncularSyncResult>;
+    start?(): Promise<void>;
+    stop?(): Promise<void>;
+    setSubscriptions?(subscriptions: readonly SyncularSubscriptionSpec[]): Promise<void>;
+    getStatus?(): SyncularBridgeStatus;
+    issueAuthLease?(request: SyncAuthLeaseIssueRequest): Promise<SyncularAuthLeaseRecord>;
+    upsertAuthLease?(lease: SyncularAuthLeaseRecord): Promise<void>;
+    authLease?(leaseId: string): Promise<SyncularAuthLeaseRecord | null>;
+    activeAuthLeases?(actorId?: string | null, nowMs?: number): Promise<SyncularAuthLeaseRecord[]>;
+    diagnosticSnapshot?(): Promise<SyncularDiagnosticSnapshot>;
+    addListener?<T extends SyncularClientEventType>(event: T, listener: SyncularClientEventSink<T>): ClientBridgeNativeEventSubscription;
+    getPresence?<TMetadata = Record<string, unknown>>(scopeKey: string): SyncularPresenceEntry<TMetadata>[];
+    joinPresence?(scopeKey: string, metadata?: Record<string, unknown>): void;
+    leavePresence?(scopeKey: string): void;
+    updatePresenceMetadata?(scopeKey: string, metadata: Record<string, unknown>): void;
+    conflictSummaries?(): Promise<SyncularConflictSummary[]>;
+    retryConflictKeepLocal?(id: string): Promise<string>;
+    resolveConflict?(id: string, resolution: SyncularConflictResolution): Promise<void>;
+}
+export interface CreateClientBridgeHarnessOptions {
+    seed?: ClientBridgeSeed;
+    idColumn?: string;
+    actorId?: string;
+    clientId?: string;
+}
+export interface ClientBridgeInvocation {
+    command: string;
+    args: Record<string, unknown> | undefined;
+}
+export interface ClientBridgeSqlQuery extends SyncularBridgeQueryRequest {
+}
+export interface ClientBridgeHarness {
+    bridge: SyncularBridge;
+    tauri: {
+        invoke: ClientBridgeTauriInvoke;
+        listen: ClientBridgeTauriListen;
+        invocations(): ClientBridgeInvocation[];
+    };
+    reactNative: {
+        module: ClientBridgeNativeModule;
+    };
+    queries(): ClientBridgeSqlQuery[];
+    batches(): SyncularBridgeMutationBatch[];
+    leasedBatches(): SyncularBridgeMutationBatch[];
+    operations(): SyncOperation[];
+    syncCount(): number;
+    listenerCount(event: SyncularClientEventType): number;
+    rows(table: string): Record<string, unknown>[];
+    setRows(table: string, rows: readonly Record<string, unknown>[]): void;
+    setStatus(status: SyncularBridgeStatus): void;
+    setConflicts(conflicts: readonly SyncularConflictSummary[]): void;
+    authLease(leaseId: string): SyncularAuthLeaseRecord | null;
+    authLeases(): SyncularAuthLeaseRecord[];
+    diagnosticSnapshot(): SyncularDiagnosticSnapshot;
+    emit<T extends SyncularClientEventType>(event: T, payload: SyncularClientEventMap[T]): void;
+    emitRowsChanged(event: SyncularClientEventMap['rowsChanged']): void;
+    presence<TMetadata = Record<string, unknown>>(scopeKey: string): SyncularPresenceEntry<TMetadata>[];
+    close(): void;
+}
+export declare function createClientBridgeHarness(options?: CreateClientBridgeHarnessOptions): Promise<AsyncDisposableResource<ClientBridgeHarness>>;
+//# sourceMappingURL=client-bridge.d.ts.map

package/dist/client-bridge.d.ts.map

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