@athenaintel/sdk 4.3.310 → 4.3.312

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@athenaintel/sdk",
-        "X-Fern-SDK-Version": "4.3.310",
-        "User-Agent": "@athenaintel/sdk/4.3.310",
+        "X-Fern-SDK-Version": "4.3.312",
+        "User-Agent": "@athenaintel/sdk/4.3.312",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/api/resources/databases/client/Client.d.ts

@@ -167,4 +167,28 @@ export declare class DatabasesClient {
      */
     getTableSchema(asset_id: string, table_name: string, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.DatabaseTableSchemaResponse>;
     private __getTableSchema;
+    /**
+     * Check if a database is running, suspended, or starting up. Poll this endpoint to determine when a serverless database is ready.
+     *
+     * **Status Values:**
+     * - `running` - Database is active and accepting connections
+     * - `suspended` - Database is suspended (scale-to-zero), will auto-resume on first query
+     * - `starting` - Database is waking up
+     * - `failed` - Database failed to start
+     * - `unknown` - Status could not be determined
+     *
+     * @param {string} asset_id
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.NotImplementedError}
+     *
+     * @example
+     *     await client.databases.getStatus("asset_id")
+     */
+    getStatus(asset_id: string, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.DatabaseStatusResponse>;
+    private __getStatus;
 }

package/dist/cjs/api/resources/databases/client/Client.js

@@ -656,5 +656,94 @@ class DatabasesClient {
             }
         });
     }
+    /**
+     * Check if a database is running, suspended, or starting up. Poll this endpoint to determine when a serverless database is ready.
+     *
+     * **Status Values:**
+     * - `running` - Database is active and accepting connections
+     * - `suspended` - Database is suspended (scale-to-zero), will auto-resume on first query
+     * - `starting` - Database is waking up
+     * - `failed` - Database failed to start
+     * - `unknown` - Status could not be determined
+     *
+     * @param {string} asset_id
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.NotImplementedError}
+     *
+     * @example
+     *     await client.databases.getStatus("asset_id")
+     */
+    getStatus(asset_id, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getStatus(asset_id, requestOptions));
+    }
+    __getStatus(asset_id, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, `api/v0/databases/${core.url.encodePathParam(asset_id)}/status`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new AthenaIntelligence.NotImplementedError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AthenaIntelligenceError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling GET /api/v0/databases/{asset_id}/status.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
 }
 exports.DatabasesClient = DatabasesClient;

