@onyx.dev/onyx-database 2.0.0 → 2.1.0

package/README.md

@@ -63,20 +63,16 @@ npm i @onyx.dev/onyx-database
 
 The package is dual-module (ESM + CJS) and has **no runtime or peer dependencies**.
 
-To use the bundled CLIs (`onyx-gen` and `onyx-schema`) globally:
+CLI tooling and schema codegen now live in the dedicated **Onyx CLI** repo:
+<https://github.com/OnyxDevTools/onyx-cli>. Install it via the official install
+script or Homebrew (macOS):
 
 ```bash
-npm install -g @onyx.dev/onyx-database
-```
-
-To install the CLI globally from this repo checkout (useful for local development and testing):
+curl -fsSL https://raw.githubusercontent.com/OnyxDevTools/onyx-cli/main/scripts/install.sh | bash
 
-```bash
-# run from the repo root
-npm install
-npm run build
-npm uninstall -g @onyx.dev/onyx-database # optional: clear older global versions
-npm install -g .                         # installs the built onyx-schema and onyx-gen
+# macOS (Homebrew)
+brew tap OnyxDevTools/onyx-cli
+brew install onyx-cli
 ```
 
 ---
@@ -85,16 +81,25 @@ npm install -g .                         # installs the built onyx-schema and on
 
 This SDK resolves credentials automatically using the chain **explicit config ➜ environment variables ➜ `ONYX_CONFIG_PATH` file ➜ project config file ➜ home profile** _(Node.js only for file-based sources)_. Call `onyx.init({ databaseId: 'database-id' })` to target a specific database, or omit the `databaseId` to use the default. You can also pass credentials directly via config.
 
+**Reliability defaults (read this):**
+- **Retries:** GET/query calls auto-retry up to 3 times with Fibonacci backoff starting at 300ms (honors `Retry-After`); writes never retry.
+- **Config cache:** Resolved config is cached per `${databaseId}-${apiKey}` for 5 minutes; tune with `ttl`, clear via `onyx.clearCacheConfig()`.
+
 ### Option A) Environment variables (recommended for production)
 
-Set the following environment variables for your database:
+Set these environment variables for your database:
 
-- `ONYX_DATABASE_ID`
-- `ONYX_DATABASE_BASE_URL`
-- `ONYX_DATABASE_API_KEY`
-- `ONYX_DATABASE_API_SECRET`
-- `ONYX_AI_BASE_URL` (optional; defaults to `https://ai.onyx.dev`)
-- `ONYX_DEFAULT_MODEL` (optional; used by `db.chat('...')`, defaults to `onyx`)
+| Variable | Purpose | Default when unset |
+| --- | --- | --- |
+| `ONYX_DATABASE_ID` | Target database ID | required |
+| `ONYX_DATABASE_BASE_URL` | Base URL for DB API | `https://api.onyx.dev` |
+| `ONYX_DATABASE_API_KEY` | API key | required |
+| `ONYX_DATABASE_API_SECRET` | API secret | required |
+| `ONYX_AI_BASE_URL` | Base URL for AI endpoints | `https://ai.onyx.dev` |
+| `ONYX_DEFAULT_MODEL` | Model used by `db.chat()` shorthand | `onyx` |
+| `ONYX_CONFIG_PATH` | Path to JSON credentials file (Node only; ignored on edge) | unset (falls back to env ➜ project file ➜ home profile) |
+| `ONYX_DEBUG` | Enable HTTP + config debug logging | off |
+| `ONYX_STREAM_DEBUG` | Enable streaming debug logs | off |
 
 ```ts
 import { onyx } from '@onyx.dev/onyx-database';
@@ -172,15 +177,34 @@ export default {
 };
 ```
 
-### Connection handling
+### Connection & config caching
 
 Calling `onyx.init()` returns a lightweight client. Configuration is resolved once
-and cached for 5 minutes to avoid repeated credential lookups (override with
-`ttl` or reset via `onyx.clearCacheConfig()`). Each database instance keeps a
-single internal `HttpClient`. Requests use the runtime's global `fetch`, which
-already reuses connections and pools them for keep‑alive. Reuse the returned
-`db` for multiple operations; extra SDK‑level connection pooling generally isn't
-necessary unless you create many short‑lived clients.
+and cached **per `${databaseId}-${apiKey}` pair** for 5 minutes to avoid repeated
+env/file lookups (override with `ttl` or reset via `onyx.clearCacheConfig()`).
+Each database instance keeps a single internal `HttpClient`. Requests use the
+runtime's global `fetch`, which already reuses connections and pools them for
+keep‑alive. Reuse the returned `db` for multiple operations; extra SDK‑level
+connection pooling generally isn't necessary unless you create many short‑lived
+clients.
+
+### Typed vs untyped init
+
+`onyx.init()` is generic. Omit the type for quick scripts; add your generated schema type for full safety.
+
+```ts
+// Untyped: flexible, no compile-time field checks
+const db = onyx.init();
+const user = await db.from('User').findById('abc'); // inferred as any/unknown
+```
+
+```ts
+// Typed: import generated schema to get autocomplete and validation
+import type { OnyxSchema as Schema } from './onyx/types';
+const db = onyx.init<Schema>();
+const user = await db.from('User').findById('abc'); // inferred as Schema['User']
+// user.emali -> TypeScript error
+```
 
 ---
 
