@gonvex/cli 0.5.2-staging.16 → 0.5.2-staging.18

package/dist/local-dependencies.d.ts

@@ -0,0 +1,58 @@
+export type LocalTableAccess = {
+    table: string;
+    operation: string;
+    /** False only for inserts with an intent-generated key: they never read locally. */
+    reads: boolean;
+    /** Project-relative `file:line`. */
+    site: string;
+};
+export type UnresolvedLocalAccess = {
+    operation: string;
+    site: string;
+    expression: string;
+};
+export type LocalReducerAnalysis = {
+    path: string;
+    accesses: LocalTableAccess[];
+    unresolved: UnresolvedLocalAccess[];
+    rawQueries: string[];
+};
+export type LocalReducerSource = {
+    /** Public function path. */
+    path: string;
+    /** Project-relative module file. */
+    file: string;
+    /** Exported binding that holds the Reducer definition. */
+    exportName: string;
+};
+export type LocalDependencyViolation = {
+    reducer: string;
+    table: string;
+    operation: string;
+    site: string;
+    reason: string;
+};
+/**
+ * Whether an access reads the table locally. The analysis checks inserts for
+ * an explicit `_id`; a table keyed by another column is treated as read by any
+ * insert, since the row may carry that key.
+ */
+export declare function readsLocally(access: LocalTableAccess, tableKeys: ReadonlyMap<string, string>): boolean;
+/** Tables a Reducer needs in the Local Replica to run locally, sorted. */
+export declare function localDependencyTables(analysis: LocalReducerAnalysis, tableKeys: ReadonlyMap<string, string>): string[];
+/** Accesses a local run cannot complete. `tableKeys` maps every local-schema table to its key. */
+export declare function localDependencyViolations(analyses: readonly LocalReducerAnalysis[], localTables: ReadonlySet<string>, tableKeys: ReadonlyMap<string, string>): LocalDependencyViolation[];
+/** A readable report grouped by table, for CLI errors and warnings. */
+export declare function formatLocalDependencyViolations(violations: readonly LocalDependencyViolation[]): string;
+/**
+ * Analyze the table dependencies of locally executing Reducers. Loads the
+ * TypeScript compiler bundled with the CLI on first use.
+ */
+export declare function analyzeLocalReducerDependencies(input: {
+    root: string;
+    backendDir: string;
+    files: readonly string[];
+    reducers: readonly LocalReducerSource[];
+    /** Project-relative tsconfig whose compiler options (paths, resolution) apply to the backend. */
+    tsconfig?: string;
+}): Promise<LocalReducerAnalysis[]>;