@boristype/ws-client 0.1.0-alpha.5 → 0.1.0-alpha.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (84) hide show
  1. package/README.md +278 -13
  2. package/build/client.d.ts +3 -1
  3. package/build/client.d.ts.map +1 -1
  4. package/build/client.js +3 -1
  5. package/build/client.js.map +1 -1
  6. package/build/evaluator.d.ts +8 -0
  7. package/build/evaluator.d.ts.map +1 -1
  8. package/build/evaluator.js +10 -0
  9. package/build/evaluator.js.map +1 -1
  10. package/build/hcm/api.d.ts +11 -2
  11. package/build/hcm/api.d.ts.map +1 -1
  12. package/build/hcm/api.js +14 -1
  13. package/build/hcm/api.js.map +1 -1
  14. package/build/hcm/execute.d.ts +35 -0
  15. package/build/hcm/execute.d.ts.map +1 -0
  16. package/build/hcm/execute.js +76 -0
  17. package/build/hcm/execute.js.map +1 -0
  18. package/build/hcm/packages/archive-types.d.ts +23 -0
  19. package/build/hcm/packages/archive-types.d.ts.map +1 -0
  20. package/build/hcm/packages/archive-types.js +2 -0
  21. package/build/hcm/packages/archive-types.js.map +1 -0
  22. package/build/hcm/packages/archive.d.ts +5 -0
  23. package/build/hcm/packages/archive.d.ts.map +1 -0
  24. package/build/hcm/packages/archive.js +410 -0
  25. package/build/hcm/packages/archive.js.map +1 -0
  26. package/build/hcm/packages/artifacts.d.ts +16 -0
  27. package/build/hcm/packages/artifacts.d.ts.map +1 -0
  28. package/build/hcm/packages/artifacts.js +140 -0
  29. package/build/hcm/packages/artifacts.js.map +1 -0
  30. package/build/hcm/packages/contracts.d.ts +89 -0
  31. package/build/hcm/packages/contracts.d.ts.map +1 -0
  32. package/build/hcm/packages/contracts.js +41 -0
  33. package/build/hcm/packages/contracts.js.map +1 -0
  34. package/build/hcm/packages/native.d.ts +5 -0
  35. package/build/hcm/packages/native.d.ts.map +1 -0
  36. package/build/hcm/packages/native.js +47 -0
  37. package/build/hcm/packages/native.js.map +1 -0
  38. package/build/hcm/packages/schemas.d.ts +121 -0
  39. package/build/hcm/packages/schemas.d.ts.map +1 -0
  40. package/build/hcm/packages/schemas.js +94 -0
  41. package/build/hcm/packages/schemas.js.map +1 -0
  42. package/build/hcm/packages/service.d.ts +215 -0
  43. package/build/hcm/packages/service.d.ts.map +1 -0
  44. package/build/hcm/packages/service.js +420 -0
  45. package/build/hcm/packages/service.js.map +1 -0
  46. package/build/hcm/packages/transfer.d.ts +6 -0
  47. package/build/hcm/packages/transfer.d.ts.map +1 -0
  48. package/build/hcm/packages/transfer.js +81 -0
  49. package/build/hcm/packages/transfer.js.map +1 -0
  50. package/build/hcm/schemas.d.ts +98 -0
  51. package/build/hcm/schemas.d.ts.map +1 -1
  52. package/build/hcm/schemas.js +18 -0
  53. package/build/hcm/schemas.js.map +1 -1
  54. package/build/hcm/system-info.d.ts +24 -0
  55. package/build/hcm/system-info.d.ts.map +1 -0
  56. package/build/hcm/system-info.js +57 -0
  57. package/build/hcm/system-info.js.map +1 -0
  58. package/build/hcm/xquery.d.ts +4 -3
  59. package/build/hcm/xquery.d.ts.map +1 -1
  60. package/build/hcm/xquery.js +3 -28
  61. package/build/hcm/xquery.js.map +1 -1
  62. package/build/index.d.ts +12 -1
  63. package/build/index.d.ts.map +1 -1
  64. package/build/index.js +5 -0
  65. package/build/index.js.map +1 -1
  66. package/build/soap-utils.d.ts +8 -14
  67. package/build/soap-utils.d.ts.map +1 -1
  68. package/build/soap-utils.js +205 -169
  69. package/build/soap-utils.js.map +1 -1
  70. package/build/types.d.ts +9 -0
  71. package/build/types.d.ts.map +1 -1
  72. package/build/value-projection.d.ts +8 -0
  73. package/build/value-projection.d.ts.map +1 -0
  74. package/build/value-projection.js +101 -0
  75. package/build/value-projection.js.map +1 -0
  76. package/build/xquery.d.ts +28 -0
  77. package/build/xquery.d.ts.map +1 -0
  78. package/build/xquery.js +63 -0
  79. package/build/xquery.js.map +1 -0
  80. package/package.json +7 -2
  81. package/resources/execute.bs +40 -0
  82. package/resources/package-operation.bs +318 -0
  83. package/resources/value-projection.bs +79 -0
  84. package/resources/xquery.bs +16 -24
package/README.md CHANGED
@@ -10,16 +10,16 @@ npm install @boristype/ws-client@next
10
10
 
11
11
  Публичные exports:
12
12
 
