@boristype/ws-client 0.1.0-alpha.6 → 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 (65) hide show
  1. package/README.md +186 -12
  2. package/build/hcm/api.d.ts +8 -0
  3. package/build/hcm/api.d.ts.map +1 -1
  4. package/build/hcm/api.js +13 -0
  5. package/build/hcm/api.js.map +1 -1
  6. package/build/hcm/execute.d.ts +35 -0
  7. package/build/hcm/execute.d.ts.map +1 -0
  8. package/build/hcm/execute.js +76 -0
  9. package/build/hcm/execute.js.map +1 -0
  10. package/build/hcm/packages/archive-types.d.ts +23 -0
  11. package/build/hcm/packages/archive-types.d.ts.map +1 -0
  12. package/build/hcm/packages/archive-types.js +2 -0
  13. package/build/hcm/packages/archive-types.js.map +1 -0
  14. package/build/hcm/packages/archive.d.ts +5 -0
  15. package/build/hcm/packages/archive.d.ts.map +1 -0
  16. package/build/hcm/packages/archive.js +410 -0
  17. package/build/hcm/packages/archive.js.map +1 -0
  18. package/build/hcm/packages/artifacts.d.ts +16 -0
  19. package/build/hcm/packages/artifacts.d.ts.map +1 -0
  20. package/build/hcm/packages/artifacts.js +140 -0
  21. package/build/hcm/packages/artifacts.js.map +1 -0
  22. package/build/hcm/packages/contracts.d.ts +89 -0
  23. package/build/hcm/packages/contracts.d.ts.map +1 -0
  24. package/build/hcm/packages/contracts.js +41 -0
  25. package/build/hcm/packages/contracts.js.map +1 -0
  26. package/build/hcm/packages/native.d.ts +5 -0
  27. package/build/hcm/packages/native.d.ts.map +1 -0
  28. package/build/hcm/packages/native.js +47 -0
  29. package/build/hcm/packages/native.js.map +1 -0
  30. package/build/hcm/packages/schemas.d.ts +121 -0
  31. package/build/hcm/packages/schemas.d.ts.map +1 -0
  32. package/build/hcm/packages/schemas.js +94 -0
  33. package/build/hcm/packages/schemas.js.map +1 -0
  34. package/build/hcm/packages/service.d.ts +215 -0
  35. package/build/hcm/packages/service.d.ts.map +1 -0
  36. package/build/hcm/packages/service.js +420 -0
  37. package/build/hcm/packages/service.js.map +1 -0
  38. package/build/hcm/packages/transfer.d.ts +6 -0
  39. package/build/hcm/packages/transfer.d.ts.map +1 -0
  40. package/build/hcm/packages/transfer.js +81 -0
  41. package/build/hcm/packages/transfer.js.map +1 -0
  42. package/build/hcm/schemas.d.ts +98 -0
  43. package/build/hcm/schemas.d.ts.map +1 -1
  44. package/build/hcm/schemas.js +18 -0
  45. package/build/hcm/schemas.js.map +1 -1
  46. package/build/hcm/system-info.d.ts +24 -0
  47. package/build/hcm/system-info.d.ts.map +1 -0
  48. package/build/hcm/system-info.js +57 -0
  49. package/build/hcm/system-info.js.map +1 -0
  50. package/build/index.d.ts +9 -0
  51. package/build/index.d.ts.map +1 -1
  52. package/build/index.js +4 -0
  53. package/build/index.js.map +1 -1
  54. package/build/value-projection.d.ts +8 -0
  55. package/build/value-projection.d.ts.map +1 -0
  56. package/build/value-projection.js +101 -0
  57. package/build/value-projection.js.map +1 -0
  58. package/build/xquery.d.ts.map +1 -1
  59. package/build/xquery.js +3 -91
  60. package/build/xquery.js.map +1 -1
  61. package/package.json +5 -2
  62. package/resources/execute.bs +40 -0
  63. package/resources/package-operation.bs +318 -0
  64. package/resources/value-projection.bs +79 -0
  65. package/resources/xquery.bs +2 -80
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:
@@ -73,11 +73,178 @@ Evaluator создаёт временный `.bs` файл на сервере
73
73
  - `xquery({query,maxRows?})` возвращает typed `XQueryResult`: integer как bigint,
74
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 и файловая операция
@@ -201,8 +368,15 @@ pnpm --filter @boristype/ws-client test
201
368
  # optional WSHCM_PORT (80), WSHCM_HTTPS (false).
202
369
  pnpm --filter @boristype/ws-client test:e2e:values
