@oleanderhq/sdk 0.1.0

package/README.md

@@ -0,0 +1,89 @@
+# oleander TypeScript SDK
+
+Use the [oleander](https://oleander.dev) API from TypeScript: run lake queries, list Spark jobs, and launch Spark jobs. Inputs and responses are validated with [Zod](https://zod.dev).
+
+## Install
+
+```bash
+npm install @oleanderhq/sdk
+```
+
+Or: `yarn add @oleanderhq/sdk` / `pnpm add @oleanderhq/sdk`
+
+## Get your API key
+
+Create an API key in [oleander settings](https://oleander.dev/app/settings), or run `oleander configure` if you use the CLI. You can pass the key when creating the client or set the `OLEANDER_API_KEY` environment variable (Node only).
+
+## Quick start
+
+```ts
+import { Oleander } from "@oleanderhq/sdk";
+
+const oleander = new Oleander();
+const list = await oleander.listSparkJobs();
+console.log(list.scripts);
+```
+
+## API
+
+### Query (lake)
+
+Run a SQL query against the oleander lake. The second parameter is optional; `save` defaults to `false`. Use `save: true` to persist results as a table.
+
+```ts
+const result = await oleander.query(
+  "SELECT * FROM public.iris_dataset LIMIT 10",
+);
+console.log(result.results?.columns, result.results?.rows);
+console.log(result.row_count, result.execution_time);
+if (result.saved_table_name) console.log("Saved to:", result.saved_table_name);
+```
+
+### List Spark jobs
+
+Paginated list of your Spark job scripts. Options: `limit` (default 20), `offset` (default 0).
+
+```ts
+const list = await oleander.listSparkJobs();
+console.log(list.scripts, list.hasMore);
+
+const next = await oleander.listSparkJobs({ offset: 20 });
+```
+
+### Launch Spark job
+
+Submit a Spark job. Required: `namespace`, `name`, `scriptName`. Other options (e.g. `args`, machine types, tags) have defaults.
+
+```ts
+const { runId } = await oleander.submitSparkJob({
+  namespace: "my-namespace",
+  name: "my-job-name",
+  scriptName: "my_script.py",
+});
+console.log("Run ID:", runId);
+```
+
+### Wait for a run to finish
+
+Submit and poll until the run completes. Optional: `pollIntervalMs` (default 10000), `timeoutMs` (default 600000).
+
+```ts
+const { runId, state, run } = await oleander.submitSparkJobAndWait({
+  namespace: "my-namespace",
+  name: "my-job-name",
+  scriptName: "my_script.py",
+});
+console.log(runId, state); // COMPLETE | FAIL | ABORT
+```
+
+### Get run status
+
+```ts
+const run = await oleander.getRun(runId);
+console.log(run.state, run.duration);
+```
+
+## Options
+
+- **Constructor**: `new Oleander({ apiKey?, baseUrl? })`. Omit `apiKey` to use `OLEANDER_API_KEY`. Set `baseUrl` to use a different endpoint (e.g. `http://localhost:3000`).
+- **Schemas**: The package exports Zod schemas (e.g. `optionsSchema`, `submitOptionsSchema`) if you want to validate config or options yourself.

package/dist/index.cjs

@@ -0,0 +1,314 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Oleander: () => Oleander,
+  apiErrorBodySchema: () => apiErrorBodySchema,
+  lakeQueryResultSchema: () => lakeQueryResultSchema,
+  listSparkJobsOptionsSchema: () => listSparkJobsOptionsSchema,
+  listSparkJobsResultSchema: () => listSparkJobsResultSchema,
+  optionsSchema: () => optionsSchema,
+  queryOptionsSchema: () => queryOptionsSchema,
+  runResponseSchema: () => runResponseSchema,
+  sparkJobListPageSchema: () => sparkJobListPageSchema,
+  sparkJobRunSchema: () => sparkJobRunSchema,
+  sparkMachineTypeSchema: () => sparkMachineTypeSchema,
+  submitOptionsSchema: () => submitOptionsSchema,
+  submitSparkJobAndWaitOptionsSchema: () => submitSparkJobAndWaitOptionsSchema
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/schemas.ts
+var import_zod = require("zod");
+var apiErrorBodySchema = import_zod.z.object({
+  error: import_zod.z.string().optional(),
+  details: import_zod.z.string().optional()
+});
+var DEFAULT_BASE_URL = "https://oleander.dev";
+var optionsSchema = import_zod.z.object({
+  apiKey: import_zod.z.string().optional(),
+  baseUrl: import_zod.z.string().default(DEFAULT_BASE_URL).transform((v) => v.trim() ? v.trim() : DEFAULT_BASE_URL)
+});
+var queryOptionsSchema = import_zod.z.object({
+  save: import_zod.z.boolean().default(false)
+});
+var lakeQueryResultSchema = import_zod.z.object({
+  success: import_zod.z.boolean(),
+  results: import_zod.z.object({
+    columns: import_zod.z.array(import_zod.z.string()),
+    column_types: import_zod.z.array(import_zod.z.string()),
+    rows: import_zod.z.array(import_zod.z.array(import_zod.z.unknown()))
+  }).optional(),
+  row_count: import_zod.z.number().optional(),
+  execution_time: import_zod.z.string().optional(),
+  saved_table_name: import_zod.z.string().optional(),
+  error: import_zod.z.string().optional(),
+  details: import_zod.z.string().optional(),
+  query: import_zod.z.string().optional()
+});
+var sparkJobListPageSchema = import_zod.z.object({
+  scripts: import_zod.z.array(import_zod.z.string()),
+  continuationToken: import_zod.z.string().optional()
+});
+var listSparkJobsOptionsSchema = import_zod.z.object({
+  limit: import_zod.z.number().int().positive().default(20),
+  offset: import_zod.z.number().int().nonnegative().default(0)
+});
+var listSparkJobsResultSchema = import_zod.z.object({
+  scripts: import_zod.z.array(import_zod.z.string()),
+  hasMore: import_zod.z.boolean()
+});
+var sparkMachineTypeSchema = import_zod.z.enum([
+  "spark.1.c",
+  "spark.2.c",
+  "spark.4.c",
+  "spark.8.c",
+  "spark.16.c",
+  "spark.1.b",
+  "spark.2.b",
+  "spark.4.b",
+  "spark.8.b",
+  "spark.16.b",
+  "spark.1.m",
+  "spark.2.m",
+  "spark.4.m",
+  "spark.8.m",
+  "spark.16.m"
+]);
+var submitOptionsSchema = import_zod.z.object({
+  namespace: import_zod.z.string().min(1, "namespace is required"),
+  name: import_zod.z.string().min(1, "name is required"),
+  scriptName: import_zod.z.string().min(1, "scriptName is required"),
+  args: import_zod.z.array(import_zod.z.string()).default([]),
+  driverMachineType: sparkMachineTypeSchema.default("spark.1.b"),
+  executorMachineType: sparkMachineTypeSchema.default("spark.1.b"),
+  executorNumbers: import_zod.z.number().int().min(1).max(20).default(2),
+  jobTags: import_zod.z.array(import_zod.z.string()).default([]),
+  runTags: import_zod.z.array(import_zod.z.string()).default([])
+});
+var submitSparkJobAndWaitOptionsSchema = submitOptionsSchema.extend({
+  pollIntervalMs: import_zod.z.number().int().positive().default(1e4),
+  timeoutMs: import_zod.z.number().int().positive().default(6e5)
+});
+var sparkJobRunSchema = import_zod.z.object({
+  runId: import_zod.z.string()
+});
+var runResponseSchema = import_zod.z.object({
+  id: import_zod.z.string(),
+  state: import_zod.z.string().nullable(),
+  started_at: import_zod.z.string().nullable().optional(),
+  queued_at: import_zod.z.string().nullable().optional(),
+  scheduled_at: import_zod.z.string().nullable().optional(),
+  ended_at: import_zod.z.string().nullable().optional(),
+  duration: import_zod.z.number().nullable().optional(),
+  error: import_zod.z.unknown().nullable().optional(),
+  tags: import_zod.z.array(
+    import_zod.z.object({
+      key: import_zod.z.string(),
+      value: import_zod.z.string(),
+      source: import_zod.z.string().nullable().optional()
+    })
+  ),
+  job: import_zod.z.object({
+    id: import_zod.z.string(),
+    name: import_zod.z.string(),
+    namespace: import_zod.z.string()
+  }),
+  pipeline: import_zod.z.object({
+    id: import_zod.z.string(),
+    name: import_zod.z.string(),
+    namespace: import_zod.z.string()
+  })
+});
+
+// src/client.ts
+function getHeaders(apiKey) {
+  return {
+    Authorization: `Bearer ${apiKey}`,
+    "Content-Type": "application/json"
+  };
+}
+function parseErrorBody(body, status) {
+  const parsed = apiErrorBodySchema.safeParse(body);
+  if (parsed.success) {
+    const { error, details } = parsed.data;
+    return error || details || `HTTP ${status}`;
+  }
+  return `HTTP ${status}`;
+}
+var Oleander = class {
+  constructor(options = {}) {
+    const parsed = optionsSchema.safeParse(options);
+    if (!parsed.success) {
+      const first = parsed.error.flatten().formErrors[0] ?? parsed.error.message;
+      throw new Error(first);
+    }
+    const fromOptions = parsed.data.apiKey?.trim();
+    const fromEnv = typeof process !== "undefined" && process.env?.OLEANDER_API_KEY;
+    const apiKey = fromOptions ?? fromEnv ?? "";
+    if (!apiKey) {
+      throw new Error(
+        "Oleander requires a non-empty apiKey (or set OLEANDER_API_KEY)"
+      );
+    }
+    this.apiKey = apiKey;
+    this.baseUrl = parsed.data.baseUrl.trim().replace(/\/$/, "");
+  }
+  /**
+   * Execute a lake query (mirrors `oleander query`).
+   */
+  async query(sql, options = {}) {
+    const query = typeof sql === "string" ? sql.trim() : "";
+    if (!query) {
+      throw new Error("Query is required");
+    }
+    const opts = queryOptionsSchema.parse(options);
+    const res = await fetch(`${this.baseUrl}/api/v1/warehouse/query`, {
+      method: "POST",
+      headers: getHeaders(this.apiKey),
+      body: JSON.stringify({
+        query,
+        autoSaveByHash: opts.save
+      })
+    });
+    const raw = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      throw new Error(parseErrorBody(raw, res.status));
+    }
+    const result = lakeQueryResultSchema.parse(raw);
+    if (!result.success && result.error) {
+      throw new Error(result.details || result.error);
+    }
+    return result;
+  }
+  /**
+   * List spark jobs (mirrors `oleander spark jobs list`).
+   * Uses limit/offset pagination; pages through the API internally.
+   */
+  async listSparkJobs(options = {}) {
+    const opts = listSparkJobsOptionsSchema.parse(options);
+    const { limit, offset } = opts;
+    const allScripts = [];
+    let continuationToken;
+    while (true) {
+      const params = continuationToken ? `?${new URLSearchParams({ continuationToken }).toString()}` : "";
+      const res = await fetch(`${this.baseUrl}/api/v1/spark/scripts${params}`, {
+        method: "GET",
+        headers: { Authorization: `Bearer ${this.apiKey}` }
+      });
+      const raw = await res.json().catch(() => ({}));
+      if (!res.ok) {
+        throw new Error(parseErrorBody(raw, res.status));
+      }
+      const page = sparkJobListPageSchema.parse(raw);
+      allScripts.push(...page.scripts);
+      continuationToken = page.continuationToken;
+      if (!continuationToken || allScripts.length >= offset + limit) {
+        break;
+      }
+    }
+    const scripts = allScripts.slice(offset, offset + limit);
+    const hasMore = !!continuationToken || allScripts.length > offset + limit;
+    return { scripts, hasMore };
+  }
+  /**
+   * Submit a spark job (mirrors `oleander spark jobs submit`).
+   * Returns the run ID; use getRun() or submitSparkJobAndWait() to poll status.
+   */
+  async submitSparkJob(options) {
+    const opts = submitOptionsSchema.parse(options);
+    const res = await fetch(`${this.baseUrl}/api/v1/spark/jobs`, {
+      method: "POST",
+      headers: getHeaders(this.apiKey),
+      body: JSON.stringify({
+        namespace: opts.namespace.trim(),
+        name: opts.name.trim(),
+        scriptName: opts.scriptName.trim(),
+        arguments: opts.args,
+        driverMachineType: opts.driverMachineType,
+        executorMachineType: opts.executorMachineType,
+        executorNumbers: opts.executorNumbers,
+        jobTags: opts.jobTags,
+        runTags: opts.runTags
+      })
+    });
+    const raw = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      throw new Error(parseErrorBody(raw, res.status));
+    }
+    return sparkJobRunSchema.parse(raw);
+  }
+  /**
+   * Get run status (used for polling after submit).
+   */
+  async getRun(runId) {
+    if (!runId || typeof runId !== "string" || !runId.trim()) {
+      throw new Error("runId is required");
+    }
+    const res = await fetch(`${this.baseUrl}/api/v2/runs/${runId}`, {
+      method: "GET",
+      headers: { Authorization: `Bearer ${this.apiKey}` }
+    });
+    const raw = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      throw new Error(parseErrorBody(raw, res.status));
+    }
+    return runResponseSchema.parse(raw);
+  }
+  /**
+   * Submit a spark job and wait until the run reaches a terminal state (COMPLETE, FAIL, ABORT).
+   */
+  async submitSparkJobAndWait(options) {
+    const opts = submitSparkJobAndWaitOptionsSchema.parse(options);
+    const { pollIntervalMs, timeoutMs, ...submitOpts } = opts;
+    const { runId } = await this.submitSparkJob(submitOpts);
+    const started = Date.now();
+    while (Date.now() - started < timeoutMs) {
+      const run2 = await this.getRun(runId);
+      const state = run2.state ?? "";
+      if (state === "COMPLETE" || state === "FAIL" || state === "ABORT") {
+        return { runId, state, run: run2 };
+      }
+      await new Promise((r) => setTimeout(r, pollIntervalMs));
+    }
+    const run = await this.getRun(runId);
+    throw new Error(
+      `Timeout waiting for run ${runId} (state: ${run.state ?? "unknown"})`
+    );
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Oleander,
+  apiErrorBodySchema,
+  lakeQueryResultSchema,
+  listSparkJobsOptionsSchema,
+  listSparkJobsResultSchema,
+  optionsSchema,
+  queryOptionsSchema,
+  runResponseSchema,
+  sparkJobListPageSchema,
+  sparkJobRunSchema,
+  sparkMachineTypeSchema,
+  submitOptionsSchema,
+  submitSparkJobAndWaitOptionsSchema
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/schemas.ts","../src/client.ts"],"sourcesContent":["export { Oleander } from \"./client.js\";\nexport type { OleanderOptions } from \"./schemas.js\";\nexport type {\n  QueryOptions,\n  LakeQueryResult,\n  ApiErrorBody,\n  SparkJobListPage,\n  ListSparkJobsOptions,\n  ListSparkJobsResult,\n  SparkMachineType,\n  SparkJobSubmitOptions,\n  SubmitSparkJobAndWaitOptions,\n  SparkJobRun,\n  RunResponse,\n  RunState,\n} from \"./schemas.js\";\nexport {\n  optionsSchema,\n  queryOptionsSchema,\n  lakeQueryResultSchema,\n  sparkJobListPageSchema,\n  listSparkJobsOptionsSchema,\n  listSparkJobsResultSchema,\n  sparkMachineTypeSchema,\n  submitOptionsSchema,\n  submitSparkJobAndWaitOptionsSchema,\n  sparkJobRunSchema,\n  runResponseSchema,\n  apiErrorBodySchema,\n} from \"./schemas.js\";\n","import { z } from \"zod\";\n\n/** API error response body */\nexport const apiErrorBodySchema = z.object({\n  error: z.string().optional(),\n  details: z.string().optional(),\n});\n\nexport type ApiErrorBody = z.infer<typeof apiErrorBodySchema>;\n\nconst DEFAULT_BASE_URL = \"https://oleander.dev\";\n\n/** Constructor options. apiKey can be omitted if OLEANDER_API_KEY env is set. */\nexport const optionsSchema = z.object({\n  apiKey: z.string().optional(),\n  baseUrl: z\n    .string()\n    .default(DEFAULT_BASE_URL)\n    .transform((v) => (v.trim() ? v.trim() : DEFAULT_BASE_URL)),\n});\n\nexport type OleanderOptions = z.input<typeof optionsSchema>;\n\n/** Lake query options */\nexport const queryOptionsSchema = z.object({\n  save: z.boolean().default(false),\n});\n\nexport type QueryOptions = z.input<typeof queryOptionsSchema>;\n\n/** Lake query result (API response) */\nexport const lakeQueryResultSchema = z.object({\n  success: z.boolean(),\n  results: z\n    .object({\n      columns: z.array(z.string()),\n      column_types: z.array(z.string()),\n      rows: z.array(z.array(z.unknown())),\n    })\n    .optional(),\n  row_count: z.number().optional(),\n  execution_time: z.string().optional(),\n  saved_table_name: z.string().optional(),\n  error: z.string().optional(),\n  details: z.string().optional(),\n  query: z.string().optional(),\n});\n\nexport type LakeQueryResult = z.infer<typeof lakeQueryResultSchema>;\n\n/** API response for one page of spark scripts (S3-style) */\nexport const sparkJobListPageSchema = z.object({\n  scripts: z.array(z.string()),\n  continuationToken: z.string().optional(),\n});\n\nexport type SparkJobListPage = z.infer<typeof sparkJobListPageSchema>;\n\n/** Options for listSparkJobs (limit/offset pagination) */\nexport const listSparkJobsOptionsSchema = z.object({\n  limit: z.number().int().positive().default(20),\n  offset: z.number().int().nonnegative().default(0),\n});\n\nexport type ListSparkJobsOptions = z.input<typeof listSparkJobsOptionsSchema>;\n\n/** Result of listSparkJobs with limit/offset */\nexport const listSparkJobsResultSchema = z.object({\n  scripts: z.array(z.string()),\n  hasMore: z.boolean(),\n});\n\nexport type ListSparkJobsResult = z.infer<typeof listSparkJobsResultSchema>;\n\n/** Spark machine type enum */\nexport const sparkMachineTypeSchema = z.enum([\n  \"spark.1.c\",\n  \"spark.2.c\",\n  \"spark.4.c\",\n  \"spark.8.c\",\n  \"spark.16.c\",\n  \"spark.1.b\",\n  \"spark.2.b\",\n  \"spark.4.b\",\n  \"spark.8.b\",\n  \"spark.16.b\",\n  \"spark.1.m\",\n  \"spark.2.m\",\n  \"spark.4.m\",\n  \"spark.8.m\",\n  \"spark.16.m\",\n]);\n\nexport type SparkMachineType = z.infer<typeof sparkMachineTypeSchema>;\n\n/** Spark job submit options. Optional fields have defaults. */\nexport const submitOptionsSchema = z.object({\n  namespace: z.string().min(1, \"namespace is required\"),\n  name: z.string().min(1, \"name is required\"),\n  scriptName: z.string().min(1, \"scriptName is required\"),\n  args: z.array(z.string()).default([]),\n  driverMachineType: sparkMachineTypeSchema.default(\"spark.1.b\"),\n  executorMachineType: sparkMachineTypeSchema.default(\"spark.1.b\"),\n  executorNumbers: z.number().int().min(1).max(20).default(2),\n  jobTags: z.array(z.string()).default([]),\n  runTags: z.array(z.string()).default([]),\n});\n\nexport type SparkJobSubmitOptions = z.input<typeof submitOptionsSchema>;\n\n/** Options for submitSparkJobAndWait (submit options + optional wait tuning) */\nexport const submitSparkJobAndWaitOptionsSchema = submitOptionsSchema.extend({\n  pollIntervalMs: z.number().int().positive().default(10000),\n  timeoutMs: z.number().int().positive().default(600000),\n});\n\nexport type SubmitSparkJobAndWaitOptions = z.input<\n  typeof submitSparkJobAndWaitOptionsSchema\n>;\n\n/** Spark job submit response */\nexport const sparkJobRunSchema = z.object({\n  runId: z.string(),\n});\n\nexport type SparkJobRun = z.infer<typeof sparkJobRunSchema>;\n\n/** Run status (for polling) */\nexport const runResponseSchema = z.object({\n  id: z.string(),\n  state: z.string().nullable(),\n  started_at: z.string().nullable().optional(),\n  queued_at: z.string().nullable().optional(),\n  scheduled_at: z.string().nullable().optional(),\n  ended_at: z.string().nullable().optional(),\n  duration: z.number().nullable().optional(),\n  error: z.unknown().nullable().optional(),\n  tags: z.array(\n    z.object({\n      key: z.string(),\n      value: z.string(),\n      source: z.string().nullable().optional(),\n    }),\n  ),\n  job: z.object({\n    id: z.string(),\n    name: z.string(),\n    namespace: z.string(),\n  }),\n  pipeline: z.object({\n    id: z.string(),\n    name: z.string(),\n    namespace: z.string(),\n  }),\n});\n\nexport type RunResponse = z.infer<typeof runResponseSchema>;\n\nexport type RunState = \"COMPLETE\" | \"FAIL\" | \"ABORT\" | string;\n","import {\n  optionsSchema,\n  queryOptionsSchema,\n  lakeQueryResultSchema,\n  sparkJobListPageSchema,\n  listSparkJobsOptionsSchema,\n  submitOptionsSchema,\n  submitSparkJobAndWaitOptionsSchema,\n  sparkJobRunSchema,\n  runResponseSchema,\n  apiErrorBodySchema,\n} from \"./schemas.js\";\nimport type {\n  OleanderOptions,\n  QueryOptions,\n  LakeQueryResult,\n  ListSparkJobsOptions,\n  ListSparkJobsResult,\n  SparkJobSubmitOptions,\n  SubmitSparkJobAndWaitOptions,\n  SparkJobRun,\n  RunResponse,\n  RunState,\n} from \"./schemas.js\";\n\nfunction getHeaders(apiKey: string): Record<string, string> {\n  return {\n    Authorization: `Bearer ${apiKey}`,\n    \"Content-Type\": \"application/json\",\n  };\n}\n\nfunction parseErrorBody(body: unknown, status: number): string {\n  const parsed = apiErrorBodySchema.safeParse(body);\n  if (parsed.success) {\n    const { error, details } = parsed.data;\n    return error || details || `HTTP ${status}`;\n  }\n  return `HTTP ${status}`;\n}\n\n/**\n * oleander API. Mirrors the CLI for query, list spark jobs, and launch spark jobs.\n */\nexport class Oleander {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n\n  constructor(options: OleanderOptions = {}) {\n    const parsed = optionsSchema.safeParse(options);\n    if (!parsed.success) {\n      const first =\n        parsed.error.flatten().formErrors[0] ?? parsed.error.message;\n      throw new Error(first);\n    }\n    const fromOptions = parsed.data.apiKey?.trim();\n    const fromEnv =\n      typeof process !== \"undefined\" && process.env?.OLEANDER_API_KEY;\n    const apiKey = fromOptions ?? fromEnv ?? \"\";\n    if (!apiKey) {\n      throw new Error(\n        \"Oleander requires a non-empty apiKey (or set OLEANDER_API_KEY)\",\n      );\n    }\n    this.apiKey = apiKey;\n    this.baseUrl = parsed.data.baseUrl.trim().replace(/\\/$/, \"\");\n  }\n\n  /**\n   * Execute a lake query (mirrors `oleander query`).\n   */\n  async query(\n    sql: string,\n    options: QueryOptions = {},\n  ): Promise<LakeQueryResult> {\n    const query = typeof sql === \"string\" ? sql.trim() : \"\";\n    if (!query) {\n      throw new Error(\"Query is required\");\n    }\n    const opts = queryOptionsSchema.parse(options);\n\n    const res = await fetch(`${this.baseUrl}/api/v1/warehouse/query`, {\n      method: \"POST\",\n      headers: getHeaders(this.apiKey),\n      body: JSON.stringify({\n        query,\n        autoSaveByHash: opts.save,\n      }),\n    });\n\n    const raw = await res.json().catch(() => ({}));\n    if (!res.ok) {\n      throw new Error(parseErrorBody(raw, res.status));\n    }\n\n    const result = lakeQueryResultSchema.parse(raw);\n    if (!result.success && result.error) {\n      throw new Error(result.details || result.error);\n    }\n    return result;\n  }\n\n  /**\n   * List spark jobs (mirrors `oleander spark jobs list`).\n   * Uses limit/offset pagination; pages through the API internally.\n   */\n  async listSparkJobs(\n    options: ListSparkJobsOptions = {},\n  ): Promise<ListSparkJobsResult> {\n    const opts = listSparkJobsOptionsSchema.parse(options);\n    const { limit, offset } = opts;\n\n    const allScripts: string[] = [];\n    let continuationToken: string | undefined;\n\n    while (true) {\n      const params = continuationToken\n        ? `?${new URLSearchParams({ continuationToken }).toString()}`\n        : \"\";\n      const res = await fetch(`${this.baseUrl}/api/v1/spark/scripts${params}`, {\n        method: \"GET\",\n        headers: { Authorization: `Bearer ${this.apiKey}` },\n      });\n      const raw = await res.json().catch(() => ({}));\n      if (!res.ok) {\n        throw new Error(parseErrorBody(raw, res.status));\n      }\n      const page = sparkJobListPageSchema.parse(raw);\n      allScripts.push(...page.scripts);\n      continuationToken = page.continuationToken;\n      if (!continuationToken || allScripts.length >= offset + limit) {\n        break;\n      }\n    }\n\n    const scripts = allScripts.slice(offset, offset + limit);\n    const hasMore = !!continuationToken || allScripts.length > offset + limit;\n    return { scripts, hasMore };\n  }\n\n  /**\n   * Submit a spark job (mirrors `oleander spark jobs submit`).\n   * Returns the run ID; use getRun() or submitSparkJobAndWait() to poll status.\n   */\n  async submitSparkJob(options: SparkJobSubmitOptions): Promise<SparkJobRun> {\n    const opts = submitOptionsSchema.parse(options);\n\n    const res = await fetch(`${this.baseUrl}/api/v1/spark/jobs`, {\n      method: \"POST\",\n      headers: getHeaders(this.apiKey),\n      body: JSON.stringify({\n        namespace: opts.namespace.trim(),\n        name: opts.name.trim(),\n        scriptName: opts.scriptName.trim(),\n        arguments: opts.args,\n        driverMachineType: opts.driverMachineType,\n        executorMachineType: opts.executorMachineType,\n        executorNumbers: opts.executorNumbers,\n        jobTags: opts.jobTags,\n        runTags: opts.runTags,\n      }),\n    });\n\n    const raw = await res.json().catch(() => ({}));\n    if (!res.ok) {\n      throw new Error(parseErrorBody(raw, res.status));\n    }\n    return sparkJobRunSchema.parse(raw);\n  }\n\n  /**\n   * Get run status (used for polling after submit).\n   */\n  async getRun(runId: string): Promise<RunResponse> {\n    if (!runId || typeof runId !== \"string\" || !runId.trim()) {\n      throw new Error(\"runId is required\");\n    }\n    const res = await fetch(`${this.baseUrl}/api/v2/runs/${runId}`, {\n      method: \"GET\",\n      headers: { Authorization: `Bearer ${this.apiKey}` },\n    });\n\n    const raw = await res.json().catch(() => ({}));\n    if (!res.ok) {\n      throw new Error(parseErrorBody(raw, res.status));\n    }\n    return runResponseSchema.parse(raw);\n  }\n\n  /**\n   * Submit a spark job and wait until the run reaches a terminal state (COMPLETE, FAIL, ABORT).\n   */\n  async submitSparkJobAndWait(\n    options: SubmitSparkJobAndWaitOptions,\n  ): Promise<{ runId: string; state: RunState; run: RunResponse }> {\n    const opts = submitSparkJobAndWaitOptionsSchema.parse(options);\n    const { pollIntervalMs, timeoutMs, ...submitOpts } = opts;\n    const { runId } = await this.submitSparkJob(submitOpts);\n    const started = Date.now();\n\n    while (Date.now() - started < timeoutMs) {\n      const run = await this.getRun(runId);\n      const state = run.state ?? \"\";\n      if (state === \"COMPLETE\" || state === \"FAIL\" || state === \"ABORT\") {\n        return { runId, state, run };\n      }\n      await new Promise((r) => setTimeout(r, pollIntervalMs));\n    }\n    const run = await this.getRun(runId);\n    throw new Error(\n      `Timeout waiting for run ${runId} (state: ${run.state ?? \"unknown\"})`,\n    );\n  }\n}\n"],"mappings":"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","names":["run"]}