package/dist/cjs/api/types/DatabaseStatusResponse.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Response for database status check.
+ *
+ * Used to determine if a serverless database is running or suspended
+ * (scale-to-zero). Poll this endpoint to know when a database is ready.
+ */
+export interface DatabaseStatusResponse {
+    /** The database asset ID */
+    asset_id: string;
+    /** Optional status message or error details */
+    message?: string;
+    /** Database provider ('neon_cloud' or 'kronos') */
+    provider: string;
+    /** Standardized database status */
+    status: DatabaseStatusResponse.Status;
+}
+export declare namespace DatabaseStatusResponse {
+    const Status: {
+        readonly Scheduled: "scheduled";
+        readonly Running: "running";
+        readonly Completed: "completed";
+        readonly Failed: "failed";
+        readonly Queued: "queued";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+}

package/dist/cjs/api/types/DatabaseStatusResponse.js

@@ -0,0 +1,14 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseStatusResponse = void 0;
+var DatabaseStatusResponse;
+(function (DatabaseStatusResponse) {
+    DatabaseStatusResponse.Status = {
+        Scheduled: "scheduled",
+        Running: "running",
+        Completed: "completed",
+        Failed: "failed",
+        Queued: "queued",
+    };
+})(DatabaseStatusResponse || (exports.DatabaseStatusResponse = DatabaseStatusResponse = {}));

package/dist/cjs/api/types/index.d.ts

@@ -22,6 +22,7 @@ export * from "./CustomAgentResponse.js";
 export * from "./DatabaseColumnInfo.js";
 export * from "./DatabaseDataResponse.js";
 export * from "./DatabaseMutationResponse.js";
+export * from "./DatabaseStatusResponse.js";
 export * from "./DatabaseTableInfo.js";
 export * from "./DatabaseTableSchemaResponse.js";
 export * from "./DatabaseTablesResponse.js";

package/dist/cjs/api/types/index.js

@@ -38,6 +38,7 @@ __exportStar(require("./CustomAgentResponse.js"), exports);
 __exportStar(require("./DatabaseColumnInfo.js"), exports);
 __exportStar(require("./DatabaseDataResponse.js"), exports);
 __exportStar(require("./DatabaseMutationResponse.js"), exports);
+__exportStar(require("./DatabaseStatusResponse.js"), exports);
 __exportStar(require("./DatabaseTableInfo.js"), exports);
 __exportStar(require("./DatabaseTableSchemaResponse.js"), exports);
 __exportStar(require("./DatabaseTablesResponse.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.310";
+export declare const SDK_VERSION = "4.3.312";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "4.3.310";
+exports.SDK_VERSION = "4.3.312";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@athenaintel/sdk",
-        "X-Fern-SDK-Version": "4.3.310",
-        "User-Agent": "@athenaintel/sdk/4.3.310",
+        "X-Fern-SDK-Version": "4.3.312",
+        "User-Agent": "@athenaintel/sdk/4.3.312",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/api/resources/databases/client/Client.d.mts

@@ -167,4 +167,28 @@ export declare class DatabasesClient {
      */
     getTableSchema(asset_id: string, table_name: string, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.DatabaseTableSchemaResponse>;
     private __getTableSchema;
+    /**
+     * Check if a database is running, suspended, or starting up. Poll this endpoint to determine when a serverless database is ready.
+     *
+     * **Status Values:**
+     * - `running` - Database is active and accepting connections
+     * - `suspended` - Database is suspended (scale-to-zero), will auto-resume on first query
+     * - `starting` - Database is waking up
+     * - `failed` - Database failed to start
+     * - `unknown` - Status could not be determined
+     *
+     * @param {string} asset_id
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.NotImplementedError}
+     *
+     * @example
+     *     await client.databases.getStatus("asset_id")
+     */
+    getStatus(asset_id: string, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.DatabaseStatusResponse>;
+    private __getStatus;
 }

package/dist/esm/api/resources/databases/client/Client.mjs

@@ -620,4 +620,93 @@ export class DatabasesClient {
             }
         });
     }
+    /**
+     * Check if a database is running, suspended, or starting up. Poll this endpoint to determine when a serverless database is ready.
+     *
+     * **Status Values:**
+     * - `running` - Database is active and accepting connections
+     * - `suspended` - Database is suspended (scale-to-zero), will auto-resume on first query
+     * - `starting` - Database is waking up
+     * - `failed` - Database failed to start
+     * - `unknown` - Status could not be determined
+     *
+     * @param {string} asset_id
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.NotImplementedError}
+     *
+     * @example
+     *     await client.databases.getStatus("asset_id")
+     */
+    getStatus(asset_id, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getStatus(asset_id, requestOptions));
+    }
+    __getStatus(asset_id, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, `api/v0/databases/${core.url.encodePathParam(asset_id)}/status`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new AthenaIntelligence.NotImplementedError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AthenaIntelligenceError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling GET /api/v0/databases/{asset_id}/status.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
 }

package/dist/esm/api/types/DatabaseStatusResponse.d.mts

@@ -0,0 +1,26 @@
+/**
+ * Response for database status check.
+ *
+ * Used to determine if a serverless database is running or suspended
+ * (scale-to-zero). Poll this endpoint to know when a database is ready.
+ */
+export interface DatabaseStatusResponse {
+    /** The database asset ID */
+    asset_id: string;
+    /** Optional status message or error details */
+    message?: string;
+    /** Database provider ('neon_cloud' or 'kronos') */
+    provider: string;
+    /** Standardized database status */
+    status: DatabaseStatusResponse.Status;
+}
+export declare namespace DatabaseStatusResponse {
+    const Status: {
+        readonly Scheduled: "scheduled";
+        readonly Running: "running";
+        readonly Completed: "completed";
+        readonly Failed: "failed";
+        readonly Queued: "queued";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+}

package/dist/esm/api/types/DatabaseStatusResponse.mjs

@@ -0,0 +1,11 @@
+// This file was auto-generated by Fern from our API Definition.
+export var DatabaseStatusResponse;
+(function (DatabaseStatusResponse) {
+    DatabaseStatusResponse.Status = {
+        Scheduled: "scheduled",
+        Running: "running",
+        Completed: "completed",
+        Failed: "failed",
+        Queued: "queued",
+    };
+})(DatabaseStatusResponse || (DatabaseStatusResponse = {}));

package/dist/esm/api/types/index.d.mts

@@ -22,6 +22,7 @@ export * from "./CustomAgentResponse.mjs";
 export * from "./DatabaseColumnInfo.mjs";
 export * from "./DatabaseDataResponse.mjs";
 export * from "./DatabaseMutationResponse.mjs";
+export * from "./DatabaseStatusResponse.mjs";
 export * from "./DatabaseTableInfo.mjs";
 export * from "./DatabaseTableSchemaResponse.mjs";
 export * from "./DatabaseTablesResponse.mjs";

package/dist/esm/api/types/index.mjs

@@ -22,6 +22,7 @@ export * from "./CustomAgentResponse.mjs";
 export * from "./DatabaseColumnInfo.mjs";
 export * from "./DatabaseDataResponse.mjs";
 export * from "./DatabaseMutationResponse.mjs";
+export * from "./DatabaseStatusResponse.mjs";
 export * from "./DatabaseTableInfo.mjs";
 export * from "./DatabaseTableSchemaResponse.mjs";
 export * from "./DatabaseTablesResponse.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.310";
+export declare const SDK_VERSION = "4.3.312";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "4.3.310";
+export const SDK_VERSION = "4.3.312";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@athenaintel/sdk",
-    "version": "4.3.310",
+    "version": "4.3.312",
     "private": false,
     "repository": "github:Athena-Intel/athena-typescript",
     "type": "commonjs",

package/reference.md

@@ -984,6 +984,76 @@ await client.databases.getTableSchema("asset_id", "table_name");
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.databases.<a href="/src/api/resources/databases/client/Client.ts">getStatus</a>(asset_id) -> AthenaIntelligence.DatabaseStatusResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Check if a database is running, suspended, or starting up. Poll this endpoint to determine when a serverless database is ready.
+
+**Status Values:**
+- `running` - Database is active and accepting connections
+- `suspended` - Database is suspended (scale-to-zero), will auto-resume on first query
+- `starting` - Database is waking up
+- `failed` - Database failed to start
+- `unknown` - Status could not be determined
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.databases.getStatus("asset_id");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**asset_id:** `string` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DatabasesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>