rado 0.1.52 → 0.1.53

package/dist/lib/Formatter.d.ts

@@ -1,67 +1,78 @@
-import { ColumnData, ColumnType } from '../define/Column';
-import { ExprData } from '../define/Expr';
-import { OrderBy } from '../define/OrderBy';
-import { Query } from '../define/Query';
-import { Target } from '../define/Target';
-import { Sanitizer } from './Sanitizer';
-import { Statement } from './Statement';
-export interface FormatContext {
-    stmt: Statement;
-    nameResult?: string;
-    /** Skip prefixing fields with their table name */
-    skipTableName?: boolean;
-    /**
-     * In SQLite table names are used as expressions in the FTS5 plugin.
-     * To distinguish between formatting a row of the table and just the table name
-     * this flag can be used.
-     **/
-    tableAsExpr?: boolean;
-    /** Inline all parameters */
-    forceInline?: boolean;
-    formatAsJson?: boolean;
-    formatAsDefault?: boolean;
-    topLevel?: boolean;
-}
-type FormatSubject = (stmt: Statement, mkSubject: () => void) => void;
-export declare abstract class Formatter implements Sanitizer {
-    constructor();
-    abstract escapeValue(value: any): string;
-    abstract escapeIdentifier(ident: string): string;
-    abstract formatParamValue(paramValue: any): any;
-    abstract formatAccess(ctx: FormatContext, mkSubject: () => void, field: string): Statement;
-    compile<T>(query: Query<T>, options?: Partial<FormatContext>): Statement;
-    format<T>(ctx: FormatContext, query: Query<T>): Statement;
-    formatSelect(ctx: FormatContext, query: Query.Select): Statement;
-    formatInsert(ctx: FormatContext, query: Query.Insert): Statement;
-    formatUpdate(ctx: FormatContext, query: Query.Update): Statement;
-    formatDelete(ctx: FormatContext, query: Query.Delete): Statement;
-    formatCreateTable(ctx: FormatContext, query: Query.CreateTable): Statement;
-    formatCreateIndex(ctx: FormatContext, query: Query.CreateIndex): Statement;
-    formatDropIndex(ctx: FormatContext, query: Query.DropIndex): Statement;
-    formatAlterTable(ctx: FormatContext, query: Query.AlterTable): Statement;
-    formatTransaction(ctx: FormatContext, { op, id }: Query.Transaction): Statement;
-    formatBatch(ctx: FormatContext, { queries }: Query.Batch): Statement;
-    formatRaw(ctx: FormatContext, { strings, params }: Query.Raw): Statement;
-    formatColumn(ctx: FormatContext, column: ColumnData): Statement;
-    formatContraintReference(ctx: FormatContext, reference: ExprData): Statement;
-    formatType(ctx: FormatContext, type: ColumnType): Statement;
-    formatInsertRow(ctx: FormatContext, columns: Record<string, ColumnData>, row: Record<string, any>): Statement;
-    formatColumnValue(ctx: FormatContext, column: ColumnData, columnValue: any): Statement;
-    formatTarget(ctx: FormatContext, target: Target): Statement;
-    formatWhere(ctx: FormatContext, expr: ExprData | undefined): Statement;
-    formatHaving(ctx: FormatContext, expr: ExprData | undefined): Statement;
-    formatGroupBy(ctx: FormatContext, groupBy: Array<ExprData> | undefined): Statement;
-    formatOrderBy(ctx: FormatContext, orderBy: Array<OrderBy> | undefined): Statement;
-    formatLimit(ctx: FormatContext, { limit, offset, singleResult }: Query.QueryBase): Statement;
-    formatSelection(ctx: FormatContext, selection: ExprData, formatSubject?: FormatSubject): Statement;
-    formatExprJson(ctx: FormatContext, expr: ExprData): Statement;
-    formatExprValue(ctx: FormatContext, expr: ExprData): Statement;
-    formatIn(ctx: FormatContext, expr: ExprData): Statement;
-    retrieveField(expr: ExprData, field: string): ExprData | undefined;
-    formatField(ctx: FormatContext, expr: ExprData, field: string): Statement;
-    formatString(ctx: FormatContext, input: string): Statement;
-    formatInlineValue(ctx: FormatContext, rawValue: any): Statement;
-    formatValue(ctx: FormatContext, rawValue: any): Statement;
-    formatExpr(ctx: FormatContext, expr: ExprData): Statement;
-}
-export {};
+import { ColumnData, ColumnType } from '../define/Column';
+import { ExprData } from '../define/Expr';
+import { OrderBy } from '../define/OrderBy';
+import { Query } from '../define/Query';
+import { Target } from '../define/Target';
+import { Sanitizer } from './Sanitizer';
+import { Statement, StatementOptions } from './Statement';
+export interface FormatContext {
+    stmt: Statement;
+    nameResult?: string;
+    /** Skip prefixing fields with their table name */
+    skipTableName?: boolean;
+    /**
+     * In SQLite table names are used as expressions in the FTS5 plugin.
+     * To distinguish between formatting a row of the table and just the table name
+     * this flag can be used.
+     **/
+    tableAsExpr?: boolean;
+    /** Inline all parameters */
+    forceInline?: boolean;
+    formatAsJson?: boolean;
+    formatAsDefault?: boolean;
+    topLevel?: boolean;
+}
+type FormatSubject = (stmt: Statement, mkSubject: () => void) => void;
+export declare abstract class Formatter implements Sanitizer {
+    constructor();
+    abstract escapeValue(value: any): string;
+    abstract escapeIdentifier(ident: string): string;
+    abstract formatParamValue(paramValue: any): any;
+    abstract formatAccess(ctx: FormatContext, mkSubject: () => void, field: string): Statement;
+    compile<T>(query: Query<T>, options?: Partial<FormatContext>): Statement;
+    createContext(options?: Partial<FormatContext> & StatementOptions): {
+        stmt: Statement;
+        nameResult?: string | undefined;
+        skipTableName?: boolean | undefined;
+        tableAsExpr?: boolean | undefined;
+        forceInline?: boolean | undefined;
+        formatAsJson?: boolean | undefined;
+        formatAsDefault?: boolean | undefined;
+        topLevel?: boolean | undefined;
+        skipNewlines?: boolean | undefined;
+    };
+    format<T>(ctx: FormatContext, query: Query<T>): Statement;
+    formatSelect(ctx: FormatContext, query: Query.Select): Statement;
+    formatInsert(ctx: FormatContext, query: Query.Insert): Statement;
+    formatUpdate(ctx: FormatContext, query: Query.Update): Statement;
+    formatDelete(ctx: FormatContext, query: Query.Delete): Statement;
+    formatCreateTable(ctx: FormatContext, query: Query.CreateTable): Statement;
+    formatCreateIndex(ctx: FormatContext, query: Query.CreateIndex): Statement;
+    formatDropIndex(ctx: FormatContext, query: Query.DropIndex): Statement;
+    formatAlterTable(ctx: FormatContext, query: Query.AlterTable): Statement;
+    formatTransaction(ctx: FormatContext, { op, id }: Query.Transaction): Statement;
+    formatBatch(ctx: FormatContext, { queries }: Query.Batch): Statement;
+    formatRaw(ctx: FormatContext, { strings, params }: Query.Raw): Statement;
+    formatColumn(ctx: FormatContext, column: ColumnData): Statement;
+    formatContraintReference(ctx: FormatContext, reference: ExprData): Statement;
+    formatType(ctx: FormatContext, type: ColumnType): Statement;
+    formatInsertRow(ctx: FormatContext, columns: Record<string, ColumnData>, row: Record<string, any>): Statement;
+    formatColumnValue(ctx: FormatContext, column: ColumnData, columnValue: any): Statement;
+    formatTarget(ctx: FormatContext, target: Target): Statement;
+    formatWhere(ctx: FormatContext, expr: ExprData | undefined): Statement;
+    formatHaving(ctx: FormatContext, expr: ExprData | undefined): Statement;
+    formatGroupBy(ctx: FormatContext, groupBy: Array<ExprData> | undefined): Statement;
+    formatOrderBy(ctx: FormatContext, orderBy: Array<OrderBy> | undefined): Statement;
+    formatLimit(ctx: FormatContext, { limit, offset, singleResult }: Query.QueryBase): Statement;
+    formatSelection(ctx: FormatContext, selection: ExprData, formatSubject?: FormatSubject): Statement;
+    formatExprJson(ctx: FormatContext, expr: ExprData): Statement;
+    formatExprValue(ctx: FormatContext, expr: ExprData): Statement;
+    formatIn(ctx: FormatContext, expr: ExprData): Statement;
+    retrieveField(expr: ExprData, field: string): ExprData | undefined;
+    formatField(ctx: FormatContext, expr: ExprData, field: string): Statement;
+    formatString(ctx: FormatContext, input: string): Statement;
+    formatInlineValue(ctx: FormatContext, rawValue: any): Statement;
+    formatValue(ctx: FormatContext, rawValue: any): Statement;
+    formatExpr(ctx: FormatContext, expr: ExprData): Statement;
+}
+export {};

