@query-graph/core 1.1.7 → 1.1.9

package/docs/sql.md

@@ -18,6 +18,53 @@ const graph = registerDefinition(definition).withRelationalMapping({
 <code>withRelationalMappings</code>. Одинаковые mappings объединяются,
 конфликтующие table/column names возвращают ошибку фазы mapping.
 
+### Oracle Database Links
+
+Для удалённой таблицы укажите <code>databaseLink</code> отдельно от имени:
+
+```ts
+const graph = registerDefinition(definition).withRelationalMapping({
+  sources: {
+    users: {
+      table: { schema: 'APP', name: 'Users', databaseLink: 'REMOTE_GATE' },
+    },
+  },
+})
+```
+
+Oracle скомпилирует адрес как <code>"APP"."Users"@REMOTE_GATE</code>.
+Schema и name экранируются как идентификаторы, а ссылка добавляется вне кавычек.
+Без schema получится <code>"Users"@REMOTE_GATE</code>; без databaseLink
+сохраняется прежний локальный адрес. Строка <code>'Users@REMOTE_GATE'</code>
+по-прежнему означает одно имя таблицы, а не удалённый адрес.
+
+Поддерживается форма <code>LINK[.DOMAIN...][@CONNECTION]</code>, например
+<code>REMOTE.EXAMPLE.COM@READER</code>. Имя должно содержать 1–128 ASCII-байт,
+LINK и CONNECTION начинаются с латинской буквы; каждая непустая часть допускает
+только буквы, цифры, `_`, `$` и `#`.
+Не передавайте ведущий <code>@</code>, кавычки, пробелы или SQL-фрагменты.
+Неверное имя отклоняется при подключении mapping с диагностикой
+<code>invalidDatabaseLink</code> и путём
+<code>sources.&lt;source&gt;.table.databaseLink</code>.
+
+Регистр ссылки нечувствителен: компилятор выводит её в верхнем регистре,
+а объединение mappings считает <code>remote_gate</code> и
+<code>REMOTE_GATE</code> одной ссылкой. Локальная и удалённая таблицы, а также
+таблицы через разные ссылки конфликтуют. Это не меняет сравнение schema/name.
+Правила Oracle описаны в
+[References to Objects in Remote Databases](https://docs.oracle.com/en/database/oracle/oracle-database/19/sqlrf/Syntax-for-Schema-Objects-and-Parts-in-SQL-Statements.html).
+
+SQL Server отклоняет <code>databaseLink</code> с диагностикой
+<code>unsupportedTableQualifier</code>, если операция обращается к этому source.
+Неиспользуемые optional relations по-прежнему не входят в SQL.
+Oracle по-прежнему не поддерживает qualifier <code>catalog</code>.
+
+Ссылки работают в корневом source, JOIN, exists и firstBy через общий рендеринг
+таблиц; bindings и projection metadata не меняются. Mapping выбирается при
+инициализации приложения, не из пользовательских operation parameters.
+Библиотека не создаёт DB link и не проверяет доступ к удалённой БД: это остаётся
+ответственностью инфраструктуры потребителя.
+
 ## Диалекты
 
 ```ts

package/docs/type-system.md

@@ -118,10 +118,44 @@ type Row = ResultOf<typeof definition, typeof operation>
 Для composed graph выбранные batch relations добавляются как массивы либо
 nullable объекты согласно cardinality.
 
+Если объект объявлен через прямое поле источника:
+
+```ts
+projectObject({ path: 'profile', presence: profiles.field('id') })
+```
+
+то внутри существующего `profile` поля этого источника больше не получают
+`null` из-за optional JOIN. Например, для non-null `id` и `name` и nullable
+`nickname` результат будет:
+
+```ts
+type Row = {
+  profile: {
+    id: number | string
+    name: string
+    nickname: string | null
+  } | null
+}
+```
+
+Сам объект остается nullable. Nullable-колонки, поля других sources и поля
+вне этого объекта сохраняют прежнюю nullability. Вложенные объекты учитывают
+presence родителей, но наличие родителя не гарантирует наличие другого
+источника, даже если связь с ним объявлена `required`.
+
+Вычисляемый presence, например `coalesce(profiles.field('id'), 0)` или
+`isNotNull(profiles.field('id'))`, не подтверждает наличие источника.
+Если тип не позволяет однозначно определить source или путь объекта,
+уточнение также не применяется.
+
+Это уточнение относится к результату после обработки `statement.objects`
+потребителем. SQL и `statement.columns[].nullable` не меняются: до сборки
+вложенных объектов отсутствующая строка JOIN по-прежнему дает NULL-колонки.
+
 Driver может заменить представление scalar values:
 
 ```ts
-interface DriverScalars extends DefaultScalarOutputTypeMap {
+interface DriverScalars extends Omit<DefaultScalarOutputTypeMap, 'int64' | 'decimal' | 'dateTime'> {
   int64: bigint
   decimal: string
   dateTime: Date

package/native.js

@@ -81,12 +81,12 @@ function requireNative() {
         const binding = require('@query-graph/core-android-arm64')
         const bindingPackageVersion = require('@query-graph/core-android-arm64/package.json').version
         if (
-          bindingPackageVersion !== '1.1.7' &&
+          bindingPackageVersion !== '1.1.9' &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
         ) {
           throw new Error(
-            `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -103,12 +103,12 @@ function requireNative() {
         const binding = require('@query-graph/core-android-arm-eabi')
         const bindingPackageVersion = require('@query-graph/core-android-arm-eabi/package.json').version
         if (
-          bindingPackageVersion !== '1.1.7' &&
+          bindingPackageVersion !== '1.1.9' &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
         ) {
           throw new Error(
-            `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -129,12 +129,12 @@ function requireNative() {
         const binding = require('@query-graph/core-win32-x64-msvc')
         const bindingPackageVersion = require('@query-graph/core-win32-x64-msvc/package.json').version
         if (
-          bindingPackageVersion !== '1.1.7' &&
+          bindingPackageVersion !== '1.1.9' &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
         ) {
           throw new Error(
-            `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -151,12 +151,12 @@ function requireNative() {
         const binding = require('@query-graph/core-win32-ia32-msvc')
         const bindingPackageVersion = require('@query-graph/core-win32-ia32-msvc/package.json').version
         if (
-          bindingPackageVersion !== '1.1.7' &&
+          bindingPackageVersion !== '1.1.9' &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
         ) {
           throw new Error(
-            `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -173,12 +173,12 @@ function requireNative() {
         const binding = require('@query-graph/core-win32-arm64-msvc')
         const bindingPackageVersion = require('@query-graph/core-win32-arm64-msvc/package.json').version
         if (
-          bindingPackageVersion !== '1.1.7' &&
+          bindingPackageVersion !== '1.1.9' &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
         ) {
           throw new Error(
-            `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -198,12 +198,12 @@ function requireNative() {
       const binding = require('@query-graph/core-darwin-universal')
       const bindingPackageVersion = require('@query-graph/core-darwin-universal/package.json').version
       if (
-        bindingPackageVersion !== '1.1.7' &&
+        bindingPackageVersion !== '1.1.9' &&
         process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
         process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
       ) {
         throw new Error(
-          `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
         )
       }
       return binding
@@ -220,12 +220,12 @@ function requireNative() {
         const binding = require('@query-graph/core-darwin-x64')
         const bindingPackageVersion = require('@query-graph/core-darwin-x64/package.json').version
         if (
-          bindingPackageVersion !== '1.1.7' &&
+          bindingPackageVersion !== '1.1.9' &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
         ) {
           throw new Error(
-            `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -242,12 +242,12 @@ function requireNative() {
         const binding = require('@query-graph/core-darwin-arm64')
         const bindingPackageVersion = require('@query-graph/core-darwin-arm64/package.json').version
         if (
-          bindingPackageVersion !== '1.1.7' &&
+          bindingPackageVersion !== '1.1.9' &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
         ) {
           throw new Error(
-            `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -268,12 +268,12 @@ function requireNative() {
         const binding = require('@query-graph/core-freebsd-x64')
         const bindingPackageVersion = require('@query-graph/core-freebsd-x64/package.json').version
         if (
-          bindingPackageVersion !== '1.1.7' &&
+          bindingPackageVersion !== '1.1.9' &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
         ) {
           throw new Error(
-            `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -290,12 +290,12 @@ function requireNative() {
         const binding = require('@query-graph/core-freebsd-arm64')
         const bindingPackageVersion = require('@query-graph/core-freebsd-arm64/package.json').version
         if (
-          bindingPackageVersion !== '1.1.7' &&
+          bindingPackageVersion !== '1.1.9' &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
         ) {
           throw new Error(
-            `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -317,12 +317,12 @@ function requireNative() {
           const binding = require('@query-graph/core-linux-x64-musl')
           const bindingPackageVersion = require('@query-graph/core-linux-x64-musl/package.json').version
           if (
-            bindingPackageVersion !== '1.1.7' &&
+            bindingPackageVersion !== '1.1.9' &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
           ) {
             throw new Error(
-              `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -339,12 +339,12 @@ function requireNative() {
           const binding = require('@query-graph/core-linux-x64-gnu')
           const bindingPackageVersion = require('@query-graph/core-linux-x64-gnu/package.json').version
           if (
-            bindingPackageVersion !== '1.1.7' &&
+            bindingPackageVersion !== '1.1.9' &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
           ) {
             throw new Error(
-              `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -363,12 +363,12 @@ function requireNative() {
           const binding = require('@query-graph/core-linux-arm64-musl')
           const bindingPackageVersion = require('@query-graph/core-linux-arm64-musl/package.json').version
           if (
-            bindingPackageVersion !== '1.1.7' &&
+            bindingPackageVersion !== '1.1.9' &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
           ) {
             throw new Error(
-              `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -385,12 +385,12 @@ function requireNative() {
           const binding = require('@query-graph/core-linux-arm64-gnu')
           const bindingPackageVersion = require('@query-graph/core-linux-arm64-gnu/package.json').version
           if (
-            bindingPackageVersion !== '1.1.7' &&
+            bindingPackageVersion !== '1.1.9' &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
           ) {
             throw new Error(
-              `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -409,12 +409,12 @@ function requireNative() {
           const binding = require('@query-graph/core-linux-arm-musleabihf')
           const bindingPackageVersion = require('@query-graph/core-linux-arm-musleabihf/package.json').version
           if (
-            bindingPackageVersion !== '1.1.7' &&
+            bindingPackageVersion !== '1.1.9' &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
           ) {
             throw new Error(
-              `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -431,12 +431,12 @@ function requireNative() {
           const binding = require('@query-graph/core-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@query-graph/core-linux-arm-gnueabihf/package.json').version
           if (
-            bindingPackageVersion !== '1.1.7' &&
+            bindingPackageVersion !== '1.1.9' &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
           ) {
             throw new Error(
-              `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -455,12 +455,12 @@ function requireNative() {
           const binding = require('@query-graph/core-linux-loong64-musl')
           const bindingPackageVersion = require('@query-graph/core-linux-loong64-musl/package.json').version
           if (
-            bindingPackageVersion !== '1.1.7' &&
+            bindingPackageVersion !== '1.1.9' &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
           ) {
             throw new Error(
-              `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -477,12 +477,12 @@ function requireNative() {
           const binding = require('@query-graph/core-linux-loong64-gnu')
           const bindingPackageVersion = require('@query-graph/core-linux-loong64-gnu/package.json').version
           if (
-            bindingPackageVersion !== '1.1.7' &&
+            bindingPackageVersion !== '1.1.9' &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
           ) {
             throw new Error(
-              `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -501,12 +501,12 @@ function requireNative() {
           const binding = require('@query-graph/core-linux-riscv64-musl')
           const bindingPackageVersion = require('@query-graph/core-linux-riscv64-musl/package.json').version
           if (
-            bindingPackageVersion !== '1.1.7' &&
+            bindingPackageVersion !== '1.1.9' &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
           ) {
             throw new Error(
-              `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -523,12 +523,12 @@ function requireNative() {
           const binding = require('@query-graph/core-linux-riscv64-gnu')
           const bindingPackageVersion = require('@query-graph/core-linux-riscv64-gnu/package.json').version
           if (
-            bindingPackageVersion !== '1.1.7' &&
+            bindingPackageVersion !== '1.1.9' &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
             process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
           ) {
             throw new Error(
-              `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -546,12 +546,12 @@ function requireNative() {
         const binding = require('@query-graph/core-linux-ppc64-gnu')
         const bindingPackageVersion = require('@query-graph/core-linux-ppc64-gnu/package.json').version
         if (
-          bindingPackageVersion !== '1.1.7' &&
+          bindingPackageVersion !== '1.1.9' &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
         ) {
           throw new Error(
-            `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -568,12 +568,12 @@ function requireNative() {
         const binding = require('@query-graph/core-linux-s390x-gnu')
         const bindingPackageVersion = require('@query-graph/core-linux-s390x-gnu/package.json').version
         if (
-          bindingPackageVersion !== '1.1.7' &&
+          bindingPackageVersion !== '1.1.9' &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
         ) {
           throw new Error(
-            `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -594,12 +594,12 @@ function requireNative() {
         const binding = require('@query-graph/core-openharmony-arm64')
         const bindingPackageVersion = require('@query-graph/core-openharmony-arm64/package.json').version
         if (
-          bindingPackageVersion !== '1.1.7' &&
+          bindingPackageVersion !== '1.1.9' &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
         ) {
           throw new Error(
-            `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -616,12 +616,12 @@ function requireNative() {
         const binding = require('@query-graph/core-openharmony-x64')
         const bindingPackageVersion = require('@query-graph/core-openharmony-x64/package.json').version
         if (
-          bindingPackageVersion !== '1.1.7' &&
+          bindingPackageVersion !== '1.1.9' &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
         ) {
           throw new Error(
-            `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -638,12 +638,12 @@ function requireNative() {
         const binding = require('@query-graph/core-openharmony-arm')
         const bindingPackageVersion = require('@query-graph/core-openharmony-arm/package.json').version
         if (
-          bindingPackageVersion !== '1.1.7' &&
+          bindingPackageVersion !== '1.1.9' &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
           process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0'
         ) {
           throw new Error(
-            `Native binding package version mismatch, expected 1.1.7 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.1.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@query-graph/core",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "description": "Native query graph planner and SQL compiler for Node.js",
   "workspaces": [
     "packages/*"
@@ -141,9 +141,9 @@
   },
   "packageManager": "yarn@4.13.0",
   "optionalDependencies": {
-    "@query-graph/core-win32-x64-msvc": "1.1.7",
-    "@query-graph/core-darwin-x64": "1.1.7",
-    "@query-graph/core-linux-x64-gnu": "1.1.7",
-    "@query-graph/core-darwin-arm64": "1.1.7"
+    "@query-graph/core-win32-x64-msvc": "1.1.9",
+    "@query-graph/core-darwin-x64": "1.1.9",
+    "@query-graph/core-linux-x64-gnu": "1.1.9",
+    "@query-graph/core-darwin-arm64": "1.1.9"
   }
 }

package/types/authoring.d.ts

@@ -529,7 +529,11 @@ export function project<
 
 export function projectObject<const Path extends string | readonly string[], const Value extends ExpressionInput>(
   configuration: ProjectionObjectConfiguration<Path, Value>,
-): TypedProjectionObject<ConfigurationPath<Path>, InputNullability<Value>>
+): TypedProjectionObject<
+  ConfigurationPath<Path>,
+  InputNullability<Value>,
+  [Value] extends [FieldExpression<infer Source, infer _Field>] ? Source : string
+>
 
 export function dimension<
   const Path extends string | readonly string[],

package/types/model.d.ts

@@ -255,6 +255,7 @@ declare const typedProjectionNullabilityType: unique symbol
 declare const typedProjectionDefaultType: unique symbol
 declare const typedProjectionObjectPathType: unique symbol
 declare const typedProjectionObjectNullabilityType: unique symbol
+declare const typedProjectionObjectPresenceSourceType: unique symbol
 
 export interface ProjectionTypeMetadata<
   Path extends string = string,
@@ -271,15 +272,18 @@ export interface ProjectionTypeMetadata<
 export interface ProjectionObjectTypeMetadata<
   Path extends string = string,
   Nullability extends NullabilityExpression = NullabilityExpression,
+  PresenceSource extends string = string,
 > {
   readonly [typedProjectionObjectPathType]: Path
   readonly [typedProjectionObjectNullabilityType]: Nullability
+  readonly [typedProjectionObjectPresenceSourceType]: PresenceSource
 }
 
 export type TypedProjectionObject<
   Path extends string = string,
   Nullability extends NullabilityExpression = NullabilityExpression,
-> = ProjectionObjectDefinition<Path, Nullability> & ProjectionObjectTypeMetadata<Path, Nullability>
+  PresenceSource extends string = string,
+> = ProjectionObjectDefinition<Path, Nullability> & ProjectionObjectTypeMetadata<Path, Nullability, PresenceSource>
 
 export type TypedProjectionField<
   Path extends string = string,
@@ -435,6 +439,8 @@ export type TableName =
       catalog?: string
       schema?: string
       name: string
+      /** Oracle database link name, without the leading @. Not supported by SQL Server. */
+      databaseLink?: string
     }
 
 export interface SourceMapping {

package/types/result.d.ts

@@ -25,6 +25,22 @@ import type { BatchQuery, BatchRelation, ComposedQueryGraph } from './compositio
 
 type BooleanOr<Value extends boolean> = true extends Value ? true : false
 
+type IsUnion<Value, Whole = Value> = Value extends unknown ? ([Whole] extends [Value] ? false : true) : never
+
+type SingleStringLiteral<Value extends string> = string extends Value
+  ? never
+  : true extends IsUnion<Value>
+    ? never
+    : Value
+
+type SourceIsPresent<Source extends string, PresentSources extends string> = [SingleStringLiteral<Source>] extends [
+  never,
+]
+  ? false
+  : [Source] extends [PresentSources]
+    ? true
+    : false
+
 type BatchQueryGraph<Query extends BatchQuery> =
   Query extends BatchQuery<infer Child, infer _KeyPath, infer _KeyParameter> ? Child : never
 
@@ -116,6 +132,7 @@ type CombineAllNullability<Left extends boolean, Right extends boolean> = [Left]
 type EvaluateAnyNullability<
   Definition extends GraphDefinitionInput,
   Values,
+  PresentSources extends string,
   Depth extends readonly unknown[],
 > = Values extends readonly []
   ? false
@@ -124,16 +141,17 @@ type EvaluateAnyNullability<
         ...infer Rest extends readonly NullabilityExpression[],
       ]
     ? BooleanOr<
-        | EvaluateNullability<Definition, First, readonly [...Depth, unknown]>
-        | EvaluateAnyNullability<Definition, Rest, readonly [...Depth, unknown]>
+        | EvaluateNullability<Definition, First, PresentSources, readonly [...Depth, unknown]>
+        | EvaluateAnyNullability<Definition, Rest, PresentSources, readonly [...Depth, unknown]>
       >
     : Values extends readonly (infer Value extends NullabilityExpression)[]
-      ? BooleanOr<EvaluateNullability<Definition, Value, readonly [...Depth, unknown]>>
+      ? BooleanOr<EvaluateNullability<Definition, Value, PresentSources, readonly [...Depth, unknown]>>
       : boolean
 
 type EvaluateAllNullability<
   Definition extends GraphDefinitionInput,
   Values,
+  PresentSources extends string,
   Depth extends readonly unknown[],
 > = Values extends readonly []
   ? true
@@ -142,14 +160,15 @@ type EvaluateAllNullability<
         ...infer Rest extends readonly NullabilityExpression[],
       ]
     ? CombineAllNullability<
-        EvaluateNullability<Definition, First, readonly [...Depth, unknown]>,
-        EvaluateAllNullability<Definition, Rest, readonly [...Depth, unknown]>
+        EvaluateNullability<Definition, First, PresentSources, readonly [...Depth, unknown]>,
+        EvaluateAllNullability<Definition, Rest, PresentSources, readonly [...Depth, unknown]>
       >
     : boolean
 
 type EvaluateNullability<
   Definition extends GraphDefinitionInput,
   Formula extends NullabilityExpression,
+  PresentSources extends string = never,
   Depth extends readonly unknown[] = readonly [],
 > = Depth['length'] extends 16
   ? boolean
@@ -158,11 +177,16 @@ type EvaluateNullability<
     : Formula extends boolean
       ? Formula
       : Formula extends SourceFieldNullability<infer Source, infer FieldNullable>
-        ? BooleanOr<FieldNullable | SourceOuterNullable<Definition, Source, never, Depth>>
+        ? BooleanOr<
+            | FieldNullable
+            | (SourceIsPresent<Source, PresentSources> extends true
+                ? false
+                : SourceOuterNullable<Definition, Source, never, Depth>)
+          >
         : Formula extends AnyNullability<infer Values>
-          ? EvaluateAnyNullability<Definition, Values, Depth>
+          ? EvaluateAnyNullability<Definition, Values, PresentSources, Depth>
           : Formula extends AllNullability<infer Values>
-            ? EvaluateAllNullability<Definition, Values, Depth>
+            ? EvaluateAllNullability<Definition, Values, PresentSources, Depth>
             : boolean
 
 type ProjectionFieldPath<Field> =
@@ -186,16 +210,59 @@ type ProjectionObjectNullability<Object> =
       ? Nullability
       : boolean
 
+// Only a direct field presence proves its source exists, and only inside that object.
+type ProjectionObjectPresenceSource<Object> = [Object] extends [
+  ProjectionObjectTypeMetadata<infer _Path, infer _Nullability, infer Source>,
+]
+  ? SingleStringLiteral<Source>
+  : never
+
+type EnclosingObjectPath<Object, Path extends string> = Object extends ProjectionObjectDefinition
+  ? Path extends `${SingleStringLiteral<ProjectionObjectPath<Object>>}.${string}`
+    ? SingleStringLiteral<ProjectionObjectPath<Object>>
+    : never
+  : never
+
+type ProjectionObjectAtPath<Object, Path extends string> = Object extends ProjectionObjectDefinition
+  ? ProjectionObjectPath<Object> extends Path
+    ? Object
+    : never
+  : never
+
+type PresentSourcesAtPath<
+  Definition extends GraphDefinitionInput,
+  Path extends string,
+  ObjectPath = EnclosingObjectPath<DefinitionProjectionObject<Definition>, Path>,
+> = [SingleStringLiteral<Path>] extends [never]
+  ? never
+  : ObjectPath extends string
+    ? ProjectionObjectPresenceSource<ProjectionObjectAtPath<DefinitionProjectionObject<Definition>, ObjectPath>>
+    : never
+
 type ProjectionObjectIsNullable<Definition extends GraphDefinitionInput, Object> =
-  true extends EvaluateNullability<Definition, ProjectionObjectNullability<Object>> ? true : false
+  true extends EvaluateNullability<
+    Definition,
+    ProjectionObjectNullability<Object>,
+    PresentSourcesAtPath<Definition, ProjectionObjectPath<Object>>
+  >
+    ? true
+    : false
 
 type ProjectionFieldValue<Definition extends GraphDefinitionInput, Field, TypeMap extends ScalarOutputTypeMap> =
   Field extends ProjectionTypeMetadata<infer _Path, infer Type, infer Nullability, infer _SelectedByDefault>
-    ? true extends EvaluateNullability<Definition, Nullability>
+    ? true extends EvaluateNullability<
+        Definition,
+        Nullability,
+        PresentSourcesAtPath<Definition, ProjectionFieldPath<Field>>
+      >
       ? TypeMap[Type] | null
       : TypeMap[Type]
     : Field extends ProjectionFieldDefinition<infer _Path, infer Type, infer Nullability, infer _SelectedByDefault>
-      ? true extends EvaluateNullability<Definition, Nullability>
+      ? true extends EvaluateNullability<
+          Definition,
+          Nullability,
+          PresentSourcesAtPath<Definition, ProjectionFieldPath<Field>>
+        >
         ? TypeMap[Type] | null
         : TypeMap[Type]
       : never