@kensio/yulin 1.20.6 → 1.20.8

package/dist/service/athena/execution/sim-athena-query-execution-store.d.ts

@@ -0,0 +1,24 @@
+import type { SimAthenaQueryExecution } from "./sim-athena-query-execution.js";
+/**
+ * The query executions of one simulated Athena scope.
+ */
+export declare class SimAthenaQueryExecutionStore {
+    private readonly executions;
+    /**
+     * Every execution in this scope, oldest first.
+     */
+    get all(): readonly SimAthenaQueryExecution[];
+    /**
+     * Store an execution.
+     */
+    put(execution: SimAthenaQueryExecution): void;
+    /**
+     * Find an execution by id.
+     */
+    find(queryExecutionId: string): SimAthenaQueryExecution | undefined;
+    /**
+     * Resolve an execution by id, or refuse.
+     */
+    require(queryExecutionId: string): SimAthenaQueryExecution;
+}
+//# sourceMappingURL=sim-athena-query-execution-store.d.ts.map

package/dist/service/athena/execution/sim-athena-query-execution-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-athena-query-execution-store.d.ts","sourceRoot":"","sources":["../../../../src/service/athena/execution/sim-athena-query-execution-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE/E;;GAEG;AACH,qBAAa,4BAA4B;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8C;IAEzE;;OAEG;IACH,IAAI,GAAG,IAAI,SAAS,uBAAuB,EAAE,CAE5C;IAED;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,uBAAuB,GAAG,IAAI,CAE5C;IAED;;OAEG;IACH,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAElE;IAED;;OAEG;IACH,OAAO,CAAC,gBAAgB,EAAE,MAAM,GAAG,uBAAuB,CAUzD;CACF"}

package/dist/service/athena/execution/sim-athena-query-execution-store.js

@@ -0,0 +1,36 @@
+import { SimAthenaInvalidRequestException } from "../error/sim-athena.error.js";
+/**
+ * The query executions of one simulated Athena scope.
+ */
+export class SimAthenaQueryExecutionStore {
+    executions = new Map();
+    /**
+     * Every execution in this scope, oldest first.
+     */
+    get all() {
+        return this.executions.values().toArray();
+    }
+    /**
+     * Store an execution.
+     */
+    put(execution) {
+        this.executions.set(execution.queryExecutionId, execution);
+    }
+    /**
+     * Find an execution by id.
+     */
+    find(queryExecutionId) {
+        return this.executions.get(queryExecutionId);
+    }
+    /**
+     * Resolve an execution by id, or refuse.
+     */
+    require(queryExecutionId) {
+        const found = this.find(queryExecutionId);
+        if (found === undefined) {
+            throw new SimAthenaInvalidRequestException(`QueryExecution ${queryExecutionId} was not found`);
+        }
+        return found;
+    }
+}
+//# sourceMappingURL=sim-athena-query-execution-store.js.map

package/dist/service/athena/execution/sim-athena-query-execution-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-athena-query-execution-store.js","sourceRoot":"","sources":["../../../../src/service/athena/execution/sim-athena-query-execution-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAGhF;;GAEG;AACH,MAAM,OAAO,4BAA4B;IACtB,UAAU,GAAG,IAAI,GAAG,EAAmC,CAAC;IAEzE;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAkC;QACpC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,gBAAwB;QAC3B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,gBAAwB;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAE1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,gCAAgC,CACxC,kBAAkB,gBAAgB,gBAAgB,CACnD,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/service/athena/execution/sim-athena-query-execution.d.ts