package/dist/lib/Formatter.js

@@ -40,10 +40,15 @@ var Formatter = class {
   constructor() {
   }
   compile(query, options) {
-    const stmt = new Statement(this);
-    const result = this.format({ stmt, topLevel: true, ...options }, query);
+    const result = this.format(
+      this.createContext({ topLevel: true, ...options }),
+      query
+    );
     return result;
   }
+  createContext(options) {
+    return { stmt: new Statement(this, options), ...options };
+  }
   format(ctx, query) {
     switch (query.type) {
       case QueryType.Select:
@@ -419,9 +424,7 @@ var Formatter = class {
   formatIn(ctx, expr) {
     const { stmt } = ctx;
     switch (expr.type) {
-      case ExprType.Query:
-        return this.formatExprValue(ctx, expr);
-      default:
+      case ExprType.Field:
         stmt.openParenthesis();
         stmt.raw("SELECT value FROM json_each");
         stmt.openParenthesis();
@@ -429,6 +432,8 @@ var Formatter = class {
         stmt.closeParenthesis();
         stmt.closeParenthesis();
         return stmt;
+      default:
+        return this.formatExprValue(ctx, expr);
     }
   }
   retrieveField(expr, field) {
@@ -495,12 +500,11 @@ var Formatter = class {
       case Array.isArray(rawValue):
         if (formatAsDefault || formatAsJson) {
           stmt.raw("json_array");
-          stmt.openParenthesis();
         }
+        stmt.openParenthesis();
         for (const v of stmt.separate(rawValue))
           this.formatValue({ ...ctx, formatAsJson: false }, v);
-        if (formatAsDefault || formatAsJson)
-          stmt.closeParenthesis();
+        stmt.closeParenthesis();
         return stmt;
       case (typeof rawValue === "string" || typeof rawValue === "number"):
         if (forceInline)
@@ -542,7 +546,7 @@ var Formatter = class {
           case ParamType.Value:
             return this.formatValue(ctx, expr.param.value);
           case ParamType.Named:
-            return stmt.param(expr.param.name);
+            return stmt.param(expr.param);
         }
       case ExprType.Field:
         return this.formatField(ctx, expr.expr, expr.field);

package/dist/lib/Functions.d.ts

@@ -0,0 +1,5 @@
+import { Expr } from './Expr';
+export declare const Functions: Functions;
+export type Functions = {
+    [key: string]: (...args: Array<any>) => Expr<any>;
+};

package/dist/lib/Functions.js

@@ -0,0 +1,11 @@
+// src/lib/Functions.ts
+import { Expr, ExprData } from "./Expr.js";
+function get(_, method) {
+  return (...args) => {
+    return new Expr(ExprData.Call(method, args.map(ExprData.create)));
+  };
+}
+var Functions = new Proxy({}, { get });
+export {
+  Functions
+};

package/dist/lib/Id.d.ts

@@ -0,0 +1,3 @@
+export type Id<T extends {
+    id: any;
+}> = T['id'];

package/dist/lib/Index.d.ts

@@ -0,0 +1,17 @@
+import { Expr, ExprData } from './Expr';
+interface PartialIndexData {
+    on: Array<ExprData>;
+    unique?: boolean;
+    where?: ExprData;
+}
+export interface IndexData extends PartialIndexData {
+    name: string;
+}
+export declare class Index {
+    data: PartialIndexData;
+    constructor(data: PartialIndexData);
+    unique(): Index;
+    where(where: Expr<boolean>): Index;
+}
+export declare function index(...on: Array<Expr<any>>): Index;
+export {};

package/dist/lib/Index.js

@@ -0,0 +1,20 @@
+// src/lib/Index.ts
+import { ExprData } from "./Expr.js";
+var Index = class {
+  constructor(data) {
+    this.data = data;
+  }
+  unique() {
+    return new Index({ ...this.data, unique: true });
+  }
+  where(where) {
+    return new Index({ ...this.data, where: ExprData.create(where) });
+  }
+};
+function index(...on) {
+  return new Index({ on: on.map(ExprData.create) });
+}
+export {
+  Index,
+  index
+};

package/dist/lib/Ops.d.ts

@@ -0,0 +1,8 @@
+import { Cursor } from './Cursor';
+import { Table } from './Table';
+export declare function selectAll<Row>(table: Table<Row>): Cursor.SelectMultiple<Row>;
+export declare function selectFirst<Row>(table: Table<Row>): Cursor.SelectSingle<Row>;
+export declare function update<Row>(table: Table<Row>): Cursor.Update<Row>;
+export declare function insertInto<Row>(table: Table<Row>): Cursor.Insert<Row>;
+export declare function deleteFrom<Row>(table: Table<Row>): Cursor.Delete;
+export declare function create(...tables: Array<Table<any>>): Cursor.Batch;

package/dist/lib/Ops.js

@@ -0,0 +1,45 @@
+// src/lib/Ops.ts
+import { Cursor } from "./Cursor.js";
+import { ExprData } from "./Expr.js";
+import { Query } from "./Query.js";
+import { Schema } from "./Schema.js";
+import { Target } from "./Target.js";
+function selectAll(table) {
+  return new Cursor.SelectMultiple(
+    Query.Select({
+      from: Target.Table(table.schema()),
+      selection: ExprData.Row(Target.Table(table.schema()))
+    })
+  );
+}
+function selectFirst(table) {
+  return new Cursor.SelectSingle(
+    Query.Select({
+      from: Target.Table(table.schema()),
+      selection: ExprData.Row(Target.Table(table.schema())),
+      singleResult: true
+    })
+  );
+}
+function update(table) {
+  return new Cursor.Update(Query.Update({ table: table.schema() }));
+}
+function insertInto(table) {
+  return new Cursor.Insert(table.schema());
+}
+function deleteFrom(table) {
+  return new Cursor.Delete(Query.Delete({ table: table.schema() }));
+}
+function create(...tables) {
+  return new Cursor.Batch(
+    tables.flatMap((table) => Schema.create(table.schema()).queries)
+  );
+}
+export {
+  create,
+  deleteFrom,
+  insertInto,
+  selectAll,
+  selectFirst,
+  update
+};

package/dist/lib/OrderBy.d.ts

@@ -0,0 +1,9 @@
+import { ExprData } from './Expr';
+export declare enum OrderDirection {
+    Asc = "Asc",
+    Desc = "Desc"
+}
+export type OrderBy = {
+    expr: ExprData;
+    order: OrderDirection;
+};

package/dist/lib/OrderBy.js

@@ -0,0 +1,9 @@
+// src/lib/OrderBy.ts
+var OrderDirection = /* @__PURE__ */ ((OrderDirection2) => {
+  OrderDirection2["Asc"] = "Asc";
+  OrderDirection2["Desc"] = "Desc";
+  return OrderDirection2;
+})(OrderDirection || {});
+export {
+  OrderDirection
+};

package/dist/lib/Param.d.ts

@@ -0,0 +1,20 @@
+import { Expr } from './Expr';
+export declare enum ParamType {
+    Value = "Value",
+    Named = "Named"
+}
+export type ParamData = {
+    type: ParamType.Value;
+    value: any;
+} | {
+    type: ParamType.Named;
+    name: string;
+};
+export declare const ParamData: {
+    Value(value: any): ParamData;
+    Named(name: string): ParamData;
+};
+export type Params<T> = {
+    [K in keyof T]: Expr<T[K]>;
+};
+export declare function createParams<T>(): Params<T>;

package/dist/lib/Param.js

@@ -0,0 +1,27 @@
+// src/lib/Param.ts
+import { Expr, ExprData } from "./Expr.js";
+var ParamType = /* @__PURE__ */ ((ParamType2) => {
+  ParamType2["Value"] = "Value";
+  ParamType2["Named"] = "Named";
+  return ParamType2;
+})(ParamType || {});
+var ParamData = {
+  Value(value) {
+    return { type: "Value" /* Value */, value };
+  },
+  Named(name) {
+    return { type: "Named" /* Named */, name };
+  }
+};
+function createParams() {
+  return new Proxy({}, {
+    get(target, prop) {
+      return new Expr(ExprData.Param(ParamData.Named(prop)));
+    }
+  });
+}
+export {
+  ParamData,
+  ParamType,
+  createParams
+};

package/dist/lib/Query.d.ts

@@ -0,0 +1,109 @@
+import { ColumnData } from './Column';
+import { ExprData } from './Expr';
+import { IndexData } from './Index';
+import { OrderBy } from './OrderBy';
+import { Schema } from './Schema';
+import { Target } from './Target';
+export declare enum QueryType {
+    Insert = "Insert",
+    Select = "Select",
+    Update = "Update",
+    Delete = "Delete",
+    CreateTable = "CreateTable",
+    CreateIndex = "CreateIndex",
+    DropIndex = "DropIndex",
+    AlterTable = "AlterTable",
+    Batch = "Batch",
+    Transaction = "Transaction",
+    Raw = "Raw"
+}
+export type Query<T = any> = Query.Insert | Query.Select | Query.Update | Query.Delete | Query.CreateTable | Query.CreateIndex | Query.DropIndex | Query.AlterTable | Query.Batch | Query.Transaction | Query.Raw;
+export declare namespace Query {
+    interface QueryBase {
+        limit?: number;
+        offset?: number;
+        type: QueryType;
+        where?: ExprData;
+        orderBy?: Array<OrderBy>;
+        groupBy?: Array<ExprData>;
+        having?: ExprData;
+        selection?: ExprData;
+        singleResult?: boolean;
+        validate?: boolean;
+    }
+    interface Insert extends QueryBase {
+        type: QueryType.Insert;
+        into: Schema;
+        data: Array<any>;
+    }
+    function Insert(insert: Omit<Insert, 'type'>): Query.Insert;
+    interface Select extends QueryBase {
+        type: QueryType.Select;
+        selection: ExprData;
+        from: Target;
+    }
+    function Select(select: Omit<Select, 'type'>): Query.Select;
+    interface Update extends QueryBase {
+        type: QueryType.Update;
+        table: Schema;
+        set?: Record<string, any>;
+    }
+    function Update(update: Omit<Update, 'type'>): Query.Update;
+    interface Delete extends QueryBase {
+        type: QueryType.Delete;
+        table: Schema;
+    }
+    function Delete(del: Omit<Delete, 'type'>): Query.Delete;
+    interface CreateTable extends QueryBase {
+        type: QueryType.CreateTable;
+        table: Schema;
+        ifNotExists?: boolean;
+    }
+    function CreateTable(create: Omit<CreateTable, 'type'>): Query.CreateTable;
+    interface CreateIndex extends QueryBase {
+        type: QueryType.CreateIndex;
+        table: Schema;
+        index: IndexData;
+        ifNotExists?: boolean;
+    }
+    function CreateIndex(create: Omit<CreateIndex, 'type'>): Query.CreateIndex;
+    interface DropIndex extends QueryBase {
+        type: QueryType.DropIndex;
+        table: Schema;
+        name: string;
+        ifExists?: boolean;
+    }
+    function DropIndex(drop: Omit<DropIndex, 'type'>): Query.DropIndex;
+    interface Batch extends QueryBase {
+        type: QueryType.Batch;
+        queries: Array<Query<any>>;
+    }
+    function Batch(batch: Omit<Batch, 'type'>): Query.Batch;
+    enum TransactionOperation {
+        Begin = "Begin",
+        Commit = "Commit",
+        Rollback = "Rollback"
+    }
+    interface Transaction extends QueryBase {
+        type: QueryType.Transaction;
+        id: string;
+        op: TransactionOperation;
+    }
+    function Transaction(transaction: Omit<Transaction, 'type'>): Query.Transaction;
+    type RawReturn = 'row' | 'rows' | undefined;
+    interface Raw extends QueryBase {
+        type: QueryType.Raw;
+        expectedReturn?: 'row' | 'rows';
+        strings: ReadonlyArray<string>;
+        params: Array<any>;
+    }
+    function Raw(raw: Omit<Raw, 'type'>): Query.Raw;
+    interface AlterTable extends QueryBase {
+        type: QueryType.AlterTable;
+        table: Schema;
+        alterColumn?: ColumnData;
+        addColumn?: ColumnData;
+        dropColumn?: string;
+    }
+    function AlterTable(alter: Omit<AlterTable, 'type'>): Query.AlterTable;
+}

package/dist/lib/Query.js

@@ -0,0 +1,74 @@
+// src/lib/Query.ts
+var QueryType = /* @__PURE__ */ ((QueryType2) => {
+  QueryType2["Insert"] = "Insert";
+  QueryType2["Select"] = "Select";
+  QueryType2["Update"] = "Update";
+  QueryType2["Delete"] = "Delete";
+  QueryType2["CreateTable"] = "CreateTable";
+  QueryType2["CreateIndex"] = "CreateIndex";
+  QueryType2["DropIndex"] = "DropIndex";
+  QueryType2["AlterTable"] = "AlterTable";
+  QueryType2["Batch"] = "Batch";
+  QueryType2["Transaction"] = "Transaction";
+  QueryType2["Raw"] = "Raw";
+  return QueryType2;
+})(QueryType || {});
+var Query;
+((Query2) => {
+  function Insert(insert) {
+    return { type: "Insert" /* Insert */, ...insert };
+  }
+  Query2.Insert = Insert;
+  function Select(select) {
+    return { type: "Select" /* Select */, ...select };
+  }
+  Query2.Select = Select;
+  function Update(update) {
+    return { type: "Update" /* Update */, ...update };
+  }
+  Query2.Update = Update;
+  function Delete(del) {
+    return { type: "Delete" /* Delete */, ...del };
+  }
+  Query2.Delete = Delete;
+  function CreateTable(create) {
+    return { type: "CreateTable" /* CreateTable */, ...create };
+  }
+  Query2.CreateTable = CreateTable;
+  function CreateIndex(create) {
+    return { type: "CreateIndex" /* CreateIndex */, ...create };
+  }
+  Query2.CreateIndex = CreateIndex;
+  function DropIndex(drop) {
+    return { type: "DropIndex" /* DropIndex */, ...drop };
+  }
+  Query2.DropIndex = DropIndex;
+  function Batch(batch) {
+    return { type: "Batch" /* Batch */, ...batch };
+  }
+  Query2.Batch = Batch;
+  let TransactionOperation;
+  ((TransactionOperation2) => {
+    TransactionOperation2["Begin"] = "Begin";
+    TransactionOperation2["Commit"] = "Commit";
+    TransactionOperation2["Rollback"] = "Rollback";
+  })(TransactionOperation = Query2.TransactionOperation || (Query2.TransactionOperation = {}));
+  function Transaction(transaction) {
+    return { type: "Transaction" /* Transaction */, ...transaction };
+  }
+  Query2.Transaction = Transaction;
+  function Raw(raw) {
+    if (raw.strings.some((chunk) => chunk.includes("?")))
+      throw new TypeError("SQL injection hazard");
+    return { type: "Raw" /* Raw */, ...raw };
+  }
+  Query2.Raw = Raw;
+  function AlterTable(alter) {
+    return { type: "AlterTable" /* AlterTable */, ...alter };
+  }
+  Query2.AlterTable = AlterTable;
+})(Query || (Query = {}));
+export {
+  Query,
+  QueryType
+};

package/dist/lib/Sanitizer.d.ts

@@ -1,5 +1,5 @@
-export interface Sanitizer {
-    escapeValue(value: any): string;
-    escapeIdentifier(ident: string): string;
-    formatParamValue(paramValue: any): any;
-}
+export interface Sanitizer {
+    escapeValue(value: any): string;
+    escapeIdentifier(ident: string): string;
+    formatParamValue(paramValue: any): any;
+}

package/dist/lib/Schema.d.ts

@@ -0,0 +1,18 @@
+import { ColumnData } from './Column';
+import { Formatter } from './Formatter';
+import { IndexData } from './Index';
+import { Query } from './Query';
+export interface Schema {
+    name: string;
+    alias?: string;
+    columns: Record<string, ColumnData>;
+    indexes: Record<string, IndexData>;
+}
+export interface SchemaInstructions {
+    columns: Record<string, string>;
+    indexes: Record<string, string>;
+}
+export declare namespace Schema {
+    function create(schema: Schema): Query.Batch;
+    function upgrade(formatter: Formatter, local: SchemaInstructions, schema: Schema): Array<Query>;
+}