@onyx.dev/onyx-database 1.2.0 → 2.0.1

package/dist/{aggregates-LoteczVS.d.ts → aggregates-BPpzRHGH.d.ts}

@@ -1,3 +1,6 @@
+var name = "@onyx.dev/onyx-database";
+var version = "2.0.1";
+
 /**
  * Supported operators for building query criteria.
  *
@@ -822,6 +825,10 @@ interface OnyxConfig {
     apiKey?: string;
     apiSecret?: string;
     fetch?: FetchImpl;
+    /**
+     * Default AI model when using shorthand chat calls (`db.chat('...')`). Defaults to `onyx`.
+     */
+    defaultModel?: string;
     /**
      * Default partition for queries, `findById`, and deletes when removing by
      * primary key. Saves rely on the entity's partition field instead.
@@ -934,6 +941,28 @@ interface AiChatCompletionChunk {
 interface AiChatCompletionStream extends AsyncIterable<AiChatCompletionChunk> {
     cancel(): void;
 }
+interface AiChatOptions extends AiRequestOptions {
+    /**
+     * Model to use for the shorthand `db.chat()` call. Defaults to config.defaultModel or `onyx`.
+     */
+    model?: string;
+    /**
+     * Role for the constructed message. Defaults to `user`.
+     */
+    role?: AiChatRole;
+    /**
+     * Temperature for the completion. Omit to use the service default.
+     */
+    temperature?: number | null;
+    /**
+     * Enable SSE streaming. Defaults to `false`.
+     */
+    stream?: boolean;
+    /**
+     * When true, return the raw completion response instead of the first message content.
+     */
+    raw?: boolean;
+}
 interface AiChatClient {
     create(request: AiChatCompletionRequest & {
         stream?: false;
@@ -968,9 +997,90 @@ interface AiErrorResponse {
         [key: string]: unknown;
     } | null;
 }
+interface AiClient {
+    /**
+     * Run a chat completion. Accepts shorthand strings or full requests.
+     *
+     * @example
+     * ```ts
+     * const quick = await db.ai.chat('Summarize last week.'); // returns first message content
+     * const completion = await db.ai.chat(
+     *   { model: 'onyx-chat', messages: [{ role: 'user', content: 'Summarize last week.' }] },
+     *   { databaseId: 'db1', raw: true }, // returns full response
+     * );
+     * ```
+     */
+    chat(content: string, options?: AiChatOptions & {
+        stream?: false;
+        raw?: false | undefined;
+    }): Promise<string>;
+    chat(content: string, options: AiChatOptions & {
+        stream: true;
+    }): Promise<AiChatCompletionStream>;
+    chat(content: string, options: AiChatOptions & {
+        raw: true;
+    }): Promise<AiChatCompletionResponse | AiChatCompletionStream>;
+    chat(request: AiChatCompletionRequest & {
+        stream?: false;
+    }, options?: AiRequestOptions): Promise<AiChatCompletionResponse>;
+    chat(request: AiChatCompletionRequest & {
+        stream: true;
+    }, options?: AiRequestOptions): Promise<AiChatCompletionStream>;
+    chat(request: AiChatCompletionRequest, options?: AiRequestOptions): Promise<AiChatCompletionResponse | AiChatCompletionStream>;
+    /**
+     * Access the chat client for more control over streaming and cancellation.
+     */
+    chatClient(): AiChatClient;
+    /**
+     * List available AI models.
+     *
+     * @example
+     * ```ts
+     * const models = await db.ai.getModels();
+     * ```
+     */
+    getModels(): Promise<AiModelsResponse>;
+    /**
+     * Retrieve a single AI model by ID.
+     *
+     * @example
+     * ```ts
+     * const model = await db.ai.getModel('onyx-chat');
+     * ```
+     */
+    getModel(modelId: string): Promise<AiModel>;
+    /**
+     * Request mutation approval for a script.
+     *
+     * @example
+     * ```ts
+     * const approval = await db.ai.requestScriptApproval({
+     *   script: "db.save({ id: 'u1', email: 'a@b.com' })"
+     * });
+     * ```
+     */
+    requestScriptApproval(input: AiScriptApprovalRequest): Promise<AiScriptApprovalResponse>;
+}
 interface IOnyxDatabase<Schema = Record<string, unknown>> {
     /**
-     * Access OpenAI-compatible chat completions.
+     * AI helpers (chat, models, script approvals) grouped under `db.ai`.
+     *
+     * @example
+     * ```ts
+     * const completion = await db.ai.chat({
+     *   model: 'onyx-chat',
+     *   messages: [{ role: 'user', content: 'Summarize last week.' }],
+     * });
+     * ```
+     */
+    ai: AiClient;
+    /**
+     * Access OpenAI-compatible chat completions via `db.chat('...')` or `db.chat().create(...)`.
+     *
+     * @example
+     * ```ts
+     * const completion = await db.chat('Summarize last week.'); // returns first message content
+     * ```
      *
      * @example
      * ```ts
@@ -995,10 +1105,22 @@ interface IOnyxDatabase<Schema = Record<string, unknown>> {
      * }
      * ```
      */
+    chat(content: string, options?: AiChatOptions & {
+        stream?: false;
+        raw?: false | undefined;
+    }): Promise<string>;
+    chat(content: string, options: AiChatOptions & {
+        stream: true;
+    }): Promise<AiChatCompletionStream>;
+    chat(content: string, options: AiChatOptions & {
+        raw: true;
+    }): Promise<AiChatCompletionResponse | AiChatCompletionStream>;
     chat(): AiChatClient;
     /**
      * List available AI models.
      *
+     * @deprecated Prefer `db.ai.getModels()`.
+     *
      * @example
      * ```ts
      * const models = await db.getModels();
@@ -1008,6 +1130,8 @@ interface IOnyxDatabase<Schema = Record<string, unknown>> {
     /**
      * Retrieve a single AI model by ID.
      *
+     * @deprecated Prefer `db.ai.getModel(...)`.
+     *
      * @example
      * ```ts
      * const model = await db.getModel('onyx-chat');
@@ -1017,6 +1141,8 @@ interface IOnyxDatabase<Schema = Record<string, unknown>> {
     /**
      * Request mutation approval for a script.
      *
+     * @deprecated Prefer `db.ai.requestScriptApproval(...)`.
+     *
      * @example
      * ```ts
      * const approval = await db.requestScriptApproval({
@@ -1632,6 +1758,7 @@ declare const upper: (attribute: string) => string;
 declare const lower: (attribute: string) => string;
 declare const substring: (attribute: string, from: number, length: number) => string;
 declare const replace: (attribute: string, pattern: string, repl: string) => string;
+declare const format: (attribute: string, formatter: string) => string;
 declare const percentile: (attribute: string, p: number) => string;
 
-export { type SchemaDiff as $, type AiRequestOptions as A, type SchemaDataType as B, type SchemaIdentifierGenerator as C, type SchemaIdentifier as D, type SchemaAttribute as E, type FullTextQuery as F, type SchemaIndexType as G, type SchemaIndex as H, type IOnyxDatabase as I, type SchemaResolver as J, type SchemaTriggerEvent as K, type SchemaTrigger as L, type SchemaEntity as M, type SchemaRevisionMetadata as N, type OnyxFacade as O, type SchemaRevision as P, QueryResults as Q, type RetryOptions as R, type SecretMetadata as S, type SchemaHistoryEntry as T, type SchemaUpsertRequest as U, type SchemaValidationResult as V, type SchemaAttributeChange as W, type SchemaIndexChange as X, type SchemaResolverChange as Y, type SchemaTriggerChange as Z, type SchemaTableDiff as _, type QueryResultsPromise as a, type QueryCriteriaOperator as a0, type LogicalOperator as a1, type Sort as a2, type StreamAction as a3, type OnyxDocument as a4, type FetchResponse as a5, type FetchImpl as a6, type QueryCriteria as a7, type QueryCondition as a8, type SelectQuery as a9, containsIgnoreCase as aA, notContains as aB, notContainsIgnoreCase as aC, startsWith as aD, notStartsWith as aE, isNull as aF, notNull as aG, avg as aH, sum as aI, count as aJ, min as aK, max as aL, std as aM, variance as aN, median as aO, upper as aP, lower as aQ, substring as aR, replace as aS, percentile as aT, type UpdateQuery as aa, type QueryPage as ab, type IConditionBuilder as ac, type IQueryBuilder as ad, type ISaveBuilder as ae, type ICascadeBuilder as af, type ICascadeRelationshipBuilder as ag, asc as ah, desc as ai, eq as aj, neq as ak, inOp as al, within as am, notIn as an, notWithin as ao, between as ap, gt as aq, gte as ar, lt as as, lte as at, matches as au, search as av, notMatches as aw, like as ax, notLike as ay, contains as az, type OnyxConfig as b, type AiChatRole as c, type AiToolCallFunction as d, type AiToolCall as e, type AiChatMessage as f, type AiToolFunction as g, type AiTool as h, type AiToolChoice as i, type AiChatCompletionRequest as j, type AiChatCompletionUsage as k, type AiChatCompletionChoice as l, type AiChatCompletionResponse as m, type AiChatCompletionChunkDelta as n, type AiChatCompletionChunkChoice as o, type AiChatCompletionChunk as p, type AiChatCompletionStream as q, type AiChatClient as r, type AiScriptApprovalRequest as s, type AiScriptApprovalResponse as t, type AiModelsResponse as u, type AiModel as v, type AiErrorResponse as w, type SecretRecord as x, type SecretsListResponse as y, type SecretSaveRequest as z };
+export { type SchemaIndexChange as $, type AiRequestOptions as A, type AiClient as B, type SecretRecord as C, type SecretsListResponse as D, type SecretSaveRequest as E, type FullTextQuery as F, type SchemaDataType as G, type SchemaIdentifierGenerator as H, type IOnyxDatabase as I, type SchemaIdentifier as J, type SchemaAttribute as K, type SchemaIndexType as L, type SchemaIndex as M, type SchemaResolver as N, type OnyxFacade as O, type SchemaTriggerEvent as P, QueryResults as Q, type RetryOptions as R, type SecretMetadata as S, type SchemaTrigger as T, type SchemaEntity as U, type SchemaRevisionMetadata as V, type SchemaRevision as W, type SchemaHistoryEntry as X, type SchemaUpsertRequest as Y, type SchemaValidationResult as Z, type SchemaAttributeChange as _, type QueryResultsPromise as a, type SchemaResolverChange as a0, type SchemaTriggerChange as a1, type SchemaTableDiff as a2, type SchemaDiff as a3, type QueryCriteriaOperator as a4, type LogicalOperator as a5, type Sort as a6, type StreamAction as a7, type OnyxDocument as a8, type FetchResponse as a9, notMatches as aA, like as aB, notLike as aC, contains as aD, containsIgnoreCase as aE, notContains as aF, notContainsIgnoreCase as aG, startsWith as aH, notStartsWith as aI, isNull as aJ, notNull as aK, avg as aL, sum as aM, count as aN, min as aO, max as aP, std as aQ, variance as aR, median as aS, upper as aT, lower as aU, substring as aV, replace as aW, format as aX, percentile as aY, type FetchImpl as aa, type QueryCriteria as ab, type QueryCondition as ac, type SelectQuery as ad, type UpdateQuery as ae, type QueryPage as af, type IConditionBuilder as ag, type IQueryBuilder as ah, type ISaveBuilder as ai, type ICascadeBuilder as aj, type ICascadeRelationshipBuilder as ak, asc as al, desc as am, eq as an, neq as ao, inOp as ap, within as aq, notIn as ar, notWithin as as, between as at, gt as au, gte as av, lt as aw, lte as ax, matches as ay, search as az, type OnyxConfig as b, type AiChatRole as c, type AiToolCallFunction as d, type AiToolCall as e, type AiChatMessage as f, type AiToolFunction as g, type AiTool as h, type AiToolChoice as i, type AiChatCompletionRequest as j, type AiChatCompletionUsage as k, type AiChatCompletionChoice as l, type AiChatCompletionResponse as m, name as n, type AiChatCompletionChunkDelta as o, type AiChatCompletionChunkChoice as p, type AiChatCompletionChunk as q, type AiChatCompletionStream as r, type AiChatOptions as s, type AiChatClient as t, type AiScriptApprovalRequest as u, version as v, type AiScriptApprovalResponse as w, type AiModelsResponse as x, type AiModel as y, type AiErrorResponse as z };

package/dist/edge.cjs

@@ -1,8 +1,13 @@
 'use strict';
 
+// package.json
+var name = "@onyx.dev/onyx-database";
+var version = "2.0.1";
+
 // src/config/defaults.ts
 var DEFAULT_BASE_URL = "https://api.onyx.dev";
 var DEFAULT_AI_BASE_URL = "https://ai.onyx.dev";
+var DEFAULT_AI_MODEL = "onyx";
 var sanitizeBaseUrl = (u) => u.replace(/\/+$/, "");
 
 // src/errors/config-error.ts
@@ -55,6 +60,7 @@ function readEnv(targetId) {
   const res = dropUndefined({
     baseUrl: pick("ONYX_DATABASE_BASE_URL"),
     aiBaseUrl: pick("ONYX_AI_BASE_URL"),
+    defaultModel: pick("ONYX_DEFAULT_MODEL"),
     databaseId: envId,
     apiKey: pick("ONYX_DATABASE_API_KEY"),
     apiSecret: pick("ONYX_DATABASE_API_SECRET")
@@ -74,12 +80,14 @@ async function resolveConfig(input) {
   const merged = {
     baseUrl: DEFAULT_BASE_URL,
     aiBaseUrl: DEFAULT_AI_BASE_URL,
+    defaultModel: DEFAULT_AI_MODEL,
     ...dropUndefined(env),
     ...dropUndefined(input)
   };
   dbg("merged (pre-validate):", mask(merged));
   const baseUrl = sanitizeBaseUrl(merged.baseUrl ?? DEFAULT_BASE_URL);
   const aiBaseUrl = sanitizeBaseUrl(merged.aiBaseUrl ?? DEFAULT_AI_BASE_URL);
+  const defaultModel = typeof merged.defaultModel === "string" && merged.defaultModel.trim() ? merged.defaultModel.trim() : DEFAULT_AI_MODEL;
   const databaseId = merged.databaseId ?? "";
   const apiKey = merged.apiKey ?? "";
   const apiSecret = merged.apiSecret ?? "";
@@ -105,6 +113,7 @@ async function resolveConfig(input) {
   const resolved = {
     baseUrl,
     aiBaseUrl,
+    defaultModel,
     databaseId,
     apiKey,
     apiSecret,
@@ -798,8 +807,8 @@ var CascadeRelationshipBuilder = class {
    * builder.graph('programs');
    * ```
    */
-  graph(name) {
-    this.graphName = name;
+  graph(name2) {
+    this.graphName = name2;
     return this;
   }
   /**
@@ -886,24 +895,24 @@ function diffAttributes(apiAttrs, localAttrs) {
   const added = [];
   const removed = [];
   const changed = [];
-  for (const [name, local] of localMap.entries()) {
-    if (!apiMap.has(name)) {
+  for (const [name2, local] of localMap.entries()) {
+    if (!apiMap.has(name2)) {
       added.push(local);
       continue;
     }
-    const api = apiMap.get(name);
+    const api = apiMap.get(name2);
     const apiNull = Boolean(api.isNullable);
     const localNull = Boolean(local.isNullable);
     if (api.type !== local.type || apiNull !== localNull) {
       changed.push({
-        name,
+        name: name2,
         from: { type: api.type, isNullable: apiNull },
         to: { type: local.type, isNullable: localNull }
       });
     }
   }
-  for (const name of apiMap.keys()) {
-    if (!localMap.has(name)) removed.push(name);
+  for (const name2 of apiMap.keys()) {
+    if (!localMap.has(name2)) removed.push(name2);
   }
   added.sort((a, b) => a.name.localeCompare(b.name));
   removed.sort();
@@ -917,22 +926,22 @@ function diffIndexes(apiIndexes, localIndexes) {
   const added = [];
   const removed = [];
   const changed = [];
-  for (const [name, local] of localMap.entries()) {
-    if (!apiMap.has(name)) {
+  for (const [name2, local] of localMap.entries()) {
+    if (!apiMap.has(name2)) {
       added.push(local);
       continue;
     }
-    const api = apiMap.get(name);
+    const api = apiMap.get(name2);
     const apiType = api.type ?? "DEFAULT";
     const localType = local.type ?? "DEFAULT";
     const apiScore = api.minimumScore;
     const localScore = local.minimumScore;
     if (apiType !== localType || apiScore !== localScore) {
-      changed.push({ name, from: api, to: local });
+      changed.push({ name: name2, from: api, to: local });
     }
   }
-  for (const name of apiMap.keys()) {
-    if (!localMap.has(name)) removed.push(name);
+  for (const name2 of apiMap.keys()) {
+    if (!localMap.has(name2)) removed.push(name2);
   }
   added.sort((a, b) => a.name.localeCompare(b.name));
   removed.sort();
@@ -946,18 +955,18 @@ function diffResolvers(apiResolvers, localResolvers) {
   const added = [];
   const removed = [];
   const changed = [];
-  for (const [name, local] of localMap.entries()) {
-    if (!apiMap.has(name)) {
+  for (const [name2, local] of localMap.entries()) {
+    if (!apiMap.has(name2)) {
       added.push(local);
       continue;
     }
-    const api = apiMap.get(name);
+    const api = apiMap.get(name2);
     if (api.resolver !== local.resolver) {
-      changed.push({ name, from: api, to: local });
+      changed.push({ name: name2, from: api, to: local });
     }
   }
-  for (const name of apiMap.keys()) {
-    if (!localMap.has(name)) removed.push(name);
+  for (const name2 of apiMap.keys()) {
+    if (!localMap.has(name2)) removed.push(name2);
   }
   added.sort((a, b) => a.name.localeCompare(b.name));
   removed.sort();
@@ -971,18 +980,18 @@ function diffTriggers(apiTriggers, localTriggers) {
   const added = [];
   const removed = [];
   const changed = [];
-  for (const [name, local] of localMap.entries()) {
-    if (!apiMap.has(name)) {
+  for (const [name2, local] of localMap.entries()) {
+    if (!apiMap.has(name2)) {
       added.push(local);
       continue;
     }
-    const api = apiMap.get(name);
+    const api = apiMap.get(name2);
     if (api.event !== local.event || api.trigger !== local.trigger) {
-      changed.push({ name, from: api, to: local });
+      changed.push({ name: name2, from: api, to: local });
     }
   }
-  for (const name of apiMap.keys()) {
-    if (!localMap.has(name)) removed.push(name);
+  for (const name2 of apiMap.keys()) {
+    if (!localMap.has(name2)) removed.push(name2);
   }
   added.sort((a, b) => a.name.localeCompare(b.name));
   removed.sort();
@@ -998,13 +1007,13 @@ function computeSchemaDiff(apiSchema, localSchema) {
   const newTables = [];
   const removedTables = [];
   const changedTables = [];
-  for (const [name, localEntity] of localMap.entries()) {
-    if (!apiMap.has(name)) {
-      newTables.push(name);
+  for (const [name2, localEntity] of localMap.entries()) {
+    if (!apiMap.has(name2)) {
+      newTables.push(name2);
       continue;
     }
-    const apiEntity = apiMap.get(name);
-    const tableDiff = { name };
+    const apiEntity = apiMap.get(name2);
+    const tableDiff = { name: name2 };
     const partitionFrom = normalizePartition(apiEntity.partition);
     const partitionTo = normalizePartition(localEntity.partition);
     if (partitionFrom !== partitionTo) {
@@ -1029,8 +1038,8 @@ function computeSchemaDiff(apiSchema, localSchema) {
       changedTables.push(tableDiff);
     }
   }
-  for (const name of apiMap.keys()) {
-    if (!localMap.has(name)) removedTables.push(name);
+  for (const name2 of apiMap.keys()) {
+    if (!localMap.has(name2)) removedTables.push(name2);
   }
   newTables.sort();
   removedTables.sort();
@@ -1130,58 +1139,64 @@ var OnyxDatabaseImpl = class {
   requestLoggingEnabled;
   responseLoggingEnabled;
   defaultPartition;
+  ai;
   constructor(config, resolveConfigWithCache) {
     this.requestLoggingEnabled = !!config?.requestLoggingEnabled;
     this.responseLoggingEnabled = !!config?.responseLoggingEnabled;
     this.defaultPartition = config?.partition;
     this.cfgPromise = resolveConfigWithCache(config);
+    this.ai = this.createAiFacade();
   }
-  async ensureClient() {
+  async resolveConfig() {
     if (!this.resolved) {
       this.resolved = await this.cfgPromise;
     }
+    return this.resolved;
+  }
+  async ensureClient() {
+    const cfg = await this.resolveConfig();
     if (!this.http) {
       this.http = new HttpClient({
-        baseUrl: this.resolved.baseUrl,
-        apiKey: this.resolved.apiKey,
-        apiSecret: this.resolved.apiSecret,
-        fetchImpl: this.resolved.fetch,
+        baseUrl: cfg.baseUrl,
+        apiKey: cfg.apiKey,
+        apiSecret: cfg.apiSecret,
+        fetchImpl: cfg.fetch,
         requestLoggingEnabled: this.requestLoggingEnabled,
         responseLoggingEnabled: this.responseLoggingEnabled,
-        retryEnabled: this.resolved.retryEnabled,
-        maxRetries: this.resolved.maxRetries,
-        retryInitialDelayMs: this.resolved.retryInitialDelayMs
+        retryEnabled: cfg.retryEnabled,
+        maxRetries: cfg.maxRetries,
+        retryInitialDelayMs: cfg.retryInitialDelayMs
       });
     }
     return {
       http: this.http,
-      fetchImpl: this.resolved.fetch,
-      baseUrl: this.resolved.baseUrl,
-      databaseId: this.resolved.databaseId
+      fetchImpl: cfg.fetch,
+      baseUrl: cfg.baseUrl,
+      databaseId: cfg.databaseId,
+      defaultModel: cfg.defaultModel ?? DEFAULT_AI_MODEL
     };
   }
   async ensureAiClient() {
-    if (!this.resolved) {
-      this.resolved = await this.cfgPromise;
-    }
+    const cfg = await this.resolveConfig();
     if (!this.aiHttp) {
       this.aiHttp = new HttpClient({
-        baseUrl: this.resolved.aiBaseUrl,
-        apiKey: this.resolved.apiKey,
-        apiSecret: this.resolved.apiSecret,
-        fetchImpl: this.resolved.fetch,
+        baseUrl: cfg.aiBaseUrl,
+        apiKey: cfg.apiKey,
+        apiSecret: cfg.apiSecret,
+        fetchImpl: cfg.fetch,
         requestLoggingEnabled: this.requestLoggingEnabled,
         responseLoggingEnabled: this.responseLoggingEnabled,
-        retryEnabled: this.resolved.retryEnabled,
-        maxRetries: this.resolved.maxRetries,
-        retryInitialDelayMs: this.resolved.retryInitialDelayMs
+        retryEnabled: cfg.retryEnabled,
+        maxRetries: cfg.maxRetries,
+        retryInitialDelayMs: cfg.retryInitialDelayMs
       });
     }
     return {
       http: this.aiHttp,
-      fetchImpl: this.resolved.fetch,
-      aiBaseUrl: this.resolved.aiBaseUrl,
-      databaseId: this.resolved.databaseId
+      fetchImpl: cfg.fetch,
+      aiBaseUrl: cfg.aiBaseUrl,
+      databaseId: cfg.databaseId,
+      defaultModel: cfg.defaultModel ?? DEFAULT_AI_MODEL
     };
   }
   registerStream(handle) {
@@ -1196,6 +1211,21 @@ var OnyxDatabaseImpl = class {
       }
     };
   }
+  createAiFacade() {
+    const chat = ((contentOrRequest, options) => {
+      if (typeof contentOrRequest === "string") {
+        return this.chatWithContent(contentOrRequest, options);
+      }
+      return this.getAiChatClient().create(contentOrRequest, options);
+    });
+    return {
+      chat,
+      chatClient: () => this.getAiChatClient(),
+      getModels: () => this.getModels(),
+      getModel: (modelId) => this.getModel(modelId),
+      requestScriptApproval: (input) => this.requestScriptApproval(input)
+    };
+  }
   getRequestLoggingEnabled() {
     return this.requestLoggingEnabled;
   }
@@ -1203,7 +1233,7 @@ var OnyxDatabaseImpl = class {
     return this.responseLoggingEnabled;
   }
   /** -------- IOnyxDatabase -------- */
-  chat() {
+  getAiChatClient() {
     return new AiChatClientImpl(
       () => this.ensureAiClient(),
       (handle) => this.registerStream(handle),
@@ -1211,6 +1241,32 @@ var OnyxDatabaseImpl = class {
       () => this.responseLoggingEnabled
     );
   }
+  async chatWithContent(content, options) {
+    const { defaultModel } = await this.ensureAiClient();
+    const stream = options?.stream ?? false;
+    const request = {
+      model: options?.model ?? defaultModel,
+      messages: [{ role: options?.role ?? "user", content }],
+      stream
+    };
+    if (options && "temperature" in options) {
+      request.temperature = options.temperature ?? null;
+    }
+    const result = await this.getAiChatClient().create(request, options);
+    if (stream) return result;
+    if (options?.raw) return result;
+    const first = result.choices?.[0]?.message?.content;
+    if (typeof first === "string" && first.trim().length > 0) {
+      return first;
+    }
+    throw new Error("Chat completion response is missing message content");
+  }
+  chat(content, options) {
+    if (typeof content === "string") {
+      return this.chatWithContent(content, options);
+    }
+    return this.getAiChatClient();
+  }
   async getModels() {
     const { http } = await this.ensureAiClient();
     return http.request("GET", "/v1/models");
@@ -2127,12 +2183,9 @@ var upper = (attribute) => `upper(${attribute})`;
 var lower = (attribute) => `lower(${attribute})`;
 var substring = (attribute, from, length) => `substring(${attribute},${from},${length})`;
 var replace = (attribute, pattern, repl) => `replace(${attribute}, '${pattern.replace(/'/g, "\\'")}', '${repl.replace(/'/g, "\\'")}')`;
+var format = (attribute, formatter) => `format(${attribute}, '${formatter.replace(/'/g, "\\'")}')`;
 var percentile = (attribute, p) => `percentile(${attribute}, ${p})`;
 
-// src/edge.ts
-var sdkName = "@onyx.dev/onyx-database";
-var sdkVersion = "0.1.0";
-
 exports.QueryResults = QueryResults;
 exports.asc = asc;
 exports.avg = avg;
@@ -2142,6 +2195,7 @@ exports.containsIgnoreCase = containsIgnoreCase;
 exports.count = count;
 exports.desc = desc;
 exports.eq = eq;
+exports.format = format;
 exports.gt = gt;
 exports.gte = gte;
 exports.inOp = inOp;
@@ -2166,8 +2220,8 @@ exports.notWithin = notWithin;
 exports.onyx = onyx;
 exports.percentile = percentile;
 exports.replace = replace;
-exports.sdkName = sdkName;
-exports.sdkVersion = sdkVersion;
+exports.sdkName = name;
+exports.sdkVersion = version;
 exports.search = search;
 exports.startsWith = startsWith;
 exports.std = std;