@@ -0,0 +1,58 @@
+import type { SimAthenaResolvedResult } from "../result/sim-athena-resolved-result.js";
+import type { SimAthenaQueryState } from "./sim-athena-query-state.js";
+interface SimAthenaQueryExecutionProperties {
+    readonly queryExecutionId: string;
+    readonly queryString: string;
+    readonly workGroupName: string;
+    readonly outputLocation: string;
+    readonly submittedAt: Date;
+    readonly database?: string | undefined;
+    readonly catalog?: string | undefined;
+}
+/**
+ * One simulated Athena query execution.
+ *
+ * A query is the one thing here that changes over time, so this is held
+ * mutably and moved through its states by `SimAthenaQueryRunner`. Everything
+ * else in simulated Athena is replaced rather than mutated.
+ *
+ * The result it settles with is a declaration, matched on the query text. No
+ * SQL is read to produce it.
+ */
+export declare class SimAthenaQueryExecution {
+    #private;
+    readonly queryExecutionId: string;
+    readonly queryString: string;
+    readonly workGroupName: string;
+    readonly outputLocation: string;
+    readonly submittedAt: Date;
+    readonly database: string | undefined;
+    readonly catalog: string | undefined;
+    constructor(properties: SimAthenaQueryExecutionProperties);
+    get state(): SimAthenaQueryState;
+    get stateChangeReason(): string | undefined;
+    get completedAt(): Date | undefined;
+    /**
+     * How many bytes the query scanned.
+     *
+     * Reported whichever way the query ended, because a caller counting the cost
+     * of a query that failed still wants it.
+     */
+    get bytesScanned(): number;
+    /** The rows this query answered with, once it has succeeded. */
+    get result(): SimAthenaResolvedResult | undefined;
+    /** Whether this query has finished. */
+    get isSettled(): boolean;
+    /** Move the query from queued to running. */
+    start(): void;
+    /** Record what the query scanned, whether or not it goes on to succeed. */
+    recordBytesScanned(bytesScanned: number): void;
+    /** Finish the query with the rows it answered. */
+    succeed(result: SimAthenaResolvedResult, completedAt: Date): void;
+    /** Finish the query without an answer, saying why. */
+    fail(reason: string, completedAt: Date): void;
+    /** Give up on a query a caller stopped. */
+    cancel(completedAt: Date): void;
+}
+export {};
+//# sourceMappingURL=sim-athena-query-execution.d.ts.map

package/dist/service/athena/execution/sim-athena-query-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-athena-query-execution.d.ts","sourceRoot":"","sources":["../../../../src/service/athena/execution/sim-athena-query-execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGvE,UAAU,iCAAiC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,qBAAa,uBAAuB;;IAClC,SAAgB,gBAAgB,EAAE,MAAM,CAAC;IACzC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,aAAa,EAAE,MAAM,CAAC;IACtC,SAAgB,cAAc,EAAE,MAAM,CAAC;IACvC,SAAgB,WAAW,EAAE,IAAI,CAAC;IAClC,SAAgB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,SAAgB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAM5C,YAAY,UAAU,EAAE,iCAAiC,EAQxD;IAED,IAAI,KAAK,IAAI,mBAAmB,CAE/B;IAED,IAAI,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAE1C;IAED,IAAI,WAAW,IAAI,IAAI,GAAG,SAAS,CAElC;IAED;;;;;OAKG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,gEAAgE;IAChE,IAAI,MAAM,IAAI,uBAAuB,GAAG,SAAS,CAEhD;IAED,uCAAuC;IACvC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,6CAA6C;IAC7C,KAAK,IAAI,IAAI,CAEZ;IAED,2EAA2E;IAC3E,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAE7C;IAED,kDAAkD;IAClD,OAAO,CAAC,MAAM,EAAE,uBAAuB,EAAE,WAAW,EAAE,IAAI,GAAG,IAAI,CAIhE;IAED,sDAAsD;IACtD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,GAAG,IAAI,CAE5C;IAED,2CAA2C;IAC3C,MAAM,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI,CAE9B;CACF"}

package/dist/service/athena/execution/sim-athena-query-execution.js