@@ -295,15 +319,19 @@ if (approval.requiresApproval) {
 
 ## Optional: generate TypeScript types from your schema
 
-The package ships a small codegen CLI that emits per-table interfaces, a `tables` enum, and a `Schema` mapping for compile-time safety and IntelliSense. Each generated interface also includes an index signature so extra properties (for graph attachments in cascade saves) don't trigger type errors.
+Use the **Onyx CLI** (`onyx`) from <https://github.com/OnyxDevTools/onyx-cli> to
+emit per-table interfaces, a `tables` enum, and a `Schema` mapping for
+compile-time safety and IntelliSense. Each generated interface also includes an
+index signature so extra properties (for graph attachments in cascade saves)
+don't trigger type errors.
 
 Generate directly from the API (using the same credential resolver as `init()`):
 
 ```bash
-npx onyx-gen --source api --out ./src/onyx/types.ts --name OnyxSchema
+onyx gen --ts --source api --out ./src/onyx/types.ts --name OnyxSchema
 ```
 
-With `--source api`, `onyx-gen` calls the Schema API (same as `onyx-schema get`) using the
+With `--source api`, `onyx gen` calls the Schema API (same as `onyx schema get`) using the
 standard config chain (env, project file, home profile).
 
 Timestamp attributes are emitted as `Date` fields by default. When saving,
@@ -313,30 +341,30 @@ Timestamp attributes are emitted as `Date` fields by default. When saving,
 Or from a local schema file you export from the console:
 
 ```bash
-npx onyx-gen --source file --schema ./onyx.schema.json --out ./src/onyx/types.ts --name OnyxSchema
+onyx gen --ts --source file --schema ./onyx.schema.json --out ./src/onyx/types.ts --name OnyxSchema
 ```
 
-Run it with no flags to use the defaults: `onyx-gen` reads `./onyx.schema.json` and writes to `./onyx/types.ts`.
+Run it with no flags to use the defaults: `onyx gen` reads `./onyx.schema.json` and writes to `./onyx/types.ts`.
 
 ### Manage schemas from the CLI
 
-Publish or download schema JSON directly via API using the `onyx-schema` helper:
+Publish or download schema JSON directly via API using the `onyx schema` helper:
 
 ```bash
 # Publish ./onyx.schema.json with publish=true by default
-onyx-schema publish
+onyx schema publish
 
 # Overwrite ./onyx.schema.json with the remote schema
-onyx-schema get
+onyx schema get
 
 # Print the remote schema without writing a file
-onyx-schema get --print
+onyx schema get --print
 
 # Fetch only selected tables (prints to stdout; does not overwrite files)
-onyx-schema get --tables=User,Profile
+onyx schema get --tables=User,Profile
 
 # Example subset output
-onyx-schema get --tables=User,Profile
+onyx schema get --tables=User,Profile
 # {
 #   "tables": [
 #     {
@@ -357,10 +385,10 @@ onyx-schema get --tables=User,Profile
 # }
 
 # Validate a schema file without publishing
-onyx-schema validate ./onyx.schema.json
+onyx schema validate ./onyx.schema.json
 
 # Diff local schema vs API
-onyx-schema diff ./onyx.schema.json
+onyx schema diff ./onyx.schema.json
 # Prints YAML with added/removed/changed tables and attribute differences between the API schema and your local file.
 ```
 
@@ -391,7 +419,7 @@ console.log(diff.changedTables);
 You can also emit to multiple paths in one run (comma-separated or by repeating `--out`):
 
 ```bash
-onyx-gen --out ./src/onyx/types.ts,./apps/admin/src/onyx/types.ts
+onyx gen --ts --out ./src/onyx/types.ts,./apps/admin/src/onyx/types.ts
 ```
 
 Use in code:
@@ -411,12 +439,12 @@ const User = await db
 ```
 
 For a schema with `User`, `UserProfile`, `Role`, and `Permission` tables,
-`onyx-gen` emits plain interfaces keyed by IDs. Each interface includes an
+`onyx gen` emits plain interfaces keyed by IDs. Each interface includes an
 index signature so resolver-attached fields or embedded objects remain
 type-safe:
 
 ```ts
-// AUTO-GENERATED BY onyx-gen. DO NOT EDIT.
+// AUTO-GENERATED BY onyx gen. DO NOT EDIT.
 export interface User {
   id?: string;
   name: string;
@@ -535,6 +563,26 @@ import {
 - `inOp`/`notIn` remain available for backward compatibility and are exact aliases.
 - `search(text, minScore?)` builds a Lucene `MATCHES` predicate on `__full_text__` and always serializes `minScore` (null when omitted).
 
+### Aggregate helpers
+
+```ts
+import {
+  avg, sum, count, min, max,
+  std, variance, median,
+  upper, lower,
+  substring, replace, percentile,
+  format
+} from '@onyx.dev/onyx-database';
+
+const rows = await db
+  .select(format('createdAt', 'yyyy-MM-dd'))
+  .from('User')
+  .list();
+```
+
+- `format(field, formatter)` uses Java-style format strings for dates and numbers.
+- Example: `examples/query/format.ts`
+
 ### Inner queries (IN/NOT IN with sub-selects)
 
 You can pass another query builder to `within` or `notWithin` to create nested filters. The SDK serializes the inner query (including its table) before sending the request.
@@ -889,36 +937,31 @@ const db = onyx.init({
 +----------------------+-----------------------------------------------+--------------------------------------------------------------+
 | Command              | Flags                                         | Defaults / notes                                             |
 +----------------------+-----------------------------------------------+--------------------------------------------------------------+
-| onyx-gen             | --source auto|api|file                        | Default: --source file; --schema ./onyx.schema.json;         |
-|                      | --schema <path>                               | --out ./onyx/types.ts (file or dir; repeatable; dir uses     |
-|                      | --out / --types-out / --types-file <dir|file> | --base onyx.schema); timestamps default: date; optional      |
-|                      | --base / --baseName <name>                    | strategy default: non-null; schema type name: OnyxSchema;    |
-|                      | --timestamps string|date|number               | emit-json disabled by default; --overwrite enabled; quiet=false. |
-|                      | --name / --schemaTypeName <T>                 | --api-path repeatable; --json-out derived from TS output.    |
-|                      | --prefix <Prefix>                             |                                                              |
-|                      | --optional non-null|nullable|none             |                                                              |
-|                      | --emit-json / --no-emit-json                  |                                                              |
-|                      | --json-out <dir>                              |                                                              |
-|                      | --api-path <path> (repeatable)                |                                                              |
+| onyx gen             | --ts/--typescript                             | Default: --source file; --schema ./onyx.schema.json;         |
+|                      | --source auto|api|file                        | --out ./onyx/types.ts (file or dir; repeatable);             |
+|                      | --schema <path>                               | schema type name: OnyxSchema; timestamps default: date.      |
+|                      | --out <dir|file>                              | Use --overwrite to force output; quiet=false.                |
+|                      | --name <T>                                    |                                                              |
+|                      | --timestamps string|date|number               |                                                              |
 |                      | --overwrite / --no-overwrite                  |                                                              |
 |                      | -q / --quiet                                  |                                                              |
 |                      | -h / --help                                   |                                                              |
 +----------------------+-----------------------------------------------+--------------------------------------------------------------+
-| onyx-schema get      | [file] (positional)                           | Default file: ./onyx.schema.json; writes file unless         |
+| onyx schema get      | [file] (positional)                           | Default file: ./onyx.schema.json; writes file unless         |
 |                      | --tables a,b                                  | --tables or --print (then prints to stdout).                 |
 |                      | --print                                       |                                                              |
 |                      | -h / --help                                   |                                                              |
 +----------------------+-----------------------------------------------+--------------------------------------------------------------+
-| onyx-schema publish  | [file] (positional)                           | Default file: ./onyx.schema.json; validates before publishing; |
+| onyx schema publish  | [file] (positional)                           | Default file: ./onyx.schema.json; validates before publishing; |
 |                      | -h / --help                                   | uses onyx.init credential resolver.                          |
 +----------------------+-----------------------------------------------+--------------------------------------------------------------+
-| onyx-schema validate | [file] (positional)                           | Default file: ./onyx.schema.json; exits non-zero on errors.  |
+| onyx schema validate | [file] (positional)                           | Default file: ./onyx.schema.json; exits non-zero on errors.  |
 |                      | -h / --help                                   |                                                              |
 +----------------------+-----------------------------------------------+--------------------------------------------------------------+
-| onyx-schema diff     | [file] (positional)                           | Default file: ./onyx.schema.json; prints YAML diff vs API.   |
+| onyx schema diff     | [file] (positional)                           | Default file: ./onyx.schema.json; prints YAML diff vs API.   |
 |                      | -h / --help                                   |                                                              |
 +----------------------+-----------------------------------------------+--------------------------------------------------------------+
-| onyx-schema info     | -h / --help                                   | Shows resolved config sources, config path, connection check.|
+| onyx schema info     | -h / --help                                   | Shows resolved config sources, config path, connection check.|
 +----------------------+-----------------------------------------------+--------------------------------------------------------------+
 ```
 

package/dist/{aggregates-BJT5DGGX.d.cts → aggregates-DREvey7b.d.cts}

@@ -1,3 +1,6 @@
+var name = "@onyx.dev/onyx-database";
+var version = "2.1.0";
+
 /**
  * Supported operators for building query criteria.
  *
@@ -1755,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 SchemaTriggerChange as $, type AiRequestOptions as A, type SecretsListResponse as B, type SecretSaveRequest as C, type SchemaDataType as D, type SchemaIdentifierGenerator as E, type FullTextQuery as F, type SchemaIdentifier as G, type SchemaAttribute as H, type IOnyxDatabase as I, type SchemaIndexType as J, type SchemaIndex as K, type SchemaResolver as L, type SchemaTriggerEvent as M, type SchemaTrigger as N, type OnyxFacade as O, type SchemaEntity as P, QueryResults as Q, type RetryOptions as R, type SecretMetadata as S, type SchemaRevisionMetadata as T, type SchemaRevision as U, type SchemaHistoryEntry as V, type SchemaUpsertRequest as W, type SchemaValidationResult as X, type SchemaAttributeChange as Y, type SchemaIndexChange as Z, type SchemaResolverChange as _, type QueryResultsPromise as a, type SchemaTableDiff as a0, type SchemaDiff as a1, type QueryCriteriaOperator as a2, type LogicalOperator as a3, type Sort as a4, type StreamAction as a5, type OnyxDocument as a6, type FetchResponse as a7, type FetchImpl as a8, type QueryCriteria as a9, notLike as aA, contains as aB, containsIgnoreCase as aC, notContains as aD, notContainsIgnoreCase as aE, startsWith as aF, notStartsWith as aG, isNull as aH, notNull as aI, avg as aJ, sum as aK, count as aL, min as aM, max as aN, std as aO, variance as aP, median as aQ, upper as aR, lower as aS, substring as aT, replace as aU, percentile as aV, type QueryCondition as aa, type SelectQuery as ab, type UpdateQuery as ac, type QueryPage as ad, type IConditionBuilder as ae, type IQueryBuilder as af, type ISaveBuilder as ag, type ICascadeBuilder as ah, type ICascadeRelationshipBuilder as ai, asc as aj, desc as ak, eq as al, neq as am, inOp as an, within as ao, notIn as ap, notWithin as aq, between as ar, gt as as, gte as at, lt as au, lte as av, matches as aw, search as ax, notMatches as ay, like 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 AiChatOptions as r, type AiChatClient as s, type AiScriptApprovalRequest as t, type AiScriptApprovalResponse as u, type AiModelsResponse as v, type AiModel as w, type AiErrorResponse as x, type AiClient as y, type SecretRecord 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/{aggregates-BJT5DGGX.d.ts → aggregates-DREvey7b.d.ts}

@@ -1,3 +1,6 @@
+var name = "@onyx.dev/onyx-database";
+var version = "2.1.0";
+
 /**
  * Supported operators for building query criteria.
  *
@@ -1755,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 SchemaTriggerChange as $, type AiRequestOptions as A, type SecretsListResponse as B, type SecretSaveRequest as C, type SchemaDataType as D, type SchemaIdentifierGenerator as E, type FullTextQuery as F, type SchemaIdentifier as G, type SchemaAttribute as H, type IOnyxDatabase as I, type SchemaIndexType as J, type SchemaIndex as K, type SchemaResolver as L, type SchemaTriggerEvent as M, type SchemaTrigger as N, type OnyxFacade as O, type SchemaEntity as P, QueryResults as Q, type RetryOptions as R, type SecretMetadata as S, type SchemaRevisionMetadata as T, type SchemaRevision as U, type SchemaHistoryEntry as V, type SchemaUpsertRequest as W, type SchemaValidationResult as X, type SchemaAttributeChange as Y, type SchemaIndexChange as Z, type SchemaResolverChange as _, type QueryResultsPromise as a, type SchemaTableDiff as a0, type SchemaDiff as a1, type QueryCriteriaOperator as a2, type LogicalOperator as a3, type Sort as a4, type StreamAction as a5, type OnyxDocument as a6, type FetchResponse as a7, type FetchImpl as a8, type QueryCriteria as a9, notLike as aA, contains as aB, containsIgnoreCase as aC, notContains as aD, notContainsIgnoreCase as aE, startsWith as aF, notStartsWith as aG, isNull as aH, notNull as aI, avg as aJ, sum as aK, count as aL, min as aM, max as aN, std as aO, variance as aP, median as aQ, upper as aR, lower as aS, substring as aT, replace as aU, percentile as aV, type QueryCondition as aa, type SelectQuery as ab, type UpdateQuery as ac, type QueryPage as ad, type IConditionBuilder as ae, type IQueryBuilder as af, type ISaveBuilder as ag, type ICascadeBuilder as ah, type ICascadeRelationshipBuilder as ai, asc as aj, desc as ak, eq as al, neq as am, inOp as an, within as ao, notIn as ap, notWithin as aq, between as ar, gt as as, gte as at, lt as au, lte as av, matches as aw, search as ax, notMatches as ay, like 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 AiChatOptions as r, type AiChatClient as s, type AiScriptApprovalRequest as t, type AiScriptApprovalResponse as u, type AiModelsResponse as v, type AiModel as w, type AiErrorResponse as x, type AiClient as y, type SecretRecord 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,5 +1,9 @@
 'use strict';
 
+// package.json
+var name = "@onyx.dev/onyx-database";
+var version = "2.1.0";
+
 // src/config/defaults.ts
 var DEFAULT_BASE_URL = "https://api.onyx.dev";
 var DEFAULT_AI_BASE_URL = "https://ai.onyx.dev";
@@ -803,8 +807,8 @@ var CascadeRelationshipBuilder = class {
    * builder.graph('programs');
    * ```
    */
-  graph(name) {
-    this.graphName = name;
+  graph(name2) {
+    this.graphName = name2;
     return this;
   }
   /**
@@ -891,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();
@@ -922,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();
@@ -951,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();
@@ -976,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();
@@ -1003,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) {
@@ -1034,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();
@@ -1973,20 +1977,38 @@ var AiChatClientImpl = class {
   }
 };
 function createOnyxFacade(resolveConfig2) {
-  let cachedCfg = null;
+  const cachedCfgs = /* @__PURE__ */ new Map();
+  const cacheKey = (databaseId, apiKey) => {
+    const id = typeof databaseId === "string" && databaseId.trim() !== "" ? databaseId.trim() : null;
+    const key = typeof apiKey === "string" && apiKey.trim() !== "" ? apiKey.trim() : null;
+    return id && key ? `${id}-${key}` : null;
+  };
   function resolveConfigWithCache(config) {
     const ttl = config?.ttl ?? DEFAULT_CACHE_TTL;
     const now = Date.now();
-    if (cachedCfg && cachedCfg.expires > now) {
-      return cachedCfg.promise;
+    const hintKey = cacheKey(config?.databaseId, config?.apiKey) ?? "__default__";
+    const existing = cachedCfgs.get(hintKey);
+    if (existing && existing.expires > now) {
+      return existing.promise;
     }
+    if (existing) cachedCfgs.delete(hintKey);
     const { ttl: _ttl, requestLoggingEnabled: _reqLog, responseLoggingEnabled: _resLog, ...rest } = config ?? {};
-    const promise = resolveConfig2(rest);
-    cachedCfg = { promise, expires: now + ttl };
+    const expires = now + ttl;
+    const promise = resolveConfig2(rest).then((resolved) => {
+      const resolvedKey = cacheKey(resolved.databaseId, resolved.apiKey) ?? hintKey;
+      const nextExpires = Date.now() + ttl;
+      cachedCfgs.set(resolvedKey, { promise, expires: nextExpires });
+      if (resolvedKey !== hintKey) {
+        const stale = cachedCfgs.get(hintKey);
+        if (stale && stale.promise === promise) cachedCfgs.delete(hintKey);
+      }
+      return resolved;
+    });
+    cachedCfgs.set(hintKey, { promise, expires });
     return promise;
   }
   function clearCacheConfig() {
-    cachedCfg = null;
+    cachedCfgs.clear();
   }
   return {
     init(config) {
@@ -2179,12 +2201,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;
@@ -2194,6 +2213,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;
@@ -2218,8 +2238,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;