13
- | Export | Назначение |
14
- | --------------------------------------- | ------------------------------------------------------------------ |
15
- | `WshcmClient` | Подключение и `callMethod(object, method, args)` через SP-XML SOAP |
16
- | `WshcmApi` | Общие файловые операции, XML объекты, XQuery и управление runtime |
17
- | `WshcmRuntimeError`, `WshcmObjectError` | Ошибки с `.status` / `.details` |
18
- | `wshcmSchemas` | Входные schemas общего SDK |
19
- | `Evaluator` | Временный серверный модуль для выполнения BorisScript |
20
- | `WshcmUploader` | Пакетная загрузка файлов через серверные BS resources |
21
- | `WshcmException`, `UnauthorizedError` | Ошибки SOAP/аутентификации |
22
- | `renderRequest`, `parseResponse` | Низкоуровневая сериализация SOAP |
13
+ | Export | Назначение |
14
+ | --------------------------------------- | ------------------------------------------------------------------- |
15
+ | `WshcmClient` | Подключение и `callMethod(object, method, args)` через SP-XML SOAP |
16
+ | `WshcmApi` | Файловые операции, XML объекты, XQuery, сведения о стенде и runtime |
17
+ | `WshcmRuntimeError`, `WshcmObjectError` | Ошибки с `.status` / `.details` |
18
+ | `wshcmSchemas` | Входные schemas общего SDK |
19
+ | `Evaluator` | Временный серверный модуль для выполнения BorisScript |
20
+ | `WshcmUploader` | Пакетная загрузка файлов через серверные BS resources |
21
+ | `WshcmException`, `UnauthorizedError` | Ошибки SOAP/аутентификации |
22
+ | `renderRequest`, `parseResponse` | Низкоуровневая сериализация SOAP |
23
23
 
24
24
  Типы опций экспортируются вместе с JavaScript declarations. Минимальный пример
25
25
  для доверенного тестового стенда, с реквизитами из environment:
@@ -70,14 +70,181 @@ Evaluator создаёт временный `.bs` файл на сервере
70
70
  - `objects.getForm/get/save(input)` — раскрытая XMD и XML объектов. ID передаётся
71
71
  строкой, replace требует token полного чтения. `.details` у `WshcmObjectError`
72
72
  сохраняет phase/writeStatus/id, включая неизвестный исход Save.
73
- - `xquery({query,maxRows?})` возвращает проверенный **исходный JSON text**:
74
- parse/re-encode может потерять точность чисел. SQL префикс передаётся без
73
+ - `xquery({query,maxRows?})` возвращает typed `XQueryResult`: integer как bigint,
74
+ real как number, XML-поля проецируются на сервере. SQL префикс передаётся без
75
75
  read-only проверки. XML/XQuery не требуют подготовки DLL.
76
+ - `systemInfo({includeReport?})` возвращает `SystemInfoResult`: сводку версий
77
+ и настроек стенда, при `includeReport: true` — также полный штатный отчёт.
78
+ Параметр по умолчанию `{}`, DLL не требуется. Контракт описан ниже.
79
+ - `execute({code})` выполняет серверный BorisScript один раз. Возвращает
80
+ `ExecutionResult` с результатом, сообщениями `print(value)` и native ошибкой.
81
+ DLL не требуется; выполнение имеет права подключённого аккаунта.
82
+ - `packages.listSchemas/getSchema/saveSchema/deleteSchema/addObjects/removeObjects/exportPackage/inspectPackage/importPackage/getOperation(input)` — штатные схемы, ZIP-артефакты, preview/import и серверные receipts, без DLL. Контракт и примеры — ниже.
76
83
  - `runtime.ensure()` автоматически подготавливает зависимости и возвращает
77
84
  статус; локальная ошибка или потеря transport-ответа выбрасывает
78
85
  `WshcmRuntimeError` с `.status`. `runtime.requireReady()` дополнительно
79
86
  выбрасывает эту ошибку при любом статусе кроме ready.
80
87
 