@@ -0,0 +1,81 @@
+import { SimAthenaQueryStatus } from "./sim-athena-query-status.js";
+/**
+ * One simulated Athena query execution.
+ *
+ * A query is the one thing here that changes over time, so this is held
+ * mutably and moved through its states by `SimAthenaQueryRunner`. Everything
+ * else in simulated Athena is replaced rather than mutated.
+ *
+ * The result it settles with is a declaration, matched on the query text. No
+ * SQL is read to produce it.
+ */
+export class SimAthenaQueryExecution {
+    queryExecutionId;
+    queryString;
+    workGroupName;
+    outputLocation;
+    submittedAt;
+    database;
+    catalog;
+    #status = new SimAthenaQueryStatus();
+    #bytesScanned = 0;
+    #result;
+    constructor(properties) {
+        this.queryExecutionId = properties.queryExecutionId;
+        this.queryString = properties.queryString;
+        this.workGroupName = properties.workGroupName;
+        this.outputLocation = properties.outputLocation;
+        this.submittedAt = properties.submittedAt;
+        this.database = properties.database;
+        this.catalog = properties.catalog;
+    }
+    get state() {
+        return this.#status.state;
+    }
+    get stateChangeReason() {
+        return this.#status.stateChangeReason;
+    }
+    get completedAt() {
+        return this.#status.completedAt;
+    }
+    /**
+     * How many bytes the query scanned.
+     *
+     * Reported whichever way the query ended, because a caller counting the cost
+     * of a query that failed still wants it.
+     */
+    get bytesScanned() {
+        return this.#bytesScanned;
+    }
+    /** The rows this query answered with, once it has succeeded. */
+    get result() {
+        return this.#result;
+    }
+    /** Whether this query has finished. */
+    get isSettled() {
+        return this.#status.isSettled;
+    }
+    /** Move the query from queued to running. */
+    start() {
+        this.#status.start();
+    }
+    /** Record what the query scanned, whether or not it goes on to succeed. */
+    recordBytesScanned(bytesScanned) {
+        this.#bytesScanned = bytesScanned;
+    }
+    /** Finish the query with the rows it answered. */
+    succeed(result, completedAt) {
+        if (this.#status.settle("SUCCEEDED", undefined, completedAt)) {
+            this.#result = result;
+        }
+    }
+    /** Finish the query without an answer, saying why. */
+    fail(reason, completedAt) {
+        this.#status.settle("FAILED", reason, completedAt);
+    }
+    /** Give up on a query a caller stopped. */
+    cancel(completedAt) {
+        this.#status.settle("CANCELLED", "Query cancelled by user", completedAt);
+    }
+}
+//# sourceMappingURL=sim-athena-query-execution.js.map

package/dist/service/athena/execution/sim-athena-query-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-athena-query-execution.js","sourceRoot":"","sources":["../../../../src/service/athena/execution/sim-athena-query-execution.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAYpE;;;;;;;;;GASG;AACH,MAAM,OAAO,uBAAuB;IAClB,gBAAgB,CAAS;IACzB,WAAW,CAAS;IACpB,aAAa,CAAS;IACtB,cAAc,CAAS;IACvB,WAAW,CAAO;IAClB,QAAQ,CAAqB;IAC7B,OAAO,CAAqB;IAEnC,OAAO,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC9C,aAAa,GAAG,CAAC,CAAC;IAClB,OAAO,CAAsC;IAE7C,YAAY,UAA6C;QACvD,IAAI,CAAC,gBAAgB,GAAG,UAAU,CAAC,gBAAgB,CAAC;QACpD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,aAAa,CAAC;QAC9C,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC;QAChD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IACpC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC;IACxC,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,gEAAgE;IAChE,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,uCAAuC;IACvC,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;IAChC,CAAC;IAED,6CAA6C;IAC7C,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,2EAA2E;IAC3E,kBAAkB,CAAC,YAAoB;QACrC,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;IACpC,CAAC;IAED,kDAAkD;IAClD,OAAO,CAAC,MAA+B,EAAE,WAAiB;QACxD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,CAAC;YAC7D,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACxB,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,IAAI,CAAC,MAAc,EAAE,WAAiB;QACpC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACrD,CAAC;IAED,2CAA2C;IAC3C,MAAM,CAAC,WAAiB;QACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,yBAAyB,EAAE,WAAW,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/service/athena/execution/sim-athena-query-runner.d.ts

@@ -0,0 +1,48 @@
+import type { BackgroundScheduler } from "../../../util/background/background.js";
+import type { SimAwsCaller } from "../../aws/caller/sim-aws-caller.js";
+import type { SimAthenaQueryResults } from "../result/sim-athena-query-results.js";
+import type { SimAthenaWorkGroupStore } from "../workgroup/sim-athena-work-group-store.js";
+import type { SimAthenaQueryExecution } from "./sim-athena-query-execution.js";
+import type { SimAthenaResultWriter } from "./sim-athena-result-writer.js";
+interface SimAthenaQueryRunnerProperties {
+    readonly results: SimAthenaQueryResults;
+    readonly workGroups: SimAthenaWorkGroupStore;
+    readonly writer: SimAthenaResultWriter;
+    readonly background: BackgroundScheduler;
+}
+/**
+ * Moves a query execution through its states on the background scheduler.
+ *
+ * A query is queued as soon as `StartQueryExecution` is answered and reaches
+ * `RUNNING` on the simulator's background work, the way
+ * `SimEcsServiceTaskStarter` schedules a task to reach `RUNNING`. Finishing is
+ * scheduled again from there, so a caller polling `GetQueryExecution` sees
+ * each state rather than a query that was already over by the time it looked.
+ *
+ * A query somebody stopped in between is left where it is. Nothing here brings
+ * a settled execution back.
+ */
+export declare class SimAthenaQueryRunner {
+    private readonly results;
+    private readonly workGroups;
+    private readonly writer;
+    private readonly background;
+    constructor(properties: SimAthenaQueryRunnerProperties);
+    /**
+     * Run one queued execution, a state at a time.
+     */
+    run(execution: SimAthenaQueryExecution, caller: SimAwsCaller | undefined): void;
+    private scheduleFinish;
+    private finish;
+    /**
+     * Why this query cannot answer, where something says it cannot.
+     *
+     * The cutoff is checked against what the declaration says the query
+     * scanned. That is the whole of the cost guardrail here, and it is the one
+     * thing this simulation can enforce for real without a query engine.
+     */
+    private refusalFor;
+    private write;
+}
+export {};
+//# sourceMappingURL=sim-athena-query-runner.d.ts.map