203
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
204
373
  ```
205
374
 
206
- Native серии создают и удаляют собственные временные BS-модули, не меняя бизнес-записи.
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
+ и относится к тестам. Это проверка с изменениями данных выбранного стенда.
207
381
  `test:e2e:values` фиксирует наблюдаемое форматирование real на Linux C 2025.2.1333;
208
382
  другие runtime требуют своей проверки.
@@ -1,7 +1,10 @@
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";
5
8
  import type { XQueryResult } from "../xquery.js";
6
9
  import type { wshcmSchemas } from "./schemas.js";
7
10
  import type { WshcmEvaluator } from "./types.js";
@@ -10,9 +13,14 @@ export declare class WshcmApi {
10
13
  private readonly evaluator;
11
14
  readonly files: WshcmFiles;
12
15
  readonly objects: WshcmObjects;
16
+ readonly packages: WshcmPackages;
13
17
  readonly runtime: WshcmRuntime;
14
18
  constructor(evaluator: WshcmEvaluator, runtimeOptions?: WshcmRuntimeOptions);
15
19
  /** Return bounded typed rows: integers are bigint, reals number, native dates ISO strings. */
16
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>;
17
25
  }
18
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,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,8FAA8F;IAC9F,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;CAG1E"}
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
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;AAK5C,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,8FAA8F;IAC9F,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"}
@@ -0,0 +1,76 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { carrierArray, carrierRecord, decodeCarrierString, projectionDecoder, projectionSource } from "../value-projection.js";
3
+ import { wshcmSchemas } from "./schemas.js";
4
+ /** No server acknowledgement is available; this error never implies cancellation/rollback. */
5
+ export class WshcmExecutionError extends Error {
6
+ details;
7
+ constructor(phase, cause) {
8
+ const message = (cause instanceof Error ? cause.message : String(cause)).slice(0, 2000).toWellFormed();
9
+ super(`Execution outcome unknown (${phase}): ${message}`, { cause });
10
+ this.name = "WshcmExecutionError";
11
+ this.details = {
12
+ phase,
13
+ executionStatus: "unknown",
14
+ error: { code: phase === "transport" ? "TransportError" : "InvalidResponse", message },
15
+ };
16
+ }
17
+ }
18
+ const template = readFileSync(new URL("../../resources/execute.bs", import.meta.url), "utf8");
19
+ /** Execute once in the server account context, without a file DLL or automatic retry. */
20
+ export async function executeBorisScript(evaluator, input) {
21
+ const { code } = wshcmSchemas.execute.parse(input);
22
+ const literal = JSON.stringify(code)
23
+ .replace(/\u2028/g, "\\u2028")
24
+ .replace(/\u2029/g, "\\u2029");
25
+ const source = template.replace(/\$\{(codeLiteral|projectionSource)\}/g, (_, name) => name === "codeLiteral" ? literal : projectionSource);
26
+ let response;
27
+ try {
28
+ response = await evaluator.eval(source);
29
+ }
30
+ catch (cause) {
31
+ throw new WshcmExecutionError("transport", cause);
32
+ }
33
+ try {
34
+ if (!carrierRecord(response, ["ok", "value", "output", "outputTruncated", "error"]) ||
35
+ typeof response.ok !== "boolean" ||
36
+ !carrierArray(response.output) ||
37
+ response.output.length > 256 ||
38
+ typeof response.outputTruncated !== "boolean") {
39
+ throw new Error("Invalid execution response envelope");
40
+ }
41
+ const output = response.output.map(decodeCarrierString);
42
+ if (Buffer.byteLength(JSON.stringify(output), "utf8") > 65536)
43
+ throw new Error("Execution diagnostics exceed 64 KiB");
44
+ let result;
45
+ if (response.ok) {
46
+ if (response.error !== null)
47
+ throw new Error("Successful execution response contains an error");
48
+ result = { ok: true, value: projectionDecoder()(response.value, 0), output, outputTruncated: response.outputTruncated };
49
+ }
50
+ else {
51
+ if (response.value !== null ||
52
+ !carrierRecord(response.error, ["phase", "message"]) ||
53
+ (response.error.phase !== "execution" && response.error.phase !== "result"))
54
+ throw new Error("Invalid native execution error");
55
+ const message = decodeCarrierString(response.error.message);
56
+ if ([...message].length > 2000)
57
+ throw new Error("Execution error message exceeds 2000 characters");
58
+ result = { ok: false, error: { phase: response.error.phase, message }, output, outputTruncated: response.outputTruncated };
59
+ }
60
+ // Conservative bound independent of the caller's integer/undefined JSON policy.
61
+ const bounded = JSON.stringify(result, (_, value) => typeof value === "bigint"
62
+ ? String(value)
63
+ : value === undefined
64
+ ? null
65
+ : typeof value === "number" && !Number.isFinite(value)
66
+ ? String(value)
67
+ : value);
68
+ if (Buffer.byteLength(bounded, "utf8") > 262144)
69
+ throw new Error("Execution response exceeds 256 KiB UTF-8");
70
+ return result;
71
+ }
72
+ catch (cause) {
73
+ throw new WshcmExecutionError("response", cause);
74
+ }
75
+ }
76
+ //# sourceMappingURL=execute.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/hcm/execute.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ export interface PackageObjectEntry {
2
+ id: string;
3
+ type: string;
4
+ name: string;
5
+ }
6
+ export interface PackageArchivePart {
7
+ id: string;
8
+ type: string;
9
+ url: string;
10
+ baseUrl?: string;
11
+ serverVersion?: string;
12
+ objects: PackageObjectEntry[];
13
+ hasCustomTemplates: boolean;
14
+ hasAccessRoles: boolean;
15
+ hasLists: boolean;
16
+ deletedObjectIds: string[];
17
+ }
18
+ export interface PackageArchiveInspection {
19
+ packages: PackageArchivePart[];
20
+ totalEntries: number;
21
+ expandedBytes: number;
22
+ }
23
+ //# sourceMappingURL=archive-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"archive-types.d.ts","sourceRoot":"","sources":["../../../src/hcm/packages/archive-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=archive-types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"archive-types.js","sourceRoot":"","sources":["../../../src/hcm/packages/archive-types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,5 @@
1
+ import type { PackageArchiveInspection } from "./archive-types.js";
2
+ export type { PackageArchiveInspection, PackageArchivePart, PackageObjectEntry } from "./archive-types.js";
3
+ /** Inspect bounded ZIP bytes in memory. Entry paths are never used as filesystem destinations. */
4
+ export declare function inspectPackageArchive(localPath: string): Promise<PackageArchiveInspection>;
5
+ //# sourceMappingURL=archive.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../src/hcm/packages/archive.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,wBAAwB,EAAsB,MAAM,oBAAoB,CAAC;AAEvF,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AA6V3G,kGAAkG;AAClG,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAsBhG"}