88
+ ## Пакеты объектов
89
+
90
+ ```js
91
+ import { randomUUID } from "node:crypto";
92
+ import { WshcmApi, WshcmPackageError, packageSchemas } from "@boristype/ws-client";
93
+
94
+ const api = new WshcmApi(evaluator); // evaluator initialized by caller
95
+ const exported = await api.packages.exportPackage({
96
+ objectIds: ["9007199254740993"],
97
+ operationId: randomUUID(),
98
+ });
99
+ const preview = await api.packages.inspectPackage({ artifactId: exported.artifact.artifactId });
100
+ // Or inspectPackage({ localPath: "/absolute/path/on-sdk-host/input.zip" })
101
+ const operationId = randomUUID(); // retain before dispatch
102
+ try {
103
+ const applied = await api.packages.importPackage({ inspectionId: preview.inspectionId, operationId });
104
+ console.log(applied.status, applied.verification, applied.reportIds);
105
+ } catch (error) {
106
+ if (error instanceof WshcmPackageError) console.error(error.details);
107
+ // After a timeout: query getOperation({ operationId }); never automatically retry.
108
+ throw error;
109
+ }
110
+ ```
111
+
112
+ `packageSchemas` — экспортируемые strict Zod input schemas. Методы используют один
113
+ контракт с десятью MCP tools (`wshcm_list_package_schemas`, `wshcm_get_package_schema`,
114
+ `wshcm_save_package_schema`, `wshcm_delete_package_schema`, `wshcm_add_package_objects`,
115
+ `wshcm_remove_package_objects`, `wshcm_export_package`, `wshcm_inspect_package`,
116
+ `wshcm_import_package`, `wshcm_get_package_operation`).
117
+
118
+ Схемы явно адресуются по id, UI current schema не переключается. `listSchemas({})`
119
+ и `getSchema({schemaId})` возвращают общую revision; `saveSchema({name})` создаёт
120
+ схему. Для изменения используйте `{schemaId,revision,name?,settings?,editable?}`;
121
+ для `addObjects/removeObjects` — `{schemaId,revision,objectIds}`; для удаления —
122
+ `deleteSchema({schemaId,revision})`. `editable` — `[{id,editable}]`.
123
+ Settings поддерживают `customTemplates`, `processCustomTemplates`,
124
+ `processAccessRoles`, `files:[{code,type,url,baseUrl?}]`. После мутации перечитайте
125
+ revision. Снимок и recheck общего XML не дают atomic CAS между клиентами.
126
+
127
+ Экспорт требует ровно один источник: `{schemaId,revision}` или `{objectIds}`.
128
+ Object IDs всегда десятичные строки. `includeCategories`, `includeRelatedObjects`,
129
+ `includeFiles`, `includeAssessmentItems` выключены по умолчанию. Related использует
130
+ только native XMD/foreign связи: `wvars`/`mode` resolvers отсутствуют; полное
131
+ транзитивное замыкание не обещается.
132
+
133
+ Результат экспорта содержит status, проверку `archive_membership`, страницу objects,
134
+ missingIds/missingCount и artifact с artifactId/localPath/mimeType/sizeBytes/sha256/expiresAt.
135
+ Файлы живут на **машине SDK**, в `~/.boristype/package-artifacts`, переживают сеанс;
136
+ handle действует 24 часа. `new WshcmPackages(evaluator,{artifactDirectory})` позволяет
137
+ выделить абсолютный каталог. Удаление expired файлов и native receipt/temp/report
138
+ автоматически не выполняется. Чтение localPath не разрешает перезапись оригинала.
139
+
140
+ Inspect создаёт неизменяемую копию ZIP и native preview. `inspectionId` связывает
141
+ весь состав; default import выбирает все его объекты, независимо от страниц.
142
+ Явные packageIds/objectIds выбирают любое подмножество этого снимка, внешние IDs
143
+ отклоняются. Исходный файл после inspect не перечитывается. Binding хранится в
144
+ памяти экземпляра; после restart требуется новый inspect, сохранившийся artifactId
145
+ можно использовать снова. Конфликты/hash/account/target проверяются перед apply.
146
+
147
+ Import флаги `skipConflictingIds`, `allowVersionMismatch`, `allowReimport`,
148
+ `includeCustomTemplates`, `includeAccessRoles`, `includeFiles`, `includeDeletions`,
149
+ `includeLists` по умолчанию false. Поддерживаются objects/courses/web/custom_file;
150
+ остальные типы отклоняются до применения. custom_file требует destination ниже
151
+ `x-local://custom/`. Дополнительные типы и extras ещё не прошли native acceptance.
152
+
153
+ ZIP ≤128 MiB; expanded bytes ≤512 MiB; ≤10000 entries; ZIP depth ≤2; XML ≤32 MiB;
154
+ input objectIds ≤10000; страницы default 100, limit 1–1000; chunk 256 KiB.
155
+ SDK не возвращает ZIP/base64 в JSON. MCP дополнительно ограничивает text 256 KiB
156
+ и добавляет truncated/nextPage; SDK выдаёт полные разрешённые страницы.
157
+
158
+ Ошибка `WshcmPackageError.details` сохраняет phase/status/code/message/operationId,
159
+ при наличии — lastKnownOperation/cleanupError. Public UUID handles operationId,
160
+ artifactId и inspectionId принимаются в любом регистре и приводятся к lowercase
161
+ перед lookup/dispatch; результаты используют lowercase. Native schemaId/packageId
162
+ сохраняют регистр. Native receipts переживают потерю
163
+ клиента и доступны через getOperation на том же target/account; автоматического
164
+ retry/rollback/cancellation/exactly-once нет. Отсутствующий, недоступный или
165
+ повреждённый receipt даёт ReceiptUnavailable/receipt/unknown с тем же operationId,
166
+ без восстановления receipt или повторной мутации. Timeout не останавливает HCM.
167
+ `completed` + `platform_report_only` не доказывает per-object success.
168
+
169
+ Native objects acceptance выполнена на Linux C HCM 2025.2.1333/PostgreSQL;
170
+ Windows/MSSQL, максимальные размеры и прикладные зависимости не подтверждены.
171
+ [Полный сценарий MCP](https://github.com/BorisType/BorisType/blob/main/packages/mcp-server/README.md#пакеты-объектов).
172
+
173
+ ## Сведения о стенде
174
+
175
+ ```js
176
+ const { summary } = await api.systemInfo();
177
+ const { report } = await api.systemInfo({ includeReport: true });
178
+ ```
179
+
180
+ Один вызов штатного `tools_report.gather_system_info()` собирает тот же отчёт,
181
+ что «О программе → Информация о системе» веб-администратора. `summary` содержит
182
+ `hcmVersion`, `osVersion`, `database: { type, version }`, `unibridgeVersion`,
183
+ `runMode` (строки или `null`) и `cluster`, `fullTextIndex`, `personalData`
184
+ (boolean или `null`). Отсутствующие поля и неизвестные значения флагов — `null`.
185
+ Сводка извлекается только из заголовка, до первой секции конфигурации.
186
+ Типы `SystemInfoSummary` и `SystemInfoResult` экспортируются из пакета.
187
+
188
+ По умолчанию `report` отсутствует. При `includeReport: true` он содержит исходный
189
+ текст без дополнительной очистки, включая конфигурации INI/XML/Global Settings;
190
+ это ещё не формализованный JSON конфигураций. CRLF/CR/LF защищены JSON carrier.
191
+ Отчёт ограничен 256 KiB UTF-8 и отклоняется целиком при превышении, в том числе
192
+ при запросе одной сводки. Неподдерживаемый SOAP carrier даёт ошибку.
193
+ Лимит проверяется после сбора отчёта и не ограничивает работу самого сборщика.
194
+ DLL не подготавливается, автоматических повторов нет; это сведения ответившего
195
+ процесса, без гарантии единого снимка всего кластера.
196
+
197
+ Проверено на Linux C HCM 2025.2.1333 / PostgreSQL 16; другие версии, локализации
198
+ заголовка и ОС требуют проверки. Настройки стенда не изменяются.
199
+
200
+ ## Выполнение BorisScript
201
+
202
+ ```js
203
+ const result = await api.execute({
204
+ code: 'print("Checking version"); return tools.get_version("wtv", false);',
205
+ });
206
+ // { ok: true, value: "2025.2.1333", output: ["Checking version"], outputTruncated: false }
207
+ ```
208
+
209
+ Передаётся именно серверный BorisScript, без компиляции TypeScript/JavaScript.
210
+ Используйте `return` для результата; переменные и вспомогательные функции можно
211
+ объявлять внутри скрипта. `print(value)` добавляет сообщение в вывод этого вызова
212
+ и возвращает свой аргумент. Строки сохраняются точно, остальные значения
213
+ форматируются штатным `EncodeJson` (`undefined` — текстом `undefined`).
214
+ Штатные `alert`/логи вызываемых библиотек остаются в журнале HCM; перехвата нет.
215
+
216
+ `print(value)` — экспериментальный кандидат: его практическую полезность ещё
217
+ предстоит оценить относительно возврата результата и чтения штатных логов.
218
+ По результатам оценки он может быть изменён или удалён.
219
+
220
+ Успех: `{ok:true,value,output,outputTruncated}`. Значение проецируется тем же
221
+ кодом, что XQuery: integer → bigint, real → number, XML → records/arrays,
222
+ date → ISO string; строки сохраняют CRLF/CR/LF. Поддерживаемые обычные значения
223
+ сохраняют null/undefined. Идентичность объектов и XML API не сохраняются.
224
+ Неподдерживаемый SOAP carrier даёт ошибку.
225
+
226
+ При native ошибке возвращается `{ok:false,error:{phase,message},output,outputTruncated}`:
227
+ `execution` — разбор/выполнение, `result` — преобразование уже полученного
228
+ результата. Сохраняются сообщения, записанные до ошибки, и native контекст
229
+ исключения (до 2000 символов). Это не подтверждение отсутствия побочных эффектов.
230
+ Transport/невалидный ответ вместо результата выбрасывает экспортируемый
231
+ `WshcmExecutionError`: `.details.phase` = `transport`/`response`,
232
+ `.details.executionStatus` = `unknown`. Вывод при потерянном ответе не гарантирован.
233
+ Невалидный input отклоняется до обращения к evaluator.
234
+
235
+ Код — до 64 KiB UTF-8; проекция результата — depth 32, 10000 значений и
236
+ 48000 символов внутреннего carrier. Диагностика сохраняет целые сообщения
237
+ до 256 сообщений/16000 символов JSON-кодированного текста, затем выставляет
238
+ `outputTruncated: true` и пропускает последующие сообщения, продолжая скрипт.
239
+ Итоговый ответ ограничен 256 KiB UTF-8. Лимиты проверяются после формирования
240
+ значения/сообщения, не ограничивают работу или память пользовательского кода.
241
+
242
+ Выполнение не изолировано от серверных API и не ограничено политикой файловых
243
+ readToken. DLL не подготавливается. Нет rollback, server cancellation и retry:
244
+ **timeout клиента не означает остановку кода**. Перед повтором неизвестного
245
+ исхода нужно установить фактические эффекты. Возврат ошибки результата также
246
+ не отменяет уже выполненные изменения.
247
+
81
248
  ## Автоматическая подготовка DLL
82
249
 
83
250
  Каждая файловая операция вызывает runtime gate. Manifest и SHA256 пакета
@@ -95,7 +262,7 @@ DOTNETLIBS-PATH, не устанавливает CLR и не перезапус
95
262
  `restart_required`: файловые вызовы блокируются до проверки после перезапуска.
96
263
  `blocked` сообщает, например, несовместимый API, повреждение immutable файлов
97
264
  или конфликт разных builds одного version. Более новая совместимая версия
98
- не откатывается. XQuery/XML остаются доступны.
265
+ не откатывается. Execute/system info/XQuery/XML остаются доступны.
99
266
 
100
267
  Concurrent ensure одного экземпляра объединяются, последующие вызовы проверяют
101
268
  процесс снова. Status относится к ответившему процессу; gate и файловая операция
@@ -115,3 +282,101 @@ BorisType.FileSystem / API 2; общий runtime manager допускает др
115
282
  Установке из npm .NET SDK не нужен.
116
283
  Подробнее: [документация BorisType](https://github.com/BorisType/BorisType/tree/main/docs)
117
284
  и [сценарии MCP](https://github.com/BorisType/BorisType/blob/main/docs/guides/mcp-server.md).
285
+
286
+ ## Типы и совместимость
287
+
288
+ **Несовместимое изменение:** все SOAP `integer`, включая небольшие значения,
289
+ возвращаются как `bigint`. Для integer-аргумента используйте `42n`; `42` всегда
290
+ передаётся как `real`. Диапазон integer — `-9223372036854775808n`…`9223372036854775807n`.
291
+ Отрицательные значения, включая `-7n`, пригодны для повторной передачи на вход.
292
+
293
+ | HCM / SOAP | JavaScript | Примечание |
294
+ | ----------- | ------------------------------- | -------------------------------------------------------- |
295
+ | `integer` | `bigint` | Точный signed int64 |
296
+ | `real` | `number` | Известная потеря точности в серверном SOAP-сериализаторе |
297
+ | `string` | `string` | Без угадывания чисел по тексту |
298
+ | `bool` | `boolean` | `true` / `false` |
299
+ | `null` | `null` | Отличается от `undefined` |
300
+ | `undefined` | `undefined` | Сохраняется и во вложенных значениях |
301
+ | `Array` | `WshcmValue[]` | Пустые, одиночные и смешанные массивы |
302
+ | `Object` | `{ [key: string]: WshcmValue }` | Обычные записи, рекурсивно |
303
+ | XML / date | Явная ошибка в общем кодеке | Для XQuery есть отдельная проекция |
304
+
305
+ `NaN`, `Infinity`, `-Infinity`, `-0` поддерживаются как real. Однако точный
306
+ round-trip произвольного `number` не гарантируется: на Linux C HCM 2025.2.1333
307
+ `1.2345678901234567` возвращается как `1.2345678901`, а `1e-100` — как `0`.
308
+
309
+ `callMethod<T>(lib, method, args)` сохраняет generic API. `T` — утверждение типа
310
+ вызывающим кодом, без runtime-конверсии или проверки. Используйте `bigint` в
311
+ ожидаемых типах integer-полей. Значения можно передавать обратно с теми же типами
312
+ в пределах поддерживаемого домена; идентичность объектов не сохраняется.
313
+
314
+ Записи на входе должны иметь собственные enumerable data properties с допустимыми
315
+ XML-именами без namespace-префикса. Имена с пробелами, `:`, XML markup,
316
+ accessors, symbols, class instances, Date, Map, циклы, sparse arrays и пользовательские
317
+ свойства массивов отвергаются. Ответ сохраняет namespace-префиксы, но такие ключи
318
+ нельзя повторно отправить без явного преобразования. Строки должны состоять из
319
+ допустимых XML 1.0 символов. Некорректные typed responses дают явную ошибку.
320
+
321
+ ## XQuery
322
+
323
+ `evaluator.xquery(query, { maxRows?: number })` возвращает `Promise<XQueryResult>`:
324
+
325
+ ```typescript
326
+ {
327
+ rows: WshcmValue[];
328
+ returnedRows: number;
329
+ truncated: boolean;
330
+ limitReason: "rows" | "output" | null;
331
+ }
332
+ ```
333
+
334
+ `WshcmApi.xquery({ query, maxRows? })` возвращает тот же typed результат.
335
+ Альтернатива для собственного evaluator: `executeXQuery({ eval }, query, options)`.
336
+ Каталожные/SQL XML-строки проецируются на сервере по фактическим типам полей.
337
+ Клиент получает обычные записи с `bigint`/`number`, вложенные структуры и массивы;
338
+ полный XML API не создаётся. Повторяющиеся имена становятся массивами, schema multi
339
+ сохраняет singleton-массив. Пустые scalar-поля используют фактическое `.Value`;
340
+ complex-поля становятся записями. Native date превращается в ISO-строку с датой
341
+ или датой/временем и смещением, как её выдаёт `EncodeJson`. Имена SQL aliases могут
342
+ содержать пробелы: внутренний carrier не использует их как XML-имена.
343
+
344
+ По умолчанию выдаётся до 100 строк, допустимо 1–1000; материализуется до `maxRows+1`.
345
+ Запрос — непустой well-formed текст до 64 KiB UTF-8 без NUL. Проекция ограничена
346
+ глубиной 32 и 10000 значений; превышение даёт ошибку. Размер ограничивается между
347
+ целыми строками по 65000 символов внутреннего carrier, итог — до 256 KiB в JSON
348
+ представлении. Метаданные усечения описывают только возвращённую выборку.
349
+ Строковые листья защищены JSON escaping, включая CR/LF.
350
+
351
+ Запрос передаётся без изменений, включая `sql:`. Вызов не гарантирует чтение,
352
+ идемпотентность, откат или ограничение работы БД; timeout не гарантирует отмену.
353
+ Автоматических повторов нет. SQL→XML может терять отрицательные integer и смешивать
354
+ NULL с пустой строкой ещё до SOAP. Для signed SQL-значений на проверенном Linux C/PG
355
+ используйте, например, `CAST(-7 AS VARCHAR(32))`.
356
+
357
+ MCP отдельно преобразует безопасные `bigint` в JSON number, остальные — в decimal
358
+ string. Прямой `JSON.stringify` результата ws-client с `bigint` требует replacer.
359
+
360
+ [Матрица, границы и источники](../../docs/reference/ws-client-values.md).
361
+
362
+ ## Проверки
363
+
364
+ ```sh
365
+ pnpm --filter @boristype/ws-client build
366
+ pnpm --filter @boristype/ws-client test
367
+ # На явно выбранном тестовом HCM: WSHCM_HOST, WSHCM_USERNAME, WSHCM_PASSWORD;
368
+ # optional WSHCM_PORT (80), WSHCM_HTTPS (false).
369
+ pnpm --filter @boristype/ws-client test:e2e:values
370
+ pnpm --filter @boristype/ws-client test:e2e:xquery
371
+ # Existing stand; WSHCM_USERNAME/WSHCM_PASSWORD and optional WSHCM_HOST/PORT
372
+ pnpm --filter @boristype/ws-client test:e2e:packages
373
+ ```
374
+
375
+ `test:e2e:values` и `test:e2e:xquery` создают и удаляют собственные временные
376
+ BS-модули, не меняя бизнес-записи. `test:e2e:packages` также создаёт, импортирует,
377
+ обновляет и удаляет собственные cost_center fixtures и схемы пакетов; очищает
378
+ свои ZIP, receipts, reports и временные каталоги. Его опциональная guarded
379
+ PostgreSQL cleanup удаляет только проверенные собственные catalog projections
380
+ и относится к тестам. Это проверка с изменениями данных выбранного стенда.
381
+ `test:e2e:values` фиксирует наблюдаемое форматирование real на Linux C 2025.2.1333;
382
+ другие runtime требуют своей проверки.
package/build/client.d.ts CHANGED
@@ -41,7 +41,9 @@ export declare class WshcmClient {
41
41
  initialize(): Promise<void>;
42
42
  /**
43
43
  * Вызывает метод через SP-XML API
44
- * @template T - тип возвращаемого значения
44
+ * SOAP integer возвращается как bigint, real — как number. Параметр T только
45
+ * утверждает тип в TypeScript; он не преобразует и не проверяет результат.
46
+ * @template T - ожидаемый вызывающим кодом тип возвращаемого значения
45
47
  * @param lib - библиотека/модуль (например, "tools", или URL модуля)
46
48
  * @param method - имя метода
47
49
  * @param methodArgs - массив аргументов метода
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAS3C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,cAAc,CAAS;IAE/B;;;OAGG;gBACS,OAAO,EAAE,kBAAkB;IAQvC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;;;;OAOG;IACG,UAAU,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAgB1F;;;;;;;OAOG;IACH,eAAe,IAAI,SAAS;IAI5B;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;CAmEpB"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAS3C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,cAAc,CAAS;IAE/B;;;OAGG;gBACS,OAAO,EAAE,kBAAkB;IAQvC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;;;;;;OASG;IACG,UAAU,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAgB1F;;;;;;;OAOG;IACH,eAAe,IAAI,SAAS;IAI5B;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;CAmEpB"}
package/build/client.js CHANGED
@@ -60,7 +60,9 @@ export class WshcmClient {
60
60
  }
61
61
  /**
62
62
  * Вызывает метод через SP-XML API
63
- * @template T - тип возвращаемого значения
63
+ * SOAP integer возвращается как bigint, real — как number. Параметр T только
64
+ * утверждает тип в TypeScript; он не преобразует и не проверяет результат.
65
+ * @template T - ожидаемый вызывающим кодом тип возвращаемого значения
64
66
  * @param lib - библиотека/модуль (например, "tools", или URL модуля)
65
67
  * @param method - имя метода
66
68
  * @param methodArgs - массив аргументов метода
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,qDAAqD;AACrD,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,WAAW;IACd,OAAO,CAAS;IAChB,QAAQ,CAAS;IACjB,QAAQ,CAAS;IACjB,OAAO,GAAa,EAAE,CAAC;IACvB,OAAO,CAAU;IACjB,cAAc,CAAS;IAE/B;;;OAGG;IACH,YAAY,OAA2B;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAC3F,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,uBAAuB,CAAC;IAC1E,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;QACxE,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,IAAI,iBAAiB,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,UAAU,CAAU,GAAW,EAAE,MAAc,EAAE,aAAoB,EAAE;QAC3E,MAAM,OAAO,GAAG;YACd,MAAM,EAAE,KAAK;YACb,iBAAiB,EAAE,qCAAqC;YACxD,eAAe,EAAE,UAAU;YAC3B,cAAc,EAAE,qCAAqC;YACrD,MAAM,EAAE,UAAU;YAClB,gBAAgB,EAAE,uBAAuB;SAC1C,CAAC;QAEF,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QACpD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,uBAAuB,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAE5F,OAAO,aAAa,CAAC,YAAsB,CAAM,CAAC;IACpD,CAAC;IAED;;;;;;;OAOG;IACH,eAAe;QACb,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;OAOG;IACK,WAAW,CAAC,IAAY,EAAE,MAAc,EAAE,UAAkC,EAAE,EAAE,IAAa;QACnG,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAEjF,MAAM,UAAU,GAA2B;gBACzC,GAAG,OAAO;gBACV,aAAa,EAAE,SAAS,IAAI,EAAE;aAC/B,CAAC;YAEF,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,UAAU,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjD,CAAC;YAED,IAAI,IAAI,EAAE,CAAC;gBACT,UAAU,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACpE,CAAC;YAED,MAAM,OAAO,GAAwB;gBACnC,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM;gBAC/B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,UAAU;gBACnB,OAAO,EAAE,IAAI,CAAC,cAAc;aAC7B,CAAC;YAEF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YACxC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACvC,oBAAoB;gBACpB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;gBAC5C,IAAI,SAAS,EAAE,CAAC;oBACd,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxE,CAAC;gBAED,kGAAkG;gBAClG,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBACxB,IAAI,IAAI,GAAG,EAAE,CAAC;gBACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;oBACvB,IAAI,IAAI,KAAK,CAAC;gBAChB,CAAC,CAAC,CAAC;gBAEH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;oBACjB,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;wBACrB,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC;oBACjC,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,IAAI,CAAC,CAAC;oBAChB,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;gBACrB,GAAG,CAAC,OAAO,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,cAAc,CAAC,2BAA2B,IAAI,CAAC,cAAc,OAAO,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;YACpG,CAAC,CAAC,CAAC;YAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACxB,MAAM,CAAC,IAAI,cAAc,CAAC,mBAAmB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACjE,CAAC,CAAC,CAAC;YAEH,IAAI,IAAI,EAAE,CAAC;gBACT,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;YAED,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
@@ -1,4 +1,5 @@
1
1
  import { WshcmClient } from "./client.js";
2
+ import { type XQueryOptions, type XQueryResult } from "./xquery.js";
2
3
  /**
3
4
  * Evaluator для выполнения произвольного BorisScript-кода на сервере
4
5
  *
@@ -33,6 +34,13 @@ export declare class Evaluator {
33
34
  * @returns результат выполнения
34
35
  */
35
36
  eval(code: string): Promise<any>;
37
+ /**
38
+ * Execute XQuery once and project server XML fields to bounded ordinary data.
39
+ * Integers remain bigint; native dates become ISO strings. Defaults to 100
40
+ * complete rows, at most 1000 rows and 256 KiB of JSON-compatible data.
41
+ * Row limits do not bound database work and failures are never retried.
42
+ */
43
+ xquery(query: string, options?: XQueryOptions): Promise<XQueryResult>;
36
44
  evalCode(code: string): Promise<any>;
37
45
  evalExpr(expr: string): Promise<any>;
38
46
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../src/evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAE5B;;;OAGG;gBACS,MAAM,EAAE,WAAW;IAM/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC;;;;OAIG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAOhC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAOpC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAI1C;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAa/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAgB5B"}
1
+ {"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../src/evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEnF;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAE5B;;;OAGG;gBACS,MAAM,EAAE,WAAW;IAM/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC;;;;OAIG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAOtC;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIzE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAOpC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAI1C;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAa/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAgB5B"}
@@ -1,3 +1,4 @@
1
+ import { executeXQuery } from "./xquery.js";
1
2
  /**
2
3
  * Evaluator для выполнения произвольного BorisScript-кода на сервере
3
4
  *
@@ -48,6 +49,15 @@ export class Evaluator {
48
49
  }
49
50
  return this.client.callMethod(this.libUrl, "execute", [code]);
50
51
  }
52
+ /**
53
+ * Execute XQuery once and project server XML fields to bounded ordinary data.
54
+ * Integers remain bigint; native dates become ISO strings. Defaults to 100
55
+ * complete rows, at most 1000 rows and 256 KiB of JSON-compatible data.
56
+ * Row limits do not bound database work and failures are never retried.
57
+ */
58
+ async xquery(query, options = {}) {
59
+ return executeXQuery(this, query, options);
60
+ }
51
61
  async evalCode(code) {
52
62
  // Оборачиваем код в функцию, чтобы явно не возвращать никакого результата всего сегмента кода, даже если в коде есть return
53
63
  const randomFuncName = "__evaluator_wrapper_" + this.generateRandomString(32);
@@ -1 +1 @@
1
- {"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../src/evaluator.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,SAAS;IACZ,MAAM,CAAc;IACpB,OAAO,CAAS;IAChB,MAAM,CAAS;IACf,WAAW,GAAG,KAAK,CAAC;IAE5B;;;OAGG;IACH,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,cAAc,GAAG,IAAI,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,GAAG,gBAAgB,IAAI,CAAC,OAAO,KAAK,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3C,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,qBAAqB,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACrF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,4HAA4H;QAC5H,MAAM,cAAc,GAAG,sBAAsB,GAAG,IAAI,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAC9E,MAAM,WAAW,GAAG,YAAY,cAAc,SAAS,IAAI,QAAQ,cAAc,YAAY,CAAC;QAC9F,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;YAC1E,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,MAAc;QACzC,MAAM,KAAK,GAAG,gEAAgE,CAAC;QAC/E,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,mBAAmB;QACzB,OAAO;;;;;;;;sBAQW,IAAI,CAAC,MAAM;;;;;EAK/B,CAAC;IACD,CAAC;CACF"}
1
+ {"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../src/evaluator.ts"],"names":[],"mappings":"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"}
@@ -1,7 +1,11 @@
1
1
  import { WshcmRuntime, type WshcmRuntimeOptions } from "./runtime/runtime.js";
2
2
  import type { z } from "zod";
3
3
  import { WshcmFiles } from "./files.js";
4
+ import { WshcmPackages } from "./packages/service.js";
4
5
  import { WshcmObjects } from "./objects.js";
6
+ import { type SystemInfoResult } from "./system-info.js";
7
+ import { type ExecutionResult } from "./execute.js";
8
+ import type { XQueryResult } from "../xquery.js";
5
9
  import type { wshcmSchemas } from "./schemas.js";
6
10
  import type { WshcmEvaluator } from "./types.js";
7
11
  /** Shared HCM operations. The caller owns the evaluator's initialization and lifecycle. */
@@ -9,9 +13,14 @@ export declare class WshcmApi {
9
13
  private readonly evaluator;
10
14
  readonly files: WshcmFiles;
11
15
  readonly objects: WshcmObjects;
16
+ readonly packages: WshcmPackages;
12
17
  readonly runtime: WshcmRuntime;
13
18
  constructor(evaluator: WshcmEvaluator, runtimeOptions?: WshcmRuntimeOptions);
14
- /** Return original JSON text to preserve large IDs and decimal tokens. */
15
- xquery(input: z.input<typeof wshcmSchemas.xquery>): Promise<string>;
19
+ /** Return bounded typed rows: integers are bigint, reals number, native dates ISO strings. */
20
+ xquery(input: z.input<typeof wshcmSchemas.xquery>): Promise<XQueryResult>;
21
+ /** Read the native About report; includeReport opts into the full unredacted text. */
22
+ systemInfo(input?: z.input<typeof wshcmSchemas.systemInfo>): Promise<SystemInfoResult>;
23
+ /** Execute BorisScript once; native failures retain print output, transport failures have an unknown outcome. */
24
+ execute(input: z.input<typeof wshcmSchemas.execute>): Promise<ExecutionResult>;
16
25
  }
17
26
  //# sourceMappingURL=api.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/hcm/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,2FAA2F;AAC3F,qBAAa,QAAQ;IAMjB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;gBAGZ,SAAS,EAAE,cAAc,EAC1C,cAAc,GAAE,mBAAwB;IAe1C,0EAA0E;IAC1E,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAGpE"}
1
+ {"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/hcm/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,2FAA2F;AAC3F,qBAAa,QAAQ;IAOjB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;gBAGZ,SAAS,EAAE,cAAc,EAC1C,cAAc,GAAE,mBAAwB;IAgB1C,8FAA8F;IAC9F,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAIzE,sFAAsF;IACtF,UAAU,CAAC,KAAK,GAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,UAAU,CAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI1F,iHAAiH;IACjH,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;CAG/E"}
package/build/hcm/api.js CHANGED
@@ -1,13 +1,17 @@
1
1
  import { WshcmRuntimeError } from "./runtime/contracts.js";
2
2
  import { WshcmRuntime } from "./runtime/runtime.js";
3
3
  import { WshcmFiles } from "./files.js";
4
+ import { WshcmPackages } from "./packages/service.js";
4
5
  import { WshcmObjects } from "./objects.js";
5
6
  import { executeXQuery } from "./xquery.js";
7
+ import { getSystemInfo } from "./system-info.js";
8
+ import { executeBorisScript } from "./execute.js";
6
9
  /** Shared HCM operations. The caller owns the evaluator's initialization and lifecycle. */
7
10
  export class WshcmApi {
8
11
  evaluator;
9
12
  files;
10
13
  objects;
14
+ packages;
11
15
  runtime;
12
16
  constructor(evaluator, runtimeOptions = {}) {
13
17
  this.evaluator = evaluator;
@@ -22,10 +26,19 @@ export class WshcmApi {
22
26
  },
23
27
  });
24
28
  this.objects = new WshcmObjects(evaluator);
29
+ this.packages = new WshcmPackages(evaluator);
25
30
  }
26
- /** Return original JSON text to preserve large IDs and decimal tokens. */
31
+ /** Return bounded typed rows: integers are bigint, reals number, native dates ISO strings. */
27
32
  xquery(input) {
28
33
  return executeXQuery(this.evaluator, input);
29
34
  }
35
+ /** Read the native About report; includeReport opts into the full unredacted text. */
36
+ systemInfo(input = {}) {
37
+ return getSystemInfo(this.evaluator, input);
38
+ }
39
+ /** Execute BorisScript once; native failures retain print output, transport failures have an unknown outcome. */
40
+ execute(input) {
41
+ return executeBorisScript(this.evaluator, input);
42
+ }
30
43
  }
31
44
  //# sourceMappingURL=api.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/hcm/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAA4B,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,2FAA2F;AAC3F,MAAM,OAAO,QAAQ;IAMA;IALV,KAAK,CAAa;IAClB,OAAO,CAAe;IACtB,OAAO,CAAe;IAE/B,YACmB,SAAyB,EAC1C,iBAAsC,EAAE;QADvB,cAAS,GAAT,SAAS,CAAgB;QAG1C,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC;YAC1B,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBACjD,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,sBAAsB,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;oBACvF,MAAM,IAAI,iBAAiB,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;gBAC/F,CAAC;gBACD,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;SACF,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,0EAA0E;IAC1E,MAAM,CAAC,KAA0C;QAC/C,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;CACF"}
1
+ {"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/hcm/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAA4B,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAyB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAwB,MAAM,cAAc,CAAC;AAKxE,2FAA2F;AAC3F,MAAM,OAAO,QAAQ;IAOA;IANV,KAAK,CAAa;IAClB,OAAO,CAAe;IACtB,QAAQ,CAAgB;IACxB,OAAO,CAAe;IAE/B,YACmB,SAAyB,EAC1C,iBAAsC,EAAE;QADvB,cAAS,GAAT,SAAS,CAAgB;QAG1C,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC;YAC1B,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBACjD,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,sBAAsB,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;oBACvF,MAAM,IAAI,iBAAiB,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;gBAC/F,CAAC;gBACD,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;SACF,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED,8FAA8F;IAC9F,MAAM,CAAC,KAA0C;QAC/C,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,sFAAsF;IACtF,UAAU,CAAC,QAAiD,EAAE;QAC5D,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,iHAAiH;IACjH,OAAO,CAAC,KAA2C;QACjD,OAAO,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;CACF"}
@@ -0,0 +1,35 @@
1
+ import type { z } from "zod";
2
+ import type { WshcmValue } from "../types.js";
3
+ import { wshcmSchemas } from "./schemas.js";
4
+ import type { WshcmEvaluator } from "./types.js";
5
+ interface ExecutionOutput {
6
+ output: string[];
7
+ outputTruncated: boolean;
8
+ }
9
+ export type ExecutionResult = ExecutionOutput & ({
10
+ ok: true;
11
+ value: WshcmValue;
12
+ } | {
13
+ ok: false;
14
+ error: {
15
+ phase: "execution" | "result";
16
+ message: string;
17
+ };
18
+ });
19
+ export interface ExecutionErrorDetails {
20
+ phase: "transport" | "response";
21
+ executionStatus: "unknown";
22
+ error: {
23
+ code: "TransportError" | "InvalidResponse";
24
+ message: string;
25
+ };
26
+ }
27
+ /** No server acknowledgement is available; this error never implies cancellation/rollback. */
28
+ export declare class WshcmExecutionError extends Error {
29
+ readonly details: ExecutionErrorDetails;
30
+ constructor(phase: ExecutionErrorDetails["phase"], cause: unknown);
31
+ }
32
+ /** Execute once in the server account context, without a file DLL or automatic retry. */
33
+ export declare function executeBorisScript(evaluator: WshcmEvaluator, input: z.input<typeof wshcmSchemas.execute>): Promise<ExecutionResult>;
34
+ export {};
35
+ //# sourceMappingURL=execute.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/hcm/execute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;CAC1B;AACD,MAAM,MAAM,eAAe,GAAG,eAAe,GAC3C,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,KAAK,EAAE,WAAW,GAAG,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CAAC;AAE/G,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,WAAW,GAAG,UAAU,CAAC;IAChC,eAAe,EAAE,SAAS,CAAC;IAC3B,KAAK,EAAE;QAAE,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE;AAED,8FAA8F;AAC9F,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;gBAC5B,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO;CAUlE;AAID,yFAAyF;AACzF,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAwDzI"}