package/dist/service/athena/execution/sim-athena-query-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-athena-query-runner.d.ts","sourceRoot":"","sources":["../../../../src/service/athena/execution/sim-athena-query-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAEnF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAC3F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAG3E,UAAU,8BAA8B;IACtC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;CAC1C;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IAEjD,YAAY,UAAU,EAAE,8BAA8B,EAKrD;IAED;;OAEG;IACH,GAAG,CACD,SAAS,EAAE,uBAAuB,EAClC,MAAM,EAAE,YAAY,GAAG,SAAS,GAC/B,IAAI,CASN;IAED,OAAO,CAAC,cAAc;YAWR,MAAM;IAsBpB;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;YAuBJ,KAAK;CAepB"}

package/dist/service/athena/execution/sim-athena-query-runner.js

@@ -0,0 +1,87 @@
+import { simAthenaWriteFailureReason } from "./sim-athena-write-failure.js";
+/**
+ * Moves a query execution through its states on the background scheduler.
+ *
+ * A query is queued as soon as `StartQueryExecution` is answered and reaches
+ * `RUNNING` on the simulator's background work, the way
+ * `SimEcsServiceTaskStarter` schedules a task to reach `RUNNING`. Finishing is
+ * scheduled again from there, so a caller polling `GetQueryExecution` sees
+ * each state rather than a query that was already over by the time it looked.
+ *
+ * A query somebody stopped in between is left where it is. Nothing here brings
+ * a settled execution back.
+ */
+export class SimAthenaQueryRunner {
+    results;
+    workGroups;
+    writer;
+    background;
+    constructor(properties) {
+        this.results = properties.results;
+        this.workGroups = properties.workGroups;
+        this.writer = properties.writer;
+        this.background = properties.background;
+    }
+    /**
+     * Run one queued execution, a state at a time.
+     */
+    run(execution, caller) {
+        this.background.schedule(() => {
+            if (!execution.isSettled) {
+                execution.start();
+                this.scheduleFinish(execution, caller);
+            }
+            return Promise.resolve();
+        });
+    }
+    scheduleFinish(execution, caller) {
+        this.background.schedule(async () => {
+            if (!execution.isSettled) {
+                await this.finish(execution, caller);
+            }
+        });
+    }
+    async finish(execution, caller) {
+        const result = this.results.resultFor({
+            queryString: execution.queryString,
+            workGroupName: execution.workGroupName,
+        });
+        execution.recordBytesScanned(result.bytesScanned);
+        const refusal = this.refusalFor(execution, result);
+        if (refusal !== undefined) {
+            execution.fail(refusal, this.background.now());
+            return;
+        }
+        await this.write(execution, result, caller);
+    }
+    /**
+     * Why this query cannot answer, where something says it cannot.
+     *
+     * The cutoff is checked against what the declaration says the query
+     * scanned. That is the whole of the cost guardrail here, and it is the one
+     * thing this simulation can enforce for real without a query engine.
+     */
+    refusalFor(execution, result) {
+        if (result.failsWith !== undefined) {
+            return result.failsWith;
+        }
+        const cutoff = this.workGroups.find(execution.workGroupName)?.bytesScannedCutoffPerQuery;
+        if (cutoff === undefined || result.bytesScanned <= cutoff) {
+            return undefined;
+        }
+        return (`Bytes scanned limit was exceeded. The query scanned ` +
+            `${String(result.bytesScanned)} bytes, and workgroup ` +
+            `${execution.workGroupName} allows ${String(cutoff)} per query.`);
+    }
+    async write(execution, result, caller) {
+        try {
+            await this.writer.write(execution, result, caller);
+        }
+        catch (error) {
+            execution.fail(simAthenaWriteFailureReason(error), this.background.now());
+            return;
+        }
+        execution.succeed(result, this.background.now());
+    }
+}
+//# sourceMappingURL=sim-athena-query-runner.js.map

package/dist/service/athena/execution/sim-athena-query-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-athena-query-runner.js","sourceRoot":"","sources":["../../../../src/service/athena/execution/sim-athena-query-runner.ts"],"names":[],"mappings":"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"}

package/dist/service/athena/execution/sim-athena-query-state.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Where one query execution has got to.
+ */
+export type SimAthenaQueryState = "QUEUED" | "RUNNING" | "SUCCEEDED" | "FAILED" | "CANCELLED";
+/**
+ * Whether a query in this state has finished.
+ *
+ * `StopQueryExecution` reaches a query that has not, and leaves one that has
+ * alone, which is how real Athena answers a stop that arrived too late.
+ */
+export declare function isSettledQueryState(state: SimAthenaQueryState): boolean;
+//# sourceMappingURL=sim-athena-query-state.d.ts.map

package/dist/service/athena/execution/sim-athena-query-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-athena-query-state.d.ts","sourceRoot":"","sources":["../../../../src/service/athena/execution/sim-athena-query-state.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,QAAQ,GACR,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAWhB;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAEvE"}

package/dist/service/athena/execution/sim-athena-query-state.js

@@ -0,0 +1,18 @@
+/**
+ * The states a query has finished in, whichever way it went.
+ */
+const settledStates = new Set([
+    "SUCCEEDED",
+    "FAILED",
+    "CANCELLED",
+]);
+/**
+ * Whether a query in this state has finished.
+ *
+ * `StopQueryExecution` reaches a query that has not, and leaves one that has
+ * alone, which is how real Athena answers a stop that arrived too late.
+ */
+export function isSettledQueryState(state) {
+    return settledStates.has(state);
+}
+//# sourceMappingURL=sim-athena-query-state.js.map

package/dist/service/athena/execution/sim-athena-query-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-athena-query-state.js","sourceRoot":"","sources":["../../../../src/service/athena/execution/sim-athena-query-state.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAsB;IACjD,WAAW;IACX,QAAQ;IACR,WAAW;CACZ,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAA0B;IAC5D,OAAO,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/dist/service/athena/execution/sim-athena-query-status.d.ts

@@ -0,0 +1,28 @@
+import { type SimAthenaQueryState } from "./sim-athena-query-state.js";
+/**
+ * Where one query has got to, and how it got there.
+ *
+ * Held apart from the execution because it is the only part that changes. A
+ * query that has settled stays as it settled, and that rule lives here so
+ * every caller gets it rather than each one remembering to ask first.
+ */
+export declare class SimAthenaQueryStatus {
+    #private;
+    get state(): SimAthenaQueryState;
+    get stateChangeReason(): string | undefined;
+    get completedAt(): Date | undefined;
+    get isSettled(): boolean;
+    /**
+     * Move a queued query to running.
+     */
+    start(): void;
+    /**
+     * Finish the query, unless something already did.
+     *
+     * Writing a result set is awaited, so a `StopQueryExecution` can land while
+     * it is in flight. Without this the write would carry a cancelled query
+     * through to `SUCCEEDED` after its caller was told it had been stopped.
+     */
+    settle(state: SimAthenaQueryState, reason: string | undefined, completedAt: Date): boolean;
+}
+//# sourceMappingURL=sim-athena-query-status.d.ts.map

package/dist/service/athena/execution/sim-athena-query-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-athena-query-status.d.ts","sourceRoot":"","sources":["../../../../src/service/athena/execution/sim-athena-query-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AAErC;;;;;;GAMG;AACH,qBAAa,oBAAoB;;IAK/B,IAAI,KAAK,IAAI,mBAAmB,CAE/B;IAED,IAAI,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAE1C;IAED,IAAI,WAAW,IAAI,IAAI,GAAG,SAAS,CAElC;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;IAED;;;;;;OAMG;IACH,MAAM,CACJ,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,IAAI,GAChB,OAAO,CAUT;CACF"}

package/dist/service/athena/execution/sim-athena-query-status.js

@@ -0,0 +1,48 @@
+import { isSettledQueryState, } from "./sim-athena-query-state.js";
+/**
+ * Where one query has got to, and how it got there.
+ *
+ * Held apart from the execution because it is the only part that changes. A
+ * query that has settled stays as it settled, and that rule lives here so
+ * every caller gets it rather than each one remembering to ask first.
+ */
+export class SimAthenaQueryStatus {
+    #state = "QUEUED";
+    #stateChangeReason;
+    #completedAt;
+    get state() {
+        return this.#state;
+    }
+    get stateChangeReason() {
+        return this.#stateChangeReason;
+    }
+    get completedAt() {
+        return this.#completedAt;
+    }
+    get isSettled() {
+        return isSettledQueryState(this.#state);
+    }
+    /**
+     * Move a queued query to running.
+     */
+    start() {
+        this.#state = "RUNNING";
+    }
+    /**
+     * Finish the query, unless something already did.
+     *
+     * Writing a result set is awaited, so a `StopQueryExecution` can land while
+     * it is in flight. Without this the write would carry a cancelled query
+     * through to `SUCCEEDED` after its caller was told it had been stopped.
+     */
+    settle(state, reason, completedAt) {
+        if (this.isSettled) {
+            return false;
+        }
+        this.#state = state;
+        this.#stateChangeReason = reason;
+        this.#completedAt = completedAt;
+        return true;
+    }
+}
+//# sourceMappingURL=sim-athena-query-status.js.map

package/dist/service/athena/execution/sim-athena-query-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-athena-query-status.js","sourceRoot":"","sources":["../../../../src/service/athena/execution/sim-athena-query-status.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,GAEpB,MAAM,6BAA6B,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IAC/B,MAAM,GAAwB,QAAQ,CAAC;IACvC,kBAAkB,CAAqB;IACvC,YAAY,CAAmB;IAE/B,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,SAAS;QACX,OAAO,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CACJ,KAA0B,EAC1B,MAA0B,EAC1B,WAAiB;QAEjB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAEhC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/service/athena/execution/sim-athena-query-tokens.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The queries a `ClientRequestToken` has already started.
+ *
+ * A token makes `StartQueryExecution` idempotent. A client that retries after
+ * a timeout sends the same token and gets the same execution back rather than
+ * running the query twice, which is the whole point of the field for an API
+ * that bills per byte scanned.
+ *
+ * Accepting a token and ignoring it would be the worse kind of divergence: a
+ * retry would look right and cost twice.
+ */
+export declare class SimAthenaQueryTokens {
+    private readonly startedQueries;
+    /**
+     * The execution this token already started, if it started one.
+     *
+     * A token reused for a different query is refused. Real Athena answers
+     * `IdempotentParameterMismatch`, because the token no longer identifies one
+     * request.
+     */
+    startedBy(token: string | undefined, queryString: string): string | undefined;
+    /**
+     * Remember which execution a token started.
+     *
+     * A request carrying no token is nothing to remember. It is not idempotent,
+     * which is what sending no token asks for.
+     */
+    record(token: string | undefined, queryString: string, queryExecutionId: string): void;
+}
+//# sourceMappingURL=sim-athena-query-tokens.d.ts.map

package/dist/service/athena/execution/sim-athena-query-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-athena-query-tokens.d.ts","sourceRoot":"","sources":["../../../../src/service/athena/execution/sim-athena-query-tokens.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;GAUG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG3B;IAEJ;;;;;;OAMG;IACH,SAAS,CACP,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAgBpB;IAED;;;;;OAKG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,GACvB,IAAI,CAMN;CACF"}

package/dist/service/athena/execution/sim-athena-query-tokens.js

@@ -0,0 +1,49 @@
+/* oxlint-disable security/detect-possible-timing-attacks -- a client request
+   token is an idempotency key a caller chooses and sends in the clear. Nothing
+   here compares a secret, so there is no timing to leak. */
+import { SimAthenaInvalidRequestException } from "../error/sim-athena.error.js";
+/**
+ * The queries a `ClientRequestToken` has already started.
+ *
+ * A token makes `StartQueryExecution` idempotent. A client that retries after
+ * a timeout sends the same token and gets the same execution back rather than
+ * running the query twice, which is the whole point of the field for an API
+ * that bills per byte scanned.
+ *
+ * Accepting a token and ignoring it would be the worse kind of divergence: a
+ * retry would look right and cost twice.
+ */
+export class SimAthenaQueryTokens {
+    startedQueries = new Map();
+    /**
+     * The execution this token already started, if it started one.
+     *
+     * A token reused for a different query is refused. Real Athena answers
+     * `IdempotentParameterMismatch`, because the token no longer identifies one
+     * request.
+     */
+    startedBy(token, queryString) {
+        const started = token === undefined ? undefined : this.startedQueries.get(token);
+        if (started === undefined) {
+            return undefined;
+        }
+        if (started.queryString !== queryString) {
+            throw new SimAthenaInvalidRequestException(`ClientRequestToken ${String(token)} has already been used for a ` +
+                `different query. A token identifies one request.`);
+        }
+        return started.queryExecutionId;
+    }
+    /**
+     * Remember which execution a token started.
+     *
+     * A request carrying no token is nothing to remember. It is not idempotent,
+     * which is what sending no token asks for.
+     */
+    record(token, queryString, queryExecutionId) {
+        if (token === undefined) {
+            return;
+        }
+        this.startedQueries.set(token, { queryString, queryExecutionId });
+    }
+}
+//# sourceMappingURL=sim-athena-query-tokens.js.map

package/dist/service/athena/execution/sim-athena-query-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-athena-query-tokens.js","sourceRoot":"","sources":["../../../../src/service/athena/execution/sim-athena-query-tokens.ts"],"names":[],"mappings":"AAAA;;4DAE4D;AAE5D,OAAO,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,oBAAoB;IACd,cAAc,GAAG,IAAI,GAAG,EAGtC,CAAC;IAEJ;;;;;;OAMG;IACH,SAAS,CACP,KAAyB,EACzB,WAAmB;QAEnB,MAAM,OAAO,GACX,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEnE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;YACxC,MAAM,IAAI,gCAAgC,CACxC,sBAAsB,MAAM,CAAC,KAAK,CAAC,+BAA+B;gBAChE,kDAAkD,CACrD,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC,gBAAgB,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CACJ,KAAyB,EACzB,WAAmB,EACnB,gBAAwB;QAExB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/service/athena/execution/sim-athena-result-csv.d.ts

@@ -0,0 +1,11 @@
+import type { SimAthenaResolvedResult } from "../result/sim-athena-resolved-result.js";
+/**
+ * One query's result set as the CSV Athena writes to S3.
+ *
+ * Athena quotes every field of a CSV result rather than only the ones that
+ * need it, and it writes the column names as the first line. A caller reading
+ * the object back gets the header whether or not it asked for one, which is
+ * the same thing `GetQueryResults` does with its first row.
+ */
+export declare function simAthenaResultCsv(result: SimAthenaResolvedResult): string;
+//# sourceMappingURL=sim-athena-result-csv.d.ts.map

package/dist/service/athena/execution/sim-athena-result-csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-athena-result-csv.d.ts","sourceRoot":"","sources":["../../../../src/service/athena/execution/sim-athena-result-csv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAEvF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAK1E"}

package/dist/service/athena/execution/sim-athena-result-csv.js

@@ -0,0 +1,20 @@
+/**
+ * One query's result set as the CSV Athena writes to S3.
+ *
+ * Athena quotes every field of a CSV result rather than only the ones that
+ * need it, and it writes the column names as the first line. A caller reading
+ * the object back gets the header whether or not it asked for one, which is
+ * the same thing `GetQueryResults` does with its first row.
+ */
+export function simAthenaResultCsv(result) {
+    const header = result.columns.map((column) => column.name);
+    const lines = [header, ...result.rows].map(csvLine);
+    return `${lines.join("\n")}\n`;
+}
+function csvLine(values) {
+    return values.map(csvField).join(",");
+}
+function csvField(value) {
+    return `"${value.replaceAll('"', '""')}"`;
+}
+//# sourceMappingURL=sim-athena-result-csv.js.map

package/dist/service/athena/execution/sim-athena-result-csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-athena-result-csv.js","sourceRoot":"","sources":["../../../../src/service/athena/execution/sim-athena-result-csv.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA+B;IAChE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAEpD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,SAAS,OAAO,CAAC,MAAyB;IACxC,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;AAC5C,CAAC"}